This project includes all necessary files reproduce a simulation of the waveshare Jetbot AI Kit model in rviz and gazebo to visualize the camera, control and navigate the differential drive robot.

At this point we have several algorithms for SLAM and Navigation that you will explore below like gmapping, karto, hector.

I based the structure of this repository using husky, turtlebot3 and Raymon Wijnands for move_base_flex repos mainly. Other repositories like Intel and PAL Robotics are mentioned below.

Several sensors are included in the simulation like:

• 1 x RGB Camera
• 1 x Intel Realsense Depth Camera D435
• 1 x RPLIdar Laser Scan
• 8 x Sonar
• 1 x GPS
• 1 x IMU
• 1 x Odometry (see issues at the end of the document)

All sensors excluding the jetbot camera could be enabled or disabled visually.

NOTE:

• For the realsense you will need to make the plugin first that is included here
• For the IMU, GPS, Odometry and sonar you will need folder hector_gazebo_plugins from here or here
• Several dependencies will be needed, see the package.xml dependencies of each one.

The robot is a WaveShare Jetbot AI Kit and its main goal is navigation.

Below a few image examples of the outcome.

The project tree:

The project is now divided in several folders and now you can easily excecute effectively each file.

NOTE: By default, all sensors are visually enabled.

• Put the ball folder from jetbot_diff_drive/model folder inside ~/.gazebo/models folder to load also the soccer ball.
• See prerequisites on the package.xml of each package.
• Create a ROS ros workspace and compile an empty package:

    cd ~
    mkdir -p catkin_ws/src
    cd catkin_ws
    catkin_make

• Open the .bashrc with nano:

    nano ~/.bashrc

• Insert this line at the end of the ~/.bashrc file for sourcing your workspace:

    source ~/catkin_ws/devel/setup.bash

• Clone this repo in the ~/catkin_ws/src folder by typing:

    cd ~/catkin_ws/src
    git clone https://github.com/issaiass/jetbot_diff_drive --recursive
    git clone https://github.com/issaiass/realsense_gazebo_plugin
    git clone https://github.com/issaiass/hector_gazebo_plugins
    cd ..

• Go to the root folder ~/catkin_ws and make the folder running catkin_make to ensure the application compiles.
• Now you can test in several ways the packages
• For just only the robot description

    # 1st terminal - mount only the robot description
    roslaunch jetbot_description description.launch
    # 2nd terminal (optional) - get the robot description
    rosparam get /robot_description

• Visualizing only the robot
• You could enable more parameters if tab is pressed

    # visualize the robot in rviz
    roslaunch jetbot_viz view_model.launch
    # example... visualize the robot in rviz and disable intel realsense
    roslaunch jetbot_viz view_model.launch realsense_enable:=false

• For just view gazebo simulation (no control)
• There are more parameters for enabling sensors
• Press tab if you want to see all parameters list
• Basic spawning of the robot

    # spawn jetbot model in gazebo in turtlebot3_world
    roslaunch jetbot_gazebo spawn_jetbot.launch
    # example... spawn jetbot model in gazebo, other world
    roslaunch jetbot_gazebo spawn_jetbot.launch world_name:=<your_world>

• For controlling the jetbot in gazebo and visualize in rviz

    # launch the jetbot to control it in gazebo and visualize in rviz simultaneously
    roslaunch jetbot_control control.launch
    # OR
    # Same as above but with multiple terminals (4 terminals to launch)
    roslaunch jetbot_gazebo spawn_jetbot.launch
    roslaunch jetbot_viz view_model.launch
    roslaunch jetbot_control jetbot_controller_manager.launch
    roslaunch jetbot_rqt_robot_steering.launch

Finally, control the robot with the rqt steering controller

• For robot navigation (it is not fine tuned at this checkpoint):

    # 1st terminal, launch gazebo
    roslaunch jetbot_gazebo spawn_jetbot.launch
    # 2nd terminal, launch navigation node (dynamic window approach or time elastic band)
    # <option> = teb or dwa
    roslaunch jetbot_navigation jetbot_navigation.launch local_planner:=<option>
    # 2nd terminal, or launch navigation node (dynamic window approach only)
    # <option> = 0 or 1, 0 = move_base 1 = move_base_flex
    # Let's say we want move_base_flex, then the argument is 1
    roslaunch jetbot_navigation jetbot_navigation.launch move_base_flex:=<option>

• For robot slam:

    # 1st terminal, launch gazebo
    roslaunch jetbot_gazebo spawn_jetbot.launch
    # 2nd terminal, launch slam node
    # <option>: gmapping, hector or karto
    roslaunch jetbot_navigation jetbot_slam.launch slam_methods:=<option>
    # 3rd terminal, launch a controller (option 1)
    roslaunch jetbot_control jetbot_rqt_control_steering.launch
    # 3rd terminal, launch a controller (option 2)
    rosrun jetbot_twist_keyboard teleop_twist_keyboard.py
    # 4rt terminal, save the map when finished
    rosrun map_server map_saver -f <path_and_name_of_map>

• You could enable/disable any sensor in the launch file.
• You must see that roscore and all configurations loading succesfully.