|
|
| Line 1: |
Line 1: |
| − | == Preparation steps ==
| + | #REDIRECT [[CM-X300: Linux: Getting started]] |
| − | {{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]]
| |
