Ctrlk
For the complete documentation index, see llms.txt. This page is also available as Markdown.
Export as PDF

Bluetooth LE Device Name - Property 1.2.2.3.1.1

Bluetooth LE Device Name - Property 1.2.2.3.1.1

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

Bluetooth LE Device Name - Get Request Example

Example (Hex)

AA00 81040128D101 841AD101 81072B06010401F609 850101 890AE208E206E304E102C100

Bluetooth LE Device Name - Get Response Example

Example (Hex)

AA008104825CD10182040000000084820020D10181072B06010401F6098501028910E10EE20CE70 AE208C106943469B297A5

Bluetooth LE Device Name - Set Request Example

Example (Hex)

AA0081040112D111842ED11181072B06010401F609850101891EE21CE21AE318E116C11444594E4 1464C4558000000000000000000000000

Bluetooth LE Device Name - Set Response Example

Example (Hex)

AA0081048212D1118204000000008482002ED11181072B06010401F609850101891EE21CE21AE31 8E116C11444594E41464C4558000000000000000000000000

Bluetooth LE Desired Minimum Connection Interval - Property 1.2.2.3.1.2

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)

Bluetooth LE Desired Minimum Connection Interval - Get Request Example

Example (Hex)

AA00 81040128D101 841AD101 81072B06010401F609 850101 890AE208E206E304E102C200

Bluetooth LE Desired Minimum Connection Interval - Get Response Example

Example (Hex)

AA0081048232D1018204000000008482001CD10181072B06010401F609850101890CE20AE208E30 6E104C202000C

Bluetooth LE Desired Minimum Connection Interval - Set Request Example

Example (Hex)

AA0081040112D111841CD11181072B06010401F609850101890CE20AE208E306E104C2020010

Bluetooth LE Desired Minimum Connection Interval - Set Response Example

Example (Hex)

AA0081048212D1118204000000008482001CD11181072B06010401F609850101890CE20AE208E30 6E104C2020010

Bluetooth LE Desired Maximum Connection Interval - Property 1.2.2.3.1.3

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)

Bluetooth LE Desired Maximum Connection Interval - Get Request Example

Example (Hex)

AA00 81040128D101 841AD101 81072B06010401F609 850101 890AE208E206E304E102C300

Bluetooth LE Desired Maximum Connection Interval - Get Response Example

Example (Hex)

AA0081048232D1018204000000008482001CD10181072B06010401F609850101890CE20AE208E30 6E104C302000C

Bluetooth LE Desired Maximum Connection Interval - Set Request Example

Example (Hex)

AA0081040112D111841CD11181072B06010401F609850101890CE20AE208E306E104C3020010

Bluetooth LE Desired Maximum Connection Interval - Set Response Example

Example (Hex)

AA0081048212D1118204000000008482001CD11181072B06010401F609850101890CE20AE208E30 6E104C3020010

Bluetooth LE Desired Slave Latency - Property 1.2.2.3.1.4

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

Bluetooth LE Desired Slave Latency - Get Request Example

Example (Hex)

AA00 81040128D101 841AD101 81072B06010401F609 850101 890AE208E206E304E102C400

Bluetooth LE Desired Slave Latency - Get Response Example

Example (Hex)

AA0081048232D1018204000000008482001CD10181072B06010401F609850101890CE20AE208E30 6E104C4020004

Bluetooth LE Desired Slave Latency - Set Request Example

Example (Hex)

AA0081040112D111841CD11181072B06010401F609850101890CE20AE208E306E104C4020004

Bluetooth LE Desired Slave Latency - Set Response Example

Example (Hex)

AA0081048212D1118204000000008482001CD11181072B06010401F609850101890CE20AE208E30 6E104C4020004

Bluetooth LE Desired Supervision Timeout - Property 1.2.2.3.1.5

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)

Bluetooth LE Desired Supervision Timeout - Get Request Example

Example (Hex)

AA00 81040128D101 841AD101 81072B06010401F609 850101 890AE208E206E304E102C500

Bluetooth LE Desired Supervision Timeout - Get Response Example

Example (Hex)

AA0081048232D1018204000000008482001CD10181072B06010401F609850101890CE20AE208E30 6E104C50201F4

Bluetooth LE Desired Supervision Timeout - Set Request Example

Example (Hex)

AA0081040112D111841CD11181072B06010401F609850101890CE20AE208E306E104C50201F4

Bluetooth LE Desired Supervision Timeout - Set Response Example

Example (Hex)

AA0081048212D1118204000000008482001CD11181072B06010401F609850101890CE20AE208E30 6E104C50201F4

Bluetooth LE Connection Parameter Update Request Control - Property 1.2.2.3.1.6

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)

Bluetooth LE Connection Parameter Update Request Control - Get Request Example

Example (Hex)

