You are on page 1of 15

January

2005

Working with the


FBD Graphic Library
for RSView Studio
Working with the FBD Graphic Library for RSView Studio

END-USER LICENSE AGREEMENT FOR COMPLIMENTARY SOFTWARE

IMPORTANT – READ CAREFULLY: This End-User License Agreement (“Agreement”) is a legal contract between you ( “Licensee”
or “you”) and Rockwell Automation Inc. ("Licensor") for the software product entitled RSView Studio FBD Graphic LIbrary (the “Software”)
which is being provided by Licensor to Licensee on a complimentary basis in “AS IS” condition for Licensee’s internal use.

BY CLICKING THE [ENTER] OR [ACCEPTED] ICON BELOW, OR BY INSTALLING, COPYING, OR OTHERWISE USING THE
SOFTWARE APPLICATION, YOU AGREE TO BE BOUND BY THE TERMS OF THIS AGREEMENT. IF YOU DO NOT AGREE TO THE
TERMS OF THIS AGREEMENT, DO NOT INSTALL OR USE THE SOFTWARE APPLICATION.

License Terms

1. License Grant. Licensor hereby grants to you, and by accepting this Agreement in a manner described above, you accept, a
nonexclusive license to use the Software, provided in machine-readable, object-code form, only as authorized in this Agreement.

Licensor further grants you the right to reproduce the Software solely for the purposes of your internal use of Software on computers
owned, leased, or otherwise controlled by you. Any copies of the Software or any related user documentation shall include Licensor's
copyright and other proprietary notices.

You agree that you will not assign, sublicense, transfer, pledge, lease, rent, or share your rights under this Agreement. You agree that
you may not reverse assemble, reverse compile or otherwise translate the Software.

2. Licensor's Rights. The Software and related user documentation are proprietary products of Licensor protected under U.S.
copyright law. All right, title, and interest in and to the Software, including associated intellectual property rights, are and shall remain with
Licensor. This Agreement does not convey to you an interest in or to the Software, but only a limited right of use revocable in accordance
with the terms of this Agreement.

3. License Fees. The Software is provided without charge. Other fees are payable only as separately stipulated by Licensor and
agreed to by you.

4. Term. This Agreement is effective upon the earlier of your acceptance of this Agreement as described above, and shall continue
until terminated. You may terminate this Agreement at any time by returning the Software and all copies thereof and extracts there from to
Licensor. Licensor may terminate this Agreement upon prior notice at any time. Upon such termination by Licensor, you agree to return to
Licensor the Software and all copies and portions thereof.

5. No Warranties. The Software is provided "AS IS," without any representation or warranty whatsoever. LICENSOR DISCLAIMS
ANY AND ALL WARRANTIES, WHETHER EXPRESS OR IMPLIED, INCLUDING, WITHOUT LIMITATION, ANY IMPLIED WARRANTIES
OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.

Licensee assumes the entire risk of using the Software. IN NO EVENT WILL LICENSOR BE LIABLE TO YOU FOR ANY
CONSEQUENTIAL, INCIDENTAL OR SPECIAL DAMAGES, INCLUDING ANY LOST PROFITS OR LOST SAVINGS, EVEN IF A
REPRESENTIVE OF LICENSOR HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES, OR FOR ANY CLAIM BY ANY
THIRD PARTY.

6. Governing Law. This Agreement shall be construed and governed in accordance with the laws of the State of Wisconsin.

7. No Waiver. The failure of either party to enforce any rights granted hereunder or to take action against the other party in the event
of any breach hereunder shall not be deemed a waiver by that party as to subsequent enforcement of rights or subsequent actions in the
event of future breaches.

Page 2 of 15
March 2005
Working with the FBD Graphic Library for RSView Studio

