自动规则的阈值该定多少?——用 ESP32 智能家居数字孪生做一次控制变量实验(4 课时 )

2026-11-165

ai 作品_哔哩哔哩_bilibili

摘要

这是一份面向 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 无(一开始就触发) 亮

三个很值得让学生自己发现的结论:

  1. 阈值存在"两端都不行"的区间:T ≤ 600 时永远不动作(漏触发),T ≥ 1200 时几乎全是误动作。本序列下 T = 900 是唯一既正确响应又零误触发的取值,它恰好落在"亮阶段最小值 980"与"暗阶段最大值 786"之间的空档里。
  2. 阈值不能靠"拍脑袋"或照抄网上的例程,必须先测出正常读数的波动带,再把阈值放到波动带之外——这就是把"控制变量"和"测量误差"落到实处的机会。
  3. 单条规则只会"开"不会"关":即使 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,长文建议先在本地写好再粘贴,避免断网丢稿;图片统一横版尺寸。

八、参考资料与来源

  1. 教育部办公厅:《义务教育阶段科学教育"做中学"领航行动指南》(教监管厅〔2026〕1 号,2026 年 7 月 29 日),教育部政府门户网站,http://www.moe.gov.cn/srcsite/A29/202608/t20260803_1445982.html
  2. 教育部:"教育部部署开展义务教育阶段科学教育'做中学'领航行动",https://www.moe.gov.cn/jyb_xwfb/gzdt_gzdt/s5987/202608/t20260804_1446039.html
  3. DF 创客社区:"做中学·探未来 | 科学教育实践案例征集活动",https://mc.dfrobot.com.cn/contest-3591.html
  4. DF 创客社区:木子哦《如何在 DF 创客社区发布一篇【精华】文章》,https://mc.dfrobot.com.cn/article-380701.html
  5. three.js r128(MIT),https://threejs.org/ ;OrbitControls 示例同版本
  6. ArduinoJson 6.x(MIT),https://arduinojson.org/ ;Adafruit DHT sensor library;aiohttp、pyserial 均按其各自开源协议使用
  7. 本文所有代码、3D 场景、图表、任务单与插图说明均为本项目原创;第 3 章仿真数据由本文 5.2 节所列逻辑在固定随机种子 20261116 下生成,可完全复现;3.2 节为 2026-11-16 本机真实硬件实测记录。文中未使用任何外站图片。

硬件清单

创作许可协议

本项目采用 CC BY(署名) 进行许可。

所需材料/产品

加载全部

    Gravity: 数字继电器模块 - 10A大电流(兼容Arduino)

    Gravity: 数字继电器模块 - 10A大电流(兼容Arduino)

    Gravity: 数字继电器模块 - 10A大电流(兼容Arduino)

    Gravity: DHT11温湿度传感器(Arduino兼容)

    Gravity: DHT11温湿度传感器(Arduino兼容)

    Gravity: DHT11温湿度传感器(Arduino兼容)

    Gravity: ADKeyboard模拟按键模块

    Gravity: ADKeyboard模拟按键模块

    Gravity: ADKeyboard模拟按键模块

相关推荐

评论(0)
- 没有更多了 -

创作许可协议

本项目采用 CC BY(署名) 进行许可。

相关推荐

所需材料/产品

Gravity: 数字继电器模块 - 10A大电流(兼容Arduino)

Gravity: 数字继电器模块 - 10A大电流(兼容Arduino)

Gravity: 数字继电器模块 - 10A大电流(兼容Arduino)

Gravity: DHT11温湿度传感器(Arduino兼容)

Gravity: DHT11温湿度传感器(Arduino兼容)

Gravity: DHT11温湿度传感器(Arduino兼容)

Gravity: ADKeyboard模拟按键模块

Gravity: ADKeyboard模拟按键模块

Gravity: ADKeyboard模拟按键模块

加载全部