基于.NET和Improv协议的IoT设备蓝牙配网方案

1. 项目背景与核心价值

最近在开发智能硬件项目时，我遇到了一个典型痛点：如何让没有屏幕的IoT设备快速接入Wi-Fi网络？传统方案要么依赖手机热点切换，要么需要硬件增加额外按键，用户体验都不够优雅。经过技术调研，发现采用Improv Wi-Fi蓝牙配网协议是个不错的解决方案，于是决定用.NET技术栈实现一套跨平台的配网工具。

Improv Wi-Fi协议的核心思想是通过蓝牙BLE通道传输Wi-Fi凭证。设备启动后进入配网模式，通过广播特定服务UUID告知客户端自己的存在。手机或电脑上的控制端扫描到设备后，建立蓝牙连接并将目标Wi-Fi的SSID和密码加密传输给设备。设备获取凭证后自动尝试连接指定网络，并通过蓝牙回传连接状态。

这套方案相比传统配网方式有三大优势：

1. 无需硬件增加额外按键或屏幕，降低成本
2. 用户无需切换手机网络，操作流程更顺畅
3. 蓝牙传输比热点方式更安全可靠

2. 技术方案设计

2.1 整体架构设计

系统需要实现两端：

• 设备端：运行在智能硬件上，使用蓝牙广播Improv服务，接收并处理配网指令
• 客户端：跨平台应用，扫描发现设备，提供UI界面输入Wi-Fi信息并传输

考虑到.NET的跨平台特性，我选择如下技术栈：

• 设备端：.NET NanoFramework（支持资源受限的嵌入式设备）
• 客户端：.NET MAUI（一套代码支持Android/iOS/Windows/macOS）
• 蓝牙通信：通用GATT协议，兼容标准Improv服务规范

2.2 Improv协议实现要点

根据官方规范，需要实现以下核心服务：

设备状态机需要处理以下状态转换：

code复制配网就绪 → 凭证接收中 → 凭证接收完成 → 正在连接 → 连接成功/失败

2.3 安全设计考虑

Wi-Fi凭证传输需要特别注意安全性：

1. 使用AES-128加密传输内容（密钥通过设备唯一ID派生）
2. 限制配网有效期为5分钟（超时后需重启配网流程）
3. 客户端需验证设备证书指纹（防止中间人攻击）

3. 设备端实现细节

3.1 NanoFramework环境搭建

设备端以ESP32为例，开发环境配置步骤：

1. 安装Visual Studio扩展"nanoFramework Extension"
2. 创建nanoFramework ESP32空白项目
3. 添加NuGet包：
   • nanoFramework.Device.Bluetooth
   • nanoFramework.Networking
4. 配置WiFi和蓝牙初始化：

csharp复制// 初始化蓝牙
BluetoothLEServer server = BluetoothLEServer.Instance;
server.DeviceName = "ImprovDevice";
GattServiceProvider improvService = CreateImprovService();

// WiFi配置
WifiNetworkHelper.Connect(ssid, password, requiresDateTime: true);

3.2 Improv服务实现

核心服务构建代码示例：

csharp复制private GattServiceProvider CreateImprovService() 
{
    var serviceProvider = new GattServiceProvider(
        new Guid("00467768-6228-2272-4663-277478268000"));
    
    // 状态特征
    var statusChar = new GattLocalCharacteristic(
        new Guid("00467768-6228-2272-4663-277478268001"),
        new GattLocalCharacteristicParameters {
            CharacteristicProperties = GattCharacteristicProperties.Read | 
                                     GattCharacteristicProperties.Notify,
            UserDescription = "Device State"
        });
    
    // RPC命令特征
    var rpcCmdChar = new GattLocalCharacteristic(
        new Guid("00467768-6228-2272-4663-277478268003"),
        new GattLocalCharacteristicParameters {
            CharacteristicProperties = GattCharacteristicProperties.Write,
            UserDescription = "RPC Command"
        });
    
    serviceProvider.AddCharacteristic(statusChar);
    serviceProvider.AddCharacteristic(rpcCmdChar);
    return serviceProvider;
}

3.3 状态机处理逻辑

设备端需要维护当前状态并处理客户端指令：

csharp复制enum ImprovState {
    ReadyToProvision = 1,
    Provisioning = 2,
    Provisioned = 3,
    Connecting = 4,
    Connected = 5
}

void ProcessRpcCommand(byte[] command) 
{
    switch(command[0]) {
        case 0x01: // 设置凭证
            currentState = ImprovState.Provisioning;
            string ssid = Encoding.UTF8.GetString(command, 1, command[1]);
            string password = Encoding.UTF8.GetString(command, 2+command[1], command[2+command[1]]);
            StartConnectWiFi(ssid, password);
            break;
        case 0x02: // 获取当前状态
            SendStateUpdate();
            break;
    }
}

4. 客户端实现（.NET MAUI）

4.1 跨平台蓝牙适配

MAUI项目中需要处理各平台蓝牙权限：

xml复制<!-- Android Manifest -->
<uses-permission android:name="android.permission.BLUETOOTH" />
<uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />
<uses-permission android:name="android.permission.BLUETOOTH_SCAN" />
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />

使用Plugin.BLE库简化跨平台操作：

