Home - hongligongsi/Consumables-storage-temperature-and-humidity GitHub Wiki
智能耗材仓 · Wiki
ESP32-S3 N16R8 3D 打印耗材干燥 / 恒温仓控制器。Arduino 框架 + PlatformIO。
文档
| 页面 | 内容 |
|---|---|
| 硬件接线与注意事项 | 引脚映射、传感器接线、触摸模式、上电前必须复核的 6 项 |
| 硬件验收流程 | 12 项待验证项的逐项验收流程：工具 / 步骤 / 判据 / 不通过改哪一行 |
| 编译烧录与预编译固件 | 编译、烧录、预编译固件与台账、分区表偏移、OTA |
| 联网功能 | WiFi 配网、REST API、MQTT 主题、NTP、OTA |
| 系统设置逐项说明 | 设置页 32 项逐条说明与取值范围 |
| 故障码与网络告警 | F-01…F-06 故障码、W-01…W-04 网络告警、NVS 故障记忆 |
快速开始
git clone https://github.com/hongligongsi/Consumables-storage-temperature-and-humidity.git
cd Consumables-storage-temperature-and-humidity
pio run -t upload
pio device monitor -b 115200
首次上电若无 WiFi 凭据，设备会开出 FilamentChamber-Setup 热点，手机连上后配网。
未注册的设备会先弹「注册码」页，提示但不限制，长按编码器即可跳过。
源码
- 仓库：https://github.com/hongligongsi/Consumables-storage-temperature-and-humidity
- 引脚定义集中在 include/pins.h，修改硬件版本只需改这一个文件
- 开发文档入口：docs/development.md（纯逻辑分层、主机端单测、CI 与工具脚本）
界面
tools/ui_preview.html 是可操作的真机模拟器，浏览器直接打开即可，渲染与操作逻辑和固件一致：
python -m http.server 8765 --directory tools
访问 http://localhost:8765/ui_preview.html ，用屏下的 EC11 旋钮像真机一样操作。
它还可直接定位到某个页面：#material 耗材设置、#system 系统设置（#system=27
定位到第 27 项）、#calib 触摸校准、#reg 注册码、#fault 故障页。
另有 tools/regcode_generator.html：离线生成 / 反查设备注册码的独立小工具。
故障与告警速查
两条通道互不相干：F 码会停机锁状态机，W 码只提示不停机。
| 码 | 含义 | 说明 |
|---|---|---|
| F-01 / F-02 / F-06 | 仓温 / 热板 NTC / 电流采样掉线 | 仅自动温控开启且在预热/打印时检测，连续 3 s |
| F-03 / F-04 / F-05 | 热板硬过温 / 仓温硬超上限 / 回路硬过流 | 任何状态都生效，超硬保护余量持续 0.5 s 锁定 |
| W-01 / W-02 | WiFi 认证失败 / 找不到 AP | 连续 10 次同类失败才提示，约 1~2 分钟 |
| W-03 / W-04 | MQTT 认证失败 / 连接超时 | 连续 10 次（约 50 s）才提示 |
详见 故障码与网络告警。