SBC Setup

If you are using Intel Joule, please refer to Intel Joule Setup instruction.

Prepare microSD Card and Reader

If you PC do not have a microSD slot, please use a microSD card reader to burn the recovery image.

Download TurtleBot3 SBC Image

Download the correct image file for your hardware and ROS version.
Kinetic version images use Raspberry Pi OS(Raspbian OS).

The recovery image files can be modified without a prior notice.

Raspberry Pi 4 does not support Ubuntu 16.04 nor Debian Jessie, therefore, ROS Kinetic is not supported.

Unzip the downloaded image file

Extract the .img file and save it in the local disk.

Burn the image file

You can use various image burning tools.
For example, Raspberry Pi Imager or Linux Disks utility can be used.
Choose your preferred tool to burn the image to microSD.

Raspberry Pi Imager

Please refer to this article to find more information about Raspberry Pi Imager.

1. Click CHOOSE OS.
2. Click Use custom and select the extracted .img file from local disk.
3. Click CHOOSE STORAGE and select the microSD.
4. Click WRITE to start burning the image.

Disks Utility

Disks utility is included in recent Ubuntu Desktop. Search for “Disks” and launch the app.

1. Select the microSD card in the left panel.
2. Select Restore Disk Image option.
3. Open the .img file from local disk.
4. Click Start Restoring... > Restore button.

Boot Up the Raspberry Pi

1. Connect the HDMI cable of the monitor to the HDMI port of Raspberry Pi.
2. Connect input devices to the USB port of Raspberry Pi
3. Insert the microSD card.
4. Connect the power (either with USB or OpenCR) to turn on the Raspberry Pi.

Configure the Raspberry Pi

NOTE : If you encounter apt failures about the ROS GPG key (due to the existing GPG expiration), you may need to update GPG key. Please see ROS GPG Key Expiration Incident, and proceed to the given solution.

1. After Raspbian OS is up and running, connect to the WiFi network that is connected with the PC.
2. Find the assigned IP address for Raspberry Pi with the command below. Usually wireless IP address for Raspberry Pi can be found under the wlan0 section.

   $ ifconfig
   

3. From your PC, open the terminal and connect to the Raspberry Pi with its IP address.
   The default password is set as turtlebot.

   $ ssh pi@{IP_ADDRESS_OF_RASPBERRY_PI}
   

4. Once logged in to the Raspberry Pi, execute the commands below to sync time.

   $ sudo apt-get install ntpdate
   $ sudo ntpdate ntp.ubuntu.com
   

5. Load Raspberry Pi configuration interface.

   $ sudo raspi-config
   

6. Select Advanced Options > Expand Filesystem and exit.
7. Network configuration for ROS

   $ nano ~/.bashrc
   

8. Go to the end of file with Ctrl+END or Alt+/, then modify the IP adddresses of ROS_MASTER_URI and the ROS_HOSTNAME.

   export ROS_MASTER_URI=http://{IP_ADDRESS_OF_REMOTE_PC}:11311
   export ROS_HOSTNAME={IP_ADDRESS_OF_RASPBERRY_PI_3}
   

9. Save the file and exit the nano editor.
10. Apply changes with the command below.

    $ source ~/.bashrc
    

NEW LDS-02 Configuration

The TurtleBot3 LDS has been updated to LDS-02 since 2022 models.
Please follow the instructions below on the SBC (Raspberry Pi) of TurtleBot3.

LDS-01	LDS-02

1. Install the LDS-02 driver and update TurtleBot3 package.

   $ sudo apt update
   $ sudo apt install libudev-dev
   $ cd ~/catkin_ws/src
   $ git clone -b develop https://github.com/ROBOTIS-GIT/ld08_driver.git
   $ cd ~/catkin_ws/src/turtlebot3 && git pull
   $ rm -r turtlebot3_description/ turtlebot3_teleop/ turtlebot3_navigation/ turtlebot3_slam/ turtlebot3_example/
   $ cd ~/catkin_ws && catkin_make
   

