イメージファイルの書き換え方法

本章では、Armadillo-610の内蔵ストレージ(eMMC)に書き込まれているイメージファイルを書き換える手順について説明します。

本章で使用するブートローダーイメージファイルなどは、"Armadillo サイト"でダウンロードすることができます。新機能の追加や不具合の修正などが行われているため、最新バージョンを利用することを推奨します。

11.1. インストールディスクを使用する

インストールディスクを使用すると、内蔵ストレージ上のすべてのイメージをまとめて書き換えることができます。 Armadilloがソフトウェアの問題により起動しなくなった場合の復旧方法としてもご使用頂けます。

内蔵ストレージに保存されている、すべてのイメージファイルが上書きされるため、既に保存されているデータやアプリケーションなどは削除されます。

特定のイメージのみ書き換えたい場合には「特定のイメージファイルだけを書き換える」を参照してください。

インストールディスクはATDEで作成します。インストールディスクの作成に使用するファイルを次に示します。

表11.1 インストールディスク作成に使用するファイル

ファイル	ファイル名
インストールディスクイメージ	install-disk-sd-a600-[version].img

11.1.1. インストールディスクの作成

512 MB以上のSDカードを用意してください。
ATDE に SD カードを接続します。詳しくは「取り外し可能デバイスの使用」を参照してください。

SD カードがマウントされている場合、アンマウントします。

[ATDE ~]$ mount
(省略)
/dev/sdb1 on /media/atmark/B18A-3218 type vfat (rw,nosuid,nodev,relatime,uid=1000,gid=1000,fmask=0022,dmask=0077,codepage=437,iocharset=utf8,shortname=mixed,showexec,utf8,flush,errors=remount-ro,uhelper=udisks2)
[ATDE ~]$ sudo umount /dev/sdb1

SDカードにインストールディスクイメージを書き込みます。

[ATDE ~]$ sudo dd if=install-disk-sd-a600-[version].img of=/dev/sdb bs=4M conv=fsync
127+1 レコード入力
127+1 レコード出力
536870400 バイト (537 MB) コピーされました、 65.6377 秒、 8.2 MB/秒

11.1.2. インストールの実行

Armadilloの電源が切断されていることを確認します。接続されていた場合は、電源を切断してください。
USBシリアル変換アダプタのスライドスイッチを確認します。スライドスイッチが図4.18「スライドスイッチの設定」の 1 側に設定されている事を確認してください。
インストールディスクを使用してSDブートを行います。JP1とJP2を共にジャンパでショートし、インストールディスクをArmadilloに接続してください。

Armadillo に電源を投入するとmicroSDカードからブートローダーが起動し、次に示すログが表示されます。

U-Boot 2018.03-at8 installer+ (Feb 17 2020 - 19:19:21 +0900)

CPU:   Freescale i.MX6ULL rev1.1 at 396 MHz
Reset cause: POR
I2C:   ready
DRAM:  512 MiB
MMC:   FSL_SDHC: 0, FSL_SDHC: 1
In:    serial
Out:   serial
Err:   serial
PMIC: PFUZE3000 DEV_ID=0x30 REV_ID=0x11
Net:   FEC

=>

次のように"boot"コマンドを実行するとインストールが始まり、自動的にeMMCが書き換えられます。

=> boot
6601520 bytes read in 344 ms (18.3 MiB/s)
25797 bytes read in 62 ms (406.3 KiB/s)
## Booting kernel from Legacy Image at 82000000 ...
   Image Name:   Linux-4.14-at19
   Image Type:   ARM Linux Kernel Image (uncompressed)
   Data Size:    6601456 Bytes = 6.3 MiB
   Load Address: 82000000
   Entry Point:  82000000
   Verifying Checksum ... OK
## Flattened Device Tree blob at 83000000
   Booting using the fdt blob at 0x83000000
   Loading Kernel Image ... OK
   Loading Device Tree to 9eef9000, end 9ef024c4 ... OK

Starting kernel ...
: (省略)
*+*+* Install Start!! *+*+*

以下のようにメッセージが表示されるとインストール完了です。電源を切断してください。
```
*+*+* Install Completed!! *+*+*
```

11.1.3. LED点灯パターンによるインストールの進捗表示

LED点灯パターンによって、インストールの進捗状況を確認することができます。

インストールの進捗とLED点灯パターンの関係を次に示します。

表11.2 インストールの進捗とLED点灯パターン

進捗	ユーザーLED黄
実行中	点滅
正常終了	点灯
異常終了	消灯

11.2. 特定のイメージファイルだけを書き換える

Armadillo-610が起動した状態であれば、特定のイメージファイルだけを書き換えることができます。

イメージファイルと書き込み先の対応を次に示します。

表11.3 イメージファイルと書き込み先の対応

名称	ファイル名	ストレージ	デバイスファイル
ブートローダーイメージ	u-boot-a600-v2018.03-at[version].imx	`eMMC`	/dev/mmcblk0
Linuxカーネルイメージ	uImage-a600-v4.14-at[version]		/dev/mmcblk0p2
Device Tree Blob(LCD用) ^[a]	armadillo-610-extboard-eva-lcd-v4.14-at[version].dtb		/dev/mmcblk0p2
Device Tree Blob(Grove用) ^[a]	armadillo-610-extboard-eva-grove-v4.14-at[version].dtb		/dev/mmcblk0p2
Debian GNU/Linuxルートファイルシステム	debian-stretch-armhf-a600-[version].tar.gz		/dev/mmcblk0p2
^[a]どちらか一方を書き込みます。工場出荷時の Armadillo-610 開発セットにはDevice Tree Blob(Grove用)が書き込まれています。

