Niryo One ROS stack
Switch branches/tags
Nothing to show
Clone or download
Latest commit 6a9d36c Nov 23, 2018
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
dynamixel_sdk Optimize write operations on Dynamixel bus Apr 13, 2018
mcp_can_rpi Add some documentation Dec 22, 2017
niryo_one 2.1.0 Nov 23, 2018
niryo_one_bringup 2.1.0 Nov 23, 2018
niryo_one_commander 2.1.0 Nov 23, 2018
niryo_one_debug 2.1.0 Nov 23, 2018
niryo_one_description 2.1.0 Nov 23, 2018
niryo_one_driver 2.1.0 Nov 23, 2018
niryo_one_modbus 2.1.0 Nov 23, 2018
niryo_one_moveit_config 2.1.0 Nov 23, 2018
niryo_one_msgs 2.1.0 Nov 23, 2018
niryo_one_python_api 2.1.0 Nov 23, 2018
niryo_one_rpi 2.1.0 Nov 23, 2018
niryo_one_tools 2.1.0 Nov 23, 2018
niryo_one_user_interface 2.1.0 Nov 23, 2018
.gitignore Update gitignore Nov 14, 2018
LICENSE Initial commit Nov 23, 2017
README.md Update README Nov 23, 2018

README.md

Niryo One ROS stack

(Niryo One : https://niryo.com)

niryo one rviz simulation

This repository contains all ROS packages used on Niryo One (Raspberry Pi 3B - Xubuntu for ARM).

How to use Niryo One with a graphical interface ?

You can download Niryo One Studio (Linux, Windows and MacOS compatible).

How to install Niryo One ROS packages on your computer (x86) - Simulation Mode

Requirements :

  • Ubuntu 16.04
  • ROS kinetic (other versions are not supported)

First install ROS kinetic "Desktop-Full" (tutorial here).

You'll need to install some additional ROS packages :

sudo apt-get install ros-kinetic-robot-state-publisher ros-kinetic-moveit ros-kinetic-rosbridge-suite ros-kinetic-joy ros-kinetic-ros-control ros-kinetic-ros-controllers ros-kinetic-tf2-web-republisher

You'll also need to install an additional Python module :

sudo -H pip install jsonpickle

Create a catkin workspace and clone Niryo One ROS stack :

mkdir -p ~/catkin_ws/src
cd ~/catkin_ws/src
git clone https://github.com/NiryoRobotics/niryo_one_ros.git .

Build the packages :

cd ~/catkin_ws
catkin_make

Don't forget to use those commands before you try to launch anything (you can add them in your .bashrc) :

source /opt/ros/kinetic/setup.bash
source ~/catkin_ws/devel/setup.bash

You can now launch Rviz with Niryo One (only display mode with some cursors to move the joints):

roslaunch niryo_one_description display.launch

You can also launch the complete Niryo One ROS Stack instead, which you can control from Niryo One Studio.

roslaunch niryo_one_bringup desktop_rviz_simulation.launch

The main differences between this launch file and the launch file executed on Raspberry Pi 3B (rpi_setup.launch) is that the hardware functionalities are disabled, and you get a 3D simulation view with Rviz.

Note that Niryo One ROS packages have been developed with ROS kinetic, on Ubuntu 16.04. Other ROS versions and OS distributions are not supported.


(Optional) After you install ROS packages and execute catkin_make you still have some installation steps if you want to use Blockly ("Niryo Blocks" on Niryo One Studio).

Make sure that you have a recent nodejs version (not the default installed one)

curl -sL https://deb.nodesource.com/setup_8.x | sudo -E bash -
sudo apt-get install -y nodejs

Install node modules in the blockly_code_generator directory (where you can find package.json) and create an executable.

cd ~/catkin_ws/src/niryo_one_user_interface/blockly_code_generator
npm install
sudo npm link

That's it, you have now all the Niryo One functionalities ready to be used.

Niryo One ROS Stack overview

Here's a global overview of the Niryo One ROS Stack :

niryo one ros stack - global overview

You can find more specific and detailed info in each package's README.

Developer Documentation

Any question ?

If you have a question and you don't find the answer here or on our documentation, please send us a message.

Thank you !