Benutzerhandbuch für SPRINGCARD SAS PRNHSP01

Inhaltsverzeichnis

• 1. Introduction

  6
  • 1.1. Abstract

    6
  • 1.2. Supported products

    6
  • 1.3. Related documents

    8
    • a. End users

      8
    • b. Integrators

      8
  • 1.4. Audience

    8
  • 1.5. Support and updates

    8
  • 1.6. Useful links

    9
• 2. PC/SC, smartcards and NFC: quick introduction and glossary

  10
  • 2.1. Smart-card and contactless smartcards standards

    10
  • 2.2. PC/SC

    11
    • a. PC/SC and a contact smartcard

      11
    • b. PC/SC and a contactless smartcard

      12
  • 2.3. Non-7816-4 contactless cards – introducing the embedded APDU interpreter

    12
    • a. Role of the embedded APDU interpreter

      13
  • 2.4. NFC ?

    13
  • 2.5. Vendor-specific features – direct control of the coupler

    14
  • 2.6. Glossary – useful terms

    15
• 3. Embedded APDU interpreter

  19
  • 3.1. Basis

    19
    • 3.1.1. CLA byte of the embedded APDU interpreter

      19
      • a. Changing the CLA byte of the embedded APDU interpreter

        19
      • b. Disabling the embedded APDU interpreter

        19
    • 3.1.2. Status words returned by the embedded APDU interpreter

      20
    • 3.1.3. Embedded APDU interpreter instruction list

      21
  • 3.2. Instructions defined by the PC/SC standard (v2 part 3)

    22
    • 3.2.1. GET DATA instruction

      22
    • 3.2.2. LOAD KEY instruction

      24
    • 3.2.3. GENERAL AUTHENTICATE instruction

      26
    • 3.2.4. READ BINARY instruction

      28
    • 3.2.5. UPDATE BINARY instruction

      30
  • 3.3. SpringCard-specific instructions for the contactless slot

    32
    • 3.3.1. MIFARE CLASSIC READ instruction

      32
      • a. MIFARE CLASSIC READ using coupler’s keys

        32
      • b. MIFARE CLASSIC READ selecting a key in the coupler

        33
      • c. MIFARE CLASSIC READ with specified key

        33
    • 3.3.2. MIFARE CLASSIC WRITE instruction

      34
      • a. MIFARE CLASSIC WRITE using coupler’s keys

        34
      • b. MIFARE CLASSIC WRITE selecting a key in the coupler

        35
      • c. MIFARE CLASSIC WRITE with specified key

        35
    • 3.3.3. MIFARE CLASSIC VALUE instruction

      37
      • a. MIFARE CLASSIC VALUE using coupler’s keys

        37
      • b. MIFARE CLASSIC VALUE selecting a key in the coupler

        38
      • c. MIFARE CLASSIC VALUE with specified key

        39
    • 3.3.4. RFID MEMORY CONTROL instruction

      40
      • a. Read Single Block

        40
      • b. Write Single Block

        40
      • c. Lock Block

        41
      • d. Read Multiple Blocks

        41
      • e. Write Multiple Blocks

        41
      • f. Write AFI

        41
      • g. Lock AFI

        42
      • h. Write DSFID

        42
      • i. Lock DSFID

        42
      • j. Get System Information

        42
      • k. Get Multiple Block Security

        43
    • 3.3.5. CONTACTLESS SLOT CONTROL instruction

      44
    • 3.3.6. SET FELICA RUNTIME PARAMETERS instruction

      45
      • a. SERVICE CODE for the READ BINARY instruction

        45
      • b. SERVICE CODE for the UPDATE BINARY instruction

        46
      • c. SERVICE CODE for both READ BINARY and UPDATE BINARY instructions

        46
      • d. SYSTEM CODE and REQUEST code for Felica polling

        46
    • 3.3.7. ENCAPSULATE instruction for the Contactless slot

      47
    • 3.3.8. ENCAPSULATE instruction for one of the Contact slots

      51
  • 3.4. Other SpringCard-specific instructions

    52
    • 3.4.1. READER CONTROL instruction

      52
      • a. Driving coupler’s LEDs

        52
      • b. Driving coupler’s buzzer

        53
      • c. Others

        53
    • 3.4.2. TEST instruction

      54
• 4. Working with contactless cards – useful hints

  56
  • 4.1. Recognizing and identifying PICC/VICC in PC/SC environment

    56
    • 4.1.1. ATR of an ISO 14443-4 compliant smartcard

      56
      • a. For ISO 14443-A:

        56
      • b. For ISO 14443-B:

        56
      • c. For Innovatron (legacy Calypso cards):

        57
    • 4.1.2. ATR of a wired-logic PICC/VICC

      58
    • 4.1.3. Using the GET DATA instruction

      59
    • 4.1.4. Contactless protocol

      59
    • 4.1.5. Contactless card name bytes

      60
  • 4.2. ISO 14443-4 PICCs

    62
    • 4.2.1. Desfire first version (0.4)

      62
    • 4.2.2. Desfire EV0 (0.6) and EV1

      62
    • 4.2.3. Calypso cards

      62
  • 4.3. Wired-logic PICCs based on ISO 14443-A

    63
    • 4.3.1. Mifare Classic

      63
      • a. READ BINARY instruction

        63
      • b. UPDATE BINARY instruction

        64
      • c. Specific instructions for Mifare Classic

        64
    • 4.3.2. Mifare Plus X and Mifare Plus S

      65
      • a. Level 0

        65
      • b. Level 1

        65
      • c. Level 2

        65
      • d. Level 3

        66
    • 4.3.3. NFC Forum Type 2 Tags – Mifare UltraLight and UltraLight C, NTAG203...

      67
      • a. READ BINARY instruction

        67
      • b. UPDATE BINARY instruction

        68
      • c. Mifare UltraLight C 3-DES authentication

        68
    • 4.3.4. NFC Forum Type 1 Tags – Innovision/Broadcom chips

      69
      • a. Memory Structures

        69
      • b. READ BINARY instruction

        70
      • Using the RALL or RSEG functions is a lot faster than using READ/READ8 in a loop.

        70
      • c. UPDATE BINARY instruction

        71
  • 4.4. Wired-logic PICCs based on ISO 14443-B

    72
    • 4.4.1. ST Micro Electronics SR176

      72
      • a. READ BINARY instruction

        72
      • b. UPDATE BINARY instruction

        72
    • 4.4.2. ST Micro Electronics SRI4K, SRIX4K, SRI512, SRX512, SRT512

      73
      • a. READ BINARY instruction

        73
      • b. UPDATE BINARY instruction

        73
    • 4.4.3. Inside Contactless PicoPass, ISO 14443-2 mode

      74
      • a. READ BINARY instruction

        74
      • b. UPDATE BINARY instruction

        74
      • c. Page select

        74
    • 4.4.4. Inside Contactless PicoPass, ISO 14443-3 mode

      75
      • a. READ BINARY instruction

        75
      • b. UPDATE BINARY instruction

        75
    • 4.4.5. Atmel CryptoRF

      76
      • a. READ BINARY instruction

        76
      • b. UPDATE BINARY instruction

        76
  • 4.5. ISO 15693 VICCs

    77
    • 4.5.1. ISO 15693-3 read/write commands

      77
      • a. READ BINARY instruction

        77
      • b. UPDATE BINARY instruction

        77
    • 4.5.2. Read/write commands for ST Micro Electronics chips with a 2-B block address

      78
    • 4.5.3. Complete ISO 15693 command set

      78
    • 4.5.4. Implementation of basic ISO 15693 commands

      79
      • a. Read single block

        79
      • b. Write single block

        79
      • c. Lock block

        80
      • d. Write AFI

        80
      • e. Lock AFI

        80
      • f. Write DSFID

        80
      • g. Lock DSFID

        80
      • h. Get system information

        80
  • 4.6. Other non-ISO PICCs

    82
    • 4.6.1. NFC Forum Type 3 Tags / Felica

      82
      • a. READ BINARY instruction

        82
      • b. UPDATE BINARY instruction (single byte)

        82
  • 4.7. Other non-ISO VICCs

    83
    • 4.7.1. EM4134

      83
      • a. READ BINARY instruction

        83
      • b. UPDATE BINARY instruction

        83
      • c. Lock

        83
