[更新2020-10-14 by@Jpsy]:
Added instructions to update HA OS through CLI.
[更新2020-10-18 by@Jpsy]:
有关安装和使用Raspberry OS更新EEPROM固件的更多详细信息。
[更新2020-10-20 by@Jpsy]:
Infos通过SSH使用Raspberry OS“无头”（没有显示器或键盘）。
谢谢@londonbenji对于这些细节。
[更新2020-10-22@Jpsy]:
Infos添加了USB3适配器的工作（和非工作）SATA。
删除了一些有关Sabrent适配器的信息（不要使用它！）。
谢谢@noobz对于这些细节。
[更新2020-10-31 by@Jpsy]:
添加了警告，以不使用HA OS版本5.4。
Added hint that Raspberry Pi Imager can be used to update EEPROM.
[更新2020-12-08 by@Jpsy]:
添加了警告，以不使用第一个登录屏幕的快照还原功能。
所有HA OS版本参考已更新为v5.6。
[更新2021-01-08@Jpsy]:
现在正式支持具有高达8GB的SSD靴子和PI4。
更新的适配器推荐从Eluteng到Startech。
为Odroid-N2+和Home Assistant Blue添加了提示和建议。19463331伟德国际
Added info about a sufficient power supply.
Added info about different boot EEPROM versions.
所有HA OS版本参考已更新为v5.10。
使用引导EEPROM更新代码添加了有关HA OS版本5.6至5.8的警告。
Updated references to current stable boot EEPROM to2020-12-142020-12-11。
添加了有关PI4引导固件问题的一般警告，并链接到发布列表。
添加了有关USB3干扰Zigbee，Zwave的警告，…
添加了“事实汇编”部分，以总结细节和信息。
[UPDATE 2021-01-11 by@Jpsy]:
RASPI-CONFIG菜单项序列更新。谢谢@Egon有关信息。
引用在英特尔的文档中添加了有关USB3干扰WLAN，Zigbee，Zwave，蓝牙的参考…谢谢@TLDP，，，，@kcyeoh以及所有提到它的人。
[更新2021-01-18@Jpsy]:
添加了“重新启动 /温暖靴 /软靴子上的问题”一章
[更新2021-02-18@Jay_P]:
更新固件发布状态：默认和最新的是指向旧版本名称的符号链接批判的和稳定的。
RPI 3为HA已死！
我终于发现我的RPI 3B上HA的滞后和悬挂是太多附加组件的结果很快填充了1 GB的记忆。我考虑切换到NUC或基于AMD 4500U的系统。但是我喜欢PIS及其小碳足迹的低功耗。因此，我决定尝试PI频谱的当前上端：
Long live HA on Raspberry Pi 4b
…（最多）8GB内存并直接从SSD启动！
更新：
您可能需要考虑使用4GB而不是新PI考虑ODROID-N2+。N2+实际上是由HA开发人员推荐的。
在开始之前，我想让您意识到HA开发人员推荐另一个硬件：odroid-n2+。甚至还有一个美丽的HA品牌套管，捆绑了您需要开始的一切。看19463331伟德国际家庭助理蓝色。我不知道Odroid是否有与PI 4具有的USB适配器有关的任何兼容性问题（并且我们将在下面介绍）。但是，如果您尚未做出决定并订购了硬件，我诚实地建议您使用HA Blue Package。我使用PI4 8 GB的唯一原因是我运行它（没有问题），并且它具有8 GB，而Odroid只有4 GB。
但是本指南是关于PI 4B的而你在这里，因为您正在寻找它。因此，让我们开始...
On the way from Pi3 to Pi4 and from SD to SSD I faced some problems:
HA尚未正式支持8GB版本。HA的完整SSD靴子尚未正式用于PI 4。- PI4上的SSD引导仍然充满陷阱。这不是家庭助理问题，而是覆盆19463331伟德国际子PI问题。尤其是EEPROM Bootloader固件无法与市场上所有可用的USB到SATA适配器一起使用。
幸运的是，这些问题可以解决，结果系统可完美地工作，并且是极其fast! The 8GB memory provides HA with enough space to run many add-ons and a long data history (30 days in my setup) without starting to swap or choke. And there is always plenty of in memory buffer and cache available to keep DB accesses really fast.
以下说明将适用于PI 4B - 1、2、4、8 GB的所有版本。实际上，您可能有更多的选项，其版本低于8 GB（例如使用32位版本的HA）。但是我仍然建议使用8 GB版本，因为它肯定会让您感到高兴更长的时间。
因此，让我们逐步进入那里：
使用正确的SATA到USB3适配器
这是可以的the one most important step为了你的成功。并非所有可用的SATA适配器都在RPI 4上工作。这不是HA问题，而是通用的RPI问题。请参见this very helpful blog posting詹姆斯·A·钱伯斯（James A. Chambers）。它包含工作和非工作适配器的列表。我从基于JMICRON JMS583桥芯片的Sabrent适配器开始，这给了我一些麻烦。IE。它仅在连接到USB2端口之一时可靠地工作 - 不在USB3上。然后，我改用了一个对我来说像魅力一样工作的Eluteng适配器，也很便宜。
更新2021-01-08：
Unfortunately it turns out that there are two versions of the ELUTENG that look nearly identical but use different chip sets. One of them only works on USB2. So if you are looking for a working solution my current recommendation is that you use either of these two adaptors:
- Startech 2.5英寸SATA到USB 3.1适配器
- StarTech 2.5″ SATA to USB 3.0 Adapter
使用足够的电源
这第二重要因素为了您的成功，是使用能够驱动PI 4和（！）SSD的电源。没有什么比电源不足更具头痛的。当您不期望它时，您的系统将停滞不前，而您将不明白为什么！
至少使用3安培的原始PI 4电源插头。如果您可以获得3.5安培或更多安培的高质量供应：使用它！
另外，您可以使用动力USB集线器或外壳为您的SSD提供专用的电源。我个人不喜欢这个想法，因为第二个电源插头会产生额外的能源损失，并且是可能破裂的另一个项目。但这仍然比不稳定的供应要好得多。
使用Raspberry OS更新EEPROM固件
RPI 4具有启动EEPROM（RPI 3没有！）。您必须将该EEPROM更新为最新的固件（2020-12-11或更高），该固件可实现USB启动。要更新EEPROM，您必须暂时安装Raspberry OS。我为此使用了SD卡。如果您想了解更多，您可以阅读Raspberry Pi文档但是我们将在这里详细介绍所有步骤。
（（暗示：这re seems to be a simpler way to update the EEPROM firmware through Raspberry Pi Imager instead of Raspberry Pi OS. I did not try that option. If you want to go for it, check这个评论以下。）
First download Raspberry OS and burn it onto an SD card. You do that using Raspberry Pi Imager. Versions for Windows, Mac and Ubuntu are在这里可用。
a）如果您有键盘，鼠标和监视器附加到PI上
这是我的建议，但是您将需要一条微型HDMI适配器电缆，您可能没有。如果这样做，只需使用该SD卡启动PI，然后随附了监视/键盘/鼠标。浏览初始设置过程。
完成后，打开一个终端窗口。
B) If you have NO monitor attached to the Pi:
准备通过SSH访问Pi的外壳。为此，您只需在SD卡上的引导分区的根部添加一个名为“ SSH”（无文件扩展名）的空文件。您应该有两个分区。第一个（和较小）是引导分区。将文件放在那里。
现在，使用该SD卡启动您的PI，然后通过网络上的另一个设备通过SSH访问PI的外壳。
这SSH-file on the boot partition is deleted on first boot, so you will loose SSH access when you reboot. To keep SSH access launch raspi-config now from the command line:
sudo raspi-config
经过…
接口选项»SSH»是的»好的»结束
更新引导EEPROM固件
这是通过告诉OS使用最新稳定版本进行所有更新来完成的，然后重新启动：
编辑rpi-eeprom-update文件，然后将pindareware_release_status从“默认”更改为“最新”：
sudo nano /etc/default/rpi-eeprom-update
更改文件，保存并退出纳米。然后…
sudo apt更新sudo apt全升级sudo重新启动
让系统重新启动。EEPROM应在启动过程中自动更新。
检查EEPROM版本
sudo rpi-eeprom update
现在，这应该至少报告固件2020-12-11或更高。
警告：
RPI 4的引导EEPROM开发目前是矿场！
您的USB到-SATA适配器可能包含与当前引导代码不兼容的芯片组。有许多问题报告。上面提到的Startech适配器应避免您避免使用。但是没有保证。一些用户在较旧的（！）引导EEPROM版本中运气更好。看到Pi4 bootloader EEPROM release notes对于稳定版和beta版本的列表。
使用raspi-config将引导配置设置为SSD启动
sudo raspi-config
Go through these menu items:
高级选项»引导加载程序版本»最新的»好的
当系统要求“重置启动ROM默认”时选择不（!!!）使用最新的启动ROM。高级选项»引导顺序»USB引导»好的结束»重启»关闭
我们现在在Raspberry Pi OS中完成。我建议您使用RPI OS保留该SD卡！您可以随时使用它以获取更多EEPROM更新。访问您的HA SSD并挽救您的配置和数据也很有帮助，以防HA应该拒绝开始一天！
SSD的Fl19463331伟德国际ash Home Assistant
现在从这里下载最新的家庭助理5.x OS：19463331伟德国际
Look for the latest “Release 5 build X (Stable)” (5.10 at the time of this writing).
在更改列表下打开“资产”面板以查看下载。
查找图像HASSOS_RPI4-64-5.x.img.gz-确保它是RPI4（不是RPI3）和64位。
AFAIK 8 GB PI不会使用32位版本运行。
警告：请勿使用HA OS 5.4！该版本存在一个问题，它影响了一些RPI4，但并非全部。（请参阅下面的讨论。）也不使用HA OS版本5.6至5.8。这些包含自己的启动EEPROM更新代码，该代码将Beta版本刷到EEPROM中。这种方法在5.9中被删除。
使用Balena Etcher或类似的工具将图像刷到SSD上。
（是的，Balena可以闪烁到SSD，不仅是SD！）
Start Home Assistant
将SSD插入PI，取出任何剩余的SD卡并引导。
查看http：// homeassistant：8123在您的网络上或将端口8123与路由器DHCP分配的IP一起使用。
It helps to follow the boot process on a monitor that is directly attached to the Pi. You will need a micro-HDMI adapter cable for that.
当初始登录屏幕出现时，请勿使用此屏幕的快照还原功能。有多个报告称，从这里安装快照行不通，甚至可能破坏您的Virgin HA安装。与其他HA OS版本创建的快照似乎有些不兼容。而是定义新的管理用户并进行新的首次启动。然后转到主管»快照，然后使用右上角的DOT菜单上传并恢复快照。
引导冥想？
当您等待初始登录屏幕时，您可能会遇到启动时间极长（> 10分钟）。如果发生这种情况，您有多个选择：
- 检查部分“使用正确的SATA到USB3适配器”多于。您可能会使用不兼容的SATA来实现USB3适配器或外壳。尝试上面推荐的Startech。
- 尝试通过USB 2端口（黑色）而不是USB 3.0端口（蓝色）连接SSD。我知道这听起来很奇怪，但请真的！如果这对您有用，这可能是您的最佳选择。尽管USB 2比USB 3.0慢得多，您将获得一个非常快的系统。但是，如果选项2.适合您，则还应该重新考虑选项1。很有可能您的适配器或外壳是罪魁祸首。
- 检查您的SSD外壳还是SATA到USB适配器是基于JMICRON JMS583桥芯片的。该芯片有一个解决问题的固件更新。对于Sabrent设备，可以找到所有受影响设备的更新这里。但是我也提醒您，我自己的Sabrent适配器从未真正为我工作。阅读1.再次！
- 确保您的电源能够喂养PI和（！）SSD。
检查部分“使用足够的电源”多于。
最后麻烦之后的好消息是：
你完成了！享受您的新HA安装。
重新启动 /温暖靴 /软靴子上的问题
You are done? Well, maybe not completely. Sorry.
Some users experience problems when they restart their Pi without powering off. There is a lot of discussion on the Pi issue tracker about this problem and it is not completely solved yet (also not for RPi OS). It seems to be connected to the fact that the Pi cuts USB power on reboot for a short moment. For some drives this power-off time seems to be ok, for others too short or too long. To make things worse, RPi4 8 GB seems to behave differently from Pis with less RAM: 8 GB does a longer power-off on reboot (which seems to create less over-all problems). If HA hangs on reboot, but boots fine when you cut the power and plug it back in, then you are affected. There are options in EEPROM config that may solve this problem (USB_MSD_PWR_OFF_TIME, POWER_OFF_ON_HALT). Seehttps://github.com/raspberrypi/rpi-eeprom/issues/266有关详细信息。
警告USB3
USB3信号频率可能严重干扰with WLAN, Zigbee, ZWave, Bluetooth, enOcean!
使用USB扩展电缆（男性到女性）将无线电棒远离PI。
将您的USB2无线电棒连接到USB3的USB2端口。（好吧，实际上，USB3端口只要在USB2模式下运行，但最好不要推动运气）。
读英特尔关于USB3干扰的文件to understand the details and how you can place and shield your devices.
更新家庭助理OS的开发版本19463331伟德国际
关于HA OS的书呆子信息。这主要是对早期采用者的内置，而5.x OS仍在开发中：
如果新的5.x开发版本可用，则可能会发现HA Frontend中的主管菜单也不会为您提供更新，即使您已切换到Beta频道。这是由于此处仅提供稳定版和beta版本的事实，而不是开发版本。但是您可以随时使用HA的命令行接口（CLI）更新操作系统。为此，您需要SSH Shell访问HA。有多个附加组件暴露了SSH（我的建议：弗朗西克的伟大”SSH& Web Terminal”）。
在外壳中，您可以使用以下命令将OS更新为定义的版本：
HA OS更新 - Version 5.10
Try this command before and after the update to get some system info:
HA OS信息
事实的汇编
这是一系列被压缩的事实集合，这些事实分布在上面的整个指南中。
可能有助于射击麻烦。
- HA OS版本5.0至5.5没有更改启动EEPROM
- HA OS versions 5.6 to 5.8 DO change the boot EEPROM to version 2020-10-28 - BETA. This was beta but considered the better solution for many users because it solves reboot hangs for many drives.
- HA OS版本自5.9以来不再更改启动EEPROM以将控制归还给用户。
- 这re are multiple generations of “stable” boot EEPROM versions available (see发布列表).
但是，即使在RPI GitHub存储库中，也有很多问题报告。因此，我建议如果您找到了一个适合您的EEPROM版本，则此时不会升级EEPROM。
- 总而言之，现在似乎可以手动尝试几个稳定的启动EEPROM版本，并避免使用HA OS版本5.6至5.8，因为它们会自己覆盖EEPROM。从指南中描述的最新稳定EEPROM版本开始。
- 这re seem to be problems with some adapter chip sets when switching to UAS (USB Attached SCSI, UAS or UASP) during Linux system startup. But I still have to gather information about that.
- 一些驱动器似乎挂在重启上。RPI4在8 GB和RAM较少的版本之间有所不同。所有人都可以关闭USB功率，但是8 GB版本可以更长的时间。如果您的PI最多4GB挂在重新启动上，请尝试真正关闭系统的电源。EEPROM配置中有一些可以解决此问题的选项（USB_MSD_PWR_OFF_TIME，POWER_OFF_OND_ON_HALT）。看https://github.com/raspberrypi/rpi-eeprom/issues/266。
- 确保您的RPI电源足以为PI和SSD提供动力。更好地使用具有3安培输出的原始RPI4电源。如果您发现具有超过3安培的质量供应：使用它。
- USB3信号频率可能会严重干扰WLAN，Zigbee，Zwave，蓝牙，Enocean。使用男性女性USB适配器电缆使您的无线电棒远离PI。将您的棍棒连接到USB2而不是3。
