Other settings
Other valid configuration settings for use in the config.txt file .
MassStorageEnable provides an alternative to a hardware lock on VTAP readers where jumpers may be difficult to access, but there is an enabled host connection via serial or USB.
NFCDefaultEnable allows the VTAP reader NFC field to be turned on or off to manage power consumption, where SleepMode and SleepInactivityTimeMS can be used to enter sleep mode, either immediately after startup or after a defined period of inactivity. StartupDelayMS provides a delay during start up to allow power to fully stabilise, for use primarily in situations with a Wiegand interface.
Settings below:
LowPowerCardDetect | MassStorageEnable NFCDefaultEnable | SleepInactivityTimeMS | SleepMode | StartupDelayMS| WakeOutEventMask | ZmodemRxTimeout
Definition:
Enable this setting to make use of low power card detection [VTAP 25 only] to reduce the average current used in an NFC polling loop. This is particularly useful for situations where a VTAP reader module is integrated in battery powered equipment. (SleepMode and SleepInactivityTimeMS options can be used in conjunction with the LowPowerCardDetect option, to significantly reduce the power requirements of the VTAP reader in normal use.)
Options:
=1 use low power card detection to reduce the current used in the NFC polling loop
=0 do not use power reduction measures
Reboot after changing this setting for the change to take effect.
Default value: =0
Example value: =1
Definition:
Allows a remote host to completely remove or restore mass storage access to VTAP readers with a config.txt setting. An alternative to a hardware lock, which avoids the need for changes to jumpers on the PCB, which may not be readily accessible.
Options:
Default value is enabled.
If the value is set =0 when there are no command interfaces on any other serial ports, on reboot the setting will be ignored (treated as if it were =1), to avoid becoming locked out of your VTAP reader.
Default value: =1
Example value: =0
Definition:
Determines whether NFC is enabled [default] or disabled at startup, in order to manage power consumption.
Options:
In the example NFC will be disabled at startup, to save power.
Default value: =1
Example value: =0
Definition:
Allows you to specify a duration of NFC and serial comms inactivity, after which the VTAP reader will automatically enter low power sleep mode.
Sleep mode runs the VTAP processor at very low power, shutting down all activity except monitoring for NFC and serial comms. Entering sleep mode also switches off all LED activity, which will resume when sleep mode ends.
(This is not available on older VTAP100 readers, with v4a hardware or earlier.)
Options:
Use a positive value in milliseconds from 1000 upwards, such as 5000.
Be aware that inactivity is checked approximately every 10ms, so the minimum effective increment in value is 10. The timer will be reset by any communications, including a configuration change, and by anything detected in the NFC field.
=0 is the default, where sleep mode is never triggered by inactivity
There are two modes of sleep: light sleep (default sleep on all readers) and deep sleep (currently only supported on VTAP25). A VTAP reader will wake from light sleep when there is an NFC event (tapping a card or phone) or receiver activity on a physical serial port. To wake from deep sleep requires activity on the VTAP25 reader's WAKE_IN pin. See also LowPowerCardDetect, an option that allows a VTAP25 reader to be woken from either sleep mode by detecting a card or phone in the NFC field.
See the ?sleep command for more details about waking from sleep mode.
CAUTION: As sleep mode disables USB completely, USB COM port activity cannot be used as a trigger to wake up the VTAP reader, although the reader should still wake when you tap a card or pass. Sleep mode is therefore not recommended for applications using only VTAP USB device interfaces.
Default value: =0
Example value: =5000
Definition:
Determines whether sleep mode should begin immediately after startup.
Sleep mode primarily runs the VTAP processor at very low power, shutting down all activity except monitoring for NFC and serial comms activity. Entering sleep mode also switches off all LED activity, which will resume when sleep mode ends.
In the case of VTAP25, sleep mode an be either a light sleep mode (default) or a deep sleep mode.
(This is not available on older VTAP100 readers, with v4a hardware or earlier.)
Options:
=1 enter sleep mode immediately after startup (VTAP25 readers will enter light sleep in this case)
=0 do not enter sleep mode immediately after startup
The following use an extra value to specify deep sleep for a VTAP25:
=1,1 enter deep sleep mode immediately after startup
=0,1 do not enter deep sleep mode immediately after startup, but do enter deep sleep mode after an inactivity period (defined by SleepInactivityTimeMS).
If these are used when deep sleep is not an available option, the optional extra value will be ignored and a light sleep mode used or not.
There are two modes of sleep: light sleep (default sleep on all readers) and deep sleep (currently only supported on VTAP25). A VTAP reader will wake from light sleep when there is an NFC event (tapping a card or phone) or receiver activity on a physical serial port. To wake from deep sleep requires activity on the VTAP25 reader's WAKE_IN pin. See also LowPowerCardDetect, an option that allows a VTAP25 reader to be woken from either sleep mode by detecting a card or phone in the NFC field.
See the ?sleep command for more details about waking from sleep mode.
CAUTION: As sleep mode disables USB completely, USB COM port activity cannot be used as a trigger to wake up the VTAP reader, although the reader should still wake when you tap a card or pass. Sleep mode is therefore not recommended for applications using only VTAP USB device interfaces.
Default value: =0
Definition:
Delay in milliseconds before fully starting up to allow the power supply to stabilise.
Options:
Use a value such as 5000 when using an external power supply.
This could prevent possible file system corruption during installation, if VTAP could be wired up to a live external power supply (typically when using Wiegand or RS-485 expansions).
Default value: =1000
Example value: =5000
Definition:
Sets which events will cause the WAKE_OUT pin on a VTAP25 to be used. This behaviour may be overridden by an ?events command that changes the behaviour of the WAKE_OUT pin.
Options:
A 32-bit hex number supplied is a bit mask to select only certain events be reported via the WAKE_OUT pin on a VTAP25 reader.
=ffffffff is the default, to report everything.
00000001 indicates the configuration has been updated (bit 0 set) since last poll.
00000004 indicates a reboot has taken place (bit 2 set) since last poll.
00000008 indicates a tap is available in the cache for reading with the ?r, ?t or ?type commands (bit 3 set).
00000010 indicates a VTAP100-PRO reader in Local mode has notified an input event (bit 4 set) since last poll.
00000020 indicates a VTAP reader has woken from sleep mode (bit 5 set). (Sleep mode is not available on older VTAP100 readers, with v4a hardware or earlier.)
The value returned can be a combination of the above. So 0000000C would indicate that a reboot has taken place since the last poll and a tap is available.
Default value: =ffffffff
Example value: =ff00f000
Definition:
Set the receive timeout to an appropriate duration.
Options:
Number of milliseconds
Default value: =1000
Example value: =2000