Brother PT-P900W Mounting instructions

Software Developer's Manual
P-touch Template Command Reference
PT-P900W/P950NW
Version 1.01

The Brother logo is a registered trademark of Brother Industries, Ltd.
Brother is a registered trademark of Brother Industries, Ltd.
© 2016 Brother Industries, Ltd. All rights reserved.
The Bluetooth word mark and logos are owned by the Bluetooth SIG, Inc. and, any use of such marks by
Brother Industries, Ltd. is under license.
BarStar Pro Encode Library (DataMatrix, MaxiCode, PDF417, RSS, POSTNET、AztecCode) Copyright (c)
2007 AINIX Corporation. All rights reserved.
QR Code is a registered trademark of DENSO WAVE INCORPORATED in Japan and other countries.
QR Code Generating Program Copyright © 2008 DENSO WAVE INCORPORATED
Each owner whose software title is mentioned in this document has a Software License Agreement specific to
its proprietary programs.
Any trade names and product names of companies appearing on Brother products, related documents and
any other materials are all trademarks or registered trademarks of those respective companies.

IMPORTANT - PLEASE READ CAREFULLY
Note
This documentation (“Documentation”) gives you information that will assist you in controlling your Printer
PT-P9XX (where “P9XX” is the model name).
You may use the Documentation only if you first agree to the following conditions.
If you do not agree to the following conditions, you may not use the Documentation.
Condition of Use
You may use and reproduce the Documentation to the extent necessary for your own use of your Printer
Model (“Purpose”). Unless expressly permitted in the Documentation, you may not;
(i) copy or reproduce the Documentation for any purpose other than the Purpose,
(ii) modify, translate or adapt the Documentation, and/or redistribute it to any third party,
(iii)rent or lease the Documentation to any third party, or,
(iv) remove or alter any copyright notices or proprietary rights legends included within the Documentation.
No Warranty
a. Any updates, upgrades or alteration of the Documentation or Printer Model will be performed at the sole
discretion of Brother. Brother may not respond to any request or inquiry about the Documentation.
b. THIS DOCUMENTATION IS PROVIDED TO YOU "AS IS" WITHOUT WARRANTY OF ANY KIND,
WHETHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTY
OF FITNESS FOR A PARTICULAR PURPOSE. BROTHER DOES NOT REPRESENT OR WARRANT
THAT THIS DOCUMENTATION IS FREE FROM ERRORS OR DEFECTS.
c. IN NO EVENT SHALL BROTHER BE LIABLE FOR ANY DIRECT, INDIRECT, PUNITIVE, INCIDENTAL,
SPECIAL OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER, ARISING OUT OF
THE USE, INABILITY TO USE, OR THE RESULTS OF USE OF THE DOCUMENTATION OR ANY
SOFTWARE PROGRAM OR APPLICATION YOU DEVELOPED IN ACCORDANCE WITH THE
DOCUMENTATION.

P-touch Template Command reference
- i -
Contents
Introduction ······························································································· 1
What is P-touch Template? ········································································· 2
1. Using P-touch Template ·········································································· 3
2. P-touch Template Settings Tool User’s Guide ··········································· 4
3. Examples for Using Commands ····························································· 10
3.1 Example for using P-touch Template .......................................................................... 10
3.2 Example for printing logo/external characters in P-touch Template .......................... 14
4. P-touch Template Limitations ······························································· 18
4.1 Relating to text objects................................................................................................. 18
4.1.1 Font, size, etc.................................................................................................... 18
4.1.2 Character alignment ......................................................................................... 20
4.1.3 Text Layout settings .......................................................................................... 21
4.2 Relating to barcodes .................................................................................................... 22
4.2.1 Barcodes ........................................................................................................... 22
4.2.2 1D barcodes...................................................................................................... 23
4.2.3 2D barcodes...................................................................................................... 24
4.3 Relating to images........................................................................................................ 25
4.4 Relating to Numbering ................................................................................................. 25
4.5 Relating to Database.................................................................................................... 25
4.6 Others ........................................................................................................................... 26
4.6.1 Transferring templates...................................................................................... 26
4.6.2 About objects in a template .............................................................................. 26
5. Precautions ·························································································· 27
5.1 Notes for printers with Bluetooth interface.................................................................. 27
5.2 Relationship between the P-touch Editor settings and the printer image ................. 28
5.3 Making a template in order to save time before starting to print................................ 29
6. Control Code Lists ················································································ 30
6.1 Setting and retrieving commands for P-touch Template mode.................................. 30
6.2 Setting and retrieving commands for raster mode ..................................................... 32
7. Control Command Details······································································ 34
^PT Select print start trigger......................................................................... 34
^FF Start printing........................................................................................... 35
^PS Specify print start command text string ................................................ 36
^PC Specify print start received character count......................................... 37
^SS Specify delimiter .................................................................................... 38
^TS Select template...................................................................................... 39
^LS Specify line spacing with line feed........................................................ 40
^CC Change the prefix character ................................................................. 41
^RC Specify line feed command text string.................................................. 42
^CN Specify number of copies...................................................................... 43
^NN Specify number of Numbering copies .................................................. 44
^ID Initialize template data .......................................................................... 45
^QS Select print options ................................................................................ 46

