Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision 		Previous revision
Next revision Both sides next revision
en:configuration_api [2017/11/29 21:20]
michael [BS2IpConfig] 		en:configuration_api [2020/07/29 11:46]
yjjung [BS2DisplayConfig]
Line 5: Line 5:
  
   * [[BS2_ResetConfig]]:​ Initializes the device'​s configurations.   * [[BS2_ResetConfig]]:​ Initializes the device'​s configurations.
 +  * [[BS2_ResetConfigExceptNetInfo]]:​​ ​ Initializes the setting information of the device. (Excluding network settings)
   * [[BS2_GetConfig]]:​ Retrieves configuration blob from the device.   * [[BS2_GetConfig]]:​ Retrieves configuration blob from the device.
   * [[BS2_SetConfig]]:​ Stores configuration blob on the device.   * [[BS2_SetConfig]]:​ Stores configuration blob on the device.
Line 52: Line 53:
   * [[BS2_GetFaceConfig]]:​ Retrieves face settings from the device.   * [[BS2_GetFaceConfig]]:​ Retrieves face settings from the device.
   * [[BS2_SetFaceConfig]]:​ Stores face settings on the device.   * [[BS2_SetFaceConfig]]:​ Stores face settings on the device.
-  * [[BS2_GetRS485ConfigEx]]: ​CIn case of Corestation,​ retrieves RS-485 network settings from the device.+  * [[BS2_GetRS485ConfigEx]]: ​In case of Corestation,​ retrieves RS-485 network settings from the device.
   * [[BS2_SetRS485ConfigEx]]:​ In case of CoreStation,​ stores RS-485 network settings on the device.   * [[BS2_SetRS485ConfigEx]]:​ In case of CoreStation,​ stores RS-485 network settings on the device.
   * [[BS2_GetCardConfigEx]]:​ Retrieves iClass SEOS card settings from the device.   * [[BS2_GetCardConfigEx]]:​ Retrieves iClass SEOS card settings from the device.
   * [[BS2_SetCardConfigEx]]:​ Stores iClass SEOS card settings on the device.  ​   * [[BS2_SetCardConfigEx]]:​ Stores iClass SEOS card settings on the device.  ​
 +  * [[BS2_GetDstConfig]]:​​ Retrieves the device DST information.
 +  * [[BS2_SetDstConfig]]:​​ Stores the device DST information.
 +  * [[BS2_GetSupportedConfigMask]]:​ Retrieves supported configuration of the device.
 +  * [[BS2_GetIPConfigViaUDPEx]]:​ [+ 2.6.3] Retrieves IP configuration through UDP broadcast with host IP. 
 +  * [[BS2_SetIPConfigViaUDPEx]]:​ [+ 2.6.3] Stores IP configuration through UDP broadcast with host IP. 
 +  * [[BS2_GetIPV6Config]]:​ [+ 2.6.3] Retrieves IPv6 configuration information. ​
 +  * [[BS2_SetIPV6Config]]:​ [+ 2.6.3] Stores IPv6 configuration information.
 +  * [[BS2_GetIPV6ConfigViaUDP]]:​ [+ 2.6.3] Retrieves IPv6 configuration through UDP broadcast.
 +  * [[BS2_SetIPV6ConfigViaUDP]]:​ [+ 2.6.3] Stores IPv6 configuration through UDP broadcast.
 +  * [[BS2_GetIPV6ConfigViaUDPEx]]:​ [+ 2.6.3] Retrieves IPv6 configuration through UDP broadcast with host IP. 
 +  * [[BS2_SetIPV6ConfigViaUDPEx]]:​ [+ 2.6.3] Stores IPv6 configuration through UDP broadcast with host IP. 
 +  * [[BS2_GetDesFireCardConfigEx]]:​ [+ V2.6.4] Retrieves DesFire advanced configuration from the device.
 +  * [[BS2_SetDesFireCardConfigEx]]:​ [+ V2.6.4] Sets DesFire advanced configuration in the device.
 \\ \\
 ===== Structure ===== ===== Structure =====
