NXP Debian Linux SDK 25.06 Release for i.MX and Layerscape MPU platforms

- Upgrade Debian to 12.9 Bookworm (Base, Server and Desktop) custom RootFS for NXP MPU platforms
- Upgrade GPU/NPU/VPU/ISP driver based on Debian runtime dependencies for imx8/imx9 SoC
- Upgrade NXP-specific components based on lf-6.6.52-2.2.0 for BSP, kernel
- Add support of eIQ AI/ML and GoPoint demos on imx platforms
- Add Weston desktop support for imx91/imx93. For imx8, weston is alternative desktop
- Add support of imx91evk and imx8mpfrdm boards

Signed-off-by: Andy Tang <[email protected]>

Author: andynxp

README.md

@@ -19,7 +19,7 @@ device (SD/eMMC card or USB/SATA disk) on target board or on host machine.
 - Native-build on ARM board running Debian for arm64 target
 
 ## Host system requirement
-- Docker hosted on Ubuntu LTS host (e.g. 22.04, 20.04) or other any distro
+- Docker hosted on Ubuntu LTS host (e.g. 22.04, 24.04) or other any distro
   Refer to [docker-setup](docs/FAQ-docker-setup.md)
   User can run 'bld docker' to create a Debian docker and build it in docker.
 - Debian 12 host
@@ -29,19 +29,15 @@ device (SD/eMMC card or USB/SATA disk) on target board or on host machine.
 ## Supported distro for target arm64
 ------------------------------------------
 - Debian-based userland    (base, desktop, server)
-- Yocto-based userland     (tiny, devel)
-- Buildroot-based userland (tiny, devel)
 
 
 ## Supported platforms
 ----------------------
 - __iMX platform__:  
-imx6qpsabresd, imx6qsabresd, imx6sllevk, imx7ulpevk, imx8mmevk, imx8mnevk, imx8mpevk,  
-imx8mqevk, imx8qmmek, imx8qxpmek, imx8ulpevk, imx93evk, imx91frdm, imx93frdm, etc
+imx8mmevk, imx8mpevk, imx8mpfrdm, imx8mqevk, imx8ulpevk, imx93evk, imx93frdm, imx91evk, imx91frdm
 
 - __Layerscape platform__:  
-ls1012ardb, ls1012afrwy, ls1028ardb, ls1043ardb, ls1046ardb, ls1046afrwy,
-ls1088ardb, ls2088ardb, ls2160ardb, lx2162aqds, etc
+ls1028ardb, ls1043ardb, ls1046ardb, ls2160ardb
 
 
 ## Flexbuild Usage
@@ -72,19 +68,14 @@ Most used example with separate command:
  bld rfs [ -r debian:desktop ]   # generate Debian-based Desktop rootfs  (with more graphics/multimedia packages for Desktop)
  bld rfs -r debian:server        # generate Debian-based Server rootfs   (with more server related packages, no GUI Desktop)
  bld rfs -r debian:base          # generate Debian-based base rootfs     (small footprint with base packages)
- bld rfs -r poky:tiny            # generate poky-based arm64 tiny rootfs
- bld rfs -r buildroot:tiny       # generate Buildroot-based arm64 tiny rootfs
- bld itb -r poky:tiny            # generate poky_tiny_IMX_arm64.itb including kernel, dtb and rootfs_poky_tiny_arm64.cpio.gz
  bld linux [ -p IMX|LS]          # compile linux kernel for all arm64 IMX or LS machines
  bld atf -m lx2160rdb -b sd      # compile atf image for SD boot on lx2160ardb
  bld boot [ -p IMX|LS ]          # generate boot partition tarball (including kernel,dtb,modules,distro bootscript) for iMX/LS machines
  bld apps                        # compile NXP-specific components against the runtime dependencies of Debian Desktop rootfs for i.MX machines
  bld apps -r debian:server -p LS # compile NXP-specific components against the runtime dependencies of Debian Server rootfs for LS machines
- bld ml [ -r <type> ]            # compile NXP-specific eIQ AI/ML components against the library dependencies of Debian rootfs
  bld merge-apps [ -r <type> ]    # merge NXP-specific components into target Debian rootfs (Desktop by default,add '-r debian:server' for Server)
  bld packrfs [ -r <type> ]       # pack and compress target rootfs as rootfs_xx.tar.zst (or add '-r debian:server' for Server)
  bld packapps [ -r <type> ]      # pack and compress target app components as apps_xx.tar.zst (add '-p LS' for Layerscape platforms)
