PetaLinux ツール資料: リファレンスガイドഊ (UG1144) · PetaLinux ツール資料...

PetaLinux ツール資料

リファレンスガイド

UG1144 (v2017.2) 2017 年 6 月 29 日

この資料は表記のバージョンの英語版を翻訳したもので、内容に相違が生じる場合には原文を優先します。資料によっては英語版の更新に対応していないものがあります。日本語版は参考用としてご使用の上、最新情報につきましては、必ず最新英語版をご参照ください。

リファレンスガイド 2UG1144 (v2017.2) 2017 年 6 月 29 日 japan.xilinx.com

改訂履歴

2017 年 6 月 29 日: Vivado® Design Suite 2017.2 リリース。内容の変更なし。

日付バージョン内容

2017 年 4 月 5 日 2017.1 PetaLinux ツール 2017.1 リリースに伴う更新。

https://japan.xilinx.com

https://japan.xilinx.com/about/feedback.html?docType=Reference_Guide&docId=UG1144&Title=PetaLinux%20%26%2312484%3B%26%2312540%3B%26%2312523%3B%26%2336039%3B%26%2326009%3B%3A%20%26%2312522%3B%26%2312501%3B%26%2312449%3B%26%2312524%3B%26%2312531%3B%26%2312473%3B%20%26%2312460%3B%26%2312452%3B%26%2312489%3B&releaseVersion=2017.2&docPage=2

目次

改訂履歴 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

第 1章: PetaLinux ツール資料はじめに . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

インストール要件 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

インストール手順 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

PetaLinux 作業環境のセットアップ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

PetaLinux BSP のインストール . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

Vivado によるハードウェアプラットフォームの作成. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

新規 PetaLinux プロジェクトの作成 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

バージョン管理 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

ハードウェアコンフィギュレーションのインポート . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

システムイメージのビルド . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

Zynq UltraScale+ MPSoC 用ブートイメージの生成 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

Zynq ファミリデバイス用ブートイメージの生成 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

MicroBlaze 用ブートイメージの生成 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

ビルド済みイメージのパッケージ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

ビルド済みイメージでの petalinux-boot コマンドの使用 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

QEMU での PetaLinux イメージのブート . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

SD カードを使用したハードウェア上での PetaLinux イメージのブート . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

JTAG を使用したハードウェア上での PetaLinux イメージのブート . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

TFTP を使用したハードウェア上での PetaLinux イメージのブート . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34

BSP のパッケージ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36

ファームウェアバージョンの設定 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

ルートファイルシステムタイプの設定 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38

ブートイメージストレージの設定 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38

プライマリフラッシュパーティションの設定 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

ベースルートファイルシステムの設定 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

イメージサイズの管理 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

INITRAMFS ブートの設定 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42

TFTP ブートの設定 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42

NFS ブートの設定 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43

SD カード外部ファイルシステムブートの設定 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

ビルド済みアプリケーションの取り込み . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46

ビルド済みモジュールの取り込み . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

カスタムアプリケーションの追加 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48

カスタムモジュールの追加 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50

ユーザーアプリケーションのビルド . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51

ユーザーアプリケーションのテスト . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53

ユーザーモジュールのビルド . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53

PetaLinux の自動ログイン . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55




起動時のアプリケーション自動実行 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55

QEMU による Linux カーネルのデバッグ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57

TCF エージェントによるアプリケーションのデバッグ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59

GDB による Zynq UltraScale+ MPSoC アプリケーションのデバッグ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64

out-of-tree ビルドの設定 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67

デバイスツリーの設定 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69

U-Boot の設定 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71

第 2章: Yocto の機能プロジェクトでの BitBake へのアクセス . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73

Yocto e-SDK レイヤーから petalinux-image-full.bb へのレシピの追加 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74

パッケージグループの追加 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75

sstate-cache の共有 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76

付録 A: PetaLinux プロジェクトの構造

付録 B: プロジェクト内での FSBL、 PMUFW および ATF の生成

付録 C: [Auto Config Settings] サブメニュー

付録 D: QEMU 仮想ネットワーキングモード

付録 E: QEMU でサポートされるザイリンクス IP モデル

付録 F: Xen Zynq Ultrascale+ MPSoC の例

付録 G: 廃止された機能

付録 H: 一般的なエラーと解決方法

付録 I: その他のリソースおよび法的通知ザイリンクスリソース . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96

ソリューションセンター . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96

参考資料 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96

お読みください: 重要な法的通知 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97




第 1章

PetaLinux ツール資料

はじめに

PetaLinux は FPGA ベースのシステムオンチップ (SoC) デザイン専用のエンベデッド Linux システム開発キットです。

このユーザーガイドでは、 PetaLinux の全体的な使用方法について説明します。

注記:読者には、 Linux コマンドの実行方法など Linux の基礎知識があることを前提とします。また、読者は OS の

ビットバージョン、 Linux ディストリビューションおよびセキュリティ権限など OS およびホストシステムの詳細に

ついても把握しておく必要があります。

新しい PetaLinux ツールには次のものが含まれます。

1. Yocto エクステンシブル SDK

表 1-1 に、インストールされる 4 つのエクステンシブル SDK を示します。

Yocto エクステンシブル SDK (e-SDK) は次の内容で構成されます。

a. レイヤー : アーキテクチャに対するすべてのレイヤーが含まれます。 Yocto e-SDk には core、 meta-oe および

その他の一般的なレイヤーが含まれます。

表 1‐1: エクステンシブル SDK

パスアーキテクチャ

$PETALINUX/components/yocto/source/aarch64 Zynq® UltraScale+™ MPSoC 用

$PETALINUX/components/yocto/source/arm Zynq 用

$PETALINUX/components/yocto/source/microblaze_full MicroBlaze™ 完全デザイン用

$PETALINUX/components/yocto/source/microblaze_lite MicroBlaze 軽量デザイン用

表 1‐2:ザイリンクス提供のレイヤー

レイヤーレシピ

meta-xilinx Linux カーネル、 U-Boot および ARM Trusted Firmware (ATF) のレシピが含まれます。

meta-xilinx-tools すべてのエンベデッドソフトウェアアプリケーション (fsbl、 pmufw、 fsboot、デバイス

ツリー ) のレシピが含まれます。

meta-petalinux ディストリビューションレシピおよびパッケージグループが含まれます。

petalinux-image-minimal --> 小機能セット

petalinux-image-full ---> 完全機能セット

meta-openamp OpenAMP レシピおよびコンフィギュレーションが含まれます。

meta-linaro-toolchain Zynq および ZynqMP 用のツールチェーンレシピが含まれます。




第 1 章: PetaLinux ツール資料

例: Zynq UltraScale+ MPSoC の場合: $PETALINUX/components/yocto/source/aarch64/layers

b. sstate-cache: BitBake によって再ビルドが不要と判断されたコンポーネントを除き、 OpenEmbedded ビルドシ

ステムはすべてを新規にビルドする仕様となっています。基本的に、新規にビルドした方がすべてのコン

ポーネントを新の状態でビルドできるため、古くなったデータによる不具合を防ぐことができる利点が

あります。

Yocto プロジェクトは、インクリメンタルビルドをサポートした共有ステートコードをインプリメントし

ています。入力タスクに変化がなければ、すべてのタスクでビルドの中間生成物を保存し、これらを再利

用することで、ビルド時間を短縮します。

例: Zynq UltraScale+ MPSoC の sstate-cache の場所:$PETALINUX/components/yocto/source/aarch64/sstate-cache

c. sysroots: ホストおよびターゲットの sysroot が含まれます。

例: Zynq UltraScale+ MPSoC の sysroot の場所:$PETALINUX/components/yocto/source/aarch64/sysroots

2. 小ダウンロード

BitBake はまずプリミラーをチェックした後、アップストリームでソースファイルを検出します。プリミラー

は、 DL_DIR 変数によって定義されたディレクトリ以外のディレクトリを共有している場合に適しています。

プリミラーはツール内の共有ディレクトリを指し示します。ツールのプロジェクトはすべてこれらのプリミ

ラーを使用し、ここからソースコードをフェッチします。

ツールのプリミラーは、次の場所を指し示します。 $PETALINUX/components/yocto/downloads

downloads ディレクトリには、 Linux カーネル、 U-Boot およびその他の小ユーティリティのソースコードが

tar アーカイブとして格納されます。

3. XSCT およびツールチェーン

PetaLinux ツールはすべてのエンベデッドソフトウェアアプリケーションの土台に XSCT を使用します。

ZynqMP および Zynq デバイスの場合、 Yocto のツールチェーン (meta-linaro-toolchain) を使用します。 MicroBlaze

の場合、 SDK ツールチェーンを使用します。

4. PetaLinux コマンド

これには、必要なすべての petalinux コマンドが含まれます。





インストール要件

PetaLinux ツールのインストール要件は次のとおりです。

• ワークステーションの小要件

° 4GB RAM (ザイリンクスツールで推奨される小サイズ)

° Pentium 4 プロセッサ 2GHz または同等品 (4 コア以上)

° 100GB のハードディスク空き容量

° サポートされる OS:

- RHEL 6.7/6.8 (64 ビット )

注記:限定的/条件付きサポートのみで、回避策があります。 RHEL および Cent OS 6.X には devtoolset-2 パッ

ケージをインストールします。サポートはザイリンクス PetaLinux イメージに限定されます。 PetaLinux イ

メージの外部で RHEL 6.X と devtools-2 の組み合わせでファイル破損が発生した場合、ザイリンクスのサ

ポート対象となりません。これは 2017.3 ではサポートされません。

- RHEL 7.2/7.3 (64 ビット )

- CentOS 7.2/7.3 (64 ビット )

- Ubuntu 16.04.1 (64 ビット )

• 一部のコマンド実行には、 root アクセス権限が必要です。 PetaLinux ツールは通常ユーザーとしてインストール

する必要があります。

• PetaLinux を使用するには、多くの標準開発ツールおよびライブラリを Linux ホストワークステーションにイン

ストールする必要があります。ホスト Linux にインストールする必要のあるライブラリとツールは、次の表に

示すとおりです。次に示す Linux ワークステーション環境はいずれも PetaLinux ツールで必要とされる 32 ビッ

トライブラリを備えています。これ以外にホスト上で 32 ビットライブラリを必要とするツールチェーンを使

用する場合、 petalinux-build を実行する前にこれらのライブラリをインストールしておく必要があります。

表 1-3 に、必要なパッケージおよびこれらパッケージを各種 Linux ワークステーション環境にインストールする

方法をまとめます。

表 1‐3:パッケージと Linux ワークステーション環境

ツール/ライブラリ CentOS 7.2/7.3 RHEL6.7/6.8(1) RHEL7.2/7.3 Ubuntu 16.04.1

python python: 3.4.0 python: 3.4.0 python: 3.4.0 python: 3.4.0

dos2unix dos2unix-6.0.3-4.el7.x

86_64.rpm

dos2unix-3.1-37.el6.x

86_64.rpm

dos2unix-6.0.3-4.

el7.x86_64.rpm

tofrodos_1.7.13

+ds-2.debian.tar.xz

ip iproute-3.10.0-74.el7.x

86_64.rpm

iproute-2.6.32-54.el6.

x86_64.rpm

iproute-3.10.0-74.

el7.x86_64.rpm

iproute2

4.3.0-1ubuntu3

gawk gawk-4.0.2-4.el7.x86_

64.rpm

gawk-3.1.7-6.el6.x86_

64.rpm

gawk-4.0.2-4.el7.

x86_64.rpm

gawk

(1:4.1.3+dfsg-0.1)

xvfb xorg-x11-server-Xvfb

-1.15.0-7.el7.x86_64.

rpm

xorg-x11-server-Xvfb-

1.17.4-9.5.el6_8.x86_

64.rpm

xorg-x11-server-X

vfb-1.15.0-7.el7.x

86_64.rpm

xvfb

(2:1.18.3-1ubuntu

2.3)

gcc (RHEL では

devtoolset-2 を

使用)

gcc 4.8.3 gcc 4.8.3 gcc 4.8.5 gcc 4.8





git git 1.8.3 git 1.7.1 git 1.8.3 git 1.7.1 以降

make make 3.81 make 3.81 make 3.82 make 3.81

netstat net-tools

2.0

net-tools 1.60 net-tools

2.0

net-tools

ncurses

devel

ncurses

-devel

5.9-13

ncurses

-devel

5.7-4

ncurses

-devel

5.9-13

libncurses5

-dev

tftp server tftp-server tftp-server tftp-server tftpd

zlib devel

(同じバージョン

の 32 ビット版も

インストールが

必要)

zlib-devel-1.2.7-17.el7.

x86_64.rpm

zlib-devel-1.2.3-29.el6.

x86_64.rpm

zlib-devel-1.2.7-17.

el7.x86_64.rpm

i386/zlib1g-dev/1:

1.2.8.dfsg-2ubuntu4

-dev

openssl

devel

openssl

-devel 1.0

openssl

-devel 1.0

openssl

-devel 1.0

libssl

-dev

flex flex 2.5.37 flex 2.5.35 flex 2.5.37 flex

bison bison-2.7 bison-2.4.1 bison-2.7.4 bison

libselinux libselinux

2.2.2

libselinux

2.0.94

libselinux

2.2.2

libselinux1

gnupg gnupg gnupg gnupg gnupg

wget wget wget wget wget

diffstat diffstat diffstat diffstat diffstat

chrpath chrpath chrpath chrpath chrpath

socat socat socat socat socat

xterm xterm xterm xterm xterm

autoconf autoconf autoconf autoconf autoconf

libtool libtool libtool libtool libtool

tar tar:1.24 tar:1.24 tar:1.24 tar:1.24

unzip unzip unzip unzip unzip

texinfo texinfo texinfo texinfo texinfo

zlib1g-dev - - - zlib1g-dev

gcc-multilib - - - gcc-multilib

build-essential - - - build-essential

libsdl1.2-dev - - - libsdl1.2-dev

libglib2.0-dev - - - libglib2.0-dev

SDL-devel SDL-devel SDL-devel SDL-devel -

glibc-devel glibc-devel glibc-devel glibc-devel -

表 1‐3:パッケージと Linux ワークステーション環境 (続き)






注意: ホストシステムの正しいパッケージ管理手順が分からない場合は、システム管理者に問い合わせてください。

重要: PetaLinux ツールは、ホストシステムの /bin/sh が bash であることを必要とします。

Ubuntu ディストリビューションを使用しており、 /bin/sh が dash の場合、システム管理者に問い合わせて

sudo dpkg-reconfigure dash コマンドでデフォルトを変更するようにしてください。

重要: PetaLinux v2017.1 は Vivado 2017.1 でのみ動作します。

インストール手順

前提条件

PetaLinux ツールをインストールするための前提条件は次のとおりです。

• PetaLinux ツールのインストール要件が満たされていること。詳細は、「インストール要件」を参照してください。

• PetaLinux リリースパッケージをダウンロード済みであること。 PetaLinux インストーラーは PetaLinux ダウン

ロードページからダウンロードできます。

PetaLinux ツールインストーラーの実行

PetaLinux ツールのインストール手順は簡単です。オプションを指定しない場合、 PetaLinux ツールはカレントディ

レクトリにインストールされます。インストール先パスをオプションで指定することもできます。

例: PetaLinux ツールを /opt/pkg/petalinux にインストールする場合:

$ mkdir -p /opt/pkg/petalinux$ ./petalinux-v2017.1-final-installer.run /opt/pkg/petalinux

これで、 PetaLinux ツールが /opt/pkg/petalinux ディレクトリにインストールされます。

32 ビット glibc glibc.i686 - glibc.i686 -

glib2-devel glib2-devel glib2-devel glib2-devel -

automake automake automake automake -

screen screen screen screen screen

pax pax pax pax pax

gzip gzip gzip gzip gzip

devtoolset-2 - devtoolset-2 - -

注記:1. 限定的/条件付きサポートのみで、回避策があります。 RHEL および Cent OS 6.X には devtools-2 パッケージをインストールしま

す。サポートはザイリンクス PetaLinux イメージに限定されます。 PetaLinux イメージの外部で RHEL 6.X と devtools-2 の組み合

わせでファイル破損が発生した場合、ザイリンクスのサポート対象となりません。これは 2017.3 ではサポートされません。

表 1‐3:パッケージと Linux ワークステーション環境 (続き)




http://japan.xilinx.com/support/download/index.html/content/xilinx/en/downloadNav/embedded-design-tools.html






重要: インストール後にインストールディレクトリを移動またはコピーすることはできません。上の例では、

/opt/pkg/petalinux は移動もコピーもできません。

PetaLinux ツールをインストールするには、 PetaLinux エンドユーザー使用許諾契約 (EULA) を読んで内容に同意する

必要があります。使用許諾契約の内容は、インストール実行前に読むこともできます。使用許諾契約の内容は、次

に示すプレーン ASCII 形式のテキストファイルとして提供されており、別途保存しておくことができます。

• $PETALINUX/etc/license/petalinux_EULA.txt: EULA は PetaLinux に適用される権利と制限について

の詳細を規定しています。

• $PETALINUX/etc/license/Third_Party_Software_End_User_License_Agreement.txt: サード

パーティ使用許諾契約は、 PetaLinux ツールの再配布可能および再配布不能コンポーネントのライセンスの詳細

を規定しています。

注記: PetaLinux ツールのインストールと実行にライセンスは必要ありません。

デフォルトでは、ツールの使用状況に関する統計データをザイリンクスに送信する WebTalk オプションが有効です。

WebTalk 機能を無効にするには、 petalinux-util --webtalk コマンドを実行します。

重要: PetaLinux コマンドを実行する前に、まず PetaLinux の settings スクリプトを実行する必要があります。詳細は、

「PetaLinux 作業環境のセットアップ」を参照してください。

$ petalinux-util --webtalk off

トラブルシューティング

このセクションでは、 PetaLinux ツールをインストールする際に発生する一般的な問題について説明します。

PetaLinux ツールのインストールに失敗した場合、 PetaLinux のインストールディレクトリに

$PETALINUX/post-install.log というファイルが生成されます。

表 1‐4: PetaLinux のインストールに関するトラブルシューティング

問題/エラーメッセージ説明/解決方法

WARNING: You have less than 1 GB

free space on the installation drive問題の説明

インストール先ドライブの空き容量が不足していることを示す警告メッセージ

です。空き容量が不足すると、インストール後にハードウェアプロジェクト

やソフトウェアプロジェクトを開発できないことがあります。

解決方法

• インストール先ドライブをクリーンアップして空き容量を増やします。

または

• PetaLinux を別のハードディスクドライブにインストールします。

WARNING: No tftp server found 問題の説明

ワークステーションで TFTP サービスが実行されていないことを示す警告メッ

セージです。 TFTP サービスが実行されていないと、 U-Boot のネットワーク

/TFTP 機能を使用して Linux システムイメージをターゲットシステムにダウン

ロードできません。その他のブートモードの場合、この警告メッセージは無

視できます。

解決方法

ワークステーションで TFTP サービスを有効にします。サービスを有効にする

方法が分からない場合は、システム管理者に問い合わせてください。





ERROR: GCC is not installed -

unable to continue. Please install and

retry

問題の説明

ワークステーションに gcc がインストールされていないことを示すエラーメッ

セージです。

解決方法

Linux ワークステーションパッケージ管理システムを使用して gcc をインス

トールします。方法が分からない場合は、システム管理者に問い合わせてくだ

さい。

ERROR: You are missing the

following system tools required by

PetaLinux: missing-tools-list

または

ERROR: You are missing these

development libraries required by

PetaLinux: missing-library-list

問題の説明

「missing-tools-list」または「missing-library-list」に表示されている必須ツール

またはライブラリが不足していることを示すエラーメッセージです。

解決方法

不足しているツールのパッケージをインストールします。詳細は、「インス

トール要件」を参照してください。

Failed to open PetaLinux lib. 問題の説明

PetaLinux ライブラリのロードに失敗したことを示すエラーメッセージです。

次の理由が考えられます。

• PetaLinux settings.sh がロードされていない。

• 動作中の Linux カーネルで SELinux が有効に設定されている。この場合、セ

キュリティコンテキストおよびライブラリのロードに関して問題が発生す

ることがあります。

解決方法

1. 上位の PetaLinux ディレクトリから settings.sh スクリプトを実行し

ます。詳細は、「PetaLinux 作業環境のセットアップ」を参照してください。

2. SELinux を有効にしている場合、 SELinux が「enforcing mode」かどうかを

確認します。

SELinux が「enforcing mode」に設定されている場合は「permissive mode」に変

更するか (詳細は SELinux マニュアルを参照)、次のコマンドを実行してライブ

ラリにアクセスできるようにセキュリティコンテキストを変更します (詳細は

以下を参照)。

$ cd $PETALINUX/tools/common/petalinux/lib

$ chcon -R -t textrel_shlib_t lib

表 1‐4: PetaLinux のインストールに関するトラブルシューティング (続き)






PetaLinux 作業環境のセットアップ

インストール完了後、付属の settings スクリプトを実行すると残りのセットアップは自動的に完了します。

前提条件

このセクションでは、次に示す前提条件が満たされているものと仮定します。

• PetaLinux ツールのインストールが完了していること。詳細は、「インストール手順」を参照してください。

• 「/bin/sh」が bash であること。

PetaLinux 作業環境のセットアップ手順

1. 適切な settings スクリプトを実行します。

• ユーザーログインシェルが bash の場合:

$ source <path-to-installed-PetaLinux>/settings.sh

• ユーザーログインシェルが C シェルの場合:

$ source <path-to-installed-PetaLinux>/settings.csh

セットアップスクリプトを初めて実行すると、次のような出力が表示されます。

PetaLinux environment set to '/opt/pkg/petalinux'INFO: Checking free disk spaceINFO: Checking installed toolsINFO: Checking installed development librariesINFO: Checking network and other servicesWARNING: No tftp server found - please refer to "PetaLinux SDK Installation Guide" for its impact and solution

2. 作業環境が正しくセットアップされたことを確認します。

$ echo $PETALINUX/opt/pkg/petalinux

環境変数「$PETALINUX」には PetaLinux のインストールパスが格納されます。実際の出力は、 PetaLinux のインス

トールパスにより異なります。


このセクションでは、 PetaLinux 作業環境をセットアップする際に発生する一般的な問題について説明します。

表 1‐5: PetaLinux 作業環境に関するトラブルシューティング


WARNING: /bin/sh is not bash 問題の説明

デフォルトのシェルが dash にリンクされていることを示す警告メッセー

ジです。

解決方法

Ubuntu Forum に記載の手順を実行します。


https://ubuntuforums.org/showthread.php?t=1932504




PetaLinux BSP のインストール

PetaLinux リファレンスボードサポートパッケージ (BSP) はそのまま使用可能なリファレンスデザインで、個々の

プロジェクトに合わせてカスタマイズできます。これらはインストール可能 BSP ファイルの形で提供され、必要な

