第6章フラッシュメモリの書き換え方法

第6章フラッシュメモリの書き換え方法

6.1. ダウンローダのインストール

6.1.1. 作業用PCがLinuxの場合
6.1.2. 作業用PCがWindowsの場合

6.2. フラッシュメモリの書き込み領域について

6.3. Hermit-Atダウンローダを使用してフラッシュメモリを書き換える

6.3.1. 準備
6.3.2. 作業用PCがLinuxの場合
6.3.3. 作業用PCがWindowsの場合

6.4. netflashを使用してフラッシュメモリを書き換える

6.5. 2ndブートローダを出荷状態に戻す

6.5.1. 作業用PCがLinuxの場合
6.5.2. 作業用PCがWindowsの場合

6.6. 2ndブートローダーのパラメータを出荷状態に戻す

フラッシュメモリの内容を書き換えることで、Armadilloの機能を変更することができます。この章ではフラッシュメモリの書き換え方法を説明します。


	何らかの原因により「書き換えイメージの転送」に失敗した場合、Armadilloが正常に起動しなくなる場合があります。書き換えの際は次の点に注意してください。 Armadilloの電源を切らない Armadilloと開発用PCを接続しているシリアルケーブルとLANケーブルを外さない

6.1. ダウンローダのインストール

作業用PCにダウンローダをインストールします。

ダウンローダの種類には、表6.1「ダウンローダ一覧」のようなものがあります。

表6.1 ダウンローダ一覧

ダウンローダ	OSタイプ	説明
hermit-at	Linux	Linux用のCUIアプリケーションです。
shoehorn-at	Linux	Linux用のCUIアプリケーションです。
hermit-at-win	Windows	Windows用のGUIアプリケーションです。


	ATDE(Atmark Techno Development Environment)を利用する場合、ダウンローダパッケージはすでにインストールされているので、インストールする必要はありません。

6.1.1. 作業用PCがLinuxの場合

付属CDのdownloader/debディレクトリよりパッケージファイルを用意し、インストールします。必ずrootユーザで行ってください。

[PC ~]# dpkg --install hermit-at_[version]_i386.deb
[PC ~]# dpkg --install shoehorn-at_[version]_i386.deb

図6.1 ダウンローダのインストール（Linux）

6.1.2. 作業用PCがWindowsの場合

付属CDのdownloader/win32/hermit-at-win_[version].zipを任意のフォルダに展開します。

6.2. フラッシュメモリの書き込み領域について

フラッシュメモリの書き込み先頭アドレスは、領域（リージョン）名で指定することができます。書き込み領域毎に指定するイメージファイルは、表6.2「リージョン名と対応するイメージファイル」のようになります。

表6.2 リージョン名と対応するイメージファイル

製品	領域名	ファイル名
Armadillo-210	bootloader	loader-armadillo2x0-`[version]`.bin
	kernel	linux-a210-`[version]`.bin.gz
	userland	romfs-a210-recover-`[version]`.img.gz romfs-a210-base-`[version]`.img.gz
Armadillo-220/230/240	bootloader	loader-armadillo2x0-eth-`[version]`.bin
	kernel	linux-a2x0-`[version]`.bin.gz
	userland	romfs-a2x0-recover-`[version]`.img.gz romfs-a2x0-base-`[version]`.img.gz
Armadillo-9	bootloader	loader-armadillo9-`[version]`.bin
	kernel	linux-`[version]`.bin.gz
	userland	romfs-`[version]`.img.gz
Armadillo-300	ipl	ipl-a300.bin(※書き換え不可)
	bootloader	loader-armadillo-3x0-`[version]`.bin
	kernel	linux-a300-`[version]`.bin.gz
	userland	romfs-a300-`[version]`.img.gz
Armadillo-500	bootloader	loader-armadillo5x0-`[version]`.bin
	kernel	linux-a500-`[version]`.bin.gz
	userland	romfs-a500-`[version]`.img.gz
Armadillo-500 FX	bootloader	loader-armadillo5x0-fx-`[version]`.bin
	kernel	linux-a500-fx-`[version]`.bin.gz
	userland	romfs-a500-fx-`[version]`.img.gz

