Interface description TLV commands and interpreter for the TruTops Mark software program Interface description TLV c
Views 280 Downloads 16 File size 2MB
Interface description
TLV commands and interpreter for the TruTops Mark software program
Interface description
TLV commands and interpreter for the TruTops Mark software program
Edition: 2017-02-23 Material number: 1436502 SW-TLV-EN
Order Information
Please specify when ordering this document: Interface description TLV commands and interpreter 2017-02-23 SW-TLV-EN Material number: 1436502
© TRUMPF Schweiz AG
Table of contents Chapter 1
Chapter 2
SW-TLV-EN
2017-02-23
Command-interpreter user interface for TruTops Mark® 1.
Functional scope of the command-interpreter ........... 1-3
2.
Starting the TLV command interpreter ........................ 1-5
3. 3.1 3.2 3.3
Application window ....................................................... 1-5 Status info ........................................................................ 1-6 Monitor area ..................................................................... 1-7 Buttons for the command interpreter ............................... 1-8 3.3.1. "F2 Monitor on/Monitor off" ............................... 1-8 3.3.2. "F3 Clear Monitor" ............................................ 1-8 3.3.3. "F4 Configuration" ............................................ 1-9 3.3.4. "F5 Find TLV-CMD" (command)..................... 1-10 3.3.5. "F6 Next TLV-CMD" (command) .................... 1-11 3.3.6. "F7 Configure interface" ................................. 1-11 3.3.7. "F8 Display interface/Hide interface" .............. 1-11 3.3.8. "F9 Reset interface" ........................................ 1-12
TLV Commands 1.
Structure of TLV Commands/TLV
1.1 1.2
Communications ............................................................ 2-7 TLV Commands ............................................................... 2-7 TLV Communications ...................................................... 2-7
2. 2.1 2.2 2.3
Structure of the TLV Command Listings..................... 2-8 TLV Sequence with ASCII string as TLV Value............... 2-8 TLV Sequence with Unicode string as TLV Value ......... 2-10 Legend of the abbreviations used for the zeroterminated strings .......................................................... 2-11 2.3.1. Result of the TLV request (G1)....................... 2-12 2.3.2. Extended error code (G2) ............................... 2-12
3. 3.1 3.2 3.3
TLV commands for laser control system .................. 2-13 Laser/shutter .................................................................. 2-13 Shutter ........................................................................... 2-14 Pilot laser ....................................................................... 2-15 Table of contents
5
3.4 3.5 3.6 3.7 3.8 3.9 3.10 3.11 3.12 3.13 3.14 3.15 3.16 3.17 3.18 3.19 3.20
3.22 3.23 3.24 3.25 3.26 3.27 3.28 3.29 3.30 3.31 3.32 3.33 3.34 3.35
Marking .......................................................................... 2-16 Trigger marking .............................................................. 2-18 Abort marking ................................................................ 2-19 Marking status ............................................................... 2-20 Laser status in Winmark format ..................................... 2-21 Laser reset ..................................................................... 2-22 Trigger conversion ......................................................... 2-23 Conversion status .......................................................... 2-24 Read pilot laser mode .................................................... 2-25 Set pilot laser mode ....................................................... 2-26 Read "Marking on the fly" parameters ........................... 2-27 Set "Marking on the fly" parameters .............................. 2-29 Read RTC parameters................................................... 2-30 Segment info .................................................................. 2-31 Segment data ................................................................ 2-33 Mark Segment ............................................................... 2-34 Creating the matrix and binning file for matrix segmentation ................................................................. 2-36 Creation of a new matrix file for the matrix segmentation ................................................................. 2-38 Laser status ................................................................... 2-41 Last error........................................................................ 2-42 Short error/warning text ................................................. 2-43 Last warning .................................................................. 2-44 Laser .............................................................................. 2-45 Q-switch ......................................................................... 2-46 Initialization of beam monitoring by the scanner ........... 2-47 Scanner beam monitoring.............................................. 2-49 Laser power ................................................................... 2-50 Frequency ...................................................................... 2-51 Defocusing ..................................................................... 2-52 Set laser parameters offsets .......................................... 2-53 Switching on or switching off "Marking on the fly" ......... 2-54 Switching on or switching off the retrigger mode ........... 2-55
4. 4.1 4.2 4.3 4.4 4.5 4.6 4.7 4.8 4.9 4.10
TLV commands for Mechanics SW module .............. 2-56 Reference all axes ......................................................... 2-56 Reference axis ............................................................... 2-57 Reference two axes ....................................................... 2-58 Move axis ....................................................................... 2-59 Move two axes ............................................................... 2-61 Axis position ................................................................... 2-62 Recognize focal position ................................................ 2-63 Set segment offset for axes ........................................... 2-64 Open door ...................................................................... 2-65 Close door...................................................................... 2-66
3.21
6
Table of contents
2017-02-23
SW-TLV-EN
4.11 4.12 4.13 4.14 4.15 4.16 4.17 4.18 4.19
Rotate rotation door ....................................................... 2-67 Status rotating door ....................................................... 2-68 Move foil module ............................................................ 2-69 Edge-detection ............................................................... 2-70 Mechanics status ........................................................... 2-71 Mechanics error ............................................................. 2-74 Moving axes continuously (from TTM 2.7) .................... 2-78 Stop all axes (from TTM 2.7) ........................................ 2-79 Switch axis on or off....................................................... 2-80
5. 5.1 5.2 5.3 5.4 5.5 5.6 5.7 5.8 5.9
TLV commands for the digital interface .................... 2-81 Inputs of the digital interface .......................................... 2-81 X input of the digital interface ........................................ 2-82 Digital interface outputs ................................................. 2-83 X output of the digital interface ...................................... 2-84 Inputs 1 to 8 of the digital interface ................................ 2-85 Inputs 9 to 16 of the digital interface .............................. 2-86 Inputs 17 to 24 of the digital interface............................ 2-87 Outputs 1 to 8 of the digital interface ............................. 2-88 Outputs 9 to 16 of the digital interface ........................... 2-89
6. 6.1 6.2 6.3 6.4 6.5 6.6 6.7 6.8 6.9 6.10
TLV commands for the marking control system ...... 2-90 Load marking file ........................................................... 2-90 Convert marking file ....................................................... 2-91 Mark marking file X ........................................................ 2-92 Set directory path ........................................................... 2-93 N text variable (see also "Set variable") ........................ 2-94 Read file name/directory ................................................ 2-95 Set variable .................................................................... 2-96 Read variable ................................................................. 2-98 Scaling/displacement ..................................................... 2-99 Rotating/displacing the marking field in MHS systems ........................................................................ 2-100 Load marking objects into the scanner ........................ 2-101 Activate scanner list ..................................................... 2-104 Start scanner list .......................................................... 2-105 Delete active VCT files ................................................ 2-106 Delete all VCT files ...................................................... 2-107 Hiding and showing the HMI ........................................ 2-108 Generating marking file for editing ............................... 2-109 Load marking file for editing......................................... 2-110 Import CAD file ............................................................ 2-111 Save the marking file opened for editing ..................... 2-113 Adding a line ................................................................ 2-113 Add an arc.................................................................... 2-115 Add a circle .................................................................. 2-116
6.11 6.12 6.13 6.14 6.15 6.16 6.17 6.18 6.19 6.20 6.21 6.22 6.23
SW-TLV-EN
2017-02-23
Table of contents
7
6.24 6.25 6.26 6.27 6.28 6.29 6.30 6.31 6.32 6.33 6.34 6.35 6.36 6.37 6.38 6.39 6.40 6.41 6.42 6.43
Add a rectangle ............................................................ 2-117 Add a text ..................................................................... 2-118 Add an expanded text .................................................. 2-119 Add a variable .............................................................. 2-121 Replace laser parameter ............................................. 2-122 Replace fill parameter .................................................. 2-123 Initialize all variables .................................................... 2-124 Initialize variable .......................................................... 2-125 Set laser parameters – properties ............................... 2-126 Read laser parameter – Properties ............................. 2-127 Hide blocks .................................................................. 2-128 Add a Bitmaps (as of TruTops Mark 2.5.3).................. 2-129 Close the TruCad Server ............................................. 2-130 Adding a polyline ......................................................... 2-131 Adding an ellipse ......................................................... 2-133 Adding an ellipse arc ................................................... 2-135 Copying a file .............................................................. 2-137 Starts the adding of an assembled geometry object ... 2-138 Add an assembled geometry object to a polyline ........ 2-139 Closes the editing of an assembled geometry object ........................................................................... 2-141
7. 7.1 7.2 7.3
Unicode TLV commands ........................................... 2-142 Set variable with Unicode data .................................... 2-142 Read variable with Unicode data ................................. 2-145 Initialize variable with Unicode data (from TruTops Mark 2.9) ...................................................................... 2-146
8. 8.1 8.2 8.3 8.4 8.5 8.6 8.7 8.8 8.9 8.10 8.11 8.12
Additional TLV commands ....................................... 2-148 External program ......................................................... 2-148 DLL function ................................................................. 2-149 Start laser calibration (LPC) or cancel (from TTM 2.7) ............................................................. 2-150 LPC status (from TTM 2.7) .......................................... 2-152 Load camera settings .................................................. 2-154 Execute camera function ............................................. 2-155 Set tag value ................................................................ 2-156 Read tag value ............................................................. 2-158 Capture image ............................................................. 2-160 Load image in camera (not yet implemented) ............. 2-161 Save image .................................................................. 2-162 Query available cameras ............................................. 2-163
9.
Sample processes for activation of the laser marking system with TLV sequences...................... 2-164
8
Table of contents
2017-02-23
SW-TLV-EN
9.1 9.2
9.3 9.4 9.5
9.6 9.7 9.8 9.9 9.10 9.11 9.12 9.13
SW-TLV-EN
2017-02-23
Example_01 Load and mark a marking file without variables....................................................................... 2-164 Example_02 Load and mark a marking file without variables for which the marking has been moved and scaled.................................................................... 2-165 Example_03 Load and mark a marking file with three variables ...................................................... 2-166 Example_04 Create a marking file Add objects and mark the created marking file ...................................... 2-167 Example_05 Add a rectangle and a line to an existing marking file and mark the revised marking file ................................................................................ 2-168 Example_06 Include a CAD file in a marking file and mark the modified marking file .............................. 2-169 Example_07 Mark 2 points without marking file using scanner beam monitoring .................................. 2-170 Example_08 Load, convert and activate the marking file in the 2 scanner lists ................................ 2-171 Example _09 Load and mark a marking file with a variable that is set with Unicode data .......................... 2-172 Example_11 Load the marking file in scanner list and set the MOF parameters ....................................... 2-173 Example_12 Demonstration of using automated Binning ......................................................................... 2-174 Example_13 TLV conversion statuses (G2) with variable ........................................................................ 2-175 Example_14 Execute camera function and carry out code analysis. ........................................................ 2-176
Table of contents
9
10
Table of contents
2017-02-23
SW-TLV-EN
Chapter 1 Command-interpreter user interface for TruTops Mark®
SW-TLV-EN 2017-02-23
1.
Functional scope of the command-interpreter ........... 1-3
2.
Starting the TLV command interpreter ........................ 1-5
3. 3.1 3.2 3.3
Application window ....................................................... 1-5 Status info ........................................................................ 1-6 Monitor area ..................................................................... 1-7 Buttons for the command interpreter ............................... 1-8 3.3.1. "F2 Monitor on/Monitor off" ............................... 1-8 3.3.2. "F3 Clear Monitor" ............................................ 1-8 3.3.3. "F4 Configuration" ............................................ 1-9 3.3.4. "F5 Find TLV-CMD" (command)..................... 1-10 3.3.5. "F6 Next TLV-CMD" (command) .................... 1-11 3.3.6. "F7 Configure interface" ................................. 1-11 3.3.7. "F8 Display interface/Hide interface" .............. 1-11 3.3.8. "F9 Reset interface"........................................ 1-12
1-1
1-2
SW-TLV-EN 2017-02-23
1.
Functional scope of the commandinterpreter
With the command interpreter for TruTops Mark®, the laser marking system can be controlled by means of TLV commands. Different communication-interface modules can be used for communication. The following communication interfaces are currently supported: •
Profibus DP/DPV1 with the control processor as Profibus slave •
•
Profinet with the control processor as ProfiNet device •
•
A "CIF 50-DPS" or a "CIFX 50-DP" Field bus card from Hilscher must be installed in your control processor. A "CIFX 50-RE" Field bus card from Hilscher must be installed in your control processor.
EtherCat with the control processor as Ethercat slave •
A "CIFX 50-RE" Field bus card from Hilscher must be installed in your control processor.
•
Serial interfaces with a simple log
•
Ethernet TCP/IP protocol
•
COM interface (SW interface) o See Interface description
The supported TLV commands are described in chapter 2 TLV commands. The main functions of the command interpreter are: •
Interpreting the received TLV commands and activating the corresponding marking function.
•
Recording the TLV communication in a monitor.
•
Recording the TLV communication in a LOG file.
Note The LSB (least significant bit) abbreviation appears in the description in chapter 2, section 3.8. If you imagine a horizontal bit sequence, then it depends on the bit sequence whether the bits are counted from the right (with the LSB) or left (with the MSB). The counting starts with zero for the lowest-value bit (LSB) on the right side and goes from right to left. The lowest-value bit has the lowest value of 1.
Fig. 1-1
SW-TLV-EN 2017-02-23
1-3
The command interpreter supports two types of the TLV communication: 1. TLV sequences: Every TLV request is answered with a TLV response by the command interpreter in this case.
2. Individual TLV commands:
The TLV request from the command interpreter is not answered with a TLV response in this case. In addition, TLV responses are provided by the command interpreter without having received a TLV request in the first place. This type of communication is used together with Profibus DP and allows controlling the "Marking laser" using the Processdata interface of Profibus DP. The available process-data interface is described in separate documentation (Profibus documentation).
1-4
SW-TLV-EN 2017-02-23
2.
Starting the TLV command interpreter
Start TruTops Mark®. Select one of the above-listed interfaces supported by the command-interpreter in the "Module" menu.
3.
Application window
After starting the command-interpreter successfully, it is displayed on the right side of the TruTops Mark® user interface such that the following display appears:
3.1 3.2
3.3
Initial screen of the command interpreter
Fig. 1-2
The user interface (GUI) of the command-interpreter basically comprises three parts:
SW-TLV-EN 2017-02-23
•
Display area (3.1) for the communication interface status
•
Monitor area (3.2) for recording the commands executed in TLV notation
•
Bar (3.3) with the buttons for controlling the commandinterpreter
1-5
3.1
Status info
The current status of the communication interface is displayed via an LED. Allocation of the individual statuses/colors is explained below. •
A total of four different statuses are displayed:
•
The communication interface is not ready as yet to replace TLV commands (status color is gray)
Status display in the "Not ready for TLV commands" status
•
The communication interface is ready to replace TLV commands (status color is green)
Status display in the "Ready for TLV commands" status
•
The communication interface is reset or configured at present (status color is yellow)
Status display in the "Reset & configuration" status
•
Communication interface is in the error state (status color is red)
Status display in the "Error" status
The statuses, causes and possible error correction measures can be seen in the Communication interfaces documentation: •
1-6
Profibus documentation and Interface description
SW-TLV-EN 2017-02-23
3.2
Monitor area
The executed TLV commands can be executed here, where a maximum of the last 400 recorded lines are saved in the monitor. Two types of TLV commands are recorded: •
TLV sequences comprising a TLV request and a TLV response
Example of a TLV sequence
•
Fig. 1-3
Structure of a recorded TLV sequence: 1. Line: TLV request with TAG, LENGTH and VALUE in HEX representation 2. Line: TLV response with TAG, LENGTH and VALUE in HEX representation 3. Line: interpreted TLV sequence with the result of the functional execution
•
Individual TLV commands
Example of an individual TLV command
•
Fig. 1-4
Structure of a recorded TLV command: 1.
Line: TLV command with TAG, LENGTH and VALUE in HEX representation
2. Line: interpreted TLV command with the result of the execution
SW-TLV-EN 2017-02-23
1-7
3.3
Buttons for the command interpreter
The command-interpreter function can be controlled using these buttons or the allocated function keys.
Fig. 1-5
• • •
Controlling the monitor Searching for TLV commands Configuring the command-interpreter or configuring and diagnosing the communication interfaces
3.3.1. "F2 Monitor on/Monitor off"
Statuses of the F2 button
Fig. 1-6
This button can be used to start or stop the recording of the TLV commands in the monitor. •
Recording that has started
•
Recording that has stopped
The button has the "F2 Stop monitor" text The F5/F6 buttons or their functions are not available. The button has the "F2 Start monitor" text The F5/F6 buttons or their functions are available. The command-interpreter continues running background.
in
the
3.3.2. "F3 Clear Monitor" This button can be used to delete the monitor recording.
1-8
SW-TLV-EN 2017-02-23
3.3.3. "F4 Configuration" This button can be used to configure the commandinterpreter. • Click the button or press the relevant function key • The following input dialog box is displayed, via which you can configure the different settings.
Configuration dialog box of the command-interpreter
Fig. 1-7
The following configuration options are available: •
•
SW-TLV-EN 2017-02-23
Log mode: – You can activate/deactivate the option of recording the TLV command in a LOG file. The name of the LOG file can be freely selected in this case. Default name of the LOG file: "CMI.LOG" Laser status and input status (available only for the Profibus interface): – You can activate/deactivate the option of sending the laser/input status automatically in case of changes in the respective statuses.
1-9
3.3.4. "F5 Find TLV-CMD" (command)
Statuses of the F5 button
Fig. 1-8
This button can be used to find a TLV command in the monitor recording. (Start the search is the first input in the monitor recording.). • Click the button or press the relevant function key – The following input dialog box is displayed using the buttons, in which you can enter the number of the searched TLV command as a decimal number.
Input dialog box for finding the TLV commands
•
If the searched TLV command is found in the monitor recording, it is highlighted and displayed on the monitor.
Displaying a TLV command that is found
1-10
Fig. 1-9
Fig. 1-10
SW-TLV-EN 2017-02-23
3.3.5. "F6 Next TLV-CMD" (command)
Statuses of the F6 button
Fig. 1-11
This button can be used to find the next occurrence of a TLV command in the monitor recording, which has already been searched for previously with the F5 button.
3.3.6. "F7 Configure interface" This button can be used to start the configuration dialog box of the communication interface. For more information regarding the configuration options, refer to the following communication interfaces: •
Profibus documentation
•
Interface description
3.3.7. "F8 Display interface/Hide interface"
Statuses of the F8 function key
Fig. 1-12
This button can be used to display/hide the user interface of the communication interfaces. The user interface of the communication interfaces can be used to configure or diagnose the same: See the following documentation of the communication interfaces:
SW-TLV-EN 2017-02-23
•
Profibus documentation
•
Interface documentation
1-11
3.3.8. "F9 Reset interface" This button can be used to reset the communication interfaces.
1-12
SW-TLV-EN 2017-02-23
Chapter 2 TLV Commands
SW-TLV-EN
2017-02-23
1.
Structure of TLV Commands/TLV
1.1 1.2
Communications ............................................................ 2-7 TLV Commands ............................................................... 2-7 TLV Communications ....................................................... 2-7
2. 2.1 2.2 2.3
Structure of the TLV Command Listings ..................... 2-8 TLV Sequence with ASCII string as TLV Value ............... 2-8 TLV Sequence with Unicode string as TLV Value ......... 2-10 Legend of the abbreviations used for the zeroterminated strings ........................................................... 2-11 2.3.1. Result of the TLV request (G1) ....................... 2-12 2.3.2. Extended error code (G2) ............................... 2-12
3. 3.1 3.2 3.3 3.4 3.5 3.6 3.7 3.8
TLV commands for laser control system................... 2-13 Laser/shutter .................................................................. 2-13 Shutter ............................................................................ 2-14 Pilot laser ........................................................................ 2-15 Marking ........................................................................... 2-16 Trigger marking .............................................................. 2-18 Abort marking ................................................................. 2-19 Marking status ................................................................ 2-20 Laser status in Winmark format ..................................... 2-21
TLV commands
2-1
3.9 3.10 3.11 3.12 3.13 3.14 3.15 3.16 3.17 3.18 3.19 3.20
3.22 3.23 3.24 3.25 3.26 3.27 3.28 3.29 3.30 3.31 3.32 3.33 3.34 3.35
Laser reset ..................................................................... 2-22 Trigger conversion.......................................................... 2-23 Conversion status........................................................... 2-24 Read pilot laser mode .................................................... 2-25 Set pilot laser mode........................................................ 2-26 Read "Marking on the fly" parameters ........................... 2-27 Set "Marking on the fly" parameters............................... 2-29 Read RTC parameters ................................................... 2-30 Segment info .................................................................. 2-31 Segment data ................................................................. 2-33 Mark Segment ................................................................ 2-34 Creating the matrix and binning file for matrix segmentation .................................................................. 2-36 Creation of a new matrix file for the matrix segmentation .................................................................. 2-38 Laser status .................................................................... 2-41 Last error ........................................................................ 2-42 Short error/warning text .................................................. 2-43 Last warning ................................................................... 2-44 Laser............................................................................... 2-45 Q-switch ......................................................................... 2-46 Initialization of beam monitoring by the scanner ............ 2-47 Scanner beam monitoring .............................................. 2-49 Laser power .................................................................... 2-50 Frequency ...................................................................... 2-51 Defocusing ..................................................................... 2-52 Set laser parameters offsets .......................................... 2-53 Switching on or switching off "Marking on the fly" .......... 2-54 Switching on or switching off the retrigger mode ........... 2-55
4. 4.1 4.2 4.3 4.4 4.5 4.6 4.7 4.8 4.9 4.10 4.11 4.12 4.13 4.14 4.15
TLV commands for Mechanics SW module .............. 2-56 Reference all axes.......................................................... 2-56 Reference axis ............................................................... 2-57 Reference two axes........................................................ 2-58 Move axis ....................................................................... 2-59 Move two axes ............................................................... 2-61 Axis position ................................................................... 2-62 Recognize focal position ................................................ 2-63 Set segment offset for axes ........................................... 2-64 Open door ...................................................................... 2-65 Close door ...................................................................... 2-66 Rotate rotation door........................................................ 2-67 Status rotating door ........................................................ 2-68 Move foil module ............................................................ 2-69 Edge-detection ............................................................... 2-70 Mechanics status............................................................ 2-71
3.21
2-2
TLV commands
SW-TLV-EN
2017-02-23
4.16 4.17 4.18 4.19
Mechanics error.............................................................. 2-74 Moving axes continuously (from TTM 2.7) ..................... 2-78 Stop all axes (from TTM 2.7) ......................................... 2-79 Switch axis on or off ....................................................... 2-80
5. 5.1 5.2 5.3 5.4 5.5 5.6 5.7 5.8 5.9
TLV commands for the digital interface..................... 2-81 Inputs of the digital interface .......................................... 2-81 X input of the digital interface ......................................... 2-82 Digital interface outputs .................................................. 2-83 X output of the digital interface ....................................... 2-84 Inputs 1 to 8 of the digital interface ................................ 2-85 Inputs 9 to 16 of the digital interface .............................. 2-86 Inputs 17 to 24 of the digital interface ............................ 2-87 Outputs 1 to 8 of the digital interface ............................. 2-88 Outputs 9 to 16 of the digital interface ........................... 2-89
6. 6.1 6.2 6.3 6.4 6.5 6.6 6.7 6.8 6.9 6.10
TLV commands for the marking control system ...... 2-90 Load marking file ............................................................ 2-90 Convert marking file ....................................................... 2-91 Mark marking file X......................................................... 2-92 Set directory path ........................................................... 2-93 N text variable (see also "Set variable") ......................... 2-94 Read file name/directory ................................................ 2-95 Set variable .................................................................... 2-96 Read variable ................................................................. 2-98 Scaling/displacement ..................................................... 2-99 Rotating/displacing the marking field in MHS systems ........................................................................ 2-100 Load marking objects into the scanner ........................ 2-101 Activate scanner list ..................................................... 2-104 Start scanner list........................................................... 2-105 Delete active VCT files ................................................. 2-106 Delete all VCT files ....................................................... 2-107 Hiding and showing the HMI ........................................ 2-108 Generating marking file for editing ............................... 2-109 Load marking file for editing ......................................... 2-110 Import CAD file ............................................................. 2-111 Save the marking file opened for editing ...................... 2-113 Adding a line................................................................. 2-113 Add an arc .................................................................... 2-115 Add a circle ................................................................... 2-116 Add a rectangle ............................................................ 2-117 Add a text ..................................................................... 2-118 Add an expanded text .................................................. 2-119 Add a variable .............................................................. 2-121 Replace laser parameter .............................................. 2-122
6.11 6.12 6.13 6.14 6.15 6.16 6.17 6.18 6.19 6.20 6.21 6.22 6.23 6.24 6.25 6.26 6.27 6.28
SW-TLV-EN
2017-02-23
TLV commands
2-3
6.29 6.30 6.31 6.32 6.33 6.34 6.35 6.36 6.37 6.38 6.39 6.40 6.41 6.42 6.43
Replace fill parameter .................................................. 2-123 Initialize all variables .................................................... 2-124 Initialize variable ........................................................... 2-125 Set laser parameters – properties ................................ 2-126 Read laser parameter – Properties .............................. 2-127 Hide blocks ................................................................... 2-128 Add a Bitmaps (as of TruTops Mark 2.5.3) .................. 2-129 Close the TruCad Server.............................................. 2-130 Adding a polyline .......................................................... 2-131 Adding an ellipse .......................................................... 2-133 Adding an ellipse arc .................................................... 2-135 Copying a file............................................................... 2-137 Starts the adding of an assembled geometry object .... 2-138 Add an assembled geometry object to a polyline ........ 2-139 Closes the editing of an assembled geometry object ............................................................................ 2-141
7. 7.1 7.2 7.3
Unicode TLV commands ........................................... 2-142 Set variable with Unicode data ..................................... 2-142 Read variable with Unicode data ................................. 2-145 Initialize variable with Unicode data (from TruTops Mark 2.9) ...................................................................... 2-146
8. 8.1 8.2 8.3 8.4 8.5 8.6 8.7 8.8 8.9 8.10 8.11 8.12
Additional TLV commands ........................................ 2-148 External program .......................................................... 2-148 DLL function ................................................................. 2-149 Start laser calibration (LPC) or cancel (from TTM 2.7) ............................................................................... 2-150 LPC status (from TTM 2.7) ........................................... 2-152 Load camera settings ................................................... 2-154 Execute camera function .............................................. 2-155 Set tag value ................................................................ 2-156 Read tag value ............................................................. 2-158 Capture image .............................................................. 2-160 Load image in camera (not yet implemented) .............. 2-161 Save image .................................................................. 2-162 Query available cameras ............................................. 2-163
9.
Sample processes for activation of the laser
9.1 9.2
2-4
marking system with TLV sequences ...................... 2-164 Example_01 Load and mark a marking file without variables ....................................................................... 2-164 Example_02 Load and mark a marking file without variables for which the marking has been moved and scaled .................................................................... 2-165
TLV commands
SW-TLV-EN
2017-02-23
9.3 9.4 9.5
9.6 9.7 9.8 9.9 9.10 9.11 9.12 9.13
SW-TLV-EN
2017-02-23
Example_03 Load and mark a marking file with three variables ...................................................... 2-166 Example_04 Create a marking file Add objects and mark the created marking file ....................................... 2-167 Example_05 Add a rectangle and a line to an existing marking file and mark the revised marking file ................................................................................. 2-168 Example_06 Include a CAD file in a marking file and mark the modified marking file .............................. 2-169 Example_07 Mark 2 points without marking file using scanner beam monitoring ................................... 2-170 Example_08 Load, convert and activate the marking file in the 2 scanner lists ................................. 2-171 Example _09 Load and mark a marking file with a variable that is set with Unicode data........................... 2-172 Example_11 Load the marking file in scanner list and set the MOF parameters ....................................... 2-173 Example_12 Demonstration of using automated Binning ......................................................................... 2-174 Example_13 TLV conversion statuses (G2) with variable ......................................................................... 2-175 Example_14 Execute camera function and carry out code analysis.......................................................... 2-176
TLV commands
2-5
2-6
TLV commands
SW-TLV-EN
2017-02-23
1.
Structure of TLV Commands/TLV Communications
If deviations from TruTops Mark® operating software utilized should occur, then these are indicated and explained at the respective points.
1.1
TLV Commands
TLV means TAG/LENGTH/VALUE. A TLV Command is made up of these three parts. The meanings of the individual parts are listed below. Description
Data size
TAG
Designation of the commands
4 bytes
LENGTH
Number of utility data in the VALUE field
4 bytes
Call-up or return parameter of the command
VALUE
(utility data of the command)
n * bytes Maximum of 64 KB
Table 2-1
1.2
TLV Communications
TLV Communications is structured as a sequence made up of TLV request and TLV Response: •
The TLV request corresponds to the requirement the same way it corresponds to a service (e.g. Set outputs/Reading inputs)
•
The TLV Response corresponds to the response to the request for the service (e.g. Result of service performance/Status of inputs)
TLV communication (example with laser marking system/laser marking device VectorMark compact)
SW-TLV-EN
2017-02-23
TLV commands
Fig. 2-1
2-7
2.
Structure of the TLV Command Listings
There are basically 2 types of TLV commands available: •
With ASCII string as TLV Value in Chapters 3, 4, 5, 6, 8
•
With Unicode strings as TLV Value in Chapter 7
Each of the TLV sequences available are described here in two tables.
2.1
General Definition of the TLV Sequence
TLV Sequence with ASCII string as TLV Value
Name of the TLV Command Brief description of the TLV Command TAG Request
Response
Number of the TLVTAG
LENGTH
VALUE
Number of bytes of the TLV VALUE
Zeroterminated ASCII string
Number of bytes of the TLV VALUE
Zeroterminated ASCII string
Remark
Table 2-2
Display of the TAG and LENGTH •
Specification as decimal number
•
The zero terminators of the ASCII string must be included in the count for the LENGTH value.
Display of a zero-terminated ASCII string using the example of HELLO:
2-8
•
ASCII display: "HELLO"
•
HEX display: 48 41 4C 4C 4F 00
TLV commands
SW-TLV-EN
2017-02-23
Display of several zero-terminated ASCII strings using the example of HELLO WORLD:
Display of the TLV Sequence in a concrete example
•
ASCII display: "HELLO" + "WORLD"
•
HEX display: 48 41 4C 4C 4F 00 57 45 4C 54 00
Example: General ASCII Dummy Command TAG Request
LENGTH
Number of the TLV TAG
HEX display of the TAG
VALUE
Number of bytes of the TLV VALUE
ASCII display of the VALUE
HEX display
HEX display of the VALUE
of the LENGTH Response
Number of the TLV TAG
HEX display of the TAG
Number of bytes of the TLV VALUE
ASCII display of the VALUE
HEX display
HEX display of the VALUE
of the LENGTH
Table 2-3
Example: Concrete ASCII Dummy Command Request
TAG
LENGTH
VALUE
12345
12
"123" + "456" + "abc"
39 30 00 00 0C 00 00 00 Response
31 32 33 00 34 35 36 00 61 62 63 00
12345
2
"0"
39 30 00 00
02 00 00 00
30 00 Table 2-4
SW-TLV-EN
2017-02-23
TLV commands
2-9
2.2
General Definition of the TLV Sequence
TLV Sequence with Unicode string as TLV Value
Name of the TLV Command Brief description of the TLV Command TAG Request
Response
LENGTH
VALUE
Number of bytes of the TLV VALUE
Zeroterminated Unicode string
Number of bytes of the TLV VALUE
Zeroterminated Unicode string
Remark
Number of the TLV TAG
Table 2-5
Display of the TAG and LENGTH •
Specification as decimal number
•
The zero terminators of the Unicode string must be included in the count for the LENGTH value.
Display of a zero-terminated Unicode string using the example of HELLO: •
Unicode display: "HELLO"
•
HEX display: 0048 0041 004C 004C 004F 0000
Display of several zero-terminated Unicode strings using the example of HELLO WORLD:
2-10
•
Unicode display: "HELLO" + "WORLD"
•
HEX display: 0048 0041 004C 004C 004F 0000 0057 0045 004C 0054 0000
TLV commands
SW-TLV-EN
2017-02-23
Display of the TLV Sequence in a concrete example
Example: General Dummy Command Request
TAG
LENGTH
VALUE
Number of the TLV TAG
Number of bytes of the TLV VALUE
Unicode display of the VALUE
HEX display of the TAG
HEX display
HEX display of the VALUE
of the LENGTH Response
Number of the TLV TAG
Number of bytes of the TLV VALUE
Unicode display of the VALUE
HEX display of the TAG
HEX display
HEX display of the VALUE
of the LENGTH
Table 2-6
Example: Concrete Dummy Command Request
TAG
LENGTH
VALUE
67890
24
"123" + "456" + "abc"
32 09 01 00 Response
31 00 32 00 33 00 00 00 34 00 18 00 00 00 35 00 36 00 00 00 61 00 62 00 63 00 00 00
67890
4
"0"
32 09 01 00
04 00 00 00
30 00 00 00 Table 2-7
2.3
Legend of the abbreviations used for the zero-terminated strings
Abbreviati on
Description
Example in ASCII display
T
Text string in ASCII/Unicode format
"Hello"
G
Whole number in ASCII/Unicode format
"1234"
D
Decimal number in ASCII/Unicode format (only decimal point permits no commas!)
B
BINARY string in ASCII/Unicode format
"45.678"
"11001100" Table 2-8
SW-TLV-EN
2017-02-23
TLV commands
2-11
2.3.1. Result of the TLV request (G1) The number of possible return values has been extended for TruTops Mark®. The following return values are currently available here: Result of the TLV request
Meaning/Remarks
0
Command executed correctly
1
Command could not be executed (-> See extended error code)
2
Erroneous TLV VALUE
3
Invalid TLV LENGTH of the Request for the active communication interface
4
Invalid TLV LENGTH of the Response for the active communication interface Table 2-9
2.3.2. Extended error code (G2) This is supported starting with TruTops Mark® and attached to the TLV response when the "Result of the TLV request" has been set to "1". It contains detailed information concerning the cause of the error behind the incorrect execution of the TLV request and makes this available to the external control system. The interpretation of the expanded error code is listed in the description of the individual TLV commands.
2-12
TLV commands
SW-TLV-EN
2017-02-23
3.
TLV commands for laser control system
3.1
Laser/shutter
Activates/deactivates the laser and opens/closes the shutter TAG
LENGTH
Request
VALUE
2
Remark
"G"
Response
G:
Status for laser/shutter
0:
Æ
Laser OFF and shutter closed
1:
Æ
Laser ON and shutter open
Extended error code:
"G1" + "G2" G1: 20201 Number of bytes in the TLV Value
•
Result of the TLV request:
0:
Æ
Command executed correctly
1:
Æ
Command could not be executed (see extended error code)
2:
Æ
Erroneous TLV VALUE
3:
Æ
Invalid TLV LENGTH of the request for the active communication interface
G2:
Extended error code
> 0:
Æ
Is added on to the TLV Response when the result of the TLV Request is "1".
Internal error Table 2-10
Example: Activate laser and open shutter
Request Response
TAG
LENGTH
VALUE
20201
2
"1"
E9 4E 00 00
02 00 00 00
31 00
20201
2
"0"
E9 4E 00 00
02 00 00 00
30 00 Table 2-11
SW-TLV-EN
2017-02-23
TLV commands
2-13
3.2
Shutter
Opens/closes the shutter TAG
LENGTH
Request
2
VALUE "G"
Response
G:
Status of the shutter
0:
Æ
Shutter for
1:
Æ
Shutter open
Extended error code:
"G1" + "G2" G1:
20202
Remark
Number of bytes in the TLV Value
Result of the TLV request:
0:
Æ
Command executed correctly
1:
Æ
Command could not be executed (see extended error code)
2:
Æ
Erroneous TLV VALUE
3:
Æ
Invalid TLV-LENGTH of the request
•
Is added on to the TLV Response when the result of the TLV request is "1".
active communication interface
G2:
Extended error code
> 0:
Æ
Internal error Table 2-12
Example: Close the shutter Request Response
TAG
LENGTH
VALUE
20202
2
"0"
EA 4E 00 00
02 00 00 00
30 00
20202
2
"0"
EA 4E 00 00
02 00 00 00
30 00 Table 2-13
2-14
TLV commands
SW-TLV-EN
2017-02-23
3.3
Pilot laser
Activates/deactivates the pilot laser TAG
LENGTH
Request
2
Response
VALUE "G" G:
Status of the shutter:
0:
Æ
Switch off pilot laser
1:
Æ
Switch on pilot laser Extended error code:
"G1" + "G2" G1:
20203
Number of bytes in the TLV Value
Remark
Result of the TLV request:
0:
Æ
Command executed correctly
1:
Æ
Command could not be executed (see extended error code)
2:
Æ
Erroneous TLV VALUE
3:
Æ
Invalid TLV LENGTH of the Request for the active communication interface
9:
Æ
Option not activated
G2: > 0:
•
Is added on to the TLV Response when the result of the TLV request is "1".
Extended error code: Æ Internal error Table 2-14
Example: Activate pilot laser TAG Request Response
LENGTH
VALUE
20203
2
"1"
EB 4E 00 00
02 00 00 00
31 00
20203
2
"0"
EB 4E 00 00
02 00 00 00
30 00 Table 2-15
SW-TLV-EN
2017-02-23
TLV commands
2-15
3.4
Marking
Starts the marking procedure for the loaded marking file and waits until the marking procedure has been completed. TAG Request
LENGTH
VALUE
Remark
0
No data
The following conditions must be fulfilled: •
Marking file must be loaded
The beam source or the pilot laser must be switched on Extended error code: •
Response
"G1" + "G2" G1:
Result of the TLV request:
0:
Æ Command executed
1:
Æ Command could not be
3:
Æ Invalid TLV LENGTH of
correctly
•
Is added on to the TLV Response when the result of the TLV request is "1".
executed (see extended error code) the request for the
active communication interface
G2: 1:
Extended error code:
Æ No converted marking file is available
20204 Number of bytes in the TLV Value
2:
Æ No marking file is loaded
3:
Æ Lasers or pilot lasers are switched off
4:
Æ Marking and/or
conversion procedure by Trigger command already activated
5:
Æ Marking procedure has been aborted manually
10:
Æ General conversion errors
11:
Æ No conversion, empty variable
12:
Æ Laser font not available
13:
Æ Variable from text file: all data processed
14:
Æ Serial number: end value reached
15:
Æ Execution in the case of
activated "Restart mark" is not allowed
> 15:
Æ Internal error Table 2-16
2-16
TLV commands
SW-TLV-EN
2017-02-23
Example: Mark loaded marking file Request
Response
TAG
LENGTH
VALUE
20204
0
No data
EC 4E 00 00
00 00 00 00
20204
2
"0"
EC 4E 00 00
02 00 00 00
30 00 Table 2-17
SW-TLV-EN
2017-02-23
TLV commands
2-17
3.5
Trigger marking
Starts the marking procedure for the loaded marking file, does not however wait until the marking procedure has been completed, but rather jumps back at once. TAG Request
LENGTH
VALUE
Remark
0
No data
The following conditions must be fulfilled: •
Marking file must be loaded
•
Response
"G1" + "G2" G1: 0:
Æ Command executed
1:
Æ Command could not be
3:
Æ Invalid TLV LENGTH of
G2: 1:
20205
Result of the TLV request: correctly
The beam source or the pilot laser must be switched on Extended error code: •
Is added on to the TLV Response when the result of the TLV request is "1".
executed (see extended error code) the request for the active communication interface
Extended error code:
Æ A marking procedure has already been activated
Number of bytes in the TLV Value
2:
Æ No converted marking file is available
3:
Æ No marking file is loaded
4:
Æ Lasers or pilot lasers are switched off
10:
Æ General conversion errors
11:
Æ No conversion, empty variable
12:
Æ Laser font not available
13:
Æ Variable from text file: all data processed
14:
Æ Serial number: end value
15:
Æ Execution in case of
reached
activated "Restart mark" is not allowed
> 15:
Æ Internal error Table 2-18
2-18
TLV commands
SW-TLV-EN
2017-02-23
Example: Trigger marking procedure
Request
Response
TAG
LENGTH
VALUE
20205
0
No data
ED 4E 00 00
00 00 00 00
20205
2
"0"
ED 4E 00 00
02 00 00 00
30 00 Table 2-19
3.6
Abort marking
Interrupts the ongoing marking procedure TAG
LENGTH
VALUE
0
No data
Request Response
Remark
"G1" + "G2" G1:
20206
Number of bytes in the TLV Value
Result of the TLV request:
0:
Æ Command executed correctly
1:
Æ Command could not be executed (see extended error code)
3:
Æ Invalid TLV LENGTH of the request for the active communication interface
G2: 0:
Note: • After the TLV Response has been received, the actual ending of the marking must be checked by means of the TLV Command "Marking status" before further TLV commands can be executed. Extended error code:
Extended error code: Æ Internal error
•
Is added on to the TLV Response when the result of the TLV request is "1". Table 2-20
Example: Interrupt the ongoing marking procedure Request
Response
TAG
LENGTH
VALUE
20206
0
No data
EE 4E 00 00
00 00 00 00
20206
2
"0"
EE 4E 00 00
02 00 00 00
30 00 Table 2-21
SW-TLV-EN
2017-02-23
TLV commands
2-19
3.7
Marking status
Reads the current marking status TAG
LENGTH
VALUE
0
No data
Request Response
Remark
Extended error code:
"G1" + "G2" + "G3" G1:
20207
Number of bytes in the TLV Value
Result of the TLV request:
0:
Æ Command executed correctly
1:
Æ Command could not be executed (see extended error code)
3:
Æ Invalid TLV LENGTH of the request for the active communication interface
G2:
•
Is added on to the TLV Response when the result of the TLV request is "1".
Extended error code:
0:
Æ Marking procedure is not active
1:
Æ Marking procedure is active
G3:
Extended error code:
> 0:
Æ Internal error Table 2-22
Example: Read marking status: marking active Request
Response
TAG
LENGTH
VALUE
20207
0
No data
EF 4E 00 00
00 00 00 00
20207
4
"0" + "1"
EF 4E 00 00
04 00 00 00
30 00 31 00 Table 2-23
2-20
TLV commands
SW-TLV-EN
2017-02-23
3.8
Laser status in Winmark format
Reads the laser status in the Winmark format TAG
LENGTH
VALUE
0
No data
Request
"G1" + "B1" + "B2" + "G2" G1: Result of the TLV request: 0: Æ Command executed correctly 1: Æ Command could not be executed (see extended error code) 3: Æ Invalid TLV LENGTH of the request for the active communication interface 4: Æ Invalid TLV LENGTH of the response for the active communication interface
Response
B1:
20208
Number of bytes in the TLV Value
1Æ 1Æ
Bit 5:
1Æ
Bit 4:
1Æ
Bit 3: Bit 2:
1Æ 1Æ
Bit 1: Bit 0:
1Æ 1Æ 1Æ 1Æ 1Æ
Bit 12:
1Æ
Bit 11:
1Æ
Bit 10:
1Æ
Bit 9: Bit 8:
1Æ 1Æ
0:
•
LSB is on the right in each case in the binary string
Extended error code: •
Is added on to the TLV Response when the result of the TLV request is "1".
Pilot laser is on Laser has a malfunction Warning laser has responded Beam expander in position Shutter is open Safety circuit is closed Laser is ready Beam source on
Bit 15 – 8
Bit 15: Bit 14: Bit 13:
G2:
Formatting the laser status:
Bit 7 – 0
Bit 7: Bit 6:
B2:
Remark
Marking is active Control is on Heating period laser is on EMERGENCY SHUTDOWN circuit is closed Key switch laser is closed Switch of control manually is activated Q-Switch trigger is on Laser warning lamp is on
Extended error code: Æ
Internal error
Table 2-24
SW-TLV-EN
2017-02-23
TLV commands
2-21
Example: Laser status query in Winmark format Request
Response
TAG
LENGTH
VALUE
20208
0
No data
F0 4E 00 00
00 00 00 00
20208
20
"0" + "00001111" + "00011000"
F0 4E 00 00
14 00 00 00
30 00 30 30 30 30 31 31 31 31 00 30 30 30 31 31 30 30 30 00 Table 2-25
3.9
Laser reset
Carries out a resetting of the laser TAG
LENGTH
VALUE
0
No data
Request Response
"G1" + "G2" G1:
20209
Number of bytes in the TLV Value
Result of the TLV request:
0:
Æ Command executed correctly
1:
Æ Command could not be executed (see extended error code)
3:
Æ Invalid TLV LENGTH of the request for the active communication interface
G2: 0:
Remark
Extended error code: •
Is added on to the TLV Response when the result of the TLV request is "1".
Extended error code: Æ Internal error Table 2-26
Example: Reset the laser Request
Response
TAG
LENGTH
VALUE
20209
0
No data
F1 4E 00 00
00 00 00 00
20209
2
"0"
F1 4E 00 00
02 00 00 00
30 00 Table 2-27
2-22
TLV commands
SW-TLV-EN
2017-02-23
3.10 Trigger conversion
Starts the conversion procedure for the loaded marking file, does not however wait until the conversion procedure has been completed, but rather jumps back at once. TAG
LENGTH
VALUE
Remark
0
No data
The following conditions must be fulfilled:
Request
• Response
Extended error code:
"G1" + "G2" G1:
20221
Æ Command executed correctly
1:
Æ Command could not be executed (see extended error code)
3:
Æ Invalid TLV LENGTH of the request for the active communication interface
G2:
Number of bytes in the TLV Value
Result of the TLV request:
0:
•
Is added on to the TLV Response when the result of the TLV request is "1".
Extended error code:
1:
Æ A conversion procedure is already active
2:
Æ No marking file is loaded
10:
Æ General conversion errors
11:
Æ No conversion, empty variable
12:
Æ Laser font not available
13:
Æ Variable from text file: all data processed
14:
Æ Serial number: end value reached
> 14:
Marking file must be loaded
Æ Internal error
Table 2-28
Example: Trigger conversion procedure Request
Response
TAG
LENGTH
VALUE
20221
0
No data
FD 4E 00 00
00 00 00 00
20221
2
"0"
FD 4E 00 00
02 00 00 00
30 00 Table 2-29
SW-TLV-EN
2017-02-23
TLV commands
2-23
3.11 Conversion status Reads the current conversion status TAG
LENGTH
VALUE
0
No data
Request Response
Remark
Extended error code:
"G1" + "G2" + "G3" G1:
20222
Number of bytes in the TLV Value
Result of the TLV request:
0:
Æ Command executed correctly
1:
Æ Command could not be executed (see extended error code)
3:
Æ Invalid TLV LENGTH of the request for the active communication interface
G2:
•
Is added on to the TLV Response when the result of the TLV Request is "1".
Marking status:
0:
Æ Conversion procedure is not active
1:
Æ Conversion procedure is active
G3:
Extended error code:
> 0:
Æ Internal error Table 2-30
Example: Read conversion status: conversion active Request
Response
TAG
LENGTH
VALUE
20222
0
No data
FE 4E 00 00
00 00 00 00
20222
4
"0" + "1"
FE 4E 00 00
04 00 00 00
30 00 31 00 Table 2-31
Also see page 2-141, Example_13 TLV conversion statuses (G2) with variable
2-24
TLV commands
SW-TLV-EN
2017-02-23
3.12 Read pilot laser mode Reads the pilot laser mode currently set TAG
LENGTH
VALUE
0
Request Response
Remark
No data "G1" + "G2" + "G3" + "G4" + "G5" + "G6" G1:
Result of the TLV request:
0:
Æ Command executed correctly
1:
Æ Command could not be executed (see extended error code)
3:
Æ Invalid TLV LENGTH of the request for the active communication interface
G2:
Number of bytes in the TLV Value
20231
Æ No pilot laser is available
1:
Æ Contour mode
2:
Æ Rectangle mode Æ Once
1:
Æ Continuous
G4:
Speed in mm/s
G5:
Restart mark
0:
Æ The pilot laser is no longer switched on automatically after activation
1:
Æ The pilot laser is switched on automatically after activation
0:
The parameter G5 is always "0". The automatic start of the pilot laser can be used only with the workstation module
Extended error code: •
Marking mode:
0:
G6:
•
Pilot laser mode:
0:
G3:
Restart mark:
Is added on to the TLV Response when the result of the TLV Request is "1".
Extended error code: Æ Internal error Table 2-32
Example: Read pilot laser mode contour/endless/400 mm/s Request
Response
TAG
LENGTH
VALUE
20231
0
No data
07 4F 00 00
00 00 00 00
20231
10
"0" + "1" + "1" + "400" + "0"
07 4F 00 00
0C 00 00 00
30 00 31 00 31 00 34 30 30 00 30 00 Table 2-33
SW-TLV-EN
2017-02-23
TLV commands
2-25
3.13 Set pilot laser mode Sets the pilot laser mode TAG
LENGTH
Request
VALUE
Remark
"G1" + "G2" + "G3"
Number of bytes in the TLV Value
G1:
Pilot laser mode:
1:
Æ Contour mode
2:
Æ Rectangle mode
G2:
Marking mode:
0:
Æ Once
1:
Æ Continuous
G3:
•
•
Speed in mm/s Valid value range: 1 to 5000
Response
Extended error code:
"G1" + "G2"
20232
G1:
Number of bytes in the TLV Value
Result of the TLV request:
0:
Æ Command executed correctly
1:
Æ Command could not be executed (see extended error code)
2:
Æ Erroneous TLV VALUE
3:
Æ Invalid TLV LENGTH of the request for the active communication interface
9:
Æ Option not activated
G2:
Pilot laser mode:
> 0:
Æ Internal error
If the "Continuous" marking mode is selected, the "Mark" TVL command should not be used at the start of the marking procedure since the marking procedure can only be aborted using the "CTRL C" standard GUI in that case. Instead, the "Trigger marking" TVL command should be used, which can be aborted again using the "Abort marking" TLV command.
•
Is added on to the TLV Response when the result of the TLV Request is "1".
Table 2-34
Example: Set pilot laser mode rectangle mode/endless/200 mm/s Request
Response
TAG
LENGTH
VALUE
20232
8
"2" + "1" + "200"
08 4F 00 00
08 00 00 00
32 00 31 00 32 30 30 00
20232
2
"0"
08 4F 00 00
02 00 00 00
30 00 Table 2-35
2-26
TLV commands
SW-TLV-EN
2017-02-23
3.14 Read "Marking on the fly" parameters Reads the "Marking on the fly" parameters currently set TAG
LENGTH
VALUE No data
Request
0
Response
Explanations: Additional details concerning "Marking on the fly" can be obtained from the associated document. "G1" + "G2" + "G3" + "D1" + "D2" + "D3" + "D4" + "D5" + "G5" G1:
Result of the TLV request:
0:
Æ Command executed correctly
1:
Æ Command could not be executed (see extended error code)
3:
Æ Invalid TLV LENGTH of the request for the active communication interface
20233 Number of bytes in the TLV Value
Remark The following conditions must be fulfilled: "Marking on the fly" must be activated.
G2:
Start delay in 1/16 pulses
G3:
Simulation of the external start signal in 1/16 pulses
D1:
Scaling for the X encoder
D2:
Scaling for the Y encoder
D3:
Scaling for the rotation encoder
D4:
Displacement to the rotation center in X direction
D5:
Displacement to the rotation center in Y direction
G5:
Extended error code:
1: > 1:
Format of the decimal numbers: Are returned with 3 digits after the decimal point. Extended error code:
Is added on to the TLV Response when the result of the TLV Request is "1".
Æ "Marking on the fly" is not activated Æ Internal error Table 2-36
SW-TLV-EN
2017-02-23
TLV commands
2-27
Example:: Reading the currently set "Marking on the fly" parameters: 10 / -5 / 1.5 / 3.0 / 0.0 / 0.0 / 0.0 Request
Response
TAG 20233 09 4F 00 00
LENGTH
VALUE
0 00 00 00 00
No data
20233
32
"0" + "10" + "-5" + "1.500" + "3.000" + "0.0" + "0.0" + "0.0"
09 4F 00 00
20 00 00 00
30 00 31 30 00 2D 35 00 31 2E 35 30 30 00 33 2E 30 30 30 00 30 2E 30 00 30 2E 30 00 30 2E 30 00 Table 2-37
2-28
TLV commands
SW-TLV-EN
2017-02-23
3.15 Set "Marking on the fly" parameters Temporarily sets the assigned parameters for "Marking on the fly" TAG
LENGTH
Request
VALUE "G1" + "G2" + "D1" + "D2" + "D3" + "D4" + "D5"
Number of bytes in the TLV Value
G1:
Start delay in 1/16 pulses
G2:
Simulation of the external start signal in 1/16 pulses
D1:
Scaling for the X encoder
D2:
Scaling for the Y encoder
D3:
Scaling for the rotation encoder
D4:
Displacement to the rotation center in X direction
D5:
Response
20234
Displacement to the rotation center in Y direction
Number of bytes in the TLV Value
Result of the TLV request:
0:
Æ Command executed correctly
1:
Æ Command could not be executed (see extended error code)
2:
Æ Erroneous TLV VALUE
3:
Æ Invalid TLV LENGTH of the request for the active communication interface
G2: 1:
The following conditions must be fulfilled: "Marking on the fly" must be activated. Explanations: Additional details concerning "Marking on the fly" can be obtained from the associated document. Limitation: The settings are only temporarily modified for the current session and will not be saved. Extended error code:
"G1" + "G2"
G1:
Remark
•
Is added on to the TLV Response when the result of the TLV Request is "1".
Extended error code: Æ "Marking on the fly" is
not activated > 1:
Æ Internal error Table 2-38
Example:Set the "Marking on the fly" parameters temporarily: 10 / -5 / 1.5 / 3.0 / 0.0 / 0.0 / 0.0 Request
Response
TAG 20234
LENGTH
VALUE
26
0A 4F 00 00
1A 00 00 00
20234
2
"10" + "-5" + "1.5" + "3.0" + "0.0" + "0.0" + "0.0" 31 30 00 2D 35 00 31 2E 35 00 33 2E 30 00 30 2E 30 00 30 2E 30 00 30 2E 30 00 "0"
0A 4F 00 00
02 00 00 00
30 00 Table 2-39
SW-TLV-EN
2017-02-23
TLV commands
2-29
3.16 Read RTC parameters Reads the current RTC parameters TAG Request
LENGTH
VALUE
0
Response
"G1" + "D1" + "G2" + "G3" + "G4" + "B1" + "G5" + "G6" + "G7" + "G8" G1:
20235
Result of the TLV request:
0:
Æ
Command executed correctly
1:
Æ
Command could not be executed (see extended error code)
3:
Æ
Invalid TLV LENGTH of the request for the active communication interface
D1:
Marking time in seconds
G2:
Number of commands of the active list
G3:
Number of markings executed through the "Restart_mark" digital interface input
G4:
Number of bytes in the TLV Value
Remark
No data
RTC card type
0:
Æ
No RTC cards are available
2:
Æ
RTC2 card
3:
Æ
RTC3 card
B2: Bit 15: : : Bit 2: Bit 1: Bit 0:
G5:
Bit 15 – 0 Options for the RTC card 1Æ 1Æ 1Æ 1Æ 1Æ 1Æ
Format of the decimal numbers: Are returned with 3 digits after the decimal point. Formatting of the options: LSB is on the right in the binary string. Extended error code: •
Is added on to the TLV Response when the result of the TLV Request is "1".
Reserved : : Reserved Multi-head "Marking on the fly"
Configuration of the "Restart_mark" digital input
0:
Æ
Deactivated
1:
Æ
Activated
G6:
Counter reading for the X encoder in case of the MOTF option
G7:
Counter reading for the Y encoder in case of the MOTF option
G8:
Extended error code:
> 0:
Limitation: The returned parameters "Number of commands of the active list" and "Number of markings executed through the "Restart_mark" digital input are only valid when the "Restart_mark" X230 input is activated.
Æ
Internal error Table 2-40
2-30
TLV commands
SW-TLV-EN
2017-02-23
Example: Reading RTC parameters: 0.567/248/79/RTC3 card / "Marking on the fly"/1/123/456 Request
Response
TAG
LENGTH
VALUE
20235
0
No data
0B 4F 00 00
00 00 00 00
20235
44
0B 4F 00 00
2C 00 00 00
"0" + "0.567" + "248" + "79" + "3" + "0000000000000001" + "1" + "123" + "456" 30 00 30 2E 35 36 37 00 32 34 38 00 37 39 00 33 00 30 30 30 30 30 30 30 30 30 30 30 30 30 30 30 31 00 31 00 31 32 33 00 34 35 36 00 Table 2-41
3.17 Segment info Reads general information of the loaded, segmented marking file TAG
LENGTH
Request
VALUE
0
No data
20241
SW-TLV-EN
2017-02-23
Remark The following conditions must be fulfilled: •
TLV commands
A segmented marking file must be loaded.
2-31
Reads general information of the loaded, segmented marking file Response
"G1" + "G2" + "G3" + "G4" + "G5" + "G6" + "D1" + "D2" + "G7" G1:
Æ
Command executed correctly
1:
Æ
Command could not be executed (see extended error code)
2:
Æ
Erroneous TLV VALUE
3:
Æ
Invalid TLV LENGTH of the request for the active communication interface
4:
Æ
Invalid TLV LENGTH of the response for the active communication interface
Segmentation mode:
0:
Æ No segmentation
1:
Æ X/Y segmentation
2:
Æ Cylinder segmentation
3:
Æ Free user-defined X/Y segmentation
4:
Number of bytes in the TLV Value
Result of the TLV request:
0:
G2:
Is returned with 3 digits after the decimal point. Extended error code: •
Is added on to the TLV Response when the result of the TLV Request is "1".
Æ 3D-Z axes segmentation
G3:
No. of segments in the X direction
G4:
No. of segments in the Y direction
G5:
No. of segments in the Z direction
G6:
Axis position at the time of cylinder segmentation
1:
Æ Parallel to the X axis with direction of rotation to the right
2:
Æ Parallel to the X axis with direction of rotation to the left
3:
Æ Parallel to the Y axis with direction of rotation to the right
4:
Æ Parallel to the Y axis with direction of rotation to the left
D1:
Increment angle at the time of cylinder segmentation
D2:
Length of the cylinder at the time of cylinder segmentation
G7:
Extended error code:
1:
Æ Segmentation not activated
2:
Æ No marking file is loaded
3:
Æ Segment info could not be read
> 3:
Format of the decimal numbers:
Æ Internal error
Table 2-42
Example: Reading general information for the loaded, segmented marking file -> X/Y-segmentation/8 segments in X direction/4 segments in Y direction
Request Response
TAG
LENGTH
VALUE
20241
0
No data
11 4F 00 00
00 00 00 00
20241
24
11 4F 00 00
18 00 00 00
"0" + "1" + "8" + "4" + "0" + "0" + "0.000" + "0.000" 30 00 31 00 38 00 34 00 30 00 30 00 30 2E 30 30 30 00 30 2E 30 30 30 00
Table 2-43
2-32
TLV commands
SW-TLV-EN
2017-02-23
3.18 Segment data Reads information concerning the segment assigned from the loaded, segmented marking file TAG Request
LENGTH Number of bytes in the TLV Value
VALUE
The following conditions must be fulfilled:
"G" G:
Segment number
Response "G1" + "D1" + "D2" + "D3" + "D4" + "D5" + "D6" + G2" G1:
20242 Number of bytes in the TLV Value
Remark
Result of the TLV request:
A segmented marking file must be loaded Format of the decimal numbers: •
Are returned with 3 digits after the decimal point.
0:
Æ Command executed correctly
1:
Æ Command could not be executed (see extended error code)
Extended error code:
2:
Æ Erroneous TLV VALUE
•
3:
Æ Invalid TLV LENGTH of the request for the active communication interface
4:
Æ Invalid TLV LENGTH of the response for the active communication interface
D1:
X offset of the segment
D2:
Y offset of the segment
D3:
Z offset of the segment
D4:
Segment width (X axes direction)
D5:
Segment height (Y axes direction)
D6:
Absolute angle for cylinder segmentation
G2:
Extended error code
1:
Æ Segmentation not activated
2:
Æ Segment data could not be read
3:
Æ No segmented file has been
Is added on to the TLV Response when the result of the TLV Request is "1".
loaded 4:
Æ Time overrun
5:
Æ Segment with the assigned number
contains no marking data > 5:
Æ Internal error Table 2-44
SW-TLV-EN
2017-02-23
TLV commands
2-33
Example: Reading information for Segment 5, the loaded, segmented marking file -> X offset=2.500/Y offset=-3.125/Z offset=1.000/Segment width = 1.500/Segment height 0 5.725/Angle = 0.000" TAG Request Response
LENGTH
VALUE
20242
2
"5"
12 4F 00 00
02 00 00 00
35 00
20242
40
"0" + "2.500" + "-3.125" + "-1000" + "1.500" + "5.752" + "0.000"
28 00 00 00
30 00 32 2E 35 30 30 00 2D 33 2E 31 32 35 00 2D 31 2E 30 30 30 00 31 2E 35 30 30 00 35 2E 37 32 35 00 30 2E 30 30 30 00
12 4F 00 00
Table 2-45
3.19 Mark Segment Marks the assigned segment of the loaded, segmented marking file
TAG
LENGTH
VALUE
Request "G1" + "G2"
Number of bytes in the 20243 TLV Value
2-34
G1:
Segment number
G2:
Axis mode
0:
Æ Axes are not moved
1:
Æ Axes are moved from the station.
TLV commands
Remark The following conditions must be fulfilled: A segmented marking file must be loaded The beam source or the pilot laser must be switched on The marking file must be converted manually prior to marking with the TLV commands "Convert marking file"/"Trigger conversion". .
SW-TLV-EN
2017-02-23
Marks the assigned segment of the loaded, segmented marking file
Response
Extended error code:
"G1" + "G2" G1:
Æ Command executed correctly
1:
Æ Command could not be executed (-> See extended error code)
2:
Æ Erroneous TLV VALUE
3:
Æ Invalid TLV LENGTH of the request for the active communication interface
G2:
Number of bytes in the TLV Value
Result of the TLV request:
0:
•
Extended error code:
1:
Æ No segmented marking file has been loaded
2:
Æ Marking procedure is already activated
3:
Æ No converted marking file is available
4:
Æ No marking file is loaded
5:
Æ Lasers or pilot lasers are switched off
6:
Æ Marking and/or conversion procedure by Trigger command already activated
7:
Æ Segmentation not activated
10:
Æ General conversion errors
11:
Æ No conversion, empty variable?
12:
Æ Laser font not available
13:
Æ Variable from text file: all data processed
14:
Æ Serial number: end value reached
15:
Æ Execution in case of activated "Restart mark" is not allowed
> 15:
Is added on to the TLV Response when the result of the TLV request is "1".
Æ Internal error
Table 2-46
Example: Marking Segment 5 of the loaded marking file/axes are not moved TAG Request Response
LENGTH
VALUE
20243
4
"5" + "0"
13 4F 00 00
04 00 00 00
35 00 30 00
20243
2
"0"
13 4F 00 00
02 00 00 00
30 00
Table 2-47
SW-TLV-EN
2017-02-23
TLV commands
2-35
3.20 Creating the matrix and binning file for matrix segmentation Creates a segment and binning matrix for the matrix segmentation from the offset/binning file of the customer.
TAG
LENGTH
VALUE
Request
"G1" + "G2"
Number of bytes in the 20244 TLV Value
G1:
Name of the original matrix file
G2:
Name of the offset and binning file of the customer.
Remark Is only supported from TruMark on. The following conditions must be fulfilled: A matrix segmentation file must be loaded. The offset/binning file must comply with the corresponding format. The marking file must be converted manually prior to marking with the TLV commands "Convert marking file"/"Trigger conversion". .
2-36
TLV commands
SW-TLV-EN
2017-02-23
Creates a segment and binning matrix for the matrix segmentation from the offset/binning file of the customer.
Response
"G1" + "G2" G1:
Æ Command executed correctly
1:
Æ Command could not be executed (-> See extended error code)
2:
Æ Erroneous TLV VALUE
3:
Æ Invalid TLV LENGTH of the request for the active communication interface
G2:
Number of bytes in the TLV Value
Result of the TLV request:
0:
Is only supported from TruMark on. Extended error code: Is added on to the TLV Response when the result of the TLV request is "1".
Extended error code:
2:
Æ No marking file has been loaded
3:
Æ No conversion data is available.
4:
Æ Header information of the XML files could not be read.
5:
Æ Original matrix file is not available.
6:
Æ Error while reading the original matrix.
7:
Æ Used matrix file is not available.
8:
Æ Error while reading the used matrix file.
9:
Æ Offset and binning file not available.
10:
Æ Error while reading the offset and binning file.
11:
Æ Matrix file could not be written.
12:
Æ Binning file could not be written.
13:
Æ Used and original matrix are identical.
14:
Æ No matrix position to be marked. Table 2-48
SW-TLV-EN
2017-02-23
TLV commands
2-37
Example: Create a new matrix and binning file for the matrix segmentation. Request
Response
TAG
LENGTH
VALUE
20244
55
"c:\TruMark\xml\matrix.xml" + "c:\TruMark\xml\OffsetBin.xml"
14 4F 00 00
37 00 00 00
63 3A 5C 54 72 75 4D 61 72 6B 5C 78 6D 6C 5C 6D 61 74 72 69 78 2E 78 6D 6C 00 63 3A 5C 54 72 75 4D 61 72 6B 5C 78 6D 6C 5C 4F 66 66 73 65 74 42 69 6E 2E 78 6D 6C 00
20244
2
"0"
14 4F 00 00
02 00 00 00
30 00
Table 2-49
3.21 Creation of a new matrix file for the matrix segmentation Creates a matrix file for the matrix segmentation.
TAG
LENGTH
VALUE
Request
Number of bytes in the 20245 TLV Value
2-38
"G1" + "G2" G1:
Name of the matrix info file
G2:
Name of the matrix file
TLV commands
Remark Is only supported from TruMark on. The following conditions must be fulfilled: A matrix info file must be available with the specific information for the matrix. The format of the XML file must be complied with.
SW-TLV-EN
2017-02-23
Creates a matrix file for the matrix segmentation.
Response
"G1" + "G2" G1:
Result of the TLV request:
0:
Æ Command executed correctly
1:
Æ Command could not be executed (-> See extended error code)
2:
Æ Erroneous TLV VALUE
3:
Æ Invalid TLV LENGTH of the request for the active communication interface
G2:
Is only supported from TruMark on. Extended error code: Is added on to the TLV Response when the result of the TLV request is "1".
Extended error code:
1:
Æ Image field height or – width could not be read
2:
Æ Starting position from Head A could not be read Æ Starting position from Head B could not be read . Æ Registry could not be read. Æ Storage location could not be allocated . Æ Error when reading in the MatrixInfo file Æ Number of columns or rows not defined Æ Size of the step in x or y direction not defined Æ Error in allocating memory when creating the strip Æ Number of rows and columns are not defined Æ X-Position is outside the marking range of Head A Æ y position is outside of the marking range of Head A Æ X-Position is outside the marking range of Head B Æ y position is outside of the marking range of Head B Æ X-Position is outside of the marking range of Head A Æ y position is outside of the marking range of Head A
.
3:
4: 5:
Number of bytes in the TLV Value
10: 21: 22: 23: 31: 40: 41: 42: 43: 50. 51:
Table 2-50
SW-TLV-EN
2017-02-23
TLV commands
2-39
Example: Creation of a new matrix file for the matrix segmentation. TAG
LENGTH
VALUE
20245
84
"c:\TruMark\xml\MatrixInfoFile_single_head.xml" + "c:\TruMark\xml\matrix_single_head.xml"
15 4F 00 00
54 00 00 00
63 3A 5C 54 72 75 4D 61 72 6B 5C 78 6D 6C 5C 4D 61 74 72 69 78 49 6E 66 6F 46 69 6C 65 5F 73 69 6E 67 6C 65 5F 68 65 61 64 2E 78 6D 6C 00 63 3A 5C 54 72 75 4D 61 72 6B 5C 78 6D 6C 5C 6D 61 74 72 69 78 5F 73 69 6E 67 6C 65 5F 68 65 61 64 2E 78 6D 6C 00
20245
2
"0"
15 4F 00 00
02 00 00 00
30 00
Request
Response Example MatrixInfo file
Meaning of the parameter
Designation of the file
Binning
Name and path of the binning file for the matrix segmentation
Vlf
Name of the Vlf file
0:
Æ
Invalid TLV LENGTH of the response for the active communication interface
LSB is on the right in each case in the binary string Extended error code: •
Is added on to the TLV Response when the result of the TLV request is "1".
Bit 7- 0 Laser has a malfunction Warning laser has responded 0Æ Laser stable (diode current in the band) 1Æ Beam expander in position 1Æ Shutter is open 1Æ Safety circuit is closed 1Æ Laser is ready 1Æ Beam source is on Bit 15 – 8 1Æ Control is on 1Æ Heating period laser is on 1Æ EMERGENCY SHUTDOWN circuit is closed 1Æ Key switch laser is closed. 1Æ Switch of control manually activated 1Æ Q-Switch trigger is on 1Æ Laser warning lamp is on 1Æ Pilot laser is on 1Æ 1Æ
Extended error code Æ
Internal error Table 2-52
Example: Laser status query Request Response
TAG
LENGTH
VALUE
20261
0
No data
25 4F 00 00
00 00 00 00
20261
20
"0" + "00001111" + "00011000"
25 4F 00 00
14 00 00 00
30 00 30 30 30 30 31 31 31 31 00 30 30 30 31 31 30 30 30 00
Table 2-53
SW-TLV-EN
2017-02-23
TLV commands
2-41
3.23 Last error Reads the error number, the short error text, the date and the time of day of the last error to occur at the laser
TAG
LENGTH
VALUE
0
No data
Request
Remark Formatting of the error number:
Response "G1" + "T1" + "T2" + "T3" + "T4" + "G2"
G1:
20262
Number of bytes in the TLV Value
Result of the TLV request:
0:
Æ
Command executed correctly
1:
Æ
Command could not be executed (see extended error code)
3:
Æ
Invalid TLV LENGTH of the request for the active communication interface
4:
Æ
Invalid TLV LENGTH of the response for the active communication interface
T1:
Error number
T2:
Short error text
T3:
Error date
T4:
Error time
G2:
Extended error code:
> 0:
Æ
"XXYYZZZZ" (e.g. "53011234") with: XX = Error identification as HEX number YY = Error number as HEX number ZZZZ = Error code as HEX number Extended error code: •
Is added on to the TLV Response when the result of the TLV Request is "1".
Internal error
Table 2-54
Example: Read the last error TAG Request Response
LENGTH
VALUE No data
20262
0
26 4F 00 00
0000 00 00
20262
46
"0" + "53011234" + "Short error text" + "01.01.2001" + "19:30:00" 30 00 35 33 30 31 31 32 33 34 00 46 65 68 6C 65 72 6B 75 72 7A 74
26 4F 00 00
2E 00 00 00
65 78 74 00 30 312E 30 31 2E 32 30 30 31 00 31 39 3A 33 30 3A 30 30 00 Table 2-55
2-42
TLV commands
SW-TLV-EN
2017-02-23
3.24 Short error/warning text Reads the short text for the assigned error/warning number
TAG
LENGTH
VALUE
Remark Formatting of the error/warning number:
Request "T1"
T:
Error/warning number
"XXYYZZZZ" (e.g. "53011234") with:
Number of bytes in the TLV Value
XX = Error identification as HEX number YY = Error number as HEX number ZZZZ = Error/warning code as HEX number Extended error code:
Response "G1" + "T" + "G2"
20263
G1:
Number of bytes in the TLV Value
Result of the TLV request:
0:
Æ
Command executed correctly
1:
Æ
Command could not be executed (see extended error code)
3:
Æ
Invalid TLV LENGTH of the request for the active communication interface
4:
Æ
Invalid TLV LENGTH of the response for the active communication interface
T: G2: > 0:
•
Is added on to the TLV Response when the result of the TLV Request is "1".
Short error text Extended error code: Æ
Internal error Table 2-56
Example: Reads the short text for the assigned error/warning number "53011234" TAG Request
Response
LENGTH
VALUE
"53011234"
20263
9
27 4F 00 00
09 00 00 00
35 33 30 31 31 32 33 34 00
20263
37
"0" + "Short text for error number 53011234"
27 4F 00 00
25 00 00 00
30 00 4B 75 72 7A 74 65 78 74 20 7A 75 72 20 46 65 68 6C 65 72 6E 75 6D 6D 65 7220 35 33 30 31 31 32 33 34 00 Table 2-57
SW-TLV-EN
2017-02-23
TLV commands
2-43
3.25 Last warning Reads the warning number, the short warning text, the date and the time of day of the last warning to appear at the laser
TAG
LENGTH
Request
VALUE No data
0
Remark
Formatting of the warning number:
Response "G1" + "T1" + "T2" + "T3" + "T4" + "G2"
G1:
20264
Number of bytes in the TLV Value
Result of the TLV request:
0:
Æ
Command executed correctly
1:
Æ
Command could not be executed (see extended error code)
3:
Æ
Invalid TLV LENGTH of the request for the active communication interface
4:
Æ
Invalid TLV LENGTH of the response for the active communication interface
T1:
Warning number
T2:
Short warning text
T3:
Warning date
T4:
Warning time
G2:
Extended error code:
> 0:
Æ
"XXYYZZZZ" (e.g. "53011234") with: XX = Error identification as HEX number YY = Error number as HEX number ZZZZ = Warning code as HEX number Extended error code: •
Is added on to the TLV Response when the result of the TLV request is "1".
Internal error Table 2-58
Example: Reads the last warning Request Response
TAG
LENGTH
VALUE
20264
0
No data
28 4F 00 00
00 00 00 00
20264
48
"0" + "53011234" + "Short warning text" + "01.01.2001" + "19:30:00"
28 4F 00 00
30 00 00 00
30 00 35 33 30 31 31 32 33 34 00 57 61 72 6E 75 72 67 73 6B 75 72 7A 74 65 78 74 0030 31 2E 30 31 2E 32 30 30 31 00 31 39 3A 33 30 3A 30 30 00 Table 2-59
2-44
TLV commands
SW-TLV-EN
2017-02-23
3.26 Laser Activates/deactivates the laser
TAG
LENGTH
Request
VALUE
Remark
2 "G"
G:
Status of the laser:
0:
Æ
Laser off
1:
Æ
Laser on
Extended error code:
Response "G1" + "G2"
G1: 20281
Number of bytes in the TLV Value
•
Result of the TLV request:
0:
Æ
Command executed correctly
1:
Æ
Command could not be executed (see extended error code)
2:
Æ
Erroneous TLV VALUE
3:
Æ
Invalid TLV LENGTH of the request for the active communication interface
G2: > 0:
Is added on to the TLV Response when the result of the TLV request is "1".
Extended error code: Æ
Internal error Table 2-60
Example: Activate the laser TAG Request Response
LENGTH
VALUE
20281
2
"1"
39 4F 00 00
02 00 00 00
31 00
20281
2
"0"
39 4F 00 00
02 00 00 00
30 00 Table 2-61
SW-TLV-EN
2017-02-23
TLV commands
2-45
3.27 Q-switch Activates the Q-switch for operation as an OEM beam source without an RTC card
TAG
LENGTH
Request
VALUE
Remark If no RTC card is present in the system (TM6000 beam source without PC), use this command. Otherwise use command 20284.
2 "G"
G:
Response
Status of the Q-switch:
0:
Æ
Q-switch off
1:
Æ
Q-switch on
At this command, the Qswitch is activated via the control blank CIP/CMU. The desired laser parameters (frequency, pulse amplitude, power specification) must be preset via the TAGs 20285, 20286 and 20287
20282
Extended error code: "G1" + "G2"
G1: Number of bytes in the TLV Value
•
Result of the TLV request:
0:
Æ
Command executed correctly
1:
Æ
Command could not be executed (see extended error code)
2:
Æ
Erroneous TLV VALUE
3:
Æ
Invalid TLV LENGTH of the request for the active communication interface
G2: > 0:
Is added on to the TLV Response when the result of the TLV request is "1".
Extended error code: Æ
Internal error Table 2-62
Example: Switch on Q-switch Request Response
TAG
LENGTH
VALUE
20282
2
"1"
3A 4F 00 00
02 00 00 00
31 00
20282
2
"0"
3A 4F 00 00
02 00 00 00
30 00 Table 2-63
2-46
TLV commands
SW-TLV-EN
2017-02-23
3.28 Initialization of beam monitoring by the scanner Preparation of a list of commands for the activation/deactivation of the beam source through the scanner with the assigned laser power and frequency for operation as the OEM beam source
TAG
LENGTH
VALUE
Request "G1" + "G2" + "D1" + "D2" + "G3"
Number of bytes in the TLV Value
G1:
Laser power in %
G2:
Frequency in Hz
D1:
X-Position in the current marking field in mm
D2:
Y position in the current marking field in mm
G3:
Pulse length of the Q-switch signal in us
Remark Activation of the beam source through: TLV command "Scanner beam control" or Restart_mark input of the digital interface Deactivation of the beam source through: TLV command "Scanner beam control" or Abort_mark input of the digital interface The following conditions must be fulfilled: No marking procedure is allowed to be active and the beam source (20284) must not be active.
20283
When an RTC2 card is used, "Variable polygon delay" must be deactivated. Extended error code:
Response "G1" + "G2"
G1: Number of bytes in the TLV Value
Result of the TLV request:
0:
Æ
Command executed correctly
1:
Æ
Command could not be executed (see extended error code)
2:
Æ
Erroneous TLV VALUE
3:
Æ
Invalid TLV LENGTH of the request for the active communication interface
G2: > 0:
•
Is added on to the TLV Response when the result of the TLV Request is "1".
Extended error code: Æ
Internal error Table 2-64
SW-TLV-EN
2017-02-23
TLV commands
2-47
Example: Preparing the list of commands: -> Laser power = 85%/-> Frequency = 10 kHz -> X value = 25.125 mm/-> Y value = 60.00 mm -> Pulse width of the Q-switch signal = 5 us Request
TAG
LENGTH
20283
24
"85" + "10000" + "25.125" + "60.00" + "5"
18 00 00 00
38 35 00 31 30 30 30 30 00 32 35 2E 31 32 35 00 36 30 2E 30 30 00 35 00
20283
2
"0"
3B 4F 00 00
02 00 00 00
30 00
3B 4F 00 00 Response
VALUE
Table 2-65
2-48
TLV commands
SW-TLV-EN
2017-02-23
3.29 Scanner beam monitoring Activates/deactivates the beam source with the adjusted laser power and frequency by means of the scanner in operation as the OEM beam source
TAG
LENGTH
Request
VALUE
Remark The following conditions must be fulfilled:
Status of the beam source:
The list of commands of the scanner must be have been initialized in advance by means of the TLV Command "Initialization of beam monitoring by the scanner"
2 "G"
G: 0:
Æ
Beam source off
1:
Æ
Beam source on
The "Laser is ready" laser status signal must be active When an RTC2 card is used, "Variables Polygon Delay" must be deactivated. 20284
As OEM beam source the "Mark active" output is not controlled in the laser status. Extended error code:
Response "G1" + "G2"
G1: Number of bytes in the TLV Value
•
Result of the TLV request:
0:
Æ
Command executed correctly
1:
Æ
Command could not be executed (see extended error code)
2:
Æ
Erroneous TLV VALUE
3:
Æ
Invalid TLV LENGTH of the request for the active communication interface
G2: > 0:
Is added on to the TLV Response when the result of the TLV request is "1".
Extended error code: Æ
Internal error Table 2-66
Example: Switch on the beam source TAG Request Response
LENGTH
VALUE
20284
2
"1"
3C 4F 00 00
02 00 00 00
31 00
20284
2
"0"
3C 4F 00 00
02 00 00 00
30 00 Table 2-67
SW-TLV-EN
2017-02-23
TLV commands
2-49
3.30 Laser power Sets the laser power for operation as an OEM beam source
TAG Request
LENGTH Number of bytes in the TLV Value
VALUE
Remark
"G"
G:
Power in % Extended error code:
Response "G1" + "G2"
G1: 20285
Number of bytes in the TLV Value
•
Result of the TLV request:
0:
Æ
Command executed correctly
1:
Æ
Command could not be executed (see extended error code)
2:
Æ
Erroneous TLV VALUE
3:
Æ
Invalid TLV LENGTH of the request for the active communication interface
G2: > 0:
Is added on to the TLV Response when the result of the TLV request is "1".
Extended error code: Æ
Internal error Table 2-68
Example: Set laser power to 90% Request Response
TAG
LENGTH
20285
3
VALUE
"90"
3D 4F 00 00
03 00 00 00
39 30 00
20285
2
"0"
3D 4F 00 00
02 00 00 00
30 00 Table 2-69
2-50
TLV commands
SW-TLV-EN
2017-02-23
3.31 Frequency Sets the laser frequency for operation as an OEM beam source
TAG Request
LENGTH Number of bytes in the TLV Value
VALUE
Remark
"G"
G:
Frequency in Hz Extended error code:
Response "G1" + "G2"
G1: 20286
Number of bytes in the TLV Value
•
Result of the TLV request:
0:
Æ
Command executed correctly
1:
Æ
Command could not be executed (see extended error code)
2:
Æ
Erroneous TLV VALUE
3:
Æ
Invalid TLV LENGTH of the request for the active communication interface
G2: > 0:
Is added on to the TLV Response when the result of the TLV request is "1".
Extended error code: Æ
Internal error Table 2-70
Example: Set frequency to 60,000 Hz Request Response
TAG
LENGTH
VALUE
20286
6
"60000"
3E 4F 00 00
06 00 00 00
36 30 30 30 30 00
20286
2
"0"
3E 4F 00 00
02 00 00 00
30 00 Table 2-71
SW-TLV-EN
2017-02-23
TLV commands
2-51
3.32 Defocusing Sets the defocusing for operation as an OEM beam source
TAG Request
LENGTH
VALUE
Number of bytes in the TLV Value
Remark
"D"
D:
Defocusing in mm Extended error code:
Response "G1" + "G2"
G1: 20287
Number of bytes in the TLV Value
•
Result of the TLV request:
0:
Æ
Command executed correctly
1:
Æ
Command could not be executed (see extended error code)
2:
Æ
Erroneous TLV VALUE
3:
Æ
Invalid TLV LENGTH of the request for the active communication interface
G2: > 0:
Is added on to the TLV Response when the result of the TLV request is "1".
Extended error code: Æ
Internal error Table 2-72
Example: Set the defocusing to –3 mm Request
TAG
LENGTH
VALUE
20287
3
"-3"
03 00 00 00
2D 33 00
2
"0"
02 00 00 00
32 00
3F 4F 00 00 Response
20287 3F 4F 00 00
Table 2-73
2-52
TLV commands
SW-TLV-EN
2017-02-23
3.33 Set laser parameters offsets Sets the general laser parameter offsets of power, frequency, marking speed, defocus and pulse amplitude
TAG Request
LENGTH Number of bytes in the TLV Value
VALUE
Remark
"D1" + "D2" + "D3"+ "D4" + "D5"
D1:
Offset power in %
D2:
Offset frequency in Hz
D3:
Offset speed in mm/s
D4:
Offset defocus in mm
D5:
Offset pulse amplitude in μs Extended error code:
Response "G1" + "G2"
G1: 0:
Æ
Command executed correctly
1:
Æ
Command could not be executed (see extended error code)
2:
Æ
Erroneous TLV VALUE
3:
Æ
Invalid TLV LENGTH of the request for the active communication interface
G2: 20288 Number of bytes in the TLV Value
Result of the TLV request:
•
Is added to the TLV Response when the result of the TLV request is "1".
Extended error code:
1:
Æ
Lower limit for offset power too low
2:
Æ
Upper limit for offset power too high
3:
Æ
Lower limit for offset frequency too low
4:
Æ
Upper limit for offset frequency too high
5:
Æ
Lower limit for the offset speed is too low
6:
Æ
Upper limit for the offset speed is too high
7:
Æ
Lower limit for offset Defocus too small
8:
Æ
Upper limit for offset Defocus too large
9:
Æ
10:
Æ
Lower limit for offset Pulse amplitude too small Upper limit for offset Pulse amplitude too large Table 2-74
SW-TLV-EN
2017-02-23
TLV commands
2-53
Example: Set the laser parameter offset to -10% power, +5000 Hz frequency, +5 mm/s speed, +3 mm defocus and +2 μs pulse amplitude TAG Request
LENGTH
20288 40 4F 00 00
Response
15
"-10" + "5000" + "5" + "3" + "2"
0F 00 00 00
2D 31 30 00 35 30 30 30 00 35 00 33 00 32 00
2
"0"
02 00 00 00
30 00
20288 40 4F 00 00
VALUE
Table 2-75
3.34 Switching on or switching off "Marking on the fly" Switches on or switches off Marking on the fly.
TAG
LENGTH
Request
VALUE
Remark
2 "G"
G:
Status "Marking on the fly":
0:
Æ
"Marking on the fly" not activated
1:
Æ
"Marking on the fly" activated
Extended error code:
Response "G1" + "G2"
G1: 20289 Number of bytes in the TLV Value
•
Result of the TLV request:
0:
Æ
Command executed correctly
1:
Æ
Command could not be executed (see extended error code)
2:
Æ
Erroneous TLV VALUE
3:
Æ
Invalid TLV LENGTH of the request for the active communication interface
G2: > 0:
Is added on to the TLV Response when the result of the TLV request is "1".
Extended error code: Æ
"Marking on the fly" option not activated. Table 2-76
Example: Switching on "Marking on the fly"
Request
TAG
LENGTH
VALUE
20289
2
"1"
02 00 00 00
31 00
2
"0"
02 00 00 00
30 00
41 4F 00 00 Response
20289 41 4F 00 00
Table 2-77
2-54
TLV commands
SW-TLV-EN
2017-02-23
3.35 Switching on or switching off the retrigger mode Switches on or switches off the retrigger mode.
TAG
LENGTH
Request
VALUE
Remark
2 "G"
G:
Status "Marking on the fly":
0:
Æ
Retrigger mode switched off
1:
Æ
Retrigger mode switched on
In the retrigger mode, the "Mark active" output is not controlled in the laser status. Extended error code:
Response "G1" + "G2"
G1:
20290 Number of bytes in the TLV Value
•
Result of the TLV request:
0:
Æ
Command executed correctly
1:
Æ
Command could not be executed (see extended error code)
2:
Æ
Erroneous TLV VALUE
3:
Æ
Invalid TLV LENGTH of the request for the active communication interface
G2: > 0:
Is added on to the TLV Response when the result of the TLV request is "1".
Extended error code: Æ
Internal error Table 2-78
Example: Switching on the retrigger mode TAG Request
20290 42 4F 00 00
Response
20290 42 4F 00 00
LENGTH
VALUE
2
"1"
02 00 00 00
31 00
2
"0"
02 00 00 00
30 00 Table 2-79
SW-TLV-EN
2017-02-23
TLV commands
2-55
4.
TLV commands for Mechanics SW module
4.1
Reference all axes
References all axes
TAG
LENGTH
VALUE
Remark
Request "G"
G: 2
Referencing mode:
0:
Æ
Start referencing without waiting for the end
1:
Æ
Start referencing and wait for the end
Extended error code:
Response "G1" + "G2"
G1:
20101 Number of bytes in the TLV Value
•
Result of the TLV request:
0:
Æ
Command executed correctly
1:
Æ
Command could not be executed (see extended error code)
2:
Æ
Erroneous TLV VALUE
3:
Æ
Invalid TLV LENGTH of the request for the active communication interface
G2:
Is added on to the TLV Response when the result of the TLV request is "1".
Extended error code:
= -1:
Æ
Command not completed
> =1:
Æ
Internal error
Note: If G1:1 and G2:1, then the procedure is not yet completed and the Command must be repeated until G1:0 Table 2-80
Example: Referencing all axes (with waiting for the end of the referencing) Request
TAG
LENGTH
VALUE
20101
2
"1"
02 00 00 00
31 00
2
"0"
85 4E 00
00 Response
20101 85 4E 00
00
30 00
02 00 00 00
Table 2-81
2-56
TLV commands
SW-TLV-EN
2017-02-23
4.2
Reference axis
References the assigned axis
TAG
LENGTH
VALUE
Remark
Request "G1" + "G2"
G1:
4
Number of the axes to be referenced:
1:
Æ
Z axis
2:
Æ
X axis
3:
Æ
A axis
4:
Æ
Y axis
5:
Æ
C axis
7:
Æ
D axis
G2:
Referencing mode:
0:
Æ
Start referencing without waiting for the end
1:
Æ
Start referencing and wait for the end
Extended error code:
Response 20102
"G1" + "G2"
G1:
Number of bytes in the TLV Value
•
Result of the TLV request:
0:
Æ
Command executed correctly
1:
Æ
Command could not be executed (see extended error code)
2:
Æ
Erroneous TLV VALUE
3:
Æ
Invalid TLV LENGTH of the request for the active communication interface
G2:
Is added on to the TLV Response when the result of the TLV request is "1".
Extended error code:
= -1:
Æ
Command not completed
> =1:
Æ
Internal error
Note: If G1:1 and G2:1, then the procedure is not yet completed and the Command must be repeated until G1:0 Table 2-82
Example: Referencing the X axis (with waiting for the end of the referencing) Request
Response
TAG
LENGTH
VALUE
20102
4
"2" + "1"
86 4E 00 00
04 00 00 00
32 00 31 00
20102
2
"0"
86 4E 00 00
02 00 00 00
30 00 Table 2-83
SW-TLV-EN
2017-02-23
TLV commands
2-57
4.3
Reference two axes
References the assigned axis
TAG
LENGTH
VALUE
Remark
Referencing is always carried out without waiting.
Request "G1" + "G2"
G1:
4
Number of the axes to be referenced:
1:
Æ
Z axis
3:
Æ
A axis
4:
Æ
Y axis
8:
Æ
S axis
G2:
This command is available for: ⎯ TMS7000/VWS1200 ⎯ TMS5000 NEW.
Number of the axes to be referenced:
2:
Æ
X axis
5:
Æ
C axis
6:
Æ
T axis Extended error code:
Response "G1" + "G2"
20105
G1:
Number of bytes in the TLV Value
•
Result of the TLV request:
0:
Æ
Command executed correctly
1:
Æ
Command could not be executed (see extended error code)
2:
Æ
Erroneous TLV VALUE
3:
Æ
Invalid TLV LENGTH of the request for the active communication interface
G2:
Is added on to the TLV Response when the result of the TLV request is "1".
Extended error code:
= -1:
Æ
Command not completed
> =1:
Æ
Internal error
Note: If G1:1 and G2:1, then the procedure is not yet completed and the Command must be repeated until G1:0 Table 2-84
Example: Referencing the X axis and the Y axis TAG Request
Response
LENGTH
VALUE
20105
4
"2" + "4"
89 4E 00 00
04 00 00 00
32 00 34 00
20105
2
"0"
89 4E 00 00
02 00 00 00
30 00 Table 2-85
2-58
TLV commands
SW-TLV-EN
2017-02-23
4.4
Move axis
Moves the assigned axis
TAG
LENGTH
VALUE
Remark
Request "G1" + "D" + "G2"
G1:
Number of bytes in the TLV Value
20103
Number of the axes to be moved:
1:
Æ
Z axis
2:
Æ
X axis
3:
Æ
A axis
4:
Æ
Y axis
5:
Æ
C axis
6:
Æ
T axis
7:
Æ
D axis
8:
Æ
S axis
1
D:
New absolute position of the axis in mm
G2:
Number of the axes to be moved:
0:
Æ
Start movement without waiting for the end
1:
Æ
Start movement and wait for the end
1
: For rotation door Use command 20123
Extended error code:
Response "G1" + "G2"
G1:
Number of bytes in the TLV Value
Result of the TLV request:
0:
Æ
Command executed correctly
1:
Æ
Command could not be executed (see extended error code)
2:
Æ
Erroneous TLV VALUE
3:
Æ
Invalid TLV LENGTH of the request for the active communication interface
G2:
•
Is added on to the TLV Response when the result of the TLV request is "1".
Extended error code:
= -1:
Æ
Command not completed
> =1:
Æ
Internal error
Note: If G1:1 and G2:1, then the procedure is not yet completed and the Command must be repeated until G1:0 Table 2-86
SW-TLV-EN
2017-02-23
TLV commands
2-59
Example: Moving Z axis to absolute position 72.25 (waiting for the end of the move) Request
Response
TAG
LENGTH
VALUE
20103
10
"1" + "72.25" + "1"
87 4E 00 00
0A 00 00 00
31 00 37 32 2E 32 35 00 31 00
20103
2
"0"
87 4E 00 00
02 00 00 00
30 00 Table 2-87
2-60
TLV commands
SW-TLV-EN
2017-02-23
4.5
Move two axes
Moves the assigned axis
TAG
LENGTH
VALUE
Remark
Request "G1" + "D1" + "G2" + "D2"
G1:
Number of bytes in the TLV Value
Number of the axes to be moved:
1:
Æ
Z axis
3:
Æ
A axis
4:
Æ
Y axis
8:
Æ
S axis
This command is available for: ⎯ TMS7000/VWS1200 ⎯ TMS5000 NEU
D1:
New absolute position of the axis in mm
G2:
Number of the axes to be moved: Æ
X axis
5:
Æ
C axis
6:
Æ
T axis
2: 1
D2:
New absolute position of the axis in mm
20106 Response
Number of bytes in the TLV Value
1
: For rotation door Use command 20123 .
•
Result of the TLV request:
0:
Æ
Command executed correctly
1:
Æ
Command could not be executed (see extended error code)
2:
Æ
Erroneous TLV VALUE
3:
Æ
Invalid TLV LENGTH of the request for the active communication interface
G2:
Important note: The numbers of the assigned axes for G1 and G2 must correspond with the numbers in the left table.
Extended error code:
"G1" + "G2"
G1:
Movement of the axes is always carried out without waiting.
Is added on to the TLV Response when the result of the TLV request is "1".
Extended error code:
= -1:
Æ
Command not completed
> =1:
Æ
Internal error
Note: If G1:1 and G2:1, then the procedure is not yet completed and the Command must be repeated until G1:0 Table 2-88
Example: Move Z axis to absolute position 72.25 and Y axis to absolute position 12.30 Request
Response
TAG
LENGTH
VALUE
20106
16
"1" + "72.25" + "4" + "12.30"
8A 4E 00 00
10 00 00 00
31 00 37 32 2E 32 35 00 34 00 31 32 2E 33 30 00
20106
2
"0"
8A 4E 00 00
02 00 00 00
30 00 Table 2-89
SW-TLV-EN
2017-02-23
TLV commands
2-61
4.6
Axis position
Reads the absolute position of the assigned axis
TAG
LENGTH
VALUE
Remark
Request "G"
G:
2
Æ
Z axis
2:
Æ
X axis
3:
Æ
A axis
4:
Æ
Y axis
5:
Æ
C axis
6:
Æ
T axis
7:
Æ
D axis
8:
Æ
S axis
1
Response
Number of the axes to be read:
1:
1
: For rotation door Use command 20124
Extended error code: 20104
"G1" + "D" + "G2"
G1:
Number of bytes in the TLV Value
Result of the TLV request:
0:
Æ
Command executed correctly
1:
Æ
Command could not be executed (see extended error code)
2:
Æ
Erroneous TLV VALUE
3:
Æ
Invalid TLV LENGTH of the request for the active communication interface
D: G2: > 0:
Is added on to the TLV Response when the result of the TLV Request is "1".
Absolute position of the axis in mm Extended error code: Æ
Internal error Table 2-90
Example: Read absolute position of the Y axis (stands at 12.34 mm) Request
Response
TAG
LENGTH
VALUE
20104
2
"4"
88 4E 00 00
02 00 00 00
34 00
20104
8
"0" + "12.34"
88 4E 00 00
08 00 00 00
30 00 31 32 2E 33 34 00 Table 2-91
2-62
TLV commands
SW-TLV-EN
2017-02-23
4.7
Recognize focal position
Defines the position starting with which the focus is to be found
TAG
LENGTH
VALUE
Remark
Request "D" + "G"
Number of bytes in the TLV Value
D:
Defining the position for the search
G:
Waiting for the command to be executed
0:
Æ
Do not wait
1:
Æ
Wait Extended error code:
Response "G1" + "G2"
G1:
20107
Number of bytes in the TLV Value
•
Result of the TLV request:
0:
Æ
Command executed correctly
1:
Æ
Command could not be executed (see extended error code)
2:
Æ
Erroneous TLV VALUE
3:
Æ
Invalid TLV LENGTH of the request for the active communication interface
G2:
Is added on to the TLV Response when the result of the TLV request is "1".
Extended error code:
= -1:
Æ
Command not completed
> =1:
Æ
Internal error Table 2-92
Example: Moves focal point into position (stands at 12.3 mm) TAG Request
Response
LENGTH
VALUE
20107
7
"12.3" + "1"
8B 4E 00 00
07 00 00 00
31 32 2E 33 00 31 00
20107
2
"0"
8B 4E 00 00
02 00 00 00
30 00 Table 2-93
SW-TLV-EN
2017-02-23
TLV commands
2-63
4.8
Set segment offset for axes
Sets the axes offsets for the A/X/Y/Z axes
TAG
LENGTH
VALUE
Remark
Request
The A offset is applied to the cylinder.
"D1" + "D2" + "D3" + "D4"
Number of bytes in the TLV Value
D1:
Offset A axis
D2:
Offset X axis
D3:
Offset Y axis
D4:
Offset Z axis
The X offset and Y offset are applied to the x/y free rectangle. The Z offset is applied only on 3D segmented files. Extended error code:
Response "G1" + "G2"
20108
G1: Number of bytes in the TLV Value
•
Result of the TLV request:
0:
Æ
Command executed correctly
1:
Æ
Command could not be executed (see extended error code)
2:
Æ
Erroneous TLV VALUE
3:
Æ
Invalid TLV LENGTH of the request for the active communication interface
G2: > 0:
Is added on to the TLV Response when the result of the TLV request is "1".
Extended error code: Æ
Internal error Table 2-94
Example: Sets the segment offsets for the A axis to 2.3 mm, for the X axis to 1.4 mm Request
Response
TAG
LENGTH
VALUE
20108
12
"2.3" + "1.4" + "0" + "0
8C 4E 00 00
0C 00 00 00
32 2E 33 00 31 2E 34 00 30 00 30 00
20108
2
"0"
8C 4E 00 00
02 00 00 00
30 00 Table 2-95
2-64
TLV commands
SW-TLV-EN
2017-02-23
4.9
Open door
Opens the door of the workstation
TAG
LENGTH
VALUE
Remark Limitations: Door positions 2 to 5 are only available with TMS7000/VWS 1200
Request "G1" + "G2"
G1:
Command execution mode Æ
0:
Æ
1:
G2: 2
Start opening without waiting for the end Start opening and wait for the end
Door position
1:
Æ
Open door up to Pos 1
2:
Æ
Open door up to Pos 2
3:
Æ
Open door up to Pos 3
4:
Æ
Open door up to Pos 4
5:
Æ
Open door up to Pos 5
20121 Response "G1" + "G2"
G1:
Number of bytes in the TLV Value
•
Result of the TLV request:
0:
Æ
Command executed correctly
1:
Æ
Command could not be executed (see extended error code)
2:
Æ
Erroneous TLV VALUE
3:
Æ
Invalid TLV LENGTH of the request for the active communication interface
G2:
Explanation Door position "Pos 1" corresponds to the upper end position (maximum opening height) Door position "Pos 5" corresponds to the lower end position (minimum opening height) The intermediate positions "Pos 2" to "Pos 3" are spaced evenly between the door positions "Pos 1" and "Pos 5" Extended error code: Is added on to the TLV Response when the result of the TLV request is "1".
Extended error code:
= -1:
Æ
Command not completed
> =1:
Æ
Internal error
Note: If G1:1 and G2:1, then the procedure is not yet completed and the Command must be repeated until G1:0 Table 2-96
Example: Opening the door of the workstation up to the upper end position (waiting until the door has been completely opened) Request
Response
TAG
LENGTH
VALUE
20121
4
"1" + "1"
99 4E 00 00
04 00 00 00
31 00 31 00
20121
2
"0"
99 4E 00 00
02 00 00 00
30 00 Table 2-97
SW-TLV-EN
2017-02-23
TLV commands
2-65
4.10 Close door Closes the door of the workstation
TAG
LENGTH
VALUE
Remark Limitations:
Request "G"
G: 2
Command execution mode
0:
Æ
Start closing without waiting for the end
1:
Æ
Start closing and wait for the end
With the VWS 1200, the door can only be closed with this command if the "Close door by software" option has been set in Setup. Extended error code:
Response "G1" + "G2"
G1:
20122
Number of bytes in the TLV Value
•
Result of the TLV request:
0:
Æ
Command executed correctly
1:
Æ
Command could not be executed (see extended error code)
2:
Æ
Erroneous TLV VALUE
3:
Æ
Invalid TLV LENGTH of the request for the active communication interface
G2:
Is added on to the TLV Response when the result of the TLV request is "1".
Extended error code:
= -1:
Æ
Command not completed
> =1:
Æ
Internal error
Note: If G1:1 and G2:1, then the procedure is not yet completed and the Command must be repeated until G1:0 Table 2-98
Example: Close the door of the workstation down to the lower end position (waiting until the door is completely closed) TAG Request
Response
LENGTH
VALUE
20122
2
"1"
9A 4E 00 00
02 00 00 00
31 00
20122
2
"0"
9A 4E 00 00
02 00 00 00
30 00 Table 2-99
2-66
TLV commands
SW-TLV-EN
2017-02-23
4.11 Rotate rotation door Rotates the rotation door of the workstation
TAG
LENGTH
VALUE
Remark
Request "G1" + "G2"
G1:
4
Direction of rotation
0:
Æ
Next position
1:
Æ
Left (counter-clockwise)
2:
Æ
Right (clockwise)
G2:
Command execution mode
1:
Æ
Start rotating without waiting for the end
2:
Æ
Start rotating and wait for the end
Extended error code:
Response "G1" + "G2"
G1:
20123
Number of bytes in the TLV Value
•
Result of the TLV request:
0:
Æ
Command executed correctly
1:
Æ
Command could not be executed (see extended error code)
2:
Æ
Erroneous TLV VALUE
3:
Æ
Invalid TLV LENGTH of the request for the active communication interface
G2:
Is added on to the TLV Response when the result of the TLV Request is "1".
Extended error code:
= -1:
Æ
Command not completed
> =1:
Æ
Internal error
Note: If G1:1 and G2:1, then the procedure is not yet completed and the Command must be repeated until G1:0 Table 2-100
Example: Rotating rotation door of the workstation clockwise (waiting for the end of the rotating process) TAG Request
Response
LENGTH
VALUE
20123
4
"2" + "1"
9B 4E 00 00
04 00 00 00
32 00 31 00
20123
2
"0"
9B 4E 00 00
02 00 00 00
30 00 Table 2-101
SW-TLV-EN
2017-02-23
TLV commands
2-67
4.12 Status rotating door Reads the status of the rotation door
TAG
LENGTH
Request
VALUE No data
0
Remark Extended error code:
Response "G1" + "G2" + "G3"
G1:
20124
Number of bytes in the TLV Value
•
Result of the TLV request:
0:
Æ
Command executed correctly
1:
Æ
Command could not be executed (see extended error code)
3:
Æ
Invalid TLV LENGTH of the request for the active communication interface
G2:
Rotating door status:
1:
Æ
Right (clockwise)
2:
Æ
Left (counter-clockwise)
G3: > 0:
Is added on to the TLV Response when the result of the TLV Request is "1".
Absolute position of the axis in mm Æ
Internal error Table 2-102
Example: Read status of the rotation door TAG Request
Response
LENGTH
VALUE
20124
0
No data
9C 4E 00 00
00 00 00 00
20124
4
"0" + "2"
9C 4E 00 00
04 00 00 00
30 00 32 00 Table 2-103
2-68
TLV commands
SW-TLV-EN
2017-02-23
4.13 Move foil module Creates a feed of the foil in the foil module
TAG
LENGTH
VALUE
Remark
Request "D" + "G"
Number of bytes in the TLV Value
D:
Feed for the foil module in mm
G:
Command execution mode
0:
Æ
Start moving without waiting for the end
1:
Æ
Start moving and wait for the end
Extended error code:
Response "G1" + "G2"
G1: 20141
Number of bytes in the TLV Value
Result of the TLV request:
0:
Æ
Command executed correctly
1:
Æ
Command could not be executed (see extended error code)
2:
Æ
Erroneous TLV VALUE
3:
Æ
Invalid TLV LENGTH of the request for the active communication interface
G2:
Is added on to the TLV Response when the result of the TLV Request is "1".
Extended error code:
= -1:
Æ
Command not completed
> =1:
Æ
Internal error
Note: If G1:1 and G2:1, then the procedure is not yet completed and the Command must be repeated until G1:0 Table 2-104
Example: Moving foil module by 43.21 mm (waiting for the end of the move) Request
Response
TAG
LENGTH
VALUE
20141
8
"43.21" + "1"
AD 4E 00 00
08 00 00 00
34 33 2E 32 31 00 31 00
20141
2
"0"
AD 4E 00 00
02 00 00 00
30 00 Table 2-105
SW-TLV-EN
2017-02-23
TLV commands
2-69
4.14 Edge-detection Activates/deactivates edge detection for the foil module
TAG
LENGTH
VALUE
Remark
Request "G"
G: 2
New status for the edgedetection
0:
Æ
Deactivate edge-detection
1:
Æ
Activate edge-detection
Extended error code:
Response "G1" + "G2"
G1:
20142 Number of bytes in the TLV Value
Result of the TLV request:
0:
Æ
Command executed correctly
1:
Æ
Command could not be executed (see extended error code)
2:
Æ
Erroneous TLV VALUE
3:
Æ
Invalid TLV LENGTH of the request for the active communication interface
G2: > 0:
Is added on to the TLV Response when the result of the TLV Request is "1".
Extended error code: Æ
Internal error Table 2-106
Example: Activate edge-detection for the foil module Request
Response
TAG
LENGTH
VALUE
20142
2
"1"
AE 4E 00 00
02 00 00 00
31 00
20142
2
"0"
AE 4E 00 00
02 00 00 00
30 00 Table 2-107
2-70
TLV commands
SW-TLV-EN
2017-02-23
4.15 Mechanics status Reads the status of the mechanics module
TAG Request
LENG TH
VALUE
0
No data
Response
"G1" + "G2" + "G3"
G1:
Æ
Command executed correctly
3:
Æ
Invalid TLV LENGTH of the request for the active communication interface
G2:
SW-TLV-EN
2017-02-23
Status of the mechanics module:
0:
Æ
Status OK
1:
Æ
Status not OK
G3:
20161
Result of the TLV request:
0:
Detail error of the axis:
1:
Æ
X axis not referenced
2:
Æ
X axis is at the reference switch
3:
Æ
X axis has traveled over the switch opposite the reference switch
4:
Æ
X axis has reached the position
5:
Æ
X axis cumulative malfunction
6:
Æ
Y axis is not referenced
7:
Æ
Y axis is at the reference switch
8:
Æ
Y axis has traveled over the switch opposite to the reference switch
9:
Æ
Y axis has reached the position
10:
Æ
Y axis cumulative malfunction
11:
Æ
Z axis is not referenced
12:
Æ
Z axis is at the reference switch
13:
Æ
Z axis has traveled over the switch opposite the reference switch
14:
Æ
Z axis has reached the position
15:
Æ
Z axis, cumulative malfunction
16:
Æ
A axis not referenced
17:
Æ
A axis is on the reference switch
18:
Æ
A axis has reached the position
19:
Æ
A axis cumulative malfunction
20:
Æ
C axis is not referenced
TLV commands
Remark
The PLC is not always able to display the status correctly at the beginning. In case of error (G2 0), the status should continue to be queried until G3 returns the same value. Please observe: After switching on the system, the 20161 telegram must be used to read the error memory of the system PLC. In certain cases, the telegram must be run more than once until a valid status is confirmed. If command 20101 is issued after that, the entire TMS and both rotary axes are referenced successfully.
2-71
Reads the status of the mechanics module
Numb er of bytes in the TLV Value
21:
Æ
C axis is on the reference switch
22:
Æ
C axis has reached the position
23:
Æ
C axis cumulative malfunction
24:
Æ
T axis is not referenced
25:
Æ
T axis is at the reference switch
26:
Æ
T axis has traveled over the switch opposite the reference switch
27:
Æ
T axis has reached position
28:
Æ
T axis cumulative malfunction
29:
Æ
Emergency Off switch actuated
30:
Æ
Z axis not referenced successfully
31:
Æ
Z axis position invalid
32:
Æ
Lifting table at an end stop
33:
Æ
Parity error
34:
Æ
Command not interpretable
35:
Æ
Unable to close door
36:
Æ
A axis not referenced successfully
37:
Æ
A axis position is invalid
38:
Æ
X axis not referenced successfully
39:
Æ
X axis position is invalid
40:
Æ
Rotary table error
41:
Æ
S axis not referenced
42:
Æ
S axis is at the reference switch
43:
Æ
S axis has traveled over the switch opposite the reference switch
44:
Æ
S axis has reached position
45:
Æ
S axis cumulative malfunction
Response
2-72
TLV commands
SW-TLV-EN
2017-02-23
Reads the status of the mechanics module Response
TMS5000 NEW (from 12.12.2008 onwards) G3:
Detail error of the axis: General error codes:
1:
Æ
6:
Æ
Y axis is not referenced
11:
Æ
Z axis is not referenced
TMS5000Neu Reference to: Mech_VWS_5100. dll
X axis not referenced
16:
Æ
A axis is not referenced
24:
Æ
T axis is not referenced
100:
Æ
All axis conditions OK
106:
Æ
107:
Æ
X axis detects EMERGENCY STOP situation
108:
Æ
Y axis detects EMERGENCY STOP situation
109:
Æ
A axis detects EMERGENCY STOP situation
110:
Æ
T axis detects EMERGENCY STOP situation
111:
Æ
No access to host drive
112:
Æ
No access to Z-drive
113:
Æ
No access to X-drive
114:
Æ
No access to Y-drive
115:
Æ
Z axis EMERGENCY STOP situation
No access to A-drive
Axis-specific error codes: 117:
Æ
X axis has approached the positive limit switch
118:
Æ
X axis has approached the negative limit switch
119:
Æ
X axis Power OFF
120:
Æ
X axis error
124:
Æ
Y axis has approached the positive limit switch
125:
Æ
Y axis has approached the negative limit switch
126:
Æ
Y axis Power OFF
127:
Æ
Y axis error
131:
Æ
Z axis has approached the positive limit switch
132:
Æ
Z axis has approached the negative limit switch
133:
Æ
Z axis Power OFF
134:
Æ
Z axis error
139:
Æ
A axis has approached the negative limit switch
140:
Æ
A axis Power OFF
141:
Æ
A axis error
146:
Æ
T axis has approached the negative limit switch
147:
Æ
T axis Power OFF
148:
Æ
T axis error
Table 2-108
SW-TLV-EN
2017-02-23
TLV commands
2-73
Example: Read the status of the Mechanics module > Mechanics module has error (Z axis not referenced) Request
Response
TAG
LENGTH
VALUE
20161
0
No data
C1 4E 00 00
00 00 00 00
20161
7
"0" + "1"+ "11"
C1 4E 00 00
07 00 00 00
30 00 31 00 31 31 00 Table 2-109
4.16 Mechanics error Reads the status of the mechanics module
TAG Request
2-74
20162
LENGTH
VALUE
0
No data
TLV commands
Remark
SW-TLV-EN
2017-02-23
Reads the status of the mechanics module
Response
TMS5000/VWS800 G1 + "G2" + "G3" + "G4" + "G5" + "G6" + "G7"
G1: 0: 1:
G2:
Number of bytes in the TLV Value
2: 4: 8: 16:
Æ Æ Æ Æ
G3:
Z axis
0: 1: 2:
Æ Æ Æ
4: 8:
Æ Æ
No error Emergency Off switch actuated Parity error Command not interpretable Unable to close door Rotary indexing table not in position No error No referenced Reference run was not successful Value for position invalid Lifting table hitting against a stop
A axis (rotary axis)
0: 1: 2:
Æ Æ Æ
4:
Æ
No error No referenced Reference run was not successful Value for position invalid
X axis
0: 1: 2:
Æ Æ Æ
4:
Æ =0 =0
G6: G7:
Command executed correctly Command could not be executed
General message Æ Æ
G5:
2017-02-23
Æ Æ
0: 1:
G4:
SW-TLV-EN
Result of the TLV request
No error No referenced Reference run was not successful Value for position invalid
TLV commands
The selected mechanical component in the configuration is the Mech_VWS_800.dll G2 – G7 can also be a combination of the bit values, as for example when "1" and "16" are set with G2, then the value is "17". After an Emergency Off on TMS5000 and TMS5000R the status of the axes is 0. Comment: When the Emergency Off was activated and then released again, the status of the axes is 0. Therefore, a reference run must be performed after activation of an Emergency Off.
2-75
Reads the status of the mechanics module
Response
TMS7000/VWS1200 G1 + "G2" + "G3" + "G4" + "G5" + "G6" + "G7"
G1: 0: 1:
2-76
Æ Æ
G2:
T axis
1: 2: 4: 8: 16: 32:
Æ Æ Æ Æ Æ Æ
G3:
Z axis
1: 2: 4: 8: 16: 32:
Æ Æ Æ Æ Æ Æ
G4: Number of bytes in the TLV Value
Result of the TLV request Command executed correctly Command could not be executed No referenced Not active Reference switch active Limit switch active Position ok General error
No referenced Not active Reference switch active Limit switch active Position ok General error
The selected mechanical component in the configuration is the Mech_VWS_1200.dll
G2 – G7 can also be a combination of the bit values, as for example when "1" and "16" are set with G2, then the value is "17".
A axis (rotary axis)
1: 2: 4: 8: 16: 32:
Æ Æ Æ Æ Æ Æ
G5:
X axis
1: 2: 4: 8: 16: 32:
Æ Æ Æ Æ Æ Æ
G6:
C axis
1: 2: 4: 8: 16: 32:
Æ Æ Æ Æ Æ Æ
G7:
Y axis
1: 2: 4: 8: 16: 32:
Æ Æ Æ Æ Æ Æ
No referenced Not active Reference switch active Limit switch active Position ok General error No referenced Not active Reference switch active Limit switch active Position ok General error No referenced Not active Reference switch active Limit switch active Position ok General error No referenced Not active Reference switch active Limit switch active Position ok General error
TLV commands
SW-TLV-EN
2017-02-23
Reads the status of the mechanics module
Response
TMS5000 NEW (from 12.12.2008 onwards) G1"+"G2"+"G3"+"G4"+"G5"+"G6"+"G7"
G1:
Number of bytes in the TLV Value
Result of the TLV request
0:
Æ
1:
Æ
G2:
T axis
0: 1: 2: 4: 8: 16: 32:
Æ Æ Æ Æ Æ Æ Æ
64: 128:
Æ Æ
G3:
Z axis
0: 1: 2: 4: 8: 16: 32:
Æ Æ Æ Æ Æ Æ Æ
64: 128: 256:
Æ Æ Æ
G4:
Command executed correctly Command could not be executed OK status: no error No host communication Emergency stop pressed No access to the drive No referenced Positive limit switch is active Negative limit switch is active Drive error Power Off drive OK status: no error No host communication Emergency stop pressed No access to the drive No referenced Positive limit switch is active Negative limit switch is active Drive error Power Off drive Positional limit reached
A axis (rotary axis)
0: 1: 2: 4: 8: 64: 128:
Æ Æ Æ Æ Æ Æ
G5:
X axis
0: 1: 2: 4: 8: 16: 32:
Æ Æ Æ Æ Æ Æ Æ
64: 128: 256:
Æ Æ Æ
G6: G7:
C axis Y axis
0: 1: 2: 4: 8: 16: 32:
Æ Æ Æ Æ Æ Æ Æ
64: 128: 256:
Æ Æ Æ
OK status: no error No host communication Emergency stop pressed No access to the drive No referenced Drive error Power Off drive OK status: no error No host communication Emergency stop pressed No access to the drive No referenced Positive limit switch is active Negative limit switch is active Drive error Power Off drive Positional limit reached
OK status: no error No host communication Emergency stop pressed No access to the drive No referenced Positive limit switch is active Negative limit switch is active Drive error Power Off drive Positional limit reached
G2 – G7 can also be a combination of the bit values, as for example when "1" and "16" are set with G2, then the value is "17". The selected mechanical component in the configuration is the Mech_VWS_5100.dll Comment 1: All the active axes signal "1" as the error code if there is no existing host communication. Comment 2: In case of the "Drive error" error, 128+64+8=200 is always set as error code for "Power OFF" and "not referenced". Comment 3: An axis not activated in TruTopsMark always confirms 0 as the error code. Comment 4: There is no point in comparing, for example, an EMERGENCY STOP always with a wholenumber type. It is better to filter out non-relevant information bit by bit and/or using an arithmetic expression.
Table 2-110
SW-TLV-EN
2017-02-23
TLV commands
2-77
Example: Read the status of the Mechanics module -> Z axis has not been referenced Request
Response
TAG
LENGTH
VALUE
20162
0
No data
C2 4E 00 00
00 00 00 00
20162
14
"0" + "0" + "1" + "0" + "0" + "0" + "0"
C2 4E 00 00
0E 00 00 00
30 00 30 00 31 00 30 00 30 00 30 00 30 00 Table 2-111
4.17 Moving axes continuously (from TTM 2.7) Moves the axis continuously in one direction
TAG
LENGTH
VALUE
Request "G1" + "G2"
G1:
Æ
Z axis
2:
Æ
X axis
3:
Æ
A axis
4:
Æ
Y axis
G2: 20163
2
Axis no.
1:
Direction of travel
0:
Æ
Negative
1:
Æ
Positive
Remark
The following comments apply to all stations with inching mode and stop mode. Comment 1: Move X, Y axis to maximum or minimum position. The axis stops at this position. Comment 2: The Z axis must receive a stop command afterward (tag 20164) in order for the brake to be activated. Comment 3: The collision window for the X, Z and A axes is not taken into consideration!
2-78
TLV commands
SW-TLV-EN
2017-02-23
Moves the axis continuously in one direction
Extended error code:
Response "G1" + "G2"
G1:
Number of bytes in the TLV Value
•
Result of the TLV request:
0:
Æ
Command executed correctly
1:
Æ
Command could not be executed (see extended error code)
2:
Æ
Erroneous TLV VALUE
3:
Æ
Invalid TLV LENGTH of the request for the active communication interface
G2:
Is added on to the TLV Response when the result of the TLV request is "1".
Extended error code: Æ
> 0:
Internal error
Table 2-112
Example: Moving the Z axis continuously in positive direction of travel Request
Response
TAG
LENGTH
VALUE
20163
4
"1" + "1"
C3 4E 00 00
04 00 00 00
31 00 31 00
20163
2
"0"
C3 4E 00 00
02 00 00 00
30 00 Table 2-113
4.18 Stop all axes (from TTM 2.7) Stops all axis movement functions
TAG
LENGTH
Request
VALUE
Remark
No data
Response "G1" + "G2"
G1:
20164
Number of bytes in the TLV Value
Result of the TLV request:
0:
Æ
Command executed correctly
1:
Æ
Command could not be executed (see extended error code)
2:
Æ
Erroneous TLV VALUE
3:
Æ
Invalid TLV LENGTH of the request for the active communication interface
G2: > 0:
Extended error code: Æ
Internal error Table 2-114
SW-TLV-EN
2017-02-23
TLV commands
2-79
Example: Stop all axes TAG Request
Response
LENGTH
VALUE
20164
2
C3 4E 00 00
04 00 00 00
31 00 31 00
20163
2
"0"
C3 4E 00 00
02 00 00 00
30 00 Table 2-115
4.19 Switch axis on or off Switch axis on or off
TAG
LENGTH
Request
VALUE
Remark
The axis mus be defined on the work station.
"G1" + "G2"
G1:
Designation of the axis
1:
Æ
Z axis
2:
Æ
X axis
3:
Æ
A axis
4:
Æ
Y axis
Æ
C axis
5:
G2:
Response 20165
Switch on or off
1
Æ
On
0
Æ
Off
"G1" + "G2"
G1:
Number of bytes in the TLV Value
Result of the TLV request:
0:
Æ
Command executed correctly
1:
Æ
Command could not be executed (see extended error code)
2:
Æ
Erroneous TLV VALUE
3:
Æ
Invalid TLV LENGTH of the request for the active communication interface
G2: > 0:
Extended error code: Æ
Internal error Table 2-116
Example: The A axis is switched on TAG Request
Response
LENGTH
VALUE
20165
4
"3" + "1"
C3 4E 00 00
04 00 00 00
33 00 31 00
20165
2
"0"
C3 4E 00 00
02 00 00 00
30 00 Table 2-117
2-80
TLV commands
SW-TLV-EN
2017-02-23
5.
TLV commands for the digital interface
5.1
Inputs of the digital interface
Reads all digital interface inputs
TAG
LENGTH
Request
VALUE No data
0
Remark
Limitation:
Response "G1" + "B1" + "B2" + "B3" + "G2"
G1:
20301
Number of bytes in the TLV Value
Result of the TLV request:
0:
Æ
Command executed correctly
1:
Æ
Command could not be executed (see extended error code)
3:
4:
Æ
Æ
Invalid TLV LENGTH of the request for the active communication interface Invalid TLV LENGTH of the response for the active communication interface
B1:
Status of the E8 to E1 inputs
B2:
Status of the E16 to E9 inputs
B3:
Status of the E24 to E17 inputs
G2:
Extended error code:
> 0:
Æ
The E1 to E9, E15 and E16 inputs are used by TruTops Mark® and are thus unavailable. Formatting of the input information: LSB is on the right in each case in the binary string Extended error code: •
Is added on to the TLV Response when the result of the TLV Request is "1".
Internal error Table 2-118
Example: Read all digital interface inputs Request Response
TAG
LENGTH
VALUE
20301
0
No data
4D 4F 00 00
00 00 00 00
20301
29
"0" + "11001100" + "10101010" + "00001111"
1D 00 00 00
30 00 31 31 30 30 31 31 30 30 00 31 30 31 30 31 30 31 30 00 30 30 30 30 31 31 31 31 00
4D 4F 00 00
Table 2-119
SW-TLV-EN
2017-02-23
TLV commands
2-81
5.2
X input of the digital interface
Reads the digital interface input X
TAG
LENGTH
VALUE
Remark Limitation:
Request "G"
Number of bytes in the TLV Value
G:
Æ Value range: 1 – 24
0:
Assignment of the inputs
1:
Æ
Input 1
Æ
Input 24
The E1 to E9, E15 and E16 inputs are used by TruTops Mark® and are thus unavailable.
: : 24:
Extended error code:
Response "G1" + "G2" + "G3"
G1: 20302 Number of bytes in the TLV Value
Result of the TLV request:
0:
Æ
Command executed correctly
1:
Æ
Command could not be executed (see extended error code)
2:
Æ
Erroneous TLV VALUE
3:
Æ
Invalid TLV LENGTH of the request for the active communication interface
G2: 0: 1:
G3: > 0:
•
Is added on to the TLV Response when the result of the TLV request is "1".
Status of input X: Æ
Input is LOW
Æ
Input is HIGH
Extended error code: Æ
Internal error Table 2-120
Example: Read input 13 of the digital interface Request Response
TAG
LENGTH
VALUE
20302
3
"13"
4E 4F 00 00
03 00 00 00
31 33 00
20302
4
"0" + "1"
4E 4F 00 00
04 00 00 00
30 00 31 00 Table 2-121
2-82
TLV commands
SW-TLV-EN
2017-02-23
5.3
Digital interface outputs
Sets all digital interface outputs
TAG
LENGTH
Request
VALUE
Remark Limitation:
18 "B1" + "B2"
B1:
Status for the A8 to A1 outputs
B2:
Status for the A16 to A9 outputs
The A1 to A8 outputs are used by TruTops Mark® and are thus unavailable. Formatting the output information: LSB is on the right in each case in the binary string Extended error code:
Response "G1" + "G2"
20303
G1: Number of bytes in the TLV Value
•
Result of the TLV request:
0:
Æ
Command executed correctly
1:
Æ
Command could not be executed (see extended error code)
2:
Æ
Erroneous TLV VALUE
3:
Æ
Invalid TLV LENGTH of the request for the active communication interface
G2: > 0:
Is added on to the TLV Response when the result of the TLV request is "1".
Extended error code: Æ
Internal error Table 2-122
Example: Set all digital interface outputs Request
Response
TAG
LENGTH
VALUE
20303
18
"11001100" + "1010101"
4F 4F 00 00
12 00 00 00
31 31 30 30 31 31 30 30 00 31 30 31 30 31 30 31 30 00
20303
2
"0"
4F 4F 00 00
02 00 00 00
30 00 Table 2-123
SW-TLV-EN
2017-02-23
TLV commands
2-83
5.4
X output of the digital interface
Sets the digital interface output X
TAG
LENGTH
VALUE
Remark Limitation:
Request "G1" + "G2"
Number of bytes in the TLV Value
G1:
Output to be set: Æ Value range: 1 – 16
G2:
Status of the output:
The A1 to A8 outputs are used by TruTops Mark® and are thus unavailable.
0:
Æ
Output is set to LOW
1:
Æ
Output is set to HIGH
Arrangement of the outputs: 1 -> Output 1 : : 16 -> Output 16 Extended error code:
Response "G1" + "G2"
20304
G1: Number of bytes in the TLV Value
•
Result of the TLV request:
0:
Æ
Command executed correctly
1:
Æ
Command could not be executed (see extended error code)
2:
Æ
Erroneous TLV VALUE
3:
Æ
Invalid TLV LENGTH of the request for the active communication interface
G2: > 0:
Is added on to the TLV Response when the result of the TLV request is "1".
Extended error code: Æ
Internal error Table 2-124
Example: Set digital interface output 9 to HIGH TAG Request Response
LENGTH
VALUE
20304
4
"9" + "1"
50 4F 00 00
04 00 00 00
39 00 31 00
20304
2
"0"
50 4F 00 00
02 00 00 00
30 00 Table 2-125
2-84
TLV commands
SW-TLV-EN
2017-02-23
5.5
Inputs 1 to 8 of the digital interface
Reads the digital interface inputs 1 to 8
TAG
LENGTH
VALUE
0
No data
Request
Remark Limitation: The E1 to E8 inputs are used by TruTops Mark® and are thus unavailable. Formatting of the input information:
Response "G1" + "B" + "G2"
G1: 20305
Number of bytes in the TLV Value
Result of the TLV request:
0:
Æ
Command executed correctly
1:
Æ
Command could not be executed (see extended error code)
3:
Æ
Invalid TLV LENGTH of the request for the active communication interface
B: G2: > 0:
Status of the E8 to E1 inputs
LSB is on the right in the binary string. Extended error code: •
Is added to the TLV Response when the result of the TLV request is "1".
Extended error code: Æ
Internal error Table 2-126
Example: Read digital interface inputs 1 to 8 TAG Request Response
LENGTH
VALUE
20305
0
No data
51 4F 00 00
00 00 00 00
20305
11
"0" + "11001100"
51 4F 00 00
0B 00 00 00
30 00 31 31 30 30 31 31 30 30 00 Table 2-127
SW-TLV-EN
2017-02-23
TLV commands
2-85
5.6
Inputs 9 to 16 of the digital interface
Reads the digital interface inputs 9 to 16
TAG
LENGTH
Request
VALUE No data
0
Remark Limitation: The E9 to E16 inputs are used by TruTops Mark® and are thus unavailable. . Formatting of the input information:
Response "G1" + "B" + "G2"
G1: 20306
Number of bytes in the TLV Value
Result of the TLV request:
0:
Æ
Command executed correctly
1:
Æ
Command could not be executed (see extended error code)
3:
Æ
Invalid TLV LENGTH of the request for the active communication interface
B: G2: > 0:
LSB is on the right in the binary string. Extended error code: •
Is added on to the TLV Response when the result of the TLV request is "1".
Status of the E16 to E9 inputs Extended error code: Æ
Internal error Table 2-128
Example: Read the inputs 9 to 16 of the digital interface Request Response
TAG
LENGTH
VALUE
20306
0
No data
52 4F 00 00
00 00 00 00
20306
11
"0" + "10101010"
52 4F 00 00
0B 00 00 00
30 00 31 30 31 30 31 30 31 30 00 Table 2-129
2-86
TLV commands
SW-TLV-EN
2017-02-23
5.7
Inputs 17 to 24 of the digital interface
Reads the digital interface inputs 17 to 24
TAG
LENGTH
Request
VALUE No data
0
Remark Formatting of the input information:
Response "G1" + "B" + "G2"
G1:
20307
Number of bytes in the TLV Value
Result of the TLV request:
0:
Æ
Command executed correctly
LSB is on the right in the binary string.
1:
Æ
Command could not be executed (see extended error code)
Extended error code:
3:
B: G2: > 0:
Æ
Invalid TLV LENGTH of the request for the active communication interface
Status of the E24 to E17 inputs
•
Is added on to the TLV Response when the result of the TLV request is "1".
Extended error code: Æ
Internal error Table 2-130
Example: Read the 17 to 24 inputs of the digital interface Request Response
TAG
LENGTH
VALUE
20307
0
No data
53 4F 00 00
00 00 00 00
20307
11
"0" + "00001111"
53 4F 00 00
0B 00 00 00
30 00 30 30 30 30 31 31 31 31 00 Table 2-131
SW-TLV-EN
2017-02-23
TLV commands
2-87
5.8
Outputs 1 to 8 of the digital interface
Sets the digital interface outputs 1 to 8
TAG
LENGTH
Request
VALUE
Remark
9
Limitation: "B"
B:
The A1 to A8 outputs are used by TruTops Mark® and are thus unavailable.
Status for the A8 to A1 outputs
Formatting of the output information: LSB is on the right in the binary string. Extended error code:
Response "G1" + "G2"
20308
G1: Number of bytes in the TLV Value
•
Result of the TLV request:
0:
Æ
Command executed correctly
1:
Æ
Command could not be executed (see extended error code)
2:
Æ
Erroneous TLV VALUE
3:
Æ
Invalid TLV LENGTH of the request for the active communication interface
G2: > 0:
Is added on to the TLV Response when the result of the TLV Request is " 1".
Extended error code: Æ
Internal error Table 2-132
Example: Set the 1 to 8 outputs of the digital interface TAG Request Response
LENGTH
VALUE
20308
9
"11001100"
54 4F 00 00
09 00 00 00
31 31 30 30 31 31 30 30 00
20308
2
"0"
54 4F 00 00
02 00 00 00
30 00 Table 2-133
2-88
TLV commands
SW-TLV-EN
2017-02-23
5.9
Outputs 9 to 16 of the digital interface
Sets the digital interface outputs 9 to 16
TAG
LENGTH
Request
VALUE
Remark Formatting of the output information:
9 "B"
B:
LSB is on the right in the binary string.
Status for the A16 to A9 outputs
Extended error code:
Response "G1" + "G2"
G1: 20309
Number of bytes in the TLV Value
•
Result of the TLV request:
0:
Æ
Command executed correctly
1:
Æ
Command could not be executed (see extended error code)
2:
Æ
Erroneous TLV VALUE
3:
Æ
Invalid TLV LENGTH of the request for the active communication interface
G2: > 0:
Is added on to the TLV Response when the result of the TLV Request is "1".
Extended error code: Æ
Internal error Table 2-134
Example: Set the 9 to 16 outputs of the X20 interface Request Response
TAG
LENGTH
VALUE
20309
9
"10101010"
55 4F 00 00
09 00 00 00
31 30 31 30 31 30 31 30 00
20309
2
"0"
55 4F 00 00
02 00 00 00
30 00 Table 2-135
SW-TLV-EN
2017-02-23
TLV commands
2-89
6.
TLV commands for the marking control system
6.1
Load marking file
Loads and converts the assigned marking file
TAG
LENGTH
VALUE
Remark Explanations:
Request
If the file extension is not specified, then the standard extension, ".vlf", is used
"T"
T:
Name of the marking file (including directory)
Number of bytes in the TLV Value
If no directory is specified, then the directory of the most recently loaded marking file or the directory set by the TLV Command "Set directory path" will be used. Extended error code:
Response "G1" + "G2"
G1:
20401
Number of bytes in the TLV Value
•
Result of the TLV request:
0:
Æ
Command executed correctly
1:
Æ
Command could not be executed (see extended error code)
2:
Æ
Erroneous TLV VALUE
3:
Æ
Invalid TLV LENGTH of the request for the active communication interface
G2:
Is added on to the TLV Response when the result of the TLV Request is "1".
Extended error code:
1:
Æ
Marking file could not be loaded
10:
Æ
General conversion errors
11:
Æ
No conversion, empty variable ?
12:
Æ
Laser font not available
13:
Æ
Variable from text file: all data processed
14:
Æ
Serial number: end value reached
> 14:
Æ
Internal error Table 2-136
Example: Load and convert the "TEST.vlf" marking file TAG Request Response
LENGTH
VALUE
20401
5
"TEST"
B1 4F 00 00
05 00 00 00
54 45 53 54 00
20401
2
"0"
B1 4F 00 00
02 00 00 00
30 00 Table 2-137
2-90
TLV commands
SW-TLV-EN
2017-02-23
6.2
Convert marking file
Converts the loaded marking file
TAG
LENGTH
VALUE
0
No data
Request
Remark The following conditions must be fulfilled: Marking file must be loaded Extended error code:
Response "G1" + "G2"
G1:
20402
Number of bytes in the TLV Value
•
Result of the TLV request:
0:
Æ
Command executed correctly
1:
Æ
Command could not be executed (see extended error code)
3:
Æ
Invalid TLV LENGTH of the request for the active communication interface
G2:
Is added on to the TLV Response when the result of the TLV Request is "1".
Extended error code:
1:
Æ
No marking file is loaded
10:
Æ
General conversion errors
11:
Æ
No conversion, empty variable?
12:
Æ
Laser font not available
13:
Æ
Variable from text file: all data processed
14:
Æ
Serial number: end value reached
> 14:
Æ
Internal error Table 2-138
Example: Convert the loaded marking file TAG Request Response
LENGTH
VALUE
20402
0
No data
B2 4F 00 00
00 00 00 00
20402
2
"0"
B2 4F 00 00
02 00 00 00
30 00 Table 2-139
SW-TLV-EN
2017-02-23
TLV commands
2-91
6.3
Mark marking file X
Loads, converts and marks the assigned marking file and waits until the marking procedure has been completed TAG
LENGTH
VALUE
Request "T"
T:
Name of the marking file (including directory)
Response "G1" + "G2"
G1:
Number of bytes in the TLV Value
The laser or the pilot laser must be switched on. Explanations: If the file extension is not specified, then the standard extension ".vlf" will be used If no directory is specified, then the directory of the most recently loaded marking file or the directory set by the TLV Command "Set directory path" will be used. Extended error code:
Number of bytes in the TLV Value
20403
Remark
The following conditions must be fulfilled:
Result of the TLV request:
0:
Æ
Command executed correctly
1:
Æ
Command could not be executed (see extended error code)
2:
Æ
Erroneous TLV VALUE
3:
Æ
Invalid TLV LENGTH of the request for the active communication interface
G2:
•
Is added on to the TLV Response when the result of the TLV Request is "1".
Extended error code:
1:
Æ
Marking file could not be loaded
10:
Æ
General conversion errors
11:
Æ
No conversion, empty variable
12:
Æ
Laser font not available
13:
Æ
Variable from text file: all data processed
14:
Æ
Serial number: end value reached
15:
Æ
Execution in case of activated "Restart mark" is not allowed
> 15:
Æ
Internal error Table 2-140
2-92
TLV commands
SW-TLV-EN
2017-02-23
Example: Load, convert and mark the "TEST.vlf" marking file TAG Request Response
LENGTH
VALUE
20403
5
"TEST"
B3 4F 00 00
05 00 00 00
54 45 53 54 00
20403
2
"0"
B3 4F 00 00
02 00 00 00
30 00 Table 2-141
6.4
Set directory path
Sets the directory path from which marking files can be loaded
TAG Request
LENGTH Number of bytes in the TLV Value
VALUE
Remark After executing this TLV command, the "Load marking file" and/or "Mark marking file X" commands can be used without specifying a directory path for the assigned marking file there.
"T"
T:
Directory name
Response "G1" + "G2"
G1: 20404
2
Result of the TLV request:
0:
Æ
Command executed correctly
1:
Æ
Command could not be executed (see extended error code)
2:
Æ
Erroneous TLV VALUE
3:
Æ
Invalid TLV LENGTH of the request for the active communication interface
G2:
Extended error code:
1:
Æ
Path does not exist
> 1:
Æ
Internal error Table 2-142
Example: Set directory for marking files to "C:\DATEN\ZEICH" Request
Response
TAG
LENGTH
VALUE
20404
15
"C:\DATEN\ZEICH"
B4 4F 00 00
0F 00 00 00
43 3A 5C 44 41 54 45 4E 5C 5A 45 49 43 48 00
20404
2
"0"
B4 4F 00 00
02 00 00 00
30 00 Table 2-143
SW-TLV-EN
2017-02-23
TLV commands
2-93
6.5
N text variable (see also "Set variable")
Sets the content for several text variables
TAG
LENGTH
VALUE
Remark The following conditions must be fulfilled:
Request "T1" + "T2" +... + "TX"" TX:
20409
- Marking file with a text as variable must be loaded Limitations: - This TLV command should not be used with TruTops Mark unless, the system is to be operated in turns with Winmark4 and TruTops Mark. - Otherwise, the TLV Command "Set variable" should be used.
Contents for the text variables
Number of bytes in the TLV Value
- The variable names for texts must meet the requirements of the following sequence: - "TX" with X as number (> 0) of the text variable Response
"G1" + "G2"
G1:
Number of bytes in the TLV Value
Result of the TLV request:
0:
Æ
Command executed correctly
1:
Æ
Command could not be executed (see extended error code)
2:
Æ
Erroneous TLV VALUE
3:
Æ
Invalid TLV LENGTH of the request for the active communication interface
G2:
Extended error code:
1:
Æ
No variable exists with the assigned ID
2:
Æ
No marking file is loaded
> 2:
Æ
Internal error Table 2-144
Example: Set text variables T1 = 123, T2 = 456, T3 = 789, T4 = abc Request
Response
TAG
LENGTH
VALUE
20409
16
"123" + "456" + "789" + "abc"
B9 4F 00 00
10 00 00 00
31 32 33 00 34 35 36 00 37 38 39 00 61 62 63 00
20409
2
"0"
B9 4F 00 00
02 00 00 00
30 00 Table 2-145
2-94
TLV commands
SW-TLV-EN
2017-02-23
6.6
Read file name/directory
Reads the file name and/or directory name of the loaded marking file
TAG
LENGTH
VALUE
Remark The following conditions must be fulfilled:
Request "G"
G:
Function to be executed:
1:
Æ
Return path and name of the marking file
2:
Æ
Return path of the marking file
3:
Æ
Return name of the marking file
2
- Marking file must be loaded
Extended error code:
Response "G1" + "T" + "G2"
G1: 20411
Number of bytes in the TLV Value
•
Result of the TLV request:
0:
Æ
Command executed correctly
1:
Æ
Command could not be executed (see extended error code)
3:
Æ
Invalid TLV LENGTH of the request for the active communication interface
4:
Æ
Invalid TLV LENGTH of the response for the active communication interface
T: G2:
Is added on to the TLV Response when the result of the TLV request is "1".
File name and/or directory Extended error code:
1:
Æ
No marking file has been loaded
> 1:
Æ
Internal error Table 2-146
Example: Read path and name of the loaded marking file -> "C:\TRUMARK\VLF\TEST.VLF" Request
Response
TAG
LENGTH
VALUE
20411
2
"1"
BB 4F 00 00
02 00 00 00
31 00
20411
26
"0" + " C:\TRUMARK\VLF\TEST.VLF "
1A 00 00 00
30 00 63 3A 5C 74 72 75 6D 61 72 6B 5C 76 6C 66 5C 74 65 73 74 2E 76 6C 66 00
BB 4F 00 00
Table 2-147
SW-TLV-EN
2017-02-23
TLV commands
2-95
6.7
Set variable
Sets the content of the assigned variables
TAG
LENGTH
VALUE
Request "TN1" + "TV1" (+ "TN2" + "TV2") + (...)"
Number of bytes in the TLV Value
TN1:
Identifying variable 1
TV1:
Content of variable 1
TN2:
Identifying variable 2
TV2:
Content of variable 2
TNn:
Identifying variable n
TVn:
Content of variable n
"G1" + "G2"
G1:
Number of bytes in the TLV Value
Result of the TLV request:
0: 1:
Æ Æ
2: 3:
Æ Æ
G2:
- Marking file with one variable must be loaded . - Always assign variable names and content in pairs. It is also true that only a pair can be assigned. - If the variable is defined as a serial number, the assigned value is used as the new start value - Data matrix – with control character: ~dnnn nnn = ASCII – decimal value Extended error code:
20421 Response
Remark The following conditions must be fulfilled:
Command executed correctly Command could not be executed (see extended error code) Erroneous TLV VALUE Invalid TLV LENGTH of the request for the active communication interface
•
Is added on to the TLV Response when the result of the TLV Request is " 1".
Extended error code:
1:
Æ
2: > 2:
Æ Æ
No variable exists with the assigned ID No marking file is loaded Internal error Table 2-148
2-96
TLV commands
SW-TLV-EN
2017-02-23
Example 1: Set the content of the "VAR_4" variable to "Test text" Request
Response
TAG
LENGTH
VALUE
20421
15
C5 4F 00 00
0F 00 00 00
56 41 52 5F 34 00 54 65 73 74 74 65 78 74 00
20421
2
"0"
C5 4F 00 00
02 00 00 00
30 00
"
VAR_4" + "Test text"
Table 2-149
Example 2: Set the content of variables "V1" to "0" and "V2" to "AB[cr][lf]C" (only applies to the data matrix code) Request
Response
TAG
LENGTH
VALUE
20421
22
"V1" + "0" + "V2" + "AB~d013~d010C"
C5 4F 00 00
16 00 00 00
56 31 00 30 00 56 32 00 41 42 7E 64 30 31 33 7E 64 30 31 30 43 00
20421
2
"0"
C5 4F 00 00
02 00 00 00
30 00
[cr] [lf]
SW-TLV-EN
2017-02-23
= Carriage return (line break) = Line feed
TLV commands
Table 2-150
2-97
6.8
Read variable
Reads the content of the assigned variable
TAG
LENGTH
VALUE
Remark The following conditions must be fulfilled:
Request "T"
T:
Number of bytes in the TLV Value
Identifying the variable
Marking file with one variable must be loaded. The content of the variable must have been set in advance and converted or marked.
Extended error code:
Response "G1" + "T" + "G2"
G1:
20422
Number of bytes in the TLV Value
Result of the TLV request:
0:
Æ
Command executed correctly
1:
Æ
Command could not be executed (see extended error code)
2:
Æ
Erroneous TLV VALUE
3:
Æ
Invalid TLV LENGTH of the request for the active communication interface
4:
Æ
Invalid TLV LENGTH of the response for the active communication interface
T: G2:
•
Is added on to the TLV Response when the result of the TLV request is "1".
Content of the variable Extended error code:
1:
Æ
No marking file has been loaded
2:
Æ
No marking file is loaded
> 2:
Æ
Internal error Table 2-151
Example: Read variable "VAR_4" with "Test text" Request
Response
TAG
LENGTH
20422
6
VALUE "VAR_4"
C6 4F 00 00
06 00 00 00
56 41 52 5F 34 00
20422
11
"0" + "Test text"
C6 4F 00 00
0B 00 00 00
30 00 54 65 73 74 74 65 78 74 00
Table 2-152
2-98
TLV commands
SW-TLV-EN
2017-02-23
6.9
Scaling/displacement
Scales, moves or rotates the marking around the midpoint of the image field
TAG
LENGTH
VALUE
Remark The following conditions must be fulfilled:
Request "D1" + "D2"+ "D3"+ "D4"
D1:
Scaling factor Æ
1:
D2: Number of bytes in the TLV Value
Angle of rotation in ° clockwise around the mid point of the image field Æ
0:
D3:
No rotation
Displacement along the X axis in mm Æ
0:
D4:
Original size
No displacement
Displacement along the Y axis in mm Æ
0:
No displacement
20423 Response "G1" + "G2"
G1: 0: 1:
Number of bytes in the TLV Value
2: 3:
G2: > 0:
•
Result of the TLV request: Æ Æ
Æ Æ
Command executed correctly Command could not be executed (see extended error code) Erroneous TLV VALUE Invalid TLV LENGTH of the request for the active communication interface
Extended error code: Æ
_ Marking file must be loaded Explanations: - The settings remain in effect for the loaded marking file until they are overwritten with this TLV Command or unless a different marking file is loaded. - Sequence of operations: 1. Scale 2. Rotate around the midpoint of the image field (+° = clockwise ) 3. Move Extended error code:
Internal error
Is added on to the TLV Response when the result of the TLV request is "1".
Notice: When this command is used with the option "Rotate, Move and Scale" in the configuration under "HW components/RTC", this is executed with RTC card commands, i.e. when rotated this has no effect on the size. Table 2-153
Example: Modification of the marking by the following values: -> Scaling by a factor of 2.5 -> Rotate by 1.25° -> Displacement along the X axis by –20 mm/displacement along the Y axis by +5 mm Request
Response
TAG
LENGTH
VALUE
20423
15
"2.5" + "1.25" + "-20" + "5"
C7 4F 00 00
0F 00 00 00
32 2E 35 00 31 2E 32 35 00 2D 32 30 00 35 00
20423
2
"0"
C7 4F 00 00
02 00 00 00
30 00 Table 2-154
SW-TLV-EN
2017-02-23
TLV commands
2-99
6.10 Rotating/displacing the marking field in MHS systems Scales, moves or rotates the marking around the midpoint of the image field
TAG
LENGTH
VALUE
Remark The following conditions must be fulfilled:
Request "D1" + "D2" + "D3"
D1:
Angle of rotation of the marking field Æ
0:
D2:
Æ
0:
Number of bytes in the TLV Value
D3:
No rotation
Displacement along the X axis in mm No displacement
Displacement along the Y axis in mm Æ
0:
No displacement
Explanations: - The marking field is rotated around the angle and the displacement in X and Y direction for Head B is calculated and taken into account. The X or Y displacement is added in case of Head A and Head B. - Sequence of operations: 1. Rotate around the zero point of the marking field (+° = clockwise ) 2. Calculating the displacement of Head B 3. Displacing Head A and Head B Extended error code:
20424
Response "G1" + "G2"
G1: Number of bytes in the TLV Value
0: 1:
Æ Æ
2: 3:
Æ Æ
G2: > 0:
- Only supported from TruMark onwards.
Result of the TLV request: Command executed correctly Command could not be executed (see extended error code) Erroneous TLV VALUE Invalid TLV LENGTH of the request for the active communication interface
- Is added on to the TLV Response when the result of the TLV request is "1".
Extended error code: Æ
Internal error Table 2-155
Example: Modification of the marking by the following values: -> Rotate by 1.25° -> Displacement along the X axis by –20 mm/displacement along the Y axis by +5 mm TAG Request
Response
LENGTH
VALUE
20424
11
"1.25" + "-20" + "5"
C8 4F 00 00
0B 00 00 00
31 2E 32 35 00 2D 32 30 00 35 00
20424
2
"0"
C8 4F 00 00
02 00 00 00
30 00 Table 2-156
2-100
TLV commands
SW-TLV-EN
2017-02-23
6.11 Load marking objects into the scanner Marking is started with the E15 start signal. The start signal must be taken back again before the end of a marking process. Loads a converted marking file into a scanner list in order to mark the marking file using the "Restart mark"/"Abort mark" digital inputs
TAG
SW-TLV-EN
LENGTH
2017-02-23
VALUE
TLV commands
Remark
2-101
Loads a converted marking file into a scanner list in order to mark the marking file using the "Restart mark"/"Abort mark" digital inputs The following conditions must Request be fulfilled: "G1" + "G2" + "G3" - Marking file must be loaded G1: List in which the marking and converted objects are loaded: - The "Restart_mark / Abort_mark" digital inputs 0: Æ Only one list is available, must be configured which is made up of list 1 and list 2 1:
Æ
List 1
2:
Æ
List 2
100:
Æ
List completion (REI)
101-115:
Æ
List space (REI)
255:
G2:
Task for the "Restart mark" counter:
0:
Æ
Do not reset counter
1:
Æ
Counter reset to 0
G3: 0:
20441
Continuous mode
Laser parameters: Æ
Number of bytes in the TLV Value
Laser parameter is not set, i.e. the currently set laser parameter is used for marking For the TruMark 6000 series, the defocus and power parameters are not set. All other laser parameters are always set.
Explanations: - Before starting the marking process using the "Restart mark" input, one of the two lists must be activated using the "Activate scanner list" TLV command beforehand. - If the unavailable list number 255 is specified when loading, list 1 is loaded at the end of the list with the "Jump to Start" command. E15=Restart Mark starts the marking procedure in the continuous mode. The continuous output can be ended using at E16=Abort Mark. Limitations: - Only marking files with a limited number of vectors can be processed - Only one laser parameter set can be processed for the complete marking file.
For TruMark 3000 and 5000, this value must always be 1. Otherwise, this can result in an incorrect marking. 1:
Æ
Laser parameter is set to the laser parameter of the first marked object Please note that for TruMark 3000 and 5000, there is always only one laser parameter in a marking file. This is because our system can only process a marking file properly in retrigger mode with one laser parameter in the file.
2-102
TLV commands
Operation with REI card or IOE: - 15 list spaces are available for operation with the REI card or IOE. - A maximum of 8000 list commands are possible. - The list spaces can be selected and activated using the REI card or IOE with respect to the hardware. - One marking file can be loaded in every list space. Complete the list with "100". (See example Sample_08_List_1-15.txt)
SW-TLV-EN
2017-02-23
Loads a converted marking file into a scanner list in order to mark the marking file using the "Restart mark"/"Abort mark" digital inputs
Extended error code:
Response "G1" + "G2"
G1:
Number of bytes in the TLV Value
0: 1:
Æ Æ
2: 3:
Æ Æ
G2:
•
Result of the TLV request: Command executed correctly Command could not be executed (see extended error code) Erroneous TLV VALUE Invalid TLV LENGTH of the request for the active communication interface
Is added on to the TLV Response when the result of the TLV Request is "1".
Extended error code:
1:
Æ
2:
Æ
3:
Æ
> 3:
Æ
Invalid list number or list in processing "Restart mark/Abort mark" inputs not configured. Converted marking file is too large for the list Internal error Table 2-157
Example: Load marking objects into the scanner -> List 1 -> "Restart mark" - reset counter -> Do not set laser parameters Request
Response
TAG
LENGTH
VALUE
20441
6
"1" + "1" + "0"
D9 4F 00 00
06 00 00 00
31 00 31 00 30 00
20441
2
"0"
D9 4F 00 00
02 00 00 00
30 00 Table 2-158
SW-TLV-EN
2017-02-23
TLV commands
2-103
6.12 Activate scanner list Activates one of the two scanner lists. The contents of this list will be marked by means of the "Restart mark" input the next time that marking is started.
TAG
LENGTH
VALUE
Remark The following conditions must be fulfilled:
Request "G"
G:
Number of bytes in the TLV Value
- A converted marking file needs to have been loaded into the selected list beforehand by means of the TLV Command "Load marking objects into the scanner". A converted marking file has been loaded
Active list selection: Æ Æ
1: 2:
List 1 List 2
- The "Restart_mark / Abort_mark" digital inputs must be configured Extended error code:
Response "G1" + "G2"
20442
G1:
Number of bytes in the TLV Value
0: 1:
Æ Æ
2: 3:
Æ Æ
G2:
•
Result of the TLV request: Command executed correctly Command could not be executed (see extended error code) Erroneous TLV VALUE Invalid TLV LENGTH of the request for the active communication interface
Is added on to the TLV Response when the result of the TLV request is "1".
Extended error code:
1:
Æ
2:
Æ
> 2:
Æ
Invalid list number or list in processing "Restart mark/Abort mark" inputs not configured. Internal error
Table 2-159
Example: Activate scanner list 1 Request Response
TAG
LENGTH
20442
2
VALUE
"1"
DA 4F 00 00
02 00 00 00
31 00
20442
2
"0"
DA 4F 00 00
02 00 00 00
30 00
Table 2-160
2-104
TLV commands
SW-TLV-EN
2017-02-23
6.13 Start scanner list Starts one of the two scanner lists. TAG
LENGTH
VALUE
Remark
Request "G"
G:
Selecting the list to be started: Æ Æ
1: 2:
Number of bytes in the TLV Value
List 1 List 2
Response "G1" + "G2"
G1:
20443
Number of bytes in the TLV Value
Result of the TLV request:
0: 1:
Æ Æ
2:
Æ
3:
Æ
G2:
Command executed correctly Command could not be executed (see extended error code) Parameter VALUE is unknown Invalid TLV LENGTH of the request for the active communication interface
The following conditions must be fulfilled: A converted marking file needs to have been loaded into the selected list beforehand by means of the TLV Command "Load marking objects into the scanner". The "Restart_mark / Abort_mark" digital inputs must be configured Extended error code: • Is added on to the TLV Response when the result of the TLV Request is "1".
Extended error code:
1:
Æ
2:
Æ
> 2:
Æ
Invalid list number or list in processing "Restart mark/Abort mark" inputs not configured. Internal error
Table 2-161
Example: Starting scanner list 1 Request Response
TAG
LENGTH
VALUE
20443
2
DB 4F 00 00
02 00 00 00
"1" 31 00
20443
2
"0"
DB 4F 00 00
02 00 00 00
30 00
Table 2-162
SW-TLV-EN
2017-02-23
TLV commands
2-105
6.14 Delete active VCT files Deletes all VCT files of the loaded marking file. TAG
LENGTH
Request
VALUE
0
Remark The following conditions must be fulfilled:
No data
A marking file must be loaded prior to deletion. After deletion, the file must be reloaded and converted. Explanation - During deletion, all used CAD variables are reset. Response "G1" + "G2"
20451
G1:
Number of bytes in the TLV Value
Result of the TLV request:
0: 1:
Æ Æ
2:
Æ
3:
Æ
G2:
Command executed correctly Command could not be executed (see extended error code) Parameter VALUE is unknown Invalid TLV LENGTH of the request for the active communication interface
Extended error code: • Is added on to the TLV Response when the result of the TLV Request is "1".
Extended error code:
1:
Æ
> 1:
Æ
No segmented marking file has been loaded for editing Internal error Table 2-163
Example: Deleting active VCT files Request Response
TAG
LENGTH
VALUE
20451
0
No data
E3 4F 00 00
00 00 00 00
20451
2
"0"
E3 4F 00 00
02 00 00 00
30 00
Table 2-164
2-106
TLV commands
SW-TLV-EN
2017-02-23
6.15 Delete all VCT files Deletes all VCT files in the VCT directory. TAG
LENGTH
VALUE
0
No data
Request
Remark The following conditions must be fulfilled: A marking file must be loaded prior to deletion. After deletion, the file must be reloaded and converted. Explanations: - During deletion, all used CAD variables are reset.
Response
Extended error code: 20452
"G1" + "G2"
G1: Number of bytes in the TLV Value
0: 1:
Æ Æ
2:
Æ
3:
Æ
G2: > 0:
•
Result of the TLV request: Command executed correctly Command could not be executed (see extended error code) Parameter VALUE is unknown Invalid TLV LENGTH of the request for the active communication interface
Is added on to the TLV Response when the result of the TLV Request is "1".
Extended error code: Æ
Internal error Table 2-165
Example: Delete all VCT files Request Response
TAG
LENGTH
VALUE
20452
0
No data
E4 4F 00 00
00 00 00 00
20452
2
"0"
E4 4F 00 00
02 00 00 00
30 00
Table 2-166
SW-TLV-EN
2017-02-23
TLV commands
2-107
6.16 Hiding and showing the HMI Hiding and showing the Standard_gui. TAG
LENGTH
Request
2
VALUE
Remark The following conditions must be fulfilled:
"D" D:
Status of the HMI
0:
Æ
HMI is not displayed
1:
Æ
HMI is displayed
TruTops Mark must be started. Extended error code:
Response "G1" + "G2"
20453
G1:
Number of bytes in the TLV Value
0: 1:
G2: > 0:
•
Result of the TLV request: Æ Æ
Command executed correctly Command could not be executed (see extended error code)
Is added on to the TLV Response when the result of the TLV Request is "1".
Extended error code: Æ
Internal error Table 2-167
Example: Hides the HMI Request Response
TAG
LENGTH
20453
2
VALUE
"0"
E4 4F 00 00
00 00 00 00
30 00
20452
2
"0"
E4 4F 00 00
02 00 00 00
30 00
Table 2-168
2-108
TLV commands
SW-TLV-EN
2017-02-23
6.17 Generating marking file for editing Generates a new, empty marking file for further editing
TAG
LENGTH
VALUE
0
No data
Request
Response
Remark Explanations: - The new CAD file is generated by loading a template . - The templates are stored in the directory "..\VLF\Vorlagen" and have the names of the image field size. - The template that corresponds to the active image field size of the separator magazine is loaded . Extended error code:
20461
"G1" + "G2"
G1:
Number of bytes in the TLV Value
0: 1:
Æ Æ
3:
Æ
G2:
•
Result of the TLV request: Command executed correctly Command could not be executed (see extended error code) Invalid TLV LENGTH of the request for the active communication interface
Is added on to the TLV Response when the result of the TLV request is "1".
Extended error code:
1: 2:
Æ Æ
> 2:
Æ
There is no template available Marking file could not be generated Internal error
Table 2-169
Example: Generating a new marking file Request Response
TAG
LENGTH
VALUE
20461
0
No data
ED 4F 00 00
00 00 00 00
20461
2
"0"
ED 4F 00 00
02 00 00 00
30 00
Table 2-170
SW-TLV-EN
2017-02-23
TLV commands
2-109
6.18 Load marking file for editing Loads the marking file to be assigned for further editing
TAG
LENGTH
VALUE
Remark Explanations:
Request
- If the file extension is not specified, then the standard extension ".vlf" will be used - If no directory is specified, then the directory of the most recently loaded marking file or the directory set by the TLV Command "Set directory path" will be used.
"T"
T: Number of bytes in the TLV Value
Name of the CAD file (including directory)
Extended error code:
Response "G1" + "G2"
20462
G1:
Number of bytes in the TLV Value
0: 1:
Æ Æ
2:
Æ
3:
Æ
G2:
Is added on to the TLV Response when the result of the TLV Request is "1".
Result of the TLV request: Command executed correctly Command could not be executed (see extended error code) Parameter VALUE is unknown Invalid TLV LENGTH of the request for the active communication interface
Extended error code:
1: 2:
Æ Æ
> 2:
Æ
Marking file does not exist Marking file could not be opened Internal error
Table 2-171
Example: Load marking file "TEST.VLF": Request
Response
TAG
LENGTH
20462
9
VALUE "TEST.VLF"
EE 4F 00 00
09 00 00 00
54 45 53 54 2E 56 4C 46 00
20462
2
"0"
EE 4F 00 00
02 00 00 00
30 00
Table 2-172
2-110
TLV commands
SW-TLV-EN
2017-02-23
6.19 Import CAD file Imports the assigned CAD file into a marking file that has already been opened for editing
TAG
LENGTH
VALUE
Request "T1" + "T2" + "G" + "D1" + "D2" + "D3" + "D4"
T1: T2:
G: 0: 1:
D1:
20463
Number of bytes in the TLV Value
D2:
D3: > 1:
D4: > 0:
SW-TLV-EN
2017-02-23
Remark Conditions: - A marking file for editing must be opened (TLV commands "Generate marking file for editing" or "Load marking file for editing").
Name of the CAD file to be imported (including directory) Name of the laser parameter for the import. If no information is Explanations: given, the original laser - The following CAD formats are parameters are used when supported: importing a marking file.
- VLF / DXF / HP / HPG / HPGL / HGL / PLT - A text file is used during DXF Import mode import for allocating the DXF fonts to the Æ Without displacement ® TruTops Mark Fonts Æ With displacement (position is (selection via TruTops Mark® defined by the lower left-hand configuration) corner) - Structure of the text file: - One font allocation per line X value of the lower left-hand "Dxf_fontname:TruTopsMark_fontn corner of the import in mm ame;" Is taken into account only when - See also the following sample file: import mode = 1 C:\TruMark\Standard_GUI\ Font_to_font.txt Y value of the lower left-hand
corner of the import in mm -> Is taken into account only when Import mode = 1 Scaling factor Æ
Original size
Angle of rotation in ° clockwise Æ
No rotation
TLV commands
- If no file extension is specified then the standard extension ".vlf" will be used - If no directory is specified, then the directory of the last marking file loaded or the directory set by the "Set directory path" TLV Command will be used. - Laser parameter must be specified with the complete parameter path (e.g. Aluminum\Marking). - If the assigned laser parameter is not available, then the "Standard" laser parameter will be used. - The laser parameters must be available in the source file (C:\TruMark\VLF\Vorlagen\*.vlf) under "In this project" - Import position is the lower lefthand corner of a rectangle that encloses all of the objects of the CAD file to be imported.
2-111
Imports the assigned CAD file into a marking file that has already been opened for editing
Extended error code:
Response "G1" + "D1" + "D2" + "D3" + "D4" + "G2"
G1:
20463
Number of bytes in the TLV Value
Result of the TLV request:
0: 1:
Æ Æ
2:
Æ
3:
Æ
4:
Æ
Command executed correctly Command could not be executed (see extended error code) Parameter VALUE is unknown Invalid TLV LENGTH of the request for the active communication interface Invalid TLV LENGTH of the response for the active communications interface
D1:
X value of the lower left-hand corner of the import in mm
D2:
Y value of the lower left-hand corner of the import in mm
D3:
X value of the upper right-hand corner of the import in mm
D4:
Y value of the upper right-hand corner of the import in mm
G2:
Extended error code:
1:
Æ
2:
Æ
3:
Æ
4: 5: 6:
Æ Æ Æ
> 6:
Æ
Is added on to the TLV Response when the result of the TLV Request is "1".
No marking file has been opened for editing The marking file opened is corrupt Import CAD file could not be opened Import CAD file is corrupt Import CAD file does not exist Import CAD file has a wrong extension Internal error Table 2-173
Example: Import "TEST.VLF" CAD file
-> Laser parameters: "Marking" -> Displacement to position X=2.5 mm/Y=5 mm -> Scaling: 200% -> Rotate counter-clockwise by 45º New position: Left-hand lower corner: X=2.500/Y=5.000; Right-hand upper corner: X=12.500/Y=15.000
Request
Response
TAG
LENGTH
20463
33
"TEST.VLF" + "Marking" + "1" + "2.5" + "5" + "2" + "-45"
EF 4F 00 00
21 00 00 00
54 45 53 54 2E 56 4C 46 00 4D 61 72 6B 69 65 72 65 6E 00 31 00 32 2E 35 00 35 0032 00 2D 34 35 00
20463
28
"0" + "2.500" + "5.000" + "12.500" + "15.000"
1C 00 00 00
30 00 32 2E 35 30 30 00 35 2E 30 30 30 00 31 32 2E 35 30 30 00 31 35 2E 30 30 30 00
EF 4F 00 00
VALUE
Table 2-174
2-112
TLV commands
SW-TLV-EN
2017-02-23
6.20 Save the marking file opened for editing Saves the marking file currently opened for editing under the assigned name.
TAG
LENGTH
VALUE
Remark Conditions:
Request "T"
T:
Name under which the marking file opened for editing should be saved (including directory).
Number of bytes in the TLV Value
Response
- A marking file must be opened for editing (TLV commands "Generate marking file for editing" or "Load marking file for editing"). Explanations - If no file extension is specified, then the standard extension ".vlf" will be used - If no directory has been specified, the directory of the last loaded marking file or the directory set by the "Set directory path" TLV command will be used.
Extended error code:
20464
"G1" + "G2"
G1:
Number of bytes in the TLV Value
Result of the TLV request:
0: 1:
Æ Æ
2:
Æ
3:
Æ
G2:
Command executed correctly Command could not be executed (see extended error code) Parameter VALUE is unknown Invalid TLV LENGTH of the request for the active communication interface
Is added on to the TLV Response when the result of the TLV Request is "1".
Extended error code:
1:
Æ
2:
Æ
> 2:
Æ
No marking file has been opened for processing Marking file could not be saved Internal error
Example: Save the marking file opened for
Table 2-175
editing under the name "TEST_01.VLF": Request
Response
TAG
LENGTH
VALUE
20464
12
"TEST_01.VLF"
F0 4F 00 00
0C 00 00 00
54 45 53 54 5F 30 31 2E 56 4C 46 00
20464
2
"0"
F0 4F 00 00
02 00 00 00
30 00
Table 2-176
6.21 Adding a line Adds a line with the assigned geometry to the marking file currently opened for editing
SW-TLV-EN
2017-02-23
TLV commands
2-113
Adds a line with the assigned geometry to the marking file currently opened for editing
TAG
LENGTH
VALUE
Request "D1" + "D2" + "D3" + "D4" + "T"
Number of bytes in the TLV Value
D1:
X value of the start point of the line in mm
D2:
Y value of the start point of the line in mm
D3:
X value of the end point of the line in mm
D4:
Y value of the end point of the line in mm
T:
Name of the laser parameter for the line
Response "G1" + "G2"
20471
G1:
Number of bytes in the TLV Value
Æ Æ
2:
Æ
3:
Æ
G2:
Explanations - Laser parameter must be specified with the complete Parameter path (e.g. Aluminum\Marking). - If the assigned laser parameter is not available, then the "Standard" laser parameter will be used. Extended error code: •
Result of the TLV request:
0: 1:
Remark Conditions: - A marking file for editing must be opened (TLV commands "Generate marking file for editing" or "Load marking file for editing").
Command executed correctly Command could not be executed (see extended error code) Parameter VALUE is unknown Invalid TLV LENGTH of the request for the active communication interface
Is added on to the TLV Response when the result of the TLV request is "1".
Extended error code:
1:
Æ
2:
Æ
> 2:
Æ
No marking file has been opened for editing The marking file opened is corrupt Internal error
Table 2-177
Example: Add a line between the points X=2.5/Y=5 and X=4/Y=-3.2 to the marking file currently opened for editing, while utilizing the "Mark"laser parameter: Request
TAG
LENGTH
VALUE
20471
22
"2.5" + "5" + "4" + "3.2" + "Marking"
16 00 00 00
32 2E 35 00 35 00 34 00 33 2E 32 00 4D 61 72 6B 69 65 72 65 6E 00
F7 4F 00
00 Response
20471 F7 4F 00
00
"0"
2
30 00
02 00 00 00
Table 2-178
2-114
TLV commands
SW-TLV-EN
2017-02-23
6.22 Add an arc Adds an arc with the assigned geometry to the marking file currently opened for editing
TAG
LENGT H
VALUE
Request
"D1" + "D2" + "D3" + "D4" + "D5" + "D6" + "T"
Number of bytes in the TLV Value
D1:
X value of the midpoint of the arc in mm
D2:
Y value of the midpoint of the arc in mm
D3:
Radius of the arc in mm
D4:
Direction of rotation of the arc Æ Æ
0: 1:
Clockwise Counter-clockwise
D5:
Start angle of the arc in ° in the mathematical coordinate system
D6:
End angle of the arc in ° in the mathematical coordinate system
T:
Name of the laser parameter for the arc
20472 Response
Number of bytes in the TLV Value
Explanations - Laser parameter must be specified with the complete parameter path (e.g. Aluminum\Marking). - If the assigned laser parameter is not available, then the "Standard" laser parameter will be used.
•
Result of the TLV request:
0: 1:
Æ Æ
2:
Æ
3:
Æ
G2:
- A marking file for editing must be opened (TLV commands "Generate marking file for editing" or "Load marking file for editing").
Extended error code:
"G1" + "G2"
G1:
Remark Conditions:
Command executed correctly Command could not be executed (see extended error code) Parameter VALUE is unknown Invalid TLV LENGTH of the request for the active communication interface
Is added on to the TLV Response when the result of the TLV request is "1".
Extended error code:
1:
Æ
2:
Æ
> 2:
Æ
No marking file has been opened for editing The marking file opened is corrupt Internal error
Example: Add an arc to the marking file
Table 2-179
opened for editing with the midpoint X=2.5/Y=5, radius 4, in the angle range of 5.3° to 45.7° by using the "Mark" laser parameter: Request
TAG
LENGTH
VALUE
20472
27
"2.5" + "5" + "4" + "5.3" + "45.7" + "Marking"
1B 00 00 00
32 2E 35 00 35 00 34 00 35 2E 33 00 34 35 2E 37 00 4D 61 72 6B 69 65 72 65 6E 00
2
"0"
F8 4F 00
00 Response
20472 F8 4F 00
00
30 00
02 00 00 00
Table 2-180
SW-TLV-EN
2017-02-23
TLV commands
2-115
6.23 Add a circle Adds a circle with the assigned geometry to the marking file currently opened for editing
TAG
LENGTH
VALUE
Remark Conditions:
Request "D1" + "D2" + "D3" + "T"
Number of bytes in the TLV Value
D1:
X value of the midpoint of the circle in mm
D2:
Y value of the midpoint of the circle in mm
D3:
Radius of the circle in mm
T:
- A marking file for editing must be opened (TLV commands "Generate marking file for editing" or "Load marking file for editing"). Explanations - Laser parameter must be specified with the complete parameter path (e.g. Aluminum\Marking). - If the assigned laser parameter is not available, then the "Standard" laser parameter will be used.
Name of the laser parameter for the circle
Extended error code:
Response 20473 "G1" + "G2"
G1:
Number of bytes in the TLV Value
0: 1:
Æ Æ
2:
Æ
3:
Æ
G2:
•
Result of the TLV request: Command executed correctly Command could not be executed (see extended error code) Parameter VALUE is unknown Invalid TLV LENGTH of the request for the active communication interface
Is added on to the TLV Response when the result of the TLV request is "1".
Extended error code:
1:
Æ
2:
Æ
> 2:
Æ
No marking file has been opened for editing The marking file opened is corrupt Internal error Table 2-181
Example: Adding a circle to the marking file currently opened for editing with midpoint X=2.5/Y=5, radius 4, while utilizing the "Marking" laser parameter: Request
TAG
LENGTH
VALUE
20473
18
"2.5" + "5" + "4" + "Marking"
12 00 00 00
32 2E 35 00 35 00 34 00 4D 61 72 6B 69 65 72 65 6E 00
2
"0"
F9 4F 00
00 Response
20473 F9 4F 00
00
30 00
02 00 00 00
Table 2-182
2-116
TLV commands
SW-TLV-EN
2017-02-23
6.24 Add a rectangle Adds a rectangle with the assigned geometry to the marking file currently opened for editing
TAG
LENGTH
VALUE
Remark Conditions:
Request "D1" + "D2" + "D3" + "D4" + "D5" + "T"
Number of bytes in the TLV Value
D1:
X value of the lower left-hand corner of the rectangle in mm
D2:
Y value of the lower left-hand corner of the rectangle in mm
- A marking file for editing must be opened (TLV commands "Generate marking file for editing" or "Load marking file for editing").
D3:
Width of the rectangle in mm
D4:
Height of the rectangle in mm
D5:
Angle of rotation of the rectangle in °
T:
Name of the laser parameter for the rectangle
Explanations - Laser parameter must be specified with the complete parameter path (e.g. Aluminum\Marking). - If the assigned laser parameter is not available, then the
"Standard" laser parameter will be used. Response
20474
Extended error code: "G1" + "G2"
G1:
Number of bytes in the TLV Value
0: 1:
Æ Æ
2:
Æ
3:
Æ
G2:
•
Result of the TLV request: Command executed correctly Command could not be executed (see extended error code) Parameter VALUE is unknown Invalid TLV LENGTH of the request for the active communication interface
Is added on to the TLV Response when the result of the TLV request is "1".
Extended error code:
1:
Æ
2:
Æ
> 2:
Æ
No marking file has been opened for editing The marking file opened is corrupt Internal error Table 2-183
Example: Adding a rectangle to the marking file currently opened for editing with the lower left-hand point X=2.5/Y=5, width 10.25 and height 15, utilizing the "Marking" laser parameter: Request
Response
TAG
LENGTH
VALUE
20474
28
"2.5" + "5" + "10.25" + "15" + "10" + "Marking"
FA 4F 00 00
1C 00 00 00
32 2E 35 00 35 00 31 30 2E 32 35 00 31 35 00 31 30 00 4D 61 72 6B 69 65 72 65 6E 00
20474
2
"0"
02 00 00 00
30 00
FA 4F 00
00
Table 2-184
SW-TLV-EN
2017-02-23
TLV commands
2-117
6.25 Add a text Adds a text with the assigned geometry to the marking file currently opened for editing
TAG
LENGTH
VALUE
Remark Conditions:
Request "D1" + "D2" + "D3" + "D4" + "T1" + "T2" + "T3"
Number of bytes in the TLV Value
D1:
X value of the lower left-hand corner of the text in mm
D2:
Y value of the lower left-hand corner of the text in mm
D3:
Angle of rotation of the text in °
D4:
Text size in mm
T1:
Name of the font for the text
T2:
Text that should be added
T3:
Name of the laser parameter for the text
- A marking file for editing must be opened (TLV commands "Generate marking file for editing" or "Load marking file for editing"). Explanations - Laser parameter must be specified with the complete parameter path (e.g. Aluminum\Marking). - If the assigned laser parameter is not available, then the "Standard" laser parameter will be used.
Response 20475
Extended error code: "G1" + "G2"
G1:
Number of bytes in the TLV Value
Result of the TLV request:
0: 1:
Æ Æ
2:
Æ
3:
Æ
G2:
Command executed correctly Command could not be executed (see extended error code) Parameter VALUE is unknown Invalid TLV LENGTH of the request for the active communication interface
Is added on to the TLV Response when the result of the TLV Request is "1".
Extended error code:
1:
Æ
2:
Æ
> 2:
Æ
No marking file has been opened for editing The marking file opened is corrupt Internal error Table 2-185
Example: Add the "Text example" text to the marking file opened for editing with the lower left-hand point X=2.5/Y=5, the angle of rotation 45°, the text size 6, the "Standard" font, by using the "Marking" laser parameter:
Request
Response
TAG
LENGTH
VALUE
20475
43
FB 4F 00 00
15 00 00 00
20475
2
"2.5" + "5" + "45" + "6" + "Standard" + "Text example" + "Marking" 32 2E 35 00 35 00 34 35 00 36 00 54 65 78 74 62 65 69 73 70 69 65 6C 00 53 74 61 6E 64 61 72 64 00 4D 61 72 6B 69 65 72 65 6E 00 "0"
FB 4F 00 00
02 00 00 00
30 00 Table 2-186
2-118
TLV commands
SW-TLV-EN
2017-02-23
6.26 Add an expanded text Adds a text with the assigned expanded geometry to the marking file currently opened for editing
TAG
LENGTH
VALUE
Request "D1" + "D2" + "D3" + "D4" + "T1" + "T2" + "T3" + "D5" + "G1" + "G2" + "G3" + "G4" + "D6" + "D7" + "D8" + "D9" + "D10" + "G5" + "D11"
+ "D12" + "T4"
Number of bytes 20476 in the TLV Value
D1:
X value of the lower left-hand corner of the text in mm
D2:
Y value of the lower left-hand corner of the text in mm
D3:
Angle of rotation of the text in °
D4:
Text size in mm
T1:
Name of the font for the text
T2:
Text that should be added
T3:
Name of the laser parameter for the text
D5:
Italics text in ° (0-45)
G1:
Mirrored (0=no, 1=yes)
G2:
Horizontal text alignment
Remark Conditions: - A marking file for editing must be opened (TLV commands "Generate marking file for editing" or "Load marking file for editing"). Explanations - Laser parameter must be specified with the complete parameter path (e.g. Aluminum\Marking). - If the assigned laser parameter is not available, then the "Standard" laser parameter will be used.
0 = Left 1 = Centered 2 = Right 3 = Scaled G3:
Vertical text alignment
0 = Bottom 1 = Base line 2 = Centered 3 = Top G4:
Circular text (0=no, 1=yes)
D6:
Radius of the circularly displayed text
D7:
Position angle, where the circular text starts
D8:
Character width in percent Standard equivalent to 100% (1 equivalent to 100%)
D9:
Character spacing in percent Standard equivalent to 100% (1 equivalent to 100%)
D10:
Line spacing in mm (0 equivalent to 0 mm)
G5:
Height of the Text box
D12:
Width of the Text box
T4:
SW-TLV-EN
2017-02-23
Text box mode (0-4)
D11:
Comment regarding G5: No box (0) Break (1) Sign wrap (2) Cut (3) Fit (4)
Variable name of an existing variable
TLV commands
2-119
Adds a text with the assigned expanded geometry to the marking file currently opened for editing
TAG
LENGTH
VALUE
Remark Extended error code:
Response "G1" + "G2"
G1:
Number of bytes in the TLV Value
0: 1:
Æ Æ
2:
Æ
3:
Æ
G2:
•
Result of the TLV request: Command executed correctly Command could not be executed (see extended error code) Parameter VALUE is unknown Invalid TLV LENGTH of the request for the active communication interface
Is added on to the TLV Response when the result of the TLV request is "1".
Extended error code:
1:
Æ
2:
Æ
> 2:
Æ
No marking file has been opened for editing The marking file opened is corrupt Internal error Table 2-187
Example: Add the text "Text example" to the marking file currently opened for editing with the lower lefthand point X=2.5/Y=5, the angle of rotation 45°, the text size 6, the "Standard" font, by using the "Marking" laser parameter (see below for more values): Request
Response
TAG
LENGTH
VALUE
20476
70
FC 4F 00 00
46 00 00 00
20476
2
"2.5" + "5" + "45" + "6" + "Standard" + "Text example" + "Marking" + "0" + "0" + "0" + "0" + "0" + "0" + "0" + "1" + "1" + "1" + "0" + "0" + "0" + "" 32 2E 35 00 35 00 34 35 00 36 00 53 74 61 6E 64 61 72 64 00 54 65 78 74 62 65 69 73 70 69 65 6C 00 4D 61 72 6B 69 65 72 65 6E 00 30 00 30 00 30 00 30 00 30 00 30 00 30 00 31 00 31 00 31 00 30 00 30 00 30 00 00 "0"
FC 4F 00 00
02 00 00 00
30 00 Table 2-188
2-120
TLV commands
SW-TLV-EN
2017-02-23
6.27 Add a variable Adds a variable to the marking file currently opened for editing
TAG
LENGTH
VALUE
Request "T1" + "G1" + "T2" + "T3" + "T4" + "G2" + "G3" + "G4" + "G5" + "G6" + "G7"
T1:
Name of the new variable
G1:
Data source Æ Æ Æ Æ Æ Æ Æ
0: 1: 2: 3: 4: 5: 6:
T2:
Interactive File COM object Serial number Keyword Function call External source
Additional information
Depending on the data source parameter
Number of bytes in the TLV Value
Æ Æ Æ Æ Æ Æ Æ
0: 1: 2: 3: 4: 5: 6:
T3:
Request text for user Path Object name of COM object -Keyword DLL path --
Function name
Only with data source = 5 (function call)
20477
T4:
Bookmark/marking text
G2:
Number of characters
G3:
Start value
G4:
Increment
G5:
End value
G6:
Set flag Æ Æ Æ
1: 2: 4:
G7:
End value: start at the start value End value: output message Reset when calendar date changes
Remark Conditions: - A marking file for editing must be opened (TLV commands "Generate marking file for editing" or "Load marking file for editing"). Explanations - Laser parameter must be specified with the complete parameter path (e.g. Aluminum\Marking). - If the assigned laser parameter is not available, then the "Standard" laser parameter will be used. Explanation regarding G6: - The flags can also be added, e.g.: 7 all 3 flags (4+2+1) are set. Explanation regarding "decimal": Use fill character at the beginning as ASCII character "32-126". Do not place the number 0 in decimal, but rather the character 0 as ASCII code (decimal = 48 as default value!)
Fill character at the start as ASCII (decimal) Extended error code:
Response "G1" + "G2"
G1: Number of bytes in the TLV Value
Result of the TLV request:
0: 1:
Æ Æ
2: 3:
Æ Æ
G2: 10:
Command executed correctly Command could not be executed (see extended error code) Parameter VALUE is unknown Invalid TLV LENGTH of the request for the active communication interface
•
Is added on to the TLV Response when the result of the TLV request is "1".
Extended error code: Æ
Variable is already present in the variable list
Table 2-189
SW-TLV-EN
2017-02-23
TLV commands
2-121
Example: Add a "SERNO" serial number to the marking file opened for editing with the start value 100, increment 1 and end value 9999: Request
TAG
LENGTH
VALUE
20477
32
"SERNO" + "3" + "0" + "0" + "0" + "6" + "100" + "1" + "9999" + "2" + "48"
20 00 00 00
53 65 72 6E 6F 00 33 00 30 00 30 00 30 00 36 00 31 30 30 00 31 00 39 39 39 39 00 32 00 34 38 00
2
"0"
02 00 00 00
30 00
FD 4F 00
00 Response
20477 FD 4F 00
00
Table 2-190
6.28 Replace laser parameter Assigns the new laser parameter to all objects which had been assigned a particular laser parameter in the marking file currently opened for editing
TAG
LENGTH
VALUE
Request "T1" + "T2"
Number of bytes in the TLV Value
T1:
Name of the laser parameter to be found
T2:
New name of the laser parameter to be replaced
Remark Conditions: - A marking file for editing must be opened (TLV commands "Generate marking file for editing" or "Load marking file for editing"). Explanations - Laser parameter must be specified with the complete parameter path (e.g. Aluminum\Marking). Extended error code:
Response "G1" + "G2"
20478
G1:
Number of bytes in the TLV Value
Result of the TLV request:
0: 1:
Æ Æ
2:
Æ
3:
Æ
G2: 1: 2: 3:
Command executed correctly Command could not be executed (see extended error code) Parameter VALUE is unknown Invalid TLV LENGTH of the request for the active communication interface
•
Is added on to the TLV Response when the result of the TLV request is "1".
Extended error code: Æ Æ Æ
Old parameter no found New parameter not found No marking file has been opened for editing Table 2-191
2-122
TLV commands
SW-TLV-EN
2017-02-23
Example: Replace the laser parameter "Red" with "Blue": Request
TAG
LENGTH
VALUE
20478
09
"Red" + "Blue"
09 00 00 00
72 65 64 00 62 6C 75 65 00
2
"0"
02 00 00 00
30 00
FE 4F 00
00 Response
20478 FE 4F 00
00
Table 2-192
6.29 Replace fill parameter Assigns the new fill to all objects which had been assigned a particular fill in the marking file currently opened for editing
TAG
LENGTH
VALUE
Request "T1" + "T2"
T1:
Name of the fill
T2:
New fill for replacement
Remark Conditions: - A marking file for editing must be opened (TLV commands "Generate marking file for editing" or "Load marking file for editing"). Explanations - Laser parameter must be specified with the complete parameter path (e.g. Aluminum\Marking).
Number of bytes in the TLV Value
-Comment: This command also works with a text object with a dynamic fill. -Limitation: All fills that are in a group are not taken into consideration.
20479
Extended error code:
Response "G1" + "G2"
G1:
Number of bytes in the TLV Value
Result of the TLV request:
0: 1:
Æ Æ
2:
Æ
3:
Æ
G2: 1: 2: 3:
Command executed correctly Command could not be executed (see extended error code) Parameter VALUE is unknown Invalid TLV LENGTH of the request for the active communication interface
•
Is added on to the TLV Response when the result of the TLV request is "1".
Extended error code: Æ Æ Æ
Old fill not found New fill not found No marking file has been opened for editing Table 2-193
SW-TLV-EN
2017-02-23
TLV commands
2-123
Example: Replacing "Red" fill with "Blue": Request
TAG
LENGTH
VALUE
20479
9
"Red" + "Blue"
09 00 00 00
72 65 64 00 62 6C 75 65 00
2
"0"
02 00 00 00
30 00
FF 4F 00
00 Response
20479 FF 4F 00
00
Table 2-194
6.30 Initialize all variables Initializes all variables with an empty character string in the marking file currently opened for editing.
TAG
LENGTH
VALUE
0
No data
Request
Remark Conditions: - A marking file for editing must be opened (TLV commands "Generate marking file for editing" or "Load marking file for editing"). Explanations - Laser parameter must be specified with the complete parameter path (e.g. Aluminum\Marking).
Response
Extended error code:
20480
"G1" + "G2"
G1:
Number of bytes in the TLV Value
0: 1:
Æ Æ
2:
Æ
3:
Æ
G2: 1:
•
Result of the TLV request: Command executed correctly Command could not be executed (see extended error code) Parameter VALUE is unknown Invalid TLV LENGTH of the request for the active communication interface
Is added on to the TLV Response when the result of the TLV Request is "1".
Extended error code: Æ
No marking file has been opened for editing Table 2-195
Example: Request
Response
TAG
LENGTH
VALUE
20480
0
00 50 00 00
00 00 00 00
00
20480
2
"0"
00 50 00 00
02 00 00 00
30 00 Table 2-196
2-124
TLV commands
SW-TLV-EN
2017-02-23
6.31 Initialize variable Assigns a new standard value to a variable in the marking file currently opened for editing
TAG
LENGTH
VALUE
Remark Conditions:
Request "T1" + "T2"
Number of bytes in the TLV Value
T1:
Name of the variable
T2:
Value of the variable
- A marking file for editing must be opened (TLV commands "Generate marking file for editing" or "Load marking file for editing").
Extended error code:
Response "G1" + "G2"
G1:
20484 Number of bytes in the TLV Value
0: 1:
Æ Æ
2:
Æ
3:
Æ
G2: 1: 2:
•
Result of the TLV request: Command executed correctly Command could not be executed (see extended error code) Parameter VALUE is unknown Invalid TLV LENGTH of the request for the active communication interface
Is added on to the TLV Response when the result of the TLV request is "1".
Extended error code: Æ Æ
Variable not found No marking file has been opened for editing Table 2-197
Example: For the "Type" variable, set the default value "W4237": Request
TAG
LENGTH
VALUE
20484
10
"Type" + "W4237"
0A 00 00 00
54 79 70 00 57 34 32 33 37 00
2
"0"
02 00 00 00
30 00
FF 53 00
00 Response
20484 FF 53 00
00
Table 2-198
SW-TLV-EN
2017-02-23
TLV commands
2-125
6.32 Set laser parameters – properties Modifies the main characteristics of a laser parameter
TAG
LENGTH
VALUE
Remark Conditions:
Request "T1" + "D1" + "D2" + "D3" + "D4" + "D5" + "D6" + "G1" + "D7" + "G2" + "G3"
Number of bytes in the TLV Value
20481
T1:
Name of the laser parameter
D1:
Power in %
D2:
Speed in mm/s
D3:
Frequency in Hz
D4:
Track width in mm
D5:
Z offset in mm
D6:
Defocus in mm
G1:
Number of pulses
D7:
Pulse width in um
G2:
Head A (1/0)
G3:
Head B (1/0)
- A marking file for editing must be opened (TLV commands "Generate marking file for editing" or "Load marking file for editing"). Explanations - Laser parameter must be specified with the complete parameter path (e.g. Aluminum\Marking).
Extended error code:
Response "G1" + "G2"
G1:
Number of bytes in the TLV Value
0: 1:
Æ Æ
2:
Æ
3:
Æ
G2: 1: 2:
•
Result of the TLV request: Command executed correctly Command could not be executed (see extended error code) Parameter VALUE is unknown Invalid TLV LENGTH of the request for the active communication interface
Is added on to the TLV Response when the result of the TLV request is "1".
Extended error code: Æ Æ
Parameter not found No marking file has been opened for editing Table 2-199
Example: Set the properties of the laser parameter "red": Request
Response
TAG
LENGTH
VALUE
20481
37
01 50 00 00
25 00 00 00
20481
2
"red"+"80"+"3000"+"20000"+"0.08"+"1" "0.4"+"1"+"5"+"1"+"0" 72 65 64 00 38 30 00 33 30 30 30 00 32 30 30 30 30 00 30 2E 30 38 00 31 00 30 2E 34 00 31 00 35 00 31 00 30 00 "0"
01 50 00 00
02 00 00 00
30 00 Table 2-200
2-126
TLV commands
SW-TLV-EN
2017-02-23
6.33 Read laser parameter – Properties Calls up the main characteristics of a laser parameter
TAG
LENGTH
VALUE
Remark Conditions:
Request "T1"
Number of bytes in the TLV Value
T1:
Response
- A marking file for editing must be opened (TLV commands "Generate marking file for editing" or "Load marking file for editing").
Name of the laser parameter
"G1" + "D1" + "D2" + "D3" + "D4" + "D5" + "D6" + "G3" + "D7" + "G4" + "G5" + "G2"
G1:
20482
Æ Æ
2:
Æ
3:
Æ
D1:
Number of bytes in the TLV Value
Result of the TLV request:
0: 1:
Command executed correctly Command could not be executed (see extended error code) Parameter VALUE is unknown Invalid TLV LENGTH of the request for the active communication interface
•
Is added on to the TLV Response when the result of the TLV Request is "1".
Power in %
D2:
Speed in mm/s
D3:
Frequency in Hz
D4:
Track width in mm
D5:
Z offset in mm
D6:
Defocus in mm
G3:
Number of pulses
D7:
Pulse width in um
G4:
Head A (1/0)
G5:
Head B (1/0)
G2:
Extended error code:
1: 2:
Extended error code:
Æ Æ
Parameter not found No marking file has been opened for editing Table 2-201
Example: Read the properties for laser parameter "red": TAG Request
Response
LENGTH
VALUE
20482
4
"red"
02 50 00 00
04 00 00 00
20482
57
02 50 00 00
39 00 00 00
72 65 64 00 "0"+"70.000"+"400.000"+"30000.000"+"0.050"+"0.000"+"0.000"+"1" + "4.000"+"1"+"0" 30 00 37 30 2E 30 30 30 00 34 30 30 2E 30 30 30 00 33 30 30 30 30 2E 30 30 30 00 30 2E 30 35 30 00 30 2E 30 30 30 00 30 2E 30 30 30 00 31 00 34 2E 30 30 30 00 31 00 30 00 Table 2-202
SW-TLV-EN
2017-02-23
TLV commands
2-127
6.34 Hide blocks Hides certain CAD block objects in the marking file currently opened
TAG
LENGTH
VALUE
Remark Conditions:
Request "G1" + "T1" + "G2"
G1: Number of bytes in the TLV Value
Type of information
1:
Æ
2: 3:
Æ Æ
Binning – Info (col1;row1/col2;row2/…) Block name (block1/block2/..) Reject Map File (EO)
T1:
Info (see type) If empty, the last status is restored.
G2:
Initialize layer (1 = yes, 0 = no)
- A marking file for editing must be opened (TLV commands "Generate marking file for editing" or "Load marking file for editing"). The blocks that have already been hidden are displayed again G2 = 1
Extended error code:
Response "G1" + "G2"
G1: 20483
Number of bytes in the TLV Value
0: 1:
Æ Æ
2:
Æ
3:
Æ
G2:
•
Result of the TLV request: Command executed correctly Command could not be executed (see extended error code) Parameter VALUE is unknown Invalid TLV LENGTH of the request for the active communication interface
Is added on to the TLV Response when the result of the TLV Request is "1".
Extended error code:
1:
Æ
2: 3: 4:
Æ Æ Æ
5:
Æ
6:
Æ
Block / EO file could not be found Error in the length info Wrong info type Reject Map File could not be opened Error when reading the Reject Map File No marking file has been opened for editing Table 2-203
Example: Hiding blocks with EO – File 888888.bin: TAG Request
Response
LENGTH
VALUE
20483
15
"3" + "888888.bin" + "0"
03 50 00 00
0F 00 00 00
33 00 38 38 38 38 38 38 2E 62 69 6E 00 30 00
20483
02
"0"
03 50 00 00
02 00 00 00
30 00 Table 2-204
2-128
TLV commands
SW-TLV-EN
2017-02-23
6.35 Add a Bitmaps (as of TruTops Mark 2.5.3) Adds a bitmap with the assigned geometry to the marking file currently opened for editing TAG
LENGTH
VALUE
Remark
Request "D1" + "D2" + "D3" + "D4" + "D5" + "D6" + "D7" + "T1" + "T2"
Number of bytes in the TLV Value
D1:
X-value of image center in mm
D2:
Y-value of image center in mm
D3:
Image width in mm
D4:
Image height in mm
D5:
Image angle
D6:
X-resolution in dpi
D7:
Y-resolution in dpi Name of the laser parameter for the bitmap Path (+name) of the bitmap file
T1: T2:
Response
Conditions: - A marking file for editing must be opened (TLV commands "Generate marking file for editing" or "Load marking file for editing"). Explanations - Laser parameter must be specified with the complete Parameter path (e.g. Aluminum\Marking). - If the assigned laser parameter is not available, then the "Standard" laser parameter will be used.
"G1" + "G2" G1: 20485
Number of bytes in the TLV Value
Result of the TLV request:
0: 1:
Æ Æ
2: 3:
Æ Æ
G2:
Extended error code for TruMark:
1:
Æ
2:
Æ
3: 4:
5:
Command executed correctly Command could not be executed (see extended error code) Parameter VALUE is unknown Invalid TLV LENGTH of the request for the active communication interface
No marking file has been opened for editing The marking file opened is corrupt Bitmap not available Height or width of the bitmap is zero. The formats: JPG, TIF and PCX have no height and width stored in the format. Bitmap cannot be read in
Extended error code: - Only supported from TruMark onwards. - Is added on to the TLV Response when the result of the TLV request is "1".
Table 2-205
SW-TLV-EN
2017-02-23
TLV commands
2-129
Example: Add a bitmap to the marking file currently opened for editing using the "Mark"laser parameter: Request
Response
TAG
LENGTH
VALUE
20485
48
"100.0" + "100.0" + "0" + "300" "300" + "Mark" + "C:\serial.bmp"
05 50 00 00
16 00 00 00
31 30 00 31 30 00 31 30 30 00 31 30 30 00 30 00 33 30 30 00 33 30 30 00 4D 61 72 6B 69 65 72 65 6E 00 63 3A 5C 73 65 72 69 61 6C 2E 62 6D 70 00
20485
2
"0"
05 50 00 00
02 00 00 00
30 00
Table 2-206
6.36 Close the TruCad Server Breaks the connection to the TruCad Server and removes this program from the program memory. The command "Close the TruCad Server" will release the memory range used once more. Closes the TruCad Server
TAG
LENGTH
VALUE
0
No data
Request
Remark
Response
Comment:
"G1" + "G2"
G1:
20486
Number of bytes in the TLV Value
Result of the TLV request:
0: 1:
Æ Æ
3:
Æ
G2: 0:
Command executed correctly Command could not be executed Invalid TLV LENGTH of the request for the active communication interface
Recommendation: Execute this command regularly!
Extended error code: Æ
The TruCad Server does not enable all of the memory range again.
No extended FC
Table 2-207
Example: Close the TruCad Server Request Response
TAG
LENGTH
VALUE
20486
0
No data
06 50 00 00
00 00 00 00
20486
2
"0"
06 50 00 00
02 00 00 00
30 00
Table 2-208
2-130
TLV commands
SW-TLV-EN
2017-02-23
6.37 Adding a polyline Adds a line with the assigned geometry to the marking file currently opened for editing
TAG
LENGTH
VALUE
Request "D1" + "T1" + "T2" + "T3" + "T4"
D1: T1:
FLAG
Base values of the polygon in the format "S=2;x0,y0;x1y1;…;xi,yi;E=0;x,y ….xiyi;" S
20487
SW-TLV-EN
Number of bytes in the TLV Value
2017-02-23
Not used
0
Straight lines
2
B spline
4
By the calibration points
E
Not used
Remark Conditions: - A marking file for editing must be opened (TLV commands "Generate marking file for Editing" or "Load marking file for editing"). Explanations - Laser parameter must be specified with the complete Parameter path (e.g. Aluminum\Marking). - If the assigned laser parameter is not available, then the "Standard" laser parameter will be used. Polygon consists of calibration points in the format: x.xxx,y.yyy
T2:
Name of the laser parameter for the polyline
T3:
Name of the filling for a closed polygon
T4:
Name of the layer for the polyline
TLV commands
Ellipse arc consists of: Center: x,y Main axis angle: x.xx Start angle: x.xx End angle: x.xx Main radius: x.xx Second radius: x.xx Direction: x
2-131
Adds a line with the assigned geometry to the marking file currently opened for editing
Extended error code:
Response "G1" + "G2"
G1:
Number of bytes in the TLV Value
0: 1:
Æ Æ
2:
Æ
3:
Æ
G2:
•
Result of the TLV request: Command executed correctly Command could not be executed (see extended error code) Parameter VALUE is unknown Invalid TLV LENGTH of the request for the active communication interface
Is added on to the TLV Response when the result of the TLV request is "1".
Extended error code:
1:
Æ
2:
Æ
3: 4: 5: 6: 7:
Æ Æ Æ Æ Æ
No marking file has been opened for editing The marking file opened is corrupt Level does not exist Flag value not valid Fill does not exist Polyline not closed Ellipse arc could not be added
Table 2-209
Example: Insert a B spline and an ellipse arc in the marking file opened for editing. Using the laser parameter "Green", the fill "Fill 0.05" and the level "Standard". TAG
LENGTH
Request
20487
186
VALUE
"7" + "S=0;20.019,96.714;19.614,104.992;9.788,102.071;1.373,107.249;5.273, 104.859;6.601,96.096;12.339,93.279; E=1;18.286,93.440;155.225;45.476;268.480;7.605;3.700;0;" + " green " + "Fill 0.05" + "Standard"
Response
37 00 53 3D 30 3B 32 30 2E 30 31 39 2C 39 36 2E 37 31 34 3B 31 39 2E 36 31 34 2C 31 30 34 2E 39 39 32 3B 39 2E 37 38 38 2C 31 30 32 2E 30 37 31 3B 31 33 2E 33 37 33 2C 31 30 37 2E 32 34 39 3B 35 2E 32 37 33 2C 31 30 34 2E 38 35 39 3B 36 2E 36 30 31 2C 39 36 2E 30 39 36 3B 31 32 2E 33 33 39 2C 39 33 2E 32 37 39 3B 45 3D 31 3B 31 38 2E 32 38 36 2C 39 33 2E 34 34 30 3B 31 35 35 2E 32 32 35 3B 34 35 2E 34 37 36 3B 32 36 38 2E 34 38 30 3B 37 2E 36 30 35 3B 33 2E 37 30 30 3B 30 3B 00 67 72 65 65 6E 00 46 69 6C 6C 20 30 2E 30 35 00 53 74 61 6E 64 61 72 64 00
07 50 00 00
16 00 00 00
20487
2
"0"
07 50 00 00
02 00 00 00
30 00
Table 2-210
2-132
TLV commands
SW-TLV-EN
2017-02-23
6.38 Adding an ellipse Adds a line with the assigned geometry to the marking file currently opened for editing
TAG
LENGTH
VALUE
Request "D1" + "D2" + "D3" + "D4" + "D5" + "T1" + "T2" + "T3"
Number of bytes in the TLV Value
D1:
X coordinate of the center of the ellipse
D2:
Y coordinate of the center of ellipse
D3:
Angle of the main axis to the horizontal
D4:
Length of the main axis
D5:
Length of the secondary axis
T1:
Name of the laser parameter for the polyline
T3:
Name of the filling for an ellipse
T4:
Layer name of the ellipse
Remark Conditions: - A marking file for editing must be opened (TLV commands "Generate marking file for editing" or "Load marking file for editing"). Explanations - Laser parameter must be specified with the complete Parameter path (e.g. Aluminum\Marking). - If the assigned laser parameter is not available, then the "Standard" laser parameter will be used. Extended error code:
Response "G1" + "G2"
G1:
20488
Number of bytes in the TLV Value
Result of the TLV request:
0: 1:
Æ Æ
2:
Æ
3:
Æ
G2:
Command executed correctly Command could not be executed (see extended error code) Parameter VALUE is unknown Invalid TLV LENGTH of the request for the active communication interface
•
Is added on to the TLV Response when the result of the TLV request is "1".
Extended error code:
1:
Æ
2:
Æ
3: 4:
Æ Æ
5:
Æ
No marking file has been opened for editing The marking file opened is corrupt Level does not exist Parameter D4 and D5 are less than 0.1 mm Fill does not exist
Table 2-211
SW-TLV-EN
2017-02-23
TLV commands
2-133
Example: Insert an ellipse in the marking file opened for editing. Which is defined by the center x=30/y=30, the main radius = 25.5, the second radius = 9.5 and the angle to the horizontal = 10°, using the laser parameter "Mark", the fill "Fill 0.05" and the level "Standard". Request
Response
TAG
LENGTH
VALUE
20488
47
"30" + "30" + "25.5" +" 9.5" + "10" + "Marking" + "Fill 0.05" + "Standard"
08 50 00 00
16 00 00 00
33 30 00 33 30 00 32 35 3B 35 00 39 3B 35 00 31 32 00 4D 61 72 6B 69 65 72 65 6E 00 46 69 6C 6C 20 30 2E 30 35 00 53 74 61 6E 64 61 72 64 00
20488
2
"0"
08 50 00 00
02 00 00 00
30 00
Table 2-212
2-134
TLV commands
SW-TLV-EN
2017-02-23
6.39 Adding an ellipse arc Adds a line with the assigned geometry to the marking file currently opened for editing
TAG
LENGTH
VALUE
Request "D1" + "D2" + "D3" + "D4" + "D5" + "D6" + "D7" + "D8" + "D9" + "T1" + "T2"
Number of bytes in the TLV Value
20489
D1:
X coordinate of the center of the ellipse
D2:
Y coordinate of the center of ellipse
D3:
Length of the main axis
D4:
Length of the secondary axis
D5:
Direction of the elliptical arc 0=Clockwise 1=Counterclockwise
D6:
X coordinate of the starting point
D7:
Y coordinate of the starting point.
D8:
X coordinate of the end point
D9:
Y coordinate of the end point.
T1:
Name of the laser parameter for the polyline
T2:
Layer name of the ellipse
Remark Conditions: - A marking file for editing must be opened (TLV commands "Generate marking file for editing" or "Load marking file for editing"). Explanations - Laser parameter must be specified with the complete Parameter path (e.g. Aluminum\Marking). - If the assigned laser parameter is not available, then the "Standard" laser parameter will be used.
Extended error code:
Response "G1" + "G2"
G1:
Number of bytes in the TLV Value
Result of the TLV request:
0: 1:
Æ Æ
2:
Æ
3:
Æ
G2:
Command executed correctly Command could not be executed (see extended error code) Parameter VALUE is unknown Invalid TLV LENGTH of the request for the active communication interface
•
Is added on to the TLV Response when the result of the TLV request is "1".
Extended error code:
1:
Æ
2:
Æ
3: 4:
Æ Æ
No marking file has been opened for editing The marking file opened is corrupt Level does not exist Parameter D4 and D5 are less than 0.1 mm
Table 2-213
SW-TLV-EN
2017-02-23
TLV commands
2-135
Example: Insert an ellipse arc in the marking file opened for editing. Which is defined by the center x=60.3/y=69.1, the main radius = 9.6, the second radius = 6.6, the direction of rotation = 0, the starting point x=51.4/y=70.7 and the end point x=68.5/y=66.4, using the laser parameter "Mark" and the level "Standard". TAG Request
Response
LENGTH
VALUE
20489
55
"60.3" + "69.1" + "9.6" +" 6.6" + "0" + "51.4" + "70.7" + "68.5" +" 66.4" + "Marking" + "Standard"
09 50 00 00
16 00 00 00
36 30 3B 33 00 36 39 3B 31 00 39 3B 36 00 30 00 35 31 3B 34 00 37 30 3B 37 00 36 38 3B 35 0036 36 3B 34 00 4D 61 72 6B 69 65 72 65 6E 00 53 74 61 6E 64 61 72 64 00
20489
2
"0"
09 50 00 00
02 00 00 00
30
0
Table 2-214
2-136
TLV commands
SW-TLV-EN
2017-02-23
6.40 Copying a file Adds a line with the assigned geometry to the marking file currently opened for editing
TAG
LENGTH
VALUE
Remark
Request Number of bytes in the TLV Value
"T1" + "T2"
T1:
Name and path of the file to be copied
T2:
Name and path of the location where the file will be copied Extended error code:
Response "G1" + "G2"
G1: 20490 Number of bytes in the TLV Value
0: 1:
Æ Æ
2:
Æ
3:
Æ
G2: 1
•
Result of the TLV request: Command executed correctly Command could not be executed (see extended error code) Parameter VALUE is unknown Invalid TLV LENGTH of the request for the active communication interface
Is added on to the TLV Response when the result of the TLV request is "1".
Extended error code: Æ
File could not be copied
Table 2-215
Example: Copies the file "c:\Temp\example.txt" to "c:\data\example.txt". Request
TAG
LENGTH
VALUE
20490
43
"c:\temp\example.txt" + "c:\data\example1.txt"
0A 50 00 00 Response
63 3A 5C 74 65 6D 70 5C 62 65 69 73 70 69 64 6C 2E 74 78 74 00 63 3A 16 00 00 00 5C 64 61 74 65 6E 5C 62 65 69 73 70 69 64 6C 2E 74 78 74 00
20490
2
"0"
0A 50 00 00
02 00 00 00
30 00
Table 2-216
SW-TLV-EN
2017-02-23
TLV commands
2-137
6.41 Starts the adding of an assembled geometry object Adds a complex object of the transferred geometry to the marking file currently opened for editing
TAG
LENGTH
VALUE
Request "T1" + "T2"+ "T3"
T1:
Name of the laser parameter
T2:
Name of the fill
T3:
Name of layer
Remark Conditions: - A marking file for editing must be opened (TLV commands "Generate marking file for editing" or "Load marking file for editing"). Explanations - Laser parameter must be specified with the complete Parameter path (e.g. Aluminum\Marking). - If the assigned laser parameter is not available, then the "Standard" laser parameter will be used.
Number of bytes in the TLV Value
With an assembled geometry object the commands 20494, 20495 and 20496 must always be sent in this sequence in order that the object can be fully created.
20494
Extended error code:
Response "G1" + "G2"
G1:
Number of bytes in the TLV Value
Result of the TLV request:
0: 1:
Æ Æ
2:
Æ
3:
Æ
G2:
Command executed correctly Command could not be executed (see extended error code) Parameter VALUE is unknown Invalid TLV LENGTH of the request for the active communication interface
•
Is added on to the TLV Response when the result of the TLV request is "1".
Extended error code:
1 2
Æ Æ
3 4 5
Æ Æ Æ
Target file not opened Target file does not show correct marking file. Layers do not exist Fill does not exist Last complex object not completed
Table 2-217
Example: Starts the processing of a complex object with the laser parameter, fill and layer
2-138
TLV commands
SW-TLV-EN
2017-02-23
Request
TAG
LENGTH
20494
25
"green" + "Fill 0.05" + "Standard"
16 00 00 00
67 72 65 65 6E 00 46 69 6C 6C 20 30 2E 30 35 00 53 74 61 6E 64 61 72 64 00
0A 50 00 00 Response
VALUE
20494
2
"0"
0A 50 00 00
02 00 00 00
30 00
Table 2-218
6.42 Add an assembled geometry object to a polyline Adds a complex object of the transferred geometry to the marking file currently opened for editing
TAG
LENGTH
VALUE
Request "D1" + "D2"+ "T3"
D1:
Mode FLAG
20495
Number of bytes in the TLV Value
D2:
Outer polygon
2
Extend outer polygon
3
Outer polygon
4
Extend inner polygon
Flag FLAG
T3:
1
2
B spline
4
Through base values for B spline
0
Polyline (straight lines)
Remark
With an assembled geometry object the commands 20494, 20495 and 20496 must always be sent in this sequence in order that the object can be fully created. The command 20495 can be sent multiple times in succession. It must always be commenced with the outer polygon
GeometryList Base values of the polygon in the format "x0,y0;x1y1;…;xi,yi;"
SW-TLV-EN
2017-02-23
TLV commands
2-139
Adds a complex object of the transferred geometry to the marking file currently opened for editing
Extended error code:
Response "G1" + "G2"
G1:
Number of bytes in the TLV Value
0: 1:
Æ Æ
2:
Æ
3:
Æ
G2: 1 2 3
•
Result of the TLV request: Command executed correctly Command could not be executed (see extended error code) Parameter VALUE is unknown Invalid TLV LENGTH of the request for the active communication interface
Is added on to the TLV Response when the result of the TLV request is "1".
Extended error code: Æ Æ Æ
Mode not defined Flag not defined Processing of a complex object not started Table 2-219
Example: Creates a B spline with an island that also consists of a B spline Request
Response
TAG
LENGTH
VALUE
20495
47
"1" + "" + "42,63;59,67;69,56;58,37;36,45;34,59;42,63;"
0A 50 00 00
16 00 00 00
31 00 32 00 34 32 2C 36 33 3B 35 39 2C 36 37 3B 36 39 2C 35 36 3B 35 38 2C 33 37 3B 33 36 2C 34 35 3B 33 34 2C 35 39 3B 34 32 2C 36 33 3B 00
20495
2
"0"
02 00 00 00
30 00
0A 50 00 00
Table 2-220
Request
Response
TAG
LENGTH
VALUE
20495
47
"3" + "2" + "45,55;55,59;57,51;52,45;42,48;44,53;45,55;"
0A 50 00 00
16 00 00 00
33 00 32 00 34 35 2C 35 35 3B 35 35 2C 35 39 3B 35 37 2C 35 31 3B 35 32 2C 34 35 3B 34 32 2C 34 38 3B 34 34 2C 35 33 3B 34 35 2C 35 35 3B 00
20495
2
"0"
0A 50 00 00
02 00 00 00
30 00
Table 2-221
2-140
TLV commands
SW-TLV-EN
2017-02-23
6.43 Closes the editing of an assembled geometry object Adds a complex object of the transferred geometry to the marking file currently opened for editing
TAG
LENGTH
VALUE
Remark
With an assembled geometry object the commands 20494, 20495 and 20496 must always be sent in this sequence in order that the object can be fully created.
Request Number of bytes in the TLV Value
Extended error code:
Response "G1" + "G2"
G1:
20496
Number of bytes in the TLV Value
0: 1:
Æ Æ
2:
Æ
3:
Æ
G2: 1
•
Result of the TLV request: Command executed correctly Command could not be executed (see extended error code) Parameter VALUE is unknown Invalid TLV LENGTH of the request for the active communication interface
Is added on to the TLV Response when the result of the TLV request is "1".
Extended error code: Æ
The editing of an assembled geometry object was not started or no geometry was added to the object. This means that the command 20494 or 20495 was called up beforehand.
Table 2-222
Example: Exit editing of an assembled geometry object. Request
Response
TAG
LENGTH
VALUE
20496
0
0A 50 00 00
16 00 00 00
20496
2
"0"
0A 50 00 00
02 00 00 00
30 00
Table 2-223
SW-TLV-EN
2017-02-23
TLV commands
2-141
7.
Unicode TLV commands
7.1
Set variable with Unicode data
Sets the content of the assigning variables TAG
LENGTH
VALUE
Request " TN1" + "TV1" + ("TN2" + "TV3") +…+ ("TNn" + "TVn")
TN1:
Identifier of variable 1
TV1:
Content of variable 1
TN2:
Identifier of variable 2
TV2:
Content of variable 2
TNn:
Identifier of variable n
TVn:
Content of variable n
The following conditions must be fulfilled: Marking file with variable must be loaded The variable must be assigned a text object as a display object Identification and content always in pairs; it is also true that only one variable can be set Limitations: The variable identifier may not use characters that are not included in the ASCII character set. Unicode characters are introduced with \u and closed with semicolon (;). Multiple Unicode characters are transferred separately (see Example 3). Barcode display objects cannot process any Unicode data. - Data matrix – with control character: ~dnnn nnn = ASCII – decimal value
Number of bytes 20501 in the TLV Value
2-142
Remark
TLV commands
SW-TLV-EN
2017-02-23
Sets the content of the assigning variables Extended error code:
Response "G1" + "G2"
G1:
Number of bytes in the TLV Value
Result of the TLV request:
0: 1:
Æ Æ
2:
Æ
3:
Æ
G2:
Command executed correctly Command could not be executed (see extended error code) Parameter VALUE is unknown Invalid TLV LENGTH of the request for the active communication interface
•
Is added on to the TLV Response when the result of the TLV Request is "1".
Extended error code:
1:
Æ
2: > 2:
Æ Æ
No variable exists with the assigned ID No marking file is loaded Internal error
Table 2-224
SW-TLV-EN
2017-02-23
TLV commands
2-143
Example 1: Set the content of the "VAR_4" to "Test text" Request
Response
TAG
LENGTH
VALUE
20501
30
"VAR_4" + "Testtext"
15 50 00 00
1E 00 00 00
56 00 41 00 52 00 5F 00 34 00 00 00 54 00 65 00 73 00 74 00 74 00 65 00 78 00 74 00 00 00
20501
4
"0"
15 50 00 00
04 00 00 00
30 00 00 00 Table 2-225
Example 2: Set the content of the variables "V1" to "0" and "V2" to "AB[cr][lf]C" (only applies to the data matrix code) Request
Response
TAG
LENGTH
VALUE
20501
42
"V1" + "0" + "V2" + "AB~d013~d010C"
15 50 00 00
2A 00 00 00
56 00 31 00 00 00 30 00 56 00 32 00 00 00 41 00 42 00 7E 00 64 00 30 00 31 00 33 00 7E 00 64 00 30 00 31 00 30 00 43 00 00 00
20501
2
"0"
15 50 00 00
02 00 00 00
30 00
Table 2-226
[cr] [lf]
= Carriage return (line break) = Line feed
Example 3: Set the content of the variables "VAR01" to "This is a CJK Unified Ideograph: 慸慷" Request
TAG
LENGTH
VALUE
20501
94
"VAR01" + "This is a CJK Unified Ideograph: \u0x6178; \u0x6177"
15 50 00 00 Response
56 00 41 00 52 00 30 00 31 00 00 00 44 00 69 00 65 00 73 00 20 00 69 00 73 00 74 00 20 00 65 00 69 00 6E 00 20 00 43 00 4A 00 4B 00 20 00 55 00 6E 5E 00 00 00 00 69 00 66 00 69 00 65 00 64 00 20 00 49 00 64 00 65 00 6F 00 67 00 72 00 61 00 70 00 68 00 3A 00 20 00 78 61 20 00 77 61 20 00 00 00
20501
2
"0"
15 50 00 00
02 00 00 00
30 00
Table 2-227
2-144
[慸]
= 0x6178
[慷]
= 0x6177
TLV commands
SW-TLV-EN
2017-02-23
7.2
Read variable with Unicode data
Reads the content of the assigned variable TAG
LENGTH
VALUE
Remark The following conditions must be fulfilled: Marking file with variable must be loaded The variable must be assigned a text object as a display object
Request "T"
T:
Identifier of the variable
Number of bytes in the TLV Value
Response
Limitations: The identification of the variables is not permitted to use characters that are not included in the ASCII character set Barcode display objects cannot process any Unicode data Extended error code:
"G1" + "T" + "G2"
20502
G1:
Number of bytes in the TLV Value
Result of the TLV request:
0: 1:
Æ Æ
2:
Æ
3:
Æ
4:
Æ
T:
Content of the variable
G2:
Extended error code:
1:
Æ
2: > 2:
Æ Æ
•
Command executed correctly Command could not be executed (see extended error code) Parameter VALUE is unknown Invalid TLV LENGTH of the request for the active communication interface Invalid TLV LENGTH of the response for the active communication interface
•
Is added on to the TLV Response when the result of the TLV request is "1".
No variable exists with the assigned ID No marking file is loaded Internal error Table 2-228
Example: Read variable "VAR_4" with "Testtext" Request Response
TAG
LENGTH
VALUE
20502 16 50 00 00 20502 16 50 00 00
12 0C 00 00 00 22 16 00 00 00
"VAR_4" 56 00 41 00 52 00 5F 00 34 00 00 00 "Testtext" + "0" 54 00 65 00 73 00 74 00 74 00 65 00 78 00 74 00 00 00 30 00 00 00 Table 2-229
SW-TLV-EN
2017-02-23
TLV commands
2-145
7.3
Initialize variable with Unicode data (from TruTops Mark 2.9)
Assigns a new standard value to a variable in the marking file currently opened for editing
TAG
LENGTH
VALUE
Request " T1" + "T2"
T1:
Name of the variable
T2:
Default value of the variable
Number of bytes in the TLV Value
20503
Remark The following conditions must be fulfilled: A marking file must be open for editing (TLV command "Generate marking file for editing" or "Load marking file for editing"). Limitations: The variable identifier may not use characters that are not included in the ASCII character set. Unicode characters are introduced with \u and closed with semicolon (;). Multiple Unicode characters are transferred separately (see Example 2). Barcode display objects cannot process any Unicode data. - Data matrix – with control character: ~dnnn nnn = ASCII – decimal value Extended error code:
Response "G1" + "G2"
G1:
Number of bytes in the TLV Value
Result of the TLV request:
0: 1:
Æ Æ
2:
Æ
3:
Æ
G2:
Command executed correctly Command could not be executed (see extended error code) Parameter VALUE is unknown Invalid TLV LENGTH of the request for the active communication interface
•
Is added on to the TLV Response when the result of the TLV Request is "1".
Extended error code:
1: 2:
Æ Æ
> 2:
Æ
Variable not found No marking file has been opened for editing Internal error
Table 2-230
2-146
TLV commands
SW-TLV-EN
2017-02-23
Example 1: For the variable "VAR_4", set the default value to "Testtext" Request
Response
TAG
LENGTH
VALUE
20503
30
"VAR_4" + "Testtext"
17 50 00 00
1E 00 00 00
56 00 41 00 52 00 5F 00 34 00 00 00 54 00 65 00 73 00 74 00 74 00 65 00 78 00 74 00 00 00
20503
4
"0"
17 50 00 00
04 00 00 00
30 00 00 00 Table 2-231
Example 2: For the variable "VAR01", set the default value to "This is a CJK Unified Ideograph: 慸慷" Request
TAG
LENGTH
VALUE
20503
94
"VAR01" + "This is a CJK Unified Ideograph: \u0x6178; \u0x6177"
17 50 00 00 Response
56 00 41 00 52 00 30 00 31 00 00 00 44 00 69 00 65 00 73 00 20 00 69 00 73 00 74 00 20 00 65 00 69 00 6E 00 20 00 43 00 4A 00 4B 00 20 00 55 00 6E 5E 00 00 00 00 69 00 66 00 69 00 65 00 64 00 20 00 49 00 64 00 65 00 6F 00 67 00 72 00 61 00 70 00 68 00 3A 00 20 00 78 61 20 00 77 61 20 00 00 00
20503
2
"0"
17 50 00 00
02 00 00 00
30 00
Table 2-232
SW-TLV-EN
2017-02-23
[慸]
= 0x6178
[慷]
= 0x6177
TLV commands
2-147
8.
Additional TLV commands
8.1
External program
Starts the assigned program .exe with the assigned parameter string TAG
LENGTH
VALUE
Remark
Request "T1" + "T2" + "G"
Number of bytes in the TLV Value
T1:
Name of the program to be started
T2:
String with the call-up parameters for the program
G:
Command execution mode
0:
Æ
1:
Æ
Start the program without waiting for the end Start the program and wait for the end
The following conditions must be fulfilled: The program to be started must be available on the control system PC and correctly installed. The program name must be specified, together with the directory. Explanations
•
Response
If no call-up parameters are used, then an empty string must be assigned for this purpose (see Example). Extended error code:
20601 "G1" + "G2"
G1:
Number of bytes in the TLV Value
0: 1:
Æ Æ
2:
Æ
3:
Æ
G2:
•
Result of the TLV request: Command executed correctly Command could not be executed (see extended error code) Parameter VALUE is unknown Invalid TLV LENGTH of the request for the active communication interface
Is added on to the TLV Response when the result of the TLV Request is "1".
Extended error code:
1: 2:
Æ Æ
> 2:
Æ
Program does not exist Program could not be started Internal error Table 2-233
Example: Start TruTops Mark® ErrorViewer and wait till the program has been ended Request
TAG
LENGTH
VALUE
20601
44
"c:\TruMark\Fehleranzeige\ErrorViewer.exe" + " " + "1" 63 3A 5C 54 72 75 4D 61 72 6B 5C 46 65 68 6C 65 72 61 6E 7A 65 69 67 65 5C 45 72 72 6F 72 56 69 65 77 65 72 2E 65 78 65 00 00 31 00 "0" 30 00
79 50 00 00 2C 00 00 00 Response
20601 2 79 50 00 00 02 00 00 00
Table 2-234
2-148
TLV commands
SW-TLV-EN
2017-02-23
8.2
DLL function
Executes the assigned function of the DLL specified TAG
LENGTH
VALUE
Request "T1" + "T2" + "T3" + "T4" + "G"
T1:
Name of the DLL
T2:
Name of the DLL function
T3:
Call-up parameter 1 of the DLL function
T4:
Call-up parameter 2 of the DLL function
G: 0: 1:
Return type of the DLL function Æ Æ
Without return parameter With return parameter
Number of bytes in the TLV Value
Remark The following conditions must be fulfilled: The DLL must be available on the control system PC. The DLL name must be specified, together with the directory. A function with the corresponding declaration must be available:
20602
extern "C" __declspec(dllexport) void F1(char* in1, char *in2) extern "C" __declspec(dllexport) void F1(char* in, char *out) extern "C" __declspec(dllexport) void F2(char* in) extern "C" __declspec(dllexport) void F3(char *out) extern "C" __declspec(dllexport) void F4(void)
Explanations
•
Response
"G1" + "T" + "G2"
G1:
Number of bytes in the TLV Value
Result of the TLV request:
0: 1:
Æ Æ
2:
Æ
3:
Æ
T: G2: 1: 2: 3: > 3:
Command executed correctly Command could not be executed (see extended error code) Parameter VALUE is unknown Invalid TLV LENGTH of the request for the active communication interface
If no call-up parameters are used, then empty strings must be used for this purpose (see Example). Extended error code:
Is added on to the TLV Response when the result of the TLV Request is "1".
Explanations If the DLL function has no return parameter, then an empty string will be returned in its place.
Return parameter of the DLL function Extended error code: Æ Æ Æ Æ
DLL does not exist DLL could not be loaded DLL function does not exist Internal error Table 2-235
SW-TLV-EN
2017-02-23
TLV commands
2-149
Example: Executing DLL function "DEZ_TO_BIN" from the "Tool.Dll". Request
Response
TAG
LENGTH
VALUE
20602
45
7A 50 00
2D 00 00 00
20602 7A 50 00
11 0B 00 00 00
"c:\QuickFlow\Tool_Dll.Dll" + "_DEZ_TO_BIN" + "202" + " " + "1" 63 3A 5C 51 75 69 63 6B 46 6C 6F 77 5C 54 6F 6F 6C 5F 44 6C 6C 2E 44 6C 6C 00 5F 44 45 5A 5F 54 4F 5F 42 49 4E 00 32 30 32 00 00 31 00 "0" + "11001010" 30 00 31 31 30 30 31 30 31 30 00 Table 2-236
8.3
Start laser calibration (LPC) or cancel (from TTM 2.7)
Start laser calibration or cancel
TAG Request
LENGTH
VALUE
Remark The following conditions must be fulfilled:
2 "G1"
G1:
Status of the laser:
0:
Æ
Cancel LPC
1:
Æ
Start LPC
1. No marking process is allowed to be active. 2. No external trigger signal is allowed to be pending (Beam ON, Beam OFF). 3. The ESU must be initialized (safety circuit must be closed for at least 10 seconds). The customer control software can start or cancel the LPC by setting the LPC status parameter.
20603
Digital interfaces are not operated while the LPC is running. Comment 1: The following firmware is required for the TM6000: CIP release from version V2090 CLH release from version 2080 V0080 Comment 2: For the TM3000/TM5000 The following firmware is required: CMU_1070
2-150
TLV commands
SW-TLV-EN
2017-02-23
Start laser calibration or cancel
Extended error code:
Response "G1" + "G2"
G1:
Number of bytes in the TLV Value
•
Result of the TLV request:
0:
Æ
Command executed correctly
1:
Æ
Command could not be executed (see extended error code)
2:
Æ
Erroneous TLV VALUE
3:
Æ
Invalid TLV LENGTH of the request for the active communication interface
G2:
Extended error code:
0:
Æ
OK
1:
Æ
LPC option not enabled
> 1:
Æ
Internal error
Example: Switching on the LPC TAG Request Response
Is added on to the TLV Response when the result of the TLV request is "1".
LENGTH
Table 2-237
VALUE
20603
2
"1"
7B 50 00 00
02 00 00 00
31 00
20603
2
"0"
7B 50 00 00
02 00 00 00
30 00 Table 2-238
SW-TLV-EN
2017-02-23
TLV commands
2-151
8.4
LPC status (from TTM 2.7)
Reads the status of the calibration procedure (LPC)
TAG Request 20604 Response
LENGTH 0
VALUE No data Information direction, laser control system -> PC G1" + "G2" + "G3" + "G4" + "G5"
G1: 0: 1: 2: 3:
Result of the TLV request: Æ Æ Æ Æ
Command executed correctly Command could not be executed (see extended error code) Parameter VALUE is unknown Invalid TLV LENGTH of the request for the active communication interface
G2, G3, G4: 0 G5:
As soon as the status parameter reaches a value >/= 224, this means for the external activation or for TruDiag that the LPC sequence is ended. From this point, it is possible to restart the LPC sequence
For the TM Series 6000, TM Series 5000, TM Series 3000
2-152
22
Æ Laser switched on.
24
Æ Laser is ready to perform the calibration.
TLV commands
Wait until the laser has reached a stable condition. Wait until a stable power measurement is present.
SW-TLV-EN
2017-02-23
Reads the status of the calibration procedure (LPC)
Response
Information direction, laser control system -> PC For the TM Series 6000, TM Series 5000, TM Series 3000
Æ The measured laser power is too high. Æ The measured laser power is too low. Æ Optimization of the oven temperature. Æ Optimization of the oven temperature. Æ The laser could not be
The laser power is reduced. The laser power is increased. The oven temperature is reduced. The oven temperature is increased.
229
Æ Saving parameters is not possible.
•
230
Æ The required laser power could not be reached.
231
Æ The required laser power could not be reached. Æ The measured output value is outside the defined band. Æ The difference between the
32 34 48 50 228
Number of bytes in the TLV Value
232 234
235 239
switched on correctly.
measured output value and the nominal value is so great that upscaling the power makes no sense. Æ The laser's pump power has reached the maximum value.
Æ The laser control system has detected an error (error status).
The laser control system switches to error state • Restart system using "Reset" • Repeat LPC The pumping current of the laser can not be increased any further. The laser power can not be upscaled any further. Repeat LPC
Check LPC parameters. • • •
240
Æ LPC has been successfully
255
Æ LPC was canceled by the
completed.
Eliminate errors Restart system using "Reset" Repeat LPC
The laser power value is within the defined range.
user.
Table 2-239
Example: LPC status for G5 = 240. Request
Response
TAG
LENGTH
VALUE
20604
0
No data
7C 50 00 00
00 00 00 00
20604
10
"0" + "0" + "0" + "240"
7C 50 00 00
0A 00 00 00
30 00 30 00 30 00 32 34 30 00 Table 2-240
SW-TLV-EN
2017-02-23
TLV commands
2-153
8.5
Load camera settings
Note: The Vision pack "VisionLine Mark Traceability 2" is prerequisite for executing the commands for the sections with the headings 8.5 to 8.12 and the example 9.13. Reads the content of the assigned variable TAG
LENGTH
VALUE
Remark The following conditions • TTMCameraComponent must be installed on the device and licensed. • XML camera setting file available in correct format (created with TTMCameraComponentCo nfig Software)
Request "G" + "T"
Number of bytes in the TLV Value
Response
G:
Camera number
0:
No camera
1:
Camera 1
T:
Name and path of the XML configuration file
Extended error code:
"G1" + "G2"
G1:
20701
Number of bytes in the TLV Value
Æ Æ
2:
Æ
3:
Æ
4:
Æ
G2:
•
Result of the TLV request:
0: 1:
Command executed correctly Command could not be executed (see extended error code) Parameter VALUE is unknown Invalid TLV LENGTH of the request for the active communication interface Invalid TLV LENGTH of the response for the active communication interface
Is added on to the TLV Response when the result of the TLV Request is "1".
Extended error code:
1:
Æ
2: > 2: 100:
Æ Æ Æ
200:
Æ
Camera number does not exist Incorrect configuration file Internal error TTMCameraComponent not installed TTMCameraComponent not licensed Table 2-241
Example: Load camera configuration file "Camersetting.xml" Request
Response
TAG
LENGTH
VALUE
20701
28
DD 50 00 00
1C 00 00 00
20701 DD 50 00 00
2 02 00 00 00
"1" + "C:\Temp\Camerasetting.xml" 31 00 43 3A 5C 54 65 6D 70 5C 43 61 6D 65 72 61 73 65 74 74 69 6E 67 2E 78 6D 6C 00 "0" 30 00 Table 2-242
2-154
TLV commands
SW-TLV-EN
2017-02-23
8.6
Execute camera function
Note: The Vision pack "VisionLine Mark Traceability 2" is prerequisite for executing the commands for the sections with the headings 8.5 to 8.12 and the example 9.13. Reads the content of the assigned variable TAG
LENGTH
VALUE
Remark
Request The following conditions TTMCameraComponent must be installed on the device and licensed.
"G" + "T"+ "G1"
G:
Number of bytes in the TLV Value
0:
No camera
1:
Camera 1
T:
Operations function
G1:
Response
Camera number
•
ReadDMC
•
TrainBrightness
Triggering image capture before operations function
0:
Without image capture
1:
With image capture Extended error code:
"G1" + "G2"
G1: 20702
Number of bytes in the TLV Value
0: 1:
Æ Æ
2:
Æ
3:
Æ
4:
Æ
G2:
•
Result of the TLV request: Command executed correctly Command could not be executed (see extended error code) Parameter VALUE is unknown Invalid TLV LENGTH of the request for the active communication interface Invalid TLV LENGTH of the response for the active communication interface
Is added on to the TLV Response when the result of the TLV Request is "1".
Extended error code:
1:
Æ
2: > 2: 3: 100:
Æ Æ Æ Æ
200:
Æ
Camera number does not exist Erroneous command Internal error Code not legible TTMCameraComponent not licensed TTMCameraComponent not licensed Table 2-243
Example: "Read DMC code with the camera" Request Response
TAG
LENGTH
VALUE
20702 DE 50 00 00 20702 DE 50 00 00
12 0C 00 00 00 2 02 00 00 00
"1" + "ReadDMC" + "1" 31 00 52 65 61 64 44 4D 43 00 31 00 "0" 30 00 Table 2-244
SW-TLV-EN
2017-02-23
TLV commands
2-155
8.7
Set tag value
Note: The Vision pack "VisionLine Mark Traceability 2" is prerequisite for executing the commands for the sections with the headings 8.5 to 8.12 and the example 9.13. Reads the content of the assigned variable TAG
LENGTH
VALUE
Remark
Request "G" + "T1"+ "T2"
G:
Camera number
0:
No camera
1:
Camera 1
T1:
Tag designation ExposureTime (Exposure time)
The following conditions TTMCameraComponent must be installed on the device and licensed. The following tag designations apply to T1: • ExposureTime • TargetBrightness • Roi
18 – 200000 μs TargetBrightness (grayscale) Number of bytes 20703 in the TLV Value
0 – 255 Roi (pixel coordinates) (x1/y1 – x2/y2) T2:
Syntax of the Roi: x1 y1 x2 y2 (a space is required as separator)
Tag value 18 – 200000 μs (exposure time) 0 – 255 (grayscale) Roi (pixel coordinates) x1: min: 0 max. 1536 y1: min: 0 max. 1136
Set the pixel coordinates manually.
x2: min: 64 max. 1600 y2: min: 64 max. 1200
2-156
TLV commands
SW-TLV-EN
2017-02-23
Reads the content of the assigned variable Response
Extended error code:
"G1" + "G2"
G1:
Number of bytes in the TLV Value
0: 1:
Æ Æ
2:
Æ
3:
Æ
G2:
•
Result of the TLV request: Command executed correctly Command could not be executed (see extended error code) Parameter VALUE is unknown Invalid TLV LENGTH of the request for the active communication interface
Is added on to the TLV Response when the result of the TLV Request is "1".
Extended error code:
1:
Æ
2: > 2: 100:
Æ Æ Æ
200:
Æ
Camera number does not exist Erroneous command Internal error TTMCameraComponent not licensed TTMCameraComponent not licensed Table 2-245
Example: "Set the exposure time" to 5000 us Request Response
TAG
LENGTH
VALUE
20703 DF 50 00 00 20703 DF 50 00 00
20 14 00 00 00 2 02 00 00 00
"1" + "ExposureTime" + "5000" 31 00 45 78 70 6F 73 75 72 65 54 69 6D 65 00 35 30 30 30 00 "0" 30 00 Table 2-246
SW-TLV-EN
2017-02-23
TLV commands
2-157
8.8
Read tag value
Note: The Vision pack "VisionLine Mark Traceability 2" is prerequisite for executing the commands for the sections with the headings 8.5 to 8.12 and the example 9.13. Reads the content of the assigned variable TAG
LENGTH
VALUE
Remark
Request "G" + "T"
G: 0:
No camera
1:
Camera 1
n:
Camera >1
T:
Number of bytes 20704 in the TLV Value
Camera number
Tag designations CodeContent CodeResult ExposureTime TargetBrightness Roi CodeSymbology CodeModuleSize CodeAngle CodeSymbolContrast CodeSymbolContrastGrade CodeAxialNonUniformity CodeAxialNonUniformityGrade CodePrintGrowth CodePrintGrowthGrade CodeUnusedErrorCorrection CodeUnusedErrorCorrectionGrade CodeModulation CodeModulationGrade CodeFixedPatternDamage CodeFixedPatternDamageGrade CodeMinimumReflectance CodeMinimumReflectanceGrade CodeGridNonUniformity CodeGridNonUniformityGrade CodeExtremeReflectance CodeExtremeReflectanceGrade CodeEdgeContrastMin CodeEdgeContrastMinGrade Only the 1D codes:
The following conditions • TTMCameraComponent must be installed on the device and licensed.
• The following tag designations are valid for T and are described in a
documentation on "VisionLineMark Traceabiliy 2".
CodeSingleScanInt CodeSingleScanIntGrade CodeMultiScanInt CodeMultiScanIntGrade
2-158
TLV commands
SW-TLV-EN
2017-02-23
Reads the content of the assigned variable Response
Extended error code:
"G1" + "T" + "G2"
G1:
Number of bytes in the TLV Value
0: 1:
Æ Æ
2: 3:
Æ Æ
4:
Æ
T G2:
•
Result of the TLV request: Command executed correctly Command could not be executed (see extended error code) Parameter VALUE is unknown Invalid TLV LENGTH of the request for the active communication interface Invalid TLV LENGTH of the response for the active communication interface
Is added on to the TLV Response when the result of the TLV Request is "1".
Tag value Extended error code:
1:
Æ
2: > 2: 100:
Æ Æ Æ
200:
Æ
Camera number does not exist Erroneous command Internal error TTMCameraComponent not licensed TTMCameraComponent not licensed Table 2-247
Example: Read out the "CodeContent" tag from the camera Request Response
TAG
LENGTH
VALUE
20704 E0 50 00 00 20704 E0 50 00 00
14 0E 00 00 00 7 07 00 00 00
"1" + "CodeContent" 31 00 43 6F 64 65 43 6F 6E 74 65 6E 74 00 "0" 30 00 30 2E 31 35 00 Table 2-248
SW-TLV-EN
2017-02-23
TLV commands
2-159
8.9
Capture image
Note: The Vision pack "VisionLine Mark Traceability 2" is prerequisite for executing the commands for the sections with the headings 8.5 to 8.12 and the example 9.13. Reads the content of the assigned variable TAG
LENGTH
VALUE
Remark The following conditions • TTMCameraComponent must be installed on the device and licensed.
Request Number of bytes in the TLV Value
Response
"G"
G: 0:
Camera number No camera
1:
Camera 1
n:
Camera >1 Extended error code:
"G1" + "G2"
G1:
20705 Number of bytes in the TLV Value
0: 1:
Æ Æ
2:
Æ
3:
Æ
G2:
•
Result of the TLV request: Command executed correctly Command could not be executed (see extended error code) Parameter VALUE is unknown Invalid TLV LENGTH of the request for the active communication interface
Is added on to the TLV Response when the result of the TLV Request is "1".
Extended error code:
1:
Æ
2: > 2: 100:
Æ Æ Æ
200:
Æ
Camera number does not exist Erroneous command Internal error TTMCameraComponent not licensed TTMCameraComponent not licensed Table 2-249
Example: Capture image "c:\temp\Test1.bmp" Request Response
TAG
LENGTH
VALUE
20705 E1 50 00 00 20705 E1 50 00 00
02 02 00 00 00 2 02 00 00 00
"1" 31 00 "0" 30 00 Table 2-250
2-160
TLV commands
SW-TLV-EN
2017-02-23
8.10 Load image in camera (not yet implemented) Note: The Vision pack "VisionLine Mark Traceability 2" is prerequisite for executing the commands for the sections with the headings 8.5 to 8.12 and the example 9.13. Reads the content of the assigned variable TAG
LENGTH
VALUE
Remark The following conditions • TTMCameraComponent must be installed on the device and licensed. • Image saved in BMP format with Cognex Dataman is available.
Request "G" + "T1"
G: Number of bytes in the TLV Value
Response
Camera number
0:
No camera
1:
Camera 1
n:
Camera >1
T1:
Name and path of the image
Note:
This function is not currently implemented. However, calling the function does not lead to any error.
(The "Load image in camera" function is not yet working!)
Extended error code:
"G1" + "G2"
G1:
20706
Number of bytes in the TLV Value
0: 1:
Æ Æ
2:
Æ
3:
Æ
G2:
•
Result of the TLV request: Command executed correctly Command could not be executed (see extended error code) Parameter VALUE is unknown Invalid TLV LENGTH of the request for the active communication interface
Is added on to the TLV Response when the result of the TLV Request is "1".
Extended error code:
1:
Æ
2: 3: > 3: 100:
Æ Æ Æ Æ
200:
Æ
Camera number does not exist Erroneous command Name or path is incorrect Internal error TTMCameraComponent not licensed TTMCameraComponent not licensed Table 2-251
Example: Load image "c:\temp\Test.bmp" in the camera Request Response
TAG
LENGTH
VALUE
20706 E2 50 00 00 20706 E2 50 00 00
19 13 00 00 00 2 02 00 00 00
"1" + "c:\temp\Test.bmp" 31 00 63 3A 5C 74 65 6D 70 5C 54 65 73 74 2E 62 6D 70 00 "0" 30 00 Table 2-252
SW-TLV-EN
2017-02-23
TLV commands
2-161
8.11 Save image Note: The Vision pack "VisionLine Mark Traceability 2" is prerequisite for executing the commands for the sections with the headings 8.5 to 8.12 and the example 9.13. Reads the content of the assigned variable TAG
LENGTH
VALUE
Remark The following conditions • TTMCameraComponent must be installed on the device and licensed. • Image available in the camera's memory. TLV 20705 ("Record picture") must have been executed without error.
Request "G" + "T1"
Number of bytes in the TLV Value
G:
Camera number
0:
No camera
1:
Camera 1
n:
Camera >1
T1:
Name and path of the image Save on drive for analysis.
Response
Extended error code:
"G1" + "G2"
G1:
20707
Number of bytes in the TLV Value
Æ Æ
2:
Æ
3:
Æ
G2:
•
Result of the TLV request:
0: 1:
Command executed correctly Command could not be executed (see extended error code) Parameter VALUE is unknown Invalid TLV LENGTH of the request for the active communication interface
Is added on to the TLV Response when the result of the TLV Request is "1".
Extended error code:
1:
Æ
2: 3: 4: > 4: 100:
Æ Æ Æ Æ Æ
200:
Æ
Camera number does not exist Erroneous command Name or path is incorrect Read only in the directory Internal error TTMCameraComponent not licensed TTMCameraComponent not licensed Table 2-253
Example: Save image "c:\temp\Test1.bmp" Request Response
TAG
LENGTH
VALUE
20707 E3 50 00 00 20707 E3 50 00 00
20 14 00 00 00 2 02 00 00 00
"1" + "c:\temp\Test1.bmp" 31 00 63 3A 5C 74 65 6D 70 5C 54 65 73 74 31 2E 62 6D 70 00 "0" 30 00 Table 2-254
2-162
TLV commands
SW-TLV-EN
2017-02-23
8.12 Query available cameras Note: The Vision pack "VisionLine Mark Traceability 2" is prerequisite for executing the commands for the sections with the headings 8.5 to 8.12 and the example 9.13. Reads the content of the assigned variable TAG
LENGTH
VALUE
Remark
The following conditions
No data Request
TTMCameraComponent must be installed on the device and licensed.
0
Response
Extended error code:
"G1" + "G2"
G1:
20708 Number of bytes in the TLV Value
Æ Æ
2:
Æ
3:
Æ
G2:
•
Result of the TLV request:
0: 1:
Command executed correctly Command could not be executed (see extended error code) Parameter VALUE is unknown Invalid TLV LENGTH of the request for the active communication interface
Is added on to the TLV Response when the result of the TLV Request is "1".
Extended error code:
1:
Æ
2: 3: 4: > 4: 100:
Æ Æ Æ Æ Æ
200:
Æ
Camera number does not exist Erroneous command Name or path is incorrect Read only in the directory Internal error TTMCameraComponent not licensed TTMCameraComponent not licensed Table 2-255
Example: Save image "c:\temp\Test1.bmp" Request Response
TAG
LENGTH
VALUE
20708 E4 50 00 00 20708 E4 50 00 00
0 00 00 00 00 4 04 00 00 00
31 00 63 3A 5C 74 65 6D 70 5C 54 65 73 74 31 2E 62 6D 70 00 "0" + "1" 30 00 31 00 Table 2-256
SW-TLV-EN
2017-02-23
TLV commands
2-163
9.
Sample processes for activation of the laser marking system with TLV sequences
The following prerequisites apply for the sample processes: • Operation with TruTops Mark® •
The laser marking system has not been initialized as yet (switch on beam source, open shutter, ...).
•
The examples are only intended to display the procedural principles for utilizing TLV Commands and will still need to be supplemented and/or adjusted for concrete applications. Directory reference: C:\trumark\communication interface\Samples
9.1
Example_01 Load and mark a marking file without variables TLV Commands
No.
Customer writes (TAG)
1
20201
Laser/shutter (Laser on/shutter open)
2
20401
Load marking file (marking file without variables)
3
20222
Query conversion status
4
20261
Check laser status
5
20204
Start marking
Explanation
File "Sample_01"
2-164
TLV commands
Table 2-257
SW-TLV-EN
2017-02-23
9.2
Example_02 Load and mark a marking file without variables for which the marking has been moved and scaled TLV Commands
No.
Customer writes (TAG)
1
20201
Laser/shutter (Laser on/shutter open)
2
20401
Load marking file (marking file without variables)
3
20222
Query conversion status
4
20423
Scaling/displacement
Explanation
(This change is not displayed in the Mark preview!) 5
20402
Convert marking file
6
20222
Query conversion status
7
20261
Check laser status
8
20204
Start marking
9
20423
Scaling/displacement (This change is not displayed in the Mark preview!)
10
20402
Convert marking file
11
20222
Query conversion status
12
20261
Check laser status Response should be: Bit 7-0=00011111 / Bit 15-8=01011011
13
20204
Start marking File "Sample_02"
SW-TLV-EN
2017-02-23
TLV commands
Table 2-258
2-165
9.3
Example_03 Load and mark a marking file with three variables TLV Commands
No.
Customer writes (TAG)
1
20201
Laser/shutter (Laser on/shutter open)
2
20401
Load marking file (marking file with 3 variables)
3
20222
Query conversion status
4
20421
Set variable 1
5
20421
Set variable 2
6
20421
Set variable 3
7
20402
Convert marking file
8
20222
Query conversion status
9
20261
Check laser status
10
20204
Start marking
Explanation
File "Sample_03"
2-166
TLV commands
Table 2-259
SW-TLV-EN
2017-02-23
9.4
Example_04 Create a marking file Add objects and mark the created marking file TLV Commands
No.
Customer writes (TAG)
1
20201
Laser/shutter (Laser on/shutter open)
2
20461
Generating marking file for editing
3
20471
Adding a line
4
20473
Add a circle
5
20475
Adding a text
6
20464
Save the marking file opened for editing
7
20401
Load marking file
8
20222
Query conversion status
9
20261
Check laser status
10
20403
Mark marking file X (with X = Name of the previously saved marking file)
Explanation
File "Sample_04"
SW-TLV-EN
2017-02-23
TLV commands
Table 2-260
2-167
9.5
Example_05 Add a rectangle and a line to an existing marking file and mark the revised marking file TLV Commands
No.
Customer writes (TAG)
1
20201
Laser/shutter (Laser on/shutter open)
2
20462
Load marking file for editing
3
20461
Generating new marking file for editing
4
20474
Adding a rectangle
5
20471
Adding a line
6
20464
Save the marking file opened for editing
7
20401
Load marking file
8
20222
Query conversion status
9
20261
Check laser status
10
20403
Mark marking file X (with X = Name of the previously saved marking file)
Explanation
File "Sample_05"
2-168
TLV commands
Table 2-261
SW-TLV-EN
2017-02-23
9.6
Example_06 Include a CAD file in a marking file and mark the modified marking file TLV Commands
No.
Customer writes (TAG)
1
20201
Laser/shutter (Laser on/shutter open)
2
20462
Load marking file for editing
3
20463
Include CAD file
4
20464
Save the marking file opened for editing
5
20403
Mark marking file X (with X = Name of the previously saved marking file)
Explanation
File "Sample_06"
SW-TLV-EN
2017-02-23
TLV commands
Table 2-262
2-169
9.7
Example_07 Mark 2 points without marking file using scanner beam monitoring TLV Commands
No.
Customer writes (TAG)
Explanation
1
20201
Laser/shutter (Laser on/shutter open)
2
20283
Initialization of beam monitoring through the scanner (setting the power, frequency, pulse width and position for the first point)
3
20284
Scanner beam monitoring (activate beam source)
4
20284
Scanner beam monitoring (deactivate beam source after the desired time)
5
20283
Initialization of beam monitoring through the scanner (setting the power, frequency, pulse width and position for the second point)
6
20284
Scanner beam monitoring (activate beam source)
7
20284
Scanner beam monitoring (deactivate beam source after the desired time) File "Sample_07"
2-170
TLV commands
Table 2-263
SW-TLV-EN
2017-02-23
9.8
Example_08 Load, convert and activate the marking file in the 2 scanner lists TLV Commands
No.
Customer writes (TAG)
1
20201
Laser/shutter (Laser on/shutter open)
2
20401
Load marking file (marking file with 1 variable)
3
20222
Query conversion status
4
20421
Set variable
5
20402
Convert marking file
6
20222
Query conversion status
7
20441
Load marking objects in scanner list 1
Explanation
-Reset Restart Counter = 1 -Load laser parameters = 1 Retrigger mode… 8
20442
Activate scanner list 1
9
---
10
20421
Set variable
11
20402
Convert marking file
12
20222
Query conversion status
13
20441
Load marking objects in scanner list 2
A positive edge at X20 input = Retrigger starts the marking of the vectors from list 1 of the Scanlab card
-Reset Restart Counter = 1 -Load laser parameters = 1 14
20442
Activate scanner list 2
15
20207
Query marking status
16
---
A positive edge at X20 input E15 = Retrigger starts the marking of the vectors from list 2 of the Scanlab card File "Sample_08"
SW-TLV-EN
2017-02-23
TLV commands
Table 2-264
2-171
9.9
Example _09 Load and mark a marking file with a variable that is set with Unicode data TLV Commands
No.
Customer writes (TAG)
1
20201
Laser/shutter (Laser on/shutter open)
2
20401
- Load marking file (marking file with one variable)
3
20222
Query conversion status
4
20501 This is a CJK
Explanation
Set Unicode variable
Unified Ideograph: 5
20402
Convert marking file
6
20222
Query conversion status
7
20261
Check laser status
8
20204
Start marking File "Sample_09"
2-172
TLV commands
Table 2-265
SW-TLV-EN
2017-02-23
9.10 Example_11 Load the marking file in scanner list and set the MOF parameters TLV Commands No.
Customer writes (TAG)
1
20201
Laser/shutter (Laser on/shutter open)
2
20401
Load marking file (marking file with 1 variable)
3
20421
Set variable 1
4
20402
Convert marking file
5
20441
Load marking objects in scanner list 1
Explanation
-Reset Restart Counter = 1 -Load laser parameters = 1 Activate retrigger mode and set MOF Restart_mark / Abort_mark = 1 is activated 6
20442
Activate scanner list 1
7
20234
Overwrite MOF parameter temporarily Start delay
=0
Simulation ext. Start = 0 Scaling X Encoder = 0.20 Scaling X Encoder = 0.20 8
---
A positive edge at X20 input E15 = Retrigger starts the marking of the vectors from list 1 of the Scanlab card File "Sample_11"
SW-TLV-EN
2017-02-23
TLV commands
Table 2-266
2-173
9.11 Example_12 Demonstration of using automated Binning TLV Commands No.
Customer writes (TAG)
Explanation Preparation (only perform at start):
1
20201
Laser/shutter (Laser on/shutter open)
2
20401
- Load marking file (marking file with one variable)
3
20402
Convert marking file Loop (carry out for each marking):
4
20421
Set 'Code' variable (if any)
5
20402
Convert marking file (only required here if variables are used)
6
20244
Bring matrix file and customer binning file together Sample_12_matrix_copy.xml is a copy of the original matrix file. The original matrix file is overwritten during conversion. Sample_12_custom_binning.xml must be filled with the current values for each marking. custom_binning.xml has a different format than the binning file created by the matrix generator.
7
20402
Convert marking file
8
20204
Start marking EndLoop File "Sample_12"
2-174
TLV commands
Table 2-267
SW-TLV-EN
2017-02-23
9.12 Example_13 TLV conversion statuses (G2) with variable TLV Commands No.
Customer writes (TAG)
1
20401
Load marking file
2
20222
Query conversion status
3
20402
Carry out conversion
4
20222
Query conversion status again and when = 0, then execute next command
5
20205
Start marking (without waiting for the end)
6
20207
Query marking status again and when = 0, then execute next command
7
20421
Reset variable
8
20402
Carry out conversion
9
20222
Query conversion status again and when = 0, then execute next command
10
20204
Start marking
Explanation
(No marking status query necessary!) File "Sample_13"
SW-TLV-EN
2017-02-23
TLV commands
Table 2-268
2-175
9.13 Example_14 Execute camera function and carry out code analysis. Note: The Vision pack "VisionLine Mark Traceability 2" is prerequisite for executing the commands for the sections with the headings 8.5 to 8.12 and the example 9.13.
TLV Commands No.
Customer writes (TAG)
1
20708
Display available cameras
2
20701
Load camera settings
3
20702
Execute camera function: "ReadDMC" with image capture
4
20704
TLV value: Read "CodeResult" -> Read code [0 / 1]
5
20704
TLV value: Read "CodeContent" -> Code content [String]
6
20704
TLV value: Read "CodeSymbolContrast" -> [0…1.0]
7
20704
TLV value: Read "CodeSymbolContrastGrade" -> [A….F]
8
20704
TLV value: Read "CodeAxialNonUniformityGrade" -> [A….F]
Explanation
File "Sample_14"
2-176
TLV commands
Table 2-269
SW-TLV-EN
2017-02-23