차이

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

--- ko:configuration_api [2024/02/21 11:41]
mwkim [BS2Trigger]
+++ ko:configuration_api [2025/06/13 09:37] (현재)
mwkim [BS2Rs485ConfigEXDynamic]
@@ 줄 70: / 줄 70: @@
   * [[BS2_GetDesFireCardConfigEx]]: [+ 2.6.4] DesFire 카드 고급설정 정보를 가져옵니다.
   * [[BS2_SetDesFireCardConfigEx]]: [+ 2.6.4] DesFire 카드 고급설정 정보를 저장합니다.
-  * [[BS2_GetAuthConfigExt]]: [+ 2.7.1] ''FSF2'' 인증 설정 정보를 가져옵니다.
+  * [[BS2_GetAuthConfigExt]]: [+ 2.7.1] ''Visual Face 기반 장치'' 인증 설정 정보를 가져옵니다.
-  * [[BS2_SetAuthConfigExt]]: [+ 2.7.1] ''FSF2'' 인증 설정 정보를 저장합니다.
+  * [[BS2_SetAuthConfigExt]]: [+ 2.7.1] ''Visual Face 기반 장치'' 인증 설정 정보를 저장합니다.
-  * [[BS2_GetFaceConfigExt]]: [+ 2.7.1] ''FSF2, FS2'' 열화상 감지와 마스크 착용 체크를 위한 설정 정보를 가져옵니다.
+  * [[BS2_GetFaceConfigExt]]: [+ 2.7.1] 열화상 감지와 마스크 착용 체크를 위한 설정 정보를 가져옵니다.
-  * [[BS2_SetFaceConfigExt]]: [+ 2.7.1] ''FSF2, FS2'' 열화상 감지와 마스크 착용 체크를 위한 설정 정보를 저장합니다.
+  * [[BS2_SetFaceConfigExt]]: [+ 2.7.1] 열화상 감지와 마스크 착용 체크를 위한 설정 정보를 저장합니다.
-  * [[BS2_GetThermalCameraConfig]]: [+ 2.7.1] ''FSF2, FS2'' 열화상 카메라 설정을 가져옵니다.
+  * [[BS2_GetThermalCameraConfig]]: [+ 2.7.1] 열화상 카메라 설정을 가져옵니다.
-  * [[BS2_SetThermalCameraConfig]]: [+ 2.7.1] ''FSF2, FS2'' 열화상 카메라 설정을 저장합니다.
+  * [[BS2_SetThermalCameraConfig]]: [+ 2.7.1] 열화상 카메라 설정을 저장합니다.
   * [[BS2_GetBarcodeConfig]]: [+ 2.8] ''XS2'' Barcode 관련 설정을 가져옵니다.
   * [[BS2_SetBarcodeConfig]]: [+ 2.8] ''XS2'' Barcode 관련 설정을 저장합니다.
@@ 줄 82: / 줄 82: @@
   * [[BS2_GetRelayActionConfig]]: [+ 2.8.1] ''IM-120'' RelayAction 관련 설정을 가져옵니다.
   * [[BS2_SetRelayActionConfig]]: [+ 2.8.1] ''IM-120'' RelayAction 관련 설정을 저장합니다.
-  * [[BS2_GetVoipConfigExt]]: [+ 2.8.3] ''BS3'' 확장형 VoIP 설정을 가져옵니다.
+  * [[BS2_GetVoipConfigExt]]: [+ 2.8.3] 확장형 VoIP 설정을 가져옵니다.
-  * [[BS2_SetVoipConfigExt]]: [+ 2.8.3] ''BS3'' 확장형 VoIP 설정을 저장합니다.
+  * [[BS2_SetVoipConfigExt]]: [+ 2.8.3] 확장형 VoIP 설정을 저장합니다.
-  * [[BS2_GetRtspConfig]]: [+ 2.8.3] ''BS3'' RTSP 설정을 가져옵니다.
+  * [[BS2_GetRtspConfig]]: [+ 2.8.3] RTSP 설정을 가져옵니다.
-  * [[BS2_SetRtspConfig]]: [+ 2.8.3] ''BS3'' RTSP 설정을 저장합니다.
+  * [[BS2_SetRtspConfig]]: [+ 2.8.3] RTSP 설정을 저장합니다.
   * [[BS2_GetLicenseConfig]]: [+ 2.9.1] 장치 라이선스 활성화 정보를 가져옵니다.
   * [[BS2_GetOsdpStandardConfig]]: [+ 2.9.1] 장치의 OSDP 설정 정보를 가져옵니다.
@@ 줄 92: / 줄 92: @@
   * [[BS2_GetCustomCardConfig]]: [+ 2.9.4] Custom smart card 설정을 가져옵니다.
   * [[BS2_SetCustomCardConfig]]: [+ 2.9.4] Custom smart card 설정을 저장합니다.
