3.8 KiB
硬件、校准与历史部署代码
当前任务的接口
| 部件 | 角色 / 记录中的连接 |
|---|---|
| 两只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冒充兼容。
代码调用链
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 安装位,共五件塑料件,见打印清单。IMU座、舵盘连接、轴孔公差和带载稳定性仍需实物验证。