Zebra Virtual Device-T Virtual Device User Guide-T (EN)

Download

Virtual Device-T

User Guide

P1067299-003

registered in many jurisdictions worldwide. All other trademarks are the property of their respective owners.

Information in this document is subject to change without notice.

For further information regarding legal and proprietary statements, please go to:

COPYRIGHTS: http://www.zebra.com/copyright WARRANTY: http://www.zebra.com/warranty END USER LICENSE AGREEMENT: http://www.zebra.com/eula SOFTWARE: http://www.zebra.com/linkoslegal

and its subsidiaries (“Zebra Technologies”). It is intended solely for the information and use of parties operating and maintaining the equipment described herein. Such proprietary information may not be used, reproduced, or disclosed to any other parties for any other purpose without the express, written permission of Zebra Technologies.

This manual contains proprietary information of Zebra Technologies Corporation

Product Improvements Continuous improvement of products is a policy of Zebra Technologies. All

specifications and designs are subject to change without notice.

Liability Disclaimer Zebra Technologies takes steps to ensure that its published Engineering

specifications and manuals are correct; however, errors do occur. Zebra Technologies reserves the right to correct any such errors and disclaims liability resulting therefrom.

Limitation of Liability In no event shall Zebra Technologies or anyone else involved in the creation,

production, or delivery of the accompanying product (including hardware and software) be liable for any damages whatsoever (including, without limitation, consequential damages including loss of business profits, business interruption, or loss of business information) arising out of the use of, the results of use of, or inability to use such product, even if Zebra Technologies has been advised of the possibility of such damages. Some jurisdictions do not allow the exclusion or limitation of incidental or consequential damages, so the above limitation or exclusion may not apply to you.

Part Number: P1067299-003 Rev. A

Contents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

Virtual Device-T Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

Supported Printers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

Configuring Network Connectivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

Install, Register, and Enable Virtual Device-T . . . . . . . . . . . . . . . . . . . . . . . . . . 11

Acquiring the Virtual Device Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

Downloading the Virtual Device-T Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

Adding Printers to the ZDownloader List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

Modifying Printers in the List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

Deleting Printers from the List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

Downloading the Virtual Device App to Selected Printers . . . . . . . . . . . . . . . . . . . . . 21

Canceling a Download in Progress . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

Registering the Virtual Device . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

ZDownloader Log File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

Enabling the Virtual Device . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

Using an SGD Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

Using the User Menus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36

Interface Command Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

Command Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

TPCL Mode Supported Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38

08/28/2018 Virtual Device-T User Guide P1067299-003

Contents

Setting Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

[ESC] D . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

[ESC] ID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

[ESC] M . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

Fine Adjustment Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46

[ESC] AX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46

[ESC] AY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48

[ESC] AH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

Clear Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50

[ESC] C . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50

[ESC] XR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51

Drawing Format Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53

[ESC] LC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53

[ESC] PC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58

[ESC] PV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71

[ESC] XB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82

[ESC] XB—WPC, CODE93, CODE128, UCC/EAN128, EAN128, POSTNET . . . . 82

[ESC] XB—MSI, Interleaved 2 of 5, CODE39, NW7, Industrial 2 of 5 . . . . . . . . . . 92

[ESC] XB—GS1 Databar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101

[ESC] XB—Two-Dimensional Code Format (Data Matrix) . . . . . . . . . . . . . . . . . . 108

[ESC] XB—Two-Dimensional Code Format (PDF417). . . . . . . . . . . . . . . . . . . . . 117

[ESC] XB—Two-Dimensional Code Format (MicroPDF417) . . . . . . . . . . . . . . . . 123

[ESC] XB—Two-Dimensional Code Format (QR Code) . . . . . . . . . . . . . . . . . . . . 129

[ESC] XB—Two-Dimensional Code Format (MaxiCode) . . . . . . . . . . . . . . . . . . . 135

Print Data Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140

[ESC] RC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140

[ESC] RV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143

[ESC] RB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146

[ESC] RB—Barcode/Two-Dimensional Code Data (any codes other than MaxiCode)146

[ESC] RB—Two-Dimensional Code Data (MaxiCode) . . . . . . . . . . . . . . . . . . . . . 154

Issue and Feed Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155

[ESC] XS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155

[ESC] T . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157

[ESC] U1 or [ESC] U2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158

Format Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159

[ESC] J1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159

Writable Character Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160

[ESC] XD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160

Graphics Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164

[ESC] SG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164

P1067299-003 Virtual Device-T User Guide 08/28/2018

Contents

PC Command Saving Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171

[ESC] XO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171

[ESC] XP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173

[ESC] XQ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173

Check Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174

[ESC] WR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174

[ESC] Z0 (zero) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174

Status Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175

[ESC] WS, [ESC] FM, [ESC] v . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175

[ESC] WB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176

[ESC] WX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176

[ESC] WV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177

Bluetooth and Wireless LAN Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179

[ESC] IT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179

Set/Get/Do (SGD) Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180

apl.enable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180

apl.version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180

apl.framework_version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181

Supported Fonts and Barcodes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182

Bitmap Fonts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183

Outline Fonts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189

Barcode Fonts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190

Character Code Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194

Times Roman, Helvetica, Letter Gothic, Prestige Elite,

Courier, Gothic725 Black . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195

PRESENTATION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196

OCR-A . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197

OCR-B . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198

TEC OUTLINE FONT 1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199

PRICE FONT 1, 2, 3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200

Barcode/Two-Dimensional Code Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201

WPC, Interleaved 2 of 5 (ITF), MSI, Industrial 2 of 5, GS1 Databar, GS1 Databar Stacked,

GS1 Databar Stacked Omni-directional, GS1 Databar Limited . . . . . . . . . . . . . . . . . . . 202

POSTNET . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203

CODE39 (Standard) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204

CODE39 (Full ASCII) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205

NW7 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206

CODE93 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207

CODE128 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208

GS1 Databar Expanded/GS1 Databar Expanded Stacked . . . . . . . . . . . . . . . . . . . . . . 211

Data Matrix . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212

08/28/2018 Virtual Device-T User Guide P1067299-003

Contents

PDF417, MicroPDF417 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213

QR Code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215

MaxiCode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217

Drawing of Barcode Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219

Type of Barcode: JAN8, EAN8 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219

Type of Barcode: JAN13, EAN13 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220

Type of Barcode: UPC-A . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222

Type of Barcode: UPC-E . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224

Type of Barcode: JAN8 + 2 digits, EAN8 + 2 digits . . . . . . . . . . . . . . . . . . . . . . . . . 225

Type of Barcode: JAN8 + 5 digits, EAN8 + 5 digits . . . . . . . . . . . . . . . . . . . . . . . . . 226

Type of Barcode: JAN13 + 2 digits, EAN13 + 2 digits . . . . . . . . . . . . . . . . . . . . . . . 227

Type of Barcode: JAN13 + 5 digits, EAN13 + 5 digits . . . . . . . . . . . . . . . . . . . . . . . 229

Type of Barcode: UPC-A + 2 digits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231

Type of Barcode: UPC-A + 5 digits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233

Type of Barcode: UPC-E + 2 Digits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235

Type of Barcode: UPC-E + 5 Digits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236

Type of Barcode: MSI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 237

Type of Barcode: Interleaved 2 of 5 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239

Type of Barcode: Industrial 2 of 5 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240

Type of Barcode: CODE39 (Standard) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241

Type of Barcode: CODE39 (Full ASCII) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242

Type of Barcode: NW7 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243

Type of Barcode: No Auto Selection of CODE128 . . . . . . . . . . . . . . . . . . . . . . . . . 244

Type of Barcode: Auto Selection of CODE128 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244

Type of Barcode: CODE93 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245

Type of Barcode: UCC/EAN128 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246

Type of Barcode: POSTNET . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247

Type of Barcode: GS1 Databar, GS1 Databar Stacked,

GS1 Databar Stacked Omni-directional, GS1 Databar Limited . . . . . . . . . . . . . . . . 248

Type of Barcode: GS1 Databar Expanded . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248

Automatic Addition of Start/Stop Codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249

CODE39 and NW7 Barcodes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249

ZDownloader Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252

Downloading the ZDownloader Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253

Installing the ZDownloader Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254

Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257

P1067299-003 Virtual Device-T User Guide 08/28/2018

Introduction

This section describes the features and functions of a Zebra printer that is running the Virtual Device-T application.

Contents

Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

Virtual Device-T Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

Configuring Network Connectivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

08/28/2018 Virtual Device-T User Guide P1067299-003

Introduction

Overview

The Virtual Device-T application enables Zebra Link-OS printers to work with many host systems that are using TOSHIBA TEC be required to the host application. This feature can help customers to make a smooth transition to Zebra printers and save them the time and expense of having to rewrite their host software.

Virtual Device-T Features

The Virtual Device-T application:

• Uses existing features of Zebra printers, when available.

• Offers fonts similar to the original device. These fonts will use 120 KB or more of memory space.

• Supports the Bluetooth

• Offers many outline fonts, barcodes, and specific commands and features of target printer models (see Supported Fonts and Barcodes on page 182).

• Provides support of TOSHIBA TEC commands (see Commands on page 36).

printers. In most cases, no changes will

, Serial, Ethernet, WLAN, and USB interfaces.

P1067299-003 Virtual Device-T User Guide 08/28/2018

Supported Printers

This manual describes the Virtual Device-T language for Zebra Link-OS printers and should be used by any person who needs to support that language on one of the following Zebra printers:

Printer Firmware

iMZ Series V73.19.6Z and later QLn Series V68.19.6Z and later ZT200 Series V72.19.6Z and later ZT400 Series V75.19.7Z and later ZT510 V80.20.02Z and later ZT600 Series V80.20.02Z and later ZD400 Series V77.19.14Z or V84.20.05Z and later ZD500 Series V74.19.6Z and later ZD600 Series V84.20.05Z and later

Introduction

Supported Printers

ZQ300 Series V81.20.06Z and later ZQ500 Series V76.19.10Z and later

Note • The Virtual Device-T language is supported only on 203 dpi printers.

For complete printer operation, use this manual in combination with the User Guide for your printer.

Configuring Network Connectivity

Your printer may be equipped with one or more of the following interfaces:

• Bluetooth—For detailed information to connect a Bluetooth device, refer to the Bluetooth User Guide.

• Wired print server—For detailed information, refer to the ZebraNet Wired and Wireless Print Servers User Guide.

• Wireless print server—For detailed information, refer to the ZebraNet Wired and Wireless Print Servers User Guide.

For other connectivity options, refer to the User Guide for your printer. Copies of these manuals are available at http://www.zebra.com/manuals.

08/28/2018 Virtual Device-T User Guide P1067299-003

Introduction

Notes

• Other command languages are disabled when running Virtual Device-T. However, Set/Get/Do (SGD) commands and file download all operate properly with Virtual Device-T enabled.

• Virtual Device-T fonts can only be used with Virtual Device-T commands. They cannot be used with other languages.

• The Virtual Device-T mode application will not respond to CPCL, ZPL, or EPL commands. Instead, commands will be processed by the Virtual Device-T application.

P1067299-003 Virtual Device-T User Guide 08/28/2018

Install, Register, and

Enable Virtual Device-T

This section provides you with instructions on how to install and enable the Virtual Device-T application on one or more Zebra printers.

Contents

Acquiring the Virtual Device Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

Downloading the Virtual Device-T Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

Using ZDownloader . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

Adding Printers to the ZDownloader List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

Auto-Detect Printers. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

Manually Add Printers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

Modifying Printers in the List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

