Document SDK sources, D405 drivers and SocketCAN setup
This commit is contained in:
@@ -4,7 +4,7 @@
|
||||
|
||||
## 安装
|
||||
|
||||
运行环境为 Ubuntu 24.04 x86_64、系统 Python 3.12、ROS 2 Jazzy、Intel RealSense D405。机械臂使用官方 SDK 1.0.5 与原生 MoveJ,G20 左手使用 SocketCAN。安装步骤见 [环境配置](docs/INSTALL.md)。
|
||||
运行环境为 Ubuntu 24.04 x86_64、系统 Python 3.12、ROS 2 Jazzy、Intel RealSense D405。机械臂使用官方 SDK 1.0.5 与原生 MoveJ,G20 左手使用 SocketCAN。官方 SDK 下载来源、D405 驱动、USB-CAN/SocketCAN 配置及检查步骤见 [环境配置](docs/INSTALL.md)。
|
||||
|
||||
~~~bash
|
||||
bash scripts/setup.sh
|
||||
|
||||
+97
-5
@@ -9,10 +9,10 @@
|
||||
- 左手 can0,1 Mbps,设备身份默认 LHT20-011-263-L-B-1-D,标定表随包提供;其他设备必须重新确认身份与标定,不能直接套用。
|
||||
- ROS_DOMAIN_ID 默认 29。主机和下位机网络、USB/CAN 权限由现场配置。
|
||||
|
||||
已安装 ROS 2 软件源的机器可补充系统组件:
|
||||
先按 [ROS 2 Jazzy 官方安装说明](https://docs.ros.org/en/jazzy/Installation/Ubuntu-Install-Debs.html) 配置 Ubuntu 24.04 的 ROS 软件源。已配置软件源的机器可补充系统组件:
|
||||
|
||||
~~~bash
|
||||
sudo apt install python3.12-venv python3-pip iproute2 libgl1 libglib2.0-0 \
|
||||
sudo apt install python3.12-venv python3-pip iproute2 can-utils usbutils kmod libgl1 libglib2.0-0 \
|
||||
ros-jazzy-ros-base ros-jazzy-realsense2-camera ros-jazzy-rosbridge-server \
|
||||
ros-jazzy-control-msgs ros-jazzy-trajectory-msgs ros-jazzy-shape-msgs \
|
||||
ros-jazzy-moveit-msgs ros-jazzy-rosidl-runtime-py
|
||||
@@ -22,13 +22,105 @@ bash run.sh check
|
||||
|
||||
requirements.txt 锁定原工作环境中实际使用的直接依赖版本。setup.sh 创建独立 .venv,并允许访问系统 ROS Python 包;不复制旧 venv。SDK 动态库随包保留在 runtime/arm/vendor,Linux x86_64 使用,其他架构需厂家对应库。
|
||||
|
||||
首次使用 CAN 且接口未启用时:
|
||||
## 官方 SDK 与驱动来源
|
||||
|
||||
| 组件 | 来源与使用方式 |
|
||||
| --- | --- |
|
||||
| A7 在线控制器 SDK 1.0.5 | [SDK 源码与下载入口](https://gitee.com/meng_fan_ji/lbot_arm_api),随包来源 commit 为 e1c4a4523a46e80e40c5dbe8cc651f2cf5fa4a51。原厂库、头文件及 SHA256 记录在 runtime/arm/vendor/lbot_sdk/provenance.json;无需再次下载相同平台的库。 |
|
||||
| RealSense SDK / Linux 驱动 | [librealsense](https://github.com/realsenseai/librealsense)、[官方 Linux 安装说明](https://github.com/realsenseai/librealsense/blob/master/doc/distribution_linux.md)。 |
|
||||
| RealSense ROS 2 驱动 | [realsense-ros 官方安装说明](https://github.com/realsenseai/realsense-ros#installation-on-ubuntu)。本项目用 Jazzy 的 realsense2_camera。 |
|
||||
| Linux CAN 驱动层 | [内核 SocketCAN 文档](https://docs.kernel.org/networking/can.html)。具体 USB-CAN 设备还需要匹配的内核驱动/固件。 |
|
||||
| CAN 命令行工具 | [linux-can/can-utils](https://github.com/linux-can/can-utils),Ubuntu 软件包为 can-utils。 |
|
||||
| Python CAN 接口 | [python-can SocketCAN 文档](https://python-can.readthedocs.io/en/stable/interfaces/socketcan.html),requirements.txt 已固定 python-can==4.6.1。 |
|
||||
|
||||
机械臂通过以太网连接在线控制器;本流程的 can0 用于 G20 左手,不要求给机械臂安装直连 CAN SDK。pip 安装 python-can 不会安装 USB-CAN 内核驱动。ROSBridge 客户端 roslibpy 已在 requirements.txt 中;主机安装 rosbridge-server 不会替代下位机已有的厂家服务。
|
||||
|
||||
## D405 相机驱动与检查
|
||||
|
||||
默认使用 ROS 软件源提供的 librealsense 和 ROS Wrapper,避免同时混装源码版与其他来源的库:
|
||||
|
||||
~~~bash
|
||||
sudo ip link set dev can0 up type can bitrate 1000000
|
||||
sudo apt update
|
||||
sudo apt install 'ros-jazzy-librealsense2*' ros-jazzy-realsense2-camera
|
||||
source /opt/ros/jazzy/setup.bash
|
||||
ros2 pkg prefix realsense2_camera
|
||||
lsusb
|
||||
lsusb -t
|
||||
~~~
|
||||
|
||||
此命令只配置 CAN 接口;机械臂使能由现场操作,不由安装脚本完成。
|
||||
将 D405 接到可靠的 USB 3 数据接口。相机 USB 权限需要 RealSense 的 udev 规则;安装后重新插拔相机。若设备识别、权限或内核兼容性仍有问题,按上方官方 Linux 指南核对当前内核支持范围和 udev 配置。采用厂家 Debian 驱动路线时,依指南配置厂家软件源并安装 librealsense2-dkms、librealsense2-utils、librealsense2-dev;这是替代安装路线,不应无条件叠加到已有源码/ROS SDK 安装之上。DKMS 与当前内核及 Secure Boot 配置需兼容。
|
||||
|
||||
厂家工具路线可用 rs-enumerate-devices 查看设备与支持的流配置,或用 realsense-viewer 看图;ROS 软件包路线不保证附带这两个工具。检查完关闭 Viewer 和直接 USB 采集程序,再启动 ROS 相机,避免争用同一 D405。默认抓取通过 ROS 获取图像,不需要另外 pip 安装 pyrealsense2。
|
||||
|
||||
仅检查相机时,可在独立终端启动与项目一致的配置:
|
||||
|
||||
~~~bash
|
||||
source /opt/ros/jazzy/setup.bash
|
||||
export ROS_DOMAIN_ID=29
|
||||
ros2 launch realsense2_camera rs_launch.py \
|
||||
camera_namespace:=camera camera_name:=camera \
|
||||
enable_color:=true enable_depth:=true \
|
||||
rgb_camera.color_profile:=848x480x30 \
|
||||
depth_module.depth_profile:=848x480x30 \
|
||||
align_depth.enable:=true
|
||||
~~~
|
||||
|
||||
在另一终端检查(观察后 Ctrl-C 退出 hz):
|
||||
|
||||
~~~bash
|
||||
source /opt/ros/jazzy/setup.bash
|
||||
export ROS_DOMAIN_ID=29
|
||||
ros2 topic list
|
||||
ros2 topic echo /camera/camera/color/camera_info --once --qos-reliability best_effort
|
||||
ros2 topic hz /camera/camera/color/image_raw
|
||||
ros2 topic hz /camera/camera/aligned_depth_to_color/image_raw
|
||||
~~~
|
||||
|
||||
应能收到新的彩色图、对齐深度和有效相机内参,目标频率约 30 Hz;仅能列出话题不等于收到图像。主流程可以复用相同域/名称的驱动,不要重复启动。若报设备忙或 VIDIOC_S_FMT,先检查是否已有 ROS 相机、Viewer 或直连采集程序占用;不要用重新安装驱动代替占用排查。
|
||||
|
||||
## G20 左手 CAN 驱动与检查
|
||||
|
||||
通信链路为:G20 → USB-CAN 适配器 → 对应内核驱动 → SocketCAN can0 → python-can → 本项目 G20 协议代码。适配器需支持 Linux SocketCAN、经典 CAN 和 1 Mbps;仓库不绑定某个 USB-CAN 型号,也不包含所有厂家驱动。
|
||||
|
||||
先识别设备和已有驱动:
|
||||
|
||||
~~~bash
|
||||
sudo apt install iproute2 can-utils usbutils kmod
|
||||
lsusb
|
||||
ip -details link show type can
|
||||
# 已有 can0 时查看实际绑定驱动;部分虚拟/串口接口无此路径
|
||||
readlink -f /sys/class/net/can0/device/driver
|
||||
~~~
|
||||
|
||||
若未出现 CAN 网络接口,应根据适配器型号、USB VID/PID 和厂家说明安装对应驱动,而不是反复运行 ip link:
|
||||
|
||||
- gs_usb / candleLight 兼容设备使用内核 gs_usb 驱动;仅确认适配器兼容后运行 sudo modprobe gs_usb。
|
||||
- 串口 SLCAN 设备需按厂家串口协议、速率和固件配置 slcan/slcand;普通 USB 串口不自动等于 CAN 接口。
|
||||
- 专有 USB-CAN 设备按其厂家 Linux 文档安装,确认最终提供 SocketCAN 接口。仅有专有动态库、没有 SocketCAN 的设备不能直接替换本项目的 can0。
|
||||
- 若当前内核缺少所需模块,安装匹配当前内核的 Ubuntu 模块包或厂家驱动;不要将 gs_usb 当成所有设备的通用驱动。
|
||||
|
||||
设备空闲且接口已确认对应左手后,加载 CAN 协议模块并配置接口。若已在 1 Mbps 正常运行,仅检查即可,不要在控制期间 down/up:
|
||||
|
||||
~~~bash
|
||||
sudo modprobe can
|
||||
sudo modprobe can_raw
|
||||
sudo ip link set dev can0 down
|
||||
sudo ip link set dev can0 type can bitrate 1000000
|
||||
sudo ip link set dev can0 up
|
||||
ip -details -statistics link show dev can0
|
||||
~~~
|
||||
|
||||
配置网络接口需要管理员权限;Python 抓取程序使用项目 venv,不以 sudo 代替环境安装。确认 CAN_H/CAN_L、参考地、独立供电和总线两端终端电阻符合设备说明;USB 接入不代表手本体已经供电。多适配器情况下先确认接口与设备对应关系,不能假定枚举出的 can0 一定是左手。
|
||||
|
||||
被动查看总线接收帧(不发送位置指令):
|
||||
|
||||
~~~bash
|
||||
timeout 5s candump can0
|
||||
ip -details -statistics link show dev can0
|
||||
.venv/bin/python -c "import can; print(can.__version__)"
|
||||
~~~
|
||||
|
||||
candump 等待到时退出属于正常现象;查询应答型设备在没有查询时可能完全无帧,因此空输出不能单独判故障,接口 UP 也不能证明设备有应答。检查 RX/TX、错误计数及 BUS-OFF 状态,再由项目既有身份/反馈预检确认实际左手。不要用随机 cansend/cangen 帧测试接有真机的总线。上述安装和接口检查不会替代设备身份、标定及执行前检查。
|
||||
|
||||
## 配置
|
||||
|
||||
|
||||
Reference in New Issue
Block a user