创建 AWS 物联网 FleetWise 车辆模型 - AWS IoT FleetWise
创建车辆型号（控制台）创建车辆型号 (AWS CLI)

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

创建 AWS 物联网 FleetWise 车辆模型

您可以使用 AWS 物联网 FleetWise 控制台或 API 来创建车辆模型。

创建车辆型号（控制台）

在 AWS 物联网 FleetWise 控制台中，您可以通过以下方式创建车辆模型：

使用提供的模板 AWS

AWS 物联网 FleetWise 提供了车载诊断 (OBD) II、J1979 模板，可自动为您创建信号目录、车辆模型和解码器清单。该模板还将 OBD 网络接口添加到解码器清单中。有关更多信息，请参阅 管理 AWS IoT FleetWise 解码器清单。

使用模板创建车辆型号

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

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

  3. 在车辆型号页面上，选择添加提供的模板。

  4. 选择板载诊断 (OBD) II。

  5. 输入 AWS 物联网 FleetWise 正在创建的 OBD 网络接口的名称。

  6. 选择 添加。

手动创建车辆型号

您可以从信号目录中添加信号，也可以通过上传一个或多个.dbc 文件来导入信号。.dbc 文件是控制器局域网（CAN 总线）数据库支持的文件格式。

重要

您无法使用 AWS 物联网 FleetWise控制台创建带有视觉系统数据信号的车辆模型。而是使用 AWS CLI 创建车辆模型。

视觉系统数据目前为预览版，可能会发生变化。

手动创建车辆型号

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

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

  3. 在车辆型号页面上，选择创建车辆型号，然后执行以下操作。

步骤 1：配置车辆型号

在一般信息部分，执行以下操作：

  1. 输入车辆型号的名称。

  2. （可选）输入描述。

  3. 选择下一步。

步骤 2：添加信号

注意

  • 如果这是您首次使用 AWS 物联网 FleetWise，则在您拥有信号目录之前，此步骤不可用。创建第一个车辆模型后， AWS 物联网 FleetWise 会自动创建信号目录，并将信号添加到第一个车辆模型中。

  • 如果您熟悉 AWS 物联网 FleetWise，则可以通过从信号目录中选择信号或上传.dbc 文件来导入信号，从而向车辆模型添加信号。

  • 您必须至少有一个信号才能创建车辆型号。

添加信号

  1. 从要添加到车辆型号中的信号目录中选择一个或多个信号。您可以在右侧窗格中查看所选信号。

    注意

    只有选定的信号才会添加到车辆型号中。

  2. 选择下一步。

第 3 步：导入信号

注意

  • 如果这是您首次使用 AWS 物联网 FleetWise，则必须上传至少一个.dbc 文件才能导入信号。

  • 如果您熟悉 AWS 物联网 FleetWise，则可以通过从信号目录中选择信号或上传.dbc 文件来导入信号，从而向车辆模型添加信号。

  • 您必须至少有一个信号才能创建车辆型号。

导入信号

  1. 选择选择文件。

  2. 在此对话框中，选择包含信号的 .dbc 文件。可以上传多个 .dbc 文件。

  3. AWS 物联网 FleetWise 解析您的.dbc 文件以检索信号。

    在信号部分，为每个信号指定以下元数据。

    • Name - 信号的名称。

      名称必须唯一。信号名称加路径最多可包含 150 个字符。有效字符包括：a-z、A-Z、0-9、:（冒号）和 _（下划线）。

    • 数据类型 — 信号的数据类型必须是以下类型之一： INT8、、、、、、、、、、、BOOLEAN、FLOAT、DOUBLE、STRING UINT8、UNIX_TIMESTAMP INT16 UINT16 INT32、_ARRAY UINT32 INT64、_ARRAY UINT64、_ARRAY、_ARRAY、_ARRAY、BOOLEAN_ARRAY、FLOAT_ARRAY、DOUBLEAN INT8 _ARRAY、DOUBLEAN UINT8 _ARRAY、DOUBLEAN INT16 _ARRAY、STRIN UINT16 G_ARRAY、 INT32 _ARRAY、_ARRAY、 UINT32 _ARRAY、_ARRAY、 INT64 _ARRAY、_ARRAY、BOOLEAN UINT64 _ARRAY、

    • Signal type - 信号的类型，可以是传感器或执行器。

    • （可选）Unit - 信号的科学单位，例如 km 或摄氏度。

    • （可选）Path - 信号的路径。类似于 JSONPath，使用点 (.) 来表示子信号。例如，Vehicle.Engine.Light。

      信号名称加路径最多可包含 150 个字符。有效字符包括：a-z、A-Z、0-9、:（冒号）和 _（下划线）。

    • （可选）Min – 信号的最小值。

    • （可选）Max – 信号的最大值。

    • （可选）Description – 信号的描述。

      描述长度最多为 2048 个字符。有效字符包括：a-z、A-Z、0-9、:（冒号）、_（下划线）和 -（连字符）。

  4. 选择下一步。

