Projetos/rpi-buildroot
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

package/qoriq-mc-utils: new package

Browse Source 
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>
This commit is contained in:
Vladimir Oltean
2025-03-28 20:04:23 +02:00
committed by Thomas Petazzoni
parent 3154fd8ee1
commit 4440f8a245
5 changed files with 125 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

1
DEVELOPERS
View File

@@ -3389,6 +3389,7 @@ F: configs/ts5500_defconfig
N: Vladimir Oltean <olteanv@gmail.com>
F: package/qoriq-ddr-phy-binary/
F: package/qoriq-mc-binary/
F: package/qoriq-mc-utils/
N: Volkov Viacheslav <sv99@inbox.ru>
F: package/v4l2grab/

1
package/Config.in
View File

@@ -452,6 +452,7 @@ menu "Firmware"
source "package/qoriq-ddr-phy-binary/Config.in"
source "package/qoriq-fm-ucode/Config.in"
source "package/qoriq-mc-binary/Config.in"
source "package/qoriq-mc-utils/Config.in"
source "package/rcw-smarc-sal28/Config.in"
source "package/rpi-firmware/Config.in"
source "package/sunxi-boards/Config.in"

76
package/qoriq-mc-utils/Config.in Normal file
View File

@@ -0,0 +1,76 @@
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

3
package/qoriq-mc-utils/qoriq-mc-utils.hash Normal file
View File

@@ -0,0 +1,3 @@
# Locally calculated
sha256 1d3f4a6b2661cff9cfb5d4fcba3b181eb6febdd88a127fa069e306f51d778fc5 qoriq-mc-utils-10.39.0.tar.gz
sha256 7a223031d76339df0e4e5a94d193a270fb9963d42b577aa42fe130a4657f3e17 LICENSE

44
package/qoriq-mc-utils/qoriq-mc-utils.mk Normal file
View File

@@ -0,0 +1,44 @@
################################################################################
#
# qoriq-mc-utils
#
################################################################################
QORIQ_MC_UTILS_VERSION = 10.39.0
QORIQ_MC_UTILS_SITE = $(call github,nxp-qoriq,mc-utils,mc_release_$(QORIQ_MC_UTILS_VERSION))
QORIQ_MC_UTILS_LICENSE = BSD-3-Clause
QORIQ_MC_UTILS_INSTALL_IMAGES = YES
QORIQ_MC_UTILS_DEPENDENCIES = host-dtc
QORIQ_MC_UTILS_DPC_FILES = $(call qstrip,$(BR2_PACKAGE_QORIQ_MC_UTILS_DPC_CUSTOM_PATH))
QORIQ_MC_UTILS_DPC_INTREE = $(call qstrip,$(BR2_PACKAGE_QORIQ_MC_UTILS_DPC_INTREE))
QORIQ_MC_UTILS_DPL_FILES = $(call qstrip,$(BR2_PACKAGE_QORIQ_MC_UTILS_DPL_CUSTOM_PATH))
QORIQ_MC_UTILS_DPL_INTREE = $(call qstrip,$(BR2_PACKAGE_QORIQ_MC_UTILS_DPL_INTREE))
QORIQ_MC_UTILS_INSTALL_PATH = $(call qstrip,$(BR2_PACKAGE_QORIQ_MC_UTILS_TARGET_INSTALL_PATH))
ifeq ($(QORIQ_MC_UTILS_TARGET_INSTALL_PATH),)
QORIQ_MC_UTILS_INSTALL_TARGET = NO
endif
define QORIQ_MC_UTILS_INSTALL_FILES
$(foreach file, $(QORIQ_MC_UTILS_DPC_FILES) $(QORIQ_MC_UTILS_DPL_FILES), \
PATH=$(BR_PATH) dtc -I dts -O dtb $(file).dts -o $(1)/$(notdir $(file)).dtb
)
$(foreach file, $(QORIQ_MC_UTILS_DPC_INTREE) $(QORIQ_MC_UTILS_DPL_INTREE), \
$(INSTALL) -D $(@D)/config/$(file).dtb $(1)/$(notdir $(file)).dtb
)
endef
define QORIQ_MC_UTILS_BUILD_CMDS
PATH=$(BR_PATH) $(MAKE) -C $(@D)/config/
endef
define QORIQ_MC_UTILS_INSTALL_IMAGES_CMDS
$(call QORIQ_MC_UTILS_INSTALL_FILES,$(BINARIES_DIR))
endef
define QORIQ_MC_UTILS_INSTALL_TARGET_CMDS
$(call QORIQ_MC_UTILS_INSTALL_FILES,$(TARGET_DIR)/$(QORIQ_MC_UTILS_INSTALL_PATH))
endef
$(eval $(generic-package))