> For the complete documentation index, see [llms.txt](https://developer.magtek.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.magtek.com/api-and-command-reference/scra-dynafamily-programmers-manual/configuration/device-settings-property-group-1.2.nnnn/bluetooth-le-device-name-property-1.2.2.3.1.1.md). # Bluetooth LE Device Name - Property 1.2.2.3.1.1 ## Table BLDN-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”.

## Table BLDN-2 - Bluetooth LE Device Name - Get Request Example


Example (Hex)
AA00 81040128D101 841AD101 81072B06010401F609 850101 890AE208E206E304E102C100

## Table BLDN-3 - Bluetooth LE Device Name - Get Response Example


Example (Hex)
AA008104825CD10182040000000084820020D10181072B06010401F6098501028910E10EE20CE70 AE208C106943469B297A5

## Table BLDN-4 - Bluetooth LE Device Name - Set Request Example


Example (Hex)
AA0081040112D111842ED11181072B06010401F609850101891EE21CE21AE318E116C11444594E4 1464C4558000000000000000000000000

## Table BLDN-5 - Bluetooth LE Device Name - Set Response Example


Example (Hex)
AA0081048212D1118204000000008482002ED11181072B06010401F609850101891EE21CE21AE31 8E116C11444594E41464C4558000000000000000000000000

## Table BLDN-6 - 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)

## Table BLDN-7 - Bluetooth LE Desired Minimum Connection Interval - Get Request Example


Example (Hex)
AA00 81040128D101 841AD101 81072B06010401F609 850101 890AE208E206E304E102C200

## Table BLDN-8 - Bluetooth LE Desired Minimum Connection Interval - Get Response Example


Example (Hex)
AA0081048232D1018204000000008482001CD10181072B06010401F609850101890CE20AE208E30 6E104C202000C

## Table BLDN-9 - Bluetooth LE Desired Minimum Connection Interval - Set Request Example


Example (Hex)
AA0081040112D111841CD11181072B06010401F609850101890CE20AE208E306E104C2020010

## Table BLDN-10 - Bluetooth LE Desired Minimum Connection Interval - Set Response Example


Example (Hex)
AA0081048212D1118204000000008482001CD11181072B06010401F609850101890CE20AE208E30 6E104C2020010

## Table BLDN-11 - 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)

## Table BLDN-12 - Bluetooth LE Desired Maximum Connection Interval - Get Request Example


Example (Hex)
AA00 81040128D101 841AD101 81072B06010401F609 850101 890AE208E206E304E102C300

## Table BLDN-13 - Bluetooth LE Desired Maximum Connection Interval - Get Response Example


Example (Hex)
AA0081048232D1018204000000008482001CD10181072B06010401F609850101890CE20AE208E30 6E104C302000C

## Table BLDN-14 - Bluetooth LE Desired Maximum Connection Interval - Set Request Example


Example (Hex)
AA0081040112D111841CD11181072B06010401F609850101890CE20AE208E306E104C3020010

## Table BLDN-15 - Bluetooth LE Desired Maximum Connection Interval - Set Response Example


Example (Hex)
AA0081048212D1118204000000008482001CD11181072B06010401F609850101890CE20AE208E30 6E104C3020010

## Table BLDN-16 - 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

## Table BLDN-17 - Bluetooth LE Desired Slave Latency - Get Request Example


Example (Hex)
AA00 81040128D101 841AD101 81072B06010401F609 850101 890AE208E206E304E102C400

## Table BLDN-18 - Bluetooth LE Desired Slave Latency - Get Response Example


Example (Hex)
AA0081048232D1018204000000008482001CD10181072B06010401F609850101890CE20AE208E30 6E104C4020004

## Table BLDN-19 - Bluetooth LE Desired Slave Latency - Set Request Example


Example (Hex)
AA0081040112D111841CD11181072B06010401F609850101890CE20AE208E306E104C4020004

## Table BLDN-20 - Bluetooth LE Desired Slave Latency - Set Response Example


Example (Hex)
AA0081048212D1118204000000008482001CD11181072B06010401F609850101890CE20AE208E30 6E104C4020004

## Table BLDN-21 - 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)

## Table BLDN-22 - Bluetooth LE Desired Supervision Timeout - Get Request Example


Example (Hex)
AA00 81040128D101 841AD101 81072B06010401F609 850101 890AE208E206E304E102C500

## Table BLDN-23 - Bluetooth LE Desired Supervision Timeout - Get Response Example


Example (Hex)
AA0081048232D1018204000000008482001CD10181072B06010401F609850101890CE20AE208E30 6E104C50201F4

## Table BLDN-24 - Bluetooth LE Desired Supervision Timeout - Set Request Example


Example (Hex)
AA0081040112D111841CD11181072B06010401F609850101890CE20AE208E306E104C50201F4

## Table BLDN-25 - Bluetooth LE Desired Supervision Timeout - Set Response Example


Example (Hex)
AA0081048212D1118204000000008482001CD11181072B06010401F609850101890CE20AE208E30 6E104C50201F4

## Table BLDN-26 - 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)

## Table BLDN-27 - Bluetooth LE Connection Parameter Update Request Control - Get Request Example


Example (Hex)
AA00 81040128D101 841AD101 81072B06010401F609 850101 890AE208E206E304E102C600

## Table BLDN-28 - Bluetooth LE Connection Parameter Update Request Control - Get Response Example


Example (Hex)
AA0081048232D1018204000000008482001BD10181072B06010401F609850101890BE209E207E305 E103C60100

## Table BLDN-29 - Bluetooth LE Connection Parameter Update Request Control - Set Request Example


Example (Hex)
AA0081040112D111841BD11181072B06010401F609850101890BE209E207E305E103C60100

## Table BLDN-30 - Bluetooth LE Connection Parameter Update Request Control - Set Response Example


Example (Hex)
AA0081048212D1118204000000008482001BD11181072B06010401F609850101890BE209E207E305 E103C60100

## Table BLDN-31 - 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)

## Table BLDN-32 - Bluetooth LE Minimum Advertising Interval - Get Request Example


Example (Hex)
AA00 81040128D101 841AD101 81072B06010401F609 850101 890AE208E206E304E102C700

## Table BLDN-33 - Bluetooth LE Minimum Advertising Interval - Get Response Example


Example (Hex)
AA0081048232D1018204000000008482001CD10181072B06010401F609850101890CE20AE208E30 6E104C70200A0

## Table BLDN-34 - Bluetooth LE Minimum Advertising Interval - Set Request Example


Example (Hex)
AA0081040112D111841CD11181072B06010401F609850101890CE20AE208E306E104C70200B0

## Table BLDN-35 - Bluetooth LE Minimum Advertising Interval - Set Response Example


Example (Hex)
AA0081048212D1118204000000008482001CD11181072B06010401F609850101890CE20AE208E30 6E104C70200B0

## Table BLDN-36 - 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)

## Table BLDN-37 - Bluetooth LE Maximum Advertising Interval - Get Request Example


Example (Hex)
AA00 81040128D101 841AD101 81072B06010401F609 850101 890AE208E206E304E102C800

## Table BLDN-38 - Bluetooth LE Maximum Advertising Interval - Get Response Example


Example (Hex)
AA0081048232D1018204000000008482001CD10181072B06010401F609850101890CE20AE208E30 6E104C80200A0

## Table BLDN-39 - Bluetooth LE Maximum Advertising Interval - Set Request Example


Example (Hex)
AA0081040112D111841CD11181072B06010401F609850101890CE20AE208E306E104C80200B0

## Table BLDN-40 - Bluetooth LE Maximum Advertising Interval - Set Response Example


Example (Hex)
AA0081048212D1118204000000008482001CD11181072B06010401F609850101890CE20AE208E30 6E104C80200B0

## Table BLDN-41 - 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'

## Table BLDN-42 - Bluetooth LE Passkey - Get Request Example


Example (Hex)
AA00 81040128D101 841AD101 81072B06010401F609 850101 890AE208E206E304E102C900

## Table BLDN-43 - Bluetooth LE Passkey - Get Response Example


Example (Hex)
AA0081048232D1018204000000008482001AD10181072B06010401F609850101890AE208E206E304 E102C900

## Table BLDN-44 - Bluetooth LE Passkey - Set Request Example


Example (Hex)
AA0081040112D1118420D11181072B06010401F6098501018910E20EE20CE30AE108C9063031323 33435

## Table BLDN-45 - Bluetooth LE Passkey - Set Response Example


Example (Hex)
AA0081048212D11182040000000084820020D11181072B06010401F6098501018910E20EE20CE30A E108C906303132333435

## Table BLDN-46 - 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)

## Table BLDN-47 - Bluetooth LE Never Advertise - Get Request Example


Example (Hex)
AA00 81040128D101 841AD101 81072B06010401F609 850101 890AE208E206E304E102CA00

## Table BLDN-48 - Bluetooth LE Never Advertise - Get Response Example


Example (Hex)
AA0081048232D1018204000000008482001BD10181072B06010401F609850101890BE209E207E305 E103CA0100

## Table BLDN-49 - Bluetooth LE Never Advertise - Set Request Example


Example (Hex)
AA0081040112D111841BD11181072B06010401F609850101890BE209E207E305E103CA0100

## Table BLDN-50 - Bluetooth LE Never Advertise - Set Response Example


Example (Hex)
AA0081048212D1118204000000008482001BD11181072B06010401F609850101890BE209E207E305 E103CA0100

## Table BLDN-51 - 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)

## Table BLDN-52 - Bluetooth LE Debug Mode Enabled - Get Request Example


Example (Hex)
AA00 8104 0155D101 840F D101 8501 01 8704 02020301 8902 CD00

## Table BLDN-53 - Bluetooth LE Debug Mode Enabled - Get Response Example


Example (Hex)
AA0081048255D10182040000000084820010D1018501018704020203018903CD0100

## Table BLDN-54 - Bluetooth LE Debug Mode Enabled - Set Request Example


Example (Hex)
AA00 81040155D111 8410 D111 850101 870402020301 8903 CD0100

## Table BLDN-55 - Bluetooth LE Debug Mode Enabled - Set Response Example


Example (Hex)
AA0081048255D11182040000000084820010D1118501018704020203018903CD0100

--- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://developer.magtek.com/api-and-command-reference/scra-dynafamily-programmers-manual/configuration/device-settings-property-group-1.2.nnnn/bluetooth-le-device-name-property-1.2.2.3.1.1.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.