---
layout: page
title: "Avi-on"
description: "Instructions on how to setup GE Avi-on Bluetooth dimmers within Home Assistant."
date: 2017-01-17 23:17
sidebar: true
comments: false
sharing: true
footer: true
ha_category: Light
ha_iot_class: "Assumed State"
logo: avi-on.png
ha_release: 0.37
---

Support for the Avi-on Bluetooth dimmer switch [Avi-On](http://avi-on.com/).

To enable these lights, add the following lines to your `configuration.yaml` file:

```yaml
# Example configuration.yaml entry
light:
  - platform: avion
```

Configuration variables:

- **username** (*Optional*): The username used in the Avion app. If username and password are both provided, any associated switches will automatically be added to your configuration.
- **password** (*Optional*): The password used in the Avion app.
- **devices** (*Optional*): An optional list of devices with their Bluetooth address, a custom name to use in the frontend and the API key. The API key can be obtained by executing the following command:
```
curl -X POST -H "Content-Type: application/json" -d '{"email": "fakename@example.com", "password": "password"}' https://admin.avi-on.com/api/sessions | jq
```

with the email and password fields replaced with those used when registering the device via the mobile app. The pass phrase field of the output should be used as the API key in the configuration.

If username and password are not supplied, devices must be configured manually like so:

```yaml
# Manual device configuration.yaml entry
light:
  - platform: avion
    devices:
      00:21:4D:00:00:01:
        name: Light 1
        api_key: YOUR_API_KEY
      00:21:3D:20:00:a1:
        name: Light 2
        api_key: YOUR_API_KEY
```
