IoTaWatt Quick Start

« Previous step: Dashboards

Next step: Add Temperature Node(s) »

IoTaWatt Quick Start

IotaWatttm is an open-hardware 14 channel WiFi connected electric power monitor. It’s based on the ESP8266 IoT platform using MCP3208 12 bit ADCs to sample voltage and current.

iotawatt View in Shop →

This is a quick start guide, for full technical documentation see IoTaWatt GitHub repo Wiki.


  • 14 x single-phase current sense (CT) channels
  • 1 x AC VRMS Channel
  • Compatible with multiple types of CT sensors and AC-AC voltage sensor adaptor
  • Local SD card logging
  • WiFi connected to post to Emoncms
  • Sample rate: 35-40 channels per second
  • Voltage (VRMS), Power (W) and Energy (kWh) logged to local SD card - every 5s
  • On-board Real-time-clock (RTC) with battery backup
  • Web-config interface
  • Secure encrypted data connection to
  • Secure automatic OTA firmware updates
  • 5V Micro USB power supply required
  • Wall mountable
  • Open-source / hardware
  • CE certified
  • RoHs compliant


Please read the CT installation guide before installing. Your safety is your responsibility. Clip-on current sensors are non-invasive and should not have direct contact with the AC mains. However, installing the sensors will require working in close proximity to cables carrying high voltage. As a precaution, we recommend ensuring the cables are fully isolated; i.e., switch off the power prior to installing your sensors and proceed slowly with care. If you have any doubts, seek professional assistance.

Clip-on Current Sensor

The clip-on current sensor measures the current flow. IoTaWatt is compatible with a number of different sized CT sensors.

  • Clip the CT sensor around either the Live or Neutral cable
  • Connect 3.5mm jack plug into one of the CT inputs on the IoTaWatt
  • If the power reading is negative, reverse the CT sensor orientation
  • Learn more about how CT sensors work…

The clip-on CT sensors must be clipped round either the live or Neutral AC wire. Not both..

CT sensor installation

AC-AC Voltage Sensor Adapter (VT)

AC-AC adapter (also known as ‘VT’ Voltage Transformer) is used to measure AC voltage, power factor and determine direction of current flow.

Use of an AC-AC voltage sensor plug-in adapter with IoTaWatt is essential.

  • Plug the AC-AC adapter into a power outlet
  • This may require installation of a new outlet or extending an existing one
  • AC-AC adapter cable can be extended if required
  • Plug power connector into the AC socket on the IoTaWatt
  • Provides AC waveform reference for accurate Real Power measurements. Learn more about measuring voltage with AC-AC power adapter…

Note: Unlike with the emonTx, the AC-AC adapter does not power the IoTaWatt. It just provides an AC voltage reference signal. This is due to the increased power requirement of the IoTaWatt WiFi connectivity

DC 5V USB Adapter

A 5V DC power supply provides power to the IoTaWatt.

  • Plug the DC 5V USB adapter into a power outlet
  • Plug the micro-B USB connector into the IotaWatt
  • High quality minimum 1.2A power supply recommended

IoTaWatt status LED should light up to indicate power-up.

Wall Mount

IoTaWatt can be optionally wall mounted using enclosed bracket.

  • Open IoTaWatt enclosure
  • Attach ‘male’ part of wall-mount bracket to IoTaWatt
  • Re-assemble IoTawatt
  • Attach ‘female’ part of wall-mount to the wall
  • Clip IoTaWatt onto wall-mount
  • IoTawatt can easily be removed if required

CT sensor installation

Connect WiFi

It's highly recommended to connect the IoTaWatt to a local WiFi network with a web connection.

Although the IoTaWatt can run without WiFi an internet connection is required to set the real time clock is not set

  • If the device is new and has never been connected to a WiFi network, or the last used network is not available, the IoTaWatt will start up in WiFi AP (access point) mode.
  • AP mode is indicated by LED flashes RED-GREEN-GREEN
  • Using a mobile device connect to SSID iota + <unique-number>
  • The default WiFi password is IotaWatt (case sensitive)
  • After connecting to IoTaWatt AP a captive portal re-direct should display the IoTaWatt WiFi setup portal

