차이

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

--- ko:configuration_api [2020/02/14 13:47]
kkshin [BS2SystemConfig]
+++ ko:configuration_api [2020/08/20 21:50]
kkshin [BS2FaceConfig]
@@ 줄 68: / 줄 68: @@
   * [[BS2_GetIPV6ConfigViaUDPEx]]: [+ 2.6.3] IP V6 설정 정보를 UDP broadcasting를 통해 가져옵니다. (host ip 지정)
   * [[BS2_SetIPV6ConfigViaUDPEx]]: [+ 2.6.3] IP V6 설정 정보를 UDP broadcasting를 통해 저장합니다. (host ip 지정)
-  * [[BS2_GetDesFireConfigEx]]: [+ 2.6.4] DesFire 카드 설정 정보를 가져옵니다.
+  * [[BS2_GetDesFireCardConfigEx]]: [+ 2.6.4] DesFire 카드 고급설정 정보를 가져옵니다.
-  * [[BS2_SetDesFireConfigEx]]: [+ 2.6.4] DesFire 카드 설정 정보를 저장합니다.
+  * [[BS2_SetDesFireCardConfigEx]]: [+ 2.6.4] DesFire 카드 고급설정 정보를 저장합니다.
 ===== 구조체 =====
 ==== BS2FactoryConfig ====
@@ 줄 150: / 줄 150: @@
 예약된 변수입니다. \\ \\
 . //deviceLocked// \\
-대기 모드에서 잠금화면을 보여줄지 결정하는 flag입니다. \\ \\
+장치의 현재 잠김상태를 나타내는 필드입니다. (읽기전용 필드) \\ \\
 . //useInterphone// \\
 인터폰을 사용할지 결정하는 flag입니다. \\ \\
@@ 줄 179: / 줄 179: @@
 MASK값은 조합을 통하여 중복 설정이 가능며, 사용자는 이 옵션을 통하여 카드 타입의 읽기를 추가 또는 제거할 수 있습니다. \\
 단, 장치가 지원할 수 있는 카드 타입에 한하며, 장치가 지원하지 않는 카드 읽기를 추가하는 경우 해당 설정은 무시됩니다. \\
+또한, 지원하고자하는 카드 타입의 마스크는 ''CARD_OPERATION_USE''와 조합해야 합니다.\\
+예를들어 EM카드만 읽을 수 있도록 설정하고자 한다면 useCardOperationMask에는 ''0x80000001''로 설정되어져야 합니다.
 <WRAP group 50%>
 ^값  ^설명  ^
@@ 줄 356: / 줄 358: @@
     uint8_t homeFormation;
     BS2_BOOL useUserPhrase;
-    uint8_t reserved[1];
+    BS2_BOOL queryUserPhrase;
     uint8_t shortcutHome[BS2_MAX_SHORTCUT_HOME];
     uint8_t tnaIcon[16];
@@ 줄 428: / 줄 430: @@
 . //useUserPhrase// \\
 인증시 개인메시지 표시 여부입니다. \\ \\
-. //reserved// \\
+. //queryUserPhrase// \\
-예약된 공간입니다. \\ \\
+true로 설정 시, 개인인증 메시지를 서버에 묻습니다. \\ \\
 . //shortcutHome// \\
 homeFormation과 관련된 변수로 추후 적용 예정입니다. \\ \\
@@ 줄 686: / 줄 688: @@
 <code cpp>
 typedef struct {
-    uint8_t securityLevel;
+    uint8_t      securityLevel;
-    uint8_t fastMode;
+    uint8_t      fastMode;
-    uint8_t sensitivity;
+    uint8_t      sensitivity;
-    uint8_t sensorMode;
+    uint8_t      sensorMode;
-    uint16_t templateFormat;
+    uint16_t     templateFormat;
-    uint16_t scanTimeout;
+    uint16_t     scanTimeout;
-    uint8_t successiveScan;
+    uint8_t      successiveScan;
-    uint8_t advancedEnrollment;
+    uint8_t      advancedEnrollment;
-    uint8_t showImage;
+    uint8_t      showImage;
-    uint8_t lfdLevel;
+    uint8_t      lfdLevel;
+    bool         checkDuplicate;
-    uint8_t reserved3[32];
+    uint8_t      reserved3[31];
 } BS2FingerprintConfig;
 </code>
