第4章 Armadillo ソフトウェア仕様

node-eye パッケージはアットマークテクノが提供する Debian パッケージです。node-eye を利用するためのクライアントソフトやファームウェアアップデートのためのスクリプトなどがまとめられています。 node-eye を利用するためには node-eye パッケージを Armadillo にインストールする必要があります。

node-eye パッケージをインストール可能な製品を以下に示します。この他の製品に node-eye パッケージはインストール出来ません。

Armadillo-IoT ゲートウェイ G3
Armadillo-IoT ゲートウェイ G3L
Armadillo-X1

4.2.1. node-eye パッケージのインストール・アンインストール

node-eye パッケージをインストールするには、下記のコマンドを実行します。

[armadillo ~]# apt-get update
[armadillo ~]# apt-get install node-eye

node-eye パッケージをアンインストールするには、下記のコマンドを実行します。

[armadillo ~]# apt-get remove node-eye

4.2.2. node-eye.service の有効化・無効化

node-eye.service を有効化することで、Armadillo の起動後自動的に armsd を立ち上げることができます。

node-eye.service を有効化するには、下記のコマンドを実行します。

[armadillo ~]# systemctl enable node-eye.service

node-eye.service を無効化するには、下記のコマンドを実行します。

[armadillo ~]# systemctl disable node-eye.service

node-eye.service が有効化されているかどうかを確認するには、下記のコマンドを実行します。

[armadillo ~]# systemctl is-enabled node-eye.service

4.3. armsd

本章では node-eye パッケージに含まれている ARMS プロトコルのクライアントソフト "armsd" について説明します。

node-eye の死活監視、リモートコンフィグ、ファームウェアアップデートなどの機能は、armsd と SACM が互いに通信することで実現しています。以下では armsd の標準機能である死活監視機能、リモートコンフィグ機能、接続状態表示機能について説明します。

4.3.1. 死活監視機能

armsd は SACM から死活監視を行うために、定期的に SACM へ Heartbeat パケットを送信しています。SACM が Heartbeat パケットを受信すると、SACM は Heartbeat パケットを送ってきた Armadillo と接続中であると判断します。

armsd の Heartbeat パケット送信間隔
- 5分に1回 Heartbeatを Armadilloから送信
SACM の接続状態の表示
- [切断中]のとき、1回Heartbeat パケットが SACM に到達すると、接続状態を[接続中]に変化させる
- [接続中]のとき、3回連続でHeartbeat パケットが SACM に到達しなかった場合、接続状態を[切断中]に変化させる


	リカバリーイメージは、Heartbeat パケットを送信しません。従って、接続状態の表示は[切断中]となりますが、Armadillo と SACM は互いに通信できるため復旧作業(ファームウェアアップデートなど)は可能です。

4.3.2. リモートコンフィグ機能

SACM から Armadillo 上の設定ファイルの修正を行ったり、なんらかのアプリケーションを実行するためには、armsd のモジュールという仕組みを使います。

以下では、リモートコンフィグ機能に欠かせないモジュールについて説明します。

4.3.2.1. モジュールについて

モジュールは Armadillo のユーザーランドに配置された start/stop/reconfig/command といった オペレーション を受け付けるスクリプトとして実装されています。

モジュールにはバイナリモジュール(BIN module)、コマンドラインインターフェースモジュール(CLI module)の2種類あり、16個のモジュールが用意されています。

表4.3 モジュールのタイプとその用途

No.	Module type	用途
0 - 3	CLI module	アットマークテクノが提供する機能に使用
4 - 7	CLI module	お客様が自由に使用
8 - 11	BIN module	お客様が自由に使用
12 - 15	CLI module	お客様が自由に使用

CLI moduleは、SACM上で直接、モジュールのコンフィグを編集、参照することができます。バイナリモジュールは、SACM上でコンフィグの内容を直接参照することはできず、ダウンロードとアップロードのみが可能です。

また、コマンドラインインターフェースモジュールのコンフィグで扱えるのは、US-ASCII のテキストのみに限られます。日本語などのマルチバイト文字が含まれる場合、バイナリモジュールで取り扱う必要があります。

モジュールのコンフィグについては SACM コンフィグの概念を参照してください。

