Differences

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

Link to this comparison view

Next revision
Previous revision
en:release_note_260 [2018/04/16 17:25]
yjjung created
en:release_note_260 [2023/08/17 13:36] (current)
Line 1: Line 1:
-FIXME **This page is not fully translated, yet. Please help completing the translation.**\\ //(remove this paragraph once the translation is finished)// 
- 
 ===== Version 2.6.0 ===== ===== Version 2.6.0 =====
 +==== Date ====
 +2018-10-31 ​
 +
 +<WRAP indent>
 +<WRAP info 70%>
 +**NOTE**\\
 +After V2.5.0, it was reflected in V2.6.0 through bug fixes and additional supplements,​ but missing contents were added to the manual.
 +</​WRAP>​
 +</​WRAP>​
 +\\
 +
 +==== New Features ====
 +  * Support reading USB memory (BioStation A2, FaceStation 2)
 +  * Supports Debugging API
 +  * Supports server port change
 +  * Supports Global APB zone feature
 +  * Supports device connection status check feature
 +  * Supports automatic connection check and change feature
 +
 +<text size="​x-large">​1.</​text>​ Added USB memory read feature.
 +
 +  * Add API [[BS2_AllocateUsbContext]]
 +  * Add API [[BS2_ReleaseUsbContext]] ​
 +  * Add API [[BS2_GetUserDatabaseInfoFromDir]] ​
 +  * Add API [[BS2_GetUserListFromDir]]
 +  * Add API [[BS2_GetUserInfosFromDir]] ​
 +  * Add API [[BS2_GetUserDatasFromDir]] ​
 +  * Add API [[BS2_GetUserInfosExFromDir]] ​
 +  * Add API [[BS2_GetUserDatasExFromDir]] ​
 +  * Add API [[BS2_GetLogFromDir]] ​
 +  * Add API [[BS2_GetLogBlobFromDir]]
 +  * Add API [[BS2_GetFilteredLogFromDir]]
 +
 +<text size="​x-large">​2.</​text>​ Added to refer to debug information that occurs in the SDK.
 +
 +  * Add API [[BS2_SetDebugExCallback]]
 +
 +<text size="​x-large">​3.</​text>​ Added server port designation feature.
 +
 +  * Add API [[BS2_SetServerPort]]
 +  * Add API [[BS2_SetSSLServerPort]]
 +
 +<text size="​x-large">​4.</​text>​ Added Global APB zone feature.
 +
 +  * Add API [[BS2_SetCheckGlobalAPBViolationHandler]]
 +  * Add API [[BS2_CheckGlobalAPBViolation]]
 +
 +<text size="​x-large">​5.</​text>​ Added device connection status check feature.
 +
 +  * Add API [[BS2_IsConnected]]
 +
 +<text size="​x-large">​6.</​text>​ Added to automatic connection check and change feature.
 +
 +  * Add API [[BS2_IsAutoConnection]]
 +  * Add API [[BS2_SetAutoConnection]]
 +
 +==== Modified Features ====
 +
 +<text size="​x-large">​1.</​text>​ In some functions, the event mask judgment condition set when acquiring logs has been modified. \\
 +(Logs that satisfy all set masks → Logs that satisfy even one) \\
 +  * Refer to API [[BS2_GetLogBlob]]
 +  * Refer to API [[BS2_GetLogBlobFromDir]]
 +
 +<text size="​x-large">​2.</​text>​ Fixed an Invalid Parameter error that occurs when the set userMask is greater than 0x3FF when obtaining user information in some functions. \\
 +  * Refer to API [[BS2_GetUserDatas]]
 +  * Refer to API [[BS2_GetUserDatasEx]]
 +  * Refer to API [[BS2_GetUserDatasFromDir]]
 +  * Refer to API [[BS2_GetUserDatasExFromDir]]
 +
 +<text size="​x-large">​3.</​text>​ Fixed a problem where a crash could occur in the context release phase when using Multi context. \\
 +In addition, fixed a problem that could cause an access violation intermittently. \\
 +  * Refer to API [[BS2_AllocateContext]]
 +  * Refer to API [[BS2_ReleaseContext]]
 +
 +<text size="​x-large">​4.</​text>​ Fixed a problem where a crash could occur due to a buffer overflow while receiving a packet from the SDK. \\
 +
 +<text size="​x-large">​5.</​text>​ Fixed a problem that caused a timeout occurs when deleting all users from an Entry family device. \\
 +  * Refer to API [[BS2_RemoveAllUser]]
 +
 +<text size="​x-large">​6.</​text>​ Fixed a problem where a Not Supported error occurs when userMask is BS2_USER_MASK_ALL when obtaining user information. \\
 +  * Refer to API [[BS2_GetSupportedConfigMask]]
 +  * Refer to API [[BS2_GetSupportedUserMask]]
 +  * Refer to API [[BS2_GetUserDatas]]
 +  * Refer to API [[BS2_GetUserDatasEx]]
 +
 +<text size="​x-large">​7.</​text>​ Fixed a problem where a crash could occur when there is no data when obtaining logs. \\
 +  * Refer to API [[BS2_GetLog]]
 +  * Refer to API [[BS2_GetFilteredLog]]
 +  * Refer to API [[BS2_GetLogFromDir]]
 +
 +<text size="​x-large">​8.</​text>​ Fixed a problem where packet for multi packet could be discarded during RS485 communications. \\
 +
 +<text size="​x-large">​9.</​text>​ Fixed a problem where the timer may not work on Linux SDK. (Change from signal method to thread method) \\
 +
 +<text size="​x-large">​10.</​text>​ Fixed a problem that dead-lock could occur due to memory allocation in signal handle in Linux SDK. \\
 +
 +<text size="​x-large">​11.</​text>​ Added socket close option SOCK_CLOEXEC when using socket on Linux. \\
 +
 +<text size="​x-large">​12.</​text>​ Fixed a problem with lock/unlock incorrect sync objects internally when using the Server matching function. \\
 +
 +<text size="​x-large">​13.</​text>​ Keep alive code has been improved to detect the disconnected status among the device status. \\
 +
 +<text size="​x-large">​14.</​text>​ Fixed a problem where Intrusion Alarm Zone information was not set. \\
 +In addition, incorrect error judgment conditions during validation have been corrected. \\
 +Before: (0 < door) AND (if there no card data), (0 < card) AND (if there no door ID) \\
 +After: (0 < door) AND (if there no door ID), (0 < card) AND (if there no card data) \\
 +  * Refer to API [[BS2_SetIntrusionAlarmZone]]
 +
 +<text size="​x-large">​15.</​text>​ Fixed blocking until the timeout occurs when loading an image log that does not actually exist. \\
 +  * Refer to API [[BS2_GetImageLog]]
 +  * Refer to API [[BS2_GetLogBlobFromDir]]
 +
 +<text size="​x-large">​16.</​text>​ Fixed a problem so that allocation memory errors do not occur when there is no data in the **Intrusion Alarm Zone**. \\
 +In addition, it has been modified to return only the count when zoneBlob is NULL. \\
 +  * Refer to API [[BS2_GetIntrusionAlarmZone]]
 +
 +<text size="​x-large">​17.</​text>​ Fixed a problem where TCP connection was no longer possible when Socket-related internal resources were exhausted. \\
 +
 +<text size="​x-large">​18.</​text>​ It has been modified so that it is returned as an Invalid Parameter when door ID exceeds 65535 when setting the door from an Entry family device. \\
 +  * Refer to API [[BS2_SetDoor]]
 +
 +<text size="​x-large">​19.</​text>​ Added cryptographic activation code to handshake phase on TCP connection. \\
 +
 +<text size="​x-large">​20.</​text>​ Fixed a problem where fingerprint information was not stored on FaceStation 2. \\
 +
 +<text size="​x-large">​21.</​text>​ Fixed a problem where a crash occurs when using the [[BS2_SearchDevicesCoreStation]] function. \\
 +
 +<text size="​x-large">​22.</​text>​ Fixed to validate a template and image size of the face when using the [[BS2_EnrolUser]] function. \\
 +
 +<text size="​x-large">​23.</​text>​ Fixed a problem of returning Not supported when using the below function. \\
 +  * Refer to API [[BS2_GetCardConfigEx]]
 +  * Refer to API [[BS2_GetRs485ConfigEx]]
 +
 +
 ==== Date ==== ==== Date ====
 2018-04-15 ​ 2018-04-15 ​
  
 <callout type="​warning"​ icon="​true">​ <callout type="​warning"​ icon="​true">​
