X5 双舵机实机标定工作台
当前:SG90 实测校准与单次爬起工作台
入口仍为 http://127.0.0.1:8767/,从仓库根运行 python3 -m calibration.imu_server --port 8767。此页使用 /home/sunrise/x5_imu_calibration_20261112/v2/motion_cli.py;未调用旧16输入恢复驱动,也未复用旧MG90S/竖直yaw标定。页面加载、刷新和相机开启不会输出PWM,动作须用户主动点击并完成现场确认。
已完成的三姿态、候选及板端保存回执持久化到 imu_data_20261112/session.json,重启恢复且不重放旧任务。动作请求、前后图及现场观察分别留存;运行中重启会将结果标未知,板端仍有租约/超时保护。维护升级前必须等待任务空闲并从 /api/imu/export 保存最新完整会话,不能丢掉用户已做的校准。
按网页依次完成:
- IMU已固定并校准后,用户确认平放静止且在现场观察,主动运行一次无PWM前置验证。回执绑定本次模型/安装/运行版本;旧逐次读取曾出现丢帧,不将旧失败或新技术诊断冒充用户验收。是否通过以当前板端回执为准。
- 先卸下舵盘和相连负载,仅对固定下轴32或上轴33做一次1500→1450/1550→1500微秒点测。首次1500也可能明显转动,不会自动归中。结束停PWM后,保持轴不转,按CAD装回机械零位;操作者用量角器确认后记录1500μs=0°。这是主动现场确认,不是预填的测量值。
- 装回后每次只选已有实测点旁边±50μs。上轴正角使原竖直杆向body+X偏;下轴正角使杆向body−Y偏,测一轴时另一轴保持零位。方向按钮只保存观察,不能替代实测角。每次目标保持时使用与关节转动平面一致的量角器读数;前图只记录准备情境,不自动验证角度,真实phase/after图另行留存。
- 板端将每份人工量角绑定到真实、清理确认的jog任务,保存增量历史。两轴实测范围均覆盖−60°…+60°后,由实测点内插生成SG90 profile,范围外不外推。行程不足或碰撞应停止;不能为了达到60°而顶死。校准不完整时爬起被阻断,有限点动仍可完成校准。
- 保持独立舵机供电并共地,将机构轻放倒、静止,不从高处抛摔。新前图、当前现场确认和板端门禁都通过后,用户点击一次爬起;3秒倒计时可取消,板端动作最长8秒,不循环、不自动重试。
本地复用原 Bridge 首浏览器心跳、互斥、2.5秒续租、25秒传输超时、板端停止和清理流程;增加两个覆写点以绑定新协议,旧入口默认行为不变。运动时700ms浏览器保活;后台、画面丢失、观察取消、停止或超时触发停机。前图15秒有效且不可复用;相机不可用时允许用户主动上传确为当前的照片并持续现场观察,标记接收时间而不伪造拍摄时间。停止PWM不等于切断舵机电源。
页面显示真实IMU、下发目标、推理、阶段和清理回读。imu_upright_candidate 只显示“姿态达标,请现场确认是否站稳”;仅用户主动记录底板着地并站稳后标为用户观察确认,不自动声称实机成功率。91.69%为既有仿真数据,非实机保证。
验证:python3 -m unittest calibration.test_imu calibration.test_imu_motion calibration.test_backend calibration.test_server,以及 node calibration/test_imu_motion_frontend.cjs、node calibration/test_imu_frontend.cjs、node calibration/test_frontend.cjs。替身测试不输出PWM;真正的点动/量角/爬起留给现场用户主动执行。
2026-11-12:独立 IMU 安装校准页
以下为此前无PWM版本的记录;当前功能与安全门禁以本文件上节和当前页面为准。
本次入口:http://127.0.0.1:8767/,启动命令:
python3 -m calibration.imu_server --port 8767
此入口不加载旧动作页面、不调用旧 Bridge.prepare/start,只复用现有受限 SSH 传输连接本次部署的 board_tool.py。没有舵机/PWM API。加载页面只读状态;用户主动开始的 8 秒窗口才采集六轴,网页显示约 20 Hz,传感器配置为 224.2 Hz、±8g、±1024°/s,结束逐位恢复并回读列出的可读配置。同步锁存需操作 AHB 时钟门控;门控原始隐藏状态不可读,退出时通过 CAL1_L=0 显式重新启用,因此 hidden_state_restored=false,不声称恢复全部硬件状态。结果显示实际接收频率、传感器计数跨度、丢帧和恢复范围。窗口结束的数值明确标记为历史样本。
按页面依次静置:顶面 +Z 朝上、+X 端竖直朝上、+Y 端竖直朝上,手托底板而非长杆。三份数据均通过静止筛查后拟合右手正交 sensor_to_body;姿态彼此不近似正交、符号反了或拟合误差超过15°时拒绝候选。仅平放估计陀螺仪零偏,保留1g;未进行完整六面加速度标定。详见 安装和四线接法。
候选先保存在本机 calibration/imu_data_20261112/,不会自动套用旧安装参数。用户勾选并点击保存后,板端基于三份原始证据 SHA、实采参考数据和模型身份重新验证,写入新 /home/sunrise/x5_imu_calibration_20261112/calibration_profile.json;本目录旧 profile 若有则先备份,20261109 旧目录保持不变。calibration_candidate_sha256 标识校准内容,model_candidate_sha256 标识冻结模型入口,两者不同。
板端96条离线数值检查已通过;真实8秒采样出现过2–4个计数缺口,实时采样尚未验收,网页会明确显示该状态。主动影子诊断保留遇任意丢帧即失败的严格门禁,可能因此中止;shadow_ready 或校准文件存在仅表示有配置,不代表实时链路通过。
保存后的 8 秒影子推理只建立196维观测并计算网络输出,两轴命令历史是虚拟的,不向舵机发送。训练模型91.69%仿真成功率不等于真机恢复成功;舵机零位、方向、全行程及机构安装仍需后续实测门禁。本次不启用旧页面的动作按钮。
本机服务只绑定回环,保留 Host/Origin/CSRF 检查。测试为 python3 -m unittest calibration.test_imu -v、node calibration/test_imu_frontend.cjs:包括纯合成三姿态、拒绝运动API、候选门禁及完整网页保存→模拟SSH→真实板端校验器→临时配置回读。该保存测试只写临时目录,没有伪造或保存实机校准。
本机入口:http://127.0.0.1:8766/calibration。原仿真结果页保留在 /,新增标定入口。服务仅绑定回环地址,不公开到局域网。
2026-11-11 自助点测:相机与单轴操作并排显示,IMU、测角和历史证据收进「更多标定」。选舵机和目标,完成三项现场确认,点击「3 秒后开始一次往返」;倒计时可用右上角停止取消,倒计时结束仍重新检查设备、相机和确认状态。每轮停止后,可点「动了,并且回位/动了,没有回位/没有动作」直接保存到显示的任务记录,页面刷新会保留已保存的观察。回位指回到本轮首次指令姿态;不指启动前姿态,也不据此认定角度标定通过。无需聊天逐次批准,原锁、租约、板端超时和清理保留;未启用策略动作或双轴联动。自助下拉不提供 550/2450 μs 极端探测。
页面载入与刷新只读状态,不启动 PWM 或 IMU 采样。设备身份每 5 秒只读刷新;实时六轴数据仅在用户主动开启的 8 秒采样中更新。历史 439 帧、零偏/安装矩阵候选、上层录像已加载,不需要从头重做。
使用
- 打开相机并允许浏览器使用摄像头,选择正确设备,完整拍到杆尖、两轴、底板及运动区域。相机预览来自浏览器所在电脑;内置浏览器不支持时用 Chrome 打开同一地址。
- 需要重采时,选择静止、前边抬高或左边抬高,倒计时后采样 8 秒。采样结束恢复原寄存器;新记录不自动替换或应用历史候选参数。
- 单轴测试前确认当前姿态、完整取景和清场。动作严格为 1500 → 1450 或 1550 → 1500 微秒,分别保持 2 / 3 / 2 秒。首次归位可能大幅运动,1500 微秒并非已验证竖直中位。
- 前后图片自动保存。用户依次点击杆底、杆尖计算二维画面投影角,另行记录看到运动/没看到/未知。拍不到杆时保持未知;前后差包含首次归位,不能当成 50 微秒产生的增量角。
- 顶部停止按钮停止当前请求;清理是否完成以板端回读为准。停止 PWM 不等于切断舵机电源。JSON 和 Markdown 导出包括原始阶段回读、候选值、来源 SHA 及图像引用。
服务启动
已有 USB SSH 用户授权保存在根目录交接文件。本机已配置专用 SSH 密钥和已核验的主机公钥,保存在 ~/.config/x5-calibration/;私钥仅本机可读,不保存板卡密码。从仓库根运行,无需预先手动建立 SSH 会话:
python3 -m calibration.server --port 8766 --debug-only
服务通过 OpenSSH ControlMaster=auto 自动建立会话,空闲复用 60 秒;会话消失后,下次状态刷新会重新建立。连接维护循环间隔 5 秒(不含连接超时耗时),首次准备失败也会重试。已准备环境重连只读取状态,不重放任何运动任务;首次脚本准备会检查板卡身份、独占锁及 PWM 空闲。断线中的任务仍按租约停止,未确认的清理保持未知。
板卡改为静态 192.168.128.100 时,为上述服务命令增加 CALIBRATION_SSH_HOST=192.168.128.100,并先将新地址对应的主机公钥核验后加入专用 known_hosts;不会自动接受未知或变更的主机密钥。默认控制 socket 按主机区分。仍兼容 CALIBRATION_SSH_CONTROL,密钥和主机公钥文件分别可通过 CALIBRATION_SSH_IDENTITY、CALIBRATION_SSH_KNOWN_HOSTS 指定。这些配置不修改电脑或板卡 IP。
本机专用公钥在板端限制为 USB 子网 192.168.128.0/24 来源,禁用端口转发、代理转发和交互终端;切换到其他网络须另行核对授权。服务停止、USB 未识别、板卡未开机或物理网络不通时,不能仅靠 SSH 自动恢复。首次在其他电脑使用仍需安装该电脑自己的公钥并核验板卡主机公钥。
2026-11-10 本次硬件调试使用同一启动命令加 --debug-only:仅上传 IMU/单轴 runner,屏蔽旧恢复就绪状态,并在服务端拒绝 recovery 请求。旧 profile 的近似起身批准不会启用本轮恢复入口。
启动前确认 8766 空闲,勿结束其他服务。启动会上传并校验专用 runner 与既有采样器,仅写 /home/sunrise/x5_calibration_web_20261109/。不会输出 PWM、改变设备树或自动采样。已有活动任务时不能替换 runner。
保护与证据
- 同源 Host/Origin 校验和每次服务启动生成的请求令牌;无跨域控制接口。
- 单轴固定指令范围,当前取景确认、15 秒内的新前图,重复 UUID 拒绝重放。
- 本地任务互斥与板端文件锁;发现已导出 PWM 即拒绝抢占。
- 收到首次浏览器保活后才允许下发任务;无首次保活或先停止时不接触运动控制。
- 浏览器每 700 ms 保活,本地与板端分别检查 2.5 秒租约;板端 15 秒超时,本地 SSH 25 秒超时。
- 清理失败或 SSH 断连显示未知/失败,不将请求接受或 PWM 回读当作机械到位。
deployment/x5_mg90s_20261109_verify/web-calibration/保存新任务 JSON、图片、观察、验收记录;历史原文件不变。
测试:python3 -m unittest calibration.test_backend calibration.test_server -v 和 node calibration/test_frontend.cjs(动作门禁、竞态、投影测量、相机授权/取消、自助倒计时取消及未回位记录)。硬件动作测试使用替身,超时测试使用独立进程;并非实机运动验收。
已实读 X5 身份、IMU 0x6B / WHO_AM_I 0x05 和空闲 PWM,已核对板端 runner SHA。新网页的实时相机权限、8 秒采样和动作闭环仍需现场操作验证。本次未输出 PWM 或重新采样。X5 直供余量、全行程、关节实际角度及旧策略的真实观测适配仍未验证,本页不提供爬起入口。
2026-11-09 晚间续作:增加逐步测量用的固定 900..2100 μs(100 μs 间隔,排除1500)目标;旧1450/1550流程不变。新目标以400 μs/s、每步最多20 μs往返,最长指令流程10秒,保留15秒硬上限和浏览器心跳停机。列表不是实测安全行程或已校准角度;执行前先核对零位,并逐个邻近目标观察。
2026-11-11 排针定位澄清
从排针末端 DO / GND 那一排开始数,每一对两针算一排;不能把 GPIO6 功能名理解成第六排,也不依赖实物上是否印全 GPIO 数字。
| 从 DO/GND 端数 | 同排文字 | 本次用途 |
|---|---|---|
| 1 | DO / GND | 不接信号 |
| 2 | DIN / GP | 不接信号 |
| 3 | GP / WS | 不接信号 |
| 4 | GND / PWM | PWM 是上轴信号,物理33 |
| 5 | PWM / GP | PWM 是下轴信号,物理32 |
| 6 | GND / GP | 不是本次下轴信号针 |
同排文字顺序不代表固定左右:正面/背面视角会镜像。定位端点、排数和PWM文字后再插线,断电改线。
用户已明确选择空载、现场口头反馈的调试方式。runner新增显式 observation_mode=user_feedback,仅允许机械空载、有人观察、场地/初始归位条件确认的单轴1450/1550us小幅任务,不伪造相机确认或照片。原相机模式、恢复模式、全行程探测仍按原门禁执行;锁、租约、硬超时与清理不变。
简化的现场确认
实机区使用一个明确的“本次准备”确认,包含供电共地、当前画面、现场观察、活动区及归中风险。同轴同阶段的成功点动和选择下个小步不清除此确认;换轴、换阶段、急停、切后台和断线会清除。阶段确认只显示当前适用的一项。测量后自动选择最新记录点;服务端原有输入验证、实时画面、租约、急停、限位与实测覆盖检查保持有效。