# 将网关添加到 适用于 LoRaWAN 的 AWS IoT Core
<a name="lorawan-onboard-gateway-add"></a>

您可以私用控制台或 CLI 将网关添加到 适用于 LoRaWAN 的 AWS IoT Core。

添加您的网关之前，我们建议您考虑[将您的网关登记到 适用于 LoRaWAN 的 AWS IoT Core](lorawan-onboard-gateways.md)的**登记网关之前**部分中提到的各项因素。

如果您是第一次添加网关，我们建议您使用控制台。如果要改为使用 CLI 添加网关，您必须已创建必要的 IAM 角色，以便网关可以连接到 适用于 LoRaWAN 的 AWS IoT Core。有关如何创建此角色的信息，请参阅 [添加 IAM 角色以允许 Configuration and Update Server (CUPS) 管理网关凭证](lorawan-rfregion-permissions.md#lorawan-onboard-permissions)。

## 使用控制台添加网关
<a name="lorawan-onboard-gateway-console"></a>

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

1. 

**提供网关详细信息和频带信息**  
使用 **Gateway details**（网关详细信息）部分提供有关设备配置数据（如网关的 EUI 和频带配置）的信息。
   + 

**网关的 EUI**  
单个网关设备的 EUI（扩展唯一标识符）。EUI 是一个 16 位的字母数字代码，例如 `c0ee40ffff29df10`，它可以唯一标识 LoRaWAN 网络中的网关。此信息特定于您的网关型号，您可以在网关设备或其用户说明手册中找到。
**注意**  
网关的 EUI 与您可能看到印在网关设备上的 Wi-Fi MAC 地址不同。EUI 遵循 EUI-64 标准，该标准可唯一标识您的网关，因此不能在其他 AWS 账户和区域中重复使用。
   + 

**频段 (RFRegion)**  
网关的频带。您可以从 `US915`、`EU868`、`AU915` 或者 `AS923-1` 中进行选择，具体取决于您的网关支持的标准以及网关从哪个国家或地区进行实际连接。有关频段的更多信息，请参阅 [为您的网关和设备连接选择 LoRa 频带](lorawan-rfregion-permissions.md#lorawan-frequency-bands)。

1. 

**指定您的无线网关配置数据（可选）**  
这些字段是可选字段，您可以使用它们提供有关网关及其配置的其他信息。
   + 

**网关的名称、描述和标签**  
这些可选字段中的信息来自于您如何组织和描述无线系统中的元素。您可以将 **Name**（名称）添加到网关，使用 **Description**（说明）字段提供有关网关的信息，并使用 **Tag**（标签）添加有关网关的元数据键值对。有关命名和描述资源的更多信息，请参阅 [描述您的 AWS IoT Wireless 资源](iotwireless-describe-resources.md)。
   + 

**使用子带和滤波器的 LoRaWAN 配置**  
此外，您还可以指定 LoRaWAN 配置数据，例如要使用的子带和可控制流量的滤波器。在本教程中，您可以跳过这些字段。有关更多信息，请参阅[配置网关的子带和筛选功能](lorawan-subband-filter-configuration.md)。

1. 

**将 AWS IoT 事物与网关关联**  
指定是否创建 AWS IoT 事物，并将其与网关联。AWS IoT 中的事物可以让您更轻松地搜索和管理您的设备。将某个事物与您的网关关联将允许网关访问其他 AWS IoT Core 特征。

1. 

**创建并下载网关证书**  
对您的网关进行身份验证，以便它能够安全地与 AWS IoT 通信，您的 LoRaWAN 网关必须向 适用于 LoRaWAN 的 AWS IoT Core 提供私有秘钥和证书。创建**网关证书**，从而使 AWS IoT 能够使用 X.509 标准验证网关的身份。

   单击 **Create certificate**（创建证书）按钮并下载证书文件。稍后您将使用它们来配置网关。

1. 

**复制 CUPS 和 LNS 端点并下载证书**  
在建立与 适用于 LoRaWAN 的 AWS IoT Core 之间的连接时，LoRaWAN 网关必须连接到 CUPS 或 LNS 端点。建议您使用 CUPS 端点，因为它还提供配置管理。要验证 适用于 LoRaWAN 的 AWS IoT Core 的端点的身份，您的网关将为每个 CUPS 和 LNS 端点使用信任证书，

   单击 **Copy**（复制）按钮复制 CUPS 和 LNS 端点。稍后您将需要此信息来配置您的网关。然后单击 **Download server trust certificates**（下载服务器信任证书）按钮下载 CUPS 和 LNS 端点的信任证书。

1. 

**为网关权限创建 IAM 角色**  
您需要添加 IAM 角色，以允许 Configuration and Update Server (CUPS) 管理网关凭证。
**注意**  
在此步骤中，您将创建 **IoTWirelessGatewayCertManager** 角色。如果已创建该角色，则可以跳过此步骤。您必须在 LoRaWAN 网关尝试连接到 适用于 LoRaWAN 的 AWS IoT Core 之前执行此操作；不过，该操作只需执行一次。

   要为您的账户创建 **IoTWirelessGatewayCertManager** IAM 角色，请单击 **Create role**（创建角色）按钮。如果该角色已存在，请从下拉列表中选择该角色。

   单击 **Submit**（提交）以完成网关创建。

## 使用 API 添加网关
<a name="lorawan-onboard-gateway-api"></a>

如果您是首次使用 API 或 CLI 添加网关，必须将 **IoTWirelessGatewayCertManager** IAM 角色，以便网关可以与 适用于 LoRaWAN 的 AWS IoT Core 连接。有关如何创建角色的信息，请参阅以下部分 [添加 IAM 角色以允许 Configuration and Update Server (CUPS) 管理网关凭证](lorawan-rfregion-permissions.md#lorawan-onboard-permissions)。

以下列表描述了执行与添加、更新或删除 LoRaWAN 网关相关任务的 API 操作。

**适用于 LoRaWAN 的 AWS IoT Core 网关的 AWS IoT Wireless API 操作**
+ [CreateWirelessGateway](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_CreateWirelessGateway.html)
+ [GetWirelessGateway](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetWirelessGateway.html)
+ [ListWirelessGateways](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_ListWirelessGateways.html)
+ [UpdateWirelessGateway](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_UpdateWirelessGateway.html)
+ [DeleteWirelessGateway](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_DeleteWirelessGateway.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-gateway](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/create-wireless-gateway.html) 命令。以下示例将展示如何创建无线 LoRaWAN 设备网关。您也可以提供 `input.json` 文件，该文件将包含其他详细信息，例如网关证书和预调配凭证。

**注意**  
您也可以使用 API 执行此流程，即使用 AWS API 中与此处显示的 CLI 命令对应的方法。

```
aws iotwireless create-wireless-gateway \
    --lorawan GatewayEui="a1b2c3d4567890ab",RfRegion="US915" \
    --name "myFirstLoRaWANGateway" \
    --description "Using my first LoRaWAN gateway"
    --cli-input-json input.json
```

有关您可以使用的 CLI 的信息，请参阅 [AWS CLI 参考](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/index.html)