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

1.2.2.3.1.3 / 0x010202030103

Bluetooth® LE Desired Maximum Connection Interval

1.2.2.3.1.4 / 0x010202030104

Bluetooth® LE Desired Slave Latency

1.2.2.3.1.5 / 0x010202030105

Bluetooth® LE Desired Supervision Timeout

1.2.2.3.1.6 / 0x010202030106

Bluetooth® LE Connection Parameter Update Request Control

1.2.2.3.1.7 / 0x010202030107

Bluetooth® LE Minimum Advertising Interval

1.2.2.3.1.8 / 0x010202030108

Bluetooth LE Maximum Advertising Interval

1.2.2.3.1.9 / 0x010202030109

Bluetooth® LE Passkey

1.2.2.3.1.A / 0x01020203010A

Bluetooth® LE Never Advertise

1.2.2.3.1.C / 0x01020203010C

Bluetooth® LE Sleep Enabled

1.2.2.3.1.D / 0x01020203010D

Bluetooth® LE Debug Mode Enabled

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.

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.

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.

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.

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.

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 , 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.

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.

This six-byte property contains the device’s Bluetooth® passkey as six characters, each a digit from ‘0’ to ‘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.

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.

The device uses this property to determine if Bluetooth® LE Sleep is enabled. When it is enabled, the device will conserve battery power when USB power is not present and the device is not in a secure Bluetooth® LE connection with notifications enabled (not able to exchange messages with a host). The device will conserve battery power by turning off various hardware features and by going into low power modes.

The battery life when the device is idle can be increased by about 3 times for DynaFlex II Go when the host application takes advantage of this feature.

Here is an example of how the host application can be written to take advantage of this feature and extend battery life.

1) Establish a BLE connection with the device only when the host needs to perform a transaction or other operation.

2) Perform the transaction or other operation.

3) Close the BLE connection.

4) The device will sleep at this point and use less power.

Some operations in addition to connecting USB power or establishing a BLE connection will wake the device from sleep mode temporarily. The following are examples of these operations.

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 . 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.