Year 2025 Changes

.NET Edition

New The Serial Framework 8 now can run on macOS!

The framework does not use any third-party libraries and requires only pure .NET 9. No .NET MAUI, No Xamarin! Only .NET 9. The Serial Framework 8 uses only P/Invoke calls to OS function.

• New macOS support with pure .NET 9 (Apple Silicon).
• Improved It is shipped as a simple zip archive. Just unpack it and start using it; no installation is required.
• Improved The messaging subsystem has been completely redesigned and reworked.
• New New error codes file errors8.xml.
• New New error codes page.
• New The ErrorInfo sample application can be used to convert the framework error code to a human readable error description.

The package includes pre-compiled binaries for: .NET 9 Windows, .NET 9 macOS, and .NET Framework 4 Windows. The macOS sample applications can be used with Visual Studio Code with the C# extention and .NET 9.

VCL Edition

• Fix Minor bugs fixed.
• New New console sample applications show how to use the framework in console and/or service applications.
• New New error codes file errors8.xml.
• New New error codes page.
• New The ErrorInfo sample application can be used to convert the framework error code to a human readable error description.

Serial Framework

C++ Edition

• New Visual Studio 2026 support.

Bluetooth Framework

C++ Edition

• New Visual Studio 2026 support.

Wi-Fi Framework

C++ Edition

• New Visual Studio 2026 support.

Serial Framework

Common changes

• Fix Resolved an issue that caused the application to crash on exit.
• Fix Fixed a bug that caused an application crash when the library was used in the DLL.
• Improved Code refactoring.
• Fix Minor bugs fixed.

Serial Framework

Common changes

• Fix Resolved an issue that caused the application to crash on exit.
• Fix Fixed a bug that caused an application crash when the library was used in the DLL.

Serial Framework

Common changes

• Fix Resolved an issue that caused the application to crash on exit.
• Fix Fixed a bug that caused an application crash when the library was used in the DLL.

Wi-Fi Framework

Common changes

• Fix Resolved an issue that caused the application to crash on exit.
• Fix Fixed a bug that caused an application crash when the library was used in the DLL.

.NET Edition

• Fix Fixed a Unity application crash on exit when the application uses the Bluetooth Framework.

Bluetooth Framework

Common changes

• Improved OnAdvertisementExtFrameInformation even has been modified to handler Primary and Secondary advertisement PHY.
• Improved Beacons sample application updated to show how to set a primary and a secondary PHY for the wclBluetoothLeAdvertiser.

Bluetooth Framework

VCL Edition

• New macOS support with Lazarus (FreePascal).
• New Each framework now defines a constant for its version number.
• Improved It is shipped as a simple zip archive. Just unpack it and start using it; no installation is required.
• Improved The messaging subsystem has been completely redesigned and reworked.
• Changed Breaking changes: The components are now classes, so you do not need to install them into an IDE.
• New For a list of error codes, refer to the errors.xml file in the Docs folder of the shipped package.
• Improved Lazarus sample projects have three configurations: Win32, Win64, and macOS. When you open one on macOS for the first time, you may get an error message about an unsupported platform. Simply open the Project Inspector and change the project's configuration to macOS.

Serial Framework

C++ Edition

• Fix Addressed a potential bug in the CwclMemoryStream class that could cause AV issues.

VCL Edition

• New Lazarus 4.2 support.

Bluetooth Framework

C++ Edition

• Fix Addressed a potential bug in the CwclMemoryStream class that could cause AV issues.

VCL Edition

• New Lazarus 4.2 support.

Serial Framework

C++ Edition

• Fix Addressed a potential bug in the CwclMemoryStream class that could cause AV issues.

VCL Edition

• New Lazarus 4.2 support.

Wi-Fi Framework

Common changes

