May 12, 2026

New Features and Improvements

• BioStation 3 Max is supported.
  • BS3M-DB, BS3M-APB, BS3M-ODB, BS3M-OAPB

Bug Fixes

• Duplicate connections to the same device occurred during the device reconnection process when using async mode.

SDK License Agreement

• The SDK License Agreement file (“LICENSE_AGREEMENT.txt”) must be in the same path as the current working directory before running device_gateway.
• The SDK License Agreement file (“LICENSE_AGREEMENT.txt”) can be created by renaming the file (“LICENSE.txt”) distributed with the SDK package.
• Placing the renamed SDK License Agreement file (“LICENSE_AGREEMENT.txt”) in the same path as device_gateway is considered as the end user agreeing to the use of the software license.
• The End User License Agreement file (“EULA.txt”) is no longer used.

December 30, 2025

New Features and Improvements

• XPass Q2 (XPQ2-DB, XPQ2-APB) is supported.
• Supports the Master Admin setting, which grants full administrator privileges.
• Supports the Device License that enables additional features.
• QR Config allows you to enable QR code scanning using your device’s visual camera. To use this feature, you must first set a license activation key to your device using Device License.
• Supports the Lock Override feature, which allows you to enroll a card that can open a door to be opened using a specific card.
• Supports the Door Mode Override feature, which restores the door to its normal state after the administrator changes the door status and a certain period of time has elapsed.
• Supports the Realtime device I/O states feature to check the current status of device Input/Output ports.
• Supports the User Override feature, which allows to set the door to remain open longer for specific users.

June 2, 2025

New Features and Improvements

• CoreStation 20 (CS-20, CS-20P) is supported.
• DoorInterface (DI-24) is supported.
• The input settings have been modified to support CS-20, DI-24. The modified InputConfig includes predefined aux inputs.
• Added a setting to facility code for offline mode to DoorInterface.
• Added information on how to obtain the connection type for the RS485 channel.
• Support RTSP settings on FaceStation F2 and support for selecting resolution.
• Added a setting to enable/disable the scramble keypad.
• Supports the function of commanding certain actions to devices.
• Supports changing the exposure level of user information (name, ID) displayed after authentication.
• Supports Mifare Plus EV1 SL1/SL3 cards. Refer to CardConfig.mifareEncryption for details.
• When using file log, it supports opening log files in append mode when restarting the gateway:
  • Device gateway config append_mode.
  • Master gateway config append_mode.

November 22, 2024

New Features and Improvements

• Added a setting to FaceData to allow users to register with visual face templates only, excluding actual images.
• Added a setting to FaceConfig to save only the template without storing the actual image in the visual face.
• Added a setting to detect_network_interval.
• Improved usability in low-speed network environments:
  • Detecting device connection status, improving device reconnection wait time, etc.

August 2, 2024

New Features and Improvements

• BioEntry W3 is supported.
• Supports Custom Smart Card.
• Supports setting Anti-Passback on the door.
• Improved to support multi-threading environments.
• Improved to allow activating or deactivating User Status updates.
• Ignore Repeated Signals Duration is added to Trigger & Action API.
• Support for HID Prox and iCLASS cards on the XPass 2 (XP2-MAPB).
• Supports the Display Result from Controller feature for displaying authentication results from a 3rd party controller on the device screen when using Intelligent Slave.
• Added new options in Device Capability.

Note: The device log filtering API GetLogWithFilter has been Deprecated. It is recommended that filtering be performed on the server using GetLog, EnableMonitoring and SubscribeRealtimeLog.

The device log filtering GetLogWithFilter API reviews the device’s logs against the conditions set by the server.
This means that the device may invest considerable time in log filtering, and as the number of logs on the device increases, more time will be required.

Also, logs are not permanently stored on the device.
If the maximum number of logs that the device can hold is exceeded, the device will overwrite the oldest logs, and logs older than a certain period of time may be automatically deleted.
It is recommended that all logs from the device be stored and managed on a server.

It is recommended that logs be received in bulk from the device using the GetLog API, and that logs occurring after the current time be received in real time using the EnableMonitoring and SubscribeRealtimeLog APIs, so that the server stores all logs in an appropriate DBMS and filters the logs from the DBMS.

August 2, 2023

New features and improvement

• BioStation 2a is supported.
• Support to select and update only the desired information when updating user information.
• Support for issuing visual face Access On Card.
• Support for setting IPConfig via UDP.
• Added procedure to the End User License Agreement.
  • The license agreement file must be placed in the same path as the current working directory before running device_gateway. Placing the license agreement file in the same path as the current working directory assumes that the end user agrees to use it.

April 10, 2023

New features and improvement

• All proto files have been standardized and rebuilt.
• Enum values have been added to the proto file for various settings.

March 13, 2023

Bug fixes

• Failed to get ThermalConfig for mask-related settings on BioStation 3.

February 21, 2023

New features

• BioStation 3 is supported.
• X-Station 2 is supported.
• FaceStation F2 is supported.
• GetCapability API has been added.

• Adds support for the RtspConfig, VoipConfigEx, CardConfig, DisplayConfig, FaceConfig, FingerConfig, QRConfig, SystemConfig, ThermalConfig, and WiegandConfig.

• To prevent namespace conflicts, the prefix gsdk. is added to all namespaces.

  • v1.4: display, system, rs485, connect, etc.
    v1.5: gsdk.display, gsdk.system, gsdk.rs485, gsdk.connect, etc.

    :warning: Caution
    When upgrading to v1.5, you must change the namespace within the project for proper operation.

June 16, 2021

New features

• X-Station 2 is supported. Card API is extended to provide related APIs.
• You can connect some BioStar devices to 3rd party ACUs using OSDP protocol. Refer to the following article for details. RS485Config is extended to configure the related options.
• New example for user synchronization is added to the client SDKs.
• Quick start examples for Kotlin and Swift are added.

Bug fixes

• When XXX_Multi commands fail, the deviceErrors will not be returned. From V1.4, you can get the detailed information from the error itself. Refer to the user synchronization example of the client SDK.