第6章ソフトウェアの更新と初期化

名称	ファイル名	ストレージ	デバイスファイル
ブートローダーイメージ	u-boot-x1-`[version]`.bin	eMMC(ブートパーティション), SPIフラッシュメモリ	/dev/mmcblk2boot0, /dev/mtdblock0
Linuxカーネルイメージ	uImage-x1-`[version]`	eMMC	/dev/mmcblk2p1
Device Tree Blob	armadillo_iotg_g3l-`[version]`.dtb		/dev/mmcblk2p1
Debian GNU/Linuxルートファイルシステム	debian-bookworm-armhf_aiotg3l_`[version]`.tar.gz		/dev/mmcblk2p2

6.1.1. ブートローダーイメージの更新

ブートローダーイメージの更新方法を次に示します。

[armadillo ~]$ x1-bootloader-install u-boot-x1-[version].bin
Erasing /dev/mmcblk2boot0....done
Writing u-boot-x1.bin to /dev/mmcblk2boot0....done

6.1.2. Linuxカーネルイメージの更新

Linuxカーネルイメージの更新方法を次に示します。

[armadillo ~]# mount -t vfat /dev/mmcblk2p1 /mnt  
[armadillo ~]# cp uImage-x1-[version] /mnt/uImage  
[armadillo ~]# umount /mnt

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

6.1.3. DTBの更新

DTBの更新方法を次に示します。

[armadillo ~]# mount -t vfat /dev/mmcblk2p1 /mnt  
[armadillo ~]# cp armadillo_iotg_g3l-[version].dtb /mnt/armadillo_iotg_g3l.dtb  
[armadillo ~]# umount /mnt

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

6.1.4. Debian GNU/Linux ルートファイルシステムの更新

Debian GNU/Linux ルートファイルシステムを更新する方法は2つあります。Debian パッケージをアップデートする方法と、ルートファイルシステムをすべて書き換える方法です。

Debian パッケージのセキュリティアップデートやバグフィックスをArmadilloに適用したい場合は「Debian パッケージのアップデート」を行ってください。 Armadillo上のルートファイルシステムを工場出荷時相当に書き換えたい場合は「ルートファイルシステムの書き換え」を行ってください。

6.1.4.1. Debian パッケージのアップデート

apt-get コマンドを使用して Debian パッケージのアップデートを行います。apt-get update でローカルに持っているパッケージのリストを最新のものに更新し、apt-get upgrade で更新可能なパッケージをすべてインストールします。

apt-get コマンドを使用するには、ネットワーク（インターネット）に接続されている必要があります。ネットワークの設定方法については「ネットワーク」を参照してください。

[armadillo ~]# apt-get update
[armadillo ~]# apt-get upgrade

図6.1 Debian パッケージのアップデート

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

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

手順6.1 eMMC上のルートファイルシステムを書き換える

eMMCをルートファイルシステムとしている場合、マウントしているルートファイルシステム自体の書き換えはできません。このため、今回は例としてSD ブートディスクから起動し書き換えを行います。ブートディスクの作成方法やSDブートの実行方法ついては15章SDブートの活用を参照してください。
Debian GNU/Linuxルートファイルシステムアーカイブを準備しておきます。
```
[armadillo ~]# ls
debian-bookworm-armhf_aiotg3l_[version].tar.gz
```

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

[armadillo ~]# mkfs.ext4 /dev/mmcblk2p2  
mke2fs 1.42.12 (29-Aug-2014)
/dev/mmcblk2p2 contains a ext4 file system
	last mounted on /root on Thu Jan  1 09:00:07 1970
Proceed anyway? (y,n) y  
...[省略]...

[armadillo ~]# mount -t ext4 /dev/mmcblk2p2 /mnt  
[armadillo ~]# tar zxf debian-bookworm-armhf_aiotg3l_[version].tar.gz -C /mnt  
[armadillo ~]# umount /mnt

	eMMCの第2パーティションのファイルシステムを再構築します。
	y に続きENTERを入力します。
	eMMCの第2パーティションを`/mnt/`ディレクトリにマウントします。
	ルートファイルシステムアーカイブを`/mnt/`ディレクトリに展開します。
	`/mnt/`ディレクトリにマウントしたeMMCの第2パーティションをアンマウントします。

