

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 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는 속성을 나타냅니다.

다음 복잡한 데이터 형식 예제는 신호와 데이터 형식을 단일 .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](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 또는 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 (밑줄).