Metadata-Version: 2.1
Name: mppsolar
Version: 0.16.39
Summary: Package to communicate with Solar inverters and BMSs
Author: John Blance
Requires-Python: >=3.11,<4.0
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Provides-Extra: ble
Provides-Extra: dev
Provides-Extra: modbus
Provides-Extra: mongo
Provides-Extra: pgsql
Provides-Extra: systemd
Requires-Dist: bluepy (>=1.3.0,<2.0.0) ; extra == "ble" or extra == "dev"
Requires-Dist: cysystemd (>=1.6.2,<2.0.0) ; extra == "systemd"
Requires-Dist: paho-mqtt (>=1.6,<2.0.0)
Requires-Dist: psycopg2-binary (>=2.9.9) ; extra == "pgsql"
Requires-Dist: pydantic (>=1.8.0)
Requires-Dist: pymodbus (>=3.6.1) ; extra == "dev" or extra == "modbus"
Requires-Dist: pymongo (>=4.6.1) ; extra == "mongo"
Requires-Dist: pyserial (>3)
Description-Content-Type: text/markdown

# MPP-Solar Device Python Package #

__BREAKING CHANGES__
- minimum python supported 3.10 for version >=0.16.0
- command separator changed to `#`
.


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
- Victron VE Direct Devices:
  - tested on SmartShunt 500A
- Daly BMS

## Install ##
- `pip install mppsolar` (minimal install), or
- `pip install mppsolar[api]` (install server stuff), or
- `pip install mppsolar[ble]` (for Bluetooth support aka jkbms), or
- `pip install mppsolar[mongo]` (for MongoDB output), or
- `pip install mppsolar[pgsql]` (for PostgreSQL output), or
- `pip install mppsolar[push]` (for Prometheus PushGateway output), or
- `pip install mppsolar[systemd]` (for `--daemon` on Linux), or
- `docker pull jblance/mppsolar:latest` (docker install)


## Documentation ##
[See the wiki for documentation](https://github.com/jblance/mpp-solar/wiki)

## Support ##
If you want to tip me for this work, you can now buy me a coffee

[![buymeacoffee1](https://user-images.githubusercontent.com/1266998/225745276-54d6a4d4-a1ed-44f9-a1f2-e99eb1aa2812.png)](https://www.buymeacoffee.com/jblance)