（可选）步骤 4：添加属性

您最多可以添加 100 个属性，包括信号目录中的现有属性。

添加属性

  1. 在添加属性中，为每个属性指定以下元数据。

    • Name – 属性的名称

      名称必须唯一。信号名称和路径最多可包含 150 个字符。有效字符包括：a-z、A-Z、0-9、:（冒号）和 _（下划线）

    • 数据类型 — 属性的数据类型必须是以下类型之一： INT8、、、、、、、、、、、BOOLEAN、FLOAT、DOUBLE、STRING UINT8 INT16、UNIX_TIMESTAMP UINT16 INT32、_ARRAY UINT32 INT64、_ARRAY UINT64、_ARRAY、_ARRAY、_ARRAY、BOOLEAN_ARRAY、FLOAT_ARRAY、DOUBLEAN INT8 _ARRAY、DOUBLEAN UINT8 _ARRAY、STRIN INT16 G_ARRAY、_ARRAY、 UINT16 _ARRAY、 INT32 _ARRAY、_ARRAY、 UINT32 _ARRAY、_ARRAY、 INT64 BOOLEAN_ARRAY、FLOAT UINT64 _ARRAY

    • （可选）Unit - 属性的科学单位，例如 km 或摄氏度。

    • （可选）Path - 信号的路径。类似于 JSONPath，使用点 (.) 来表示子信号。例如，Vehicle.Engine.Light。

      信号名称加路径最多可包含 150 个字符。有效字符包括：a-z、A-Z、0-9、:（冒号）和 _（下划线）

    • （可选）Min – 属性的最小值。

    • （可选）Max – 属性的最大值。

    • （可选）Description - 属性的描述。

      描述长度最多为 2048 个字符。有效字符包括：a-z、A-Z、0-9、:（冒号）、_（下划线）和 -（连字符）。

  2. 选择下一步。

第 5 步：审核并创建

验证车辆型号的配置，然后选择创建。

复制车辆型号

AWS 物联网 FleetWise 可以复制现有车辆模型的配置来创建新模型。所选车辆型号中指定的信号将复制到新的车辆型号中。

复制车辆型号

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

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

  3. 从车辆型号列表中选择一个模型，然后选择复制模型。

要配置车辆型号，请按照手动创建车辆型号教程操作。

AWS 物联网可能需要几分钟 FleetWise 才能处理您创建车辆模型的请求。成功创建车辆型号后，在车辆型号页面上，状态列将显示为活动。当车辆型号变为活动状态时，您无法对其进行编辑。

创建车辆型号 (AWS CLI)

您可以使用 CreateModelManifestAPI 操作来创建车辆模型（模型清单）。下面的示例使用了 AWS CLI。

重要

必须先拥有信号目录，然后才能使用 CreateModelManifest API 操作创建车辆模型。有关如何创建信号目录的更多信息，请参阅 创建 AWS 物联网 FleetWise 信号目录。

要创建车辆型号，请运行以下命令。

vehicle-model-configuration替换为包含配置的.json 文件的名称。

aws iotfleetwise create-model-manifest --cli-input-json file://vehicle-model-configuration.json

  • vehicle-model-name替换为您正在创建的车辆模型的名称。

  • signal-catalog-ARN替换为信号目录的亚马逊资源名称 (ARN)。

  • （可选）description替换为描述以帮助您识别车辆型号。

有关如何配置分支、属性、传感器和执行器的更多信息，请参阅配置 AWS 物联网 FleetWise 信号。

{
    "name": "vehicle-model-name",
    "signalCatalogArn": "signal-catalog-ARN", 
    "description": "description",
    "nodes": ["Vehicle.Chassis"]
}

如果您启用了使用客户托管 AWS KMS 密钥的加密，请包括以下政策声明，以便您的角色可以调用 CreateModelManifest API 操作。

{
  "Version": "2012-10-17",
  "Statement": [

    {
      "Effect": "Allow",
      "Action": [
        "kms:GenerateDataKey*",
        "kms:Decrypt"
      ],
      "Resource": [
        "arn:aws:kms:KMS_KEY_REGION:KMS_KEY_ACCOUNT_ID:key/KMS_KEY_ID"
      ]
    },
  ]
}