View source for Linux Kernel 4.9.y

[[File:245px-Tux.svg.png|right|167x197px]]&nbsp;

=What is Linux?=
Linux is the result of merging the computational Kernel made by Linux Torval and the scheme present in any Unix operative system, Kernel was written from scratch by Linus and a loosely-knit team of hackers across the Net. It aims towards POSIX standard and Single UNIX Specification compliance.

It has all the features you would expect in a modern fully-fledged Unix, including true multitasking, virtual memory, shared libraries, demand loading, shared copy-on-write executables, proper memory management, and multistack networking including IPv4 and IPv6.

Although originally developed first for 32-bit x86-based PCs (386 or higher), today Linux also runs on a multitude of other processor architectures, in both 32- and 64-bit variants.

=<span id="Introduction" class="mw-headline">Introduction</span>=
<span style="color: #000000;">In order to build the Linux Kernel for IGEP PROCESSOR BOARDS it is recommended to cross-compile the kernel, that means to build the kernel in your HOST machine for a target architecture.</span>

To [[Ubuntu 16.04 LTS Toolchain|Ubuntu_16.04]] there are two fundamental variables that the kernel uses to select the target architecture. Normally these values are guessed based on your build environment, but of course that environment here does not match our target embedded system, so we'll need to override them. The variables in question are:

* <u>''' ARCH'''</u>''':''' The ARCH variable is the architecture you're targeting as the kernel knows it. For IGEP PROCESSOR BOARDS you'll set to "arm" architecture.

* <u>'''CROSS_COMPILE'''</u>''':''' Hopefully the CROSS_COMPILE variable is pretty self-explanatory. Set this to the prefix of your toolchain (including the trailing dash "-"). So if your toolchain is invoked as say arm-linux-gnueabihf-gcc, just chop off that trailing gcc and that's what you use: '''arm-linux-gnueabihf-'''

There is an additional variable, '''INSTALL_MOD_PATH''', which defines where the /lib directory will be created, and all the modules stored. While you don't have to transfer the kernel sources to your target device, if you build any modules, you'll want this directory.

The general process that it has to be followed in order to compile your Linux Kernel is usually the same:

# Clone the git from ISEE git with the latest stable version of the corresponding Linux Kernel.
# Select the corresponding branch inside the git repository.
# Select the correct default configuration (defconfig)
# Compile the Kernel Image, Device Tree and Modules of that configuration.

=<span id="How_to_cross_compile_the_linux_kernel" class="mw-headline">Prepare the environment<br/></span>=
{{Message/Information Message|message=The following steps has been tested using '''Ubuntu 16.04''' and the '''4.9 version''' of the '''arm-linux-'''<span class="mw-headline">'''gnueabihf''' compiler</span>}}

First we have to set up the Cross Compiler correctly if it is necessary. In this [[Set Up the Cross Compiler|post]] there are some steps that can be followed in order to do it.

<span class="mw-headline">If it is necessary we can install this extra packages that could be necessaries: </span>

 <span class="mw-headline">sudo apt-get install libc6-armel-cross libc6-armhf-cross libc6-dev-armel-cross libncurses5-dev<br><br>sudo apt-get install lzop<br></span>
<span class="mw-headline">The next step is to clone the corresponding git repository. There are different git repositories depending on the model of the processor of the board. The following table shows the steps for each of the <span style="color: #000000;">IGEP PROCESSOR BOARDS</span>:<br data-attributes="%20/"></span>

{| class="contenttable sortable" style="width: 890px;"
|-
! style="width: 97px;"|PROCESSOR
! style="width: 324.217px;"|GIT REPOSITORY
! style="width: 275.783px;"|BRANCH
|-
| style="width: 97px;"|DM3730
| style="width: 324.217px;"|https://git.isee.biz/cgit/linux-kernel/linux-omap-2.6.git/
| style="width: 275.783px;"|isee-linux-v.4.9.y
|-
| style="width: 97px;"|AM335X
| style="width: 324.217px;"|https://git.isee.biz/cgit/linux-kernel/linux-omap-2.6.git/
| style="width: 275.783px;"|isee-linux-v.4.9.y
|-
| style="width: 97px;"|iMX6
| style="width: 324.217px;"|https://git.isee.biz/cgit/linux-kernel/linux-imx.git/
| style="width: 275.783px;"|
isee-imx_4.9.11_1.0.0_ga

|}

To get to desired branch we will use:

 git checkout [your_branch]

=<span id="How_to_cross_compile_the_linux_kernel" class="mw-headline">Compile the Linux Kernel<br data-attributes="%20/"></span>=
<span style="color: #000000;">Once the development environment has been correctly set up, the following steps can be followed in order to compile the Linux Kernel using a Cross Compiler.<br data-attributes="%20/"></span>

<span style="color: #000000;">First of all, the default configuration ''(defconfig)'' has to be loaded. It can be done by writing the following command:</span>

 <span style="color: #000000;"><code class="java plain">make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- [your_defconfig]</code></span>
In the following table it can be found the name of each default configuration associated to each IGEP PROCESSORS BOARDS:

{| class="contenttable sortable" style="width: 888px;"
|-
! style="width: 160px;"|BOARD
! style="width: 163px;"|DEFCONFIG
! style="width: 527px;"|EXAMPLE
|-
| style="width: 160px;"|IGEPv5 OMAP5432
| style="width: 163px;"|[https://git.isee.biz/linux-kernel/linux-omap-2.6/blob/isee-linux-v.4.9.y/arch/arm/configs/omap2plus_defconfig omap2plus_defconfig]
| style="width: 527px;"|<span style="color: #000000;"><code class="java plain">make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- omap2plus_defconfig  <br /></code></span>
|-
| style="width: 160px;"|IGEPv2 DM3730
| style="width: 163px;"|[https://git.isee.biz/linux-kernel/linux-omap-2.6/blob/isee-linux-v.4.9.y/arch/arm/configs/omap2plus_defconfig omap2plus_defconfig]
| style="width: 527px;"|<span style="color: #000000;"><code class="java plain">make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- omap2plus_defconfig</code></span>
|-
| style="width: 160px;"|IGEP COM AQUILA AM335x
| style="width: 163px;"|[https://git.isee.biz/linux-kernel/linux-omap-2.6/blob/isee-linux-v.4.9.y/arch/arm/configs/am335x_igep0034_defconfig am335x_igep0034_defconfig]
| style="width: 527px;"|<span style="color: #000000;"><code class="java plain">make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- am335x_igep0034_defconfig</code></span>
|-
| style="width: 160px;"|IGEP COM MODULE DM3730/AM3703
| style="width: 163px;"|[https://git.isee.biz/linux-kernel/linux-omap-2.6/blob/isee-linux-v.4.9.y/arch/arm/configs/omap2plus_defconfig omap2plus_defconfig]
| style="width: 527px;"|<span style="color: #000000;"><code class="java plain">make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- omap2plus_defconfig</code></span>
|-
| style="width: 160px;"|IGEP SMARC AM335x
| style="width: 163px;"|[https://git.isee.biz/linux-kernel/linux-omap-2.6/blob/isee-linux-v.4.9.y/arch/arm/configs/am335x_igep0034_defconfig am335x_igep0034_defconfig]
| style="width: 527px;"|<span style="color: #000000;"><code class="java plain">make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- am335x_igep0034_defconfig</code></span>
|-
| style="width: 160px;"|IGEP SMARC iMX6S/DL/Q
| style="width: 163px;"|[https://git.isee.biz/linux-kernel/linux-imx/blob/isee-imx_4.9.11_1.0.0_ga/arch/arm/configs/imx6_igep0046_defconfig imx6_igep0046_defconfig]
| style="width: 527px;"|<span style="color: #000000;"><code class="java plain">make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- imx6_igep0046_defconfig</code></span>
|-
| style="width: 160px;"|IGEP SMARC iMX6UL/ULL
||[https://git.isee.biz/linux-kernel/linux-imx/blob/isee-imx_4.9.11_1.0.0_ga/arch/arm/configs/imx6_igep0146_defconfig imx6_igep0146_defconfig]
| style="width: 527px;"|<span style="color: #000000;"><code class="java plain">make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- imx6_igep0146_defconfig</code></span>
|}
Once the default configuration has been loaded, it is time to compile the Linux Kernel. There are three important elements to compile:

* '''Image: '''The kernel image. There are three several formats. Generally we will use the '''zImage''': a compressed version of the Linux kernel image that is self-extracting.
* '''DTBs: '''Device tree binary, a low level device description, specific to your device.
* '''Modules: '''Kernel Modules, pieces of code that can be loaded and unloaded into the kernel upon demand. They extend the functionality of the kernel without the need to reboot the system. 

In order to compile this three elements we have to type:

<span style="color: #000000;"><code class="java plain">make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- zImage dtbs modules</code></span>

Finally we will find the resulting compiled Kernel in the '''''arch/arm/boot''''' folder:

* zImage: located in '''arch/arm/boot/zImage'''
* DTB: located in arch/arm/boot/dts/.dtb. Depending of the board the dtb file will be different. In the following table it is detailed the corresponding dtb filename for each b''' <br />'''


{| class="contenttable sortable" style="width: 890px;"
|-
! style="width: 281.467px;"|BOARD
! style="width: 588.533px;"|DTB NAME
|-
| style="width: 281.467px;"|IGEPv2 DM3730
| style="width: 588.533px;"|[https://git.isee.biz/linux-kernel/linux-omap-2.6/blob/isee-linux-v.4.9.y/arch/arm/boot/dts/omap3-igep0020-rev-f.dts omap3-igep0020-rev-f.dts]
|-
| style="width: 281.467px;"|IGEP COM MODULE DM3730/AM3703
| style="width: 588.533px;"|[https://git.isee.biz/linux-kernel/linux-omap-2.6/blob/isee-linux-v.4.9.y/arch/arm/boot/dts/omap3-igep0030-rev-g.dts omap3-igep0030-rev-g.dts]
|-
| style="width: 281.467px;"|IGEP COM AQUILA AM335x
| style="width: 588.533px;"|[https://git.isee.biz/linux-kernel/linux-omap-2.6/blob/isee-linux-v.4.9.y/arch/arm/boot/dts/am335x-base0033.dts am335x-base0033.dts]
|-
| style="width: 281.467px;"|IGEPv5 OMAP5432
| style="width: 588.533px;"|[https://git.isee.biz/linux-kernel/linux-omap-2.6/blob/isee-linux-v.4.9.y/arch/arm/boot/dts/omap5-igep0050.dts omap5-igep0050.dts]
|-
| style="width: 281.467px;"|IGEP SMARC AM335x
| style="width: 588.533px;"|[https://git.isee.biz/linux-kernel/linux-omap-2.6/blob/isee-linux-v.4.9.y/arch/arm/boot/dts/am335x-igep-base0040.dts am335x-igep-base0040.dts]
|-
| style="width: 281.467px;"|IGEP SMARC iMX6 Quad
| style="width: 588.533px;"|[https://git.isee.biz/linux-kernel/linux-imx/blob/isee-imx_4.9.11_1.0.0_ga/arch/arm/boot/dts/imx6q-igep-base0040rd102.dts imx6q-igep-base0040rd102.dts]
|-
| style="width: 281.467px;"|IGEP SMARC iMX6 Dual Lite
| style="width: 588.533px;"|[https://git.isee.biz/linux-kernel/linux-imx/blob/isee-imx_4.9.11_1.0.0_ga/arch/arm/boot/dts/imx6dl-igep-base0040rd102.dts imx6dl-igep-base0040rd102.dts]
|-
| style="width: 281.467px;"|IGEP SMARC iMX6 Ultra Lite
||[https://git.isee.biz/linux-kernel/linux-imx/blob/isee-imx_4.9.11_1.0.0_ga/arch/arm/boot/dts/imx6ul-igep-base0040rd102.dts imx6ul-igep-base0040rd102.dts], [https://git.isee.biz/linux-kernel/linux-imx/blob/isee-imx_4.9.11_1.0.0_ga/arch/arm/boot/dts/imx6ul-igep-base0040rd102-wifi.dts imx6ul-igep-base0040rd102-wifi.dts]
|}

Once you have to compile the Kernel, you have to copy de Zimage and dtb in /media/user/boot.'''<br />'''

zImage example:

<span style="color: #000000;"><code class="java plain">cp arch/arm/boot/zimage /media/user/boot</code></span>


<span style="color: #000000;"><code class="java plain">cp arch/arm/boot/dts/omap3-igep0020-rev-f.dtb /media/user/boot</code></span>


'''Before to install the modules, you need to choose a [[IGEP Firmware set-up|rootfs]] and copy in your SDCard or Nand/MMC rootfs parition.'''


'''Finally''', the last step is to''' install the modules inside the desired rootfs'''. For example, if the rootfs is located in a external storage device mounted on the /media folder:

 sudo make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- INSTALL_MOD_PATH=/media/user/rootfs/ modules_install
==<span id="Linux_kernels" class="mw-headline">Linux kernels</span>==
To get more information about our Kernel and their compatibilities

* [[Linux Kernel 4.1.y|Linux Kernel 4.1]]
* [[Linux Kernel 3.8.y|Linux Kernel 3.8]]


[[Category:Linux]]
[[Category:Linux_Kernel]]