If printing does not begin (main most frequent cause) ....................................................117
If a template linked to a database is not printed ..............................................................117
Appendix D: Introducing the Brother Developer Center ····························· 118
- iii -
P-touch Template 2.0 Command Reference
Introduction
This material provides the necessary information for directly controlling the tem plates transferred to RJ-2XXX.
This information is provided assuming that the user has full understanding of the operating system being used
and basic mastery of programming in a developer's environment.
Read the model names that appear in the screens in this manual as the name of your printer.
We accept no responsibility for any problems caused by programs that you develop using the information
provided in this material, affecting software, data or hardware, including the RJ-2XXX, and any problems
resulting directly or indirectly from them. Use this material only if you accept these terms.
This material shall not be reproduced, in part or in full, without prior approval. In addition, this material shall
not be used as evidence in a lawsuit or dispute in a way that is unfavorable towards our company.
- 1 Introduction
P-touch Template 2.0 Command Reference
3. Transfer the data (text) from
the host, and then print the
template.
1. Set up the printer from
the PC according to the
configuration of the host.
2. Design the template
with P-touch Editor, then
transfer it to printer.
What is P-touch Template 2.0?
P-touch Template 2.0 helps the user develop a printing system that connects directly from the host and has
following functions:
transfers the template data from P-touch Editor to the printer (2)
transfers the ASCII text and binary data from a host to the template in the printer (3)
(“Host” includes medias such as barcode readers, smartphones or mobile terminals.)
prints the transferred data (3)
(See the figure shown below.)
P-touch Template 2.0 commands consist of a prefix character and a two-character text string.
When the prefix character is sent, the printer begins the analysis of the P-touch Template 2.0 command, and
performs the specified process if the following two-character text string corresponds to a command.
Note
*P-touch Template 2.0 is not compatible with some hosts .
*These hosts should have an interface to transfer the data.
*ZP L II emulation is supported by P-touch Template 2.0.
- 2 -
What is P-touch Template 2.0?
Settings Tool User’s
The printer driver must first be installed via a USB
touch Editor, design the template to be transferred
If any special commands are required to control the printer,
change the terminal program in accordance with the
1. Using P-touch Template 2.0
(1) Specify the printer settings.
Using the P-touch Template Settings tool, specify the initial
printer settings according to the host system environment or
the host that the printer is connected to.
(Please refer to “2. P-touch Template
Guide” on page 4.)
connection.
P-touch Template 2.0 Command Reference
(2) Design the template.
Using Pto the printer.
(Please refer to “4. P-touch Template 2.0 Limitations” on
page 19.)
(3) Transfer the templates.
Using P-touch Transfer Manager, transfer the templates to
the printer.
(Please refer to the TD Series Software User’s Guide.)
(4) Program using P-touch Template 2.0 commands.
P-touch Template 2.0 commands.
(Please refer to “6. Control Code Lists” on page 30.)
(5) Connect the printer with the host and print slips etc.
Transfer the data such as ASCII text from the host to
templates in the printer, and print the slips etc.
- 3 -
1. Using P-touch Template 2.0
(5) Print start command text
string setting
(1) Command mode setting
(2) Template number setting
(3) Delimiter setting
(4) Print start trigger setting
(6) Print start data amount setting
(7) Character code set setting
(8) International character set setting
(9) Prefix character setting
(10) Non-printed character setting
Applies settings for
(1)
through (15) to the printer.
Returns
(1)
through (15) to their default settings.
Closes the tool.
(11) Line feed character setting
(13) Number of copies setting
(12) FNC1 replacement setting
(14) Print quality setting
(15) Rotate setting
2. P-touch Template Settings Tool User’s Guide
P-touch Template 2.0 Command Reference
- 4 -
2. P-touch Template Settings Tool User’s Guide
P-touch Template 2.0 Command Reference
(1) Command mode setting
- P-touch Template mode
To use P-touch Template 2.0, select the P-touch Template mode.
(2) Template number setting
Specify the template number selected as the default when the printer is turned on.
However, if any template has been set to not be transferred to the printer, the number of that template
cannot be specified.
(3) Delimiter setting
A delimiter is the symbol used to indicate when to move to the next object in the data that is being sent.
Between 1 and 20 characters can be specified.
(4) Print start trigger setting
Select one of the following three options for the print start trigger.
- Command Character
(Printing starts when the command character specified in (5) is received.)
- Data Insertion into All the Objects
(Printing starts when the delimiter for the last object is received.)
- Received Data Size
(Printing starts when the number of characters specified in (6) is received. However, delimiters are not
counted in the number of characters.)
(5) Print start command text string setting
Specify 1 to 20 characters.
(6) Print start data amount setting
The amount of data that must be received before printing can begin can be set between 1 and 999.
(7) Character code set setting
Select one of the following three character code sets. For character code tables, refer to “Appendix B:
Character Code Tables”.
- Windows1252
- Windows1250
- Brother standard
- 5 -
2. P-touch Template Settings Tool User’s Guide
(8) International character set setting
Select one of the following countries for the character set.
- USA
- France
- Germany
- Britain
- Denmark I
- Sweden
- Italy
- Spain I
- Japan
- Norway
- Denmark II
- Spain II
P-touch Template 2.0 Command Reference
- Latin America
- South Korea
- Legal
The following 12 codes are switched depending on the country selected from those listed above.
23h 24h 40h 5Bh 5Ch 5Dh 5Eh 60h 7Bh 7Ch 7Dh 7Eh
For the characters that are switched, refer to the “International character set table” in “Appendix B:
Character Code Tables”.
(9) Prefix character setting
Change the prefix character code. Specify as a one-character character code.
The prefix character is the code for the first character that identifies commands that can be used in
P-touch Template mode.
(10) Non-printed character setting
The characters specified here are not printed when data is received. Specify 1 to 20 characters.
(11) Line feed character setting
The line feed code is used when feeding data to indicate that the following data should be moved to the
next line in a text object. One of the following four line feed codes can be selected, or 1 to 20 characters
can be specified as the line feed code.
1. ^CR
2. \0D\0A
3. \0A
4. \0D
- 6 -
2. P-touch Template Settings Tool User’s Guide
P-touch Template 2.0 Command Reference
(12) FNC1 replacement setting
This setting selects whether or not GS codes, which are included in barcode protocols such as
GS1-128 (UCC/EAN-128), are replaced with FNC1 codes.
If the check box is selected, a received GS code is replaced with the FNC1 code. If the check box is
cleared, a received GS code is outputted as is.
(13) Number of copies setting
Specify the number of copies. A number between 1 and 99 can be specified.
(14) Print quality setting
Select the print quality setting. If the check box is selected, priority is given to the print quality. If the
check box is cleared, priority is given to the print speed.
(15) Rotate setting
Set print orientation. When the check box is checked, a print is 180 degrees rotated.
- 7 -
2. P-touch Template Settings Tool User’s Guide
P-touch Template 2.0 Command Reference
PRINT
PRINT
Tab control code
\09
Line feed control code
\0D \ \\
Others
· ini file
After the [Set] button (in the main dialog box or the Communications Settings dialog box) is clicked, the
settings are saved when the dialog box is closed.
C:\Users\(user_account_name)\App Data\Roaming\Brother\Printer Settings\ptsXX37.ini
Note: A name of file “ptsXX37.ini” varies depending on printers like below.
- RJ-2030 pts3637.ini
- RJ-2050 pts3737.ini
- RJ-2140 pts3837.ini
- RJ-2150 pts3937.ini
Note: A file path above might be different depending on OS.
· Typing text into text boxes (3), (5), (9), (10) and (11)
Characters that can be entered as text can be typed in, and control codes can be entered as ASCII
codes (00 to FF) with \ in front of them.
Example
- 8 -
2. P-touch Template Settings Tool User’s Guide
3. Examples for Using Commands
3.1 Example for using P-touch Template 2.0
Here is the label that will be made.
Steps
1. Make a template with P-touch Editor.
P-touch Template 2.0 Command Reference
2. Transfer the template to Transfer Manager.
3. Transfer the template from Transfer Manager to the printer.
4. Use P-touch Template 2.0 commands for printing.
Step 1: Make a template with P-touch Editor.
Start the P-touch Editor and make a label.
- 9 -
3. Examples for Using Commands
Stored template
Assigned number
Click [Transfer] button.
Step 2: Transfer the template to Transfer Manager.
The template sent in step 2 is stored in Transfer Manager, as shown below.
P-touch Template 2.0 Command Reference
Step 3: Transfer the template from Transfer Manager to the printer.
- 10 -
3. Examples for Using Commands
P-touch Template 2.0 Command Reference
(1) Select the P-touch Template mode.
(2) Choose the assigned number.
Note
Make sure that the printer is turned on and hooked up to the PC with a USB cable before using
Transfer Manager. Also, make sure that the printer communication setting is always bidirectional
communication when Transfer Manager is used.
When the template is transferred to the printer, the following message appears.
Step 4: Use P-touch Template 2.0 co mmands for printing.
When using P-touch Template 2.0 commands, at least these four commands are required.
However, two out of the four can be set by using the P-touch Template Settings tool.
After setting (1) and (2) with the P-touch Template Settings tool, the other two commands must be sent
to the printer.
- 11 -
3. Examples for Using Commands
^II
Entered command
^FF
Entered command
(3) Initialize P-touch Template 2.0
(4) Print Start
P-touch Template 2.0 Command Reference
When the printer receives the command above, the label below is printed.
- 12 -
3. Examples for Using Commands
609 dots (3 inches)
406 dots (
2 inches)
80 dots
290 dots
Example:
A case 203dpi printer is used
Font is outline font, and size is
50, 50 dots.
Select P-touch Template mode.
3.2 Example for using ZPL II in P-touch Template 2.0
Here is the label that will be made.
P-touch Template 2.0 Command Reference
Steps
1. Change the mode to P-touch Template mode.
2. Set the label length with ^LL.
3. Set the label width with ^PW.
4. Send other ZPL II command.
Step 1: Change the mode to P-touch Template mode.
P-touch Template mode can be selected by using the P-touch Template Settings tool shown below.
- 13 -
3. Examples for Using Commands
^LL609
Entered command
^PW406
Entered command
^FO80,290
^A0N,50,50
^FDAt your side
Entered command
Step 2: Set the label length with ^LL.
The label length is 609 dots.
Step 3: Set the label width with ^PW.
The label width is 406 dots.
Step 4: Send other ZPL II commands.
The orientation of the text is 80, 290.
The font is outline font and size is 50, 50.
P-touch Template 2.0 Command Reference
The text is “At your side.”
Summar y -all commands to be sent to make the label-
^XA
^LL609
^PW406
^FO80,290
^A0N,50,50
^FDAt your side
^XZ
Note
“^XZ” is the command required at the end of for mat with ZPL II commands.
- 14 -
3. Examples for Using Commands
With those commands above, the label below is printed.
P-touch Template 2.0 Command Reference
- 15 -
3. Examples for Using Comm ands
P-touch Template 2.0 Command Reference
Stored template
Assigned number
Click[Transfer] button.
3.3 Example for printing logo/external characters in P-touch Template 2.0
Here is the label to be printed.
Steps
1. Make a template and transfer it to the printer.
2. Store the logo/external characters as a bitmap file.
3. Transfer the bitmap file from Transfer Manager to the printer.
4. In the P-touch Template Settings tool, select the assigned number for the stored template.
5. With the P-touch Template commands, select the assigned number for the bitmap file.
Step 1: Make a template and transfer it to the printer.
- 16 -
3. Examples for Using Commands
P-touch Template 2.0 Command Reference
Example file name is “_ext_logo.bmp”
Assigned number
Click[Transfer] button.
(1) Select the P-touch Template mode.
(2) Choose the assigned number.
Step 2: Store the loge/external characters as a bitmap file. The file name should be started from
“_ext_”,, and drag & drop it to Transfer Manager.
Step 3: Transfer the bitmap file from Transfer Manager to the printer.
Step 4: In the P-touch Template Settings tool, select the assigned number for the stored template.
- 17 -
3. Examples for Using Commands
P-touch Template 2.0 Command Reference
^II
Entered
command
In order to select the bitmap file, enter a specific character
d the value one less than the assigned number for the
enter \01 as shown right.
\01
Entered command
^FF
Entered command
Step 5: With the P-touch Template 2.0 commands, select the assigned number for the bitmap file.
After using the P-touch Template Settings tool in Step 4, the remaining three commands must be sent to
the printer.
(1) Initialize P-touch Template
(2) Select the bitmap file to be printed.
“\” an
bitmap file that is shown in Step 3.
For example, if the assigned number for the bitmap file is 2,
(3) Start printing.
When the printer receives the command above, the label below is printed.
- 18 -
3. Examples for Using Commands
P-touch Template 2.0 Command Reference
4. P-touch Template 2.0 Limitations
4.1 Relating to text objects
4.1.1 Font, size, etc.
Please also refer to “5.2 Relationship between the P-touch Editor settings and the printer image” on page 28 When a template is transferred to a printer, a font specified in P-touch Editor is changed to most similar
resident font in the printer.
Character sizes specified in P-touch Editor are converted to the closest built-in character size when the
data is sent to the printer.
Character sizes specified in P-touch Editor are all made the same size within an object.
Depending on the language of the computer used for transferring, either the Western European or the
Eastern European character set is used for characters within text objects.
“\” is used as control character for an external character. When “\” has to be used as a data, input “\\”.
When “At Printing” check box is NOT checked, the time and date when editing P-touch Editor is applied
and printed. When “At Printing” check box is checked, time and date is not printed.
“At Printing” setting
To cancel the “At Printing” setting for a date/time in P-touch Editor, display the properties for the Date and
Time object, and then clear the “At Printing” check box.
- 19 -
4. P-touch Template 2.0 Limitations
P-touch Template 2.0 Command Reference
4.1.2 Character alignment
Horizontal alignment settings (“Justify” or “Equal Length”) specified in P-touch Editor are changed to the
left alignment setting.
The setting for line feed with a line feed specified with the P-touch Editor can be set between 0 and 255
dots.
A negative line spacing setting cannot be used in P-touch Editor. In addition, since there is an upper limit
for the line width with the printer, a line spacing setting larger than this limit specified in P-touch Editor will
not be applied on the printer.
Specifying the line spacing setting in P-touch Editor
- 20 -
4. P-touch Template 2.0 Limitations
P-touch Template 2.0 Command Reference
The text object size is fixed, and the text size is changed depending on the text
length.
The text object size is fixed, and the text size is fixed. If the text is too long, the text
is not printed.
The text object width is fixed, and the text size is fixed. If the text is too long, the text
object height is increased.
Automatic
Length
The text object height is fixed, and the text size is fixed. If the text is too long, the
text object width is increased.
The text size is fixed. If the text is too long, the text object width is increased. If a
new line is started, the text height is increased.
4.1.3 Text Layout settings
Character styles specified in P-touch Editor all become the same style within an object.
If the “Long text” is selected under “Text Layout” in P-touch Editor, the text is always aligned at top left.
If the “Long Text” setting is selected under “Text Layout” in P-touch Editor and continuous length tape is
used, the print length is increased to fit the text.
If the “Fixed Frame Size (Wrap)” setting is selected under “Text Layout” in P-touch Editor, the object size
does not change, and the text size is reduced.
“Fixed Frame Size (Wrap)” is a setting that was added for inserting long text. Since it is possible that the
text size may become extremely small if the wrapping feature is no longer applied, we recommend that
“Fixed Frame Size” be selected when die-cut labels or a fixed length is specified in P-touch Editor, or that
“Automatic Length” be selected when an automatic media length is specified.
Shrink to Fit
Clip Text
Long Text
Free Size
Specifying a Text Layout setting
Click the button circled in red to display a drop-down list, and then select the desired option.
When trying to transfer a template containing a barcode that is not compatible with the printer, an error will
occur while transferring and the template cannot be transferred to the printer.
The following barcodes are compatible with the RJ-2XXX.
1D barcodes
If data containing characters incompatible with the protocol are fed into the barcode object, that barcode
object is not printed.
The barcode size may differ from that in the print result with P-touch Editor.
Since CODE128 and GS1-128(UCC/EAN-128) can easily be printed slightly larger, we recommend
leaving larger margins when creating templates in P-touch Editor.
If data fed into a barcode in a template created with P-touch Editor causes an extremely long barcode, the
barcode may not be fully printed.
Do not insert line feed immediately before or immediately after the barcode data. Otherwise, it will be
considered as part of the barcode data. In that case, the barcode will be created containing the line feed
code, or the barcode will not be printed since data incompatible with the barcode protocol is entered.
A delimiter or print start text string should be entered immediately after the barcode data.
- 22 -
4. P-touch Template 2.0 Limitations
P-touch Template 2.0 Command Reference
1 to 50 characters (not including “*” on both sides)
skipped.
ITF
I-2/5
1 to 64 characters
The bearer bar setting specified in P-touch Editor is invalid.
EAN-8
7 characters
EAN-13
12 characters
UPC-A
11 characters
UPC-E
6 characters
CODABAR
3 to 64 characters (with “A”, “B”, “C” or “D” at the beginning and end)
CODE128
1 to 64 characters
GS1-128
(UCC/EAN-128)
RSS-14
3 to 15 characters (begins with “01”)
RSS Limited
3 to 15 characters (begins with “01”; third digit is “0” or “1”)
RSS Expanded
1 to 64 numbers or 1 to 40 letters*
POSTNET
5, 9 or 11 characters
4.2.2 1D barcodes
A barcode wider than 22.5 cm will not be printed.
A 1D barcode taller than 1164 dots is converted to 1164dots.
The number of characters that can be entered for each protocol is shown below.
CODE39
When feeding data, the asterisks (*) at the beginning and end of the data are
1 to 64 characters
* ISO646 characters can be printed.
<<numbers, letters, spaces, !, ”, %, &, ’, (, ), *, +, ,, -, ., /, :, ;, <, =, >, ? and _>>
When trying to transfer data exceeding the ranges described above, an error will occur while
transferring. If the data that is fed does not meet the minimum limit, the barcode is not printed. If the
data exceeds the maximum limit, only the data to the maximum limit is applied.
- 23 -
4. P-touch Template 2.0 Limitations
The version setting for a QR Code specified in P-touch Editor is invalid. The
The Structured Append settings specified in P-touch Editor are invalid.
Since the error correction levels for PDF417 specified in P-touch Editor are
The Structured Append settings specified in P-touch Editor are invalid.
The Structured Append settings specified in P-touch Editor are invalid.
Macro settings specified in P-touch Editor are invalid
The Structured Append settings specified in P-touch Editor are invalid.
P-touch Editor: “200”; Printer: “002”
The Remove Character setting specified in P-touch Editor is invalid.
specified in P-touch Editor are invalid.
4.2.3 2D barcodes
P-touch Template 2.0 Command Reference
QR Code
PDF417
Data Matrix
Maxi Code
Aztec
version setting must be turned off.
inconsistent with those on the printer, the size of the barcode may change when
it is printed with P-touch Template 2.0.
The barcode is partitioned when too much data is entered.
When specifying the country code and service class with P-touch Editor, the
number is entered at the beginning if the maximum number of characters is not
reached. However, with the printer, the number is entered at the end.
Example: “2” is specified.
When the Number of Parts in the Set Structured Append setting is specified as
Auto, the number of appended blocks becomes 2.
The Code Spacing and Join Vertically in the Set Structured Append settings
- 24 -
4. P-touch Template 2.0 Limitations
Loading...
+ 95 hidden pages
You need points to download manuals.
1 point = 1 manual.
You can buy points or you can get point for every manual you upload.