EDK60 + EDV163 水位监测方案:吊装测距,水位 = 挂高 − 距离
在水箱、水塔、地下水池、雨水调蓄池这类地方做水位监测,传统做法是装浮子式 / 投入式 / 超声波液位计: 浮子要跟水接触、会卡涩、会结垢;投入式探头长期泡在水里,要防腐蚀、要定期清洗;超声波受温度分层与蒸汽影响大。 而很多现场真正需要的并不是「计量级读数」,而是**「水位现在大概多少、在涨还是在降、离满罐还有多远」**。
我们用 EDK60 开发板(ESP32-C6)桥接 EDV163 60 GHz 雷达模组,做了一套非接触水位监测的参考方案: 模组吊在容器上方、天线朝正下方,测「到水面的距离」(mm);ESP32-C6 把串口字节原样搬到芯片原生 USB, 浏览器打开一个单文件网页就能看到水位曲线与水位柱——不需要 USB 转串口芯片、PC 端不需要装任何驱动。
水位的换算只有一行:水位 = 挂高 − 到水面距离。其中「挂高」是传感器天线罩下沿到水位零点的垂直距离,
必须显式下发给雷达(出厂默认 3000 mm,忘了改就会整体偏 1 m)。
⚠️ 验证状态(必读):固件、网页、工具都已就绪并通过无硬件自测(页内用例 10/10、桩环境 44/44、 布局契约 32/32、帧校验工具
--selftest36 行对账全过);但这套链路还没有在 EDV163 实物上跑过—— 手上那颗模组当前烧的是「挥手」固件,连45 44帧头都抓不到,GET命令无应答。 因此本文没有任何实测性能数字:帧率、坏帧率、水位精度、漂移全部标着「待实测」。 文中的协议帧是按规则程序化生成/自测合成的,不是设备抓包。
场景需求
| 需求 | 说明 | 方案如何满足 |
|---|---|---|
| 不接触水 | 污水、含砂、含腐蚀性介质的水,探头越少接触越好 | 60 GHz 雷达测距,吊在容器上方非接触测量 |
| 无机械件 | 浮子会卡涩、绳缆会缠绕;现场往往没人维护 | 没有浮子、没有导轮、没有运动部件,无机械磨损 |
| 只看趋势,不看 0.1 mm | 真正要回答的是「在涨还是在降、离满罐多远」 | 水位显示整数 cm;页面明写「受 8 cm 级分辨率限制,适合趋势/相对变化」 |
| 一台设备一根线 | 现场少装一件是一件 | 单点吊装 + 板载 USB-C:数据与供电同一根线 |
| 免驱动接入 PC | 现场电脑常是受控/云桌面环境,不能装驱动 | ESP32-C6 原生 USB CDC,插上就是串口 |
| 上位机可替换 | 客户已有自己的平台或网关 | 桥接固件纯字节透传,不解析、不加工;协议公开,谁都能写上位机 |
为什么用雷达而不是超声波:60 GHz FMCW 的波束窄、不受气压/温度分层影响,对水面这种平坦镜面目标 反射条件好;缺点是对镜面质量极其敏感——波纹超过约 0.6 mm 就会把镜面回波打成漫反射。这条限制在「已知限制」里写清楚了。
方案构成
EDV163 60 GHz 雷达模组(吊装,天线朝正下方)
│ UART 256000 8N1(模组 TX → IO4,模组 RX ← IO5)
▼
EDK60(ESP32-C6)——纯字节双向透传:不解析、不组帧、不做转义、不下发命令、不算水位
│ 芯片原生 USB CDC(免驱动)
▼
浏览器(单文件网页):还原转义 → 切帧 → 校验和 → 解 0x81 → 水位 = 挂高 − 距离
| 环节 | 器件 / 技术 | 关键点 |
|---|---|---|
| 感知 | EDV163(二进制协议 V2.0,设备 ID EDV163_VB) | 主动上报 op=0xA3 / type=0x81:通道数 + 每通道 7 字节(含 target_distance 2 B 大端,mm) |
| 主控 | ESP32-C6(EDK60_VA V1.0) | UART1 与模组通信(256000 8N1),原生 USB 与 PC 通信,两路各自独立 |
| 连接 | 芯片原生 USB Serial/JTAG | 省掉 USB 转串口芯片与驱动;USB CDC 对波特率不敏感,填 256000 只为与线速对齐 |
| 供电 | PC 的 USB-C 口 | 模组典型 11 mA ± 2 mA、综合 < 0.1 W;板载 LDO(AP7362,1.5 A)余量 ≥50×,不需要外部适配器 |
| 上位机 | 单文件网页(Web Serial) | 默认只读:连上只发 8 条 GET,写入必须你在确认框点确定且逐条等应答 |
接线与安装
| 信号 | EDK60 侧 | 模组侧 | 说明 |
|---|---|---|---|
| 模组 TX → MCU RX | IO4 | H3 排针 T 脚 | 数据入口(水面距离全靠这条线) |
| 模组 RX ← MCU TX | IO5 | H3 排针 A 脚 | 下发配置(挂高、上报频率、工作模式) |
| 雷达电源使能 | IO14(高有效) | — | 上电后常高;丝印 RADAR 红灯 = 已上电 |
| 电源 / 地 | 3.3V_RADAR / GND | V、P / G | 3.3 V 单电源,不需要电平转换 |
| 串口参数 | 256000 / 8N1,无流控 | — | 不是人数统计版那套的 921600 |
:::warning 模组必须插 H3,不要插 H4
板上 H3 与 H4 两个 8 pin 排针信号集合相同但顺序相反:
H3 = RES A R T G V P,H4 = RES P V G R T A。
H4 的 T 脚与雷达电源使能在同一侧的网络关系上,插 H4 会让电源与数据互相干扰,
症状是「红灯亮着、却一个字节都没有」或「偶发丢帧」——最难查的那一类。
另外:禁止在雷达已上电(红灯亮)时插拔模组。
:::
安装几何(水位场景专属,全部是设计要求,几何精度待实测):
| 项 | 要求 | 为什么 |
|---|---|---|
| 姿态 | 天线面朝正下方,与水面法线夹角 ≤ ±5° | 60 GHz(λ ≈ 5 mm)镜面反射主导,倾斜超 5° 回波就偏出接收视场 |
| 水平位置 | 容器几何中心正上方,离罐壁 ≥ 100 mm | 减少罐壁多径(±50° 在 2 m 处光斑半径约 2.4 m,远大于 1 m 容器) |
| 支架 | 刚性、可锁死 | 挂高是系统零点,机械松动直接变成系统性偏差 |
| 天线罩 | ABS / PP / PE,厚度 ≤ 2 mm,朝下外凸 | 金属罩会让 60 GHz 全反射;内表面结露水膜会明显衰减回波 |
| 量程 | 挂高 1200~5000 mm(本方案推荐 2000 mm) | 协议允许区间,两侧各留 ≥800 mm 余量 |
| 水位工作带 | 设计 0~1500 mm(对应距离 500~2000 mm) | 预留 ≥500 mm 近距余量,避开尚未实测的近场盲区 |
真实状态:已经验证了什么、还差什么
这一节替代了「实测数据」——因为上板实测还没做。把没做的部分写清楚,比把没测的数字写得很漂亮有用。
已通过(无硬件自测,可复现)
| 项 | 结果 |
|---|---|
| 网页工具页内帧解析用例 | 10/10 通过(含「正文含 0x0A/0x09」的转义用例、旧 8 B 口径用例、静水面用例) |
| 整页桩环境(假串口/假时钟/DOM+Canvas 桩) | 44/44 通过(含「默认只读 = 连接后 0 条 SET」「取消确认框一帧不发」「设备不应答 500 ms 中止」) |
| 布局与不变量契约 | 32/32 通过(满视口布局、无外链、无本地存储、波特率钉死 256000、步长钉死 7 B) |
| 帧校验工具自测 | tools/edv163_frame_check.py --selftest 36 行对账全过(合成流 443 B、16 帧,专门造了含 0x0A/0x09 的帧) |
| 固件规格 | demo radar_bridge_edv163(5.3);合并固件 244,192 B、SHA256 72E600D0…07381B、烧 0x0;工程 18 个 demo |
待实测(全部上板用例)
| 项 | 为什么还没做 | 判据(做的时候照这个判) |
|---|---|---|
| 30 分钟静置采集 | 模组固件不是水位版,抓不到 45 44 帧 | 坏帧率 < 0.1%、帧完整率 ≥ 99.9%、未归属字节率 = 0、转义错误 = 0、0x81 帧数 ≥ 1 |
| 水位换算正确性 | 同上 | 卷尺实测距离与页面读数同量级一致,偏差 ≤ 1 个分辨率单元(≈80 mm) |
| 卷尺标定 | 同上 | 空罐/满罐两点 + 1/3、2/3 点线性拟合,斜率应 ≈ −1 |
转义实况(真实帧里出现 0x0A/0x09) | 需要真实上报帧 | 「转义错误 = 0」且「还原的转义对 > 0」——若后者为 0,说明这轮采集根本没检验到转义路径 |
| presence=0 时距离是否仍有效 | 需要静水真实场景 | 静置 10 min,统计 presence 与 distance 的组合;水位是否持续更新 |
| 近距盲区(最小可测距离) | 需要平板/水面标定 | 从 2000 mm 每 100 mm 下移,看距离何时失真 → 决定满罐水位上限 |
启动峰值电流、3.3V_RADAR 上升时间 | 需要示波器 | 峰值 < 300 mA 且上升 < 50 ms,则可把「EN 后等 200 ms」缩短 |
| 浏览器像素级目检 | 本轮环境禁止启动 Chromium | 1280×720 / 1920×1080 两档整页无纵向滚动、曲线自适应 |
关键工程点
1. 为什么选「雷达 + 非接触」
| 方案 | 接触介质 | 机械件 | 主要失效模式 |
|---|---|---|---|
| 浮子式 | 接触 | 浮子、绳缆、导轮 | 卡涩、缠绕、结垢,需人维护 |
| 投入式(压力) | 长期浸泡 | 无 | 探头结垢/腐蚀、零点漂移,需定期清洗标定 |
| 超声波 | 不接触 | 无 | 温度分层、蒸汽、泡沫影响大;需温度补偿 |
| 60 GHz 雷达(本方案) | 不接触 | 无 | 水面波纹/泡沫/结露破坏镜面回波(见已知限制) |
代价要说清楚:它换掉了机械件,但换来了「对水面状态敏感」。平静水面是优良镜面(垂直入射回波强), 一旦起波纹、起沫、结露,回波可能掉 10~20 dB。所以现场要么有静水条件(静水井/导波管), 要么在水面放一个低密度浮子反射靶(泡沫/EPE,直径 ≥150 mm)——它同时抑制波纹、提升回波。
2. 水位 = 挂高 − 距离(原理与那个必踩的坑)
挂高 mount = 天线罩下沿 → 水位零点(空罐水面/罐底)的垂直距离 (系统零点,单位 mm)
距离 dist = 雷达上报的 target_distance (到当前水面的距离,单位 mm)
水位 level = mount − dist
符号约定:空罐 → 距离 ≈ 挂高、水位 ≈ 0;水位 h → 距离 ≈ 挂高 − h。 手边没有工具时可以用这一条自查:手在水面附近上下移动,距离与水位的方向一定相反。
三个必须写进心里的推论:
- 挂高错 100 mm,全量程就错 100 mm,而且是没有任何报错的系统性偏差。
- 出厂/驱动默认挂高是 3000 mm。你按 2000 mm 换算却忘记下发
0x25 = 2000,水位就整体偏 1 m。 所以流程必须是:连上 → 先GET 0x25回读 → 再SET 0x25→ 页面把「回读 ≠ 设定」标红。 - 挂高不是「传感器到容器口」,也不是「传感器到当前水面」。换容器、移位、改支架后必须重标。
标定只有一步关键:空罐时用卷尺量真值
H0,用H0当挂高(不要用雷达测到的D0, 否则把模组偏差写进了零点)。
3. 工程坑一:帧尾 0x0A 与字节转义
EDV163 的帧是 45 44 | 长度 | msgid | op | type | tlv_len | 数据 | 校验和 | 0x0A,
并且正文里的 0x0A 和 0x09 必须转义:0x0A → 09 01、0x09 → 09 00(帧尾不转义)。
这带来三个连锁后果,每一个都能单独把解析器打挂:
| 后果 | 说明 |
|---|---|
| 长度不是线上字节数 | 长度字段按转义前算(12 + N,含帧尾)。同一个逻辑帧,线上可能多出若干字节 |
帧尾 0x0A 与正文 0x0A 长得一样 | 接收侧必须靠「前面有没有 0x09 引导」来区分;用「按 0x0A 切分」这种偷懒办法必错 |
| 日志污染升级为致命 | 人数统计版的帧没有帧尾,混进一行日志只是「插在帧之间」;EDV163 的帧尾就是换行,任何文本日志的 0x0A 都会切断当前帧 |
还有一个更隐蔽的:target_distance 的高/低字节很容易落在 0x09/0x0A 上
(2569 mm = 0x0A09、1497 mm = 0x05D9),所以转义不是「偶发情况」,而是每一帧都在被检验。
校验和字节本身也可能是 0x09/0x0A。
连「简单」的 SET 帧都会中招:
SET 0x17 = 10(上报频率 1 s)的 value 就是0x000A, 这条帧必须写成… 00 09 01 5C 0A——声明 14 B、线上 15 B。手工拼帧忘了这一步,设备会把它当截断帧丢掉。
4. 工程坑二:0x81 载荷是 7 字节/通道,不是 8 字节
协议文档 §3 写「每个通道 8 字节」,但同一段紧接着列出的字段只有 6 项、合计 7 字节。
| 证据 | 结论 |
|---|---|
驱动 edv163_channel_data_t 是 packed 结构,字段 channel / delay_presence / target_state / motion_direction / target_distance(2) / target_angle(1) | sizeof = 7 |
驱动 edv163.c L372-390:读到 channel_count 后按 7 字节顺序读取 | 解析实现按 7 |
| 反推 | tlv_len = 1 + 7×count(1 通道 → 8、2 通道 → 15、3 通道 → 22) |
为什么这个笔误会「藏起来」:单通道帧 tlv_len = 0x0008,按 8 B 解析恰好不报错;
一旦设备上报 2 通道(tlv_len = 0x000F),整个载荷错位 1 字节,距离与角度全变成垃圾值,而且不报错。
所以网页与帧校验工具都把步长钉死为 7,并且 tlv_len ≠ 1 + 7×count 时显式判载荷异常、点明口径,
绝不按 tlv_len/8 去猜通道数——猜错就是静默渲染垃圾数据。
5. 静水面会被判「无人」
EDV163 本质是人体存在检测算法的衍生品。静止水面没有微动、RCS 也远小于人体,
很可能被判定为 delay_presence = 0、target_state = 0(无人)。
如果上位机写成「只有 presence = 1 时才取距离」,静水场景就会长时间没有水位数据—— 现场看起来就是「设备坏了」。本方案的处理是:
- 上位机一律直接读
target_distance,只做两种有效性判断:距离 = 0(无回波)、距离 > 挂高(超量程); presence/target_state只作展示;- 界面明写「判定:无人(静水面)」并加一行口径提示,避免使用者误判为故障;
- 这条逻辑被页内自测用例 C9 钉死(
presence=0, state=0, distance=1234→ 水位必须算出 766 mm)。
同时把设备侧参数往「别急着判无人」的方向调:0x1D(30 min 强制无人)关、0x1C(无人后持续存在检测)关、
0x11(检测延时)放宽到 5 s。
已知限制
写清楚没做的部分,比写清楚做了的部分更重要:
| 限制 | 现状 |
|---|---|
| 未实机验证 | 全部上板用例未做(模组固件不是水位版)。本文不含任何实测性能数字 |
| 分辨率 8 cm 级 | 水位绝对精度按 ±1 个分辨率单元(≈80 mm) 预期,不是计量级液位计;页面只显示整数 cm |
| 对水面状态敏感 | 波纹 > 约 0.6 mm 即破坏镜面回波;泡沫、结露水膜会显著衰减;只能缓解不能根除 |
| 多径 | ±50° 波束在 2 m 处覆盖半径约 2.4 m,罐壁/支架/进水管都在波束内,可能读到「假水面」;靠检测范围收窄 + 屏蔽区 + 物理挡圈缓解 |
| 近距盲区未知 | 最小可测距离没有规格标注也未实测 → 满罐水位上限只能保守留余量 |
| 通道语义待确认 | 0x81 带 channel 字段、count 可为 1~3;本方案按单通道设计,多通道与安装位置的对应关系待上板确认。与目标 ID 无关:不追踪、不合并 |
0x28/0x29 未使用 | 自动测高不发(会绕过标定);屏蔽区只认类型名、不解析 13 B×N |
| 接线有一处悬念 | H3 的 A/R 两脚「读图 vs 实测」不一致,尚未用万用表定论(定论前不要插满脚) |
| 只测了一条供电路径 | 只用 USB-C 直连 PC;未实测峰值电流。若走板载 DC-005,注意板上是 LM2596 降压,要 7~12 V(不能照抄别处的「5 V/2 A」) |
| 未做长期老化 | 计划内最长用例 30 分钟,没有 24 h / 7 天数据,也没有结露、蒸汽环境的量化结论 |
| 浏览器限制 | Web Serial 只在 Chrome / Edge 89+ 可用,需 https 或 localhost;Firefox / Safari 不支持 |
| 不承担计量/安全结论 | 水位是换算结果,未经计量标定,不可用于结算、报警、防洪等有责任后果的场景 |
复现方式
| 内容 | 入口 |
|---|---|
| 完整实施指南(接线、烧录、协议、安装、标定、排障) | 水位监测实施指南(EDV163) |
| 网页水位工具 | 随仓库提供的单文件网页(默认只读、可离线) |
| 帧校验工具与验收判据 | 随仓库提供的 tools/edv163_frame_check.py(--selftest 无硬件;--port 采集出 JSON + level.csv) |
| 协议与实现依据 | 组件库《EDV163 串口通用协议》+ 驱动源码(以源码为准,文档 §3 的 8 B 为笔误) |
| 固件与上位机源码 | 随仓库提供;需要源码包请发邮件到 support@easydetek.com |
准备好(模组换好水位固件、接线、烧录):从打开网页到看到水位曲线,通常 5 分钟内可以完成。 但第一次安装的卷尺标定请留 10 分钟——它是水位准不准的唯一依据。
:::info 许可与支持 本方案代码以 MIT 许可开源,作者 @fuhua817。 技术问题请发 support@easydetek.com,或在仓库提 Issue。 :::
:::danger 免责声明 本方案为技术演示与方案验证用途,不是计量器具,也不构成任何液位安全联锁的保证。 水位读数受安装几何、水面状态、环境结露与模组自身分辨率限制,不可用于防溢流保护、防洪预警、 贸易结算或任何有责任后果的决策场景。用于实际项目前,请按目标市场的无线电、数据与安全法规完成合规评估。 :::
