Name; Raster graphics transfer; Syntax- Page 24

Brother QL-700 Raster Command Reference

Raster Command Reference

Software User's Guide

User's Guide

Quick Setup Guide

2014 Dodge Charger SRT Owner Manual

Brother QL Series

Command Reference

(QL-500/550/560/570/580N/

650TD/700/1050/1060N)

October 3, 2011 Version 6.0

Brother Industries, Ltd.,

Software Application Development Dept.

3.1.Print data overview 4

3.2.Page data details 5

4.1. Overview 12

4.2. Definitions of each part 14

6.1. Sequential Normal Flow for USB connection 25

6.2. Sequential Error Flow for USB Connection (Error when feeding at the end of the page, for example, because of a tape cutter jam) 26

6.3. Sequential Error Flow for USB Connection (Error during continuous printing, for example, because there is no more tape) 27

6.4. Sequential Cooling Flow for USB Connection 28

6.5. Flow for Setting Serial Connection Baud Rate 29

6.6. Buffering Normal Flow for Serial/USB Connection 30

6.7. Buffering Error Flow for Serial/USB Connection 31

6.8. Buffering Cooling Flow for Serial/USB Connection 32

6.9. Buffering Normal Flow for Network (Standard TCP/IP / LPR port) Connection 33

1.Introduction

This material provides the necessary information for directly controlling the Brother QL-500/550/560/ 570/580N/650TD/700/1050/1060N. This information is provided assuming that the user has full understanding of the operating system being used and basic mastery of USB in a developer’s environment.

Details concerning the USB interface are not described in this material. If a USB interface is being used, refer to “7. USB Specifications” to prepare the interface.

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 Brother QL-500/ 550/560/570/580N/650TD/700/1050/1060N, and any problems resulting directly or indirectly from them. These materials are provided in their current condition, and we assume no responsibility for their content. 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.

2.Overview

The printing procedure is described below. For details on each command, refer to “5.Command Details”.

By using the machine’s button (E/EL), QL-700 can be switched between operating in the printer class and the mass storage class.

These materials assume that the machine is operating in the printer class.

① Open USB/Serial/Network port

Open the USB/Serial/Network port in the operating environment. The procedure for opening the USB/Serial/Network port is not described in this material.

The serial port can only be used with the QL-580N/650TD/1050/1060N.

The network port can only be used with the QL-580N/1060N.

② Check machine status

The “Status information request” command is sent to the printer, the status information received from the printer is analyzed, and then the status of the printer is determined. For details on the “Status information request” command and on the definition of “status”, refer to “Status information request” in “5. Command Details”.

③ Send print data

If the status analysis concludes that a tape cassette corresponding to the print data is loaded into the printer and that no error has occurred, the print data is sent. The structure of the print data is explained in the next section, “3. Print Data”.

Note:No command can be sent to the printer after the print data is transmitted and until the completion of printing is confirmed.Even the “Status information request” command cannot be sent during printing.

④ Confirmation of printing completion

When printing is completed, the status is sent from the printer. This status is analyzed and, if printing is completed, one page is printed. If the print job has multiple pages, ② through ④ are repeated.

⑤ Close USB/Serial/Network port

After all printing is finished, close the USB/Serial/Network port.

Note:In order to print at high speed when the USB port is used, the Brother QL starts printing when it starts to receive print data, instead of waiting for a print command. For the processing flow, for example when managing errors, refer to “6. Flow Charts”.

(If the printing data is compressed in Command “4D H + 02 H” for QL-580N/650TD/1050/1060N, the printer starts printing after a print command.)

3.Print Data

3.1.Print data overview

The print data is constructed of the following: ① Initialize, ② Job data, ③ Page data, and ④ Print command. If the print job consists of multiple pages, ② through ④ are repeated

① Initialize

Initialize

Clears the mode settings. 1B H, 40 H

② Job data

Added at the beginning of each page and feeds each page.

Only used with QL-580N/650TD/1050/1060N.

Switches to raster mode

1B H, 69 H, 61 H, 01 H

Print information command

Sets the print information for the printer.