Deleting Printers from the List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

Downloading the Virtual Device App to Selected Printers . . . . . . . . . . . . . . . . . . . . 21

Registering the Virtual Device . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

Enabling the Virtual Device . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

Using an SGD Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

Using the User Menus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

QLn420 Printers. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

QLn320 and QLn220 Printers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

Supported ZTxxx and ZDxxx Printers with a Display. . . . . . . . . . . . . . . . . . . . . . . . 32

08/28/2018 Virtual Device-T User Guide P1067299-003

Getting Started

Acquiring the Virtual Device Application

To get the Virtual Device app, perform the following from your computer:

1. Open a web browser and navigate to http://www.zebra.com/virtualdevices.

2. Locate your printer type in the list of printers, and then click Download Now.

3. Fill out the information on the Virtual Device Download Request form.

4. Click Submit.

5. Read the End User License Agreement.

6. Click Accept and Begin Download Now.

Your browser prompts you to open or save the archive containing the Virtual Device app.

7. Save and store the Virtual Device app archive file to your computer.

The archive file contains the following:

• The Virtual Device .NRD file to be downloaded to a Zebra printer.

•A .txt file that contains the SGD command for immediately activating the Virtual Device app.

8. Extract the files from the archive to your computer.

P1067299-003 Virtual Device-T User Guide 08/28/2018

Downloading the Virtual Device-T Application

Zebra provides two options to download the Virtual Device-T app to the printer.

• On a computer with the ZDownloader Utility The ZDownloader Utility is the only method shown in this manual. For instructions

on how to download and install the ZDownloader Utility, see ZDownloader Utility

on page 252.

• On an Android device with the Zebra Printer Setup Utility for Android Devices (available for free on Google Play™)

For information on using the Zebra Printer Setup Utility for Android Devices and to download the user guide, navigate to http://www.zebra.com/setup.

Using ZDownloader

The ZDownloader application can update Virtual Device-T files in Zebra printers connected by Serial, Parallel, USB, and IP Ethernet networks.

Getting Started

Figure 1 • Initial ZDownloader Screen

Adding Printers to the ZDownloader List

There are two ways to add printers to the list:

• Auto-Detect (use for USB or IP Ethernet interfaces)

• Manual add (use for Serial, Parallel, or IP Ethernet interfaces)

If your printer is connecting via the serial or parallel interfaces, or is not detected by using the Auto-Detect method, use the Manual Add method.

08/28/2018 Virtual Device-T User Guide P1067299-003

Getting Started

Downloading the Virtual Device-T Application

Auto-Detect Printers

Use Auto-Detect for USB or IP Ethernet interfaces.

Note • Ethernet connected printers are detected by the application broadcasting a UDP packet out onto the network. UDP port number 4201 is used for the discovery process. Some networks filter out UDP packets. This means that the ZDownloader utility may not be able to detect all of the printers on your network. See your network administrator for more information. If you are not able to AutoDetect your network printers, follow instructions for manually adding a printer.

USB printers can only be added by using Auto-Detect. The ZDownloader utility can support as many USB printers as your computer can support (most computers typically can support up to 255).

P1067299-003 Virtual Device-T User Guide 08/28/2018

Getting Started

Downloading the Virtual Device-T Application

To Auto-Detect printers connected via the USB or IP Ethernet interfaces, perform the following steps:

1. In the ZDownloader toolbar, select Printer > Auto-Detect.

OR Right-click in the ZDownloader window and select Auto-Detect Printers. The printers detected are added to the printer list.

Manually Add Printers

To manually add printers connected via the Serial, Parallel, or Network interfaces, perform the following steps:

1. In the ZDownloader toolbar, select Printer > Add….

OR Right-click in the ZDownloader window and select Add Printer…. The following window appears.

08/28/2018 Virtual Device-T User Guide P1067299-003

Getting Started

Downloading the Virtual Device-T Application

2. Add a printer name and your printer model in the appropriate fields.

3. What type of printer are you adding?

If you are adding a… Then…

Serial Printer Go to Adding a Serial Printer. Parallel Printer Go to Adding a Parallel Printer on page 18. Network Printer Go to Adding a Network Printer on page 19.

Adding a Serial Printer

4. Select the serial port to which the printer is connected.

P1067299-003 Virtual Device-T User Guide 08/28/2018

5. Click Port Settings.

The following window appears.

Getting Started

Downloading the Virtual Device-T Application

6. Adjust the settings as necessary. The printer’s serial port settings must match the

computer’s serial port settings. For more information about the settings, refer to the User Guide for your printer.

7. Click OK to save the port settings.

8. Click OK to add the printer.

08/28/2018 Virtual Device-T User Guide P1067299-003

Getting Started

Downloading the Virtual Device-T Application

Adding a Parallel Printer

9. Set Communication Type to Parallel.

The available parallel ports will be shown in the Port drop-down box.

10. Select the port to which the printer is connected. No additional configuration is

necessary.

11. Click OK to add the printer.

P1067299-003 Virtual Device-T User Guide 08/28/2018

Adding a Network Printer

12. Set Communication Type to Network.

The following window appears.

Getting Started

Downloading the Virtual Device-T Application

13. Enter the printer’s IP address.

14. Click OK to save the network settings.

15. Click OK to add the printer.

Modifying Printers in the List

To change printer settings for a printer in the list, perform the following steps:

1. Select the printer to modify.

08/28/2018 Virtual Device-T User Guide P1067299-003

Getting Started

Downloading the Virtual Device-T Application

2. In the toolbar, select Printer > Modify Printer….

OR Right-click on the printer and select Modify Printer…. The printer settings for the selected printer are displayed.

3. Modify the settings as desired.

4. Click OK to save the settings.

Deleting Printers from the List

To delete printers from the list, perform the following steps:

1. Select one or more printers to delete.

P1067299-003 Virtual Device-T User Guide 08/28/2018

Downloading the Virtual Device-T Application

2. In the toolbar, select Printer > Delete.

OR Right-click on one of the selected printers and select Delete Printer(s). The printer is removed from the list.

Getting Started

Downloading the Virtual Device App to Selected Printers

To download the Virtual Device-T app to your printer(s), you must select the file to send to each printer. ZDownloader, by default, downloads files to one printer at a time. If you have multiple printers to update and want to speed up the process, you can increase the number of simultaneous downloads.

Note • More simultaneous downloads require more of your computer resources. Some computers may slow down with simultaneous downloads or as more printers are added for simultaneous downloading.

To allow simultaneous downloads, perform the following step:

1. Click Tools > Options….

The following prompt appears.

2. Raise the number shown to allow multiple simultaneous downloads.

3. Click OK.

08/28/2018 Virtual Device-T User Guide P1067299-003

Getting Started

Downloading the Virtual Device-T Application

To download the Virtual Device app file to one or more printers, perform the following steps:

1. Select the printers to which you want to download the Virtual Device-T app file. To

select multiple printers, hold down the Ctrl or Shift key, and then click on the desired printers.

2. In the toolbar, select File > Select Firmware File….

OR Right-click on one of the selected printers and select Select Firmware File….

3. Navigate to the Virtual Device app file that you acquired previously.

4. Click Open.

The file that you selected appears under Download File for the selected printers. Printers that are present in the list but that do not have a file selected will be

ignored when Downloading starts.

P1067299-003 Virtual Device-T User Guide 08/28/2018

Getting Started

Downloading the Virtual Device-T Application

5. Start the download process by doing one of the following:

• Select Printer > Download to Selected.

• Select the printer(s) of interest and select the Printer and then select

Download To Selected.

6. In the toolbar, select Printer > Download All.

OR Right-click in the ZDownloader window and select Download All. After downloading has begun, the progress of each printer will be shown in the

Download Status column.

Canceling a Download in Progress

The Cancel Download toolbar button and the Printer > Cancel Download menu options become active when the files are downloading.

To cancel downloading to ALL printers in the list, perform the following step:

1. Click Printer > Cancel Download.

OR Right-click in the ZDownloader window and select Cancel Download.

To cancel downloading to SPECIFIC printers in the list, perform the following step:

1. Select one or more printers with a download in progress.

2. Click Printer > Cancel Download.

OR Right-click on a selected printer and select Cancel Download.

08/28/2018 Virtual Device-T User Guide P1067299-003

Getting Started

Registering the Virtual Device

ZDownloader maintains a log file of all items downloaded to a Zebra printer along with the printer serial number. You can register your Virtual Device installation with Zebra Repair and Tech Support to ensure that a printer sent in for repair is returned with the Virtual Device installed, and when engaging Zebra Tech Support, they will have records of the item being loaded. To register your Virtual Device installation, you must send the log file created by ZDownloader to the Zebra log file management group.

ZDownloader Log File

To send the log file, complete these steps:

1. Based on your operating system, navigate to the appropriate folder:

•Microsoft® Windows® XP

C:\Program Files\Common Files\FirmwareDownloader

• Microsoft Windows 7, Windows 8, and Windows 10

C:\ProgramData\Zebra Technologies\Firmware Downloader and ZBI Key Manager

2. Copy the log file (DownloadLog.txt), and email to Zdownloader@zebra.com.

If you are downloading from several computers, you need to send the log file from each computer. If you download files to printers on one day and do not send the file the same day, please note this in your email so that the log file management group picks up the previous load detail. Otherwise, they only pick up the load data for the day that the log file is sent.

P1067299-003 Virtual Device-T User Guide 08/28/2018

Enabling the Virtual Device

You can enable Virtual Device-T by sending a Set/Get/Do (SGD) command to the printer or by selecting the option through the printer’s menus.

Using an SGD Command

To enable Virtual Device-T on your printer, send the following command:

! U1 setvar "apl.enable" "apl-t"

To disable Virtual Devices on your printer and return to normal function, send the following command:

! U1 setvar "apl.enable" "none"

You must restart the printer after changing the value of apl.enable. For more information about this SGD command, see apl.enable on page 180.

Getting Started

Enabling the Virtual Device

Using the User Menus

This section includes instructions for the following printers:

• QLn420 Printers on page 26

• QLn320 and QLn220 Printers on page 29

• Supported ZTxxx and ZDxxx Printers with a Display on page 32

If necessary, refer to the User Guide for your printer for additional information about your printer’s control panel.

08/28/2018 Virtual Device-T User Guide P1067299-003

Getting Started

PRINTER READY

VXXXXXXX

SETTINGS

LANGUAGE

Enabling the Virtual Device

QLn420 Printers

1. From the printer’s idle display screen, press the LEFT SOFT KEY to select the

Home icon.

The printer displays the Home Menu.

2. Use the ARROWS to navigate to the LANGUAGE menu.

P1067299-003 Virtual Device-T User Guide 08/28/2018

3. Press OK.

LANGUAGE

▼ ENGLISH ▲

VIRTUAL DEVICE

▼ NONE ▲

The printer displays the LANGUAGE selection screen.

Getting Started

Enabling the Virtual Device

4. Use the LEFT or RIGHT ARROW to navigate to the VIRTUAL DEVICE selection

screen.

08/28/2018 Virtual Device-T User Guide P1067299-003

Getting Started

VIRTUAL DEVICE

▼ APL-T ▲

USE

Enabling the Virtual Device

5. Use the UP or DOWN ARROW to scroll to the APL-T option.

6. Press the RIGHT SOFT KEY to select USE.

The printer restarts and uses the Virtual Device that you selected.

P1067299-003 Virtual Device-T User Guide 08/28/2018

QLn320 and QLn220 Printers