一部製品のユーザーランドには、RecoverとBaseという2種類のイメージファイルが用意されています。Recoverイメージは、出荷状態でオンボードフラッシュメモリに書き込まれていて、各製品の特徴や性能を利用するアプリケーションが含まれています。Baseイメージは、開発のベースとなるように、基本的なアプリケーションやツールのみが含まれています。

6.3. Hermit-Atダウンローダを使用してフラッシュメモリを書き換える

ここでは、Hermit-Atダウンローダを使用してフラッシュメモリを書き換える手順について説明します。「ダウンローダのインストール」でインストールしたHermit-Atダウンローダを使用します。これは、Armadilloのブートローダーと協調動作を行い、作業用PCからArmadilloのフラッシュメモリを書き換えることができます。

6.3.1. 準備

「ジャンパピンの設定について」を参照し、Hermit-Atを起動してください。

Armadilloと接続している作業用PCのシリアルインターフェースが他のアプリケーションで使用されていないことを確認します。使用されている場合は、該当アプリケーションを終了するなどしてシリアルインターフェースを開放してください。

6.3.2. 作業用PCがLinuxの場合

図6.2「ダウンロードコマンド」のようにコマンドを実行します。

downloadはhermitのサブコマンドの一つです。--input-fileで指定されたファイルをターゲットボードに書き込む時に使用します。--regionは書き込み対象の領域を指定するオプションです。下記の例では、「kernel領域にlinux.bin.gzを書き込む」という命令になります。

[PC ~]$ hermit download --input-file linux.bin.gz --region kernel

図6.2 ダウンロードコマンド

シリアルインターフェースがttyS0以外の場合は、図6.3「ダウンロードコマンド（ポート指定）」のように--portオプションを使用してポートを指定してください。

[PC ~]$ hermit download --input-file linux.bin.gz --region kernel --port ttyS1

図6.3 ダウンロードコマンド（ポート指定） ^[4]

bootloaderリージョンは、誤って書き換えることがないように簡易プロテクトされています。書き換える場合は、図6.4「ダウンロードコマンド（アンプロテクト）^[4]」のように--force-lockedオプションを使用して、プロテクトの解除をしてください。

[PC ~]$ hermit download --input-file loader.bin --region bootloader --force-locked

図6.4 ダウンロードコマンド（アンプロテクト）^[4]


	bootloaderリージョンに誤ったイメージを書き込んでしまった場合、オンボードフラッシュメモリからの起動ができなくなります。この場合は「2ndブートローダを出荷状態に戻す」を参照してブートローダーを復旧してください。

6.3.3. 作業用PCがWindowsの場合

hermit-at-win.exeを実行します。図6.5「Hermit-At：Downloadウィンドウ」が表示されます。

図6.5 Hermit-At：Downloadウィンドウ

Armadilloと接続されているシリアルインターフェースを「Serial Port」に指定してください。ドロップダウンリストに表示されない場合は、直接ポートを入力してください。

Imageには書き込むファイルを指定してください。Regionには書き込み対象のリージョンを指定してください。allやbootloaderリージョンを指定する場合は、Force Lockedをチェックしてください。

すべて設定してから実行ボタンをクリックします。図6.6「Hermit-At：downloadダイアログ」が表示されます。

図6.6 Hermit-At：downloadダイアログ

ダウンロードの設定と進捗状況が表示されます。ダウンロードが完了するとダイアログはクローズされます。

6.4. netflashを使用してフラッシュメモリを書き換える

Linuxアプリケーションのnetflashを使用してフラッシュメモリを書き換えることができます。netflashは、所属するネットワークにあるHTTPサーバーやFTPサーバーが公開しているファイルをダウンロードしてフラッシュメモリを書き換えることができます。

Armadilloにログインし、図6.7「netflashコマンド例」のようにコマンドを実行します。

[armadillo ~]# netflash -k -n -u -r /dev/flash/kernel [URL]

図6.7 netflashコマンド例

