Smartcard API

API that provides a function that reads and writes card data.

• BS2_ScanCard: Scans the card from the device and analyzes it.
• BS2_WriteCard: Writes data to the smart card.
• BS2_EraseCard: Formats the smart card.
• BS2_WriteQRCode: [+ V2.8] Write the character strings to use QR code in the structure BS2CSN Card for X-Station 2.

typedef struct {
    uint8_t type;
    uint8_t size;
    uint8_t data[BS2_CARD_DATA_SIZE];
} BS2CSNCard;

1. type
The code value of card type. The card type is to indicate the purpose of the card. When transferring a user from device to server, the Access card will be used only to keep the issue history, since the Access card will work on its own without any user information.

2. size
The size of card template. This field needs to be filled with a fixed value as '32'.

3. data
The data of card template.
In case of Secure Credential Card(SCC), users need to have card information which includes Card ID(24byte), issueCount(4byte) and TimeStamp(4byte). Also, cardObjs array of BS2UserBlob structure should be filled for SCC cards and the user should be updated after SCC issuing.

typedef struct {
    uint16_t hdrCRC;
    uint16_t cardCRC;
    BS2_CARD_TYPE cardType;
    uint8_t numOfTemplate;
    uint16_t templateSize;
    uint16_t issueCount;
    uint8_t duressMask;
    uint8_t cardAuthMode;
    uint8_t useAlphanumericID;
    uint8_t cardAuthModeEx;
    uint8_t numOfFaceTemplate;
    uint8_t reserved[1];
} BS2SmartCardHeader;

1. hdrCRC
Value of card header checksum. (cardCRC - reserved)

2. cardCRC
Value of card data checksum. (BS2SmartCardHeader.cardType - BS2SmartCardData.accessOnData)

3. cardType
Code of card types.

4. numOfTemplate
Number of templates.

5. templateSize
Size of the template. A normal fingerprint template is a fixed 384 byte.
If you are using a smart card the default in BioStar 2 is 300 bytes and you can change as required but we recommend that you set it above 300 bytes because if the template size is too small it can cause fingerprint matching issues because of the lack of information in the template.

6. issueCount
Number of smart card issue count.

7. duressMask
Mask for whether there is a duress finger.
8. cardAuthMode
Other devices Card authentication mode.
FaceStation F2 Please use cardAuthModeEx instead

9. useAlphanumericID
Flag of usage of Alphanumeric ID
10. cardAuthModeEx
Other devices Please use cardAuthMode instead
[+ V2.7.1] FaceStation F2 Card authentication mode

11. numOfFaceTemplate
Number of face templates.
Basic size of template is different between fingerprint and face(Fingerprint:384, Face:552).
You can consider the total size of templateData in BS2SmartCardCredentials.

12. reserved
Reserved

typedef struct {
    uint8_t pin[BS2_PIN_HASH_SIZE];
    uint8_t templateData[BS2_SMART_CARD_MAX_TEMPLATE_COUNT * BS2_FINGER_TEMPLATE_SIZE];
} BS2SmartCardCredentials;

1. pin
Value of PIN.

2. templateData
List of fingerprint template data area, which can be stored up to 4 fingerprint templates.

typedef struct {
    uint16_t accessGroupID[BS2_SMART_CARD_MAX_ACCESS_GROUP_COUNT];
    BS2_DATETIME startTime;
    BS2_DATETIME endTime;
} BS2AccessOnCardData;

1. accessGroupID
List of access group IDs.

2. startTime
Starting time where a user can authenticate. When it is set as 0, there are no limits.

3. endTime
Ending time where a user can authenticate. When it is set as 0, there are no limits.

typedef struct {
    BS2SmartCardHeader header;
    uint8_t cardID[BS2_CARD_DATA_SIZE];
    BS2SmartCardCredentials credentials;
    BS2AccessOnCardData accessOnData;
} BS2SmartCardData;    

1. header
Smart card header.

2. cardID
Card ID that will be used on the card.
Access on Cards will need to use the 32 byte array for the card ID.
Secure Credential Cards will need to use a 24 byte array for the card ID.
In case of Secure Credential Card(SCC), users need to have card information which includes Card ID(24byte), issueCount(4byte) and TimeStamp(4byte).
Also, cardObjs array of BS2UserBlob structure should be filled for SCC cards and the user should be updated after SCC issuing.

3. credentials
Authentication data area where the PIN or fingerprint template is stored.

4. accessOnData
Data area the AOC card uses, which carries the access group information.

typedef struct {
    uint8_t isSmartCard;
    union {
        BS2CSNCard card;
        BS2SmartCardData smartCard;
    };
}BS2Card;   

1. isSmartCard
Decides whether it is a smart card.

2. card
CSN card data.

3. smartCard
Smart card data.