自动规则的阈值该定多少?——用 ESP32 智能家居数字孪生做一次控制变量实验(4 课时 )
摘要
这是一份面向 7—9 年级、共 4 课时的科学探究实践案例。学生从"教室和家里总有人走灯不灭"这一真实问题出发,用一块 ESP32、几个常见传感器和一个网页 3D 数字孪生,亲手搭建"感知—判断—执行"的闭环,然后围绕一个可探究的科学问题做控制变量实验:在传感器读数存在抖动的条件下,自动规则的阈值取多少,才能既及时动作又不反复误触发?
项目最特别的地方是零硬件也能完整开展:电脑端的 --sim 模拟模式会生成一个"假 ESP32",同样上报传感器数据、同样触发规则,因此没有器材的学校也能完成全部 4 课时;有器材的小组则可以把仿真结论拿到真实硬件上验证。全套源码、协议、任务单、数据记录表和评价观察表都在文内公开。
对应主题方向:方向六「人工智能」(认识人工智能、智能规划、人机交互与人工智能的规范使用),兼方向五「新兴产业」(能源利用与工程设计)。
一、项目介绍
1.1 创作背景与真实问题
在教室、实验室和普通家庭里,"人走了灯还亮着""空调开一整晚"是几乎每个人都遇到过的现象。学生会很自然地提出:"装个传感器,让灯自己关不就行了?"
真正动手之后才会发现问题没那么简单:传感器读数一直在抖,人从光敏电阻前走过会造成瞬时遮挡,PIR 也会因为窗帘飘动误报。如果阈值定得太灵敏,继电器会"咔哒咔哒"反复动作;定得太迟钝,人走了灯又不关。于是"自动"反而变成了新麻烦。
这个问题同时具备三个特点:来自学生身边、可以用低成本器材定量研究、结论能直接改进自己的作品。它正好对应《义务教育阶段科学教育"做中学"领航行动指南》(教监管厅〔2026〕1 号)所强调的"聚焦真实问题,开展跨学科项目式学习",以及"通过提出问题和假设、设计方案、搜集分析证据、得出结论并解释、制作改进、交流反思"的完整链条。
1.2 探究问题与假设
主问题:在传感器读数存在抖动的情况下,自动规则的阈值 T 取多少,才能既及时动作、又不反复误触发?
分解出三个可由学生自主验证的子问题:
- Q1:阈值 T 与"误触发次数""漏触发"之间是什么关系?是否存在一个合适的阈值区间?
- Q2:只有"上升沿触发"够不够?加入"连续 N 次确认"或"滞回双阈值"能改善多少?代价是什么?
- Q3:网页里的 3D 状态与真实硬件状态是否一致?一条指令从页面到硬件再回到页面,需要多长时间?
学生假设(写在任务单上,实验后再回头对照):
- H1:阈值越靠近正常读数的波动带,误触发越多;阈值离波动带太远则会漏触发。
- H2:连续确认与滞回都能显著降低误触发,但会带来可测量的响应延迟。
- H3:2 秒采样周期下,串口链路的往返时间远小于采样周期,足以支撑课堂上"发出指令—看到反馈"的闭环。
1.3 应用场景与学段
- 学段:7—9 年级(初中)为主,对应《指南》"能应用控制变量方法,制订比较完整的探究方案";小学高年级可改用定性版(只数"咔哒"次数,不做统计)。
- 课时:4 课时,每课时 45 分钟,2—4 人一组,符合《指南》"每个学生每学期完成不少于 1 个任务且不少于 4 课时"的要求。
- 课程归属:信息科技(人工智能与智慧社会)、物理(电路与测量)、综合实践活动 / 校本课程,可统筹使用跨学科主题学习课时。
- 场景:普通教室即可,不需要路由器、不需要 WiFi、不需要云平台,一根 USB 数据线就能跑。
1.4 核心功能
- 网页 3D 房间与 ESP32 双向控制:点 3D 家具下发指令,按实体按钮则页面同步变化。
- 7 个默认设备(吊灯、落地灯、风扇、空调、电视、窗帘、门锁)与 4 类默认传感器(DHT11 温湿度、光照 ADC、PIR 人体、HC-SR04 测距),均可在网页上增删、改名、改 GPIO。
- 阈值规则引擎:任选传感器与指标(温度 / 湿度 / 读数)、比较符(大于 / 小于)、阈值、目标设备和动作,条件成立时自动下发 ESP32;采用上升沿触发,避免每帧重复下发。
- 温湿度双线趋势图(保留最近 40 个采样点)、通信日志窗口、本地配置保存。
- 模拟模式:
python bridge_serial.py --sim不接任何硬件即可上报数据,用于零器材课堂与课前预演。 - 3D 第一人称漫游:学生可以"走进"这间屋子,从窗户往外看、开门进楼道、走楼梯到其他楼层,用场景式学习理解"谁在触发传感器"。
- 完善的引脚冲突检测:控制脚、按钮脚、传感器脚、超声波触发脚、DHT 单总线脚互斥,非法配置会被固件拒绝并在日志里说明原因。
1.5 涉及的科学原理(跨学科)
| 学科 | 科学概念 | 在本项目中的体现 |
|---|---|---|
| 物理 | 光敏电阻分压与 ADC 采样、热释电红外、声速测距、GPIO 高低电平 | LDR 与 10 kΩ 电阻串联分压接 GPIO34;PIR 输出 0/1;HC-SR04 用 dur × 0.034 / 2 换算厘米;继电器 / LED 由 digitalWrite 驱动 |
| 数学与统计 | 阈值、变量控制、噪声与波动带、上升沿、频数统计、时延 | 阈值扫描、误触发计数、采样间隔与抖动统计 |
| 信息科技 | 传感—判断—执行闭环、事件驱动、状态同步、协议设计 | 一行一条 JSON 的串口协议、WebSocket 广播、上升沿去抖、localStorage 状态持久化 |
| 工程与技术 | 需求—设计—制作—测试—改进、约束与权衡 | 引脚资源约束、误触发与响应延迟的取舍、低压安全设计 |
| 人文与伦理 | 科技教育与人文教育协同、AI 的规范使用、人在回路 | 讨论"过度自动化"对老人夜间起居的影响、传感器采集边界与隐私、保留手动覆盖按钮 |
需要特别说明一点:本项目是规则式(符号主义)的智能控制,不是数据驱动的机器学习。这恰好是《指南》"人工智能"主题里"认识人工智能""了解人工智能带来的伦理与安全挑战"的好载体——学生能亲手看清"所谓智能"背后的 if-then 规则,进而讨论它的能力边界和责任归属,而不是把自动化当成黑箱崇拜。
1.6 与《做中学》指南的逐条对应
| 《指南》要求 | 本文对应做法 |
|---|---|
| 聚焦真实问题、跨学科项目式学习 | 1.1、1.5;物理 + 数学 + 信息科技 + 工程 + 人文 |
| 每学期不少于 1 个任务且不少于 4 课时 | 4.5 节 4 课时任务单 |
| 提出问题和假设、设计方案、搜集分析证据、得出结论、制作改进、交流反思 | 第 3 章完整探究链条,1.2 节先写假设 |
| 应用控制变量方法 | 3.1 节自变量 / 因变量 / 控制变量表 |
| 运用项目式、探究式、场景式学习 | 3D 第一人称漫游即场景式学习环境 |
| 提供学习任务单、方法导引等学习支架,强化过程性评价 | 4.5、4.6 节任务单、数据记录表、四维评价观察表 |
| 鼓励大胆尝试、包容失败 | 3.6 节如实记录 6 次真实失败与排查过程 |
| 合理利用计算机建模、虚拟仿真实验等数智技术 | 3D 数字孪生 +--sim 模式 + 3.3 节可复现仿真实验 |
| 注重科技教育与人文教育协同 | 1.5、4.5 课时 4 的适老化讨论与"人在回路"设计 |
| 做好安全风险评估与前置防范 | 4.6 节安全风险卡,全程低压、不接市电 |
二、运行演示(必需项)
说明:本节所有图片位按 DF 创客社区《精华帖发布指南》的建议统一为横版、尺寸一致,图注用纯文字,不使用 Emoji。实物照片需补拍;3D 页面截图可直接用项目已生成的
explore-room.png等文件。
【图 1】成品实物全景 拍摄:横版 16:9,ESP32 开发板居中,传感器与 LED 呈扇形排开,旁放一台显示 3D 房间的电脑屏幕;浅色干净垫子做背景,侧前方补光,对焦在开发板。
【图 2】接线特写 拍摄:俯拍,能看清杜邦线颜色与 GPIO 丝印;建议用后期在图上加引脚标注(社区指南推荐连线图加标注)。
【图 3】"数字孪生 vs 实物"状态对照 拍摄:左右同框或上下拼图,左为 3D 吊灯点亮,右为板载 LED(GPIO2)点亮,两张照片在同一曝光下拍摄。
【图 4】动图 A:网页下发指令 8—12 秒。依次演示:点击 3D 吊灯 → 弹窗设为开启 → 实物 LED 亮 → 页面状态与日志同步刷新。
【图 5】动图 B:物理按钮回传 8—12 秒。按下 GPIO25 轻触开关 → 实物 LED 翻转 → 页面 3D 吊灯同步翻转 → 日志打印"按钮 GPIO25 → lamp_main 开"。
【图 6】动图 C:阈值规则触发 10—15 秒。演示在"自动化"面板设定"光照读数 < 900 → 开启吊灯",用手遮住光敏电阻,观察规则触发、日志打印、3D 与实物同步。
【图 7】动图 / 视频 D:第一人称漫游(选做) 15—20 秒。进入"我是小人",走到 302 门口按 E 开门、走进楼道、沿楼梯上下一层,用于展示场景式学习环境。
【视频 1】4 课时学生操作剪辑(建议 60—90 秒,配字幕或旁白) 分镜:提出问题 → 接线 → 观察日志 → 记录数据 → 改进规则 → 小组汇报。
图片与动图拍摄清单(备查):
| 编号 | 内容 | 形式 | 建议时长 / 尺寸 | 对应小节 |
|---|---|---|---|---|
| 图 1 | 成品实物全景 | 照片,横版 | 1600×900 | 2 / 4.4 |
| 图 2 | 接线特写(带引脚标注) | 照片,横版 | 1600×900 | 4.3 |
| 图 3 | 数字孪生与实物状态对照 | 拼图,横版 | 1600×900 | 1.4 / 3.2 |
| 图 4 | 网页下发指令 | GIF,横版 | 8—12 s | 4.4 步骤 5 |
| 图 5 | 物理按钮回传 | GIF,横版 | 8—12 s | 4.4 步骤 5 |
| 图 6 | 阈值规则触发 | GIF,横版 | 10—15 s | 3.3 / 3.4 |
| 图 7 | 第一人称漫游 | GIF 或视频 | 15—20 s | 1.4 / 4.5 |
| 视频 1 | 4 课时完整演示 | 视频,横版 | 60—90 s | 全文 |
三、探究过程与结果
3.1 探究设计(控制变量)
| 类别 | 内容 |
|---|---|
| 自变量 | 阈值 T(300 / 600 / 900 / 1000 / 1100 / 1200 / 1500);是否加入"连续 N 次确认"(N=1/2/3/4);是否采用滞回双阈值 |
| 因变量 | 规则触发次数、误触发次数(亮灯阶段本不该动作却动作)、漏触发(变暗阶段未动作)、首次正确响应点、理论响应延迟、结束时灯的状态 |
| 控制变量 | 完全相同的 40 点输入序列(固定随机种子 20261116)、同一条规则、2 s 采样周期、同一目标设备、同一份规则引擎逻辑 |
| 重复 | 序列确定,每组结果可完全复现;课堂建议每组独立跑 3 遍并交叉核对 |
| 工具 | 3.3 节给出的 Python 仿真脚本(逻辑与网页 evalRules() 一致),以及网页自带的通信日志与趋势图 |
输入序列设计:40 个采样点,每点间隔 2 s,共 80 s。第 1—12 点为"亮"(基线 1200 ± 90 抖动),第 13—26 点为"变暗"(基线 700 ± 90),第 27—40 点恢复"亮";在亮阶段人为插入 4 个瞬时遮挡尖峰(1020、980、1010、960),模拟有人走过光敏电阻。该序列固定随机种子,任何人运行脚本都会得到同一组数。
判定规则:读数 < T 时开启吊灯,采用网页同款上升沿触发(条件由"不满足"变为"满足"时才动作一次)。
3.2 实验 A:真实硬件链路实测
方法:在已连接 ESP32 的电脑上,用一个只读的 WebSocket 客户端连接 ws://localhost:8080/ws,只发送一条 {"type":"hello"}(固件仅回传状态、不动作),被动接收 22 秒并按消息类型计时分类。全程不发送任何 cmd,不改动任何设备状态。
实测结果(2026-11-16,本机 ESP32-DevKitC,串口 115200):
| 观测项 | 实测值 |
|---|---|
hello 发出到收到首条 state |
12.4 ms |
hello 回传的设备状态 |
7 条,覆盖 lamp_main / lamp_floor / fan / ac / tv / curtain / doorlock |
| 22 秒内传感器上报 | 4 路各 11 条,共 44 条 |
| 相邻两次上报间隔 | 2.000—2.002 s,抖动不超过 2 ms |
| DHT11 温度 | 23.2 ℃,22 秒内保持稳定 |
| PIR 人体感应 | 观测到 1 → 0 的状态变化 |
| 光照 LDR / 超声波 HC-SR04 | 读数恒为 0(见 3.6 失败记录) |
结论:2 s 采样周期稳定,链路往返约 12 ms,仅为采样周期的 0.6%,完全满足课堂上"发出指令—立刻看见反馈"的需求,也为后续把仿真结论搬到真实硬件上验证提供了前提。假设 H3 成立。
3.3 实验 B:阈值扫描与误触发统计(虚拟仿真)
把 3.1 节的固定序列逐点喂给与网页 evalRules() 完全相同的上升沿逻辑,扫描阈值 T,统计动作次数:
| 阈值 T | 亮阶段误触发 | 变暗阶段应触发 | 恢复亮阶段误触发 | 动作总数 | 首个正确响应点 | 结束时灯 |
|---|---|---|---|---|---|---|
| 300 | 0 | 0 | 0 | 0 | 无(漏触发) | 灭 |
| 600 | 0 | 0 | 0 | 0 | 无(漏触发) | 灭 |
| 900 | 0 | 1 | 0 | 1 | 第 13 点 | 亮(不会自动关) |
| 1000 | 1 | 1 | 1 | 3 | 第 13 点 | 亮 |
| 1100 | 2 | 1 | 2 | 5 | 第 13 点 | 亮 |
| 1200 | 5 | 0 | 4 | 9 | 无(过早触发后不再触发) | 亮 |
| 1500 | 1 | 0 | 0 | 1 | 无(一开始就触发) | 亮 |
三个很值得让学生自己发现的结论:
- 阈值存在"两端都不行"的区间:T ≤ 600 时永远不动作(漏触发),T ≥ 1200 时几乎全是误动作。本序列下 T = 900 是唯一既正确响应又零误触发的取值,它恰好落在"亮阶段最小值 980"与"暗阶段最大值 786"之间的空档里。
- 阈值不能靠"拍脑袋"或照抄网上的例程,必须先测出正常读数的波动带,再把阈值放到波动带之外——这就是把"控制变量"和"测量误差"落到实处的机会。
- 单条规则只会"开"不会"关":即使 T = 900 完全正确,天重新变亮后灯依然亮着。这暴露了规则式系统的结构性缺陷,直接引出实验 C 的改进。
假设 H1 成立。
3.4 实验 C:改进方案对比
改进一,连续 N 次确认(连续 N 个采样点都满足条件才认定成立),固定 T = 1100:
| 确认次数 N | 误触发 | 应触发 | 动作总数 | 首个正确响应点 | 理论响应延迟 |
|---|---|---|---|---|---|
| 1 | 4 | 1 | 5 | 第 13 点 | 0 s |
| 2 | 0 | 1 | 1 | 第 14 点 | 2 s |
| 3 | 0 | 1 | 1 | 第 15 点 | 4 s |
| 4 | 0 | 1 | 1 | 第 16 点 | 6 s |
改进二,滞回双阈值(低于 T_on 开灯、高于 T_off 关灯),T_on = 1000 / T_off = 1100:
| 方案 | 动作序列(采样点序号) | 动作总数 | 结束时灯 |
|---|---|---|---|
| 仅滞回,无确认 | 开 10、关 11、开 13、关 27、开 36、关 37 | 6 | 灭 |
| 滞回 + 连续 2 次确认 | 开 14、关 28 | 2 | 灭 |
| 滞回 + 连续 3 次确认 | 开 15、关 29 | 2 | 灭 |
结果讨论:
- 单独加滞回解决了"不会自动关",但引入了新的抖动动作(第 10/11、36/37 点),动作数反而升到 6 次。
- "滞回 + 连续 2 次确认"把动作收敛到恰好 2 次——变暗后第 2 个点开灯、恢复亮后第 2 个点关灯,误触发归零,且灯在观察结束时正确熄灭。这是本实验得到的最优方案。
- 代价是每次动作晚 1 个采样周期(2 s)。要不要多等这 2 秒,取决于场景:走廊照明可以等,安防报警不能等。这个权衡正是工程思维的落点。
- N 从 2 增加到 3、4 不再减少误触发,只是白白增加延迟,说明"越保守越好"并不成立。
假设 H2 成立,但需补充限定:改进存在收益递减,参数要按场景选。
3.5 课堂数据记录表(空白模板,供学生打印填写)
表 1:阈值扫描记录表
| 组号 | 阈值 T | 亮阶段动作次数 | 变暗阶段动作次数 | 恢复亮阶段动作次数 | 是否漏触发 | 首次正确响应点 | 结论 |
|---|---|---|---|---|---|---|---|
| 600 | |||||||
| 900 | |||||||
| 1100 | |||||||
| 1200 |
表 2:改进方案对比记录表
| 组号 | 方案 | 确认次数 N | 动作总数 | 误触发数 | 响应延迟(s) | 结束时灯 | 是否推荐 |
|---|---|---|---|---|---|---|---|
| 单规则 | 1 | ||||||
| 连续确认 | 2 | ||||||
| 滞回 | 1 | ||||||
| 滞回 + 确认 | 2 |
表 3:真实硬件验证记录表(有器材的小组填)
| 组号 | 指令 | 页面显示状态 | 实物状态 | 日志是否一致 | 往返感受 / 计时 | 备注 |
|---|---|---|---|---|---|---|
| 开吊灯 | ||||||
| 按 GPIO25 按钮 | ||||||
| 遮住光敏电阻 |
3.6 探究发现总结
- 自动控制的难点不在"能不能自动",而在"参数怎么定、误动作怎么压"。
- 上升沿触发解决的是"每帧重复下发指令",解决不了读数抖动;两者是不同层次的问题。
- 单一规则往往不完整(只会开不会关),需要成对规则或滞回。
- 任何改进都有代价,参数选择要结合具体场景和人的感受。
- 数字孪生的价值在于把"看不见的状态变化"变成可观察、可回放、可计数的对象,这正是《指南》所鼓励的计算机建模与虚拟仿真实验。
3.7 失败尝试与问题排查(如实记录)
这一节是本项目最想分享给其他老师和创客的部分,全部为开发过程中真实发生过、并已定位的问题:
| 现象 | 根因 | 解决 / 结论 |
|---|---|---|
| LDR 与 HC-SR04 读数恒为 0(3.2 节实测) | 这两路传感器在本轮接线中未接入 / 未在页面成功注册,固件默认传感器表为空,需由页面发 sensor_add 注册 |
保留 dht1、pir1 做真实硬件验证;阈值实验改用可复现的仿真序列,并在任务单中把"补齐这两路"设为拓展任务。不把 0 当成有效数据 |
| 早期文档把 HC-SR04 TRIG 写成 GPIO13 | GPIO13 已被落地灯占用,固件会拒绝冲突配置 | 统一改为 TRIG=GPIO12 / ECHO=GPIO14,并把"先查引脚占用表"写进任务单 |
| 双击启动脚本只闪一下就退出 | 中文 UTF-8(无 BOM)的 .bat 被中文 Windows 的 cmd 按 GBK 误读,整段脚本解析错乱 |
启动 / 停止脚本全部改为纯 ASCII 内容 |
| 页面显示"已连接桥接服务"却软硬件不联动 | 上一次实验的桥接进程残留并占用 8080,新服务静默启动失败,浏览器连到的是旧进程 | 启动脚本启动前自动清理 8080 残留进程、启动后自检端口;明确区分"已连接桥接服务"与"ESP32 在线"两个指示灯 |
| 点"我来操控"没反应 | 一次大段代码插入时误删了 driveKeys 声明,ReferenceError 又被渲染循环的 try/catch 静默吞掉 |
补回声明;此后除语法检查外,增加一次交互级自动化验证(语法通过不等于功能正常) |
| 第一人称漫游按 W 往后走 | Three.js 相机默认看 −Z,水平前向应为 (−sinYaw, −cosYaw),代码写反了 | 修正前向与右向向量,第三人称相机与角色朝向同步修正 |
| 楼梯被楼板盖住、下楼高度算错 | 整块楼板覆盖梯段;下行高度插值方向写反 | 楼板与天花开洞,改为上下双跑楼梯,并补实心梯梁 |
《指南》要求"鼓励学生大胆尝试,包容失败""通过不断试错、反思、改进寻求解决方案"。把失败如实写出来,比只展示成品更有教学价值。
四、软硬件清单与制作步骤
4.1 硬件清单
| 器材 | 数量 | 是否必需 | 用途 / 低成本替代 |
|---|---|---|---|
| ESP32-DevKitC(ESP32-WROOM-32E 模组) | 1 | 必需 | 主控;Arduino IDE 中选「ESP32 Dev Module」 |
| USB 数据线 | 1 | 必需 | 供电 + 串口通信,无需 WiFi、无需路由器 |
| DHT11 温湿度模块 | 1 | 建议 | 温湿度双线趋势图;也可用 DHT22 |
| 光敏电阻 + 10 kΩ 电阻 | 1 | 建议 | 阈值实验的主角;可先用 --sim 代替 |
| HC-SR505 / AM312 人体感应模块 | 1 | 建议 | PIR 0/1 输入;本项目唯一实测到状态变化的一路 |
| HC-SR04 超声波模块 | 1 | 选配 | 测距演示 |
| 轻触按钮 | 3 | 选配 | 绑定 GPIO25 / 26 / 27,验证"硬件 → 页面" |
| LED + 220 Ω 限流电阻(或 5 V 光耦继电器模块) | 按设备数 | 建议 | 教学强烈建议先用 LED + 板载 GPIO2 LED,不接市电 |
| 面包板、杜邦线 | 1 套 | 必需 | |
| 电脑(Windows / Linux / macOS 均可) | 1 | 必需 | 跑桥接服务与浏览器 |
说明:整套散件在常见电商渠道属于几十元量级,具体价格随渠道与时间波动,本文不列固定金额。最简复刻只需要一块 ESP32 和一根 USB 线——板载 GPIO2 LED 就是"客厅吊灯",其余设备用 --sim 模拟,追加成本为零。这一点是本项目在"复刻性"上最主要的设计考虑。
4.2 软件清单
| 软件 / 库 | 版本 / 说明 |
|---|---|
| Arduino IDE | 2.x;开发板包 esp32 by Espressif 3.x |
| ArduinoJson | 6.x(固件解析 JSON 行) |
| DHT sensor library | Adafruit 版(读 DHT11) |
| Python | 3.9+,依赖 aiohttp、pyserial(pip install aiohttp pyserial) |
| 浏览器 | Chrome / Edge,需联网加载 three.js r128 与 OrbitControls(CDN) |
| 页面本身 | 单文件 smart-home-3d.html,Three.js r128,无需构建工具 |
页面依赖 three.js CDN,首次打开需联网;离线课堂可提前把两个 js 文件下载到同目录并改成本地引用。
4.3 硬件连线图
【图 8】系统连线图(建议用 Fritzing 或手绘后拍成横版照片,务必标注 GPIO 编号)
默认引脚表(以 esp32_mini.ino 与页面 defaultState() 为准,两者必须一致):
输出设备(控制脚,接 LED / 继电器 IN):
| 设备 | 网页 ID | GPIO | 实体按钮 GPIO |
|---|---|---|---|
| 客厅吊灯 | lamp_main |
2(板载 LED) | 25 |
| 落地灯 | lamp_floor |
13 | 26 |
| 风扇 | fan |
5 | 27 |
| 空调 | ac |
18 | 无 |
| 电视 | tv |
19 | 无 |
| 智能门锁 | doorlock |
23 | 无 |
| 智能窗帘 | curtain |
22 | 无 |
传感器与按钮(输入):
| 器件 | 网页 ID | GPIO |
|---|---|---|
| DHT11 DATA | dht1 |
4 |
| 光敏电阻分压输出(ADC) | ldr1 |
34 |
| PIR 数字输出 | pir1 |
35 |
| HC-SR04 TRIG / ECHO | hcsr04_1 |
12 / 14 |
| 轻触按钮(按下接 GND) | — | 25 / 26 / 27 |
接线约束(这几条是固件里真实存在的校验,也是很好的教学资源):
- GPIO 34—39 只能做输入,不能作为设备控制脚。
- 控制脚必须在 1—33 之间,且不得与任何按钮脚、传感器脚、超声波触发脚、DHT 单总线脚重复。
- 每个设备有"控制脚 pin"和"实体按钮脚 btn"两个独立概念,必须不同;按钮使用
INPUT_PULLUP,按下接 GND 触发。 - 数字 / 模拟输入脚允许与按钮共用,DHT 单总线脚不允许。
- 若继电器为低电平触发(市面常见),把固件里的
RELAY_ON/RELAY_OFF两个值对调即可。
4.4 制作步骤(可照抄执行)
第一步,装环境。Arduino IDE 安装 esp32 开发板包与 ArduinoJson、DHT 两个库;电脑安装 Python 3.9+ 后执行 pip install aiohttp pyserial。
第二步,烧录固件。打开 esp32_mini/esp32_mini.ino,工具 → 开发板选「ESP32 Dev Module」,选好 COM 口,点上传。打开串口监视器(115200)应看到 ESP32 极简固件启动(双向+传感器+按钮) 与一条 boot JSON。验证完请关闭串口监视器,否则会占用 COM 口。
第三步,最小接线。先只做一件事:什么都不接,用板载 GPIO2 LED 当吊灯。确认能双向控制后,再按 4.3 的表逐个加传感器和按钮,每加一个就在页面点"+ 添加"并核对读数,避免一次性接完难以排错。
第四步,启动桥接。在项目目录执行 python bridge_serial.py(Windows 也可双击 启动桥接.bat),浏览器打开 http://localhost:8080 并点"连接"。零硬件预演改用 python bridge_serial.py --sim。
第五步,验证闭环。确认顶栏两个指示灯:**"已连接桥接服务"表示浏览器 ↔ 桥接通,"ESP32 在线"表示桥接 ↔ 串口通**,两者都亮才算全链路可用。随后做三个动作:点 3D 吊灯看 LED、按 GPIO25 按钮看页面同步、看日志里 hello 回传的 7 条 state。
第六步,配置规则。点顶栏"自动化",新建规则"光照强度 读数 < 900 → 开启客厅吊灯",用手遮住光敏电阻观察触发;再把阈值改成 1100 观察误触发,复现第 3 章实验。
通信协议(一行一条 JSON,桥接只做透明转发):
网页 → ESP32:cmd(on/off/toggle/set)、cfg(改控制脚)、btnbind(绑定按钮)、dev_add / dev_del、sensor_add / sensor_del、hello。
ESP32 → 网页:state、sensor、sensor_list、boot、log。
示例:
【图 9】系统架构与数据流图(浏览器 3D 页面 ⇄ aiohttp WebSocket ⇄ pyserial 串口 ⇄ ESP32 ⇄ 传感器/执行器)
4.5 4 课时任务单
| 课时 | 主题 | 学生活动 | 教师学习支架 | 过程性评价观测点 | 产出 |
|---|---|---|---|---|---|
| 第 1 课时 | 提出问题与认识系统 | 讨论"人走灯不灭";用 --sim 自由点 3D 房间;写下 Q1—Q3 与 H1—H3;看懂通信日志 |
现象导入卡、任务单第 1 页、术语图文卡(阈值/上升沿/误触发) | 问题意识:能否从真实情境提出可探究的问题 | 假设表、系统框图草图 |
| 第 2 课时 | 搭建与验证闭环 | 按 4.3 接线(最简版可用板载 LED)、烧录、启动桥接、完成"页面 → 硬件""硬件 → 页面"双向验证 | 接线图、引脚占用表、分步检查卡、常见故障表 | 探究实践能力:工具使用、按步骤验证、记录异常 | 表 3 真实硬件验证记录表 |
| 第 3 课时 | 控制变量实验 | 固定序列,逐组扫描阈值;填写表 1;再试连续确认与滞回,填写表 2;画动作次数—阈值草图 | 数据记录表、仿真脚本、控制变量提示卡、"只改一个量"提醒 | 探究实践能力与反思改进能力:控制变量、证据意识、解释异常 | 表 1、表 2、结论三条 |
| 第 4 课时 | 改进、交流与伦理讨论 | 把最优参数写回网页规则并在实物上验证;小组讨论"若家中有老人夜间起身,误关灯会怎样""要不要保留手动覆盖""传感器采集的边界";小组汇报 | 汇报模板、适老化情境卡、四维评价观察表 | 反思改进能力、合作交流能力:质疑与回应、分工与分享 | 改进后规则截图、汇报、自评互评表 |
第 4 课时的伦理讨论不是附加题:《指南》明确要求"注重科技教育与人文教育协同",人工智能主题也要求"了解人工智能带来的伦理与安全挑战,掌握安全规范使用人工智能的手段和方法"。让学生意识到"最自动的方案不一定是最好的人的方案",是本案例的育人落点。
4.6 安全风险卡与过程性评价观察表
安全风险卡(课前必须由教师逐条确认):
- 全程使用 USB 5 V / 板子 3.3 V 低压,严禁接入 220 V 市电、灯具或家电;继电器模块仅作演示,输出端不接任何负载。
- 接线、改线、插拔杜邦线前先拔掉 USB 线;确认无短路再上电。
- GPIO 输出串 220 Ω 限流电阻再接 LED;不要把一个 GPIO 同时接两路。
- 传感器远离水源;桌面保持整洁,导线不跨越键盘与电源。
- 首次上电由教师检查;出现发热、异味立即断电。
- 使用
--sim的课堂同样要讲清"仿真与真实硬件的差别",不能把仿真结论直接当成工程结论。
过程性评价观察表(四维,按 1—4 级记录,纪实性描述,不打分排名):
| 维度 | 观测点(举例) | 记录方式 |
|---|---|---|
| 问题意识 | 能否自主提出可探究的问题、能否把"灯老亮着"转成"阈值与误触发的关系" | 课堂观察 + 假设表 |
| 探究实践能力 | 是否坚持只改变一个变量、是否如实记录异常数据、能否用日志和趋势图作证据 | 数据记录表 + 操作观察 |
| 反思改进能力 | 能否解释 T=1200 为何全是误动作、能否主动提出并验证改进方案 | 结论三条 + 汇报问答 |
| 合作交流能力 | 分工是否明确、能否倾听并有理有据地质疑同伴结论 | 小组汇报 + 自评互评 |
五、开源代码
5.1 文件结构与协议
项目共三个核心源文件,加上启动脚本:
| 文件 | 作用 |
|---|---|
esp32_mini/esp32_mini.ino |
ESP32 固件:设备表、引脚冲突检测、按钮去抖、传感器采集、JSON 行协议 |
bridge_serial.py |
电脑端桥接:aiohttp 提供 HTTP + WebSocket,pyserial 读写串口,含 --sim 假 ESP32 |
smart-home-3d.html |
单文件 3D 控制台:Three.js 场景、设备/传感器面板、趋势图、规则引擎、第一人称漫游 |
启动桥接.bat/停止桥接.bat |
Windows 一键启动 / 停止(纯 ASCII,含 8080 残留进程清理与端口自检) |
README.md |
完整接线表、烧录步骤、协议说明与常见问题 |
threshold_lab.py |
第 3 章阈值探究仿真脚本;把 5.2 节第 (4) 段代码另存为该文件即可作为附件上传 |
【图 10】固件核心代码截图:setup() / loop() 与 2 s 采样、200 ms 按钮去抖 【图 11】固件核心代码截图:cfg 分支的六类引脚冲突检测 【图 12】网页核心代码截图:evalRules() 上升沿触发与 applyRuleAction()【图 13】桥接核心代码截图:serial_reader() 与 ws_handler() 的透明转发 【图 14】网页核心代码截图:handleMsg() 中 state / sensor 的状态同步
截图建议:直接用编辑器打开对应文件、字号调大、截取 20—30 行,四张图统一宽度,避免整屏截小字看不清。
5.2 关键代码精讲
(1)规则的上升沿触发——解决"条件持续成立时每帧重复下发指令":
第 3 章的实验表明:上升沿只解决重复下发,不解决读数抖动;抖动要靠连续确认或滞回,两者不能互相替代。
(2)六类引脚冲突检测——把"硬件约束"变成可讨论的工程问题:
(3)按钮去抖与传感器周期采样——200 ms 去抖、2 s 上报,是 3.2 节实测间隔的来源:
(4)阈值探究仿真脚本(核心逻辑完整可运行,固定随机种子;按此逻辑统计即得 3.3 / 3.4 各表):
5.3 完整源程序附件清单
- 附件 1:
esp32_mini.ino - 附件 2:
bridge_serial.py - 附件 3:
smart-home-3d.html - 附件 4:
启动桥接.bat、停止桥接.bat - 附件 5:
threshold_lab.py(把本文 5.2 节第 (4) 段代码另存为该文件,即第 3 章仿真脚本) - 附件 6:
README.md - 附件 7:4 课时任务单、数据记录表、评价观察表(本文 3.5 / 4.5 / 4.6 可直接复制打印)
代码建议以 MIT 协议开源,文档与任务单建议以 CC BY 4.0 发布;第三方库(three.js、ArduinoJson、DHT sensor library、aiohttp、pyserial)各自遵循其原有协议,引用处见第八节。
六、优化记录与功能拓展
版本演进(体现"制作—测试—改进"的真实过程):
| 阶段 | 改动 | 为什么改 |
|---|---|---|
| v1 | WiFi + TCP 桥接(esp32_smart_home.ino+bridge_server.py) |
最初想做局域网多端访问 |
| v2 | 增加纯串口方案(esp32_smart_home_serial.ino) |
教室 / 比赛现场没有路由器,WiFi 不稳定 |
| v3 | 极简串口版(esp32_mini.ino) |
去掉 PWM 调光等复杂部分,只保留开关两态;按设备类型区分"开"的视觉(灯亮、门开、窗帘拉开),降低门槛 |
| v4 | 条件自动化规则、温湿度双线趋势图、传感器增删、PIR 联动、3D 小人 | 从"能控制"走向"能探究",为控制变量实验提供数据工具 |
| v5 | 住宅楼语境与第一人称漫游、模拟模式加固、启动脚本自检 | 引入场景式学习环境,让"谁在屋里触发传感器"变得可观察;同时提升复刻成功率 |
可拓展方向(供其他班级二次创作):
- 用照度计校准光敏电阻,把 ADC 原始值换算成 lx,让阈值有物理单位。
- 汇总全班各组的数据,讨论"同一阈值在不同小组为何结论不同"(光照环境差异),引出误差与重复性。
- 把"连续确认 / 滞回"做成网页上的可选参数,让学生不改代码就能复现实验 C。
- 接入 MQTT 或校园物联网平台,讨论数据上云后的隐私与权限。
- 结合语音助手或图像识别,对比"规则式"与"数据驱动式"智能的差别,落实人工智能主题的规范使用讨论。
- 适老化情境包:加入夜灯、缓亮、"人在回路"手动覆盖按钮,讨论技术如何照顾真实的人。
- 智慧社区:把 6 层 12 户的楼道模型扩展成多户能耗对比与公共照明策略探究。
七、注意事项(复刻提示)
- 启动桥接前务必关闭 Arduino 的串口监视器,同一个 COM 口不能被两个程序同时打开。
- 若页面显示"已连接桥接服务"但硬件无反应,先看"ESP32 在线"指示灯,并确认没有旧的桥接进程占用 8080;
启动桥接.bat已内置清理与端口自检。 - Windows 下的
.bat必须是纯 ASCII 内容,含中文的 UTF-8 脚本会被 cmd 按 GBK 误读而闪退。 - 页面首次打开需要联网加载 three.js CDN;离线环境请提前把两个 js 文件放到本地并改为相对路径。
- 页面配置保存在浏览器 localStorage,换电脑或换浏览器不会同步;课堂批量部署前可先"恢复默认"。
- 低电平触发的继电器要把
RELAY_ON/RELAY_OFF对调。 - 社区编辑器不支持 Emoji,长文建议先在本地写好再粘贴,避免断网丢稿;图片统一横版尺寸。
八、参考资料与来源
- 教育部办公厅:《义务教育阶段科学教育"做中学"领航行动指南》(教监管厅〔2026〕1 号,2026 年 7 月 29 日),教育部政府门户网站,http://www.moe.gov.cn/srcsite/A29/202608/t20260803_1445982.html
- 教育部:"教育部部署开展义务教育阶段科学教育'做中学'领航行动",https://www.moe.gov.cn/jyb_xwfb/gzdt_gzdt/s5987/202608/t20260804_1446039.html
- DF 创客社区:"做中学·探未来 | 科学教育实践案例征集活动",https://mc.dfrobot.com.cn/contest-3591.html
- DF 创客社区:木子哦《如何在 DF 创客社区发布一篇【精华】文章》,https://mc.dfrobot.com.cn/article-380701.html
- three.js r128(MIT),https://threejs.org/ ;OrbitControls 示例同版本
- ArduinoJson 6.x(MIT),https://arduinojson.org/ ;Adafruit DHT sensor library;aiohttp、pyserial 均按其各自开源协议使用
- 本文所有代码、3D 场景、图表、任务单与插图说明均为本项目原创;第 3 章仿真数据由本文 5.2 节所列逻辑在固定随机种子 20261116 下生成,可完全复现;3.2 节为 2026-11-16 本机真实硬件实测记录。文中未使用任何外站图片。



