Define an Add-On Instruction component                  Chapter 5 
Rockwell 
Automation 
Publicatio
n 1756-RM084U-EN-P - November 2015 
91 
<Comments> 
<Comment Operand="specifier"
<![CDATA[ comment_text ]]> 
</Comment> 
</Comments> 
<EngineeringUnits> 
<EngineeringUnit Operand="specifier"
<![CDATA[ engineering_unit_text ]]> 
</EngineeringUnit> 
</EngineeringUnits> 
<Mins> 
<Min Operand="specifier"> min_value </Min> 
</Mins> 
<Maxes> 
<Max Operand="specifier"> max_value </Max> 
</Maxes> 
<State0s> 
<State0 Operand="specifier"> 
<![CDATA[ state0_text ]]> 
</State0> 
</State0s> 
<State1s> 
<State1 Operand="specifier"> 
<![CDATA[ state1_text ]]> 
</State1> 
</State1s> 
<DefaultData [DefaultData_Attributes]> 
data 
</DefaultData> 
</Parameter> 
</Parameters> 
L5K parameters structure 
PARAMETERS 
<name> : <datatype[array_specification]>[(Description := 
"text", 
Comment := "text", 
EngineeringUnit := "text", 
Max := value, 
Min := value, 
State0 := "text", 
State1 := "text", 
Parameter_Attributes)]; 
END_PARAMETERS 
Convert pdf image to text online - Convert PDF to txt files in C#.net, ASP.NET MVC, WinForms, WPF application
C# PDF to Text (TXT) Converting Library to Convert PDF to Text
converting pdf to text; convert pdf to txt file online
Convert pdf image to text online - VB.NET PDF Convert to Text SDK: Convert PDF to txt files in vb.net, ASP.NET MVC, WinForms, WPF application
VB.NET Guide and Sample Codes to Convert PDF to Text in .NET Project
convert pdf to txt file format; convert pdf photo to text
Chapter 5                  Define an Add-On Instruction component 
92 
Rockwell 
Automation 
Publicatio
n 1756-RM084U-EN-P - November 2015 
Parameter elements 
L5X Item 
L5K Item 
Description 
N/A 
name 
The name of the parameter. 
In L5X, use a Name attribute on the <Parameter> element. 
N/A 
datatype 
Data type of the parameter. 
InOut parameters can be atomic (SINT, INT, DINT, and REAL) and compound (user-defined 
and array) data types. Input and Output parameters can be only atomic (SINT, INT, DINT, and 
REAL) data types. 
In L5X, use a DataType attribute on the <Parameter> element. 
N/A 
array_specification 
Dimensional boundaries for an InOut parameter array. 
In L5X, use a Dimensions attribute on the <Parameter> element. 
Description 
Description 
User information about the parameter with a 128-character maximum. 
DefaultData 
N/A 
The default data values for Input parameters or Output parameters. 
In L5K, use a DefaultData attribute. 
Comment 
Comment 
(optional) User information about specified sub-regions of the parameter. 
Can specify Comment<specifier> 
Where the specifier is: 
.bitnumber - for a bit in the parameter 
[element] - for an array element of the parameter 
.membername - for a structure member of the parameter 
There can be multiple comment elements. 
EngineeringUnit 
EngineeringUnit 
(optional) 
Us
er specified description of what the unit of the value is (that is, feet, gallons, 
kilos). 
Can specify EngineeringUnit <specifier> 
Where the specifier is: 
.bitnumber - for a bit in the parameter 
[element] - for an array element of the parameter 
.membername - for a structure member of the parameter 
There can be multiple engineering unit elements. 
Max 
Max 
(optional) User specified maximum value about qualified sub-regions of the parameter. 
Only valid for a parameter’s sub-regions, which is a non-Boolean atomic datatypes. 
Can specify Max <specifier> 
Where the specifier is: 
.bitnumber - for a bit in the parameter 
[element] - for an array element of the parameter 
.membername - for a structure member of the parameter 
There can be multiple max elements. 
C# PDF Image Extract Library: Select, copy, paste PDF images in C#
image. Extract image from PDF free in .NET framework application with trial SDK components and online C# class source code. A powerful
convert pdf to txt format; convert pdf to text online
VB.NET PDF - Convert PDF Online with VB.NET HTML5 PDF Viewer
C#: Convert PDF to HTML; C#: Convert PDF to Jpeg; C# File: Compress PDF; C# File: Merge PDF; C# Read: PDF Image Extract; C# Write: Insert text into PDF; C# Write
convert pdf to text; convert pdf to txt
Define an Add-On Instruction component                  Chapter 5 
Rockwell 
Automation 
Publicatio
n 1756-RM084U-EN-P - November 2015 
93 
L5X Item 
L5K Item 
Description 
Min 
Min 
(optional) User specified minimum value about qualified sub-regions of the parameter. Only 
valid for a parameter’s sub-regions, which is a non-Boolean atomic datatypes. 
Can specify Min <specifier> 
Where the specifier is: 
.bitnumber - for a bit in the parameter 
[element] - for an array element of the parameter 
.membername - for a structure member of the parameter 
There can be multiple min elements. 
State0 
State0 
(optional) for Boolean parameters or sub-regions only. User specified description of what 
the Zero state of the Boolean value is. 
Can specify State0 <specifier> 
Where the specifier is: 
.bitnumber - for a bit in the parameter 
[element] - for an array element of the parameter 
.membername - for a structure member of the parameter 
There can be multiple state0 elements. 
State1 
State1 
(optional) for Boolean parameters or sub-regions only. User specified description of what 
the One state of the Boolean value is. 
Can specify State1 <specifier> 
Where the specifier is: 
.bitnumber - for a bit in the parameter 
[element] - for an array element of the parameter 
.membername - for a structure member of the parameter 
There can be multiple state1 elements. 
Parameters attributes 
Attribute 
Description 
Name 
L5X only. Specify the name of the parameter. 
In L5K, the name is an element of the statement. 
DataType 
L5X only. Specify the datatype of the parameter. 
InOut parameters can be atomic (SINT, INT, DINT, and REAL) , compound (user-defined and array) data types object 
backed (MESSAGE, ALARM, etc.). Input and Output parameters can be only atomic (SINT, INT, DINT, and REAL) data 
types. 
In L5K, the datatype is an element of the statement. 
TagType 
L5X only. Specify Base or Alias
VB.NET PDF Image Extract Library: Select, copy, paste PDF images
Extract image from PDF free in .NET framework application with trial SDK components for .NET. Online source codes for quick evaluation in VB.NET class.
convert scanned pdf to editable text; convert pdf to rich text format
C# HTML5 PDF Viewer SDK to convert and export PDF document to
C#: Convert PDF to HTML; C#: Convert PDF to Jpeg; C# File: Compress PDF; C# File: Merge PDF; C# Read: PDF Image Extract; C# Write: Insert text into PDF; C# Write
convert pdf to word searchable text; remove text from pdf
Chapter 5                  Define an Add-On Instruction component 
94 
Rockwell 
Automation 
Publicatio
n 1756-RM084U-EN-P - November 2015 
Attribute 
Description 
AliasFor 
L5X only.  Name of the base tag that the alias parameter references. 
Specify LocaTag<specifier> 
Where the specifier is a bit (.bitnumber), array element ([element]), or structure member (.membername) of the tag, or 
any combination such as [7].Input.0. 
Dimensions 
L5X only. Specify the dimensions of the datatype. 
In L5K, the dimensions are an element of the statement. 
Usage 
Specify the type of parameter. Type InputOutput, or InOut
Radix 
Specify decimalhexoctalbinaryexponentialfloatASCII
Required 
Specify whether the parameter is required. Type 1 if the parameter is required; type 0 if the parameter is optional. 
Constant 
Specify whether the value for an Input or an Output parameter is a constant value or it can change. For L5K, specify yes 
for a constant value or no for a dynamic value. For L5X, specify true or false
ExternalAccess 
Specify the external access, outside of the controller,  to the parameter. Specify Read/WriteRead Only, or None
Max 
(optional) User specified maximum value for the parameter. Only valid for parameter with non-Boolean atomic 
datatype. 
Min 
(optional) User specified minimum value for the parameter. Only valid for parameter with non-Boolean atomic datatype.
Visible 
Specify whether the parameter is visible on the display for the instructions. Type 1 if the parameter is visible; type 0 if 
the parameter is not visible. 
DefaultData 
L5K only. Specify a default value for the parameter. This attribute is not available if you specify Usage as InOut. 
In L5X, the parameter default data is an element of the L5X structure. 
The Signature History stores history entries for an Add-On Instruction. There 
can be 0…6 entries that are exported in the order they are created. The order in 
the file is used during import to store them. If you edit the file manually, that 
order is maintained. 
 L5K file—The Signature History is stored in the HISTORY_ENTRY 
