Specifications

124 www.xilinx.com Embedded System Tools Guide (EDK 6.2i)
1-800-255-7778 UG111 (v1.4) January 30, 2004
Chapter 7: Library Generator
R
For more information about the Tcl procedures and MDD/MLD related parameters, refer
to chapter Chapter 21, “Microprocessor Driver Definition (MDD)” and Chapter 20,
“Microprocessor Library Definition (MLD)”.
MSS Parameters
For a complete description of the MSS format and all the parameters that MSS supports,
refer to Chapter 19, “Microprocessor Software Specification (MSS)”.
Drivers
Most peripherals require software drivers. The EDK peripherals are shipped with
associated drivers, libraries and BSPs. Refer to “Device Driver Programmer Guide”
chapter in the Processor IP Reference Guide for more information on driver functions.
The MSS file includes a driver block for each peripheral instance. The block contains a
reference to the driver by name (DRIVER_NAME parameter) and the driver version
(DRIVER_VER). There is no default value for these parameters. A driver LEVEL is also
specified depending on the driver functionality required. The driver directory contains C
source and header files for each level of drivers and a makefile for the driver.
A Driver has an MDD file and/or a Tcl file associated with it. The MDD file for the driver
specifies all configurable parameters for the drivers. This is the data definition file. Each
MDD file has a corresponding Tcl file associated with it. This Tcl file generates data that
includes generation of header files, generation of C files, running DRCs for the driver and
generating executables. Refer to Chapter 21, “Microprocessor Driver Definition (MDD)”
and Chapter 19, “Microprocessor Software Specification (MSS)” for more information.
Users can write their own drivers. These drivers must be in a specific directory under
USER_PROJECT/drivers or library_name/drivers, as shown in Figure 7-1. The
DRIVER_NAME attribute allows the user to specify any name for their drivers, which is
also the name of the driver directory. The source files and makefile for the driver must be
in the src/ subdirectory under the driver_name directory. The makefile should have the
targets “include” and “libs”. Each driver must also contain an MDD file and a Tcl file in the
data/ subdirectory. Refer to the existing EDK drivers to get an understanding of the
structure of the drivers. Refer to Chapter 21, “Microprocessor Driver Definition (MDD)”
for details on how to write an MDD and its corresponding Tcl file.
Libraries
The MSS file now includes a library block for each library. The library block contains a
reference to the library name (LIBRARY_NAME parameter) and the library version
(LIBRARY_VER). There is no default value for these parameters. The library directory
contains C source and header files and a makefile for the library.
The MLD file for each driver specifies all configurable options for the drivers. Each MLD
file has a corresponding Tcl file associated with it. Refer to Chapter 20, “Microprocessor
Library Definition (MLD)” and Chapter 19, “Microprocessor Software Specification
(MSS)” for more information.
Users can write their own libraries. These libraries must be in a specific directory under
USER_PROJECT/sw_services or library_name/sw_services as shown in
Figure 7-1. The LIBRARY_NAME attribute allows the user to specify any name for their
libraries, which is also the name of the library directory. The source files and makefile for
the library must be in the src subdirectory under the library_name directory. The makefile