跳转至

PS2 手柄遥控

English version

Hint

操作环境及软硬件配置如下:

  • OriginCar / OriginCar Pro
  • ROS 2 Humble(Foxy 也可使用,安装对应的 joy 版本)
  • PS2 手柄 + USB 接收器
  • 底盘驱动:origincar_base
  • 手柄功能包:ps2_teleop

本页介绍如何使用 PS2 手柄遥控 OriginCar。手柄接收器插入主控 USB 口后,系统会把它识别为 /dev/input/js0;joy 功能包将手柄状态发布到 /joy,ps2_teleop 再把左摇杆映射为速度指令发布到 /cmd_vel。

PS2 手柄与 USB 接收器

图 1:PS2 手柄及 USB 接收器

控制链路如下:

PS2 手柄 → USB 接收器 → /dev/input/js0 → joy_node → /joy
                                             ↓
                                   ps2_teleop_node
                                             ↓
                                         /cmd_vel → 底盘

1. 连接与识别手柄

将手柄的 USB 接收器插入主控(RDK X3 / X5 / S100)的 USB 接口,打开手柄电源,然后在终端中检查设备:

ls /dev/input/js*

如果输出类似 /dev/input/js0,说明系统已经识别到手柄。

如果手柄已经识别,但摇杆没有数据,可以按一下手柄上的 MODE 键,切换到模拟模式(手柄指示灯状态通常会变化)。

如果只有 js0,后续命令直接使用默认设备即可。如果识别到多个手柄,可以通过 ros2 run joy joy_enumerate_devices 查看设备列表,或在启动 joy_node 时指定设备。

设备权限

OriginCar 默认使用 root 登录时通常不需要额外设置。如果使用普通用户运行,可能会遇到 Permission denied,可以临时放开权限:

sudo chmod 666 /dev/input/js0

需要长期生效时,可以添加 udev 规则:

echo 'KERNEL=="js[0-9]*", MODE="0666"' | sudo tee /etc/udev/rules.d/99-joystick.rules
sudo udevadm control --reload-rules
sudo udevadm trigger

安装 joy 驱动

如果系统没有 joy_node,先安装:

sudo apt update
sudo apt install -y ros-humble-joy

2. 安装 ps2_teleop 功能包

下载功能包:

点击下载 ps2_teleop.zip

将压缩包上传到小车的 ROS 2 工作空间:

scp ps2_teleop.zip root@<小车IP>:/userdata/dev_ws/src/

在小车端解压并编译:

cd /userdata/dev_ws/src
unzip ps2_teleop.zip

cd /userdata/dev_ws
colcon build --packages-select ps2_teleop --symlink-install
source install/setup.bash

编译完成后确认节点已经安装:

ros2 pkg executables ps2_teleop

应该能看到:

ps2_teleop ps2_teleop_node

关于 --symlink-install

使用 --symlink-install 后,修改 config/ps2_teleop.yaml 不需要重新编译,重启 launch 即可生效。如果没有使用该选项,修改配置后需要重新执行 colcon build。

3. 启动遥控

终端 1,启动底盘驱动:

ros2 launch origincar_base origincar_bringup.launch.py

终端 2,启动手柄节点:

ros2 launch ps2_teleop ps2_teleop.launch.py

启动成功后,按住 L1,拨动左摇杆即可控制小车:

操作 效果
按住 L1 + 左摇杆向上 前进
按住 L1 + 左摇杆向下 后退
按住 L1 + 左摇杆向左 左转
按住 L1 + 左摇杆向右 右转
按住 R1 + 左摇杆 快速模式
松开 L1 或摇杆回中 停车

阿克曼转向

OriginCar Pro 为阿克曼转向结构,原地打方向不会让车辆转向,需要同时给一点前进或后退速度。

4. 键位映射

默认映射按照常见 PS2 USB 接收器配置:

手柄输入 /joy 索引 作用
左摇杆上下 axes[1] 前进 / 后退(linear.x)
左摇杆左右 axes[0] 左转 / 右转(angular.z)
L1 buttons[4] 使能遥控
R1 buttons[5] 快速模式

不同批次的手柄接收器可能会有差异。可以运行下面的命令,观察摇杆和按键对应的索引:

ros2 topic echo /joy

例如拨动左摇杆时,axes 数组中的数值会变化;按下 L1 / R1 时,buttons 对应位置会从 0 变成 1。

如果索引与默认值不同,修改 config/ps2_teleop.yaml 中的 axis_linear、axis_angular、enable_button、turbo_button 即可。

5. 功能包结构

ps2_teleop/
├── config/
│   └── ps2_teleop.yaml          # 轴、按键、速度和超时参数
├── launch/
│   └── ps2_teleop.launch.py     # 同时启动 joy_node 和遥控节点
├── ps2_teleop/
│   ├── __init__.py
│   └── ps2_teleop_node.py       # 手柄到 Twist 的映射节点
├── resource/
│   └── ps2_teleop
├── package.xml
├── setup.cfg
├── setup.py
└── README.md

节点的主要逻辑如下:

  1. 订阅 /joy,保存最新的 axes 和 buttons;
  2. 以 20 Hz 定时发布 /cmd_vel;
  3. 超过 timeout 没有收到 /joy 时发布零速度;
  4. 未按住 enable_button 时发布零速度;
  5. 读取左摇杆垂直 / 水平轴,经过死区、方向反转和限幅后得到 linear.x、angular.z;
  6. 按住 turbo_button 时使用快速档速度。

6. 安全说明

  • 首次测试建议把小车架空,确认前进、后退、转向和松开 L1 停车都正常后再落地。
  • 调试时使用较低速度,周围不要站人,避免小车冲出桌面或撞到障碍物。
  • 松开 L1、摇杆回中或 /joy 超时,节点都会发布零速度;但底盘驱动异常时仍可能无法停车,建议随时准备关闭电源。
  • 手柄接收器尽量直接插在主控 USB 口,不使用劣质 USB 延长线。
  • 长时间不使用时关闭手柄电源,避免电池耗尽。

图片1