• New New error code: WCL_E_BLUETOOTH_LE_RELIABLE_WRITE_ACTIVE.
• New New error code: WCL_E_BLUETOOTH_LE_INVALID_WRITE_OPERATION.
• New New error code: WCL_E_BLUETOOTH_LE_RELIABLE_WRITE_WRONG_ATTRIBUTE.
• New New error code: WCL_E_BLUETOOTH_LE_RELIABLE_WRITE_NOT_STARTED.
• New New error code: WCL_E_BLUETOOTH_LE_RELIABLE_WRITE_ALREADY_STARTED.
• New New error code: WCL_E_BLUETOOTH_LE_RELIABLE_WRITE_NOT_SUPPORTED.
• New BlueSoleil: Reliable write support.
• New A new AppParams parameter has been added to the Get method of the wclCustomObexClient class.

VCL Edition

• New RAD Studio 13 Florence support.

Bluetooth Framework

Common changes

• Improved Compatibility update.

VCL Edition

• New Radio Studio 13 Florence support.

Wi-Fi Framework

Common changes

• New A new AppParams parameter has been added to the Get method of the wclCustomObexClient class.

VCL Edition

• New Radio Studio 13 Florence support.

Serial Framework

Common changes

• Fix Fixed the critical bug that caused the Bluetooth Framework to crash when pairing with a Classic Bluetooth device.

Bluetooth Framework

Common changes

• New New error code: WCL_E_BLUETOOTH_LE_ADVERTISEMENT_PHY_NOT_SUPPORTED.
• New New error code: WCL_E_BLUETOOTH_LE_ADVERTISEMENT_PRIMARY_PHY_NOT_SUPPORTED.
• New New error code: WCL_E_BLUETOOTH_LE_ADVERTISEMENT_SECONDARY_PHY_NOT_SUPPORTED.
• New Setting a primary Bluetooth LE advertisement PHY.
• New Setting a secondary Bluetooth LE advertisement PHY.
• Improved The PHY settings will be ignored for the BLED112 Bluetooth dongle.

Bluetooth Framework

Common changes

• Fix Fixed a bug where wclBluetoothLeBeaconWatcher was unable to start when custom scan parameters were selected.
• New The new ScanParametersType property has been added to the wclBluetoothLeBeaconWatcher class. This property controls how scan parameters are applied.

Bluetooth Framework

Common changes

• Improved Bluetooth Framework compatibility update.

Wi-Fi Framework

Common changes

• Improved Bluetooth Framework compatibility update.

Serial Framework

Common changes

• Fix Fixed a memory leak that occurred during reading from a serial device.

Serial Framework

Common changes

• Fix Fixed a bug where the wclBluetoothLeBeaconWatcher failed to start with the error WCL_E_BLUETOOTH_LE_START_WATCHER_FAILED on certain Bluetooth drivers.
• New New error code: WCL_E_BLUETOOTH_LE_WATCHER_DRIVER_REJECTED_SCAN_PARAMS.

Bluetooth Framework

Common changes

• Fix Fixed a bug that caused the OBEX server data processors to not respond to OpenSession requests on certain platforms.

.NET Edition

• Fix Fixed a bug that caused an ObjectDisposedException when closing the wclRfCommClient.

C++ Edition

• Fix Fixed a critical bug in wclRfCommClient that prevented connections from being established, which previously resulted in the WCL_E_BLUETOOTH_UNABLE_SET_EVENT error.

Bluetooth Framework

Common changes

• Fix Fixed the issue where client disconnection could cause an A/V or ObjectDisposedException on the latest Windows 11.

Bluetooth Framework

Common changes

• Fix Fixed the issue where client disconnection could cause an A/V or ObjectDisposedException on the latest Windows 11.

Serial Framework

Common changes

• Improved The wclBluetoothLeBeaconWatcher frames processing speed increased.

C++ Edition

• Fix Fixed bug with not connecting to BLED112 dongle on Windows 11.
• Fix Fixed bug with not communicating with Toshiba stack on Windows 11.

Bluetooth Framework

Common changes

• Fix Minor Windows 11 related bugs fixed.

