このブログ記事が廃れたです。BSP 5用のご参考ください。

本マニュアルについて

本マニュアルはトラデックスのCPUモジュール上で動作するLinux OSの開発環境構築およびOSイメージの作成をする手順を記述しています。

参考：

• http://developer.toradex.com/knowledge-base/board-support-package/openembedded-(core)
• http://www.openembedded.org/wiki/Main_Page
• https://www.yoctoproject.org/docs/1.6/bitbake-user-manual/bitbake-user-manual.html
• https://developer.toradex.com/device-tree-customization

本マニュアルのPDFダウンロード

１．実行環境

２．事前準備

３．前提知識

４．注意事項

Open Embeddedについて

トラデックスのCPUモジュール上で動作するLinux OSは組み込み向けディストリビューション(Poky)であり、パソコンなどで動作するDebian系ディストリビューションなどと大きく異なります。例えばapt-getなどパッケージ管理ソフトで容易にパッケージのインストールを行うような仕組みがありません。(opkgは実質使用できない)また開発環境(x86系)と実行環境(ARM)が異なるためOSやミドルウェア、アプリケーションなどはすべてARM向けにソースコードからクロスコンパイルを行って作成する必要があります。
トラデックスの開発環境ではそれらの開発を容易にするためにOpen Embeddedという開発プラットフォームを使用します。
Open Embeddedは主にリソースが限られた組み込み機器に軽量なOSを搭載させるために用意された開発プラットフォームです。

CPUボードの開発をする場合、目的のアプリケーション向けに必要なCPUの速度やメモリ容量などハードウェアスペックを確認してデバイス選定を行いますがソフトウェア(主にOSとミドルウェア)も目的のアプリケーションを動かすための必要最小限のもの にしないと余計なリソースを奪われ性能が損なわれる可能性があります。

例えばトラデックス標準OSはX-WindowやPerlなどが搭載されていますがpythonやwebサーバ、QTなどは含まれていません。
CPUボードを使ってGUIを不要とするルーターを開発する場合、GUI機能は不要ですがさまざまな通信プロトコルやwebサーバなどの機能が要求されます。トラデックス標準OSではこのようなルーターを作ることはできません。
Open Embeddedではこのような要求される機能を丁度よく盛り込んだOSを容易に作成できるようになっています。

Open Embeddedの詳細に関しては下記をご参照ください。
http://docs.openembedded.org/usermanual/html/

開発の流れ

トラデックスのCPUモジュールのソフトウェア郡は主にブートローダー(U-Boot)、Linux OS、ファイルシステムで構成されています。
本マニュアルではそれら３つを含めたOSイメージの作成について記載しています。下記はOSイメージの開発の流れです。アプリケーションはファイルシステムに含まれます。

開発環境構築

Ubuntuのアップデートを行います。画面左下のダッシュボードをクリックして「update」と入力しSoftware Updaterを起動しアップデートを行います。アップグレード(OSバージョンのアップデート)の案内がある場合もありますがUbuntu18.04のバージョンのまま使用しますのでアップグレードはしないようにご注意ください。

Software Updaterと同じようにダッシュボードからTerminalを立ち上げます。以後Terminalでさまざまなコマンド入力します。コマンドを入力するのは場合はTerminalを立ち上げてください。

Open Embeddedの開発においてシェルにdashを使うとうまくいきません。またdashを使用しないといけないケースはありません。基本的にbashを使用すればよいため下記コマンドでdashからbashへ変更します。

[ubuntu]$sudo dpkg-reconfigure dash

下記のような画面が表示されますのでNoを選択します。

必要機能のインストールのため下記コマンドを実行します。

[ubuntu]$ sudo dpkg --add-architecture i386

[ubuntu]$ sudo apt-get -y update

[ubuntu]$ sudo apt-get -y install g++-5-multilib

[ubuntu]$ sudo apt-get -y install curl dosfstools gawk g++-multilib gcc-multilib lib32z1-dev libcrypto++6:i386 libcrypto++-de

v:i386 liblzo2-dev:i386 lzop libsdl1.2-dev libstdc++-5-dev:i386 libusb-1.0-0:i386 libusb-1.0-0-dev:i386 uuid-dev:i386 texinfo

chrpath

[ubuntu]$ sudo apt-get -y install git python libncurses5-dev

BSPの入手

トラデックスのBSP(Board Support Package)の内容はOpen EmbeddedのレシピになっていますのでBSP = Open Embedded のレシピをダウンロードとご認識ください。

BSPをダウンロードするためのrepoを入手します。
実行ディレクトリ作成

[ubuntu]$ mkdir ~/bin

repoのダウンロード

[ubuntu]$ curl http://commondatastorage.googleapis.com/git-repo-downloads/repo > ~/bin/repo

実行権限追加

[ubuntu]$ chmod a+x ~/bin/repo

一度Ubuntuを再起動します。再起動することでrepoコマンドが使用できるようになります。

[ubuntu]$ sudo mkdir /work

オーナーとグループを変更

[ubuntu]$ sudo chown  /work

[ubuntu]$ sudo chgrp  /work

[ubuntu]$ cd /work

repoダウンロード用ディレクトリ作成

[ubuntu]$ mkdir bsp && cd bsp

repo(git)の設定メールアドレスと名前(ダミーで問題ありません。変更せず下記をそのまま実行してください。)

[ubuntu]$ git config --global user.email example@example.com

[ubuntu]$ git config --global user.name example

repo初期化

[ubuntu]$ repo init -u http://git.toradex.com/toradex-bsp-platform.git -b LinuxImage3.0 -m default.xml

repoを実行すると下記のような質問があるのでyを入力

[ubuntu]$ Enable color display in this user account (y/N)?

repo同期

[ubuntu]$ repo sync

エラーが出る場合、いったんすべて削除して

[ubuntu]$ rm -rf ./* && rm -rf ./.repo

[ubuntu]$ repo sync -j1

を試してください。並列のダウンロード数を１つにします。

Open Embedded用のディレクトリ作成&移動

cd /work

[ubuntu]$ mkdir oe-core && cd ./oe-core

BSPコピー(repoのディレクトリはそのまま置いておき最新版や古いバージョンを入手するときに再利用します。不要なら削除しても問題ありません。)

[ubuntu]$ cp -prf /work/bsp/* ./

BSP配下のファイルは下記のようになっています。
export ：ビルド環境設定シェル
layers ：Open Embeddedのレシピ

Open Embeddedの設定

/work/oe-core配下で下記を実行します。

Open Embeddedの環境設定

[ubuntu]$ . export

自動的にOpen Embeddedで使われるファイルの生成や環境変数の定義などがされ/work/oe-core/buildに移動します。

Open Embeddedの設定を変更
local.confファイルの内容を変更しま

[ubuntu]$ gedit ./conf/local.conf

・ターゲットモジュールの選択(必須)
MACHINE変数はモジュールの設定を行います。ファイル内に候補がいくつかあるのでコメントアウトをはずして目的の設定を行ってください。コメントアウトは#で行います。下記はcolibri-imx7の場合の設定です。ターゲットのモジュールにあわせて変更してください。

MACHINE ?= "colibri-imx7“

・i.MX系のGPUのライセンスへの同意(必須)
i.MX系のモジュールでGPUの機能を使用する場合、下記ファイルを参照の上ライセンスに同意しなければなりません。

/work/oe-core/layers/meta-freescale/EULA

同意できた場合、下記をlocal.conf内の任意の場所に追加します。

ACCEPT_FSL_EULA = "1"

・一時ファイルの削除設定(任意)
下記設定を消すとビルド途中の一時ファイルなどが削除されなくなります。容量は大幅に増えますが一時ファイルが必要になる場合は本設定を削除します。通常はこのままの設定で問題ありません。

INHERIT += “rm_work”

・ビルドヒストリーの書き込みをなくす(任意)
下記設定を追記するとビルドの最後に書き込まれるビルドヒストリーの書き込みを行いません。その分若干ビルドが早くなります。

INHERIT_remove = "buildhistory"

ビルドヒストリーは/work/oe-core/build/buildhistory/配下にできます。主にビルドで出力されたファイルリストや依存関係の情報などが出力されます。

・並列処理オプション
下記の設定を変更することによりbitbakeの並列タスク数を変更できます。
初期設定は下記のようになっていてCPUの数と同じ数になります。

BB_NUMBER_THREADS ?= "${@oe.utils.cpu_count()}"

bitbakeを並列で行うとエラーが発生する場合の原因の一つに並列タスクが原因の場合があります。
その場合１に設定してbitbakeを行うと正常にできる場合があります。

BB_NUMBER_THREADS = "1"

・並列make設定
makeで指定するプロセッサ数を指定します。
初期設定は下記のようになっていてCPUの数と同じ数になります。

PARALLEL_MAKE ?= "-j ${@oe.utils.cpu_count()}"

４つを指定する場合は下記のようになります。

PARALLEL_MAKE ?= "-j 4"

Open Embeddedのビルド

Open Embeddedのビルドを行うと大雑把に下記のような手順が実行されます。

do_fetch: ソースコードをダウンロード
do_unpack: ソースコードを解凍(展開)
do_patch: パッチを適用
do_configure: configureを実行
do_compile: makeを実行
do_install: make install を実行
do_populate_sysroot: sysroot にインストール
do_package: パッケージ化用のディレクトリにインストール
do_package_write: パッケージの作成（ipk, deb, rpm）
do_build: ビルド終了用のタスク
do_rm_work:一時ファイルの削除

ビルドに失敗する場合は最初のソースコードのダウンロードで失敗するケースがほとんどです。
ダウンロードにはgitやftpなど使用しています。ファイヤーウォールやプロキシの利用している場合ダウンロードエラーとなる場合があります。最初に下記コマンドですべてのファイルのダウンロードだけをしておきエラーが発生しないかを検証します。

[ubuntu]$ bitbake -runall fetch console-tdx-image

本コマンドでダウンロードエラーが出る場合はインターネット回線に何かしらの制限がかかっていると思われます。
ダウンロードが正常に終われば下記コマンドですべてのビルド作業を行います。

[ubuntu]$ bitbake console-tdx-image

パソコンのスペックにもよりますがビルドには数時間かかります。正常にビルドが終わると下記にOSイメージを作成するためのtarファイルが出力されます。(Colibri-iMX7の場合) バージョンや日付はコンパイル環境によります。

/work/oe-core/build/deploy/images/colibri-imx7/Colibri-iMX7_Console-Image-Tezi_<バージョン>-<日付>.tar

下記のようなメッセージが出るとビルド成功です。

無視してよいエラー

the basehash value changed fromというようなエラーが出るときがあります。これはレシピの修正などを行ったりするとOpen Embeddedの出力物のハッシュ値が変更されたときにでてきますが無視できるエラーです。出力物には影響ありません。
もし消したい場合は一度すべてのファイルを消して最初からbitbakeを行います。非常に時間がかかるため開発時には行わず開発が終わったときなど、最後のbitbakeで行うと効率的です。

OSイメージの書き込み

OSイメージ用ディレクトリ作成&移動

[ubuntu]$ mkdir /work/image && cd /work/image

作成したイメージを展開します。必ずroot権限で展開してください。

[ubuntu]$ sudo tar -xf /work/oe-core/build/deploy/images/colibri-imx7/Colibri-iMX7_Console-Image-Tezi_3.0b4.tar

以前に展開したものある場合すでにあるディレクトリを削除してから行ってください。

[ubuntu]$ sudo rm -rf ./Colibri-iMX7_Console-Image-Tezi_3.0b4

解凍したファイルはTEZIでモジュールに書き込みます。
書き込み方法はTEZIマニュアルをご参照ください。

出力されたファイルの説明

u-boot-nand.imx

ブートローダーのファイルです。

zImage

カーネルを圧縮したものです。

Console-Image-colibri-imx7.tar.xz

ルートファイルシステムを圧縮したものです。

imx7d-colibri-aster.dtb

imx7d-colibri-eval-v3.dtb

imx7d-colibri-iris.dtb

imx7d-colibri-iris-v2.dtb

imx7s-colibri-aster.dtb

imx7s-colibri-eval-v3.dtb

imx7s-colibri-iris.dtb

imx7s-colibri-iris-v2.dtb

キャリアボードやモジュール別のデバイスツリーファイルです。

上記以外のファイルはTEZIで使用するファイルです。

以上がOSイメージ開発の流れになります。本マニュアルではトラデックス標準のOSイメージを作成しましたが必要に応じてOSイメージのカスタムやアプリケーションの作成を行う必要があります。それらに関しては別途、対象のマニュアルをご参照ください。

Leave a comment