デザインおよびコンフィギュレーションファイル、ビルドおよびテスト済みのハードウェアおよびソフトウェアイ

メージがすべて含まれており、ボードへのダウンロードまたは QEMU システムエミュレーション環境でのブートが

すぐに行えます。

前提条件


• PetaLinux BSP がダウンロードされていること。 PetaLinux BSP は PetaLinux ダウンロードページからダウンロー

ドできます。

• PetaLinux 作業環境のセットアップが完了していること。詳細は、「PetaLinux 作業環境のセットアップ」を参照

してください。

PetaLinux BSP のインストール手順

BSP をインストールする手順は次のとおりです。

1. PetaLinux プロジェクトを作成するディレクトリに移動します。たとえば /home/user 直下にプロジェクトを作成

する場合は次のように実行します。

$ cd /home/user

2. コマンドコンソールで petalinux-create コマンドを実行します。

petalinux-create -t project -s <path-to-bsp>

参照先のボードは、インストールする BSP によって決まります。次のような表示が出力されます。

INFO: Create project: INFO: Projects: INFO: * xilinx-zcu102-v2017.1-final.bspINFO: has been successfully installed to /home/user/INFO: New project successfully created in /home/user/

指定したディレクトリが NFS の場合、 TMPDIR が /tmp/<projname_timestamp> に変更されます。

/tmp/<projname_timestamp> も NFS の場合はエラーになります。

上の例で、 petalinux-create コマンドを実行すると BSP から抽出されたインストール中のプロジェクトがディスプレ

イコンソールにリスト表示されます。 /home/user に移動して ls を実行すると、インストール済みプロジェクトが表

示されます。



http://japan.xilinx.com/support/download/index.html/content/xilinx/en/downloadNav/petalinux.html

http://japan.xilinx.com/support/download/index.html/content/xilinx/en/downloadNav/petalinux.html




このセクションでは、 PetaLinux BSP をインストールする際に発生する一般的な問題について説明します。

BSP のファイル名

出荷されているシリコンおよびボードには複数のリビジョンがあります。表 1-7 に、 Zynq UltraScale ファミリでサ

ポートされるダウンロード可能 BSP の一覧を示します。

BSP はこちらのページからダウンロードできます。

Vivado によるハードウェアプラットフォームの作成

このセクションでは、 PetaLinux プロジェクトで使用できるようにハードウェアプラットフォームを設定する方法に

ついて説明します。

前提条件


• Vivado® Design Suite がインストールされていること。 Vivado Design Suite は Vivado デザインツールのダウン

ロードページからダウンロードできます。

• Vivado ツール作業環境がセットアップされていること。まだの場合は、次のように適切な settings スクリプトを

実行してください。

$ source <path-to-installed-Xilinx-Vivado>/settings64.sh

• ザイリンクス Vivado および SDK ツールの使用法を習得していること。

表 1‐6: PetaLinux BSP のインストールに関するトラブルシューティング


petalinux-create: command not

found問題の説明

petalinux-create コマンドが見つからず、 BSP のインストールが中止されたこと

を示すメッセージです。

解決方法

PetaLinux ツールの環境をセットアップする必要があります。セットアップ方

法の詳細は、「PetaLinux 作業環境のセットアップ」を参照してください。

表 1‐7: BSP のファイル名

プラットフォームシリコンリビジョンボードリビジョン PetaLinux BSP ファイル名

ZCU102

1.0 シリコン (zu9-es1)

Rev-B

xilinx-zcu102-zu9-es1-v2017.1-final.bspRev-C

Rev-D

3.0 シリコン (zu9-es2) Rev-1.0 xilinx-zcu102-zu9-es2-rev1.0-v2017.1-final.bsp

プロダクションシリコン (zu9) Rev-1.0 xilinx-zcu102-v2017.1-final.bsp



https://japan.xilinx.com/support/download/index.html/content/xilinx/en/downloadNav/embedded-design-tools.html

http://japan.xilinx.com/support/download/index.html/content/xilinx/en/downloadNav/vivado-design-tools.html

http://japan.xilinx.com/support/download/index.html/content/xilinx/en/downloadNav/vivado-design-tools.html



Linux 用にハードウェアプラットフォームを設定する

独自のハードウェアプラットフォームを Vivado を使用して作成できます。ハードウェアプラットフォームをどのよ

うな方法で作成および設定したかにかかわらず、ハードウェアプラットフォームを Linux で使用できるようにする

には、いくつかのハードウェア IP およびソフトウェアプラットフォームの設定変更が必要です。次に、具体的な方

法を示します。

Zynq UltraScale+ MPSoC

Zynq® UltraScale+™ MPSoC ハードウェアプロジェクトで Linux をブートするためのハードウェア要件は次のとおり

です。

1. 外部メモリコントローラーと 64MB 以上のメモリ (必須)

2. UART (必須)

重要: ソフト IP を使用する場合、割り込み信号を接続する必要があります。

3. QSPI フラッシュ、 SD/MMC などの不揮発性メモリ (オプション)

4. イーサネット (オプション。ネットワークアクセスを利用する場合は必須)

重要: ソフト IP または外部 PHY デバイスで割り込みを使用する場合、割り込み信号を接続する必要があります。

Zynq‐7000

Zynq-7000 ハードウェアプロジェクトで Linux をブートするためのハードウェア要件は次のとおりです。

1. 1 個のトリプルタイマーカウンター (TTC) (必須)

重要: 複数の TTC を有効にした場合、 Zynq-7000 Linux カーネルはデバイスツリーの初の TTC ブロックを使用しま

す。この TTC がほかで使用されていないことを確認する必要があります。

2. 外部メモリコントローラーと 32MB 以上のメモリ (必須)

3. UART (必須)

重要: ソフト IP を使用する場合、割り込み信号を接続する必要があります。

4. QSPI フラッシュ、 SD/MMC などの不揮発性メモリ (オプション)

5. イーサネット (オプション。ネットワークアクセスを利用する場合は必須)

重要: ソフト IP または外部 PHY デバイスで割り込みを使用する場合、割り込み信号を接続する必要があります。





MicroBlaze (AXI)

MicroBlaze™ ハードウェアプロジェクトで Linux をブートするための要件は次のとおりです。

1. IP コアのチェックリスト :

° 外部メモリコントローラーと 32MB 以上のメモリ (必須)

° 割り込みを接続したデュアルチャネルタイマー (必須)

° 割り込みを接続した UART (必須)

° リニアフラッシュや SPI フラッシュなどの不揮発性メモリ (オプション)

° 割り込みを接続したイーサネット (オプション。ネットワークアクセスを利用する場合は必須)

2. MicroBlaze CPU コンフィギュレーション:

° MicroBlaze Configuration Wizard でコンフィギュレーションテンプレートの [Linux with MMU] または

[Low-end Linux with MMU] をクリックして MicroBlaze の MMU サポートを有効にします。

重要: テンプレートによって有効にされるオプションに関係する命令セットは、無効にした場合の影響を十分に理解

している場合を除き、無効にしないでください。

° MicroBlaze 初期ブートローダー (FS-BOOT) には BRAM の小要件があります。不揮発性メモリからシステ

ムをブートする場合、パラレルフラッシュでは 4KB、 SPI フラッシュでは 8KB が必要です。

PetaLinux プロジェクトへのハードウェアプラットフォームのエクスポート

このセクションでは、ハードウェアプラットフォームを PetaLinux プロジェクトにエクスポートする方法について説

明します。

前提条件

このセクションでは、 Vivado Design Suite を使用してハードウェアプラットフォームが作成済みであるものと仮定し

ます。詳細は、「Vivado によるハードウェアプラットフォームの作成」を参照してください。

ハードウェアプラットフォームをエクスポートする

ハードウェアプロジェクトの設定が完了したら、ハードウェアビットストリームをビルドします。 PetaLinux プロ

ジェクトでは、プロセッシングシステムに関する情報を含んだハードウェア記述ファイル (.hdf ファイル) が必要

です。ハードウェア記述ファイルは、 Vivado で [Export Hardware] を実行すると生成できます。

このハードウェア記述ファイルに基づいて、 PetaLinux ツールはデバイスツリーソースファイル、 U-Boot config

ヘッダーファイルを生成し、一部のザイリンクス IP カーネルドライバーを有効にします。詳細については後のセク

ションで説明します。

Zynq UltraScale+ MPSoC プラットフォームの場合、プラットフォーム管理ユニットファームウェア (PMUFW) および

ATF を使用してブートする必要があります。 PMUFW および ATF のビルド方法は、付録 B 「プロジェクト内での

FSBL、 PMUFW および ATF の生成」を参照してください。





新規 PetaLinux プロジェクトの作成

このセクションでは、新規 PetaLinux プロジェクトを作成する方法について説明します。

前提条件

このセクションでは、 PetaLinux 作業環境のセットアップが完了しているものと仮定します。詳細は、「PetaLinux 作

業環境のセットアップ」を参照してください。

新規プロジェクトを作成する

新規 PetaLinux プロジェクトを作成するには、 petalinux-create コマンドを実行します。

$ petalinux-create --type project --template <CPU_TYPE> --name <PROJECT_NAME>

パラメーターは次のとおりです。

• --template <CPU_TYPE> - サポートされる CPU タイプは Zynq UltraScale+ MPSoC、 Zynq および MicroBlaze

です。

• --name <PROJECT_NAME> - ビルドするプロジェクト名を指定します。

このコマンドを実行すると、デフォルトテンプレートから新規 PetaLinux プロジェクトフォルダーが作成されます。

この後の手順で、先に作成したハードウェアプロジェクトに合わせてこれらの設定をカスタマイズします。

ヒント : bsp の代わりに --template オプションを使用した場合、次のように petalinux-config コマンドを使用してボード

デザインに近いデフォルトボード設定を選択できます。

1. petalinux-config--get-hw-description=<PATH-TO-HDF-DIRECTORY>

2. CONFIG_SUBSYSTEM_MACHINE_NAME を必要に応じて設定します。設定可能な値は、 kc705-full、 kc705-lite、

ac701-full、 ac701-lite、 kcu105、 zc702、 zc706、 zedboard、 zcu102、 zcu102-revb、 zcu106、 zc1751-dc1 および

zc1751-dc2 です。

ヒント : PetaLinux プロジェクトの構造の詳細は、付録 A 「PetaLinux プロジェクトの構造」を参照してください。

注意: PetaLinux プロジェクトを NFS に作成した場合、 TMPDIR が /tmp/<projname_timestamp> に変更されます。

/tmp/<projname_timestamp> も NFS の場合はエラーになります。 TMPDIR をローカルストレージに変更するには、

petalinux-config メニューから [Yocto-settings --> TMPDIR] を選択します。複数の異なる PetaLinux プロジェクトで

TMPDIR に同じディレクトリを設定しないでください。同じディレクトリを設定するとビルドエラーになります。





バージョン管理

このセクションでは、 PetaLinux プロジェクトのバージョン管理について説明します。

前提条件

このセクションでは、新規 PetaLinux プロジェクトを作成済み、または既存の PetaLinux プロジェクトが存在するも

のと仮定します。 PetaLinux プロジェクトの作成方法の詳細は、「新規 PetaLinux プロジェクトの作成」を参照してく

ださい。

バージョン管理

PetaLinux プロジェクトディレクトリ <plnx-proj-root> に対してバージョン管理が可能です。ただし次のものは

除きます。

• <plnx-proj-root>/.petalinux

• <plnx-proj-root>/build/

• <plnx-proj-root>/images/

• <plnx-proj-root>/pre-built/

• <plnx-proj-root>/project-spec/meta-plnx-generated/

プロジェクトの .gitignore を次の内容で置き換えます。

