# CatFeeder

**Repository Path**: jimonik/cat-feeder

## Basic Information

- **Project Name**: CatFeeder
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-10-08
- **Last Updated**: 2026-10-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 猫咪喂食机

本仓库保存猫咪自动喂食机的机械结构、控制器 PCB、原理图、Go 后端、物料表与嘉立创生产文件。

## 目录

- `mechanical/喂猫_机械结构.FCStd`：FreeCAD 机械结构源文件；各部件可在模型树中独立隐藏。
- `electronics/source/喂猫_pcb.brd`：Fusion/EAGLE 最终 PCB 源文件。
- `electronics/source/喂猫_原理图.sch`：Fusion/EAGLE 原理图源文件。
- `electronics/BOM.csv`：样机物料表。
- `backend/`：设备注册、遥测和投粮任务队列的 Go 后端。
- `manufacturing/CatFeeder_JLCPCB_UPLOAD.zip`：由最新权威 PCB 在线生成的 48 × 42 mm 制造包。
- `electronics/3d/喂猫_pcb_Fusion3D.f3d`：Fusion 在线生成并装入乐鑫官方模组的可编辑三维 PCB。
- `electronics/3d/喂猫_pcb_3d.step`：可离线查看的整板 3D STEP；ESP32 使用乐鑫官方模型，其余高件为明确标注的空间包络。
- `manufacturing/3d-print/CatFeeder_JLC3DP_PROTOTYPE_PARTS.zip`：9 个已校验的嘉立创 3D 打印样机候选件；不含尚待定型的驱动模块，不能当作完整整机生产包。
- `manufacturing/gerber/`：与上传 ZIP 对应的展开版最终 Gerber/Excellon，便于逐层审查和迁移。
- `verification/manufacturing/`：最新制造包的钻孔统计等核验记录。
- `docs/嘉立创下单指南.md`：打板参数、预览检查及样机上电步骤。
- `docs/最终设计复核.md`：设计复核与样机阶段注意事项。
- `docs/投粮控制与标定规范.md`：100 g 净增量称重、单格索引、防卡与配网按钮逻辑。
- `docs/开发环境与迁移.md`：新电脑软件、MCP 配置、迁移及文件保留说明。
- `.codex/skills/cat-feeder-continuation/`：供后续 AI agent 继续设计和验证的项目 skill。
- `AGENTS.md`：要求进入仓库的 agent 加载项目 skill。

## 权威设计文件

- FreeCAD：`mechanical/喂猫_机械结构.FCStd`，只用于机械结构。
- Fusion Electronics：`electronics/source/喂猫_pcb.brd` 和 `electronics/source/喂猫_原理图.sch`，只用于电路板与原理图。
- 嘉立创下单：`manufacturing/CatFeeder_JLCPCB_UPLOAD.zip` 已由最新 `.brd` 在线重新生成；下单前仍应在嘉立创预览器逐层确认。

## 关键规格

- 主板：48 mm × 42 mm，双层，1.6 mm FR-4。
- 安装孔：4 × Ø3.2 mm；孔中心距 42 mm × 36 mm。
- 主控：ESP32-C3-MINI-1-N4X（4 MB Flash）直接贴装 Wi-Fi/BLE 模组，不使用开发板。
- 电机驱动：DRV8833 可拔插模块。
- 称重：可插拔 HX711 模块；四线称重传感器直接接 HX711，减少主板冗余接口。
- 供电：独立 Type-C 面板小板，通过锁扣线束向主板提供 5 V。
- 维护：PCB 抽拉托盘、M3 支柱、可拆线束、可更换驱动/称重模块和六针下载维护口。
- 机械：低重心矮宽粮仓、六格横轴气锁计量轮、六槽槽轮单格索引、可逆两线减速电机、柔性防卡刮片和 58 × 26 mm 一体曲面承重粮道；粮食沿连续下坡粮道自由落入用户自备碗，三点夹具适配 Ø108–150 mm 常见圆碗。
- 电子仓：集成在底座内，不再使用粮桶后方的外凸方盒；独立 Type-C 面板小板位于机身后下方。
- 称重：5 kg 条形传感器与打印托架分离，投粮前记录基准、按净增重量闭环；空碗可去皮，有余粮时不误清零。
- 碗托：顶面距地约 13.5 mm；外缘六个局部悬空支脚距地 1 mm，正常称重时不接触地面，只在过载或严重偏斜时限位，避免绕过传感器且减少用料。
- 索引与配网：J5 改作霍尔索引接口；面板配网按钮复用 J7 的 BOOT 与 GND，运行时长按进入配网模式。

## 嘉立创下单

`manufacturing/CatFeeder_JLCPCB_UPLOAD.zip` 已于 2026-10-09 从最新 PCB 在线导出，包含 2 层 Gerber、阻焊、丝印、钢网、板框、钻孔和贴片坐标。上传后仍须确认 48 × 42 mm 外形、四个 Ø3.2 mm 安装孔及各层方向无误。

当前机械 ZIP 仅用于 9 个独立结构件的报价与装配样机；驱动模块需在电机、轴承、密封和离合硬件定型后补齐。整机完成实物验证并确认定稿前，不得把该样机包当作完整生产包。

`manufacturing/gerber/`、`verification/` 用于审查和复核；设计修改仍以 `electronics/source/` 与 `mechanical/` 中的权威源文件为准。过期的 KiCad 转换板、旧截图和旧报告不再保留，避免与最新 Fusion/EAGLE 源混用。