This page is part of archived documentation for openHAB 4.0. Go to the current stable version
# Govee
This extension adds support for Govee (opens new window) Bluetooth Devices.
# Supported Things
Only two thing types are supported by this extension at the moment.
Thing Type ID | Description | Supported Models |
---|---|---|
goveeHygrometer | Govee Thermo-Hygrometer | H5051,H5071 |
goveeHygrometerMonitor | Govee Thermo-Hygrometer w/ Warning Alarms | H5052,H5072,H5074,H5075,H5101,H5102,H5177,H5179,B5175,B5178 |
# Discovery
As any other Bluetooth device, Govee devices are discovered automatically by the corresponding bridge.
# Thing Configuration
Govee things have the following configuration parameters:
Thing | Parameter | Required | Default | Description |
---|---|---|---|---|
all | address | yes | The Bluetooth address of the device (in format "XX:XX:XX:XX:XX:XX") | |
all | refreshInterval | 300 | How often, in seconds, the sensor data of the device should be refreshed | |
goveeHygrometer1 | temperatureCalibration | no | Offset to apply to temperature2 sensor readings | |
goveeHygrometer1 | humidityCalibration | no | Offset to apply to humidity sensor readings | |
goveeHygrometerMonitor | temperatureWarningAlarm | false | Enables warning alarms to be broadcast when temperature is out of specified range | |
goveeHygrometerMonitor | temperatureWarningMin | 0 | The lower safe temperature2 threshold 3 | |
goveeHygrometerMonitor | temperatureWarningMax | 0 | The upper safe temperature2 threshold 3 | |
goveeHygrometerMonitor | humidityWarningAlarm | false | Enables warning alarms to be broadcast when humidity is out of specified range | |
goveeHygrometerMonitor | humidityWarningMin | 0 | The lower safe humidity threshold 3 | |
goveeHygrometerMonitor | humidityWarningMax | 0 | The upper safe humidity threshold 3 |
- Available to both
goveeHygrometer
andgoveeHygrometerMonitor
thing types. - In °C
- Only applies if alarm feature is enabled
# Channels
Govee things have the following channels in addition to the default bluetooth channels:
Thing | Channel ID | Item Type | Description |
---|---|---|---|
goveeHygrometer1 | temperature | Number:Temperature | The measured temperature |
goveeHygrometer1 | humidity | Number:Dimensionless | The measured relative humidity |
goveeHygrometer1 | battery | Number:Dimensionless | The measured battery percentage |
goveeHygrometerMonitor | temperatureAlarm | Switch | Indicates if current temperature is out of range. 2 |
goveeHygrometerMonitor | humidityAlarm | Switch | Indicates if current humidity is out of range. 2 |
- Available to both
goveeHygrometer
andgoveeHygrometerMonitor
thing types. - Only applies if warning alarms are enabled in the configuration.
# Example
demo.things:
bluetooth:goveeHygrometer:hci0:beacon "Govee Temperature Humidity Monitor" (bluetooth:bluez:hci0) [ address="12:34:56:78:9A:BC" ]
demo.items:
Number:Temperature temperature "Room Temperature [%.1f %unit%]" { channel="bluetooth:goveeHygrometer:hci0:beacon:temperature" }
Number:Dimensionless humidity "Humidity [%.0f %unit%]" { channel="bluetooth:goveeHygrometer:hci0:beacon:humidity" }
Number:Dimensionless battery "Battery [%.0f %unit%]" { channel="bluetooth:goveeHygrometer:hci0:beacon:battery" }
Caught a mistake or want to contribute to the documentation? Edit this page on GitHub (opens new window)