Creating a Catalog Item that Represents a Device Driver
Other versions of this page are also available for the following:
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
8/27/2008
This topic describes how to create and set properties for an item in a Catalog file so that it can represent a device driver in the Platform Builder Catalog.
To create a Catalog item, you must have already created a Catalog file. For more information, see Using the Catalog Editor to Create a Catalog File.
To create a Catalog item that represents a device driver
In Catalog Editor, choose the Add arrow, and then choose Catalog Item.
Browse to the new Catalog item and select it.
The Properties window displays the property settings for the selected Catalog item in the .pbcxml file.
Click in the box next to Supported CPUs, select which CPUs will support your device driver, and then choose OK. In this example, select x86.
Click in the box next to Type, and then choose the Catalog item group to which you want to add the device driver. In this example, choose General.
In the box next to Title, type a name for the Catalog item that you want to add to the Catalog. In this example, type "My Device Driver".
In the box next to Unique Id, type a unique ID for the Catalog item that follows the expected format. If the device driver can be used with various board support packages (BSPs), you can use the format Item:VENDOR:SYSGEN. If the device driver is BSP-specific, you can use the format Item:VENDOR:MODULE:BSPDIR. In this example, type "MyDriver:MyCompany:sysgen_my_driver".
Click in the box next to Modules. Type the full name of each file that represents a module that implements the functionality of this driver. For example, type "MyDriver.dll". Choose OK.
Click in the box next to Modules. Type the full name of each file that represents a module that implements the functionality of this driver. For example, type "MyDriver.dll". Choose OK.
In the box next to Sysgen variable, type a Sysgen variable for your selectable Catalog item. For example, type "SYSGEN_MY_DRIVER".
Add any additional property values that you want for the Catalog item. For more information about property values, see Catalog Item Properties.
If you want to add a link to driver source code, add a source-code link to the Catalog item. This source-code link is for display purposes only. For more information, see Adding a Source Code Link to a Catalog File.
On the File menu, choose Save <MyCatalogFile>.pbcxml.
See Also
Tasks
Using the Catalog Editor to Create a Catalog File
How to Add a Device Driver to the Catalog