C++ Edition

• Fix Fixed bug with connecting to a Serial Port on Windows 11.

Serial Framework

Common changes

New The Wireless Communication Library now includes the Limited Access Feature (LAF) unlocking functionality. You can find more details about LAF in this short article. The LAF Manager requires the Bluetooth Framework 7.19.16, Serial Framework 7.8.6, Wi-Fi Framework 7.12.6.

• New The new wclLafManager class that allows to unlock any Limited Access Feature (LAF).
• New New error code: WCL_E_LAF_NOT_FOUND.
• New New error code: WCL_E_LAF_OPEN_KEY_FAILED.
• New New error code: WCL_E_LAF_KEY_NOT_FOUND.
• New New error code: WCL_E_LAF_DLL_LOAD_FAILED.
• New New error code: WCL_E_LAF_FUNC_NOT_FOUND.
• New New error code: WCL_E_LAF_ACQUIRE_CONTEXT_FAILED.
• New New error code: WCL_E_LAF_CREATE_HASH_FAILED.
• New New error code: WCL_E_LAF_CRYPT_HASH_FAILED.
• New New error code: WCL_E_LAF_GET_CRYPTED_HASH_FAILED.
• New New error code: WCL_E_LAF_IDENTITY_NOT_FOUND.
• New New error code: WCL_E_LAF_IDENTITY_READ_FAILED.
• New New error code: WCL_E_LAF_IDENTITY_INVALID.
• New New error code: WCL_E_LAF_IDENTITY_EMPTY.
• New New error code: WCL_E_LAF_IDENTITY_INVALID_FORMAT.
• New New error code: WCL_E_LAF_UNLOCK_REQUEST_FAILED.
• New New error code: WCL_E_LAF_GET_REQUEST_STATUS_FAILED.
• New New error code: WCL_E_LAF_LOCKED.
• New New error code: WCL_E_LAF_UNAVAILABLE.
• New New error code: WCL_E_LAF_STATUS_UNKNOWN.
• New New error code: WCL_E_LAF_MANAGER_OPENED.
• New New error code: WCL_E_LAF_MANAGER_NOT_OPENED.
• New New error code: WCL_E_LAF_MANAGER_CLOSED.
• New New error code: WCL_E_LAF_MANAGER_CREATE_INIT_EVENT_FAILED.
• New New error code: WCL_E_LAF_MANAGER_CREATE_TERM_EVENT_FAILED.
• New New error code: WCL_E_LAF_MANAGER_START_THREAD_FAILED.
• New New error code: WCL_E_LAF_MANAGER_FEATURE_NOT_SUPPORTED.
• New New error code: WCL_E_LAF_MANAGER_GET_LAF_LIST_FAILED.

Wireless Communication Library

Common changes

• Fix Fixed the incorrect OS version reading issue.
• Improved Minor changes in connection parameters settings.

.NET Edition

• Fix Fixed the bug when changing connection parameters takes too long time.

Bluetooth Framework

Common changes

• New New error code: WCL_E_WIFI_ACCESS_DENIED_BY_SYSTEM.
• New New error code: WCL_E_WIFI_ACCESS_DENIED_BY_USER.
• New New error code: WCL_E_WIFI_HN_ACCESS_DENIED_BY_SYSTEM.
• New New error code: WCL_E_WIFI_HN_ACCESS_DENIED_BY_USER.
• Fix Windows 11 24H2 related fixes and updates.

New Starting with Windows 11 24H2, Microsoft has modified the Wi-Fi security system, now requiring users to grant access to Location and Wi-Fi services. If the Wi-Fi Framework returns any of the following error codes: WCL_E_WIFI_ACCESS_DENIED_BY_SYSTEM, WCL_E_WIFI_ACCESS_DENIED_BY_USER, WCL_E_WIFI_HN_ACCESS_DENIED_BY_SYSTEM, WCL_E_WIFI_HN_ACCESS_DENIED_BY_USER you should prompt the user to enable access to Location and Wi-Fi for classic applications in the System Settings. The user must grant these permissions when requested to ensure your application can properly utilize Wi-Fi Framework functions.

