기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# AWS IoT FleetWise 신호 카탈로그 가져오기
AWS IoT FleetWise 콘솔 또는 API를 사용하여 신호 카탈로그를 가져올 수 있습니다.
**Topics**
+ [신호 카탈로그 가져오기(콘솔)](#import-signal-catalog-console)
+ [신호 카탈로그 가져오기(AWS CLI)](#import-signal-catalog)
## 신호 카탈로그 가져오기(콘솔)
AWS IoT FleetWise 콘솔을 사용하여 신호 카탈로그를 가져올 수 있습니다.
**중요**
최대 1개의 신호 카탈로그를 가질 수 있습니다. 신호 카탈로그가 이미 있는 경우 콘솔에 신호 카탈로그를 가져오는 옵션이 표시되지 않습니다.
**신호 카탈로그를 가져오려는 경우**
1. [AWS IoT FleetWise](https://console.aws.amazon.com/iotfleetwise/) 콘솔을 엽니다.
1. 탐색 창에서 **신호 카탈로그(Signal catalog)**를 선택합니다.
1. 신호 카탈로그 요약 페이지에서 **신호 카탈로그 가져오기**를 선택합니다.
1. 신호가 포함된 파일을 가져옵니다.
+ S3 버킷으로부터 파일을 업로드하려면
1. **S3에서 가져오기(Import from S3)**를 선택합니다.
1. **S3 찾아보기(Browse S3)**를 선택합니다.
1. **버킷**의 경우 버킷 이름 또는 객체를 입력하고 목록에서 선택한 다음 목록에서 파일을 선택합니다. **파일 선택** 버튼을 선택합니다.
또는 **S3 URI**의 경우 Amazon Simple Storage Service URI를 입력합니다. 자세한 내용은 *Amazon S3 사용 설명서*의 [버킷에 액세스하는 방법](https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-bucket-intro.html)을 참조하세요.
+ 컴퓨터에서 파일을 업로드하려는 경우
1. **Import file(파일 가져오기)**을 선택합니다.
1. .json 파일을 [차량 신호 사양(VSS)](https://www.w3.org/auto/wg/wiki/Vehicle_Signal_Specification_(VSS)/Vehicle_Data_Spec)형식으로.json 파일을 업로드합니다.
1. 신호 카탈로그를 확인한 다음 **파일 가져오기**를 선택합니다.
## 신호 카탈로그 가져오기(AWS CLI)
[ImportSignalCatalog](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_ImportSignalCatalog.html) API 작업을 사용하여 신호 카탈로그 생성에 도움이 되는 JSON 파일을 업로드할 수 있습니다. 신호를 JSON 파일에 저장하려면 [차량 신호 사양(VSS)](https://www.w3.org/auto/wg/wiki/Vehicle_Signal_Specification_(VSS)/Vehicle_Data_Spec)을 따라야 합니다. 다음 예제에서는를 사용합니다 AWS CLI.
신호 카탈로그를 가져오려면 다음 명령을 실행합니다.
+ *signal-catalog-name*을 생성 중인 신호 카탈로그의 이름으로 바꾸세요.
+ (선택 사항) 설명을 신호 카탈로그를 식별하는 데 도움이 되는 *설명*으로 바꾸세요.
+ *signal-catalog-configation-vss*를 VSS에 정의된 신호가 포함된 JSON 문자열 파일의 이름으로 바꾸세요.
분기, 속성, 센서 및 액추에이터를 구성하는 방법에 대한 자세한 내용은 [AWS IoT FleetWise 신호 구성](define-signal.md) 섹션을 참조하세요.
```
aws iotfleetwise import-signal-catalog \
--name signal-catalog-name \
--description description \
--vss file://signal-catalog-configuration-vss.json
```
### 신호 카탈로그 구성(VSS)
JSON을 문자열화하여 `vssJson` 필드에 전달해야 합니다. 다음은 VSS에 정의된 신호의 예제입니다.
```
{
"Vehicle": {
"type": "branch",
"children": {
"Chassis": {
"type": "branch",
"description": "All data concerning steering, suspension, wheels, and brakes.",
"children": {
"SteeringWheel": {
"type": "branch",
"description": "Steering wheel signals",
"children": {
"Diameter": {
"type": "attribute",
"description": "The diameter of the steering wheel",
"datatype": "float",
"unit": "cm",
"min": 1,
"max": 50
},
"HandsOff": {
"type": "branch",
"children": {
"HandsOffSteeringState": {
"type": "actuator",
"description": "HndsOffStrWhlDtSt. Hands Off Steering State",
"datatype": "boolean"
},
"HandsOffSteeringMode": {
"type": "actuator",
"description": "HndsOffStrWhlDtMd. Hands Off Steering Mode",
"datatype": "int8",
"min": 0,
"max": 2
}
}
}
}
},
"Accelerator": {
"type": "branch",
"description": "",
"children": {
"AcceleratorPedalPosition": {
"type": "sensor",
"description": "Throttle__Position. Accelerator pedal position as percent. 0 = Not depressed. 100 = Fully depressed.",
"datatype": "uint8",
"unit": "%",
"min": 0,
"max": 100.000035
}
}
}
}
},
"Powertrain": {
"type": "branch",
"description": "Powertrain data for battery management, etc.",
"children": {
"Transmission": {
"type": "branch",
"description": "Transmission-specific data, stopping at the drive shafts.",
"children": {
"VehicleOdometer": {
"type": "sensor",
"description": "Vehicle_Odometer",
"datatype": "float",
"unit": "km",
"min": 0,
"max": 67108863.984375
}
}
},
"CombustionEngine": {
"type": "branch",
"description": "Engine-specific data, stopping at the bell housing.",
"children": {
"Engine": {
"type": "branch",
"description": "Engine description",
"children": {
"timing": {
"type": "branch",
"description": "timing description",
"children": {
"run_time": {
"type": "sensor",
"description": "Engine run time",
"datatype": "int16",
"unit": "ms",
"min": 0,
"max": 10000
},
"idle_time": {
"type": "sensor",
"description": "Engine idle time",
"datatype": "int16",
"min": 0,
"unit": "ms",
"max": 10000
}
}
}
}
}
}
}
}
},
"Axle": {
"type": "branch",
"description": "Axle signals",
"children": {
"TireRRPrs": {
"type": "sensor",
"description": "TireRRPrs. Right rear Tire pressure in kilo-Pascal",
"datatype": "float",
"unit": "kPaG",
"min": 0,
"max": 1020
}
}
}
}
},
"Cameras": {
"type": "branch",
"description": "Branch to aggregate all cameras in the vehicle",
"children": {
"FrontViewCamera": {
"type": "sensor",
"datatype": "VehicleDataTypes.SVMCamera",
"description": "Front view camera"
},
"RearViewCamera": {
"type": "sensor",
"datatype": "VehicleDataTypes.SVMCamera",
"description": "Rear view camera"
},
"LeftSideViewCamera": {
"type": "sensor",
"datatype": "VehicleDataTypes.SVMCamera",
"description": "Left side view camera"
},
"RightSideViewCamera": {
"type": "sensor",
"datatype": "VehicleDataTypes.SVMCamera",
"description": "Right side view camera"
}
}
},
"ComplexDataTypes": {
"VehicleDataTypes": {
"type": "branch",
"description": "Branch to aggregate all camera related higher order data types",
"children": {
"SVMCamera": {
"type": "struct",
"description": "This data type represents Surround View Monitor (SVM) camera system in a vehicle",
"comment": "Test comment",
"deprecation": "Test deprecation message",
"children": {
"Make": {
"type": "property",
"description": "Make of the SVM camera",
"datatype": "string",
"comment": "Test comment",
"deprecation": "Test deprecation message"
},
"Description": {
"type": "property",
"description": "Description of the SVM camera",
"datatype": "string",
"comment": "Test comment",
"deprecation": "Test deprecation message"
},
"FPS": {
"type": "property",
"description": "FPS of the SVM camera",
"datatype": "double",
"comment": "Test comment",
"deprecation": "Test deprecation message"
},
"Orientation": {
"type": "property",
"description": "Orientation of the SVM camera",
"datatype": "VehicleDataTypes.Orientation",
"comment": "Test comment",
"deprecation": "Test deprecation message"
},
"Range": {
"type": "property",
"description": "Range of the SVM camera",
"datatype": "VehicleDataTypes.Range",
"comment": "Test comment",
"deprecation": "Test deprecation message"
},
"RawData": {
"type": "property",
"description": "Represents binary data of the SVM camera",
"datatype": "uint8[]",
"dataencoding": "binary",
"comment": "Test comment",
"deprecation": "Test deprecation message"
},
"CapturedFrames": {
"type": "property",
"description": "Represents selected frames captured by the SVM camera",
"datatype": "VehicleDataTypes.Frame[]",
"dataencoding": "typed",
"comment": "Test comment",
"deprecation": "Test deprecation message"
}
}
},
"Range": {
"type": "struct",
"description": "Range of a camera in centimeters",
"comment": "Test comment",
"deprecation": "Test deprecation message",
"children": {
"Min": {
"type": "property",
"description": "Minimum range of a camera in centimeters",
"datatype": "uint32",
"comment": "Test comment",
"deprecation": "Test deprecation message"
},
"Max": {
"type": "property",
"description": "Maximum range of a camera in centimeters",
"datatype": "uint32",
"comment": "Test comment",
"deprecation": "Test deprecation message"
}
}
},
"Orientation": {
"type": "struct",
"description": "Orientation of a camera",
"comment": "Test comment",
"deprecation": "Test deprecation message",
"children": {
"Front": {
"type": "property",
"description": "Indicates whether the camera is oriented to the front of the vehicle",
"datatype": "boolean",
"comment": "Test comment",
"deprecation": "Test deprecation message"
},
"Rear": {
"type": "property",
"description": "Indicates whether the camera is oriented to the rear of the vehicle",
"datatype": "boolean",
"comment": "Test comment",
"deprecation": "Test deprecation message"
},
"Side": {
"type": "property",
"description": "Indicates whether the camera is oriented to the side of the vehicle",
"datatype": "boolean",
"comment": "Test comment",
"deprecation": "Test deprecation message"
}
}
},
"Frame": {
"type": "struct",
"description": "Represents a camera frame",
"comment": "Test comment",
"deprecation": "Test deprecation message",
"children": {
"Data": {
"type": "property",
"datatype": "string",
"dataencoding": "binary",
"comment": "Test comment",
"deprecation": "Test deprecation message"
}
}
}
}
}
}
}
```
아래 예제에서는 VSS에 정의된 것과 동일한 신호를 JSON 문자열로 보여줍니다.
```
{
"vssJson": "{\"Vehicle\":{\"type\":\"branch\",\"children\":{\"Chassis\":{\"type\":\"branch\",\"description\":\"All data concerning steering, suspension, wheels, and brakes.\",\"children\":{\"SteeringWheel\":{\"type\":\"branch\",\"description\":\"Steering wheel signals\",\"children\":{\"Diameter\":{\"type\":\"attribute\",\"description\":\"The diameter of the steering wheel\",\"datatype\":\"float\",\"unit\":\"cm\",\"min\":1,\"max\":50},\"HandsOff\":{\"type\":\"branch\",\"children\":{\"HandsOffSteeringState\":{\"type\":\"actuator\",\"description\":\"HndsOffStrWhlDtSt. Hands Off Steering State\",\"datatype\":\"boolean\"},\"HandsOffSteeringMode\":{\"type\":\"actuator\",\"description\":\"HndsOffStrWhlDtMd. Hands Off Steering Mode\",\"datatype\":\"int8\",\"min\":0,\"max\":2}}}}},\"Accelerator\":{\"type\":\"branch\",\"description\":\"\",\"children\":{\"AcceleratorPedalPosition\":{\"type\":\"sensor\",\"description\":\"Throttle__Position. Accelerator pedal position as percent. 0 = Not depressed. 100 = Fully depressed.\",\"datatype\":\"uint8\",\"unit\":\"%\",\"min\":0,\"max\":100.000035}}}}},\"Powertrain\":{\"type\":\"branch\",\"description\":\"Powertrain data for battery management, etc.\",\"children\":{\"Transmission\":{\"type\":\"branch\",\"description\":\"Transmission-specific data, stopping at the drive shafts.\",\"children\":{\"VehicleOdometer\":{\"type\":\"sensor\",\"description\":\"Vehicle_Odometer\",\"datatype\":\"float\",\"unit\":\"km\",\"min\":0,\"max\":67108863.984375}}},\"CombustionEngine\":{\"type\":\"branch\",\"description\":\"Engine-specific data, stopping at the bell housing.\",\"children\":{\"Engine\":{\"type\":\"branch\",\"description\":\"Engine description\",\"children\":{\"timing\":{\"type\":\"branch\",\"description\":\"timing description\",\"children\":{\"run_time\":{\"type\":\"sensor\",\"description\":\"Engine run time\",\"datatype\":\"int16\",\"unit\":\"ms\",\"min\":0,\"max\":10000},\"idle_time\":{\"type\":\"sensor\",\"description\":\"Engine idle time\",\"datatype\":\"int16\",\"min\":0,\"unit\":\"ms\",\"max\":10000}}}}}}}}},\"Axle\":{\"type\":\"branch\",\"description\":\"Axle signals\",\"children\":{\"TireRRPrs\":{\"type\":\"sensor\",\"description\":\"TireRRPrs. Right rear Tire pressure in kilo-Pascal\",\"datatype\":\"float\",\"unit\":\"kPaG\",\"min\":0,\"max\":1020}}}}}}"
}
```
**참고**
[데모 스크립트](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)를 참조하세요.
비전 시스템 데이터는 평가판 릴리스이며 변경될 수 있습니다.
고객 관리형 AWS KMS 키를 사용하여 [암호화를 활성화](key-management.md)한 경우 역할이 `ImportSignalCatalog` API 작업을 호출할 수 있도록 다음 정책 설명을 포함합니다.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"kms:GenerateDataKey*",
"kms:Decrypt"
],
"Resource": [
"arn:aws:kms:us-east-1:111122223333:key/KMS_KEY_ID"
]
}
]
}
```
------