Table of Contents
Document Purpose ........................................................................................................................................................................................... 4
Document Layout.............................................................................................................................................................................................. 4
Assumptions ..................................................................................................................................................................................................... 4
Hardware, Software, and Firmware Used......................................................................................................................................................... 4
How to use the FBD Graphic Library in RSView Studio ................................................................................................................................... 5
Step 1 - Importing the FBD Graphics into RSView Studio ........................................................................................................................... 5
Step 2 – Creating a display with an RSView Studio FBD Graphics ............................................................................................................. 7
Step 3 - Creating a Parameter File............................................................................................................................................................. 10
Step 4 - Configuring a Goto Display Button ............................................................................................................................................... 11
Step 5 – Create RSView Tags to Manage FBD Graphic............................................................................................................................ 12
Instructions for each individual FBD Graphic.................................................................................................................................................. 13
Logix_ALM (ALM function block)................................................................................................................................................................ 13
Logix_D2SD (D2SD function block) ........................................................................................................................................................... 13
Logix_D3SD (D3SD function block) ........................................................................................................................................................... 13
Logix_ESEL (ESEL function block) ............................................................................................................................................................ 13
Logix_PIDE (PIDE function block).............................................................................................................................................................. 13
Logix_RMPS (RMPS function block).......................................................................................................................................................... 14
Logix_TOT (TOT function block) ................................................................................................................................................................ 14
Differences Between the RSView Studio FBD Graphic Library and the ActiveX FBD Faceplates................................................................. 15
General Differences ................................................................................................................................................................................... 15
Ramp/Soak Graphic ................................................................................................................................................................................... 15
Alarm Graphic ............................................................................................................................................................................................ 15
PIDE Graphic ............................................................................................................................................................................................. 15

Page 3 of 15
March 2005
Working with the FBD Graphic Library for RSView Studio

Document Purpose
This document explains how to use the FBD Graphic Library for RSView Studio. Additionally, this document describes differences in
operation between these graphics and their ActiveX versions. Once you understand this document, you'll be able to effectively use the
FBD Graphic Library for RSView Studio in your HMI screens.

Document Layout
This document describes the steps required to import the FBD graphics into RSView Studio and create displays using them. In addition, it
provides you with specific instructions on an FBD graphic type basis, as well as covering other information you should know prior to using
them in your application. Lastly, we'll discuss the differences between the FBD graphics for RSView Studio and their ActiveX counterparts.

Assumptions
This document assumes that you are familiar with RSView Studio, that you have properly setup the communications in RSLinx Enterprise
and defined a device shortcut for your target controller. Additionally, it also assumes that a program, containing the FBD instructions for
which you want to use these FBD graphics, is running in your Logix5000 controller.

Hardware, Software, and Firmware Used


The following hardware, software, and firmware were used when developing the information in this document:
• 1756-L63/A f/w rev 13.x (ControlLogix5663 Controller)
• RSView Studio 3.20
• RSLogix 5000 v13.x

Page 4 of 15
March 2005
Working with the FBD Graphic Library for RSView Studio

How to use the FBD Graphic Library in RSView Studio


Step 1 - Importing the FBD Graphics into RSView Studio
This section of the document describes how to import the FBD graphics in your RSView Studio project. The procedure is the same whether
you intend to use the graphics in a Supervisory Edition (SE) or Machine Edition (ME) project. The example shown below is based on using
the FBD graphics into an ME project.

Important: There are two different sets of FBD graphics, one to be used in RSView Studio SE and one for ME. This is because
the set of graphic objects supported by SE and ME is different.

1. Unzip the file containing the FBD graphics for ME on your desktop. For example to a folder called FBD_Graphic_Library_ME.
2. Start RSView Studio, by selecting Start-> Programs-> Rockwell Software-> RSView Enterprise -> RSView Studio
3. Select the type of product from the Product Type Selection dialog. For example Machine Edition and click Continue.

4. Select the New tab, enter the project name and click Create:

Important: You can also import the FBD graphics into an existing project.

Page 5 of 15
March 2005
Working with the FBD Graphic Library for RSView Studio

