Skip to content
John Blance edited this page Mar 14, 2024 · 14 revisions

mpp-solar Device Python Package

Python package with reference library of commands (and responses) designed to get information from inverters and other solar inverters and power devices

Currently has support for:

  • MPP-Solar and similar inverters, e.g.
    • PIP-4048MS
    • IPS-4000WM
    • Voltronic Axpert MKS 5KVA Off-grid Inverter-Chargers
    • LV5048
  • JK BMS
    • JK-B2A24S (HW version 3.0)
    • JK-B1A24S (HW version 3.0)
  • Victron VE Direct Devices:
    • tested on SmartShunt 500A
  • Daly BMS

Compute hardware support

The python code is designed to run on Linux type python environments using python 3.10 or newer

Hardware that has been known to work

Installation

to get the latest stable version:

  • pip install mppsolar (minimal install), or
  • pip install mppsolar[ble] (install including BLE support aka jkbms), or
  • docker pull jblance/mppsolar:latest (docker install)

more installation options

Usage

$ mpp-solar -h will display the available options

More detailed usage

Protocol Selection

All devices need to have their commands and responses 'interpreted' / decoded. This uses a protocol definition.

Many inverters will 'tell' you the protocol they support, unfortunately there are multiple versions of the same protocol (for example protocol PI30 has many differences in different models)

The default protocol for mpp-solar is the base PI30 protocol

There is a database of device details and recommended protocols here

Troubleshooting

Troubleshooting

Clone this wiki locally