SelfRising/docs/HARDWARE.md

3.8 KiB
Raw Permalink Blame History

硬件、校准与历史部署代码

当前任务的接口

部件 角色 / 记录中的连接
两只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座、舵盘连接、轴孔公差和带载稳定性仍需实物验证。