Govee H5xxx Bluetooth Client
A library to listen for the BLE (Bluetooth Low Energy) broadcasts from Govee Thermometer Hygrometer devices. Requires a compatible bluetooth module and operating system (see prepequisites).
Supported devices:
- H5072
- H5074
- H5075
- H5100
- H5101
- H5102
- H5179
Installation
npm install govee-bt-client
API
startDiscovery: (callback: (reading: GoveeReading) => void)- Starts listening to broadcasts and pass decrypted data into the callback function.
stopDiscovery()- Stops listening to broadcasts from Bluetooth
debug: (on: boolean)- Function to enable debugging of bluetooth advertisements and peripherals.
Example
import { startDiscovery, stopDiscovery, debug } from "./index";
debug(true);
console.log("=== start discovery");
startDiscovery((reading) => {
console.log(reading);
});
setTimeout(async () => {
await stopDiscovery();
console.log("=== stop discovery");
}, 30000);
Credits
Credits and thanks to
- Thrilleratplay/GoveeWatcher for explanation and examples of how to decode advertisement data for Govee H5075.
- Home-Is-Where-You-Hang-Your-Hack/sensor.goveetemp_bt_hci for explanation and examples of advertisement data for various Govee devices.
- @abandonware/noble for a great BLE library for node.
- andrewjbates and eharris for triaging and developing an algorithm to parse H5075 data below 0 degrees Celsius.