Application for trail-o punching and timed control operation

Version: 4.9.2(7)
Translation: Libor Forst, Radka Hacklová, Adam Dingle
Acknowledgements: Antonín Forst, Lenka Forstová, Ján Furucz, Sami Hyvönen, Martin Jullum, Zuzana Kosová

Introduction

► This help is for application users, i.e. marshals and competitors. Help for organisers is on the application web page http://ant.yq.cz.
► ANT can run in several modes:
 • Timed control answer recording and time keeping by a marshal.
 • Timed control answer selection and time keeping by a competitor.
 • Punching classic course (Pre-o) answers by a competitor on a device carried by him/her (mobile card mode).
 • Punching classic course (Pre-o) answers by a competitor on a device placed at a punching station.
 • As a start and finish point device.
► The application must be configured for an event. The configuration procedure depends on whether you have a configuration file (prepared by an organizer or a downloaded sample from the server ant.yq.cz) or whether you have to configure the application by yourself.
► If you want to test the application only using a sample, press the Sample button on the initial screen and select any sample. ANT will download the configuration, a competitor selection dialog appears on a screen (see Selecting Competitors) and the application is prepared for testing.
► If you have a configuration from the organiser, press the Event button on the initial screen, select the server where the configuration is stored, select the right event and ANT will download the configuration. If you are a timed control marshal, you will usually need to visit the Stations menu (see Stations and Courses Configuration) to activate stations which you will work at.
► If you have no configuration, you will have to visit more menu items including Preferences, Event, Stations, Courses and maybe Startlist and Maps (see the corresponding help topics).
► When your configuration is complete the competitor selection screen appears (see Selecting Competitors) and you can start your punching or a work at timed control.
 • Using ANT at a timed control is described in the Marshal at a Timed Control chapter.
 • Mobile card punching is described in the Punching on a mobile card chapter.
 • Punching at a punching station is described in the Punching at a punching station chapter.
 • At a start point you only need identify yourself and when you start your timer, ANT will record this time.
 • At a finish point you only identify yourself and ANT will record your finish time.
► Before the competition, charge your phone/tablet fully and cut your fingernails. :-) Or keep in mind that you can use your fingertips instead.

Setting Preferences

► If you don't like using your phone/tablet's default language, or this language is not supported, you can choose one of the supported languages. However, we recommend restarting the application after changing languages.
► ANT needs a working directory to be set. Normally ANT chooses it by himself, but sometimes a publicly accessible directory must be set manually.
► At timed controls, ANT displays instructions and questions that marshals must give to competitors. They have two parts: one is given before showing the scene, the other afterward. You can choose whether ANT shows them on two separate screens, or together on a single screen.
► To prevent unintentional answers selection when punching, you can choose to protect task selection by configuring ANT either to require a double click when you select a task, or to have you confirm each task selection using an extra button.

Setting System Permissions

► ANT needs permission to change the general settings of the phone/tablet so that it can disable automatic sleep mode.
 • If access to this setting is not permitted, you should manually set the screen off timeout to several minutes.
► ANT needs access to the "Do Not Disturb" mode setting so that it can reject incoming calls solely for the period of running the timer.
⚠ Some phone applications are so invasive that they ignore this setting. We recommended making a test call to the device while measuring times! ⚠
 • If access to this setting is not permitted, you should disable incoming calls manually.

Event Configuration

► Before using ANT for a new event, you should use the Clear Event button to clear the old configuration. If there are also old result files, the program will ask you whether to delete them or not.
 • Respond No in the typical case. Files from old events cause no problem and they might be used later for further analysis.
 • Respond Yes only if you tried the application before the event and you have stored meaningless data.
► If you have a configuration file prepared, you need only configure the Configuration File item according to the instructions from the organizer (see Selecting Resources/Targets) and the application will load the configuration by itself. This will complete the configuration and you can leave the dialog via the Done button.
► The following steps are typically needed only if you create a configuration by yourself.
► The Event ID item is needed for distinguishing events when processing multiple result files.
► If you configure an event on another day than on the day of the competition, you can change the date.
► In mobile card mode you can choose whether competitors can answer in free-order and whether they can change their answers.
► For testing purposes you can enable Test mode in which ANT does not set the Do Not Disturb mode and screen off timeout.
► You can choose a method of competitor identification. Besides identifying by name or startnumber it is also possible to use NFC chips. In this case you can choose whether unknown chips are to be assigned to competitors in the startlist.
► You can lock the menu so that competitors cannot change event settings. You must then set a PIN and/or set of chip numbers for marshals to be able to unlock the menu.
► For timed controls, you can specify that there will be a second timekeeper and both times will be stored to the result file.
► Instructions to be displayed or told to competitors may be in English or in the application language.
► At timed controls, ANT displays instructions and questions that marshals must give to competitors. They have two parts: one is given before showing the scene, the other afterward. You can choose whether ANT shows them on two separate screens, or together on a single screen.
► It is also possible to choose which information and questions will be displayed and in what order.

Stations and Courses Configuration

