Smart apo common revA2

Smart Apo · 智能阿波与智能水中

想让浮漂自己记笔记，顺便查清是谁在拽鱼线。 方案是水面阿波和钩侧水中件各记录一份数据，回收后对时分析。鱼还没参与测试，预算已经先替项目按了暂停键。

[!NOTE] 项目状态：暂停。 完整方案的预计试制成本超出当前预算。仓库保留研究过程与可审查的工程文件；暂停不等于技术验证通过。

[!IMPORTANT] 制造状态：NOT_FAB_RELEASED。 Rev.A2 的 KiCad ERC 为 0 错误、0 警告，DRC 为 0 错误、0 未连接，仍有 3 项连接区 courtyard 警告。没有放行的生产 Gerber、钻孔和最终 BOM/CPL，也没有首件装配或水域实测。DRC 很能检查铜线，但不会替你拧紧 O 形圈。

先看钓组

概念示意，不按比例。鱼在饵旁边，没有被画成“已咬钩”的成功案例；线长、结节、配重和安全绳位置仍需实物确认。

“共板”是同一 PCB 设计、两块独立设备、两套贴装清单。它们计划各自记录，回收后导出；水里不靠实时无线链路传数据。上表描述的是设计功能，尚无装配样机证明这些功能在水里运行。

波浪很会演，鱼却不一定配合

浮漂动了，原因可能是浪、流、提竿动作，也可能是钩侧发生了机械事件。这个项目希望用水中张力作研究阶段的辅助标签，寻找阿波的 IMU 与压力信号里可重复的特征，而不是只赌一个瞬时阈值。

flowchart LR
    A["阿波原始记录<br/>运动 · 压力"] -->|回收导出| H["主机工具<br/>校验 · 对时 · 评价"]
    U["水中原始记录<br/>张力 · 运动 · 压力"] -->|回收导出| H
    H --> P["候选检测参数"]
    P --> V["下一独立航次再验证"]

这条链路是研究方案，不是已经跑通的产品流程。尤其要说清楚：张力变化说明钩侧受了力，不自动证明有鱼咬钩。 摄像、提竿或捕获结果仍需作为语义真值。现场验证计划记录了拟进行的台架、水槽和真实海况测试。

尺寸和材料：设计目标，不是合格证

位号、数量与 DNP 差异请看 Rev.A2 工作 BOM和装配变体表。采购后缀与来料尚未全部确认，工作 BOM 不能直接当最终贴片清单。

进度条不如证据可靠

三处警告只是最显眼的剩余提示；更大的缺口在采购、装配和实物。详细情况见 Rev.A2 交付门槛与暂停检查点。历史检查点中的数字属于当时版本，别把不同日期的报告拼成一块“全绿”的板。

[!CAUTION] hardware/revA2/smart_apo_common_revA2.kicad_pcb 是设计候选版；hardware/ 根目录里早期的 *_NETS_PLACED.kicad_pcb 只是布局参考。仓库里没有可直接付款投产的制造包。

如果你想复现数字检查

在仓库根目录运行。Python 测试使用宿主机 C 编译器验证模型和协议，不能替代板上测试。

python3 -m unittest discover -s firmware/host/tests -v
python3 -m unittest discover -s firmware/mcu/tests -v
python3 -m unittest discover -s tools/tests -v
python3 tools/validate_revA2.py

2026-09-24 公开提交前，三组测试分别有 34、8、17 项通过，结构检查也通过；最新 UART 航次头尚缺完整端到端用例。若有 KiCad 10，可用仅检查模式刷新 ERC/DRC 报告：

KICAD_CLI=/path/to/kicad-cli bash tools/export_fab_revA2.sh --check-only

--check-only 会更新工程中的检查报告，不生成制造文件。返回 0 只说明脚本规定的电气门禁通过，不替三处警告、采购、3D 和实物验证签字。无参数调用会进入制造导出流程，当前项目不应将其结果视作放行。

安装了 NumPy、SciPy 后，还可以用合成数据熟悉离线工具：

python3 firmware/host/generate_synthetic_dataset.py
python3 firmware/host/autotune.py \
  firmware/host/example_data/awa.csv \
  firmware/host/example_data/underwater.csv \
  -o /tmp/smart-apo-synthetic-result.json

这个例子主要验证管线能否处理规定格式，不负责替鱼提供表演。真实数据的字段、缺测规则、时钟回绕与梁标定要求见 主机说明和数据协议。

仓库地图

hardware/revA2/       当前原理图、PCB、项目库、工作 BOM、正式检查结果
hardware/*revA1*      Rev.A1 历史文件；旧板不能投产
firmware/mcu/         STM32 固件、宿主模型与构建说明
firmware/host/        解码、输入校验、评分和离线寻参
mechanical/           Rev.A1 壳体/托架、316L 梁图纸与装配说明
tools/                生成器、结构检查、BOM 检查、制造导出门禁
validation/           现场试验方案与 Rev.A1 验证记录
CONTEXT_HANDOFF.md    历史决策与交接资料

公开仓库保存源码、工程文件和正式检查结果。本机逐轮候选板、回退快照、编译日志及不完整 3D 审查包没有推送到 GitHub；旧文档提及这些目录时，请以仓库实际文件为准。

如果哪天预算松口

先补齐 UART 航次头的端到端测试和最终固件链接；再确认电芯、CT05、LED、晶振、MLCC、Pogo 与板厂工艺，关闭连接区警告；随后核对 Rev.A2 壳体/压力口/电池的实物干涉。完成制造文件独立审阅后，才轮到首件、梁标定、压力、盐水和水域试验。PCB 放行清单给出了更细的关口。

当前结论仍是：项目因成本超预算而暂停，Rev.A2 未制造放行。 鱼可以晚点上钩，工程结论不能抢跑。

复用与交流

欢迎通过 Issue 指出具体器件、KiCad 位置或可重复的测试问题。仓库中由项目作者原创的代码、设计文件、文档与插图按 WTFPL Version 2 发布（SPDX：WTFPL）。引用或改作自第三方的器件资料、库内容等仍受其原有权利约束；本仓库的许可证不能替第三方授权。许可证也不等于产品安全或制造放行证明。