Armadillo-IoT G3Lの内蔵ストレージ(eMMC及びQSPIフラッシュメモリ)から起動するために、次のようにコマンドを実行しArmadilloを終了させます。「System halted.」と表示されたのを確認してから電源を切断します。
```
[armadillo ~]# halt
```
JP1をオープンにしてから、電源を投入してください。
次のように"boot"コマンドを実行すると、書き換えたルートファイルシステムで起動します。必要に応じて「Debian パッケージのアップデート」を行ってください。
```
=> boot
```

6.2. ソフトウェアを初期化する

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

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

特定のイメージのみ書き換えたい場合には「ソフトウェアを最新の状態に更新する」を参照してください。

インストールディスクの作成には、SDカードに書き込むためのインストールディスクイメージが必要です。

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

ファイル	ファイル名
インストールディスクイメージ	install_disk_sd_`[version]`_iotg3l.img

6.2.1. インストールディスクイメージの作成

ここでは、インストールディスクイメージ作成ツールを使用し、インストールディスクイメージを作成する方法を示します。

インストールディスクイメージはATDEで作成します。インストールディスクイメージ作成ツールを、以下の手順に従い実行してください

必要なパッケージのインストール及び展開を行います。

[PC ~]$ sudo apt-get update && sudo apt-get install u-boot-tools
[PC ~]$ tar xf make_install_disk_image-[version].tar.gz
[PC ~]$ cd make_install_disk_image
[PC ~/make_install_disk_image]$

ツールの使用方法を確認します。詳細な使用方法はインストールディスクイメージ作成ツールのREADMEをご確認ください。

[PC ~/make_install_disk_image]$ sudo ./build.sh
Install Disk Image Build Script v1.4.0

Usage:
  sudo ./build.sh BOARD UBOOT KERNEL DTB USERLAND [BOOTSCR]
  sudo ./build.sh -f CONFIG_FILE
  sudo ./build.sh -r BOARD UBOOT KERNEL DTB USERLAND RECOVERY RECOVERY_DTB RECOVERY_BOOTSCR [BOOTSCR]

  -f: use config file
  -r: use Recovery image

  BOARD: x1/iotg3/iotg3_m1/iotg3_w2/iotg3l/degugw_iotg3_m1
  UBOOT: u-boot image
  KERNEL: uImage
  DTB: Device Tree Blob image
  USERLAND: Debian userland archive
  RECOVERY: Recovery uImage
  RECOVERY_DTB: Recovery Device Tree Blob image
  RECOVERY_BOOTSCR: Recovery u-boot script
  BOOTSCR: u-boot script

ツールで指定する引数と、インストールディスクイメージの作成に必要なファイルの対応を次に示します。

表6.3 イメージファイルと引数の対応

引数	説明	ファイル名称
BOARD	iotg3l を指定	-
UBOOT	ブートローダーイメージ	u-boot-x1-`[version]`.bin
KERNEL	Linuxカーネルイメージ	uImage-x1-`[version]`
DTB	Device Tree Blob	armadillo_iotg_g3l-`[version]`.dtb
USERLAND	Debian GNU/Linuxルートファイルシステム	debian-bookworm-armhf_aiotg3l_`[version]`.tar.gz
RECOVERY	node-eye リカバリー用 Linux カーネルイメージ ^[a]	uImage.recovery
RECOVERY_DTB	node-eye リカバリー用 Device Tree Blob^[a]	armadillo_iotg_g3l.dtb.recovery
RECOVERY_BOOTSCR	node-eye リカバリー用 U-Boot ブートスクリプト^[a]	boot.scr.recovery
BOOTSCR	U-Bootブートスクリプト (オプション)	boot.scr
^[a]-f オプションでリカバリーイメージを書き込む場合または -r オプションを使用する場合は必須です。

これらのファイルは、Armadillo サイトでダウンロードすることができるほか、11章ビルド手順でビルドしたファイルを使用することも可能です。

使用するイメージを指定し、インストールディスクイメージを作成します。

