最近在对接工业设备时，发现很多新手工程师对 MODBUS 协议中的“地址代码2”感到困惑，不清楚它具体指代什么，在配置软件或编写程序时经常填错，导致通讯失败。本文将彻底厘清 MODBUS 地址的编码规则，特别是常说的“地址代码2”的真实含义，并提供从理论到实战的完整解析，包含 PLC、组态软件及代码示例。无论你是做上位机开发、SCADA 系统集成，还是设备调试，都能通过本文建立清晰的 MODBUS 地址映射知识体系，避免踩坑。
1. MODBUS 地址基础与编码混乱的根源
在深入“地址代码2”之前，我们必须理解 MODBUS 协议中地址混乱现象的根源。MODBUS 作为一种应用层报文协议，其核心是读写设备内部的寄存器或线圈。但不同厂商、不同软件对同一数据区域的“称呼”和“编码”方式不同，导致了著名的“MODBUS 地址偏移”问题。
1.1 四种基本数据类型
MODBUS 协议主要定义了四种基本数据类型，每种类型都有独立的地址空间：
- 线圈（Coils）：可读可写的布尔量（1位），常用于控制设备的开关量输出，如继电器、指示灯。功能码：01（读），05（写单个），15（写多个）。
- 离散输入（Discrete Inputs）：只读的布尔量（1位），常用于反映设备的开关量输入状态，如按钮、传感器。功能码：02（读）。
- 保持寄存器（Holding Registers）：可读可写的16位整数（也可组合表示32位浮点数等），常用于存储设备参数、设定值等。功能码：03（读），06（写单个），16（写多个）。
- 输入寄存器（Input Registers）：只读的16位整数，常用于反映设备的模拟量输入，如温度、压力变送器的值。功能码：04（读）。
1.2 三种主流地址表示法
正是对这四种数据类型的“编号”方式不同，产生了混淆。主要有三种约定：
- PLC 地址（或协议地址）：这是 MODBUS 协议报文帧中实际使用的地址。它的范围是0x0000 到 0xFFFF（0-65535）。例如，要读取第一个保持寄存器，报文中的地址字段就是
0x0000。 - MODBUS 数据模型地址：这是一种带前缀的表示法，用于在文档或软件中清晰地区分数据类型。它不在报文中直接使用。
0xxxx： 线圈， 例如00001表示第一个线圈。1xxxx： 离散输入，例如10001表示第一个离散输入。3xxxx： 输入寄存器，例如30001表示第一个输入寄存器。4xxxx： 保持寄存器，例如40001表示第一个保持寄存器。 这里的xxxx部分通常从1开始计数。
- 软件/设备厂商自定义地址：许多组态软件（如力控、组态王）或PLC编程软件，为了符合用户习惯（喜欢从1开始数数），会在内部对“协议地址”做一个偏移。这是“地址代码2”这类说法出现的直接原因。
核心矛盾：当一个设备手册说“温度值地址为 40001”，而你的软件里需要填“地址代码”时，你应该填40001、40000还是0？这取决于软件采用的是哪种表示法。
2. “地址代码2” 深度解析
“地址代码2”这个说法，通常出现在国内一些组态软件、数据采集平台或老旧设备的参数表中。它不是一个标准术语，而是一个特定上下文下的简写或选项。
2.1 “地址代码2”的常见含义
在绝大多数出现此说法的场景中，“地址代码2”指的是“基于0起始的十进制协议地址”，并且通常是针对保持寄存器（4xxxx）而言的。
让我们通过一个对照表来理解：
| 数据模型地址（文档常用） | 协议地址（报文使用） | “地址代码2”（软件中可能填写） | 说明 |
|---|---|---|---|
| 40001 | 0x0000 (十进制 0) | 0 | 第一个保持寄存器 |
| 40002 | 0x0001 (十进制 1) | 1 | 第二个保持寄存器 |
| 40010 | 0x0009 (十进制 9) | 9 | 第十个保持寄存器 |
| 40100 | 0x0063 (十进制 99) | 99 | 第100个保持寄存器 |
结论：如果你的设备手册指出某个参数在保持寄存器 40100，而配置软件要求你填写“地址代码2”，那么你大概率应该填写99。计算公式：地址代码2 = 数据模型地址的后五位 - 1。例如 40100 ->100 - 1 = 99。
2.2 为什么会有“代码1”、“代码2”？
在一些软件的下拉菜单或配置项中，你可能会看到：
- 地址格式：代码1-> 对应“数据模型地址”，如
40001。 - 地址格式：代码2-> 对应“协议地址（十进制）”，如
0。
软件提供这个选项，是为了兼容不同设备厂家的文档习惯。作为开发者或工程师，你的关键任务是确定设备厂家使用的是哪种地址表示法，然后在软件中选择对应的“代码”。
2.3 如何确定该用哪种地址？
- 查阅设备手册：这是最权威的方式。手册中“MODBUS 地址表”一节会明确列出参数地址。注意看它是
4xxxx，4xxx， 还是直接以0开始的0xxxx。 - 使用调试工具验证：使用 MODBUS 调试助手（如 Modbus Poll、QModMaster）进行测试。如果你用“代码2”（地址填0）能正确读到“40001”的数据，那就验证了你的判断。
- 观察软件上下文：配置软件旁边的提示或帮助文档，有时会写明“代码2即从0开始的地址”。
3. 环境与工具准备
在开始实战前，我们需要统一实验环境。本文示例将涵盖模拟测试和真实代码开发。
3.1 软件工具
- MODBUS 从站模拟器：用于模拟一个PLC或智能仪表。推荐
Modbus Slave（与Modbus Poll配套）或开源的pyModbusSlave。 - MODBUS 主站调试工具：用于手动发送指令、验证地址。推荐
Modbus Poll或QModMaster。 - 开发环境：
- Python：使用
pymodbus库。准备 Python 3.8+ 环境。 - Java：使用
com.infiniteautomation:modbus4j库。准备 JDK 8+ 和 Maven。 - C#：使用
NModbus库。准备 .NET Core 或 .NET Framework。
- Python：使用
3.2 模拟从站配置
我们创建一个简单的从站，定义以下数据点用于后续测试：
- 保持寄存器 40001：设备温度（整数，假设值为 250，代表25.0°C）
- 保持寄存器 40002：设备压力（整数，假设值为 1000）
- 线圈 00001： 运行状态（1=运行）
- 输入寄存器 30001： 模拟量输入（只读）
在Modbus Slave中配置：
- Connection -> Connect， 选择 TCP 或 RTU（本文以TCP为例，端口502）。
- Setup -> Slave Definition...
- Slave ID: 1
- ️ Function: 03 Holding Register
- Address: 0 （这代表协议地址，对应40001）
- Length: 10
- 在数据窗口的地址0处双击，输入值
250；地址1处输入1000。
4. 使用调试工具验证“地址代码2”
现在，我们用主站调试工具连接从站，验证地址映射。
4.1 场景一：读取保持寄存器 40100（实际是40002）
- 设备手册描述：压力值存储在保持寄存器 40002。
- 软件配置（使用“代码2”）：
- 在 Modbus Poll 中，新建一个查询窗口。
- Function: 03 (Read Holding Registers)
- Address:1（因为 40002 ->
2 - 1 = 1） - Quantity: 1
- Slave ID: 1
- 预期结果：读取到值
1000。 - 报文分析：工具发出的请求报文会是
[Slave ID] [03] [00 01] [00 01] [CRC]。这里的00 01就是十进制1的十六进制表示，即协议地址。
4.2 场景二：读取线圈 00001
- 设备手册描述：运行状态在线圈 00001。
- 软件配置（使用“代码2”）：
- 注意：对于线圈，其协议地址范围也是 0-65535。
00001对应协议地址0。 - Function: 01 (Read Coils)
- Address:0
- Quantity: 1
- 注意：对于线圈，其协议地址范围也是 0-65535。
- 预期结果：读取到 ON (1)。
关键点：“地址代码2”的规则（地址-1）通常只应用于保持寄存器（4xxxx）和输入寄存器（3xxxx）。对于线圈（0xxxx）和离散输入（1xxxx），00001直接对应协议地址0，10001也对应协议地址0。但在一些软件中，可能会为线圈单独提供一个“0x”或“Coil”的地址类型选择，此时直接填1即可，软件内部会处理偏移。最稳妥的方式是查阅你所使用软件的帮助文档。
5. 在代码中处理 MODBUS 地址
在编程时，我们需要根据所使用的库的约定来传入地址。大多数底层库要求传入的是协议地址。
5.1 Python (pymodbus) 示例
pymodbus库要求使用从0开始的协议地址。
# 示例：读取保持寄存器 40001 和 40002 from pymodbus.client import ModbusTcpClient def read_holding_registers(): # 连接到模拟从站 client = ModbusTcpClient('127.0.0.1', port=502) if not client.connect(): print("连接失败") return try: # 读取从协议地址0开始的两个寄存器（对应40001和40002） # “地址代码2” 在这里就是 0 和 1 response = client.read_holding_registers(address=0, count=2, slave=1) if not response.isError(): registers = response.registers print(f"寄存器 40001 (地址0) 的值: {registers[0]}") # 应输出 250 print(f"寄存器 40002 (地址1) 的值: {registers[1]}") # 应输出 1000 else: print(f"读取错误: {response}") finally: client.close() if __name__ == "__main__": read_holding_registers()5.2 Java (modbus4j) 示例
modbus4j同样使用基于0的协议地址。
// Maven 依赖 // <dependency> // <groupId>com.infiniteautomation</groupId> // <artifactId>modbus4j</artifactId> // <version>3.1.0</version> // </dependency> import com.serotonin.modbus4j.ModbusFactory; import com.serotonin.modbus4j.ModbusMaster; import com.serotonin.modbus4j.ip.IpParameters; import com.serotonin.modbus4j.locator.BaseLocator; public class ModbusAddressDemo { public static void main(String[] args) throws Exception { ModbusFactory factory = new ModbusFactory(); IpParameters ipParams = new IpParameters(); ipParams.setHost("127.0.0.1"); ipParams.setPort(502); ModbusMaster master = factory.createTcpMaster(ipParams, true); master.setTimeout(3000); master.setRetries(1); try { master.init(); // 定义要读取的保持寄存器位置：协议地址0（40001） // 这里的 “2” 是 Modbus4j 内部定义 Holding Register 的常量，不是地址代码 BaseLocator<Number> locator = BaseLocator.holdingRegister(1, 0); // (slaveId, 协议地址) // 读取 Number value = master.getValue(locator); System.out.println("保持寄存器 40001 (协议地址0) 的值: " + value); // 应输出 250 // 读取协议地址1（40002） BaseLocator<Number> locator2 = BaseLocator.holdingRegister(1, 1); Number value2 = master.getValue(locator2); System.out.println("保持寄存器 40002 (协议地址1) 的值: " + value2); // 应输出 1000 } finally { master.destroy(); } } }5.3 C# (NModbus) 示例
NModbus 库也遵循协议地址规范。
// NuGet 安装 NModbus using Modbus.Device; using System.Net.Sockets; class Program { static void Main(string[] args) { TcpClient tcpClient = new TcpClient("127.0.0.1", 502); ModbusIpMaster master = ModbusIpMaster.CreateIp(tcpClient); // 读取保持寄存器：从协议地址0开始，读取2个 // 对应 40001 和 40002 ushort[] registers = master.ReadHoldingRegisters(1, 0, 2); // (slaveId, startAddress, numberOfPoints) Console.WriteLine($"寄存器 40001 (地址0) 的值: {registers[0]}"); // 250 Console.WriteLine($"寄存器 40002 (地址1) 的值: {registers[1]}"); // 1000 tcpClient.Close(); } }代码总结：在几乎所有编程库中，你都需要将“数据模型地址”（如40001）转换为“协议地址”（如0）再传入函数。这个转换逻辑协议地址 = 数据模型地址的后五位 - 1需要你在业务代码中实现。
6. 常见问题与排查思路
MODBUS 通讯问题，80%与地址映射错误有关。以下是一个排查清单。
| 问题现象 | 可能原因 | 排查步骤与解决方案 |
|---|---|---|
| 读取返回全是0或错误值 | 地址映射错误（最常见） | 1. 确认设备手册地址格式（4xxxx还是0x…）。 2. 确认软件/代码中使用的地址格式（代码1还是代码2）。 3. 使用调试工具，分别用“地址0”和“地址1”尝试读取同一个参数，看哪个能返回正确值。 |
| 通讯超时或无响应 | 1. 物理连接问题（串口线、网线） 2. 从站地址（Slave ID）错误 3. 波特率、校验位等串口参数不匹配（RTU） | 1. 检查线缆、接口、电源。 2. 确认设备设置的从站地址（默认为1）。 3. 使用串口助手先测试物理链路，再核对所有串口通讯参数。 |
| 返回异常错误码（如0x02, 0x03） | 1. 功能码不支持 2. 请求的地址超出设备范围 3. 数据量超限 | 1. 0x02（非法数据地址）：检查地址是否正确，设备是否有该地址。 2. 0x01（非法功能码）：确认设备是否支持该功能码（如尝试写只读寄存器）。 3. 减少单次请求的数量（Quantity）。 |
| 数据值不正确（如放大10倍） | 数据格式解析错误 | MODBUS寄存器通常只传原始整数。需要根据手册进行转换： - 除以10/100得到浮点值。 - 两个寄存器组合成32位整数或浮点数（注意字节序和字序）。 |
| 部分地址通，部分不通 | 设备内部地址不连续或存在“保留”区域 | 仔细查阅设备地址表，确认每个功能区域的起始地址和长度。不要假设地址是连续的。 |
7. 最佳实践与工程建议
在实际工业项目中，规范地处理 MODBUS 地址能极大提升系统稳定性和可维护性。
建立地址映射配置文件： 不要将硬编码的地址散落在代码中。建议使用配置文件（如 JSON、YAML）或数据库来管理所有测点地址。配置项应包含：设备ID、数据模型地址、协议地址、数据类型、缩放系数、单位等。
# points_config.yaml devices: - id: furnace_1 slave_id: 1 points: - name: "temperature" model_address: 40001 protocol_address: 0 data_type: "uint16" scale: 0.1 unit: "°C" - name: "pressure" model_address: 40002 protocol_address: 1 data_type: "uint16" scale: 1 unit: "kPa"实现统一的地址转换层： 在代码中抽象出一个
AddressTranslator类或函数，专门负责将“数据模型地址”转换为底层库所需的“协议地址”。这样，业务逻辑层只需要关心40001， 转换层负责处理-1的逻辑。详细记录与注释： 在项目文档中，必须为每个设备维护一份 MODBUS 地址表，并明确注明厂家使用的地址表示法。在代码中，为每个读写操作添加注释，说明其对应的实际物理意义和原始地址。
进行全面的地址测试： 在新设备接入时，编写一个简单的测试脚本，遍历设备手册中所有重要的地址，验证读写是否正常，数据解析是否正确。这能提前发现地址映射或数据格式问题。
处理字序与字节序： 对于32位浮点数、64位整数等跨寄存器的数据类型，不同设备厂商可能采用不同的字节序（Big-Endian, Little-Endian）和字序（Word-Swap）。这是另一个常见的坑。必须在地址映射配置中增加
byte_order和word_order字段，并在数据解析层正确处理。
理解“MODBUS地址代码2”本质上是理解了MODBUS协议应用层与底层报文之间的桥梁。核心规则就是牢记协议地址 = 数据模型地址的后五位 - 1（主要针对寄存器）。在具体工作中，第一原则永远是查阅设备手册，第二原则是用调试工具验证。将地址映射规则封装在配置和转换层中，能使你的工业通讯程序更加健壮和清晰。下次再遇到地址配置问题时，不妨先问自己：这个地址，是给协议看的，还是给人看的？
