차이

문서의 선택한 두 판 사이의 차이를 보여줍니다.

차이 보기로 링크

양쪽 이전 판 이전 판
다음 판
이전 판
다음 판 양쪽 다음 판
ko:configuration_api [2018/12/11 14:48]
yjjung [BS2DisplayConfig]
ko:configuration_api [2019/07/19 11:51]
kkshin [BS2CardConfig]
줄 60: 줄 60:
   * [[BS2_SetDstConfig]]:​ DST 설정 정보를 저장합니다.   * [[BS2_SetDstConfig]]:​ DST 설정 정보를 저장합니다.
   * [[BS2_GetSupportedConfigMask]]:​ 장치에서 지원하는 구성 설정을 가져옵니다.   * [[BS2_GetSupportedConfigMask]]:​ 장치에서 지원하는 구성 설정을 가져옵니다.
 +  * [[BS2_GetIPConfigViaUDPEx]]:​ [+ 2.6.3] IP 설정 정보를 UDP broadcasting를 통해 가져옵니다. (host ip 지정)
 +  * [[BS2_SetIPConfigViaUDPEx]]:​ [+ 2.6.3] IP 설정 정보를 UDP broadcasting를 통해 저장합니다. (host ip 지정)
 +  * [[BS2_GetIPV6Config]]:​ [+ 2.6.3] IP V6 설정 정보를 가져옵니다.
 +  * [[BS2_SetIPV6Config]]:​ [+ 2.6.3] IP V6 설정 정보를 저장합니다.
 +  * [[BS2_GetIPV6ConfigViaUDP]]:​ [+ 2.6.3] IP V6 설정 정보를 UDP broadcasting를 통해 가져옵니다.
 +  * [[BS2_SetIPV6ConfigViaUDP]]:​ [+ 2.6.3] IP V6 설정 정보를 UDP broadcasting를 통해 저장합니다.
 +  * [[BS2_GetIPV6ConfigViaUDPEx]]:​ [+ 2.6.3] IP V6 설정 정보를 UDP broadcasting를 통해 가져옵니다. (host ip 지정)
 +  * [[BS2_SetIPV6ConfigViaUDPEx]]:​ [+ 2.6.3] IP V6 설정 정보를 UDP broadcasting를 통해 저장합니다. (host ip 지정)
 ===== 구조체 ===== ===== 구조체 =====
 ==== BS2FactoryConfig ==== ==== BS2FactoryConfig ====
줄 111: 줄 119:
  
 ==== BS2SystemConfig ==== ==== BS2SystemConfig ====
-반드시 [[BS2_GetSystemConfig]] 호출 후, tamperOn을 제외하고 필요한 설정을 완료한 후 
-[[BS2_SetSystemConfig]]를 호출하여야 합니다. \\ 
 <code cpp> <code cpp>
 typedef struct { typedef struct {
줄 127: 줄 133:
     uint32_t cameraFrequency;​     uint32_t cameraFrequency;​
     bool secureTamper;​     bool secureTamper;​
-private: +    ​bool reserved0;     // (write protected)
-    ​bool tamperOn;     // (write protected)+
     uint8_t reserved[2];​     uint8_t reserved[2];​
     uint8_t reserved2[20];​     uint8_t reserved2[20];​
줄 146: 줄 151:
 인터폰을 사용할지 결정하는 flag입니다. \\ \\  인터폰을 사용할지 결정하는 flag입니다. \\ \\ 
 7. //​useUSBConnection//​ \\  7. //​useUSBConnection//​ \\ 
-USB 연결을 허지 결정하는 flag입니다. \\ \\ +지 는 member 변수입니다. ​(USB 연결은 장치가 자동으로 감지합니다.) ​\\ \\ 
 8. //​keyEncrypted//​ \\  8. //​keyEncrypted//​ \\ 
 OSDP secure key를 사용할지 flag입니다. \\ \\  OSDP secure key를 사용할지 flag입니다. \\ \\ 
줄 163: 줄 168:
 보안 탬퍼를 사용할지 결정하는 flag입니다.\\ ​ 보안 탬퍼를 사용할지 결정하는 flag입니다.\\ ​
 탬퍼 on 발생 시 다음의 데이터가 장치에서 삭제됩니다. (사용자, 로그, 데이터 암호화 키, SSL 인증서) \\ \\ 탬퍼 on 발생 시 다음의 데이터가 장치에서 삭제됩니다. (사용자, 로그, 데이터 암호화 키, SSL 인증서) \\ \\
-13. //tamperOn// \\  +13. //reserved0// \\  
-탬퍼가 발생하였는지 내부적으로 관리하기 위한 정보로, 설정되어져서는 안되는 값니다. \\   +예약된 공간입니다. \\ \\  
-반드시, [[BS2_GetSystemConfig]] 호출 후, tamperOn을 제외한 필요 설정을 완료한 후 [[BS2_SetSystemConfig]]를 호출하여야 합니다. \\ \\ +14. //reserved// \\ 
-14. //reserved1// \\ +
 예약된 공간입니다. \\ \\  예약된 공간입니다. \\ \\ 
 15. //​reserved2//​ \\  15. //​reserved2//​ \\ 
줄 568: 줄 572:
     uint8_t fileID;     uint8_t fileID;
     uint8_t encryptionType;​     uint8_t encryptionType;​
-    uint8_t reserved[3];+    ​uint8_t operationMode;​ 
 +    ​uint8_t reserved[2];
 } BS2DesFireCard;​ } BS2DesFireCard;​
  
줄 580: 줄 585:
     BS2DesFireCard desfire;     BS2DesFireCard desfire;
     uint8_t formatID;     uint8_t formatID;
 +    uint8_t cipher;
     uint8_t reserved[24];​     uint8_t reserved[24];​
 } BS2CardConfig;​ } BS2CardConfig;​
줄 618: 줄 624:
 |1  |AES  | |1  |AES  |
 </​WRAP>​ </​WRAP>​
-16. //​reserved//​ \\ +16. //​operationMode//​ \\  
 +운영 방식을 지정합니다.\\  
 +<WRAP group 50%> 
 +^값  ^설명 ​ ^ 
 +|0  |기존방식 (PICC master key를 사용) ​ | 
 +|1  |신규방식 (App master를 사용) ​ | 
 +</​WRAP>​ 
 +17. //​reserved//​ \\ 
 예약된 공간입니다.\\ \\  예약된 공간입니다.\\ \\ 
-17. //​byteOrder//​ \\ +18. //​byteOrder//​ \\ 
 카드 데이터의 바이트 저장 순서입니다. 0일 경우 MSB((최상위 비트, Most Significant Bit))이고,​ 1일 경우 LSB((최하위 비트, Least Significant Bit))입니다. \\ \\  카드 데이터의 바이트 저장 순서입니다. 0일 경우 MSB((최상위 비트, Most Significant Bit))이고,​ 1일 경우 LSB((최하위 비트, Least Significant Bit))입니다. \\ \\ 
-18. //​useWiegandFormat//​ \\ +19. //​useWiegandFormat//​ \\ 
 Wiegand 형식 카드 사용 유무를 결정하는 flag입니다. \\ \\  Wiegand 형식 카드 사용 유무를 결정하는 flag입니다. \\ \\ 
-19. //​dataType//​ \\ +20. //​dataType//​ \\ 
 Card의 데이터 유형입니다. \\  Card의 데이터 유형입니다. \\ 
 <WRAP group 50%> <WRAP group 50%>
줄 633: 줄 646:
 |3  |BCD  | |3  |BCD  |
 </​WRAP>​ </​WRAP>​
-20. //​useSecondaryKey//​ \\ +21. //​useSecondaryKey//​ \\ 
 두번째 암호화 키 사용 유무를 결정하는 flag입니다. \\ \\  두번째 암호화 키 사용 유무를 결정하는 flag입니다. \\ \\ 
-21. //​formatID//​ \\ +22. //​formatID//​ \\ 
 BioStar 애플리케이션에서 card configuration을 데이터베이스 관리할 필요가 있을 경우 사용할 수 있는 식별자입니다. \\ \\  BioStar 애플리케이션에서 card configuration을 데이터베이스 관리할 필요가 있을 경우 사용할 수 있는 식별자입니다. \\ \\ 
