edb93xx-linux-quickstart.txt

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

the method used to install Redboot onto the flash ROM on the EDB9312/01 board.

  Power down the target board and make sure the jumpers are set to put the 
processor into serial boot mode the next time the board is reset.  On the 
EDB9312 board check that JP92 is set to 1-2 and JP93 is set to 2-3.  These 
jumpers lie between the JTAG test connector and touchscreen connectors.  
You may have to move the 10-pin ribbon cable slightly to see this area of 
the board.  

On the EDB9301 board, just check that JP13 is set to 2-3 and JP14 is set 
to 1-2.  These jumpers are located close to the reset buttons.

  Next, on the PC, change the current directory to the one containing the 
Cirrus Linux demo package.  Type the following command:

          ./download redboot.bin

  The PC should respond with "Waiting for the board to wake up..."  Turn 
on the power to the EDB9312/01.  The PC will count the percentages of the 
various phases of the download process.  When complete, the PC will
display: "Successfully programmed 'redboot.bin'."  If you do not see
this message after about one minute, start again from the beginning of 
this section.

  Once programming is finished, reconfigure the board to boot Redboot
from flash.  On the EDB9312 board, move JP92 back to the 2-3 position.  
On the EDB9301 board, move JP14 back to the 2-3 position.




3.  Using Redboot

  Redboot requires a few steps to configure, especially if using the 
network to transfer files.  This section describes how to do this.



3.1 Starting Redboot

  At this point, run Minicom or another telecom program on your Linux host.
For Minicom, use the '-s' flag to configure the terminal settings.  Set
the terminal settings to use /dev/ttyS0 (or S1 if using COM2) at
57600 bps, no parity, 8 data bits, one stop bit, and no flow control.
You may want to save these settings as the default.  Exit into the terminal
program.

  Press the POR Reset button on the EDB9312/01 (near the power connector). The 
first time that Redboot is installed into flash, a two to three minute
delay will pass while Redboot contemplates its unprogrammed flash.  After
this delay, an error message regarding a failed BOOTP attempt and corrupt
flash will be displayed.  This is normal and will not occur again after the
configuration process in the next section.  

If the terminal is set properly, you should eventually see a message like 
the following:

          
Ethernet eth0: MAC address 00:60:11:28:a8:35
IP: 192.168.1.8/255.255.255.0, Gateway: 192.168.1.250
Default server: 192.168.1.250, DNS server IP: 0.0.0.0
					   
RedBoot(tm) bootstrap and debug environment [ROMRAM]
Non-certified release, version v2_0 - built 14:32:52, Jul 24 2003
                                      
Platform: Cirrus Logic EDB9312 Board (ARM920T) Rev A
Copyright (C) 2000, 2001, 2002, Red Hat, Inc.
                                          
RAM: 0x00000000-0x02000000, 0x00041408-0x01fbd000 available
FLASH: 0x60000000 - 0x62000000, 128 blocks of 0x00040000 bytes each.
RedBoot>

At this point Redboot is up and running and ready to be configured.  If you 
have questions about any command you can type "help" for generic list of all
commands available, or "help <command_name>" for help on a specific command.

3.2 Configuring Redboot

  Now that Redboot is running, it must be configured.  Type 

	  fis init -f

to initialize the flash file system.  Answer 'y' when asked for confirmation.
Once this is complete, type:

	  fconfig -i

  This will start the Redboot setup.  Answer 'y' when asked for confirmation.
Press Enter to accept the default of 'false' for 'Run script at boot'. Press 
Backspace four times to erase the word 'true' and type 'false' for the 
question regarding BOOTP. 

  If not using the network to download, press Enter to accept empty defaults
for all of the Redboot networking parameters.  Otherwise, continue through
the end of this paragraph.  For Gateway IP address, enter the network 
gateway IP if on a corporate or home network or press Enter if using a 
private network or do not know this address.  Enter the IP address chosen
for the EDB9312/01 for the Local IP address.  Enter the net mask for the chosen
IP for the address mask.  If this is not known, try using 255.255.255.0 for 
this question.  Enter the PC's IP address for the Default server IP address.
Press Enter to accept the default for the DNS server IP address.
For Network hardware address, you should choose the default unless using
more than one EDB9312/01 on the same network.  In that case, change the last
three hex bytes to unique values.  Choose the default of 9000 for GDB 
connection port.

  Now that the network configuration is complete, choose the defaults for
the last two questions.  When asked to update the non-volatile configuration,
answer 'y'.  This will write these settings into permanent storage.  Changing
these settings in the future is as simple as running 'fconfig -i' again.

  After Redboot has finished flashing the settings, press POR Reset to
restart Redboot and load the new settings.

3.3 Testing the network

  A simple test of the network is to use the ping command.  This checks basic
connectivity between the host PC and the target.  In the terminal window,
type: 

          ping -v -n 5 -h <hostip>

where <hostip> is the IP address of your PC.  After five counts, you should
see the following message:

PING - received 5 of 5 expected


4.  Downloading Linux
4.1 Downloading via the network

  In downloading Linux to the target flash, it is assumed that the three files 
(Linux kernel plus two ram disk images) were already copied in section 1.5.  
To begin, type the following to load the large (12MB) ramdisk image into RAM:

    load -v -r -b 0x1000000 ramdisk12

The options on this command line have the following meaning:
    -v Indicates verbose output (optional)
    -r Indicates Raw binary input
    -b The base address to start loading to.

  A twirling line should appear while this file is transferring.  On a 10 Mbit
