edb93xx-linux-quickstart.txt

嵌入式编程开发套件Virgo_20040130_1在开发板ebd93xx上的支持文档

**********************************************************************
----------------------------------------------------------------------
Linux Quickstart Guide for the EDB9312 and EDB9301
----------------------------------------------------------------------

Revision 0.1137

Copyright © 2003-2004 Cirrus Logic
January 15, 2004

**********************************************************************

Abstract: 

    The goal of this document is to guide the reader through the 
process necessary to download and execute a prebuilt Linux demonstration 
image on an EDB9312/01 development kit.  A basic familiarity with Linux
is assumed.

Table of Contents
    1       Prerequisites
    1.1	    Host computer requirements
    1.2	    Hardware setup
    1.3	    Preparing for network use
    1.4	    Setting up TFTP
    1.4.1   for Redhat 6.x
    1.4.2   for Redhat 7.x
    1.4.3   for Redhat 8.x
    1.4.4   for Redhat 9.x
    1.4.5   for Debian GNU/Linux
    1.5	    File setup
    2	    Downloading Redboot
    3	    Using Redboot
    3.1	    Starting Redboot
    3.2	    Configuring Redboot
    3.3	    Testing the network    
    4	    Downloading Linux
    4.1	    Downloading via the network
    4.2	    Downloading via serial
    5	    Using the Linux demo
    5.1	    Basics
    5.2	    Graphical apps






1.  Prerequisites
1.1 Host Computer Requirements

  In order to use this demonstration and further Cirrus Logic tools, the
following minimum personal computer requirements must be met:

	  -Personal computer running Redhat 7, 8, 9, or any version of 
	   Debian GNU/Linux from 2.2 to current with:
	  -One free RS232 serial port (DB9, or DB25 with an adapter)
	  -Minimum 500MB of disk space
	  -A Linux terminal program such as Minicom

  An Ethernet interface card can be used to accelerate most
of the file transfer and development processes on the EDB9312/01.  Redboot
(the flash-resident Linux bootloader) supports file transfers via TFTP.
See section 1.3 for more information about network requirements.



     
1.2 Hardware setup

  The EDB9312 kit includes a basic guide for setting up hardware.  It is
assumed that the kit is configured as described in this guide.  Here are 
the minimum required connections for using this demo:

	  -Serial null modem cable (included) between the host PC
	   and the bottom RS232 jack (J7)
	  -ATX power supply (included) connected to AC power and
	   the output connected to J24
	  -Keyboard (included) connected to the PS/2 connector (J15)

The minimum required connections for the EDB9301 board are slightly
different:

	-Serial null modem cable (included) between the host PC
	 and the bottom RS232 jack (J1)
	-5V DC "wall wart" power supply (included)
	


1.3 Preparing for network use

  One shining feature of the EP93XX device is its network interface.  Not
only can the 10/100 Ethernet MAC be used for communications in your
target application, but it can be used for accelerated development as well.
This Linux demo can be used without the network interface, but it is
painfully slow to transfer the necessary images.  For this reason, we have
provided two filesystem images:  one contains a minimal Linux root
filesystem, and the other includes graphical applications along with
the NanoX windowing system.  The latter image consumes ten times the memory
of the basic filesystem, necessitating a faster transfer method than the
56kbit serial link.

  To use the network interface, one must acquire a static IP address
on their network for the EDB9312/01 to utilize and locate the IP
address of the host PC.  Consult your system administrator if you do
not already know this information.  Dynamic IP allocation through BOOTP 
is supported by Redboot, but will not be discussed here.  Please consult 
the Redboot manual on the eCos website at http://sources.redhat.com/ecos/ 
for information on additional Redboot commands associated with BOOTP or 
other Redboot features not covered here.

  The connection to the network should be made through Category-5 Ethernet
cable to a hub, switch, or wall connection on the same network as the
host computer.  If these are not available but the host computer has
a network interface, an impromptu network can be made between the
host and target by connecting them together with an Ethernet crossover 
(null modem) cable.  These cables differ from standard network patch 
cables and are often available at local computer stores.

  If using a crossover cable or a private network (i.e. the host PC
and the EDB9312/01 are the only devices on the network), a non-Internet
set of IP addresses must be set on the host PC and the target.  
You must be familiar with setting the network interface address on your
particular PC Linux installation in order to use this option.  These are 
the preferred settings for this type of network:

	  Host (PC) IP: 192.168.1.250
	  EDB9312/01 IP  : 192.168.1.2
	  Network Mask: 255.255.255.0
	  Broadcast IP: 192.168.1.255

  TFTP is needed on the host PC for transferring files to the target board 
over a network.  TFTP, the Trivial File Transfer Protocol, is a rudimentary 
file serving protocol intended for loading operating systems to diskless 
workstations.  The following sections cover installing TFTP under a few
common Linux distributions.



1.4 Setting up TFTP

  The next few sections describe the setup of a TFTP server on the 
host Linux machine.  This is necessary only when using Ethernet as
opposed to serial transfers.  All commands in this section must be
executed as the root user.



1.4.1 for Redhat 6.x

  First, ensure that you have the tftp server RPM package installed from
the Redhat installation CDs. By default, this installs the TFTP server in 
a disabled state.  To enable the server, uncomment the following line
in the file /etc/inetd.conf

          tftp dgram   udp  wait root /usr/sbin/tcpd  /usr/sbin/in.tftpd

  If this line was not already uncommented (i.e. no pound sign # at the 
beginning) then run the following command:

          service inet reload

  Create the TFTP directory with these commands:

	  mkdir /tftpboot
	  chmod 777 /tftpboot

  The default TFTP transfer directory is /tftpboot . This is where files
must be placed in order to be transferred to Redboot.



1.4.2 for Redhat 7.x

  First, ensure that the xinetd RPM is installed.  Also, ensure that 
the tftp-server RPM is installed.  Enable TFTP by typing the following: 

          /sbin/chkconfig tftp on
 
  Reload the xinetd configuration using the command: 
  
          /sbin/service xinetd reload 

  Create the TFTP directory with these commands:

	  mkdir /tftpboot
	  chmod 777 /tftpboot

  The default TFTP transfer directory is /tftpboot . This is where files
must be placed in order to be transferred to Redboot.

  NOTE: Under Red Hat 7 you must address files by absolute pathnames. 
In the directions in the following sections, place the server path
/tftpboot before the filename to be transferred.  Example:

	  load -r -b 0x218000 vmlinux.bin

  becomes under Redhat 7.x:

	  load -r -b 0x218000 /tftpboot/vmlinux.bin



1.4.3 for Redhat 8.x

  Redhat 8.0 does not include the TFTP server on the install CDs.  
You should download these from Redhat's FTP site at:

	  ftp://rpmfind.net/linux/redhat/8.0/en/os/i386/RedHat/RPMS/ 

  The files are tftp-0.29-3.i386.rpm and tftp-server-0.29-3.i386.rpm .

  Install these packages by:

	  rpm -i tftp-0.29-3.i386.rpm
	  rpm -i tftp-server-0.29-3.i386.rpm

  Enable TFTP by means of the following:

	  /sbin/chkconfig tftp on


  Reload the xinetd configuration using the command:
   
	  /sbin/service xinetd reload

  Create the TFTP directory with these commands:

	  mkdir /tftpboot
	  chmod 777 /tftpboot

  The default TFTP transfer directory is /tftpboot . This is where files
must be placed in order to be transferred to Redboot.



1.4.4 for Redhat 9.x

  Install the tftp and tftp-server packages from the installation CDs
by mounting the third install CD, changing to the /mnt/cdrom/RedHat/RPMS 
directory, and typing the following commands:

          rpm -i tftp-0.32-4.i386.rpm
          rpm -i tftp-server-0.32-4.i386.rpm


  Enable TFTP by means of the following: 
  
          /sbin/chkconfig tftp on
       
  Reload the xinetd configuration using the command: 
   
          /sbin/service xinetd reload 

  Create the TFTP directory with these commands:

	  mkdir /tftpboot
	  chmod 777 /tftpboot

  The default TFTP transfer directory is /tftpboot . This is where files
must be placed in order to be transferred to Redboot.

  Redhat 9.x's TFTP server has a very short retry timeout period.  In some 
situations, this can cause the TFTP process to fail.  If this becomes an
issue, uninstall the TFTP and TFTP-server packages and follow the procedures
under the Redhat 8.x section.

1.4.5 for Debian GNU/Linux

  For all versions after 2.2, just execute the following command:

apt-get install tftpd

  and choose the default answer at all prompts (press Enter).  Debian 
assumes that installing the TFTP server indicates a willingness to use
it, so it is enabled by default after installation.

  Unlike Redhat, the default directory for TFTP is /boot .  Replace all
occurences of /tftpboot in all directions following this with /boot .




1.5 File setup

  If using TFTP, copy the following files to the TFTP directory (/tftpboot 
on Redhat and /boot on Debian):

	  cp vmlinux.bin /tftpboot
	  cp ramdisk12 /tftpboot
	  cp ramdisk1_5Meg /tftpboot





2.  Downloading Redboot

  Serial boot is a feature of the EP93XX device.  It allows applications
to be downloaded and executed without the need for a JTAG ICE or ROM
programmer tool.  The most popular use for this feature is to program the 
flash ROM on the target board during development and production.  This is