+  * [[BS2_GetMifareCardConfigEx]]: [+ 2.9.9] 장치의 Mifare 카드 중 AES128 암호화 된 카드에 사용되는 설정 정보를 가져옵니다.
+  * [[BS2_SetMifareCardConfigEx]]: [+ 2.9.9] 장치의 Mifare 카드 중 AES128 암호화 된 카드에 사용되는 설정 정보를 저장합니다.
+  * [[BS2_GetFacilityCodeConfig]]: [+ 2.9.9] ''Door Interface(DI-24)''와 마스터 장치의 OSDP 연결이 끊어진 경우 인증코드로 사용되는 BS2FacilityCode를 가져옵니다.
+  * [[BS2_SetFacilityCodeConfig]]: [+ 2.9.9] ''Door Interface(DI-24)''와 마스터 장치의 OSDP 연결이 끊어진 경우 인증코드로 사용되는 BS2FacilityCode 설정을 저장합니다.
+  * [[BS2_GetRS485ConfigExDynamic]]: [+ 2.9.9] ''CoreStation''일 경우 RS485 네트워크 설정 정보를 가져옵니다.
+  * [[BS2_SetRS485ConfigExDynamic]]: [+ 2.9.9] ''CoreStation''일 경우 RS485 네트워크 설정 정보를 저장합니다.
 ===== 구조체 =====
 ==== BS2FactoryConfig ====
@@ 줄 389: / 줄 395: @@
     uint8_t showOsdpResult;
     uint8_t reserved1[30];
+    BS2_SHOW_OSDP_RESULT showOsdpResult;	///< 1 byte
+    BS2_AUTHMSG_USERINFO authMsgUserName;			///< 1 byte
+    BS2_AUTHMSG_USERINFO authMsgUserId;			///< 1 byte
+    BS2_SCRAMBLE_KEYBOARD_MODE scrambleKeyboardMode ;		///< 1 byte
+    uint8_t reserved3[27];		///< 27 bytes (padding)
 } BS2DisplayConfig;
 </code>
@@ 줄 493: / 줄 507: @@
 장치내에서 근태 코드값에 해당하는 아이콘을 보여줄 때 사용합니다. \\ \\
 . //useScreenSaver// \\
-''FaceStation 2'', ''FaceStation F2'' true로 설정 시, 화면보호기가 활성화됩니다. \\ \\
+true로 설정 시, 화면보호기가 활성화됩니다. \\ \\
 . //showOsdpResult// \\
 [+ 2.9.6] Intelligent slave나 타사 컨트롤러에 슈프리마 장치를 주변장치로 연결하여 사용하는 환경에서 \\
@@ 줄 503: / 줄 517: @@
 </WRAP>
 . //reserved1// \\
-예약된 공간입니다. \\
+예약된 공간입니다. \\ \\
+. //authMsgUserName// \\
+[+2.9.8] 장치 화면에 표시되는 인증 결과 메시지에 포함된 사용자 이름의 표시 방법을 설정합니다. \\
+<WRAP group 50%>
+^값  ^설명  ^
+|0  |전체 표시  |
+|1  |첫 문자만 표시  |
+|2  |표시 안함  |
+</WRAP>
+. //authMsgUserID// \\
+[+2.9.8]  장치 화면에 표시되는 인증 결과 메시지에 포함된 사용자 ID의 표시 방법을 설정합니다. \\
+<WRAP group 50%>
+^값  ^설명  ^
+|0  |전체 표시  |
+|1  |첫 문자만 표시  |
+|2  |표시 안함  |
+</WRAP>
+. //scrambleKeyboardMode// \\
+[+2.9.8] 스크램블 키패드의 사용 여부를 설정합니다. \\
+<WRAP group 50%>
+^값  ^설명  ^
+|0  |사용  |
+|1  |사용 안함  |
+</WRAP>
 ==== BS2IpConfig ====
 <code cpp>
@@ 줄 678: / 줄 714: @@
     uint8_t cipher;
     uint8_t smartCardByteOrder;
-    uint8_t reserved[22];
+    uint8_t reserved[1];
+    uint8_t mifareEncType;
+    uint8_t reserved[20];
 } BS2CardConfig;
 </code>
@@ 줄 760: / 줄 798: @@
 </WRAP>
 . //reserved// \\
+예약된 공간입니다. \\
+. //mifareEncType// \\
+[+2.9.9] Mifare Card의 암호화 방식을 지정합니다. Mifare Classic 카드는 CRYPTO1만 지원하며, \\
+Mifare Plus 카드는 CRYPTO1과 AES128 모두 지원합니다. \\
+CRYPTO1으로 설정하면 BS2MifareCard의 Mifare 설정이 적용되고, AES128로 설정하면 \\
+BS2_SetMifareCardConfigEx 및 BS2_GetMifareCardConfigEx를 통해 설정할 수 있는 \\
+BS2MifareCardConfigEx 설정이 적용됩니다. \\
+<WRAP group 50%>
+^값  ^설명  ^
+|0  |CRYPTO1  |
+|1  |AES128  |
+</WRAP>
+. //reserved// \\
 예약된 공간입니다. \\
 ==== BS2FingerprintConfig ====
@@ 줄 911: / 줄 962: @@
 <WRAP group 50%>
 ^값  ^설명  ^
-|0  |사용안함  |
 |1  |Master  |
 |2  |Slave  |
@@ 줄 1117: / 줄 1167: @@
     uint8_t numInputs;
     uint8_t numSupervised;
