ブートローダー (U-Boot) 仕様

U-Boot はブートローダーなので、OS を起動するのが仕事です。しかし OS を起動する以外にも、いろいろと便利な機能が U-Boot には備わっています。

Armadillo-640 の U-Boot には 2つの起動モードがあります。「保守モード」と「オートブートモード」です。 Armadillo-640 に接続している USBシリアル変換アダプターのスライドスイッチによって、モードを切り替えることができます。 Armadillo-400シリーズの Hermit にもあった機能です。このモード切り換えは、 GPIO によって実現しています。 U-Boot 本家にはまだマージされておらず、 Armadillo-640 用の U-Boot に独自実装されている機能です。

ブートローダーが起動すると、USBシリアル変換アダプタのスライドスイッチの状態により、2つのモードのどちらかに遷移します。USBシリアル変換アダプタのスライドスイッチの詳細については、「スライドスイッチの設定について」を参照してください。

	USBシリアル変換アダプタが未接続の場合オートブートモードとなり、Linuxが起動します。

U-Boot が起動すると、U-Boot のバージョンや、ビルド時間、CPUの情報、DRAMのサイズなどボード情報が表示されます。

U-Boot 2018.03-at1 (Apr 04 2018 - 12:12:16 +0900)

CPU:   Freescale i.MX6ULL rev1.0 at 396 MHz
Reset cause: POR
DRAM:  512 MiB
MMC:   FSL_SDHC: 0, FSL_SDHC: 1
Loading Environment from MMC... OK
In:    serial
Out:   serial
Err:   serial
Net:   FEC
=>

⇒ が U-Boot のプロンプトです。プロンプトが出るのは保守モードの時だけです。Armadillo-640 では U-Boot のプロンプトが表示され、コマンド入力を受け付ける状態を「保守モード」と呼んでいます。

U-Boot の 機能を使うには U-Boot のコマンドプロンプトからコマンドを入力します。コマンドプロンプトは保守モードにすることで表示されます。

U-Bootの保守モードでは、U-Bootのバージョン番号を表示したり、あるメモリアドレスの値を表示したり Linuxカーネルの起動オプションの設定などを行うことができます。保守モードで利用できる有用なコマンドは、プロンプトで help と入力すると表示されます。

=> help
?       - alias for 'help'
base    - print or set address offset
bdinfo  - print Board Info structure
boot    - boot default, i.e., run 'bootcmd'
bootd   - boot default, i.e., run 'bootcmd'
bootefi - Boots an EFI payload from memory
bootm   - boot application image from memory
bootp   - boot image via network using BOOTP/TFTP protocol
clocks  - display clocks
cmp     - memory compare
config  - print .config
cp      - memory copy
crc32   - checksum calculation
dcache  - enable or disable data cache
dhcp    - boot image via network using DHCP/TFTP protocol
echo    - echo args to console
editenv - edit environment variable
env     - environment handling commands
ext2load- load binary file from a Ext2 filesystem
ext2ls  - list files in a directory (default /)
ext4load- load binary file from a Ext4 filesystem
ext4ls  - list files in a directory (default /)
ext4size- determine a file's size
ext4write- create a file in the root directory
fatinfo - print information about filesystem
fatload - load binary file from a dos filesystem
fatls   - list files in a directory (default /)
fatsize - determine a file's size
fdt     - flattened device tree utility commands
fstype  - Look up a filesystem type
fsuuid  - Look up a filesystem UUID
fuse    - Fuse sub-system
grepenv - search environment variables
help    - print command description/usage
icache  - enable or disable instruction cache
load    - load binary file from a filesystem
loadb   - load binary file over serial line (kermit mode)
loads   - load S-Record file over serial line
loadx   - load binary file over serial line (xmodem mode)
loady   - load binary file over serial line (ymodem mode)
loop    - infinite loop on address range
loopw   - infinite write loop on address range
ls      - list files in a directory (default /)
md      - memory display
md5sum  - compute MD5 message digest
meminfo - display memory information
mm      - memory modify (auto-incrementing address)
mmc     - MMC sub system
mmcinfo - display MMC info
mw      - memory write (fill)
nm      - memory modify (constant address)
part    - disk partition related commands
ping    - send ICMP ECHO_REQUEST to network host
printenv- print environment variables
reset   - Perform RESET of the CPU
run     - run commands in an environment variable
save    - save file to a filesystem
saveenv - save environment variables to persistent storage
setenv  - set environment variables
sha1sum - compute SHA1 message digest
size    - determine a file's size
strings - display strings
tftpboot- boot image via network using TFTP protocol
usb     - USB sub-system
version - print monitor, compiler and linker version
=>

各コマンドのヘルプを表示するにはU-Bootコマンドのヘルプを表示のようにします。

=> help [コマンド]

良く使うと思われるコマンドを以下で説明します。

