【C1-P02开发板】赋予机器“感知”：AHT20 温湿度传感器极速上手
本案例基于C1-P02开发板和ATH20模块实现了环境温湿度数据的采集，不讲解复杂深奥的I2C协议，带你使用QuecPython提供的接口快速为自己的开发板添加“感知”功能。
- AHT20 温湿度传感器极速上手
效果预览：数据是会“呼吸”的
清点你的“感官”装备
注意：细节决定成败，很多“故障”其实源于装备不匹配。
核心硬件
软件军火库
表中软件可在QuecPython官方下载专区获取，严禁混用型号。
| 名称 | 作用 | 注意事项 |
| QuecPython 驱动 | 建立电脑与板子的通信桥梁 | 型号必须严格匹配开发板搭载的模组型号。 |
| QuecPython 固件 | 开发板运行代码的环境 | 尾缀必须一致。例如模组型号含 `CNLE`，固件也必须选 `...CNLE` 版本。 |
| QPYcom 工具 | 代码烧录与调试终端 | 官方集成开发环境，无需额外配置。 |
中文路径陷阱：解压固件和代码的文件夹路径中，绝对不能包含任何中文字符或空格！
❌ 错误示范：D:\我的下载\新建文件夹\firmware
✅ 正确示范：D:\dev\firmware
神经连接 (硬件接线)
| 颜色建议 | C1-P02 开发板引脚 | ||
|---|---|---|---|
| 🔴 红色 | 3V3 | ||
| ⚫ 黑色 | GND | ||
| SCL | 🔵 蓝色 | SCL (或 GPIO 对应引脚) | 时钟信号线 |
| SDA | 🟡 黄色 | SDA (或 GPIO 对应引脚) | 数据信号线 |
注入灵魂 (软件部署)
1. 烧录系统固件
- 用 USB 线连接开发板与电脑。
- 打开 QPYcom 工具。
- 在右上角端口列表中，寻找名为 REAL PORT或 NEMA PORT的 COM 口。若找不到：请重新安装驱动（记得用管理员权限），或更换 USB 接口/数据线。
- 点击 "Download Firmware" (烧录固件)，选择你下载好的模组专用固件。
- 等待进度条跑满，弹出success窗口即表示烧录成功。
2. 运行感知代码
- 在 QPYcom 左侧文件栏，找到示例代码文件 (aht20_demo.py)。
- (可选) 如果你想修改数据刷新频率，可以用vscode打开代码，调整 sleep_ms() 中的数值。
- 将代码文件拖拽至开发板的 usr 目录中。
- 右键点击 该文件，选择 "Run" (运行)。
正常现象：你会看到类似以下的数据流不断滚动刷新：
互动测试：
1. 哈气测试：对着 AHT20 传感器轻轻哈一口气。预期结果：湿度数值 (RH) 应该会迅速飙升，随后缓慢回落。
2. 体温测试：用手指紧紧捏住传感器头部约 10 秒。预期结果：温度数值 (Temp) 应该会逐渐上升，接近你的体温。
创意延伸：接下来玩什么？
既然已经能读取温湿度，下一步就是让这些数据产生价值。这里有几个灵感供你参考：
智能温控风扇
逻辑：当温度 > 30°C 时，自动触发 GPIO 开启风扇；低于 25°C 自动关闭。
衣物干燥提醒器
逻辑：监测室内湿度，当湿度连续 1 小时 > 70% 时，通过短信/微信推送提醒：“太潮湿了，小心衣服发霉！”
微型气象站
逻辑：将采集到的数据上传到云端可视化平台，在手机 APP 上远程查看家里的环境曲线。
想要更多灵感？
我们的 GitHub 创客仓库 里已经开源了上述案例的完整代码。别再造轮子了，站在巨人的肩膀上直接起飞！
👉 点击访问 QuecPython 开源案例库
喜欢这篇指南？觉得 AHT20 很有趣？别忘了去 GitHub 给项目点个 Star ⭐️，你的支持是我们更新更多好玩教程的动力！