5. Right-click on the Libraries icon in the Application Explorer view and select Add Component Into Application… from the context
menu.

Important: You can also add FBD graphic files into to your RSView Studio project by dragging and dropping them onto the
Displays icon in the Application Explorer view.

6. Browse to the FBD_Graphic_Library_ME folder and select one or all of the graphics as you need. In this example, we will select
them all, and click Open.

7. The following dialog box will appear to show the progress while the FBD graphics are being imported.

8. All the FBD graphics are now available in your Library and are ready to be used. This concludes step 1.

Page 6 of 15
March 2005
Working with the FBD Graphic Library for RSView Studio

Step 2 – Creating a display with an RSView Studio FBD Graphics

All of the new graphics are just like the other regular library graphics that come preinstalled in RSView Studio in that you only need to copy
them to your display and tie them to the proper tags to get them to work.

Typically, each graphic in the library is made of two or more objects:

Faceplate detail
graphic

How to use instructions

Faceplate graphic

Page 7 of 15
March 2005
Working with the FBD Graphic Library for RSView Studio

To use one of the FBD graphics do as follows:


1. Select the graphic that you would like to use by double-clicking on its icon in the Libraries view. For example double-click on the
Logix ALM.

2. Select all the graphical objects in the Logix_ALM graphic by pressing the keys [Ctrl]+A . Then copy all the objects by either
pressing the keys [Ctrl]+C or by selecting Copy from the Edit menu.

Page 8 of 15
March 2005
Working with the FBD Graphic Library for RSView Studio

3. Right-click on the Displays icon in the Application Explorer view and select New from the context menu.

4. To paste the FBD graphic objects either use the keys [Ctrl] +V or select Paste from the right-click context menu.

5. Save your display. For example as MyALMDisplay.

6. You have now copied the Logix_ALM FBD graphic from the library into a new display and then you saved the new display. This
concludes step 2.

Page 9 of 15
March 2005
Working with the FBD Graphic Library for RSView Studio

Step 3 - Creating a Parameter File


