20after4 / mpp-solar

Python package to communicate to MPP Solar PIP-4048MS inverters (and similar)

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

MPP Solar Inverter Python Package

Note: python less than v3.6 not 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

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

Install

pip install -e "git+https://github.com/jblance/mpp-solar.git#egg=mpp-solar"

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

Troubleshooting

Troubleshooting

MQTT / Influx / Grafana Setup

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

Example Usage

$ mpp-solar -p /dev/hidraw0 -c QPI

$ jkbms -p 3C:A5:09:0A:AA:AA -c getInfo More detailed usage

Protocol / Command Documentation

Protocol Index Interface

About

Python package to communicate to MPP Solar PIP-4048MS inverters (and similar)

License:MIT License


Languages

Language:Python 100.0%