Files
buildroot/package/qoriq-mc-utils/Config.in
Vladimir Oltean 4440f8a245 package/qoriq-mc-utils: new package
The configuration files for the MC firmware binary are distributed
through a separate repository on GitHub, and need a different package.
They are licensed differently than the firmware itself, and unlike the
firmware, they are customizable.

There are two ways for a board to use this package - similar to
qoriq-rcw. If it is an NXP reference board or if the example files
otherwise work fine with it, it is recommended to set the _INTREE
variables to select a pre-existing DPL and DPC. Otherwise, if it is a
custom board, the best solution is to just provide the DPL and DPC dts
files in board/, and set the _CUSTOM_PATH variables to point to them.

There are also two ways to deploy to the target.

Traditionally in NXP BSPs, U-Boot loads the MC firmware, DPL and DPC
from given offsets in the storage medium (outside of the filesystem).
But this is not hardcoded and it doesn't have to be the case - the
mcinitcmd U-Boot environment variable is freely customizable. What can
also be done, and is done for the LX2160A-RDB, is to deploy multiple DPL
and DPC files (all the files available for a board) to a folder of the
rootfs, and just have two symlinks: dpl.dtb and dpc.dtb which point to
the currently active files. This makes easier the processes of
upgrading, downgrading and keeping multiple file versions.

Nonetheless, the "traditional" method of deploying to the target is also
possible. The selected DPL and DPC files are deployed to the "images"
folder and are freely usable with genimage or other post-image scripts.

Signed-off-by: Vladimir Oltean <olteanv@gmail.com>
Signed-off-by: Thomas Petazzoni <thomas.petazzoni@bootlin.com>
2025-04-22 23:52:12 +02:00

77 lines
2.9 KiB
Plaintext

config BR2_PACKAGE_QORIQ_MC_UTILS
bool "qoriq-mc-utils"
select BR2_PACKAGE_HOST_DTC
help
The Management Complex (MC) is a key component of the
networking subsystem named DPAA2 (Data Path Acceleration
Architecture, second version) in some NXP Layerscape SoCs.
The MC firmware is configured through two distinct files
named DPL and DPC, which are customizable by the end user.
Example configuration files for NXP reference boards are
distributed through this package, and are frequently patched
to produce the configuration required in other scenarios.
https://github.com/nxp-qoriq/mc-utils
# sign in required
https://www.nxp.com/webapp/Download?colCode=DPAA2UM
if BR2_PACKAGE_QORIQ_MC_UTILS
config BR2_PACKAGE_QORIQ_MC_UTILS_DPC_CUSTOM_PATH
string "Data Path Configuration (DPC) custom file paths"
help
The DPC file contains the settings defining the behavior
of the MC firmware. Its structure follows the device
tree syntax and is compiled to a device tree blob.
This option defines a space-separated list of device
tree source (DTS) file names, specified without
the trailing .dts. It should be used when the NXP
qoriq-mc-utils repository does not contain an adequate
DPC for the platform, and is preferable to patching
the package.
config BR2_PACKAGE_QORIQ_MC_UTILS_DPC_INTREE
string "Data Path Configuration (DPC) in-tree files"
help
This option defines a space-separated list of device
tree source (DTS) files relative to the "config/"
folder of the qoriq-mc-utils repository, specified
without the trailing .dts. It should be used when NXP
provides an adequate DPC for the platform.
config BR2_PACKAGE_QORIQ_MC_UTILS_DPL_CUSTOM_PATH
string "Data Path Layout (DPL) custom file paths"
help
The DPL file contains a description of the initial
networking objects created by the MC firmware when it
boots. Its structure follows the device tree syntax
and is compiled to a device tree blob.
This option defines a space-separated list of device
tree source (DTS) files, specified without the
trailing .dts. It should be used when the NXP
qoriq-mc-utils repository does not contain an
adequate DPL for the platform, and is preferable to
patching the package.
config BR2_PACKAGE_QORIQ_MC_UTILS_DPL_INTREE
string "Data Path Layout (DPL) in-tree files"
help
This option defines a space-separated list of device
tree source (DTS) files relative to the "config/"
folder of the qoriq-mc-utils repository, specified
without the trailing .dts. It should be used when NXP
provides an adequate DPL for the platform.
config BR2_PACKAGE_QORIQ_MC_UTILS_TARGET_INSTALL_PATH
string "Path on target to install DPL and DPC files"
help
The DPL and DPC files can optionally be deployed to
the target at the path specified here. This is useful
if the mcinitcmd U-Boot environment variable is
configured to apply the DPL and DPC from the filesystem.
endif