More documentation

README.md

@@ -1,7 +1,32 @@
 # c3gov
 Fill out your hacker passport using a professional dot matrix printer.
 
-## Hardware Requirements
+## How to use the official® setup
+
+### Start up
+1. Plugin the Raspberry Pi.
+2. Mind the following order:
+  1. Insert the RS232 adapter for the client(s) and connect them.
+  2. As the last device insert the RS232 adapter for the printer.
+  3. Turn on the printer.
+
+### If the interface freezes
+1. Turn off the printer.
+2. Unplug the RS232 adapter from the Raspberry Pi.
+3. Replug all RS232 in the order like described above.
+
+### Turning off
+1. Turn off the computer.
+2. Unplug the RS232 adapter from the Raspberry Pi.
+3. Turn off the Raspberry Pi.
+
+## General information
+
+### Configuration
+
+See the `./config` file to set the client number and the event name.
+
+### Hardware Requirements
 - Wincor Nixdorf HighPrint 4915
 - Raspberry Pi
 - 3x - 5x USB RS232 adapter (male -> USB)
@@ -10,17 +35,14 @@ Fill out your hacker passport using a professional dot matrix printer.
 - 2x RS232 connector (female -> female)
 - 2x old laptops with some debian without GUI, only tty.
 
-## Software Requirements
+### Software Requirements
 For the clients:
 - screen
 
 For the Raspberry Pi
 - dialog
 
-## Set event name
-To set the event name, just change the `EVENT` variable in `./start_dialog` at the top.
-
-## Supported Passports
+### Supported Passports
 The following passports are supported atm:
  - CmS Junghackerpass
  - Bound Diplomatic passport by Mitch Altman (TVBGone) Matthew Borgatti (har.ms)