target.nr

WINDRIVER 8260 ATM BSP

              script finished continue to the next step.

       4.1.2. In the terminal window at the ">BKM>" or ">ERR>" prompt enter the 
              "IN" command and press enter. Now you should get the ">BKM>" 
              prompt.

       4.1.3. Continue to step 5.

   4.2 Using SingleStep for vision:

       4.2.1. Go to the "File" menu and choose the "Start Debug Session...".


       4.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.
			  
       4.2.3. In the "Processor" tab choose the MPC8260.

       4.2.4. In the "Register" tab choose the option 
	      "Use vision-style register window with REG file" and then
	      browse to $(WIND_BASE)\target\config\wrSbc8260Atm\misc" and 
              choose the "sbc8260atm_CS0_OnBoard.reg" file.

       4.2.5. In the "File" tab choose the "Debug without a file" option and 
              press OK.

       4.2.6. Now should get the "Debug Status" dialogbox and in the 
              "Debug Session" field you should have in green 
              "Started Successfully", press the "Close" button.

       4.2.7. 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>".

       4.2.8. Cotinue to step 5.

5. At the ">BKM>" prompt enter: 
.CS	
   SY RSTCONF 04340E05 8
.CE
   The emulator should respond with the following:
.CS
   + Flash Erase : Success
   + Program Configuration Word : Success
   >BKM>
.CE

6. Power off the SBC8260ATM and close switch S2-1. You will get the ">ERR>" 
   prompt in visionCLICK terminal window or in SingleStep command window.

7. Power on the SBC8260ATM and at the ">ERR>" prompt enter: "IN"

8. The SBC8260ATM will read the configuration word from Flash during reset and 
   initialize the processor base on the configuration word entered in step 5 
   and you will get to ">BKM>".

9. Now you are ready to disconnect the emulator and run the BSP.


.SS "Programming the Hard Reset Configuration Word to the SIMM FLASH"
.PP

1. Power off the SBC8260ATM board and set dip switch SW2-1 to Open posetion 
   (Sets Reset Configuration to internal default).

2. Verify JP-24 jumper is set to 1-2 and 3-4 if you boot from the Local Flash.

3. Power on the SBC8260ATM and the emulator (visionPROBE II or visionICE II).

4. If you are using visionCLICK follow section 4.1, if you are using SingleStep 
   for vision follow section 4.2 :

   4.1 Using visionCLICK:

       4.1.1. Start visionCLICK and go to the menu and choose 
	      "Tools"->"Upload / Download Register Files"->
              "Download Register Value from File To Emulator". The 
              "CHOOSE FILE TO LOAD REGISTER FROM:" dialogbox will popup.
	      Browse to "$(WIND_BASE)\target\config\wrSbc8260Atm\misc" and 
              choose the "sbc8260atm_CS0_SIMM.reg", after plabacking the script 
              finished continue to the next step.

       4.1.2. In the terminal window at the ">BKM>"  or ">ERR>" prompt enter the 
              "IN" command and press enter. Now you should get the ">BKM>" prompt.

       4.1.3. Go to the "Tools" menu and choose the "Program Flash Devices". The 
              "TF FLASH PROGRAMMING" dialogbox will popup.

       4.1.4. In the "Flash Card or PC Host File Name and Path" group, press the 
              "Select..." button.

       4.1.5. The "CHOOSE A FILE FROM HOST PC" dialogbox will popup. Use the
              "<-Browse" button to browse to 
              "$(WIND_BASE)\target\config\wrSbc8260Atm\misc" and choose the 
              "sbc8260atmSIMM_hreset.bin" and press the "OK" button. After 
              returning to the "CHOOSE A FILE FROM HOST PC" dialogbox press
	      again the "OK" button.
	   
       4.1.6. Now you should be in the "TF FLASH PROGRAMMING" dialogbox. Go to 
	      the "Programming Algorithm" group and press the "Select" button.
	      The "Choose TF Device Algorithm" dialogbox will popup. Choose the
 	      "INTEL  28F640Jx ( 8192 x  8 ) 4 Devices" and press the "OK" 
              button.

       4.1.7. Now you should be back in the "TF FLASH PROGRAMMING" dialogbox.
	      In the "Device or Sector Base and End Address" enter the 
              following: "FC000000" for the "Base Address" and check the 
              "Erase All" radio button.

       4.1.8. In the "Available RAM Workspace For Flash Algorithm" group enter 
              the following: For "Start Address" "F0008000" and for 
              "Byts Of Target RAM Required" enter "4000".

       4.1.9. Now press the "Erase and Program" button. After getting the 100% 
              close the "TF FLASH PROGRAMMING" dialogbox and continue to step 5.
	    

   4.2 Using SingleStep for vision:

       4.2.1. Go to the "File" menu and choose the "Start Debug Session..." .
   	   
       4.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.
			  
       4.2.3. In the "Processor" tab choose the MPC8260.

       4.2.4. In the "Register" tab choose the option 
	      "Use vision-style register window with REG file" and then
	      browse to $(WIND_BASE)\target\config\wrSbc8260Atm\misc"
              and choose the "sbc8260atm_CS0_SIMM.reg" file.

       4.2.5. In the "File" tab choose the "Debug without a file" option
              and press OK.

       4.2.6. Now should get the "Debug Status" dialogbox and in the 
              "Debug Session" field you should have in green 
              "Started Successfully", press the 'Close' button.

       4.2.7. 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 pres the right button. A menu will popup, choose the 
              "VisionShell(vsh)" option. Now the prompt in the window will be 
              ">BKM>".

       4.2.8. Go to the menu and choose "Tools"->"Vision Flash Utility..." .

       4,2.9. The "Flash Programming Window" will popup. Go to the 
              "Configuration" tab, and choose the following Flash device:

	      "INTEL 28F640Jx (8192 x 8) 4 Devices" . In "Flash Bank" group 
              for the "Start:" enter "FC000000" . In the "RAM Workspace" 
              group for the "Workspace Start at:" enter "F0008000" and for 
              the "Workspace Size:" enter "4000".

      4.2.10. Now switch to the "Files" tab and press the "Add" button. The 
              open dialogbox will popup, browse to 
              "$(WIND_BASE)\target\config\wrSbc8260Atm\misc" and choose the
              "sbc8260atmSIMM_hreset.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.

      4.2.11. Now go to the "Program" tab and press the "Erase/Program" button. 
              After the process finished continue to step 5.

