Reference Manual


VhlCfg / File / MifareVcsParams Value

This value enables Virtual Card Selection. An ISO Select command is performed to select a particular MIFARE (Plus) installation. If valid keys are specified, an additional ISO External Authenticate will be executed.

Properties

Format

Name Type/Size Description
VcsOptions Bit mask (8 bits) Virtual card select options
RFU Integer (bit mask area 0xF8) Zero padding
PrependUidBeforeMacDivData Boolean (bit 0x04) Prepends UID before VC Mac diversification data.
RejectCardsWithoutValidIid Boolean (bit 0x02) Cards without valid IIDs are rejected.
ForceAuthToCard Boolean (bit 0x01) Cards without encryption are rejected.
Length of DfName Integer (8 bits) Length of DfName in bytes
DfName Raw data Select VC with the given Installation Identifier (DF Name / 1..16 byte)
MifareVcsEncKeyMemoryType Enumeration (8 bits) This value references a key memory type within the reader. VHL detects the security level (SL0..3) of a Mifare classic/plus card automatically and according to the security level the adequate key memories (AES and/or Mifare keys) are chosen. For some key memory types a card in Mifare plus security level 2 (SL2) needs both keys (AES and Mifare): then the configuration value MifarePlusKeyIdxOffset describes an offset of Mifare keys to AES keys (! signed value).
Values:
  • CryptoKey (0x00)
    References keys within the CryptoKey memory.
    Key offset needed: refer to MifarePlusKeyIdxOffset
  • SamKey (0x01)
    References keys within a SAM, only available on SAM based readers: key index from 0x00 to 0x7F, a SAM key contains up to 3 AES keys with different versions or 3 Mifare key pairs (A and B). VHL uses always the first SAM key.
    Key offset needed: see MifarePlusKeyIdxOffset
  • ReaderChipKey (0x02)
    References keys which are stored in reader chip memory: 32 keys (index 0..31) are available. This memory contains only keys for Mifare classic cards (SL1).
  • VhlKey (0x03)
    References keys which are defined in respective VHL files:
    AES keys in MifarePlusAesKeyList
    Mifare keys in MifareKeyList
MifareVcsEncKeyIdx Integer (8 bits) Key entry of the virtual card select encryption key.
MifareVcsMacKeyMemoryType Enumeration (8 bits) This value references a key memory type within the reader. VHL detects the security level (SL0..3) of a Mifare classic/plus card automatically and according to the security level the adequate key memories (AES and/or Mifare keys) are chosen. For some key memory types a card in Mifare plus security level 2 (SL2) needs both keys (AES and Mifare): then the configuration value MifarePlusKeyIdxOffset describes an offset of Mifare keys to AES keys (! signed value).
Values:
  • CryptoKey (0x00)
    References keys within the CryptoKey memory.
    Key offset needed: refer to MifarePlusKeyIdxOffset
  • SamKey (0x01)
    References keys within a SAM, only available on SAM based readers: key index from 0x00 to 0x7F, a SAM key contains up to 3 AES keys with different versions or 3 Mifare key pairs (A and B). VHL uses always the first SAM key.
    Key offset needed: see MifarePlusKeyIdxOffset
  • ReaderChipKey (0x02)
    References keys which are stored in reader chip memory: 32 keys (index 0..31) are available. This memory contains only keys for Mifare classic cards (SL1).
  • VhlKey (0x03)
    References keys which are defined in respective VHL files:
    AES keys in MifarePlusAesKeyList
    Mifare keys in MifareKeyList
MifareVcsMacKeyIdx Integer (8 bits) Key entry of the virtual card select MAC key.