target.ref

MPC8560 for vxwork BSP

\" wrSbc85xx/target.ref - WR SBC 85xx target specific documentation
\"
\" Copyright 2002-2004 Wind River Systems, Inc.
\"
\" modification history
\" --------------------
\" 01f,30jul06,tor  Add VxBus support information
\" 01a,29oct04,mil  Updated TFFS info.
\" 01d,03aug04,mil  Updated operating speed information.
\" 01c,28jun04,mil  Removed long boot time workaround.
\" 01b,20May04,mil  Update for Rev.2 board.
\" 01a,27Oct03,mil  Created
\"
\"
\TITLE wrSbc85xx - Wind River SBC8540 and SBC8560

NAME
`Wind River SBC 85xx - MPC8540/8560 Reference Board'

INTRODUCTION
This reference entry provides board-specific information necessary to run
VxWorks with the wrSbc85xx BSP. Please read the section 
"Getting the board running vxWorks" in order to configure the board
to run vxWorks.

Setting up the board and running vxWorks
This section will guide you step by step how to get vxWorks running on this 
board.

0. Bootrom update required
   Flashing a new bootrom is required if the board has a 1.2/0 bootrom.
   This BSP version contains changes to the TLB mapping during initialization
   as well as both the static and dynamic TLB entries.  The bootrom needs to
   be updated in order for the RAM vxWorks iamges to work properly.  All
   TS=1 entries are now in sysPhysMemDesc[], while TS=0 entries are in
   sysStaticTlbDesc[].  The default mapping is just an example: applications
   may need to change the mapping for specific needs, or to improve
   performance.  Note that the mappings flagged IPROT are mandatory, and
   RAM image TLB mappings should agree with bootrom image TLB mappings.

   The BSP is also configured so that a RAM vxWorks image can be loaded
   with either the bootrom or WindPowerICE.  The EXTRA_DEFINE=-DNO_VX_BOOTROM
   in earlier versions of the BSP is no longer needed for ICE downloads.  
   However, it may be necessary to define USE_ALT_BOOTLINE in config.h
   and udpate ALT_BOOT_LINE to use the proper networking parameters.

1. Setting the board Jumpers & Switches:

   Rev.2 of the wrSbc85xx board with rev.2 of the MPC8540/8560 silicon is
   the currently supported configuration by this BSP revision.  
   Rev.1 of the wrSbc85xx board or processor silicon is obsolete.  
   Information on such hardware in this document is retained for 
   reference only.

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

\cs
    Keys:
    Switch "ON"  = CLOSED = Logic Value 0
    Switch "OFF" = OPEN   = Logic Value 1
    Refer to the board manaul for clarification.

    WR SBC 85XX Rev.1 (obsolete)
    Operating Mode Settings    Positions
    --------------------------------------------------------------------
    SW7-[4..1]                 0011  3:1 ratio for CCB:SYSCLK clock
    SW7-[5..6]                   10  3:1 ratio for e500core:CCB clock *NB
    SW8-[1],SW7-[8..7]          101  Local Bus GPCM - 8bit ROM
    SW8-[3..2]                   11  CPU acts as host processor
    SW8-[4]                       1  e500 core boots without waiting
    SW8-[6..5]                   11  Boot sequencer disabled, no I2C ROM
    SW8-[7]                       1  TSEC width standard
    SW8-[8]                       0  TSEC1 uses GMII or RGMII
    SW5-[1]                       0  TSEC2 uses GMII or RGMII
    SW5-[3..2]                   11  TxClk uses CCB clk as source
    SW5-[4]                       1  PCI/PCI-X in 32-bit
    SW5-[5..8],SW4-[1..4]  11111111  Device ID of RIO host
    SW4-[5]                       1  42 ohm I/O on LBC
    SW4-[6]                       0  Internal PCI arbiter disabled
    SW4-[7]                       1  PCI in normal mode (non-debug)
    SW4-[8]                       1  PCI mode (non-PCI-X)
    SW3-[1]                       0  LBC debug on MsrcID and MDVAL
    SW3-[2]                       0  Debug info driver on ECC pins
    SW3-[4..3]                   11  PCI 2 added buffer delay (2ns hold)
    SW3-[6..5]                   11  LBC 1 added buffer delay
    SW3-[8]                       X  0 for MPC8560, 1 for MPC8540

    WR SBC 85XX Rev.2
    Operating Mode Settings    Positions
    --------------------------------------------------------------------
    SW9-[4..1]                 0011  3:1 ratio for CCB:SYSCLK clock
    SW9-[5..6]                   10  3:1 ratio for CCB:SYSCLK clock *NB
    SW6-1,SW9-[8..7]            101  Local Bus GPCM - 8bit ROM
    SW6-[3..2]                   11  CPU acts as host processor
    SW6-[4]                       1  e500 core boots without waiting
    SW6-[6..5]                   11  Boot sequencer disabled, no I2C ROM
    SW6-[7]                       1  TSEC width standard
    SW6-[8]                       0  TSEC1 uses GMII or RGMII
    SW3-[1]                       0  TSEC2 uses GMII or RGMII
    SW3-[3..2]                   10  TxClk uses RxClk as source
    SW3-[4]                       1  PCI/PCI-X in 32-bit
    SW3-[5..8],SW2-[1..4]  11111111  Device ID of RIO host
    SW2-[5]                       1  42 ohm I/O on LBC
    SW2-[6]                       0  Internal PCI arbiter disabled
    SW2-[7]                       1  PCI in normal mode (non-debug)
    SW2-[8]                       1  PCI mode (non-PCI-X)

    SW5-[1]                       0  LBC debug on MsrcID and MDVAL
    SW5-[2]                       0  Debug info driver on ECC pins
    SW5-[3..4]                   11  PCI 2 added buffer delay (2ns hold)

    SW5-[5..6]                   11  LBC 1 added buffer delay
    SW5-[7]                       X  0 for Rev.2, 1 for Rev.1 silicon
    SW5-[8]                       X  0 for MPC8560, 1 for MPC8540

    *NB: [5..6] - The use of [5..6] instead of [6..5] is correct.
                  Some switches have the MSB/LSB order reversed.

\ce

2. Creating bootrom_uncmp.hex image.  The board should be pre-programmed with
   VxWorks bootrom.  Follow these steps to reprogram the bootrom.

   2.1 Launch Tornado, 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 "wrSbc8540" or "wrSbc8560", and in the "Select an Image to 
       build:" column choose "bootrom_uncmp.hex" and press the "OK" button.
   2.3 After the build process finishes 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/wrSbc8540" or
       "$(WIND_BASE)/target/config/wrSbc8560".

3. Programming bootrom_uncmp to the SBC85xx FLASH:
   If you are using visionCLICK please follow the instructions in section 3.1 
   If you are using WindPowerIDE please follow the instructions in section 3.2
   
   3.1 Using visionCLICK (version 7.11 or above required):

       3.1.1 Install the WindPowerICE.  Connect the JTAG interface cable
             from the WindPowerICE to the SBC85xx board JTAG connector
             and power it on.

             Once all the connections have been made, power up the SBC85xx
             board and start visionCLICK 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->E500->MPC8540" for the MPC8540 or 
             "PowerPC->E500->MPC8560" for the MPC8560. Verify that the 
             "Target Control" option point to WindPowerICE for 
             WindPowerICE.  Also switch to the "Communications" 
             TAB and verify that the "Normal Port/Rate" & "Download Port/Rate" 
             suite your connection.  Now press the "Save" button at the
             bottom of the window and after it on the "Activate" button.

       3.1.3 Program WindPowerICE with the proper register setting for
             the SBC85xx 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 to the location of the register file for the 
             wrSbc8540 or wrSbc8560.  The file is 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 Converting the bootrom_uncmp.hex to bootrom_uncmp.bin:

              3.1.4.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 either of: 
                      "$(WIND_BASE)/target/config/wrSbc8540/bootrom_uncmp.hex"
                      "$(WIND_BASE)/target/config/wrSbc8560/bootrom_uncmp.hex"

              3.1.4.2 In the group "Binary Downloadable Objects Modules" check 
                      the "Create Flat BIN File For Flash Programming". 
                      "In Range Of 0x" editbox, enter 0x0 for the start
                      address, and in the "To 0x" editbox, enter "FFFFFFFF".
                      Note that if the non-hex version bootrom_uncmp is used,
                      the start address should be 0xd00000 instead.

              3.1.4.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.5 Programming the SBC 85xx 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 "WindPowerICE Utilities Panel" and follow the 
             steps below:

             3.1.5.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 "FFF00000" in 
                     the edit box. Now click the "OK" button, this will bring 
                     you back to the "TF FLASH PROGRAMMING" dialog box.  If
                     the non-hex version bootrom_uncmp is used, bias should
                     be "FF200000" instead.

             3.1.5.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 8MB Flash: "INTEL V28F640Jx (8192 x 8) 1 Device"

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

             3.1.5.4 Press the "Erase and Program" button.

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

   3.2 Using WindPowerIDE (version 1.20 or above required):

       3.2.1 Install the WindPowerICE and power it on.
             Connect the JTAG interface cable from the WindPowerICE
             into the SBC85xx board JTAG connector.

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

       3.2.2 Configure the WindPowerIDE project:
             Follow the documentation on how to create a project in
             WindPowerIDE.

       3.2.3 Play the register file to initialize the SBC85xx board:
             Navigate to the location of the register file for the wrSbc8540
             or wrSbc8560.  The file is located in the WindPowerIDE
             installation.  Click OK and play the register file.
             In the "Terminal" window you can see the script being run.
             When WindPowerIDE finishes with the playback you will get back
             the prompt.

       3.2.4 Converting the bootrom_uncmp.hex to bootrom_uncmp.bin:
             Follow the documentation on how to convert a hex file to a bin
             file in WindPowerIDE.  Use 0x0 to 0xffffffff as the range.
             Note that if the non-hex version of bootrom_uncmp is used, the
             range should be 0xd00000 to 0xffffffff instead.

       3.2.5 Programming the SBC85xx Flash:
             In WindPowerIDE, select "Program Flash Devices" from the
             pull-down menu. This will invoke the "TF FLASH PROGRAMMING"
             window. 

             3.2.5.1 Specify the path and filename for the newly created
                     "bootrom_uncmp.bin" file.  Set the bias to 0xFFF00000.
                     If the non-hex version bootrom_uncmp is used, bias
                     should be 0xFF200000 instead.