Differences
This shows you the differences between two versions of the page.
|
en:release_note_240 [2023/03/02 14:29] 127.0.0.1 external edit |
en:release_note_240 [2023/08/17 13:32] |
||
|---|---|---|---|
| Line 1: | Line 1: | ||
| - | ===== Version 2.4.0 ===== | ||
| - | <WRAP em><text size="x-large">Date</text></WRAP> 2017-3-24 | ||
| - | \\ | ||
| - | \\ | ||
| - | <callout type="warning" icon="true"><WRAP em>Caution</WRAP> \\ | ||
| - | New APIs have been added that will work only with the v2.4 FW group. Please check the FW that will be compatible with the new APIs.\\ | ||
| - | \\ | ||
| - | <text size="large">New API for v2.4</text>\\ | ||
| - | * API [[BS2_EnrolUserEx]] has been added | ||
| - | * API [[BS2_GetUserInfosEx]] has been added | ||
| - | * Structure [[user management api#BS2UserBlobEx]] has been added | ||
| - | * [[ssl api]] has been added | ||
| - | \\ | ||
| - | |||
| - | |||
| - | <text size="large">v2.4 Firmware Group</text>\\ | ||
| - | <WRAP group 40%> | ||
| - | ^Device ^FW version ^ | ||
| - | |BioStation 2 |1.4.0 or higher | | ||
| - | |BioStation A2 |1.3.0 or higher | | ||
| - | |BioStation L2 |1.2.0 or higher | | ||
| - | |BioEntry W2 |1.1.0 or higher | | ||
| - | </WRAP> | ||
| - | </callout> | ||
| - | \\ | ||
| - | |||
| - | <WRAP em><text size="x-large">New Features</text></WRAP> | ||
| - | <text size="x-large">1.</text> A brand new lift controller OM-120 has been released. New APIs and structures were added to allow SDK users to integrate this device and features to their own system.\\ | ||
| - | * [[lift control api]] has been added | ||
| - | |||
| - | The OM-120 is a new device having capability of controlling 12 relays which can be used for lifts. There is now a new concept as floors, which will work exactly like the doors. Once a user authenticates, the floors connected to the relays of the OM-120 will be activated depending on the floor level the access group has. The floor level is the same concept of the access level and they both will be allocated to an access group.\\ | ||
| - | \\ | ||
| - | |||
| - | <text size="x-large">2.</text> The new FaceStation 2 will be released in the 2nd quarter of 2017. The v2.4 has implemented all features so the FaceStation 2 can be used right away with its release. | ||
| - | \\ | ||
| - | * [[face api]] has been added | ||
| - | The FaceStation 2 will be supporting a feature called group matching, which is a feature where you can have maximum 5000 users to be used for 1:N matching. The user can select the group that they belong to, and continue with the face matching.\\ | ||
| - | \\ | ||
| - | |||
| - | <text size="x-large">3.</text> Certain devices will be compatible with the v1 Template on Cards. It was a downside of the v2 devices since there can be sites having v1 and v2 devices mixed. Now, it is possible to read the pre-issued cards from the v1 devices. | ||
| - | \\ | ||
| - | * Structure [[configuration api#BS1CardConfig]] has been added | ||
| - | The v2 devices can now be set to read Template on Cards issued from a v1 device. The v2 device will need the starting block index to be the same as the CIS index block of the v1 Template on Card. To use both v1 Template on Card, v2 Access on Card/Secure Credential Card together, they will need to share the same starting block index and CIS index block.\\ | ||
| - | \\ | ||
| - | |||
| - | <text size="x-large">4.</text> Job code has been added to support flexibility on integrations with a T&A software. It is possible to allocate job codes to users and get the job code information from the logs. This feature is included only with the v2.4 FW group. | ||
| - | \\ | ||
| - | * Structure [[user management api#BS2UserBlobEx]] has been added | ||
| - | Due to the limitation on size of the existing [[user management api#BS2UserBlob]] structure, there were needs to create a new structure to implement a new feature. The new [[user management api#BS2UserBlobEx]] structure will work only with the v2.4 FW group which includes a field for the job code. Each user will have their own code and name for each job code.\\ | ||
| - | \\ | ||
| - | |||
| - | <text size="x-large">5.</text> A new method to retrieve logs has been added. | ||
| - | \\ | ||
| - | * API [[BS2_GetLogBlob]] has been added | ||
| - | * Structure [[log management api#BS2EventBlob]] has been added | ||
| - | The existing API [[BS2_GetLog]] was not capable to get logs including the job code. Now there is a new API where it gets the event blob. The event blob can be categorized using a mask value, which leads to be possible to get logs based on the type of the log.\\ | ||
| - | \\ | ||
| - | |||
| - | <text size="x-large">6.</text> Personal messages will be supported from the next version of the firmware for certain devices. This was implemented to be ready to use once the releases are made. | ||
| - | \\ | ||
| - | * Structure [[user management api#BS2UserBlobEx]] has been added | ||
| - | This feature will be supported starting from the FaceStation 2. The rest of the devices with a display screen will support this feature in the future release.\\ | ||
| - | Due to the limitation on size of the existing [[user management api#BS2UserBlob]] structure, there were needs to create a new structure to implement a new feature. The new [[user management api#BS2UserBlobEx]] structure will work only with the v2.4 FW group which includes a field for personal messages. | ||
| - | \\ | ||
| - | |||
| - | <text size="x-large">7.</text> SSL Communication will be available between the server and devices. This will allow the devices to be only connected to a server where the certificate is valid. | ||
| - | \\ | ||
| - | * [[ssl api]] has been added | ||
| - | \\ | ||
| - | \\ | ||
| - | |||
| - | <WRAP em><text size="x-large">Changed Objects</text></WRAP> | ||
| - | |||
| - | <text size="x-large">1.</text> Parameter <text type="success">**outQuality**</text> has been added to the [[BS2_ScanFingerprint]] API \\ | ||
| - | The [[BS2_ScanFingerprint]] API now has a new parameter which returns the quality score of the scanned fingerprint. This was added to give a proper feedback to make fingerprint template management more efficient. | ||
| - | \\ | ||
| - | |||
| - | **BEFORE** \\ | ||
| - | <code cpp> | ||
| - | #include "BS_API.h" | ||
| - | |||
| - | int BS2_ScanFingerprint(void* context, uint32_t deviceId, BS2Fingerprint* finger, uint32_t templateIndex, uint32_t quality, uint8_t templateFormat, OnReadyToScan ptrReadyToScan); | ||
| - | </code> | ||
| - | **AFTER**\\ | ||
| - | <code cpp> | ||
| - | #include "BS_API.h" | ||
| - | |||
| - | int BS2_ScanFingerprint(void* context, uint32_t deviceId, BS2Fingerprint* finger, uint32_t templateIndex, uint32_t quality, uint8_t templateFormat, uint32_t* outQuality, OnReadyToScan ptrReadyToScan); | ||
| - | </code> | ||
| - | \\ | ||
| - | |||
| - | <text size="x-large">2.</text> Field <text type="success">**useJobCode, useAlphanumericID, cameraFrequency**</text> has been added to the [[Configuration API#BS2SystemConfig]] structure \\ | ||
| - | The <text type="success">**useJobCode**</text> field was added to allow enable/disable the usage of job codes.\\ | ||
| - | The alphanumeric ID was already allowed in the certain devices such as, BioStation 2, BioStation A2, BioStation L2, and BioEntry W2. However, the devices with display screens did not support keypads that allowed ID + credential authentications. Starting from the v2.4 FW group, the devices with a display screen can change the value of the <text type="success">**useAlphanumericID**</text> field and allow users to input an alphanumeric ID for authentication.\\ | ||
| - | The camera frequency can be changed for the BioStation A2 device using the <text type="success">**cameraFrequency**</text> field. | ||
| - | \\ | ||
| - | |||
| - | <text size="x-large">3.</text> Parameter <text type="success">**rs485mode, sslSupported, rootCertExist, dualIDSupported, useAlphanumericID, connectedIP, phraseCodeSupported, card1xSupported, systemExtSupported, voipSupported**</text> has been added to the [[Device API#BS2SimpleDeviceInfo]] Structure \\ | ||
| - | The [[Device API#BS2SimpleDeviceInfo]] Structure has additional fields that will indicate the capability and status of the device.\\ | ||
| - | \\ | ||
| - | <text type="success">**rs485mode**</text> is a field where it determines the RS-485 mode of the device\\ | ||
| - | <text type="success">**sslSupported**</text> is a field that indicates whether the device supports SSL connection\\ | ||
| - | <text type="success">**rootCertExist**</text> is a field that indicates whether the device has the root certificate\\ | ||
| - | <text type="success">**dualIDSupported**</text> is a field that indicates whether the device supports alphanumeric ID\\ | ||
| - | <text type="success">**useAlphanumericID**</text> is a field where it determines the device is set to use alphanumeric ID\\ | ||
| - | <text type="success">**connectedIP**</text> is a field where it determines the IP address of the server that the device is connected to\\ | ||
| - | <text type="success">**phraseCodeSupported**</text> is a field that indicates whether the device supports personal messages\\ | ||
| - | <text type="success">**card1xSupported**</text> is a field that indicates whether the device supports v1 ToC cards\\ | ||
| - | <text type="success">**systemExtSupported**</text> is a field that indicates whether the device can set the RS-485 master key\\ | ||
| - | <text type="success">**voipSupported**</text> is a field that indicates whether the device supports VoIP\\ | ||
| - | |||
| - | \\ | ||
| - | |||
| - | <WRAP em><text size="x-large">Bug Fixes</text></WRAP> | ||
| - | |||
| - | <text size="x-large">1.</text> The UDP packet payload size has been changed starting from the v2.4 FW group. The SDK was modified to support both payload sizes for the old and new firmware.\\ | ||
| - | \\ | ||
| - | |||
| - | <text size="x-large">2.</text> The ALL mask of [[BS2_GetConfig]] was not working properly. This was caused because the buffer size was set smaller than the added structure [[Configuration API#BS2MultiWiegandConfig]]. Now the buffer size has been increased so the ALL mask will work properly.\\ | ||
| - | \\ | ||
| - | |||
| - | <text size="x-large">3.</text> The BioEntry Plus and BioEntry W did had the capability of using the multiple wiegand feature, but was ruled out in the SDK. Now these devices can operate using the multiple wiegand feature.\\ | ||
| - | \\ | ||
| - | |||