-<wrap em>CAUTION</​wrap> ​\\+**CAUTION** \\
 Up to version 2.5.0, Device SDK statically included OpenSSL library,\\ Up to version 2.5.0, Device SDK statically included OpenSSL library,\\
 but starting with 2.6.0, it has been changed to link in shared library form. \\ but starting with 2.6.0, it has been changed to link in shared library form. \\
Line 17: Line 149:
 ==== New Features ==== ==== New Features ====
   * Supports ​ for new device connections (BioLite N2, Xpass D2)   * Supports ​ for new device connections (BioLite N2, Xpass D2)
-  supports ​Daylight saving time (DST)  +  ​Supports ​Daylight saving time (DST)  
-  supports ​Interlock zone  +  Supports ​Interlock zone  
-  * Supports data encryption key setting of device +  * Supports data encryption key setting of device 
-  * Factory default without network setting +  * Factory default without network setting 
-<text size="​x-large">​1.</​text>​New devices BioLite N2, Xpass D2 are supported. Xpass D2 is a slave exclusive card device.+ 
 +<text size="​x-large">​1.</​text>​New devices BioLite N2, Xpass D2 are supported. Xpass D2 is a slave exclusive card device.\\
 <text size="​x-large">​2.</​text>​Daylight Saving Time can be set up to 2 devices. In addition, relevant information has been added to the log to let you know when daylight saving time is in effect. <text size="​x-large">​2.</​text>​Daylight Saving Time can be set up to 2 devices. In addition, relevant information has been added to the log to let you know when daylight saving time is in effect.
  
