Emoncms 是一个开源 Web 应用程序，用于处理、记录和可视化能源、温度和其他环境数据，是 OpenEnergyMonitor 项目的一部分。
- PHP（使用 8.1.12 测试）
- MySQL 或 MariaDB（使用 10.5.15 测试）
- Apache（使用 2.4.54 测试）
- Redis*（使用 6.0.16 测试）
*建议使用 Redis，因为它可以减少磁盘写入次数，从而延长磁盘寿命（尤其是在 SD 卡上，例如 Raspberry Pi）。某些输入处理器还需要 Redis，如果未安装 Redis，则会默默地失败。某些环境（例如共享托管或我们尝试过的 Windows 服务器）不支持 Redis，因此 Emoncms 有一个回退模式，允许在没有 Redis 的情况下进行核心操作。
查看 Emoncms 文档： https: //docs.openenergymonitor.org/emoncms
- 开始使用 emonPi/Base
- 开始使用 emoncms.org
- Emoncms 核心概念
- 发布数据
- MQTT
- 查看图表
- 仪表板生成器
- 应用程序仪表板
- 八达通敏捷应用程序
- 计算每日千瓦时
- 计算平均值
- 脉冲计数
- 导出 CSV
- 直方图
- 后处理模块
- 需求塑造模块
- 导入/备份
- 更新与升级
- 远程访问
- 故障排除
设计
Emoncms时间序列数据库设计（提要存储）
其他
Emoncms术语
- 输入：传入的数据源。每个输入都有一个关联的“节点”标识符和一个“键”子标识符。输入是入口点，仅记录输入的最后一个值和时间。要记录历史数据，需要根据输入创建提要。
- 输入：节点：输入或提要的分组标识符。
- 输入： 键：每个节点内项目的子标识符。
- 输入进程列表（或输入处理）：在每个输入值上接收到该输入值时按顺序执行的进程*列表。
- 进程：可以附加到输入的进程列表以更改值或将值保存到 feed* 的函数。
- Feed：记录数据的地方，数据点的时间序列。Emoncms 使用的标准时间序列数据库是 PHPFina 和 PHPTimeSeries，它们是作为 Emoncms 项目的一部分编写的。
- 有关 Emoncms 中每个输入进程的作用的说明，请参阅 Emoncms 输入处理配置界面中的帮助说明。
Emoncms.org API 参考
Emoncms 经过设计和测试，可在 Ubuntu Linux（本地、专用计算机或 VPS）或 RaspberryPi 操作系统上运行。它应该可以在其他 Debian Linux 系统上运行，尽管我们没有测试或提供这些系统上的安装文档。
我们不建议也无法支持在共享主机或 XAMPP 服务器上安装，特别是共享主机没有运行 emoncms 使用的某些脚本的功能或功能有限。现在有多种低成本微型 Linux VPS 托管解决方案可供选择，它们以相似的成本提供更好的安装环境。
受到推崇的：
实验性（当前不是最新的）：
可以通过下载或 git 克隆到 emoncms/Modules 文件夹来安装模块。安装新模块后，请务必在“管理”菜单中检查数据库更新。emonSD 映像中包含以下核心模块：
-
图形模块- 与 emoncms feed list 集成的高级图形模块，强烈推荐；使用示例可以在 emoncms 指南[1] [2] [3] [4]中找到。
-
设备模块- 使用设备模板自动配置输入和源。
-
仪表板模块- 创建、查看和发布仪表板所需的。
-
应用程序模块- 应用程序特定的仪表板，例如 MyElectric、MySolar。
-
配置- 浏览器内 emonhub.conf 编辑器和 emonhub.log 日志查看器。用于
git clone安装。 -
Raspberry Pi 备份/恢复模块(emonPi / emonBase)
-
Usefulscripts：严格来说不是一个模块，更多的是与 emoncms 一起使用的有用脚本的集合。
-
DemandShaper 模块- 安排智能插头、EmonEVSE 智能电动汽车充电器、热泵在以下方面的最佳时间运行：碳、成本、电网压力。基于日前的预测。
还有许多其他可用的模块，例如事件模块和 openbem（开源建筑能源建模模块）：查看Emoncms 存储库列表。
-
master - 最新、最伟大的进展。潜在错误，使用风险自负！所有拉取请求都应向主分支发出。
-
stable - emonPi/emonBase 发布分支，定期从 master 合并。经过更多尝试和测试。请参阅发布变更日志。
- PHPFina 数据文件查看器- 直接轻松浏览 phpfina timeseries feed 引擎数据文件，无需完整安装 Emoncms。对于检查备份和存档数据很有用。