View source for Getting started with Linux on CM-X300

== Preparation steps ==

* Obtain a PC workstation with serial communication port.
* 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
* 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}}.
* Copy {{filename|debian-image.jffs2}} 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 USB flash drive or to a directory exported through NFS.

== Image installation ==

* Connect CM-X300's ETH0 port to your local Ethernet
* 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.}}
* You can use U-boot {{command|dhcp}} command to obtain IP address or manually set {{parameter|ipaddr}} and {{parameter|serverip}} environment variables:
<pre>
> setenv serverip <host ip address>
> setenv ipaddr <CM-X300 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> 
* After the ramdisk image is loaded you will get Linux login prompt. Login as {{parameter|root}} into the system.
* Now you can install kernel and filesystem images to the NAND flash using USB flash drive or NFS share as described below.

=== Installation using USB flash drive ===

* Connect USB flash drive to CM-X300. Use USB2 (host/slave) port.
* The USB flash drive will be automatically mounted under {{filename|/media/sda1}}
* Format the NAND flash and write the kernel image and Debian filesystem image onto it:
<pre>
$ flash_eraseall /dev/mtd4
$ flash_eraseall /dev/mtd5
$ nandwrite /dev/mtd4 /media/sda1/cm-x300-kernel.jffs2
$ nandwrite /dev/mtd5 /media/sda1/debian-image.jffs2
</pre>

=== Installation using NFS ===

* 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> 
* Mount the NFS share containing {{filename|debian-image.jffs2}} image:
<pre>
$ mount <host ip>:/path/to/nfs/share /mnt/net
</pre> 
* Format the NAND flash and write the kernel image and Debian filesystem image onto it:
<pre>
$ flash_eraseall /dev/mtd4
$ flash_eraseall /dev/mtd5
$ nandwrite /dev/mtd4 /media/sda1/cm-x300-kernel.jffs2
$ nandwrite /dev/mtd5 /media/sda1/debian-image.jffs2
</pre>


== After Installation ==

<ol>
<li> Reset the CM-X300.</li>
<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-X270 allows anonymous FTP access.

== See also ==

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