[RELEASE] Pioneer and others Mini-Split Local Control (Tuya Protocol)

Custom Apps and Drivers Custom Drivers
1

I've created a native Hubitat driver for local control of Pioneer WYT (Diamante) mini-splits and potentially other Tuya-based mini-split systems.

GitHub: GitHub - signal15/tuya-minisplit-hubitat: Local control of Pioneer WYT (Tuya) mini-split heat pumps via Hubitat

What This Is

This driver communicates directly with your mini-split over your local network - no cloud, no bridge service, no external dependencies. It implements the Tuya protocol natively in Groovy.

Important: This Is For Tuya Protocol Units Only

Many Pioneer mini-splits (like the WYS series) use the Midea protocol - this driver does NOT support those. This driver is specifically for units that use the Tuya protocol, which includes:

Confirmed Working:

  • Pioneer WYT (Diamante) series with TST-DIAWIFITPD WiFi module

May Also Work (same Tuya protocol):

  • Cooper & Hunter (Sophia, MIA, Olivia, Dakota, Hyper Heat series)
  • Confortotal CICON series
  • Royal Sovereign RSAI series
  • Kaisai Pro Heat+ series
  • Rotenso Roni series
  • Tesla Smart TAF/AUX series
  • Be Cool BC series

How to tell if yours is compatible: If your mini-split uses the Tuya Smart or Smart Life app (not an IR blaster), it probably uses this protocol. The Pioneer app seems to be a rebrand of the Tuya app also.

Installation

HPM (Hubitat Package Manager):

I've submitted this to HPM but it may not be approved yet. In the meantime, you can install via URL:

  1. Apps → Hubitat Package Manager → Install → From a URL
  2. Enter: https://raw.githubusercontent.com/signal15/tuya-minisplit-hubitat/main/hubitat/packageManifest.json

Manual:

  1. Drivers Code → New Driver → Import
  2. Enter: https://raw.githubusercontent.com/signal15/tuya-minisplit-hubitat/main/hubitat/pioneer-minisplit-local.groovy

Getting Your Local Key

This is the trickiest part. You need a Device ID, Local Key, and IP address.

  1. Pair your device with the Tuya Smart app (not Pioneer Airlink)
    - Download "Tuya Smart" from your app store
    - Add your mini-split to the app
  2. Create a free Tuya IoT developer account:
    - Go to https://iot.tuya.com and register
    - Create a Cloud Project (select your region, e.g., "Western America")
    - Choose "Smart Home" industry and "Smart Home PaaS"
  3. Link your app account:
    - In your Tuya IoT project: Devices → Link Tuya App Account
    - Open Tuya Smart app → Profile → scan the QR code
    - Your devices will appear in the IoT console
  4. Get the Local Key:
    - In Tuya IoT console: Cloud → API Explorer
    - Select: Device Management → Get Device Information
    - Enter your Device ID and click "Submit Request"
    - Copy the local_key from the response (16 characters)
  5. Find your device IP:
    - Check your router's DHCP client list, or
    - Use a network scanner to find devices listening on port 6668

