diff --git a/source/_includes/asides/getting_started_navigation.html b/source/_includes/asides/getting_started_navigation.html index c7741c01864..f640dd7e062 100644 --- a/source/_includes/asides/getting_started_navigation.html +++ b/source/_includes/asides/getting_started_navigation.html @@ -5,6 +5,7 @@
  • {% active_link /installation/ Installation %}
  • {% active_link /getting-started/onboarding/ Onboarding %}
  • {% active_link /getting-started/concepts-terminology/ Concepts and terminology %}
    • +
  • {% active_link /getting-started/integration/ Integration %}
  • {% active_link /getting-started/automation/ Automation %}
  • {% active_link /getting-started/presence-detection/ Presence detection diff --git a/source/getting-started/concepts-terminology.markdown b/source/getting-started/concepts-terminology.markdown index a918b698baf..a031fc8e550 100644 --- a/source/getting-started/concepts-terminology.markdown +++ b/source/getting-started/concepts-terminology.markdown @@ -57,4 +57,4 @@ Depending on your [installation type](/installation), you may have the ability t ![Add-ons](/images/getting-started/add-ons.png) -{% include getting-started/next_step.html step="Automate Home Assistant" link="/getting-started/automation/" %} +{% include getting-started/next_step.html step="Adding Integrations In Home Assistant" link="/getting-started/integration/" %} diff --git a/source/getting-started/index.markdown b/source/getting-started/index.markdown index 3ca9838011b..32f08ab71cd 100644 --- a/source/getting-started/index.markdown +++ b/source/getting-started/index.markdown @@ -8,6 +8,7 @@ show_title: true {% include getting-started/next_step.html step="Installation" link="/installation/" %} {% include getting-started/next_step.html step="Onboarding" link="/getting-started/onboarding/" %} {% include getting-started/next_step.html step="Concepts and terminology" link="/getting-started/concepts-terminology/" %} +{% include getting-started/next_step.html step="Integration" link="/getting-started/integration/" %} {% include getting-started/next_step.html step="Automation" link="/getting-started/automation/" %} {% include getting-started/next_step.html step="Presence detection" link="/getting-started/presence-detection/" %} {% include getting-started/next_step.html step="Join the community" link="/getting-started/join-the-community/" %} diff --git a/source/getting-started/integration.markdown b/source/getting-started/integration.markdown new file mode 100644 index 00000000000..d8f3e5d9961 --- /dev/null +++ b/source/getting-started/integration.markdown @@ -0,0 +1,31 @@ +--- +title: "Adding Integrations" +description: "Instructions to add an integration." +--- +Let's start by adding your first {% term integration %} so that you can see and change a smart home {% term device %}. + +From the sidebar, click on {% my integrations title="Settings > Devices & Services" %}. At this screen you will be able to set up integrations with Home Assistant. You might notice a *discovered* section. This section contains integrations that were found on your network and can easily be added with a few clicks. If your integrations are not discovered, click the **Add integration** button in the lower right and search for your integration in that list. + +In this example, we'll add a Chromecast to Home Assistant. Chromecast uses the [Google Cast integration](/integrations/cast). Although the below example has already discovered the device, let's add it manually. + +First, press the **Add integration** button in the lower right and search for your integration in that list. + +![Search for Google Cast](/images/getting-started/add-google-cast-integration.png) + +Select **Google Cast** from the list. Because my Chromecast device was already discovered, it asks if I want to add the discovered one or a different one. I will choose the latter and setup another instance. + +![Google Cast discovered confirmation](/images/getting-started/google-cast-discovered.png) + +It now asks for the network IP address of the device. Describing how to identify a devices IP address is beyond the scope of this article because each network is different. However, the router is usually a good place to look. In this example, it's *192.168.1.99*. + +![Manually setup Google Cast device](/images/getting-started/google-cast-manual-details.png) + +If it was successful, it will show a message and allow you to set the {% term area %} it belongs to. + +![Search for Google Cast](/images/getting-started/google-cast-integration-added.png) + +When you're done, navigate back to the web interface and voila, your devices are ready for you to control. You can always go back to add and remove integrations in the future. + +If you get stuck, need more information, or want to see what the setup process is like, use the [integration documentation](/integrations). + +{% include getting-started/next_step.html step="Automate Home Assistant" link="/getting-started/automation/" %} \ No newline at end of file diff --git a/source/getting-started/onboarding.markdown b/source/getting-started/onboarding.markdown index aa8bac323f0..2c88007da72 100644 --- a/source/getting-started/onboarding.markdown +++ b/source/getting-started/onboarding.markdown @@ -17,16 +17,6 @@ Once you are done, click **Next**. In this screen, Home Assistant will show any ![Discovery of devices on your network.](/images/getting-started/devices.png) -Finally, click **Finish**. Now you're brought to the Home Assistant web interface. This screen will show all of your devices. So let's get that screen filled up! - -![The Home Assistant user interface.](/images/getting-started/lovelace.png) - -From the side bar, click on {% my integrations title="Settings > Devices & Services" %}. On this screen, you will be able to set up {% term integrations %} with Home Assistant. - -![The integrations page in the configurations panel shows you all your configured integrations.](/images/getting-started/integrations.png) - -When each integration is done setting up, it will ask you to put the new devices in areas. Areas allow you to organize all the devices in your home. - -When you're done, navigate back to the web interface and voila, your devices are ready for you to control. +Finally, click **Finish**. Now you're brought to the Home Assistant web interface. This screen will show all of your devices. {% include getting-started/next_step.html step="Concepts & Terminologies" link="/getting-started/concepts-terminology/" %} diff --git a/source/images/getting-started/add-google-cast-integration.png b/source/images/getting-started/add-google-cast-integration.png new file mode 100644 index 00000000000..eb1dcff0808 Binary files /dev/null and b/source/images/getting-started/add-google-cast-integration.png differ diff --git a/source/images/getting-started/google-cast-discovered.png b/source/images/getting-started/google-cast-discovered.png new file mode 100644 index 00000000000..de1ec343640 Binary files /dev/null and b/source/images/getting-started/google-cast-discovered.png differ diff --git a/source/images/getting-started/google-cast-integration-added.png b/source/images/getting-started/google-cast-integration-added.png new file mode 100644 index 00000000000..e7600798e18 Binary files /dev/null and b/source/images/getting-started/google-cast-integration-added.png differ diff --git a/source/images/getting-started/google-cast-manual-details.png b/source/images/getting-started/google-cast-manual-details.png new file mode 100644 index 00000000000..2f2907ba3ac Binary files /dev/null and b/source/images/getting-started/google-cast-manual-details.png differ