target.nr

WINDRIVER ADS8260 BSP

'\" t
.so wrs.an
.\" ads8260/target.nr - Motorola MPC8260ADS target specific documentation
.\"
.\" Copyright 1984-2002 Wind River Systems, Inc.
.\"
.\" modification history
.\" --------------------
.\" 01h,17Oct01,jrs  upgrade to veloce
.\"                  update SYSCLK freq for 33 and 66MHz selections
.\"                  configuration SYSCLK oscillator for 33, 40, and 66MHz
.\"                  added MODCK and MODCKH settings for 33, 40, and 66MHZ
.\"                  (SPR #66989)
.\" 01g,23aug01,dgp  change manual entry to reference entry per SPR 23698
.\" 01f,21apr00,stv  changes regarding programming start flash address (PILOT) 
.\" 01e,05mar00,mtl  changes for PILOT rev of ads8260 board
.\" 01d,04oct99,ms_  fixed header to give correct file name for online man page
.\" 01c,14sep99,ms_  updated for fcs release
.\" 01b,19jul99,ms_  updated for beta release
.\" 01a,21feb99,ms_  adapted from template version 01e
.\"
.\"
.TH "ads8260" T "Motorola MPC8260ADS" "Rev: 04 Dec 2001" "VXWORKS REFERENCE MANUAL"

.SH "NAME"
.aX "Motorola MPC8260ADS"

.SH "INTRODUCTION"
This reference entry provides board-specific information necessary to run
VxWorks for the ads8260 BSP. 

The BSP will work with the rev PILOT of the ADS8260 board.
The default rev is PILOT, which is turned on by the macro BOARD_REV_PILOT
in config.h.

.SH "BOOT ROMS"
No VxWorks Boot ROM is provided with this BSP release. Nevertheless VxWorks
boot code is working if downloaded into the SIMM Flash ROM.

VxWorks boot code can be programmed in to Flash using one of the following
methods:

.SS "1. Using Macraigor Raven"
Using the Macraigor Raven (www.macraigor.com), and their OCD Commander
host-based software a bootrom image can be read from the host and 
programmed into Flash Rom, as detailed below:

On the host, prepare a hex image of the bootrom. On a Unix host:
.CS
	make bootrom_uncmp.hex
.CE

Install the Raven connector through a parallel port onto your host, and
power it on. Connect the COP interface cable from the Raven into the
ADS board's JTAG/COP connector.

Once all the connections have been made, power up the ADS board and start the
OCD Commander executable on the host. 

1. Execute the reset command to initialize the board:

.CS
	> RESET
.CE

2. Click FLASH PGM.  Wait for the flash programmer to come up.

3. Click Program.  Wait for the programming menu.

4. Click Browse and select the bootrom_uncmp.hex file.

5. Select "Erase Target Flash Sectors Before Programming".

6. Change the "Start Programming at Flash Address:" value to 0xfff00000. 

7. Click Program.  The software will erase the flash, then program it,
and finally will say Program/Verify Complete.

.SS "2. Using vxWorks"
Booting VxWorks as detailed below, and then using VxWorks to read the
bootrom image from a host and to program it into Flash Rom

This is explained below:

1. Boot VxWorks as detailed below

2. Configure and start the Tornado target server on the host.

3. On the host, prepare a hex image of the bootrom. On a Unix host:
.CS
	make bootrom_uncmp.bin
	cp bootrom_uncmp.bin /tmp
	ls -l /tmp/bootrom_uncmp.bin
.CE
Note the number of bytes given by the last step

4. Using a VxWorks shell, read and program the image. Replace the number
of bytes (359044 below) with the size of your image. Make sure the allocated
buffer is large enough:
.CS
	sysFlashErase 0
	fd1 = open ("/tmp/bootrom_uncmp",2,0)
	p1 = malloc (0x100000)
	read (fd1, p1, 359044)
	sysFlashWrite (p1, 359044, 0,0)
.CE

Note that the offset on the PILOT rev board will have to be 
(0xfff00000 - FLASH_ADRS). See ROM considerations below.

5. At this point the VxWorks bootrom is programmed into Flash rom. Resetting
the board should yield the familiar VxWorks boot screen.

