通过Modbus TCP写入华为SUN2000 KTL逆变器报错排查请求

出现Exception Response(144, 16, IllegalAddress)错误，说明设备判定你写入的地址非法，结合读取正常的情况，可从以下方向排查：

1. 功能码与寄存器写入方式不匹配 #

你当前使用的write_registers对应Modbus功能码16（写多个寄存器），但部分设备对单个可写寄存器，仅支持用功能码6（写单个寄存器，对应pymodbus的write_register函数）写入。哪怕只写一个寄存器，设备也可能拒绝功能码16的请求。

2. Modbus地址偏移规则问题 #

多数Modbus设备的文档地址是基于1的（比如40125），但pymodbus的函数参数默认是基于0的偏移量。保持寄存器的偏移量计算公式为：偏移量 = 文档地址 - 40001，因此40125对应的偏移量是40125 - 40001 = 124。
你读取成功可能是设备兼容了绝对地址，但写入时严格要求使用偏移量。

3. 设备未解锁参数修改权限 #

华为SUN2000系列逆变器通常需要先执行参数解锁操作才能修改寄存器，直接写入会被拒绝。一般流程是先向特定寄存器写入解锁码（比如部分型号需写入0xAAAA到40000地址），超时后会自动锁定。

4. 寄存器的运行状态限制 #

部分参数仅能在逆变器停机、未并网的状态下修改，如果设备当前处于并网运行状态，即使文档标注为RW，也会拒绝写入。

对应解决步骤与代码示例 #

尝试改用写单个寄存器函数

修改写入代码为：

from pymodbus.client import ModbusTcpClient as ModbusClient

client = ModbusClient('192.168.1.116', port=502)
connected = client.connect()

if connected:
    # 读取寄存器（保持原方式或改用偏移量124）
    APPD = client.read_holding_registers(40125, 1, unit=1)
    print(APPD.registers[0])

    # 改用write_register（功能码6）写入单个寄存器
    response = client.write_register(40125, 500, unit=1)
    print(response)

client.close()

验证地址偏移量是否正确

如果上述方法无效，尝试把地址换成偏移量124：

# 读取
APPD = client.read_holding_registers(124, 1, unit=1)
# 写入
response = client.write_register(124, 500, unit=1)

执行设备解锁流程

查阅华为SUN2000 KTL官方Modbus协议文档，找到参数解锁的具体步骤，示例如下（以解锁码写入40000地址为例）：

# 写入解锁码
client.write_register(0, 0xAAAA, unit=1)
# 间隔短时间后写入目标参数
response = client.write_register(40125, 500, unit=1)

检查逆变器运行状态

将逆变器切换到停机状态后，再尝试写入操作。

内容的提问来源于stack exchange，提问作者Maario