オプションの"-r [デバイスファイル名]"で書き込み対象のリージョンを指定しています。表6.3「リージョンとデバイスファイルの対応」を参照してください。その他のオプションについては、netflash -hで詳細を確認する事ができます。

表6.3 リージョンとデバイスファイルの対応

リージョン	デバイスファイル
カーネル	/dev/flash/kernel
ユーザランド	/dev/flash/userland

6.5. 2ndブートローダを出荷状態に戻す

2ndブートローダ領域にhermitコマンドプロンプトが表示されないイメージや、不正なイメージを書き込んでしまい、2ndブートローダを制御できなくなった場合の対処方法について説明します。

Armadillo-300の1stブートローダは、Shoehorn-At Hostと協調動作をすることで、Armadillo-300のRAM上に直接プログラムを書き込むことができます。この機能を利用して2ndブートローダを復旧させることが可能です。


	1stブートローダが破壊されている場合、本手段では復旧することはできません。破壊されている場合は、JTAGを使用し直接フラッシュメモリへ1st/2ndブートローダを書き込む必要があります。

6.5.1. 作業用PCがLinuxの場合

Armadillo-300の電源が切断されていることを確認し、作業用PCとArmadillo-300をシリアルケーブルで接続します。
Armadillo-300のJP1を「2-3」に設定します。

作業用PCでshoehornコマンドを以下の例^[5] のように実行します。

[PC ~]$ shoehorn --boot --terminal --initrd /dev/null
 --kernel /usr/lib/hermit/loader-armadillo3x0-boot.bin 
 --loader /usr/lib/shoehorn/shoehorn-armadillo3x0.bin
 --initfile /usr/lib/shoehorn/shoehorn-armadillo3x0.init
 --postfile /usr/lib/shoehorn/shoehorn-armadillo3x0.post

※ シリアルインターフェースが「ttyS0」以外の場合は、オプション「--port "ポート名"」を指定してください

図6.8 shoehornコマンド例

Armadillo-300の電源を投入します。


	電源を投入した場合、起動ログの表示が開始されます。表示が開始されない場合は、Armadillo-300の電源を切断し、シリアルケーブルの接続やジャンパ設定を確認してください。

"hermit>"と表示されたら、「Ctrl + C」キーを入力してください。

以上で作業用PCからhermitを使用してArmadillo-300へ2ndブートローダをダウンロードする準備が整います。ジャンパの設定変更や電源の切断をしないでCtrl-Cを押してShoehornを終了してから、図6.9「ブートローダの書き込みコマンド例」のようにブートローダの書き込みを行ってください^[6]。

[PC ~]$ hermit erase --region bootloader download --input-file loader-armadillo3x0-[version].bin
        --region bootloader --force-locked

図6.9 ブートローダの書き込みコマンド例

6.5.2. 作業用PCがWindowsの場合

Armadillo-300の電源が切断されていることを確認し、作業用PCとArmadillo-300をシリアルケーブルで接続します。
Armadillo-300のJP1を「2-3」に設定します。
「ダウンローダのインストール」で展開したhermit.exeを実行します。
「Shoehorn」ボタンをクリックすると図6.10「Hermit-At Win32：Shoehorn ウィンドウ」が表示されます。
図6.10 Hermit-At Win32：Shoehorn ウィンドウ
"Target"にarmadillo3x0を指定します。
「実行」ボタンをクリックすると図6.11「Hermit-At Win32：shoehorn ダイアログ」が表示されます。
図6.11 Hermit-At Win32：shoehorn ダイアログ

Armadillo-300の電源を投入します。


	電源を投入した場合、起動ログの表示が開始されます。表示が開始されない場合は、Armadillo-300の電源を切断し、シリアルケーブルの接続やジャンパ設定を確認してください。

shoehornダイアログがクローズするのを待ちます。以上で作業用PCからhermitを使用してArmadillo-300へ2ndブートローダをダウンロードする準備が整います。
以降の手順はジャンパの設定変更や電源の切断をせずにおこなう必要があります。

