Skip to main content

An api allowing control of AC state (temperature, on/off, mode) of an Airtouch 4 controller locally over TCP

Project description

Airtouch 4 & 5 Python TCP API

An api allowing control of AC state (temperature, on/off, mode) of an Airtouch 4 controller locally over TCP. Airtouch 5 support is experimental as of 28 Nov 2022, and is fully interface compatible with AT4.

All you need to do is initialise and specify the correct AirTouchVersion (if you don't, it assumes 4).

Warning

I am using this with my own Airtouch 4 and see no issues. Please don't blame me if you have any issues with your Airtouch 4 or AC system after using this - I don't know much about AC systems and will probably not be able to help!

Others are using it with Airtouch 5 and see no issues.

Usage

To initialise:

  • airTouch = AirTouch("192.168.1.19")
  • airTouch = AirTouch("192.168.1.1", AirTouchVersion.AIRTOUCH5)

As a test:

Use the demo.py file and pass in an AirTouch IP. It takes you through a few tests.

Notes

AirTouch5: If you turn off all zones, the AC itself turns off. Turning on a zone does not turn the AC back on by itself. You must turn it back on too. Same behaviour in 'official' app.

To load:

  • await airTouch.UpdateInfo(); -- This loads the config from the AirTouch. Make sure you check for any errors before using it. It will load the Group/Zone info, the AC info, then capabilities. This needs to happen prior to using.

The following functions are available:

Group Level Functions:

  • SetGroupToTemperature (async)
  • TurnGroupOn (async)
  • TurnGroupOff (async)
  • SetCoolingModeByGroup (async)
  • SetFanSpeedByGroup (async)
  • GetSupportedCoolingModesByGroup -- Based on the loaded config.
  • GetSupportedFanSpeedsByGroup -- Based on the loaded config.

AC Level Functions

  • TurnAcOn (async)
  • TurnAcOff (async)
  • SetFanSpeedForAc (async)
  • SetCoolingModeForAc (async)
  • GetSupportedCoolingModesForAc
  • GetSupportedFanSpeedsForAc
  • GetAcs

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

airtouch4pyapi-1.0.8.tar.gz (11.2 kB view details)

Uploaded Source

Built Distribution

airtouch4pyapi-1.0.8-py3-none-any.whl (11.6 kB view details)

Uploaded Python 3

File details

Details for the file airtouch4pyapi-1.0.8.tar.gz.

File metadata

  • Download URL: airtouch4pyapi-1.0.8.tar.gz
  • Upload date:
  • Size: 11.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.1 CPython/3.11.1

File hashes

Hashes for airtouch4pyapi-1.0.8.tar.gz
Algorithm Hash digest
SHA256 fdb3d17a467f0ef34a9ce7e04e38de41ba661ff65c1523fe1e406c8cbe3dce75
MD5 7bf681f52bbf01cb948dda0214b0bbe6
BLAKE2b-256 1be9f16962de46563a761d12d79f697d3fa1f34210a3e2776209257c85b90430

See more details on using hashes here.

File details

Details for the file airtouch4pyapi-1.0.8-py3-none-any.whl.

File metadata

File hashes

Hashes for airtouch4pyapi-1.0.8-py3-none-any.whl
Algorithm Hash digest
SHA256 e11577566a5e6b37021f798b66baad1477078b518e6b0a7b77ad4943e52e3153
MD5 83d93d856c8a2a760eb6881b4c52804b
BLAKE2b-256 1b00b7538dd8b9264393b1b93686156f0ca9a9e54b3ac807f5d3b7a87083874c

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page