Wireless Communication Library year 2023 changes

• Getting a default audio device for the specified role and data flow has been added to the wclAudioSwitcher class.
• New error code: WCL_E_AUDIO_SWITCHER_GET_DEFAULT_DEVICE_FAILED.
• New error code: WCL_E_AUDIO_SWITCHER_GET_DEVICE_ID_FAILED.
• New error code: WCL_E_AUDIO_SWITCHER_DEFAULT_DEVICE_NOT_FOUND.
• VCL Edition: The new "SByte" data type has been added.
• VCL Edition: The event declarations in the wclBluetoothLeBeaconWatcher class have been changed.
• VCL Edition: Fixed the bug with assigning event handlers in design for the wclBluetoothLeBeaconWatcher class if the Bluetooth Framework is used with CBuilder.

Bluetooth Framework

• Fixed the bug that caused an application crash during enumerating classic Bluetooth device services.
• Fixed the issue with an incorrect mixed Bluetooth device type detection.

Bluetooth Framework

The Wireless Communication Library VCL edition has been updated to add Embarcadero RAD Studio 12 Athens support.

• Fixed the issue when the GATT server did not restart after a client was disconnected.
• Fixed the issue when the GATT server did not restart advertising after a client was disconnected.
• Fixed the issue when reconnecting to the server is rejected after a client was disconnected.
• Fixed the issue with an incorrect event calling order.
• Fixed the issue with the broken data sequence that appeared when data was sent too often using a characteristic value change notification.
• C++ Edition: Fixed the bug when the Bluetooth LE devices can not be discovered.

Bluetooth Framework

• The GattClient demo application has been updated to show how to use the new Bluetooth Framework GATT features.
• The EnumPairedDevice method of the wclBluetoothRadio class has been updated to be able to return only Bluetooth LE or only classic Bluetooth devices.
• The error codes that can be returned by the wclAudioSwitcher class have been modified.
• .NET Edition: The error codes that can be returned by the wclAudioSwitcher class were moved to the new wclAudioErrors class located in the wclAudio namespace.
• VCL Edition: The wclAudioSwitcher class error code declarations have been moved to the wclAudioErrors file.
• C++ Edition: The wclAudioSwitcher class error codes have been moved to the wclAudio namespace in the wclAudioErrors file.
• VCL Edition: The wclAudioSwitcher class has been moved to the wclAudio file.
• .NET Edition: The wclAudioSwitcher class has been moved to the wclAudio namespace.
• C++ Edition: The wclAudioSwitcher class has been moved to the wclAudio namespace in the wclAudio file.
• The error codes returned by the wclAudioSwitcher class have been changed.
• The common error codes of the Audio Framework have been changed.
• The new wclAudioMeter class that allows you to monitor an audio volume level has been added.
• The new wclAudioVolume class that allows you to control an audio volume has been added.
• The new AudioVolume demo application has been added.
• New error code: WCL_E_AUDIO_METER_GET_PEAK_VALUE_FAILED.
• New error code: WCL_E_AUDIO_METER_CREATE_FAILED.
• New error code: WCL_E_AUDIO_VOLUME_CREATE_FAILED.
• New error code: WCL_E_AUDIO_VOLUME_GET_VOLUME_FAILED.
• New error code: WCL_E_AUDIO_VOLUME_SET_VOLUME_FAILED.
• New error code: WCL_E_AUDIO_VOLUME_GET_MUTE_FAILED.
• New error code: WCL_E_AUDIO_VOLUME_SET_MUTE_FAILED.

Bluetooth Framework

• Compatibility update.

IrDA Framework

• The SerialClient demo has been updated to send CR, LF, or CR+LF.

Serial Framework

• Compatibility update.

Timeline Framework

• Compatibility update.

WiFi Framework

• Fixed the issue when the incorrect WCL_E_BLUETOOTH_LE_GATT_SERVER_START_FAILED error code was returned when starting a GATT server if Bluetooth hardware did not support peripheral mode.
• The wclAudioSwitcher class is now able to connect to and to disconnect from a Bluetooth-enabled audio device by the device's MAC address.

Bluetooth Framework

• Fixed the bug in the wclGattClient class that caused the disconnection from a device to take too long.
• Minor changes in the wclGattClient class.
• The GattClient demo application has been updated.

Bluetooth Framework

• Fixed the bug that caused all Bluetooth LE devices to be detected as mixed with the Microsoft Bluetooth driver.
• Fixed the application crash that appeared when the Close method of the wclBluetoothManager class was called twice.
• The BluetoothManager demo application has been updated to show how to disable pairing handling by the Bluetooth Framework.
• The GattClient demo application has been updated to use the "HandlePairing" feature.
• The GattClient demo application has been updated to use the MITM protection pairing feature.
• The GattClient demo application has been updated to use the IO Capabilities pairing feature.
• .NET Edition: Fixed the wclGattClient freezing issue when the wclBluetoothManager class is closing.

