차이

문서의 선택한 두 판 사이의 차이를 보여줍니다.

--- ko:smartcard_api [2018/03/12 09:50]
kkshin [BS2SmartCardHeader]
+++ ko:smartcard_api [2025/10/16 14:39] (현재)
alex [BS2CSNCard]
@@ 줄 7: / 줄 7: @@
   * [[BS2_WriteCard]]: SmartCard에 데이터를 저장합니다.
   * [[BS2_EraseCard]]: SmartCard를 포맷합니다.
 ===== 구조체 ======
 ==== BS2CSNCard ====
@@ 줄 21: / 줄 22: @@
 <WRAP group 100%>
 ^값      ^설명     ^사용된 형식   ^
-|0x00 |알려지지 않은 카드  |
+|0x00 |알려지지 않은 카드  |  |
-|0x01 |CSN 카드    |
+|0x01 |CSN 카드    |  |
-|0x02 |Secure 카드    |
+|0x02 |Secure 카드    |  |
-|0x03 |Access 카드  |
+|0x03 |Access 카드  |  |
+|0x06 |QR 코드  |  |
 |0x0A |Wiegand 카드  | BS2WiegandConfig.format (이 형식은  BS2WiegandConfig.CSNIndex 혹은 BS2WiegandConfig.CardMask가 0으로 설정될 때 사용됩니다. |
 |0x0B |Config 카드  |
+|0x0D |Custom smart card 카드  |
 |0x1A |Wiegand 카드  | BS2WiegandMultiConfig.formats[0] |
 |0x2A |Wiegand 카드  | BS2WiegandMultiConfig.formats[1] |
@@ 줄 45: / 줄 48: @@
 **2. //size//** \\
-카드 템플릿의 크기입니다. \\ \\
+데이터 버퍼 사이즈 크기입니다. \\ \\
 **3. //data//** \\
 카드 템플릿 데이터입니다. \\
@@ 줄 59: / 줄 62: @@
     uint16_t issueCount;
     uint8_t duressMask;
-    uint8_t reserved[5];
+    uint8_t cardAuthMode;
-} BS2SmartCardHeader;
+    uint8_t useAlphanumericID;
+    uint8_t cardAuthModeEx;
+    uint8_t numOfFaceTemplate;
+    uint8_t reserved[1];
+} BS2SmartCardHeader;
 </code>
 **1. //hdrCRC//** \\
-card header 체크섬 값입니다. \\ \\
+card header 체크섬 값입니다. (cardCRC - reserved)  \\ \\
 **2. //cardCRC//** \\
-card data 체크섬 값입니다. \\ \\
+card data 체크섬 값입니다. (BS2SmartCardHeader.cardType - BS2SmartCardData.accessOnData) \\ \\
 **3. //cardType//** \\
 카드 유형의 코드 값입니다. \\
@@ 줄 79: / 줄 86: @@
 **4. //numOfTemplate//** \\
