0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

Arty A7-100T + ZephyrでTFT LCD(ILI9341)を使ってみる

0
Last updated at Posted at 2026-07-20

はじめに

本記事はArty A7-100Tに接続したTFT LCDをZephyrで利用する手順を記述しています。LCDモジュールとArty A7は8080 Bus方式で接続しています。8080 Bus I/F部分には自前で実装したロジックを利用しています。

Display SubsystemとLVGL、Touch Screenを利用可能にするのが目標です。

記事の前半では実行手順を記述し、実装に関する情報は後半に記述しています。

システム概要

以下は実装するBlock Designです。以前の記事のデザインにLCD接続モジュールを追加した形になっています。

BD-1.png

開発環境

構成

Board
 Arty A7-100T
TFT LCD
 TFT LCDディスプレイ(8080 Bus接続)
Tools
 Vivado 2025.1
 Vitis 2025.1
Zephyr RTOS
 Base Version - 3.7.0(LTS)
 Xilinx Repository Tag - 2025.1
Host OS
 Ubuntu 24.04 Desktop
電子部品、その他
 ユニバーサルプレート(LCDの固定に利用)
 ジャンパーワイヤ
 ジャンパーワイヤ 4ピン(LCDとArty-A7の接続に利用。30cmは長かった。)

Vivado/Vitis

これらのツールは/tools/Xilinx/2025.1/配下にインストールされている事を前提とします。

Vivadoのプロジェクトはスクリプトにより$HOME/ws/vivado/arty-a7-mbv32-lcd-8080-16bit/配下に作成されます。

今回の作業でVitisは使いませんが、System Device Treeを生成する際にVitisに含まれるツールやデータを利用する為、Vitisのインストールが必要です。

Zephyr RTOS

Zephyr RTOSはZephyr ProjectがLTS版としてリリースしている3.7.0にAMDが提供するソースを組み込んだ環境でビルドします。

本記事では$HOME/zephyrproject/配下にインストールされている事を前提とします。

TFT LCDモジュール接続方法

I/F構成

下記がLCDモジュールに接続するI/F部分のブロック図と機能になります。

BD-2.png

Module Function
lcd_bus_ctrl Command/Data送信用8080 Bus Controller
axi_quad_spi_touch Touch Screen制御用SPI Controller
axi_gpio_touch Touch Screen割り込み信号入力用GPIO Controller

接続方法

本記事では以下の様に配線します。コネクタを上部から見た状態に合わせる為、表のLCD列が中央に2つ並ぶ形になっています。LCD列を中心に左右に各サイドの接続情報が記述されています。

LCD出力信号の接続

Signal PIN Arty LCD LCD Arty PIN Signal
LCD_BACKLIGHT U11 IO26 BL VDD
LCD_DATA[15] V16 IO27 DB15 SDCS IO0 V15 -
LCD_DATA[13] M13 IO28 DB13 DB14 IO1 U16 LCD_DATA[14]
LCD_DATA[11] R10 IO29 DB11 DB12 IO2 P14 LCD_DATA[12]
LCD_DATA[9] R11 IO30 DB9 DB10 IO3 T11 LCD_DATA[10]
LCD_DATA[7] R13 IO31 DB7 DB8 IO4 R12 LCD_DATA[8]
LCD_DATA[5] R15 IO32 DB5 DB6 IO5 T14 LCD_DATA[6]
LCD_DATA[3] P15 IO33 DB3 DB4 IO6 T15 LCD_DATA[4]
LCD_DATA[1] R16 IO34 DB1 DB2 IO7 T16 LCD_DATA[2]
LCD_RESX N16 IO35 RST DB0 IO8 N15 LCD_DATA[0]
LCD_WRX N14 IO36 WR RD IO9 M16 LCD_RDX
LCD_CSX U17 IO37 CS RS IO10 V17 LCD_DCX

TFT LCDはArty-A7のJ2, J3, J4に接続します。I/Fが8080 16-bit Bus方式なので接続するピン数が多いです。今回は1ピンと4ピンのジャンパーケーブルを駆使して何とか接続しました。

