Skip to content
Benas09Public

About

Local Fujitsu AC integration to HomeAssistant. Alternative for FGLair and Airstage

Resources

Stars

121 stars

Watchers

4 watching

Forks

Latest commit

 

History

201 Commits

Folders and files

Repository files navigation

FujitsuAC | faircon

Fujitsu AC Wifi controller.

This library reverse-engineers parts of the communication used by Fujitsu air conditioners, including those using the FGLair® mobile app.

FGLair is a registered trademark of Fujitsu General Limited. This project is not affiliated with or endorsed by Fujitsu. FGLair® app is not required when using this integration - everything runs local here.

This library can be used to replace these dongles:

  • UTY-TFSXW1
  • Z series
    • UTY-TFSXZ1 (confirmed. For: Europe)
    • UTY-TFSXZ2 (not confirmed yet. For: North America, Australia, New Zealand, Thailand, India, Singapore)
    • UTY-TFSXZ4 (not confirmed yet. For: China)
  • F series
    • UTY-TFSXF1 (not confirmed yet. For: North America)
    • UTY-TFSXF2 (not confirmed yet. For: Europe)
    • UTY-TFSXF3 (confirmed. For: Oceania)
  • H Series:
    • UTY-TFSXH4 (not confirmed yet. For: USA, Canada (sold as direct replacement for FGLair UTY-TFSXF1)
    • UTY-TFSXH3 (not confirmed yet. For: every other regions)

Tested aircons list: #24

Support

If you find this project useful, you can support its development here.

Or you can purchase ready-to-use dongle.

If you have any questions or want to purchase multiple dongles you can contact me via email benas.rag@gmail.com

Or you can build it yourself - you will find instructions below :)

Screenshots

HomeAssistant Integration (MQTT Autodiscovery)

Credentials page

This page is available at 192.168.1.1 when connected to the access point created by the dongle, when no config saved yet, or impossible to connect to WiFi

Building the module

Required parts

Connection

!!! IMPORTANT !!!

Do not connect anything from air conditioner to external device, like your computer. If you touch AC GND with, lets say laptop GND, it will fry your laptop USB port and/or AC mainboard fuse. AC pins are not galvanically isolated and these voltages are not relative to earth GND.

JST Type wiring USB Type wiring
Pins from left to right 1 2 3 4 Circuit for JST type connector

JST-type wiring

 AC Socket       CN3903                 ESP32
1 (+12V) ------> V in+ ---> V out+ ---> 5V
2 (GND)  ------> V in- ---> V out- ---> GND
3 (DATA) -----------------------------> RX/16 (AC -> ESP)
4 (DATA) -----------------------------> TX/17 (AC <- ESP)

USB-type wiring

Pinout for USB style socket:
Pin 1 - 12v
Pin 2 - AC_TX - 16 pin
Pin 3 - AC_RX - 17 pin
Pin 4 - GND

USB Pinout from top to bottom

LED's connection (optional, resistors must be choosen according your leds)

