Difference between revisions of "How to boot from MicroSD Card"

From IGEP - ISEE Wiki

Jump to: navigation, search
(Kernel & Rootfs)
(u-boot.imx IGEP Boards based on NXP-Freescale Processors)
 
(62 intermediate revisions by 4 users not shown)
Line 1: Line 1:
= Introduction  =
+
=Overview=
 +
This how to explains how to '''create a microSD card''' to boot IGEP boards with  '''software distributions ( yocto, Ubuntu, Debian ...)'''.
  
This how to explains how to boot IGEPv2 or IGEP Module using a microSD card.
+
__TOC__
  
== Theory ==
+
==Theory==
 +
OMAP35xx, DM37xx, AM335x, OMAP5, iMX6 processors can boot from a microSD. All IGEP boards use the microSD card as highest boot priority, it means that the processor try to boot from the microsd card before try to boot from other devices such the OneNand, Nand, SSD or eMMC.
  
OMAP35xx or DM37xx processors can boot from a microSD. IGEPv2 or IGEP Module uses the microSD card as highest boot priority, it means that the processor try to boot from the microsd card before try to boot from other devices such the OneNand.  
+
Exist some rules to boot from a microSD card.
  
Exist some rules for boot from a microSD card.  
+
===Texas Instruments Processors===
 +
* The microsd card must be content at latest 2 partitions.
 +
* The first one must be primary partition with the boot flag mark and formated using FAT(16 or 32) file system.
 +
* All names used in this partition must be msdos names (applies to OLD OMAP35xx processor).
 +
