Updated external content (Jenkins build 1844)
openHAB Build Server
parent
b5878f3f02
commit
d97a302dba
File diff suppressed because one or more lines are too long
Binary file not shown.
|
After Width: | Height: | Size: 44 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 24 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 28 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 25 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 104 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 30 KiB |
|
|
@ -0,0 +1,185 @@
|
|||
---
|
||||
id: govee
|
||||
label: Govee Lan-API
|
||||
title: Govee Lan-API - Bindings
|
||||
type: binding
|
||||
description: ""
|
||||
since: 3x
|
||||
logo: images/addons/govee.png
|
||||
install: manual
|
||||
---
|
||||
|
||||
<!-- Attention authors: Do not edit directly. Please add your changes to the appropriate source repository -->
|
||||
|
||||
{% include base.html %}
|
||||
|
||||
# Govee Lan-API Binding
|
||||
|
||||
|
||||
|
||||
This binding integrates Light devices from [Govee](https://www.govee.com/).
|
||||
Even though these devices are widely used, they are usually only accessable via the Cloud.
|
||||
Another option is using Bluetooth which, due to its limitation only allows to control devices within a small range.
|
||||
The Bluetooth approach is supported by the openHAB Govee Binding while this binding covers the LAN interface.
|
||||
|
||||
Fortunately, there is a [LAN API](https://app-h5.govee.com/user-manual/wlan-guide) that allows to control the devices within your own network without accessing the Cloud.
|
||||
Note, though, that is somehow limited to a number of devices listed in the aforementioned manual.
|
||||
The binding is aware of all the devices that are listed in that document and even provides a product description during discovery.
|
||||
|
||||
Note: By intent the Cloud API has not been implemented (so far) as it makes controlling Govee devices dependent by Govee service itself.
|
||||
|
||||
## Supported Things
|
||||
|
||||
The things that are supported are all lights.
|
||||
While Govee provides probably more than a hundred different lights, only the following are supported officially by the LAN API, even though others might works as well.
|
||||
|
||||
Here is a list of the supported devices (the ones marked with * have been tested by the author)
|
||||
|
||||
- H619Z RGBIC Pro LED Strip Lights
|
||||
- H6046 RGBIC TV Light Bars
|
||||
- H6047 RGBIC Gaming Light Bars with Smart Controller
|
||||
- H6061 Glide Hexa LED Panels (*)
|
||||
- H6062 Glide Wall Light
|
||||
- H6065 Glide RGBIC Y Lights
|
||||
- H6066 Glide Hexa Pro LED Panel
|
||||
- H6067 Glide Triangle Light Panels (*)
|
||||
- H6072 RGBICWW Corner Floor Lamp
|
||||
- H6076 RGBICW Smart Corner Floor Lamp (*)
|
||||
- H6073 LED Floor Lamp
|
||||
- H6078 Cylinder Floor Lamp
|
||||
- H6087 RGBIC Smart Wall Sconces
|
||||
- H6173 RGBIC Outdoor Strip Lights
|
||||
- H619A RGBIC Strip Lights With Protective Coating 5M
|
||||
- H619B RGBIC LED Strip Lights With Protective Coating
|
||||
- H619C LED Strip Lights With Protective Coating
|
||||
- H619D RGBIC PRO LED Strip Lights
|
||||
- H619E RGBIC LED Strip Lights With Protective Coating
|
||||
- H61A0 RGBIC Neon Rope Light 1M
|
||||
- H61A1 RGBIC Neon Rope Light 2M
|
||||
- H61A2 RGBIC Neon Rope Light 5M
|
||||
- H61A3 RGBIC Neon Rope Light
|
||||
- H61A5 Neon LED Strip Light 10
|
||||
- H61A8Neon Neon Rope Light 10
|
||||
- H618A RGBIC Basic LED Strip Lights 5M
|
||||
- H618C RGBIC Basic LED Strip Lights 5M
|
||||
- H6117 Dream Color LED Strip Light 10M
|
||||
- H6159 RGB Light Strip (*)
|
||||
- H615E LED Strip Lights 30M
|
||||
- H6163 Dreamcolor LED Strip Light 5M
|
||||
- H610A Glide Lively Wall Lights
|
||||
- H610B Music Wall Lights
|
||||
- H6172 Outdoor LED Strip 10m
|
||||
- H61B2 RGBIC Neon TV Backlight
|
||||
- H61E1 LED Strip Light M1
|
||||
- H7012 Warm White Outdoor String Lights
|
||||
- H7013 Warm White Outdoor String Lights
|
||||
- H7021 RGBIC Warm White Smart Outdoor String
|
||||
- H7028 Lynx Dream LED-Bulb String
|
||||
- H7041 LED Outdoor Bulb String Lights
|
||||
- H7042 LED Outdoor Bulb String Lights
|
||||
- H705A Permanent Outdoor Lights 30M
|
||||
- H705B Permanent Outdoor Lights 15M
|
||||
- H7050 Outdoor Ground Lights 11M
|
||||
- H7051 Outdoor Ground Lights 15M
|
||||
- H7055 Pathway Light
|
||||
- H7060 LED Flood Lights (2-Pack)
|
||||
- H7061 LED Flood Lights (4-Pack)
|
||||
- H7062 LED Flood Lights (6-Pack)
|
||||
- H7065 Outdoor Spot Lights
|
||||
- H70C1 Govee Christmas String Lights 10m (*)
|
||||
- H70C2 Govee Christmas String Lights 20m (*)
|
||||
- H6051 Aura - Smart Table Lamp
|
||||
- H6056 H6056 Flow Plus
|
||||
- H6059 RGBWW Night Light for Kids
|
||||
- H618F RGBIC LED Strip Lights
|
||||
- H618E LED Strip Lights 22m
|
||||
- H6168 TV LED Backlight
|
||||
|
||||
## Discovery
|
||||
|
||||
Discovery is done by scanning the devices in the Thing section.
|
||||
|
||||
The devices _do not_ support the LAN API support out-of-the-box.
|
||||
To be able to use the device with the LAN API, the following needs to be done (also see the "Preparations for LAN API Control" section in the [Goveee LAN API Manual](https://app-h5.govee.com/user-manual/wlan-guide)):
|
||||
|
||||
- Start the Govee APP and add / discover the device (via Bluetooth) as described by the vendor manual
|
||||
Go to the settings page of the device
|
||||
|
||||
- Note that it may take several(!) minutes until this setting comes up.
|
||||
- Switch on the LAN Control setting.
|
||||
- Now the device can be used with openHAB.
|
||||
- The easiest way is then to scan the devices via the SCAN button in the thing section of that binding
|
||||
|
||||
## Thing Configuration
|
||||
|
||||
Even though binding configuration is supported via a thing file it should be noted that the IP address is required and there is no easy way to find out the IP address of the device.
|
||||
One possibility is to look for the MAC address in the Govee app and then looking the IP address up via:
|
||||
|
||||
```shell
|
||||
arp -a | grep "MAC_ADDRESS"
|
||||
```
|
||||
|
||||
### `govee-light` Thing Configuration
|
||||
|
||||
| Name | Type | Description | Default | Required | Advanced |
|
||||
|-----------------|---------|---------------------------------------|---------|----------|----------|
|
||||
| hostname | text | Hostname or IP address of the device | N/A | yes | no |
|
||||
| macAddress | text | MAC address of the device | N/A | yes | no |
|
||||
| deviceType | text | The product number of the device | N/A | yes | no |
|
||||
| refreshInterval | integer | Interval the device is polled in sec. | 5 | no | yes |
|
||||
|
||||
## Channels
|
||||
|
||||
| Channel | Type | Description | Read/Write | Description |
|
||||
|-----------------------|--------|---------------------------------|------------|----------------------|
|
||||
| color | Switch | On / Off | RW | Power On / OFF |
|
||||
| | Color | HSB (Hue Saturation Brightness) | RW | |
|
||||
| | Dimmer | Brightness Percentage | RW | |
|
||||
| color-temperature | Dimmer | Color Temperature Percentage | RW | |
|
||||
| color-temperature-abs | Dimmer | Color Temperature Absolute | RW | in 2000-9000 Kelvin |
|
||||
|
||||
Note: you may want to set Unit metadata to "K" when creating a color-temperature-abs item.
|
||||
|
||||
## UI Example for one device
|
||||
|
||||
|
||||
|
||||
Thing channel setup:
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
```java
|
||||
UID: govee:govee-light:33_5F_60_74_F4_08_77_21
|
||||
label: Govee H6159 RGB Light Strip H6159 (192.168.178.173)
|
||||
thingTypeUID: govee:govee-light
|
||||
configuration:
|
||||
deviceType: H6159
|
||||
wifiSoftwareVersion: 1.02.11
|
||||
hostname: 192.168.162.233
|
||||
macAddress: 33:5F:60:74:F4:08:66:21
|
||||
wifiHardwareVersion: 1.00.10
|
||||
refreshInterval: 5
|
||||
productName: H6159 RGB Light Strip
|
||||
channels:
|
||||
- id: color
|
||||
channelTypeUID: system:color
|
||||
label: Color
|
||||
description: Controls the color of the light
|
||||
configuration: {}
|
||||
- id: color-temperature
|
||||
channelTypeUID: system:color-temperature
|
||||
label: Color Temperature
|
||||
description: Controls the color temperature of the light from 0 (cold) to 100 (warm)
|
||||
configuration: {}
|
||||
- id: color-temperature-abs
|
||||
channelTypeUID: govee:color-temperature-abs
|
||||
label: Absolute Color Temperature
|
||||
description: Controls the color temperature of the light in Kelvin
|
||||
configuration: {}
|
||||
```
|
||||
|
||||
## Additional Information
|
||||
|
||||
Please provide any feedback regarding unlisted devices that even though not mentioned herein do work.
|
||||
|
|
@ -0,0 +1,32 @@
|
|||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<thing:thing-descriptions bindingId="govee"
|
||||
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">
|
||||
|
||||
<thing-type id="govee-light">
|
||||
<label>Govee Light</label>
|
||||
<description>Govee light controllable via LAN API</description>
|
||||
|
||||
<channels>
|
||||
<channel id="color" typeId="system.color"/>
|
||||
<channel id="color-temperature" typeId="system.color-temperature"/>
|
||||
<channel id="color-temperature-abs" typeId="color-temperature-abs"/>
|
||||
</channels>
|
||||
<config-description-ref uri="thing-type:govee:govee-light"/>
|
||||
</thing-type>
|
||||
|
||||
<channel-type id="color-temperature-abs">
|
||||
<item-type>Number:Temperature</item-type>
|
||||
<label>Absolute Color Temperature </label>
|
||||
<description>Controls the color temperature of the light in Kelvin</description>
|
||||
<category>Temperature</category>
|
||||
<tags>
|
||||
<tag>Control</tag>
|
||||
<tag>ColorTemperature</tag>
|
||||
</tags>
|
||||
<state min="2000" max="9000" pattern="%.0f K"/>
|
||||
</channel-type>
|
||||
|
||||
|
||||
</thing:thing-descriptions>
|
||||
Loading…
Reference in New Issue