Get information from Deye Microinverter
Project description
inverter
Get information from Deye Microinverter
The whole thing is just a learning exercise for now. We will see.
quickstart
Currently just clone the project and just start the cli (that will create a virtualenv and installs every dependencies)
Note: Please enable https://www.piwheels.org/ if you are on a Raspberry Pi !
e.g.:
~$ git clone https://github.com/jedie/inverter-connect.git
~$ cd inverter-connect
~/inverter-connect$ ./cli.py --help
The output of ./cli.py --help
looks like:
Usage: ./cli.py [OPTIONS] COMMAND [ARGS]...
╭─ Options ────────────────────────────────────────────────────────────────────────────────────────╮
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────────────────────────╯
╭─ Commands ───────────────────────────────────────────────────────────────────────────────────────╮
│ debug-settings Display (anonymized) MQTT server username and password │
│ print-at-commands Print one or more AT command values from Inverter. │
│ print-values Print all known register values from Inverter, e.g.: │
│ publish-loop Publish current data via MQTT (endless loop) │
│ read-register Read register(s) from the inverter │
│ set-time Set current date time in the inverter device. │
│ store-settings Store MQTT server settings. │
│ test-mqtt-connection Test connection to MQTT Server │
│ version Print version and exit │
╰──────────────────────────────────────────────────────────────────────────────────────────────────╯
most important commands
print-values
Help from ./cli.py print-values --help
Looks like:
Usage: ./cli.py print-values [OPTIONS] IP
Print all known register values from Inverter, e.g.:
.../inverter-connect$ ./cli.py print-values 192.168.123.456
╭─ Options ────────────────────────────────────────────────────────────────────────────────────────╮
│ --port INTEGER RANGE [1000<=x<=65535] Port of the inverter │
│ [default: 48899; 1000<=x<=65535] │
│ --debug/--no-debug [default: no-debug] │
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────────────────────────╯
Example output of print-values
call:
print-at-commands
Help from ./cli.py print-at-commands --help
Looks like:
Usage: ./cli.py print-at-commands [OPTIONS] IP [COMMANDS]...
Print one or more AT command values from Inverter.
Use all known AT commands, if no one is given, e.g.:
.../inverter-connect$ ./cli.py print-at-commands 192.168.123.456
Or specify one or more AT-commands, e.g.:
.../inverter-connect$ ./cli.py print-at-commands 192.168.123.456 WEBVER .../inverter-connect$
./cli.py print-at-commands 192.168.123.456 WEBVER WEBU
e.g.: Set NTP server, enable NTP and check the values:
.../inverter-connect$ ./cli.py print-at-commands 192.168.123.456 NTPSER=192.168.1.1 NTPEN=on
NTPSER NTPEN
wait a while and request the current date time:
.../inverter-connect$ ./cli.py print-at-commands 192.168.123.456 NTPTM
(Note: The prefix "AT+" will be added to every command)
╭─ Options ────────────────────────────────────────────────────────────────────────────────────────╮
│ --port INTEGER RANGE [1000<=x<=65535] Port of the inverter │
│ [default: 48899; 1000<=x<=65535] │
│ --debug/--no-debug [default: no-debug] │
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────────────────────────╯
Example output of print-at-commands
call:
read-register
Help from ./cli.py read-register --help
Looks like:
Usage: ./cli.py read-register [OPTIONS] IP REGISTER LENGTH
Read register(s) from the inverter
e.g.: read 3 registers starting from 0x16:
.../inverter-connect$ ./cli.py read-register 192.168.123.456 0x16 3
e.g.: read the first 32 registers:
.../inverter-connect$ ./cli.py read-register 192.168.123.456 0 32
The start address can be pass as decimal number or as hex string, e.g.: 0x123
╭─ Options ────────────────────────────────────────────────────────────────────────────────────────╮
│ --port INTEGER RANGE [1000<=x<=65535] Port of the inverter │
│ [default: 48899; 1000<=x<=65535] │
│ --debug/--no-debug [default: debug] │
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────────────────────────╯
Example output of read-register
call:
start development
For development, we have a separate CLI, just call it:
~/inverter-connect$ ./dev-cli.py --help
The output of ./dev-cli.py --help
looks like:
Usage: ./dev-cli.py [OPTIONS] COMMAND [ARGS]...
╭─ Options ────────────────────────────────────────────────────────────────────────────────────────╮
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────────────────────────╯
╭─ Commands ───────────────────────────────────────────────────────────────────────────────────────╮
│ check-code-style Check code style by calling darker + flake8 │
│ coverage Run and show coverage. │
│ fix-code-style Fix code style of all inverter source code files via darker │
│ install Run pip-sync and install 'inverter' via pip as editable. │
│ mypy Run Mypy (configured in pyproject.toml) │
│ publish Build and upload this project to PyPi │
│ safety Run safety check against current requirements files │
│ test Run unittests │
│ tox Run tox │
│ update Update "requirements*.txt" dependencies files │
│ update-test-snapshot-files Update all test snapshot files (by remove and recreate all snapshot │
│ files) │
│ version Print version and exit │
╰──────────────────────────────────────────────────────────────────────────────────────────────────╯
credits
Others before me have done good work. In particular, I have learned a lot from the following projects:
- https://github.com/s10l/deye-logger-at-cmd
- https://github.com/kbialek/deye-inverter-mqtt
- https://github.com/StephanJoubert/home_assistant_solarman
The included definitions yaml files are from:
various links
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for inverter_connect-0.4.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 1b144ba699afb94b1e3915cdf3c404e2559155bfa506ce81041f170efe27a64b |
|
MD5 | e379362fcb2ab640162c1911c2e907a3 |
|
BLAKE2b-256 | 3aaac4188b4338b47d48f77c66c9d5fc93355d6b0128533d2445b13bfaf64580 |