Skip to main content

LED Reference

Overview

iReporter can drive hardware LEDs on an Arduino or compatible serial device to provide visual indicators for active crash/incident timers and the Top X Cars approach warning.

Serial Protocol

iReporter communicates with the serial device using a simple text-based protocol over the configured COM port at 9600 baud. Each LED command is a single line in the format:

LED;{COLOUR};{STATE};

Where:

  • COLOUR — one of: RED, BLUE, GREEN, AMBER
  • STATE — 1 to turn the LED on, 0 to turn it off

Examples:

LED;RED;1;      (turn red LED on)
LED;RED;0;      (turn red LED off)
LED;AMBER;1;    (turn amber LED on)

LED Assignments

FeatureSettingBehaviour
Crash CaptureTimeout LED (in Crash Capture settings)ON while a crash is active, OFF when timeout expires
Incident CaptureTimeout LED (in Incident Capture settings)ON while an incident is active, OFF when timeout expires
Top X ApproachingApproach LED (in Top X Cars settings)ON when a top-X car is within the approach gap AND more than 1 lap ahead

Colour Options

OptionDescription
NoneNo LED output for this feature
REDRed LED
BLUEBlue LED
GREENGreen LED
AMBERAmber / orange LED

Notes

  • iReporter only sends a new LED command when the state changes — it does not repeatedly send the same command.
  • Multiple features can use different colours simultaneously (e.g. RED for crash, AMBER for incident).
  • If two features are assigned the same colour, the last state change wins. It is recommended to assign a unique colour to each feature.
  • The COM port and baud rate (9600) are fixed. Ensure your Arduino sketch listens on 9600 baud and parses the LED;COLOUR;STATE; format.
Back to top