Skip to main content
Version: Next

EDV25P-4 Modbus RTU 协议说明

EDV25P-4(RS485 / Modbus 版)Modbus RTU 协议在线版,整理自知识库《EDV2XX Modbus RTU 协议说明》V1.1(2026-07-15)

适用范围与版本​

本文档定义 EDV25P-4(RS485 / Modbus 版)所用固件 EDV2XX-CTRL-FW 的 RS485 / Modbus RTU 协议,适用于 0x0000 起的 Holding Registers 与 0x1000 起的 Input Registers 的读写,以及 apply_command / apply_result 配置下发流程。

  • 协议层:Modbus RTU 从机(标准 Modbus 类总线协议)
  • 物理层:RS485 半双工总线(EDV25P-4 通过 A / B 端子接入)
  • 角色关系:上位机 / PLC / 网关为主站,EDV25P-4 为从站

:::info 版本说明 本页为 V1.1 版本,相对 V1.0 的变更为 EDV25P-4 实现对齐:新增扩展基础参数(0x00D0-0x00D2)、输入寄存器扩展(0x100B-0x100F)、设备信息块(0x1B20);0x000F 功能确认。文中标注 🆕 的条目为 V1.1 新增内容。 :::

版本信息​

序号版本日期作者变更说明
1V1.0--初始版本,基础 Modbus RTU 协议定义
2V1.12026-07-15gongdezhiEDV25P-4 实现对齐:新增扩展基础参数(0x00D0-0x00D2)、输入寄存器扩展(0x100B-0x100F)、设备信息块(0x1B20);0x000F 功能确认

🆕 标记为 V1.1 新增内容

1. 适用范围​

本文档定义 EDV2XX-CTRL-FW 当前项目的 RS485 / Modbus RTU 协议。

设计原则:

  1. 保持当前 Modbus RTU 功能码与基础寄存器模型稳定
  2. 保持全局参数、总体检测边界、分区配置、分区结果的统一结构
  3. 增加控制板联网参数、工作模式与雷达扩展状态

2. 协议角色​

项目说明
物理层RS485 半双工 / UART 直连(由具体板型决定)
协议层Modbus RTU 从机
角色关系上位机 / PLC / 网关为主站,设备为从站

说明:

  1. 协议层采用标准 Modbus RTU 从机模型
  2. 当前项目的硬件引脚、串口实例可因板型不同而变化
  3. 对外协议不依赖 ed_unity_protocol 帧格式

3. 串口参数​

默认建议值:

项目默认值
波特率9600
数据位8
校验位None
停止位1
CRCModbus CRC16

说明:

  1. 默认建议使用 9600 8N1
  2. 当前项目扩展支持把 从站地址 + 波特率档位 作为配置项
  3. 若波特率被修改,主站必须同步切换到同样波特率

:::note 备注 EDV25P-4 的 RS485 端子为 A(RS485-A)/ B(RS485-B),供电端子为 V(DC 12-30V)/ G(GND),接线方式见规格书的「接口说明」一节。EDV25P-4 另提供蓝牙 BLE 与 UART 串口作为通用接口,用于小程序调试/参数配置与本地调试/数据透传。 :::

4. 设计原则​

4.1 不定义总人数​

目标结果按 感应区 zone_id 分组,感应区允许重叠,因此:

  • 同一目标可能出现在多个感应区结果中
  • 协议不定义全局人数 / 全局目标总数

4.2 保持三层结构​

Modbus 对外模型继续保持三层:

  1. 全局参数
  2. 总体检测边界
  3. 感应区 / 屏蔽区配置与分区结果

4.3 保持「暂存 + apply」​

配置写入采用:

  1. 先写 Holding Registers 暂存镜像
  2. 再写 apply_command
  3. 最后读 apply_result

这样可以适应更复杂的控制板与雷达配置组合,并保持寄存器访问流程清晰稳定。

5. 支持的功能码​

功能码说明
0x03读 Holding Registers
0x04读 Input Registers
0x06写单个 Holding Register
0x10写多个 Holding Registers

不支持:

  • 0x05
  • 0x0F

6. Holding Registers​

6.1 基础 Holding Registers​

以下区间构成当前协议的基础 Holding Registers:

区间说明
0x0000~0x000F基础全局参数与总体检测边界摘要
0x0010~0x0055感应区配置块
0x0080~0x00C5屏蔽区配置块
0x00F0~0x00F1apply_command / apply_result
0x00C6~0x00CF控制板与联网参数(V1.1 新增)
0x00D0~0x00D2扩展基础参数(V1.1 新增)

