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

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

ops 2025/6/19 18:36:09

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.

敬请期待!!!

http://www.xdnf.cn/news/13709.html

相关文章：

  • FEC（Forward Error Correction）前向纠错快速了解
  • 【AS32系列MCU调试教程】硬件调试：JLink 驱动配置与调试技巧
  • 5 Android系统常用debug方法
  • [安卓按键精灵辅助工具]一些安卓端可以用的雷电模拟器adb命令
  • 行为模式-命令模式
  • Dagster 实现数据质量自动化：6大维度检查与最佳实践
  • 工厂模式demo
  • Peiiieee的Linux笔记（1）
  • 基于大模型预测的上睑下垂综合诊疗技术方案
  • 浅析4D-bev标注技术在自动驾驶领域的重要性
  • 数据库更新！万方
  • centos转移mysql的数据存储目录
  • 猎犬：快速 友好的桌面文本搜索软件 支持30+格式与高精度OCR
  • HTTP系列---有状态
  • 在MATLAB命令行执行ros2node 和 ros2subscriber后，执行ros2 topic list，MATLAB卡死
  • 云服务器如何搭建多站点？Nginx多域名部署方案详解 (2025)
  • 中国第七次人口普查100m网格化人口数据集(Tif/分省/分市)
  • 使用 VLC Media Player 轻松提取视频中的音频文件
  • 一分钟部署nginx-公网IP访问内网
  • RED DA认证-EN18031网络安全常见问题以及解答
  • 玛哈特零件矫平机：精密制造中的平整度守护者
  • gRPC 与 JSON 之间的类型映射规则
  • PH热榜 | 2025-06-12
  • odoo CRM中销售管道的自定义与阶段管理
  • 使用Optimization tool优化后禁用windows更新批量的脚本
  • 深入解析Web信息探测与分析技术：网站指纹识别、敏感文件扫描与端口探测实战
  • 《linux2.4内存管理》第 4 章 进程地址空间
  • 执行应用共享内存空间 同步QT进行快速捕获数据流
  • 5.4.1树的存储结构
  • 如何搭建反向海淘代购系统？