Triggers
Examples
This section provides various examples of different scenarios to explain the different trigger types and their typical handling in an application.
Prerequisite
If not stated otherwise, the following examples assume a device in the following state:
- The device is connected to the MT1 server, indicated by the S symbol right above the signal strength indication
- The device shows the home screen with a blinking start number
Sequential Trigger
If the device is in the above state, showing a blinking number (e.g. 5) and the channel C0 is triggered, the device will produce the following trigger:
- Channel: C0
- Trigger Type: StartNumberTrigger
- Startnumber Type: SEQUENTIAL
- Startnumber: 5
After the trigger the device will show the blinking number 6.
If the channel C0 is triggered again, the device will produce the following trigger:
- Channel: C0
- Trigger Type: StartNumberTrigger
- Startnumber Type: SEQUENTIAL
- Startnumber: 6
The device will show the blinking number 7.
An application should handle a StartNumberTrigger with the startnumber type SEQUENTIAL as follows:
- If the device (or channel) is assigned as start device (application specific), such a trigger indicates that the next competitor, according to the defined start order, started a new run.
- If the device (or channel) is assigned as a finish device, such a trigger indicates that the run with the currently highest runtime has finished.
Manual Trigger
If a user manually enters a number on the device, e.g. by pressing 1 2 ⏎ the device will show 12 constantly (not blinking).
If the channel C0 is triggered in this state, the device will produce the following trigger:
- Channel: C0
- Trigger Type: StartNumberTrigger
- Startnumber Type: MANUAL
- Startnumber: 12
The device will show the blinking number 13.
If the channel C0 is triggered again, the device will produce the following trigger:
- Channel: C0
- Trigger Type: StartNumberTrigger
- Startnumber Type: SEQUENTIAL
- Startnumber: 13
The device will show the blinking number 14.
An application should handle a StartNumberTrigger with the startnumber type MANUAL as follows:
- If the device (or channel) is assigned as start device, such a trigger indicates that the competitor with the according startnumber started a new run.
- If the device (or channel) is assigned as a finish device, such a trigger indicates that the run of the competitor with the according startnumber finished the run.
Deleting Triggers (Scroll Mode)
Assume that the device is in the state of the above scenario, i.e. showing the blinking number 14 and two triggers have been produced.
The user is able to delete or change the triggers via the Scroll mode of the device. This mode can be entered by pressing ESC ESC (entering the menu) and then selecting Scroll and pressing ⏎.
The device shows the triggers in a list, which looks like this:
The user can select a trigger using the cursor keys and pressing ⏎.
If the user selects the trigger with the startnumber 12 and presses ⏎, the number 12 starts to blink, indicating that the number can be changed now.
If the user enters a new startnumber, e.g. 1 0 ⏎, the device will produce the following triggers:
- Channel: C0
- Trigger Type: ClearTrigger
- Startnumber Type: MANUAL
- Startnumber: 12
- Channel: C0
- Trigger Type: StartNumberTrigger
- Startnumber Type: MANUAL
- Startnumber: 10
Both newly produced triggers will have the same timestamp, channel and device ID as the original trigger of the example above, therefore, these three field must be used to identify the original trigger which is affected by these new triggers.
An application should handle such a scenario as follows:
- The ClearTrigger should delete/rollback the action which was taken by the original trigger. This could be that the started run is cancelled again or a finished run is active again.
- The new StartNumberTrigger should be handled as if it is a new trigger. This could be that a new run is started or an existing run is finished.
If the user selects a trigger in the Scroll mode and inputs the new startnumber 0, i.e. by pressing 0 ⏎, the selected trigger will be deleted from the list and the following trigger will be produced:
- Channel: C0
- Trigger Type: ClearTrigger
- Startnumber Type: MANUAL
- Startnumber: 13
This indicates that the original trigger, identified by the timestamp, channel and device ID should be deleted.
An application should handle that as follows:
- It should delete/rollback the action which was taken by the original trigger. This could be that the started run is cancelled again or a finished run is active again.