Appendix J - Bluetooth LE Module Control Messages (Bluetooth LE Only | PCI Bluetooth LE Only)
DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS)
Page 237 of 247 (
D998200136-31
)
J.2.3
Bluetooth LE Property 0x02 - Bluetooth Device Name
Property ID: 0x02
Get Property: Yes
Set Property: Yes
Non-Volatile: Yes. Changes made to this property persist even if the device is powered off or reset. This
property should only be changed once during device configuration. Modifying this property too many
times wears out flash memory.
Default value: A string composed of the device name (such as “DynaProMini” or “DynaPro Go”) plus
“-XXYY” where XX is the second to least significant byte of the Bluetooth device address converted to
ASCII hex, and YY is the least significant byte. For example, if the second to least significant byte of the
Bluetooth device address is 0x11 and the least significant byte is 0xEC, the Bluetooth device name would
be “DeviceName-11EC”. To reset the device to this default, set this property using a zero-length string.
Shipped (factory default) values may differ. For example, some devices may be shipped with the last five
characters of the Device Name property set to the last five characters of the device’s serial number.
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.
(PCI Bluetooth LE Only)
The Bluetooth device name can have a length of 0 to 20 ASCII characters.
The name should not contain any null string characters (0x00). If set to a length of 0, the value reverts to
its original default value described above. After modifying the Bluetooth device name, you must reset the
Bluetooth LE module. See section
3.2 How to Use Bluetooth LE Connections
Example Get Bluetooth Device Name property:
Request message (hex): 00 00 02
Response message (hex): 01 00 31 32 33 (device name “123”)
Example Set Bluetooth Device Name property:
Request message (hex): 00 01 02 31 32 33 (device name “123”)
Response message (hex): 01 00