Getting started

Set up an OpenEnergyMonitor system

The OpenEnergyMonitor system comprises wireless sensor nodes that send data at periodic intervals to a web-connected base-station.

Application Specific Guides (advanced)

At present, it's possible to sense: AC Electricity (apparent  / real power, current, RMS voltage), Temperature, Humidity, Pulses (from pulse output utility meters), Elster IrDA (direct utility meter interface) and PV system power diversion. We and others, are working on extending this list to include moisture, CO2 and other air quality measurements.

This guide lists the steps to set up a basic system. You will need a base station and at least one sensor node to get it running. Read the entire article to determine what hardware you will need.

1) Set up your base station

It's best to start by setting up the base-station so you'll be ready to receive data from new sensor nodes as you add them.

There are two Base station choices:

Option 1: emonBase - Raspberry Pi + RFM69Pi RF adapter





Option 2: emonPi - Raspberry Pi based energy monitoring node 


Both base stations use the same pre-built SD card (as of June 2015) and run the same software. 

Both can receive data from wireless nodes (e.g emonTx / emonTH)

Both can log data locally to the Raspberry Pi's SD card and post data to a remote server such as

The difference with the emonPi is that it can perform energy and temperature monitoring functions and has a compact enclosure and LC display. 

See this blog post comparing the emonPi and emonTx V3

>>> emonBase / emonPi Setup Guide <<<

Note: If you purchased your emonBase or pre-built ready-to-go SD card prior to 17th June 2015, you have an older emonSD image. We recommend you download the latest image, flash it to the SD card, then follow the above guide. 

2) Choose the wireless nodes you want to use:

a) emonTx - Electrical Energy Monitoring 

The multi purpose, open hardware emonTx can measure:

  • 4x AC single-phase circuits with clip on CT sensors.
  • Or one 3-phase circuit
  • 1x AC Voltage, with an AC-AC Voltage adapter for isolation.
  • 6x Temperatures via 1-wire DS18B20 sensors.
  • 1x Pulse counting input for pulse output meters 

Up to 30 emonTx's can be connected to a single emonBase.
Each emonTx will need a unique wireless node ID.

If you already own an Arduino, you may want to consider using an emonTx Shield.

Select the correct guide for the emonTx version that you have:

See Part 3 for instructions to configure emoncms to log, process and display the monitored data.

b) emonTH - Temperature and Humidity Monitoring

Battery powered temperature (internal / external) and humidity (internal) monitoring node


c) emonGLCD - wireless LCD display (discontinued)

The emonGLCD is an open-source general purpose wireless graphical LCD unit that can be added to the system like any other node. 

It can be configured to show anything you'd like to display from power consumption and generation, to room temperature. It has two indicator LEDs that glow red or green depending on whether you're importing or exporting energy. The emonGLCD has a built in temperature sensor and can transmit the current room temperature back to the base station for logging to emoncms. 

The emonGLCD is especially useful for providing real-time at-a-glance information. 

emonGLCD Documentation Page

Build an emonGLCD

Upload emonGLCD Arduino Firmware


3) Configure Emoncms to log, process and display monitored data

Now that the sensor node data values are registered in the emoncms inputs list, the next step is to set up processing on those inputs. Input processing enables you to manipulate your input data before storing it in the emoncms database.

Check: The RFM69Pi LED should flash each time an RF packet is received.

Emoncms setup examples:

​4) FAQ

Still have questions? See our FAQ, or post on the forums