ethernet network, this should take about one minute depending on the file size.
When this command completes, the ramdisk image will reside at address 
0x1000000 in RAM.  

Now you need to create the file in the flash file system.  Type the following 
command to write this image into flash: 

    fis create -b 0x1000000 -l <size of ramdisk in bytes> ramdisk

The options on this command line have the following meaning:
    -b The base address to start loading from.
    -l The size of the file that was downloaded.

  The ramdisk now exists in the flash filesystem.  The next two steps function
in the same way as the previous two, but will load the kernel into the RAM and
then into the flash ROM.

    load -v -r -b 0x218000 vmlinux.bin

    fis create -b 0x218000 -l <size of vmlinux.bin file> vmlinux

  To check that the files were written to flash, type:

    fis list

  The output should show something like the following:

Name              FLASH addr  Mem addr    Length      Entry point
RedBoot           0x60000000  0x60000000  0x00040000  0x00000000
RedBoot config    0x61F80000  0x61F80000  0x00001000  0x00000000
FIS directory     0x61FC0000  0x61FC0000  0x00040000  0x00000000
ramdisk           0x60040000  0x01000000  0x00C00000  0x01000000
vmlinux           0x60C40000  0x00218000  0x00140000  0x00218000


  Linux can now be started directly from the flash whenever Redboot is 
restarted by typing:

    fis load ramdisk

    fis load vmlinux

    exec -r 0x1000000 0x218000

The -r parameter on the exec command specifies the address of the ramdisk.


4.2 Downloading via serial

  If a network is unavailable, the Linux image can be downloaded via the 
same serial link as Redboot.  Because the serial connection has far less
throughput than the EP93XX's Ethernet interface, this option is not 
preferred.  A smaller version of the ramdisk image has been included in 
this kit to save time during this process.

  To begin, load the ramdisk image into RAM by typing:

    load -v -r -b 0x1000000 -m ymodem

  Insure that the terminal program used has the YModem file transfer 
protocol available.  In Minicom, invoke this by pressing Ctrl-A then S 
then choosing YModem.  Choose the file named 'ramdisk1_5Meg' to transfer. 
Most file transfer clients will show a few retries or NAKs.  This is alright
and will eventually give way to the transfer of the ramdisk.  The transfer 
process will take about five minutes.

  When this is completed, program the ramdisk into the flash by executing the
following:

    fis create -b 0x1000000 -l <size of ramdisk file> ramdisk

  The ramdisk now exists in the flash filesystem.  The next two
steps function in the same way as the previous two, but will load the 
kernel into the RAM and then into the flash ROM.

    load -v -r -b 0x218000 -m ymodem

  Now start the ymodem transfer as before except choose the file 
'vmlinux.bin'.  When the transfer is complete, program it into flash
by typing:

    fis create -b 0x218000 -l <size of vmlinux.bin file> vmlinux

To check that the files were written to flash, type:

    fis list

The output should show something like the following:

Name              FLASH addr  Mem addr    Length      Entry point
RedBoot           0x60000000  0x60000000  0x00040000  0x00000000
RedBoot config    0x61F80000  0x61F80000  0x00001000  0x00000000
FIS directory     0x61FC0000  0x61FC0000  0x00040000  0x00000000
ramdisk           0x60040000  0x01000000  0x00180000  0x01000000
vmlinux           0x601C0000  0x00218000  0x00140000  0x00218000

Linux can now be started directly from the flash whenever Redboot is restarted
by typing:

    fis load ramdisk

    fis load vmlinux

    exec -r 0x1000000 0x218000

The -r parameter on the exec command specifies the address of the ramdisk.
                                                                                                                             


5.  Using the Linux demos
5.1 Basics

  Once Linux is started on the EDB9312/01, the LCD should display the Linux
boot-up text and a prompt to activate the console.  Pressing the Enter key
will return a command prompt (ash).  The following are a few basic commands
for navigating the distribution:

	  ls -0		-List files
	  ls -0l	-List files, sizes, dates, and permissions
	  cd		-Change directory
	  vi		-Invoke the VI editor
	  top		-Show an interactive process list
	  ps aefd	-Show the current processes
	  kill n	-Kill process number 'n'
	  ifconfig	-Set up IP networking
	  route		-Set IP networking routes

  Linux supports virtual consoles, that is, it can have multiple terminals 
running at once on the same display.  To change to another terminal, hold down
the left CTRL and ALT keys on the keyboard while pressing a function key F1-F4,
depending on the console desired.

  In this demonstration distribution, the LCD video rate is such that a VGA 
monitor attached to jack J9 will display the same video as the LCD. This is 
useful when showing the EDB9312/01 board to more than a few people or when 
debugging or developing for long stretches of time.


5.2 Graphical apps

  All graphical applications in this demo use QT-2.3.7 Embedded Free for displaying 
graphics directly on the Framebuffer.  To start the demo, type:

	  cd /qtdemo

	  ./launcher

  Now that Qt-E is running, the touchscreen can be used as a mouse. A finger 
works just as well as a PDA stylus for moving the cursor.  Be careful as too 
much pressure on the screen can damage it.  

  A few applications that can be run from the demo

       	   Canvas - Alpha Blending
	   Scribble Editor
	   Magnifier - Touch inside the window, then touch somewhere on the screen.
	   Line Draw - Move your finger around the window and release.
	   Rotation - Select Rotation degrees and launch a new app