Device Setup in Hubitat

  1. Devices → Add Device → Virtual
  2. Name it, select Type: "Pioneer Mini-Split Local" or whatever you want to name it (Garage AC)
  3. Configure preferences:
    - Device IP: your mini-split's IP (you should do a DHCP reservation on it so it doesn't change)
    - Device ID: from Tuya IoT console
    - Local Key: the 16-character key
    - Protocol Version: 3.3 (try 3.4 if that doesn't work)
  4. Save Preferences, then click Refresh

Important: Tuya devices only allow ONE local connection at a time. KILL the Tuya Smart app on your phone before testing, or Hubitat won't be able to connect.

Features

  • Power on/off
  • Thermostat modes: cool, heat, auto, dry, fan only
  • Temperature setpoint (61-86°F)
  • Fan speed: auto, low, medium, high
  • Auto-reconnect on connection loss
  • Status polling (configurable interval)

My Use Case & Support Expectations

I built this primarily for on/off control to participate in a power company demand response program. The basic functionality works great for my needs.

If something beyond on/off doesn't work as intended for your setup, I'm happy to merge pull requests from the community. I may or may not have time to investigate issues that don't affect my use case, but I'll do my best to help where I can.

Credits

Let me know if you have questions or run into issues!

2

Great work.

Two Solar DC/AC Mini-splits one sold in the US under the name Airspool the other EG4 are both made by Deye. I have been told these have Tuya smarts in them and talk to Tuya's US server if you employ the respective App.

There is a WHOLE bunch of work done to facilitate control of Tuya based HVAC systems in the Home Assistant space so it's great to see a similar effort in the Hubitat arena.

Thanks, not sure this will be a slam dunk to implement...but it's hopeful !

EDIT ADD:

One of the things that the app for these dual power mini-splits presents is the use of solar vs mains power (Power Statistics). Wonder how easy that would be to add in.

EDIT OUT:

Removed some external video links showing the above mentioned data presented in the Tuya App.

3

Relevant progress in the same vein for these "Tuya-talkin" HVAC units.

"" The EG4 Hybrid Solar Mini-Split ships with a Tuya WBR3 WiFi+BLE module for cloud control via the Tuya/Smart Life app. While Tuya's cloud API and integrations like LocalTuya can control basic functions (power, mode, fan speed, temperature), they have significant limitations:

  • LocalTuya couldn't map all DPs the way we wanted for Home Assistant
  • The solar/energy data points are completely hidden from Tuya's cloud API and standard integrations
  • No flexibility in how entities are created in Home Assistant

This bridge connects directly to the device over your local network (no cloud dependency), reads all data points including the hidden ones, and publishes raw values to MQTT where you have full control over entity creation""

4

I’m looking to get this going on my Della Mini-Split. I can turn it on and off with the Tuya Dimmer Driver. Haven’t used MQTT at all. Would love to get this split working with Hubitat.

5

I think you will have some luck on the basic controls if you pursue OP's work and read the Home Assistant work he refers to for extra context. There has been A LOT of work on the Tuya controlled mini-split stuff in the HA environment.

Unfortunately for my needs it's the extra controls like Energy Saving Mode, and the real time energy data feed that will be missing as referred to in the EG4 mini-split excerpt above. May just go the Broadlink remote path for full control and skip the data. (Edit Add: did not go the IR Remote path, found it wasn’t as simple as replicating the IR Codes)

As an aside:
For anybody looking to cool a space where they can fit four 400+ watt solar panels nearby, these hybrid Deye units being sold in the US by AirSpool and EG4 really allow you to cut the cord while the sun is out.

6

Tried getting this working with my Della as well. Keeps failing: Session timeout at step2… so it connects to my device tries the send but nothing happens it seems - tried 3.1, 3.3, 3.4:

dev:5112026-05-31 11:19:31.160 AM debug Closing socket
dev:5112026-05-31 11:19:31.158 AM error No response after 5 retries
dev:5112026-05-31 11:19:30.871 AM error Session timeout at step2
dev:5112026-05-31 11:19:30.101 AM debug Sending: 000055….
dev:5112026-05-31 11:19:30.095 AM debug LocalKey length: 16, expected: 16
dev:5112026-05-31 11:19:30.023 AM debug Connecting to 172.16.0.67:6668
dev:5112026-05-31 11:19:30.021 AM debug Creating new session

7

Just leaving this link here for future reference. The folks over in the Home Assistant Community have really made some progress interfacing with the whole Tuya control on so equipped HVAC units.

Edit Add a good week later: For folks coming along and finding this thread. Know that Tuya MCU DPs and commands for the ACs they’re bundled with can be pretty different. That is to say Tuya hasn’t standardized this stuff to the degree you’d hope.

One simple example I’ve just uncovered that applied to my unit is the use of MID instead of MEDIUM for the middle fan setting. If you read the threads that apply in the HA Community you’ll eventually start to piece together what fits for the unit you are dealing with. I’ve discovered a few folks have reverse engineered (or sniffed) the DPs and come closer than others in identifying what works.

More Data Points for future reference

[Bug]: Add device profile for Solar AC (gpjca2vt) with solar monitoring support · Issue #770 · xZetsubou/hass-localtuya

https://github.com/rylincoln/eg4-heatpump/blob/main/reverse-engineering/PROTOCOL.md/

8

Just discovered a little different path to this info after NOT finding the “Device Management” on that selection list of APIs. The following replaced your second line on step 4 to get the Local Key

Select: IOT Core → Query Device Detials

9

FYI

image

10

@signal15 I assume I need a tuya hub?

Also, the tuya website has changed ALOT since your detailed instructions!

I am having a terrible time navigating and find the items you list.

Any clue as to where all the info is?

Thanks!