readme.md

Emoncms 9

Emoncms is an open-source web application for processing, logging and visualising energy, temperature and other environmental data and is part of the OpenEnergyMonitor project.

Version 9 of emoncms has been developed by Chaveiro with a significant list of improvements, see forum thread with full change log

Requirements

• PHP (5.6 - 7 recomended)
• MYSQL (14.14 recomended)
• Apache (2.4 recomended)
• Redis OPTIONAL (2.2 - 3.0 recomended)

Install

• Ubuntu / Debian Linux via git
• Multi-platform using Docker Container
• Raspberry Pi
  • Pre built emonSD SD-card Image Download
• Shared Linux Hosting
• Windows

Modules

Modules can be installed by downloading or git cloning into the emoncms/Modules folder. Be sure to check for database updates in Administration menu after installing new modules:

• Dashboards module, required for creating, viewing and publishing dashboards:

• App Module - Application specific dashboards e.g. MyElectric, MySolar

• Config - In-browser emonhub.conf editor and emonhub.log log viewer. git clone

• Wifi Module - Wifi configuration interface designed for use on the emonPi

There are many other modules such as the event module and openbem (open source building energy modelling module) that are available, check out the Emoncms repo list

Branches

• master - The latest and greatest developments. Potential bugs, use at your own risk! All pull-requests should be made to the master branch. EmonCMS 9.x forum thread

• stable - emonPi/emonBase release branch, regularly merged from master. Slightly more tried and tested. See change log

• ARCHIVE low-write (v8.5) - Old emonpi/emonbase emoncms version (July 15 emonSD ready-to-go SD card image). Low-write mode is now available in v9.0. The low write version of emoncms is designed for running on SD cards. This is a cut down version of emoncms supports only the phpfina and phptimeseries feed engines (no in built feed averaging or histograms) and a reduced input processor set. Archived branch

Upgrade

• Upgrading emoncms

Data Backup

• Backup
• Raspberry Pi Backup / Restore Module (emonPi / emonBase)

Development

• Emoncms Community Forum
• V9 Development thread (archive)

Using Emoncms

• Home Energy Monitor
• Solar PV Monitor

Design

Note: due to ongoing development some docs may now be outdated

• Emoncms architecture
• Input processing
• Emoncms time series database development history
• Variable interval time series
• Fixed interval time series
• Fixed interval with averaging time series
• Improving write performance with buffering

Android App

Google Play

GitHub Repo

Development Forum

More information

• Cloud hosted platform - http://emoncms.org
• OpenEnergyMonitor Forums
• OpenEnergyMonitor Labs page