2. Export the LDS_MODEL to the bashrc file. Depending on your LDS model, use LDS-01 or LDS-02.

   $ echo 'export LDS_MODEL=LDS-02' >> ~/.bashrc
   

3. Apply changes with the command below.

   $ source ~/.bashrc
   

SBC Setup

Prepare microSD Card and Reader

If you PC do not have a microSD slot, please use a microSD card reader to burn the recovery image.

Download TurtleBot3 SBC Image

Download the correct image file for your hardware and ROS version.
Melodic version images are created based on Ubuntu 18.04.

The recovery image files can be modified without a prior notice.

Unzip the downloaded image file

Extract the .img file and save it in the local disk.

Burn the image file

You can use various image burning tools.
For example, Raspberry Pi Imager or Linux Disks utility can be used.
Choose your preferred tool to burn the image to microSD.

Raspberry Pi Imager

Please refer to this article to find more information about Raspberry Pi Imager.

1. Click CHOOSE OS.
2. Click Use custom and select the extracted .img file from local disk.
3. Click CHOOSE STORAGE and select the microSD.
4. Click WRITE to start burning the image.

Disks Utility

Disks utility is included in the recent Ubuntu Desktop. Search for “Disks” and launch the app.

1. Select the microSD card in the left panel.
2. Select Restore Disk Image option.
3. Open the .img file from local disk.
4. Click Start Restoring... > Restore button.

Resize the Partition

In order to reduce the size of recovery image file and to decrease the time to burn the image onto microSD, the recovery partition is minimized.
Please resize the partition to use the unallocated space.

Be aware of selecting an incorrect disk or a partition. Partitioning a system disk of your PC may cause a serious system malfunction.

Download or install GParted GUI tool

1. Select microSD card from the menu (mounted location may vary by system).
2. Right click on the yellow partition.
3. Select Resize/Move option.
4. Drag the right edge of the partition to all the way to the right end.
5. Click Resize/Move button.
6. Click the Apply All Operations green check button at the top.

Configure the WiFi Network Setting

NOTE : If you encounter apt failures about the ROS GPG key (due to the existing GPG expiration), you may need to update GPG key. Please see ROS GPG Key Expiration Incident, and proceed to the given solution.

1. Open a terminal window with Alt+Ctrl+T and go to the netplan directory in the microSD card.
   Start editing the 50-cloud-init.yaml file with a superuser permission sudo.

   $ cd /media/$USER/writable/etc/netplan
   $ sudo nano 50-cloud-init.yaml
   

   When the editor is opened, replace the WIFI_SSID and WIFI_PASSWORD with your wifi SSID and password.
   
   Save the file with Ctrl+S and exit with Ctrl+X.
   

If “No such file or directory” is returned, make sure the microSD is mounted to the system.

1. Boot Up the Raspberry Pi
   a. Connect the HDMI cable of the monitor to the HDMI port of Raspberry Pi.
   b. Connect input devices to the USB port of Raspberry Pi.
   c. Insert the microSD card.
   d. Connect the power (either with USB or OpenCR) to turn on the Raspberry Pi.
   e. Login with ID ubuntu and PASSWORD turtlebot.

HDMI cable has to be connected before powering the Raspberry Pi, or else the HDMI port of the Raspberry Pi will be disabled.

ROS Network Configuration

Please follow the instructions below on the SBC (Raspberry Pi).

1. Confirm the WiFi IP address.

   $ ifconfig
   

2. Edit the .bashrc file.

   $ nano ~/.bashrc
   

3. Find the ROS_MASTER_URI and ROS_HOSTNAME setting section, then modify the IP adddresses accordingly.

   export ROS_MASTER_URI=http://{IP_ADDRESS_OF_REMOTE_PC}:11311
   export ROS_HOSTNAME={IP_ADDRESS_OF_RASPBERRY_PI_3}
   

4. Save the file with Ctrl + S and exit the nano editor with Ctrl + X.

5. Apply changes with the command below.

   $ source ~/.bashrc
   

   

NEW LDS-02 Configuration

LDS-01	LDS-02

