CHG script: setting control script

The scripts serve for HW-independent as well as HW-dependant test of setting of the given component or compiler with the possibility of changing the setting (that is setting for specific component properties, methods and events or compiler setting). The scripts are located in the component directory (the same as with the *.bean file); the extension reads as chg; for types and naming of scripts, see CHG script types topic. These files are processed by PE in the same way as that for the drivers, starting them directly without using the src files; in addition, these files can employ the %set command. The DriverExtension macro will have the chg value. Unlike the src file, the existence of the CHG script file is not required. The output from this script will not be saved anywhere, only errors, warnings and hints will be displayed and item setting will be executed using the %set command. Other non empty line generated to output is considered as wrong CHG script. Generating errors directly for the corresponding item using the " %set Property Error ErrorMessage" command is recommended.

Note: Within the CHG script file processing, the symbols defined will not be changed, even if the item value is modified by the %set command. The current item setting value (for example, after the %setMethod Selection enable command) can be tested using the %get command. Instead of testing the value of the corresponding symbol, only use of the %get command is recommended.

The CHG script file will be processed each time the component setting is modified regardless of correctness of the setting or if a target processor had been selected or not. During the process above, some symbols may not be defined (no symbol will be guaranteed). Within the CHG script file, work will be possible only with the symbols valid for the given component, but not with global symbols. Inserting the component into the project will open CHG script with the defined BeanInitialization symbol (which does not apply for project loading); during project loading CHG file is executed after component is loaded with symbol _SpecialBeanCompatibilityInitialization defined; creation of inherited component will invoke CHG script of parent component with symbol _BeanInInheritedItemInitialization and its value is symbol of property, that contains new inherited component.

In addition, during execution of CHG script will be defined the symbol CHG_BeanIsEnabled with yes or no values provided information if the component is enabled.