SelfRising/docs/HARDWARE.md

51 lines
3.8 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 硬件、校准与历史部署代码
## 当前任务的接口
| 部件 | 角色 / 记录中的连接 |
|---|---|
| 两只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座、舵盘连接、轴孔公差和带载稳定性仍需实物验证。