PetaLinux TE-Template

PetaLinux 2024.2

Petalinux 2024.2 is under review documentation for 2024.2 can be changed permanently at the moment

Create own template

Clear existing project with: petalinux-build -x mrproper
1. in case changes in u-boot or kernel, see Issues and note
change/remove manually(on linux file manager press Strg+H to see hidden files):

folder/file	Delete	Note
<base folder>	*.xsa	".gitignore" can be stay there
.petalinux/	all, excepted "metadata"	"metadata" must be stay there to keep folder in case git is used
components/	delete whole folder	will be recreated with xsa import
project-spec/	--	"attributes" must be stay there
project-spec/configs/	all, excepted ""config" and "rootfs_config"
project-spec/hw-description/	delete whole folder	will be recreated with xsa import
project-spec/meta-user	---	complete folder and content must be stay there

3. comment out DDR settings in ""project-spec/configs/config", see Issues and notes

GIT Ignore

Extended git ignore file:

.gitignore

#default amd/xilinx
*/*/config.old
*/*/rootfs_config.old
build/
images/linux/
pre-built/linux/
.petalinux/*
!.petalinux/metadata
*.o
*.jou
*.log
components/plnx_workspace
components/yocto

#trenz template  
*.xsa
project-spec/configs/.Xil
project-spec/configs/.statistics
project-spec/configs/flash_parts.txt
project-spec/configs/gen-machineconf.log
project-spec/configs/gen-machineconf.log.old
project-spec/configs/plnx_syshw_data
project-spec/hw-description/
project-spec/configs/busybox/
project-spec/configs/init-ifupdown/
project-spec/configs/systemd-conf/
project-spec/configs/configs/
project-spec/configs/rootfsconfigs/

Use template

copy xsa into base folder
reload XSA with petalinux-config --get-hw-description=<XSA Filename>.xsa
build or change design like prefer

Issues and Notes

Issue

Workaround

Note

DDR size will be not reloaded

comment out DDR size settings in "project-spec/configs/config" to force DDR reload with XSA import:

Only important, if DDR size will is changed for different assembly variants

DDR configuration will be reloaded with xsa import.

PetaLinux 2023.2

Petalinux 2023.2 is under review documentation for 2023.2 can be changed permanently at the moment

Create own template

Clear existing project with: petalinux-build -x mrproper
1. in case changes in u-boot or kernel, see Issues and note
change/remove manually(on linux file manager press Strg+H to see hidden files):

folder/file	Delete	Note
<base folder>	*.xsa .gitignore	"config.project" must be stay there
.petalinux/	all, excepted "metadata"	"metadata" must be stay there
.xil/	complete folder
components/	---	should be empty
project-spec/	yocto-layer.log	"attributes" must be stay there
project-spec/configs/	*.old .Xil	"config" and "rootfs_config" must be stay there
project-spec/hw-description/	all, excepted "metadata"	"metadata" must be stay there
project-spec/meta-user	---	complete folder must be stay there

3. uncomment DDR settings in ""project-spec/configs/config", see Issues and notes

Use template

copy xsa into base folder
reload XSA with petalinux-config --get-hw-description
build or change design like prefer

Issues and Notes

Issue	Workaround	Note
DDR size will be not reloaded	comment out DDR settings in "project-spec/configs/config" to force DDR reload with XSA import	Only important, if DDR size will is changed

PetaLinux 2022.2

Create own template

Clear existing project with: petalinux-build -x mrproper
1. in case changes in u-boot or kernel, see Issues and note
change/remove manually(on linux file manager press Strg+H to see hidden files):

folder/file	Delete	Note
<base folder>	*.xsa .gitignore	"config.project" must be stay there
.petalinux/	all, excepted "metadata"	"metadata" must be stay there
.xil/	complete folder
components/	---	should be empty
project-spec/	yocto-layer.log	"attributes" must be stay there
project-spec/configs/	config.old rootfs_config.old	"config" and "rootfs_config" must be stay there
project-spec/hw-description/	all, excepted "metadata"	"metadata" must be stay there
project-spec/meta-user	---	complete folder must be stay there

3. uncomment DDR settings in ""project-spec/configs/config", see Issues and notes

Use template

copy xsa into base folder
reload XSA with petalinux-config --get-hw-description
build or change design like prefer

Issues and Notes

Issue	Workaround	Note
DDR size will be not reloaded	comment out DDR settings in "project-spec/configs/config" to force DDR reload with XSA import	Only important, if DDR size will is changed

PetaLinux 2021.2

Petalinux 2021.2 is under review documentation for 2021.2 can be changed permanently at the moment

Create own template

Clear existing project with: petalinux-build -x mrproper
1. in case changes in u-boot or kernel, see Issues and note
change/remove manually(on linux file manager press Strg+H to see hidden files):

folder/file	Delete	Note
<base folder>	*.xsa .gitignore	"config.project" must be stay there
.petalinux/	all, excepted "metadata"	"metadata" must be stay there
.xil/	complete folder
components/	---	should be empty
project-spec/	yocto-layer.log	"attributes" must be stay there
project-spec/configs/	config.old rootfs_config.old	"config" and "rootfs_config" must be stay there
project-spec/hw-description/	all, excepted "metadata"	"metadata" must be stay there
project-spec/meta-user	---	complete folder must be stay there

3. uncomment DDR settings in ""project-spec/configs/config", see Issues and notes

Use template

copy xsa into base folder
reload XSA with petalinux-config --get-hw-description
build or change design like prefer

Issues and Notes

Issue	Workaround	Note
DDR size will be not reloaded	comment out DDR settings in "project-spec/configs/config" to force DDR reload with XSA import	Only important, if DDR size will is changed

PetaLinux 2020.2

Create own template

Clear existing project with: petalinux-build -x mrproper
1. in case changes in u-boot or kernel, see Issues and note
change/remove manually(on linux file manager press Strg+H to see hidden files):

folder/file	Delete	Note
<base folder>	*.xsa .gitignore	"config.project" must be stay there
.petalinux/	all, excepted "metadata"	"metadata" must be stay there
.xil/	complete folder
components/	---	should be empty
project-spec/	yocto-layer.log	"attributes" must be stay there
project-spec/configs/	config.old rootfs_config.old	"config" and "rootfs_config" must be stay there
project-spec/hw-description/	all, excepted "metadata"	"metadata" must be stay there
project-spec/meta-user	---	complete folder must be stay there

3. uncomment DDR settings in ""project-spec/configs/config", see Issues and notes

Use template

copy xsa into base folder
reload XSA with petalinux-config --get-hw-description
build or change design like prefer

Issues and Notes

Issue	Workaround	Note
DDR size will be not reloaded	comment out DDR settings in "project-spec/configs/config" to force DDR reload with XSA import	Only important, if DDR size will is changed

PetaLinux 2019.2

Create own template

Clear existing project with: petalinux-build -x mrproper
1. in case changes in u-boot or kernel, see Issues and note
change/remove manually:

folder/file	Delete	Note
<base folder>	*.xsa .gitignore	"config.project" must be stay there
.petalinux/	all, excepted "metadata"	"metadata" must be stay there
.xil/	complete folder
components/	---	should be empty
project-spec/	yocto-layer.log	"attributes" must be stay there
project-spec/configs/	config.old rootfs_config.old	"config" and "rootfs_config" must be stay there
project-spec/hw-description/	all, excepted "metadata"	"metadata" must be stay there
project-spec/meta-plnx-generated	complete folder
project-spec/meta-user	---	complete folder must be stay there

Use template

copy hdf into base folder
reload XSA with petalinux-config --get-hw-description
build or change design like prefer

Issues and Notes

Issue Workaround Note

DDR size will be not reloaded

comment out DDR settings in "project-spec/configs/config" to force DDR reload with HDF import

Only important, if DDR size will is changed

Kernel and u–bot changes will not saved automatically in meta-user

run:

petalinux-build -c kernel -x finish -f
petalinux-build -c u-boot -x finish -f

before the project will be cleared.

only need if you change something in uboot ot kernel setup

PetaLinux 2018.3

Create own template

Clear existing project with: petalinux-build -x mrproper
change/remove manually:

folder/file	Delete	Note
<base folder>	*.hdf .gitignore	"config.project" must be stay there
.petalinux/	all, excepted "metadata"	"metadata" must be stay there
.xil/	complete folder
components/	---	should be empty
project-spec/	yocto-layer.log	"attributes" must be stay there
project-spec/configs/	config.old rootfs_config.old	"config" and "rootfs_config" must be stay there
project-spec/hw-description/	all, excepted "metadata"	"metadata" must be stay there
project-spec/meta-plnx-generated	complete folder
project-spec/meta-user	---	complete folder must be stay there

Use template

copy hdf into base folder
reload HDF with petalinux-config --get-hw-description
build or change design like prefer

Issues and Notes

Issue	Workaround	Note
DDR size will be not reloaded	comment out DDR settings in "project-spec/configs/config" to force DDR reload with HDF import	Only important, if DDR size will is changed

PetaLinux 2018.2

Create own template

Clear existing project with: petalinux-build -x mrproper
change/remove manually:

folder/file	Delete	Note
<base folder>	*.hdf .gitignore	"config.project" must be stay there
.petalinux/	all, excepted "metadata"	"metadata" must be stay there
.xil/	complete folder
components/	---	should be empty
project-spec/	yocto-layer.log	"attributes" must be stay there
project-spec/configs/	config.old rootfs_config.old	"config" and "rootfs_config" must be stay there
project-spec/hw-description/	all, excepted "metadata"	"metadata" must be stay there
project-spec/meta-plnx-generated	complete folder
project-spec/meta-user	---	complete folder must be stay there

Use template

copy hdf into base folder
reload HDF with petalinux-config --get-hw-description
build or change design like prefer

Issues and Notes

Issue	Workaround	Note
DDR size will be not reloaded	comment out DDR settings in "project-spec/configs/config" to force DDR reload with HDF import	Only important, if DDR size will is changed

PetaLinux 2017.4

Create own template

Clear existing project with: petalinux-build -x mrproper
change/remove manually:

folder/file	Delete Files/Folder	Note
<base folder>	*.hdf .gitignore	"config.project" must be stay there
.petalinux/	all, excepted "metadata"	"metadata" must be stay there
.xil/	complete folder
components/	---	should be empty
project-spec/	yocto-layer.log	"attributes" must be stay there
project-spec/configs/	config.old rootfs_config.old	"config" and "rootfs_config" must be stay there
project-spec/hw-description/	all, excepted "metadata"	"metadata" must be stay there
project-spec/meta-plnx-generated	complete folder
project-spec/meta-user	---	complete folder must be stay there

Use template

copy hdf into base folder
reload HDF with petalinux-config --get-hw-description
build or change design like prefer

Issues and Notes

Issue	Workaround	Note
temp folder path is absolute path	change CONFIG_TMP_DIR_LOCATION from "project-spec/configs/config" to the correct project dir	Trenz Electronic provide init_config.sh script to change path to the current project

Trenz Electronic Documentation

PetaLinux TE-Template

PetaLinux 2024.2

Create own template

GIT Ignore

Use template

Issues and Notes

PetaLinux 2023.2

Create own template

Use template

Issues and Notes

PetaLinux 2022.2

Create own template

Use template

Issues and Notes

PetaLinux 2021.2

Create own template

Use template

Issues and Notes

PetaLinux 2020.2

Create own template

Use template

Issues and Notes

PetaLinux 2019.2

Create own template

Use template

Issues and Notes

PetaLinux 2018.3

Create own template

Use template

Issues and Notes

PetaLinux 2018.2

Create own template

Use template

Issues and Notes

PetaLinux 2017.4

Create own template

Use template

Issues and Notes