使用说明
IO Gesture 软件基础信息
系统要求
| 项目 | 要求 |
|---|---|
| 操作系统 | Ubuntu 22.04 或 24.04(x86 或 arm64) |
| 处理器(CPU) | 建议 ≥ 14 代 Intel Core i5,或 ≥ 13 代 Intel Core i7 同级性能(详见 设备性能要求) |
| 内存 | 建议 16 GB 及以上 |
| 命令行工具 | curl(启动脚本用于本地健康检查) |
| 浏览器 | Headed 模式需现代浏览器(Chrome / Firefox / Edge 等) |
说明:软件包自带运行时所需 Python、依赖库与可执行程序,使用主程序无需安装 ROS 和系统级 Python 依赖。
设备性能要求(CPU)
本平台同时运行多个子进程,Headed 模式下还有 Web 三维可视化与实时曲线,对 CPU 算力 要求较高。 低于推荐配置时,可能出现界面卡顿、关节曲线掉帧、子进程响应变慢等现象。
可参考如下建议:
| 等级 | CPU 参考 | 说明 |
|---|---|---|
| 推荐 | 14 代 Intel Core i5 或 13 代 Intel Core i7 及以上 | 可流畅运行 Headed 模式(含 URDF 可视化与实时监控) |
| 勉强可用 | 13 代 i5、12 代 i7 或同级 | Headless 模式通常可接受;Headed 模式可视化可能偶发卡顿 |
| 不推荐 | 低于上述等级的老款笔记本 / 低功耗 U 系列 | 易出现明显卡顿,不建议用于演示或生产 |
软件包结构
- 软件包目录结构和说明如下(以实际为准):
io_teleop_exoglove_amd64-2.1.7/
│
├── bundle/ # 运行时依赖(开箱即用)
│
├── configs/ # 配置与模型资源
│ ├── config/ # 系统配置(Gateway / Zenoh / 话题)
│ ├── end_tools/ # 末端工具配置
│ ├── exoskeleton_urdf/ # 外骨骼 URDF 模型与网格
│ ├── IO.png # 应用图标
│ └── udev/ # 串口设备规则
│
├── io-gateway.desktop # 桌面快捷方式模板
│
├── scripts/ # 启动脚本
│ ├── bundle-env.sh # 环境变量加载
│ ├── install-desktop.sh # 安装桌面快捷方式
│ └── run_gateway.sh # 启动 Gateway 控制台
│
├── src/
│ ├── io_bus_proto/ # 通信消息协议
│ ├── io_gateway/ # Web 控制台(后端 + 3D 可视化)
│ └── io_unicontroller/ # 外骨骼运动控制
│
└── tools/ # 辅助工具
├── tools/ # 无线模块烧录等
├── ws2ros_bridge.py # WebSocket ↔ ROS 桥接
├── ws2ros-env.sh
├── zenoh2ros_bridge.py # Zenoh ↔ ROS 桥接
└── zenoh2ros-env.sh
附:常用配置说明(点击展开)
主配置文件:configs/config/gateway.yaml
| 配置项 | 说明 |
|---|---|
udp_probe.bind_ip | 无线模式本机绑定 IP(须为本机实际地址) |
listen_host / listen_port | Web 监听地址与端口(默认 0.0.0.0:8080) |
logs_dir | 日志目录 |
wifi_provision | 配网默认 SSID / 密码 / 回调 IP |
udp_allowed_ips | 无线 IP 白名单(最多 2 个,可选) |
灵巧手资源目录:configs/end_tools/<型号名>/。
软件运行模式
IO Gesture 提供两种运行模式:
| 模式 | 适用场景 | Web 界面 | 操作方法 |
|---|---|---|---|
| Headed(默认) | 本地桌面、调试、演示 | 有,自动打开浏览器(界面说明请查阅 界面总览) | 方法一:进入软件包目录,在终端执行 ./scripts/install-desktop.sh 后,双击桌面快捷方式或在应用菜单搜索「IO Gateway」/「IO Gesture」启动;方法二:进入软件包目录,在终端运行 ./scripts/run_gateway.sh |
| Headless | SSH 远程、systemd 服务、二次集成 | 无 | 进入软件包目录,在终端运行 ./scripts/run_gateway.sh --headless |
- 软件包
tools/额外提供可选 ROS 桥接脚本(主程序不依赖 ROS):Zenoh → ROS / WebSocket → ROS
详细启动方式请查阅 IO Gesture 使用方法 章节。
IO Gesture 部署方法
- 软件包 解压与权限设置:
cd /path/to/io_teleop_exoglove_amd64-2.1.7
chmod +x scripts/*.sh
- 在项目根目录执行:
./scripts/install-desktop.sh
该脚本会:
- 安装桌面快捷方式「IO Gateway」/「IO Gesture」。
- 安装串口 udev 规则(
ttyACM*/ttyUSB*→dialout组)。 - 将当前用户加入
dialout组。
重要提示
若本次才加入 dialout 组,请注销并重新登录(或重启)后再插拔外骨骼。
提示
若脚本执行完成后仍出现串口权限问题,请尝试手动执行:
sudo chmod -R 777 /dev/ttyA*