# 将您的无线设备添加到 适用于 LoRaWAN 的 AWS IoT Core
<a name="lorawan-end-devices-add"></a>

如果您是首次添加无线设备，我们建议您使用控制台。在 AWS IoT 控制台中导航到 [适用于 LoRaWAN 的 AWS IoT Core](https://console.aws.amazon.com/iot/home#/wireless/landing) ** 简介**页面，选择 **Get started**（开始使用），然后选择 **Add device**（添加设备）。如果您已添加设备，请选择 **View device**（查看设备）以查看您添加的网关。如果要添加更多设备，请选择 **Add device**（添加设备）。

此外，您还可以从 AWS IoT 控制台的 [Devices](https://console.aws.amazon.com/iot/home#/wireless/devices)（设备）页面添加无线设备。

## 使用控制台将您的无线设备规范添加到 适用于 LoRaWAN 的 AWS IoT Core
<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**  
在您选择**无线设备规范**时，您会看到控制台上显示无线设备的 EUI（扩展唯一标识符）参数。您可以从设备或无线供应商的文档中找到此信息。
+ **DevEUI**：设备标签或文档中找到的 16 位六进制值，为您的设备所专有。
+ **AppEUI**：在设备文档中找到的联接服务器的 16 位六进制值，为此服务器所专有。在 LoRaWAN v1.1 版本中，**AppEUI** 被称为 **JoinEUI**。

有关唯一标识符、会话密钥和根密钥的详细信息，请参阅 [LoRa Alliance](https://lora-alliance.org/about-lorawan) 文档。

## 使用 API 将您的无线设备规范添加到 适用于 LoRaWAN 的 AWS IoT Core
<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)

有关可用于创建和管理 适用于 LoRaWAN 的 AWS IoT Core 资源的操作和数据类型的完整列表，请参阅 [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 执行此流程，即使用 AWS API 中与此处显示的 CLI 命令对应的方法。

**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)