Elfin Robot

If you don't speak chinese, please click here

本文件夹中包含了多个为Elfin机器人提供ROS支持的软件包。推荐的运行环境为 Ubuntu 16.04 + ROS Kinetic 或 Ubuntu 14.04 + ROS Indigo，其他环境下的运行情况没有测试过。

安装软件包

Ubuntu 16.04 + ROS Kinetic

安装一些重要的依赖包

$ sudo apt-get install ros-kinetic-soem ros-kinetic-gazebo-ros-control ros-kinetic-ros-control ros-kinetic-ros-controllers

安装和升级MoveIt!, 注意因为MoveIt!最新版进行了很多的优化，如果你已经安装了MoveIt!, 也请一定按照以下方法升级到最新版。

安装/升级MoveIt!：

$ sudo apt-get update
$ sudo apt-get install ros-kinetic-moveit

安装本软件包

首先创建catkin工作空间 (教程)。然后将本文件夹克隆到src/目录下，之后用catkin_make来编译。
假设你的工作空间是~/catkin_ws，你需要运行的命令如下：

$ cd ~/catkin_ws/src
$ git clone -b kinetic-devel https://github.com/hans-robot/elfin_robot.git
$ cd ..
$ catkin_make
$ source devel/setup.bash

Ubuntu 14.04 + ROS Indigo

安装一些重要的依赖包

$ sudo apt-get install ros-indigo-soem ros-indigo-gazebo-ros-control ros-indigo-ros-control ros-indigo-ros-controllers

安装和升级MoveIt!, 注意因为MoveIt!最新版进行了很多的优化，如果你已经安装了MoveIt!, 也请一定按照以下方法升级到最新版。

安装/升级MoveIt!：

$ sudo apt-get update
$ sudo apt-get install ros-indigo-moveit
$ sudo apt-get install ros-indigo-moveit-full-pr2
$ sudo apt-get install ros-indigo-moveit-kinematics
$ sudo apt-get install ros-indigo-moveit-ros-move-group

安装本软件包

首先创建catkin工作空间 (教程)。然后将本文件夹克隆到src/目录下，之后用catkin_make来编译。
假设你的工作空间是~/catkin_ws，你需要运行的命令如下：

$ cd ~/catkin_ws/src
$ git clone -b indigo-devel https://github.com/hans-robot/elfin_robot.git
$ cd ..
$ catkin_make
$ source devel/setup.bash

使用仿真模型

下面给出的是启动Elfin3的一系列命令。启动Elfin5和Elfin10的方法与之类似，只要在相应的地方替换掉相应的前缀即可。

用Gazebo仿真请运行：

$ roslaunch elfin_gazebo elfin3_empty_world.launch

运行MoveIt!模块, RViz界面:

$ roslaunch elfin3_moveit_config moveit_planning_execution.launch

如果你此时不想运行RViz界面，请用以下命令:

$ roslaunch elfin3_moveit_config moveit_planning_execution.launch display:=false

运行后台程序及Elfin Control Panel界面：

$ roslaunch elfin_basic_api elfin_basic_api.launch

关于MoveIt!的使用方法可以参考docs/moveit_plugin_tutorial.md
Tips:
每次规划路径时，都要设置初始位置为当前位置。

如果你有手柄的话，可以运行以下程序开启手柄遥控功能：

$ roslaunch elfin3_moveit_config joystick_control.launch

关于手柄遥控的使用方法可以参考下面的链接：
http://docs.ros.org/indigo/api/moveit_tutorials/html/doc/ros_visualization/joystick.html
Tips:

In the Motion Planning plugin of Rviz, enable “Allow External Comm.” checkbox in the “Planning” tab.

Add “Pose” to rviz Displays and subscribe to /joy_pose in order to see the output from joystick. Note that only planning groups that have IK solvers for all their End Effector parent groups will work.

更多关于API的信息请看docs/API_description.md

使用真实的Elfin机器人

下面给出的是启动Elfin3的一系列命令。启动Elfin5和Elfin10的方法与之类似，只要在相应的地方替换掉相应的前缀即可。

先把购买机器人时得到的elfin_drivers.yaml放到elfin_robot_bringup/config/文件夹下。

将Elfin通过网线连接到电脑。先通过ifconfig指令来确定与Elfin连接的网卡名称。本软件包默认的名称是eth0 。假如当前名称不是eth0的话，请对elfin_robot_bringup/config/elfin_drivers.yaml的相应部分进行修改。

elfin_ethernet_name: eth0

加载Elfin机器人模型：

$ roslaunch elfin_robot_bringup elfin3_bringup.launch

启动Elfin硬件，Elfin的控制需要操作系统的实时性支持，运行下面的命令前请先为你的Linux系统内核打好实时补丁。打补丁的方法可以参考这个教程。Elfin机械臂有两种不同版本的EtherCAT从站，在启动硬件前，请先确认你的Elfin的从站版本。

$ sudo chrt 10 bash
$ roslaunch elfin_robot_bringup elfin_ros_control.launch

或

$ sudo chrt 10 bash
$ roslaunch elfin_robot_bringup elfin_ros_control_v2.launch