PM5365 PMC-Sierra, Inc., PM5365 Datasheet - Page 84

• Manufacturer Part Number: PM5365
• Description: TEMUX/TEMAP/TECT3 T1/E1 FRAMER, VT/TU MAPPER, M12/M13 MUX DRIVER MANUAL
• Manufacturer: PMC-Sierra, Inc.

7.2
Proprietary and Confidential to PMC-Sierra, Inc., and for its Customers’ Internal Use
Document ID: PMC-1991611, Issue 2
Buffer Management
All operating systems provide some sort of buffer system, particularly for use in sending and
receiving messages. Most operating systems provide both an internal set of buffers (usually small
in size) and functions that allow the user to create additional buffer pools (especially when the
buffer size needs to be large). It is the intention of this driver to use both types of buffers, the ISV
being the large buffer that carries the entire exception state of the device and the DPV being the
small buffer that carries individual block event flags and other simple bits of information.
The following calls, provided by the user, allow the driver to get and return these buffers from/to
the RTOS. It is the user’s responsibility to create any special resources or pools to handle buffers
of these sizes. This creation is done by the application when the driver calls the user-supplied
function
Starting Buffers: sysTemuxBufferStart
This function alerts the RTOS that the time has come to make sure ISV buffers and DPV buffers
are available and sized correctly. This may involve the creation of new buffer pools and it may
involve nothing, depending on the RTOS.
Getting DPV Buffers: sysTemuxDPVBufferGet
This function gets a buffer from the RTOS that will be used by the DPR code to create a DPR
Vector (DPV). The DPV consists of information about the state of the device that is to be passed
to the user via a callback function.
Prototype
Inputs
Outputs
Returns
Prototype
Inputs
Outputs
Returns
sysTemuxBufferStart
sysTemuxBufferStart (void)
None
None
Success =
Failure = <any other value>
sysTemuxDPVBufferGet (void)
None
None
Success = (pointer to) a DPV buffer
Failure = NULL (pointer)
0x00
TEMUX/TEMAP/TECT3 (PM8315, PM5365, PM4328) Driver Manual
.
RTOS Interface
84