차이

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

--- ko:smartcard_api [2020/08/21 13:09]
kkshin [BS2SmartCardHeader]
+++ ko:smartcard_api [2026/03/11 15:51] (현재)
@@ 줄 7: / 줄 7: @@
   * [[BS2_WriteCard]]: SmartCard에 데이터를 저장합니다.
   * [[BS2_EraseCard]]: SmartCard를 포맷합니다.
+  * [[BS2_GetLockOverride]]: [+ 2.9.12] 특정 조건에 해당하는 장치의 Lock Override 정보를 가져옵니다.
+  * [[BS2_GetAllLockOverride]]: [+ 2.9.12] 장치의 모든 Lock Override 정보를 가져옵니다.
+  * [[BS2_SetLockOverride]]: [+ 2.9.12] 장치에 Lock Override 정보를 설정합니다.
+  * [[BS2_RemoveLockOverride]]: [+ 2.9.12] 특정 조건에 해당하는 장치의 Lock Override 정보를 삭제합니다.
+  * [[BS2_RemoveAllLockOverride]]: [+ 2.9.12] 장치의 모든 Lock Override 정보를 삭제합니다.
 ===== 구조체 ======
 ==== BS2CSNCard ====
@@ 줄 21: / 줄 26: @@
 <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 카드  |
@@ 줄 45: / 줄 51: @@
 **2. //size//** \\
-카드 템플릿의 크기입니다. \\ \\
+데이터 버퍼 사이즈 크기입니다. \\ \\
 **3. //data//** \\
 카드 템플릿 데이터입니다. \\
@@ 줄 83: / 줄 89: @@
 **4. //numOfTemplate//** \\
-지문 템플릿의 개수입니다. \\ \\
+지문 템플릿의 개수입니다. \\
+<WRAP important>AOC 카드 구조상 template은 [[smartcard_api#BS2SmartCardCredentials]]에 저장됩니다. \\
+그리고 이곳에는 지문 또는 얼굴이 선택적으로 저장되어집니다. 지문과 얼굴이 함께 저장되어지지 않습니다. \\
+따라서 AOC 카드에 지문 template을 담고자 한다면, numOfFacetemplate은 반드시 0으로 설정 되어야 합니다.
+</WRAP>
 **5. //templateSize//** \\
 지문 템플릿의 크기입니다. 일반적인 지문 템플릿의 크기는 384 바이트로 고정되어 있습니다. \\
@@ 줄 93: / 줄 104: @@
 협박 지문 유무 마스크 값입니다. \\
 **8. //cardAuthMode//** \\
-''FaceStation F2 이외'' 카드 인증 모드 설정값입니다. \\
+''IR Face 기반'' 카드 인증 모드 설정값입니다. \\
-''FaceStation F2'' **cardAuthModeEx**를 사용합니다. \\
+''Visual Face 기반'' **cardAuthModeEx**를 사용합니다. \\
 <WRAP group 50%>
 ^값  ^설명  ^
@@ 줄 108: / 줄 119: @@
 Alphanumeric ID를 사용할지 결정하는 flag입니다. \\
 **10. //cardAuthModeEx//** \\
-''FaceStation F2 이외'' **cardAuthMode를 사용합니다. \\
+''IR Face 기반'' **cardAuthMode**를 사용합니다. \\
-[+ V2.7.1] ''FaceStation F2'' 카드 인증 모드 설정값입니다. \\
+[+ V2.7.1] ''Visual Face 기반'' 카드 인증 모드 설정값입니다. \\
-<WRAP group 50%>
+<WRAP group 60%>
 ^값  ^1단계 인증  ^2단계 인증  ^3단계 인증  ^
 |21  |카드  |      |   |
@@ 줄 133: / 줄 144: @@
 얼굴 템플릿 수를 나타냅니다. \\
 지문과 얼굴이 갖는 기본적인 template의 크기가 다르지만 (지문:384, 얼굴:552) \\
-이경우에도 변함없이 BS2SmartCardCredentials의 templateData의 전체크기를 고려하여 저장하시면 됩니다. \\
+이경우에도 변함없이 [[smartcard_api#BS2SmartCardCredentials]]의 templateData의 전체크기를 고려하여 저장하시면 됩니다. \\
+<WRAP important>AOC 카드 구조상 template은 [[smartcard_api#BS2SmartCardCredentials]]에 저장됩니다. \\
+그리고 이곳에는 지문 또는 얼굴이 선택적으로 저장되어집니다. 지문과 얼굴이 함께 저장되어지지 않습니다. \\
+따라서 AOC 카드에 얼굴 template을 담고자 한다면, numOfTemplate은 반드시 0으로 설정 되어야 합니다.
+</WRAP>
 **12. //reserved//** \\
 예약된 공간입니다. \\
@@ 줄 202: / 줄 218: @@
 **3. //smartCard//** \\
 SmartCard 데이터\\
+==== BS2LockOverride ====
+<code cpp>
+typedef struct {
+    uint8_t cardID[BS2_CARD_DATA_SIZE];		///< 32 bytes
+    uint16_t issueCount;			///< 2 bytes
+    BS2_CARD_TYPE type;				///< 1 byte
+    uint8_t	size;				///< 1 byte
+    BS2_USER_ID userID;				///< 32 bytes
+    uint8_t reserved[4];			///< 4 bytes
+} BS2LockOverride;
+</code>
+**1. //cardID//** \\
+byte의 카드ID 입니다. \\ \\
+**2. //issueCount//** \\
+스마트 카드의 발급 회차입니다. \\ \\
+**3. //type//** \\
+카드 유형을 나타내는 코드 값입니다. 현재 Lock Override 기능을 지원하는 카드 유형은 다음과 같습니다. \\
+<WRAP group 100%>
+^값      ^설명     ^사용된 형식   ^
+|0x01 |CSN 카드    |  |
+|0x02 |Secure 카드    |  |
+</WRAP>
+**4. //size//** \\
+카드 ID의 크기를 나타내며, 32의 값을 갖습니다. \\ \\
+**5. //userID//** \\
+할당하고자 하는 카드가 이미 특정 사용자에게 할당된 상태라면, 해당 사용자의 ID를 설정할 수 있습니다. \\ \\