.NET Edition

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.

• macOS support with pure .NET 9 (Apple Silicon).
• It is shipped as a simple zip archive. Just unpack it and start using it; no installation is required.
• The messaging subsystem has been completely redesigned and reworked.
• New error codes file errors8.xml.
• New error codes page.
• 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

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

Serial Framework

C++ Edition

• Visual Studio 2026 support.

Bluetooth Framework

C++ Edition

• Visual Studio 2026 support.

Wi-Fi Framework

C++ Edition

• Visual Studio 2026 support.

Serial Framework

Common changes

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

Serial Framework

Common changes

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

Serial Framework

Common changes

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

Wi-Fi Framework

Common changes

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

.NET Edition

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

Bluetooth Framework

Common changes

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

Bluetooth Framework

VCL Edition

• macOS support with Lazarus (FreePascal).
• Each framework now defines a constant for its version number.
• It is shipped as a simple zip archive. Just unpack it and start using it; no installation is required.
• The messaging subsystem has been completely redesigned and reworked.
• Breaking changes: The components are now classes, so you do not need to install them into an IDE.
• For a list of error codes, refer to the errors.xml file in the Docs folder of the shipped package.
• 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

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

VCL Edition

• Lazarus 4.2 support.

Bluetooth Framework

C++ Edition

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

VCL Edition

• Lazarus 4.2 support.

Serial Framework

C++ Edition

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

VCL Edition

• Lazarus 4.2 support.

Wi-Fi Framework

Common changes

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

VCL Edition

• RAD Studio 13 Florence support.

Bluetooth Framework

Common changes

• Compatibility update.

VCL Edition

• Radio Studio 13 Florence support.

Wi-Fi Framework

Common changes

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

VCL Edition

• Radio Studio 13 Florence support.

Serial Framework

Common changes

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

Bluetooth Framework

Common changes

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

Bluetooth Framework

Common changes

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

Bluetooth Framework

Common changes

• Bluetooth Framework compatibility update.

Wi-Fi Framework

Common changes

• Bluetooth Framework compatibility update.

Serial Framework

Common changes

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

Serial Framework

Common changes

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

Bluetooth Framework

Common changes

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

.NET Edition

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

C++ Edition

• 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

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

Bluetooth Framework

Common changes

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

Serial Framework

Common changes

• The wclBluetoothLeBeaconWatcher frames processing speed increased.

C++ Edition

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

Bluetooth Framework

Common changes

• Minor Windows 11 related bugs fixed.

C++ Edition

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

Serial Framework

Common changes

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.

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

Wireless Communication Library

Common changes

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

.NET Edition

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

Bluetooth Framework

Common changes

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

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

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

Bluetooth Framework

Common changes

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

Bluetooth Framework

Common changes

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

VCL Edition

• Fixed C++ Builder building issue.

Bluetooth Framework

Common changes

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

VCL Edition

• Fixed C++ Builder building issue.

Wi-Fi Framework

Common changes

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

VCL Edition

• Fixed C++ Builder building issue.

Serial Framework

Common changes

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

Bluetooth Framework

Common changes

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

Bluetooth Framework

Common changes

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

Wi-Fi Framework

Common changes

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

Serial Framework

Common changes

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

Bluetooth Framework

Common changes

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

.NET Edition

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

Serial Framework

Common changes

• 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

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

.NET Edition

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

Bluetooth Framework

Common changes

• Fixed the incorrect connectable and discoverable radio modes changing bug.
• Fixed the issue when a GATT server could receive data packets in incorrect order.
• Fixed the bug when a GATT server may hang on closing.
• 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.
• 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

• The Timeout parameter has been added to the WinRT WaitAsync method.
• Fixed the bug when classic Bluetooth devices returned during BLE discovering with the Microsoft Bluetooth driver.
• New error code: WCL_E_WINRT_ASYNC_OPERATION_TIMEOUT.
• The WCL_E_BLUETOOTH_LE_ADMIN_RIGHTS_REQUIRED error code has been removed.
• The WCL_E_BLUETOOTH_LE_CLIENT_NOT_CONNECTED error value has been changed from 0x000510E0 to 0x000510A7.
• 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

• 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

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

VCL Edition

• 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

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

VCL Edition

• 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

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

.NET Edition

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

VCL Edition

• 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