차이

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

--- ko:configuration_api [2020/11/27 13:25]
kkshin [BS2FaceConfigExt]
+++ ko:configuration_api [2021/08/05 10:20]
kkshin [Configuration API]
@@ 줄 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 관련 설정을 저장합니다.
+  * [[BS2_GetInputConfigEx]]: [+ 2.8.1] ''IM-120'' Input 관련 확장형 설정을 가져옵니다.
+  * [[BS2_SetInputConfigEx]]: [+ 2.8.1] ''IM-120'' Input 관련 확장형 설정을 저장합니다.
+  * [[BS2_GetRelayActionConfig]]: [+ 2.8.1] ''IM-120'' RelayAction 관련 설정을 가져옵니다.
+  * [[BS2_SetRelayActionConfig]]: [+ 2.8.1] ''IM-120'' RelayAction 관련 설정을 저장합니다.
 ===== 구조체 =====
@@ 줄 409: / 줄 415: @@
 </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입니다.\\ \\
@@ 줄 776: / 줄 811: @@
 ==== 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;
@@ 줄 789: / 줄 833: @@
     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%>
@@ 줄 803: / 줄 865: @@
 |115200  |
 </WRAP>
 . //channelIndex// \\
-RS485 network의 통신 채널 번호입니다. \\ \\
+(사용자 설정 불가) RS485 network의 통신 채널 번호입니다. \\ \\
 . //useRegistance// \\
-종단 저항을 설정할지 결정하는 flag입니다. \\ \\
+종단 저항을 설정할지 결정하는 flag입니다. - 동작에 영향 없음 \\ \\
 . //numOfDevices// \\
 슬레이브 장치의 개수입니다.\\ \\
-. //slaveDevices// \\
+. //reserved// \\
+예약된 공간입니다.\\ \\
+. //slaveDevices// \\
 슬레이브 장치를 나열한 리스트로 최대 32개까지 정의할 수 있습니다.\\ \\
-. //mode// \\
+\\
+. //mode// \\
 RS485 네트워크에서 어떤 모드로 동작할지 결정하는 flag입니다 .\\
 <WRAP group 50%>
@@ 줄 820: / 줄 885: @@
 |3  |Standalone  |
 </WRAP>
 . //numOfChannels// \\
 RS485 채널의 개수입니다.\\ \\
 . //reserved// \\
 예약된 공간입니다.\\ \\
-. //reserved1// \\
+. //intelligentInfo// \\
+''[+V2.8]'' Intelligent Slave 기능을 설정하며, mode가 default(Standalone)인 경우에만 동작됩니다. \\
+이 설정을 이용하면 슈프리마 기기가 타사 컨트롤러와 연결된 환경에서 OSDP로 인증 결과를 출력시켜 줍니다.  \\ \\
+. //reserved1// \\
 예약된 공간입니다.\\ \\
 . //channels// \\
 RS485 채널을 나열한 리스트로 최대 4개까지 설정할 수 있습니다.\\ \\
@@ 줄 1625: / 줄 1693: @@
 |1  |옥외  |
 |2  |자동  |
+|3  |[+V2.8] 사용 안함 ''(FaceStation F2)''  |
 </WRAP>
 . //enrollThreshold// \\
@@ 줄 2229: / 줄 2298: @@
 또한 섭씨 기준으로만 입력할 수 있습니다. \\
 이 값은 인증 거부의 근거가 되며, 설정 범위는 섭씨로 100 (1º)에서 4500 (45º) 사이 입니다. \\
-기본 값은 3200이며, 설정 범위보다 크거나 작은 값을 입력 시 기본 값 3200으로 설정됩니다. \\
+기본 값은 3200 (32º)이며, 설정 범위보다 크거나 작은 값을 입력 시 기본 값 3200 (32º)으로 설정됩니다. \\
 그리고 thermalThresholdHigh보다 작은 값을 설정 하여야 합니다. \\ \\
 . //thermalThresholdHigh// \\
@@ 줄 2235: / 줄 2304: @@
 또한 섭씨 기준으로만 입력할 수 있습니다. \\
 이 값은 인증 거부의 근거가 되며, 설정 범위는 섭씨로 100 (1º)에서 4500 (45º) 사이 입니다. \\
-기본 값은 3800이며, 설정 범위보다 크거나 작은 값을 입력 시 기본 값 3800으로 설정됩니다. \\
+기본 값은 3800(38º)이며, 설정 범위보다 크거나 작은 값을 입력 시 기본 값 3800 (38º)으로 설정됩니다. \\
 그리고 thermalThresholdLow보다 큰 값을 설정 하여야 합니다. \\ \\
 . //maskDetectionLevel// \\
@@ 줄 2261: / 줄 2330: @@
 <WRAP group 50%>
 ^값  ^설명  ^기본값  ^
-|0  |발열 측정 및 마스크 착용 감지 후 인증  | 기본값  |
+|0  |인증 후 발열 측정 및 마스크 착용 감지  | 기본값  |
-|1  |인증 후 발열 측정 및 마스크 착용 감지  |  |
+|1  |발열 측정 및 마스크 착용 감지 후 인증  |  |
 |2  |인증 절차 생략. 발열 검사 및 마스크 착용 감지만 수행  |  |
 </WRAP>
@@ 줄 2296: / 줄 2365: @@
 실제 체온측정값과, 카메라를 통한 체온측정은 약간의 차이가 존재할 수 있으며, 이곳에 값을 설정하여, 그 차이를 보정할 수 있습니다. \\
 설정할 온도의 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// \\
+예약된 공간입니다. \\