Armadillo 開発者サイト

Armadillo-IoT は、複数の種類のネットワークに接続することができます。接続可能なネットワークとLinuxから使用するネットワークデバイスの対応を次に示します。

ネットワーク設定は、/etc/config/interfacesに記述されています。デフォルト状態では、次のように設定されています。

# /etc/network/interfaces -- configuration file for ifup(8), ifdown(8)

auto lo eth0
iface lo inet loopback
iface eth0 inet dhcp
iface umts0 inet dhcp
	pre-up 3g-connect
	post-down 3g-disconnect

ここでは有線LANの使用方法について説明します。

[armadillo ~]# ifup eth0

[armadillo ~]# ifdown eth0

6.2.3.2. 有線LANのネットワーク設定を変更する

有線LANのネットワーク設定を変更する方法について説明します。

	ネットワーク接続に関する不明な点については、ネットワークの管理者へ相談してください。

Armadillo-IoT上の「/etc/config」以下にあるファイルを編集し、コンフィグ領域に保存することにより起動時のネットワーク設定を変更することができます。コンフィグ領域の保存については、7章コンフィグ領域 − 設定ファイルの保存領域を参照してください。

	設定を変更する場合は、かならずネットワークを無効化してから行ってください。変更してからネットワークを無効化しても、「新しい設定」を無効化することになります。「古い設定」が無効化されるわけではありません。

6.2.3.2.1. 有線LANを固定IPアドレスに設定する

表6.3「有線LAN固定IPアドレス設定例」の内容に設定する例を、図6.4「有線LANの固定IPアドレス設定」に示します。

表6.3 有線LAN固定IPアドレス設定例

項目	設定
IPアドレス	192.0.2.10
ネットマスク	255.255.255.0
ネットワークアドレス	192.0.2.0
ブロードキャストアドレス	192.0.2.255
デフォルトゲートウェイ	192.0.2.1

[armadillo ~]# vi /etc/config/interfaces
# /etc/network/interfaces -- configuration file for ifup(8), ifdown(8)

auto lo eth0
iface lo inet loopback
iface eth0 inet static
address 192.0.2.10
netmask 255.255.255.0
network 192.0.2.0
broadcast 192.0.2.255
gateway 192.0.2.1
iface umts0 inet dhcp
	pre-up 3g-connect
	post-down 3g-disconnect

図6.4 有線LANの固定IPアドレス設定

6.2.3.2.2. 有線LANをDHCPに設定する

DHCPに設定する例を、図6.5「DHCP設定」に示します。

DHCPに設定するには、viエディタで/etc/config/interfacesを、次のように編集します。

[armadillo ~]# vi /etc/config/interfaces
# /etc/network/interfaces -- configuration file for ifup(8), ifdown(8)

auto lo eth0
iface lo inet loopback
iface eth0 inet dhcp
iface umts0 inet dhcp
	pre-up 3g-connect
	post-down 3g-disconnect

図6.5 DHCP設定

6.2.3.3. 有線LANの接続を確認する

有線LANで正常に通信が可能か確認します。設定を変更した場合、かならず変更したインターフェースを再度有効化してください。

同じネットワーク内にある通信機器とPING通信を行います。以下の例では、通信機器が「192.0.2.20」というIPアドレスを持っていると想定しています。

[armadillo ~]# ping 192.0.2.20

図6.6 有線LANのPING確認

	awlan0 または umts0 を使用してネットワークに接続している場合、ネットワーク通信に eth0 が使用されない場合があります。確実に eth0 を使用させる場合は、事前に eth0 以外のネットワークインターフェースを無効化してください。

ここでは、Armadillo-IoT に搭載されている無線LANモジュール「Armadillo-WLANモジュール(AWL13)」の使用方法について説明します。

6.2.4.1. WLAN インターフェースの有効化

Armadillo-WLANモジュール(AWL13)が接続されている WLAN インターフェース(ベースボード:CON5)と SD インターフェース(ベースボード:CON4)は、共通の信号が接続されています。工場出荷状態のソフトウェアでは、デフォルトで SD インターフェースが有効化されているため、無線LANモジュールを利用することができません。

WLAN インターフェースを有効化するためには、図6.7「無線LANモジュールの有効化」のようにコマンドを実行します。事前に SD インターフェース(ベースボード:CON4)から SD カードを取り外しておく必要があります。

[armadillo ~]# sd-awlan-sel awlan
select to AWLAN
mmc1: queuing unknown CIS tuple 0x10 (5 bytes)
mmc1: queuing unknown CIS tuple 0x10 (5 bytes)
mmc1: new high speed SDIO card at address 02bd
awl13: RX Transmission mode SDINT HT
mmc1: registerd "awl13" device as awlan0
awl13: WID=0x5, STATUS CODE=0x0
awl13: disconnected!
awl13: device ready!
awl13: MAC is 00:1d:12:cf:28:ae
awl13: WID=0x5, STATUS CODE=0x1
awl13: WID=0x5, STATUS CODE=0x1

図6.7 無線LANモジュールの有効化

WLAN インターフェースを有効化すると、Armadillo-WLANモジュール(AWL13)のLinuxカーネルモジュールおよびファームウェアのロードが自動的に行われます。

	Armadillo-WLANモジュール(AWL13)のファームウェアは、"STA"(ステーションおよびアドホックモード用)と"AP"(アクセスポイントモード用)の2種類が用意されています。工場出荷状態のソフトウェアでは、"STA"が自動的にロードされるよう設定されています。 "AP"を自動的にロードするように設定するには図6.7「無線LANモジュールの有効化」を実行する前に、次のように設定ファイル/etc/config/awl13.confを編集します。 [armadillo ~]# vi /etc/config/awl13.conf #AWL13_MODE=STA AWL13_MODE=AP 設定ファイルをコンフィグ領域に保存する方法については、7章コンフィグ領域 − 設定ファイルの保存領域を参照してください。

[armadillo ~]# iwconfig awlan0 essid [essid]
[armadillo ~]# iwpriv awlan0 set_psk [passphrase]
[armadillo ~]# iwpriv awlan0 set_cryptmode WPA2-AES
[armadillo ~]# iwconfig awlan0 mode managed

