차이

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

--- ko:configuration_api [2020/11/03 14:04]
kkshin [BS2Action]
+++ ko:configuration_api [2021/06/07 10:14]
kkshin [BS2Rs485Config]
@@ 줄 76: / 줄 76: @@
   * [[BS2_GetThermalCameraConfig]]: [+ 2.7.1] ''FaceStation F2, FaceStation2'' 열화상 카메라 설정을 가져옵니다.
   * [[BS2_SetThermalCameraConfig]]: [+ 2.7.1] ''FaceStation F2, FaceStation2'' 열화상 카메라 설정을 저장합니다.
+  * [[BS2_GetBarcodeConfig]]: [+ 2.8] ''X-Station 2'' Barcode 관련 설정을 가져옵니다.
+  * [[BS2_SetBarcodeConfig]]: [+ 2.8] ''X-Station 2'' Barcode 관련 설정을 저장합니다.
 ===== 구조체 =====
@@ 줄 368: / 줄 370: @@
     uint8_t shortcutHome[BS2_MAX_SHORTCUT_HOME];
     uint8_t tnaIcon[16];
-    uint8_t reserved1[32];
+    uint8_t useScreenSaver;
+    uint8_t reserved1[31];
 } BS2DisplayConfig;
 </code>
@@ 줄 408: / 줄 411: @@
 </WRAP>
 . //menuTimeout// \\
-사용자의 장치 조작이 없을 때 잠금 화면으로 전환되는 시간이며 단위는 초(sec)를 사용합니다. 0-255 sec로 설정할 수 있습으며. 0으로 설정되면 잠금 화면으로 전환되지 않습니다.\\ \\
+사용자의 장치 조작이 없을 때 잠금 화면으로 전환되는 시간이며 단위는 초(sec)를 사용합니다. 0-255 sec로 설정할 수 있습으며. 0으로 설정되면 잠금 화면으로 전환되지 않습니다.\\
+<WRAP group 50%>
+^값  ^설명  ^
+|0  |메뉴화면 유지 지속  |
+|10  |메뉴화면 유지 10초  |
+|20  |메뉴화면 유지 20초 (기본값)  |
+|30  |메뉴화면 유지 30초  |
+|40  |메뉴화면 유지 40초  |
+|50  |메뉴화면 유지 50초  |
+|60  |메뉴화면 유지 60초  |
+</WRAP>
 . //msgTimeout// \\
-메시지 화면이 자동으로 사라지는 시간이며 단위는 밀리초(ms)를 사용합니다. 500-5000 ms로 설정할 수 있습니다.\\ \\
+메시지 화면이 자동으로 사라지는 시간이며 단위는 밀리초(ms)를 사용합니다. 500-5000 ms로 설정할 수 있습니다.\\
+<WRAP group 50%>
+^값  ^설명  ^
+|500  |메시지 화면 유지 500밀리초  |
+|1000  |메시지 화면 유지 1초  |
+|2000  |메시지 화면 유지 2초 (기본값)  |
+|3000  |메시지 화면 유지 3초  |
+|4000  |메시지 화면 유지 4초  |
+|5000  |메시지 화면 유지 5초  |
+</WRAP>
 . //backlightTimeout// \\
-백라이트 유지 시간이며 단위는 초(sec)를 사용합니다. \\ \\
+백라이트 유지 시간이며 단위는 초(sec)를 사용합니다. \\
+<WRAP group 50%>
+^값  ^설명  ^
+|0  |백라이트 유지 0초  |
+|10  |백라이트 유지 10초  |
+|20  |백라이트 유지 20초 (기본값)  |
+|30  |백라이트 유지 30초  |
+|40  |백라이트 유지 40초  |
+|50  |백라이트 유지 50초  |
+|60  |백라이트 유지 60초  |
+</WRAP>
 . //displayDateTime// \\
 화면에 시간을 표시할지 결정하는 flag입니다.\\ \\
@@ 줄 443: / 줄 475: @@
 . //tnaIcon// \\
 장치내에서 근태 코드값에 해당하는 아이콘을 보여줄 때 사용합니다. \\ \\
-. //reserved1// \\
+. //useScreenSaver// \\
+''FaceStation 2'', ''FaceStation F2'' true로 설정 시, 화면보호기가 활성화됩니다. \\ \\
+. //reserved1// \\
 예약된 공간입니다. \\
@@ 줄 773: / 줄 807: @@
 ==== BS2Rs485Config ====
 <code cpp>
+typedef struct {
+    uint8_t supportConfig;
+    uint8_t useExceptionCode;
+    uint8_t exceptionCode[BS2_RS485_MAX_FAIL_CODE_LEN];
+    uint8_t outputFormat;
+    uint8_t osdpID;
+    uint8_t reserved[4];
+} BS2IntelligentPDInfo;
 typedef struct {
     uint32_t baudRate;
@@ 줄 786: / 줄 829: @@
     uint8_t numOfChannels;
     uint8_t reserved[2];
-    uint8_t reserved1[32];
+    BS2IntelligentPDInfo intelligentInfo;
+    uint8_t reserved1[16];
     BS2Rs485Channel channels[BS2_RS485_MAX_CHANNELS];
 } BS2Rs485Config;
 </code>
