Professional Documents
Culture Documents
TKD Scoring System: Developed by Alex Sajnovetzky
TKD Scoring System: Developed by Alex Sajnovetzky
TKD Scoring System: Developed by Alex Sajnovetzky
USER MANUAL
TABLE OF CONTENTS
System overview ………………………………………………………………………………... 3
Acronyms and abbreviations …………………………………………….……………………. 3
System summary …...…………………………………………….……………………………. 4
System connection ……………………………………………………………………………… 4
Setting up Windows application ………………………………………………………………. 6
Using the Windows application …………………………………………………..…………….8
Using the Android application …………………………………………………………….......23
System Requirements…………………………………………………………………………. 27
Agreement of terms and conditions………………………………………………………….. 28
License …………………………………………………………………….…………………… 29
System overview
The TKD Scoring System is an application that utilizes an intuitive user interface that makes
Taekwon-Do ITF competitions fast and efficient. This software provides different tools and
features to track the score of the competitors and store it for future analysis.
This program uses a client/server based model. The remote devices/controllers are the
clients who are connected wired/wireless to the local computer in the jury table.
This system can be connected to Android devices and any kind of controllers that are
compatible with the PC.
IP – Internet Protocol. A number address that is unique for every computer on a network.
LAN – Local Area Network. This is a network of computers that are located in close vicinity.
Port – A port number is a way to identify a specific process to which an Internet or other
network message is to be forwarded when it arrives at a server.
Router – Networking device that forwards data packets between computer networks.
Routers perform the traffic directing functions on the Internet. Data sent through the internet
is in the form of data packets and it is forwarded between remote devices.
NAT – The router has a function called Network Address Translation, or NAT, built in. Inside
your network, computers have local addresses like 192.168.1.100. All addresses in the
192.168.* range (or in the 10.*) range are "private" addresses. These addresses are how
computers in your network communicate with the router and with each other. Your router has
a separate network interface that connects it to the internet. The router gets an external and
unique address from the ISP (Internet Service Provider). This is the address that your router
uses it to communicate with other devices over the internet. Computers inside of your
network have non-routable private IP addresses, meaning that if they send packets directly
to the internet the packets will automatically be dropped (packets with private addresses are
not allowed to traverse the internet for stability reasons). But your router has a routable
address. Network Address Translation, as its name suggests, translates between these two
kinds of addresses, allowing the multiple computers inside of your network to appear to the
internet as one computer with one address.
Port forwarding - All network connection requests include a "port". The port is a number,
and it is part of how a computer knows what the packet is. Port forwarding on your router
allows you to enter a port number and a local IP address. All incoming connections to the
router IP with a matching port number will be forwarded to the internal computer with that
local address. Port forwarding allows redirecting incoming messages/packets to a specific
device in the network.
System summary
Each jury table uses its own computer running Windows OS. Those computers will run the
server application that will be connected to several devices. The user may connect Android
devices using a Wi-Fi/Cellular network or any compatible PC controllers (Wired, Bluetooth, or
any other controller which is compatible with your OS).
System connection
Option 1: Wi-Fi Network
Android App
Android App
Client
Client
TKD Scoring System
Server
Router
Option 2: PC Controllers
Connect PC controllers that are compatible with the PC. The user may connect wired,
Bluetooth, or any other controller which is compatible with the OS.
PC Controller
PC Controller
PC Controller PC Controller
• Run Setup.exe. This will begin the installation of the TKD Scoring System application.
Select the “Next” button.
• After installation complete, select the “Close” button. Then, run the new shortcut on your desktop.
1. Settings
The server application can be connected to Android devices using a Wi-Fi network or to
controllers that are connected via USB/Bluetooth. Changing the settings will fit the
connection mode you have been selected.
When this option is checked, all the Android devices should be connected to the same Wi-Fi
network that your PC is connected. The user should configure the same Local IP and Local
Port on Android devices.
• External Network:
The user may connect devices that are not in the same Wi-Fi network (For example mobile
phones with cellular connection). In this case, uncheck “Local Wi-Fi Network” and configure
the External IP and External port on the Android devices. To use this feature the user needs
to configure “Port Forwarding” on the router. Port forwarding is needed to redirect the
packets from Android devices to the specific PC in the Wi-Fi network. Read about port
forwarding and then follow this tutorial to configure it.
• Note: Create an inbound and outbound rule for the local/external port on Windows Firewall.
Then, go to Tools -> Settings. The user will see the buttons according to competition mode:
• Simple Mode:
2. Competition Modes:
2.1 Sparring Mode:
• Warnings
Add warnings to the red/blue competitor. Every three warnings will be calculated as one
point less to the corresponding competitor according to Taekwon-Do ITF rules.
• Faults
In case that the central umpire deducted point(s) to a competitor, the umpire in the jury
table may use the deduction buttons to reduce point(s) to the red/blue competitor. After
three deducted points the competitor can be disqualified according to Taekwon-Do ITF
rules. The system will ask for the umpire’s confirmation before disqualifying the
competitor. In case that the umpire decided to continue the match, the system will not
ask again to disqualify the competitor. To disqualify, the umpire can do it manually.
o Select pattern: Select the pattern that will be shown on the screen instead of
the “Optional Pattern” text. This option can be found in the menu, by double
clicking the “Optional Pattern” text or press Ctrl + P.
Available also in Simple Mode and Team Patterns Mode.
o Select rounds: Select the number of rounds for the current match.
Note: If two rounds are selected, the umpire will be not able to make the
decision (get the winner) until the two rounds are finished.
Select
deduction level
Change
visibility of
patterns label
Select rounds
number
• System warnings:
In case that the team does not perform the traditional sparring during the valid time,
the system will show a yellow warning in the corresponding button. Then, the umpire
in the jury table will decide if the team is disqualified (the disqualified team will
receive 0 points according to Taekwon-Do ITF rules).
Select
deduction level
Disqualify
according
to rules
• Acrobatic sequences: Each team cannot perform more than a total of three
acrobatic sequences of technique that is not part of the Taekwon-Do syllabus.
If it happens, the umpire can click the “Acrobatic Sequences” button and the team
will receive 0 points.
• In the event that a competitor is disqualified (injured, faults, other reason), the other
team will receive one point for every umpire connected.
• The umpire in the jury table can see the previous results by clicking on “All Results” button.
• The umpire will be not able to make the decision (get the winner) until the four rounds
are finished.
3. Connect
Select “Android” or “Controllers” mode in the menu or double click the left-bottom icon on the
main screen. On Wi-Fi network, click “Open Connection” to open the server socket for
incoming client’s connections. On Controllers mode click “Scan” to connect all the controllers
which are physically connected to the PC.
4. Clock
The TKD Scoring System includes an internal clock for sparring, team sparring and
traditional sparring modes.
e. Clock settings:
- Final Countdown Interval: Interval in seconds to change the clock text color to Final
Countdown Color in PC Screen.
• According to Taekwon-Do ITF rules, extra time will be given in the following cases:
a. Injury – medical attention: three total minutes for the entire match. This amount of
time will be recorded, and if the doctor is called again to the same match, the injury
clock will resume counting down from the last point.
b. Equipment Check: The competitor has a maximum of three minutes to change what
is requested.
c. Coach: A removed coach must be replaced by another coach, or by a competitor
wearing a coach’s outfit, within a two minute time limit.
• The umpire can open the extra time panel by double clicking the competitor color on the
main screen.
• The umpire can manually update the clock (in case of mistakes) by double clicking the
clock.
5. Log files
The logs files will help the user to debug the application in case of errors. Every action in the
system is stored in these files. Logs files contain information about connected devices,
messages between clients to the server and the matches’ results after every round.
* The user can click “Open Log” or press Ctrl + L to debug the server application.
6. Additional features
After each match, the umpire may click “Make Decision” to calculate points according to
Taekwon-Do ITF rules. After calculating the current points, the winner will be announced.
Sparring/Team Sparring Mode: In case of TIE, the umpire will be asked to open a new
timer for a shorter round.
The user can get the last results by clicking the “Last Results” button on the PC screen.
In addition, all the results are saved in the “Results.xml” file. By default, the results files are
saved in the default directory (C:\Logs). The user may load older results files from the
toolbar menu: File -> Load Results From File.
* The user may save matches results into an Excel file by clicking “Export” in the
results form. Please notice that only the selected tab will be exported.
* In case that there are missing files in the Office installation in your local PC, the
system will not be available to create the Excel file. In this case, use the “Copy To
Clipboard” function and then paste the information in a new document.
After connecting the controllers to the PC, the user may set umpires’ names and gender.
Double click on the umpire name to set a new name or double click the umpire picture to
switch between genders. On Wi-Fi network mode, this feature is not necessary because the
umpire name and gender are registered on the Android device.
The user can enable this feature on the menu or press Ctrl + V. The system will check that
there are 4/5 umpires connected (depending on the competition mode) before calculating the
results. For test purposes, the user can disable this feature.
Note
The system will calculate the winner according to Taekwon-Do ITF rules.
The winner is the competitor obtaining the majority of umpire votes, with a minimum of two (2)
umpire votes in his favor.
6.7 Disqualify
The umpire may disqualify a competitor by pressing right click on the competitor color and
selecting “Disqualify Competitor”. Then, the umpire will be able to select the reason for
disqualification that will be shown in the competition results file.
Update umpires' total points by double clicking the label of the red/blue point on the main
screen. This feature will be enabled only for connected umpires.
6.9 TV Screen
7. Umpire Emulator
• The umpire emulator works with Wi-Fi Network and Controllers modes.
• You may use real and virtual devices at the same match.
• Click the Umpire Emulator button various times to create many instances.
1. Connect
The user may connect the Android device to the TKD Scoring System in two ways:
1. Using Wi-Fi Network (Use local IP and port).
2. Using Cellular Network (Use external IP and port).
In both cases, go to connection settings in the Windows Application and copy to the Android
devices the IP and port.
The user can open the QR code generator in the Windows Application and scan it in Android
devices (This feature is available only if the user installed the APK directly from the website.
Not available if the user downloaded the APK from Google Play).
Note:
The Android device will try to connect during 5 seconds, in case of failure please verify that
the PC connection is open and properly configured.
2. Competition Modes
Description:
• During the fight, the umpire should click the scoring buttons of the relevant competitor.
• Undo buttons - undo the last operation of the relevant competitor.
Description:
• During the round the umpire should click the deductions buttons of the relevant
competitor.
• Undo buttons - undo the last operation of the relevant competitor.
• 0 button – Set 0 points to the relevant competitor.
Description:
• During the round the umpire should click the deductions buttons of the relevant competitor.
• Undo buttons - undo the last operation of the relevant competitor.
3. Troubleshooting
• Disconnection of a device from the server application:
o Delete umpire from the ring: Right click on umpire name -> Delete umpire.
o Reconnect: Close the Android app, restart Wi-Fi/Cellular network and reconnect.
o In case of failure, close the TCP connection in the PC server and reopen it (in this
case all the umpires should reconnect).
• Recommendations: The Android app disables the lock screen to prevent screen locking in
case that the umpire did not touch the device screen for a while. We suggest disabling
phone calls during the competition (Do Not Disturb mode in Android phones).
• Battery: To keep the battery life, reduce the screen brightness and charge the Android
device before the competition. In case of low battery, disable “vibration on click” is
recommended.
• Mismatch protocol: In case that the user receives a “mismatch protocol error” verify
that both applications versions (PC + Android) are the latest. Please contact us to get
the latest PC application. The latest Android application “TKD ITF UMPIRE” is
available in Google Play.
System Requirements
Minimum requirements:
• PC: Intel Core i3 processor, 4GB Ram, Windows 10, 10 GB HD free space.
• Controllers: Any PC controller that is supported by Windows Operating System.
• Android Device: Android 6.0, 4GB Ram.
Recommended requirements:
• PC: Intel Core i5 processor, 8GB Ram, Windows 10 64 Bit, 10 GB SSD free space.
• Controllers: Any PC controller that is supported by Windows Operating System.
• Android Device: Android 8.0, 4GB Ram.
Additional recommendations:
The following terms will govern the relationship between the owner of the intellectual
property ("IP") and the user of the IP:
1. The owner will allow the user to use the IP that is the basis of these terms only for
personal use on which the sides agreed upon in advance, during the license validity.
The use of the IP by the user for any purpose not agreed upon in advance or outside the
timeline defined will be regarded as a fundamental breach of the terms of use. In any case,
the use of the IP shall be "fair use" as this term is defined by Israeli law.
2. The owner will not responsible for the outcome of the event in which the IP has been
used.
3. The user or anyone on his behalf shall not transfer the IP to a third party by any
circumstances unless otherwise agreed by the owner in advance.
4. The use of the IP outside the timeline defined above is forbidden and will be regarded as
a fundamental breach of terms unless otherwise agreed by the owner.
5. The courts of Israel will have the jurisdiction to enforce these terms of use and to set the
compensation in case of a breach.
6. The proper functioning of the IP requires meeting the technical requirements specified in
the user manual article.
License