Esphome Modbus Register 43: Total Battery Percent
Technical documentation for Modbus register 43 on Esphome. Data type: U WORD. Includes Python and YAML configuration examples.
January 16, 2026
•
3 read
Technical Definition
The register Total Battery Percent at address 43 is used to monitor total battery percent on the Esphome.
- Protocol: Modbus RTU
- Data Type: U WORD
- 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 Total Battery Percent (Address: 43)
# Note: Check if your device uses 0-based or 1-based addressing
result = client.read_input_registers(address=43, 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: "Total Battery Percent"
address: 43
value_type: U_WORD
unit_of_measurement: "%"
Connection Diagram
Here is the standard RS485 wiring for this configuration:
graph TD
PLC[Host Controller / Home Assistant]
Device[Esphome]
PLC -- "A+ (D+)" --> Device
PLC -- "B- (D-)" --> Device
PLC -- GND --> Device
💡 Engineer's Insight
Analysis: State of charge of the battery as a percentage. Range is 0-100%.
Troubleshooting: Battery disconnected, faulty battery, BMS communication error, or calibration issue.