The TurtleBot3 LDS has been updated to LDS-02 since 2022 models.
Please follow the instructions below on the SBC (Raspberry Pi) of TurtleBot3.

1. Install the LDS-02 driver and update TurtleBot3 package

   $ sudo apt update
   $ sudo apt install libudev-dev
   $ cd ~/catkin_ws/src
   $ git clone -b develop https://github.com/ROBOTIS-GIT/ld08_driver.git
   $ cd ~/catkin_ws/src/turtlebot3 && git pull
   $ rm -r turtlebot3_description/ turtlebot3_teleop/ turtlebot3_navigation/ turtlebot3_slam/ turtlebot3_example/
   $ cd ~/catkin_ws && catkin_make
   

2. Export the LDS_MODEL to the bashrc file. Depending on your LDS model, use LDS-01 or LDS-02.

   $ echo 'export LDS_MODEL=LDS-02' >> ~/.bashrc
   $ source ~/.bashrc
   

This is it! Now you are done with SBC setup :)
Next Step : OpenCR Setup

SBC Setup

Prepare microSD Card and Reader

If you PC do not have a microSD slot, please use a microSD card reader to burn the recovery image.

Download TurtleBot3 SBC Image

Download the correct image file for your hardware and ROS version.
Noetic version images are created based on Ubuntu 20.04.

The recovery image files can be modified without a prior notice.

Unzip the downloaded image file

Extract the .img file and save it in the local disk.

Burn the image file

You can use various image burning tools.
For example, Raspberry Pi Imager or Linux Disks utility can be used.
Choose your preferred tool to burn the image to microSD.

Raspberry Pi Imager

Please refer to this article to find more information about Raspberry Pi Imager.

1. Click CHOOSE OS.
2. Click Use custom and select the extracted .img file from local disk.
3. Click CHOOSE STORAGE and select the microSD.
4. Click WRITE to start burning the image.

Disks Utility

Disks utility is included in the recent Ubuntu Desktop. Search for “Disks” and launch the app.

1. Select the microSD card in the left panel.
2. Select Restore Disk Image option.
3. Open the .img file from local disk.
4. Click Start Restoring... > Restore button.

Resize the Partition

In order to reduce the size of recovery image file and to decrease the time to burn the image onto microSD, the recovery partition is minimized.
Please resize the partition to use the unallocated space.

Be aware of selecting an incorrect disk or a partition. Partitioning a system disk of your PC may cause a serious system malfunction.

Download or install GParted GUI tool

1. Select microSD card from the menu (mounted location may vary by system).
2. Right click on the yellow partition.
3. Select Resize/Move option.
4. Drag the right edge of the partition to all the way to the right end.
5. Click Resize/Move button.
6. Click the Apply All Operations green check button at the top.

Configure the WiFi Network Setting

1. Open a terminal window with Alt+Ctrl+T and go to the netplan directory in the microSD card.
   Start editing the 50-cloud-init.yaml file with a superuser permission sudo.

   $ cd /media/$USER/writable/etc/netplan
   $ sudo nano 50-cloud-init.yaml
   

   When the editor is opened, replace the WIFI_SSID and WIFI_PASSWORD with your wifi SSID and password.
   
   Save the file with Ctrl+S and exit with Ctrl+X.
   

If “No such file or directory” is returned, make sure the microSD is mounted to the system.

1. Boot Up the Raspberry Pi
   a. Connect the HDMI cable of the monitor to the HDMI port of Raspberry Pi.
   b. Connect input devices to the USB port of Raspberry Pi.
   c. Insert the microSD card.
   d. Connect the power (either with USB or OpenCR) to turn on the Raspberry Pi.
   e. Login with ID ubuntu and PASSWORD turtlebot.

HDMI cable has to be connected before powering the Raspberry Pi, or else the HDMI port of the Raspberry Pi will be disabled.

ROS Network Configuration

NOTE : If you encounter apt failures about the ROS GPG key (due to the existing GPG expiration), you may need to update GPG key. Please see ROS GPG Key Expiration Incident, and proceed to the given solution.

