Skip to main content

Event Routing

When chip/tag data arrives in RunScore, each read must be assigned to a RunScore event (TIME, SPLIT, CHIP, etc.).

Location matching​

Every chip system identifies the source of a read with a name — ChampionChip calls it a Location, ChronoTrack calls it a Point. RunScore resolves this name to an event in the following order:

  1. Direct name match. If the Location/Point name matches a RunScore event name (case-insensitive), data routes automatically. For example, a ChampionChip Location called TIME matches the RunScore event TIME.

  2. events_mapping.ini lookup. If no direct match is found, RunScore checks events_mapping.ini in the race folder. This file contains one mapping per line:

    events_mapping.ini
    FIN_PRIMARY=TIME
    START_MAT=CHIPSTART

  3. No automatic match found. RunScore opens a dialog so you can pick the event:

    a. Pick an event. Your choice is saved to events_mapping.ini and reused for later packets.

    b. Cancel. The data for this location is dropped, and the prompt reappears on the next packet from the same location.

    c. First-event fallback. Only if the entry you picked doesn't resolve to an event, RunScore asks whether to place the data in the first event. Yes writes the first event to events_mapping.ini.

Repeated prompts

9.0 does not remember cancelled locations, so the prompt returns on every packet from an unmatched location — during a busy race that means repeated dialogs. Set up events_mapping.ini before connecting to avoid it. (9.1 remembers a cancelled location and stays quiet until you reopen the race.)

Editing the mapping file​

Open the mapping file from Tools → Chip Options → Events mapping…. This opens events_mapping.ini in a text editor. Each line is LocationName=EventName.

To start fresh, delete the file (or all its contents). The next time a chip system connects, RunScore will re-prompt for each location.

Troubleshooting​

If data is going to the wrong event:

  1. Open Tools → Chip Options → Events mapping… and check for stale or incorrect mappings.
  2. Delete events_mapping.ini from the race folder and reinitialize external timers. RunScore will prompt for each location again.
  3. Verify that your middleware's Location/Point names match what you expect — these names are case-insensitive but must otherwise match exactly.

Per-event chip routing fields​

Beyond location matching, each event has chip/tag routing fields that filter incoming reads. Configure these in Misc → Edit list of Events (or Tools → Edit List of Events), then double-click an event to open the Event Editor.

Edit Events list and Event Editor showing chip/tag routing fields

The right side of the Event Editor contains the chip/tag routing fields:

  • Default / Start (last) / Split (first) / Finish (first) — Start keeps the last read; Split and Finish keep the first (fastest) read
  • Round or Pass — matches the pass number sent by the middleware
  • Mat or Box — matches the mat or decoder box ID
  • Ear — matches the antenna (ear) number
  • MyLaps GroupID — matches the MyLaps group identifier
  • Times — accepts reads only within a time window
  • Lap difference — minimum time between laps for the same runner
  • Pre Event — requires a read in another event before accepting this one

For a full description of each field, see Enter/Edit Results → Chip/tag race settings.

How RunScore resolves incoming data​

When a chip read arrives, RunScore follows this sequence:

  1. Find the event from the Location/Point name (via direct match, events_mapping.ini, or user prompt as described above).
  2. Apply routing fields. If the resolved event has Round, Mat, Ear, or GroupID values set, RunScore checks each event in order. The first event whose routing fields match the metadata of the incoming read receives the data.
  3. No routing match. If no event's routing fields match, the data goes to the event resolved in step 1 (or the first event if no location was specified at initialization).
note

The Event column in the Initialize External Timers dialog also affects routing. Setting it to * lets the location/routing fields decide; setting it to a specific event number pins that slot to one event regardless of other routing.