Bluetooth Framework

• The device type reading code has been updated for the Microsoft Bluetooth driver implementation.
• VCL Edition: Fixed the CBuilder demo applications build issue.
• New error code: WCL_E_AUDIO_SWITCHER_CLOSED.
• New error code: WCL_E_AUDIO_SWITCHER_OPENED.
• New error code: WCL_E_AUDIO_SWITCHER_NOT_OPENED.
• New error code: WCL_E_AUDIO_SWITCHER_COM_INIT_FAILED.
• New error code: WCL_E_AUDIO_SWITCHER_CREATE_ENUMERATOR_FAILED.
• New error code: WCL_E_AUDIO_SWITCHER_REGISTER_EVENT_FAILED.
• New error code: WCL_E_AUDIO_SWITCHER_ENUM_ENDPOINTS_FAILED.
• New error code: WCL_E_AUDIO_SWITCHER_GET_ENDPOIN_COUNT_FAILED.
• New error code: WCL_E_AUDIO_SWITCHER_CREATE_CONFIGURATOR_FAILED.
• New error code: WCL_E_AUDIO_SWITCHER_SET_DEFAULT_DEVICE_FAILED.
• New error code: WCL_E_AUDIO_SWITCHER_FEATURE_NOT_SUPPORTED.
• New error code: WCL_E_AUDIO_SWITCHER_DEVICE_NOT_FOUND.
• New error code: WCL_E_AUDIO_SWITCHER_INVALID_DEVICE.
• New error code: WCL_E_AUDIO_SWITCHER_DEVICE_CONNECTED.
• New error code: WCL_E_AUDIO_SWITCHER_DEVICE_DISCONNECTED.
• New error code: WCL_E_AUDIO_SWITCHER_CREATE_TOPOLOGY_FAILED.
• New error code: WCL_E_AUDIO_SWITCHER_GET_CONNECTORS_COUNT_FAILED.
• New error code: WCL_E_AUDIO_SWITCHER_CONNECT_FAILED.
• New error code: WCL_E_AUDIO_SWITCHER_DISCONNECT_FAILED.
• New error code: WCL_E_AUDIO_SWITCHER_NO_CONNECTORS_FOUND.
• The new wclAudioSwitcher class.
• The method to enumerate audio devices has been added.
• The method to monitor audio device states has been added.
• The method to change a system default audio device has been added.
• The method to connect to the already paired Bluetooth audio device has been added.
• The method to disconnect from the connected Bluetooth audio device has been added.
• The new AudioSwitcher demo application has been added.

Bluetooth Framework

• VCL Edition: Fixed the CBuilder demo applications building issue.
• C++ Edition: Fixed the IoT demo applications building issue.

WiFi Framework

• VCL Edition: Fixed the CBuilder demo applications building issue.
• C++ Edition: Fixed the IoT demo applications building issue.

Serial Framework

• VCL Edition: Fixed the CBuilder demo applications building issue.

IrDA Framework

• VCL Edition: Fixed the CBuilder demo applications building issue.

Timeline Framework

• The new FindService method has been added to the wclGattClient class. The method helps to find a GATT service with a specified UUID.
• The new FindCharacteristic method has been added to the wclGattClient. The method helps to find a GATT characteristic with a specified UUID.
• Some methods were moved from the wclGattClientConnection class to the wclGattClient class.
• The GattClient demo application has been updated.

Bluetooth Framework

• .NET Edition: Fixed the bug in the VB.NET GattServer demo application.
• Fixed the bug with setting the "Discoverable" property to "True" when Bluetooth LE advertising is running.
• Fixed the issue when power events were not received on some systems.

Bluetooth Framework

• Fixed the issue when power events were not received on some systems.

WiFi Framework

• Fixed the issue when power events were not received on some systems.

Serial Framework

• Fixed the issue when power events were not received on some systems.

IrDA Framework

• Fixed the issue when power events were not received on some systems.

Timeline Framework

• Enumerating installed services for the specified remote device is now possible.

Bluetooth Framework

• Compatibility update.

Serial Framework

• Compatibility update.

IrDA Framework

• Compatibility update.

Timeline Framework

• The data type definitions have been updated for support of the latest authentication and encryption algorithms.
• New error code: WCL_E_WIFI_RES_NO_VISIBLE_AP.
• The new OnLinkDegraded event has been added to the wclWiFiEvents class.
• The new OnLinkImproved event has been added to the wclWiFiEvents class.

WiFi Framework

• .NET Edition: Fixed the issue when the GetRemoteRssi method always returned 4 instead of the correct RSSI value.
• Minor bug fixes.

Bluetooth Framework

• Minor bug fixes.