-22. //​reserved5//​ \\ +23. //cipher// \\ 
 +Keypad로 card id를 입력받을 수 있도록 활성화 합니다. \\ 
 +기본 값은 0이며, Xpass D2 Gangbox Keypad 만 유효합니다. \\ 
 +<WRAP group 50%> 
 +^값  ^설명 ​ ^ 
 +|0  |비활성화 ​ | 
 +|1  |활성화 ​ | 
 +</​WRAP>​ 
 +24. //​reserved5//​ \\ 
 예약된 공간입니다. \\  예약된 공간입니다. \\ 
 ==== BS2FingerprintConfig ==== ==== BS2FingerprintConfig ====
줄 652: 줄 673:
     uint8_t showImage;     uint8_t showImage;
     uint8_t lfdLevel;     uint8_t lfdLevel;
-    ​uint8_t ​reserved1[32];+ 
 +    ​uint8_t ​reserved3[32];
 } BS2FingerprintConfig;​ } BS2FingerprintConfig;​
 </​code>​ </​code>​
줄 712: 줄 734:
 |3  |민감도 높음 ​ | |3  |민감도 높음 ​ |
 </​WRAP>​ </​WRAP>​
-11. //reserved1// \\ +11. //reserved3// \\ 
 예약된 공간입니다. \\  예약된 공간입니다. \\ 
  
줄 1499: 줄 1521:
 <code cpp> <code cpp>
 typedef struct { typedef struct {
- BS2_FACE_SECURITY_LEVEL ​      ​securityLevel;​  + BS2_FACE_SECURITY_LEVEL ​      ​securityLevel;​ 
- BS2_FACE_LIGHT_CONDITON ​      ​lightCondition;​  + BS2_FACE_LIGHT_CONDITON ​      ​lightCondition;​ 
- BS2_FACE_ENROLL_THRESHOLD ​    ​enrollThreshold;​  + BS2_FACE_ENROLL_THRESHOLD ​    ​enrollThreshold;​ 
- BS2_FACE_DETECT_SENSITIVITY ​  ​detectSensitivity;​ + BS2_FACE_DETECT_SENSITIVITY ​  ​detectSensitivity;​
  
- uint16_t ​                     enrollTimeout;​  + uint16_t ​                     enrollTimeout;​ 
- uint8_t ​                      reserved3[32]; + BS2_FACE_LFD_LEVEL ​           lfdLevel; 
 + bool                          quickEnrollment;​ 
 + 
 + BS2_FACE_PREVIEW_OPTION ​      ​previewOption;​ 
 + uint8_t ​                      ​reserved[3];​ 
 + 
 + uint8_t ​                      reserved2[26];
 } BS2FaceConfig;​ } BS2FaceConfig;​
 </​code>​ </​code>​
줄 1550: 줄 1578:
 5. //​enrollTimeout//​ \\  5. //​enrollTimeout//​ \\ 
 얼굴 스캔 대기 시간으로 기본값은 60초입니다\\ \\ 얼굴 스캔 대기 시간으로 기본값은 60초입니다\\ \\
-6. //reserved3// \\ +6. //lfdLevel// \\ 
 +[+ V2.6.4] 위조된 얼굴을 여과할 수 있는 민감도를 설정할 수 있습니다. \\ 
 +<WRAP group 50%> 
 +^값  ^설명 ​ ^ 
 +|0  |사용안함 ​ | 
 +|1  |민감도 낮음 ​ | 
 +|2  |민감도 보통 ​ | 
 +|3  |민감도 높음 ​ | 
 +</​WRAP>​ 
 +7. //​quickEnrollment//​ \\ 
 +[+ V2.6.4] 빠른 얼굴 등록 사용 여부를 설정할 수 있습니다. \\ 
 +이 값을 true로 설정하면 얼굴 등록 절차가 1단계로 설정되며,​ false로 설정할 경우 3단계로 설정됩니다. \\ 
 +고품질의 얼굴 템플릿을 등록하려면 false를 설정하십시오. \\ \\ 
 +8. //​previewOption//​ \\ 
 +[+ V2.6.4] IR 인증 가이드를 의미하며,​ 얼굴 인증 시 preview 화면 출력 설정을 변경할 수 있습니다. \\ 
 +<WRAP group 50%> 
 +^값  ^설명 ​ ^ 
 +|0  |Preview 표시 안함 ​ | 
 +|1  |인증 시작 시는 preview를 표시하지 않으며, 1/2 지점에 표시 ​ | 
 +|2  |인증 시도 전구간에 걸쳐 preview를 표시 ​ | 
 +</​WRAP>​ 
 +9. //​reserved//​ \\  
 +예약된 공간입니다.\\ \\ 
 +10. //reserved2// \\ 
 예약된 공간입니다.\\ \\ 예약된 공간입니다.\\ \\
  
