Crankshaft dev mode - opencardev/crankshaft GitHub Wiki

Development mode

This page is being written. There will be more interesting features regarding the dev mode, check back this page later for more tips and tricks.

As Crankshaft is designed as a "plug-n-play" solution, it mostly doesn't need to be configured. But if you want to dig deeper, you could do so by starting it in dev mode. This feature is offered on image 2018-03-05 or later.

To enable dev mode, open the file crankshaft/chrankshaft_env.sh on the boot partition (that's what you see when you open the SD card on Windows) with Sublime Text, then edit so it says DEV_MODE=1. Save the file, put the card into the Pi and start it, then wait for it to restart. Voila! You're in dev mode. The screen is black! You can now plug a keyboard to type directly or SSH into the system.

Do not edit Crankshaft files using Windows Notepad, Wordpad, Mac OS's TextEdit.app, Microsoft Word. They will mess things up! Use Notepad++ or Sublime Text or VS Code.

Use default username pi and password raspberry.

To quit dev mode, remove the jumper, then issue sudo reboot. It will reboot twice, and you'll be out of dev mode.

  • It will enable network services that are normally not enabled.
  • It will mount the system in the read-write mode so your changes are saved.
  • It will not start the head unit app automatically until you ask it to (issue sudo systemctl start autoapp.service).
  • It will allow you to compile OpenAuto on it from the source.
  • It will enable the OpenSSH daemon. Plug a wired connection in, and you can SSH into the system (on Mac & Linux, ssh pi@crankshaft, on Windows, use PuTTY).

Note: Every time you enable dev mode on a new version of Crankshaft, it will generate a new key. When you SSH in, your computer might warn you about changed host signatures - that's OK. Just remove the old sigs so it doesn't complain anymore.

Build OpenAuto in dev mode

Yes you can. See here: https://github.com/htruong/crankshaft/wiki/Building-the-binary-blobs#building-openauto

Run OpenAuto under X11

This section has been moved here: https://github.com/htruong/crankshaft/wiki/Custom-touchscreens