Define a new Add-On Instruction

Create an Add-On Instruction to define a single instruction that contains commonly used logic. Add-On Instructions contain parameters and tags and the logic contained in standard ladder diagram.
Add-On Instructions appear in
Toolbox
for use throughout the project. Add an Add-On Instruction in
Library
to reuse Add-On Instructions to provide consistency across the project or multiple projects.
  1. On the explorer bar, select Library Icon
    Library
    .
  2. In
    Library
    , select the Add-On Instruction item.
  3. From the
    Library
    menu Hamburger Menu Icon, select
    New add-on instruction
    .
  4. In
    New add-on instruction
    , complete:
    • Name
      . Type a unique name for the Add-On Instruction. Names must start with a letter or underscore and can contain up to 40 characters.
    • Description
      . Enter the behavior of the Add-On Instruction. Descriptions contain up to 256 characters.
    • Type
      . Select the language type of the main logic of the Add-On Instruction -- ladder diagram.
    • Version number
      . Enter the major, minor, and build numbers of the Add-On Instruction.
    • Version note
      . Enter additional information about this version.
    • Vendor
      . Type the name of the vendor who owns the Add-On Instruction.
  5. (Optional) Select the items to open when the Add-On Instruction is created:
    • Open definition
      . Open the definition of the Add-On Instruction.
    • Open tags & parameters
      . Open the Tags and parameters tab for the Add-On Instruction.
    • Open logic
      . Open the Ladder Editor for the Add-On Instruction.
  6. Select
    Create
    . The Add-On Instruction appears in
    Library
    . The
    Parameter & Tags
    and
    Logic
    items appear in the data structure of the Add-On Instruction.
    TIP:
    • The Add-On Instruction appears in the specified category in
      Toolbox
      .
    • A user-defined data type named (Name_AOI)_TYPE appears in
      Library
      under
      Date Types
       and
      Add-On Defined
      .
    • To open the Tag Editor for the Add-On Instruction, in
      Library
       select the Add-On Instruction and then in the
      Library
      title bar, select
      View
      Tags Icon
      tags and parameters: (name)
       or double-click the user-defined data type named (Add-On Instruction name)_TYPE.
    • The Add-On Instruction has a parameter that executes the instruction and a read-only EnableOut parameter that updates the output of the instruction.
Provide Feedback
Have questions or feedback about this documentation? Please submit your feedback here.