5. Power off the SBC8260ATM and close switch SW2-1. You will get the ">ERR>" 
   prompt in visionCLICK terminal window or in SingleStep command window.

7. Power on the SBC8260ATM and at the ">ERR>" prompt enter: IN

8. The SBC8260ATM will read the configuration word from Flash during reset and 
   initialize the processor base on the configuration word entered in step 4 
   and you will get to ">BKM>".

9. Now you are ready to disconnect the emulator and run the BSP.


.SS "SDRAM Size"
.PP
The BSP divides the 256MB SDRAM into two sections. The first section is 
used by vxWorks at the beginning and his size is 32MB. The second section 
is the rest of the memory 224MB can be added in the application level or 
by changing the compilation switch. Here is the reason way is done like this:

The reason the BSP divides the 256Meg SDRAM into 32MB sections and 224MB
section has to do with the EABI compilation option of a 24 bit address. 
The default compilation options generates a 'bl' for branch instructions. 
This increases performance, but places a 32Meg address limit on the code.
  
There are two "work arounds" to this limitation.
 
    1.) recompile all the source with the -mlongcall compilation flag
    2.) add remaining 224Meg to the memory pool vi the memAddToPool() function.
  
Option #1 would require all the libraries, driver, and the BSP to be 
recompiled with the -mlongcall compiler option. This results in a number
of code changes; the most obvious code change is branches are implemented
via brlr instruction verses the bl instruction.
  
Option #2, the preferable options, requires the USER_RESERVED_MEM and the
memAddToPool() constructs be used to specify the remaining 224Meg to be added
to the memory pool. Consult WindTech Note WTN41 for details on specifying
user memory.