For the starting page of die-cut labels (29 mm × 90 mm) with priority given to print speed:

1BH, 69H, 7AH, 0EH, 0BH, 1DH, 5AH, DFH, 03H,

00H, 00H, 00H, 00H

Set each mode

To select “Auto Cut”(except QL-500):

1B H, 69 H, 4D H, 40 H

Specify the page number in ”cut every * labels”

Only used with QL-570/580N/700/1050/1060N.

When an auto cut setting is effective, specify the number of sheets for auto cut.

For each sheets,

1B H, 69 H, 41 H, 01 H

Set expanded mode

Only used with QL-570/580N/650TD/700/1050/1060N.

To set “Cut at end flag”

1B H, 69 H, 4B H, 08 H

Set margin amount

For 3 mm margins:

1B H, 69 H, 64 H, 23 H, 00 H

Compression mode selection

Only used with QL-580N/650TD/1050/1060N

For QL-650TD, data can only be compressed when the serial port is used.

③ Page data

Repeat for each page in the print job.

Sequence

Command Name

Description/Example

－

Raster graphics transfer

Sends a raster line that contains data with a pixel set to “ON”.

For a single perpendicular line on 62-mm-wide continuous length tape:

67H, 00H, 5AH, 00H, 0FH, FFH (repeat for 86 bytes),

F0H, 00H (QL-500/550/560/570/580N/650TD)

67H, 00H, 5AH, 00H, 0FH, FFH (repeat for 168 bytes),

F0H, 00H (QL-1050/1060N)

④ Print command

Specified at the end of the page.

－

Specified at the end of a page that is not the last page.

0C H

－

Print command with feeding

Specified at the end of the last page. 1A H

3.2.Page data details

3.2.1. Resolution

Resolution

Height-to-Width Proportion

300 dpi high, 300 dpi wide

1:1

600 dpi high, 300 dpi wide

2:1

3.2.2. Page size

Ａ．Continuous length tape

Number 1 Width 2 Length

3 Print area width (maximum printing width) 4 Print area length

5 Width offset 6 Length offset

Label Size

Designation

１

２

３

４

５

６

257

258

264

262

261

259

260

102mm continuous tape is only for QL-1050/1060N

Inch measurements are indicated as decimals with QL-700 and as fractions with all models other than QL-700.

Ｂ． Die-cut labels

Number 1 Width 2 Length

3 Print area width (maximum printing width) 4 Print area length

5 Width offset 6 Length offset

7 Width offset of masked area 8 Length offset of masked area

9 Width of masked area 10 Length of masked area

１

３

５

269

270

370

271

272

367

374

274

275

365

366

362

363

273

Inch measurements are indicated as decimals with QL-700 and as fractions with all models other than QL-700.

７

273

*1 The number of dots in the table is for 300 dpi; it is difference in the high-resolution mode.

*2 Margins of 3 mm (1.5 mm × 2) horizontally and 3 mm (1.5 mm × 2) vertically are added to a diameter of 16 mm.

“102mm x 51mm” and “102mm x 152mm” is only for QL-1050/1060N

3.2.3. Feed amount

The feed amount (left and right margins) is defined below.

Tape Type

Minimum Margin Setting

Maximum Margin Setting

Continuous length tape

Set the command for specifying the margin to “0”.

In case of using 12 mm Dia for QL-500/550/560/570/580N/700, specify 35 dots.

3.2.4. Maximum and minimum lengths

The maximum and minimum lengths are defined below.

Tape Type

Minimum Length

Maximum Length

Continuous length tape

(QL-500/550/560/650TD/1050/1060N)

(QL-500/550/560/570/580N/650TD/700)

3.2.5. Raster line arrangement

QL-500/550/560/570/580N/650TD/700: Total number of pins 720 pins

Continuous length tape:

Label Size

Number of Pins for Left Margin

Number of Print Area Pins

Number of Pins for Right Margin

Number of Raster Graphics Transfer Bytes

12mm

585

106

29mm

408

306

38mm

295

413

50mm

154

554

54mm

130

590

62mm

696

Die-cut labels:

Label Size

Number of Pins for Left Margin

Number of Print Area Pins

Number of Pins for Right Margin

Number of Raster Graphics Transfer Bytes

17 mm x 54 mm

555

165

17 mm x 87 mm

555

165

23 mm x 23 mm

442

236

29 mm x 90 mm

408

306

38 mm x 90 mm

295

413

39 mm x 48 mm

289

425

52 mm x 29 mm

142

578

62 mm x 29 mm

696

62 mm x 100 mm

696

12 mm Dia

513

113

24 mm Dia

442

236

58 mm Dia

618

QL-1050/1060N: Total number of pins 1296 pins

Continuous length tape:

Label Size

Number of Pins for Left Margin

Number of Print Area Pins

Number of Pins for Right Margin

Number of Raster Graphics Transfer Bytes

12mm

1116

106

162

29mm

940

306

162

38mm

827

413

162

50mm

686

554

162

54mm

662

590

162

62mm

544

696

162

162

Number of Pins for Left Margin

Number of Print Area Pins

Number of Pins for Right Margin

Number of Raster Graphics Transfer Bytes

17mm x 54mm

1087

165

162

17mm x 87mm

1087

165

162

23mm x 23mm

976

236

162

29mm x 90mm

940

306

162

38mm x 90mm

827

413

162

39mm x 48mm

821

425

162

52mm x 29mm

674

578

162

62mm x 29mm

544

696

162

62mm x 100mm

544

696

162

162

162

156

162

24mm Dia

975

236

162

58mm Dia

584

618

162

4.Status

4.1. Overview

The status is sent from the printer to the computer as a reply to the “status information request” command or as an error message. The size is fixed to 32 bytes.

Fixed to ’B’ (42 Hex)

Reserved

QL-500/550/650TD/1050:

Fixed to ’0’ (30 Hex)

QL-560/570/580N/700/1060N:

Fixed to ’4’ (34 Hex)

Reserved

QL-500/550: Fixed to ‘O’ (4F Hex)

QL-560: Fixed to ‘1’ (31 Hex)

QL-570: Fixed to ‘2’ (32 Hex)

QL-580N: Fixed to ‘3’ (33 Hex)

QL-650TD: Fixed to ‘Q’ (51 Hex)

QL-700: Fixed to ‘5’ (35 Hex)

QL-1050: Fixed to ‘P’ (50 Hex)

QL-1060N: Fixed to ‘4’ (34 Hex)

Reserved

Fixed to ’0’ (30 Hex)

Refer to section 4.2.1.

Error information 2

Refer to section 4.2.1.

Media width

Refer to section 4.2.2.

Media type

Refer to section 4.2.3.

Refer to section 4.2.2.

Status type

Refer to section 4.2.4.

Phase type

Refer to section 4.2.5.

Higher order bytes of phase number

Refer to section 4.2.5.

Lower order bytes of phase number

Refer to section 4.2.5.

Notification number

Refer to section 4.2.6.

4.2. Definitions of each part

4.2.1. Error information 1 and error information 2

No media when printing

Bit 1

0x02

End of media (die-cut size only)

Main unit in use (QL-560/650TD/1050)

Fan doesn’t work (QL-1050/1060N)

Cover opened while printing

Cannot feed (used even when the media is empty)

Bit 7

0x80

System error

4.2.2. Media width and length

The media width and length is described in millimeters. 0 to 255 (FF Hex)

The width of continuous length tape is indicated in millimeters of the tape width, and the width of die-cut labels is indicated by the width of the die-cut section.

The length of continuous length tape is fixed to “00 Hex”, and the length of die-cut labels is indicated by the length of the die-cut section.

Continuous length tape

102

100

102

102

153

Used as print information when the media type is not indicated.

Continuous length tape

0A Hex

Used for both paper and MKP.

Die-cut labels

0B Hex

Used for both paper and MKP.

4.2.4. Status type

Status Type

Value

Reply to status request

If an error occurred during printing, the unit returns the error status.

4.2.5. Phase type and phase number

If the phase type and phase number are not used, both are fixed to “00 Hex”.

