ROS¶

This section will show you how to use Mech-Eye SDK on ROS on Ubuntu.

Requirements¶

Operating system: Ubuntu.
ROS installed according to instructions on Documentation of ROS.

Note:

In the example below, the Ubuntu system’s version is 18.04, but the installation of ROS will be different for different versions of Ubuntu systems.
If using a virtual machine to install the software, please reserve more than 20G of disk space; otherwise, the installation may fail.
If after following the instructions below, you can run turtlesim normally, you have successfully installed ROS.
# Open a terminal in any directory and enter the command: roscore # Open a second terminal and enter the command: rosrun turtlesim turtlesim_node # Open a third terminal and enter the command: rosrun turtlesim turtle_teleop_key
After executing the above command, in the third terminal window, you will be able to control the little turtle by pressing the up, down, left, and right keys on the keyboard, as shown in the figure below.

Instructions¶

Install Mech-Eye SDK for Ubuntu¶

Please see :ref: ref-install-sdk-on-ubuntu for instructions on installing.

Install ROS API¶

Install libzmq5 and libzmq3-dev. .. code-block:: sh

sudo apt install libzmq5 libzmq3-dev

Create directory ~/ros_ws/src and open it.

mkdir -p ~/ros_ws/src && cd ~/ros_ws/src

Clone repository mecheye_ros_interface to directory ~/ros_ws/src.

git clone https://github.com/MechMindRobotics/mecheye_ros_interface

Open directory ~/ros_ws and build.
```
cd ~/ros_ws && catkin_make
```
Modify the files.
- If you need to store the images, please change false to true in the line <arg name="save_file" default="true"/> in the file ~/ros_ws/src/mecheye_ros_interface/launch/start_camera.launch.
- The path to store the images can be modified in the file ~/ros_ws/src/mecheye_ros_interface/src/main.cpp.

Run the Service¶

Open a new terminal and run the following command to start the service.

source ~/ros_ws/devel/setup.bash
roslaunch mecheye_ros_interface start_camera.launch

The output is as follows:

... logging to /home/mechmind/.ros/log/69ffe3a2-d290-11ec-828a-000c29351753/roslaunch-ubuntu-4349.log
Checking log directory for disk usage. This may take a while.
Press Ctrl-C to interrupt
Done checking log file disk usage. Usage is <1GB.

started roslaunch server http://ubuntu:38711/

SUMMARY
========

PARAMETERS
    * /mechmind_camera_start/camera_ip: 192.168.0.123
    * /mechmind_camera_start/fx: 1727.46410256
    * /mechmind_camera_start/fy: 1727.45869267
    * /mechmind_camera_start/save_file: False
    * /mechmind_camera_start/u: 655.818082573
    * /mechmind_camera_start/use_external_intri: False
    * /mechmind_camera_start/v: 516.630650061
    * /rosdistro: melodic
    * /rosversion: 1.14.13

NODES
    /
    mechmind_camera_start (mecheye_ros_interface/start)

auto-starting new master
process[master]: started with pid [4359]
ROS_MASTER_URI=http://localhost:11311

setting /run_id to 69ffe3a2-d290-11ec-828a-000c29351753
process[rosout-1]: started with pid [4370]
started core service [/rosout]
process[mechmind_camera_start-2]: started with pid [4377]
Find Mech-Eye devices...
Mech-Eye device index : 0
............................
Camera Model Name: Mech-Eye Pro M Enhanced
Camera ID:         Sample
Camera IP Address: 192.168.xx.xx
Hardware Version:  Vx.x.x
Firmware Version:  Vx.x.x
............................
Please enter the device index you want to connect: 0
Connected to the Mech-Eye device successfully.
............................
Camera Model Name: Mech-Eye Nano
Camera ID:         TAM06218A3020706
Camera IP Address: 192.168.xx.xx
Hardware Version:  Vx.x.x
Firmware Version:  Vx.x.x
............................

Open another new terminal and run the following command to capture images.
source ~/ros_ws/devel/setup.bash rosservice call /run_mechmind_camera
The output is as follows:
success: True message: ''
At this point, the camera has started working. Data such as 2D images and depth maps are saved in the folder /tmp by default.

Attention

Every time you modify a file under ~/ros_ws/src/mecheye_ros_interface/src, please do cd ~/ros_ws && catkin_make to update the executable.