User Manual - pietwauters/esp32-scoring-device GitHub Wiki
Introduction
The scoring device is designed to have no physical buttons. This makes it easier to have permanent installations without the need for physical access to the device. In general the device selects the correct weapon automatically using a smart detection algorithm (see below). When used during training, this is most often good enough. When used in competition mode, an Android smartphone can be used as a remote control.
Use case 1: No remote (training mode)
In its most simplest use case, the scoring device is pure stand-alone, not connected to the remote control app. The text display (if available) shows the currently detected weapon. When the device is powered up, it starts in automatic weapon detection mode in Epee. To switch to a different weapon, both fencers make a hit on valid surface, continuously for about 5 seconds. Both colored lights will light up, indicating the device has detected that different weapons are connected, and the switch has happened. The text display will indicate the newly detected weapon. The fencers can now fence normally. On foil or sabre, when both fencers are disconnected for a long time (more than 1 minute) the device will switch automatically to epee to save power and to silence the device.
Use case 2: With remote control app connected to the scoring device's access point
In this use case the remote control app is running on an android device directly connected to the scoring machine's access point. No other networking is involved so there is no need for a global WiFi network.
Step1: Connect to the devices Access Point
Open the WiFi setting on your mobile device. Look for a network named Piste_XYZ (where XYZ is the number of the scoring machine) and connect to it using the provided password.
If you use the code as-is, the defaults are:
- password = 01041967.
- PisteNr = Piste_500.
Step2: Open the remote control app
The remote control app has multiple screens that can be reached by swiping up, down, left or right. (See ...) The main screen has one big Start/stop button to control the timer, buttons to change the score, a reset button and a button to go to the next period or break.
As soon as the remote control is connected, the text display will start to alternate between score, time and period. This indicates that at least one remote control is connected to the device.
Step3: Select Match type
In the remotecontrol app, swipe up to go to the "Basic Device Settings" tab. Select what type of match is happening using the "cycle match type" button. Pressing this button will cycle between
- 1/1 (pools)
- 1/3 (direct elimination (individual))
- 1/9 (team events) The selection will be shown on the device.
Step4: Fence!
Use the remote to start / stop the timer, awards points, cards, ... The screen for the cards and priority is accessed by swiping left from the main screen.
When the timer is running, this is indicated by fast blinking of the ":". Only the time is shown. When the timer is not running, the ":" is steady, and the text display cycles between time, score and period.
When the timer reaches zero no more hits will be registered during 10 seconds. After this period, hits will be registered again normally. Next to this, the following will happen, depending on the type of bout you're in:
Pools
If the score is equal, an extra minute is shown (and the text display will show x/1 to indicate this is the extra minute). The referee should press the Prio button to determine which side has priority. The scoring device will show an animation and indicate which side has priority (until prio is pressed again or the device is reset). When the timer reaches zero again, the match is considered to be ended. The referee should do a long-press reset to go to the next bout.
Individual Direct Elimination
When the timer reaches zero at the end of the first or the second 3 minute period, 1 minute is shown on the text display. The timer is stopped until the referee starts it. At the end of the one minute breaks, the device will automatically increase the period, and show 3 minutes. If at the end of the 3rd period, the score is equal, an extra minute is added. See also Pools.
Team events
At the end of every relay, the timer is reset to 3 minutes (cards that have been given during this relay will be cleared), and the period is incremented. If at the end of the 9th relay, the score is equal, and extra minute is added. See also Pools.
Non combativité (unwillingness to fight, passivity)
The device has an extra timer for unwillingness to fight (UW2F). This is indicated by a "blue" bar in the middle of the lights display. Every 10 seconds during which no hit was made, an extra led lights up. When the timers reaches 1 minute, the top of the bar lights up in red, to warn the referee that he should apply the unwillingness to fight rules.