help で表示されるコマンドには、Git のようにサブコマンドを持つものがあります。 env や usb などがそうです。 help env とすることで、 指定したコマンドのサブコマンドが表示されます。

=> help env
env - environment handling commands

Usage:
env default [-f] -a - [forcibly] reset default environment
env default [-f] var [...] - [forcibly] reset variable(s) to their default values
env delete [-f] var [...] - [forcibly] delete variable(s)
env edit name - edit environment variable
env exists name - tests for existence of variable
env export [-t | -b | -c] [-s size] addr [var ...] - export environment
env grep [-e] [-n | -v | -b] string [...] - search environment
env import [-d] [-t [-r] | -b | -c] addr [size] - import environment
env print [-a | name ...] - print environment
env run var [...] - run commands in an environment variable
env save - save environment
env set [-f] name [arg ...]

=>

=> mmc
mmc - MMC sub system

Usage:
mmc info - display info of the current MMC device
mmc read addr blk# cnt
mmc write addr blk# cnt
mmc erase blk# cnt
mmc rescan
mmc part - lists available partition on current mmc device
mmc dev [dev] [part] - show or set current mmc device [partition]
mmc list - lists available devices
mmc hwpartition [args...] - does hardware partitioning
  arguments (sizes in 512-byte blocks):
    [user [enh start cnt] [wrrel {on|off}]] - sets user data area attributes
    [gp1|gp2|gp3|gp4 cnt [enh] [wrrel {on|off}]] - general purpose partition
    [check|set|complete] - mode, complete set partitioning completed
  WARNING: Partitioning is a write-once setting once it is set to complete.
  Power cycling is required to initialize partitions after set to complete.
mmc setdsr <value> - set DSR register value

=>

U-Boot は、環境変数を持つことができます。デフォルトの環境変数は、U-Boot をビルドした時に値が決定します。実行に環境変数を変更したり、変更した環境変数を保存したりすることも可能です。

env print コマンドで、現在設定されているすべての環境変数を表示できます。

=> env print
baudrate=115200
bootargs=root=/dev/mmcblk0p2 rootwait
bootcmd=ext4load mmc 0:2 ${loadaddr} /boot/uImage; ext4load mmc 0:2 0x83000000 /
boot/a640.dtb; bootm ${loadaddr} - 0x83000000;
bootdelay=0
ethact=FEC
ethaddr=00:11:0c:00:07:90
loadaddr=0x82000000
stderr=serial
stdin=serial
stdout=serial
tftpboot=tftpboot uImage; tftpboot 0x83000000 a640.dtb; bootm ${loadaddr} - 0x83
000000;

Environment size: 402/524284 bytes
=>

または env print コマンドで変数を指定すると、その変数の値だけを表示することも可能です。

=> env print loadaddr
loadaddr=0x82000000
=>

新しく変数を追加したり、すでに設定されている値を変更するには env set を使います。

=> env set hello world
=> env print hello
hello=world
=> env set hello a640
=> env print hello
hello=a640
=>

不要な変数を削除するには env delete を使います。

=> env delete hello
=> env print hello
## Error: "hello" not defined
=>

環境変数を保存するには env save コマンドを使います。

=> env set hello a640
=> env save
Saving Environment to MMC... Writing to MMC(0)... OK
=>

....電源入れなおし....

U-Boot 2018.03-at1 (Apr 04 2018 - 12:12:16 +0900)

CPU:   Freescale i.MX6ULL rev1.0 at 396 MHz
Reset cause: POR
DRAM:  512 MiB
MMC:   FSL_SDHC: 0, FSL_SDHC: 1
Loading Environment from MMC... OK
In:    serial
Out:   serial
Err:   serial
Net:   FEC
=> env print hello
hello=a640
=>

表示された文字からも分るように、Armadillo-640では環境変数を MMC の 0番、つまりオンボード eMMC に保存します。U-Boot の環境変数が保存される場所は、オンボード eMMC の先頭から 512 KByte オフセットです。eMMC の 1 MByte オフセットから第1パーティションが始まっているので、環境変数を保存できるのは 512 KByte になります。 eMMC のアドレスマップについては 表3.4「eMMCメモリマップ」 を参照してください。

環境変数をデフォルト値に戻したい場合は env default コマンドを使います。

=> env print bootdelay
bootdelay=0
=> env set bootdelay 1
=> env print bootdelay
bootdelay=1
=> env default bootdelay
=> env print bootdelay
bootdelay=0
=>

もし、すべての環境変数をデフォルト値に戻したい場合は、 オプション -a を付けてください。

=> env default -a
## Resetting to default environment
=>

	特定の変数は、値を変更するタイミングで U-Boot の関数が実行されます。環境変数 baudrate もそのうちの1つです。つまり値が変更されるだけでなく、実際にボーレートが変更されます。 他にも値の変更できなくなっていたり、変更回数が決まっているものもあります。環境変数 ethaddr もその1つです。それらの変数は、変更する必要はあまり無いと思いますが、もし変更する場合には U-Boot のマニュアルを参照してください。

