'\" t.so wrs.an.\" wrPpmc74xx/target.nr - PPMC74xx target specific documentation.\".\" Copyright 1984-2002 Wind River Systems, Inc..\".\" modification history.\" --------------------.\" 01a,01apr02,mil  Removed support for FXP END driver..\" 01e,04feb02,g_h  Add explanation how to use the FXP END driver.\" 01d,23oct01,g_h  Cleaning and re-structuring.\" 01c,28aug01,dgp  change manual pages to reference entries per SPR 23698.\" 01b,29may01,kab  Fixed formatting, typos.\" 01a,12May01,g_h  written.\".\".TH wrPpmc74xx T "Wind River PPMC74xx" "Rev: 16 Apr 01" "TORNADO REFERENCE: VXWORKS".SH "NAME".aX "Wind River PPMC74xx - MPC7400/7410 and MPC107 Reference Board".SH "INTRODUCTION"This reference entry provides board-specific information necessary to runVxWorks for the wrPpmc74xx 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    On the carrier board:    --------------------    JP3		1-2		    JP4		2-3    On the PMC board:    ----------------    For Default XPC7400/MPC7400    ---------------------------    SW1-1   Off  SW3-1   Off  SW2-1    Off    SW1-2   On   SW3-2   Off  SW2-2    On     SW1-3   Off  SW3-3   On   SW2-3    Off    SW1-4   On   SW3-4   Off  SW2-4    Off                 SW3-5   On   SW2-5    Off		 SW3-6   Off  SW2-6    Off                              SW2-7    On                               SW2-8    Off    JP37    Open    On Power Module:    ---------------    For Default XPC7400 (2.15V)    For Default MPC700 (1.8V)    ---------------------------    ------------------------    SW1-1   Off (1)                SW1-1   On  (0)    SW1-2   Off (1)                SW1-2   On  (0)    SW1-3   Off (1)                SW1-3   Off (1)    SW1-4   Off (1)                SW1-4   On  (0)    SW1-5   On  (0)                SW1-5   Off (1)    SW1-6   On  (0)                SW1-6   On  (0)   .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 "wrPpmc74xx", 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/wrPpmc74xx".3. Programming bootrom_uncmp to PPMC74xx 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 PPMC74xx board JTAG (JP6 The JTAG Port)              connector.             Once all the connections have been made, power up the PPMC74xx             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->MPC7xx->MPC7400" for the MPC7400 or              "PowerPC->MPC7xx->MPC7410" for the MPC7410. 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 PPMC74xx 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: "ppmc7400_107.reg" for the MPC7400 or              "ppmc7410_107.reg" for the MPC7410. 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 Converting the bootrom_uncmp.hex to bootrom_uncmp.bin:              3.1.5.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/wrPpmc74xx/bootrom_uncmp.hex"              3.1.5.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.5.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.6 Programming the PPMC74xx 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.6.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.6.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 4MB Flash: "AMD 29F800T (512 x 16) 4 Devices"             3.1.6.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.6.4 Press the "Erase and Program" button.             3.1.6.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 PPMC74xx board JTAG (JP6 The JTAG Port)              connector.             Once all the connections have been made, power up the PPMC74xx              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 "MPC7400" for the                      MPC7400 or "MPC7410" for the MPC7410.             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 "ppmc7400_107.reg" for                     the MPC7400 or "ppmc7410_107.reg" for MPC7410, and                      choose it. The "ppmc7400_107.reg" or "ppmc7410_107.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 PPMC74xx Flash:             3.2.5.2 In the "Flash Programming Window" window. Go to the                      "Configuration" tab, & choose the following Flash device:                     For the 4MB Flash: "AMD 29F800T (512 x 16) 4 Devices"                     In "Flash Bank" group for the "Start:" enter "FFF00000".                      In the "RAM Workspace" group for the "Workspace Start at:"                      enter "00000000" and for the "Workspace Size:" enter                      "60000".             3.2.5.3 Now switch to the "Files" tab and press the "Add" button.                      The open dialogbox will popup, browse to                      "$(WIND_BASE)\target\config\wrPpmc74xx\" and choose the                      "bootrom_uncmp.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 "0xFFF00100" and press the "OK" button.             3.2.5.4 Now go to the "Program" tab and press the "Erase/Program"                      button. After the process finished continue to step 5.             3.2.5.5 Now the Flash memory is programmed with the new boot program.4. Running the VxWorks Boot ROM program:   4.1 Disconect visionPROBE II or the visonICE II if it still connected to the        board, because it still connected to the board in some case it can stop        the processor at the first instruction.   4.2 Connecting the Ethernet channel and the serial channel:       4.2.1 First, connect the supplied serial cable with the board. On              one said connect the RJ11 connector to the RS232 port on the front