Yocto Build Linux: Difference between revisions

From Variscite Wiki
No edit summary
(41 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<!-- Set release according to "release" parameter in URL and use MORTY_BETA_DART-6UL as default
<!-- Set release according to "release" parameter in URL and use MORTY_V1.0_DART-6UL as default
--> {{#vardefine:RELEASE_PARAM|{{#urlget:release}}}} <!--
--> {{#vardefine:RELEASE_PARAM|{{#urlget:release|RELEASE_MORTY_V1.0_DART-6UL}}}} <!--
--> {{#lst:Yocto_Platform_Customization|{{#var:RELEASE_PARAM|RELEASE_MORTY_BETA_DART-6UL}}}} <!--
--> {{#lst:Yocto_Platform_Customization|{{#var:RELEASE_PARAM}}}} <!--
--> {{PageHeader|Yocto Build Linux from source code}} {{DocImage|category1={{#var:HARDWARE_NAME}}|category2=Yocto}} __toc__
--> {{#lst:B2QT_Platform_Customization|{{#var:RELEASE_PARAM}}}} <!--
--> {{PageHeader|Build Linux from source code}} {{DocImage|category1=Yocto|category2={{#var:HARDWARE_NAME}}}} __toc__
{{note|It is recommended to build the kernel image using Yocto (see the {{Varlink|Yocto Customizing the Linux kernel|{{#var:RELEASE_LINK}}|Customizing the Linux kernel}} page) instead of using the direct method described in this page.<br>
This is because some of the Yocto packages may depend on the kernel, like the WiFi module that is built from outside of the kernel source tree on some of the Yocto releases.}}
 
= Toolchain installation for out of Yocto builds =
= Toolchain installation for out of Yocto builds =


Line 10: Line 14:


Get the Linux source code:  
Get the Linux source code:  
$ cd {{#var:BUILD_FOLDER}}
  $ git clone {{#var:KERNEL_GIT}}
  $ git clone {{#var:KERNEL_GIT}}
  $ cd linux-2.6-imx
  $ cd {{#var:KERNEL_REPO_NAME}}
$ git checkout -b {{#var:KERNEL_BRANCH}} origin/{{#var:KERNEL_BRANCH}}
$ git checkout {{#var:KERNEL_BRANCH}}


Build the Linux kernel:
Build the Linux kernel:
  $ source {{#var:TOOLCHAIN_LOCATION}}
  $ source {{#var:TOOLCHAIN_LOCATION}}{{#ifeq: {{#var:SOC_SERIES}}|imx8|<br>$ unset LDFLAGS|}}


  $ make mrproper
  $ make mrproper
  $ make {{#var:KERNEL_DEFCONFIG}}
  $ make {{#var:KERNEL_DEFCONFIG}}
Customize the kernel configuration (optional step):
$ make menuconfig
  Build everything:
  Build everything:
  $ make -j4
  $ make -j4
Line 25: Line 32:
  Build {{#var:KERNEL_IMAGE}} only:
  Build {{#var:KERNEL_IMAGE}} only:
  $ make -j4 {{#var:KERNEL_BUILD_PARAMS}} {{#var:KERNEL_IMAGE}}
  $ make -j4 {{#var:KERNEL_BUILD_PARAMS}} {{#var:KERNEL_IMAGE}}
  Build modules only:
  Build modules only:
  $ make -j4 {{#var:KERNEL_BUILD_PARAMS}} modules
  $ make -j4 {{#var:KERNEL_BUILD_PARAMS}} modules
 
  Build device trees only:
  Build device trees only:
  $ make -j4 dtbs
  $ make -j4 dtbs
<!-- Attach DTB section from specific release-->
<!-- Attach DTB section from specific release-->
{{#lst:Yocto_Platform_Customization|{{#var:KERNEL_DTB_SECTION}}}}
{{#lst:Yocto_Platform_Customization|{{#var:KERNEL_DTB_SECTION}}}}


Notes:<br>
Notes:<br>
- If you replace the kernel image ({{#var:KERNEL_IMAGE}}) on your system, you also need to reinstall the kernel modules, and vice versa.<br>
{{note|If you replace the kernel image ({{#var:KERNEL_IMAGE}}) on your system, you also need to reinstall the kernel modules, and vice versa.}}
- If you just want to make a change in the device tree, you can compile and replace it without replacing the kernel image and modules.<br>
{{note|If you just want to make a change in the device tree, you can compile and replace it without replacing the kernel image and modules.}}


= Install the built kernel on an SD card =
= Install the built kernel on an SD card =


Copy the {{#var:KERNEL_IMAGE}} and device trees to the SD card boot partition, and install the modules in the SD card rootfs partition.<br>
Copy the {{#var:KERNEL_IMAGE}} and device trees to the SD card boot partition, and install the modules in the SD card rootfs partition.<br>
Assuming the boot partition is mounted on /media/BOOT-{{#var:HARDWARE_NAME}} and the rootfs partition is mounted on /media/rootfs:
Assuming the {{#ifeq: {{#var:SOC_SERIES}}|imx8||boot partition is mounted on /media/user/{{#var:EMMC_FAT_PARTITION_NAME}} and the&nbsp;}}rootfs partition is mounted on /media/user/rootfs:
 
{{#ifeq: {{#var:SOC_SERIES}}|imx8 |
<br>
Install the kernel image and modules:
$ kver=$(strings arch/arm64/boot/Image <nowiki>|</nowiki> grep -i "Linux version" <nowiki>|</nowiki> awk '{print $3}')
$ sudo cp arch/arm64/boot/{{#var:KERNEL_IMAGE}} /media/user/rootfs/boot/{{#var:KERNEL_IMAGE}}-${kver}
$ sudo ln -fs /boot/{{#var:KERNEL_IMAGE}}-${kver} /media/user/rootfs/boot/{{#var:KERNEL_IMAGE}}
$ sudo make ARCH=arm64 modules_install INSTALL_MOD_PATH=/media/user/rootfs
Install the device trees:
{{#ifeq: {{#var:YOCTO_NAME}}|Morty|$ for dtb in arch/arm64/boot/dts/variscite/*.dtb; do sudo cp $dtb /media/user/rootfs/boot/devicetree-Image.gz-$(basename $dtb); done | $ sudo cp arch/arm64/boot/dts/freescale/*imx*var*.dtb /media/user/rootfs/boot/}}
|
<br>
  Install the kernel image and modules:
  Install the kernel image and modules:
  $ cp arch/arm/boot/{{#var:KERNEL_IMAGE}} /media/{{#var:EMMC_FAT_PARTITION_NAME}}
  $ cp arch/arm/boot/{{#var:KERNEL_IMAGE}} /media/user/{{#var:EMMC_FAT_PARTITION_NAME}}
  $ sudo make ARCH=arm modules_install INSTALL_MOD_PATH=/media/rootfs
  $ sudo make ARCH=arm modules_install INSTALL_MOD_PATH=/media/user/rootfs
 
  Install the device trees:
  Install the device trees:
  $ cp arch/arm/boot/dts/*var*.dtb /media/{{#var:EMMC_FAT_PARTITION_NAME}}
  {{#ifeq: {{#var:HARDWARE_NAME}} | DART-6UL | $ cp arch/arm/boot/dts/imx6ul*var*.dtb /media/user/{{#var:EMMC_FAT_PARTITION_NAME}}}}
 
{{#ifeq: {{#var:HARDWARE_NAME}} | VAR-SOM-MX7 | $ cp arch/arm/boot/dts/imx7*var*.dtb /media/user/{{#var:EMMC_FAT_PARTITION_NAME}}}}
Note:<br>
{{#ifeq: {{#var:HARDWARE_NAME}} | VAR-SOM-MX6 | $ cp arch/arm/boot/dts/imx6q*var*.dtb  /media/user/{{#var:EMMC_FAT_PARTITION_NAME}}<br>$ cp arch/arm/boot/dts/imx6dl*var*.dtb /media/user/{{#var:EMMC_FAT_PARTITION_NAME}}}}
If you are using our {{Varlink2|Yocto Recovery SD card|{{#var:RELEASE_LINK}}}}, and you want the NAND flash/eMMC installation to update as well as the SD card boot itself, you need to also update the /opt/images/Yocto directory.
Notes:<br>
* If you are using our {{Varlink2|Yocto Recovery SD card|{{#var:RELEASE_LINK}}}}, and you want the NAND flash/eMMC installation process to be updated as well as the SD card boot itself, you need to also update the /opt/images/Yocto directory.
* You should always properly unmount your SD card before physically removing it.
}}

Revision as of 16:51, 1 March 2021

Build Linux from source code
It is recommended to build the kernel image using Yocto (see the Customizing the Linux kernel page) instead of using the direct method described in this page.
This is because some of the Yocto packages may depend on the kernel, like the WiFi module that is built from outside of the kernel source tree on some of the Yocto releases.

Toolchain installation for out of Yocto builds

To install the toolchain, follow Yocto Toolchain installation.

Build Linux out of Yocto tree

Get the Linux source code:

$ git clone https://github.com/varigit/linux-2.6-imx.git
$ cd linux-2.6-imx
$ git checkout imx-rel_imx_4.1.15_2.0.0_ga-var02

Build the Linux kernel:

$ source /opt/fslc-x11/2.2.1/environment-setup-armv7at2hf-neon-fslc-linux-gnueabi
$ make mrproper
$ make imx6ul-var-dart_defconfig
Customize the kernel configuration (optional step):
$ make menuconfig
Build everything:
$ make -j4
Build zImage only:
$ make -j4  zImage

Build modules only:
$ make -j4  modules

Build device trees only:
$ make -j4 dtbs
Build only the device tree for DART-6UL with i.MX6UL SOC, eMMC and WiFi:
$ make -j4 imx6ul-var-dart-emmc_wifi.dtb

Build only the device tree for DART-6UL with i.MX6UL SOC, eMMC and SD card:
$ make -j4 imx6ul-var-dart-sd_emmc.dtb

Build only the device tree for DART-6UL with i.MX6UL SOC, NAND flash and WiFi:
$ make -j4 imx6ul-var-dart-nand_wifi.dtb

Build only the device tree for DART-6UL with i.MX6UL SOC, NAND flash and SD card:
$ make -j4 imx6ul-var-dart-sd_nand.dtb

Build only the device tree for DART-6UL with i.MX6ULL SOC, eMMC and WiFi:
$ make -j4 imx6ull-var-dart-emmc_wifi.dtb

Build only the device tree for DART-6UL with i.MX6ULL SOC, eMMC and SD card:
$ make -j4 imx6ull-var-dart-sd_emmc.dtb

Build only the device tree for DART-6UL with i.MX6ULL SOC, NAND flash and WiFi:
$ make -j4 imx6ull-var-dart-nand_wifi.dtb

Build only the device tree for DART-6UL with i.MX6ULL SOC, NAND flash and SD card:
$ make -j4 imx6ull-var-dart-sd_nand.dtb


Notes:

If you replace the kernel image (zImage) on your system, you also need to reinstall the kernel modules, and vice versa.
If you just want to make a change in the device tree, you can compile and replace it without replacing the kernel image and modules.

Install the built kernel on an SD card

Copy the zImage and device trees to the SD card boot partition, and install the modules in the SD card rootfs partition.
Assuming the boot partition is mounted on /media/user/BOOT-VAR6UL and the rootfs partition is mounted on /media/user/rootfs:

Install the kernel image and modules:
$ cp arch/arm/boot/zImage /media/user/BOOT-VAR6UL
$ sudo make ARCH=arm modules_install INSTALL_MOD_PATH=/media/user/rootfs


Install the device trees:
$ cp arch/arm/boot/dts/imx6ul*var*.dtb /media/user/BOOT-VAR6UL


Notes:

  • If you are using our Yocto Recovery SD card, and you want the NAND flash/eMMC installation process to be updated as well as the SD card boot itself, you need to also update the /opt/images/Yocto directory.
  • You should always properly unmount your SD card before physically removing it.