Topic: DMD0073 PUBLISH - Translate from Do-more |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
The Translate from Do-more (PUBLISH) instruction copies and converts ranges of data from Do-more memory to a data format that is directly usable by an external source, for example: converting memory to BCD data that will be used by a DirectLOGIC CPU, or byte-swapping data that will be used by a Modbus device. There is no sequencing or stepping regarding the rows in this instruction, every row in the instruction is processed every time the instruction is executed.
The Translate from Do-more instruction can have from 1 to 50 rows of data blocks to convert. For each of the rows, this instruction will copy each of the Elements from the Source block to the Destination block, converting each of them from the native data format of the Source block to the specified format.
The following functions are used to manage the rows in the instruction: Ok closes the editor, saving any changes, and Cancel closes the editor, discarding any changes. Edit opens the editor for the currently selected row. Insert inserts a new row before the currently selected row. Remove removes the currently selected row. Move Up / Move Down moves the currently selected row up one row / down one row respectively.
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Parameters:Note: Use the F9 key or click the 'three dot box' at the right edge of the parameter field to open the Default Element Selection Tool (the Element Picker or the Element Browser) or use the Down-Arrow key (Auto-Complete) on any parameter field to see a complete list of the memory locations that are valid for that parameter of the instruction.
Source - specifies the beginning address of the data block to be copied and converted. This can be any readable numeric location.
Destination - specifies the beginning address of the block to store the converted data. This can be any writable numeric location.
As - specifies the type of format conversion to be applied to each element in the Source block as they are copied to the Destination block.
#Elements - specifies the number of Source locations to convert. This can be any constant value between 1 and 255.
Swap Byte - checking this option will cause the Bytes of each Source Word or DWord to be swapped before the data conversion operation is applied.
Note: As of Do-more Designer version 1.1, the Reverse Bytes option in the PUBLISH instruction was split in two options: Swap Byte and Swap Word. This change allows any combination of Swap Bytes in Word-size elements and / or Swap Words in DWord or Real elements. However, if the Do-more CPU is running a firmware version older that v1.1 there is a caveat: if the instruction is setup to operate on a DWord-size element, and ONLY Swap Byte or Swap Word is selected, this cannot be downloaded to the Do-more CPU with the older firmware. Selecting Swap Word AND Swap Byte can be downloaded to the Do-more CPU with older firmware. This issue is best remedied by upgrading the CPU firmware to v1.1 or later.
Note: checking both Swap Byte and Swap Word will reverse the bytes in a DWord.
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Status Display:
The status display of the PUBLISH instruction is a textual description of the data conversion.
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
See Also:PUBLISH - Transport from Do-more
SUBSCRIB - Translate to Do-more
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Rung Example:
The following table shows how the PUBLISH instruction manipulates the data in the above example using various values:
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|