줄 1771: 줄 1822:
 </​WRAP>​ </​WRAP>​
  
 +==== BS2IPV6Config ====
 +<code cpp>
 +enum {
 +    BS2_MAX_IPV6_ALLOCATED_ADDR = 8,
 +};
  
 +typedef struct {
 +    uint8_t useIPV6;
 +    uint8_t reserved1;
 +    uint8_t useDhcpV6;
 +    uint8_t useDnsV6;
 +    uint8_t reserved[1];​
 +    char staticIpAddressV6[BS2_IPV6_ADDR_SIZE];​
 +    char staticGatewayV6[BS2_IPV6_ADDR_SIZE];​
 +    char dnsAddrV6[BS2_IPV6_ADDR_SIZE];​
 +    char serverIpAddressV6[BS2_IPV6_ADDR_SIZE];​
 +    uint16_t serverPortV6;​
 +    uint16_t sslServerPortV6;​
 +    uint16_t portV6;
 +    uint8_t numOfAllocatedAddressV6;​
 +    uint8_t numOfAllocatedGatewayV6;​
 +    uint8_t reserved[8];​
 +    char allocatedIpAddressV6[BS2_IPV6_ADDR_SIZE][BS2_MAX_IPV6_ALLOCATED_ADDR];​
 +    char allocatedGatewayV6[BS2_IPV6_ADDR_SIZE][BS2_MAX_IPV6_ALLOCATED_ADDR];​
 +} BS2IpConfig;​
 +</​code>​
 +1. //useIPV6// \\ 
 +IP V6 사용여부를 나태내는 flag입니다. \\ \\ 
 +2. //​reserved1//​ \\ 
 +예약된 공간입니다. \\ \\ 
 +3. //​useDhcpV6//​ \\ 
 +DHCP 사용 유무를 나타내는 flag입니다. \\ \\ 
 +4. //​useDnsV6//​ \\ 
 +server addresss를 사용할지 server URL을 사용할 지 결정하는 flag입니다. \\ \\ 
 +5. //​staticIpAddressV6//​ \\ 
 +현재 장치의 정적 IP V6 주소입니다. \\ \\ 
 +6. //​staticGatewayV6//​ \\ 
 +현재 장치의 정적 IP V6 게이트웨이 주소입니다. \\ \\ 
 +7. //​dnsAddrV6//​ \\ 
 +DNS V6 주소입니다. \\ \\ 
 +8. //​serverIpAddressV6//​ \\ 
 +connectionMode가 server mode일 때 사용되며,​ BioStar 애플리케이션의 IP V6 주소입니다. \\ \\ 
 +9. //​serverPortV6//​ \\ 
 +connectionMode가 server mode일 때 사용되며,​ BioStar 애플리케이션의 포트 번호입니다. \\ \\ 
 +10. //​sslServerPortV6//​ \\ 
 +connectionMode가 server mode일 때 사용되며,​ ssl로 연결될 애플리케이션의 서버 포트 번호입니다. \\ \\ 
 +11. //portV6// \\ 
 +현재 장치의 IP V6 포트 번호입니다. \\ \\ 
 +12. //​numOfAllocatedAddressV6//​ \\ 
 +현재 장치에 할당되어진 IP V6 주소의 갯수를 나타냅니다. \\ \\ 
 +13. //​numOfAllocatedGatewayV6//​ \\ 
 +현재 장치에 할당되어진 IP V6 게이트웨이 주소의 갯수를 나타냅니다. \\ \\ 
 +14. //​reserved//​ \\ 
 +예약된 공간입니다. \\ \\
 +15. //​allocatedIpAddressV6//​ \\ 
 +현재 장치에 할당되어진 IP V6 주소입니다. numOfAllocatedAddressV6는 할당되어진 주소의 갯수를 나타냅니다. \\ \\
 +16. //​allocatedGatewayV6//​ \\ 
 +현재 장치에 할당되어진 IP V6 게이트웨이 주소입니다. numOfAllocatedGatewayV6는 할당되어진 게이트웨이 주소의 갯수를 나타냅니다.\\