[armadillo ~]# ifconfig awlan0 192.0.2.1 up

6.2.4.3. 自動で無線LANインターフェースを有効化する

Armadilloの起動時に、自動的に無線LANインターフェースの有効化を行う方法について説明します。無線LANの設定をコンフィグ領域に保存することにより、Armadilloを再起動するたびに設定を行う必要が無くなります。

Armadilloの起動時に、自動的に WLAN インターフェースを有効化するために/etc/config/rc.localに「sd-awlan-sel awlan」を追加します。

[armadillo ~]# vi /etc/config/rc.local
        echo -n "Starting vinmonitor: "
        /etc/config/vinmonitor &
        check_status
fi

sd-awlan-sel awlan  

WLAN インターフェースを有効化します

WPA2-PSK(AES)のアクセスポイントに接続する場合の/etc/config/interfacesの編集例を次に示します。

[armadillo ~]# vi /etc/config/interfaces
# /etc/network/interfaces -- configuration file for ifup(8), ifdown(8)

auto lo eth0
iface lo inet loopback
iface eth0 inet dhcp
iface umts0 inet dhcp
	pre-up 3g-connect
	post-down 3g-disconnect
iface awlan0 inet dhcp  
      pre-up iwpriv awlan0 set_psk [passphrase]  
      pre-up iwpriv awlan0 set_cryptmode WPA2-AES  
      pre-up iwconfig awlan0 essid [essid]  
      wireless-mode managed  

	awlan0をDHCPに設定します
	パスフレーズを[passphrase]に設定します
	暗号化方式をWPA2-PSK(AES)に設定します
	ESSIDを[essid]に設定します
	接続モードをインフラストラクチャモード(STA)に設定します

Armadilloの起動時に自動的にawlan0が有効化されるようにするには、/etc/config/awl13-firmware-load.shの最後の行に「ifup awlan0」を追加します。

[armadillo ~]# vi /etc/config/awl13-firmware-load.sh
[ -f /sys/module/awl13_usb/$WLAN/firmware ] && \
cat $FIRMWARE_USB > /sys/module/awl13_usb/$WLAN/firmware
iwpriv $WLAN fwload
iwpriv $WLAN fwsetup

ifup awlan0  

/etc/config/interfacesの設定でawlan0を有効化します

追加後、次回起動時に設定が反映されるようにコンフィグ領域を保存します。

[armadillo ~]# flatfsd -s

Armadilloを再起動すると、自動的に無線LANインターフェースが有効化されます。

	Armadilloの再起動の前に、SD インターフェース(ベースボード:CON4)から SD カードを取り外しておく必要があります。

6.2.4.4. 無線LANの接続を確認する

無線LANで正常に通信が可能か確認します。

同じネットワーク内にある通信機器とPING通信を行います。以下の例では、通信機器が「192.0.2.20」というIPアドレスを持っていると想定しています。

[armadillo ~]# ping 192.0.2.20

図6.9 無線LANのPING確認

	eth0 または umts0 を使用してネットワークに接続している場合、ネットワーク通信に awlan0 が使用されない場合があります。確実に awlan0 を使用させる場合は、事前に awlan0 以外のネットワークインターフェースを無効化してください。

ここでは、Armadillo-IoT に搭載されている 3Gモジュール「Sierra Wireless製 HL8548」の使用方法について説明します。

3Gモジュール「Sierra Wireless製 HL8548」はドコモ相互接続性試験を完了しています。 しかし、2015年8月以前に出荷したArmadillo-IoTは、ドコモ相互接続性試験 未完了のファームウェアが書き込まれています。 ファームウェアをアップデートすることでドコモ相互接続性試験完了版となります。 表6.4 ドコモ相互接続性試験 完了状況 未完了ファームウェアバージョン 完了ファームウェアバージョン RHL85xx.5.5.14.0.201502091756.x6250_1 RHL85xx.5.5.16.0.201505261641.x6250_2 以降 ドコモ相互接続性試験 未完了のファームウェアでドコモのネットワークを使用し、接続トラブルが発生した場合、技術サポートが得られないなどの制約があるため、アップデートを行うことを強く推奨いたします。 ファームウェアバージョンの確認方法は「3Gモジュールのファームウェアバージョンを確認する」を参照してください。 ファームウェアのアップデート方法は「3Gモジュールのファームウェアをアップデートする」を参照してください。

6.2.5.1. 3G データ通信設定を行う前に

3Gデータ通信を利用するには、通信事業者との契約が必要です。契約時に通信事業者から貸与されたmicroSIM(UIMカード)とAPN情報を準備します。

	Armadillo-IoTの電源が切断されていることを確認してからmicroSIM(UIMカード)を取り付けてください。

	本製品は、microSIMスロットを搭載しています。 SIM変換アダプタを利用したnanoSIM、標準サイズのSIMカードをmicroSIMサイズにカットしたもの、サイズの異なるものを使用すると、microSIMスロットが故障する原因となります。 これらを使用し本製品が故障した場合は、保証期間内であっても保証適用外となります。

microSIM(UIMカード)は、次のようにArmadillo-IoTに取り付けます。

図6.10 microSIMの取り付け

APNの設定を行うには、次に示す情報が必要です。

• APN

• ユーザー名

• パスワード

• 認証方式(PAP または CHAP)

• PDP Type(IPのみをサポート)

6.2.5.3. APN設定方法

3GモジュールにAPN情報を設定します。APN設定には3g-set-apコマンドを利用します。3g-set-apコマンドのヘルプは次の通りです。

[armadillo ~]# 3g-set-ap
usage: /usr/bin/3g-set-ap [apn] [user] [passwd] [auth_type] [pdp_type]
   apn       ... access point name
   user      ... user name
   passwd    ... pass word
   auth_type ... NON/PAP/CHAP(default)
   pdp_type  ... IP(default)/PPP

図6.11 3g-set-apコマンドのヘルプ

表6.5「APN情報設定例」の内容に設定する例を、図6.12「APN設定例」に示します。

表6.5 APN情報設定例

項目	設定
APN	[apn]
ユーザー名	[user]
パスワード	[password]
認証方式	PAP
PDP Type	IP

[armadillo ~]# 3g-set-ap [apn] [user] [password] PAP IP

