Changes

= Overview =This how to explains how to '''create a microSD card''' to boot Texas Instruments Processors (OMAP35xx, DM37xx, AM335x, OMAP5432)  with other '''software distributions (Including yocto, Ubuntu, Debian ...)'''.

<br> {{Message/Information Message|message=To update your board with =Theory==OMAP35xx, DM37xx, AM335x or OMAP5 processors can boot from a microSD. All IGEP boards use the latest version of microSD card as highest boot priority, it means that the '''pre-installed software''' you can follow processor try to boot from the article: [[Update microsd card before try to boot from other devices such the PRE-INSTALLED software image to a current release]]OneNand, Nand, SSD or eMMC.}}

OMAP35xxTherefore, DM37xx, AM335x or OMAP5 processors can boot from we are going to '''setup a microSD. All IGEP boards use the microSD card as highest boot priority, with these requirements''' and '''install a custom software distribution''' into 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 ==Prerequisites==* PC with Linux (We use for this how to boot from a microSD cardUbuntu 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).

Therefore, we are going to '''setup a microSD card with these requirements''' and '''install a custom software distribution''' into it* [[Ubuntu 16. 04 LTS Toolchain]]

<br> == Prerequisites == *PC with Linux (We use for this how to Ubuntu 12.04 LTS) *MicroSD Card (4 Gbytes - class 4) or bigger ...*Tools such, fdisk, mkfs.ext3, mkfs.vfat, gparted ... *ToolChain. <br> == ToolChain<br> == We will use the Ubuntu/Linaro Toolchain in this howto.  You can install it using synaptic package manager.  [[Image:LinaroUbuntu ToolChain.png|center|544x344px]] = Preparing the microSD card =Open a terminal window and clear your dmesg using:

You should see something like this:  

</pre> Ensure all in your microsd card it's erased:<br>  

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:

==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 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.

The next step [[Image:Gparted create msdos table partition.png|thumb|center]]Check the default option it's create the a msdos partition table partition for it you should click in the "Device" menu and then in the "Create Partition Table" option.

[[Image:Gparted create msdos table partition.png|thumb|center]]Check the default option itAfter that you can '''Apply'''s create a msdos partition table.<br>

=== Create the BOOT Partition ===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:

The Next step it's [[Image:Gparted create the partitions for it you should go to first partition.png|thumb|center]]We will configure the partition menu and select the "New" option then the application show a window like thisas:

[[Image* Primary Partition* Format:Gparted create first partition.png|thumb|center]]We will configure the partition asFAT32* Size:<br> 100 MegaBytes* Label: Boot* '''Align to: cylinder'''

*Primary Partition<br/> *FormatWe must "add" the partition and gparted shows a partitions structure like this: FAT32<br> *Size: 100 MegaBytes<br> *Label: Boot<br> *'''Align to: cylinder'''

<br> We must "add" the [[Image:Gparted configure boot partition and gparted shows a partitions structure like this: .png|thumb|center]]

[[Image:Gparted configure boot partitionIt is recommended to '''apply changes''' now or you might get an error later.png|thumb|center]]

=== Create the ROOTFS Partition ===The Next step it's create the root file system partition.

The Next step it's 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 root file system rootfs partition. as:

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* Primary Partition* Format:<br> [[ImageEXT4* Size:Gparted create first partition.png|thumb|center]] We will configure All the rootfs partition asRest* Label:Rootfs'''<br/> '''

At end we will click on "Add" button[[Image:Gparted all configured. png|thumb|center]]

=== Apply all Changes ===Click on apply button in the main menu after that gparted show a window like this for confirm all operations

Click [[Image:Gparted apply changes.png|thumb|center]]We should click on apply button in the main menu after that gparted show a window like this for confirm all operations .

[[Image:Gparted apply changesinformation.png|thumb|center]]We should click on apply button. When the process finish we can see all changes applied

[[Image:Gparted apply informationoperations complete.png|thumb|center]]When the process finish we can see all changes applied

===[[Image:Gparted partitions done.png|thumb|center]]Select "Boot flag" for the boot partition===Now we can see all partitions must select the boot flag for the first partition for it we use the right mouse button over the boot partition and configurations done in the main gparted window select "Manage Flags" option

=== [[Image:Gparted partitions doneboot flag.png|thumb|center]]Select "Boot flag" for the boot partition === Now we must select the boot flag for have the first partition microsd prepared for it we use the right mouse button over copy the boot partition and select "Manage Flags" option files

== Boot Partition Structure ==We commented in the theory point the OMAP needs only the MLO (x-loader) file for boot, we will start checking this point.