[PC ~/make_install_disk_image]$ sudo ./build.sh iotg3l u-boot-x1-[version].bin uImage-x1-[version] armadillo_iotg_g3l-[version].dtb debian-bookworm-armhf_aiotg3l_[version].tar.gz
Image Name:
Created:      Wed Feb 21 20:44:32 2024
Image Type:   ARM Linux Script (uncompressed)
Data Size:    167 Bytes = 0.16 KiB = 0.00 MiB
Load Address: 00000000
Entry Point:  00000000
Contents:
   Image 0: 159 Bytes = 0.16 KiB = 0.00 MiB
0+0 records in
0+0 records out
0 bytes copied, 0.000167513 s, 0.0 kB/s
Checking that no-one is using this disk right now ... OK

Disk /dev/loop0: 450 MiB, 471859200 bytes, 921600 sectors
Units: sectors of 1 * 512 = 512 bytes
Sector size (logical/physical): 512 bytes / 512 bytes
I/O size (minimum/optimal): 512 bytes / 512 bytes

>>> Created a new DOS (MBR) disklabel with disk identifier 0x2a309517.
/dev/loop0p1: Created a new partition 1 of type 'W95 FAT32' and of size 14 MiB.
/dev/loop0p2: Created a new partition 2 of type 'Linux' and of size 435 MiB.
/dev/loop0p3: Done.

New situation:
Disklabel type: dos
Disk identifier: 0x2a309517

Device       Boot Start    End Sectors  Size Id Type
/dev/loop0p1       2048  30719   28672   14M  b W95 FAT32
/dev/loop0p2      30720 921599  890880  435M 83 Linux

The partition table has been altered.
Calling ioctl() to re-read partition table.
Syncing disks.
mkfs.fat 4.2 (2021-01-31)
mke2fs 1.47.0 (5-Feb-2023)
Discarding device blocks: done
Creating filesystem with 445440 1k blocks and 111320 inodes
Filesystem UUID: 56eb675a-b81f-4571-b14c-0e3b77b731e7
Superblock backups stored on blocks:
    8193, 24577, 40961, 57345, 73729, 204801, 221185, 401409

Allocating group tables: done
Writing inode tables: done
Creating journal (8192 blocks): done
Writing superblocks and filesystem accounting information: done

368+1 records in
368+1 records out
377288 bytes (377 kB, 368 KiB) copied, 0.00677961 s, 55.7 MB/s
[PC ~/make_install_disk_image]$

ツールの実行が終了すると、インストールディスクイメージが作成されていることを確認できます。
```
[PC ~/make_install_disk_image]$ ls install_disk_sd_*.img
install_disk_sd_[version]_[model].img
```

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

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

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

[PC ~]$ 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)
[PC ~]$ sudo umount /dev/sdb1

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

[PC ~]$ sudo dd if=install_disk_sd_[version].img of=/dev/sdb bs=4M conv=fsync
94+1 レコード入力
94+1 レコード出力
397410304 バイト (397 MB) コピーされました、 45.8441 秒、 8.7 MB/秒

6.2.3. インストールの実行

電源が切断されていることを確認します。接続されていた場合は、電源を切断してください。
USBシリアル変換アダプタをArmadillo-IoTから切断します。USBシリアル変換アダプタを接続した状態でインストールを実行したい場合は、スライドスイッチを図4.24「スライドスイッチの設定」の 2 側（オートブートモード）に設定してください。
インストールディスクを使用してSDブートを行います。microSDスロット(メインユニットCON12)にインストールディスクを接続し、JP1をショートに設定してください。
Armadillo に電源を投入します。Armadilloが起動するとインストールが始まり、自動的にeMMCとQSPIが書き換えられます。インストールの実行中は電源を切断しないでください。

インストールの進捗状況はユーザーLEDで確認することができます。インストールの進捗状況とユーザーLEDの状態を次に示します。ユーザーLEDの位置については図7.48「ユーザーLEDの位置」を参照してください。

表6.4 インストールの進捗状況とユーザーLEDの状態

インストールの進捗	ユーザーLED4	ユーザーLED3	ユーザーLED5
起動中	点灯	消灯	消灯
実行中	点灯	間欠点灯	消灯
正常終了	点灯	点灯	点灯
異常終了	間欠点灯	間欠点灯	間欠点灯

インストールが終了したら、電源を切断し、JP1をオープンに設定してください。


第5章起動と終了	PDF version	第7章動作確認方法