*/config.oldbuild/images/linux/.petalinux/*!.petalinux/metadata*.o*.jou*.log.metadata/meta-plnx-generated/.Xil/

注記: ソースコントロールへ送信する前に PetaLinux プロジェクトをクリーンアップする必要があります。

重要: 現時点で、 PetaLinux プロジェクトのバージョン管理は完全ではありません。いくつかのファイルはタイムス

タンプまたはパスが更新されます。これらは明示的に .gitignore に追加する必要があります。





ハードウェアコンフィギュレーションのインポート

このセクションでは、既存の (または新規に作成した) PetaLinux プロジェクトを新しいハードウェアコンフィギュ

レーションで更新する方法について説明します。これにより、 PetaLinux ツールのソフトウェアプラットフォームを

使用して新しいハードウェアプラットフォームにカスタマイズした Linux システムをビルドできるようになります。

前提条件


• ハードウェアプラットフォームのエクスポートと .hdf ファイルの生成が完了していること。詳細は、「ハード

ウェアプラットフォームをエクスポートする」を参照してください。

• 新規 PetaLinux プロジェクトを作成済み、または既存の PetaLinux プロジェクトが存在すること。 PetaLinux プロ

ジェクトの作成方法の詳細は、「新規 PetaLinux プロジェクトの作成」を参照してください。

ハードウェアコンフィギュレーションのインポート手順

ハードウェアコンフィギュレーションをインポートする手順は次のとおりです。

1. PetaLinux プロジェクトディレクトリに移動します。

$ cd <plnx-proj-root>

2. .hdf ファイルのあるディレクトリへのパスを指定して petalinux-config コマンドを実行し、ハードウェア

記述ファイルをインポートします。

$ petalinux-config --get-hw-description=<path-to-directory-which-contains-hardwaredescription-file>

PetaLinux プロジェクトで初めて petalinux-config --get-hw-description を実行した場合、またはシステム

の第 1 ハードウェア候補の変更がツールによって検出されると、次のような上位システムコンフィギュレーショ

ンメニューが表示されます。

Linux Components Selection ---> Auto Config Settings ---> -*- Subsystem AUTO Hardware Settings ---> Kernel Bootargs ---> ARM Trusted Firmware Compilation Configuration ---> PMU FIRMWARE Configuration ---> u-boot Configuration ---> Image Packaging Configuration ---> Firmware Version Configuration ---> (zcu102-revb) MACHINE_NAME Yocto Settings --->

[Subsystem AUTO Hardware Settings --->] を選択すると、次のようなメニューが表示されます。

Subsystem AUTO Hardware Settings System Processor (psu_cortexa53_0) ---> Memory Settings ---> Serial Settings ---> Ethernet Settings ---> Flash Settings ---> SD/SDIO Settings --->





RTC Settings ---> [*] Advanced bootable images storage Settings --->

[Subsystem AUTO Hardware Settings --->] メニューでは、システム全体のハードウェア設定をカスタマイズ

できます。

この手順には数分かかります。これは、 [Auto Config Settings --->] および [Subsystem AUTO Hardware

Settings --->] の設定に基づいてツールがハードウェア記述ファイルを解析し、デバイスツリー、 PetaLinux

U-Boot コンフィギュレーションファイルおよびカーネルコンフィギュレーションファイルの更新に必要なハード

ウェア情報を収集するのに時間がかかるためです。

たとえば Primary Ethernet として ps7_ethernet_0 を選択し、カーネルコンフィギュレーションと U-Boot コ

ンフィギュレーションの自動更新を有効にした場合、ツールは自動的にカーネルドライバーを有効にし、選択した

イーサネットコントローラーを U-Boot が使用できるように U-Boot コンフィギュレーションヘッダーも更新します。

注記: [Auto Config Settings] メニューの詳細は、付録 C 「[Auto Config Settings] サブメニュー」を参照してくだ

さい。

システムイメージのビルド

前提条件

このセクションでは、 PetaLinux ツールのソフトウェアプラットフォームを使用して実際のハードウェアプラット

フォームにカスタマイズした Linux システムをビルドできる準備が完了しているものと仮定します。詳細は、「ハー

ドウェアコンフィギュレーションのインポート」を参照してください。

PetaLinux システムイメージのビルド手順

1. PetaLinux プロジェクトディレクトリに移動します。


2. petalinux-build を実行してシステムイメージをビルドします。

$ petalinux-build

コンパイルの進行状況がコンソールに表示されます。次に例を示します。

[INFO] building project[INFO] generating Kconfig for project[INFO] oldconfig project[INFO] sourcing bitbake[INFO] generating plnxtool conf[INFO] generating meta-plnx-generated layer/home/user/xilinx-zcu102-zu9-es2-rev1.0-2017.1/build/misc/plnx-generated [INFO] generating machine configuration[INFO] generating bbappends for project . This may take time ! /home/user/xilinx-zcu102-zu9-es2-rev1.0-2017.1/build/misc/plnx-generated [INFO] generating u-boot configuration files[INFO] generating kernel configuration files[INFO] generating kconfig for Rootfs





Loading cache: 100% |########################################################################################################################################################| Time: 0:00:00Loaded 3235 entries from dependency cache.Parsing recipes: 100% |######################################################################################################################################################| Time: 0:00:02Parsing of 2446 .bb files complete (2407 cached, 39 parsed). 3236 targets, 224 skipped, 0 masked, 0 errors.NOTE: Resolving any missing task queue dependenciesNOTE: PN build list saved to 'pn-buildlist'NOTE: PN dependencies saved to 'pn-depends.dot'NOTE: Package dependencies saved to 'package-depends.dot'NOTE: Task dependencies saved to 'task-depends.dot'Generate rootfs kconfig[INFO] oldconfig rootfs[INFO] generating petalinux-user-image.bbINFO: bitbake petalinux-user-imageLoading cache: 100% |########################################################################################################################################################| Time: 0:00:00Loaded 3235 entries from dependency cache.Parsing recipes: 100% |######################################################################################################################################################| Time: 0:00:02Parsing of 2446 .bb files complete (2414 cached, 32 parsed). 3236 targets, 224 skipped, 0 masked, 0 errors.NOTE: Resolving any missing task queue dependenciesInitialising tasks: 100% |###################################################################################################################################################| Time: 0:00:09Checking sstate mirror object availability: 100% |###########################################################################################################################| Time: 0:00:35NOTE: Executing SetScene TasksNOTE: Executing RunQueue TasksNOTE: Tasks Summary: Attempted 2645 tasks of which 1892 didn't need to be rerun and all succeeded.INFO: generating FIT ImageINFO: bitbake petalinux-user-image -R /home/user/xilinx-zcu102-zu9-es2-rev1.0-2017.1/build/conf/fit-image.confParsing recipes: 100% |######################################################################################################################################################| Time: 0:00:29Parsing of 2446 .bb files complete (0 cached, 2446 parsed). 3236 targets, 224 skipped, 0 masked, 0 errors.NOTE: Resolving any missing task queue dependenciesInitialising tasks: 100% |###################################################################################################################################################| Time: 0:00:09Checking sstate mirror object availability: 100% |###########################################################################################################################| Time: 0:00:04NOTE: Executing SetScene TasksNOTE: Executing RunQueue TasksNOTE: Tasks Summary: Attempted 2646 tasks of which 2576 didn't need to be rerun and all succeeded.





INFO: Copying Images from deploy to imagesINFO: Creating images/linux directory[INFO] successfully built project

完全なコンパイルログは、 PetaLinux プロジェクトの build サブディレクトリに build.log として格納されます。

Linux ソフトウェアイメージとデバイスツリーは PetaLinux プロジェクトの images/linux サブディレクトリに生

成されます。

重要: デフォルトでは、 PetaLinux プロジェクトはカーネル、 rootfs および U-Boot 以外に第 1 段階ブートローダー

(FSBL) も生成およびビルドするように設定されています。自動生成される FSBL の詳細は、付録 B 「プロジェクト

内での FSBL、 PMUFW および ATF の生成」を参照してください。

uImage を生成する

petalinux-build を実行すると Zynq ファミリデバイスおよび MicroBlaze プラットフォーム用の FIT イメージが

生成され、 RAM ディスクイメージ urootfs.cpio.gz も生成されます。 uImage を使用する場合は、上記コマンド

の代わりに petalinux-package --image を実行します。次に例を示します。

$ petalinux-package --image -c kernel --format uImage

uImage は PetaLinux プロジェクトの images/linux サブディレクトリに生成されます。次に、 uImage でブートする

ように U-Boot を設定する必要があります。 U-Boot コンフィギュレーションターゲットとして

[PetaLinux u-boot config] を選択した場合、 PetaLinux プロジェクトの

<plnx-proj-root>/project-spec/meta-user/recipes-bsp/u-boot/files/platform-top.h で

CONFIG_EXTRA_ENV_SETTINGS マクロを上書き編集し、 uImage でブートするように U-Boot ブートコマンドを定

義します。


このセクションでは、 PetaLinux システムイメージをビルドする際に発生する一般的な問題について説明します。

表 1‐8: システムイメージのビルドに関するトラブルシューティング


[ERROR]

<path-to-installed-PetaLinux>

/etc/build/common.mk:17:

*** "No architecture is defined!".

Stop.

問題の説明

PetaLinux ツールがハードウェアアーキテクチャ定義を理解できなかったため

petalinux-build プロセスが完了しなかったことを示すエラーメッセージ

です。

解決方法

Vivado ハードウェアプロジェクトでボードとデバイスを正しく選択してハー

ドウェア記述をインポートする必要があります。詳細は、「ハードウェアコン

フィギュレーションのインポート」を参照してください。





Zynq UltraScale+ MPSoC 用ブートイメージの生成

このセクションは Zynq UltraScale+ MPSoC 専用で、Zynq UltraScale+ MPSoC 用の BOOT.BIN を生成する方法について

説明します。

前提条件

このセクションでは、 PetaLinux システムイメージのビルドが完了しているものと仮定します。詳細は、「システム

イメージのビルド」を参照してください。

ブートイメージを生成する

ここからの手順は、ハードウェアビットストリームのビルドが完了してから実行してください。ブートイメージは

フラッシュまたは SD カードに格納できます。ボードに電源を投入すると、ブートイメージからブートできます。

通常、ブートイメージには FSBL イメージ、 FPGA ビットストリーム、 PMU ファームウェアおよび U-Boot が含まれ

ます。

次のコマンドを実行して、 .bin フォーマットのブートイメージを生成します。

$ petalinux-package --boot --fsbl <FSBL image> --fpga <FPGA bitstream> --pmufw <PATH_TO_PMU_FW_ELF> --u-boot

コマンドの詳細は、 --help オプションで確認するか、『PetaLinux ツール資料: PetaLinux コマンドラインリファレ

ンスガイド』 (UG1157) [参照 4] を参照してください。

Zynq ファミリデバイス用ブートイメージの生成

このセクションは Zynq ファミリデバイス専用で、 BOOT.BIN を生成する方法について説明します。

前提条件




ここからの手順は、ハードウェアビットストリームのビルドが完了してから実行してください。ブートイメージは

フラッシュまたは SD カードに格納できます。ボードに電源を投入すると、ブートイメージからブートできます。

通常、ブートイメージには FSBL イメージ、 FPGA ビットストリームおよび U-Boot が含まれます。

次のコマンドを実行して、 .bin フォーマットのブートイメージを生成します。

$ petalinux-package --boot --fsbl <FSBL image> --fpga <FPGA bitstream> --u-boot

コマンドの詳細は、 --help オプションで確認するか、『PetaLinux ツール資料: PetaLinux コマンドラインリファレンス

ガイド』 (UG1157) [参照 4] を参照してください。





MicroBlaze 用ブートイメージの生成

このセクションは MicroBlaze 専用で、 MicroBlaze 用に MCS ファイルを生成する方法について説明します。

前提条件




次のコマンドを実行して、 MicroBlaze 用の MCS ブートファイルを生成します。

$ petalinux-package --boot --fpga <FPGA bitstream> --u-boot --kernel

boot.mcs が作業ディレクトリに生成され、 <plnx-proj-root>/images/linux/ ディレクトリにコピーされま

す。上記のコマンドを実行した場合、 MCS ファイルには fpga bit、 fs-boot、 u-boot およびカーネルイメージ

image.ub が含まれます。

fs-boot と fpga のみを含む .mcs ファイルを生成するには、次のコマンドを実行します。

$ petalinux-package --boot --fpga <FPGA bitstream>

fpga、 fs-boot および U-Boot を含む .mcs ファイルを生成するには、次のコマンドを実行します。

$ petalinux-package --boot --fpga <FPGA bitstream> --u-boot



ビルド済みイメージのパッケージ

このセクションでは、新規にビルドしたイメージを prebuilt ディレクトリにパッケージする方法について説明します。

注記: この手順を実行すると、 prebuilt 機能を使用して JTAG/QEMU でブートできるようになります。ただしこの手順

を実行しなくても JTAG/QEMU でのブートは可能です。

前提条件


• Zynq ファミリデバイスの場合、ブートイメージの生成が完了していること。詳細は、「Zynq UltraScale+

MPSoC 用ブートイメージの生成」を参照してください。

• MicroBlaze の場合、システムイメージの生成が完了していること。詳細は、「システムイメージのビルド」を

参照してください。





ビルド済みイメージのパッケージ手順

1. プロジェクトのルートディレクトリに移動します。


2. petalinux-package --prebuilt を実行してビルド済みイメージをパッケージします。

$ petalinux-package --prebuilt --fpga <FPGA bitstream>



ビルド済みイメージでの petalinux‐boot コマンドの使用

PetaLinux イメージをブートするには petalinux-boot コマンドを使用します。このコマンドで --qemu オプショ

ンを指定するとソフトウェアエミュレーション (QEMU) 環境でイメージがブートされ、 --jtag オプションを指定

するとハードウェアボード上でブートされます。このセクションでは、 prebuilt オプションの各種ブートレベルにつ

いて説明します。

前提条件

このセクションでは、ビルド済みイメージのパッケージが完了しているものと仮定します。詳細は、「ビルド済みイ

メージのパッケージ」を参照してください。

prebuilt オプションのブートレベル

--prebuilt <BOOT_LEVEL> オプションを指定すると、すべての設定をオーバーライドしてビルド済みイメージ

がブートされます。サポートされるブートレベルは 1 ～ 3 です。

• レベル 1: ビルド済み FPGA ビットストリームをダウンロードします。

° Zynq-7000 では FSBL、 Zynq UltraScale+ MPSoC では FSBL と PMUFW もブートします。

• レベル 2: ビルド済み FPGA ビットストリームをダウンロードし、ビルド済み U-Boot をブートします。

° Zynq-7000 の場合: U-Boot をブートする前に FSBL もブートします。

° Zynq UltraScale+ MPSoC の場合: U-Boot をブートする前に FSBL、 PMUFW および ATF もブートします。

• レベル 3:

° MicroBlaze の場合: ビルド済み FPGA ビットストリームをダウンロードし、ターゲット上のビルド済みカー

ネルイメージをブートします。

° Zynq-7000 の場合: ビルド済み FPGA ビットストリームと FSBL をダウンロードし、ビルド済み U-Boot を

ブートし、ターゲット上のビルド済みカーネルをブートします。

° Zynq UltraScale+ MPSoC の場合: ビルド済み FPGA ビットストリーム、ビルド済み FSBL、ビルド済み

PMUFW、ビルド済み ATF およびターゲット上のビルド済みカーネルをダウンロードします。

次に、 prebuilt オプションでブートレベルを使用した場合の例を示します。

$ petalinux-boot --jtag --prebuilt 3





QEMU での PetaLinux イメージのブート

このセクションでは、ソフトウェアエミュレーション (QEMU) 環境で PetaLinux イメージをブートする方法について

説明します。

注記: QEMU でサポートされるザイリンクス IP モデルの詳細は、付録 E 「QEMU でサポートされるザイリンクス IP

モデル」を参照してください。

前提条件


• PetaLinux BSP をインストール ( 「PetaLinux BSP のインストール」参照) または独自の PetaLinux プロジェクトを

ビルド ( 「システムイメージのビルド」参照) して PetaLinux システムイメージが存在していること。

• QEMU ブートで --prebuilt オプションを使用する場合、ビルド済みイメージをパッケージしておく必要があ

ります。詳細は、「ビルド済みイメージのパッケージ」を参照してください。

重要: 特に明記しない限り、 PetaLinux ツールのコマンドはプロジェクトディレクトリ (<plnx-proj-root>) で実行する

必要があります。

QEMU で PetaLinux イメージをブートする手順

ハードウェアなしでも PetaLinux ソフトウェアイメージをシミュレーション環境でテストできるように、 PetaLinux

は QEMU をサポートしています。

QEMU を使用して PetaLinux リファレンスデザインをテストする手順は次のとおりです。

1. プロジェクトディレクトリに移動し、ビルド済み Linux カーネルイメージをブートします。

$ petalinux-boot --qemu --prebuilt 3

注記: prebuilt 機能を使用しないで QEMU をブートする方法については、「QEMU でのその他のブート方法」を参照

してください。

° --qemu オプションを指定すると petalinux-boot は JTAG 経由で実際のハードウェアをブートするので

はなく、 QEMU をブートします。 --prebuilt 3 オプションを指定すると PMUFW をバックグラウンドで

実行しながら Linux カーネルをブートします。

ヒント : prebuilt オプションの各ブートレベルの詳細は、「ビルド済みイメージでの petalinux-boot コマンドの使用」を


petalinux-kernel の実行に成功すると、シリアルコンソールに次のようなカーネルブートログメッセージ

が表示されます。

[ 13.399282] Freeing unused kernel memory: 11392K (ffffffc000bd0000 - ffffffc0016f0000)[ 16.804862] udevd[1668]: starting version 3.2[ 16.819766] random: udevd: uninitialized urandom read (16 bytes read)[ 16.941649] udevd[1669]: starting eudev-3.2[ 22.690630] hrtimer: interrupt took 17368800 ns





[ 34.708066] random: dd: uninitialized urandom read (512 bytes read)[ 37.317181] IPv6: ADDRCONF(NETDEV_UP): eth0: link is not ready[ 38.401704] macb ff0e0000.ethernet eth0: link up (100/Full)[ 38.436587] IPv6: ADDRCONF(NETDEV_CHANGE): eth0: link becomes ready[ 42.300546] random: dropbearkey: uninitialized urandom read (32 bytes read)

PetaLinux 2017.1 plnx_aarch64 /dev/ttyPS0

plnx_aarch64 login: rootPassword: root@plnx_aarch64:~# [ 110.059298] random: fast init done

root@plnx_aarch64:~# root@plnx_aarch64:~#

2. デフォルトのユーザー名 root とパスワード root を使用して PetaLinux にログインします。

ヒント : QEMU を終了するには、 Ctrl + A キー、 X キーを押します。

QEMU でのその他のブート方法

• 新規にビルドした <plnx-proj-root>/images/linux/u-boot.elf を QEMU でダウンロードする方法

$ petalinux-boot --qemu --u-boot

° MicroBlaze および Zynq-7000 の場合、 <plnx-proj-root>/images/linux/u-boot.elf が QEMU で

ブートされます。

° Zynq UltraScale+ MPSoC の場合、 <plnx-proj-root>/images/linux/u-boot.elf がロードされ、 ATF

イメージ <plnx-proj-root>/images/linux/bl31.elf が QEMU でブートされた後、ロードされた

U-Boot イメージが ATF によってブートされます。

• 新規にビルドしたカーネルを QEMU でダウンロードする方法

$ petalinux-boot --qemu --kernel

° MicroBlaze の場合、 <plnx-proj-root>/images/linux/image.elf が QEMU でブートされます。

° Zynq-7000 の場合、 <plnx-proj-root>/images/linux/zImage が QEMU でブートされます。

° Zynq UltraScale+ MPSoC の場合、カーネルイメージ <plnx-proj-root>/images/linux/Image がロー

ドされ、 ATF イメージ <plnx-proj-root>/images/linux/bl31.elf が QEMU でブートされた後、

ロードされたカーネルイメージが ATF によってブートされます。バックグラウンドでは PMUFW が動作し

ます。

• DTB を指定して Linux イメージを直接ブートする方法

デバイスツリー (DTB ファイル) は、 Linux カーネルにハードウェアアーキテクチャとアドレスマップを知らせる目

的で使用します。また、 DTB ファイルは PetaLinux システムエミュレーターがハードウェアプラットフォームに合

わせてエミュレーション環境を動的に設定する目的でも使用します。

DTB ファイルオプションが提供されない場合、 petalinux-boot は指定された image.elf から DTB ファイルを

抽出する (MicroBlaze の場合) か、 <plnx-proj-root>/images/linux/system.dtb から DTB ファイルを抽出し

ます (Zynq-7000 および Zynq UltraScale+ MPSoC の場合)。

注記: QEMU のバージョンが 2.6 にアップグレードされました。これらの旧オプションは新バージョンでは推奨され

ませんが、以前と同じ動作をします。 PetaLinux ツールは旧オプションを使用しているため警告メッセージが表示さ

れますが、これらは無視できます。





次に、 Zynq UltraScale+ MPSoC の警告メッセージを示します。

qemu-system-aarch64: -tftp /home/user/xilinx-zcu102-2017.1/images/linux: The -tftp option is deprecated. Please use '-netdev user,tftp=...' instead.g

SD カードを使用したハードウェア上での PetaLinux イメージのブート

このセクションでは、 SD カードを使用してハードウェア上で PetaLinux イメージをブートする方法について説明し

ます。

注記: このセクションは、SD カードからのブートをサポートした Zynq-7000 および Zynq UltraScale+ MPSoC のみを対

象としています。

前提条件


• Linux ワークステーションに PetaLinux ツールがインストールされていること。インストールしていない場合は、

「インストール手順」を参照してください。

• Linux ワークステーションに PetaLinux BSP がインストールされていること。インストールしていない場合は、

「PetaLinux BSP のインストール」を参照してください。

• minicom/kermit/gtkterm などのシリアル通信プログラムがインストールされていること (シリアル通信プログラム

のボーレートは 115200bps に設定すること )。

SD カードを使用してハードウェア上で PetaLinux イメージをブートする手順

1. ホストマシンに SD カードをマウントします。

2. <plnx-proj-root>/pre-built/linux/images/ にある次のファイルを、 FAT32 でフォーマットした SD

カードの先頭パーティションのルートディレクトリにコピーします。

° BOOT.BIN

° image.ub

3. ボードのシリアルポートをワークステーションに接続します。

4. ワークステーションでコンソールを開き、 kermit、 minicom、 gtkterm などのシリアル通信プログラムを起動しま

す。コンソールでボーレートを 115200 に設定します。

5. ボードの電源をオフにします。

6. ボードのブートモードを SD ブートに設定します。詳細は、ボードのマニュアルを参照してください。

7. SD カードをボードに挿入します。

8. ボードの電源をオンにします。





9. シリアルコンソールに、次のようなブートメッセージが表示されます。

[ 4.233206] Freeing unused kernel memory: 512K (ffffffc000bb0000 - ffffffc000c30000)INIT: version 2.88 bootingStarting udev[ 4.351288] udevd[1624]: starting version 3.2[ 4.361779] udevd[1625]: starting eudev-3.2[ 4.364957] random: crng init donePopulating dev cacheTue Mar 14 11:19:35 UTC 2017Starting internet superserver: inetd.INIT: Entering runlevel: 5Configuring network interfaces... ifconfig: SIOCGIFFLAGS: No such deviceStarting Dropbear SSH server: Generating key, this may take a while...Public key portion is:ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQDivIP/aVx0x2TkA2hY0+mCmb0M0ySyU3XKKz7/fGqG5egd3JaA8kCwKf9l74eEfMh/YUnPc1s+ujBq2UWRnBMJbO7jk6KBv0GBVvJtrMxl5cgM7DlWd/jnQESOLjGuXM2OmzYbP4NzVQiXcjk0q5+cvayzN39c6B3V+a749wxwKzb8UE1DWc4kEswYsOSO8EL8T9y7tJbrD9mOPkoyQRI4lPHveapI3uB+NCmKabHMqCFsrsL+YYIYlWo7ZXxZdEZ11bncdd9LtzFXYSuTC0IhWnF9DgBfPWxmtu/fyRzmKxMeUY+1NrbBfUwn4Rf+utxrVWtCPCG3A6+krDYbccVT root@plnx_aarch64Fingerprint: md5 9e:8e:e0:01:73:1d:48:d6:73:b0:c8:19:7c:15:d1:c6dropbear.Starting syslogd/klogd: doneStarting tcf-agent: OKINIT: Id "hvc0" respawning too fast: disabled for 5 minutesPetaLinux 2017.1 plnx_aarch64 /dev/ttyPS0plnx_aarch64 login: rootPassword: root@plnx_aarch64:~#

ヒント : 自動ブートを停止する場合は、コンソールに次のようなメッセージが表示された後に任意のキーを押してく

ださい。 Hit any key to stop autoboot:

10. シリアルコンソールにユーザー名 root とパスワード root を入力して PetaLinux システムにログインします。






このセクションでは、 SD カードを使用してハードウェア上で PetaLinux イメージをブートする際に発生する一般的

な問題について説明します。

ヒント : U-Boot オプションを確認するには、 $ U-Boot-PetaLinux> printenv コマンドを実行してください。

JTAG を使用したハードウェア上での PetaLinux イメージのブート

このセクションでは、 JTAG を使用してハードウェア上で PetaLinux イメージをブートする方法について説明します。

前提条件


• PetaLinux BSP をインストール ( 「PetaLinux BSP のインストール」参照) または独自の PetaLinux プロジェクトを

ビルド ( 「システムイメージのビルド」参照) して PetaLinux システムイメージが存在していること。

• この条件はオプションで、 JTAG ブートで prebuilt 機能を使用する場合のみ必要です。ビルド済みイメージの

パッケージが完了していること ( 「ビルド済みイメージのパッケージ」参照)。

表 1‐9:ハードウェア上での PetaLinux イメージに関するトラブルシューティング


Wrong Image Format for boot

command.

ERROR: Can’t get kernel image!

問題の説明

u-boot ブートローダーがカーネルイメージを検出できないことを示すエラー

メッセージです。 bootcmd 環境変数が正しく設定されていない可能性があり

ます。

解決方法

デフォルトのブートデバイスを確認するには、 U-Boot コンソールで次のコマ

ンドを実行して bootcmd 環境変数の内容を出力します。

U-Boot-PetaLinux> print bootcmd

デフォルトで SD カードからブートしない場合、次に示すように複数の解決方

法があります。

• PetaLinux を再ビルドしない場合、希望する媒体からブートするように

setenv コマンドを使用して bootcmd を設定します。SD カードからブート

するには、環境変数を次のように設定します。

U-Boot-PetaLinux> setenv bootcmd ’run sdboot’ ;

saveenv

• petalinux-config を実行し、 SD カードからカーネルイメージをロード

するように設定します。詳細は、「ブートイメージストレージの設定」を参

照してください。 PetaLinux を再ビルドし、再ビルドした U-Boot を使用して

BOOT.BIN を再生成し、新しい BOOT.BIN を使用してボードをブートしま

す。 BOOT.BIN の生成方法の詳細は、「Zynq UltraScale+ MPSoC 用ブートイ

メージの生成」を参照してください。







• 適切な JTAG ケーブルドライバーがインストールされていること。ドライバーは Digilent Adept のダウンロード

ページからダウンロードできます。

JTAG を使用してハードウェア上で PetaLinux イメージをブートする手順


2. ボードの JTAG ポートを JTAG ケーブル経由でワークステーションに接続します。


4. システムにイーサネットが含まれる場合、ボードのイーサネットポートをローカルネットワークに接続します。

5. Zynq ファミリデバイスボードの場合、モードスイッチが JTAG モードになっていることを確認します。

詳細は、ボードのマニュアルを参照してください。


7. ワークステーションでコンソールを開き、 kermit、 minicom などのシリアル通信プログラムを起動します。

コンソールでボーレートを 115200 に設定します。

8. ワークステーションで次の petalinux-boot コマンドを実行します。


注記: JTAG ブートで prebuilt 機能を使用しない場合、「JTAG でのその他のブート方法」を参照してください。

petalinux-boot で --jtag オプションを指定すると JTAG を使用してハードウェア上でブートし、--prebuilt

3 オプションを指定すると Linux カーネルをブートします。コマンドが完了してから、コマンドコンソールにシェ

ルプロンプトが表示するまで待ちます。

注記: prebuilt オプションの各種ブートレベルの詳細は、「ビルド済みイメージでの petalinux-boot コマンドの使用」を


petalinux-boot の実行が正しく完了すると、ワークステーションのコマンドコンソールに次のようなメッセー

ジが表示されます。

$ petalinux-boot --jtag --prebuilt 3INFO: Launching XSDB for file download and boot.INFO: This may take a few minutes, depending on the size of your image.INFO: Configuring the FPGA...INFO: Downloading bitstream to the target.INFO: Downloading ELF file to the target.INFO: Downloading ELF file to the target.INFO: Downloading ELF file to the target.INFO: Downloading ELF file to the target.



https://store.digilentinc.com/

https://store.digilentinc.com/



petalinux-boot の実行が正しく完了すると、シリアルコンソールに次のようなメッセージが表示されます。

[ 4.862842] Freeing unused kernel memory: 5376K (ffffffc000bb0000 - ffffffc0010f0000)[ 5.546506] udevd[1762]: starting version 3.2[ 5.557113] udevd[1763]: starting eudev-3.2[ 6.088398] IPv6: ADDRCONF(NETDEV_UP): eth0: link is not ready[ 7.111774] macb ff0e0000.ethernet eth0: link up (1000/Full)[ 7.119195] IPv6: ADDRCONF(NETDEV_CHANGE): eth0: link becomes ready

PetaLinux 2017.1 plnx_aarch64 /dev/ttyPS0

plnx_aarch64 login: rootPassword: root@plnx_aarch64:~#

デフォルトでは、 PetaLinux リファレンスデザインのネットワーク設定は DHCP が有効です。テストに使用する

PetaLinux リファレンスデザインによっては、出力が上記のものとは若干異なることがあります。

9. シリアルコンソールにユーザー名 root とパスワード root を入力して PetaLinux システムにログインします。

10. システムコンソールで ifconfig を実行して PetaLinux の IP アドレスを確認します。

JTAG でのその他のブート方法

• ビットストリームをターゲットボードにダウンロードする方法

$ petalinux-boot --jtag --fpga --bitstream <BITSTREAM>

• 新規にビルドした <plnx-proj-root>/images/linux/u-boot.elf をターゲットボードにダウンロードす

る方法

$ petalinux-boot --jtag --u-boot

• 新規にビルドしたカーネルをターゲットボードにダウンロードする方法

$ petalinux-boot --jtag --kernel

° MicroBlaze の場合、 <plnx-proj-root>/images/linux/image.elf がターゲットボート上でブートさ

れます。

° Zynq-7000 の場合、 <plnx-proj-root>/images/linux/zImage がターゲットボード上でブートされ

ます。

° Zynq UltraScale+ MPSoC の場合、 <plnx-proj-root>/images/linux/Image がターゲットボード上で

ブートされます。

• --fpga --bitstream <BITSTREAM> オプションを使用してビットストリームとイメージをダウンロードする方法

$ petalinux-boot --jtag --u-boot --fpga --bitstream <BITSTREAM>

上記のコマンドを実行するとビットストリームの後に U-Boot イメージがダウンロードされます。

• JTAG ブートの出力を詳細モードにするには、 -v オプションを指定します。

$ petalinux-boot --jtag --u-boot -v





JTAG ブート中の Tcl/XSDB ログ

JTAG ブート中に使用する XSDB コマンドのログを記録するには、次のコマンドを使用します。このコマンドを実行

すると、 tcl スクリプト (およびそれによって実行される xsdb コマンド ) のデータが test.txt にダンプされます。

$ cd <plnx-proj-root>$ petalinux-boot --jtag --prebuilt 3 --tcl test.txt


このセクションでは、 JTAG を使用してハードウェア上で PetaLinux イメージをブートする際に発生する一般的な問

題について説明します。

表 1‐10: JTAG を使用したハードウェア上での PetaLinux イメージに関するトラブルシューティング


ERROR: This tool requires ’xsdb’

and it is missing. Please source

Xilinx Tools settings first.

問題の説明

PetaLinux ツールがザイリンクス Vivado または SDK ツールに含まれる xsdb

ツールを検出できなかったことを示すエラーメッセージです。

解決方法

Vivado ツール作業環境をセットアップする必要があります。

詳細は、「PetaLinux 作業環境のセットアップ」を参照してください。

QEMU では正しくブートするの

に、ハードウェアで U-Boot また

はカーネルをブートしようとし

てもコンソールに何も出力され

ない。

問題の説明

通常、この問題は次のいずれかまたは両方の理由により発生します。

• シリアル通信ターミナルアプリケーションで設定したボーレートが間違っ

ている。

• ハードウェアプラットフォームとソフトウェアプラットフォームが一致し

ていない。

解決方法

• ターミナルアプリケーションのボーレートがハードウェアコンフィギュ

レーションに合わせて正しく設定されていることを確認します。

• PetaLinux プロジェクトが正しいハードウェアプラットフォームでビルドさ

れていることを確認します。

° ハードウェアコンフィギュレーションを正しくインポートします。

詳細は、「ハードウェアコンフィギュレーションのインポート」を参照し

てください。

° [Subsystem AUTO Hardware Settings --->] サブメニューをチェックし、ハー

ドウェアプラットフォームと一致していることを確認します。

° [Subsystem AUTO Hardware Settings --->] の [Serial settings --->] をチェック

し、 stdout と stdin が正しい UART IP コアに設定されていることを確認し

ます。

° システムイメージをビルドし直します。詳細は、「システムイメージの

ビルド」を参照してください。





TFTP を使用したハードウェア上での PetaLinux イメージのブート

このセクションでは、 TFTP (Trivial File Transfer Protocol) を使用して PetaLinux イメージをブートする方法について説

明します。

ヒント : TFTP ブートは、カーネルソース変更のたびにイメージをフラッシュする必要がなく、 JTAG ブートよりも

はるかに高速なので、時間を大幅に短縮できます。

前提条件


• TFTP サーバーが動作するホスト環境のセットアップが完了しており、 TFTP ブート用の PetaLinux イメージがビ

ルド済みであること。詳細は、「TFTP ブートの設定」を参照してください。

• ビルド済みイメージのパッケージが完了していること ( 「ビルド済みイメージのパッケージ」参照)。



• ホストと Linux ターゲットの間でイーサネット接続が正しくセットアップされていること。

• 適切な JTAG ケーブルドライバーがインストールされていること。ドライバーは Digilent Adept のダウンロード

ページからダウンロードできます。

TFTP を使用してハードウェア上で PetaLinux イメージをブートする手順


2. ボードの JTAG ポートを JTAG ケーブル経由でワークステーションに接続します。


4. ボードのイーサネットポートをネットワークスイッチ経由でローカルネットワークに接続します。

5. Zynq ファミリデバイスボードの場合、モードスイッチが JTAG モードになっていることを確認します。

詳細は、ボードのマニュアルを参照してください。


7. ワークステーションでコンソールを開き、 kermit、 minicom などのシリアル通信プログラムを起動します。

コンソールでボーレートを 115200 に設定します。

8. ワークステーションで次の petalinux-boot コマンドを実行します。


petalinux-boot で --jtag オプションを指定すると JTAG を使用してハードウェア上でブートし、--prebuilt

2 オプションを指定するとビルド済みビットストリーム (および Zynq の場合は FSBL) をターゲットボードにダウン

ロードした後、ターゲットボード上でビルド済み U-Boot をブートします。

9. 自動ブートが開始したら、任意のキーを押して停止します。





U-Boot のダウンロードが正しく完了した場合のワークステーションコンソール出力の例を示します。

U-Boot 2017.01 (Mar 28 2017 - 14:14:14 -0600) Xilinx ZynqMP ZCU102

I2C: readyDRAM: 2 GiBEL Level: EL2Chip ID: xczu9egMMC: sdhci@ff170000: 0 (SD)SF: Detected n25q512a with page size 512 Bytes, erase size 128 KiB, total 128 MiB*** Warning - bad CRC, using default environment

In: serialOut: serialErr: serialBootmode: JTAG_MODENet: ZYNQ GEM: ff0e0000, phyaddr c, interface rgmii-ideth0: ethernet@ff0e0000U-BOOT for xilinx-zcu102-zu9-es2-rev1_0-2017.1

ethernet@ff0e0000 Waiting for PHY auto negotiation to complete....... doneBOOTP broadcast 1BOOTP broadcast 2BOOTP broadcast 3DHCP client bound to address 10.10.70.2 (1257 ms)Hit any key to stop autoboot: 0 Device: sdhci@ff170000Manufacturer ID: 3OEM: 5054Name: SL16G Tran Speed: 50000000Rd Block Len: 512SD version 3.0High Capacity: YesCapacity: 14.5 GiBBus Width: 4-bitErase Group Size: 512 Bytes** Invalid partition 1 **ZynqMP>

10. TFTP サーバーの IP アドレスが、イメージの存在するホストの IP アドレスに設定されていることを確認します。

これは、次のコマンドで実行できます。

ZynqMP> print serverip

11. サーバーの IP アドレスをホストの IP アドレスに設定するには、次のコマンドを実行します。

ZynqMP> set serverip <HOST IP ADDRESS>; saveenv

12. 次のコマンドを実行して、カーネルをブートします。

ZynqMP> run netboot






BSP のパッケージ

BSP は一般的な配布手段として使用するだけでなく、ザイリンクスワールドワイドテクニカルサポート (WTS) で

ケースを開く際にも使用します。ザイリンクス WTS でケースを開いてデバッグおよびサポートを受けるには、必要

小限のデザインを Petalinux BSP としてパッケージする必要があります。このセクションでは、 PetaLinux プロ

ジェクトで BSP をパッケージする方法を、例を示しながら説明します。

前提条件




BSP のパッケージ手順

WTS に提出してデバッグが行えるようにプロジェクトをパッケージする手順は次のとおりです。

1. petalinux-package コマンドは PetaLinux プロジェクトディレクトリ以外からでも実行できます。

2. 次のコマンドを実行して、 bsp をパッケージします。

$ petalinux-package --bsp -p <plnx-proj-root> --output MY.BSP

3. これにより、 MY.BSP が生成されます。これには、指定したプロジェクトの次の要素が含まれます。

° <plnx-proj-root>/project-spec/

° <plnx-proj-root>/config.project

° <plnx-proj-root>/.petalinux/

° <plnx-proj-root>/pre-built/

° その他、選択したすべてのコンポーネント

表 1‐11: TFTP を使用したハードウェア上での PetaLinux イメージ


Error: "serverip" not defined. 問題の説明

u-boot の環境変数 serverip が設定されていないことを示すエラーメッ

セージです。イメージの存在するホストの IP アドレスに設定する必要があり

ます。

解決方法

次のコマンドを実行して、 serverip を設定します。

ZynqMP> set serverip <HOST IP ADDRESS>;saveenv





BSP のその他のパッケージ方法

1. ハードウェアソースを使用して BSP をパッケージする方法

$ petalinux-package --bsp -p <plnx-proj-root> \--hwsource <hw-project-root> --output MY.BSP

この場合、指定した PetaLinux プロジェクトの <plnx-proj-root> は変更されません。指定したハードウェアプロ

ジェクトソースは MY.BSP アーカイブ内の <plnx-proj-root>/hardware/ に置かれます。

2. 外部ソースを使用して BSP をパッケージする方法

サーチパスのサポートは廃止されました。外部ソースは components/ext_sources にコピーする必要があります。

詳細は、「PetaLinux での外部カーネルおよび U-Boot 使用手順」を参照してください。 BSP をパッケージする必

要があります。

ファームウェアバージョンの設定

このセクションでは、 petalinux-config コマンドを使用してファームウェアバージョンを設定する方法につい

て説明します。

前提条件




ファームウェアバージョンの設定手順

1. PetaLinux プロジェクトのルートディレクトリに移動します。


2. 上位のシステム設定メニューを起動します。

$ petalinux-config

3. [Firmware Version Configuration] を選択します。

4. [Host Name]、 [Product Name]、 [Firmware Version] を選択し、必要に応じて編集します。

5. メニューを終了し、[Do you wish to save your new configuration?] と表示されたら <Yes> を選択し

ます。

Do you wish to save your new configuration ? <ESC><ESC>to continue.< Yes > < No >





ルートファイルシステムタイプの設定

このセクションでは、 petalinux-config コマンドを使用して RootFS タイプを設定する方法について説明します。

前提条件




ルートファイルシステムタイプの設定手順




$ petalinux-config

3. [Image Packaging Configuration] を選択します。

4. [Root file System type] を選択します。

5. 必要に応じて [INITRAMFS]、 [INITRD]、 [JFFS2]、 [NFS]、 [SD card] のいずれかを選択します。

6. 設定を保存します。

ブートイメージストレージの設定

このセクションでは、 petalinux-config コマンドを使用してフラッシュや SD/MMC などのブートデバイスを設

定する方法について説明します。

前提条件








ブートイメージストレージの設定手順




$ petalinux-config

3. [Subsystem AUTO Hardware Settings] を選択します。

4. [Advanced Bootable Images Storage Settings] を選択します。

5. [boot image settings] を選択します。

6. [Image Storage Media] を選択します。

7. 必要に応じてブートデバイスを選択します。ブートデバイスとしてフラッシュを設定するには、 [primary

flash] を選択します。 SD カードをブートデバイスにするには、 [primary sd] を選択します。

8. [Advanced Bootable Images Storage Settings] サブメニューで、 [kernel image settings] を選択します。

9. [Image Storage Media] を選択します。

10. 必要に応じてストレージデバイスを選択します。ブートデバイスとしてフラッシュを設定するには、

[primary flash] を選択します。 SD カードをブートデバイスにするには、 [primary sd] を選択します。

11. 設定を保存します。

ヒント : いったん選択を解除したメニュー /サブメニューを選択するには、下方向キー (↓) または上方向キー (↑) を

押してメニューをスクロールし、目的のメニューまでカーソルを移動して y キーを押します。メニュー /サブメ

ニューの選択を解除するには、同じ手順に従って後に n キーを押します。


このセクションでは、ブートデバイスを設定する際に発生する一般的な問題について説明します。

表 1‐12: ブートイメージストレージに関するトラブルシューティング


ERROR: Failed to config

linux/kernel!問題の説明

menuconfig で Linux カーネルコンポーネントを設定できなかったことを示すエ

ラーメッセージです。

解決方法

必要なライブラリ /パッケージが正しくインストールされていることを確認し

ます。詳細は、「インストール要件」を参照してください。





プライマリフラッシュパーティションの設定

このセクションでは、 PetaLinux の menuconfig でフラッシュパーティションを設定する方法について説明します。




$ petalinux-config

3. [Subsystem AUTO Hardware Settings] を選択します。

4. [Flash Settings] を選択します。

5. [Primary Flash] としてフラッシュデバイスを選択します。

6. 各パーティションの名前とサイズを設定します。

注記: PetaLinux ツールは boot、 bootenv (U-Boot 環境変数用) およびカーネルパーティションを使用して U-Boot コマ

ンドを生成します。

PetaLinux ツールは、パラレルフラッシュの開始アドレスまたは SPI フラッシュの開始オフセットと上記パーティ

ションのサイズを使用して次の U-Boot コマンドを生成します。

• update_boot: ブートイメージ (MicroBlaze の場合は U-Boot イメージ、 Zynq ファミリデバイスの場合は

BOOT.BIN イメージ) をプライマリフラッシュに格納するように選択している場合。

• update_kernel および load_kernel: カーネルイメージ (FIT イメージ image.ub) をフラッシュに格納するよ

うに選択している場合。

ベースルートファイルシステムの設定

このセクションでは、ベースルートファイルシステムの設定について説明します。

前提条件




ベースルートファイルシステムの設定手順




$ petalinux-config

3. [Linux Components Selection] を選択します。

4. petalinux-rootfs を rootfs として選択します。





イメージサイズの管理

エンベデッド環境では、フラッシュに格納するカーネルイメージのサイズ、および RAM におけるカーネルイメー

ジの静的サイズを縮小することが重要です。このセクションでは、 config の項目がカーネルサイズおよび RAM 使

用量に与える影響について説明します。

デフォルトのブータブルイメージフォーマットは FIT イメージです。デフォルトでは、 FIT イメージはカーネルイ

メージ、 DTB および rootfs イメージで構成されます。

前提条件




イメージサイズの管理手順

FIT イメージのサイズを縮小するには、次の手順を実行します。

1. 次のコマンドを実行して、 RootFS 設定メニューを起動します。

$ cd <plnx-proj-root>$ petalinux-config -c rootfs

[Filesystem Packages] を選択します。このサブメニューには、 RootFS パッケージに対応するオプションのリストが表示

されます。この中に不要なパッケージがある場合、これらを無効にすると RootFS イメージのサイズを縮小できます。

2. 次のコマンドを実行して、カーネル設定メニューを起動します。

$ cd <plnx-proj-root>$ petalinux-config -c kernel

[General Setup] を選択します。このサブメニューには、 config の項目を設定するオプションがあります。システム

で必須でない項目がある場合、これらを無効にするとカーネルイメージのサイズを縮小できます。たとえば

CONFIG_SHMEM、 CONFIG_AIO、 CONFIG_SWAP、 CONFIG_SYSVIPC などです。詳細は、 Linux カーネルのマニュ

アルを参照してください。

注意: 一部の config 項目を無効にすると、ブートに失敗することがあります。したがって、これらを無効にする場

合は config 項目に関する知識が求められます。

ヒント : 余分な config 項目とファイルシステムパッケージを含めると、カーネルイメージサイズと RootFS サイズが

それぞれ大きくなります。

注記: カーネルまたは rootfs のサイズが 128MB を超えた場合は、次の手順を実行する必要があります。

1. platform-top.h で Bootm の長さを定義します。

#define CONFIG_SYS_BOOTM_LEN <value greater then image size>

2. platform-top.h で CONFIG_SYS_BOOTMAPSZ の定義を削除します。





INITRAMFS ブートの設定

INITRAMFS (処理 RAM ファイルシステム) は initrd の後継です。PetaLinux 起動プロセスでメモリにロードされる

初期ファイルシステムの cpio アーカイブです。 Linux カーネルはこれを RootFS としてマウントし、初期化プロセ

スを開始します。

このセクションでは、 INITRAMFS ブートの設定方法について説明します。

前提条件

このセクションでは、新規 PetaLinux プロジェクトを作成済み ( 「新規 PetaLinux プロジェクトの作成」参照) で、

ハードウェアプラットフォームをインポート済み ( 「ハードウェアコンフィギュレーションのインポート」参照) で

あるものと仮定します。

INITRAMFS ブートの設定手順

1. RootFS タイプを INITRAMFS に設定します。詳細は、「ルートファイルシステムタイプの設定」を参照してく

ださい。

2. システムイメージをビルドします。詳細は、「システムイメージのビルド」を参照してください。

3. 次のいずれかの方法でシステムイメージをブートします。

a. QEMU で PetaLinux イメージをブートする ( 「QEMU での PetaLinux イメージのブート」参照)。

b. SD カードを使用してハードウェア上で PetaLinux イメージをブートする ( 「SD カードを使用したハードウェ

ア上での PetaLinux イメージのブート」参照)。

c. JTAG を使用してハードウェア上で PetaLinux イメージをブートする ( 「JTAG を使用したハードウェア上で

の PetaLinux イメージのブート」参照)。

重要: PetaLinux のデフォルト RootFS は INITRAMFS です。

TFTP ブートの設定

このセクションでは、ホストと PetaLinux イメージを TFTP ブートに設定する方法について説明します。

ヒント : TFTP ブートではカーネルソース変更のたびにイメージをフラッシュする必要がなく、 JTAG ブートよりも

はるかに高速なので、時間を大幅に短縮できます。

前提条件


• 新規 PetaLinux プロジェクトを作成済み ( 「新規 PetaLinux プロジェクトの作成」参照) で、ハードウェアプラッ

トフォームをインポート済み ( 「ハードウェアコンフィギュレーションのインポート」参照) であること。

• ホスト上で TFTP サーバーが動作していること。





PetaLinux の設定とシステムイメージのビルド

PetaLinux を TFTP ブート用に設定し、システムイメージをビルドする手順は次のとおりです。




$ petalinux-config


4. [Copy final images to tftpboot] を選択し、 [tftpboot directory] を設定します。デフォルトでは TFTP ディレクトリ ID

は /tftpboot です。

5. 設定を保存し、「システムイメージのビルド」で説明した手順でシステムイメージをビルドします。

NFS ブートの設定

Linux システムのも重要なコンポーネントの 1 つがルートファイルシステムです。開発用のルートファイルシス

テムには、開発に役立つすべてのツールが置かれます。このようなルートファイルシステムはサイズが非常に大き

くなることが多いため、フラッシュメモリに格納するのは困難です。

このような場合、ルートファイルシステム全体をネットワークからマウントし、ホストシステムとターゲットが同

じファイルを共有できるようにすると便利です。ルートファイルシステムは短時間で変更でき、システム実行中に

オンザフライでも変更できます。このようなシステムをセットアップする方法の 1 つとしてもよく使われるのが、

NFS です。

ヒント : NFS の場合、新規ファイルに対する手動での更新は必要ありません。

前提条件




• Linux ファイルおよびディレクトリのパーミッションがあること。

• ホスト上で NFS サーバーがセットアップされていること。


PetaLinux を NFS ブート用に設定し、システムイメージをビルドする手順は次のとおりです。




$ petalinux-config






4. [Root filesystem type] を選択します。

5. RootFS タイプとして [NFS] を選択します。

6. NFS ルートディレクトリの位置を選択し、 /home/NFSshare に設定します。

7. menuconfig を終了し、設定を保存します。自動生成された DTSI に含まれる bootargs は、 PetaLinux が SD カード

のデフォルト設定から rootfs をロードすると更新されます。

<plnx-proj-root>/components/plnx_workspace/device-tree-generation/plnx_aarch64-syst

em.dts をチェックできます。

8. システムイメージをビルドします。詳細は、「システムイメージのビルド」を参照してください。

9. bootargs の変更は、ビルド後に反映されます。

NFS によるブート

NFS ブートでは、 RootFS は NFS 経由でマウントされます。ただしブートローダー (fsbl、ビットストリーム、

U-Boot) とカーネルは、次に示すいくつかの方法でダウンロードできます。

1. JTAG: この場合、ブートローダーとカーネルは JTAG 経由でターゲットにダウンロードされます。詳細は、

「JTAG を使用したハードウェア上での PetaLinux イメージのブート」を参照してください。

ヒント : JTAG ブートで prebuilt 機能を使用する場合、イメージを prebuilt ディレクトリにパッケージする必要があり

ます。詳細は、「ビルド済みイメージのパッケージ」を参照してください。

2. TFTPBOOT: この場合、ブートローダーは JTAG 経由でダウンロードされ、カーネルは TFTPBOOT 経由でター

ゲットにダウンロードされます。詳細は、「TFTP を使用したハードウェア上での PetaLinux イメージのブート」

を参照してください。

3. SD カード : この場合、ブートローダー (BOOT.BIN) とカーネルイメージ (image.ub) は SD カードにコピーさ

れ、 SD カードからダウンロードされます。詳細は、「SD カードを使用したハードウェア上での PetaLinux イ

メージのブート」を参照してください。

SD カード外部ファイルシステムブートの設定

このセクションでは、 SD カード外部ファイルシステムブートを設定する方法について説明します。

前提条件




• 容量 4GB 以上の SD メモリカード。十分なファイル転送速度が得られるように、スピードグレード 6 以上の

カードを推奨します。





SD カードを準備する

PetaLinux SD カード外部ファイルシステムブート用に SD カードを準備する手順は次のとおりです。

1. gparted などのパーティションエディターを使用して SD カードを 2 つのパーティションにフォーマットします。

2. 第 1 パーティションは 60MB 以上のサイズとし、 FAT32 ファイルシステムでフォーマットします。このパー

ティションの前には 4MB の未割り当て領域が必要です。第 1 パーティションにはブートローダー、デバイスツ

リーおよびカーネルイメージを格納します。このパーティションは、ラベル名を BOOT とします。

3. SD カードの残り領域全体を第 2 パーティションとし、 ext4 ファイルシステムでフォーマットします。この

パーティションにはシステムルートファイルシステムを格納します。このパーティションは、ラベル名を

rootfs とします。

ヒント : 大限の性能を得るには、 SD カードのパーティションを 4MB 境界に揃える必要があります。


PetaLinux を SD カード外部ファイルシステムブート用に設定し、システムイメージをビルドする手順は次のとおり

です。




$ petalinux-config


4. [Root filesystem type] を選択します。

5. RootFS タイプとして [SD card] を選択します。

6. menuconfig を終了し、設定を保存します。自動生成された DTSI に含まれる bootargs は、 PetaLinux が SD カード

のデフォルト設定から rootfs をロードすると更新されます。

<plnx-proj-root>/components/plnx_workspace/device-tree-generation/system-conf.dtsi

をチェックできます。

注記: これらの変更はビルド後に反映されます。

7. PetaLinux イメージをビルドします。詳細は、「システムイメージのビルド」を参照してください。

8. ブートイメージを生成します。詳細は、「Zynq UltraScale+ MPSoC 用ブートイメージの生成」を参照してください。

9. 生成された rootfs.cpio.gz ファイルは images/linux ディレクトリにあります。 cpio を抽出するには、

gzip -d rootfs.cpio.gz を実行します。





イメージファイルをコピーする

このセクションでは、イメージファイルを SD カードの各パーティションにコピーする方法について説明します。



2. BOOT.BIN および image.ub を SD カードの BOOT パーティションにコピーします。 image.ub ファイルには、

デバイスツリーとカーネルイメージファイルが含まれます。

$ cp images/linux/BOOT.BIN /media/BOOT/$ cp images/linux/image.ub /media/BOOT/

3. rootfs.cpio ファイルを SD カードの rootfs パーティションにコピーし、ファイルシステムを抽出します。

$ cp images/linux/rootfs.cpio /media/rootfs/$ cd /media/rootfs$ sudo pax -rvf rootfs.cpio

この SD カード外部イメージをブートする方法は、「SD カードを使用したハードウェア上での PetaLinux イメージの

ブート」を参照してください。


ビルド済みアプリケーションの取り込み

ザイリンクス SDK など PetaLinux 以外の環境で開発したアプリケーションがある場合、アプリケーションのバイナ

リを単に PetaLinux のルートファイルシステムに追加したい場合があります。この場合、アプリケーションテンプ

レートを作成して既存のコンテンツをターゲットファイルシステムに追加できるようにする必要があります。

このセクションでは、コンパイル済みアプリケーションを PetaLinux ルートファイルシステムに取り込む方法につ


前提条件




表 1‐13: SD カード外部ファイルシステムブートの設定


EXT4-fs (mmcblk0p2): mounted

filesystem with ordered data mode.

Opts: (null) Kernel panic - not

syncing: No working init found.

問題の説明

Linux カーネルが EXT4 ファイルシステムをマウントできず、 working init を検

出できなかったことを示すメッセージです。

解決方法

SD カードの rootfs パーティションで RootFS を抽出します。詳細は、「Extract

RootFS」を参照してください。





ビルド済みアプリケーションの取り込み手順

ビルド済みアプリケーション (ここでは myapp とします) を PetaLinux ルートファイルシステムに取り込むには、次

の手順を実行します。

1. コンパイル済みコードが、 MicroBlaze や ARM など PetaLinux のターゲットアーキテクチャ用にコンパイルされ

ていることを確認します。

2. 次のコマンドを実行してアプリケーションを作成します。

$ petalinux-create -t apps --template install --name myapp --enable

3. 新規に作成されたアプリケーションディレクトリに移動します。

$ cd <plnx-proj-root>/project-spec/meta-user/recipes-apps/myapp/files/

4. このディレクトリにある myapp を削除し、ビルド済みの myapp をコピーします。

$ rm myapp$ cp <path-to-prebuilt-app> .

重要: インストールテンプレートアプリケーションによってターゲットファイルシステムにインストールされるバ

イナリデータが、実際のシステムの基盤ハードウェアインプリメンテーションと互換であることを確認する必要が

あります。

ビルド済みモジュールの取り込み

コンパイル済みカーネルモジュールがある場合、このモジュールを単に PetaLinux のルートファイルシステムに追

加したい場合があります。このセクションでは、コンパイル済みモジュールを PetaLinux ルートファイルシステム

に取り込む方法について説明します。

前提条件




ビルド済みモジュールの取り込み手順

ビルド済みモジュール (ここでは mymodule とします) を PetaLinux ルートファイルシステムに取り込むには、次の手

順を実行します。

1. コンパイル済みカーネルモジュールが、 MicroBlaze や ARM など PetaLinux のターゲットアーキテクチャ用にコ

ンパイルされていることを確認します。

2. モジュールプロジェクトを作成するには、次のコマンドを実行します。

$ petalinux-create -t apps --template install --name mymodule --enable

3. 新規に作成されたモジュールディレクトリに移動します。

$ cd <plnx-proj-root>/project-spec/meta-user/recipes-apps/mymodule/files





4. ビルド済みライブラリの mymodule を置きます。

$ cp <path-to-prebuilt-module>/gpiomod.ko./

5. mymodule.bb をエディターで開き、次のように編集します。

## This file is the mymodule recipe.#

SUMMARY = "Simple shivamod application"SECTION = "PETALINUX/apps"LICENSE = "MIT"LIC_FILES_CHKSUM = "file://${COMMON_LICENSE_DIR}/MIT;md5=0835ade698e0bcf8506ecda2f7b4f302"

SRC_URI = "file://gpiomod.ko \ "

inherit module-base

S = "${WORKDIR}"

do_install() {install -d ${D}${base_libdir}/modules/${KERNEL_VERSION}/extrainstall -m 0755 ${S}/gpiomod.ko ${D}/${base_libdir}/modules/${KERNEL_VERSION}/extra/

}

FILES_${PN} = "${base_libdir}/modules/"

6. 次を実行します。

petalinux-build

カスタムアプリケーションの追加

このセクションでは、カスタムアプリケーションを PetaLinux ルートファイルシステムに追加する方法について説

明します。

前提条件




カスタムアプリケーションの追加手順

基本的な手順は次のとおりです。

1. ワークステーションで PetaLinux プロジェクトから petalinux-create -t apps を実行してユーザーアプリケーション

を作成します。

$ cd <plnx-proj-root>$ petalinux-create -t apps [--template TYPE] --name <user-application-name> --enable





たとえば myapp という名前のユーザーアプリケーションを C (デフォルト ) で作成する場合は次のように実行し

ます。

$ petalinux-create -t apps --name myapp --enable

または

$ petalinux-create -t apps --template c --name myapp --enable

C++ アプリケーションテンプレートを作成する場合は、次のように --template c++ オプションを指定します。

$ petalinux-create -t apps --template c++ --name myapp --enable

注記: アプリケーション名に「_」が含まれる場合は、付録 H 「アプリケーション/モジュール名に「_」が含まれ

る。」を参照してください。

autoconf アプリケーションテンプレートを作成する場合は、次のように --template autoconf オプションを指定

します。

$ petalinux-create -t apps --template autoconf --name myapp --enable

新規アプリケーションは <plnx-proj-root>/project-spec/meta-user/recipes-apps/myapp ディレクト

リに作成されます。

2. 新規に作成されたアプリケーションディレクトリに移動します。

$ cd <plnx-proj-root>/project-spec/meta-user/recipes-apps/myapp

このディレクトリには、 PetaLinux のテンプレートで生成された次のファイルがあります。

注記: サードパーティユーティリティによるデバッグでビルド中間生成物を使用する場合は、

<plnx-proj-root>/project-spec/meta-user/conf/petalinuxbsp.conf に次の行を追加します。

RM_WORK_EXCLUDE += “myapp”

注記: ビルド中間生成物はすべて ${TMPDIR}/work/aarch64-xilinx-linux/myapp/1.0-r0/ にあります。

3. myapp.c/myapp.cpp は編集が可能で、アプリケーションの実際のソースコードで置き換えることができま

す。後でカスタムユーザーアプリケーションを変更する際は、このファイルを編集します。

表 1‐14: カスタムアプリケーションを追加してテンプレートで生成されるファイル

テンプレート説明

<plnx-proj-root>/project-

spec/meta-user/recipes-co

re/images/petalinux-image

.bbappend

コンフィギュレーションファイルテンプレート。このファイルは、カスタ

ムアプリケーションを PetaLinux rootfs メニューコンフィギュレーションに

どのように統合するかを制御します。また、 app および dev、 dbg パッケージ

をターゲットルートファイルシステムに含めるかどうかもこのファイルで

決定します。

Makefile コンパイルファイルテンプレート。カスタムアプリケーションをビルドし

てルートファイルシステムにインストールするためのターゲットを含む基

本的な Makefile です。ソースコードファイルをプロジェクトに追加した場

合、このファイルを編集する必要があります。

README ユーザーアプリケーションのビルド方法について説明したファイル。

myapp.c (C の場合)、

myapp.cpp (C++ の場合)

ユーザーの指定に応じて C または C++ で記述したシンプルなアプリケーショ

ンプログラム。





注意: 不要になったアプリケーションディレクトリは削除できます。アプリケーションディレクトリを削除した場

合、 <plnx-proj-root>/project-spec/meta-user/recipes-core/images/petalinux-image.bbappend を開いて

「IMAGE_INSTALL_append= “ myapp”」の行も削除する必要があります。この行を残したままディレクトリを削除す

ると、エラーになります。

カスタムモジュールの追加

このセクションでは、カスタムカーネルモジュールを PetaLinux ルートファイルシステムに追加する方法について

説明します。

前提条件




カスタムモジュールの追加手順

1. ワークステーションで PetaLinux プロジェクトから petalinux-create -t modules を実行してユーザーモジュールを

作成します。

$ cd <plnx-proj-root>$ petalinux-create -t modules --name <user-module-name> --enable

たとえば mymodule という名前のユーザーモジュールを C (デフォルト ) で作成する場合は次のように実行します。

$ petalinux-create -t modules --name mymodule --enable

または

$ petalinux-create -t modules --name mymodule --enable

petalinux-create -t モジュールの使用法は、 -h または --help オプションを使用して確認してください。

新規モジュールは <plnx-proj-root>/project-spec/meta-user/recipes-modules/mymodule ディレクト

リに作成されます。

注記: アプリケーション名に「_」が含まれる場合は、付録 H 「アプリケーション/モジュール名に「_」が含まれ

る。」を参照してください。

2. 新規に作成されたモジュールディレクトリに移動します。

$ cd <plnx-proj-root>/project-spec/meta-user/recipes-modules/mymodule





このディレクトリには、 PetaLinux のテンプレートで生成された次のファイルがあります。

3. mymodule.c は編集が可能で、モジュールの実際のソースコードで置き換えることができます。後でカスタム

ユーザーモジュールを変更する際は、このファイルを編集します。


project-spec/meta-user/conf/petalinuxbsp.conf に次の行を追加します。

RM_WORK_EXCLUDE += "mymodule"

注記: ビルド中間生成物はすべて ${TMPDIR}/work/aarch64-xilinx-linux/myapp/1.0-r0/ にあります。

注意: 不要になったモジュールディレクトリは削除できます。モジュールディレクトリを削除した場合、

<plnx-proj-root>/project-spec/meta-user/recipes-core/images/petalinux-image.bbappend を開いて

「IMAGE_INSTALL_append= “mymodule”」の行も削除する必要があります。 petalinux-image.bbappend でこの行を残し

たままディレクトリを削除すると、エラーになります。

ユーザーアプリケーションのビルド

このセクションでは、コンパイル済み/カスタムユーザーアプリケーションをビルドして PetaLinux ルートファイル

システムにインストールする方法について説明します。

前提条件

このセクションでは、コンパイル済みアプリケーションを PetaLinux ルートファイルシステムに取り込み済み ( 「ビ

ルド済みアプリケーションの取り込み」参照)、またはカスタムアプリケーションを PetaLinux ルートファイルシス

テムに追加済み ( 「カスタムアプリケーションの追加」参照) であるものと仮定します。

表 1‐15: カスタムモジュールを追加してテンプレートで生成されるファイル

テンプレート説明

Makefile コンパイルファイルテンプレート。カスタムモジュールをビルドしてルー

トファイルシステムにインストールするためのターゲットを含む基本的な

Makefile です。ソースコードファイルをプロジェクトに追加した場合、この

ファイルを編集する必要があります。 Makefile のカスタマイズ方法は、こち

らを参照してください。

README ユーザーモジュールのビルド方法について説明したファイル。

mymodule.c C で記述したシンプルなカーネルモジュール。

<plnx-proj-root>/project-

spec/meta-user/recipes-co

re/images/petalinux-image

.bbappened

コンフィギュレーションファイルテンプレート。このファイルは、カスタ

ムアプリケーションを PetaLinux rootfs メニューコンフィギュレーションシ

ステムにどのように統合するかを制御します。また、 app および dev、 dbg

パッケージをターゲットルートファイルシステムに含めるかどうかもこの

ファイルで決定します。


https://www.kernel.org/doc/Documentation/kbuild/modules.txt

https://www.kernel.org/doc/Documentation/kbuild/modules.txt




ユーザーアプリケーションのビルド手順

プロジェクトディレクトリ <plnx-proj-root> で petalinux-build を実行すると、選択したユーザーアプリ

ケーション (myapp) を含む形でシステムイメージが再ビルドされます。このビルドプロセスの出力ディレクトリは

<TMPDIR>/work/aarch64-xilinx-linux/myapp/1.0-r0/ です。

$ petalinux-build

myapp を既存のシステムイメージに含めてビルドするには、次を実行します。

$ cd <plnx-proj-root>$ petalinux-build -x do_populate_sysroot$ petalinux-build -c rootfs$ petalinux-build -x package

注記: do_populate_sysroot を指定すると、 menuconfig で選択したビルド済みパッケージに基づいて sysroot が生

成されます。 do_populate_sysroot はアプリケーションをビルドする前に少なくとも 1 回実行する必要がありま

すが、毎回実行する必要はありません。

petalinux-build のその他のオプションについては、 --help で確認してください。ここでは、一部のオプショ

ンについて説明します。

• 選択したユーザーアプリケーションをクリーンアップする方法

$ petalinux-build -c myapp -x do_clean

• 選択したユーザーアプリケーションを再ビルドする方法

$ petalinux-build -c myapp

この場合、アプリケーションのみがコンパイルされます。コンパイル済み実行ファイルは

${TMPDIR}/work/aarch64-xilinx-linux/myapp/1.0-r0/ ディレクトリに格納されます。


RM_WORK_EXCLUDE += “myapp” を

<plnx-proj-root>/<plnx-proj-root>/project-spec/meta-user/conf/petalinuxbsp.conf に追

加します。この行がないと、ビルド後にすべての実行ファイルが bitbake によって削除されます。

myapp のすべてのタスクをリスト表示する方法: petalinux-build -c myapp -x listtasks

• 選択したユーザーアプリケーションをインストールする方法

$ petalinux-build -c /myapp -x do_install

このコマンドを実行すると、アプリケーションがターゲットの rootfs ホストコピーにインストールされます。

<TMPDIR>/work/plnx_aarch64-xilinx-linux/petalinux-user-image/1.0-r0/rootfs/

注記: TMPDIR は petalinux-config メニューの [Yocto-settings --> TMPDIR] にあります。プロジェクトがローカルスト

レージにある場合、 TMPDIR は <plnx-proj-root>/build/tmp/ です。複数の異なる PetaLinux プロジェクトで

TMPDIR に同じ場所を設定するとビルドエラーが発生します。

Zynq UltraScale+ MPSoC の場合:ARCH: aarch64MACHINE: plnx_aarch64





ユーザーアプリケーションのテスト

このセクションでは、ユーザーアプリケーションのテスト方法について説明します。

前提条件

このセクションでは、コンパイル済み/カスタムユーザーアプリケーションのビルドとインストールが完了している

ものと仮定します。詳細は、「ユーザーアプリケーションのビルド」を参照してください。

ユーザーアプリケーションのテスト手順

1. 新規に作成したシステムイメージをブートします。

2. ターゲットシステムのログインコンソールで次のコマンドを実行し、ユーザーアプリケーションが PetaLinux

システムに存在することを確認します。

# ls /usr/bin

Makefile でユーザーアプリケーションの位置を変更していない限り、ユーザーアプリケーションは /usr/bin ディ

レクトリに置かれます。

3. ターゲットシステムのコンソールでユーザーアプリケーションを実行します。たとえばユーザーアプリケー

ションが myapp の場合、次のように実行します。

# myapp

4. アプリケーションの実行結果が期待どおりであることを確認します。

新規アプリケーションがターゲットファイルシステムに見つからない場合、前のセクションで説明した

petalinuxbuild -x package の手順を完了していることを確認してください。これにより、アプリケーション

バイナリがルートファイルシステムのステージングエリアにコピーされ、ターゲットシステムイメージがこの新

しいファイルシステムで更新されます。

ユーザーモジュールのビルド

このセクションでは、コンパイル済み/カスタムユーザーカーネルモジュールをビルドして PetaLinux ルートファイ

ルシステムにインストールする方法について説明します。

前提条件

このセクションでは、コンパイル済みアプリケーションを PetaLinux ルートファイルシステムに取り込み済み ( 「ビ

ルド済みモジュールの取り込み」参照)、またはカスタムモジュールを PetaLinux ルートファイルシステムに追加済

み ( 「カスタムモジュールの追加」参照) であるものと仮定します。





ユーザーモジュールのビルド手順

プロジェクトディレクトリ <plnx-proj-root> で petalinux-build を実行すると、選択したユーザーモジュー

ル (mymodule) を含む形でシステムイメージが再ビルドされます。このビルドプロセスの出力ディレクトリは

<TMPDIR>/work/{ARCH}-xilinx-linux-gnueabi/mymodule/1.0-r0/ です。

$ petalinux-build

mymodule を既存のシステムイメージに含めてビルドするには、次を実行します。

$ cd <plnx-proj-root>$ petalinux-build -c rootfs$ petalinux-build -x package

petalinux-build のその他のオプションについては、 --help で確認してください。ここでは、一部のオプショ

ンについて説明します。

• 選択したユーザーモジュールをクリーンアップする方法

$ petalinux-build -c mymodule -x do_cleansstate

• 選択したユーザーモジュールを再ビルドする方法

$ petalinux-build -c mymodule

この場合、モジュールのみがコンパイルされます。コンパイル済み実行ファイルは

<TMPDIR>/work/aarch64-xilinx-linux/mymodule/1.0-r0/ ディレクトリに格納されます。

このモジュールのすべてのタスクをリスト表示する方法: petalinux-build -c mymodule -x listtasks

• 選択したユーザーモジュールをインストールする方法

$ petalinux-build -c mymodule -x do_install

このコマンドを実行すると、モジュールがターゲットの rootfs ホストコピーにインストールされます。

<TMPDIR>/work/plnx_aarch64-xilinx-linux/petalinux-user-image/1.0-r0/rootfs/

注記: TMPDIR は petalinux-config メニューの [Yocto-settings --> TMPDIR] にあります。複数の異なる PetaLinux プロ

ジェクトで同じ TMPDIR を設定しないでください。ビルドエラーが発生します。プロジェクトがローカルストレー

ジにある場合、 TMPDIR は <plnx-proj-root>/build/tmp/ です。

Zynq UltraScale+ MPSoC の場合:ARCH: aarch64

MACHINE: plnx_aarch64





PetaLinux の自動ログイン

このセクションでは、ログイン情報を入力せずにブートから直接ログインする方法について説明します。

前提条件




PetaLinux の自動ログイン手順

PetaLinux に自動ログインする手順は次のとおりです。

1. cd <plnx-proj-root>

2. petalinux-config を実行します。

3. [Yocto-settings -->] を選択し、 [Enable debug-tweaks] を選択します。

4. 設定を保存して終了します。

5. petalinux-build を実行します。

起動時のアプリケーション自動実行

このセクションでは、システム起動時に自動的に実行するアプリケーションを追加する方法について説明します。

前提条件

このセクションでは、 PetaLinux アプリケーションの追加とビルドが完了しているものと仮定します。詳細は、「カ

スタムアプリケーションの追加」および「ユーザーアプリケーションのビルド」を参照してください。

起動時にアプリケーションを自動実行する手順

ビルド済みまたは新規に作成したカスタムユーザーアプリケーションの myapp が PetaLinux プロジェクトの

<plnx-proj-root>/project-spec/meta-user/recipes-apps/ にある場合、このアプリケーションをシス

テム起動時に自動で実行できます。自動実行を有効にする手順は次のとおりです。

ヒント : 既存のビルド済みアプリケーションを PetaLinux ルートファイルシステムに取り込んでいない場合は、「ビ

ルド済みアプリケーションの取り込み」を参照してください。

カスタムアプリケーションを作成して PetaLinux ルートファイルシステムにインストールする場合は、「カスタム

アプリケーションの追加」を参照してください。

終了することのないブロッキングアプリケーションを自動実行する場合は、このアプリケーションをデーモンとし

て実行してください。





1. 新規インストールアプリケーション myapp-init を作成します。

cd <plnx-proj-proot>/petalinux-create -t apps --template install -n myapp-init --enable

2. project-spec/meta-user/recipes-apps/myapp-init/myapp-init.bb をエディターで開き、次のよ

うに編集します。

## This file is the myapp-init recipe.#

SUMMARY = "Simple myapp-init application"SECTION = "PETALINUX/apps"LICENSE = "MIT"LIC_FILES_CHKSUM = "file://${COMMON_LICENSE_DIR}/MIT;md5=0835ade698e0bcf8506ecda2f7b4f302"

SRC_URI = "file://myapp-init \ "

S = "${WORKDIR}"

FILESEXTRAPATHS_prepend := "${THISDIR}/files:"

inherit update-rc.d

INITSCRIPT_NAME = "myapp-init"INITSCRIPT_PARAMS = "start 99 S ."

do_install() { install -d ${D}${sysconfdir}/init.d install -m 0755 ${S}/myapp-init ${D}${sysconfdir}/init.d/myapp-init}

FILES_${PN} += "${sysconfdir}/*"

3. myapp をデーモンとして実行します。

edit the file project-spec/meta-user/recipes-apps/myapp-init/files/myapp-initThe file should look like#!/bin/sh

DAEMON=/usr/bin/myapp

start (){ echo " Starting myapp" start-stop-daemon -S -o --background -x $DAEMON}

stop (){ echo " Stoping myapp" start-stop-daemon -K -x $DAEMON}

restart()





{ stop start}

[ -e $DAEMON ] || exit 1

case "$1" in start) start; ;; stop) stop; ;; restart) restart; ;; *) echo "Usage: $0 {start|stop|restart}" exit 1 esacexit $?


QEMU による Linux カーネルのデバッグ

このセクションでは、 QEMU 環境で GDB デバッガーを使用して Linux カーネルをデバッグする方法について説明し

ます。なお、この機能は Zynq ファミリデバイスプラットフォームでのみテストしています。

前提条件



QEMU による Linux カーネルのデバッグ手順

1. 次のコマンドを実行し、現在ビルド済みの Linux を使用して QEMU を起動します。

$ petalinux-boot --qemu --kernel

2. コンソールに QEMU コマンドの詳細が表示されます。-gdb tcp:<TCP_PORT> で GDB の TCP ポートを確認し

ます。

3. PetaLinux の settings スクリプトが実行済みであることを確認して別のコマンドコンソールを開き、 Linux ディレ

クトリに移動します。

$ cd "<plnx-proj-root>/images/linux"

4. vmlinux カーネルイメージに対してコマンドモードで GDB を起動します。

$ petalinux-util --gdb vmlinux





gdb プロンプトが表示されます。次に例を示します。

GNU gdb (Linaro GDB 2017.01) 7.12.1.20170130-gitCopyright (C) 2017 Free Software Foundation, Inc.License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>This is free software: you are free to change and redistribute it.There is NO WARRANTY, to the extent permitted by law. Type "show copying"and "show warranty" for details.This GDB was configured as "--host=x86_64-unknown-linux-gnu --target=aarch64-linux-gnu".Type "show configuration" for configuration details.For bug reporting instructions, please see:<http://www.gnu.org/software/gdb/bugs/>.Find the GDB manual and other documentation resources online at:<http://www.gnu.org/software/gdb/documentation/>.For help, type "help".Type "apropos word" to search for commands related to "word"...Reading symbols from vmlinux...done.

5. 次の GDB コマンドを実行し、 GDB で QEMU ターゲットに接続します。

(gdb) target remote :9000

6. QEMU の実行を継続します。

(gdb) continue

7. Ctrl+C キーを押すとカーネル実行を中断して GDB プロンプトに戻ることができます。

8. ブレークポイントを設定し、ほかの GDB コマンドを実行してカーネルをデバッグできます。

注意: ポート 9000 がほかのプロセスで使用中の場合、 petalinux-boot は別のポートの使用を試みます。 petalinux-boot の

出力を見て、どのポートが使用されているかを確認してください。次の例では、ポート 9001 が使用されています。

INFO: qemu-system-arm ...-gdb tcp::9001 ...

ヒント : petalinux-config --kernel を実行し、カーネルコンフィギュレーションメニューで [Kernel hacking] → [Kernel

debugging] を選択してカーネルデバッグを有効にし、カーネルデバッグシンボルをイメージに含めることを推奨し

ます。


このセクションでは、 QEMU で Linux カーネルをデバッグする際に発生する一般的な問題について説明します。

表 1‐16: QEMU による Linux カーネルのデバッグに関するトラブルシューティング


(gdb) target remote

W.X.Y.Z:9000:9000:

Connection refused.

問題の説明

GDB から QEMU ターゲットへの接続に失敗しました。 QEMU がポート 9000

を使用していないことが考えられます。

解決方法

• QEMU コンソールをチェックし、 QEMU が動作していることを確認します。

• Linux ホストコマンドラインコンソールを確認します。ここにはすべての

QEMU コマンドが表示されるため、 QEMU が使用しているポートを確認で

きます。





TCF エージェントによるアプリケーションのデバッグ

このセクションでは、 Eclipse TCF (Target Communication Framework) エージェントを使用してユーザーアプリケー

ションをデバッグする方法について説明します。このセクションでは、 Zynq ユーザーアプリケーション myapp を例

に、基本的なデバッグ手順について説明します。

前提条件


• XSDK ツールの使用経験があること。

• Vivado ツールの作業環境が正しくセットアップされていること。詳細は、「PetaLinux 作業環境のセットアップ」


• ユーザーアプリケーションを作成済みで、選択したユーザーアプリケーションを含むシステムイメージをビル

ド済みであること。詳細は、「ユーザーアプリケーションのビルド」を参照してください。

デバッグ用のビルドシステムを準備する手順

1. プロジェクトディレクトリに移動します。


2. コマンドコンソールで petalinux-config -c rootfs を実行します。

$ petalinux-config -c rootfs

3. [linux/rootfs Configuration] メニューを下方へスクロールし、 [Filesystem Packages] を選択します。次のサブメ

ニューが表示されます。

admin ---> audio ---> base ---> baseutils ---> benchmark ---> bootloader ---> console ---> devel ---> fonts ---> kernel ---> libs ---> misc ---> multimedia ---> net ---> network ---> optional ---> utils ---> x11 --->

4. [base --->] サブメニューを選択し、 [misc --->] サブメニューを選択します。

base --->baseutils --->benchmark --->console --->devel --->





fonts --->kernel -->libs --->misc --->multimedia -->net -->network -->optional -->utils -->xll -->

5. アルファベット順にパッケージが表示されます。「t」で始まる項目までスクロールします。

serf ---> sysfsutils ---> sysvinit-inittab ---> tbb ---> tcf-agent ---> texi2html ---> tiff ---> trace-cmd ---> util-macros ---> v4l-utils --->

6. [tcf-agent] が選択されていることを確認します。

[*] tcf-agent[ ] tcf-agent-dev[ ] tcf-agent-dbg

7. [console/network --->] サブメニューを選択し、 [dropbear --->] サブメニューを選択します。

[dropbear-openssh-sftp-server] が選択されていることを確認します。

[*] dropbear-openssh-sftp-server

8. メニューを終了します。

9. myapp を含めたターゲットシステムイメージを再ビルドします。詳細は、「システムイメージのビルド」を参

照してください。

デバッグセッションの実行手順

1. 新しいイメージでボード (または QEMU) をブートします。

2. tcf-agent が開始したことがブートログに記録されます。これは、次のメッセージで確認できます。

Starting tcf-agent: OK

3. ザイリンクス SDK を起動し、ワークスペースを作成します。

4. [File] → [New] → [Project] をクリックしてハードウェアプラットフォーム仕様を追加します。

5. ウィザード画面で [Xilinx] → [Hardware Platform Specification] をクリックします。

6. ハードウェアプロジェクトに名前を付けます (例: ZC702)。

7. ターゲットハードウェア用の system.hdf を見つけます。このファイルは、

<plnx-proj-root>/project-spec/hw-description/system.hdf にあります。

8. [Run] → [Debug Configurations] をクリックし、 [Debug Launch Configuration] ウィンドウを開きます。





9. [Xilinx C/C++ application (System Debugger)] をクリックして新規作成し、設定画面を開きます。

10. [Debug Type] は [Linux Application Debug] に設定します。

11. [New] をクリックして接続の詳細を入力します。

12. ターゲット接続に名前を付け、ホスト (ターゲットの IP アドレス) を指定します。

13. tcf-agent のポートを設定して [OK] をクリックします。

X-Ref Target - Figure 1-1

図 1‐1: XSDK デバッグ設定


図 1‐2: XSDK デバッグの新規ターゲット設定





重要: QEMU でデバッグを実行する場合、非ルート (デフォルト ) またはルートモードでテストする際の IP および

ポートリダイレクトの詳細は、付録 D 「QEMU 仮想ネットワーキングモード」を参照してください。たとえば非

ルートモードでテストする場合、以降の手順でターゲット IP として localhost を使用する必要があります。

14. [Application] タブをクリックします。

15. [Local File Path] に、プロジェクトディレクトリのコンパイル済みアプリケーションのパスを指定します

(例: <TMPDIR>/work/aarch64-xilinx-linux/myapp1/1.0-r0/image/usr/bin/)。

注記:デバッグ用イメージを残すには、アプリケーションを作成する際に

project-spec/meta-user/conf/petalinuxbsp.conf に「RM_WORK_EXCLUDE += “myapp”」を追加し

ておく必要があります。

16. ターゲットファイルシステムの [Remote File Path] には、アプリケーションがあるディレクトリを指定します

(例: /usr/bin/myapp)。

17. [Debug] をクリックすると設定が適用され、デバッグセッションが開始します (デバッグパースペクティブ切り

替えの確認を求められた場合は、承諾します)。

18. これで、標準 XSDK デバッグフローを開始できます。


図 1‐3: XSDK デバッグ設定





ヒント : コードの解析とデバッグには、次のショートカットキーを使用できます。

Step Into (F5)

Step Over (F6)

Step Return (F7)

Resume (F8)


図 1‐4: XSDK デバッグ





GDB による Zynq UltraScale+ MPSoC アプリケーションのデバッグ

PetaLinux は、 GDB による Zynq UltraScale+ MPSoC ユーザーアプリケーションのデバッグをサポートしています。

このセクションでは、基本的なデバッグ手順について説明します。

前提条件


• Vivado ツールの作業環境が正しくセットアップされていること。詳細は、「PetaLinux 作業環境のセットアップ」


• ユーザーアプリケーションを作成済みで、選択したユーザーアプリケーションを含むシステムイメージをビル

ド済みであること。詳細は、「ユーザーアプリケーションのビルド」を参照してください。

デバッグ用のビルドシステムを準備する手順

1. プロジェクトディレクトリに移動します。


2. コマンドコンソールで petalinux-config -c rootfs を実行します。

$ petalinux-config -c rootfs

3. [linux/rootfs Configuration] メニューを下方へスクロールし、 [Debugging] を選択します。

Filesystem Packages --->Libs --->Apps --->Modules --->User packages --->PetaLinux RootFS Settings --->

4. [Apps -->] を選択し、 [myapp -->] を選択します。

[ ] myapp

[X] myapp-dbg

[ ] myapp-dev

[myapp-dbg] を選択します。 myapp サブメニューを終了します。

5. [App] サブメニューを終了し、 [Filesystem Packages] を選択した後、 [base] サブメニューを選択します。

misc

6. gdb サブメニューオプションを選択し、 [gdbserver] を選択します。

selecting_gdb server

[ ] gdb

[ ] gdb-dev

[X] gdbserver

[ ] gdb-dbg





7. メニューを終了し、 <Yes> を選択して設定を保存します。

8. ターゲットシステムイメージを再ビルドします。詳細は、「システムイメージのビルド」を参照してください。

デバッグセッションの実行手順

1. 上で作成した新しいイメージでボード (または QEMU) をブートします。

2. ターゲットシステムコンソールでユーザーアプリケーションに gdbserver を実行します (ポート 1534 をリッ

スンするように設定)。

root@plnx_aarch64:~# gdbserver host:1534 /usr/bin/myappProcess /bin/myapp created; pid = 73Listening on port 1534

1534 は gdbserver ポートです。未使用ポートであればほかのポートでもかまいません。

3. ワークステーションで、コンパイル済みユーザーアプリケーションのディレクトリに移動します。

$ cd <plnx-proj-root>/build/linux/rootfs/apps/myapp

4. GDB クライアントを実行します。

$ petalinux-util --gdb myapp

5. GDB コンソールが開始します。

...GNU gdb (crosstool-NG 1.18.0) 7.6.0.20130721-cvs...(gdb)

6. GDB コンソールで次のコマンドを実行し、ターゲットマシンに接続します。

a. ターゲットシステムの IP アドレスを使用する (例: 192.168.0.10)。 IP アドレスが分からない場合は、ター

ゲットコンソールで ifconfig を実行して確認します。

b. ポート 1534 を使用する。前の手順で gdbserver のポート番号を変更している場合は、その値を使用します。

重要: QEMU でデバッグを実行する場合、非ルート (デフォルト ) またはルートモードでテストする際の IP および

ポートリダイレクトの詳細は、「QEMU 仮想ネットワーキングモード」を参照してください。たとえば非ルート

モードでテストする場合、以降の手順でターゲット IP として localhost を使用する必要があります。

(gdb) target remote 192.168.0.10:1534

GDB コンソールがリモートターゲットに接続します。ターゲットコンソールの gdbserver により、ホスト IP の

確認情報が表示されます。

Remote Debugging from host 192.168.0.9

7. プログラムの実行を始める前に、ブレークポイントをいくつか作成します。 GDB コンソールでは、関数名と行

番号を使用してコードの任意の場所にブレークポイントを作成できます。たとえば main 関数に対するブレー

クポイントは次のようにして作成します。

(gdb) break mainBreakpoint 1 at 0x10000444: file myapp.c, line 10.

8. GDB コンソールで continue コマンドを実行し、プログラムを実行します。 GDB はプログラムの実行を開始します。

(gdb) continueContinuing.Breakpoint 1, main (argc=1, argv=0xbffffe64) at myapp.c:1010 printf("Hello, PetaLinux World!\n");





9. 現在のプログラム実行位置のコードリストを出力するには、 list コマンドを実行します。

(gdb) list5 */6 #include <stdio.h>78 int main(int argc, char *argv[])9 {10 printf("Hello, PetaLinux World!\n");11 printf("cmdline args:\n");12 while(argc--)13 printf("%s\n",*argv++);14

