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

• 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
Notifying the Application of Space/time Switch events: cbackStsw
This callback function is provided by the user and is used by the CSD to report space/time
switch-related events back to the application. This function should be non-blocking. Typically, the
callback routine sends a message to another task with the event identifier and other context
information. The task that receives this message can then process this information according to
the system requirements. Note: the callback function’s address is passed to the driver during the
nbcsModuleOpen
initialization, then no callback is made. The
the STSW event(s) encountered. The
indicating which space/time switch is causing the event(s).
Application is responsible for calling
the return of this function.
Notifying the Application of C1 Frame Pulse: cbackC1FP
This callback function is provided by the user and is used by the CSD to report arrival of C1FP
events back to the application. This function should be non-blocking and short because it is
invoked in the interrupt service routine (ISR) context. User should exercise caution when filling
in this callback function. For instance, it should not wait for any semaphores which creates a
blocking situation. Typically, the callback routine sends a message to another task with the event
identifier and other context information. The task that receives this message can then process this
information according to the system requirements. Note: the callback function’s address is passed
to the driver during the
as a NULL at initialization, then no callback is made. Since DPV buffer is not employed, there is
no need to call
function.
Prototype
Inputs
Outputs
Returns
Valid States
Side Effects
Prototype
Inputs
sysNbcsDPVBufferRtn
void cbackStsw(sNBCS_USR_CTXT usrCtxt,
sNBCS_DPV *pdpv)
usrCtxt
pdpv
None
None
NBCS_ACTIVE
None
void cbackC1FP(sNBCS_USR_CTXT usrCtxt, UINT4
rsv1, UINT4 rsv2)
usrCtxt
rsv1
call. If the address of the callback function was passed as a NULL at
nbcsModuleOpen
info
sysNbcsDPVBufferRtn
: user context (from
: (pointer to) DPV that describes
: user context (from
: reserved field 1
this event
to release the DPV buffer upon the return of this
call. If the address of the callback function was passed
field in the DPV is encoded as the switch descriptor
event
field in the DPV is a bit mask that reports all
Narrowband Chipset Device Driver Manual
nbcsAdd
nbcsAdd
to release the DPV buffer upon
Application Programming Interface
)
)
163