If printing does not begin (main most frequent cause) ....................................................11 2
If a template linked to a database is not printed ..............................................................112
Appendix D: Introducing the Brother Developer Center ····························· 113
- iii -
P-touch Template Command Reference
Introduction
This material provides the necessary information for directly controlling the templates transferred to PT-P9XX.
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 PT-P9XX, 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 Command Reference
2.Design the
1.Set up the printer from the computer according to
configuration of the host device.
3. Transfer the
What is P-touch Template?
P-touch Template is a tool for transferring ASCII text and binary data from a host device to a template
transferred to the printer. This transferred data is inserted into text objects or bar code objects in the
template.
template in
P-touch Editor,
and then transfer
it to the printer.
data (text) from
the host device,
and then print it
in the template.
This allows the user to develop a printing system that connects directly from the host device.
Compatible host devices are listed below.
- Scale/measurement devices
- Medical devices
- Bar code readers
- Control devices in any system environment
Note
* The host device should be equipped with a connector for a serial cable (RS-232C) or USB-A cable in
order to transfer the data.
* P-touch Te mplate is not compatible with some hosts.
- 2 -
What is P-touch Template?
touch Template Settings tool, specify the initial
printer settings according to the host system environment
touch Template Settings Tool User’s
The printer driver must first be installed via a USB
touch Editor, design the template to be transferred
touch Transfer Manager, transfer the templates to
dance with the
Connect the printer to the host device by using a serial
1. Using P-touch Template
(1) Set up the printer.
Using the P-
or the host that the printer is connected to.
(Please refer to “2. P-
Guide” )
connection.
(2) Design the template.
Using Pto the printer.
P-touch Template Command Reference
(Please refer to “4. P-touch Template Limitations”)
(3) Transfer the templates.
Using Pthe printer.
(Please refer to the PT-900 Series Software User’s Guide.)
(4) Program using P-touch Template commands.
If any special commands are required to control the printer,
change the terminal program in accor
P-touch Template commands.
(Please refer to “6. Control Code Lists”)
(5) Connect the printer with the host and print slips etc.
cable (RS-232C) or USB-A cable.
Transfer the data, such as ASCII text, from the host device
to templates on the machine, and print the labels
- 3 -
1. Using P-touch Template
2. P-touch Template Settings Tool User’s Guide
(1) Command mode setting
(2) Template number setting
(3) Delimiter setting
(4) Print start trigger setting
(5) Print start command
P-touch Template Command Reference
text string setting
(6) Print start data amount setting
(7) Character code set setting
(8 ) International character setting
(9) Prefix character setting
(10) Non-printed character setting
(11) Line feed character setting
(12) FNC1 replacement setting
(13) Number of copies setting
(14 ) Auto cut setting
(15) Half cut setting
(16) Special tape setting
(17) Cut number setting
(18) Chain printing setting
(19) Mirror printing setting
(20) Communication settings
Applies settings for (1) through (20) to the machine.
Closes the tool.
Returns (1) through (19) to their default settings.
- 4 -
2. P-touch Template Settings Tool User’s Guide
P-touch Template Command Reference
(1) Command mode setting
- P-touch Template mode (Fixed)
To use P-touch Template, select the P-touch Template mode.
(2) Template number setting
Specify the template number selected as the default when the machine is turned on.
However, if any template has been set to not be transferred to the machine, 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 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.
- 5 -
2. P-touch Template Settings Tool User’s Guide
P-touch Template Command Reference
(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 codes. For details on the character code tables,
refer to the character code tables in the P-touch Template Command Reference.
Windows 1252
Windows 1250
Brother standard
(8) International character setting
Select one of the following as the character set of the country.
- USA
- France
- Germany
- UK
- Denmark
- Sweden
- Italy
- Spain
- Japan
- Norway
- Denmark II
- Spain II
- Latin America
- 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.
- 6 -
2. P-touch Template Settings Tool User’s Guide
P-touch Template Command Reference
(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
(12) FNC1 replacement setting
This setting selects whether or not GS codes, which are included in bar code 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) Auto cut setting
If auto cutting is selected, the cut operation will be performed after the number of labels specified in (17).
(15) Half cut setti ng
Specifies half cutting. If the check box is selected, half cuts are made. If the check box is cleared, half cuts
are not made.
(16) Special tape setting
Specifies the special tape (no cut) setting. If the check box is selected, the special tape setting is enabled,
and the auto cut and chain printing settings are disabled (same as being turned off). If the check box is
cleared, the special tape setting is disabled, and the operations for the auto cut and chain printing settings
are performed as specified.
Returns the four parameters to
thei r default settin gs.
Closes the Communication
Settings dialog box.
(17) Cut number setting
A number between 1 and 99 can be specified.
(18) Chain printing setting
Specifies chain printing. If the check box is selected, chain printing is enabled, and the tape is not fed or
automatically cut after the last label is printed. If the check box is cleared, chain printing is disabled, and
the tape is fed and automatically cut after the last label is printed.
(19) Mirror printing setting
Specifies mirror printing. If the check box is selected, mirror printing is enabled. If the check box is cleared,
mirror printing is disabled.
(20) Communication settings
Settings can be specified for the following parameters for serial communication.
Baud rate
Applies the four settings to the printer.
- 8 -
2. P-touch Template Settings Tool User’s Guide
P-touch Template Command Reference
Others
・ini file
After the [Set] button (in the main dialog box or the Communications Settings dialog box) is clicked, the
settings are saved and the dialog box is closed.
C: \Users\ (user_account_name) \AppData\Roaming\Brother\Printer Settings\ptsXX30.ini
Note: A name of file “ptsXX30.ini” varies depending on printers like below.
- PT-P900W pts6F30.ini
- PT-P950NW pts7030ini
Note: A file path above might be different depending on OS.
・Entering text in text boxes (3), (5), (9) and (10)
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: PRINT : [PRIN T]
TAB control code : [\09]
Return control code : [\0D]
\ : [\\]
- 9 -
2. P-touch Template Settings Tool User’s Guide
3. Examples for Using Commands
3.1 Example for using P-touch Template
Here is the label that will be made.
The media size is 0.70 inches
Steps
P-touch Template Command Reference
1. Make a template with P-touch Editor.
2. Transfer the template to Transfer Manager.
3. Transfer the template from Transfer Manager to the printer.
4. Use P-touch Template commands for printing.
Step 1: Make a template with P-touch Editor.
Start the P-touch Editor and make a label.
- 10 -
3. Examples for Using Commands
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 Command Reference
Stored template
Assigned number
Step 3: Transfer the template from Transfer Manager to the printer.
Click [Transfer] button.
- 11 -
3. Examples for Using Commands
P-touch Template Command Reference
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 commands for printing.
When using P-touch Template 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.
(1) Select the P-touch Template mode (Fixed)
(2) Choose the assigned number
After setting (1) and (2) with the P-touch Template Settings tool, the other two commands must be sent
to the printer.
- 12 -
3. Examples for Using Commands
^II
Entered command
^FF
Entered command
(3) Initialize P-touch Template
(4) Print Start
P-touch Template Command Reference
When the printer receives the command above, the label below is printed.
- 13 -
3. Examples for Using Commands
2. Store the logo/external characters as a bitmap file, and drag & drop it to Transfer Manager.
3.2 Example for printing logo/external characters in P-touch Template
Here is the label to be printed.
P-touch Template Command Reference
Steps
1. Make a template and transfer it to the printer.
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.
Assigned number
Stored template
- 14 -
3. Examples for Using Commands
P-touch Template Command Reference
Step 2: Store the logo/external characters as a bitmap file, and drag & drop it to Transfer Manager.
Click [Transfer] button.
Step 3: Transfer the bitmap file from Transfer Manager to the printer.
Assigned number
Stored the logo/external character as a bitmap
- 15 -
3. Examples for Using Commands
P-touch Template Command Reference
^II
Entered command
In order to select the bitmap file, enter a specific character
” and the value one less than the assigned number for the
For example, if the assigned number for the bitmap file is 2,
Step 4: In the P-touch Template Settings tool, select the assigned number for the stored template.
(1) Select the P-touch Template mode (Fixed)
(2) Choose the assigned number
Step 5: With the P-touch Template 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.
“\
bitmap file that is shown in Step 3.
Entered command
\01
enter \01 as shown right.
The command \01 is written in Hexadecimal : 5C 30 31
- 16 -
3. Examples for Using Commands
^FF
Entered command
(3) Start printing.
When the printer receives the command above, the label below is printed.
P-touch Template Command Reference
- 17 -
3. Examples for Using Commands
P-touch Template Command Reference
4. P-touch Template 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 Fonts specified in P-touch Editor are converted to Helsinki, Letter Gothic or Brussels, depending on the font
shape, when the data is sent to the machine.
(The font is converted according to the following rules: fixed pitch: Letter Gothic; serif: Brussels; san serif:
Helsinki. Symbol fonts are converted to text objects if text input mode has been entered, and fonts are
divided into three categories, as described above. If the text input mode has been exited, they are
converted to image objects and the selected font is not converted.)
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, if the TDU is connected, the time and date printed is
the same as TDU and if the TDU is not connected, time and date is not printed.
- 18 -
4. P-touch Template Limitations
P-touch Template Command Reference
“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 Limitations
P-touch Template 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 Limitations
P-touch Template 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.
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 (W rap)” 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
Automatic Length
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 PT-P9XX.
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 Limitations
P-touch Template 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 454 dots is converted to 454dots.
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. However, if the data
exceeds 64 characters, the barcode is not printed.
- 23 -
4. P-touch Template 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
n the printer, the size of the barcode may change when
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.
number is entered at the beginning if the maximum number of characters is not
P-touch Editor: “200”; Printer: “002”
The Remove Character setting specified in P-touch Editor is invalid.
When the Number of Parts in the Set Structured Append setting is specified as
The Code Spacing and Join Vertically in the Set Structured Append settings
specified in P-touch Editor are invalid.
4.2.3 2D barcodes
P-touch Template Command Reference
QR Code
PDF417
Data Matrix
MaxiCode
AztecCode
version setting must be turned off.
inconsistent with those o
it is printed with P-touch Template.
The barcode is partitioned when too much data is entered.
When specifying the country code and service class with P-touch Editor, the
reached. However, with the printer, the number is entered at the end.
Example: “2” is specified.
Auto, the number of appended blocks becomes 2.
- 24 -
4. P-touch Template Limitations
P-touch Template Command Reference
4.3 Relating to images
If a template containing overlapping images is transferred with P-touch Editor, all image data will be
overlapping. (P-touch Editor displays the image created last on top.)
4.4 Relating to Numbering
A single object contains a single Numbering field.
A Numbering field can contain a maximum of 15 digits. If the field contains more than 15 digits, Numbering
will only be performed with the last 15 digits.
Only Numbering fields will be saved in Numbering objects when printing is finished.
If the number of characters that was fed in is less than the number of characters in the Numbering object, it
may not be printed correctly.
If a line feed exists in the numbering area, characters after line feed are deleted.
Note
Numbering objects refer to text objects or barcode objects that have the Numbering function
applied.
4.5 Relating to Database
When a database is transferred, it is named using the file name + sheet name (when created in Excel).
The file name can contain up to 15 bytes of characters (15 one-byte characters or 7 two-byte characters).
A maximum of 99 databases can be transferred. However, the transfer cannot be completed if the amount
of data being transferred exceeds7MByte.
If there is a line feed in a cell containing text to be replaced, only the string of characters before the line
feed will be replaced.
The text to be replaced can contain up to 256 characters.
The maximum number of database line is 65000 lines included the title. If the database is over 65000 lines,
the only lines over 65000 are deleted.
A database can contain a maximum of 100 columns. If a database containing more than 100 columns is
transferred, all data after the 100th column will be deleted.
If there is no database linked to the template being printed, or if the corresponding string of characters to
be replaced cannot be found, an error occurs.
If columns linked to the template being printed are not in the database, the objects related to those
columns remain as they were when the template was transferred.
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 databases.
- 25 -
4. P-touch Template Limitations
P-touch Template Command Reference
4.6 Others
4.6.1 Transferring templates
A maximum of 99 templates can be transferred. The transfer cannot be completed if the amount of data
being transferred exceeds 7MByte.
A single template can contain a maximum of 50 objects. When trying to transfer more than 50 objects, an
error will occur and the transfer cannot be completed.
When print data is fed, the command mode should be the P-touch Template mode.
When a template is transferred to the printer, all values specified with dynamic commands are initialized.
This is not compatible with split labels.
After printing from P-touch Editor, the command mode changes to raster mode. In order to print a template,
select the P-touch Template mode in the P-touch Template Settings tool or, if the previous mode in the
P-touch Template Settings tool was the P-touch Template mode, turn the printer off, then on again to enter
P-touch Template mode.
4.6.2 About objects in a template
The line feed codes (0D0A, 0D and 0A) in print data are read, then discarded. However, when specified as
special data, such as delimiters, print start text strings or line feed commands, they are applied.
The order of the objects is determined only by the last four-digit number of the object name. Objects with
no numbers in their names will be at the end of the order. If objects have the same number, the order is
determined in the following order: text, 1D barcodes, then 2D barcodes. If the objects are of the same type,
the object created first is first in the order. We recommend that the numbers indicating the order be added
at the end of the object name.
(To specify the name of an object in P-touch Editor, display the properties of the text or barcode object, and
then specify the name in the “Object Name” box on the Expanded tab.)
Specifying the object name
- 26 -
4. P-touch Template Limitations
P-touch Template Command Reference
5. Precautions
5.1 Notes for printers with Bluetooth interface
If the printer is connected using Bluetooth, the printer may not be ready immediately after the port is opened.
When sending print data, wait at least 500 msec after the port has been opened before starting to send the
data.
In addition, if the port is continuously opened and closed, for example, when printing multiple pages, wait at
least 500 msec after the port is closed before opening the port the next time.
Once the print data for one page has been sent, do not close the Bluetooth port until printing is finished.
- 27 -
5. Precautions
(Text Layout settings)
Printer ima ge
Layout
Options
Text
text is not printed.
If the text is too long,
not printed.
Shr ink to Fit
If the text is too long,
Clip Text
Selected
Shr ink to Fit
Selected
(Wrap)
line.
If the text is too long,
frame.
the frame.
5.2 Relationship between the P-touch Editor settings and the printer image
P-touch Editor setting
Text options
Width Height
Text
Details-
Wrap
Frame Size Text Size Frame Size Text Size
P-touch Template Command Reference
Printed
image
Clip Text
Fixed
Frame Size
Fixed
Frame Size
Long Text -
Automatic
Length
-
-
Fixed
If the text is too
long, the overflow
Fixed
If the text is too
long, even with
the minimum text
size, the overflow
text is printed
outside the
frame.
Fixed
The overflow text
is automatically
sent to the new
Eve n t he
overflow text is
printed outside
the frame.
Fixed
Auto
The text is
automatically
maximize d to
fit the frame
size.
Fixed
Fixed
Fixed
the overflow text is
Fixed
eve n with t he
minimum text size,
the overflow text is
printed outside the
frame.
Even the overflow
text is printed
outside the frame.
Fixed
eve n with t he
minimum text size,
the overflow text is
printed outside the
Fixed
Auto
The text is
automatically
maximize d to
fit the frame
size.
Fixed
Auto
The text is
automatically
maximize d to
fit the frame
size.
1
(See
below.)
2
(See
below.)
3
(See
below.)
4
(See
below.)
Free Size -
Printed image
1
2
Eve n t he
overflow text is
printed outside
3
Fixed
- 28 -
Even the overflow
text is printed
outside the frame.
4
Fixed
5
(See
below.)
5
5. Precautions
P-touch Template Command Reference
5.3 Making a template in order to save time before starting to print
Perform the following operation to convert permanent objects into images.
- In the Text Properties dialog box, select the Expanded tab, and then select the “Text Cannot Be Edited”
check box.
- If the Expanded tab of the Text Properties dialog box is not displayed, click [Options] on the Tools menu,
and then select the “Display Expanded Tabs of Object Properties” check box on the General tab.
Specify the text options (Text Layout settings) so that the text size is fixed.
- 29 -
5. Precautions
P-touch Template Command Reference
ASCII Code
Binary Code
Static/Dynamic
Description
6. Control Code Lists
6.1 Setting and retrieving commands for P-touch Template mode
With static commands, settings specified with a command are saved and stored in the memory.
With dynamic commands, settings specified with a command are temporarily saved and applied until the
machine is turned off.
^PT 5E 50 54 Dynamic Select print start trigger
^FF 5E 46 46 Start printing
^PS 5E 50 53 Dynamic Specify print start command text string
^PC 5E 50 43 Dynamic Specify print start received character count
^SS 5E 53 53 Dynamic Specify delimiter
^TS 5E 54 53 Dynamic Select template
^LS 5E 4C 53 Specify line spacing with line feed
^CC 5E 43 43 Dynamic Change prefix character
^RC 5E 52 43 Dynamic Specify line feed command text string
^CN 5E 43 4E Specify number of copies
^NN 5E 4E 4E Specify number of Numbering copies
^ID 5E 49 44 Initialize template data
^QV 5E 51 56 Dynamic Specify QR Code version
^FC 5E 46 43 Dynamic FNC1 replacement setting
^CF 5E 43 46 Dynamic Full cut setting
^CH 5E 43 48 Dynamic Half cut setting
^CP 5E 43 50 Dynamic Chain printing setting
^MP 5E 4D 50 Dynamic Mirror printing setting
^II 5E 49 49 Initialize
^OP 5E 4F 50 Perform machine operations (feed/cut)
^SR 5E 53 52 Status request
- 30 -
6. Control Code Lists
P-touch Template Command Reference
ASCII Code
Binary Code
Static/Dynamic
Description
^VR 5E 56 52
Retrieve version Information
^CR 5E 43 52 Line feed in object
^OS 5E 4F 53 Select object (object number)
^ON 5E 4F 4E Select object (object name)
^DI 5E 44 49 Directly insert object
ESC ia 1B 69 61 Dynamic Specify command mode
Note
* The commands listed above must be used in P-touch Template mode.
* These commands (except ESC ia) cannot be used in raster mode or ESC/P mode.
* With dynamic commands, settings specified with a command are temporarily saved and applied
until the printer is turned off.
- 31 -
6. Control Code Lists
P-touch Template Command Reference
ASCII Code
Binary Code
Static/Dynamic
Description
6.2 Setting and retrieving commands for raster mode
This command selects whether or not GS codes, which are included in bar code protocols such as
GS1-128 (UCC/EAN-128), are replaced with FNC1 codes.
This command is a dynamic command.
Remarks
Invalid if n is a value other than 1 or 0
Example
To disable FNC1 replacement:
Since FNC1 replacement will be disabled, n=0. Therefore, the command will be as follows.
^ F C 0
(5Eh 46h 43h 30h)
- 48 -
7. Control Command Details
(n1*10)+n2:
Full cut and number of copies settings
(00: OFF; 01 to 99: Number of copies) (Default value: 01)
^CF Full cut setting
ASCII: ^ C F n1 n2
Decim al: 94 67 70 nd1 nd2
Hexadecimal: 5E 43 46 nh1 nh2
Parameters
0≤n1≤9
0≤n1≤9
Description
Specifies whether or not full cut is used, and specifies the number of copies.
This command is a dynamic command.
P-touch Template Command Reference
Remarks
The full cut label number setting can be between 1 and 99. This command becomes invalid if any other
value has been specified.
Example
To cut after every two labels:
Since the auto cut label number will be set to 2, n1=0 and n2=2. Therefore, the command will be as follows.
^ C F 0 2
(5Eh 43h 46h 30h 32h)
- 49 -
7. Control Command Details
n:
Half cut setting
(ON: 1 (default); OFF: 0)
^CH Half cut setting
ASCII: ^ C H n
Decim al: 94 67 72 nd
Hexadecimal: 5E 43 48 nh
Parameters
0≤n≤1
Description
Specifies whether or not half cut is used.
This command is a dynamic command.
Remarks
P-touch Template Command Reference
Invalid if n is a value other than 1 or 0
Example
To make half cuts:
Since half cuts will be enabled, n=1. Therefore, the command will be as follows.
^ C H 1
(5Eh 43h 48h 31h )
- 50 -
7. Control Command Details
n:
Chain printing setting
(OFF: 0 (default); ON: 1)
^CP Chain printing setting
ASCII: ^ C P n
Decim al: 94 67 80 nd
Hexadecimal: 5E 43 50 nh
Parameters
0≤n≤1
Description
Specifies whether or not chain printing is applied.
This command is a dynamic command.
Remarks
P-touch Template Command Reference
Invalid if n is a value other than 1 or 0
Example
To use chain printing:
Since chain printing will be enabled, n=1. Therefore, the command will be as follows.
^ C P 1
(5Eh 43h 50h 31h )
- 51 -
7. Control Command Details
n:
Mirror printing setting
(OFF: 0 (default); ON: 1)
^MP Mirror printing setting
ASCII: ^ M P n
Decim al: 94 77 80 nd
Hexadecimal: 5E 4D 50 nh
Parameters
0≤n≤1
Description
Specifies whether or not mirror printing is applied.
This command is a dynamic command.
Remarks
P-touch Template Command Reference
Invalid if n is a value other than 1 or 0
Example
To use mirror printing:
Since mirror printing will be enabled, n=1. Therefore, the command will be as follows.
^ M P 1
(5Eh 4Dh 50h 31h )
- 52 -
7. Control Command Details
(1)
Select print start trigger
(2)
Specify print start command text string
(3)
Specify print start received character count
(4)
Delimiter setting
(5)
Select template
(6)
Full cut setting
(7)
Half cut setting
(8)
Chain printing setting
(9)
Mirror printing setting
(10)
Special tape setting
(11 )
Change prefix character
(12)
Specify line feed command text string
(13)
Specify number of copies
(14)
Specify QR Code version
(15)
FNC1 replacement setting
^II Initialize
ASCII: ^ I I
Decim al: 94 73 73
Hexadecimal: 5E 49 49
Parameters
None
Description
Reverts all dynamic settings to the machine settings.
P-touch Template Command Reference
Remarks
All data already fed in, selected objects and the search text are initialized.
- 53 -
7. Control Command Details
n=4
Performs the feed and cut operation
^OP Perform machine operations (feed/cut)
ASCII: ^ O P n
Decim al: 94 79 80 nd
Hexadecimal: 5E 4F 50 nh
Parameters
n = 4
Description
Causes the machine to perform a feed and cut operation.
Remarks
Invalid if n is a value other than 4
P-touch Template Command Reference
Example
To specify that the machine performs a feed and cut operation:
^ O P 4
(5Eh 4Fh 50h 34h)
- 54 -
7. Control Command Details
Number
Offset
Size
Name
Value/Reference
1 0 1
Print head mark
Fixed at 80h
2 1 1
Size
Fixed at 20h
3 2 1
Brother code
Fixed at “B” (42h)
4 3 1
Series code
Fixed at “0” (30h)
5 4 1
6 5 1
Country code
Fixed at “0” (30h)
7 6 1
Battery level information
Refer to table (11) below.
8 7 1
Extended error
Refer to table (10) below.
9 8 1
Error information 1
Refer to table (1) below.
10 9 1
Error information 2
Refer to table (2) below.
11
10
1
Media width
Refer to table (3) below.
12
11
1
Media type
Refer to table (4) below.
13
12
1
Number of colors
Fixed at 00h
14
13
1
Internal font information
Fixed at 00h
15
14
1
Internal Japanese font information
Fixed at 00h
16
15
1
Mode
Fixed at 00h
17
16
1
Density
Fixed at 00h
18
17
1
Media length
Refer to table (3) below.
19
18
1
Status type
Refer to table (5) below.
20
19
1
Phase type
Refer to table (6) below.
21
20
1
Phase number (higher order bytes)
Fixed at 00h
22
21
1
Phase number (lower order bytes)
Fixed at 00h
23
22
1
Notification number
Refer to table (7) below.
24
23
1
Expansion area (number of bytes)
Fixed at 00h
^SR Status request
ASCII: ^ S R
Decim al: 94 83 82
Hexadecimal: 5E 53 52
Parameters
None
Description
The printer status is returned.
The printer status consists of 32 bytes.
P-touch Template Command Reference
Model code
“o” (6Fh) : P900W
“p” (70h) : P950NW
- 55 -
7. Control Command Details
Number
Offset
Size
Name
Value/Reference
25
24
1
Media color information
Refer to table (8) below.
26
25
1
Ribbon color information
Refer to table (9) below.
27
26
6
Not used
Fixed at 00h
Flag
Mask
Definition
Bit 0
01h
Not used
Bit 1
02h
Not used
Bit 2
04h
“Cutter jam” error
Bit 3
08h
Low battery
Bit 4
10h
Not used
Bit 5
20h
Not used
Bit 6
40h
Not used
Bit 7
80h
Not used
Flag
Mask
Definition
Bit 0
01h
Not used
Bit 1
02h
Not used
Bit 2
04h
Not used
Bit 3
08h
Not used
Bit 4
10h
“Cover open” error
Bit 5
20h
High temperature error
Bit 6
40h
Feed error
Bit 7
80h
System error
(1) Error information 1
P-touch Template Command Reference
(2) Error information 2
- 56 -
7. Control Command Details
Media type
Media width
Media length
No tape
00h
00h
3.5-mm-wide tape
04h
00h
6-mm-wide tape
06h
00h
9-mm-wide tape
09h
00h
12-mm-wide tape
0Ch
00h
18-mm-wide tape
12h
00h
24-mm-wide tape
18h
00h
36-mm-wide tape
24h
00h
HS 5.8-mm-wide tape
06h
00h
HS 8.8-mm-wide tape
09h
00h
HS 11.7 -mm-wide tape
0Ch
00h
HS 17.7-mm-wide tape
12h
00h
HS 23.6-mm-wide tape
18h
00h
FLe 21mm x 45mm-wide tape
15h
2Dh
Media type
Value
No tape
00h
Laminated tape
01h
Non-laminated tape
03h
Fabric tape
04h
Heat-shrink Tube
11h
FLe tape
13h
Flexible ID tape
14h
Satin tape
15h
Incompatible tape
FFh
(3) Media width, Media length
P-touch Template Command Reference
(4) Media type
- 57 -
7. Control Command Details
Status type
Value
Reply to status request
00 h
Not use
01 h
Error occurred
02 h
Not use
03 h
Not use
04 h
Notification
05 h
Phase change
06 h
(Not used)
07h to 20h
Usage prohibited
21h to FFh
Phase type
Value
(Reception possible) Edit
00h
Printing
01h
Cover opened while
(5) Status type
(6) Phase type, number
P-touch Template Command Reference
Edit
Phase number (Dec) higher order bytes lower order bytes
(Reception possible)Edit 0 00h 00h
Feed 1 00h 01h
Printing
Phase number (Dec) higher order bytes lower order bytes
Printing 0 00h 00h
Not use 10 00h 0Ah
20 00h 14h
receiving data
Not use 25 00h 19h
- 58 -
7. Control Command Details
TZe-535(12mm)
(7) Notifica tion number
(No notification) 00h
Cover open 01h
Cove r close 02h
Cooling started 03h
Cooling finished 04h
(8) Media color information
Media color Media color ID Remarks
White 01h
Other 02h
Clear 03h
Red 04h
P-touch Template Command Reference
Notification Value
Blue 05h
Yellow 06h
Green 07h
Black 08h
Clear 09h
Matte White 20h
Matte Clear 21h
Matte Silver 22h
Satin Gold 23h
Satin Silver 24h
Blue 30h
TZe-545(18mm)
TZe-555(24mm)
Red 31h TZe-435(12mm)
Fluorescent Orange 40h
Fluorescent Yellow 41h
Berry Pink 50h TZe-MQP35
Light Gray 51h TZe-MQL35
Lime Green 52h TZe-MQG35
Yellow 60h
Pink 61h
Blue 62h
Heat-shrink Tube 70h
- 59 -
7. Control Command Details
White(Flex. ID)
Media colorMedia color IDRemarks
Yellow(Flex. ID) 91h
Clearning F0h
Stencil F1h
Cooling finished FFh
(9) Ribbon color infor mation
P-touch Template Command Reference
90h
Ribbon color Ribbon color ID
White 01h
Red 04h
Blue 05h
Black 08h
Gold 0Ah
Blue 62h
Clearning F0h
Stencil F1h
Other 02h
Incompatible FFh
(10) Extended error information
Error information Value
High resolution/High- speed printing error 1Dh
Power switching error 1Eh
Battery error 1Fh
Incompatible media error 21h
(11) Battery level information
Battery level Value
Full battery 00h
Half battery 01h
Low battery 02h
Changing required 03h
AC adapter in use 04h
Undetectable FFh
- 60 -
7. Control Command Details
^VR Retrieve version information
ASCII: ^ V R
Decim al: 94 86 82
Hexadecimal: 5E 56 52
Parameters
None
Description
Retrieves the version information for the machine as a 16-character text string.
P-touch Template Command Reference
- 61 -
7. Control Command Details
1
2
3
^CR Line feed in object
ASCII: ^ C R
Decim al: 94 67 82
Hexadecimal: 5E 43 52
Parameters
None
Description
Adds a return to the next line in the text object.
Valid even if the text string for the line feed command has been changed
Example
To print three lines:
P-touch Template Command Reference
Code: 1 ^ C R 2 ^ C R 3 ^ F F
(31h 5Eh 43h 52h 32h 5Eh 43h 52h 33h 5Eh 46h 46h)
Print result:
- 62 -
7. Control Command Details
(n1*10)+n2:
Object number (1 to 50)
^OS Select object (object number)
ASCII: ^ O S n1 n2
Decim al: 94 79 83 nd1 nd2
Hexadecimal: 5E 4F 53 nh1 nh2
Parameters
0≤n1≤5
0≤n2≤9
Description
Selects an object by its object number.
Remarks
P-touch Template Command Reference
The object number can be set between 1 and 50.
This command becomes invalid if any other value has been specified.
Use this command to insert data starting with an intermediary object.
Example
To select the 33rd object:
^ O S 3 3
(5Eh 4Fh 53h 33h 33h)
- 63 -
7. Control Command Details
P-touch Template Command Reference
data:
Text string (object name)
^ON Select object (object name)
ASCII: ^ O N data 00
Decim al: 94 79 78 datad 00
Hexadecimal: 5E 4F 4E datah 00
Parameters
None
Description
Selects an object by its object name.
Remarks
The maximum length of text that can be set is 20 characters. If text longer than this has been specified, the
command becomes invalid. In addition, the command becomes invalid if no text has been specified.
“00h” should be added at the end of the text. This indicates the end of the text.
Use this command to insert data starting with an intermediary object.
Example
To select an object with the name “TEXT1”:
^ O N T E X T 1 00h
(5Eh 4Fh 4Eh 54h 45h 58h 54h 31h 00h)
- 64 -
7. Control Command Details
P-touch Template Command Reference
(nh2*256)+nh1:
Specified number of characters (bytes)
data:
Text string
1A2
^DI Directly insert object
ASCII: ^ D I n1 n2 data
Decim al: 94 68 73 nd1 nd2 datad
Hexadecimal: 5E 44 49 nh1 nh2 datah
Parameters
00h≤nh1≤FFh
00h≤nh2≤FEh
Description
Inserts a text string for the specified number of characters into the object selected in the selected template.
(If even a print command or delimiter is within the specified number of characters, they are treated as data.)
Example
If “A” is specified as the print start text string, and the print start trigger is specified as the print start text
string, simply print “A” by printing with the following command.
Code: ^ D I 03h 00h 1 A 2 A
(5Eh 44h 49h 03h 00h 31h 41h 32h 41h)
Print result:
- 65 -
7. Control Command Details
nh=00h or 30h:
ESC/P mode
nh=01h or 31h:
Raster mode
nh=03h or 33h:
P-touch Template mode (default)
ESC i a Specify command mode
ASCII: ESC i a n
Decim al: 27 105 97 nd
Hexadecimal: 1B 69 61 nh
Parameters
nh=00h 01h 03h 30h 31h 33h
Description
Switches the mode.
This command is a dynamic command.
P-touch Template Command Reference
Remarks
If the specified value is one other than those that can be set, raster mode will be entered.
- 66 -
7. Control Command Details
nh3=00h:
When the specified text string is received (default)
nh3=01h:
When all objects are filled
(Prints with the delimiter at the end of the data)
nh3=02h:
When the specified number of characters is received
(not including delimiters)
ESC iXT2 Select print start trigger
ASCII: ESC i X T 2 n1 n2 n3
Decim al: 27 105 88 84 50 nd1 nd2 nd3
Hexadecimal: 1B 69 58 54 32 nh1 nh2 nh3
Parameters
nh1=01h (Fixed)
nh2=00h (Fixed)
00h≤nh3≤02h
Description
Selects the print start trigger type.
P-touch Template Command Reference
This command is a static command.
Remarks
Invalid if nh3 is a value other than 00h through 02h
Example
When the print start trigger is “when all objects are filled”
ESC i X T 2 01h 00h 01h
(1Bh 69h 58h 54h 32h 01h 00h 01h)
- 67 -
7. Control Command Details
nh1+(nh2*256):
Length of the text string (can be set between 1 and 20)
data:
Text string (The maximum number of characters that can be set is 20 characters
(bytes).)
ESC iXP2 Specify print start command text string
ASCII: ESC i X P 2 n1 n2 data
Decim al: 27 105 88 80 50 nd1 nd2 datad
Hexadecimal: 1B 69 58 50 32 nh1 nh2 datah
Parameters
01h≤nh1≤14h
nh2: 00h (Fixed)
00h≤datah≤FFh
Description
Specifies the text string for the print start command.
P-touch Template Command Reference
The default text string for the print start command is “^FF”.
This command is a static command.
Remarks
Invalid if more than 20 characters are specified
Example
To change the text string for the print start command to “START”:
Since the text string to be specified (data), “START”, contains 5 characters, nh1=05h and nh2=00h.
Therefore, the command will be as follows.
ESC i X P 2 05h 00h S T A R T
(1Bh 69h 58h 50h 32h 05h 00h 53h 54h 41h 52h 54h)
- 68 -
7. Control Command Details
nh3+(nh4*256):
Print start received character count (bytes) (1 to 999)
ESC iXr2 Specify print start received character count
ASCII: ESC i X r 2 n1 n2 n3 n4
Decim al: 27 105 88 114 50 nd1 nd2 nd3 nd4
09h: Full cut setting ON, chain printing setting OFF
ESC iXc1 Retrieve printer settings (cut options)
ASCII: ESC i X c 1 n1 n2
Decim al: 27 105 88 99 49 nd1 nd2
Hexadecimal: 1B 69 58 63 31 nh1 nh2
Parameters
nh1: 00h (Fixed)
nh2: 00h (Fixed)
Description
Retrieves the various cut settings.
3-byte data is returned from the machine.
P-touch Template Command Reference
00h: Full cut setting OFF, chain printing setting ON
01h: Full cut setting ON, chain printing setting ON
08h: Full cut setting OFF, chain printing setting OFF
The retrieved value is a value specified by a static command.
Example
When the full cut setting is ON and the chain printing setting is ON: