1. SpaceMouse与Ubuntu环境准备
SpaceMouse作为专业3D交互设备，在工业设计和机器人仿真领域有着广泛应用。但很多开发者不知道的是，官方早在2014年就停止了对Linux驱动的维护。这导致在Ubuntu系统上使用SpaceMouse需要依赖开源社区方案。我最近在机器人仿真项目中就遇到了这个问题，经过多次尝试终于找到了稳定可靠的解决方案。
首先需要明确的是，整个配置流程主要涉及三个关键组件：
- spacenavd：SpaceMouse的开源驱动守护进程
- libspnav：提供设备通信的底层库
- hidapi：Python访问USB设备的接口
在开始之前，请确保你的Ubuntu系统版本在18.04及以上（我实测20.04和22.04都能完美运行）。建议使用有线连接的SpaceMouse设备，无线版本可能需要额外配置蓝牙驱动。另外，Python环境建议使用3.7+版本，因为后续要用的Robosuite对Python版本有要求。
2. 驱动安装与配置
2.1 安装spacenavd驱动
打开终端，先安装必要的依赖库：
sudo apt update sudo apt install -y libxext-dev libxrender-dev libxmu-dev libxmuu-dev \ libxtst-dev libx11-dev libxi-dev这些库是X11窗口系统的基础组件，spacenavd需要通过它们来捕获设备输入。我遇到过因为漏装libxi-dev导致编译失败的情况，所以建议一次性全部安装。
接下来获取源码并编译安装：
git clone https://github.com/FreeSpacenav/spacenavd.git cd spacenavd ./configure make sudo make install安装完成后需要设置开机自启：
sudo ./setup_init sudo /etc/init.d/spacenavd start这里可能会看到"cat: /etc/inittab: 没有那个文件或目录"的提示，这是正常现象，因为现代Ubuntu系统已经不再使用inittab了。
2.2 安装libspnav库
libspnav是应用程序与spacenavd通信的桥梁：
git clone https://github.com/FreeSpacenav/libspnav.git cd libspnav ./configure make sudo make install安装完成后建议运行测试程序验证：
cd examples/simple make ./simple_af_unix正常移动SpaceMouse会看到类似这样的输出：
got motion event: t(0, 0, 9) r(-19, 0, 0) got motion event: t(-45, 0, 56) r(-78, 0, -38)其中t表示平移向量，r表示旋转向量。如果能看到这些实时数据，说明驱动安装成功。
3. Python环境配置
3.1 获取设备ID
首先通过lsusb命令查找设备信息：
lsusb | grep -i spacemouse如果没有输出，可以对比插入设备前后的lsusb结果差异。我的设备显示：
Bus 001 Device 010: ID 256f:c62e这里256f是厂商ID(Vendor ID)，c62e是产品ID(Product ID)，后续配置会用到。
3.2 配置设备权限
默认情况下，普通用户无法直接访问USB设备。我们可以通过udev规则解决：
sudo nano /etc/udev/rules.d/99-spacemouse.rules添加以下内容（替换为你设备的ID）：
SUBSYSTEM=="usb", ATTRS{idVendor}=="256f", ATTR{idProduct}=="c62e", MODE="0666"保存后重新加载udev规则：
sudo udevadm control --reload-rules sudo udevadm trigger现在安装Python的hidapi库：
pip install hidapi可以编写一个简单的测试脚本test_spacemouse.py：
import hid device = hid.device() device.open(0x256f, 0xc62e) # 替换为你的设备ID while True: data = device.read(64) if data: print(data)运行后移动SpaceMouse应该能看到原始数据输出。如果出现权限错误，请检查udev规则是否生效。
4. Robosuite集成实战
4.1 安装Robosuite
建议使用源码安装最新版：
git clone https://github.com/ARISE-Initiative/robosuite.git cd robosuite pip install -e .4.2 修改控制脚本
找到robosuite/demos/demo_device_control.py，修改以下部分：
# 修改参数默认值 parser.add_argument("--device", type=str, default="spacemouse") # 修改设备初始化参数 device = SpaceMouse( vendor_id=0x256f, # 替换为你的Vendor ID product_id=0xc62e, # 替换为你的Product ID pos_sensitivity=args.pos_sensitivity, rot_sensitivity=args.rot_sensitivity )4.3 运行仿真环境
启动演示程序：
python demo_device_control.py --env Lift现在应该可以用SpaceMouse控制机械臂了。如果发现控制不灵敏，可以调整灵敏度参数：
python demo_device_control.py --env Lift --pos_sensitivity 1.5 --rot_sensitivity 1.25. 常见问题排查
5.1 设备无响应
如果SpaceMouse完全没有反应：
- 检查USB连接是否正常
- 确认spacenavd服务正在运行：
ps aux | grep spacenavd - 尝试重启服务：
sudo /etc/init.d/spacenavd restart
5.2 Python读取失败
如果Python脚本无法读取数据：
- 确认udev规则已正确设置
- 检查设备节点是否存在：
ls -l /dev/input/by-id/ - 尝试以root身份运行测试脚本
5.3 Robosuite控制异常
如果机械臂运动不正常：
- 检查SpaceMouse的6个自由度是否都能正确输出
- 尝试降低灵敏度参数
- 确认Robosuite版本与Python环境兼容
我在实际项目中发现，SpaceMouse的Z轴旋转（扭动动作）有时会与机械臂的末端旋转轴不一致，这时需要调整Robosuite的控制器映射关系。可以在demo_device_control.py中找到control_loop函数，修改其中的动作映射逻辑。
