mbmd 开源项目使用教程
1. 项目介绍
mbmd 是一个用于从智能电表和电网逆变器收集测量数据的守护进程。它通过 Modbus 接口与这些设备进行通信,并提供 HTTP 接口来访问这些设备的读数。mbmd 支持 Modbus RTU 和 Modbus TCP 通信,并且可以将数据通过 REST API 和 MQTT 暴露出来。mbmd 最初由 Mathias Dalheimer 开发,原名为 gosdm。
2. 项目快速启动
2.1 安装
2.1.1 使用预编译二进制文件
从 mbmd GitHub 发布页面 下载适合您平台的预编译二进制文件,并解压缩。
2.1.2 从源码构建
mbmd 使用 Go 语言开发,需要 Go 1.16 或更高版本。构建步骤如下:
# 安装构建工具
make install
# 构建 mbmd 二进制文件
make build
如果您需要为不同的架构(例如 Raspberry Pi)构建,可以使用以下命令:
GOOS=linux GOARCH=arm GOARM=5 make build
2.2 运行
运行 mbmd 时,可以使用 -h
选项查看所有命令行选项。以下是一个典型的启动命令:
mbmd run -a /dev/ttyUSB0 -u 0:8080 -d sdm:1
2.3 使用 Docker 运行
您也可以使用 Docker 运行 mbmd:
docker run -p 8080:8080 --device=/dev/ttyUSB0 volkszaehler/mbmd run -a /dev/ttyUSB0 -u 0:8080 -d sdm:1
3. 应用案例和最佳实践
3.1 家庭能源监控
mbmd 可以用于家庭能源监控系统,通过连接智能电表和电网逆变器,实时监控家庭用电情况。用户可以通过 REST API 或 MQTT 获取实时数据,并将其集成到家庭自动化系统中。
3.2 工业能源管理
在工业环境中,mbmd 可以用于监控和管理多个电表和逆变器。通过集中管理这些设备,企业可以更好地控制能源消耗,优化生产流程。
4. 典型生态项目
4.1 Home Assistant
Home Assistant 是一个开源的家庭自动化平台,支持通过 MQTT 协议与 mbmd 集成。用户可以将 mbmd 收集的能源数据集成到 Home Assistant 中,实现更智能的家庭能源管理。
4.2 Grafana
Grafana 是一个开源的数据可视化工具,支持通过 REST API 获取 mbmd 的数据。用户可以将 mbmd 的数据导入 Grafana,创建实时监控仪表板,以便更好地分析和展示能源使用情况。
通过以上步骤,您可以快速上手 mbmd 项目,并将其应用于各种能源监控和管理场景中。