-. //baudRate// \\
+. //supportConfig// \\
+''[+V2.8]'' 이 값이 0으로 전달되면 장치는 아래의 Intelligent PD(Peripheral Device) 관련 설정들을 모두 무시하게 됩니다. \\ \\
+. //useExceptionCode// \\
+''[+V2.8]'' 예외코드를 전송을 사용할지의 여부를 설정합니다. \\ \\
+. //exceptionCode// \\
+''[+V2.8]'' 인증에 실패하거나, 인증 성공이지만 카드가 등록되어있지 않은 사용자의 경우 예외코드를 내보낼 수 있습니다. \\
+이때 사용할 예외코드를 설정합니다. \\
+만일 예외코드가 0(0x0000000000000000)이라면 예외코드가 발생되지 않습니다. \\ \\
+. //outputFormat// \\
+''[+V2.8]'' 인증 성공 시 내보내어지는 정보를 지정할 수 있습니다. \\
+이면 카드ID가, 1 이면 사용자ID가 출력됩니다. \\ \\
+. //osdpID// \\
+''[+V2.8]'' 동일한 ACU에 연결된 장치들을 서로 구분시켜주기위해 사용되어지는 값으로, \\
+~127 사이의 unique한 값을 설정해 지정하여주면 됩니다. \\ \\
+. //reserved// \\
+''[+V2.8]'' 예약된 공간입니다.\\ \\
+\\
+. //baudRate// \\
 RS485 통신 속도이며 설정할 수 있는 범위는 다음과 같습니다. \\
 <WRAP group 50%>
@@ 줄 800: / 줄 861: @@
 |115200  |
 </WRAP>
 . //channelIndex// \\
-RS485 network의 통신 채널 번호입니다. \\ \\
+(사용자 설정 불가) RS485 network의 통신 채널 번호입니다. \\ \\
 . //useRegistance// \\
-종단 저항을 설정할지 결정하는 flag입니다. \\ \\
+종단 저항을 설정할지 결정하는 flag입니다. - 동작에 영향 없음 \\ \\
 . //numOfDevices// \\
 슬레이브 장치의 개수입니다.\\ \\
-. //slaveDevices// \\
+. //reserved// \\
+예약된 공간입니다.\\ \\
+. //slaveDevices// \\
 슬레이브 장치를 나열한 리스트로 최대 32개까지 정의할 수 있습니다.\\ \\
-. //mode// \\
+\\
+. //mode// \\
 RS485 네트워크에서 어떤 모드로 동작할지 결정하는 flag입니다 .\\
 <WRAP group 50%>
@@ 줄 817: / 줄 881: @@
 |3  |Standalone  |
 </WRAP>
 . //numOfChannels// \\
 RS485 채널의 개수입니다.\\ \\
 . //reserved// \\
 예약된 공간입니다.\\ \\
-. //reserved1// \\
+. //intelligentInfo// \\
+''[+V2.8]'' Intelligent Slave 기능을 설정하며, mode가 default(Standalone)인 경우에만 동작됩니다. \\
+이 설정을 이용하면 슈프리마 기기가 타사 컨트롤러와 연결된 환경에서 OSDP로 인증 결과를 출력시켜 줍니다.  \\ \\
+. //reserved1// \\
 예약된 공간입니다.\\ \\
 . //channels// \\
 RS485 채널을 나열한 리스트로 최대 4개까지 설정할 수 있습니다.\\ \\
@@ 줄 1622: / 줄 1689: @@
 |1  |옥외  |
 |2  |자동  |
+|3  |[+V2.8] 사용 안함 ''(FaceStation F2)''  |
 </WRAP>
 . //enrollThreshold// \\
@@ 줄 2170: / 줄 2238: @@
     uint8_t thermalFormat;
-    uint8_t reserved2[3];
+    uint8_t reserved2;
-    uint16_t thermalThreshold;
+    uint16_t thermalThresholdLow;
+    uint16_t thermalThresholdHigh;
     uint8_t maskDetectionLevel;
     uint8_t auditTemperature;
@@ 줄 2178: / 줄 2247: @@
     uint8_t useRejectSound;
     uint8_t useOverlapThermal;
-    uint8_t reserved4;
+    uint8_t useDynamicROI;
     uint8_t faceCheckOrder;
 } BS2FaceConfigExt;
@@ 줄 2220: / 줄 2289: @@
 . //reserved2// \\
 예약된 공간입니다. \\ \\
-. //thermalThreshold// \\
+. //thermalThresholdLow// \\
-고열 판단 기준 값이며, 설정 할 온도의 100을 곱한 값으로 입력하여야 합니다. \\
+''지원 버전'' : ''FaceStation F2 V1.0.2'', ''FaceStation 2 V1.5.0'' \\
+고열 판단 기준의 범위값이며, 설정 할 온도의 100을 곱한 값으로 입력하여야 합니다. \\
 또한 섭씨 기준으로만 입력할 수 있습니다. \\
