Baracoda IDBlue Manuale

Data Capture

for Workforce

in Motion

IDBlue

Communication Protocol

©Baracoda

– December 2008

IDBlue – Communication Protocol v2.4.1 - 2 -

Data Capture

for Workforce

in Motion

SUMMARY

SUMMARY................................................................... 2

REVISION HISTORY.......................................................... 4

DOCUMENT CONVENTIONS...................................................... 6

COMMUNICATION OVERVIEW.................................................... 7

LUETOOTH

ODE

.......................................................... 7

ERIAL

NFORMATION

........................................................... 7

ACKET

TRUCTURE

............................................................. 8

SYNCHRONOUS

VENTS

.......................................................... 8

EVELOPER

IPS

.............................................................. 9

DEVICE OPERATING MODES................................................... 10

ISCONNECTED

ODE

........................................................... 10

ERIFY

......................................................... 10

TORE

IMESTAMP

LOCK

ATA

................................ 10

ATHEXIS

WEB ........................................................ 10

ONNECTED

ODE

............................................................. 11

ORMAL

............................................................. 11

EACTIVE

........................................................... 11

EAD

LOCK

N ....................................................... 11

RITE

LOCK

N....................................................... 11

EAD

LOCKS

........................................................ 11

DEVICE CONFIGURATION..................................................... 12

ONTINUOUS

CANNING

LAG

..................................................... 12

ONNECTED

ODE

ARAMETERS

.................................................... 13

COMMANDS................................................................. 14

ESPONSES

................................................................. 16

ORE

UNCTIONS

............................................................. 17

ONFIGURATION

UNCTIONS

...................................................... 20

LUETOOTH

UNCTIONS

......................................................... 23

NTERNAL

ATABASE

UNCTIONS

................................................... 26

RFID COMMANDS............................................................ 28

DEPRECATED FUNCTIONS..................................................... 33

APPENDIX A – PROPERTIES.................................................. 42

APPENDIX B - PROTOCOLS................................................... 45

APPENDIX C - CHECKSUM GENERATION......................................... 46

IDBlue – Communication Protocol v2.4.1 - 3 -

Data Capture

for Workforce

in Motion

GLOSSARY................................................................. 47

IDBlue – Communication Protocol v2.4.1 - 4 -

Data Capture

for Workforce

in Motion

Revision History

Changes to the original manual are listed below.

Document Date Description

2.4. 1 July 6 Initial release

2.4.1 31 Dec. 8 Upgrade Graphic Presentation

IDBlue – Communication Protocol v2.4.1 - 5 -

Data Capture

for Workforce

in Motion

Introduction

Overview

The intent of this document is to provide software developers with a general specification for

interfacing with the IDBlue™ device. It provides a description of the byte-level protocol used to

communicate with an IDBlue™ device, and enables end-users to develop their own drivers and

applications for any platform supporting a Bluetooth serial port profile (SPP).

Note: Cathexis recommends that our partners and customers use our supported drivers

whenever possible. This document is intended for the use of clients who wish to use

IDBlue™ on a platform for which Cathexis does not yet provide a software development kit

(SDK). For information on which platforms have supported SDK’s, please visit

www.cathexis.com.

This document details how to use all of the features of the IDBlue™ device, including configuration

and RFID operations.

Background

This document assumes that the reader has some experience in developing device drivers for

microelectronic devices. Also, a background in data communication protocols is helpful.

Knowledge of serial communications and Bluetooth® access using the requisite development

environment is highly recommended.

IDBlue – Communication Protocol v2.4.1 - 6 -

Data Capture

for Workforce

in Motion

Document Conventions

The following text conventions and symbols are used throughout this manual.

IDBlue – Communication Protocol v2.4.1 - 7 -

Data Capture

for Workforce

in Motion

Communication Overview

In order to communicate with IDBlue™, a Bluetooth® connection must be established to the device

using the serial port profile (SPP). It is beyond the scope of this document on how to establish this

connection, is it varies greatly between platforms.

When developing a driver library for IDBlue™ this connection is typically established either via a pre-

configured Bluetooth® serial port, or the Bluetooth® libraries provided by the platform and

programming language.

Bluetooth PIN Co e

The default Bluetooth PIN code for all IDBlue devices is “ ” (i.e. four zeroes). This PIN code is

required to Bond or Pair with the device (this is a prerequisite of establishing a serial connection

through the SPP profile).

Serial Information

The serial port communication parameters are as follows:

Baud Rate 19,2 bps

Data Bits 8

Stop bits 1

Parity None

Flow Control None

These are the default communication settings for IDBlue™ and cannot be changed. A connection to

an IDBlue™ device must be initiated from the host because the IDBlue device operates in “Slave”

mode.

IDBlue – Communication Protocol v2.4.1 - 8 -

Data Capture

for Workforce

in Motion

Packet Structure

Packets are a sequence of bytes sent to the IDBlue device via a serial port connection.

The table below shows the formatting for all request and response packets used to communicate

with the IDBlue™ device.

Note: the data length does not include the checksum.

* Please see Appendix C - Checksum Generation for information on how to calculate

the packet checksum.

Asynchronous Events

When the user presses the button on the device an asynchronous event is created, sending a packet

to the computer. To designate this packet as an asynchronous event, and not a possible response to

an earlier command issued over the serial connection, a special packet (ASYNCH) is sent before the

main packet to indicate that it is a asynchronous event. This has the form:

Response format (Asynchronous Header)

This is true for all modes of operation during a button press, excluding reactive mode.

Applications (and driver libraries) should interpret the response packet immediately following an

ASYNCH (asynchronous header) packet as an asynchronous event.

In reactive mode, only a button press response (as seen below) is sent.

Response format (Button Pressed)

IDBlue – Communication Protocol v2.4.1 - 9 -

Data Capture

for Workforce

in Motion

Developer Tips

• Tag IDs are sent and received in LSB order, but need to be displayed as MSB order. The byte

array containing the tag ID should be reversed when either sending a command to the

device, or receiving a response from the device.

• The data length value does not include the checksum, only the payload.

IDBlue – Communication Protocol v2.4.1 - 1 -

Data Capture

for Workforce

in Motion

Device Operating Mo es

The IDBlue™ device has a number of operating modes, each performing different operations when

the hardware button the device is pressed. These modes are divided into Connected modes (when

the device has an active Bluetooth® connection to a PDA or other computing device) and

Disconnected (when the device does not have an active Bluetooth® connection).

Note: each of these operating modes is affected by the Continuous Scanning Flag – please refer to

the configuration section for details.

Disconnecte Mo e

The IDBlue™ device supports three disconnected modes, as listed below.

Tag Verify

Tag VerifyTag Verify

Tag Verify

In Tag Verify mode, when the hardware button is pressed, the device will:

• Indicate a start of RFID operations by turning the LED orange

• Attempt to scan a tag using the currently configured RFID protocol.

• If a tag is successfully scanned, the device will indicate with a green LED and audio beep (if

audio feedback is enabled).

Store Timestamp + Tag Id + Block 0 Data

Store Timestamp + Tag Id + Block 0 DataStore Timestamp + Tag Id + Block 0 Data

Store Timestamp + Tag Id + Block 0 Data

In Tag Store mode (aka Store Timestamp + Tag Id + Block 0 Data), when the hardware button is

pressed, the device will:

• Check for a valid timestamp value (note: this check can be disabled through the

TIMESTAMPRE UIRED property).

• If no valid timestamp is present (i.e. the device’s timestamp has not been set), the LED will

blink double-red.

• If a valid timestamp is present, the device will indicate a start of RFID operations by turning

the LED orange.

• Attempt to read block from a tag using the currently configured RFID protocol.

• If a tag is successfully scanned, the device will indicate with a green LED and audio beep (if

audio feedback is enabled).

The current timestamp, tag ID, and contents of byte (in block ) on the tag will

then be stored in the internal tag database (see Tag Store for details). This data

can later be accessed through the GET_TAG command.

CathexisWEB

CathexisWEBCathexisWEB

CathexisWEB

This operating mode is reserved for use by Cathexis.

Altri manuali per IDBlue

Indice

Altri manuali Baracoda Scanner

Baracoda

Baracoda D-Fly Manuale utente

Baracoda

Baracoda D-Fly Istruzioni operative

Baracoda

Baracoda ToughRunners Manuale utente

Baracoda

Baracoda RoadRunners BRR-LA Manuale utente

Baracoda

Baracoda IDBlue Manuale utente

Baracoda

Baracoda ScanWear Manuale utente

Baracoda

Baracoda RoadRunner BRR-FS Manuale utente

Baracoda

Baracoda D-Fly Manuale utente

Baracoda

Baracoda RoadRunners Laser Manuale

Baracoda

Baracoda TagRunners Manuale

Baracoda

Baracoda RoadRunners Laser Manuale utente

Baracoda

Baracoda RoadRunner BRR-FS Manuale

Baracoda

Baracoda TagRunners Manuale utente

Baracoda

Baracoda TagRunners Manuale utente

Baracoda

Baracoda BaracodaPencil2 Manuale utente

Baracoda

Baracoda IDBlue Manuale utente

Baracoda

Baracoda D-Fly Manuale utente

Baracoda

Baracoda ScanWear Manuale utente

Baracoda

Baracoda ScanWear Manuale utente

Baracoda

Baracoda ToughRunners Manuale utente

Baracoda

Baracoda RoadRunners 1D Manuale utente

Baracoda

Baracoda ScanWear Manuale

Manuali Scanner popolari di altre marche

Plustek

Plustek Scanner Manuale utente

Z/I Imaging

Z/I Imaging PhotoScan 2001 Manuale utente

Renkforce

Renkforce DS100-5M Manuale utente

Image Access

Image Access WideTEK A2 Manuale utente

Canon

Canon imageFORMULA CR-120N Manuale utente

Fujitsu

Fujitsu FI-4860C2 Manuale utente

GeoSlam

GeoSlam ZEB Horizon Istruzioni per l'installazione

Kodak

Kodak i5800 Scanner Manuale utente

Kodak

Kodak i7300 Manuale utente

Revopoint

Revopoint POP Manuale utente

Fujitsu

Fujitsu fi-4860C Manuale utente

Eddyfi Technologies

Eddyfi Technologies Floormap X Manuale utente

Faselase

Faselase F6 Manuale utente

Fujitsu

Fujitsu CardMinder Manuale utente

Uniden

Uniden BC340CRS Manuale utente

Infinite Peripherals

Infinite Peripherals INFINEA TAB M Manuale utente

Mustek

Mustek PageExpress 4800 Pro Manuale utente

Optex

Optex 750830 Manuale utente