Renogy Inverter BLE Sensor

The renogy_inverter_ble sensor platform reads live data from a Renogy inverter with built-in Bluetooth over Bluetooth Low Energy — for example the Renogy PUH 12V 3000W Pure Sine Wave Inverter (with UPS transfer switch, SKU RIV1230PU-126) and other units in the RNGRIU family.

These inverters speak Modbus over BLE, but require a proprietary “wake” read on a vendor characteristic before they answer any request — which is why a generic Modbus Controller over a BLE bridge times out against them. This component performs that handshake, then reads the inverter’s holding registers and publishes the values.

It depends on the BLE Client component, which in turn requires the ESP32 BLE Tracker.

Finding the inverter’s MAC address

The inverter’s BLE MAC address is not the same as the UUID shown by some operating systems. To find it, flash a temporary tracker build and watch the logs for a device whose name starts with RNGRIU:

logger:
  level: DEBUG

esp32_ble_tracker:
  on_ble_advertise:
    then:
      - lambda: |-
          ESP_LOGD("scan", "Found %s '%s'", x.address_str().c_str(), x.get_name().c_str());

A phone app such as nRF Connect can also be used. Once you have the MAC, remove the tracker logging and configure the component below.

Configuration example

esp32_ble_tracker:

ble_client:
  - mac_address: AA:BB:CC:DD:EE:FF  # the inverter's BLE MAC (RNGRIU…)
    id: inverter_client

renogy_inverter_ble:
  - id: inverter0
    ble_client_id: inverter_client
    update_interval: 30s

sensor:
  - platform: renogy_inverter_ble
    renogy_inverter_ble_id: inverter0
    ac_output_voltage:
      name: "Inverter Output Voltage"
    battery_voltage:
      name: "Inverter Battery Voltage"
    load_active_power:
      name: "Inverter Load Power"
    temperature:
      name: "Inverter Temperature"

Hub configuration variables

id (Optional, ID): Manually specify the ID used for code generation.
ble_client_id (Required, ID): The ID of the BLE Client to read from.
update_interval (Optional, Time): The interval to poll the inverter. Defaults to 30s.

Sensor configuration variables