Updated external content (Jenkins build 1772)
openHAB Build Server
parent
d81f8c97bc
commit
2e0da3e8c2
File diff suppressed because one or more lines are too long
|
|
@ -34,7 +34,7 @@ Here is a product picture of how this Weather Station looks like:
|
|||
|
||||
|
||||
|
||||
This binding works offline by [implementing the wire protocol](https://osswww.ecowitt.net/uploads/20210716/WN1900%20GW1000,1100%20WH2680,2650%20telenet%20v1.6.0%20.pdf) of the WiFi gateway device.
|
||||
This binding works offline by [implementing the wire protocol](https://osswww.ecowitt.net/uploads/20220407/WN1900%20GW1000,1100%20WH2680,2650%20telenet%20v1.6.4.pdf) of the WiFi gateway device.
|
||||
|
||||
## Discussion
|
||||
|
||||
|
|
|
|||
|
|
@ -0,0 +1,91 @@
|
|||
---
|
||||
id: tasmotaplug
|
||||
label: TasmotaPlug
|
||||
title: TasmotaPlug - Bindings
|
||||
type: binding
|
||||
description: "This binding connects Tasmota flashed smart plugs with 1, 2, 3 or 4 relay channels to openHAB."
|
||||
since: 3x
|
||||
install: auto
|
||||
---
|
||||
|
||||
<!-- Attention authors: Do not edit directly. Please add your changes to the appropriate source repository -->
|
||||
|
||||
{% include base.html %}
|
||||
|
||||
# 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.
|
||||
See the [Tasmota Supported Devices Repository](https://templates.blakadder.com/plug.html) for a list of supported plugs.
|
||||
|
||||
## Supported Things
|
||||
|
||||
There is exactly one supported thing type, which represents any supported Tasmota smart plug.
|
||||
It has the `plug` id.
|
||||
Multiple Things can be added if more than one plug is to be controlled.
|
||||
|
||||
## Discovery
|
||||
|
||||
Discovery is not supported. All things must be added manually.
|
||||
|
||||
## Thing Configuration
|
||||
|
||||
At minimum, the host name must be specified.
|
||||
The refresh interval and number of channels can be overridden from the default.
|
||||
|
||||
| Parameter | Description |
|
||||
|-------------|-----------------------------------------------------------------------------------------|
|
||||
| hostName | The host name or IP address of the plug. Mandatory. |
|
||||
| refresh | Overrides the refresh interval of the plug status. Optional, the default is 30 seconds. |
|
||||
| numChannels | Number of channels on the Tasmota Plug (1-4). Optional, the default is 1 |
|
||||
| username | Username for authentication with the Tasmota Plug. Default 'admin' |
|
||||
| password | Password for authentication with the Tasmota Plug, if not supplied auth is disabled. |
|
||||
|
||||
## Channels
|
||||
|
||||
The number of channels depends of on the `numChannels` configuration parameter.
|
||||
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 |
|
||||
|
||||
## Full Example
|
||||
|
||||
tasmotaplug.things:
|
||||
|
||||
```java
|
||||
tasmotaplug:plug:plug1 "Plug 1" [ hostName="192.168.10.1", refresh=30 ]
|
||||
tasmotaplug:plug:plug2 "Plug 2" [ hostName="myplug2", refresh=30 ]
|
||||
```
|
||||
|
||||
tasmotaplug.items:
|
||||
|
||||
```java
|
||||
Switch Plug1 "Plug 1 Power" { channel="tasmotaplug:plug:plug1:power" }
|
||||
|
||||
Switch Plug2a "4ch Power 1" { channel="tasmotaplug:plug:plug2:power" }
|
||||
Switch Plug2b "4ch Power 2" { channel="tasmotaplug:plug:plug2:power2" }
|
||||
Switch Plug2c "4ch Power 3" { channel="tasmotaplug:plug:plug2:power3" }
|
||||
Switch Plug2d "4ch Power 4" { channel="tasmotaplug:plug:plug2:power4" }
|
||||
```
|
||||
|
||||
tasmotaplug.sitemap:
|
||||
|
||||
```perl
|
||||
sitemap tasmotaplug label="My Tasmota Plugs" {
|
||||
Frame label="Plugs" {
|
||||
Switch item=Plug1
|
||||
|
||||
Switch item=Plug2a
|
||||
Switch item=Plug2b
|
||||
Switch item=Plug2c
|
||||
Switch item=Plug2d
|
||||
}
|
||||
}
|
||||
```
|
||||
|
|
@ -0,0 +1,65 @@
|
|||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<thing:thing-descriptions bindingId="tasmotaplug"
|
||||
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
|
||||
xmlns:thing="https://openhab.org/schemas/thing-description/v1.0.0"
|
||||
xsi:schemaLocation="https://openhab.org/schemas/thing-description/v1.0.0 https://openhab.org/schemas/thing-description-1.0.0.xsd">
|
||||
|
||||
<!-- Tasmota Plug Thing -->
|
||||
<thing-type id="plug">
|
||||
<label>Plug</label>
|
||||
<description>
|
||||
Tasmota Smart Plug
|
||||
</description>
|
||||
|
||||
<channels>
|
||||
<channel id="power" typeId="system.power">
|
||||
<label>Power</label>
|
||||
<description>Controls the smart plug relay for the 1st channel</description>
|
||||
</channel>
|
||||
<channel id="power2" typeId="system.power">
|
||||
<label>Power 2</label>
|
||||
<description>Controls the smart plug relay for the 2nd channel</description>
|
||||
</channel>
|
||||
<channel id="power3" typeId="system.power">
|
||||
<label>Power 3</label>
|
||||
<description>Controls the smart plug relay for the 3rd channel</description>
|
||||
</channel>
|
||||
<channel id="power4" typeId="system.power">
|
||||
<label>Power 4</label>
|
||||
<description>Controls the smart plug relay for the 4th channel</description>
|
||||
</channel>
|
||||
</channels>
|
||||
|
||||
<config-description>
|
||||
<parameter name="hostName" type="text" required="true">
|
||||
<context>network-address</context>
|
||||
<label>Plug Host Name/IP Address</label>
|
||||
<description>Host name or IP address of the plug</description>
|
||||
</parameter>
|
||||
<parameter name="refresh" type="integer" min="1" required="false" unit="s">
|
||||
<label>Refresh Interval</label>
|
||||
<description>Specifies the refresh interval in seconds</description>
|
||||
<default>30</default>
|
||||
</parameter>
|
||||
<parameter name="numChannels" type="integer" min="1" max="4" required="false">
|
||||
<label>Number of Channels</label>
|
||||
<description>Number of channels on the Tasmota plug (1-4) default 1</description>
|
||||
<default>1</default>
|
||||
</parameter>
|
||||
<parameter name="username" type="text">
|
||||
<label>Username</label>
|
||||
<description>Tasmota username</description>
|
||||
<default>admin</default>
|
||||
<advanced>true</advanced>
|
||||
</parameter>
|
||||
<parameter name="password" type="text" required="false">
|
||||
<context>password</context>
|
||||
<label>Password</label>
|
||||
<description>Tasmota password</description>
|
||||
<advanced>true</advanced>
|
||||
</parameter>
|
||||
</config-description>
|
||||
|
||||
</thing-type>
|
||||
|
||||
</thing:thing-descriptions>
|
||||
Loading…
Reference in New Issue