Ubisys 7047, Reference Manual

Page 1: ...13 56 MHz RFID USB READER REFERENCE MANUAL...

Page 2: ...es operating and maintenance instructions command references a tag compliance matrix and other detailed product information If you have any questions or need additional support drivers software librar...

Page 3: ...ory Scan 11 5 2 8 Inventory Scan without Anti Collision 12 5 2 9 Select Tag 12 5 2 10 Get System Information 13 5 2 11 Read Data Block 14 5 2 12 Write Data Block 14 5 2 13 Lock Data Block 15 5 2 14 En...

Page 4: ...are update 33 9 ubisys RFID Smart Card API 40 9 1 Overview 40 9 2 Basic RFID Smart Card API 40 9 2 1 CSmartCardContext 40 9 2 2 CSmartCard 41 9 2 3 CSmartCardTransaction 42 9 2 4 CSmartCardStatusRecei...

Page 5: ...C Different firmware types are available can be used and exchanged depending on customer requirements o CDC ACM Virtual Serial Port The reader appears as a virtual serial port COM port by implementing...

Page 6: ...eader devices can be ordered with the firmware of choice CDC ACM HID or CCID and can later be updated to newer firmware releases as well as to other firmware types by using the ubisys RFID Control Cen...

Page 7: ...quest STM LRI2K STM LRIS2K Fujitsu MB89R118 Requires CDC Version 1 16 or above CCID Version 1 02 or above ISO14443A storage cards Mifare Classic Mifare Ultralight Mifare Plus Mifare Mini ISO14443A 4 p...

Page 8: ...and allows read write access via the CCID firmware using the transparent data exchange Transparent data exchange for ISO15693 tags allows implementing features exceeding the reader supported read wri...

Page 9: ...Tag It HF NXP i code SLI etc Features a simple to use AT like command set that allows scanning for tags reading and writing on tag memories modifying physical layer parameters etc Thin abstraction lay...

Page 10: ...d back Response OK 5 2 5 Light Emitting Diode Control This command controls the state of the light emitting diodes LEDs Notice that not all hardware variants feature LEDs Requires CDC ACM firmware ver...

Page 11: ...n relinquishes control to the firmware a short beep whenever a transponder is detected Response OK Example Request AT B 1 Turns buzzer on Response OK Request AT B 0 Turns buzzer off Response OK Reques...

Page 12: ...rs If no tag was found the response is OK no UID ISO 15693 command 01h mandatory supported by all tags Requires CDC ACM firmware version 1 09 or above Syntax Request AT i Response UID uid RSSI main au...

Page 13: ...FI memory block count BC and size BS and IC manufacturer defined data IC Notice that not all tags support this command and not all tags support all items DSFID AFI and IC are displayed in hexadecimal...

Page 14: ...n chip memory including NXP i code SL 2 TI Tag It HF I Syntax Request AT R block number Response DATA number of raw bytes raw data bytes OK ERROR tag reported an error or did not respond or automatic...

Page 15: ...0x78 0x74 to Text memory block 23 option flag set Response OK 5 2 13 Lock Data Block Lock data block in tag memory Requires CDC ACM firmware version 1 15 or above The block number must be within the r...

Page 16: ...number with option flag Response OK ERROR tag reported an error or did not respond or automatic scan mode section 0 enabled Examples Request AT w0 4 Writes 0x31 0x32 0x33 0x34 to 1234 memory block 0 o...

Page 17: ...ld Syntax Request AT RF 0 1 Response OK Example Request AT RF 0 Disable RF field Response OK Request AT RF 1 Enable RF field Response OK 5 2 15 Query RF field status Syntax Request AT RF Response RF 0...

Page 18: ...N UID uid Tag lost Mode 2 only SCAN UID uid RSSI main aux New tag or RSSI changed Example Request AT SCAN1 Enable scan mode 1 Response OK from this point forward the reader only accepts AT SCAN comman...

Page 19: ...return Supported standards are ISO15693 and ISO14443A integrated multi ISO firmware and dedicated firmware images for each standard Extended firmware versions available that type the reader s serial n...

Page 20: ...ISO 15693 allowing the host application to communicate directly with the tag This feature allows customers to operate any tag that complies with the ISO 15693 standard In particular application softwa...

Page 21: ...s To verify correct operation on MacOS open a terminal shell and enter pcsctest which will run the MUSCLE PC SC Lite Test Program Your ubisys reader should be listed When prompted to enter the reader...

Page 22: ...00 00 03 06 13 00 35 00 00 00 00 4E 3B 8F 80 01 80 4F 0C A0 00 00 03 06 00 35 00 00 00 00 i Code SL2 as per PCSC std part3 7 2 Features and Tag Support The CCID firmware supports the following standa...

Page 23: ...terested in the tag s UID 7 3 1 ATR for ISO14443 4 The ATR for an ISO14443 4 card is built around the historical bytes as received from the tag itself as the answer to the RATS command Up to 15 histor...

Page 24: ...nstruction INS Parameter 1 P1 Parameter 2 P2 Lc Payload Le 1 byte 1 byte 1 byte 1 byte 1 byte variable 1 byte Mandatory Optional The first four fields CLA INS P1 P2 are mandatory Each of them is encod...

Page 25: ...l bytes Response Data SW1 SW2 Response codes SW1 SW2 Meaning 90h 00h The complete data is returned 62h 82h The complete data is returned End of data reached i e Le is larger than the length of the UID...