SDCSはボードに接続していますが、今回は未使用です。

Touch Screen信号の接続

PIN PmodD LCD LCD PmodD PIN
D4 1 MISO MOSI 7 E2
D3 2 PEN F_CS 8 D2
F4 3 T_CS CLK 9 H2

SPI接続となるTouch Screenの信号に関してはPMOD端子のJDに接続しています。

VDDとGNDはPMOD端子のJC, JDのVCC/GNDピンに接続しています。

LCDの電源をボードから取っていますので、Arty-A7はACアダプタを接続して利用しています。ACアダプタを接続しなくても、一応動作確認は取れています。

BOARD-1.jpeg

Zephyrビルド環境のインストール

Zephyr Getting Started Guideに記載されている通り、最初はZephyr 3.7.0 Getting Started Guideの手順を実行してビルド環境を用意して下さい。

Install the Zephyr SDKに記載されている手順まで実行します。最後に記述されているudev rulesのインストールは実行しなくても問題ありません。

mbv32固有環境のインストール

オリジナルのソースツリーにMicroBlaze V固有のソースツリーを追加します。

本記事ではSDK及びプロジェクトがホームディレクトリ配下にある事を前提に記述します。

最初にPythonのvenvを有効化します。

source $HOME/zephyrproject/.venv/bin/activate

次にMicroBlaze V固有のソースツリーを追加します。

cd $HOME/zephyrproject/
mv zephyr zephyr.upstream
git clone https://github.com/Xilinx/zephyr-amd.git -b xlnx_rel_v2025.1 zephyr
west update
west lopper-install

これでZephyrのビルド環境が用意できました。

Vivadoビルド手順

Block Design作成

ここではVivadoでBitstreamを生成します。先ずは下記コマンドでスクリプト一式を取得して下さい。

cd $HOME
git clone https://github.com/hkato-sssl/arty-a7-mbv32-lcd-8080-16bit.git

次にVivadoでBlock Designを作成します。

source /tools/Xilinx/2025.1/Vivado/settings64.sh
cd $HOME/arty-a7-mbv32-lcd-8080-16bit/vivado
vivado -source arty-a7-mbv32-lcd-8080-16bit.tcl &

VivadoにArty A7-100Tのボード情報が無い場合、ボード情報の取得を行うので多少時間が掛かります。

作成直後のBlock Designはビルド不可能な状態です。Projectを作成した後は、以降に記述するGUI操作を実行してMIGの設定を変更する必要があります。

MIG Configuration

スクリプト実行直後の状態では、まだBitstreamの生成は出来ません。MIGの設定を変更する必要があります。

Block Designの右下にあるmig_7series_0をダブルクリックしてMemory Interface Generatorウィンドウを表示します。

MIG-1.png

ウィドウが表示されたらNextボタンを7回クリックします。

MIG-1.png

FPGA Optionsが表示されたらSystem Clockを [Single-Ended] から [No Buffer] に変更します。変更したらNextボタンを3回クリックします。

MIG-2.png

Pin Selectionが表示されたらValidateボタンをクリックして、表示されたDRC ValidationウィンドウのOKボタンをクリックして下さい。その後、Nextボタンを3回クリックして下さい。

MIG-3.png

Simulation Optionsが表示されたらAcceptをチェックしてNextを2回クリックして下さい。

MIG-4.png

Design Notesが表示されたら、Generateボタンをクリックして終了です。

MIG-5.png

XSAファイル生成

VivadoのTCL Consoleから下記コマンドを実行してarty-a7-mbv32-lcd-8080-16bit.xsaを生成します。

source generate.tcl

スクリプトの実行が完了するとBitstream Generation Completedウィンドウが表示されるので、Cancelをクリックして閉じれば作業完了です。

Zephyrビルド手順

準備

最初に作業に利用するファイル名、ディレクトリ名を定義します。

PROJ_NAME=arty-a7-mbv32-lcd-8080-16bit
XSA_FILE=$HOME/ws/vivado/$PROJ_NAME/${PROJ_NAME}.xsa
SDT_DIR=$HOME/${PROJ_NAME}_sdt

