차이
문서의 선택한 두 판 사이의 차이를 보여줍니다.
양쪽 이전 판 이전 판 다음 판 | 이전 판 다음 판 양쪽 다음 판 | ||
ko:configuration_api [2019/07/19 11:51] kkshin [BS2CardConfig] |
ko:configuration_api [2020/02/14 14:00] kkshin [BS2FingerprintConfig] |
||
---|---|---|---|
줄 68: | 줄 68: | ||
* [[BS2_GetIPV6ConfigViaUDPEx]]: [+ 2.6.3] IP V6 설정 정보를 UDP broadcasting를 통해 가져옵니다. (host ip 지정) | * [[BS2_GetIPV6ConfigViaUDPEx]]: [+ 2.6.3] IP V6 설정 정보를 UDP broadcasting를 통해 가져옵니다. (host ip 지정) | ||
* [[BS2_SetIPV6ConfigViaUDPEx]]: [+ 2.6.3] IP V6 설정 정보를 UDP broadcasting를 통해 저장합니다. (host ip 지정) | * [[BS2_SetIPV6ConfigViaUDPEx]]: [+ 2.6.3] IP V6 설정 정보를 UDP broadcasting를 통해 저장합니다. (host ip 지정) | ||
+ | * [[BS2_GetDesFireConfigEx]]: [+ 2.6.4] DesFire 카드 설정 정보를 가져옵니다. | ||
+ | * [[BS2_SetDesFireConfigEx]]: [+ 2.6.4] DesFire 카드 설정 정보를 저장합니다. | ||
===== 구조체 ===== | ===== 구조체 ===== | ||
==== BS2FactoryConfig ==== | ==== BS2FactoryConfig ==== | ||
줄 135: | 줄 137: | ||
bool reserved0; // (write protected) | bool reserved0; // (write protected) | ||
uint8_t reserved[2]; | uint8_t reserved[2]; | ||
- | uint8_t reserved2[20]; | + | uint32_t useCardOperationMask; |
+ | uint8_t reserved2[16]; | ||
} BS2SystemConfig; | } BS2SystemConfig; | ||
</code> | </code> | ||
줄 172: | 줄 175: | ||
14. //reserved// \\ | 14. //reserved// \\ | ||
예약된 공간입니다. \\ \\ | 예약된 공간입니다. \\ \\ | ||
- | 15. //reserved2// \\ | + | 15. //useCardOperationMask// \\ |
+ | [+ V2.6.4] 모든 카드를 읽지 않고, 사용자 선택에 의해 카드 타입별로 읽을 수 있도록 옵션을 제공합니다. \\ | ||
+ | MASK값은 조합을 통하여 중복 설정이 가능며, 사용자는 이 옵션을 통하여 카드 타입의 읽기를 추가 또는 제거할 수 있습니다. \\ | ||
+ | 단, 장치가 지원할 수 있는 카드 타입에 한하며, 장치가 지원하지 않는 카드 읽기를 추가하는 경우 해당 설정은 무시됩니다. \\ | ||
+ | <WRAP group 50%> | ||
+ | ^값 ^설명 ^ | ||
+ | |0xFFFFFFFF |CARD_OPERATION_MASK_DEFAULT | | ||
+ | |0x80000000 |CARD_OPERATION_USE | | ||
+ | |0x00000200 |CARD_OPERATION_MASK_BLE | | ||
+ | |0x00000100 |CARD_OPERATION_MASK_NFC | | ||
+ | |0x00000080 |CARD_OPERATION_MASK_SEOS | | ||
+ | |0x00000040 |CARD_OPERATION_MASK_SR_SE | | ||
+ | |0x00000020 |CARD_OPERATION_MASK_DESFIRE_EV1 | | ||
+ | |0x00000010 |CARD_OPERATION_MASK_CLASSIC_PLUS | | ||
+ | |0x00000008 |CARD_OPERATION_MASK_ICLASS | | ||
+ | |0x00000004 |CARD_OPERATION_MASK_MIFARE_FELICA | | ||
+ | |0x00000002 |CARD_OPERATION_MASK_HIDPROX | | ||
+ | |0x00000001 |CARD_OPERATION_MASK_EM | | ||
+ | </WRAP> | ||
+ | 16. //reserved2// \\ | ||
예약된 공간입니다. \\ \\ | 예약된 공간입니다. \\ \\ | ||
==== BS2AuthConfig ==== | ==== BS2AuthConfig ==== | ||
줄 234: | 줄 256: | ||
개별 인증 모드를 사용할지 결정하는 flag입니다. \\ \\ | 개별 인증 모드를 사용할지 결정하는 flag입니다. \\ \\ | ||
7. //faceDetectionLevel// \\ | 7. //faceDetectionLevel// \\ | ||
- | 사용자를 인증할 때 얼굴 검출 레벨값이며, 지정한 레벨보다 낮은 레벨로 얼굴이 검출되면 인증 실패로 처리됩니다.\\ | + | A2에서 사용자를 인증할 때 얼굴 검출 레벨값이며, 지정한 레벨보다 낮은 레벨로 얼굴이 검출되면 인증 실패로 처리됩니다.\\ |
+ | 설정하면 Normal/Strict에 따른 카메라 뷰가 표시되며, 인증 성공 시의 이미지 로그가 얼굴로 인식되지 않으면 접근이 거부됩니다. 기본값은 0입니다. \\ | ||
<WRAP group 50%> | <WRAP group 50%> | ||
^값 ^설명 ^ | ^값 ^설명 ^ | ||
줄 242: | 줄 265: | ||
</WRAP> | </WRAP> | ||
<WRAP info> | <WRAP info> | ||
- | 카메라가 장착된 장치에서만 유효합니다. | + | A2에서만 설정 가능하며, FaceStation2나 FaceLite에서는 사용되지 않습니다. |
</WRAP> | </WRAP> | ||
8. //useServerMatching// \\ | 8. //useServerMatching// \\ | ||
줄 618: | 줄 641: | ||
DESFire 카드내에 내장된 사용할 애플리케이션가 데이터를 읽고 쓰기 위한 파일 식별자입니다.\\ \\ | DESFire 카드내에 내장된 사용할 애플리케이션가 데이터를 읽고 쓰기 위한 파일 식별자입니다.\\ \\ | ||
15. //encryptionType// \\ | 15. //encryptionType// \\ | ||
- | 데이터 암호화 방식이며, AES는 추후 적용 예정입니다.\\ | + | 데이터 암호화 방식을 나타냅니다.\\ |
<WRAP group 50%> | <WRAP group 50%> | ||
^값 ^설명 ^ | ^값 ^설명 ^ | ||
줄 625: | 줄 648: | ||
</WRAP> | </WRAP> | ||
16. //operationMode// \\ | 16. //operationMode// \\ | ||
- | 운영 방식을 지정합니다.\\ | + | 운영 방식을 지정합니다. (추후적용)\\ |
<WRAP group 50%> | <WRAP group 50%> | ||
^값 ^설명 ^ | ^값 ^설명 ^ | ||
|0 |기존방식 (PICC master key를 사용) | | |0 |기존방식 (PICC master key를 사용) | | ||
- | |1 |신규방식 (App master를 사용) | | + | |1 |신규방식 (App master key를 사용) | |
</WRAP> | </WRAP> | ||
17. //reserved// \\ | 17. //reserved// \\ | ||
줄 663: | 줄 686: | ||
<code cpp> | <code cpp> | ||
typedef struct { | typedef struct { | ||
- | uint8_t securityLevel; | + | uint8_t securityLevel; |
- | uint8_t fastMode; | + | uint8_t fastMode; |
- | uint8_t sensitivity; | + | uint8_t sensitivity; |
- | uint8_t sensorMode; | + | uint8_t sensorMode; |
- | uint16_t templateFormat; | + | uint16_t templateFormat; |
- | uint16_t scanTimeout; | + | uint16_t scanTimeout; |
- | uint8_t successiveScan; | + | uint8_t successiveScan; |
- | uint8_t advancedEnrollment; | + | uint8_t advancedEnrollment; |
- | uint8_t showImage; | + | uint8_t showImage; |
- | uint8_t lfdLevel; | + | uint8_t lfdLevel; |
- | + | bool checkDuplicate; | |
- | uint8_t reserved3[32]; | + | |
+ | uint8_t reserved3[31]; | ||
} BS2FingerprintConfig; | } BS2FingerprintConfig; | ||
</code> | </code> | ||
줄 734: | 줄 758: | ||
|3 |민감도 높음 | | |3 |민감도 높음 | | ||
</WRAP> | </WRAP> | ||
- | 11. //reserved3// \\ | + | 11. //checkDuplicate// \\ |
+ | [+ V2.6.4] true로 설정하면 중복된 지문인지 판단합니다. \\ \\ | ||
+ | 12. //reserved3// \\ | ||
예약된 공간입니다. \\ | 예약된 공간입니다. \\ | ||
- | |||
==== BS2Rs485Config ==== | ==== BS2Rs485Config ==== | ||
<code cpp> | <code cpp> | ||
줄 1521: | 줄 1546: | ||
<code cpp> | <code cpp> | ||
typedef struct { | typedef struct { | ||
- | BS2_FACE_SECURITY_LEVEL securityLevel; | + | uint8_t securityLevel; |
- | BS2_FACE_LIGHT_CONDITON lightCondition; | + | uint8_t lightCondition; |
- | BS2_FACE_ENROLL_THRESHOLD enrollThreshold; | + | uint8_t enrollThreshold; |
- | BS2_FACE_DETECT_SENSITIVITY detectSensitivity; | + | uint8_t detectSensitivity; |
- | uint16_t enrollTimeout; | + | uint16_t enrollTimeout; |
- | BS2_FACE_LFD_LEVEL lfdLevel; | + | uint8_t lfdLevel; |
- | bool quickEnrollment; | + | bool quickEnrollment; |
- | BS2_FACE_PREVIEW_OPTION previewOption; | + | uint8_t previewOption; |
- | uint8_t reserved[3]; | + | bool checkDuplicate; |
+ | uint8_t reserved[2]; | ||
- | uint8_t reserved2[26]; | + | uint8_t reserved2[26]; |
} BS2FaceConfig; | } BS2FaceConfig; | ||
</code> | </code> | ||
줄 1579: | 줄 1605: | ||
얼굴 스캔 대기 시간으로 기본값은 60초입니다\\ \\ | 얼굴 스캔 대기 시간으로 기본값은 60초입니다\\ \\ | ||
6. //lfdLevel// \\ | 6. //lfdLevel// \\ | ||
- | [+ V2.6.4] 위조된 얼굴을 여과할 수 있는 민감도를 설정할 수 있습니다. \\ | + | [+ V2.6.3] 위조된 얼굴을 여과할 수 있는 민감도를 설정할 수 있습니다. \\ |
<WRAP group 50%> | <WRAP group 50%> | ||
^값 ^설명 ^ | ^값 ^설명 ^ | ||
줄 1588: | 줄 1614: | ||
</WRAP> | </WRAP> | ||
7. //quickEnrollment// \\ | 7. //quickEnrollment// \\ | ||
- | [+ V2.6.4] 빠른 얼굴 등록 사용 여부를 설정할 수 있습니다. \\ | + | [+ V2.6.3] 빠른 얼굴 등록 사용 여부를 설정할 수 있습니다. \\ |
이 값을 true로 설정하면 얼굴 등록 절차가 1단계로 설정되며, false로 설정할 경우 3단계로 설정됩니다. \\ | 이 값을 true로 설정하면 얼굴 등록 절차가 1단계로 설정되며, false로 설정할 경우 3단계로 설정됩니다. \\ | ||
고품질의 얼굴 템플릿을 등록하려면 false를 설정하십시오. \\ \\ | 고품질의 얼굴 템플릿을 등록하려면 false를 설정하십시오. \\ \\ | ||
8. //previewOption// \\ | 8. //previewOption// \\ | ||
- | [+ V2.6.4] IR 인증 가이드를 의미하며, 얼굴 인증 시 preview 화면 출력 설정을 변경할 수 있습니다. \\ | + | [+ V2.6.3] IR 인증 가이드를 의미하며, 얼굴 인증 시 preview 화면 출력 설정을 변경할 수 있습니다. \\ |
<WRAP group 50%> | <WRAP group 50%> | ||
^값 ^설명 ^ | ^값 ^설명 ^ | ||
줄 1599: | 줄 1625: | ||
|2 |인증 시도 전구간에 걸쳐 preview를 표시 | | |2 |인증 시도 전구간에 걸쳐 preview를 표시 | | ||
</WRAP> | </WRAP> | ||
- | 9. //reserved// \\ | + | 9. //checkDuplicate// \\ |
+ | [+ V2.6.4] true로 설정하면 중복된 얼굴 정보인지 판단합니다. \\ \\ | ||
+ | 10. //reserved// \\ | ||
예약된 공간입니다.\\ \\ | 예약된 공간입니다.\\ \\ | ||
- | 10. //reserved2// \\ | + | 11. //reserved2// \\ |
예약된 공간입니다.\\ \\ | 예약된 공간입니다.\\ \\ | ||
- | |||
==== BS2Rs485ConfigEX ==== | ==== BS2Rs485ConfigEX ==== | ||
<code cpp> | <code cpp> | ||
줄 1880: | 줄 1907: | ||
16. //allocatedGatewayV6// \\ | 16. //allocatedGatewayV6// \\ | ||
현재 장치에 할당되어진 IP V6 게이트웨이 주소입니다. numOfAllocatedGatewayV6는 할당되어진 게이트웨이 주소의 갯수를 나타냅니다.\\ | 현재 장치에 할당되어진 IP V6 게이트웨이 주소입니다. numOfAllocatedGatewayV6는 할당되어진 게이트웨이 주소의 갯수를 나타냅니다.\\ | ||
+ | \\ | ||
+ | |||
+ | ==== BS2DesFireCardConfigEx ==== | ||
+ | <code cpp> | ||
+ | typedef struct { | ||
+ | uint8_t appMasterKey[16]; | ||
+ | uint8_t fileReadKey[16]; | ||
+ | uint8_t fileWriteKey[16]; | ||
+ | uint8_t fileReadKeyNumber; | ||
+ | uint8_t fileWriteKeyNumber; | ||
+ | uint8_t reserved[2]; | ||
+ | } BS2DesFireAppLevelKey; ///< 52 bytes | ||
+ | |||
+ | typedef struct { | ||
+ | BS2DesFireAppLevelKey desfireAppKey; ///< 52 bytes | ||
+ | uint8_t reserved[16]; | ||
+ | } BS2DesFireCardConfigEx; ///< 68 bytes | ||
+ | </code> | ||
+ | 1. //appMasterKey// \\ | ||
+ | DesFire의 application master key 값 입니다. \\ \\ | ||
+ | 2. //fileReadKey// \\ | ||
+ | 파일 읽기에 사용되는 key 값 입니다. \\ \\ | ||
+ | 3. //fileWriteKey// \\ | ||
+ | 파일 쓰기에 사용되는 key 값 입니다. \\ \\ | ||
+ | 4. //fileReadKeyNumber// \\ | ||
+ | 파일 읽기용 key의 key index 입니다. \\ \\ | ||
+ | 5. //fileWriteKeyNumber// \\ | ||
+ | 파일 쓰기용 key의 key index 입니다. \\ \\ | ||
+ | 6. //reserved// \\ | ||
+ | 예약된 공간입니다. \\ \\ | ||
+ | 7. //desfireAppKey// \\ | ||
+ | DesFire의 키 정보를 갖는 구조체입니다. \\ \\ | ||
+ | 8. //reserved// \\ | ||
+ | 예약된 공간입니다. \\ |