EmsTechLabs Logo EmsTechLabs

Deye12 Modbus Register 590: Sun12k-Battery output power

Technical documentation for Modbus register 590 on Deye12. Data type: S WORD. Includes Python and YAML configuration examples.

January 16, 2026 3 read

Technical Definition

The register sun12k-Battery output power at address 590 is used to monitor sun12k-battery output power on the Deye12.

  • Protocol: Modbus RTU
  • Data Type: S WORD
  • Unit: W
  • 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 sun12k-Battery output power (Address: 590)
# Note: Check if your device uses 0-based or 1-based addressing
result = client.read_input_registers(address=590, 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: "sun12k-Battery output power"
  address: 590
  value_type: S_WORD
  unit_of_measurement: "W"

Connection Diagram

Here is the standard RS485 wiring for this configuration:

graph TD
    PLC[Host Controller / Home Assistant]
    Device[Deye12]

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


💡 Engineer's Insight

Analysis: Instantaneous power output from the battery in Watts (W). Positive for discharge, negative for charge.

Troubleshooting: Zero if battery is idle. Error if showing power when disconnected or during faults.