Uploading the code first time

  1. Download Arduino IDE (I used 2.3)
  2. File -> Preferences -> Additional boards manager URLs: http://arduino.esp8266.com/stable/package_esp8266com_index.json
  3. Download required libraries:
    • this library - FujitsuAC (Benas09)
    • PubSubClient 2.8 (Nick O'Leary)
  4. Open Arduino IDE -> File -> Examples -> FujitsuAC -> Controller
  5. Select your ESP32 board:
    • Choose your board type Tools -> Board -> esp32 -> ESP32 Dev module
    • Choose your port Tools -> Port -> /dev/ttyUSB0 (or similar)
    • Sketch -> Upload using programmer (when uploading from MAC, you have to set upload speed to lowest - 460800, otherwise you will get an error while uploading)

Additional button can be used for credentials reset functionality - uncomment RESET_BUTTON and set to corresponding pin. When you press this button (pull corresponding pin to GND) - controller deletes given credentials, reboots and goes to point

Configuring credentials

  1. When controller boots up, it will create access point faircon-uniqueId (default password is faircon9)
  2. Connect to this access point with your computer/mobile phone
  3. Go to 192.168.1.1
  4. Fill in WiFi, MQTT credentials, name your device and click Submit. (Device password will be used in OTA updates and WiFi AP)
  5. Dongle will reboot and connect to your wifi network.
  6. If everything is ok, new AC device should appear in HomeAssistant MQTT integration

OTA Update

  1. Open Arduino IDE
  2. File -> Examples -> FujitsuAC -> Controller
  3. Select your ESP32 board:
    • Choose your board type Tools -> Board -> esp32 -> ESP32 Dev module
    • Choose your port Tools -> Port -> Network ports -> "YourDongleName at your-dongle-ip" (disappears time by time, so wait or reload Arduino IDE to apear again)
    • Sketch -> Upload

Network update

Since 1.1.6 one-click network update is available. The dongle checks for new version every 24 hours (and immediately after reboot). To update, just click "update firmware" button in HA and wait.

Chip list for prebuilt firmwares:

  • ESP32
  • ESP32-S3
  • ESP32-C3
  • ESP32-C6
  • others will ignore update request
Network update (latest, or exact version)
  • mosquitto_pub -h 192.168.1.100 -t fujitsu/uniqueId/set/update_firmware -m "latest"
  • mosquitto_pub -h 192.168.1.100 -t fujitsu/uniqueId/set/update_firmware -m "tags/1.4.11"

DIY Module (Logic level shifter is not included here yet)

FAQ

Dongle configuration page

This page is used to setup your dongle. You can access this page by going connecting to access point created by the dongle and going to 192.168.1.1. Access page is created in these scenarios:

  1. Credentials are not filled in yet
  2. Unable to connect to WiFi for 60 seconds
  3. Unable to connect to MQTT for 60 seconds
  4. Unhandled error occured and the dongle reboot reason was PANIC

In 1st case AP is active until credentials will be saved, otherwise AP is active for 5 minutes. Then the dongle reboots and starts WiFi connection again. All saved credentials are still stored (except 1st case), just they are not shown to prevent exposing them.

Does the dongle disables the use of other controllers?

Product has been tested with IR and wall controller (UTY-RLRY). Functionality of these controllers remains available when using the dongle. IR is a one-way channel without feedback where UTY-RLRY is two-way and displays changes made by the dongle.

How can I reset the dongle configuration?

  • ready-to-use has a small hole in the enclosure. Click the button through that hole with a toothpick and all credentials will be cleared.
  • When building DIY dongle, you have to attach a button to the RESET_BUTTON pin to use that feature.
  • In HomeAssistant's device configuration page you can click "clear_credentials" button.

What do the LED statues mean?

When building DIY dongle, you have attach LEDS to the correspinding pins (Red - 19, White - 18 for esp32) that feature.

  • Only red blinking - connecting to wifi
  • Only red shining - AP is created
  • Red + White shining - connected to wifi and mqtt

I'm missing some features to control my AC.

The dongle reads the AC information and only displays available options. When you believe you are missing options, please create an issue and post your logfile.

How to collect a logfile?

‎SSH to your MQTT setup and use these commands.

  • mosquitto_sub -h 192.168.1.100 -t fujitsu/# -v for all your dongles
  • mosquitto_sub -h 192.168.1.100 -t fujitsu/80f3dabb15f0/# -v for exact one, just change with your unique id

The total number of swing positions is incorrectly displayed.

There is a registry which reports how many louver grille positions available. When you believe number of positions are incorrect, please send us your logfile. You'll be able to override the displayed value in a future release.

What does energy_saving_fan option do?

Power saving function to control the indoor unit fan rotation when the outdoor unit is stopped during cooling operation. Enabled, the indoor fan operates intermittently at a very low speed when outdoor unit is stopped.

I'm missing the OutdoorUnitLowNoise feature

By manufacturer design, this option will not be available when using a multi-split system (multiple indoor units connected to one outdoor unit).

Available dongle status messages

  • MqttBridge started (connected to mqtt and HA configuration started)
  • Init1 Send - first stage of handshake between esp and aircon
  • Init2 Send - second stage of handshake between esp and aircon
  • Running - handshake successful and communication is running
  • Updating - when updating through network started

Other Integrations

These community projects are built on top of this library and are maintained independently.

ESPHome

HomeKit

About

Local Fujitsu AC integration to HomeAssistant. Alternative for FGLair and Airstage

Resources

Stars

121 stars

Watchers

4 watching

Forks

Releases

Contributors

Languages