第7章ビルド手順

第7章ビルド手順

7.1. Linuxカーネル/ユーザーランドをビルドする
7.2. イメージをカスタマイズする
7.3. ユーザーランドイメージにアプリケーションを追加する
7.4. ブートローダーをビルドする

本章では、工場出荷イメージと同じイメージを作成する手順について説明します。

使用するソースコードは、開発セット付属のDVDに収録されています。最新版のソースコードは、Armadilloサイトからダウンロードすることができます。新機能の追加や不具合の修正などが行われているため、DVDに収録されているものよりも新しいバージョンがリリースされているかを確認して、最新バージョンのソースコードを利用することを推奨します。

開発作業では、基本ライブラリ・アプリケーションやシステム設定ファイルの作成・配置を行います。各ファイルは作業ディレクトリ配下で作成・配置作業を行いますが、作業ミスにより誤って作業用 PC 自体の OS を破壊しないために、すべての作業は root ユーザーではなく一般ユーザーで行ってください。

7.1. Linuxカーネル/ユーザーランドをビルドする

ここでは、「Atmark Dist」、「Linuxカーネル」のソースコードからイメージファイルを作成する手順を説明します。

手順7.1 Linuxカーネル/ユーザーランドをビルド

アーカイブの展開

各ソースコードアーカイブを展開します。

[ATDE ~]$ ls
atmark-dist-[version].tar.gz  linux-3.14-at[version].tar.gz
[ATDE ~]$ tar zxf atmark-dist-[version].tar.gz
[ATDE ~]$ tar zxf linux-3.14-at[version].tar.gz
[ATDE ~]$ ls
atmark-dist-[version]         linux-3.14-at[version]
atmark-dist-[version].tar.gz  linux-3.14-at[version].tar.gz

シンボリックリンクの作成
Atmark Distに、Linuxカーネルのシンボリックリンクを作成します。
```
[ATDE ~]$ cd atmark-dist-[version]
[ATDE ~/atmark-dist-[version]]$ ln -s ../linux-3.14-at[version] linux-3.x
```
以降のコマンド入力例では、各ファイルからバージョンを省略した表記を用います。
AWL13ドライバーの登録
この手順は、Armadillo-WLANモジュール(AWL13)を使用する場合にのみ必要です。
AWL13を使用するイメージを作成する場合は、カーネルソースの他に、AWL13用のデバイスドライバー(AWL13ドライバー)をAtmark-Distに登録する必要があります。
付属 DVD の AWL13ドライバーのソースアーカイブディレクトリ (source/awlan_driver) にある awl13-[version].tar.gzを作業ディレクトリに展開します。
展開後、Atmark-DistにAWL13ドライバーのソースを登録するため、シンボリックリンクを作成します。図7.1「ソースコード準備(AWL13ドライバー)」のように作業してください。
```
[ATDE ~]$ tar zxvf awl13-[version].tar.gz
[ATDE ~]$ ls
atmark-dist-[version].tar.gz  atmark-dist-[version]
linux-[version].tar.gz  linux-[version]
awl13-[version].tar.gz  awl13-[version]
[ATDE ~]$ cd atmark-dist
[ATDE ~/atmark-dist]$ ln -s ../awl13-[version] awl13
```
図7.1 ソースコード準備(AWL13ドライバー)

コンフィギュレーションの開始

コンフィギュレーションを開始します。ここでは、menuconfigを利用します。

[ATDE ~/atmark-dist]$ make menuconfig

 atmark-dist v1.45.0 Configuration
------------------------------------------------------------------------
                                Main Menu
  Arrow keys navigate the menu.  <Enter> selects submenus --->.
  Highlighted letters are hotkeys.  Pressing <Y> includes, <N> excludes,
  <M> modularizes features.  Press <Esc><Esc> to exit, <?> for Help.
  Legend: [*] built-in  [ ] excluded  <M> module  < > module capable
  --------------------------------------------------------------------
                Vendor/Product Selection  --->
                Kernel/Library/Defaults Selection  --->
                ---
                Load an Alternate Configuration File
                Save Configuration to an Alternate File


  --------------------------------------------------------------------

                    <Select>    < Exit >    < Help >

