Skip to content

Tuya Zigbee mmWave Sensor

kkossev edited this page May 6, 2024 · 14 revisions

last edited 2024-05-06

  • Why a new driver?

As announced earlier, the size of the "Tuya Multi-Sensor 4 In 1" driver became too large, and it is impossible to add new devices to it. All the support for the mmWave sensors is now moved to this new drver.

Any improvements and new models will be added to this new driver only. The old 4-in-1 code is in the process of stripping down to support only the basic 'motion active' / 'motion inactive' events without any extra features. I must do this to free up code space for adding new Tuya PIR motion sensor models into the 4-in-1 driver. If someone accidentally updates the old 4-in-1 driver, there will be a warning and link to instructions on transitioning to the new mmWave sensors driver.**

  • Installation as a new driver

Please use the community Hubitat Package Manager (HPM) to install the new driver - search for 'Tuya Zigbee mmWave Sensor'. Once installed using HPM, please update to the latest development branch version manually.

  • MatchUp in HPM

If you have already installed this driver manually, do a 'MatchUp' in HPM. In case of problems, see this link.

  • Driver structure

To easily handle a dozen different Tuya mmWave sensors, all devices are described as static data structures called 'Device Profile.' When a detailed documentation (WIP) is available sometime in the future, it may become possible that the adding of new 'presence' sensors be done by experienced Hubitat users, with little or no knowledge of Groovy... (dreaming)

This is a rather complex driver, including several libraries that are shared with many other drivers that I wrote. To avoid the DLL hell, the driver is distributed as a single Groovy file, with all the libraries included.

  • Supported mmWave sensors

The currently supported mmWave sensors list is available in the second post in the Hubitat Community forum thread.

  • Configuration

    • If the driver was installed prior to pairing the new mmWave device, the configuration will be automatic.
    • If the driver was manually changed (upgrading from the 4-in-1 driver), the configuration should be automatic as well.
    • In a case you want to start fresh:
    1. Select 'LOAD ALL DEFAULTS' from the Configure command drop-down menu.
    2. Click on the 'Configure' button image

If the device is supported, it will be recognized automatically. This can be verified by checking the 'device profile' (after refreshing the web page!) image If the device profile is shown as 'UNKNOWN' - the fingerprint of your mmWave sensor is currently not in the driver. Please check the Troubleshooting section below for hints on how to proceed.

  • Current States

The 'Current States' in the device web page will show different attributes, depending on the particular type of your device.

image

  • Commands

  • State Variables

  • Troubleshooting

  • Adding new mmWave sensors models/manufacturers

... to be continued ...


back to https://github.com/kkossev/Hubitat/wiki

Clone this wiki locally