図6.12 APN設定例

3g-set-apは本来、3Gモジュール「Sierra Wireless製 HL8548」内の不揮発性メモリに対して永続的にAPN情報を保存します。 しかし、3Gモジュールのファームウェアの不具合により、保存することができません。 このため、Armadillo-IoTの電源を切断した場合、3Gモジュールに設定したAPN情報が消えてしまいます。 暫定対策として、コンフィグ領域を利用し、Armadillo-IoT内蔵のフラッシュメモリにAPN情報を保存します。 vi エディタで/etc/config/interfacesを次のように編集します。 [armadillo ~]# vi /etc/config/interfaces # /etc/network/interfaces -- configuration file for ifup(8), ifdown(8) auto lo eth0 iface lo inet loopback iface eth0 inet dhcp iface umts0 inet dhcp pre-up 3g-set-ap [apn] [user] [password] [auth_type] [pdp_type] pre-up 3g-connect post-down 3g-disconnect pre-upで3g-set-apを実行し、3Gインターフェース有効化時にAPN情報を設定します。 編集後、次回起動時に設定が反映されるようにコンフィグ領域を保存します。 [armadillo ~]# flatfsd -s コンフィグ領域については、7章コンフィグ領域 − 設定ファイルの保存領域を参照してください。

6.2.5.4. 3Gインターフェースの有効化、無効化

無効化されている3Gインターフェースを有効化するには、次のようにコマンドを実行します。

[armadillo ~]# ifup umts0

図6.13 ネットワークインターフェース(umts0)の有効化

有効化されている3Gインターフェースを無効化するには、次のようにコマンドを実行します。

[armadillo ~]# ifdown umts0

図6.14 ネットワークインターフェース(umts0)の無効化

	APN情報が適切に設定されていない場合、3Gインターフェースを有効化することができません。 [armadillo ~]# ifup umts0 3G connect error 上記のように"error"と表示された場合は、APNの設定を確認してください。

6.2.5.5. 自動で3Gインターフェースを有効化する

Armadilloの起動時に、自動的に3Gインターフェースの有効化を行う方法について説明します。

/etc/config/interfacesを、次のように編集します。

[armadillo ~]# vi /etc/config/interfaces
# /etc/network/interfaces -- configuration file for ifup(8), ifdown(8)

auto lo eth0 umts0 
iface lo inet loopback
iface eth0 inet dhcp
iface umts0 inet dhcp
        pre-up 3g-connect
        post-down 3g-disconnect

auto 節に umts0 を追加します。

追加後、次回起動時に設定が反映されるようにコンフィグ領域を保存します。

[armadillo ~]# flatfsd -s

Armadilloを再起動すると、自動的に3Gインターフェースが有効化されます。

v20160527以降のユーザーランドでは、3Gインタフェース切断を検知して3Gインタフェースの再起動を行うスクリプト(3g-recover)が標準設定で起動します。 従来の3g-monitorは使用していませんので、v20160527より古いユーザーランドを使用されていてコンフィグ領域の設定が古い場合は、 コンフィグ領域の更新と、3G通信確認のためのping先IPアドレス設定を下記の手順で行ってください。 [armadillo ~]# flatfsd -w [armadillo ~]# echo 'PING_DEST_IP=[ping_dest_ip_addr]' > /etc/config/3g-recover.conf [armadillo ~]# flatfsd -s 3g-recoverは3G切断をpingで確認します。ping先のIPアドレスを指定してください。 併せて、「APN設定方法」を参照し、/etc/config/interfacesに3g-set-ap設定を追加してください。

6.2.5.6. 3Gの接続を確認する

3Gで正常に通信が可能か確認します。

アットマークテクノのWebサーバーとPING通信を行います。VPN接続を利用するなどインターネットに接続できない場合は、ネットワーク内の通信機器に読み替えてください。

[armadillo ~]# ping www.atmark-techno.com

図6.15 3GのPING確認

	eth0 または awlan0 を使用してネットワークに接続している場合、ネットワーク通信に umts0 が使用されない場合があります。確実に umts0 を使用させる場合は、事前に umts0 以外のネットワークインターフェースを無効化してください。

6.2.5.7. microSIMから電話番号を取得する

microSIM(UIMカード)から電話番号を取得するには、次のようにコマンドを実行します。

[armadillo ~]# 3g-phone-num
[number] 

11桁の電話番号が表示されます。

図6.16 microSIMからの電話番号取得

	microSIMが適切に接続されていない場合、電話番号を取得することができません。 [armadillo ~]# 3g-phone-num error 上記のように"error"と表示された場合は、図6.10「microSIMの取り付け」を参照してmicroSIMの接続を確認してください。

[armadillo ~]# 3g-temp
30 

6.2.5.11. 3Gモジュールのファームウェアをアップデートする

3G モジュール「Sierra Wireless 製 HL8548」のファームウェアは、デバッグシリアルインターフェース(ベースボード:CON9)に接続したWindows PCからアップデートが可能です。

6.2.5.11.1. Windows PCからアップデート行う

Windowsのファームウェア書き込みツールを使用してアップデートする方法を次に示します。

	Windows PCから、USB シリアル変換アダプタ経由でファームウェアの書き込みを行います。USB シリアル変換アダプタのドライバはWindowsで提供されているものを利用するか、FTDI社のWebサイトよりダウンロードしてください。 FTDI - Drivers http://www.ftdichip.com/FTDrivers.htm

手順6.3 Windowsのファームウェア書き込みツール使用方法

1. ファームウェア書き込みツールのダウンロード

   「アットマークテクノ ユーザーズサイト」からWindows PCにファームウェア書き込みツールをダウンロードします。ダウンロードを行うにはユーザー登録をする必要があります。

   アットマークテクノ ユーザーズサイト Armadillo-IoT HL8548 ファームウェア書き込みツール

   https://users.atmark-techno.com/armadillo-iot/hl8548-firmware/download

   zip形式で圧縮されているので解凍ソフトを使用して解凍してください。フォルダ「RHL85xx.5.x.xx_WIN」内に次に示すファイルが解凍されます。

   表6.6 書き込みツールファイル一覧

   ファイル名
   AENEAS_FW.fls
   DownloadTool.dll
   DownloadTool.exe
   entry.bat
   psi.fls
   read_ini.bat
   SAM_6260-CDS.fls
   SAM_6260-MSY.fls
   SAM_6260.fls
   slb.fls
   start-update.bat
   tee.exe

   
   

