{"id":37085243,"url":"https://github.com/dewet22/givenergy-modbus","last_synced_at":"2026-05-28T00:01:44.831Z","repository":{"id":43468281,"uuid":"444061243","full_name":"dewet22/givenergy-modbus","owner":"dewet22","description":"A python library to access GivEnergy inverters via Modbus TCP on a local network, with no dependency on the GivEnergy Cloud.","archived":false,"fork":false,"pushed_at":"2026-05-27T00:43:34.000Z","size":2787,"stargazers_count":25,"open_issues_count":16,"forks_count":17,"subscribers_count":6,"default_branch":"main","last_synced_at":"2026-05-27T01:13:12.661Z","etag":null,"topics":["energy","energy-monitoring","inverter-control","local","modbus","polling","python"],"latest_commit_sha":null,"homepage":"https://dewet22.github.io/givenergy-modbus/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dewet22.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2022-01-03T12:56:28.000Z","updated_at":"2026-05-27T00:43:08.000Z","dependencies_parsed_at":"2023-01-30T18:15:47.642Z","dependency_job_id":"9f8f17f0-4d74-49e4-bf08-f2aeaa35a289","html_url":"https://github.com/dewet22/givenergy-modbus","commit_stats":{"total_commits":188,"total_committers":7,"mean_commits":"26.857142857142858","dds":0.07446808510638303,"last_synced_commit":"9fc61b53f85f91a1bd16f0bfb6c9071d0090fc9e"},"previous_names":[],"tags_count":36,"template":false,"template_full_name":null,"purl":"pkg:github/dewet22/givenergy-modbus","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dewet22%2Fgivenergy-modbus","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dewet22%2Fgivenergy-modbus/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dewet22%2Fgivenergy-modbus/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dewet22%2Fgivenergy-modbus/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dewet22","download_url":"https://codeload.github.com/dewet22/givenergy-modbus/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dewet22%2Fgivenergy-modbus/sbom","scorecard":{"id":338632,"data":{"date":"2025-08-11","repo":{"name":"github.com/dewet22/givenergy-modbus","commit":"9fc61b53f85f91a1bd16f0bfb6c9071d0090fc9e"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":2.7,"checks":[{"name":"Code-Review","score":0,"reason":"Found 2/24 approved changesets -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Maintained","score":0,"reason":"project is archived","details":["Warn: Repository is archived."],"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"Dangerous-Workflow","score":10,"reason":"no dangerous workflow patterns detected","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Token-Permissions","score":0,"reason":"detected GitHub workflow tokens with excessive permissions","details":["Info: jobLevel 'actions' permission set to 'read': .github/workflows/codeql-analysis.yml:28","Info: jobLevel 'contents' permission set to 'read': .github/workflows/codeql-analysis.yml:29","Warn: no topLevel permission defined: .github/workflows/codeql-analysis.yml:1","Warn: no topLevel permission defined: .github/workflows/dev.yml:1","Warn: no topLevel permission defined: .github/workflows/preview.yml:1","Warn: no topLevel permission defined: .github/workflows/release.yml:1","Info: no jobLevel write permissions found"],"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"Pinned-Dependencies","score":0,"reason":"dependency not pinned by hash detected -- score normalized to 0","details":["Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/codeql-analysis.yml:41: update your workflow using https://app.stepsecurity.io/secureworkflow/dewet22/givenergy-modbus/codeql-analysis.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/codeql-analysis.yml:45: update your workflow using https://app.stepsecurity.io/secureworkflow/dewet22/givenergy-modbus/codeql-analysis.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/codeql-analysis.yml:56: update your workflow using https://app.stepsecurity.io/secureworkflow/dewet22/givenergy-modbus/codeql-analysis.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/codeql-analysis.yml:70: update your workflow using https://app.stepsecurity.io/secureworkflow/dewet22/givenergy-modbus/codeql-analysis.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/dev.yml:30: update your workflow using https://app.stepsecurity.io/secureworkflow/dewet22/givenergy-modbus/dev.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/dev.yml:31: update your workflow using https://app.stepsecurity.io/secureworkflow/dewet22/givenergy-modbus/dev.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/dev.yml:47: update your workflow using https://app.stepsecurity.io/secureworkflow/dewet22/givenergy-modbus/dev.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/preview.yml:24: update your workflow using https://app.stepsecurity.io/secureworkflow/dewet22/givenergy-modbus/preview.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/preview.yml:25: update your workflow using https://app.stepsecurity.io/secureworkflow/dewet22/givenergy-modbus/preview.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/preview.yml:45: update your workflow using https://app.stepsecurity.io/secureworkflow/dewet22/givenergy-modbus/preview.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/release.yml:35: update your workflow using https://app.stepsecurity.io/secureworkflow/dewet22/givenergy-modbus/release.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/release.yml:39: update your workflow using https://app.stepsecurity.io/secureworkflow/dewet22/givenergy-modbus/release.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/release.yml:45: update your workflow using https://app.stepsecurity.io/secureworkflow/dewet22/givenergy-modbus/release.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/release.yml:75: update your workflow using https://app.stepsecurity.io/secureworkflow/dewet22/givenergy-modbus/release.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/release.yml:86: update your workflow using https://app.stepsecurity.io/secureworkflow/dewet22/givenergy-modbus/release.yml/main?enable=pin","Warn: pipCommand not pinned by hash: .github/workflows/dev.yml:37","Warn: pipCommand not pinned by hash: .github/workflows/dev.yml:38","Warn: pipCommand not pinned by hash: .github/workflows/preview.yml:31","Warn: pipCommand not pinned by hash: .github/workflows/preview.yml:32","Warn: pipCommand not pinned by hash: .github/workflows/release.yml:51","Warn: pipCommand not pinned by hash: .github/workflows/release.yml:52","Info:   0 out of  10 GitHub-owned GitHubAction dependencies pinned","Info:   0 out of   5 third-party GitHubAction dependencies pinned","Info:   0 out of   6 pipCommand dependencies pinned"],"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"License","score":9,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Warn: project license file does not contain an FSF or OSI license."],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Signed-Releases","score":0,"reason":"Project has not signed or included provenance with any releases.","details":["Warn: release artifact v0.10.1 not signed: https://api.github.com/repos/dewet22/givenergy-modbus/releases/60940858","Warn: release artifact v0.10.0 not signed: https://api.github.com/repos/dewet22/givenergy-modbus/releases/60835029","Warn: release artifact v0.9.4 not signed: https://api.github.com/repos/dewet22/givenergy-modbus/releases/59997870","Warn: release artifact v0.9.3 not signed: https://api.github.com/repos/dewet22/givenergy-modbus/releases/58494377","Warn: release artifact v0.9.2 not signed: https://api.github.com/repos/dewet22/givenergy-modbus/releases/57839858","Warn: release artifact v0.10.1 does not have provenance: https://api.github.com/repos/dewet22/givenergy-modbus/releases/60940858","Warn: release artifact v0.10.0 does not have provenance: https://api.github.com/repos/dewet22/givenergy-modbus/releases/60835029","Warn: release artifact v0.9.4 does not have provenance: https://api.github.com/repos/dewet22/givenergy-modbus/releases/59997870","Warn: release artifact v0.9.3 does not have provenance: https://api.github.com/repos/dewet22/givenergy-modbus/releases/58494377","Warn: release artifact v0.9.2 does not have provenance: https://api.github.com/repos/dewet22/givenergy-modbus/releases/57839858"],"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Branch-Protection","score":0,"reason":"branch protection not enabled on development/release branches","details":["Warn: branch protection not enabled for branch 'main'"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"SAST","score":7,"reason":"SAST tool detected but not run on all commits","details":["Info: SAST configuration detected: CodeQL","Warn: 0 commits out of 9 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}},{"name":"Vulnerabilities","score":0,"reason":"33 existing vulnerabilities detected","details":["Warn: Project is vulnerable to: PYSEC-2024-48 / GHSA-fj7x-q9j7-g6q6","Warn: Project is vulnerable to: PYSEC-2024-230 / GHSA-248v-346w-9cwc","Warn: Project is vulnerable to: PYSEC-2023-135 / GHSA-xqr8-7jwr-rhp7","Warn: Project is vulnerable to: GHSA-3ww4-gg4f-jr7f","Warn: Project is vulnerable to: GHSA-5cpq-8wj7-hf2v","Warn: Project is vulnerable to: PYSEC-2024-225 / GHSA-6vqw-3v5j-54x4","Warn: Project is vulnerable to: GHSA-9v9h-cgj8-h64p","Warn: Project is vulnerable to: GHSA-h4gh-qq45-vh27","Warn: Project is vulnerable to: PYSEC-2023-254 / GHSA-jfhm-5ghh-2f97","Warn: Project is vulnerable to: GHSA-jm77-qphf-c4w8","Warn: Project is vulnerable to: GHSA-v8gr-m533-ghj9","Warn: Project is vulnerable to: PYSEC-2024-4 / GHSA-2mqj-m65w-jghx","Warn: Project is vulnerable to: PYSEC-2023-165 / GHSA-cwvm-v4w8-q58c","Warn: Project is vulnerable to: PYSEC-2023-137 / GHSA-pr76-5cm5-w9cj","Warn: Project is vulnerable to: PYSEC-2023-161 / GHSA-wfm5-v35h-vwf4","Warn: Project is vulnerable to: PYSEC-2024-60 / GHSA-jjg7-2v4v-x38h","Warn: Project is vulnerable to: GHSA-29gw-9793-fvw7","Warn: Project is vulnerable to: PYSEC-2023-228 / GHSA-mq26-g339-26xf","Warn: Project is vulnerable to: PYSEC-2022-42969","Warn: Project is vulnerable to: GHSA-mr82-8j83-vxmv","Warn: Project is vulnerable to: PYSEC-2023-117 / GHSA-mrwq-x4v8-fh7p","Warn: Project is vulnerable to: GHSA-9hjg-9r4m-mvj7","Warn: Project is vulnerable to: GHSA-9wx4-h78v-vm56","Warn: Project is vulnerable to: PYSEC-2023-74 / GHSA-j8r2-6x86-q33q","Warn: Project is vulnerable to: GHSA-g92j-qhmh-64v2","Warn: Project is vulnerable to: PYSEC-2025-49 / GHSA-5rjg-fvgr-3xxf","Warn: Project is vulnerable to: GHSA-cx63-2mw6-8hw5","Warn: Project is vulnerable to: GHSA-34jh-p97f-mpxf","Warn: Project is vulnerable to: PYSEC-2023-212 / GHSA-g4mx-q9vg-27p4","Warn: Project is vulnerable to: GHSA-pq67-6m6q-mj2v","Warn: Project is vulnerable to: PYSEC-2023-192 / GHSA-v845-jxx5-vc9f","Warn: Project is vulnerable to: PYSEC-2024-187 / GHSA-rqc4-2hc7-8c8v","Warn: Project is vulnerable to: GHSA-jfmj-5v4g-7637"],"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}}]},"last_synced_at":"2025-08-18T05:16:58.005Z","repository_id":43468281,"created_at":"2025-08-18T05:16:58.006Z","updated_at":"2025-08-18T05:16:58.006Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33588345,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-27T02:00:06.184Z","response_time":53,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["energy","energy-monitoring","inverter-control","local","modbus","polling","python"],"created_at":"2026-01-14T10:28:44.061Z","updated_at":"2026-05-28T00:01:44.825Z","avatar_url":"https://github.com/dewet22.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# GivEnergy Modbus\n\n\u003cp align=\"center\"\u003e\u003cimg src=\"logo.png\" alt=\"GivEnergy\" width=\"320\"\u003e\u003c/p\u003e\n\n[![pypi](https://img.shields.io/pypi/v/givenergy-modbus)](https://pypi.org/project/givenergy-modbus/)\n[![python](https://img.shields.io/pypi/pyversions/givenergy-modbus)](https://pypi.org/project/givenergy-modbus/)\n[![CI](https://img.shields.io/github/checks-status/dewet22/givenergy-modbus/main)](https://github.com/dewet22/givenergy-modbus/actions?query=branch%3Amain)\n[![codecov](https://img.shields.io/codecov/c/github/dewet22/givenergy-modbus)](https://codecov.io/github/dewet22/givenergy-modbus)\n[![license](https://img.shields.io/github/license/dewet22/givenergy-modbus)](LICENSE)\n[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)\n\nA Python library for communicating with GivEnergy inverters via Modbus TCP on a local network, with no dependency on the GivEnergy Cloud. Inspired by and originally built on [pymodbus](https://pymodbus.readthedocs.io/), it now provides its own asyncio-based framer, decoder and PDUs specific to the GivEnergy implementation.\n\n\u003e ⚠️ This project makes no representations as to its completeness or correctness. You use it at your own risk — if your\n\u003e inverter mysteriously explodes because you accidentally set the `BOOMTIME` register or you consume a MWh of\n\u003e electricity doing SOC calibration: you **really** are on your own. We make every effort to prevent you from shooting\n\u003e yourself in the foot, so as long as you use the client and its exposed methods, you should be perfectly safe.\n\n* Documentation: \u003chttps://dewet22.github.io/givenergy-modbus\u003e\n* GitHub: \u003chttps://github.com/dewet22/givenergy-modbus\u003e\n* PyPI: \u003chttps://pypi.org/project/givenergy-modbus/\u003e\n* Free software: Apache-2.0\n\n## Features\n\n* Reading all registers and decoding them into their representative datatypes\n* Writing data to holding registers that are deemed to be safe to set configuration on the inverter\n\n## How to use\n\nThe client is async. Use it inside an `asyncio` event loop; commands are plain functions that return request lists\nwhich you send via `one_shot_command` or `execute`:\n\n```python\nimport asyncio\nfrom givenergy_modbus.client.client import Client\nfrom givenergy_modbus.client import commands\nfrom givenergy_modbus.model import TimeSlot\nfrom givenergy_modbus.model.inverter import Model\n\nasync def main():\n    client = Client(host=\"192.168.99.99\", port=8899)\n    await client.connect()\n\n    # Read current state first (needed for slot_map)\n    await client.refresh_plant(full_refresh=True)\n    plant = client.plant\n\n    # Write configuration to the device\n    await client.one_shot_command(commands.set_charge_target(80))\n    # set a charging slot from 00:30 to 04:30; slot_map selects correct registers for this model\n    await client.one_shot_command(\n        commands.set_charge_slot(1, TimeSlot.from_components(0, 30, 4, 30), plant.inverter.slot_map)\n    )\n    # set the inverter to charge from excess solar and discharge to meet demand\n    await client.one_shot_command(commands.set_mode_dynamic())\n\n    assert plant.inverter_serial_number == 'SA1234G567'\n    assert plant.inverter.model == Model.HYBRID\n    assert plant.inverter.enable_charge_target\n    assert plant.inverter.charge_slot_1 == TimeSlot.from_components(0, 30, 4, 30)\n    assert plant.inverter.model_dump() == {\n        'serial_number': 'SA1234G567',\n        'device_type_code': '3001',\n        'charge_slot_1': TimeSlot.from_components(0, 30, 4, 30),\n        ...\n    }\n    assert plant.inverter.model_dump_json() == '{\"serial_number\": \"SA1234G567\", \"device_type_code\": \"3001\", ...'\n\n    assert plant.batteries[0].serial_number == 'BG1234G567'\n    assert plant.batteries[0].v_cell_01 == 3.117\n    assert plant.batteries[0].model_dump() == {\n        'bms_firmware_version': 3005,\n        'cap_design': 160.0,\n        ...\n    }\n    assert plant.batteries[0].model_dump_json() == '{\"serial_number\": \"BG1234G567\", \"v_cell_01\": 3.117, ...'\n\n    await client.close()\n\nasyncio.run(main())\n```\n\n## Credits\n\nThis package was created with [Cookiecutter](https://github.com/audreyr/cookiecutter) and\nthe [waynerv/cookiecutter-pypackage](https://github.com/waynerv/cookiecutter-pypackage) project template.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdewet22%2Fgivenergy-modbus","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdewet22%2Fgivenergy-modbus","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdewet22%2Fgivenergy-modbus/lists"}