@@ 줄 757: / 줄 760: @@
 |3  |민감도 높음  |
 </WRAP>
-. //reserved3// \\
+. //checkDuplicate// \\
+[+ V2.6.4] true로 설정하면 중복된 지문인지 판단합니다. \\ \\
+. //reserved3// \\
 예약된 공간입니다. \\
 ==== BS2Rs485Config ====
 <code cpp>
@@ 줄 1327: / 줄 1331: @@
 |11|Led action|
 |12|Fire alarm input|
+|13|Auth Success(Access granted)|
+|14|Auth Fail(Access denied)|
+|15|Lift action|
 </WRAP>
 . //stopFlag// \\
@@ 줄 1541: / 줄 1548: @@
 예약된 공간입니다.\\ \\
-==== BS2FaceConfig====
+==== BS2FaceConfig ====
 <code cpp>
 typedef struct {
-	BS2_FACE_SECURITY_LEVEL       securityLevel;
+    uint8_t       securityLevel;
-	BS2_FACE_LIGHT_CONDITON       lightCondition;
+    uint8_t       lightCondition;
-	BS2_FACE_ENROLL_THRESHOLD     enrollThreshold;
+    uint8_t       enrollThreshold;
-	BS2_FACE_DETECT_SENSITIVITY   detectSensitivity;
+    uint8_t       detectSensitivity;
-	uint16_t                      enrollTimeout;
+    uint16_t      enrollTimeout;
-	BS2_FACE_LFD_LEVEL            lfdLevel;
+    uint8_t       lfdLevel;
-	bool                          quickEnrollment;
+    bool          quickEnrollment;
-	BS2_FACE_PREVIEW_OPTION       previewOption;
+    uint8_t       previewOption;
-	uint8_t                       reserved[3];
+    bool          checkDuplicate;
+    uint8_t       operationMode;
+    uint8_t       maxRotation;
-	uint8_t                       reserved2[26];
+    struct {
+        uint16_t  min;
+        uint16_t  max;
+    } faceWidth;
+    struct {
+        uint16_t  x;
+        uint16_t  width;
+    } searchRange;
+    uint8_t       reserved2[18];
 } BS2FaceConfig;
 </code>
@@ 줄 1576: / 줄 1595: @@
 </WRAP>
 . //enrollThreshold// \\
-얼굴 등록의 임계값입니다.\\
+얼굴 등록의 임계값입니다. 등록시 어느 정도 포즈 움직임을 허용하는지에 대한 값입니다. \\
 <WRAP group 50%>
 ^값  ^설명  ^
-|0  |THRESHOLD_0  |
+|0  |THRESHOLD_0  (엄격) |
 |1  |THRESHOLD_1 |
 |2  |THRESHOLD_2  |
@@ 줄 1588: / 줄 1607: @@
 |7  |THRESHOLD_7  |
 |8  |THRESHOLD_8  |
-|9  |THRESHOLD_9  |
+|9  |THRESHOLD_9  (느슨) |
 </WRAP>
 . //detectSensitivity// \\
@@ 줄 1600: / 줄 1619: @@
 </WRAP>
 . //enrollTimeout// \\
-얼굴 스캔 대기 시간으로 기본값은 60초입니다\\ \\
+''FaceStation2, FaceLite'' : 얼굴 스캔 대기 시간으로 기본값은 60초입니다. \\
+<WRAP group 60%>
+^값  ^설명  ^
+|BS2_FACE_ENROLL_TIMEOUT_MIN  |30  |
+|BS2_FACE_ENROLL_TIMEOUT_MAX  |60  |
+|BS2_FACE_ENROLL_TIMEOUT_DEFAULT  |BS2_FACE_ENROLL_TIMEOUT_MAX  |
+</WRAP>
+''FaceStation F2'' : [+ V2.7.1]  얼굴 스캔 대기 시간으로 기본값은 20초입니다. \\
+<WRAP group 70%>
+^값  ^설명  ^
+|BS2_FACE_EX_ENROLL_TIMEOUT_MIN  |10  |
+|BS2_FACE_EX_ENROLL_TIMEOUT_MAX  |20  |
+|BS2_FACE_EX_ENROLL_TIMEOUT_DEFAULT  |BS2_FACE_EX_ENROLL_TIMEOUT_MAX  |
+</WRAP>
 . //lfdLevel// \\
