디바이스 프로필 및 Sidewalk 엔드 디바이스 추가 - AWS IoT Wireless
Sidewalk 디바이스 추가 (콘솔)Sidewalk 디바이스 추가 (CLI)

디바이스 프로필 및 Sidewalk 엔드 디바이스 추가

이 섹션에서는 디바이스 프로필을 생성하는 방법을 소개합니다. 또한 AWS IoT 콘솔 및 AWS CLI를 사용하여 Sidewalk 엔드 디바이스를 Amazon Sidewalk용 AWS IoT Core에 추가하는 방법도 보여 줍니다.

Sidewalk 디바이스 추가 (콘솔)

AWS IoT 콘솔을 사용하여 Sidewalk 디바이스를 추가하려면 디바이스 허브의 Sidewalk 탭으로 이동하여 디바이스 프로비저닝을 선택한 후 다음 단계를 수행하세요.

  1. 디바이스 세부 정보 지정

    Sidewalk 디바이스의 구성 정보를 지정합니다. 새 디바이스 프로필을 만들거나 Sidewalk 디바이스의 기존 프로필을 선택할 수도 있습니다.

    1. 디바이스 이름 및 선택적 설명을 지정합니다. 설명은 최대 2,048자입니다. 이러한 필드는 디바이스를 만든 후에 편집할 수 있습니다.

    2. Sidewalk 디바이스와 연결할 디바이스 프로필을 선택합니다. 기존 디바이스 프로필이 있는 경우 프로필을 선택할 수 있습니다. 새 프로젝트를 생성하려면 새 프로필 생성을 선택하고 프로필의 이름을 입력합니다.

      참고

      디바이스 프로필에 태그를 부착하려면 프로필을 만든 후 프로필 허브로 이동한 다음 프로필을 편집하여 이 정보를 추가합니다.

    3. 디바이스의 메시지를 다른 AWS 서비스로 라우팅할 대상 이름을 지정합니다. 아직 대상을 만들지 않았다면 대상 허브로 이동하여 대상을 만듭니다. 그런 다음 Sidewalk 디바이스의 대상을 선택할 수 있습니다. 자세한 내용은 Sidewalk 엔드 디바이스의 대상 추가 단원을 참조하십시오.

    4. Sidewalk 디바이스를 계속 추가하려면 다음을 선택합니다.

  2. Sidewalk 디바이스를 AWS IoT 사물과 연결 (선택 사항)

    원하는 경우 Sidewalk 디바이스를 AWS IoT 사물에 연결할 수도 있습니다. IoT는 AWS IoT 디바이스 레지스트리의 항목입니다. 사물을 사용하면 디바이스를 더 쉽게 검색하고 관리할 수 있습니다. 사물을 디바이스에 연결하면 디바이스에서 다른 AWS IoT Core 기능에 액세스할 수 있습니다.

    디바이스를 사물과 연결하려면 자동 사물 등록을 선택합니다.

    1. Sidewalk 디바이스를 연결하려는 IoT 사물의 고유한 이름을 입력합니다. 사물 이름은 대소문자를 구분하며 AWS 계정 및 AWS 리전에서 고유해야 합니다.

    2. 사물 유형이나 사물 목록에서 필터링하는 데 사용할 수 있는 검색 가능한 속성을 사용하는 등 IoT 사물에 대한 추가 구성을 제공합니다.

    3. 다음을 선택하고 Sidewalk 디바이스에 대한 정보를 확인한 다음 생성을 선택합니다.

Sidewalk 디바이스 추가 (CLI)

Sidewalk 디바이스를 추가하고 Sidewalk 디바이스를 프로비저닝하는 데 사용할 JSON 파일을 다운로드하려면 다음 API 작업을 수행하세요.

1단계: 디바이스 프로필 생성

AWS 계정에서 디바이스 프로필을 생성하려면 CreateDeviceProfile API 작업 또는 create-device-profile 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 디바이스를 추가하려면 CreateWirelessDevice API 작업 또는 create-wireless-device CLI 명령을 사용합니다. 디바이스를 생성할 때 다음 파라미터와 함께 선택적으로 Sidewalk 디바이스의 이름과 설명을 지정하세요.

참고

Sidewalk 디바이스를 AWS IoT 사물과 연결하려면 AssociateWirelessDeviceWithThing API 작업 또는 associate-wireless-device-with-thing 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"
}