Differences

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

--- en:device_api [2023/08/16 15:51]
mashin [BS2DeviceCapabilities]
+++ en:device_api [2026/03/11 15:56] (current)
@@ Line 22: / Line 22: @@
   * [[BS2_RemoveAllAuthOperatorLevelEx]]: [+ 2.6.3] Removes all device operators. (Support operator up to 1000)
   * [[BS2_GetDeviceCapabilities]]: [+ 2.8] Gets available function information of the device.
+  * [[BS2_RunAction]]: [+ 2.8.1] Commands the device to take certain actions.
+  * [[BS2_GetMasterAdmin]]: [+ 2.9.12] Gets the master admin from the device.
+  * [[BS2_SetMasterAdmin]]: [+ 2.9.12] Sets the master admin on the device.
 ===== Structure =====
 ==== BS2SimpleDeviceInfo ====
@@ Line 102: / Line 106: @@
 |0x21  |Input Module 120  |
 |0x22  |XStation 2 Finger  |
+|0x23  |BioStation 3  |
+|0x24  |3rd party OSDP device  |
+|0x25  |3rd party OSDP IO device  |
+|0x26  |BioStation 2a  |
+|0x27  |UZ OSDP Module  |
+|0x28  |UZ OSDP Door handle  |
+|0x29  |UZ OSDP Door knob  |
+|0x2A  |BioEntry W3  |
+|0x2B  |CoreStation 20  |
+|0x2C  |Door Interface 24  |
+|0x2D  |BioStation 3 MAX  |
+|0x2E  |BioStation 3 MAX FP	 |
+|0x2F  |XPass Q2  |
 </WRAP>
@@ Line 261: / Line 278: @@
 <WRAP group 100%>
 ^Value  ^Description  ^Supported data format  ^
-|0  |UI(Langauge pack)  |Suprema language pack |
+|0  |UI(Language pack)  |Suprema language pack |
 |1  |Notice message  | UTF-8 string |
 |2  |Image(Background)  | PNG |
@@ Line 313: / Line 330: @@
 ==== BS2AuthOperatorLevel ====
+<callout type="warning" icon="true">To use the Operator feature properly, **at least one administrator(//BS2_OPERATOR_LEVEL_ADMIN//)** must be configured on the device. \\
+If no administrator is assigned, **any user will be able to access the device menu without restriction**.</callout>
 <code cpp>
 typedef struct {
@@ Line 380: / Line 399: @@
             uint32_t NFC: 1;
             uint32_t BLE: 1;
-            uint32_t reserved: 21;
+            uint32_t CustomClassicPlus: 1;
+            uint32_t CustomDesFireEV1: 1;
+            uint32_t TOM_NFC: 1;
+            uint32_t TOM_BLE: 1;
+            uint32_t CustomFelica: 1;
+            uint32_t reserved: 16;
             uint32_t useCardOperation: 1;
         };
@@ Line 515: / Line 539: @@
     uint8_t maxVoipExtensionNumbers;		///< 1 byte
     uint8_t osdpStandardCentralSupported : 1;		///< 1 byte
     uint8_t enableLicenseFuncSupported : 1;   ///< 1 byte
@@ Line 521: / Line 546: @@
     uint8_t customSmartCardSupported: 1;
     uint8_t tomSupported: 1;
-    uint8_t unused2: 2;		///< 1 byte
+    uint8_t tomEnrollSupported: 1;
+    uint8_t showOsdpResultbyLED: 1;
+    uint8_t customSmartCardFelicaSupported: 1;
+    uint8_t ignoreInputAfterWiegandOut: 1;
+    uint8_t setSlaveBaudrateSupported: 1;
+    uint8_t rtspResolutionChangeSupported: 1;
+    uint8_t voipResolutionChangeSupported: 1;
+    uint8_t voipTransportChangeSupported: 1;
+    uint8_t authMsgUserInfoSupported: 1;
+    uint8_t scrambleKeyboardModeSupported: 1;
+    uint16_t visualFaceTemplateVersion;
+    //-------------------------------------------------------------------------------- 2 byte
+    uint8_t authDenyMaskSupported: 1;
+    uint8_t mifareExSupported: 1;
+    uint8_t lockOverrideSupported: 1;
+    uint8_t doorModeOverrideSupported: 1;
+    uint8_t alternateAccessTimerSupported: 1;
+    uint8_t realtimeIOStatusReportSupported:1;
+    uint8_t dynamicSlaveDeviceNumSupported: 1;
+    uint8_t secureTamperSupported: 1;
+    //-------------------------------------------------------------------------------- 1 byte
+    uint8_t customSmartcardSlaveSupported: 1;
+    uint8_t serverPrivateMsgSupported: 1;
+    uint8_t facilityCodeSupported: 1;
+    uint8_t masterAdminSupported: 1;
+    uint8_t adminTwoStepAuthSupported: 1;
+    uint8_t qrDetectGuideLedSupported: 1;
+    uint8_t unused: 2;
+    uint8_t reserved[424];		///< 424 bytes
-    uint8_t reserved[429];
 } BS2DeviceCapabilities;
 </code>
 . //maxUsers// \\
 Indicates the maximum number of information that can be stored on the device. (User) \\ \\
 . //maxEventLogs// \\
 Indicates the maximum number of information that can be stored on the device. (Event log) \\ \\
 . //maxImageLogs// \\
 Indicates the maximum number of information that can be stored on the device. (Image log) \\ \\
 . //maxBlacklists// \\
