External integration - Faikout

Development
1

Hello everyone,

I present to you a new external integration for Gladys Assistant: Faikout.

It connects Gladys to Daikin air conditioners equipped with a Faikout module (formerly Faikin). This small open-source ESP32 module, designed by RevK, replaces the original Wi-Fi module of the air conditioner.

:backhand_index_pointing_right: Everything stays on your network: no Daikin cloud, no account, no Internet.

:sparkles: What it does

Each air conditioner becomes a Gladys device with:

  • On/off, mode (auto, cold, heating, dehumidification, ventilation)
  • Setpoint and fan speed (auto, silent, 1 to 5)
  • *Horizontal and vertical swing
  • Econo, Powerful, Comfort, Streamer, outdoor unit silent modes
  • Measurements:
    • room temperature and outdoor temperature
    • air intake and refrigerant temperatures
    • humidity
    • power consumed (W)
    • energy meter (kWh)

The integration only creates what your air conditioner actually reports: a function not present in your model does not appear.

:high_voltage: Energy tracking

If the air conditioner reports its energy meter, it appears in the Energy page of Gladys:

  • consumption per half-hour, calculated by Gladys;
  • cost, according to your electricity contract;
  • association with your main meter.

:warning: In multi-split (several indoor units on a single outdoor unit), the meter is that of the outdoor unit: check that it is not counted twice.

:clapper_board: Scenes

Triggers

  • An air conditioner disconnects or comes back (Faikout unreachable, or air conditioner no longer responding to the module)
  • An air conditioner is modified outside of Gladys: remote control, Faikout web page, timer
  • An air conditioner starts or finishes defrosting

Actions

  • Set an air conditioner: on/off, mode, setpoint, and fan speed all at once
  • Set Faikout auto: the module keeps the room between target − margin and target + margin
  • Read an air conditioner: a fresh reading, usable in the rest of the scene

Example: « If the living room air conditioner is turned on with the remote after 11 p.m., switch it to silent ventilation. »

:bar_chart: Dashboard widgets

  • Faikout Air Conditioner: live tiles (room, setpoint, outdoor, power), temperature curve over 24 hours, status, mode, fan speed, On/Off and Refresh buttons.
  • Faikout Overview: all your air conditioners on a single map.

Each device also has a badge:

Badge Meaning
Local Everything responds
Local + orange dot The Faikout responds, but not the air conditioner (S21 / X50 cable?)
Unreachable The Faikout does not respond

:hammer_and_wrench: Installation

Prerequisites

  • Gladys 5.1 or newer
  • A Faikout module installed and connected to your Wi-Fi (installation manual)
  • A fixed IP address for each module (DHCP reservation on your box)

Configuration

  1. Install the Faikout integration from the Gladys integrations catalog.

  2. In Configuration, list your units, separated by commas:

    Living Room=192.168.1.50, Bedroom=192.168.1.51

  3. If you have set a web password on the Faikout, enter it (the same for all units).

  4. Click Test connection: each unit indicates its model, protocol, mode, and temperature.

  5. Open the Discovery tab and create the proposed devices.

:light_bulb: Prefer the IP address to names in .local: they are often poorly resolved from the container.

:locked: Privacy

  • The integration only talks to the addresses you give it, in local HTTP and WebSocket.
  • It only keeps, in its /data volume, the MAC address, name, model, and list of functions of each unit.

:link: Links

Your feedback interests me: air conditioner model, protocol (S21, X50A
), bugs, ideas. Open an issue on GitHub or reply here. Thank you! :folded_hands: