MPP Solar Inverter Python Package

Note refactor underway - code likely broken / changing

use the 'stable' release 0.4.6

Note: python2 no longer supported

Python package with reference library of serial commands (and responses) for MPP and similar inverters, some known to work (to varying amounts):

• PIP-4048MS
• IPS-4000WM
• Voltronic Axpert MKS 5KVA Off-grid Inverter-Chargers
• LV5048

Also supports JK BMS

• JK-B2A24S (HW version 3.0)
• JK-B1A24S (HW version 3.0)

Good overview and technical discussion here http://forums.aeva.asn.au/viewtopic.php?f=31&t=4332

Tested On

• Raspberry Pi 3
• 2x USB to serial adapters (like https://www.adafruit.com/product/18)
• connected to 2x PIP-4048MS inverters connected in parallel

Also

• Raspberry Pi 3
• USB cable to USB port of inverter
• connected to 1x PIP-4048MS (/dev/hidraw0 on Pi)

Also

• Raspberry Pi
• 3x USB to serial adapters
• connected to 3x LV5048 inverters

Also

• Ubuntu 2020.04
• Direct USB connection to Inverter (LV5048)
• see documented approach

Install (from source)

• Download or clone the repo
• From the directory that has the requirements files:
  • sudo pip install -r requirements.txt # for the minimal install (dependances must be installed manually)
  • sudo pip install -r requirements-serial.txt # for the mqtt install (includes pyserial)
  • sudo pip install -r requirements-full.txt # for the full install (includes pyserial, mqtt and bluepy) Note: need sudo apt-get install libglib2.0-dev for bluepy

Documented Ubuntu Install

venv Install

for when you want to keep the install and dependencies separate from the rest of the environment

• create venv folder mkdir ~/venv
• create venv python3 -m venv ~/venv/mppsolar
  • might need python3-venv installed
• activate venv source venv/mppsolar/bin/activate (needed each time before using)
• pip install from git pip install -e "git+https://github.com/jblance/mpp-solar.git#egg=mpp-solar" (only needed if the code is updated)

see worked example here

MQTT / Influx / Grafana Setup

Instruction of one way of connecting the inverter output to Grafana Setup Instructions

Example Usage

Usage

Protocol / Command Documentation

Protocol Index Interface