2. Windows PCとArmadillo-IoTの接続

   USB シリアル変換アダプタ で Windows PCとArmadillo-IoTを接続し、Armadillo-IoTの電源を入れます。

   Tera Term等のシリアル通信ソフトでArmadillo-IoTにログインしてください。

3. 書き込みの準備

   次のコマンドを実行し、3Gモジュールの電源をOFFします。

   [armadillo ~]$ echo 1 > /sys/class/gpio/RESET_N_3G/value

   3Gモジュールの電源がOFFされると、次のように表示されます。

   cdc_ether 2-1:1.6 umts0: unregister 'cdc_ether' usb-ci_hdrc.1-1, CDC Ethernet Device
   cdc_ether 2-1:1.8 umts1: unregister 'cdc_ether' usb-ci_hdrc.1-1, CDC Ethernet Device
   cdc_ether 2-1:1.10 umts2: unregister 'cdc_ether' usb-ci_hdrc.1-1, CDC Ethernet Device

   次のコマンドを実行します。このコマンドを実行する事で、ユーザースイッチ 1を押すことをトリガに3Gモジュールの電源が入ります。この時点ではユーザースイッチ 1は押さないでください。

   [armadillo ~]$ swmgr sw1 1 echo 0 > /sys/class/gpio/RESET_N_3G/value

4. Windows PCと3GモジュールのUART接続

   USB シリアル変換アダプタのスライドスイッチを次に示すように設定します。

   Armadillo-IoTのシリアルコンソールから、3GモジュールのUARTへと接続が切り替わります。

5. シリアル通信ソフトの終了

   Tera Term等のシリアル通信ソフトを終了してください。

   	シリアル経由でファームウェアイメージの転送、書き込みを行うため、シリアル通信ソフトがCOMポートを占有していると書き込みができません。

6. ファームウェア書き込みツールの起動

   フォルダ「RHL85xx.5.x.xx_WIN」内に展開されたファイルstart-update.batをダブクリックします。

   次に示すDOSコマンドプロンプトが表示されます。

7. COMポート番号の入力

   「Please enter the serial port number >」と表示されるので、USB シリアル変換アダプタのCOMポート番号を入力します。

   COM147の場合は、147と入力し、Enterキーを押します。

   Enterキーを押すと「 Please reboot your phone device 」と表示されます。

8. 書き込みの実行

   Armadillo-IoTのユーザースイッチ 1を押すとファームウェア書き込みが開始されます。ユーザースイッチ 1の位置は「Armadillo-IoTゲートウェイG2の外観」を参照してください。

   ファームウェア書き込みが開始されると次に示すように表示されます。

   	ファームウェア書き込み中はArmadillo-IoTの電源を切らないでください。3Gモジュールが故障する可能性があります。

   	「 Please reboot your phone device 」と表示されてから、1分以内にユーザースイッチ 1を押してください。 1分以上経過すると、ツールがタイムタイムアウトし、次のように表示されます。 タイムアウト後、ファームウェア書き込みを再度実行するには、「続行するには何かキーを押してください . . .」と表示された後Enterキーを押しツールを終了させ、再度start-update.batをダブルクリックしてください。

   次のように表示されればファームウェア書き込みは完了です。完了後5秒するとDOSコマンドプロンプトが自動的に閉じます。

   ファームウェア書き込み完了後、3Gモジュールは自動的に再起動します。

9. Armadillo-IoTのシリアルコンソールへ接続

   USB シリアル変換アダプタのスライドスイッチを次に示すように設定します。

   3GモジュールのUARTからArmadillo-IoTのシリアルコンソールに接続が切り替わります。

10. ファームウェアバージョンの確認

    ファームウェアバージョンが変更されているか確認します。ファームウェアバージョンの確認方法は「3Gモジュールのファームウェアバージョンを確認する」を参照してください。

DNSサーバーを指定する場合は、viエディタで/etc/config/resolv.confを編集します。

[armadillo ~]# vi /etc/config/resolv.conf
nameserver 192.0.2.1

	DHCPを利用している場合には、DHCPサーバーがDNSサーバーを通知する場合があります。この場合、/etc/config/resolv.confは自動的に更新されます。

Armadilloでは、簡易ファイアーウォールが動作しています。設定されている内容を参照するには、図6.19「iptables」のようにコマンドを実行してください。

[armadillo ~]# iptables --list

工場出荷イメージで利用することができるネットワークアプリケーションについて説明します。

	ATDEとArmadilloのネットワーク設定がデフォルト状態であることを想定して記述しています。ネットワーク設定を変更している場合は適宜読み換えてください。

[ATDE ~]$ telnet 192.0.2.10  
Trying 192.0.2.10...
Connected to 192.0.2.10.
Escape character is '^]'.

atmark-dist v1.41.0 (AtmarkTechno/Armadillo-IoTG-Std)
Linux 3.14-at1 [armv5tejl arch]

armadillo-iotg login: guest 
[guest@armadillo ~]$
[guest@armadillo ~]$ su 
Password:  
[root@armadillo ~]#
[root@armadillo ~]# exit 
[guest@armadillo ~]$ exit 
Connection closed by foreign host.
[ATDE ~]$ 

[ATDE ~]$ ls -l file
-rw-r--r-- 1 atmark atmark 1048576 Jan 1 12:00 file
[ATDE ~]$ ftp 192.0.2.10  
Connected to 192.0.2.10.
220 armadillo-iotg FTP server (GNU inetutils 1.4.1) ready.
Name (192.0.2.10:atmark): ftp
331 Guest login ok, type your name as password.
Password: 
230 Guest login ok, access restrictions apply.
Remote system type is UNIX.
Using binary mode to transfer files.
ftp> cd pub 
250 CWD command successful.
ftp> put file 
local: file remote: file
200 PORT command sucessful.
150 Opening BINARY mode data connection for 'file'.
226 Transfer complete.
1048576 bytes sent in 0.14 secs (7399.5 kB/s)
ftp> quit 
221 Goodbye.
[ATDE ~]$ 