Zebra QLn320 FW ver: XXXXXXXXXX Baud Rate: 115200 Battery ok IP Addr: 10.14.205.138

Communication Back

Settings Back

1. From the printer’s idle display screen, press the LEFT SOFT KEY to select the

Home icon.

Getting Started

Enabling the Virtual Device

The printer displays the Home Menu.

2. Use the ARROWS to navigate to the SETTINGS menu.

08/28/2018 Virtual Device-T User Guide P1067299-003

Getting Started

Virtual Dev: none ▲▼

Menu Use Back

Virtual Dev: apl‐t ▲? ▼

Menu Use Back

Enabling the Virtual Device

3. Press OK.

The printer displays the VIRTUAL DEVICE selection screen.

4. Press the RIGHT ARROW to highlight the up arrow on the display.

5. With the up arrow highlighted, press the OK button until you scroll to the APL-T

option.

P1067299-003 Virtual Device-T User Guide 08/28/2018

6. Press the LEFT ARROW to highlight APL-T

7. Press OK to select USE.

The printer restarts and uses the Virtual Device that you selected.

Getting Started

Enabling the Virtual Device

08/28/2018 Virtual Device-T User Guide P1067299-003

Getting Started

PRINTER READY

VXXXXXXX

HOME MENU

SETTINGS

Enabling the Virtual Device

Supported ZTxxx and ZDxxx Printers with a Display

Note • The ZT230 control panel is shown in this procedure. The control panel for the

other printers is similar.

1. From the printer’s idle display screen, press the LEFT SELECT KEY to select the

Home icon.

The printer displays the Home Menu.

P1067299-003 Virtual Device-T User Guide 08/28/2018

2. Use the ARROWS to navigate to the LANGUAGE menu.

HOME MENU

SETTINGS

▼

LANGUAGE

ENGLISH

▲

Getting Started

Enabling the Virtual Device

3. Press OK.

The printer displays the LANGUAGE selection screen.

08/28/2018 Virtual Device-T User Guide P1067299-003

Getting Started

▼

VIRTUAL DEVICE

NONE

▲

▼

VIRTUAL DEVICE

APL-T

▲

USE

Enabling the Virtual Device

4. Use the LEFT or RIGHT ARROW to navigate to the VIRTUAL DEVICE selection

screen.

5. Use the UP or DOWN ARROW to scroll to the APL-T option.

P1067299-003 Virtual Device-T User Guide 08/28/2018

6. Press the RIGHT SOFT KEY or OK to select USE.

▼

VIRTUAL DEVICE

APL-T

▲

USE

Getting Started

Enabling the Virtual Device

The printer restarts and uses the Virtual Device that you selected.

08/28/2018 Virtual Device-T User Guide P1067299-003

Commands

This section provides a detailed listing of commands for use on your Zebra printer with the Virtual Device-T app.

Contents

Interface Command Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

Command Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

TPCL Mode Supported Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38

Setting Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

Fine Adjustment Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46

Clear Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50

Drawing Format Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53

Print Data Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140

Issue and Feed Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155

Format Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159

Writable Character Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160

Graphics Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164

PC Command Saving Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171

Check Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174

Status Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175

Bluetooth and Wireless LAN Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179

Set/Get/Do (SGD) Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180

08/28/2018 Virtual Device-T User Guide P1067299-003

Interface Command Format

The commands are sent to the printer in the following format:

ESC Command and Data LF NUL

Alternately, the following syntax may be used:

{ Command and Data | }

The command length from [ESC] to [LF] [NUL} must conform to what is specified for each command.

The two following kinds of control codes exist:

ESC (1BH), LF (0AH), NUL (00H)

{ (7BH), | (7CH), } (7DH)

Commands

Interface Command Format

Command Format

The commands in this section are presented in the following format.

Command

Description Command Function

Syntax

(example below for EOT). Variable values are denoted by n and other letters.

Range The values that can be used for n or other variables (if any).

Default Initial value of n (if any).

Notes In-depth description of the command function.

Command format in ASCII followed by Hexadecimal and decimal equivalents

EOTn

ASCII

Hex

Decimal

EOT n

04 n

4 n

08/28/2018 Virtual Device-T User Guide P1067299-003

Commands

TPCL Mode Supported Commands

Command Function

Setting Commands

[ESC] D on page 41 Set Label Size [ESC] ID on page 44 Set the Printer ID [ESC] M on page 45 Select the Print Mode

Fine Adjustment Commands

[ESC] AX on page 46 Fine Adjust the Print Start Position [ESC] AY on page 48 Fine Adjust Print Density That Was Set Automatically [ESC] AH on page 49 Adjust the Strip Sensor

Clear Commands

[ESC] C on page 50 Clear the Image Buffer [ESC] XR on page 51 Clear or Reverse a Specified Area

Drawing Format Commands

[ESC] LC on page 53 Draw a Line or Rectangle [ESC] PC on page 58 Specify a Bitmap Font Format [ESC] PV on page 71 Specify an Outline Font Format

[ESC] XB Specify a Barcode or Two-Dimensional Code Format

[ESC] XB on page 82 WPC, CODE93, CODE128, UCC/EAN128, EAN128, POSTNET [ESC] XB on page 92 MSI, Interleaved 2 of 5, CODE39, NW7, Industrial 2 of 5 [ESC] XB on page 101 GS1 Databar [ESC] XB on page 108 Two-Dimensional Code Format (Data Matrix) [ESC] XB on page 117 Two-Dimensional Code Format (PDF417) [ESC] XB on page 123 Two-Dimensional Code Format (MicroPDF417) [ESC] XB on page 129 Two-Dimensional Code Format (QR Code) [ESC] XB on page 135 Two-Dimensional Code Format (MaxiCode)

Print Data Commands

[ESC] RC on page 140 Specify Bitmap Font Data [ESC] RV on page 143 Specify Outline Font Data

[ESC] RB Specify Data for a Barcode or Two-Dimensional Code

[ESC] RB on page 146 Barcode/Two-Dimensional Code Data (any codes other than

MaxiCode)

[ESC] RB on page 154 Two-Dimensional Code Data (MaxiCode)

P1067299-003 Virtual Device-T User Guide 08/28/2018

Command Function

Issue and Feed Commands

[ESC] XF Storage Area Allocation.

Consumed but not processed.

[ESC] XS on page 155 Issue Labels [ESC] T on page 157 Feed Media

Commands

TPCL Mode Supported Commands

[ESC] U1 or [ESC] U2 on page 158

Forward/Reverse Feed

Support for these commands was added after the initial release. To use the commands, download the latest version of the Virtual

Device-T app.

Format Commands

[ESC] J1 on page 159 Format Flash Memory

Writable Character Commands

[ESC] XE 2-Byte Writable Character Code Range.

Consumed but not processed.

[ESC] XD on page 160 Store Bitmap Writable Character

Graphics Commands

[ESC] SG on page 164 Draw Graphic

PC Command Saving Commands

[ESC] XO on page 171 Start Save Operation [ESC] XP on page 173 Terminate Save Operation [ESC] XQ on page 173 Read Saved Data

Check Commands

[ESC] HD Check Printhead for Broken Dots.

Consumed but not processed.

[ESC] XJ Display Message on LCD.

Consumed but not processed.

[ESC] WR on page 174 Reset the Printer [ESC] Z0 (zero) on page 174 Reset Device

Status Commands

[ESC] WS, [ESC] FM, [ESC]

Request Printer Status

v on page 175 [ESC] WB on page 176 Request Printer Status and Free Buffer Space [ESC] WX on page 176 Acquire Mode Information [ESC] WV on page 177 Acquire Version Information

08/28/2018 Virtual Device-T User Guide P1067299-003

Commands

TPCL Mode Supported Commands

Command Function

Bluetooth and Wireless LAN Commands

[ESC] IT on page 179 Acquire the Device Address [ESC] WT Acquire Bluetooth Parameters.

Consumed but not processed.

P1067299-003 Virtual Device-T User Guide 08/28/2018

Setting Commands

[ESC] D

Description Set Label Size

Commands

Setting Commands

Syntax

Range

a = length (pitch) of the label or tag from 10.0 to 999.9 mm (0.39 to 39.37 in.) in 0.1 mm

b = print width in 0.1 mm (0.0039 in.) increments. Must be four digits. c = print length from 7.0 to 997.0 mm (0.28 to 39.25 in.) in 0.1 mm (0.0039 in.) increments.

d = optional reserved area. Must be four digits.

Notes This command specifies the length (pitch) of a label or tag, including backing. The values set with this command are retained even if the printer is power cycled.

If the value specified for parameter a, b, or c is greater than the printer can support, the maximum value is used. If a value is smaller than the printer can support, the minimum value is used. Refer to the User Guide for your printer for the exact print specifications for your printer. The value for the optional reserved area is not checked. Values outside of the supported area may be ignored, or an error may occur.

[ESC] Da, b, c(, d) [LF] [NUL]

(0.0039 in.) increments. Must be four or five digits.

4 digits = 0100 to 9999 5 digits = 00100 to 09999

Must be four or five digits.

4 digits = 0070 to 9970 5 digits = 00070 to 09970

0300 to 1120

If you change the size of the labels that you are using or the label sensor type, you must first transmit this command. After that, feed one label by [ESC] T on page 157 to position the label properly prior to printing. After transmitting this command, you must clear the image buffer using [ESC] C on page 50.

The origin of drawing coordinates and the print stop position (printhead position when printing stops) are adjustable by the Fine Adjustment Commands

If you change the print position or if the gap between labels is not 3 mm, use [ESC]

AX on page 46 as required.

08/28/2018 Virtual Device-T User Guide P1067299-003

on page 46.

Commands

Setting Commands

Top-First Printing

Bottom-First Printing

P1067299-003 Virtual Device-T User Guide 08/28/2018

Commands

Setting Commands

Example 1 • Label with 51.8 mm pitch, 46.8 mm print length, and 76 mm print width

[ESC] D0518, 0760, 0468, 0820 [LF] [NUL]

[ESC] T20C40 [LF] [NUL]

Example 2 •

[ESC] D0772, 0996, 0722 [LF] [NUL]

[ESC] T10C40 [LF] [NUL]

Tag with 77.2 mm pitch, 72.2 mm print length, and 99.6 mm print width

08/28/2018 Virtual Device-T User Guide P1067299-003

Commands

Setting Commands

[ESC] ID

Description Set the Printer ID

[ESC] ID ; a(,b) [LF] [NUL]

Syntax

Range

a = a 5-digit printer ID value (2-byte hex data)

b = reserved (can be omitted; any value other than 0 causes an error)

Notes This command sets the ID for the printer, which is used by the host to identify each printer. The printer ID is retained even if [ESC] WR on page 174 is executed or if the printer is power cycled.

Example • To set 03H 51H as the ID of the printer, send

0000H to FFFFH

Fixed at 0

[ESC] ID; [03H] [51H] [LF] [NUL]

In this example, the printer ID would be 00849.

P1067299-003 Virtual Device-T User Guide 08/28/2018

[ESC] M

Description Select the Print Mode

Commands

Setting Commands

Syntax

[ESC] M; a (,b) [LF] [NUL]

Range

a = print mode designation

HEX ASCII

Print Mode

How received data is dealt with after an error is cleared

30H 0 LABEL Discarded 31H 1 RECEIPT Discarded 32H 2 RECEIPT1 Continues printing 41H A TPCL

Continues printing

(default mode)

b = Reserved.

Notes This command specifies the print mode. The value set with this command is retained even if the printer is power cycled.

08/28/2018 Virtual Device-T User Guide P1067299-003

