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

• 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
Prototype
Inputs
Reading from a block of Device Registers: nbcsReadBlock
This function is used to read a register block of a specific Narrowband Chipset device by
providing the starting register number and the size to read. This function derives the actual start
address location based on the device handle and starting register number inputs. It then reads the
contents of this data block from the device. Note that a failure to read returns a zero and that any
error indication is written to the CSDDB. It is the user’s responsibility to allocate enough memory
for the block read.
Writing to a Block of Device Registers: nbcsWriteBlock
This function is used to write to a register block of a specific Narrowband Chipset device by
providing the starting register number and the block size. This function derives the actual starting
address location based on the device handle and starting register number inputs. It then writes the
contents of this data block to the actual device. A bit from the passed block is only modified in the
device’s registers if the corresponding bit is set in the passed mask. Note that any error indication
is written to the CSDDB.
Prototype
Inputs
Outputs
Returns
Valid States
Side Effects
UINT4 nbcsReadBlock(sNBCS_HNDL handle, UINT2
startRegNum, UINT2 size, UINT4 *pblock)
handle
startRegNum
size
pblock
ERROR code written to the CSMDB
pblock
Success = Last register value read
Failure = 0
NBCS_PRESENT, NBCS_ACTIVE, NBCS_INACTIVE
Can affect registers that change after a read operation
UINT4 nbcsWriteBlock(sNBCS_HNDL handle, UINT2
startRegNum, UINT2 size, UINT4 *pblock, UINT4
*pmask)
handle
startRegNum
size
pblock
pmask
NBCS_ERR_INVALID_DEV
NBCS_ERR_DEV_ABSENT
NBCS_ERR_INVALID_REG
: device handle (from
: starting register number
: size of the block to read
: (pointer to) the block to read
: (pointer to) the block read
: device handle (from
: starting register number
: size of block to read
: (pointer to) block to write
: (pointer to) mask
Narrowband Chipset Device Driver Manual
nbcsAdd
nbcsAdd
Application Programming Interface
)
)
115