[armadillo ~]# cd /home/ftp/pub/
[armadillo /home/ftp/pub]# ls
file

6.2.8.3. HTTPサーバー

Armadilloでは、HTTPサーバーが動作しています。ATDEなどのPCのWebブラウザからArmadilloのURL (http://[ArmadilloのIPアドレス]/ ^[11] または、http://armadillo-iotg.local/)にアクセスすると、Armadilloのトップページ(index.html)が表示されます。

図6.23 Armadilloトップページ

ここでは、ベースボードにSDHCカードを接続した場合を例にストレージの使用方法を説明します。以降の説明では、共通の操作が可能な場合に、SD/SDHC/SDXCカードをSDカードと表記します。

	SD インターフェース(ベースボード:CON4)と WLAN インターフェース(ベースボード:CON5)は、共通の信号が接続されています。工場出荷状態のソフトウェアでは、デフォルトで SD インターフェースが有効化されています。 「WLAN インターフェースの有効化」の手順を実行してWLAN インターフェースが有効化されている場合は、次のように SD インターフェースを有効化してください。 [armadillo ~]# sd-awlan-sel sd select to SD

	SDXC/microSDXCカードを使用する場合は、事前に「ストレージのパーティション変更とフォーマット」を参照してフォーマットを行う必要があります。これは、LinuxカーネルがexFATファイルシステムを扱うことができないためです。通常、購入したばかりのSDXC/microSDXCカードはexFATファイルシステムでフォーマットされています。

Linuxでは、アクセス可能なファイルやディレクトリは、一つの木構造にまとめられています。あるストレージデバイスのファイルシステムを、この木構造に追加することを、マウントするといいます。マウントを行うコマンドは、mountです。

mountコマンドの典型的なフォーマットは、次の通りです。

mount -t [fstype] device dir

-t オプションに続くfstypeには、ファイルシステムタイプを指定します^[12]。FAT32ファイルシステムの場合はvfat^[13]、EXT3ファイルシステムの場合はext3を指定します。

deviceには、ストレージデバイスのデバイスファイル名を指定します。SDカードのパーティション1の場合は/dev/mmcblk0p1、パーティション2の場合は/dev/mmcblk0p2となります。

dirには、ストレージデバイスのファイルシステムをマウントするディレクトリを指定します。

SDスロットにSDHCカードを挿入した状態で図6.25「ストレージのマウント」に示すコマンドを実行すると、/mntディレクトリにSDHCカードのファイルシステムをマウントします。SDカード内のファイルは、/mntディレクトリ以下に見えるようになります。

[armadillo ~]# mount -t vfat /dev/mmcblk0p1 /mnt

	FAT32ファイルシステムをマウントした場合、次の警告メッセージが表示される場合があります。 FAT-fs (mmcblk0p1): utf8 is not a recommended IO charset for FAT filesystems, filesystem will be case sensitive! これは無視して構いません。 UTF-8 ロケールでは結局はファイル名の表示を正しく処理できないためです。

ストレージを安全に取り外すには、アンマウントする必要があります。アンマウントを行うコマンドは、umountです。オプションとして、アンマウントしたいデバイスがマウントされているディレクトリを指定します。

[armadillo ~]# umount /mnt

通常、購入したばかりのSDHCカードやUSBメモリは、一つのパーティションを持ち、FAT32ファイルシステムでフォーマットされています。

パーティション構成を変更したい場合、fdiskコマンドを使用します。fdiskコマンドの使用例として、一つのパーティションで構成されているSDカードのパーティションを、2つに分割する例を図6.27「fdiskコマンドによるパーティション変更」に示します。一度、既存のパーティションを削除してから、新たにプライマリパーティションを二つ作成しています。先頭のパーティションには100MByte、二つめのパーティションに残りの容量を割り当てています。先頭のパーティションは/dev/mmcblk0p1、二つめは/dev/mmcblk0p2となります。fdiskコマンドの詳細な使い方は、manページ等を参照してください。

[armadillo ~]# fdisk /dev/mmcblk0

The number of cylinders for this disk is set to 62528.
There is nothing wrong with that, but this is larger than 1024,
and could in certain setups cause problems with:
1) software that runs at boot time (e.g., old versions of LILO)
2) booting and partitioning software from other OSs
   (e.g., DOS FDISK, OS/2 FDISK)

Command (m for help): d
Selected partition 1

Command (m for help): n
Command action
   e   extended
   p   primary partition (1-4)
p
Partition number (1-4): 1
First cylinder (1-62528, default 1):
Using default value 1
Last cylinder or +size or +sizeM or +sizeK (1-62528, default 62528): +100M

Command (m for help): n
Command action
   e   extended
   p   primary partition (1-4)
p
Partition number (1-4): 2
First cylinder (3054-62528, default 3054):
Using default value 3054
Last cylinder or +size or +sizeM or +sizeK (3054-62528, default 62528):
Using default value 62528

Command (m for help): w
The partition table has been altered!

Calling ioctl() to re-read partition table.
 mmcblk0: p1 p2
 mmcblk0: p1 p2
Syncing disks.

FAT32ファイルシステムでストレージデバイスをフォーマットするには、mkfs.vfatコマンドを使用します。また、EXT2やEXT3ファイルシステムでフォーマットするには、mke2fsコマンドを使用します。SDカードのパーティション1をEXT3ファイルシステムでフォーマットするコマンド例を、次に示します。

[armadillo ~]# mke2fs -j /dev/mmcblk0p1

LEDクラスディレクトリ以下のbrightnessファイルへ値を書き込むことによって、LEDの点灯/消灯を行うことができます。brightnessに書き込む有効な値は0〜255です。

brightnessに0以外の値を書き込むとLEDが点灯します。

[armadillo ~]# echo 1 > /sys/class/leds/[LED]/brightness

	Armadillo-IoT のLEDには輝度制御の機能が無いため、0 (消灯)、1〜255 (点灯)の2つの状態のみ指定することができます。

brightnessに0を書き込むとLEDが消灯します。

[armadillo ~]# echo 0 > /sys/class/leds/[LED]/brightness

