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

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

5.9
Proprietary and Confidential to PMC-Sierra, Inc., and for its Customers’ Internal Use
Document ID: PMC-2021248, Issue 1
Outputs
Returns
Valid States
Side Effects
Status and Counts Functions
Reading the Device Counters: nbcsStatsGetCounts
This function retrieves all the device counts. This routine should be called by the application
code, in the context of a task. It is the user’s responsibility to ensure that this function is called
often enough to prevent the device counts from saturating or rolling over. This function also
operates in the context of a group. The buffer pointed to by
all the returned counts of the members in the group.
Getting the Current Status: nbcsStatsGetStatus
This function retrieves a snapshot of the current status from the device registers. This involves
retrieving current alarms, status, and clock activity. It also operates in the context of a group. It is
the user’s responsibility to ensure the buffer indicated by
returned status of the members in the group.
Prototype
Inputs
Outputs
Returns
Valid States
Side Effects
None
Success =
Failure =
NBCS_ACTIVE
None
INT4 nbcsStatsGetCounts(sNBCS_HNDL handle,
sNBCS_CNTR *pCntr)
handle
pCntr
pCntr
Success =
Failure =
NBCS_ACTIVE, NBCS_INACTIVE
None
NBCS_ERR_INVALID_DEVICE_STATE
NBCS_ERR_INVALID_ARG
NBCS_ERR_INVALID_DEV
NBCS_SUCCESS
NBCS_SUCCESS
NBCS_ERR_INVALID_DEV
NBCS_ERR_INVALID_DEVICE_STATE
NBCS_ERR_DEV_ABSENT
: device/group handle (from
: allocated memory for counts
: current device counts
or nbcsGroupAdd
Narrowband Chipset Device Driver Manual
pStatus
pCntr
)
should be large enough to hold
is large enough to hold all the
Application Programming Interface
nbcsAdd
157