Differences

This shows you the differences between two versions of the page.

--- init [2011/12/22 23:25] – schneider
+++ init [2013/07/31 21:28] (current) – Change according to Sven Neuhaus sec
@@ Line 1: / Line 1: @@
-====== **This page is contains the current release of our 28C3 firmware. Feel free to try it and give us feedback if you discover bugs in the firmware or these instructions** ======
+====== ** 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 flash your roket? ======
+====== How to flash your r0ket? ======
-<note tip>Flashing your r0ket ensures you will get the full functionality on the 28C3. It is highly recommended you flash your old r0ket before attending the congress.</note>
-<note tip>We will bring a device to the 28C3 that will do the steps below for you. If you can, please try to flash it your self. This helps to reduce the waiting time on congress :)</note>
+<note tip>Flashing your r0ket ensures you will get the full functionality. It is highly recommended you flash your old r0ket before attending the congress.</note>
 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-28c3-r1.tar.gz}}
+  - Download the firmware pack here: {{:r0ket-firmware-r15.tar.gz}}
   - Unpack the archive with your favourite tool.
   - Turn r0ket off (switch position up).
@@ Line 20: / Line 30: @@
   - 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-r1 && ./flash-r0ket
+    - cd r0ket-firmware-28c3-r6 && ./flash-r0ket
   - The script should tell you, that everything went fine.
   - Turn r0ket off.
@@ Line 26: / Line 36: @@
   - Turn r0ket on.
   - As above look for a new volume on your system. Mount the r0ket if you don't get one.
-  - Make a copy of the following files to your computer: R0KET.CFG, NICK.CFG, privx.key, privy.key and pub.key
+  - <note important>If you already completed the steps below before, please jump to [[init#updating|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:
@@ Line 39: / Line 50: @@
       - Example: <code>sudo dd if=dataflash.img of=/dev/sdb</code>
     - <code>sync</code>
+      - 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.
@@ Line 46: / Line 58: @@
 ===== Windows =====
-  - Download the firmware here: {{:r0ket-firmware-28c3-r1.zip}}
+  - Download the firmware here: {{:r0ket-firmware-r15.zip}}
-  - Turn r0ket off (switch position down)
+  - Turn r0ket off (switch position up)
   - Plug micro-USB cable into r0ket and Computer
   - Hold joystick to the left
-  - Turn r0ket on (switch position up)
+  - Turn r0ket on (switch position down)
   - Release joystick
   - Wait about 30 seconds.
@@ Line 67: / Line 79: @@
 **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
+    - <code> ./flashscript r0ket-firmware-r15 </code>
+FlashScript UNSAFE (user errors might cause loss of data and corruption)
+<code>
+#!/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 $@
+</code>
+===== 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!