XML¶

Module: smap.drivers.xml.XMLDriver

Communications: XML over file, http, or python loader

Data: whatever is exposed through the XSLT transform

XSLT is a way of applying a declarative transformation to XML documents. Sometimes you can use that to very easily convert existing XML data into sMAP feeds. There are a few sample XSLT transformation available in trunk/xslt:

Expression Driver¶

Module: smap.drivers.expr.ExprDriver

The expression driver is a way to compute ArdQuery operator expressions over new data. This gives you a way to create new “virtual” sMAP streams based on other data. The driver will create streams corresponding to the output of the query

apply _Expression_ to data before now where _Restrict_ group by _Group_

As new data arrives, it will be pushed through the expression and published as a new sMAP feed. To avoid circularity, it’s a good idea to make _Restrict_ include at least has Path and not has Metadata/Extra/Operator.

Dent PowerScout 18¶

Module: smap.drivers.dent.Dent18

Communications: Modbus over TCP

Data: 6 three-phase electric meters

Veris E30 Panel Meter¶

Module : smap.drivers.veris.VerisDriver

Communications: Modbus over TCP

Data: 42 single-phase power and energy measurements

Power Standards Lab pQube¶

Module : smap.drivers.pqube.PQubeModbus

Communications: Modbus/TCP

Data: Three phase energy, power, and quality measurements

TED 5000¶

Module : smap.drivers.ted.Ted5000Driver

Communications: HTTP/XML

UC Berkeley ACme X2¶

Module : smap.drivers.acmex2.acmex2.ACmeX2Driver

Communications: Proprietary UDP

Data: Per-device energy and power data.

Obvius Aquisuite¶

Module : smap.drivers.obvius.Driver

Communications: Proprietary XML

Device maps are stored in smap.drivers.obvius.sensordb. These map the somewhat opaque mappings present in the Aquisuite XML to nicer sMAP names. You can pick one from device type on the Aquisuite Page. Current mappings are:

PG&E GreenButton Downloader¶

Module: smap.drivers.pge + smap.drivers.xslt.XMLDriver

Communications: Web scrape + XML

PG&E makes residential smartmeter data available, but difficult to download through their webpage. You can combine a mechanized download of the xml with an XSLT transform to create a sMAP source from your PG&E data.

Here’s a full example:

[/pge-gas]
type = smap.drivers.xml.XMLDriver
Uri = python://smap.drivers.pge.update
Xslt = ~/smap-data/xslt/greenbutton.xsl
Period = 86400
Username = <username>
Password = <password>
# From = 1/1/2010
# To = 12/31/2012
Type = gas

Weather Underground¶

Module : smap.drivers.wunderground.WunderGround

Communications: XML

Data: Current conditions for the station.

NOAA Weather Forecasts¶

Module : smap.drivers.noaaforecast.NOAAForecast

Communications: XML

NWS Weather Forecasts¶

Module : smap.drivers.forecastTemp.ForecastTempDriver

Communications: XML

Vaisala WXT520¶

Module : smap.drivers.vaisala.VaisalaDriver

Communications: SDI-12 (serial) over IP

ETCOT¶

Module : smap.drivers.ercot.ErcotDriver

PJM¶

Module : smap.drivers.pjm.PJMDriver

NYISO¶

Module : smap.drivers.nyiso.NYIsoDriver

MISO¶

Module : smap.drivers.miso.MIsoDriver

Washington BPA¶

Module : smap.drivers.washingtonbpa.BPADriver

ISO NE¶

Module: smap.drivers.isone.IsoNEDriver

CA ISO¶

Module : smap.drivers.caiso.CaIsoDriver

CA ISO LMP Data¶

Module : smap.drivers.caiso_price.CaIsoPrice

HeatX Flow Meter¶

Module: smap.drivers.heatx.HeatX

Communication: Modbus over TCP

Data: Description from the Central Station Steam Co. Cadillac HEATX BTU Meter

Omega iSeries Steam Gauge¶

Module: smap.drivers.iseries.IseriesSteam

Communication: Proprietary TCP

Labjack UE9¶

Module: smap.drivers.labjack.LabjackDriver

Communicate: Labjack modbus. Requires updated Labjack firmware.

This module is configured through a python module you must write; here is an example (in a file named labjackconf.py:

BIP_5V = 0x08    # from the datasheet

def temp_cal(x):    # convert an analog reading to celsius
  return x*55.57-273.15+255.37

CONF = {
  'labjack01' : {
    'address' : '10.0.0.1',
    'rate' : 10,
    'channels' : {
    'freezer_bat_temp' : {
      'register' : 0,      # Ain0
      'unit' : 'C',
      'calibrate' : temp_cal,
      'range' : BIP_5V,
    },
    'freezer_air_temp' : {
      'register' : 2,      # Ain1
      'unit' : 'C',
      'calibrate' : lambda x: (x * 100) - 273.15,
      'range' : BIP_5V,
    },
  }
}

ReadingDB¶

Module: smap.drivers.readingdb.Driver

Data: Statistics from a readingdb database.