차이

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

--- ko:configuration_api [2022/08/24 19:21]
kkshin [Configuration API]
+++ ko:configuration_api [2022/08/24 19:56]
kkshin [BS2SystemConfig]
@@ 줄 70: / 줄 70: @@
   * [[BS2_GetDesFireCardConfigEx]]: [+ 2.6.4] DesFire 카드 고급설정 정보를 가져옵니다.
   * [[BS2_SetDesFireCardConfigEx]]: [+ 2.6.4] DesFire 카드 고급설정 정보를 저장합니다.
-  * [[BS2_GetAuthConfigExt]]: [+ 2.7.1] ''FaceStation F2'' 인증 설정 정보를 가져옵니다.
+  * [[BS2_GetAuthConfigExt]]: [+ 2.7.1] ''FSF2'' 인증 설정 정보를 가져옵니다.
-  * [[BS2_SetAuthConfigExt]]: [+ 2.7.1] ''FaceStation F2'' 인증 설정 정보를 저장합니다.
+  * [[BS2_SetAuthConfigExt]]: [+ 2.7.1] ''FSF2'' 인증 설정 정보를 저장합니다.
-  * [[BS2_GetFaceConfigExt]]: [+ 2.7.1] ''FaceStation F2, FaceStation2'' 열화상 감지와 마스크 착용 체크를 위한 설정 정보를 가져옵니다.
+  * [[BS2_GetFaceConfigExt]]: [+ 2.7.1] ''FSF2, FS2'' 열화상 감지와 마스크 착용 체크를 위한 설정 정보를 가져옵니다.
-  * [[BS2_SetFaceConfigExt]]: [+ 2.7.1] ''FaceStation F2, FaceStation2'' 열화상 감지와 마스크 착용 체크를 위한 설정 정보를 저장합니다.
+  * [[BS2_SetFaceConfigExt]]: [+ 2.7.1] ''FSF2, FS2'' 열화상 감지와 마스크 착용 체크를 위한 설정 정보를 저장합니다.
-  * [[BS2_GetThermalCameraConfig]]: [+ 2.7.1] ''FaceStation F2, FaceStation2'' 열화상 카메라 설정을 가져옵니다.
+  * [[BS2_GetThermalCameraConfig]]: [+ 2.7.1] ''FSF2, FS2'' 열화상 카메라 설정을 가져옵니다.
-  * [[BS2_SetThermalCameraConfig]]: [+ 2.7.1] ''FaceStation F2, FaceStation2'' 열화상 카메라 설정을 저장합니다.
+  * [[BS2_SetThermalCameraConfig]]: [+ 2.7.1] ''FSF2, FS2'' 열화상 카메라 설정을 저장합니다.
-  * [[BS2_GetBarcodeConfig]]: [+ 2.8] ''X-Station 2'' Barcode 관련 설정을 가져옵니다.
+  * [[BS2_GetBarcodeConfig]]: [+ 2.8] ''XS2'' Barcode 관련 설정을 가져옵니다.
-  * [[BS2_SetBarcodeConfig]]: [+ 2.8] ''X-Station 2'' Barcode 관련 설정을 저장합니다.
+  * [[BS2_SetBarcodeConfig]]: [+ 2.8] ''XS2'' Barcode 관련 설정을 저장합니다.
   * [[BS2_GetInputConfigEx]]: [+ 2.8.1] ''IM-120'' Input 관련 확장형 설정을 가져옵니다.
   * [[BS2_SetInputConfigEx]]: [+ 2.8.1] ''IM-120'' Input 관련 확장형 설정을 저장합니다.
@@ 줄 193: / 줄 193: @@
 예약된 공간입니다. \\ \\
 . //useCardOperationMask// \\
-[+ V2.6.4] 모든 카드를 읽지 않고, 사용자 선택에 의해 카드 타입별로 읽을 수 있도록 옵션을 제공합니다. \\
+[+ 2.6.4] 모든 카드를 읽지 않고, 사용자 선택에 의해 카드 타입별로 읽을 수 있도록 옵션을 제공합니다. \\
 MASK값은 조합을 통하여 중복 설정이 가능며, 사용자는 이 옵션을 통하여 카드 타입의 읽기를 추가 또는 제거할 수 있습니다. \\
 단, 장치가 지원할 수 있는 카드 타입에 한하며, 장치가 지원하지 않는 카드 읽기를 추가하는 경우 해당 설정은 무시됩니다. \\
 또한, 지원하고자하는 카드 타입의 마스크는 ''CARD_OPERATION_USE''와 조합해야 합니다.\\
 예를들어 EM카드만 읽을 수 있도록 설정하고자 한다면 useCardOperationMask에는 ''0x80000001''로 설정되어져야 합니다.
-<WRAP group 50%>
+<WRAP group 60%>
 ^값  ^설명  ^
 |0xFFFFFFFF  |CARD_OPERATION_MASK_DEFAULT  |
 |0x80000000  |CARD_OPERATION_USE  |
