target.nr

WINDRIVER MCP750 BSP

"node 0".  The "host node" may or may not be the "master node".  Note
also that the "host node" need not necessarily be a VxWorks node.

Below are the crucial "config.h" parameters involved in shared memory:

.IP "SM_OFF_BOARD (TRUE or FALSE):"
The parameter has a configurable value of either TRUE or FALSE
and directly determines the value of SM_ANCHOR_ADRS (the anchor
address).
  
If SM_OFF_BOARD is defined as FALSE, then the anchor is on-board
and SM_ANCHOR_ADRS is defined to be
LOCAL_MEM_LOCAL_ADRS + SM_ANCHOR_OFFSET.
LOCAL_MEM_LOCAL_ADRS is defined as 0x0 in "config.h" and
SM_ANCHOR_OFFSET is defined as 0x4100 in "config.h".
  
If defined as TRUE, then SM_ANCHOR_ADRS is defined as a function
call: sysSmAnchorAdrs() (defined in "sysLib.c").  This function
will dynamically poll, at system startup, various locations
(explained below) for the exact location of the shared memory
anchor.
  
Note that if "sm=xxxxxxxx" is used as a boot parameter, then
SM_OFF_BOARD has no effect.  The value of "xxxxxxxx" will be used
as the anchor location regardless of the setting of SM_OFF_BOARD.
If simply "sm" is used as a boot parameter, then SM_OFF_BOARD is
queried at initialization time to determine if polling is required
or not.

