updates

Author: aritchie

src/content/docs/client/obd/ble.md

@@ -45,6 +45,35 @@ If the defaults don't work, use a BLE scanner app (like nRF Connect) to discover
 
 ## Creating a Transport
 
+### From a Discovered Device (recommended)
+
+Use `BleObdDeviceScanner` to find adapters, then pass the selected device:
+
+```csharp
+IBleManager bleManager = /* from DI or Shiny setup */;
+
+var scanner = new BleObdDeviceScanner(bleManager, new BleObdConfiguration
+{
+    DeviceNameFilter = "OBDII"  // optional: matches any device name containing "OBDII"
+});
+
+var cts = new CancellationTokenSource();
+var devices = new List<ObdDiscoveredDevice>();
+
+await scanner.Scan(device =>
+{
+    devices.Add(device);
+    Console.WriteLine($"Found: {device.Name} ({device.Id})");
+}, cts.Token);
+
+// Connect to a selected device
+var transport = new BleObdTransport(devices[0], new BleObdConfiguration());
+var connection = new ObdConnection(transport);
+await connection.Connect();
+```
+
+`BleObdDeviceScanner` deduplicates by peripheral UUID — each device is reported once. Cancel the token to stop scanning.
+
 ### Auto-Scan
 
 Let the transport scan for the first device matching your filter:
@@ -75,6 +104,27 @@ var connection = new ObdConnection(transport);
 await connection.Connect(); // connects to known peripheral, initializes
 ```
 
+## MAUI Setup
+
+Register BLE and the scanner in your `MauiProgram.cs`:
+
+```csharp
+using Shiny;
+using Shiny.Obd;
+using Shiny.Obd.Ble;
+
+var builder = MauiApp.CreateBuilder();
+builder.UseMauiApp<App>();
+
+builder.Services.AddBluetoothLE();
+builder.Services.AddSingleton(new BleObdConfiguration { DeviceNameFilter = "OBD" });
+builder.Services.AddSingleton<IObdDeviceScanner, BleObdDeviceScanner>();
+```
+
+:::note
+In Shiny.BluetoothLE v4, use `services.AddBluetoothLE()` (namespace `Shiny`). There is no `UseShiny()` or `AddBle()` call needed.
+:::
+
 ## Full Example
 
 ```csharp
@@ -143,7 +193,7 @@ public class DashboardData
 
 The BLE transport:
 
-1. **Scans** for a peripheral matching the configured service UUID and optional device name filter (or uses a pre-provided peripheral)
+1. **Scans** for a peripheral matching the configured service UUID and optional device name filter (or uses a pre-provided peripheral / discovered device)
 2. **Connects** using Shiny's task-based `ConnectAsync`
 3. **Subscribes** to notifications on the read characteristic via `NotifyCharacteristic`
 4. **Sends commands** by writing bytes to the write characteristic via `WriteCharacteristicAsync`

src/content/docs/client/obd/index.md

@@ -9,6 +9,7 @@ Shiny.Obd is a .NET library for communicating with vehicles through OBD-II (On-B
 - **Command-object pattern** — OBD commands are objects, not methods. Pass built-in commands or create your own for custom PIDs.
 - **Generic return types** — each command declares its return type (`int`, `double`, `string`, `TimeSpan`, etc.) with compile-time safety.
 - **Pluggable transports** — `IObdTransport` abstracts the communication channel. Ships with BLE; add WiFi or USB later.
+- **Device discovery** — `IObdDeviceScanner` finds available adapters before connecting. BLE scanner included.
 - **Adapter auto-detection** — detects ELM327 vs OBDLink (STN) adapters via ATI and runs the appropriate initialization sequence.
 - **Task-based async** — fully async/await throughout, no Reactive Extensions required in consuming code.
 - **9 standard commands included** — speed, RPM, coolant temp, throttle, fuel level, engine load, intake air temp, runtime, and VIN.
@@ -32,13 +33,21 @@ using Shiny.Obd;
 using Shiny.Obd.Ble;
 using Shiny.Obd.Commands;
 
-// Create BLE transport
-var transport = new BleObdTransport(bleManager, new BleObdConfiguration
+// Scan for an adapter
+var scanner = new BleObdDeviceScanner(bleManager, new BleObdConfiguration
 {
     DeviceNameFilter = "OBDLink"
 });
+var cts = new CancellationTokenSource();
+ObdDiscoveredDevice? selected = null;
+await scanner.Scan(device =>
+{
+    selected = device;
+    cts.Cancel();
+}, cts.Token);
 
-// Create connection (auto-detects adapter type)
+// Connect using the discovered device
+var transport = new BleObdTransport(selected!, new BleObdConfiguration());
 var connection = new ObdConnection(transport);
 await connection.Connect();
 
@@ -65,8 +74,8 @@ var vin = await connection.Execute(StandardCommands.Vin);              // string
 └──────────────────────┬──────────────────────────┘
                        │
 ┌──────────────────────▼──────────────────────────┐
-│             IObdTransport                       │
-│  Pluggable transport layer                      │
+│  IObdDeviceScanner ──▶ IObdTransport            │
+│  Discover adapters     Pluggable transport layer │
 │  ┌────────────────┐  ┌────────┐  ┌─────────┐   │
 │  │ BleObdTransport│  │ WiFi   │  │  USB    │   │
 │  │ (Shiny BLE)    │  │(future)│  │(future) │   │

src/content/docs/client/obd/transports.md

@@ -4,6 +4,15 @@ title: Custom Transports
 
 The `IObdTransport` interface abstracts the communication channel between your app and the OBD adapter. The library ships with BLE, but you can implement WiFi, USB, or any other transport.
 
+For transports that support discovery (BLE, WiFi), implement `IObdDeviceScanner` as well:
+
+```csharp
+public interface IObdDeviceScanner
+{
+    Task Scan(Action<ObdDiscoveredDevice> onDeviceFound, CancellationToken ct = default);
+}
+```
+
 ## IObdTransport Interface
 
 ```csharp