By Toradex胡珊逢

Toradex 自从 Linux BSP v6 开始在使用 32位处理器的 Arm 模块如 iMX6、iMX6ULL、iMX7 上提供 mainline/upstream kernel ，部分 64位处理器模块如 Verdin iMX8M Mini/Plus 也提供实验性支持。文章将以季度发布版本 Linux BSP V6.3.0 为例介绍如何下载和编译 mainline/upstream Linux kernel 和 U-Boot。

Linux

下载 kernel 源码

内核源码可以从官网 https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git 下载。但考虑到国内网络情况，推荐从国内的镜像站点下载，如 https://mirrors.tuna.tsinghua.edu.cn/git/linux-stable.git。默认下载时会获取最新的 upstream 内核版本。可根据模块上运行 Linux 的版本 checkout 到对应版本源码。在模块上的 Linux 中运行 uname 命令，可以看到当前版本是 6.1.37。后面的 6.3.0 是 Toradex Linux BSP 季度发布版本。季度发布版本是经过充分的自动化和人工测试后发布的，可用于对应模块的生产环境。

----------------------------------

root@apalis-imx6:~# uname -a

Linux apalis-imx6 6.1.37-6.3.0+git.0f4ac6b4c5f0 #1 SMP Sat Jul  1 11:16:27 UTC 2023 armv7l armv7l armv7l GNU/Linux

----------------------------------

在电脑上使用下面命令并 checkout 到 v6.1.37。

----------------------------------

$ git clone https://mirrors.tuna.tsinghua.edu.cn/git/linux-stable.git

$ git checkout v6.1.37

----------------------------------

下载和应用补丁

mainline/upstream kernel 通常还需要一些补丁。它们可以从 meta-toradex-bsp-common 中下载，后续其版本也需要对应到一样的季度版本。首先打开网址 https://git.toradex.com/cgit/toradex-manifest.git/tree/bsp/pinned-tdx.xml?h=6.3.0。结尾的 6.3.0 为对应的季度发布版本号。在页面中可以看到如下内容：

----------------------------------

<project name="meta-toradex-bsp-common.git" path="layers/meta-toradex-bsp-common" remote="tdx" revision="f7ff10a3b560dcf4e258115da679d1f864e09837" upstream="kirkstone-6.x.y"/>

----------------------------------

可以看到 meta-toradex-bsp-common.git 在季度发布版本 6.3.0 对应的 hash 是 f7ff10a3b560dcf4e258115da679d1f864e09837。通常建议使用最新发布的季度版本，获得问题修复和功能完善。因此，下载时请修改季度发布版本号和 hash 值。

进入上面下载的 Linux 源码目录后创建 patch 文件夹，并在其中下载 meta-toradex-bsp-common，checkout 对应用版本。

----------------------------------

$ cd linux-stable/

$ mkdir patch

$ cd patch

$ git clone https://git.toradex.com/cgit/meta-toradex-bsp-common.git

$ cd meta-toradex-bsp-common

$ git checkout f7ff10a3b560dcf4e258115da679d1f864e09837

----------------------------------

将 meta-toradex-bsp-common/recipes-kernel/linux/linux-toradex-mainline-git 的所有 patch 文件复制到 patch 目录下。

----------------------------------

