58 lines
3.0 KiB
Markdown
58 lines
3.0 KiB
Markdown
# RDK X5 · 实机控制
|
||
|
||
对应参考仓库中的Arduino部分,本项目使用RDK X5上的Python控制程序:底板IMU→姿态/历史观测→策略推理→限幅→两轴PWM。
|
||
|
||
## 文件
|
||
|
||
| 位置 | 用途 |
|
||
|---|---|
|
||
| [WIRING.md](WIRING.md) | 双SG90、IMU、电源与X5连接 |
|
||
| [calibration/imu_server.py](calibration/imu_server.py)、[imu.html](calibration/imu.html) | 校准网页与接口 |
|
||
| [deployment/x5_continuous_speed_20261112/](deployment/x5_continuous_speed_20261112/) | 历史7626速度模型、推理、限幅、点动、自主监听 |
|
||
| [deployment/x5_imu_calibration_20261112/v2/](deployment/x5_imu_calibration_20261112/v2/) | 独立IMU采集进程、PWM输出、故障处理与测试 |
|
||
| [bench_receipts/](deployment/x5_continuous_speed_20261112/bench_receipts/) | 六轮实机JSON与实拍,包含失败 |
|
||
|
||
## 权重先分清
|
||
|
||
- **板端历史7626**:在X5真实运行过;纯模型三次起身失败,辅助撑地有成功记录。
|
||
- **RL/actor.npz的BC43**:后续诊断仿真主模型,未部署到真机,物理参数校准尚未通过。
|
||
|
||
两者不能互换文件冒充同一版本。板端程序检查模型和安装profile的身份。[完整结果](../docs/RESULTS.md)
|
||
|
||
## 接线、校准、验证
|
||
|
||
1. 按[接线说明](WIRING.md)检查实际模块、电源与两路PWM。
|
||
2. IMU固定在底板;用flat、x_up、y_up三姿态校准安装旋转与陀螺偏置。
|
||
3. 分轴测停止点、转向、带载响应;连续旋转版不做1500 μs等于零角的标定。
|
||
4. 核对冻结模型及控制接口,再执行无PWM推理检查。
|
||
5. 在现场完成受限动作测试,保存实际写入脉宽、限幅、IMU、时间与停机收据。
|
||
|
||
## 网页程序
|
||
|
||
从仓库根目录运行:
|
||
|
||
```sh
|
||
export CALIBRATION_SSH_HOST=你的X5地址
|
||
export CALIBRATION_SSH_IDENTITY=你的SSH私钥路径
|
||
export CALIBRATION_SSH_KNOWN_HOSTS=你的known_hosts路径
|
||
cd RDK
|
||
python -B -m calibration.imu_server --port 8767
|
||
```
|
||
|
||
网页地址为`http://127.0.0.1:8767/`。启动会尝试读取所配置X5的状态;仓库不携带SSH凭据和当前部署标记。首次启动不等于已完成部署、允许动作或新硬件已标定。校准/部署仍需结合自己的板卡身份与现场条件,不能从网页出现推断已具备执行条件。
|
||
|
||
自主监听程序为autonomous.py,服务定义为x5-selfright.service。历史辅助模式会上轴分段撑地,不能称为两轴全由网络控制。upload.py等历史脚本有真实部署副作用,不属于离线查看步骤。[部署与控制边界](../docs/HARDWARE.md)
|
||
|
||
## 离线测试
|
||
|
||
从仓库根目录运行,使用假硬件:
|
||
|
||
```sh
|
||
(cd RDK && python -B -m unittest calibration.test_imu calibration.test_imu_motion)
|
||
(cd RDK/deployment/x5_continuous_speed_20261112 && python -B -m unittest test_speed_runtime test_autonomous)
|
||
(cd RDK && node calibration/test_imu_frontend.cjs)
|
||
(cd RDK && node calibration/test_imu_motion_frontend.cjs)
|
||
```
|
||
|
||
这些检查不操作真实板卡,不代表电源、PWM波形、机械配合或实机起身验证。
|