airscape 0.1.8

An interface to control AirScape Whole House Fans

AirScape WHF interface

AirScape has a collection of connected whole house fans. They can be controlled via their app, but also have a published API. This project is an interface to control their fans locally via the REST API on the fan.

API is documented here

Invocation

Import into your code and create a airscape.Fan object

import airscape
fan = airscape.Fan('192.168.1.10', 5)

Constructor takes 2 arguments. The IP or hostname (if you DNS registered your fan) and the timeout for communicating with the fan.

The timeout is optional and has a default value of 5.

Fan Control

The fan has 2 attributes to control:

• on
• speed

>>> fan.on
False
>>> fan.on = True
>>> fan.on
True
>>> fan.speed
2
>>> fan.speed = 5
>>> fan.speed
5

The speed can also be controled in incrememnts instead of setting directly

>>> fan.speed
3
>>> fan.speed_up()
>>> fan.speed
4
>>> fan.slow_down()
>>> fan.speed
3