iotawatt wifi

Note: If this page does not display automatically browse to

  • Follow on screen instructions to connect IoTaWatt to your local WiFi network.
  • Once connected, the name of the new WiFi network will be saved, and the device will continue its startup procedure.
  • If the LED begins blinking a rapid dull green, proceed to the next step Device Configuration.
  • If the device displays another three colour LED sequence, see Troubleshooting (wiki).


The IotaWatt is configured via a web-interface, see online demo at

Successful start-up will be indicated by a dull green glow on the LED. If the LED is off, or blinking a three-colour sequence, see Troubleshooting (wiki).

  • After successful start-up, you can connect to the device with your web browser
  • Connect to IoTaWatt using http://iotawatt.local
If local host-name (iotawat.local) does not work on your network, use ‘Fing’ mobile app Android iOS to scan the local network for an IoTaWatt (ESP8266, espressif) device. Alternatively local IP address be be found via router DHCP table or IoTaWatt serial output at startup (115200 baud).

iotawatt config

Note: if local hostname resolution is not supported on your network you will need to connect to IoTaWatt using its local IP address. This can be obtained this from your router DHCP table, using Fing or see IoTaWatt serial debug at start up to obtain local IP address (115200 baud)

Configure Input Sensors

AC-AC Voltage Transformer (VT)

You should have installed the device with an AC-AC voltage reference transformer plugged into the IoTaWatt via 2.1mm barrel-jack. The initial configuration has this channel pre-configured as a generic “VT” or voltage-transformer.

iotawatt status

  • Click on [0] input to edit the voltage input channel
  • Select your VT (AC-AC adapter) calibration pre-set from the drop down list
  • Click Save

iotawatt status

It’s recomended for highest accuracy that calibration is done on your specific unit. See IoTaWatt Wiki.

Configure Current Transformers (CT’s)

IoTaWatt is compatible with a number of different sized CT sensors. Pre-set calibrations are available for popular models.

  • Click on [1] to configure the first CT input channel
  • Choose calibration pre-set to match your CT model
  • Click Save

iotawatt status

Input list should now show input 0 configured as a AC voltage input and input 1 configured as a current sensor CT input.

Add additional CT’s as required:

iotawatt status

View Local Data

Real Time Status

After VT and CT inputs have been setup, check real-time readings on the Input Channel Status page.

Here is an example of a more complex setup:

iotawatt status

View historic local data

Historic data logged to internal-SD card can be viewed using Run Local Graph App

Configure Remote Emoncms Server

By default the IoTaWatt logs data to internal SD card, data can be viewed using Local Graph App.

The IoTaWatt can also post to a remote Emoncms server e.g. or emonPi etc. Posting to a remote server is recommended for backup and to enable easy remote access to view the data.

To enable remote data logging:

  • Select Setup Web Server
  • Choose Emoncms
  • Enter API KEY
  • (optional but recommended): Enter userID to enable posting using encrypted protocol (recommended)*
  • Chose which inputs to be posted remotely (default all)

iotawatt status

* Emoncms UserID can be found in the Setup > Account page of

Encrpted protocol is specific to, posting to other Emoncms sever (e.g. emonPi) can only be done using un-encrypted http.

If network connectivity is lost, data logged locally to SD card will later be bulk-uploaded to Emoncms when connectivity is restored.

Firmware Update (OTA)

IotaWatt checks the site for new software every 1hr. The update process takes less than a minute and the new firmware is authenticated with a digital signature from IotaWatt.

iotawatt status

Technical Wiki

For technical IoTaWatt documentation see IoTaWatt GitHub repo Wiki.

Open Source

IoTaWatt is fully open-source and has been designed with input from the OpenEnergyMonitor community.

IoTaWatt is designed and manufactured by Bob Lemaire @overeasy in partnership with OpenEnergyMonitor.

Next step: Add Temperature Node(s) »