Commands

Fine Adjustment Commands

[ESC] AX

Description Fine Adjust the Print Start Position

Syntax

Range

a = whether the direction of the print position should be adjusted forward or backward.

b = value by which to change the print position (in 0.1 mm units)

c = whether the direction of the strip position should be adjusted forward or backward.

d = value by which to change the strip position (in 0.1 mm units)

e = Reserved. (Can be omitted.) f = Reserved. (Can be omitted.) g = Reserved. (Can be omitted.) h = Reserved. (Can be omitted.) h = Reserved. (Can be omitted.)

Notes This command adjusts the feed value so that the label shifts forward or backward from the automatically set print start position. The values set with this command are retained even if the printer is power cycled. The factory default value is

0.0 mm.

[ESC] AX; ab, cd(, ef, gh) [LF] [NUL]

+ = Backward – = Forward

000 to 500 (0 to ±50 mm)

+ = Backward – = Forward

000 to +030 (0 to 3.0 mm) 000 to –020 (0 to –2.0 mm)

The fine adjustment values changed by this command in LABEL mode, are also effective in TPCL mode.

A command error occurs in the following instances:

• When parameter a or c is set to anything other than + or -

• When any out-of-range value is specified for parameter b or d.

When the label pitch is 20.0 to 24.0 mm and the print length is 15.0 mm or more or when the label pitch is 24.0 mm or more, the printer backfeeds before printing.

P1067299-003 Virtual Device-T User Guide 08/28/2018

Example 1 • Print position fine adjustment

Commands

Fine Adjustment Commands

08/28/2018 Virtual Device-T User Guide P1067299-003

Commands

Fine Adjustment Commands

[ESC] AY

Description Fine Adjust Print Density That Was Set Automatically

[ESC] AY ; ab, c (, d) [LF] [NUL]

Syntax

Range

a = makes the print density higher or lower, resulting in darker or lighter print

+ = Increase the density (darker print) – = Decrease the density (lighter print)

b = value by which to change the print density

00 to 30

c = print mode

0 = Reserved 1 = direct thermal

d =Reserved

2-inch printhead width

0 = Auto (divided by 2 or 3) 1 = Reserved (if specified, Auto (divided by 2 or 3)) 2 = Fixed at divided by 3 3 = Auto1 (not divided/divided by 2 or 3) 4 = Reserved (if specified, fixed at divided by 3) 5 = Auto2 (not divided/divided by 2 or 3)

Default = 3 The Auto1 selection is print-quality oriented, while Auto2 is print-speed oriented.

Auto2 uses a higher print speed and may result in lighter print.

4-inch printhead width

0 = Auto (divided by 2, 3, or 6) 1 = Reserved (if specified, Auto (divided by 2, 3, or 6)) 2 = Reserved (if specified, Auto (divided by 2, 3, or 6)) 3 = Auto1 (not divided/divided by 2, 3, or 6) 4 = Fixed at divided by 6

Default = 3

Notes This command adjusts print density that was set automatically. The values set with this command are retained even if the printer is power cycled. A command error occurs when any out-of-range fine adjustment value is specified.

The fine adjustment values changed by this command in TPCL mode, are also effective in LABEL, RECEIPT, and ESC/POS modes.

Example 1 • Send the following to set the density to –2:

[ESC] AY; -02, 1 [LF] [NUL]

Example 2 • Send the following to set the density to +3:

[ESC] AY; +03, 1 [LF] [NUL]

P1067299-003 Virtual Device-T User Guide 08/28/2018

[ESC] AH

Description Adjust the Strip Sensor

Syntax

Range

a = one of the following settings

Notes This command sets the sensor threshold value that switches between strip and batch modes. The values set by this command are stored and used when the printer is powered up.

Fine Adjustment Commands

[ESC] AH; a [LF] [NUL]

0 = operation in conformance with the strip sensor 1 = operation in conformance with the strip sensor 2 = batch mode only 3 = strip mode only 4 = Reserved (The command is ignored if this is specified.)

Default = 0

Commands

08/28/2018 Virtual Device-T User Guide P1067299-003

Commands

Clear Commands

[ESC] C

Description Clear the Image Buffer

Syntax

Notes This command clears the image buffer of drawing characters, lines, barcodes,

and graphics. Use this command after you change the label size using [ESC] D

on page 41.

When this command is transmitted, the increment/decrement designation and the link field designations are reset.

Example • This example shows how [ESC] C is used after changing the label size.

[ESC] C [LF] [NUL]

[ESC] D0508, 0760, 0468 [LF] [NUL]

[ESC] T20C41 [LF] [NUL]

[ESC] C [LF] [NUL]

[ESC] PC000; 0080, 0065, 1, 1, A, +00, 00, B, J0000, M0, +0000000000, Z00, P1 [LF] [NUL]

[ESC] PC001; 0250, 0150, 1, 1, G, +00, 00, B, J0000, M0, +0000000000, Z00, P1 [LF] [NUL]

[ESC] RC000; ABC [LF] [NUL]

[ESC] RC001; DEF [LF] [NUL]

[ESC] XS; I, 0001, 0002C1000 [LF] [NUL]

P1067299-003 Virtual Device-T User Guide 08/28/2018

[ESC] XR

Commands

Clear Commands

Description Clear or Reverse a Specified Area

[ESC] XR; a, b, c, d, e [LF] [NUL]

Syntax

Range

a = the X coordinate of the start point of the area to be cleared. Must be four digits. Specified

b = the Y coordinate of the start point of the area to be cleared. Must be four or five digits.

c = the X coordinate of the end point of the area to be cleared. Must be four digits. Specified

d = the Y coordinate of the end point of the area to be cleared. Must be four or five digits.

e = how to clear the specified area (If a value other than A or B is specified, an error occurs.)

in 0.1 mm (0.0039 in.) increments.

0100 to 1057

Fixed at 4 digits (in 0.1 mm units)

Specified in 0.1 mm (0.0039 in.) increments.

4 digits = 0100 to 9999 5 digits = 00100 to 09999

in 0.1 mm (0.0039 in.) increments.

0100 to 1057

Specified in 0.1 mm (0.0039 in.) increments.

4 digits = 0100 to 9999 5 digits = 00100 to 09999

A = clear the contents in the designated area B = reverse black/white in the designated area.

Notes This command clears a designated area or reverses black/white printing in the

designated area in the drawing area. The start and end point coordinates specified must be set within the print area set by the [ESC] D on page 41. The results of this command are the same when the start and end point coordinates are reversed.

Example • This example shows how to clear a specified area.

[ESC] XR; 0345, 0100, 0762, 0585, A [LF] [NUL]

[ESC] XS; I, 0001, 0002C4000 [LF] [NUL]

08/28/2018 Virtual Device-T User Guide P1067299-003

Commands

Clear Commands

P1067299-003 Virtual Device-T User Guide 08/28/2018

Drawing Format Commands

[ESC] LC

Description Draw a Line or Rectangle

Commands

Drawing Format Commands

Syntax

Range

a = the X coordinate of the start point. Must be four digits. Specified in 0.1 mm (0.0039 in.)

b = the Y coordinate of the start point. Must be four or five digits. Specified in 0.1 mm

c = the X coordinate of the end point. Must be four digits. Specified in 0.1 mm (0.0039 in.)

d = the Y coordinate of the end point. Must be four or five digits. Specified in 0.1 mm

e = type of line or rectangle to draw (A command error occurs if the specified value is

f = thickness of the line to be drawn. Specified in 0.1 mm (0.0039 in.) increments. A

g = radius of rounded corners of a rectangle (Can be omitted. If omitted, the rectangle

[ESC] LC; a, b, c, d, e, f (, g) [LF] [NUL]

increments.

0100 to 1057

Fixed at 4 digits (in 0.1 mm units)

(0.0039 in.) increments.

4 digits = 0100 to 9999 5 digits = 00100 to 09999

increments.

0100 to 1057

(0.0039 in.) increments.

4 digits = 0100 to 9999 5 digits = 00100 to 09999

anything other than 0 to 6.)

0 = line (horizontal, vertical) 1 = rectangle 2 = Reserved (If specified, processed as 0.) 3 = Reserved (If specified, processed as 1.) 4 = Reserved (If specified, processed as 1.) 5 = Reserved (If specified, processed as 0.) 6 = Reserved (If specified, processed as 1.)

command error occurs if this is set to zero.

1 to 9 or 01 to 99

corners are drawn square, not rounded.) Must be three digits. Specified in 0.1 mm (0.0039 in.) increments. This parameter is ignored unless parameter e is set to 1 or 3.

000 to 999

Notes This command specifies the parameters for drawing a line or rectangle. The start and end point coordinates specified must be set within the print area set by the

[ESC] D on page 41. The results of this command are the same when the start and

end point coordinates are reversed.

08/28/2018 Virtual Device-T User Guide P1067299-003

Commands

Drawing Format Commands

Example 1 • This example shows the different results based on whether the top or bottom of the label is printed first.

Example 2 • A horizontal line is drawn when |Y

Example 3 • A vertical line is drawn when |X

- Y1| = 0.

- X1| = 0.

Example 4 • A slanted line is drawn when |X2 - X1| < |Y2 - Y1|.

P1067299-003 Virtual Device-T User Guide 08/28/2018

Commands

Drawing Format Commands

Example 5 • A slanted line at a different angle results when |X2 - X1| > |Y2 - Y1|.

08/28/2018 Virtual Device-T User Guide P1067299-003

Commands

| X

– X

| Y

– Y

the radius of the rounded corners

Drawing Format Commands

Example 6 • A rectangle with square corners is drawn when the corner radius is specified as 000 or by default when a corner radius is not specified.

Example 7 • A rectangle with rounded corners is drawn when a corner radius other than 000 is specified.

To draw a circle, use coordinates that meet the following criteria:

P1067299-003 Virtual Device-T User Guide 08/28/2018

Commands

Drawing Format Commands

Example 8 • This example shows how to draw a horizontal line and a vertical line that start at the same point.

[ESC] C [LF] [NUL]

[ESC] LC; 0200, 0050, 0305, 0050, 0, 4 [LF] [NUL]

[ESC] LC; 0200, 0050, 0200, 0280, 0, 4 [LF] [NUL]

[ESC] XS; I, 0001, 0002C4000 [LF] [NUL]

08/28/2018 Virtual Device-T User Guide P1067299-003

Commands

Drawing Format Commands

[ESC] PC

Description Specify a Bitmap Font Format

Syntax

This command has two possible formats:

[ESC] PCa; b, c, d, e, f (, gh), i, j (, Jkl) (, Mm) (, no) (, Zp) (, Pq) (= r ‐‐‐‐‐‐ r) [LF] [NUL]

[ESC] PC (, Z

a; b, c, d, e, f (, gh), i, j (, Jkl) (, Mm) (, no)

p) (, Pq) (; s1, s2, s3, ------ , s20) [LF] [NUL]

Range

a = character string number. Can be two or three digits.

000 to 199 or 00 to 99

b = the X coordinate of the print origin of the character string. Must be four digits. Specified

in 0.1 mm (0.0039 in.) increments.

0100 to 1057

c = the Y coordinate of the print origin of the character string. Must be four or five digits.

Specified in 0.1 mm (0.0039 in.) increments.

4 digits = 0100 to 9999 5 digits = 00100 to 09999

d = the character horizontal magnification factor

1 digit indicates the number of times to magnify = 1 to 9 2 digits indicate that the magnification is in fractional increments =

