Olimpia Splendid Unico — Local control integration (BLE pairing + TCP)

Share your Projects! Custom Integrations
,
1

Hi everyone,

I’d like to share a custom integration I built for Olimpia Splendid Unico air conditioners.

Why

I’ve owned an Olimpia Splendid Unico Pro (with B1015 WiFi board) for about 3 years. These units have no native Home Assistant integration, no cloud API, no Alexa/Google Home support — the only way to control them remotely is through the dedicated “Olimpia Splendid Unico” app. I got tired of that limitation and couldn’t find any existing solution, so I decided to build one.

What it does

The integration provides full local TCP control (no cloud) with these features:

  • HVAC modes: Heat, Cool, Dry, Fan Only, Auto
  • Fan speed: Low, Mid, High, Auto
  • Swing control (on/off)
  • Target temperature & room temperature reading
  • Automatic reconnect and keepalive
  • BLE setup flow directly from the HA config UI: scan for the device, enter the PIN printed on the unit, complete ECDH pairing, configure WiFi — and the integration discovers the device IP automatically
  • Manual IP setup also available if you’ve already paired via the standalone CLI

How I built it

I want to be transparent: I’m a developer, but I honestly wouldn’t have tackled a project like this on my own — reverse-engineering a proprietary BLE pairing protocol and TCP control protocol from an APK is not something I’d have jumped into without help. I used Claude (Anthropic’s AI) extensively throughout the process: analyzing the decompiled APK, figuring out the protocol, and writing the integration code. Claude was an essential tool in making this happen. That said, all the testing and validation was done against my real device over a few days of focused work.

Compatibility

Tested on Olimpia Splendid Unico Pro with B1015 WiFi board. It should work with all Unico models that use the same B1015 board and the same app (Olimpia Splendid Unico v1.0.9 by Codermine).

If you have a different Unico model with the B1015 board, I’d love to hear if it works for you.

Installation

Available via HACS as a custom repository:

  1. Open HACS → three-dot menu → Custom repositories
  2. Add https://github.com/Daneel87/ha-olimpia-splendid-unico (category: Integration)
  3. Search for “Olimpia Splendid Unico” and install
  4. Restart HA → Settings → Devices & Services → Add Integration → search “Olimpia Splendid Unico”

Requirements: HA 2024.8.0+, device on the same LAN (TCP port 2000), Bluetooth adapter for BLE setup.

Tip: After BLE pairing and WiFi setup, it’s recommended to assign a static IP to the device via your router’s DHCP reservation. This prevents the IP from changing and the integration losing contact with the unit.

Links

I hope this can be useful to someone — I couldn’t find any other solution out there for these units. Feedback and bug reports are welcome!