DeepRacer Custom Car provides an updated software stack that contains a set of features that will improve your DeepRacer car.
This repository contains a few different things:
- Build and install scripts for a custom ROS2 software stack for DeepRacer, supporting original DeepRacer, Raspberry Pi 4 and Raspberry Pi 5.
- Drawings and build instructions for building a DeepRacer compatible car based on a WLToys A979 and a Raspberry Pi.
- Utilities, e.g. to create a USB stick to flash the original DeepRacer with the custom
The repository is a merge of deepracer-scripts that contained improvements for the original car and deepracer-pi that ported DeepRacer to a Raspberry Pi4.
The main features of the custom software stack is
- Performance improvement through using compressed image transport for main processing pipeline
- Modern user-interface from Deepracer Custom Console.
- Inference using OpenVINO with Intel GPU (original DeepRacer), OpenVino with Myriad Neural Compute Stick (NCS), or Tensorflow Lite
- Model Optimizer caching, speeding up switching of models
- Capture in-car camera and inference results to a ROS Bag for logfile analysis
- Car health and latency analysis both in console and the ROS Bag
- Reduced log output from chatty nodes
Additionally there are OS level tweaks for the original DeepRacer and Raspberry Pi4 alike:
- Original: Uninstall unused packages and stop unnecessary services
- RPi: Minimal install, required packages only
- Disable wifi power-save to avoid disconnects
- Disable suspend
- CPU governors in performance mode to ensure that CPU is running at max frequency during inference.
In the utils/ folder there are utilities to create a USB flash stick for the original DeepRacer. See documentation.
There are separate installation scripts for the original DeepRacer on Ubuntu 20.04/ROS2 Foxy, the Raspberry Pi4 based car on Ubuntu 22.04/ROS2 Humble and the Raspberry Pi5 based car on Ubuntu 24.04/ROS2 Humble. Basic installation depends on pre-packages apt/deb packages, and does not require any packages to be compiled on the car itself.
For the original DeepRacer run:
sudo install_scripts/aws-20.04/install-prerequisites.sh
sudo install_scripts/aws-20.04/install-deepracer.sh
For the Raspberry Pi4 on Ubuntu 22.04:
sudo install_scripts/rpi4-22.04/install-prerequisites.sh
sudo install_scripts/rpi4-22.04/install-deepracer.sh
For the Raspberry Pi 4 or 5 on Ubuntu 24.04:
sudo install_scripts/rpi-24.04/install-prerequisites.sh
sudo install_scripts/rpi-24.04/install-deepracer.sh
See also building instructions for the Raspberry Pi4.
It is also possible to flash the Original Car using a custom flash image:
- Enter the utils directory
- Run
./usb-build.ubuntu.sh -d [drive] -r https://larsll-build-artifact-share.s3.eu-north-1.amazonaws.com/car-image/custom_factory_reset.zip - Drive is
sdb,sdcor similar. Uselsblkto look for the available drives.
This builds on the original flashing procedure, but is including the steps in both install-prerequisites.sh and install-deepracer.sh giving you a much
leaner DR install which already has already been upgraded to Ubuntu 20.04.6 LTS, and with most packages up-to-date. (The original image is providing 20.04.1 LTS,
and requires a long time to bring up to the latest version.)
Once installed the software will look very much like the original DeepRacer software.
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. |
camera_mode |
legacy |
Camera integration method (legacy or modern). |
inference_engine |
TFLITE |
Inference engine to use (TFLITE or OV). |
inference_device |
CPU |
Inference device to use, applicable to OV only (CPU, GPU or MYRIAD). |
logging_mode |
usbonly |
Enable the logging of results to ROS Bag on USB stick. |
logging_provider |
sqlite3 |
Database provider to use for logging. |
battery_dummy |
False |
Use static dummy for battery measurements. |
rplidar |
True |
Enable RPLIDAR node for LiDAR sensor integration. |
The different combinations of inference_engine and inference_device are not all compatible with the RPi4, and each option comes with pros and cons. The original car software only supports OpenVINO CPU.
| Feature | Original (Ubuntu 20.04, ROS2 Foxy) | RPi4 (Ubuntu 22.04, ROS2 Humble) | RPi4/RPi5 (Ubuntu 24.04, ROS2 Jazzy) | Notes |
|---|---|---|---|---|
| Camera | Original USB (incl. Stereo) | RPi Camera Module 2 + USB | RPi Camera Module 2 & 3 + USB | |
| TensorFlow Lite (CPU) | Yes | Yes | Yes | Default for RPi |
| OpenVINO (CPU) | Yes | No | No | Default for Original |
| OpenVINO (GPU) | Yes | No | No | Reduces CPU load, but model takes longer to load |
| OpenVINO (NCS2/Myriad X) | Yes | Yes | No | Reduces CPU load, requires NCS2 stick, model takes longer to load |
The different modes have been tested for equivalency, and it is verified that they provide the same results (identical picture in -> identical action taken). Less than 1 per 1000 frames are differing, mainly due to the model not having a clear action, and several actions are having very similar probabilities.
If you insert a USB stick or SD card with a folder called logs/ then this will be automatically mounted, and when you start the car in autonomous mode then a ROS Bag file is created storing the inference results, which also contains the ROS messages.
Images are only captured if the autonomous mode is running ("Start Vehicle"). If stopped no images are stored. If the same model is restarted within 15 seconds the new images are appended to the same bag. After 15 seconds the bag is closed, and if restarted a new bag is created. If the selected model changes, the current bag is immediately closed, and a new one created once the car is started.
larsll-deepracer-logging is providing a script to convert the bag into a video, combining it with a grad-cam analysis to visualize what happens inside of the car.
To create a DeepRacer compatible car with WLToys A979 and a Raspberry Pi read the building instructions.
To build the software packages, either for the Raspberry Pi4 or for the original Deepracer read the instructions.