MA-X/MA-S/MA-E/IP-K Developers' WiKi

この文書は読取専用です。文書のソースを閲覧することは可能ですが、変更はできません。もし変更したい場合は管理者に連絡してください。
====== Azure IoT Edge を使用する (Using Azure IoT Edge) ======

\\
\\
[[download_software:max3xx:azure_iot_edge:start|]] を使用して、MA-X3xx シリーズの機器を Azure IoT Hub に接続してみます。\\
<color #7092be>(English) Connect MA-X3xx series devices to Azure IoT Hub using Azure IoT Edge Runtime Deployed Firmware.</color>

※ 詳細なドキュメントは [[https://learn.microsoft.com/ja-jp/azure/iot-edge/how-to-provision-single-device-linux-symmetric?view=iotedge-1.4&tabs=azure-portal%2Cubuntu|対称キーを使用して Linux で IoT Edge デバイスを作成およびプロビジョニングする - Microsoft]] を参照してください。\\
<color #7092be>※ (English) For detailed documentation, see [[https://learn.microsoft.com/en-us/azure/iot-edge/how-to-provision-single-device-linux-symmetric?view=iotedge-1.4&tabs=azure-portal%2Cubuntu|Create and provision an IoT Edge device on Linux using symmetric keys - Microsoft]]</color>\\
\\
\\
\\
===== Step 1：Prerequisites =====
作業を始める前に、以下のものを用意してください\\

  * Azureアカウント
  * Azure Portalへのログイン
  * Azure IoT Edge ランタイム導入済み ファームウェア


<color #7092be>(English) You should have the following items ready before beginning the process:</color>

  * [[https://azure.microsoft.com/en-us/free/|Create an Azure account]]
  * [[https://portal.azure.com/#home|Sign up to Azure Portal]]
  * [[download_software:max3xx:azure_iot_edge:start|Install Azure-IoT aware Firmware]]

\\

===== Step 2：Prepare your Device =====

==== 2.1 ファームウェアをダウンロードする ====
<color #7092be>(English) 2.1: Download the firmware.</color>\\

[[download_software:max3xx:azure_iot_edge:start|]] からファームウェアをダウンロードし、MA-X3xx にインストールして再起動しておきます。\\
<color #7092be>(English) Download the firmware from the [[https://wiki.centurysys.jp/doku.php?id=download_software:max3xx:azure_iot_edge:start|Azure IoT Edge Runtime Deployed Firmware]] , install it on the MA-X3xx and reboot.</color>
\\
\\
==== 2.2 ファームウェアのインストール、再起動 ====
<color #7092be>(English) 2.2: Firmware installation and restart</color>\\
\\
sftpなどでファームウェアを実機に転送するなどして、ファイルを準備します。
root権限で “firmup” コマンドを実行します。\\

<color #7092be>(English) Prepare the files by transferring the firmware to the actual device by sftp or other means.Execute the "firmup" command as root.</color>

<code>
root@plum:~# firmup /tmp/firmware.img 
### MA-E3xx series firmware update utility (for 2-area firmware).
Updating AREA: 0 ...
* image file for kernel found.
  writing "kernel" image to /dev/mtdblock2 ... succeeded.
* image file for kmod found.
  writing "kmod" image to /dev/mtdblock6 ... succeeded.
* image file for initramfs found.
  writing "initramfs" image to /dev/mtdblock4 ... succeeded.
* image file for rootfs found.
  writing "rootfs" image to /dev/mtdblock8 ... succeeded.
* DTB file found.
  writing "dtb" image to /dev/mtd15 ... succeeded.
* Bootloader file found.
  writing "barebox.bin" image to /dev/mtd13 ... succeeded.
Succeeded.
</code>
\\

※ アカウントがいろいろと追加されるため、アカウントの追加など作業をしていた環境にインストールした場合、オーバーレイ領域を初期化しておくほうが無難です。\\
<color #7092be>※ (English) Since various accounts are added, it is safer to initialize the overlay area if it is installed in an environment where work was being done to add accounts.</color>
\\
\\
==== 2.3 ネットワーク設定 ====
<color #7092be>(English) 2.3 Network Configuration</color>\\
\\
Azure に接続可能なように、適宜ネットワークの設定(デフォルトゲートウェイ、DNS など) を設定しておきます。\\
<color #7092be>(English) Configure network settings (default gateway, DNS, etc.) as appropriate to enable connection to Azure.</color>
\\

MA-X3xx シリーズのEthernet を利用する場合の設定画面です。\\
<color #7092be>(English) This is the setting screen when using Ethernet for the MA-X3xx series.</color>

{{:mas1xx_ope:use_webui:ethernet_setting:ethernet_00.png?1600|}}
\\

MA-X3xx シリーズのLTE Module を利用する場合の設定画面です。\\
<color #7092be>(English) This is the setting screen when using the LTE Module of MA-X3xx series.</color>

{{:mas1xx_ope:use_webui:lte_setting:lte_setting_00.png?1400|LTE 設定画面}}

\\
\\
===== Step 3: Manual Test for Azure IoT Edge on device =====
==== 3.1: Register your device ====

[[https://portal.azure.com/|Azure Portal]] にサインインして、IoT Hub に移動します。\\
<color #7092be>(English) Sign in to [[https://portal.azure.com/|Azure Portal]]  and navigate to IoT Hub.</color>\\

{{:max3xx_tips:use_azure_iot_edge:iotedge_00.png|Azure Portal - モノのインターネット}}

{{:max3xx_tips:use_azure_iot_edge:iotedge_01.png|IoT Hub}}

\\


接続する **IoT Hub** を選択して、メニューから **[デバイス]** を選択し、**デバイスの追加** をクリックします。\\
<color #7092be>(English) Select the **IoT Hub** you wish to connect to, select Devices from the menu, and click Add Device.</color>

{{:max3xx_tips:use_azure_iot_edge:iotedge_02.png|}}

\\

\\
**デバイスの作成** のページで、次の情報を入力します。\\
\\
1.デバイスID (任意の名称、今回の例では **ma-x3xx-01** としてみます)\\
2.**IoT Edge デバイス** のチェックボックスをオンにします。\\
3.『認証の種類』として **対象キー** を選択します。\\
4.設定できたら **保存** をクリックします。\\
\\
<color #7092be>(English) On the **Create Device page**, enter the following information</color>\\
\\
<color #7092be>1.(English) Device ID (arbitrary name, let's use ma-x3xx-01 in this example)</color>\\
<color #7092be>2.(English) Check the IoT Edge Device checkbox.</color>\\
<color #7092be>3.(English) Select the Symmetric key as the "Authentication Type".</color>\\
<color #7092be>4.(English) When you are done, click Save.</color>\\

{{:max3xx_tips:use_azure_iot_edge:iotedge_03.png|}}

\\

追加されました。\\
<color #7092be>(English) Added.</color>\\
{{:max3xx_tips:use_azure_iot_edge:iotedge_04.png|}}

\\

==== 3.2: Obtaining provisioning information ====

デバイスを設定する準備ができたら、デバイスを IoT ハブ内でのその ID にリンクする接続文字列が必要です。\\
対称キーを使用して認証を行うデバイスでは、接続文字列をポータルでコピーできます。\\
<color #7092be>(English) When you are ready to configure a device, you will need a connection string that links the device to its identity within the IoT hub.</color>\\
<color #7092be>(English) For devices that authenticate using symmetric keys, the connection string can be copied on the portal.</color>

**デバイス** ページで、一覧から **デバイス ID** を選択します。\\
<color #7092be>(English) On the Device page, select a Device ID from the list.</color>\\
\\
{{:max3xx_tips:use_azure_iot_edge:iotedge_05.png|}}

\\

**プライマリ接続文字列** または **セカンダリ接続文字列** のどちらかの値をコピーします。\\
※ どちらのキーも機能します。\\
<color #7092be>(English) Copy the value of either the primary or secondary connection string.</color>\\
<color #7092be>※(English) Both keys work.</color>\\

{{:max3xx_tips:use_azure_iot_edge:iotedge_06.png|}}

\\

==== 3.3: Device Provisioning ====

MA-X3xx デバイスにログインし、先ほどコピーした **接続文字列** を適用します。\\
<color #7092be>(English) Log in to the MA-X3xx device and apply the **connection string** you just copied.</color>\\

<code>
user1@metis:~$ sudo iotedge config mp --connection-string 'PASTE_DEVICE_CONNECTION_STRING_HERE'
</code>

{{:max3xx_tips:use_azure_iot_edge:iotedge_07.png|}}

\\

構成の変更を適用します。\\
<color #7092be>(English) Apply configuration changes.</color>\\

<code>
user1@metis:~$ sudo iotedge config apply
</code>

{{:max3xx_tips:use_azure_iot_edge:iotedge_08.png|}}

\\

==== 3.4: Checking the connection status ====

IoT Edge デバイスにランタイムが正常にインストールされ、構成されていることを確認します。\\
<color #7092be>(English) Verify that the runtime has been successfully installed and configured on the IoT Edge device.</color>\\

<code>
user1@metis:~$ sudo iotedge system status
</code>

{{:max3xx_tips:use_azure_iot_edge:iotedge_09.png|}}

\\

==== 3.5: Check in Azure Portal ====

Azure ポータル上で接続状態を確認します。正常に接続されると、下記のようになります。\\
接続完了直後は **Iot Edge ランタイムの応答** は 「417 -- デバイスのデプロイ構成が設定されていません」 となり、モジュールは **\$edgeAgent** のみ動作している状態になります。\\
<color #7092be>(English) Check the connection status on the Azure portal. If the connection is successful, it will look like the following</color>\\
<color #7092be>(English) Immediately after the connection is completed, the **Iot Edge Runtime Response** will be "417 --     **\$edgeAgent**. </color> \\

{{:max3xx_tips:use_azure_iot_edge:iotedge_10.png|}}

\\

==== 3.6: operation test ====

サンプルモジュール **"Sumulated Temperature Sensor"** をデバイスにデプロイして、動作確認を行います。\\
<color #7092be>(English) Deploy the sample module **"Sumulated Temperature Sensor "** on the device and check its operation.</color>\\
\\

=== Deploying Sample Modules ===

**モジュールを設定する** をクリックします。\\
<color #7092be>(English) Click **Set Modules**. </color>\\

{{:max3xx_tips:use_azure_iot_edge:iotedge_11.png|}}

\\

**＋ 追加** をクリックし、プルダウンのリストから **Marketplace モジュール** を選択します。\\
<color #7092be>(English) Click +Add and select the Marketplace module.</color>\\

{{:max3xx_tips:use_azure_iot_edge:iotedge_12.png|}}

\\

Marketplace のモジュールから **Simulated Temperature Sensor** を選択して追加します。\\
<color #7092be>(English) Select **Simulated Temperature Sensor** from the Marketplace modules to add.</color>\\
\\
{{:max3xx_tips:use_azure_iot_edge:iotedge_13.png|}}

{{:max3xx_tips:use_azure_iot_edge:iotedge_14.png|}}

\\

モジュール設定の画面に戻るので、**確認及び作成** ボタンをクリックします。\\
<color #7092be>(English) Click the **Review + create** button.</color>\\

{{:max3xx_tips:use_azure_iot_edge:iotedge_15.png|}}

\\

JSON で記述されたデプロイ設定画面が表示されますので、**作成** ボタンをクリックします。\\
<color #7092be>(English) Click the **Create** button on the Deploy Configuration screen described in JSON.</color>\\

{{:max3xx_tips:use_azure_iot_edge:iotedge_16.png|}}

\\

=== Confirmation of operational status ===

デプロイを実行すると、デバイスのページに戻ります。\\
しばらくして **最新の情報に更新** をクリックして状態を更新すると、『IoT Edge ランタイムの応答』 が "200 -- OK" になり、**\$edgeHub** と **SimulatedTemperatureSendor** モジュールが追加され、"running" になっていることが確認できます。\\
<color #7092be>(English) Once deployed, you will be returned to the device page.\\
(English) After a while, click **Update** to refresh the status, and you will see that the "IoT Edge Runtime Response" is "200 -- OK" and that the **\$edgeHub** and **SimulatedTemperatureSendor** modules have been added and are "running". The "Runtime Response" is "200 -- OK".</color>\\




{{:max3xx_tips:use_azure_iot_edge:iotedge_17.png|}}
MA-X/MA-S/MA-E/IP-K Developers' WiKi

ユーザ用ツール

サイト用ツール

ページ用ツール