brightnessを読み出すとLEDの状態が取得できます。

[armadillo ~]# cat /sys/class/leds/[LED]/brightness
0

LEDクラスディレクトリ以下のtriggerファイルへ値を書き込むことによってLEDの点灯/消灯にトリガを設定することができます。triggerに書き込む有効な値を次に示します。

以下のコマンドを実行すると、LEDが2秒点灯、1秒消灯を繰り返します。

[armadillo ~]# echo timer > /sys/class/leds/[LED]/trigger
[armadillo ~]# echo 2000 > /sys/class/leds/[LED]/delay_on
[armadillo ~]# echo 1000 > /sys/class/leds/[LED]/delay_off

triggerを読み出すとLEDのトリガが取得できます。"[ ]"が付いているものが現在のトリガです。

[armadillo ~]# cat /sys/class/leds/[LED]/trigger
none mmc0 mmc1 [timer] heartbeat default-on

Linuxの時刻には、Linuxカーネルが管理するシステムクロックと、RTCが管理するハードウェアクロックの2種類があります。RTCに時刻を設定するためには、まずシステムクロックを設定します。その後に、ハードウェアクロックをシステムクロックと一致させる手順となります。

システムクロックは、dateコマンドを用いて設定します。dateコマンドの引数には、設定する時刻を[MMDDhhmmCCYY.ss]というフォーマットで指定します。時刻フォーマットの各フィールドの意味を次に示します。

2015年6月2日12時34分56秒に設定する例を次に示します。

[armadillo ~]# date 
Sat Jan  1 09:00:00 JST 2000
[armadillo ~]# date 060212342015.56 
Tue Jun  2 12:34:56 JST 2015 
[armadillo ~]# date 
Tue Jun  2 12:34:57 JST 2015

	Armadillo-IoTが接続しているネットワーク内にタイムサーバーがある場合は、NTP(Network Time Protocol)クライアントを利用してシステムクロックを設定することができます。 [armadillo ~]# ntpclient -h [NTP SERVER] -s 42155 30535.977 24736.0 0.8 14862.8 0.0 0 [armadillo ~]# date Tue Jun 2 12:34:57 JST 2015

システムクロックを設定後、ハードウェアクロックをhwclockコマンドを用いて設定します。

[armadillo ~]# hwclock 
Sat Jan  1 00:00:00 2000  0.000000 seconds
[armadillo ~]# hwclock --utc --systohc 
[armadillo ~]# hwclock --utc 
Tue Jun  2 12:35:08 2015  -0.897934 seconds

ユーザースイッチのボタンプッシュ/リリースイベントを確認するために、ここではevtestコマンドを利用します。evtestを停止するには、Ctrl+c を入力してください。

[armadillo ~]# evtest /dev/input/event1
Input driver version is 1.0.0
Input device ID: bus 0x19 vendor 0x1 product 0x1 version 0x100
Input device name: "gpio-keys-polled"
Supported events:
  Event type 0 (Sync)
  Event type 1 (Key)
    Event code 3 (2)
    Event code 4 (3)
Testing ... (interrupt to exit)
Event: time 946704238.665631, type 1 (Key), code 3 (2), value 1
Event: time 946704238.665651, -------------- Report Sync ------------ 
Event: time 946704238.785610, type 1 (Key), code 3 (2), value 0
Event: time 946704238.785623, -------------- Report Sync ------------ 
                 :
[armadillo ~]#

/sys/class/i2c-adapter/i2c-3/3-0048/temp1_inputファイルの値を読み出すことによって、現在の基板周辺温度を取得することができます。

[armadillo ~]# cat /sys/class/i2c-adapter/i2c-3/3-0048/temp1_input
30000 

thermaltriggerコマンドを利用して、指定した温度になった場合に任意のコマンドを実行させることができます。

	thermaltriggerを複数起動することはできません。「thermalmonitor」に示すthermalmonitorコマンドも、内部的にthermaltriggerを起動しています。

thermaltriggerコマンドのヘルプは次の通りです。

[armadillo ~]# thermaltrigger
Usage: thermaltrigger -a|-b THRESHOLD COMMAND [ARGS]
Options:
  -a, --above=THRESHOLD
      Execute the program COMMAND when the detected temperature is equal
      to or above the THRESHOLD.
  -b, --below=THRESHOLD
      Execute the program COMMAND when the detected temperature is equal
      to or below the THRESHOLD.
TEMPERATURE: Range: -55000 - 125000

温度が60000ミリ°C(60°C)以上になった場合に、ベースボード:LED2を点灯させる例を次に示します。

[armadillo ~]# thermaltrigger -a 60000 echo 1 > /sys/class/leds/led2/brightness

	thermaltriggerコマンドのログは/var/log/messagesファイルに出力されます。 [armadillo ~]# cat /var/log/messages : Dec 19 12:34:59 (none) daemon.info thermaltrigger[1131]: Waiting for 60000 millidegrees Celsius or above. Dec 19 12:34:59 (none) daemon.info thermaltrigger[1131]: exceeded the threshold. executing command. 指定した温度(60000ミリ°C)以上になるまで待機します。 指定した温度に達したのでコマンドを実行します。

電源電圧は、分圧されてADコンバーターへ入力されています。電源電圧を取得するためには、まずADコンバーターへの入力電圧を取得する必要があります。

ADコンバーターは IIO(Industrial I/O) デバイスとして実装しています。/sys/bus/iio/devices/iio:device0/in_voltage_rawファイルと/sys/bus/iio/devices/iio:device0/in_voltage_scaleの値を読み出し乗算する事で、ADコンバータの入力電圧を算出する事ができます。

	IIO デバイスは、デバイスを認識した順番で iio:deviceN (N は'0'からの連番)となります。IIO デバイスは、IIOデバイス名から特定することができます。ADコンバーターの IIO デバイス名は "3-0054"です。 [armadillo ~]# cat /sys/bus/iio/devices/iio:device0/name 3-0054

[ADコンバータへの入力電圧 (mV)] = [in_voltage_raw] × [in_voltage_scale]

[armadillo ~]# cat /sys/bus/iio/devices/iio:device0/in_voltage_raw
150
[armadillo ~]# cat /sys/bus/iio/devices/iio:device0/in_voltage_scale
12.890625000

