Property Subgroup 1.2.2.3.nn Bluetooth® LE Settings (Bluetooth® LE Only) - 1.2.2.3.1.1 - 1.2.2.3.1.D
Table - Property 1.2.2.3.1.1 Bluetooth® LE Device Name
Property Description
Property OID
1.2.2.3.1.1 / 0x010202030101
Name
Bluetooth® LE Device Name
Description
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.
Securing Key
None
Min. Len (b)
0
Max. Len (b)
20
Data Type
Binary
Valid Values
Default
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”.
Table - Get Request Example
Example (Hex)
AA00 81040128D101 841AD101 81072B06010401F609 850101 890AE208E206E304E102C100
Table - Get Response Example
Example (Hex)
AA008104825CD10182040000000084820020D10181072B06010401F6098501028910E10EE20CE70 AE208C106943469B297A5
Table - Set Request Example
Example (Hex)
AA0081040112D111842ED11181072B06010401F609850101891EE21CE21AE318E116C11444594E4 1464C4558000000000000000000000000
Table - Set Response Example
Example (Hex)
AA0081048212D1118204000000008482002ED11181072B06010401F609850101891EE21CE21AE31 8E116C11444594E41464C4558000000000000000000000000
Table - Property 1.2.2.3.1.2 Bluetooth® LE Desired Minimum Connection Interval
Property Description
Property OID
1.2.2.3.1.2 / 0x010202030102
Name
Bluetooth® LE Desired Minimum Connection Interval
Description
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.
Securing Key
None
Min. Len (b)
2
Max. Len (b)
2
Data Type
Binary
Valid Values
0x00 0x06 (6) - 0x0C 0x80 (3200) MSB first
Default
0x00 0x0C (15.0 milliseconds)
Table - Get Request Example
Example (Hex)
AA00 81040128D101 841AD101 81072B06010401F609 850101 890AE208E206E304E102C200
Table - Get Response Example
Example (Hex)
AA0081048232D1018204000000008482001CD10181072B06010401F609850101890CE20AE208E30 6E104C202000C
Table - Set Request Example
Example (Hex)
AA0081040112D111841CD11181072B06010401F609850101890CE20AE208E306E104C2020010
Table - Set Response Example
Example (Hex)
AA0081048212D1118204000000008482001CD11181072B06010401F609850101890CE20AE208E30 6E104C2020010
Table - Property 1.2.2.3.1.3 Bluetooth® LE Desired Maximum Connection Interval
Property Description
Property OID
1.2.2.3.1.3 / 0x010202030103
Name
Bluetooth® LE Desired Maximum Connection Interval
Description
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.
Securing Key
None
Min. Len (b)
2
Max. Len (b)
2
Data Type
Binary
Valid Values
0x00 0x06 (6) - 0x0C 0x80 (3200) MSB first
Default
0x00 0x00C (15.0 milliseconds)
Table - Get Request Example
Example (Hex)
AA00 81040128D101 841AD101 81072B06010401F609 850101 890AE208E206E304E102C300
Table - Get Response Example
Example (Hex)
AA0081048232D1018204000000008482001CD10181072B06010401F609850101890CE20AE208E30 6E104C302000C
Table - Set Request Example
Example (Hex)
AA0081040112D111841CD11181072B06010401F609850101890CE20AE208E306E104C3020010
Table - Set Response Example
Example (Hex)
AA0081048212D1118204000000008482001CD11181072B06010401F609850101890CE20AE208E30 6E104C3020010
Table - Property 1.2.2.3.1.4 Bluetooth® LE Desired Slave Latency
Property Description
Property OID
1.2.2.3.1.4 / 0x010202030104
Name
Bluetooth® LE Desired Slave Latency
Description
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.
Securing Key
None
Min. Len (b)
2
Max. Len (b)
2
Data Type
Binary
Valid Values
0x00 0x00 (0) – 0x01 0xF3 (499) MSB first
Default
0x00 0x00
Table - Get Request Example
Example (Hex)
AA00 81040128D101 841AD101 81072B06010401F609 850101 890AE208E206E304E102C400
Table - Get Response Example
Example (Hex)
AA0081048232D1018204000000008482001CD10181072B06010401F609850101890CE20AE208E30 6E104C4020004
Table - Set Request Example
Example (Hex)
AA0081040112D111841CD11181072B06010401F609850101890CE20AE208E306E104C4020004
Table - Set Response Example
Example (Hex)
AA0081048212D1118204000000008482001CD11181072B06010401F609850101890CE20AE208E30 6E104C4020004
Table - Property 1.2.2.3.1.5 Bluetooth® LE Desired Supervision Timeout
Property Description
Property OID
1.2.2.3.1.5 / 0x010202030105
Name
Bluetooth® LE Desired Supervision Timeout
Description
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.
Securing Key
None
Min. Len (b)
2
Max. Len (b)
2
Data Type
Binary
Valid Values
0x00 0x0A (10) - 0x0C 0x80 (3200) MSB first
Default
0x01 0xF4 (5000 milliseconds)
Table - Get Request Example
Example (Hex)
AA00 81040128D101 841AD101 81072B06010401F609 850101 890AE208E206E304E102C500
Table - Get Response Example
Example (Hex)
AA0081048232D1018204000000008482001CD10181072B06010401F609850101890CE20AE208E30 6E104C50201F4
Table - Set Request Example
Example (Hex)
AA0081040112D111841CD11181072B06010401F609850101890CE20AE208E306E104C50201F4
Table - Set Response Example
Example (Hex)
AA0081048212D1118204000000008482001CD11181072B06010401F609850101890CE20AE208E30 6E104C50201F4
Table - Property 1.2.2.3.1.6 Bluetooth® LE Connection Parameter Update Request Control
Property Description
Property OID
1.2.2.3.1.6 / 0x010202030106
Name
Bluetooth® LE Connection Parameter Update Request Control
Description
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.
Securing Key
None
Min. Len (b)
1
Max. Len (b)
1
Data Type
Binary
Valid Values
0x00 (Disabled) 0x01 (Enabled)
Default
0x01 (Enabled)
Table - Get Request Example
Example (Hex)
AA00 81040128D101 841AD101 81072B06010401F609 850101 890AE208E206E304E102C600
Table - Get Response Example
Example (Hex)
AA0081048232D1018204000000008482001BD10181072B06010401F609850101890BE209E207E305 E103C60100
Table - Set Request Example
Example (Hex)
AA0081040112D111841BD11181072B06010401F609850101890BE209E207E305E103C60100
Table - Set Response Example
Example (Hex)
AA0081048212D1118204000000008482001BD11181072B06010401F609850101890BE209E207E305 E103C60100
Table - Property 1.2.2.3.1.7 Bluetooth® LE Minimum Advertising Interval
Property Description
Property OID
1.2.2.3.1.7 / 0x010202030107
Name
Bluetooth® LE Minimum Advertising Interval
Description
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.
Securing Key
None
Min. Len (b)
2
Max. Len (b)
2
Data Type
Binary
Valid Values
0x00 0x20 (32) - 0xFF 0xFF (65535) MSB first
Default
0x00 0xA0 = 160 (100 milliseconds)
Table - Get Request Example
Example (Hex)
AA00 81040128D101 841AD101 81072B06010401F609 850101 890AE208E206E304E102C700
Table - Get Response Example
Example (Hex)
AA0081048232D1018204000000008482001CD10181072B06010401F609850101890CE20AE208E30 6E104C70200A0
Table - Set Request Example
Example (Hex)
AA0081040112D111841CD11181072B06010401F609850101890CE20AE208E306E104C70200B0
Table - Set Response Example
Example (Hex)
AA0081048212D1118204000000008482001CD11181072B06010401F609850101890CE20AE208E30 6E104C70200B0
Table - Property 1.2.2.3.1.8 Bluetooth® LE Maximum Advertising Interval
Property Description
Property OID
1.2.2.3.1.8 / 0x010202030108
Name
Bluetooth® LE Maximum Advertising Interval
Description
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.
Securing Key
None
Min. Len (b)
2
Max. Len (b)
2
Data Type
Binary
Valid Values
0x00 0x20 (32) - 0xFF 0xFF (65535) MSB first
Default
0x00 0xA0 = 160 (100 milliseconds)
Table - Get Request Example
Example (Hex)
AA00 81040128D101 841AD101 81072B06010401F609 850101 890AE208E206E304E102C800
Table - Get Response Example
Example (Hex)
AA0081048232D1018204000000008482001CD10181072B06010401F609850101890CE20AE208E30 6E104C80200A0
Table - Set Request Example
Example (Hex)
AA0081040112D111841CD11181072B06010401F609850101890CE20AE208E306E104C80200B0
Table - Set Response Example
Example (Hex)
AA0081048212D1118204000000008482001CD11181072B06010401F609850101890CE20AE208E30 6E104C80200B0
Table - Property 1.2.2.3.1.9 Bluetooth® LE Passkey
Property Description
Property OID
1.2.2.3.1.9 / 0x010202030109
Name
Bluetooth® LE Passkey
Description
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.
Securing Key
None
Min. Len (b)
6
Max. Len (b)
6
Data Type
Alphanumeric
Valid Values
'000000' - '999999'
Default
'000000'
Table - Get Request Example
Example (Hex)
AA00 81040128D101 841AD101 81072B06010401F609 850101 890AE208E206E304E102C900
Table - Get Response Example
Example (Hex)
AA0081048232D1018204000000008482001AD10181072B06010401F609850101890AE208E206E304 E102C900
Table - Set Request Example
Example (Hex)
AA0081040112D1118420D11181072B06010401F6098501018910E20EE20CE30AE108C9063031323 33435
Table - Set Response Example
Example (Hex)
AA0081048212D11182040000000084820020D11181072B06010401F6098501018910E20EE20CE30A E108C906303132333435
Table - Property 1.2.2.3.1.A Bluetooth® LE Never Advertise
Property Description
Property OID
1.2.2.3.1.A / 0x01020203010A
Name
Bluetooth® LE Never Advertise
Description
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.
Securing Key
None
Min. Len (b)
1
Max. Len (b)
1
Data Type
Binary
Valid Values
0x00 (Disabled) 0x01 (Enabled)
Default
0x00 (Disabled)
Table - Get Request Example
Example (Hex)
AA00 81040128D101 841AD101 81072B06010401F609 850101 890AE208E206E304E102CA00
Table - Get Response Example
Example (Hex)
AA0081048232D1018204000000008482001BD10181072B06010401F609850101890BE209E207E305 E103CA0100
Table - Set Request Example
Example (Hex)
AA0081040112D111841BD11181072B06010401F609850101890BE209E207E305E103CA0100
Table - Set Response Example
Example (Hex)
AA0081048212D1118204000000008482001BD11181072B06010401F609850101890BE209E207E305 E103CA0100
Table - Property 1.2.2.3.1.C Bluetooth® LE Sleep Enabled
Property Description
Property OID
1.2.2.3.1.C / 0x01020203010C
Name
Bluetooth® LE Sleep Enabled
Description
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.
1) Pressing the button.
2) Putting the device into pairing mode.
When the device is sleeping, all LEDs will go off so the device will look similar to when it is off.
If the value of this property is set to 0, sleep is disabled. If it is set to 1, sleep is enabled.
After the host changes this property, the device must be reset before the changes will take effect.
Securing Key
None
Min. Len (b)
1
Max. Len (b)
1
Data Type
Binary
Valid Values
0x00 – 0x01
Default
0x01 (Bluetooth® LE Sleep enabled)
Table - Get Request Example
Example (Hex)
AA00 8104 0155D101 840F D101 8501 01 8704 02020301 8902 CC00
Table - Get Response Example
Example (Hex)
AA0081048255D10182040000000084820010D1018501018704020203018903CC0100
Table - Set Request Example
Example (Hex)
AA00 81040155D111 8410 D111 850101 870402020301 8903 CC0100
Table - Set Response Example
Example (Hex)
AA0081048255D11182040000000084820010D1118501018704020203018903CC0100
Table - Property 1.2.2.3.1.D Bluetooth® LE Debug Mode Enabled
Property Description
Property OID
1.2.2.3.1.D / 0x01020203010D
Name
Bluetooth® LE Debug Mode Enabled
Description
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.
Securing Key
None
Min. Len (b)
1
Max. Len (b)
1
Data Type
Binary
Valid Values
0x00 – 0x01
Default
0x00 (Bluetooth® LE Debug Mode disabled)
Table - Get Request Example
Example (Hex)
AA00 8104 0155D101 840F D101 8501 01 8704 02020301 8902 CD00
Table - Get Response Example
Example (Hex)
AA0081048255D10182040000000084820010D1018501018704020203018903CD0100
Table - Set Request Example
Example (Hex)
AA00 81040155D111 8410 D111 850101 870402020301 8903 CD0100
Table - Set Response Example
Example (Hex)
AA0081048255D11182040000000084820010D1118501018704020203018903CD0100
Last updated