Wi-Fi Framework

Common changes

• Fix Fixed the bug with changing scan parameters on Windows 11.
• Fix Fixed the issue when changing BLE scan parameters on Windows 11 24H2 does not work.

Bluetooth Framework

Common changes

• Fix Correct BLE pairing termination when an application exits or when the Bluetooth Manager was closed.
• Fix Fixed incorrect BLE pairing method selection when IO Capabilities set to iocapDisplayOnly or to iocapKeyboardOnly.

Bluetooth Framework

Common changes

• Fix Fixed the issue when connecting to a GATT-enabled device may fail with a timeout error too early.
• Fix Fixed the issue that caused an application to freeze when calling Cancel for asynchronous operations on Windows 11 23H2.
• Fix Correct error code returning when a connection timed out.
• Fix Correct error code returning when a connection was cancelled.
• Fix Fixed the bug that causes the Access Violation exception during connecting to a paired GATT-enabled device on Windows 11.

VCL Edition

• Fix Fixed C++ Builder building issue.

Bluetooth Framework

Common changes

• Fix Fixed the issue that caused an application to freeze when calling Cancel for asynchronous operations on Windows 11 23H2.
• Improved The WiFiClient sample application has been updated.

VCL Edition

• Fix Fixed C++ Builder building issue.

Wi-Fi Framework

Common changes

• Fix Fixed the issue that caused an application to freeze when calling Cancel for asynchronous operations on Windows 11 23H2.
• Improved The WiFiClient sample application has been updated.

VCL Edition

• Fix Fixed C++ Builder building issue.

Serial Framework

Common changes

• Fix The critical bug has been fixed. The bug causes the Access Violation crash during BLE pairing.

Bluetooth Framework

Common changes

• New The new wclCriticalSection class has been added. The class implements the Critical Section synchronization primitive.
• New The new wclMutex class has been added. The class implements the Mutex synchronization primitive.
• New The new wclEvent class has been added. The class implements the Event synchronization primitive.
• New The new wclAutoResetEvent class has been added. The class implements the Auto Reset Event synchronization primitive.
• New The new wclManualResetEvent class has been added. The class implements Manual Reset Event synchronization primitive.

Bluetooth Framework

Common changes

• New The new wclCriticalSection class has been added. The class implements the Critical Section synchronization primitive.
• New The new wclMutex class has been added. The class implements the Mutex synchronization primitive.
• New The new wclEvent class has been added. The class implements the Event synchronization primitive.
• New The new wclAutoResetEvent class has been added. The class implements the Auto Reset Event synchronization primitive.
• New The new wclManualResetEvent class has been added. The class implements Manual Reset Event synchronization primitive.

Wi-Fi Framework

Common changes

• New The new wclCriticalSection class has been added. The class implements the Critical Section synchronization primitive.
• New The new wclMutex class has been added. The class implements the Mutex synchronization primitive.
• New The new wclEvent class has been added. The class implements the Event synchronization primitive.
• New The new wclAutoResetEvent class has been added. The class implements the Auto Reset Event synchronization primitive.
• New The new wclManualResetEvent class has been added. The class implements Manual Reset Event synchronization primitive.

Serial Framework

Common changes

• Fix Fixed the bug when the WCL_E_WINRT_ASYNC_OPERATION_TIMEOUT error returned too early.
• Fix Fixed the bug when changing ScanInterval and ScanWindow properties of the wclBluetoothLeBeaconWatcher class to lower values raised an exception.

Bluetooth Framework

Common changes

• New The new OnStarted event that is called when serial devices monitoring is started add to the wclSerialMonitor class.
• New The new OnStopped event that is called when serial devices monitoring is stopped add to the wclSerialMonitor class.
• New The new OnStarted event that is called when USB devices monitoring is started add to the wclUsbMonitor class.
• New The new OnStopped event that is called when USB devices monitoring is stopped add to the wclUsbMonitor class.

