Renogy BLE Integration for Home Assistant

This custom Home Assistant integration provides monitoring capabilities for Renogy devices over Bluetooth Low Energy (BLE). Charge controllers and DCC chargers use BT-1 or BT-2 modules; Renogy inverters advertise directly over BLE as RNGRIU*; Smart Shunt 300 devices advertise directly over BLE as RTMShunt300*.

Disclaimer: This integration is experimental software. Use caution when controlling electrical loads, and ensure any connected equipment is properly rated and protected.

Currently Supported Devices

Tested:

• Renogy Rover
• Renogy Wanderer
• Renogy DC-DC Charger
• Renogy Smart Shunt 300
• Renogy inverters advertising RNGRIU*

Should work, but untested:

• Renogy Adventurer

Features

• Automatic discovery of Renogy BLE devices
• Automatic discovery of Renogy inverter devices advertising RNGRIU*
• Automatic discovery of Smart Shunt 300 devices advertising RTMShunt300*
• Monitor battery status (voltage, current, temperature, charge state)
• Monitor solar panel (PV) performance metrics
• Monitor load status and statistics
• Monitor inverter AC output, frequency, load power, temperature, and diagnostic metadata
• Monitor Smart Shunt voltage, current, power, state of charge, and derived energy
• Turn the DC load output on/off (supported controllers only)
• Monitor controller information
• All data exposed as Home Assistant sensors
• Energy dashboard compatible sensors
• Configurable polling interval
• Automatic error recovery

Prerequisites

• Home Assistant instance (version 2025.3 or newer)
• A compatible Bluetooth adapter on your Home Assistant host device
• Bluetooth discovery enabled in Home Assistant

Hardware

Includes Amazon affiliate links which provide a small commission to support this project.

• Compatible Renogy device (see above)
• Charge controllers and DCC chargers require a BT-1 or BT-2 Bluetooth module.
• Renogy inverters advertise directly over BLE as RNGRIU*.
• Smart Shunt 300 devices use their built-in BLE radio and do not require a BT-1 or BT-2 dongle.
• Make sure to purchase the correct module for your device. Different devices use different ports.
• Bluetooth radio for Home Assistant
• ESP32 for Bluetooth proxy (Recommended)
• USB Bluetooth adapter

Installation

This integration can be installed via HACS (Home Assistant Community Store).

1. Ensure you have HACS installed
2. Search for "Renogy" in the HACS store and install it
3. Restart Home Assistant

Configuration

The integration is configurable through the Home Assistant UI after installation:

1. Go to Settings > Devices & Services
2. Click the "+ Add Integration" button
3. Search for "Renogy" and select it
4. The integration will automatically start scanning for devices

Advanced Configuration Options

• Polling Interval: Adjust how frequently the device is polled (10-600 seconds, default: 60)
• Can be configured per device in the device settings
• Lower values provide more frequent updates but may impact battery life
• Connection Mode: Starting in 0.6.0, devices expose connection mode options in the config entry options flow
• Smart Shunt 300 devices support sustained and intermittent
• Controllers, DCC chargers, and inverters support intermittent and persistent_session
• See docs/connection-modes.md for behavior and recommendations

Sensors

The integration provides the following sensor groups:

Battery Sensors

• Voltage
• Current
• Temperature
• State of Charge
• Charging Status

Solar Panel (PV) Sensors

• Voltage
• Current
• Power
• Daily Generation
• Total Generation

Load Sensors

• Status
• Current Draw
• Power Consumption
• Daily Usage

Inverter Sensors

• Battery Voltage
• AC Output Voltage
• AC Output Current
• AC Output Frequency
• Input Frequency
• Load Active Power
• Load Apparent Power
• Temperature
• Device ID
• Model

DC Load Control

Some Renogy charge controllers expose a controllable DC load output. This integration creates a switch entity that can turn the DC load on or off.

Caution: This feature is experimental. Write commands may be interpreted differently by devices or firmware versions, which could cause unexpected load behavior. Use appropriate fusing and wiring, and verify behavior in a safe test setup before relying on it.

Controller Info

• Temperature
• Device Information
• Operating Status

Smart Shunt Sensors

• Shunt Voltage
• Shunt Current
• Shunt Power
• Shunt State of Charge
• Shunt Charge Status
• Shunt Energy

Caution: Shunt support is experimental.

All sensors are automatically added to Home Assistant's Energy Dashboard where applicable.

Troubleshooting

Enable Debug Logging

It can be extremely helpful to enable debug logging when troubleshooting issues.

1. Open your Home Assistant instance and navigate to the Renogy integration
2. Select "Enable debug logging"
3. Navigate to the Home Assistant Core logs
4. Select the three dots in the top right and choose "Show raw logs"

Device Not Found

1. Verify the device is supported by this integration
2. For controllers or DCC chargers, confirm a BT-1 or BT-2 module is installed
3. For inverter devices, confirm the BLE name starts with RNGRIU
4. For Smart Shunt 300 devices, confirm the BLE name starts with RTMShunt300
5. Check that Bluetooth is enabled on your Home Assistant host
6. Ensure the device is within range (typically 10m/33ft)
7. Restart the Bluetooth adapter

Connection Issues

• If the device shows as unavailable:
• Check the device is powered on
• Verify it's within range
• Check Home Assistant logs for specific error messages
• Try reducing the polling interval temporarily for testing

Data Accuracy

• Verify your device firmware is up to date
• Check the Renogy app to compare readings
• Note that some values (like daily totals) reset at midnight
• Smart Shunt energy is integration-derived rather than read directly from the device

Support

• For bugs, please open an issue on GitHub
• Include Home Assistant logs and your device model information

License

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.