@@ Line 536: / Line 595: @@
 . //maxOperators// \\
 Indicates the maximum number of information that can be stored on the device. (Operator) \\ \\
 . //maxCards// \\
 Indicates the maximum number of information that can be stored on the device. (Card)  \\ \\
 . //maxFaces// \\
 Indicates the maximum number of information that can be stored on the device. (Face) \\ \\
 . //maxFingerprints// \\
 Indicates the maximum number of information that can be stored on the device. (Fingerprint) \\ \\
 . //maxUserNames// \\
@@ Line 576: / Line 635: @@
 |7  |1  |unused  |Unassigned  |
 . //cardSupported// \\
-This indicates the card support relevant. \\
+This indicates the card support relevant. Referring to mask value, you can access each item in its entirety or in bit units. \\
-Referring to mask value, you can access each item in its entirety or in bit units. \\
 ^Bit position  ^Number of bit  ^Member  ^Description  ^
-|-  |Total  |mask  |total Information  |
+|-  |Total  |mask  |	total Information  |
 |0  |1  |EM  |EM Card  |
 |1  |1  |HIDProx  |HID Proximity Card  |
@@ Line 590: / Line 648: @@
 |8  |1  |NFC  |NFC Card  |
 |9  |1  |BLE  |BLE  |
-|10 |21 |reserved  |Unassigned  |
+|10 |1  |ClassicPlus(Custom card)  |ClassicPlus(Custom Card)  |
+|11 |1  |DesFireEV1(Custom card)  |DesFireEV1(Custom Card)  |
+|12 |1  |TOM NFC  |TOM NFC  |
+|13 |1  |TOM BLE  |TOM BLE  |
+|14 |1  |FeliCa(Custom card)  | FeliCa (Custom Card)  |
+|15 |16 |reserved  |Unassigned  |
 |31 |1  |useCardOperation  |Card operation enabled or not  |
 . //authSupported// \\
@@ Line 710: / Line 773: @@
 |7  |1  |visualQRSupported  |Whether Visual QR is supported.  |
 . //maxVoipExtensionNumbers// \\
