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
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 :)
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
-
DC/DC converter 12 -> 5 V (~2.65 € for bundle of 5pcs)
Choose 5V version, also ensure you get right one. in case of bigger voltage, you will pass too high voltage to AC UART and risk to damage it
(https://www.aliexpress.com/item/1005008257960729.html) -
ESP32 30 pin (~4.40 €)
-
Connector (4P, 10cm/20cm) (~3.00 € for bundle of 5pcs, https://www.aliexpress.com/item/1005006294406922.html)
-
Board (4x6, needs to be trimmed a little bit) (~2.00 € for bundle of 5pcs, https://www.aliexpress.com/item/1005007024264426.html)
-
Logic level converter (~2.50 € for bundle of 5pcs, https://www.aliexpress.com/item/1005006968679749.html)
-
Total parts cost for a dongle:
- ~ 15.00 € (if you build one)
- ~ 6.50 € each (if you build 5)
You can also crimp your own plug (Connector PAP-04V-S, pins to crimp: SPHD-002T-P0.5) <- very time consuming if you do not have right tools for it.
!!! 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 |
|
|
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)
Pinout for USB style socket:
Pin 1 - 12v
Pin 2 - AC_TX - 16 pin
Pin 3 - AC_RX - 17 pin
Pin 4 - GND
LED's connection (optional, resistors must be choosen according your leds)
- Download Arduino IDE (I used 2.3)
- File -> Preferences -> Additional boards manager URLs: http://arduino.esp8266.com/stable/package_esp8266com_index.json
- Download required libraries:
- this library - FujitsuAC (Benas09)
- PubSubClient 2.8 (Nick O'Leary)
- Open Arduino IDE -> File -> Examples -> FujitsuAC -> Controller
- 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
- When controller boots up, it will create access point faircon-uniqueId (default password is faircon9)
- Connect to this access point with your computer/mobile phone
- Go to 192.168.1.1
- Fill in WiFi, MQTT credentials, name your device and click Submit. (Device password will be used in OTA updates and WiFi AP)
- Dongle will reboot and connect to your wifi network.
- If everything is ok, new AC device should appear in HomeAssistant MQTT integration
- Open Arduino IDE
- File -> Examples -> FujitsuAC -> Controller
- 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
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
- 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"
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:
- Credentials are not filled in yet
- Unable to connect to WiFi for 60 seconds
- Unable to connect to MQTT for 60 seconds
- 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.
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.
- 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.
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
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.
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
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.
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.
By manufacturer design, this option will not be available when using a multi-split system (multiple indoor units connected to one outdoor unit).
- 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
These community projects are built on top of this library and are maintained independently.