-이 값은 인증 거부의 근거가 되며, 설정 범위는 섭씨로 3000에서 4500 사이 입니다. \\ \\
+이 값은 인증 거부의 근거가 되며, 설정 범위는 섭씨로 100 (1º)에서 4500 (45º) 사이 입니다. \\
-. //maskDetectionLevel// \\
+기본 값은 3200 (32º)이며, 설정 범위보다 크거나 작은 값을 입력 시 기본 값 3200 (32º)으로 설정됩니다. \\
+그리고 thermalThresholdHigh보다 작은 값을 설정 하여야 합니다. \\ \\
+. //thermalThresholdHigh// \\
+고열 판단 기준의 범위값이며, 설정 할 온도의 100을 곱한 값으로 입력하여야 합니다. \\
+또한 섭씨 기준으로만 입력할 수 있습니다. \\
+이 값은 인증 거부의 근거가 되며, 설정 범위는 섭씨로 100 (1º)에서 4500 (45º) 사이 입니다. \\
+기본 값은 3800(38º)이며, 설정 범위보다 크거나 작은 값을 입력 시 기본 값 3800 (38º)으로 설정됩니다. \\
+그리고 thermalThresholdLow보다 큰 값을 설정 하여야 합니다. \\ \\
+. //maskDetectionLevel// \\
 ''FaceStation F2'' 마스크 착용 감지 수준을 입력합니다. 여기서 감지 수준은 내부적으로 설정된 값에 근거합니다. \\
 ''FaceStation 2'' 이 설정은 무시됩니다. \\
@@ 줄 2234: / 줄 2312: @@
 |3  |감지수준 매우높음  |  |
 </WRAP>
 . //auditTemperature// \\
 측정 온도를 이벤트 로그에 기록할지 여부를 설정합니다. \\ \\
 . //useRejectSound// \\
 thermalThreshold 또는 maskDetectionLevel에 의해서 사용자 인증이 거부되는 경우, 효과음을 발생시킬지 여부를 설정합니다. \\ \\
 . //useOverlapThermal// \\
 화면상에 열화상 이미지를 중첩해서 표시합니다. \\ \\
-. //reserved4// \\
+. //useDynamicROI// \\
-예약된 공간입니다. \\ \\
+true로 설정하면, 온도 측정 시 고정 영역이 아닌 실제 사용자의 이마를 찾아 측정합니다. \\ \\
 . //faceCheckOrder// \\
 발열 측정 및 마스크 착용 감지와 인증절차에 대한 순서를 정의합니다. \\
 ID를 조합한 인증이나, PIN을 조합한 인증의 경우, 장치에 접촉하게되는 절차를 거치게 되므로, \\
@@ 줄 2248: / 줄 2326: @@
 <WRAP group 50%>
 ^값  ^설명  ^기본값  ^
-|0  |발열 측정 및 마스크 착용 감지 후 인증  | 기본값  |
+|0  |인증 후 발열 측정 및 마스크 착용 감지  | 기본값  |
-|1  |인증 후 발열 측정 및 마스크 착용 감지  |  |
+|1  |발열 측정 및 마스크 착용 감지 후 인증  |  |
 |2  |인증 절차 생략. 발열 검사 및 마스크 착용 감지만 수행  |  |
 </WRAP>
 ==== BS2ThermalCameraConfig ====
@@ 줄 2274: / 줄 2349: @@
 </code>
 . //distance// \\
-열화상 카메라의 체온 측정 거리를 나타냅니다. 단위는 cm이며 기본값은 70 입니다. \\ \\
+열화상 카메라의 체온 측정 거리를 나타냅니다. 단위는 cm이며 기본값은 100 입니다. \\ \\
 . //emissionRate// \\
 피사체가 열을 방사하는 비율을 입력합니다. \\
@@ 줄 2286: / 줄 2361: @@
 실제 체온측정값과, 카메라를 통한 체온측정은 약간의 차이가 존재할 수 있으며, 이곳에 값을 설정하여, 그 차이를 보정할 수 있습니다. \\
 설정할 온도의 10을 곱한 값으로 입력하여야하며, 최소 -50에서 최대 50 사이의 값을 지정할 수 있습니다. \\ \\
+==== BS2BarcodeConfig ====
+<code cpp>
+typedef struct {
+    uint8_t useBarcode;
+    uint8_t scanTimeout;
+    uint8_t reserved[14];
+} BS2BarcodeConfig;
+</code>
+. //useBarcode// \\
+Barcode 사용여부 flag입니다. \\ \\
+. //scanTimeout// \\
+Barcode scan 시간을 설정합니다. 단위는 초입니다. \\
+기본값은 4초이며, 4~10초 범위 내로 입력 가능합니다. \\ \\
+. //reserved// \\
+예약된 공간입니다. \\