차이

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

--- ko:configuration_api [2020/08/20 21:55]
kkshin
+++ ko:configuration_api [2021/03/16 11:10]
yjjung [BS2FaceConfigExt]
@@ 줄 35: / 줄 35: @@
   * [[BS2_GetWiegandDeviceConfig]]: Wiegand 신호 설정 정보를 가져옵니다.
   * [[BS2_SetWiegandDeviceConfig]]: Wiegand 신호 설정 정보를 저장합니다.
-  * [[BS2_GetInputConfig]]: 입력 포트 설정 정보를 가져옵니다.
+  * [[BS2_GetInputConfig]]: Suprevised 입력 포트 설정 정보를 가져옵니다.
-  * [[BS2_SetInputConfig]]: 입력 포트 설정 정보를 저장합니다.
+  * [[BS2_SetInputConfig]]: Supervised 입력 포트 설정 정보를 저장합니다.
   * [[BS2_GetWlanConfig]]: 무선랜 설정 정보를 가져옵니다.
   * [[BS2_SetWlanConfig]]: 무선랜 설정 정보를 저장합니다.
@@ 줄 70: / 줄 70: @@
   * [[BS2_GetDesFireCardConfigEx]]: [+ 2.6.4] DesFire 카드 고급설정 정보를 가져옵니다.
   * [[BS2_SetDesFireCardConfigEx]]: [+ 2.6.4] DesFire 카드 고급설정 정보를 저장합니다.
+  * [[BS2_GetAuthConfigExt]]: [+ 2.7.1] ''FaceStation F2'' 인증 설정 정보를 가져옵니다.
+  * [[BS2_SetAuthConfigExt]]: [+ 2.7.1] ''FaceStation F2'' 인증 설정 정보를 저장합니다.
+  * [[BS2_GetFaceConfigExt]]: [+ 2.7.1] ''FaceStation F2, FaceStation2'' 열화상 감지와 마스크 착용 체크를 위한 설정 정보를 가져옵니다.
+  * [[BS2_SetFaceConfigExt]]: [+ 2.7.1] ''FaceStation F2, FaceStation2'' 열화상 감지와 마스크 착용 체크를 위한 설정 정보를 저장합니다.
+  * [[BS2_GetThermalCameraConfig]]: [+ 2.7.1] ''FaceStation F2, FaceStation2'' 열화상 카메라 설정을 가져옵니다.
+  * [[BS2_SetThermalCameraConfig]]: [+ 2.7.1] ''FaceStation F2, FaceStation2'' 열화상 카메라 설정을 저장합니다.
 ===== 구조체 =====
 ==== BS2FactoryConfig ====
@@ 줄 361: / 줄 368: @@
     uint8_t shortcutHome[BS2_MAX_SHORTCUT_HOME];
     uint8_t tnaIcon[16];
-    uint8_t reserved1[32];
+    uint8_t useScreenSaver;
+    uint8_t reserved1[31];
 } BS2DisplayConfig;
 </code>
@@ 줄 436: / 줄 444: @@
 . //tnaIcon// \\
 장치내에서 근태 코드값에 해당하는 아이콘을 보여줄 때 사용합니다. \\ \\
-. //reserved1// \\
+. //useScreenSaver// \\
+''FaceStation 2'', ''FaceStation F2'' true로 설정 시, 화면보호기가 활성화됩니다. \\ \\
+. //reserved1// \\
 예약된 공간입니다. \\
@@ 줄 794: / 줄 804: @@
 </WRAP>
 . //channelIndex// \\
-RS485 network의 통신 채널 번호입니다. \\ \\
+(사용자 설정 불가) RS485 network의 통신 채널 번호입니다. \\ \\
 . //useRegistance// \\
-종단 저항을 설정할지 결정하는 flag입니다. \\ \\
+종단 저항을 설정할지 결정하는 flag입니다. - 동작에 영향 없음 \\ \\
 . //numOfDevices// \\
 슬레이브 장치의 개수입니다.\\ \\
@@ 줄 841: / 줄 851: @@
     uint16_t wiegandCardMask;
     uint8_t wiegandCSNIndex;
-    uint8_t reserved[27];
+    uint8_t useWiegandUserID;
+    uint8_t reserved[26];
 } BS2WiegandConfig;
 </code>
