# 디바이스 프로필 및 Sidewalk 엔드 디바이스 추가
이 섹션에서는 디바이스 프로필을 생성하는 방법을 소개합니다. 또한 AWS IoT 콘솔 및 AWS CLI를 사용하여 Sidewalk 엔드 디바이스를 Amazon Sidewalk용 AWS IoT Core에 추가하는 방법도 보여 줍니다.
## Sidewalk 디바이스 추가 (콘솔)
AWS IoT 콘솔을 사용하여 Sidewalk 디바이스를 추가하려면 [디바이스 허브의 Sidewalk 탭](https://console.aws.amazon.com/iot/home#/wireless/devices?tab=sidewalk)으로 이동하여 **디바이스 프로비저닝**을 선택한 후 다음 단계를 수행하세요.
1.
**디바이스 세부 정보 지정**
Sidewalk 디바이스의 구성 정보를 지정합니다. 새 디바이스 프로필을 만들거나 Sidewalk 디바이스의 기존 프로필을 선택할 수도 있습니다.
1. 디바이스 이름 및 선택적 설명을 지정합니다. 설명은 최대 2,048자입니다. 이러한 필드는 디바이스를 만든 후에 편집할 수 있습니다.
1. Sidewalk 디바이스와 연결할 디바이스 프로필을 선택합니다. 기존 디바이스 프로필이 있는 경우 프로필을 선택할 수 있습니다. 새 프로젝트를 생성하려면 **새 프로필 생성**을 선택하고 프로필의 이름을 입력합니다.
**참고**
디바이스 프로필에 태그를 부착하려면 프로필을 만든 후 [프로필 허브](https://console.aws.amazon.com/iot/home#/wireless/profiles)로 이동한 다음 프로필을 편집하여 이 정보를 추가합니다.
1. 디바이스의 메시지를 다른 AWS 서비스로 라우팅할 대상 이름을 지정합니다. 아직 대상을 만들지 않았다면 [대상 허브](https://console.aws.amazon.com/iot/home#/wireless/destinations)로 이동하여 대상을 만듭니다. 그런 다음 Sidewalk 디바이스의 대상을 선택할 수 있습니다. 자세한 내용은 [Sidewalk 엔드 디바이스의 대상 추가](iot-sidewalk-qsg-destination.md) 단원을 참조하십시오.
1. Sidewalk 디바이스를 계속 추가하려면 **다음**을 선택합니다.
1.
**Sidewalk 디바이스를 AWS IoT 사물과 연결 (선택 사항)**
원하는 경우 Sidewalk 디바이스를 AWS IoT 사물에 연결할 수도 있습니다. IoT는 AWS IoT 디바이스 레지스트리의 항목입니다. 사물을 사용하면 디바이스를 더 쉽게 검색하고 관리할 수 있습니다. 사물을 디바이스에 연결하면 디바이스에서 다른 AWS IoT Core 기능에 액세스할 수 있습니다.
디바이스를 사물과 연결하려면 **자동 사물 등록**을 선택합니다.
1. Sidewalk 디바이스를 연결하려는 IoT 사물의 고유한 이름을 입력합니다. 사물 이름은 대소문자를 구분하며 AWS 계정 및 AWS 리전에서 고유해야 합니다.
1. 사물 유형이나 사물 목록에서 필터링하는 데 사용할 수 있는 검색 가능한 속성을 사용하는 등 IoT 사물에 대한 추가 구성을 제공합니다.
1. **다음**을 선택하고 Sidewalk 디바이스에 대한 정보를 확인한 다음 **생성**을 선택합니다.
## Sidewalk 디바이스 추가 (CLI)
Sidewalk 디바이스를 추가하고 Sidewalk 디바이스를 프로비저닝하는 데 사용할 JSON 파일을 다운로드하려면 다음 API 작업을 수행하세요.
**Topics**
+ [1단계: 디바이스 프로필 생성](#iot-sidewalk-profile-create)
+ [2단계: Sidewalk 디바이스 추가](#iot-sidewalk-device-create)
### 1단계: 디바이스 프로필 생성
AWS 계정에서 디바이스 프로필을 생성하려면 [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_CreateDeviceProfile.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_CreateDeviceProfile.html) API 작업 또는 [https://docs.aws.amazon.com/cli/latest/reference/create-device-profile.html](https://docs.aws.amazon.com/cli/latest/reference/create-device-profile.html) CLI 명령을 사용합니다. 디바이스 프로필을 생성할 때 이름을 지정하고 선택적으로 태그를 이름-값 페어로 제공하세요.
예를 들어 다음 명령을 실행하면 Sidewalk 디바이스의 디바이스 프로필이 생성됩니다.
```
aws iotwireless create-device-profile \
--name {{sidewalk_profile}} --sidewalk {}
```
이 명령을 실행하면 디바이스 프로필의 Amazon 리소스 이름(ARN)과 ID가 출력으로 반환됩니다.
```
{
"DeviceProfileArn": "arn:aws:iotwireless:{{us-east-1}}:{{123456789012}}:DeviceProfile/{{12345678-a1b2-3c45-67d8-e90fa1b2c34d}}",
"DeviceProfileId": "{{12345678-a1b2-3c45-67d8-e90fa1b2c34d}}"
}
```
### 2단계: Sidewalk 디바이스 추가
Amazon Sidewalk용 AWS IoT Core 계정에 Sidewalk 디바이스를 추가하려면 [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_CreateWirelessDevice.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_CreateWirelessDevice.html) API 작업 또는 [https://docs.aws.amazon.com/cli/latest/reference/create-wireless-device.html](https://docs.aws.amazon.com/cli/latest/reference/create-wireless-device.html) CLI 명령을 사용합니다. 디바이스를 생성할 때 다음 파라미터와 함께 선택적으로 Sidewalk 디바이스의 이름과 설명을 지정하세요.
**참고**
Sidewalk 디바이스를 AWS IoT 사물과 연결하려면 [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_AssociateWirelessDeviceWithThing.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_AssociateWirelessDeviceWithThing.html) API 작업 또는 [https://docs.aws.amazon.com/cli/latest/reference/associate-wireless-device-with-thing.html](https://docs.aws.amazon.com/cli/latest/reference/associate-wireless-device-with-thing.html) CLI 명령을 사용합니다.
다음 명령은 Sidewalk 디바이스 생성의 예시를 보여줍니다.
```
aws iotwireless create-wireless-device \
--cli-input-json "{{file://device.json}}"
```
다음은 `device.json` 파일의 콘텐츠를 보여줍니다.
**device.json의 내용**
```
{
"Type": "Sidewalk",
"Name": "{{SidewalkDevice}}",
"DestinationName": "{{SidewalkDestination}}",
"Sidewalk": {
"DeviceProfileId": "{{12345678-a1b2-3c45-67d8-e90fa1b2c34d}}"
}
}
```
이 명령을 실행하면 디바이스 ID와 Amazon 리소스 이름(ARN)이 출력으로 반환됩니다.
```
{
"Arn": "arn:aws:iotwireless:{{us-east-1}}:{{123456789012}}:WirelessDevice/{{23456789-abcd-0123-bcde-fabc012345678}}",
"Id": {{"23456789-abcd-0123-bcde-fabc012345678"}}
}
```