U-Boot は、 boot コマンドによって、OS を起動します。 boot コマンドは、 環境変数 bootcmd に登録されているコマンドを実行するコマンドです。つまり run bootcmd と同じ意味です。

=> env print loadaddr
loadaddr=0x82000000
=> env print bootcmd
bootcmd=ext4load mmc 0:2 ${loadaddr} /boot/uImage; ext4load mmc 0:2 0x83000000 /boot/a640.dtb; bootm ${loadaddr} - 0x83000000;
=> run bootcmd
3345800 bytes read in 127 ms (25.1 MiB/s)
23185 bytes read in 54 ms (418.9 KiB/s)
## Booting kernel from Legacy Image at 82000000 ...
   Image Name:   Linux-4.14-at1
   Image Type:   ARM Linux Kernel Image (uncompressed)
   Data Size:    3345736 Bytes = 3.2 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 9eeff000, end 9ef07a90 ... OK

Starting kernel ...

環境変数 bootcmd には複数のコマンドが ; で区切られて並んでいます。 U-Boot の run コマンドは、並んでいるコマンドを順次実行していきます。

bootcmd=ext4load mmc 0:2 ${loadaddr} /boot/uImage; ext4load mmc 0:2 0x83000000 /boot/a640.dtb; bootm ${loadaddr} - 0x83000000;

最初のコマンドは ext4load です。このコマンドは、指定された mmc タイプの 0 番目のデバイスにある、 2 番目パーティションにアクセスし /boot/uImage を、環境変数 loadaddr で指定されているメモリアドレスにロードします。コマンドで環境変数を参照するには、変数を ${…} でくくります。出荷状態では、オンボード eMMC の第2パーティションが EXT4 でフォーマットされており、 /boot/ ディレクトリに uImage というファイル名で Linux カーネルが配置されています。つまり最初のコマンドは、Linux カーネルをメモリにロードしているわけです。

=> help ext4load
ext4load - load binary file from a Ext4 filesystem

Usage:
ext4load <interface> [<dev[:part]> [addr [filename [bytes [pos]]]]]
    - load binary file 'filename' from 'dev' on 'interface'
      to address 'addr' from ext4 filesystem
=>

同じコマンドを U-Boot のプロンプトで手で実行しても、同じ動作結果になります。コマンドを1つだけ入力するときは ; を付けても付けなくても問題ありません。

=> ext4load mmc 0:2 ${loadaddr} /boot/uImage
3345800 bytes read in 128 ms (24.9 MiB/s)
=>

	Armadillo-640 では 512 MByte (0x20000000) の DRAM が 0x80000000 から 0xA0000000 までマップされています。この情報は bdinfo コマンドで確認することができます。

次のコマンドも同じく ext4load で、 a640.dtb ファイルをメモリアドレス 0x83000000 にロードしている事が分ります。このファイルは「Device Tree Blob (dtb)」というもので、ボードのデバイス情報が記録されています。最近の Linuxカーネルでは必須のファイルです。このファイルのロードアドレスは、 uImage と異なり変数になっておらず値 (0x83000000) がそのまま記載されています。ファイルがある場所は、 uImage と同じくオンボード eMMC の第2パーティションで /boot/ です。

=> ext4load mmc 0:2 0x83000000 /boot/a640.dtb
23185 bytes read in 54 ms (418.9 KiB/s)
=>

これで、Linuxを起動するために必要なファイル 2つ (uImage と a640.dtb) をメモリに配置することができました。次のコマンド bootm で実際に Linux をブートします。 bootm コマンドは、引数に 3つのアドレスを取ります。

bootm ${loadaddr} - 0x83000000

1つ目が、Linuxカーネルを置いたアドレス (${loadaddr} == 0x82000000)、2つ目が initrd のアドレスですが Armadillo-640 では使用してないので - を書きます。3つ目が Device Tree Blob を置いたアドレス (0x83000000) です。 U-Boot は Linux 以外も起動することができるので、 bootm のヘルプでは Linuxカーネルを "Application image" と記載しています。

=> help bootm
bootm - boot application image from memory

Usage:
bootm [addr [arg ...]]
    - boot application image stored in memory
        passing arguments 'arg ...'; when booting a Linux kernel,
        'arg' can be the address of an initrd image
        When booting a Linux kernel which requires a flat device-tree
        a third argument is required which is the address of the
        device-tree blob. To boot that kernel without an initrd image,
        use a '-' for the second argument. If you do not pass a third
        a bd_info struct will be passed instead
   :
   :
=>

実際に bootm コマンドを使って Linux を起動してみます。ここではあえて loadaddr ではなく 0x82000000 を入力してみます。

