차이

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

--- ko:log_management_api [2023/10/05 14:34]
kkshin [BS2Event]
+++ ko:log_management_api [2026/03/11 15:49] (현재)
@@ 줄 5: / 줄 5: @@
   * [[BS2_GetLog]]: 일정량의 로그를 가져옵니다.
-  * [[BS2_GetFilteredLog]]: 조건에 맞는 로그를 가져옵니다.
+  * [[BS2_GetFilteredLog]]: ''[지원중단]'' 조건에 맞는 로그를 가져옵니다.
   * [[BS2_ClearLog]]: 모든 로그를 삭제합니다.
   * [[BS2_StartMonitoringLog]]: 실시간 로그 스트리밍을 시작합니다.
@@ 줄 11: / 줄 11: @@
   * [[BS2_StopMonitoringLog]]: 실시간 로그 스트리밍을 중단합니다.
   * [[BS2_GetLogBlob]]: EventMask에 맞게 일정량의 로그를 가져옵니다.
-  * [[BS2_GetFilteredLogSinceEventId]]: 조건에 맞는 로그를 가져옵니다.
+  * [[BS2_GetFilteredLogSinceEventId]]: ''[지원중단]'' 조건에 맞는 로그를 가져옵니다.
   * [[BS2_GetImageLog]]: 이미지로그를 가져옵니다.
   * [[BS2_GetLogSmallBlob]]: [+ 2.6.4] 효율적으로 메모리를 사용하면서, EventMask에 맞게 일정량의 로그를 가져옵니다.
   * [[BS2_GetLogSmallBlobEx]]: [+ 2.7.1] 효율적으로 메모리를 사용하면서, EventMask를 사용해서 체온정보를 포함한 로그를 가져옵니다.
+  * [[BS2_GetDeviceIOStatus]]: [+ 2.9.12] 현재 장치의 입출력 포트 상태를 가져옵니다.
+  * [[BS2_GetAllDeviceIOStatus]]: [+ 2.9.12] 현재 장치 및 슬레이브 장치들의 입출력 포트 상태를 가져옵니다.
 ===== 콜백 함수 =====
 ==== OnLogReceived ====
@@ 줄 78: / 줄 79: @@
             uint8_t reserved[28];
         } relayAction;
