Godex EZ-4TKP User manual

P/N. 920-010612-02
Edition 2
November 00
EZ-4TTP/4TKP Programming Manual

1
EZ-4TTP/4TKP PROGRAMMING MANUAL...................0
1. COMMANDS......................................................................................2
1-1. EZPL........................................................................................................2
1-2. Language Description.............................................................................4
1-3. Barcode .................................................................................................13
2. EXAMPLES.....................................................................................14
APPENDIX..........................................................................................21
A. Barcode Details........................................................................................21
B. The New Commands...............................................................................22

2
1. Commands
1-1. EZPL
The EZPL (EZ Programming Language) is a high-level label definition and printer control language.
The features are:
1. The data fields are stored and processed until the printing instruction is received.
2. All the data can be rotated.
3. Imagescan be downloaded and stored.
There are three basic types of commands:
?Setup
?Control
?Label format
Setupcommands
Contain the printer control instructions, configuration instructions and image downloading instructions.
Description Command Page
1. Stop position setting ^Ex 4
2. Setting Print darkness ^Hx 4
3. Number of pages printed ^Px 4
4. Label length ^Qx,y(,z?)4
5. Speed setting ^Sx 5
6. Numberofcopies per label ^Cx 5
7. Row column adjustment ^Rx 5
8. Label format begin sign ^L 5
9. Strippersensor ^Ox 5
10.Download label format ^Fname 5
11.Recall label format ^Kname 5
12.Label width setting ^Wxx 6
13.Numberoflabelsper cut ^Dx 6
14.Serial Port translation setting ^Yp1.p2,p3,p4 6
15.Set the forward length ^Mx 6
16.Set the backward length ^Bx 6
Control commands
Cause the printer to take action immediately, such as cleaning memory, feeding label.
Description Command Page
1. Graphicdownloadmemory ~Ea,name,length 7
2. Bit-Mapped font download ~Jn 7
3. Graphicmode ~G 7
4. Print last label ~Px 7
5. Print version message ~V 7
6. Date/Time setting ~Dm,d,y,h,I,s 7
7. Reset printer ~Z 7
8. Printer head testing ~T 7
9. Clear all ~MDEL 7
10.Clear memory ~MDELx,name 7
11.Rotate printing ~Rx 8
12.Print the available space and data name in the memory ~Xn 8
13.Acknowledge fromRS-232 ~Kn8
14.Row Offset Adjustment ~Q±n 8

3
Label formatting commands
Define field data, such as Line, Rectangle, Barcode, Text and image.
Description Command Page
1. Define date layout Daa|bb|cc 9
2. Serial number setting Cx,ys,?value,prompt 9
3. Terminate label formatting mode and print
label E9
4. Graphiccommand Gwxxx 9
5. Line command La,x, y, x1, y1 9
6.
Rectangle Rx, y, x1,y1, lrw, ubw 10
7. Table Hx,y,row_count,col_count,row_width,col_width,line_width 10
8. Define time layout formatting Th|m|s 10
9. Graphics Yx, y, name 10
10.Text At, x, y, x_mul, y_mul, gap, rotation, data 10
11.Barcode Bt,x,y,narrow,wide,height,rotation,readable,data 11
12.PDF 417 Px,y,w,h,r,c,ec,len 11
13.Maxicode Mx, y, sno, nos, mode, ccode, zip, class, rotation,
message 11
14.Define variable field Vxx, length, prompt 12
15.Pattern command Qx,y,width,height 12
16.Downloading character sets to memory Vt,x,y,x_mul,y_mul,gap,rotation,data 12

