target.nr

wind river提供的MPC8260的BSP典型代码

.\" wrSbc8260/target.nr - SBC8260 target specific documentation
.\"
.\" Copyright 2000-2002 Wind River Systems, Inc.
.\"
.\" modification history
.\" --------------------
.\" 01f,18jan02,g_h  update for removing MAC_ADRS_IN_NVRAM
.\" 01e,29nov01,jhw  update for SPR 71595 fix
.\" 01d,24oct01,g_h  update for T2.2
.\" 01c,06jul01,g_h  update to contain instruction how to use SingleStep for vision
.\" 01b.11May01,g_h  update to reflect new changes in BSP
.\" 01a,22Nov00,g_h  baseline version
.\"
.\"
.TH wrSbc8260 T "Wind River SBC8260" "Rev: 22 Nov 00" "TORNADO REFERENCE: VXWORKS"

.SH "NAME"
.aX "Wind River SBC8260 - MPC8260 Reference Board"

.SH "INTRODUCTION"
This manual entry provides board-specific information necessary to run
VxWorks for the wrSbc8260 BSP. Please read the section 
"Getting the board running vxWorks" in order to configure the board
to run vxWorks.

.SH "Getting the board running vxWorks"
This section will guide you step by step how to get vxWorks running on this 
board.

1. Setting the board Jumpers & Switches:

   In order to get the board running with the default configuration, the 
   jumpers and switches need to be set as follows:

   .CS

   For boards with a 33Mhz Oscillator:
    ____________________________________________________________
   |   Jumpers   | Dip Switch S1 | Dip Switch S2 | Dip Switch S6|
   |-------------|---------------|---------------|--------------|
   |JP1     1-2  | S1-1    Close | S2-1    Close | S6-1    Close|
   |JP2     1-2  | S1-2    Close | S2-2    Close | S6-2    Close|
   |JP3     Open | S1-3    Close | S2-3    Close | S6-3    Close|
   |JP4     Open | S1-4    Close | S2-4    Close | S6-4    Close|
   |JP10    1-2  | S1-5    Close | S2-5    Close | S6-5    Close|
   |JP16    Open | S1-6    Close | S2-6    Close | S6-6    Close|
   |JP25    1-2  | S1-7    Close | S2-7    Open  | S6-7    Open |
   |JP23    Open | S1-8    Close | S2-8    Close | S6-8    Close|
   |_____________|_______________|_______________|______________| 

   For boards with a 66Mhz Oscillator:
    ____________________________________________________________
   |   Jumpers   | Dip Switch S1 | Dip Switch S2 | Dip Switch S6|
   |-------------|---------------|---------------|--------------|
   |JP1     1-2  | S1-1    Close | S2-1    Close | S6-1    Close|
   |JP2     1-2  | S1-2    Close | S2-2    Close | S6-2    Close|
   |JP3     Open | S1-3    Close | S2-3    Close | S6-3    Close|
   |JP4     Open | S1-4    Close | S2-4    Close | S6-4    Close|
   |JP10    1-2  | S1-5    Close | S2-5    Close | S6-5    Close|
   |JP16    Open | S1-6    Close | S2-6    Open  | S6-6    Open | 
   |JP25    1-2  | S1-7    Close | S2-7    Open  | S6-7    Open |
   |JP23    Open | S1-8    Close | S2-8    Open  | S6-8    Open |
   |_____________|_______________|_______________|______________|

   Other Jumper settings depend on CS0 configuration: 
    ____________________________________________________
   |Chip Select 0 to SIMM FLASH      | JP24    1-2 & 3-4|
   |---------------------------------|------------------|
   |Chip Select 0 to On Board FLASH  | JP24    1-3 & 2-4|
   |_________________________________|__________________|
   
   .CE

2. Creating a bootrom_uncmp.hex:
   2.1 Launch Tornado II, go to the "Build" menu and choose the option 
       "Build Boot ROM...".
   2.2 the "Build Boot ROM" window will popup, in the "Select a BSP:" column
       choose the "wrSbc8260", and in the "Select an Image to build:" column
       choose "bootrom_uncmp.hex" and press the "OK" button.
   2.3 After the build process will finish successfully (You will see "Done" in
       the "Build window" without error), you will have the bootrom_uncmp.hex in
       your BSP directory "$(WIND_BASE)/target/config/wrSbc8260".

