govee_btled_windows

A re-implementation of Christian Volkmann's govee_btled wrapper but with Windows compatibility.

This wrapper supports controlling the Govee/Minger H6001 Smart LED Light Bulb.

Installation

Use pip to install:

pip install -U git+https://github.com/kabyru/govee-btled-controller

Platform Support

This wrapper accomplishes Windows compatibility by re-implementing the govee_btled package to use the Bleak GATT client software. PyGATT is not compatible with most Windows machines' Bluetooth interfaces, and requires an external BGAPI compatible device. Bleak is platform-agnostic and can use any Windows Bluetooth interface as it uses the UWP Bluetooth Stack.

This software should be compatible with any platform that supports Bleak, which are listed by Bleak as:

• Supports Windows 10, version 16299 (Fall Creators Update) or greater
• Supports Linux distributions with BlueZ >= 5.43
• OS X/macOS support via Core Bluetooth API, from at least OS X version 10.11
• Android backend compatible with python-for-android

Usage

See __main__.py for a full example in action.

import time
from govee-btled-controller import BluetoothLED
import asyncio

async def main():
    # Replace this with your LED's MAC address
    led = BluetoothLED('XX:XX:XX:XX:XX:XX')
    await led.init_and_connect()
    await led.set_state(True)
    await led.set_color_white(-.55)
    time.sleep(.5)
    await led.set_color('orangered')
    await led.set_brightness(.7)

loop = asyncio.get_event_loop()
try:
    loop.run_until_complete(main())
finally:
    loop.close()

Also included...

On the root of the repo, there are two additional Python scripts:

• govee_payload_generator.py generates the 20 bytes long payload that would be sent to the bulb via BLE. Useful for troubleshooting.
• search_btle.py returns a dict of MAC Addresses and Device Names of the devices of interest given a search phrase. Useful to integrate into programs where you do not know the MAC Address of the BLE devices you want to interact with (e.g. a room full of Govee bulbs...) To use this, simply call print(my_funcs.search_btle("minger"))

Reverse Engineering of H6001 BLE Packets

Have a look here for how the BLE packets that control the state of the LED bulb were reverse engineered.