CL-SOM-iMX7: Linux: Kernel - Revision history

Igor at 13:20, 25 April 2023

2023-04-25T13:20:41Z

imported>Ilya: /* Getting kernel sources */

2020-02-23T07:00:40Z

‎Getting kernel sources

imported>Valentin: /* Mount boot partition */

2020-02-13T18:52:13Z

‎Mount boot partition

imported>Uri.mashiach at 15:20, 23 May 2019

2019-05-23T15:20:27Z

imported>Uri.mashiach at 13:08, 6 December 2018

2018-12-06T13:08:53Z

Urim at 12:24, 27 March 2018

2018-03-27T12:24:33Z

Ilya: /* NFS Boot Parameters */

2017-08-22T11:09:09Z

‎NFS Boot Parameters

Grinberg: /* Basic platform support */

2017-05-08T15:00:00Z

‎Basic platform support

Grinberg at 12:48, 27 March 2017

2017-03-27T12:48:21Z

Ilya: /* Overview */

2017-02-20T09:26:33Z

‎Overview

@@ Line 15: / Line 15: @@
 === Getting kernel sources ===
-Linux git tree can be cloned <!--or downloaded as a tarball -->from the [https://source.codeaurora.org/external/imx/linux-imx.git Code Aurora].
+Linux git tree can be cloned <!--or downloaded as a tarball -->from the [https://github.com/nxp-imx/linux-imx NXP GitHub].
 The instructions below assume that the {{filename|/home/development/cl-som-imx7/kernel}} directory has been created for CL-SOM-iMX7 kernel development.
 <!--
@@ Line 37: / Line 37: @@
 <pre>
 cd /home/development/cl-som-imx7/kernel
-git clone https://source.codeaurora.org/external/imx/linux-imx.git linux-cl-som-imx7
+git clone https://github.com/nxp-imx/linux-imx.git linux-cl-som-imx7
 </pre>
 * Create a branch for CL-SOM-iMX7 development. The CL-SOM-iMX7 patches are generated vs. [https://source.codeaurora.org/external/imx/linux-imx/tag/?h=rel_virt_4.14.98_4.11_0.10_ga rel_virt_4.14.98_4.11_0.10_ga] tag in the Linux tree. It is recommended to use exactly the same baseline to avoid merge conflicts.

@@ Line 9: / Line 9: @@
 * [https://www.compulab.com/products/sbcs/sbc-iot-imx7-nxp-i-mx-7-internet-of-things-single-board-computer/#devres SBC-IOT-iMX7 Single Board Computer BSP package]
 * [https://www.compulab.com/products/iot-gateways/iot-gate-imx7-nxp-i-mx-7-internet-of-things-gateway/#devres IOT-GATE-iMX7 IoT Gateway BSP package]
-Unzip the downloaded BSP source package to a directory on your host workstation. The following instructions use {{filename|/path/to/cl-som-imx7-linux/}} template for this location. Please use the real path to the Linux package instead.
+Unzip the downloaded BSP source package to a directory on your host workstation. The following instructions use {{filename|/path/to/cl-som-imx7-bsp-src/}} template for this location. Please use the real path to the Linux package instead.
 == Building kernel for CL-SOM-iMX7 ==
@@ Line 46: / Line 46: @@
 * Apply the CL-SOM-iMX7 patch
 <pre>
-git am /path/to/cl-som-imx7-linux/kernel/patches/*.patch
+git am /path/to/cl-som-imx7-bsp-src/kernel/patches/*.patch
 </pre>

@@ Line 15: / Line 15: @@
 === Getting kernel sources ===
-Linux git tree can be cloned or downloaded as a tarball from the [http://git.freescale.com/git/cgit.cgi/imx/linux-imx.git/ NXP public git repository].
+Linux git tree can be cloned <!--or downloaded as a tarball -->from the [https://source.codeaurora.org/external/imx/linux-imx.git Code Aurora].
 The instructions below assume that the {{filename|/home/development/cl-som-imx7/kernel}} directory has been created for CL-SOM-iMX7 kernel development.
 ==== Snapshot download ====
 * Download [http://git.freescale.com/git/cgit.cgi/imx/linux-imx.git/snapshot/linux-imx-rel_imx_4.9.x_1.0.0_ga.tar.gz rel_imx_4.9.11_1.0.0_ga] snapshot with your web browser.
@@ Line 30: / Line 31: @@
 patch -p1 < /path/to/cl-som-imx7-linux/kernel/linux-4.9.11-cl-som-imx7-*.patch
 </pre>
+-->
 ==== Git clone ====
 * Install [http://git-scm.com/ git] version control system.
@@ Line 36: / Line 37: @@
 <pre>
 cd /home/development/cl-som-imx7/kernel
-git clone git://git.freescale.com/imx/linux-imx.git linux-cl-som-imx7
+git clone https://source.codeaurora.org/external/imx/linux-imx.git linux-cl-som-imx7
 </pre>
-* Create a branch for CL-SOM-iMX7 development. The CL-SOM-iMX7 patches are generated vs. [http://git.freescale.com/git/cgit.cgi/imx/linux-imx.git/commit/?h=imx_4.9.11_1.0.0_ga&id=f2ed3bfca174b3e370fc37cd5f75a67334822093 rel_imx_4.9.x_1.0.0_ga] tag in the Linux tree. It is recommended to use exactly the same baseline to avoid merge conflicts.
+* Create a branch for CL-SOM-iMX7 development. The CL-SOM-iMX7 patches are generated vs. [https://source.codeaurora.org/external/imx/linux-imx/tag/?h=rel_virt_4.14.98_4.11_0.10_ga rel_virt_4.14.98_4.11_0.10_ga] tag in the Linux tree. It is recommended to use exactly the same baseline to avoid merge conflicts.
 <pre>
 cd /home/development/cl-som-imx7/kernel/linux-cl-som-imx7
-git checkout -b development rel_imx_4.9.x_1.0.0_ga
+git checkout -b development rel_virt_4.14.98_4.11_0.10_ga
 </pre>
 * Apply the CL-SOM-iMX7 patch
@@ Line 99: / Line 100: @@
 # cp -v ${DTB} /home/development/cl-som-imx7/rootfs/boot/
 # cd -
-# tar -C /home/development/cl-som-imx7/rootfs -czvf /home/development/cl-som-imx7/linux-image-cl-som-imx7.tar.gz .
+# tar --keep-directory-symlink -C /home/development/cl-som-imx7/rootfs -czvf /home/development/cl-som-imx7/linux-image-cl-som-imx7.tar.gz .
 </pre>
@@ Line 127: / Line 128: @@
 * Use the below command to mount the boot partition for installing the CL-SOM-iMX7 Linux kernel binary:
 <pre>
-# boot_partition=`cat /proc/cmdline | awk '{ for (i=1;i<=NF;i++) { if($i~/^root=/) { print substr($i,6,length($i)-6)"1" } } }'`
+# boot_partition=$(boot_partition=$(findmnt -o SOURCE -n /); cat <<< ${boot_partition:0:-1}1)
 # mount $boot_partition /boot
 </pre>
@@ Line 142: / Line 143: @@
 * Extract and install the Linux kernel binary:
 <pre>
-# tar -C / -xvf /root/linux-image-cl-som-imx7.tar.gz
+# tar -C / --keep-directory-symlink -xvf /root/linux-image-cl-som-imx7.tar.gz
 </pre>

@@ Line 53: / Line 53: @@
 export ARCH=arm
 export CROSS_COMPILE=arm-none-linux-eabi-
-export DTB="imx7d-*imx7*.dtb"
+export DTB=$(ls -al arch/arm/boot/dts | awk '(/imx7d-.*imx7.*\.dts$/)&&($0=$NF)$$(gsub(/dts/,"dtb"))')
 make compulab_imx7_defconfig
 make menuconfig
@@ Line 116: / Line 116: @@
 * registration of the devices integrated in the CL-SOM-iMX7 module;
 * definitions of platform-specific configuration for these devices.
 == Deploying the CL-SOM-iMX7 kernel and modules onto eMMC ==
@@ Line 142: / Line 144: @@
 # tar -C / -xvf /root/linux-image-cl-som-imx7.tar.gz
 </pre>
 == See also ==

@@ Line 1: / Line 1: @@
 == Overview ==
-The Linux kernel for CL-SOM-iMX7 provides support for on-board peripherals/interfaces of CL-SOM-iMX7 system-on-module devices (SoM) and following derived devices built around them:
+The CL-SOM-iMX7 Linux kernel provides support for on-board peripherals/interfaces of the CL-SOM-iMX7 System-on-Module and the following CompuLab products built around CL-SOM-iMX7:
 * SBC-iMX7 Single Board Computer
 * SBC-IOT-iMX7 Internet of Things Single Board Computer
 * IOT-GATE-iMX7 Internet of Things Gateway
-Though Linux packages released for different devices may differ from each other. It is recommended to use the most recent Linux package released for specific device used. It can be downloaded from the corresponding product web page:
+BSP packages for different CompuLab i.MX7 devices may differ from each other. It is recommended to use the most recent BSP package released for the specific device being used. It can be downloaded from the corresponding product web page:
-* SBC-iMX7 Single Board Computer [http://www.compulab.com/products/sbcs/sbc-imx7-freescale-i-mx-7-single-board-computer/#devres Linux package]
+* [https://www.compulab.com/products/computer-on-modules/cl-som-imx7-freescale-i-mx-7-system-on-module/#devres CL-SOM-iMX7 System-on-Module BSP package]
-* SBC-IOT-iMX7 Internet of Things Single Board Computer [http://www.compulab.com/products/sbcs/sbc-iot-imx7-nxp-i-mx-7-internet-of-things-single-board-computer/#devres Linux package]
+* [https://www.compulab.com/products/sbcs/sbc-imx7-freescale-i-mx-7-single-board-computer/#devres SBC-iMX7 Single Board Computer BSP package]
-* IOT-GATE-iMX7 Internet of Things Gateway [http://www.compulab.com/products/iot-gateways/iot-gate-imx7-nxp-i-mx-7-internet-of-things-gateway/#devres Linux package]
+* [https://www.compulab.com/products/sbcs/sbc-iot-imx7-nxp-i-mx-7-internet-of-things-single-board-computer/#devres SBC-IOT-iMX7 Single Board Computer BSP package]
-Unzip the downloaded Linux package to a directory on your host workstation. The following discussion uses {{filename|/path/to/cl-som-imx7-linux/}} template for this location. Please use the real path to the Linux package instead.
+* [https://www.compulab.com/products/iot-gateways/iot-gate-imx7-nxp-i-mx-7-internet-of-things-gateway/#devres IOT-GATE-iMX7 IoT Gateway BSP package]
 == Building kernel for CL-SOM-iMX7 ==
@@ Line 14: / Line 15: @@
 === Getting kernel sources ===
-Linux git tree can be cloned or downloaded as a tarball from [http://git.freescale.com/git/cgit.cgi/imx/linux-2.6-imx.git/ Freescale public git repository].
+Linux git tree can be cloned or downloaded as a tarball from the [http://git.freescale.com/git/cgit.cgi/imx/linux-imx.git/ NXP public git repository].
 The instructions below assume that the {{filename|/home/development/cl-som-imx7/kernel}} directory has been created for CL-SOM-iMX7 kernel development.
 ==== Snapshot download ====
@@ Line 32: / Line 33: @@
 ==== Git clone ====
 * Install [http://git-scm.com/ git] version control system.
-* Create a clone of the FreeScale Linux kernel tree
+* Create a clone of the NXP Linux kernel tree
 <pre>
 cd /home/development/cl-som-imx7/kernel
 git clone git://git.freescale.com/imx/linux-imx.git linux-cl-som-imx7
 </pre>
-* Create a branch for CL-SOM-iMX7 development. The CL-SOM-iMX7 patches are generated vs. [http://git.freescale.com/git/cgit.cgi/imx/linux-2.6-imx.git/commit/?id=77f61547834c4f127b44b13e43c59133a35880dc rel_imx_4.1.15_1.2.0_ga] tag in the Linux tree. It is recommended to use exactly the same baseline to avoid merge conflicts.
+* Create a branch for CL-SOM-iMX7 development. The CL-SOM-iMX7 patches are generated vs. [http://git.freescale.com/git/cgit.cgi/imx/linux-imx.git/commit/?h=imx_4.9.11_1.0.0_ga&id=f2ed3bfca174b3e370fc37cd5f75a67334822093 rel_imx_4.9.x_1.0.0_ga] tag in the Linux tree. It is recommended to use exactly the same baseline to avoid merge conflicts.
 <pre>
 cd /home/development/cl-som-imx7/kernel/linux-cl-som-imx7
@@ Line 63: / Line 64: @@
 * loadable kernel modules will be installed into the {{filename|/home/development/cl-som-imx7/rootfs/lib/modules}} directory.
 <br>
-When the CL-SOM-iMX7 is booted with the kernel image created as described above and with networked root filesystem at {{filename|/home/development/cl-som-imx7/rootfs/}}, the system will be able to load the kernel modules properly, thus avoiding module version problems.
+When CL-SOM-iMX7 is booted with the kernel image created as described above and with networked root filesystem at {{filename|/home/development/cl-som-imx7/rootfs/}}, the system will be able to load the kernel modules properly, thus avoiding module version problems.
 ==== zImage, DTB files and modules locations  ====
@@ Line 91: / Line 92: @@
 ==== Prepare kernel and modules tarball  ====
-* In the example below, the Linux kernel and modules are packed into the tar archive for deploying onto the CL-SOM-iMX7 internal storage eMMC.
+* In the example below, the Linux kernel and modules are packed into the tar archive for deploying onto the CL-SOM-iMX7 on-board eMMC storage.
 <pre>
 # mkdir -p /home/development/cl-som-imx7/rootfs/boot
@@ Line 107: / Line 108: @@
 * {{filename|imx7d-sbc-imx7.dtb}} - for SBC-iMX7 Single Board Computer
 ** {{filename|imx7d-sbc-imx7-m4.dtb}} - for SBC-iMX7 Single Board Computer with Cortex-M4 core support
-* {{filename|imx7d-sbc-iot-imx7.dtb}} - for IOT-GATE-iMX7 Internet of Things Gateway and SBC-IOT-iMX7 Internet of Things Single Board Computer
+** {{filename|imx7d-sbc-imx7-lvds.dtb}} - device tree blob for SBC-iMX7 Single Board Computer with LVDS support
 ** {{filename|imx7d-sbc-iot-imx7-can.dtb}} - for IOT-GATE-iMX7 and SBC-IOT-iMX7 with CAN bus support
 ** {{filename|imx7d-sbc-iot-imx7-rs485-hdx.dtb}} - for IOT-GATE-iMX7 and SBC-IOT-iMX7 with RS485 half duplex support
@@ Line 140: / Line 142: @@
 # tar -C / -xvf /root/linux-image-cl-som-imx7.tar.gz
 </pre>
 == See also ==

@@ Line 53: / Line 53: @@
 export ARCH=arm
 export CROSS_COMPILE=arm-none-linux-eabi-
-export DTB="imx7d-*sbc-imx7.dtb imx7d-cl-som-imx7.dtb"
+export DTB="imx7d-sbc-*imx7.dtb imx7d-cl-som-imx7.dtb"
 make cl_som_imx7_defconfig
 make menuconfig
@@ Line 95: / Line 95: @@
 <pre>
 # mkdir -p /home/development/cl-som-imx7/rootfs/boot
-# cp -v /home/development/cl-som-imx7/kernel/linux-cl-som-imx7/arch/arm/boot/zImage /home/development/cl-som-imx7/rootfs/boot/zImage-cl-som-imx7
+# cp -v /home/development/cl-som-imx7/kernel/linux-cl-som-imx7/arch/arm/boot/zImage /home/development/cl-som-imx7/rootfs/boot/
 # cd /home/development/cl-som-imx7/kernel/linux-cl-som-imx7/arch/arm/boot/dts/
 # cp -v ${DTB} /home/development/cl-som-imx7/rootfs/boot/
@@ Line 104: / Line 104: @@
 == Basic platform support ==
-The CL-SOM-iMX7 basic platform support is implemented in the {{parameter|imx7d-cl-som-imx7.dtb}} file of the Linux kernel source tree.
+The CL-SOM-iMX7 basic platform support is implemented in the {{filename|imx7d-cl-som-imx7.dtb}} file of the Linux kernel source tree.
 The extended interface support depends on carrier board used and thus is implemented in the Single Board Computer device tree files:
-* {{parameter|imx7d-sbc-imx7.dtb}} - for SBC-iMX7 Single Board Computer
+* {{filename|imx7d-sbc-imx7.dtb}} - for SBC-iMX7 Single Board Computer
-* {{parameter|imx7d-sbc-iot-imx7.dtb}} - for IOT-GATE-iMX7 Internet of Things Gateway and SBC-IOT-iMX7 Internet of Things Single Board Computer
+* {{filename|imx7d-sbc-iot-imx7.dtb}} - for IOT-GATE-iMX7 Internet of Things Gateway and SBC-IOT-iMX7 Internet of Things Single Board Computer
 These files contain:
@@ Line 117: / Line 117: @@
 * Boot up the CL-SOM-iMX7 computer.
-* Copy the previously created {{filename|linux-image-cl-com-imx7.tar.gz}} to {{filename|/root}} directory of the CL-SOM-iMX7.
+* Copy the previously created {{filename|linux-image-cl-som-imx7.tar.gz}} to {{filename|/root}} directory of the CL-SOM-iMX7.
 ==== Mount boot partition ====
@@ Line 130: / Line 130: @@
 <pre>
 # mkdir /boot/`uname -r`
-# mv /boot/zImage-cl-som-imx7 /boot/*.dtb /boot/`uname -r`/
+# mv /boot/zImage* /boot/*.dtb /boot/`uname -r`/
 </pre>
 ==== Installing kernel and modules ====
-Assuming that the {{filename|linux-image-cl-com-imx7.tar.gz}} tar ball has been copied to the CL-SOM-iMX7 {{filename|/root}} directory.
+Assuming that the {{filename|linux-image-cl-som-imx7.tar.gz}} tar ball has been copied to the CL-SOM-iMX7 {{filename|/root}} directory.
 * Extract and install the Linux kernel binary:
 <pre>
-# tar -C / -xvf /root/linux-image-cl-com-imx7.tar.gz
+# tar -C / -xvf /root/linux-image-cl-som-imx7.tar.gz
 </pre>
@@ Line 156: / Line 156: @@
 </pre>
 Continue to the [[#Common Boot Parameters | Common Boot Parameters]].
 === Common Boot Parameters ===
@@ Line 162: / Line 172: @@
 setenv loadaddr 0x80800000
 setenv fdt_addr 0x83000000
-setenv image zImage-cl-som-imx7
+setenv image zImage
 setenv bootargs console=ttymxc0,115200 root=/dev/${mmcblk} rw rootwait
 mmc dev ${mmcdev}
@@ Line 174: / Line 183: @@
 To boot via network interface type:
 <pre>
 setenv loadaddr 0x80800000
 setenv fdt_addr 0x83000000
-setenv image zImage-cl-som-imx7
+setenv image zImage
 setenv nfsserver <nfs server ip address>
 setenv tftpserver <tftp server ip address>
 setenv bootargs console=ttymxc0,115200 root=/dev/nfs rw ip=dhcp nfsroot=${nfsserver}:${nfsroot}
 tftpboot ${loadaddr} ${tftpserver}:${image}
 tftpboot ${fdt_addr} ${tftpserver}:${fdt_file}