aiovantage 0.2.0

Python module to talk to Vantage InFusion controllers.

aiovantage

aiovantage is a Python library for interacting with and controlling Vantage InFusion home automation controllers.

Uses a "controller" pattern inspired heavily by the aiohue library.

This open-source, non-commercial library is not affiliated, associated, authorized, endorsed by, or in any way officially connected with Vantage, and is provided for interoperability purposes only.

Example

from aiovantage import Vantage

async with Vantage("192.168.1.2", "username", "password") as vantage:
    async for load in vantage.loads:
        print(f"{load.name} is at {load.level}%")

See the examples folder for more examples.

Features

• Uses Python asyncio for non-blocking I/O.
• Exposes "controllers" to make fetching and controlling various objects easy.
• Uses SSL connections by default, with automatic reconnection.
• Fetch objects lazily (with async for obj in controller).
• Alternatively, eager-fetch objects with controller.initialize.

Supported objects types

The following interfaces/controllers are currently supported.

Type	Description	Controller	Examples
Area	Rooms, etc	vantage.areas	Examples
Blind	Shades, blinds	vantage.blinds	Examples
BlindGroups	Groups of blinds	vantage.blind_groups	Examples
Buttons	Keypad buttons	vantage.buttons	Examples
DryContacts	Motion sensors, etc	vantage.dry_contacts	Examples
GMem	Vantage variables	vantage.gmem	Examples
Load	Lights, relays, etc	vantage.loads	Examples
LoadGroup	Groups of loads	vantage.load_groups	Examples
OmniSensor	Power, current, etc	vantage.omni_sensors	Examples
RGBLoad	RGB lights	vantage.rgb_loads	Examples
Stations	Keypads, etc	vantage.stations	Examples
Tasks	Vantage tasks	vantage.tasks	Examples

If you have an object that you expect to show up in one of these controllers, but it is missing, please let me know in an issue.

Installation

pip3 install aiovantage