Download and Compilation¶
Download¶
To get dynamixel_control_hw, simply clone the source code from https://github.com/resibots/dynamixel_contrl_hw.git with git.
Note
Don’t forget to clone it into your catkin_workspace directory cd $HOME/catkin_ws/src
.
Dependencies¶
python2.x
C++
ROS Control:
apt-get install ros-kinetic-ros-control
Note
You need to store the installation path of libdynamixel in your environment variable inside your ~/.bashrc
file export LIBDYNAMIXEL=/home/USER/Resibots
.
ROS Dependencies :
catkin
rospy
roscpp
urdf
std_msgs
message_generation
hardware_interface
combined_robot_hw
controller_manager
ros-controllers
joint-state-publisher:
apt-get install ros-kinetic-catkin ros-kinetic-rospy ros-kinetic-roscpp ros-kinetic-urdf ros-kinetic-std-msgs ros-kinetic-message-generation ros-kinetic-hardware-interface ros-kinetic-combined-robot-hw ros-kinetic-controller-manager ros-kinetic-ros-controllers ros-kinetic-joint-state-publisher
Building¶
The build system for this package is catkin . Don’t run away yet. Here is how we compile and install it :
Note
don’t forget to install ROS kinetic before and libdynamixel .
- Clone
simply clone the package dynamixel_control_hw in our catkin workspace source folder
cd $HOME/catkin_ws/src git clone https://github.com/resibots/dynamixel_control_hw.git
- Compilation
go into our workspace directory, then compile
cd .. catkin_make
Building the documentation¶
Note
This section is only useful for developers who need to update the documentation.
Install sphinx via pip:
sudo pip install Sphinx
sudo pip install sphinxcontrib-bibtex
Warning
On Mac OSX, do not use brew install sphinx because this is not the right sphinx
Install the Resibots theme for Sphinx:
git clone https://github.com/resibots/sphinx_resibots_theme
export SPHINX_RESIBOTS_THEME="/home/me/path/to/sphinx_resibots_theme"
Install breathe via pip:
sudo pip install breathe
Install doxygen via your package manager (e.g. apt-get / brew):
apt-get install doxygen
create a temporary folder where we generate the documentation:
rm -rf /tmp/doc_dynamixel_control_hw
mkdir /tmp/doc_dynamixel_control_hw
cd /tmp/doc_dynamixel_control_hw
git clone git@github.com:resibots/dynamixel_control_hw.git
cd dynamixel_control_hw/
git checkout doc
cd doc
make html
git checkout gh-pages
cd ..
cp -r doc/_build/html/* .
git add .
git commit -m 'manualy update of the doc [skip ci]'
git push origin gh-pages
rm -rf /tmp/doc_dynamixel_control_hw
Note
in general, we’re using the branch doc to write the documentation and the branch gh-pages which contains html files.
- About sphinx and ReStructuredText:
- Primer for ReStructuredText, the markup language of Sphinx,
- markup specific to Sphinx,
- About C++ in Sphinx
- Breathe (bridge between sphinx and doxygen)