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

• 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
Prototype
Inputs
Outputs
Returns
Switching Over a Port Protection: nbcsFmgtSwitchProtect
This function switches traffic over for a current 1+1 and 1:N port protection or switches virtual
paths in a UPSR. In a 1+1 port protection, this function swaps traffic between active and inactive
ports. If at the time of the request the working port is active, then this function swaps traffic to the
protection port and makes it active. In the 1:N port protection case, this function swaps traffic
from the working port (if currently active) to the protection port which then becomes active. If the
protection port is currently active protecting other working ports, then this call fails. Calling this
function to switch traffic over from the protection port back to the working port always succeeds.
The handle of the working port should be given (via
protection to working port.
The pending active port after the switch over is returned via argument
NULL for this parameter is given, no active port information will be returned. The parameter,
numSlots, is ignored when performing 1+1 or 1:N port protection switchover.
This function also performs paths switchover in the context of UPSR. When dropping traffic from
a UPSR, it is by default from the working path. In the event of a signal degradation in the
working path, traffic will instead be dropped from the protect path. One or more protected
connections (the total is specified by
sbsSlot
over to the protect path from the active one. The function returns an error code if the first path
does not originate from a SBS defined in UPSR protection. (Hence, the handles in the
array for subsequent entries can be left unfilled.). If the parameter
NULL, the pending active path of the first tributary (i.e., the first entry in the
after a UPSR path switchover will be returned in this parameter.
. All destinations currently drawing traffic from the specified path(s) will be switched
NBCS_INACTIVE, NBCS_ACTIVE, NBCS_PRESENT
None
INT4 nbcsFmgtSwitchProtect(sNBCS_SLOT* sbsSlot,
UINT2 numSlots, sNBCS_SLOT* activeSbsSlot)
sbsSlot
numSlots
activeSbsSlot
activeSbsSlot
Success =
Failure =
NBCS_ERR_INVALID_SYS_CONFIG
NBCS_ERR_OPA_PROTECT_NONEXISTENT
NBCS_ERR_OPA_PROTECT_1FORN
NBCS_ERR_INVALID_SYS_CONFIG
NBCS_ERR_INVALID_SWITCHOVER
NBCS_ERR_INVALID_DEV
NBCS_SUCCESS
numSlots
: pointer to (array of) tributaries for
: number of paths to switchover
: pointer to device handle for active port
: pointer to device handle for active port
switchover
) dropped from the UPSR can be specified by
sbsSlot
Narrowband Chipset Device Driver Manual
) when switching traffic back from
activeSbsSlot
Application Programming Interface
activeSbsSlot.
sbsSlot
is non-
sbsSlot
array)
If a
153