Split Raspberry Pi getting started (#33777)

source/_includes/installation/container.md

@@ -5,9 +5,9 @@ These below instructions are for an installation of {% term "Home Assistant Cont
 
 {% important %}
 
-<bPrerequisites</b>
+<b>Prerequisites</b>
 This guide assumes that you already have an operating system setup and a container runtime installed (like Docker).
-  
+
 If you are using Docker then you need to be on at least version 19.03.9, ideally an even higher version, and `libseccomp` 2.4.2 or newer.
 
 {% endimportant %}

source/common-tasks/os.markdown

@@ -82,6 +82,7 @@ You can manually define that the previous boot slot is used. This can be useful
 {% include common-tasks/lost_password.md %}
 {% include common-tasks/third-party-addons.md %}
 {% include common-tasks/configuration_check.md %}
+{% include common-tasks/enable_i2c.md %}
 
 ## Home Assistant versions
 
@@ -92,3 +93,4 @@ To see which version your system is running, go to {% my info title="**Settings*
 {% include common-tasks/development_version.md %}
 
 {% include common-tasks/data_disk.md %}
+

source/installation/index.html

@@ -102,7 +102,7 @@ toc: true
             </div>
           </div>
           <div class="buttons">
-            <a href="https://amzn.to/2S0Gcl1" class="button accent"
+            <a href="https://amzn.to/3UH6TcD" class="button accent"
               >Get Raspberry Pi {% include assets/chevron_right.html %}</a
             >
             <a href="/installation/raspberrypi" class="button"
@@ -363,7 +363,7 @@ toc: true
       </tr>
     </table>
   </div>
-  
+
   <sub
     >1: Names are abbreviated. The full names of the installation methods are:
     <ul>
@@ -389,6 +389,49 @@ toc: true
     >
   </p>
   <p></p>
+  <div class="installations-card">
+    <div class="material-card text">
+      <div class="content-container">
+        <div class="image">
+          <img
+            src="/images/installation/rpi.jpg"
+          />
+        </div>
+        <div class="content">
+          <h3>Install Home Assistant variants on Raspberry Pi</h3>
+          <p>A low-cost DIY solution to get started with Home Assistant</p>
+          <div class="columns">
+            <div>
+              <b>SKILLS REQUIRED</b>
+              <ul>
+                <li>Assembling a Raspberry Pi setup</li>
+                <li>Flashing a Raspberry Pi</li>
+                <li>Advanced knowledge of Linux</li>
+                <li>Using Linux command line</li>
+              </ul>
+            </div>
+            <div>
+              <b>TOOLS REQUIRED</b>
+              <ul>
+                <li>Raspberry Pi 3, 4 or 5 with power supply</li>
+                <li>MicroSD card</li>
+                <li>Ethernet connection</li>
+              </ul>
+            </div>
+          </div>
+          <div class="buttons">
+            <a href="https://amzn.to/3UH6TcD" class="button accent"
+              >Get Raspberry Pi {% include assets/chevron_right.html %}</a
+            >
+            <a href="/installation/raspberrypi-other" class="button"
+              >View tutorial {% include assets/chevron_right.html %}</a
+            >
+          </div>
+        </div>
+      </div>
+    </div>
+  </div>
+
   <div class="installations-card">
     <div class="material-card text">
       <div class="content-container">

source/installation/raspberrypi-other.markdown

@@ -0,0 +1,18 @@
+---
+title: "Advanced Raspberry Pi installations"
+description: "Advanced instructions to install Home Assistant variants on a Raspberry Pi"
+installation_type: raspberrypi-other
+---
+
+{% comment %}
+Included section for this page is located under source/_includes/installation
+{% endcomment %}
+
+{% assign board = "Raspberry Pi" %}
+{% assign installation_media = "SD card" %}
+
+While we recommend Home Assistant OS, there are also alternative ways to install Home Assistant. Before you continue, be aware of the limitations and differences compared to Home Assistant OS. You can find more information on the [installation page](/installation/#advanced-installation-methods). Most notably,
+<a href="/addons">add-ons</a> are only available with the Home Assistant Operating System.
+
+{% include installation/container.md %}
+{% include installation/core.md %}

source/installation/raspberrypi.markdown

@@ -10,24 +10,19 @@ Included section for this page is located under source/_includes/installation
 {% assign board = "Raspberry Pi" %}
 {% assign installation_media = "SD card" %}
 
-{% note %}
-Remember to ensure you're using an [appropriate power supply](https://www.raspberrypi.com/documentation/computers/raspberry-pi.html#power-supply) with your Raspberry Pi. Mobile chargers may not be suitable, since some are designed to only provide the full power with that manufacturer's handsets. USB ports on your computer also will not supply enough power and must not be used.
-{% endnote %}
-
-Before installing Home Assistant, you might want to <a href="/installation#compare-installation-methods">compare installation methods</a>. Most notably, 
-<a href="/addons">add-ons</a> are only available with the Home Assistant Operating System.
-
 ## Suggested Hardware
 
-We will need a few things to get started with installing Home Assistant. Links below lead to Amazon US. If you’re not in the US, you should be able to find these items in web stores in your country.
+We will need a few things to get started with installing Home Assistant.
 
-- [Raspberry Pi 5](https://amzn.to/3UH6TcD)
+- [Raspberry Pi 5](https://amzn.to/3UH6TcD) or [Raspberry Pi 4](https://amzn.to/2S0Gcl1) with [power supply](https://amzn.to/2ReZ2Vq) (Raspberry Pi 3 Model B is ok to get started, but the Model A does not have enough RAM).
-- [Raspberry Pi 4](https://amzn.to/2S0Gcl1) (Raspberry Pi 3 Model B is ok too, but the Model A does not have enough RAM). Raspberry Pi are currently hard to come by, use [RPilocator](https://rpilocator.com/?cat=PI4) to find official distributors with stock.
-- [Power Supply for Raspberry Pi 4](https://amzn.to/2ReZ2Vq) or [Power Supply for Raspberry Pi 3](https://amzn.to/2R8yG7h)
 - [Micro SD Card](https://amzn.to/2X0Z2di). Ideally get one that is [Application Class 2](https://www.sdcard.org/developers/overview/application/index.html) as they handle small I/O much more consistently than cards not optimized to host applications. A 32&nbsp;GB or bigger card is recommended.
 - SD Card reader. This is already part of most laptops, but you can purchase a [standalone USB adapter](https://amzn.to/2WWxntY) if you don't have one. The brand doesn't matter, just pick the cheapest.
 - [Ethernet cable](https://amzn.com/dp/B00N2VISLW). Required for installation. After installation, Home Assistant can work with Wi-Fi, but an Ethernet connection is more reliable and highly recommended.
 
+{% note %}
+Remember to ensure you're using an [appropriate power supply](https://www.raspberrypi.com/documentation/computers/raspberry-pi.html#power-supply) with your Raspberry Pi. Mobile chargers may not be suitable, since some are designed to only provide the full power with that manufacturer's handsets. USB ports on your computer also will not supply enough power and must not be used.
+{% endnote %}
+
 ## Install Home Assistant Operating System
 
 This guide shows how to install the Home Assistant Operating system onto your Raspberry Pi using Raspberry Pi Imager.
@@ -37,7 +32,6 @@ If Raspberry Pi Imager is not supported by your platform, you can use [Balena Et
 ### Write the image to your SD card
 
 1. Download and install the Raspberry Pi Imager on your computer as described under [https://www.raspberrypi.com/software/](https://www.raspberrypi.com/software/).
-   ![Install Raspberry Pi Imager](/images/installation/rpi_imager.png)
 2. Open the Raspberry Pi Imager and select your Raspberry Pi device.
     ![Open Raspberry Pi Imager](/images/installation/rpi_imager_start.png)
 3. Choose the operating system:
@@ -66,7 +60,7 @@ If Raspberry Pi Imager is not supported by your platform, you can use [Balena Et
 Within a few minutes after connecting the Raspberry Pi, you will be able to reach your new Home Assistant.
 
 - In the browser of your desktop system, enter <a href="http://homeassistant.local:8123" target="_blank">homeassistant.local:8123</a>.
- 
+
 {% note %}
 If you are running an older Windows version or have a stricter network configuration, you might need to access Home Assistant at <a href="http://homeassistant:8123" target="_blank">homeassistant:8123</a> or `http://X.X.X.X:8123` (replace X.X.X.X with your Raspberry Pi’s IP address).
 {% endnote %}
@@ -86,52 +80,7 @@ With the Home Assistant Operating System installed and accessible, you can now c
 {% include getting-started/next_step.html step="Onboarding" link="/getting-started/onboarding/" %}
 
 
-{% include installation/container.md %}
-{% include installation/core.md %}
-
-## Writing the image with Balena Etcher
-
-Use this procedure if Raspberry Pi Imager is not supported by your platform.
-
-1. Insert the SD card into the computer. Note: the contents of the card will be overwritten.
-2. Download and start <a href="https://www.balena.io/etcher" target="_blank">Balena Etcher</a>. You may need to run it with administrator privileges on Windows.
-
-3. Download the image to your computer.
-   - Copy the correct URL for the Raspberry Pi 3, 4 or 5 (Note: there are 3 different links below!):
-
-{% tabbed_block %}
-{% for variant in site.installation.types[page.installation_type].variants %}
-
-- title: {{ variant.name }}
-  content: |
-
-    ```text
-    https://github.com/home-assistant/operating-system/releases/download/{{site.data.version_data.hassos[variant.key]}}/haos_{{ variant.key }}-{{site.data.version_data.hassos[variant.key]}}.img.xz
-    ```    
-
-{% endfor %}
-{% endtabbed_block %}
-
-_Select and copy the URL or use the "copy" button that appear when you hover it._
-
-4. Paste the URL into your browser to start the download.
-5. Select **Flash from file** and select the image you just downloaded.
-   - **Flash from URL** does not work on some systems.
-
-  ![Screenshot of the Etcher software showing flash from URL selected.](/images/installation/etcher1_file.png)
-6. **Select target**.
-![Screenshot of the Etcher software showing the select target button highlighted.](/images/installation/etcher3.png)
-7. Select the SD card you want to use for your installation.
-![Screenshot of the Etcher software showing the targets available.](/images/installation/etcher4.png)
-8. Select **Flash!** to start writing the image.
-![Screenshot of the Etcher software showing the Flash button highlighted.](/images/installation/etcher5.png)
-9. Once Balena Etcher has finished writing the image, you will see a confirmation.
-![Screenshot of the Etcher software showing that the installation has completed.](/images/installation/etcher6.png)
-
-
 <div style="margin-top:50px">
 <p>
     <i>We get commissions for purchases made through links in this post.</i></p>
 </div>
-
-{% include common-tasks/enable_i2c.md %}