ISO 15693 Protocol Guide - metraTec

1 ISO 15693 Protocol Guidefor metraTec RFID Readers and ModulesDate: Mai 2013 Version: Firmware Version: ISO 15693 Protocol Guide Page 1 of 37 1 Table of Content 1 Table of Further Communication Helpful Reader Control Reset (RST).. Revision (REV).. Read Serial Number (RSN).. Read Hardware Revision (RHR).. Standby (STB).. Wake Up (WAK).. Read Input Pin (RIP).. Write Output Pin (WOP).. Start Up Commands (SUC).. Mode (MOD) .. Set RF Interface (SRI).. Set Timings (STT).. Cyclic Redundancy Check On (CON).. Cyclic Redundancy Check Off (COF).. End of Frame Mode (EOF).. No End of Frame Mode (NEF).

2 Verbose Level (VBL).. SET (Settings).. Power Level (PWR).. High on tag (HOT)..16metraTec ISO 15693 Protocol Guide Page 2 of Input High Commands (IHC).. Status (STA).. Read Sub-Version (RSV)..194. Tag Manipulation Inventory (INV).. Request (REQ, DRQ, WRQ, DWQ).. Commands according to ISO/IEC Responses from Continuous Repeat Prefix (CNR).. Break (BRK)..275. Error Typical Reader Initialization Reading the Tag-ID of a Reading Tag IDs Example for writing and reading to and from ISO 15693 Appendix 1: CRC Version ISO 15693 Protocol Guide Page 3 of 371.

3 IntroductionThis document describes the metraTec firmware Protocol for all metraTec RFID readers that work with RFID transponders according to ISO 15693 . This includes the DeskID ISO, QuasarMX, Dwarf15, QuasarLR and the QR15 OEM module. This Guide does not cover the Protocol of our older QuasarMR1 reader or older Firmware versions. A description of this protocols can be found on the website, too. ( Support Downloads Documents)The target audience for this document are programmers, who need to communicate with the reader and want to write their own software for this task. This software can be written in any programming language, such as C#, Java, Delphi, Ansi-C or IEC/EN (6)1131-3, with CoDeSys.

4 An alternative to this low level Protocol is to use our free .NET DLL if you use a modern Windows operating reader firmware offers an ASCII based programming interface. The instructions are identified by an easy to remember, three character string usually followed by mandatory parameters and/or optional parameters. The response format depends on the type and result of an (as well as this document) are divided into two main groups: Reader Instructions, divided into Reader Control Instructions Reader Configuration Instructions Tag Manipulation Instructions All Instructions have Error-Codes which are described in section 5. DocumentsFor an even deeper understanding of the operating principle it might be useful to read all datasheets and norms regarding your transponder IC, esp.

5 ISO 15693 (-3) as well as the respective tag IC ISO 15693 Protocol Guide Page 4 of 372. Communication PrincipleThe communication between the reader and the host system is based on ASCII strings. Each string is terminated with a carriage-return (0x0D), NOT NULL and will be transmitted with MSB communication from the reader to the host system ( the response) is the same as above but in most cases the response from the reader comprises more than one line. Hint: The answer may is finished by line-feed <LF> (0x0A) if the command EOF was line:Instruction<SPACE>Parameter<Space>Parameter<CR>Example without Parameter:REV<CR>in ANSI C:char Rev[4] = {'R','E','V',13};The first values which will be sent is 'R' ( 52h), followed by 45h, 56h, 0dh.

6 Some instructions may be specified with parameters, which are separated by a space (20h).Example with ParameterINV<SPACE>SSL<CR>char Inv[8] = {'I','N','V',0x20,'S', 'S', 'L' ,0x0D}; Helpful ToolsFor debugging purpose it is very helpful to use a program to sniff the communication between the host and the reader. Depending on the type of communication and hardware you use, this could be: If you communicate via a (real or virtual) COM-Port: a Com-Port Monitor (several free version available in the net) If you use Ethernet or other TCP/IP-based communication, like WiFi: a packet sniffing tool, wireshark/ethereal, which is available for almost every platform If you use a direct UART connection or something at a similar low level: a hardware logic analyzer To send ASCII data via a serial connection or even Ethernet, you can use the free metraTerm terminal software, also available on our ISO 15693 Protocol Guide Page 5 of 373.

7 Reader Control InstructionsThis list gives an overview of all the existing instructions that directly influence the reader itself. All commands that are connected to the transponder, can be found in the next the readerREVR evisionReturns hardware architecture and firmware versionRSNRead Serial the Serial Number of the readerRHRRead Hardware-RevisionReturn the hardware revisionSTBS tandbySends the reader into standby/sleep mode for power savingWAKWake UpEnds standby/sleep modeRIPRead Input PinReads the state of an input pinWOPW rite Output PinWrites the state of an output pinMODModeSets the ISO Norm (14434-B, 15693 ) SRISet RF-InterfaceSets modulation depth and subcarrier mode or turns RF offSTTSet TimingsAllows to set all important timings (for Iso15693)

8 , not for QuasarLRCONCRC onTurns on CRC checking of computer / reader communicationCOFCRC offTurns off CRC checking of computer / reader communicationEOFEnd of FrameTurns on the End of Frame delimiter <LF>NEFNo End of FrameTurns off the End of Frame delimiter <LF>VBLV erbosity LevelSets the verbosity levelSUCS tart Up CommandsCommands are executed on RST or power upSET HOTSet High on tagsAllow GPIOs to switch on tag foundSET IHCSet input high commandsAllows executing commands on GPIOs rising edgeSET PWRSet Power LevelSets the RF output power (only QuasarLR)STAS tatusGets the Status of the QuasarLR (only QuasarLR)RSVRead sub versionReads the version of underlaying modules. Used for support only. (Only QuasarLR)Table 1: Overview of reader control Reset (RST)The reset command hard resets the reader.

9 The Reset command has no parameters. After sending the RST command and receiving the OK! The reader will behave like after (re-)powering. The Bootloader starts, the basic configuration (UART etc.) is done, the HF power is turned off and the reader has to be initialized ISO 15693 Protocol Guide Page 6 of 37 The startup (from OK! to taking commands) takes about 200ms. For QuasarLR the time to take commands is about 50ms but the first answer is coming not before :RST<CR>Response, if successful: OK!<CR>Possible Error Response: UPA<CR> Revision (REV)The revision command requests the device type and hardware architecture- and firmware revision of the reader.

10 The hardware architecture revision is the hardware type needed to use the firmware. It's not identical to the RHR commands hardware revision which may change without a change of the firmware. REV has no parameters and returns no error :REV<CR>Response, if successful:PRODUCT_NAME<SPACE>HW_arch[4bytes]FW_revision[4bytes]<CR>QuasarLR:16 Bytes product name (filled with Spaces) + 4 bytes HW- architecture + 4 Bytes Firmware-Revision + <CR>All other:15 Bytes product name (filled with Spaces) + 4 bytes HW- architecture + 4 Bytes Firmware-Revision + <CR>Possible Error Response: UPA<CR>Example for a response:DESKID_ISO<5 Times Space>01000101<CR>Interpretation:Product name: DESKID_ISOH ardware-Revision: ISO 15693 Protocol Guide Page 7 of Read Serial Number (RSN)The RSN command gets the serial number of the Reader.