Line 120: Line 134:
     uint8_t keyEncrypted;​     uint8_t keyEncrypted;​
     uint8_t useJobCode;     uint8_t useJobCode;
-    uint8_t useAlphanumericID +    uint8_t useAlphanumericID;  
-    uint32_t cameraFrequency +    uint32_t cameraFrequency;  
-    uint8_t ​reserved1[24];+    bool secureTamper;​​  
 +    bool reserved0; ​    // (write protected) 
 +    uint8_t reserved[2];​ 
 +    uint32_t useCardOperationMask;​ 
 +    uint8_t ​​reserved2[16];     ​
 } BS2SystemConfig;​ } BS2SystemConfig;​
 </​code>​ </​code>​
Line 134: Line 152:
 Reserved variable. \\ \\ Reserved variable. \\ \\
 **5. //​deviceLocked//​** \\  **5. //​deviceLocked//​** \\ 
-Decides whether to show lock screen in stand-by mode. \\ \\ +Indicates the current locked state of the device. (Read only filed) ​\\ \\ 
 **6. //​useInterphone//​** \\  **6. //​useInterphone//​** \\ 
 Decides whether to use intercom. \\ \\  Decides whether to use intercom. \\ \\ 
 **7. //​useUSBConnection//​** \\  **7. //​useUSBConnection//​** \\ 
-Decides whether to use USB connection. \\ \\ +This is not used anymore. (The device automatically detects ​USB connection.) \\ \\ 
 **8. //​keyEncrypted//​** \\  **8. //​keyEncrypted//​** \\ 
 Decides whether to use OSDP secure key. \\ \\  Decides whether to use OSDP secure key. \\ \\ 
Line 153: Line 171:
 |2  |60Hz  | |2  |60Hz  |
 </​WRAP> ​ </​WRAP> ​
-**12. //reserved1//** \\ +***12. //secureTamper//​** \\  
 +Flag to determine whether to use a security tamper. \\ 
 +When Tamper on, the following data is deleted from the device. (User, log, data encryption key, SSL certificate) \\ \\ 
 +**13. //​reserved0//​** \\  
 +Reserved space. \\ \\  
 +**14. //​reserved//​** \\  
 +Reserved space. \\ \\  
 +**15. //​useCardOperationMask//​** \\ 
 +[+ V2.6.4] Provides a card selective option not to read all kinds of cards from the device. \\ 
 +You can select multiple cards using MASK. The user can select or deselect of a specific card reading option using this option. \\ 
 +However, it can be applied to the card types the device supporting. If you add a card type which isn't supported from the device would be ignored. \\ 
 +Also, the required card type MASK should be combined with ''​CARD_OPERATION_USE''​. \\ 
 +For example, useCardOperationMask needs to be configured ''​x0x80000001''​ when EM card is selected only. 
 +<WRAP group 50%> 
 +^Value ​ ^Description ^ 
 +|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//** \\ 
 Reserved space. \\ \\  Reserved space. \\ \\ 
  
