Airtouch 4 integration (AUS)

@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!

1 Like

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!

Thanks @LonePurpleWolf

I didn’t even think of extracting the component out of the pull request and adding it as a custom component - just did it and got it installed. Thanks for the suggestion!

I’m heading away for a week so will properly test once I’m back

@LonePurpleWolf this works great. Been using it for a bit now. For those interested, I have placed all the airtouch files into a custom-components/airtouch4 folder and it works great.

Do you see a way to get the % based reading for each area? Not sure how this would work with a climate entity but I have a few use cases where I would like to manually control the % open as opposed to room set point.

@jlich glad it is working for you! In regards to percents, a little further above in this thread I think someone else brought that up - the way that other climate control plugins handle this is by exposing a ‘cover’ entity for each zone which can be incremented in 5% increments. All the information and server calls to do this are mostly supported by the python plugin, so the only thing left would be to create climate entities in the AirTouch plugin…

The dev guidelines on integrations explain (i think) that if you’re adding a new integration, you should only be adding one type of entity - so I have been waiting until the initial integration request gets approved before going back in and changing it.

Another thing that I’m not happy with is that I’ve put the climate controls (eg. hot, cold) on each zone, however with AT4 the climate control setting is actually at the AC level - so I’d like to give the option to people to have an AC entity as well to handle the climate setting and then control the temps/percents on the individual zones. But again I have held back in the interests of getting the pull request approved.

I’m interested in any update for this.

I tried copying the files (via VScode) into the Config folder as suggested, but no-go. (I assume seeing I can’t download the files in the normal way it is copy from raw into VSC and then save???)

Are there any mods required - IP address etc???

I got this integration working. It’s great, thank you for all the hard work. It would be great if there was an entity for the fan speed and mode. Leaving each zone as a temp and zone control.

It took me a bit to work out what to do once I had added the files as a custom_component. It was as simple as selecting +Add Integration from the configuration/intergrations screen.

1 Like

I copied the 5 files from https://github.com/LonePurpleWolf/airtouch4pyapi, thanks @LonePurpleWolf !

__ini __.py
airtouch.py
communicate.py
helper.py
packetmap.py

into custom_components/airtouch4

But it didn’t add an option to add integrations.

Could anyone point me in the right direction here… i’m pretty new to this. Just got my air con installed and I’d love to get the home assistant side of it working. I’m hoping to be able to log oom tempeatures as well as use automations and generally just have my entire house run of home assistant.

Eventually planning to run the HA UI on the airtouch controller so i can controll the entire house from the tablet as well as phone.