Armadilloの電源を入れる前に

4.1. 準備するもの

Armadilloを使用する前に、次のものを必要に応じて準備してください。

作業用PC: LinuxまたはWindowsが動作し、ネットワークインターフェースと 1つ以上のUSBポートを持つPCです。「開発/動作確認環境の構築」を参照して、作業用PC上に開発/動作確認環境を構築してください。
ネットワーク環境: Armadilloと作業用PCをネットワーク通信ができるようにしてください。
microSDカード: microSDスロットの動作を確認する場合などに利用します。
USBメモリ: USBの動作を確認する場合などに利用します。
nanoSIM(UIM カード)とAPN 情報: LTE の動作を確認する場合に利用します。通信事業者との契約が必要です。SMS の動作を確認する場合は、SMS が利用可能な nanoSIM(UIMカード)が必要です。
tar.xz形式のファイルを展開するソフトウェア: 開発/動作確認環境を構築するために利用します。Linuxでは、tar で展開できます。Windowsでは、7-Zip などが対応しています。
プラスドライバー: microSDカードを装着する場合に必要です。推奨するドライバーの先端サイズはNo.1です。
マイナスドライバー: ケースを組み立てる際に必要です。推奨するドライバーの先端サイズは4.0mm x 0.5mmです。

4.2. microSDカードの装着

microSDカードの装着手順は、以下の通りです。

サブユニットを固定しているネジを取り外す
サブユニットを取り外す
microSDスロットにmicroSDカードを装着する

図4.1 サブユニット固定ネジの取り外し

図4.2 サブユニットの取り外し

サブユニットの外観については、「インターフェースレイアウト」を参照してください。

4.3. C1モデルケースの組み立て


	nanoSIM(UIMカード)の取り付けは、ケース組立前に行う必要があります。取り付け手順については、「LTE データ通信設定を行う前に」を参照してください。

基板をケースに収め、付属のネジで固定してください。

図4.3 ケースの組み立て

表4.1 ケースの組み立て

番号	名称	説明
1	タッピングネジ(M2.6、L=21mm)×3	ケーストップとケースボトムを固定するためのねじです。
2	タッピングネジ(M3、L=12mm)×1	ケーストップとケースボトムを固定するためのねじです。
3	飾りネジ	ボンド止めされているので、無理に取り外さないでください。

4.4. アンテナコネクタ形状

アンテナコネクタ形状は、以下の通りです。

表4.2 アンテナコネクタ形状

	Armadilloのアンテナコネクタ	外付けアンテナコネクタ
タイプ	SMA(FeMale)	SMA(Male)
形状

4.5. 開発/動作確認環境の構築

アットマークテクノ製品のソフトウェア開発や動作確認を簡単に行うために、VMware仮想マシンのデータイメージを提供しています。このVMware仮想マシンのデータイメージをATDE(Atmark Techno Development Environment)と呼びます。ATDEの起動には仮想化ソフトウェアであるVMwareを使用します。ATDEのデータは、tar.xz圧縮されています。環境に合わせたツールで展開してください。

仮想化ソフトウェアとして、VMwareの他にOracle VM VirtualBoxが有名です。 Oracle VM VirtualBoxには以下の特徴があります。

GPL v2(General Public License version 2)で提供されている ^[4]
VMware形式の仮想ディスク(.vmdk)ファイルに対応している

Oracle VM VirtualBoxからATDEを起動し、ソフトウェア開発環境として使用することができます。

ATDEは、バージョンにより対応するアットマークテクノ製品が異なります。本製品に対応しているATDEは、ATDE8 の v20201224 以降です。

ATDE8 は Debian GNU/Linux 10 (コードネーム buster) をベースに、Armadillo-IoT ゲートウェイ A6 のソフトウェア開発を行うために必要なクロス開発ツールや、Armadillo-IoT ゲートウェイ A6 の動作確認を行うために必要なツールが事前にインストールされています。

4.5.1. ATDEのセットアップ

4.5.1.1. VMwareのインストール

