用 EDK60 桥接 EDV11P 斜装雷达——人数统计与目标轨迹跟踪
一句话:一块 EDK60_VA 开发板 + 一颗 EDV11P 侧装雷达,不用 USB 转串口芯片、不用装驱动, 把每个目标的
x / y / z坐标(cm)实时透传到 PC,画成人数统计与运动轨迹。可复现性的硬证据:连续 30 分钟(1800 s)采集,有效帧 15,483 帧、坏帧 0、重同步 0,统计窗口内帧完整率 100% (实测:2026-10-22 上板验收,见附录 A)。
⚠️ 「100%」的准确含义:该值是 P4 = 好帧 /(好帧 + 坏帧 + 重同步);坏帧为 0 时恒等于 100%,它不度量「漏帧」, 且统计窗口从 T+10 s 起算(窗口外还有 2,970 B 开机引导日志)。正确读法是「窗口内没有坏帧与重同步」,不是「绝不丢帧」。
1. 你能做出什么
接好线、烧好固件、打开上位机,你会得到一个实时人数 + 轨迹画布:人在地面走动,画布上对应出现一个带颜色的目标圈, 轨迹拖尾跟着人走;多人同时在场时人数从 1 变到 6,进出即时增减。
这颗雷达上报的是目标的真实坐标(不是原始点云、不是热力图),所以上位机侧只做「画点」这一件事, 不需要你在 PC 上做聚类、跟踪、滤波——固件侧更是一个字节都不解析,纯透传。
1.1 实测数据(30 分钟连续采集)
| 指标 | 实测值 | 判据 | 结论 |
|---|---|---|---|
| 采集时长 / 字节数 | 1800 s / 530,972 B | — | — |
| 有效帧数 | 15,483 | ≥ 1 | PASS |
| 帧完整率 | 100.0000% | ≥ 99.9% | PASS(P4 口径,见下方说明) |
| 坏帧数 / 坏帧率 | 0 / 0.0000% | < 0.1% | PASS |
| 重同步(假同步)次数 | 0 | ≤ 3 次 / 30 min | PASS |
| 未归属字节 | 1 B(0.0002%) | = 0 为 PASS,0~0.1% 为 WARN | WARN(原因已定位,非缺陷,见下) |
| msgid 跳号率 | 0.0000%(15,454 帧连续) | < 0.1% | PASS |
目标上报帧(op=0xA3 / type=0x70) | 15,454 帧,载荷异常 0 | 载荷异常 = 0 | PASS |
工作模式应答(0xA2 / 0x05) | 29 帧(每 60 s 一次保活 GET,全部有应答) | 双向通路稳定 | PASS |
| 人数分布 | 1 人×2802、2 人×1810、3 人×4920、4 人×3784、5 人×2043、6 人×95 | — | 中位数 3,峰值 6 |
感应区 zone_id | [1] | — | 单感应区 |
那 1 个「未归属字节」是什么? 是采集文件最后一个字节
0x45(偏移 530971/530972)。 采集脚本在 1800 s 到点时正好卡在一帧中间关串口,末帧被截断,帧校验器把它归为尾部垃圾。 这是采集边界效应,不是设备行为、不是丢帧(同一份数据里坏帧 0、重同步 0)。
1.2 你会得到什么
- 一条完整可复现的链路:EDV11P →(UART 921600 8N1)→ 开发板 →(原生 USB,免驱)→ PC
- 实测确认的接线表(包含一处文档冲突的定论:为什么必须插 H3)
- 两种烧录路径(网页一键 / 本地
idf.py)+ 一个「烧 0x0」的单文件合并固件 - 两种上位机(网页版
track.html/ 桌面版human_track_v1.4_side_mount.py)——网页版默认只读、写入需显式确认;桌面版会在你点「开始跟踪」时下发配置 - EDV11P 帧协议的逐字节拆解,包含校验和手算的完整过程——以及一个「手算错就永远收不到应答」的真坑
- 侧装 60° 的几何口径与调参表,以及「怎么核对设备当前配置」
- 三层排障法,覆盖本项目 95% 的现场问题
2. 需要什么
2.1 物料清单
| # | 项目 | 型号 / 规格 | 必备/可选 | 说明 |
|---|---|---|---|---|
| 1 | 开发板 | EDK60_VA V1.0(ESP32-C6-MINI-1-N4,4 MB Flash,无 PSRAM) | 必备 | 板载 USB-C,无 USB 转串口芯片(走芯片原生 USB,免驱) |
| 2 | 雷达模组 | EDV11P(侧装版固件,回读为 EDV11P_VA, V1.3.3, 0x95F0) | 必备 | 插在板子的 H3 排针上 |
| 3 | 线缆 | USB-C 数据线 | 必备 | 必须能传数据;纯充电线会出现「灯亮但电脑认不到」 |
| 4 | 固定件 | 侧装支架(60° 倾角) | 必备 | 也可用可调支架替代,但倾角要能固定 |
| 5 | 电源 | 5 V / ≥2 A 适配器 + DC-005 插头 | 可选(推荐) | 见下方供电提示;USB-C 同时接 PC 取数据 |
| 6 | PC | Windows / macOS / Linux | 必备 | 走网页版需要 Chrome / Edge 89+ |
| 7 | 卷尺 + 地面标记(胶带) | — | 可选 | 做轨迹标定时用(见 7.5) |
| 8 | 万用表 | — | 可选 | 量 H3-P 的 3.3 V 与 H3-A → IO5 通断 |
供电提示(必读):板上雷达那一路 LDO 是 AP7362-33SP-13,额定 1.5 A;EDV11P 手册给的启动峰值 < 1.2 A、 平均 < 190 mA。所以建议用 DC-005 + 5 V/≥2 A 适配器给板子供电、USB-C 只接 PC 取数据——这样浪涌有足够余量。 实测「只接 USB-C 也能烧录并稳定跑」(含 30 分钟采集),但 PC 的 USB 口限流能力差异很大(USB2 常按 500 mA 算), 一旦 5 V 轨被拉塌,塌的是整条 5 V,主控会跟着复位——现象非常像「板子坏了」。这是本 demo 的头号供电风险。
2.2 软件环境
| 软件 | 本文实测版本 | 用途 |
|---|---|---|
| ESP-IDF | v6.1.0(目标 esp32c6) | 本地编译烧录 |
| Python | 3.13(py -3 启动器) | 跑帧校验脚本;跑桌面端上位机 |
pyserial | 可选 | 只有 --port 实时抓包模式需要 |
| Chrome / Edge | 89+ | 网页版上位机(Web Serial) |
| 桌面端依赖 | PySide6、numpy、opencv-python | 只有桌面端上位机需要 |
2.3 不需要的东西
- 不需要 USB 转串口模块(CH340 / CP2102 等)
- 不需要 装任何驱动(原生 USB Serial/JTAG,设备管理器直接认成「USB 串行设备」)
- 不需要 电平转换(两边都是 3.3 V CMOS,交叉直连)
- 不需要 你在固件里写协议解析(固件只搬字节,配置全部由上位机发)
3. 接线
3.1 H3 引脚表(实测确认,请以此为准)
模组只有 4 个电气信号(VCC / GND / TX / RX)。H3 排针的丝印依次是 RES A R T G V P,
本项目只用其中 4 个:电源(P/V)、地(G)、数据入(T)、数据出(A);R 与 RES 悬空不用。
| # | H3 丝印 | 板载网络 / GPIO | 接到模组 | 方向 | 电平 |
|---|---|---|---|---|---|
| 1 | P | 3.3V_RADAR(LDO 输出) | VCC(脚 1) | 板 → 模组(供电) | 3.3 V DC |
| 2 | V | 3.3V_RADAR(与 P 同网络) | VCC(脚 1,第二供电点) | 同上 | 3.3 V DC |
| 3 | G | GND | GND(脚 2) | 共地 | 0 V |
| 4 | T | IO4(MCU 的 UART RX) | TX(脚 3,模组发送) | 模组 → MCU | 3.3 V TTL |
| 5 | A | IO5(MCU 的 UART TX) | RX(脚 4,模组接收) | MCU → 模组 | 3.3 V TTL |
| 6 | R | IO1(ADC) | 不使用(悬空) | — | — |
| 7 | RES | 复位网络 | 不使用(悬空,模组侧绝不要驱动它) | — | — |
必须交叉,不能直连:模组的 TX(脚 3)接板子的 T(IO4,即 MCU 的 RX),模组的 RX(脚 4)接板子的 A(IO5,即 MCU 的 TX)。
这是本链路唯一容易接反的地方,也是最容易「有数据但下发命令没反应」的原因。
串口参数:921600 bps / 8 数据位 / 无校验 / 1 停止位 / 无流控,协议大端。
电源使能:IO14,高有效。U4 的 EN 脚经 10 kΩ 下拉到地,所以上电默认是关的, 固件启动后主动拉高才给雷达供电——这意味着模组可以热插拔,而且 MCU 复位时雷达一定先掉电(安全的顺序)。
3.2 ⚠️ 必须插 H3,不能插 H4
板子上有两个长得几乎一样的排针,信号集合相同、顺序完全相反:
| 排针 | 丝印顺序 | 后果 |
|---|---|---|
| H3(正确) | RES A R T G V P | T=IO4(数据入)、A=IO5(数据出)、P/V=电源 |
| H4(禁止) | RES P V G R T A | T 与电源使能同网络 → 电源与数据互相干扰 |
插 H4 不会冒烟,但会出现「红灯亮着、却一个字节都没有」或者「偶发丢帧、校验大面积失败」这类最难查的现象。
认准丝印 H3。
接线前最后一件事:模组
VCC与GND一旦对调 = 上电即烧模组。 插之前用万用表确认模组的VCC焊盘与H3-P同侧、GND与H3-G同侧。 另外:如果刚用 2 mm 顶针治具烧过模组固件,先把顶针拆掉——治具的 3V3 会和板载3.3V_RADAR互顶。
3.3 上电自检:只看一个灯
板上有三个灯,只有一个是电源判据:
| 灯 | 丝印 | 含义 | 能不能用来判断雷达供电 |
|---|---|---|---|
| 绿 | ON | 主板 3.3 V 正常 | 不能 |
| 橙 | L(由 IO15 驱动) | 只是普通指示灯 | 不能(这是最容易误判的一个) |
| 红 | RADAR | 接在 3.3V_RADAR 轨上 | 能——红灯亮 = 雷达已上电 |
上电时序(固件已经做好,你只需要观察结果):
① MCU 先启动(主 3.3 V + USB 枚举稳定)
↓
② IO14 拉高 → U4 使能 → 3.3V_RADAR 建立 → 丝印 RADAR 红灯亮
↓
③ 模组内部上电复位/自检/射频校准(需要一段时间,别急)
↓
④ 模组开始主动上报 0x45 0x44 帧
期望现象:烧好固件、插上 USB 后,红灯常亮,设备管理器出现「USB 串行设备 (COMx)」(VID:PID = 303A:1001)。
失败先查:
| 现象 | 先查什么 |
|---|---|
| 一个灯都不亮 | USB 线是不是充电线;换个 USB 口(台式机优先机箱后面) |
| 绿灯亮、红灯不灭(复位前就常亮) | EN 被误拉高或下拉电阻异常 → 断电排查,别带着问题插模组 |
| 绿灯亮、红灯不亮 | 模组没插紧 / 插到了 H4 / 固件没把 IO14 拉高 |
| 橙灯亮但红灯不亮 | 正常也可能发生,橙灯与电源无关,不要用它判断 |
📷 配图位(待补):板卡俯视照,标注
H3丝印方向与RADAR红灯位置。
4. 烧录
固件 demo 名:radar_bridge_edv11p(Kconfig 里是 5.2)。
它的全部工作就是:把 IO4 收到的字节原样写到 USB,把 USB 收到的字节原样写到 IO5。
不解析协议、不注入任何命令帧、不打印任何日志字符。
4.1 路径①:线上烧录页(零基础,推荐)
在 Chrome / Edge 里打开网页烧录页(Web Serial,需要 https 或 localhost):
这个页面内置的就是本节要用的那份合并固件(
edk60_edv11p_track.bin,244,192 B,烧0x0), 插上 USB 点几下就能烧完,不需要装 ESP-IDF。
操作顺序与验证点:
| 步骤 | 你会看到 | 你要做什么 / 期望结果 |
|---|---|---|
| 1 | 「连接设备」按钮 | 点击 → 浏览器弹出串口设备列表 |
| 2 | 设备列表里有一项带 USB / JTAG / COM 字样 | 选中它 → 连接 |
| 3 | 进度条 | 什么都不做,等 10~20 秒 |
| 4 | 「完成 / Done」 | 成功 |
| 5 | — | 拔掉 USB,等 2 秒,再插回(让新固件重新启动) |
| 6 | 板载丝印 RADAR 红灯亮 | 上电成功,进第 5 节看数据 |
失败先查:设备列表是空的 → 换数据线(90% 是这个)→ 换 USB 口 → 按住 BOOT 再插 USB 后松开 → 关掉其它占用串口的软件。
4.2 路径②:本地编译烧录(开发者)
# ① 激活 ESP-IDF(每次新开终端都要做一次)
. C:\Espressif\tools\Microsoft.v6.1.PowerShell_profile.ps1
# ② 进工程根
cd <你的工程根目录>
# ③ 选 demo + 编译(推荐:build_all.ps1 会自动管理该 demo 的 sdkconfig)
.\build_all.ps1 -Demo radar_bridge_edv11p
# ④ 烧录(COM8 换成你实际的端口)
idf.py -B build-radar_bridge_edv11p -p COM8 flash
如果你想直接用 idf.py(本次实测就是这么构建的,构建目录名可以随意取):
idf.py -B build-ev11p-final set-target esp32c6
idf.py -B build-ev11p-final build
idf.py -B build-ev11p-final -p COM8 flash
或者在 idf.py menuconfig → EDK60 Demo → 选 5.2 radar_bridge_edv11p 再 idf.py build。
期望现象:
| 检查点 | 期望输出 |
|---|---|
| 编译结束 | BUILD_EXIT=0,0 error(实测:idf.py -B build-ev11p-final build → BUILD_EXIT=0) |
| 烧录结束 | Wrote 178656 bytes at 0x10000 且紧跟 Hash of data verified(实测值) |
| 烧录后 | 自动复位 → RADAR 红灯亮 |
失败先查:
| 现象 | 原因 | 处置 |
|---|---|---|
build_all.ps1 中途抛异常退出,报的却是 Kconfig 的 NOTE | 脚本把子进程 stderr 当成错误(IDF 6.1 下 $ErrorActionPreference='Stop' 的已知缺陷,P2) | 改用 4.2 的 idf.py 直调路径,本次实测即如此 |
| 改了 Kconfig 但新符号不生效 | IDF 不会因 Kconfig 变化强制重建既有 sdkconfig | 构建前删掉该 demo 的 sdkconfig 再跑 build_all.ps1 |
| 烧完不启动、USB 不枚举 | 有人为了「让 USB 上只有数据」去关了 USB 第二控制台 | 绝对不要关(见 9.3 坑 6) |
| 端口被占用 / 打不开 | 串口助手、另一个浏览器标签或桌面端上位机正开着同一端口 | 全部关掉再烧 |
4.3 合并固件:一个文件,烧 0x0
不想装工具链、又想离线烧录时,用这个「单文件」固件:
⬇ 下载合并固件 edk60_edv11p_track.bin
| 项 | 值 |
|---|---|
| 文件 | edk60_edv11p_track.bin(即工程里 idf.py merge-bin 的产物,原名 merged-binary.bin) |
| 体积 | 244,192 B |
| SHA256 | C847423F1FFDF7482934355432907AE1A788533AF121DE997C96658549A7B40E |
| 烧录偏移 | 0x0(这个文件已含 bootloader + 分区表 + app,所以只有一个地址) |
| 组成 | bootloader(0x0)+ 分区表 + app(app 本体 178,656 B,正常烧在 0x10000)。可以自检:0x10000 + 178,656 = 244,192,与文件体积正好吻合 |
烧法(二选一):
- Flash Download Tool(乐鑫官方 GUI):选 ESP32-C6;文件填
edk60_edv11p_track.bin,地址填0x0;端口选那个「USB 串行设备」,BAUD 460800 → START。 工具版本必须 ≥ 3.9.5(旧版本不认 ESP32-C6)。 - 命令行(esptool,随 IDF 一起装):
esptool --chip esp32c6 -p COM8 -b 460800 write_flash 0x0 edk60_edv11p_track.bin
旧的 esptool 版本命令名是
esptool.py,参数相同。 如果你看到别的教程让你填三个文件、三个地址(bootloader / 分区表 / app 分开烧),那是没合并的产物,不适用于本文件。 想从源码自己生成这一份:先完成 4.2 的编译,再在工程里执行idf.py -B <你的构建目录> merge-bin, 产物是<你的构建目录>\merged-binary.bin——发布包的edk60_edv11p_track.bin就是它改名后的同一份文件。
验证点:烧完拔插一次 USB → 红灯亮 → 打开帧校验脚本(9.4)能看到 45 44 开头的帧。
⚠️ 先自己核一次哈希:
Get-FileHash .\edk60_edv11p_track.bin -Algorithm SHA256。 网上流传的说明文档里的哈希可能被截断或过期;以你实际下载(或自行构建)的这份为准—— 下载文件、发布页manifest.json引用的文件(偏移0x0)、以及本文这三处应当是同一份。
5. 看数据
两条路径,按你的角色选:
| 路径 | 适合谁 | 优点 | 限制 |
|---|---|---|---|
① 网页版 track.html | 零基础、演示、快速目检 | 单文件、免安装、默认只读、离线可用 | 必须 Chrome/Edge,且需 https 或 localhost |
② 桌面版 human_track_v1.4_side_mount.py | 集成商、需要长时间挂着看 | 功能完整、本次验收用就是它 | 需装 PySide6 等依赖,占串口 |
⚠️ 同一时刻只能有一个程序占用这个 COM 口。 网页版和桌面版同时开会互相抢端口(后连的那个打开失败)。
5.1 路径①:网页版轨迹工具 track.html
打开方式(推荐直接用线上页面):
- 单文件 HTML,用 Chrome / Edge 打开即可,不用装任何软件;
- 也可以把这一页另存为本地
track.html,在保存目录起一个静态服务(例如py -3 -m http.server 8770), 然后访问http://127.0.0.1:8770/track.html; - 部分浏览器允许直接双击以
file://打开并使用 Web Serial,被拒绝时走上面两种方式。
它是「默认只读」的——这一点很重要,也是本项目的一条硬约束:
| 行为 | 说明 |
|---|---|
| 连接后自动发的帧 | 只有 op=0xA0(GET 查询),实测逻辑:连上后先 GET 0x02(模块信息),随后依次 GET 0x05 → 0x10 → 0x20 → 0x21 → 0x22,再读一轮高级项(灵敏度/感应区/屏蔽区/目标延时/存在开关/出厂状态/自学习状态),共 16 条查询,一条 SET 都没有 |
| 会不会改你的设备配置 | 不会。页面上「当前回读」区显示的每一项,都只来自设备真实应答 |
| 什么时候才会写配置 | 只有你点「下发配置…(需确认)」并在确认框里点确定之后;且逐条发送、逐条等设备应答(0xA2 或 0xA9 ACK)才发下一条 |
| 取消确认框 | 一帧都不发 |
| 兜底监控 | 若在确认流程之外检测到 op=0xA1(SET),页面会打内部告警(正常应恒为 0) |
| 本地存储 | 不写 localStorage / IndexedDB / Cookie,不采集数据 |
页面还提供两个「不接硬件也能看」的按钮,用来先确认渲染管线没问题:
- 「演示用一键配置」:把工作模式=1 / 挂高=200 cm / 上报频率=2(100 ms)填进表单(同样需要确认)
- 「写入一条 0x70 样例帧」:向解析器灌一条模拟的目标上报帧,看画布会不会画出目标
期望现象(连真机后):
| 观察点 | 期望 |
|---|---|
| 状态条 | 串口 = 你的 COMx;连接状态 = 已连接;帧率 = 近 1 秒的 0x70 帧数(应持续 > 0) |
| 模块信息回读 | 出现 EDV11P_VA, V1.3.3, 0x95F0(设备 ID / 固件版本 / 软件 ID) |
| 画布范围 | 侧装口径:x −500…+500 cm、y 0…800 cm(挂高 200 cm) |
| 目标 | 每个目标一个固定颜色的圆圈(半径 20 cm 显示口径),带 50 点轨迹拖尾 |
| 人数 | 随人进出增减(实测场景 1~6 人,中位数 3) |
| 坏帧数 | 常态应为 0(长时间挂着偶发 +1 可观察,但不应持续增长) |
📷 配图位(待补):静止 1 人 / 走动 / 多人 三种状态的画布截图。
5.2 路径②:桌面端上位机(PySide6)
本项目验收时用的是厂商提供的桌面端上位机 human_track_v1.4_side_mount.py(PySide6 实现,本项目一行都没改,只作为验证工具使用)。
这份脚本由模组厂商/社区渠道提供,本页不提供下载;如果拿不到,直接用 5.1 的网页版即可——看人数与轨迹这件事两者等价。
# ① 装依赖
py -3 -m pip install PySide6 numpy opencv-python
# ② 运行(在你保存脚本的目录下执行)
py -3 human_track_v1.4_side_mount.py
# ③ 窗口标题应为:EDV11P雷达监控器 (协议V1.4 / 支持侧装)
# 选 COM 口 → 波特率 921600 → 点「连接」→ 再点「开始跟踪」
连接时序(知道这个,排障时能少走一大圈):连上 COM 后约 100 ms 就会自动发一条 GET 0x02(读模块信息),
随后在约 750 ms 内连续下发十几条 GET 把配置全部回读一遍——所以上位机界面能回读出参数,就等价于「PC → 板子 → 雷达 RX」这条反向通路是通的。
换句话说:
- 界面能回读 → 双向通路都 OK
- 界面一片空白(连模块信息都没有)→ 反向通路(IO5 /
H3-A)有问题,不是「雷达没数据」
期望现象(实测 2026-10-22 通过):选对 COM → 连接 → 开始跟踪 → 画布出现轨迹点、人数随走位变化。
⚠️ 与网页版不同,桌面版不是只读的:点「开始跟踪」时它会向设备下发配置(例如把工作模式设为 1)。 这是它作为参考上位机的正常行为;如果你希望「只看不改」,用网页版(5.1)。
界面里要确认的三项:安装方式选「侧装 60°」、挂高填 200、显示范围填 800。
选错安装方式不会报错,只会让轨迹整体偏移(朝下模式还会把 z 解释成「挂高 − z」,语义完全不同)。
📷 配图位(待补):桌面端窗口全图(含标题栏、串口选择、画布轨迹)。
6. 协议要点
这一节够你从零写出自己的上位机。固件不需要懂协议——它只搬字节,配置全部由 PC 侧发出。
6.1 帧结构
+--------+--------+--------+------+------+---------+---------+------+
| 45 44 | 长度 | msg id | op | type | TLV长度 | value | 校验 |
| 2 B | 2 B | 2 B | 1 B | 1 B | 2 B | N B | 1 B |
+--------+--------+--------+------+------+---------+---------+------+
←———————————— 全部多字节字段均为大端 ————————————→
| 字段 | 偏移 | 长度 | 编码 | 说明 |
|---|---|---|---|---|
| 帧头 | 0 | 2 | 0x45 0x44 | 固定(ASCII "ED") |
| 长度 | 2 | 2 | uint16 BE | 整包字节数,= 11 + N;合法范围 11 ~ 4096 |
| msg id | 4 | 2 | uint16 BE | 1 ~ 0xFFFF(跳过 0);应答沿用请求的 msg id |
| op | 6 | 1 | uint8 | 见 6.2 |
| type | 7 | 1 | uint8 | 见 6.2 |
| TLV 长度 | 8 | 2 | uint16 BE | = 帧长度 − 11 |
| value | 10 | N | 视 type | 载荷 |
| 校验 | 10+N | 1 | uint8 | 从帧头起逐字节求和 & 0xFF |
op 取值:
| op | 含义 | 谁发 |
|---|---|---|
0xA0 | GET(读) | 上位机 |
0xA1 | SET(写) | 上位机 |
0xA2 | REPORT(应答) | 雷达(对 GET/SET 的回复) |
0xA3 | STATUS(主动上报) | 雷达 |
0xA9 | ACK(失败/错误确认) | 雷达 |
上报是异步的:发一条 SET 之后必须等应答(
0xA2/0xA9)再发下一条。 本项目踩过「连发不等应答」的坑,所以网页版强制「逐条等应答」。
6.2 关键 type 表
| type | 名称 | 载荷长度 | 编码 | 单位 / 说明 |
|---|---|---|---|---|
0x01 | 产品信息 | 3 B | 1 B 协议版本 + 2 B 厂商 ID(默认 "ED") | — |
0x02 | 雷达模块信息 | 23 B | ASCII 设备ID,固件版本,软件ID | 实测 EDV11P_VA,V1.3.3,0x95F0 |
0x05 | 工作模式 | 1 B | uint8:0 调试 / 1 跟踪·人数统计 / 2 体征 / 3 跌倒 | 本项目必须 = 1 |
0x10 | 上报频率 | 2 B | uint16 BE | 单位 50 ms;0 = 不上报;设 100 ms ⇒ 下发 0x0002 |
0x20 | 检测范围 | 8 B | int16 BE ×4:xmin, xmax, ymin, ymax | cm |
0x21 | 检测高度 | 4 B | uint16 BE ×2:min, max | cm |
0x22 | 挂高 | 2 B | uint16 BE | cm |
0x23 | 运动灵敏度 | 1 B | uint8 0~10 | — |
0x24 | 存在灵敏度 | 1 B | uint8 0~10 | — |
0x25 | 感应区数量 | 1 B | uint8 | 个 |
0x26 | 感应区配置 | n B | 每区 13 B | cm |
0x70 | 目标上报 | n B | 见 6.3 | cm;主数据源 |
0xF0 | 错误码 | n B | — | 只用于显示 |
0xA9 | ACK | 1 B | 01 成功 / 02 帧头错 / 03 校验错 / 04 不支持 / 05 参数错 | — |
上报频率的单位一定要记牢:50 ms,不是 10 ms。
想要 100 ms 一帧就下发 0x0002;出厂回读常见值是 0x000A(=500 ms);下发 0x0000 会彻底停报(调试时很有用,见 6.4)。
6.3 0x70 目标上报载荷布局
注意:载荷是「重复的感应区块」,没有固定头。 一个区一条,每个区里再套目标。
重复 {
zone_id : uint8 感应区编号
count : uint8 本区目标数
count × {
target_id : uint8 目标 ID(同一目标跨区重复上报时要合并)
x : int16 BE cm,可为负
y : int16 BE cm,可为负
z : int16 BE cm(侧装下 = 离地高度)
} 每个目标固定 7 字节
}
| 偏移(区首字节起) | 长度 | 字段 | 类型 |
|---|---|---|---|
| 0 | 1 | 感应区编号 | uint8 |
| 1 | 1 | 本区目标数 | uint8 |
| 2 + 7k | 1 | 目标 ID | uint8 |
| 3 + 7k | 2 | x | int16 BE |
| 5 + 7k | 2 | y | int16 BE |
| 7 + 7k | 2 | z | int16 BE |
三条实现要点:
op是0xA3(STATUS 主动上报),不是0xA2;稳妥起见解析器可同时兼容0xA2。x / y / z全是有符号 int16,负数按二补码解释(例如0xFF88= −120)。- 载荷越界(区头越界、或
count × 7超出剩余长度)应当判坏帧并丢弃本帧,不要算半截目标。
6.4 一个真实帧的逐字节拆解(实测)
下面这两帧是上板实测里真实收发的(用来验证双向通路的那组):先发 SET 0x10 = 0 让上报停下来,
雷达回了同 type 的应答,然后我们再发 SET 0x10 = 2 恢复上报。
A. 上位机发出的请求帧(13 字节)
45 44 | 00 0D | 31 01 | A1 | 10 | 00 02 | 00 00 | 7B
| 偏移 | 字节 | 字段 | 解读 |
|---|---|---|---|
| 0–1 | 45 44 | 帧头 | 固定 |
| 2–3 | 00 0D | 长度 | 大端 = 13,正好是整帧字节数 = 11 + 2 |
| 4–5 | 31 01 | msg id | 0x3101(本次会话的流水号,应答会原样带回) |
| 6 | A1 | op | SET |
| 7 | 10 | type | 上报频率 |
| 8–9 | 00 02 | TLV 长度 | 大端 = 2,即 value 占 2 字节 |
| 10–11 | 00 00 | value | uint16 BE = 0 → 停止上报 |
| 12 | 7B | 校验 | 见下方手算 |
手算校验和(这就是你必须用程序算的那一步):
0x45+0x44+0x00+0x0D+0x31+0x01+0xA1+0x10+0x00+0x02+0x00+0x00
= 69+68+0+13+49+1+161+16+0+2+0+0
= 379
379 mod 256 = 123 = 0x7B ✅ 与末字节一致
B. 雷达回的应答帧(13 字节)
45 44 | 00 0D | 31 01 | A2 | 10 | 00 02 | 00 00 | 7C
| 偏移 | 字节 | 与请求的差异 | 解读 |
|---|---|---|---|
| 0–5 | 45 44 00 0D 31 01 | 完全相同 | 帧头、长度、msg id 原样带回 |
| 6 | A2 | ← A1 → A2 | REPORT:这是设备对 SET 的回复 |
| 7–11 | 10 00 02 00 00 | 完全相同 | 回显 type(0x10)、TLV 长度(2)、value(0)——设备在说「我收到的是 0」 |
| 12 | 7C | ← 校验和随之 +1 | 379 − 0xA1(161) + 0xA2(162) = 380 → 380 mod 256 = 124 = 0x7C ✅ |
怎么一眼判断是应答还是上报:看
op。A2= 对你请求的应答(msg id 与你的请求相同);A3= 设备主动上报(0x70目标帧走这条)。两者都在同一条流里,解析器要按op分流。
实测现象:这条 SET 发出去后,数据流从「1.5 s 收到 703 字节」掉到「3 s 只收到 39 字节」(几乎停报),
说明雷达真的执行了;再发 SET 0x10 = 2(45 44 00 0D 41 01 A1 10 00 02 00 02 8D)后,1.5 s 内恢复 446 字节。
这组实验的价值:它同时证明了三件事——① PC → 板子 → 雷达 RX 的反向通路有效;② 校验和/帧格式被设备接受; ③ 雷达会执行你下发的配置。如果你怀疑「到底是不是透传」,先做这组实验。
C. GET 0x02(读模块信息)的请求帧与应答载荷
请求:45 44 00 0B 00 01 A0 02 00 00 37 ← 11 字节,无 value(TLV 长度 = 0)
校验:69+68+0+11+0+1+160+2+0+0 = 311 → 311 mod 256 = 0x37 ✅
应答的 value 是 23 字节 ASCII(0x17),实测原始字节:
45 44 56 31 31 50 5F 56 41 2C 56 31 2E 33 2E 33 2C 30 78 39 35 46 30
E D V 1 1 P _ V A , V 1 . 3 . 3 , 0 x 9 5 F 0
⚠️ 这段 value 的头两个字节恰好也是
45 44——因为设备 ID 是EDV11P_VA,以 ASCII"ED"开头, 而"ED"的字节就是0x45 0x44。这是巧合,不是帧头。 解析器只在「帧边界」找帧头、按长度字段整段消费,才不会把这个 value 从中间切开; 如果你用正则/字符串查找去扫45 44,就会在这里制造一次假同步。
| 字段 | 字节 | 值 |
|---|---|---|
| 设备 ID | 0–8(9 B) | EDV11P_VA |
| 分隔符 | 9 | , |
| 固件版本 | 10–15(6 B) | V1.3.3 |
| 分隔符 | 16 | , |
| 软件 ID | 17–22(6 B) | 0x95F0 |
完整应答帧的骨架是 45 44 00 22 00 01 A2 02 00 17 <23 B value> <CS>(长度 0x22 = 34 = 11 + 23)。
这条命令是「链路是否通」的最佳单点验证:能回读出 EDV11P_VA, V1.3.3, 0x95F0,说明接线、波特率、帧格式、双向通路全对。
6.5 一个 0x70 帧的字段走查
说明:30 分钟实测里
0x70都是单感应区(zone_id恒为[1]),且原始帧字节未在本文件留存(见附录 C 待补 ①)。 下面这条是按 6.3 格式构造的合规帧(本项目网页工具自测用例里的同一条),用来把字段位置讲清楚——它不是设备原始捕获字节。 实测侧的证据是:30 分钟里 15,454 条0x70帧、载荷异常 0(每一帧都能被完整解出,没有半截帧)。
45 44 00 32 00 31 A3 70 00 27
01 03 02 FF88 006F 0095 03 FFE4 0026 00CB 04 0024 FF48 00C7
02 02 05 FFF0 005E 00B0 06 FF75 FF4A 00D3
60
| 片段 | 字节 | 解读 |
|---|---|---|
| 帧头 | 45 44 | 固定 |
| 长度 | 00 32 | 50 字节 = 11 + 39 |
| msg id | 00 31 | 0x0031 |
| op / type | A3 70 | STATUS 主动上报 / 目标上报 |
| TLV 长度 | 00 27 | 39 字节 |
| 区 1 头 | 01 03 | 感应区 1,3 个目标 |
| 目标 2 | 02 FF88 006F 0095 | id=2,x=−120,y=111,z=149 |
| 目标 3 | 03 FFE4 0026 00CB | id=3,x=−28,y=38,z=203 |
| 目标 4 | 04 0024 FF48 00C7 | id=4,x=36,y=−184,z=199 |
| 区 2 头 | 02 02 | 感应区 2,2 个目标 |
| 目标 5 | 05 FFF0 005E 00B0 | id=5,x=−16,y=94,z=176 |
| 目标 6 | 06 FF75 FF4A 00D3 | id=6,x=−139,y=−182,z=211 |
| 校验 | 60 | 全部前序字节求和 = 4192 → 4192 mod 256 = 96 = 0x60 ✅ |
要点:count 是「本区目标数」,所以解析必须按区循环,不能假设只有一个区、也不能假设目标 ID 连续。
同一目标若在重叠感应区里被重复上报,画的时候按 target_id 合并(只保留一份)。
6.6 校验和:唯一一个「手算必错」的地方
公式只有一句:
cs = sum(frame_bytes_without_cs) & 0xFF # 从帧头的 0x45 开始,一个字节都不能漏
这个项目里最先踩的坑就是它:手算 GET 0x02 的校验和时算错,发出去的帧被设备静默丢弃——表现为
「串口打开了、灯也亮着、就是一条应答都没有」,看起来像硬件坏。
错误示范:msg id 用 21 01,正确 CS = 0x58,实际发了 0x35 → 无任何应答
正确帧: 45 44 00 0B 21 01 A0 02 00 00 58
(69+68+0+11+33+1+160+2 = 344 → 344 mod 256 = 0x58 ✅)
规矩:永远用程序组帧,不要手工拼;发送前把算出来的 CS 打印出来对一眼。
7. 安装与调参
7.1 侧装 60° 的几何口径
本项目采用的是「侧装方案 A」:模组绕 +y 轴倾斜 60°(主坐标轴俯角 30°),挂高 200 cm,装在墙侧朝房间内。
| 轴 | 取值范围(实测配置) | 含义 |
|---|---|---|
x | −500 … +500 cm | 水平横轴,0 在模组地面投影处 |
y | 0 … 800 cm | 沿地面、从墙/模组投影向前,0 在墙根 |
z | 0 … 200 cm | 离地高度(侧装下 z 直接就是离地高度) |
关键结论(别把事情做复杂):60° / 30° 是机械安装参数,不是软件要做的三角变换。
实测该模组固件为侧装版:挂高 200 cm、范围 x±500 / y[0,800]、z 为离地高度——
上位机侧直接把上报的 x/y/z 当世界坐标画就行,不需要写旋转矩阵。
反过来也要说清边界:这不等价于「任意角度都能自动转」。协议里没有任何倾角/旋转参数
(0x20 范围、0x21 检测高度、0x22 挂高,全是水平俯视正交坐标系的口径),
换一个倾角或换一个非侧装固件,坐标语义就可能变——那时要按实测重新标定(见 7.5)。
7.2 参数表(实测回读值 + 本项目在用值)
| 参数 | type | 实测回读原始值 | 解读 | 本项目在用值 |
|---|---|---|---|---|
| 工作模式 | 0x05 | 01 | 跟踪/人数统计 | 1 |
| 上报频率 | 0x10 | 0000(采集前被置 0)→ SET 为 0002 | 2 × 50 ms = 100 ms | 2(100 ms) |
| 挂高 | 0x22 | 00C8 | 200 cm | 200 cm |
| 检测范围 | 0x20 | FE0C 01F4 0000 0320 | x[−500,+500]、y[0,800] cm | 同左 |
| 检测高度 | 0x21 | 001E 00C8 | 30 ~ 200 cm | 同左 |
| 运动灵敏度 | 0x23 | 09 | 9 | 9 |
| 存在灵敏度 | 0x24 | 09 | 9 | 9 |
| 感应区数量 | 0x25 | —(30 分钟采集里 zone_id 恒为 [1]) | 单感应区 | — |
调参建议(按现象下手,别乱调):
| 现象 | 先动哪个 | 怎么动 |
|---|---|---|
| 轨迹断断续续、跟不上人 | 0x10 上报频率 | 值调小(如 1 = 50 ms);代价是数据量翻倍 |
| 远处的人检测不到 | 0x20 检测范围 / 0x21 检测高度 | 范围按实际房间放宽;高度上限别低于人的身高 |
| 没人也报目标、或目标频繁跳变 | 0x23 运动灵敏度 | 降低(如 9 → 7) |
| 有人却报 0 人 | 0x20 / 0x21 / 挂高 0x22 | 先确认这三项和实际安装对得上(最常见的原因是挂高填错) |
| 轨迹整体按固定比例偏 | 挂高 0x22 | 用卷尺量真实挂高后重设(见 7.5) |
7.3 怎么核对设备当前配置(GET 回读)
三种方式,从省事到原始:
- 网页版(推荐):连上后自动回读,页面「当前回读」区显示设备真实回报值;设备没回的项显示「未回读」。
- 桌面端:连上后 100 ms 内自动回读一轮,界面参数即设备值。
- 自己发 GET 帧(开发者):下面的帧都只读、无副作用,可以放心先跑通通道。
| 用途 | 帧(可直接粘到串口工具的 HEX 发送框) |
|---|---|
| 产品信息 | 45 44 00 0B 00 01 A0 01 00 00 36 |
| 模块信息(主验证) | 45 44 00 0B 00 01 A0 02 00 00 37 |
| 工作模式 | 45 44 00 0B 00 01 A0 05 00 00 3A |
| 检测范围 | 45 44 00 0B 00 01 A0 20 00 00 55 |
| 挂高 | 45 44 00 0B 00 01 A0 22 00 00 57 |
| 从机软件 ID | 45 44 00 0B 00 01 A0 80 00 00 B5 |
期望现象:每条 GET 都会收到一条 op=0xA2、type 相同、value 回显的应答。
没有任何应答 = 反向通路(A → IO5)有问题,或者校验和算错了。
不想用串口助手的话,用 20 行 pyserial 也能读(逻辑与实测所用一致):
import struct, serial
def get_frame(t, msg_id=1):
body = bytes([0x00, 0x0B]) + struct.pack('>H', msg_id) + bytes([0xA0, t, 0x00, 0x00])
return b'\x45\x44' + body + bytes([sum(b'\x45\x44' + body) & 0xFF])
ser = serial.Serial('COM8', 921600, timeout=1)
ser.write(get_frame(0x02)) # 读模块信息
print(ser.read(64).hex(' ').upper()) # 期望里含 ASCII "EDV11P_VA,V1.3.3,0x95F0"
7.4 写配置(SET)的两个纪律
- 先 GET 通,再 SET。通道没验证就狂发 SET,出问题时你分不清是「没通」还是「参数错」。
- SET 之后等应答(
0xA2或0xA9),不要连发。设备是异步应答模型。
本项目在用(侧装 200 cm + 100 ms)的几条 SET 帧,可直接对照:
| 用途 | 帧 | 备注 |
|---|---|---|
| 工作模式 = 1 | 45 44 00 0C 00 01 A1 05 00 01 01 3E | 跟踪/人数统计 |
| 上报频率 = 100 ms | 45 44 00 0D 00 01 A1 10 00 02 00 02 4C | value = 2(×50 ms) |
| 挂高 = 200 cm | 45 44 00 0D 00 01 A1 22 00 02 00 C8 24 | 0x00C8 = 200 |
| 检测范围 x[−500,500] y[0,800] | 45 44 00 13 00 01 A1 20 00 08 FE 0C 01 F4 00 00 03 20 88 | 恢复实测默认口径 |
| 检测高度 30~200 cm | 45 44 00 0F 00 01 A1 21 00 04 00 1E 00 C8 45 | 0x001E=30,0x00C8=200 |
| 停止上报(调试用) | 45 44 00 0D 00 01 A1 10 00 02 00 00 4A | value = 0 |
上表 LEN 与校验和均已按 6.6 公式复核过;发送前仍建议用脚本现算一遍。 特别注意:
0x10 = 0会让数据流完全停止——排查「没有 0x70」时,先GET 0x10确认不是 0,别急着换线。
7.5 标定(轨迹与实际位置对不上时做)
1) 用卷尺量真实挂高,与 0x22 回读值比对(最常见的不准就出在这里)
2) 地面贴一条直线胶带(建议沿 y 轴方向,长度 ≥3 m),标出 0 / 100 / 200 / 300 cm 刻度
3) 一个人沿直线缓慢走一趟(不要跑),同时看画布轨迹
4) 在 100 / 200 / 300 cm 三点分别读画布坐标,与地面刻度比对,记录偏差
5) 偏差 < 30 cm 视为可用;偏差更大时先校准挂高与检测范围,再考虑环境因素(金属、遮挡、多人)
本项目把「偏差 < 30 cm」定为标定判据,该判据的实测偏差值尚未记录(见附录 C 待补 ③)。 可以用两点法快速判断方向:若偏差随距离按固定比例放大 → 多半是挂高/范围口径不对;若整体平移 → 多半是安装原点(离墙位置)不对。
8. 验证清单
从插模组到看到轨迹,逐项打勾。每一项都给了「期望现象」和「失败先查什么」,不要跳步。
| # | 步骤 | 期望现象 | 失败先查什么 | ✅ |
|---|---|---|---|---|
| 1 | 模组插 H3,USB-C 数据线连 PC | 绿灯 ON 常亮 | 线是不是充电线;换 USB 口 | ☐ |
| 2 | 丝印 RADAR 红灯 | 亮 | 是否插到 H4;固件是否拉高 IO14;H3-P 对 G 是否 3.3 V | ☐ |
| 3 | 设备管理器 | 出现「USB 串行设备 (COMx)」,VID:PID 303A:1001 | 换线/换口;按住 BOOT 再插 | ☐ |
| 4 | 烧录固件(4.1 或 4.2) | 「完成」/ Hash of data verified | 端口是否被占用;工具版本(Flash Download Tool ≥3.9.5) | ☐ |
| 5 | 拔插一次 USB | 红灯仍亮,端口号不变 | 板子是否复位后 EN 没起来 | ☐ |
| 6 | 帧校验脚本抓 10 s(9.4) | 有效帧数 > 0,未归属字节 = 0 | 见 9.1 第②层(帧完整性) | ☐ |
| 7 | 打开上位机并连接 | 回读出 EDV11P_VA, V1.3.3, 0x95F0 | 反向通路(A→IO5)不通;校验和错 | ☐ |
| 8 | 回读工作模式 0x05 | = 1(跟踪/人数统计) | 若为 0/3,按 7.4 下发 SET 0x05=1 | ☐ |
| 9 | 回读上报频率 0x10 | ≠ 0(本项目 = 2,即 100 ms) | 为 0 则数据流被关了,按 7.4 恢复 | ☐ |
| 10 | 人站进检测区 | 画布出现目标圈,人数 ≥ 1 | 挂高/范围/高度与实际是否一致(7.2) | ☐ |
| 11 | 人沿地面走动 | 轨迹跟随移动,方向合理 | 安装方式是否选「侧装 60°」;挂高是否 200 | ☐ |
| 12 | 多人同时在场 | 人数随之变化(实测场景 1~6 人,中位 3) | 灵敏度 0x23;遮挡;感应区配置 | ☐ |
| 13 | 挂 30 分钟不动它 | 帧完整率 ≥ 99.9%,坏帧 0,重同步 0 | 看 9.4 报告里哪一项不达标,按 9.1 定位 | ☐ |
第 13 项就是本文的验收标准。实测结果:15,483 帧 / 坏帧 0 / 重同步 0 / 帧完整率 100%。
9. 故障排查
9.1 三层法:电源 → 帧完整性 → 工作模式
照顺序走,不要跳层。 前一层的现象会伪装成后一层的问题,这是本项目 95% 的现场问题的根因。
第①层 电源(看红灯 + 量电平)
| 现象 | 判据 | 处置 |
|---|---|---|
RADAR 红灯不亮 | 3.3V_RADAR 没建立 | 量 H3-P/V 对 G 是否 3.3 V ±5%;确认插的是 H3;确认固件在启动后拉了 IO14 |
| 红灯亮但一点数据都没有 | 供电 OK,问题在数据通路 | 进第②层 |
| 红灯闪 / USB 反复掉枚举 | 供电能力不足(启动峰值 < 1.2 A 把 5 V 拉塌) | 改用 DC-005 + 5 V/≥2 A;见 2.1 供电提示 |
| 连上后一直没数据(GET 有应答、但没有 0x70 帧) | 实测行为:模组掉电重启后不会自动上报,需要主机至少下发一次 SET 才恢复数据流(2026-10-22 反复验证:回读工作模式已是 1、频率已是 2,但无上报;发一次 SET 0x05=1 后立即恢复) | 点一次网页版「下发配置」,或手动发 SET 0x05=1(45 44 00 0C [msgid] A1 05 00 01 01 CS)与 SET 0x10=2(100 ms) |
第②层 帧完整性(PC 侧看字节)
| 现象 | 判据 | 处置 |
|---|---|---|
| 一个字节都收不到 | 没有数据到 PC | ① 是否插 H4;② RX 是否 IO4;③ 波特率是否 921600(波特率不匹配会丢全部字节,看起来像「没信号」);④ 是否开了别的程序占用端口 |
有字节但找不到 45 44 | 波特率不对 / 电平异常 | 用「已知可用」的 USB-TTL 直连模组做 A/B 对照,先证明模组在发 |
| 帧头对、校验大量失败 | 字节被插入或丢失 | 若同时混着可打印文本 → 数据流被日志污染(第③层之外的独立问题,见 9.3 坑 4);否则怀疑接触不良(顶针半插/线太长) |
有 45 44 但帧长字段离谱(如 19254) | 假同步:"ED" 是帧头,某处打印了含 ED 的文本 | 见 9.3 坑 4("EDK60" 的前两字节就是帧头) |
第③层 工作模式 / 上报频率(协议语义)
| 现象 | 判据 | 处置 |
|---|---|---|
有应答、没有 0x70 | 不在跟踪模式,或上报频率 = 0 | GET 0x05 是否 =1;GET 0x10 是否 =0;必要时 SET 0x05=1、SET 0x10=2 |
0x70 有但人数恒 0 | 挂高/范围/高度与实际不符,或有人被屏蔽区挡住 | GET 0x20/0x21/0x22/0x25/0x26 逐项核对 |
| 有目标但坐标明显偏 | 安装方式/挂高/离墙距离与实际不符 | 按 7.5 标定 |
连 0xA2 应答都没有 | 反向通路不通(IO5 / H3-A)或校验和错 | 先按 6.6 用程序重算 CS;再查接线 |
9.2 ⚠️ 致命提示:串口助手看到「乱码」是正常现象
这是本 demo 最容易把人劝退的一条。 用串口助手(SSCOM / XCOM / Arduino 串口监视器)以文本模式打开这个端口,
你会看到满屏乱码、方块、?、偶尔蹦出几个 ED 字母——
这不是故障,这是二进制协议帧。
| 你看到的 | 真相 |
|---|---|
| 一片乱码 | 每帧是 45 44 … 的二进制,含大量不可打印字节(\x00、\xff 之类) |
偶尔出现 ED | 那是帧头 0x45 0x44 正好是 ASCII 的 "E" "D" |
| 看起来「重复的怪符号」 | 每 100 ms 一帧,文本模式下一屏几百帧堆在一起 |
怎么正确看:
- 把串口助手切到 HEX / 十六进制模式,你会看到整齐的
45 44 00 32 …帧 - 或者干脆别用串口助手——用 5.1 的网页版 / 5.2 的桌面版(它们懂协议)
- 想统计帧质量,用 9.4 的帧校验脚本(它会给 PASS/WARN/FAIL 结论)
同理:不要用「串口助手能看到字」来判断链路正常。能不能收数据只看 HEX 模式里有没有合法帧。
9.3 本项目踩过的十个真实坑
按杀伤力排序(全部是实际发生过的,不是假设):
| # | 现象 | 根因 | 处置 |
|---|---|---|---|
| 1 | 串口打开了、红灯亮着,发 GET 一条应答都没有,像硬件坏 | 手算校验和算错(GET 0x02 msgid 21 01 正确 CS 应为 0x58,实际发了 0x35) | 永远用程序组帧;发送前打印 CS 核对;先跑 GET 0x02 这一条「主验证帧」 |
| 2 | 照着协议文档抄 GET 帧,校验和总是差 4 | 协议文档里 GET 0x01/GET 0x02 两条示例的 CS 与其自身 LEN 字段自相矛盾(文档给 0x3B/0x3A,按 LEN 实算是 0x37/0x36) | 以公式和实现为准,不要照抄文档示例;本文 6.6 与附录 B 的帧都已复核 |
| 3 | 一个字节都收不到,但红灯亮 | 模组插到了 H4(T 与电源使能同网络) | 只插 H3;认丝印顺序 RES A R T G V P |
| 4 | 数据流里混进可打印文本,解析器不停重同步、报「长度非法 19254」 | 固件/横幅打印了 EDK60——E=0x45、D=0x44,项目名本身就是帧头 | 数据通路一律零 printf;启动横幅与引脚表关掉;文案里连 LED 这种词都会造出 45 44 |
| 5 | 以为「只关日志级别」就干净了,实测仍抓到 1142 字节文本 | ESP_LOG* 被压住了,但启动横幅/引脚表是 printf,走的是另一条路 | 四处一起关:日志级别 + 横幅 + 引脚表 + 源码零 printf(本项目就是这么做的,实测稳态 30 分钟 0 个非协议字节) |
| 6 | 为了「让 USB 上只有数据」关掉 USB 第二控制台,结果固件启动卡死、USB 不枚举,必须拔插 | 该选项与 USJ_ENABLE_USB_SERIAL_JTAG 联动,USB 外设时钟在启动阶段被关掉 | 绝对不要关;用「不产生字符」的方式实现洁净,而不是关控制台 |
| 7 | 跑着跑着整板复位、USB 掉枚举,看起来像「板子坏了」 | 启动浪涌(峰值 < 1.2 A)把 5 V 轨拉塌,主控跟着一起复位 | 用 DC-005 + 5 V/≥2 A 供电,USB-C 只做数据;必要时输出端并 470 µF |
| 8 | 日志里出现 6 行「握手 … (未取到 ok)」,误判成接线错 | 烧的是 EDV151 的 radar_bridge(会向模组灌 6 条 0x5A … 帧),而 EDV11P 的帧头是 45 44,0x5A 属于非法帧 | 本 demo 必须用 radar_bridge_edv11p(纯透传、零注入) |
| 9 | build_all.ps1 -Demo … 中途抛异常,报的却是 Kconfig 的一条 NOTE | IDF 6.1 下脚本把子进程 stderr 当异常(脚本级缺陷) | 改用 idf.py 直调;或按 4.2 的命令走 |
| 10 | 30 分钟统计里「未归属字节 = 1」,差点被判成缺陷 | 采集脚本到点关串口时正好卡在帧中间,末帧被截断(tail_garbage),采集边界效应 | 采集结束后先读完当前帧再关端口;或在报告里注明是末尾截断 |
还想补两条环境坑:
python命令不可用(Windows 应用商店占位别名)→ 统一用py -3; PowerShell 5.1 读不了含中文注释的脚本(按 ANSI 解码会解析失败)→ 采集脚本写成纯 ASCII。
9.4 可复现的 30 分钟验证(第三方照做即可)
随仓库提供了零第三方依赖的帧校验脚本(tools/edv11p_frame_check.py),你可以用同一套判据复核本文的数据。
三个随仓库工具(帧校验 / 采集流水线 / 出图脚本)的用途见附录 C.1。
# ① 先自测脚本本身(不需要硬件,30 秒)
py -3 tools\edv11p_frame_check.py --selftest
# ② 静态门禁:检查有没有「会污染数据流的文案」(不需要硬件)
py -3 tools\edv11p_frame_check.py --check-banner
# ③ 实时 30 分钟采集 + 分析(需要 pyserial:py -3 -m pip install pyserial)
py -3 tools\edv11p_frame_check.py --port COM8 --baud 921600 --duration 1800 `
--save-raw capture.bin --raw-dump --csv people.csv --out evidence\
怎么读结论:脚本退出码 0 = PASS;报告里逐项列 P0~P6。要复核本文的硬指标,只看这四行:
| 看哪一行 | 期望 |
|---|---|
| 有效帧数 | > 0(不够就说明采集/接线有问题,其余判据会被跳过) |
| 帧完整率 | ≥ 99.9%(本项目实测 100%,P4 口径) |
| 重同步绝对次数 | ≤ 3 次 / 30 min(本项目实测 0) |
| 未归属字节率 | = 0 为 PASS;0~0.1% 为 WARN,必须在报告里点名来源 |
采样窗口从 T+10 s 起算:上电最初几十毫秒里 ROM/bootloader 会走同一路 USB 输出启动文本, 那不属于任何 EDV11P 帧。算进去会让每次采集都假失败。脚本已默认跳过这 10 s。
10. 已知边界
诚实列出这个方案没有验证到的地方——照着做之前请先看这一节。
| # | 边界 | 说明 |
|---|---|---|
| 1 | 型号与能力口径 | 人数统计/轨迹跟踪能力已由 0x70 目标上报实测确认(30 分钟 15,454 帧、载荷异常 0)。若换用别的型号/分支,必须以设备实际回读与 0x70 是否上报为准,不能按名字推断。 |
| 2 | 侧装不等于任意角度,且未做地面标定 | 实测该模组固件为侧装版:挂高 200 cm、范围 x±500 / y[0,800]、z 为离地高度。这不等价于「固件自动完成任意角度旋转」;协议里没有倾角参数,换倾角/换安装方式后坐标语义可能改变,需要重新标定。 |
| 3 | 场景覆盖有限 | 只验证了常规室内、1~6 人的场景(中位 3 人)。未验证:零人空场景的长时间基线、密集人群(>6 人)、快速穿行、多人交叉遮挡、宠物/儿童低矮目标。 |
| 4 | 未做长期老化 | 最长连续运行 30 分钟。没有 24 h / 7 天老化、没有温升与长期稳定性数据。 |
| 5 | 帧率与设定值的差 | 设定 100 ms(0x10=2)后,30 分钟实测 15,454 帧 / 1800 s ≈ 8.6 帧/s,低于名义 10 帧/s。该差异的原因尚未定位(见附录 C 待补 ④),不影响帧完整率结论。 |
| 6 | Web Serial 的浏览器限制 | 网页版只在 Chrome / Edge 89+ 可用,必须在 https 或 localhost 下;Firefox / Safari 不支持(iOS 上所有浏览器都不支持)。页面不写本地存储,也不采集任何数据。 |
| 7 | 网页版与桌面版不可同时开 | 两者都独占同一个 COM 口。 |
| 8 | 桌面端是厂商参考工具 | human_track_v1.4_side_mount.py 本项目一行未改,只作为验证工具;遇到它自身的问题不在本文范围内。 |
| 9 | 不承担医疗/安防结论 | 这是技术演示:人数与坐标是设备算法的输出,未经计量标定;不能用于安防判责、跌倒报警等有责任后果的场景。 |
| 10 | 0x10 单位是 50 ms | 本文所有帧率相关数字都按「单位 50 ms」计算(100 ms ⇒ 下发 2)。若你的设备固件不同,请先按 9.1 第③层确认实际帧间隔。 |
附录 A · 实测数据与测量条件
本文所有「实测」数字均来自 2026-10-22 的上板验收,测量条件如下。 引用具体数字时请连着条件一起引用,否则没有意义。
| 项 | 值 |
|---|---|
| 日期 | 2026-10-22 |
| 板卡 / 模组位置 | EDK60_VA V1.0(ESP32-C6-MINI-1-N4),模组插 H3 |
| 主机端口 | COM8(USB 串行设备,VID:PID = 303A:1001) |
| 模组回读 | EDV11P_VA, V1.3.3, 0x95F0(设备 ID / 固件 / 软件 ID) |
| 固件 demo | radar_bridge_edv11p(纯字节透传、零协议注入、零 printf) |
| 构建 | ESP-IDF v6.1.0,BUILD_EXIT=0(0 error) |
| 烧录 | Wrote 178656 bytes at 0x10000,Hash of data verified |
| 合并固件 | 244,192 B,SHA256 C847423F1FFDF7482934355432907AE1A788533AF121DE997C96658549A7B40E,烧 0x0 |
| 采集窗口 | 1800 s(T+10 s 起算未归属率),530,972 B |
| 配置 | 工作模式 1;上报频率 2(100 ms);挂高 200 cm;范围 x[−500,500] y[0,800];高度 30~200 cm;灵敏度 9/9 |
| 场景 | 常规室内,1~6 人在检测区内进出、走动(未逐时刻记录人工计数的真值,人数一律以雷达 count 字段为准) |
| 帧统计 | 有效帧 15,483(0xA3/0x70 15,454 + 0xA2/0x05 29);坏帧 0;重同步 0;帧完整率 100.0000%(P4 口径,坏帧为 0 时恒为 100%,不度量漏帧);未归属 1 B(末尾 0x45,采集截断;窗口外另有 2,970 B 开机日志) |
| 背压计数器实测 | 60 s 取证采集(临时开启 APP_EDK60_EDV11P_STATS_VIA_USB=y,12 次采样,累计 radar→PC 14,653 B / 553 批):uart 溢出 0 / FIFO 溢出 0 / 帧错误 0 / USB 写失败 0 / USB 丢弃 0 / USB 短写 0 —— 「零丢字节」判据成立;取证后已刷回静默固件并复验(6 s 741 B、57 个帧头、0 个非协议字节) |
| 人数分布 | 1 人×2802、2 人×1810、3 人×4920、4 人×3784、5 人×2043、6 人×95(中位 3,峰值 6) |
| 供电方式 | 仅 USB-C 直连 PC(数据 + 供电);未使用 DC-005 适配器;未实测电流/浪涌 |
| 上位机目检 | 桌面端 human_track_v1.4_side_mount.py:连接 → 开始跟踪 → 画布出现轨迹、人数随走位变化(通过) |
附录 B · 命令帧速查(只读优先)
只读帧(安全,先跑通通道再用):
| 用途 | type | 帧 |
|---|---|---|
| 产品信息 | 0x01 | 45 44 00 0B 00 01 A0 01 00 00 36 |
| 模块信息 | 0x02 | 45 44 00 0B 00 01 A0 02 00 00 37 |
| 工作模式 | 0x05 | 45 44 00 0B 00 01 A0 05 00 00 3A |
| 检测范围 | 0x20 | 45 44 00 0B 00 01 A0 20 00 00 55 |
| 挂高 | 0x22 | 45 44 00 0B 00 01 A0 22 00 00 57 |
| 从机软件 ID | 0x80 | 45 44 00 0B 00 01 A0 80 00 00 B5 |
写入帧(会改设备配置,逐条等应答):
| 用途 | 帧 |
|---|---|
| 工作模式 = 1(跟踪/人数) | 45 44 00 0C 00 01 A1 05 00 01 01 3E |
| 上报频率 = 100 ms | 45 44 00 0D 00 01 A1 10 00 02 00 02 4C |
| 上报频率 = 0(停报) | 45 44 00 0D 00 01 A1 10 00 02 00 00 4A |
| 挂高 = 200 cm | 45 44 00 0D 00 01 A1 22 00 02 00 C8 24 |
| 范围 x[−500,500] y[0,800] | 45 44 00 13 00 01 A1 20 00 08 FE 0C 01 F4 00 00 03 20 88 |
| 检测高度 30~200 cm | 45 44 00 0F 00 01 A1 21 00 04 00 1E 00 C8 45 |
| 运动灵敏度 = 7 | 45 44 00 0C 00 01 A1 23 00 01 07 62 |
所有帧的 LEN 与校验和均已按「逐字节求和 & 0xFF」复核;发送前仍建议用脚本现算。 若某条 SET 收不到
0xA2,先退回发一条 GET 确认通道,不要反复重试。
附录 C · 随仓库提供的工具与待补清单
C.1 随仓库提供的工具
下面三个脚本随 demo 仓库一起提供(按仓库相对路径使用;本页不提供下载):
| 工具 | 用途 | 依赖 |
|---|---|---|
tools/edv11p_frame_check.py | 帧校验与验收:静态门禁(扫出会污染数据流的文本)+ 实时采集 + 30 分钟判据报告(有效帧数 / 帧完整率 / 重同步次数 / 未归属字节),退出码 0 = PASS。本文 1.1 节的统计就是它出的 | 无;实时采集需 pyserial |
tools/capture_gate2.ps1 | 采集流水线封装:把「抓 1800 s → 存原始 .bin → 跑帧校验 → 落报告」固定成一条命令,避免手工漏参数 | PowerShell(脚本为纯 ASCII) |
tools/plot_gate2_capture.py | 出图与统计:从原始捕获文件生成俯视轨迹图与人数时间序列(应用案例页里的两张图即出自它) | numpy、matplotlib |
C.2 待补清单(本文件尚未闭环的项)
按影响从大到小;填上之后请把「待补」字样替换成实测值并在此表标记日期。
| # | 待补项 | 影响 | 怎么补 |
|---|---|---|---|
| ① | 一条设备原始捕获的 0x70 帧字节(30 分钟采集的原始 .bin 未随文档归档,6.5 用的是构造示例) | 读者无法直接对照真实字节 | 采集时加 --save-raw,从 capture.bin 里截一条 3~6 目标的帧贴进来 |
| ② | — | 已上线:见 4.1 的「网页烧录页」链接;该页 manifest.json 引用的正是 4.3 的 edk60_edv11p_track.bin(偏移 0x0) | |
| ③ | 斜装几何标定的实测偏差值(7.5,判据 < 30 cm) | 无法量化「轨迹准不准」 | 按 7.5 走一趟,记录 100/200/300 cm 三点偏差 |
| ④ | 实测帧率 8.6 帧/s 与名义 10 帧/s 的差异归因(10 章第 5 条) | 影响背压/带宽估算 | 用带时间戳的抓包统计帧间隔分布,判断是设备上报节奏还是 USB 侧 |
| ⑤ | 零人空场景的 30 分钟基线(10 章第 3 条) | 空场景下的误报率未知 | 无人房间跑一次 1800 s,看 0x70 目标数是否恒 0 |
| ⑥ | 与「雷达直连 USB-TTL」的 A/B 对照 | 无法排除桥接侧的系统性丢帧 | 直连采 10 min + 桥接采 10 min,比对帧数/字节/直方图(差异 < 0.5%) |
| ⑦ | >30 分钟的长时间老化 / 温升 | 长期稳定性未知 | 连续跑 24 h,记录掉线次数与板温 |
| ⑧ | 配图 3 张(板卡接线、网页画布、桌面端窗口) | 教程可读性 | 见各节 📷 配图位 |
| ⑨ | 桌面端脚本的下载入口(5.2) | 读者需从厂商/社区渠道获取;可先用 5.1 网页版替代 | 随发行包或发布页提供下载入口 |
| ⑩ | 多型号分支的 0x70 支持矩阵(10 章第 1 条) | 换型号时结论不可直接沿用 | 每个型号按 9.4 跑一次,记录是否有 0x70 与载荷异常数 |
许可与署名
本项目代码以 MIT License 发布,作者 @fuhua817。
EDV11P 串口协议部分参考厂商公开的《EDV11P 串口通用协议》,版权归原厂所有。
桌面端 human_track_v1.4_side_mount.py 为厂商参考上位机,本项目未做任何修改。
免责声明:本项目是技术演示,人数与坐标来自雷达算法输出,未经计量标定, 不可用于医疗诊断、安防判责或任何有责任后果的决策场景。