本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 教程：准备 Raspberry Pi 运行影子应用程序
<a name="create-resources-shadow"></a>

本教程演示如何设置和配置 Raspberry Pi 设备，以及如何创建设备连接和交换 MQTT 消息所需的 AWS IoT 资源。

**注意**  
如果您计划 [使用 Amazon EC2 创建虚拟设备](creating-a-virtual-thing.md)，您可以跳过此页面并继续执行 [配置您的设备](configure-device.md)。创建虚拟事物时，您将创建这些资源。如果您想使用不同的设备，而不是 Raspberry Pi，可以尝试按照这些教程进行操作，将它们调整到您选择的设备。

**在本教程中，您将学习如何：**
+ 设置 Raspberry Pi 设备并将其配置为与一起使用 AWS IoT。
+ 创建 AWS IoT 策略文档，授权您的设备与 AWS IoT 服务进行交互。
+ 在 X.509 设备证书 AWS IoT 中创建事物资源，然后附加策略文档。

  事物是您的设备在 AWS IoT 注册表中的虚拟展示。证书用于向 C AWS IoT ore 对您的设备进行身份验证，策略文档授权您的设备与之交互。 AWS IoT

**如何运行本教程？**  
要为 Device Shadow 运行 `shadow.py` 示例应用程序，您将需要一个连接到 AWS IoT的 Raspberry Pi 设备。我们建议您按照此处显示的顺序遵循本教程，首先设置 Raspberry Pi 及其配件，然后创建策略并将策略附加到您创建的事物资源。然后，您可以使用 Raspberry Pi 支持的图形用户界面 (GUI) 在设备的 Web 浏览器上打开 AWS IoT 控制台，从而更轻松地将证书直接下载到 Raspberry Pi 进行连接 AWS IoT。

**在开始本教程之前，请确保您具有：**
+ 一个 AWS 账户。如果您没有账户，请完成 [设置 AWS 账户](setting-up.md)中介绍的步骤然后继续操作。你需要你的 AWS 账户 和 AWS IoT 主机才能完成本教程。
+ Raspberry Pi 及其必要的配件。您将需要：
  + [Raspberry Pi 3 Model B](https://www.raspberrypi.com/products/) 或更新型号。本教程可能适用于早期版本的 Raspberry Pi，但我们还没有测试过。
  + [Raspberry Pi OS (32 位)](https://www.raspberrypi.com/software/operating-systems/)或更高版本。我们始终建议使用最新版本的 Raspberry Pi OS。早期版本的操作系统可能有用，但我们还没有测试过。
  + 以太网或 Wi-Fi 连接。
  + 键盘、鼠标、显示器、电缆和电源。

完成本教程需要大约 30 分钟。

## 步骤 1：设置和配置 Raspberry Pi 设备
<a name="setup-device-shadow"></a>

在本节中，我们将配置一台 Raspberry Pi 设备与一起使用 AWS IoT。

**重要**  
将这些指令用于其它设备和操作系统可能会非常困难。您需要充分了解您的设备，以便能够解释这些说明并将它们应用到您的设备上。如果遇到困难，可以尝试使用其它设备选项之一作为替代方案，例如 [使用 Amazon EC2 创建虚拟设备](creating-a-virtual-thing.md) 或者 [使用你的 Windows、Linux 电脑或 Mac 作为 AWS IoT 设备](using-laptop-as-device.md)。

您需要配置您的 Raspberry Pi，以便它可以启动操作系统（OS），连接到互联网，并允许您在命令行界面与它进行交互。您也可以使用 Raspberry Pi 支持的图形用户界面 (GUI) 打开 AWS IoT 控制台并运行本教程的其余部分。

**要设置 Raspberry Pi**

1. 将 SD 卡插入 Raspberry Pi 上的 MicroSD 卡槽。有些 SD 卡预装了一个安装管理器，将为您显示在启动主板后安装操作系统的菜单。您还可以使用 Raspberry Pi 在您的卡上安装操作系统。

1. 将 HDMI TV 或显示器 Connect 到 HDMI 电缆，然后连接到 Raspberry Pi 的 HDMI 端口。

1. 将键盘和鼠标连接到 Raspberry Pi 的 USB 端口，然后插入电源适配器以启动主板。

Raspberry Pi 启动后，如果 SD 卡预先加载了安装管理器，则会出现一个菜单来帮助您安装操作系统。如果您在安装操作系统时遇到问题，请尝试以下步骤。有关设置 Raspberry Pi 的更多信息，请参阅[设置您的 Raspberry Pi](https://projects.raspberrypi.org/en/projects/raspberry-pi-setting-up/)。

**如果您在设置 Raspberry Pi 时遇到问题：**
+ 在启动主板之前，请检查是否插入了 SD 卡。如果在启动主板后插入 SD 卡，则可能不会显示安装菜单。
+ 确保电视或显示器已打开，并且选择了正确的输入信号源。
+ 确保您使用的是兼容 Raspberry Pi 的软件。

安装并配置 Raspberry Pi 操作系统后，打开 Raspberry Pi 的 Web 浏览器并导航到 AWS IoT Core 控制台，继续本教程中的其余步骤。

如果你能打开 AWS IoT Core 主机，那么 Raspberry Pi 就准备好了，你可以继续[教程：在中配置您的设备 AWS IoT](shadow-provision-cloud.md)。

如果您遇到问题或需要其它帮助，请参阅[为您的 Raspberry Pi 获取帮助](https://projects.raspberrypi.org/en/projects/raspberry-pi-setting-up/5)。