10. step、 next および continue コマンドを実行できます。ブレークポイントの設定と削除は break コマンドで

行います。コマンドに関する詳細は、 GDB コンソールで help コマンドを実行して確認してください。

11. プログラム実行が完了すると、ターゲットシステムの GDB サーバーアプリケーションが終了します。コン

ソールには次のようなメッセージが表示されます。

Hello, PetaLinux World!cmdline args:/usr/bin/myappChild exited with status 0GDBserver exitingroot@plnx_aarch64:~#

ヒント : ライブラリへのパスを記述した .gdbinit ファイルが自動的に作成されます。このファイルの末尾に、独自の

GDB 初期化コマンドを追加できます。

GDB の詳細

GDB の一般的な使用法について、詳細は www.gnu.org にアクセスし、GDB プロジェクトの資料を参照してください。


このセクションでは、 GDB でアプリケーションをデバッグする際に発生する一般的な問題について説明します。

表 1‐17: GDB による Zynq UltraScale+ MPSoC アプリケーションのデバッグに関するトラブルシューティング


GDB error message: <IP

Address>:<port>: Connection

refused. GDB cannot connect to the

target board using <IP>: <port>

問題の説明

GDB クライアントが GDB サーバーに接続できなかったことを示すエラーメッ

セージです。

解決方法

