项目简介
本项目提供基于ESP8266 WiFi模块的感应式电能表(Ferraris电表)能量监测器的固件和原理图。借助ELV传感器ES - Fer,可将传感器数据通过WiFi和HTTP RESTful API传输,适用于多种场景,不限于HomeMatic生态系统,还能在Node - Red中使用。
项目的主要特性和功能
REST - API
提供RESTful HTTP接口,返回所有数据的JSON对象。API描述遵循OpenAPI 2.0格式,位于api
文件夹。推荐用Swagger Editor查看文档并生成客户端代码。主要路径和方法如下:
- /info
:获取板卡和系统状态信息。
- /meters
:获取电能表信息。
- /meters/{idMeter}
:获取特定电能表的信息。
- /meters/{idMeter}/counters
:获取电能表的计数器信息。
- /meters/{idMeter}/counters/{idCounter}
:获取特定电能表的特定计数器的信息。
- /meters/{idMeter}/counters/{idCounter}/kWh
:获取或设置计数器的千瓦时数据。
- /meters/{idMeter}/counters/{idCounter}/revolutions
:获取或设置能量表转盘转速信息。
- /meters/{idMeter}/revsPerKWh
:获取或设置每千瓦时转速数。
- /meters/{idMeter}/threshold
:获取或设置能量表传感器的阈值。
硬件
hardware
文件夹提供fritzing原理图,展示引脚布局,还有实物图及女性rj11连接器的引脚定义。
固件
构建Arduino草图步骤:
1. 安装Arduino IDE。
2. 在Arduino IDE中安装ESP8266工具链和ArduinoJSON库。
3. 打开草图并修改config.h
头文件中的设置,包括WiFi网络的SSID和密码。
4. 编译并下载到NodeMcu板卡。
安装使用步骤
- 已下载本项目的源码文件。
- 若未安装Arduino IDE,下载并安装。
- 在Arduino IDE中,通过“工具” -> “开发板” -> “开发板管理器”安装ESP8266工具链。
- 通过“工具” -> “管理库”安装ArduinoJSON库。
- 打开
config.h
文件,设置WiFi网络的SSID和密码。 - 在Arduino IDE中打开项目的主草图文件,编译并上传到ESP8266设备。
- 按照
hardware
文件夹中的原理图连接硬件。 - 使用浏览器或API客户端工具访问设备的IP地址,开始使用RESTful API。
下载地址
点击下载 【提取码: 4003】【解压密码: www.makuang.net】