Differences

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

--- en:device_api [2019/05/27 16:20]
yjjung
+++ en:device_api [2024/02/27 13:42]
@@ Line 1: / Line 1: @@
-====== Device API ======
-API that controls the device information or upgrade the firmware.\\
-  * [[BS2_GetDeviceInfo]]: Gets the device information.
-  * [[BS2_GetDeviceInfoEx]]: [+ 2.6.0] Gets additional device information.
-  * [[BS2_GetDeviceTime]]: Gets the device time.
-  * [[BS2_SetDeviceTime]]: Sets the device time.
-  * [[BS2_ClearDatabase]]: Initializes the user information and blacklist.
-  * [[BS2_FactoryReset]]: Initializes all configurations and the database.
-  * [[BS2_RebootDevice]]: Restarts the device.
-  * [[BS2_LockDevice]]: Doesn't allow user authentication by locking the device.
-  * [[BS2_UnlockDevice]]: Allows user authentication by unlocking the device.
-  * [[BS2_SetKeepAliveTimeout]]: Configures the keep-alive time of the device.
-  * [[BS2_UpgradeFirmware]]: Upgrades the firmware.
-  * [[BS2_UpdateResource]]: Updates the resource.
-  * [[BS2_GetSpecifiedDeviceInfo]]: [+ 2.6.3] Gets specified device information.
-  * [[BS2_GetAuthOperatorLevelEx]]: [+ 2.6.3] Gets specified device operator. (Support operator up to 1000)
-  * [[BS2_GetAllAuthOperatorLevelEx]]: [+ 2.6.3] Gets all device operators. (Support operator up to 1000)
-  * [[BS2_SetAuthOperatorLevelEx]]: [+ 2.6.3] Sets device operator. (Support operator up to 1000)
-  * [[BS2_RemoveAuthOperatorLevelEx]]: [+ 2.6.3] Remove specified device operator. (Support operator up to 1000)
-  * [[BS2_RemoveAllAuthOperatorLevelEx]]: [+ 2.6.3] Remove all device operators. (Support operator up to 1000)
-===== Structure =====
-==== BS2SimpleDeviceInfo ====
-<code cpp>
-typedef struct
-{
-    uint32_t id;
-    uint16_t type;
-    uint8_t connectionMode;
-    uint32_t ipv4Address;
-    uint16_t port;
-    uint32_t maxNumOfUser;
-    uint8_t userNameSupported;
-    uint8_t userPhotoSupported;
-    uint8_t pinSupported;
-    uint8_t cardSupported;
-    uint8_t fingerSupported;
-    uint8_t faceSupported;
-    uint8_t wlanSupported;
-    uint8_t tnaSupported;
-    uint8_t triggerActionSupported;
-    uint8_t wiegandSupported;
-    uint8_t imageLogSupported;
-    uint8_t dnsSupported;
-    uint8_t jobCodeSupported;
-    uint8_t wiegandMultiSupported;
-    uint8_t rs485Mode;
-    uint8_t sslSupported;
-    uint8_t rootCertExist;
-    uint8_t dualIDSupported;
-    uint8_t useAlphanumericID;
-    uint32_t connectedIP;
-    uint8_t phraseCodeSupported;
-    uint8_t card1xSupported;
-    uint8_t systemExtSupported;
-    uint8_t voipSupported;
-}BS2SimpleDeviceInfo;
-</code>
-**1. //id//** \\
-The device identifier which is always above 1. \\
-**2. //type//** \\
-Code value of device type.
-<WRAP group 50%>
-^Value  ^Description  ^
-|0x01  |BioEntry Plus  |
-|0x02  |BioEntry W  |
-|0x03  |BioLite Net  |
-|0x04  |Xpass  |
-|0x05  |Xpass S2  |
-|0x06  |Secure IO 2  |
-|0x07  |DM-20  |
-|0x08  |BioStation 2  |
-|0x09  |BioStation A2  |
-|0x0A  |FaceStation 2  |
-|0x0B  |IO Device  |
-|0x0C  |BioStation L2  |
-|0x0D  |BioEntry W2  |
-|0x0E  |CoreStation  |
-|0x0F  |Output Module|
-|0x10  |Input Module|
-|0x11  |BioEntry P2|
-|0x0F  |OM-120  |
-</WRAP>
-**3. //connectionMode//** \\
-It indicates the connection mode between the BioStar application and device which is separated by the subject of the connection as direct mode(0x0) and server mode(0x1). The BioStar application connects to the device in direct mode, and the device connects to the BioStar application in server mode. The default settings for the devices are direct mode, and to change the connection mode refer to [[configuration_api#IP Config]]. \\
-**4. //ipv4Address//** \\
-IP address of the selected device. \\
-**5. //port//** \\
-TCP port number of the selected device. \\
-**6. //maxNumOfUser//** \\
-Maximum capacity of users that can be stored in the device. \\
-**7. //userNameSupported//** \\
-Flag that notifies whether the device supports user name. \\
-**8. //userPhotoSupported//** \\
-Flag that notifies whether the device supports user profile picture. \\
-**9. //pinSupported//** \\
-Flag that notifies whether the device supports PIN. \\
-**10. //cardSupported//** \\
-Flag that notifies whether the device supports Smart card authentication. \\
-**11. //fingerSupported//** \\
-Flag that notifies whether the device supports finger authentication. \\
-**12. //faceSupported//** \\
-Flag that notifies whether the device supports face recognition. \\
-**13. //wlanSupported//** \\
-Flag that notifies whether the device supports wireless LAN. \\
-**14. //tnaSupported//** \\
-Flag that notifies whether the device supports time and attendance. \\
-**15. //triggerActionSupported//** \\
-Flag that notifies whether the device supports trigger action. \\
-**16. //wiegandSupported//** \\
-Flag that notifies whether the device supports wiegand. \\
-**17. //imageLogSupported//** \\
-Flag that notifies whether the device supports image logs. \\
-**18. //dnsSupported//** \\
-Flag that notifies whether the device supports DNS.\\
-**19. //jobCodeSupported//** \\
-Flag that notifies whether the device supports job codes.\\
-**20. //wiegandMultiSupported//** \\
-Flag that notifies whether the device supports Multi-Wiegand. \\
-**21. //rs485Mode//** \\
-RS-485 mode of the device. \\
-**22. //sslSupported//** \\
-Flag that notifies whether the device supports SSL communication. \\
-**23. //rootCertExist//** \\
-Flag that notifies whether the device has a root certificate. \\
-**24. //dualIDSupported//** \\
-Flag that notifies whether the device supports alphanumeric ID. \\
-**25. //useAlphanumericID//** \\
-Flag that notifies whether the device is currently using Alphanumeric ID. \\
-**26. //connectedIP//** \\
-IP address where the device is connected to. (0xFFFFFFFF if disconnected)\\
-**27. //phraseCodeSupported//** \\
-Flag that notifies whether the device supports personal messages. \\
-**28. //card1xSupported//** \\
-Flag that notifies whether the device supports reading 1.x ToC cards. \\
-**29. //systemExtSupported//** \\
-Flag that notifies whether the device supports configuring RS-485 keys. \\
-**30. //voipSupported//** \\
-Flag that notifies whether the device supports VoIP. \\
-==== BS2SimpleDeviceInfoEx ====
-Retrieves BS2SimpleDeviceInfo and supported information.\\
-<code cpp>
-typedef struct
-{
-    enum
-    {
-        BS2_SUPPORT_RS485EX = 0x00000001,
-        BS2_SUPPORT_CARDEX  = 0x00000002,
-        BS2_SUPPORT_DST     = 0x00000004,
-        BS2_SUPPORT_ALL     = BS2_SUPPORT_RS485EX | BS2_SUPPORT_CARDEX | BS2_SUPPORT_DST,
-    };
-    uint32_t supported;
-    uint8_t  reserved[4];
-}BS2SimpleDeviceInfoEx;
-</code>
-**1. //supported//** \\
-The current device additionally obtains information beyond the functionality provided by BS2SimpleDeviceInfo.\\
-By bit masking with the values defined below, you can check if it is supported.
-<WRAP group 50%>
-^Definition  ^Value  ^Description  ^
-|BS2_SUPPORT_RS485EX  |0x00000001  |Whether RS485 extensions are supported (In case of CoreStation 40)  |
-|BS2_SUPPORT_CARDEX  |0x00000002  |Whether iClass SEOS card is used  |
-|BS2_SUPPORT_DST  |0x00000004  |Whether daylight savings time is used |
-|BS2_SUPPORT_ALL  |0x00000007  |Whether to provide additional full information
-  |
-</WRAP>
-**2. //reserved//** \\
-Reserved space. \\
-==== BS2ResourceElement ====
-<code cpp>
-typedef struct
-{
-    uint8_t type;
-    uint32_t numResData;
-    struct {
-        uint8_t index;
-        uint32_t dataLen;
-        uint8_t* data;
-    }resData[128];
-}BS2ResourceElement;
-</code>
-**1. //type//** \\
-Resource data type. \\
-<WRAP group 100%>
-^Value  ^Description  ^Supported data format  ^
-|0  |UI(Langauge pack)  |Suprema language pack |
-|1  |Notice message  | UTF-8 string |
-|2  |Image(Background)  | PNG |
-|3  |Slide image  | PNG |
-|4  |Sound  | WAVE |
-</WRAP>
-**2. //numResData//** \\
-Number of resource data. \\ \\
-**3. //index//** \\
-Resource index number. \\ \\
-**4. //dataLen//** \\
-Resource data length. \\ \\
-**5. //data//** \\
-Binary resource data. \\ \\
-==== BS2IPv6DeviceInfo ====
-<code cpp>
-enum {
-    BS2_MAX_IPV6_ALLOCATED_ADDR = 8,
-};
-typedef struct
-{
-    BS2_DEVICE_ID id;
-    uint8_t reserved[1];
-    uint8_t bIPv6Mode;
-    char ipv6Address[BS2_IPV6_ADDR_SIZE];
-    uint16_t portV6;
-    char connectedIPV6[BS2_IPV6_ADDR_SIZE];
-    uint8_t numOfAllocatedAddressV6;
-    char allocatedIpAddressV6[BS2_IPV6_ADDR_SIZE][BS2_MAX_IPV6_ALLOCATED_ADDR];
-}BS2IPv6DeviceInfo;
-</code>
-. //id// \\
-장치 식별자입니다. \\ \\
-. //reserved// \\
-예약된 공간입니다. \\ \\
-. //bIPv6Mode// \\
-현 장치가 IP V6로 동작하는지 여부를 나타내는 flag입니다. \\ \\
-. //ipv6Address// \\
-현재 장치의 IP V6 주소입니다. \\ \\
-. //portV6// \\
-현재 장치의 IP V6 포트 번호입니다. \\ \\
-. //connectedIPV6// \\
-장치가 연결된 서버의 IP V6 주소입니다. \\ \\
-. //numOfAllocatedAddressV6// \\
-현재 장치에 할당되어진 IP V6 주소의 갯수를 나타냅니다. \\ \\
-. //allocatedIpAddressV6// \\
-현재 장치에 할당되어진 IP V6 주소입니다. numOfAllocatedAddressV6는 할당되어진 주소의 갯수를 나타냅니다. \\ \\
-==== BS2AuthOperatorLevel ====
-<code cpp>
-typedef struct {
-    char userID[BS2_USER_ID_SIZE];
-    uint8_t level;
-    uint8_t reserved[3];
-} BS2Operator;
-typedef BS2Operator BS2AuthOperatorLevel;
-</code>
-. //userID// \\
-사용자 식별자입니다. \\ \\
-. //level// \\
-사용자가 인증되었을 때 식별자에 해당하는 권한을 지정합니다. \\
-<WRAP group 50%>
-^값  ^설명  ^
-|0  |권한 없음  |
-|1  |관리자 권한  |
-|2  |시스템 구성을 변경할 수 있는 권한  |
-|3  |사용자 정보를 변경할 수 있는 권한  |
-</WRAP>
-. //reserved// \\
-예약된 공간입니다. \\