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

# 教程： AWS 物联网入门 FleetWise
<a name="fleetwise-getting-started"></a>

借助 AWS 物联网 FleetWise，您可以收集、转换和传输车辆数据。使用本节中的教程开始使用 AWS IoT FleetWise。

要了解有关 AWS IoT 的更多信息，请参阅以下主题 FleetWise：
+ [将 AWS 物联网 FleetWise 数据摄取到云端](data-ingestion.md)
+ [对 AWS 物联网 FleetWise 车辆进行建模](vehicle-modeling.md)
+ [管理 AWS 物联网 FleetWise 车辆](vehicles.md)
+ [在物联网中 AWS 管理车队 FleetWise](fleets.md)
+ [通过活动收集 AWS 物联网 FleetWise 数据](campaigns.md)

## 简介
<a name="getting-started-console-tutorial"></a>

使用 AWS 物联网 FleetWise 近乎实时地收集、转换自动驾驶汽车的独特数据格式并将其传输到云端。您可以访问车队范围的见解。这可以帮助您高效地检测和缓解车辆运行状况问题，高效地传输高价值数据信号和远程诊断问题，同时还能降低成本。

本教程向您展示如何开始使用 AWS 物联网 FleetWise。您将了解如何创建车辆型号（模型清单）、解码器清单、车辆和活动。

有关 AWS IoT 的关键组件和概念的更多信息 FleetWise，请参阅[AWS 物联网的主要概念和特点 FleetWise](how-iotfleetwise-works.md)。

估计时间：约 45 分钟。

