%set ReqValue <value>=<reason>

The command creates a request for setting up a value of CPU component item, inherited component, linked component or item of actual component itself, required from the actual component. Value will be set according to the request and will be read only. After the request is cancelled (i.e. component disabled) the initial value of the item will be reset.

It is correct to use several different values (change the value according to the current component setting). For reset is always used the initial value (value used before first ReqValue request). If different components asked for different values, target item will issue an error.

Note: Item initial values are stored into the project, after loading the project the required value will be set from CHG script.

The value must have the format <value>=<reason>, where <value> is the requested item value. Generally value displayed in the second column shall be used with the following exceptions:

value for integer properties must be in format D:num, where num is a decimal number;
value for time property must be in format H:m:s, for example 13:30:55;
value for date property must be in format yyyy-mm-dd, for example 2012-01-31;

<reason> is the reason for the request shown in the hint. For enumeration items it is also possible to use format #DefinedValue:<def-value>=<reason>, where <def-value> is value defined from the item (it depends on settings of the property). For boolean items, it is also possible to use format #Bool:<yes/no>=<reason>.

The request is cancelled by setting up the value $=NONE=$ .

Cancelation of all requests from the current component to all items in the target component excluding the TTmngItem and TPrscItem and TListItem items may be done by entering the value $=CLEAR-ALL=$ into any item of the target component. It is recommended to cancel all the requests on the start of CHG script and after that set up all of them again. This is because it is not easy to cancel previous requests (i.e. after switching the peripheral). If there is no need to cancel all the requests (for inherited components, linked components and the component itself, because all the requests are always updated), value $=CLEAR ALL NOT APPLICABLE=$ should be used (only suppress the error message from the PE).

All settings and cancelations of requests are done immediately during the command execution, so the interrupt and the following value setup may cause reallocation of the peripheral, invalidate the calculated timing and also malfunctioning of the whole PE project.

Supported is a setup of boolean, enumeration, prescaler type items.

Above that for inherited and linked components items string, priority, integer (value must be in the format D:num), enumeration-group, periphery, signal name (pin), +/- list are supported.

Limitations list ( TListItem, TListItemFromFile) items: ReqValue cannot change value outside range selected by Min/MaxValue of the list item.