-    uint16_t reseved;
+    union {
+	uint16_t value;
+	struct {
+		uint16_t tamperAuxIndex : 4;
+		uint16_t acFailAuxIndex : 4;
+		uint16_t aux0Type : 1;
+		uint16_t aux1Type : 1;
+		uint16_t reserved : 6;
+	} field;
+    } aux;
     struct {
         uint8_t portIndex;
@@ 줄 1157: / 줄 1216: @@
 |255  |사용자 정의  |
 </WRAP>
-. //reserved// \\
+. //aux// \\
-예약된 공간입니다. \\ \\
+[+2.9.8] Aux의 동작을 설정합니다.
+<WRAP group 70%>
+^비트위치  ^비트 수  ^멤버명  ^설명  ^
+|0  |4  |tamperAuxIndex  |Tamper로 사용할 Aux 번호 (0:None, 1:Aux0, 2:Aux1)  |
+|7  |4  |acFailAuxIndex  |AC Fail로 사용할 Aux 번호 (0:None, 1:Aux0, 2:Aux1)  |
+|8  |1  |aux0Type  |Aux 0의 타입 (0: NO, 1:NC)  |
+|9  |1  |aux1Type  |Aux 1의 타입 (0: NO, 1:NC)  |
+|10  |6  |reserved  |예약된 공간  |
+</WRAP>
 . //config// \\
 supervised 입력 신호 유형을 판단하는 설정값으로, supervised input의 저항값이 사용자 정의일 경우에만 의미가 있습니다. \\
@@ 줄 1284: / 줄 1351: @@
 슈프리마 장치가 타사 컨트롤러와 wiegand로 연결된 환경에서 \\
 특정 모델의 컨트롤러로부터 슈프리마 장치로 인증에 대한 피드백이 반복적으로 입력되는 경우 \\
-이 설정을 통해 설정한 시간만큼 강제로 입력 신호가 무시되도록 지정할 수 있습니다. \\ \\
+이 설정을 통해 해당 시간만큼 강제로 입력 신호가 무시되도록 지정할 수 있습니다. \\ \\
 ==== BS2Action ====
@@ 줄 1728: / 줄 1795: @@
 } BS2FaceConfig;
 </code>
 . //securityLevel// \\
 시스템 전반적으로 사용할 얼굴 인증 보안 레벨입니다. \\
@@ 줄 1743: / 줄 1811: @@
 |1  |옥외  |
 |2  |자동  |
-|3  |[+ 2.8] 사용 안함 ''(FaceStation F2)''  |
+|3  |[+ 2.8] 사용 안함  |
 </WRAP>
 . //enrollThreshold// \\
@@ 줄 1770: / 줄 1838: @@
 </WRAP>
 . //enrollTimeout// \\
-''FaceStation2, FaceLite'' : 얼굴 스캔 대기 시간으로 기본값은 60초입니다. \\
+''IR Face 기반'' : 얼굴 스캔 대기 시간으로 기본값은 60초입니다. \\
 <WRAP group 60%>
 ^값  ^설명  ^
@@ 줄 1777: / 줄 1845: @@
 |BS2_FACE_ENROLL_TIMEOUT_DEFAULT  |BS2_FACE_ENROLL_TIMEOUT_MAX  |
 </WRAP>
-''FaceStation F2'' : [+ V2.7.1]  얼굴 스캔 대기 시간으로 기본값은 20초입니다. \\
+''Visual Face 기반'' : [+ V2.7.1]  얼굴 스캔 대기 시간으로 기본값은 20초입니다. \\
 <WRAP group 70%>
 ^값  ^설명  ^
@@ 줄 1786: / 줄 1854: @@
 . //lfdLevel// \\
 [+ 2.6.3] 위조된 얼굴을 여과할 수 있는 민감도를 설정할 수 있습니다. \\
-''FaceStation2, FaceLite'' : 기본값은 0입니다. \\
+''IR Face 기반'' : 기본값은 0입니다. \\
-''FaceStation F2'' : [+ 2.7.1] 기본값이 1입니다. \\
+''Visual Face 기반'' : [+ 2.7.1] 기본값이 1입니다. \\
 <WRAP group 50%>
 ^값  ^설명  ^
@@ 줄 1811: / 줄 1879: @@
 [+ 2.6.4] true로 설정하면 중복된 얼굴 정보인지 판단합니다. \\ \\
 . //operationMode// \\
-[+ 2.7.1] ''FaceStation F2'' 아래의 동작 모드를 설정하며, 기본값은 Fusion 모드입니다. \\
+[+ 2.7.1] ''FaceStation F2 V1.0.1''미만은 아래의 동작 모드로 설정가능하며, 기본값은 Fusion 모드입니다. \\
 <WRAP group 50%>
 ^값  ^모드  ^설명  ^기본값  ^
@@ 줄 1817: / 줄 1885: @@
 |1  |Visual 모드 |Visual matching | |
 |2  |Visual + IR검출 |Visual matching, IR은 얼굴 검출만| |
+</WRAP>
+''FaceStation F2 V1.0.1''이상, ''Visual Face 기반''는 아래와 같은 의미로 사용됩니다.
+<WRAP group 50%>
+^값  ^모드  ^설명  ^기본값  ^
+|0  |Fusion 모드 |Visual matching + IR matching |기본 |
+|1  |Fast 모드 |Visual matching | |
 </WRAP>
 . //maxRotation// \\