IrDA Framework

• Minor bug fixes.

Serial Framework

• Minor bug fixes.

Timeline Framework

• Minor bug fixes.

WiFi Framework

• The new OnConnectionPhyChanged event has been added to the wclGattClient class.
• Reading a connection PHY is now available in the GATT server.
• Reading the connection parameters is now available in the GATT server.
• Changing connection parameters handling is not available in the GATT server.
• Changing connection PHY handling is not available in the GATT server.
• The GattServer demo application has been updated to show how to read the current connection parameters.
• The GattServer demo application has been updated to show how to read the current connection PHY.
• The WCL_E_BLUETOOTH_LE_GATT_SERVER_RESPONSE_ALREADY_SEND error constant has been changed to WCL_E_BLUETOOTH_LE_GATT_SERVER_RESPONSE_ALREADY_SENT.
• New error code: WCL_E_BLUETOOTH_LE_CLIENT_NOT_CONNECTED.
• New error code: WCL_E_BLUETOOTH_LE_SUBSCRIBE_FAILED.
• New error code: WCL_E_BLUETOOTH_LE_UNSUBSCRIBE_FAILED.
• C++ Edition: Fixed the bug when writing the client configuration descriptor failed on Windows 11.
• .NET Edition: Fixed the issue when closing a console application that uses the Bluetooth Framework that caused an application to freeze.
• .NET Edition: Fixed the bug when Bluetooth LE devices were not discovered on the Windows 10 IoT Core platform.
• .NET Edition: Fixed the bug when not all Bluetooth LE advertisements were captured on the Windows 10 IoT Core platform.

Bluetooth Framework

• The new wclGattLocalCharacteristicReadRequest class has been added. The class provides information about a GATT server characteristic value read request and allows you to respond to the request with the data or with the error.
• The new wclGattLocalCharacteristicWriteRequest class has been added. The class provides information about a GATT server characteristic value write request and allows receiving data provided by a GATT client and responding to the request with processing the request result if the "Write With Response" operation is executing.
• The wclGattLocalCharacteristicValue class has been removed.
• The OnRead event of the wclGattServer class has been changed.
• The OnWrite event of the wclGattServer class has been changed.
• The GattServer demo application has been updated.
• New error code: WCL_E_BLUETOOTH_LE_GATT_SERVER_SEND_RESPONSE_FAILED.
• New error code: WCL_E_BLUETOOTH_LE_GATT_SERVER_WRITE_WITHOUT_RESPONSE.
• New error code: WCL_E_BLUETOOTH_LE_GATT_SERVER_RESPONSE_ALREADY_SENT.

Bluetooth Framework

• The WCL_E_BLUETOOTH_LE_GET_ADV_PARAMS_FAILED error code has been removed.
• The WCL_E_BLUETOOTH_LE_RESET_ADV_PARAMS_FAILED error code has been removed.
• New error code: WCL_E_BLUETOOTH_LE_NOTHING_ADVERTISE.
• New error code: WCL_E_BLUETOOTH_LE_TOO_MANY_ADVERTISEMENTS.
• The number of concurrent advertisements that the wclBluetoothLeAdvertiser class can run at the same time has been limited.
• The OnAdvertisingBegin event has been removed from the wclBluetoothLeAdvertiser class.
• The OnAdvertisingEnd event has been removed from the wclBluetoothLeAdvertiser class.
• The OnAdvertisingError event has been removed from the wclBluetoothLeAdvertiser class.
• Fixed the issue that caused a MAC address change for each advertisement with the Microsoft Bluetooth driver.

Bluetooth Framework

• The SetLeScanParams method has been removed from the wclBluetoothRadio class.
• The GetLeScanParams method has been removed from the wclBluetoothRadio class.
• The ResetLeScanParams method has been removed from the wclBluetoothRadio class.
• The SetLeAdvParams method has been removed from the wclBluetoothRadio class.
• The GetLeAdvParams method has been removed from the wclBluetoothRadio class.
• The ResetLeAdvParams method has been removed from the wclBluetoothRadio class.
• The new ScanInterval and ScanWindow parameters have been added to the Start method of the wclBluetoothLeBeaconWatcher class.
• The new Interval parameter has been added to the Start method of the wclBluetoothLeAdvertiser class.
• Now changing the Bluetooth LE advertising parameters does not require administrative rights.
• Now changing the Bluetooth LE scan parameters does not require administrative rights.
• The WCL_E_BLUETOOTH_LE_GET_SCAN_PARAMS_FAILED error code has been removed.
• The WCL_E_BLUETOOTH_LE_RESET_SCAN_PARAMS_FAILED error code has been removed.
• New error code: WCL_E_BLUETOOTH_LE_CREATE_SCAN_PARAMS_SET_EVENT_FAILED.
• New error code: WCL_E_BLUETOOTH_LE_GET_ADV_PARAMS_FAILED.
• New error code: WCL_E_BLUETOOTH_RADIO_INSTANCE_NOT_FOUND.
• New error code: WCL_E_BLUETOOTH_OPEN_RADIO_FAILED.