Line 182: Line 228:
 **1. //​authSchedule//​** \\  **1. //​authSchedule//​** \\ 
 Stores schedules for different types of authentication modes. \\ \\  Stores schedules for different types of authentication modes. \\ \\ 
 +It has the following meanings in the value of the array. \\
 +If the value in the array is greater than 0, the corresponding authentication mode is enabled. \\
 +Biometric information in the descriptions below refers to the fingerprint or face depending on the device. \\
 +<WRAP group 60%>
 +^Value ^Code  ^Description ​ ^
 +|0  |BS2_AUTH_MODE_BIOMETRIC_ONLY ​ |Biometric only |
 +|1  |BS2_AUTH_MODE_BIOMETRIC_PIN ​ |Biometric + PIN  |
 +|2  |BS2_AUTH_MODE_CARD_ONLY ​ |Card only  |
 +|3  |BS2_AUTH_MODE_CARD_BIOMETRIC ​ |Card + Biometric ​ |
 +|4  |BS2_AUTH_MODE_CARD_PIN ​ |Card + PIN |
 +|5  |BS2_AUTH_MODE_CARD_BIOMETRIC_OR_PIN ​ |Card + Biometric or PIN  |
 +|6  |BS2_AUTH_MODE_CARD_BIOMETRIC_PIN ​ |Card + Biometric + PIN  |
 +|7  |BS2_AUTH_MODE_ID_BIOMETRIC ​ |ID + Biometric ​ |
 +|8  |BS2_AUTH_MODE_ID_PIN ​ |ID + PIN  |
 +|9  |BS2_AUTH_MODE_ID_BIOMETRIC_OR_PIN ​ |ID + Biometric or PIN  |
 +|10  |BS2_AUTH_MODE_ID_BIOMETRIC_PIN ​ |ID + Biometric + PIN  |
 +</​WRAP>​
 **2. //​useGlobalAPB//​** \\  **2. //​useGlobalAPB//​** \\ 
 Decides whether to enable global APB zone. \\ \\  Decides whether to enable global APB zone. \\ \\ 
Line 200: Line 263:
 **7. //​faceDetectionLevel//​** \\  **7. //​faceDetectionLevel//​** \\ 
 Level of face detection in user authentication. If the detected face level is lower than the configuration,​ it will be processed as authentication fail.\\ Level of face detection in user authentication. If the detected face level is lower than the configuration,​ it will be processed as authentication fail.\\
 +When set, the camera view according to Normal/​Strict is displayed, access is denied if the device doesn'​t recognize facial image through image log. Default is 0. 
 <WRAP group 50%> <WRAP group 50%>
 ^Value ​ ^Description ​ ^ ^Value ​ ^Description ​ ^
Line 207: Line 271:
 </​WRAP>​ </​WRAP>​
 <WRAP info> <WRAP info>
-Only valid for devices ​with a camera.+Only valid for A2. Not used with FaceStation2 or FaceLite.
 </​WRAP>​ </​WRAP>​
 **8. //​useServerMatching//​** \\  **8. //​useServerMatching//​** \\ 
Line 230: Line 294:
 |1  |Administrative privilege ​ | |1  |Administrative privilege ​ |
 |2  |Privilege to change the system settings| |2  |Privilege to change the system settings|
-|3  |Normal ​user privilege|+|3  |Privilege to change ​user information|
 </​WRAP>​ </​WRAP>​
 <WRAP alert> <WRAP alert>
Line 300: Line 364:
     uint8_t timeFormat;     uint8_t timeFormat;
     uint8_t homeFormation;​     uint8_t homeFormation;​
-    ​uint8_t ​useUserPhrase;​ +    ​BS2_BOOL ​useUserPhrase;​ 
-    ​uint8_t reserved[1];+    ​BS2_BOOL queryUserPhrase;
     uint8_t shortcutHome[BS2_MAX_SHORTCUT_HOME];​     uint8_t shortcutHome[BS2_MAX_SHORTCUT_HOME];​
     uint8_t tnaIcon[16];​     uint8_t tnaIcon[16];​
Line 359: Line 423:
 |0  |12 hour  | |0  |12 hour  |
 |1  |24 hour  | |1  |24 hour  |
 +However, Linux OS devices like BioStation 2, BioStation L2, BioLite N2 and FaceLite have opposite settings.(0 = 24 hour / 1 = 12 hour) 
 </​WRAP>​ </​WRAP>​
 **12. //​homeFormation//​** \\  **12. //​homeFormation//​** \\ 
Line 372: Line 437:
 **13. //​useUserPhrase//​** \\  **13. //​useUserPhrase//​** \\ 
 Flag that determines whether to use the user phrase feature. \\ \\  Flag that determines whether to use the user phrase feature. \\ \\ 