モジュール0 ~ 3はアットマークテクノが提供する機能(ネットワーク設定、ファームウェア管理など)に使用しています。モジュール0 ~ 3に変更を加えることは可能ですが、変更を加えた場合にはアットマークテクノから提供する機能(サービス等)を受けられなくなる場合があります。

現在、アットマークテクノから提供しているモジュールを表に示します。

表4.4 アットマークテクノが提供しているモジュール一覧

No.	Module type	Module name	用途
0	CLI module	ネットワークモジュール	ネットワークインターフェースの設定に使用
1	CLI module	ファームウェアモジュール	ファームウェアアップデートに使用

モジュール4 ~ 15 はお客様が自由に使用することができます。モジュールを作成・追加を行うには「モジュールの作成方法」を参照してください。

その他、モジュールに関する情報は SACM モジュールの概念を参照してください。

4.3.3. 接続状態表示機能

armsd は SACM との接続状態によって、ユーザー LED3 を点灯,点滅させます。ユーザーは、ユーザー LED3 の点灯状態を確認することで、Armadillo と SACM の接続状態を確認することができます。

ユーザー LED3 の点灯,点滅と接続状態の関係を以下に記載します。

表4.5 ユーザー LED3 の点灯,点滅と接続状態の関係

ユーザー LED3 の状態	接続状態
点灯	接続完了
点滅	接続中

Armadillo-IoT の外観から見たユーザー LED の位置を以下に示します。

図4.1 ユーザーLEDの位置

4.3.4. その他・詳細仕様

armsd についてより詳しい情報は libarms のドキュメントを参照してください

4.4. アットマークテクノが提供するモジュールの仕様

本章ではアットマークテクノが提供する armsd のモジュールについて説明します。

4.4.1. ネットワークモジュール

ネットワークモジュールは Armadillo のネットワーク設定を管理します。ネットワークモジュールを使用することで、SACM コントロールパネルから Armadillo のネットワーク設定を変更することができます。ネットワークモジュールを使ったネットワークの設定方法は「ネットワーク設定方法」を参照してください。

4.4.1.1. ネットワークインターフェース設定シーケンス

以下に SACM 上に設定したネットワークインターフェース設定が反映されるまでのシーケンスを示します。

armsd が起動すると/etc/armsd/scripts/line が実行されます。 /etc/armsd/scripts/line は /etc/armsd/line.conf を元に /etc/NetworkManager/system-connections/armsd_line_connection (以下、コネクションと表記します)を生成します。
次に、生成されたコネクションを使用して LS(Location Server)に接続します。
接続が確立すると、LS から RS(Resource Server)へ接続するために必要な情報(Location-Config)を取得します。これを LS Pull といいます。Armadillo は LS Pull に成功すると、Location-Config をキャッシュします。(/etc/armsd/armsd.cacheとして保存します) Location-Config がある場合、LS Pull をスキップします。
次に、再び/etc/armsd/scripts/line でコネクションを生成し、これを用いて RS へ接続します。ここで生成されるコネクションは、armsd が起動した時と同じものが生成されます。
接続が確立すると、RS から SACM のモジュール N に設定されたコンフィグ(Service-Config)を取得します。これを RS Pull といいます。
取得した Service-Config を用いて、post-pull script がコネクションを生成します。
こうして、Service-Config の設定でネットワークインターフェースがアップします。
最後に接続性の確認を行います。
- Service-Config により設定したコネクションで SACM と接続できるかを確認します。接続は 5 回試行しますが、5 回とも接続できなかった場合、新たに設定する前の Service-Config にロールバックします。
SACM との接続が確認されると、ネットワーク設定のシーケンスは終了となります。

4.4.1.2. コンフィグの書式

ネットワークモジュール(モジュール0)のコンフィグの書式を以下に示します。

version=[version]

[key]=[value]
[key]=[value]
     :

version
- モジュール内の処理とコンフィグの内容を対応付けるために使用するバージョン番号です
- Armadillo-IoT G3, Armadillo-IoT G3L, Armadillo-X1 では "2" 固定となっています
key
- コンフィグの変数名です
- 同一の key を同じコンフィグ内に書くと、後に書かれたものが使用されます
- key の前に#をつけることで、コメントアウトできます
value
- key に対応する値です

