Skip to content

v1.15.4

Latest

Choose a tag to compare

@kattcrazy kattcrazy released this 02 Jun 07:25

Fixes

  • Fix compatibility issues that caused setup failures.
  • Update sensor/binary sensor entity-registry lookups to current APIs.
  • Fix Repairs platform registration with a valid no-op fix flow.

Tuya Quirks as of 2026.5.0

With Home Assistant core release 2026.5.0, Tuya quirks now enable users to edit, add, and map datapoints so their device is supported in the core intergration. That means that this custom intergration will be uneeded in the future once all the datapoints have quirks.

To help with the creation and collection of quirks for public use (🎉), please help out by doing the below instructions for any devices that are missing entities in the core Tuya intergration. You can put all the below info in an issue in tuya-device-handlers where some people like myself will help make a quirk. Once you've tested it and confirmed it works, a pull request can be created and hopefully merged to be used in the next core release. Then, you'll be able to use your device using the core intergration!

Contribute details for a quirk

Make an issue (template Feature Request) in the issues tab of tuya-device-handlers with the following debugging responses.

Tuya Dev Debug (don't have an account? see tutorial)

  1. Go to https://platform.tuya.com/ > cloud > project management > open project > devices
  2. Find your device and copy its ID
  3. Go to https://platform.tuya.com/cloud/explorer > device control > query properties
  4. Paste your device's ID and submit

When sharing this, please don't share the request url as it contains sensitive parameters.

Home Assistant Diagnostics

  1. Go the the core Tuya integration in your installation- not this intergration
  2. Navigate to your unsupported device
  3. Click download diagnostics
  4. Paste the diagnostics in the issue (don't upload the file if possible)

Testing a quirk

  1. Make the folder <config>/tuya_quirks/ in your Home Assistant directory
  2. Place the provided quirk file in that location, keeping the name the same
  3. Reload the core Tuya intergration
  4. Check your device for entities and confirm if they are correct

Tuya Developer API

Follow this guide until step 5 to see how to set up the API credentials

Thanks to @azerty9971 for the thorough guide