ベンダー/プロダクト名の選択

メニュー項目は、上下キーで移動することができます。下部のSelect/Exit/Helpは左右キーで移動することができます。選択するにはEnterキーを押下します。 "Vendor/Product Selection --->"に移動してEnterキーを押下します。 Vendorには "AtmarkTechno" を選択し、AtmarkTechno Productsには表7.1「プロダクト名一覧」から選択します。

表7.1 プロダクト名一覧

製品	プロダクト名	備考
Armadillo-420 ベーシックモデル	Armadillo-420	出荷時イメージ
Armadillo-420 WLANモデル(AWL13対応)	Armadillo-420.WLAN-AWL13	出荷時イメージ

 atmark-dist v1.45.0 Configuration
------------------------------------------------------------------------
                        Vendor/Product Selection
  Arrow keys navigate the menu.  <Enter> selects submenus --->.
  Highlighted letters are hotkeys.  Pressing <Y> includes, <N> excludes,
  <M> modularizes features.  Press <Esc><Esc> to exit, <?> for Help.
  Legend: [*] built-in  [ ] excluded  <M> module  < > module capable
  --------------------------------------------------------------------
                --- Select the Vendor you wish to target
                (AtmarkTechno) Vendor
                --- Select the Product you wish to target
                (Armadillo-420) AtmarkTechno Products


  --------------------------------------------------------------------

                    <Select>    < Exit >    < Help >

デフォルトコンフィギュレーションの適用

前のメニューに戻るには、"Exit"に移動してEnterキーを押下します。続いて、"Kernel/Library/Defaults Selection --->"に移動してEnterキーを押下します。"Default all settings (lose changes)"に移動して"Y"キーを押下します。押下すると"[*]"のように選択状態となります。

 atmark-dist v1.45.0 Configuration
------------------------------------------------------------------------
                    Kernel/Library/Defaults Selection
  Arrow keys navigate the menu.  <Enter> selects submenus --->.
  Highlighted letters are hotkeys.  Pressing <Y> includes, <N> excludes,
  <M> modularizes features.  Press <Esc><Esc> to exit, <?> for Help.
  Legend: [*] built-in  [ ] excluded  <M> module  < > module capable
  --------------------------------------------------------------------
             --- Kernel is linux-3.x
             (default) Cross-dev
             (None) Libc Version
             [*] Default all settings (lose changes) (NEW)
             [ ] Customize Kernel Settings (NEW)
             [ ] Customize Vendor/User Settings (NEW)
             [ ] Update Default Vendor Settings (NEW)

  --------------------------------------------------------------------

                    <Select>    < Exit >    < Help >

コンフィギュレーションの終了
前のメニューに戻るため、"Exit"に移動してEnterキーを押下します。コンフィギュレーションを抜けるためにもう一度"Exit"に移動してEnterキーを押下します。

コンフィギュレーションの確定

コンフィギュレーションを確定させるために"Yes"に移動してEnterキーを押下します。

 atmark-dist v1.45.0 Configuration
------------------------------------------------------------------------


        ----------------------------------------------------------
            Do you wish to save your new kernel configuration?

                            < Yes >      <  No  >

        ----------------------------------------------------------

ビルド
コンフィギュレーションが完了するので、続いてビルドを行います。ビルドは"make"コマンドを実行します。
```
[ATDE ~/atmark-dist]$ make
```
ビルドログが表示されます。ビルドするPCのスペックにもよりますが、数分から十数分程度かかります。
イメージファイルの生成確認
ビルドが終了すると、atmark-dist/images/ディレクトリ以下にイメージファイルが作成されています。Armadillo-400 シリーズでは圧縮済みのイメージ(拡張子が".gz"のもの)を利用します。
```
[ATDE ~/atmark-dist]$ ls images/
linux.bin  linux.bin.gz  romfs.img  romfs.img.gz
```

7.2. イメージをカスタマイズする

