AN2345 Freescale Semiconductor / Motorola, AN2345 Datasheet - Page 12

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

VSMM Distribution
3.1 VSMM Documentation
3.2 VSMM Object Library
3.3 VSMM Configuration ‘C’ Source File
12
The VSMM Reference Manual[5] describes the common symptoms of general memory managers and
presents a high-level overview of the VSMM architecture and a reference guide to the VSMM features. A
VSMM User’s Guide[4] provides additional information for tailoring and incorporating VSMM in your
applications. An Interface Control Document (ICD) is also provided for each VSMM routine. These
ICDs provide the following information on each routine:
• Function prototype. Function name and parameter list.
• Functional description. Brief summary of the primary function of each module.
• Interface. Lists all programmer-defined data types used by this module.
• Argument description. Lists arguments and briefly describes the data types defined within the interface
• Design and implementation notes. Summarizes algorithms, handling methods, and implementation
• Performance. Describes code size, data size, and cycles required.
• Precision. Describes any precision limitations
The primary component of the VSMM distribution is the VSMM object library,
VSMMLibrary1_3.elb. This library contains the entire suite of VSMM routines and was built using
Metrowerks® Codewarrior® v2.02 targeted for the Motorola StarCore DSPs. The library was built using
Level 3 optimization, which implements several general, target-independent optimizations. The output
from the target-independent optimizations is linear assembly code. The Codewarrior librarian grouped
these object files into a linkable library.
The VSMM ‘C’ source file, VSMM_cfg.c, is provided so that programmers can tailor VSMM to their
applications. Configurable parameters supported by the use of this file include:
• Enabling or disabling parameter verification within each VSMM routine. Setting the
VSMM Object Library
VSMM Configuration Source File
VSMM Configuration Header File
VSMM DSP Setup File
VSMM General Header File
VSMM Master Include File
VSMM Enter Critical Method 2 Source
VSMM Exit Critical Method 2 Source
VSMM Non-RTOS Example Archive
VSMM OSEck RTOS Example Archive
section.
issues.
gucVSMM_ARG_CHK_EN global constant to 1 enables parameter verification, which ensures that all
Freescale Semiconductor, Inc.
Item Description
For More Information On This Product,
Go to: www.freescale.com
Table 4. VSMM Released Items (Continued)
VSMMLibrary1_3.elb
VSMM_cfg.c
VSMM_cfg.h
VSMM_dsp.h
VSMM.h
VSMM_Includes.h
VSMMEnterCritical.asm
VSMMExitCritical.asm
VSMMExamplesCR1_3.zip
VSMMExampleRTOS2.zip
Item Identification