当前位置： 首页 > news >正文

【android bluetooth 框架分析 04】【bt-framework 层详解 6】【Properties介绍】

news 来源：原创 2025/6/13 7:11:40

DeviceProperties、AdapterProperties、StorageModule、以及 bt_config.conf 是 AOSP Bluetooth 栈中 设备属性管理与持久化系统 的核心组成部分，它们之间关系紧密，但职责各有不同。

下面我将依次讲解它们的区别与联系.

注意:

  • 在代码里面 还有 BluetoothProperties ： 他是管理 蓝牙相关的系统属性的， 和本文讨论的 DeviceProperties、AdapterProperties 不是同一个话题。
  • 有兴趣可以参看： 【android bluetooth 框架分析 04】【bt-framework 层详解 1】【BluetoothProperties介绍】

1. 核心组件职责概览

模块职责管理对象是否与存储直接交互
AdapterProperties管理本地蓝牙适配器的属性（如：名称、可发现性、IO能力）本地适配器✅ 是，会调用 StorageModule
DeviceProperties管理单个远程设备的属性（如名称、RSSI、UUID、版本信息等）每个远程设备一套✅ 是，会调用 StorageModule
StorageModule抽象了属性的持久化与加载逻辑，负责读写 bt_config.conf存储本地和远程设备属性✅ 是，底层对 bt_config.conf 读写
bt_config.conf配置文件，持久化存储蓝牙设备属性（ini 格式）适配器/已配对的远程设备✅ 是，由 StorageModule 管理

2. 各模块职责与交互细节

1. AdapterProperties

  • 对应的是本地蓝牙适配器的属性，如：

    • 本地蓝牙名 (BT_PROPERTY_BDNAME)

    • 适配器地址 (BT_PROPERTY_BDADDR)

    • 可发现性 (BT_PROPERTY_ADAPTER_SCAN_MODE)

    • LE 特性等

  • 存储方式：

    • 初始化时从 StorageModule 读取对应项

    • 修改时（如用户改蓝牙名）通过 StorageModule 写入 bt_config.conf 的 [Adapter] 节

2. DeviceProperties

  • 对应每一个远程设备（配对或曾连接）的属性，如：

    • 名称、RSSI、UUID、版本、是否支持某功能等

    • 这些属性通过扫描、配对、连接等过程获得

  • 管理方式：

    • 每个远程设备维护一个 DeviceProperties 实例（以地址为 key）

    • 当发现设备、连接、配对或服务发现后更新属性

  • 写入存储：

    • 只有绑定/配对成功的设备才会写入

      • 如果一个设备只是在扫描时被发现，会创建一个 临时的 DeviceProperties，保存在内存中。 掉电或者开关蓝牙时将丢失。

    • 这些属性会保存到 bt_config.conf 的 [RemoteDevice] 节，例如：

[RemoteDevice00:11:22:33:44:55]
Name=MyHeadphones
DevType=1
Service=180A 112D ...

3. StorageModule

  • 提供统一接口负责蓝牙配置的持久化与读取。

  • 核心功能：

    • 加载/保存本地适配器属性

    • 加载/保存配对设备属性

    • 支持迁移、同步、回写等操作

  • 底层调用 config.cc 进行 ini 格式文件操作。

我之前写过一篇 关于 StorageModule 模块的文章，需要 可以查阅：

  • 【android bluetooth 框架分析 02】【Module详解 6】【StorageModule 模块介绍】

4. bt_config.conf 文件

  • 位置：/data/misc/bluedroid/bt_config.conf

  • 权限：系统组件访问，普通 APP 不可读

  • 结构：

[Adapter]
Address=00:11:22:33:AA:BB
Name=CarBluetooth
ScanMode=1
DiscoverableTimeout=120[RemoteDevice11:22:33:44:55:66]
Name=Phone
DevType=1
Service=110A 110B

3. 关键问题：扫描到的未配对设备会写入 bt_config.conf 吗？

