차이
문서의 선택한 두 판 사이의 차이를 보여줍니다.
| 양쪽 이전 판 이전 판 다음 판 | 이전 판 다음 판 양쪽 다음 판 | ||
|
ko:log_management_api [2018/10/31 13:01] kkshin |
ko:log_management_api [2020/06/01 13:28] kkshin [BS2EventBlob] |
||
|---|---|---|---|
| 줄 12: | 줄 12: | ||
| * [[BS2_GetFilteredLogSinceEventId]]: 조건에 맞는 로그를 가져옵니다. | * [[BS2_GetFilteredLogSinceEventId]]: 조건에 맞는 로그를 가져옵니다. | ||
| * [[BS2_GetImageLog]]: 이미지로그를 가져옵니다. | * [[BS2_GetImageLog]]: 이미지로그를 가져옵니다. | ||
| + | * [[BS2_GetLogSmallBlob]]: [+ 2.6.4] 효율적으로 메모리를 사용하면서, EventMask에 맞게 일정량의 로그를 가져옵니다. | ||
| + | |||
| ===== 콜백 함수 ===== | ===== 콜백 함수 ===== | ||
| <code cpp> | <code cpp> | ||
| 줄 177: | 줄 179: | ||
| |::: |BS2_EVENT_USER_DELETE_ALL_SUCCESS |0x2600 |전체 사용자 삭제 성공 | | |::: |BS2_EVENT_USER_DELETE_ALL_SUCCESS |0x2600 |전체 사용자 삭제 성공 | | ||
| |::: |BS2_EVENT_USER_ISSUE_AOC_SUCCESS |0x2700 |Access card로 인증 성공 | | |::: |BS2_EVENT_USER_ISSUE_AOC_SUCCESS |0x2700 |Access card로 인증 성공 | | ||
| + | |::: |BS2_EVENT_USER_DUPLICATE_CREDENTIAL |0x2800 |중복 인증(카드/지문/얼굴)정보 검출 | | ||
| |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 |시스템이 시작됨 | | ||
| 줄 263: | 줄 266: | ||
| |:::|BS2_TNA_KEY_15|0|15| | |:::|BS2_TNA_KEY_15|0|15| | ||
| |:::|BS2_TNA_KEY_16|Esc|16| | |:::|BS2_TNA_KEY_16|Esc|16| | ||
| + | </WRAP> | ||
| + | \\ | ||
| + | **[+ 2.6.3] param의 추가기능** \\ | ||
| + | event code가 사용자와 관련된 경우에 한합니다. \\ | ||
| + | 장치에서 직접 사용자를 추가 또는 편집, 삭제하였다면 param은 1, BioStar를 통해 이루어졌다면 0입니다.\\ | ||
| + | 예를들어 BS2_EVENT_USER_ENROLL_SUCCESS와 함께 param이 1이었다면, 장치에서 직접 추가된 사용자를 나타냅니다.\\ | ||
| + | 이 기능은 아래의 펌웨어 버전 이후부터 지원합니다. | ||
| + | <WRAP group 60%> | ||
| + | ^장치 종류 ^지원 버전 ^ | ||
| + | |BioStation 2 |V1.7.0 | | ||
| + | |BioStation A2 |V1.6.0 | | ||
| + | |CoreStation 40 |V1.2.0 | | ||
| + | |BioEntry P2 |V1.2.0 | | ||
| + | |BioStation L2 |V1.4.0 | | ||
| + | |BioLite N2 |V1.1.0 | | ||
| + | |BioEntry W2 |V1.3.0 | | ||
| + | |FaceStation 2 |V1.2.0| | ||
| </WRAP> | </WRAP> | ||
| \\ \\ | \\ \\ | ||
| 줄 329: | 줄 349: | ||
| 로그와 관련된 사용자 식별자로써 사용자와 관련 없는 로그일 경우 0으로 설정됩니다. \\ \\ | 로그와 관련된 사용자 식별자로써 사용자와 관련 없는 로그일 경우 0으로 설정됩니다. \\ \\ | ||
| 5. //cardID// \\ | 5. //cardID// \\ | ||
| - | 로그와 관련된 card 식별자로써 card와 관련 없는 로그일 경우 0으로 설정됩니다. \\ \\ | + | 로그와 관련된 card 식별자로써 card와 관련 없는 로그일 경우 0으로 설정됩니다. \\ |
| + | 인증 실패의 경우에만 기록하며, 인증 성공의 경우에는 eventMask와 상관없이 user ID를 리턴합니다. \\ \\ | ||
| 6. //doorID// \\ | 6. //doorID// \\ | ||
| 로그와 관련된 door 식별자로써 door와 관련 없는 로그일 경우 0으로 설정됩니다. \\ \\ | 로그와 관련된 door 식별자로써 door와 관련 없는 로그일 경우 0으로 설정됩니다. \\ \\ | ||
| 줄 403: | 줄 424: | ||
| </WRAP> | </WRAP> | ||
| 4. //reserved// \\ | 4. //reserved// \\ | ||
| + | 예약된 공간입니다.\\ \\ | ||
| + | |||
| + | ==== BS2EventSmallBlob ==== | ||
| + | <code cpp> | ||
| + | typedef struct { | ||
| + | uint16_t eventMask; | ||
| + | uint32_t id; | ||
| + | BS2EventExtInfo info; | ||
| + | union | ||
| + | { | ||
| + | BS2_USER_ID userID; // valid if eventMask has BS2_EVENT_MASK_USER_ID | ||
| + | uint8_t cardID[BS2_CARD_DATA_SIZE]; // valid if eventMask has BS2_EVENT_MASK_CARD_ID | ||
| + | BS2_DOOR_ID doorID; // valid if eventMask has BS2_EVENT_MASK_DOOR_ID | ||
| + | BS2_ZONE_ID zoneID; // valid if eventMask has BS2_EVENT_MASK_ZONE_ID | ||
| + | BS2EventExtIoDevice ioDevice; // valid if eventMask has BS2_EVENT_MASK_IODEVICE | ||
| + | }; | ||
| + | uint8_t tnaKey; | ||
| + | uint32_t jobCode; | ||
| + | uint16_t imageSize; | ||
| + | uint8_t* imageObj; // valid if eventMask has BS2_EVENT_MASK_IMAGE | ||
| + | uint8_t reserved; | ||
| + | } BS2EventSmallBlob; | ||
| + | </code> | ||
| + | \\ | ||
| + | |||
| + | 1. //eventMask// \\ | ||
| + | Event mask값입니다. mask값에 따라서 해당 ID(User, card, door, zone)값을 인식할 수 있습니다.\\ \\ | ||
| + | <WRAP group 50%> | ||
| + | ^값 ^설명 ^ | ||
| + | |0 |없음 | | ||
| + | |1 |BS2EventExtInfo 구조체 | | ||
| + | |2 |User ID | | ||
| + | |4 |Card ID | | ||
| + | |8 |Door ID | | ||
| + | |16 |Zone ID | | ||
| + | |32 |BS2EventExtIoDevice 구조체 | | ||
| + | |64 |Door ID | | ||
| + | |128 |Zone ID | | ||
| + | |256 |TNA Key | | ||
| + | |512 |Job Code | | ||
| + | |1024 |Image | | ||
| + | |65535 |ALL | | ||
| + | </WRAP> | ||
| + | 2. //id// \\ | ||
| + | 로그 레코드의 식별자이며 로그가 발생될 때마다 1부터 자동으로 증가합니다. \\ \\ | ||
| + | 3. //info// \\ | ||
| + | BS2EventExtInfo 구조체 정보입니다. \\ \\ | ||
| + | 4. //userID// \\ | ||
| + | 로그와 관련된 사용자 식별자로써 사용자와 관련 없는 로그일 경우 0으로 설정됩니다. \\ \\ | ||
| + | 5. //cardID// \\ | ||
| + | 로그와 관련된 card 식별자로써 card와 관련 없는 로그일 경우 0으로 설정됩니다. \\ \\ | ||
| + | 6. //doorID// \\ | ||
| + | 로그와 관련된 door 식별자로써 door와 관련 없는 로그일 경우 0으로 설정됩니다. \\ \\ | ||
| + | 7. //zoneID// \\ | ||
| + | 로그와 관련된 zone 식별자로써 zone와 관련 없는 로그일 경우 0으로 설정됩니다. \\ \\ | ||
| + | 8. //ioDevice// \\ | ||
| + | Door나 Input 장치의 식별자로 Door나 Input 장치와 관련 없는 로그일 경우 0으로 설정됩니다. (BS2EventExtIoDevice 구조체 참고)\\ \\ | ||
| + | 9. //tnaKey// \\ | ||
| + | 이벤트 발생 장치의 추가 정보가 필요할 경우에만 사용되고, 주로 근태 코드나 출입문이나 입력 장치의 포트 번호가 저장됩니다 \\ \\ | ||
| + | 10. //jobCode// \\ | ||
| + | 사용자 정보에 JobCode가 존재했을 경우에, JobCode 사용하여 인증 할 때 사용자의 JobCode 값을 말합니다. \\ \\ | ||
| + | 11. //imageSize// \\ | ||
| + | 이벤트 발생되었을 때 이미지 size를 말합니다. \\ \\ | ||
| + | 12. //imageObj// \\ | ||
| + | 이벤트 발생되었을 때 이미지 정보가 포함될 경우에 사용됩니다 \\ \\ | ||
| + | 13. //reserved// \\ | ||
| 예약된 공간입니다.\\ \\ | 예약된 공간입니다.\\ \\ | ||