SelfRising/RDK/README.md

58 lines
3.0 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.

# 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波形、机械配合或实机起身验证。