- The contents in this chapter corresponds to the
Raspberry Pi 3which will be the main computer of TurtleBot3 Burger and Waffle Pi. Do NOT apply this instruction to your Remote PC (your desktop PC or laptop).
- Setup work requires Power and Time. So battery is not suitable. We recommend using SMPS (AC adapter) during this work.
NOTE: There are two ways to install Linux and ROS to Raspberry Pi 3.
- First method: If you prefer Ubuntu MATE, please take the first method
Install Linux (Ubuntu MATE)below. This method should install the ROS and dependency packages after installing the Linux images. This instruction takes about 1 hours to install ROS and related packages for TurtleBot3.
- Second method: We provide the Linux distro based on Raspbian. They are pre-installed with ROS and ROS-packages related TurtleBot3. It is available immediately without additional installation. If you want to use it, please take the second method
Install Linux based on Raspbianbelow.
WARNING: The microSD card should have at least 8 GB of empty space in order to install Linux (Ubuntu MATE) on Raspberry Pi 3.
[Remote PC] Download
Ubuntu MATE 16.04 image for the Raspberry Pi 3 on your remote PC from the link below.
[Remote PC] In order to write an Ubuntu MATE image to microSD, it is recommended using
GNOME Disks with
Restore Disk Image... option, which natively supports XZ compressed image.
$ sudo apt-get install gnome-disk-utility
TIP: It is recommended using
GNOME Disks, but other applications such as
ddrescue on Linux can be used.
$ sudo apt-get install gddrescue xz-utils $ unxz ubuntu-mate-16.04.2-desktop-armhf-raspberry-pi.img.xz $ sudo ddrescue -D --force ubuntu-mate-16.04.2-desktop-armhf-raspberry-pi.img /dev/sdx
TIP: It is recommended using
GNOME Disks, but other applications such as
Win32 Disk Imager on Windows can be used. Win32 Disk Imager
NOTE: This instruction takes about 1 hours to install ROS and related packages for TurtleBot3. Elapsed time may vary depending on network environment.
[TurtleBot] The following script will allow you to simplify the ROS installation procedure. Run the following command in a terminal window on TurtleBot PC. The terminal application can be found with the Ubuntu search icon on the top left corner of the screen. Shortcut key for terminal is
T. After install ROS, please reboot TurtleBot PC.
$ sudo apt-get update $ sudo apt-get upgrade $ wget https://raw.githubusercontent.com/ROBOTIS-GIT/robotis_tools/master/install_ros_kinetic_rp3.sh && chmod 755 ./install_ros_kinetic_rp3.sh && bash ./install_ros_kinetic_rp3.sh
NOTE: In order to check which packages are installed, please check this link out. install_ros_kinetic_rp3.sh
If you prefer manual installation, please following the link below.
The next step is to install dependent packages for TurtleBot3 control.
[TurtleBot] Download packages from github
$ cd ~/catkin_ws/src $ git clone https://github.com/ROBOTIS-GIT/hls_lfcd_lds_driver.git $ git clone https://github.com/ROBOTIS-GIT/turtlebot3_msgs.git $ git clone https://github.com/ROBOTIS-GIT/turtlebot3.git
NOTE: If you want to use Raspberry Pi Camera, please check related appendix for Raspberry Pi Camera
[TurtleBot] Delete some packages that are not needed in TurtleBot PC
$ cd ~/catkin_ws/src/turtlebot3 $ sudo rm -r turtlebot3_description/ turtlebot3_teleop/ turtlebot3_navigation/ turtlebot3_slam/ turtlebot3_example/
[TurtleBot] Install dependent packages
$ sudo apt-get install ros-kinetic-rosserial-python ros-kinetic-tf
[TurtleBot] After install packages, please reboot Raspberry Pi 3.
[TurtleBot] Build packages
$ source /opt/ros/kinetic/setup.bash $ cd ~/catkin_ws && catkin_make -j1
catkin_make command is completed without any errors, the preparation for TurtleBot3 is done.
[TurtleBot] The following commands allow to use USB port for OpenCR without acquiring root permission.
$ rosrun turtlebot3_bringup create_udev_rules
ROS requires IP addresses in order to communicate between TurtleBot PC and the remote PC. The remote PC and TurtleBot PC should be connected to the same wifi router.
Enter the below command on the terminal window of the TurtleBot PC to find out the IP address of TurtleBot.
Texts in the rectangle is the IP address of the
Enter the following command.
$ nano ~/.bashrc
alt+/ to end line of the file.
localhost in the
ROS_MASTER_URI address with the Remote PC’s IP address acquired from Remote PC Network Configuration. Also replace the
localhost in the
ROS_HOSTNAME address with the IP address acquired from the above terminal window, which is the IP address of TurtleBot PC.
Then, source the bashrc with below command.
$ source ~/.bashrc
WARNING: The SDcard should have at least 8 GB of empty space in order to install Linux on Raspberry Pi 3.
We provide the Linux distro image based on Raspbian. They are pre-installed with ROS and ROS-packages related TurtleBot3. It supports the TurtleBot3 Burger and Waffle Pi model. In this distro image, non-free software like Wolfram, Mathematica, Minecraft Pi and Oracle Java SE are removed.
- Download the Linux distro image based on Raspbian for TurtleBot3
- download link
- SHA256: a82e6dff50d6216ae2f557ebb1d8636af7d6c8a260e8df4f7ae7c9c8bdc0da28
- After download, unzip the downloaded file.
- Guide to burn the image to SD card
- Visit etcher.io and download and install the Etcher SD card image utility.
- Run Etcher and select the Linux image you downloaded on your computer or laptop.
- Select the SD card drive.
- Click Burn to transfer the image to the SD card.
- (other methods to burn) You can use ‘dd’ command in Linux or use application ‘win32diskimager’ in Windows. For a complete guide, take a look here (for Linux users) and here (for Windows users)
After the installation, you can login with username pi and password turtlebot. In this case, you have to connect your Raspberry Pi to your monitor using an HDMI cable, and connect your keyboard and mouse to the Raspberry Pi.
- Expand filesystem to use a whole SD card.
sudo raspi-config (select 7 Advanced Options > A1 Expand Filesystem)
- Synchronize and set computers’ date and time by querying a Network Time Protocol (NTP) server
sudo apt-get install ntpdate sudo ntpdate ntp.ubuntu.com
- If you want to change the Password, Locale and Timezone setting (Optional):
- sudo raspi-config > 1 Change User Password
- sudo raspi-config > 4 Localisation Options > I1 Change Locale
- sudo raspi-config > 4 Localisation Options > I2 Change Timezone
- Network configuration for ROS (reference link)
nano ~/.bashrc (modified the `localhost` below to `Raspberry Pi's IP`) export ROS_MASTER_URI=http://localhost:11311 export ROS_HOSTNAME=localhost
- Once you’re done the wireless configuration, you can connect to Raspberry Pi via SSH from your desktop or laptop (reference link):
ssh firstname.lastname@example.org (The IP 192.168.xxx.xxx is your Raspberry Pi's IP or hostname)
NOTE: Differences from the official Raspbian Stretch
- It based on Raspbian Stretch with desktop, the Raspbian based on Debian Stretch
- Removed non-free software like Wolfram, Mathematica, Minecraft Pi and Oracle Java SE
- Removed libreoffice to reduce image size
- Enabled SSH and Camera function using raspi-config
- Change the password: turtlebot
- Installed software for ROS and TurtleBot3
- ROS Kinetic Kame and dependency software
- raspicam_node package for Raspberry Pi Camera
- hls_lfcd_lds_driver package for Laser Distance Sensor
- turtlebot3 and turtlebot3_msgs packages for TutleBot3
- Installed ROS Packages (132 packages): actionlib, actionlib_msgs, angles, bond, bond_core, bondcpp, bondpy, camera_calibration_parsers, camera_info_manager, catkin, class_loader, cmake_modules, collada_parser, collada_urdf, common_msgs, compressed_image_transport, control_msgs, cpp_common, cv_bridge, diagnostic_aggregator, diagnostic_analysis, diagnostic_common_diagnostics, diagnostic_msgs, diagnostic_updater, diagnostics, dynamic_reconfigure, eigen_conversions, eigen_stl_containers, executive_smach, filters, gencpp, geneus, genlisp, genmsg, gennodejs, genpy, geometric_shapes, geometry, geometry_msgs, hls_lfcd_lds_driver, image_transport, joint_state_publisher, kdl_conversions, kdl_parser, message_filters, message_generation, message_runtime, mk, nav_msgs, nodelet, nodelet_core, nodelet_topic_tools, octomap (plain cmake), opencv3 (plain cmake), orocos_kdl (plain cmake), pluginlib, python_orocos_kdl (plain cmake), python_qt_binding, random_numbers, raspicam_node, resource_retriever, robot, robot_model, robot_state_publisher, ros, ros_base, ros_comm, ros_core, rosbag, rosbag_migration_rule, rosbag_storage, rosbash, rosboost_cfg, rosbuild, rosclean, rosconsole, rosconsole_bridge, roscpp, roscpp_core, roscpp_serialization, roscpp_traits, roscreate, rosgraph, rosgraph_msgs, roslang, roslaunch, roslib, roslint, roslisp, roslz4, rosmake, rosmaster, rosmsg, rosnode, rosout, rospack, rosparam, rospy, rosserial_msgs, rosserial_python, rosservice, rostest, rostime, rostopic, rosunit, roswtf, self_test, sensor_msgs, shape_msgs, smach, smach_msgs, smach_ros, smclib, std_msgs, std_srvs, stereo_msgs, tf, tf_conversions, tf2, tf2_kdl, tf2_msgs, tf2_py, tf2_ros, topic_tools, trajectory_msgs, turtlebot3_bringup, turtlebot3_msgs, urdf, urdf_parser_plugin, visualization_msgs, xacro, xmlrpcpp