LED control settings
A list of all valid configuration settings which relate to LED behaviour for use in the config.txt file.
Note: VTAP100 and some VTAP50 readers have factory fitted LEDs, but these settings can also control an external RGB or serial LEDs fitted.
The VTAP100 has diagnostic LEDs for factory use and user feedback LEDs.
Use LEDMode to control the behaviour of any diagnostic LEDs. LEDSelect chooses to use user feedback LEDs in a position compatible with the case around the VTAP100. LEDDefaultRGB sets the default colour for those user feedback LEDs, when pass reads or errors are not being signalled.
PassLED chooses the colour to flash on user feedback LEDs, with duration and repeats, when a mobile pass is read. TagLED does the same for cards/tags. PassErrorLED chooses the colour to flash on user feedback LEDs, duration and repeats, when an error occurs during a mobile pass read.
StartLED chooses the LED colour, duration and repeats to trigger on startup.
There is a simple example in the section Control LED and buzzer feedback.
Settings below:
LEDMode | LEDSelect | PassErrorLED | PassLED | TagLED | LEDDefaultRGB | LEDMaxSerial | LEDSerialGRB | LEDSerialRGB | StartLED
Definition:
Chooses a default mode of operation for diagnostic LEDs
Options:
=0 Factory use LEDs 1-4 will flash in sequence but all on during
NFC activity
=1 Factory use LEDs all off but all on during NFC activity
=2 Factory use LEDs will flash in sequence but no reaction to NFC activity
=3 Factory use LEDs always off
Default value: =0
Example value: =1
Definition:
Selects which RGB LED to use in response to pass reads, to suit the type of case around a VTAP100. For a VTAP50 using an external RGB LED board, use it to select the appropriate common cathode or common anode connection.
Options:
=0 External RGB LED (common cathode),
=1 on VTAP100: on‑board LED pair shows through compact case window; On VTAP50: external RGB LED (common anode),
=2 on VTAP100: on‑board LED pair shows through square case window; On VTAP50: external RGB LED (common anode),
=3 on VTAP50 only: External and on‑board serial LEDs, where fitted.
Default value: =1
Example value: =2
Definition:
Chooses LED colour to flash on presentation of mobile NFC pass, if an error occurs
Options:
LED colour (use any hex RGB colour value) , LED on ms, LED off ms, number of repeats
Example sets a long 500ms flash in red on presentation of mobile NFC pass, if an error occurs
Default value: N/A
Example value: =FF0000,500
Definition:
Chooses LED colour to flash on successful presentation of mobile NFC pass
Options:
LED colour (use any hex RGB colour value), LED on time in ms, LED off time in ms, number of repeats
Example sets two 100ms orange LED flashes, spaced by 50ms, on presentation of mobile NFC pass
Default value: N/A
Example value: =FF8000,100,50,2
Definition:
Chooses LED colour to flash on presentation of a card/tag
Options:
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
Default value: N/A
Example value: =00FF00,500
Definition:
Chooses the default colour of the RGB LED. [On VTAP50 v2 only: A serial LED pattern can be chosen.]
Options:
=FF8000 sets the LED to a warm orange colour as its default state, use any hexadecimal RGB value.
The second example sets the LED to white on most VTAPs, but on a VTAP50 v2 with serial the LEDs are being instructed to follow a flash sequence defined in the seq.comet section of the leds.ini file.
Default value: =FFFFFF
Example value:
=FF8000
=FFFFFF:seq.comet@leds.ini
Definition:
Limits the maximum number of LEDs in a serial LED chain or matrix. [VTAP50 v2 only] Not required for external RGB LEDs.
Options:
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.
Default value: =24
Example value: =255
Definition:
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]
Options:
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.
Default value: =1-255
Example value: =3-9,16,18-24
Definition:
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]
Options:
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.
Default value: N/A
Example value: =1,2,10-15,17
Definition:
Chooses LED colour or sequence on start up
Options:
LED colour (use any hex RGB colour value), LED on time in ms, LED off time in ms, number of repeats
Example sets two 100ms orange LED flashes, spaced by 50ms, on startup
Default value: N/A
Example value: =FF8000,100,50,2
