added Reference Manual, increased Clock Brightness

Reference_Manual.md

@@ -0,0 +1,80 @@
+# ROFLS Arena Reference Manual
+
+### Before a fight/tournament (omit step 1-6 after initial setup):
+ 1. Check all connections
+ 2. Power on the PSU
+ 3. Turn on the Teambuttons and the Referee Remote
+ 4. Wait for the 7 Segment Clock to turn on (~2s)
+ 5. Turn on the lights (if off and needed)
+ 6. Open the Controller Box and set the brightness with the potentiometer on the top right
+ 7. Select the mode (explanations for the modes, see below):
+ 8. Press and Hold Reset for >1s, can be on the Controller itself or the Referee Remote
+ 9. Arena is ready
+ 
+
+### Start a normal fight:
+ 1. for good measure: Press and Hold Reset for >1s, can be on the Controller itself or the Referee Remote.
+ 2. Team Red and Team Blue need to (short) press their respective Teambuttons, the Clock turns green to signal that both are ready.
+ 3. Press Start, if the Teambuttons are not working, the Start button can be long pressed (>1s), to force a start.
+ 4. To prevent the automatic pit opening, press and hold the Pit button, as soon as the pit button gets released, the pit will open.
+ 
+### Start a rumble fight:
+ 1. for good measure: Press and Hold Reset for >1s, can be on the Controller itself or the Referee Remote.
+ 2. Press Start, if the Teambuttons are not working, the Start button can be long pressed (>1s), to force a start.
+ 3. To prevent the automatic pit opening, press and hold the Pit button, as soon as the pit button gets released, the pit will open.
+
+### Pausing a running fight:
+ 1. Press the Pause button
+ 2. To resume:
+  - normal fight:
+	Both Teams need to press their respective Teambuttons to signal that they are both ready.
+	- Press start, after 3s, the timer resumes.
+  - rumble fight:
+    - Press start, after 3s, the stop watch resumes.
+
+## Modes
+* Normal Mode:
+  * Normal fight mode, 3 Minute Timer, Tapout enabled, after 90s (halftime) automatic pit opening (if enabled)
+  * Teambuttons are active and need to be pressed once to sign that they are ready. They light up if ready.
+  * Teambuttons LEDs turn of when the fight starts
+  * During a running fight, if one of the Teambuttons is pressed >1s, it counts as a tapout. The Timer stops and displays "TAPOUT", cycles between "TAPOUT" and the end time.
+  * Can be paused, resuming works the same as starting, Teams must be ready
+* Rumble Mode:
+  * Rumble mode, stop watch counting up, Tapout disabled, after 90s automatic pit opening (if enabled)
+  * Match starts 3s after pressing start
+  * Teambuttons are inactive
+  * Teambutton LEDs Light up 3s before the match begins, and turn off when it starts.
+  * No Tapout available
+  * Can be paused, resuming works the same as starting, Teams must be ready
+ 
+## Buttons explained
+> The 4 buttons on the referee remote and the controller box have the same function and can both be used.
+ * Start
+   * Starts a fight, can be long pressed (>1s) to force start a fight
+ * Pause
+   * Pauses a fight
+ * Pit
+   * Short press (<1s) immediately opens the pit, Long press (>1s) prevents the pit from automatically open, but opens immediately after released
+ * Reset
+   * Resets the Arena Controller, needs to be long pressed (>1s)
+ * Lights Switch
+   * Turns on/off the Arena Lights, lights up if lights are on.
+ * Auto Pit Switch
+   * Turn on/off the automatic pit opening, lights up if enabled
+ * Mode Switch
+   * R = Rumble mode
+   * N = Normal mode
+   * T = Self Test (not implemented yet)
+
+## Display Colours & Status explained
+| Colour | Meaning |
+|--------|---------|
+| Blue with one purple segment, displaying 00:00   | not initialized (hit reset to fix)            |
+| Purple, displaying 03:00                         | Normal Mode, Idle/Arena Ready                 |
+| Green                                            | Normal Mode, Both Teams Ready/Running Fight   |
+| Yellow                                           | 3s Ready Countdown or Paused                  |
+| Yellow, initally blinking 3 times                | Timer run out / finish                        |
+| Red, cycling between tap, out and time           | Red Team has tapped out                       |
+| Blue, cycling between tap, out and time          | Blue Team has tapped out                      |
+| Teal, displaying 00:00                           | Rumble mode, Idle/Arena Ready                 |
+| Teal, displaying timer                           | Rumble mode, active fight                     |