试试 Amazon IoT 快速连接 - Amazon IoT Core
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

试试 Amazon IoT 快速连接

在本教程中,您将创建您的第一件事物对象,将设备连接到该对象,并观看其发送 MQTT 消息。

您预计需要花费 15-20 分钟来完成本教程。

本教程最适合想要快速入门 Amazon IoT 以了解其在有限场景中工作原理的人士。如果您正在寻找一个能够帮助您入门以便您能够探索更多功能和服务的示例,请尝试 通过详细教程了解 Amazon IoT Core 服务

在本教程中,您将在 Amazon IoT Core 中连接到事物资源的设备上下载并运行软件,以作为一个极小的 IoT 解决方案的一部分。该设备可以是 IoT 设备,如 Raspberry Pi,也可以是运行 Linux、OS 和 OSX 或 Windows 的电脑。如果您希望将远程广域网 (LoRaWAN) 设备连接到 Amazon IoT,请参阅教程将设备和网关连接到适用于 LoRaWAN 的 Amazon IoT Core

如果您的设备支持可以运行 Amazon IoT 控制台的浏览器,我们建议您在该设备上完成本教程。

注意

如果您的设备没有兼容的浏览器,请在电脑上遵循本教程。当流程要求您下载文件时,请将其下载到您的电脑,然后使用 Secure Copy (SCP) 或类似流程将下载的文件传输到您的设备。

本教程要求您的 IoT 设备与 Amazon Web Services 账户 的设备数据终端节点上的端口 8443 进行通信。要测试它是否可以访问该端口,请尝试测试与设备数据终端节点的连接中的步骤。

第 1 步 开始教程

如果可能,请在您的设备上完成此流程;否则,请在本流程随后的步骤中准备好将文件传输到您的设备。

  1. 打开您的 Amazon IoT 控制台,在左侧菜单中,选择 Learn(学习)。

    
                            Amazon IoT 控制台主页
  2. Connect to Amazon IoT(连接到 IoT)磁贴,选择 View connection options(查看连接选项)。

    
                            Amazon IoT 控制台学习主页
  3. Onboard a device(挂载设备)磁贴,选择 Get started(开始)。

    
                            Amazon IoT 控制台连接选项页
  4. 查看步骤,其中描述了您将在本教程中执行的操作。准备就绪后,选择 Get started(开始)。

    
                            Amazon IoT 控制台连接快速入门概览页

第 2 步 创建一个事物对象

  1. How are you connecting to Amazon IoT?(您如何连接到 Amazon IoT?)页面上,选择平台和您要使用的 Amazon IoT Device SDK 的语言。本示例使用 Linux/OSX 平台和 Python 开发工具包。请确保在目标设备上安装了 python3 和 pip3,再继续下一步。

    注意

    请务必在控制台页面底部检查所选 SDK 所需的必备软件列表。

    您必须先在目标电脑上安装所需的软件,然后才能继续执行下一步。

    选择好平台和 Device SDK 语言后,选择 Next(下一步)。

    
                            Amazon IoT 控制台快速入门选项页面
  2. Name(名称)字段中,输入事物对象的名称。本例中使用的事物名称为 MyIotThing

    重要

    在继续之前,请仔细检查您的事物名称。

    事物对象创建后便无法更改事物名称。如果要更改事物名称,您必须使用正确的事物名称创建新事物对象,然后删除名称不正确的事物。

    
                            Amazon IoT 控制台事物名称页面
  3. 为事物对象指定一个名称后,选择 Next step(下一步)。

    
                            带有名称的 Amazon IoT 控制台事物名称页

第 3 步 将文件下载到您的设备

此页面将在 Amazon IoT 创建连接工具包后显示,工具包中将包括设备所需的以下文件和资源:

  • 用于对设备进行身份验证的事物证书文件

  • 一个策略资源,用于授权事物对象与 Amazon IoT 交互

  • 用于下载 Amazon Device SDK 并在设备上运行示例程序的脚本

  1. 准备好继续后,请选择下载连接套件按钮为您之前选择的平台下载连接工具包。

    
                            Amazon IoT 控制台证书文件下载页面
  2. 如果您在设备上运行此流程,请将连接工具包文件保存到可运行命令行命令的目录中。

    如果您未在设备上运行此流程,请将连接工具包文件保存到本地目录中,然后将该文件传输到您的设备。

  3. 设备获取连接工具包文件后,请选择 Next step(下一步)继续教程。

    
                            下载连接工具包后的 Amazon IoT 控制台证书文件下载页面

第 4 步 运行示例

您可以在设备上的终端或命令窗口中执行此程序,同时按照控制台中显示的说明进行操作。控制台中显示的命令适用于您在 第 2 步 创建一个事物对象 中选择的操作系统。此处显示的内容适用于 Linux/OSX 操作系统。

  1. 在设备的终端或命令窗口中,在包含连接工具包文件的目录里,执行 Amazon IoT 控制台中显示的步骤。

    如果您使用的是 Windows PowerShell 命令窗口,且 unzip 命令不起作用,请将 unzip 替换为 expand-archive,然后再次尝试命令行。

    
                            Amazon IoT 控制台快速入门安装和运行页面
  2. 在控制台中输入 Step 3(步骤 3)的命令后,您应该会在设备的终端或命令窗口中看到类似以下内容的输出。此输出来自程序发出然后由 Amazon IoT Core 接收的消息。

    
                            Amazon IoT 控制台快速入门示例程序输出

    运行示例程序时,请在 Step 4: Send a message to the device(步骤 4:向设备发送消息)中输入一条消息,例如在 Amazon IoT 控制台中输入 Hello World!。然后选择 Send me(发送消息)来发送该消息。测试消息便会显示在设备的终端或命令窗口中。

    注意

    有关主题订阅和发布的更多信息,请参阅所选开发工具包的示例代码。

  3. 若要再次运行示例程序,您可以在本过程的控制台中重复 Step 3/3(步骤 3/3)的命令。

  4. (可选)如果要在 Amazon IoT 控制台 中查看来自 IoT 客户端的消息,请在 Amazon IoT 控制台的 Test(测试)页面上打开 MQTT 测试客户端。如果选择 Python 开发工具包,请在 MQTT test client(MQTT 测试客户端)的 Topic filter(主题筛选条件)中输入主题(例如 sdk/test/Python),即可订阅来自设备的消息。主题筛选条件区分大小写,并且受到您在 Step 1/1(步骤 1/1)中所选开发工具包的编程语言限制。有关主题订阅和发布的更多信息,请参阅所选开发工具包的代码示例。

  5. 订阅测试主题后,请在设备上运行 ./start.sh。有关更多信息,请参阅使用 Amazon IoT MQTT 客户端查看 MQTT 消息

    运行 ./start.sh 后,MQTT 客户端会显示类似以下内容的消息:

    { "message": "Hello World!", "sequence": 10 }

    每次接收新的 Hello World 消息时,sequence 数量会递增 1,并在您结束程序时停止。

  6. 若要完成本教程并查看摘要,请在 Amazon IoT 控制台中选择 Done(完成)。

    
                            Amazon IoT 控制台快速入门完成

第 5 步 进一步探索

在您完成入门教程后,可以采用以下建议进一步探索 Amazon IoT。