► If you have station/course data prepared by the organiser, this configuration is pretty easy:
 • For timing at a timed control or punching at punching station just check and activate each station/course you will be using by clicking a button at the beginning of the row.
 • At a timed control, you can also check and fix the number of flags so that you give competitors correct information.
► If you configure an event by yourself, you must enter station/course data in editing mode, which you can switch to by pressing the button in the top right corner. Station parameters:
 • Class (if defined by the organizer, e.g. category, stage, heat)
 • Station/course part number
 • Number of flags at station
 • Zero answers
 • Number of tasks at station/in course part
 • Time limit in seconds (timed controls only)
 • Number of seconds before time limit to warn competitors (timed controls only).
► New stations/course parts can be added by the Add button.
► You must confirm your changes by pressing the Done button.

Loading and Viewing the Startlist

► The application can work with a startlist in several modes:
 • No startlist is used (option No startlist).
 • Sample startlist for testing.
 • The startlist is a part of the configuration file (no action is needed in this case since the startlist will be loaded automatically).
 • The organiser has published a startlist on a web server and specified its URL address in the configuration file. In this case you can load the startlist by clicking the download button.
 • The organiser has provided a startlist in a separate file. In this case you should enter/select its path (see the help for the Selecting Resources/Targets dialog) and it will be loaded.
► If a startlist is loaded, you can preview it by clicking the button with the magnifier icon.

Map Configuration

► If you want to use maps you have to define a map source:
 • In the case of a web source, you enter the URL and after the tarball with maps is downloaded, it will be extracted to an internal directory.
 • If the maps are already present on the local filesystem, you have to specify the root directory (with maps or with per-class directories with maps).
► While registering answers, the device display orientation is fixed. You can choose portrait or landscape orientation according to which one is better for your particular map format.
► For each station, you have to set the following attributes:
 • Map image zoom (in %).
 • A flag indicating whether maps are complete (they include control descriptions and a north arrow), or whether the maps and descriptions are in separate files.
 • The counterclockwise rotation angle requested (i.e. viewing direction in degrees).
 • A flag indicating whether the map is to be cut in a circular shape.
► You can preview maps for a station by clicking the magnifier button.
► You must confirm your changes by clicking the Done button.

Selecting Resources/Targets

► This dialog appears in several situations where a resource (for data input or output) is to be chosen. If you are a marshal or a competitor, you will typically use it just once, to select the location of event data provided by organisers.
► The resource can be located in various places:
 • If the resource is on a web server, you should enter the URL address (except the case of servers ant.yq.cz and preoresultat.se, whose URL is known). Besides the address, the event ID is usually also required. If the server supports this function, you can download the list of events (using the button with the magnifier icon) and select the proper one by clicking on a particular list item.
 • If the resource is on a server running on another ANT device (ANT Master Server) you must check and possibly correct the IP address in the URL.
 • If the resource is on the local filesystem, you can enter a file or directory path manually, or select it by browsing the disk (using the magnifier icon button).
 • If the resource is on a device connected via Bluetooth you will need to switch Bluetooth on and pair the devices. ANT will bring up the appropriate system setting dialog.
► Any additional data (e.g. password, character set etc.) provided by the organiser should be entered into the appropriate fields.
► For HTTP uploads, you can specify a timeout to prevent an extremely long wait in case of network problems.

Selecting Competitors

► A competitor name and/or start number can be either selected from the startlist or entered manually, or (s)he can be identified by placing an NFC chip at the reverse side of the device. You can switch between these modes using the buttons with the NFC and keyboard icons.
► If you have a startlist loaded, you can type any part of the name or number (and thus avoid typing any non-ASCII/national alphabet characters) and a scrollable filtered list of competitors will appear. If you use a space as the pattern, you will get the entire startlist.
► If you use the application buttons with digits, the filtered list is shown only after you click the filter button (funnel icon), or when the selection is unique.
► The full funnel shows all competitors; the empty one only those who haven't finished a particular station/course part yet.
► The vertical orientation of your phone/tablet is better because the list of competitors appears immediately.
► In horizontal orientation, you can achieve a similar effect by pressing the Done button after entering enough characters of the name or number.
► If you want to time a competitor who is not present in the startlist (or if you have no startlist) you must enter their whole name manually.

Marshal at a Timed Control

► As soon as you press the NOW! button, the timer starts and answer buttons (incl. the X button for any invalid answer) appear.
► After the last answer or when the time limit is over, the Stop button (with a black square) appears, however the timer doesn't stop and any additional answers and times will still be recorded (so that they will be available in any case).
► If you press a wrong button, press the correct one afterwards and keep going. If you press a button by mistake, keep going. ANT lets you correct mistakes such as these before saving the data.
► If you pressed the NOW! button prematurely, you have two choices:
 • Either just click arbitrary answers, then remove the record and return back to the start of timing.
 • If only a few seconds have passed, let the timer run, finish the start procedure and press the X button when starting for real. Later you can remove this first "answer" and move the start (using the Move start button).
► If a call arrives while you are measuring time, a phone application window may pop up temporarily, covering the display. In such case, no action is required, the window will disappear right away without disrupting the measuring process.
► The only way to exit this dialog is to press the Stop button.

