Frequently Asked Questions / What configurable properties are available for IDBLUE devices?

(This information is taken from the IDBLUE Serial Interface Specification on the IDBLUE Documentation page. The firmware commands referenced below have respective calls in each Developer SDK which can be called to set the desired properties. For more detailed information, please refer to the document above or the respective SDK interface guide.)

All of the configurable behavior of the IDBLUE device is managed through the use of device properties. These properties are configured via the Get Property, Set Property, Load Properties and Save Properties commands.

  • Continuous Scanning – Whether or not continuous scanning mode is enabled. Refer to section Operating Modes on continuous scanning mode. Format:
    • Disabled (00h) (Default)
    • Enabled (01h)
  • Timestamp Required – Whether or not a valid timestamp (i.e. the timestamp property has been set since the device has been turned on) is required when storing tag ID’s in disconnected mode. Format:
    • Disabled (00h)
    • Enabled (01h) (Default)
  • Duplicate Elimination Timeout – When scanning tags, this property specifies the timeout (in milliseconds) between reads that duplicate scans of the same tag will be ignored. Format:
    • 0 = no timeout (Default)
    • 100 = 100 ms
    • Maximum value is 10000 (10 seconds).
  • Time – The timestamp stored on the device. When the device first turns on, the device will not know what time it is and will start tracking time from 0000-00-00 00:00:00. Once this property is set, the device will keep track of time until it is turned off.
  • Disconnected Mode – (HF Only) Configures the disconnected (i.e. not connected to a host via USB or Bluetooth) operating mode of the IDBLUE device. For more information, please read Operating Modes FAQ.
    • Default: Tag Verify (00)
  • Connected Mode – (HF Only) Configures the connected (i.e. connected to a host via USB or Bluetooth) operating mode of the IDBLUE device.  For more information, please read Operating Modes FAQ.
    • Default: Tag ID (03)
  • RFID Protocol – (Read Only) The currently selected RFID Protocol. More information about the supported RFID protocols is available in section Supported Protocols.
    • IDBLUE.HF = ISO15693 (01h)
    • IDBLUE.UHF = EPC Gen 2, ISO 18000-6C (02h)
  • Buzzer – Whether or not the on-board audio buzzer is enabled. Format:
    • Disabled (00h)
    • Enabled (01h) (Default)
  • Device Timeout – The idle time (in minutes) before the device shuts down. A value of 0 means that the device will not shut down automatically.
    • 0 – No timeout
    • Values values: 1-255
    • Default: 10 minutes
  • RFID Timeout – The time in seconds before an RFID operation (select tag, read block, etc) times out. The timer begins as soon as the RFID operation begins and the operation will fail (timeout) if the timeout elapses before the operation is complete.
    • Min value: 1 second
    • Max value: 16 seconds
    • Default: 4 seconds
  • Bluetooth Timeout – The time in minutes before the Bluetooth link times out and shuts down. Note: this only applies when the device does not have an active Bluetooth connection.
    • Valid values: 1-255 minutes
    • 0 = no timeout (Default)
  • Continuous Scanning Timeout – In continuous scanning mode, this property controls how long the device will “scan” without finding a tag before ceasing continuous operations.
    • Valid values: 1-255 seconds
    • 0 = no timeout
    • Default: 16 seconds
  • Block Index – (HF Only) For connected modes Read Block N and Write Block N this property configures which block index is used for the operation.
    • Valid values: 0-255
    • Default: 0
  • Block Data – (HF Only) For connected mode Write Block N this property sets the block data used for the operation.
    • The maximum length is 8 bytes.
    • Default: 00 00 00 00
  • Block Count – (HF Only) For connected mode Read Blocks, this property configures the block count (i.e. number of blocks read).
    • Valid values: 1-255
    • Default: 1
  • Version Information – (Read Only) Extended versioning information. Contains full major/minor/build information for both hardware and firmware versions, as well as a version comment string.
  • Hold To Scan – Specifies whether Hold To Scan is enabled. Format:
    • Disabled (00h)
    • Enabled (01h) (Default)
  • Action Button – Enable or Disable the front Action button. Format:
    • Disabled (00h)
    • Enabled (01h) (Default)
  • AutoConnect to Host – When enabled, this will attempt to connect to the last known iOS host automatically when powered on. Format:
    • Disabled (00h)
    • Enabled (01h) (Default)

In addition, you can set the following properties directly:

  • Set Bluetooth PIN – This command assigns a PIN code (passkey) for Bluetooth connectivity. The Bluetooth security PIN (also known as a passkey) for connecting to the IDBLUE device and is a series of ASCII characters, of length up to 16 characters.
  • Default: 0000
  • Set/Get Bluetooth Name – Assign a new or fetch the display name of the IDBLUE device. This identifying name will be displayed when a host scans for Bluetooth devices. The name has a maximum length  of 16 ASCII characters (bytes).
    • Default: IDBLUE-HF-<last 4 characters of Bluetooth MAC address> or IDBLUE-UHF-<last 4 characters of Bluetooth MAC address>

The Factory Default Settings are set to the below values. Your device can be reset back to the default properties by performing a Factory Reset command. The following values are not reset as they either don’t change or unaffected.

  • Time
  • RFID Protocol
  • Version Information

Posted in: Software and Development