# AWS IoT Core for LoRaWAN에 무선 디바이스 추가
<a name="lorawan-end-devices-add"></a>

무선 디바이스를 처음으로 추가하는 경우 콘솔을 사용하는 것이 좋습니다. AWS IoT 콘솔의 [AWS IoT Core for LoRaWAN](https://console.aws.amazon.com/iot/home#/wireless/landing) **소개(Intro)** 페이지로 이동하여 **시작하기(Get started)**를 선택한 다음 **디바이스 추가(Add device)**를 선택합니다. 디바이스를 이미 추가한 경우 **디바이스 보기**를 선택하여 추가한 게이트웨이를 봅니다. 디바이스를 더 추가하려면 **디바이스 추가**를 선택합니다.

또는 AWS IoT 콘솔의 [디바이스](https://console.aws.amazon.com/iot/home#/wireless/devices) 페이지에서 무선 디바이스를 추가할 수도 있습니다.

## 콘솔을 사용하여 AWS IoT Core for LoRaWAN에 무선 디바이스 사양 추가
<a name="lorawan-end-device-spec-console"></a>

활성화 방법과 LoRaWAN 버전을 기반으로 **무선 디바이스 사양**을 선택합니다. 선택한 데이터는 사용자를 위해 AWS가 소유하고 관리하는 키로 암호화됩니다.

**OTAA 및 ABP 활성화 모드**  
LoRaWAN 디바이스에서 업링크 데이터를 전송하기 전에 *활성화* 또는 *조인 프로시저*라는 프로세스를 완료해야 합니다. 디바이스를 활성화하려면 OTAA(무선 업데이트 활성화) 또는 ABP(개인 설정으로 활성화)를 사용할 수 있습니다.

ABP는 조인 프로시저를 필요로하지 않으며 정적 키를 사용합니다. OTAA를 사용하면 LoRaWAN 디바이스가 조인 요청을 전송하고 네트워크 서버에서 요청을 허용할 수 있습니다. 각 활성화에 대해 새 세션 키가 생성되므로 OTAA를 사용하여 디바이스를 활성화하는 것이 좋습니다.

**LoRaWAN 버전**  
OTAA를 사용하면 LoRaWAN 디바이스와 클라우드 호스팅 애플리케이션이 루트 키를 공유합니다. 이러한 루트 키는 버전 v1.0.x 또는 v1.1을 사용하는지 여부에 따라 다릅니다. v1.0.x에는 루트 키(**AppKey**(애플리케이션 키)가 하나만 있는 반면 v1.1에는 두 개의 루트 키(**AppKey**(애플리케이션 키) 및**NwkKey**(네트워크 키))가 있습니다. 세션 키는 각 활성화에 대한 루트 키를 기반으로 파생됩니다. **NwkKey** 및 **AppKey**는 모두 무선 공급 업체에서 제공한 32자리 16진수 값입니다.

**무선 디바이스 EUI**  
**무선 디바이스 사양**을 선택하면 콘솔에 표시되는 무선 디바이스의 EUI(확장 고유 식별자) 파라미터가 표시됩니다. 이 정보는 디바이스 또는 무선 공급 업체에 대한 설명서에서 찾을 수 있습니다.
+ **DevEUI**: 디바이스에 고유하며 디바이스 레이블 또는 해당 설명서에 있는 16자리 16진수 값입니다.
+ **AppEui**: 조인 서버에 고유하며 디바이스 설명서에서 찾을 수 있는 16자리 16진수 값입니다. LoRaWAN v1.1 버전에서 **AppEui**가 **JoinEui**로 호출됩니다.

고유 식별자, 세션 키 및 루트 키에 대한 자세한 내용은[ LoRa Alliance](https://lora-alliance.org/about-lorawan) 설명서를 참조하세요.

## API를 사용하여 AWS IoT Core for LoRaWAN에 무선 디바이스 사양 추가
<a name="lorawan-end-device-spec-api"></a>

API를 사용하여 무선 디바이스를 추가하는 경우 무선 디바이스를 만들기 전에 먼저 디바이스 프로파일과 서비스 프로파일을 만들어야 합니다. 무선 디바이스를 만들 때 디바이스 프로파일과 서비스 프로파일 ID를 사용합니다. API를 사용해 프로파일을 생성하는 방법에 대한 자세한 내용은 [API를 사용하여 디바이스 프로파일 추가](lorawan-define-profiles.md#lorawan-device-profile-api) 단원을 참조하세요.

다음 목록에서는 서비스 프로파일 추가, 업데이트 또는 삭제와 관련된 작업을 수행하는 API 작업에 대해 설명합니다.

**서비스 프로파일에 대한 AWS IoT 무선 API 작업**
+ [CreateWirelessDevice](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_CreateWirelessDevice.html)
+ [GetWirelessDevice](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetWirelessDevice.html)
+ [ListWirelessDevices](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_ListWirelessDevices.html)
+ [ UpdateWirelessDevice](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_UpdateWirelessDevice.html)
+ [DeleteWirelessDevice](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_DeleteWirelessDevice.html)

AWS IoT Core for LoRaWAN 리소스 생성 및 관리에 사용할 수 있는 작업 및 데이터 유형의 전체 목록은 [AWS IoT 무선 API 참조](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/welcome.html)를 참조하세요.

**AWS CLI를 사용하여 무선 디바이스를 생성하는 방법**  
AWS CLI를 사용하여 [create-wireless-device](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/create-device-profile.html) 명령으로 무선 디바이스를 만들 수 있습니다. 다음 예제에서는 input.json 파일을 사용하여 파라미터를 입력하여 무선 디바이스를 만듭니다.

**참고**  
여기에 표시된 CLI 명령에 해당하는 AWS API의 메서드를 사용하여 API로 이 절차를 수행할 수도 있습니다.

**input.json 내용**

```
{
    "Description": "My LoRaWAN wireless device"
    "DestinationName": "IoTWirelessDestination"
    "LoRaWAN": {
        "DeviceProfileId": "ab0c23d3-b001-45ef-6a01-2bc3de4f5333",
        "ServiceProfileId": "fe98dc76-cd12-001e-2d34-5550432da100",
        "OtaaV1_1": {
            "AppKey": "3f4ca100e2fc675ea123f4eb12c4a012",
            "JoinEui": "b4c231a359bc2e3d",
            "NwkKey": "01c3f004a2d6efffe32c4eda14bcd2b4"
        },
        "DevEui": "ac12efc654d23fc2"
    },
    "Name": "SampleIoTWirelessThing"
    "Type": LoRaWAN
}
```

이 파일을 `create-wireless-device` 명령에 대한 입력으로 제공할 수 있습니다.

```
aws iotwireless create-wireless-device \
    --cli-input-json file://input.json
```

사용할 수 있는 CLI에 대한 자세한 내용은 [AWS CLI 참조](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/index.html)를 참조하세요.