target.nr

WINDRIVER 8260 ATM BSP

.\" wrSbc8260Atm/target.nr - SBC8260ATM target specific documentation
.\"
.\" Copyright 1984-2002 Wind River Systems, Inc.
.\"
.\" modification history
.\" --------------------
.\" 01a,30jan03,dee  fix SPR# 85481 - Wind River MAC address 1st 3 bytes
.\" 01a,03oct02,nrv  Adding info about TFFS
.\" 01a,30sep02,nrv  Updating the SIMM flash configuration
.\" 01a,25sep02,gjc  Adding note for defining the MAC address for the SCC SPR
.\"                  #82303.
.\" 01b,20mar02,g_h  Add note about the use of the ATM and SCC
.\" 01a,28jun01,g_h  created
.\"
.\"
.TH wrSbc8260Atm T "Wind River SBC8260" "Rev: 28 jun 01" "TORNADO REFERENCE: VXWORKS"

.SH "NAME"
.aX "Wind River SBC8260ATM"

.SH "INTRODUCTION"
This manual entry provides board-specific information necessary to run
VxWorks for the wrSbc8260Atm 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 
   following jumper's and switch's need to be set as follows:

   .CS
   Switch settings:
    ___________________________________________________________________
   | Dip Switch SW1 | Dip Switch SW2 | Dip Switch SW4 | Dip Switch SW3 |
   |----------------|----------------|----------------|----------------|
   | SW1-1    Close | SW2-1    Close | SW4-1    Close | SW3-1    Close |
   | SW1-2    Close | SW2-2    Close | SW4-2    Close | SW3-2    Close |
   | SW1-3    Close | SW2-3    Close | SW4-3    Close | SW3-3    Close |
   | SW1-4    Close | SW2-4    Close | SW4-4    Close | SW3-4    Close |
   | SW1-5    Close | SW2-5    Close | SW4-5    Close | SW3-5    Close |
   | SW1-6    Close | SW2-6    Open  | SW4-6    Close | SW3-6    Open  |
   | SW1-7    Close | SW2-7    Open  | SW4-7    Close | SW3-7    Open  |
   | SW1-8    Close | SW2-8    Open  | SW4-8    Close | SW3-8    Open  |
   |________________|________________|________________|________________| 

    ________________________________
   | Dip Switch SW1                 |
   |--------------------------------|
   | SW1-1    Close                 |  
   | SW1-2    Close                 |
   | SW1-3    Close (For ATM Open ) |
   | SW1-4    Open  (For ATM Close) |
   | SW1-5    Close                 |
   | SW1-6    Close                 |
   | SW1-7    Close                 |
   | SW1-8    Close                 |
   |________________________________|

   Jumpers:
    ______________
   |   Jumpers    |
   |--------------|
   |JP1     Close |
   |JP2     Close |
   |JP10    Close |
   |JP27    Close |
   |______________|

   Other Jumpers setting depend on CS0 connection: 
    ____________________________________________________
   |Chipe Select 0 to SIMM FLASH     | JP24    1-2 & 3-4|
   |---------------------------------|------------------|
   |Chipe 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 "wrSbc8260Atm", 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/wrSbc8260Atm".

3. Programming bootrom_uncmp to SBC8260ATM 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 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 SBC8260ATM board JTAG (JP6 The JTAG Port) 
             connector.

             Once all the connections have been made, power up the SBC8260ATM 
             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 "PROJECTS/LOAD" 
             window. In this window press on the '+' left to the 
             "PowerPC_C_Demo.prj".This will show you the project configuration. 
             Point with the mouse cursor on the "Microprocessors" option and 
             press the right button and choose the type of CPU you have on your 
             board. For example: "PowerPC->MPC82xx->MPC8260" . Verify that the 
             "Target Control" option point to visionPROBE for visionPROBE II or 
             visionICE for visionICE II, Also switch to the "Communications" 
             TAB and verify that the "Normal Port/Rate" & "Download Port/Rate" 
             suite your connection. for example: "LPT1"  for visionPROBE II. 
             Now press the "Save" button at the bottom of the window and after 
             it on the "Activate" button.

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

             Go to the "Tools" menu and select the 
             "Log Output/Playback Scripts" option. The "Record / Playback" 
             dialog box will popup. In this dialog box go to the 
             "Playback Commands From File" group and press on the "Browse" 
             button. Navigate your self to the location of the following  
             register file: "sbc8260atm_CS0_SIMM.reg.reg" for the SBC8260ATM 
             board where CS0 connected to the SIMM FLASH or  
             "sbc8260atm_CS0_OnBoard.reg" for the SBC8260ATM board where CS0 
             connected to the On Board FLASH. The file located in the 
             visionCLICK installation. After choosing the register file press 
             on the "Open" button to confirm the selected reg file. You will 
             return back to the "Record / Playback" dialog box. Now press on 
             the "Start" button located in the same group. In the "Terminal" 
             window you can see that the visionCLICK is running the script. 
             When visionCLICK will finish the playback you will get back the 
             ">BKM>" or the ">ERR>".

       3.1.4 Get into Background Mode: 
             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.

       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 configure correct. To do this type "CS" 
                     in the "Terminal" 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.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 again the
                     ">BKM>" prompt.    

             3.1.5.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.1.6 Converting the 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" dialog 
                      box will pop up.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/wrSbc8260Atm/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" editbox, enter 0 for the start address, 
                      and in the "To 0x" editbox, enter "FFFFFFFF".

              3.1.6.3 Make sure that all the other check box are unchecked. 
                      Press the "Convert" button. Close the terminal window 
                      when the conversion completes.

       3.1.7 Programming the SBC8260ATM 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" 
                     dialog box will popup. In the edit box enter the full path 
                     to the location of the "bootrom_uncmp.bin", or use the 
                     "<--Browse" button to browse to the file location. Go to 
                     the "+/- Bias" group and enter the number "FFF00100" in 
                     the edit box. Now click the "OK" button, this will bring 
                     you back to the "TF FLASH PROGRAMMING" dialog box. 

             3.1.7.2 In the "Programming Algorithm" group in, the edit box 
                     press on the "Select" button, and select one of the 
                     following Flash devices:

                     The 64MB SIMM Flash: "INTEL 28F640Jx (8192 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 SBC8260ATM board JTAG (JP6 The JTAG Port) 
             connector.

             Once all the connections have been made, power up the SBC8260ATM 
             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 
                     "sbc8260atm_CS0_SIMM.reg.reg" for the SBC8260ATM 
                     board where CS0 connected to the SIMM FLASH or  
                     "sbc8260atm_CS0_OnBoard.reg" for the SBC8260ATM board 
                     where CS0 connected to the On Board FLASH.
                     The "sbc8260atm_CS0_OnBoard.reg" or 
                     "sbc8260atm_CS0_SIMM.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