Home Assistant integration

Choose your integration

Open the device Settings page (http://<DEVICE-IP>/settings). Both options are configured from there. Pick one — they are independent and can be enabled/disabled separately.

Option 1 — MQTT auto-discovery

Recommended if you already use the Mosquitto / MQTT broker add-on in Home Assistant. Once the broker connection is set, the device publishes Home Assistant discovery configs to standard homeassistant/sensor/… topics, and sensors appear in Settings → Devices & Services → MQTT within a few seconds — grouped under a single device named Pylon-Monitor.com.

What you fill in on the device

On the device Settings page, open the MQTT Home Assistant card and fill these four fields exactly as the firmware expects them:

Save. The Pylon-Monitor's dashboard MQTT row turns blue (Connected) within ~5 seconds. To disable MQTT, simply clear the four fields and save.

Topics the firmware publishes

The device hostname (default pylon-monitor) is used as the topic prefix and discovery node id. Replace it below with the hostname you chose.

All four sensors share a single state topic from which they pull their values:

pylon-monitor/state

The payload published a few times per minute looks like this:

{
  "soc": 94,
  "voltage": 48.62,
  "power": -350.1,
  "soh": 96,
  "temp": 23.4
}

The temp field (battery base temperature) is published in every state message but isn't exposed via auto-discovery in the current firmware. If you need it in HA via MQTT, add a manual mqtt sensor: entry pointing at the same state topic and value_template {{ value_json.temp }}.

Option 2 — REST API polling

No MQTT broker required. Home Assistant's built-in rest platform polls the device every 30 seconds and creates 6 sensors. The YAML block below is the exact one the firmware itself generates inside the Settings page (with your current IP pre-filled) — copy-paste it from there for zero typing, or use the version below.

The JSON the device returns

GET http://<DEVICE-IP>/api.json

{
  "system": "pylon-monitor",
  "firmware": "v1.1",
  "summary": {
    "soc": 94,
    "soh": 96,
    "voltage": 48.62,
    "current": -7.20,
    "power": -350.10,
    "state": "Discharge"
  }
}

Paste this in configuration.yaml

rest:
  - resource: http://<DEVICE-IP>/api.json
    scan_interval: 30
    sensor:
      - name: "Pylontech SOC"
        unique_id: pylontech_soc
        value_template: "{{ value_json.summary.soc }}"
        unit_of_measurement: "%"
        device_class: battery
        state_class: measurement
      - name: "Pylontech SOH"
        unique_id: pylontech_soh
        value_template: "{{ value_json.summary.soh }}"
        unit_of_measurement: "%"
        state_class: measurement
      - name: "Pylontech Voltage"
        unique_id: pylontech_voltage
        value_template: "{{ value_json.summary.voltage }}"
        unit_of_measurement: "V"
        device_class: voltage
        state_class: measurement
      - name: "Pylontech Current"
        unique_id: pylontech_current
        value_template: "{{ value_json.summary.current }}"
        unit_of_measurement: "A"
        device_class: current
        state_class: measurement
      - name: "Pylontech Power"
        unique_id: pylontech_power
        value_template: "{{ value_json.summary.power }}"
        unit_of_measurement: "W"
        device_class: power
        state_class: measurement
      - name: "Pylontech State"
        unique_id: pylontech_state
        value_template: "{{ value_json.summary.state }}"

Restart Home Assistant. The 6 sensors appear under Settings → Devices & Services → Entities, searchable by pylontech.

Node-RED

Use an http request node, method GET, URL http://<DEVICE-IP>/api.json, return a parsed JSON object. Then read msg.payload.summary.soc (or any other field) downstream. If MQTT is configured on the device, you can also subscribe directly to pylon-monitor/state with an MQTT-in node — no polling needed.

Jeedom

Install the JSON plugin, point an equipment to http://<DEVICE-IP>/api.json, then map JSON paths to commands (e.g. summary>soc, summary>voltage, summary>state).