AN2345 Freescale Semiconductor / Motorola, AN2345 Datasheet - Page 11

• Manufacturer Part Number: AN2345
• Description: Real-Time Memory Manager for StarCore DSPs
• Manufacturer: Freescale Semiconductor / Motorola

2.5 Data Control Block
3
VSMM Distribution
The data control block (DCB) is a 28-byte VSMM object used by the VSMM query routine to store
specific information about a heap. The VSMM DCB is defined as follows:
typedef struct {
} t_VSMM_MEM_DATA;
The VSMM distribution code is an official release that is available to all Motorola customers via their
marketing representative and the Motorola website listed on the back of this document. It contains all the
necessary components to build an application using the VSMM routines within an RTOS or non-RTOS
environment running the StarCore MSC81xx family of DSPs. Table 4 lists the items supplied with
VSMM distribution. The remainder of this section discusses the components provided in this distribution.
VSMMAddr
VSMMFreeList
VSMMBlkSize
VSMMNBlks
VSMMNFree
VSMMNUsed
VSMMHeapAddr
VSMM Reference Manual
VSMM User’s Guide
VSMM Interface Control Documents
VSMM Executive Summary
void
void
INT32U uliVSMMBlkSize;
INT32U uliVSMMNBlks;
INT32U uliVSMMNFree;
INT32U uliVSMMNUsed;
INT32U uliVSMMHeapAddr;
Variable
Freescale Semiconductor, Inc.
*pvVSMMAddr;
*pvVSMMFreeList;
For More Information On This Product,
Item Description
Go to: www.freescale.com
Table 3. VSMM Data Control Block Definition
A pointer to the base address of a heap.
A pointer to the next available free memory block within a heap.
The size of each block contained within a heap.
The number of blocks contained within a heap.
The number of memory blocks that are still available within a heap.
The number of memory blocks in use.
A pointer to a parent heap. If the heap associated with this MCB was created directly
from free memory, the value is NULL. Otherwise, if the heap was created from a
memory block associated with another heap, the value is this heap’s handle or
address.
Table 4. VSMM Released Items
VSMM_ReferenceManual.doc
VSMM_UsersGuide.doc
<routine>_ICD.doc
where <routine> is one of the following:
• Init
• Create
• AllocCreate
• Destroy
• Alloc
• Free
• Query
VSMMPresentation.ppt
Description
Item Identification
VSMM Distribution
11