차이
문서의 선택한 두 판 사이의 차이를 보여줍니다.
양쪽 이전 판 이전 판 다음 판 | 이전 판 다음 판 양쪽 다음 판 | ||
ko:log_management_api [2018/02/21 19:27] kkshin [BS2Event] |
ko:log_management_api [2018/09/12 10:00] kkshin |
||
---|---|---|---|
줄 30: | 줄 30: | ||
union { | union { | ||
char userID[BS2_USER_ID_SIZE]; | char userID[BS2_USER_ID_SIZE]; | ||
- | uint32_t ioDeviceID; | + | uint32_t uid; |
+ | uint32_t doorID; | ||
+ | uint32_t liftID; | ||
+ | uint32_t zoneID; | ||
+ | struct { | ||
+ | uint32_t ioDeviceID; | ||
+ | uint16_t port; | ||
+ | int8_t value; | ||
+ | uint8_t reserved[25]; | ||
+ | }; | ||
+ | struct { | ||
+ | uint32_t zoneID; | ||
+ | uint32_t doorID; | ||
+ | uint32_t ioDeviceID; | ||
+ | uint16_t port; | ||
+ | uint8_t reserved[18]; | ||
+ | } alarm; | ||
+ | struct { | ||
+ | uint32_t zoneID; | ||
+ | uint32_t doorID[4]; | ||
+ | uint8_t reserved[12]; | ||
+ | } interlock; | ||
}; | }; | ||
union { | union { | ||
줄 40: | 줄 61: | ||
}; | }; | ||
uint8_t param; | uint8_t param; | ||
- | uint8_t image; | + | #ifdef LESS_THAN_SDK_2_6_0 |
+ | BS2_BOOL image; // Deprecated in V2.6.0 | ||
+ | #else | ||
+ | uint8_t image: 1; // bit 단위 분할하여 image 및 DST 지원 | ||
+ | uint8_t isDST: 1; | ||
+ | uint8_t half: 1; | ||
+ | uint8_t hour: 4; | ||
+ | uint8_t negative: 1; | ||
+ | #endif | ||
} BS2Event; | } BS2Event; | ||
</code> | </code> | ||
줄 53: | 줄 82: | ||
4. //userID// \\ | 4. //userID// \\ | ||
로그와 관련된 사용자 식별자로써 사용자와 관련 없는 로그일 경우 0으로 설정됩니다. \\ \\ | 로그와 관련된 사용자 식별자로써 사용자와 관련 없는 로그일 경우 0으로 설정됩니다. \\ \\ | ||
- | 5. //ioDeviceID// \\ | + | 5. //uid// \\ |
+ | 출입문에 대한 로그라면 doorID를, 구역에 대한 로그라면 zoneID를 참조하면 되지만, \\ | ||
+ | 이를 정확히 알 수 없는 경우 uid를 참조하면 됩니다. \\ | ||
+ | uid, doorID, liftID, zoneID는 union으로 선언되어 있기때문에 기본적으로 같은 정보를 의미합니다. \\ \\ | ||
+ | 6. //doorID// \\ | ||
+ | 로그가 발생된 출입문 식별자입니다. \\ \\ | ||
+ | 7. //liftID// \\ | ||
+ | 로그가 발생된 리프트 식별자입니다. \\ \\ | ||
+ | 8. //zoneID// \\ | ||
+ | 로그가 발생된 구역 식별자입니다. \\ \\ | ||
+ | 9. //ioDeviceID// \\ | ||
Door나 Input 장치의 식별자로 Door나 Input 장치와 관련 없는 로그일 경우 0으로 설정됩니다. \\ \\ | Door나 Input 장치의 식별자로 Door나 Input 장치와 관련 없는 로그일 경우 0으로 설정됩니다. \\ \\ | ||
- | 6. //subCode// \\ | + | 10. //port// \\ |
+ | ioDeviceID에 대한 port를 의미합니다. \\ \\ | ||
+ | 11. //value// \\ | ||
+ | ioDeviceID에 대한 port value를 나타하며 다음을 의미합니다. \\ | ||
+ | BS2_PORT_VALUE_UNKNOWN : -1 \\ | ||
+ | BS2_PORT_VALUE_OPEN : 0 \\ | ||
+ | BS2_PORT_VALUE_CLOSED : 1 \\ | ||
+ | BS2_PORT_VALUE_SUPERVISED_SHORT : 2 \\ | ||
+ | BS2_PORT_VALUE_SUPERVISED_OPEN : 3 \\ \\ | ||
+ | 12. //alarm.zoneID// \\ | ||
+ | 침입탐지 구역 경보 발생 시 구역에대한 식별자를 의미합니다. \\ \\ | ||
+ | 13. //alarm.doorID// \\ | ||
+ | 침입탐지 구역 경보를 발생시킨 출입문 식별자를 의미합니다. \\ \\ | ||
+ | 14. //interlock.zoneID// \\ | ||
+ | 인터락 위반을 발생시킨 구역 식별자를 의미합니다. \\ \\ | ||
+ | 15. //interlock.doorID// \\ | ||
+ | 인터락 위반을 발생시킨 출입문 식별자를 의미합니다. \\ \\ | ||
+ | 16. //subCode// \\ | ||
로그 유형의 하위 코드 값입니다. 추가 정보가 필요할 경우 사용하십시오. \\ | 로그 유형의 하위 코드 값입니다. 추가 정보가 필요할 경우 사용하십시오. \\ | ||
^범주 ^이벤트 코드 ^값 ^설명 ^ | ^범주 ^이벤트 코드 ^값 ^설명 ^ | ||
줄 63: | 줄 119: | ||
|::: |BS2_SUB_EVENT_VERIFY_ID_FACE |0x04 |주어진 사용자 식별자로 얼굴 인식 성공 | | |::: |BS2_SUB_EVENT_VERIFY_ID_FACE |0x04 |주어진 사용자 식별자로 얼굴 인식 성공 | | ||
|::: |BS2_SUB_EVENT_VERIFY_ID_FACE_PIN |0x05 |주어진 사용자 식별자로 얼굴 인식과 PIN 인증 성공 | | |::: |BS2_SUB_EVENT_VERIFY_ID_FACE_PIN |0x05 |주어진 사용자 식별자로 얼굴 인식과 PIN 인증 성공 | | ||
- | |::: |BS2_SUB_EVENT_VERIFY_CARD |0x06 |스마트 카드 인증 성공 | | + | |::: |BS2_SUB_EVENT_VERIFY_CARD |0x06 |카드 인증 성공 | |
- | |::: |BS2_SUB_EVENT_VERIFY_CARD_PIN |0x07 |스마트 카드와 PIN 인증 성공 | | + | |::: |BS2_SUB_EVENT_VERIFY_CARD_PIN |0x07 |카드와 PIN 인증 성공 | |
- | |::: |BS2_SUB_EVENT_VERIFY_CARD_FINGER |0x08 |스마트 카드와 지문 인증 성공 | | + | |::: |BS2_SUB_EVENT_VERIFY_CARD_FINGER |0x08 |카드와 지문 인증 성공 | |
- | |::: |BS2_SUB_EVENT_VERIFY_CARD_FINGER_PIN |0x09 |스마트 카드, 지문, PIN 인증 성공 | | + | |::: |BS2_SUB_EVENT_VERIFY_CARD_FINGER_PIN |0x09 |카드, 지문, PIN 인증 성공 | |
- | |::: |BS2_SUB_EVENT_VERIFY_CARD_FACE |0x0A |스마트 카드 인증과 얼굴 인식 성공 | | + | |::: |BS2_SUB_EVENT_VERIFY_CARD_FACE |0x0A |카드 인증과 얼굴 인식 성공 | |
- | |::: |BS2_SUB_EVENT_VERIFY_CARD_FACE_PIN |0x0B |스마트 카드, 얼굴 인식, PIN 인증 성공 | | + | |::: |BS2_SUB_EVENT_VERIFY_CARD_FACE_PIN |0x0B |카드, 얼굴 인식, PIN 인증 성공 | |
|::: |BS2_SUB_EVENT_VERIFY_AOC |0x0C |AOC 카드 인증 성공 | | |::: |BS2_SUB_EVENT_VERIFY_AOC |0x0C |AOC 카드 인증 성공 | | ||
|::: |BS2_SUB_EVENT_VERIFY_AOC_PIN |0x0D |AOC 카드와 PIN 인증 성공 | | |::: |BS2_SUB_EVENT_VERIFY_AOC_PIN |0x0D |AOC 카드와 PIN 인증 성공 | | ||
줄 80: | 줄 136: | ||
|::: |BS2_SUB_EVENT_DUAL_AUTH_FAIL_ACCESS_GROUP |0x02 |유효하지 않은 사용자로 2인 인증 시도 | | |::: |BS2_SUB_EVENT_DUAL_AUTH_FAIL_ACCESS_GROUP |0x02 |유효하지 않은 사용자로 2인 인증 시도 | | ||
|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 |유효하지 않은 카드 | |
|::: |BS2_SUB_EVENT_CREDENTIAL_PIN |0x03 |유효하지 않은 PIN | | |::: |BS2_SUB_EVENT_CREDENTIAL_PIN |0x03 |유효하지 않은 PIN | | ||
|::: |BS2_SUB_EVENT_CREDENTIAL_FINGER |0x04 |유효하지 않은 지문 | | |::: |BS2_SUB_EVENT_CREDENTIAL_FINGER |0x04 |유효하지 않은 지문 | | ||
줄 98: | 줄 154: | ||
|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 구역 | | ||
- | 7. //mainCode// \\ | + | 17. //mainCode// \\ |
로그 유형의 주코드 값입니다. \\ | 로그 유형의 주코드 값입니다. \\ | ||
^범주 ^이벤트 코드 ^값 ^설명 ^ | ^범주 ^이벤트 코드 ^값 ^설명 ^ | ||
줄 119: | 줄 175: | ||
|::: |BS2_EVENT_USER_DELETE_FAIL |0x2500 |사용자 삭제 실패 | | |::: |BS2_EVENT_USER_DELETE_FAIL |0x2500 |사용자 삭제 실패 | | ||
|::: |BS2_EVENT_USER_DELETE_ALL_SUCCESS |0x2600 |전체 사용자 삭제 성공 | | |::: |BS2_EVENT_USER_DELETE_ALL_SUCCESS |0x2600 |전체 사용자 삭제 성공 | | ||
- | |::: |BS2_EVENT_USER_ISSUE_AOC_SUCCESS |0x2600 |Access card로 인증 성공 | | + | |::: |BS2_EVENT_USER_ISSUE_AOC_SUCCESS |0x2700 |Access card로 인증 성공 | |
|Device |BS2_EVENT_DEVICE_SYSTEM_RESET |0x3000 |시스템 다시 시작 | | |Device |BS2_EVENT_DEVICE_SYSTEM_RESET |0x3000 |시스템 다시 시작 | | ||
|::: |BS2_EVENT_DEVICE_SYSTEM_STARTED |0x3100 |시스템이 시작됨 | | |::: |BS2_EVENT_DEVICE_SYSTEM_STARTED |0x3100 |시스템이 시작됨 | | ||
|::: |BS2_EVENT_DEVICE_TIME_SET |0x3200 |시스템 시간 변경 | | |::: |BS2_EVENT_DEVICE_TIME_SET |0x3200 |시스템 시간 변경 | | ||
+ | |::: |BS2_EVENT_DEVICE_TIMEZONE_SET |0x3201 |Time zone 변경 | | ||
+ | |::: |BS2_EVENT_DEVICE_DST_SET |0x3202 |DST 설정 변경 | | ||
|::: |BS2_EVENT_DEVICE_LINK_CONNECTED |0x3300 |LAN 케이블 연결됨 | | |::: |BS2_EVENT_DEVICE_LINK_CONNECTED |0x3300 |LAN 케이블 연결됨 | | ||
|::: |BS2_EVENT_DEVICE_LINK_DISCONNETED |0x3400 |LAN 케이블 빠짐 | | |::: |BS2_EVENT_DEVICE_LINK_DISCONNETED |0x3400 |LAN 케이블 빠짐 | | ||
줄 141: | 줄 199: | ||
|::: |BS2_EVENT_DEVICE_FIRMWARE_UPGRADED |0x4300 |펌웨어가 업데이트됨 | | |::: |BS2_EVENT_DEVICE_FIRMWARE_UPGRADED |0x4300 |펌웨어가 업데이트됨 | | ||
|::: |BS2_EVENT_DEVICE_RESOURCE_UPGRADED |0x4400 |리소스가 업데이트됨 | | |::: |BS2_EVENT_DEVICE_RESOURCE_UPGRADED |0x4400 |리소스가 업데이트됨 | | ||
- | |::: |BS2_EVENT_DEVICE_CONFIG_RESET |0x4500 |시스템 구성 정보가 초기화됨 | | + | |::: |BS2_EVENT_DEVICE_CONFIG_RESET |0x4500 |시스템 구성 정보가 초기화됨 (네트워크 정보 포함) | |
+ | |::: |BS2_EVENT_DEVICE_DATABASE_RESET |0x4501 |데이터베이스가 초기화됨 | | ||
+ | |::: |BS2_EVENT_DEVICE_FACTORY_RESET |0x4502 |공장 초기화됨 | | ||
+ | |::: |BS2_EVENT_DEVICE_CONFIG_RESET_EX |0x4503 |시스템 구성 정보가 초기화됨 (네트워크 정보 제외) | | ||
+ | |Supervised Input |BS2_EVENT_SUPERVISED_INPUT_SHORT |0x4600 |Supervised Input (단락 감지) | | ||
+ | |::: |BS2_EVENT_SUPERVISED_INPUT_OPEN |0x4700 |Supervised Input (단선 감지) | | ||
+ | |Device-Ex |BS2_EVENT_DEVICE_AC_FAIL |0x4800 |AC Power 실패 | | ||
+ | |::: |BS2_EVENT_DEVICE_AC_SUCCESS |0x4900 |AC Power 성공 | | ||
|Door |BS2_EVENT_DOOR_UNLOCKED |0x5000 |출입문 잠금이 풀림 | | |Door |BS2_EVENT_DOOR_UNLOCKED |0x5000 |출입문 잠금이 풀림 | | ||
|::: |BS2_EVENT_DOOR_LOCKED |0x5100 |출입문이 잠김 | | |::: |BS2_EVENT_DOOR_LOCKED |0x5100 |출입문이 잠김 | | ||
줄 154: | 줄 219: | ||
|::: |BS2_EVENT_DOOR_APB_ALARM |0x5A00 |APB 경보 시작 | | |::: |BS2_EVENT_DOOR_APB_ALARM |0x5A00 |APB 경보 시작 | | ||
|::: |BS2_EVENT_DOOR_APB_ALARM_CLEAR |0x5B00 |APB 경보 해제 | | |::: |BS2_EVENT_DOOR_APB_ALARM_CLEAR |0x5B00 |APB 경보 해제 | | ||
+ | |::: |BS2_EVENT_DOOR_RELEASE |0x5C00 |출입문 해제 | | ||
+ | |::: |BS2_EVENT_DOOR_LOCK |0x5D00 |출입문 잠금 | | ||
+ | |::: |BS2_EVENT_DOOR_UNLOCK |0x5E00 |출입문 개방 | | ||
|Zone |BS2_EVENT_ZONE_APB_VIOLATION |0x6000 |구역내 APB 규칙 위반 | | |Zone |BS2_EVENT_ZONE_APB_VIOLATION |0x6000 |구역내 APB 규칙 위반 | | ||
|::: |BS2_EVENT_ZONE_APB_ALARM |0x6100 |BS2_EVENT_ZONE_APB_VIOLATION 이벤트 발생 경보 시작 | | |::: |BS2_EVENT_ZONE_APB_ALARM |0x6100 |BS2_EVENT_ZONE_APB_VIOLATION 이벤트 발생 경보 시작 | | ||
줄 163: | 줄 231: | ||
|::: |BS2_EVENT_ZONE_FIRE_ALARM |0x6700 |BS2_EVENT_ZONE_FIRE_ALARM_INPUT 이벤트 발생 경보 시작 | | |::: |BS2_EVENT_ZONE_FIRE_ALARM |0x6700 |BS2_EVENT_ZONE_FIRE_ALARM_INPUT 이벤트 발생 경보 시작 | | ||
|::: |BS2_EVENT_ZONE_FIRE_ALARM_CLEAR |0x6800 |BS2_EVENT_ZONE_FIRE_ALARM_INPUT 이벤트 발생 경보 해제 | | |::: |BS2_EVENT_ZONE_FIRE_ALARM_CLEAR |0x6800 |BS2_EVENT_ZONE_FIRE_ALARM_INPUT 이벤트 발생 경보 해제 | | ||
- | |::: |BS2_EVENT_ZONE_FORCED_LOCK_START |0x6900 |구역내 강제 잠금 시작 | | + | |::: |BS2_EVENT_ZONE_SCHEDULED_LOCK_VIOLATION |0x6900 |스케줄 잠금 구역 위반 감지 | |
- | |::: |BS2_EVENT_ZONE_FORCED_LOCK_END |0x6A00 |구역내 강제 잠금 끝 | | + | |::: |BS2_EVENT_ZONE_SCHEDULED_LOCK_START |0x6A00 |스케줄 잠금 구역 시작 | |
- | |::: |BS2_EVENT_ZONE_FORCED_UNLOCK_START |0x6B00 |구역내 강제 잠금 해제 시작 | | + | |::: |BS2_EVENT_ZONE_SCHEDULED_LOCK_END |0x6B00 |스케줄 잠금 구역 끝 | |
- | |::: |BS2_EVENT_ZONE_FORCED_UNLOCK_END |0x6C00 |구역내 강제 잠금 해제 끝 | | + | |::: |BS2_EVENT_ZONE_SCHEDULED_UNLOCK_START |0x6C00 |스케줄 개방 구역 시작 | |
+ | |::: |BS2_EVENT_ZONE_SCHEDULED_UNLOCK_END |0x6D00 |스케줄 개방 구역 끝 | | ||
+ | |::: |BS2_EVENT_ZONE_SCHEDULED_LOCK_ALARM |0x6E00 |스케줄 잠금 구역 경보 시작 | | ||
+ | |::: |BS2_EVENT_ZONE_SCHEDULED_LOCK_ALARM_CLEAR |0x6F00 |스케줄 잠금 구역 경보 해제 | | ||
- | 8. //param// \\ | + | 18. //param// \\ |
이벤트 발생 장치의 추가 정보가 필요할 경우에만 사용되고, 주로 근태 코드나 출입문이나 입력 장치의 포트 번호가 저장됩니다. 근태 코드가 저장될 때는 아래의 코드표를 참고하십시오. | 이벤트 발생 장치의 추가 정보가 필요할 경우에만 사용되고, 주로 근태 코드나 출입문이나 입력 장치의 포트 번호가 저장됩니다. 근태 코드가 저장될 때는 아래의 코드표를 참고하십시오. | ||
<WRAP group 60%> | <WRAP group 60%> | ||
줄 194: | 줄 265: | ||
\\ \\ | \\ \\ | ||
- | 9. //image// \\ | + | 19. //image// \\ |
- | 이벤트 발생되었을 때 이미지 정보가 포함될 경우에 사용됩니다. | + | SDK V2.6.0 이전까지는 1byte 전체를 사용하여 다음을 의미했습니다. \\ |
+ | - 이벤트 발생되었을 때 이미지 정보가 포함되었는지 여부 (true/false). \\ | ||
+ | SDK V2.6.0 부터는 1byte를 bit 단위로 나누어 다음의 정보를 제공할 수 있도록 변경되었습니다. \\ | ||
+ | - 이미지 정보가 포함되었는지 여부 \\ | ||
+ | - DST 적용 여부 \\ | ||
+ | ^범주 ^비트 수 ^변수 ^설명 ^ | ||
+ | |SDK 2.6.0 이전 |8 |image |이벤트 발생되었을 때 이미지 정보가 포함될 경우에 사용됩니다. | | ||
+ | |SDK 2.6.0 부터 |1 |image |이벤트 발생되었을 때 이미지 정보가 포함될 경우에 사용됩니다. | | ||
+ | |::: |1 |isDST |현재 로그가 DST의 적용을 받았는지 여부를 표시 | | ||
+ | |::: |1 |half |DST가 30분 단위의 적용을 받는지여부. 0은 0분, 1은 30분 | | ||
+ | |::: |4 |hour |시간을 표시. 1~12시 | | ||
+ | |::: |1 |negative |0은 +시간, 1은 -시간 | | ||
==== BS2EventBlob==== | ==== BS2EventBlob==== |