The target sends the result state to the server. This message is published after every target change, which can be a hit on one target or a reset when all targets are opened.

PUB biathlon/server/result
PUBLISH biathlon/server/result

Target State Message

Contains the current state and results of a biathlon target

Payload

  • target_hostname string Required

    Hostname of the target device. The hostname is permanently stored in the target device and cannot be changed. An example could be SVA_EBTS_S1 (Schützenverein Sandkrug - Elektronisches Biathlon Target System - Stehend Nr. 1).

  • target_lane integer Required

    Lane number of the target. The default is permanently stored in the target system, e.g., 1 for Lane 1. However, the default lane number can be overwritten by the server via a REST call. This might be necessary in case of a defect during competition when the target system must be replaced by a backup system.

  • target_mac_address string Required

    MAC address of the target device. The MAC address is static and set by the hardware manufacturer. It will never change permanently.

  • target_ip_address string Required

    IP address of the target device. The IP address is typically fixed but could change due to network settings.

  • shooting_position string Required

    Current shooting position.

    Values are prone or standing.

  • athlete_competition_number string Required

    Athlete Identifier: Represents the unique number (ID) assigned to each athlete in the competition. Corresponds to the "Startnummer" (bib number) displayed on the athlete's uniform. Team bib numbers can be provided with the subnumber of the current team athlete. This number changes frequently and is set by the operator via handheld device/tablet during athlete check-in at the lane. This field will be automatically cleared after every target reset by pulling the rope.

  • athlete_time_on_lane integer Required

    Time the athlete has spent on the lane in milliseconds, measured from check-in until check-out.

  • results array[integer(int64)] Required

    Array of unix timestamps in ms for each target hit. The hit array consists of five entries in a fixed order. Index 0 is the leftmost target, and index 4 is the rightmost target. The hit timestamp will be set for the particular target independent of the athlete's shooting order on the target.

  • target_result_image string Required

    Visual representation of the target state without timestamps. Be aware, that the result image might be confusing on screens set to dark mode.

  • hits integer Required

    Number of hits on the target.

    Minimum value is 0, maximum value is 5.

  • final boolean Required

    Indicates if this is the final result for the current shooting series. The final result indicator will only be set after the reset state by pulling the rope.

  • final_time integer(int64)

    Timestamp of the final result (only present if final is true)

Payload examples
{
  "target_hostname": "DE_NW_SVS_EBTS_S01",
  "target_lane": 1,
  "target_mac_address": "CC:7B:5C:F1:7F:B4",
  "target_ip_address": "192.168.1.100",
  "shooting_position": "prone",
  "athlete_competition_number": "142",
  "athlete_time_on_lane": 60123,
  "results": [
    0,
    1730916270,
    0,
    0,
    1730916392
  ],
  "target_result_image": [
    "● ◯ ● ● ◯"
  ],
  "hits": 2,
  "final": true,
  "final_time": 1730916415
}