structure. 
 L5X file—The Signature History is stored in the <SignatureHistory> 
structure. 
When an Add-On Instruction is sealed, the Signature History is protected and 
hidden in the ENCODED_DATA section. See Encoded/UnencodedAdd-On 
Instructions on page 97
 L5K file—The ENCODED_DATA section is a separate section. 
 L5X file—The <EncodedData> section is an element of 
<AddOnInstructionDefinitions>. 
Signature history 
VB.NET PDF Text Extract Library: extract text content from PDF
provides text extraction from PDF images and image files. Best VB.NET PDF text extraction SDK library and Online Visual Basic .NET class source code for quick
convert pdf file to txt; convert pdf to txt batch
C# PDF Text Extract Library: extract text content from PDF file in
Supports text extraction from scanned PDF by using XDoc.PDF for .NET Image text extraction control provides text extraction from PDF images and image files.
c# convert pdf to text; convert pdf to text file
Define an Add-On Instruction component                  Chapter 5 
Rockwell 
Automation 
Publicatio
n 1756-RM084U-EN-P - November 2015 
95 
L5X SignatureHistory structure 
<SignatureHistory> 
<HistoryEntry [HistoryEntry_Attributes]> 
<Description> 
<![CDATA[ text ]] > 
</Description> 
</HistoryEntry> 
</SignatureHistory> 
L5K HISTORY_ENTRY structure 
HISTORY_ENTRY [History_Entry_Attributes)] 
END_HISTORY_ENTRY 
History entry attributes 
Attribute 
Description 
User 
Specifies the identity of the user that created the entry. 
Timestamp 
Specifies the timestamp when the entry was created. The value is a UTC date time, such as 2009-04-01T12:08:00.000Z. 
SignatureID 
Specifies the signature ID for the Add-On Instruction when the entry was created. The value is an 8-digit uppercase hex number, such as  8F44EBA3. 
Description 
User information about the parameter (128 characters maximum). 
The local tags component defines local tags in the Add-On Instruction. The L5K 
format for defining a local tag is the same format for defining a tag in a program or 
at controller scope For more details on defining a tag, see Chapter 6 Defining a 
Tag Component on page 107. For L5X format, you specify the default data for the 
local tag with a <DefaultData> element. Define the <DefaultData> element the 
same as a <Data> element. See Chapter 1 Data Formats on page 41 for more 
information on the <Data> element format. 
L5X LocalTags structure 
<LocalTags> 
<LocalTag [LocalTag_Attributes]> 
<Description> 
<![CDATA[ text ]] > 
</Description> 
<Comments> 
Local tags 
VB.NET PDF insert image library: insert images into PDF in vb.net
VB.NET code to add an image to the inputFilePath As String = Program.RootPath + "\\" 1.pdf" Dim doc New PDFDocument(inputFilePath) ' Get a text manager from
convert pdf to text open source; convert pdf to plain text
VB.NET PDF Convert to Jpeg SDK: Convert PDF to JPEG images in vb.
C#: Convert PDF to HTML; C#: Convert PDF to Jpeg; C# File: Compress PDF; C# File: Merge PDF; C# Read: PDF Image Extract; C# Write: Insert text into PDF; C# Write
convert pdf to txt format online; converting pdf to editable text
Chapter 5                  Define an Add-On Instruction component 
96 
Rockwell 
Automation 
Publicatio
n 1756-RM084U-EN-P - November 2015 
<Comment Operand="specifier"
<![CDATA[ comment_text ]]> 
</Comment> 
</Comments> 
<EngineeringUnits> 
<EngineeringUnit Operand="specifier"
<![CDATA[ engineering_unit_text ]]> 
</EngineeringUnit> 
</EngineeringUnits> 
<Mins> 
<Min Operand="specifier"> min_value </Min> 
</Mins> 
<Maxes> 
<Max Operand="specifier"> max_value </Max> 
</Maxes> 
<State0s> 
<State0 Operand="specifier"> 
<![CDATA[ state0_text ]]> 
</State0> 
</State0s> 
<State1s> 
<State1 Operand="specifier"> 
<![CDATA[ state1_text ]]> 
</State1> 
</State1s> 
<DefaultData [DefaultData_Attributes]> 
data 
</DefaultData> 
</LocalTag> 
</LocalTags> 
L5K LOCAL_TAGS structure 
LOCAL_TAGS 
tag_declaration 
END_LOCAL_TAGS 
Local tag attributes 
Specify these attributes for local tags in L5X format. See Chapter 6 Defining a Tag 
Component on page 107 for attributes for local tags in L5K format. 
Attribute 
Description 
Name 
L5X only. Specify the name of the local tag. 
In L5K, the name is an element of the statement. 
C# PDF Convert to Jpeg SDK: Convert PDF to JPEG images in C#.net
NET library to batch convert PDF files to jpg image files. Thumbnails can be created from PDF pages. Support for customizing image size.
convert pdf document to text; convert .pdf to text
Define an Add-On Instruction component                  Chapter 5 
Rockwell 
Automation 
Publicatio
n 1756-RM084U-EN-P - November 2015 
97 
Attribute 
Description 
DataType 
L5X only. Specify the datatype of the local tag. 
Local tags can be atomic (SINT, INT, DINT, and REAL) and compound (for example, user-defined, add-on instruction 
defined, array) data types. Local tags cannot be object backed data types (for example, MESSAGE, ALARM). 
In L5K, the datatype is an element of the statement. 
Dimensions 
L5X only. Specify the dimensions of the datatype. 
In L5K, the dimensions are an element of the statement. 
Radix 
Specify decimalhexoctalbinaryexponentialfloat, ASCII. 
ExternalAccess 
Specify the external access, outside of the controller, to the local tag. Specify Read/WriteRead Only, or None
Max 
(optional) User specified maximum value for the local tag. Only valid for local tag with non-Boolean atomic datatype. 
Min 
(optional) User specified minimum value for the local tag. Only valid for local tag with non-Boolean atomic datatype. 
DefaultData 
L5K only. Specify a default value for the local tag. 
In L5X, the parameter default data is an element of the L5X structure. 
These examples are for protected (encoded) and unprotected (clear text) codes for 
Add-On Instructions. 
If the project contains high-integrity Add-On Instructions, those Add-On 
Instructions always appear as encoded data components when you export 
the project. 
See Exporting Source-protected Logic on page 28 on page 33 for procedures. 
L5X EncodedData Structure 
<EncodedData EncodedType= "type", Name="name", 
Type="routinetype
[,other_attributes]> 
<Description> 
<![CDATA[ text ]] > 
</Description> 
encoded_data 
</EncodedData> 
L5K ENCODED_DATA Structure 
ENCODED_DATA [( EncodedType: type, Name:= name, 
Type:= routinetype, 
other_attributes)
encoded_data 
END_ENCODED_DATA 
Encoded/Unencoded Add-
On Instructions 
Chapter 5                  Define an Add-On Instruction component 
98 
Rockwell 
Automation 
Publicatio
n 1756-RM084U-EN-P - November 2015 
Encoded data attributes 
L5X Item 
L5K Item 
Description 
type 
type 
The type of data encoded. 
In L5K, specify ADD_ON_INSTRUCTION_DEFINITION 
In L5X, specify AddOnInstructionDefinition 
name 
name 
The name of the protected Add-On Instruction. 
SignatureID 
SignatureID 
32-bit value based upon the current configuration of the Add-On-Instruction. 
SignatureTimestamp 
SignatureTimestamp 
The time and date that the Add-On-Instruction was sealed. 
SafetySignatureID 
SafetySignatureID 
Only applies to Safety Add-On-Instructions. Additional safety ID calculated online in the 
safety system. 
N/A 
other_attributes 
Attributes of the Add-On Instruction that are not protected during export. 
N/A 
encoded_data 
The protected portion of the Add-On Instruction. 
Important: 
When the Add-On Instruction is source-protected, the encoded_data information is encrypted. If you 
modify this encrypted information, you cannot re-import the Add-On Instruction. 
Define an Add-On Instruction component                  Chapter 5 
Rockwell 
Automation 
Publicatio
n 1756-RM084U-EN-P - November 2015 
99 
L5X Encoded Add-On Instruction example 
Chapter 5                  Define an Add-On Instruction component 
100 
Rockwell 
Automation 
Publicatio
n 1756-RM084U-EN-P - November 2015 
L5K Encoded Add-On instruction example 
ENCODED_DATA (EncodedType := ADD_ON_INSTRUCTION_DEFINITION, 
Name := "Conveyor_Control", 
Description := "This is the description", 
Revision := "1.0", 
RevisionNote := "This is a Revision Note", 
Vendor := "vendor", 
SignatureID := AC2CCC57, 
SignatureTimestamp := "2014-05-20T14:04:14.807Z", 
EditedDate := "2014-05-20T14:04:14.807Z", 
AdditionalHelpText := "This is help text", 
EncryptionConfig := 3)  
HISTORY_ENTRY  (User := RA-INT\JBieder2, 
Timestamp := "2014-05-20T00:15:08.867Z", 
SignatureID := 16#52db_eb8a, 
Description := "History description") 
END_HISTORY_ENTRY 
PARAMETERS 
EnableIn : BOOL (Description := "Enable Input - 
System Defined Parameter", 
Usage := Input, 
RADIX := Decimal 
Required := No, 
Visible := No, 
ExternalAccess := Read Only); 
EnableOut : BOOL (Description := "Enable Output - 
System Defined Parameter", 
Usage := Output, 
RADIX := Decimal, 
Required := No, 
Visible := No, 
ExternalAccess := Read 
Only); 
END_PARAMETERS 
5PC4UUeSPrD8+QMe30neT5/97J+VmK95qgOApHiZ7VpmkuGyeYVmzDm3
ceYND35YMmzC4xyFQfJYld… 
END_ENCODED_DATA 
Use these Add-On Instruction guidelines with function blocks: 
 If the operand is not a qualified tag or literal value, the Add-On Instruction 
is not verified. 
 The X and Y grid locations are a relative position from the upper-left corner 
of the sheet. X is the horizontal position; Y is the vertical position. 
Add-On Instruction 
Guidelines 
Documents you may be interested
Documents you may be interested