-**14. //​shortcutHome//​** \\  +**13. //​queryUserPhrase//​** \\  
-Home screen layout(Currently, not used). \\ \\  +If set true, asks the user phrase to the server. \\ \\  
-**15. //​tnaIcon//​** \\ +**15. //​shortcutHome//​** \\  
 +Home screen layout(Going to apply later, not used currently). \\ \\  
 +**16. //​tnaIcon//​** \\ 
 Icon displayed on the device corresponding to the job code. \\ \\ Icon displayed on the device corresponding to the job code. \\ \\
-**16. //​reserved1//​** \\ +**17. //​reserved1//​** \\ 
 Reserved space. \\  Reserved space. \\ 
  
Line 420: Line 487:
 Port number of BioStar. Used only in the server mode. \\ \\  Port number of BioStar. Used only in the server mode. \\ \\ 
 **11. //​mtuSize//​** \\  **11. //​mtuSize//​** \\ 
-Maximum ​transmission unit for the TCP/IP communication. \\ \\ +MTU((Maximum ​Transmission Unit)) size for the TCP/IP communication. \\ \\ 
 **12. //​baseband//​** \\  **12. //​baseband//​** \\ 
 Bandwidth of the device. The value can be set to 10MB/S or 100 MB/S. \\ \\  Bandwidth of the device. The value can be set to 10MB/S or 100 MB/S. \\ \\ 
Line 538: Line 605:
     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;​
  
Line 550: Line 618:
     BS2DesFireCard desfire;     BS2DesFireCard desfire;
     uint8_t formatID;     uint8_t formatID;
 +    uint8_t cipher;
     uint8_t reserved[24];​     uint8_t reserved[24];​
 } BS2CardConfig;​ } BS2CardConfig;​
Line 583: Line 652:
 File ID that is stored inside the DesFire card, which will be used by the application to read and write data.\\ \\  File ID that is stored inside the DesFire card, which will be used by the application to read and write data.\\ \\ 
 **15. //​encryptionType//​** \\  **15. //​encryptionType//​** \\ 
-Type of data encryption. AES will be supported soon.\\ +Type of data encryption.\\ ​
 <WRAP group 50%> <WRAP group 50%>
 ^Value ​ ^Description ​ ^ ^Value ​ ^Description ​ ^
Line 589: Line 658:
 |1  |AES  | |1  |AES  |
 </​WRAP>​ </​WRAP>​
-**16. //​reserved//​** \\ +**16. //​operationMode//​** \\  
 +Operation mode. (operationMode will be supported soon.)\\  
 +<WRAP group 50%> 
 +^Value ​ ^Description ​ ^ 
 +|0  |Lagacy mode (Using PICC master key)  | 
 +|1  |New mode (Using App master key)  | 
 +</​WRAP>​ 
 +**17. //​reserved//​** \\ 
 Reserved space.\\ \\  Reserved space.\\ \\ 
-**17. //​byteOrder//​** \\ +**18. //​byteOrder//​** \\ 
 Order of how the byte of the card is stored. When it is set as 0, will function as MSB((Most Significant Bit)). When it is set as 1, will function as LSB((Least Significant Bit)). \\ \\  Order of how the byte of the card is stored. When it is set as 0, will function as MSB((Most Significant Bit)). When it is set as 1, will function as LSB((Least Significant Bit)). \\ \\ 
-**18. //​useWiegandFormat//​** \\ +**19. //​useWiegandFormat//​** \\ 
 Decides whether to use Wiegand format.\\ \\  Decides whether to use Wiegand format.\\ \\ 
-**19. //​dataType//​** \\ +**20. //​dataType//​** \\ 
 Type of card data. \\  Type of card data. \\ 
 <WRAP group 50%> <WRAP group 50%>
Line 604: Line 680:
 |3  |BCD  | |3  |BCD  |
 </​WRAP>​ </​WRAP>​
-**20. //​useSecondaryKey//​** \\ +**21. //​useSecondaryKey//​** \\ 
 Decides whether to use the secondary encryption key. \\ \\  Decides whether to use the secondary encryption key. \\ \\ 
