init
Table of Contents
** This page contains the current release of our r0ket firmware release. Feel free to try it and give us feedback if you discover bugs in the firmware or these instructions **
How to flash your r0ket?
Flashing your r0ket ensures you will get the full functionality. It is highly recommended you flash your old r0ket before attending the congress.
This procedure also brings your r0ket back into shape in case you “bricked” it or experience other strange software glitches including a damaged file system for l0dables.
Revision | Change |
---|---|
1 | Initial |
2 | Improved Mesh |
3 | Improved r_player l0dable |
4 | Improved fahrplan, mesh, fonts |
5 | Fixed mesh |
6 | Actually pushed the mesh changes, improved game l0dable |
15 | numerous small bugfixes |
Linux
- Download the firmware pack here: r0ket-firmware-r15.tar.gz
- Unpack the archive with your favourite tool.
- Turn r0ket off (switch position up).
- Plug micro-USB cable into r0ket and Computer.
- Hold joystick to the left.
- Turn r0ket on (switch position down).
- Release joystick.
- Wait about 30 seconds.
- The r0ket will pose as a thumb drive. Check that you have a new volume with a 'firmware.bin' file on it. Mount the r0ket if you don't get a new volume.
- As a normal user run the following command in a command window:
- cd r0ket-firmware-28c3-r6 && ./flash-r0ket
- The script should tell you, that everything went fine.
- Turn r0ket off.
- Hold joystick down towards the battery connector.
- Turn r0ket on.
- As above look for a new volume on your system. Mount the r0ket if you don't get one.
- <note important>If you already completed the steps below before, please jump to Updating the dataflash</note>
- Make a copy of the following files to your computer: R0KET.CFG, NICK.CFG, L0NICK.CFG, FONT.CFG, pubx.key, puby.key and priv.key
- Don't worry if some of these files are missing. Your r0ket will still work.
- Now unmount the r0ket. In a terminal run the following commands:
mount
- look for a line like:
/dev/sdb on /media/3355-4B37 type vfat [...]
- In this case “/dev/sdb” is the device of your r0ket. Make sure that the second path matches name of the new volume
sudo umount <device that was shown by the 'mount' command above>
- Example:
sudo umount /dev/sdb
- Write the new image by running:
sudo dd if=dataflash.img of=<device that was shown by the 'mount' command above>
- make absolutely sure that you enter the correct device in the line above, or you can damage your computer.
- Example:
sudo dd if=dataflash.img of=/dev/sdb
sync
- This command may take a minute or two.
- Turn off r0ket and back on, while pressing the joystick towards the battery connector.
- Copy the files from step 16 back to the r0ket.
You're done. Yay!
Windows
- Download the firmware here: r0ket-firmware-r15.zip
- Turn r0ket off (switch position up)
- Plug micro-USB cable into r0ket and Computer
- Hold joystick to the left
- Turn r0ket on (switch position down)
- Release joystick
- Wait about 30 seconds.
- Write firmware.bin to r0ket
- run “copy firmware.bin G:” (check the drive letter first – or just do it via drag&drop)
- Turn r0ket off.
- Hold joystick down
- Turn r0ket on.
- Write new dataflash image
- Either use a tool like ImageWriter
- select dataflash.img as source and the USB r0ket as target
- or write with dd for windows with a command like
- dd if=dataflash.img of=\\.\g: # (check drive-letter first)
- wait until all data is written
- turn off r0ket
You're done. Yay!
Mac
- Download the firmware pack here: r0ket-firmware-r15.tar.gz
- Download and compile keys.c from https://github.com/r0ket/r0ket.git (r0ket/tools/crypto/generate-keys.c) and put in in the same directory as the script
- Write the following script to a file. Extract the firmware. Execute the script with the directory containing the new firmware as parameter. The script will guide you through the process.
- Example
./flashscript r0ket-firmware-r15
FlashScript UNSAFE (user errors might cause loss of data and corruption)
#!/bin/bash myTmpdir=/tmp/r0ket/$(uuidgen) myCalled="$(pwd)" function ERROR { echo ERROR $@ } function DEBUG { echo DEBUG $@ } function PRINT { echo $@ } function DIE { echo DIED $@ exit 1 } function flashFirmware { myMount="$(diskutil info $(system_profiler SPUSBDataType | grep -A15 "NXP LPC13XX IFLASH" | grep "BSD Name" | awk -F: '{print $2}') | grep "Mount Point" | sed 's/[ ]*.*[ ][ ]//g')/" if [ -z "$myMount" ] || [ ! -d "$myMount" ]; then DIE "Could not flash firmware. Could not find mountpoint $myMount" fi cp -v "$FIRMWAREBIN" "$myMount" sleep 2 sync sleep 2 myroket="/dev/$(system_profiler SPUSBDataType | grep -A15 "NXP LPC13XX IFLASH" | grep "BSD Name" | awk -F: '{print $2}' | sed 's/ //')" PRINT Unmounting the rocket $myroket. Please enter your password: sudo umount "$myroket" return } function flashDataflash { myMount="$(diskutil info $(system_profiler SPUSBDataType | grep -A10 "r0ket" | grep 'BSD Name' | awk -F: '{print $2}' | sed 's/ //' ) | grep "Mount Point" | sed 's/[ ]*.*[ ][ ]//g')" if [ -z "$myMount" ] || [ ! -d "$myMount" ]; then DIE "Could not flash dataflash. Could not find mount $myMount" fi cd "$myMount" pwd cp -v R0KET.CFG NICK.CFG L0NICK.CFG FONT.CFG pubx.key puby.key priv.key $myTmpdir/backup/ cd $myTmpdir sleep 5 #PRINT "Please unmount the roket in the finder. Press the eject button on the newly mounted device. Then press return" #read myroket="/dev/$(system_profiler SPUSBDataType | grep -A10 "r0ket" | grep "BSD Name" | awk -F: '{print $2}' | sed 's/ //')" PRINT Unmounting the rocket $myroket. Please enter your password: sudo umount $myroket PRINT Flashing the rocket. Please enter your password: cd "$myCalled" echo sudo dd if=$FIRMWARE/dataflash.img of=$myroket sudo dd if=$FIRMWARE/dataflash.img of=$myroket sync sleep 3 sudo mount -t msdos $myroket $myTmpdir/mountpoint cd $myTmpdir/backup cp -v * $myTmpdir/mountpoint/ ls pubx.key puby.key priv.key || ( echo "Generating new keys" && cd .. && ./generate-keys && cp -v files/* $myTmpdir/mountpoint/ ) cd /tmp PRINT Unmounting the rocket $myroket. Please enter your password: sudo umount $myroket } function cleanUp { sudo rm -rf /tmp/r0ket/ } function init { mkdir -p $myTmpdir/backup mkdir -p $myTmpdir/mountpoint mkdir -p $myTmpdir/files } function main { init if [ -n "$@" ]; then if [ -e "$@/firmware.bin" ]; then FIRMWARE=$@ FIRMWAREBIN=$@/firmware.bin else DIE $@/firmware.bin seems not to be a firmware fi else DIE expected the path to the directory with the new firmware as parameter fi PRINT "Please turn off your r0ket and connect your r0ket to a USB port." PRINT "Please press the r0ket joystick to the LEFT and turn the rocket on. Then press return" read sleep 10 flashFirmware #PRINT "Please unmount the roket in the finder. Press the eject button on the newly mounted device. Then press return" #read PRINT "Please turn off your r0ket." PRINT "Please press the r0ket joystick DOWNWARDS and turn the rocket on. Then press return" read flashDataflash cleanUp } main $@
Updating
If completed the steps above once, you can update your dataflash by copying the files from the 'files' directory in the archive to the mounted dataflash of your r0ket. Do not forget to properly 'eject' or 'unmount' the device or you might loose data!
init.txt · Last modified: 2013/07/31 21:28 by sec