{"id":24701588,"url":"https://github.com/thegarmr/smartups","last_synced_at":"2026-04-14T15:33:09.163Z","repository":{"id":274113625,"uuid":"921948046","full_name":"TheGarmr/SmartUPS","owner":"TheGarmr","description":"A project to make standard UPS smarter for status monitoring and Home Assistant integration.","archived":false,"fork":false,"pushed_at":"2025-03-14T11:41:42.000Z","size":1651,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-22T04:12:42.179Z","etag":null,"topics":["diy","diy-electronics","esp32","esp32-arduino","esp32-c3","home-assistant-sensor"],"latest_commit_sha":null,"homepage":"","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/TheGarmr.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-01-24T23:36:29.000Z","updated_at":"2025-03-14T11:41:45.000Z","dependencies_parsed_at":"2025-01-25T01:28:39.961Z","dependency_job_id":null,"html_url":"https://github.com/TheGarmr/SmartUPS","commit_stats":null,"previous_names":["thegarmr/smartups"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheGarmr%2FSmartUPS","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheGarmr%2FSmartUPS/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheGarmr%2FSmartUPS/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheGarmr%2FSmartUPS/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/TheGarmr","download_url":"https://codeload.github.com/TheGarmr/SmartUPS/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244902927,"owners_count":20529115,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["diy","diy-electronics","esp32","esp32-arduino","esp32-c3","home-assistant-sensor"],"created_at":"2025-01-27T05:24:50.231Z","updated_at":"2026-04-14T15:33:09.130Z","avatar_url":"https://github.com/TheGarmr.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Network UPS\n\n## Description\nThis project aims to enhance the functionality of my network UPS system, making it smarter. Frequent electricity outages in Ukraine have highlighted the need to automate various processes that rely on electricity. Also, it helps to correct your plans in case of shit happened.\n\n### How it works?\nI have two UPS with front panels with 4 and 5 LED status indicators.\nThe idea is to replace the original pcb for these leds with a **ESP32-C3** microcontroller that will read statuses of these indicators.\n\nStatuses:\n- **AC Input**: Indicates whether mains electricity is available.\n- **Battery is charging**: This is active when the battery is charging (e.g., when 12V is provided).\n- **Battery is low**: Warns when the battery level is critically low.\n- **DC output**: Always green.\n- **AC Input is absent**: only at one of my UPS\n![Full energy BBGP-125](./files/full-energy-bbgp-125.jpg)\n\n### Functionality\nThis project have the following features:\n1. **Real-time monitoring**\n2. **Home Assistant integration**\n\nThe pcb is done in modifications with 4 and 5 leds\n\n### Configs\nSee the `Variables` section in the code to understand how to configure your device for your specific setup. These configurations allow you to adapt the system to the type of UPS you are using, as well as customize notifications and automation.\n\n### Home Assistant integration\nYou can integrate your UPS with Home Assistant in two ways:\n- **API**: Enables direct communication with Home Assistant using RESTful APIs.\n- **MQTT**: Allows integration via MQTT, a lightweight messaging protocol commonly used in IoT systems.\n\nThe provided code supports both integration methods. You can find detailed configuration files and examples in the `files` folder to help you set up and start using your smart UPS.\n\n![Home Assistant card](./files/home-assistant-card.png)\n![Home Assistant MQTT entity](./files/mqtt-entity.png)\n![Home Assistant rest-template-entity](./files/rest-template-entity.png)\n\n### Components you will need\n1. **4-5 Leds**\n2. **ESP32 C3**\n3. **PH2.0 connectors (5/6 pins and 2 pins)**\n4. **Diode 1N4148WS**\n5. **100nF capacitor**\n6. **PCB** - can be find in the files folder (POWER_LED.zip)\n\n# Thanks\nThe PCB was designed by [Ivan](https://github.com/Ivan7123)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthegarmr%2Fsmartups","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fthegarmr%2Fsmartups","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthegarmr%2Fsmartups/lists"}