摘要
Simple-automatic-feeder-based-on-ESP8266 是一个把嵌入式控制和机械结构结合起来的宠物喂食器原型。ESP8266 连接 Wi‑Fi 后运行轻量 Web 控制接口，通过 PWM 驱动两路舵机，并在 OLED 上显示设备地址和动作状态。仓库同时提供 SketchUp 与 STL 模型，以及实物演示视频。
项目背景
自动喂食器并不只是“让舵机转一下”。一个能展示完整思路的原型需要结构设计、执行机构、联网控制、状态反馈和操作界面。这个项目把这些部分放进同一个仓库，适合用来理解从 3D 模型到设备代码再到浏览器控制的协作关系。
核心功能
- ESP8266 连接本地 Wi‑Fi 并显示设备 IP。
- 使用 PWM 控制两路舵机的不同方向动作。
- SSD1306 OLED 显示就绪状态与最近操作。
- 嵌入式 HTTP 接口接收网页控制命令。
- 控制接口要求令牌，避免局域网内任意访问。
- 网页允许填写设备地址与令牌，并只保存在当前浏览器会话。
- 提供底座、盖板和转轮的 SketchUp/STL 文件及演示视频。
技术架构与技术栈
设备端使用 MicroPython，核心模块包括 network、usocket、ure、machine.PWM 与 ssd1306。ESP8266 既负责执行舵机动作，也运行一个小型 HTTP 服务。网页使用原生 JavaScript 的 Fetch API 调用设备接口，界面样式由 Bootstrap 提供。
结构部分使用 SketchUp 建模并导出 STL，可通过 3D 打印制作外壳。安全更新后，Wi‑Fi 信息和控制令牌放在设备本地配置文件中，不再写进公开源码。
项目亮点
相比只包含一段舵机代码的实验，这个仓库同时提供了可打印结构件、网页控制端和实物演示，因此更接近一个可复刻的智能硬件原型。新增的配置模板和控制令牌也让公开分享更安全。
使用与部署
将 ESP8266/config.example.py 复制为设备本地的 config.py，填写自己的 Wi‑Fi 与随机控制令牌；随后把配置、主程序和所需显示驱动上传到 ESP8266。设备启动后会在 OLED 和串口输出 IP 地址。
打开仓库中的控制网页，填写设备地址与相同令牌，即可发送四种舵机动作。实际装配前应根据舵机型号校准 PWM 占空比、机械限位和转轮角度，避免卡死或持续堵转。当前项目是局域网原型，远程使用时不应直接把设备 80 端口暴露到公网。
适用场景
- 宠物自动喂食器原型。
- ESP8266 Web 控制与 PWM 舵机学习。
- 嵌入式、网页与 3D 打印综合实践。
- 继续扩展定时喂食、称重反馈和剩余粮提醒。
项目地址
GitHub：https://github.com/hemo528/Simple-automatic-feeder-based-on-ESP8266