扫描到的未配对设备会写入 bt_config.conf 吗？

不会！

  • 当仅仅是扫描（inquiry/discovery）到一个设备时，系统可能会临时创建该设备的 DeviceProperties 实例，但不会写入 bt_config.conf。

  • 只有以下情形会触发写入：

    • 配对成功

    • 某些属性需要持久化（如用户手动设置了设备名等）

    • 有实际连接历史 + 存储条件满足（具体由 DeviceManager::Add 判断）

1. 临时设备属性的生命周期：

  • 临时创建的 DeviceProperties 保存在内存中

  • 断电或重启后不保留

  • 若用户未配对该设备，这些属性不会持久化

4. 模块关系图示意

+-----------------+
| AdapterProperties (本地适配器属性)
+-----------------+|v
+-----------------+
| StorageModule   | <-------> bt_config.conf (持久化存储)
+-----------------+^|
+------------------+
| DeviceProperties (远程设备属性)
| -- 每个设备一套 --
+------------------+

5. 我们 源码里面都定义了那些属性呢？

1. java 侧的属性表

  • android/app/src/com/android/bluetooth/btservice/AbstractionLayer.java
    static final int BT_PROPERTY_BDNAME = 0x01;static final int BT_PROPERTY_BDADDR = 0x02;static final int BT_PROPERTY_UUIDS = 0x03;static final int BT_PROPERTY_CLASS_OF_DEVICE = 0x04;static final int BT_PROPERTY_TYPE_OF_DEVICE = 0x05;static final int BT_PROPERTY_SERVICE_RECORD = 0x06;static final int BT_PROPERTY_ADAPTER_SCAN_MODE = 0x07;static final int BT_PROPERTY_ADAPTER_BONDED_DEVICES = 0x08;static final int BT_PROPERTY_ADAPTER_DISCOVERABLE_TIMEOUT = 0x09;static final int BT_PROPERTY_REMOTE_FRIENDLY_NAME = 0x0A;static final int BT_PROPERTY_REMOTE_RSSI = 0x0B;static final int BT_PROPERTY_REMOTE_VERSION_INFO = 0x0C;static final int BT_PROPERTY_LOCAL_LE_FEATURES = 0x0D;static final int BT_PROPERTY_LOCAL_IO_CAPS = 0x0e;static final int BT_PROPERTY_LOCAL_IO_CAPS_BLE = 0x0f;static final int BT_PROPERTY_DYNAMIC_AUDIO_BUFFER = 0x10;static final int BT_PROPERTY_REMOTE_IS_COORDINATED_SET_MEMBER = 0x11;

2. native 属性表

bt_property_type_t

  • system/include/hardware/bluetooth.h
