]> git.basschouten.com Git - openhab-addons.git/commitdiff
Rename README.MD to README.md
authorKai Kreuzer <kai@openhab.org>
Fri, 2 Apr 2021 08:46:26 +0000 (10:46 +0200)
committerGitHub <noreply@github.com>
Fri, 2 Apr 2021 08:46:26 +0000 (10:46 +0200)
bundles/org.openhab.binding.mecmeter/README.MD [deleted file]
bundles/org.openhab.binding.mecmeter/README.md [new file with mode: 0644]

diff --git a/bundles/org.openhab.binding.mecmeter/README.MD b/bundles/org.openhab.binding.mecmeter/README.MD
deleted file mode 100644 (file)
index aa8f2f8..0000000
+++ /dev/null
@@ -1,247 +0,0 @@
-# MecMeter Binding
-
-This binding reads data from MEC power meter for providing electrical information for the electric circuit.
-
-To use this binding the meter must be installed, initialized and connected to the same network as openHAB. 
-
-## Supported Things
-
-The mecMeter is supported with firmware version starting from 2.0.0.
-There is exactly one supported thing type `meter`, which represents the electric meter.
-Its unique ID is the serial number.
-
-## Discovery
-
-MecMeters are automatically discovered via mDNS. 
-The IP of the Power Meter is automatically set and can be changed manually if needed.
-The default update interval is set to 5 seconds. Intervals from 1 to 300 seconds can be set manually.
-
-## Thing Configuration
-
-The thing has a few configuration parameters:  
-
-| Parameter       | Description                                                           |
-|-----------------|-----------------------------------------------------------------------|
-| password        | User-defined password during initializing the Power Meter. Mandatory. |
-| ip              | The IP address of the meter. Mandatory.                               |
-| refreshInterval | Refresh interval in second. Optional, the default value is 5 seconds. |
-
-       
-## Channels
-
-The meter has the following channels: 
-
-| Channel Type ID                                              | Item Type                | Label                             | Description                              |
-|--------------------------------------------------------------|--------------------------|-----------------------------------|------------------------------------------|
-| general_group#frequency                                      | Number:Frequency         | Main Frequency                    | Frequency in Hertz                       |
-| general_group#temperature                                    | Number:Temperature       | Internal Temperature              | Internal Temperature of the energy meter |
-| general_group#op_time                                        | Number:Time              | Time in Operation                 | Time in Operation                        |
-| voltage_group#voltage_phase1                                 | Number:ElectricPotential | Voltage P1                        | Voltage in Volt                          |
-| voltage_group#voltage_phase2                                 | Number:ElectricPotential | Voltage P2                        | Voltage in Volt                          |
-| voltage_group#voltage_phase3                                 | Number:ElectricPotential | Voltage P3                        | Voltage in Volt                          |
-| voltage_group#avg_phase_phase_voltage                        | Number:ElectricPotential | Average Phase – Phase Voltage     | Average Phase – Phase Voltage in Volt    |
-| voltage_group#avg_neutral_phase_voltage                      | Number:ElectricPotential | Average Voltage                   | Average N – Phase Voltage in Volt        |
-| current_group#current_allphase                               | Number:ElectricCurrent   | Current                           | Current in Ampere                        |
-| current_group#current_phase1                                 | Number:ElectricCurrent   | Current P1                        | Current in Ampere                        |
-| current_group#current_phase2                                 | Number:ElectricCurrent   | Current P2                        | Current in Ampere                        |
-| current_group#current_phase3                                 | Number:ElectricCurrent   | Current P3                        | Current in Ampere                        |
-| angle_group#phase_angle_currvolt_phase1                      | Number:Angle             | Current P1                        | Angle Current to Voltage in Degree       |
-| angle_group#phase_angle_currvolt_phase2                      | Number:Angle             | Current P2                        | Angle Current to Voltage in Degree       |
-| angle_group#phase_angle_currvolt_phase3                      | Number:Angle             | Current P3                        | Angle Current to Voltage in Degree       |
-| angle_group#phase_angle_phase1-3                             | Number:Angle             | Angle Voltage to Voltage          | Angle Voltage to Voltage in Degree       |
-| angle_group#phase_angle_phase2-3                             | Number:Angle             | Angle Voltage to Voltage          | Angle Voltage to Voltage in Degree       |
-| activepower_group#activepower_allphase                       | Number:Power             | Active Power                      | Active power consumed                    |
-| activepower_group#activepower_phase1                         | Number:Power             | Active Power P1                   | Active power consumed                    |
-| activepower_group#activepower_phase2                         | Number:Power             | Active Power P2                   | Active power consumed                    |
-| activepower_group#activepower_phase3                         | Number:Power             | Active Power P3                   | Active power consumed                    |
-| activefundpower_group#activefundpower_allphase               | Number:Power             | Active Fundamental Power          | Active fundamental power                 |
-| activefundpower_group#activefundpower_phase1                 | Number:Power             | Active Fund Power P1              | Active fundamental power                 |
-| activefundpower_group#activefundpower_phase2                 | Number:Power             | Active Fund Power P2              | Active fundamental power                 |
-| activefundpower_group#activefundpower_phase3                 | Number:Power             | Active Fund Power P3              | Active fundamental power                 |
-| activeharmpower_group#activeharmpower_allphase               | Number:Power             | Active Harmonic Power             | Active harmonic power                    |
-| activeharmpower_group#activeharmpower_phase1                 | Number:Power             | Active Harm Power P1              | Active harmonic power                    |
-| activeharmpower_group#activeharmpower_phase2                 | Number:Power             | Active Harm Power P2              | Active harmonic power                    |
-| activeharmpower_group#activeharmpower_phase3                 | Number:Power             | Active Harm Power P3              | Active harmonic power                    |
-| reactivepower_group#reactivepower_allphase                   | Number:Power             | Reactive Power                    | Reactive power consumed                  |
-| reactivepower_group#reactivepower_phase1                     | Number:Power             | Reactive Power P1                 | Reactive power consumed                  |
-| reactivepower_group#reactivepower_phase2                     | Number:Power             | Reactive Power P2                 | Reactive power consumed                  |
-| reactivepower_group#reactivepower_phase3                     | Number:Power             | Reactive Power P3                 | Reactive power consumed                  |
-| powerfactor_group#powerFactor_allphase                       | Number:Dimensionless     | Power Factor                      | Power Factor                             |
-| powerfactor_group#powerFactor_phase1                         | Number:Dimensionless     | Power Factor P1                   | Power Factor                             |
-| powerfactor_group#powerFactor_phase2                         | Number:Dimensionless     | Power Factor P2                   | Power Factor                             |
-| powerfactor_group#powerFactor_phase3                         | Number:Dimensionless     | Power Factor P3                   | Power Factor                             |
-| apppower_group#apppower_allphase                             | Number:Power             | Apparent Power                    | Apparent power consumed                  |
-| apppower_group#apppower_phase1                               | Number:Power             | Apparent Power P1                 | Apparent power consumed                  |
-| apppower_group#apppower_phase2                               | Number:Power             | Apparent Power P2                 | Apparent power consumed                  |
-| apppower_group#apppower_phase3                               | Number:Power             | Apparent Power P3                 | Apparent power consumed                  |
-| fwd_active_energy_group#fwd_active_energy_allphase           | Number:Energy            | Forward Active Energy             | Forward Active Energy in kWh             |
-| fwd_active_energy_group#fwd_active_energy_phase1             | Number:Energy            | Fwd Active Energy P1              | Forward Active Energy in kWh             |
-| fwd_active_energy_group#fwd_active_energy_phase2             | Number:Energy            | Fwd Active Energy P2              | Forward Active Energy in kWh             |
-| fwd_active_energy_group#fwd_active_energy_phase3             | Number:Energy            | Fwd Active Energy P3              | Forward Active Energy in kWh             |
-| fwd_active_fund_energy_group#fwd_active_fund_energy_allphase | Number:Energy            | Forward Active Fundamental Energy | Forward Active Fundamental Energy in kWh |
-| fwd_active_fund_energy_group#fwd_active_fund_energy_phase1   | Number:Energy            | Fwd Active Fund Energy P1         | Forward Active Fundamental Energy in kWh |
-| fwd_active_fund_energy_group#fwd_active_fund_energy_phase2   | Number:Energy            | Fwd Active Fund Energy P2         | Forward Active Fundamental Energy in kWh |
-| fwd_active_fund_energy_group#fwd_active_fund_energy_phase3   | Number:Energy            | Fwd Active Fund Energy P3         | Forward Active Fundamental Energy in kWh |
-| fwd_active_harm_energy_group#fwd_active_harm_energy_allphase | Number:Energy            | Forward Active Harmonic Energy    | Forward Active Harmonic Energy in kWh    |
-| fwd_active_harm_energy_group#fwd_active_harm_energy_phase1   | Number:Energy            | Fwd Active Harm Energy P1         | Forward Active Harmonic Energy in kWh    |
-| fwd_active_harm_energy_group#fwd_active_harm_energy_phase2   | Number:Energy            | Fwd Active Harm Energy P2         | Forward Active Harmonic Energy in kWh    |
-| fwd_active_harm_energy_group#fwd_active_harm_energy_phase3   | Number:Energy            | Fwd Active Harm Energy P3         | Forward Active Harmonic Energy in kWh    |
-| fwd_reactive_energy_group#fwd_reactive_energy_allphase       | Number:Energy            | Forward Reactive Energy           | Forward Reactive Energy in VArh          |
-| fwd_reactive_energy_group#fwd_reactive_energy_phase1         | Number:Energy            | Fwd Reactive Energy P1            | Forward Reactive Energy in VArh          |
-| fwd_reactive_energy_group#fwd_reactive_energy_phase2         | Number:Energy            | Fwd Reactive Energy P2            | Forward Reactive Energy in VArh          |
-| fwd_reactive_energy_group#fwd_reactive_energy_phase3         | Number:Energy            | Fwd Reactive Energy P3            | Forward Reactive Energy in VArh          |
-| rev_active_energy_group#rev_active_energy_allphase           | Number:Energy            | Reverse Active Energy             | Reverse Active Energy in kWh             |
-| rev_active_energy_group#rev_active_energy_phase1             | Number:Energy            | Rev Active Energy P1              | Reverse Active Energy in kWh             |
-| rev_active_energy_group#rev_active_energy_phase2             | Number:Energy            | Rev Active Energy P2              | Reverse Active Energy in kWh             |
-| rev_active_energy_group#rev_active_energy_phase3             | Number:Energy            | Rev Active Energy P3              | Reverse Active Energy in kWh             |
-| rev_active_fund_energy_group#rev_active_fund_energy_allphase | Number:Energy            | Reverse Active Fundamental Energy | Reverse Active Fundamental Energy in kWh |
-| rev_active_fund_energy_group#rev_active_fund_energy_phase1   | Number:Energy            | Rev Active Fund Energy P1         | Reverse Active Fundamental Energy in kWh |
-| rev_active_fund_energy_group#rev_active_fund_energy_phase2   | Number:Energy            | Rev Active Fund Energy P2         | Reverse Active Fundamental Energy in kWh |
-| rev_active_fund_energy_group#rev_active_fund_energy_phase3   | Number:Energy            | Rev Active Fund Energy P3         | Reverse Active Fundamental Energy in kWh |
-| rev_active_harm_energy_group#rev_active_harm_energy_allphase | Number:Energy            | Reverse Active Harmonic Energy    | Reverse Active Harmonic Energy in kWh    |
-| rev_active_harm_energy_group#rev_active_harm_energy_phase1   | Number:Energy            | Rev Active Harm Energy P1         | Reverse Active Harmonic Energy in kWh    |
-| rev_active_harm_energy_group#rev_active_harm_energy_phase2   | Number:Energy            | Rev Active Harm Energy P2         | Reverse Active Harmonic Energy in kWh    |
-| rev_active_harm_energy_group#rev_active_harm_energy_phase3   | Number:Energy            | Rev Active Harm Energy P3         | Reverse Active Harmonic Energy in kWh    |
-| rev_reactive_energy_group#rev_reactive_energy_allphase       | Number:Energy            | Reverse Reactive Energy           | Reverse Reactive Energy in VArh          |
-| rev_reactive_energy_group#rev_reactive_energy_phase1         | Number:Energy            | Rev Reactive Energy P1            | Reverse Reactive Energy in VArh          |
-| rev_reactive_energy_group#rev_reactive_energy_phase2         | Number:Energy            | Rev Reactive Energy P2            | Reverse Reactive Energy in VArh          |
-| rev_reactive_energy_group#rev_reactive_energy_phase3         | Number:Energy            | Rev Reactive Energy P3            | Reverse Reactive Energy in VArh          |
-| app_energy_group#appenergy_consumption_allphase              | Number:Energy            | Apparent Energy Consumption       | Apparent Energy Consumption in VArh      |
-| app_energy_group#appenergy_consumption_phase1                | Number:Energy            | Apparent Energy P1                | Apparent Energy Consumption in VArh      |
-| app_energy_group#appenergy_consumption_phase2                | Number:Energy            | Apparent Energy P2                | Apparent Energy Consumption in VArh      |
-| app_energy_group#appenergy_consumption_phase3                | Number:Energy            | Apparent Energy P3                | Apparent Energy Consumption in VArh      |
-
-## Full Example
-
-### mecmeter.things
-
-```
-mecmeter:meter:1 [ password="Test1234", ip="192.168.1.16", refreshInterval="10" ]
-```
-
-### mecmeter.items
-
-```
-Number:Frequency    MainFrequency           { channel="mecmeter:meter:1:general_group#frequency" }
-Number:Temperature  InternalTemperature     { channel="mecmeter:meter:1:general_group#temperature" }
-Number:Time         TimeinOperation         { channel="mecmeter:meter:1:general_group#op_time" }
-
-Number:Power ActivePower { channel="mecmeter:meter:1:activepower_group#activepower_allphase" }
-Number:Power ActivePowerP1 { channel="mecmeter:meter:1:activepower_group#activepower_phase1" }
-Number:Power ActivePowerP2 { channel="mecmeter:meter:1:activepower_group#activepower_phase2" }
-Number:Power ActivePowerP3 { channel="mecmeter:meter:1:activepower_group#activepower_phase3" }
-
-Number:ElectricPotential VoltageP1 { channel="mecmeter:meter:1:voltage_group#voltage_phase1" }
-Number:ElectricPotential VoltageP2 { channel="mecmeter:meter:1:voltage_group#voltage_phase2" }
-Number:ElectricPotential VoltageP3 { channel="mecmeter:meter:1:voltage_group#voltage_phase3" }
-Number:ElectricPotential AveragePhasePhaseVoltage { channel="mecmeter:meter:1:voltage_group#avg_phase_phase_voltage" }
-Number:ElectricPotential AverageVoltage { channel="mecmeter:meter:1:voltage_group#avg_neutral_phase_voltage" }
-
-Number:ElectricCurrent Current { channel="mecmeter:meter:1:current_group#current_allphase" }
-Number:ElectricCurrent Current_Group_Current_Phase1 { channel="mecmeter:meter:1:current_group#current_phase1" }
-Number:ElectricCurrent Current_Group_Current_Phase2 { channel="mecmeter:meter:1:current_group#current_phase2" }
-Number:ElectricCurrent Current_Group_Current_Phase3 { channel="mecmeter:meter:1:current_group#current_phase3" }
-
-Number:Power ActiveFundamentalPower { channel="mecmeter:meter:1:activefundpower_group#activefundpower_allphase" }
-Number:Power ActiveFundPowerP1 { channel="mecmeter:meter:1:activefundpower_group#activefundpower_phase1" }
-Number:Power ActiveFundPowerP2 { channel="mecmeter:meter:1:activefundpower_group#activefundpower_phase2" }
-Number:Power ActiveFundPowerP3 { channel="mecmeter:meter:1:activefundpower_group#activefundpower_phase3" }
-
-Number:Power ActiveHarmonicPower { channel="mecmeter:meter:1:activeharmpower_group#activeharmpower_allphase" }
-Number:Power ActiveHarmPowerP1 { channel="mecmeter:meter:1:activeharmpower_group#activeharmpower_phase1" }
-Number:Power ActiveHarmPowerP2 { channel="mecmeter:meter:1:activeharmpower_group#activeharmpower_phase2" }
-Number:Power ActiveHarmPowerP3 { channel="mecmeter:meter:1:activeharmpower_group#activeharmpower_phase3" }
-
-Number:Angle Angle_Group_Phase_Angle_Currvolt_Phase1 { channel="mecmeter:meter:1:angle_group#phase_angle_currvolt_phase1" }
-Number:Angle Angle_Group_Phase_Angle_Currvolt_Phase2 { channel="mecmeter:meter:1:angle_group#phase_angle_currvolt_phase2" }
-Number:Angle Angle_Group_Phase_Angle_Currvolt_Phase3 { channel="mecmeter:meter:1:angle_group#phase_angle_currvolt_phase3" }
-Number:Angle Angle_Group_Phase_Angle_Phase13 { channel="mecmeter:meter:1:angle_group#phase_angle_phase1-3" }
-Number:Angle Angle_Group_Phase_Angle_Phase23 { channel="mecmeter:meter:1:angle_group#phase_angle_phase2-3" }
-
-Number:Energy ApparentEnergyConsumption { channel="mecmeter:meter:1:app_energy_group#appenergy_consumption_allphase" }
-Number:Energy ApparentEnergyP1 { channel="mecmeter:meter:1:app_energy_group#appenergy_consumption_phase1" }
-Number:Energy ApparentEnergyP2 { channel="mecmeter:meter:1:app_energy_group#appenergy_consumption_phase2" }
-Number:Energy ApparentEnergyP3 { channel="mecmeter:meter:1:app_energy_group#appenergy_consumption_phase3" }
-
-Number:Power ApparentPower { channel="mecmeter:meter:1:apppower_group#apppower_allphase" }
-Number:Power ApparentPowerP1 { channel="mecmeter:meter:1:apppower_group#apppower_phase1" }
-Number:Power ApparentPowerP2 { channel="mecmeter:meter:1:apppower_group#apppower_phase2" }
-Number:Power ApparentPowerP3 { channel="mecmeter:meter:1:apppower_group#apppower_phase3" }
-
-Number:Energy ForwardActiveEnergy { channel="mecmeter:meter:1:fwd_active_energy_group#fwd_active_energy_allphase" }
-Number:Energy ForwardActiveFundamentalEnergy { channel="mecmeter:meter:1:fwd_active_fund_energy_group#fwd_active_fund_energy_allphase" }
-Number:Energy ForwardActiveHarmonicEnergy { channel="mecmeter:meter:1:fwd_active_harm_energy_group#fwd_active_harm_energy_allphase" }
-Number:Energy ForwardReactiveEnergy { channel="mecmeter:meter:1:fwd_reactive_energy_group#fwd_reactive_energy_allphase" }
-
-Number:Energy FwdActiveEnergyP1 { channel="mecmeter:meter:1:fwd_active_energy_group#fwd_active_energy_phase1" }
-Number:Energy FwdActiveEnergyP2 { channel="mecmeter:meter:1:fwd_active_energy_group#fwd_active_energy_phase2" }
-Number:Energy FwdActiveEnergyP3 { channel="mecmeter:meter:1:fwd_active_energy_group#fwd_active_energy_phase3" }
-
-Number:Energy FwdActiveFundEnergyP1 { channel="mecmeter:meter:1:fwd_active_fund_energy_group#fwd_active_fund_energy_phase1" }
-Number:Energy FwdActiveFundEnergyP2 { channel="mecmeter:meter:1:fwd_active_fund_energy_group#fwd_active_fund_energy_phase2" }
-Number:Energy FwdActiveFundEnergyP3 { channel="mecmeter:meter:1:fwd_active_fund_energy_group#fwd_active_fund_energy_phase3" }
-
-Number:Energy FwdActiveHarmEnergyP1 { channel="mecmeter:meter:1:fwd_active_harm_energy_group#fwd_active_harm_energy_phase1" }
-Number:Energy FwdActiveHarmEnergyP2 { channel="mecmeter:meter:1:fwd_active_harm_energy_group#fwd_active_harm_energy_phase2" }
-Number:Energy FwdActiveHarmEnergyP3 { channel="mecmeter:meter:1:fwd_active_harm_energy_group#fwd_active_harm_energy_phase3" }
-
-Number:Energy FwdReactiveEnergyP1 { channel="mecmeter:meter:1:fwd_reactive_energy_group#fwd_reactive_energy_phase1" }
-Number:Energy FwdReactiveEnergyP2 { channel="mecmeter:meter:1:fwd_reactive_energy_group#fwd_reactive_energy_phase2" }
-Number:Energy FwdReactiveEnergyP3 { channel="mecmeter:meter:1:fwd_reactive_energy_group#fwd_reactive_energy_phase3" }
-
-Number:Energy PowerFactor { channel="mecmeter:meter:1:powerfactor_group#powerFactor_allphase" }
-Number:Energy PowerFactorP1 { channel="mecmeter:meter:1:powerfactor_group#powerFactor_phase1" }
-Number:Energy PowerFactorP2 { channel="mecmeter:meter:1:powerfactor_group#powerFactor_phase2" }
-Number:Energy PowerFactorP3 { channel="mecmeter:meter:1:powerfactor_group#powerFactor_phase3" }
-
-Number:Power ReactivePower { channel="mecmeter:meter:1:reactivepower_group#reactivepower_allphase" }
-Number:Power ReactivePowerP1 { channel="mecmeter:meter:1:reactivepower_group#reactivepower_phase1" }
-Number:Power ReactivePowerP2 { channel="mecmeter:meter:1:reactivepower_group#reactivepower_phase2" }
-Number:Power ReactivePowerP3 { channel="mecmeter:meter:1:reactivepower_group#reactivepower_phase3" }
-
-Number:Energy ReverseActiveEnergy { channel="mecmeter:meter:1:rev_active_energy_group#rev_active_energy_allphase" }
-Number:Energy RevActiveEnergyP1 { channel="mecmeter:meter:1:rev_active_energy_group#rev_active_energy_phase1" }
-Number:Energy RevActiveEnergyP2 { channel="mecmeter:meter:1:rev_active_energy_group#rev_active_energy_phase2" }
-Number:Energy RevActiveEnergyP3 { channel="mecmeter:meter:1:rev_active_energy_group#rev_active_energy_phase3" }
-
-Number:Energy ReverseActiveFundamentalEnergy { channel="mecmeter:meter:1:rev_active_fund_energy_group#rev_active_fund_energy_allphase" }
-Number:Energy RevActiveFundEnergyP1 { channel="mecmeter:meter:1:rev_active_fund_energy_group#rev_active_fund_energy_phase1" }
-Number:Energy RevActiveFundEnergyP2 { channel="mecmeter:meter:1:rev_active_fund_energy_group#rev_active_fund_energy_phase2" }
-Number:Energy RevActiveFundEnergyP3 { channel="mecmeter:meter:1:rev_active_fund_energy_group#rev_active_fund_energy_phase3" }
-
-Number:Energy ReverseActiveHarmonicEnergy { channel="mecmeter:meter:1:rev_active_harm_energy_group#rev_active_harm_energy_allphase" }
-Number:Energy RevActiveHarmEnergyP1 { channel="mecmeter:meter:1:rev_active_harm_energy_group#rev_active_harm_energy_phase1" }
-Number:Energy RevActiveHarmEnergyP2 { channel="mecmeter:meter:1:rev_active_harm_energy_group#rev_active_harm_energy_phase2" }
-Number:Energy RevActiveHarmEnergyP3 { channel="mecmeter:meter:1:rev_active_harm_energy_group#rev_active_harm_energy_phase3" }
-
-Number:Energy ReverseReactiveEnergy { channel="mecmeter:meter:1:rev_reactive_energy_group#rev_reactive_energy_allphase" }
-Number:Energy RevReactiveEnergyP1 { channel="mecmeter:meter:1:rev_reactive_energy_group#rev_reactive_energy_phase1" }
-Number:Energy RevReactiveEnergyP2 { channel="mecmeter:meter:1:rev_reactive_energy_group#rev_reactive_energy_phase2" }
-Number:Energy RevReactiveEnergyP3 { channel="mecmeter:meter:1:rev_reactive_energy_group#rev_reactive_energy_phase3" }
-```
-
-### mecmeter.sitemap
-
-```
-sitemap mecmeter label="MecMeter"
-{
-    Frame label="General" {
-            Text item=MainFrequency
-            Text item=InternalTemperature
-    }
-
-    Frame label="Power" {
-        Text item=ActivePower
-        Text item=ActivePowerP1
-        Text item=ActivePowerP2
-        Text item=ActivePowerP3
-    }
-
-    Frame label="Electric Potential" {
-        Text item=VoltageP1
-        Text item=VoltageP2
-        Text item=VoltageP3
-    }
-    
-}
-```
diff --git a/bundles/org.openhab.binding.mecmeter/README.md b/bundles/org.openhab.binding.mecmeter/README.md
new file mode 100644 (file)
index 0000000..aa8f2f8
--- /dev/null
@@ -0,0 +1,247 @@
+# MecMeter Binding
+
+This binding reads data from MEC power meter for providing electrical information for the electric circuit.
+
+To use this binding the meter must be installed, initialized and connected to the same network as openHAB. 
+
+## Supported Things
+
+The mecMeter is supported with firmware version starting from 2.0.0.
+There is exactly one supported thing type `meter`, which represents the electric meter.
+Its unique ID is the serial number.
+
+## Discovery
+
+MecMeters are automatically discovered via mDNS. 
+The IP of the Power Meter is automatically set and can be changed manually if needed.
+The default update interval is set to 5 seconds. Intervals from 1 to 300 seconds can be set manually.
+
+## Thing Configuration
+
+The thing has a few configuration parameters:  
+
+| Parameter       | Description                                                           |
+|-----------------|-----------------------------------------------------------------------|
+| password        | User-defined password during initializing the Power Meter. Mandatory. |
+| ip              | The IP address of the meter. Mandatory.                               |
+| refreshInterval | Refresh interval in second. Optional, the default value is 5 seconds. |
+
+       
+## Channels
+
+The meter has the following channels: 
+
+| Channel Type ID                                              | Item Type                | Label                             | Description                              |
+|--------------------------------------------------------------|--------------------------|-----------------------------------|------------------------------------------|
+| general_group#frequency                                      | Number:Frequency         | Main Frequency                    | Frequency in Hertz                       |
+| general_group#temperature                                    | Number:Temperature       | Internal Temperature              | Internal Temperature of the energy meter |
+| general_group#op_time                                        | Number:Time              | Time in Operation                 | Time in Operation                        |
+| voltage_group#voltage_phase1                                 | Number:ElectricPotential | Voltage P1                        | Voltage in Volt                          |
+| voltage_group#voltage_phase2                                 | Number:ElectricPotential | Voltage P2                        | Voltage in Volt                          |
+| voltage_group#voltage_phase3                                 | Number:ElectricPotential | Voltage P3                        | Voltage in Volt                          |
+| voltage_group#avg_phase_phase_voltage                        | Number:ElectricPotential | Average Phase – Phase Voltage     | Average Phase – Phase Voltage in Volt    |
+| voltage_group#avg_neutral_phase_voltage                      | Number:ElectricPotential | Average Voltage                   | Average N – Phase Voltage in Volt        |
+| current_group#current_allphase                               | Number:ElectricCurrent   | Current                           | Current in Ampere                        |
+| current_group#current_phase1                                 | Number:ElectricCurrent   | Current P1                        | Current in Ampere                        |
+| current_group#current_phase2                                 | Number:ElectricCurrent   | Current P2                        | Current in Ampere                        |
+| current_group#current_phase3                                 | Number:ElectricCurrent   | Current P3                        | Current in Ampere                        |
+| angle_group#phase_angle_currvolt_phase1                      | Number:Angle             | Current P1                        | Angle Current to Voltage in Degree       |
+| angle_group#phase_angle_currvolt_phase2                      | Number:Angle             | Current P2                        | Angle Current to Voltage in Degree       |
+| angle_group#phase_angle_currvolt_phase3                      | Number:Angle             | Current P3                        | Angle Current to Voltage in Degree       |
+| angle_group#phase_angle_phase1-3                             | Number:Angle             | Angle Voltage to Voltage          | Angle Voltage to Voltage in Degree       |
+| angle_group#phase_angle_phase2-3                             | Number:Angle             | Angle Voltage to Voltage          | Angle Voltage to Voltage in Degree       |
+| activepower_group#activepower_allphase                       | Number:Power             | Active Power                      | Active power consumed                    |
+| activepower_group#activepower_phase1                         | Number:Power             | Active Power P1                   | Active power consumed                    |
+| activepower_group#activepower_phase2                         | Number:Power             | Active Power P2                   | Active power consumed                    |
+| activepower_group#activepower_phase3                         | Number:Power             | Active Power P3                   | Active power consumed                    |
+| activefundpower_group#activefundpower_allphase               | Number:Power             | Active Fundamental Power          | Active fundamental power                 |
+| activefundpower_group#activefundpower_phase1                 | Number:Power             | Active Fund Power P1              | Active fundamental power                 |
+| activefundpower_group#activefundpower_phase2                 | Number:Power             | Active Fund Power P2              | Active fundamental power                 |
+| activefundpower_group#activefundpower_phase3                 | Number:Power             | Active Fund Power P3              | Active fundamental power                 |
+| activeharmpower_group#activeharmpower_allphase               | Number:Power             | Active Harmonic Power             | Active harmonic power                    |
+| activeharmpower_group#activeharmpower_phase1                 | Number:Power             | Active Harm Power P1              | Active harmonic power                    |
+| activeharmpower_group#activeharmpower_phase2                 | Number:Power             | Active Harm Power P2              | Active harmonic power                    |
+| activeharmpower_group#activeharmpower_phase3                 | Number:Power             | Active Harm Power P3              | Active harmonic power                    |
+| reactivepower_group#reactivepower_allphase                   | Number:Power             | Reactive Power                    | Reactive power consumed                  |
+| reactivepower_group#reactivepower_phase1                     | Number:Power             | Reactive Power P1                 | Reactive power consumed                  |
+| reactivepower_group#reactivepower_phase2                     | Number:Power             | Reactive Power P2                 | Reactive power consumed                  |
+| reactivepower_group#reactivepower_phase3                     | Number:Power             | Reactive Power P3                 | Reactive power consumed                  |
+| powerfactor_group#powerFactor_allphase                       | Number:Dimensionless     | Power Factor                      | Power Factor                             |
+| powerfactor_group#powerFactor_phase1                         | Number:Dimensionless     | Power Factor P1                   | Power Factor                             |
+| powerfactor_group#powerFactor_phase2                         | Number:Dimensionless     | Power Factor P2                   | Power Factor                             |
+| powerfactor_group#powerFactor_phase3                         | Number:Dimensionless     | Power Factor P3                   | Power Factor                             |
+| apppower_group#apppower_allphase                             | Number:Power             | Apparent Power                    | Apparent power consumed                  |
+| apppower_group#apppower_phase1                               | Number:Power             | Apparent Power P1                 | Apparent power consumed                  |
+| apppower_group#apppower_phase2                               | Number:Power             | Apparent Power P2                 | Apparent power consumed                  |
+| apppower_group#apppower_phase3                               | Number:Power             | Apparent Power P3                 | Apparent power consumed                  |
+| fwd_active_energy_group#fwd_active_energy_allphase           | Number:Energy            | Forward Active Energy             | Forward Active Energy in kWh             |
+| fwd_active_energy_group#fwd_active_energy_phase1             | Number:Energy            | Fwd Active Energy P1              | Forward Active Energy in kWh             |
+| fwd_active_energy_group#fwd_active_energy_phase2             | Number:Energy            | Fwd Active Energy P2              | Forward Active Energy in kWh             |
+| fwd_active_energy_group#fwd_active_energy_phase3             | Number:Energy            | Fwd Active Energy P3              | Forward Active Energy in kWh             |
+| fwd_active_fund_energy_group#fwd_active_fund_energy_allphase | Number:Energy            | Forward Active Fundamental Energy | Forward Active Fundamental Energy in kWh |
+| fwd_active_fund_energy_group#fwd_active_fund_energy_phase1   | Number:Energy            | Fwd Active Fund Energy P1         | Forward Active Fundamental Energy in kWh |
+| fwd_active_fund_energy_group#fwd_active_fund_energy_phase2   | Number:Energy            | Fwd Active Fund Energy P2         | Forward Active Fundamental Energy in kWh |
+| fwd_active_fund_energy_group#fwd_active_fund_energy_phase3   | Number:Energy            | Fwd Active Fund Energy P3         | Forward Active Fundamental Energy in kWh |
+| fwd_active_harm_energy_group#fwd_active_harm_energy_allphase | Number:Energy            | Forward Active Harmonic Energy    | Forward Active Harmonic Energy in kWh    |
+| fwd_active_harm_energy_group#fwd_active_harm_energy_phase1   | Number:Energy            | Fwd Active Harm Energy P1         | Forward Active Harmonic Energy in kWh    |
+| fwd_active_harm_energy_group#fwd_active_harm_energy_phase2   | Number:Energy            | Fwd Active Harm Energy P2         | Forward Active Harmonic Energy in kWh    |
+| fwd_active_harm_energy_group#fwd_active_harm_energy_phase3   | Number:Energy            | Fwd Active Harm Energy P3         | Forward Active Harmonic Energy in kWh    |
+| fwd_reactive_energy_group#fwd_reactive_energy_allphase       | Number:Energy            | Forward Reactive Energy           | Forward Reactive Energy in VArh          |
+| fwd_reactive_energy_group#fwd_reactive_energy_phase1         | Number:Energy            | Fwd Reactive Energy P1            | Forward Reactive Energy in VArh          |
+| fwd_reactive_energy_group#fwd_reactive_energy_phase2         | Number:Energy            | Fwd Reactive Energy P2            | Forward Reactive Energy in VArh          |
+| fwd_reactive_energy_group#fwd_reactive_energy_phase3         | Number:Energy            | Fwd Reactive Energy P3            | Forward Reactive Energy in VArh          |
+| rev_active_energy_group#rev_active_energy_allphase           | Number:Energy            | Reverse Active Energy             | Reverse Active Energy in kWh             |
+| rev_active_energy_group#rev_active_energy_phase1             | Number:Energy            | Rev Active Energy P1              | Reverse Active Energy in kWh             |
+| rev_active_energy_group#rev_active_energy_phase2             | Number:Energy            | Rev Active Energy P2              | Reverse Active Energy in kWh             |
+| rev_active_energy_group#rev_active_energy_phase3             | Number:Energy            | Rev Active Energy P3              | Reverse Active Energy in kWh             |
+| rev_active_fund_energy_group#rev_active_fund_energy_allphase | Number:Energy            | Reverse Active Fundamental Energy | Reverse Active Fundamental Energy in kWh |
+| rev_active_fund_energy_group#rev_active_fund_energy_phase1   | Number:Energy            | Rev Active Fund Energy P1         | Reverse Active Fundamental Energy in kWh |
+| rev_active_fund_energy_group#rev_active_fund_energy_phase2   | Number:Energy            | Rev Active Fund Energy P2         | Reverse Active Fundamental Energy in kWh |
+| rev_active_fund_energy_group#rev_active_fund_energy_phase3   | Number:Energy            | Rev Active Fund Energy P3         | Reverse Active Fundamental Energy in kWh |
+| rev_active_harm_energy_group#rev_active_harm_energy_allphase | Number:Energy            | Reverse Active Harmonic Energy    | Reverse Active Harmonic Energy in kWh    |
+| rev_active_harm_energy_group#rev_active_harm_energy_phase1   | Number:Energy            | Rev Active Harm Energy P1         | Reverse Active Harmonic Energy in kWh    |
+| rev_active_harm_energy_group#rev_active_harm_energy_phase2   | Number:Energy            | Rev Active Harm Energy P2         | Reverse Active Harmonic Energy in kWh    |
+| rev_active_harm_energy_group#rev_active_harm_energy_phase3   | Number:Energy            | Rev Active Harm Energy P3         | Reverse Active Harmonic Energy in kWh    |
+| rev_reactive_energy_group#rev_reactive_energy_allphase       | Number:Energy            | Reverse Reactive Energy           | Reverse Reactive Energy in VArh          |
+| rev_reactive_energy_group#rev_reactive_energy_phase1         | Number:Energy            | Rev Reactive Energy P1            | Reverse Reactive Energy in VArh          |
+| rev_reactive_energy_group#rev_reactive_energy_phase2         | Number:Energy            | Rev Reactive Energy P2            | Reverse Reactive Energy in VArh          |
+| rev_reactive_energy_group#rev_reactive_energy_phase3         | Number:Energy            | Rev Reactive Energy P3            | Reverse Reactive Energy in VArh          |
+| app_energy_group#appenergy_consumption_allphase              | Number:Energy            | Apparent Energy Consumption       | Apparent Energy Consumption in VArh      |
+| app_energy_group#appenergy_consumption_phase1                | Number:Energy            | Apparent Energy P1                | Apparent Energy Consumption in VArh      |
+| app_energy_group#appenergy_consumption_phase2                | Number:Energy            | Apparent Energy P2                | Apparent Energy Consumption in VArh      |
+| app_energy_group#appenergy_consumption_phase3                | Number:Energy            | Apparent Energy P3                | Apparent Energy Consumption in VArh      |
+
+## Full Example
+
+### mecmeter.things
+
+```
+mecmeter:meter:1 [ password="Test1234", ip="192.168.1.16", refreshInterval="10" ]
+```
+
+### mecmeter.items
+
+```
+Number:Frequency    MainFrequency           { channel="mecmeter:meter:1:general_group#frequency" }
+Number:Temperature  InternalTemperature     { channel="mecmeter:meter:1:general_group#temperature" }
+Number:Time         TimeinOperation         { channel="mecmeter:meter:1:general_group#op_time" }
+
+Number:Power ActivePower { channel="mecmeter:meter:1:activepower_group#activepower_allphase" }
+Number:Power ActivePowerP1 { channel="mecmeter:meter:1:activepower_group#activepower_phase1" }
+Number:Power ActivePowerP2 { channel="mecmeter:meter:1:activepower_group#activepower_phase2" }
+Number:Power ActivePowerP3 { channel="mecmeter:meter:1:activepower_group#activepower_phase3" }
+
+Number:ElectricPotential VoltageP1 { channel="mecmeter:meter:1:voltage_group#voltage_phase1" }
+Number:ElectricPotential VoltageP2 { channel="mecmeter:meter:1:voltage_group#voltage_phase2" }
+Number:ElectricPotential VoltageP3 { channel="mecmeter:meter:1:voltage_group#voltage_phase3" }
+Number:ElectricPotential AveragePhasePhaseVoltage { channel="mecmeter:meter:1:voltage_group#avg_phase_phase_voltage" }
+Number:ElectricPotential AverageVoltage { channel="mecmeter:meter:1:voltage_group#avg_neutral_phase_voltage" }
+
+Number:ElectricCurrent Current { channel="mecmeter:meter:1:current_group#current_allphase" }
+Number:ElectricCurrent Current_Group_Current_Phase1 { channel="mecmeter:meter:1:current_group#current_phase1" }
+Number:ElectricCurrent Current_Group_Current_Phase2 { channel="mecmeter:meter:1:current_group#current_phase2" }
+Number:ElectricCurrent Current_Group_Current_Phase3 { channel="mecmeter:meter:1:current_group#current_phase3" }
+
+Number:Power ActiveFundamentalPower { channel="mecmeter:meter:1:activefundpower_group#activefundpower_allphase" }
+Number:Power ActiveFundPowerP1 { channel="mecmeter:meter:1:activefundpower_group#activefundpower_phase1" }
+Number:Power ActiveFundPowerP2 { channel="mecmeter:meter:1:activefundpower_group#activefundpower_phase2" }
+Number:Power ActiveFundPowerP3 { channel="mecmeter:meter:1:activefundpower_group#activefundpower_phase3" }
+
+Number:Power ActiveHarmonicPower { channel="mecmeter:meter:1:activeharmpower_group#activeharmpower_allphase" }
+Number:Power ActiveHarmPowerP1 { channel="mecmeter:meter:1:activeharmpower_group#activeharmpower_phase1" }
+Number:Power ActiveHarmPowerP2 { channel="mecmeter:meter:1:activeharmpower_group#activeharmpower_phase2" }
+Number:Power ActiveHarmPowerP3 { channel="mecmeter:meter:1:activeharmpower_group#activeharmpower_phase3" }
+
+Number:Angle Angle_Group_Phase_Angle_Currvolt_Phase1 { channel="mecmeter:meter:1:angle_group#phase_angle_currvolt_phase1" }
+Number:Angle Angle_Group_Phase_Angle_Currvolt_Phase2 { channel="mecmeter:meter:1:angle_group#phase_angle_currvolt_phase2" }
+Number:Angle Angle_Group_Phase_Angle_Currvolt_Phase3 { channel="mecmeter:meter:1:angle_group#phase_angle_currvolt_phase3" }
+Number:Angle Angle_Group_Phase_Angle_Phase13 { channel="mecmeter:meter:1:angle_group#phase_angle_phase1-3" }
+Number:Angle Angle_Group_Phase_Angle_Phase23 { channel="mecmeter:meter:1:angle_group#phase_angle_phase2-3" }
+
+Number:Energy ApparentEnergyConsumption { channel="mecmeter:meter:1:app_energy_group#appenergy_consumption_allphase" }
+Number:Energy ApparentEnergyP1 { channel="mecmeter:meter:1:app_energy_group#appenergy_consumption_phase1" }
+Number:Energy ApparentEnergyP2 { channel="mecmeter:meter:1:app_energy_group#appenergy_consumption_phase2" }
+Number:Energy ApparentEnergyP3 { channel="mecmeter:meter:1:app_energy_group#appenergy_consumption_phase3" }
+
+Number:Power ApparentPower { channel="mecmeter:meter:1:apppower_group#apppower_allphase" }
+Number:Power ApparentPowerP1 { channel="mecmeter:meter:1:apppower_group#apppower_phase1" }
+Number:Power ApparentPowerP2 { channel="mecmeter:meter:1:apppower_group#apppower_phase2" }
+Number:Power ApparentPowerP3 { channel="mecmeter:meter:1:apppower_group#apppower_phase3" }
+
+Number:Energy ForwardActiveEnergy { channel="mecmeter:meter:1:fwd_active_energy_group#fwd_active_energy_allphase" }
+Number:Energy ForwardActiveFundamentalEnergy { channel="mecmeter:meter:1:fwd_active_fund_energy_group#fwd_active_fund_energy_allphase" }
+Number:Energy ForwardActiveHarmonicEnergy { channel="mecmeter:meter:1:fwd_active_harm_energy_group#fwd_active_harm_energy_allphase" }
+Number:Energy ForwardReactiveEnergy { channel="mecmeter:meter:1:fwd_reactive_energy_group#fwd_reactive_energy_allphase" }
+
+Number:Energy FwdActiveEnergyP1 { channel="mecmeter:meter:1:fwd_active_energy_group#fwd_active_energy_phase1" }
+Number:Energy FwdActiveEnergyP2 { channel="mecmeter:meter:1:fwd_active_energy_group#fwd_active_energy_phase2" }
+Number:Energy FwdActiveEnergyP3 { channel="mecmeter:meter:1:fwd_active_energy_group#fwd_active_energy_phase3" }
+
+Number:Energy FwdActiveFundEnergyP1 { channel="mecmeter:meter:1:fwd_active_fund_energy_group#fwd_active_fund_energy_phase1" }
+Number:Energy FwdActiveFundEnergyP2 { channel="mecmeter:meter:1:fwd_active_fund_energy_group#fwd_active_fund_energy_phase2" }
+Number:Energy FwdActiveFundEnergyP3 { channel="mecmeter:meter:1:fwd_active_fund_energy_group#fwd_active_fund_energy_phase3" }
+
+Number:Energy FwdActiveHarmEnergyP1 { channel="mecmeter:meter:1:fwd_active_harm_energy_group#fwd_active_harm_energy_phase1" }
+Number:Energy FwdActiveHarmEnergyP2 { channel="mecmeter:meter:1:fwd_active_harm_energy_group#fwd_active_harm_energy_phase2" }
+Number:Energy FwdActiveHarmEnergyP3 { channel="mecmeter:meter:1:fwd_active_harm_energy_group#fwd_active_harm_energy_phase3" }
+
+Number:Energy FwdReactiveEnergyP1 { channel="mecmeter:meter:1:fwd_reactive_energy_group#fwd_reactive_energy_phase1" }
+Number:Energy FwdReactiveEnergyP2 { channel="mecmeter:meter:1:fwd_reactive_energy_group#fwd_reactive_energy_phase2" }
+Number:Energy FwdReactiveEnergyP3 { channel="mecmeter:meter:1:fwd_reactive_energy_group#fwd_reactive_energy_phase3" }
+
+Number:Energy PowerFactor { channel="mecmeter:meter:1:powerfactor_group#powerFactor_allphase" }
+Number:Energy PowerFactorP1 { channel="mecmeter:meter:1:powerfactor_group#powerFactor_phase1" }
+Number:Energy PowerFactorP2 { channel="mecmeter:meter:1:powerfactor_group#powerFactor_phase2" }
+Number:Energy PowerFactorP3 { channel="mecmeter:meter:1:powerfactor_group#powerFactor_phase3" }
+
+Number:Power ReactivePower { channel="mecmeter:meter:1:reactivepower_group#reactivepower_allphase" }
+Number:Power ReactivePowerP1 { channel="mecmeter:meter:1:reactivepower_group#reactivepower_phase1" }
+Number:Power ReactivePowerP2 { channel="mecmeter:meter:1:reactivepower_group#reactivepower_phase2" }
+Number:Power ReactivePowerP3 { channel="mecmeter:meter:1:reactivepower_group#reactivepower_phase3" }
+
+Number:Energy ReverseActiveEnergy { channel="mecmeter:meter:1:rev_active_energy_group#rev_active_energy_allphase" }
+Number:Energy RevActiveEnergyP1 { channel="mecmeter:meter:1:rev_active_energy_group#rev_active_energy_phase1" }
+Number:Energy RevActiveEnergyP2 { channel="mecmeter:meter:1:rev_active_energy_group#rev_active_energy_phase2" }
+Number:Energy RevActiveEnergyP3 { channel="mecmeter:meter:1:rev_active_energy_group#rev_active_energy_phase3" }
+
+Number:Energy ReverseActiveFundamentalEnergy { channel="mecmeter:meter:1:rev_active_fund_energy_group#rev_active_fund_energy_allphase" }
+Number:Energy RevActiveFundEnergyP1 { channel="mecmeter:meter:1:rev_active_fund_energy_group#rev_active_fund_energy_phase1" }
+Number:Energy RevActiveFundEnergyP2 { channel="mecmeter:meter:1:rev_active_fund_energy_group#rev_active_fund_energy_phase2" }
+Number:Energy RevActiveFundEnergyP3 { channel="mecmeter:meter:1:rev_active_fund_energy_group#rev_active_fund_energy_phase3" }
+
+Number:Energy ReverseActiveHarmonicEnergy { channel="mecmeter:meter:1:rev_active_harm_energy_group#rev_active_harm_energy_allphase" }
+Number:Energy RevActiveHarmEnergyP1 { channel="mecmeter:meter:1:rev_active_harm_energy_group#rev_active_harm_energy_phase1" }
+Number:Energy RevActiveHarmEnergyP2 { channel="mecmeter:meter:1:rev_active_harm_energy_group#rev_active_harm_energy_phase2" }
+Number:Energy RevActiveHarmEnergyP3 { channel="mecmeter:meter:1:rev_active_harm_energy_group#rev_active_harm_energy_phase3" }
+
+Number:Energy ReverseReactiveEnergy { channel="mecmeter:meter:1:rev_reactive_energy_group#rev_reactive_energy_allphase" }
+Number:Energy RevReactiveEnergyP1 { channel="mecmeter:meter:1:rev_reactive_energy_group#rev_reactive_energy_phase1" }
+Number:Energy RevReactiveEnergyP2 { channel="mecmeter:meter:1:rev_reactive_energy_group#rev_reactive_energy_phase2" }
+Number:Energy RevReactiveEnergyP3 { channel="mecmeter:meter:1:rev_reactive_energy_group#rev_reactive_energy_phase3" }
+```
+
+### mecmeter.sitemap
+
+```
+sitemap mecmeter label="MecMeter"
+{
+    Frame label="General" {
+            Text item=MainFrequency
+            Text item=InternalTemperature
+    }
+
+    Frame label="Power" {
+        Text item=ActivePower
+        Text item=ActivePowerP1
+        Text item=ActivePowerP2
+        Text item=ActivePowerP3
+    }
+
+    Frame label="Electric Potential" {
+        Text item=VoltageP1
+        Text item=VoltageP2
+        Text item=VoltageP3
+    }
+    
+}
+```