.SS "Ethernet Port"
The BSP configures to use FCC2 as an Ethernet port. The name `motfcc' 
should be specified as the boot device to the boot ROMs when booting 
vxWorks over that interface. The Fast Ethernet Controller (FCC) makes 
available fast Ethernet connectivity using the RJ45 (JP28) connector. 
The BSP configures to use END-style network driver. If you wishes to 
use the SCC1 as the boot device you need to change boot device name 
to "motscc"

.SS " NVRAM Support" 
This BSP implements NvRam via a EEPROM device. There are a few user 
parameters associated with this device. The parameters are located in
the "config.h" file and are:
.CS  
    #undef  INCLUDE_EEPROM_LOCKING
    #define SMART_EEPROM_WRITE
    #define ETHERNET_ADR_SET /* (used in bootConfig.c to enable 'N' command) */
.CE
The INCLUDE_EEPROM_LOCKING parameter is typically #undef'ed. If #define'ed, the
EEPROM will be software locked between accesses. This was implemented on the
BSP to work around a power-on EEPROM corruption problem. It should be noted, 
that if the EEPROM is locked, its contents can not be altered via an emulator 
or visionPROBE II or visionICE II (JTAG does not meet the minimum timing 
relationships needed).

The SMART_EEPROM_WRITE parameter is typically #define'd. When defined, the 
EEPROM write code first checks to see if a cell is the desired value. If the 
memory location already contains the desired value, the write is skipped. This 
was implemented to increase the life of the EEPROM device.
  
The ETHERNET_ADR_SET is a value that indicates the MAC address is stored in 
NVRAM and alterable via the 'N' bootrom command.

.SS "Changing the Ethernet Address"
The SBC8260ATM boards do not have a unique Ethernet hardware address 
assigned to each board. A unique address is absolutely necessary if the
user wishes to connect the board to a network. Thus, the user must 
provide a suitable 6 byte Ethernet address for each board used
on a network. The BSP support up to 8 deferent MAC address. Byte number 4
is the one that is deferent between etch MAC address. The default 
Ethernet Address is specified in the "config.h" The following 
relate to the storage of the Ethernet address in NVRAM:
.CS
    /* Ethernet MAC Address Parameters */
	#define CUST_ENET3_0    0xA0	/* Customer portion of MAC address */
	#define CUST_ENET3_1    0xA1
	#define CUST_ENET3_2    0xA2
	#define CUST_ENET3_3    0xA3
	#define CUST_ENET3_4    0xA4
	#define CUST_ENET3_5    0xA5
	#define CUST_ENET3_6    0xA6
	#define CUST_ENET3_7    0xA7
	#define CUST_ENET4 	0xAA
	#define CUST_ENET5 	0xA0
.CE
The first three bytes (0x00, 0xa0, 0x1e) are a Wind River specific prefix
that should be kept as-is. If for some reason you need to change them, in
"config.h" change the following macros:
.CS
    #define WR_ENET0  0x00  /* Wind River specific portion of MAC (MSB->LSB) */
    #define WR_ENET1  0xa0
    #define WR_ENET2  0x1e	  

    #define	ENET_DEFAULT 0x1ea00000
.CE
Note:
    The "ENET_DEFAULT" macro should contain the same number as the three 
    "WR_ENETx"
    macros. For example : 
.CS
    #define WR_ENET0  0x11
    #define WR_ENET1  0x22
    #define WR_ENET2  0x33	  

    #define	ENET_DEFAULT 0x33221100

NOTE:  The bytes are reversed in the #define due to little endian issues
       in the macro that processes the ENET_DEFAULT macro.
.CE

The user must change the last three bytes to three unique bytes 
(i.e., bytes not used by any other Wind River Ethernet connection on your net). 
Check with your system administrator if you do not know this information. 
If these bytes need changing (they often will not), a new boot ROM must be 
burned, and a new image must be built. Ethernet Address can be specified at 
the bootrom prompt (N command). The Ethernet address is stored in the on board 
NVRAM. This option will able  you to change the last three bytes. To use this 
option, open the console window (for example: "Hayper Terminal") and when the 
bootrom banner appear and the countdown start, press any key, when you get the 
[VxWorks Boot] prompt , press 'N' and follow the instructions.

.SS "Changing the BOOT FLASH On Board FLASH to SIMM FLASH"
The BSP configures to use the 2MByte Local Flash. In order to use the 64MByte 
SIMM Flash instead , change in "config.h" the following lines:

FROM: 
.CS
    #define BOOT_FLASH ON_BOARD_FLASH
.CE
TO:
.CS
    #define BOOT_FLASH SIMM_FLASH
.CE

New boot ROM must be burned, and a new image must be built.

**Note: You need also to change the jumpers and switch's configuration. For 
        more details see "Setting the board Jumpers & Switches" section in 
        this file.

.SS "Serial Configuration"
SMC1 and SMC2 are configured as UART devices with 8 data bits, 1 stop bit, 
hardware handshaking, and parity disabled.

.SS "Serial Connections"
This VxWorks MPC8260 BSP uses a simple 3 wire connection and standard 
phone jacks where pin 1 = RIN, pin 2 = TOUT, pin 3 = NC, and pin 4 = GND.

.SS "SCSI Configuration"
There is no SCSI interface on this board.