# RIA-E100-2

**Repository Path**: mkingdragon/ria-e100-2

## Basic Information

- **Project Name**: RIA-E100-2
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-10-28
- **Last Updated**: 2020-12-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# RIA-E100
E100_sim Package

E100_sim is a gazebo simulator. It provides the mobile base robot “ria_e100”  model  with simulated sensors such as the IMU, odometry sensor, and the rplidar, rgbd camra, Other sensor  which can be mounted on the robot.
This package contains some controllers, like teleop in an indoor worlds, a joystick controller. Below we provide the instructions necessary for getting started with the navigation in the simulation world. 


Installation

Note: Following steps are based on UBUNTU 16.04 with ROS-kinetic

This step assumes that your PC is running with Ubuntu 16 and configured with ROS KINETIC and all required libraries 

Creating Work Space and cloning RIA E100 package

     mkdir –p ~/catkin_ws/src
     cd ~/catkin_ws/src
     git clone https://github.com/gaitech-robotics/RIA-E100.git
     cd ~/catkin_ws && catkin_make

Install dependencies 

      sudo apt install ros-kinetic-controller-manager ros-kinetic-gazebo-ros-control ros-kinetic-teleop-twist-keyboard ros-kinetic-teleop-twist-joy ros-kinetic-joy ros-kinetic-slam-gmapping ros-kinetic-hector-mapping ros-kinetic-hector-trajectory-server ros-kinetic-move-base ros-kinetic-map-server ros-kinetic-amcl ros-kinetic-teb-local-planner

Add env variable

       sudo echo "export USE_EKF='true'" >> ~/.bashrc


Basic Usage

First, launch the simulation by use the following:

    $roslaunch e100_sim gazebo.launch 

Note The first run of gazebo might take considerably long, as it will download some models from an online database. 

Getting the robot to move

To let the robot move you need to send velocity command,  There are currently a few ways to send commands to the robot, we will show  them here. We will also show how you can control the robot with a joystick.

• Send direct velocities commands

We will for now just send some constant command velocities to the robot by:
   
     $rostopic pub /ria_base_controller/cmd_vel geometry_msgs/Twist "linear: x: 1.0 y: 0.0 z: 0.0 angular: x: 0.0 y: 0.0 z: 0.0"  



•  Teleop using keyboard

Now, we are goining to send the command to the robot via keypoard by typing the following:
        
        $ roslaunch e100_sim keyboard.launch 

• Usage with a joystick

Connect a USB joystick to your computer and launch the file(Please check the js port number,default is js1. You can change in the launch file.):

       $ roslaunch e100_teleop joy.launch 
        


Navigation

Create a map using slam_gmapping:

First launch the robot in the  simulation world by:

       $ roslaunch e100_sim gazebo.launch 

Now launch the joy node: 
             
       $roslaunch e100_teleop joy.launch

Further, we need to launch the gmapping slam by:

       $roslaunch e100_navigation slam_gmapping.launch

And start move around in the whole environment, open rviz and visualize.







The last step you have to save the map using the following:

      $ rosrun map_server map_saver -f office_map


It is recommended to save the map in the path: 

        ~/catkin_ws/src/ria_e100/e100_navigation/maps


The last step is to launch the navigation file by: 

      $ roslaunch e100_navigation navigation.launch  






Note: Gazebo Version,
It is recommended to install at least Gazebo v7.x for full functionlity, (which is installed by default with ROS Kinetic). 

For more demos, please visit the official wiki here 

https://edu.gaitech.hk/ria_e100/installation.html#installation