BSP Developer's Guide

B
Upgrading a BSP for Tornado 2.2
Changes in the Shared Memory Subsystem
A BSP for VxWorks 5.5 requires several modest changes to config.h and possibly
to sysLib.c in order to support the shared memory network and the optional
component VxMP. In past releases of VxWorks, you could ensure that the shared
memory components were included simply by verifying the inclusion of the
shared memory backplane network. But in VxWorks 5.5, VxMP can be configured
without support for the shared memory network.
A new component with the inclusion macro INCLUDE_SM_COMMON has been
added to VxWorks 5.5. Use this macro to test for shared memory support. The
majority of BSPs that support shared memory use conditional compilation
statements such as the following:
#ifdef INCLUDE_SM_NET
/* shared memory-specific code */
#endif
For VxWorks 5.5, these statements must be updated to test for
INCLUDE_SM_COMMON:
B
#ifdef INCLUDE_SM_COMMON
/* shared memory-specific code */
#endif
When you modify sysLib.c, follow the simple rule of replacing all instances of
INCLUDE_SM_NET with INCLUDE_SM_COMMON.
With a few exceptions, you can use the same rule in changing config.h. A test for
INCLUDE_SM_NET is still valid in network-related statements, but is not valid as
a test for the common shared memory parameters:
SM_ANCHOR_ADRS SM_ANCHOR_OFFSET SM_CPUS_MAX
SM_INT_ARG1 SM_INT_ARG2 SM_INT_ARG3
SM_INT_TYPE SM_MASTER SM_MAX_WAIT
SM_MEM_ADRS SM_MEM_SIZE SM_OBJ_MEM_SIZE
SM_OFF_BOARD SM_TAS_TYPE
These shared memory parameters do not require conditional compilation and can
be left defined at all times. (Note that some are defined by default in configAll.h
and must be undefined before being redefined in config.h.)
The definition of INCLUDE_SM_NET in config.h may also bring in components
that have changed in VxWorks 5.5, such as INCLUDE_NET_SHOW and
INCLUDE_BSD. These components are no longer needed; the smNetShow( )
routine is now in a separate component, called INCLUDE_SM_NET_SHOW, and
proper BSD or other network configuration is contained in other files.
213