Differences
This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision Next revision | Previous revision | ||
|
en:log_management_api [2023/10/05 14:37] kkshin [BS2Event] |
en:log_management_api [2024/02/27 13:53] (current) |
||
|---|---|---|---|
| Line 5: | Line 5: | ||
| * [[BS2_GetLog]]: Gets certain amount of logs. | * [[BS2_GetLog]]: Gets certain amount of logs. | ||
| - | * [[BS2_GetFilteredLog]]: Gets filtered logs. | + | * [[BS2_GetFilteredLog]]: ''[Deprecated]'' Gets filtered logs. |
| * [[BS2_ClearLog]]: Deletes all logs. | * [[BS2_ClearLog]]: Deletes all logs. | ||
| * [[BS2_StartMonitoringLog]]: Starts Real-time log streaming. | * [[BS2_StartMonitoringLog]]: Starts Real-time log streaming. | ||
| Line 11: | Line 11: | ||
| * [[BS2_StopMonitoringLog]]: Stops Real-time log streaming. | * [[BS2_StopMonitoringLog]]: Stops Real-time log streaming. | ||
| * [[BS2_GetLogBlob]]: Gets certain amount of logs based on the event mask. | * [[BS2_GetLogBlob]]: Gets certain amount of logs based on the event mask. | ||
| - | * [[BS2_GetFilteredLogSinceEventId]]: Gets filtered logs. | + | * [[BS2_GetFilteredLogSinceEventId]]: ''[Deprecated]'' Gets filtered logs. |
| * [[BS2_GetImageLog]] : Gets image logs using event ID. | * [[BS2_GetImageLog]] : Gets image logs using event ID. | ||
| * [[BS2_GetLogSmallBlob]]: [+ 2.6.4] Gets certain amount of logs based on the event mask in an efficient way. | * [[BS2_GetLogSmallBlob]]: [+ 2.6.4] Gets certain amount of logs based on the event mask in an efficient way. | ||
| - | * [[BS2_GetLogSmallBlobEx]]: [+ 2.7.1] Gets certain amount of logs based on the event mask in an efficient way, including the temperature information. | + | * [[BS2_GetLogSmallBlobEx]]: [+ 2.7.1] Gets certain amount of logs based on the event mask in an efficient way, including the temperature information. |
| ===== Callback Function ===== | ===== Callback Function ===== | ||
| ==== OnLogReceived ==== | ==== OnLogReceived ==== | ||
| Line 79: | Line 79: | ||
| uint8_t reserved[28]; | uint8_t reserved[28]; | ||
| } relayAction; | } relayAction; | ||
| + | struct { | ||
| + | BS2_DEVICE_ID deviceId; | ||
| + | uint8_t data[28]; | ||
| + | } osdpStandard; | ||
| }; | }; | ||
| union { | union { | ||
| Line 91: | Line 95: | ||
| BS2_BOOL image; // Deprecated in V2.6.0 | BS2_BOOL image; // Deprecated in V2.6.0 | ||
| #else | #else | ||
| - | uint8_t image: 1; // Support image and DST by bit division | + | uint8_t image: 1; // Supports image and DST by splitting bit unit |
| uint8_t isDST: 1; | uint8_t isDST: 1; | ||
| uint8_t half: 1; | uint8_t half: 1; | ||
| Line 142: | Line 146: | ||
| **17. //relayAction.inputPort//** \\ | **17. //relayAction.inputPort//** \\ | ||
| Relay port identifier when IM-120 RelayAction takes place. \\ \\ | Relay port identifier when IM-120 RelayAction takes place. \\ \\ | ||
| - | **18. //subCode//** \\ | + | **18. //osdpStandard.deviceId//** \\ |
| + | Identifier of the OSDP standard device. \\ \\ | ||
| + | **19. //osdpStandard.data//** \\ | ||
| + | This is notification structure information with a total size of 28 bytes generated from OSDP standard devices. \\ | ||
| + | For detailed information about the structure, please refer to [[slave_control_api#BS2OsdpStandardDeviceNotify|BS2OsdpStandardDeviceNotify]]. \\ \\ | ||
| + | **20. //subCode//** \\ | ||
| Sub code value of log types. Use if the additional information is necessary. \\ | Sub code value of log types. Use if the additional information is necessary. \\ | ||
| ^Category ^Event code ^Value ^Description ^ | ^Category ^Event code ^Value ^Description ^ | ||
| Line 172: | Line 181: | ||
| |::: |BS2_SUB_EVENT_VERIFY_MOBILE_CARD_FACE_FINGER |0x20 |Mobile card, face, fingerprint verification success (+V2.8) | | |::: |BS2_SUB_EVENT_VERIFY_MOBILE_CARD_FACE_FINGER |0x20 |Mobile card, face, fingerprint verification success (+V2.8) | | ||
| |::: |BS2_SUB_EVENT_VERIFY_MOBILE_CARD_FINGER_FACE |0x21 |Mobile card, fingerprint, face verification success (+V2.8) | | |::: |BS2_SUB_EVENT_VERIFY_MOBILE_CARD_FINGER_FACE |0x21 |Mobile card, fingerprint, face verification success (+V2.8) | | ||
| + | |::: |BS2_SUB_EVENT_VERIFY_QR |0x25 |QR verification success | | ||
| + | |::: |BS2_SUB_EVENT_VERIFY_QR_PIN |0x26 |QR and PIN verification success | | ||
| + | |::: |BS2_SUB_EVENT_VERIFY_QR_FINGER |0x27 |QR and finger verification success | | ||
| + | |::: |BS2_SUB_EVENT_VERIFY_QR_FINGER_PIN |0x28 |QR, finger and PIN verification success | | ||
| + | |::: |BS2_SUB_EVENT_VERIFY_QR_FACE |0x29 |QR and face verification success | | ||
| + | |::: |BS2_SUB_EVENT_VERIFY_QR_FACE_PIN |0x2A |QR, face and PIN verification success | | ||
| + | |::: |BS2_SUB_EVENT_VERIFY_QR_FACE_FINGER |0x2B |QR, face and finger verification success | | ||
| + | |::: |BS2_SUB_EVENT_VERIFY_QR_FINGER_FACE |0x2C |QR, finger and face verification success | | ||
| |Identify |BS2_SUB_EVENT_IDENTIFY_FINGER |0x01 |Fingerprint identification success | | |Identify |BS2_SUB_EVENT_IDENTIFY_FINGER |0x01 |Fingerprint identification success | | ||
| |::: |BS2_SUB_EVENT_IDENTIFY_FINGER_PIN |0x02 |Fingerprint and PIN identification success | | |::: |BS2_SUB_EVENT_IDENTIFY_FINGER_PIN |0x02 |Fingerprint and PIN identification success | | ||
| Line 207: | Line 224: | ||
| |::: |BS2_SUB_EVENT_CREDENTIAL_AOC_FINGER |0x07 |Invalid AOC fingerprint | | |::: |BS2_SUB_EVENT_CREDENTIAL_AOC_FINGER |0x07 |Invalid AOC fingerprint | | ||
| |::: |BS2_SUB_EVENT_CREDENTIAL_MOBILE_CARD |0x08 |Invalid mobile card (+V2.8) | | |::: |BS2_SUB_EVENT_CREDENTIAL_MOBILE_CARD |0x08 |Invalid mobile card (+V2.8) | | ||
| - | |::: |BS2_SUB_EVENT_CREDENTIAL_QR |0x09 |Invalid QR | | + | |::: |BS2_SUB_EVENT_NON_NUMERIC_QR |0x09 |Non numeric QR | |
| + | |::: |BS2_SUB_EVENT_CREDENTIAL_QR |0x0C |Invalid QR | | ||
| + | |::: |BS2_SUB_EVENT_NON_PRINTABLE_QR |0x0A |Contains unusable characters | | ||
| + | |::: |BS2_SUB_EVENT_TOO_LONG_QR |0x0B |Too long QR | | ||
| |Auth |BS2_SUB_EVENT_AUTH_FAIL_INVALID_AUTH_MODE |0x01 |Invalid authentication mode | | |Auth |BS2_SUB_EVENT_AUTH_FAIL_INVALID_AUTH_MODE |0x01 |Invalid authentication mode | | ||
| |::: |BS2_SUB_EVENT_AUTH_FAIL_INVALID_CREDENTIAL |0x02 |Non-registered authentication method| | |::: |BS2_SUB_EVENT_AUTH_FAIL_INVALID_CREDENTIAL |0x02 |Non-registered authentication method| | ||
| Line 242: | Line 262: | ||
| |::: |BS2_SUB_EVENT_FLOOR_FLAG_ACTION |0x08 |Floor flag (Action) | | |::: |BS2_SUB_EVENT_FLOOR_FLAG_ACTION |0x08 |Floor flag (Action) | | ||
| |::: |BS2_SUB_EVENT_FLOOR_FLAG_EMERGENCY |0x02 |Floor flag (Emergency) | | |::: |BS2_SUB_EVENT_FLOOR_FLAG_EMERGENCY |0x02 |Floor flag (Emergency) | | ||
| - | **19. //mainCode//** \\ | + | **21. //mainCode//** \\ |
| Main code value of log types. \\ | Main code value of log types. \\ | ||
| ^Category ^Event code ^Value ^Description ^ | ^Category ^Event code ^Value ^Description ^ | ||
| Line 352: | Line 372: | ||
| |::: |BS2_EVENT_RELAY_ACTION_OFF |0xC400 |RelayAction Switch-OFF | | |::: |BS2_EVENT_RELAY_ACTION_OFF |0xC400 |RelayAction Switch-OFF | | ||
| |::: |BS2_EVENT_RELAY_ACTION_KEEP |0xC500 |RelayAction KEEP SIGNAL | | |::: |BS2_EVENT_RELAY_ACTION_KEEP |0xC500 |RelayAction KEEP SIGNAL | | ||
| - | **20.//param//** \\ | + | **22.//param//** \\ |
| It is used only when extra information on the device is needed. Usually, a time and attendance code, a port number of the door or input device is stored in the //param// argument. | It is used only when extra information on the device is needed. Usually, a time and attendance code, a port number of the door or input device is stored in the //param// argument. | ||
| When a time and attendance code is stored, refer to the following values: | When a time and attendance code is stored, refer to the following values: | ||
| Line 394: | Line 414: | ||
| \\ \\ | \\ \\ | ||
| - | **21. //image//** \\ | + | **23. //image//** \\ |
| Prior to SDK V2.6.0, it used the whole 1 byte and means below: \\ | Prior to SDK V2.6.0, it used the whole 1 byte and means below: \\ | ||
| - Whether the image was included when the event occurred (true / false). \\ \\ | - Whether the image was included when the event occurred (true / false). \\ \\ | ||