openhab-addons/bundles/org.openhab.binding.revogi
Wouter Born 07a1976c81
Add default translations for binding add-ons (#11760)
* Add default translations for binding add-ons

This makes the texts used by these add-ons translatable with Crowdin.

To keep the PR simple, it only adds default translations for add-ons which do not yet have any default translations properties file.
We can do follow up PRs for adding missing key/values to add-ons that already have these files or to remove duplications.

There are several add-ons in this PR that do have non-English translation files, so I'll upload those to Crowdin when the PR is merged.

Signed-off-by: Wouter Born <github@maindrain.net>
2021-12-15 18:40:21 +01:00
..
src Add default translations for binding add-ons (#11760) 2021-12-15 18:40:21 +01:00
NOTICE [revogi] Initial contribution - Resubmitted for OH3 (#8534) 2020-11-03 09:13:08 -08:00
pom.xml applied spotless 2021-06-27 23:25:35 +02:00
README.md [revogi] Initial contribution - Resubmitted for OH3 (#8534) 2020-11-03 09:13:08 -08:00

Revogi Binding

This binding is written to control Revogi devices. The first thing implemented is the Revogi Smart Power Strip. The device has 6 power plugs that can be switched independently, or all together. It also provides information like power consumption and electric current for each plug.

It was hard to find out how to control it without internet access, but there's a way to use UDP packets. See the following support document for details. This was the only document the Revogi support provided.

Supported Things

Currently only the model SOW019 is supported.

Discovery

If your smart strip is within your network (broadcast domain), discovery can work. The discovery service will send udp packets to the broadcast address and waits for a feedback.

It is required to integrate your power strip into your network first, maybe with the official app.

Thing Configuration

You need to know the serial number. Usually you can find it on the back. The serial number will also be discovered. The IP address of the device is also necessary, this address should be set static. There's a fallback to broadcast status and switch requests. That may be unreliable if you have more than one smart plug in your network. They all react on UDP packets.

Channels

channel type description
overallPlug#switch Switch Switches all plugs
plug1#switch Switch Switch plug 1
plug1#watt Number:Power Contains currently used power of plug 1
plug1#amp Number:ElectricCurrent Contains currently used current of plug 1
plug2#switch Switch Switch plug 2
plug2#watt Number:Power Contains currently used power of plug 2
plug2#amp Number:ElectricCurrent Contains currently used current of plug 2
plug3#switch Switch Switch plug 3
plug3#watt Number:Power Contains currently used power of plug 3
plug3#amp Number:ElectricCurrent Contains currently used current of plug 3
plug4#switch Switch Switch plug 4
plug4#watt Number:Power Contains currently used power of plug 4
plug4#amp Number:ElectricCurrent Contains currently used current of plug 4
plug5#switch Switch Switch plug 5
plug5#watt Number:Power Contains currently used power of plug 5
plug5#amp Number:ElectricCurrent Contains currently used current of plug 5
plug6#switch Switch Switch plug 6
plug6#watt Number:Power Contains currently used power of plug 6
plug6#amp Number:ElectricCurrent Contains currently used current of plug 6

Full Example

Example Thing configuration:

Thing revogi:smartstrip:<serialNumber> "<Name>" @ "<Location>" [serialNumber="<serialNumnber>", ipAddress=<ipaddress>, pollIntervall=45]

Example Items configuration:

Group revogi (LivingRoom)

Group plug1 (revogi)
Group plug2 (revogi)

Switch All_Plugs "Steckdosen komplett" <switch> (revogi) {channel="revogi:smartstrip:<serialNumnber>:overallPlug#switch"}

Switch Plug_1 "Steckdose 1" <switch> (plug1) {channel="revogi:smartstrip:<serialNumnber>:plug1#switch"}
Number Plug_1_Watt "Steckdose 1 Leistung" <chart> (plug1) {channel="revogi:smartstrip:<serialNumnber>:plug1#watt"}
Number Plug_1_Amp "Steckdose 1 Strom" <chart> (plug1) {channel="revogi:smartstrip:<serialNumnber>:plug1#amp"}

...