• ターゲットシステムで gdbserver が動作していることを確認します。

• 既に別の GDB クライアントが GDB サーバーに接続していないか確認しま

す。これは、ターゲットコンソールの表示を見て確認します。たとえば Remote Debugging from host <IP>

と表示される場合、既に別の GDB クライアントがサーバーに接続しています。

• IP アドレスとポートが正しく設定されていることを確認します。



http://www.gnu.org/software/gdb/documentation/



out‐of‐tree ビルドの設定

PetaLinux には、新版のカーネル/U-Boot ソースコードを Git リポジトリから自動的にダウンロードする機能があ

ります。このセクションでは、この機能のしくみおよびシステムレベルの menuconfig での使用法について説明しま

す。このセクションで説明するように、 out-of-tree ビルドには 2 つの方法があります。

前提条件


• PetaLinux ツールのソフトウェアプラットフォームを使用して実際のハードウェアプラットフォームにカスタ

マイズした Linux システムをビルドできる準備が完了していること。詳細は、「ハードウェアコンフィギュレー

ションのインポート」を参照してください。

• インターネット経由で git にアクセスできること。

out‐of‐tree ビルドの設定手順

UBOOT/Kernel の out-of-tree ビルドを設定する手順は次のとおりです。




$ petalinux-config

3. [linux Components Selection --->] サブメニューを選択します。