-  * API [[BS2_GetDstConfig]] ​has been added +  * Add API [[BS2_GetDstConfig]] 
-  * API [[BS2_SetDstConfig]] ​has been added +  * Add API [[BS2_SetDstConfig]] 
-  * Structure ​[[configuration api#​BS2DstConfig]] ​has been added +  * Add structure ​[[configuration api#​BS2DstConfig]] 
-  * Structure ​[[Log_Management_API#​BS2Event]] ​has been modified+  * Modify structure ​[[Log_Management_API#​BS2Event]]
  
-<text size="​x-large">​3.</​text>​인터락 구역 설정을 지원합니다. 이중 문으로 구성되어 한 쪽 문과, 다른 한 쪽 문이 서로 배타적으로 잠겨있어야 하는 경우 사용됩니다. 현재 CoreStation만 사용가능합니다.+<text size="​x-large">​3.</​text>​
 Interlock zone setting is supported. It is used when one door and the other door need to be exclusively locked to each other. Currently only CoreStation is available. Interlock zone setting is supported. It is used when one door and the other door need to be exclusively locked to each other. Currently only CoreStation is available.
  
-  * API [[BS2_GetInterlockZone]] ​has been added +  * Add API [[BS2_GetInterlockZone]] 
-  * API [[BS2_GetInterlockZoneStatus]] ​has been added  +  * Add API [[BS2_GetInterlockZoneStatus]] 
-  * API [[BS2_GetAllInterlockZoneStatus]] ​has been added    +  * Add API [[BS2_GetAllInterlockZoneStatus]] 
-  * API [[BS2_SetInterlockZone]] ​has been added +  * Add API [[BS2_SetInterlockZone]] 
-  * API [[BS2_SetInterlockZoneAlarm]] ​has been added +  * Add API [[BS2_SetInterlockZoneAlarm]] 
-  * API [[BS2_RemoveInterlockZone]] ​has been added  +  * Add API [[BS2_RemoveInterlockZone]]  
-  * API [[BS2_RemoveAllInterlockZone]] ​has been added +  * Add API [[BS2_RemoveAllInterlockZone]] 
-  * Structure ​[[zone control api#​BS2InterlockZoneBlob]] ​has been added+  * Add structure ​[[zone control api#​BS2InterlockZoneBlob]]
  
 <text size="​x-large">​4.</​text>​Data Encryption key of the device can be changed and verified. <text size="​x-large">​4.</​text>​Data Encryption key of the device can be changed and verified.
-  * API [[BS2_GetDataEncryptKey]] ​has been added +  * Add API [[BS2_GetDataEncryptKey]] 
-  * API [[BS2_SetDataEncryptKey]] ​has been added +  * Add API [[BS2_SetDataEncryptKey]] 
-  * API [[BS2_RemoveDataEncryptKey]] ​has been added +  * Add API [[BS2_RemoveDataEncryptKey]] 
 + 
 +<text size="​x-large">​5.</​text>​Supports new device initialization API BS2_ResetConfigExceptNetInfo. This API can factory default without network information unlike BS2_ResetConfig. 
 + 
 +  * Add API [[BS2_ResetConfigExceptNetInfo]]
  
-<text size="​x-large">​5.</​text>​신규 장치초기화 함수 BS2_ResetConfigExceptNetInfo를 지원합니다. 이 함수는 BS2_ResetConfig와 비교하여 네트워크 정보를 제외한 초기화가 가능합니다.Supports ​new device initialization ​API BS2_ResetConfigExceptNetInfo. This API can factory default without network information unlike BS2_ResetConfig.+<text size="​x-large">​6.</​text>​Supports ​feature feasibility check API BS2_GetDeviceInfoEx. This API BS2_GetDeviceInfo uses structure BS2SimpleDeviceInfoEx which has recent fields moved from the BS2SimpleDeviceInfo.
  
-  * API [[BS2_ResetConfigExceptNetInfo]] has been added +  * Add API [[BS2_GetDeviceInfoEx]] 
 +  * Add structure [[device_api # BS2SimpleDeviceInfoEx]]
  
 ==== Modified features ==== ==== Modified features ====
Line 57: Line 195:
  
 <text size="​x-large">​2.</​text>​ Device security tamper setting is supported. \\ <text size="​x-large">​2.</​text>​ Device security tamper setting is supported. \\
- ​BS2SystemConfig의 secureTamper를 통해 현재 보안템퍼가 설정되어 있는지 확인 및 설정이 가능합니다. \\ 
- 이 구조체 정보는 반드시 BS2_GetSystemConfig를 통해 읽어낸 후, 필요한 정보만 수정하고 BS2_SetSystemConfig로 설정하여야 합니다. \\ 
 The secureTamper of BS2SystemConfig can check and set whether the current security tamper is set. \\ The secureTamper of BS2SystemConfig can check and set whether the current security tamper is set. \\
   This structure must be configured after reading through BS2_GetSystemConfig,​ and then only necessary information should be modified through BS2_SetSystemConfig. \\   This structure must be configured after reading through BS2_GetSystemConfig,​ and then only necessary information should be modified through BS2_SetSystemConfig. \\
   * Refer to structure [[configuration api#​BS2SystemConfig]]   * Refer to structure [[configuration api#​BS2SystemConfig]]
  
 +<text size="​x-large">​3.</​text>​ Fingerprinter is supported on FaceStation 2 or FaceLite\\
 +Both FaceStation 2 and FaceLite do not have a fingerprint sensor and therefore do not support fingerprint authentication directly from those devices. ​
 +However, fingerprint devices can be connected to as a slave device to either device, then it means fingerprint matching is supported. \\
 +Thus, BS2SimpleDeviceInfo.fingersupported changed from 0 to 1. \\
 +Whether or not the device currently supports fingerprint matching can be checked via fingerSupported in BS2SimpleDeviceInfo. \\
 +  * Refer to structure [[device_api#​BS2SimpleDeviceInfo]] ​