Vzduch Dotek

An API to interface with an AirTouch 3 AC controller.

Why Vzduch Dotek

Vzduch Dotek translates to Air Touch in Czech (naming is always hard). Now as to why do this? Because I want local control of my AC unit. I run Home Assistant and while AirTouch 3 has IFTTT support, IFTTT is not ideal. IFTTT is still in the cloud and on top of that there is no feedback from IFTTT if the action succeeded or failed. So when doing any automations in Home Assistant it only works most of the time. I have also created a Home Assistant custom component that wraps this api, but the Api is standalone and can be used with any interface.

Settings

The appsettings.json file contains a section for the AirTouch3 controller. You will need to provide the localhost and localPort of your AirTouch 3 unit`

  "airTouch": {
    "localHost": "192.168.80.21",
    "localPort": 8899
  }

Running

I used vscode to put this together. The default port the api runs on is 5353. Once you pull down the repo, you will need to update the appsettings.json file to match your home environment. Without setting the right ip address and port of the actual AirTouch 3 control unit this Api will not work. After that, you should be able to hit F5 (if running inside of vscode and then navigate to http://localhost:5353/api/aircons and get the current status of your AC. The build has been tested on Windows 10 and Linux (Ubuntu).

Changes

• 2024.06 - Add timeout logic when setting damper percentage
• 2024.05 - Update .net to v8. Improve error handling
• 2023.05 - Fix Setting Log Level. Clean up some code - Add new property to the ac response that tells us the number of zones with the temperature puks
• 2023.04 - Added a new Api aircons/{selectedId}/zones/{zoneId}/damper/{percentage}. Allows you to set the damper percentage. Percentage must be between 0 and 100% and divisible by 5. - Updated the .net version to .net 7.0

Home Assistant Addon

I have created an addon for this Api. This makes it easy to get up and running. See here

Running and Building Within Docker

CD into the source directory cd vzduch-dotek, edit appsettings.json, and run docker build -f Dockerfile -t vzduch-dotek .

Once built, you should be able to run it as any other docker container, including putting into a docker-compose file. An example to get you started:

---
version: "2.1"
services:
  vzduch-dotek:
    container_name: vzduch-dotek
    image: vzduch-dotek
    restart: unless-stopped
    ports:
      - 5353:5353

Examples

• Get current status: http://localhost:5353/api/aircons
• Switch aircon On: http://localhost:5353/api/aircons/0/switch/1
• Toggle aircon: http://localhost:5353/api/aircons/0/toggle
• Switch zone Off: http://localhost:5353/api/aircons/0/zones/0/switch/0

Front Ends

• Custom Control - I have developed a Home Assistant custom control. More information here.
• Homebridge - @L0rdCha0s has developed a homebridge plugin allowing you to control your AC via Homekit. More information here.

Limitations

There are many limitations. This code has been tested against one (yes just one) AirTouch 3 unit interfacing with a Daikin System reverse cycle ducted aircondition unit. It has not been tested with any other systems or combinations of. Please bear that in mind. Other limitations:

• AirTouch 3 supports controlling upto two AC units. Vzduch Dotek currently only supports controlling one AC unit.
• Setting Date / Time is currently not supported
• Setting passwords not supported
• Some temperature setting functionality not supported

Todo

I want to add some level of security. It is running locally but some sort of auth would not go astray. I also plan to add tests and finish working on setting the date and time. Plus more.