@@ 줄 912: / 줄 923: @@
 Mifare 또는 EM 카드를 사용할 때 Wiegand out을 어떤 형식으로 처리할 것인지 결정하는 인덱스입니다.
 설정하기 전에 [[configuration api#BS2CardConfig]] 구조체의 //useWiegandFormat// 값을 확인하십시오. \\ \\
-. //reserved// \\
+. //useWiegandUserID// \\
+Wiegand 출력시 Card ID 또는 사용자 ID를 선택적으로 출력할 수 있도록 결정하는 플래그 입니다. \\
+<WRAP group 50%>
+^값  ^설명  ^
+|0  |사용 안함  |
+|1  |Card ID  |
+|2  |사용자 ID  |
+</WRAP>
+. //reserved// \\
 예약된 공간입니다.\\
@@ 줄 1316: / 줄 1335: @@
 . //type// \\
 Action 유형입니다. \\
+<WRAP round important 60%>
+<wrap em>[DoorModule-20, CoreStation-40]</wrap> \\
+Action type이 relay 또는 TTL(Output)이면서, action 장치가 DM20, CS40 이라면,
+action type은 relay action (6) 으로만 설정하여야 합니다. (TTL 설정불가) \\ \\
+<wrap em>[DM20]</wrap> \\
+  * Action type : Relay
+  * relay.relayIndex : 0 ~ 3 (RELAY 0 ~ 3)
+  * relay.relayIndex : 4 ~ 9 (OUTPUT 0 ~ 5)
+<wrap em>[CS40]</wrap> \\
+  * Action type : Relay
+  * relay.relayIndex : 0 ~ 3 (RELAY 0 ~ 3)
+  * relay.relayIndex : 4 ~ 11 (OUTPUT 0 ~ 7)
+</WRAP>
 <WRAP group 50%>
 ^값  ^설명  ^
@@ 줄 2028: / 줄 2060: @@
 배열 내의 값이 0보다 큰경우 해당 인증모드는 활성화 되어 있습니다. \\
 아래 설명 중 생체정보는 장치에 따라 지문 또는 얼굴을 의미합니다. \\
-<WRAP group 50%>
+<WRAP group 70%>
 ^순서 ^의미  ^설명  ^
 |11  |BS2_EXT_AUTH_MODE_FACE_ONLY  |얼굴  |
@@ 줄 2131: / 줄 2163: @@
 . //reserved4// \\
 예약된 공간입니다. \\ \\
+==== BS2FaceConfigExt ====
+<code cpp>
+typedef struct {
+    uint8_t thermalCheckMode;
+    uint8_t maskCheckMode;
+    uint8_t reserved[2];
+    uint8_t thermalFormat;
+    uint8_t reserved2;
+    uint16_t thermalThresholdLow;
+    uint16_t thermalThresholdHigh;
+    uint8_t maskDetectionLevel;
+    uint8_t auditTemperature;
+    uint8_t useRejectSound;
+    uint8_t useOverlapThermal;
+    uint8_t useDynamicROI;
+    uint8_t faceCheckOrder;
+} BS2FaceConfigExt;
+</code>
+. //thermalCheckMode// \\
+열화상 감지 모드를 설정합니다. \\
+HARD로 설정 시, 고열의 기준인 thermalThreshold를 초과하면, 출입에 영향을 주게됩니다. \\
+SOFT로 설정 시, 고열의 기준인 thermalThreshold를 초과하면, 근거를 로그를 남기고 출입에 영향을 주지 않습니다. \\
+thermalCheckMode가 사용안함(0)으로 설정되면, \\
+thermalFormat, thermalThreshold, auditTemperature, useOverlapThermal 의 설정은 무시됩니다. \\
+그리고 useRejectSound의 열화상 감지로 인한 sound발생이, faceCheckOrder의 발열 측정이 무시됩니다. \\
+<WRAP group 50%>
+^값  ^설명  ^기본값  ^
+|0  |열화상 감지 사용 안함  |기본값  |
+|1  |열화상 감지 사용 (HARD)  |  |
+|2  |열화상 감지 사용 (SOFT)  |  |
+</WRAP>
+. //maskCheckMode// \\
+''FaceStation F2'' 마스크 착용 감지 모드를 설정합니다. \\
+''FaceStation 2'' 이 설정은 무시됩니다. \\
+HARD로 설정 시, maskDetectionLevel에 근거하여 착용 위반이 감지되면, 출입에 영향을 주게됩니다. \\
+SOFT로 설정 시, maskDetectionLevel에 근거하여 착용 위반이 감지되면, 근거를 로그를 남기고 출입에 영향을 주지 않습니다. \\
+maskCheckMode가 사용안함(0)으로 설정되면, \\
+maskDetectionLevel 의 설정은 무시됩니다. \\
+그리고 useRejectSound의 마스크 착용으로 인한 sound발생이, faceCheckOrder의 마스크 착용 감지가 무시됩니다. \\
+<WRAP group 50%>
+^값  ^설명  ^기본값  ^
+|0  |마스크 착용 감지 사용 안함  |기본값  |
+|1  |마스크 착용 감지 사용 (HARD)  |  |
+|2  |마스크 착용 감지 사용 (SOFT)  |  |
+</WRAP>
+. //reserved// \\
+예약된 공간입니다. \\ \\
+. //thermalFormat// \\
+온도 단위를 나타내며, 화면상의 온도 표시를 화씨 또는 섭씨로 나타내도록 선택할 수 있습니다. \\
+<WRAP group 50%>
+^값  ^설명  ^기본값  ^
+|0  |화씨  |  |
+|1  |섭씨  |기본값  |
+</WRAP>
+. //reserved2// \\
+예약된 공간입니다. \\ \\
+. //thermalThresholdLow// \\
+''지원 버전'' : ''FaceStation F2 V1.0.2'', ''FaceStation 2 V1.5.0'' \\
+고열 판단 기준의 범위값이며, 설정 할 온도의 100을 곱한 값으로 입력하여야 합니다. \\
+또한 섭씨 기준으로만 입력할 수 있습니다. \\
+이 값은 인증 거부의 근거가 되며, 설정 범위는 섭씨로 100 (1º)에서 4500 (45º) 사이 입니다. \\
+기본 값은 3200 (32º)이며, 설정 범위보다 크거나 작은 값을 입력 시 기본 값 3200 (32º)으로 설정됩니다. \\
+그리고 thermalThresholdHigh보다 작은 값을 설정 하여야 합니다. \\ \\
+. //thermalThresholdHigh// \\
+고열 판단 기준의 범위값이며, 설정 할 온도의 100을 곱한 값으로 입력하여야 합니다. \\
+또한 섭씨 기준으로만 입력할 수 있습니다. \\
+이 값은 인증 거부의 근거가 되며, 설정 범위는 섭씨로 100 (1º)에서 4500 (45º) 사이 입니다. \\
+기본 값은 3800(38º)이며, 설정 범위보다 크거나 작은 값을 입력 시 기본 값 3800 (38º)으로 설정됩니다. \\
+그리고 thermalThresholdLow보다 큰 값을 설정 하여야 합니다. \\ \\
+. //maskDetectionLevel// \\
+''FaceStation F2'' 마스크 착용 감지 수준을 입력합니다. 여기서 감지 수준은 내부적으로 설정된 값에 근거합니다. \\
+''FaceStation 2'' 이 설정은 무시됩니다. \\
+<WRAP group 50%>
+^값  ^설명  ^기본값  ^
+|0  |착용 감지 안함  |기본값  |
+|1  |감지수준 보통  |  |
+|2  |감지수준 높음  |  |
+|3  |감지수준 매우높음  |  |
+</WRAP>
+. //auditTemperature// \\
+측정 온도를 이벤트 로그에 기록할지 여부를 설정합니다. \\ \\
+. //useRejectSound// \\
+thermalThreshold 또는 maskDetectionLevel에 의해서 사용자 인증이 거부되는 경우, 효과음을 발생시킬지 여부를 설정합니다. \\ \\
+. //useOverlapThermal// \\
+화면상에 열화상 이미지를 중첩해서 표시합니다. \\ \\
+. //useDynamicROI// \\
+true로 설정하면, 온도 측정 시 고정 영역이 아닌 실제 사용자의 이마를 찾아 측정합니다. \\ \\
+. //faceCheckOrder// \\
+발열 측정 및 마스크 착용 감지와 인증절차에 대한 순서를 정의합니다. \\
+ID를 조합한 인증이나, PIN을 조합한 인증의 경우, 장치에 접촉하게되는 절차를 거치게 되므로, \\
+고위험군을 고려하는 환경이라면, 발열 측정 후 인증을 선택할지, 그 전에 인증을 수행할지에 대한 선택은 매우 중요한 요소입니다. \\
+<WRAP group 50%>
+^값  ^설명  ^기본값  ^
+|0  |인증 후 발열 측정 및 마스크 착용 감지  | 기본값  |
+|1  |발열 측정 및 마스크 착용 감지 후 인증  |  |
+|2  |인증 절차 생략. 발열 검사 및 마스크 착용 감지만 수행  |  |
+</WRAP>
+==== BS2ThermalCameraConfig ====
+<code cpp>
+typedef struct {
+    uint8_t distance;
+    uint8_t emissionRate;
+    struct {
+        uint16_t x;
+        uint16_t y;
+        uint16_t width;
+        uint16_t height;
+    } roi;
+    uint8_t useBodyCompensation;
+    int8_t compensationTemperature;
+} BS2ThermalCameraConfig;
+</code>
+. //distance// \\
+열화상 카메라의 체온 측정 거리를 나타냅니다. 단위는 cm이며 기본값은 100 입니다. \\ \\
+. //emissionRate// \\
+피사체가 열을 방사하는 비율을 입력합니다. \\
+[95/97/98] 범위내의 입력을 권장합니다. 피사체가 사람인 경우 적정 권장은 98 입니다. \\ \\
+. //roi// \\
+ROI(Region of interest)는 관심영역을 의미하며, 얼굴에서 발열 측정 시, 관심 대상이되는 영역을 \\
+좌표(x, y)와, 범위(width, height) 값을 통해서 지정할 수 있습니다. \\ \\
+. //useBodyCompensation// \\
+발열 측정된 체온의 보정을 사용할지 여부를 나타냅니다. \\ \\
+. //compensationTemperature// \\
+실제 체온측정값과, 카메라를 통한 체온측정은 약간의 차이가 존재할 수 있으며, 이곳에 값을 설정하여, 그 차이를 보정할 수 있습니다. \\
+설정할 온도의 10을 곱한 값으로 입력하여야하며, 최소 -50에서 최대 50 사이의 값을 지정할 수 있습니다. \\ \\