Differences

This shows you the differences between two versions of the page.

--- en:configuration_api [2020/02/19 14:37]
yjjung [BS2FaceConfig]
+++ en:configuration_api [2020/08/28 13:16]
yjjung [BS2FaceConfig]
@@ Line 70: / Line 70: @@
   * [[BS2_GetDesFireCardConfigEx]]: [+ V2.6.4] Retrieves DesFire advanced configuration from the device.
   * [[BS2_SetDesFireCardConfigEx]]: [+ V2.6.4] Sets DesFire advanced configuration in the device.
+  * [[BS2_GetAuthConfigExt]]: ''FaceStation F2'' Retrieves authentication settings from the device. [+ V2.7.1]
+  * [[BS2_SetAuthConfigExt]]: ''FaceStation F2'' Stores authentication settings from the device. [+ V2.7.1]
+  * [[BS2_GetFaceConfigExt]]: ''FaceStation F2, FaceStation2'' Retrieves configuration of thermal camera and mask detection. [+ V2.7.1]
+  * [[BS2_SetFaceConfigExt]]: ''FaceStation F2, FaceStation2'' Stores configuration of thermal camera and mask detection. [+ V2.7.1]
+  * [[BS2_GetThermalCameraConfig]]: ''FaceStation F2, FaceStation2'' Retrieves configuration of thermal camera. [+ V2.7.1]
+  * [[BS2_SetThermalCameraConfig]]: ''FaceStation F2, FaceStation2'' Stores configuration of thermal camera. [+ V2.7.1]
 \\
 ===== Structure =====
@@ Line 123: / Line 130: @@
 ==== BS2SystemConfig ====
-[[BS2_SetSystemConfig]] must be called after calling [[BS2_GetSystemConfig]] and completing necessary settings except for tamperOn.  \\
 <code cpp>
 typedef struct {
@@ Line 153: / Line 159: @@
 Reserved variable. \\ \\
 **5. //deviceLocked//** \\
-Decides whether to show lock screen in stand-by mode. \\ \\
+Indicates the current locked state of the device. (Read only filed) \\ \\
 **6. //useInterphone//** \\
 Decides whether to use intercom. \\ \\
@@ Line 365: / Line 371: @@
     uint8_t timeFormat;
     uint8_t homeFormation;
-    uint8_t useUserPhrase;
+    BS2_BOOL useUserPhrase;
-    uint8_t reserved[1];
+    BS2_BOOL queryUserPhrase;
     uint8_t shortcutHome[BS2_MAX_SHORTCUT_HOME];
     uint8_t tnaIcon[16];
@@ Line 438: / Line 444: @@
 **13. //useUserPhrase//** \\
 Flag that determines whether to use the user phrase feature. \\ \\
-**14. //shortcutHome//** \\
+**13. //queryUserPhrase//** \\
-Home screen layout(Currently, not used). \\ \\
+If set true, asks for the user phrase to the server. \\ \\
-**15. //tnaIcon//** \\
+**15. //shortcutHome//** \\
+Home screen layout(Going to apply later, not used currently). \\ \\
+**16. //tnaIcon//** \\
 Icon displayed on the device corresponding to the job code. \\ \\
-**16. //reserved1//** \\
+**17. //reserved1//** \\
 Reserved space. \\
@@ Line 1342: / Line 1350: @@
 |11|Led action|
 |12|Fire alarm input|
+|13|Auth Success(Access granted)|
+|14|Auth Fail(Access denied)|
+|15|Lift action|
 </WRAP>
 . //stopFlag// \\
@@ Line 1572: / Line 1583: @@
     uint8_t       previewOption;
     bool          checkDuplicate;
-    uint8_t       reserved[2];
+    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>
@@ Line 1594: / Line 1616: @@
 </WRAP>
 **3. //enrollThreshold//** \\
-Threshold of face enrollment.\\
+Threshold of face enrollment. It determines how much movement of pose is allowed when enrolling the face.  \\
 <WRAP group 50%>
 ^Value  ^Description  ^
-|0  |THRESHOLD_0  |
+|0  |THRESHOLD_0 (Most strict) |
 |1  |THRESHOLD_1 |
 |2  |THRESHOLD_2  |
@@ Line 1606: / Line 1628: @@
 |7  |THRESHOLD_7  |
 |8  |THRESHOLD_8  |
-|9  |THRESHOLD_9  |
+|9  |THRESHOLD_9 (Least strict) |
 </WRAP>
 **4. //detectSensitivity//** \\
@@ Line 1618: / Line 1640: @@
 </WRAP>
 **5. //enrollTimeout//** \\
-Timeout period of face scanning which is 60 seconds by default.\\ \\
+''FaceStation2, FaceLite'' : Timeout period of face scanning which is 60 seconds by default.\\ \\
+<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>
 **6. //lfdLevel//** \\
 [+ V2.6.3] Configuration for the LFD(Live Face Detection - fake face detection) sensitivity. \\
+''FaceStation2, FaceLite'' : 기본값은 0입니다. \\
+''FaceStation F2'' : [+ V2.7.1] 기본값이 1입니다. \\
 <WRAP group 50%>
 ^Value  ^Description  ^
@@ Line 1635: / Line 1674: @@
 **8. //previewOption//** \\
 [+ V2.6.3] IR camera preview option when you authenticate with face. \\
+Only used to ''FaceLite''. \\
 <WRAP group 50%>
 ^Value  ^Description  ^
@@ Line 1643: / Line 1683: @@
 **9. //checkDuplicate//** \\
 [+ V2.6.4] Check whether the scanned face is duplicated in the device. \\ \\
-**10. //reserved//** \\
-Reserved space. \\ \\
+**10. //operationMode//** \\
-**11. //reserved2//** \\
+[+ V2.7.1] ''FaceStation F2'' Configures operation mode with below values, default is Fusion mode. \\
-Reserved space. \\ \\
+<WRAP group 50%>
+^Value  ^Mode  ^Description  ^Default  ^
+|0  |Fusion Mode |Visual matching + IR matching |Default |
+|1  |Visual Mode |Visual matching | |
+|2  |Visual + IR |Visual matching, IR detects only face| |
+</WRAP>
+**11. //maxRotation//** \\
+[+ V2.7.1] ''FaceStation F2'' When face is recognized normally it's front side. \\
+Still, it is possible to determine how many degrees the image has been rotated from the front when FSF2 detects a face. \\
+This enables detection failure in the case of images rotated over a certain angle. \\
+maxRotation represents the maximum allowable value in this case, and the default value is 15 degrees. \\ \\
+**12. //faceWidth//** \\
+[+ V2.7.1] ''FaceStation F2'' This indicates the width of the face image, and you can specify the minimum and maximum values. \\
+The minimum and maximum values default to 66 and 250. \\ \\
+**13. //searchRange//** \\
+[+ V2.7.1] ''FaceStation F2'' Represents the face search range, and you can specify the x value (horizontal coordinate) of the range and the width from the x value point. \\
+The default values for x value and width are 144 and 432. \\ \\
+. //reserved2// \\
+Reserved space.\\ \\
 ==== BS2Rs485ConfigEX ====
 <code cpp>