4.4.1.3. ネットワークモジュールコンフィグ一覧

4.4.1.3.1. eth0

ネットワークモジュールの eth0 に関する key 一覧です。

表4.6 ネットワークモジュールの eth0 に関する key 一覧

key	value (参考例)	説明
interface_eth0	enable	eth0 の有効/無効 (enable / disable)
interface_eth0_type	static	IPアドレスの設定方法 (dhcp / static)
interface_eth0_address	192.168.10.1	IPアドレス
interface_eth0_netmask	255.255.0.0	ネットマスク
interface_eth0_gateway	192.168.0.1	ゲートウェイ
interface_eth0_metric	1	メトリック値
interface_eth0_never-default	true	デフォルトゲートウェイとして使用しない (true / false) 未設定の場合false


	interface_eth0_never-default はnode-eyeパッケージ v0.2.0-1 以降で使用することができます。

4.4.1.3.2. wwan

ネットワークモジュールの wwan に関する key 一覧です。

表4.7 ネットワークモジュールの wwan に関する key 一覧

key	value (参考例)	説明
interface_wwan	enable	wwan の有効/無効 (enable / disable)
interface_wwan_type	dhcp	IPアドレスの設定方法 (dhcp のみサポート)
interface_wwan_apn	APN	アクセスポイント名 (APN)
interface_wwan_id	"user name"	認証ID(ユーザー名)
interface_wwan_pass	"password"	パスワード
interface_wwan_metric	20	メトリック値

4.4.1.3.3. wlan0

ネットワークモジュールの wlan0 に関する key 一覧です。

表4.8 ネットワークモジュールの wlan0 に関する key 一覧

key	value (参考例)	説明
interface_wlan0	enable	enable または disable
interface_wlan0_type	dhcp	dhcp または static
interface_wlan0_address	192.168.10.2	IPアドレス
interface_wlan0_netmask	255.255.0.0	ネットマスク
interface_wlan0_gateway	192.168.0.1	ゲートウェイ
interface_wlan0_metric	40	メトリック値
interface_wlan0_never-default	true	デフォルトゲートウェイとして使用しない (true / false) 未設定の場合false
interface_wlan0_passphrase	"passphrase"	パスフレーズ
interface_wlan0_cryptmode	"WPA2-AES"	暗号化方式*1
interface_wlan0_essid	"mywpa2aes"	ESSID


	interface_wlan0_never-default はnode-eyeパッケージ v0.2.0-1 以降で使用することができます。

4.4.1.3.4. resolv.conf

ネットワークモジュールの resolv.conf に関する key 一覧です。 resolv_conf_から始まる変数の値は /etc/resolv.conf に書き込まれます。

表4.9 ネットワークモジュールの resolv.conf に関する key 一覧

key	説明
resolv_conf_search	resolv.conf の search
resolv_conf_nameserver	resolv.conf の nameserver

4.4.2. ファームウェアモジュール

ファームウェアモジュールは node-eye コントロールパネルからファームウェアアップデートを行う際に使用されます。ファームウェアモジュールを使ったファームウェアアップデートの方法は「ファームウェアアップデートを行う」を参照してください。

ファームウェアモジュールで書き換えることのできるファイルは以下の3つです。 kernel, dtb は必ず同時にアップデートを行います。個別にアップデートすることはできません。dtb のみ、kernel のみ更新したい場合は、Armadillo に既に書き込まれているイメージを指定する必要があります。

kernel・dtb
userland
recovery

ファームウェアアップデートを行う際に、用意する必要があるファイルは以下のとおりです。

表4.10 ファームウェアアップデートに必要なファイル

アップデート対象	種別	ファイル名
kernel・dtb	Linux カーネル	uImage
	Linux カーネルチェックサム	uImage.md5
	Linux カーネル DTB アーカイブ	uImage.dtb.zip
	Linux カーネル DTB アーカイブチェックサム	uImage.dtb.zip.md5