Recording Answers and Times

► After stopping the time, the competitor's full results will appear. In the exceptional that a problem has occurred, you can change the competitor name, time and answers.
► If you chose the wrong competitor before starting, you can change the name manually, or select the correct one from the startlist using the magnifier icon (after finishing the selection you can return to edit mode via the icon with a "tick").
► You can insert an unrecorded answer. A typical usage is when the competitor turns over two maps at a time.
► You can change any answer by clicking the answer button.
► You can remove an answer clicked by mistake and the application will let you keep the original time, or use the later one.
 • Respond Yes, if you pressed the wrong button right when a competitor was answering and you corrected the answer afterwards.
 • Respond No, if you pressed a button by mistake, although the competitor did not answer.
► Using the +1/-1 buttons, you can adjust the total time by one second up and down.
► It is recommended to note changes in the Comment field.
► All changes can be revoked using the Restore button.
► The whole record can be also irrevocably deleted by the Remove button.
► The only way to exit this dialog is to press the Save button.
► If you close the window before copying the answers and time to the competitor's card, you can restart this dialog using the Review Last Record action of the main menu Special Actions item. ► Later, you can also visit the Results and look at the result file.

Punching on a mobile card

► In mobile card mode (the phone/tablet is carried by a competitor) you identify yourself before the start, then you select the (part of a) course to compete in (if there is just a single part, this step is skipped) and then a screen with a start (triangle) button appears.
► After starting the timer, you see buttons for all tasks in the selected (part of the) course.
► To initiate punching an answer, first click the button with the corresponding task number. Then, all possible answer buttons appear and you can select one by clicking on it.
► After punching an answer, it is shown on the corresponding task button. You can later change the answer by clicking on it again, if it is permitted by the organiser.
► To prevent accidental unwanted punches, you can press the Back key or Lock button between individual punchings. The application becomes hidden and you can recall it later.
► After completing all tasks, you stop the timer by clicking on the stop (black square) button. WARNING! Stopping the timer must be approved by clicking a special button within 5 sec.
► There are other methods for preventing unintentional screen touches. You can activate them in the Preferences menu (see Setting Preferences).

Punching at a punching station

► When punching at a punching station, you identify yourself by an NFC chip or by name and/or startnumber and a list of tasks to be answered at this station appears.
► You select a task by clicking anywhere on its row. WARNING! The task must be selected within ca 5 sec. after which ANT will log you off.
► If there is just a single task at a station, this step is skipped.
► As soon as you select a task, answer letter buttons appear and you can choose an answer by clicking one of them.
► The result is immediately saved to the local disc of the device and ANT lets you continue by answering another task (Next button) or logging off (End button).

Results Management

► The Results page shows you all result files saved in the internal storage of the phone/tablet. You can review, remove and upload them.
► Essential information (total time and answers) appears in result file lines immediately following the competitor name, in the result file line.
► For uploading results you have three possibilities:
 • Uploading to a web server (it might be secured by a password that you must enter in the upload configuration dialog).
 • Transferring to a device connected via Bluetooth.
 • Uploading (e.g. to a PC) over USB.
► If a file contains results which have not yet been uploaded, the corresponding button has a green border.
► All result files that have not yet been uploaded can be sent to the server using the button at the bottom right corner (with a double arrow).
► WARNING! Uninstalling the application will remove all these files!

Results Upload

► The application has several modes for uploading results; you can switch among them according to your needs and connection quality:
 • Manual - The marshal can start an upload manually by clicking the upload button on a line on the Results screen.
 • Automatic - The upload is started after saving each competitor's result.
 • Batch - The upload occurs automatically after every few competitors; the application will ask you for permission to make an upload attempt. You can specify the number of competitors in this case.
► In automatic and batch mode, you can specify a timeout to prevent an extremely long wait in case of network problems.
► If the automatic or batch transfer fails, the application offers to open this dialog where you can change the parameters of future uploads.
► The Package Content option is usually defined by the organiser. It controls whether every transfer contains the entire result file, or just the records saved after the last successful transfer.
► All changes must be confirmed by the Done button.

ANT Master Server

► On an ANT device you can run an HTTP server for downloading the configuration and uploading results. The server can be invoked by the ANT Master Server item of the Special Actions menu.
► Before starting the server, you can choose whether configured devices will send results to your server, or to the same location that your device sends them to.
► After starting, the server begins accepting result files and counting the number of received records. At a suitable moment, you can stop the server and if you have enabled automatic uploading to the final server, ANT will try to send all new results.

Problem reporting

► If you encounter a problematic behavior of the app, we would appreciate it if you could save the application log as soon as possible and then send it to us with some comment. You can start the log management module from the menu using the Problem reporting item.
► The Save log button saves a copy of the current system log to a new file so that it can be later sent to developers and also lets you add a comment directly.
► For uploading logs you have three possibilities:
 • Uploading to a web server (ant.yq.cz).
 • Transferring to a device connected via Bluetooth.
 • Uploading (e.g. to a PC) over USB.
► WARNING! Uninstalling the application will remove all log files!