We commented in Before you follow the theory point next points you should mount the OMAP needs only the MLO (x-loader) file for microsd boot, we will start checking this pointpartition in your host pc.

Before you follow Select the next points you should mount the microsd boot partition and mount it in your host pc.

Select the boot partition and mount it in your host[[Image:Microsd partitions. png|thumb|center]]

== X-Loader (MLO) - IGEPv2 - IGEP COM Module - IGEP COM Proton<br> ==You can follow this other howto about the [[The IGEP X-loader|IGEP-X-loader]].

</pre> Alternatively you can download the binary package from [http://downloads.isee.biz/pub/releases/IGEP_xloader/igep-x-loader-2.5.0-2.tar.bz2 here]

If you're using 2.5.0.x x-loader copy directly the MLO to your boot partion or if you use older version then follow the next instructions:

Copy the x-loader.bin.ift into the boot partition.

[[Image:Copy Xloader.png|thumb|center]]

Rename the x-loader.bin.ift to MLO<br>

[[Image:Rename Xloader to MLO.png|thumb|center]]Now we're ready for test the board boot from the microsd card.

=== X-Loader Boot ===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 eject insert our microSD card into the boot and rootfs partitions from our Host PCIGEP board, this step it's a lot important due connect the Linux must sync all changes before eject serial debug cable and open the microsd card. serial terminal

We will insert our microSD card into [[Image:Putty Serial Configuration.png|thumb|center]]Power UP the IGEP board, connect the serial debug cable and open the serial terminal .

[[Image:Putty Serial ConfigurationIGEP-X-Loader Boot.png|thumb|center]]Power UP the board.

</pre> Create a new file into the boot partition named igep.ini with these content and save the file.

== MLO + uboot - IGEP COM AQUILA, IGEPv5 ==You can find more detailed information about the build procedure on this other [[U-Boot 2014.01.y|howto]]

</pre> <span style="line-height: 1.5em;">If you're using IGEPv5 board you should checkout this one:</span>  

</pre> Or if you're using IGEP COM Aquila:<br>  

make igep0033_config CROSS_COMPILE=arm-linux-gnueabi-</pre> After configuration you can build it with: <pre>make CROSS_COMPILE=&lt;set here your cross compiler&gt;</pre> After build it generate two files:

<pre>make CROSS_COMPILE=&lt;set here your cross compiler&gt;</pre>After build it generate two files: MLO and u-boot.img, you must copy both file into your boot partition.

== Kernel ==You can follow this other howto about [[The Linux kernel|how compile and install the Linux Kernel]].

You can follow this other howto about [[The Linux We will get from our git repository the kernel|how compile sources and install the Linux Kernel]]. build it:

</pre> Notes: The kernel binary resides inside the directory: $/home/jdoe/linux-omap-2.6/arch/arm/boot/'''zImage''' <br/>Notes: Alternatively you can download the kernel binary from this [http://downloads.isee.biz/pub/releases/linux_kernel/v2.6.37-7/zImage-2.6.37-7.bin link] and modules from [http://downloads.isee.biz/pub/releases/linux_kernel/v2.6.37-7/modules-2.6.37-7.tar.gz this].<br/>Notes: You can download directly all releases using this [http://downloads.isee.biz/pub/releases/linux_kernel link]<br/>

== Root File System ==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.

In this tutorial we will use the <br /> {{Message/Information Message|message=Here there are many articles about how to get '''many other [[http://downloads.isee.biz/pub/files/linaro/releases/linaro-m-headless-tar-20101108-2.tar.gz linaro headlessCategory:Software distributions|software distributions]]&nbsp;(soft floating) image as rootfs but you can use your favorite rootfs also'''. }}

<br> {{Message/Information Message|message=Here there are many articles about how to get '''many other [[:Category:Software distributions|software distributions]]'''.}}  <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.<br>

=== Create the Rootfs mount point ===Go to /media directory and create one sub-folder called "binary"

</pre> <br>

=== Mount the RootFS partition ===Mount the rootfs partition using the 'binary' directory

</pre> <br>

=== 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> <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> ===Now you should install your kernel modules inside your root file system.

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

=== Install the kernel Image<br> ===Just copy the zImage inside your boot partition, remember before that you must mount your mmc boot partition.

</pre> After that you can unmount the boot &amp; rootfs partitions.  Now we're ready for test our new microsd card<br>

= Test your Now we're ready for test our new MicroSD<br> =microsd card

(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.

[[Image:Linaro Boot1.png|thumb|center]][[Image:Linaro Boot2.png|thumb|center]]

=Related articles=*[[Boot up sequence]]*[[Update the PRE-INSTALLED software image to a current release]]*[[The Linux kernel]]