-
Notifications
You must be signed in to change notification settings - Fork 0
IEC 62056 21 Meter Binding
Documentation of the IEC 62056-21 meter binding bundle
This binding is used to communicate to metering devices supporting serial communication according IEC 62056-21 mode C master. It can be used to read metering data from slaves such as gas, water, heat, or electricity meters. For further information read Wiki page of IEC 62056-21.
Information receive from the meter device are structured according IEC 62056-6-1:2013, Object identification system (OBIS). For further information read Wiki page of OBIS ("Object Identification System").
For installation of the binding, please see Wiki page Bindings.
The openhab.cfg file (in the folder '${openhab_home}/configurations') contain following config parameters to configure the binding. The configuration allows the definition of multiple meter devices.
######################### IEC 620562-21 Meter Binding ####################
# the serial port to use for connecting to the metering device e.g. COM1 for Windows and /dev/ttyS0 or
# /dev/ttyUSB0 for Linux
iec6205621meter:<meter-id1>.serialPort=/dev/ttyS0
# Delay of baud rate change in ms. Default is 0. USB to serial converters often require a delay of up to 250ms
# default is 0ms
iec6205621meter:<meter-id1>.baudRateChangeDelay=0
# Enable handling of echos caused by some optical tranceivers
# default is true
iec6205621meter:<meter-id1>.echoHandling=true
# Perform a module status query every x seconds (optional, defaults to 600 (10 minutes)).
iec6205621meter:refresh=60
NOTE: the <meter-id1>
will be used in both the binding item configs and the action calls to defined which of your meter devices is connected to the item.
In order to bind an item to the data received from the meter device , you need to provide item configuration settings. The easiest way to do so is to add some binding information in your item file (in the folder configurations/items`). The syntax of the binding configuration strings accepted is the following: The syntax of an item configuration is shown in the following line in general:
iec6205621meter="<meter-id>:<OBIS>"
Where meter-id matches one of the ids defined in your openhab.cfg file.
If you do not know the available OBIS on your meter device you propably find them on the local HMI of you meter device. Please review you manual of the meter device or read the instruction of your utility. You can also start openhab in debug mode, the binding will then dump all available OBIS it receives from the meter device in the osgi console.
Below is an example of represent the current energy counter tarif values as numeric items.
/* IEC 62056-21 Meter data */
Number Tarif_Period "Chart Period"
Number Tarif1 "High price tarif [%d kwh]" (gEnergy) { iec6205621meter="meter1:1.8.1" }
Number Tarif2 "Low price tarif [%d kwh]" (gEnergy) { iec6205621meter="meter1:1.8.2" }
Number ActualEnergyConsumption "Actual energy consumption [%.2f KW]" <gEnergy> () { iec6205621meter="meter1:16.7" }
In order to calculate the daily accumulated energy consumption below item and script will allow you to present a chart in your sitemap. First create the necessary items:
Number Tarif1Today "Daily Consumption High Price" (gEnergieConsumption)
Number Tarif2Today "Daily Consumption Low Price" (gEnergieConsumption)
Second add below script to your rules:
rule "Energy chart"
when
Item Tarif1 changed or
Item Tarif2 changed
then
var Number tmp
var Number stopTarif1
var Number stopTarif2
var Number startTarif1
var Number startTarif2
if (Tarif1.state instanceof DecimalType && Tarif2.state instanceof DecimalType) {
stopTarif1 = Tarif1.maximumSince(now.toDateMidnight).state as DecimalType
stopTarif2 = Tarif2.maximumSince(now.toDateMidnight).state as DecimalType
//Today
startTarif1 = Tarif1.minimumSince(now.toDateMidnight).state as DecimalType
startTarif2 = Tarif2.minimumSince(now.toDateMidnight).state as DecimalType
tmp = stopTarif1 - startTarif1
postUpdate(Tarif1Today, tmp)
tmp = stopTarif2 - startTarif2
postUpdate(Tarif2Today, tmp)
}
end
Third add below Frame to your sitemap:
Frame label="Energie" {
Text item=Tarif1 icon="energy" {
Frame {
Text item=Tarif1
Text item=Tarif2
Chart item=gEnergieConsumption period=D refresh=600
Chart item=gEnergieConsumption period=W refresh=3600
}
Text item=ActualEnergyConsumption icon="energy" {
Frame {
Text item=ActualEnergyConsumption
Switch item=ActualEnergyConsumption_Chart_Perdiod label="Period" mappings=[0="Hour", 1="Day", 2="Week"]
Chart item=ActualEnergyConsumption period=h visibility=[ActualEnergyConsumption_Period==0, ActualUsage_Chart_Period==Uninitialized ]
Chart item=ActualEnergyConsumption period=D visibility=[ActualEnergyConsumption_Chart_Period==1]
Chart item=ActualEnergyConsumption period=W visibility=[ActualEnergyConsumption_Chart_Period==2]
}
}
}
The binding has been successfully tested with below hardware configuration:
- Landis & Gyr meter ZMD120AR connected with IR-Reader RS232 from open hardware project in volkszaehler
- Landis & Gyr meter E350 connected with IR-Reader RS232 from open hardware project in volkszaehler
- Landis & Gyr meter connected the IR-Reader USB from open hardware project in volkszaehler
###Linux / OS X
###Windows
- Cosm Persistence
- db4o Persistence
- Exec Persistence
- InfluxDB Persistence
- JDBC Persistence
- JPA Persistence
- Logging Persistence
- mapdb Persistence
- MongoDB Persistence
- MQTT Persistence
- my.openHAB Persistence
- MySQL Persistence
- rrd4j Persistence
- Sen.Se Persistence
- SiteWhere Persistence
- AlarmDecoder Binding
- Anel Binding
- Arduino SmartHome Souliss Binding
- Asterisk Binding
- Astro Binding
- Autelis Pool Control Binding
- BenQ Projector Binding
- Bluetooth Binding
- Bticino Binding
- CalDAV Binding
- Comfo Air Binding
- Config Admin Binding
- CUL Binding
- CUL Intertechno Binding
- CUPS Binding
- DAIKIN Binding
- Davis Binding
- Denon Binding
- digitalSTROM Binding
- DMX512 Binding
- DSC Alarm Binding
- DSMR Binding
- eBUS Binding
- Ecobee Binding
- EDS OWSever Binding
- eKey Binding
- Energenie Binding
- EnOcean Binding
- Enphase Energy Binding
- Epson Projector Binding
- Exec Binding
- Freebox Binding
- Freeswitch Binding
- Frontier Silicon Radio Binding
- Fritz AHA Binding
- Fritz!Box Binding
- FS20 Binding
- Global Cache IR Binding
- GPIO Binding
- HAI/Leviton OmniLink Binding
- HDAnywhere Binding
- Heatmiser Binding
- Homematic / Homegear Binding
- HTTP Binding
- IEC 62056-21 Binding
- IHC / ELKO Binding
- ImperiHome Binding
- Insteon Hub Binding
- Insteon PLM Binding
- IPX800 Binding
- IRtrans Binding
- jointSPACE-Binding
- KNX Binding
- Koubachi Binding
- LCN Binding
- LightwaveRF Binding
- Leviton/HAI Omnilink Binding
- Lg TV Binding
- Logitech Harmony Hub
- MailControl Binding
- MAX!Cube-Binding
- MAX! CUL Binding
- MiLight Binding
- MiOS Binding
- Modbus TCP Binding
- MPD Binding
- MQTT Binding
- MQTTitude binding
- Neohub Binding
- Nest Binding
- Netatmo Binding
- Network Health Binding
- Network UPS Tools Binding
- Nibe Heatpump Binding
- Nikobus Binding
- Novelan/Luxtronic Heatpump Binding
- NTP Binding
- One-Wire Binding
- Onkyo AV Receiver Binding
- Open Energy Monitor Binding
- OpenPaths presence detection binding
- OpenSprinkler Binding
- OSGi Configuration Admin Binding
- Panasonic TV Bindung
- panStamp Binding
- Philips Hue Binding
- Piface Binding
- pilight Binding
- Pioneer-AVR-Binding
- Plex Binding
- Plugwise Binding
- PLCBus Binding
- Primare Binding
- Pulseaudio Binding
- RFXCOM Binding
- RWE Smarthome Binding
- Sager WeatherCaster Binding
- Samsung AC Binding
- Samsung TV Binding
- Serial Binding
- Sallegra Binding
- Satel Alarm Binding
- Sinthesi Sapp Binding
- Snmp Binding
- Somfy URTSI II Binding
- Sonos Binding
- Squeezebox Binding
- Swegon ventilation Binding
- System Info Binding
- TA CMI Binding
- TCP/UDP Binding
- Tellstick Binding
- TinkerForge Binding
- Tivo Binding
- VDR Binding
- Velleman-K8055-Binding
- Wago Binding
- Wake-on-LAN Binding
- Waterkotte EcoTouch Heatpump Binding
- Weather Binding
- Wemo Binding
- Withings Binding
- XBMC Binding
- xPL Binding
- Yamahareceiver Binding
- Zibase Binding
- Z-Wave Binding
- Asterisk
- Google Calendar
- Linux Media Players
- ROS Robot Operating System
- Telldus Tellstick
- Zoneminder
- Wink Hub (rooted)
- Wink Monitoring
- Transformations
- XSLT
- JSON
- REST-API
- Security
- Service Discovery
- Voice Control
- BritishGasHive-Using-Ruby
- Dropbox Bundle
A good source of inspiration and tips from users gathered over the years. Be aware that things may have changed since they were written and some examples might not work correctly.
Please update the wiki if you do come across any out of date information.
- Comfo Air Binding
- Ecobee Examples
- Nest Examples
- Rollershutter Bindings
- Squeezebox
- WAC Binding
- WebSolarLog
- Alarm Clock
- Convert Farenheit to Celcius
- The mother of all lighting rules
- Reusable Rules via Functions
- Combining different Items
- Items, Rules and more Examples of a SmartHome
- Google Map
- Controlling openHAB with Android
- Usecase examples
- B-Control Manager
- Spell checking for foreign languages
- Flic via Tasker
- Chromecast via castnow