.NET Edition

• Fix Fixed the bug when the default message processing for the wclSerialMonitor and the wclUsbMonitor was set to mpAsync.

Serial Framework

Common changes

• New The GATT server is now able to detect real client connections. Now you do not need to wait when a client subscribes, writes, or reads a characteristic.

Bluetooth Framework

Common changes

• Improved GATT server write request processing speed was decreased; the code was completely reworked and optimized.

.NET Edition

• Fix Fixed the Unity building issue when the IL2CPP compiling option is selected.
• Fix Fixed the bug in the C# GattClient sample application when the Write characteristic value code line was missed.

Bluetooth Framework

Common changes

• Fix Fixed the incorrect connectable and discoverable radio modes changing bug.
• Fix Fixed the issue when a GATT server could receive data packets in incorrect order.
• Fix Fixed the bug when a GATT server may hang on closing.
• New The new Timestamp property was added to the wclGattLocalCharacteristicReadRequest class. This is a high-percision timestamp (with less than 1 ns resolution) that allows your application to know when the request was exactly received.
• New The new Timestamp property was added to the wclGattLocalCharacteristicWriteRequest class. This is a high-percision timestamp (with less than 1 ns resolution) that allows your application to know when the request was exactly received. There is a known issue when a remote device writes too often to a GATT server; the GATT server may receive data packets in the wrong order. This timestamp will help your application to restore a data packet's order.

Bluetooth Framework

Common changes

• New The Timeout parameter has been added to the WinRT WaitAsync method.
• Fix Fixed the bug when classic Bluetooth devices returned during BLE discovering with the Microsoft Bluetooth driver.
• New New error code: WCL_E_WINRT_ASYNC_OPERATION_TIMEOUT.
• Changed The WCL_E_BLUETOOTH_LE_ADMIN_RIGHTS_REQUIRED error code has been removed.
• Changed The WCL_E_BLUETOOTH_LE_CLIENT_NOT_CONNECTED error value has been changed from 0x000510E0 to 0x000510A7.
• Fix Fixed the issue when connection to a Bluetooth GATT-enabled device can be blocked forever. The cause of this issue is usually a bug in a third-party Bluetooth driver or a Microsoft Bluetooth driver extension. Now, instead of blocking, the WCL_E_WINRT_ASYNC_OPERATION_TIMEOUT error code will be returned to indicate such a situation.

.NET Edition

• Fix Fixed the Access Violation error that appeared in the GetRemoteRssi method on Windows 11 when you build your application as x86 CPU (not AnyCPU) and run it on Windows 11 64 bits.

C++ Edition

• Fix Fixed the freezing bug that appeared when starting the wclBluetoothLeAdvertiser.

VCL Edition

• Fix Fixed the problem when the demo version shows the demo warning dialog on the IDE startup; now it does not show the dialog when the IDE is running.

Bluetooth Framework

Common changes

• New The messaging subsystem now works on macOS.
• New The Timeout parameter has been added to the WinRT WaitAsync method.
• New New error code: WCL_E_WINRT_ASYNC_OPERATION_TIMEOUT.

VCL Edition

• Fix Fixed the problem when the demo version shows the demo warning dialog on the IDE startup; now it does not show the dialog when the IDE is running.

Serial Framework

Common changes

• New The messaging subsystem now works on macOS.
• New The Timeout parameter has been added to the WinRT WaitAsync method.
• New New error code: WCL_E_WINRT_ASYNC_OPERATION_TIMEOUT.

.NET Edition

• Fix Fixed the incorrect creation and connection date and time reading in the network list manager wclNlmNetwork class.

VCL Edition

• Fix Fixed the problem when the demo version shows the demo warning dialog on the IDE startup; now it does not show the dialog when the IDE is running.

Wi-Fi Framework