autolabor-c1-doc/pro/quick.md

99 lines
3.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

## 云台相机快速上手指南
### 1. 编译与安装
#### 依赖项:
安装image_proc包用于矫正图像。
```bash
sudo apt-get install ros-noetic-image-proc
```
#### 步骤:
1. 打开终端并导航到你的 ROS 工作空间目录:
```bash
cd ~/catkin_ws
```
2. 下载以下三个包到 `src` 目录下:
- `cv_camera`:用于图像获取和标定数据。
- `pantilt_camera_serial`:用于云台串口驱动,控制云台转动。
- `rviz_pantilt_plugin`:云台控制的 RViz 可视化插件。
3. 进入 `src` 目录后,使用以下命令编译工作空间:
```bash
catkin_make
```
如果你使用的是 `catkin_tools`,则可以使用:
```bash
catkin build
```
4. Source 你的工作空间:
```bash
source ~/catkin_ws/devel/setup.bash
```
### 2. 配置摄像头路径和串口路径
#### 步骤:
1. 找到你的摄像头设备路径和云台串口路径:
```bash
ls /dev/v4l/by-path
```
```bash
ls /dev/ttyUSB*
```
2. 修改 `pantiltcamera.launch` 文件中的 `device_path``port_name` 参数:
- `device_path`:摄像头设备路径,如 `/dev/video0`
- `port_name`:云台控制的串口路径,如 `/dev/ttyUSB0`
3. 确保当前用户有设备操作权限,使用以下命令添加权限:
```bash
sudo usermod -a -G dialout $USER
sudo chmod a+rw /dev/ttyUSB0
sudo chmod a+rw /dev/video0
```
### 3. 启动Launch文件
![ControlPanel](./imgs/control-panel.png)
```bash
roslaunch pantilt_camera_serial pantiltcamera.launch
```
这将启动云台控制节点,允许你通过话题或服务控制云台的转动。
在 RViz 中,你可以通过插件界面实时控制云台,并查看摄像头的图像变化。
### 4. ROS节点说明
#### 节点功能:
- **cv_camera**:用于图像捕获和发布标定数据,提供矫正前后的图像。
- **pantilt_camera_serial**:通过串口控制云台的转动,发布当前的云台角度,并响应来自其他节点的控制命令。
- **rviz_pantilt_plugin**:提供 RViz 可视化控制界面,允许用户通过图形界面控制云台,并查看实时图像。
#### 话题和服务:
- **cv_camera节点**
- 发布话题:
- `/cv_camera/image_raw`:发布原始图像。
- `/cv_camera/camera_info`:发布相机的标定信息。
- **pantilt_camera_serial节点**
- 发布话题:
- `/pantilt_camera_serial/pantilt_angle_info`:发布当前的云台角度信息。
- 订阅话题:
- `/pantilt_camera_serial/pantilt_vel`:接收并执行云台速度控制指令。
- 提供服务:
- `/pantilt_camera_serial/send_command`:允许用户发送控制命令,如设置云台角度、速度等。
- **rviz_pantilt_plugin节点**
- 提供一个交互式界面,通过 RViz 可视化控制云台角度,并显示实时图像。
按照这些步骤操作,你可以快速上手并有效控制你的云台相机系统。