跳到主要内容
版本:Next

用 EDK60 配置 EDX106 门锁雷达模组——有人触发(I2C 寄存器 + OUT 电平)

一句话:一块 EDK60_VA 开发板 + 一颗 EDX106-N-01(AT10LP1T1RDB,10.5 GHz 频段)雷达模组, 只用 5 根线、一个外接电阻都不用,MCU 通过 I2C(7 位地址 0x28) 每次上电把 7 组参数写进芯片并逐字节回读校验, 然后把芯片 OUT 引脚的电平变化翻译成一行一条的 USB 文本事件,橙灯跟着亮。 人手在模组正前方 1.0 m 内移动 → EDX106: t=… trig=1 → 高电平保持 2 s 左右 → trig=0 width=…。

这套方案与前三个(EDV11P 人数 / EDV163 水位 / EDV163 手扫)最不一样的一件事: 前三个是「MCU 只搬字节」,这一套 MCU 是主动方——寄存器语义、写入顺序、时序、状态机全在固件里。 而且这颗芯片配置掉电不保存,所以「每次上电重配 + 回读校验」不是可选项,是本 demo 存在的理由。

:::warning ✅ 验证状态(读正文之前请先看这一块) 已上板跑通(2026-10-27):EDK60 + EDX106-N-01,首次上板即通过—— i2c ok freq=100000 pullup=internal、SCAN 见 0x28、CFG? 13 个寄存器回读全通过、 1.0 m 处 22 秒内 3 次触发、闭锁防抖有效、橙灯随触发点亮。

本文里的「通信、配置回读、触发距离(1.0 m)、高电平宽度、闭锁行为、橙灯」已是实测值; 「电池供电续航 / 30 分钟长稳 / 深睡唤醒 / 外置上拉下 400 kHz」仍未验证,全文如实标着「待实测」。

一句话前提不变:必须走 H3 的五根线,且必须由 MCU 每次上电重配寄存器—— 模组把芯片的 delay / burst_en / 阈值档位三个「外部 pin 控制」全部内部绑死、没有引出(型号只有 5 个脚)。

实测条件:2026-10-27,EDK60_VA V1.0 + 模组型号 EDX106-N-01(N = 无光敏), SCL = H3 的 T(IO4)、SDA = H3 的 A(IO5)、OUT = H3 的 A2(IO2), I2C 100 kHz + ESP32-C6 内部上拉(无任何外部电阻),定稿参数:常规模式、thr=70、delay=2000 ms、lockout=2000 ms。 :::

已实测(2026-10-27)仍未验证(待实测)
I2C 通信:i2c ok freq=100000 pullup=internal,SCAN 见 0x28电池供电续航(两份资料电流本身矛盾,见第 7 节)
芯片存在性:读 0x0d 返回 0x0a30 分钟以上长时稳定性(本次最长连续观察 22 s)
三个控制位:0x6e=0xe8(thr_reg=1)、0x45=0x01(delay_reg=1)、0x6c 的 mode_reg=1深睡唤醒(OUT 在 IO2,属 EXT1 域,本 demo 未实现)
13 个寄存器回读全通过(cfg ok / verified=1)外置 2×4.7 kΩ 上拉下升 400 kHz(样机全程 100 kHz 内部上拉)
常规模式 + thr=70 → ≥1.0 m 稳定触发ULP 模式下 thr=70 的单独测距(只验了在线写入 rd=70)
1.0 m 处 22 秒内 3 次触发(2.37 s / 8.75 s / 16.81 s)模组辐射面朝向的仪器化确认(现按实测触发方向判定)
高电平宽度 2368 / 3198 / 3845 ms(大于 delay=2000,因二次触发顺延)供电纹波实测值(手册要求 ≤50~100 mV)
闭锁防抖:0.5 s 间隔连挥 3 次 → 只记 1 次事件—
橙灯随触发点亮(用户目视确认)—
维度现在的真实状态证据
固件demo door_lock_edx106(Kconfig 编号 5.5,工程共 20 个 demo)已实现;2026-10-27 已上板跑通上板记录
配置7 组配置、13 字节回读校验、三个强制控制位单独打一行 ctrl 日志启动日志 ctrl … / cfg ok
网页测试页 pathname:///edk60/edx106/test.html、烧录页 pathname:///edk60/edx106/flash.html静态资源(另一路工程师实现中)
固件合并包254,736 B / SHA256 1B13C347C9EB50DC7A792B697B02CD16831713039D38D546D8493E165306CE78,烧 0x0构建产物
本文数字的性质本文数字分三档并逐处标注:实测(标 2026-10-27)/ 芯片手册明写 / 工程建议;没有第四种—

所以请这样读这篇文档:

  1. 接线、烧录、看数据、调参这几节可以照着做——五根线、IO14 使能、RADAR 红灯是实测事实, 寄存器语义来自原厂 AN-003 寄存器手册(V1.2),关键行为数字已被 2026-10-27 上板实测背书(见上表)。
  2. 涉及「能测多远、宽度多少、闭锁有没有用」的结论已有实测值;仍标着「待实测」的那几项是真的没测, 不要当成已验证(清单见附录 C)。
  3. 你要复现,第一步不是插模组,而是确认接线走的是 H3(见第 3 节): 走 H3 就意味着 不能同时接 EDV11P / EDV163(共用同一组脚)。

1. 你能做出什么​

1.1 做好之后你会看到什么​

人手在模组正前方移动,USB 口上就会滚出这样的行(每行以回车换行结尾,全部以 EDX106: 开头):

EDX106: t=2370 trig=1 level=1 delay=2000 lockout=2000 thr=70 mode=normal
EDX106: led on (trigger)
EDX106: t=4738 trig=0 width=2368
EDX106: led off (release)

同时板上丝印 L 的橙灯亮起约 2 s,然后熄灭。

界面元素 / 通道内容
网页测试页大字「有人 / 无人」、触发计数、最近触发时刻、高电平保持时长、闭锁窗口可视化
命令行CFG? / SCAN / TRIG? / SET / LED / RESET 六类命令,全部即敲即回
橙灯跟随 OUT 电平:触发亮、回落灭(实测确认)

:::tip 关键预期管理 本 demo 的输出是一行一条的文本事件,不是波形也不是点云。 它回答的是「此刻有没有人在门前动」,不回答「是谁」「离得多远」「往哪走」。 想要距离与坐标,那是另一类模组(本次这颗只给 OUT 高低电平)。 :::

1.2 你会得到什么​

  1. 一条完整链路:EDX106 模组 →(I2C 两根 + OUT 一根 + 电源两根)→ EDK60 →(原生 USB,免驱)→ PC / 浏览器
  2. 实测确认的接线表(H3 五根线,零外部电阻)
  3. 两种烧录路径(线上网页烧录 / 本地 idf.py)+ 一个「烧 0x0」的单文件合并固件
  4. 一份可照抄的寄存器配置表 + 13 字节回读校验 + 三个「缺一不可」的控制位
  5. 调参即测距的现场手册:SET mode → thr → win → gain 的推荐顺序,每步的代价写清楚
  6. 三层排障法:红灯不亮(电源)→ 扫不到 0x28(总线)→ 能通信但测不远(参数与安装)
  7. 一份 2026-10-27 的上板实测基线:1.0 m 触发、宽度 2368/3198/3845 ms、闭锁只记 1 次