csharp复制var adapter = CrossBluetoothLE.Current.Adapter;
var devices = await adapter.ScanForDevicesAsync(new Guid("00467768-6228-2272-4663-277478268000"));

var device = devices.First();
await adapter.ConnectToDeviceAsync(device);

var service = await device.GetServiceAsync(improvServiceUuid);
var stateChar = await service.GetCharacteristicAsync(stateCharUuid);
var rpcChar = await service.GetCharacteristicAsync(rpcCharUuid);

4.2 用户界面设计

MAUI页面关键元素：

• 设备列表（ListView绑定扫描结果）
• Wi-Fi输入表单（Entry控件）
• 状态显示区域（Label+ProgressBar）
• 操作按钮（开始扫描/停止/连接）

XAML示例：

xml复制<VerticalStackLayout>
    <Button Text="扫描设备" Command="{Binding ScanCommand}"/>
    <ListView ItemsSource="{Binding Devices}">
        <ListView.ItemTemplate>
            <DataTemplate>
                <TextCell Text="{Binding Name}" Detail="{Binding Id}"/>
            </DataTemplate>
        </ListView.ItemTemplate>
    </ListView>
    
    <Entry Placeholder="Wi-Fi名称" Text="{Binding Ssid}"/>
    <Entry Placeholder="密码" Text="{Binding Password}" IsPassword="True"/>
    <Button Text="发送凭证" Command="{Binding ProvisionCommand}"/>
    
    <Label Text="{Binding StatusMessage}"/>
    <ProgressBar Progress="{Binding Progress}"/>
</VerticalStackLayout>

4.3 凭证传输逻辑

处理与设备的交互流程：

csharp复制async Task ProvisionDevice(string ssid, string password)
{
    // 构建RPC命令
    var ssidBytes = Encoding.UTF8.GetBytes(ssid);
    var pwdBytes = Encoding.UTF8.GetBytes(password);
    var command = new byte[3 + ssidBytes.Length + pwdBytes.Length];
    command[0] = 0x01; // 设置凭证指令
    command[1] = (byte)ssidBytes.Length;
    Array.Copy(ssidBytes, 0, command, 2, ssidBytes.Length);
    command[2 + ssidBytes.Length] = (byte)pwdBytes.Length;
    Array.Copy(pwdBytes, 0, command, 3 + ssidBytes.Length, pwdBytes.Length);
    
    // 发送命令
    await rpcChar.WriteAsync(command);
    
    // 监听状态变化
    stateChar.ValueUpdated += (o, args) => {
        var state = (ImprovState)args.Characteristic.Value[0];
        UpdateUI(state);
    };
    await stateChar.StartUpdatesAsync();
}

5. 调试与优化技巧

5.1 常见问题排查

1. 设备无法被发现

   • 检查设备端服务UUID是否正确广播
   • 确认手机蓝牙权限已授权
   • 在Android上需要开启位置权限才能扫描BLE设备

2. 凭证传输失败

   • 检查特征属性的读写权限是否匹配
   • 验证数据包格式是否符合Improv规范
   • 使用nRF Connect等工具抓包分析

3. Wi-Fi连接超时

   • 设备端增加重试机制（建议3次）
   • 检查Wi-Fi模块初始化是否正确
   • 验证天线性能（RSSI应大于-70dBm）

5.2 性能优化建议

1. 蓝牙广播间隔调整：

   csharp复制// ESP32上设置广播间隔为100ms
   var advParams = new AdvertisementParameters {
       Interval = 100,
       Type = AdvertisementType.ConnectableUndirected
   };
   server.StartAdvertising(advParams);
   

2. 数据包压缩：

   • 对SSID和密码使用Deflate压缩后再传输
   • 在设备端使用微型解压库（如nanoFramework.System.IO.Compression）

3. 内存优化：

   • 使用ArrayPool共享字节数组
   • 限制最大凭证长度（SSID 32字节+密码64字节）

5.3 生产环境增强

1. 设备认证：

   • 每个设备预置唯一证书
   • 客户端验证设备签名后才允许配网

2. 日志记录：

   • 在Flash中记录最后5次配网操作
   • 包含时间戳、客户端MAC和连接结果

3. OTA支持：

   • 通过蓝牙传输固件更新包
   • 使用差分更新减少数据传输量

6. 项目扩展方向

在实际部署中，我发现这套基础架构可以进一步扩展：

1. 批量配网模式：
   在工厂生产时，可以通过NFC写入初始配置，设备首次上电自动连接测试工位的Wi-Fi

2. 多协议支持：
   除了Improv协议，可以同时实现Apple HomeKit的EAP配网方式，提升iOS用户体验

3. 网络诊断功能：
   设备连接Wi-Fi后，可以通过蓝牙通道上报网络质量数据（信号强度、丢包率等）

4. 声波配网备用方案：
   在蓝牙不可用时，可以通过扬声器播放编码后的Wi-Fi信息，手机麦克风接收解码

这套.NET实现的跨平台配网方案已经在我们的智能插座产品线上稳定运行，平均配网时间从原来的2分钟缩短到15秒以内，用户投诉率下降了83%。对于需要连接Wi-Fi的无屏设备，Improv协议确实是个优雅的解决方案。