Affected Version: BioStar 2.9.4 or above
Affected Products & Versions:
XPass D2 Firmware Version v1.7.1 (Released in April 2023) and above
Device Manager App v1.1.8 (Android, Released in January 2023) and above

Are you using BioStar 2 software and Suprema devices through integration with 3rd party and needed ways to read smart cards issued by the 3rd party? BioStar 2 version 2.9.4 now supports a Custom Smart Card Layout feature, allowing 3rd party issued smart card to be read.

Please be aware that the [Custom Smart Card Layout] feature only supports reading custom smart cards; issuing (printing) custom smart cards is currently not one of its features. Furthermore, for RS-485 master device without a custom smart card layout feature, the custom smart card reading feature will also not work on the connected slave device.


In BioStar 2 Version 2.9.4, Smart Cards are categorized into two main types.
1. Suprema Smart Cards and 2. Custom Smart Cards.
1. Suprema Smart Cards
▶ Suprema Smart Cards are specifically issued using Suprema Device or through BioStar 2 software containing each user's biometric information.
2. Custom Smart Cards
▶ Custom Smart Cards, on the other hand, are cards issued by third-party products or systems without biometric data.
It's important to note that while BioStar 2 supports custom smart card reading, it does not support the issuance of custom smart cards, as stated above in the pre-text.

The Custom Smart Card Layout feature supports two card formats: MIFARE and DESFire.


Notable feature of Custom Smart Card Layout

  • Supports RAW type of card data
  • Supports smart card byte order
  • Capability to skip bytes during data reading through byte-skipping settings

The smart card byte order has been supported since BioStar 2 version 2.8.16; this feature ensures smart card data is read and processed correctly, regardless of the byte order used in the card's data structure. This compatibility feature eliminates potential issues related to byte order mismatches, making it easier to work correctly.

The capability to skip bytes during data reading through byte-skipping settings. This feature is especially useful when specific card data is stored within a larger data block. By defining the number of bytes to skip, retrieving the necessary information from the card, enhances data retrieval efficiency.

[Tutorial Video] How to Configure Custom Smart Card Layout The custom smart card layout set in the video can be applied to numerous devices connected to BioStar 2 version 2.9.4 with the “Device Batch Edit' feature.
Log in to BioStar 2 version 2.9.4 and higher → Devices → Select multiple devices with the [Custom Smart Card] layout feature, enable [Custom Smart Card], and select the particular layout you have previously created.

[Custom Smart Card] features setup in BioStar 2 Software ▶ Devices
Step 1. Login to BioStar 2
Step 2. Go to Devices
Step 3. Select the device supporting the [Custom Smart Card] feature
Step 4. Authentication → Card Type
Step 5. Enable Custom Smart Card
Note: The custom smart card feature is set as 'disabled' by default.

<callout type=“primary” icon=“false”> How to enroll custom smart cards to users in BioStar 2 Version 2.9.4 and above
Step 1. Login to BioStar 2
Step 2. Go to User
Step 3. Click on one of the users to add a custom card credential or clock on “ADD USER” to create a new user with a custom card credential
Step 4. Credential → Card → Card Type → Smart Card
Step 5. Select the device support Custom Smart Card feature
Step 6. Registration Option for the custom smart card works the same as enrolling CSN card in BioStar 2 software Note: Credential → Card → Card Type → Read Card: the read card feature in BioStar 2 can be applied to custom smart cards as well.
How to Use Custom Smart Card Layout