05 to 95 (0.5 to 9.5 in 0.5 unit increments) 06 to 09 (0.6 to 0.9 in 0.1 unit increments)

e = the character vertical magnification factor

1 digit indicates the number of times to magnify = 1 to 9 2 digits indicate that the magnification is in fractional increments =

05 to 95 (0.5 to 9.5 in 0.5 unit increments) 06 to 09 (0.6 to 0.9 in 0.1 unit increments)

f = the type of bitmap font (See Table 5, Supported Bitmap Fonts on page 183 for

examples.)

Font Description

Times Roman (Medium)* 12 points

Times Roman (Medium)* 15 points

Times Roman (Bold)* 15 points

Times Roman (Bold)* 18 points

Times Roman (Bold)* 21 points

Times Roman (Italic)* 18 points

Helvetica (Medium)* 9 points

Helvetica (Medium)* 15 points

Helvetica (Medium)* 18 points

Helvetica (Bold)* 18 points

Helvetica (Bold)* 21 points

* Indicates proportional fonts

P1067299-003 Virtual Device-T User Guide 08/28/2018

Size

(203-dpi printhead)

Font Description

Helvetica (Italic) 18 points*

Presentation (Bold) 27 points

Letter Gothic (Medium) 14.3 points

Prestige Elite (Medium) 10.5 points

Prestige Elite (Bold) 15 points

Courier (Medium) 15 points

Courier (Bold) 18 points

OCR-A 12 points

OCR-B 12 points

Gothic725 Black * 6 points

Size

(203-dpi printhead)

Commands

Drawing Format Commands

gh = fine adjustment of character-to-character space (Can be omitted, in which case space is

adjusted according to the designated font.)

g = increases or decreases the character-to-character space.

+ = Increase the space – = Decrease the space

h = number of dots between characters. Must be two digits.

00 to 99 dots

i = rotational angle of a single character and character strings

Single

Character

Character String

00 0° 0° 11 90° 90° 22 180° 180° 33 270° 270°

j = character attributes

B = black characters W (xy) = reverse characters* **

x = number of dots horizontally from the character string to the end of the black

background. Must be two digits.

01 to 99

y = number of dots vertically from the character string to the end of the black

background. Must be two digits.

01 to 99

F (xy) = boxed characters* ***

x = number of dots horizontally from the character string to the surrounding box.

Must be two digits.

01 to 99

y = number of dots vertically from the character string to the surrounding box.

Must be two digits.

01 to 99

C (x) = strike-through characters* ***

x = number of dots horizontally from the character string to the end of the strike-

through line. Must be two digits.

01 to 99

* Specifications in parentheses can be omitted, in which case the value used is the character magnification (horizontal or vertical, whichever is larger) x 6 dots.

Jkl = bold character shift* (may be omitted, in which case characters are not shifted)

k = distance in dots to shift horizontally. Must be two digits.

00 to 16

l = distance in dots to shift vertically. Must be two digits.

00 to 16

08/28/2018 Virtual Device-T User Guide P1067299-003

Commands

Drawing Format Commands

Mm = attach the specified check digit* (Can be omitted, in which case no check digit is drawn.

If any data other than numerals are included for the fonts listed below, no drawing is performed.)

m = the type of check digit*

0 = Modulus 10 (draws data and check digit)—Data must include only numerals. 1 = Modulus 43 (draws data and check digit)—Data must include only CODE39. 2 = DBP Modulus 10** (draws only the check digit)—Data must include only

numerals.

* The check digit cannot be specified if the font type is U, V, r, s, or w. If a value is specified, the printer ignores it.

** DBP Modulus 10 is Modulus 10 for Deutsche Bundespost Postdienst only.

no = increment and decrement* (Can be omitted, in which case no increment/decrement is

performed.)

n = specifies whether to increment or decrement

+ = Increment – = Decrement

o = skip value. Must be ten digits.

0000000000 to 9999999999

* Increment/decrement cannot be specified if the font type is U, V, r, s, w, or a (for JA type only). If a value is specified, the printer ignores it.

Zp = zero suppression* (Can be omitted, in which case zero suppression is not performed.)

p = number of digits after zero suppression. Must be two digits.

00 to 20

Pq = alignment* (Can be omitted, in which case left alignment is used.)

q = specifies the character position.

1 = left 2 = center 3 = right 4a = justified

a = character string in the X direction (in 0.1 mm units)

0050 to 1040

5abc = automatic line feed

Note: Lines may not be divided exactly the same as they are with

TOSHIBA TEC

printers.

a = character string in the X direction (in 0.1 mm units)

0050 to 1040

b = line feed spacing (in 0.1 mm units)

010 to 500

c = number of lines

01 to 99

* When the rotational angle of a character or character string is set to 01, 12,

23, or 30, the printer ignores alignment and automatic line feed input.

P1067299-003 Virtual Device-T User Guide 08/28/2018

Commands

Drawing Format Commands

r = a data string to be printed (Can be omitted.)

255 digits maximum

s1, s2, s3, ..., s20 = up to 20 link field numbers, separated by commas (Can be omitted.)

01 to 99 or 1 to 99

Notes This command specifies where and how a bitmap font is to be printed on a label. When drawing using the Data Command ([ESC] RC on page 140), the format specified by the character string number is used.

The Bitmap Font Format Command ( [ESC] PC on page 58) may be connected to the Outline Font Format Command ([ESC] PV on page 71) when transmitted. For example:

[ESC] P C001; 0100, 0150, 1, 1, A, 00, B [LF]

C002; 0350, 0180, 1, 1, A, 00, B [LF] C005; 0200, 0300, 25, 2, C, +05, 00, B,

+0000000001 [LF]

V01; 0500, 0400, 0100, 0100, A, 00, B [LF] [NUL]

When the drawing data is different between labels, the drawing data field for the previous label is cleared automatically using the character string number, and then the next drawing data field is printed. Therefore, you should specify the character string number so that they differ for the drawing fields.

Because the automatic field clearing is not performed between the Clear command ([ESC] C on page 50) and the Issue command ([ESC] XS on page 155), the fixed data may be drawn using the same character string number. In this case, the Format command and Data command should be sent alternately. (After you send the Issue command, the fields with the same character string number are automatically cleared until you send the Clear command.)

The link field designation is cleared by omitting the link field designation using the same character string number and reformatting data. The link field designation can be also cleared by [ESC] C on page 50.

A print data string and link field number cannot be programmed at the same time.

When a reserved font type is designated, a bitmap font format is not specified.

You can program drawing data by designating a number of digits after the = symbol. With most fonts, up to 255 digits of characters can be printed. If the number of characters exceeds the maximum number of digits, the excess data will be discarded. For the character codes, refer to Character Code Tables on page 194.

08/28/2018 Virtual Device-T User Guide P1067299-003

Commands

Drawing Format Commands

Example 1 • The print origin of coordinates must be set so that the character drawing result is within the print area set by [ESC] D on page 41.

Example 2 •

orientation

Examples of horizontal and vertical magnification, based on text

P1067299-003 Virtual Device-T User Guide 08/28/2018

Commands

Drawing Format Commands

Example 3 •

Example of the relationship between drawing coordinates and

magnification.

Example 4 •

Example of

fine adjustment of character-to-character space

If no character-to-character space is specified or if the number of dots of space between characters is zero, drawing takes place according to horizontal spacing/proportional spacing determined for each character. If a character-tocharacter space is specified, this value is added to the character

spacing/proportional

spacing.

Example 5 •

08/28/2018 Virtual Device-T User Guide P1067299-003

Example of rotational angles

Commands

Drawing Format Commands

Example 6 • Example of character attributes

Example 7 •

Example of bold character designation

P1067299-003 Virtual Device-T User Guide 08/28/2018

Commands

Drawing Format Commands

Example 8 • The printer prints while data is incremented or decremented each time that a label format is sent. If a data row exceeds 40 digits, the row is not drawn.

Initial value 0000 0000 0000 0000 999999 INC/DEC +10 +10 +10 +10 +1 Zero suppression not designated 5 3 0 3 1st label 0000 0000 2nd label 0010 0010 3rd label 0020 0020 4th label 0030 0030 5th label 0040 0040

(? indicates a space but does not print.)

?000 0000 999999 ?010 0010 ???000 ?020 0020 ???001 ?030 0030 ???002 ?040 0040 ???003

Example 9 • Handling of letters and numerals for incrementing/decrementing

The data string can include up to 40 digits of letters, numerals, and symbols. Only the numerals are subjected to incrementing/decrementing. The incremented/decremented value is returned to the position of the original numeral for printing.

Initial value 00000 A0A0A 7A8/9 A2A0A INC/DEC +1 +1 +3 –3 1st label 00000 A0A0A 7A8/9 A2A0A 2nd label 00001 A0A1A 7A9/2 A1A7A 3rd label 00002 A0A2A 7A9/5 A1A4A 4th label 00003 A0A3A 7A9/8 A1A1A 5th label 00004 A0A4A 8A0/1 A0A8A

08/28/2018 Virtual Device-T User Guide P1067299-003

Commands

0001

AB-0100

0002

AB-0102

0003

AB-0104

00000

Drawing Format Commands

Example 10 • The printer can draw up to 32 fields for which increment/decrement has been designated. If the total number of bitmap font, outline font, and barcode increment/decrement fields is greater than 32, drawing takes place without incrementing/decrementing more than the first 32 fields. The fields are incremented or decremented as specified until the Image Buffer Clear command ([ESC] C

on page 50) is transmitted.

This sample shows how you would send commands to increment/decrement different fields on labels:

1. Command: Format (incrementing character string number 001 (+1))

2. Command: Format (non-incrementing character string number 002)

3. Command: Format (incrementing character string number 003 (+2))

4. Command: Image Buffer Clear

5. Command: Data (character string number 001 “0001”)

6. Command: Data (character string number 002 “AB-”)

7. Command: Data (character string number 003 “0100”)

8. Command:

9. Command:

10. Command: Image Buffer Clear

11. Command: Data (character string number 02 “00000”)

12. Command:

Issue (2 labels)

Issue (1 label)

P1067299-003 Virtual Device-T User Guide 08/28/2018

Commands

Drawing Format Commands

Example 11 •

Zero suppression works by replacing leading zeroes with spaces, according to the specified number of digits. In instances where the number of digits after zero suppression is greater than the data row, the printer draws the data row without performing zero suppression.

If a data row exceeds 40 digits, the data row is

not drawn.

Number of digits after zero suppression

0122345

data 0000 0000 0000 0A12 0123 0123 0123 print result 0000

(? indicates a space but does not print.)

???0 ??00 ?A12 ?123 0123 0123

Example 12 • How alignment affects text placement

If characters are not all on one line when justification and automatic line feed are specified, the printer does the following:

1. The character-to-character space is decreased.

2. If the characters do not fit on one line even if the character-to-character space value is set to

0, that value returns to its default. Then the horizontal magnification is reduc ed for a character by 0.5.

3. If the characters still do not fit on one line, the value of the character-to-character space is

repeatedly decreased, and the horizontal magnification is reduced.

4. If the characters do not fit on one line after the character magnification is set to 0.5 and the

character-to-character space is set to 0, the field is not drawn.

Example 13 • The check digit attachment, increment/decrement, and zero suppression are prioritized as follows. If any of the conditions is invalid, no drawing takes place.

increment/decrement > zero suppression > attachment of check digit

08/28/2018 Virtual Device-T User Guide P1067299-003

Commands

Drawing Format Commands

Example 14 • Programming link field numbers

