説明

The Things Networkは、LoRaWANネットワークおよびサービスの大手プロバイダーであり、そのスタックをv3（The Thing Stack v3）にアップグレードしています。LoRaWANのエンドデバイスおよびゲートウェイの大手プロバイダーであるMilesight IoTのゲートウェイは、「Semtech Packet forwarder」またはBasic Station経由に関わらず、The Thing Stackに簡単に接続できます。

Basic Stationには、ゲートウェイをネットワークサーバーに接続するための2つのサブプロトコル、LoRaWANネットワークサーバー（LNS）と構成およびアップデートサーバー（CUPS）が含まれています。本ドキュメントでは、CUPSまたはLNS経由でThe Thing Stackに接続する方法を説明します。両方から1つを選択して構成を完了することができます。

Semtech Packet forwarderを使用する場合は、こちらをクリックしてください。

要件

• The Thing Stack Sandboxアカウント
• Milesight LoRaWAN ゲートウェイ

設定

1. The Thing Stack にログインし、ゲートウェイを追加します

ステップ1. The Thing Stack にログインします

ゲートウェイの設置場所に応じてクラスタを選択し、認証情報/Things ID を使用して The Thing Stack にログインします。

これはログインページです。 Login with The Things ID

認証情報を入力し、Submit（送信）をクリックします。

完了すると、このコンソールページが正常に表示されます。

ステップ2. ゲートウェイを追加します

1. ゲートウェイのウェブインターフェースにログインして、周波数プランを確認します。この例では、周波数プランはEU868です。

You will need to take a note of the Gateway ID and Gateway EUI, which is needed when Register a device in The Thing Stack.

MilesightゲートウェイのデフォルトのGateway IDはGateway EUIと同じです。 Gateway IDはご自身のものに変更できます。 この例では、Gateway ID= milesightug65、Gateway EUI= 24E124FFFEF1272Bです。 ゲートウェイIDは36文字以下で、小文字の英数字とダッシュ（-）のみを使用する必要があります。

2. The Thing Stack ページで Register a Gateway をクリックし、ゲートウェイ情報を入力します。

• Gateway EUI:ゲートウェイのウェブ GUI のステータスページで確認できます。 EUI を入力せずに Continue をクリックして空白のままにしておくこともできます
• Gateway ID:ゲートウェイのウェブ GUI で設定した ID と同じです。 この例では milesightug65 です
• Gateway name: ユーザー定義
• Frequency plan:ゲートウェイの設定と同じです。 この例では EU868 です
• Require authenticated connection: 有効

注：

1）Thing Stackで削除したゲートウェイIDは再利用できません

2）「APIキーを生成」のチェックボックスにチェックを入れ、キーファイルを直接ダウンロードすることをお勧めします。

完了すると、ゲートウェイが正常に作成されます。

ステップ3. APIキーの作成

注：すでにAPIキーを生成している場合は、このステップをスキップしてください。

ゲートウェイをLNSに接続する必要がある場合は、LNS APIキーを作成してください。ゲートウェイをCUPSに接続する必要がある場合は、LNS APIキーとCUPS APIキーを作成してください。

1. LNS APIキーの作成

API Keys > Add API Keyをクリックします

任意の名前を入力し、Grant Individual rightsにチェックを入れ、以下の権利を選択し、Create API Keyをクリックします。

API キーをコピーする旨のポップアップウィンドウが表示されます。

この例では、LNS API キーは次のとおりです。: NNSXS.KDSXSAHLASC6REZDI3RV3ZTU27FDTNQVSRT7TYQ.MD7XXFD5D7ZOJW7XT2G3IV3QSVCTMVKJLKB2RF7HPPQOJPRUH6LQ

2. CUPS API キーを作成します

注：LNS プロトコルを使用してゲートウェイを The Thing Stack に接続する必要がある場合は、この手順をスキップします。

API Keys > Add API Keyをクリックし、任意の名前を入力し、Grant Individual rights にチェックを入れ、以下の権利を選択し、Create API Key をクリックしてキーをコピーします。

この例では、CUPS キーは次のとおりです。

NNSXS.O75NDWBFXFP2PVPGJU7NL5GBAUFNUWPLCUT57XA.BBMHEII2FJT433QJX37CNOQBBJ74465BJC5BZSF6JPT4OLB4XXAQ

注記：各デバイス用に作成されたアプリケーションには固有のキーが割り当てられます。

2. ゲートウェイをLNS経由でThing Stackに接続

ステップ1. CAファイル（*.trust）を用意

これは、お客様のドメインを保護するCA証明書です。Milesight Gatewayでは、信頼された認証局（CA）が発行した、The Things Stackで使用される一般的なルートSSL証明書へのリンクが含まれています。ISRG Root X1 Trustファイルをダウンロードして展開すると、isrgrootx1.pemというCAファイルが取得できます。これを*.trustにリネームします。

