openhab-addons/bundles/org.openhab.binding.bluetooth.govee

Govee

This extension adds support for Govee 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

1. Available to both goveeHygrometer and goveeHygrometerMonitor thing types.
2. In °C
3. 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

1. Available to both goveeHygrometer and goveeHygrometerMonitor thing types.
2. 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" }