-[+ V2.6.4] 위조된 얼굴을 여과할 수 있는 민감도를 설정할 수 있습니다. \\
+[+ V2.6.3] 위조된 얼굴을 여과할 수 있는 민감도를 설정할 수 있습니다. \\
+''FaceStation2, FaceLite'' : 기본값은 0입니다. \\
+''FaceStation F2'' : [+ V2.7.1] 기본값이 1입니다. \\
 <WRAP group 50%>
 ^값  ^설명  ^
@@ 줄 1611: / 줄 1645: @@
 </WRAP>
 . //quickEnrollment// \\
-[+ V2.6.4] 빠른 얼굴 등록 사용 여부를 설정할 수 있습니다. \\
+[+ V2.6.3] 빠른 얼굴 등록 사용 여부를 설정할 수 있습니다. \\
 이 값을 true로 설정하면 얼굴 등록 절차가 1단계로 설정되며, false로 설정할 경우 3단계로 설정됩니다. \\
 고품질의 얼굴 템플릿을 등록하려면 false를 설정하십시오. \\ \\
 . //previewOption// \\
-[+ V2.6.4] IR 인증 가이드를 의미하며, 얼굴 인증 시 preview 화면 출력 설정을 변경할 수 있습니다. \\
+[+ V2.6.3] IR 인증 가이드를 의미하며, 얼굴 인증 시 preview 화면 출력 설정을 변경할 수 있습니다. \\
+''FaceLite''에서만 사용됩니다. \\
 <WRAP group 50%>
 ^값  ^설명  ^
@@ 줄 1622: / 줄 1657: @@
 |2  |인증 시도 전구간에 걸쳐 preview를 표시  |
 </WRAP>
-. //reserved// \\
+. //checkDuplicate// \\
-예약된 공간입니다.\\ \\
+[+ V2.6.4] true로 설정하면 중복된 얼굴 정보인지 판단합니다. \\ \\
-. //reserved2// \\
+. //operationMode// \\
+[+ V2.7.1] ''FaceStation F2'' 아래의 동작 모드를 설정하며, 기본값은 Fusion 모드입니다. \\
+<WRAP group 50%>
+^값  ^모드  ^설명  ^기본값  ^
+|0  |Fusion 모드 |Visual matching + IR matching |기본 |
+|1  |Visual 모드 |Visual matching | |
+|2  |Visual + IR검출 |Visual matching, IR은 얼굴 검출만| |
+</WRAP>
+. //maxRotation// \\
+[+ V2.7.1] ''FaceStation F2'' 얼굴 검출 시 보통은 정면 일 것입니다. \\
+하지만 FSF2는 얼굴 검출 시 정면에서 몇도 정도 회전된(외곡된) 이미지인지 판단이 가능합니다. \\
+이를 통해 일정 각도 이상 회전된 이미지의 경우 검출 실패 처리를 시킬 수 있습니다. \\
+maxRotation은 이경우의 최대 허용치를 나타내며, 기본값은 15도 입니다. \\ \\
+. //faceWidth// \\
+[+ V2.7.1] ''FaceStation F2'' 얼굴 이미지의 폭을 나타내며, 폭의 최소값, 최대값을 지정할 수 있습니다. \\
+최소값, 최대값은 각각 66과 250를 기본값으로 갖습니다. \\ \\
+. //searchRange// \\
+[+ V2.7.1] ''FaceStation F2'' 얼굴 검색 범위를 나타내며, 범위의 x값(가로 좌표)과 x값 지점으로부터의 폭을 지정할 수 있습니다. \\
+x값과 폭의 기본값은 각각 144, 432를 기본값으로 갖습니다. \\ \\
+. //reserved2// \\
 예약된 공간입니다.\\ \\