$ cp meta-toradex-bsp-common/recipes-kernel/linux/linux-toradex-mainline-git/*.patch ./

----------------------------------

在 patch 目录下使用 git am 命令给 kernel 打补丁。注意必须要以固定的顺序打补丁。补丁顺序可以参看 meta-toradex-bsp-common/recipes-kernel/linux/linux-toradex-mainline_git.bb 文件。

----------------------------------

SRC_URI:append = " \

    file://0001-thermal-imx-Update-critical-temp-threshold.patch \

    file://0001-Revert-drm-panel-simple-drop-use-of-data-mapping-pro.patch \

    file://0001-arm-dts-colibri-imx6-usb-dual-role-switching.patch \

    file://0002-arm-dts-colibri-imx6-move-vbus-supply-to-module-leve.patch \

    file://0003-arm-dts-colibri-imx6-specify-usbh_pen-gpio-being-act.patch \

    file://0001-arm-dts-colibri-imx6ull-keep-peripherals-disabled.patch \

    file://0002-arm-dts-colibri-imx6ull-enable-default-peripherals.patch \

    file://0001-ARM-dts-colibri-imx6ull-Enable-dual-role-switching.patch \

    file://0002-drivers-chipidea-disable-runtime-pm-for-imx6ul.patch \

    file://0001-ARM-dts-apalis-imx6-Disable-usb-over-current.patch \

    file://0002-ARM-dts-colibri-imx6-Disable-usb-over-current.patch \

    file://0003-ARM-dts-colibri-imx6ull-Disable-usb-over-current.patch \

    file://0004-ARM-dts-colibri-imx7-Disable-usb-over-current.patch \

    file://0001-arm64-dts-imx8mm-verdin-Add-yavia-carrier-board.patch \

    file://0002-arm64-dts-imx8mp-verdin-Add-yavia-carrier-board.patch \

    file://0001-media-v4l2-async-fix-binding-async-subdevs-with-mult.patch \

    file://0002-media-i2c-ov5640-Implement-get_mbus_config.patch \

    file://0001-Revert-media-v4l2-async-Use-endpoints-in-__v4l2_asyn.patch \

"

----------------------------------

在 patch 文件夹里执行面命令，期间不应该出现任何错误和冲突。

----------------------------------

$ cd patch

$ git am 0001-thermal-imx-Update-critical-temp-threshold.patch \

0001-Revert-drm-panel-simple-drop-use-of-data-mapping-pro.patch \

0001-arm-dts-colibri-imx6-usb-dual-role-switching.patch \

0002-arm-dts-colibri-imx6-move-vbus-supply-to-module-leve.patch \

0003-arm-dts-colibri-imx6-specify-usbh_pen-gpio-being-act.patch \

0001-arm-dts-colibri-imx6ull-keep-peripherals-disabled.patch \

0002-arm-dts-colibri-imx6ull-enable-default-peripherals.patch \

0001-ARM-dts-colibri-imx6ull-Enable-dual-role-switching.patch \

0002-drivers-chipidea-disable-runtime-pm-for-imx6ul.patch \

0001-ARM-dts-apalis-imx6-Disable-usb-over-current.patch \

0002-ARM-dts-colibri-imx6-Disable-usb-over-current.patch \

0003-ARM-dts-colibri-imx6ull-Disable-usb-over-current.patch \

0004-ARM-dts-colibri-imx7-Disable-usb-over-current.patch \

0001-arm64-dts-imx8mm-verdin-Add-yavia-carrier-board.patch \

0002-arm64-dts-imx8mp-verdin-Add-yavia-carrier-board.patch \

0001-media-v4l2-async-fix-binding-async-subdevs-with-mult.patch \

0002-media-i2c-ov5640-Implement-get_mbus_config.patch \

0001-Revert-media-v4l2-async-Use-endpoints-in-__v4l2_asyn.patch

----------------------------------

kernel 配置

内核配置文件 .config  也可以从 Toradex Artifactory 下载，并使用对应的季度发布版本的编译文件。打开 Toradex Artifactory 网页，在左边的 Artifact Repository Browser 中点开 oe-release，选择 Linux BSP v6 对应的 kirkstone-6.x.y。依次打开 kirkstone-6.x.y/release/7/apalis-imx6/tdx-xwayland-upstream/tdx-reference-multimedia-image/oedeploy/。release 下面一般可以选择最大序列的，这对应最新的发布版本。右击 kernel-config 下载即可。

将 kernel-config 复制到刚才下载的内核源码目录，命名为 .config ，用其作为 Linux 的默认配置。如果需要修改，后面还可以使用 make menuconfig 命令。

----------------------------------

$ cd linux-stable/

$ mv kernel-config .config

$ make olddefconfig

----------------------------------

准备好源码、补丁和内核配置文件，接下来就可以编译了，具体方法参考这里。

U-Boot

下载 U-Boot 源码

首先从 https://source.denx.de/u-boot/u-boot.git 下载源码，并 checkout 到 v2022.07 版本，也是 Linux BSP v6 所使用的 U-Boot 版本。

----------------------------------

$ git clone https://source.denx.de/u-boot/u-boot.git

$ cd u-boot

$ git checkout v2022.07

----------------------------------

下载和应用补丁

Upstream/mainline U-Boot 同样也需要相关补丁，和上面一样由 meta-toradex-bsp-common 提供。按照前面的方法在 u-boot 目录中建立 patch 文件夹后，在其中下载和 checkout。U-Boot 补丁位于 meta-toradex-bsp-common/recipes-bsp/u-boot/u-boot-toradex 目录下。将里面的 patch 文件复制到 u-boot/patch 目录下。

----------------------------------

$ cd u-boot

$ mkdir patch

$ cd patch

$ git clone https://git.toradex.com/cgit/meta-toradex-bsp-common.git

$ cd meta-toradex-bsp-common

$ git checkout f7ff10a3b560dcf4e258115da679d1f864e09837

$ cp meta-toradex-bsp-common/recipes-bsp/u-boot/u-boot-toradex/*.patch ./

----------------------------------

注意必须要以固定的顺序打补丁。补丁顺序可以参看 U-Boot meta-toradex-bsp-common/recipes-bsp/u-boot/u-boot-toradex_2022.07.bb 文件。

----------------------------------

TDX_PATCHES = " \

    file://0001-toradex-tdx-cfg-block-use-only-snprintf.patch \

    file://0002-toradex-tdx-cfg-block-use-defines-for-string-length.patch \

    file://0003-toradex-tdx-cfg-block-extend-assembly-version.patch \

    file://0004-toradex-tdx-cfg-block-add-new-toradex-oui-range.patch \

    file://0005-toradex-tdx-cfg-block-add-0068-i.mx-8m-mini-sku.patch \

    file://0006-toradex-common-Remove-stale-comments-about-modules-a.patch \

    file://0007-toradex-common-Use-ARRAY_SIZE-macro.patch \

    file://0008-toradex-tdx-cfg-block-Cleanup-interactive-cfg-block-.patch \

    file://0009-toradex-common-Remove-stale-function-declaration.patch \

    file://0010-toradex-common-Remove-ifdef-usage-for-2nd-ethaddr.patch \

    file://0011-toradex-tdx-cfg-block-Use-official-SKU-names.patch \

    file://0012-toradex-common-Improve-product-serial-print-during-b.patch \

    file://0013-configs-colibri-imx7-Enable-bootd-command.patch \

    file://0001-ARM-imx8mp-verdin-imx8mp-Add-memory-size-detection.patch \

    file://0001-apalis-colibri_imx6-imx6ull-_imx7-update-env-memory-.patch \

    file://0001-configs-colibri-imx7-Fix-bad-block-table-in-flash-co.patch \

    file://0001-colibri_imx6-fix-RALAT-and-WALAT-values.patch \

"

----------------------------------

在 patch 文件夹里执行面 git am 命令，期间不应该出现任何错误和冲突。

----------------------------------

$ git am 0001-toradex-tdx-cfg-block-use-only-snprintf.patch \

0002-toradex-tdx-cfg-block-use-defines-for-string-length.patch \

0003-toradex-tdx-cfg-block-extend-assembly-version.patch \

0004-toradex-tdx-cfg-block-add-new-toradex-oui-range.patch \

0005-toradex-tdx-cfg-block-add-0068-i.mx-8m-mini-sku.patch \

0006-toradex-common-Remove-stale-comments-about-modules-a.patch \

0007-toradex-common-Use-ARRAY_SIZE-macro.patch \

0008-toradex-tdx-cfg-block-Cleanup-interactive-cfg-block-.patch \

0009-toradex-common-Remove-stale-function-declaration.patch \

0010-toradex-common-Remove-ifdef-usage-for-2nd-ethaddr.patch \

0011-toradex-tdx-cfg-block-Use-official-SKU-names.patch \

0012-toradex-common-Improve-product-serial-print-during-b.patch \

0013-configs-colibri-imx7-Enable-bootd-command.patch \

0001-ARM-imx8mp-verdin-imx8mp-Add-memory-size-detection.patch \

0001-apalis-colibri_imx6-imx6ull-_imx7-update-env-memory-.patch \

0001-configs-colibri-imx7-Fix-bad-block-table-in-flash-co.patch \

0001-colibri_imx6-fix-RALAT-and-WALAT-values.patch

----------------------------------

U-Boot  配置

对于 32位处理器的模块，默认配置如下：

l colibri_imx6_defconfig

l colibri-imx6ull_defconfig

l colibri-imx6ull-emmc_defconfig

l colibri_imx7_defconfig

l colibri_imx7_emmc_defconfig

l apalis_imx6_defconfig

以  Apalis iMX6 为例。

----------------------------------

$ make mrproper

$ make apalis_imx6_defconfig

----------------------------------

最后编译 U-Boot。

----------------------------------

$ make -j$(nproc)

----------------------------------