Esp%20Inverter Modbus Register 217: Friendly name Battery Capacity Shutdown

Technical Definition

The register friendly name Battery Capacity Shutdown at address 217 is used to monitor friendly name battery capacity shutdown on the Esp%20Inverter.

• Protocol: Modbus RTU
• Data Type: INT16
• Unit: %
• Access: Read Only

How to Read (Python pymodbus)

Use this code snippet to read this specific value via RS485:

from pymodbus.client.sync import ModbusSerialClient

client = ModbusSerialClient(method='rtu', port='/dev/ttyUSB0', baudrate=9600)
client.connect()

# Read friendly_name Battery Capacity Shutdown (Address: 217)
# Note: Check if your device uses 0-based or 1-based addressing
result = client.read_input_registers(address=217, count=2, unit=1)

if not result.isError():
    print(f"Raw Value: {result.registers}")
else:
    print("Error reading register")

client.close()

Integration (Home Assistant)

Paste this into your configuration.yaml:

- platform: modbus_controller
  name: "friendly_name Battery Capacity Shutdown"
  address: 217
  value_type: INT16
  unit_of_measurement: "%"

Connection Diagram

Here is the standard RS485 wiring for this configuration:

graph TD
    PLC[Host Controller / Home Assistant]
    Device[Esp%20Inverter]

    PLC -- "A+ (D+)" --> Device
    PLC -- "B- (D-)" --> Device
    PLC -- GND --> Device

💡 Engineer's Insight

Analysis: Battery capacity shutdown threshold in Ampere-hours (Ah). Preset limit to prevent deep discharge.

Troubleshooting: Incorrect setting, BMS communication failure, or system shutdown due to low capacity.