Each graphic uses tag parameters (for example #1, #2, #3, etc.) as placeholders for the function block instruction backing tag name(s) that
the graphic will be connected to. Use a parameter file to define the path to the function block instruction backing tag you wish to connect to.

You can either load the parameter file as part of the Startup configuration for your startup display in your RSView Studio project or most
often you will assign a parameter file to a Goto Display Button ( ) object to launch the display containing the FBD graphic in an ME
project. You can use a Button ( ) object to launch the display containing the FBD graphic in an SE project by configuring the Action
properties. You can also use a Display List Selector ( ) object to launch displays containing FBD graphics. Just assign a graphic display
and its corresponding parameter file for each state. This object is available in both SE and ME.

To create a parameter file do as follows:


1. Right-click on the Parameters icon in the Application Explorer view and select New from the context menu.

2. Enter the information following this syntax Parameter=[Device Shortcut]Backing_Tag_name. Where the Device Shortcut is what
you defined in the Communication Setup dialog and the Backing_Tag_name is the name of the backing tag for the FBD
instruction running in the Logix5000 controller.

3. Enter all parameters as required by the FBD graphic and then save the parameter file.

4. You have now created the parameter file that includes the association between the parameter numbers, for example #1, and the
path to the FBD instruction backing tag in the controller. This concludes step 3.

Page 10 of 15
March 2005
Working with the FBD Graphic Library for RSView Studio

Step 4 - Configuring a Goto Display Button


To create and configure a Goto Display button do as follows:
1. Add a Goto Display button ( ) on the display from which you want to navigate to the display containing the FBD graphic. You
could for example add the Goto Display button onto your Startup display.
2. Right-click on the button and select Properties.

3. In the Display settings box set the name of the display containing the FBD graphic, and select its parameter file, which defines
the path to the FBD graphic backing tag in the controller. In the example below, we have selected MyALMDisplay as the display,
and MyALMParameter as the parameter file.

4. Click OK to close this dialog. This concludes step 4.


Page 11 of 15
March 2005
Working with the FBD Graphic Library for RSView Studio

Step 5 – Create RSView Tags to Manage FBD Graphic

Create any RSView tags that are required to manage the FBD graphic as directed in the How to Use Instructions text box available in the
graphic. This text box is for informational purpose only and does not need to be included in the display containing the graphic.

Faceplate detail
graphic

How to use instructions

Faceplate graphic

You are now ready to start testing your graphic. To do so, click on the Test Application button on the RSView Studio toolbar.

Page 12 of 15
March 2005
Working with the FBD Graphic Library for RSView Studio

Instructions for each individual FBD Graphic

Logix_ALM (ALM function block)


This graphic only requires a connection to one Alarm FBD instruction backing tag. This graphic also requires two local tags to function
properly.
• The first is a string tag which should be called “Units” or name the tag as you wish and then use tag substitution to replace all
references to “Units” in the graphic with the name of the tag you just created. This tag is used in the graphic to display the
correct units of measurement for the values it is retrieving/setting. Thus, assign the appropriate string value to this tag so that the
appropriate unit of measure is displayed on the FBD graphic.
• Also, a digital tag called “ShowDetail” should be created or name the tag as you wish and then use tag substitution to replace all
references to “ShowDetail” in the graphic with the name of the tag you just created. “ShowDetail” allows the Details portion of
the graphic to be hidden or shown when the “Detail” button on the display is clicked.

Logix_D2SD (D2SD function block)


This graphic only requires a connection to one Discrete 2-State FBD instruction backing tag.

Logix_D3SD (D3SD function block)


This graphic only requires a connection to one Discrete 3-State FBD instruction backing tag.

Logix_ESEL (ESEL function block)


This graphic only requires a connection to one Enhanced Selection FBD instruction backing tag.

Logix_PIDE (PIDE function block)


This graphic requires connections to multiple FBD instructions backing tags and is made up of multiple screens.
• Screen one, which is called “Logix_PIDE” in the library listing, is the main screen for the graphic and has #1 representing the
actual PIDE instruction backing tag.
• Screen two, which is called “Logix_PIDE_Trend”, is the trending screen for the graphic and has #1 representing the actual PIDE
instruction backing tag as well.
• The final screen, which is called “Logix_PIDE_Autotune”, is the autotuning screen of the graphic and has #1 representing the
actual PIDE instruction backing tag and #2 representing the Autotune backing tag.

This graphic requires two local tags to function properly.


• The first is a string tag which should be called “Units” or name the tag as you wish and then use tag substitution to replace all
references to “Units” in the graphic with the name of the tag you just created. This tag is used in the graphic to display the
correct units of measurement for the values it is retrieving/setting. Thus, assign the appropriate string value to this tag so that
the appropriate unit of measure is displayed on the FBD graphic.
• Also, a digital tag called “ShowDetail” should be created or name the tag as you wish and then use tag substitution to replace all
references to “ShowDetail” in the graphic with the name of the tag you just created. “ShowDetail” allows the Details portion of
the graphic to be hidden or shown when the “Detail” button on the display is clicked.
It is recommended that when you initialize the first screen of the PIDE Graphic that you also cache the PIDE – Trending screen while
allowing updates since this will allow the graphs on that screen to continue collection and persistence of the data even when the screen is
not displayed. Remember to flush the display from the cache when exiting the PIDE Graphic completely.

Page 13 of 15
March 2005
Working with the FBD Graphic Library for RSView Studio

Logix_RMPS (RMPS function block)


This graphic requires connections to multiple tags in the controller. Parameter #1 represents the actual Ramp/Soak FBD instruction
backing tag in the controller, parameter #2 represents the path to the “Ramp Value” array, #3 represents the path to the “Soak Value”
array, and #4 represents the path to the “Soak Time” array.
This graphic requires two local tags to function properly.
• The first is a String tag which should be called “Units” or name the tag as you wish and then use tag substitution to replace all
references to “Units” in the graphic with the name of the tag you just created. This tag is used in the graphic to display the
correct units of measurement for the values it is retrieving/setting. Thus, assign the appropriate string value to this tag so that
the appropriate unit of measure is displayed on the FBD graphic.
• Also, a digital tag called “ShowDetail” should be created or name the tag as you wish and then use tag substitution to replace all
references to “ShowDetail” in the graphic with the name of the tag you just created. “ShowDetail” allows the Details portion of
the graphic to be hidden or shown when the “Detail” button on the display is clicked.

Logix_TOT (TOT function block)


This graphic only requires a connection to one Totalizer FBD instruction backing tag.
This graphic requires two local tags to function properly.
• The first is a String tag which should be called “Units” or name the tag as you wish and then use tag substitution to replace all
references to “Units” in the graphic with the name of the tag you just created. This tag is used in the graphic to display the
correct units of measurement for the values it is retrieving/setting. Thus, assign the appropriate string value to this tag so that
the appropriate unit of measure is displayed on the FBD graphic.
• Also, a digital tag called “ShowDetail” should be created or name the tag as you wish and then use tag substitution to replace all
references to “ShowDetail” in the graphic with the name of the tag you just created. “ShowDetail” allows the Details portion of
the graphic to be hidden or shown when the “Detail” button on the display is clicked.
• There is also a label next to the Input value which initially reads “Units/sec”. This should be changed to reflect the desired unit of
measurement for the Input.

Page 14 of 15
March 2005
Working with the FBD Graphic Library for RSView Studio

Differences Between the RSView Studio FBD Graphic Library and the ActiveX
FBD Faceplates

General Differences
This a list of general differences between the RSView Studio FBD graphics and the ActiveX FBD faceplates:

• A function block instruction backing tag cannot be connected to an RSView Studio FBD graphic dynamically at run-time; you can
only specify this at design-time.

• Making display changes for an RSView Studio FBD graphic (such as changing the font, colors, and setting the units for the
values) can only be done at design-time.

• You cannot display the name and/or path of the function block instruction that is connected to an RSView Studio FBD graphic.

• A tag must be used to show/hide parts of particular controls (this functionality is desirable for the “Detail” button that must show
or hide another portion of the control when clicked). It is up to you to create this tag so that the control functions properly.

• The RSView Studio FBD graphics use buttons in place of checkboxes and radio buttons to change the value of a tag and text
that reads “Enabled”, which is hidden or made visible depending on the value of the tag.

• Some of the RSView Studio FBD graphics require you to enter limit values; however the graphics do not do any limit checking.
Thus, it is your responsibility to verify the values before committing them.

Ramp/Soak Graphic
Can only support a small number of segments (around 10) for the graphic because tags cannot be nested such as using one tag to access
an array element of another tag (e.g. ::[Controller]Program:Routine.RMPS.RampVal[::[Controller]Program:Routine.RMPS.CurrentSeg]).

Because of the lack of a scrollbar object in RSView Studio, the graphic does not provide the ability to scroll through the list of all segments
and view their information. In addition, there is no “Detail” button; everything is just incorporated into the main dialog.

Alarm Graphic
The bar graphs where the minimum and maximum values change with respect to a formula is not supported by the FBD graphic, since the
min and max can only be a specific value or a tag.

PIDE Graphic
If tags are used for the min and max values of a bar or the vertical or horizontal position animations, and the value of one of the tags
changes, you must exit the display and go back to it to get the new min and max values to take effect.
Dynamic limits (such as from a tag) cannot be imposed on the SP and CV sliders in this graphic. The limits should be based on the High
and Lo values of SP and CV, but this cannot be accomplished in RSView Studio.

An “Autotune” button is added on the main dialog of the RSView Studio FBD graphic so that you do not need much clicking to get there.

Page 15 of 15
March 2005

You might also like