* The processor must load a first program called '''MLO''', this program must reside in the first partition, this program it's also called '''x-loader or uboot-spl.'''
  
*The microsd card must be content at latest 2 partitions.
+
''The processor when boot ONLY load and execute the MLO program and ignore all the rest it's the X-loader(MLO) the program responsible to load the next programs such kernel or uboot if you use this last one approach.''
*The first one must be primary partition with the boot flag mark and formated using FAT file system.
 
*All names used in this partition must be msdos names, it means you cannot use a extended names.
 
*The processor must load a first program called '''MLO''', this program must reside in the first partition, this program it's also called '''x-loader.'''
 
  
''The processor ONLY load and execute the MLO program and ignore all the rest it's the X-loader(MLO) the program responsible to load the next programs such kernel or uboot if you use this last one approach.''
+
===Freescale-NXP Processors===
 +
* The microsd card must be content at latest 1 partitions.
 +
* The primary partition can be formatted with any filesystem that u-boot can mount.
 +
* The Processor will load the '''u-boot.imx''' it include the SPL and u-boot.
  
== Prerequisites  ==
+
''After load this u-boot.imx, u-boot will be ready for boot the kernel.''
  
*PC with Linux (We use for this how to Ubuntu 11.04)
+
Therefore, we are going to '''setup a microSD card with these requirements''' and '''install a custom software distribution''' into it.
*MicroSD Card (4 Gbytes - class 4)
 
*Tools such, fdisk, mkfs.ext3, mkfs.vfat, gparted ...
 
*ToolChain.
 
  
== ToolChain<br>  ==
+
==Prerequisites==
 +
* PC with Linux (We use for this how to Ubuntu 16.04 LTS)
 +
* MicroSD Card (4 Gbytes - class 4) or bigger ...
 +
* Tools such, fdisk, mkfs.ext3, mkfs.vfat, gparted ...
 +
* Cross Toolchain included in Ubuntu 16.04 LTS gcc version 4.9.3 (Ubuntu/Linaro 4.9.3-13ubuntu2).
  
We will use the Ubuntu/Linaro Toolchain in this howto.
+
==ToolChain==
 +
* Read: [[Ubuntu 16.04 LTS Toolchain]]
  
You can install it using synaptic package manager.
+
==Preparing the microSD card==
 +
Open a terminal window and clear your dmesg using:
  
[[Image:LinaroUbuntu ToolChain.png|center|544x344px]]
 
 
= Preparing the microSD card  =
 
 
Open a terminal window and clear your dmesg using:
 
 
<pre>sudo dmesg -c</pre>
 
<pre>sudo dmesg -c</pre>
 
Now insert a new microsd card in your PC and then check your dmesg:
 
Now insert a new microsd card in your PC and then check your dmesg:
 +
 
<pre>dmesg</pre>
 
<pre>dmesg</pre>
You should see something like this:  
+
You should see something like this:
 +
 
 
<pre>mmc0: new high speed SDHC card at address 0001
 
<pre>mmc0: new high speed SDHC card at address 0001
 
mmcblk0: mmc0:0001 00000 3.79 GiB
 
mmcblk0: mmc0:0001 00000 3.79 GiB
 
mmcblk0: unknown partition table
 
mmcblk0: unknown partition table
</pre>  
+
</pre>
Ensure all in your microsd card it's erased:<br>
+
Ensure all in your microsd card it's erased:
 +
 
 
<pre>$ sudo dd if=/dev/zero of=/dev/mmcblk0 bs=1024 count=1024
 
<pre>$ sudo dd if=/dev/zero of=/dev/mmcblk0 bs=1024 count=1024
 
[sudo] password for jdoe:
 
[sudo] password for jdoe:
 
1024+0 records in
 
1024+0 records in
 
1024+0 records out
 
1024+0 records out
1048576 bytes (1.0 MB) copied, 0.43556 s, 2.4 MB/s</pre>  
+
1048576 bytes (1.0 MB) copied, 0.43556 s, 2.4 MB/s</pre>
== Install GParted  ==
 
  
We will use the gparted program for create the partitions, if you don't have this program installed then you must install it with this command:  
+
==Install GParted==
<pre>sudo apt-get install gparted</pre>
+
We will use the gparted program for create the partitions, if you don't have this program installed then you must install it with this command:
== GParted and Creation of Partitions ==
 
  
When the install procedure ends you can call the program from your system tools menu or directly using a terminal console.
+
<pre>sudo apt-get install gparted</pre>
  
=== [[Image:Gparted initial.png|thumb|center]]Create the MSDOS&nbsp;Partition Table  ===
 
  
The next step it's create the msdos table partition for it you should click in the "Device" menu and then in the "Create Partition Table" option.  
+
==GParted and Creation of Partitions==
 +
When the install procedure ends you can call the program from your system tools menu or directly using a terminal console.
  
[[Image:Gparted create msdos table partition.png|thumb|center]]Check the default option it's create a msdos partition table.<br>
+
[[Image:Gparted initial.png|thumb|center]]
  
After that you can '''Apply'''.  
+
===Create the MSDOS&nbsp;Partition Table===
 +
The next step it's create the msdos table partition for it you should click in the "Device" menu and then in the "Create Partition Table" option.
  
=== Create the BOOT Partition  ===
+
[[Image:Gparted create msdos table partition.png|thumb|center]]Check the default option it's create a msdos partition table.
  
The Next step it's create the partitions for it you should go to the partition menu and select the "New" option then the application show a window like this:
+
After that you can '''Apply'''.
  
[[Image:Gparted create first partition.png|thumb|center]]We will configure the partition as:<br>
 
  
*Primary Partition<br>
 
*Format: FAT32<br>
 
*Size: 100 MegaBytes<br>
 
*Label: Boot<br>
 
*'''Align to: cylinder'''
 
  
<br> We must "add" the partition and gparted shows a partitions structure like this:
+
===Create the BOOT Partition - IGEP Texas Instruments Processor based===
 +
<u>This Step it's only for OMAP35xx, DM37xx, AM335x, OMAP5432 processor based IGEP boards.</u>
  
[[Image:Gparted configure boot partition.png|thumb|center]]
+
The Next step it's create the partitions for it you should go to the partition menu and select the "New" option then the application show a window like this:
  
It is recommended to '''apply changes''' now or you might get an error later.  
+
[[Image:Gparted create first partition.png|thumb|center]]We will configure the partition as:
  
=== Create the ROOTFS Partition ===
+
* Primary Partition
 +
* Format: FAT32
 +
* Size: 100 MegaBytes
 +
* Free Space Preceding: 0 MiB
 +
* Label: Boot
 +
* '''Align to: cylinder'''
  
The Next step it's create the root file system partition.  
+
It is recommended to '''apply changes''' now or you might get an error later.
  
First you should select the unallocated partition area and then&nbsp; you should go to the partition menu and select the "New" option then the application show a window like this:<br> [[Image:Gparted create first partition.png|thumb|center]] We will configure the rootfs partition as:<br>  
+
===Create the BOOT Partition - IGEP NXP-Freescale Processor based===
 +
<u>This Step it's only for iMX6 processor based IGEP boards.</u>
  
*Primary Partition<br>
+
The Next step it's create the partitions for it you should go to the partition menu and select the "New" option then the application show a window like this:
*Format: EXT4<br>
 
*Size: All the Rest<br>
 
*Label: Rootfs'''<br>'''
 
  
At end we will click on "Add" button.  
+
[[File:imx6-primary-part.png|thumb|center]]
  
[[Image:Gparted all configured.png|thumb|center]]
+
We will configure the partition as:
  
=== Apply all Changes  ===
+
* Primary Partition
 +
* Format: FAT32
 +
* Free Space Preceding: 8 MiB
 +
* Size: 100 MegaBytes
 +
* Label: Boot
 +
* '''Align to: cylinder'''
  
Click on apply button in the main menu after that gparted show a window like this for confirm all operations
 
  
[[Image:Gparted apply changes.png|thumb|center]]We should click on apply button.  
+
It is recommended to '''apply changes''' now or you might get an error later.
  
[[Image:Gparted apply information.png|thumb|center]]When the process finish we can see all changes applied
+
===Create the ROOTFS Partition===
 +
The Next step it's create the root file system partition.
  
[[Image:Gparted operations complete.png|thumb|center]]  
+
First you should select the unallocated partition area and then&nbsp; you should go to the partition menu and select the "New" option then the application show a window like this:<br /> [[Image:Gparted create first partition.png|thumb|center]] We will configure the rootfs partition as:
  
Now we can see all partitions and configurations done in the main gparted window
+
* Primary Partition
 +
* Format: EXT4
 +
* Size: All the Rest
 +
* Label: Rootfs'''<br />'''
  
=== [[Image:Gparted partitions done.png|thumb|center]]Select "Boot flag" for the boot partition  ===
+
At end we will click on "Add" button.
  
Now we must select the boot flag for the first partition for it we use the right mouse button over the boot partition and select "Manage Flags" option
+
[[Image:Gparted all configured.png|thumb|center]]
  
[[Image:Gparted boot flag.png|thumb|center]]Now we have the microsd prepared for copy the boot files
+
or
  
= Boot Partition Structure  =
+
[[File:imx6_str.png|thumb|center]]
  
We commented in the theory point the OMAP needs only the MLO (x-loader) file for boot, we will start checking this point.
+
After all apply all changes
  
Before you follow the next points you should mount the microsd boot partition in your host pc.
+
===Select "Boot flag" for the boot partition===
 +
Now we must select the boot flag for the first partition for it we use the right mouse button over the boot partition and select "Manage Flags" option
  
Select the boot partition and mount it in your host.
+
[[Image:Gparted boot flag.png|thumb|center]]Now we have the microsd prepared for copy the boot files
 
 
[[Image:Microsd partitions.png|thumb|center]]  
 
  
<br>
+
==MLO + u-boot IGEP Boards Texas Instruments based boards==
 +
After build or download the MLO and u-boot you should follow the next steps:
  
== X-Loader (MLO)<br>  ==
+
* Copy MLO and u-boot.img to primary boot partition
  
You can follow this other howto about the [[The IGEP X-loader|IGEP-X-loader]].
+
$ cp MLO u-boot.img /media/user/boot
<pre>We will compile the sources from our git repository:
+
You can follow this [[U-Boot Texas Instruments Series|HowTo]] if you want build the MLO and u-boot
  
$/home/jdoe&gt; git clone git://git.isee.biz/pub/scm/igep-x-loader.git
+
==u-boot.imx IGEP Boards based on NXP-Freescale Processors==
 +
* Copy u-boot.imx using dd before primary partition in raw mode as
  
$/home/jdoe&gt; cd igep-x-loader
+
sudo dd if=/home/user/u-boot-imx/u-boot.imx of=/dev/sde bs=512 seek=2
 +
Where /dev/sde is your microsd card
  
$/home/jdoe/igep-x-loader&gt; make igep00x0_config
+
You can follow this [[U-boot Freescale-NXP iMX6 Series|HowTo ]]if you want build the u-boot.imx
  
$/home/jdoe/igep-x-loader&gt; make
+
==Kernel==
 +
You can follow this other howto about [[The Linux kernel|how compile and install the Linux Kernel]].
  
$/home/jdoe/igep-x-loader&gt; contrib/signGP
+
==Root File System==
</pre>
+
In this tutorial we will use the [http://downloads.isee.biz/pub/files/linaro/releases/linaro-m-headless-tar-20101108-2.tar.gz linaro headless]&nbsp;(soft floating) image as rootfs but you can use your favorite rootfs also.
Copy the x-loader.bin.ift into the boot partition.  
 
  
[[Image:Copy Xloader.png|thumb|center]]  
+
<br /> {{Message/Information Message|message=Here there are many articles about how to get '''many other [[:Category:Software distributions|software distributions]]'''.}}
  
Rename the x-loader.bin.ift to MLO<br>
+
<br /> Here you've the [http://downloads.isee.biz/pub/files/linaro/releases/linaro-11.09-nano-n-tar-20110929-0.tar.gz linaro nano 11.09]&nbsp;(soft floating) available for download from the ISEE server.
  
[[Image:Rename Xloader to MLO.png|thumb|center]]Now we're ready for test the board boot from the microsd card.  
+
Notes: You must build your programs with the hard floating if your rootfs is build with it.
  
=== X-Loader Boot  ===
+
Notes: IGEPv5 must use Hard floating Rootfs
  
We will eject the boot and rootfs partitions from our Host PC, this step it's a lot important due the Linux must sync all changes before eject the microsd card.
 
  
We will insert our microSD card into the IGEP board, connect the serial debug cable and open the serial terminal
 
  
[[Image:Putty Serial Configuration.png|thumb|center]]Power UP the board.
+
===Create the Rootfs mount point===
 +
Go to /media directory and create one sub-folder called "binary"
  
[[Image:IGEP-X-Loader Boot.png|thumb|center]]
 
 
=== Configure the IGEP-X-Loader  ===
 
 
You can use a file like this:
 
<pre>[kernel]
 
; Kernel load address, NOT&nbsp;Modify
 
kaddress=0x80008000
 
; RAM disk load Address, NOT Modify
 
;rdaddress=0x84000000
 
; Board Serial ID
 
serial.low=00000001
 
serial.high=00000000
 
; Board Revision
 
revision=0003
 
; Kernel Image Name
 
kImageName=zImage
 
; Kernel RAM Disk Image Name
 
;kRdImageName=initrd.img-2.6.35-1010-linaro-omap
 
MachineID=xxxx Where Machine ID =&nbsp;2344 for IGEPv2 and ID = 2717 for IGEP Module
 
 
[kparams]
 
;buddy=igep0022
 
;buddy=base0010
 
; Setup the Kernel console params
 
console=ttyS2,115200n8
 
; Enable early printk
 
;earlyprintk=serial,ttyS2,115200
 
; Setup the Board Memory Configuration
 
mem=430M
 
;mem=512M
 
; Setup the Boot Delay
 
boot_delay=0
 
; Setup the ARM Processor Speed
 
;mpurate=800
 
; Setup the loglevel
 
;loglevel=7
 
; Enable Kernel Debug Output
 
;debug=1
 
; Fix RTC Variable
 
;fixrtc=1
 
; Configure nocompcache variable
 
nocompcache=1
 
; Configure Frame Buffer Configuration
 
;omapfb.mode=dvi:1280x720MR-16@60
 
omapfb.mode=dvi:hd720-16@60
 
; Configure Video Ram assigned
 
vram=40M
 
; Configure Video RAM assigned to every frame buffer
 
omapfb.vram=0:12M,1:16M,2:12M
 
; Configure frame buffer debug output
 
;omapfb.debug=1
 
; Configure DSS Video Debug option
 
;omapdss.debug=1
 
; Configure the Board Ethernet Mac Address
 
smsc911x.mac=0xb2,0xb0,0x14,0xb5,0xcd,0xde
 
;  --- Configure UBI FS boot ---
 
;ubi.mtd=2
 
;root=ubi0:igep0020-rootfs
 
;rootfstype=ubifs
 
;  --- Configure NFS boot ---
 
;ip=192.168.2.123:192.168.2.129:192.168.2.1:255.255.255.0::eth0:
 
;root=/dev/nfs
 
;nfsroot=192.168.2.129:/srv/nfs/igep_rootfs
 
;  --- Configure MMC boot ---
 
root=/dev/mmcblk0p2 rw rootwait
 
; Assign Init program
 
;init=/bin/bash
 
 
</pre>
 
Create a new file into the boot partition named igep.ini with these content and save the file.
 
 
== Kernel &amp; Rootfs  ==
 
 
You can follow this other howto about [[The Linux kernel|how compile and install the Linux Kernel]].
 
 
In our case we build the kernel sources from zero:<br>
 
<pre>a) Clone the Kernel git repository
 
 
$/home/jdoe/&gt; git clone git://git.igep.es/pub/scm/linux-omap-2.6.git
 
 
$/home/jdoe&gt; cd linux-omap-2.6
 
 
b) Checkout your desired branch (we used for this howto 2.6.37.y)
 
 
$/home/jdoe/linux-omap-2.6&gt; git checkout origin/linux-2.6.37.y -b linux-2-6-37.y
 
 
c) Configure the kernel
 
 
$/home/jdoe/linux-omap-2.6&gt; make ARCH=arm CROSS_COMPILE=arm-linux-gnueabi- igep00x0_defconfig
 
 
d) Build the kernel and Modules
 
 
$/home/jdoe/linux-omap-2.6&gt; make ARCH=arm CROSS_COMPILE=arm-linux-gnueabi- zImage modules
 
</pre>
 
Notes: The kernel binary resides inside the directory: $/home/jdoe/linux-omap-2.6/arch/arm/boot/'''zImage'''
 
 
 
{{Message/Broken Links}}
 
 
 
We will use the [http://downloads.isee.biz/pub/files/linaro/releases/linaro-m-headless-tar-20101108-2.tar.gz linaro headless] image as rootfs but you can use your favorite rootfs also.
 
 
Here you've the [http://downloads.igep.es/pub/files/linaro/releases/linaro-11.09-nano-n-tar-20110929-0.tar.gz linaro nano 11.09] available for download from our server.
 
 
=== Create the Rootfs mount point  ===
 
 
Go to /media directory and create one sub-folder called "binary"
 
 
<pre>$ cd /media
 
<pre>$ cd /media
  
 
$ sudo mkdir binary
 
$ sudo mkdir binary
</pre>  
+
</pre>
=== Mount the RootFS partition ===
+
 
 +
===Mount the RootFS partition===
 +
Mount the rootfs partition using the 'binary' directory
  
Mount the rootfs partition using the 'binary' directory
 
 
<pre>$ media &gt; sudo mount /dev/mmcblkp2 /media/binary
 
<pre>$ media &gt; sudo mount /dev/mmcblkp2 /media/binary
</pre>  
+
</pre>
=== Untar the rootfs package ===
+
 
 +
===Untar the rootfs package===
 +
Copy "linaro-m-headless-tar-20101108-2.tar.gz" file inside the /media directory and untar the file
  
Copy "linaro-m-headless-tar-20101108-2.tar.gz" file inside the /media directory and untar the file
+
<pre>$ media &gt; sudo tar xvfz linaro-m-headless-tar-20101108-2.tar.gz</pre>
<pre>$ media &gt; sudo tar xvfz linaro-m-headless-tar-20101108-2.tar.gz</pre>  
+
<br /> Now you should see inside your rootfs partition a similar structure like this.
<br> Now you should see inside your rootfs partition a similar structure like this.<br>
 
  
=== [[Image:Linaro RootFS.png|thumb|center]]Install the kernel modules<br>  ===
+
===[[Image:Linaro RootFS.png|thumb|center]]Install the kernel modules===
 +
Now you should install your kernel modules inside your root file system.
  
Now you should install your kernel modules inside your root file system.<br>
 
 
<pre>$ media &gt; cd /home/jdoe/linux-omap-2.6
 
<pre>$ media &gt; cd /home/jdoe/linux-omap-2.6
  
 
$ /home/jdoe/linux-omap-2.6&gt; sudo make ARCH=arm CROSS_COMPILE=arm-linux-gnueabi- modules_install INSTALL_MOD_PATH=/media/binary
 
$ /home/jdoe/linux-omap-2.6&gt; sudo make ARCH=arm CROSS_COMPILE=arm-linux-gnueabi- modules_install INSTALL_MOD_PATH=/media/binary
 +
</pre>
 +
Alternatively if you downloaded the binary package uncompress it inside the directory /media/binary
  
</pre>
+
===Install the kernel Image===
=== Install the kernel Image<br>  ===
+
Just copy the zImage inside your boot partition, remember before that you must mount your mmc boot partition.
  
Just copy the zImage inside your boot partition, remember before that you must mount your mmc boot partition.<br>
 
 
<pre>$ /home/jdoe/linux-omap-2.6&gt; sudo cp arch/arm/boot/zImage /media/boot/
 
<pre>$ /home/jdoe/linux-omap-2.6&gt; sudo cp arch/arm/boot/zImage /media/boot/
</pre>
+
if you're using dtb kernel as 3.8.y you must copy the dtb too.
After that you can unmount the boot &amp; rootfs partitions.  
+
$ /home/jdoe/linuz-omap-2.6&gt; sudo cp arch/arm/boot/dtbs/omap5-igep0050.dtb /media/boot
  
Now we're ready for test our new microsd card<br>
+
</pre>
 +
After that you can unmount the boot &amp; rootfs partitions.
  
= Test your new MicroSD<br>  =
+
Now we're ready for test our new microsd card
  
 +
=Test your new MicroSD=
 
You can test your new microSD card with a Serial client such as PuTTy. [[Using serial debug port to communicate|Here]] is an explanation about how to configure it.
 
You can test your new microSD card with a Serial client such as PuTTy. [[Using serial debug port to communicate|Here]] is an explanation about how to configure it.
  
(Note that speed should be configured to 115200 bauds).  
+
(Note that speed should be configured to 115200 bauds).
 +
 
 +
If you already have configured it or you are using another Serial client and you have connected the Serial cable to the IGEPv2 board, then you are ready to test your microSD.
 +
 
 +
Insert the microSD in your IGEPv2 board and power up the board.
  
If you already have configured it or you are using another Serial client and you have connected the Serial cable to the IGEPv2 board, then you are ready to test your microSD.  
+
[[Image:Linaro Boot1.png|thumb|center]][[Image:Linaro Boot2.png|thumb|center]]
  
Insert the microSD in your IGEPv2 board and power up the board.
 
  
[[Image:Linaro Boot1.png|thumb|center]][[Image:Linaro Boot2.png|thumb|center]]
 
  
= Related articles =
+
=Related articles=
 +
* [[Boot up sequence]]
 +
* [[Update the PRE-INSTALLED software image to a current release]]
 +
* [[The Linux kernel]]
  
*[[Boot up sequence]]
+
{{Message/Forum}}
  
 
[[Category:Boot loaders]]
 
[[Category:Boot loaders]]
[[Category:Tutorials]]
 
 
[[Category:Software]]
 
[[Category:Software]]
 +
[[Category:Software distributions]]

Latest revision as of 11:46, 9 March 2018

Overview

This how to explains how to create a microSD card to boot IGEP boards with  software distributions ( yocto, Ubuntu, Debian ...).

Theory

OMAP35xx, DM37xx, AM335x, OMAP5, iMX6 processors can boot from a microSD. All IGEP boards use the microSD card as highest boot priority, it means that the processor try to boot from the microsd card before try to boot from other devices such the OneNand, Nand, SSD or eMMC.

Exist some rules to boot from a microSD card.

Texas Instruments Processors

  • The microsd card must be content at latest 2 partitions.
  • The first one must be primary partition with the boot flag mark and formated using FAT(16 or 32) file system.
  • All names used in this partition must be msdos names (applies to OLD OMAP35xx processor).
  • The processor must load a first program called MLO, this program must reside in the first partition, this program it's also called x-loader or uboot-spl.

The processor when boot ONLY load and execute the MLO program and ignore all the rest it's the X-loader(MLO) the program responsible to load the next programs such kernel or uboot if you use this last one approach.

Freescale-NXP Processors

  • The microsd card must be content at latest 1 partitions.
  • The primary partition can be formatted with any filesystem that u-boot can mount.
  • The Processor will load the u-boot.imx it include the SPL and u-boot.

After load this u-boot.imx, u-boot will be ready for boot the kernel.

Therefore, we are going to setup a microSD card with these requirements and install a custom software distribution into it.

Prerequisites

  • PC with Linux (We use for this how to Ubuntu 16.04 LTS)
  • MicroSD Card (4 Gbytes - class 4) or bigger ...
  • Tools such, fdisk, mkfs.ext3, mkfs.vfat, gparted ...
  • Cross Toolchain included in Ubuntu 16.04 LTS gcc version 4.9.3 (Ubuntu/Linaro 4.9.3-13ubuntu2).

ToolChain

Preparing the microSD card

Open a terminal window and clear your dmesg using:

sudo dmesg -c

Now insert a new microsd card in your PC and then check your dmesg:

dmesg

You should see something like this:

mmc0: new high speed SDHC card at address 0001
mmcblk0: mmc0:0001 00000 3.79 GiB
mmcblk0: unknown partition table

Ensure all in your microsd card it's erased:

$ sudo dd if=/dev/zero of=/dev/mmcblk0 bs=1024 count=1024
[sudo] password for jdoe:
1024+0 records in
1024+0 records out
1048576 bytes (1.0 MB) copied, 0.43556 s, 2.4 MB/s

Install GParted

We will use the gparted program for create the partitions, if you don't have this program installed then you must install it with this command:

sudo apt-get install gparted


GParted and Creation of Partitions

When the install procedure ends you can call the program from your system tools menu or directly using a terminal console.

Gparted initial.png

Create the MSDOS Partition Table

The next step it's create the msdos table partition for it you should click in the "Device" menu and then in the "Create Partition Table" option.

Gparted create msdos table partition.png
Check the default option it's create a msdos partition table.

After that you can Apply.


Create the BOOT Partition - IGEP Texas Instruments Processor based

This Step it's only for OMAP35xx, DM37xx, AM335x, OMAP5432 processor based IGEP boards.

The Next step it's create the partitions for it you should go to the partition menu and select the "New" option then the application show a window like this:

Gparted create first partition.png
We will configure the partition as:
  • Primary Partition
  • Format: FAT32
  • Size: 100 MegaBytes
  • Free Space Preceding: 0 MiB
  • Label: Boot
  • Align to: cylinder

It is recommended to apply changes now or you might get an error later.

Create the BOOT Partition - IGEP NXP-Freescale Processor based

This Step it's only for iMX6 processor based IGEP boards.

The Next step it's create the partitions for it you should go to the partition menu and select the "New" option then the application show a window like this:

imx6-primary-part.png

We will configure the partition as:

  • Primary Partition
  • Format: FAT32
  • Free Space Preceding: 8 MiB
  • Size: 100 MegaBytes
  • Label: Boot
  • Align to: cylinder


It is recommended to apply changes now or you might get an error later.

Create the ROOTFS Partition

The Next step it's create the root file system partition.

First you should select the unallocated partition area and then  you should go to the partition menu and select the "New" option then the application show a window like this:
Gparted create first partition.png
We will configure the rootfs partition as:
  • Primary Partition
  • Format: EXT4
  • Size: All the Rest
  • Label: Rootfs

At end we will click on "Add" button.

Gparted all configured.png

or

imx6 str.png

After all apply all changes

Select "Boot flag" for the boot partition

Now we must select the boot flag for the first partition for it we use the right mouse button over the boot partition and select "Manage Flags" option

Gparted boot flag.png
Now we have the microsd prepared for copy the boot files

MLO + u-boot IGEP Boards Texas Instruments based boards

After build or download the MLO and u-boot you should follow the next steps:

  • Copy MLO and u-boot.img to primary boot partition
$ cp MLO u-boot.img /media/user/boot

You can follow this HowTo if you want build the MLO and u-boot

u-boot.imx IGEP Boards based on NXP-Freescale Processors

  • Copy u-boot.imx using dd before primary partition in raw mode as
sudo dd if=/home/user/u-boot-imx/u-boot.imx of=/dev/sde bs=512 seek=2

Where /dev/sde is your microsd card

You can follow this HowTo if you want build the u-boot.imx

Kernel

You can follow this other howto about how compile and install the Linux Kernel.

Root File System

In this tutorial we will use the linaro headless (soft floating) image as rootfs but you can use your favorite rootfs also.


Information.jpg Here there are many articles about how to get many other software distributions.


Here you've the linaro nano 11.09 (soft floating) available for download from the ISEE server.

Notes: You must build your programs with the hard floating if your rootfs is build with it.

Notes: IGEPv5 must use Hard floating Rootfs


Create the Rootfs mount point

Go to /media directory and create one sub-folder called "binary"

$ cd /media

$ sudo mkdir binary

Mount the RootFS partition

Mount the rootfs partition using the 'binary' directory

$ media > sudo mount /dev/mmcblkp2 /media/binary

Untar the rootfs package

Copy "linaro-m-headless-tar-20101108-2.tar.gz" file inside the /media directory and untar the file

$ media > sudo tar xvfz linaro-m-headless-tar-20101108-2.tar.gz


Now you should see inside your rootfs partition a similar structure like this.

Linaro RootFS.png
Install the kernel modules

Now you should install your kernel modules inside your root file system.

$ media > cd /home/jdoe/linux-omap-2.6

$ /home/jdoe/linux-omap-2.6> sudo make ARCH=arm CROSS_COMPILE=arm-linux-gnueabi- modules_install INSTALL_MOD_PATH=/media/binary

Alternatively if you downloaded the binary package uncompress it inside the directory /media/binary

Install the kernel Image

Just copy the zImage inside your boot partition, remember before that you must mount your mmc boot partition.

$ /home/jdoe/linux-omap-2.6> sudo cp arch/arm/boot/zImage /media/boot/
if you're using dtb kernel as 3.8.y you must copy the dtb too.
$ /home/jdoe/linuz-omap-2.6> sudo cp arch/arm/boot/dtbs/omap5-igep0050.dtb /media/boot

After that you can unmount the boot & rootfs partitions.

Now we're ready for test our new microsd card

Test your new MicroSD

You can test your new microSD card with a Serial client such as PuTTy. Here is an explanation about how to configure it.

(Note that speed should be configured to 115200 bauds).

If you already have configured it or you are using another Serial client and you have connected the Serial cable to the IGEPv2 board, then you are ready to test your microSD.

Insert the microSD in your IGEPv2 board and power up the board.

Linaro Boot1.png
Linaro Boot2.png


Related articles

Igep forum.png If you have any question, don't ask to ask at the IGEP Community Forum or the IGEP Community Chat Irc.png