-**21. //​formatID//​** \\ +**22. //​formatID//​** \\ 
 ID that is used when the card configuration needs to be managed from the database on the BioStar application.\\ \\  ID that is used when the card configuration needs to be managed from the database on the BioStar application.\\ \\ 
-**22. //​reserved5//​** \\ +**23. //​cipher//​** \\ 
 +Activates '​Keypad card ID' option. \\ 
 +Default value is 0, it is only valid for XPass D2 Gangbox Keypad type. \\ 
 +<WRAP group 50%> 
 +^Value ​ ^Description ​ ^ 
 +|0  |Deactivate ​ | 
 +|1  |Activate ​ | 
 +**24. //​reserved5//​** \\ 
 Reserved space. \\  ​ Reserved space. \\  ​
 +</​WRAP>​
  
 ==== BS2FingerprintConfig ==== ==== BS2FingerprintConfig ====
 <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; 
-    uint8_t ​reserved1[32];+    bool         ​checkDuplicate;​ 
 + 
 +    uint8_t ​     ​reserved3[31];
 } BS2FingerprintConfig;​ } BS2FingerprintConfig;​
 </​code>​ </​code>​
Line 676: Line 762:
 Decides whether to display scanned fingerprint image on the screen. \\ \\  Decides whether to display scanned fingerprint image on the screen. \\ \\ 
 **10. //​lfdLevel//​** \\  **10. //​lfdLevel//​** \\ 
-Configuration for the LFD sensitivity. \\+Configuration for the LFD(Live Fingerprint Detection - fake fingerprint detection) ​sensitivity. \\
 <WRAP group 50%> <WRAP group 50%>
 ^Value ​ ^Description ​ ^ ^Value ​ ^Description ​ ^
Line 684: Line 770:
 |3  |Most Strict ​ | |3  |Most Strict ​ |
 </​WRAP>​ </​WRAP>​
-**11. //reserved1//** \\  +**11. //checkDuplicate//​** \\ 
-Reserved space.+[+ V2.6.4] If set to true, it will determine if the fingerprint is a duplicate. \\ \\ 
 +**12. //reserved3//** \\  
 +Reserved space. ​\\ \\
  
 ==== BS2Rs485Config ==== ==== BS2Rs485Config ====
