문서의 이전 판입니다!


날짜

2017-3-24

주의사항


BioStar 2 Device SDK v2.4 에서 추가된 새로운 함수들은 2.4 펌웨어 그룹에서만 지원됩니다. 아래 목록에서 새로운 함수들을 사용할 수 있는 펌웨어 버전을 확인하십시오.

v2.4용 신규 함수


v2.4 펌웨어 그룹

장치명 펌웨어 버전
BioStation 2 1.4.0
BioStation A2 1.3.0
BioStation L2 1.2.0
BioEntry W2 1.1.0

신규 기능

1. 신규 장치인 엘레베이터 컨트롤러 OM-120이 출시되었습니다. 해당 장치를 SDK 고객의 시스템에 통합할 수 있도록 신규 API 와 구조체가 추가되었습니다.

OM-120은 Lift에 사용할 수있는 12 개의 Relay를 제어 할 수있는 새로운 장치입니다. 이제는 door와 똑같이 작동하는 새로운 개념의 floor가 있습니다. 사용자가 인증되면 OM-120의 릴레이에 연결된 층은 Access group의 floor level에 따라 활성화됩니다. floor level은 Access level과 동일한 개념이며 둘 다 액세스 그룹에 할당됩니다.

2. 새로운 FaceStation 2는 2017 년 2 분기에 출시 될 예정입니다. v2.4는 FaceStation 2를 출시 이후 바로 사용될 수 있도록 모든 기능을 구현했습니7다.

FaceStation 2는 1:N Matching에 최대 5,000 명의 사용자를 사용할 수 있는 그룹 매칭 기능을 지원합니다. 사용자는 자신이 속한 그룹을 선택한 뒤 얼굴 매칭할 수 있습니다.

3. 특정 장치는 카드의 v1 Template과 호환됩니다. v1 및 v2 장치가 함께 사용되는 곳에서 호환되지 않는 단점이 있었지만, 이제 v1 장치에서 미리 발급 된 카드를 읽을 수 있습니다./

v1 장치에서 발행된 ToC(Template on Card)가 v2 장치에서 읽을 수 있도록 설정되었습니다. v2 장치는 시작 block index가 카드의 v1 장치의 CIS index block과 동일하게 설정되어야 합니다. v1 ToC와 v2 Access on Card/Secure Credential Card를 함께 사용하기 위해서는,동일한 시작 block index와 CIS index block를 사용해야 합니다.

4. T&A SW와의 연동성을 위해 Job Code가 추가되었습니다. Job Code를 사용자에게 할당하고 로그에서 Job Code 정보를 얻을 수 있습니다. 이 기능은 v2.4 FW 그룹에만 포함됩니다.

기존 BS2UserBlob 구조의 크기 제한으로 인해 새로운 기능 구현을 위한 새로운 구조를 만들어야했습니다. 새로운 BS2UserBlobEx 구조는 Job Code 필드를 포함하는 v2.4 FW 그룹에서만 동작합니다. 각 사용자는 각 Job Code에 대해 고유 코드 및 이름을 갖습니다.

5. 로그를 검색하는 새로운 방법이 추가되었습니다.

기존 API BS2_GetLog는 Job Code를 포함한 로그를 가져올 수 없었습니다. 이제 이벤트 blob을 가져 오는 새로운 API가 있습니다. 이벤트 blob는 마스크 값을 사용하여 분류할 수 있으며 로그의 유형에 따라 로그를 가져올 수 있습니다.

6. 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.

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 BS2UserBlob structure, there were needs to create a new structure to implement a new feature. The new BS2UserBlobEx structure will work only with the v2.4 FW group which includes a field for personal messages.

7. 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.



Changed Objects

1. Parameter outQuality 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

#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);

AFTER

#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);


2. Field useJobCode, useAlphanumericID, cameraFrequency has been added to the BS2SystemConfig structure
The useJobCode 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 useAlphanumericID field and allow users to input an alphanumeric ID for authentication.
The camera frequency can be changed for the BioStation A2 device using the cameraFrequency field.

3. Parameter rs485mode, sslSupported, rootCertExist, dualIDSupported, useAlphanumericID, connectedIP, phraseCodeSupported, card1xSupported, systemExtSupported, voipSupported has been added to the BS2SimpleDeviceInfo Structure
The BS2SimpleDeviceInfo Structure has additional fields that will indicate the capability and status of the device.

rs485mode is a field where it determines the RS-485 mode of the device
sslSupported is a field that indicates whether the device supports SSL connection
rootCertExist is a field that indicates whether the device has the root certificate
dualIDSupported is a field that indicates whether the device supports alphanumeric ID
useAlphanumericID is a field where it determines the device is set to use alphanumeric ID
connectedIP is a field where it determines the IP address of the server that the device is connected to
phraseCodeSupported is a field that indicates whether the device supports personal messages
card1xSupported is a field that indicates whether the device supports v1 ToC cards
systemExtSupported is a field that indicates whether the device can set the RS-485 master key
voipSupported is a field that indicates whether the device supports VoIP


Bug Fixes

1. 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.

2. The ALL mask of BS2_GetConfig was not working properly. This was caused because the buffer size was set smaller than the added structure BS2MultiWiegandConfig. Now the buffer size has been increased so the ALL mask will work properly.

3. 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.