mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-06-01 07:46:49 +00:00
61 lines
1.9 KiB
Markdown
61 lines
1.9 KiB
Markdown
---
|
|
layout: page
|
|
title: "Dyson"
|
|
description: "Instructions how to integrate Dyson into Home Assistant."
|
|
date: 2017-05-27 10:00
|
|
sidebar: true
|
|
comments: false
|
|
sharing: true
|
|
footer: true
|
|
logo: dyson.png
|
|
ha_category: Hub
|
|
ha_iot_class: "Cloud Polling"
|
|
ha_release: 0.47
|
|
---
|
|
|
|
The `dyson` component is the main component to integrate all [Dyson](https://dyson.com) related platforms: [Fans](/components/fan/dyson/) and [Robot vacuum](/components/vacuum/dyson/).
|
|
|
|
To enable this component, add the following lines to your `configuration.yaml`:
|
|
|
|
```yaml
|
|
dyson:
|
|
username: <dyson_account_user_email>
|
|
password: <dyson_acount_password>
|
|
language: <dyson_account_language>
|
|
devices:
|
|
- device_id: <device_id_1> # eg: Pure Cool Link device
|
|
device_ip: <device_ip_1>
|
|
- device_id: <device_id_2> # eg: Eye 360 robot vacuum
|
|
device_ip: <device_ip_2>
|
|
...
|
|
```
|
|
|
|
Configuration variables:
|
|
|
|
- **username** (*Required*): Dyson account username (email address)
|
|
- **password** (*Required*): Dyson account password
|
|
- **language** (*Required*): Dyson account language country code. Known working codes: `FR`, `NL`, `GB`, `AU`. But others codes should work.
|
|
- **devices** (*Optional*): List of devices
|
|
- **device_id** (*Required*): Device ID. Available in the mobiles applications (*Settings* page)
|
|
- **device_ip** (*Required*): Device IP address
|
|
|
|
`devices` list is optional but you'll have to provide them if discovery is not working (warnings in the logs and the devices are not available in Home Assistant web interface).
|
|
*If your are using a robot vacuum (Dyson 360 Eye), discovery is not yet supported so you have to provide `devices` list.*
|
|
|
|
To find devices IP address, you can use your router or `nmap`:
|
|
|
|
```bash
|
|
$ nmap -p 1883 XXX.XXX.XXX.XXX/YY -- open
|
|
```
|
|
|
|
Where:
|
|
|
|
- **XXX.XXX.XXX.XXX** is your network address
|
|
- **YY** is your network mask
|
|
|
|
For example:
|
|
|
|
```bash
|
|
$ nmap -p 1883 192.168.0.0/24 -- open
|
|
```
|