次に下記手順でZephyrをビルド可能な状態にします。

cd $HOME
source zephyrproject/.venv/bin/activate
source zephyrproject/zephyr/zephyr-env.sh

ソースファイル取得

以下のコマンドでソースファイルを取得します。これには既存ドライバにパッチを当てた物も含まれます。

cd $HOME
git clone https://github.com/hkato-sssl/arty-a7-mbv32-lcd-8080-16bit-zephyr.git

Devicetreeの更新

先にビルドしたXSAファイルを使ってmbv32のDevicetree情報を更新します。最初のsetting64.shは既に実行済みであれば再実行の必要はありません。

# create the SDT files
. /tools/Xilinx/2025.1/Vivado/settings64.sh
xsct -eval "sdtgen set_dt_param -dir $SDT_DIR -xsa $XSA_FILE ; sdtgen generate_sdt"

# update the devicetree for Zephyr Project
cd $HOME/zephyrproject/
LOPPER_DTC_FLAGS="-b 0 -@" west lopper-command -p microblaze_riscv_0 -s $SDT_DIR/system-top.dts -w $HOME/zephyrproject/zephyr

Display Subsystem 動作確認

先ずはDisplay Subsystemの動作確認を行います。

ビルド手順は以下の通りです。

cd $HOME/zephyrproject/zephyr/samples/drivers/display
$HOME/arty-a7-mbv32-lcd-8080-16bit-zephyr/patch_and_install.sh
west build -p -b mbv32 -- -DZEPHYR_TOOLCHAIN_VARIANT=zephyr
west flash --runner xsdb --elf-file ./build/zephyr/zephyr.elf --bitstream $SDT_DIR/$PROJ_NAME.bit

正常に動作すれば下記の様に表示されます。

BOARD-2.jpeg

理由は不明ですが、本記事の公開時点では-DZEPHYR_TOOLCHAIN_VARIANT=zephyrを追加しないとビルド不可能になりました。追加オプションが面倒な人はシェルで下記コマンドを1度実行して下さい。

export ZEPHYR_TOOLCHAIN_VARIANT=zephyr

LVGL動作確認

次にLVGLのサンプル・コードを実行します。手順は以下の通りです。

cd $HOME/zephyrproject/zephyr/samples/modules/lvgl/demos
$HOME/arty-a7-mbv32-lcd-8080-16bit-zephyr/patch_and_install.sh
west build -p -b mbv32 -- -DCONFIG_LV_Z_DEMO_MUSIC=y -DZEPHYR_TOOLCHAIN_VARIANT=zephyr
west flash --runner xsdb --elf-file ./build/zephyr/zephyr.elf --bitstream $SDT_DIR/$PROJ_NAME.bit

このデモでは再生ボタンを押した後の一時停止ボタンが機能しませんが原因は不明です。今の所、これ以外のデモでは不具合らしき所は見当たりません。

このサンプル・コードではwest buildに渡す最後の引数を変更してデモ内容を選択可能です。具体的には-Dxxxxの部分を以下から1つ選択します。

-DCONFIG_LV_Z_DEMO_MUSIC=y
-DCONFIG_LV_Z_DEMO_BENCHMARK=y
-DCONFIG_LV_Z_DEMO_STRESS=y
-DCONFIG_LV_Z_DEMO_WIDGETS=y

インストールファイル概要

ここではpatch_and_install.shでインストールされるファイルについて記述します。このスクリプトによりインストールされるファイルには、既存ドライバを修正するファイルとプロジェクトに追加される2種類のファイルがあります。

修正対象ファイル

既存ドライバの修正はarty-a7-mbv32-lcd-16bit-zephyr/patched配下にあるファイルを上書きする形で行われます。この他、スクリプトが直接修正する分も含めて4つのファイルが修正されます。

drivers/interrupt_controller/intc_xlnx.c

以前の記述した問題に対応した修正を行なっています。

drivers/display/display_ili9xxx.c

