차이
문서의 선택한 두 판 사이의 차이를 보여줍니다.
양쪽 이전 판 이전 판 다음 판 | 이전 판 | ||
ko:log_management_api [2023/10/05 13:16] kkshin [BS2Event] |
ko:log_management_api [2024/02/27 14:56] (현재) |
||
---|---|---|---|
줄 5: | 줄 5: | ||
* [[BS2_GetLog]]: 일정량의 로그를 가져옵니다. | * [[BS2_GetLog]]: 일정량의 로그를 가져옵니다. | ||
- | * [[BS2_GetFilteredLog]]: 조건에 맞는 로그를 가져옵니다. | + | * [[BS2_GetFilteredLog]]: ''[지원중단]'' 조건에 맞는 로그를 가져옵니다. |
* [[BS2_ClearLog]]: 모든 로그를 삭제합니다. | * [[BS2_ClearLog]]: 모든 로그를 삭제합니다. | ||
* [[BS2_StartMonitoringLog]]: 실시간 로그 스트리밍을 시작합니다. | * [[BS2_StartMonitoringLog]]: 실시간 로그 스트리밍을 시작합니다. | ||
줄 11: | 줄 11: | ||
* [[BS2_StopMonitoringLog]]: 실시간 로그 스트리밍을 중단합니다. | * [[BS2_StopMonitoringLog]]: 실시간 로그 스트리밍을 중단합니다. | ||
* [[BS2_GetLogBlob]]: EventMask에 맞게 일정량의 로그를 가져옵니다. | * [[BS2_GetLogBlob]]: EventMask에 맞게 일정량의 로그를 가져옵니다. | ||
- | * [[BS2_GetFilteredLogSinceEventId]]: 조건에 맞는 로그를 가져옵니다. | + | * [[BS2_GetFilteredLogSinceEventId]]: ''[지원중단]'' 조건에 맞는 로그를 가져옵니다. |
* [[BS2_GetImageLog]]: 이미지로그를 가져옵니다. | * [[BS2_GetImageLog]]: 이미지로그를 가져옵니다. | ||
* [[BS2_GetLogSmallBlob]]: [+ 2.6.4] 효율적으로 메모리를 사용하면서, EventMask에 맞게 일정량의 로그를 가져옵니다. | * [[BS2_GetLogSmallBlob]]: [+ 2.6.4] 효율적으로 메모리를 사용하면서, EventMask에 맞게 일정량의 로그를 가져옵니다. | ||
줄 78: | 줄 78: | ||
uint8_t reserved[28]; | uint8_t reserved[28]; | ||
} relayAction; | } relayAction; | ||
+ | struct { | ||
+ | BS2_DEVICE_ID deviceId; | ||
+ | uint8_t data[28]; | ||
+ | } osdpStandard; | ||
}; | }; | ||
union { | union { | ||
줄 141: | 줄 145: | ||
17. //relayAction.inputPort// \\ | 17. //relayAction.inputPort// \\ | ||
IM-120에서 RelayAction 동작 시 input의 port 식별자입니다. \\ \\ | IM-120에서 RelayAction 동작 시 input의 port 식별자입니다. \\ \\ | ||
- | 18. //subCode// \\ | + | 18. //osdpStandard.deviceId// \\ |
+ | OSDP standard 장치의 식별자입니다. \\ \\ | ||
+ | 19. //osdpStandard.data// \\ | ||
+ | OSDP standard 장치에서 발생된 총 28byte 크기의 알림 구조체 정보입니다. \\ | ||
+ | 구조체에 대한 상세한 정보는 [[slave_control_api#BS2OsdpStandardDeviceNotify|BS2OsdpStandardDeviceNotify]]를 참조하세요. \\ \\ | ||
+ | 20. //subCode// \\ | ||
로그 유형의 하위 코드 값입니다. 추가 정보가 필요할 경우 사용하십시오. \\ | 로그 유형의 하위 코드 값입니다. 추가 정보가 필요할 경우 사용하십시오. \\ | ||
^범주 ^이벤트 코드 ^값 ^설명 ^ | ^범주 ^이벤트 코드 ^값 ^설명 ^ | ||
줄 159: | 줄 168: | ||
|::: |BS2_SUB_EVENT_VERIFY_AOC_FINGER |0x0E |AOC 카드와 지문 인증 성공 | | |::: |BS2_SUB_EVENT_VERIFY_AOC_FINGER |0x0E |AOC 카드와 지문 인증 성공 | | ||
|::: |BS2_SUB_EVENT_VERIFY_AOC_FINGER_PIN |0x0F |AOC 카드, 지문, PIN 인증 성공 | | |::: |BS2_SUB_EVENT_VERIFY_AOC_FINGER_PIN |0x0F |AOC 카드, 지문, PIN 인증 성공 | | ||
+ | |::: |BS2_SUB_EVENT_VERIFY_CARD_FACE_FINGER |0x10 |카드, 얼굴, 지문 인증 성공 | | ||
+ | |::: |BS2_SUB_EVENT_VERIFY_CARD_FINGER_FACE |0x11 |카드, 지문, 얼굴 인증 성공 | | ||
+ | |::: |BS2_SUB_EVENT_VERIFY_ID_FACE_FINGER |0x12 |ID, 얼굴, 지문 인증 성공 | | ||
+ | |::: |BS2_SUB_EVENT_VERIFY_ID_FINGER_FACE |0x13 |ID, 지문, 얼굴 인증 성공 | | ||
|::: |BS2_SUB_EVENT_VERIFY_MOBLIE_CARD |0x16 |Mobile카드 인증 성공 (+2.8) | | |::: |BS2_SUB_EVENT_VERIFY_MOBLIE_CARD |0x16 |Mobile카드 인증 성공 (+2.8) | | ||
|::: |BS2_SUB_EVENT_VERIFY_MOBILE_CARD_PIN |0x17 |Mobile카드, PIN 인증 성공 (+2.8) | | |::: |BS2_SUB_EVENT_VERIFY_MOBILE_CARD_PIN |0x17 |Mobile카드, PIN 인증 성공 (+2.8) | | ||
줄 167: | 줄 180: | ||
|::: |BS2_SUB_EVENT_VERIFY_MOBILE_CARD_FACE_FINGER |0x20 |Mobile카드, 얼굴, 지문 인증 성공 (+2.8) | | |::: |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_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 |지문 인증으로 사용자 식별 | | |Identify |BS2_SUB_EVENT_IDENTIFY_FINGER |0x01 |지문 인증으로 사용자 식별 | | ||
|::: |BS2_SUB_EVENT_IDENTIFY_FINGER_PIN |0x02 |지문과 PIN 인증으로 사용자 식별 | | |::: |BS2_SUB_EVENT_IDENTIFY_FINGER_PIN |0x02 |지문과 PIN 인증으로 사용자 식별 | | ||
줄 175: | 줄 196: | ||
|::: |BS2_SUB_EVENT_IDENTIFY_FINGER_FACE |0x07 |지문 인증과 얼굴 인식으로 사용자 식별 | | |::: |BS2_SUB_EVENT_IDENTIFY_FINGER_FACE |0x07 |지문 인증과 얼굴 인식으로 사용자 식별 | | ||
|::: |BS2_SUB_EVENT_IDENTIFY_FINGER_FACE_PIN |0x08 |지문 인증과 얼굴 인식, PIN 인증으로 사용자 식별 | | |::: |BS2_SUB_EVENT_IDENTIFY_FINGER_FACE_PIN |0x08 |지문 인증과 얼굴 인식, PIN 인증으로 사용자 식별 | | ||
+ | |User |BS2_SUB_EVENT_ENROLL_FAIL_INVALID_FACE |0x01 |등록실패(잘못된 얼굴 정보) | | ||
+ | |::: |BS2_SUB_EVENT_UPDATE_FAIL_INVALID_FACE |0x01 |갱신실패(잘못된 얼굴 정보) | | ||
+ | |::: |BS2_SUB_EVENT_ENROLL_FAIL_MISMATCHED_FORMAT |0x02 |등록실패(존재하지 않는 사용자 등록 시, 템플릿 포멧이 장치 설정과 다름) | | ||
+ | |::: |BS2_SUB_EVENT_UPDATE_FAIL_MISMATCHED_FORMAT |0x02 |갱신실패(존재하는 사용자 갱신 시, 템플릿 포멧이 장치 설정과 다름) | | ||
+ | |::: |BS2_SUB_EVENT_ENROLL_FAIL_FULL_CREDENTIAL |0x03 |등록실패(사용자 등록으로 인해 장치의 credential 허용치를 초과함) | | ||
+ | |::: |BS2_SUB_EVENT_UPDATE_FAIL_FULL_CREDENTIAL |0x03 |갱신실패(사용자 갱신으로 인해 장치의 credential 허용치를 초과함) | | ||
+ | |::: |BS2_SUB_EVENT_ENROLL_FAIL_INVALID_USER |0x04 |등록실패(사용자 ID가 비어있다거나, 등록이 불가한 상황) | | ||
+ | |::: |BS2_SUB_EVENT_UPDATE_FAIL_INVALID_USER |0x04 |갱신실패(등록된 사용자가 없는 경우) | | ||
+ | |::: |BS2_SUB_EVENT_ENROLL_FAIL_INTERNAL_ERROR |0x09 |등록실패(내부오류) | | ||
+ | |::: |BS2_SUB_EVENT_UPDATE_FAIL_INTERNAL_ERROR |0x09 |갱신실패(내부오류) | | ||
|Auth |BS2_SUB_EVENT_DUAL_AUTH_FAIL_TIMEOUT |0x01 |이중 인증(2인 인증) 시간 만료 | | |Auth |BS2_SUB_EVENT_DUAL_AUTH_FAIL_TIMEOUT |0x01 |이중 인증(2인 인증) 시간 만료 | | ||
|::: |BS2_SUB_EVENT_DUAL_AUTH_FAIL_ACCESS_GROUP |0x02 |유효하지 않은 사용자로 2인 인증 시도 | | |::: |BS2_SUB_EVENT_DUAL_AUTH_FAIL_ACCESS_GROUP |0x02 |유효하지 않은 사용자로 2인 인증 시도 | | ||
+ | |::: |BS2_SUB_EVENT_HIGH_TEMPERATURE |0x00 |고온 감지 | | ||
+ | |::: |BS2_SUB_EVENT_NO_TEMPERATURE |0x01 |체온 감지 실패 | | ||
+ | |::: |BS2_SUB_EVENT_UNMASKED_FACE |0x02 |마스트 미착용 | | ||
+ | |::: |BS2_SUB_EVENT_BYPASS_NO_VIOLATION |0x00 |Bypass violation (No) | | ||
+ | |::: |BS2_SUB_EVENT_BYPASS_THERMAL_VIOLATION |0x01 |Bypass violation (체온) | | ||
+ | |::: |BS2_SUB_EVENT_BYPASS_MASK_VIOLATION |0x02 |Bypass violation (마스크) | | ||
+ | |::: |BS2_SUB_EVENT_BYPASS_MASK_THERMAL_VIOLATION |0x03 |Bypass violation (마스크 + 체온) | | ||
|Credential |BS2_SUB_EVENT_CREDENTIAL_ID |0x01 |등록되지 않은 사용자 식별자 | | |Credential |BS2_SUB_EVENT_CREDENTIAL_ID |0x01 |등록되지 않은 사용자 식별자 | | ||
|::: |BS2_SUB_EVENT_CREDENTIAL_CARD |0x02 |유효하지 않은 카드 | | |::: |BS2_SUB_EVENT_CREDENTIAL_CARD |0x02 |유효하지 않은 카드 | | ||
줄 185: | 줄 223: | ||
|::: |BS2_SUB_EVENT_CREDENTIAL_AOC_FINGER |0x07 |유효하지 않은 AOC 지문 | | |::: |BS2_SUB_EVENT_CREDENTIAL_AOC_FINGER |0x07 |유효하지 않은 AOC 지문 | | ||
|::: |BS2_SUB_EVENT_CREDENTIAL_MOBILE_CARD |0x08 |유효하지 않은 Mobile카드 (+2.8) | | |::: |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 |유효하지 않은 인증 모드 | | |Auth |BS2_SUB_EVENT_AUTH_FAIL_INVALID_AUTH_MODE |0x01 |유효하지 않은 인증 모드 | | ||
|::: |BS2_SUB_EVENT_AUTH_FAIL_INVALID_CREDENTIAL |0x02 |인증 모드에 설정되지 않은 인증 수단 | | |::: |BS2_SUB_EVENT_AUTH_FAIL_INVALID_CREDENTIAL |0x02 |인증 모드에 설정되지 않은 인증 수단 | | ||
|::: |BS2_SUB_EVENT_AUTH_FAIL_TIMEOUT |0x03 |인증 시간 만료 | | |::: |BS2_SUB_EVENT_AUTH_FAIL_TIMEOUT |0x03 |인증 시간 만료 | | ||
+ | |::: |BS2_SUB_EVENT_AUTH_FAIL_MATCHING_REFUSAL |0x04 |매칭 거부 | | ||
|Access |BS2_SUB_EVENT_ACCESS_DENIED_ACCESS_GROUP |0x01 |출입 통제 구역에 등록되지 않아 출입 실패 | | |Access |BS2_SUB_EVENT_ACCESS_DENIED_ACCESS_GROUP |0x01 |출입 통제 구역에 등록되지 않아 출입 실패 | | ||
|::: |BS2_SUB_EVENT_ACCESS_DENIED_DISABLED |0x02 |비활성화된 사용자이기 때문에 출입 실패 | | |::: |BS2_SUB_EVENT_ACCESS_DENIED_DISABLED |0x02 |비활성화된 사용자이기 때문에 출입 실패 | | ||
줄 213: | 줄 255: | ||
|APB |BS2_SUB_EVENT_ZONE_HARD_APB |0x01 |하드 APB 구역 | | |APB |BS2_SUB_EVENT_ZONE_HARD_APB |0x01 |하드 APB 구역 | | ||
|::: |BS2_SUB_EVENT_ZONE_SOFT_APB |0x02 |소프트 APB 구역 | | |::: |BS2_SUB_EVENT_ZONE_SOFT_APB |0x02 |소프트 APB 구역 | | ||
- | |User |BS2_SUB_EVENT_ENROLL_FAIL_INVALID_FACE |0x01 |등록실패(잘못된 얼굴 정보) | | + | |Door |BS2_SUB_EVENT_DOOR_FLAG_SCHEDULE |0x01 |출임문 플래그 (Schedule) | |
- | |::: |BS2_SUB_EVENT_UPDATE_FAIL_INVALID_FACE |0x01 |갱신실패(잘못된 얼굴 정보) | | + | |::: |BS2_SUB_EVENT_DOOR_FLAG_OPERATOR |0x04 |출임문 플래그 (Operator) | |
- | |::: |BS2_SUB_EVENT_ENROLL_FAIL_MISMATCHED_FORMAT |0x02 |등록실패(존재하지 않는 사용자 등록 시, 템플릿 포멧이 장치 설정과 다름) | | + | |::: |BS2_SUB_EVENT_DOOR_FLAG_EMERGENCY |0x02 |출임문 플래그 (Emergency) | |
- | |::: |BS2_SUB_EVENT_UPDATE_FAIL_MISMATCHED_FORMAT |0x02 |갱신실패(존재하는 사용자 갱신 시, 템플릿 포멧이 장치 설정과 다름) | | + | |Floor |BS2_SUB_EVENT_FLOOR_FLAG_SCHEDULE |0x01 |층 플래그 (Schedule) | |
- | |::: |BS2_SUB_EVENT_ENROLL_FAIL_FULL_CREDENTIAL |0x03 |등록실패(사용자 등록으로 인해 장치의 credential 허용치를 초과함) | | + | |::: |BS2_SUB_EVENT_FLOOR_FLAG_OPERATOR |0x04 |층 플래그 (Operator) | |
- | |::: |BS2_SUB_EVENT_UPDATE_FAIL_FULL_CREDENTIAL |0x03 |갱신실패(사용자 갱신으로 인해 장치의 credential 허용치를 초과함) | | + | |::: |BS2_SUB_EVENT_FLOOR_FLAG_ACTION |0x08 |층 플래그 (Action) | |
- | |::: |BS2_SUB_EVENT_ENROLL_FAIL_INVALID_USER |0x04 |등록실패(사용자 ID가 비어있다거나, 등록이 불가한 상황) | | + | |::: |BS2_SUB_EVENT_FLOOR_FLAG_EMERGENCY |0x02 |층 플래그 (Emergency) | |
- | |::: |BS2_SUB_EVENT_UPDATE_FAIL_INVALID_USER |0x04 |갱신실패(등록된 사용자가 없는 경우) | | + | 21. //mainCode// \\ |
- | |::: |BS2_SUB_EVENT_ENROLL_FAIL_INTERNAL_ERROR |0x09 |등록실패(내부오류) | | + | |
- | |::: |BS2_SUB_EVENT_UPDATE_FAIL_INTERNAL_ERROR |0x09 |갱신실패(내부오류) | | + | |
- | 19. //mainCode// \\ | + | |
로그 유형의 주코드 값입니다. \\ | 로그 유형의 주코드 값입니다. \\ | ||
^범주 ^이벤트 코드 ^값 ^설명 ^ | ^범주 ^이벤트 코드 ^값 ^설명 ^ | ||
줄 335: | 줄 374: | ||
|::: |BS2_EVENT_RELAY_ACTION_OFF |0xC400 |RelayAction 꺼짐 | | |::: |BS2_EVENT_RELAY_ACTION_OFF |0xC400 |RelayAction 꺼짐 | | ||
|::: |BS2_EVENT_RELAY_ACTION_KEEP |0xC500 |RelayAction 신호유지 | | |::: |BS2_EVENT_RELAY_ACTION_KEEP |0xC500 |RelayAction 신호유지 | | ||
- | + | 22. //param// \\ | |
- | + | ||
- | 20. //param// \\ | + | |
이벤트 발생 장치의 추가 정보가 필요할 경우에만 사용되고, 주로 근태 코드나 출입문이나 입력 장치의 포트 번호가 저장됩니다. 근태 코드가 저장될 때는 아래의 코드표를 참고하십시오. | 이벤트 발생 장치의 추가 정보가 필요할 경우에만 사용되고, 주로 근태 코드나 출입문이나 입력 장치의 포트 번호가 저장됩니다. 근태 코드가 저장될 때는 아래의 코드표를 참고하십시오. | ||
<WRAP group 60%> | <WRAP group 60%> | ||
줄 378: | 줄 415: | ||
\\ \\ | \\ \\ | ||
- | 21. //image// \\ | + | 23. //image// \\ |
SDK V2.6.0 이전까지는 1byte 전체를 사용하여 다음을 의미했습니다. \\ | SDK V2.6.0 이전까지는 1byte 전체를 사용하여 다음을 의미했습니다. \\ | ||
- 이벤트 발생되었을 때 이미지 정보가 포함되었는지 여부 (true/false). \\ | - 이벤트 발생되었을 때 이미지 정보가 포함되었는지 여부 (true/false). \\ |