- bld repo-fetch [ <component> ]  # fetch git repository of all or specified component from remote repos if not exist locally
  bld docker                      # create or attach docker container to build in docker
  bld clean                       # clean all obsolete firmware/linux/apps binary images except distro rootfs
  bld clean-apps [ -r <type> ]    # clean the obsolete NXP-specific apps components binary images
@@ -97,8 +88,7 @@ Most used example with separate command:
 
 ## More info
 ------------
-Please refer to https://nxp.com/nxpdebian for more information about NXP Debian Linux SDK Distribution for i.MX and Layerscape.
-[i.MX Debian Linux SDK User's Guide](https://nxp.com/docs/en/user-guide/UG10155.pdf).
-[Layerscape Debian Linux SDK User's Guide](https://nxp.com/docs/en/user-guide/UG10143.pdf).
+Please refer to https://nxp.com/nxpdebian for more information about NXP Debian Linux SDK Distribution.
+[Debian Linux SDK User's Guide]((https://docs.nxp.com/bundle/UG10155).
 
 [flexbuild_usage](docs/flexbuild_usage.md), [build_and_deploy_distro](docs/build_and_deploy_distro.md), [nxp_linux_sdk](docs/nxp_linux_sdk.md) for detailed information.

SCR.txt

@@ -0,0 +1,29 @@
+# [general]
+
+machine=imx8mpfrdm
+
+UBOOT_CONFIG="imx8mp_frdm_defconfig"
+
+# BOARD_VARIANTS="lpddr4 ddr4"
+
+COMPOSITE_IMG1_FILE_sd="bsp/imx-mkimage/imx8mpfrdm/flash.bin"
+
+# distro boot script
+distro_bootscript="bsp/u-boot/imx8mpfrdm/imx8mpfrdm_boot.scr"
+
+# imx8mp-ddr4-evk.dtb for ddr4 rev-a3 board
+# imx8mp-evk.dtb for lpddr4 rev-b2 board with sound-wm8960 codec
+# imx8mp-evk-revb4.dtb for lpddr4 rev-b4 board with new sound-wm8962 codec
+# setenv fdtfile imx8mp-evk-os08a20.dtb for camera os08a20
+
+# set distro boot to generate boot.scr which is searched by u-boot automatically
+distroboot=\
+'env exists fdtfile || setenv fdtfile imx8mp-frdm.dtb;'\
+'env exists image || setenv image Image;'\
+'env exists devpart_boot || setenv devpart_boot 1;'\
+'env exists devpart_root || setenv devpart_root 3;'\
+'part uuid $devtype $devnum:$devpart_root partuuidr;'\
+'setenv bootargs console=ttymxc1,115200 root=PARTUUID=$partuuidr rw rootwait $othbootargs;'\
+'ext4load mmc $mmcdev:$devpart_boot $fdt_addr $fdtfile;'\
+'ext4load mmc $mmcdev:$devpart_boot $loadaddr $image;'\
+'booti $loadaddr - $fdt_addr'

configs/board/imx8mpfrdm.conf

@@ -0,0 +1,23 @@
+# [general]
+
+machine=imx91frdmstorm
+
+UBOOT_CONFIG="imx91_11x11_frdm_storm_defconfig"
+
+COMPOSITE_IMG1_FILE_sd="bsp/imx-mkimage/imx91frdmstorm/flash.bin"
+
+
+# distro boot script
+distro_bootscript="bsp/u-boot/imx91frdmstorm/imx91frdmstorm_boot.scr"
+
+# set distro boot to generate boot.scr which is searched by u-boot
+distroboot=\
+'env exists fdtfile || setenv fdtfile imx91-11x11-frdm-storm.dtb;'\
+'env exists image || setenv image Image;'\
+'env exists devpart_boot || setenv devpart_boot 1;'\
+'env exists devpart_root || setenv devpart_root 3;'\
+'part uuid $devtype $devnum:$devpart_root partuuidr;'\
+'setenv bootargs console=ttyLP0,115200 earlycon root=PARTUUID=$partuuidr rw rootwait $othbootargs;'\
+'ext4load mmc $mmcdev:$mmcpart $fdt_addr $fdtfile;'\
+'ext4load mmc $mmcdev:$mmcpart $loadaddr $image;'\
+'booti $loadaddr - $fdt_addr'

configs/board/imx91frdmstorm.conf

@@ -53,7 +53,7 @@ distroboot=\
 'env exists devpart_boot || setenv devpart_boot 1;'\
 'env exists devpart_root || setenv devpart_root 3;'\
 'part uuid $devtype $devnum:$devpart_root partuuidr;'\
-'setenv bootargs console=ttyS0,115200 earlycon=uart8250,mmio,0x21c0500 root=PARTUUID=$partuuidr rw rootwait video=1920x1080-32@60 cma=640M iommu.passthrough=1 arm-smmu.disable_bypass=0  $othbootargs;'\
+'setenv bootargs console=ttyS0,115200 earlycon=uart8250,mmio,0x21c0500 root=PARTUUID=$partuuidr rw rootwait iommu.passthrough=1 arm-smmu.disable_bypass=0  $othbootargs;'\
 'load $devtype $devnum:$devpart_boot $kernel_addr_r $kernel_image;'\
 'load $devtype $devnum:$devpart_boot $fdt_addr_r $dtb;'\
 'env exists secureboot && echo validating secureboot && run secureboot_validate;'\
@@ -72,7 +72,7 @@ distroboot_ima=\
 'setenv initramfs_addr_r 0xb0000000; setenv initramfsheader_addr_r 0x80300000;'\
 'load $devtype $devnum:$devpart_boot $initramfs_addr_r initramfs.img;'\
 'env exists secureboot && echo validating secureboot && run secureboot_validate;'\
-'setenv bootargs console=ttyS0,115200 earlycon=uart8250,mmio,0x21c0500 root=PARTUUID=$partuuidr rw rootwait video=1920x1080-32@60 cma=256M iommu.passthrough=1 arm-smmu.disable_bypass=0  $othbootargs;'\
+'setenv bootargs console=ttyS0,115200 earlycon=uart8250,mmio,0x21c0500 root=PARTUUID=$partuuidr rw rootwait iommu.passthrough=1 arm-smmu.disable_bypass=0  $othbootargs;'\
 'booti $kernel_addr_r $initramfs_addr_r $fdt_addr_r'
 
 

configs/board/ls1028ardb.conf

@@ -52,6 +52,7 @@ mmdebstrap:
     - util-linux
     - lshw
     - keyutils
+    - locales
     - wpasupplicant
   setup-hooks:
     # Setup NXP board-specific configurations for various platforms
@@ -64,7 +65,7 @@ mmdebstrap:
   customize-hooks:
     - 'chroot "$1" useradd -m -d /home/debian -s /bin/bash debian'
     - 'chroot "$1" gpasswd -a debian sudo'
-    - 'chroot "$1" usermod -aG sudo debian'
+    - 'chroot "$1" usermod -aG sudo,input,video debian'
     - 'chroot "$1" passwd --delete root'
     - 'chroot "$1" passwd --delete debian'
     - 'chroot "$1" apt-get update'
@@ -81,7 +82,6 @@ mmdebstrap:
     - 'cp src/system/platcfg.service $1/lib/systemd/system/'
     - 'cp src/system/blacklist.conf $1/etc/modprobe.d/'
     - 'cp src/system/ts.conf $1/etc/'
-    - 'chroot "$1" ln -s /lib/systemd/system/platcfg.service /etc/systemd/system/multi-user.target.wants/platcfg.service'
     - 'chroot "$1" ln -s /lib/systemd/system/boot.mount /etc/systemd/system/local-fs.target.wants/boot.mount'
     - 'chroot "$1" ln -s /boot/tools/perf /usr/local/bin/perf'
     - 'chroot "$1" ln -s /sbin/init /init'
@@ -90,11 +90,17 @@ mmdebstrap:
     - 'chroot "$1" ln -s /boot/firmware /lib/firmware'
     - 'cp src/system/gpuconfig $1/etc/'
     - 'cp src/system/gpuconfig.service $1/lib/systemd/system/'
+    - 'cp src/system/board_id.sh $1/usr/bin/'
     - 'chroot "$1" ln -s /lib/systemd/system/gpuconfig.service /etc/systemd/system/graphical.target.wants/gpuconfig.service'
     - 'chroot "$1" ln -s /usr/lib/systemd/system/graphical.target /etc/systemd/system/default.target'
-    - 'printf "COGL_DRIVER=gles2\nCLUTTER_DRIVER=gles2\nQT_QPA_PLATFORM=wayland\nGDK_GL=gles" >> $1/etc/environment'
+    - 'chroot "$1" sed -i -e "s/.*zh_CN.UTF-8.*/zh_CN.UTF-8 UTF-8/" -e "s/.*en_US.UTF-8.*/en_US.UTF-8 UTF-8/"  /etc/locale.gen'
+    - 'chroot "$1" /usr/sbin/locale-gen'
+    - 'chroot "$1" /usr/sbin/update-locale LANG=en_US.UTF-8'
+    - 'printf "COGL_DRIVER=gles2\nCLUTTER_DRIVER=gles2\nQT_QPA_PLATFORM=wayland\nGDK_GL=gles\n" >> $1/etc/environment'
+    - 'printf "QT_QUICK_BACKEND=software\n" >> $1/etc/environment'
+    - 'printf "\nexport DISPLAY=:0\nexport WAYLAND_DISPLAY=wayland-1" >> $1/root/.bashrc'
     - 'printf "/usr/lib\n" >> $1/etc/ld.so.conf.d/01-sdk.conf'
     - 'printf " * Support:   https://www.nxp.com/support\n" >> $1/etc/update-motd.d/20-help-text'
     - 'printf " * Licensing: https://lsdk.github.io/eula\n" >> $1/etc/update-motd.d/20-help-text'
-    - 'printf "NXP Linux SDK 2412 Debian base\n" >> $1/etc/issue'
+    - 'printf "NXP Linux SDK 2506 Debian base\n" >> $1/etc/issue'
     - 'printf "Build: `date --rfc-3339 seconds`\n" >> $1/etc/buildinfo'

configs/debian/debian_base_arm64.yaml

@@ -111,6 +111,7 @@ mmdebstrap:
     - v4l-utils
     - mesa-utils
     - alsa-utils
+    - locales
     - dmz-cursor-theme
   setup-hooks:
       # Setup NXP board-specific configurations for various platforms
@@ -123,8 +124,8 @@ mmdebstrap:
   customize-hooks:
     - 'chroot "$1" apt purge -y xserver-xorg xserver-xorg-core xserver-xorg-legacy gnome-games gnome-chess apache2-bin'
     - 'chroot "$1" useradd -m -d /home/debian -s /bin/bash debian'
-    - 'chroot "$1" gpasswd -a debian sudo'
-    - 'chroot "$1" usermod -aG sudo debian'
+    - 'chroot "$1" groupadd wayland'
+    - 'chroot "$1" usermod -aG sudo,input,video,wayland,render debian'
     - 'chroot "$1" passwd --delete root'
     - 'chroot "$1" passwd --delete debian'
     - 'chroot "$1" apt-get update'
@@ -148,11 +149,17 @@ mmdebstrap:
     - 'chroot "$1" ln -s /boot/firmware /lib/firmware'
     - 'cp src/system/gpuconfig $1/etc/'
     - 'cp src/system/gpuconfig.service $1/lib/systemd/system/'
+    - 'cp src/system/board_id.sh $1/usr/bin/'
     - 'chroot "$1" ln -s /lib/systemd/system/gpuconfig.service /etc/systemd/system/graphical.target.wants/gpuconfig.service'
     - 'chroot "$1" ln -s /usr/lib/systemd/system/graphical.target /etc/systemd/system/default.target'
-    - 'printf "COGL_DRIVER=gles2\nCLUTTER_DRIVER=gles2\nQT_QPA_PLATFORM=wayland\nGDK_GL=gles" >> $1/etc/environment'
+    - 'chroot "$1" sed -i -e "s/.*zh_CN.UTF-8.*/zh_CN.UTF-8 UTF-8/" -e "s/.*en_US.UTF-8.*/en_US.UTF-8 UTF-8/"  /etc/locale.gen'
+    - 'chroot "$1" /usr/sbin/locale-gen'
+    - 'chroot "$1" /usr/sbin/update-locale LANG=en_US.UTF-8'
+    - 'printf "COGL_DRIVER=gles2\nCLUTTER_DRIVER=gles2\nQT_QPA_PLATFORM=wayland\nGDK_GL=gles\n" >> $1/etc/environment'
+    - 'printf "QT_QUICK_BACKEND=software\n" >> $1/etc/environment'
+    - 'printf "\nexport DISPLAY=:0\nexport WAYLAND_DISPLAY=wayland-1" >> $1/root/.bashrc'
     - 'printf "/usr/lib\n" >> $1/etc/ld.so.conf.d/01-sdk.conf'
     - 'printf " * Support:   https://www.nxp.com/support\n" >> $1/etc/update-motd.d/20-help-text'
     - 'printf " * Licensing: https://lsdk.github.io/eula\n" >> $1/etc/update-motd.d/20-help-text'
-    - 'printf "NXP Linux SDK 2412 Debian Desktop (optimized with NXP-specific hardware acceleration)\n" >> $1/etc/issue'
+    - 'printf "NXP Linux SDK 2506 Debian Desktop (optimized with NXP-specific hardware acceleration)\n" >> $1/etc/issue'
     - 'printf "Build: `date --rfc-3339 seconds`\n" >> $1/etc/buildinfo'

configs/debian/debian_desktop_arm64.yaml

@@ -89,6 +89,7 @@ mmdebstrap:
     - pipewire-audio
     - pipewire-pulse
     - wireplumber
+    - locales
     - libspa-0.2-bluetooth
   setup-hooks:
       # Setup NXP board-specific configurations for various platforms
@@ -100,7 +101,7 @@ mmdebstrap:
   customize-hooks:
     - 'chroot "$1" useradd -m -d /home/debian -s /bin/bash debian'
     - 'chroot "$1" gpasswd -a debian sudo'
-    - 'chroot "$1" usermod -aG sudo debian'
+    - 'chroot "$1" usermod -aG sudo,input,video debian'
     - 'chroot "$1" passwd --delete root'
     - 'chroot "$1" passwd --delete debian'
     - 'chroot "$1" apt-get update'
@@ -115,15 +116,19 @@ mmdebstrap:
     - 'cp src/system/platcfg.service $1/lib/systemd/system/'
     - 'cp src/system/blacklist.conf $1/etc/modprobe.d/'
     - 'cp src/system/ts.conf $1/etc/'
+    - 'cp src/system/board_id.sh $1/usr/bin/'
     - 'chroot "$1" ln -s /lib/systemd/system/platcfg.service /etc/systemd/system/multi-user.target.wants/platcfg.service'
     - 'chroot "$1" ln -s /lib/systemd/system/boot.mount /etc/systemd/system/local-fs.target.wants/boot.mount'
     - 'chroot "$1" ln -s /boot/tools/perf /usr/local/bin/perf'
     - 'chroot "$1" ln -s /sbin/init /init'
     - 'chroot "$1" ln -s /boot/modules /lib/modules'
     - 'chroot "$1" rm -rf /lib/firmware'
     - 'chroot "$1" ln -s /boot/firmware /lib/firmware'
+    - 'chroot "$1" sed -i -e "s/.*zh_CN.UTF-8.*/zh_CN.UTF-8 UTF-8/" -e "s/.*en_US.UTF-8.*/en_US.UTF-8 UTF-8/"  /etc/locale.gen'
+    - 'chroot "$1" /usr/sbin/locale-gen'
+    - 'chroot "$1" /usr/sbin/update-locale LANG=en_US.UTF-8'
     - 'printf "/usr/lib\n" >> $1/etc/ld.so.conf.d/01-sdk.conf'
     - 'printf " * Support:   https://www.nxp.com/support\n" >> $1/etc/update-motd.d/20-help-text'
     - 'printf " * Licensing: https://lsdk.github.io/eula\n" >> $1/etc/update-motd.d/20-help-text'
-    - 'printf "NXP Linux SDK 2412 Debian Server (optimized with NXP-specific hardware acceleration)\n" >> $1/etc/issue'
+    - 'printf "NXP Linux SDK 2506 Debian Server (optimized with NXP-specific hardware acceleration)\n" >> $1/etc/issue'
     - 'printf "Build: `date --rfc-3339 seconds`\n" >> $1/etc/buildinfo'