既存ドライバだとLCD表示とTouch Screenの上下が合わない為、ドライバの設定処理を修正しています。RasPi Pico2でILI9341を動作させた時も同様の問題がありましたが、こちらではILI9341のDevicetreeにv-mirrorを追加する事で対応しています。古いLTS版ではこの対応が実装されていない為、直接ドライバを修正する形にしました。

ili9xxx_set_orientation()に下記処理を追加して、ILI9341のMADCTL Registerの設定値を修正しています。

tx_data ^= ILI9XXX_MADCTL_MY;
tx_data ^= ILI9XXX_MADCTL_MX;

prj.conf

LVG用にprj.confに下記オプションを追加します。

CONFIG_LV_COLOR_16_SWAP=y

CMakeFiles.txt

スクリプトにより追加されるソースファイルをビルド対象に指定します。

プロジェクト追加ファイル

プロジェクトにはmbv32用のDevicetreeや今回実装したドライバが追加されます。追加されたソースファイルはCMakeLists.txtを修正してビルド対象に指定されます。

src/cache.S

キャッシュ保守用APIを実装しています。このAPIはMIPI DBI DriverがDMA転送前に実行します。

src/mipi_dbi_16bit.c

今回実装したLCD Bus Controller用のMIPI DBI Driverです。

dts/bindings/mipi-dbi/vnd,mipi-dbi-16bit.yaml

MIPI DBI Driver用のDevicetreeを定義しています。

boards/mbv32.overlay

mvb32用に追加するDevicetree定義です。この中にMIPI DBI DriverとILI9341、Touch Screenの定義が含まれています。

LCD Bus Controller

ここでは今回実装したLCD Bus Controllerについて記述します。本機能はBlock Designではlcd_bus_ctrlと表示されます。

機能概要

本デバイスは下記機能を提供します。

  • 8080 16-bit Bus方式によるLCDモジュールへのCommand/Data送信
  • RESET/CS信号制御
  • LCD Backlight制御

LCDモジュールからのデータ読み出しには対応していません。本デバイスはLCDモジュールへのCommand/Data送信機能に特化しています。

ブロック図

lcd_bus_ctrl

lcd_bus_ctrlは3つの機能ブロックにより構成されています。

LCD-1.png

Block Function
pio_fifo CPUから書き込まれたCommand/Dataを保持
RESET/CS信号とLCD Backlight制御
dma_fifo DMAから書き込まれたDataを保持
lcd_out pio_fifo/dma_fifoに書き込まれたデータをLCDモジュールへ送信

pio_fifo/dma_fifoのどちらかにデータが保存され次第、lcd_outがFIFOデータをLCDモジュールへ送信するのが本デバイスの基本機能です。pio_fifoとdma_fifoの双方にデータが存在する場合は、dma_fifoのデータを優先的に送信します。

DMAとFIFOはVivadoが提供するAXI DMAとFIFO Generatorを利用しています。

pio_fifo

pio_fifoはCPUにAXI Lite I/Fを提供するaxi_lite_to_fifoとFIFO Generatorで構成されています。

LCD-2.png

CPUはaxi_lite_to_fifoが提供するレジスタをアクセスする事でFIFOにCommand/Dataを書き込みます。FIFOのデータ幅は17-bitとなっており、上位1-bitがCommand/Data種別、下位16-bitが送信データとなります。

axi_lite_to_fifoではRESET/CS信号やLCD Backlight制御用のレジスタも用意しています。

dma_fifo

dma_fifoはAXI DMA, FIFO Generatorと、グルー・ロジックとしてそれらを繋ぐaxis_to_fifoで構成されています。

LCD-3.png

DMAはメモリから読み出したデータをAXI Streamを使いFIFOへ書き込みます。DMAとFIFOの間はaxis_to_fifoを経由して接続されており、axi_to_fifoがAXI Stream・FIFO間の信号変換を行います。この他、FIFO_prog_full信号をAXI StreamのREADY信号に接続する事でフロー制御を実現しています。これにより、FIFO長より大きなサイズのデータをDMA転送可能です。

lcd_out