Line 754: Line 842:
  
 typedef struct { typedef struct {
-    uint8_t ​inOut;+    uint8_t ​mode;
     uint8_t useWiegandBypass;​     uint8_t useWiegandBypass;​
     uint8_t useFailCode;​     uint8_t useFailCode;​
Line 797: Line 885:
 **5. //​parityPos//​** \\  **5. //​parityPos//​** \\ 
 Select the position of the parity bit on the wiegand card data. \\ \\ Select the position of the parity bit on the wiegand card data. \\ \\
-**6. //inOut//** \\ +**6. //mode//** \\ 
 Set the wiegand Input/​Output mode. \\ Set the wiegand Input/​Output mode. \\
 <WRAP group 50%> <WRAP group 50%>
Line 803: Line 891:
 |0  |Input ​ | |0  |Input ​ |
 |1  |Output ​ | |1  |Output ​ |
 +|2  |In/​Output ​ |
 </​WRAP>​ </​WRAP>​
 **7. //​useWiegandBypass//​** \\  **7. //​useWiegandBypass//​** \\ 
Line 1147: Line 1236:
     uint32_t deviceID;     uint32_t deviceID;
     uint8_t type;     uint8_t type;
-    uint8_t ​reserved[3];+    uint8_t ​​stopFlag;​ 
 +    uint16_t delay;
     union {     union {
         BS2RelayAction relay;         BS2RelayAction relay;
Line 1237: Line 1327:
 ID of the device that will execute the action. \\ \\ ID of the device that will execute the action. \\ \\
 26. //type// \\  26. //type// \\ 
-Action ​유형입니다. \\+Action ​types. \\
 <WRAP group 50%> <WRAP group 50%>
 ^Value ​ ^Description ​ ^ ^Value ​ ^Description ​ ^
Line 1253: Line 1343:
 |11|Led action| |11|Led action|
 |12|Fire alarm input| |12|Fire alarm input|
 +|13|Auth Success(Access granted)|
 +|14|Auth Fail(Access denied)|
 +|15|Lift action|
 </​WRAP>​ </​WRAP>​
-27. //reserved// \\  +27. //stopFlag// \\  
-Reserved space. \\ \\+Specifies the condition to stop the Action. \\ 
 +If this value is set to 1 and the signal is detected through the door sensor, the action will stop. \\ 
 +If this value is set to 2, it can be stopped only by the current action information. \\ 
 +In general, related APIs that stop an action are called with a zone id, in which case all devices in the zone will stop the action. \\ 
 +By setting stopFlag to 2 and and loading action information,​ you can selectively control only the alarms of that device. 
 +<WRAP group 50%> 
 +^Value ​ ^Description ​ ^ 
 +|0|Don'​t stop| 
 +|1|Stop if door is closed| 
 +|2|Stop by command(Added in V2.6.0)| 
 +</​WRAP>​ 
 +28. //delay// \\  
 +Action delay. Unit is millisecond(ms). \\ \\ 
  
 ==== BS2TriggerActionConfig ==== ==== BS2TriggerActionConfig ====
Line 1459: Line 1565:
 <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;​ 
- uint8_t ​                      reserved3[32]; +    uint8_t ​      lfdLevel; 
 +    bool          quickEnrollment;​ 
 + 
 +    uint8_t ​      ​previewOption;​ 
 +    bool          checkDuplicate;​ 
 +    uint8_t ​      ​reserved[2];​ 
 + 
 +    uint8_t ​      ​reserved2[26];
 } BS2FaceConfig;​ } BS2FaceConfig;​
 </​code>​ </​code>​
-1. //​securityLevel//​ \\ +**1. //​securityLevel//​** \\ 
 Face authentication security level. This is used across the system. . \\  Face authentication security level. This is used across the system. . \\ 
 <WRAP group 50%> <WRAP group 50%>
Line 1476: Line 1589:
 |2  |Most highly secure ​ | |2  |Most highly secure ​ |
 </​WRAP>​ </​WRAP>​
-2. //​lightCondition//​ \\ +**2. //​lightCondition//​** \\ 
 Configuration of the light condition.\\ ​ Configuration of the light condition.\\ ​
 <WRAP group 50%> <WRAP group 50%>
Line 1484: Line 1597:
 |2  |Automatic ​ | |2  |Automatic ​ |
 </​WRAP>​ </​WRAP>​
-3. //​enrollThreshold//​ \\  +**3. //​enrollThreshold//​** \\  
-Threshold of face enrollment.\\ ​+Threshold of face enrollment. ​It determines how much movement of pose is allowed when enrolling the face.  ​\\ 
 <WRAP group 50%> <WRAP group 50%>
 ^Value ​ ^Description ​ ^ ^Value ​ ^Description ​ ^
-|0  |THRESHOLD_0 ​ |+|0  |THRESHOLD_0 ​(Most strict) ​|
 |1  |THRESHOLD_1 | |1  |THRESHOLD_1 |
 |2  |THRESHOLD_2 ​ | |2  |THRESHOLD_2 ​ |
Line 1497: Line 1610:
 |7  |THRESHOLD_7 ​ | |7  |THRESHOLD_7 ​ |
 |8  |THRESHOLD_8 ​ | |8  |THRESHOLD_8 ​ |
-|9  |THRESHOLD_9 ​ |+|9  |THRESHOLD_9 ​(Least strict) ​|
 </​WRAP> ​ </​WRAP> ​
-4. //​detectSensitivity//​ \\ +**4. //​detectSensitivity//​** \\ 
 Configuration of sensitivity on detecting the face. \\  Configuration of sensitivity on detecting the face. \\ 
 <WRAP group 50%> <WRAP group 50%>
Line 1508: Line 1621:
 |3  |High  | |3  |High  |
 </​WRAP>​ </​WRAP>​
-5. //​enrollTimeout//​ \\ +**5. //​enrollTimeout//​** \\ 
 Timeout period of face scanning which is 60 seconds by default.\\ \\ Timeout period of face scanning which is 60 seconds by default.\\ \\
-6. //reserved3// \\  +**6. //lfdLevel//** \\ 
-Reserved space.\\ \\ +[+ V2.6.3] Configuration for the LFD(Live Face Detection - fake face detection) sensitivity. \\ 
 +<WRAP group 50%> 
 +^Value ​ ^Description ​ ^ 
 +|0  |Not Use  | 
 +|1  |Strict ​ | 
 +|2  |More Strict ​ | 
 +|3  |Most Strict ​ | 
 +</​WRAP>​ 
 +**7. //​quickEnrollment//​** \\ 
 +[+ V2.6.3] Quick face enrollment process. \\ 
 +True - Face enrollment process with a single step.\\ 
 +False - Face enrollment rpcoess with 3 steps.\\ 
 +Please use false if you want to enroll with a high quality of face templates. \\ \\ 
 +**8. //​previewOption//​** \\ 
 +[+ V2.6.3] IR camera preview option when you authenticate with face. \\ 
 +Only used to ''​FaceLite''​. \\ 
 +<WRAP group 50%> 
 +^Value ​ ^Description ​ ^ 
 +|0  |Preview not used  | 
 +|1  |Preview not used at frist of authentication,​ preview at 1/2 stage  | 
 +|2  |Preview of all stages on authentication ​ | 
 +</​WRAP>​ 
 +**9. //​checkDuplicate//​** \\ 
 +[+ V2.6.4] Check whether the scanned face is duplicated in the device. \\ \\ 
 +**10. //​reserved//​** ​\\  
 +Reserved space. \\ \\ 
 +**11. //​reserved2//​** \\  
 +Reserved space. \\ \\
 ==== BS2Rs485ConfigEX ==== ==== BS2Rs485ConfigEX ====
 <code cpp> <code cpp>
Line 1605: Line 1744:
 10. //​reserved//​ \\  10. //​reserved//​ \\ 
 Reserved space\\ \\ Reserved space\\ \\
 +==== BS2DstConfig ====
 +<code cpp>
 +enum {
 + BS2_MAX_DST_SCHEDULE = 2,
 +};
 +
 +typedef struct {
 + uint16_t year; // year, 0 means every year.
 + uint8_t month; // [0, 11] : months since January
 + int8_t ordinal;​ //​ [0, -1] : first, second, ..., last
 + uint8_t weekDay; // [0, 6] : days since Sunday
 + uint8_t hour; // [0, 23]
 + uint8_t minute; // [0, 59]
 + uint8_t second; // [0, 59]
 +} BS2WeekTime;​
 +
 +typedef struct {
 + BS2WeekTime startTime;
 + BS2WeekTime endTime;
 + int32_t timeOffset;​ //​ in seconds
 + uint8_t reserved[4];​
 +} BS2DstSchedule;​
 +
 +typedef struct {
 + uint8_t numSchedules;​
 + uint8_t reserved[31];​
 +
 + BS2DstSchedule schedules[BS2_MAX_DST_SCHEDULE];​
 +} BS2DstConfig;​
 +</​code>​
 +1. // year // \\
 +Means year, and if set to 0, it means yearly. \\ \\
 +2. // month // \\
 +Means month, and has a value between 0 and 11 [January-December]. \\ \\
 +3. // ordinal // \\
 +It starts with 0 and means the order of first, second, etc. \\ \\
 +4. // weekDay // \\
 +Day of the week, 0 means Sunday, 1 means Monday. \\ \\
 +5. // hour // \\
 +Specifies the time in 24-hour format. \\ \\
 +6. // minute // \\
 +Specifies the minute. \\ \\
 +7. // second // \\
 +Specifies the seconds. \\ \\
 +8. // startTime // \\
 +It means start date and time. \\ \\
 +9. // endTime // \\
 +It means the end date. \\ \\
 +10. // timeOffset // \\
 +You can apply the DST time in seconds. \\
 +For example, if you want to apply 1 hour, enter 3600. \\ \\
 +11. // reserved // \\
 +Reserved space. \\ \\
 +12. // numSchedules // \\
 +The number of DST schedules to apply. \\ \\
 +13. // schedules // \\
 +DST schedule, up to two can be specified. \\ \\
  
 ==== BS2Configs ==== ==== BS2Configs ====
Line 1666: Line 1862:
 |0x2000000|Multi-Wiegand configuration| |0x2000000|Multi-Wiegand configuration|
 |0x4000000|Extended System configuration| |0x4000000|Extended System configuration|
-|0x8000000|Daylight Saving configuration|+|<del>0x8000000</​del>​|<​del>​Daylight Saving configuration (Deprecated)</​del>​| 
 +|0x10000000|RS485 Extended configuration|  
 +|0x20000000|Extended Card configuration|  
 +|0x40000000|Daylight Saving configuration|
 |0xFFFFFFFF|All configuration| |0xFFFFFFFF|All configuration|
 </​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// \\ 
 +Flag indicating whether to use IP V6. \\ \\ 
 +2. //​reserved1//​ \\ 
 +Reserved space. \\ \\
 +3. //​useDhcpV6//​ \\ 
 +Flag indicating whether to use DHCP. \\ \\ 
 +4. //​useDnsV6//​ \\ 
 +Decides whether to use server address or server URL. \\ \\ 
 +5. //​staticIpAddressV6//​ \\ 
 +Static IP V6 address of current device. \\ \\ 
 +6. //​staticGatewayV6//​ \\ 
 +Static IP V6 address of gateway. \\ \\ 
 +7. //​dnsAddrV6//​ \\ 
 +DNS address. \\ \\ 
 +8. //​serverIpAddressV6//​ \\ 
 +IP address of BioStar. Used only in the server mode. \\ \\ 
 +9. //​serverPortV6//​ \\ 
 +Port number of BioStar. Used only in the server mode. \\ \\ 
 +10. //​sslServerPortV6//​ \\ 
 +Used when the connectionMode is set as server SSL mode, which is the port of the SDK application. \\ \\ 
 +11. //portV6// \\ 
 +Port number of the device. \\ \\ 
 +12. //​numOfAllocatedAddressV6//​ \\ 
 +The number of IP V6 address currently assigned to the device. \\ \\ 
 +13. //​numOfAllocatedGatewayV6//​ \\ 
 +The number of gateway address currently assigned to the device. \\ \\ 
 +14. //​reserved//​ \\ 
 +Reserved space. \\ \\
 +15. //​allocatedIpAddressV6//​ \\ 
 +The IP V6 address currently assigned to the device. \\ \\
 +16. //​allocatedGatewayV6//​ \\ 
 +The gateway address currently assigned to the device.\\ \\
 +
 +==== 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//​ \\ 
 +Application master key of DesFire. \\ \\ 
 +2. //​fileReadKey//​ \\ 
 +The key used to read the file. \\ \\ 
 +3. //​fileWriteKey//​ \\ 
 +The key used to write the file. \\ \\ 
 +4. //​fileReadKeyNumber//​ \\ 
 +The index of the key for reading the file. \\ \\ 
 +5. //​fileWriteKeyNumber//​ \\ 
 +The index of the key for writing the file. \\ \\ 
 +6. //​reserved//​ \\ 
 +Reserved space. \\ \\
 +7. //​desfireAppKey//​ \\ 
 +A structure containing DesFire key information. \\ \\ 
 +8. //​reserved//​ \\
 +Reserved space. \\