BLE Monitor 项目配置参数详解

BLE Monitor 项目配置参数详解

BLE Monitor 是一个用于监控蓝牙低功耗(BLE)设备的组件，能够从各种BLE传感器收集数据并集成到智能家居系统中。本文将全面解析BLE Monitor的配置参数，帮助用户根据实际需求进行个性化设置。

组件级配置参数

蓝牙接口配置

bt_interface

蓝牙接口MAC地址

• 类型：MAC地址字符串或列表，可选"disable"
• 功能：指定Home Assistant主机使用的蓝牙接口
• 使用说明：
  • 系统启动时会在日志中列出可用蓝牙接口
  • 可指定单个或多个接口
  • 设为"disable"可完全禁用蓝牙适配器
• 示例：

ble_monitor:
  bt_interface:
    - '04:B1:38:2C:84:2B'
    - '34:DE:36:4F:23:2C'

• 默认值：系统第一个可用接口

hci_interface (仅YAML)

蓝牙接口hci编号

• 类型：整数或列表，可选"disable"
• 注意：建议优先使用bt_interface，因hci编号可能变动
• 示例：

ble_monitor:
  hci_interface:
    - 0
    - 1

蓝牙适配器管理

bt_auto_restart

蓝牙适配器自动重启

• 类型：布尔值
• 功能：在蓝牙故障时自动重启适配器
• 适用场景：蓝牙适配器周期性失效的情况
• 示例：

ble_monitor:
  bt_auto_restart: True

扫描模式设置

active_scan

主动扫描模式

• 类型：布尔值
• 影响：
  • True：发送扫描请求，略微增加传感器耗电
  • False：被动接收广播(推荐)
• 默认值：False

设备发现控制

discovery

自动发现设备

• 类型：布尔值
• 功能：
  • True：自动为所有支持的设备创建实体
  • False：仅监控devices列表中指定的设备
• 典型应用：避免接收邻居设备数据
• 示例：

ble_monitor:
  discovery: False
  devices:
    - mac: '58:C1:38:2F:86:6C'

数据处理参数

period

数据采集周期

• 类型：正整数(秒)
• 功能：设定数据收集和平均的时间窗口
• 说明：不影响传感器本身广播频率，仅影响HA更新间隔
• 默认值：60秒

use_median

使用中位数代替平均值

• 类型：布尔值
• 适用场景：传感器数据波动较大时
• 注意：原始数据属性中仍包含平均值和中位数
• 默认值：False

log_spikes

记录异常值

• 类型：布尔值
• 功能：将超出测量范围的异常值记录到日志
• 默认值：False

状态恢复设置

restore_state

重启后恢复状态

• 类型：布尔值
• 注意事项：
  • True：立即恢复重启前状态(可能不准确)
  • False：等待新数据(显示"不可用")
• 推荐：测量类传感器可启用，二进制传感器建议禁用
• 默认值：False

未知设备报告

report_unknown

报告未知设备

• 类型：品牌名称或"Other"/"False"
• 用途：协助开发新设备支持
• 警告：设为"Other"会产生大量日志
• 示例：

ble_monitor:
  report_unknown: "Xiaomi"

设备级配置参数

设备基础配置

mac/uuid

设备标识符

• 类型：字符串
• 必填：至少指定一个
• 注意：uuid优先级高于mac

name

设备名称

• 功能：自定义实体ID前缀
• 效果：创建新实体，需手动清理旧实体

encryption_key

加密密钥

• 长度：24或32字符
• 注意：不同设备需要不同长度的密钥

设备特定设置

temperature_unit

温度单位

• 选项：C或F
• 特殊情况：ATC固件设备需特别设置

reset_timer

状态重置计时器

• 单位：秒
• 应用：
  • 运动传感器：35秒(推荐)
  • 按钮：1秒(推荐)
  • 0表示禁用自动重置

设备级覆盖参数

use_median/restore_state

覆盖组件级设置

• 选项：True/False/default
• 功能：为特定设备单独设置

配置建议

1. 基础配置：大多数用户只需设置bt_interface和encryption_key
2. 数据稳定性：数据波动大时启用use_median和log_spikes
3. 设备管理：建议为所有设备指定mac和name，便于长期维护
4. 性能优化：在密集环境中设置discovery=False提高效率

通过合理配置这些参数，用户可以优化BLE Monitor的性能，获得更稳定可靠的传感器数据集成体验。