Skip to main content

Python module to talk to Vantage InFusion controllers.

Project description

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

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

aiovantage-0.1.1.tar.gz (41.5 kB view hashes)

Uploaded Source

Built Distribution

aiovantage-0.1.1-py3-none-any.whl (60.3 kB view hashes)

Uploaded Python 3

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