4
1-2. Language Description
Rules and syntax
EZPL commands have parameter strings associated with them;
?? The commands begin with a letter as ID for each function.
?? The comma (,) is the delimiter to separate each parameter.
?? The CR [Carriage Return: decimal (13), hex (oD) signifies the end of every command.
?? Control and Setup commands use the tilde (~) and caret (^) prefix.
?? Label Formatting commands have no prefix.
Example: “~Ea,name,length “. ”I” is an image download command, and (a,name,length) are three parameters.
Setupcommands
1. Stoppositionsetting
Syntax : ^Ex
Parameter : X= 0~40 (unit : mm)
Description : Feed paper to desired stopposition.
The suggested value of x is 14 for label gap paper, 12 for stripper operation, 28 for cutter fonction.
2. Setting Print darkness
Syntax : ^Hx
Parameter : X = 00 ~ 19
Description : Set printing darkness.
3. Number of pages printed
Syntax : ^Px
Parameter : x = 1 ~ 32767
Description : Set how many labels to print; and it will initiate the program.(refer page 17)
4. Label length
Syntax :
^Qx,y(,z?)
Die cut label:(See fig. 1)
x = Label length (unit : mm)
y = Gap length (mm)
Parameter : EX.
^Q25,3
(x=25,y=3)mm
paper feed
direction
x y
Plainpaper:
x = Label length (unit : mm)
y = 0 (constant)
z = Feed paper length (unit : mm)
Black marklabel:
x= Label length (unit : mm)
y = Black mark width(mm)
z= Black line to top of form position.
z+ : When thepositionisoutside the blackmark.
z-:When the position iswithin the black mark.

5
EX.
^Q25,4,3+
(x=25, y=4, z=3+) mm
^Q25,4,3-
(x=25, y=4, z=3-)mm
y
paper feed
direction
x
^Qx,y,z+
^Q,x,y,0+
^Q,x,y,z-
x
x
Description : Set label size (length, gap length, [plain paper feed length])
5. Speed setting
Syntax : ^Sx
Parameter : x=1 to 4 (inch/sec)
Description : Set printing speed
6. Number of copies per label
Syntax : ^Cx
Parameter : X = 0 ~ 32767
Description : Number of copies of the same label (refer page 17)
7. Row column adjustment
Syntax : ^Rx
Parameter : x = 0 ~ 399dots
Response : None
Description : Set left margin
8. Label format beginsign
Syntax : ^L
Parameter : None
Descripton : Set label begin sign
9. Stripper sensor
Syntax : ^Ox
Parameter : x = 0 , stripper disable.
x = 1 , stripperenable
Description : Enable or disable the stripper sensor. When you use this command, it should be matched with^Ex.
(refer page 16)
10. Download label format
Syntax : ^Fname
data
Parameter : Name = name of label format (up to 20 characters)
Data = the data containing the label formatting command for this stored format
Description : Download label format intomemory. After the download is finished, the printer will beep once (refer
page19).
^Fname
:
:
^L
:
:
E
Control/Setup command
Label format command
data
Same name inspection : If you use the same file name, the printer will print ”REPEAT FILE
NAME”, and the download will be not be accepted.
11. Recall label format
Syntax : ^Kname
Parameter : Name = name of recall label format (up tp 20 characters)
Description : Recall label format from external format (refer page19)

6
^Kname
:
:
E
:
:
~Px
data
Control/Setup command [option]
12. Label width setting
Syntax : ^Wxx
Parameter : x=label width (mm)
Description : Label width setting
13. Number of labelsper cut
Syntax : ^Dx
Parameter : X = 0 , disable cutting.
X = 1 ~ 32767 , number of label per cut.
Description : Number of labelsper cut (refer page 17)
14. Serial Port translation setting
Syntax : ^Yp1.p2,p3,p4
Parameter : p1 : Baud Rate (48 or 96 or 19 or 38) ; 48=4800bps; 96=9600bps; 19=19200bps; 38=38400bps
p2 : Parity (N, O, E) ; N=none parity; O=odd parity; E=even parity
p3 : Number of data bits (7 or 8)
p4 : Number of stop bits (1 or 2)
Description : Serial Port translation setting
15. Set the forward length
Syntax : ^Mx
Parameter : x = forward length (mm)
Description : Set the forward length of the paper
16. Set the backward length
Syntax : ^Bx
Parameter : x = backward length (mm)
Description : Set the backward length of the paper

7
CONTROL COMMAND
1. Graphic download memory
Syntax: ~Ea, name, length
Parameters : a = P or p : PCX file
a = B orb :BMPfile
name : Name of image (up to20 character)
length : Length of image (bytes), maximum 512K byte.
Description : Download monochrome image onto memory. Printer will beep 1 time after completely downloaded.
If you use the same file name, the printer will show ”REPEAT FILE NAME”, and the download will
be not be accepted (refer page 19).
2. Bit-Mapped fontdownload
Syntax : ~Jn
Parameters : n = character; From a ~ z or A ~ Z; at least up to 26 characters.
Description : The command used for font loading is usually generated by Qlabel-III label creation software. The
printer will beep once after downloaded. If you use the same file name, the printer will
show ”REPEAT FILE NAME”, and the download will be not being accepted. The downloaded font
are compatible with the HP Laser Jet II Plus (PCL-4).
Download the “HVR0OE1A.SFP” text file to external memory card. Use “A” to do the character
code name.
Example :
~JA ; Define A as HVR0OE1A.SFP
COPY HVR0OE1A.SFP PRN/B ; Send the order with the DOSmode
3. Graphic mode
Syntax : ~G
Parameter : None
Decription : Printer is in the image-receiving mode. Image data is directly sent from host to the printing buffer
(refer page 18)
4. Print last label
Syntax : ~Px
Parameter : x = 1 ~ 32767
Description : This command will repeatedly print the indicated copies of the last label format.
5. Print version message
Syntax : ~V
Parameter : None
Description : Print firmware version (refer page20)
6. Date/Timesetting
Syntax : ~Dm,d,y,h,I,s
Parameter : m = Month (01 to 12)
d = Date (01 to 31)
y = Year (last two digits of year)
h = Hour (00 to 23)
i = Minutes (00 to 59)
s =Seconds (00 to 59)
Description : Set real time clock (refer page 15)
7. Reset printer
Syntax : ~Z
Parameter : None
Description : Reset the printer, the LED will flash once.
8. Printer head testing
Syntax :~T
Parameter :None
Description :Print a pattern for the user to determine if the print head is damaged (refer page20)
9. Clear all
Syntax :~MDEL
Parameter :none
Description :Clear all in the memory (not include Asia font)
10. Clear memory
Syntax :~MDELx,name
Parameter :x = type
G, graphic
F, label form

8
E, Bit-Mapped font (not included Asia font)
name: The name of the graphic, form and Bit-Mapped font
Description :Able to delete individual files or erase entire flash memory.
Example :~MDELG,Bus ; the graphic “Bus” will be deleted
11. Rotate printing
Syntax :~Rx
Parameter :x = label width; from 1 to 104 (mm)
Description :Rotate the label format 180-degrees when printing (refer page 18). To return to the original print
direction, set the x value greater than 104 (ie. ~R105).
12. Print the available space and data name in the memory
Syntax :~Xn
Parameter :n = 1, print label format names and available space in memory.
n = 2, print graphic namesand available space in memory.
n = 3, print Bit-Mapped font names and available space in memory.
n = 4, print the name of the label formats, graphics, fonts, and available space in memory.
n = 5, print Asia font names and available space in memory
n = 6, feed backthe total printed length through the printer’s serial port
Description :Print the available space in the memory card (unit: bytes)
13. Acknowledge from RS-232
Syntax :~Kn
Pararmeter :n= 0, disable.
n = 1, enable.
Return value :Y?
Description :Acknowledge a “Y(0D0A)” from RS-232 back to host each printing label.
14. Row Offset Adjustment
Syntax :~Q±n
Pararmeter :n=-36 ~ +36
Return value :none
Description :If the printing doed not appear in the same place on every label, this command instructs the printer
to print label formats +n increments above the position the format specifies, and–n decrements
below the position the format specifies.

9
Label formatting commands
1. Define date layout
Syntax :Daa|bb|cc
Parameter :aa = Year
y2 : Year with twodigits (such as 97)
y4 : Year with four digits ( such as 1997)
bb = Month
me : Month in letters (JAN, FEB, .... )
mn : Month in numeric (01, 02, .... )
cc = 2 digits day
| = Separator, can be any ASCII character between decimal 32 to 63.
Description :Define the date layout for print out (refer page15)
2. Serial number setting
Syntax :Cx,ys,?value,prompt
Parameter :x: 0 to 9(up to10group),maximum combination up to3groups.
y: select the decimal
y=none,Decimal(0~9)
y = A, Hexadecimal (0~9,A~F)
y = C, 0~9, A~Z
s: start value of serial variable (up to 13-digit)
?value: inc. / dec. value of serial variable (up to 12-digit)
prompt: prompt of serial variable (up to 20 characters)
Description :Set the serial number (refer page17)
Example :^Q50,0,0
^W100
^S3
^H10
^E12
^P5
^L
C0,000,+1,AA
C1,AEE,+1,BB
C2,CZYY,+1,CC
AC,5,5,1,1,1,0,^C0^C1^C2
E
Printing result:
000EEZYY
001EFZYZ
002F0ZZ0
003F1ZZ1
004F2ZZ2
3. Terminatelabel formatting mode and print label
Syntax :E
Parameter :None
Description :End of formatting command; printer will print label after receiving this command.
4. Graphic command
Syntax :Gwxxx
Parameter :wxxx...
w : byte number of image data (xxx...)
Description :This command is a sub-commandof ~G It is sent by binary data. W is the digits number byte of image
data (refer page18). For example, if the image file is 50 bytes, the command is G2xxx . (2: ASCII is 50
decimal)
5. Line command
Syntax :La,x, y, x1, y1
Parameter :a = o, overwrite line
a = e, exclusive or line
x : left-up; per horizontal(Hori.) pos. (dot; 1mm= 8dots)
y : left-upper vertical (Vert.) pos. (dots)
x1: right-bottom Hori. Pos. (dots)
y1: right-bottom Vert. Pos. (dots)
Description :Define a line to render in the label (refer page15)
** The diagonal line draw is not available **