また、こちらから、さらに多くのCAファイルを入手できます。

ステップ2. クライアントキーファイル（*.key）を用意します。

注：すでに新しいゲートウェイを追加する際にAPIキーを生成している場合は、このステップをスキップしてください。

以下のコマンドを実行してLNS.keyファイルを生成します。<your-lns-api-key> を、前にコピーしたLNS APIキーに置き換えてください。

LinuxまたはmacOSでは、以下のコマンドを使用します。

export LNS_KEY="your-lns-api-key"
echo "Authorization: Bearer $LNS_KEY" | perl -p -e 's/\r\n|\n|\r/\r\n/g' > lns.key

Windows のコマンドプロンプトでは、次のコマンドを使用します。

set LNS_KEY=your-lns-api-key
echo Authorization: Bearer %LNS_KEY% > lns.key

この例では、コマンドプロンプトの詳細は次のようになります。

その後、対応するパスで lns.key ファイルを見つけることができます。

Milesight Gateway にアップロードするファイルは次のとおりです。

ステップ3. ゲートウェイの設定

1. ゲートウェイがインターネットに正常に接続できることを確認します。

2. Packet Forwarder > General に移動し、Embedded NS を無効にして、新しい宛先を作成します。

3. + をクリックして新しい宛先を作成します

タイプをBasic Stationとして選択し、このオプションを有効にして、Connecting to an LNSの情報を入力し、Save&Applyをクリックします。

• URI: フォーマットはwss://<server-address>:8887です。こちらをクリックして情報を入力し、正しいURIを取得できます。
• CA File: .trustフォーマットファイルをインポートします
• Client Key File: lns.keyフォーマットファイルをインポートします

CA file と Client Key の両方に Import をクリックし、その後 Save をクリックします。

4. The Thing Stack 側でゲートウェイのステータスを確認します。正常にオンライン化されています。

上記のスクリーンショットでは、ゲートウェイからのパケットを確認できます。

3. CUPS 経由でゲートウェイを The Thing Stack に接続

ステップ1. CA ファイル (*. trust)

これは、お客様のドメインを保護するCA証明書です。The Things Stackで使用される一般的なルートSSL証明書へのリンクが含まれており、信頼された認証局（CA）によって発行されています。Milesight Gatewayでは、ISRG Root X1 Trustファイルをダウンロードして展開するだけで、isrgrootx1.pemというCAファイルが取得できます。これを*.trustにリネームする必要があります。

また、こちらからさらに多くのCAファイルを入手できます。

ステップ2. CUPSを設定してLNS APIキーを送信する

注：すでに新しいゲートウェイを追加する際にAPIキーを_生成している場合は、このステップをスキップしてください。

一般設定をクリックし、前のステップで生成したLNSキー（「NNSXS…」で始まる）の内容をここに貼り付けます。

ステップ3. クライアントキーファイル（*.key）を準備する

注：すでに新しいゲートウェイを追加する際にAPIキーを_生成している場合は、このステップをスキップしてください。

以下のコマンドを実行してCUPS.keyファイルを生成します。<your-cups-api-key> を、前にコピーしたCUPS APIキーに置き換えてください。

LinuxまたはmacOSでは、以下のコマンドを使用します。

CUPS_KEY="your-cups-api-key"
echo "Authorization: Bearer $CUPS_KEY" | perl -p -e 's/\r\n|\n|\r/\r\n/g'  > cups.key

Windows のコマンドプロンプトでは、次のコマンドを使用します。

set CUPS_KEY=your-cups-api-key
echo Authorization: Bearer %CUPS_KEY% > cups.key

この例では、コマンドプロンプトの詳細は次のようになります。

その後、対応するパスで lns.key ファイルを見つけます。
Milesight Gateway にアップロードするファイルは次のとおりです。

ステップ4. ゲートウェイの設定

1. ゲートウェイがインターネットに正常に接続できることを確認します。

2. Packet Forwarder > General に移動し、Embedded NS を無効にして、新しい宛先を作成します。

3. + をクリックして新しい宛先を作成します

タイプを「Basic Station」に選択し、このオプションを有効にして、CUPSに接続するための情報を入力し、「Save&Apply」をクリックします。

• URI: フォーマットはhttps://<サーバーアドレス>:443です。こちらをクリックして情報を入力し、正しいURIを取得できます。
• CA File: .trustフォーマットファイルをインポートします
• Client Key File: Cups.keyフォーマットファイルをインポートします

4. The Thing Stack 側でゲートウェイのステータスを確認します。正常にオンライン化されています。

上記のスクリーンショットでは、ゲートウェイからのパケットを確認できます。