GoveeBTTempLogger 项目使用教程
1. 项目介绍
GoveeBTTempLogger 是一个用于记录 Govee 品牌蓝牙低功耗(BLE)温度和湿度传感器数据的工具。支持的设备包括 Govee H5072、H5074、H5075、H5100、H5101、H5104、H5105、H5174、H5177、H5179、H5181、H5182 和 H5183。该项目最初使用 Microsoft Visual Studio 2017 开发,目标平台为运行 Linux 的 ARM 处理器,如 Raspberry Pi。
GoveeBTTempLogger 的主要功能包括:
- 创建日志文件,记录每个设备的温度、湿度、电池百分比和日期(UTC 时间)。
- 支持每月创建新的日志文件。
- 支持通过命令行选项生成 HTML 索引文件。
- 支持通过 BlueZ 和 DBus 进行蓝牙通信。
- 支持生成 SVG 图形文件,展示温度和湿度的历史数据。
2. 项目快速启动
2.1 环境准备
确保你的系统满足以下要求:
- Linux Kernel 版本 3.6 或更高
- 安装
libbluetooth-dev
和libdbus-1-dev
在 Ubuntu/Debian/Raspbian 系统上,可以使用以下命令安装依赖:
sudo apt install build-essential cmake git libbluetooth-dev libdbus-1-dev
2.2 下载项目
使用 git
克隆项目到本地:
git clone https://github.com/wcbonner/GoveeBTTempLogger.git
2.3 编译项目
进入项目目录并使用 cmake
进行编译:
cd GoveeBTTempLogger
cmake -S . -B build
cmake --build build
2.4 运行项目
编译完成后,进入 build
目录并运行生成的可执行文件:
cd build
./GoveeBTTempLogger
2.5 生成日志文件
使用 --log
选项指定日志文件的存储路径:
./GoveeBTTempLogger --log /var/log/goveebttemplogger/
2.6 生成 HTML 索引文件
使用 --index
选项生成 HTML 索引文件:
./GoveeBTTempLogger --log /var/log/goveebttemplogger/ --index index.html
3. 应用案例和最佳实践
3.1 家庭环境监测
GoveeBTTempLogger 可以用于家庭环境监测,记录室内温度和湿度变化。通过定期生成 SVG 图形文件,用户可以直观地查看环境变化趋势,及时调整空调或加湿器设置。
3.2 农业温湿度监测
在农业领域,GoveeBTTempLogger 可以用于监测温室或农田的温湿度变化。通过记录和分析数据,农民可以优化灌溉和通风系统,提高作物产量。
3.3 食品存储监测
GoveeBTTempLogger 还可以用于食品存储环境的监测,特别是肉类等易腐食品。通过记录温度变化,确保食品存储在适宜的温度范围内,防止食品变质。
4. 典型生态项目
4.1 Home Assistant
Home Assistant 是一个开源的家庭自动化平台,支持与 GoveeBTTempLogger 集成。通过将 GoveeBTTempLogger 记录的数据导入 Home Assistant,用户可以实现更智能的家庭环境控制。
4.2 Grafana
Grafana 是一个开源的数据可视化工具,支持与 GoveeBTTempLogger 集成。通过将日志数据导入 Grafana,用户可以创建更复杂的可视化仪表板,实时监控环境变化。
4.3 InfluxDB
InfluxDB 是一个开源的时间序列数据库,支持与 GoveeBTTempLogger 集成。通过将日志数据导入 InfluxDB,用户可以实现更高效的数据存储和查询,支持更复杂的分析和报警功能。