Share via


Catalog Item Management (Compact 2013)

3/26/2014

In Platform Builder, the Catalog Items View window shows all the catalog items that you can add to the OS design (.pbxml) file, including board support packages (BSPs), core OS features, transport layers, and device drivers. You can also use filters to display only the catalog items that are currently included in your OS design.

Catalog Items

A catalog item is specifically included in the OS design by a design template or by the OS developer. A catalog item might also be automatically added during the build cycle if it is a dependency of another item.

The Cesysgen.bat file controls additional batch files, which contain dependency rules that Platform Builder compares against the items in your OS design. Platform Builder automatically includes additional catalog items that are required to support the catalog items that are included in the OS design.

Each time that you add a catalog item to, or remove one from, your OS design, or when you perform any other action that would require performing a Sysgen of the OS design, Platform Builder updates the display of catalog items in the Solution Explorer window. The Build tab in the Output window also displays a list of catalog items added because of dependencies.

Each time the build process is initiated, Platform Builder starts with only required catalog item functionality and no dependent items.

At that point, you can delete catalog items that the design template or OS developer included in the OS design.

After dependent items have been added to the OS design, you can remove a catalog item that has been brought in by dependency, but only after the items that depend on it are removed.

Also, to ensure that a child catalog item is not removed if its parent catalog item is removed from the OS design, you can select the child and then select Add Item to User Specified Catalog Item(s) from the context menu. This explicitly includes the child catalog item in your OS design. If, at a later point in the development process, you no longer want to keep the child catalog item in your OS design, you can reverse this process. To do this, select the catalog item, and then, from the context menu, select Remove Item from User-specified Catalog Item(s).

Include Catalog Items

You can include a catalog item in your OS design in one of two ways:

  • Explicit inclusion through setting or clearing a Sysgen variable, which is an environment variable that corresponds to a specific feature, or by selecting the catalog item from the catalog.
    Explicitly included catalog items are called user-specified Catalog items.
  • Indirect inclusion because of another item or feature depending on it to function.
    These indirectly included items are brought in by dependency. To remove an indirectly included catalog item from your OS design, you must remove all catalog items that bring it in by dependency.

In the Solution Explorer window IDE, you can determine whether a catalog item is explicitly or indirectly included by examining its icon.

In this Section

Drivers in an OS Design

Catalog Item Dependencies

Add Applications to the Catalog

Add Device Drivers to the Catalog

See Also

Concepts

Platform Builder