Turtlebot4 Setup

Setup scripts and tools for the TurtleBot 4 Raspberry Pi.

Visit the TurtleBot 4 User Manual for more details.

Create an image manually

Follow these instructions if you wish to create a Turtlebot4 image manually.

Create an Ubuntu Image

First install the Raspberry Pi Imager.

• Insert your SD card into your PC and run the Raspberry Pi Imager. Follow the instructions and install Ubuntu 22.04 Server (64-bit) onto the SD card.
• Ensure your Raspberry Pi 4 is not powered before inserting the flashed SD card.
• You can set up the Raspberry Pi by either connecting it to your network via Ethernet or by using a keyboard and HDMI monitor via a micro HDMI cable.

Ethernet Setup

• Connect the Raspberry Pi to your Network with an Ethernet cable.
• Boot the Raspberry Pi.
• Find the Raspberry Pi's IP using your router's portal.
• SSH into the Raspberry Pi using the IP address.

ssh ubuntu@xxx.xxx.xxx.xxx

• The default login is ubuntu and password is ubuntu. You will be prompted to change your password.

HDMI Setup

• Connect a keyboard to the Raspberry Pi via USB.
• Connect a monitor to the Raspberry Pi via the HDMI0 port.
• Boot the Raspberry Pi.
• The default login is ubuntu and password is ubuntu. You will be prompted to change your password.

Manually configure Wi-Fi

Once you are logged into the Raspberry Pi, configure the Wi-Fi:

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

Add the following lines:

wifis:
    wlan0:
        optional: true
        access-points:
            "YOUR_WIFI_SSID":
                password: "YOUR_WIFI_PASSWORD"
        dhcp4: true

Note: Ensure that wifis: is aligned with the existing ethernets: line. All indentations should be 4 spaces. Do not use tabs. - Reboot the Raspberry Pi. It should now be connected to your Wi-Fi. - Find the Raspberry Pi's IP using your router's portal. - SSH into the Raspberry Pi using the IP address.

ssh ubuntu@xxx.xxx.xxx.xxx

Download and run the setup script

wget -qO - https://raw.githubusercontent.com/turtlebot/turtlebot4_setup/humble/scripts/turtlebot4_setup.sh | bash

The script will automatically install ROS 2 Humble, TurtleBot 4 packages, and other important apt packages. It will also configure the RPi4 to work in a TurtleBot 4. Once complete, the RPi4 should be rebooted with sudo reboot. Then, run turtlebot4-setup to configure the robot with the setup tool.

Changelog for package turtlebot4_setup

1.0.3 (2023-11-08)

• Cleanup <https://github.com/turtlebot/turtlebot4_setup/issues/7>
• Remove scripts that should not be used in Humble
• Update create_update.sh to reference Humble minimum version
• Updated README
• Updated turtlebot4_setup.sh script
• Fixed setting robot model
• Contributors: Hilary Luo, Roni Kreinin

1.0.2 (2023-03-01)

• Fixed Discovery Server IP
• Updated default configs
• Contributors: Roni Kreinin

1.0.1 (2023-02-28)

• Fixed script install path
• Contributors: Roni Kreinin

1.0.0 (2023-02-24)

• turtlebot4_setup tool
• RPI config updates
• Discovery server files
• Contributors: Roni Kreinin

0.1.3 (2022-09-27)

• Merge pull request #2 from turtlebot/roni-kreinin/domain_id v0.1.3
• Added webserver service
• Added argparser to install.py Removed namespacing for now
• Added \'ros_config\' script for setting ROS_DOMAIN_ID, namespace, and RMW_IMPLEMENTATION
• Contributors: Roni Kreinin, roni-kreinin

0.1.2 (2022-06-14)

• Added chrony Updated wifi script
• Updated dependencies Move swap_on and swap_off to /usr/local/bin
• Fixed comment
• Updated Create 3 curl commands Move wifi and create update scripts to /usr/local/bin
• Updated oakd branch
• Update README.md
• Moved contents to root folder Updated oakd script to work for both pro and lite Updated turtlebot4_setup script Updated wifi script to allow the create 3 to be set up through the pi Added create 3 firmware flash scripts
• Update README.md
• Updated robot_upstart repo
• Added swap memory scripts when more RAM is needed to build packages
• Updated README
• Initial commit
• Contributors: Roni Kreinin, roni-kreinin