80 likes | 188 Views
May 25, 2011. SIDSC Design File Methodology. Configure and Generate Register Content at the Device Level. Noreen McMahan based on Work by Seth Park. What is An SIDSC Design Map File?.
E N D
May 25, 2011 SIDSC Design File Methodology Configure and Generate Register Content at the Device Level Noreen McMahan based on Work by Seth Park
What is An SIDSC Design Map File? Enables reuse of generic modules of register content across different devices and device families, both in block guides (module chapters) and in packages of register data targeted for board software developers. For each component in a generated publication, the SIDSC design file writes device-specific information, such as the base address of the module on the device and the number of instances of the module that are available on that device. Device-specific information is supplied only at publication time, so the component (configured for conditional processing) remains generic and available for reuse. The component references can contain conditional processing attributes to filter entire components/modules in and out of the content as different reference manuals in a family are generated.
What is a Design Map File The structure of an SIDSC design map file is very simple. It is a list of component references using the <component-ref> element, just as a DITA map for a block guide is a list of topic references using the <topicref> element. Each <component-ref> element must reference exactly one component, although it may specify multiple instances of this component. Each <component-ref> contains a series of attributes and their values, most of them required and some of them optional.
Attributes on a Component Reference • All of the select-atts (optional) • Base address (required) • Corresponds to the <unitAddress> element in the <componentBody> of an SIDSC component. Overwrites <unitAddress>. • href (path to component file) (required) • Instances number (optional) • Set of 4 attributes: <instancesNumber>, <instanceOffsets>, <namePattern>, <unitQualifier> to define how many instances of this component are available on a device • Register increment (optional) • IP version and IP name (required) • Must match these values in the individual component file
Conditional Processing: Use Case 1 Filter a module in or out of a deliverable
Conditional Processing: Use Case 2 Select Number of Instances When Filter is Applied