2. 需要什么​

2.1 物料清单​

#项目型号 / 规格必备/可选说明
1开发板EDK60_VA V1.0(ESP32-C6-MINI-1-N4,4 MB Flash,无 PSRAM)必备板载 USB-C,无 USB 转串口芯片(走芯片原生 USB,免驱)
2雷达模组EDX106-N-01(AT10LP1T1RDB,10.5 GHz 频段)必备插在板子的 H3 排针上;只有 5 个脚(V / G / SCL / SDA / O)
3杜邦线5 根(母对母或公对母,按你的转接方式)必备长度建议不超过 10~15 cm:内部上拉下上升沿本来就慢,线越长越容易 NACK
4线缆USB-C 数据线必备必须能传数据;纯充电线会出现「灯亮但电脑认不到」
5PCWindows / macOS / Linux + Chrome / Edge 89+必备网页测试页用 Web Serial,只在 Chromium 内核浏览器可用
6卷尺 / 地面标尺不小于 1.5 m可选(推荐)做「0.5 / 1.0 / 1.5 m 触发对照」时需要,1.0 m 是本次实测基线
7万用表通断档 + 直流电压档可选(推荐)接线查错最快:量 SCL/SDA 通断、量 H3 的 V 对 G 是否 3.3 V

:::tip 不需要任何电阻 板上的 R13/R14(4.7 kΩ I2C 上拉位)是 DNP 未贴片,而且挂在 IO6/IO7 网络上, 与本次用的 IO4/IO5 无关、也帮不上忙。本 demo 全程用 ESP32-C6 内部上拉(约 45 kΩ 量级)+ I2C 100 kHz, 首次上板即通过。外置 2×4.7 kΩ 是量产建议(用于升到 400 kHz 或加长走线),不是本 demo 的前置条件。 :::

2.2 软件环境​

软件本文涉及版本用途
ESP-IDFv6.1.0(target esp32c6)本地编译烧录(走预置合并固件则不需要)
Python3.x(用 py -3 启动器)跑触发事件抓取工具
pyserial3.x只有实时采集需要
Chrome / Edge89+网页测试页(Web Serial)
串口助手任意(文本模式即可)不开网页也能敲 CFG? / SET thr=70 等命令

2.3 不需要的东西​

  • 不需要 任何上拉 / 下拉电阻(内部上拉够用)
  • 不需要 电平转换(模组输入 2.7~4.8 V、输出 3.3 V±0.1 V 推挽,与 ESP32-C6 同域直连)
  • 不需要 USB 转串口模块(CH340 / CP2102 等),不需要装任何驱动
  • 不需要 外部电源:3.3V_RADAR 轨额定 1.5 A,模组常规档 ≈26 mA,PC 的 USB-C 口绰绰有余
  • 不需要 给模组接复位脚——它没有复位脚,复位只有两条路:断 VCC,或寄存器软复位
  • 不需要 厂商上位机:调参全部通过 USB 文本命令完成

3. 接线​

3.1 先认清 H3 的丝印顺序(本链路最容易搞错的一处)​

板上有两个 8 pin 排针,同一物料、同一信号集合、顺序完全相反:

脚位(自上而下)12345678
H3(雷达插槽,用这个)RESARTGVPRES
H4(不要用)RESPVGTRARES
  • 证据:原理图 SCH_EDK60_VA.pdf 文本对象逐脚还原 + 仓库内引脚定义文档的上板实测结论 「模组必须插 H3,H4 会导致电源与数据互扰」。
  • 本 demo 只用 H3 的 5 个脚,RES(1、8 脚)、R(3 脚)、P(7 脚)全部空置。

3.2 五根线(用户最终接线,以此为准)​

EDX106 引脚接到 EDK60GPIO方向说明
VH3 的 V—电源入走 3.3V_RADAR 轨,由 IO14 使能,固件启动即拉高
GH3 的 G—地共地
SCLH3 的 TIO4MCU → 模组走 GPIO matrix 硬件 I2C。⚠ 这根脚原本是模组 TX,本次改作 SCL
SDAH3 的 AIO5双向同上,原本是 MCU TX,本次改作 SDA
O(OUT)H3 的 A2IO2模组 → MCU默认高有效:检测到目标输出高。只配输入 + 内部上拉,固件从不驱动它
EDK60 H3 排针 EDX106 模组(5 脚)
┌──────────────────────┐ ┌─────────────────────┐
│ RES │ │ │
│ A ──[IO5]──────────┼──────────┤ SDA │
│ R │ │ │
│ T ──[IO4]──────────┼──────────┤ SCL │
│ G ─────────────────┼──────────┤ G │
│ V ──3V3_RADAR──────┼──────────┤ V │
│ P │ │ │
│ RES │ └─────────────────────┘
└──────────────────────┘
A2 ──[IO2]────────────────── O(OUT,默认高有效)

上电顺序(防经 IO 灌电流):先接 GND → 再接 VCC → 最后接 SCL / SDA / OUT;拆线顺序相反。

3.3 为什么必须走 H3​

  1. H3 的 T/A 落在 IO4/IO5,与 3.3V_RADAR 的使能网络不冲突;H4 把顺序镜像过来, T 与雷达电源使能处在同一侧的网络关系上,会出现「红灯亮着、却一个 ACK 都没有」这类最难查的现象。
  2. A2 落在 IO2,正好在 GPIO0~7 范围内 → 将来做「有人才唤醒 MCU」时不需要改脚。

3.4 上电自检:只看一个灯​

灯丝印含义能不能判断雷达供电
绿ON主板 3.3 V 正常不能
橙L(IO15 驱动)本 demo 里跟着 OUT 亮灭(触发指示)不能(它是指示灯,不是电源灯)
红RADAR直接挂在 3.3V_RADAR 轨上能——红灯亮 = 雷达已上电

电源使能是 IO14,高有效,且板上使能脚经 10 kΩ 下拉到地 → 上电默认是关的, 固件启动后主动拉高才给雷达供电(这个顺序是安全的:MCU 复位时雷达一定先掉电)。

① MCU 启动(主 3.3 V + USB 枚举稳定)
↓
② 固件先把 OUT(IO2) 配成输入 + 内部上拉(模组还没上电,防浮空)
↓
③ IO14 拉高 → 3.3V_RADAR 建立 → 丝印 RADAR 红灯亮
↓
④ 等不少于 100 ms(上电稳定)→ I2C 建总线 → probe 0x28
↓
⑤ 软复位 → 写 7 组配置 → 回读 13 字节 → 挂 OUT 中断
↓
⑥ 自检窗口(约 3000 ms,从模组上电起算)内**丢弃所有 OUT 事件**

失败先查:

现象先查什么
一个灯都不亮USB 线是不是充电线;换 USB 口(台式机优先机箱后面);换一根线
绿灯亮、红灯不亮模组没插紧 / 插到了 H4 / 固件没把 IO14 拉高(确认烧的是 door_lock_edx106)
红灯亮、SCAN 扫不到 0x28进第 9 节第②层:先查 SCL/SDA 是否接反、再降频到 50 kHz、最后考虑外置上拉

3.5 上拉、电平、以及「走 H3 的代价」​

