DMD0535

CTUPDLVL - CTRIO Update Level

The CTRIO Update Level (CTUPDLVL) instruction is used to change the Level configuration of one of the CTRIO's Discrete Outputs (for description of that function see Discrete Output For Input Function under (2) Level (button) bullet).

Note: Changes made to CTRIO Level parameter using this instruction does not change the Level parameter configured in the System Configuration for the CTRIO. It is temporary and is lost on a power-cycle of the CTRIO. The change cannot be viewed, for example, in the PLC --> System Configuration.

The red triangle in the upper left corner indicates the CTRIO Update Level (CTUPDLVL) is a Fully Asynchronous instruction.

Note: The CTUPDLVL instruction can be used with both the CTRIO and CTRIO2 module.

Inputs:

The ladder logic input for this instruction is dual mode:

It is edge-triggered, meaning that each time this input logic transitions from OFF to ON, the CTRIO Update Level (CTUPDLVL) will:

• Load the specified Output Preset table on the CTRIO Discrete Output Device

• Run to completion, even if the input logic goes OFF before the operation is complete.

After the level value is updated, the input transitions to a traditional Enable function, meaning that as long as the ladder logic input has power flow, the output will be enabled.

Parameters:

Note: Use the F9 key (Element Browser) at any time to see a complete list of the memory locations that are valid in the current field of the instruction.

Discrete Output Device - designates which of the pre-configured CTRIO Discrete Output Devices to interact with. Before this instruction can select a Discrete Output Device, a CTRIO Device must be configured with at least one of its output channels setup for Discrete output mode.

Part of the configuration for a device is assigning a name to the device. It is that name which will show up in the Discrete Output Device selection drop-down menu. For more information on configuring CTRIO devices go to the Module Configuration Section under System Configuration.

Note: no devices available - indicates that there are no CTRIO Devices that have been pre-configured to perform this instruction.

Discrete Output Structure -  This field displays the name of the Discrete Output Structure that will be used by this instruction. This structure was created when the CTRIO module configuration was read during the Module Configuration phase.

Output is - specifies the new Output state: ON  or  OFF

When Level is - specifies the level comparison operator: Greater than  or  Less than

Scaled Level - specifies the new Level value. This can be any constant value of any readable numeric location.
 

Deadband (tenths of %) - specifies the new deadband value in tenths of a percent. This can be any integer constant value in the range of 0 to 1000 or any readable numeric location.

On Success - designates which of the following actions to take if the CTRIO Update Level operation is successful.

• SET BIT - The specific BIT location will be turned OFF when the CTRIO Update Level (CTUPDLVL) instruction is first enabled, and then SET ON if the operation is successful. This value can be any writable bit location.
   

• JMP to Stage - JMP to the specified Stage. The target Stage must be in the same Program code block as the CTRIO Update Level (CTUPDLVL) instruction, you cannot specify a Stage in a different Program code block. This selection will function like a standalone Jump to Stage instruction. Click here for more information on the Jump To Stage instruction.

On Error - designates which of the following two actions to take if the CTRIO Update Level operation is unsuccessful. For example if the specified CTRIO Discrete output is not configured correctly.

• SET BIT - The specific BIT location will be turned OFF when the CTRIO Update Level (CTUPDLVL) instruction is first enabled, and then SET ON if the operation is unsuccessful. This value can be any writable bit location.
   

• JMP to Stage - JMP to the specified Stage. The target Stage must be in the same Program code block as the CTRIO Update Level (CTUPDLVL) instruction, you cannot specify a Stage in a different Program code block. This selection will function the same as a standalone Jump to Stage instruction. Click here for more information on the Jump To Stage instruction.

Note: any time the On Error condition occurs, the CTRIO generates an Error Code that can be read in the <Module Name>.ErrorCode (Module Name is the name assigned to the CTRIO in the Module Configuration). The List of Error Code values (in decimal) follows:

Status Display:

The Status display of the CTRIO Update Level (CTUPDLVL) instruction shows:

• Values: Scaled Level, Deadband (tenths of %), Pulse Time (ms)
   

• Highlight: .OutputEnabled bit
   

• ON/OFF: On Success, On Error bits
   

CTRIO Structure Field Care-Abouts:

The following is a list of the"dot" fields of the CTRIO structure that are programmatically used with the CTRIO Update Level (CTUPDLVL) instruction. To see a complete listing of all CTRIO structures and members, goto the Project Browser --> Configuration --> Memory --> I/O --> Specialty.

COLOR KEY

Blue: CTRIO Input

Maroon: CTRIO Output

Black: CTRIO Module

Silver: Not used for this instruction

Note: The red "x" is the digit 0, 1, 2, or 3.

See Also:

• CTDYNPOS - CTRIO Run Dynamic Position Mode
   

• CTDYNVEL - CTRIO Run Dynamic Velocity Mode
   

• CTUPDLVL - CTRIO Update Level
   

• CTPLSADD - CTRIO2 Add Entry to PLS
   

• CTPLSEDT - CTRIO2 Edit PLS Entry
   

• CTREGRD - CTRIO Read Register
   

• CTREGWR - CTRIO Write Register
   

• CTRUNPOS - CTRIO Run Position Mode
   

• CTRUNVEL - CTRIO Run Velocity Mode
   

• CTTBLADD - CTRIO Add Entry to Preset Table
   

• CTTBLCLR - CTRIO Clear Table
   

• CTTBLEDT - CTRIO Edit Preset Table Entry
   

• CTTBLLD - CTRIO Load Table

Example: