reform2-keyboard-fw/flash.sh: add more detailed instructions

reform2-keyboard-fw/flash.sh

@@ -48,16 +48,28 @@ devnum_keyboard=
 if [ -n "$path_keyboard" ] && [ -e "$path_keyboard" ]; then
 	busnum_keyboard="$(udevadm info --query=property --property=BUSNUM --value "$path_keyboard")"
 	devnum_keyboard="$(udevadm info --query=property --property=DEVNUM --value "$path_keyboard")"
+	echo " 1. Find out your keyboard firmware version in the 'System Status' by pressing" >&2
+	echo "    the circle key followed by the S key. The keyboard firmware version is on" >&2
+	echo "    on the last line in a date-based format YYYYMMDD. Then either:"
 	echo >&2
-	echo "Press the circle key followed by the X key to enter firmware update mode." >&2
+	echo " 2.A. If you are on keyboard firmware version 20231124 or newer:" >&2
 	echo >&2
-	echo "If you have an old version of the keyboard firmware, you might need to:" >&2
-	echo "- Toggle the programming DIP switch SW84 on the keyboard to “ON”." >&2
-	echo "- Then press the reset button SW83." >&2
+	echo "       2.A.1. Press the circle key followed by the X key to enter firmware update mode." >&2
 	echo >&2
-	echo "Waiting for the keyboard to disappear..." >&2
+	echo " 2.B. If you are on keyboard firmware version older than 20231124:" >&2
+	echo >&2
+	echo "       2.B.1. Toggle the programming DIP switch SW84 on the keyboard to “ON”." >&2
+	echo "       2.B.2. Press the reset button SW83." >&2
+	echo >&2
+	echo "    ATTENTION: Do not remove the keyboard bezel without having disconnected" >&2
+	echo "               both battery boards first. If you don't want to remove the" >&2
+	echo "               bezel you can reach both the programming DIP switch as well" >&2
+	echo "               as the reset button with a non-conductive thin stick (like" >&2
+	echo "               a wooden toothpick) behind the F4 key." >&2
+	echo >&2
+	echo " 3. Waiting for the keyboard to disappear..." >&2
 	udevadm wait --removed "$path_keyboard"
-	echo "Waiting for the Atmel DFU bootloader USB device to appear..." >&2
+	echo " 4. Waiting for the Atmel DFU bootloader USB device to appear..." >&2
 	udevadm wait --settle "$path_keyboard"
 fi