A simple Python script to read data from the USB port of Rainforest EMU-2 device and post the XML block to PVoutput web site.
The idea is based on this project (https://github.com/zagnuts/RAVEnOUT) but Python and asynchronous serial port access worked much better for me. Building and running from the Docker container makes it much easier to deploy the script into your solar home infrastructure.
You must obtain your user id and access key pair from (https://pvoutput.org/help.html#api-getting-started) prior to using this script.
The following environment variables are mandatory:
RF_PVOUTPUT_SID- This variable specifies the user idRF_PVOUTPUT_KEY- This variable contains the API secret key
The following variables are available to customise your configuration:
RF_SERIAL_PORT- path to the USB device name on the local system (/dev/ttyACM0 is default)RF_SERIAL_BAUDRATE- serial port connection speed (115200 is default)RF_PVOUTPUT_SERVER- pvoutput end point host name (http://pvoutput.org:80 is default)RF_LOG_LEVEL- log level (9 (DEBUG) is default )
docker build . -t rainforest-to-pvoutput:latest
RF_PVOUTPUT_SID=<sid> RF_PVOUTPUT_KEY=<key> docker run --restart unless-stopped -d -e RF_PVOUTPUT_SID -e RF_PVOUTPUT_KEY --device "/dev/ttyACM0:/dev/ttyACM0" --name emu-to-pvoutput emu-to-pvoutput:latest
Clone the repository
cd /opt
sudo git clone https://github.com/pvl7/emu-to-pvoutput
Install Python dependencies
sudo apt-get -y install python-setuptools python3-pip
sudo pip3 install -r /opt/emu-to-pvoutput/emu-requirements.txt
Create systemd service configuration file
cat /opt/emu-to-pvoutput/emu2-reader.service | sudo tee /etc/systemd/system/emu2-reader.service
Start the service
sudo systemctl daemon-reload
sudo systemctl enable emu2-reader
sudo systemctl start emu2-reader
Check if the service is online
journalctl -xefu emu2-reader