Atmark-Dist には、様々なアプリケーションやライブラリが含まれており、コンフィギュレーションによってそれらをイメージに含めたり、イメージから削除することができます。また、カーネルのコンフィギュレーションの変更を行うこともできます。

Atmark-Dist のコンフィギュレーションを変更するには、make menuconfig コマンドを使用します。

[ATDE ~/atmark-dist]$ make menuconfig

図7.2 Atmark-Dist のコンフィギュレーション

make menuconfigを実行すると、図7.3「menuconfig: Main Menu」に示すMain Menu画面が表示されます。

 atmark-dist v1.45.0 Configuration
------------------------------------------------------------------------
                                Main Menu
  Arrow keys navigate the menu.  <Enter> selects submenus --->.
  Highlighted letters are hotkeys.  Pressing <Y> includes, <N> excludes,
  <M> modularizes features.  Press <Esc><Esc> to exit, <?> for Help.
  Legend: [*] built-in  [ ] excluded  <M> module  < > module capable
  --------------------------------------------------------------------
                Vendor/Product Selection  --->
                Kernel/Library/Defaults Selection  --->
                ---
                Load an Alternate Configuration File
                Save Configuration to an Alternate File


  --------------------------------------------------------------------

                    <Select>    < Exit >    < Help >

図7.3 menuconfig: Main Menu

キーボードの上下キーでフォーカスをKernel/Library/Defaults Selection --->に合わせ、Enterキーを押すと、Kernel/Library/Defaults Selection画面が表示されます。

 atmark-dist v1.45.0 Configuration
------------------------------------------------------------------------
                    Kernel/Library/Defaults Selection
  Arrow keys navigate the menu.  <Enter> selects submenus --->.
  Highlighted letters are hotkeys.  Pressing <Y> includes, <N> excludes,
  <M> modularizes features.  Press <Esc><Esc> to exit, <?> for Help.
  Legend: [*] built-in  [ ] excluded  <M> module  < > module capable
  --------------------------------------------------------------------
             --- Kernel is linux-3.x
             (default) Cross-dev
             (None) Libc Version
             [ ] Default all settings (lose changes) (NEW)
             [*] Customize Kernel Settings (NEW)
             [*] Customize Vendor/User Settings (NEW)
             [ ] Update Default Vendor Settings (NEW)

  --------------------------------------------------------------------

                    <Select>    < Exit >    < Help >

図7.4 menuconfig: Kernel/Library/Defaults Selection

カーネルコンフィギュレーションを変更するには、Cuntomize Kernel Settingsを選択してください。また、ユーザーランドに含めるアプリケーションやライブラリを変更するには、Customize Vendor/User Settingsを選択してください。ここでいう、"選択する"とは、上下キーで選択したい項目ににフォーカスを合わせ、スペースキーを一度押し、*印を付けることを言います。

項目を選択したら、キーボードの左右キーでExitにフォーカスを合わせ、Enterキーを押してください。そうすることで、Kernel/Library/Defaults Selection画面を抜け、Main Menu画面へ戻ります。

Main Menu画面でも、Exitにフォーカスを合わせ、Enterキーを押してください。すると、Do you wish to save your new kernel configuration?と表示されますので、Yesにフォーカスを合わせたまま、Enterキーを押してください。

 atmark-dist v1.45.0 Configuration
------------------------------------------------------------------------


        ----------------------------------------------------------
            Do you wish to save your new kernel configuration?

                            < Yes >      <  No  >

        ----------------------------------------------------------

図7.5 menuconfig: Do you wish to save your new kernel configuration?

Cuntomize Kernel Settingsを選択していた場合は、Linux Kenrel Configuration画面が表示されます。ここで、カーネルコンフィギュレーションを変更することができます。コンフィギュレーションが完了したら、Linux Kernel Configuration画面でExitにフォーカスを当ててEnterキーを押し、画面を抜けてください。

 .config - Linux/arm 3.14.36-at4 Kernel Configuration
