Adding a New Recipe to the Workspace Layer
To add a new recipe to the workspace layer, use the petalinux-devtool add
command. For $
petalinux-devtool add bbexample
https://github.com/whbruce/bbexample.git
This command fetches the
source from the specified URL and creates the recipe bbexample in the Devtool
Workspace directory.
$.petalinux-devtool add bbexample https://github.com/whbruce/bbexample.git
[INFO] Sourcing buildtools
[INFO] Sourcing build environment
[INFO] Generating workspace directory
[INFO] devtool add bbexamples https://github.com/whbruce/bbexample.git
NOTE: Starting bitbake server...
NOTE: Started PRServer with DBfile: /scratch/ws/ashwini/lpt/xilinx-ac701-2022.1/build/cache/prserv.sqlite3, Address: 127.0.0.1:33665, PID: 2087898
NOTE: Starting bitbake server...
NOTE: Started PRServer with DBfile: /scratch/ws/ashwini/lpt/xilinx-ac701-2022.1/build/cache/prserv.sqlite3, Address: 127.0.0.1:36189, PID: 2087940
INFO: Fetching git://github.com/whbruce/bbexample.git;protocol=https;branch=master...
Loading cache: 100% |#####################################################################################################################| Time: 0:00:03
Loaded 5436 entries from dependency cache.
Parsing recipes: 100% |###################################################################################################################| Time: 0:00:01
Parsing of 3638 .bb files complete (3634 cached, 4 parsed). 5440 targets, 1029 skipped, 0 masked, 0 errors.
NOTE: Resolving any missing task queue dependencies
Initialising tasks: 100% |################################################################################################################| Time: 0:00:00
Sstate summary: Wanted 0 Local 0 Network 0 Missed 0 Current 0 (0% match, 0% complete)
NOTE: No setscene tasks
NOTE: Executing Tasks
NOTE: Tasks Summary: Attempted 2 tasks of which 0 didn't need to be rerun and all succeeded.
INFO: Using default source tree path /scratch/ws/ashwini/lpt/xilinx-ac701-2022.1/components/yocto/workspace/sources/bbexamples
NOTE: Starting bitbake server...
NOTE: Started PRServer with DBfile: /scratch/ws/ashwini/lpt/xilinx-ac701-2022.1/build/cache/prserv.sqlite3, Address: 127.0.0.1:34873, PID: 2088514
INFO: Recipe /scratch/ws/ashwini/lpt/xilinx-ac701-2022.1/components/yocto/workspace/recipes/bbexamples/bbexamples_git.bb has been automatically created; further editing may be required to make it fully functional
Getting the Status of the Recipes in Your Workspace
Use the petalinux-devtool status
command to list the recipes
currently in your workspace. Information includes the paths to their respective
external source trees.
$ petalinux-devtool status
[INFO] Sourcing buildtools
[INFO] Sourcing build environment
[INFO] Generating workspace directory
[INFO] devtool status
NOTE: Starting bitbake server...
NOTE: Started PRServer with DBfile: /scratch/ws/ashwini/lpt/xilinx-ac701-2022.1/build/cache/prserv.sqlite3, Address: 127.0.0.1:33099, PID: 2088991
bbexample: /scratch/ws/ashwini/lpt/xilinx-ac701-2022.1/components/yocto/workspace/sources/bbexample (/scratch/ws/ashwini/lpt/xilinx-ac701-2022.1/components/yocto/workspace/recipes/bbexample/bbexample_git.bb)
bbexamples: /scratch/ws/ashwini/lpt/xilinx-ac701-2022.1/components/yocto/workspace/sources/bbexamples (/scratch/ws/ashwini/lpt/xilinx-ac701-2022.1/components/yocto/workspace/recipes/bbexamples/bbexamples_git.bb)
Modifying an Existing Recipe
Use the petalinux-devtool modify
command to begin modifying the
source of an existing recipe. This command extracts the source for a recipe to the
Devtool Workspace directory, checks out a branch for development, and applies the
patches, if any, from the recipe as commits on top.
Use the following command to modify the linux-xlnx recipe:
$ petalinux-devtool modify linux-xlnx
Building the Recipe
Use the petalinux-devtool build
command to build your recipe. This
command is equivalent to the bitbake -c populate_sysroot
command.
You must supply the root name of the recipe (i.e., do not provide versions, paths,
or extensions), as shown:
$ petalinux-devtool build linux-xlnx
Building Your Image
Use the petalinux-devtool build-image
command to build an image
using the devtool flow. This will include the recipes which are the workspace
directory. When running this command you must specify the image name to be
built.
$ petalinux-devtool build-image petalinux-image-minimal
Resetting the Recipe
Use the petalinux-devtool reset
command to
remove the recipe and its configurations from Devtool Workspace directory. This
command does not add/append changes in the Devtool Workspace to any layers, you need
to update the recipe append file before running the reset command.
$ petalinux-devtool reset linux-xlnx
petalinux-devtool
in place of devtool in the
examples.