Skip to content

Latest commit

 

History

History
81 lines (42 loc) · 3.25 KB

README.md

File metadata and controls

81 lines (42 loc) · 3.25 KB

Emoncms Device module

3.png

  • Auto-configuration of inputs and feeds from pre-defined device templates
  • Device templates available for all standard OpenEnergyMonitor hardware units
  • Device level access keys

Original author: Chaveiro Contributions from: Trystan Lea, Adminde

Installation

The following steps document the installation of the device module on a stock emonpi/emonbase running the latest emonSD image.

After logging in via SSH, place the pi in write mode:

rpi-rw

Navigate to the emoncms Modules folder:

cd /var/www/emoncms/Modules

Clone the device module into the modules folder using git:

git clone https://github.com/emoncms/device.git

Login to emoncms on your emonpi/emonbase, navigate to Setup > Administration, Update the emoncms database by running 'Update & Check' under the Update database section.

Using the device module

Auto-configration

One of the useful features of the device module is automatic configuration of inputs and feeds according to pre-defined device templates.

The following is an example of automatic configuration of an emonpi for use as a Type 1 Solar PV monitor.

With the EmonPi and CT sensors connected up the emoncms inputs list running on the EmonPi should show a list of inputs like so:

1.png

These are unconfigured at this point and no data is being recorded. The manual setup for a Type 1 Solar PV setup is documented here OpenEnergyMonitor Guide: SolarPV, but we are going to use the device module here to automatically setup the inputs and feeds.

Navigate to the device module, click on Setup > Device Setup, which should bring up the following page:

2.png

Click on 'New device', this will bring up the 'Configure Device' window. The left-hand pane lists the device templates available.

Click on OpenEnergyMonitor > EmonPi > Solar PV Type 1 to select this template.

Enter the nodename emonpi in both the 'Node' and 'Name' fields, set a location as you wish or leave blank.

Click save to continue.

3.png

When a new device is created, it will automatically be initialized and all input processes and feeds will be created, according to the pre-defined template. If the template needs to be applied again, as e.g. a process list was experimented on and altered, or single feeds deleted, it may be re-initialized. Clicking the cycling arrows 'refresh icon' will bring up the initialization window.

4.png

Click 'Initialize' to re-initialize the device and to confirm the creation of missing feeds and inputs, as well as the reset of configured processes to their original state.

5.png

The input list will now show the input processes created:

6.png

and the feeds page the feeds created:

7.png

Development

After updating a device template redis redis must be updated reload the templates to make the changes visable:

http://emonpi/device/template/reload.json

See: Development: Devices, Inputs and Feeds in emoncms