/* Bluetooth Adapter and Remote Device property types */
typedef enum {/* Properties common to both adapter and remote device *//*** Description - Bluetooth Device Name* Access mode - Adapter name can be GET/SET. Remote device can be GET* Data type   - bt_bdname_t*/BT_PROPERTY_BDNAME = 0x1,/*** Description - Bluetooth Device Address* Access mode - Only GET.* Data type   - RawAddress*/BT_PROPERTY_BDADDR,/*** Description - Bluetooth Service 128-bit UUIDs* Access mode - Only GET.* Data type   - Array of bluetooth::Uuid (Array size inferred from property*               length).*/BT_PROPERTY_UUIDS,/*** Description - Bluetooth Class of Device as found in Assigned Numbers* Access mode - Only GET.* Data type   - uint32_t.*/BT_PROPERTY_CLASS_OF_DEVICE,/*** Description - Device Type - BREDR, BLE or DUAL Mode* Access mode - Only GET.* Data type   - bt_device_type_t*/BT_PROPERTY_TYPE_OF_DEVICE,/*** Description - Bluetooth Service Record* Access mode - Only GET.* Data type   - bt_service_record_t*/BT_PROPERTY_SERVICE_RECORD,/* Properties unique to adapter *//*** Description - Bluetooth Adapter scan mode* Access mode - GET and SET* Data type   - bt_scan_mode_t.*/BT_PROPERTY_ADAPTER_SCAN_MODE,/*** Description - List of bonded devices* Access mode - Only GET.* Data type   - Array of RawAddress of the bonded remote devices*               (Array size inferred from property length).*/BT_PROPERTY_ADAPTER_BONDED_DEVICES,/*** Description - Bluetooth Adapter Discoverable timeout (in seconds)* Access mode - GET and SET* Data type   - uint32_t*/BT_PROPERTY_ADAPTER_DISCOVERABLE_TIMEOUT,/* Properties unique to remote device *//*** Description - User defined friendly name of the remote device* Access mode - GET and SET* Data type   - bt_bdname_t.*/BT_PROPERTY_REMOTE_FRIENDLY_NAME,/*** Description - RSSI value of the inquired remote device* Access mode - Only GET.* Data type   - int8_t.*/BT_PROPERTY_REMOTE_RSSI,/*** Description - Remote version info* Access mode - SET/GET.* Data type   - bt_remote_version_t.*/BT_PROPERTY_REMOTE_VERSION_INFO,/*** Description - Local LE features* Access mode - GET.* Data type   - bt_local_le_features_t.*/BT_PROPERTY_LOCAL_LE_FEATURES,/*** Description - Local Input/Output Capabilities for classic Bluetooth* Access mode - GET and SET* Data Type - bt_io_cap_t.*/BT_PROPERTY_LOCAL_IO_CAPS,/*** Description - Local Input/Output Capabilities for BLE* Access mode - GET and SET* Data Type - bt_io_cap_t.*/BT_PROPERTY_LOCAL_IO_CAPS_BLE,BT_PROPERTY_DYNAMIC_AUDIO_BUFFER,/*** Description - True if Remote is a Member of a Coordinated Set.* Access mode - GET.* Data Type - bool.*/BT_PROPERTY_REMOTE_IS_COORDINATED_SET_MEMBER,BT_PROPERTY_REMOTE_DEVICE_TIMESTAMP = 0xFF,
} bt_property_type_t;

3. 属性使用场景介绍

1. AdapterProperties 和 DeviceProperties 共同使用

枚举常量说明使用范围数据类型访问权限
🔁 适用于 Adapter 和 Remote Device
BT_PROPERTY_BDNAME设备名称Adapter: 读/写Remote Device: 只读bt_bdname_tGET / SET（Adapter）GET（Remote）
BT_PROPERTY_BDADDR设备地址Adapter & Remote DeviceRawAddressGET
BT_PROPERTY_UUIDS支持的服务 UUID 列表Remote Devicebluetooth::Uuid[]GET
BT_PROPERTY_CLASS_OF_DEVICE类别码Remote Deviceuint32_tGET
BT_PROPERTY_TYPE_OF_DEVICE设备类型（BR/EDR/LE）Remote Devicebt_device_type_tGET
BT_PROPERTY_SERVICE_RECORD服务记录Remote Devicebt_service_record_tGET

2. 仅 AdapterProperties 使用

枚举常量说明使用范围数据类型访问权限
🧭 仅适用于 Adapter（本地适配器）
BT_PROPERTY_ADAPTER_SCAN_MODE扫描模式（可发现性）Adapterbt_scan_mode_tGET / SET
BT_PROPERTY_ADAPTER_BONDED_DEVICES已绑定设备地址列表AdapterRawAddress[]GET
BT_PROPERTY_ADAPTER_DISCOVERABLE_TIMEOUT可发现超时时间Adapteruint32_tGET / SET
BT_PROPERTY_LOCAL_LE_FEATURES本地 LE 特性Adapterbt_local_le_features_tGET
BT_PROPERTY_LOCAL_IO_CAPS本地 IO 能力（经典蓝牙）Adapterbt_io_cap_tGET / SET
BT_PROPERTY_LOCAL_IO_CAPS_BLE本地 IO 能力（BLE）Adapterbt_io_cap_tGET / SET
BT_PROPERTY_DYNAMIC_AUDIO_BUFFER音频缓冲设置（动态）Adapter自定义类型（未明确）

