CM-T3517: Linux: Getting started - Revision history

Grinberg at 10:31, 9 March 2013

2013-03-09T10:31:46Z

Lifshitz: /* Boot from the MMC/SD card */

2013-01-14T15:52:45Z

‎Boot from the MMC/SD card

Show changes

Grinberg at 15:26, 18 October 2012

2012-10-18T15:26:33Z

Lifshitz: /* Preparation steps */

2012-10-17T14:01:23Z

‎Preparation steps

Grinberg: /* Installation using NFS */

2010-12-30T09:22:44Z

‎Installation using NFS

New page

== Preparation steps ==
* Obtain a PC workstation with a serial communication port.
* For networked installation you need to install a TFTP server on the host PC. For Windows machines we recommend [http://tftpd32.jounin.net/ TFTPD32] included in the [http://www.compulab.co.il/t3517/download/t3517-linux.zip Linux package for CM-T3517].
* Download the [http://www.compulab.co.il/t3517/download/t3517-linux.zip Linux package for CM-T3517] from CompuLab's website. Unzip the package to a directory on your host workstation.
* All image files mentioned below can be found in {{filename|images}} subdirectory

== Image installation ==
* Connect the host PC to the SB-T35 base-board (connector P12) via the serial cable supplied with the evaluation kit.
* Start terminal emulation software on your PC. Set baud rate to 115200 bps, 8 bit per frame, 1 stop bit, no parity, no flow control.
* Turn on the CM-T3517 evaluation system. The U-Boot boot-loader will start and you will get a command prompt.
*: {{Note|If the boot settings of your CM-T3517 are different than default, you may need to press and hold ^C while turning the CM-T3517 on, in order to get command prompt.}}

=== Installation using MMC/SD card ===
* Copy {{filename|debian-image.ubi}}, {{filename|uImage-cm-t3517}}, {{filename|kernel.img}}, {{filename|ramdisk.img}} and {{filename|bootscr.img}} from [http://www.compulab.co.il/t3517/download/t3517-linux.zip Linux package for CM-T3517] to the root directory of the MMC/SD card.
* Insert the MMC/SD card into the SD socket (P13) on SB-T35.
* Use the following U-boot commands to boot Linux on CM-T3517:
<pre>
> mmc init
> fatload mmc 0:1 80400000 bootscr.img
> source 80400000
</pre>

* After the ramdisk image is loaded, you will get Linux login prompt. Login as {{parameter|root}} into the system.
* The MMC/CD card will be mounted automatically under {{filename|/media/mmcblk0p1}}
* Format the NAND flash kernel partition and write the kernel image onto it:
<pre>
$ flash_eraseall /dev/mtd3
$ nandwrite -p /dev/mtd3 /media/mmcblk0p1/uImage-cm-t3517
</pre>
* Format the NAND flash root filesystem partition and write Debian filesystem image onto it:
<pre>
$ ubiformat -O 2048 /dev/mtd4 -f /media/mmcblk0p1/debian-image.ubi
</pre>
* Continue to [[#After Installation | After Installation]] section

=== Installation using NFS ===
* Connect the CM-T3517 Ethernet port (connector P18 on SB-T35) to your local network
* Copy {{filename|debian-image.ubi}} and {{filename|uImage-cm-t3517}} from [http://www.compulab.co.il/t3517/download/t3517-linux.zip Linux package for CM-T3517] to a directory exported through NFS.
* Make sure that Linux kernel binary image {{filename|kernel.img}}, ramdisk image {{filename|ramdisk.img}} and bootloader script image {{filename|bootscr.img}} are accessible by the TFTP server.
*: - On Windows machine: copy {{filename|kernel.img}}, {{filename|ramdisk.img}} and {{filename|bootscr.img}} to the same folder and point the TFTP server to that folder
*: - On Linux machine: copy {{filename|kernel.img}}, {{filename|ramdisk.img}} and {{filename|bootscr.img}} to TFTP server root directory, usually {{filename|/tftpboot}} or {{filename|/tftproot}}.
* You can use U-boot {{cmd|dhcp}} command to obtain IP address or manually set {{parameter|ipaddr}} environment variable:
<pre>
> setenv ipaddr <CM-T3517 ip address>
</pre>
* Set {{parameter|serverip}} environment variable and save the new environment to NAND flash:
<pre>
> setenv serverip <host ip address>
> saveenv
</pre>

* Use the following U-boot command to boot Linux on CM-T3517:
<pre>
> tftp 80400000 bootscr.img && source 80400000
</pre>
* After the ramdisk image is loaded you will get Linux login prompt. Login as {{parameter|root}} into the system.
* Obtain the IP address for CM-T3517:
** Using DHCP:<pre>$ ifup `basename /sys/devices/platform/davinci_emac/net/eth?`</pre>
** If you do not have DHCP server, you can set a static IP address using {{cmd|ifconfig}}:<pre>$ ifconfig `basename /sys/devices/platform/davinci_emac/net/eth?` <ip address></pre>
* Mount the NFS share containing {{filename|uImage-cm-t3517}} and {{filename|debian-image.ubi}} image:
<pre>
$ mount -n <host ip>:/path/to/nfs/share /mnt/net
</pre>

* Format the NAND flash kernel partition and write the kernel image onto it:
<pre>
$ flash_eraseall /dev/mtd3
$ nandwrite -p /dev/mtd3 /mnt/net/uImage-cm-t3517
</pre>
* Format the NAND flash root filesystem partition and write Debian filesystem image onto it:
<pre>
$ ubiformat /dev/mtd4 -f /mnt/net/debian-image.ubi
</pre>
* Continue to [[#After Installation | After Installation]] section

== After Installation ==
* Make sure there is no MMC/SD card in the SD socket (P13) on SB-T35.
* Reset the system.
*: {{Note|If the boot settings of your CM-T3517 are different than default, you may need to press and hold ^C while turning the CM-T3517 on, in order to get command prompt.}}
* To boot Linux, type:
<pre>> nboot 82000000 nand0 2a0000; bootm</pre>
{{Caution|The Linux kernel for CM-T3517 is shipped with built-in command line parameters that define primary console, default display settings, root device and root filesystem type. Setting U-Boot {{parameter|bootargs}} environment variable overrides default kernel command line!}}
* For Linux automatic boot, type:
<pre>
> setenv bootdelay 3
> setenv bootcmd "nboot 82000000 nand0 2a0000; bootm"
> saveenv
> boot
</pre>
{{Note|If you want to get back to U-Boot prompt, hold '''Ctrl-C''' during reset.}}
CM-T3517 will boot Debian Linux from the internal NAND flash.

== See also ==

* [[CM-T3517: Linux: Debian]]
* [[CM-T3517: Linux: Kernel]]
* [[Linux Development for ARM modules]]
* [[U-Boot for CM-T3517]]

[[Category:Linux|Getting started]]
[[Category:CM-T3517|Linux: Getting started]]

@@ Line 15: / Line 15: @@
 * Copy {{filename|uImage-cm-t3517}} from [http://compulab.co.il/products/computer-on-modules/cm-t3517/#devres Linux package for CM-T3517] to the root directory on the first partition of the MMC/SD card (FAT (16 or 32) formatted) and rename it to {{filename|uImage}}.
 * Unpack {{filename|debian-image.tar.bz2}} from [http://compulab.co.il/products/computer-on-modules/cm-t3517/#devres Linux package for CM-T3517] to the root directory on the second partition of the MMC/SD card (EXT3 formatted).<pre>tar -xvpf /path/to/image/debian-image.tar.bz2 -C /path/to/rootfs/ && sync</pre>
+* Insert the MMC/SD card into the CM-T3517 SD card slot.
-* Reset the system.
+* Reset the CM-T3517 system.
 * The boot from MMC/SD card will start automatically with default U-Boot environment.

@@ Line 3: / Line 3: @@
 * For networked installation you need to install a TFTP server on the host PC. For Windows machines we recommend [http://tftpd32.jounin.net/ TFTPD32] included in the Linux package for CM-T3517 (link below).
 * Download the Linux package for CM-T3517 from [http://compulab.co.il/products/computer-on-modules/cm-t3517/#devres CompuLab website]. Unzip the package to a directory on your host workstation.
-* If MMC/SD card is used for installation it must be prepared as described in [[CM-T3x: Linux: Booting from MMC/SD card|CM-T3x: Linux: Booting from MMC/SD card]] article.
+* If MMC/SD card is used for booting into U-Boot, it must be prepared as described in [[CM-T3x: Linux: Booting from MMC/SD card|CM-T3x: Linux: Booting from MMC/SD card]] article.
 * All image files mentioned below can be found in {{filename|images}} subdirectory

@@ Line 1: / Line 1: @@
 == Preparation steps ==
 * Obtain a PC workstation with a serial communication port.
-* For networked installation you need to install a TFTP server on the host PC. For Windows machines we recommend [http://tftpd32.jounin.net/ TFTPD32] included in the [http://www.compulab.co.il/t3517/download/t3517-linux.zip Linux package for CM-T3517].
+* For networked installation you need to install a TFTP server on the host PC. For Windows machines we recommend [http://tftpd32.jounin.net/ TFTPD32] included in the Linux package for CM-T3517 (link below).
-* Download the [http://www.compulab.co.il/t3517/download/t3517-linux.zip Linux package for CM-T3517] from CompuLab's website. Unzip the package to a directory on your host workstation.
+* Download the Linux package for CM-T3517 from [http://compulab.co.il/products/computer-on-modules/cm-t3517/#devres CompuLab website]. Unzip the package to a directory on your host workstation.
 * All image files mentioned below can be found in {{filename|images}} subdirectory
@@ Line 12: / Line 13: @@
 === Installation using MMC/SD card ===
-* Copy {{filename|debian-image.ubi}}, {{filename|uImage-cm-t3517}}, {{filename|kernel.img}}, {{filename|ramdisk.img}} and {{filename|bootscr.img}} from [http://www.compulab.co.il/t3517/download/t3517-linux.zip Linux package for CM-T3517] to the root directory of the MMC/SD card.
+* Copy {{filename|debian-image.ubi}}, {{filename|uImage-cm-t3517}}, {{filename|kernel.img}}, {{filename|ramdisk.img}} and {{filename|bootscr.img}} from [http://compulab.co.il/products/computer-on-modules/cm-t3517/#devres Linux package for CM-T3517] to the root directory of the MMC/SD card.
 * Insert the MMC/SD card into the SD socket (P13) on SB-T35.
 * Use the following U-boot commands to boot Linux on CM-T3517:
@@ Line 36: / Line 37: @@
 === Installation using NFS ===
 * Connect the CM-T3517 Ethernet port (connector P18 on SB-T35) to your local network
-* Copy {{filename|debian-image.ubi}} and {{filename|uImage-cm-t3517}} from [http://www.compulab.co.il/t3517/download/t3517-linux.zip Linux package for CM-T3517] to a directory exported through NFS.
+* Copy {{filename|debian-image.ubi}} and {{filename|uImage-cm-t3517}} from [http://compulab.co.il/products/computer-on-modules/cm-t3517/#devres Linux package for CM-T3517] to a directory exported through NFS.
 * Make sure that Linux kernel binary image {{filename|kernel.img}}, ramdisk image {{filename|ramdisk.img}} and bootloader script image {{filename|bootscr.img}} are accessible by the TFTP server.
 *: - On Windows machine: copy {{filename|kernel.img}}, {{filename|ramdisk.img}} and {{filename|bootscr.img}} to the same folder and point the TFTP server to that folder
@@ Line 70: / Line 71: @@
 * Format the NAND flash root filesystem partition and write Debian filesystem image onto it:
 <pre>
-$ ubiformat /dev/mtd4 -f /mnt/net/debian-image.ubi
+$ ubiformat -O 2048 /dev/mtd4 -f /mnt/net/debian-image.ubi
 </pre>
 * Continue to [[#After Installation | After Installation]] section