Ahsoka.Extensions.Bluetooth 5.7.0

Ahsoka.Extensions.Bluetooth

An OpenPV Bluetooth Extension that provides Bluetooth Classic (BR/EDR) and Bluetooth Low Energy (BLE) support through two Ahsoka services.

Services

Both services auto-start and are configured via the extension info bundled with this package.

Bluetooth Classic

Manages Bluetooth Classic adapter operations and profile-based connections over BR/EDR.

Capabilities

• Adapter power, discoverable, and pairable mode control (with configurable timeouts)
• Device discovery with configurable timeout
• Pairing, unpairing, and paired device management
• Multi-adapter support
• Profile service plugin architecture

Built-in Profile Services

Client Usage

var client = new BluetoothServiceClient();

// Listen for notifications
client.NotificationReceived += OnBluetoothNotification;

// Control adapter
client.EnableAdapter(adapterIndex);
client.StartDiscovery(adapterIndex, timeoutSeconds);
client.RequestToPair(deviceInfo);

Bluetooth Low Energy (BLE)

Provides BLE peripheral mode functionality including GATT server and advertisement management.

BLE Capabilities

• BLE stack lifecycle management
• Advertisement creation and management (including manufacturer data)
• GATT service, characteristic, and descriptor management
• Characteristic read, write, and notify operations
• Pairing confirmation flow

Attribute-Based Service Definition

Define BLE services declaratively using attributes and a ViewModel base class:

[BLEService(UUID = "180F", Name = "Battery Service", IsPrimary = true, Advertise = true)]
public class BatteryService : BLEServiceViewModelBase
{
    [BLECharacteristic(UUID = "2A19", Name = "Battery Level",
                       Flags = new[] { BLECharacteristicFlag.Read, BLECharacteristicFlag.Notify })]
    public byte BatteryLevel
    {
        get => batteryLevel;
        set => SetValue(ref batteryLevel, value);
    }
}

Available attributes:

• BLEServiceAttribute — Defines service UUID, name, and advertisement behavior
• BLECharacteristicAttribute — Defines characteristic UUID, name, and flags (Read, Write, Notify, Indicate)
• BLEManufactureDataAttribute — Defines manufacturer-specific advertisement data

BLE Client Usage

var client = new BLEServiceClient();

// Start BLE stack
client.StartStack(new BLEStackRequest { LocalName = "My Device" });

// Enable an attribute-defined service
var batteryService = new BatteryService();
batteryService.EnableService(client, advertProps);

Platform Support

The production platform is Linux using the BlueZ Bluetooth stack over D-Bus.

Companion Package

Ahsoka.Extensions.Bluetooth.UX — An OpenPV Developer Toolkit plugin providing an Avalonia-based UI for configuring Bluetooth Classic adapters, profiles, and Class of Device settings.

Requirements

• .NET 8.0 or .NET 10.0
• Ahsoka.Core 5.x

Useful Links

• D-Bus
• BlueZ
• Tmds.DBus (C# D-Bus library)
• BlueZ D-Bus Interfaces
• oFono D-Bus Interfaces (HFP)
• OpenPV Developer Resources