PowerPi

PowerPi is a python3 interfacing bridge between modbus connections and a MQTT broker.

This project is based on the amazing work of Charles Godwin's pymagnum software as well as Graham22's work communicating with Midnite's classic MPPT charge controller.

To fit my use case, I needed a single project to talk to my Magnum Energy devices via Modbus (RS485) connection as well as to my Midnite Solar Classic 150 charge controller that could combine the data and transmit a universal payload back to my Home Automation System.

This allows remote monitoring and control of my off grid home remotely and easily through a single contact node.

Table Of Contents

1. Configuration
2. Usage
3. ToDo

This implementation is for personal use and uploaded for educational purposes only. See each originating project's licenses where approprate.

Configuration

PowerPi can be configured via a powerpi.conf file or via command-line arguments upon launch. An example configuration file is supplied.

Config	Section	Flag	Default	Notes
interval	Config	--interval	60	(s) interval between data publishing
timeout	Config	--timeout	0.005	(s) mqtt timeout
root_topic	Config	--topic	powerpi/	root topic to publish to. root_topic/device
packet_count	Config	--packets	50	number of packets to scan at a time
broker	Mqtt	--broker	localhost	ip address of mqtt broker
port	Mqtt	--brokerport	1883	mqtt broker port
username	Mqtt	--username	mqtt_user	username to the mqtt broker
mqtt_password	Secret	--password	mqtt	password to the mqtt broker
client	Mqtt	--clientid	uuid	mqtt client id
classic	Classic	--classic	10.10.0.2	ip address of the Midnite Classic
port	Classic	--classicport	502	port of the Midnite Classic
device	Magnum	--device	/dev/ttyUSB0	path to modbus device

Command-line Flags

Flag	Description
--config	Supply a config file path
--ignoremagnum	Does not poll and report Magnum data
--ignoreclassic	Does not poll and report Classic data
--allowduplicates	Allow duplicate entries
--trace	Trace packets
--nocleanup	Clean up packets.

Any command-line arguments supplied upon execution will override any settings within the powerpi.conf file.

Any values neglected from command-line or a config file will hold the default value shown above.

Usage

PowerPi can be run from a bash shell or added to a startup script or routine.

Launching

Basic: python3 powerpi.py

Custom broker: python3 powerpi.py --broker 192.168.0.100

Classic: python3 powerpi.py --classic 192.168.0.101

Advanced: python3 powerpi.py --broker 192.168.0.100 --classic 192.168.0.101 --username classic_user --interval 3600 --allowduplicates --nocleanup

Command-line Flags: python3 powerpi.py --config '~/.configs/powerpi.cfg' --ignoreclassic

ToDo

• Ensure more graceful failures.

Setup And Usage

PowerPi Wiki

License

 Copyright (c) 2019

  Licensed under the Apache License, Version 2.0 (the "License");
  you may not use this file except in compliance with the License.
  You may obtain a copy of the License at

       http://www.apache.org/licenses/LICENSE-2.0

  Unless required by applicable law or agreed to in writing, software
  distributed under the License is distributed on an "AS IS" BASIS,
  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  See the License for the specific language governing permissions and
  limitations under the License.