Skip to main content

About

This is an addon for 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:
...
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:
...
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")
    }
    ...
]
...

Metadata

Release files for qtoggleserver-mppsolar 1.7.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for qtoggleserver-mppsolar 1.7.3
File Size Uploaded
qtoggleserver_mppsolar-1.7.3.tar.gz 17.0 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for qtoggleserver-mppsolar 1.7.3
File Interpreter ABI Platform
qtoggleserver_mppsolar-1.7.3-py3-none-any.whl Python 3 none any Details

Total release size: 40.7 kB

Release files / qtoggleserver_mppsolar-1.7.3.tar.gz

Download URL qtoggleserver_mppsolar-1.7.3.tar.gz
Size 17.0 kB
Tags Source
SHA-256 checksum
How to use checksums
b92a73a4ca0ab840e2d4d59d404443b160a9bed2cd4b7d2d272e8c8764f004af
BLAKE2b-256 checksum
How to use checksums
885ff8a75a9ddee3d4cab1f705d4f9a380090c3a8e919446d5008aada3a191a7
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.14

Release files / qtoggleserver_mppsolar-1.7.3-py3-none-any.whl

Download URL qtoggleserver_mppsolar-1.7.3-py3-none-any.whl
Size 23.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
c6460ad56dde926bbd0062a889be28439b5be7e48a68c7286fe1d2bed8094b55
BLAKE2b-256 checksum
How to use checksums
b2610cfc832c36012e9479014414b6be2e9181f2b503d223e9340665addde02a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.14
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page