Bluetooth Framework

• The new LeSupported property has been added to the wclBluetoothRadio class.
• The new ClassicSupported property has been added to the wclBluetoothRadio class.
• Fixed the issue in the wclBluetoothManager class that appeared if the OnStatusChanged event was called before the AfterOpen event and the Radio object passed to the OnStatusChanged event is not in the radios list.
• Fixed the issue in the wclBluetoothManager class that appeared if the OnStatusChanged event was called after then the BeforeClose event, and the Radio object passed to the OnStatusChanged event can be destroyed before the OnClosed event was called.

Bluetooth Framework

• Now the data processors allow manual data flow management.
• Minor update in the WinAPI declarations.
• Now it is possible to provide any custom maximum OBEX packet size.

Bluetooth Framework

• Minor update in the WinAPI declarations.

WiFi Framework

• Now the data processors allow manual data flow management.
• Fixed the issue with enumerating com0com ports on Windows 10 and above.
• Fixed the issue with com0com ports not being detected on Windows 10 and above.
• Minor update in the WinAPI declarations.
• .NET Edition: Fixed the bug with accessing the "Processor" property of the wclSerialClient class.
• Now it is possible to provide any custom maximum OBEX packet size.
• The new demos applications that show how to use OBEX with a serial connection have been added.

Serial Framework

• Now the data processors allow manual data flow management.
• Minor update in the WinAPI declarations.
• Now it is possible to provide any custom maximum OBEX packet size.

IrDA Framework

• Minor update in the WinAPI declarations.

Timeline Framework

• The WCL_E_WIFI_DIRECT_DEVICE_START_GET_PAIRED_THREAD_FAILED error code has been changed to WCL_E_WIFI_DIRECT_DEVICE_WATCHER_START_GET_PAIRED_THREAD_FAILED.
• The WCL_E_WIFI_DIRECT_DEVICE_START_UNPAIR_THREAD_FAILED error code has been changed to WCL_E_WIFI_DIRECT_DEVICE_WATCHER_START_UNPAIR_THREAD_FAILED.
• The WCL_E_WIFI_DIRECT_DEVICE_START_NAME_RESOLVING_THREAD_FAILED error code has been changed to WCL_E_WIFI_DIRECT_DEVICE_WATCHER_START_NAME_RESOLVING_THREAD_FAILED.
• New error code: WCL_E_WIFI_DIRECT_DEVICE_WATCHER_START_ENUM_PAIRED_DEVICES_THREAD_FAILED.
• New error code: WCL_E_WIFI_DIRECT_DEVICE_WATCHER_ENUMERATE_DEVICES_FAILED.
• New error code: WCL_E_WIFI_DIRECT_DEVICE_WATCHER_QUERY_ASYNC_INFO_FAILED.
• New error code: WCL_E_WIFI_DIRECT_DEVICE_WATCHER_GET_ENUM_RESULT_FAILED.
• Enumerating paired WiFi Direct devices has been added to the wclWiFiDirectDeviceWatcher class.

WiFi Framework

• The Bluetooth LE error codes were redefined.
• The RfCommServer demo application has been updated to show how to make the local Bluetooth radio discoverable and connectable.
• The OppServer demo application has been updated to show how to make the local Bluetooth radio discoverable and connectable.
• Minor fixes in the OBEX OPP server implementation.

Bluetooth Framework

• Minor fixes in the OBEX OPP server implementation.

IrDA Framework

• Minor fixes in the OBEX OPP server implementation.

Serial Framework

• New GATT errors decoding.
• New error code: WCL_E_BLUETOOTH_LE_WRITE_WITHOUT_RESPONSE_NOT_SUPPORTED.
• The new WriteKind parameter has been added to the WriteCharacteristicValue method. The parameter allows you to control a write operation: with or without a response or in auto mode. You can use this parameter instead of changing a characteristic's property.
• The new SubscribeKind parameter has been added to the WriteClientConfiguration method. The parameter allows you to control how to subscribe to a value change notification. Use this parameter instead of changing a characteristic's property.
• The new SubscribeKind parameter has been added to the Subscribe method.
• The new SubscribeKind parameter has been added to the Unsubscribe method.
• The new SubscribeKind parameter has been added to the SubscribeForNotifications method.
• The new SubscribeKind parameter has been added to the UnsubscribeFromNotifications method.
• The new ReadProtectionLevel field has been added to the wclGattLocalDescriptor structure.
• The new WriteProtectionLevel field has been added to the wclGattLocalDescriptor structure.

Bluetooth Framework