CHG file

The CHG file is a script for testing the component settings, and controls the component behaviour in the Component Inspector view in Processor Expert.

This file should implement implementation-independent tests and report errors if the component setting is incorrect (component function is not defined for this component settings). For example, the CHG file can generate error if the buffer size is lower than 16 bytes. You can generate error messages using commands: %error, %warning, %hint or you can change or read the value of any property/method/event using special commands %set and %get. These commands can be used only in CHG files.

The following is the syntax of Set command:

%set {Symbol} {FeatureSymbol} {Value}

Description:

{Symbol} is a symbol of any property, method, or event
{FeatureSymbol} is a symbol from following list
{Value} is a new value for the feature. Value is text to the end of line.

List of FeatureSymbols:

ReadOnly - you can enable/disable changing of value of any property.
{Symbol} must be symbol of any property.

{Value} must be yes or no.
Selection - you can enable/disable changing of selection of any method or event, for example, if method will be generated to the driver and if event will be called from the driver.
{Symbol} must be symbol of any method or event.

{Value} must be
- always (the method/event must be selected) or
- never (the method/event cannot be selected) or
- enable (you can change selection)
Value - you can change the value of any property.
{Symbol} must be symbol of any property.

{Value} must be value for the property (the same as you can enter in the Processor Expert Component Inspector). Integer value can be expressed in enhanced format.
MinValue, MaxValue - you can change the minimal and maximal possible value of the property.
{Symbol} must be symbol of property of type: integer number, real number, or list of items.

{Value} must be decimal number.

Warning: If you change any value of the property, the macros are NOT changed to the end of CHG file. You can read the value of any property using %get command.

The following is the syntax of Get command:

Syntax:

%get({Symbol},{FeatureSymbol})

List of known symbols is the same as for %set command. Result is value of selected feature.

Example:

%if defined(Property1) & Property1="MASTER"

%error Sorry - this feature is not implemented yet.

%endif

%-

%if defined(OutputBufferSize) & OutputBufferSize="0"

%set SendData Selection never

%else

%set SendData Selection enable

%endif

There is complete component BasicProperties in this version of CDE. This component contains example of CHG file and TST file.