第1章 はじめに

このたびは Armadillo-Box WS1 をご利用いただき、ありがとうございます。

Armadillo-Box WS1 は、Wi-SUN に対応した HEMS装置向けのプラットフォームです。スマートメーターの標準通信ネットワーク規格である Wi-SUN を標準搭載することで、すぐに HEMS機器の開発を開始することができます。もちろんスマートメーター以外の様々な Wi-SUN 機器とも通信可能です。

Armadillo-Box WS1 では、ECHONET Lite のプロトコルスタックを用意しています。HEMS標準プロトコルであるECHONET Lite を使うことで、簡単に HEMS機器の開発が可能です。

Armadillo-Box WS1 には、標準 OS として Linux がプリインストールされています。そのため、オープンソースソフトウェアを含む多くのソフトウェア資産を活用し、自由にオリジナルのアプリケーションを開発することができます。開発言語としては、C/C++言語をサポートしています。Wi-SUN 経由で取得したデーターをクラウド側に転送したり、クラウドから Armadillo-Box WS1 や Wi-SUN機器をコントロールするなど、Wi-SUN機器とインターネットプロトコルとのゲートウェイを開発することが可能です。

以降、本書では他の Armadillo ブランド製品にも共通する記述については、製品名を Armadillo と表記します。

1.1. 本書で扱うこと扱わないこと

1.1.1. 扱うこと

本書では、Armadillo-Box WS1の使い方、製品仕様(ソフトウェアおよびハードウェア)、製品を開発するために必要となる情報、その他注意事項について記載しています。Linuxあるいは組み込み機器に不慣れな方でも読み進められるよう、コマンドの実行例なども記載しています。

1.1.2. 扱わないこと

本書では、一般的なLinux のプログラミング、デバッグ方法やツールの扱い方など、一般的な情報や、他に詳しい情報があるものは扱いません。また、(Armadillo-Box WS1を使用した)最終製品あるいはサービスに、固有な情報や知識も含まれていません。

1.2. 本書で必要となる知識と想定する読者

本書は、読者としてArmadillo-Box WS1を使って、Wi-SUNと従来のネットワークを中継するゲートウェイ機器を開発するエンジニアを想定して書かれています。また、「Armadillo-Box WS1を使うと、どのようなことが実現可能なのか 」を知りたいと考えている設計者・企画者も対象としています。Armadillo-Box WS1は組込みプラットフォームとして実績のあるArmadilloをベースとしているため、標準で有効になっている機能以外にも様々な機能を実現することができます。

ソフトウェアエンジニア

端末からのコマンドの実行方法など、基本的なLinuxの扱い方を知っているエンジニアを対象読者として想定しています。プログラミング言語としてC/C++を扱えることは必ずしも必要ではありませんが、基礎的な知識がある方が理解しやすい部分もあります。

ハードウェアエンジニア

電子工学の基礎知識を有したエンジニアを対象読者として想定しています。回路図や部品表を読み、理解できる必要があります。

1.3. ユーザー限定コンテンツ

アットマークテクノ ユーザーズサイトで購入製品登録を行うと、製品をご購入いただいたユーザーに限定して公開している限定コンテンツにアクセスできるようになります。主な限定コンテンツには、下記のものがあります。

  • リカバリ用ユーザーランドイメージ(工場出荷時と同等のもの)

  • 各種信頼性試験データ・納入仕様書等製造関連情報

限定コンテンツを取得するには、18章ユーザー登録を参照してください。

1.4. 本書および関連ファイルのバージョンについて

本書を含めた関連マニュアル、ソースファイルやイメージファイルなどの関連ファイルは最新版を使用することをおすすめいたします。本書を読み始める前に、Armadilloサイトで最新版の情報をご確認ください。

1.5. 本書の構成

本書には、ご利用にあたっての注意事項や、ご購入時のソフトウェアの状態、ハードウェア・ソフトウェアをカスタマイズする場合に必要な情報などが記載されています。

◆ はじめにお読みください。

1章はじめに2章注意事項

◆ Armadillo-Box WS1の仕様を紹介します。

3章製品概要

◆ 工場出荷状態のソフトウェアの使い方や、動作を確認する方法を紹介します。

4章Armadilloの電源を入れる前に5章起動と終了6章動作確認方法7章コンフィグ領域 − 設定ファイルの保存領域

◆ 工場出荷状態のソフトウェア仕様について紹介します。

8章Linuxカーネル仕様9章ユーザーランド仕様10章ブートローダー仕様

◆ システム開発に必要な情報を紹介します。

11章ビルド手順12章フラッシュメモリの書き換え方法13章開発の基本的な流れ

◆ ハードウェア仕様について紹介します。

14章ハードウェア仕様15章電気的仕様16章組み立て17章形状図

◆ ご購入ユーザーに限定して公開している情報の紹介やユーザー登録について紹介します。

18章ユーザー登録

1.6. 表記について

1.6.1. フォント

本書では以下のような意味でフォントを使いわけています。

表1.1 使用しているフォント

フォント例説明
本文中のフォント本文
[PC ~]$ lsプロンプトとユーザ入力文字列
text編集する文字列や出力される文字列。またはコメント

1.6.2. コマンド入力例

本書に記載されているコマンドの入力例は、表示されているプロンプトによって、それぞれに対応した実行環境を想定して書かれています。「/」の部分はカレントディレクトリによって異なります。各ユーザのホームディレクトリは「~」で表わします。

表1.2 表示プロンプトと実行環境の関係

プロンプトコマンドの実行環境
[PC /]#作業用PC上のrootユーザで実行
[PC /]$作業用PC上の一般ユーザで実行
[armadillo /]#Armadillo上のrootユーザで実行
[armadillo /]$Armadillo上の一般ユーザで実行
hermit>Armadillo上の保守モードで実行

コマンド中で、変更の可能性のあるものや、環境により異なるものに関しては以下のように表記します。適時読み替えて入力してください。

表1.3 コマンド入力例での省略表記

表記説明
[version]ファイルのバージョン番号

1.6.3. アイコン

本書では以下のようにアイコンを使用しています。

[警告]

注意事項を記載します。

[ティップ]

役に立つ情報を記載します。

1.7. 謝辞

Armadilloで使用しているソフトウェアの多くは Free Software / Open Source Softwareで構成されています。Free Software / Open Source Softwareは世界中の多くの開発者の成果によってなりたっています。この場を借りて感謝の意を表します。