GoodWe
Library for connecting to GoodWe inverter over local network and retrieving runtime sensor values and configuration parameters.
It has been reported to work with GoodWe ET, EH, BT, BH, ES, EM, BP, DT, MS, D-NS, and XS families of inverters. It should work with other inverters as well, as long as they listen on UDP port 8899 or TCP port 502 and respond to one of supported communication protocols. In general, if you can connect to your inverter with the official mobile app (SolarGo/PvMaster) over Wi-Fi (not bluetooth), this library should work.
White-label (GoodWe manufactured) inverters may work as well, e.g. General Electric GEP (PSB, PSC) and GEH models are know to work properly.
Since v0.4.x the library also supports standard Modbus/TCP over port 502. This protocol is supported by the V2.0 version of LAN+WiFi communication dongle (model WLA0000-01-00P).
(If you can't communicate with the inverter despite your model is listed above, it is possible you have old ARM firmware version. You should ask manufacturer support to upgrade your ARM firmware (not just inverter firmware) to be able to communicate with the inverter.)
Usage
- Install this package
pip install goodwe - Write down your GoodWe inverter's IP address (or invoke
goodwe.search_inverters()) - Connect to inverter and read all runtime data, example below
import asyncio
import goodwe
async def get_runtime_data():
ip_address = '192.168.1.14'
inverter = await goodwe.connect(ip_address)
runtime_data = await inverter.read_runtime_data()
for sensor in inverter.sensors():
if sensor.id_ in runtime_data:
print(f"{sensor.id_}: \t\t {sensor.name} = {runtime_data[sensor.id_]} {sensor.unit}")
asyncio.run(get_runtime_data())
References and useful links
Metadata
Release files for goodwe 0.4.10
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| goodwe-0.4.10.tar.gz | 61.7 kB | Without provenance | Details for goodwe-0.4.10.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| goodwe-0.4.10-py3-none-any.whl | Python 3 | none | any | Details for goodwe-0.4.10-py3-none-any.whl |
Total release size: 107.7 kB
Release files / goodwe-0.4.10.tar.gz
| Download URL | goodwe-0.4.10.tar.gz |
|---|---|
| Size | 61.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
8c0786f32b1f59bb0209773bf6b9d3333b33e5628039de95c1efc3b49c593e26
|
|
BLAKE2b-256 checksum How to use checksums |
f058b1a9d61b036da8d5ee8c475b45d7bfe697b7df047eceb981dd9db55cde6c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Release files / goodwe-0.4.10-py3-none-any.whl
| Download URL | goodwe-0.4.10-py3-none-any.whl |
|---|---|
| Size | 46.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
5b1e4e8ab420f2edc2effd9fab3c3a4e0f65fe4274965ae0e26055d72431c6a0
|
|
BLAKE2b-256 checksum How to use checksums |
2f52802e6b58da0c9116dac4df636a6acc376a66b79dff535604e5cee611506a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Security for goodwe 0.4.10
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.