PM8621-BI PMC-Sierra, Inc., PM8621-BI Datasheet - Page 146

• Manufacturer Part Number: PM8621-BI
• Description: Driver, NSE/SBS Narrowband Chipset Driver
• Manufacturer: PMC-Sierra, Inc.

Proprietary and Confidential to PMC-Sierra, Inc., and for its Customers’ Internal Use
Document ID: PMC-2021248, Issue 1
Valid States
Side Effects
Retrieving Changed Setting of the Connection Map: nbcsFmgtGetChgMap
This function allows user to retrieve the changed (or delta) connection setting of the device(s) as a
result of new call connection setup, and protection switchover activities. The user should call this
function repeatedly until no further settings are returned (indicated by the
the structure, a zero denotes there is no more settings). It is imperative to retrieve all changed
settings of a particular type (e.g., call connection settings) once it has started until its completion
(this condition is denoted by the field
switchover settings) can be retrieved to preserve data integrity. The function returns an error code
if an attempt is made to retrieve settings of different type prior to completely retrieving changed
settings of another type. It is, however, not necessary to retrieve changed settings immediately
after every single operation (such as a call setup request). User can delay the retrieval until after
several operations (such as multiple call requests) as long as no retrieval has been started.
The structure
only input parameters in the structure are
beginning of the three buffers for the device settings. The rest of the fields in the structure are
filled in by the CSD as output parameters. These include
for further device identification (ingress or egress for SBS device, and port number for NSE
device),
indicating what access mode to use,
summary of the definition of all fields in the structure.
If the corresponding fields,
set, the changed settings are written to the standby (offline) pages of the devices and the settings
will not be copied to the user-specified buffers (
settings are copied to their respective buffers without being written to the standby pages of the
devices.
Table 58: Narrowband Chipset Connection Map Header Definition – Changed Map
Fields
devHndl
devId
devType
devNum1
devType
conMapHdr
NBCS_ACTIVE, NBCS_INACTIVE
None
I/O
output
output
output
output
for the type for device,
NBCS_ERR_INVALID_SYS_CONFIG
NBCS_FAILURE
serves both as the input and output between user and the CSD. The
sbsAutoUpdate
SBS
device handle
0 = ingress, 1 = egress
NBCS_SBS or
NBCS_SBSLITE
user number of the device
pBuf
numSetting
pBuf, pBuf2, and pBuf3
,
accMode
pBuf2
, and/or
pBuf, pBuf2 and pBuf3
,
pBuf3
= 0) before other types (such as protection
for used in API
nseAutoUpdate
Narrowband Chipset Device Driver Manual
devHndl
NSE
device handle
port number: 0-11/31 for NSE-8/20G
NBCS_NSE20G or NBCS_NSE8G
user number of the device
are pointers to buffers. Table 58 gives a
for the device handle,
Application Programming Interface
nbcsStswMapSlot
, which indicate the
(specified by MIV) are
numSetting
). Otherwise, the
field in
devId
146