ATC_MiThermometer项目解析：米家BLE连接协议与Mi Service详解

ATC_MiThermometer项目解析：米家BLE连接协议与Mi Service详解

ATC_MiThermometer Custom firmware for the Xiaomi Thermometers and Telink Flasher 项目地址: https://gitcode.com/gh_mirrors/atc/ATC_MiThermometer

前言

在智能家居领域，蓝牙低功耗(BLE)技术因其低功耗特性被广泛应用于各类传感器设备。本文将深入解析ATC_MiThermometer项目中使用的米家BLE连接协议，帮助开发者理解如何实现与米家生态系统的无缝对接。

协议概述

米家BLE连接协议是小米智能家居生态系统中蓝牙设备与米家APP通信的标准规范。该协议定义了设备广播格式、服务特性以及安全认证机制，确保不同厂商的设备能够在米家生态中互操作。

设备分级体系

根据设备功能复杂度，协议将BLE设备分为两个级别：

1. 一级设备：仅具备广播能力，适用于简单传感器类产品
2. 二级设备：支持完整蓝牙连接功能，可实现更复杂的交互

ATC_MiThermometer作为温湿度监测设备，通常采用一级设备设计，但协议实现上也兼容二级设备功能。

Mi Service核心服务解析

协议核心服务UUID为0xFE95，包含多个关键特性：

| UUID | 大小 | 属性 | 功能描述 | |-------|------|-------------|--------------------| | 0x0001| 12 | 写/通知 | 设备令牌交换 | | 0x0002| 2 | 只读 | 产品ID标识 | | 0x0004| 10 | 只读 | 固件版本信息 | | 0x0010| 4 | 写 | 认证控制 | | 0x0014| 12 | 只读 | Beacon密钥 |

特别值得注意的是版本号格式采用xxx_xxxx设计，前段由生态链公司定义，后段由小米控制。

应用层服务设计

除核心服务外，协议还定义了应用层服务：

| UUID | 大小 | 属性 | 功能描述 | |-------|------|-----------|------------------| | 0xFFE0| 4 | 读/写 | LED状态控制 | | 0xFFE1| 4 | 通知 | 按钮事件上报 |

对于ATC_MiThermometer这类设备，LED控制可用于指示设备状态，而按钮事件则可实现设备配对等功能。

安全机制详解

协议安全设计包含两大层面：

1. 设备与APP间安全：基于安全认证机制，包括：

   • 首次连接时的绑定流程
   • 后续连接的登录验证
   • 使用混淆算法(1.x版本)或加密算法套件(2.x版本)

2. 设备间广播安全：支持通过预交换密钥实现广播消息加密

开发时需特别注意：未经成功绑定/登录的设备，必须拒绝所有特征读写操作。

协议实现要点

在ATC_MiThermometer项目中实现协议时，需要关注以下关键函数：

• mible_server_info_init：初始化设备基础信息
• mible_server_miservice_init：Mi Service服务初始化
• mible_bonding_evt_callback：绑定结果回调处理

典型实现流程：

1. 设备上电后初始化协议栈
2. 配置产品ID、版本号等参数
3. 注册各类事件回调函数
4. 启动广播和服务

开发注意事项

1. 版本管理：协议调整或bug修复必须更新次版本号
2. 用户数据：设备重新绑定后需立即清除前用户配置
3. 广播格式：必须包含Mi Service UUID和服务数据字段
4. 连接控制：严格遵循绑定/登录状态机

结语

通过实现米家BLE连接协议，ATC_MiThermometer能够无缝接入米家智能家居生态系统，与其他设备实现联动控制。开发者应深入理解协议的分层设计和安全机制，确保设备的稳定性和安全性。对于资源受限的设备，可考虑采用一级设备实现方案，在保证功能的同时优化功耗表现。

ATC_MiThermometer Custom firmware for the Xiaomi Thermometers and Telink Flasher 项目地址: https://gitcode.com/gh_mirrors/atc/ATC_MiThermometer