When the machine is turned on, it is in the “Waiting to receive” phase state. When printing begins, it changes to the “Printing state” phase state and the machine sends the phase status to the computer. When printing has finished, the machine sends the “Waiting to receive” phase status to the computer. Unless an error occurs during printing, the machine sends the “Printing completed” status.

In sequential printing, In order to print at high speed, printing starts even if a print command has not been sent from the computer. At this time, care should be taken since the “Printing state” phase and “Waiting to receive” phase statuses will be sent. (Refer to “6. Flow Charts”.)

4.2.6. Notification number

If a high-temperature error occurred during printing, the unit stops printing and enters the

cooling state.

At this time, the notification number is used for delivering the status of the cooling state. For details on controlling the actual printing process, refer to “6. Flow Charts”.

Initialize mode settings.

Also used to cancel printing.

Name

Status information request

Send request to printer to receive status information.

Name

Command mode switch (QL-580N/650TD/1050/1060N)

Syntax

ESC + i + a + {n}

1B H + 69 H + 61 H + {n}

Description

Specifies the command mode.

Definition of {n}

:ESC/P mode (normal)

:Raster mode (default)

:ESC/P mode (text) for QL-650TD

: P-touch Template mode for QL-580N/1050/1060N

Name

Print information command

Syntax

ESC + i + z + {n1} + {n2} + {n3} + {n4} + {n5} + {n6} + {n7} + {n8} + {n9}+ {n10}

1B H + 69 H + 7AH + {n1} + {n2} + {n3} + {n4} + {n5} + {n6} + {n7} + {n8} + {n9}+ {n10}

Description

Specifies the print information.

Definition of {n1} through {n10}

{n1}: Valid flag; specifies which values are valid

#define PI_KIND 0x02 // Paper type

#define PI_WIDTH 0x04 // Paper width

#define PI_LENGTH 0x08 // Paper length

#define PI_QUALITY 0x40 // Give priority to print quality

#define PI_RECOVER 0x80 // Always ON

{n2}: Paper type

Continuous length tape 0A Hex

Die-cut labels 0B Hex

{n3}: Paper width; units: mm

{n4}: Paper length; units: mm

{n5-n8}: Raster number = n8*256*256*256 + n7*256*256 + n6*256 + n5

If the media is not correctly loaded into the printer when the valid flag for PI_KIND, PI_WIDTH and PI_LENGTH are set to “ON”, an error status is returned (Bit 0 of “error information 2” is set to “ON”.)

{n9}: Starting page: 0; Other pages: 1

1B H + 69 H + 4D H + {n}

Description

Definition of {n}

The meaning of each bit in a 1-byte parameter is described below.

７６５４３２１０

Not used

Not defined

Auto cut (QL550/560/570/580N/

650TD/700/1050/1060N)

Not used

Bit 6 Auto cut 1: Auto cut 0:No auto cut

When “auto cut” is specified for QL-560/570/580N/700/1050/1060N, following command (ESC + I + A + {n1}) is valid.

Name

Specify the page number in ”cut every * labels” (QL-560/570/580N/700/1050/1060N)

Syntax

ESC + i + A + {n1}

1B H + 69 H + 41 H + {n1}

Description

When “auto cut” is specified, you can specify page number (1-255) in “cut each * labels”.

Page number = n1 (1- 255)

Default is 1 (cut each label)

Name

Set expanded mode (QL-560/570/580N/650TD/700/1050/1060N)

Syntax

ESC + i + K + {n}

1B H + 69 H + 4B H + {n}

Description

Definition of {n}

The meaning of each bit in a 1-byte parameter is described below.

７６５４３２１０

Not used

Cut at end (Earlier version of QL-650TD firmware is not supported.)

Not used

High resolution printing

(QL-570/580N/700)

Not used

Bit 3 Cut at end

Specify that whether cut at end or not when plural pages printing

ON: Cut at end (default)

OFF: Not cut at end

Bit 6 High resolution printing (QL-570/580N/700)

ON: It prints at 600 dpi in the paper length direction.

OFF: It prints at 300 dpi in the paper length direction.（default）

Name