-|0x00000200  |CARD_OPERATION_MASK_BLE  |
+|0x00000000  |CARD_OPERATION_MASK_NONE  |
-|0x00000100  |CARD_OPERATION_MASK_NFC  |
+|0x00000001  |CARD_OPERATION_MASK_LF_EM  |
-|0x00000080  |CARD_OPERATION_MASK_SEOS  |
+|0x00000002  |CARD_OPERATION_MASK_LF_PROX  |
-|0x00000040  |CARD_OPERATION_MASK_SR_SE  |
+|0x00000004  |CARD_OPERATION_MASK_HF_CSN_MIFARE  |
-|0x00000020  |CARD_OPERATION_MASK_DESFIRE_EV1  |
+|0x00000008  |CARD_OPERATION_MASK_HF_CSN_ICLASS  |
-|0x00000010  |CARD_OPERATION_MASK_CLASSIC_PLUS  |
+|0x00000010  |CARD_OPERATION_MASK_HF_SMART_MIFARE  |
-|0x00000008  |CARD_OPERATION_MASK_ICLASS  |
+|0x00000020  |CARD_OPERATION_MASK_HF_SMART_MIFARE_DESFIRE  |
-|0x00000004  |CARD_OPERATION_MASK_MIFARE_FELICA  |
+|0x00000040  |CARD_OPERATION_MASK_HF_SMART_ICLASS  |
-|0x00000002  |CARD_OPERATION_MASK_HIDPROX  |
+|0x00000080  |CARD_OPERATION_MASK_HF_SMART_ICLASS_SEOS  |
-|0x00000001  |CARD_OPERATION_MASK_EM  |
+|0x00000100  |CARD_OPERATION_MASK_MOBILE_NFC  |
+|0x00000200  |CARD_OPERATION_MASK_MOBILE_BLE  |
+|0x00000400  |CARD_OPERATION_MASK_HF_CSN_OTHERS  |
 </WRAP>
 . //reserved2// \\
@@ 줄 1679: / 줄 1681: @@
     uint8_t       maxRotation;
+    // Deprecated
     struct {
         uint16_t  min;
@@ 줄 1684: / 줄 1687: @@
     } faceWidth;
+    // Deprecated
     struct {
         uint16_t  x;
@@ 줄 1689: / 줄 1693: @@
     } searchRange;
-    uint8_t       reserved2[18];
+    struct {
+        uint8_t min;		// 30 ~ 100
+        uint8_t max;		// 40 ~ 100, 255
+    } detectDistance;		////< 2 bytes
+    BS2_BOOL wideSearch;	///< 1 byte
+    uint8_t unused;
+    uint8_t reserved[14];	///< 14 bytes (reserved)
 } BS2FaceConfig;
 </code>
@@ 줄 1707: / 줄 1719: @@
 |1  |옥외  |
 |2  |자동  |
-|3  |[+V2.8] 사용 안함 ''(FaceStation F2)''  |
+|3  |[+ 2.8] 사용 안함 ''(FaceStation F2)''  |
 </WRAP>
 . //enrollThreshold// \\
@@ 줄 1749: / 줄 1761: @@
 </WRAP>
 . //lfdLevel// \\
-[+ V2.6.3] 위조된 얼굴을 여과할 수 있는 민감도를 설정할 수 있습니다. \\
+[+ 2.6.3] 위조된 얼굴을 여과할 수 있는 민감도를 설정할 수 있습니다. \\
 ''FaceStation2, FaceLite'' : 기본값은 0입니다. \\
-''FaceStation F2'' : [+ V2.7.1] 기본값이 1입니다. \\
+''FaceStation F2'' : [+ 2.7.1] 기본값이 1입니다. \\
 <WRAP group 50%>
 ^값  ^설명  ^
@@ 줄 1760: / 줄 1772: @@
 </WRAP>
 . //quickEnrollment// \\
-[+ V2.6.3] 빠른 얼굴 등록 사용 여부를 설정할 수 있습니다. \\
+[+ 2.6.3] 빠른 얼굴 등록 사용 여부를 설정할 수 있습니다. \\
 이 값을 true로 설정하면 얼굴 등록 절차가 1단계로 설정되며, false로 설정할 경우 3단계로 설정됩니다. \\
 고품질의 얼굴 템플릿을 등록하려면 false를 설정하십시오. \\ \\
 . //previewOption// \\
-[+ V2.6.3] IR 인증 가이드를 의미하며, 얼굴 인증 시 preview 화면 출력 설정을 변경할 수 있습니다. \\
+[+ 2.6.3] IR 인증 가이드를 의미하며, 얼굴 인증 시 preview 화면 출력 설정을 변경할 수 있습니다. \\
 ''FaceLite''에서만 사용됩니다. \\
 <WRAP group 50%>
@@ 줄 1773: / 줄 1785: @@
 </WRAP>
 . //checkDuplicate// \\