AA00 81040128D101 841AD101 81072B06010401F609 850101 890AE208E206E304E102C600

Bluetooth LE Connection Parameter Update Request Control - Get Response Example

Example (Hex)

AA0081048232D1018204000000008482001BD10181072B06010401F609850101890BE209E207E305 E103C60100

Bluetooth LE Connection Parameter Update Request Control - Set Request Example

Example (Hex)

AA0081040112D111841BD11181072B06010401F609850101890BE209E207E305E103C60100

Bluetooth LE Connection Parameter Update Request Control - Set Response Example

Example (Hex)

AA0081048212D1118204000000008482001BD11181072B06010401F609850101890BE209E207E305 E103C60100

Bluetooth LE Minimum Advertising Interval - Property 1.2.2.3.1.7

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)

Bluetooth LE Minimum Advertising Interval - Get Request Example

Example (Hex)

AA00 81040128D101 841AD101 81072B06010401F609 850101 890AE208E206E304E102C700

Bluetooth LE Minimum Advertising Interval - Get Response Example

Example (Hex)

AA0081048232D1018204000000008482001CD10181072B06010401F609850101890CE20AE208E30 6E104C70200A0

Bluetooth LE Minimum Advertising Interval - Set Request Example

Example (Hex)

AA0081040112D111841CD11181072B06010401F609850101890CE20AE208E306E104C70200B0

Bluetooth LE Minimum Advertising Interval - Set Response Example

Example (Hex)

AA0081048212D1118204000000008482001CD11181072B06010401F609850101890CE20AE208E30 6E104C70200B0

Bluetooth LE Maximum Advertising Interval - Property 1.2.2.3.1.8

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)

Bluetooth LE Maximum Advertising Interval - Get Request Example

Example (Hex)

AA00 81040128D101 841AD101 81072B06010401F609 850101 890AE208E206E304E102C800

Bluetooth LE Maximum Advertising Interval - Get Response Example

Example (Hex)

AA0081048232D1018204000000008482001CD10181072B06010401F609850101890CE20AE208E30 6E104C80200A0

Bluetooth LE Maximum Advertising Interval - Set Request Example

Example (Hex)

AA0081040112D111841CD11181072B06010401F609850101890CE20AE208E306E104C80200B0

Bluetooth LE Maximum Advertising Interval - Set Response Example

Example (Hex)

AA0081048212D1118204000000008482001CD11181072B06010401F609850101890CE20AE208E30 6E104C80200B0

Bluetooth LE Passkey - Property 1.2.2.3.1.9

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'

Bluetooth LE Passkey - Get Request Example

Example (Hex)

AA00 81040128D101 841AD101 81072B06010401F609 850101 890AE208E206E304E102C900

Bluetooth LE Passkey - Get Response Example

Example (Hex)

AA0081048232D1018204000000008482001AD10181072B06010401F609850101890AE208E206E304 E102C900

Bluetooth LE Passkey - Set Request Example

Example (Hex)

AA0081040112D1118420D11181072B06010401F6098501018910E20EE20CE30AE108C9063031323 33435

Bluetooth LE Passkey - Set Response Example

Example (Hex)

AA0081048212D11182040000000084820020D11181072B06010401F6098501018910E20EE20CE30A E108C906303132333435

Bluetooth LE Never Advertise - Property 1.2.2.3.1.A

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)

Bluetooth LE Never Advertise - Get Request Example

Example (Hex)

AA00 81040128D101 841AD101 81072B06010401F609 850101 890AE208E206E304E102CA00

Bluetooth LE Never Advertise - Get Response Example

Example (Hex)

AA0081048232D1018204000000008482001BD10181072B06010401F609850101890BE209E207E305 E103CA0100

Bluetooth LE Never Advertise - Set Request Example

Example (Hex)

AA0081040112D111841BD11181072B06010401F609850101890BE209E207E305E103CA0100

Bluetooth LE Never Advertise - Set Response Example

Example (Hex)

AA0081048212D1118204000000008482001BD11181072B06010401F609850101890BE209E207E305 E103CA0100

Bluetooth LE Debug Mode Enabled - Property 1.2.2.3.1.D

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)

Bluetooth LE Debug Mode Enabled - Get Request Example

Example (Hex)

AA00 8104 0155D101 840F D101 8501 01 8704 02020301 8902 CD00

Bluetooth LE Debug Mode Enabled - Get Response Example

Example (Hex)

AA0081048255D10182040000000084820010D1018501018704020203018903CD0100

Bluetooth LE Debug Mode Enabled - Set Request Example

Example (Hex)

AA00 81040155D111 8410 D111 850101 870402020301 8903 CD0100

Bluetooth LE Debug Mode Enabled - Set Response Example

Example (Hex)

AA0081048255D11182040000000084820010D1118501018704020203018903CD0100

Last updated