CM-X300: Linux: Getting started - Revision history

Grinberg: /* After Installation */

2014-05-05T10:58:48Z

‎After Installation

Grinberg: /* After Installation */

2014-05-05T10:54:33Z

‎After Installation

Grinberg: /* See also */

2013-09-29T13:53:49Z

‎See also

Mike: Getting started with Linux on CM-X300 moved to CM-X300: Linux: Getting started

2009-12-23T08:02:16Z

Getting started with Linux on CM-X300 moved to CM-X300: Linux: Getting started

New page

== Preparation steps ==
{{Note|It is possible to install Linux on CM-X300 using either an NFS share or a USB flash drive. The first method is preferred because NFS setup will ease further Linux evaluation and development.}}
* Obtain a PC workstation with serial communication port.
* For installation using NFS install TFTP server on host PC. For Windows machines we recommend [http://tftpd32.jounin.net/ TFTPD32] included in this distribution package.
* Download the [http://www.compulab.co.il/x300/download/x300-linux.zip Linux distribution package for CM-X300] 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
* Copy {{filename|debian-image.ubi}} and {{filename|cm-x300-kernel.jffs2}} from [http://www.compulab.co.il/x300/download/x300-linux.zip Linux distribution package for CM-X300] either to a directory exported through NFS or to a USB flash drive.

== Image installation ==
* Connect the host PC to the CM-X300 via a null modem cable supplied with the Eval Kit.
* Start terminal emulation software on your PC using the COM port to which the null modem is connected. Set baud rate to 38400 bps, 8 bit per frame, 1 stop bit, no parity, no flow control.
* Turn on the CM-X300. The U-Boot will start and you will get a command prompt.
*: {{Note|If the boot settings of your CM-X300 are different than default, you may need to press and hold ^C while turning the CM-X300 on, in order to get command prompt.}}

=== Installation using NFS ===
* Connect CM-X300's ETH0 port to your local Ethernet
* Make sure that Linux kernel binary image {{filename|kernel.img}}, ramdisk image {{filename|ramdisk.img}} and bootloader script image {{filename|first_boot.img}} are accessible by the TFTP server.
*: - On Windows machine: copy {{filename|kernel.img}}, {{filename|ramdisk.img}} and {{filename|first_boot.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|first_boot.img}} to TFTP sevrver 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-X300 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-X300:
<pre>
> tftp 80400000 first_boot.img && autoscr 80400000
</pre>
* During boot the CM-X300 tries to obtain an IP address using DHCP. If you do not have DHCP server you can set the CM-X300 IP address statically using {{cmd|ifconfig}}:
<pre>
$ ifconfig eth0 <ip address>
</pre>
* After the ramdisk image is loaded you will get Linux login prompt. Login as {{parameter|root}} into the system.
* Mount the NFS share containing {{filename|cm-x300-kernel.jffs2}} and {{filename|debian-image.ubi}} image:
<pre>
$ mount <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/mtd4
$ nandwrite /dev/mtd4 /mnt/net/cm-x300-kernel.jffs2
</pre>
* Format the NAND flash root filesystem partition and write Debian filesystem image onto it:
<pre>
$ ubiformat /dev/mtd5 -f /mnt/net/debian-image.ubi
</pre>

=== Installation using USB flash drive ===
* Make sure that CM-X300's ETH0 port is '''disconnected'''
* Make sure that Linux kernel binary image {{filename|kernel.img}}, ramdisk image {{filename|ramdisk.img}}, kernel JFFS2 image {{filename|cm-x300-kernel.jffs2}}, Debian filesystem JFFS2 image {{filename|debian-image.ubi}} and bootloader script image {{filename|first_boot.img}} are present at the root directory of the USB flash drive.
* Connect USB flash drive to CM-X300. Use USB2 (host/slave) port.
* Use the following U-boot command to boot Linux on CM-X300:
<pre>
> usb start
> fatload usb 0:1 80400000 first_boot.img
> autoscr 80400000
</pre>
* After the ramdisk image is loaded you will get Linux login prompt. Login as {{parameter|root}} into the system.
* The USB flash drive will be automatically mounted under {{filename|/media/sda1}}
* Format the NAND flash kernel partition and write the kernel image onto it:
<pre>
$ flash_eraseall /dev/mtd4
$ nandwrite /dev/mtd4 /media/sda1/cm-x300-kernel.jffs2
</pre>
* Format the NAND flash root filesystem partition and write Debian filesystem image onto it:
<pre>
$ ubiformat /dev/mtd5 -f /media/sda1/debian-image.ubi
</pre>

== After Installation ==

<ol>
<li> Reset the CM-X300.</li>
{{Note|If the boot settings of your CM-X300 are different than default, you may need to press and hold ^C while turning the CM-X300 on, in order to get command prompt.}}
<li> To start Linux type:
<pre>> fsload; bootm</pre>
</li>
<li> If you want Linux to start automatically, type:
<pre>
> setenv bootdelay <delay in seconds>
> setenv bootcmd "fsload; bootm"
> saveenv
> boot
</pre>
</li>
</ol>

If you want to get back to U-Boot prompt, hold '''Ctrl-C''' during reset.

=== Connection and Logging In ===

Use the following usernames and passwords to login:

Account with administrative privileges:
<pre>
User: root
Password: 111111
</pre>
Regular user account:
<pre>
User: user
Password: 111111
</pre>
In addition to these accounts CM-X300 allows anonymous FTP access.

== See also ==

* [[Linux Development for XScale modules]]
* [[Linux Kernel for CM-X300]]
* [[Debian Linux for CM-X300]]
* [[U-Boot for CM-X300]]

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

@@ Line 84: / Line 84: @@
 </li>
 <li> To start Linux type:
-<pre>> fsload; bootm</pre>
+<pre>> fsload && bootm</pre>
 </li>
 <li> If you want Linux to start automatically, type:

@@ Line 77: / Line 77: @@
 <li> Reset the CM-X300.</li>
 {{Note|If the boot settings of your CM-X300 are different than default, you may need to press and hold ^C while turning the CM-X300 on, in order to get command prompt.}}
-<li> To start Linux type:
+<li>
 <pre>> fsload; bootm</pre>
 </li>
 <li> If you want Linux to start automatically, type:
 <pre>
 > setenv bootdelay <delay in seconds>
-> setenv bootcmd "fsload; bootm"
+> setenv bootcmd "fsload && bootm"
 > saveenv
 > boot

@@ Line 2: / Line 2: @@
 {{Note|It is possible to install Linux on CM-X300 using either an NFS share or a USB flash drive. The first method is preferred because NFS setup will ease further Linux evaluation and development.}}
 * Obtain a PC workstation with serial communication port.
-* For installation using NFS install TFTP server on host PC. For Windows machines we recommend [http://tftpd32.jounin.net/ TFTPD32] included in this distribution package.
+* For installation using NFS install TFTP server on host PC. For Windows machines we recommend [http://tftpd32.jounin.net/ TFTPD32] included in the [http://compulab.co.il/products/computer-on-modules/cm-x300/#devres Linux package for CM-X300].
-* Download the [http://www.compulab.co.il/x300/download/x300-linux.zip Linux distribution package for CM-X300] from CompuLab's website . Unzip the package to a directory on your host workstation.
+* Download the [http://compulab.co.il/products/computer-on-modules/cm-x300/#devres Linux package for CM-X300] 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
-* Copy {{filename|debian-image.ubi}} and {{filename|cm-x300-kernel.jffs2}} from [http://www.compulab.co.il/x300/download/x300-linux.zip Linux distribution package for CM-X300] either to a directory exported through NFS or to a USB flash drive.
+* Copy {{filename|debian-image.ubi}} and {{filename|cm-x300-kernel.jffs2}} from [http://compulab.co.il/products/computer-on-modules/cm-x300/#devres Linux package for CM-X300] either to a directory exported through NFS or to a USB flash drive.
 == Image installation ==
@@ Line 15: / Line 15: @@
 === Installation using NFS ===
 * Connect CM-X300's ETH0 port to your local Ethernet
-* Make sure that Linux kernel binary image {{filename|kernel.img}}, ramdisk image {{filename|ramdisk.img}} and bootloader script image {{filename|first_boot.img}} are accessible by the TFTP server.
+* 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|first_boot.img}} to the same folder and point the TFTP server to that folder
+*: - 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|first_boot.img}} to TFTP sevrver root directory, usually {{filename|/tftpboot}} or {{filename|/tftproot}}.
+*: - On Linux machine: copy {{filename|kernel.img}}, {{filename|ramdisk.img}} and {{filename|bootscr.img}} to TFTP sevrver 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>
@@ Line 30: / Line 30: @@
 * Use the following U-boot command to boot Linux on CM-X300:
 <pre>
-> tftp 80400000 first_boot.img && autoscr 80400000
+> tftp 80400000 bootscr.img && autoscr 80400000
 </pre>
 * After the ramdisk image is loaded you will get Linux login prompt. Login as {{parameter|root}} into the system.
 * Mount the NFS share containing {{filename|cm-x300-kernel.jffs2}} and {{filename|debian-image.ubi}} image:
 <pre>
-$ mount <host ip>:/path/to/nfs/share /mnt/net
+$  mount -o nolock <host ip>:/path/to/nfs/share /mnt/net
 </pre>
 * Format the NAND flash kernel partition and write the kernel image onto it:
@@ Line 48: / Line 47: @@
 * Format the NAND flash root filesystem partition and write Debian filesystem image onto it:
 <pre>
-$ ubiformat /dev/mtd5 -f /mnt/net/debian-image.ubi
+$ ubiformat -O 2048 /dev/mtd5 -f /mnt/net/debian-image.ubi
 </pre>
 === Installation using USB flash drive ===
 * Make sure that CM-X300's ETH0 port is '''disconnected'''
-* Make sure that Linux kernel binary image {{filename|kernel.img}}, ramdisk image {{filename|ramdisk.img}}, kernel JFFS2 image {{filename|cm-x300-kernel.jffs2}}, Debian filesystem JFFS2 image {{filename|debian-image.ubi}} and bootloader script image {{filename|first_boot.img}} are present at the root directory of the USB flash drive.
+* Make sure that Linux kernel binary image {{filename|kernel.img}}, ramdisk image {{filename|ramdisk.img}}, kernel JFFS2 image {{filename|cm-x300-kernel.jffs2}}, Debian filesystem JFFS2 image {{filename|debian-image.ubi}} and bootloader script image {{filename|bootscr.img}} are present at the root directory of the USB flash drive.
 * Connect USB flash drive to CM-X300. Use USB2 (host/slave) port.
 * Use the following U-boot command to boot Linux on CM-X300:
 <pre>
 > usb start
-> fatload usb 0:1 80400000 first_boot.img
+> fatload usb 0:1 80400000 bootscr.img
 > autoscr 80400000
 </pre>
@@ Line 70: / Line 69: @@
 * Format the NAND flash root filesystem partition and write Debian filesystem image onto it:
 <pre>
-$ ubiformat /dev/mtd5 -f /media/sda1/debian-image.ubi
+$ ubiformat -O 2048 /dev/mtd5 -f /media/sda1/debian-image.ubi
 </pre>
@@ Line 111: / Line 110: @@
 == See also ==
-* [[Linux Development for XScale modules]]
+* [[Linux: Development for ARM modules]]
-* [[Linux Kernel for CM-X300]]
+* [[CM-X300: Linux: Kernel]]
-* [[Debian Linux for CM-X300]]
+* [[CM-X300: Linux: Debian]]
 * [[U-Boot for CM-X300]]
 [[Category:Linux|Getting started]]
 [[Category:CM-X300|Linux:Getting started]]