Op03 - Implementing Panelview Plus & Versaview Ce With Rsview Machine Edition Recipeplus
Op03 - Implementing Panelview Plus & Versaview Ce With Rsview Machine Edition Recipeplus
Contents
OP03 — RecipePlus
RSTechED 2005 Rockwell Software 1 of 52
Before you begin
The general purpose of a recipe system is to allow the user to read and write a set of values
to/from a set of tags in a single operation. The ingredient data values of the recipe are saved into
the recipe file and can be downloaded to/uploaded from a controller in a single action. A single
recipe can contain up to 15 000 ingredients. The recipe file can also be restored into the
RecipePlus Table during runtime to view the ingredient data values from the recipe.
The RecipePlus Table is also used to modify the recipe data values during runtime. The
RecipePlus Table can be set as view-only to prevent modifications during runtime.
During runtime the values of the data set and tag set can be compared. Moreover, the recipe
system can also be used to compare two configured recipes or compare a data set pair or a tag
set pair of a single recipe.
The recipe you will be creating is for a Hot Sauce manufacturing firm.
You will be designing for operators that will be required to input information about the Hot Sauce
being manufactured. Depending on the spice level of the sauce the ingredient data will be saved
in three different tag sets of the recipe. The ingredient recipe information is then downloaded to a
tag set in the controller and is used to animate the manufacturing process.
• Files required
o Pre-created displays: ‘RecipeComponets.gfx’ and ‘Animation.gfx’
o Pre-created recipe file: ‘Recipe.rpp’
o Controller file: ‘RecipePlus_ControllerFile.ACD’
OP03 — RecipePlus
2 of 52 RSTechED 2005 Rockwell Software
Starting RSView Studio and Creating a Project
2. As RSView Studio is opening you will be prompted to log onto FactoryTalk. Please follow
steps a) to b) to login.
OP03 — RecipePlus
RSTechED 2005 Rockwell Software 3 of 52
a) Type in 'labuser' for
User name and
'rockwell' for Password
b) Press ‘OK’
to accept
3. Create a new project called ‘RecipePlus’ by following the steps from a) to d).
OP03 — RecipePlus
4 of 52 RSTechED 2005 Rockwell Software
b) Type in
‘RecipePlus’ as the
Application Name
c) Ensure that
‘English (US)’ is
selected by default
d) Click on ‘Create’
to create this project
OP03 — RecipePlus
RSTechED 2005 Rockwell Software 5 of 52
a) Double-Click on
‘RSLinx Enterprise’ in
the Explorer window to
expand.
b) Double-click on
Communications
Setup to open the
RSLinx Enterprise
Configuration Wizard
OP03 — RecipePlus
6 of 52 RSTechED 2005 Rockwell Software
c) Select ‘Copy an existing
configuration…’ in the
RSLinx Enterprise
Configuration Wizard
d) Click
‘Next’ to
continue
e) Select
RecipeConfiguration
f) Click ‘Finish’
to complete
OP03 — RecipePlus
RSTechED 2005 Rockwell Software 7 of 52
a) Click ‘Add’ to
add a new
shortcut. Then
type the shortcut
name as
‘RecipeShortcut’
and press Enter
a) Ensure that
the Local tab is
selected c) Expand the Ethernet driver and
scroll to and select the SoftLogix 5800
module with the IP address and node
as specified by the lab instructor.
b) Select the
‘RecipeShortcut’ by
clicking on it.
f) Click ‘Apply’
then ‘OK’ to
finish.
OP03 — RecipePlus
8 of 52 RSTechED 2005 Rockwell Software
Configuring the RSView ME Application
Before the application screens are created, some basic system configuration needs to be
performed.
a) In the Explorer
window, double-click
on the ‘Project
Settings’ to open
b) Ensure that
the ‘General’
tab is selected.
OP03 — RecipePlus
RSTechED 2005 Rockwell Software 9 of 52
e) Uncheck ‘Scale
graphic displays’
because no
display scaling is
required.
f) Click
‘OK’ to
finish
Recipes have two tag settings that are used to determine the results of various recipe operations
during runtime.
The first tag is called the Status Tag and it shows the results of download and upload operations.
The result status of these operations can be ‘start’, ‘successful’ or ‘with errors’.
The second tag is called the Percent Complete Tag. The recipe system writes to this tag during
any recipe download/upload operation to show what percent of ingredients currently being
processed have been completed.
1. Follow steps a) to e) to add the Status HMI Tag to the tag database using the Tag Editor
OP03 — RecipePlus
10 of 52 RSTechED 2005 Rockwell Software
a) Double-click on
‘Tags’ in the
Explorer window
to open the Tag
Editor.
Note: Expand the
HMI Tags folder if
needed.
d) Select
‘Memory’ as e) Click ‘Accept’
the Data to accept this
Source Type tag configuration
OP03 — RecipePlus
RSTechED 2005 Rockwell Software 11 of 52
2. Follow steps a) to e) to add the Percent Complete HMI Tag to the tag database using the Tag
Editor
a) Click on ‘New’
to create a new
tag.
OP03 — RecipePlus
12 of 52 RSTechED 2005 Rockwell Software
b) In the ‘Name’ box,
type in the name of the c) Click on the downward
tag as arrow to expand the Type
‘PercentCompleteTag’ selection box and select
‘Analog’
d) Select
‘Memory’ as
the Data
Source Type
e) Click ‘Accept’
to accept this f) Click
tag configuration ‘Close’
to finish
OP03 — RecipePlus
RSTechED 2005 Rockwell Software 13 of 52
Configuring the RecipePlus components
RecipePlus feature allows users to read/write a set of values to a set of tags in a single operation.
The RecipePlus can also be used to compare two recipes and determine their difference.
• RecipePlus Setup – used to specify whether recipe files will be a part of the HMI project
or not, and where the files will be stored for retrieval at run time.
• RecipePlus Editor – used to create and edit the recipe files by specifying the ingredients
of the recipe, the data sets, the tag sets and the recipe units. The editor can also be used
to compare data sets and tag sets within a single recipe.
• RecipePlus table object – used to display, modify and save the contents of a recipe at
run time. The table also shows the differences between the recipe data values and the
tags associated with the recipe (i.e. data set and tag set)
• RecipePlus button object – used to initiate recipe operations at run time (i.e. download,
upload, upload and create, save, restore)
OP03 — RecipePlus
14 of 52 RSTechED 2005 Rockwell Software
a) Double-click on
‘RecipePlus Setup’.
The RecipePlus
Folder is near the
bottom of the
Explorer window
c) Select ‘OK’
to finish
OP03 — RecipePlus
RSTechED 2005 Rockwell Software 15 of 52
* b) If you select ‘Recipe files are NOT part of the HMI project’, the recipe files will be saved in
an alternative location for recipe files at run time. When this option is selected, none of the recipe
files in the HMI project or in the specified folder will be included in the ME runtime application.
Follow steps a) to k) to setup the General Tab in the RecipePlus Editor. You will add the
runtime recipe name, the Status Tag and the Percent Complete Tag.
a) Double-click on
the ‘RecipePlus
Editor’, located near
the bottom of the
Explorer window.
OP03 — RecipePlus
16 of 52 RSTechED 2005 Rockwell Software
b) Select the
‘General’ tab
d) Click on ‘…’ of the
c) In the ‘Runtime
Status Tag option, to
recipe name’ box,
open the ‘Tag
type in the name of the
Browser’
recipe as ‘Hot Sauce’
e) Select the
‘RecipePlus’
folder by f) Select the
clicking on it. ‘StatusTag’ by
clicking on it
g) Click ‘OK’
to add the tag.
OP03 — RecipePlus
RSTechED 2005 Rockwell Software 17 of 52
h) Click on ‘…’
of the Percent
Complete Tag
option, to open
the ‘Tag
Browser’
i) Select the
j) Select the
‘RecipePlus’
‘PercentCompleTag’ by
folder by
clicking on it
clicking on it.
k) Click ‘OK’
to add the tag
OP03 — RecipePlus
18 of 52 RSTechED 2005 Rockwell Software
2.2 Configure the Ingredients Tab of the RecipePlus Editor
Follow steps a) to f) to setup the Ingredients Tab in the RecipePlus Editor. In this section you
will add and setup recipe Ingredients and the corresponding Data Sets and Tag Sets.
• Ingredients – they can be either of type String or Numeric. If numeric, the user can
specify a minimum and maximum data value for the ingredient. Numeric ingredients can
be boolean, integer or floating point numbers. Note: One recipe can have up to 15000
ingredients.
• Data Set – Each recipe can contain up to 50 data sets. Each data set represents the set
of data values where each data value is associated with a specific ingredient. The data
sets are to be downloaded (or uploaded) to a controller.
• Tag Set – Each recipe can contain up to 50 tag sets where each tag set represents the
set of tags to write to during a download (or read during an upload) operation. Each of the
tag names is associated with a specific ingredient.
b) Type a descriptive
name for the ingredient:
a) Select the ‘Water (L). The name can
‘Ingredients’ contain multiple words,
tab. e.g. name and units.
f) To add a Tag to
the tag set of this
ingredient press
c) Click on the ‘Type’ CTRL+T to open a
field for this ingredient to d) If the ingredient Tag Browser or
choose a data type and is of numeric type, right-click and
select ‘Number’. then you must set choose the Tag
the Min and Max Browser from the
values. Set Min=0 list.
and Max=1000. e) Set an initial
Data Set value
for this
ingredient: 100.
OP03 — RecipePlus
RSTechED 2005 Rockwell Software 19 of 52
h) Click on ‘Online’ to
g) Double-click on open the controller tags,
‘RecipeShortcut’ to shown on the right side
expand of the window.
i) Select the
‘Water’ tag
j) Click ‘OK’
to finish.
Note: If you were to add a type ‘String’ ingredient, follow the same steps a) to j). In this case the
‘Min’ and ‘Max’ value field will be left empty and the data type will be set to ‘String’.
OP03 — RecipePlus
20 of 52 RSTechED 2005 Rockwell Software
Add additional Data Sets to the RecipePlus Editor
Follow steps a) to f) to add two additional Data Sets in the RecipePlus Editor and rename the
current Data Set. Each Data Set will represent the spice level of the Red Sauce. Ensure that the
‘Ingredient’ tab of the RecipePlus Editor is open.
a) From the menu
of RSView Studio,
click on ‘Recipe’ to
open a submenu.
b) Click on ‘Rename
Data Set’. This menu can
be used to also Insert,
Delete and Rename both
Data and Tag sets.
Moreover, it is used to
compare two recipes or
the Data/Tag sets of a
single recipe.
c) Under ‘Enter
new data set name’ d) Click
delete the current 'OK' to finish
name and type in a re-naming
new name: the data set.
DataSet#1_Mild.
OP03 — RecipePlus
RSTechED 2005 Rockwell Software 21 of 52
e) From the menu of RSView
Studio, click on ‘Recipe’ to
open a submenu.
f) Click on ‘Insert
Data Set’. To insert a
new data set.
Follow steps a) to f) to configure the Units tab in RecipePlus Editor. We will add two additional
units and rename the existing unit.
• Units - A unit is a data set paired with a tag set. A single recipe can contain up to 2500
recipe units. It is the recipe units that are acted upon at runtime (e.g. Download unit).
OP03 — RecipePlus
22 of 52 RSTechED 2005 Rockwell Software
a) Select the
‘Units’ tab.
b) Click on ‘Edit’ to
edit Unit 1. You can
change the name of
the recipe unit and
also edit other
properties of the unit.
d) Click ‘OK’ to
finish editing the
unit.
OP03 — RecipePlus
RSTechED 2005 Rockwell Software 23 of 52
e) Click ‘Insert’ to
insert a new Unit.
g) Click on the
downward arrow and
Select a data set:
‘DataSet#2_Hot’.
h) Click ‘OK’ to
finish inserting a
new unit.
OP03 — RecipePlus
24 of 52 RSTechED 2005 Rockwell Software
Repeat steps e) to h) to add a third Unit for this recipe called: ‘Devil’s Advocate Hot Sauce’. In
this case choose the DataSet#3_VeryHot in step g).
j) Type in the
name of the recipe
component:
‘Recipe’.
k) Press ‘OK’
to close.
Add a ready made recipe to replace the created one to save time in completing this lab.
The ready-made recipe contains many additional Ingredients. Follow steps a) to d) to add this
recipe and overwrite the created one to save time.
OP03 — RecipePlus
RSTechED 2005 Rockwell Software 25 of 52
a) From the Explorer
window right-click on
‘‘RecipePlus Editor’ and
click on ‘Add Compnent
Into
c) Press ‘Open’
to open the
selected recipe.
OP03 — RecipePlus
26 of 52 RSTechED 2005 Rockwell Software
d) Click ‘Yes’ to
overwrite the
created recipe.
NOTE: The recipe will now contain all the required ingredients and units.
a) Open the
configured recipe by
double-clicking on it.
b) Under
‘Recipe’ menu
select ‘Compare
Recipes’.
OP03 — RecipePlus
RSTechED 2005 Rockwell Software 27 of 52
c) Select ‘Compare with a
Single Recipe’ to
compare the values of a
single recipe. If you need
to compare between two
recipes then select
‘Compare across two d) Choose the recipe to do the
recipes’. comparison with, by clicking on ‘…’. The
location of the recipe for this application
is located at: ‘C:\Documents and
Settings\All Users\Documents\RSView
Enterprise\ME\HMI
projects\RecipePlus\RecipePlus’.
Select ‘Recipe.rpp’.
e) Select to
compare only
data sets of
the chosen
recipe.
OP03 — RecipePlus
28 of 52 RSTechED 2005 Rockwell Software
Import displays – “RecipePlus Components” and “Animation”
1. Import a display
For this lab we will import a library display with the RecipePlus components (i.e. RecipePlus
Table, RecipePlus Selector and RecipePlus Buttons) already set up. We will also import an
Animation display which corresponds to the recipe ingredients created in this lab.
a) Right-click on
‘Displays’ and select ‘Add
component Into
Application’ to add the
library recipe component.
b) Browse to ‘C:\OP03\ME
Recipe Plus Lab\GFX’ and
select
‘RecipeComponents.gfx’.
c) Press ‘Open’
to open the
selected library
file.
OP03 — RecipePlus
RSTechED 2005 Rockwell Software 29 of 52
Repeat steps a) to c) to import the ‘Animation’ display, which demonstrates an animation of the
RecipePlus ingredient values. In this case, the display name to import, from step b) is named
‘Animation.gfx’.
OP03 — RecipePlus
30 of 52 RSTechED 2005 Rockwell Software
c) The added library
display ‘Animation’
should appear like
the display below.
NOTE: If you would like to add all the RecipePlus components manually you would need to do
the following:
Click on ‘Objects’
menu to expand the
submenu.
Click on
‘RecipePlus’, then
select RecipePlus
Selector or
RecipePlus Table
or RecipePlus
Button.
OP03 — RecipePlus
RSTechED 2005 Rockwell Software 31 of 52
During runtime the RecipePlus Table can be read-only. In this case the ingredient data values of
the recipes cannot be modified at runtime.
a) Double-click on the
RecipePlus Table object of
the ‘RecipeComponents’
display. This property window
can also be used to modify
other properties of the recipe
b) In the ‘RecipePlus
objects.
Table Properties’ click
on the ‘Recipe’ tab.
The RecipePlus system can be used to compare data sets of two different recipes, tag sets of two
different recipe, and data sets vs. tag sets of a single recipe.
OP03 — RecipePlus
32 of 52 RSTechED 2005 Rockwell Software
The RecipePlus system has a button with five different action properties. The button types and
their functionality descriptions are summarized in the table below:
Download Writes the data values of all the ingredients to the tags in the controller.
Upload Reads the ingrediant values from the tag set and saves them to the data
set in the recipe file.
Upload and Create Reads the tag values in the tag set and creates a new recipe unit by
writing those values to a new data set.
Save Saves the data value changes made in the Table back to the recipe file.
Restore Restore means to read the recipe file and display it in the table. Viewing
the recipe in the table will show the user the data values in the recipe, the
data values currently in the controller and the tag names used.
Review the configured button action properties to learn about how to set them up.
OP03 — RecipePlus
RSTechED 2005 Rockwell Software 33 of 52
b) Click on the ‘General’ tab
of the ‘RecipePlus Button
Properties’.
c) Using the
downward arrow,
select the ‘Action’ of
the button. In this case
it is ‘Download’.
e) In the ‘Caption’
space, you can type in
the text that you would
like to appear on the
button.
f) Click
‘OK’ to
complete.
OP03 — RecipePlus
34 of 52 RSTechED 2005 Rockwell Software
How RecipePlus Works at Runtime
Follow steps a) to f) to setup the ‘RecipeComponents’ as the start-up display at runtime and test
run the application.
a) Double-click on
‘Startup’ in the
Explorer Window.
OP03 — RecipePlus
RSTechED 2005 Rockwell Software 35 of 52
b) Click on the
check box of ‘Initial
graphic’ to select. c) From the list choose
‘RecipeComponents’
display as the initial
display.
d) Click ‘OK’
to complete.
The RecipePlus Selector object is used to view all units of all the configured recipes. You can
select any of the units in the RecipePlus Selector and restore the ingredients into the
RecipePlus Table, using the Restore button.
OP03 — RecipePlus
36 of 52 RSTechED 2005 Rockwell Software
Before using the Recipe Buttons the application of the two RecipePlus diagnostics tags, Status
Tag and Percent Complete Tag will be explained.
1.1 Please read steps a) to b) and view the Diagnostics while using the buttons at runtime.
OP03 — RecipePlus
RSTechED 2005 Rockwell Software 37 of 52
2. Modify the ingredient data values
After restoring the recipe unit, the Recipe Table lists all of the ingredients, the corresponding
recipe values, controller values, the tags and a visual comparison indicator between the recipe
data values and controller tag values.
The definitions of what each column represents during runtime of a RecipePlus Table is
summarized below:
Recipe Value Displays the recipe's data value for the ingredient.
This data value can be modified by selecting the
ingredient row in the table and pressing Enter.
Compare Status If the tag value and the recipe data value differ, an
X appears in this column to alert the operator of the
difference.
Tag Name Displays the name of the tag associated with the
ingredient in the tag set.
OP03 — RecipePlus
38 of 52 RSTechED 2005 Rockwell Software
2.1 To modify the data values of an ingredient of a recipe unit, follow steps a) to d).
After changing the value of the ingredient the ‘Recipe’ column will update to the new data value
for the corresponding ingredient.
OP03 — RecipePlus
RSTechED 2005 Rockwell Software 39 of 52
3. Using the Recipe Buttons
Using the buttons we can save the recipe data values, download to a controller, upload from a
controller and upload and create a new unit.
3.1 Follow steps a) to d) to save the recipe data values and download to a controller.
b) The ‘Compare’
column indicates with an c) Download the
‘X’ that the controller recipe data to
ingredient value and the the controller by
value in the recipe differ. pressing the
‘Download’
button.
3.2 Follow steps a) to d) to Upload the controller values to the recipe and Create a new Recipe
Unit.
The new unit will represent a Green Hot Sauce. Using the same Recipe file we can make multiple
recipe units during runtime, allowing us to create both Green Sauce and Red Sauce without going
offline. Both of these units are using the same Recipe Ingredients with different data values.
OP03 — RecipePlus
40 of 52 RSTechED 2005 Rockwell Software
a) Press on the
‘Update and
Create’ button
create a new recipe
unit.
OP03 — RecipePlus
RSTechED 2005 Rockwell Software 41 of 52
d) Check in the ‘Recipe Selector’ that
the new Recipe Unit ‘Green Sauce –
Hot’ has been successfully added.
The Status tag in the Diagnostics
should also display that the unit creation
was successful.
If you would like to modify this newly created Recipe unit you can do the following section. This
section does not need to be done for this lab.
The new Recipe unit can be ‘Restored’ into the Recipe Table, the ingredient values can be
modified and downloaded to a controller to make a new recipe – Green Sauce.
Follow steps a) to c) described in 2.1 of this section to input the example ingredient data values
for the Green Sauce. The data values are summarized in the following table:
OP03 — RecipePlus
42 of 52 RSTechED 2005 Rockwell Software
After modifying the ingredient data values please follow steps a) to d) to download recipe data
values of the ‘Green Sauce’ recipe unit to a controller.
Any animation can be created to accompany the RecipePlus functionality. It can be used as a
graphical representation of the recipe. In the case of the recipe we created for this lab, the
animation describes step by step how the Hot Sauce is made and is using the values the user
input into the RecipePlus Ingredients.
a) Click on ‘GoTo
ANIMATION’ to go to
the animation display.
OP03 — RecipePlus
RSTechED 2005 Rockwell Software 43 of 52
b) Press ‘Press
START to begin!’ to
start the animation.
NOTE: A warning will occur while the ‘Test Application’ mode is shutting down. The
warning explains that all the changes made to a recipe during the ‘Test Application’ mode
will not be saved. Please click ‘OK’ to close the warning message box.
Optional Section
Before running the application on a terminal we must resize the project to correspond to the size
of the terminal. Follow steps a) to h) to resize the project to fit the terminal size.
OP03 — RecipePlus
44 of 52 RSTechED 2005 Rockwell Software
Follow the table below to select the appropriate window size:
a) In the Explorer
window, double-click
on the ‘Project
Settings’ to open
b) Ensure that
the ‘General’
tab is open
OP03 — RecipePlus
RSTechED 2005 Rockwell Software 45 of 52
d) Click on the
‘Runtime’ tab to
open.
g) Check the
‘Scale graphic
displays’ and
the sub-boxes,
because we want
to scale our
project to fit the
terminal size.
h) Click
‘OK’ to
finish.
OP03 — RecipePlus
46 of 52 RSTechED 2005 Rockwell Software
2. Set the target tab in the communications setup
a) Double-Click on
‘RSLinx Enterprise’ in
the Explorer window to
expand.
b) Double-click on
Communications
Setup to open the
RSLinx Enterprise
Configuration Wizard
OP03 — RecipePlus
RSTechED 2005 Rockwell Software 47 of 52
c) Click on the
‘Target’ tab of the
‘Communications
Setup’.
g) Click ‘Apply’ to
h) Click ‘OK’ to complete
apply the shortcut
the Target tab
to the device.
configuration.
Follow steps a) to f) to create the runtime file of the application to download to the terminal.
a) Click on ‘Application’,
then ‘Create Runtime
Application’, in the
RSView Studio menu.
OP03 — RecipePlus
48 of 52 RSTechED 2005 Rockwell Software
b) Save the runtime application, to
‘C:\Documents and Settings\All
Users\Documents\RSView
Enterprise\ME\Runtime’ (which is
the default directory) and click
‘Save’.
c) The ‘Creating
runtime file’ window
will be displayed, while
the runtime file is
being created.
OP03 — RecipePlus
RSTechED 2005 Rockwell Software 49 of 52
d) From RSView Studio
icon menu click on the
Transfer Utility icon to open
the Transfer Utility and
transfer the file to a terminal.
OP03 — RecipePlus
50 of 52 RSTechED 2005 Rockwell Software
a) Click on ‘Load
Application’, select the
RecipePlus file and click
‘Load’. Click ‘Yes’ to
‘Replace
c) After the application
Communications….’. finishes loading click
on ‘Run Application’.
OP03 — RecipePlus
RSTechED 2005 Rockwell Software 51 of 52
Notes
OP03 — RecipePlus
52 of 52 RSTechED 2005 Rockwell Software