Please follow the instructions below on the SBC (Raspberry Pi).

1. Confirm the WiFi IP address.

   $ ifconfig
   

2. Edit the .bashrc file.

   $ nano ~/.bashrc
   

3. Find the ROS_MASTER_URI and ROS_HOSTNAME setting section, then modify the IP adddresses accordingly.

   export ROS_MASTER_URI=http://{IP_ADDRESS_OF_REMOTE_PC}:11311
   export ROS_HOSTNAME={IP_ADDRESS_OF_RASPBERRY_PI_3}
   

4. Save the file with Ctrl + S and exit the nano editor with Ctrl + X.

5. Apply changes with the command below.

   $ source ~/.bashrc
   

   

NEW LDS-02 Configuration

LDS-01	LDS-02

The TurtleBot3 LDS has been updated to LDS-02 since 2022 models.
Please follow the instructions below on the SBC (Raspberry Pi) of TurtleBot3.

1. Install the LDS-02 driver and update TurtleBot3 package

   $ sudo apt update
   $ sudo apt install libudev-dev
   $ cd ~/catkin_ws/src
   $ git clone -b develop https://github.com/ROBOTIS-GIT/ld08_driver.git
   $ cd ~/catkin_ws/src/turtlebot3 && git pull
   $ rm -r turtlebot3_description/ turtlebot3_teleop/ turtlebot3_navigation/ turtlebot3_slam/ turtlebot3_example/
   $ cd ~/catkin_ws && catkin_make
   

2. Export the LDS_MODEL to the bashrc file. Depending on your LDS model, use LDS-01 or LDS-02.

   $ echo 'export LDS_MODEL=LDS-02' >> ~/.bashrc
   $ source ~/.bashrc
   

This is it! Now you are done with SBC setup :)
Next Step : OpenCR Setup

SBC Setup

Prepare microSD Card and Reader

If you PC do not have a microSD slot, please use a microSD card reader to burn the recovery image.

Download SBC OS Image

Download the correct image file for your hardware and ROS version.
ROS2 Dashing requires Ubuntu 18.04.

Unzip the downloaded image file

Extract the .img file and save it in the local disk.

Burn the image file

You can use various image burning tools.
For example, Raspberry Pi Imager or Linux Disks utility can be used.
Choose your preferred tool to burn the image to microSD.

Raspberry Pi Imager

Please refer to this article to find more information about Raspberry Pi Imager.

1. Click CHOOSE OS.
2. Click Use custom and select the extracted .img file from local disk.
3. Click CHOOSE STORAGE and select the microSD.
4. Click WRITE to start burning the image.

Disks Utility

Disks utility is included in the recent Ubuntu Desktop. Search for “Disks” and launch the app.

1. Select the microSD card in the left panel.
2. Select Restore Disk Image option.
3. Open the .img file from local disk.
4. Click Start Restoring... > Restore button.

Boot Up the Raspberry Pi

1. Connect the HDMI cable of the monitor to the HDMI port of Raspberry Pi.
2. Connect input devices to the USB port of Raspberry Pi
3. Insert the microSD card.
4. Connect the power (either with USB or OpenCR) to turn on the Raspberry Pi.
5. Login with ID ubuntu and PASSWORD ubuntu.
   Once logged in, the system will request to change the password.

HDMI cable has to be connected before powering the Raspberry Pi, or else the HDMI port of the Raspberry Pi will be disabled.

Configure the Raspberry Pi

1. Open automatic update setting file.

   $ sudo nano /etc/apt/apt.conf.d/20auto-upgrades
   

2. Edit to disable automatic update settings as below.

   APT::Periodic::Update-Package-Lists "0";
   APT::Periodic::Unattended-Upgrade "0";
   

   Save the file with Ctrl+S and exit with Ctrl+X.

3. Enter below command to configure the WiFi network setting.

   $ sudo nano /etc/netplan/50-cloud-init.yaml
   

