Application for trail-o punching and timed control operation

Version: 4.9.1(6)
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 answers recording and time keeping by a marshal.
 • Timed control answers 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).
 • Punching classic course (Pre-o) answers by a competitor on a device placed at a punching station.
 • 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 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, you press the Sample button on the initial screen and select any sample. ANT will download the configuration, a competitor selection dialog occurs on a screen (see Selecting Competitors) and the application is prepared for testing.
► If you have a configuration from the organiser, you press the Event button on the initial screen, select the server with the configuration stored, select the right event and ANT will download the configuration. If you are a timed control marshal, you will usually need to visit a Stations menu (see Configuring Stations) to activate stations which you will work at.
► If you have no configuration, you will have to visit more menu items like Preferences, Event, Stations, Courses and maybe Startlist and Maps (see particular help topics).
► Whenever your configuration is complete a competitor selection screen occurs (see Selecting Competitors) and you can start your punching or a work at timed control.
 • Using ANT at timed control is described in the Marshal at Timed Control chapter.
 • Mobile card punching is described in the Punching on mobile card chapter.
 • Punching at punching station is described in the Punching answers on course chapter.
 • At a start point you only identify yourself and when you start your timer, ANT records this time.
 • At a finish point you only identify yourself and ANT records 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 to be given 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 screens, or all on a single screen.
► To prevent an unintentional answer selection when punching, you can choose to protect task selection either by mandatory using of doubleclick, or approving the selection by 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 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 must only configure the Configuration File item according to the instructions from the organizer (see Selecting Resources) and the application will load the configuration by itself. Hereby, the configuration is completed and you can leave the dialog by the Done button.
► 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 competition one, you can change the date.
► In the 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 switch on a Test mode when ANT does not set the Do Not Disturb mode and screen off timeout.
► You can choose a form 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.
► It is possible to lock a menu so that competitors cannot change event settings. It is then necessary to 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 another 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 to be given 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 screens, or all on a single screen.
► It is also possible to choose which information and questions will be displayed and in what order.

Configuring Stations and Courses

► If you have station/course data prepared by the organiser, this configuration is pretty easy:
 • For timing at timed control or punching at punching station just check and activate each station/course you will be using by clicking to a switch at the beginning of the line.
 • 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/course part
 • Time limit in seconds (timed controls only)
 • Number of seconds before time limit to warning (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 the startlist should be loaded 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 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 %).
 • The 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).
 • The 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

► 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:
 • In the case of 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 a button with the magnifier icon) and select the proper one by clicking on a particular list item.
 • In the case of location on a server running on another ANT device (ANT Master Server) you must check and fix an IP address in URL.
 • In the case of the local filesystem, you can enter file or directory path manually, or select it by browsing the disk (using the magnifier icon button).
 • In the case location on a device connected via Bluetooth you will need to switch Bluetooth on and pair the devices. Particular system setting will be called by ANT.
► Eventual additional data (e.g. password, character set etc.) provided by the organiser should be entered to appropriate fields.
► For HTTP uploads, you can specify the 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 putting an NFC chip to the reverse side of the device. You can switch between these modes using a button with an NFC or keyboard icon respectively.
► 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 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 Timed Control

► As soon as you press the NOW! button, the timer starts and answer buttons (incl. button X for any bad answer) appear.
► After the last answer or when the time limit is over, a Stop button (with a black square) appears, however the timer doesn't stop and additional answers and times are recorded for the case of an error.
► 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 it is just a few seconds, let the timer run, finish the start procedure and press the X answer 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 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 case of problems, 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. Typical usage is when the competitor turns 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 from the main menu Special Actions using the Review Last Record item.
► Anytime later, you can also visit the Results menu and review the result file.

Punching on mobile card

► In the mobile card mode (phone/tablet is carried by a competitor) you identifies yourself before the start, then you select the (part of) course to begin (if there is just a single part, this step is skipped) and then a screen with a start (triangle) button occurs.
► After starting the timer, you see buttons for all tasks in the selected (part of the) course.
► Punching of an answer is invoked by clicking to particular button with the task number. Then, all possible answer buttons occur and you select one by clicking on it.
► After punching an answer, it is shown on particular 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 to a special button within 5 sec.
► There are other methods for preventing an unintentional screen touching. You can activate them in the Preferences menu (see Setting Preferences).

Punching answers on course

► 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 occurs.
► You select a task by clicking anywhere on its row. WARNING! The task must be selected within ca 5 sec. then ANT logs you off.
► If there ia just a single task at a station, this step is skipped.
► As soon as the task is selected, answer letter buttons occurs and you choose an answer by clicking to one of them.
► The result is immediately saved to the local disc of the device and ANT offers you a continuation by answering to 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.
► The essential information (total time and answers) are located immediately behind 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 has to be entered 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 unuploaded result files can be sent to the server using the button at the bottom right corner (with doubled 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 the result of each competitor.
 • 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 the same location as your device.
► After the start, the server begins to accept result files and count the number of received records. In a suitable moment, you can stop the server and if you have configured an automatic upload 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!