ACS ACM1281U-C7 Reference Manual

Usb contactless reader module with sam slot

Advertisement

Quick Links

ACM1281U-C7
USB Contactless Reader
Module with SAM Slot
Reference Manual V1.03
Subject to change without prior notice
info@acs.com.hk
www.acs.com.hk

Advertisement

Table of Contents
loading

Summary of Contents for ACS ACM1281U-C7

  • Page 1 ACM1281U-C7 USB Contactless Reader Module with SAM Slot Reference Manual V1.03 Subject to change without prior notice info@acs.com.hk www.acs.com.hk...
  • Page 2 Updated Section 5.0 Host Programming (PC-Linked) API ● Updated Section 5.2.5 Set Default LED and Buzzer Behavior 2020-06-16 1.03 ● Updated Section 5.2.6 Read Default LED and Buzzer Behavior Page 2 of 44 www.acs.com ACM1281U-C7 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.03...
  • Page 3: Table Of Contents

    Table of Contents 1.0. Introduction ....................... 5 2.0. Features ........................6 3.0. ACM1281U-C7 Architecture ..................7 3.1. Reader Block Diagram ......................7 3.2. Communication between PC/SC driver PICC and SAM ............7 4.0. Hardware Design ....................... 8 4.1. USB ............................8 4.1.1.
  • Page 4 List of Figures Figure 1 : ACM1281U-C7 Reader Block Diagram ................. 7 Figure 2 : ACM1281U-C7 Architecture ....................7 List of Tables Table 1 : USB Interface Wiring ....................... 8 Table 2 : Buzzer Event ........................... 9 Table 3 : LED Indicator ........................... 9 Table 4 : ISO 14443 Part 3 ATR Format ....................
  • Page 5: Introduction

    This Reference Manual will discuss in detail how the PC/SC APDU commands are implemented for the contactless interface, SAM card support and device peripherals of ACM1281U-C7. Page 5 of 44 www.acs.com...
  • Page 6: Features

    • Supports Android™ 3.1 and later • Compliant with the following standards: ISO 14443 ISO 7816 PC/SC CCID RoHS REACH Microsoft® WHQL Uses an ACS-defined Android Library Page 6 of 44 www.acs.com ACM1281U-C7 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.03...
  • Page 7: Acm1281U-C7 Architecture

    3.1. Reader Block Diagram Figure 1: ACM1281U-C7 Reader Block Diagram 3.2. Communication between PC/SC driver PICC and SAM The protocol used between ACM1281U-C7 and the PC is CCID. All communications between PICC and SAM are PC/SC-compliant. Figure 2: ACM1281U-C7 Architecture Page 7 of 44 www.acs.com...
  • Page 8: Hardware Design

    Control Endpoint – For setup and control purposes. Bulk-OUT – For commands to be sent from host to ACM1281U-C7 (data packet size is 64 bytes). Bulk-IN – For response to be sent from ACM1281U-C7 to host (data packet size is 64 bytes).
  • Page 9: User Interface

    1. No PICC Found or PICC present but A single pulse per ~ 5 seconds not activated. 2. PICC is present and activated. 3. PICC is operating. Blinking Table 3: LED Indicator Page 9 of 44 www.acs.com ACM1281U-C7 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.03...
  • Page 10: Host Programming (Pc-Linked) Api

    ATR for MIFARE 1K = {3B 8F 80 01 80 4F 0C A0 00 00 03 06 00 01 00 00 00 00 6Ah} Initial Card Length Standard Header Name Page 10 of 44 www.acs.com ACM1281U-C7 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.03...
  • Page 11: Table 5: Iso 14443 Part 4 Atr Format

    Data from Byte from from ATTRIB ATQB ATQB command Lower nibble (RFU)=0 Exclusive-oring of all the bytes T0 to Tk Table 5: ISO 14443 Part 4 ATR Format Page 11 of 44 www.acs.com ACM1281U-C7 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.03...
  • Page 12 1C 2D 94 11 F7 71 85 00 Application Data of ATQB = 1C 2D 94 11h Protocol Information of ATQB = F7 71 85h MBLI of ATTRIB = 00h Page 12 of 44 www.acs.com ACM1281U-C7 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.03...
  • Page 13: Pseudo Apdus For Contactless Interface

    UINT8 GET_UID[5] = {FF CA 00 00 00h}; Example 2: To get the ATS of the connected ISO 14443-A PICC: UINT8 GET_ATS[5] = {FF CA 01 00 00h}; Page 13 of 44 www.acs.com ACM1281U-C7 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.03...
  • Page 14: Picc Commands (T=Cl Emulation) For Mifare 1K/4K Memory Cards

    Load a key { FF FF FF FF FF FFh } into the volatile memory location 20h. APDU = {FF 82 00 20 06 FF FF FF FF FF FFh} Page 14 of 44 www.acs.com ACM1281U-C7 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.03...
  • Page 15 “key value” that will not change frequently. If the ”key value” is supposed to be changed from time to time, store the “key value” to the “volatile key location 20h” instead. Page 15 of 44 www.acs.com ACM1281U-C7 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.03...
  • Page 16 PC. Only 1 volatile memory is provided. The volatile key can be used as a session key for different sessions. Default value = FF FF FF FF FF FFh. Page 16 of 44 www.acs.com ACM1281U-C7 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.03...
  • Page 17: Table 6: Mifare 1K Memory Map

    Sector 32 80h ~ 8Eh Sector 33 90h ~ 9Eh 2 KB Sector 38 E0h ~ EEh Sector 39 F0h ~ FEh Table 7: MIFARE 4K Memory Map Page 17 of 44 www.acs.com ACM1281U-C7 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.03...
  • Page 18: Table 8: Mifare Ultralight Memory Map

    Data33 Data34 Data35 Data read/write Data36 Data37 Data38 Data39 Data read/write Data40 Data41 Data42 Data43 Data read/write Data44 Data45 Data46 Data47 Table 8: MIFARE Ultralight Memory Map Page 18 of 44 www.acs.com ACM1281U-C7 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.03...
  • Page 19 Example 2: Read 240 bytes starting from the binary block (MIFARE 4K). Block 80h to Block 8Eh (15 blocks). APDU = { FF B0 00 F0 } Page 19 of 44 www.acs.com ACM1281U-C7 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.03...
  • Page 20 Example 2: Update the binary block of MIFARE Ultralight with Data { 00 01 02 03h } APDU = {FF D6 00 04 00 01 02 03h} Page 20 of 44 www.acs.com ACM1281U-C7 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.03...
  • Page 21 Example 2: Decimal 1 = { 00 00 00 01h } VB_Value Response Response Data Out Result Where: SW1 SW2 = 90 00h means the operation was completed successfully. = 63 00h means the operation failed. Page 21 of 44 www.acs.com ACM1281U-C7 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.03...
  • Page 22 Example 2: Decimal 1 = { 00 00 00 01h } VB_Value Response Response Data Out Result Where: SW1 SW2 = 90 00h means the operation was completed successfully. = 63 00h means the operation failed. Page 22 of 44 www.acs.com ACM1281U-C7 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.03...
  • Page 23 APDU = {FF D7 06h} by “5” Example 4: Increment the value block APDU = {FF D7 00 00 00 05h} Page 23 of 44 www.acs.com ACM1281U-C7 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.03...
  • Page 24: Access Pc/Sc-Compliant Tags (Iso 14443-4)

    5.1.4. Access PC/SC-compliant tags (ISO 14443-4) All ISO 14443-4 compliant cards (PICCs) understand the ISO 7816-4 APDUs. The ACM1281U-C7 reader will only need to communicate with the ISO 14443-4 compliant cards through exchanging ISO 7816-4 APDUs and responses. ACM1281U-C7 will handle the ISO 14443 Parts 1-4 Protocols internally.
  • Page 25: Accessing Mifare Desfire Tags (Iso 14443-4)

    In which, the first byte “AF” is the status code returned by the MIFARE DESFire card. The Data inside the blanket [$1DD7h] can simply be ignored by the application. Page 25 of 44 www.acs.com ACM1281U-C7 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.03...
  • Page 26 1. If the response length is less than 2, the status code [90 00h] will be added in order to meet the requirement of PC/SC. The minimum response length is 2. Page 26 of 44 www.acs.com ACM1281U-C7 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.03...
  • Page 27: Peripherals Control

    Response = E1 00 00 00 0F 41 43 52 31 32 38 31 55 5F 56 37 30 32 2E 32 Firmware Version (HEX) = 41 43 52 31 32 38 31 55 5F 56 37 30 32 2E 32 Firmware Version (ASCII) = “ACR1281U_V702.2” Page 27 of 44 www.acs.com ACM1281U-C7 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.03...
  • Page 28: Led Control

    1 = ON Bit 1 Green LED 0 = OFF Bit 2 – 7 LED Control Response Format (6 bytes) Response Class Data Out Result LED Status Page 28 of 44 www.acs.com ACM1281U-C7 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.03...
  • Page 29: Led Status

    LED Status Description Description 1 = ON Bit 0 Red LED 0 = OFF 1 = ON Bit 1 Green LED 0 = OFF Bit 2 – 7 Page 29 of 44 www.acs.com ACM1281U-C7 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.03...
  • Page 30: Buzzer Control

    Buzzer ON Duration (1 Byte) 00h = OFF 01 – FFh = Duration (unit: 10 ms) Buzzer Control Response Format (6 bytes) Response Class Data Out Result Page 30 of 44 www.acs.com ACM1281U-C7 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.03...
  • Page 31: Set Default Led And Buzzer Behaviors

    (PICC) is being accessed. Note: Default value of Behaviors = FBh. Set LED and Buzzer Behaviors Response Format (6 bytes) Response Class Data Out Result Default Behaviors Page 31 of 44 www.acs.com ACM1281U-C7 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.03...
  • Page 32: Read Default Led And Buzzer Behaviors

    Bit 6 To make the LED blink whenever the Bit 7 Card Operation Blinking LED card (PICC) is being accessed. Note: Default value of Behaviors = FBh. Page 32 of 44 www.acs.com ACM1281U-C7 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.03...
  • Page 33: Set Automatic Picc Polling

    1 = Enable Bit 7 Enforce ISO 14443A Part 4 0 = Disable Note: Default value of Behaviors = 8Fh. Response Response Class Data Out Result Polling Setting Page 33 of 44 www.acs.com ACM1281U-C7 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.03...
  • Page 34 4. The JCOP30 card comes with two modes: ISO 14443A-3 (MIFARE 1K) and ISO 14443A-4 modes. The application has to decide which mode should be selected once the PICC is activated. Page 34 of 44 www.acs.com ACM1281U-C7 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.03...
  • Page 35: Read Automatic Picc Polling

    1 – 1 = 2500 ms Bit 6 1 = Enable Bit 7 Enforce ISO 14443A Part 4 0 = Disable Note: Default value of Behaviors = 8Fh. Page 35 of 44 www.acs.com ACM1281U-C7 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.03...
  • Page 36: Manual Picc Polling

    Manual PICC Polling Response Format (6 bytes) Response Class Data Out Result Status Where: Status (1 Byte) 00h = PICC is detected FFh = No PICC is detected Page 36 of 44 www.acs.com ACM1281U-C7 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.03...
  • Page 37: Set Picc Operating Parameter

    0 = Skip Bit 2 – 7 Note: Default value of Behaviors = 03h. Set PICC Operating Parameter Response Format (6 bytes) Response Class Data Out Result Operating Parameter Page 37 of 44 www.acs.com ACM1281U-C7 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.03...
  • Page 38: Read Picc Operating Parameter

    The tag types to be 0 = Skip detected during 1 = Detect PICC Polling Bit 1 ISO 14443 Type B 0 = Skip Bit 2 – 7 Page 38 of 44 www.acs.com ACM1281U-C7 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.03...
  • Page 39: Appendix A. Basic Program Flow For Contactless Applications

    Step 1: Connect the “ACR1281U PICC Interface” with T=1 protocol. Step 2: Access the PICC by exchanging APDUs. Step N: Disconnect the “ACR1281U PICC Interface”. Shut down the application. Page 39 of 44 www.acs.com ACM1281U-C7 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.03...
  • Page 40: Appendix B. Extended Apdu Example

    0E1E2E3E4E5E6E7E8E9EAEBECEDEEEFF0F1F2F3F4F5F6F7F8F9FAFBFCFDFEFF9000h Example 2: APDU length = 775 bytes APDU Command: 80D20000000300000102030405060708090A0B0C0D0E0F101112131415161718191A1B1C1D1E1F 202122232425262728292A2B2C2D2E2F303132333435363738393A3B3C3D3E3F40414243444546 4748494A4B4C4D4E4F505152535455565758595A5B5C5D5E5F606162636465666768696A6B6C6 D6E6F707172737475767778797A7B7C7D7E7F808182838485868788898A8B8C8D8E8F90919293 9495969798999A9B9C9D9E9FA0A1A2A3A4A5A6A7A8A9AAABACADAEAFB0B1B2B3B4B5B6B7B 8B9BABBBCBDBEBFC0C1C2C3C4C5C6C7C8C9CACBCCCDCECFD0D1D2D3D4D5D6D7D8D9D ADBDCDDDEDFE0E1E2E3E4E5E6E7E8E9EAEBECEDEEEFF0F1F2F3F4F5F6F7F8F9FAFBFCFD FEFF000102030405060708090A0B0C0D0E0F101112131415161718191A1B1C1D1E1F2021222324 25262728292A2B2C2D2E2F303132333435363738393A3B3C3D3E3F404142434445464748494A4B 4C4D4E4F505152535455565758595A5B5C5D5E5F606162636465666768696A6B6C6D6E6F70717 2737475767778797A7B7C7D7E7F808182838485868788898A8B8C8D8E8F9091929394959697989 99A9B9C9D9E9FA0A1A2A3A4A5A6A7A8A9AAABACADAEAFB0B1B2B3B4B5B6B7B8B9BABBBC BDBEBFC0C1C2C3C4C5C6C7C8C9CACBCCCDCECFD0D1D2D3D4D5D6D7D8D9DADBDCDDDE DFE0E1E2E3E4E5E6E7E8E9EAEBECEDEEEFF0F1F2F3F4F5F6F7F8F9FAFBFCFDFEFF0001020 30405060708090A0B0C0D0E0F101112131415161718191A1B1C1D1E1F202122232425262728292 A2B2C2D2E2F303132333435363738393A3B3C3D3E3F404142434445464748494A4B4C4D4E4F50 5152535455565758595A5B5C5D5E5F606162636465666768696A6B6C6D6E6F7071727374757677 Page 40 of 44 www.acs.com ACM1281U-C7 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.03...
  • Page 41 78797A7B7C7D7E7F808182838485868788898A8B8C8D8E8F909192939495969798999A9B9C9D9 E9FA0A1A2A3A4A5A6A7A8A9AAABACADAEAFB0B1B2B3B4B5B6B7B8B9BABBBCBDBEBFC0C1 C2C3C4C5C6C7C8C9CACBCCCDCECFD0D1D2D3D4D5D6D7D8D9DADBDCDDDEDFE0E1E2E3 E4E5E6E7E8E9EAEBECEDEEEFF0F1F2F3F4F5F6F7F8F9FAFBFCFDFEFFh Response: 000102030405060708090A0B0C0D0E0F101112131415161718191A1B1C1D1E1F20212223242526 2728292A2B2C2D2E2F303132333435363738393A3B3C3D3E3F404142434445464748494A4B4C4 D4E4F505152535455565758595A5B5C5D5E5F606162636465666768696A6B6C6D6E6F70717273 7475767778797A7B7C7D7E7F808182838485868788898A8B8C8D8E8F909192939495969798999A 9B9C9D9E9FA0A1A2A3A4A5A6A7A8A9AAABACADAEAFB0B1B2B3B4B5B6B7B8B9BABBBCBDB EBFC0C1C2C3C4C5C6C7C8C9CACBCCCDCECFD0D1D2D3D4D5D6D7D8D9DADBDCDDDEDFE 0E1E2E3E4E5E6E7E8E9EAEBECEDEEEFF0F1F2F3F4F5F6F7F8F9FAFBFCFDFEFF00010203040 5060708090A0B0C0D0E0F101112131415161718191A1B1C1D1E1F202122232425262728292A2B2 C2D2E2F303132333435363738393A3B3C3D3E3F404142434445464748494A4B4C4D4E4F505152 535455565758595A5B5C5D5E5F606162636465666768696A6B6C6D6E6F70717273747576777879 7A7B7C7D7E7F808182838485868788898A8B8C8D8E8F909192939495969798999A9B9C9D9E9FA 0A1A2A3A4A5A6A7A8A9AAABACADAEAFB0B1B2B3B4B5B6B7B8B9BABBBCBDBEBFC0C1C2C3 C4C5C6C7C8C9CACBCCCDCECFD0D1D2D3D4D5D6D7D8D9DADBDCDDDEDFE0E1E2E3E4E5 E6E7E8E9EAEBECEDEEEFF0F1F2F3F4F5F6F7F8F9FAFBFCFDFEFF000102030405060708090A 0B0C0D0E0F101112131415161718191A1B1C1D1E1F202122232425262728292A2B2C2D2E2F303 132333435363738393A3B3C3D3E3F404142434445464748494A4B4C4D4E4F50515253545556575 8595A5B5C5D5E5F606162636465666768696A6B6C6D6E6F707172737475767778797A7B7C7D7E 7F808182838485868788898A8B8C8D8E8F909192939495969798999A9B9C9D9E9FA0A1A2A3A4A 5A6A7A8A9AAABACADAEAFB0B1B2B3B4B5B6B7B8B9BABBBCBDBEBFC0C1C2C3C4C5C6C7C 8C9CACBCCCDCECFD0D1D2D3D4D5D6D7D8D9DADBDCDDDEDFE0E1E2E3E4E5E6E7E8E9EA EBECEDEEEFF0F1F2F3F4F5F6F7F8F9FAFBFCFDFEFF9000h Page 41 of 44 www.acs.com ACM1281U-C7 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.03...
  • Page 42: Appendix C. Escape Command Example

    Step 4: Enter Command: “3500” Enter Data: “E0 00 00 18 00” (APDU for Get Firmware Version) Click enter to send to reader, then check the Response. Page 42 of 44 www.acs.com ACM1281U-C7 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.03...
  • Page 43: Appendix D. Acr128 Compatibility

    8. Buzzer Control 00 = Turn Off Duration: 01 – FE = Duration x 10 ms 01 – FF = Duration x 10 ms FF = Turn On Page 43 of 44 www.acs.com ACM1281U-C7 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.03...
  • Page 44 Microsoft is a registered trademark of Microsoft Corporation in the United States and/or other countries. MIFARE, MIFARE Classic, MIFARE DESFire and MIFARE Ultralight are registered trademarks of NXP B.V. and are used under license. Page 44 of 44 www.acs.com ACM1281U-C7 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.03...

Table of Contents