# 硬件、校准与历史部署代码 ## 当前任务的接口 | 部件 | 角色 / 记录中的连接 | |---|---| | 两只360°连续旋转SG90 | 下轴物理32、上轴物理33,接X5两路PWM;输出是转向与转速 | | QMI8658C模块 | 通过I²C连接X5,IMU刚性固定在机器人底板;记录使用224.2Hz、±1024dps、±8g | | X5 | 外置推理和控制,不计入大底板机器人的运动质量 | | 舵机电源 | 与X5共地的独立匹配电压支路;历史调试记录最终按用户确认5V测试 | | 底板 | 100×80×5mm,单独的刚体与IMU安装位 | 这是项目现有接线记录,不是对任意X5版本/任意IMU模块的通用电气保证。换设备须核对实际接口、模块允许电压与供电能力。三线舵机插头的电源、地、信号应分线连接,不能整排套到相邻三针。历史MG90S/定位SG90文件仅作为依赖与演进证据。 ## 连续旋转与定位控制不能混用 历史软件一度把SG90当位置舵机做1500μs归中;确认是360°版后,该角度校准不再有效。现有速度控制的名义映射是下轴`1500+50*u0`、上轴`1500−50*u1`,整数脉宽约1450–1550μs。它记录的是**发出的脉宽与累计命令**,不是实际轴角或带载转速测量。 停止点、死区、带载速度、供电压降与停PWM后的被动响应依赖个体、负载和接线。保留每轴限制、故障锁存、独占锁、失联处理与退出清理。不可为了提高仿真成绩去放宽实机保护。 ## IMU安装标定 `RDK/calibration/imu_server.py`使用flat、x_up、y_up三个静止姿态,筛查采样质量、正交关系和符号,估计sensor-to-body旋转与陀螺零偏。加速度偏置没有完整标定;底板IMU不能直接给出两个关节角度、杆尖接触或真实停止力矩。 原安装profile在工作区部署目录中缺失;本次整理从冻结训练的`installation.json`恢复到部署副本。二者期望SHA一致:`7685b881cf3a47b204c8e4b7dc6083008f89ae53f0979c0bb9d9c483cc13ff6b`。这是原安装记录的逐字节恢复,不是重新校准。换安装后应重新测量,不能强行维持该SHA冒充兼容。 ## 代码调用链 ```mermaid flowchart TD Web[RDK/calibration/imu.html] --> API[imu_server.py] API --> Bridge[speed_bench.py / SSH bridge] Bridge --> Bench[bench_pulse.py] Bench --> IMU[imu_reader / imu_stream / orientation] IMU --> Actor[speed_runtime.py + 旧actor] Actor --> Limit[PWM映射 / 每轴命令积分限制] Limit --> PWM[pwm_outputs.py] Auto[autonomous.py] --> Bench Bench --> Receipt[bench_receipts JSON / 录像] ``` 网页实验与自主监听的生命周期不同:单次实验有浏览器心跳;历史自主服务由板端独立监听,不依赖网页持续开启。历史服务还可接入分段撑地,上轴并非始终来自网络,因此要读每轮`model_only`和`measured_support`字段。 ## 启动边界 本次整理没有上传或启用任何板端程序。仓库不携带SSH私钥、known_hosts、连接会话或原网页session;`DEPLOYED.json`也不作为当前机器已部署的信号复制。网页源码中的SSH目标可用`CALIBRATION_SSH_HOST`、`CALIBRATION_SSH_IDENTITY`、`CALIBRATION_SSH_KNOWN_HOSTS`配置,使用自己的可信连接。 `upload.py`等历史部署脚本有真实副作用,不能作为查看项目的第一步。协作者先运行离线测试和模型推理,具体部署须对自己的硬件、安装、运行身份与现场条件完成校核。v3诊断主模型没有真实上机验证;不要把它替换进历史7626目录,哈希约束也会拒绝这种混用。 当前机械主版为加高圆角 v4+IMU 安装位,共五件塑料件,见[打印清单](../3Dmodel/README.md)。IMU座、舵盘连接、轴孔公差和带载稳定性仍需实物验证。