项事实依据
I2C 上拉不需要外部电阻:全程 ESP32-C6 内部上拉 + 100 kHz2026-10-27 首次上板即通过(pullup=internal)
板上 R13/R14DNP 未贴片,且挂在 IO6/IO7 网络 → 与本次用的 IO4/IO5 无关原理图 + 本工程既有结论
外置上拉什么时候要想跑 400 kHz、或跳线超过 10 cm、或出现 ACK 不稳量产建议(待实测,见附录 C)
电平转换不需要:模组输入 2.7~4.8 V、输出 3.3 V±0.1 V 推挽模组规格书
走 H3 的代价不能同时接 EDV11P / EDV163(共用 IO4/IO5 这组脚)本工程四个雷达 demo 的接线互斥关系

:::warning 一次只能跑一个雷达 demo 想切回 EDV11P/EDV163 时,要先拔掉 EDX106 的线并重新烧对应固件—— 否则两边同时占用 IO4/IO5,会出现「谁都通不了」的现象,而现象本身不会告诉你是接线冲突。 :::

3.6 IO2 是 strapping 脚:一条「现在能跑、产品化要看」的约束​

IO2 属 GPIO0~GPIO7,是 C6 的 strapping 关注脚,同时也在 EXT1 深睡唤醒域内。

需求该用哪根脚本 demo 怎么处理
在线监测 OUT 电平 / 边沿中断(当前形态)IO2(H3 的 A2) ✅已经在用
产品化「有人靠近才唤醒 MCU」(电池门锁必需)仍在 IO2 即可(同属 EXT1 域)本 demo 未实现深睡唤醒(附录 C ③)
若上电偶发异常 / 偶发进下载模式Plan B:改用 H3 的 A3(IO3)改动只有两步,见下

Plan B 怎么落地(已验证「改一行 Kconfig 即可」,本 demo 未触发过):

  1. Kconfig 里把 APP_EDK60_EDX106_OUT_GPIO 改成 3;
  2. 把模组 OUT 那根线从 H3 的 A2 挪到 H3 的 A3;
  3. 重新构建烧录。IO3 不是 strapping 脚,同样在 EXT1 域内,源码不需要改。

:::note 固件侧的三条纪律 只配 GPIO_MODE_INPUT + 内部上拉、从不 gpio_set_level()、先配引脚再给模组上电。 因为从不驱动,所以不会影响 C6 的 strapping 判定。 :::


4. 烧录​

固件 demo 名:door_lock_edx106(Kconfig 里是 5.5,工程共 20 个 demo)。 它的工作是:probe 0x28 → 软复位 → 写 7 组配置 → 回读 13 字节 → 挂 OUT 双边沿中断 → 把电平变化翻译成 EDX106: 文本行;另外提供 6 类 USB 命令用于现场诊断与调参。

4.1 路径①:线上烧录页(零基础,推荐)​

在 Chrome / Edge 里打开网页烧录页(Web Serial,需要 https 或 localhost):

⚡ 网页烧录页 · 门锁感应固件(EDX106)

这个页面内置的就是本节要用的那份合并固件(烧 0x0),插上 USB 点几下就能烧完,不需要装 ESP-IDF。

ℹ️ 若打开是 404,说明这份静态资源还没部署到站点——此时走 4.2(本地编译)或 4.3(合并固件 + esptool)即可。 不要因为它 404 就怀疑自己的接线或板子。

操作顺序与验证点:

步骤你会看到你要做什么 / 期望结果
1「连接设备」按钮点击 → 浏览器弹出串口设备列表
2列表里有一项带 USB / JTAG 字样选中它 → 连接
3进度条什么都不做,等待完成
4「完成 / Done」成功
5—拔掉 USB,等 2 秒,再插回(让新固件重新启动)
6板载丝印 RADAR 红灯亮上电成功,进第 5 节看数据

失败先查:设备列表是空的 → 换数据线(最常见)→ 换 USB 口 → 按住 BOOT 再插 USB 后松开 → 关掉其它占用串口的软件。

4.2 路径②:本地编译烧录(开发者)​

# ① 激活 ESP-IDF(每次新开终端都要做一次)
. C:\Espressif\tools\Microsoft.v6.1.PowerShell_profile.ps1

# ② 进工程根(切到你本机的 ed_edk60_demos 目录)
cd C:\path\to\ed_edk60_demos

# ③ 选 demo + 编译(build_all.ps1 会自动叠加该 demo 的 sdkconfig.defaults 并重建 sdkconfig)
.\build_all.ps1 -Demo door_lock_edx106

# ④ 确认 demo 清单是 20 个
.\build_all.ps1 -List

# ⑤ 烧录 + 看日志(COMx 换成实际端口;USB-C 口即原生 USB CDC)
idf.py -B build-door_lock_edx106 -p COM8 flash monitor

build_all.ps1 每次构建都会删掉该 demo 的 sdkconfig 后重建(这是设计行为,避免新符号不生效), 不是删除源码。

本 demo 的 USB 输出是协议流:用 idf.py monitor 看到的 EDX106: 行就是正常输出 (ESP-IDF 自身日志已在编译期关掉)。

期望现象:

检查点期望输出
单独构建成功,0 error / 0 warning
全量回归.\build_all.ps1 -Size → 20/20 通过
关键宏生效build-door_lock_edx106\config\sdkconfig.h 里有 CONFIG_APP_EDK60_DEMO_DOOR_LOCK_EDX106 与 CONFIG_APP_EDK60_EDX106_THRESHOLD=70
模式不是 ULP启动日志出现 mode=normal、0x6c=0x53(若看到 mode=ulp / 0x6c=0xd3,探测距离必然很短,见第 7 节)

4.3 合并固件:一个文件,烧 0x0​

不想装工具链、又暂时没有线上烧录页时,用这份「单文件」固件:

项值
文件merged-binary.bin(发布包里叫 edk60_edx106_door_lock.bin)
体积254,736 B
SHA2561B13C347C9EB50DC7A792B697B02CD16831713039D38D546D8493E165306CE78
烧录偏移0x0(文件已含 bootloader + 分区表 + app,所以只有一个地址)

生成方式(先完成 4.2 的构建):

idf.py -B build-door_lock_edx106 merge-bin
Get-Item build-door_lock_edx106\merged-binary.bin | Select-Object Length
Get-FileHash build-door_lock_edx106\merged-binary.bin -Algorithm SHA256

烧法(二选一):

  • Flash Download Tool(乐鑫官方 GUI):选 ESP32-C6;文件填 edk60_edx106_door_lock.bin,地址 0x0; 端口选那个「USB 串行设备」,BAUD 460800 → START。工具版本必须 ≥ 3.9.5(旧版不认 ESP32-C6)。
  • 命令行(esptool,随 IDF 一起装):
esptool --chip esp32c6 -p COM8 -b 460800 write_flash 0x0 edk60_edx106_door_lock.bin

:::warning 先自己核一次哈希 上表的体积与 SHA256 请以你手上这份文件算出的哈希为准: Get-FileHash .\edk60_edx106_door_lock.bin -Algorithm SHA256。 不要拿「别人截图上的一串哈希」当依据。 若看到让你填三个文件、三个地址(bootloader / 分区表 / app 分开烧)的说明,那是没合并的产物,不适用于本文件。 :::

4.4 烧完的验证点​