.SS "Jumpers on PILOT board revision"
.LP
The baud rate generator assumes a 40 MHz or 66 MHz system clock and a
CPM multiplication factor of 2. Although the PILOT board
supports reading the Hard Reset Configuration Word from Flash
or from the BCSR, the currently shipping Pilot Board has a
processor XPC8260 rev. 0.2, which does not support reading
the Flash at Power-on or Hard reset and so must be set to
use BCSR. This setting and the CPM multiplication factor is
programmed on DS1, as follows:
.TS
center;
l l
l l.
Label   	Position
_
FLASH/BCSR	Off
MODCKH 0	On
MODCKH 1	Off
MODCKH 2	On
MODCKH 3	Off
MODCK  1	Off
MODCK  2	Off
MODCK  3	Off
.TE

If the system clock is 33 MHz then the DIP switch MODCKH 1 (position 3)
should be set to Off.

On revision PILOT of the ADS8260 board, there is a new JTAG machine inserted
in front of the MPC8260's COP/JTAG port to provide fast download 
capability for the ADS. Via J5 it is possible to bypass the new JTAG machine
to be compatible with the ENG rev of the board. In the tested configuration,
a jumper is placed between positions 1-2 of J5 to enable the new JTAG
machine. 

.SH "FEATURES"

.SS "Supported Features (PILOT board revisions)"

SCC1 and SCC2 as a UART

FCC2 as an Ethernet device supporting 10BaseT and 100BaseT protocol

Interrupt Controller

System Clock

Baud Rate Generators as required for SCC1 and SCC2

16 MByte SDRAM DIMM on 60x bus (32 and 64 MByte configurations have not 
been tested)

DMA as required only for SCC1, SCC2, and FCC2

Auxiliary clock and timestamp clock

8 MByte Flash module (16 and 32 MByte configurations have not been tested)

Flash read and write capability

Instruction and Data caches


.SS "Unsupported Features (PILOT board revisions)"

virtual DMA

Parallel Ports

Baud Rate Generators not used by supported devices

SPI

I2C

4MByte SDRAM on local bus. 

Reset capability or options

SCC1 and SCC2 in any mode other than UART

SCC3 and SCC4

ATM, Transparent, or HDLC protocols on FCC2 

FCC1 and FCC3

MCC1 and MCC2

SMC1 or SMC2

Any of the eight TDM interfaces

Support for the PCI bridge (hardware not available yet)

Support for the L2 cache (hardware not available yet)

Support for the two 96 DIN connectors 
(Voyager Tools Board connector and Expansion connector) 
which bring out all pins on the MPC8260 chip

.SS "Feature Interactions"
None known

.SH "HARDWARE DETAILS"
This section documents the details of the device drivers and board
hardware elements.

.SS "Devices"
The chip drivers included are:

    m8260Flash.c - flash memory driver
    m8260Sio.c - serial driver
    m8260IntrCtl.c - interrupt controller driver
    m8260Timer.c - timer driver
    motFccEnd.c - FCC Ethernet END driver
    miiLib.c - Media Independent Interface library

The BSP configures both SCC1 and SCC2 as UART devices. 
SCC1 is used as a console device.
FCC2 is used as an ethernet port. 

.SS "Memory Maps"
.LP
The following table describes the ads8260 default memory map:
.TS E
allbox expand;
lf3 lf3 lf3 lf3
l l l l .
.ne 6
.sp .5
Start	Size	End	Access to
_
0x0000_0000	16MB	0x00FF_FFFF	SDRAM DIMM on 60X bus
0x0100_0000	48MB	0x03FF_FFFF	T{
Unused (partially used when optional 32MB DIMM
is installed, and fully used when optional 64MB DIMM
is installed in place of standard 16MB DIMM)
T}
0x0400_0000	4MB	0x043F_FFFF	T{
Soldered SDRAM on local (1) bus (unsupported)
T}
0x0440_0000	1MB	0x044F_FFFF	Unused
0x0450_0000	32KB	0x0450_7FFF	T{
Board Control and Status Registers
(BCSR0 through BCSR7 on PILOT revision)
T}
0x0450_8000		0x045F_FFFF	Unused
0x0460_0000	32KB	0x0460_7FFF	ATM (unsupported)
0x0460_8000		0x046F_FFFF	Unused
0x0470_0000	64KB	0x0471_FFFF	T{
MPC 8260 Internal Memory 
(see MPC8260 PowerQUICC II User's Manual, 
Chapter 3, Memory Map, and
Chapter 13, CPM Overview, for further details, 
and see Parameter Ram below)
T}
0x0472_0000		0xFCFF_FFFF	Unused
0xFD00_0000	32MB	0xFFFF_FFFF	Flash SIMM (size optional)
.TE

