Skip to content

feat(calibration): 设备存的鱼眼标定等于参考内参时告警 - #43

Merged
Vertax42 merged 3 commits into
mainfrom
feat/warn-reference-fisheye-cal
Nov 20, 2026
Merged

Vertax42 merged 3 commits into
mainfrom
feat/warn-reference-fisheye-cal

Conversation

@Vertax42

Copy link
Copy Markdown
Collaborator

背景

主爪 TCGU01A28Z0096m 存的 8 个鱼眼参数与 SDK 参考内参 FISHEYE_FALLBACK_CAL 逐位相同:产线写入了参考值而没有标定这台机器,读回时它看起来就是本机记录。用户决定 SDK 读取时告警、产线测试工具判失败(后者由工具会话做)。

改动

  • matches_fisheye_fallback_cal(cal)(C++ / Python):8 个参数都在参考值 1e-3 以内即判为参考值(焦距与主点按相对值),文本截断的副本也能识别。
  • ResolvedFisheyeCal.matches_reference:用了本机记录且它就是参考值时置位并告警;is_reference 语义不变。
  • write_fisheye() / write_fisheye_sized() 写入参考值时告警(不拒绝)。
  • read_intrinsics.py 输出 matches_reference,--require-device 拒绝;fisheye_cal.py show 标出。文档(CALIBRATION / USAGE / USAGE-zh)与 CHANGELOG [Unreleased]。顺手修正 USAGE.md 里重复的 "Firmware firmware"。

验证

  • C++ 664 passed(新增 FisheyeReferenceMatch 4);pytest 175 passed / 2 skipped;ruff 通过。
  • 实机(固件 1.3.1,只读):0096m matches_reference=True 并告警;0095m(本机标定)不置位。

🤖 Generated with Claude Code

Vertax42 and others added 3 commits November 20, 2026 15:56
主爪 TCGU01A28Z0096m 的 flash 里 8 个鱼眼参数与 FISHEYE_FALLBACK_CAL 逐位相同:产线
写入了参考值而没有标定这台机器,而读回时它看起来就是本机记录,无从分辨。

- matches_fisheye_fallback_cal(cal)(C++ / Python):8 个参数都在参考值 1e-3 以内
  (焦距与主点按相对值)即判为参考值,经文本打印再解析的副本也能识别;真实标定的主点
  在装配间就会差几个像素,不可能 8 个都这么近。
- ResolvedFisheyeCal.matches_reference:resolve_fisheye() / resolve_fisheye_for() 用了
  本机记录且它就是参考值时置位并打警告;is_reference 仍表示"SDK 代用了参考值"。
- write_fisheye() / write_fisheye_sized() 写入参考值时打警告(允许,不拒绝)。
- read_intrinsics.py 输出 matches_reference,--require-device 拒绝这种机器;
  fisheye_cal.py show 标出。

实机(固件 1.3.1,只读):0096m matches_reference=True 并告警;0095m(本机标定)不置位。
C++ 664 passed,pytest 175 passed / 2 skipped。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
docs/architecture-map/(自 10-02 起未跟踪,停在 SDK 0.4.1 / 固件 1.2.14)按代码重新取证:
基线 SDK 7652848(v0.4.8 之上)、固件 hw_v1.1.0@2543940(v1.3.1,V2.11)。新增交换模式
(FollowerExchange / LeaderExchange、控制通道线程)、腕部去畸变决策、鱼眼双槽与参考内参
检查等节点、连线、业务对象与两个场景;行号逐条复核。节点类型 optin 改为 optional
(typos 钩子)。JS 均通过 node --check,id 交叉检查 0 错。

顺带:CHANGELOG [0.4.8] 与 payloads.hpp 里"鱼眼槽常量尚未进 check_protocol_drift.py"
已过时(5e51a81 起已比对),改正。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@Vertax42
Vertax42 merged commit b714acb into main Nov 20, 2026
3 checks passed
@Vertax42
Vertax42 deleted the feat/warn-reference-fisheye-cal branch November 20, 2026 08:27
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant