Getting started with Linux on CM-X270

From Compulab Mediawiki
Revision as of 15:19, 6 March 2008 by Mike (talk | contribs)
Jump to: navigation, search

Preparation Steps

  1. Obtain PC workstation with serial communications port.
  2. Download the Linux distribution package for CM-X270 from CompuLab's website. Unzip the package to a folder on your workstation PC. Within the package, unzip disk.dat.zip file, to extract disk.dat.
  3. Download the Linux kernel package for CM-X270 from CompuLab's website. Copy the file named zImage.2.x.x from the package to the same folder. If installing on CM-X255, download the kernel specific for X255, since kernels are different per architecture.
  4. From the X270 kernel package, select version 2.6.16. Drivers in the file system image are kernel version dependent to some extent. If you prefer to use a different version of kernel, you will have to resolve the dependencies yourself. (Note for X255 users: older kernels were also tested)
  5. Rename the kernel file from zImage.2.x.x to zImage - to remove version marking.
  6. On CM-X270: ensure that you have ARMmon running.
  7. Connect the host PC to the CM-X270 via a null modem cable supplied with the Eval Kit.
  8. Choose the method of installation as explained in the next section.

Installation

Installation using LAN

This installation process requires local network with optional DHCP server. Host computer can run Windows or Linux. This method enables highest data rate and fastest turnover if repeated installations are required. Please refer to setip command in ARMmon manual for instruction on how to turn on the DHCP support or set static IP for your system. You can review the current IP setup by typing setupinfo. Perform the necessary setup, save and reset the board.

Installing the kernel

  1. Connect CM-X270's ETH0 port to your local Ethernet
  2. Install TFTP server on host PC. The TFTP server tested by CompuLab is TFTPD32 included in this distribution package.
  3. Point the TFTP server to the folder that contains Linux installation files for CM-X270: zImage and disk.dat
  4. 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.
  5. Turn on the CM-X270. The ARMmonitor will start and you will get a command prompt.
  6. Note: If NOR flash contents of your CM-X270 are different than default, you may need to press and hold ^C while turning the CM-X270 on, in order to get command prompt.
  7. In terminal window, type:
    > download kernel tftp zImage <ip of your host PC>
    The Linux kernel will be transferred from host PC to CM-X270's memory (SDRAM) through LAN, using TFTP protocol. (ARMMON contains TFTP client)
  8. In terminal window type:
    > flash kernel
    The Linux kernel will be saved to the NOR flash.

Installing the filesystem

  1. Format the NAND Flash, by typing in terminal window:
    > nand flash format
    This will erase the NAND flash contents!
    Are you sure(y/n)?
    y
    
  2. Type:
    > nand write disk.dat <ip of your host PC>
    
  3. This will start downloading the NAND flash image from the tftp server directly to NAND flash. Wait for the process to end.

  4. Follow to After Installation section below.

Installation using USB link

This method requiring minimum user's actions and it is fast enough. It uses USB slave port of CM-X270 and requires host workstation running Windows 2000 or XP.

Installation process

  1. Download the UsbMlink from [Developer] >> [CM-X270] >> [UsbMlink]. Read UsbMLink documentation provided in its package. Following documentation install and activate UsbMLink.
  2. If ARMmon of your card dated August 16, 2006 or later, run nor_prefix utility, provided with this package. It adds a 4 byte file length prefix to kernel image, required by new bootloader. (Note: use nor_prefix only for installation by UsbMlink). For help run nor_prefix without arguments.
  3. Rename the zImage (kernel image) file to nor-data.in. Using UsbMLink_GUI perform [NOR Update].
  4. Rename the disk.dat (filesystem image) file to nand-data.in. Using UsbMLink_GUI perform [NAND Update]. It will take about 15 minutes.
  5. Disconnect USB from target and follow to After Installation section below.

After Installation

  1. Reset the CM-X270.
  2. To start Linux type:
    > bootos
  3. If you want Linux to start automatically, type:
    > setboot os
    > save
    > bootos
    

    If you want to get back to ARMmon prompt, hold Ctrl-C during reset.

Connection and Logging In

Use the following usernames and passwords to login:

Account with administrative privileges:

User: root
Password: 111111

Regular user account:

User: user	
Password: 111111

In addition to these accounts CM-X270 allows anonymous FTP access.

To login into the Linux system, you may use a serial console at 38400 bps (ttySA0 for Linux 2.6.16 and ttyS0 for previous Linux versions), or connect through the network, or use a keyboard and VGA display (tty1, tty2, tty3).


See also