Set margin amount (feed amount)

Syntax

ESC + i + d + {n1} + {n2}

1B H + 69 H + 64 H + {n1} + {n2}

Description

Specifies the amount of the margins.

Margin amount (dots) = n1 + 256*n2

With this model, the amount of feed cannot be set for each mode.

With die-cut labels, the margin amount at the ends of the printed area is “0”.

In case of using QL-550/560/570/580N/700, specify 35dots.

Continuous length tape

Die-cut labels

Name

Compression mode selection (QL-570/580N/650TD/1050/1060N)

This selects the compression mode. Data compression is only enabled with raster graphic transfer data.

Definition of {n}

0 No-compression mode (Enabled)

1 Reserved (Disabled)

2 TIFF (QL-580N/650TD/1050/1060N)

In case QL-650TD, only enabled with serial interface

In case QL-580N/1060N, serial and LAN interface should set TIFF option.

【TIFF(Pack Bits)】

1. 1-byte unit

When the same data is repeated, the number of repetitions and the one-byte data are specified.

When the data is different, the number of data items and all data are specified.

.When the same data is repeated, the number of data units is specified as the actual number minus 1, expressed as a negative number.

When the number of different data units is specified, that number of bytes minus 1 is expressed as a positive number.

.If the above process results in more than 90 bytes of compressed data, the data is treated as being all different. As a result, there are 91 bytes, including the 1 byte specifying the data length.

Example: Compression example

Without compression 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00

00 00 00 00 00 22 22 23 BA BF A2 22 2B ……

With compression　 ED 00 FF 22 05 23 BA BF A2 22 2B …

a　　　b　　　　c　　　　　　　　　　　　　

a. 00H continues for 20 bytes, so 20 Dec -> 19 Dec -> 13 Hex, made into a negative number ED Hex.

Therefore, ED 00

b. 22H continues for 2 bytes, so 2 Dec -> 1 Dec -> 1 Hex, made into a negative number FF Hex.

Therefore, FF 22

c. The following 6 bytes remain unchanged. 6 Dec-> 5 Dec ->5 Hex.

Therefore, 05 23 BA BF A2 22 2B

This continues for up to 90 bytes. Even if the remainder of the 90 bytes consists only of 00 Hex, it cannot be omitted. (In case QL-1050, 162 bytes)

Name

Raster graphics transfer

Syntax

g + {s} + {n} + {d1} + ... + {dn}

67 H + {s} + {n} + {d1} + ... + {dn}

Description

{s} The definition of raster information s is as follows.

s 0x0: Data transmission

0x1～0xFE: Not used

0xFF: Indicates that data transmission should be stopped.

{n} Transfers the specified number of bytes (n) of data. (However, this changes if the data is compressed using the serial interface.)

n=90 (QL-500/550/560/570/580N/650TD/700)

n=162 (QL-1050/1060N)

Raster line is filled in zero data. (Compression mode)

Used as a print command, except for the last label when multiple labels are printed.

Name

Print command with feeding

Used as a print command for the last label when multiple labels are printed.

Name

Baud rate setting (QL-580N/650TD/1050/1060N)

Syntax

ESC + i + B + {n1} + {n2}

1B H + 69 H + 42H + {n1} + {n2}

Description

This changes the communications baud rate for the main unit. The factory setting is 115200 bps

Definition of {n1} and {n2}

Setting = n1 + n2 * 256

Setting: 96=9600 bps, 576=57600 bps, 1152=115200 bps

6.Flow Charts

There are following 4 ways of print methods.

・ USB Sequential*

Sequential print by USB interface.

・ USB Buffering*

Buffering print by USB interface.

・ Serial Buffering

Buffering print by serial interface.

・ Network Buffering

Buffering print by LAN interface.

Note:

*Sequential: Start printing immediately after starting to receive print data.

*Buffering: Start printing after one page of print data is received.

Print methods which each printers support are as below.

○

○

○

○

○

○

○

○

○

For the each print method, refer to following flow.

・ USB Sequential: 6.1, 6.2, 6.3 and 6.4.

・ USB Buffering: 6.6 and 6.7.

