This page is part of archived documentation for openHAB 3.3. 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
  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" }