ATDEを使用するためには、作業用PCにVMwareがインストールされている必要があります。 VMware社 Webページ(http://www.vmware.com/)を参照し、利用目的に合うVMware製品をインストールしてください。また、ATDEのアーカイブは tar.xz圧縮されていますので、環境に合せたツールで展開してください。


	VMwareは、非商用利用限定で無償のものから、商用利用可能な有償のものまで複数の製品があります。製品ごとに異なるライセンス、エンドユーザー使用許諾契約書(EULA)が存在するため、十分に確認した上で利用目的に合う製品をご利用ください。

VMwareやATDEが動作しないことを未然に防ぐため、使用するVMwareのドキュメントから以下の項目についてご確認ください。

ホストシステムのハードウェア要件
ホストシステムのソフトウェア要件
ゲストOSのプロセッサ要件

VMwareのドキュメントは、VMware社 Webページ(http://www.vmware.com/)から取得することができます。

4.5.1.2. ATDEのアーカイブを取得

ATDEのアーカイブは Armadillo サイト(http://armadillo.atmark-techno.com)から取得可能です。


	本製品に対応している ATDE のバージョンは ATDE8 v20201224 以降です。


	作業用PCの動作環境(ハードウェア、VMware、ATDEの対応アーキテクチャなど)により、ATDEが正常に動作しない可能性があります。VMware社 Webページ(http://www.vmware.com/)から、使用しているVMwareのドキュメントなどを参照して動作環境を確認してください。

4.5.1.3. ATDEのアーカイブを展開

ATDEのアーカイブを展開します。ATDEのアーカイブは、tar.xz形式の圧縮ファイルです。

Windowsでの展開方法を「WindowsでATDEのアーカイブ展開する」に、Linuxでの展開方法を手順「Linuxでtar.xz形式のファイルを展開する」に示します。

4.5.1.4. WindowsでATDEのアーカイブ展開する

7-Zipのインストール
7-Zipをインストールします。7-Zipは、圧縮解凍ソフト 7-Zipのサイト(http://sevenzip.sourceforge.jp)からダウンロード取得可能です。
7-Zipの起動
7-Zipを起動します。
xz圧縮ファイルの選択
xz圧縮ファイルを展開して、tar形式のファイルを出力します。tar.xz形式のファイルを選択して、「展開」をクリックします。
xz圧縮ファイルの展開先の指定
「展開先」を指定して、「OK」をクリックします。
xz圧縮ファイルの展開
展開が始まります。
tarアーカイブファイルの選択
xz圧縮ファイルの展開が終了すると、tar形式のファイルが出力されます。tarアーカイブファイルを出力したのと同様の手順で、tarアーカイブファイルからATDEのデータイメージを出力します。tar形式のファイルを選択して「展開」をクリックし、「展開先」を指定して、「OK」をクリックします。
展開の完了確認
tarアーカイブファイルの展開が終了すると、ATDEアーカイブの展開は完了です。「展開先」に指定したフォルダにATDEのデータイメージが出力されています。

4.5.1.5. Linuxでtar.xz形式のファイルを展開する

tar.xz圧縮ファイルの展開
tar の xf オプションを使用して tar.xz 圧縮ファイルを展開します。
```
[PC ~]$ tar xf atde8-amd64-[version].tar.xz
```

展開の完了確認

tar.xz圧縮ファイルの展開が終了すると、ATDEアーカイブの展開は完了です。 atde8-amd64-[version] ディレクトリにATDEのデータイメージが出力されています。

[PC ~]$ ls atde8-amd64-[version]/
atde8-amd64-s001.vmdk  atde8-amd64.nvram
atde8-amd64-s002.vmdk  atde8-amd64.vmdk
atde8-amd64-s003.vmdk  atde8-amd64.vmsd
atde8-amd64-s004.vmdk  atde8-amd64.vmx
atde8-amd64-s005.vmdk  atde8-amd64.vmxf
atde8-amd64-s006.vmdk
atde8-amd64-s007.vmdk
atde8-amd64-s008.vmdk

4.5.1.6. ATDEの起動

ATDEのアーカイブを展開したディレクトリに存在する仮想マシン構成(.vmx)ファイルをVMware上で開くと、ATDEを起動することができます。ATDE8にログイン可能なユーザーを、表4.3「ユーザー名とパスワード」に示します ^[5]。

表4.3 ユーザー名とパスワード

ユーザー名	パスワード	権限
`atmark`	`atmark`	一般ユーザー
`root`	`root`	特権ユーザー


	ATDEに割り当てるメモリおよびプロセッサ数を増やすことで、ATDEをより快適に使用することができます。仮想マシンのハードウェア設定の変更方法については、VMware社 Webページ(http://www.vmware.com/)から、使用しているVMwareのドキュメントなどを参照してください。

4.5.2. 取り外し可能デバイスの使用

VMwareは、ゲストOS (ATDE)による取り外し可能デバイス(USBデバイスやDVDなど)の使用をサポートしています。デバイスによっては、ホストOS (VMwareを起動しているOS)とゲストOSで同時に使用することができません。そのようなデバイスをゲストOSで使用するためには、ゲストOSにデバイスを接続する操作が必要になります。


	取り外し可能デバイスの使用方法については、VMware社 Webページ(http://www.vmware.com/)から、使用しているVMwareのドキュメントなどを参照してください。

Armadillo-IoT ゲートウェイ A6の動作確認を行うためには、表4.4「動作確認に使用する取り外し可能デバイス」に示すデバイスをゲストOSに接続する必要があります。

表4.4 動作確認に使用する取り外し可能デバイス

デバイス	デバイス名
USBシリアル変換アダプタ	Future Devices FT232R USB UART
作業用PCの物理シリアルポート	シリアルポート

4.5.3. コマンドライン端末(GNOME端末)の起動

ATDEで、CUI (Character-based User Interface)環境を提供するコマンドライン端末を起動します。ATDEで実行する各種コマンドはコマンドライン端末に入力し、実行します。コマンドライン端末にはいくつかの種類がありますが、ここではGNOMEデスクトップ環境に標準インストールされているGNOME端末を起動します。

GNOME端末を起動するには、図4.4「GNOME端末の起動」のようにデスクトップ左上のアクティビティから「terminal」と入力し「端末」を選択してください。

images/common-images/open-gnome_terminal-on-atde8/gnome_terminal_menu.png

図4.4 GNOME端末の起動

図4.5「GNOME端末のウィンドウ」のようにウィンドウが開きます。

images/common-images/open-gnome_terminal-on-atde8/gnome_terminal_open.png

図4.5 GNOME端末のウィンドウ

4.5.4. シリアル通信ソフトウェア(minicom)の使用

シリアル通信ソフトウェア(minicom)のシリアル通信設定を、表4.5「シリアル通信設定」のように設定します。また、minicomを起動する端末の横幅を80文字以上にしてください。横幅が80文字より小さい場合、コマンド入力中に表示が乱れることがあります。

表4.5 シリアル通信設定

項目	設定
転送レート	115,200bps
データ長	8bit
ストップビット	1bit
パリティ	なし
フロー制御	なし

図4.6「minicomの設定の起動」に示すコマンドを実行し、minicomの設定画面を起動してください。
```
[ATDE ~]$ sudo LANG=C minicom --setup
```
図4.6 minicomの設定の起動

図4.7「minicomの設定」が表示されますので、「Serial port setup」を選択してください。

            +-----[configuration]------+
            | Filenames and paths      |
            | File transfer protocols  |
            | Serial port setup        |
            | Modem and dialing        |
            | Screen and keyboard      |
            | Save setup as dfl        |
            | Save setup as..          |
            | Exit                     |
            | Exit from Minicom        |
            +--------------------------+

図4.7 minicomの設定

図4.8「minicomのシリアルポートの設定」が表示されますので、Aキーを押してSerial Deviceを選択してください。

    +-----------------------------------------------------------------------+
    | A -    Serial Device      : /dev/ttyUSB0                              |
    | B - Lockfile Location     : /var/lock                                 |
    | C -   Callin Program      :                                           |
    | D -  Callout Program      :                                           |
    | E -    Bps/Par/Bits       : 115200 8N1                                |
    | F - Hardware Flow Control : No                                        |
    | G - Software Flow Control : No                                        |
    |                                                                       |
    |    Change which setting?                                              |
    +-----------------------------------------------------------------------+

図4.8 minicomのシリアルポートの設定

Serial Deviceに使用するシリアルポートを入力してEnterキーを押してください。

USB to シリアル変換ケーブル使用時のデバイスファイル確認方法

LinuxでUSB to シリアル変換ケーブルを接続した場合、コンソールに以下のようなログが表示されます。ログが表示されなくても、dmesgコマンドを実行することで、ログを確認することができます。

usb 2-1.2: new full-speed USB device number 5 using ehci-pci
usb 2-1.2: New USB device found, idVendor=0403, idProduct=6001
usb 2-1.2: New USB device strings: Mfr=1, Product=2, SerialNumber=3
usb 2-1.2: Product: FT232R USB UART
usb 2-1.2: Manufacturer: FTDI
usb 2-1.2: SerialNumber: A702ZLZ7
usbcore: registered new interface driver usbserial
usbcore: registered new interface driver usbserial_generic
usbserial: USB Serial support registered for generic
usbcore: registered new interface driver ftdi_sio
usbserial: USB Serial support registered for FTDI USB Serial Device
ftdi_sio 2-1.2:1.0: FTDI USB Serial Device converter detected
usb 2-1.2: Detected FT232RL
usb 2-1.2: Number of endpoints 2
usb 2-1.2: Endpoint 1 MaxPacketSize 64
usb 2-1.2: Endpoint 2 MaxPacketSize 64
usb 2-1.2: Setting MaxPacketSize 64
usb 2-1.2: FTDI USB Serial Device converter now attached to ttyUSB0

図4.9 例. USB to シリアル変換ケーブル接続時のログ

上記のログからUSB to シリアル変換ケーブルがttyUSB0に割り当てられたことが分かります。

Fキーを押してHardware Flow ControlをNoに設定してください。
Gキーを押してSoftware Flow ControlをNoに設定してください。

キーボードのEキーを押してください。図4.10「minicomのシリアルポートのパラメータの設定」が表示されます。

                      +---------[Comm Parameters]----------+
                      |                                    |
                      |     Current: 115200 8N1            |
                      | Speed            Parity      Data  |
                      | A: <next>        L: None     S: 5  |
                      | B: <prev>        M: Even     T: 6  |
                      | C:   9600        N: Odd      U: 7  |
                      | D:  38400        O: Mark     V: 8  |
                      | E: 115200        P: Space          |
                      |                                    |
                      | Stopbits                           |
                      | W: 1             Q: 8-N-1          |
                      | X: 2             R: 7-E-1          |
                      |                                    |
                      |                                    |
                      | Choice, or <Enter> to exit?        |
                      +------------------------------------+

図4.10 minicomのシリアルポートのパラメータの設定

図4.10「minicomのシリアルポートのパラメータの設定」では、転送レート、データ長、ストップビット、パリティの設定を行います。
現在の設定値は「Current」に表示されています。それぞれの値の内容は図4.11「minicomシリアルポートの設定値」を参照してください。
図4.11 minicomシリアルポートの設定値
Eキーを押して、転送レートを115200に設定してください。
Qキーを押して、データ長を8、パリティをNone、ストップビットを1に設定してください。
Enterキーを2回押して、図4.7「minicomの設定」に戻ってください。
図4.7「minicomの設定」から、「Save setup as dfl」を選択し、設定を保存してください。
「Exit from Minicom」を選択し、minicomの設定を終了してください。

minicomを起動させるには、図4.12「minicom起動方法」のようにしてください。

[ATDE ~]$ sudo LANG=C minicom --wrap --device /dev/ttyUSB0

図4.12 minicom起動方法


	デバイスファイル名は、環境によって `/dev/ttyS0` や `/dev/ttyUSB1` など、本書の実行例とは異なる場合があります。

minicomがオープンする /dev/ttyS0 や /dev/ttyUSB0 といったデバイスファイルは、 root または dialout グループに属しているユーザーしかアクセスできません。

ユーザーを dialout グループに入れることで、以降、sudoを使わずにminicomで /dev/ttyUSB0 をオープンすることができます。

[ATDE ~]$ sudo usermod -aG dialout atmark
[ATDE ~]$ LANG=C minicom --wrap --device /dev/ttyUSB0

minicomを終了させるには、まず Ctrl-a に続いて q キーを入力します。その後、以下のように表示されたら「Yes」にカーソルを合わせてEnterキーを入力するとminicomが終了します。

+-----------------------+
| Leave without reset? |
|     Yes       No     |
+-----------------------+

図4.13 minicom終了確認


	`Ctrl-a` に続いて `z` キーを入力すると、minicomのコマンドヘルプが表示されます。

4.6. インターフェースレイアウト

Armadillo-IoT ゲートウェイ A6のインターフェースレイアウトです。各インターフェースの配置場所等を確認してください。

images/aiot-a6-u1-a640-interface-details.svg

図4.14 メインユニットインターフェースレイアウト(U1モデル)

images/aiot-a6-c1-a640-interface-details.svg

図4.15 メインユニットインターフェースレイアウト(C1モデル)

表4.6 メインユニットインターフェース内容

部品番号	インターフェース名	形状	備考
CON1	SDインターフェース	microSDスロット(ヒンジタイプ)
CON2	LANインターフェース	RJ-45コネクタ
CON3	シリアルインターフェース	D-Sub9ピン(オス)	C1モデルには、コネクタは実装されていません。
CON4	シリアルインターフェース	ピンヘッダ 10ピン(2.54mmピッチ)	U1モデルには、コネクタは実装されていません。
CON5	USBインターフェース	Type-Aコネクタ(2ポートスタック)
CON7	LANインターフェース	ピンヘッダ 10ピン(2.54mmピッチ)	コネクタ非搭載
CON12	電源入力インターフェース	DCジャック	対応プラグ: EIAJ#2
LED1	LANスピードLED	LED(緑色,面実装)
LED2	LANリンクアクティビティLED	LED(黄色,面実装)
LED3	ユーザーLED(赤)	LED(赤色,φ3mm)
LED4	ユーザーLED(緑)	LED(緑色,φ3mm)
SW1	ユーザースイッチ	タクトスイッチ(h=17mm)

図4.16 サブユニットインターフェースレイアウト

表4.7 サブユニットインターフェース内容

部品番号	インターフェース名	形状	備考
CON1	LTE アンテナインターフェース	小型同軸コネクタ	挿抜寿命: 20回 ^[a]
CON2	nanoSIM インターフェース	nanoSIM スロット
CON3	拡張インターフェース	ピンヘッダ14ピン(2.54mmピッチ)	C1モデルには、コネクタは実装されていません。
SW1	起動デバイス設定スイッチ	スライドスイッチ
^[a]挿抜寿命は製品出荷時における目安であり、実際の挿抜可能な回数を保証するものではありません。

4.7. 接続方法

Armadillo-IoT ゲートウェイ A6と周辺装置の接続例を次に示します。

図4.17 Armadillo-IoT ゲートウェイ A6 C1モデルの接続例

: Armadillo-IoT ゲートウェイ
: ACアダプタ(5V/2A)
: 作業用PC
: シリアルクロスケーブル
: USB-RS-232C変換ケーブル
: LAN HUB
: Ethernetケーブル
: nanoSIMカード
: D-Sub9/10ピンシリアル変換ケーブル
: LTE用外付けアンテナ

図4.18 Armadillo-IoT ゲートウェイ A6 U1モデルの接続例

: Armadillo-IoT ゲートウェイ
: ACアダプタ(5V/2A)
: 作業用PC
: シリアルクロスケーブル
: USB-RS232C変換ケーブル
: LAN HUB
: Ethernetケーブル
: nanoSIMカード
: LTE用外付けアンテナ

4.8. スライドスイッチの設定について

サブユニットのスライドスイッチを操作することで、起動デバイスを設定することができます。

図4.19 スライドスイッチの設定

: 起動デバイスはmicroSDになります。
: 起動デバイスはeMMCになります。

4.9. viエディタの使用方法

viエディタは、Armadilloに標準でインストールされているテキストエディタです。本書では、Armadilloの設定ファイルの編集などにviエディタを使用します。

viエディタは、ATDEにインストールされてるgeditやemacsなどのテキストエディタとは異なり、モードを持っていることが大きな特徴です。viのモードには、コマンドモードと入力モードがあります。コマンドモードの時に入力した文字はすべてコマンドとして扱われます。入力モードでは文字の入力ができます。

本章で示すコマンド例はATDEで実行するよう記載していますが、Armadilloでも同じように実行することができます。

4.9.1. viの起動

viを起動するには、以下のコマンドを入力します。

[ATDE ~]# vi [file]

図4.20 viの起動

file にファイル名のパスを指定すると、ファイルの編集( file が存在しない場合は新規作成)を行います。viはコマンドモードの状態で起動します。

4.9.2. 文字の入力

文字を入力するにはコマンドモードから入力モードへ移行する必要があります。コマンドモードから入力モードに移行するには、表4.8「入力モードに移行するコマンド」に示すコマンドを入力します。入力モードへ移行後は、キーを入力すればそのまま文字が入力されます。

表4.8 入力モードに移行するコマンド

コマンド	動作
i	カーソルのある場所から文字入力を開始
a	カーソルの後ろから文字入力を開始

「i」、「a」それぞれのコマンドを入力した場合の文字入力の開始位置を図4.21「入力モードに移行するコマンドの説明」に示します。

images/common-images/vi-insert-command.svg

図4.21 入力モードに移行するコマンドの説明

入力モードからコマンドモードに戻りたい場合は、ESCキーを入力することで戻ることができます。現在のモードが分からなくなった場合は、ESCキーを入力し、一旦コマンドモードへ戻ることにより混乱を防げます。

日本語変換機能をOFFに

viのコマンドを入力する時はATDEの日本語入力システム(Mozc)をOFFにしてください。日本語入力システムのON/OFFは、半角/全角キーで行うことができます。

viでの文字削除

コンソールの環境によってはBS(Backspace)キーで文字が削除できず、「^H」文字が入力される場合があります。その場合は、「文字の削除」で説明するコマンドを使用し、文字を削除してください。

4.9.3. カーソルの移動

方向キーでカーソルの移動ができますが、コマンドモードで表4.9「カーソルの移動コマンド」に示すコマンドを入力することでもカーソルを移動することができます。

表4.9 カーソルの移動コマンド

コマンド	動作
h	左に1文字移動
j	下に1文字移動
k	上に1文字移動
l	右に1文字移動

4.9.4. 文字の削除

文字を削除する場合は、コマンドモードで表4.10「文字の削除コマンド」に示すコマンドを入力します。

表4.10 文字の削除コマンド

コマンド	動作
x	カーソル上の文字を削除
dd	現在行を削除

「x」コマンド、「dd」コマンドを入力した場合に削除される文字を図4.22「文字を削除するコマンドの説明」に示します。

images/common-images/vi-delete-command.svg

図4.22 文字を削除するコマンドの説明

4.9.5. 保存と終了

ファイルの保存、終了を行うコマンドを表4.11「保存・終了コマンド」に示します。

表4.11 保存・終了コマンド

コマンド	動作
`:q!`	変更を保存せずに終了
`:w[file]`	ファイルを `file` に指定して保存
`:wq`	ファイルを上書き保存して終了

保存と終了を行うコマンドは「 : 」(コロン)からはじまるコマンドを使用します。" : "キーを入力すると画面下部にカーソルが移り入力したコマンドが表示されます。コマンドを入力した後Enterキーを押すことで、コマンドが実行されます。

^[4]バージョン3.xまではPUEL(VirtualBox Personal Use and Evaluation License)が適用されている場合があります。

^[5]特権ユーザーでGUIログインを行うことはできません


第3章製品概要	PDF version	第5章起動と終了