------------------------------------------------------------------------
                    Linux/arm 3.14.36-at4 Kernel Configuration
  Arrow keys navigate the menu.  <Enter> selects submenus --->.
  Highlighted letters are hotkeys.  Pressing <Y> includes, <N> excludes,
  <M> modularizes features.  Press <Esc><Esc> to exit, <?> for Help.
  Legend: [*] built-in  [ ] excluded  <M> module  < > module capable
  --------------------------------------------------------------------
                -*- Patch physical to virtual translations at runtime
                General setup  --->
            [*] Enable loadable module support  --->
            [*] Enable the block layer  --->
                System Type  --->
                Bus support  --->
                Kernel Features  --->
                Boot options  --->
                CPU Power Management  --->
                Floating point emulation  --->
                Userspace binary formats  --->
                Power management options  --->
            [*] Networking support  --->
                Device Drivers  --->
                File systems  --->
                Kernel hacking  --->
                Security options  --->
            -*- Cryptographic API  --->
                Library routines  --->
            [ ] Virtualization  ----
  --------------------------------------------------------------------
                  <Select>    < Exit >    < Help >    < Save >    < Load >

図7.6 menuconfig: Linux Kernel Configuration

AWL13を使用するためのカーネルコンフィギュレーション変更について

Armadillo-420のプロダクトを選択した場合に、Armadillo-WLAN(AWL13)をSDIOインターフェースで使用するには、以下のカーネルコンフィギュレーションを有効にします。

  System Type  --->
      [*] Freescale i.MX family
            Freescale i.MX support  --->
              *** MX25 platforms: ***
          [*] Support Armadillo-420 platform
                Device options  --->
                    -*- Enable eSDHC2
                Armadillo-400 Board options  --->
                    [*] Enable SDHC2 at CON9
					[*]   Enable PWREN for SDHC2 at CON9_1

図7.7 Armadillo-WLAN用SDIOインターフェース有効化

Customize Vendor/User Settingsを選択していた場合は、Userland Configuration画面が表示されます。ここで、ユーザーランドに含めるアプリケーションやライブラリを選択することができます。選択が完了したら、Userland Configuration画面でExitにフォーカスを当ててEnterキーを押し、画面を抜けてください。

 atmark-dist v1.45.0 Configuration
------------------------------------------------------------------------
                    Userland Configuration
  Arrow keys navigate the menu.  <Enter> selects submenus --->.
  Highlighted letters are hotkeys.  Pressing <Y> includes, <N> excludes,
  <M> modularizes features.  Press <Esc><Esc> to exit, <?> for Help.
  Legend: [*] built-in  [ ] excluded  <M> module  < > module capable
  --------------------------------------------------------------------
              Vendor specific  --->
              Fonts  --->
              Core Applications  --->
              Library Configuration  --->
              Flash Tools  --->
              Filesystem Applications  --->
              Network Applications  --->
              Miscellaneous Applications  --->
              BusyBox  --->
              Tinylogin  --->
              Qt  --->
              X Window System  --->
              MicroWindows  --->
              Games  --->
              Miscellaneous Configuration  --->
              Debug Builds  --->
              ---
              Load an Alternate Configuration File
              Save Configuration to an Alternate File
  --------------------------------------------------------------------

                    <Select>    < Exit >    < Help >

図7.8 menuconfig: Userland Configuration

AWL13を使用する場合のユーザーランドコンフィギュレーション変更について

Armadillo-WLAN(AWL13)を使用するには、ユーザーランドコンフィギュレーションのVendor SpecificでArmadillo-WLANを選択してください。

Armadillo-WLAN ProductsでAWL13を選択した場合、使用するインターフェースとして SDIOまたは USBを選択できます。

また、ユーザーランドに組み込むAWL13のファームウェアとして、STA (ステーション)とAP (アクセスポイント)を選択できます。両方を選択した場合は、どちらのファームウェアを標準で使用するかを、AWL13 Default Mode で指定します。

  Userland Configuration
      Vendor specific  --->
          [*] Armadillo-WLAN
          (AWL13) Armadillo-WLAN Products
          (SDIO) AWL13 Support interface
          --- AWL13 Firmware
          [*] AWL13 Station Mode
          [*] AWL13 Access Point Mode
          (STA) AWL13 Default Mode

