{"id":20607517,"url":"https://github.com/loopj/home-assistant-vantage","last_synced_at":"2025-04-15T03:55:56.756Z","repository":{"id":174862782,"uuid":"628038776","full_name":"loopj/home-assistant-vantage","owner":"loopj","description":"Home Assistant integration for Vantage InFusion home automation controllers.","archived":false,"fork":false,"pushed_at":"2025-04-14T19:36:43.000Z","size":509,"stargazers_count":11,"open_issues_count":3,"forks_count":6,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-04-15T03:55:48.198Z","etag":null,"topics":["home-assistant","infusion","vantage"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/loopj.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2023-04-14T19:07:30.000Z","updated_at":"2025-04-14T19:36:46.000Z","dependencies_parsed_at":null,"dependency_job_id":"eb1fc141-cbd9-425d-addc-4beaab40d25c","html_url":"https://github.com/loopj/home-assistant-vantage","commit_stats":null,"previous_names":["loopj/hass-vantage"],"tags_count":50,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/loopj%2Fhome-assistant-vantage","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/loopj%2Fhome-assistant-vantage/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/loopj%2Fhome-assistant-vantage/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/loopj%2Fhome-assistant-vantage/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/loopj","download_url":"https://codeload.github.com/loopj/home-assistant-vantage/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249003951,"owners_count":21196794,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["home-assistant","infusion","vantage"],"created_at":"2024-11-16T10:07:40.944Z","updated_at":"2025-04-15T03:55:56.743Z","avatar_url":"https://github.com/loopj.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Vantage InFusion integration for Home Assistant\n\n[![GitHub release](https://img.shields.io/github/v/release/loopj/home-assistant-vantage?style=for-the-badge)](http://github.com/loopj/home-assistant-vantage/releases/latest)\n[![Discord](https://img.shields.io/discord/1120862286576353370?style=for-the-badge)](https://discord.gg/psU7PxDyNQ)\n[![hacs_badge](https://img.shields.io/badge/HACS-Default-41BDF5.svg?style=for-the-badge)](https://github.com/hacs/integration)\n\nHome Assistant integration for Vantage InFusion home automation controllers, using [aiovantage](https://github.com/loopj/aiovantage).\n\n## Features\n\nThe features of this integration include:\n\n- Control Vantage devices (lights, shades, motion sensors, etc) as [Home Assistant entities](#platforms).\n- Trigger automations based on Vantage keypad button presses, using [blueprints](#blueprints) or [events](#events).\n- Start Vantage tasks from Home Assistant, using [services](#services).\n- Automatic Vantage controller discovery (via mDNS).\n- UI-based configuration (config flow).\n- Entity state updated using [Local Push](https://www.home-assistant.io/blog/2016/02/12/classifying-the-internet-of-things/#classifiers).\n- Entities and devices are automatically synchronized when the Vantage system is programmed.\n- Non-blocking I/O, via asyncio and [aiovantage](https://github.com/loopj/aiovantage).\n- Uses SSL connections by default, with automatic reconnection.\n- Works with Vantage InFusion and IC-II controllers running firmware 2.3 and above.\n\n## Prerequisites\n\nIf your Vantage controller requires authentication (most do by default) you'll need to know a username and password to continue.\n\nIf you don't know your username and password, you can reset the password for the *administrator* user if you have physical access to the controller. When resetting your password, it will revert to the serial number of your controller. Alternatively, if you are working with a Vantage dealer, they can provide these credentials.\n\nIf you aren't using the default *administrator* user, ensure that the following permissions are enabled for your user: *Read State*, *Write State*, *Read Config*.\n\n## Installation\n\nThe easiest way to install this integration is by using [HACS](https://hacs.xyz).\n\nIf you have HACS installed, you can add the Vantage integration by using this My button:\n\n[![Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.](https://my.home-assistant.io/badges/hacs_repository.svg)](https://my.home-assistant.io/redirect/hacs_repository/?owner=loopj\u0026repository=home-assistant-vantage\u0026category=integration)\n\n\u003cdetails\u003e\n\u003csummary\u003e\n\u003ch4\u003eManual installation\u003c/h4\u003e\n\u003c/summary\u003e\n\nIf you aren't using HACS, you can download the [latest release](https://github.com/loopj/home-assistant-vantage/releases/latest/download/vantage.zip) and extract the contents to your Home Assistant `config/custom_components` directory.\n\u003c/details\u003e\n\n## Configuration\n\nAdding Vantage to your Home Assistant instance can be done via the user interface, by using this My button:\n\n[![Open your Home Assistant instance and start setting up a new integration.](https://my.home-assistant.io/badges/config_flow_start.svg)](https://my.home-assistant.io/redirect/config_flow_start/?domain=vantage)\n\nVantage can be auto-discovered by Home Assistant. If an instance was found, it will be shown as **Discovered**. You can then set it up right away.\n\n\u003cdetails\u003e\n\u003csummary\u003e\n\u003ch4\u003eManual configuration\u003c/h4\u003e\n\u003c/summary\u003e\n\nIf it wasn’t discovered automatically, you can set up a manual integration entry:\n\n- Go to [**Settings \u003e Devices \u0026 Services**](https://my.home-assistant.io/redirect/integrations).\n- In the bottom right corner, select the [**Add Integration**](https://my.home-assistant.io/redirect/config_flow_start?domain=vantage) button.\n- From the list, select **Vantage InFusion**.\n- Follow the instructions on screen to complete the setup.\n\n\u003c/details\u003e\n\n## Platforms\n\n### Lights\n\nVantage *Load* and *Load Group* objects will appear as lights in Home Assistant, except for loads labeled as *Relay* or *Motor* in Design Center.\n\nAdditionally, color loads connected to a Vantage DMX or DMX/DALI Gateway will appear as lights in Home Assistant.\n\n\u003e [!TIP]\n\u003e By default, lights turn on instantly to 100% brightness without ramping. If you'd like to change this behavior, you can use Home Assistant's [light profiles](https://www.home-assistant.io/integrations/light/#default-turn-on-values) feature.\n\n### Switches\n\nVantage *Load* objects labeled as *Relay* or *Motor* will appear as switches in Home Assistant.\n\n\u003e [!TIP]\n\u003e If you have a relay or motor load that you'd like to show up as a different type of entity, you can use the [change device type of a switch](https://www.home-assistant.io/integrations/switch_as_x/) integration.\n\n### Climate\n\nVantage *Thermostat*, *VirtualThermostat*, *Generic HVAC RS485*, and *HVAC-IU* objects will appear as climate devices in Home Assistant.\n\n### Covers\n\nVantage *Blind*, *BlindGroup*, *QISBlind*, *QubeBlind*, *RelayBlind*, *Somfy.RS-485*, and *Somfy.URTSI_2* objects will appear as covers in Home Assistant.\n\n### Binary Sensors\n\nVantage *DryContact* objects (motion sensors, etc) will appear as binary sensors in Home Assistant.\n\n### Sensors\n\nVantage *AnemoSensor* (wind speed), *LightSensor*, *Temperature*, and *OmniSensor* objects will appear as sensors in Home Assistant.\n\nCertain Vantage dimmer modules have built-in power, current, and temperature sensors exposed as *OmniSensor* objects. These are created as sensors in Home Assistant, but are not enabled by default to reduce clutter. You can enable them from the Home Assistant settings.\n\n### Other Entities\n\nVantage *GMem* objects (variables) will be created as entities in Home Assistant, but are hidden by default.\n\nVariables with numeric types will be created as number entities, variables with a type of *Boolean* will be created as binary sensor entities, and variables with a type of *Text* will be created as text entities.\n\n## Blueprints\n\nAutomation blueprints are pre-made automations that you can easily add to your Home Assistant instance. See the [Home Assistant documentation](https://www.home-assistant.io/docs/automation/using_blueprints/) for more information on how to use blueprints.\n\nThis integration provides some pre-made blueprints that are helpful for working with Vantage systems.\n\n### Trigger Actions on Vantage Button Press\n\nSee [blueprints/vantage_button_press.yaml](blueprints/vantage_button_press.yaml) for a blueprint that allows you to trigger actions in Home Assistant when a button is pressed or held on a Vantage keypad.\n\n## Events\n\nThis integration will fire events on the Home Assistant event bus which can be used to trigger automations. You can test events using the [events developer tools](https://my.home-assistant.io/redirect/developer_events/) page in the Home Assistant UI.\n\n### `vantage_button_pressed`\n\nThis event is fired when a button is pressed on a Vantage keypad. The following is an example of the payload:\n\n```json\n{\n    \"button_id\": 250,\n    \"button_name\": \"Lights\",\n    \"button_position\": 1,\n    \"button_text1\": \"lights\",\n    \"button_text2\": \"\",\n    \"station_id\": 249,\n    \"station_name\": \"Office Keypad\"\n}\n```\n\n| Attribute | Description |\n| --- | --- |\n| `button_id` | The Vantage ID of the button that was pressed. |\n| `button_name` | The name of the button that was pressed. |\n| `button_position` | The position on the keypad of the button that was pressed. |\n| `button_text1` | The first line of text on the button that was pressed. |\n| `button_text2` | The second line of text on the button that was pressed. |\n| `station_id` | The Vantage ID of the keypad containing the button that was pressed. |\n| `station_name` | The name of the keypad containing the button that was pressed. |\n\n### `vantage_button_released`\n\nThis event is fired when a button is released on a Vantage keypad. It has the same payload as the `vantage_button_pressed` event.\n\n### `vantage_task_started`\n\nThis event is fired when a Vantage task is started. It's worth noting that this event can be fired multiple times for a single button press, since buttons have press, release, and hold actions, and tasks can be configured to start on any of these actions.\n\nThe following is an example of the payload:\n\n```json\n{\n    \"task_id\": 683,\n    \"task_name\": \"Toggle Office Lights\"\n}\n```\n\n| Attribute | Description |\n| --- | --- |\n| `task_id` | The Vantage ID of the task that was started. |\n| `task_name` | The name of the task that was started. |\n\n### `vantage_task_stopped`\n\nThis event is fired when a Vantage task is stopped. It has the same payload as the `vantage_task_started` event.\n\n### `vantage_task_state_changed`\n\nThis event is fired when a Vantage task changes it's LED state. The following is an example of the payload:\n\n```json\n{\n    \"task_id\": 683,\n    \"task_name\": \"Toggle Office Lights\",\n    \"task_state\": 1\n}\n```\n\n| Attribute | Description |\n| --- | --- |\n| `task_id` | The Vantage ID of the task that changed state. |\n| `task_name` | The name of the task that changed state. |\n| `task_state` | The new LED state of the task. |\n\n## Services\n\nThis integration exposes the following services which can be called from automations.\n\n### `vantage.start_task`\n\nYou can start a Vantage task by calling the `vantage.start_task` service, with either the Vantage ID of the task, or the task's name.\n\n### `vantage.stop_task`\n\nYou can stop a Vantage task by calling the `vantage.stop_task` service, with either the Vantage ID of the task, or the task's name.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Floopj%2Fhome-assistant-vantage","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Floopj%2Fhome-assistant-vantage","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Floopj%2Fhome-assistant-vantage/lists"}