6.1.1 基础全局参数​

地址名称类型R/W说明
0x0000protocol_versionuint16R协议版本号
0x0001motion_sensitivityuint16R/W运动灵敏度
0x0002presence_sensitivityuint16R/W存在灵敏度
0x0003overall_presence_hold_suint16R/W整体有无人保持时间
0x0004install_height_mmuint16R/W安装高度
0x0005detect_x_min_mmint16R/W总体检测 X 最小值
0x0006detect_x_max_mmint16R/W总体检测 X 最大值
0x0007detect_y_min_mmint16R/W总体检测 Y 最小值
0x0008detect_y_max_mmint16R/W总体检测 Y 最大值
0x0009detect_z_min_mmuint16R/W总体检测 Z 最小值
0x000Adetect_z_max_mmuint16R/W总体检测 Z 最大值
0x000Bsensing_zone_countuint16R/W感应区数量
0x000Cmask_zone_countuint16R/W屏蔽区数量
0x000Dtarget_disappear_delay_suint16R/W目标消失延时
0x000Epresence_active_report_enableuint16R/W有无人变化主动上报开关
0x000Fzone1_idle_report_enableuint16R/WZone1 空闲主动上报开关

6.1.2 感应区配置块​

  • 起始地址:0x0010
  • 每区占 7 个寄存器
  • 最多 10 个感应区

结构:

偏移字段类型
+0zone_iduint16
+1x_min_mmint16
+2x_max_mmint16
+3y_min_mmint16
+4y_max_mmint16
+5z_min_mmuint16
+6z_max_mmuint16

6.1.3 屏蔽区配置块​

  • 起始地址:0x0080
  • 每区占 7 个寄存器
  • 结构与感应区相同

6.2 控制板与联网参数 Registers​

以下寄存器用于控制板工作模式、联网参数和附加通信参数:

地址名称类型R/W说明
0x00C6device_work_modeuint16R/W0=normal,1=passthrough
0x00C7rs485_addressuint16R/W从站地址,范围 1~247
0x00C8rs485_baudrate_codeuint16R/W0=9600,1=19200,2=38400,3=57600,4=115200
0x00C9radar_work_modeuint16R/W雷达工作模式
0x00CAradar_report_period_msuint16R/W雷达上报周期,单位 ms
0x00CBmqtt_enableduint16R/W0=关闭,1=开启
0x00CCmqtt_report_period_msuint16R/WMQTT 上报周期
0x00CDmqtt_portuint16R/WMQTT 端口
0x00CEpassthrough_portuint16R/WTCP 透传端口
0x00CFota_server_portuint16R/WOTA 服务器端口

6.2.1 扩展基础参数(V1.1 新增)🆕​

以下寄存器为基础全局参数的扩展,对接 BLE 协议命令:

地址名称类型R/W说明
0x00D0presence_detect_switchuint16R/W存在检测总开关,0=关闭(强制无人) 1=开启(默认),↔ BLE 0x1A
0x00D1led_switchuint16R/WLED 开关,0=关 1=开,↔ BLE 0x17
0x00D2radar_switchuint16R/W雷达开关,0=关(断电) 1=开,↔ BLE 0x23

6.3 字符串配置块​

由于 Wi-Fi / Host 字符串不适合单寄存器表达,新增固定长度字符串块:

起始地址名称长度说明
0x0200wifi_ssid_block32 regsWi-Fi SSID
0x0220wifi_password_block32 regsWi-Fi Password
0x0240mqtt_host_block32 regsMQTT Host
0x0260passthrough_host_block32 regs透传 Host
0x0280ota_server_host_block32 regsOTA 服务器 Host

编码规则建议如下:

  1. block[0]:字符串实际字节长度
  2. block[1...]:后续寄存器每个寄存器存放 2 个 ASCII 字节
  3. 未使用部分补 0x00

6.4 apply_command / apply_result​

6.4.1 0x00F0 apply_command​

值含义
0x0001应用基础全局参数
0x0002应用总体检测边界
0x0003应用感应区配置
0x0004应用屏蔽区配置
0x0005应用扩展通信参数
0x0006应用字符串配置块
0x00FF应用全部暂存配置

6.4.2 0x00F1 apply_result​

