A ROS package to control the KUKA LWR 4 (both simulation and physical robot). This was originally forked from CentroEPiaggio/kuka-lwr.
Do the following steps:
- In your catkin src directory clone the repository
$ git clone https://github.com/epfl-lasa/kuka-lwr-ros.git
- wstool gets all other git repository dependencies, after the following steps you should see extra catkin packages in your src directory.
$ wstool init $ wstool merge kuka-lwr-ros/dependencies.rosinstall $ wstool up
- Query and installs all libraries and packages
$ rosdep install --from-paths . --ignore-src --rosdistro indigo
- Install Gazebo, follow this link for instructions on how to install it on ubuntu. Make sure that the ros libraries of Gazebo are also installed:
$ sudo apt-get install ros-indigo-gazeboX-*
$ sudo apt-get install ros-indigo-gazebo-ros-pkgs ros-indigo-gazebo-ros-control $ sudo apt-get install ros-indigo-ros-control ros-indigo-ros-controllers
Software Version Combinations
- ROS-Indigo + Gazebo2 (If you are having troubles starting-up the simulation, you need to install Gazebo7)
- ROS-Kinetic + Gazebo7
- Install move_it_library
sudo apt-get install ros-indigo-moveit
If not yet installed, c++ library is needed:
sudo apt-get install libncurses5-dev libncursesw5-dev
Set of packages for simulating and controlling the KUKA Light Weight Robot (LWR).
kuka_lwr contains URDF robot description, hardware interface, controllers with configuration files.
lwr_ros_client basic implemenation of action handling such that it is easy to call different types of policies.
robot_motion_generation utilities such as filters for smoothing robot motion.
kuka-lwr-ros-examples set of examples.
Quick Start (Simulation)
Download the kuka-lwr-ros-examples into your catkin_ws and after compling them are ready to run the lwr_simple_example.
Open a new terminal and run the following:
$ roslaunch lwr_simple_example sim.launch
This will run the simulator and the Gazebo simulator and ROS Rviz visualiser GUIs should both open. If the Gazebo window does not open this is because a flag is set in the sim.launch file. In the caption below Rviz is on the left and Gazebo is on the right.
Now that the simulations are up and running we are ready to control the robot. In on terminal run the following:
$ roslaunch lwr_simple_example client.launch
and in another:
$ roslaunch lwr_simple_example console.launch
Notice on the bottom right console the heading is "KUKA PLANNING INTERFACE" and a prompt Cmd>. This is the main interface from which you will be starting and stopping policies to be run on the robot. If you press tab (in this console window) a list of possible actions (robot policies) will be displayed, which in the simple example case are; go_front, go_home, go_left, grav_comp and linear (note that grav_comp only works on the real physical robot).
Quick start (real robot)
You first have to make sure that your network configurations are set correctly and you can ping the robot. If you are unsure about this, take a look at Network setup
Once the robot is turned on and you have loaded your script open the FRI such that in the KUKA interface you see the following message: FRI-Ctrl FRI successfully opened.
In a terminal run the following:
$ roslaunch lwr_simple_example real.launch
$ roslaunch lwr_fri lwr_fri_console.launch
Here you can see all the different state information of the robot. You can notice that the FRI State is in MONITOR mode which means that you cannot control the robot for the moment. Next go to this console and press tab. You will see that a control cmd is avaiable. Now we are going to change the FRI State to COMMAND which will allow use to run the simple example (see quick start simulation). In the terminal type the follwoing:
In the terminal where you run real.lauch you will see the lign: Waiting for script.... This statement means that you have to press the green button on the KUKA interface panel until you hear a click originating from the robot.
Once this is down you will see in the FRI terminal that the FRI State is now in COMMAND mode and that the Drives are in state GO.
To send actions to the robot proceed as in Quick start (simulation). Essentially open two new terminals and launch the simple client and server nodes.
If the real-time control interface is not working, you might need to provide your user name with real time priority and memlock limits higher than the default ones. You can do it permanently like this:
sudo nano /etc/security/limits.confand add these lines:
YOUR_USERNAME hard rtprio 95 YOUR_USERNAME soft rtprio 95 YOUR_USERNAME hard memlock unlimited YOUR_USERNAME soft memlock unlimited
sudo nano /etc/pam.d/common-sessionand add
session required pam_limits.so
- Reboot, open a terminal, and check that
ulimit -r -lgives you the values set above.