LabVIEW utilities - sequences or recipes

Using Recipes on New or Existing LabVIEW Programs

MANUAL

version 20070716

GENERAL

recipe.vi is a top-level vi in recipe.llb.

recipe.vi is a separate utility, which, through recipes, can automatically perform actions on an existing vi.

Working with recipes has several advantages over working manually:

• the operator doesn't have to stay close to the PC
• the process variables can be changed with high speed
• typing errors during the process can be avoided
• repeated data entry can be automated

A recipe is a list of commands. Small recipes can be made or changed with the built-in editor. However, it is recommended to use Notepad or an equivalent editor. The recipes are simply stored as ASCII files, ending with '.rcp', and can be read by this utility.

Recipes will be executed line by line. One line may contain several, ';' separated commands. The following sections describe all existing commands. Anything else will be regarded as comment.

Recipes may contain empty lines. Two consecutive empty lines will be regarded as the end of the recipe.

COMMANDS

In order to present all commands, they have been grouped as follows:

• adjust controls
• delay
• repeat
• jump

All commands start with a unique keyword.

adjust controls

A recipe can adjust the controls of a vi. These are both input fields and knobs, but also indicator fields. The following keywords can be used to change, differently typed, controls:

• 'aout', 'mfc' and 'heater': an alias of 'dbl', for real numbers e.g. 12.65
• 'index': an alias of 'i32', for integers e.g. 3
• 'dout', 'valve' and 'button': an alias of 'bln', for booleans being either 'on' or 'off'
• 'text' and 'command': an alias of 'str', for text e.g. "regeneraton phase"

The abovementioned keywords are being used as follows:

keyword variable name value

Spaces separate the parts of a complete command. The variable name may also contain spaces.

The value that comes with the 'text' command may also contain spaces in which case it must be placed within quotation marks.

Examples:

mfc mfc_H2 12.65; sets mass flow controller 'mfc_H2' to 12.65
index 6 way valve 3; sets 6 way valve '6 way valve' to 3
valve V102 off; turns valve 'V102' off
text status "regeneration phase"; sets status text 'status' to "regeneration phase"

Besides adjusting simple controls it is possible to adjust controls in clusters or in arrays too. Use the following notation to point to a cluster element:

clustername.elementname Example: heater heater1.setpoint 20.0 The control setpoint, which is part of the cluster heater1, will be set to 20.0.

Change an element of an array by adding the index of the element, preceded by a '/', to the name of the array. For example:

valve ValveArray/3 on This command turns the 4th valve (index counting starts at 0) to 'on'.

delay

The command for a delay is:

delay amount unit This command can be used to set a delay in seconds, minutes or hours. The actual delay can be slightly different from the desired delay. The command for a delay of 1 second, 10 minutes and 2 hours respectively, must be given as follows: delay 1 s;
delay 10 m;
delay 2 h;

If a line contains more than one delay, only the last will be executed. And a delay will only be executed after all other commands of the same line have been executed.

By default the unit is in seconds.

An alternative delay command waits until a specific condition is met:

waitfor variablename condition[|timeout[|on_timeout_goto]]

Without a timeout the recipe will be paused until the condition is met.

With a timeout the recipe will continue even if the condition is not met, yet after the given delay in seconds. If no 'on_timeout_label' was given, the recipe will continue at the next line. Or else the recipe will continue at the labelled line¹⁾.

The variable can be a boolean type control. The condition can only be either 'true' or 'false':

waitfor my condition true This pauses the recipe until 'my condition' has become true. Until the condition is met, 'my condition' will blink.

The variable can also be a numeric control. The value of that control can be compared with a constant or another control^{2) 3)}:

waitfor variablename operator constant:margin[|timeout[|on_timeout_goto]] For example: waitfor heater2 >75:2|40|error_heater2 If heater2 is 75 or more, with a margin of 2, then the recipe will continue at the next line. If this is not the case within 40 seconds the recipe will continue at the line labelled 'error_heater2'.

1) A label is unique word without spaces, preceded by a ':'. 
2) Currently the name of the other control may not contain spaces and the variable
   must have been used elsewhere in the recipe as a first variable e.g. in a 'foreach' loop.
3) There should be no space between the operator and constant or named control.

repeat

The commands for a program loop are:

foreach variablename values
next variablename For example: foreach I 2,4,8
== part to be repeated
next I This command structure repeats the lines of the recipe between the 'foreach' and 'next' for each of the given values. The values must be comma separated and may contain no spaces.

If instead of 'I' an existing variable name (of a numeric input) like 'real_value' is being used, then the loop may also contain the following command:

set real_value This will set the numeric field 'real_value' to 2, 4 and 8 respectively.

The 'andeach' command complements the 'foreach' command:

andeach variablename values This command can be placed inside a 'foreach' program loop, preferably right after the 'foreach' command. With this structure it is possible to get values from a second series of values just like the 'foreach' command gets values from the first series of values. For example: foreach value_1 12,34,56
andeach value_2 2 56,34,21
== common part to be repeated
set value_1
set value_2
next value_1 There is no 'next' command for the 'andeach' command. The number of values after the 'andeach' command should be the same as after the 'foreach' command. If it is smaller, then the remaining iterations will use 0. If it is larger, then the surplus values are left unused.

jump

The command to jump to a specific line in a recipe is:

goto label

The normal program flow is that the lines of the recipe will be executed one after the other. This command forces the recipe to continue at the line containing the label.

For example:

goto proceed
== part to be skipped
:proceed It is possible to use the 'goto' command within a program loop. But jumping into a loop or out of a loop should be avoided.

Jumping to a specific recipe line may depend on a specific condition.

If a numeric control must be compared to a constant or another control¹⁾, then this is the command to use:

if variablename condition|goto The condition looks like this: operator constant:margin

If the condition is met, then the recipe will be executed at the line marked with the 'goto' label. If not, then the next line in the recipe will be executed.

Valid operators are '=' ( 'equals'), '!=' ('doesnt_equal'), '>' ('greater_than') and '<' ('less_than').

For example:

if temperature >72.5|cool_now This will jump to 'cool_now' if the temperature exceeds 72.5.

The 'if' command is suitable for boolean type controls as well. The condition is either 'true' or 'false'.

For example:

if LED true|exception If indicator LED is true, then the recipe continues at the line labelled 'exception'.

1) The name of the other control may not contain spaces.

USERINTERFACE

The user interface contains 3 tabbed pages, 'recipe', 'options' and 'about', and a common taskbar.

The 'recipe' page shows the recipe and buttons to load a recipe (LOAD) or to save the recipe (SAVE). Also a loaded recipe can be erased (NEW). The remaining buttons have the same functionality as the similar buttons on the taskbar.

On the 'recipe' page, 'vi path' should indicate for which program (vi) the recipe is intended.

The 'recipe state control' can be used to force the recipe into a different state.

The 'options' page states which aliases can be used for changing controls. If desired, aliases can be added, making recipes even more readable, or deleted, making recipe execution slightly faster.

On the 'options' page 'inverted boolean controls' lists the boolean controls that work in an irregular way. When using valves, 'true' stands for 'open' and 'false' stands for 'close' by default. Controls set down in this list act the other way round. In this way a 'normally closed' and 'normally open' valve can take the same command, whereas, from a logic point of view, the opposite will happen.

The 'about' page contains a brief explanation on how to create a recipe. The 'all control specs' table on this page shows which variable names were found in the selected program. Likewise the 'selected control specs' table shows which variable names were used in the recipe thusfar.

The common taskbar contains buttons to start (START), to either pause (HOLD) or resume (CONTINUE) and to stop (STOP) the recipe. Also the common taskbar contains the button to stop the program (QUIT).

While the recipe is executing the active line will be highlighted. Should the active line end up outside the visible area of the recipe, then the program will automatically shift the list of commands in such a way that it will make the active line reappear.

If a recipe has been paused with the HOLD button, it can be stored to file. The recipe will then resume just like would happen with the CONTINUE button.

REMARKS

Commands to adjust the value of a numeric control can be mixed. A command to adapt an integer value could be replaced by the command to adapt a real value. This should be used as an exception and should be checked for each individual case.

Commands to adjust integer values can also be used to adjust enumerated values. A later version of this utility might enable the use of selection names instead of selection numbers.

Recipes may contain commas. Commas can be used as decimal symbol or for digit grouping depending on regional options. Think of modifying these options at erratic behaviour.

This utility only uses rudimentary error handling. Therefor test any recipe without running the vi that should be automated.

AUTHOUR

Bart Boshuizen / SSC-ICT 3xO

Bld	: DelftChemTech
	  Julianalaan 136
Room 	: 0.044
Phone	: +31 15 2785073
Web	: www.morechemistry.com

COMMAND SHORTLIST

keyword:	command group
andeach	repeat
bln*	adjust controls
dbl*	adjust controls
delay	delay
foreach	repeat
i32*	adjust controls
if	jump
goto	jump
next	repeat
set	repeat
str*	adjust controls
waitfor	delay

* or one of its aliases.

Other information

For downloads and additional information please visit the Bart Boshuizen, 2007/07/10