值含义
0x0000成功
0x0001基础全局参数非法
0x0002总体检测边界非法
0x0003感应区配置非法
0x0004屏蔽区配置非法
0x0005下发设备 / 雷达失败
0x0006扩展通信参数非法
0x0007字符串配置块非法

7. Input Registers​

7.1 基础 Input Registers​

以下输入寄存器用于摘要状态和分区结果读取:

地址名称类型说明
0x1000update_seq_louint16更新序号低 16 位
0x1001update_seq_hiuint16更新序号高 16 位
0x1002active_zone_bitmapuint16已启用感应区位图
0x1003occupied_zone_bitmapuint16当前有目标的感应区位图
0x1004overall_presence_stateuint16整体有无人状态

感应区结果块地址如下:

  • Zone1 = 0x1100
  • Zone2 = 0x1200
  • ...
  • Zone10 = 0x1A00

每区结构仍为:

  1. zone_id
  2. zone_target_count
  3. 最多 20 个目标槽位
    • target_id
    • x_mm
    • y_mm
    • z_mm

7.2 运行状态 Input Registers​

地址名称类型说明
0x1005fall_stateuint160=正常,1=疑似跌倒,2=确认跌倒
0x1006current_device_work_modeuint16当前控制板工作模式
0x1007current_radar_work_modeuint16当前雷达工作模式
0x1008wifi_stateuint160=未配置,1=已连接,2=连接中,3=失败
0x1009mqtt_stateuint160=关闭,1=已连接,2=连接中,3=失败
0x100Apassthrough_stateuint160=空闲,1=连接中,2=已连接,3=异常

7.2.1 扩展运行状态(V1.1 新增)🆕​

地址名称类型说明
0x100Billuminance_luxuint16光敏照度值(LTR303),单位 lux
0x100Coccupied_duration_s_louint16有人持续时长低 16 位
0x100Doccupied_duration_s_hiuint16有人持续时长高 16 位(32bit 秒值)
0x100Eno_presence_duration_s_louint16无人持续时长低 16 位
0x100Fno_presence_duration_s_hiuint16无人持续时长高 16 位(32bit 秒值)

7.3 雷达信息块​

为承载雷达扩展信息,定义只读信息块:

起始地址名称长度说明
0x1B00radar_info_block32 regs雷达产品信息 / 模块版本 / 软件 ID / 协议版本

7.3.1 设备信息块(V1.1 新增)🆕​

起始地址名称长度说明
0x1B20device_info_block32 regs控制板设备信息:型号 / 软件版本 / MAC 地址 / 能力码

编码规则与字符串配置块一致:

  1. 第一个寄存器表示实际字节长度
  2. 后续寄存器按 2 字节 ASCII 打包

8. 主动状态上报​

8.1 主动状态帧​

当前协议定义两类主动帧:

  1. overall_presence_state 变化主动上报
  2. Zone1 空闲主动上报

这样可以让串口监听场景下的状态上报保持简单直接。

8.2 新增主动状态建议​

对于当前项目增加的联网与扩展状态,建议仍以 主站轮询读取 为主,不在第一版协议中新增更多主动帧类型。

若后续确需新增,建议新增到新的独立触发开关,并保持帧格式与对应输入寄存器读取结果一致。

9. 设计约束​

  1. 已定义寄存器的含义不得重定义
  2. 已定义功能码不得变化
  3. 新功能优先通过:
    • 新增 Holding 区
    • 新字符串块
    • 新增 Input 区 来承载

附录 A:V1.1 新增寄存器汇总 🆕​

地址名称类型区说明
0x00D0presence_detect_switchuint16Holding存在检测总开关 ↔ BLE 0x1A
0x00D1led_switchuint16HoldingLED 开关 ↔ BLE 0x17
0x00D2radar_switchuint16Holding雷达开关 ↔ BLE 0x23
0x100Billuminance_luxuint16Input光敏照度值
0x100C-0x100Doccupied_duration_suint32Input有人持续时长(秒)
0x100E-0x100Fno_presence_duration_suint32Input无人持续时长(秒)
0x1B20device_info_block32 regsInput控制板设备信息块

上表全部条目均为 V1.1 新增;基础寄存器(0x0000-0x000F、0x0010-0x0055、0x0080-0x00C5、0x00F0-0x00F1、0x0200-0x0280、0x1000-0x100A、0x1B00)沿用 V1.0 定义,含义未变更。