3. 仅 DeviceProperties 使用

枚举常量说明使用范围数据类型访问权限
📡 仅适用于 Remote Device（远程设备）
BT_PROPERTY_REMOTE_FRIENDLY_NAME远程设备名称（用户设定）Remote Devicebt_bdname_tGET / SET
BT_PROPERTY_REMOTE_RSSI远程设备 RSSIRemote Deviceint8_tGET
BT_PROPERTY_REMOTE_VERSION_INFO远程设备协议版本信息Remote Devicebt_remote_version_tGET / SET
BT_PROPERTY_REMOTE_IS_COORDINATED_SET_MEMBER是否是协同设备成员Remote DeviceboolGET
BT_PROPERTY_REMOTE_DEVICE_TIMESTAMP属性刷新时间戳Remote Deviceint64_t（或自定义）GET

4. 小结

分类枚举项
Adapter 专属属性ADAPTER_SCAN_MODE, ADAPTER_BONDED_DEVICES, ADAPTER_DISCOVERABLE_TIMEOUT, LOCAL_LE_FEATURES, LOCAL_IO_CAPS, LOCAL_IO_CAPS_BLE, DYNAMIC_AUDIO_BUFFER
Remote Device 专属属性REMOTE_FRIENDLY_NAME, REMOTE_RSSI, REMOTE_VERSION_INFO, REMOTE_IS_COORDINATED_SET_MEMBER, REMOTE_DEVICE_TIMESTAMP, CLASS_OF_DEVICE, TYPE_OF_DEVICE, SERVICE_RECORD, UUIDS
Adapter 与 Remote 共用属性BDNAME, BDADDR

6. 总结重点

关键点说明
AdapterProperties管理本地适配器的属性，初始化时加载并可写入 bt_config.conf
DeviceProperties管理远程设备属性，仅在配对后写入 bt_config.conf
StorageModule所有属性存储的中间桥梁
bt_config.conf存储持久化蓝牙信息的文件，位于 /data/misc/bluedroid
扫描行为是否写入文件？❌ 不会，只有绑定/配对设备才写入

接下来我会出单独的文章来总结 DeviceProperties、AdapterProperties.

敬请期待!!!

相关文章：

  • Springboot仿抖音app开发之消息业务模块后端复盘及相关业务知识总结
  • php反序列化漏洞学习
  • [安卓按键精灵辅助工具]一些安卓端可以用的雷电模拟器adb命令
  • 关于安卓dialogFragment中，EditText无法删除文字的问题
  • Android NTP自动同步时间机制
  • 展开说说Android之Glide详解_使用篇
  • DRG支付场景模拟器扩展分析：技术实现与应用价值
  • 算法导论第三章：数据结构艺术与高效实现
  • 为什么TCP有粘包问题，而UDP没有
  • 前端导出PDF(适配ios Safari浏览器）
  • 力扣HOT100之技巧：136. 只出现一次的数字
  • opencl的简单介绍以及c++实例
  • 爱普生FC-135R晶振在广域网LoRa设备中的应用
  • openEuler 虚拟机中 Shell 脚本实现自动化备份与清理实践
  • Tomcat线程模型
  • 单链表经典算法
  • nt!CcGetDirtyPages函数分析
  • 软件测试相关问题
  • 蓝牙无线串口入门使用教程（以大夏龙雀 WF24 和 BT36 为例）
  • PCI总线概述
  • 网站加入我们页面/小程序开发公司排行榜
  • 个人建站的app哪里有卖/外链系统
  • 西安网站建设优化/西安关键词seo公司
  • 牡丹江网站建设公司/整合营销名词解释
  • 郑州汉狮做网站费用/电商运营推广怎么做
  • 如何做高清pdf下载网站/长沙网站推广智投未来