Professional Documents
Culture Documents
Um3 - Command - Instructions (Laser - F-Series) - en
Um3 - Command - Instructions (Laser - F-Series) - en
Command instructions
for TL07
Command Description Machine’s answer
GO Start-up marking GO M
GO F
A Legal notices Translation of the French original document
The purpose of this document is to provide users (hereinafter the User(s)) with information and to ensure their
safety. It has no contractual value and Gravotech group (hereinafter Gravotech) reserves the right, at any time
and without notice, to make such changes or improvements as it deems fits, or to substitute any new equipment
and/or material and/or part and/or image to its equipment, software and/or associated manuals or documentation
(hereinafter the Product(s)).
This manual, including texts, images, photos, graphics, design, or any compilation, digital conversion or data
contained in it, is subject to copyright. This manual shall not be reproduced, disseminated, transmitted,
transcribed, translated or stored electronically, on any medium whatsoever regardless of its format without the
express and written permission of Gravotech, to the exception of software backup copies as provided by law.
The intellectual property rights relating to the Products and to this manual, including - but not limited to - patents,
trademarks, models, copyright, domain names and also the know-how, trading name or company name, are
owned by Gravotech Marking S.A.S or any company of the Gravotech group. Under no circumstances does the
transmission of this manual or the supply of Products or services constitute an assignment of or any express or
tacit license for any intellectual property right owned by Gravotech.
To the extent permitted by law, Gravotech provides hereby no warranty (in particular no warranties of
performance, non-infringement, merchantability or fitness for a particular purpose) relating to the supply of its
Products, other than those conferred upon the User by Gravotech’s general terms and conditions of sale or any
contractual document agreed between Gravotech and the User. Nor does Gravotech guarantee the compatibility
of its software with any software package not supplied by it, or any defect in assembly, adaptation, design,
compatibility and operation with any or part of a combination created by the User.
Gravotech shall not be liable for any damages, that the User or its property, a third party or the Product itself may
suffer, caused by the Product and arising from any inappropriate use or misuse of the Product, negligence,
carelessness, inadequate supervision or maintenance, failure to observe the safety or usage instructions
described herein or otherwise communicated to the User, the use of poor-quality or non-recommended lubricants,
fluids and additives or where there is fault on the part of the User or a third party. As provided in this manual, the
User shall furthermore (i) observe the normal conditions of use, (ii) not exceed the recommended maximum
number of hours during which the equipment may be operated on and (iii) refrain from proceeding to any
Product’s repair or make it proceed by any unqualified third party, or without the appropriate personal protective
equipment.
The Product’s specifications are altered by (i) any Product’s modification or alteration, (ii) any adaptation and
installation of accessories that are not recommended by Gravotech, (iii) the integration of a control system and
(iv) the connection to an external device. Such specifications’ alterations may lead to the non-compliance of the
Product with applicable rules and standards. Shall the Product be non-compliant, the person in charge of the
Product’s installation shall be responsible of the final workstation’s compliance. In no event, Gravotech shall be
liable for any damages arising from such non-recommended or unauthorized Product’s alterations. It is precised
that the warranty shall not apply in such case.
Under no circumstances shall Gravotech be held liable for any indirect, incidental, special, consequential punitive
or other similar damages, including any economic loss, loss of profit, loss of data or opportunity, whether or not
foreseeable by or communicated to Gravotech, caused by this manual or the supply of Products or services
concerned by the said manual.
To the widest extent permitted by law, Gravotech shall only be held liable for direct damage arising from personal
injury caused by a fault proven in its Product (including this manual).
Gravotech® - Type3® - Propen™ - Technifor™ - Gravograph® is (are) a used, pending or registered trademark(s)
of Gravotech group or one of its subsidiaries.
The products and names of third party companies which appear in this manual are used solely for the necessary
purposes of reference, and in particular for issues of compatibility. All the trademarks mentioned in this manual
remain the property of their respective owners. Windows® is (are) a used, pending or registered trademark(s) of
Microsoft Corporation. Postscript® is (are) a used, pending or registered trademark(s) of Adobe Systems
Incorporated.
A - Introduction .................................................................................................................... 4
1. Definition of a command instruction ....................................................................................................... 4
Alphabetical list of commands ........................................................................................................... 4
Command instructions ...................................................................................................................... 5
Response mode ................................................................................................................................ 5
2. Protocol .................................................................................................................................................. 6
3. Possibilities for using commands ........................................................................................................... 7
4. Example: marking cycle ......................................................................................................................... 8
D - Appendix ..................................................................................................................... 29
A AD Fault acknowledgement 9
AM Stop marking 10
GF File reception 11
G GI Information request 13
GO Start-up marking 14
H HP On-line help 15
R RM Deleting files 21
SI Definition of information 22
VS Assigning a variable 27
Response mode
The commands can send back concise responses (for a machine) or detailed responses (for a human), always in
English.
All responses are followed by the 2 characters <CR> <LF> (code: 13 - 10). They signal the end of the response
and add a line feed and a return carriage when using a telnet manual connection.
The 2 characters <CR> <LF> will not always be mentioned in this document.
Connection to the machine is made via a telnet session, on the 55555 port (value by default, modifiable on the
machine). The machine is like a telnet server. The connection is made without providing an ID or password. Only
one connection at a time is possible.
Connection may be done with a standard telnet client, for a manual sending of the commands, or directly via a
user program which opens a connection (socket) on the port.
TCP/IP ensures reliable data transfer. Commands may therefore be entered directly, without protocol overlayering
in order to validate their integrity or to acknowledge their reception.
The telnet session and the command instructions are in text mode.
Example
Connection via a telnet client on order line:
• IP address: 192.168.0.211
• port: 55555
It is thus possible to enter commands, sent after pressing the Enter key.
The LS command is manually entered and sent to the machine via the Enter key.
The following lines are emitted by the machine and received by the telnet client.
Status Description
READY File loaded - waiting for start marking (interlock status open or closed)
The table shows the commands which can be used according to the status of the machine.
CONTROL
INIT READY MARKING FAULT PAUSE
UNIT OK
AD X
AM X X X
GF X X X X
GI X X X X X X
GO X X
HP X X X X X X
LD X
LS X X X
PF X X
QS X X X X X X
RM X X X
SI X X X
SO X X X
ST X X X X X X
VG X X X
VM X X X X X X
VS X X X
Note:
Example:
Syntax used AD
Parameter None
Command: AD
Example
Machine’s answer: AD 1
Syntax used AM
Parameter None
Command: AM
Example
Machine’s answer: AM 1
GF "filename"
Syntax used
Returns the file whose name is specified between quotation marks.
.../...
GF
Command: GF "_temp.t2l"
Machine’s answer:
EFBBBF54324C28290D0A424828290D0A5350283130302C323530290D0A4C4228302C333
02C302C3137392C30290D0A545028313030302C3530302C313030302C302C3530302C30
2C30290D0A4F4828412C592C322C31290D0A454828290D0A424D28290D0A4242284F4E2
C4C2C31202D20426C6F63205465787465206C696EC3A9616972652C4C3252290D0A4D56
2831372E36342C32312E3837290D0A464F28225446203130302E706F33222C392E31372
C3130302C3130302C4C2C4E2C302C4E290D0A4D5028302E30290D0A4D4B282274657874
22290D0A454228432C31290D0A4242284F4E2C532C32202D20426C6F6320436572636C6
52C4C3252290D0A53432837332E30322C32372E35322C372E37362C372E37362C302C30
2C3336302C30290D0A454228432C31290D0A4242284F4E2C472C33202D20426C6F63204
C6F676F2C4C3252290D0A4D562832382E39332C39362E3330290D0A464F28224345506C
65696E2E6C6F33222C34302E39322C3130302C3130302C4C2C4E2C302C4E290D0A4D502
8302E30290D0A454228432C31290D0A454D28290D0A424628290D0A4F4828412C592C30
2C290D0A454628290D0A
Command: GI *
Machine’s answer:
Head: LASER SOLUTION F20
Focale: 160
Id: 768
Sn: A4-09-123456-00
vSoftware: v1.46
Example
Date: 08/09/2014
Hour: 14: 34: 04
Mac: e8: e0: 8f: 00: 2d: 00
Ip: 192.168.0.24
SRAM: 52%
I: 0.0, 1.0, 2.0, 3.0, 4.0, 5.0, 6.0, 7.0
O: 0.0, 1.0, 2.0, 3.0, 4.0, 5.0, 6.0, 7.0
Syntax used GO
Parameter None
Marking launched GO M
Marking suspended GO P
Command: GO
Machine’s answer:
Example
- GO M
- GO F
HP
Help of all commands
Syntax used
HP command
Help for the specified command
Human mode: help message on the specified command or list of commands separated by spaces
Machine’s answer (with line feed and carriage return for an easier visualization in a telnet client)
Machine mode: HP 1
Possible error ER 1 3 ER 1 6
codes (see:
Summary table of
the error codes)
Command: HP
Machine’s answer:
HP is the online help command.
Try: HP command
Available commands are:
AM,AD,GF,GO,GI,HP,LD,LS,PF,QS,RM,SI,SO,ST,VG,VM,VS
--End of help--
Example
Command: HP VG
Machine’s answer:
Online help for the VG (Variable Get) command.
Syntax : VG var
Effect : Returns the text contained in the specified variable(s)
Parameters:
var: number of the variable, or * for all
--End of help--
Note The name of the file must take into account caps.
Possible error ER 1 2 ER 1 3 ER 1 4 ER 1 9
codes (see: ER 2 state
Summary table of ER 3 2 ER 3 3 ER 3 1 Line param ErrorCode
the error codes)
Command: LD "test.t2l" 0 A
=> loading the marking files: test.t2l
Example "Infinite" independent marking
Machine’s answer: LD 1
LS
List of files stored on the machine
Syntax used
LS mask
List of the files corresponding to the specified mask
Parameter mask UTF-8 text Rule of the files to display *, *.lo3, *.po3, *.t2l
The mask includes 2 parts: the name and the file extension.
Note The star * is used to specify any name or extension.
Question mark ? is used to replace a character.
NbFilesFound
File1.ext
File2.ext
Machine’s answer ...
Filen.ext
Possible error ER 1 3 ER 1 5
codes (see: ER 2 state
Summary table of
the error codes)
Possible
Parameter Type Description
values
Possible error ER 1 2 ER 1 3 ER 1 4 ER 1 5 ER 1 7 ER 1 9
codes (see: ER 2 state
Summary table of ER 3 4 ER 3 2 ER 3 3
the error codes)
.../...
PF
Command: PF "_temp.t2l"
Machine’s answer:
EFBBBF54324C28290D0A424828290D0A5350283130302C323530290D0A4C4228302C333
02C302C3137392C30290D0A545028313030302C3530302C313030302C302C3530302C30
2C30290D0A4F4828412C592C322C31290D0A454828290D0A424D28290D0A4242284F4E2
C4C2C31202D20426C6F63205465787465206C696EC3A9616972652C4C3252290D0A4D56
2831372E36342C32312E3837290D0A464F28225446203130302E706F33222C392E31372
C3130302C3130302C4C2C4E2C302C4E290D0A4D5028302E30290D0A4D4B282274657874
22290D0A454228432C31290D0A4242284F4E2C532C32202D20426C6F6320436572636C6
52C4C3252290D0A53432837332E30322C32372E35322C372E37362C372E37362C302C30
2C3336302C30290D0A454228432C31290D0A4242284F4E2C472C33202D20426C6F63204
C6F676F2C4C3252290D0A4D562832382E39332C39362E3330290D0A464F28224345506C
65696E2E6C6F33222C34302E39322C3130302C3130302C4C2C4E2C302C4E290D0A4D502
8302E30290D0A454228432C31290D0A454D28290D0A424628290D0A4F4828412C592C30
2C290D0A454628290D0A
Syntax used QS
Possible error ER 1 3
codes (see: ER 3 2
Summary table of
the error codes)
Command: QS
Example
Machine’s answer: CCU does not respond
The mask includes 2 parts: the name and the file extension.
Note The star * is used to specify any name or extension.
Question mark ? is used to replace a character.
Machine’s answer RM 1
Possible error ER 1 3 ER 1 7 ER 1 2
codes (see: ER 2 state
Summary table of ER 3 2 ER 3 3
the error codes)
RM "exemple.t2l"
RM "*.t2l"
RM "152.lo3 "
RM "254.po3 "
Example
Command: RM example.t2l
Machine’s answer: RM 1
Command: RM *.t2l
Machine’s answer: RM 1
Possible error ER 1 2 ER 1 3 ER 1 6 ER 1 7
codes (see: ER 2 state
Summary table of
the error codes)
Command: SI date:28/02/2014
Machine’s answer: SI 1
Command: SI time:12:00:00
Example
Machine’s answer: SI 1
SO
Description Used to specify the state of the Outputs.
Possible error ER 1 2
codes (see: ER 1 3
Summary table of ER 1 4
the error codes) ER 2 State
To modify Outputs 0 to 3:
Activate Outputs 2 - 3.
Invert Outputs 0 - 1 status.
Command: SO 15 12 3
Machine’s answer: SO 1
0000 1111 15
0000 1100 12
0000 0011 3
ST
Description State of machine operation
Syntax used ST
State:
1: INIT
2: ALIVE
4: READY
8: MARKING
10 (16): PAUSED
20 (32): FAULT
0: Normal marking
1: "Infinite" independent marking
2: Simulation
Possible error ER 1 3
codes (see: ER 3 2 ER 3 3
Summary table of
the error codes)
Command: ST
Machine’s answer: ST 4 0 1 (4: machine ready to mark / 0: laser shot possi-
Example
ble / 1: "infinite" independent marking)
Possible error ER 1 2 ER 1 3 ER 1 4 ER 1 7
codes (see: ER 2 state
Summary table of ER 3 2 ER 3 3
the error codes)
If:
V0=example0
V1=example1
Example
Command: VG 0
Machine’s answer: example0
Machine mode: VM 1
Machine’s answer
Human mode: Human answer mode
Possible error ER 1 2 ER 1 3 ER 1 7
codes (see:
Summary table of
the error codes)
Command: VM H
Machine’s answer: Human answer mode
Example
Command: VM M
Machine’s answer: VM 1
Possible error ER 1 2 ER 1 3 ER 1 4 ER 1 7 ER 1 9
codes (see: ER 2 state
Summary table of ER 3 2 ER 3 3
the error codes)
Command: VS 0 "ABCD"
Example
Machine’s answer: VS 1 (Allocation: OK) 0 (number of the variable)
• an error-type code
• a code specifying the error
0 Reserved 0 Reserved
0 Reserved
1 Unknown command
4 Wrong parameter
1 Syntax error
5 Cannot open file
6 Unknown parameter
0 Reserved
1 Initialization
ER 2 CCU OK
8 Marking
16 Pause
32 Fault
0 Reserved
2 Internal error TX
3 Internal error RX
9 AD failed
www.gravotech.com