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.

Branches

Note: We are currently reorganising the emoncms branches. The master branch is now the same as 9.x.

• master - The latest and greatest developments. Potential bugs, use at your own risk! 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

Modules

Modules can be installed by downloading or git cloning into the emoncms/Modules folder. Be sure to update 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: https://github.com/emoncms

Install

• Recommended: Ubuntu / Debian Linux via git
• Raspberry Pi
  • Pre built emonSD SD-card Image
• Shared Linux Hosting
• Windows

Upgrade

• Upgrading emoncms

Data Backup

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

Development

• Community Forum
• V9 Development thread

Using Emoncms

• Home Energy Monitor
• Solar PV Monitor

Design

Documentation hosted on openenergymonitor documentation github:

• 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

Development Forum

More information

• Official site - http://emoncms.org
• OpenEnergyMonitor Forums
• OpenEnergyMonitor Labs page