mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-07-16 05:46:52 +00:00
58 lines
2.1 KiB
Markdown
58 lines
2.1 KiB
Markdown
---
|
|
layout: page
|
|
title: "Nanoleaf Light Panel"
|
|
description: "Instructions how to integrate Nanoleaf Light Panels into Home Assistant."
|
|
date: 2018-01-04 20:00
|
|
sidebar: true
|
|
comments: false
|
|
sharing: true
|
|
footer: true
|
|
logo: nanoleaf_light.png
|
|
ha_category: Light
|
|
ha_iot_class: Local Polling
|
|
ha_release: 0.67
|
|
redirect_from:
|
|
- /components/light.nanoleaf/
|
|
---
|
|
|
|
### {% linkable_title Configuration Sample %}
|
|
|
|
The `nanoleaf` platform allows you to control [Nanoleaf Light Panels](https://nanoleaf.me) from Home Assistant.
|
|
|
|
The preferred way to set up this platform is by enabling the [discovery component](/components/discovery/). Make sure to press and hold the *ON* button for 5 seconds (the LED will start flashing) on your Nanoleaf Lights while Home Assistant is starting.
|
|
|
|
To configure the Nanoleaf lights manually, add the following lines to your `configuration.yaml` file:
|
|
|
|
```yaml
|
|
# Example configuration.yaml entry
|
|
light:
|
|
- platform: nanoleaf
|
|
host: 192.168.1.10
|
|
token: xxxxxxxxxxxxxxxxxxxxx
|
|
```
|
|
|
|
{% configuration %}
|
|
host:
|
|
description: IP address or host-name of the device, e.g., 192.168.1.10.
|
|
required: true
|
|
type: string
|
|
token:
|
|
description: The *auth* token that you get via *POST* to */api/v1/new*
|
|
required: true
|
|
type: string
|
|
name:
|
|
description: Name of the component, make this unique if you have multiple Light Panels
|
|
required: false
|
|
type: string
|
|
default: Nanoleaf
|
|
{% endconfiguration %}
|
|
|
|
### {% linkable_title Getting The Auth Token %}
|
|
|
|
1. Make sure that your Nanoleaf Light Panel is fully patched (as of the time of writing the latest version was 3.0.8 for Aurora and 1.2.0 for Canvas)
|
|
2. Hold down the *ON* button on the Panel for 5 seconds; the LED will start flashing
|
|
3. Issue a *POST* request to the API endpoint, e.g., via `$ curl -i -X POST http://192.168.1.155:16021/api/v1/new`
|
|
4. The output should include the auth token like *{"auth_token":"xxxxxxxxxxxxxxxxxxxxx"}*, copy the resulting token into your configuration
|
|
|
|
If you get a 403 Forbidden message, you probably did not press the *ON* button long enough. The time-frame to get a valid token is only 30 seconds, so you have to be quick to issue the curl request.
|