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 runVxWorks for the wrSbc405gp BSP. Please read the section "Getting the board running vxWorks" in order to configure the boardto 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 |    |__________________|   .CE2. 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"