차이

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

차이 보기로 링크

양쪽 이전 판 이전 판
다음 판 		이전 판
ko:configuration_api [2024/05/28 19:06]
kkshin [BS2DisplayConfig] 		ko:configuration_api [2025/06/13 10:46] (현재)
줄 92: 줄 92:
   * [[BS2_GetCustomCardConfig]]:​ [+ 2.9.4] Custom smart card 설정을 가져옵니다.   * [[BS2_GetCustomCardConfig]]:​ [+ 2.9.4] Custom smart card 설정을 가져옵니다.
   * [[BS2_SetCustomCardConfig]]:​ [+ 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 ==== ==== BS2FactoryConfig ====
줄 389: 줄 395:
     uint8_t showOsdpResult;​     uint8_t showOsdpResult;​
     uint8_t reserved1[30];​     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;​ } BS2DisplayConfig;​
 </​code>​ </​code>​
줄 503: 줄 517:
 </​WRAP>​ </​WRAP>​
 19. //​reserved1//​ \\  19. //​reserved1//​ \\ 
-예약된 공간입니다. \\  +예약된 공간입니다. ​\\ \\ 
 +20. //​authMsgUserName//​ \\  
 +[+2.9.8] 장치 화면에 표시되는 인증 결과 메시지에 포함된 사용자 이름의 표시 방법을 설정합니다. \\  
 +<WRAP group 50%> 
 +^값  ^설명 ​ ^ 
 +|0  |전체 표시 ​ | 
 +|1  |첫 문자만 표시 ​ | 
 +|2  |표시 안함 ​ | 
 +</​WRAP>​ 
 +21. //​authMsgUserID//​ \\ 
 +[+2.9.8] ​ 장치 화면에 표시되는 인증 결과 메시지에 포함된 사용자 ID의 표시 방법을 설정합니다. \\ 
 +<WRAP group 50%> 
 +^값  ^설명 ​ ^ 
 +|0  |전체 표시 ​ | 
 +|1  |첫 문자만 표시 ​ | 
 +|2  |표시 안함 ​ | 
 +</​WRAP>​ 
 +22. //​scrambleKeyboardMode//​ \\ 
 +[+2.9.8] 스크램블 키패드의 사용 여부를 설정합니다. \\ 
 +<WRAP group 50%> 
 +^값  ^설명 ​ ^ 
 +|0  |사용 ​ | 
 +|1  |사용 안함 ​ | 
 +</​WRAP>​
 ==== BS2IpConfig ==== ==== BS2IpConfig ====
 <code cpp> <code cpp>
줄 678: 줄 714:
     uint8_t cipher;     uint8_t cipher;
     uint8_t smartCardByteOrder;​     uint8_t smartCardByteOrder;​
-    uint8_t reserved[22];+    uint8_t reserved[1]; 
 +    uint8_t mifareEncType;​ 
 +    uint8_t reserved[20];
 } BS2CardConfig;​ } BS2CardConfig;​
 </​code>​ </​code>​
줄 760: 줄 798:
 </​WRAP>​ </​WRAP>​
 25. //​reserved//​ \\  25. //​reserved//​ \\ 
 +예약된 공간입니다. \\ 
 +26. //​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>​
 +27. //​reserved//​ \\ 
 예약된 공간입니다. \\  예약된 공간입니다. \\ 
 ==== BS2FingerprintConfig ==== ==== BS2FingerprintConfig ====
줄 911: 줄 962:
 <WRAP group 50%> <WRAP group 50%>
 ^값  ^설명 ​ ^ ^값  ^설명 ​ ^
-|0  |사용안함 ​ | 
 |1  |Master ​ | |1  |Master ​ |
 |2  |Slave ​ | |2  |Slave ​ |