-[+ 2.7.1] ''FaceStation F2'' 일반적인 상황에서 얼굴을 검출할 때 얼굴의 방향은 정면일 것입니다. \\
+[+ 2.7.1] ''Visual Face 기반'' 일반적인 상황에서 얼굴을 검출할 때 얼굴의 방향은 정면일 것입니다. \\
-FaceStation F2는 얼굴 검출 시 정면에서 어느 정도 회전된(왜곡된) 이미지인지 판단할 수 있습니다. \\
+이 경우 장치는 얼굴 검출 시 정면에서 어느 정도 회전된(왜곡된) 이미지인지 판단할 수 있습니다. \\
 이를 통해 일정 각도 이상 회전된 이미지의 경우 검출 실패 처리를 할 수 있습니다. \\
 maxRotation은 이런 경우의 최대 허용치를 나타내며 기본값은 15도입니다. \\ \\
@@ 줄 1836: / 줄 1911: @@
 </WRAP>
 . //faceWidth// \\
-[+ 2.7.1] ''FaceStation F2'' 얼굴 이미지의 폭을 나타내며 폭의 최소값, 최대값을 지정할 수 있습니다. \\
+[+ 2.7.1] ''Visual Face 기반'' 얼굴 이미지의 폭을 나타내며 폭의 최소값, 최대값을 지정할 수 있습니다. \\
 최소값, 최대값의 기본값은 아래와 같습니다. \\
 <WRAP group 30%>
@@ 줄 1845: / 줄 1920: @@
 </WRAP>
 . //searchRange// \\
-[+ 2.7.1] ''FaceStation F2'' 얼굴 감지 범위를 나타내며 범위의 x값(가로 좌표)과 x값으로부터의 폭을 지정할 수 있습니다. \\
+[+ 2.7.1] ''Visual Face 기반'' 얼굴 감지 범위를 나타내며 범위의 x값(가로 좌표)과 x값으로부터의 폭을 지정할 수 있습니다. \\
 x값과 폭의 기본값은 아래와 같습니다. \\
 <WRAP group 30%>
@@ 줄 1854: / 줄 1929: @@
 </WRAP>
 . //detectDistance// \\
-[+ 2.8.3] ''BioStation 3'' 얼굴 감지 거리의 최소값과 최대값을 설정합니다. \\
+[+ 2.8.3] ''Visual Face 기반'' 얼굴 감지 거리의 최소값과 최대값을 설정합니다. \\
-[+ 2.9.6] ''FaceStation F2'' ''BioEntry W3'' 기능추가. \\
 픽셀 단위로 얼굴 위치를 지정하는 faceWidth는 사용하기 난해하므로 더 이상 사용하지 않습니다. \\
 대신 피사체(얼굴)의 감지 거리를 얼마로 할지 만 정합니다. 거리는 cm로 설정하며, 10의 배수로 입력하여야 합니다. \\
@@ 줄 1865: / 줄 1939: @@
 </WRAP>
 . //wideSearch// \\
-[+ 2.8.3] ''BioStation 3'' 얼굴 감지 범위를 넓힙니다. \\
+[+ 2.8.3] ''BioStation 3, BioEntry W3'' 얼굴 감지 범위를 넓힙니다. \\
 x좌표와 width를 지정해야하는 난해한 설정인 searchRange는 더 이상 사용하지 않습니다. \\
 대신 얼굴 감지를 표준(false) 설정으로 할지, 광역(true)으로 할지 여부만 지정합니다. \\
@@ 줄 1922: / 줄 1996: @@
 <WRAP group 50%>
 ^값  ^설명  ^
-|0  |사용안함  |
 |1  |Master  |
 |2  |Slave  |
 |3  |Standalone  |
+</WRAP>
+<WRAP info>
+CoreStation은 Master로만 사용 가능합니다. 다른 값은 설정할 수 없습니다.
 </WRAP>
 . //numOfChannels// \\
@@ 줄 2368: / 줄 2444: @@
 </WRAP>
 . //maskCheckMode// \\
