Skip to content

sctse999/donkeycar-images

Repository files navigation

Warning

Use this image at your own risk. This image is designed for the ease of use and therefore sacrifice quite some security concern. For example, it has an unprotected jupyter lab instance running with shell access. In addition, the donkeycar console installed accept any web or mobile client to connect without a password. This may be enhanced in the future but it is what it is now.

Features

  • Pre-installed Donkey Car Software
  • Support Donkey Car mobile app
  • Supports RPI4B
  • Supports Robohat MM1
  • Built-in wifi hotspot
  • Pre-installed librealsense and pyrealsense2
  • Jupyter Lab

Download

Date Platform Donkeycar version Download
2021-02-04 Raspberry Pi 4B / Buster v4 Download
2020-10-14 Raspberry Pi 4B / Buster v3 Download
2020-07-18 Raspberry Pi 4B / Buster v3 Download

Access

SSH Login

  • username: pi
  • password: raspberry

Jupyter Lab

http://donkey-xxxxxx.local:8888

How to install

sudo git clone https://github.com/sctse999/donkeycar-images /opt/donkeycar-images
sudo ln -s donkey-init.service /etc/systemd/system/donkey-init.service

Add Cron Job

Add the following lines after you execute sudo crontab -e

* * * * * /opt/donkeycar-images/switch-network.sh
* * * * * /home/pi/env/bin/python /opt/donkeycar-images/low-battery-auto-shutdown.py 2>&1 | /usr/bin/logger -t low-battery-protector

Wifi Hotspot

This image is installed with Raspap. To login the Raspap portal, visit http://hostname/ with the following credentials:

  • username: admin
  • password: secret

A hotspot is automatically available if there is no active wireless connection. The hotspot name is determined by /etc/hostapd/hostapd.conf, which is updated by a script located in /usr/local/sbin/donkey-init.sh upon first boot.

This script will use the prefix donkey- and the last 6 character of the hardware mac address to create the hotspot. You can change this hotspot name to something else by editing the file or using the Raspap portal.

The script switch-network.sh is a cron job run by root. It turns off the hotspot when there is an active wireless connection. Similiarly, it turns on the hotspot when there is no wireless connection.

Jupyter Lab

Installation step

pip install jupyterlab

sudo systemctl enable jupyter-lab.service

Startup Config

/etc/systemd/system/jupyter-lab.service

[Unit]
Description = JupyterLab

[Service]
PIDFile = /run/jupyter.pid
ExecStart = /home/pi/env/bin/jupyter-lab
User = pi
Group = pi
WorkingDirectory = /home/pi
Restart=always
RestartSec=10

[Install]
WantedBy = multi-user.target

Reset script

The reset script will reset the current system to a clean state.

# Run either one of the following command

/opt/donkey-images/pre-release-v3.sh
/opt/donkey-images/pre-release-v4.sh

Others

Software Info

Donkey Car

origin: https://github.com/robocarstore/donkeycar

v4 branch: robocarstore_v4

v3 branch: robocar_dev

Donkey Car Console

origin: https://github.com/robocarstore/donkeycar-console

branch: dev

Commercial Use

If you intend to use this project for making money, you must obtain our consent before you do so. Contact us at [email protected]

Changelog

RPI4B

v20210204

  • Update donkey car to v4.2.0
  • Compatible with Donkey Car Controller 1.3.2
  • Single python venv at /home/pi/env. Both donkey console and donkey car software use this venv.

v20201014 / v1.0

  • Update donkey car to v3.1.5
  • Update to latest donkeycar-console

v20200708

  • Fine tune myconfig.py value
  • Install Google Coral Edgetpu library

v20200707

  • Installed jupyter lab as a service

v20200526

  • Installed ffmpeg and keras-vis
apt-get install ffmpeg
pip install git+https://github.com/sctse999/keras-vis.git

v20200421

  • Installed donkey console v2 under ~/
  • Installed donkey console as systemd service

v20200324

  • Rename init script to donkey-init.sh
  • Added ~/donkey.cfg for config reset
  • donkey-init.sh will rename hostname when DONKEY_RESET=True in donkey.cfg
  • donkey-init.sh will reset wpa_supplicant.conf
  • Change raspap country to US and use 80211.ac 5Ghz
  • Install switch-network.sh to crontab

v20200310

  • Performed OS upgrade
  • Removed vim
  • Added librealsense support (build 2.33.1)
  • Enabled serial port for MM1 and installed pyserial
  • Upgraded pip to 20.0.2
  • Installed vim
  • Adopted https://github.com/amix/vimrc

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published