userland	Debian GNU/Linux ユーザーランドアーカイブ	*.tar.gz
userland	Debian GNU/Linux ユーザーランドアーカイブチェックサム	*.tar.gz.md5
recovery	リカバリー Linux カーネル	uImage.recovery
	リカバリー Linux カーネルチェックサム	uImage.recovery.md5
	リカバリー Linux カーネル DTB アーカイブ	uImage.recovery.dtb.zip
	リカバリー Linux カーネル DTB アーカイブチェックサム	uImage.recovery.dtb.zip.md5


	ファームウェアアップデートを行うためには、Armadillo が HTTP プロトコルでアクセス可能な Web サーバーにイメージファイルを事前に置いておく必要があります。

4.5. リカバリーイメージ

recovery 領域には、Linux カーネルとユーザーランドを一つにまとめたイメージを書き込みます。このイメージをリカバリーイメージといいます。

4.5.1. リカバリーイメージの目的

リカバリーイメージの目的は、次のような人為的ミスによって正常に起動できなくなった Armadillo をnode-eyeコントロールパネルからの復旧をできるようにすることです。

ファームウェアアップデート機能を使ってLinux カーネルまたはユーザーランドに誤ったイメージを書き込んでしまった
ファームウェアアップデート機能を使ったイメージ書き込みの最中に、電源が遮断されて書き込みが完了せず再起動に失敗した

4.5.2. リカバリーイメージの起動条件

リカバリーイメージを使って Armadillo の起動する条件を次に示します。

ファームウェアアップデートが正常に完了していない状態で、Armadilloが再起動した
ファームウェアアップデートは完了したが、更新したイメージで起動できなかった

4.5.3. リカバリーイメージの特徴

4.5.3.1. インストールされているアプリケーション

リカバリーイメージは、Linux カーネルとユーザーランドを復旧するためにSACMに接続することのできる最小の構成となっています。そのため、インストールされているアプリケーションは標準イメージと比べ少なくなっています。

4.5.3.2. リカバリーイメージ起動中のWebUI上の表示

リカバリーイメージで Armadillo が起動すると、SACM コントロールパネル、node-eye コントロールパネル上では [切断中] と表示されます。ただし、Armadillo がリカバリーイメージで起動し、SACM と通信できる場合は、SACM コントロールパネル, node-eye コントロールパネルから Ping と Traceroute を実行することができます。

4.5.3.3. RAM disk に展開されるユーザーランド

リカバリーイメージが起動すると、ユーザーランドはRAM disk上に展開されます。そのため、ルートファイルシステムへ書き込みを行っても変更は保存されません。また、eMMC 第2パーティションに保存されているユーザーランドがRAM上に展開されるのではなく、リカバリーイメージに含まれるユーザーランドがRAM上に展開されます。

4.5.3.4. リカバリーイメージが使用するline.conf

リカバリーイメージは eMMC 第3パーティションに保存された /etc/armsd/line.conf を使用します。eMMC 第2パーティションの /etc/armsd/line.conf は使用されません。

4.5.4. リカバリーイメージのビルド方法

リカバリーイメージをビルドする方法を示します。リカバリーイメージのビルドは ATDE 上で行います。


	eMMC 第2パーティションに書き込む GNU/Linux Debianアーカイブの構築方法は、製品マニュアルを参照してください。

手順4.1 リカバリーイメージのビルド

x1-node-eye-recovery-builder の準備
はじめに、x1-node-eye-recovery-builder を使用するための準備を行います。下記のコマンドを実行する前に、最新の x1-node-eye-recovery-builder を Armadillo サイトからダウンロードしておいてください。
```
[PC ~]$ sudo apt-get update && sudo apt-get install qemu-user-static
[PC ~]$ tar xf x1-node-eye-recovery-builder-[version].tar.gz
```
リカバリーイメージ用の initramfs アーカイブ作成
x1-node-eye-recovery-builder を使ってリカバリーイメージ用の initramfs アーカイブを作成します。build-recovery-initramfs.sh を実行してから initramfs アーカイブが完成するまでに40分程度かかります。これは x1-node-eye-recovery-builder がパッケージをインターネット上から取得するためです。回線速度によって完成までにかかる時間は前後します。
```
[PC ~]$ cd x1-node-eye-recovery-builder-[version]
[PC ~/x1-node-eye-recovery-builder-[version]]$ sudo ./build-recovery-initramfs.sh
```

