Skip to main content

EDK60 + EDV163 水位监测方案:吊装测距,水位 = 挂高 − 距离

· 16 min read
EasyDetek 团队
EasyDetek 官方

在水箱、水塔、地下水池、雨水调蓄池这类地方做水位监测,传统做法是装浮子式 / 投入式 / 超声波液位计: 浮子要跟水接触、会卡涩、会结垢;投入式探头长期泡在水里,要防腐蚀、要定期清洗;超声波受温度分层与蒸汽影响大。 而很多现场真正需要的并不是「计量级读数」,而是**「水位现在大概多少、在涨还是在降、离满罐还有多远」**。

我们用 EDK60 开发板(ESP32-C6)桥接 EDV163 60 GHz 雷达模组,做了一套非接触水位监测的参考方案: 模组吊在容器上方、天线朝正下方,测「到水面的距离」(mm);ESP32-C6 把串口字节原样搬到芯片原生 USB, 浏览器打开一个单文件网页就能看到水位曲线与水位柱——不需要 USB 转串口芯片、PC 端不需要装任何驱动。

水位的换算只有一行:水位 = 挂高 − 到水面距离。其中「挂高」是传感器天线罩下沿到水位零点的垂直距离, 必须显式下发给雷达(出厂默认 3000 mm,忘了改就会整体偏 1 m)。

⚠️ 验证状态(必读):固件、网页、工具都已就绪并通过无硬件自测(页内用例 10/10、桩环境 44/44、 布局契约 32/32、帧校验工具 --selftest 36 行对账全过);但这套链路还没有在 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 RXIO4H3 排针 T 脚数据入口(水面距离全靠这条线)
模组 RX ← MCU TXIO5H3 排针 A 脚下发配置(挂高、上报频率、工作模式)
雷达电源使能IO14(高有效)—上电后常高;丝印 RADAR 红灯 = 已上电
电源 / 地3.3V_RADAR / GNDV、P / G3.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」缩短
浏览器像素级目检本轮环境禁止启动 Chromium1280×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。 手边没有工具时可以用这一条自查:手在水面附近上下移动,距离与水位的方向一定相反。

三个必须写进心里的推论:

  1. 挂高错 100 mm,全量程就错 100 mm,而且是没有任何报错的系统性偏差。
  2. 出厂/驱动默认挂高是 3000 mm。你按 2000 mm 换算却忘记下发 0x25 = 2000,水位就整体偏 1 m。 所以流程必须是:连上 → 先 GET 0x25 回读 → 再 SET 0x25 → 页面把「回读 ≠ 设定」标红。
  3. 挂高不是「传感器到容器口」,也不是「传感器到当前水面」。换容器、移位、改支架后必须重标。 标定只有一步关键:空罐时用卷尺量真值 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 免责声明 本方案为技术演示与方案验证用途,不是计量器具,也不构成任何液位安全联锁的保证。 水位读数受安装几何、水面状态、环境结露与模组自身分辨率限制,不可用于防溢流保护、防洪预警、 贸易结算或任何有责任后果的决策场景。用于实际项目前,请按目标市场的无线电、数据与安全法规完成合规评估。 :::