检查点期望状态
拔插一次 USBRADAR 红灯亮;USB 枚举成「USB 串行设备」,网页与本机工具都能直连已实测(2026-10-27)
看启动日志前 3 行i2c ok → ctrl … → cfg ok(见 5.3)已实测 ✅
断电重上电 5 次每次都出现 cfg ok,无 CFG_MISMATCH已实测(首次上板即通过;10 次压测待实测)
手在 1.0 m 处挥动trig=1 → 约 2 s 后 trig=0,橙灯同步已实测 ✅

5. 看数据​

5.1 网页测试页(本方案的图形上位机)​

📈 网页测试页 · 门锁感应(EDX106)

  • 单文件 HTML,用 Chrome / Edge 打开即可,不用装任何软件;
  • 页面通过 Web Serial 连板子的「USB 串行设备」,解析 EDX106: 事件行;
  • 主要有三块信息:「有人 / 无人」大字、触发计数与最近触发时刻、高电平宽度与闭锁窗口。

:::caution 同一时刻只能有一个程序占用这个 COM 口 网页测试页与命令行工具同时跑会互相抢端口。演示用网页,采集用工具,排查用命令行。 :::

5.2 命令行(推荐先用这个把链路确认下来)​

任意串口助手(文本模式,行尾用回车换行,波特率随便填——USB CDC 不受波特率限制)或 idf.py monitor, 敲下面这些命令即可。

CFG? → 逐条回读 9 组寄存器并翻译语义(含 thr_src 告警)
SCAN → 扫 0x08~0x77,标出 0x28
TRIG? → 当前电平 / 最近触发时刻 / 累计次数 / 丢弃计数
SET thr=70 → 写 0x0f/0x10 + 回读确认
SET delay=2000 → 写 0x46~0x49 + 回读确认
SET lockout=2000 → 写 0x52/0x53 + 回读确认
SET mode=normal → 只翻 0x6c bit7 + 回读
SET gain=3 → 写 0x60 的高 4 位(值越大增益越小)
SET win=10,4,3 → 写 0x0d / 0x30 / 0x31 + 三项回读
LED on | LED off | LED blink | LED?
RESET → 重跑启动序列(软复位 + 重配 + 重开自检窗口)

回执示例(每条写命令都必打回读值,这是设计约束,不是为了好看):

EDX106: set thr=70 ok rd=70
EDX106: set mode=normal ok rd=0x53
EDX106: set thr src=0x6e_bit6=1
EDX106: run mode=normal thr=70 delay=2000 lockout=2000 gain=0x33(0x60) win=10/4/3
EDX106: led on (trigger)

:::note run 那一行的数字是芯片里的实际值 每个数字都是回读来的,不是 Kconfig 值。其中 win=10/4/3 三个数来自 0x0d / 0x30 / 0x31—— 判据是「与你 SET win= 写进去的一致」,而不是「看起来合理」(部分样片上 0x30/0x31 会读回 0x00)。 :::

5.3 上电后先看三行(60 秒判据)​

照顺序看这三行,过了就不用再看别处:

#期望行(字段可能因配置略有差异)它证明了什么没出现时去哪查
1EDX106: i2c ok freq=100000 scl=4 sda=5 addr=0x28 pullup=internal总线建起来了、0x28 有 ACK、上拉来源是内部9.1 第②层(扫不到 0x28)
2EDX106: ctrl 0x6c=0x53(mode_reg=1 ulp=0 light_off=1) 0x6d=0xf8(pwr_step=0) 0x6e=0xe8(thr_reg=1 burst_reg=1) 0x45=0x01(delay_reg=1)三个「外部 pin 控制」真的被切到寄存器了9.2(参数改了没反应)
3EDX106: cfg ok thr=70 delay=2000 lockout=2000 mode=normal light=off13 个寄存器逐字节回读全通过,参数已在芯片里日志里逐条 CFG_MISMATCH 会告诉你哪一字节不对

紧接着还会有一行「回读快照」和自检窗口结束:

EDX106: run mode=normal thr=70 delay=2000 lockout=2000 gain=0x33(0x60) win=10/4/3
EDX106: out irq=anyedge armed gpio=2
EDX106: SELFCHECK done level=0 dropped=1
EDX106: ready(命令:CFG? SCAN TRIG? LED on|off|blink | LED? | SET ... | RESET)
  • SELFCHECK done … dropped=N:N 可能是 0~2。自检期 OUT 由高落到低的那一次会被计 1, 这是芯片自检结束,不是误触发。
  • 若出现 EDX106: I2C_DOWNSHIFT 100000 -> 50000:内部上拉连 100 kHz 都勉强。仍可用,但已到边缘—— 缩短跳线、检查共地,量产时按 3.5 补外置上拉。

6. 寄存器与配置逻辑(本文最重要的一章)​

这一节的结论全部来自原厂 AN-003《AT10LP1T1RDB 寄存器读写说明》V1.2 + 本固件实现。 换了芯片/代次就以新手册为准,不要相信任何二手转述(包括本文)。

6.1 为什么每次上电都必须重配​

事实后果
芯片寄存器掉电不保存(手册明写「每次上电后需要配置」)MCU 每次上电都要把 7 组参数重新写进去
出厂默认值不是门锁要的值(0x6e 默认 0x98、0x45 默认 0x00、0x6c 默认 0x03)不配就是「出厂行为」:阈值走 pin、延时走 pin、模式走 pin —— 而这三条在模组上全部落空(见 6.2)
软复位不改变已写寄存器内容(手册明写)所以「复位→写配置」两种理解下都安全,固件固定一个顺序,不做分支

这就是本 demo 的核心价值:不是「读一个传感器」,而是每次上电把一颗需要配置的芯片带回已知状态, 并且用回读校验证明它真的在状态里。

固件启动序列(严格顺序,每步失败都有明确上报):

#动作失败会打印
0先把 OUT(IO2) 配成输入 + 内部上拉(在模组上电之前)err OUT_INIT
1IO14 拉高 → 等不少于 100 mserr PWR_INIT
2建 I2C 总线(内部上拉,100 kHz)err I2C_BUS_INIT
3probe 0x28,失败逐级降频(配置值 → 100 kHz → 50 kHz)err I2C_NO_DEVICE + 提示加外置上拉
4读 0x0d(期望 0x0a)作存在性探针只打印实际值,不一致不中止
5软复位 0x00=0x00 → 10 ms → 0x00=0x01 → 20 mserr CFG_WRITE reg=0x00
6写配置块 7 组(0x6e 排在阈值之前)err CFG_WRITE block
7回读校验 13 个字节逐条 CFG_MISMATCH reg=… wrote=… read=…
8挂 OUT 双边沿中断err OUT_INIT
9自检窗口内丢弃事件(默认 3000 ms,从模组上电起算)窗口结束打 SELFCHECK done
10进入监控循环(20 ms 节拍 + 队列唤醒)—

6.2 三个「外部 pin 控制」为什么必须改寄存器(本方案最容易静默失败的地方)​

这颗芯片有三个开关:阈值档位、延时、工作模式。出厂时它们由芯片的物理 pin 决定, 只有把对应的「寄存器控制位」置 1,才会改由寄存器决定:

控制位不置 1 的后果为什么在 EDX106 上尤其致命
0x6e bit6阈值由外部 pin 的 8 档决定,0x0f/0x10 完全不生效(出厂 0x6e=0x98,bit6=0!)模组只有 5 个脚,这个 pin 没有引出,模组内部绑成什么未知
0x45 bit0延时由外部 delay pin 决定,0x46~0x49 不生效同上,delay pin 也没有引出
0x6c bit6工作模式由外部 burst_en pin 决定同上,burst_en 也没有引出

「静默失效」为什么最难查:写完 0x0f=70 之后回读仍然是 70(写入通路完全正常), 但芯片实际用的是 pin 档位 —— 现象是「参数改了没反应」,现场极容易误判成「芯片坏」或「接线松」。

所以本固件做了三重保护:

  1. 写顺序:0x6e 排在 0x0f/0x10 之前;
  2. 单独日志:启动时打一行 EDX106: ctrl 0x6c=… 0x6d=… 0x6e=… 0x45=… (thr_reg=… delay_reg=… mode_reg=…);
  3. 编译期断言:把「这三位必须为 1、且三个字节的默认值分别等于 0xD3/0xF8/0xE8」钉死, 改坏了直接构建失败(负控已验证:把 0x6e bit6 改成 0 → static assertion failed)。

:::warning 本次定稿的 0x6c 是 0x53(不是 0xD3) 两者的差别只在 bit7(ULP):0xD3 = 超低功耗档,0x53 = 常规模式。 这正是第 7 节测距的关键,别以为是写错了。 :::

6.3 为什么实测高电平宽度会大于 delay​

实测 delay=2000 ms,但三次触发的高电平宽度是 2368 / 3198 / 3845 ms。原因不是误差,是二次触发顺延:

t0(有人) t0+2000 t0+…
OUT ─────┐‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾┌─────────────────────
│ 高电平 = 芯片内部的 delay 定时(0x46~0x49) │
│ ▲ 期间又检测到运动 → 定时器被再次装满 → 继续高
LED ────┐‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾┌──── (灯直接映射 OUT 电平)
USB ────┤ trig=1 t=t0 … │ trig=0 t=t0+width
└── 闭锁(lockout, 0x52/0x53)在延时结束之后才开始计时 ──►

要点:

  • width 是实测宽度(固件算的),不是配置值。判据是「width 不小于 delay」而不是「约等于」;
  • 只要人手一直在门前动,width 就会一直顺延——这是门锁场景想要的(人还在就不灭灯);
  • 若确实要「到点必灭」,手册里 0x32 bit6 有关二次触发的位(本 demo 没有改它,保持出厂行为);
  • LED 定时在芯片里、不在 MCU 里:固件只做「电平 → 灯」的映射,不做任何软件定时, 所以「灯和 OUT 同步」是结构性正确,不依赖定时精度。

6.4 上电自检期 OUT 恒高约 3000 ms(必须丢弃)​

项值
自检时间约 3000 ms(0x3c/0x3d 默认 0x0bb8,单位 ms)
期间 OUT强制高(看起来像「一直有人」)
固件行为自检窗口内丢弃所有事件,只累计 dropped,窗口结束打一行 SELFCHECK done level=… dropped=…
窗口起点从模组上电(IO14 拉高)起算,不是从「配置写完」起算

为什么起点要从上电算:芯片自检是它自己上电后开始的,与 MCU 什么时候写完配置无关。 若从「配置写完」起算,窗口会被推迟,等于把芯片自检的最后一段暴露成误触发。

RESET 命令会重开窗口:软复位同样会重跑芯片内部自检。

6.5 闭锁时间(防抖)怎么工作​

项值说明
寄存器0x52 / 0x53(16 位,单位 1 ms)出厂约 1512 ms,本 demo 写 2000 ms
起算点延时(高电平)结束之后所以两次事件的最小间隔约为 delay + lockout = 4000 ms
实测0.5 s 间隔连挥 3 次 → 只记 1 次事件闭锁生效
实测1.0 m 处 22 s 内 3 次触发,间隔 6.4 s / 8.1 s均不小于 4 s,0 次违例

闭锁是「门锁不误触发」的第一道工程手段,比调阈值更直接: 调阈值是「降低灵敏度」,闭锁是「同一件事只算一次」。

6.6 本固件实际写入的寄存器表(可照抄)​

寄存器写入值(定稿)语义出厂默认
0x000x00 → 延时 → 0x01软复位 → 释放0x01
0x6c0x53(常规)/0xD3(ULP)bit7=1 超低功耗 / bit6=1 模式走寄存器 / bit4=1 关光敏(兼容保留)0x03
0x6d0xF8bit3=1 参数可调 / bits2:0=000 最低功耗档0xf3
0x6e0xE8bit6=1 阈值走寄存器 / bit5=1 burst 可调 / bits4:3=010x98
0x0f / 0x10thr 低 8 位 / 高 2 位(thr=70 → 0x46/0x00)阈值 0~10230x06/0x00
0x450x01bit0=1 延时走寄存器0x00
0x46~0x49delay 32 位小端(2000 → D0 07 00 00)高电平延时,单位 ms0x0400 = 1024 ms
0x52 / 0x53lockout 16 位小端(2000 → D0 07)闭锁时间,单位 ms约 1512 ms
0x600x33第一级接收增益(3 dB/step,值越大增益越小)0x33

回读校验覆盖 13 个字节:0x6c / 0x6d / 0x6e / 0x0f / 0x10 / 0x45 / 0x46~0x49 / 0x52 / 0x53 / 0x60。

6.7 关于 I2C 本身​

项值
7 位从机地址0x28(8 位写法:写 0x50 / 读 0x51)
速率芯片上限 400 kHz;本 demo 用 100 kHz(内部上拉下才稳)
寄存器空间111 个字节,偏移 0x00~0x6f,连续读写地址自动加一
单字节读必须重复起始(Sr):写偏移 → Sr → 读
地址选择脚没有(模组只 5 个脚,地址固定)

7. 调参即测距(本文第二重要的一章)​

7.1 决定性对比:瓶颈是功耗模式,不是阈值​

同一颗模组、同一套接线(内部上拉 100 kHz)、同一安装位置,只改工作模式与阈值:

配置写入值阈值实测触发距离备注
ULP 模式0x6c=0xD3300需贴很近出厂参考代码的初始默认
ULP 模式0x6c=0xD3115约 30 cm降阈值只换来一点距离
ULP 模式0x6c=0xD370只验了在线写入 rd=70(未单独测距)—
常规模式0x6c=0x5370不小于 1.0 m,稳定触发本次定稿配置

结论:探测距离由占空比决定,不由阈值决定。 ULP 是 burst / duty-cycle 扫描,把平均电流压到 µA 级,代价就是探测距离被占空比直接压掉; 常规模式是连续工作,距离回到芯片标称水平。想要 1 m 级距离,只能常供电。

7.2 两档功耗差约 100 倍(并且本文不给续航数字)​

档位电流量级来源备注
ULP 模式78~341 µA芯片手册实测表(对应不同功耗档 / burst 频率)模组规格书没有这一栏
常规模式约 26 mA芯片手册模组规格书写的是「常规 <55 µA」,与芯片手册矛盾

两档差约 100 倍,这是「30 cm 对 1.0 m」的电气根源。