P-touch Template Command reference
- ii -
^QV Specify QR Code version...................................................................... 47
^FC FNC1 replacement setting .................................................................... 48
^CF Full cut setting........................................................................................ 49
^CH Half cut setting....................................................................................... 50
^CP Chain printing setting............................................................................. 51
^MP Mirror printing setting............................................................................. 52
^II Initialize .................................................................................................. 53
^OP Perform machine operations (feed/cut)................................................ 54
^SR Status request........................................................................................ 55
^VR Retrieve version information................................................................. 61
^CR Line feed in object ................................................................................. 62
^OS Select object (object number)............................................................... 63
^ON Select object (object name) .................................................................. 64
^DI Directly insert object.............................................................................. 65
ESC i a Specify command mode........................................................................ 66
ESC iXT2 Select print start trigger......................................................................... 67
ESC iXP2 Specify print start command text string ................................................ 68
ESC iXr2 Specify print start received character count......................................... 69
ESC iXD2 Specify delimiter .................................................................................... 70
ESC iXa2 Specify non-printed text strings ............................................................ 71
ESC iXi2 Specify command mode........................................................................ 72
ESC iXn2 Select template...................................................................................... 73
ESC iXf2 Change the prefix character ................................................................. 74
ESC iXc2 Select printer settings (cut options)...................................................... 75
ESC iXy2 Select printer settings (cut options–specifying number of labels) ...... 76
ESC iXH2 Half cut setting....................................................................................... 77
ESC iXM2 Mirror printing setting............................................................................. 78
ESC iXs2 Special tape setting ............................................................................... 79
ESC iXm2 Select character code set ..................................................................... 80
ESC iXj2 Select international character set......................................................... 81
ESC iXR2 Specify line feed command text string.................................................. 82
ESC iXC2 Specify number of copies...................................................................... 83
ESC iXN2 Specify number of Numbering copies .................................................. 84
ESC iXF2 FNC1 replacement setting.................................................................... 85
ESC iXq2 Select print options ................................................................................ 86
ESC iXT1 Retrieve select print start trigger items................................................. 87
ESC iXP1 Retrieve print start command setting text string .................................. 88
ESC iXr1 Retrieve print start received character count....................................... 89
ESC iXD1 Retrieve delimiter................................................................................... 90
ESC iXa1 Retrieve non-printed text strings........................................................... 91
ESC iXi1 Retrieve command mode setting.......................................................... 92
ESC iXn1 Retrieve template selection number..................................................... 93
ESC iXc1Retrieve printer settings (cut options) .................................................. 94
ESC iXy1 Retrieve printer settings (cut options–specifying number of labels)... 95
ESC iXH1 Retrieve half cut setting......................................................................... 96
ESC iXM1 Retrieve mirror printing setting.............................................................. 97
ESC iXs1 Retrieve special tape setting................................................................. 98
ESC iXm1 Retrieve character code set setting...................................................... 99
ESC iXj1 Retrieve international character set setting........................................ 100
ESC iXf1 Retrieve the prefix character............................................................... 101
ESC iXR1 Retrieve line feed command setting text string.................................. 102
ESC iXC1 Retrieve number of copies setting...................................................... 103
ESC iXN1 Retrieve number of Numbering copies setting................................... 104
ESC iXF1 Retrieve FNC1 replacement setting ................................................... 105
ESC iXq1 Retrieve print options .......................................................................... 106
Appendix A: Specifications ······································································107
Appendix B: Character Code Tables ·························································108

