Selpi

Selpi is woefully incomplete, but in the long run it will hopefully be a collection of basic utilties to monitor a Selectronic SP Pro 2 from a RaspberryPi.

Additional docs:

License / Warranty

See the LICENSE file for license rights and limitations (MIT).

For those unfamiliar please note that this means no warranty OF ANY KIND is granted with this code, further it is possible using this code may impact on any warranty from Selectronic.

Getting Started

Ensure your device is connecting to the SP Pro.

Pipenv is used to control managed dependencies, if it's not already installed, install it:

$ pip install pipenv
[...]
Successfully installed certifi-2019.9.11 enum34-1.1.6 pip-19.3.1 pipenv-2018.11.26 setuptools-41.4.0 typing-3.7.4.1 virtualenv-16.7.6 virtualenv-clone-0.5.3

On the first execution of ./selpi, pipenv should install requirements:

$ ./selpi
Creating a virtualenv for this project...
Pipfile: .../code/selpi/Pipfile
Using /usr/bin/python3 (3.6.8) to create virtualenv...
⠹ Creating virtual environment...Already using interpreter /usr/bin/python3
Using base prefix '/usr'
New python executable in .../.local/share/virtualenvs/selpi-E1h07TTq/bin/python3
Also creating executable in .../.local/share/virtualenvs/selpi-E1h07TTq/bin/python
Installing setuptools, pip, wheel...
done.
Running virtualenv with interpreter /usr/bin/python3

✔ Successfully created virtual environment!

Commands

Selpi uses a sub command structure meaning the base selpi accepts multiple commands that run it in different modes.

See selpi --help for a full list of commands, some commands are documented below.

Additional logging output can be printed with selpi --log=debug ....

proxy

The proxy command is used to expose the Selectronic SP PRO over TCP.

The listening address and port can be controlled from .env.local.

To start the proxy run:

$ ./selpi proxy

TP LINK can then be configured to connect to the device selpi is started on.

stat

The stat command displays the currently known stats from the SP PRO:

$ ./selpi stat
[
  {
    "description": "AC Solar Power",
    "name": "CombinedKacoAcPowerHiRes",
    "value": 4707.696533203125,
    "units": "W"
  },
  {
    "description": "Shunt 1 Name",
    "name": "Shunt1Name",
    "value": "Solar",
    "units": ""
  },
...
  {
    "description": "Battery Out Energy Today",
    "name": "BattOutkWhPreviousAcc",
    "value": 5998.53515625,
    "units": "Wh"
  },
  {
    "description": "Battery State of Charge",
    "name": "BattSocPercent",
    "value": 87.55859375,
    "units": "%"
  }
]

Acknowledgements

This repository is primarily maintained by David Schoen.

Foundational code and inspirational advice provided by Justin Stafford.