:::danger 本文不写任何续航 / 平均功耗 / 「能用几个月」的数字 原因:两份资料的电流本身互相矛盾(模组规格书「常规 <55 µA」vs 芯片手册「常规约 26 mA」), 且两份都没有给峰值 / 启动浪涌。续航结论还依赖电池容量、占空比策略、唤醒频率与整机静态电流, 这些在本 demo 里一项都没实测。需要续航结论时,按附录 C ① 先测功耗再说。 :::

7.3 现场调参顺序(照这个顺序,代价从低到高)​

#命令预期效果代价 / 副作用
1SET mode=normal最大杠杆(0xD3 → 0x53)。距离回到芯片标称水平电流涨到约 26 mA 量级;电池场景要重新评估
2SET thr=70 → 60 → 40灵敏度提高,1 m 站稳更易触发误触发上升(走廊人流、窗帘、风扇都可能触发);低于约 40 后底噪开始主导
3SET win=10,4,2「需超阈值的窗口数」减一,明显更易触发抗噪变差:单窗偶然尖峰就会被判成「有人」
4SET gain=3(值越小增益越大)增益变大 → 距离增加同时放大噪声与本振泄漏,容易误触发
5检查安装朝向 / 壳体10.5 GHz 穿透极差:金属完全挡死,塑料壳要留窗纯结构改动,无电气副作用
6检查电源纹波(H3 的 V 对 G)纹波超标会同时造成误报与灵敏度下降需要示波器;对策是加去耦 / 换电源

一次完整的现场脚本(照抄即可):

CFG? → 先看现状(thr / delay / lockout / mode 分别是什么)
SET mode=normal → EDX106: set mode=normal ok rd=0x53
EDX106: run mode=normal thr=70 ... ← 先确认模式真的切了
(此时手在 1.0 m 处试;已 OK 就到此为止)
SET thr=60 → EDX106: set thr=60 ok rd=60
SET win=10,4,2 → 明显更易触发(抗噪变差)
SET gain=3 → 增益变大(值越小增益越大)
TRIG? → 看累计次数与当前电平,确认这次改动有没有效果

:::warning 两条容易踩的坑

  1. SET 不落 NVS:设置只在本次运行有效,复位 / 重新上电就回到编译期默认(本 demo 默认已是常规模式 + thr=70)。 现场调好后要固化,得改 sdkconfig.defaults.door_lock_edx106 并重新构建烧录。
  2. 改过 0x0d(SET win=)之后重启,启动日志可能出现 id reg0x0d=… expect=0x0a (mismatch, continue) —— 这不是器件坏: 0x0d 同时是「窗口长度」和本固件拿来当存在性探针的寄存器。判据依旧看 5.3 那三行。 :::

7.4 怎么把「距离 vs 参数」变成数据而不是印象​

用触发事件抓取工具落 CSV(每次触发一行:宽度、间隔),每换一组参数就换一个标签:

py -3 tools\edx106_capture.py --port COM8 --duration 22 --label "normal_thr70_1.0m"

判据:

  • 每行宽度不小于 delay(小于 delay 说明 0x45 bit0 没生效,延时还在走 pin);
  • 两次 trig=1 的间隔不小于 delay + lockout(否则说明闭锁没生效);
  • 一次只测一个固定距离:异步指令下无法对齐「用户实际开始时刻」,站定后持续挥手 18 s 最干净。

8. 验证清单​

从插模组到看见触发,逐项打勾。每一项都标了状态: 已实测 = 2026-10-27 在真实 EDK60 + EDX106-N-01 上跑过; 待实测 = 仍未验证(清单见本文开头的验证状态块与附录 C)。

8.1 环境与链路​

#步骤期望现象状态✅
1模组 5 根线按 3.2 接到 H3(SCL→T/IO4、SDA→A/IO5、OUT→A2/IO2、V/G→V/G)万用表通断逐根核对通过已实测 ✅☑
2USB-C 连 PC(数据线)绿灯 ON 常亮;设备管理器出现「USB 串行设备 (COMx)」已实测 ✅☑
3丝印 RADAR 红灯亮亮(= IO14 拉高、3.3V_RADAR 建立)已实测 ✅☑
4烧录固件(4.1 / 4.2 / 4.3)Hash of data verified;烧 0x0 时体积 254,736 B已确认(合并包 254,736 B / SHA256 1B13C347C9EB50DC7A792B697B02CD16831713039D38D546D8493E165306CE78)☐
5构建回归build_all.ps1 -Size → 20/20已确认(工程 demo 总数 20)☐

8.2 通信与配置(本 demo 的验收核心,全部已实测)​

#判据阈值 / 期望状态
6I2C 总线i2c ok freq=100000 … pullup=internal,无降频已实测 ✅
7地址扫描SCAN 结果里出现 0x28已实测 ✅
8存在性探针读 0x0d 返回 0x0a已实测 ✅
9三个控制位0x6e=0xe8(thr_reg=1)、0x45=0x01(delay_reg=1)、0x6c 的 mode_reg=1已实测 ✅
10回读校验13 个寄存器全通过,cfg ok,0 条 CFG_MISMATCH已实测 ✅
11断电重上电每次上电都出现 cfg ok(连续 10 次压测)已实测 1 次(首次上板);10 次压测 待实测

8.3 功能与时序​

#检查期望状态
12OUT 空闲低、有人高无人约 0 V、有人 3.2~3.4 V已实测 ✅(由 TRIG? 与事件行印证)
131.0 m 触发1.0 m 处站立 / 挥手必触发已实测 ✅(22 s 内 3 次)
14高电平宽度不小于 delay(2000 ms);实测 2368 / 3198 / 3845 ms已实测 ✅(大于 delay 因二次触发顺延)
15闭锁防抖0.5 s 间隔连挥 3 次 → 只记 1 次事件已实测 ✅
16橙灯每次触发都亮,随 OUT 回落已实测 ✅(用户目视确认)
17自检期丢弃上电后约 3000 ms 内无 trig=1,只有 SELFCHECK done已实测 ✅
18SET 回读确认每条写命令回执都带 ok rd=…,且 run 快照同步变化已实测 ✅(thr=70 / mode=normal 等)
19LED on / LED off / LED?灯随命令亮灭、level 随命令变化已实测 ✅(现场调试验证)
20上电偶发进下载模式不出现已实测(本次未出现;若出现走 3.6 Plan B)

8.4 仍待实测​

#检查现状怎么补
21电池供电续航无任何数字(两份资料矛盾)串采样电阻测常规 / ULP 两档平均电流,再乘实际占空比(附录 C ①)
2230 分钟长稳最长观察 22 s静置 30 min + 每隔 1 min 触发一次,看 CFG_MISMATCH 与 i2c_err 是否增长
23深睡唤醒未实现(OUT 在 IO2,属 EXT1 域)固件加 EXT1 唤醒 + 实测唤醒电流与恢复时间(附录 C ③)
24外置上拉下 400 kHz全程 100 kHz 内部上拉H3 侧并 2×4.7 kΩ 后写读 1000 次,i2c_err 必须为 0(附录 C ④)

9. 故障排查​

9.1 三层法:电源 → 总线 → 参数与安装​

照顺序走,不要跳层。 前一层的现象会伪装成后一层的问题。

第①层 RADAR 红灯不亮 = 模组没上电​

