Syslib rm042 - en P
Syslib rm042 - en P
IMPORTANT This manual applies to the Rockwell Automation Library of Process Objects version 3.5 or earlier.
For Rockwell Automation Library of Process Objects version 5.0, see
• PROCES-RM200
For Rockwell Automation Library of Process Objects version 4.0 or later, use the following manuals:
• PROCES-RM013 contains logic instructions
• PROCES-RM014 contains display elements
Important User Information
Read this document and the documents listed in the additional resources section about installation, configuration, and
operation of this equipment before you install, configure, operate, or maintain this product. Users are required to
familiarize themselves with installation and wiring instructions in addition to requirements of all applicable codes, laws,
and standards.
Activities including installation, adjustments, putting into service, use, assembly, disassembly, and maintenance are required
to be carried out by suitably trained personnel in accordance with applicable code of practice.
If this equipment is used in a manner not specified by the manufacturer, the protection provided by the equipment may be
impaired.
In no event will Rockwell Automation, Inc. be responsible or liable for indirect or consequential damages resulting from the
use or application of this equipment.
The examples and diagrams in this manual are included solely for illustrative purposes. Because of the many variables and
requirements associated with any particular installation, Rockwell Automation, Inc. cannot assume responsibility or
liability for actual use based on the examples and diagrams.
No patent liability is assumed by Rockwell Automation, Inc. with respect to use of information, circuits, equipment, or
software described in this manual.
Reproduction of the contents of this manual, in whole or in part, without written permission of Rockwell Automation,
Inc., is prohibited.
Throughout this manual, when necessary, we use notes to make you aware of safety considerations.
WARNING: Identifies information about practices or circumstances that can cause an explosion in a hazardous environment,
which may lead to personal injury or death, property damage, or economic loss.
ATTENTION: Identifies information about practices or circumstances that can lead to personal injury or death, property
damage, or economic loss. Attentions help you identify a hazard, avoid a hazard, and recognize the consequence.
IMPORTANT Identifies information that is critical for successful application and understanding of the product.
SHOCK HAZARD: Labels may be on or inside the equipment, for example, a drive or motor, to alert people that dangerous
voltage may be present.
BURN HAZARD: Labels may be on or inside the equipment, for example, a drive or motor, to alert people that surfaces may
reach dangerous temperatures.
ARC FLASH HAZARD: Labels may be on or inside the equipment, for example, a motor control center, to alert people to
potential Arc Flash. Arc Flash will cause severe injury or death. Wear proper Personal Protective Equipment (PPE). Follow ALL
Regulatory requirements for safe work practices and for Personal Protective Equipment (PPE).
Allen-Bradley, Rockwell Software, Rockwell Automation, RSLogix, Logix5000, FactoryTalk, PlantPAx, and ControlLogix are trademarks of Rockwell Automation, Inc.
Trademarks not belonging to Rockwell Automation are property of their respective companies.
Table of Contents
Notes:
This manual contains new and updated information. Changes throughout this
revision are marked by change bars, as shown to the right of this paragraph.
For the latest compatible software information and to download the Rockwell
Automation® Library of Process Objects, see the Product Compatibility and
Download Center at
http://www.rockwellautomation.com/rockwellautomation/support/pcdc.page.
Additional Resources These documents contain additional information concerning related products
from Rockwell Automation.
Resource Description
PlantPAx® Distribution Control System Selection Guide, Provides information to assist with equipment
publication PROCES-SG001 procurement for your PlantPAx system.
PlantPAx Distribution Control System Reference Manual, Provides characterized recommendations for
publication PROCES-RM001 implementing your PlantPAx system.
Rockwell Automation Library of Process Objects, Provides general considerations for the Rockwell
publication PROCES-RM002 Automation system library of process objects.
FactoryTalk® View Machine Edition User Manual, Provides details on how to use this software package for
publication VIEWME-UM004 creating an automation application.
FactoryTalk View Site Edition User Manual, Provides details on how to use this software package for
publication VIEWSE-UM006 developing and running human-machine interface
(HMI) applications that can involve multiple users and
servers, distributed over a network.
Logix5000™ Controllers Add-On Instructions Programming Provides information for designing, configuring, and
Manual, publication 1756-PM010 programming Add-On Instructions.
Rockwell Automation Library of Process Objects: Common Details how to monitor an input condition to raise an
Alarm Block (P_Alarm) Reference Manual, publication alarm. Information includes acknowledging, resetting,
SYSLIB-RM002 inhibiting, and disabling an alarm. Generally the
P_Alarm faceplate is accessible from the Alarms tab.
Notes:
This instruction is usually associated with other instructions, with one instance
being used for each analog input of the associated instruction.
Functional Description The P_AIChan Add-On Instruction monitors one analog input channel for the
following conditions:
• Invalid configuration
• I/O module fault
• Input out of range
• Instrument reports the following conditions:
– Out of specification (uncertain)
– Function check (substitute PV entered manually)
– Maintenance required
• Channel fault
• Input not-a-number (floating-point exception)
• Input stuck (unchanging)
For each condition, the Process Variable (PV) quality to report can be configured
as follows:
• Good
• Uncertain
• Bad (raises Fail alarm)
Required Files Add-On Instructions are reusable code objects that contain encapsulated logic
that can streamline implementing your system. This lets you create your own
instruction set for programming logic as a supplement to the instruction set
provided natively in the ControlLogix® firmware. An Add-On Instruction is
defined once in each controller project, and can be instantiated multiple times in
your application code as needed.
Controller File
Visualization Files
http://www.rockwellautomation.com/global/support/pcdc.pageThis Add-On
Instruction has associated visualization files that provide a common user
interface. These files can be downloaded from the Product Compatibility and
Download Center at
http://www.rockwellautomation.com/rockwellautomation/support/pcdc.page.
IMPORTANT The visualization file dependencies require Process Library content imports to
occur in a specific order as reflected in the following tables:
• Images
• Global Objects
• Standard Displays
• HMI Tags
• Macros
Images are external graphic files that can be used in displays. They must be
imported for FactoryTalk View to make use of them.
When PNG files are imported, they are renamed by FactoryTalk View with
a .bmp file extension, but retain a .png format.
Table 2 - Visualization Files: Images (.png)
FactoryTalk View SE Software FactoryTalk View ME Software Description
All .png files in the images folder All .png files in the images folder These are the common icons used in the global objects and
standard displays for all Process Objects.
The Global Object files (.ggfx file type) in the following table are Process Library
display elements that are created once and referenced multiple times on multiple
displays in an application. When changes are made to a Global Object, all
instances in the application are automatically updated.
The Standard Display files (.gfx file type) in the following table are the Process
Library displays that you see at runtime.
Table 4 - Visualization Files: Standard Displays (.gfx)
FactoryTalk View SE Software FactoryTalk View ME Software Description
(RA-BAS) Common-AnalogEdit N/A Faceplate used for analog input data entry. The FactoryTalk
View ME faceplates use the native analog input data entry
so no file is required.
(RA-BAS) P_AIChan-Faceplate (RA-BAS-ME) P_AIChan-Faceplate The faceplate that is used for the object.
(RA-BAS) P_AIChan-Help (RA-BAS-ME) P_AIChan-Help The Help display that is used for the object.
(RA-BAS) P_Alarm-Faceplate (RA-BAS-ME) P_Alarm-Faceplate The faceplate that is used for the object
(RA-BAS) P_Alarm-Help (RA-BAS-ME) P_Alarm-Help Alarm Help information that is accessed from the
P_AIarm faceplate.
Controller Code This section describes the parameter references for this Add-On Instruction.
• Alarm data elements (Alm_) are outputs of the instruction that indicate a
particular alarm has occurred.
• Acknowledge data elements (Ack_) are outputs of the instruction that
indicate the corresponding alarm has been acknowledged.
• Ready data elements (Rdy_) are bit outputs of the instruction
used by the HMI to enable or disable Command buttons and Setting entry
fields.
Table 8 - P_AIChan Output Parameters
Output Parameter Data Type Alias For Description
EnableOut BOOL Enable Output: The EnableOut signal is not manipulated by this instruction. Its output state
always reflects EnableIn Input state.
Val_InpRaw REAL Analog input value (raw units) (before scaling or checking).
Val PV value (engineering units).
Val_PVEUMin Minimum of scaled range = minimum (Cfg_PVEUMin, Cfg_PVEUMax).
Val_PVEUMax Maximum of scaled range = maximum (Cfg_PVEUMin, Cfg_PVEUMax).
SrcQ_IO SINT I/O signal source and quality.
SrcQ Final channel status source and quality.
GOOD 0 = I/O live and confirmed good quality
1 = I/O live and assumed good quality
2 = No feedback configured, assumed good quality
TEST 8 = Device simulated
9 = Device loopback simulation
10 = Manually entered value
UNCERTAIN 16 = Live input, off-specification
17 = Value substituted at device/bus
18 = Value substituted by maintenance (Has and not Use)
19 = Shed, using last good value
20 = Shed, using replacement value
BAD 32 = Signal failure (out-of-range, NaN, invalid combination)
33 = I/O channel fault
34 = I/O module fault
35 = Bad I/O configuration (for example, scaling parameters)
Val_Sts SINT Device confirmed status:
0 = PV Good
5 = PV Uncertain
6 = PV Bad
7 = Substitute PV
33 = Disabled
Val_Fault SINT Device fault status:
0 = none
32 = Fail
34 = Configuration error
Val_Notify SINT Current alarm level and acknowledgement (enumeration):
0 = No alarm
1 = Alarm cleared: a reset or acknowledge is required
2 = Low (acknowledged)
3 = Low (unacknowledged)
4 = Medium (acknowledged)
5 = Medium (unacknowledged)
6 = High (acknowledged)
7 = High (unacknowledged)
8 = Urgent (acknowledged)
9 = Urgent (unacknowledged)
Configuration parameters that are arrayed, string, or structure data types cannot
be configured as parameters for Add-On Instructions. Configuration parameters
of these types appear as local tags to the Add-On Instruction. Local tags can be
configured through the HMI faceplates or in Studio 5000 Logix Designer®
application by opening the instruction logic of the Add-On Instruction instance
and then opening the Data Monitor on a local tag. These parameters cannot be
modified by using controller logic or Logix Designer application export/import
functionality.
Table 9 - Local Configuration Tags
Tag Name Data Type Default Description
Cfg_Desc STRING_40 'Analog Channel Description for display on HMI. This string is shown in the title bar of the faceplate.
Quality'
Cfg_EU STRING_8 '%' Engineering units for display on HMI.
Cfg_Label STRING_20 'Analog In Channel' Label for graphic symbol displayed on HMI. This string appears on the graphic symbol.
Cfg_RU STRING_8 'mA DC' Raw Units for display on HMI.
Cfg_Tag STRING_20 'P_AIChan' Tag name for display on HMI. This string is shown in the title bar of the faceplate.
Operations This section describes the primary operations for Add-On Instructions.
Modes
The P_AIChan instruction does not have modes and does not use an embedded
P_Mode Add-On Instruction. The P_AIChan instruction is used to monitor an
analog input.
Alarms
This instruction uses the following alarms, which are implemented by using
embedded P_Alarm and P_Gate Add-On Instructions.
TIP The P_AIChan object's ‘Fail’ alarm is set to not exist by default. If you set this
alarm to exist, be aware that the P_AIChan object does not have its own
display elements. Thus, you do not have a graphic symbol with flashing border
to show and click to call up the P_AIChan faceplate. However, you can still get
to the P_AIChan instance's faceplate easily when it raises a failure alarm in
two different ways:
• Tie the Sts_PVBad output parameter of the P_AIChan instance to the
Inp_PVBad input parameter of the downstream object and enable that
object's I/O failure alarm. Enable the downstream object's navigation to its
upstream Channel object. When the P_AIChan raises its Fail alarm, the
symbol for the downstream object flashes. Call up the downstream
object's faceplate, then navigate from there to the P_AIChan faceplate.
• In the FactoryTalk Alarm and Events alarm setup, create a command string
for the P_AIChan ‘Fail’ alarm that opens the P_AIChan faceplate with that
instance's tag. Instructions for how to do this are included in the alarm
set-up PDF document that is included in the Rockwell Automation Library
download. When the alarm occurs, open the Alarm Summary screen.
Double-click the alarm in the summary list and the P_AIChan faceplate is
displayed.
Simulation
The Analog Input Channel Add-On Instruction does not have a Simulation
capability.
Execution
Programming Example The following example provides shows the connection from raw analog input
through process value by using the P_AIChan block.
The raw input value (Local:1:I.Ch0Data) from the analog input card is used as
the raw input value (Inp_Raw) for the P_AIChan block. The output value (Val)
and quality (SrcQ) from the P_AIChan block are used as inputs for the P_AIn
block. In this configuration, the P_AIn block uses the Cfg_HasChanObj
configuration parameter. The final output process value (Feedwater_Flow) is the
fully converted, scaled, and filtered analog value that is propagated through the
system.
The P_AIChan block also uses the Channel Fault and Module Fault parameters
taken from the same analog input module as the process value. Inp_ChanFault is
simply the tag value for the channel (Local:1:I.Ch0Fault). The Inp_ModFault
parameter (Rack1Slot4ModFault) is generated by using a GSV to the module
object (with the instance for the appropriate card and then the EntryStatus
parameter). The top four bits of the EntryStatus parameter are checked to make
sure they do not equal 2#0100_xxxx_xxxx_xxxx. The 0100 pattern indicates the
connection is “Running”. All other values are considered faulted.
Display Elements The P_AIChan instruction is used in association with other device instructions
to provide input monitoring functions. There are no dedicated display elements
for this instruction. The faceplate is called from the associated instruction’s
faceplate.
Status/Quality Indicators
One of these symbols appears on the graphic symbol when the described
condition is true.
Graphic Symbol Description
Invalid configuration.
TIP When the Invalid Configuration indicator appears, you can find what
configuration setting is invalid by following the indicators. The Invalid
Configuration indicator appears next to the appropriate tab at the top of the
faceplate to guide you in finding the configuration error. Once you navigate to
the tab, the misconfigured item is flagged with this indicator or appears in a
magenta box.
Threshold Indicators
Alarm Indicators
One of these symbols appears on the left of the label to indicate the described
alarm condition. The alarm border and label background blink if
Acknowledgement of an alarm condition is required. Once the alarm is
acknowledged, the alarm border and label background remain the color that
corresponds to the severity of the alarm.
Symbol Border and Label Background Description
No change in color Alarm Inhibit: an alarm is suppressed by the Program,
disabled by Maintenance, or shelved by the Operator.
No symbol No change in color No alarm or alarm inhibit condition, and all alarms
are acknowledged.
Faceplate The P_AIChan faceplate consists of four tabs and each tab consists of one or
more pages.
The title bar of each faceplate contains the value of local configuration tags
Cfg_Tag and Cfg_Desc.
Operator Tab
The faceplate initially opens to the Operator (‘Home’) tab. From here, an
operator can monitor the device status.
Status Indicator
Fail Alarm
The following table shows the alarm status symbols used on the Operator tab.
Table 12 - Operator Tab Alarm Status
Graphic Symbol Alarm Status
In Alarm (Active Alarm)
Maintenance Tab
Maintenance personnel use the information and controls on the Maintenance tab
to make adjustments to device parameters.
Engineering Tab
On Page 1 of the Engineering tab, you can configure the description, label, tag,
and PV units for the device.
The following table lists the functions on page 1 of the Engineering tab.
Table 14 - Engineering Tab Page 1 Description
Function Action Security Configuration Parameters
Description Type the device description to show Engineering Cfg_Desc
on the Faceplate title bar. Configuration
(Code E)
Label Type the label to show on the graphic Cfg_Label
symbol.
Tag Type the tag name to show on the Cfg_Tag
faceplate title bar and in the Tooltip.
IMPORTANT: Pausing the mouse
over this field displays a tool tip with
the configured Logix tag/path.
Raw Input Scaling: Type the range of the signal • Cfg_InpRawMax
Input - Maximum connected to the Inp_PV Input. The • Cfg_InpRawMin
Raw Min default is 4.0 and the Raw
Raw Input Scaling: Max default is 20.0.
Input - Minimum EXAMPLE: If your input card provides
a signal from 4.0…20.0 mA, set
Cfg_InpRawMin to 4.0 and
Cfg_InpRawMax to 20.0. The Raw
minimum/maximum and
engineering units minimum/
maximum are used for scaling to
engineering units.
Raw Input Scaling: Type the PV range represented by the • Cfg_PVEUMax
Scaled - Maximum input signal connected to Inp_PV. • Cfg_PVEUMin
The PV engineering units minimum
Raw Input Scaling: default is 0.0 and the PV engineering
Scaled - Maximum units maximum is 100.0.
EXAMPLE: If your input card provides
a signal from 4…20 mA that
represents -50…250 °C, set
Cfg_PVEUMin to -50.0 and
Cfg_PVEUMax to 250.0.
The Raw Min/Max and PV
engineering units Min/Max are used
for scaling to Engineering Units.
Input Units Type the units of measure for the Cfg_RU
input signal. “mA DC” is the default.
Scaled Units Type the engineering units for display Cfg_EU
on the HMI. Percent (%) is the
default.
Fail if Bad or Check to trigger a failure condition Cfg_FailOnUncertain
Uncertain quality and alarm when the PV status is
(unchecked will fail either Bad or Uncertain.
on Bad quality) Clear this checkbox to trigger the
failure condition when only the PV
status is Bad.
Clear Program Check to clear program commands on Cfg_PCmdClear
Commands upon receipt.
receipt
The following table shows the functions on page 2 of the Engineering tab.
Table 15 - Engineering Tab Page 2 Description
Function Action Security Configuration Parameters
Invalid When the P_AInChan configuration Engineering Cfg_CfgErrAction
Configuration - is not valid: Configuration
Action = Use Input, • Use the input to determine value (Code E)
Hold Input, or • Hold value at its last good value
Replace PV • Set value by using
Cfg_PVReplaceVal
Invalid When the P_AIChan configuration is Cfg_CfgErrQual
Configuration - not valid:
Quality = Good • Set Sts_PVGood
Quality, Uncertain, • Set Sts_PVUncertain
or Bad Quality • Set Sts_PVBad
Channel Fault- When there is a channel fault: Cfg_ChanFaultAction
Action = Use Input, • Use the input to determine value
Hold Input, or • Hold value at its last good value
Replace PV • Set value by using
Cfg_PVReplaceVal
Alarms Tab
The Alarms tab displays each configured alarm for the P_AIChan instruction.
The icon on the tab for the alarms page changes color based on the current active
alarms. A blinking alarm icon indicates that one or more alarms must be
acknowledged or the device must be reset.
Alarm Acknowledge
Alarm Severity Indicators
Command Button
Click an alarm name to open the P_Alarm faceplate for that alarm. From the
P_Alarm faceplate, you can configure and perform additional operations on
the alarm.
If an alarm is active, the panel behind the alarm changes color to match the
severity of the alarm. The color of the bell icon at the top of the faceplate shows
the severity of the highest active alarm, and the icon blinks if any alarm is
unacknowledged or requires reset.
When the Reset and Acknowledge All Alarms button is enabled, the panel
behind the alarm blinks, indicating the alarm requires acknowledgement or reset.
The Alarm Acknowledge button is enabled if the alarm requires
acknowledgment. Click the button with the check mark to acknowledge the
alarm.
Faceplate Help
In addition, we offer multiple support programs for installation, configuration, and troubleshooting. For more
information, contact your local distributor or Rockwell Automation representative, or visit
http://www.rockwellautomation.com/services/online-phone.
Installation Assistance
If you experience a problem within the first 24 hours of installation, review the information that is contained in this
manual. You can contact Customer Support for initial help in getting your product up and running.
United States or Canada 1.440.646.3434
Outside United States or Canada Use the Worldwide Locator at http://www.rockwellautomation.com/rockwellautomation/support/overview.page, or contact your local
Rockwell Automation representative.
Rockwell Automation tests all of its products to help ensure that they are fully operational when shipped from the
manufacturing facility. However, if your product is not functioning and needs to be returned, follow these procedures.
United States Contact your distributor. You must provide a Customer Support case number (call the phone number above to obtain one) to your
distributor to complete the return process.
Outside United States Please contact your local Rockwell Automation representative for the return procedure.
Documentation Feedback
Your comments will help us serve your documentation needs better. If you have any suggestions on how to improve this
document, complete this form, publication RA-DU002, available at http://www.rockwellautomation.com/literature/.
Rockwell Otomasyon Ticaret A.Ş., Kar Plaza İş Merkezi E Blok Kat:6 34752 İçerenköy, İstanbul, Tel: +90 (216) 5698400