From f3c22ed1ebfb63f341b48a78abff1588101850d9 Mon Sep 17 00:00:00 2001 From: Paulus Schoutsen Date: Thu, 21 Feb 2019 17:25:59 -0800 Subject: [PATCH 1/2] Clarify device --- docs/device_registry_index.md | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/docs/device_registry_index.md b/docs/device_registry_index.md index 6aaf09d7..b79ad602 100644 --- a/docs/device_registry_index.md +++ b/docs/device_registry_index.md @@ -10,6 +10,16 @@ The device registry is a registry where Home Assistant keeps track of devices. A alt='Device registry overview' /> +## What is a device? + +A device in Home Assistant represents a physical device that has its own control unit. The control unit itself does not have to be smart, but it should be in control of what happens. For example, an Ecobee thermostat with 4 sensors equals 5 devices in Home Assistant, one for the thermostat and one for each sensor. + +If you connect a sensor to another device to read some of its data, it should still be represented as two different devices. The reason for this is that the sensor could be moved to read the data of another device. + +> Although not currently available, we could consider offering an option to users to merge devices. + +## Device properties + | Attribute | Description | | --------- | ----------- | | id | Unique ID of device (generated by Home Assistant) From 10f87026b081a11ba86f772dac28e58c43722215 Mon Sep 17 00:00:00 2001 From: Paulus Schoutsen Date: Thu, 21 Feb 2019 18:59:47 -0800 Subject: [PATCH 2/2] Update device_registry_index.md --- docs/device_registry_index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/device_registry_index.md b/docs/device_registry_index.md index b79ad602..c1d751be 100644 --- a/docs/device_registry_index.md +++ b/docs/device_registry_index.md @@ -12,7 +12,7 @@ The device registry is a registry where Home Assistant keeps track of devices. A ## What is a device? -A device in Home Assistant represents a physical device that has its own control unit. The control unit itself does not have to be smart, but it should be in control of what happens. For example, an Ecobee thermostat with 4 sensors equals 5 devices in Home Assistant, one for the thermostat and one for each sensor. +A device in Home Assistant represents a physical device that has its own control unit. The control unit itself does not have to be smart, but it should be in control of what happens. For example, an Ecobee thermostat with 4 room sensors equals 5 devices in Home Assistant, one for the thermostat including all sensors inside it, and one for each sensor. If you connect a sensor to another device to read some of its data, it should still be represented as two different devices. The reason for this is that the sensor could be moved to read the data of another device.