=> bootm 0x82000000 - 0x83000000
## Booting kernel from Legacy Image at 82000000 ...
   Image Name:   Linux-4.14-at1
   Image Type:   ARM Linux Kernel Image (uncompressed)
   Data Size:    3345736 Bytes = 3.2 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 9eeff000, end 9ef07a90 ... OK

Starting kernel ...

このように、手で入力しても手順さえ間違わなければ、Linux を起動することができます。もちろん uImage の場所やファイル名を変更しても、 U-Boot で正しく指定すれば同様に動作します。

起動コマンドから分るように Armadillo-640 では、オンボード eMMC が 0 番目の mmc タイプのデバイスです。これは mmc list コマンドでも確認できます。

=> mmc list
FSL_SDHC: 0 (eMMC)
FSL_SDHC: 1

mmc タイプのデバイス情報は mmc info コマンドで表示できます。 mmc info コマンドは、引数でどのデバイスかを指定するのではなく、事前に mmc dev コマンドで使うデバイスを指定しておく必要があります。

=> mmc dev
switch to partitions #0, OK
mmc0(part 0) is current device

mmc dev コマンドでデバイス番号を指定しないと、現在指定されているデバイスを表示します。

=> mmc info
Device: FSL_SDHC
Manufacturer ID: 13
OEM: 14e
Name: Q2J55
Bus Speed: 52000000
Mode : MMC High Speed (52MHz)
Rd Block Len: 512
MMC version 5.0
High Capacity: Yes
Capacity: 3.5 GiB
Bus Width: 8-bit
Erase Group Size: 512 KiB
HC WP Group Size: 8 MiB
User Capacity: 3.5 GiB ENH WRREL
User Enhanced Start: 0 Bytes
User Enhanced Size: 3.5 GiB
Boot Capacity: 2 MiB ENH
RPMB Capacity: 4 MiB ENH
GP1 Capacity: 8 MiB ENH WRREL
GP2 Capacity: 8 MiB ENH WRREL
GP3 Capacity: 8 MiB ENH WRREL
GP4 Capacity: 8 MiB ENH WRREL

これが、オンボード eMMC の情報です。次に 1番目のデバイスを指定してみます。

=> mmc dev 1
switch to partitions #0, OK
mmc1 is current device
=> mmc info
Device: FSL_SDHC
Manufacturer ID: 2
OEM: 544d
Name: SA08G
Bus Speed: 50000000
Mode : SD High Speed (50MHz)
Rd Block Len: 512
SD version 3.0
High Capacity: Yes
Capacity: 7.2 GiB
Bus Width: 4-bit
Erase Group Size: 512 Bytes
=>

microSDカードが装着されていれば、上記のように表示されます。カードの種類によって表示される値は異なります。もし SDカードに入れている Linux カーネルを起動する場合は、先の ext4load コマンドでデバイス 1 を指定すれば良いことが分ります。

=> ext4load mmc 1:1 ${loadaddr} /boot/uImage

上記の例は、 microSD の 1番目のパーティションにある /boot/uImage をロードする例です。

Linuxカーネルは、ブートローダーから「カーネルパラメーター」と呼ばれる起動オプションを受けとる事ができます。U-Boot では 環境変数 bootargs に入っている文字列を Linux に渡します。

Armadillo-640 では bootargs の値は setup_mmcargs 変数の内部で一旦setenvすることで以下のように設定しています

setup_mmcargs=setenv bootargs root=/dev/mmcblk0p2 rootwait ${optargs};

この文字列で、ルートファイルシステムが /dev/mmcblk0p2 であり、mmcblk0 がみつかるまで待つ (rootwait) ように指示しています。 前述の通り Armadillo-640 では オンボード eMMC が 0 番目の MMCデバイスです。Armadillo-640 の初期出荷時に、オンボード eMMCの第2パーティションに Debian をインストールして出荷しているので 「オンボード eMMC、つまり 0番目の MMM の第2パーティション」を表わす /dev/mmcblk0p2 を指定しています。

もし microSDカードに、Debian を構築し、そのパーティションをルートファイルシステムとして指定したい場合、

=> setenv setup_mmcargs setenv bootargs root=/dev/mmcblk1p1 rootwait ${optargs};

としてください。 前述の通り microSD は 1番目の MMCデバイスなので root=/dev/mmcblk1p1 で microSD の第1パーティションという意味になります。

	bootargs と setup_mmcargs に関する仕様は v2018.03-at3 から変更しています。at2を利用する場合は、以前の製品マニュアルをご覧ください。

	Linuxカーネル起動オプション Linuxカーネルには様々な起動オプションがあります。詳しくは、Linuxの解説書や、Linuxカーネルのソースコードに含まれているドキュメント (Documentation/kernel-parameters.txt) を参照してください。