# ゲートウェイのサブバンドとフィルタリング機能を設定する
<a name="lorawan-subband-filter-configuration"></a>

LoRaWAN ゲートウェイは、ゲートウェイが AWS IoT Core for LoRaWAN に接続できるようにする [LoRa Basics Station](https://doc.sm.tc/station) ソフトウェアを実行します。AWS IoT Core for LoRaWAN に接続するために、LoRa ゲートウェイはまず CUPS サーバーに LNS エンドポイントをクエリし、そのエンドポイントとの WebSockets データ接続を確立します。接続が確立されたら、その接続を介してアップリンクフレームとダウンリンクフレームを交換できます。

## ゲートウェイが受信する LoRa データフレームのフィルタリング
<a name="lorawan-frequency-channels-subbands"></a>

LoRaWAN ゲートウェイがエンドポイントへの接続を確立した後、AWS IoT Core for LoRaWAN は、LoRa ゲートウェイの設定の一連のパラメータを指定する `router_config` メッセージで応答します。これには、`NetID` や `JoinEui` のフィルタリングパラメータが含まれます。`router_config` についてと、LoRaWAN Network Server (LNS) との接続が確立される方法については、[LNS プロトコル](https://doc.sm.tc/station/tcproto.html)を参照してください。

```
{
"msgtype"    : "router_config"
"NetID"      : [ INT, .. ]
"JoinEui"    : [ [INT,INT], .. ] // ranges: beg,end inclusive
"region"     : STRING             // e.g. "EU863", "US902", ..
"hwspec"     : STRING
"freq_range" : [ INT, INT ]       // min, max (hz)
"DRs"        : [ [INT,INT,INT], .. ]   // sf,bw,dnonly
"sx1301_conf": [ SX1301CONF, .. ]
"nocca"      : BOOL
"nodc"       : BOOL
"nodwell"    : BOOL
}
```

ゲートウェイは、通常、Wi-Fi、イーサネット、またはセルラーなどの広帯域幅ネットワーク経由で、LoRaWAN デバイスデータを LNS との間で送受信します。ゲートウェイは通常、すべてのメッセージをピックアップし、ゲートウェイに送信されるトラフィックを AWS IoT Core for LoRaWAN に渡します。ただし、一部のデバイスデータトラフィックをフィルターするようにゲートウェイを設定できます。これにより、帯域幅の使用量を節約し、ゲートウェイと LNS 間のトラフィックフローを削減できます。

データフレームをフィルターするように LoRa ゲートウェイを設定するには、`router_config` メッセージ内のパラメータ `NetID` および `JoinEui` を使用できます。`NetID` は、受け入れられる NetID 値のリストです。リストされているもの以外のデータフレームを含む LoRa データフレームは除外されます。`JoinEui` は、JoinEUI 値の範囲をエンコードする整数値のペアのリストです。参加要求フレームは、メッセージ内の `JoinEui` フィールドが [BegEui,EndEui] の範囲にない限り、ゲートウェイによって除外されます。

## 周波数チャネルとサブバンド
<a name="lorawan-frequency-channels-subbands"></a>

US915 および AU915 の RF リージョンでは、ワイヤレスデバイスには 64 個の 125 KHz アップリンクチャネルと 8 個の 500 KHz アップリンクチャネルがあり、LoRa ゲートウェイを使用して LoRaWAN ネットワークにアクセスできます。アップリンク周波数チャネルは 8 つのサブバンドに分かれており、それぞれに 8 つの 125 KHz チャネルと 1 つの 500 KHz チャネルがあります。AU915 リージョンの通常ゲートウェイごとに、1 つ以上のサブバンドがサポートされます。

一部のワイヤレスデバイスはサブバンド間でホップできず、AWS IoT Core for LoRaWAN への接続時に 1 つのサブバンドでのみ周波数チャネルを使用します。これらのデバイスからのアップリンクパケットを送信するには、LoRa ゲートウェイをその特定のサブバンドを使用するように設定します。EU868 など、他の RF リージョンのゲートウェイでは、この設定は必要ありません。

## コンソールを使用して、フィルタリングおよびサブバンドを使用するようにゲートウェイを設定する
<a name="lorawan-configure-gateway-channels-console"></a>

特定のサブバンドを使用するようにゲートウェイを設定したり、LoRa データフレームをフィルタリングする機能を有効にしたりすることができます。コンソールを使用してこれらのパラメータを指定するには、次のようにします。

1. AWS IoT コンソールの [AWS IoT Core for LoRaWAN](https://console.aws.amazon.com/iot/home#/wireless/gateways) の **[Gateways]** (ゲートウェイ) ページに移動し、**[Add gateway]** (ゲートウェイの追加) を選択します。

1. **[Gateway's Eui]** (ゲートウェイのEUI)、**[Frequency band (RFRegion)]** (周波数帯 (RFRegion))、オプションで **[Name]** (名前) および **[Description]** (説明) など、ゲートウェイの詳細を指定して、AWS IoT のモノをゲートウェイに関連付けるかどうかを選択します。ゲートウェイを追加する方法については、「[コンソールを使用してゲートウェイを追加する](lorawan-onboard-gateway-add.md#lorawan-onboard-gateway-console)」を参照してください。

1. [**LoRaWAN configuration**] (LoRaWAN 設定) セクションでは、サブバンドとフィルタリング情報を指定できます。
   + `SubBands`: サブバンドを追加するには、**Add SubBand**を選択し、ゲートウェイでサポートされているサブバンドを示す整数値のリストを指定します。`SubBands` パラメータは、`RfRegion` US915 および AU915 でのみ設定でき、これらのサポート対象リージョン内のいずれかの `[1,8]` の範囲内にある値を持つ必要があります。
   + `NetIdFilters`: アップリンクフレームをフィルターするには、[**Add NetId**] (NetID の追加) をクリックし、ゲートウェイが使用する文字列値のリストを指定します。ワイヤレスデバイスからの着信アップリンクフレームの NetID は、リストされている値の少なくとも 1 つと一致する必要があります。一致しない場合、フレームは除外されます。
   + `JoinEuiFilters`: [**Add JoinEui range**] (参加範囲の追加) を選択し、ゲートウェイが LoRa フレームをフィルターするために使用する文字列値のペアのリストを指定します。ワイヤレスデバイスからの参加要求の一部として指定された JoinEUI 値は、それぞれが [BegEui, EndEui] のペアとしてリストされた、少なくとも 1 つの JoinEuiRange 値の範囲内にある必要があります。そうでない場合、フレームは除外されます。

1. 「[コンソールを使用してゲートウェイを追加する](lorawan-onboard-gateway-add.md#lorawan-onboard-gateway-console)」で説明されている手順に従って、ゲートウェイの設定を続行できます。

ゲートウェイを追加した後、AWS IoT コンソールで [AWS IoT Core for LoRaWAN](https://console.aws.amazon.com/iot/home#/wireless/gateways) の **[Gateways]** (ゲートウェイ)ページで、追加したゲートウェイを選択すると、[Gateway details] (ゲートウェイの詳細) ページの **[LoRaWAN specific details]** (LoRaWAN 固有の詳細) セクションに `SubBands`、フィルター `NetIdFilters` および `JoinEuiFilters` が表示されます。

## API を使用して、フィルタリングおよびサブバンドを使用するようにゲートウェイを設定する
<a name="lorawan-configure-gateway-channels-api"></a>

ゲートウェイの作成に使用する [CreateWirelessGateway](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_CreateWirelessGateway.html) API を使用して、使用するサブバンドを設定し、フィルタリング機能を有効にすることができます。`CreateWirelessGateway` API を使用すると、`LoRaWAN` フィールドを使用して指定したゲートウェイ設定情報の一部としてサブバンドとフィルターを指定できます。以下に、この情報を含むリクエストトークンを示します。

```
POST /wireless-gateways HTTP/1.1
Content-type: application/json

{
"Arn": "arn:aws:iotwireless:us-east-1:400232685877aa:WirelessGateway/
       a11e3d21-e44c-471c-afca-6716c228336a",
"Description": "Using my first LoRaWAN gateway",
   "LoRaWAN": { 
      "GatewayEui": "a1b2c3d4567890ab",
      "JoinEuiFilters": [
        ["0000000000000001", "00000000000000ff"],
        ["000000000000ff00", "000000000000ffff"]
      ],
      "NetIdFilters": ["000000", "000001"],
      "RfRegion": "US915",
      "SubBands": [2]
   },
   "Name": "myFirstLoRaWANGateway"  
   "ThingArn": null,
   "ThingName": null
}
```

また、[UpdateWirelessGateway](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_UpdateWirelessGateway.html) API を使用して、サブバンドは更新せずにフィルターを更新することができます。`JoinEuiFilters` と `NetIdfilters` の値が null の場合、そのフィールドに更新がないことを意味します。値が null でなく、空のリストが含まれている場合は、更新が適用されています。指定したフィールドの値を取得するには、[GetWirelessGateway](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetWirelessGateway.html) API を使用します。