줄 1117: 줄 1167:
     uint8_t numInputs;     uint8_t numInputs;
     uint8_t numSupervised;​     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 {     struct {
         uint8_t portIndex;         uint8_t portIndex;
줄 1157: 줄 1216:
 |255  |사용자 정의 ​ | |255  |사용자 정의 ​ |
 </​WRAP>​ </​WRAP>​
-12. //reserved// \\  +12. //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>​
 13. //config// \\  13. //config// \\ 
 supervised 입력 신호 유형을 판단하는 설정값으로,​ supervised input의 저항값이 사용자 정의일 경우에만 의미가 있습니다. \\  supervised 입력 신호 유형을 판단하는 설정값으로,​ supervised input의 저항값이 사용자 정의일 경우에만 의미가 있습니다. \\ 
줄 1744: 줄 1811:
 |1  |옥외 ​ | |1  |옥외 ​ |
 |2  |자동 ​ | |2  |자동 ​ |
-|3  |[+ 2.8] 사용 안함 ​''​(FaceStation F2)'' ​ |+|3  |[+ 2.8] 사용 안함 ​ |
 </​WRAP>​ </​WRAP>​
 3. //​enrollThreshold//​ \\  3. //​enrollThreshold//​ \\ 
줄 1771: 줄 1838:
 </​WRAP>​ </​WRAP>​
 5. //​enrollTimeout//​ \\  5. //​enrollTimeout//​ \\ 
-''​FaceStation2,​ FaceLite''​ : 얼굴 스캔 대기 시간으로 기본값은 60초입니다. \\ +''​IR Face 기반''​ : 얼굴 스캔 대기 시간으로 기본값은 60초입니다. \\ 
 <WRAP group 60%> <WRAP group 60%>
 ^값  ^설명 ​ ^ ^값  ^설명 ​ ^
줄 1778: 줄 1845:
 |BS2_FACE_ENROLL_TIMEOUT_DEFAULT ​ |BS2_FACE_ENROLL_TIMEOUT_MAX ​ | |BS2_FACE_ENROLL_TIMEOUT_DEFAULT ​ |BS2_FACE_ENROLL_TIMEOUT_MAX ​ |
 </​WRAP>​ </​WRAP>​
-''​FaceStation F2''​ : [+ V2.7.1] ​ 얼굴 스캔 대기 시간으로 기본값은 20초입니다. \\ +''​Visual Face 기반''​ : [+ V2.7.1] ​ 얼굴 스캔 대기 시간으로 기본값은 20초입니다. \\ 
 <WRAP group 70%> <WRAP group 70%>
 ^값  ^설명 ​ ^ ^값  ^설명 ​ ^
줄 1787: 줄 1854:
 6. //​lfdLevel//​ \\ 6. //​lfdLevel//​ \\
 [+ 2.6.3] 위조된 얼굴을 여과할 수 있는 민감도를 설정할 수 있습니다. \\ [+ 2.6.3] 위조된 얼굴을 여과할 수 있는 민감도를 설정할 수 있습니다. \\
-''​FaceStation2,​ FaceLite''​ : 기본값은 0입니다. \\ +''​IR Face 기반''​ : 기본값은 0입니다. \\ 
-''​FaceStation F2''​ : [+ 2.7.1] 기본값이 1입니다. \\+''​Visual Face 기반''​ : [+ 2.7.1] 기본값이 1입니다. \\
 <WRAP group 50%> <WRAP group 50%>
 ^값  ^설명 ​ ^ ^값  ^설명 ​ ^
줄 1820: 줄 1887:
 </​WRAP> ​ </​WRAP> ​
  
-''​FaceStation F2 V1.0.1''​이상,​ ''​BioStatoin 3'',​ ''​BioEntry W3''​는 아래와 같은 의미로 사용됩니다.+''​FaceStation F2 V1.0.1''​이상,​ ''​Visual Face 기반''​는 아래와 같은 의미로 사용됩니다.
 <WRAP group 50%> <WRAP group 50%>
 ^값  ^모드 ​ ^설명 ​ ^기본값 ​ ^ ^값  ^모드 ​ ^설명 ​ ^기본값 ​ ^
줄 1827: 줄 1894:
 </​WRAP> ​ </​WRAP> ​
 11. //​maxRotation//​ \\  11. //​maxRotation//​ \\ 
-[+ 2.7.1] ''​FaceStation F2''​ 일반적인 상황에서 얼굴을 검출할 때 얼굴의 방향은 정면일 것입니다. \\ +[+ 2.7.1] ''​Visual Face 기반''​ 일반적인 상황에서 얼굴을 검출할 때 얼굴의 방향은 정면일 것입니다. \\ 
-FaceStation F2는 얼굴 검출 시 정면에서 어느 정도 회전된(왜곡된) 이미지인지 판단할 수 있습니다. \\+이 경우 장치는 얼굴 검출 시 정면에서 어느 정도 회전된(왜곡된) 이미지인지 판단할 수 있습니다. \\
 이를 통해 일정 각도 이상 회전된 이미지의 경우 검출 실패 처리를 할 수 있습니다. \\ 이를 통해 일정 각도 이상 회전된 이미지의 경우 검출 실패 처리를 할 수 있습니다. \\
 maxRotation은 이런 경우의 최대 허용치를 나타내며 기본값은 15도입니다. \\ \\ maxRotation은 이런 경우의 최대 허용치를 나타내며 기본값은 15도입니다. \\ \\
줄 1844: 줄 1911:
 </​WRAP> ​ </​WRAP> ​
 12. //​faceWidth//​ \\  12. //​faceWidth//​ \\ 
-[+ 2.7.1] ''​FaceStation F2''​ 얼굴 이미지의 폭을 나타내며 폭의 최소값, 최대값을 지정할 수 있습니다. \\ +[+ 2.7.1] ''​Visual Face 기반''​ 얼굴 이미지의 폭을 나타내며 폭의 최소값, 최대값을 지정할 수 있습니다. \\ 
 최소값, 최대값의 기본값은 아래와 같습니다. \\ 최소값, 최대값의 기본값은 아래와 같습니다. \\
 <WRAP group 30%> <WRAP group 30%>
줄 1853: 줄 1920:
 </​WRAP> ​ </​WRAP> ​
 13. //​searchRange//​ \\ 13. //​searchRange//​ \\
-[+ 2.7.1] ''​FaceStation F2''​ 얼굴 감지 범위를 나타내며 범위의 x값(가로 좌표)과 x값으로부터의 폭을 지정할 수 있습니다. \\ +[+ 2.7.1] ''​Visual Face 기반''​ 얼굴 감지 범위를 나타내며 범위의 x값(가로 좌표)과 x값으로부터의 폭을 지정할 수 있습니다. \\ 
 x값과 폭의 기본값은 아래와 같습니다. \\ x값과 폭의 기본값은 아래와 같습니다. \\
 <WRAP group 30%> <WRAP group 30%>
줄 1862: 줄 1929:
 </​WRAP> ​ </​WRAP> ​
 14. //​detectDistance//​ \\ 14. //​detectDistance//​ \\
-[+ 2.8.3] ''​BioStation 3''​ 얼굴 감지 거리의 최소값과 최대값을 설정합니다. \\ +[+ 2.8.3] ''​Visual Face 기반''​ 얼굴 감지 거리의 최소값과 최대값을 설정합니다. \\
-[+ 2.9.6] ''​FaceStation F2''​ ''​BioEntry W3''​ 기능추가. \\+
 픽셀 단위로 얼굴 위치를 지정하는 faceWidth는 사용하기 난해하므로 더 이상 사용하지 않습니다. \\ 픽셀 단위로 얼굴 위치를 지정하는 faceWidth는 사용하기 난해하므로 더 이상 사용하지 않습니다. \\
 대신 피사체(얼굴)의 감지 거리를 얼마로 할지 만 정합니다. 거리는 cm로 설정하며,​ 10의 배수로 입력하여야 합니다. \\ 대신 피사체(얼굴)의 감지 거리를 얼마로 할지 만 정합니다. 거리는 cm로 설정하며,​ 10의 배수로 입력하여야 합니다. \\
줄 1873: 줄 1939:
 </​WRAP> ​ </​WRAP> ​
 15. //​wideSearch//​ \\ 15. //​wideSearch//​ \\
-[+ 2.8.3] ''​BioStation 3''​ 얼굴 감지 범위를 넓힙니다. \\+[+ 2.8.3] ''​BioStation 3, BioEntry W3''​ 얼굴 감지 범위를 넓힙니다. \\
 x좌표와 width를 지정해야하는 난해한 설정인 searchRange는 더 이상 사용하지 않습니다. \\ x좌표와 width를 지정해야하는 난해한 설정인 searchRange는 더 이상 사용하지 않습니다. \\
 대신 얼굴 감지를 표준(false) 설정으로 할지, 광역(true)으로 할지 여부만 지정합니다. \\ 대신 얼굴 감지를 표준(false) 설정으로 할지, 광역(true)으로 할지 여부만 지정합니다. \\
줄 1930: 줄 1996:
 <WRAP group 50%> <WRAP group 50%>
 ^값  ^설명 ​ ^ ^값  ^설명 ​ ^
-|0  |사용안함 ​ | 
 |1  |Master ​ | |1  |Master ​ |
 |2  |Slave ​ | |2  |Slave ​ |
 |3  |Standalone ​ | |3  |Standalone ​ |
 +</​WRAP>​
 +<WRAP info>
 +CoreStation은 Master로만 사용 가능합니다. 다른 값은 설정할 수 없습니다.
 </​WRAP>​ </​WRAP>​
 7. //​numOfChannels//​ \\  7. //​numOfChannels//​ \\ 
줄 2376: 줄 2444:
 </​WRAP>​ </​WRAP>​
 2. //​maskCheckMode//​ \\  2. //​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%> <WRAP group 50%>
 ^값  ^설명 ​ ^기본값 ​ ^ ^값  ^설명 ​ ^기본값 ​ ^
줄 2388: 줄 2455:
 |1  |마스크 착용 감지 사용 (HARD) ​ |  | |1  |마스크 착용 감지 사용 (HARD) ​ |  |
 |2  |마스크 착용 감지 사용 (SOFT) ​ |  | |2  |마스크 착용 감지 사용 (SOFT) ​ |  |
 +|3  |마스크 착용 금지 ​ |  |
 </​WRAP>​ </​WRAP>​
 3. //​reserved//​ \\  3. //​reserved//​ \\ 
줄 2401: 줄 2469:
 예약된 공간입니다. \\ \\ 예약된 공간입니다. \\ \\
 6. //​thermalThresholdLow//​ \\ 6. //​thermalThresholdLow//​ \\
-''​지원 버전''​ : ''​FaceStation F2 V1.0.2'',​ ''​FaceStation 2 V1.5.0''​ \\  
 고열 판단 기준의 범위값이며,​ 설정 할 온도의 100을 곱한 값으로 입력하여야 합니다. \\ 고열 판단 기준의 범위값이며,​ 설정 할 온도의 100을 곱한 값으로 입력하여야 합니다. \\
 또한 섭씨 기준으로만 입력할 수 있습니다. \\ 또한 섭씨 기준으로만 입력할 수 있습니다. \\
줄 2414: 줄 2481:
 그리고 thermalThresholdLow보다 큰 값을 설정 하여야 합니다. \\ \\ 그리고 thermalThresholdLow보다 큰 값을 설정 하여야 합니다. \\ \\
 8. //​maskDetectionLevel//​ \\ 8. //​maskDetectionLevel//​ \\
-''​FaceStation F2''​ 마스크 착용 감지 수준을 입력합니다. 여기서 감지 수준은 내부적으로 설정된 값에 근거합니다. \\ +''​Visual Face 기반''​ 마스크 착용 감지 수준을 입력합니다. 여기서 감지 수준은 내부적으로 설정된 값에 근거합니다. \\
-''​FaceStation 2''​ 이 설정은 무시됩니다. \\ +
 <WRAP group 50%> <WRAP group 50%>
 ^값  ^설명 ​ ^기본값 ​ ^ ^값  ^설명 ​ ^기본값 ​ ^
줄 2546: 줄 2612:
     uint8_t ​   numInputs;     uint8_t ​   numInputs;
     uint8_t ​   numSupervised;​     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 {     struct {
줄 2555: 줄 2633:
         uint8_t ​   reserved;         uint8_t ​   reserved;
         uint8_t ​   supervisedResistor;​         uint8_t ​   supervisedResistor;​
-        ​uint8_t ​   reserved1[16];+        ​BS2SupervisedInputConfig ​ supervisedConfig;
     ​     ​
         uint8_t ​   reserved2[26];​         uint8_t ​   reserved2[26];​
줄 2567: 줄 2645:
 2. //​numSupervised//​ \\ 2. //​numSupervised//​ \\
 supervised input 포트의 개수입니다. \\ \\ supervised input 포트의 개수입니다. \\ \\
-3. //​reserved//​ \\+3. //​tamperAuxIndex,​ acFailAuxIndex,​ fireAuxIndex//​ \\ 
 +[+2.9.9] Aux 입력을 설정합니다. 4bit 크기이며 CS20, DI24는 고정되어 있고 변경할 수 없습니다. \\ 
 +<WRAP group 50%> 
 +^Aux이름 ​ ^인덱스 ​ ^ 
 +|AC Fail  |0  | 
 +|TAMPER ​ |1  | 
 +|FIRE  |2  | 
 +</​WRAP>​  
 +4. //aux0Type, aux1Type, aux2Type// \\ 
 +[+2.9.9] Aux 입력 신호 유형을 설정합니다. \\ 
 +<WRAP group 50%> 
 +^값  ^설명 ​ ^ 
 +|0  |Normally Open  | 
 +|1  |Normally Closed ​ | 
 +</​WRAP>​ 
 +5. //​reserved//​ \\
 예약된 공간입니다. \\ \\ 예약된 공간입니다. \\ \\
-4. //​portIndex//​ \\ +6. //​portIndex//​ \\ 
 Input 포트 번호입니다. \\ \\ Input 포트 번호입니다. \\ \\
-5. //​switchType//​ \\+7. //​switchType//​ \\
 Input 신호 유형입니다. \\  Input 신호 유형입니다. \\ 
 <WRAP group 50%> <WRAP group 50%>
줄 2578: 줄 2671:
 |1  |Normally Closed ​ | |1  |Normally Closed ​ |
 </​WRAP> ​ </​WRAP> ​
-6. //​duration//​ \\ +8. //​duration//​ \\ 
 Input 신호의 지속시간으로 단위는 밀리초(ms)입니다. \\ \\ Input 신호의 지속시간으로 단위는 밀리초(ms)입니다. \\ \\
-7. //​reserved//​ \\+9. //​reserved//​ \\
 예약된 공간입니다. \\ \\ 예약된 공간입니다. \\ \\
-8. //​supervisedResistor//​ \\+10. //​supervisedResistor//​ \\
 Supervised input 저항 값의 유형을 설정하거나,​ 해제할 수(unsupervised) 있습니다. \\ Supervised input 저항 값의 유형을 설정하거나,​ 해제할 수(unsupervised) 있습니다. \\
 <WRAP group 50%> <WRAP group 50%>
줄 2592: 줄 2685:
 |254  |Unsupervised(기본값) ​ | |254  |Unsupervised(기본값) ​ |
 </​WRAP> ​ </​WRAP> ​
-9. //reserved1// \\+11. //reserved2// \\
 예약된 공간입니다. \\ \\ 예약된 공간입니다. \\ \\
-10. //​reserved2//​ \\ +12. //​reserved2//​ \\
-예약된 공간입니다. \\ \\ +
-11. //​reserved2//​ \\+
 예약된 공간입니다. \\ \\ 예약된 공간입니다. \\ \\
  
줄 2704: 줄 2795:
     BS2ExtensionNumber phonebook[128];​     BS2ExtensionNumber phonebook[128];​
  
-    uint8_t reserved2[32];        ///< ​32 bytes (reserved)+    ​uint8_t resolution;​ 
 +    uint8_t transport;​ 
 +    ​uint8_t reserved2[30]; ///< ​30 bytes (reserved)
 } BS2VoipConfigExt;​ } BS2VoipConfigExt;​
 </​code>​ </​code>​
줄 2758: 줄 2851:
 22. //​phonebook//​ \\ 22. //​phonebook//​ \\
 128개까지 내선 번호들을 전화번호부로 지정할 수 있습니다. \\ \\ 128개까지 내선 번호들을 전화번호부로 지정할 수 있습니다. \\ \\
-23. //​reserved2//​ \\+23. //​resolution//​ \\ 
 +[+2.9.8] 송신 비디오 해상도를 설정합니다. 
 +<WRAP group 50%> 
 +^값  ^설명 ​ ^ 
 +|0  |360 x 640  | 
 +|1  |720 x 480  | 
 +</​WRAP>​  
 +24. //​transport//​ \\ 
 +[+2.9.8] 데이터 전송 방식을 설정합니다. 
 +<WRAP group 50%> 
 +^값  ^설명 ​ ^ 
 +|0  |UDP  | 
 +|1  |TCP  | 
 +|2  |SSL  | 
 +</​WRAP>​ 
 +25. //​reserved2//​ \\
 예약된 공간입니다. \\ \\ 예약된 공간입니다. \\ \\
  
줄 2772: 줄 2880:
     BS2_PORT port;     BS2_PORT port;
     BS2_BOOL enabled;     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;​ } BS2RtspConfig;​
 </​code>​ </​code>​
줄 2789: 줄 2898:
 6. //​reserved//​ \\ 6. //​reserved//​ \\
 예약된 공간입니다. \\ \\ 예약된 공간입니다. \\ \\
-7. //​reserved2//​ \\+7. //​resolution//​ \\ 
 +[+2.9.8] 송신 비디오 해상도를 설정합니다. 
 +<WRAP group 30%> 
 +^값  ^설명 ​ ^ 
 +|0  |180 x 320  | 
 +|1  |720 x 480  | 
 +</​WRAP>​  
 +8. //​reserved2//​ \\
 예약된 공간입니다. \\ \\ 예약된 공간입니다. \\ \\
  
줄 2861: 줄 2977:
 5. //​reserved1//​ \\  5. //​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>​ 
-1. //​useBarcode//​ \\  
-''​XS2-QR 만 지원''​ 
-Barcode 사용여부 flag입니다. \\ \\  
-2. //​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>​ 
-3. //​bypassData//​ \\  
-[+2.8.2] 읽혀진 barcode 정보를 장치에서 처리하지 않고, 서버로 전송하기 위해 사용합니다. \\ 
-사용자 인증을 위해 사용자 정보 구조체에 barcode 값을 저장하게되는 경우, \\ 
-32 byte의 크기 제약([[smartcard_api#​BS2CSNCard|BS2CSNCard data 참조]])이 있으나, \\ 
-[[BS2_SetBarcodeScanListener]]를 호출하고,​ 이 옵션을 사용하면 최대 512 byte크기의 barcode를 서버로 전송할 수 있습니다. \\ \\ 
-4. //​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 데이터를 동일한 값으로 사용하고자하는 사용자의 목적에 부합할 수 있습니다. \\ \\ 
-5. //​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]]를 통해 지원합니다. \\ \\ 
-6. //​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>​ 
-7. //​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>​ 
-8. //​reserved//​ \\  
-예약된 공간입니다. \\ 
  
  
줄 3237: 줄 3283:
 ==== BS2CustomCardConfig ==== ==== BS2CustomCardConfig ====
 <code cpp> <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 { typedef struct {
  BS2_CARD_DATA_TYPE dataType;  BS2_CARD_DATA_TYPE dataType;
줄 3244: 줄 3299:
  BS2CustomMifareCard mifare;  BS2CustomMifareCard mifare;
  BS2CustomDesFireCard desfire;  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;​  BS2_CARD_BYTE_ORDER smartCardByteOrder;​
줄 3253: 줄 3309:
 } BS2CustomCardConfig;​ } BS2CustomCardConfig;​
 </​code>​ </​code>​
-1. //​dataType//​ \\ +1. //​primaryKey//​ \\ 
 +Mifare card 정보에 접근하기 위한 첫번째 암호화 키입니다. \\ \\ 
 +2. //​secondaryKey//​ \\ 
 +Mifare card 정보에 접근하기 위한 두번째 암호화 키입니다. \\ \\ 
 +3. //​startBlockIndex//​ \\ 
 +Mifare data storage에서의 start block index입니다. \\ \\ 
 +4. //​datasize//​ \\ 
 +카드 데이터가 몇 byte의 크기를 갖는지를 나타냅니다. \\ \\ 
 +5. //​skipBytes//​ \\ 
 +카드 데이터가 나타나는 위치를 의미합니다. \\ 
 +카드 데이터를 읽어들일 시작점 입니다. 처음부터 읽을경우 0이고, 첫번째 이후일 경우 건너뛴 byte 수를 나타냅니다. \\ \\ 
 +6. //​reserved//​ \\ 
 +예약된 공간입니다. \\ \\ 
 + 
 +7. //​dataType//​ \\ 
 Card의 데이터 유형입니다. \\  Card의 데이터 유형입니다. \\ 
 <WRAP group 50%> <WRAP group 50%>
줄 3262: 줄 3332:
 |3  |BCD  | |3  |BCD  |
 </​WRAP>​ </​WRAP>​
-2. //​useSecondaryKey//​ \\ +8. //​useSecondaryKey//​ \\ 
 두번째 암호화 키 사용 유무를 결정하는 flag입니다. \\ \\  두번째 암호화 키 사용 유무를 결정하는 flag입니다. \\ \\ 
-3. //​reserved1//​ \\ +9. //​reserved1//​ \\ 
 예약된 공간입니다. \\ \\  예약된 공간입니다. \\ \\ 
-4. //mifare// \\ +10. //mifare// \\ 
 Mifare custom card 정보를 설정합니다. \\ \\  Mifare custom card 정보를 설정합니다. \\ \\ 
-5. //desfire// \\ +11. //desfire// \\ 
 DESFire custom card 정보를 설정합니다. \\ \\  DESFire custom card 정보를 설정합니다. \\ \\ 
-6. //reserved2// \\  +12. //mifareEx// \\ 
-예약된 공간입니다. \\ \\  +[+2.9.9] 장치의 Mifare Custom Card 중에서 AES128 암호화 ​된 카드에 사용되는 설정 정보를 저장합니다. \\ \\ 
-7. //​reserved3//​ \\ +13. //​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>​ 
 +14. //​reserved3//​ \\ 
 예약된 공간입니다. \\ \\  예약된 공간입니다. \\ \\ 
-8. //​smartCardByteOrder//​ \\+15. //​smartCardByteOrder//​ \\
 MSB 또는 LSB로 출력을 지정할 수 있습니다. \\ MSB 또는 LSB로 출력을 지정할 수 있습니다. \\
 <WRAP group 50%> <WRAP group 50%>
줄 3281: 줄 3359:
 |1  |LSB  | |1  |LSB  |
 </​WRAP>​ </​WRAP>​
-9. //​reserved4//​ \\ +16. //​reserved4//​ \\ 
 예약된 공간입니다. \\ \\  예약된 공간입니다. \\ \\ 
-10. //​formatID//​ \\ +17. //​formatID//​ \\ 
 BioStar 2 애플리케이션에서 card configuration을 데이터베이스 관리할 필요가 있을 경우 사용할 수 있는 식별자입니다. \\ \\  BioStar 2 애플리케이션에서 card configuration을 데이터베이스 관리할 필요가 있을 경우 사용할 수 있는 식별자입니다. \\ \\ 
-11. //​reserved5//​ \\ +18. //​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>​
 +1. //​primaryKey//​ \\ 
 +Mifare card 정보에 접근하기 위한 첫번째 암호화 키입니다. \\
 +\\
 +2. //​secondaryKey//​ \\
 +Mifare card 정보에 접근하기 위한 두번째 암호화 키입니다. \\
 +\\
 +3. //​startBlockIndex//​ \\
 +Mifare data storage에서의 start block index입니다. \\
 +\\
 +4. //​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>​
 +1. //​numFacilityCode//​ \\
 +설정할 FacilityCode의 개수를 설정합니다. 최대 16개까지 지원합니다. \\ \\
 +2. //​reserved0//​ \\
 +예약된 공간입니다. \\ \\
 +3. //​BS2FacilityCode//​ \\
 +Door Interface(DI-24)와 마스터 장치의 OSDP 연결이 끊어진 경우 인증코드로 사용됩니다. \\ \\
 +4. //​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>​
 +1. //​baudRate//​ \\ 
 +RS485 통신 속도이며 설정할 수 있는 범위는 다음과 같습니다. \\
 +<WRAP group 50%>
 +^값  ^
 +|9600  |
 +|19200 ​ |
 +|38400 ​ |
 +|57600 ​ |
 +|115200 ​ |
 +</​WRAP>​
 +2. //​channelIndex//​ \\ 
 +RS485 network의 통신 채널 번호입니다. \\ \\
 +3. //​useRegistance//​ \\ 
 +종단 저항을 설정할지 결정하는 flag입니다. \\ \\
 +4. //​numOfDevices//​ \\ 
 +슬레이브 장치의 개수입니다. \\ \\
 +5. //​channelType//​ \\
 +해당 포트에 연결된 슬레이브 장치타입을 나타냅니다. \\
 +<WRAP group 50%>
 +^값  ^설명 ​ ^
 +|0  |연결이 없음 ​ |
 +|1  |슈프리마 장치 ​ |
 +|2  |OSDP 표준 장치 ​ |
 +|3  |더 이상 연결할 수 없음 ​ |
 +</​WRAP>​
 +6. //​slaveDevices//​ \\ 
 +장치에 연결된 슬레이브 장치를 나열한 포인터 \\
 +<WRAP group 50%>
 +포트별 연결가능한 최대 장치
 +|Host 포트 ​ |16개 ​ |
 +|0번 포트 ​ |2개  |
 +|1번 포트 ​ |2개  |
 +</​WRAP>​
 +7. //mode// \\ 
 +RS485 네트워크에서 어떤 모드로 동작할지 결정하는 flag입니다. \\
 +<WRAP group 50%>
 +^값  ^설명 ​ ^
 +|1  |Master ​ |
 +|2  |Slave ​ |
 +|3  |Standalone ​ |
 +</​WRAP>​
 +<WRAP info>
 +CoreStation은 Master로만 사용 가능합니다. 다른 값은 설정할 수 없습니다.
 +</​WRAP>​
 +8. //​numOfChannels//​ \\ 
 +RS485 채널의 개수입니다.\\ \\ 
 +9. //​reserved//​ \\ 
 +예약된 공간입니다.\\ \\ 
 +10. //​reserved1//​ \\ 
 +예약된 공간입니다.\\ \\
 +11. //​channels//​ \\ 
 +RS485 채널을 나열한 리스트로 최대 8개까지 설정할 수 있습니다.\\ \\ 
 +