Linux カーネルのソースコードの準備

Armadillo サイトから Linux カーネルのソースコードアーカイブをダウンロードした後、アーカイブの展開をします。

[PC ~]$ ls
linux-3.14.38-at[version].tar.gz  x1-node-eye-recovery-builder-[version]
[PC ~]$ tar xf linux-3.14.38-at[version].tar.gz
[PC ~]$ ls
linux-3.14.38-at[version]         x1-node-eye-recovery-builder-[version]
linux-3.14.38-at[version].tar.gz

initramfsアーカイブへのシンボリックリンクを作成
Linuxカーネルディレクトリに移動して、initramfsアーカイブへのシンボリックリンクを作成します。
```
[PC ~]$ cd linux-3.14.38-at[version]
[PC ~/linux-3.14.38-at[version]]$ ln -s ../x1-node-eye-recovery-builder-[version]/initramfs_x1_node-eye_recovery_[YYYYMMDD].cpio.gz initramfs_x1.cpio.gz
```

ビルド

ビルドするには、次のようにコマンドを実行します。

[PC ~/linux-3.14.38-at[version]]$ make ARCH=arm x1_defconfig
[PC ~/linux-3.14.38-at[version]]$ make CROSS_COMPILE=arm-linux-gnueabihf- ARCH=arm
[PC ~/linux-3.14.38-at[version]]$ make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- LOADADDR=0x80008000 uImage

イメージファイルの生成確認
ビルドが終了すると、arch/arm/boot/ディレクトリと、arch/arm/boot/dts/以下にイメージファイル(LinuxカーネルとDTB)が作成されています。
```
[PC ~/linux-3.14.38-at[version]]$ ls arch/arm/boot/uImage
uImage
[PC ~/linux-3.14.38-at[version]]$ ls arch/arm/boot/dts/armadillo_iotg_g3.dtb
armadillo_iotg_g3.dtb
```

4.5.5. リカバリーイメージの書き込み方法

「リカバリーイメージのビルド方法」で作成したイメージファイルを、Armadilloに書き込む方法について説明します。「ファームウェアアップデートを行う」で説明した方法と同様に、ATDEで必要なファイルの名前変更とZIP圧縮を行った後に所定の位置へ設置します。

[PC ~]$ ls
armadillo_iotg_g3.dtb  uImage
[PC ~]$ mv uimage uImage.recovery
[PC ~]$ mv armadillo_iotg_g3.dtb armadillo_iotg_g3.dtb.recovery
[PC ~]$ zip uImage.recovery.dtb.zip armadillo_iotg_g3.dtb.recovery
[PC ~]$ ls
armadillo_iotg_g3.dtb.recovery  uImage.recovery  uImage.recovery.dtb.zip
[PC ~]$ md5sum uImage.recovery > uImage.recovery.md5
[PC ~]$ md5sum uImage.recovery.dtb.zip > uImage.recovery.dtb.zip.md5
[PC ~]$ ls
armadillo_iotg_g3.dtb.recovery  uImage.recovery  uImage.recovery.dtb.zip  uImage.recovery.dtb.zip.md5  uImage.recovery.md5
[PC ~]$ sudo cp uImage.recovery* /var/www/html


	AGX314X(Armadillo-IoTゲートウェイ G3 M1)をご利用の場合は、上記例の「armadillo_iotg_g3.dtb」を「armadillo_iotg_g3_m1.dtb」に置き換えて実施してください。

次に、「ファームウェアアップデートを行う」で説明した方法と同様に、接続中デバイスから[ファームウェアアップデート]項目に移動します。その後、下記のようにフォームへ入力してください([ATDEのIPアドレス]はご利用の環境にあわせて変更してください)。

表4.11 リカバリーイメージアップデート

フォーム	入力内容
プライマリ/リカバリ	リカバリ
リカバリ	http://`[ATDEのIPアドレス]`/uImage.recovery
アップデート完了時に再起動する

[実行]をクリックし、リカバリーイメージのアップデートを行ってください。

図4.2 リカバリーイメージアップデート実行 (node-eye コントロールパネル)


第3章 node-eye を体験する	PDF version	第5章 Howto