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

Armadillo-IoT G3L は工場出荷状態で、動作確認に必要な全てのソフトウェアが書き込まれています。 しかし、ソフトウェアはセキュリティアップデートや新機能の追加によって随時アップデートを実施しているため、 開発、評価を行う際は最新バージョンのソフトウェアを利用いただくことを推奨します。

本章では Armadillo のソフトウェアを最新の状態に更新する方法と、ソフトウェアを初期化する方法を説明します。

本章で使用する最新版のブートローダーイメージやLinuxカーネルイメージなどは、"Armadillo サイト"からダウンロードすることができます。

6.1. ソフトウェアを最新の状態に更新する

工場出荷状態のArmadilloに書き込まれているイメージファイルは、最新版ではない可能性があります。本章では Armadillo のソフトウェアを最新の状態に更新する方法を説明します。

ソフトウェアと書き込み先の対応を次に示します。ソフトウェアは、予めArmadillo上にダウンロードしてください。

表6.1 ソフトウェアと書き込み先の対応

名称

ファイル名

ストレージ

デバイスファイル

ブートローダーイメージ

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  1
[armadillo ~]# cp uImage-x1-[version] /mnt/uImage  2
[armadillo ~]# umount /mnt  3

1

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

2

Linuxカーネルイメージを/mnt/ディレクトリにコピーします。

3

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

6.1.3. DTBの更新

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

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

1

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

2

DTBを/mnt/ディレクトリにコピーします。

3

/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上のルートファイルシステムを書き換える

  1. eMMCをルートファイルシステムとしている場合、マウントしているルートファイルシステム自体の書き換えはできません。このため、今回は例としてSD ブートディスクから起動し書き換えを行います。ブートディスクの作成方法やSDブートの実行方法ついては15章SDブートの活用を参照してください。

  2. Debian GNU/Linuxルートファイルシステムアーカイブを準備しておきます。

    [armadillo ~]# ls
    debian-bookworm-armhf_aiotg3l_[version].tar.gz
  3. ルートファイルシステムをeMMCの第2パーティションに再構築します。

    [armadillo ~]# mkfs.ext4 /dev/mmcblk2p2  1
    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  2
    ...[省略]...
    
    [armadillo ~]# mount -t ext4 /dev/mmcblk2p2 /mnt  3
    [armadillo ~]# tar zxf debian-bookworm-armhf_aiotg3l_[version].tar.gz -C /mnt  4
    [armadillo ~]# umount /mnt  5

    1

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

    2

    y に続きENTERを入力します。

    3

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

    4

    ルートファイルシステムアーカイブを/mnt/ディレクトリに展開します。

    5

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

  4. Armadillo-IoT G3Lの内蔵ストレージ(eMMC及びQSPIフラッシュメモリ)から起動するために、次のようにコマンドを実行しArmadilloを終了させます。「System halted.」と表示されたのを確認してから電源を切断します。

    [armadillo ~]# halt
  5. JP1をオープンにしてから、電源を投入してください。

  6. 次のように"boot"コマンドを実行すると、書き換えたルートファイルシステムで起動します。必要に応じて「Debian パッケージのアップデート」を行ってください。

    => boot

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

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

[警告]

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

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

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

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

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

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

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

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

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

    [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]$ 
  2. ツールの使用方法を確認します。 詳細な使用方法はインストールディスクイメージ作成ツールの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章ビルド手順でビルドしたファイルを使用することも可能です。

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

    [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]$ 
  4. ツールの実行が終了すると、インストールディスクイメージが作成されていることを確認できます。

    [PC ~/make_install_disk_image]$ ls install_disk_sd_*.img
    install_disk_sd_[version]_[model].img

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

  1. 512 MB以上のmicroSDカードを用意してください。

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

  3. 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
  4. 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. インストールの実行

  1. 電源が切断されていることを確認します。接続されていた場合は、電源を切断してください。

  2. USBシリアル変換アダプタをArmadillo-IoTから切断します。USBシリアル変換アダプタを接続した状態でインストールを実行したい場合は、スライドスイッチを図4.19「スライドスイッチの設定」の 2 側(オートブートモード)に設定してください。

  3. インストールディスクを使用してSDブートを行います。microSDスロット(メインユニットCON12)にインストールディスクを接続し、JP1をショートに設定してください。

  4. Armadillo に電源を投入します。Armadilloが起動するとインストールが始まり、自動的にeMMCとQSPIが書き換えられます。インストールの実行中は電源を切断しないでください。

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

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

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

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