**重要**  
您需要为本演示创建和使用的 AWS 物联网 FleetWise 资源付费。有关更多信息，请参阅 [AWS IoT FleetWise ](https://aws.amazon.com/iot-fleetwise/pricing/) *定价页面 FleetWise中的AWS 物联网*。

**Topics**

## 先决条件
<a name="getting-started-tutorial-prerequisites"></a>

要完成本入门教程，首先需要满足以下条件：
+ 一个 AWS 账户。如果您没有 AWS 账户，请参阅《*AWS 账户管理 参考指南》 AWS 账户*中的[创建](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-creating.html)。
+ 访问支持 AWS 物联网 FleetWise的。 AWS 区域 目前，美国东部（弗吉尼亚北部）和欧洲（法兰克福）支持 AWS 物联网 FleetWise 。您可以使用中的区域选择器切换 AWS 管理控制台 到其中一个区域。有关更多信息，请参阅 [AWS IoT FleetWise 终端节点和配额](https://docs.aws.amazon.com/general/latest/gr/iotfleetwise.html)。
+ Amazon Timestream 资源：
  + Amazon Timestream 数据库。有关更多信息，请参阅《Amazon Timestream 开发人员指南》**中的[创建数据库](https://docs.aws.amazon.com/timestream/latest/developerguide/console_timestream.html#console_timestream.db.using-console)。
  + 在 Amazon Timestream 中创建的用于保存数据的 Amazon Timestream 表。有关更多信息，请参阅《Amazon Timestream 开发人员指南》**中的[创建表](https://docs.aws.amazon.com/timestream/latest/developerguide/console_timestream.html#console_timestream.table.using-console)。
+ 边缘代理软件演示。（设置演示的说明将在下一步中介绍。） 
  + 您可以使用 Explore Edge Agent 快速入门演示来探索 AWS 物联网 FleetWise 并学习如何为 AWS 物联网开发边缘代理软件 FleetWise。此演示使用 CloudFormation 模板。它将引导您查看边缘代理软件参考实现，开发边缘代理，然后在 Amazon EC2 Graviton 上部署边缘代理软件并生成车辆数据示例。该演示还提供了一个脚本，您可以使用该脚本在云端创建信号目录、车辆模型、解码器清单、车辆、车队和活动。
  + 要下载演示，请导航到 [AWS IoT FleetWise 控制台](https://console.aws.amazon.com/iotfleetwise/)。在服务主页上的 “** AWS 物联网入门**” FleetWise 部分，选择 “**探索 Edge Agent**”。

## 步骤 1：为 AWS 物联网设置边缘代理软件 FleetWise
<a name="getting-started-tutorial-edge-setup"></a>

**注意**  
此步骤中的 CloudFormation 堆栈使用遥测数据。您也可以使用视觉系统数据创建 CloudFormation 堆栈。有关更多信息，请参阅[视觉系统数据开发人员指南**](https://github.com/aws/aws-iot-fleetwise-edge/blob/main/docs/dev-guide/vision-system-data/vision-system-data-demo.ipynb)。  
视觉系统数据目前为预览版，可能会发生变化。

适用于 AWS 物联网的 Edge Agent 软件 FleetWise 可促进车辆与云之间的通信。该软件接收来自数据收集方案的说明如何从联网车辆收集数据的指令。

要设置边缘代理软件，请在**常规信息**中执行以下操作：

1. 打开[启动 CloudFormation 模板](https://us-east-1.console.aws.amazon.com/cloudformation/home?region=us-east-1#/stacks/quickcreate?templateUrl=https%3A%2F%2Faws-iot-fleetwise.s3.us-west-2.amazonaws.com%2Flatest%2Fcfn-templates%2Ffwdemo.yml&stackName=fwdemo)。

1. 在**快速创建堆栈**页面上，在**堆栈名称**中输入您的物 AWS 联网 FleetWise 资源堆栈的名称。堆栈是一个友好的名称，它以前缀形式出现在此 CloudFormation 模板创建的资源名称上。

1. 在**参数**下，输入与堆栈相关的参数的自定义值。

   1. **Fleetsize** ‐ 可以通过更新 Fleetsize 参数来增加车队中的车辆数量。

   1. **Io TCore 区域**-您可以通过更新 Io Region 参数来指定创建 AWS IoT 事物的TCore区域。您必须使用与创建 AWS 物联网 FleetWise 车辆相同的区域。有关更多信息 AWS 区域，请参阅[区域和区域-Amazon Elastic Compute Cloud](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-regions-availability-zones.html#using-regions-availability-zones-setup)。

1. 在**功能**部分中，选中复选框以确认 CloudFormation 创建了 IAM 资源。

1. 选择**创建堆栈**，然后等待大约 15 分钟，等到堆栈的状态显示为 CREATE\$1COMPLETE。

1. 要确认堆栈已创建，请选择**堆栈信息**选项卡，刷新视图，然后查找 CREATE\$1COMPLETE。

![\[显示创建完成确认通知的 AWS IoT FleetWise 堆栈信息选项卡。\]](http://docs.aws.amazon.com/zh_cn/iot-fleetwise/latest/developerguide/images/create-complete.png)


**重要**  
您需要为本演示创建和使用的 AWS 物联网 FleetWise 资源付费。有关更多信息，请参阅 [AWS IoT FleetWise ](https://aws.amazon.com/iot-fleetwise/pricing/) *定价页面 FleetWise中的AWS 物联网*。

## 步骤 2：创建车辆型号
<a name="getting-started-tutorial-vehicle-model-creation"></a>

**重要**  
您无法在 AWS 物联网 FleetWise 控制台中创建带有视觉系统数据信号的车辆模型。可改用 AWS CLI。

可以使用车辆模型来标准化车辆的格式，并帮助定义所创建的车辆中信号之间的关系。创建车辆模型时还会创建*信号目录*。信号目录是标准化信号的集合，可以重用这些目录来创建车辆型号。。信号是用于定义是否包含车辆数据及其元数据的基本结构。目前， AWS 物联网 FleetWise 服务 AWS 区域 每个账户仅支持一个信号目录。这有助于确保处理的车队数据保持一致。

**创建车辆型号**

1. 打开 AWS 物联网 FleetWise 控制台。

1. 在导航窗格中，选择**车辆型号**。

1. 在**车辆型号**页面上，选择**创建车辆型号**。

1. 在**一般信息**部分，输入您的车辆型号的名称（例如 Vehicle1）和可选描述。然后选择**下一步**。

1.  从信号目录中选择一个或多个信号。您可以在搜索目录中按名称筛选信号，也可以从列表中选择信号。例如，您可以选择轮胎压力和制动压力信号，以便收集与这些信号相关的数据。选择**下一步**。

1. 选择您的 .dbc 文件并从本地设备上传。选择**下一步**。
**注意**  
根据本教程，可以下载 [.dbc 文件示例](samples/EngineSignals.zip)以供在此步骤中上传。

1. 在车辆型号中添加属性，然后选择**下一步**。

   1. **名称** - 输入车辆属性的名称，例如制造商名称或制造日期。

   1. **数据类型** - 在**数据类型**菜单上，选择一种数据类型。

   1. **单位** −（可选）输入单位值，例如千米或摄氏度。

   1. **路径** −（可选）输入信号路径的名称，例如 `Vehicle.Engine.Light.`点 (.) 表示它是子信号。

   1. **默认值** -（可选）输入默认值。

   1. **描述** -（可选）输入属性的描述。

1. 审核您的配置。当您准备好后，选择 **Create**（创建）。系统将显示一条通知，说明您的车辆型号已成功创建。

![\[显示您的车辆模型已成功创建的 AWS 物联网 FleetWise 通知。\]](http://docs.aws.amazon.com/zh_cn/iot-fleetwise/latest/developerguide/images/vehicle-model-status.png)


## 步骤 3：创建解码器清单
<a name="getting-started-tutorial-decoder-manifest-creation"></a>

解码器清单与您创建的车辆型号关联。它们包含有助于 AWS 物联网 FleetWise 解码车辆数据并将其从二进制格式转换为可供分析的人类可读值的信息。网络接口和解码器信号是帮助配置解码器清单的组件。网络接口包含有关您的车辆网络使用的 CAN 或 OBD 协议的信息。解码器信号为特定信号提供解码信息。

**创建解码器清单**

1. 打开 AWS 物联网 FleetWise 控制台。

1. 在导航窗格中，选择**车辆型号**。

1. 在**车辆型号**部分，选择要用于创建解码器清单的车辆型号。

1. 选择**创建解码器清单**。

## 步骤 4：配置解码器清单
<a name="getting-started-tutorial-configuration"></a>

**配置解码器清单**
**重要**  
您无法使用物 AWS 联 FleetWise 网控制台在解码器清单中配置视觉系统数据信号。可改用 AWS CLI。有关更多信息，请参阅 [创建解码器清单 (AWS CLI)](create-decoder-manifest.md#create-decoder-manifest-cli)。

1. 为了帮助您识别解码器清单，请为其输入名称和可选描述。然后选择**下一步**。

1. 要添加一个或多个网络接口，请选择 CAN\$1INTERFACE 或 OBD\$1INTERFACE 类型。
   + **板载诊断 (OBD) 接**口-如果您想要一个定义电子控制单元之间如何通信自诊断数据的协议，请选择此接口类型（）ECUs。该协议提供了许多标准的诊断故障代码 (DTCs)，可以帮助您解决车辆问题。
   + **控制器局域网（CAN 总线）**接口-如果您想要一个定义数据之间如何通信的协议，请选择此接口类型 ECUs。 ECUs 可以是发动机控制单元、安全气囊或音频系统。

1. 输入网络接口的名称。

1. 要向网络接口添加信号，请从列表中选择一个或多个信号。

1. 为在上一步中添加的信号选择解码器信号。要提供解码信息，请上传 .dbc 文件。车辆模型中的每个信号都必须与解码器信号（可从列表中选择）配对。

1. 要添加另一个网络接口，请选择**添加网络接口**。添加网络接口后，选择**下一步**。

1. 检查配置，然后选择**创建**。系统将显示一条通知，说明您的解码器清单已成功创建。

## 步骤 5：创建车辆
<a name="getting-started-tutorial-vehicle-creation"></a>

在 AWS 物联网中 FleetWise，车辆是现实生活中的实体车辆的虚拟代表。使用相同车辆模型创建的所有车辆都继承一组相同的信号，并且您创建的每个车辆都对应于一个新创建的 IoT 事物。您必须将所有车辆与解码器清单相关联。

**先决条件**

1. 确认您已经创建了车辆模型和解码器清单。此外，还要确认车辆模型的状态为**活动**。

   1. 要验证车辆模型的状态是否为激活，请打开 AWS 物联网 FleetWise 控制台。

   1. 在导航窗格中，选择**车辆型号**。

   1. 在**摘要**部分的**状态**下，查看您的车辆状态。

![\[“摘要” 部分的 AWS 物联网 FleetWise 屏幕截图显示了您的车辆状态。\]](http://docs.aws.amazon.com/zh_cn/iot-fleetwise/latest/developerguide/images/vehicle-model-status.png)


**创建车辆**

1. 打开 AWS FleetWise 控制台。

1. 在导航窗格中，选择**车辆**。

1. 选择**创建车辆**。

1. 要定义车辆属性，请输入车辆名称，然后选择模型清单（车辆型号）和解码器清单。

1. （可选）要定义车辆属性，请输入键值对，然后选择**添加属性**。

1. （可选）要为您的 AWS 资源添加标签，请添加标签，然后选择**添加新标签**。

1. 选择**下一步**。

1. 要配置车辆证书，您可以上传自己的证书，也可以选择**自动生成新证书**。建议您自动生成证书，以便更快地进行设置。如果您已经有证书，可以选择改用您的证书。

1. 下载公钥和私钥文件，然后选择**下一步**。

1. 要将策略附加到车辆证书，可以输入现有策略名称或创建新策略。要创建新策略，请选择**创建策略**，然后选择**下一步**。

1. 审核您的配置。完成后，选择**创建车辆**。

## 步骤 6：创建活动
<a name="getting-started-tutorial-campaign-creation"></a>

在 AWS 物联网中 FleetWise，活动用于促进数据从车辆的选择、收集和传输到云端。活动包含数据收集方案，这些方案向边缘代理软件提供有关如何使用基于条件的收集方案或基于时间的收集方案收集数据的指令。

**创建市场活动**

1. 打开 AWS 物联网 FleetWise 控制台。

1. 在导航窗格中，选择**活动**。

1. 选择**创建市场活动**。

1. 输入活动名称和可选描述。

1. 要配置活动的数据收集方案，可以手动定义数据收集方案，或者从本地设备上传 .json 文件。上传 .json 文件可自动定义数据收集方案。

   1. 要手动定义数据收集方案，请选择**定义数据收集方案**，然后选择要用于活动的数据收集方案类型。您可以选择**基于条件**的收集方案或**基于时间**的收集方案。

   1. 如果选择**基于时间**的收集方案，则必须指定活动收集车辆数据的时长。

   1. 如果选择基于条件的数据收集方案，则必须指定一个表达式来识别要收集哪些数据。确保将信号的名称指定为变量、比较运算符和比较值。

   1. （可选）选择表达式的语言版本，或将其保留为默认值 1。

   1. （可选）指定两个数据收集事件之间的触发间隔。

   1. 要收集数据，请选择边缘代理软件的**触发**模式条件。默认情况下，适用于 AWS 物联网的 Edge Agent FleetWise 软件**始终**在满足条件时收集数据。或者，它只在第一次满足条件时收集数据，即**首次触发时**。

   1. （可选）可以选择更多高级方案选项。

1. 要指定数据收集方案将从中收集数据的信号，请从菜单中搜索信号的名称。

1. （可选）可以选择最大样本数或最小采样间隔。您还可以添加更多信号。

1. 选择**下一步**。

1. 定义您希望活动将数据传输到的存储目标。您可以将数据存储在 Amazon S3 或 Amazon Timestream 中。

   1. Amazon S3 — 选择 AWS IoT FleetWise 有权访问的 S3 存储桶。

   1. Amazon Timestream - 选择 Timestream 数据库和表名。输入允许向 Timestream AWS IoT FleetWise 发送数据的 IAM 角色。

1. 选择**下一步**。

1. 从搜索框中选择车辆属性或车辆名称。

1. 输入与您为车辆选择的属性或名称相关的值。

1. 选择您的活动将从中收集数据的车辆。然后选择**下一步**。

1. 检查活动配置，然后选择**创建活动**。您或您的团队必须将活动部署到车辆上。

## 步骤 7：清除
<a name="tutorial-cleanup"></a>

为避免对您在本教程中使用的资源收取更多费用，请删除 CloudFormation 堆栈和所有堆栈资源。

**删除 CloudFormation 堆栈**

1. 打开 [CloudFormation 控制台](https://console.aws.amazon.com/cloudformation)。

1. 从**堆栈**列表中，选择您在步骤 1 中创建的堆栈。

1. 选择**删除**。

1. 要确认删除，选择 **Delete (删除)**。删除堆栈约需 15 分钟时间。

## 后续步骤
<a name="getting-started-tutorial-next-steps"></a>

1. 您可以处理和可视化活动收集到的车辆数据。有关更多信息，请参阅 [可视化 AWS 物联网 FleetWise 车辆数据](process-visualize-data.md)。

1. 您可以对 AWS 物联网问题进行故障排除和解决 FleetWise。有关更多信息，请参阅 [AWS 物联网故障排除 FleetWise](troubleshooting.md)。