Updated external content (Jenkins build 2033)
openHAB Build Server
parent
7cb031ae78
commit
8367534546
|
|
@ -15,8 +15,9 @@ install: auto
|
|||
|
||||
# TasmotaPlug Binding
|
||||
|
||||
This binding connects Tasmota flashed smart plugs with 1, 2, 3 or 4 relay channels to openHAB.
|
||||
The plug must report the status of the relay via the url `http://$PLUG_IP/cm?cmnd=Power` in order for the binding to work.
|
||||
This binding connects Tasmota flashed smart plugs with 1, 2, 3 or 4 relay channels to openHAB.
|
||||
The plug must report the status of the relay via the url `http://$PLUG_IP/cm?cmnd=Power` in order for the binding to work.
|
||||
The energy monitoring channels can be used if the plug reports energy status via the url `http://$PLUG_IP/cm?cmnd=Status%2010`.
|
||||
See the [Tasmota Supported Devices Repository](https://templates.blakadder.com/plug.html) for a list of supported plugs.
|
||||
|
||||
## Supported Things
|
||||
|
|
@ -49,12 +50,22 @@ Channels above the number specified are automatically removed.
|
|||
Therefore `numChannels` cannot be changed upward after Thing creation.
|
||||
If the number of channels must be increased, delete the Thing and re-create it with the correct number.
|
||||
|
||||
| Channel ID | Item Type | Description |
|
||||
|------------|-----------|-----------------------------------------|
|
||||
| power | Switch | Turns the smart plug relay #1 ON or OFF |
|
||||
| power2 | Switch | Turns the smart plug relay #2 ON or OFF |
|
||||
| power3 | Switch | Turns the smart plug relay #3 ON or OFF |
|
||||
| power4 | Switch | Turns the smart plug relay #4 ON or OFF |
|
||||
| Channel ID | Item Type | Description |
|
||||
|----------------------|--------------------------|-------------------------------------------------|
|
||||
| power | Switch | Turns the smart plug relay #1 ON or OFF |
|
||||
| power2 | Switch | Turns the smart plug relay #2 ON or OFF |
|
||||
| power3 | Switch | Turns the smart plug relay #3 ON or OFF |
|
||||
| power4 | Switch | Turns the smart plug relay #4 ON or OFF |
|
||||
| voltage | Number:ElectricPotential | Channel for output voltage measurement |
|
||||
| current | Number:ElectricCurrent | Channel for output current measurement |
|
||||
| watts | Number:Power | Channel for output power measurement |
|
||||
| volt-ampere | Number:Power | Channel for output VA measurement |
|
||||
| volt-ampere-reactive | Number:Power | Channel for output VAr measurement |
|
||||
| power-factor | Number:Dimensionless | Channel for output power factor measurement |
|
||||
| energy-today | Number:Energy | Channel for output energy today measurement |
|
||||
| energy-yesterday | Number:Energy | Channel for output energy yesterday measurement |
|
||||
| energy-total | Number:Energy | Channel for output energy total measurement |
|
||||
| energy-total-start | DateTime | Channel for output energy total start date/time |
|
||||
|
||||
## Full Example
|
||||
|
||||
|
|
@ -68,7 +79,17 @@ tasmotaplug:plug:plug2 "Plug 2" [ hostName="myplug2", refresh=30 ]
|
|||
tasmotaplug.items:
|
||||
|
||||
```java
|
||||
Switch Plug1 "Plug 1 Power" { channel="tasmotaplug:plug:plug1:power" }
|
||||
Switch Plug1 "Plug 1 Power" { channel="tasmotaplug:plug:plug1:power" }
|
||||
Number:ElectricPotential Voltage { channel="tasmotaplug:plug:plug1:voltage" }
|
||||
Number:ElectricCurrent Current { channel="tasmotaplug:plug:plug1:current" }
|
||||
Number:Power Watts { channel="tasmotaplug:plug:plug1:watts" }
|
||||
Number:Power VoltAmpere { channel="tasmotaplug:plug:plug1:volt-ampere" }
|
||||
Number:Power VoltAmpereReactive { channel="tasmotaplug:plug:plug1:volt-ampere-reactive" }
|
||||
Number PowerFactor { channel="tasmotaplug:plug:plug1:power-factor" }
|
||||
Number:Energy EnergyToday { channel="tasmotaplug:plug:plug1:energy-today" }
|
||||
Number:Energy EnergyYesterday { channel="tasmotaplug:plug:plug1:energy-yesterday" }
|
||||
Number:Energy EnergyTotal { channel="tasmotaplug:plug:plug1:energy-total" }
|
||||
DateTime EnergyTotalStart "Total Start [%s]" { channel="tasmotaplug:plug:plug1:energy-total-start" }
|
||||
|
||||
Switch Plug2a "4ch Power 1" { channel="tasmotaplug:plug:plug2:power" }
|
||||
Switch Plug2b "4ch Power 2" { channel="tasmotaplug:plug:plug2:power2" }
|
||||
|
|
@ -83,6 +104,18 @@ sitemap tasmotaplug label="My Tasmota Plugs" {
|
|||
Frame label="Plugs" {
|
||||
Switch item=Plug1
|
||||
|
||||
// Energy monitoring
|
||||
Text item=Voltage
|
||||
Text item=Current
|
||||
Text item=Watts
|
||||
Text item=VoltAmpere
|
||||
Text item=VoltAmpereReactive
|
||||
Text item=PowerFactor
|
||||
Text item=EnergyToday
|
||||
Text item=EnergyYesterday
|
||||
Text item=EnergyTotal
|
||||
Text item=EnergyTotalStart
|
||||
|
||||
Switch item=Plug2a
|
||||
Switch item=Plug2b
|
||||
Switch item=Plug2c
|
||||
|
|
|
|||
|
|
@ -28,8 +28,39 @@
|
|||
<label>Power 4</label>
|
||||
<description>Controls the smart plug relay for the 4th channel</description>
|
||||
</channel>
|
||||
|
||||
<!-- Energy Monitor Channels -->
|
||||
<channel id="voltage" typeId="system.electric-voltage"/>
|
||||
<channel id="current" typeId="system.electric-current"/>
|
||||
<channel id="watts" typeId="system.electric-power">
|
||||
<label>Active Power</label>
|
||||
<description>Active Power (W)</description>
|
||||
</channel>
|
||||
|
||||
<channel id="volt-ampere" typeId="volt-ampere"/>
|
||||
<channel id="volt-ampere-reactive" typeId="volt-ampere-reactive"/>
|
||||
<channel id="power-factor" typeId="power-factor"/>
|
||||
|
||||
<channel id="energy-today" typeId="system.electric-energy">
|
||||
<label>Energy Today</label>
|
||||
<description>Energy consumed today (kWh)</description>
|
||||
</channel>
|
||||
<channel id="energy-yesterday" typeId="system.electric-energy">
|
||||
<label>Energy Yesterday</label>
|
||||
<description>Energy consumed yesterday (kWh)</description>
|
||||
</channel>
|
||||
<channel id="energy-total" typeId="system.electric-energy">
|
||||
<label>Energy Total</label>
|
||||
<description>Total energy consumed (kWh)</description>
|
||||
</channel>
|
||||
|
||||
<channel id="energy-total-start" typeId="energy-total-start"/>
|
||||
</channels>
|
||||
|
||||
<properties>
|
||||
<property name="thingTypeVersion">1</property>
|
||||
</properties>
|
||||
|
||||
<config-description>
|
||||
<parameter name="hostName" type="text" required="true">
|
||||
<context>network-address</context>
|
||||
|
|
@ -62,4 +93,36 @@
|
|||
|
||||
</thing-type>
|
||||
|
||||
<channel-type id="volt-ampere">
|
||||
<item-type>Number:Power</item-type>
|
||||
<label>Apparent Power</label>
|
||||
<description>Apparent Power (VA)</description>
|
||||
<state readOnly="true" pattern="%d %unit%"/>
|
||||
</channel-type>
|
||||
|
||||
<channel-type id="volt-ampere-reactive">
|
||||
<item-type>Number:Power</item-type>
|
||||
<label>Reactive Power</label>
|
||||
<description>Reactive Power (VAr)</description>
|
||||
<state readOnly="true" pattern="%d %unit%"/>
|
||||
</channel-type>
|
||||
|
||||
<channel-type id="power-factor">
|
||||
<item-type>Number:Dimensionless</item-type>
|
||||
<label>Power Factor</label>
|
||||
<description>Power Factor (PF)</description>
|
||||
<state readOnly="true" pattern="%.1f %unit%"/>
|
||||
</channel-type>
|
||||
|
||||
<channel-type id="energy-total-start">
|
||||
<item-type>DateTime</item-type>
|
||||
<label>Energy Total Start</label>
|
||||
<description>The date/time when the energy total measurement started</description>
|
||||
<category>Time</category>
|
||||
<tags>
|
||||
<tag>Timestamp</tag>
|
||||
</tags>
|
||||
<state readOnly="true"/>
|
||||
</channel-type>
|
||||
|
||||
</thing:thing-descriptions>
|
||||
|
|
|
|||
Loading…
Reference in New Issue