-''FaceStation F2'' 마스크 착용 감지 모드를 설정합니다. \\
+''Visual Face 기반'' 마스크 착용 감지 모드를 설정합니다. \\
-''FaceStation 2'' 이 설정은 무시됩니다. \\
+HARD로 설정 시 maskDetectionLevel에 따라 마스크 착용 위반이 감지될 경우 출입에 영향을 주게됩니다. \\
-HARD로 설정 시, maskDetectionLevel에 근거하여 착용 위반이 감지되면, 출입에 영향을 주게됩니다. \\
+SOFT로 설정 시 maskDetectionLevel에 따라 마스크 착용 위반이 감지될 경우 로그가 기록되고 출입에는 영향을 주지 않습니다. \\
-SOFT로 설정 시, maskDetectionLevel에 근거하여 착용 위반이 감지되면, 근거를 로그를 남기고 출입에 영향을 주지 않습니다. \\
+maskCheckMode가 사용안함(0)으로 설정되면, maskDetectionLevel의 설정은 무시됩니다. \\
-maskCheckMode가 사용안함(0)으로 설정되면, \\
+또한 useRejectSound의 마스크 착용으로 인한 소리 발생과 faceCheckOrder의 마스크 착용 감지가 무시됩니다. \\
-maskDetectionLevel 의 설정은 무시됩니다. \\
+[+2.9.8] 마스크 착용 금지(3)는 Mask Check Mode가 Check Before Authentication 인 경우만 설정 가능하며, maskDetectionLevel에 따라 마스크를 착용한 사용자는 인증이 실패됩니다. 이 옵션은 [[device_api#bs2devicecapabilities|BS2DeviceCapabilities - authDenyMaskSupported]]를 지원하는 장치만 사용할 수 있습니다. \\
-그리고 useRejectSound의 마스크 착용으로 인한 sound발생이, faceCheckOrder의 마스크 착용 감지가 무시됩니다. \\
 <WRAP group 50%>
 ^값  ^설명  ^기본값  ^
@@ 줄 2380: / 줄 2455: @@
 |1  |마스크 착용 감지 사용 (HARD)  |  |
 |2  |마스크 착용 감지 사용 (SOFT)  |  |
+|3  |마스크 착용 금지  |  |
 </WRAP>
 . //reserved// \\
@@ 줄 2393: / 줄 2469: @@
 예약된 공간입니다. \\ \\
 . //thermalThresholdLow// \\
-''지원 버전'' : ''FaceStation F2 V1.0.2'', ''FaceStation 2 V1.5.0'' \\
 고열 판단 기준의 범위값이며, 설정 할 온도의 100을 곱한 값으로 입력하여야 합니다. \\
 또한 섭씨 기준으로만 입력할 수 있습니다. \\
@@ 줄 2406: / 줄 2481: @@
 그리고 thermalThresholdLow보다 큰 값을 설정 하여야 합니다. \\ \\
 . //maskDetectionLevel// \\
-''FaceStation F2'' 마스크 착용 감지 수준을 입력합니다. 여기서 감지 수준은 내부적으로 설정된 값에 근거합니다. \\
+''Visual Face 기반'' 마스크 착용 감지 수준을 입력합니다. 여기서 감지 수준은 내부적으로 설정된 값에 근거합니다. \\
-''FaceStation 2'' 이 설정은 무시됩니다. \\
 <WRAP group 50%>
 ^값  ^설명  ^기본값  ^
@@ 줄 2538: / 줄 2612: @@
     uint8_t    numInputs;
     uint8_t    numSupervised;
-    uint8_t    reserved[18];
+    union {
+        uint16_t value;
+        struct {
+            uint16_t tamperAuxIndex : 4;
+            uint16_t acFailAuxIndex : 4;
+            uint16_t aux0Type : 1;
+            uint16_t aux1Type : 1;
+            uint16_t aux2Type : 1;
+            uint16_t reserved : 1;
+            uint16_t fireAuxIndex : 4;
+        } field;
+    } aux;
+    uint8_t     reserved[16];
     struct {
@@ 줄 2547: / 줄 2633: @@
         uint8_t    reserved;
         uint8_t    supervisedResistor;
-        uint8_t    reserved1[16];
+        BS2SupervisedInputConfig  supervisedConfig;
         uint8_t    reserved2[26];
@@ 줄 2559: / 줄 2645: @@
 . //numSupervised// \\
 supervised input 포트의 개수입니다. \\ \\
-. //reserved// \\
+. //tamperAuxIndex, acFailAuxIndex, fireAuxIndex// \\
+[+2.9.9] Aux 입력을 설정합니다. 4bit 크기이며 CS20, DI24는 고정되어 있고 변경할 수 없습니다. \\
+<WRAP group 50%>
+^Aux이름  ^인덱스  ^
+|AC Fail  |0  |
+|TAMPER  |1  |
+|FIRE  |2  |
+</WRAP>
+. //aux0Type, aux1Type, aux2Type// \\
+[+2.9.9] Aux 입력 신호 유형을 설정합니다. \\
+<WRAP group 50%>
+^값  ^설명  ^
+|0  |Normally Open  |
+|1  |Normally Closed  |
+</WRAP>
+. //reserved// \\
 예약된 공간입니다. \\ \\
 . //portIndex// \\
 Input 포트 번호입니다. \\ \\
 . //switchType// \\
 Input 신호 유형입니다. \\
 <WRAP group 50%>
@@ 줄 2570: / 줄 2671: @@
 |1  |Normally Closed  |
 </WRAP>
 . //duration// \\
 Input 신호의 지속시간으로 단위는 밀리초(ms)입니다. \\ \\
 . //reserved// \\
 예약된 공간입니다. \\ \\
 . //supervisedResistor// \\
 Supervised input 저항 값의 유형을 설정하거나, 해제할 수(unsupervised) 있습니다. \\
 <WRAP group 50%>
@@ 줄 2584: / 줄 2685: @@
 |254  |Unsupervised(기본값)  |
 </WRAP>
-. //reserved1// \\
+. //reserved2// \\
 예약된 공간입니다. \\ \\
 . //reserved2// \\
-예약된 공간입니다. \\ \\
-. //reserved2// \\
 예약된 공간입니다. \\ \\
@@ 줄 2696: / 줄 2795: @@
     BS2ExtensionNumber phonebook[128];
-    uint8_t reserved2[32];        ///< 32 bytes (reserved)
+    uint8_t resolution;
+    uint8_t transport;
+    uint8_t reserved2[30];		///< 30 bytes (reserved)
 } BS2VoipConfigExt;
 </code>
@@ 줄 2750: / 줄 2851: @@
 . //phonebook// \\
 개까지 내선 번호들을 전화번호부로 지정할 수 있습니다. \\ \\
-. //reserved2// \\
+. //resolution// \\
+[+2.9.8] 송신 비디오 해상도를 설정합니다.
+<WRAP group 50%>
+^값  ^설명  ^
+|0  |360 x 640  |
+|1  |720 x 480  |
+</WRAP>
+. //transport// \\
+[+2.9.8] 데이터 전송 방식을 설정합니다.
+<WRAP group 50%>
+^값  ^설명  ^
+|0  |UDP  |
+|1  |TCP  |
+|2  |SSL  |
+</WRAP>
+. //reserved2// \\
 예약된 공간입니다. \\ \\
@@ 줄 2764: / 줄 2880: @@
     BS2_PORT port;
     BS2_BOOL enabled;
-    uint8_t reserved;
+    uint8_t reserved;				///< 1 byte (packing)
-    uint8_t reserved2[32];
+    uint8_t resolution;
+    uint8_t reserved2[31];			///< 31 bytes (reserved)
 } BS2RtspConfig;
 </code>
@@ 줄 2781: / 줄 2898: @@
 . //reserved// \\
 예약된 공간입니다. \\ \\
-. //reserved2// \\
+. //resolution// \\
+[+2.9.8] 송신 비디오 해상도를 설정합니다.
+<WRAP group 30%>
+^값  ^설명  ^
+|0  |180 x 320  |
+|1  |720 x 480  |
+</WRAP>
+. //reserved2// \\
 예약된 공간입니다. \\ \\
@@ 줄 2853: / 줄 2977: @@
 . //reserved1// \\
 예약된 공간입니다. \\ \\
-==== BS2BarcodeConfig ====
-<code cpp>
-typedef struct {
-    uint8_t useBarcode;
-    uint8_t scanTimeout;
-    uint8_t bypassData;
-    uint8_t treatAsCSN;
-	uint8_t useVisualBarcode;
-	uint8_t motionSensitivity;
-    uint8_t visualCameraScanTimeout;
-    uint8_t reserved[9];
-} BS2BarcodeConfig;
-</code>
-. //useBarcode// \\
-''XS2-QR 만 지원''
-Barcode 사용여부 flag입니다. \\ \\
-. //scanTimeout// \\
-Barcode scan 시간을 설정합니다. 단위는 초입니다. \\
-기본값은 4초이며, 4~10초 범위 내로 입력 가능합니다. \\ \\
-<WRAP group 50%>
-^값  ^매크로  ^설명  ^
-|4  |BS2_BARCODE_TIMEOUT_DEFAULT  |기본값  |
-|4  |BS2_BARCODE_TIMEOUT_MIN  |최소값  |
-|10  |BS2_BARCODE_TIMEOUT_MAX  |최대값  |
-</WRAP>
-. //bypassData// \\
-[+2.8.2] 읽혀진 barcode 정보를 장치에서 처리하지 않고, 서버로 전송하기 위해 사용합니다. \\
-사용자 인증을 위해 사용자 정보 구조체에 barcode 값을 저장하게되는 경우, \\
-byte의 크기 제약([[smartcard_api#BS2CSNCard|BS2CSNCard data 참조]])이 있으나, \\
-[[BS2_SetBarcodeScanListener]]를 호출하고, 이 옵션을 사용하면 최대 512 byte크기의 barcode를 서버로 전송할 수 있습니다. \\ \\
-. //treatAsCSN// \\
-[+2.8.2] Barcode를 일반 CSN 카드와 동일하게 처리할지의 여부를 나타냅니다. \\
-XS2-QR 1.1.3부터 적용되며, false의 경우, 이전과 동일하게 처리됩니다. \\
-이방식은 barcode로 처리될 수 있는 문자셋을 ASCII code 32에서 126까지 자유롭게 지정할 수 있습니다. ([[qr_code_api#BS2_WriteQRCode|BS2_WriteQRCode의 설명 참조]]) \\
-true로 설정하면, barcode를 기존 CSN과 동일하게 숫자로만 취급하게 됩니다. \\
-따라서, 특수문자, 영문자가 들어있는 barcode 카드 데이터를 설정하고자 하면 오류를 반환할 수 있습니다. \\
-이 경우, card type만 다르게, CSN 카드와 barcode 데이터를 동일한 값으로 사용하고자하는 사용자의 목적에 부합할 수 있습니다. \\ \\
-. //useVisualBarcode// \\
-[+ 2.9.1] Visual barcode 사용여부 flag입니다. \\
-<WRAP group 50%>
-^지원장치  ^펌웨어  ^
-|XS2-Finger  |V1.2.0  |
-|XS2-Card  |V1.2.0  |
-|BS3  |V1.1.0  |
-</WRAP>
-Visual barcode는 QR code sensor가 아닌, 일반 visual camera를 통해 QR code 읽기를 지원하며, \\
-이 기능을 사용하기 위해서는, 별도의 라이선스 활성화가 필요합니다. \\
-라이선스 활성화는 [[BS2_EnableDeviceLicense]]를 통해 지원합니다. \\ \\
-. //motionSensitivity// \\
-[+ 2.9.1] Visual barcode에 대한, 모션 센서의 감도를 설정합니다. \\
-<WRAP group 50%>
-^값  ^매크로  ^설명  ^
-|0  |BS2_MOTION_SENSITIVITY_LOW  |낮음  |
-|1  |BS2_MOTION_SENSITIVITY_NORMAL  |중간  |
-|2  |BS2_MOTION_SENSITIVITY_HIGH  |높음  |
-</WRAP>
-. //visualCameraScanTimeout// \\
-[+ 2.9.1] Visual camera에대한 scan 시간을 설정합니다. 단위는 초입니다. \\
-기본값은 10초이며, 3~20초 범위 내로 입력 가능합니다. \\
-<WRAP group 50%>
-^값  ^매크로  ^설명  ^
-|10  |BS2_VISUAL_BARCODE_TIMEOUT_DEFAULT  |기본값  |
-|3  |BS2_VISUAL_BARCODE_TIMEOUT_MIN  |최소값  |
-|20  |BS2_VISUAL_BARCODE_TIMEOUT_MAX  |최대값  |
-</WRAP>
-. //reserved// \\
-예약된 공간입니다. \\
@@ 줄 3229: / 줄 3283: @@
 ==== BS2CustomCardConfig ====
 <code cpp>
+typedef struct {
+	uint8_t primaryKey[16];
+	uint8_t secondaryKey[16];
+	uint16_t startBlockIndex;
+	uint8_t dataSize;
+	uint8_t skipBytes;
+	uint8_t reserved[16];
+} BS2CustomMifareCardEx;
 typedef struct {
 	BS2_CARD_DATA_TYPE dataType;
@@ 줄 3236: / 줄 3299: @@
 	BS2CustomMifareCard mifare;
 	BS2CustomDesFireCard desfire;
-	uint8_t reserved2[24];
+	BS2CustomMifareCardEx mifareEx;
-	uint8_t reserved3[96];
+	BS2_MIFARE_ENCRYPTION mifareEncType;
+	uint8_t reserved3[67];
 	BS2_CARD_BYTE_ORDER smartCardByteOrder;
@@ 줄 3245: / 줄 3309: @@
 } BS2CustomCardConfig;
 </code>
-. //dataType// \\
+. //primaryKey// \\
+Mifare card 정보에 접근하기 위한 첫번째 암호화 키입니다. \\ \\
+. //secondaryKey// \\
+Mifare card 정보에 접근하기 위한 두번째 암호화 키입니다. \\ \\
+. //startBlockIndex// \\
+Mifare data storage에서의 start block index입니다. \\ \\
+. //datasize// \\
+카드 데이터가 몇 byte의 크기를 갖는지를 나타냅니다. \\ \\
+. //skipBytes// \\
+카드 데이터가 나타나는 위치를 의미합니다. \\
+카드 데이터를 읽어들일 시작점 입니다. 처음부터 읽을경우 0이고, 첫번째 이후일 경우 건너뛴 byte 수를 나타냅니다. \\ \\
+. //reserved// \\
+예약된 공간입니다. \\ \\
+. //dataType// \\
 Card의 데이터 유형입니다. \\
 <WRAP group 50%>
@@ 줄 3254: / 줄 3332: @@
 |3  |BCD  |
 </WRAP>
 . //useSecondaryKey// \\
 두번째 암호화 키 사용 유무를 결정하는 flag입니다. \\ \\
 . //reserved1// \\
 예약된 공간입니다. \\ \\
 . //mifare// \\
 Mifare custom card 정보를 설정합니다. \\ \\
 . //desfire// \\
 DESFire custom card 정보를 설정합니다. \\ \\
-. //reserved2// \\
+. //mifareEx// \\
-예약된 공간입니다. \\ \\
+[+2.9.9] 장치의 Mifare Custom Card 중에서 AES128 암호화 된 카드에 사용되는 설정 정보를 저장합니다. \\ \\
-. //reserved3// \\
+. //mifareEncType// \\
+[+2.9.9] Mifare Custom Card의 암호화 방식을 지정합니다. Mifare Classic 카드는 CRYPTO1만 지원하며, Mifare Plus 카드는 CRYPTO1과 AES128 모두 지원합니다. \\
+CRYPTO1으로 설정하면 BS2CustomMifareCard의 Mifare 설정이 적용되고, AES128로 설정하면 BS2CustomMifareConfigEx의 mifareEx 설정이 적용됩니다. \\
+<WRAP group 50%>
+^값  ^설명  ^
+|0  |CRYPTO1  |
+|1  |AES128  |
+</WRAP>
+. //reserved3// \\
 예약된 공간입니다. \\ \\
 . //smartCardByteOrder// \\
 MSB 또는 LSB로 출력을 지정할 수 있습니다. \\
 <WRAP group 50%>
@@ 줄 3273: / 줄 3359: @@
 |1  |LSB  |
 </WRAP>
 . //reserved4// \\
 예약된 공간입니다. \\ \\
 . //formatID// \\
 BioStar 2 애플리케이션에서 card configuration을 데이터베이스 관리할 필요가 있을 경우 사용할 수 있는 식별자입니다. \\ \\
 . //reserved5// \\
 예약된 공간입니다. \\ \\
+==== BS2MifareCardConfigEx ====
+<code cpp>
+typedef struct {
+    uint8_t primaryKey[16];
+    uint8_t secondaryKey[16];
+    uint16_t startBlockIndex;
+    uint8_t reserved[14];
+} BS2MifareCardEx;
+typedef struct {
+    BS2MifareCardEx mifareEx;
+    uint8_t reserved[16];
+} BS2MifareCardConfigEx;
+</code>
+. //primaryKey// \\
+Mifare card 정보에 접근하기 위한 첫번째 암호화 키입니다. \\
+\\
+. //secondaryKey// \\
+Mifare card 정보에 접근하기 위한 두번째 암호화 키입니다. \\
+\\
+. //startBlockIndex// \\
+Mifare data storage에서의 start block index입니다. \\
+\\
+. //reserved// \\
+예약된 공간입니다.
+==== BS2FacilityCodeConfig ====
+<code cpp>
+typedef struct{
+    uint8_t code[4];
+} BS2FacilityCode;
+typedef struct{
+        uint8_t numFacilityCode;
+        uint8_t reserved0[3];
+        BS2FacilityCode facilityCodes[16];
+        uint8_t reserved1[128];
+} BS2FacilityCodeConfig;
+</code>
+. //numFacilityCode// \\
+설정할 FacilityCode의 개수를 설정합니다. 최대 16개까지 지원합니다. \\ \\
+. //reserved0// \\
+예약된 공간입니다. \\ \\
+. //BS2FacilityCode// \\
+Door Interface(DI-24)와 마스터 장치의 OSDP 연결이 끊어진 경우 인증코드로 사용됩니다. \\ \\
+. //reserved1// \\
+예약된 공간입니다. \\ \\
+==== BS2Rs485ConfigEXDynamic ====
+<code cpp>
+typedef struct {
+    uint32_t   deviceID;       ///<
+    uint16_t   deviceType;     ///< 2 bytes
+    uint8_t    enableOSDP;     ///< 1 byte
+    uint8_t    connected;      ///< 1 bytes (packing)
+    union {
+            uint8_t         channelInfo;
+            uint32_t        parentID;
+    };
+} BS2Rs485SlaveDeviceEX;
+typedef struct {
+    uint32_t                baudRate;
+    uint8_t                 channelIndex;
+    uint8_t                 useRegistance;
+    uint8_t                 numOfDevices;
+    uint8_t                 channelType;
+    BS2Rs485SlaveDeviceEX  *slaveDevices;
+} BS2Rs485ChannelEXDynamic;
+typedef struct {
+    BS2_RS485_MODE mode[8];
+    uint16_t numOfChannels;
+    uint8_t reserved[2];
+    uint8_t reserved1[32];
+    BS2Rs485ChannelEXDynamic channels[8];
+} BS2Rs485ConfigEXDynamic;
+</code>
+<WRAP info>
+baudRate을 제외한 모든 값은 읽기 전용으로 변경이 불가능합니다. \\
+''지원 장치'': CoreStation 20(CS-20, CS-20P), Door Interface(DI-24)
+</WRAP>
+. //baudRate// \\
+RS485 통신 속도이며 설정할 수 있는 범위는 다음과 같습니다. \\
+<WRAP group 50%>
+^값  ^
+|9600  |
+|19200  |
+|38400  |
+|57600  |
+|115200  |
+</WRAP>
+. //channelIndex// \\
+RS485 network의 통신 채널 번호입니다. \\ \\
+. //useRegistance// \\
+종단 저항을 설정할지 결정하는 flag입니다. \\ \\
+. //numOfDevices// \\
+슬레이브 장치의 개수입니다. \\ \\
+. //channelType// \\
+해당 포트에 연결된 슬레이브 장치타입을 나타냅니다. \\
+<WRAP group 50%>
+^값  ^설명  ^
+|0  |연결이 없음  |
+|1  |슈프리마 장치  |
+|2  |OSDP 표준 장치  |
+|3  |더 이상 연결할 수 없음  |
+</WRAP>
+. //slaveDevices// \\
+장치에 연결된 슬레이브 장치를 나열한 포인터 \\
+<WRAP group 50%>
+포트별 연결가능한 최대 장치
+|Host 포트  |16개  |
+|0번 포트  |2개  |
+|1번 포트  |2개  |
+</WRAP>
+. //mode// \\
+RS485 네트워크에서 어떤 모드로 동작할지 결정하는 flag입니다. \\
+<WRAP group 50%>
+^값  ^설명  ^
+|1  |Master  |
+|2  |Slave  |
+|3  |Standalone  |
+</WRAP>
+<WRAP info>
+CoreStation은 Master로만 사용 가능합니다. 다른 값은 설정할 수 없습니다.
+</WRAP>
+. //numOfChannels// \\
+RS485 채널의 개수입니다.\\ \\
+. //reserved// \\
+예약된 공간입니다.\\ \\
+. //reserved1// \\
+예약된 공간입니다.\\ \\
+. //channels// \\
+RS485 채널을 나열한 리스트로 최대 8개까지 설정할 수 있습니다.\\ \\