4. When the editor is opened, append below contents at the end of the file.
   Replace the WIFI_SSID and WIFI_PASSWORD with your wifi SSID and password.
   
   Save the file with Ctrl+S and exit with Ctrl+X.

5. Apply all configuration for the renderers, and then reboot the Raspberry Pi.

   $ sudo netplan apply
   $ reboot
   

6. Set the systemd to prevent boot-up delay even if there is no network at startup. Run the command below to set mask the systemd process using the following command.

   $ systemctl mask systemd-networkd-wait-online.service
   

7. Disable Suspend and Hibernation

   $ sudo systemctl mask sleep.target suspend.target hibernate.target hybrid-sleep.target
   

8. Install and enable the SSH

   $ sudo apt install ssh
   $ sudo systemctl enable --now ssh
   $ reboot
   

9. After rebooting the Raspberry Pi, if you wish to work from the Remote PC using SSH, use below command from the remote PC terminal. The default password is ubuntu.

   $ ssh ubuntu@{IP Address of Raspberry PI}
   

Add Swap Space

1. Enter the command below to create 2GB swap space.

   $ sudo swapoff /swapfile
   $ sudo fallocate -l 2G /swapfile
   $ sudo chmod 600 /swapfile
   $ sudo mkswap /swapfile
   $ sudo swapon /swapfile
   $ sudo nano /etc/fstab
   

   You can ignore below error when entering swapoff /swapfile command.

   swapoff: /swapfile: swapoff failed: No such file or directory
   

2. When the editor opens the fstab file, append below contents at the end of the file.

   /swapfile swap swap defaults 0 0
   

3. Check if 2GB of swap space is correctly configured.

   $ sudo free -h
                 total        used        free      shared  buff/cache   available
   Mem:           912M         97M        263M        4.4M        550M        795M
   Swap:          2.0G          0B        2.0G
   

Install ROS 2 Dashing Diademata

Reference: Official ROS 2 Dashing Installation Guide

1. Open a terminal on SBC

2. Setup locale

   $ sudo apt update && sudo apt install locales
   $ sudo locale-gen en_US en_US.UTF-8
   $ sudo update-locale LC_ALL=en_US.UTF-8 LANG=en_US.UTF-8
   $ export LANG=en_US.UTF-8
   

3. Setup sources

   $ sudo apt update && sudo apt install curl gnupg2 lsb-release
   $ sudo curl -sSL https://raw.githubusercontent.com/ros/rosdistro/master/ros.key  -o /usr/share/keyrings/ros-archive-keyring.gpg
   $ echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/ros-archive-keyring.gpg] http://packages.ros.org/ros2/ubuntu $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/ros2.list > /dev/null
   

4. Install ROS 2 packages

   $ sudo apt update
   $ sudo apt install ros-dashing-ros-base
   

5. Install and Build ROS Packages.

   $ sudo apt install python3-argcomplete python3-colcon-common-extensions libboost-system-dev build-essential
   $ sudo apt install ros-dashing-hls-lfcd-lds-driver
   $ sudo apt install ros-dashing-turtlebot3-msgs
   $ sudo apt install ros-dashing-dynamixel-sdk
   $ mkdir -p ~/turtlebot3_ws/src && cd ~/turtlebot3_ws/src
   $ git clone -b dashing-devel https://github.com/ROBOTIS-GIT/turtlebot3.git
   $ cd ~/turtlebot3_ws/src/turtlebot3
   $ rm -r turtlebot3_cartographer turtlebot3_navigation2
   $ cd ~/turtlebot3_ws/
   $ echo 'source /opt/ros/dashing/setup.bash' >> ~/.bashrc
   $ source ~/.bashrc
   $ colcon build --symlink-install --parallel-workers 1
   $ echo 'source ~/turtlebot3_ws/install/setup.bash' >> ~/.bashrc
   $ source ~/.bashrc
   

6. USB Port Setting for OpenCR

   $ sudo cp `ros2 pkg prefix turtlebot3_bringup`/share/turtlebot3_bringup/script/99-turtlebot3-cdc.rules /etc/udev/rules.d/
   $ sudo udevadm control --reload-rules
   $ sudo udevadm trigger
   

