 | The elements of the DTD software are described in the following. The description of an element is made up of: Description of the element, details of attributes, details of the context, and an example is given for each.
These are elements of general applicability and are to be allocated to a user architecture. These element names are not prefixed by "sw-". These elements are used in all DTD's that correspond to a certain user architecture. They are therefore not all listed again here. These are described in the document "Concepts of the DTD".
There is an attribute "s" (Signature) that occurs in all elements and is therefore not listed again here.
Fixed attributes are also given in the examples for the sake of clarity (e.g. [f-namespace]). The fixed attributes no longer appear in an entity due to the software DTD, i.e the entity is only complete together with the DTD.
<abs> Description Absolute value for parameter characteristics. See parameter model ( <sw-prm>).
Example <prm>
<long-name>long designation</long-name>
<short-name>short designation</short-name>
<prm-char>
<abs>10</abs>
<tol>5<tol>
<unit>oC</unit>
</prm-char>
</prm>
<prm>
<long-name>long designation</long-name>
<short-name>short designation</short-name>
<prm-char>
<min>0</min>
<typ>5<typ>
<max>0</max>
<unit>oC</unit>
</prm-char>
</prm>
<add-info> Description Additional notes. The programming language used could be documented in a function using this element for example.
Included in <sw-function-variant>, < sw-param>, <sw-variable-implementation>
Example <sw-function-variant>
...
<add-info>
<prms>
<prm>
<long-name>program-language</long-name>
<short-name>program-language</short-name>
<prm-char><text>ASS</text>
</prm-char>
</prm>
</prms>
</add-info>
</sw-function-variant>
<add-spec> Description
Included in <general-project-data>
Example
<admin-data> Description Information can be provided within the structure of this elements on the separate administration of sub-entities. It is for this reason that this element exists at all those points where a potential export and import is foreseen for separate administration purposes.
Attributes [f-child-type] For applications in order to make differing "child-types" possible (type test). Example: "language:selection", i.e. the child element language is of the type selection, can thus be chosen from a selection list.
Included in All elements that are foreseen for a fragmentation.
Example <admin-data>
<language>de</language>
<doc-revisions>
<doc-revision>
<company-revision-infos>
<company-revision-info>
<company-ref></company-ref>
<revision-label>10.4</revision-label>
<state></state>
</company-revision-info>
</company-revision-infos>
<team-member-ref></team-member-ref>
<date></date>
<modifications>
<modification type="part-related">
<change></change>
<reason></reason>
</modification>
</modifications>
</doc-revision>
</doc-revisions>
</admin-data>
<annotation> Description Information of different kinds can arise throughout the course of a process, (e.g. processing information, notes etc.) that shall be linked to the variables, parameters or function and be forwarded in the process. Such kinds of information are stored in <annotation>.
Included in <annotations>
Example
<arraysize> Description In the case of variables, it can happen that these are present not as an element but rather in the form of an array. This value then gives the size of the array. Diemsions can be separated by blanks for multi-dimensional arrays.
Parameter fields and arrays can also be established.
Included in <sw-param>, <sw-variable-implementation>
Example <sw-param>
<long-name></long-name>
<short-name>kgr_a</short-name>
<sw-param-class>curve_individual</sw-param-class>
<desc></desc>
<sw-param-array-x>
<sw-param-axis-x>
<sw-axis-individual>
<sw-variable-ref>TMOT</sw-variable-ref>
<max-count></max-count>
</sw-axis-individual>
</sw-param-axis-x>
<sw-param-axis-values>
<sw-compu-method-ref>DEZ</sw-compu-method-ref>
</sw-param-axis-values>
</sw-param-array-x>
<arraysize>0x3</arraysize>
<sw-addressing-method-ref>Vek</sw-addressing-method-ref>
<sw-param-record-layout-ref>DAMOS_KL0</sw-param-record-layout-ref>
<sw-code-syntax-ref>csyKLuw</sw-code-syntax-ref>
</sw-param>
<bit-base-name> Description In <sw-bit-representation> in <sw-variable>. Name of the variable containing the bit.
Included in <sw-bit-representation>
Example <sw-bit-representation>
<bit-base-name>variable-short-name</bit-base-name>
<bit-base-type>w<bit-base-type>
<bit-count>1</>
<bit-pos>5</>
</sw-bit-pos>
<bit-base-type> Description In <sw-bit-representation> in <sw-variable>. Type (byte, word, long) of the variable containing the bit.
Included in <sw-bit-representation>
Example <sw-bit-representation>
<bit-base-name>variable-short-name</bit-base-name>
<bit-base-type>w<bit-base-type>
<bit-count>1</>
<bit-pos>5</>
</sw-bit-pos>
<bit-count> Description In <sw-bit-representation> in <sw-variable>. Number of associated bits.
Included in <sw-bit-representation>
Example <sw-bit-representation>
<bit-base-name>variable-short-name</bit-base-name>
<bit-base-type>w<bit-base-type>
<bit-count>1</>
<bit-pos>5</>
</sw-bit-pos>
<bit-pos> Description In <sw-bit-representation> in <sw-variable>. Postion of the bits in the basic size.
Included in <sw-bit-representation>
Example <sw-bit-representation>
<bit-base-name>variable-short-name</bit-base-name>
<bit-base-type>w<bit-base-type>
<bit-count>1</>
<bit-pos>5</>
</sw-bit-pos>
<change> Description Element in which a description for the type of change can be given.
Included in <Modification>
Example <modification>
<change>Änderung ...</change>
<reason></reason>
</modification>
<chapter> Description A description of informal information not structured according to the application can be given in a chapter. Chapters can be structured according to a hierarchy. A chapter can contain paragraphs, tables, graphics, lists, etc.
Included in
Example <chapter id="ch1" help-entry="chapter">
<long-name>Chapter1</long-name>
<short-name></short-name>
<p></p>
<figure id="fig1" help-entry="synopic diagram"><
long-name>principal circuit diagram</long-name>
<short-name>psb</short-name>
<graphic filename="bild.eps" notation="eps"></graphic>
</figure>
<chapter id="ch11">
<long-name>Chapter 1.1</long-name>
<short-name></short-name>
<p></p>
<p></p>
</chapter>
</chapter>
<cmt-int> Description Internal value for a conversion formula
Included in <sw-compu-method-text-pair>, <sw-compu-method-value-pair>
Example <sw-compu-method-text>
<sw-compu-method-text-pair>
<cmt-int>0</cmt-int>
<cmt-text>Heck</cmt-text>
</cmt-compu-method-text-pair>
</sw-compu-method-text>
<cmt-phys> Description Physical value for a conversion formula.
Included in <sw-compu-method-value-pair>
Example <sw-compu-method-table>
<sw-compu-method-value-pair>
<cmt-int>0</cmt-int>
<cmt-phys>11</cmt-phys>
</cmt-compu-method-value-pair>
</sw-compu-method-table
<cmt-text> Description Value in text form for a conversion formula.
Included in <sw-compu-method-text-pair>
Example <sw-compu-method-text>
<sw-compu-method-text-pair>
<cmt-int>0</cmt-int>
<cmt-text>Heck</cmt-text>
</cmt-compu-method-text-pair>
</sw-compu-method-text>
<code> Description
Included in <variant-char>, <variant-char-value>, <variant-def>
Example
<coded> Description Coded/internal values for limits.
Example <sw-limits>
<coded>
<coded-min>0</coded-min>
<coded-max>255</coded-max>
</coded>
<phys>
<phys-min>0</phys-min>
<phys-max>90</phys-max></phys>
</sw-limits>
<coded-max> Description Maximum coded limiting value
Example <coded-max>255</coded-max>
<coded-min> Description Minimum coded limiting value
Example <coded-min>0</coded-min>
<companies> Description Company-specific details, comprising 1 .. n companies.
Example <companies>
<company role="supplier" id="rb"></company>
<company role="manufacturer" id="db"></company>
</companies>
<company> Description Company-spefic details for a company participating in the project
Attributes [f-child-type] For applications to make different "child-types" possible
[role] Role of the company participating in the project. "Manufacturer", "supplier".
Example <company role="supplier" id="rb">
<long-name>Robert Bosch GmbH</long-name>
<short-name>rb</short-name>
<team-members>
<team-member id="ge"></team-member>
</team-members><
general-project-data></general-project-data>
</company>
<company-doc-info> Description
Included in <company-doc-infos>
Example <company-doc-info>
<company-ref company="rb"></company-ref>
<doc-label>Programmstand</doc-label>
<private-codes>1.1</private-codes>
<entity-name>P11.sgm</entity-name>
</company-doc-info>
<company-doc-infos> Description Company-specific information for administrative data
Example
<comany-ref> Description Reference to a company
Included in <company-doc-info>, <company-revision-info>
Example <company-revision-info>
<company-ref company="rb">rb</company-ref>
...
</company-revision-info>
<company-revision-info> Description Company-specific information concerning a certain revision/variant.
Included in <company-revision-infos>
Example <company-revision-info>
<company-ref company="rb">rb</company-ref>
<revision-label>15.4</revision-label>
<state>freigegeben</state>
</company-revision-info>
<company-revision-infos> Description Revision and variant information on an entity or fragment.
Included in <doc-revision>
Example
<cond> Description Condition for parameters.
Example <prm>
<long-name>Langbezeichnung</long-name>
<short-name>Kurzbezeichnung</short-name>
<prm-char>
<cond><p>gültig wenn x < 20</p></cond>
<abs>10</abs>
<tol>5<tol>
<unit>oC</unit>
</prm-char>
</prm>
<count> Description Number of elements for one parameter block.
Included in <sw-param-value-block>
Example <sw-param-value-block>
<sw-param-axis-values>
<sw-compu-method-ref sw-compu-method="dez">
</sw-compu-method-ref>
</sw-param-axis-values>
<count>4</count>
</sw-param-value-block>
<date> Description Date information, multiple-language possible
Included in <doc-revision>, <schedule>
Example
<date-1> Description Date information, multiple-language not possible
Included in <std>, <xdoc>
example
<demarcation-other-project> Description Delimitation to other projects
Included in <general-project-data>
Example
<department> Description Department
Included in <team-member>
Example
<desc> Description Description element
Included in <figure>, <overall-project>, <prm>, <project>, <sw-data-dictionary>, <sw-param>, <sw-param-content>, <sw-param-contents>, <sw-physic-type-contents>, <sw-variable>, <tbd>
Example <sw-variable calibration="no-calibration" f-id-class="sw-variable" f-namespace="sw-variable">
<long-name>engine temperature</long-name>
<short-name>tmot</short-name>
<desc>The engine temeprature is stored in this variable</desc>
...
</sw-variable>
<doc-label> Description
Included in <company-doc-info>
Example
<doc-revision> Description
Included in <doc-revisions>
Example
<doc-revisions> Description
Example
<entity-name> Description
Included in <company-doc-info>
Example
<figure> Description Graphics can be linked using this element.
Included in
Example
<file> Description Information on a file name for referencing an external file, a standard
Attributes [filename] Name of the file.
[notation] Type of file, e.g. "wmf", "cgm".
[tool] Tool for displaying or editing the file
[tool-version] Version of the tool with with the file was created
Included in <std>, <xdoc>, <xfile>
Example <file filename="agr.eps" notation="eps" tool="ascet" tool-version="sd"></file>
<function-ref> Description Reference to function or requirements-function.
Example
<general-project-data> Description General project data.
Example
<generic-math> Description Mathematical formula.
Example
<graphic> Description Graphics file information
Example <graphic filename="ggub.eps" notation="eps"></graphic>
<ie> Description
Included in <mixed-content-4>, <ml-data-1>, <ml-data2>, <ml-data-4>
Example
<introduction> Description Introductory section or introductory chapter
Included in <company-revision-info>, <general-project-data>, <info>, <msrsw>, <sample-spec>, <sw-data-dictionary-spec>, <sw-glossary>, <sw-param-contents-spec>, <variant-spec>
Example
<label> Description A label is a designation for an object that must not, and cannot, be referenced, i.e. possesses no < short-name> and no [id].
A <label> for <sw-param-value-block> is a long designation for the characteristic values of a characteristic values block.
Included in <annotation>, <labels>, <overall-project>, <prms>
Example <sw-param-value-block>
<sw-param-axis-values>
<sw-compu-method-ref sw-compu-method="dez">
</sw-compu-method-ref>
<labels>
<label>sensor rear left</label>
<label>sensor rear right</label>
<label>sensor front left</label>
<label>sensor front right</label>
<l/abels>
</sw-param-axis-values>
<count>4</count>
</sw-param-value-block>
<labels> Description Quantity of labels for axial values
Included in <sw-param-axis-values>
Example
<locs> Description This element is used for document/entity-overriding referencing (HighTime referencing using namelocs)
Example
<language> Description Identifies the Masterlanguage for <admin-data>
Example
<long-name> Description Long designation, e.g. "Engine temperature".
Included in
Example <sw-variable id="tmot">
<long-name>engine temperature</long-name>
<short-name>tmot</short-name>
<desc></desc>
...
</sw-variable>
<max> Description Maximum value for a parameter characteristic
Example
<max-count> Description Maximum number of datapoints
Included in <sw-axis-individual>, <sw-axis-shift-offset>
Example
<min> Description Minimum value for prm-char
Example
<modification> Description
Attributes [type] Content-related, doc-related
Included in <modifications>
Example
<modifications> Description
Included in <doc-revision>
Example
<msrsw> Description Root elelement
Attributes
[f-pubid] Fixed attribute: -//MSR//DTD MSR SOFTWARE DTD:V1.1.0:MSRSW.DTD//EN
[pubid] -//MSR//DTD MSR SOFTWARE DTD:V1.1.0:MSRSW.DTD//EN
Included in -
Example
<na> Description This element is used instead of sub-structures if certain statements are not relevant ("not applicable").
Included in <general-project-data>, <info>, <sample-spec>, <sw-data-dictionary-spec>, <sw-functions-spec>, <sw-glossary>, <sw-param-contents-spec>
Example <sw-param-contents-spec>
<na></na>
</sw-param-contents-spec>
<ncoi-1> Description This is a general element that contains informal and non-software-specific structures ("none coded information").
Included in <info>, <sample>, <sw-function-def>, <sw-glossary>
Example
<offset> Description The datapoints are defined by an algorithm for fixed characteristics and maps. Example for an algorithm: Datapoint[i] = ( ... shift ) * x + offset
Included in <sw-axis-shift-offset>
Example <sw-axis-shift-offset>
<sw-variable-ref>var1</sw-variable-ref>
<max-count>4</max-count>
<shift>2</shift>
<offset>3</offset>
<sw-axis-shift-offset></sw-axis-shift-offset>
<p> Description Paragraph. A paragraph can comprise text and the elements tt (technical text), xref (cross reference), e (text attribute like bold), ft (footnote), sup (superscript), sub (subscript), ie (index entry), std (standard), xdoc (external document), xfile (external file) in any arbitrary, though not hierarchical, order.
Attributes [help-entry] Entry for a Help system
Included in add-info, annotation-text, chapter, cond, def, introduction, ncoi-1, p-level-elements, sw-addressing-method-desc, sw-application-notes, sw-carb-doc, sw-code-syntax-desc, sw-function-desc, sw-maintenance-notes, sw-param-record-layout-desc, sw-test-spec
Example <sw-function-desc>
<p>This function describes the <ie>exhaust-gas return</ie>. Refer to <std> ... </std></p>
</sw-function-desc>
<private-code> Description
Included in <private-codes>
Example <private-codes>
<private-code> TYPE="generated_by_ASCET-SD">$generated_by_ASCET-SD:2.2.0$ </private-code>
<private-code> TYPE="Implementation xy">Implementation xy</private-code>
</private-codes>
<private-codes> Description
Included in <company-doc-infos>
Example <company-doc-infos>
<private-codes>
<private-codes>
<private-code> TYPE="generated_by_ASCET-SD">$generated_by_ASCET-SD:2.2.0$ </private-code>
</private-codes>
</company-doc-infos>
<prm> Description A parameter model has been implemented in MSR. There are 2 possibilities given. A parameter can be specified either by defining <abs>, <tol> or by defining <min>, <typ> and <max>.
Included in prms
Example
<prms> Description List of parameters
Included in <add-info>, <chapter>, <ncoi-1>, <sw-addressing-method-desc>, <sw-application-notes>, <sw-carb-doc>, <sw-function-desc>, <sw-maintenance-notes>, <sw-param-record-layout-desc>, <sw-test-spec>, <topic-1>
Example
<prm-char> Description Description of the parameter characteristics of a parameter
Example <sw-prm>
<long-name>long designation</long-name>
<short-name>short designation</short-name>
<min>10</min>
<typ>45</typ>
<max>90</max>
<unit>oC</unit>
</sw-prm>
<prog-code> Description Description of conversion formulae in a programming language notation
Attributes
[prog-lang] Programming language
[used-libs] Libraries used
Included in sw-compu-method
Example
<project> Description Information regarding a project.
Included in <project-data>
Example
<project-data> Description Project data
Example
<shift> Description The datapoints are defined by an algorithm for fixed characteristics and fixed maps. Example for an algorithm: Datapoint[i] = ( ... shift ) * x + offset
Included in <sw-axis-shift-offset>
Example <sw-axis-shift-offset>
<sw-variable-ref>var1</sw-variable-ref>
<max-count>4</max-count>
<shift>2</shift>
<offset>3</offset>
<sw-axis-shift-offset></sw-axis-shift-offset>
<short-name> Description Short designation, e.g. "TMOT". The <short-name> has an identifying character, in particular for outside references (e.g. ASAP, ASCET).
Included in chapter, company, def-item, figure, formula, msrsw, namloc, prm, sample, std, sw-addressing-method, sw-code-syntax, sw-compu-method, sw-function, sw-param, sw-param-record-layout, sw-physic-type, sw-unit, sw-variable, team-member, topic-1, topic-2, variant-char, variant-def, xdoc, xfile
Example
<si-unit> Description There are SI units of measure for the units of measure. STEP (ISO/DIS 10303-41. S96ff) is supported with regard to SI units by seven basic units (length, mass, time, electric_current, thermodynamic_temperature, amount_of_substance, luminous_intensity). These basic units are realized by means of attributes.
Attributes [amount-ofsubstance-expo]
[luminous-intensity-expo]
[thermodynamic-temperature-expo]
Example <sw-unit>
<long-name>Meter per second</long-name>
<short-name>mps</short-name>
<si-unit length-expo = "1" time-expo = "-1"></si-unit>
<sw-unit-display></sw-unit-display>
</sw-unit>
<reason> Description
Included in <modification>
Example
<revision-label> Description Revision
Included in <company-revision-info>
Example <company-revision-info>
<company-ref></company-ref>
<revision-label>10.4</revision-label>
<state></state>
</company-revision-info>
<state> Description
Included in <company-revision-info>
Example
<std> Description
Attributes [f-child-type] date1:date
Included in
Example <std>
<long-name-1>ISO/DIS 10303-41 units of measure</long-name-1>
<short-name>ISO/DIS 10303-41</short-name>
<subtitle>SI units of measure</subtitle>
<state-1></state-1>
<date-1></date-1>
<file>ISO10303-41.std</file>
<position>S96ff</position>
</std>
<sw-addressing-method> Description Describes the addressing scheme. A description of how a parameter or a RAM variable from the control unit is given. Examples for the differing types of addressing are the direct addressing and the indirect addressing by a vector. The addressing scheme can also be used to define the RAM range in which the a RAM variable lies (e.g. in the internal or external RAM). Addressing schemes can be used by parameters and RAM variables.
This element is a reference to an access method for a name that must be simulated in the following systems (e.g. adjustment systems). This name links the MSR entity and the following systems.
Addressing schemes are not standardized or pre-defined in the DTD. Neither are they fully modeled. They are only described in terms of text in <sw-addressing-method-desc>.
Included in <sw-addressing-methods>
Example
<sw-addressing-method-class> Description Gives the class for the addressing scheme. Parameters or variables can only use addressing schemes of a certain class. This however cannot be assured by SGML means; the application must do this.
Addressing-scheme classes are not standardized or pre-defined in the DTD.
Included in <sw-addressing-method>
Example
<sw-addressing-method-desc> Description Text-form description of the addressing schemes
Included in <sw-addressing-method>
Example
<sw-addressing-method-ref> Description Reference to the addressing scheme, e.g. by giving the short name.
Attributes
[sw-addressing-method] idref
Included in <sw-param>, <sw-variable-implementation>
Example <sw-addressing-method-ref>defaultAdrS</sw-addressing-method-ref>
<sw-addressing-methods> Description All addressing schemes are defined in <sw-data-dictionary>
Included in <sw-data-dictionary>
Example
<sw-application-notes> Description Application notes
Included in <sw-function-variant>
Example
<sw-array-index> Description Reference to the sub-structure for parameter structures.
Included in <sw-param-content>
Example
<sw-asap-6-prm-method> Description 6-parameter formula corresponding to ASAP (polynomial presentation. Presentation of the elements of the formula separated by white spaces. formula: int = (a × x2 + b × x1 + c ) / ( d × x2 + e × x1 + f)
Included in <sw-compu-method>
Example <sw-asap-6-prm-method>0 1 0 0 0 0.698 </sw-asap-6-prm-method>
<sw-axis-grouped> Description Several characteristics have the same datapoints for running-time reasons that are referenced by the name.
Included in <sw-param-axis-x>, <sw-param-axis-y>
Example
<sw-axis-individual> Description Description of an axis, the datapoints for which can be individually defined. Each characteristic or each map has its own private datapoint values (unlike a group characteristic).
Included in <sw-param-axis-x>, <sw-param-axis-y>, <sw-param-group-axis>
Example <sw-param>
<long-name></long-name>
<short-name>etalam</short-name>
<sw-param-class>curve_individual</sw-param-class>
<desc></desc>
<sw-param-array-x>
<sw-param-axis-x>
<sw-axis-individual>
<sw-variable-ref>lambas</sw-variable-ref>
<max-count>10</max-count>
</sw-axis-individual>
</sw-param-axis-x>
...
</sw-param>
<sw-axis-shift-offset> Description Special form of datapoints used for reasons of optimizing the running time. The datapoints are computed according to the following algorithm: Datapoint[i] = ... + Offset.
Included in <sw-param-axis-x>, <sw-param-axis-y>
Example
<sw-base-type> Description Base type of SW variable (e.g. char, integer).
Included in <sw-param>, <sw-variable-implementation>
Example <sw-variable-implementation>
<sw-base-type>UBIT</sw-base-type>
</sw-variable-implementation>
<sw-bit-representation> Description This optional element contains information or bit presentation in the form of elements (number of bits, bit position, bit base name, bit base type) for variables with the data type "bit".
Included in <sw-variable-implementation>
Example <sw-bit-representation>
<bit-base-name>variable-short-name</bit-base-name>
<bit-base-type>w<bit-base-type>
<bit-coutn>1</>
<bit-pos>5</>
</sw-bit-pos>
<sw-carb-doc> Description CARB documentation.
Included in <sw-function-variant>
Example
<sw-code-syntax> Description Name reference to a code syntax. The presentation of RAM variables and parameters in the data source file is defined by the code syntax. The code syntaxes are described in the <sw-data-dictionary>. The code syntaxes described here can be used by variables and parameters by referencing.
The content of a code syntax is not fully modeled, i.e. the code syntax is only decribed in text-form in <sw-code-syntax-desc>. There are no standardized values or values pre-defined in the DTD for the code syntax.
Included in <sw-code-syntaxes>
Example <sw-code-syntax>
<long-name>Code syntax object for system constants</long-name>
<short-name>cSyKgsSys</short-name>
<sw-code-syntax-desc>
<verbatim>Code syntax: cSyKgsSys Code syntax object for system constants
... e.g. C code
</verbatim>
</sw-code-syntax-desc>
</sw-code-syntax>
<sw-code-syntax-class> Description Gives the class for the code syntax. Parameters or variables can only use the code syntax of a certain class. This however cannot be assured by SGML means; the application must do this. A code syntax is for example, suitable for a parameter or for a variable, or only for a characteristic. The combination of a certain code syntax with a certain saving scheme can also be expressed by the class.
There are no standardized values or values pre-defined in the DTD for the code syntax classes.
Included in <sw-code-syntax>
Example
<sw-code-syntax-desc> Description Description of the code syntax
Included in <sw-code-syntax>
Example
<sw-code-syntax-ref> Description A reference to a code syntax can be made optionally within a RAM variable or parameter.
Included in <sw-param>, <sw-variable-implementation>
Example </sw-variable-implementation>
...
<sw-code-syntax-ref>csyRAMub</sw-code-syntax-ref>
...
</sw-variable-implementation>
<sw-code-syntaxes> Description List of code syntaxes.
Included in <sw-data-dictionary>
Example
<sw-compu-generic-math> Description The conversion formula is described by a general mathematical expression.
Included in <sw-compu-method>
Example
<sw-compu-method> Description Conversion formula. Computing procedure according to which a control-unit-internal variable can be converted into its physical value. The conversion formula must be reversible.
Included in <sw-compu-methods>
Example
<sw-compu-method-ref> Description Reference to a conversion formula
Included in <sw-param-axis-values>
Example
<sw-compu-method-table> Description With this form for the conversion formula, the relationship between internal and physical presentation is given using a table of for the internal-physical pairs of values. An attribute interpolation-style is given that can take the values interpolation (default) and discrete.
Attributes [interpolation-style] Possible values: Interpolation, no-interpolation, discrete. Default: Interpolation.
Included in <sw-compu-method>
Example
<sw-compu-method-text> Description The conversion formula is described in text form. Unlike the other types of conversions, the physical side does not constitute a number but rather a text. Applications are conceivable for switches ("on"/"off") or for country identification ( "D", "F", "US").
Included in <sw-compu-method>
Example <sw-compu-method-text>
<sw-compu-method-text-pair>
<cmt-int>0</cmt-int>
<cmt-text>Heck</cmt-text>
</cmt-compu-method-text-pair>
<sw-compu-method-text-pair>
<cmt-int>16</cmt-int>
<cmt-text>16</cmt-text>
</cmt-compu-method-text-pair>
</sw-compu-method-text>
<sw-compu-method-text-pair> Description Includes an internal and a text-form value for text-type conversion formulae.
Included in <sw-compu-method-text>
Example <sw-compu-method-text-pair>
<cmt-int>0</cmt-int>
<cmt-text>Heck</cmt-text>
</cmt-compu-method-text-pair>
<sw-compu-method-value-pair> Description Includes an internal and a physical value for tabular types of conversion formulae.
Included in <sw-comput-method-table>
Example
<sw-compu-methods> Description List of conversion formulae.
Included in <sw-data-dictionary>
Example
<sw-data-dictionaries> Description Size of the data dictionaries
Included in <sw-data-dictionary-spec>
Example <msrsw>
<short-name></short-name>
<sw-data-dictionary-spec>
<sw-data-dictionaries>
<sw-data-dictionary>
...
</sw-data-dictionary>
</sw-data-dictionaries>
</sw-data-dictionary-spec>
</msrsw>
<sw-data-dictionary> Description Data dictionary. Data types, variables, parameters, units of measure, addressing schemes, storage schemes, code syntaxes and conversion formulae can be described here.
Included in <sw-data-dictionaries>
Example <msrsw>
<short-name></short-name>
<sw-data-dictionary-spec>
<sw-data-dictionaries>
<sw-data-dictionary>
<sw-datadictionary-class> ... </sw-datadictionary-class>
<sw-funtion-ref> ... </sw-funtion-ref>
<sw-units> ... </sw-units>
<sw-physic-types> ... </sw-physic-types>
<sw-variables> ... </sw-variables>
<sw-params> ... </sw-params>
<sw-compu-methods> ... </sw-compu-methods>
<sw-addressing-methods> ... </sw-addressing-methods>
<sw-param-record-layouts> ... </sw-param-record-layouts>
<sw-code-syntaxes> ... </sw-code-syntaxes>
</sw-data-dictionary>
</sw-data-dictionaries>
</sw-data-dictionary-spec>
</msrsw>
<sw-data-dictionary-spec> Description Data-dictionary specification.
Example <msrsw>
<short-name></short-name>
<sw-data-dictionary-spec>
<sw-data-dictionaries>
<sw-data-dictionary>
...
</sw-data-dictionary>
</sw-data-dictionaries>
</sw-data-dictionary-spec>
</msrsw>
<sw-data-dictionary-class> Description Information can be provided in this element regarding the development and modifications made to data dictionaries, e.g. "Data dictionary from company xy".
Included in <sw-data-dictionary>
Example
<sw-data-type-scaling> Description Quantization of a variable. Example: "16 bit".
Included in <sw-physic-type-contents>
Example
<sw-decomposition> Description Formation of functional hierarchies by referencing included and used functions.
Included in <sw-function-variant>
Example <sw-function id="function">
<long-name>exhaust-gas return</long-name>
<short-name>egr</short-name>
<sw-function-class></sw-function-class>
<sw-function-variants>
<sw-function-variant>
<sw-function-desc></sw-function-desc>
<sw-decomposition>
<sw-function-ref sw-function="function used"></sw-function-ref>
</sw-decomposition>
</sw-function-variant>
</sw-function-variants>
</sw-function>
<sw-fullfils> Description Allocates that or those (behavorial) function(s) to a software function that it realizes.
Included in <sw-function-variant>
Example
<sw-function> Description Software function
Included in <sw-functions>
Example <sw-function id="EGR">
<long-name>exhaust-gas return</long-name>
<short-name>EGR</short-name>
<sw-function-class>documentation only</sw-function-class>
<sw-function-variants>
<sw-function-variant></sw-function-variant>
</sw-function-variants>
</sw-function>
<sw-function-class> Description Function class. The functions can be broken down into different classes. There can be functions for example occurring only in the documentation/analysis phase that can be grouped to a class.
Included in <sw-function>
Example <sw-function id="test">
<long-name></long-name>
<short-name></short-name>
<sw-function-class>documentation only</sw-function-class>
<sw-function-variants>
<sw-function-variant></sw-function-variant>
</sw-function-variants>
</sw-function>
<sw-function-def> Description A short decription for each function is given by a suitable means of presentation. A graphical and a short text are used as a rule. Example: ASCET functional model, status diagrams, SA/SD diagrams.
Included in <sw-function-variant>
Example <sw-function-variant>
<sw-function-def>
<figure id="ascet-bild">
<long-name></long-name>
<short-name></short-name>
<graphic filename="ascet-modell" notation="cgmbin"></graphic>
</figure>
...
<ncoi-1><p> ... </p></ncoi-1>
...
</sw-function-def>
</sw-function-variant>
<sw-function-desc> Description Extensive description in text form for the function.
Included in <sw-function-variant>
Example <sw-function-variant>
<sw-function-desc>
...
<chapter>
<p>The ABS is an add-on function for a conventional brakes system.
It consists of a ABS hydro unit integrated electronic
control unit and 4 spped sensors for sensing the velocity behavior of the wheels.
</p>
</chapter>
</sw-function-desc>
...
</sw-function-variant>
<sw-function-export-variables> Description List of exported variables. When a function defines a variable, i.e., provides a variable or the value, then it is to be listed here.
Included in <sw-function-variables>
Example <sw-funtion-variables></>
<sw-function-export-variables>
<sw-variables-read>
<sw-variable-ref sw-variable="tmot">tmot</sw-variable-ref>
<sw-variable-ref sw-variable="b_max_flr">b_max_flr</sw-variable-ref>
</sw-variables-read>
<sw-variables-write>
<sw-variable-ref sw-variable="..."> ... </sw-variable-ref>
</sw-variables-write>
<sw-variables-readwrite>
<sw-variable-ref sw-variable="..."> ... </sw-variable-ref>
</sw-variables-readwrite>
</sw-function-export-variables>
</sw-function-variables>
<sw-function-import-variables> Description List of imported variables. Variables are listed here that are made available by other functions.
Included in <sw-function-variables>
Example
<sw-function-local-variables> Description List of local variables, i.e. no transfer variable.
Included in <sw-function-variables>
Example
<sw-function-modelonly-variables> Description List of variables that only exist in the model and no longer occur during implementation.
Included in <sw-function-variables>
Example
<sw-function-ref> Description In <msrsw>, reference to functions used that are described outside of the SW. In <sw-decomposition>, reference to functions that are described within <msrsw>.
Included in <sw-data-dictionary>, <sw-decomposition>, <sw-functions-refs>, <sw-param-content>, <sw-param-contents>,
Example
<sw-function-refs> Description References to functions used that are described outside of the document, e.g. operating system functions, network services.
Example
<sw-function-spec> Description Functions specification. A functions specification can include several functions. The functions can be in hierarchical form by which reference to a function is made by <sw-decomposition>.
Example
<sw-function-variables> Description List of variables used by the function
Included in <sw-function-variant>
Example <sw-function-variant>
...
<sw-funtion-variables></>
<sw-function-export-variables>
<sw-variables-read>
<sw-variable-ref sw-variable="tmot">tmot</sw-variable-ref>
<sw-variable-ref sw-variable="b_max_flr">b_max_flr</sw-variable-ref>
</sw-variables-read>
<sw-variables-write>
<sw-variable-ref sw-variable="..."> ... </sw-variable-ref>
</sw-variables-write>
<sw-variables-readwrite>
<sw-variable-ref sw-variable="..."> ... </sw-variable-ref>
</sw-variables-readwrite>
</sw-function-export-variables>
<sw-function-import-variables> ... </sw-function-import-variables>
<sw-function-local-variables> ... </sw-function-local-variables>
<sw-function-modelonly-variables> ... </sw-function-modelonly-variables>
</sw-function-variables>
...
</sw-function-variant>
<sw-function-variant> Description Function variant. If no function variants are used, then a minimum of one still has to be given. Each function variant must be completely described in the implementation V1.1.0, i.e. there is no re-use.
A features bar in <project-data> ... <var-def> (function switch) can be referenced by means of < variant-def-ref>.
Included in <sw-function-variants>
Example <sw-function id="EGR">
<long-name>exhaust-gas return</long-name>
<short-name>EGR</short-name>
<sw-function-class>documentation only</sw-function-class>
<sw-function-variants>
<sw-function-variant>
<variant-def-refs>
<variant-def-ref variant-def="v1.2"></variant-def-ref>
<variant-def-ref variant-def="v1.3"></variant-def-ref>
</variant-def-refs>
<sw-function-def> ...</sw-function-def>
<sw-function-desc> ... </sw-function-desc>
<sw-function-variables> ... </sw-function-variables>
<sw-param-refs> ... </sw-param-refs>
<sw-test-spec> ... </sw-test-spec>
<sw-application-notes> ... </sw-application-notes>
<sw-maintenance-notes> ... </sw-maintenance-notes>
<sw-carb-doc> ... </sw-carb-doc>
<sw-decomposition> ... </sw-decomposition>
<add-info></add-info>
</sw-function-variant>
</sw-function-variants>
</sw-function>
<sw-function-variants> Description Number of function variants.
Included in <sw-function>
Example
<sw-functions> Description Number of functions in the functional specification/in the document. Envelope element.
Included in <sw-function-spec>
Example
<sw-glossary> Description Glossary
Example <sw-glossary>
<ncoi-1>
<def-list>
<def-item id="gid1">
<long-name>Interpolation methods</long-name>
<def><p>linear interpolation between datapoints for parameters</p></def>
</def-item>
</def-list>
</ncoi-1>
</sw-glossary>
<sw-interpolation-method> Description Interpolation method for parameters. The methods are not standardized or defined in the DTD. The methods are described in text form.
Example <sw-param>
...
<sw-interpolation-method>linear</sw-interpolation-method>
...
</sw-param>
<sw-limits> Description Minimum and maximum values for the physical and the control-unit-internal values are given here.
Included in <sw-axis-individual>, <sw-param-axis-values>, <sw-physic-type-contents>, <sw-variable-implementation>
Example <sw-variable-implementation>
<sw-base-type>UBYTE</sw-base-type>
<sw-limits>
<phys>
<phys-min>40.000000</phys-min>
<phys-max>4000.000000</phys-max>
</phys>
</sw-limits>
...
</sw-variable-implementation>
<sw-maintenance-notes> Description Customer servicing notes
Included in <sw-function-variant>
Example
<sw-param> Description Software parameters . Software parameters are parameters ( in ASAP characteristics): characteristics, maps and fixed values.
Parameters are as a rule, stored in the EPROM of the control unit. They are applicable, i.e. they can be read or modified using application tools within the scope of the plausibility and within the scope of set access protection attributes. Exceptions: e.g. cylinder number, not in the EPROM, not applicable. There is one attribute calibration for the possible attribute values calibration (default), no-calibration and not-in-memory.
Attributes [calibration] Possible values: Calibration (default), no-calibration, not-in-memory
Example <sw-param>
<long-name></long-name>
<short-name>etalam</short-name>
<sw-param-class>curve_individual</sw-param-class>
<desc></desc>
<sw-param-array-x>
<sw-param-axis-x>
...
</sw-param-axis-x>
<sw-param-axis-values>
<sw-compu-method-ref>rel_ub-b127b5</sw-compu-method-ref>
</sw-param-axis-values>
<sw-addressing-method-ref>NearRomByte</sw-addressing-method-ref>
<sw-param-record-layout-ref>KlAUbSstUbWUb</sw-param-record-layout-ref>
<sw-code-syntax-ref>KlNearAUbSstUbUb</sw-code-syntax-ref>
</sw-param>
<sw-param-array-x> Description Characteristic
Example <sw-param-array-x>
<sw-param-axis-x>
<sw-axis-individual>
<sw-variable-ref>N40</sw-variable-ref>
<max-count></max-count>
</sw-axis-individual>
</sw-param-axis-x>
<sw-param-axis-values>
<sw-compu-method-ref>FKT256</sw-compu-method-ref>
<sw-param-noeffect-value>0.04567</sw-param-noeffect-value>
</sw-param-axis-values>
</sw-param-array-x>
<sw-param-array-xy> Description Map
Example <sw-param>
<long-name>map exhaust gas recirculation</long-name>
<short-name>KFAGR</short-name>
<sw-param-class>map_individual</sw-param-class>
<desc></desc>
<sw-param-array-xy>
<sw-param-axis-x>
<sw-axis-individual>
...
</sw-axis-individual>
</sw-param-axis-x>
<sw-param-axis-y>
<sw-axis-individual>
...
</sw-axis-individual>
</sw-param-axis-y>
<sw-param-axis-values>
<sw-compu-method-ref>PCENT</sw-compu-method-ref>
<sw-param-noeffect-value>0.000000</sw-param-noeffect-value>
</sw-param-axis-values>
</sw-param-array-xy>
<sw-addressing-method-ref>Vek</sw-addressing-method-ref>
<sw-param-record-layout-ref>KF0</sw-param-record-layout-ref>
<sw-code-syntax-ref>cSyKfVk</sw-code-syntax-ref>
</sw-param>
<sw-param-axis-values> Description Value axis. Description of a characteristic value or the values of a characteristic or map
Included in <sw-param-array-x>, <sw-param-array-xy>, <sw-param-single-value>, <sw-param-value-block>
Example <sw-param-axis-values>
<sw-compu-method-ref>DEZ</sw-compu-method-ref>
<sw-param-noeffect-value>0.000000</sw-param-noeffect-value>
</sw-param-axis-values>
<sw-param-axis-x> Description Describes the x axis of a parameter ( <sw-param>). This description consists of the input variable (as reference to a variable), min, max, max-count (max. number of datapoints).
Included in <sw-param-array-x>, <sw-param-array-xy>
Example <sw-param-axis-x>
<sw-axis-individual>
<sw-variable-ref>N40</sw-variable-ref>
<max-count></max-count>
</sw-axis-individual>
</sw-param-axis-x>
<sw-param-axis-y> Description Describes the y axis of a parameter ( <sw-param>). This description consists of the input variable (as reference to a variable), min, max, max-count (max. nzmver of datapoints).
Included in <xs-param-array-xy>
Example <sw-param-axis-y>
<sw-axis-individual>
<sw-variable-ref>TL</sw-variable-ref>
<max-count>4</max-count>
</sw-axis-individual>
</sw-param-axis-y>
<sw-param-class> Description Gives the type of parameter (characteristic, map, characteristic value, fixed characteristic, group characteristic, fixed map).
Included in <sw-param>, <sw-param-content>
Example <sw-param>
<long-name>map Abgasrückführung</long-name>
<short-name>KFAGR</short-name>
<sw-param-class>map_individual</sw-param-class>
...
</sw-param>
<sw-param-content> Description Parameter values
Included in <sw-param-contents>
Example <sw-param-contents-spec>
<sw-param-contents>
<sw-param-contents-class>msr-test-values</sw-param-contents-class>
<sw-param-content>
<sw-param-ref>DLIP</sw-param-ref>
<sw-param-class>curve_fixed</sw-param-class>
<sw-param-content-x>
<sw-unit-ref>Upm</sw-unit-ref>
<sw-param-values-phys>
<v>0.000000</v><v>10.000000</v>
</sw-param-values-phys>
</sw-param-content-x>
<sw-param-content-v>
<sw-unit-ref>kg/h pro sec</sw-unit-ref>
<sw-param-values-phys>
<v>3.780000</v><v>32.90000</v>
</sw-param-values-phys>
</sw-param-content-v>
</sw-param-content>
</sw-param-contents>
</sw-param-contents-spec>
<sw-param-contents-class> Description Gives the type of the data contents/data sets, e.g.: "Test data", "Raw application data".
The parameter classes are not standardized or defined in the DTD.
Included in <sw-param-contents>
Example <sw-param-contents-class>Testdata</>
<sw-param-content-text> Description The values of a test parameter are given here (sw-param-text).
Included in <sw-param-content>
Example <sw-param-content-text>EIN</sw-param-content-text>
<sw-param-content-v> Description An individual value is given here for a characteristic value. The values of the v axis are given here for a characteristic. The values of the v axis are given here for a map. The following convention thereby applies: Index of the x axis runs faster. Values are separated by blanks or line feeds.
Included in <sw-param-content>
Example <sw-param-content-v>
<sw-unit-ref>dez</sw-unit-ref>
<sw-param-values-phys>
<v>1.000000</v><v>2.000000</v><v>3.000000</v><v>4.000000</v><v>5.000000</v><v>6.000000</v>
</sw-param-values-phys>
</sw-param-content-v>
<sw-param-content-x> Description The physical, internal, ... values for the x axis are given here.
Included in <sw-param-content>
Example <sw-param-content-x>
<sw-param-values-phys>
<v>-30.5</v><v>-20.0</v><v>30</v>
</sw-param-values-phys>
<sw-param-content-x>
<sw-param-content-y> Description The physical, internal, ... values for the y axis are given here.
Included in <sw-param-content>
Example <sw-param-content-y>
<sw-param-values-phys>
<v>-30.5</v><v>-20.0</v><v>30</v>
</sw-param-values-phys>
<sw-param-content-y>
<sw-param-contents-spec> Description Specification for parameter contents
Included in <msrsw>, <sw-function-variant>
Example <sw-param-contents-spec>
<sw-param-contents>
<sw-param-contents-class>msr-test-values</sw-param-contents-class>
<sw-param-content>
...
</sw-param-content>
<sw-param-content>
...
</sw-param-content>
</sw-param-contents>
</sw-param-contents-spec>
<sw-param-group-axis> Description Group characteristic
Example <sw-param>
<long-name></long-name>
<short-name>N40</short-name>
<sw-param-class>axis_points</sw-param-class>
<desc></desc>
<sw-param-group-axis>
<sw-axis-individual>
<sw-variable-ref>N40</sw-variable-ref>
<max-count></max-count>
</sw-axis-individual>
</sw-param-group-axis>
...
</sw-param>
<sw-param-noeffect-value> Description Value that cancels the action by a parameter (typically 0 or 1).
Included in <sw-param-axis-values>
Example <sw-param>
<long-name>map exhaust-gas return</long-name>
<short-name>KFAGR</short-name>
<sw-param-class>map_individual</sw-param-class>
<desc></desc>
<sw-param-array-xy>
<sw-param-axis-x>
...
</sw-param-axis-x>
<sw-param-axis-y>
...
</sw-axis-individual>
</sw-param-axis-y>
<sw-param-axis-values>
<sw-compu-method-ref>PCENT</sw-compu-method-ref>
<sw-param-noeffect-value>0.000000</sw-param-noeffect-value>
</sw-param-axis-values>
</sw-param-array-xy>
...
</sw-param>
<sw-param-record-layout> Description Storing scheme (in ASAP record layout). A storing scheme decribes the form for storing a parameter in the EEPROM. The storing scheme determines the sequence of parameters, components and their data types. Hence a storing scheme can define for a characteristic, that the address for the input variable shall be saved first stored as a byte, then the number of datapoints as an unsigned byte, then the datapoints as signed word and finally the values of the characteristic.
This element is the name for a reference to a storing scheme. This storing scheme designates the structure for the storage device in the memory of the control unit. The following systems (e.g. adjustment systems) must evaluate these storing schemes. The link to such types of systems is by their names.
Code syntax objects describe the presentation of an object in a programming language, the storing-scheme objects their storage in the EPROM. Code syntax objects and storing-scheme objects must be consistent. I.e. a parameter cannot use word storage for the storing scheme and byte storage for the code syntax.
The storing scheme is not fully modeled. The actual storing scheme can be described in text form in <sw-param-record-layout-desc>.
Included in <sw-param-record-layouts>
Example <sw-param-record-layout>
<long-name>storing scheme DAMOS_KF0</long-name>
<short-name>DAMOS_KF0</short-name>
<sw-param-record-layout-desc>
<verbatim>Ablageschema: DAMOS_KF0
...
column-wise values Unsigned Byte
</verbatim>
</sw-param-record-layout-desc>
</sw-param-record-layout>
<sw-param-record-layout-class> Description Gives the class for the storing scheme. Parameters or variables can only use storing schemes of a certain class. This however cannot be assured by SGML means; the application must do this. The storage classes are not standardized and are not defined in the DTD.
Included in <sw-param-record-layout>
Example
<sw-param-record-layout-desc> Description The storing scheme can be described here in text form.
Included in <sw-param-record-layout>
Example <sw-param-record-layout-desc>
<verbatim>storing scheme: FKF0
element datatyp
-----------------------------------------------
Store-element-list
X datapoint aequidist. not in EPROM
Y datapoint aequidist. not in EPROM
Colum-wise values unsigned Byte
</verbatim>
</sw-param-record-layout-desc>
<sw-param-ref> Description Reference to <sw-param> parameters. If the attribute own is not defined for <sw-param-ref> in <sw-function-variant>, then this means that the parameter is defined in the function and is hence assigned to this.
Included in <sw-axis-grouped>, <sw-param-content>, <sw-param-refs>
Example <sw-function-variant>
...
<sw-param-refs></sw-param-refs>
<sw-param-ref owns="noown" sw-param="lamx">lamx</sw-param-ref>
</sw-param-refs>
...
</sw-function-variant>
<sw-param-single-value> Description Applicable single paramater. A single parameter is treated as a characteristic with one element. The parameter is defined in < sw-param>, the value is given in <sw-param-content>. The allocation is by referencing <sw-param-content> to <sw-param> in <sw-param-ref>.
Example <sw-param>
<long-name></long-name>
<short-name>KUP_SIG_G</short-name>
<sw-param-class>value</sw-param-class>
<desc></desc>
<sw-param-single-value>
<sw-param-axis-values>
<sw-compu-method-ref>TEMPQ</sw-compu-method-ref>
</sw-param-axis-values>
</sw-param-single-value>
<sw-addressing-method-ref>offset</sw-addressing-method-ref>
<sw-param-record-layout-ref>KW0</sw-param-record-layout-ref>
<sw-code-syntax-ref>cSyKwByte</sw-code-syntax-ref>
</sw-param>
<sw-param-content>
<sw-param-ref>KUP_SIG_G</sw-param-ref>
<sw-param-class>value</sw-param-class>
<sw-param-content-v>
<sw-unit-ref>grad C</sw-unit-ref>
<sw-param-values-phys>
<v>-88.3456</v>
</sw-param-values-phys>
</sw-param-content-v>
</sw-param-content>
<sw-param-target> Description Reference to the name of a variable/RAM cell where the result of the interpolation shall be given.
Included in <sw-param-group-axis>
Example <sw-param-group-axis>
<sw-axis-individual>
<sw-variable-ref>N40</sw-variable-ref>
<max-count></max-count>
</sw-axis-individual>
<sw-param-target>
<sw-variable-ref><sw-variable-ref>
</sw-param-target>
</sw-param-group-axis>
<sw-param-text> Description A description of parameters can be given here that have text as their values. Example: Message text for driver back-signals. The values are included in <sw-param-content-text>.
Example <sw-param>
<long-name></long-name>
<short-name>EIN</short-name>
<sw-param-class>ASCII</sw-param-class>
<desc></desc>
<sw-param-text></sw-param-text>
</sw-param>
<sw-param-value-block> Description A parameters block comprises an array of characteristic values of the same type. The number is given in <count>.
Example <sw-param>
<long-name></long-name>
<short-name>KWBLOCK1</short-name>
<sw-param-class>value_block</sw-param-class>
<desc></desc>
<sw-param-value-block>
<sw-param-axis-values>
<sw-compu-method-ref>TIQ</sw-compu-method-ref>
</sw-param-axis-values>
<count>2</count>
</sw-param-value-block>
<sw-addressing-method-ref>dir</sw-addressing-method-ref>
<sw-param-record-layout-ref>KWB0</sw-param-record-layout-ref>
<sw-code-syntax-ref>cSyKwb</sw-code-syntax-ref>
</sw-param>
<sw-param-content>
<sw-param-ref>KWBLOCK1</sw-param-ref>
<sw-param-class>value_block</sw-param-class>
<sw-param-content-v>
<sw-unit-ref>ms/Umdr.</sw-unit-ref>
<sw-param-values-phys><v>0.012345</v><v>0.099999</v></sw-param-values-phys>
</sw-param-content-v>
</sw-param-content>
<sw-param-values-adr> Description This element contains the addresses of parameters. The values are in the sub-element <v>, that is given once for a single characteristic value and several times for parameters.
Included in <sw-param-content-v>, <sw-param-content-x>, <sw-param-content-y>
Example
<sw-param-values-coded> Description This element contains the values for parameters in coded form. The values are in the sub-element <v>, that is given once for a single characteristic value and several times for parameters.
Included in <sw-param-content-v>, <sw-param-content-x>, <sw-param-content-y>
Example
<sw-param-values-coded-hex> Description This element contains the values for parameters in hexadecimal coded form. The values are in the sub-element <v>, that is given once for a single characteristic value einmal and several times for parameters.
Included in <sw-param-content-v>, <sw-param-content-x>, <sw-param-content-y>
Example
<sw-param-values-generic> Description Values can be stored here in a format that is not directly supported. The format is given in the attribute [type]. The use of this element is process-specific.
Included in <sw-param-content-v>, <sw-param-content-x>, <sw-param-content-y>
Example
<sw-param-values-phys> Description This element contains the values for parameters in physical form. The values are in the sub-element <v>, that is given once for a single characteristic value einmal and several times for parameters.
Included in <sw-param-content-v>, <sw-param-content-x>, <sw-param-content-y>
Example
<sw-params> Description List of parameters (envelope element).
Included in <sw-data-dictionary>
Example <sw-params>
<admin-data> ... </admin-data>
<sw-param><admin-data> ... </admin-data> ... </sw-param>
...
<sw-param><admin-data> ... </admin-data> ... </sw-param>
</sw-params>
<sw-physic-type> Description Definition of a physical, implementation-independent and re-usable data type. Physical data types are defined in the early phases of software development for the control unit.
Included in <sw-physic-types>
Example <sw-physic-type>
<long-name>speed</long-name>
<short-name>n</short-name>
<desc></desc>
<sw-unit-ref>Umin</sw-unit-ref>
<sw-limits>
<phys><phys-min>0</phys-min><phys-max>8000</phys-max></phys>
</sw-limits>
<sw-resolution>20</sw-resolution>
<sw-data-type-scaling>8bit</sw-data-type-scaling>
<sw-variable-sample-rate>10</sw-variable-sample-rate>
<sw-var-init-value>0</sw-var-init-value>
<sw-var-not-av-value></sw-var-not-av-value>
</sw-physic-type>
<sw-physic-type-1> Description Physical data types can be defined for <sw-physic-types> both in the data dictionary as well as directly for the varibles definition. The physical properties defined directly for variables have no <long-name> and no <short-name>, and cannot be referenced.
Included in <sw-variable>
Example <sw-physic-type-1>
<desc></desc>
<sw-unit-ref>Umin</sw-unit-ref>
<sw-limits>
<phys><phys-min>0</phys-min><phys-max>8000</phys-max></phys>
</sw-limits>
<sw-resolution>20</sw-resolution>
<sw-data-type-scaling>8bit</sw-data-type-scaling>
<sw-variable-sample-rate>10</sw-variable-sample-rate>
<sw-var-init-value>0</sw-var-init-value>
<sw-var-not-av-value></sw-var-not-av-value>
</sw-physic-type-1>
<sw-physic-type-contents> Description Description of a physical data type.
Included in <sw-physic-type>, <sw-physic-type-1>
Example
<sw-physic-type-ref> Description Reference/use of a physical data type by means of a variable
Included in <sw-variable>
Example <sw-variable id="tmot">
<long-name>engine temperature</long-name>
<short-name>tmot</short-name>
<desc></desc>
<sw-physic-type-ref sw-physic-type="temp">n</sw-physic-type-ref>
<sw-variable-implementation></sw-variable-implementation>
</sw-variable>
<sw-physic-types> Description Number of physical data types
Included in <sw-data-dictionary>
Example <sw-data-dictionary>
...
<sw-physic-types>
<sw-physic-type>
...
</sw-physic-type>
<sw-physic-type>
...
</sw-physic-type>
</sw-physic-types>
...
</sw-data-dictionary>
<sw-resolution> Description Resolution, e.g. "100 Rev/m/s". Whereby only "100" is to be given, "Rev/m/s" is the unit in <sw-unit>.
Included in <sw-physic-type-contents>
Example <sw-physic-type>
<long-name>speed</long-name>
<short-name>n</short-name>
...
<sw-unit-ref>RPM</sw-unit-ref>
...
<sw-resolution>20</sw-resolution>
...
</sw-physic-type>
<sw-unit> Description Definition of a unit of measure
Example <sw-units>
<sw-unit>
<long-name>Kilometer per hour</long-name>
<short-name>kmh</short-name>
<sw-unit-display>km/h</sw-unit-display>
<sw-unit-ref>mps</sw-unit-ref>
<sw-unit-to-ref-method>0 1 0 0 3600 0</sw-unit-to-ref-method>
<sw-unit-from-ref-method></sw-unit-from-ref-method>
</sw-unit>
<sw-unit>
<long-name>Meter per second</long-name>
<short-name>mps</short-name>
<si-unit length-expo = "1" time-expo = "-1"></si-unit>
<sw-unit-display></sw-unit-display>
</sw-unit>
</sw-units>
<sw-unit-display> Description Information as to how the unit of measure shall displayed in an output medium.
Example <sw-units>
<sw-unit>
<long-name>Kilometer per hour</long-name>
<short-name>kmh</short-name>
<sw-unit-display>km/h</sw-unit-display>
....
</sw-unit>
</sw-units>
<sw-unit-ref> Description Reference to a unit of measure already defined for use
Included in <sw-compu-method>, <sw-param-content-v>, <sw-param-conten-x>, <sw-param-content-y>, <sw-physic-type-contents>
Example <sw-compu-method>
...
<sw-unit-ref>dez</sw-unit-ref>
...
</sw-comput-method><>
<sw-var-init-value> Description Initialization value for a variable
Included in <sw-physic-type-contents>, <sw-variable-implementation>
Example <sw-variable>
<long-name></long-name>
<short-name>N40</short-name>
<desc></desc>
<sw-variable-implementation>
...
<sw-var-init-value>100.000000</sw-var-init-value>
...
</sw-variable-implementation>
</sw-variable>
<sw-var-not-av-value> Description Internal value for an internal value not available cannot be given
Included in <sw-physic-type-contents>
Example <sw-physic-type>
<long-name>Drehzahl</long-name>
<short-name>n</short-name>
<desc></desc>
...
<sw-var-init-value>0</sw-var-init-value>
<sw-var-not-av-value></sw-var-not-av-value>
...
</sw-physic-type>
<sw-variable> Description Variable ( in ASAP " measurement"). Variable parameter needed for the algorithm of a control-unit function. Variables are stored as a rule in the RAM. A differentiation is made between input, intermediate (local) and output variables.
Included in <sw-variables>
Example <sw-variables>
<sw-variable>
<long-name></long-name>
<short-name>N40</short-name>
<desc></desc>
<sw-variable-implementation>
...
</sw-variable-implementation>
</sw-variable>
...
</sw-variables>
<sw-variable-implementation> Description Element for a SW variable for which implementation notes can be entered (not to be filled in manually)
Included in <sw-variable>
Example <sw-variables>
<sw-variable>
<long-name></long-name>
<short-name>N40</short-name>
<desc></desc>
<sw-variable-implementation>
<sw-base-type>UBYTE</sw-base-type>
<sw-limits>
<phys>
<phys-min>10.000000</phys-min>
<phys-max>3000.000000</phys-max>
</phys>
</sw-limits>
<sw-var-init-value>160.000000</sw-var-init-value>
<sw-addressing-method-ref>defaultAdrS</sw-addressing-method-ref>
<sw-compu-method-ref>NQ40</sw-compu-method-ref>
<sw-code-syntax-ref>csyRAMub</sw-code-syntax-ref>
</sw-variable-implementation>
</sw-variable>
...
</sw-variables>
<sw-variable-kind> Description E.g. data flow, control flow
Included in <sw-variable-implementation>
Example
<sw-variable-ref> Description Reference to <sw-variable> / RAM variable
Included in <sw-axis-individual>, <sw-axis-shift-offset>, <sw-function-modelonly-variables>, <sw-param-target>, <sw-variables-read>, <sw-variables-readwrite>, <sw-variables-write>
Example
<sw-variable-sample-rate> Description Sampling rate or resolution over time (e.g. crankshaft synchronization, every 10 ms).
Included in sw-physic-type-contents
Example
<sw-variables> Description Number of variables for a data dictionary. The structure for describing the variables is recursive and hence hierarchical structures for the variable can be established by this (e.g. Struct-Construct in C).
Included in <sw-data-dictionary>, <sw-variable-implemenation>
Example <SW-VARIABLES>
<SW-VARIABLE ID="sw1">
<LONG-NAME></LONG-NAME>
<SHORT-NAME></SHORT-NAME>
<DESC></DESC>
...
SW-VARIABLE-IMPLEMENTATION>
<SW-VARIABLES>
<SW-VARIABLE ID="sw2"></SW-VARIABLE>
</SW-VARIABLES>
</SW-VARIABLE-IMPLEMENTATION>
</SW-VARIABLE></SW-VARIABLES>
<sw-variables-read> Description Variables to which reading access from a function is possible
Included in <sw-function-export-variables>, <sw-function-import-variables>
Example <sw-function-import-variables>
<sw-variables-read>
<sw-variable-ref>TL</sw-variable-ref>
<sw-variable-ref>TMOT</sw-variable-ref>
</sw-variables-read>
</sw-function-import-variables>
<sw-variables-readwrite> Description Variables to which reading and writing access from a function is possible
Included in <sw-function-export-variables>, <sw-function-import-variables>, <sw-function-local-variables>
Example <sw-function-import-variables>
<sw-variables-readwrite>
<sw-variable-ref>TL</sw-variable-ref>
<sw-variable-ref>TMOT</sw-variable-ref>
</sw-variables-readwrite>
</sw-function-import-variables>
<sw-variables-write> Description Variables to which writing access from a function is possible
Included in <sw-function-export-variables>, <sw-function-import-variables>
Example
<team-member-ref> Description Reference to a team member
Included in <team-members>
Example <doc-revision>
...
<team-member-ref team-member="team-member-not-available">team-member-not-available
</team-member-ref>
<date>08.12.1997</date>
...
</doc-revision>
<tbd> Description "to be defined"
Included in <general-project-data>, <info>, <sample-spec>, <sw-data-dictionary-spec>, <sw-function-spec>, <sw-glossary>, <sw-param-contents-spec>, <variant-spec>
Example <sw-param-contents-spec><tbd></tbd></sw-param-contents-spec>
<tbr> Description "to be resolved"
Included in <general-project-data>, <info>, <sample-spec>, <sw-data-dictionary-spec>, <sw-function-spec>, <sw-glossary>, <sw-param-contents-spec>, <variant-spec>
Example
<topic-1> Description Chapter structure. Unlike a chapter, this does not appear in the table of contents as a separate chapter.
Included in <add-info>, <chapter>, <ncoi-1>, <sw-addressing-method-desc>, <sw-application-notes>, <sw-carb-doc>, <sw-code-syntax-desc>, <sw-function-desc>, <sw-maintenance-notes>, <sw-param-record-layout-desc>, <sw-test-spec>
Example
<topic-2> Description Introductory chapter, chapter structure. Same as topic-1 except no prms. Unlike a chapter, this does not appear in the table of contents as a separate chapter.
Included in <introduction>
Example
<used-languages> Description List of the languages used for <admin-data>. The master language is given in <language>.
Example <admin-data>
<languages>de</language>
<used-languages>de ge fr</used-languages>
</admin-data>
<variant-char> Description A description of variante features can be given here
Attributes
[type] REQUIRED: new-part-number, no-new-part-number
Included in <variant-chars>
Example <variant-chars>
<variant-char id="language" type="new-part-number">
<long-name></long-name>
<short-name>language</short-name>
<code></code>
</variant-char>
<variant-char id="transmission-type" type="new-part-number">
<long-name></long-name>
<short-name>transmission-type</short-name>
<code></code>
</variant-char>
<variant-char id="cylinder-number" type="new-part-number">
<long-name></long-name>
<short-name>cylinder-number</short-name>
<code></code>
</variant-char>
</variant-chars>
<variant-def> Description Description of variant definitions that can be referenced in <sw-funtion-variant>. The corresponding variant features ( <variant-def>) are allocated here to a variant for a variants definition and the allocation of variant feature to feature value ( <variant-char-value>, <value>) takes place.
Included in <variant-defs>
Example <variant-defs>
<variant-def id="V1">
<long-name>variant 6-cylinder automatic German</long-name>
<short-name>V1</short-name>
<code></code>
<variant-char-assigns>
<variant-char-assign>
<variant-char-ref variant-char="language">language</variant-char-ref>
<variant-char-value>
<value>de</value>
<code></code>
</variant-char-value>
</variant-char-assign>
<variant-char-assign>
<variant-char-ref variant-char="cylinder-type">cylinder-type</variant-char-ref>
<variant-char-value>
<value>en</value>
<code></code>
</variant-char-value>
</variant-char-assign>
<variant-char-ref variant-char="transmission-type">transmission-type</variant-char-ref>
<variant-char-value>
<value>automatic</value>
<code></code>
</variant-char-value>
</variant-char-assign>
</variant-char-assigns>
</variant-def>
<variant-def-ref> Description
Included in <variant-def-refs>
Example <sw-function-variant>
<variant-def-refs>
<variant-def-ref variant-def="V1">V1</variant-def-ref>
<variant-def-ref variant-def="V2">V2</variant-def-ref>
/variant-def-refs>
</sw-function-variant>
<variant-def-refs> Description
Included in <sw-function-variant>
Example <sw-function-variant>
<variant-def-refs>
<variant-def-ref variant-def="V1">V1</variant-def-ref>
<variant-def-ref variant-def="V2">V2</variant-def-ref>
/variant-def-refs>
</sw-function-variant>
|