现象判据处置
红灯不亮、绿灯亮3.3V_RADAR 没建立确认插的是 H3(不是 H4);固件是否把 IO14 拉高(确认烧的是 door_lock_edx106);量 H3 的 V 对 G 是否 3.3 V ±5%(3.14~3.47 V)
两个灯都不亮USB 链路换数据线(最常见)→ 换 USB 口(台式机用机箱后面)→ 换主机
红灯亮但设备管理器没有串口USB 链路同上;按住 BOOT 再插 USB 后松开

:::tip 红灯是唯一能直接判断「模组有没有电」的指示 红灯不亮时,任何 I2C 排查都是白做——芯片没上电,SCAN 一定扫不到 0x28。 :::

第②层 SCAN 扫不到 0x28 = 接线 / 上拉 / 降频​

按顺序做,每一步都只改一个变量:

#动作期望
1查 SCL 与 SDA 是否接反(SCL→H3 的 T(IO4)、SDA→A(IO5))接反的现象就是「红灯亮、扫不到」
2确认启动日志里有 pullup=internal、boot pwr_en=1内部上拉没启用时总线是浮空的
3把跳线缩短(不超过 10~15 cm),确认共地良好内部上拉约 45 kΩ,线越长上升沿越慢
4把 APP_EDK60_EDX106_I2C_FREQ_HZ 设成 50000,重建后再扫固件本身有三级降频(配置值 → 100 kHz → 50 kHz),若看到 I2C_DOWNSHIFT 说明已到边缘
5仍不行 → H3 侧外并 2×4.7 kΩ 到 3V3固件连续两次失败会自己提示这一条(hint 建议加 2x4.7k 外置上拉)

SCAN 扫不到不等于芯片坏:这颗芯片没有复位脚、没有地址脚,扫不到只有三种可能—— 没上电 / 线不通 / 上拉不足。

第③层 能通信但测不远 = 功耗模式 / 阈值 / 安装​

这一层是最容易「以为硬件坏了」的一层。先看 run 行的 mode:

现象先看什么结论与处置
run … mode=ulp / ctrl … 0x6c=0xd3(ulp=1)模式还在 ULP这是 30 cm 级的默认档。SET mode=normal(7.1 第 1 步)
mode=normal 但 1 m 不触发阈值 / 窗口 / 增益按 7.3 顺序:thr 70→60→40、win 的 cnt 由 3 改 2、gain 由 4 改 3 再改 2
阈值改了没反应CFG? 里有没有 thr_src=pin 告警0x6e bit6=0 → 阈值仍走 pin,写进去不生效(6.2)
触发但 width 远小于 delayctrl … 0x45=0x01(delay_reg=1)0x45 bit0 没生效 → 延时还在走 pin
完全不动也报触发电源纹波 / 安装朝向纹波超过 100 mV 会误报;金属门 / 玻璃 / 陶瓷贴在模组前方也会异常(10.5 GHz 穿透极差)
一上电就 trig=1 且久久不落自检窗口太短调大 APP_EDK60_EDX106_SELFCHECK_MS(默认 3000,芯片标称即 3000)

9.2 本方案特有的坑(按杀伤力排序)​

#现象根因处置
1参数改了没反应(回读却正确)三个控制位之一没置 1,参数走的是 pin看 ctrl 行三个 *_reg=1;CFG? 有 thr_src=pin 告警
2忘了每次上电重配,现场「参数不对」芯片寄存器掉电不保存本固件已在启动序列里强制重配 + 回读;自己写固件时别省这一步
3上电前 3 s 被判成「一直有人」自检期 OUT 恒高固件已在自检窗口内丢事件;自己写固件时用 0x3c/0x3d 的毫秒数 + 余量
4「宽度比 delay 长,是 bug 吗」二次触发顺延(6.3)不是 bug;判据用「width 不小于 delay」
5想同时接 EDV11P/EDV163共用 IO4/IO5一次只能一个雷达 demo;换 demo 要拔线 + 重烧
6换到 H4 后一个 ACK 都没有H4 顺序镜像,T 与电源使能同侧认准丝印 H3,按 RES A R T G V P 对齐
7跑 400 kHz 就大量 NACK内部上拉约 45 kΩ,上升沿不够快先降回 100 kHz;要 400 kHz 必须外并 2×4.7 kΩ(待实测,附录 C ④)
8上电偶发进下载模式IO2 是 strapping 关注脚Plan B:OUT_GPIO=3 + 线挪到 H3 的 A3(3.6)
9改了 SET win= 后重启,id reg0x0d 报 mismatch0x0d 既是窗口长度又是存在性探针不是故障;判据看 5.3 三行
10网页页面打开是 404静态资源尚未部署先用命令行;不要因此怀疑接线
11网页与命令行 / idf.py monitor 同时开同一个 COM 口只能一个程序占用先断开一个

10. 已知边界​

诚实列出这个方案没有做到的地方——照着做之前请先看这一节。

#边界说明
1本型号无光敏型号 EDX106-N-01,命名规则里 N = 无光敏 → 没有光敏脚。0x6c bit4(关光敏)在本型号上无实际作用,固件写 1 属兼容保留(换 -Y 型号才有意义)。所以「白天 / 夜晚不同灵敏度」这类策略做不了
2模组没有 delay / burst_en / 阈值档位 pin5 个脚里这三路全部没有引出,芯片内部把这三个「外部 pin 控制」绑成了什么未知。本 demo 的应对是把三个控制位强制切到寄存器(6.2),因此不依赖这个未知量
3供电纹波要求不超过 50~100 mV规格书注意事项明写:纹波超标会「受干扰和误报」。本 demo 用 PC 的 USB-C 供电(未实测纹波值);若改电池 / 适配器,第一件事是量纹波
410.5 GHz 穿透极差金属完全挡死;玻璃、陶瓷、金属拉手也不能放在天线前方;天线板与金属平面要保持 5~12 mm,且前方必须是塑胶。门锁里常见的金属面板 / 玻璃面板都在禁区
5电池场景必须用 ULP 换距离ULP 档(78~341 µA)实测只有约 30 cm,常规档(约 26 mA)才不小于 1.0 m。两档差约 100 倍电流——电池门锁要么接受近距离方案,要么接受常供电
6不给续航数字见 7.2:两份资料电流矛盾且都没给峰值。任何「能用 X 个月」的说法在此刻都没有依据
7SET 不落 NVS运行期改动复位即失效。固化要改默认配置并重新构建烧录
8本 demo 只做「在线监测 + 亮灯」未实现深睡唤醒。好在 OUT 在 IO2(GPIO0~7,EXT1 域),产品化可直接用,不需要改脚
9只给「有人/无人」,不给距离与坐标OUT 是单比特电平,不含距离、速度、方向信息。需要这些请换带数据接口的模组
10「有人」是运动感应,不是存在感应10.5 GHz 多普勒测的是运动。人坐在门前一动不动可能不触发(本次未专项实测)
11外部上拉 + 400 kHz 未验证样机全程 100 kHz + 内部上拉(零外部电阻)。量产要升 400 kHz 时需补测(附录 C ④)
12IO2 是 strapping 脚app 运行前的电平由芯片内部默认决定,固件管不到。固件只配输入 + 上拉、从不驱动;异常时走 Plan B(IO3)
13走 H3 就不能同时接其它雷达与 EDV11P / EDV163 共用 IO4/IO5
14不承担安全/控制责任这是技术演示:触发信号未经功能安全评估,不可直接驱动锁体、门禁联锁等有安全后果的执行机构