.LP
The following table describes the ads8260 default usage
of the MPC8260's internal Parameter Ram, sometimes also 
called Data/Parameter Ram or DPRAM:
.TS E
allbox expand;
lf3 lf3 lf3 lf3
l l l l .
.ne 6
.sp .5
Start	Size	End	Description
_
0x0470_0000	8 bytes	0x0470_0007	SCC1 Receive Buffer Descriptor
0x0470_0000	2 bytes	0x0470_0001	SCC1 Receive Buffer Status
0x0470_0002	2 bytes	0x0470_0003	SCC1 Receive Buffer Length
0x0470_0004	4 bytes	0x0470_0007	pointer to SCC1 Receive Buffer 
0x0470_0008	8 bytes	0x0470_000F	SCC1 Transmit Buffer Descriptor
0x0470_0008	2 bytes	0x0470_0009	SCC1 Transmit Buffer Status
0x0470_000A	2 bytes	0x0470_000B	SCC1 Transmit Buffer Length
0x0470_000C	4 bytes	0x0470_000F	pointer to SCC1 Transmit Buffer 

0x0470_0040	1 bytes	0x0470_0040	SCC1 Receive Buffer 
0x0470_0060	1 bytes	0x0470_0060	SCC1 Transmit Buffer 

0x0470_0100	8 bytes	0x0470_0107	SCC2 Receive Buffer Descriptor
0x0470_0100	2 bytes	0x0470_0101	SCC2 Receive Buffer Status
0x0470_0102	2 bytes	0x0470_0103	SCC2 Receive Buffer Length
0x0470_0104	4 bytes	0x0470_0107	pointer to SCC2 Receive Buffer 
0x0470_0108	8 bytes	0x0470_010F	SCC2 Transmit Buffer Descriptor
0x0470_0108	2 bytes	0x0470_0109	SCC2 Transmit Buffer Status
0x0470_010A	2 bytes	0x0470_010B	SCC2 Transmit Buffer Length
0x0470_010C	4 bytes	0x0470_010F	pointer to SCC2 Transmit Buffer 

0x0470_0140	1 bytes	0x0470_0140	SCC2 Receive Buffer 
0x0470_0160	1 bytes	0x0470_0160	SCC2 Transmit Buffer 
.TE

.LP
The following table describes the default VxWorks macros which
are used to address memory
.TS E
expand;
lf3 lf3 lf3
l l l .
.ne 6
.sp .5
Macro Name	Macro Definition	Description
_
LOCAL_MEM_LOCAL_ADRS	0x0000_0000	Base of RAM
RAM_LOW_ADRS	T{
LOCAL_MEM_LOCAL_ADRS + 0x0001_0000
T}	T{
VxWorks image loaded here. Stack grows down from this address.
T}
RAM_HIGH_ADRS	T{
LOCAL_MEM_LOCAL_ADRS + 0x00d0_0000
T}	T{
VxWorks bootrom loaded here.
T}
LOCAL_MEM_SIZE	0100_0000	Default 16 MBytes of RAM
BCSR_BASE_ADRS	0450_0000	T{
Default location of Board Control and Status Registers on PILOT rev
T}
BCSRS_SIZE	0001_0000	64 KBytes on PILOT rev
DEFAULT_IMM_ADRS	0470_0000	T{
Default location of MPC 8260 Internal Memory Map
T}
IMM_SIZE	0x20000	T{
128K Internal Memory Map Size
T}
ROM_BASE_ADRS	0xFFF0_0000	Base address of ROM on PILOT rev
ROM_TEXT_ADRS	T{
ROM_BASE_ADRS + 0x100
T}	T{
Text must start after vector table
T}
ROM_WARM_ADRS	T{
ROM_TEXT_ADRS + 8
T}	Warm Reboot Entry Address
ROM_SIZE	0x0010_0000	Default 1 MByte of ROM on PILOT rev (see ROM considerations)
.TE
.sp