7. ROS Domain ID Setting In ROS2 DDS communication, ROS_DOMAIN_ID must be matched between Remote PC and TurtleBot3 for communication under the same network environment. Following commands shows how to assign a ROS_DOMAIN_ID to SBC in TurtleBot3.
   • A default ID of TurtleBot3 is 30.
   • Configuring the ROS_DOMAIN_ID of Remote PC and SBC in TurtleBot3 to 30 is recommended.

$ echo 'export ROS_DOMAIN_ID=30 #TURTLEBOT3' >> ~/.bashrc
$ source ~/.bashrc

WARNING : Do not use an identical ROS_DOMAIN_ID with others in the same network. It will cause a conflict of communication between users under the same network environment.

NEW LDS-02 Configuration

LDS-01	LDS-02

The TurtleBot3 LDS has been updated to LDS-02 since 2022 models.
Please follow the instructions below on the SBC (Raspberry Pi) of TurtleBot3.

1. Install the LDS-02 driver and update TurtleBot3 package

   $ sudo apt update
   $ sudo apt install libudev-dev
   $ cd ~/turtlebot3_ws/src
   $ git clone -b dashing-devel https://github.com/ROBOTIS-GIT/ld08_driver.git
   $ cd ~/turtlebot3_ws && colcon build --symlink-install
   

2. Export the LDS_MODEL to the bashrc file. Depending on your LDS model, use LDS-01 or LDS-02.

   $ echo 'export LDS_MODEL=LDS-02' >> ~/.bashrc
   $ source ~/.bashrc
   

SBC Setup

Prepare microSD Card and Reader

If you PC do not have a microSD slot, please use a microSD card reader to burn the recovery image.

Download TurtleBot3 SBC Image

Download the correct image file for your hardware and ROS version.
Foxy version images are created based on Ubuntu 20.04.

The recovery image files can be modified without a prior notice.

Unzip the downloaded image file

Extract the .img file and save it in the local disk.

Burn the image file

You can use various image burning tools.
For example, Raspberry Pi Imager or Linux Disks utility can be used.
Choose your preferred tool to burn the image to microSD.

Raspberry Pi Imager

Please refer to this article to find more information about Raspberry Pi Imager.

1. Click CHOOSE OS.
2. Click Use custom and select the extracted .img file from local disk.
3. Click CHOOSE STORAGE and select the microSD.
4. Click WRITE to start burning the image.

Disks Utility

Disks utility is included in the recent Ubuntu Desktop. Search for “Disks” and launch the app.

1. Select the microSD card in the left panel.
2. Select Restore Disk Image option.
3. Open the .img file from local disk.
4. Click Start Restoring... > Restore button.

Resize the Partition

In order to reduce the size of recovery image file and to decrease the time to burn the image onto microSD, the recovery partition is minimized.
Please resize the partition to use the unallocated space.

Be aware of selecting an incorrect disk or a partition. Partitioning a system disk of your PC may cause a serious system malfunction.

Download or install GParted GUI tool

1. Select microSD card from the menu (mounted location may vary by system).
2. Right click on the yellow partition.
3. Select Resize/Move option.
4. Drag the right edge of the partition to all the way to the right end.
5. Click Resize/Move button.
6. Click the Apply All Operations green check button at the top.

Configure the WiFi Network Setting

NOTE : If you encounter apt failures about the ROS GPG key (due to the existing GPG expiration), you may need to update GPG key. Please see ROS GPG Key Expiration Incident, and proceed to the given solution.

1. Open a terminal window with Alt+Ctrl+T and go to the netplan directory in the microSD card.
   Start editing the 50-cloud-init.yaml file with a superuser permission sudo.

   $ cd /media/$USER/writable/etc/netplan
   $ sudo nano 50-cloud-init.yaml
   

   When the editor is opened, replace the WIFI_SSID and WIFI_PASSWORD with your wifi SSID and password.
   
   Save the file with Ctrl+S and exit with Ctrl+X.
   