図7.9 AWL13を使用する場合のコンフィギュレーション例(SDIOインターフェース、ステーションモード)

再び、Do you wish to save your new kernel configuration?と表示されますので、Yesにフォーカスを合わせたまま、Enterキーを押してください。

以上で、コンフィギュレーションの変更は完了です。

make menuconfig を使用したコンフィギュレーション方法の詳細については、「Atmark-Dist 開発者ガイド」を参照してください。

コンフィギュレーションを行ったあとは、「Linuxカーネル/ユーザーランドをビルドする」のステップ 9の手順と同様に、make コマンドを実行すると、コンフィギュレーション結果を反映したイメージが作成されます。

7.3. ユーザーランドイメージにアプリケーションを追加する

ここでは、「Linuxカーネル/ユーザーランドをビルドする」で作成したユーザーランドに、自作のアプリケーションなど Atmark-Dist には含まれないファイルを追加する方法について説明します。

自作アプリケーションは、Out-Of-Tree コンパイル^[15]で作成し、~/sample/hello にあると仮定とします。

Atmark-Dist では、romfs ディレクトリにユーザーランドイメージに含めるファイルが置かれています。ここに自作アプリケーションを追加し、make image コマンドを実行することで、自作アプリケーションを含んだユーザーランドイメージを作成することができます。

[ATDE ~/atmark-dist]$ cp ~/sample/hello romfs/bin/
[ATDE ~/atmark-dist]$ make image
	：
	：
[ATDE ~/atmark-dist]$ ls images
linux.bin  linux.bin.gz  romfs.img  romfs.img.gz

図7.10 ユーザーランドイメージのカスタマイズ

作成されたユーザーランドイメージの /bin ディレクトリには、hello がインストールされています。

7.4. ブートローダーをビルドする

ここでは、ブートローダーである「Hermit-At」のソースコードからイメージファイルを作成する手順を説明します。

手順7.2 ブートローダーをビルド

ソースコードの準備
Hermit-Atのソースコードアーカイブを準備し展開します。展開後、hermit-atディレクトリに移動します。
```
[ATDE ~]$ ls
hermit-at-[version]-source.tar.gz
[ATDE ~]$ tar zxf hermit-at-[version]-source.tar.gz
[ATDE ~]$ ls
hermit-at-[version]  hermit-at-[version]-source.tar.gz
```
以降のコマンド入力例では、ブートローダーのソースファイルからバージョンを省略した表記を用います。
デフォルトコンフィギュレーションの適用
Hermit-Atディレクトリに入り、Armadillo-400 シリーズ用のデフォルトコンフィギュレーションを適用します。ここでは例としてフラッシュメモリ起動用イメージを作成します。デフォルトコンフィグにはarmadillo4x0_defconfigを指定します。UART起動用イメージを作成する場合は、armadillo4x0_boot_defconfigを指定してください。
```
[ATDE ~]$ cd hermit-at
[ATDE ~/hermit-at]$ make armadillo4x0_defconfig
```
ビルド
ビルドには"make"コマンドを利用します。
```
[ATDE ~/hermit-at]$ make
```
イメージファイルの生成確認
ビルドが終了すると、hermit-at/src/target/armadillo4x0/ディレクトリ以下にイメージファイルが作成されています。
```
[ATDE ~/hermit-at]$ ls src/target/armadillo4x0/loader-armadillo4x0-*.bin
src/target/armadillo4x0/loader-armadillo4x0-[version].bin
```

^[15]Out-Of-Tree コンパイルに関しては「Atmark-Dist 開発者ガイド」を参照してください


第6章フラッシュメモリの書き換え方法	PDF version	第8章カーネル/ユーザーランドの配置

Armadillo 開発者サイト

第7章 ビルド手順

7.1. Linuxカーネル/ユーザーランドをビルドする

7.2. イメージをカスタマイズする

7.3. ユーザーランドイメージにアプリケーションを追加する

7.4. ブートローダーをビルドする

第7章ビルド手順