# 將您的無線裝置新增至 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** (新增裝置)。如果已新增裝置，請選擇 **View device** (檢視裝置)，以檢視您已新增的閘道。如果您想要新增更多裝置，請選擇 **Add device** (新增裝置)。

或者，您也可以從 AWS IoT 主控台的 [Devices](https://console.aws.amazon.com/iot/home#/wireless/devices) (裝置)頁面新增無線裝置。

## 使用主控台將您的無線裝置規格新增至 AWS IoT Core for LoRaWAN
<a name="lorawan-end-device-spec-console"></a>

根據您的啟用方法和 LoRaWAN 版本，選擇 **Wireless device specification** (無線裝置規格)。一旦選取，就會使用 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 位數)。

**無線裝置 EUI**  
在您選取 **Wireless device specification** (無線裝置規格) 之後，您會看到主機上顯示無線裝置的 EUI (延伸唯一識別碼) 參數。您可以從裝置或無線廠商的文件中找到此資訊。
+ **DevEUI**：16 位數的十六進位值，這是您裝置獨有的，可在裝置標籤或其文件上找到。
+ **AppEUI**：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 Wireless 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 Wireless 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 檔案來輸入參數。

**注意**  
您也可以使用 API 中對應於此處顯示的 CLI 命令的方法，在 AWS 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)