-[+ V2.6.4] true로 설정하면 중복된 얼굴 정보인지 판단합니다. \\ \\
+[+ 2.6.4] true로 설정하면 중복된 얼굴 정보인지 판단합니다. \\ \\
 . //operationMode// \\
-[+ V2.7.1] ''FaceStation F2'' 아래의 동작 모드를 설정하며, 기본값은 Fusion 모드입니다. \\
+[+ 2.7.1] ''FaceStation F2'' 아래의 동작 모드를 설정하며, 기본값은 Fusion 모드입니다. \\
 <WRAP group 50%>
 ^값  ^모드  ^설명  ^기본값  ^
@@ 줄 1783: / 줄 1795: @@
 </WRAP>
 . //maxRotation// \\
-[+ V2.7.1] ''FaceStation F2'' 얼굴 검출 시 보통은 정면 일 것입니다. \\
+[+ 2.7.1] ''FaceStation F2'' 얼굴 검출 시 보통은 정면 일 것입니다. \\
 하지만 FSF2는 얼굴 검출 시 정면에서 몇도 정도 회전된(외곡된) 이미지인지 판단이 가능합니다. \\
 이를 통해 일정 각도 이상 회전된 이미지의 경우 검출 실패 처리를 시킬 수 있습니다. \\
 maxRotation은 이경우의 최대 허용치를 나타내며, 기본값은 15도 입니다. \\ \\
 . //faceWidth// \\
-[+ V2.7.1] ''FaceStation F2'' 얼굴 이미지의 폭을 나타내며, 폭의 최소값, 최대값을 지정할 수 있습니다. \\
+[+ 2.7.1] ''FaceStation F2'' 얼굴 이미지의 폭을 나타내며, 폭의 최소값, 최대값을 지정할 수 있습니다. \\
 최소값, 최대값은 아래의 값을 기본값으로 갖습니다. \\
+[+ 2.8.3] ''BioStation 3'' 해당 설정은 무시됩니다. \\
 <WRAP group 20%>
-^  ^기본값  ^
+^  ^기본값(min)  ^기본값(max)  ^
-|min  |66  |
+|FSF2  |66  |250  |
-|max  |250  |
+|BS3  |-  |-  |
 </WRAP>
 . //searchRange// \\
-[+ V2.7.1] ''FaceStation F2'' 얼굴 검색 범위를 나타내며, 범위의 x값(가로 좌표)과 x값 지점으로부터의 폭을 지정할 수 있습니다. \\
+[+ 2.7.1] ''FaceStation F2'' 얼굴 검색 범위를 나타내며, 범위의 x값(가로 좌표)과 x값 지점으로부터의 폭을 지정할 수 있습니다. \\
 x값과 폭은 아래의 값을 기본값으로 갖습니다. \\
+[+ 2.8.3] ''BioStation 3'' 해당 설정은 무시됩니다. \\
 <WRAP group 20%>
-^  ^기본값  ^
+^  ^기본값(x)  ^기본값(width)  ^
-|x  |144  |
+|FSF2  |144  |432  |
-|width  |432  |
+|BS3  |-  |-  |
 </WRAP>
-. //reserved2// \\
+. //detectDistance// \\
+[+ 2.8.3] ''BioStation 3'' 얼굴 감지 거리의 최소값과 최대값을 설정합니다. \\
+픽셀 단위로 얼굴 위치를 지정하는 faceWidth는 사용하기 난해하므로 더 이상 사용하지 않습니다. \\
+대신 피사체(얼굴)의 감지 거리를 얼마로 할지 만 정합니다. 거리는 cm로 설정하며, 10의 배수로 입력하여야 합니다. \\
+<WRAP group 80%>
+^  ^최소 감지거리의 최소값  ^최소 감지거리의 최대값  ^최소 감지거리(기본값)  ^최대 감지거리의 최소값  ^최대 감지거리의 최대값  ^최대 감지거리(무제한)  ^최대 감지거리(기본값)  ^
+|BS3  |30  |100  |60  |40  |100  |255  |100  |
+</WRAP>
+. //wideSearch// \\
+[+ 2.8.3] ''BioStation 3'' 얼굴 감지 범위를 넓힙니다. \\
+x좌표와 width를 지정해야하는 난해한 설정인 searchRange는 더 이상 사용하지 않습니다. \\
+대신 얼굴 감지를 표준(false) 설정으로 할지, 광역(true)으로 할지 여부만 지정합니다. \\
+광역으로 감지하는 범위에 대한 세부 설정은 장치 내부 설정 값을 따릅니다. 사용자는 이 값을 변경할 수 없습니다. \\ \\
+이 설정 값이 켜지면(true) 카메라를 통해 넓은 범위의 피사체를 찾아내므로, 피사체가 여럿이 되는 경우 의도치 않은 인증으로 연결될 수 있습니다. \\
+기본 설정 값은 false입니다. \\ \\
+. //unused// \\
+예약된 공간입니다.\\ \\
+. //reserved// \\
 예약된 공간입니다.\\ \\