search

robocarstore / donkeycar_controller

4 stars 0 forks source link

readme

Robocar Controller

Robocar Controller is a mobile app designed to provide a “commandless” user experience to get started with the Donkey Car.

cover

Features

Requirements

Quickstart Guide

Please refer to the quick start guide here.

Features Details

Built-in Hotspot

The car will become a hotspot when there is no known Wifi network to connect. After connecting your phone to this hotspot, you can use the app to configure the car to join the Wifi network you want.

Search vehicle on the network

Once your car connects to the same network as your phone, the app will scan the whole network to discover it. The app will also show you the IP address of the car in case you want to connect to it via SSH.

Search Vehicle

Real-time Calibration

Sometimes it is quite annoying if the car goes too fast or does not run in a straight line. The calibration UI assists you to find the right settings so that your car could be properly calibrated. With the enhanced calibration function, the change will take place in real time and you could observe the change immediately.

Real-time calibration

Virtual Joystick

The virtual joystick offers a quick way to test drive the car if you don't have a physical gamepad controller. It also streams the video captured from the camera in real time. You can just look at the screen and start driving.

Drive UI

Drive Summary

The app presents a drive summary with histogram, the size and the number of images you have collected. The histogram is generated automatically by calling the tubhist function in the Donkey car software.

Drive summary

Visualize the data

The app shows all the data(tubs) and the metadata you have collected on the Pi. The metadata includes number of images, size of the tub, the resolutions, the histogram and the location. The app will make use of the donkey makemovie command to generate a video so you can review how the data look like.

Data

Free GPU Training

Free GPU training is available to user who use the app. You can train a model by selecting the data(tubs) you wish to train. The data will be uploaded to our server to start the training process. Once the training is completed, the app will show you the training loss and accuracy graph. At the same time, the app will download the model to your car and you can test the model right away.

Note: We keep the data and models for a period of time. After that, we will delete it from our storage.

Train

More on Free GPU Training

We are using AWS g4dn.xlarge instance to train the model. It feautres NVIDIA T4 GPU and up to 16GB GPU memory. Increase the batch size to 256 or more to fully utilize the powerful GPU.

Limitation

N.B.: To protect our equipment from being abused, we have the following rules to use the training service.

Autopilot

The app will list all models inside the Pi, no matter it is generated from the training function or just a model copied to the Pi. You can start the autopilot mode using a similar UI as the Drive UI.

Autopilot

Advanced configuration

The Doneky car software comes with a vast of configuration that you can experiment. We have included some of the popular options that you may want to change.

Advanced configuration

Battery level

If you are using MM1, the app shows you the current battery level in percentage. We have also added an OS tweak that if battery level fall below 7V, the system will shutdown automatically.

Upcoming features

Report a problem

If you encountered a problem, please file an issue on this github project.

FAQ

We would love to call the app Donkeycar Controller but Apple does not allow us to do so. We are working with Adam to submit a proof to Apple that we can use the Donkeycar trademark in our app. In the meanwhile, we will be using the name Robocar Controller.

Commercial Usage

This app is developed by Robocar Store. If you plan to use this app to make money, please follow the Donkey Car guideline and send an email to Robocar Store.