target.nr

WINDRIVER SBC405 BSP

Wind River SBC405GP target specific documentation
'\" t
.\" wrSbc405gp/target.nr - SBC405GP target specific documentation
.\"
.\" Copyright 1984-2002 Wind River Systems, Inc.
.\"
.\" modification history
.\" --------------------
.\" 01g,11jul02,pch  SPR 77837:  Add section on programming flash using
.\"		     VisionXD.  SPR 77845:  Use generic fei82557End driver.
.\" 01f,26jun02,pch  SPR 73650 & 76704: clean up refs to processor revisions
.\" 01e,13may02,gjc  #73061 Fixing instuctions to erase FLASH Boot ROM
.\" 01d,18jan02,g_h  Update
.\" 01c,22nov01,g_h  Cleaning for T2.2
.\" 01b,03jul01,g_h  add SingleStep with vision instruction
.\" 01a,09apr01,g_h  created
.\"
.\"
.TH wrSbc405gp T "Wind River SBC405GP" "Rev: 09 Apr 01" "TORNADO REFERENCE: VXWORKS"

.SH "NAME"
.aX " Wind River SBC405GP"

.SH "INTRODUCTION"
This manual entry provides board-specific information necessary to run
VxWorks for the wrSbc405gp 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
     ___________________________________________________
    |           CPU Configuration Switch Box            |
    |___________________________________________________|
    | Dip Switch SW6 | Dip Switch SW5 | Dips Switch SW4 |
    |----------------|----------------|-----------------|
    | SW6-1      On  | SW5-1      On  | SW4-1       On  |
    | SW6-2      On  | SW5-2      Off | SW4-2       Off |
    | SW6-3      On  | SW5-3      Off | SW4-3       On  |
    | SW6-4      Off | SW5-4      Off | SW4-4       Off |
    | SW6-5      Off | SW5-5      On  | SW4-5       Off |
    | SW6-6      Off | SW5-6      Off | SW4-6       On  |
    | SW6-7      Off | SW5-7      On  | SW4-7       Off |
    | SW6-8      Off | SW5-8      Off | SW4-8       On  |
    |________________|________________|_________________|

     __________________   _______________________
    | User Switch Bank | | EPLD Isolation Switch |
    |__________________| |_______________________|
    | Dip Switch   SW3 | | Dip Switch        SW1 |
    |------------------| |-----------------------|
    | SW3-1        Off | | SW1-1             On  |
    | SW3-2        Off | | SW1-2             On  |
    | SW3-3        Off | | SW1-3             On  |
    | SW3-4        Off | | SW1-4             On  |
    | SW3-5        Off | |_______________________|
    | SW3-6        Off |
    | SW3-7        Off |
    | SW3-8        Off |
    |__________________|

   .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 "wrSbc405gp", 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/wrSbc405gp".

3. Programming bootrom_uncmp to SBC405GP 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
   If you are using VisionXD please follow the instruction in section 3.3

   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 SBC405GP board JTAG (JP12 The JTAG Port) 
             connector.

             Once all the connections have been made, power up the SBC405GP 
             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->IBM40x->405GP" . 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 SBC405GP 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: "sbc405gp.reg", 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 Enabling the TRPEXP option in visionCLICK:
             Execute the "CF TRPEXP YES" command in the "Terminal" window, 
             after you get back the ">BKM>" prompt execute the "IN" command to 
             reset the board.

             ** NOTE: If the "TRPEXP" option is set to "NO" the Flash erasing & 
                      programming will fail with timeout. On the other hand to 
                      run VxWorks using visionPROBE II/visionICE II "TRPEXP" 
                      option need to be set to "NO".

       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/wrSbc405gp/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 SBC405GP 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 "FFE00200" 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:

                     For the 16MB Flash: "INTEL 28F640Jx (4096 x 16) 2 Devices"

             3.1.7.3 Set the proper address of the Flash to "FFE00000", check 
                     the "Erase To" radio button, and set the end address of 
                     the FLASH to "FFFFFFFF".

                     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 SBC405GP board JTAG (JP12 The JTAG Port) 
             connector.

             Once all the connections have been made, power up the SBC405GP
             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 "405GP".

             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 "sbc405gp.reg" and 
                     choose it. The "sbc405gp.reg" file should be in the 
                     SingleStep 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 Converting the bootrom_uncmp.hex to bootrom_uncmp.bin:

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

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

             3.2.4.3 The "File Convertion" window will popup. In the 
                     "Enter new start address" edit box type "0x0" and in the
                     "Enter new end address" edit box type "0xFFFFFFFF".
      
             3.2.4.4 Now press the "Convert" button. After the convert operation
                     finished, you will see it in the "Convert Result" section
                     press the "Close" button.
          
       3.2.5 Programming the SBC405GP Flash:

             3.2.5.1 Go to the menu and choose "Tools"->
                     "Vision Flash Utility...". In the 
                     "Flash Programming Window" window. Go to the 
                      "Configuration" tab, & choose the following Flash device:

                     For the 16MB FLASH: "INTEL 28F640Jx (4096 x 16) 2 Devices"

                     In "Flash Bank" group for the "Start:" enter "FFE00000" . 
                     In the "RAM Workspace" group for the "Workspace Start at:"
                     enter "00000000" and for the "Workspace Size:" enter 
                     "60000".

             3.2.5.2 Now switch to the "Files" tab and press the "Add" button. 
                     The open dialogbox will popup, browse to 
                     "$(WIND_BASE)\target\config\wrSbc405gp\" and choose the
                     "bootrom_uncmp.bin" or "bootrom.bin" file. Now after 
                     getting back to the "Files" tab you will see the full path 
                     to the selected file in the "Binary Files" group. Move the
                     mouse curser above the line that showing the full path in 
                     the "Binary Files" group and press the right button to 
                     mark this line. Now press the "Toggle Enable" button to
                     select this binary file. Make sure that the line is still 
                     marked, and press the "Edit" button on the right. The 
                     "File Edit" dialog box will popup. In the 
                     "Enter new start address" edit box enter "0xFFE00200" and 
                     press the "OK" button.

             3.2.5.3 Now go to the "Program" tab and press the "Erase/Program"