附录 A · 寄存器速查​

A.1 本 demo 写入的 7 组(定稿值)​

0x00 ← 0x00, 延时 10 ms, 0x01 软复位 → 释放(不改变其它寄存器内容)
0x6c ← 0x53(常规) / 0xD3(ULP) 模式走寄存器 + 关光敏(兼容保留)
0x6d ← 0xF8 参数可调 + 最低功耗档
0x6e ← 0xE8 ★ bit6=1 阈值走寄存器
0x0f ← thr & 0xFF 0x10 ← (thr>>8) & 0x03 阈值 0~1023(默认 70)
0x45 ← 0x01 ★ bit0=1 延时走寄存器
0x46~0x49 ← delay 32 位小端(ms) 默认 2000 → D0 07 00 00
0x52,0x53 ← lockout 16 位小端(ms) 默认 2000 → D0 07
0x60 ← 0x33 第一级增益(值越大增益越小)

写入顺序硬约束:0x6e 必须写在 0x0f/0x10 之前(否则阈值那一刻仍由 pin 决定)。

A.2 三个「缺一不可」的控制位​

位置 1 后不置 1 会怎样
0x6e bit6阈值由 0x0f/0x10 决定阈值由外部 pin 的 8 档决定,写进去不生效
0x45 bit0延时由 0x46~0x49 决定延时由外部 delay pin 决定,写进去不生效
0x6c bit6工作模式由寄存器 bit7 决定模式由外部 burst_en pin 决定,ULP / 常规切换无效

A.3 回读校验覆盖的 13 字节​

0x6c 0x6d 0x6e 0x0f 0x10 0x45 0x46 0x47 0x48 0x49 0x52 0x53 0x60

A.4 只读 / 参考寄存器(本 demo 不改,但排查时会看)​

寄存器出厂默认用途
0x0d0x0a窗口长度(采样点数);本固件拿它当存在性探针
0x30 / 0x310x04 / 0x03观察 4 个窗口、其中 3 个超阈值即触发(SET win= 可改)
0x3c / 0x3d0x0bb8 = 3000 ms上电自检期(OUT 恒高),改后需软复位
0x320x04bit6 关二次触发;bits5:4 GPIO 逻辑极性

附录 B · 命令速查​

命令作用写芯片回执示例
CFG?逐条回读 9 组寄存器并翻译语义(含 thr_src=pin 告警)否多行寄存器清单
SCAN扫 0x08~0x77,标出 0x28否地址列表
TRIG?当前电平 / 最近触发时刻 / 累计次数 / 丢弃计数否单行
SET thr=70写 0x0f/0x10 + 回读 + 复查 0x6e bit6是set thr=70 ok rd=70
SET delay=2000写 0x46~0x49 + 回读是set delay=2000 ok rd=2000
SET lockout=2000写 0x52/0x53 + 回读是set lockout=2000 ok rd=2000
SET mode=normal只翻 0x6c bit7 + 回读是set mode=normal ok rd=0x53
SET gain=3写 0x60 高 4 位(低 4 位保持)+ 回读是set gain=3 ok rd=…
SET win=10,4,3写 0x0d / 0x30 / 0x31 + 三项回读是set win=10,4,3 ok rd=10,4,3
LED on / LED off只动 IO15,不碰 I2C否led on gpio=15 level=1
LED blink亮灭 3 × 200 ms否led blink done
LED?电平原值 / 是否点亮 / 编译开关否led? level=1 on=1 …
RESET重跑启动序列(软复位 + 重配 + 重开自检窗口)是重复整段启动日志

事件行格式(全部以 EDX106: 开头):

EDX106: t=<ms> trig=1 level=1 delay=<ms> lockout=<ms> thr=<n> mode=<normal|ulp>
EDX106: led on (trigger)
EDX106: t=<ms> trig=0 width=<实测毫秒>
EDX106: led off (release)
EDX106: stat interval=10s trig=<n> width_min=<ms> width_max=<ms> i2c_err=<n>
EDX106: SELFCHECK done level=<n> dropped=<n>
EDX106: ctrl 0x6c=0x.. 0x6d=0x.. 0x6e=0x.. 0x45=0x..
EDX106: cfg ok thr=.. delay=.. lockout=.. mode=.. light=off
EDX106: run mode=.. thr=.. delay=.. lockout=.. gain=0x33(0x60) win=..,..,..
EDX106: CFG_MISMATCH reg=0x.. wrote=0x.. read=0x..
EDX106: err <CODE> ...

:::note stat 行有两个独立键 width_min= 与 width_max= 是两个独立键(不是一格两值),自己写解析器时按两个键取。 :::


附录 C · 待补清单(仍未验证的 4 项 + 1 个前提)​

2026-10-27 上板跑通后,「通信、地址扫描、13 字节回读、1.0 m 触发、宽度、闭锁、橙灯」已完成并从本表移除。 下面只剩真的还没测的与一个影响结论口径的前提。

#待补项影响怎么补
①电池供电续航决定「电池门锁」这个产品形态成不成立采样电阻 + 示波器(或高分辨率万用表长时间积分)测常规档与ULP 各功耗档的平均电流;再乘实际占空比。在拿到实测值之前,不要对外承诺任何续航数字
②30 分钟以上长时稳定性本 demo 最长连续观察 22 s静置 30 min + 每 1 min 触发一次,末尾复核 CFG? 无 CFG_MISMATCH、i2c_err 不增长
③深睡唤醒决定「有人靠近才唤醒 MCU」能不能做固件里把 OUT(IO2) 配成 EXT1 唤醒源,测唤醒电流、从触发到串口首行的时延、误唤醒率
④外置上拉下升 400 kHz决定量产能不能把总线提速(现在 100 kHz)H3 侧并 2×4.7 kΩ 到 3V3,跑 1000 次寄存器读写,i2c_err 必须为 0;再对比降回 100 kHz
⑤两份资料的电流矛盾(前提项)影响所有功耗 / 续航结论的口径模组规格书写「常规 <55 µA」,芯片手册写「常规约 26 mA」。按 ① 的实测去裁决;在那之前,本文只写「两档实测范围 + 差约 100 倍」,不写结论

许可与署名​

本项目代码与文档以 MIT License 发布,作者 @fuhua817。

寄存器语义(0x6c / 0x6d / 0x6e / 0x0f / 0x10 / 0x45 / 0x46~0x49 / 0x52 / 0x53 / 0x60、 自检期 0x3c/0x3d、I2C 地址与时序)均以原厂《AT10LP1T1RDB 寄存器读写说明》V1.2 为准,版权归原厂所有; 模组电气与安装约束以《EDX106 规格书》为准。若原厂后续发布新版手册且与本文冲突,以新版手册为准。

:::danger 免责声明 本项目是技术演示与方案验证用途。雷达触发信号未经功能安全评估, 受安装朝向、金属遮挡、电源纹波、环境运动与参数配置影响; 链路已于 2026-10-27 上板跑通,但电池续航、长时稳定性、深睡唤醒、400 kHz 总线仍未验证, 不可用于有安全后果或需要可复现触发的生产场景。用于实际项目前,请按目标市场的无线电、数据与安全法规完成合规评估。 :::