/deepracer-scripts

Primary LanguageShell

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.custom, and changes /opt/aws/deepracer/start_ros.sh to use it.
5 dev-stack-install-remote.sh Pushes an install onto a remote machine. Add as parameter the SSH information e.g. deepracer@amss-hm12

The custom stack exposes the following arguments which can be changed through changing /opt/aws/deepracer/start_ros.sh.

Argument Default Description
camera_fps 30 Number of camera frames per second, directly impacting how frequently the car takes new actions.
camera_resize True Does the camera resize from 640x480 to 160x120 at source.
inference_engine CPU What device will perform inference. Can be CPU, GPU or MYRIAD; Myriad is the intel compute stick.
logging_enable False Shall the output of inference be written to a ROS Bag?

Example custom /opt/aws/deepracer/start_ros.sh:

source /opt/ros/foxy/setup.bash
source /opt/aws/deepracer/lib.custom/setup.bash
source /opt/intel/openvino_2021/bin/setupvars.sh
ros2 launch deepracer_launcher deepracer_launcher.py camera_resize:=False camera_fps:=15 logging_enable:=True

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:

  • The custom AWS DeepRacer Ubuntu ISO image ubuntu-20.04.1-20.11.13_V1-desktop-amd64.iso in the same directory (will be downloaded if missing)
  • The latest AWS DeepRacer software update package factory_reset.zip unzipped in the same directory (will be downloaded and unzipped if missing)

Both files can be downloaded from here https://docs.aws.amazon.com/deepracer/latest/developerguide/deepracer-ubuntu-update.html (under the "Prerequisites" heading).

OSX version

Requirements:

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 PowerShell command window (NOT run as Administrator, but you will be prompted to elevate with Administrator at some point in the script=

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.