.IP "SYS_SM_SYSTEM_MEM_POLL (#define or #undef):"
This define only has an effect if anchor polling is called for
(because SM_OFF_BOARD is defined as TRUE and "sm" is used with no
"=xxxxxxxx").  In this case, simply defining SYS_SM_SYSTEM_MEM_POLL
will cause the node to poll for the anchor at compact PCI bus
address PCI2DRAM_BASE_ADRS + SM_ANCHOR_OFFSET (0x80004100).
"System memory" (which is the host node's DRAM) will
be included as one of the locations where the anchor might reside.
Note that other locations my be polled as well (explained later).

Not defining SYS_SM_SYSTEM_MEM_POLL will prevent the polling of
system  memory for the anchor.

.IP "SYS_SM_ANCHOR_POLL_LIST (#define or #undef):"
This define has an effect only if polling is called for (see
SM_OFF_BOARD explained above).  When defined,
SYS_SM_ANCHOR_POLL_LIST allows a list of devices, identified by
device/vendor ID and subsystem ID/subsystem vendor ID to be
specified as candidates for the anchor location.  Devices which
appear directly on the compact PCI bus are found and if they
appear on the list defined by SYS_SM_ANCHOR_POLL_LIST, they are
checked to see if they house the shared memory anchor.  The memory
defined by the first memory BAR is queried at offset
SM_ANCHOR_OFFSET (0x4100 by default, defined in "configAll.h").  If
SYS_SM_ANCHOR_POLL_LIST is not defined, ALL devices on the compact
PCI bus will be considered candidates for the anchor location and
will be polled.  If SYS_SM_ANCHOR_POLL_LIST defined but empty, NO
devices on the compact PCI bus will be considered candidates for
the anchor location.  In that case, the only location polled would
be system memory if SYS_SM_SYSTEM_MEM_POLL (see above) was defined.

.IP "SYS_SM_DEVICE_LIST"
This define lists the Dec2155x-based cPCI boards which support shared memory by
PCI Subsystem Vendor ID and Subsystem ID. To recognize a new Dec2155x-based
cPCI board as a participant in the shared memory subsystem, simply add a new
entry to this list.

.IP "INCLUDE_SM_SEQ_ADDR (#define or #undef)"
If "undef'ed", sequential addressing is disabled.  This symbol
is defined by default.
.LP

Consider a system consisting of an MCP750 (host node) and two MCPN750s.
The following six configurations are the only ones possible:

.TS E
expand;
lf3 lf3 lf3 lf3
l l l l .
.ne 8
.sp .5
	Master node on...	Anchor on...	Sequential Addressing?
_
1.	MCP750	MCP750	NO
2.	MCP750	MCP750	YES
3.	MCPN750	MCP750	NO
4.	MCPN750	MCP750	YES
5.	MCPN750	MCPN750	NO
6.	MCPN750	MCPN750	YES
.TE

Below is a description of how each of the above systems would be
configured.  Crucial "config.h" and boot parameter settings for an
example system are given.  In each example, SYS_SM_ANCHOR_POLL_LIST
was defined to contain information identifying the Dec21554 bridge
chip (present on the MCPN750).  See "config.h" for the example of
how this was done.

.ne 6
.IP "1)"
MCP750 master, MCP750 anchor, no sequential addressing:
.CS

   MCP750:

        #define SM_OFF_BOARD FALSE
        #undef  SYS_SM_SYSTEM_MEM_POLL
        #undef  INCLUDE_SM_SEQ_ADDR

        boot device          : dc
        host name            : sunray
        processor number     : 0
        inet on ethernet (e) : 124.170.16.112
        inet on backplane (b): 124.200.200.1:ffffff00
        host inet (h)        : 124.170.16.143
        gateway inet (g)     : 124.170.16.233
        target name (tn)     : gamma

   MCPN750-1:

        #define SM_OFF_BOARD TRUE
        #define SYS_SM_SYSTEM_MEM_POLL
        #undef  INCLUDE_SM_SEQ_ADDR

        boot device          : sm
        host name            : sunray
        processor number     : 1
        inet on ethernet (e) : 124.170.16.109
        inet on backplane (b): 124.200.200.2
        host inet (h)        : 124.170.16.143
        gateway inet (g)     : 124.200.200.1
        target name (tn)     : alpha

   MCPN750-2:

        (same "config.h" setup as MCPN750-1 above)

        boot device          : sm
        host name            : sunray
        processor number     : 2
        inet on ethernet (e) : 124.170.16.110
        inet on backplane (b): 124.200.200.3
        host inet (h)        : 124.170.16.143
        gateway inet (g)     : 124.200.200.1
        target name (tn)     : beta
.CE

.ne 6
.IP "2)"
MCP750 master, MCP750 anchor, sequential addressing:
.CS

   MCP750:

        #define SM_OFF_BOARD FALSE
        #define SYS_SM_CPCI_BUS_NUMBER    1
        #undef SYS_SM_SYSTEM_MEM_POLL
        /* #undef INCLUDE_SM_SEQ_ADDR */

        boot device          : dc
        host name            : sunray
        processor number     : 0
        inet on ethernet (e) : 124.170.16.112:ffffff00
        inet on backplane (b): 124.200.200.1:ffffff00
        host inet (h)        : 124.170.16.143
        gateway inet (g)     : 124.170.16.233
        target name (tn)     : gamma


   MCPN750-1:

         #define SM_OFF_BOARD TRUE
        #define SYS_SM_CPCI_BUS_NUMBER    1
        #define SYS_SM_SYSTEM_MEM_POLL
        /* #undef INCLUDE_SM_SEQ_ADDR */

        boot device          : sm
        host name            : sunray
        processor number     : 1
        inet on ethernet (e) :
        inet on backplane (b):
        host inet (h)        : 124.170.16.143
        gateway inet (g)     :
        target name (tn)     : alpha


   MCPN750-2:

        (same "config.h" setup as MCPN750-1 above)

        boot device          : sm
        host name            : sunray
        processor number     : 2
        inet on ethernet (e) :
        inet on backplane (b):
        host inet (h)        : 124.170.16.143
        gateway inet (g)     :
        target name (tn)     : beta
.CE

.ne 6
.IP "3)"
MCPN750 master, MCP750 anchor, no sequential addressing:
.CS

   MCP750:

        #define SM_OFF_BOARD TRUE
        #undef  SYS_SM_SYSTEM_MEM_POLL
        #undef  INCLUDE_SM_SEQ_ADDR

        boot device          : sm
        host name            : sunray
        processor number     : 1
        inet on ethernet (e) : 124.170.16.112
        inet on backplane (b): 124.200.200.1
        host inet (h)        : 124.170.16.143
        gateway inet (g)     : 124.200.200.2
        target name (tn)     : gamma

   MCPN750-1:

        #define SM_OFF_BOARD FALSE
        #define SYS_SM_SYSTEM_MEM_POLL
        #undef  INCLUDE_SM_SEQ_ADDR

        boot device          : dc
        processor number     : 0
        host name            : sunray
        inet on ethernet (e) : 124.170.16.109
        inet on backplane (b): 124.200.200.2:ffffff00
        host inet (h)        : 124.170.16.143
        gateway inet (g)     : 124.170.16.233
        target name (tn)     : alpha

   MCPN750-2:

        #define SM_OFF_BOARD TRUE
        #define SYS_SM_SYSTEM_MEM_POLL
        #undef  INCLUDE_SM_SEQ_ADDR

        boot device          : sm
        processor number     : 2
        host name            : sunray
        inet on ethernet (e) : 124.170.16.110
        inet on backplane (b): 124.200.200.3
        host inet (h)        : 124.170.16.143
        gateway inet (g)     : 124.200.200.2
        target name (tn)     : beta
.CE

.ne 6
.IP "4)"
MCPN750 master, MCP750 anchor, sequential addressing:
.CS

   MCP750:

        #define SM_OFF_BOARD TRUE
        #undef  SYS_SM_SYSTEM_MEM_POLL
        /* #undef  INCLUDE_SM_SEQ_ADDR */

        boot device          : sm
        processor number     : 1
        host name            : sunray
        inet on ethernet (e) :
        inet on backplane (b):
        host inet (h)        : 124.170.16.143
        gateway inet (g)     :
        target name (tn)     : gamma


   MCPN750-1:

        #define SM_OFF_BOARD FALSE
        #define SYS_SM_CPCI_BUS_NUMBER    1
        #define SYS_SM_SYSTEM_MEM_POLL
        /* #undef  INCLUDE_SM_SEQ_ADDR */

        boot device          : dc
        processor number     : 0
        host name            : sunray
        inet on ethernet (e) : 124.170.16.109:ffffff00
        inet on backplane (b): 124.200.200.1:ffffff00
        host inet (h)        : 124.170.16.143
        gateway inet (g)     : 124.170.16.233
        target name (tn)     : alpha

   MCPN750-2:

        #define SM_OFF_BOARD TRUE
        #define SYS_SM_CPCI_BUS_NUMBER    1
        #define SYS_SM_SYSTEM_MEM_POLL
        /* #undef  INCLUDE_SM_SEQ_ADDR */

        boot device          : sm
        processor number     : 2
        host name            : sunray
        inet on ethernet (e) :
        inet on backplane (b):
        host inet (h)        : 124.170.16.143
        gateway inet (g)     :
        target name (tn)     : beta
.CE

.ne 6
.IP "5)"
MCPN750 master, MCPN750 anchor, no sequential addressing:
.CS

   MCP750:

        #define SM_OFF_BOARD TRUE
        #undef  SYS_SM_SYSTEM_MEM_POLL
        #undef  INCLUDE_SM_SEQ_ADDR

        boot device          : sm
        processor number     : 1
        host name            : sunray
        inet on ethernet (e) : 124.170.16.112
        inet on backplane (b): 124.200.200.1
        host inet (h)        : 124.170.16.143
        gateway inet (g)     : 124.200.200.2
        user (u)             : ball
        ftp password (pw) (blank = use rsh):
        flags (f)            : 0x0
        target name (tn)     : gamma


   MCPN750-1:

        #define SM_OFF_BOARD FALSE
        #undef  SYS_SM_SYSTEM_MEM_POLL
        #undef  INCLUDE_SM_SEQ_ADDR