October 04, 2015
Karotz Diagnostics (USB key)
I decided to create a bootable USB key to collect diagnostic information about my Karotz. My goal was to include a list of available Wifi networks, as the (Wifi interface of) the Karotz sees them. I read a lot of forum posts about people having troubles to connect their rabbit to their Wifi network, so this might be a little help in the future to find out what is going on.
To create the USB key
- Download the ZIP file from Github
- Unzip to the root of a FAT32 formatted USB key. Note that your USB key must contain the files in the root, so skip the folder created by Github.
- Check if your USB key contains a folder called “logs”. You will find your logfiles in this folder after your Karotz has collected them. Also check for a folder called “scripts”. Your Karotz will copy its scripts to this folder, so you can check the contents of some scripts (for example config.py).
- Turn off your Karotz.
- Place the USB key in your Karotz.
- Turn on your Karotz and let it do its work. You will hear spoken instructions when your Karotz contains firmware that supports it. Otherwise, check the color of the LEDs (see the instructions and image below for the meaning of the different colors).
- When your LED stays off for 10 seconds, the procedure has finished.
- Wait for the LED to turn on again, then turn off your Karotz.
- Unplug the USB key.
- Examine the USB key with a computer and look for files in folder "logs" and "scripts".
Information about the LED color
- Fixed Red: Your Karotz is starting up.
- Pulsing Orange: Diagnostics have started, and will soon collect information.
- Fixed Purple: Collecting startup information (dmesg).
- Fixed Cyan: Collecting file and folder information (ls).
- Fixed Pink: Collecting BusyBox information.
- Fixed Green: Collecting network interface information (ifconfig).
- Fixed Yellow: Collecting Environment information (printenv).
- Fixed Orange: Collecting Process information (ps).
- Fixed Violet: Collecting information about the Wifi networks in your neighbourhood.
- Pulsing Orange: All information has been collected. Your Karotz will complete the procedure.
- Off: Script has finished. LED will be off for 10 seconds.
Version of your Karotz (based on version of BusyBox)
I discovered that the version of BusyBox gives information about the firmware of the Karotz (check the logs folder for the file “Busybox.txt”). You can find the version number on the first line of “BusyBox.txt”:
- BusyBox v1.16.1: Your rabbit is running factory default firmware.
- BusyBox v1.17.4: Your rabbit has been upgraded after factory defaults.
- BusyBox v1.21.1: Your rabbit could be running Open Karotz.
You can find the source files on Github.