P-touch Template Command reference
- iii -
International character set table .......................................................................................111
Appendix C: Troubleshooting···································································112
If printing does not begin (main most frequent cause)....................................................112
If a template linked to a database is not printed..............................................................112
Appendix D: Introducing the Brother Developer Center ·····························113

P-touch Template Command Reference
- 1 -
Introduction
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.

P-touch Template Command Reference
- 2 -
What is P-touch Template?
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.
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 Template is not compatible with some hosts.
2.Design the
template in
P-touch Editor,
and then transfer
it to the printer.
1.Set up the printer from the computer according to
configuration of the host device.
3. Transfer the
data (text) from
the host device,
and then print it
in the template.

P-touch Template Command Reference
- 3 -
1. Using P-touch Template
1. Using P-touch Template
(1) Set up the printer.
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 Settings Tool User’s
Guide”)
The printer driver must first be installed via a USB
connection.
(2) Design the template.
Using P-
touch Editor, design the template to be transferred
to the printer.
(Please refer to “4. P-touch Template Limitations”)
(3) Transfer the templates.
Using P-
touch Transfer Manager, transfer the templates to
the 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
dance with the
P-touch Template commands.
(Please refer to “6. Control Code Lists”)
(5) Connect the printer with the host and print slips etc.
Connect the printer to the host device by using a serial
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

P-touch Template Command Reference
- 4 -
2. P-touch Template Settings Tool User’s Guide
2. P-touch Template Settings Tool User’s Guide
(1) Command mode setting
(2) Template number setting
(3) Delimiter setting
(5) Print start command
text string setting
(4) Print start trigger 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
(14 ) Auto cut setting
(15) Half cut setting
(17) Cut number setting
(20) Communication settings
Applies settings for (1) through (20) to the machine.
Returns (1) through (19) to their default settings.
(11) Line feed character setting
(13) Number of copies setting
(18) Chain printing setting
(12) FNC1 replacement setting
(16) Special tape setting
Closes the tool.
(19) Mirror printing setting

P-touch Template Command Reference
- 5 -
2. P-touch Template Settings Tool User’s Guide
(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.

P-touch Template Command Reference
- 6 -
2. P-touch Template Settings Tool User’s Guide
(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.

P-touch Template Command Reference
- 7 -
2. P-touch Template Settings Tool User’s Guide
(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 setting
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.

P-touch Template Command Reference
- 8 -
2. P-touch Template Settings Tool User’s Guide
(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
115200 bps, 57600 bps, 38400 bps, 31250 bps, 28800 bps, 19200 bps, 14400
bps, 9600 bps, 4800 bps, 2400 bps, 1200 bps, 600 bps
Bit length (bits)
8 bit, 7 bit
Parity
None, Odd, Even
Busy control
DTR, XON/XOFF
Applies the four settings to the printer.
Returns the four parameters to
their default settings.
Closes the Communication
Settings dialog box.

P-touch Template Command Reference
- 9 -
2. P-touch Template Settings Tool User’s Guide
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 : [PRINT]
TAB control code : [\09]
Return control code : [\0D]
\ : [\\]

P-touch Template Command Reference
- 10 -
3. Examples for Using Commands
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
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.

P-touch Template Command Reference
- 11 -
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.
Step 3: Transfer the template from Transfer Manager to the printer.
Stored template Assigned number
Click [Transfer] button.

P-touch Template Command Reference
- 12 -
3. Examples for Using Commands
(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 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.
After setting (1) and (2) with the P-touch Template Settings tool, the other two commands must be sent
to the printer.
(1) Select the P-touch Template mode (Fixed)

P-touch Template Command Reference
- 13 -
3. Examples for Using Commands
(3) Initialize P-touch Template
^II
Entered command
(4) Print Start
^FF
Entered command
When the printer receives the command above, the label below is printed.

P-touch Template Command Reference
- 14 -
3. Examples for Using Commands
3.2 Example for printing logo/external characters in P-touch Template
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, and drag & drop it to Transfer Manager.
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.
Stored template
Assigned number