https://github.com/qtoggle/qtoggleserver-mppsolar

MPP Solar inverters support for qToggleServer
https://github.com/qtoggle/qtoggleserver-mppsolar

Last synced: about 1 month ago
JSON representation

MPP Solar inverters support for qToggleServer

• Host: GitHub
• URL: https://github.com/qtoggle/qtoggleserver-mppsolar
• Owner: qtoggle
• License: apache-2.0
• Created: 2020-06-06T23:04:01.000Z (almost 6 years ago)
• Default Branch: main
• Last Pushed: 2024-01-21T18:06:11.000Z (over 2 years ago)
• Last Synced: 2025-02-16T08:28:05.600Z (over 1 year ago)
• Language: Python
• Size: 49.8 KB
• Stars: 1
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.txt

Awesome Lists containing this project

README

          
## About

This is an addon for [qToggleServer](https://github.com/qtoggle/qtoggleserver).

It provides MPP Solar inverters (and similar) support for qToggleServer.

Currently, only status reading is supported. No changes to the inverter configuration can be done via this add-on.

## Install

Install using pip:

    pip install qtoggleserver-mppsolar

## Supported Models

Currently supported models include:

 * GK

 * MK

 * LV

 * MAX

## Usage

### Serial Connection

##### `qtoggleserver.conf:`

``` ini

...

peripherals = [

    ...

    {

        driver = "qtoggleserver.mppsolar.SerialMPPSolarInverter"

        name = "myinverter"             # an optional name of your choice

        serial_port = "/dev/ttyUSB0"    # use /dev/hidraw0 if using the USB connection

        serial_baud = 2400              # this is the default

        model = "GK"                    # model letters found in inverter model (e.g. "GK" for "PIP 5048GK")

        blacklist_properties = [...]    # optional list of property names to be excluded

        # optional min SoC required to force battery into discharge mode (defaults to null, i.e. disabled)

        force_battery_discharge_min_soc = 10

        # optional min grid voltage required to force battery into charge mode (defaults to null, i.e. disabled)

        force_battery_charge_grid_min_voltage = 200 

    }

    ...

]

...

```

### Bluetooth Connection

*note*: The bluetooth connection variant is limited to just a few read-only inverter properties.

##### `qtoggleserver.conf:`

``` ini

...

peripherals = [

    ...

    {

        driver = "qtoggleserver.mppsolar.BluetoothMPPSolarInverter"

        name = "myinverter"             # an optional name of your choice

        address = "00:1A:22:AA:BB:CC"   # bluetooth address of the device

        model = "GK"                    # model letters found in inverter model (e.g. "GK" for "PIP 5048GK")

    }

    ...

]

...

```