11.2.1. ブートローダーイメージの書き換え

ブートローダーイメージの書き換え方法を次に示します。

[armadillo ~]# dd if=u-boot-a600-v2018.03-at[version].imx of=/dev/mmcblk0 bs=1k seek=1 conv=fsync 
275+0 records in
275+0 records out
281600 bytes (282 kB, 275 KiB) copied, 0.0310393 s, 9.1 MB/s

MTDのブロックデバイスの先頭からブートローダーイメージを書き込みます。

製品アップデートでリリースされた最新のブートローダーイメージに書き換えを行った場合は図9.6「全ての環境変数をデフォルト値に戻す」を参照して環境変数をデフォルト値に戻してください。

新しくリリースされた最新のブートローダーイメージは、環境変数のデフォルト値が更新されることがあります。書き替え前のブートローダーによって生成された環境変数で、最新のブートローダーを動作させると不具合が起こる可能性があります。

11.2.2. Linuxカーネルイメージの書き換え

Linuxカーネルイメージの書き換え方法を次に示します。

[armadillo ~]# mount /dev/mmcblk0p2 /mnt  
[armadillo ~]# cp uImage-a600-v4.14-at[version] /mnt/boot/uImage  
[armadillo ~]# umount /mnt

	eMMCの第2パーティションを/mnt/ディレクトリにマウントします。
	Linuxカーネルイメージを/mnt/boot/ディレクトリにコピーします。
	/mnt/ディレクトリにマウントしたeMMCの第2パーティションをアンマウントします。

11.2.3. DTBの書き換え

DTBの書き換え方法を次に示します。

[armadillo ~]# mount /dev/mmcblk0p2 /mnt  
[armadillo ~]# cp armadillo-610-extboard-eva-grove-v4.14-at[version].dtb /mnt/boot/a610.dtb  
[armadillo ~]# umount /mnt

eMMCの第2パーティションを/mnt/ディレクトリにマウントします。

DTBをa610.dtbにリネームして/mnt/boot/ディレクトリにコピーします。

LCD インターフェース(Armadillo-610 拡張ボード: CON11)を利用する場合は、 armadillo-610-extboard-eva-grove-v4.14-at[version].dtb の代わりに armadillo-610-extboard-eva-lcd-v4.14-at[version].dtb を使用してください。

/mnt/ディレクトリにマウントしたeMMCの第2パーティションをアンマウントします。

11.2.4. ルートファイルシステムの書き換え

eMMC上のルートファイルシステムを書き換えるには、SDブートを行う必要があります。ブートディスクの作成方法やSDブートの実行方法ついては14章SDブートの活用を参照してください。

SDブートしたArmadilloで、eMMC上のルートファイルシステムを書き換える手順を次に示します。

Debian GNU/LinuxルートファイルシステムアーカイブをArmadilloにコピーします。例としてUSBメモリを利用する方法を記載します。

ATDEにあるDebian GNU/LinuxルートファイルシステムアーカイブをUSBメモリの第1パーティションにコピーするには次のコマンドを実行します。

[ATDE ~]$ sudo umount /dev/sdb1  
[ATDE ~]$ sudo mount /dev/sdb1 /media  
[ATDE ~]$ sudo cp debian-stretch-armhf-a600-[version].tar.gz /media  
[ATDE ~]$ sudo umount /media

	USBメモリ接続時に自動でUSBメモリの第1パーティションがマウントされることがあるため、一旦アンマウントします。
	USBメモリの第1パーティションを/media/ディレクトリにマウントします。
	ルートファイルシステムアーカイブを/media/ディレクトリ以下にコピーします。
	/media/ディレクトリにマウントしたUSBメモリの第1パーティションをアンマウントします。

USBメモリの第1パーティションにあるDebian GNU/LinuxルートファイルシステムアーカイブをArmadilloにコピーするには次のコマンドを実行します。

[armadillo ~]# mount /dev/sda1 /media  
[armadillo ~]# cp /media/debian-stretch-armhf-a600-[version].tar.gz .  
[armadillo ~]# umount /media

	USBメモリの第1パーティションを/media/ディレクトリにマウントします。
	ルートファイルシステムアーカイブをカレントディレクトリ以下にコピーします。
	/media/ディレクトリにマウントしたUSBメモリの第1パーティションをアンマウントします。

ルートファイルシステムをeMMCの第2パーティションに再構築します。

[armadillo ~]# mount -t ext4 /dev/mmcblk0p2 /mnt  
[armadillo ~]# cd /mnt
[armadillo ~]# ls | grep -v -E 'boot|lost\+found' | xargs rm -rf  
[armadillo ~]# cd -
[armadillo ~]# tar zxf debian-stretch-armhf-a600-[version].tar.gz -C /mnt  
[armadillo ~]# umount /mnt

	eMMCの第2パーティションを/mnt/ディレクトリにマウントします。
	eMMCの第2パーティションのboot、lost+foundディレクトリ以外のファイル・ディレクトリを削除します。
	ルートファイルシステムアーカイブを/mnt/ディレクトリに展開します。
	/mnt/ディレクトリにマウントしたeMMCの第2パーティションをアンマウントします。


第10章ビルド手順	PDF version	第12章開発の基本的な流れ