mcmuller / emoncms

Core emoncms bundle: includes: input, feed, dashboard, vis

Emoncms 8

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

• Master - stable but less actively developed branch of emoncms. New features will be far and few between but testing will be more extensive.

• Extended - An extended feature set branch of emoncms for advanced users. This branch may be less stable than the master branch , pull requests are merged with light review for quick development.

• BufferedWrite - A low write version of emoncms designed for running on SD cards, this is a cut down version of emoncms supporting only the phpfina and phptimeseries feed engines (no in built feed averaging or histograms) and a reduced input processor set. Data is written to disk at spaced out intervals allowing datapoints to buffer and be written to disk in larger blocks.

Install

• Recommended: Ubuntu / Debian Linux via git
• Shared Linux Hosting
• Windows

Upgrade

• Upgrading emoncms

Backing up emoncms data

• Backup

Development

Development plan overview: Github: Emoncms development overview

EmonView: An open source python, flask, socketio, js web application for monitoring and control https://github.com/emoncms/emonview

Using emoncms

• Github: Home Energy Monitor - Second half gives an example of how to configure emoncms to show an electric use dashboard
• EmonTx v3: Quick start guide - an example of configuring the inputs of the standard (non watt hour calculating) firmware for the EmonTx v3 including My Electric dashboard configuration
• EmonTH: Quick start guide - an example of configuring emoncms EmonTH inputs and creating temperature and humidity feeds
• Blog post: An Example of configuring the new emoncms bargraph visualisation that uses accumulating watt hour data - part of the Monitoring SolarPV, Heatpump and house electric, EmonTx v2 system upgrade example
• An Example of more advanced custom dashboard setup
• A list with screenshots of available visualisations

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

• Forum post: How to build an Energy Monitoring Android App part 1
• How to build an Energy Monitoring Android App P1 - Retrieving data from a remote server such as emoncms.org
• How to build an Energy Monitoring Android App P2 - Drawing an Energy Monitoring display with java 2d canvas
• Drawing a myelectric style bar chart

More information

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

IRC

You can also join us on our IRC channel #emon on irc.freenode.net.

Developers

Emoncms is developed and has had contributions from the following people.

• Trystan Lea https://github.com/trystanlea (principal maintainer)
• Ildefonso Martínez https://github.com/ildemartinez
• Matthew Wire https://github.com/mattwire
• Baptiste Gaultier https://github.com/bgaultier
• Paul Allen https://github.com/MarsFlyer
• James Moore https://github.com/foozmeat
• Lloyda https://github.com/lloyda
• JSidrach https://github.com/JSidrach
• Jramer https://github.com/jramer
• Drsdre https://github.com/drsdre
• Dexa187 https://github.com/dexa187
• Carlos Alonso Gabizó
• PlaneteDomo https://github.com/PlaneteDomo
• Paul Reed https://github.com/Paul-Reed
• thunderace https://github.com/thunderace
• pacaj2am https://github.com/pacaj2am
• Ynyr Edwards https://github.com/ynyreds
• Jerome https://github.com/Jerome-github
• fake-name https://github.com/fake-name