このモジュールの機能は単純で、pio_fifoかdma_fifoにデータが存在すれば、読み出してLCDモジュールに送信します。先に記述した通り、dma_fifoのデータを優先して扱います。

クロック

lcd_bus_ctrlでは2つのクロックを利用します。

Name Frequency Usage
AXI_ACLK 100MHz 各種 AXI I/F や AXI DMA
LCD_CLK 20MHz lcd_outでのバス制御

割り込み

本デバイスは割り込み信号を1つ持ちます。これはdma_fifo内部にあるAXI DMAの割り込み信号で、DMA転送完了イベントの検知に利用します。

レジスタ領域

本デバイスはaxi_lite_to_fifoとAXI DMAが提供する2つのレジスタ領域を持ちます。

今回提供するデザインのレジスタ領域は以下の通りです。

Device Base Address
axi_lite_to_fifo 0x48000000
AXI DMA 0x41E00000

AXI DMAについてはAMDが提供するプログラマーズガイドのPG021を参照して下さい。

以降ではaxi_lite_to_fifoが提供するレジスタについて記述します。

レジスタ・マップ

Offset Register Access Reset Value Description
0x000 CTRL RW 0x00000000 Control Register
0x004 STATUS RO 0x00000000 Status Register
0x008 DATA WO 0x00000000 Transmit Data Register
0x010 BACKLIGHT RW 0x00000000 LCD Backlight Control Register

レジスタ仕様

CTRL Register

Offset: 0x000

Access: RW

Reset Value: 0x00000000

Bits Name Access Reset Description
31:8 Reserved - 0 Reserved
1 RESET RW 0 RESET Signal
0 CS RW 0 CS Signal    

フィールド定義

CS
Value Meaning
0 Deassert CS Signal (inactive)
1 Assert CS Signal (active)
RESET
Value Meaning
0 Deassert RESET Signal (inactive)
1 Assert RESET Signal (active)

RESET/CS信号の制御を行います。設定する値は信号線の極性とは関係なく、0:inactive, 1:activeとなります。

STATUS Register

Offset: 0x004

Access: RO/RAC

Reset Value: 0x00000000

Bits Name Access Reset Description
31:16 Reserved - 0 Reserved
17 DMA OVERFLOW RAC 0 DMA FIFO overflow error
16 PIO OVERFLOW RAC 0 PIO FIFO overflow error
15:11 Reserved - 0 Reserved
9 DMA FIFO FULL RO 0 DMA FIFO full status
8 DMA FIFO RMPTY RO 0 DMA FIFO empty status
7:3 Reserved - 0 Reserved
1 PIO FIFO FULL RO 0 PIO FIFO full status
0 PIO FIFO RMPTY RO 0 PIO FIFO empty status

Field Description

DMA OVERFLOW/PIO OVERFLOW
Value Meaning
0 No Error
1 Error Detected

これらのエラービットはRead And Clearとなっており、読み出し後は0に設定されます。エラーが発生した場合、エラービットはレジスタを読み取るまで1が設定され続けます。

DMA FIFO FULL/PIO FIFO FULL
Value Meaning
0 FIFO is not full
1 FIFO is full
DMA FIFO EMPTY/PIO FIFO EMPTY
Value Meaning
0 FIFO is not empty
1 FIFO is epmpty

DATA Register

Offset: 0x008

Access: WO

Reset Value: 0x00000000

Bits Name Access Reset Description
31:17 Reserved - 0 Reserved
16 D/C WO 0 Data/Command Selector
15:0 TX DATA WO 0 Transmit Data

Field Description

D/C
Value Meaning
0 DATA
1 COMMAND

このビットでTX DATAがData/Commandのどちらを送信しているかをLCDに通知します。

TX DATA

本レジスタに書き込んだ値が、DataまたはCommandとしてLCDモジュールに送信されます。Dataは16-bitで送信されますが、Commandの場合は下位8-bitのみ有効です。

BACKLIGHT Register

Offset: 0x010

Access: RW

Reset Value: 0x00000000

Bits Name Access Reset Description
0 BACKLIGHT RW 0 LCD Backlight

