Skip to main content
Version: Next

EDK60 多工程 Demo(ed_edk60_demos)

仓库:GitHub · easydetek/ed_edk60_demos | 国内镜像:Gitee · easydetek/ed_edk60_demos | 许可:MIT

一套工程、多个 demo:所有示例放在同一个 ESP-IDF 工程里,用 idf.py menuconfig → EDK60 Demo → 选择要编译的 Demo 单选一个编译运行,不用为每个 demo 切分支或换目录。

项目内容
主控ESP32-C6-MINI-1-N4(RISC-V 单核 @160 MHz,4 MB Flash,无 PSRAM)
开发框架ESP-IDF v6.1
工程根目录仓库根目录(CMakeLists.txt 直接位于此处)
串口能力C6 原生 USB Serial/JTAG(IO12 / IO13),板上无 USB 转串口芯片
板级支持包components/edk60_board(引脚宏 + LED / 按键 / I2C / 雷达电源 / 控制台),引脚写错会编译期报错
许可MIT

快速开始​

# 1. 激活 ESP-IDF v6.1 环境(或按 docs/vscode-setup.md 用 VS Code 插件)
idf.py --version

# 2. 选 demo 并编译
idf.py set-target esp32c6 # 本工程只支持 esp32c6
idf.py menuconfig # → "EDK60 Demo" → "选择要编译的 Demo"
idf.py build
idf.py -p COM<x> flash monitor # Ctrl+] 退出监视

# 3. 批量编译全部 demo(回归验证用,每个 demo 独立 build-<demo>/ 目录)
powershell -ExecutionPolicy Bypass -File .\build_all.ps1 -List
powershell -ExecutionPolicy Bypass -File .\build_all.ps1

VS Code 用户不需要命令行:装 ESP-IDF 插件后,按仓库 docs/vscode-setup.md 图形化选 demo / 编译 / 烧录 / 监视。

Demo 清单(17 个)​

基础外设组

#demo目的关键观察点
1.1hello_board板卡自检 + 串口心跳上电打印 EDK60 横幅;RX/TX 两颗黄灯各闪一次;每 5 秒打印运行时长与空闲堆
1.2blink最小 GPIO 输出IO8 慢闪 1 Hz、IO9 快闪 5 Hz
1.3button按键输入(轮询 vs 中断消抖)按下/松开都打印;按住 ≥2 秒标为长按;与 100 ms 轮询结果对照
1.4uart_echo硬件 UART 收发UART1 重映射到 IO16 / IO17,发什么回显什么(ASCII + HEX)
1.5adc_readADC1 六通道采集与校准A0–A5 每通道打印 raw / 校准 mV,末行输出可喂示波器的 CSV

无线组(Wi-Fi 6 / BLE 5)

#demo目的关键观察点
2.1wifi_staSTA 扫描 / 连接 / 状态打印 AP 表(SSID / BSSID / 信道 / RSSI / 加密);断线自动重连
2.2wifi_softapSoftAP + DHCP手机可连接并拿到 IP;实时打印站点上下线
2.3ble_uartBLE 串口透传(NUS 兼容)手机 nRF Connect 能发现 EDK60-BLE-UART 并收发
2.4ble_scanBLE 广播扫描解析名字 / UUID / 厂商数据 / iBeacon,按周期输出 RSSI 汇总

Wi-Fi 只支持 2.4 GHz;ESP32-C6 无经典蓝牙,BLE demo 使用 NimBLE 协议栈。

板载互动组(针对 EDK60 特有电路)

#demo目的关键观察点
3.1radar_power3.3V_RADAR 使能时序 + 雷达 UART 观测演示一次关→开电源复位;丝印 “L” 的橙灯亮 = 雷达已上电;未插模组会给出静默诊断;BOOT 键切换电源
3.2led_sequenceLEDC PWM 灯效编排5 种灯效(交替 / 呼吸 / 追光 / 交叉呼吸 / SOS),BOOT 键循环
3.3i2c_scanI2C 总线扫描打印地址网格 + 常见器件识别;空板扫不到是正常现象

低功耗与存储组

