User Manual - pietwauters/esp32-scoring-device GitHub Wiki

Use case 1: No remote

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 coloured 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 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.

Use case 2: With remote control app connected to the scoring device access point

In this use case the remote control app is running on a device directly connected to the scoring machine's access point. No other networking is involved.

Step1: Connect to Access Point

Open the WiFi setting on your mobile device. Look for a network named ESP32_XX (where XX is the number of the scoring machine) and connect to it using the provided password. (The password can be changed in the file FPA422Handler.cpp) If you use the code as-is, the defaults are:

Network credentials Example QR Code
SSID: ESP32_01 Passwd: 010419671 Brooddoos1 (6)

|

Step2: Open the remote control app

Screenshot_2022-05-29-17-35-57

As soon as you press any button on the remote control, the text display will start to alternate between score, time and period. This shows that at least one remote control is connected to the device.

Step3: Select Match type

Select what type of match is happening using the "Mc" (short for match count) button. Pressing the Mc button will cycle between

  • 1/1 (pools)
  • 1/3 (direct elimination (individual))
  • 1/9 (team events)

Step4: Fence!

Use the remote to start / stop the timer, awards points, cards, ...

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 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 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 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.