AB KTx RIO TLM
  SoftPLC    Font size:      

TLIs (Ladder Instructions)

This driver includes a pair of Ladder Logic instructions, called TLIs. For TOPDOC online, these instructions are automatically added to the instruction menu the moment you go online to a SoftPLC that has the KTX.TLM installed.

Note
The rung logic preceding these instructions must be true for the instructions to operate.

Both instructions work with a block of 32 integer words. Each of the 32 words corresponds to a logical I/O rack, whose number is given by the rack adapter switch settings. Remember, field I/O racks may be placed in any I/O image table location due to the flexibility of KTX.LST. The TLIs use the rack numbers as they are determined by adapter switch settings, not the mapped logical addresses in the KTX.LST file.

For example, rack octal 017 (decimal 15), would be mapped to the sixteenth word in the block.


KTXGETFAULTMAP

This instruction copies a bitmap of faulted I/O adapters for a particular KTX card into the datatable. This instruction is a permissive instruction, and evaluates as TRUE only if an adapter is faulted. It can be used as a condition for invoking a JSR or setting a summary alarm bit in the same rung. It only writes to the indicated bits and no others. It takes two parameters.

The following example uses a TRUE evaluation result, indicating at least one faulted rack, to turn on bit S6/11 which will then fault SoftPLC.


Parameter NameDescription
CardNumis the zero based index into your [CARDS] section of the KTX.LST file. That is, it refers to a particular card. Zero is the first card, 1 is the second card, etc.
Mapis the start of a 32 word block that will receive the faulted rack adapter bitmap. The format of the bitmap is given below. Each of the 32 words corresponds to a logical rack.


The Map will always be set to zeros unless an I/O rack adapter is faulted. Also, remember from earlier that when an I/O rack adapter is faulted S15 is set to 5324 by the KTX.TLM independent of this TLI. S15 is not ever cleared by the KTX.TLM, you must do that in logic. Only the least significant 4 bits of each word make up the map:


This bit when setCorresponds to a fault in
0first 1/4 rack starting I/O group 0
1second 1/4 rack starting I/O group 2
2third 1/4 rack starting I/O group 4
3fourth1/4 rack starting I/O group 6


KTXRACKEXISTS

This insruction copies a bitmap of existing I/O adapters for a particular KTX card into the datatable. Immediately after loading each KTx card with its firmware, the firmware goes out and detects the existence of racks on the RIO cabling. This instruction is an output instruction. It can be used to fetch the findings of a KTX card/channel. It only writes to the indicated bits and no others. It takes two parameters:


Parameter NameDescription
CardNumis the zero based index into your [CARDS] section of the KTX.LST file. That is, it refers to a particular card. Zero is the first card, 1 is the second card, etc.
Mapis the start of a 32 word block that will receive the existence status bitmap. The format of the bitmap is given below. Each of the 32 words corresponds to a full rack.


Below is the layout of the 32 Map words. Only bits 8, 9, 10, and 11 are part of this map:


This bit when setCorresponds to the existence of
8first 1/4 rack starting I/O group 0
9second 1/4 rack starting I/O group 2
10third 1/4 rack starting I/O group 4
11fourth 1/4 rack starting I/O group 6
Note
Both TLIs can point to the same Map block since each TLI only affects the bits indicated, but you would only do this for the same CardNum. Each card should get its own block of Map words.