° カーネルの場合、 [linux-kernel () --->] を選択後、 [remote] を選択します。

( ) linux-xlnx

( ) ext-local-src

(X) remote

° U-Boot の場合、 [u-boot () --->] を選択後、 [remote] を選択します。

( ) u-boot-plnx

(X) remote

( ) ext-local-src

4. カーネルの場合、 [Remote linux-kernel settings --->] を選択後、 [Remote linux-kernel git URL] を選択し、 Linux カー

ネルの git URL を入力します。

次に例を示します。

git://github.com/Xilinx/linux-xlnx.git;protocol=https

U-Boot の場合、 [Remote u-boot settings --->URL] を選択後、 [Remote u-boot git URL] を選択し、 U-Boot の git URL

を入力します。次に例を示します。

git://github.com/Xilinx/u-boot-xlnx.git;protocol=https

注記: 「git://」で始まる URL を入力する必要があります。





[Remote git TAG/commit ID] で git タグを設定します。

次に示すいずれかの値を設定しないと、エラーメッセージが表示されます。

1 - リポジトリの HEAD を示す値

${AUTOREV}

2 - 任意のタグを示す値 petalinux-v2017.1-final

3 - 任意の Commit ID を示す値

commit id sha key

注記: git ブランチ上のタグまたは Commit ID は設定できません。マスターのタグまたは Commit ID である必要が

あります。ブランチ、またはブランチのタグ/Commit ID を使用する場合は、 git をローカルにチェックアウトし、

手順 3 で ext-local-src を選択してください。

5. メニューを終了し、設定を保存します。

PetaLinux での外部カーネルおよび U‐Boot 使用手順

PetaLinux にはカーネルソースと U-Boot ソースが含まれます。ただし PetaLinux で独自のカーネルと U-Boot をビル

ドすることもできます。

PetaLinux はカーネル、 U-Boot および ATF のローカルソースをサポートしています。

外部ソースの場合、ディレクトリ <plnx-proj-root>/components/ext_sources/ を作成します。

1. カーネルソースディレクトリを次のディレクトリにコピーします。

<plnx-proj-root>/components/ext_sources/<MY-KERNEL>

2. U-Boot ソースディレクトリを次のディレクトリにコピーします。

<plnx-proj-root>/components/ext_sources/<MY-U-BOOT>

3. petalinux-config を実行し、 [linux Components Selection --->] サブメニューを選択します。

° カーネルの場合、 [linux-kernel () --->] を選択後、 [ext-local-src] を選択します。

( ) linux-xlnx

(X) ext-local-src

( ) remote

° U-Boot の場合、 [u-boot () --->] を選択後、 [ext-local-src] を選択します。

( ) u-boot-plnx

( ) remote

(X) ext-local-src

4. カーネルの場合、 [External linux-kernel local source settings --->] を選択します。

5. パスを入力します。

${TOPDIR}/../components/ext_sources/<MY-KERNEL>

6. U-Boot の場合、 [External u-boot local source settings --->] を選択します。パスを入力します。

${TOPDIR}/../components/ext_sources/<MY-U-BOOT>${TOPDIR} --> is the yocto variable pointing to <plnx-proj-root>/build directory





ソースの絶対パスを指定することもできますが、ソースで BSP を使用する間、ユーザーがパスを変更する必要があ

ります。ソースパスはユーザーが責任を持って変更する必要があります。ソースはプロジェクト外部にも配置でき

ます。

注記: プロジェクトで外部ソースを使用して BSP を作成する場合、ユーザーの責任でソースをプロジェクトにコピー

してパッケージする必要があります。詳細は、「BSP のパッケージ」を参照してください。


このセクションでは、 out-of-tree ビルドを設定する際に発生する一般的な問題について説明します。

デバイスツリーの設定

このセクションでは、デバイスツリーの設定時に編集しても安全なファイル、およびデバイスツリーに新しい情報

を追加する方法について説明します。

前提条件




表 1‐18: out‐of‐tree ビルドの設定に関するトラブルシューティング

問題/エラーメッセージ

fatal: The remote end hung up

unexpectedly ERROR: Failed to get

linux-kernel

問題の説明

システムがリモート git URL を使用してソースコード (Kernel/UBOOT) をダ

ウンロードできず、 petalinux-build を実行できなかったことを示すエラーメッ

セージです。

解決方法

• 入力したリモート git URL が正しいことを確認します。

• 上の方法で解決しない場合、

次のコマンドを実行してビルドをクリーンアップします。

$ petalinux-build -x mrproper

このコマンドを実行すると、次のディレクトリが削除されます。

° < plnx-proj-root>/images/

° <plnx-proj-root>/build/

システムイメージを再ビルドします。詳細は、「システムイメージのビルド」






デバイスツリーを設定する

PetaLinux のデバイスツリー設定には、

<plnx-projroot>/project-spec/meta-user/recipes-bsp/device-tree/ にある次の config ファイルが

関係します。

• multi-arch/

• system-user.dtsi

• xen-overlay.dtsi

• zynqmp-qemu-arm.dts

• openamp-overlay.dtsi

• xen-qemu-overlay.dtsi

ファイルは <plnx-projroot>/components/plnx_workspace/device-tree-generation/ ディレクトリに

生成されます。

注意: 上記の dtsi ファイルはすべてツールによって生成されます。これらのファイルを編集することは推奨しません。

<plnx-projroot>/project-spec/meta-user/recipes-bsp/device-tree にはデバイスツリーの bbappend

とファイルディレクトリが格納されます。このファイルディレクトリにある system-user.dtsi は編集可能です。

デバイスツリーファイルの詳細は、付録 A 「PetaLinux プロジェクトの構造」を参照してください。

注意: 上記の DTSI ファイル (*.dtsi) は自動で生成されるため、ユーザーによる編集はしないでください。

イーサネット PHY などの情報を追加する場合は、 system-user.dtsi ファイルに追加してください。この場合、

情報 (ここではイーサネット PHY の情報) はボードレベル (ボード固有) のため、デバイスツリーにはプラット

フォーム固有の情報を含めるようにします。

注記: このように手動での操作が必要なのは、一部の情報はボードレベルであり、何を含めるべきかをツールが判断

できないためです。各デバイスのバインディングの詳細は、 Linux カーネルデバイスツリーバインディングドキュ

メント (カーネルソースのルート下の Documentation/devicetree/bindings) を参照してください。

次に、 system-user.dtsi の整形式のデバイスツリーノードの例を示します。

/dts-v1/;/include/ "system-conf.dtsi"/ {};&gem0 {

phy-handle = <&phy0>;ps7_ethernet_0_mdio: mdio {

phy0: phy@7 {compatible = "marvell,88e1116r";device_type = "ethernet-phy";reg = <7>;

};};

};

重要: デバイスツリーのノード名、 MDIO アドレスおよび互換文字列が、実際のシステムの命名規則に対応している

必要があります。





次に、例として sample-user-1.dtsi を追加する手順を示します。

1. project-spec/meta-user/recipes-bsp/device-tree/files/system-user.dtsi をエディターで開

き、「/include/ "system-user-1.dtsi」を追加します。次に、編集結果を示します。

/include/ "system-conf.dtsi"/include/ "system-user-1.dtsi"/ {};

2. project-spec/meta-user/recipes-bsp/device-tree/device-tree-generation_%.bbappend を

エディターで開き、「file://system-user-1.dtsi」を追加します。次に、編集結果を示します。

SRC_URI_append ="\ file://system-user.dtsi \

file://system-user-1.dtsi \"FILESEXTRAPATHS_prepend := "${THISDIR}/files:"

<plnx-proj-root>/components/plnx_workspace/device-tree-generation/ の内容を変更することは推

奨しません。

変更はすべて meta-user に対して行う必要があります。たとえば何らかの変更が必要な場合、変更のある meta-user レ

イヤーのノード全体を meta-user で書き換えます。 meta-user で delete-node を使用すると、生成された dtsi から特定の

ノードを削除できます。

U‐Boot の設定

このセクションでは、 U-Boot の設定時に編集しても安全なファイル、および U-Boot CONFIG_ オプション/設定につ


前提条件




U‐Boot を設定する

通常、 U-Boot (Universal Bootloader) のコンフィギュレーションは、 C プリプロセッサ define を使用して行います。

• コンフィギュレーション _OPTIONS_:

コンフィギュレーションオプションを選択できるようになります。名前の先頭には「CONFIG_」が付きます。

• コンフィギュレーション _SETTINGS_:

これらはハードウェアなどに依存します。名前の先頭には「CONFIG_SYS_」が付きます。

ヒント : CONFIG_ オプション/設定の文書の詳細な説明、および U-Boot の README は、 Denx U-Boot ガイドにあり

ます。



http://www.denx.de/wiki/view/DULG/UBoot



PetaLinux の U-Boot 設定には、 <plnxproj_root>/project-spec/ meta-plnx-generated/recipes-bsp/

u-boot/configs にあるコンフィギュレーションファイルの config.mk と platform-auto.h、および

<plnxproj_root>/project-spec/meta-user/recipes-bsp/ u-boot/files/ にある platform-top.h

が関係します。

U-Boot 環境変数を設定するには、 platform-auto.h で CONFIG_EXTRA_ENV_SETTINGS 変数を編集します。

なお、 platform-auto.h は「petalinux-config」を実行するたびに生成されます。

注意: config.mk と platform-auto.h は自動的に生成されます。これらのファイルは編集しないでください。

PetaLinux は現在、 CONFIG_ オプション/設定に関して U-Boot の設定の自動化をサポートしていません。これらの

CONFIG_ オプション/設定を platform-top.h に追加できます。

CONFIG_ オプション (たとえば CONFIG_CMD_MEMTEST) を platform-top.h に追加する手順は次のとおりです。

• PetaLinux プロジェクトのルートディレクトリに移動します。


• platform-top.h を開きます。

$ vi project-spec/meta-user/recipes-bsp/u-boot/files/platform-top.h

• CONFIG_CMD_MEMTEST オプションを追加する場合は、このファイルに次の行を追加します。変更を保存し

ます。

#define CONFIG_CMD_MEMTEST

ヒント : CONFIG_CMD_MEMTEST を定義しておくと、簡単な RAM テストに使用するモニターコマンドの「mtest」

を利用できるようになります。

• U-Boot イメージをビルドします。

$ petalinux-build -c u-boot

• 次のコマンドを実行し、 BOOT.BIN を生成します。

$ petalinux-package --boot --fsbl <FSBL image> --fpga <FPGA bitstream> --u-boot

• ハードウェアまたは QEMU でイメージをブートし、 U-Boot ステージで停止します。

• U-Boot コンソールで次のように「「mtest」コマンドを実行します。

U-Boot-PetaLinux> mtest

• U-Boot コンソールの出力は次のようになります。

Testing 00000000 ... 00001000:Pattern 00000000 Writing... Reading...Iteration: 20369

重要: CONFIG_CMD_MEMTEST を定義していない場合、 U-Boot コンソールの出力は次のようになります。

U-Boot-PetaLinux> mtest

Unknown command ’mtest’ - try ’help’




第 2章

Yocto の機能この章では、 Yocto の各種機能について説明します。

プロジェクトでの BitBake へのアクセス

BitBake は bash シェルでのみ使用できます。

Zynq UltraScale+ MPSoC で BitBake ユーティリティにアクセスする手順:

1. 必要な環境をセットアップするには、プロジェクトを作成後、 petalinux-config または

petalinux-config --oldconfig を少なくとも 1 回実行する必要があります。

2. PetaLinux ツールのスクリプトを実行します。

source /opt/pkg/petalinux/settings.sh

3. Yocto e-SDK を実行します。

source /opt/pkg/petalinux/components/yocto/source/aarch64/environment-setup-aarch64-xilinx-linux

4. 環境セットアップスクリプトを実行します。

source /opt/pkg/petalinux/components/yocto/source/aarch64/layers/core/oe-init-build-env

5. この手順の後、 build ディレクトリにリダイレクトされます。 bitbake を実行するには、 build ディレクトリにとど

まる必要があります。

6. XSCT をエクスポートします。

export PATH=/opt/pkg/petalinux/tools/hsm/bin:$PATH

7. レシピへの PETALINUX 変数を解析します。

export BB_ENV_EXTRAWHITE="$BB_ENV_EXTRAWHITE PETALINUX"

8. bitbake が利用できるかどうかを調べるため、次のコマンドを実行します。

bitbake fsbl -c cleansstatebitbake fsbl

生成されたイメージは deploy ディレクトリに格納されます。ほかのコマンドを利用するには、生成されたイメージ

を <plnx-proj-root>/images/linux ディレクトリにコピーする必要があります。




第 2 章: Yocto の機能

Yocto e‐SDK レイヤーから petalinux‐image‐full.bb へのレシピの追加

rootfs の menuconfig には petalinux-image の内容が反映されます。 petalinux-image ターゲットはザイリンクスによって

サポートされます。

例として、 alsa-utils を追加する手順を次に示します。

1. レシピは yocto e-SDK の次の場所にあります。

/opt/pkg/petalinux/components/yocto/source/aarch64/layers/core/meta/recipes-multime

dia/alsa/

2. <plnx-proj-root>/project-spec/meta-user/recipes-core/images/petalinux-image.bbappend

をエディターで開き、次の行を追加します。

IMAGE_INSTALL_append = " alsa-utils"

3. petalinux-config -c rootfs を実行します。

[user packages -->] を選択し、 [alsa-utils-->] を選択します。

有効にした後、保存して終了します。


注記: petalinux-image 以外に、ユーザーの責任で PetaLinux ツールで利用できるレイヤーにレシピを追加する必要

があります。

重要: petalinux-image に含まれるレシピのすべてで sstate がロックされています。ロックを解除するには、

project-spec/meta-user/conf/petalinuxbsp.conf に SIGGEN_UNLOCKED_RECIPES += "my-recipe" を追加する必要があり

ます。

注記: 「_append」を使用する場合は、「= “」の直後にスペースが必要です。





パッケージグループの追加

イメージをカスタマイズする場合、カスタムパッケージグループを作成し、これを用いてイメージをビルドすると

いう方法が特に推奨されます。 PetaLinux ツールには、いくつかのパッケージグループレシピが付属しています。


$PETALINUX/components/yocto/source/aarch64/layers/meta-petalinux/recipes-core/packagegroups/packagegroup-petalinux-x11.bb

注記:パッケージグループの名前は、既存のレシピ名と競合しない一意の名前とする必要があります。

次に、例として ALSA という名前のカスタムパッケージグループを作成する方法を示します。

DESCRIPTION = "PetaLinux ASLA supported Packages"

inherit packagegroup

ALSA_PACKAGES = " \ alsa-lib \ alsa-plugins \ alsa-tools \ alsa-utils \ alsa-utils-scripts \ pulseaudio \ "RDEPENDS_${PN}_append_zynqmp += " \ ${ALSA_PACKAGES} \ "

これは、

<plnx-proj-root>/meta-user/recipes-core/packagegroups/packagegroup-petalinux-alsa.bb に

追加できます。

このパッケージグループを rootfs menuconfig に追加するには、

<plnx-proj-root>/project-spec/meta-plnx-generated/recipes-core/petalinux-image.bbappend

に「IMAGE_INSTALL_append = " packagegrouppetalinux-alsa"」を追加して menuconfig に反映されるよ

うにします。

次に petalinux-config -c rootfs を実行し、 [user packages --->]、 [packagegroup --->]、 [petalinux-alsa] の順に選択して保存

し、 petalinux-build を終了します。





sstate‐cache の共有

Yocto e-SDK には小限の共有 sstate-cache が含まれます。ザイリンクスは、完全な petalinux-image 共有 sstate-cache

を http://petalinux.xilinx.com/sswreleases/rel-v2017.1/ でホスティングしています。

petalinux-build の実行中、 bitbake は小セットの PetaLinux ツール内で sstate-cache を探します。この場所に

sstate-cache が見つからない場合、 bitbake は www.xilinx.com で sstate-cache を探します。それでも sstate-cache が見つか

らない場合、 bitbake は新規に sstate-cache をビルドします。 sstate はシグネチャでロックされています。既に存在する

rootfs コンポーネントに対して .bbappend ファイルを追加する場合、

<plnx-proj-root>/project-spec/meta-user/conf/petalinuxbsp.conf に

「SIGGEN_UNLOCKED_RECIPES += "<component>"」を追加する必要があります。




付録 A

PetaLinux プロジェクトの構造このセクションでは、 PetaLinux プロジェクトのファイルおよびディレクトリ構造について簡単に説明します。

PetaLinux プロジェクトは、一度に 1 つの Linux システム開発をサポートします。ビルドした Linux システムは次のコ

ンポーネントで構成されます。

• デバイスツリー

• 第 1 段階ブートローダー (オプション)

• U-Boot

• Linux カーネル

• rootfs。 rootfs は次のコンポーネントで構成されます。

° ビルド済みパッケージ

° Linux ユーザーアプリケーション (オプション)

° ユーザーモジュール (オプション)

PetaLinux プロジェクトディレクトリにはプロジェクトのコンフィギュレーションファイル、 Linux サブシステム、

およびサブシステムのコンポーネントが含まれます。 petalinux-build コマンドを実行すると、これらコンフィ

ギュレーションファイルを使用してプロジェクトがビルドされます。設定は petalinux-config を実行して変更

できます。次に、 PetaLinux プロジェクトの例を示します。

<plnx-proj-root>-components

- plnx_workspace- device-tree-generation- fsbl- fsbl_bsp- fsbl_hwproj- .metadata- pmu-firmware- pmu-firmware_bsp- pmu-firmware_hwproj- SDK.log- .Xil

-config.project-.gitignore-hardware-.petalinux pre-built

-linux- etc- images- implementation

- project-spec-attributes-configs





- config- rootfs_config

- hw-description- meta-plnx-generated

- conf- COPYING.MIT- README- recipes-bsp- recipes-core- recipes-kernel

- meta-user- conf- COPYING.MIT- README- recipes-apps- recipes-bsp- recipes-core- recipes-kernel- yocto-layer.log

- README

表 A‐1: PetaLinux プロジェクトの説明

PetaLinux プロジェクトのファイル/ディレクトリ

説明

<plnx-proj-root>/.petalinux/ ツールの使用状況と WebTalk データを格納するディレクトリ

<plnx-proj-root>/config.project/ プロジェクトコンフィギュレーションファイル

<plnx-proj-root>/project-spec プロジェクトのプロジェクト仕様

<plnx-proj-root>/project-spec/

hw-descriptionVivado からインポートしたハードウェア記述

<plnx-projroot>/project-spec/

configs上位 config および rootfs config のコンフィギュレーションファイル


configs/configユーザー設定を格納するためのコンフィギュレーションファイル


configs/rootfs_configルートファイルシステムに使用するコンフィギュレーションファイル

<plnx-proj-root>/components/

plnx_workspace/device-tree-

generation/

デバイスツリーのビルドに使用するデバイスツリーファイル。

次のファイルが petalinux-config によって自動生成されます。

• skeleton.dtsi (Zynq-7000 のみ)

• zynq-7000.dtsi (Zynq-7000 のみ)

• zynqmp.dtsi (Zynq UltraScale+ MPSoC のみ)

• pcw.dtsi (Zynq-7000 および Zynq UltraScale+MPSoC のみ)

• pl.dtsi

• system-conf.dtsi

• system-top.dts

• <bsp name>.dtsi

これらのファイルはツールによって再生成されるため、ユーザーによ

る編集は推奨しません。





プロジェクトをビルドすると、 2 つのディレクトリが自動で生成されます。

• <plnx-proj-root>/build には、ビルド用に生成されるファイルが格納されます。

• <plnx-proj-root>/images にはブータブルイメージが格納されます。

• <plnx-proj-root>/build/tmp には Yocto によって生成されるファイルが格納されます。このディレクトリ

は、 petalinux-config で設定を変更できます。


<plnx-proj-root>-build

-bitbake.lock -build.log-config.log-cache/ -conf/ -downloads/


meta-user/recipes-bsp/device-

tree/files/

system-user.dtsi は PetaLinux ツールによって変更されません。

したがって、リビジョン管理システムで使用しても安全です。また、

このディレクトリにユーザー独自の DTSI ファイルを追加することも

できます。その場合、

<plnx-proj-root>/project-spec/meta-user/recipes-bsp/

device-tree/device-tree-generation_%.bbappend にその

dtsi ファイルを追加する必要があります。


meta-plnx-generated/recipes-bsp

/u-boot/configs

U-Boot PetaLinux コンフィギュレーションファイル。次のファイルが

petalinux-config によって自動生成されます。

• config.mk (MicroBlaze のみ)

• platform-auto.h

• config.cfg

platform-top.h は PetaLinux ツールによって変更されません。

U-Boot をビルドすると、これらのファイルは次のように U-Boot ビル

ドディレクトリ build/linux/u-boot/src/<U_BOOT_SRC>/ にコ

ピーされます。

• config は U-Boot kconfig ファイルです。

• MicroBlaze の場合、 config.mk は board/xilinx/microblaze-generic/ にコ

ピーされます。


meta-user/recipes-bsp/u-boot/

files/platform-top.h

• platform-auto.h and platform-top.h は include/configs/ ディ

レクトリにコピーされます。

<plnx-proj-root>/components/ エンベデッドソフトウェアのワークスペース用、および BSP をパッ

ケージする際に外部ソースを格納するためのディレクトリ。このディ

レクトリに手動でコンポーネントをコピーすることもできます。外部

コンポーネントは次のディレクトリに置く必要があります。

<plnx-proj-root>/components/ext_source/<COMPONENT>

表 A‐1: PetaLinux プロジェクトの説明 (続き)

PetaLinux プロジェクトのファイル/ディレクトリ

説明





-misc/-config/-plnx-generated/ -rootfs_config/

-sstate-cache/-tmp/

-components -plnx_workspace/

-config.project -hardware -images

-linux/-pre-built

-linux/-project-spec

-attributes -configs/

-config-rootfs_config

-hw-description/-meta-plnx-generated/-meta-user/

注意: <plnx-proj-root>/build/ は自動で生成されます。このディレクトリのファイルは手動で編集しないでく

ださい。このディレクトリの内容は、 petalinux-config または petalinuxbuild を実行すると更新されます。

<plnx-proj-root>/images/ も自動で生成されます。このディレクトリのファイルは、 petalinux-build を実

行すると更新されます。

次の表に、 Zynq UltraScale+ MPSoC の場合の例を示します。

注記:デフォルトでは、空き容量を確保するためにビルド中間生成物は petalinux-build 実行後に削除されます。

build/conf/local.conf から「INHERIT += "rm_work"」を削除するとビルド中間生成物を残すことができますが、プロ

ジェクトの容量が大きくなります。

表 A‐2: PetaLinux プロジェクトのビルドディレクトリ

PetaLinux プロジェクトのビルドディレクトリ説明

<plnx-proj-root>/build/build.log ビルドのログファイル

<plnx-proj-root>/build/misc/config/ Linux サブシステムのビルド関連ファイルを格納するディレクトリ

<plnx-proj-root>/build/misc/rootfs

_config/rootfs のビルド関連ファイルを格納するディレクトリ

<plnx-projroot>/build/tmp/work/plnx

_aarch64-xilinx-linux/petalinux-ser

-image/1.0-r0/rootfs

ターゲット rootfs ホストコピー。これはステージングディレクト

リです。

<plnx-projroot>/tmp/plnx_aarch64 ユーザーアプリケーション/ライブラリのビルドに必要なライブ

ラリとヘッダーファイルを格納するステージディレクトリ

<plnx-proj-root>/build/tmp/work/pln

x_aarch64-xilinx-linux/linux-xlnxカーネルのビルド関連ファイルを格納するディレクトリ

<plnx-proj-root>/build/tmp/work/pln

x_aarch64-xilinx-linux/u-boot-xlnxU-Boot のビルド関連ファイルを格納するディレクトリ





プロジェクトのレイヤー

PetaLinux プロジェクトは、 <proj-plnx-root>/project-spec に次の 2 つのレイヤーがあります。

1. meta‐plnx‐generated:

このレイヤーには、すべてのコンポーネントのすべての bbappend とコンフィギュレーションフラグメント (cfg) が格

納されます。このレイヤーのファイルはすべて、 HDF およびユーザー設定に基づいてツールによって生成されます。

このレイヤーのファイルは petalinux-config および petalinux-build コマンドを実行すると再生成されるた

め、手動では更新しないでください。

2. meta‐user:

このレイヤーは、すべてのユーザー固有の変更のプレースホルダーです。独自の bbappend およびコンフィギュレー

ションファイルをこのレイヤーに追加できます。

レイヤーの優先度

デフォルトでは、 meta-plnx-generated レイヤーの優先度がも高く設定されています。これは、ユーザー設定による

システムの変更をツールが禁止しているためです。ユーザー設定に基づいてシステムを変更する場合は、 meta-user

の優先度を meta-plnx-generated の優先度よりも高い値に変更する必要があります。

デフォルトでは、 meta-plnx-generated と meta-user の優先度はどちらも 6 です。

ユーザーによる変更を優先する場合は、 meta-user の優先度を 7 に変更します。

注記: meta-user の優先度を変更すると、システムの変更が可能になります。ユーザーの責任でシステムの安定性を確

保する必要があります。

meta‐user レイヤーの優先度を 7 に変更する手順

1. <plnx-proj-plnx-root>/project-spec/meta-user/conf/layer.conf を開きます。

2. BBFILE_PRIORITY_meta-user の値を 6 から 7 に変更します。

3. これで、 meta-user の優先度が 7 に変更されます。

BBFILE_PRIORITY_meta-user = "7"

<plnx-proj-root>/components/plnx_

workspace/device-tree-generationデバイスツリーのビルド関連ファイルを格納するディレクトリ

<plnx-projroot>/components/plnx_

workspace/fsblブートローダーのビルド関連ファイルを格納するディレクトリ

表 A‐3: PetaLinux プロジェクトのイメージディレクトリ

PetaLinux プロジェクトのイメージディレクトリ説明

<plnx-proj-root>/images/linux/ Linux サブシステムのブータブルイメージを格納するディレクトリ

表 A‐2: PetaLinux プロジェクトのビルドディレクトリ (続き)

PetaLinux プロジェクトのビルドディレクトリ説明




付録 B

プロジェクト内での FSBL、 PMUFW および ATF の生成

この手順はオプションです。デフォルトでは、上位システム設定で第 1 段階ブートローダー (FSBL) が生成される

ようになっています。

注意: PetaLinux で FSBL/FS-BOOT をビルドしないように設定した場合、これらを手動でビルドする必要があります。

そうしないと、システムは正しくブートしません。

menuconfig で FSBL を無効にしている場合、プロジェクトで FSBL をビルドするように設定するには次の手順を実行

します。

1. 上位のシステム設定メニューを起動して設定を変更します。

$ petalinux-config

a. [linux Components Selection --->] サブメニューを選択します。

b. [First Stage Bootloader] オプションを選択します。

[*] First Stage Bootloader

c. メニューを終了し、変更を保存します。

これにより、 PetaLinux プロジェクトのルートディレクトリの components/bootloader/ に FSBL ソースが存在して

いなければ生成されます。 Zynq® UltraScale+™ MPSoC の場合:

components/plnx_workspace/fsbl/zynqmp_fsbl

Zynq-7000 の場合:

components/plnx_workspace/fsbl/zynq_fsbl

MicroBlaze の場合:

components/plnx_workspace/fs-boot

FSBL はローカルプロジェクトディレクトリに置く必要があります。

2. petalinux-build を実行し、 FSBL をビルドします。

プロジェクトのビルド時に FSBL をビルドする場合:

$ petalinux-build

FSBL のみをビルドする場合:

$ petalinux-build -c bootloader





ブートローダーの ELF ファイルは、プロジェクトルートディレクトリの images/linux に

zynqmp_fsbl.elf (Zynq UltraScale+ MPSoC の場合)、 zynq_fsbl.elf (Zynq-7000 の場合)、または

fs-boot.elf (MicroBlaze の場合) としてインストールされます。

ヒント : fsbl_bsp と fsbl_bsp は petalinux-build を実行すると自動で更新されます。

ARM トラステッドファームウェア (ATF)

この手順は Zynq UltraScale+ MPSoC 専用です。この手順は必須です。デフォルトでは、上位システム設定で ATF

が生成されるようになっています。

ATF の設定可能オプションを変更するには、次の手順を実行します。


$ petalinux-config

a. [ARM Trusted Firmware Compilation Configuration” --->] サブメニューを選択します。

b. 設定を入力します。


2. プロジェクトのビルド時に ATF をビルドする場合:

$ petalinux-build

ATF のみをビルドする場合:

$ petalinux-build -c arm-trusted-firmware

ATF の ELF ファイルは、プロジェクトルートディレクトリの images/linux に bl31.elf としてインストールさ

れます (Zynq UltraScale+ MPSoC のみ)。

PMU ファームウェア (PMUFW)

この手順は Zynq UltraScale+ MPSoC 専用です。この手順はオプションです。デフォルトでは、上位システム設定

で PMUFW が生成されるようになっています。

注意: PetaLinux で PMUFW をビルドしないように設定した場合、これらを手動でビルドする必要があります。

そうしないと、システムは正しくブートしません。

プロジェクトで PMUFW をビルドするように設定するには、次の手順を実行します。


$ petalinux-config

a. [linux Components Selection --->] サブメニューを選択します。

b. [PMU Firmware] オプションを選択します。

[*] PMU Firmware






2. プロジェクトのビルド時に PMUFW をビルドする場合:

$ petalinux-build

PMUFW のみをビルドする場合:

$ petalinux-build -c pmufw

PMUFW の ELF ファイルは、プロジェクトルートディレクトリの images/linux に pmufw.elf としてインストー

ルされます (Zynq UltraScale+ MPSoC のみ)。

FS‐Boot (MicroBlaze プラットフォームのみ)

PetaLinux の FS-Boot は、 MicroBlaze プラットフォーム専用の FSBL デモです。フラッシュからメモリへイメージを

ロードして、メモリにジャンプする方法をデモとして示しています。 FS-Boot を使用する場合、 8KB 以上の BRAM

が必要です。

FS-Boot がサポートするのは、パラレルフラッシュと標準 SPI モードの SPI フラッシュのみです。 axi_quad_spi を

使用する場合、 X1 モードでの動作に限られます。

FS-Boot がフラッシュのどこからイメージを取得するかを判断できるように、 CONFIG_FS_BOOT_START マクロを定

義する必要があります。これは、 PetaLinux ツールで行います。 PetaLinux ツールは、 menuconfig のプライマリフラッ

シュパーティションテーブルで設定した boot パーティションに基づいてこのマクロを自動で設定します。パラレ

ルフラッシュの場合、 boot パーティションの開始アドレスに基づいて設定します。 SPI フラッシュの場合、 boot

パーティションの開始オフセットに基づいて設定します。

フラッシュ内部のイメージには、 BIN ファイルの直前にラッパーヘッダーが必要です。 FS-Boot はターゲットメモリ

位置をラッパーから取得します。ラッパーには次の情報を含める必要があります。

FS-Boot はラッパーヘッダーのその他のフィールドは無視します。 U-Boot BIN ファイルをラップアラウンドするため

のラッパーヘッダーが PetaLinux ツールによって生成されます。

表 B‐1: ラッパーの情報

オフセット説明値

00 FS-Boot ブータブルイメージのマジックコード 0b8b40008

04 BIN イメージサイズユーザー定義

0100 FS-Boot ブータブルイメージのターゲット

メモリアドレス

ユーザー定義。 menuconfig の [Memory Settings] で設

定した U-Boot テキストベースアドレスオフセット

から PetaLinux ツールが自動的に計算します。

010c BIN ファイルの開始位置なし





付録 C

[Auto Config Settings] サブメニューpetalinux-config を実行すると、 [Auto Config Settings] サブメニューが表示されます。このサブメニュー

には、上位のシステム設定に基づいて PetaLinux が自動設定 (autoconfig) を適用可能なコンポーネントの一覧が表

示されます。コンポーネントを選択して autoconfig を有効にすると、 petalinux-config 実行時にそのコンポーネ

ントの config ファイルが自動で更新されます。

表 C‐1: [Auto Config Settings] サブメニュー

メニュー項目 autoconfig を有効にした場合に影響を受けるファイル

[Device tree] • <plnx-proj-root>/components/plnx_workspace/device-tree-generation/

skeleton.dtsi (Zynq-7000 のみ)

• <plnx-proj-root>/components/plnx_workspace/device-tree-generation/

zynq-7000.dtsi (Zynq-7000 のみ)


zynqmp.dtsi (Zynq UltraScale+ MPSoC のみ)


zynqmp-clk.dtsi (Zynq UltraScale+ MPSoC のみ)


pcw.dtsi (Zynq-7000 および Zynq UltraScale+ MPSoC)


pl.dtsi (MicroBlaze のみ)

• <plnx-proj-root>/components/plnx_workspace/device-tree-generation/sys

tem-conf.dtsi


system-top.dts

[kernel] <plnx-proj-root>/project-spec/meta-plnx-generated/recipes-kernel/

linux/configs/plnx_kernel.cfg

[u-boot] • <plnx-proj-root>/project-spec/meta-plnx-generated/recipes-bsp/

u-boot/configs/config.cfg

• <plnx-proj-root>/project-spec/meta-plnx-generated/recipes-bsp/

u-boot/configs/platform-auto.h

[fsbl] <plnx-proj-root>/components/plnx_workspace/fsbl

[pmufw] <plnx-proj-root>/components/plnx_workspace/pmu-firmware

[fsboot] <plnx-proj-root>/components/plnx_workspace/fs-boot



付録 D

QEMU 仮想ネットワーキングモードQEMU には非ルート (デフォルト ) とルート (sudo または root のパーミッションが必要) の 2 つの実行モードがありま

す。これら 2 つのモードの違いは、仮想ネットワーク設定にあります。

非ルートモードでは、 QEMU はホストからゲストへのネットワークトラフィックを制限する内部仮想ネットワーク

をセットアップします。これは NAT ルーターと同じように動作します。 tcp ポートをリダイレクトしないとこのネッ

トワークにはアクセスできません。

ルートモードでは、 QEMU は仮想イーサネットアダプターにサブネットを作成し、ホストシステムの DHCP サー

バーを利用して動作します。

以降のセクションでは、非ルートモードでローカルホストからのアクセスを可能にするリダイレクトの方法を含

め、これらモードの使用方法について説明します。

非ルートモードでのポートリダイレクト

デフォルトの非ルートモードで QEMU を実行し、ホストマシンから内部 (仮想) ネットワークにアクセスしたい場

合 (たとえば GDB または TCF エージェントでデバッグするなど)、エミュレートしたシステムポートを QEMU 仮想

マシン内部からローカルマシンへとリダイレクトする必要があります。このリダイレクトは、 petalinux-boot

--qemu コマンドの --qemu-args オプションを使用して実行します。次の表に、リダイレクトに関する引数の例

をいくつか示します。これは QEMU の標準機能です。詳細は、 QEMU の資料を参照してください。

表 D‐1: リダイレクトに関する引数

QEMU オプションスイッチ

目的ホストからゲストへのアクセス

-tftp <path-to-directory> 指定したディレクトリに TFTP サーバーをセット

アップします。サーバーには QEMU の内部 IP ア

ドレス 10.0.2.2 でアクセスできます。

-redir tcp:10021:

10.0.2.15:21

ホストのポート 10021 をゲストのポート 21 (ftp)

にリダイレクトします。

host> ftp localhost 10021

-redir tcp:10023:

10.0.2.15:23

ホストのポート 10023 をゲストのポート 23 (telnet)


host> telnet localhost 10023

-redir tcp:10080:

10.0.2.15:80

ホストのポート 10080 をゲストのポート 80 (http)


ウェブブラウザーで

http://localhost:10080 と

入力

-redir tcp:10022:

10.0.2.15:22

ホストのポート 10022 をゲストのポート 22 (ssh)


ホストで ssh -P 10022

localhost を実行し、ターゲット

への SSH セッションを開始




付録 D: QEMU 仮想ネットワーキングモード

次に、ポートをリダイレクトするコマンドラインの例を示します。

$ petalinux-boot --qemu --kernel --qemu-args "-redir tcp:1534::1534"

この文書では gdbserver と tcf エージェントでポート 1534 を使用していますが、任意の空きポートへのリダイレクト

が可能です。また、内部でエミュレートしたポートがローカルマシンのポートと異なっていてもかまいません。

$ petalinux-boot --qemu --kernel --qemu-args "-redir tcp:1444::1534"

QEMU 仮想サブネットの指定

デフォルトでは、 PetaLinux は --root モードの QEMU 仮想サブネットとして 192.168.10.* を使用します。この

サブネットがローカルネットワークまたはその他の仮想サブネットで使用されている場合、別のサブネットを使用

したいことがあります。コマンドコンソールで次のように petalinux-boot を実行すると、 QEMU でその他のサ

ブネットを使用するように PetaLinux を設定できます。

注意: この機能を利用するには、ローカルマシンでの sudo アクセスが必要です。また、この機能は --root オプション

と組み合わせて使用する必要があります。

$ petalinux-boot --qemu --root --u-boot --subnet <subnet gateway IP>/<number of the bits of the subnet mask>

例) サブネット 192.168.20.* を使用する場合:

$ petalinux-boot --qemu --root --u-boot --subnet 192.168.20.0/24




付録 E

QEMU でサポートされるザイリンクス IP モデル

PetaLinux ツールに付属する QEMU エミュレーターは、次に示すザイリンクス IP モデルをサポートしています。

• Zynq-7000 ARM Cortex-A9 CPU

• Zynq UltraScale+ MPSoC ARM Cortex-A53 MPCore

• Zynq UltraScale+ MPSoC Cortex-R5

• MicroBlaze CPU ( リトルエンディアン AXI)

• ザイリンクス Zynq-7000/Zynq UltraScale+ MPSoC DDR メモリコントローラー

• ザイリンクス Zynq UltraScale+ MPSoC DMA コントローラー

• ザイリンクス Zynq UltraScale+ MPSoC SD/SDIO ペリフェラルコントローラー

• ザイリンクス Zynq UltraScale+ MPSoC ギガビットイーサネットコントローラー

• ザイリンクス Zynq UltraScale+ MPSoC NAND コントローラー

• ザイリンクス Zynq UltraScale+ MPSoC UART コントローラー

• ザイリンクス Zynq UltraScale+ MPSoC QSPI コントローラー

• ザイリンクス Zynq UltraScale+ MPSoC I2C コントローラー

• ザイリンクス Zynq UltraScale+ MPSoC USB コントローラー (ホストサポートのみ)

• ザイリンクス Zynq-7000 トリプルタイマーカウンター

• ザイリンクス Zynq-7000 DMA コントローラー

• ザイリンクス Zynq-7000 SD/SDIO ペリフェラルコントローラー

• ザイリンクス Zynq-7000 ギガビットイーサネットコントローラー

• ザイリンクス Zynq-7000 USB コントローラー (ホストサポートのみ)

• ザイリンクス Zynq-7000 UART コントローラー

• ザイリンクス Zynq-7000 SPI コントローラー

• ザイリンクス Zynq-7000 QSPI コントローラー

• ザイリンクス Zynq-7000 I2C コントローラー

• ザイリンクス AXI Timer および AXI Interrupt Controller ペリフェラル

• ザイリンクス AXI External Memory Controller (パラレルフラッシュに接続)

• ザイリンクス AXI DMA Controller

• ザイリンクス AXI Ethernet




付録 E: QEMU でサポートされるザイリンクス IP モデル

• ザイリンクス AXI Ethernet Lite

• ザイリンクス AXI UART 16650 および Lite

重要: デフォルトでは、 IP モデルが提供されていないデバイスは QEMU で無効にされます。このため、カスタマイ

ズした独自の IP コアは、 QEMU 規格に従ってユーザーが C/C++ モデルを作成しない限り QEMU を使用してテスト

することはできません。

詳細は、『Zynq UltraScale+ MPSoC QEMU ユーザーガイド』 (UG1169) [参照 5] を参照してください。




付録 F

Xen Zynq Ultrascale+ MPSoC の例このセクションでは、 Xen Zynq® Ultrascale+™ MPSoC の例について説明します。 Zynq Ultrascale+ MPSoC で Xen の上

に Linux を dom0 としてブートする方法について説明します。

前提条件


• PetaLinux ツールのソフトウェアプラットフォームを使用して実際のハードウェアプラットフォームにカスタ

マイズした Linux システムをビルドできる準備が完了していること。詳細は、「ハードウェアコンフィギュレー

ションのインポート」を参照してください。

• ZCU102 リファレンス BSP を使用して PetaLinux プロジェクトが作成済みであること。

° pre-built/linux/images ディレクトリには、 Xen に関するビルド済みの xen.dtb、 xen.ub、

xen-image および xen-rootfs.cpio.gz.u-boot があります。

ビルド済み Linux を dom0 としてブートする

1. tftp を使用して U-Boot からロードできるように、ビルド済み Xen イメージおよび Linux カーネルイメージを tftp

ディレクトリにコピーします。

$ cd <plnx-proj-root>$ cp pre-built/linux/images/xen.dtb <tftpboot>/$ cp pre-built/linux/images/xen.ub <tftpboot>/$ cp pre-built/linux/images/xen-Image <tftpboot>/$ cp pre-built/linux/images/xen-rootfs.cpio.gz.u-boot <tftpboot>/

2. JTAG ブートまたは SD カードからのブートにより、ボード上のビルド済み U-Boot イメージをブートします。

3. U-Boot から tftp サーバーの IP をセットアップします。

U-Boot-PetaLinux> setenv serverip <TFTP SERVERIP>

4. U-Boot から Xen イメージおよびカーネルイメージをロードします。

U-Boot-PetaLinux> tftpboot D80000 xen.dtbU-Boot-PetaLinux> tftpboot 80000 xen-ImageU-Boot-PetaLinux> tftpboot 1000000 xen.ubU-Boot-PetaLinux> tftpboot 2000000 xen-rootfs.cpio.gz.u-bootU-Boot-PetaLinux> bootm 1000000 2000000 D80000





Xen を再ビルドする

Zynq UltraScale + MPSoC 用に PetaLinux プロジェクトを作成した後、次の手順を実行して xen イメージをビルドします。

1. cd <proj root directory> を実行し、プロジェクトのルートディレクトリに移動します。

2. Petalinux-config コマンドを実行し、 [Image Packaging Configuration]、 [Root filesystem type (INITRD)] の順に

選択します。

3. Petalinux-config -c rootfs コマンドを実行し、 [Filesystem Packages --->]、 [misc --->]、

[packagegroup-petalinux-xen --->] の順に選択し、 [[*] packagegroup-petalinux-xen] を選択します。

4. Xen 関連の config でビルド対象のデバイスツリーを編集します。

project-spec/meta-user/recipes-bsp/device-tree/files/system-user.dtsi をエディターで開

き、次の行を追加します。

/include/ "xen-overlay.dtsi".

次に、編集結果を示します。

/include/ "system-conf.dtsi"/include/ "xen-overlay.dtsi"/ {};

5. project-spec/meta-user/recipes-bsp/device-tree/device-tree-generation_%.bbappend を

エディターで開き、次の行を追加します。 file://xen-overlay.dtsi

次に、編集結果を示します。

SRC_URI_append ="\ file://system-user.dtsi \

file://xen-overlay.dtsi \"FILESEXTRAPATHS_prepend := "${THISDIR}/files:"

6. 次のように petalinux-build を実行します。 $ petalinux-build

7. ビルド中間生成物は、プロジェクトディレクトリの images/linux にあります。

注記:デフォルトでは、 petalinux-build コマンドでは Xen はビルドされません。デフォルトのルートファイルシステ

ムには Xen ツールは含まれません。 Xen rootfs を使用する必要があります。

ヒント : XEN の詳細は、「PetaLinux 2016.4 以降での Xen ハイパーバイザーのビルド方法」を参照してください。



http://www.wiki.xilinx.com/Building+the+Xen+Hypervisor+with+PetaLinux+2016.4+and+newer



OpenAMP を実行する

OpenAMP を実行する手順は次のとおりです。

1. $ cd <plnx-proj-root> を実行し、プロジェクトのルートディレクトリに移動します。

$ cp pre-built/linux/images/openamp.dtb pre-built/linux/images/system.dtb$petalinux-boot --jtag --prebuilt 3 --hw_server-url <hostname:3121>

2. Linux にログインします。

a. echo <echo_test_firmware> > /sys/class/remoteproc/remoteproc0/firmware を実行します。

例) # echo image_echo_test > /sys/class/remoteproc/remoteproc0/firmware

b. echo start > /sys/class/remoteproc/remoteproc0/state

c. modprobe rpmsg_user_dev_driver

d. echo_test

OpenAMP の詳細は、『Zynq デバイス向け OpenAMP フレームワーク』 (UG1186) [参照 7] を参照してください。





付録 G

廃止された機能このセクションでは、 PetaLinux コマンドで廃止された機能およびオプションについて説明します。

1. petalinux-create

a. -t libs: ライブラリを開発またはインストールするには、 -t apps を使用する必要があります。

b. -t libs --priority: このオプションのサポートは終了しました。

c. -t generic: ジェネリックコンポーネントのサポートは終了しました。

d. --out: このオプションを使用して、プロジェクトの場所がサポートされていないかどうかを指定できます。

-n も使用できます。

2. petalinux-config

a. --search: 全体のサーチパスインプリメンテーションおよびそのすべてのサブオプションのサポートは終了

しました。

3. petalinux-build

a. --makeenv: 対応する bbappend または Makefile でフラグを指定する必要があります。

4. petalinux-package

a. --bsp --no-extern: ローカルの外部コンポーネントは明示的にコピーする必要があります。

b. --bsp --no-local: このオプションのサポートは終了しました。

c. --firmware: このオプションのサポートは終了しました。

d. --image -c rootfs: petalinux-config でファイルシステムタイプを選択する必要があります。

5. petalinux-boot

a. --qemu --qemu-gdb: --qemu-args オプションを直接使用して gdb を起動するように QEMU に指示できます。

6. petalinux-util

a. --update-sdcard: SD カードは手動で更新する必要があります。詳細は、「SD カード外部ファイルシステム

ブートの設定」を参照してください。



付録 H

一般的なエラーと解決方法このセクションでは、 PetaLinux コマンドの実行時に発生する一般的なエラーとその解決手順について説明します。

一般的なエラーとその解決方法には、次のものがあります。

1. TMPDIR が NFS にある。

「ERROR: OE-core's config sanity checker detected a potential misconfiguration」

このエラーが発生した場合は、原因を修正するか、ユーザーの責任でチェッカーを停止します (sanity.conf 参照)。

次に、考えられる問題と推奨事項の一覧を示します。

The TMPDIR: /home/user/xilinx-kc705-axi-full-2017.1/build/tmp cannot be located on NFS.

TMPDIR が NFS にあると解析エラーになります。 petalinux-config を実行して、任意のローカルストレージに変

更する必要があります。

Yocto-settings --> TMPDIR

複数の異なる PetaLinux プロジェクトで同じ TMPDIR を設定しないでください。ビルドエラーが発生します。

2. Bitbake を実行できない。

bitbake は 1 つのプロジェクトで 1 インスタンスしか実行できません。直前にビルドが異常終了している場合、

bitbake が正常に終了しておらず、現在のビルドで bitbake を起動できない可能性があります。

to reciver: rm -rf <plnx-proj-root>/build/bitbake.lock

3. アプリケーション/モジュール名に「_」が含まれる。

「plnx_myapp」のようなアプリケーション名の場合、 bitbake でエラーが発生します。「_」の後はバージョン番

号とする必要があります。

たとえば「myapp_1」は有効なアプリケーション/モジュール名です。

この問題を解決するには、作成されたアプリケーションを削除すると共に、

<plnx-proj-root>/project-spec/meta-user/recipes-core/images/petalinux-image.bbappen

d で次の行を削除します。

IMAGE_INSTALL_append = " plnx_myapp"




付録 H:一般的なエラーと解決方法

4. Ctrl + C キーを 2 回押して PetaLinux を強制終了すると、次のエラーメッセージが表示される。

NOTE: Sending SIGTERM to remaining 1 tasksError in atexit._run_exitfuncs:Traceback (most recent call last): File "/opt/pkg/petalinux/components/yocto/source/aarch64/layers/core/bitbake/lib/bb/ui/knotty.py", line 313, in finish self.termios.tcsetattr(fd, self.termios.TCSADRAIN, self.stdinbackup)termios.error: (5, 'Input/output error')

このエラーが表示されると、コンソールが文字化けして入力したテキストが表示されなくなります。コンソー

ルを回復するには、 stty sane を入力し、 Enter キーを 2 回押します。

5. 言語設定が不足しており、 petalinux-config を実行するとエラーメッセージ「Could not find the

/log/cooker/plnx_microblaze in the /tmp directory」が表示される。

この問題を解決するには、次のように設定します。

export LC_ALL=en_US.UTF-8export LANG=en_US.UTF-8export LANGUAGE=en_US.UTF-8

6. petalinux-config -c kernel および petalinux-config -c u-boot を実行した場合、 bitbake が内部で新規ターミナルを開こ

うとして失敗し、次のエラーメッセージが表示される。

ERROR: linux-xlnx-4.9-xilinx+gitAUTOINC+a96b8d2e1c-r0 do_menuconfig: Unable to spawn terminal auto: Execution of '/home/user/xilinx-zcu102-2017.1/build/tmp/work/plnx_aarch64-xilinx-linux/linux-xlnx/4.9-xilinx+gitAUTOINC+a96b8d2e1c-r0/temp/run.do_terminal.8249' failed with exit code -6:Fatal Python error: Py_Initialize: Unable to get the locale encodingImportError: No module named 'encodings'Current thread 0x00007fd12b4f8700 (most recent call first):ERROR: linux-xlnx-4.9-xilinx+gitAUTOINC+a96b8d2e1c-r0 do_menuconfig: Function failed: do_menuconfigERROR: Logfile of failure stored in: /home/user/xilinx-zcu102-2017.1/build/tmp/work/plnx_aarch64-xilinx-linux/linux-xlnx/4.9-xilinx+gitAUTOINC+a96b8d2e1c-r0/temp/log.do_menuconfig.8249

デフォルトの OE_TERMINAL ではエラーになるため、変更する必要があります。

<plnx-proj-root>/project-spec/meta-user/conf/petalinuxbsp.conf で OE_TERMINAL のコメントをはずし、xterm または

screen に設定します。そのためには、対応するユーティリティを PC にインストールしておく必要があります。




付録 I

その他のリソースおよび法的通知

ザイリンクスリソース

アンサー、資料、ダウンロード、フォーラムなどのサポートリソースは、ザイリンクスサポートサイトを参照して

ください。

ソリューションセンター

デバイス、ツール、 IP のサポートについては、ザイリンクスソリューションセンターを参照してください。デザイ

ンアシスタント、デザインアドバイザリ、トラブルシュートのヒントなどが含まれます。

参考資料

注記:日本語版のバージョンは、英語版より古い場合があります。

1. PetaLinux 資料 (japan.xilinx.com/petalinux)

2. ザイリンクスアンサー 55776

3. 『Zynq UltraScale+ MPSoC ソフトウェア開発者向けガイド』 (UG1137: 英語版、日本語版)

4. 『PetaLinux ツール資料: PetaLinux コマンドラインリファレンスガイド』 (UG1157)

5. 『Zynq Ultrascale+ MPSoC QEMU ユーザーガイド』 (UG1169)

6. 『PetaLinux ツール資料: ワークフローチュートリアル』 (UG1156)

7. 『Zynq デバイス向け OpenAMP フレームワーク』 (UG1186)



http://japan.xilinx.com/support

http://japan.xilinx.com/support/solcenters.htm

http://japan.xilinx.com/products/design-tools/embedded-software/petalinux-sdk.html

http://japan.xilinx.com/cgi-bin/docs/ndoc?t=answers;d=55776.html

https://japan.xilinx.com/cgi-bin/docs/ndoc?t=user_guides;d=ug1137-zynq-ultrascale-mpsoc-swdev.pdf

https://japan.xilinx.com/cgi-bin/docs/ndoc?t=user_guides;d=j_ug1137-zynq-ultrascale-mpsoc-swdev.pdf

https://japan.xilinx.com/cgi-bin/docs/rdoc?v=2017.2;d=ug1157-petalinux-tools-command-line-guide.pdf

http://japan.xilinx.com/cgi-bin/docs/rdoc?v=2017.2;d=ug1169-zynqmp-qemu.pdf

https://japan.xilinx.com/cgi-bin/docs/rdoc?v=2017.2;d=ug1156-petalinux-tools-workflow-tutorial.pdf

https://japan.xilinx.com/cgi-bin/docs/rdoc?v=2017.2;d=ug1186-zynq-openamp-gsg.pdf


付録 I: その他のリソースおよび法的通知

お読みください: 重要な法的通知本通知に基づいて貴殿または貴社 (本通知の被通知者が個人の場合には「貴殿」、法人その他の団体の場合には「貴社」。以下同じ ) に開示される情報 (以下「本情報」といいます) は、ザイリンクスの製品を選択および使用することのためにのみ提供されます。適

用される法律が許容する大限の範囲で、 (1) 本情報は「現状有姿」、およびすべて受領者の責任で (with all faults) という状態で提供

され、ザイリンクスは、本通知をもって、明示、黙示、法定を問わず (商品性、非侵害、特定目的適合性の保証を含みますがこれ

らに限られません)、すべての保証および条件を負わない (否認する ) ものとします。また、 (2) ザイリンクスは、本情報 (貴殿または

貴社による本情報の使用を含む) に関係し、起因し、関連する、いかなる種類・性質の損失または損害についても、責任を負わな

い (契約上、不法行為上 (過失の場合を含む)、その他のいかなる責任の法理によるかを問わない) ものとし、当該損失または損害に

は、直接、間接、特別、付随的、結果的な損失または損害 (第三者が起こした行為の結果被った、データ、利益、業務上の信用の

損失、その他あらゆる種類の損失や損害を含みます) が含まれるものとし、それは、たとえ当該損害や損失が合理的に予見可能で

あったり、ザイリンクスがそれらの可能性について助言を受けていた場合であったとしても同様です。ザイリンクスは、本情報に

含まれるいかなる誤りも訂正する義務を負わず、本情報または製品仕様のアップデートを貴殿または貴社に知らせる義務も負いま

せん。事前の書面による同意のない限り、貴殿または貴社は本情報を再生産、変更、頒布、または公に展示してはなりません。一

定の製品は、ザイリンクスの限定的保証の諸条件に従うこととなるので、 https://japan.xilinx.com/legal.htm#tos で見られるザイリンク

スの販売条件を参照してください。 IP コアは、ザイリンクスが貴殿または貴社に付与したライセンスに含まれる保証と補助的条件

に従うことになります。ザイリンクスの製品は、フェイルセーフとして、または、フェイルセーフの動作を要求するアプリケー

ションに使用するために、設計されたり意図されたりしていません。そのような重大なアプリケーションにザイリンクスの製品を

使用する場合のリスクと責任は、貴殿または貴社が単独で負うものです。 https://japan.xilinx.com/legal.htm#tos で見られるザイリンク

スの販売条件を参照してください。

自動車用のアプリケーションの免責条項

オートモーティブ製品 (製品番号に「XA」が含まれる ) は、 ISO 26262 自動車用機能安全規格に従った安全コンセプトまたは余剰性

の機能 ( 「セーフティ設計」 ) がない限り、エアバッグの展開における使用または車両の制御に影響するアプリケーション ( 「セー

フティアプリケーション」 ) における使用は保証されていません。顧客は、製品を組み込むすべてのシステムについて、その使用

前または提供前に安全を目的として十分なテストを行うものとします。セーフティ設計なしにセーフティアプリケーションで製品

を使用するリスクはすべて顧客が負い、製品の責任の制限を規定する適用法令および規則にのみ従うものとします。

© Copyright 2017 Xilinx, Inc. Xilinx、 Xilinx のロゴ、 Artix、 ISE、 Kintex、 Spartan、 Virtex、 Vivado、 Zynq、およびこの文書に含まれる

その他の指定されたブランドは、米国およびその他各国のザイリンクス社の商標です。すべてのその他の商標は、それぞれの保有

者に帰属します。

この資料に関するフィードバックおよびリンクなどの問題につきましては、 [email protected] まで、または各ページの

右下にある [フィードバック送信] ボタンをクリックすると表示されるフォームからお知らせください。フィードバックは日本語で

入力可能です。いただきましたご意見を参考に早急に対応させていただきます。なお、このメールアドレスへのお問い合わせは受

け付けておりません。あらかじめご了承ください。



https://japan.xilinx.com/legal.htm#tos

https://japan.xilinx.com/legal.htm#tos

mailto:[email protected]


PetaLinux ツール資料: リファレンスガイドഊ (UG1144) · PetaLinux ツール資料...

Documents

Transcript of PetaLinux ツール資料: リファレンスガイドഊ (UG1144) · PetaLinux ツール資料...

PetaLinux ツール資料: リファレンス ガイドഊ (UG1144) · PetaLinux ツール資料...

Documents

Transcript of PetaLinux ツール資料: リファレンス ガイドഊ (UG1144) · PetaLinux ツール資料...

PetaLinux ツール資料: リファレンスガイドഊ (UG1144) · PetaLinux ツール資料...

Transcript of PetaLinux ツール資料: リファレンスガイドഊ (UG1144) · PetaLinux ツール資料...