+        struct {
+            BS2_DEVICE_ID deviceId;
+            uint8_t data[28];
+        } osdpStandard;
     };
     union {
@@ 줄 141: / 줄 146: @@
 . //relayAction.inputPort// \\
 IM-120에서 RelayAction 동작 시 input의 port 식별자입니다. \\ \\
-. //subCode// \\
+. //osdpStandard.deviceId// \\
+OSDP standard 장치의 식별자입니다. \\ \\
+. //osdpStandard.data// \\
+OSDP standard 장치에서 발생된 총 28byte 크기의 알림 구조체 정보입니다. \\
+구조체에 대한 상세한 정보는 [[slave_control_api#BS2OsdpStandardDeviceNotify|BS2OsdpStandardDeviceNotify]]를 참조하세요. \\ \\
+. //subCode// \\
 로그 유형의 하위 코드 값입니다. 추가 정보가 필요할 경우 사용하십시오. \\
 ^범주  ^이벤트 코드  ^값  ^설명  ^
@@ 줄 171: / 줄 181: @@
 |::: |BS2_SUB_EVENT_VERIFY_MOBILE_CARD_FACE_FINGER  |0x20  |Mobile카드, 얼굴, 지문 인증 성공 (+2.8)  |
 |::: |BS2_SUB_EVENT_VERIFY_MOBILE_CARD_FINGER_FACE  |0x21  |Mobile카드, 지문, 얼굴 인증 성공 (+2.8)  |
+|::: |BS2_SUB_EVENT_VERIFY_QR  |0x25  |QR 인증 성공  |
+|::: |BS2_SUB_EVENT_VERIFY_QR_PIN  |0x26  |QR, PIN 인증 성공  |
+|::: |BS2_SUB_EVENT_VERIFY_QR_FINGER  |0x27  |QR, finger 인증 성공  |
+|::: |BS2_SUB_EVENT_VERIFY_QR_FINGER_PIN  |0x28  |QR, finger, PIN 인증 성공  |
+|::: |BS2_SUB_EVENT_VERIFY_QR_FACE  |0x29  |QR, face 인증 성공  |
+|::: |BS2_SUB_EVENT_VERIFY_QR_FACE_PIN  |0x2A  |QR, face, PIN 인증 성공  |
+|::: |BS2_SUB_EVENT_VERIFY_QR_FACE_FINGER  |0x2B  |QR, face, finger 인증 성공  |
+|::: |BS2_SUB_EVENT_VERIFY_QR_FINGER_FACE  |0x2C  |QR, finger, face 인증 성공  |
 |Identify  |BS2_SUB_EVENT_IDENTIFY_FINGER  |0x01  |지문 인증으로 사용자 식별  |
 |::: |BS2_SUB_EVENT_IDENTIFY_FINGER_PIN  |0x02  |지문과 PIN 인증으로 사용자 식별  |
@@ 줄 206: / 줄 224: @@
 |::: |BS2_SUB_EVENT_CREDENTIAL_AOC_FINGER  |0x07  |유효하지 않은 AOC 지문  |
 |::: |BS2_SUB_EVENT_CREDENTIAL_MOBILE_CARD  |0x08  |유효하지 않은 Mobile카드 (+2.8)  |
-|::: |BS2_SUB_EVENT_CREDENTIAL_QR  |0x09  |유효하지 않은 QR (+2.8.3)  |
+|::: |BS2_SUB_EVENT_NON_NUMERIC_QR  |0x09  |QR에 숫자가 아닌 문자가 포함됨  |
+|::: |BS2_SUB_EVENT_CREDENTIAL_QR  |0x0C  |유효하지 않은 QR (+2.8.3)  |
+|::: |BS2_SUB_EVENT_NON_PRINTABLE_QR  |0x0A  |QR에 사용 불가능한 제어문자가 포함됨  |
+|::: |BS2_SUB_EVENT_TOO_LONG_QR  |0x0B  |QR로 너무 긴 문자열이 사용됨  |
 |Auth  |BS2_SUB_EVENT_AUTH_FAIL_INVALID_AUTH_MODE  |0x01  |유효하지 않은 인증 모드  |
 |::: |BS2_SUB_EVENT_AUTH_FAIL_INVALID_CREDENTIAL  |0x02  |인증 모드에 설정되지 않은 인증 수단  |
@@ 줄 217: / 줄 238: @@
 |::: |BS2_SUB_EVENT_ACCESS_DENIED_APB  |0x05  |APB 규칙 위반하여 출입 실패  |
 |::: |BS2_SUB_EVENT_ACCESS_DENIED_TIMED_APB  |0x06  |Timed APB 구역을 재진입 대기 시간내에 출입  |
+|::: |BS2_SUB_EVENT_ACCESS_DENIED_FORCED_LOCK  |0x07  |강제 잠금 구역이기 때문에 출입 실패  |
 |::: |BS2_SUB_EVENT_ACCESS_DENIED_SCHEDULED_LOCK  |0x07  |출입 스케줄에 의하여 출입 실패  |
 |::: |BS2_SUB_EVENT_ACCESS_EXCUSED_APB  |0x08  |APB 규칙 위반 및 출입허용(Soft APB)  |
@@ 줄 241: / 줄 263: @@
 |:::  |BS2_SUB_EVENT_FLOOR_FLAG_ACTION  |0x08  |층 플래그 (Action)  |
 |:::  |BS2_SUB_EVENT_FLOOR_FLAG_EMERGENCY  |0x02  |층 플래그 (Emergency)  |
 . //mainCode// \\
 로그 유형의 주코드 값입니다. \\
 ^범주  ^이벤트 코드  ^값  ^설명  ^
@@ 줄 353: / 줄 375: @@
 |:::  |BS2_EVENT_RELAY_ACTION_OFF  |0xC400  |RelayAction 꺼짐  |
 |:::  |BS2_EVENT_RELAY_ACTION_KEEP  |0xC500  |RelayAction 신호유지  |
 . //param// \\
 이벤트 발생 장치의 추가 정보가 필요할 경우에만 사용되고, 주로 근태 코드나 출입문이나 입력 장치의 포트 번호가 저장됩니다. 근태 코드가 저장될 때는 아래의 코드표를 참고하십시오.
 <WRAP group 60%>
@@ 줄 394: / 줄 416: @@
 \\ \\
 . //image// \\
 SDK V2.6.0 이전까지는 1byte 전체를 사용하여 다음을 의미했습니다. \\
 - 이벤트 발생되었을 때 이미지 정보가 포함되었는지 여부 (true/false). \\
@@ 줄 671: / 줄 693: @@
 . //reserved// \\
 예약된 공간입니다.\\ \\
+==== BS2IOStatus ====
+<code cpp>
+typedef struct{
+    uint8_t count;
+    uint8_t reserved[3];
+    BS2_PORT_VALUE status[BS2_IO_STATUS_MAX_IO_PORT];
+} BS2_IO_STATUS;
+typedef struct{
+    BS2_DEVICE_ID deviceID;
+    BS2_IO_STATUS input;
+    BS2_IO_STATUS output;
+    BS2_IO_STATUS relay;
+    BS2_IO_STATUS tamper;
+    BS2_IO_STATUS auxIn;
+    BS2_IO_STATUS auxOut;
+    uint8_t numOfSupervisorInput;
+    BS2_PORT_VALUE supervisorInputStatus[BS2_IO_STATUS_MAX_SIO_PORT];
+    uint8_t reserved1[3];
+    uint8_t reserved2[16];
+} BS2IOStatus;
+</code>
+\\
+. //count// \\
+포트의 개수입니다. \\ \\
+. //status// \\
+포트의 상태를 나타냅니다. \\
+<WRAP group 50%>
+^값  ^설명  ^
+|-1  |UNKNOWN  |
+|0   |Open |
+|1   |Closed |
+|2   |Supervised Short |
+|3   |Supervised Open |
+</WRAP>
+. //deviceID// \\
+장치 식별자입니다. \\ \\
+. //input// \\
+입력 포트를 의미합니다.  \\ \\
+. //output// \\
+출력 포트를 의미합니다.  \\ \\
+. //relay// \\
+릴레이 포트를 의미합니다.  \\ \\
+. //tamper// \\
+탬퍼 포트를 의미합니다.  \\ \\
+. //auxIn// \\
+보조 입력 포트를 의미합니다.  \\ \\
+. //auxOut// \\
+보조 출력 포트를 의미합니다.  \\ \\
+. //numOfSupervisorInput// \\
+Supervisor 입력 포트의 개수입니다.  \\ \\
+. //supervisorInputStatus// \\
+Supervisor 입력 포트들의 상태를 나타냅니다.  \\ \\
+. //reserved1// \\
+예약된 공간입니다. \\ \\
+. //reserved2// \\
+예약된 공간입니다. \\ \\