-지문 템플릿의 개수입니다. \\ \\
+지문 템플릿의 개수입니다. \\
+<WRAP important>AOC 카드 구조상 template은 [[smartcard_api#BS2SmartCardCredentials]]에 저장됩니다. \\
+그리고 이곳에는 지문 또는 얼굴이 선택적으로 저장되어집니다. 지문과 얼굴이 함께 저장되어지지 않습니다. \\
+따라서 AOC 카드에 지문 template을 담고자 한다면, numOfFacetemplate은 반드시 0으로 설정 되어야 합니다.
+</WRAP>
 **5. //templateSize//** \\
 지문 템플릿의 크기입니다. 일반적인 지문 템플릿의 크기는 384 바이트로 고정되어 있습니다. \\
@@ 줄 88: / 줄 100: @@
 **7. //duressMask//** \\
 협박 지문 유무 마스크 값입니다. \\
+**8. //cardAuthMode//** \\
+''IR Face 기반'' 카드 인증 모드 설정값입니다. \\
+''Visual Face 기반'' **cardAuthModeEx**를 사용합니다. \\
+<WRAP group 50%>
+^값  ^설명  ^
+|2 |카드 인증만 사용   |
+|3 |카드와 지문 인증 사용   |
+|4 |카드와 PIN 인증 사용  |
+|5 |카드 인증 후 지문이나 PIN 인증 사용   |
+|6 |카드, 지문, PIN 인증 사용   |
+|254 |사용할 수 없음  |
+|255 |정의되지 않음(시스템에 정의된 모드로 동작)  |
+</WRAP>
+**9. //useAlphanumericID//** \\
+Alphanumeric ID를 사용할지 결정하는 flag입니다. \\
+**10. //cardAuthModeEx//** \\
+''IR Face 기반'' **cardAuthMode**를 사용합니다. \\
+[+ V2.7.1] ''Visual Face 기반'' 카드 인증 모드 설정값입니다. \\
+<WRAP group 60%>
+^값  ^1단계 인증  ^2단계 인증  ^3단계 인증  ^
+|21  |카드  |      |   |
+|22  |카드  |얼굴  |   |
+|23  |카드  |지문  |   |
+|24  |카드  |PIN  |   |
+|25  |카드  |얼굴 또는 지문  |   |
+|26  |카드  |얼굴 또는 PIN  |   |
+|27  |카드  |지문 또는 PIN  |   |
+|28  |카드  |얼굴 또는 지문 또는 PIN  |   |
+|29  |카드  |얼굴  |지문  |
+|30  |카드  |얼굴  |PIN  |
+|31  |카드  |지문  |얼굴  |
+|32  |카드  |지문  |PIN  |
+|33  |카드  |얼굴 또는 지문  |PIN  |
+|34  |카드  |얼굴  |지문 또는 PIN  |
+|35  |카드  |지문  |얼굴 또는 PIN  |
+|254 |사용할 수 없음  |  |  |
+|255 |정의되지 않음(시스템 정의 모드)  |  |  |
+</WRAP>
+**11. //numOfFaceTemplate//** \\
+얼굴 템플릿 수를 나타냅니다. \\
+지문과 얼굴이 갖는 기본적인 template의 크기가 다르지만 (지문:384, 얼굴:552) \\
+이경우에도 변함없이 [[smartcard_api#BS2SmartCardCredentials]]의 templateData의 전체크기를 고려하여 저장하시면 됩니다. \\
+<WRAP important>AOC 카드 구조상 template은 [[smartcard_api#BS2SmartCardCredentials]]에 저장됩니다. \\
+그리고 이곳에는 지문 또는 얼굴이 선택적으로 저장되어집니다. 지문과 얼굴이 함께 저장되어지지 않습니다. \\
+따라서 AOC 카드에 얼굴 template을 담고자 한다면, numOfTemplate은 반드시 0으로 설정 되어야 합니다.
+</WRAP>
+**12. //reserved//** \\
+예약된 공간입니다. \\
 ==== BS2SmartCardCredentials ====
@@ 줄 128: / 줄 189: @@
 SmartCard 헤더입니다. \\ \\
 **2. //cardID//** \\
-단말기에서 사용할 카드 식별자입니다. Access on Card의 경우 배열의 32 byte를 Card ID로
+단말기에서 사용할 카드 식별자입니다. \\
- 사용하고, Secure Credential card는 배열의 24 byte를 Card ID로 사용하게 됩니다. \\ \\
+Access on Card의 경우 배열의 32 byte를 Card ID로 사용하고, \\
+Secure Credential card는 배열의 24 byte를 Card ID로 사용하게 됩니다. \\
+Secure Credential Card(SCC)의 경우, 32 byte는 Card ID(24 bytes), issueCount(4 byte) 그리고 Time Stamp(4 byte)로 채워져야 합니다. \\
+또한, BS2UserBlob 구조체의 cardObjs array가 SC Card로 채워야 하며, SC Card 발급시마다 cardObjs 업데이트 되어야 합니다. \\ \\
 **3. //credentials//** \\
 pin code나 지문 템플릿이 저장되어 있는 인증 데이터 영역입니다. \\ \\