ダウンロードをおこなう前に、一旦ブートローダリージョンを削除します。Eraseボタンをクリックすると、図6.12「Hermit-At Win32：Erase ウィンドウ」が表示されます。


	Eraseを実行するためには、Hermit-At Win32 v1.3.0 以降が必要です。Hermit-At Win32 v1.2.0 以前ではこの手順は適用できません。Eraseを実行しない場合でもダウンロードは可能ですが、setenvサブコマンドなどでフラッシュメモリに保存されたパラメータが削除されません。

図6.12 Hermit-At Win32：Erase ウィンドウ

"Region"にbootloaderを指定し、Force Lockedをチェックして実行ボタンをクリックします。ブートローダリージョンの削除中は、図6.13「Hermit-At Win32：Erase ダイアログ」が表示され、削除の設定と進捗状況を確認することができます。
図6.13 Hermit-At Win32：Erase ダイアログ
ブートローダリージョンの削除が完了すると、ダイアログはクローズされます。次にダウンロードをおこないます。「Download」ボタンをクリックすると、図6.14「Hermit-At Win32：Download ウィンドウ(Erase後)」が表示されます。
図6.14 Hermit-At Win32：Download ウィンドウ(Erase後)
"Image"にはブートローダイメージファイルを、"Region"にはbootloaderを指定し、Force Lockedをチェックして実行ボタンをクリックします。ダウンロード中は、図6.15「Hermit-At Win32：Download ダイアログ(bootloader)」が表示され、ダウンロードの設定と進捗状況を確認することができます。
図6.15 Hermit-At Win32：Download ダイアログ(bootloader)
ダウンロードが完了すると、ダイアログはクローズされます。

6.6. 2ndブートローダーのパラメータを出荷状態に戻す

フラッシュメモリの2ndブートローダ領域には、2ndブートローダーイメージの他に2ndブートローダーのパラメータが保存されています。これは、Armadilloの再起動後も設定を有効にするためです。パラメータと初期設定の対応を、表6.4「2ndブートローダーのパラメータ」に示します。

表6.4 2ndブートローダーのパラメータ

パラメータ	初期設定	説明
Linuxカーネルパラメータ	無し	Linuxカーネル起動時にカーネルに渡すパラメータ

2ndブートローダーのパラメータを出荷状態に戻すには、ターゲットとなる Armadillo のジャンパを設定し、保守モードで起動してください。

作業用PCのシリアル通信ソフトウェアを使用して、コマンドを入力します。Linuxカーネルパラメータを初期設定に戻すには、図6.16「Linuxカーネルパラメータを初期設定に戻す」のようにコマンドを実行してください。^[7]

hermit> clearenv

図6.16 Linuxカーネルパラメータを初期設定に戻す

^[4]コマンドは1 行で入力します。

^[5]紙面の都合上、折り返して表現しています。

^[6]書面の都合上折り返して表記しています。実際にはコマンドは1 行で入力します。

^[7]「2ndブートローダを出荷状態に戻す」の手順を実行すると、パラメータが初期化されますので、この手順は必要ありません。但し、Hermit-AT Win32 v1.2.0 以前のバージョンを使用した場合、自動ではパラメータが初期化されないため、本手順を実行する必要があります。


第5章開発環境の準備	PDF version	第7章ビルド

Armadillo 開発者サイト

第6章 フラッシュメモリの書き換え方法

6.1. ダウンローダのインストール

6.1.1. 作業用PCがLinuxの場合

6.1.2. 作業用PCがWindowsの場合

6.2. フラッシュメモリの書き込み領域について

6.3. Hermit-Atダウンローダを使用してフラッシュメモリを書き換える

6.3.1. 準備

6.3.2. 作業用PCがLinuxの場合

6.3.3. 作業用PCがWindowsの場合

6.4. netflashを使用してフラッシュメモリを書き換える

6.5. 2ndブートローダを出荷状態に戻す

6.5.1. 作業用PCがLinuxの場合

6.5.2. 作業用PCがWindowsの場合

6.6. 2ndブートローダーのパラメータを出荷状態に戻す

第6章フラッシュメモリの書き換え方法