#demo目的关键观察点
4.1deep_sleep深睡 + 三种唤醒源打印唤醒原因与累计次数;LED 闪次编码唤醒源;EXT1 仅 IO0–IO7
4.2nvs_rwNVS 读写 / 统计打印「本机第 N 次启动」、键值清单、分区使用统计
4.3usb_serial_bridge原生 USB ⇄ UART 桥(调试视图)PC 出现 USB 串行设备;本地回环可验证 USB 通路。⚠ 实际单向:「雷达→USB」可用,「USB→雷达」因 UART1 的 TX 未布线而物理不通

雷达透传组

#demo目的关键观察点
5.1radar_bridgeEDV151 体征雷达原始字节透传(不解析协议)自动识别接收脚与波特率;使能后橙灯亮;PC 打开 USB 串行设备即可看到原始字节;本地回环自测
5.2radar_bridge_edv11pEDV11P 侧装雷达纯字节透传(零协议注入、零 printf)USB 流里只有雷达数据;上电后需主机下发一次 SET 0x05=1 才开始上报;配套 release/track.html 与 tools/edv11p_frame_check.py

5.1 与 4.3 的区别:4.3 是通用 USB↔UART 桥 + 调试视图;5.1 是面向雷达模组开箱即用的透传,多了「自动识别接收脚与波特率」「雷达电源使能控制」「本地回环自测」三项能力。两者都只做字节搬运。

只想在 PC 上看雷达数据:三步​

  1. 选 demo 并烧录:build_all.ps1 -Demo radar_bridge → idf.py -p COM<x> flash
  2. 看控制台(H2 排针 D0/RX(IO16)、D1/TX(IO17),115200)确认识别到雷达与波特率
  3. 在 PC 上打开USB 串行设备(VID 303A)收原始字节——波特率随意(USB CDC 不依赖波特率)

:::warning 日志与数据是两条链路 C6 的 USB Serial/JTAG 只有一个外设。若把控制台日志也接到 USB,日志会与雷达数据混进同一个 FIFO, 数据流就被污染了。radar_bridge 默认在 sdkconfig.defaults.radar_bridge 里关掉了该选项,并带编译期保护。 :::

站内配套文档:

仓库里的关键文档​

文档用途
docs/EDK60-pinmap.md引脚定义表(含实测结论)、雷达电源控制、电源树、待实测确认项 —— 写代码前必读
docs/EDK60-pitfalls.md开发避坑清单 + 排障速查表
docs/vscode-setup.mdVS Code + ESP-IDF 插件使用说明
docs/flash-guide-for-beginner.md新手烧录指南(与本站生命体征检测实施指南同源)
docs/tutorial-edv151-vital-signs.mdEDV151 体征雷达打通全过程(开发者教程)
docs/recipe-edv11p-person-tracking.mdEDV11P 侧装人数统计实施指南
docs/case-edv11p-person-tracking.mdEDV11P 应用案例(含 30 分钟实测数据与轨迹图)
docs/SCH_EDK60_VA.pdf原理图(EDK60_VA V1.0)
release/网页烧录 / 实时监测 / 轨迹演示页面与固件

硬件红线(违反会踩坑)​

事项说明
雷达引脚(已实测)模组 TX→IO4、模组 RX←IO5、电源 EN=IO14、橙灯=IO15。早期按图纸推断「EN=IO15、RX=IO14」两个都错,已由 2026-10-15 上板实测推翻
模组必须插 H3H4 的 T 脚与电源使能同网络,插 H4 会互相干扰
射频默认关闭必须下发 turn_on,否则没有任何体征数据
增益过大会恒为 0出厂 gain=4 / boost=0 会让心率呼吸永远算不出来,需 set_gain 0.5 + set_boost 2
雷达接口只有 RXIO15 被电源使能占用,且 C6 的 UART1 无 IOMUX 默认引脚,H4 上没有给雷达的独立 TX —— 无法主动向雷达发命令(usb_serial_bridge 因此是单向的)
USB 是单一外设USB Serial/JTAG 只有一个,PC 上只呈现一个 COM 口;JTAG 与数据分时复用,不开调试器不占链路
IO8 / IO9 是 strapping复位瞬间不要外接强驱动;IO9 同时是 BOOT 键,上电按住会进下载模式
IO12 / IO13 被 USB 占用拿去当 GPIO 会失去 USB 串口与调试能力
ADC 只能用 ADC1C6 的 ADC2 不提供给用户程序;IO7 无 ADC;输入不得超过 3.6 V

完整红线与实测依据见仓库 docs/EDK60-pitfalls.md 与 docs/EDK60-pinmap.md。

相关文档​