図6.42「ADコンバーターへの入力電圧を取得する」の例では、ADコンバータへの入力電圧は、約 1.933V (150 × 12.89062500 [mV])である事がわかります。

ADコンバーターへの入力電圧から、電源電圧を求める計算式を次に示します。

[電源電圧 (mV)] = [ADコンバーターへの入力電圧] × (200 ＋ 39) ÷ 39

図6.42「ADコンバーターへの入力電圧を取得する」を例にとると、ADコンバーターへの入力電圧1.933Vから、電源電圧は約11.849Vであることを求めることができます。

	awkコマンドを利用して、次のように電源電圧を表示することができます。 [armadillo ~]# adin_raw=`cat /sys/bus/iio/devices/iio:device0/in_voltage_raw` [armadillo ~]# adin_scale=`cat /sys/bus/iio/devices/iio:device0/in_voltage_scale` [armadillo ~]# echo $adin_raw $adin_scale | awk '{printf ("%d",$1*$2*(200+39)/39)}' 11849

vintriggerコマンドを利用して、電源電圧が指定した電圧になった場合に任意のコマンドを実行させることができます。

	vintriggerを複数起動することはできません。「vinmonitor」に示すvinmonitorコマンドも、内部的にvintriggerを起動しています。

vintriggerコマンドのヘルプは次の通りです。

[armadillo ~]# vintrigger
Usage: vintrigger -o|-u VOLTAGE COMMAND [ARGS]
Options:
  -o, --over=VOLTAGE
      Execute the program COMMAND when the detected voltage is equal
      to or over the VOLTAGE.
  -u, --under=VOLTAGE
      Execute the program COMMAND when the detected voltage is equal
      to or unver the VOLTAGE.
VOLTAGE: Range: 0 - 20223

電源電圧が11000mV(11V)以下になった場合に、ベースボード:LED2を点灯させる例を次に示します。

[armadillo ~]# vintrigger -u 11000 echo 1 > /sys/class/leds/led2/brightness

	vintriggerコマンドのログは/var/log/messagesファイルに出力されます。 [armadillo ~]# cat /var/log/messages : Jun 15 12:34:57 (none) daemon.info vintrigger[1173]: waiting for an under range alert (11000 mV). Jun 15 12:34:57 (none) daemon.info vintrigger[1173]: exceeded the limit. executing command. 指定した電圧(11000mV)以下になるまで待機します。 指定した電圧に達したのでコマンドを実行します。

RS232CアドオンモジュールのシリアルインターフェースからArmadillo-IoTにログインします。

アドオンインターフェース(ベースボード:CON1)に接続したRS232Cアドオンモジュールのシリアルインターフェースからログインする手順を次に示します。

ATDEのminicomにログインプロンプトが表示されます。ユーザー「guest」でログインすることができます。

	以下のように/etc/securettyにシリアルデバイスを登録すると、特権ユーザー「root」でログインすることが可能になります。 [armadillo ~]# echo ttymxc3 >> /etc/securetty デフォルト状態ではセキュリティーを考慮し、特権ユーザーでのログインを制限しています。

Armadillo-IoTに電源を投入する前に 絶縁シリアルアドオンモジュール:SW1.1をOFFに設定すると、TTYデバイスのRS485設定が自動的に有効化されます。

	Armadillo-IoTの電源投入後に 絶縁シリアルアドオンモジュール:SW1.1の設定を変更しないでください。故障の原因となる可能性があります。

変更が可能なRS485設定と、自動的に有効化された場合の初期値を表6.16「RS485設定と初期値」に示します。flagsは各ビットごとの論理和を示します。

	flagsのRTS_ON_SENDとRTS_AFTER_SENDは初期値を変更しないでください。変更した場合はデータ送信を行うことができなくなります。

	RS485が有効化されたTTYデバイスをコンソールとして利用することはできません。

RS485設定は、アプリケーションプログラムまたは、Linuxカーネル起動オプションで変更することができます。

アプリケーションプログラムの作成方法については、Linuxカーネルのソースコードに含まれているドキュメント(Documentation/serial/serial-rs485.txt)を参照してください。

Linux カーネル起動オプションでは、次のオプション指定子でRS485設定を行います。

RS485設定のフォーマットは次の通りです。

<flags>,<delay_rts_before_send>,<delay_rts_after_send>

例として、ベースボード:CON2に接続した絶縁シリアルアドオンモジュールのRS485設定を全二重通信にする場合は、保守モードで起動してから次のようにコマンドを実行してください。

hermit> setenv console=ttymxc1,115200 root=/dev/ram0 imx.rs485_uart1=0x13,0,0

絶縁シリアルアドオンモジュールのシリアルインターフェースからArmadillo-IoTにログインします。

RS422/RS485通信を行う場合は、事前に「RS422/RS485の通信設定を変更する」を参照して通信環境に合わせた設定を行ってください。

アドオンインターフェース(ベースボード:CON2)に接続した絶縁シリアルアドオンモジュールのシリアルインターフェースからログインする手順を次に示します。

ATDEのminicomにログインプロンプトが表示されます。ユーザー「guest」でログインすることができます。

	以下のように/etc/securettyにシリアルデバイスを登録すると、特権ユーザー「root」でログインすることが可能になります。 [armadillo ~]# echo ttymxc0 >> /etc/securetty デフォルト状態ではセキュリティーを考慮し、特権ユーザーでのログインを制限しています。

RN4020アドオンモジュールを制御する例として、RN4020 の設定情報の取得を行います。

アドオンインターフェース(ベースボード:CON2)に接続したRN4020アドオンモジュールに搭載されているRN4020の設定情報を取得する手順を次に示します。

その他の ASCII コマンドや、RN4020 の詳細な情報については Microchip製ドキュメントを参照してください。

EnOcean無線データを受信する例として、ROHM製スイッチモジュール PTM 210Jを使用します

アドオンインターフェース(ベースボード:CON2)に接続したEnOceanアドオンモジュールで受信する手順を次に示します。

PTM 210Jなど、EnOcean製品の情報については ROHM社 Webページを参照してください。

EnOcean Serial Protocolの詳細については EnOcean GmbH製ドキュメントを参照してください。