• 5. Using the H663 with a NFCIP-1 target

  84
  • 5.1. Introduction

    84
    • 5.1.1. Functions performed by the coupler

      84
    • 5.1.2. Functions to be implemented on the PC

      85
  • 5.2. Mapping of the NFC functions into PC/SC functions

    85
    • 5.2.1. ATR of an ISO 18092 target

      85
    • 5.2.2. Using SCardTransmit (ENCAPSULATE) to exchange PDUs

      86
  • 5.3. Advanced features

    86
    • 5.3.1. Changing the GI bytes in the ATR_REQ

      86
• 6. Direct control of the H663

  88
  • 6.1. Basis

    88
  • 6.2. Implementation details

    88
    • 6.2.1. Sample code

      88
    • 6.2.2. Link to SpringProx legacy protocol

      90
    • 6.2.3. Format of response, return codes

      90
    • 6.2.4. Redirection to the Embedded APDU Interpreter

      90
  • 6.3. List of available control sequences

    91
    • 6.3.1. Action on the LEDs

      91
      • a. Setting the coupler's LEDs manually

        91
      • b. Going back to default (LEDs managed by the coupler's firmware)

        91
    • 6.3.2. Action on the buzzer

      92
      • a. Starting/stopping the buzzer

        92
      • b. Going back to default (buzzer managed by the coupler's firmware)

        92
    • 6.3.3. Obtaining information on coupler and slots

      93
      • a. Coupler “product-wide” information

        93
      • b. Slot related information

        93
    • 6.3.4. Stopping / starting a slot

      94
      • a. Stopping a slot

        94
      • b. Starting a slot

        94
    • 6.3.5. Forced insert/remove sequences

      95
      • a. Card insertion

        95
      • b. Card remove

        95
    • 6.3.6. Reading/writing H663's configuration registers

      96
      • a. Reading coupler’s registers

        96
      • b. Writing coupler’s registers

        96
    • 6.3.7. Pushing a new temporary configuration

      97
• 7. Configuration registers

  98
  • 7.1. Editing coupler's configuration

    98
    • 7.1.1. By software

      98
    • 7.1.2. Using SpringCard MultiConf software

      98
  • 7.2. List of the configuration registers available to the end-user or integrator

    99
  • 7.3. Core configuration

    100
    • 7.3.1. Configuration of the LEDs

      100
    • 7.3.2. Options for the LEDs and GPIOs

      101
    • 7.3.3. Behaviour of the LEDs and buzzer

      101
  • 7.4. PC/SC configuration

    102
    • 7.4.1. Slot naming and startup mode

      102
    • 7.4.2. CLA byte of APDU interpreter

      102
    • 7.4.3. Behaviour of the contactless slot in PC/SC mode

      103
  • 7.5. Contactless configuration

    104
    • 7.5.1. Enabled protocols

      104
    • 7.5.2. Parameters for polling

      105
    • 7.5.3. Options for polling

      106
    • 7.5.4. Allowed baudrates in T=CL (ISO 14443-4)

      107
    • 7.5.5. Options for T=CL (ISO 14443-4)

      108
    • 7.5.6. Number of antennas + auto-stop

      108
  • 7.6. Felica configuration

    109
    • 7.6.1. Service Codes for Felica read/write

      109
  • 7.7. ISO 18092 / NFC-DEP configuration

    110
    • 7.7.1. Global Bytes in ATR_REQ

      110
  • 7.8. ISO 7816 configuration

    111
    • 7.8.1. Options for the smartcard slots

      111
• 8. Annex A – Specific error codes

  112
• 9. Annex B – activating SCardControl with the different drivers

  114
  • 9.1. Direct control using SpringCard SDD480

    114
  • 9.2. Direct control using MS USBCCID

    114
  • 9.3. Direct control using MS WUDFUsbccidDriver

    115
  • 9.4. Direct control using PCSC-Lite CCID

    116
• 10. 3rd-party licenses

  117
  • 10.1. FreeRTOS

    117