Python Inverter COM

Python module to communicate with WKS EKO Circle inverters.

Installation

$ python -m pip install 'git+https://github.com/BoboTiG/python-wks-com.git@main'

Utility

When installing the module, the wks-read program is made available. You can use it to send commands to inverters, and see what data you can get from.

The usage is as follow:

$ wks-read [--port SERIAL_PORT] [--debug] COMMAND_OR_ALIAS [COMMAND_OR_ALIAS...]

As an example, here is how to retrieve the inverter serial number:

$ wks-read QID

# The same command with an alias:
$ wks-read serial-no

The output will be something like that:

$ wks-read serial-no
"96332309100452"

When enabling debug logs, it will likely show:

$ wks-read --debug serial-no
DEBUG:wks_com.inverter:/dev/ttyUSB0 > SEND 'QIDÖê\r'
DEBUG:wks_com.inverter:/dev/ttyUSB0 > WRITTEN 6 chars (OK)
DEBUG:wks_com.inverter:/dev/ttyUSB0 < RAW b'(96332309100452?\xf3\r'
DEBUG:wks_com.inverter:/dev/ttyUSB0 < DECODED '96332309100452'
"96332309100452"

The default port is /dev/ttyUSB0, you can change that:

$ wks-read --port /dev/ttyAMA0 serial-no
"96332309100452"

Available Commands

You can send any commands as defined in the official documentation, and even unknown commands.

There are also aliases you could use:

• daily-load for the QLD command (it will automatically fill the date using the current time);
• daily-pv for the QED command (it will automatically fill the date using the current time);
• metrics for the QPGS0 command;
• monthly-load for the QLM command (it will automatically fill the date using the current time);
• monthly-pv for the QEM command (it will automatically fill the date using the current time);
• ratings for the QPIRI command;
• serial-no for the QID command;
• status for the QPIGS command;
• time for the QT command;
• total-load for the QLT command;
• total-pv for the QET command;
• warnings for the QPIWS command;
• yearly-load for the QLY command (it will automatically fill the date using the current time);
• yearly-pv for the QEY command (it will automatically fill the date using the current time);

When the inverter does not understand a command, it will respond with NAK.

Development

Setup a virtual environment:

$ python -m venv venv
$ . venv/bin/activate

Install, or update, dependencies:

$ python -m pip install -U pip
$ python -m pip install -e '.[dev]'

Run tests:

$ python -Wd -m pytest --doctest-modules src

Run linters, and quality checkers:

$ ./checks.sh