# 將閘道新增至 AWS IoT Core for LoRaWAN
<a name="lorawan-onboard-gateway-add"></a>

您可以使用主控台或 CLI，將閘道新增至 AWS IoT Core for LoRaWAN。

新增閘道之前，我們建議您考慮 [將閘道加入 AWS IoT Core for LoRaWAN](lorawan-onboard-gateways.md) 的**在加入您的閘道之前**一節中提到的因素。

如果您是第一次新增閘道，我們建議您使用主控台。如果您想要改用 CLI 新增閘道，則必須已建立必要的 IAM 角色，以便閘道可以與 AWS IoT Core for LoRaWAN 連接。如需如何建立角色的相關資訊，請參閱 [新增 IAM 角色以允許組態與更新伺服器 (CUPS) 管理閘道憑證](lorawan-rfregion-permissions.md#lorawan-onboard-permissions)。

## 使用主控台新增閘道
<a name="lorawan-onboard-gateway-console"></a>

導覽至 AWS IoT 主控台的 [AWS IoT Core for LoRaWAN](https://console.aws.amazon.com/iot/home#/wireless/landing) **Intro** (簡介) 頁面，並選擇 **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 帳戶 和 Region 中重複使用。
   + 

**頻帶 (RFRegion)**  
閘道的頻帶。您可以選擇 `US915`、`EU868`、`AU915` 或 `AS923-1`，取決於閘道支援的項目，以及閘道實際連線的國家或地區。如需頻帶的相關資訊，請參閱 [考慮為閘道和裝置連線選取 LoRa 頻帶](lorawan-rfregion-permissions.md#lorawan-frequency-bands)。

1. 

**指定您的無線閘道組態資料 (選用)**  
這些是選用欄位，您可以使用它們來提供關於閘道及其組態的其他資訊。
   + 

**閘道的名稱、描述和標籤**  
這些選用欄位中的資訊來自於您如何組織和描述無線系統中的元素。您可以將 **Name** (名稱) 指派給閘道、使用**Description** (描述) 欄位來提供閘道的相關資訊，以及使用 **Tags** (標籤) 來新增關於閘道的中繼資料的鍵值對。如需有關命名和描述資源的詳細資訊，請參閱 [描述您的 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 閘道必須提供私有金鑰和憑證給 AWS IoT Core for LoRaWAN。建立 **Gateway certificate** (閘道憑證)，以便 AWS IoT 可以使用 X.509 標準來驗證閘道的身分。

   按一下 **Create certificate** (建立憑證) 按鈕並下載憑證檔案。稍後您將使用它們來設定閘道。

1. 

**複製 CUPS 和 LNS 端點並下載憑證**  
建立與 AWS IoT Core for LoRaWAN 的連線時，您的 LoRaWAN 閘道必須連接到 CUPS 或 LNS 端點。建議您使用 CUPS 端點，因為它也可以提供組態管理。若要驗證 AWS IoT Core for LoRaWAN 端點，您的閘道會針對每個 CUPS 和 LNS 端點使用信任憑證，

   按一下 **Copy** (複製) 按鈕來複製 CUPS 和 LNS 端點。您稍後需要此資訊來設定您的閘道。然後按一下 **Download server trust certificates** (下載伺服器信任憑證) 按鈕，來下載 CUPS 和 LNS 端點的信任憑證。

1. 

**建立 IAM 角色以取得閘道許可**  
您需要新增一個允許組態與更新伺服器 (CUPS) 管理閘道憑證的 IAM 角色。
**注意**  
在此步驟中，您會建立 **IoTWirelessGatewayCertManager** 角色。如果您已建立此角色，則可略過此步驟。您必須先執行此動作，然後 LoRaWAN 閘道才會嘗試與 AWS IoT Core for LoRaWAN 連接；不過，您只需執行此動作一次。

   若要為您的帳戶建立 **IoTWirelessGatewayCertManager** IAM 角色，請按一下 **Create role** (建立角色) 按鈕。如果角色已存在，請從下拉式清單中選取該角色。

   按一下 **Submit** (提交) 以完成閘道建立。

## 使用 API 新增閘道
<a name="lorawan-onboard-gateway-api"></a>

如果您是第一次使用 API 或 CLI 新增閘道，則必須新增 **IoTWirelessGatewayCertManager** IAM 角色，以便閘道可以與 AWS IoT Core for LoRaWAN 連接。如需如何建立角色的相關資訊，請參閱下列 [新增 IAM 角色以允許組態與更新伺服器 (CUPS) 管理閘道憑證](lorawan-rfregion-permissions.md#lorawan-onboard-permissions) 一節。

下方清單描述 API 動作，其會執行與新增、更新或刪除 LoRaWAN 閘道相關聯的任務。

**AWS IoT Core for LoRaWAN 閘道的 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)

如需可用來建立和管理 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-gateway](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/create-wireless-gateway.html) 命令。以下範例會建立無線 LoRaWAN 裝置閘道。您也可以提供 `input.json` 檔案，其中包含其他詳細資訊，例如閘道憑證和佈建憑證。

**注意**  
您也可以使用 API 中對應於此處顯示的 CLI 命令的方法，在 AWS API 中執行此程序。

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