Bluetooth BLE GATT server settings

A list of all valid configuration settings for the config.txt file which relate to sending pass information over a BLE GATT server interface, when the VTAP PRO is in Local mode.

Note: Bluetooth is only available on VTAP100-PRO-BW hardware.

BTServerMode is used to switch between BLE GATT server and BLE keyboard emulation or reading mobile driver's licenses. A VTAP100‑PRO‑BW reader can operate as either a BLE keyboard emulation, BLE GATT server or BLE mDL server. Only one BLE server type can be active at any time.

When a BLE GATT server mode is enabled, use BTServerName if you want the Bluetooth advertised device name to be anything other than the VTAP reader's serial number. If you want to add a PIN for pairing set BTServerPIN. Use BTServerSource if you want to restrict the types of data source permitted to send data to Bluetooth server.

The VTAP BLE GATT service has a 16-bit service UUID of 0xD0F0. The client app can scan for BLE devices that advertise this service and potentially offer the user a list of devices which they can connect to.

The service provides 3 characteristics each with 16-bit UUIDs as follows:

  • 0xD0F1 - Used to send data to the VTAP reader

  • 0xD0F2 - Used to receive data from the VTAP reader

  • 0xD0F3 - Status information

The data transferred on all three characteristics takes the form of a JSON string. Appendix B in this page contains an example of the JSON format used for action commands.

There is much more detailed information in the VTAP Application Note on the VTAP PRO BLE GATT server.

Settings below: BTServerMode | BTServerName | BTServerPIN | BTServerSource 

New options from v2.5.0.2
BTServerMode
Definition:

Turns BLE GATT server on or off. (Cannot be enabled at the same time as BTKeyboardMode or mDLMode).

Options:

=1 enables BLE GATT server (overrides any BTKeyboardMode setting),
=0 switches it off (default)

Default value: =0
Example value: =1
BTServerName
Definition:

This is the name that the VTAP BLE GATT server will advertise for discovery by a host device.

Options:

Up to 15 characters. If something longer is set it will be truncated.
Defaults to the VTAP assigned serial number. (VTAP Label value in boot.txt.)

Default value: =<VTAP Label>
Example value: =CC123456
BTServerPIN
Definition:

Optional PIN for pairing the VTAP PRO reader with host device such as PC or tablet.

Options:

Numeric, 6 digits. By default a PIN is not set.

If a PIN of less than 6 digits is set, that PIN will be padded with leading zeros.
So, if you set BTServerPIN=1234, your PIN will actually be 001234.

Default value: N/A
Example value: =123456
New from v2.5.0.2
BTServerSource
Definition:

Provides the option to restrict which sources send output to the BLE GATT server.

Options:

=FF (default) all possible data sources may send output to the BLE GATT server

The values are determined from a bitwise combination of the following hexadecimal values. Source options include these bit values for mobile passes and tag UIDs:
Bit 7 (0x80) = Mobile Pass (Apple VAS/Google Wallet Smart Tap)
Bit 6 (0x40) = STUID
Bit 5 (0x20) = Write to card emulation mode (CardEmulationMode=1 see VTAP NFC tag emulation settings)
Bit 4 (0x10) = mDL data
Bit 3 (0x08) = TNEP handover message from NFC
Bit 2 (0x04) = Barcode/QR scanners
Bit 1 (0x02) = Command interface messages (>interface:type:message see Dynamic configuration commands)
Bit 0 (0x01) = Card/Tag

Default value: =FF
Example value: =04