DeepRacer Scripts

Please note this scripts are provided as is.... if something breaks through use then a) I'm sorry b) fix it and submit a PR ;-)

dev-stack-*

Refactoring of the dev-build.sh, which splits it into three distinct scripts.

To ensure that car configuration is correct, please run tweaks.sh once after flashing the car.

-	File	Description
1	tweaks.sh	Update the car settings.
2	dev-stack-dependencies.sh	Installs the dependencies for a custom DR stack. Script is only required to be run one time.
3	dev-stack-build.sh	Downloads the packages defined in ws/.rosinstall and builds them into the ws folder.
4	dev-stack-install.sh	Installs the stack built in ws/install into /opt/aws/deepracer/lib.

usb-build.*

Recommendations:

• Try using USB 3.0 usb stick, the process will take about 30 minutes per stick compared to 1.5hrs with USB 2.0 ones.

Requirements:

• factory_reset.zip unzipped in the same directory (will be downloaded and unzipped if missing)
• ubuntu-20.04.1-20.11.13_V1-desktop-amd64.iso in the same directory (will be downloaded if missing)

Both files can be downloaded from here https://docs.aws.amazon.com/deepracer/latest/developerguide/deepracer-ubuntu-update-preparation.html

OSX version

Requirements:

• https://unetbootin.github.io/ installed

Command:

./usb-build.sh -d disk2 -s <WIFI_SSID> -W <WIFI_PASSWORD>

Note:

• The wifi credentials are used to create wifi-creds.txt on the DEEPRACER partition, upon rebooting after flashing the car will use this file to connect to wifi
• Tested and working on Intel and Apple based Macs
• Unetbootin currently doesn't work on OSX Ventura #Issue 337

Ubuntu version

Requirements:

• Requires sudo privileges
• Will add current user to sudoer automatically (with the "no password" option enabled)

Command:

./usb-build.ubuntu.sh -d sdX -s <WIFI_SSID> -W <WIFI_PASSWORD>

Note:

• The wifi credentials are used to create wifi-creds.txt on the DEEPRACER partition, upon rebooting after flashing the car will use this file to connect to wifi
• Tested and working on Ubuntu 20.0.4 (like a DeepRacer car)

Windows PowerShell version

Requirements:

• Run in an Administrator / elevated mode PowerShell command window

Command:

start powershell {.\usb-build.ps1 -DiskId <disk number>}

Additional switches:

Description	Switch
Provide Wifi Credentials	-SSID <WIFI_SSID> -SSIDPassword <WIFI_PASSWORD>
Create partitions (default value is True)	-CreatePartition <True/False>
Ignore lock files (default value is False)	-IgnoreLock <True/False>
Ignore Factory Reset content creation (default value is False)	-IgnoreFactoryReset <True/False>
Ignore Boot Drive creation (default value is False)	-IgnoreBootDrive <True/False>

Note:

• The wifi credentials are used to create wifi-creds.txt on the DEEPRACER partition, upon rebooting after flashing the car will use this file to connect to wifi
• Tested and working on Windows 11 Pro

tweaks.sh

A script to change a couple of things on the car that I've found useful at events

• Add deepracer user to sudoers
• Change the hostname
• Change the car console password (Note: Update the default password in the script)
• Update Ubuntu
• Update the car software
• Disable IPV6 on network interfaces
• Disable the video stream on the car console by default
• Disable system suspend
• Disable network power saving
• Disable the software update check
• Enable SSH (You've probably already done this)
• Allow multiple logins to the car console
• Increase the car console cookie duration
• Disable Gnome, Bluetooth & CUPS

Command:

sudo ./tweaks.sh -h newhostname -p magicpassword

reset-usb.sh

Needs to be run on the car to reset USB in the event of a failure of the front USB hub, faster than a full reboot of the car - works ~70% of the time YMMV

VS.Code Dev Container

Files have been added to the repository (.devcontainer and .vscode) that allows the normal DR packages to be built on another machine, isolated from what is installed on the OS. Tested on Ubuntu 20.04.

Container includes most relevant ROS2 Foxy packages, as well as the OpenVINO release that is used on the car.

Before opening the container run docker volume create deepracer-ros-bashhistory to get your commandline history enabled inside the container.