External LED settings

Following are the main settings in config.txt you need to define, with their specific use on a VTAP50 reader.

Setting

Definition

Default value

Example value

Options

LEDSelect

Selects which type of LED output to use, both for a default colour or in response to pass or card reads.

=0 External RGB (common cathode),
=1 External RGB (common anode),
=2 External RGB (common anode),
=3 External or on‑board serial LEDs (where fitted).

LEDDefaultRGB

Chooses the default colour for the RGB LED, or default sequence if using serial LEDs.

=FFFFFF

=FF8000

=FFFFFF:seq.comet@leds.ini

=FF8000 sets the LED to a specific hex colour, here #FF8000, as its default state. Use any hex RGB value, where each byte represents the strength of that colour component RRGGBB, so #FF0000 is red.

=FFFFFF:seq.comet@leds.ini sets a default LED sequence of timed toggling or animation of serial LEDs (if fitted), in this case following the seq.comet sequence you have defined in a text file called leds.ini

PassLED

Chooses LED colour to flash on successful presentation of mobile NFC pass

N/A

=FF8000,100,50,2

LED colour (use any hex RGB colour value), LED on time in ms, LED off time in ms, number of repeatsExample sets two 100ms orange LED flashes, spaced by 50ms, on presentation of mobile NFC pass

TagLED

Chooses LED colour to flash on presentation of a card/tag

N/A

=00FF00,500

LED colour (use any hex RGB colour value), LED on time in ms, LED off time in ms, number of repeats
Example sets 1 500ms green LED flash on presentation of card/tag

LEDMaxSerial

Limits the maximum number of LEDs in a serial LED chain or matrix. [VTAP50 v2 only] Not required for external RGB LEDs.

=24

=255

The VTAP50 v2 has a limit of 1 to 255 serial LEDs in a chain. If future versions permit longer chains, there may be a need to limit the number used, for backward compatibility.

LEDSerialGRB

Identify any serial external LEDs used which follow a GRB byte order when a mixture of GRB and RGB types are used. (When not specified a GRB byte order is the default assumed for all serial external LEDs.) [VTAP50 v2 only]

=1-255

=3-9,16,18-24

List LED numbers 1 to 255 that follow GRB byte order, separated by commas, or identify ranges such as 18-24, where the start and end of the range are separated by a hyphen. If you accidentally include an LED number in both LEDSerialRGB and LEDSerialGRB settings it will be treated as RGB.

LEDSerialRGB

Identify any serial external LEDs used which follow a RGB byte order when a mixture of RGB and GRB types are used. (When not specified a GRB byte order is the default assumed for all serial external LEDs.) [VTAP50 v2 only]

N/A

=1,2,10-15,17

List LED numbers 1 to 255 that follow RGB byte order, separated by commas, or identify ranges such as 10-15, where the start and end of the range are separated by a hyphen, or =all to affect all LEDs. If you accidentally include an LED number in both LEDSerialRGB and LEDSerialGRB settings it will be treated as RGB. Any LED number not set by LEDSerialRGB will be treated as GRB.

Note: Where status LEDs are fitted alongside a chain or matrix of serial LEDs, they duplicate the behaviour of the first two LEDs in the chain.