A link field number can be designated after a semicolon (;) in a Format command. After the link field number is designated, the data strings are linked by a Link Field Data command to draw an image.

Up to 20 fields can be linked. An error occurs if the number of link fields exceeds 20.

The following example shows linked fields on two continuous labels.

P1067299-003 Virtual Device-T User Guide 08/28/2018

Commands

Drawing Format Commands

Example 15 • The following sample code would result in a label as shown.

[ESC] C [LF] [NUL]

[ESC] PC000; 0200, 0300, 1, 1, A, 00, B=ABCD [LF] [NUL]

[ESC] PC001; 0200, 0125, 1, 1, C, 00, B [LF] [NUL]

[ESC] PC002; 0650, 0550, 2, 2, G, 33, B, +0000000001 [LF] [NUL]

[ESC] RC001; Sample [LF] [NUL]

[ESC] RC002; 001 [LF] [NUL]

[ESC] XS; I, 0002, 0002C4000 [LF] [NUL]

08/28/2018 Virtual Device-T User Guide P1067299-003

Commands

Drawing Format Commands

Example 16 • The following sample code would result in a label as shown.

[ESC] C [LF] [NUL]

[ESC] PC001; 0200, 0300, 1, 1, C, 00, B; 01, 02 [LF] [NUL]

[ESC] PV01; 0650, 0550, 0200, 0150, B, 33, B; 02 [LF] [NUL]

[ESC] XB01; 0200, 0550, 3, 1, 03, 03, 08, 08, 03, 0, 0150; 01, 02 [LF] [NUL]

[ESC] RC; S [LF] 001 [LF] [NUL]

[ESC] XS; I, 0002, 0002C4000 [LF] [NUL]

P1067299-003 Virtual Device-T User Guide 08/28/2018

[ESC] PV

Description Specify an Outline Font Format

Commands

Drawing Format Commands

Syntax

This command has two possible formats:

[ESC] PVa; b, c, d, e, f (, gh), i, j (, Mk) (, Lm) (, Zn) (, Po) (, Qq, Rr) (= s ‐‐‐‐‐‐ s) [LF] [NUL]

[ESC] PV (, P

Range

a = character string number. Must be two digits.

00 to 99

b = the X coordinate of the print origin of the character string. Must be four digits. Specified

in 0.1 mm (0.0039 in.) increments.

0100 to 1057

c = the Y coordinate of the print origin of the character string. Must be four or five digits.

Specified in 0.1 mm (0.0039 in.) increments.

4 digits = 0100 to 9999 5 digits = 00100 to 09999

d = the character width. Specified in 0.1 mm (0.0039 in.) increments. Must be four digits.

0020 to 0850

e = the character height. Specified in 0.1 mm (0.0039 in.) increments. Must be four digits.

0020 to 0850

f = the type of font (See Table 6, Supported Outline Fonts on page 189 for examples.)

gh = fine adjustment of character-to-character space (Can be omitted, in which case space is

adjusted according to the designated font.)

i = rotational angle of characters and character strings

a; b, c, d, e, f (, gh), i, j (, Mk) (, Lm) (, Zn)

o) (, Qq, Rr) (; t1, t2, t3, ------ , t20) [LF] [NUL]

A = TEC FONT1 (Helvetica [bold]) B = TEC FONT1 (Helvetica [bold], proportional) E = Price font 1 F = Price font 2 G = Price font 3 K = Reserved C, D, H, I, J: = Reserved (If one of these is specified, it is processed as B.)

g = increases or decreases the character-to-character space.

+ = Increase the space – = Decrease the space

h = number of dots between characters. Must be three digits.

000 to 512 dots

00 0° 11 90° 22 180° 33 270°

08/28/2018 Virtual Device-T User Guide P1067299-003

Commands

Drawing Format Commands

j = character attributes

B = black characters W (xy) = reverse characters* **

x = number of dots horizontally from the character string to the end of the black

background

01 to 99

y = number of dots vertically from the character string to the end of the black

background

01 to 99

F (xy) = boxed characters*

x = number of dots horizontally from the character string to the surrounding box

01 to 99

y = number of dots vertically from the character string to the surrounding box

01 to 99

C (x) = strike-through characters*

x = number of dots horizontally from the character string to the end of the strike-

through line

01 to 99

* Specifications in parentheses can be omitted, in which case the value used is the character size (character height or width, whichever is larger) ÷ 8 dots.

** If the print ratio of a line (the printhead width) is too high, printing may become poor, or the printer may reset. When you specify to print reversed characters, be aware of the print ratio being used.

Mk = attach the specified check digit* (Can be omitted, in which case no check digit is drawn.

If any data other than numerals are included for the fonts listed below, no drawing is performed.)

k = the type of check digit*

numerals.

* The check digit cannot be specified if the font type is U, V, r, s, or w. If it is specified, the printer ignores it.

** DBP Modulus 10 is Modulus 10 for Deutsche Bundespost Postdienst only.

lm = increment and decrement (Can be omitted, in which case no increment/decrement is

performed.)

l = specifies whether to increment or decrement

+ = Increment – = Decrement

m = skip value. Must be ten digits.

0000000000 to 9999999999

Zn = zero suppression (Can be omitted, in which case zero suppression is not performed.)

= number of digits after zero suppression. Must be two digits.

00 to 20

P1067299-003 Virtual Device-T User Guide 08/28/2018

Commands

Drawing Format Commands

Po = alignment (Can be omitted, in which case left alignment is used.)

o = specifies the character position

1 = left 2 = center 3 = right 4a = justified*

a = character string in the X direction (in 0.1 mm units)

0050 to 1040

Qq = character string width (in 0.1 mm units) (Can be omitted, in which case 0000 is used.)

q = specifies the character width. Must be four digits.

0000 to 1600

Rr = the number of digits in the character string (Can be omitted, in which case 00 is used.

)

r = specifies the number of digits. Must be two digits.

00 to 99

s = a data string to be printed (Can be omitted.)

255 digits maximum

t1, t2, t3, ..., t20 = up to 20 link field numbers, separated by commas (Can be omitted.)

01 to 99 or 1 to 99

Notes This command specifies where and how an outline font is to be printed on a

label. When drawing using the Data Command ([ESC] RC on page 140), the format specified by the character string number is used.

The Bitmap Font Format Command ( [ESC] PC on page 58) may be connected to the Outline Font Format Command ([ESC] PV on page 71) when transmitted.

[ESC] P C001; 0100, 0150, 1, 1, A, 00, B [LF]

C002; 0350, 0180, 1, 1, A, 00, B [LF] C005; 0200, 0300, 25, 2, C, +05, 00, B,

+0000000001 [LF]

V01; 0500, 0400, 0100, 0100, A, 00, B [LF] [NUL]

You can program drawing data by designating a number of digits after the = symbol. Up to 255 digits of characters can be printed. If the number of characters exceeds the maximum number of digits, the excess data will be discarded. For the character codes, refer to Character Code Tables on page 194.

A print data string and link field number cannot be programmed at the same time.

When a reserved font type is designated, a bitmap font format is not specified.

08/28/2018 Virtual Device-T User Guide P1067299-003

Commands

Drawing Format Commands

The outline font does not print properly in the following situations:

• When characters overlap because of fine adjustments to the character-to- character space. Use fine adjustment values that do not cause the characters to overlap.

• When items such as lines or characters are positioned over the outline font area. For font types A, B, and K, set the fine adjustment value so that other items do not overlap the area in which the outline font is to be drawn. For font types E, F, and G, set the fine adjustment value so that other items do not overlap the area designated by the character width and height.

The check digit attachment, increment/decrement, and zero suppression are prioritized as follows. If any of the conditions is invalid, no drawing takes place.

increment/decrement > zero suppression > attachment of check digit

P1067299-003 Virtual Device-T User Guide 08/28/2018

Commands

Drawing Format Commands

Example 1 • The print origin of coordinates must be set so that the character drawing result is within the print area set by [ESC] D on page 41.

Example 2 •

Examples of character width and character height, based on text

orientation

Example 3 • How alignment affects text placement

If characters are not all on one line when justification and automatic line feed are specified, the printer calculates the width automatically. If the width is less than the 2mm minimum for the outline font, the printer does not draw that field.

08/28/2018 Virtual Device-T User Guide P1067299-003

Commands

Drawing Format Commands

Example 4 •

Example of

fine adjustment of character-to-character space

spacing/proportional spacing. If alignment is set to justify, the character-to-character spacing is ignored. The amount that horizontal spacing/proportional spacing is changed depends on the character size.

Example 5 • Example of rotational angles

Example 6 • Example of character attributes

P1067299-003 Virtual Device-T User Guide 08/28/2018

Commands

Drawing Format Commands

Example 7 • The printer prints while data is incremented or decremented each time that a label format is sent. If a data row exceeds 40 digits, the row is not drawn.

(? indicates a space but does not print.)

?000 0000 999999 ?010 0010 ???000 ?020 0020 ???001 ?030 0030 ???002 ?040 0040 ???003

Example 8 • Handling of letters and numerals for incrementing/decrementing

Example 9 •

If a data row exceeds 40 digits, the data row is

not drawn.

Number of digits after zero suppression

0122345

data 0000 0000 0000 0A12 0123 0123 0123 print result 0000

(? indicates a space but does not print.)

???0 ??00 ?A12 ?123 0123 0123

08/28/2018 Virtual Device-T User Guide P1067299-003

Commands

Drawing Format Commands

Example 10 • Programming link field numbers

A link field number can be designated after a semicolon (;) in a Format command. After the link field number is designated, the data strings are linked by a Link Field Data command to draw an image.

Up to 20 fields can be linked. An error occurs if the number of link fields exceeds 20.

The following example shows linked fields on two continuous labels.

P1067299-003 Virtual Device-T User Guide 08/28/2018

Commands

0001

AB-0100

0002

AB-0102

0003

AB-0104

00000

Drawing Format Commands

Example 11 • The printer can draw up to 32 fields for which increment/decrement has been designated. If the total number of bitmap font, outline font, and barcode increment/decrement fields is greater than 32, drawing takes place without incrementing/decrementing more than the first 32 fields. The fields are incremented or decremented as specified until the Image Buffer Clear command ([ESC] C

on page 50) is transmitted.

This sample shows how you would send commands to increment/decrement different fields on labels:

1. Command: Format (incrementing character string number 001 (+1))

2. Command: Format (non-incrementing character string number 002)

3. Command: Format (incrementing character string number 003 (+2))

4. Command: Image Buffer Clear

5. Command: Data (character string number 001 “0001”)

6. Command: Data (character string number 002 “AB-”)

7. Command: Data (character string number 003 “0100”)

8. Command:

9. Command:

10. Command: Image Buffer Clear

11. Command: Data (character string number 02 “00000”)

12. Command:

Issue (2 labels)

Issue (1 label)

08/28/2018 Virtual Device-T User Guide P1067299-003

Commands

Drawing Format Commands

Example 12 • The following sample code would result in a label as shown.

[ESC] C [LF] [NUL]

[ESC] PV00; 0200, 0300, 0080, 0080, B, 00, B=ABCD [LF] [NUL]

[ESC] PV01; 0200, 0125, 0100, 0100, B, 00, B [LF] [NUL]

[ESC] PV02; 0650, 0550, 0200, 0150, B, 33, B, +0000000001 [LF] [NUL]

[ESC] RV01; Sample [LF] [NUL]

[ESC] RV02; 001 [LF] [NUL]

[ESC] XS; I, 0002, 0002C4000 [LF] [NUL]