Wi-SUNアドオンモジュールを制御する例として、BP35A1 の設定情報の取得を行います。

アドオンインターフェース(ベースボード:CON2)に接続したWi-SUNアドオンモジュールに搭載されているBP35A1の設定情報を取得する手順を次に示します。

その他の ASCII コマンドや、BP35A1 の詳細な情報については ROHM 製ドキュメントを参照してください。

TTYデバイスのRS485設定は自動的に有効化されます。

変更が可能なRS485設定と、自動的に有効化された場合の初期値を表6.16「RS485設定と初期値」に示します。flagsは各ビットごとの論理和を示します。

	flagsのRTS_ON_SENDとRTS_AFTER_SENDは初期値を変更しないでください。変更した場合はデータ送信を行うことができなくなります。

	RS485が有効化されたTTYデバイスをコンソールとして利用することはできません。

RS485設定は、アプリケーションプログラムまたは、Linuxカーネル起動オプションで変更することができます。

アプリケーションプログラムの作成方法については、Linuxカーネルのソースコードに含まれているドキュメント(Documentation/serial/serial-rs485.txt)を参照してください。

Linux カーネル起動オプションでは、次のオプション指定子でRS485設定を行います。

RS485設定のフォーマットは次の通りです。

<flags>,<delay_rts_before_send>,<delay_rts_after_send>

例として、ベースボード:CON2に接続した絶縁 RS485 アドオンモジュールのRS485設定を全二重通信にする場合は、保守モードで起動してから次のようにコマンドを実行してください。

hermit> setenv console=ttymxc1,115200 root=/dev/ram0 imx.rs485_uart1=0x13,0,0

絶縁 RS485アドオンモジュールのシリアルインターフェースからArmadillo-IoTにログインします。

RS422/RS485通信を行う場合は、事前に「RS422/RS485の通信設定を変更する」を参照して通信環境に合わせた設定を行ってください。

アドオンインターフェース(ベースボード:CON2)に接続した絶縁 RS485アドオンモジュールのシリアルインターフェースからログインする手順を次に示します。

ATDEのminicomにログインプロンプトが表示されます。ユーザー「guest」でログインすることができます。

	以下のように/etc/securettyにシリアルデバイスを登録すると、特権ユーザー「root」でログインすることが可能になります。 [armadillo ~]# echo ttymxc0 >> /etc/securetty デフォルト状態ではセキュリティーを考慮し、特権ユーザーでのログインを制限しています。

GPIOクラスディレクトリ以下のvalueファイルに値を書き込むことによって、出力状態を設定することができます。"0"は開放、"1"は短絡を表わします。

アドオンインターフェース(ベースボード:CON2)に接続した絶縁 IO アドオンモジュールのデジタル出力 1を開放に設定する例を次に示します。

[armadillo ~]# echo 0 > /sys/class/gpio/DO1_CON2/value

GPIOクラスディレクトリ以下のvalueファイルから値を読み出すことによって、入力状態を取得することができます。"0"はGND_ISOとの短絡。"1"は開放または3.15V以上印加を表わします。

アドオンインターフェース(ベースボード:CON2)に接続した絶縁 IO アドオンモジュールのデジタル入力 1の状態を取得する例を次に示します。

[armadillo ~]# cat /sys/class/gpio/DI1_CON2/value
1

/sys/bus/iio/devices/iio:device0/ディレクトリ以下のファイルから入力電圧を算出することができます。

	IIO デバイスは、デバイスを認識した順番で iio:deviceN (N は'0'からの連番)となります。IIO デバイスは、IIOデバイス名から特定することができます。絶縁 IO アドオンモジュールに搭載しているADコンバーターの IIO デバイス名は "mcp3202"です。 [armadillo ~]# cat /sys/bus/iio/devices/iio:device0/name mcp3202

ADコンバータへの入力電圧は、AD変換値と最小入力電圧変動から算出する事ができます。

[ADコンバータへの入力電圧 (mV)] = [AD変換値] × [最小入力電圧変動]

/sys/bus/iio/devices/iio:device0/ディレクトリ以下にある、入力電圧の算出に必要なファイルを次に示します。

シングルエンド入力 CH0への入力電圧を算出する例を次に示します。

[armadillo ~]# cat /sys/bus/iio/devices/iio:device0/in_voltage0_raw
2048
[armadillo ~]# cat /sys/bus/iio/devices/iio:device0/in_voltage_scale
1.220703125

図6.49「ADコンバーターへの入力電圧を取得する」の例では、シングルエンド入力 CH0への入力電圧は、2.5V (2048 × 1.220703125 [mV])である事がわかります。

	awkコマンドを利用して、次のように電源電圧を表示することができます。 [armadillo ~]# adin_raw=`cat /sys/bus/iio/devices/iio:device0/in_voltage0_raw` [armadillo ~]# adin_scale=`cat /sys/bus/iio/devices/iio:device0/in_voltage_scale` [armadillo ~]# echo $adin_raw $adin_scale | awk '{printf ("%d",$1*$2)}' 2500

Linuxカーネルのソースコードに含まれているサンプルプログラム(drivers/staging/iio/Documentation/generic_buffer.c)を利用して、AD変換値とタイムスタンプを取得することができます。サンプルプログラムは次のようにビルドします。 [ATDE ~]# cd linux-3.14-at[version] [ATDE ~/linux-3.14-at[version]]# arm-linux-gnueabi-gcc drivers/staging/iio/Documentation/generic_buffer.c -o generic_buffer シングルエンド入力 CH0のAD変換値とタイムスタンプ(ナノ秒)を取得する例を次に示します。 [armadillo ~]# echo 1 > /sys/bus/iio/devices/iio_sysfs_trigger/add_trigger [armadillo ~]# echo 1 > /sys/bus/iio/devices/iio:device0/scan_elements/in_voltage0_en [armadillo ~]# echo 1 > /sys/bus/iio/devices/iio:device0/scan_elements/in_timestamp_en [armadillo ~]# ./generic_buffer -n mcp3202 -t sysfstrig1 -l 128 -c 10 & [armadillo ~]# echo 1 > /sys/bus/iio/devices/trigger0/trigger_now 2472.000000 947128416143915461