!TE0950
Versal AI Edgeで遊びたいなと思っても，あまり手軽なボードがない...と思っていた時に，
Trentzのボード TE950-03-EGBE21C の在庫がDigikeyにあるよ，と教えてもらって購入．

:: リファレンス
* [TE0950 Test Board|https://wiki.trenz-electronic.de/display/PD/TE0950+Test+Board]
* [TE0950 Basic Linux Example|https://shop.trenz-electronic.de/de/Download/?path=Trenz_Electronic/Development_Boards/TE0950/Reference_Design/2023.2/test_board]

:: まずは動かしてみる
[TE0950 Basic Linux Example|https://shop.trenz-electronic.de/de/Download/?path=Trenz_Electronic/Development_Boards/TE0950/Reference_Design/2023.2/test_board]から，
TE0950-test_board-vivado_2023.2-build_4_20240531092954.zip をダウンロード．
展開すると，test_board/prebuilt の下にビルド済みファイルがある．
file_location.txt に従って，
FAT32でフォーマットされているmicroSDカードにTE950-03-EGBE21C用のファイルをコピー．
 cp boot_images/23_1lse_8gb/u-boot/* /media/miyo/9016-4EF8
 cp -r os/petalinux/8GB/* /media/miyo/9016-4EF8
 cp -r hardware/23_1lse_8gb/* /media/miyo/9016-4EF8
で，ボードの外側に近い方のマイクロUSB端子を使ってホストPCと接続して電源投入．
無事にLinuxが起動してきた．
 root@Trenz:~# uname -a
 Linux Trenz 6.1.30-xilinx-v2023.2 #1 SMP Fri Sep 22 10:41:01 UTC 2023 aarch64 GNU/Linux
EthernetポートにLANケーブルをつなぐとDHCPでIPを取得．
ユーザ名 root / パスワード root で，sshでログインできた．

:: 自分でビルドしてみる
環境は
* Vivado 2023.2.1 - /tools/Xilinx/Vivado/2023.2
** Vivado 2023.2.1の場合は有償ライセンスが必要
** 合成以降を Vivado 2024.2.2 で置換することでライセンスなしでも構築可能
* Petalinux 2023.2 - $HOME/petalinux/2023.2
というもの．


まずは，[TE0950 Basic Linux Example|https://shop.trenz-electronic.de/de/Download/?path=Trenz_Electronic/Development_Boards/TE0950/Reference_Design/2023.2/test_board]から，
TE0950-test_board_noprebuilt-vivado_2023.2-build_4_20240531092954.zip をダウンロード
展開すると，test_boardができる．
test_board/_readme.txtにWebページ以上に細かく手順が書いてあるので読む．
私の場合，まず準備として，
 chmod 755 _create_linux_setup.sh
としてスクリプトに実行権限を付与し，console/base_sh/design_basic_settings.sh を開いて
 export ALTERNATIVE_PETALINUX_XSETTINGS=~/petalinux/2023.2/settings.sh
と変更しておく．
で，
 ./_create_linux_setup.sh
実行
 ------------------------TE Reference Design-------------------------
 --------------------------------------------------------------------
 -- (d)  Go to Documentation (Web Documentation)
 -- (x)  Exit Batch (nothing is done!)
 -- (0)  Module selection guide, project creation...
 -- (1)  Create minimum setup of CMD-Files and exit Batch
 -- (2)  Create maximum setup of CMD-Files and exit Batch
 -- (3)  (internal only) Dev
 -- (g)  Install Board Files from Xilinx Board Store (beta)
 -- (a)  Start  design with unsupported Vivado Version (beta)
 ----
  Select (ex.:'0' for module selection guide):
とかメニューがでてくるので，
 0
を選択．環境チェックが走ったあと，
 ------------------
 Select Module will be done in 2 steps:
 -----
 Step 1: (select column filter):
 -Change module list size (for small monitors only), press: 'full' or 'small'
 -Display current module list, press: 'L' or 'l'
 -Restore whole module list, press: 'R' or 'r'
 -Reduce List by ID, press: 'ID' or 'id' or insert ID columns value directly(filter step is bypassed and id number is used)
 -Reduce List by Article Number, press: 'AN' or 'an'
 -Reduce List by SoC/FPGA, press: 'FPGA' or 'fpga'
 -Reduce List by PCB REV, press: 'PCB' or 'pcb'
 -Reduce List by DDR, press: 'DDR' or 'ddr'
 -Reduce List by Flash, press: 'FLASH' or 'flash'
 -Reduce List by EMMC, press: 'EMMC' or 'emmc'
 -Reduce List by Others, press: 'OTHERS' or 'others'
 -Reduce List by Notes, press: 'NOTES' or 'notes'
 -Exit without selection, press: 'Q' or 'q'
 -----------------------
 Please Enter Option:
と，続いて選択肢のテーブルが表示される．まず，
 id
と入力すると，
 Last Input:<id>
 Note: Input will be compared with list elements, wildcard * possible. Ex.*1*
 Go back to top menu with 'q' or 'Q'
 Step 2: Insert ID:
とでてくるので，利用するボードにあわせて，
 4
を選択．
 You like to start with this device? y/N
と問われるので，
 y
と入力．
 What would you like to do?
 - Create and open delivery binary folder, press 0
 - Create vivado project, press 1
 - Both, press 2
とかでてくる．
 1
を入力．Vivadoが走ってプロジェクトの作成がはじまる．
しばらくすると，VivadoがGUIモードで起動してくるので，Generate Device Image をクリックして，FWを作る．
プロジェクトファイルは vivado/test_board.xpr にできている．
無事にFWができたら，File→Export→Export Hardware...でxsaファイルを作る．
Include device imageにチェックをいれるのを忘れないように．
デフォルトのまますすめると， vivado/vsys_wrapper.xsa ができる．
なお，ビルドにはVivadoの有償ライセンスが必要になる．
有償ライセンスがない場合，たとえば，2024.2では，TE0950に搭載されているXCVE2302向けのビルドができるので，
Vivadoを一旦終了した後で，Vivado 2024.2でvivado/test_board.xprを開いて，
プロジェクトのアップグレードとIPコアのアップデートをおこなうと無事にビルドができる．


次はPetalinuxでu-bootやLinuxなど一式をビルドする．test_board/petalinux を作って作業することに．
(ここでは，Vivado 2024.2を使ってxsaを作った場合でも2023.2を使った)
まずは，test_board/ の下にいる状態で，
 mkdir -p petalinux
 cd petalinux
として作業ディレクトリを作成．
プロジェクトを
 petalinux-create --type project --template versal --name vsys
 cd vsys
で作成して，作成したプロジェクトのディレクトリに移動．
次に，作成したxsaファイルを読み込む．
 petalinux-config --get-hw-description ../../vivado/vsys_wrapper.xsa 
とりあえず，configは，そのまま抜ける．
あらかじめ作ってある設定ファイルがあるので，雑に上書きしてみる．
 pushd ../../os/petalinux/
 tar cvf - project-spec | tar xvf - -C ../../petalinux/vsys/ 
 popd
このままだと，xsaファイルへの参照がおかしいので，再度読み込んでおく．
 petalinux-config --get-hw-description ../../vivado/vsys_wrapper.xsa 
準備がととのったで，ビルド．
 petalinux-build
ビルドがおわったらパッケージを作成して，必要なファイルを集める．
 petalinux-package --boot --plm --psmfw --u-boot --dtb --force
 mkdir -p SD; cp images/linux/{BOOT.BIN,boot.scr,Image,rootfs.cpio.gz.u-boot} SD/
SD以下のファイルをmicroSDカードに書き込む．				      
作成したmicroSDカードでブートすると，無事にLinuxが起動してきた．