P1067299-003 Virtual Device-T User Guide 08/28/2018

Commands

Drawing Format Commands

Example 13 • The following sample code would result in a label as shown.

[ESC] C [LF] [NUL]

[ESC] PC001; 0200, 0300, 1, 1, C, 00, B; 01, 02 [LF] [NUL]

[ESC] PV01; 0650, 0550, 0200, 0150, B, 33, B; 02 [LF] [NUL]

[ESC] XB01; 0200, 0550, 3, 1, 03, 03, 08, 08, 03, 0, 0150; 01, 02 [LF] [NUL]

[ESC] RV; S [LF] 001 [LF] [NUL]

[ESC] XS; I, 0002, 0002C4000 [LF] [NUL]

08/28/2018 Virtual Device-T User Guide P1067299-003

Commands

Drawing Format Commands

[ESC] XB

[ESC] XB — WPC, CODE93, CODE128, UCC/EAN128, EAN128, POSTNET

Description Specify a Barcode or Two-Dimensional Code Format

(WPC is the generic name for JAN, EAN, and UPC barcodes.)

Syntax

This command has two possible formats:

[ESC] XBa; b, c, d, e, f, k, l (, mn, o, p, q) (= s ‐‐‐‐‐‐ s) [LF] [NUL]

[ESC] XB

t1, t2, t3, ------, t20) [LF] [NUL]

(;

Range

a = the barcode number. Must be two digits.

00 to 31

b = the X coordinate of the print origin of the barcode. Must be four digits. Specified in

0.1 mm (0.0039 in.) increments.

0100 to 1057

Fixed at 4 digits (in 0.1 mm units)

c = the Y coordinate of the print origin of the barcode. Must be four or five digits. Specified

in 0.1 mm (0.0039 in.) increments.

4 digits = 0100 to 9999 5 digits = 00100 to 09999

d = the type of barcode (See Table 7, Supported Barcode Fonts and Two-Dimensional Codes

on page 190 for examples.)

a; b, c, d, e, f, k, l (, mn, o, p, q)

Barcode Description

JAN8, EAN8 JAN13, EAN13 UPC-E EAN-13 + 2digits EAN-13 + 5digits CODE128 (with auto code selection) CODE128 (without auto code selection) CODE93 UPC-E + 2 digits UPC-E + 5 digits EAN-8 + 2 digits EAN-8 + 5 digits UPC-A UPC-A + 2 digits UPC-A + 5 digits UCC/EAN128 POSTNET (Postal code for U.S.A.)

P1067299-003 Virtual Device-T User Guide 08/28/2018

e = the type of check digit

1 = continue without attaching check digit 2 = perform check digit check

WPC Modulus 10 CODE93 Modulus 47 CODE128 PSEUDO 103

3 = check digit auto attachment 1*

WPC Modulus 10 CODE93 Modulus 47 CODE128 PSEUDO 103 UCC/EAN128 or EAN128 PSEUDO 103 POSTNET Special check digit

4 = check digit auto attachment 2

WPC Modulus 10 + Price C/D 4 digits

5 = check digit auto attachment 3

WPC Modulus 10 + Price C/D 5 digits

* For the POSTNET barcode, only option 3 is available.

f = 1-module width (in dots). Must be two digits.

01 to 15

k = rotational angle of barcodes

Commands

Drawing Format Commands

0 0° 1 90° 2 180° 3 270°

l = the barcode height. Specified in 0.1 mm (0.0039 in.) increments.

0000 to 1000

For the POSTNET barcode, this parameter sets the height of the long bar.

mn = increment and decrement* (Can be omitted, in which case no increment/decrement is

performed.)

m = specifies whether to increment or decrement

+ = Increment – = Decrement

n = skip value. Must be ten digits.

0000000000 to 9999999999

* Cannot be set when the POSTNET barcode is specified.

o =Reserved. Any value specified is ignored.

p = specify whether to print numerals under barcodes* (Can be omitted, in which case no

numerals are printed.)

0 = do not print the numerals 1 = print the numerals

* Cannot be set when the POSTNET barcode is specified.

q = zero suppression* (Can be omitted, in which case zero suppression is not performed.)

q = number of digits after zero suppression. Must be two digits.

00 to 20

* Cannot be set when the POSTNET barcode is specified.

08/28/2018 Virtual Device-T User Guide P1067299-003

Commands

Drawing Format Commands

s = a data string to be printed* (Can be omitted.)

126 digits maximum

* The actual number of digits that you can use varies according to the barcode type.

t1, t2, t3, ..., t20 = up to 20 link field numbers, separated by commas (Can be omitted.)

01 to 99 or 1 to 99

Notes This command specifies where and how a specific barcode is to be printed. When drawing using the Data Command ([ESC] RB on page 146), the format specified by the barcode number is used.

This command and its parameters allow you to do the following:

• You can specify whether numerals are printed under barcode bars. How numerals print under the bars varies according to the barcode type, but the font used is always OCR-B. These numerals may be enlarged or reduced horizontally based on the barcode width. If the numerals are drawn vertically, they are not enlarged or reduced. See Table 7, Supported Barcode Fonts and Two-Dimensional Codes

on page 190 for samples of barcodes with numerals under the bars.

• You can transmit more than one Barcode Format ([ESC] XB) command at a time:

[ESC] XB01; 0100, 0150, 3, 1, 02, 02, 06, 06, 02, 0, 0150 [LF]

B02; 0350, 0150, 3, 1, 02, 02, 06, 06, 02, 0, 0150

[LF] [NUL]

• You can program drawing data by designating a number of digits after the = symbol. The barcode number determines the number of digits of digits that can be printed. If the number of characters exceeds the maximum number of digits, the excess data will be discarded.

In situations where the drawing data changes for each label during printing, the printer automatically clears the data from the previous label and then prints the next instance of drawing data.

Because the drawing data field is not cleared between the Clear command ([ESC] C

on page 50) and Issue command ([ESC] XS on page 155), fixed data may be drawn

using the same barcode number that was used for the last drawing. Because of this, the Format command and Data command should be sent alternately.

You can clear the link field designation by omitting the link field designation while using the same barcode number and reformatting data. You can also use the Clear command ([ESC] C on page 50). A print data string and a link field number cannot be programmed at the same time.

The check digit attachment, increment/decrement, and zero suppression are prioritized as follows. If any of the conditions is invalid, no drawing takes place.

increment/decrement > zero suppression > attachment of check digit

P1067299-003 Virtual Device-T User Guide 08/28/2018

Commands

Drawing Format Commands

Check Digits

If no check digit is attached, the printer draws a barcode of the data row.

For those instances where a check digit check is performed, the check is performed according to the type of barcode. If the results are normal, the printer draws a barcode. If the results are improper, the printer does not draw a barcode.

For those instances where the check digit is attached automatically, each check digit is attached according to the type of barcode when a barcode is drawn.

With barcode types CODE93, CODE128 (with auto code selection), and UCC/EAN128 or EAN128, the check digit is always attached regardless of the designation of the type of check digit. With barcode types JAN, EAN, or UPC, the designation of no check digit attachment automatically assumes the check digit check.

Example 1 • The print origin of coordinates must be set so that the drawing result is within the print area set by [ESC] D on page 41. See Table 7, Supported Barcode

Fonts and Two-Dimensional Codes on page 190 for examples of the barcodes.

08/28/2018 Virtual Device-T User Guide P1067299-003

Commands

Drawing Format Commands

Example 2 • Bar width, space width, and character-to-character space width

The width of bars, spaces, and character-to-character spaces are designated according to the type of barcode. The correct values to use differ based on factors such as the rotational angle of the barcode, the barcode type, the number of digits, the print speed, and the media used.

With the barcodes in the following example, the width of modules 2 to 6 is calculated automatically based on what you designate for a 1-module width. With a

203-dpi

printhead, one dot = 1/8 mm.

Barcode type

1 module 2 modules 3 modules 4 modules 5 modules 6 modules

bar space bar space bar space bar space bar space bar space

JAN, EAN, UPC 36912- - CODE93 CODE128,

2468- -

UCC/EAN128, EAN128

Example 3 • Rotational angle of barcodes

Example 4 • Barcode height determination

Example 5 • The printer prints while data is incremented or decremented each time

that a label format is sent. If a data row exceeds 40 digits, the row is not drawn. If you

P1067299-003 Virtual Device-T User Guide 08/28/2018

Commands

Drawing Format Commands

use CODE128 (without auto code selection), the number of the start code (CODE A, CODE B, and CODE C) digits is regarded as 2.

(? indicates a space but does not print.)

?000 0000 999999 ?010 0010 ???000 ?020 0020 ???001 ?030 0030 ???002 ?040 0040 ???003

Example 6 • Handling of letters and numerals for incrementing/decrementing

With CODE93 and CODE128, increment/decrement is performed even if a data string other than numerals are included in the data. However, increment/decrement is not performed if code that does not exist in barcode table is contained in the data. See

Barcode/Two-Dimensional Code Tables on page 201 for more information.

08/28/2018 Virtual Device-T User Guide P1067299-003

Commands

Drawing Format Commands

Example 7 • Incrementing/decrementing of data, including the special codes of CODE128

Incrementing/decrementing calculation starts from the rightmost digit in the data strings. If the data string to be calculated is numeric and the next digit to the left is a > symbol (such as that shown underlined in the following table), these two digits are skipped, and the next digit is incremented/decremented.

Example of increment/decrement calculation of CODE128

Initial value 00000 00 > 0

80A > 080A9 > 08

INC/DEC +1 +1 +1 +1 1st label 00000 00 > 2nd label 00001 00 > 0 3rd label 00002 01 > 0 4th label 00003 01 > 0 5th label 00004 01 > 0

Example 8 •

Zero suppression works by replacing leading zeroes with spaces,

080A > 080A9 > 08

90A > 090A9 > 09

01A > 001A0 > 00

11A > 011A0 > 01

21A > 021A0 > 02

according to the specified number of digits. In instances where the number of digits after zero suppression is greater than the data row, the printer draws the data row without performing zero suppression.

If a data row exceeds 40 digits, the data row is

not drawn.

Number of digits after zero suppression

0122345

data 0000 0000 0000 0A12 0123 0123 0123 print result 0000

(? indicates a space but does not print.)

???0 ??00 ?A12 ?123 0123 0123

When you send print data that includes start/stop codes, the start/stop codes are each counted as one digit. Zero suppression is not performed when the barcode type is JAN, EAN, UPC, UCC/EAN 128, or EAN128.

P1067299-003 Virtual Device-T User Guide 08/28/2018

Commands

Drawing Format Commands

Example 9 • Programming link field numbers

A link field number can be designated after a semicolon (;) in a Format command. After the link field number is designated, the data strings are linked by a Link Field Data command to draw an image.

Up to 20 fields can be linked. An error occurs if the number of link fields exceeds 20.

The following example shows linked fields on two continuous labels.

08/28/2018 Virtual Device-T User Guide P1067299-003

Commands

Drawing Format Commands

on page 50) is transmitted.

This sample shows how you would send commands to increment/decrement different fields on labels:

1. Command: Format (incrementing barcode number 01 (+1))

2. Command: Format (incrementing barcode number 02 (+2))

3. Command: Image Buffer Clear

4. Command: Data (barcode number 01 “0001”)

5. Command: Data (barcode number 02 “0100”)

6. Command: Issue (2 labels)

7. Command:

8. Command: Image Buffer Clear

9. Command: Data (barcode number 02 “3000”)

P1067299-003 Virtual Device-T User Guide 08/28/2018