Page 26: ...ubcarrier 8eh ISO15693 default memory configuration2 2 byte See table below 8fh Clear ISO15693 default memory configuration write only 0 The ISO15693 data rates are as following Data rate Single Subca...

Page 27: ...ignored Response SW1 SW2 Response codes SW1 SW1 Meaning 90h 00h Configuration updated 67h 00h Wrong length 6Ah 81h Function not supported The specified parameter value is invalid 6Bh 00h Unsupported...

Page 28: ...28 www ubisys de...

Page 29: ...nds can be used This default memory layout will only be used if the layout cannot be determined automatically 7 5 3 1 Read Binary This command reads data from the memory card Request CLA INS P1 P2 Le...

Page 30: ...LA INS P1 P2 Le FFh A2h see table ignored P1 P2 Description Response Payload 00h 00h Get total capacity in bytes 2 bytes 00h 01h Get number of blocks 1 byte 00h 02h Get block size in bytes 1 256 bytes...

Page 31: ...this means the removal of the tag from the reader s field can be detected Please note that the memory card access commands section 7 5 3 are not available when using the transparent mode The extended...

Page 32: ...marker to the tag approx 15 ms after the request frame was sent Afterwards the response is captured Request Command CLA INS P1 P2 Lc Payload Le Exchange transparent data FFh 27h 03h 00h Payload length...

Page 33: ...The ubisys RFID Control Center software is available at http www ubisys de rfid download software html free of charge and includes an online help which explains the necessary steps The package also i...

Page 34: ...34 www ubisys de...

Page 35: ...Update of CDC and CCID Devices Step 1b Step 1b applies to CDC CCID devices If you are planning to update a CDC or CCID device first use the connect command to click on the device which you want to upd...

Page 36: ...hen conducting the firmware update You can verify this by observing the command log when presenting a card to the reader The card ATR will be printed for any card that enters reading range Notice that...

Page 37: ...37 www ubisys de Figure 4 Acknowledging the Warning Notice Step 2 Step 2 Acknowledge the warning message...

Page 38: ...FID Control Center typically C Program Files ubisys technologies RFID Control Firmware Make sure that the USB connection is reliable while programming the firmware Do not turn off intermediate hubs If...

Page 39: ...t or smart card reader according to its desired USB device role Notice If the update fails for any reason you might be able to resume the update using the Resume Update command However this should nor...

Page 40: ...ways be passed by reference The same applies to CSmartCardTransaction which does not encapsulate a handle but manipulates the state of an object associated with a handle 9 2 1 CSmartCardContext Manage...

Page 41: ...CSmartCardContext typedef std basic_string TCHAR tstring 9 2 2 2 Constructor CSmartCard CSmartCardContext context const tstring strReader const DWORD dwShareMode SCARD_SHARE_SHARED const DWORD dwPref...

Page 42: ...and received is passed as void pointers together with the corresponding size parameters The number of bytes actually received is returned void BeginTransaction Begin a transaction Block other applicat...

Page 43: ...hanges const std vector unsigned char vbATR This method will be called for events on a specific card tag dwCurrentState indicates the current state and consists of SCARD_STATE_XXX flags dwChanges enco...

Page 44: ...ion class and can be used in MFC programs Please note that MFC exceptions must be caught by pointer whereas ordinary C exceptions are usually caught by const reference or less optimal by value CSmartC...

Page 45: ...ception and eventually determines the type of exception to throw Two default implementations are provided c f 9 2 7 9 2 7 Pre defined Exception Classes SCardException h and SCardException cpp contain...

Page 46: ...ased on the C class std exception overrides the what method virtual const char what const The method returns a plain CSmartCardException without the std prefix The MFC based implementation overrides t...

Page 47: ...47 www ubisys de 10 Physical Dimensions Figure 7 USB Stick with on board PCB antenna Figure 8 USB Stick with on board PCB antenna OEM without case...

Page 48: ...48 www ubisys de Figure 9 USB Stick with SMA Connector for External Antenna Figure 10 USB Stick with SMA Connector OEM without case...

Page 49: ...49 www ubisys de Figure 11 Desktop Reader Pro Case USB Micro B Socket Figure 12 Desktop Reader Case USB B Socket...

Page 50: ...201 010320 01 7092 HID U0201 010320 02 7108 CCID U0201 010320 03 7115 OEM without case CDC U0201 010020 01 7009 HID U0201 010020 02 7016 CCID U0201 010020 03 7023 SMA Connector Black CDC U0201 020120...

Page 51: ...51 www ubisys de 11 3 Desktop Case Firmware variant Product Number Order Code Light Grey RAL 7035 CDC U0202 010210 01 7245 HID U0202 010210 02 7252 CCID U0202 010210 03 7269...

Page 52: ...Equipment Directive RED 2014 30 EU Electromagnetic Compatibility Directive EMC 2014 35 EU Low Voltage Directive LVD 2012 19 EG Waste Electrical and Electronic Equipment Directive WEEE 2011 65 EU Rest...

Page 53: ...trol command information Minor editorial changes corrected documentation for write single block command CDC ACM 3 0 06 07 2012 Added Desktop Reader Pro dimensions and ordering information 3 1 19 07 20...

Page 54: ...Contact UBISYS TECHNOLOGIES GMBH HARDWARE AND SOFTWARE DESIGN ENGINEERING AND CONSULTING AM WEHRHAHN 45 40211 D SSELDORF GERMANY T 49 211 54 21 55 00 F 49 211 54 21 55 99 www ubisys de info ubisys de...