mycobot_ros/READMEcn.md
2021-05-06 12:37:06 +08:00

107 lines
2.6 KiB
Markdown

# mycobot_ros
[![jaywcjlove/sb](https://jaywcjlove.github.io/sb/lang/english.svg)](README.md)
[English](README.md) | [中文](READMEcn.md)
![Demo](./Screenshot-1.png)
**注意**:
<!-- This is the mycobot ROS package designed by Zhang Lijun([lijun.zhang@elephantrobotics.com]()) -->
> 请确保顶部的 Atom 烧入 `Atom`,底部的 Basic 烧入 `Transponder`。烧录工具的下载地址: [https://github.com/elephantrobotics/myCobot/tree/main/Software](https://github.com/elephantrobotics/myCobot/tree/main/Software)<br>
> 该包的测试环境:<br> &nbsp;&nbsp;&nbsp;&nbsp; ubuntu: 16.04LTS<br> &nbsp;&nbsp;&nbsp;&nbsp; ros version: 1.12.17
**如果你的`Atom` 是 2.3 或更早的, 或者 `pymycobot` 是 1.\*, 请查看分支 [before](https://github.com/elephantrobotics/myCobotRos/tree/before)**
ROS 下载地址:[http://wiki.ros.org/ROS/Installation](http://wiki.ros.org/ROS/Installation)
## 1. 安装
### 1.1 前提
要使用该包,请确保 [python api](https://github.com/elephantrobotics/pymycobot.git) 已正确安装。
```bash
pip install pymycobot --user
```
### 1.2 Ros 包的下载和安装
将该 ros 包安装到 Catkin 的 src 文件夹中。
```bash
$ cd ~/catkin_ws/src
$ git clone https://github.com/elephantrobotics/mycobot_ros.git
$ cd ~/catkin_ws
$ catkin_make
```
### 1.3 你可以选择测试 Python API
```bash
cd ~/catkin_ws/src/mycobot_ros
python scripts/test.py
```
## 2. 模块
### 2.1 节点
- `display` 展示节点。 同步展示 myCobot 的姿态到仿真的模型。
- `control_slider` 通过滑动条控制 myCobot。
- `control_marker` 通过可交互的标记控制 myCobot。
### 2.2 主题
- `joint_states` - 控制和记录 myCobot 的状态.
```
Message_type: std_msgs/JointState
Data: position[float, float, float, float, float, float]
```
## 3. RViz 可视化
### 3.1 功能
- 可视化 -- `display.launch`: This function will display robot arm movement in realtime when you manually move mycobot.
- 控制 -- `control.launch`: This function will allow you use slider bar to control movement of the robot arm.
### 3.2 启动和运行
- 使用滑块控制
- 启动 ros 和 rviz
```
roslaunch mycobot_ros control_slider.launch
```
- 运行 python 脚本
```
rosrun mycobot_ros control_slider.py
```
- 仿真模型同步机械臂
- 启动 ros 和 rviz
```
roslanuch mycobot_ros mycobot.launch
```
- 运行 python 脚本
```
rosrun mycobot_ros display.py
```
## Q & A
**Q: error[101]**
**A**: 请确保的你的串口没有被占用,以及 Basic 和 Atom 烧入了正确的固件。