

AWS IoT FleetWise は、2026 年 4 月 30 日をもって新規顧客に公開されなくなります。既存の AWS IoT FleetWise のお客様は、このサービスを引き続き使用できます。[の「接続モビリティのガイダンス AWS](https://aws.amazon.com/solutions/guidance/connected-mobility-on-aws/)」では、 AWS IoT FleetWise と同等の機能を実現するために使用できる接続モビリティソリューションのモジュラーサービスを開発およびデプロイする方法に関するガイダンスを提供します。

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Configure AWS IoT FleetWise シグナル
<a name="define-signal"></a>

このセクションでは、ブランチ、属性、センサー、アクチュエータの構成方法を説明します。

**Topics**
+ [ブランチの構成](#configure-branch)
+ [属性の構成](#configure-attributes)
+ [センサーまたはアクチュエータの構成](#configure-sensors-or-acuators)
+ [複雑なデータ型の設定](#configure-complex-data-types)

## ブランチの構成
<a name="configure-branch"></a>

ブランチを構成するには、以下の情報を指定します。
+ `fullyQualifiedName` - ブランチの完全修飾名。ブランチのパスにブランチの名前を続けたものです。子ブランチを参照するには、ドット (.) を使用します。例えば、`Vehicle.Chassis.SteeringWheel` は `SteeringWheel` ブランチの完全修飾名です。`Vehicle.Chassis.` はこのブランチのパスを示します。

  完全修飾名には最大 150 文字を入力できます。有効な文字は、a～z、A～Z、0～9、コロン (:)、アンダースコア (\$1) です。
+ (オプション) `Description` - ブランチの説明。

  説明には最大 2048 文字を入力できます。有効な文字は、a～z、A～Z、0～9、: (コロン)、\$1 (アンダースコア)、- (ハイフン) です。
+ (オプション) `deprecationMessage` - 移動または削除されるノードやブランチに関する非推奨メッセージ。

  deprecationMessage には最大 2048 文字を入力できます。有効な文字は、a～z、A～Z、0～9、: (コロン)、\$1 (アンダースコア)、- (ハイフン) です。
+ (オプション) `comment` - 説明に追加するコメント。コメントは、ブランチに関する追加情報を提供するために使用できます。例えば、ブランチの意図や、関連するブランチへの参照を示すことができます。

  コメントには最大 2048 文字を入力できます。有効な文字は、a～z、A～Z、0～9、: (コロン)、\$1 (アンダースコア)、- (ハイフン) です。

## 属性の構成
<a name="configure-attributes"></a>

属性を構成するには、以下の情報を指定します。
+ `dataType` - 属性のデータ型は、INT8、UINT8、INT16、UINT16、INT32、UINT32、INT64、UINT64、BOOLEAN、FLOAT、DOUBLE、STRING、UNIX\$1TIMESTAMP、INT8\$1ARRAY、UINT8\$1ARRAY、INT16\$1ARRAY、UINT16\$1ARRAY、INT32\$1ARRAY、UINT32\$1ARRAY、INT64\$1ARRAY、UINT64\$1ARRAY、BOOLEAN\$1ARRAY、FLOAT\$1ARRAY、DOUBLE\$1ARRAY、STRING\$1ARRAY、UNIX\$1TIMESTAMP\$1ARRAY、UNKNOWN、fullyQualifiedName、またはデータ型ブランチに定義されているカスタム構造体のいずれかである必要があります。
+ `fullyQualifiedName` - 属性の完全修飾名は、属性のパスに属性名を続けたものです。子シグナルを参照するには、ドット (.) を使用します。例えば、`Vehicle.Chassis.SteeringWheel.Diameter` は `Diameter` 属性の完全修飾名です。`Vehicle.Chassis.SteeringWheel.` はこの属性のパスを示します。

  完全修飾名には最大 150 文字を入力できます。有効な文字は、a～z、A～Z、0～9、: (コロン)、\$1 (アンダースコア) です。
+ (オプション) `Description` - 属性の説明。

  説明には最大 2048 文字を入力できます。有効な文字は、a～z、A～Z、0～9、: (コロン)、\$1 (アンダースコア)、- (ハイフン) です。
+ (オプション) `unit` - 属性の科学単位 (km、摂氏など)。
+ (オプション) `min` - 属性の最小値。
+ (オプション) `max` - 属性の最大値。
+ (オプション) `defaultValue` - 属性のデフォルト値。
+ (オプション) `assignedValue` - 属性に割り当てられた値。
+ (オプション) `allowedValues` - 属性が受け入れる値のリスト。
+ (オプション) `deprecationMessage` - 移動または削除されるノードやブランチに関する非推奨メッセージ。

  deprecationMessage には最大 2048 文字を入力できます。有効な文字は、a～z、A～Z、0～9、: (コロン)、\$1 (アンダースコア)、- (ハイフン) です。
+ (オプション) `comment` - 説明に追加するコメント。コメントは、属性に関する追加情報を提供するために使用できます。例えば、属性の意図や、関連する属性への参照を示すことができます。

  コメントには最大 2048 文字を入力できます。有効な文字は、a～z、A～Z、0～9、: (コロン)、\$1 (アンダースコア)、- (ハイフン) です。

## センサーまたはアクチュエータの構成
<a name="configure-sensors-or-acuators"></a>

センサーまたはアクチュエータを構成するには、以下の情報を指定します。
+ `dataType` - シグナルのデータ型は、INT8、UINT8、INT16、UINT16、INT32、UINT32、INT64、UINT64、BOOLEAN、FLOAT、DOUBLE、STRING、UNIX\$1TIMESTAMP、INT8\$1ARRAY、UINT8\$1ARRAY、INT16\$1ARRAY、UINT16\$1ARRAY、INT32\$1ARRAY、UINT32\$1ARRAY、INT64\$1ARRAY、UINT64\$1ARRAY、BOOLEAN\$1ARRAY、FLOAT\$1ARRAY、DOUBLE\$1ARRAY、STRING\$1ARRAY、UNIX\$1TIMESTAMP\$1ARRAY、UNKNOWN、fullyQualifiedName、またはデータ型ブランチに定義されているカスタム構造体のいずれかである必要があります。
+ `fullyQualifiedName` - シグナルの完全修飾名は、シグナルのパスにシグナルの名前を続けたものです。子シグナルを参照するには、ドット (.) を使用します。例えば、`Vehicle.Chassis.SteeringWheel.HandsOff.HandsOffSteeringState` は `HandsOffSteeringState` アクチュエータの完全修飾名です。`Vehicle.Chassis.SteeringWheel.HandsOff.` はこのアクチュエータのパスを示します。

  完全修飾名には最大 150 文字を入力できます。有効な文字は、a～z、A～Z、0～9、: (コロン)、\$1 (アンダースコア) です。
+ (オプション) `Description` - シグナルの説明。

  説明には最大 2048 文字を入力できます。有効な文字は、a～z、A～Z、0～9、: (コロン)、\$1 (アンダースコア)、- (ハイフン) です。
+ (オプション) `unit` – km や摂氏など、シグナルの科学単位。
+ (オプション) `min` - シグナルの最小値。
+ (オプション) `max` - シグナルの最大値。
+ (オプション) `assignedValue` - シグナルに割り当てられた値。
+ (オプション) `allowedValues` - シグナルが受け入れる値のリスト。
+ (オプション) `deprecationMessage` - 移動または削除されるノードやブランチに関する非推奨メッセージ。

  deprecationMessage には最大 2048 文字を入力できます。有効な文字は、a～z、A～Z、0～9、: (コロン)、\$1 (アンダースコア)、- (ハイフン) です。
+ (オプション) `comment` - 説明に追加するコメント。コメントは、センサーやアクチュエータに関する追加情報を提供するために使用できます。例えば、それらの意図や、関連するセンサーまたはアクチュエータへの参照を示すことができます。

  コメントには最大 2048 文字を入力できます。有効な文字は、a～z、A～Z、0～9、: (コロン)、\$1 (アンダースコア)、- (ハイフン) です。

## 複雑なデータ型の設定
<a name="configure-complex-data-types"></a>

複雑なデータ型は、ビジョンシステムをモデル化するときに使用します。これらのデータ型は、ブランチに加えて、構造 (構造体とも呼ばれる) とプロパティで構成されます。構造体は、画像のように、複数の値で記述されるシグナルです。プロパティは、プリミティブデータ型 (UINT8 など) や別の構造体 (タイムスタンプなど) など、構造体のメンバーを表します。例えば、Vehicle.Cameras.Front はブランチを表し、Vehicle.Cameras.Front.Image は構造体を表し、Vehicle.Cameras.Timestamp はプロパティを表します。

次の複雑なデータ型の例は、シグナルとデータ型を 1 つの .json ファイルにエクスポートする方法を示しています。

**Example 複雑なデータ型**  

```
{
  "Vehicle": {
    "type": "branch"
    // Signal tree
  },
  "ComplexDataTypes": {
    "VehicleDataTypes": {
      // complex data type tree
      "children": {
        "branch": {
          "children": {
            "Struct": {
              "children": {
                "Property": {
                  "type": "property",
                  "datatype": "Data type",
                  "description": "Description",
                  //                  ...
                }
              },
              "description": "Description",
              "type": "struct"
            }
          }
          "description": "Description",
          "type": "branch"
        }
      }
    }
  }
}
```

**注記**  
[デモスクリプト](https://raw.githubusercontent.com/aws/aws-iot-fleetwise-edge/main/tools/cloud/ros2-to-nodes.py)をダウンロードして、ROS 2 メッセージをシグナルカタログと互換性のある VSS .json ファイルに変換できます。詳細については、「[ビジョンシステムデータデベロッパーガイド](https://github.com/aws/aws-iot-fleetwise-edge/blob/main/docs/dev-guide/vision-system-data/vision-system-data-demo.ipynb)」を参照してください。**  
ビジョンシステムデータはプレビューリリースであり、変更される可能性があります。

### 構造体の設定
<a name="configure-custom-structure"></a>

カスタム構造 (または構造体) を設定するには、以下の情報を指定します。
+ `fullyQualifiedName` — カスタム構造の完全修飾名。例えば、カスタム構造の完全修飾名は `ComplexDataTypes.VehicleDataTypes.SVMCamera` です。

  完全修飾名には最大 150 文字を入力できます。有効な文字は、a～z、A～Z、0～9、: (コロン)、\$1 (アンダースコア) です。
+ (オプション) `Description` - シグナルの説明。

  説明には最大 2048 文字を入力できます。有効な文字は、a～z、A～Z、0～9、: (コロン)、\$1 (アンダースコア)、- (ハイフン) です。
+ (オプション) `deprecationMessage` - 移動または削除されるノードやブランチに関する非推奨メッセージ。

  deprecationMessage には最大 2048 文字を入力できます。有効な文字は、a～z、A～Z、0～9、: (コロン)、\$1 (アンダースコア)、- (ハイフン) です。
+ (オプション) `comment` - 説明に追加するコメント。コメントは、センサーやアクチュエータに関する追加情報を提供するために使用できます。例えば、それらの意図や、関連するセンサーまたはアクチュエータへの参照を示すことができます。

  コメントには最大 2048 文字を入力できます。有効な文字は、a～z、A～Z、0～9、: (コロン)、\$1 (アンダースコア)、- (ハイフン) です。

### プロパティの設定
<a name="configure-custom-property"></a>

カスタムプロパティを設定するには、以下の情報を指定します。
+ `dataType` - シグナルのデータ型は、INT8、UINT8、INT16、UINT16、INT32、UINT32、INT64、UINT64、BOOLEAN、FLOAT、DOUBLE、STRING、UNIX\$1TIMESTAMP、INT8\$1ARRAY、UINT8\$1ARRAY、INT16\$1ARRAY、UINT16\$1ARRAY、INT32\$1ARRAY、UINT32\$1ARRAY、INT64\$1ARRAY、UINT64\$1ARRAY、BOOLEAN\$1ARRAY、FLOAT\$1ARRAY、DOUBLE\$1ARRAY、STRING\$1ARRAY、UNIX\$1TIMESTAMP\$1ARRAY、STRUCT、STRUCT\$1ARRAY、UNKNOWN のいずれかである必要があります。
+ `fullyQualifiedName` — カスタムプロパティの完全修飾名。例えば、カスタムプロパティの完全修飾名は `ComplexDataTypes.VehicleDataTypes.SVMCamera.FPS` です。

  完全修飾名には最大 150 文字を入力できます。有効な文字は、a～z、A～Z、0～9、: (コロン)、\$1 (アンダースコア) です。
+ (オプション) `Description` - シグナルの説明。

  説明には最大 2048 文字を入力できます。有効な文字は、a～z、A～Z、0～9、: (コロン)、\$1 (アンダースコア)、- (ハイフン) です。
+ (オプション) `deprecationMessage` - 移動または削除されるノードやブランチに関する非推奨メッセージ。

  deprecationMessage には最大 2048 文字を入力できます。有効な文字は、a～z、A～Z、0～9、: (コロン)、\$1 (アンダースコア)、- (ハイフン) です。
+ (オプション) `comment` - 説明に追加するコメント。コメントは、センサーやアクチュエータに関する追加情報を提供するために使用できます。例えば、それらの意図や、関連するセンサーまたはアクチュエータへの参照を示すことができます。

  コメントには最大 2048 文字を入力できます。有効な文字は、a～z、A～Z、0～9、: (コロン)、\$1 (アンダースコア)、- (ハイフン) です。
+ (オプション) `dataEncoding` — プロパティがバイナリデータかどうかを示します。カスタムプロパティのデータエンコーディングは、BINARY または TYPED のいずれかである必要があります。
+ (オプション) `structFullyQualifiedName ` — カスタムプロパティのデータ型が Struct または StructArray の場合、カスタムプロパティの構造 (構造体) ノードの完全修飾名。

  完全修飾名には最大 150 文字を入力できます。有効な文字は、a～z、A～Z、0～9、: (コロン)、\$1 (アンダースコア) です。