Airtouch 4 integration (AUS)

Similar to this request but version 4:

Already integrates with IFTTT and Google Home / Alexa but native HA integration would be awesome.
https://www.polyaire.com.au/products/control-systems/airtouch-4/

Airtouch 4 is also mentioned here: Polyaire Air Touch 2 or 3 with someone already having built an integration with HOOBS
https://github.com/mihailescu2m/homebridge-airtouch4-platform

And because I can only put two links in each post:
https://plugins.hoobs.org/plugin/homebridge-airtouch4-platform

Hey @andy_vdg - I too am interested in whether this can be done for HA. I did manage to get hold of the API manual… :slight_smile: can provide via PM if your or anyone else is interested in giving it a go. Will probably try myself when I get the chance.

Hi all,

I just got an Airtouch 4 recently and have been really keen to see it integrated with home assistant - never contributed to an open source repository or otherwise before but thought I would give it a crack - so far I have managed to get a python library built which should hopefully be able to be added to a home assistant integration once I work out how! If anyone else is keen to give it a go heres the link: https://pypi.org/project/airtouch4pyapi - I have been using it fine with my Airtouch 4 but if anyone is feeling brave would be great to get some verification it works on other people’s systems (please don’t blame me if anything breaks, its just using their TCP Api doco!)

1 Like

@LonePurpleWolf Thanks for sharing this. I know AC but coding not so much, so I’m glad someone else could make sense of the API.

I’m trying to test this on my system by adding https://github.com/LonePurpleWolf/airtouch4pyapi as a repository in my add-ons page, but I get an error “Not a valid add-on repository”.

Any tips?

@Paulbunyan Thanks for trying to have a look at it! You won’t actually be able to use it as an addon yet, as the repository I linked is just for a python library to be able to interact with the AirTouch 4 (via code) - I haven’t got around to using the library in a Home Assistant Integration just yet - I am hoping to make some headway in the next couple of weeks. Maybe someone else might be able to advise but I also think that addons (which are perhaps hass.io oriented?) are different to Integrations, but not too sure about what the difference is (very new to home assistant myself!)

I have attempted to make an integration pull request for this feature: https://github.com/home-assistant/core/pull/43513 - I feel way out of my depth, so if anyone has any experience with integrations and can help me with any bits I have missed, please let me know!

Hi would you know if this works for the Airtouch 2+ https://www.airtouch.net.au/airtouch/airtouch-2-plus/

Would you help me test it please?.

What would be the easiest way to test your python script to see if I can connect?
The Airtouch 2+ uses port 9200 from what I can tell.

Hi @Selmak ,

The python API doesnt allow configuration of the port as of now (as from what I can tell the AirTouch 4 doesn’t allow port configuration). Also other than basic functionality most of the functionality is designed around the assumption that you are using the ITC (individual temperature control) sensors, as Climate entities in home assistant work with temperature targets. I believe some other integrations use cover entities to represent non-temperature controlled aircon zones so this is something that could be added down the track.

I would recommend contacting AirTouch via their support email and asking them if they have a TCP api for the AirTouch 2+ - I can tell you from looking at that document whether they are the same or not - if you want to try using the python API against your AirTouch 2+ regardless, you would have to download it from the github link, manually change port 9004 to port 9200, then run it up and try it out. It would be pretty awesome if they did work the same!

Thank you I have contacted Polyaire asking for the api Guess I will wait and see.

I found this thread about the airtouch 4 https://forums.homeseer.com/forum/homeseer-products-services/general-discussion-area/1318292-expert-opinion-please-a-c-integration-document-direct-api-control

It seems the API doesn’t work for the airtouch 2+.

When I tried a few commands status/ turn off I got no response. I did notice when I left the command running I did get a reply once I opened the app on my phone and changed a setting. So I guess I have the right port at least.

Hi @LonePurpleWolf

I managed to get the api AirTouch 2 Plus would you be willing to have a look at adding support ?

Thanks!

Hi @Selmak

Looks very similar to the AirTouch 4 api in terms of the way it works - the approach that other AC systems have taken with non-temperature controlled zones seems to be by using ‘covers’ to represent the percentage opening for a zone - so first I would have to look at implementing support for non-temperature controlled AirTouch 4 zones using covers, and then we could look at making something that also supported airtouch 2 plus as covers. Still waiting on the core repo owners to approve my first pull request, so I’m waiting for that to go through before I do any more!

Hi @LonePurpleWolf

Thanks for replying and having a look mate appreciate it.

How are people finding the AirTouch systems? Considering grabbing one but would be keen to hear some opinions!

I love my AirTouch 4. It has most of the features I was looking for in a control unit. I run a few others apps on the controller such as Spotify and HA. I’m looking at adding a second controller so I can have one at the front end of the house. I have temp sensors in each zone, which makes a big difference.

Wish there was better integration with HA so I can use door and window sensors, together with my weather station to control zones etc. Currently working on an automation which tells me when outside temp is cooler than inside. Also playing around with IFTTT with AirTouch and webhooks into HA to try and get things working together.

1 Like

I also really like mine but this is also my first ducted A/C system (so I can’t really compare). I like having an app I can control the A/C with (either when I’m out or just around home). The UI is ok, could probably use some polishing but works well. I’ve got it set up (via Nabu Casa Home Assistant Cloud) to integrate with my Amazon Echos. I feel like the missing piece for my home setup is this integration so I’m watching it with keen interest!

1 Like

This will definitely make it a must have purchase - at least things look promising. I may bite the bullet still as having some app integration is better than none (right now I don’t even have a remote!). Thanks for the quick responses.

Am looking forward to this integration. Thanks for all your hard work @LonePurpleWolf

Do you have a view of when this is expected please?

Hi @mattnz

Unfortunately, I haven’t heard back from the repository reviewers since last year! Unfortunately I have no idea or control at this stage of how long/when/if. In the meantime, if you’re tech savvy, you can check out my branch and copy/paste the changed files into your home assistant installation - I’ve been running it this way while I’ve been waiting!