Awesome
Allegro Hand Controller - Noetic
This repository contains the information to setup the ROS Noetic based Allegro Hand controller package which is a part of the official implementation of DIME. We would advice you to run the setup.sh
file in the base repository for convenience and use this as a debugging tool. The base repo containing all the information can be found at DIME - Models.
Contents
Installation Requirements <a name="requirements"></a>
- LibPCAN package
- Allegro Hand v4
Installing Drivers <a name="driver-installation"></a>
Before setting up the controller, we need to ensure that we have all the drivers necessary for establishing communication over the PCAN channel. Make sure to install the following dependencies first before setting up the allegro controller package.
- Install these C++ dependencies:
sudo apt-get install cmake gcc g++ libpopt-dev
- Set up the necessary drivers using the following commands:
cd ../ mkdir drivers && cd drivers wget https://www.peak-system.com/fileadmin/media/linux/files/peak-linux-driver-8.12.0.tar.gz tar -xvzf peak-linux-driver-8.12.0.tar.gz cd peak-linux-driver-8.12.0 make clean make NET=NO_NETDEV_SUPPORT sudo make install sudo modprobe pcan cd .. wget https://www.peak-system.com/quick/BasicLinux tar -xvzf BasicLinux cd PCAN-Basic_Linux-4.5.4/libpcanbasic make sudo make install
- Test the installation of the drivers using the following command:
You will be able to see the pcan driver stream data if you are connected to a PCAN device.cat /proc/pcan
- You can also run the following command to list all the PCAN devices connected to the system:
ls -l /dev/pcan*
- If you do not see any available files, you may need to run:
sudo ./driver/pcan_make_devices 2
- After installing the drivers install ROS followed by it's PCAN package:
sudo apt-get install ros-noetic-libpcan
Setting up DART Sim <a name="dart-sim"></a>
We need to setup DART Sim for the ll4ma-kdl packages to run. Run the following commands:
sudo apt-add-repository ppa:dartsim/ppa
sudo apt-get update
sudo apt-get install libdart6-all-dev
Launching the Controller <a name="launch-controller"></a>
After setting up the drivers and DART sim, you can run catkin_make from the base controller directory (where you have both - Kinova JACO arm controller and Allegro Hand controller). Do the following from this directory:
cd <base-controller-dir>
catkin_make
After you make the binaries, you need to source the setup files using the below command:
source <base-controller-dir>/devel/setup.bash
Then you can launch the Allegro Hand's roslaunch file to start controlling the roslaunch file.
roslaunch allegro_hand allegro_hand.launch
If you want to launch the visualizer along with the roslaunch file, you can run the following command:
roslaunch allegro_hand allegro_hand.launch VISUALIZE:=true
Citation
If you use this repo in your research, please consider citing the paper as follows:
@article{arunachalam2022dime,
title={Dexterous Imitation Made Easy: A Learning-Based Framework for Efficient Dexterous Manipulation},
author={Sridhar Pandian Arunachalam and Sneha Silwal and Ben Evans and Lerrel Pinto},
journal={arXiv preprint arXiv:2203.13251},
year={2022}
}