Home Assistant Tapt

Home Assistant integration for Tapt

Installation

Available on HACS:

Usage

Tapt communicates with Bluetooth advertisments.

The integration will autodiscover devices with the appropriate advertisment metadata. After installing it, either press the button or turn it off and on to trigger autodiscovery.

Entities provided:

• Button press: Event
• Battery level: Sensor (measured in volts)
• MAC address (hardware address set in nRF chip)
• Tapt Device ID (set in firmware config, unused as of now)

The Home Assistant device ID is based on the MAC.

Discovery

Home Assistant discovery config:

• manufacturer_id: 0x59 - Nordic Semiconductor (underlying chip)
• manufacturer_data_start: [65, 84] - ASCII codes for 'A' and 'T'. (TA but backwards). Used as a magic at the start of the manufacturer data.

{
    "connectable": false,
    "manufacturer_id": 89,
    "manufacturer_data_start": [65, 84]
}

Development

Development is done in a Home Assistant devcontainer:

$ devcontainer up --workspace-folder .
$ devcontainer exec --workspace-folder . scripts/develop