BLE Monitor 开源项目教程

BLE Monitor 开源项目教程

ble_monitorBLE monitor for passive BLE sensors项目地址:https://gitcode.com/gh_mirrors/bl/ble_monitor

1. 项目的目录结构及介绍

BLE Monitor 项目的目录结构如下：

ble_monitor/
├── ble_monitor/
│   ├── __init__.py
│   ├── const.py
│   ├── sensor.py
│   ├── bt_helpers.py
│   ├── binary_sensor.py
│   ├── device_tracker.py
│   ├── __pycache__/
│   └── ...
├── custom_components/
│   ├── ble_monitor/
│   │   ├── __init__.py
│   │   ├── const.py
│   │   ├── sensor.py
│   │   ├── bt_helpers.py
│   │   ├── binary_sensor.py
│   │   ├── device_tracker.py
│   │   └── ...
├── tests/
│   ├── __init__.py
│   ├── test_sensor.py
│   └── ...
├── .gitignore
├── LICENSE
├── README.md
├── requirements.txt
└── setup.py

目录结构介绍

• ble_monitor/: 主项目目录，包含核心代码文件。

  • __init__.py: 初始化文件。
  • const.py: 常量定义文件。
  • sensor.py: 传感器相关代码。
  • bt_helpers.py: 蓝牙辅助功能代码。
  • binary_sensor.py: 二进制传感器相关代码。
  • device_tracker.py: 设备追踪相关代码。
  • __pycache__/: 编译后的字节码缓存目录。

• custom_components/: 自定义组件目录，用于集成到 Home Assistant。

  • ble_monitor/: 与主项目目录结构相同，用于 Home Assistant 集成。

• tests/: 测试目录，包含单元测试文件。

  • __init__.py: 初始化文件。
  • test_sensor.py: 传感器相关单元测试。

• .gitignore: Git 忽略文件配置。

• LICENSE: 项目许可证。

• README.md: 项目说明文档。

• requirements.txt: 项目依赖文件。

• setup.py: 项目安装脚本。

2. 项目的启动文件介绍

BLE Monitor 项目的启动文件是 ble_monitor/__init__.py。该文件负责初始化项目并加载必要的模块和配置。

__init__.py 文件内容概述

• 导入必要的模块和常量。
• 定义项目的基本配置和初始化逻辑。
• 加载传感器、二进制传感器和设备追踪模块。
• 处理配置更新和状态管理。

3. 项目的配置文件介绍

BLE Monitor 项目的配置文件通常位于 Home Assistant 的 configuration.yaml 文件中。以下是一个典型的配置示例：

ble_monitor:
  bt_interface: '00:1A:7D:DA:71:13'
  discovery: true
  active_scan: false
  report_unknown: false
  devices:
    - mac: 'A4:C1:38:2F:86:6C'
      name: 'Living Room Sensor'
    - mac: 'C4:7C:8D:6B:4F:24'
      name: 'Bedroom Sensor'

配置项介绍

• bt_interface: 指定蓝牙接口的 MAC 地址。
• discovery: 是否启用自动发现设备功能。
• active_scan: 是否启用主动扫描模式。
• report_unknown: 是否报告未知设备。
• devices: 设备列表，包含每个设备的 MAC 地址和名称。

通过以上配置，BLE Monitor 可以监控指定的蓝牙设备并将其状态集成到 Home Assistant 中。

ble_monitorBLE monitor for passive BLE sensors项目地址:https://gitcode.com/gh_mirrors/bl/ble_monitor