Issue (1 label)

Commands

Drawing Format Commands

10. Command:

Issue (1 label)

Example 11 • The following sample code would result in a label as shown.

[ESC] C [LF] [NUL]

[ESC] XB01; 0200, 0125, 9, 3, 02, 0, 0150, +0000000000, 010, 0, 00 = 12345 [LF] [NUL]

[ESC] XB02; 0830, 0550, 3, 1, 02, 04, 07, 08, 04, 3, 0150, +0000000000, 1, 00, N [LF] [NUL]

[ESC] RB02; *ABC* [LF] [NUL]

[ESC] XS; I, 0002, 0002C4000 [LF] [NUL]

08/28/2018 Virtual Device-T User Guide P1067299-003

Commands

Drawing Format Commands

[ESC] XB — MSI, Interleaved 2 of 5, CODE39, NW7, Industrial 2 of 5

Syntax

This command has two possible formats:

[ESC] XBa; b, c, d, e, f, g, h, i, j, k, l (, mn, p, q) (, r) (= s ------ s) [LF] [NUL]

[ESC] XBa; b, c, d, e, f, g, h, i, j, k, l (, mn, p, q) (, r) (; t1, t2, t3, ------, t20) [LF] [NUL]

Range

a = the barcode number. Must be two digits.

00 to 31

b = the X coordinate of the print origin of the barcode. Must be four digits. Specified in

0.1 mm (0.0039 in.) increments.

0100 to 1057

Fixed at 4 digits (in 0.1 mm units)

c = the Y coordinate of the print origin of the barcode. Must be four or five digits. Specified

in 0.1 mm (0.0039 in.) increments.

4 digits = 0100 to 9999 5 digits = 00100 to 09999

d = the type of barcode (See Table 7, Supported Barcode Fonts and Two-Dimensional Codes

on page 190 for examples.)

1 = MSI 2 = Interleaved 2 of 5 (ITF) 3 = CODE39 (standard) 4 = NW7 B = CODE39 (full ASCII) O: Industrial 2 of 5

e = the type of check digit

1 = continue without attaching check digit 2 = perform check digit check

CODE39 Modulus 43 MSI IBM modulus 10 ITF Modulus 10 Industrial 2 of 5 Modulus check character

3 = check digit auto attachment 1

CODE39 Modulus 43 MSI IBM modulus 10 ITF Modulus 10 Industrial 2 of 5 Modulus check character

4 = check digit auto attachment 2

MSI IBM modulus 10 + IBM modulus 10 ITF DBP Modulus 10*

5 = check digit auto attachment 3

MSI IBM modulus 11 + IBM modulus 10

* DBP Modulus 10 is Modulus 10 for Deutsche Bundespost Postdienst only.

P1067299-003 Virtual Device-T User Guide 08/28/2018

f = the narrow bar width (in dots)

01 to 99

g = the narrow space width* (in dots)

01 to 99

* For Industrial 2 of 5, designate an element-to-element space.

h = the wide bar width (in dots)

01 to 99

i = the wide space width* (in dots)

01 to 99

For Industrial 2 of 5, the value is fixed at 00.

j = the character-to-character space width* (in dots)

01 to 99

* For MSI and ITF, the character-to-character space width is fixed at 00.

k = rotational angle of barcodes

0 0° 1 90° 2 180° 3 270°

Commands

Drawing Format Commands

l = the barcode height. Specified in 0.1 mm (0.0039 in.) increments.

0000 to 1000

For the POSTNET barcode, this parameter sets the height of the long bar.

mn = increment and decrement (Can be omitted, in which case no increment/decrement is

performed.)

l = specifies whether to increment or decrement

+ = Increment – = Decrement

m = skip value. Must be ten digits.

0000000000 to 9999999999

p = specify whether to print numerals under barcodes (Can be omitted, in which case no

numerals are printed.)

0 = do not print the numerals 1 = print the numerals

q = zero suppression (Can be omitted, in which case zero suppression is not performed.)

q = number of digits after zero suppression. Must be two digits.

00 to 20

r = specify whether to attach start/stop codes* (Can be omitted, in which case the start/stop

codes are attached automatically.) For more information, see Automatic Addition of

Start/Stop Codes on page 249.

T = attach start code only P = attach stop code only N = do not attach start/stop codes

* Applies only when the barcode type is CODE39 or NW7. For CODE39, “*” is added. For NW7, “a” is added.

08/28/2018 Virtual Device-T User Guide P1067299-003

Commands

Drawing Format Commands

s = a data string to be printed* (Can be omitted.)

126 digits maximum

* The actual number of digits that you can use varies according to the barcode type.

t1, t2, t3, ..., t20 = up to 20 link field numbers, separated by commas (Can be omitted.)

01 to 99 or 1 to 99

Notes This command specifies where and how a specific barcode is to be printed. When drawing using the Data Command ([ESC] RB on page 146), the format specified by the barcode number is used.

This command and its parameters allow you to do the following:

• You can specify whether numerals are printed under barcode bars. How numerals print under the bars varies according to the barcode type, but the font used is always OCR-B. These numerals may be enlarged or reduced horizontally based on the barcode width. If the numerals are drawn vertically, they are not enlarged or reduced. See Barcode Fonts on page 190 for samples of barcodes with numerals under the bars.

• You can transmit more than one Barcode Format ([ESC] XB) command at a time:

[ESC] XB01; 0100, 0150, 3, 1, 02, 02, 06, 06, 02, 0, 0150 [LF]

B02; 0350, 0150, 3, 1, 02, 02, 06, 06, 02, 0, 0150 [LF] [NUL]

In situations where the drawing data changes for each label during printing, the printer automatically clears the data from the previous label and then prints the next instance of drawing data.

Because the drawing data field is not cleared between the Clear command ([ESC] C

on page 50) and Issue command ([ESC] XS on page 155), fixed data may be drawn

using the same barcode number that was used for the last drawing. Because of this, the Format command and Data command should be sent alternately. (After you send the Issue command, the fields with the same barcode number are automatically cleared until you send the Clear command.)

The check digit attachment, increment/decrement, and zero suppression are prioritized as follows. If any of the conditions is invalid, no drawing takes place.

increment/decrement > zero suppression > attachment of check digit

P1067299-003 Virtual Device-T User Guide 08/28/2018

Commands

Drawing Format Commands

Type of Check Digit

If no check digit is attached, the printer draws a barcode of the data row.

For those instances where the check digit is attached automatically, each check digit is attached according to the type of barcode when a barcode is drawn.

Example 1 • The print origin of coordinates must be set so that the drawing result is within the print area set by [ESC] D on page 41. See Table 7, Supported Barcode

Fonts and Two-Dimensional Codes on page 190 for examples of the barcodes.

08/28/2018 Virtual Device-T User Guide P1067299-003

Commands

Drawing Format Commands

Example 2 • Bar width, space width, and character-to-character space width

With a 203-dpi printhead, one dot = 1/8 mm.

Barcode type

narrow wide

bar space bar space

character-to-

character

space

MSI 2266 0 ITF 2266 0 CODE39 2266 2 NW7 2266 2 Industrial 2 of 5 2260 2

With NW7, when the space character is transmitted, the printer assumes that a space equals the width of a narrow space x 12 dots. The maximum width is 255 dots.

Example 3 • Rotational angle of barcodes

Example 4 • Barcode height determination

P1067299-003 Virtual Device-T User Guide 08/28/2018

Commands

Drawing Format Commands

Example 5 • The printer prints while data is incremented or decremented each time that a label format is sent. If a data row exceeds 40 digits, the row is not drawn.

(? indicates a space but does not print.)

?000 0000 999999 ?010 0010 ???000 ?020 0020 ???001 ?030 0030 ???002 ?040 0040 ???003

Example 6 • Handling of letters and numerals for incrementing/decrementing

For CODE39 (standard), CODE39 (full ASCII), and NW-7, even if a data string other than numerals are included in the data, increment/decrement is performed. However, if any code which does not exist in each barcode table is contained in the data, increment/decrement is not performed. See Barcode/Two-Dimensional Code

Tables on page 201 for more information.

Example 7 •

If a data row exceeds 40 digits, the data row is

not drawn.

Number of digits after zero suppression

0122345

data 0000 0000 0000 0A12 0123 0123 0123 print result 0000

(? indicates a space but does not print.)

???0 ??00 ?A12 ?123 0123 0123

When you send print data that includes start/stop codes, the start/stop codes are each counted as one digit.

08/28/2018 Virtual Device-T User Guide P1067299-003

Commands

Drawing Format Commands

Example 8 • Programming link field numbers

A link field number can be designated after a semicolon (;) in a Format command. After the link field number is designated, the data strings are linked by a Link Field Data command to draw an image.

Up to 20 fields can be linked. An error occurs if the number of link fields exceeds 20.

The following example shows linked fields on two continuous labels.

P1067299-003 Virtual Device-T User Guide 08/28/2018

Commands

Drawing Format Commands

Example 9 • The printer can draw up to 32 fields for which increment/decrement has been designated. If the total number of bitmap font, outline font, and barcode increment/decrement fields is greater than 32, drawing takes place without incrementing/decrementing more than the first 32 fields. The fields are incremented or decremented as specified until the Image Buffer Clear command ([ESC] C

on page 50) is transmitted.

This sample shows how you would send commands to increment/decrement different fields on labels:

1. Command: Format (incrementing barcode number 01 (+1))

2. Command: Format (incrementing barcode number 02 (+2))

3. Command: Image Buffer Clear

4. Command: Data (barcode number 01 “0001”)

5. Command: Data (barcode number 02 “0100”)

6. Command: Issue (2 labels)

7. Command:

8. Command: Image Buffer Clear

9. Command: Data (barcode number 02 “3000”)

08/28/2018 Virtual Device-T User Guide P1067299-003

Issue (1 label)

100

Commands

Drawing Format Commands

10. Command:

Issue (1 label)

Example 10 • The following sample code would result in a label as shown.

[ESC] C [LF] [NUL]

[ESC] XB01; 0200, 0125, 3, 1, 02, 02, 06, 06, 02, 0, 0150 = 12345 [LF] [NUL]

[ESC] XB02; 0830, 0550, 3, 1, 02, 04, 07, 08, 04, 3, 0150, +0000000000, 1, 00, N [LF] [NUL]

[ESC] RB02; *ABC* [LF] [NUL]

[ESC] XS; I, 0002, 0002C4000 [LF] [NUL]

P1067299-003 Virtual Device-T User Guide 08/28/2018

Zebra Virtual Device-T Virtual Device User Guide-T (EN)

Specifications and Main Features

Frequently Asked Questions

User Manual

Contents

Introduction

Overview

Virtual Device-T Features

Supported Printers

Configuring Network Connectivity

Notes

Acquiring the Virtual Device Application

Downloading the Virtual Device-T Application

Adding Printers to the ZDownloader List

Modifying Printers in the List

Deleting Printers from the List

Downloading the Virtual Device App to Selected Printers

Canceling a Download in Progress

Registering the Virtual Device

ZDownloader Log File

Enabling the Virtual Device

Using an SGD Command

Using the User Menus

Commands

Interface Command Format

Command Format

TPCL Mode Supported Commands

Setting Commands

[ESC] D

[ESC] ID

[ESC] M

Fine Adjustment Commands

[ESC] AX

[ESC] AY

[ESC] AH

Clear Commands

[ESC] C

[ESC] XR

Drawing Format Commands

[ESC] LC

[ESC] PC

[ESC] PV

[ESC] XB