If “No such file or directory” is returned, make sure the microSD is mounted to the system.

1. Boot Up the Raspberry Pi
   a. Connect the HDMI cable of the monitor to the HDMI port of Raspberry Pi.
   b. Connect input devices to the USB port of Raspberry Pi.
   c. Insert the microSD card.
   d. Connect the power (either with USB or OpenCR) to turn on the Raspberry Pi.
   e. Login with ID ubuntu and PASSWORD turtlebot.

HDMI cable has to be connected before powering the Raspberry Pi, or else the HDMI port of the Raspberry Pi will be disabled.

ROS2 Network Configuration

In ROS2 DDS communication, ROS_DOMAIN_ID must be matched between Remote PC and TurtleBot3 for communication under the same network environment.
The default ROS Domain ID for TurtleBot3 is set to 30 in the .bashrc file.
Please modify the ID to avoid any conflict when there are identical ID in the same network.

ROS_DOMAIN_ID=30 #TURTLEBOT3

WARNING : Do not use an identical ROS_DOMAIN_ID with others in the same network. It will cause a conflict of communication between users under the same network environment.

NEW LDS-02 Configuration

LDS-01	LDS-02

The TurtleBot3 LDS has been updated to LDS-02 since 2022 models.
Please follow the instructions below on the SBC (Raspberry Pi) of TurtleBot3.

1. Install the LDS-02 driver and update TurtleBot3 package

   $ sudo apt update
   $ sudo apt install libudev-dev
   $ cd ~/turtlebot3_ws/src
   $ git clone -b ros2-devel https://github.com/ROBOTIS-GIT/ld08_driver.git
   $ cd ~/turtlebot3_ws/src/turtlebot3 && git pull
   $ rm -r turtlebot3_cartographer turtlebot3_navigation2
   $ cd ~/turtlebot3_ws && colcon build --symlink-install
   

2. Export the LDS_MODEL to the bashrc file. Depending on your LDS model, use LDS-01 or LDS-02.

   $ echo 'export LDS_MODEL=LDS-02' >> ~/.bashrc
   $ source ~/.bashrc
   

This is it! Now you are done with SBC setup :)
Next Step : OpenCR Setup

$ echo 'export ROS_DOMAIN_ID=30 #TURTLEBOT3' >> ~/.bashrc
$ source ~/.bashrc

SBC Setup

Prepare microSD Card and Reader

If you PC do not have a microSD slot, please use a microSD card reader to burn the recovery image.

The microSD card reader is not included in the TurtleBot3 package.

Install Raspberry Pi Imager

Download the Raspberry Pi Imager to install Ubuntu Server 22.04 for Raspberry Pi.
If the Raspberry Pi Imager is already installed, update to the latest version.
Please refer to this article to find more information about Raspberry Pi Imager.

Install Ubuntu 22.04

1. Run Raspberry Pi Imager
2. Click CHOOSE OS.
3. Select Other gerneral-purpose OS.
4. Select Ubuntu.
5. Select Ubuntu Server 22.04.5 LTS (64-bit) that support RPi 3/4/400.
6. Click CHOOSE STORAGE and select the micro SD card.
7. Click WRITE to install the Ubuntu.

Configure the Raspberry Pi

HDMI cable must be connected before powering the Raspberry Pi, or else the HDMI port of the Raspberry Pi will be disabled.

1. Boot Up the Raspberry Pi
   a. Connect the HDMI cable of the monitor to the HDMI port of Raspberry Pi.
   b. Connect input devices to the USB port of Raspberry Pi.
   c. Insert the microSD card.
   d. Connect the power (either with USB or OpenCR) to turn on the Raspberry Pi.
   e. Login with ID ubuntu and PASSWORD ubuntu. Once logged in, you’ll be asked to change the password.

2. Open the network configuration file with the command below.

   $ sudo nano /writable/etc/netplan/50-cloud-init.yaml
   

3. When the editor is opened, edit the content as below while replacing the WIFI_SSID and WIFI_PASSWORD with your actual wifi SSID and password.
   

