[Status] config.ini settings

Status settings

The Status section of the config.ini file can override the LED behaviour for signalling connectivity status on a VTAP PRO reader.

The status LEDs are the same RGB LEDs that may also be controlled through the config.txt file using settings such as LEDDefaultRGB, PassLED or TagLED, by the ?ledr command, or by an 'action' defined to occur in response to a 'tap'.

This section of the config.ini file controls an additional use of these LEDs, to signal Internet or Cloud connectivity. Default behaviour, when UpdateMode=2, is to show status LED signals only when the reader is in Cloud mode, with no connectivity status reported over LEDs when a VTAP reader is in Local mode.

This involves a section headed [Status] in config.ini with some of the following settings, as appropriate.

Copy

[Status]
UpdateMode=2
LEDOnline=1EBBCF
LEDHeartbeat=000000,500,0,1
LEDNoCloud=FF0000,3000,3000,5
LEDNoNetwork=FF0000,1000,1000,15
LEDAPMode=0000FF,1000,1000,15
LEDFwUpdate=FF8000,1000,500,255
LEDSyncFile=FF8000,1000,500,255

UpdateMode

Definition:

Choose when status LEDs will be used. (This option only affects VTAP PRO readers.)

By default, status LEDs are only used to report the status of a reader in Cloud Mode. For instance, to signal whether the reader is online or in hotspot mode.

Options:

=0 LEDs will never signal Internet or Cloud connectivity, regardless of whether a reader is in Cloud mode or Local mode

=1 LEDs will signal Internet or Cloud connectivity whenever the reader is online, in either Cloud mode or Local mode

=2 LEDs will signal Internet or Cloud connectivity only when CloudMode=1, which means that the reader is managed through the VTAP Cloud platform

The colours and sequences used for status LEDs are those defined in the [status] section of the config.ini file, which can be changed locally on a reader or through the VTAP Cloud platform

Default value: =2

Example value: =1

LEDAPMode

Definition:

Defines the LED colour and flashing interval for the status LED to indicate that the hotspot (access point) is active. (This is checked approximately every 30s to maintain the indication until the hotspot is de‑activated.)

Options:

LED colour (use any hex RGB colour value), LED on time in ms, LED off time in ms, number of repeats

The default sets a 1000ms blue LED, spaced by 1000ms, 15 times - to fill the approximately 30s period until the hotspot status is re‑asserted or cancelled.

Default value: =0000FF,1000,1000,15

Example value: =0000FF,500,500,30

LEDFwUpdate

Definition:

Defines the LED colour and flashing interval for the status LED to indicate a firmware update is in progress. (This is checked approximately every 3 minutes to maintain the indication until the update is complete.)

Options:

LED colour (use any hex RGB colour value), LED on time in ms, LED off time in ms, number of repeats

The default sets a 1000ms orange LED, spaced by 500ms, 255 times - although the status is checked approximately every 3 minutes for the firmware update status to be re‑asserted or cancelled.

Default value: =FF8000,1000,500,255

Example value: =FF8000,500,500,180

LEDHeartbeat

Definition:

Defines the LED colour and flashing interval for the status LED to indicate that a heartbeat message is being sent to VTAP Cloud

Options:

LED colour (use any hex RGB colour value), LED on time in ms, LED off time in ms, number of repeats

The default switches the status LEDs off for 500ms just once, for each heartbeat

Default value: =000000,500,0,1

Example value: =FF0000,800,200,1

LEDNoCloud

Definition:

Defines the LED colour and flashing interval for the status LED to indicate when the VTAP Cloud cannot be contacted or when there is no successful response to a heartbeat message.

Options:

LED colour (use any hex RGB colour value), LED on time in ms, LED off time in ms, number of repeats

The default sets a 3000ms red LED, spaced by 3000ms, 5 times

Default value: =FF0000,3000,3000,5

Example value: =FF0000,5000,1000,5

LEDNoNetwork

Definition:

Defines the LED colour and flashing interval for the status LED to indicate when there is no Internet or network connection. (The ConnTestURL set in the network.ini file is used to determine whether there is network connectivity).

Options:

LED colour (use any hex RGB colour value), LED on time in ms, LED off time in ms, number of repeats

The default sets a 1000ms red LED, spaced by 1000ms, 15 times

Default value: =FF0000,1000,1000,15

Example value: =FF0000,500,500,30

LEDOnline

Definition:

Defines the LED colour for the status LED to indicate that the reader is online, which means heartbeat messages and responses are being exchanged successfully with VTAP Cloud

Options:

=1EBBCF sets the LED to a VTAP blue colour as its default state, use any hexadecimal RGB value.

Default value: =1EBBCF

Example value: =FFFFFF

LEDSyncFile

Definition:

Defines the LED colour and flashing interval for the status LED to indicate that a file transfer (or other lengthy operation) is in progress.

Options:

LED colour (use any hex RGB colour value), LED on time in ms, LED off time in ms, number of repeats

The default sets a 1000ms orange LED, spaced by 500ms, 255 times

Default value: =FF8000,1000,500,255

Example value: =FF8000,3000,500,100