Name

oe_create_model — create a new OpenECU model in the current directory.

Synopsis

oe_create_model {modelname} [dd [dd-name]] [part [part-number]] [issue [issue-number]] [template [template-type]]

Description

OE_CREATE_MODEL('model-name')

Creates a new OpenECU model with appropriate model settings and a 'basic' template containing a put_Identification block, as well as creating a build list and data dictionary that defaults to using a prefix of 'aaa'. The put_Identification block defaults to the 01T-068432-000 (M220-000) issue 1 target configuration.

OE_CREATE_MODEL('model-name', 'dd',       'dd-name')

Creates a new OpenECU model with appropriate model settings and a 'basic' template containing a put_Identification block, as well as creating a basic build list and data dictionary using a prefix given by 'dd-name'. 'dd-name' must be 3 characters long. The model defaults to the 01T-068432-000 (M220-000) issue 1 target.

OE_CREATE_MODEL('model-name', 'dd',       'dd-name',       ...
                              'part',     'part-number',   ...
                              'issue',    issue-number)

Creates a new OpenECU model with appropriate model settings and a 'basic' template containing a put_Identification block, as well as creating a basic build list and data dictionary using a prefix given by 'dd-name'. The model is configured for the target given by 'part-number' and 'issue-number'.

OE_CREATE_MODEL('model-name', 'dd',       'dd-name',       ...
                              'part',     'part-number',   ...
                              'issue',    issue-number,    ...
                              'template', 'template-type')

Creates a new OpenECU model with appropriate model settings take from one of the supported templates specified by 'template-type', containing a put_Identification block, as well as creating a basic build list and data dictionary using a prefix given by 'dd-name'. The model is configured for the target given by 'part-number' and 'issue-number'.

Examples

oe_create_model('my_name')

Creates a new OpenECU model named 'my_name' with a data dictionary using the prefix 'aaa' for a 01T-068432-000 (M220-000) issue 1 target.

oe_create_model('my_name', 'dd' 'mbe')

Creates a new OpenECU model named 'my_name' with a data dictionary using the prefix 'mbe' for a 01T-068432-000 (M220-000) issue 1 target.

  oe_create_model('my_name', 'dd',        'mbe',                 ...
                             'part',      '01T-068276-000',      ...
                             'issue',     2,                     ...
                             'template',  'basic-bussed')

Creates a new OpenECU model named 'my_name' with a data dictionary using the prefix 'mbe' for a 01T-068276-000 (M250-000) issue 2 target. The OpenECU model created will have a basic-bussed template.

Duplicate file naming

It is not possible to create a model if a file with a matching name already exists in the same directory. Choose a different name for the model and run the command again.

It is possible to create a model with a data dictionary file that already exists. The user will be given a choice to retain the existing data dictionary, or overwrite the existing data dictionary when the command runs.

Templates

The supported templates are:

minimal

Nothing but a put_Identification block to select the ECU target.

basic

Builds on top of the minimal template by including: configuration for the ECU target, CAN bus and CCP communications for reprogramming, signal monitoring and calibration purposes; retrieval of the version and build information for each software component programmed into the ECU for identification purposes; retrieval of basic operating variables, such as CPU loading and stack use for periodic checks on how large the application becomes over time; and a basic break down of data flow from input through to output processing ready to fill out.

basic-bussed

Identical to the basic template except that the data flow from input to output processing utilises busses making the diagram tidier.