4. Save the file with Ctrl+S and exit with Ctrl+X.

5. Enter the command below to edit automatic update setting file.

   $ sudo nano /etc/apt/apt.conf.d/20auto-upgrades
   

6. Change the update settings as below.

   APT::Periodic::Update-Package-Lists "0";
   APT::Periodic::Unattended-Upgrade "0";
   

7. Save the file with Ctrl+S and exit with Ctrl+X.

8. Set the systemd to prevent boot-up delay even if there is no network at startup. Run the command below to set mask the systemd process using the following command.

   $ systemctl mask systemd-networkd-wait-online.service
   

9. Disable Suspend and Hibernation

   $ sudo systemctl mask sleep.target suspend.target hibernate.target hybrid-sleep.target
   

10. Reboot the Raspberry Pi.

    $ reboot
    

11. After rebooting the Raspberry Pi, if you wish to work from the Remote PC using SSH, use below command from the remote PC terminal. Make sure to use the password you set in Step 1.

    $ ssh ubuntu@{IP Address of Raspberry PI}
    

12. Install ROS2 Humble Hawksbill
    Follow the instruction in the official ROS2 Humble installation guide.

13. Install and Build ROS Packages.
    Building the turtlebot3 package may take longer than an hour. Please use the SMPS to ensure the system is always powered.

    $ sudo apt install python3-argcomplete python3-colcon-common-extensions libboost-system-dev build-essential
    $ sudo apt install ros-humble-hls-lfcd-lds-driver
    $ sudo apt install ros-humble-turtlebot3-msgs
    $ sudo apt install ros-humble-dynamixel-sdk
    $ sudo apt install libudev-dev
    $ mkdir -p ~/turtlebot3_ws/src && cd ~/turtlebot3_ws/src
    $ git clone -b humble-devel https://github.com/ROBOTIS-GIT/turtlebot3.git
    $ git clone -b ros2-devel https://github.com/ROBOTIS-GIT/ld08_driver.git
    $ cd ~/turtlebot3_ws/src/turtlebot3
    $ rm -r turtlebot3_cartographer turtlebot3_navigation2
    $ cd ~/turtlebot3_ws/
    $ echo 'source /opt/ros/humble/setup.bash' >> ~/.bashrc
    $ source ~/.bashrc
    $ colcon build --symlink-install --parallel-workers 1
    $ echo 'source ~/turtlebot3_ws/install/setup.bash' >> ~/.bashrc
    $ source ~/.bashrc
    

14. USB Port Setting for OpenCR

    $ sudo cp `ros2 pkg prefix turtlebot3_bringup`/share/turtlebot3_bringup/script/99-turtlebot3-cdc.rules /etc/udev/rules.d/
    $ sudo udevadm control --reload-rules
    $ sudo udevadm trigger
    

15. ROS Domain ID Setting In ROS2 DDS communication, ROS_DOMAIN_ID must be matched between Remote PC and TurtleBot3 for communication under the same network environment. Following commands shows how to assign a ROS_DOMAIN_ID to SBC in TurtleBot3.
    • A default ID of TurtleBot3 is 30.
    • Configuring the ROS_DOMAIN_ID of Remote PC and SBC in TurtleBot3 to 30 is recommended.

$ echo 'export ROS_DOMAIN_ID=30 #TURTLEBOT3' >> ~/.bashrc
$ source ~/.bashrc

WARNING : Do not use an identical ROS_DOMAIN_ID with others in the same network. It will cause a conflict of communication between users under the same network environment.

LDS Configuration

The TurtleBot3 LDS has been updated to LDS-02 since 2022.
If you have purchased TurtleBot3 after 2022, please use LDS-02 for the LDS_MODEL.

LDS-01	LDS-02

Depending on your LDS model, use LDS-01 or LDS-02.

$ echo 'export LDS_MODEL=LDS-02' >> ~/.bashrc

Apply changes with the command below.

$ source ~/.bashrc

This is it! Now you are done with SBC setup :)
Next Step : OpenCR Setup

SBC Setup