Field Description

BACKLIGHT
Value Meaning
0 OFF
1 ON

このビットでLCD BacklightのON/OFFを制御します。

データ送信方法

LCDモジュールへのデータ送信はCPUによるレジスタ書き込みと、DMA転送の2つが用意されています。

CPUによるCommand/Data送信

この機能はpio_fifoが提供します。CPUは送信データをDATA Registerに書き込む事で任意のCommand/DataをLCDモジュールに送信可能です。

CommandとDataの違いはD/CX信号で区別されます。これはDATA Register[16]の設定により指定します。このビットはコマンドを示すビットになっており、0:DATA, 1:COMMANDとなっています。

LCDモジュールにCommandを送信できるのは、DATA Registerへの書き込み処理だけです。

DATA Registerに書き込まれたデータは一旦FIFOに保存され、FIFOでは32ワード分が保存可能です。FIFOが満杯の時に書き込みを行うとOverflow Errorとなります。

DMA転送によるData送信

この機能はdma_fifoが提供します。フレームバッファの様な大量のデータ送信に専用のDMAを用意しています。このDMAによりCPUに負荷を掛ける事なく大量の画像情報を送信可能になります。

DMAにはAMDから提供されるAXI DMAを利用しています。このDMAはScatter-Gather転送が無効化されており、シンプル転送モードによるMemory Readのみ実行可能です。このDMAは転送完了時に割り込みを通知可能です。

DMAはメモリから読み出したデータをFIFOに書き込みます。FIFOが満杯の時にDMA転送を行うとOverflow Errorが発生しますが、実際にはDMAとFIFO間でフロー制御が実行されますのでエラーが発生する事はありません。エラー情報はデバッグ用に残しています。

DMAはLCDモジュールに対してDataのみ送信可能です。Commandは送信できません。

Devicetree

ここではZephyr用Devicetreeの定義内容について記述します。

lcd_bus_ctrl

lcd_bus_ctrlのDevicetreeは以下の通りです。

mipi-dbi@0 {
        compatible = "vnd,mipi-dbi-8080";
        #address-cells = <1>;
        #size-cells = <1>;
        reg = <0x48000000 0x1000>, <0x41e00000 0x1000>;
        reg-names = "pio", "dma";
        bus-width = <16>;

        interrupts = <5 2>;
        interrupt-parent = <&microblaze_riscv_0_axi_intc>;

        #size-cells = <0>;
        lcd0: ili9341@0 {
                compatible = "ilitek,ili9341";
                ...
        };
};

ILI9341はmipi-dbi busの子ノードとして定義する必要があるので、上記の様にlcd_bus_ctrl(vnd,mipi-dbi-8080)を親ノードとして定義します。

lcd_bus_ctrlのDevicetreeはプロジェクト配下のdts/bindings/mipi-dbi/vnd,mipi-dbi-16bit.yamlで定義しています。

レジスタ領域を2つ持つ為、regでは2つの要素を定義します。regの各要素の名称をreg-nameで定義していますが。ドライバではreg-nameで定義された名称を使ってレジスタ情報を取得しますので、この定義は必須です。

bus-widthは8080 busのバス幅を定義します。これは必須パラメータですがドライバでは使いません。情報として明記する目的で定義しています。

割り込みやその他の定義は一般的なデバイスと同じです。

Touch Screen

Touch ScreenはRasPi Pico2でILI9341を動作させた時とほぼ同じで、割り込み番号の定義が異なります。

amba_pl配下に下記の様に定義しています。

touch0: xpt2046@0 {
        compatible = "xptek,xpt2046";

        reg = <0>;
        int-gpios = <&lcd_module_axi_gpio_touch 0 GPIO_ACTIVE_LOW>;

        spi-max-frequency = <2500000>;

        touchscreen-size-x = <240>;
        touchscreen-size-y = <320>;

        min-x = <200>;
        max-x = <3900>;

        min-y = <200>;
        max-y = <3900>;
};

おわりに

CPUの動作周波数が100MHzだと、LVGLのデモは少々重めに見えました。

0
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?