User manual

Toolbox 32 User Manual 1.47d www.cse-semaphore.com/mykingfisher
Page
71
String Copy
Copies up to 31 text characters (a string) to consecutive local registers. Each character is stored as an 8-bit
ASCII number and the string is null terminated. Two characters are stored in each local register. For each
pair of characters, the left character is stored in channels 1-8 and the right character is stored in channels 9-
16. For an LP-1/2/3, the characters are stored in reverse order. Eg. string XY is copied to a local register
CPU Type
Chs 9
-
16
Chs 1
-
8
PC-1, CP-
10/11/21
59 Hex (Y) 58 Hex (X)
LP-1/2/3 58 Hex (X) 59 Hex (Y)
A string copy can be used with indirect pager messages. The pager message Line 1 is configured as a local
register #Rx. A String Copy is then used to copy the required text to a block of registers beginning at #Rx
before the pager message is triggered. Note: multiple strings can be joined together by copying over the null
terminator of the first string with the beginning of the second string.
Destination: (#R1 - #R2048) The first local register to copy the characters to. Characters are stored in
consecutive registers until the end of the string is reached (a maximum of 16 registers are used)
Source: Up to 31 text characters to copy to the local registers.
Swap Bytes? When checked, the 2 characters stored in each local register will be swapped (this function is
used for the DV1000 protocol driver).
Multi Copy
A Multi Copy is the same as a Single Copy block except it can perform up to 16 individual copies at the same
time. This is useful for minimising the number of ladder rungs used. A Multi Copy block showing various
types of copies is shown below.
Note: multicopy blocks can use a considerable amount of processing power. To free up the processing time,
multi copy blocks should be processed once a second or less by using a #YTICK.SEC contact in the
multicopy rung as shown above.