・ Serial Buffering: 6.5, 6.6, and 6.7.

・ Network Buffering: 6.9

6.1. Sequential Normal Flow for USB connection

6.2. Sequential Error Flow for USB Connection (Error when feeding at the end of the page, for example, because of a tape cutter jam)

6.3. Sequential Error Flow for USB Connection (Error during continuous printing, for example, because there is no more tape)

6.4. Sequential Cooling Flow for USB Connection

6.5. Flow for Setting Serial Connection Baud Rate

6.6. Buffering Normal Flow for Serial/USB Connection

6.7. Buffering Error Flow for Serial/USB Connection

6.8. Buffering Cooling Flow for Serial/USB Connection

6.9. Buffering Normal Flow for Network (Standard TCP/IP / LPR port) Connection

※ When it prints 2 pages data.

7.USB Specifications

USB specifications 1.1

QL-700 0x2042 (for printer class)

0x2049 (for mass storage class)

Mass storage (QL-700 only)

Character string for manufacturer

Character string descriptor: 0x01

0x0409:“Brother"

Character string for product

Character string descriptor: 0x02

Character string for serial number

Character string descriptor: 0x03

0x0409:“00000000"

Last nine digits of the unit’s serial number

(The serial number is written on the bottom of the product.)

Device speed

Full speed

Number of interfaces

1 (No alternate interfaces)

With the printer class

Power supply

Self-powered (As a printer class, Bus power is also set to “ON”.)

Maximum packet size: 16 bytes

End point 1

In bulk (Sends the status from the unit to the computer.)

Maximum packet size: 16 bytes

End point 2

Out bulk (Sends print commands and data from the computer to the unit.)

Maximum packet size: 64 bytes

With the mass storage class (QL-700 only)

Power supply

Self-powered

End point 1

Out bulk (Sends print commands and data from the computer to the unit.)

Maximum packet size: 64 bytes

End point 2

In bulk (Sends the status from the unit to the computer.)

Maximum packet size: 64 bytes

Created version 2.0 edition adding QL-650TD

2006.11.07

Created version 3.0 edition adding QL-1050

2008.09.01

Created version 4.0 edition adding QL-560

2008.12.25

Created version 5.0 edition adding QL-570/580N/1060N

2011.10.03

Created version 6.0 edition adding QL-700

Word のしおり

OLE_LINK1

OLE_LINK2

Name

Raster graphics transfer

Syntax

g + {s} + {n} + {d1} + ... + {dn}

67 H + {s} + {n} + {d1} + ... + {dn}

Description

{s} The definition of raster information s is as follows.

s 0x0: Data transmission

0x1

～

0xFE: Not

used

0xFF:

Indicates that data transmission should be stopped.

{n} Transfers the specified number of bytes (n) of data.

(However, this changes if the

data is compressed using the serial interface.)

n=90 (QL-500/550/560/570/580N/650TD/700)

n=162 (QL-1050/1060N)

{d1-dn} Print data.

Name

Zero raster graphics

Syntax

5A H

Description

Raster line is filled in zero data. (Compression mode)

Name

Print command

Syntax

0C H

Description

Used as a print command, except for the last label when multiple labels are printed.

Name

Print command with feeding

Syntax

Control-Z

1A H

Description

Used as a print command for the last label when multiple labels are printed.

Name

Baud rate setting (QL-580N/650TD/1050/1060N)

Syntax

ESC + i + B + {n1} + {n2}

1B H + 69 H + 42H + {n1} + {n2}

Description

This changes the communications baud rate for the main unit. The factory setting is

115200 bps

Definition of {n1} and {n2}

Setting = n1 + n2 * 256

Setting: 96=9600 bps, 576=57600 bps, 1152=115200 bps

Brother QL-500/550/560/570/580N/650TD/700/1050/1060N Command Reference

1 ... 202122232425262728

Name; Raster graphics transfer; Syntax- Page 24

Brother QL-700 Raster Command Reference

Table of Contents

Detailed Information for Brother QL-700 Raster Command Reference

Related Documents for Brother QL-700 Raster Command Reference