Deye Inverter Entities Sensor Modbus Register 217: Name inverter name battery capacity shutdown

Technical Definition

The register name inverter name battery capacity shutdown at address 217 is used to monitor name inverter name battery capacity shutdown on the Deye Inverter Entities Sensor.

• 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 name inverter_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: "name inverter_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[Deye Inverter Entities Sensor]

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

💡 Engineer's Insight

Analysis: Battery State of Charge (SoC %) at which the inverter will shut down to prevent deep discharge.

Troubleshooting: Zero could indicate disabled protection or a communication error. Check battery BMS and inverter configuration.