Skip to content

Commit 22c35b4

Browse files
authored
Concepts and terms: update screenshots (home-assistant#28503)
1 parent 1acaa05 commit 22c35b4

File tree

8 files changed

+22
-14
lines changed

8 files changed

+22
-14
lines changed

source/getting-started/concepts-terminology.markdown

Lines changed: 22 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -6,29 +6,33 @@ Now you're in Home Assistant, let's go over important parts of Home Assistant an
66

77
## Dashboards
88

9-
Customizable pages to display information connected to and available in Home Assistant. By default there are two Dashboards, Overview and Energy. The Overview dashboard is the first thing you see after the [onboarding process](/getting-started/onboarding). More details can be found [here](/dashboards).
9+
Dashboards are customizable pages to display information in Home Assistant. By default there are two Dashboards: **Overview** and **Energy**. The **Overview** dashboard is the first thing you see after the [onboarding process](/getting-started/onboarding). The image below shows a customized example of the **Overview** dashboard. If you just onboarded, yours will be nearly empty. To learn how to customize your dashboards, refer to the [dashboard](/dashboards) documentation.
1010

1111
![Dashboard](/images/getting-started/lovelace.png)
12+
1213
## Integrations
1314

14-
Software that allows Home Assistant to connect to other software and platforms. For example, a product by Philips called Hue would use the Philips Hue integration and allow Home Assistant to talk to the hardware controller Hue Bridge. Any connected and Home Assistant compatible devices to the Hue Bridge would appear in Home Assistant as [devices](#devices--entities).
15+
Integrations are pieces of software that allow Home Assistant to connect to other software and platforms. For example, a product by Philips called Hue would use the Philips Hue integration and allow Home Assistant to talk to the hardware controller Hue Bridge. Any Home Assistant compatible devices connected to the Hue Bridge would appear in Home Assistant as [devices](#devices--entities).
1516

1617
![Integrations](/images/getting-started/integrations-new.png)
1718

18-
A full list of compatible integrations can be found [here](/integrations).
19+
For a full list of compatible integrations, refer to the [integrations](/integrations) documentation.
1920

2021
Once an integration has been added, the hardware and/or data are represented in Home Assistant as [devices and entities](#devices--entities).
2122

22-
## Devices & Entities
23+
## Devices & entities
24+
25+
Devices are a logical grouping for one or more entities. A {% term device %} may represent a physical device which can have one or more sensors. The sensors appear as entities associated to the device. For example, a motion sensor is represented as a device. It may provide motion detection, temperature, and light levels as entities. Entities have states such as *detected* when motion is detected and *clear* when there is no motion.
2326

24-
Devices are a logical grouping for one or more entities. A device may represent a physical device and the device may have one or more sensors which appear as entities associated to the device. For example, a motion sensor is represented as a device and the motion may provide motion detection, temperature and light levels as entities. Entities have states such as on when motion is detected and off when there is no motion.
27+
![Home Assistant Device](/images/getting-started/home-assistant-device_01.png)
2528

2629
Devices and entities are used throughout Home Assistant. To name a few examples:
27-
- [Dashboards](#dashboards) can show a state of an entity like if a light bulb is on or off as well as buttons that interact with devices like turning a light bulb on or off.
28-
- An [automation](#automations) can be triggered from a state change on an entity e.g. a light turning on and control another device or entity.
29-
- A predefined setting for light device saved as a [scene](#scenes).
3030

31-
![Home Assistant Device](/images/getting-started/home-assistant-device.png)
31+
- [Dashboards](#dashboards) can show a state of an entity. For example, if a light is on or off.
32+
- An [automation](#automations) can be triggered from a state change on an entity. For example, a motion sensor detects motion and triggers a light to turn on.
33+
- A predefined color and brightness setting for a light saved as a [scene](#scenes).
34+
35+
![Home Assistant Device](/images/getting-started/home-assistant-device_02.png)
3236

3337
## Automations
3438

@@ -37,23 +41,27 @@ A set of repeatable actions that can be set up to run automatically. Automations
3741
2. Conditions - optional tests that must be met before continuing to running actions. For example, if someone is home.
3842
3. Actions - interact with devices such as turn on a light.
3943

40-
More details can be found [here](/docs/automation/basics/) or try creating an [automation](/getting-started/automation).
44+
To learn the basics about automations, refer to the [automation basics](/docs/automation/basics/) page or try [creating an automation](/getting-started/automation) yourself.
4145

4246
![Automations](/images/getting-started/automation-editor.png)
4347

4448
## Scripts
4549

46-
Similar to automations, repeatable actions that can be run. The difference between scripts and automations is that scripts do not have triggers like automations. This means that scripts cannot automatically run unless they are used in an automation. Scripts are particularly useful if you perform the same actions in different automations or trigger them from a dashboard. More details can be found [here](/integrations/script/).
50+
Similar to automations, repeatable actions that can be run. The difference between scripts and automations is that scripts do not have triggers like automations. This means that scripts cannot automatically run unless they are used in an automation. Scripts are particularly useful if you perform the same actions in different automations or trigger them from a dashboard. For information on how to create scripts, refer to the [scripts](/integrations/script/) documentation.
51+
52+
![Scripts](/images/getting-started/script_01.png)
4753

4854
## Scenes
4955

50-
Scenes allow you to create predefined settings for your devices. Likened to driving mode on phones, driver profiles in cars, it can change an environment to suit you. For example, your environment for watching films may have dimmer lighting, TV is switched on and higher volume. This can be saved as a scene and used without having to set individual devices every time.
56+
Scenes allow you to create predefined settings for your devices. Similar to a driving mode on phones, or driver profiles in cars, it can change an environment to suit you. For example, your *watching films* scene may dim the lighting, switch on the TV and increase its volume. This can be saved as a scene and used without having to set individual devices every time.
57+
58+
To learn how to use scenes, refer to the [scene](/integrations/scene/) documentation.
5159

52-
Further details can be found [here](/integrations/scene/).
60+
![Scenes](/images/getting-started/scene_02.png)
5361

5462
## Add-ons
5563

56-
Depending on your [installation type](/installation), you may have the ability to install third party add-ons. Add-ons are usually apps that can be run with Home Assistant but provide a quick and easy way to install, configure, and run within Home Assistant. Add-ons provide additional functionality whereas integrations connect Home Assistant to other apps.
64+
Depending on your [installation type](/installation), you can install third party add-ons. Add-ons are usually apps that can be run with Home Assistant but provide a quick and easy way to install, configure, and run within Home Assistant. Add-ons provide additional functionality whereas integrations connect Home Assistant to other apps.
5765

5866
![Add-ons](/images/getting-started/add-ons.png)
5967

13.5 KB
Loading
Binary file not shown.
133 KB
Loading
42.7 KB
Loading
234 KB
Loading
42.8 KB
Loading
37.8 KB
Loading

0 commit comments

Comments
 (0)