python-rabbitair 0.0.8

Description:

pythonrabbitair 0.0.8

Rabbit Air Python library
This library can be used to control Rabbit Air air purifiers over a local
network.
Usage
#! /usr/bin/env python3

import asyncio

from rabbitair import Mode, Speed, UdpClient


async def main():
with UdpClient("ip", "token") as client:

# Getting the current state of the air purifier

state = await client.get_state()
print(state)

# Controlling the air purifier

print("Power Off")
await client.set_state(power=False)

await asyncio.sleep(3)

print("Power On")
await client.set_state(power=True)

await asyncio.sleep(3)

print("Set Speed to High")
await client.set_state(speed=Speed.High)

await asyncio.sleep(3)

print("Set Mode to Auto")
await client.set_state(mode=Mode.Auto)


asyncio.run(main())

Retrieving the Access Token
To establish a connection, you need to know the address and access token of the
device.

Open the Rabbit Air mobile app. You will see a list of devices connected to
your account.
Tap the list item and the device control page will open.
On the device page tap the Edit button. You will see a page with the
device location and name settings.
On this page, quickly tap on "Serial Number" several times until you see two
more lines that were previously hidden. The first is the device ID, and the
second is the access token.

Note that the device ID is used as an mDNS name of the device. So you can
specify it as the host value by adding the suffix ".local" at the end.
For example, you got:

Then you can use abcdef1234_123456789012345678.local as the host and
0123456789ABCDEF0123456789ABCDEF as the token.
In some cases the access token may not be available right away, then you will
see a "Tap for setup user key" message instead. To generate the access token,
tap on this message and follow the instructions. If the app says "your device
is not supported", it probably means that you are trying to connect to a
first-generation MinusA2 model (an older hardware revision). It is not yet
supported.