3. Programming bootrom_uncmp to SBC8260 FLASH:
   If you are using visionCLICK please follow the instruction in section 3.1.
   If you are using SingleStep please follow the instruction in section 3.2.
   
   3.1 Using visionCLICK:

       3.1.1 Connect the JTAG interface cable from the visionPROBE II  or 
             visionICE II into the SBC8260 board JTAG (JP6 The JTAG Port) 
             connector, and power it on.

             Once all the connections have been made, power up the SBC8260 
             board and start the visionCLICK executable on the host.

       3.1.2 Configure the visionCLICK project: 
             The "Welcome To visionCLICK" window will appear .In this window 
             press on the "Configure" button, This will invoke the 
	     "PROJECTS/LOAD" window. In this window press on the '+' left 
	     of the "PowerPC_C_Demo.prj" project. This will show you the 
	     project configuration. 
             Point with the mouse cursor on the "Microprocessors" option and 
             right-click to choose the type of CPU you have on your board. 
	     For example: "PowerPC->MPC82xx->MPC8260". Verify that the 
             "Target Control" option points to visionPROBE for visionPROBE II,
	     or visionICE for visionICE II. Switch to the "Communications" 
             TAB and verify that the "Normal Port/Rate" & "Download Port/Rate" 
             suit your connection. For example: "LPT1"  for visionPROBE II. 
             Save the project by clicking the "Save" button at the bottom of 
	     the window. Click the "Activate" button to send the project
	     configuration to the attached hardware debugger.

       3.1.3 Program visionPROBE II / visionICE II with the proper register 
             setting for the SBC8260 board:

             Go to the "Tools" menu and select the "Log Output/Playback Scripts"
	     option. The "Record / Playback" dialog box will popup. Go to the 
             "Playback Commands From File" group and click the "Browse" button. 
	     Navigate to the location of the register file: "sbc8260_64MB.reg"
	     for the board with 64MB SDRAM or "sbc8260_16MB.reg" for the board
	     with 16MB SDRAM. The file is located in the visionCLICK 
	     installation. After choosing the register file press on the "Open"
	     button to confirm the selected reg file. This will return you back
	     to the "Record / Playback" dialog box. Click the "Start" button 
	     located in the same group. In the "Terminal" window you can see 
	     that visionCLICK is running the script. When the script is finished
	     running, you will get back the ">BKM>" or the ">ERR>" prompt.

       3.1.4 Get into Background Mode: 
             Execute the "IN" command to reset the board and initialize it with 
             the register settings.

             .CS
             IN
             .CS

             This is the reset command to initialize the board.

       3.1.5 Setting the Flash Chip Select:

             3.1.5.1 Once the ">BKM>" prompt appears we need to verify that the 
                     Flash chip select configuration is correct. To do this,
		     type "CS" in the "Terminal" window and press Enter. The 
		     first line ("CS0") is for the Flash chip select. Under the
		     "PS" (for Port Size) column for CS0, check that the number
		     is 32 For the SIMM Flash or 8 For the On Board Local Flash.
		     If configured properly, goto Section 3.1.6.
		     If not configured properly, follow the steps below to 
		     change it:

             3.1.5.2 Type "CS CS0" in the "Terminal" window and press Enter. 

                     .CS	    
                     >BKM>CS CS0
                     .CE

             3.1.5.3 Press enter until you get the following line:

                     .CS
                     (0-3) = 64, 8, 16, 32 bits  |  Port Size  =  32 Bits    >
                     .CE

                     Enter 3 for 32 SIMM Flash or 1 for the On Board Local 
                     Flash and keep pressing Enter until you get the
                     ">BKM>" prompt again.

             3.1.5.4 Once the prompt appears, reset the board and the emulator 
                     with the following command:

                     .CS	    
                     >BKM>IN
                     .CE

                     After you get the ">BKM>" prompt, continue with the 
                     instructions in the next section.

       3.1.6 Converting bootrom_uncmp.hex to bootrom_uncmp.bin:

              3.1.6.1 In visionCLICK, choose "Convert Object Modules" from the 
                      "Tools" menu. The "CONVERT BINARY AND SYMBOL OBJs" window 
                      will appear. Select "All Files" in the "Files of Type" 
                      box. Go to the "Select Input Object Module To Convert" 
                      group and navigate to the file "bootrom_uncmp.hex" 
                      located in: 
                      "$(WIND_BASE)/target/config/wrSbc8260/bootrom_uncmp.hex"

              3.1.6.2 In the group "Binary Downloadable Objects Modules" check 
                      the "Create Flat BIN File For Flash Programming". 
                      "In Range Of 0x" edit box, enter 0 for the start address, 
                      and in the "To 0x" edit box, enter "FFFFFFFF".

              3.1.6.3 Make sure that none of the other check boxes are checked. 
                      Press the "Convert" button. Close the terminal window 
                      when the conversion completes.

       3.1.7 Programming the SBC8260 Flash:
             In visionCLICK, select "Program Flash Devices" from the Tools 
             pull-down menu. This will invoke the "TF FLASH PROGRAMMING" 
             window. If you are not using visionCLICK, you can also invoke 
             this window using the "visionICE Utilities Panel" and follow the 
             steps below:

             3.1.7.1 Click the "Select" in the "Flash Card or PC Host File 
                     Name and Path" group. The "CHOOSE A FILE FROM HOST PC" 
                     window will appear. In the edit box enter the full path 
                     of the file "bootrom_uncmp.bin", or use the "<--Browse"
		     button to navigate to the file. Go to the "+/- Bias" group
		     and enter "FFF00100" in the edit box. Click the "OK" 
		     button. This will bring you back to the 
		     "TF FLASH PROGRAMMING" window. 

             3.1.7.2 In the "Programming Algorithm" group, click the "Select" 
	     	     button, and select one of the following Flash devices:

                     The 4MB SIMM FLASH:    "AMD 29F080/81(1024 x 8) 4 Devices"

                     The 2MB On Board FLASH: "AMD 29F016/17(2048 x 8) 1 Device"

                     ** Note: In order to use the On Board FLASH some jumpers 
                              and switches should be changed.

             3.1.7.3 Set the proper address of the Flash to "FFF00000", check 
                     the "Erase All" radio button, and set the 
                     "Available RAM Workspace" setting to "00000000". Set the 
                     "Bytes Of Target RAM Required" to "60000".

             3.1.7.4 Press the "Erase and Program" button.

             3.1.7.5 Now the Flash memory is programmed with the new boot 
                     program. 

   3.2 Using SingleStep for vision:

       3.2.1 Install the visionPROBE II  or visionICE II and power it on. 
             Connect the JTAG interface cable from the visionPROBE II  or 
             visionICE II into the SBC8260 board JTAG (JP6 The JTAG Port) 
             connector.

             Once all the connections have been made, power up the SBC8260 
             board and start the SingleStep for vision executable on the host.

       3.2.2 Configure the SingleStep project: 

             3.2.2.1 Go to the "File" menu and choose the 
                     "Start Debug Session..." .
   	   
             3.2.2.2 The "Debug" dialog box will popup, In the "Connection" tab
                     choose the visionPROBE option & the correct LPT port if 
                     you are using visionPROBE, or visionICE & enter the 
                     emulator IP address if you are using visionICE.
			  
             3.2.2.3 In the "Processor" tab choose the "MPC8260".

             3.2.2.4 In the "Register" tab choose the option 
                     "Use vision-style register window with REG file" and then
                     browse to the location of the file "sbc8260_64MB.reg" for
                     board with 64MB SDRAM or "sbc8260_16MB.reg" for board with
                     16MB SDRAM, and choose it. The "sbc8260_64MB.reg" or 
                     "sbc8260_16MB.reg" file should be in the SingleStep 
                      registers directory.

             3.2.2.5 In the "File" tab choose the "Debug without a file" 
                     option.

       3.2.3 Get into Background Mode: 

             3.2.3.1 Now in the "File" tab press OK.

             3.2.3.2 Now should get the "Debug Status" dialogbox and in the 
                     "Debug Session" field you should have in green 
                     "Started Successfully", press the "Close" button.

             3.2.3.3 Now go to the "Command" button in the toolbar and press on 
                     it. The "Command" Window will popup, the prompt in the 
                     window will be "SingleStep". Bring the mouse cursor above 
                     the "Command" window and press the right button. A menu 
                     will popup, choose the "VisionShell(vsh)" option. Now the 
                     prompt in the window will be ">BKM>". If the prompt is
                     ">ERR>" execute the "IN" command to reset the board and 
                     initialize it with the register setting.

                     .CS
                     IN
                     .CS
                     This command is the reset command to initialize the board. 
                     After you got the ">BKM>" prompt again continue with the 
                     instruction in the next section. 

       3.2.4 Setting the Flash Chip Select:

             3.2.4.1 Once the ">BKM>" prompt appears we need to verify that the 
                     Flash chip select configure correct. To do this type "CS" 
                     in the "Command" window and press Enter. The first line 
                     is for the Flash chip select. This is chip select 0 "CS0" 
                     under the "PS" (From Port Size) column for the first line, 
                     check that the number is 32 For the SIMM Flash or 8 For 
                     the On Board Local Flash. If the number is else follow 
                     the step below in order to change it:

             3.2.4.2 Type "CS CS0" in the "Command" window and press Enter. 

                     .CS	    
                     >BKM>CS CS0
                     .CE

             3.2.4.3 Press enter until you get the following line:

                     .CS
                     (0-3) = 64, 8, 16, 32 bits  |  Port Size  =  32 Bits    >
                     .CE

                     Enter 3 for 32 SIMM Flash or 1 for the On Board Local 
                     Flash and keep pressing Enter until you get again the
                     ">BKM>" prompt.    

             3.2.4.4 Once the prompt appears, reset the board and the emulator 
                     with the following command:

                     .CS	    
                     >BKM>IN
                     .CE

                     After you got the ">BKM>" prompt again continue with the 
                     instruction in the next section.

       3.2.5 Converting the bootrom_uncmp.hex to bootrom_uncmp.bin:

             3.2.5.1 Go to the menu and choose "Tools" and 
                    "Vision Flash Utility..." . 

             3.2.5.2 The "Flash Programming Window" will popup. Go to the 
                     "Files" tab, press the "Convert" button.

             3.2.5.3 The "File Convertion" window will popup. In the