1.2.2.3.1.1 - Bluetooth LE Device Name

This property contains the Bluetooth® device name, which is typically used by the host software to present an operator with a list of devices to interact with. To avoid ambiguity, if the solution specifies that more than one device of the same name will be available, MagTek recommends including a unique identifier in the device name so the operator can differentiate.

The name should not contain any null string characters (0x00) at the beginning or in the middle, 0x00 can be used at the end of the name for padding to a total length of 20 characters. When setting this property, you can enter 0 to 20 characters. If set to a length of 0, the value reverts to its original default value described below. After modifying the Bluetooth® device name, you must reset the Bluetooth® LE module.

When getting this property, device will always return 20 characters If the name is less than 20 characters long, device will return 0x00 for the remaining characters.

None

0

20

Binary

A prefix, such as “DF II Go-“ for DynaFlex II Go, followed by the device’s serial number. For example, “DF II Go-B603226”.

Devices are always deployed with the serial number loaded, but prior to loading the serial number at MagTek, the prefix will be followed by the second to last and the last least significant bytes of the Bluetooth® device address converted to ASCII hex. For example, “DF II Go-97C2”.

1.2.2.3.1.2 / 0x010202030102

Bluetooth® LE Desired Minimum Connection Interval

This two-byte property, in most significant byte order, contains the Interval Min value in

1.25 millisecond units that the device sends to a Bluetooth® LE host in a CONNECTION PARAMETER UPDATE REQUEST. See the Core Bluetooth® Specification for details. Only values between 6 and 3200 are valid.

After the host changes this property, the device must be reset before the changes will take effect.

1.2.2.3.1.3 / 0x010202030103

Bluetooth® LE Desired Maximum Connection Interval

This two-byte property, in most significant byte order, contains the Interval Max value in

1.25 millisecond units that the device sends to a Bluetooth® LE host in a CONNECTION PARAMETER UPDATE REQUEST. See the Core Bluetooth® Specification for more details. Only values between 6 and 3200 are valid.

After the host changes this property, the device must be reset before the changes will take effect.

1.2.2.3.1.4 / 0x010202030104

Bluetooth® LE Desired Slave Latency

This two byte property, in most significant byte order, contains the Slave Latency value the device sends to the Bluetooth® LE host in a CONNECTION PARAMETER UPDATE REQUEST. See the Core Bluetooth® Specification for details. Only values between 0 and 499 are valid.

After the host changes this property, the device must be reset before the changes will take effect.

1.2.2.3.1.5 / 0x010202030105

Bluetooth® LE Desired Supervision Timeout

This two-byte property, in most significant byte order, contains the value of the Timeout Multiplier sent in 10 millisecond units that the device sends to a Bluetooth® LE host in a CONNECTION PARAMETER UPDATE REQUEST. See the Core Bluetooth® Specification for details. Only values between 10 and 3200 are valid.

After the host changes this property, the device must be reset before the changes will take effect.

1.2.2.3.1.6 / 0x010202030106

Bluetooth® LE Connection Parameter Update Request Control

The device uses this property to determine if the Bluetooth® LE connection parameter update request control is enabled. When it is enabled, the device sends a connection parameter update request once after each Bluetooth® LE connection.

After the host changes this property, the device must be reset before the changes will take effect.

1.2.2.3.1.7 / 0x010202030107

Bluetooth® LE Minimum Advertising Interval

This two property, in most significant byte order, contains the device’s minimum Bluetooth® LE advertising interval in 625 microsecond increments. This property, combined with Property 1.2.2.3.1.8 Bluetooth® LE Maximum Advertising Interval, specifies the Bluetooth® LE advertising interval the device uses. Smaller advertising intervals cause the device to consume more power when advertising, which may be a concern when running on battery power.

Only values between 32 (20ms) and 65535 (40.96s) are valid. The host may need to adjust the maximum advertising interval property when changing this property; if the maximum advertising interval is less than the minimum, the device may behave unpredictably.

After the host changes this property, the device must be reset before the changes will take effect.

1.2.2.3.1.8 / 0x010202030108

Bluetooth LE Maximum Advertising Interval

This two-byte property, in most significant byte order, contains the device’s maximum Bluetooth® LE advertising interval in 625 microsecond increments. This property, combined with Interval, specifies the Bluetooth® LE advertising interval the device uses. Smaller advertising intervals cause the device to consume more power when advertising, which may be a concern when running on battery power.

Only values between 32 (20ms) and 65535 (40.96s) are valid. The host may need to adjust the minimum advertising interval property when changing this property. If the minimum advertising interval is greater than the maximum, the device may behave unpredictably.

After the host changes this property, the device must be reset before the changes will take effect.

1.2.2.3.1.9 / 0x010202030109

Bluetooth® LE Passkey

This six-byte property contains the device’s Bluetooth® passkey as a six-character with valid value for each character between ‘0’ and ‘9’

After the host changes this property, the device must be reset before the changes will take effect.

For security, the Get request for this property will always return a length of zero and no value, so you can only set the passkey and not get it.

1.2.2.3.1.A / 0x01020203010A

Bluetooth® LE Never Advertise

The device uses this property to determine if the Bluetooth® LE Never Advertise is enabled. When it is enabled, the device never advertises. This mode may be useful for operators who only want to use the USB interface and don’t want the device to advertise.

After the host changes this property, the device must be reset before the changes will take effect.

1.2.2.3.1.D / 0x01020203010D

Bluetooth® LE Debug Mode Enabled

The device uses this property to determine if Bluetooth® LE Debug Mode is enabled. When it is enabled, the secure connections bonding uses known debug keys, so that the encrypted packet can be opened by a Bluetooth® protocol analyzer. Bondings made in debug mode are unsecure. This mode should only be enabled for debugging for development purposes and not for regular device use.

Prior to enabling or disabling Debug Mode, the following should be done. Erase all of the device's bonds with Command 0x1F05 – Erase All Bluetooth® LE Bonds (Bluetooth® LE Only). Forget the device on all hosts that have paired with it by using the host's Bluetooth® settings application. Reboot all of those hosts.

Some hosts like Windows 10 will not pair with devices that use known debug keys.

If the value of this property is set to 0, Debug Mode is disabled. If it is set to 1, Debug Mode is enabled.

After the host changes this property, the device must be reset before the changes will take effect.