-It is the number of registered internal numbers in the extension phone book at the extended VoIP setting information. \\ \\
+It is the number of registered internal numbers in the extension phone book at the extended VoIP setting information.\\ \\
 . //System support information 2// \\
 It indicates the system information supported by the device in bit units as follows. \\
 ^Bit position  ^Number of bit  ^Member  ^Description  ^
 |0  |1  |osdpStandardCentralSupported  |Whether OSDP Standard is supported. ([[configuration_api#BS2OsdpStandardConfig|BS2OsdpStandardConfig]])  |
-|1  |1  |enableLicenseFuncSupported  |Whether Device license is supported. ([[configuration_api#BS2LicenseConfig|BS2LicenseConfig]])  |
+|1  |1  |enableLicenseFuncSupported  |Whether Device license is supported.([[configuration_api#BS2LicenseConfig|BS2LicenseConfig]])  |
 |2  |1  |keypadBacklightSupported  |Whether Keypad backlight is supported.  |
 |3  |1  |uzWirelessLockDoorSupported  |Whether U&Z wireless lock is supported.  |
 |4  |1  |customSmartCardSupported  |Whether Custom card is supported. ([[configuration_api#BS2CustomCardConfig|BS2CustomCardConfig]])  |
 |5  |1  |tomSupported  |Whether ToM is supported.  |
-|6  |2  |unused2  |Unassigned  |
+|6  |1  |tomEnrollSupported  |Whether ToM enrollment is supported.  |
-. //reserved// \\
+|7  |1  |showOsdpResultbyLED  |Whether OSDP standard device supports the ability to display authentication results. ([[configuration_api#BS2DisplayConfig|BS2DisplayConfig]])  |
+. //System support information 3// \\
+It indicates the system information supported by the device in bit units as follows. \\
+^Bit position  ^Number of bit  ^Member  ^Description  ^
+|0  |1  |customSmartCardFelicaSupported  |Whether FeliCa custom smart card is supported.  |
+|1  |1  |ignoreInputAfterWiegandOut  |Whether a feature to filter out repetitive re-entry of Wiegand output results is included.  |
+|2  |1  |setSlaveBaudrateSupported  |Whether to support baudrate setting of RS485 slave device.  |
+|3  |1  |rtspResolutionChangeSupported  |[+2.9.8] Whether to support changing RTSP video resolution.  |
+|4  |1  |voipResolutionChangeSupported  |[+2.9.8] Whether to support changing intercom video resolution.  |
+|5  |1  |voipTransportChangeSupported  |[+2.9.8] Whether to support changing intercom data transmission method.  |
+|6  |1  |authMsgUserInfoSupported  |[+2.9.8] Whether to support changing the method of displaying user information on the authentication screen.  |
+|7  |1  |scrambleKeyboardModeSupported  |[+2.9.8] Whether to support changing the use of scramble keypad.  |
+. //visualFaceTemplateVersion// \\
+[+2.9.8] For visual face devices, indicates template version information supported by the device. \\ \\
+. //System Support Information 4// \\
+[+2.9.12] Indicates the system information supported by the device in bit units as follows. \\
+^Bit Position  ^Number of Bits  ^Member Name  ^Description  ^
+|0  |1  |authDenyMaskSupported  |Whether to support mask wearing prohibition in facial authentication  |
+|1  |1  |mifareExSupported  |Whether Mifare CardEx is supported  |
+|2  |1  |lockOverrideSupported  |Whether lock override is supported  |
+|3  |1  |doorModeOverrideSupported  |Whether door mode override is supported  |
+|4  |1  |alternateAccessTimerSupported  |Whether user override is supported  |
+|5  |1  |realtimeIOStatusReportSupported  |Whether real-time device I/O port status information is provided  |
+|6  |1  |dynamicSlaveDeviceNumSupported  |Whether dynamic slave device connection (up to 128 devices) is supported  |
+|7  |1  |secureTamperSupported  |Whether secure tamper is supported  |
+. //System Support Information 5// \\
+[+2.9.12] Indicates the system information supported by the device in bit units as follows. \\
+^Bit Position  ^Number of Bits  ^Member Name  ^Description  ^
+|0  |1  |customSmartcardSlaveSupported  |Whether custom smart card slave is supported  |
+|1  |1  |serverPrivateMsgSupported  |Whether server private message is supported  |
+|2  |1  |facilityCodeSupported  |Whether facility code is supported  |
+|3  |1  |masterAdminSupported  |Whether master admin is supported  |
+|4  |1  |adminTwoStepAuthSupported  |Whether two-step authentication for master admin is supported  |
+|5  |1  |qrDetectGuideLedSupported  |Whether QR detection LED can be displayed (XPQ2)  |
+|6  |2  |unused  |Unused  |
+. //reserved// \\
 Reserved space.\\ \\