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

Download

Page 1

Virtual Device-E

User Guide

P1067298-003

Page 2

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: P1067298-003 Rev. A

Page 3

Contents

2 • Contents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

1 • Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

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

Virtual Device-E Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

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

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

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

2 • Install, Register, and Enable Virtual Device-E . . . . . . . . . . . . . . . . . . . . . . . 11

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

Downloading the Virtual Device-E 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

3 • Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36

Supported Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

Command Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

08/28/2018 Virtual Device-E User Guide P1067298-003

Page 4

Contents

Virtual Device-E Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

EOT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

HT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43

LF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43

FF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

CAN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

ESC FF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

ESC SP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

ESC ! . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

ESC $ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46

ESC % . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

ESC & . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

ESC * . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48

ESC - . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

ESC 2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

ESC 3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50

ESC @ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50

ESC D . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51

ESC E . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51

ESC G . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52

ESC J . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52

ESC L . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53

ESC M . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

ESC R . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55

ESC S . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56

ESC T . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57

ESC W . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58

ESC \ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59

ESC a . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60

ESC d . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60

ESC t . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61

ESC { . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62

FS p . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63

FS q . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64

GS ! . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66

GS $ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67

GS ( A . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68

GS ( F . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69

<Function 2> (m = 2) 69—GS ( F pL pH m a nL nH 69

<Function 112> (m = 112) 70—GS ( F pL pH m aL aH bL bH 70

GS ( k . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71

<Function 065> (fn = 65) 74—GS ( k pL pH cn fn n 74

P1067298-003 Virtual Device-E User Guide 08/28/2018

Page 5

<Function 066> (fn = 66) 75—GS ( k pL pH cn fn n 75

<Function 067> (fn = 67) 76—GS ( k pL pH cn fn n 76

<Function 068> (fn = 68) 76—GS ( k pL pH cn fn n 76

<Function 069> (fn = 69) 77—GS ( k pL pH cn fn m n 77

<Function 070> (fn = 70) 78—GS ( k pL pH cn fn m 78

<Function 080> (fn = 80) 79—GS ( k pL pH cn fn m d1...dk 79

<Function 081> (fn = 81) 80—GS ( k pL pH cn fn m 80

<Function 082> (fn = 82) 82—GS ( k pL pH cn fn m 82

<Function 165> (fn = 65) 83—GS ( k pL pH cn fn n1 n2 83

<Function 167> (fn = 67) 84—GS ( k pL pH cn n 84

<Function 169> (fn = 69) 85—GS ( k pL pH cn n 85

<Function 180> (fn = 80) 86—GS ( k pL pH cn fn m d1...dk 86

<Function 181> (fn = 81) 87—GS ( k pL pH cn fn m 87

<Function 182> (fn = 82) 89—GS ( k pL pH cn fn m 89

<Function 265> (fn = 65) 90—GS ( k pL pH cn fn n1 n2 90

Contents

<Function 280> (fn = 80) 91—GS ( k pL pH cn fn m d1...dk 91

<Function 281> (fn = 81) 92—GS ( k pL pH cn fn m 92

<Function 367> (fn = 67) 94—GS ( k pL pH cn n 94

<Function 380> (fn = 80) 95—GS ( k pL pH cn fn m d1...dk 95

<Function 381> (fn = 81) 96—GS ( k pL pH cn fn m 96

GS ( E . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97

<Function 1> (fn = 1) 98—GS ( E pL pH fn d1 d2 98

<Function 2> (fn = 2) 99—GS ( E pL pH fn d1 d2 d3 99

<Function 3> (fn = 3) 100—GS ( E pL pH fn [a1 b18...b11]...[ak bk8...bk1]

100

<Function 4> (fn = 4) 103—GS ( E pL pH fn a 103

<Function 11> (fn = 11) 104—GS ( E pL pH fn a d1…dk 104

<Function 12> (fn = 12) 106—GS ( E pL pH fn a 106

GS ( L, GS 8 L . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108

<Function 48> (fn = 0, 48) 108—GS ( L pL pH m fn 108

<Function 50> (fn = 2, 50) 109—GS ^ L pL pH fn 109

<Function 51> (fn = 3, 51) 110—GS ( L pL pH m fn 110

<Function 64> (fn = 64) 111—GS ( L pL pH m fn d1 d2 111

<Function 65> (fn = 65) 111—GS ( L pL pH m fn d1 d2 d3 111

<Function 66> (fn = 66) 112—GS ( L pL pH m fn kc1 kc2 112

<Function 67> (fn = 67) 113—GS ( L pL pH m fn a kc1 kc2 b xL xH yL yH

[c d1...dk]1...[c d1...dk]b 113

<Function 69> (fn = 69) 114—GS ( L pL pH m fn kc1 kc2 x y 114

08/28/2018 Virtual Device-E User Guide P1067298-003

Page 6

Contents

<Function 112> (fn = 112) 115—GS ( L pL pH m fn a bx by c xL xH yL yH d1...dk

115

GS : . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116

GS B . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116

GS H . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117

GS I . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118

GS I b . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119

GS L . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120

GS T . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121

GS W . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122

GS \ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123

GS ^ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124

GS a . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125

GS f . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127

GS h . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127

GS k . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128

GS r . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130

GS v 0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131

GS w . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132

BS L A . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133

BS L L . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133

BS L R . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134

BS M . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134

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

apl.enable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135

apl.version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135

apl.framework_version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136

4 • Supported Fonts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137

Supported Fonts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138

5 • ZDownloader Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140

Downloading the ZDownloader Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141

Installing the ZDownloader Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142

1 • Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145

P1067298-003 Virtual Device-E User Guide 08/28/2018

Page 7

Introduction

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

Contents

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

Virtual Device-E Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

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

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

08/28/2018 Virtual Device-E User Guide P1067298-003

Page 8

Introduction

Overview

The Virtual Device-E application enables Zebra Link-OS printers to work with many host systems that are using BIXOLON 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-E Features

The Virtual Device-E 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 on page 137).

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

printers. In most cases, no changes will be

, Serial, Ethernet, WLAN, and USB interfaces.

P1067298-003 Virtual Device-E User Guide 08/28/2018

Page 9

Supported Printers

This manual describes the Virtual Device-E 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-E 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-E User Guide P1067298-003

Page 10

Introduction

Notes

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

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

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

P1067298-003 Virtual Device-E User Guide 08/28/2018

Page 11

Install, Register, and

Enable Virtual Device-E

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

Contents

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

Downloading the Virtual Device-E 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-E User Guide P1067298-003

Page 12

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.

P1067298-003 Virtual Device-E User Guide 08/28/2018

Page 13

Downloading the Virtual Device-E Application

Zebra provides two options to download the Virtual Device-E 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 140.

• 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-E 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-E User Guide P1067298-003

Page 14

Getting Started

Downloading the Virtual Device-E 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).

P1067298-003 Virtual Device-E User Guide 08/28/2018

Page 15

Getting Started

Downloading the Virtual Device-E 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.

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….

Right-click in the ZDownloader window and select Add Printer….

The following window appears.

08/28/2018 Virtual Device-E User Guide P1067298-003

Page 16

Getting Started

Downloading the Virtual Device-E 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.

P1067298-003 Virtual Device-E User Guide 08/28/2018

Page 17

5. Click Port Settings.

The following window appears.

Getting Started

Downloading the Virtual Device-E 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-E User Guide P1067298-003

Page 18

Getting Started

Downloading the Virtual Device-E 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.

P1067298-003 Virtual Device-E User Guide 08/28/2018

Page 19

Adding a Network Printer

12. Set Communication Type to Network.

The following window appears.

Getting Started

Downloading the Virtual Device-E 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-E User Guide P1067298-003

Page 20

Getting Started

Downloading the Virtual Device-E Application

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

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.

P1067298-003 Virtual Device-E User Guide 08/28/2018

Page 21

Downloading the Virtual Device-E Application

2. In the toolbar, select Printer > Delete.

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-E 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-E User Guide P1067298-003

Page 22

Getting Started

Downloading the Virtual Device-E 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-E 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….

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.

P1067298-003 Virtual Device-E User Guide 08/28/2018

Page 23

Getting Started

Downloading the Virtual Device-E 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.

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.

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.

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

08/28/2018 Virtual Device-E User Guide P1067298-003

Page 24

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.

P1067298-003 Virtual Device-E User Guide 08/28/2018

Page 25

Enabling the Virtual Device

You can enable Virtual Device-E 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-E on your printer, send the following command:

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

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 135.

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-E User Guide P1067298-003

Page 26

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.

P1067298-003 Virtual Device-E User Guide 08/28/2018

Page 27

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-E User Guide P1067298-003

Page 28

Getting Started

VIRTUAL DEVICE

▼ APL-E ▲

USE

Enabling the Virtual Device

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

6. Press the RIGHT SOFT KEY to select USE.

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

P1067298-003 Virtual Device-E User Guide 08/28/2018

Page 29

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-E User Guide P1067298-003

Page 30

Getting Started

Virtual Dev: none ▲▼

Menu Use Back

Virtual Dev: apl‐e ▲? ▼

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-E

option.

P1067298-003 Virtual Device-E User Guide 08/28/2018

Page 31

6. Press the LEFT ARROW to highlight APL-E

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-E User Guide P1067298-003

Page 32

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.

P1067298-003 Virtual Device-E User Guide 08/28/2018

Page 33

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-E User Guide P1067298-003

Page 34

Getting Started

▼

VIRTUAL DEVICE

NONE

▲

▼

VIRTUAL DEVICE

APL-E

▲

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-E option.

P1067298-003 Virtual Device-E User Guide 08/28/2018

Page 35

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

▼

VIRTUAL DEVICE

APL-E

▲

USE

Getting Started

Enabling the Virtual Device

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

08/28/2018 Virtual Device-E User Guide P1067298-003

Page 36

Commands

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

Contents

Supported Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

Command Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

Virtual Device-E Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

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

08/28/2018 Virtual Device-E User Guide P1067298-003

Page 37

Supported Commands

Command Function

EOT on page 41 Transmit status

HT on page 43 Horizontal tab

LF on page 43 Print and line feed

FF on page 44 Form feed (in Page mode)

CR Print and carriage return

DLE Set real-time command mode

CAN on page 44 Cancel the print data (in Page mode)

ESC FF on page 44 Print data (in Page mode)

ESC SP on page 45 Set the character right space

ESC ! on page 45 Set print mode

Commands

Supported Commands

This command has no effect. Use LF on page 43.

Consumed, but not processed.

ESC $ on page 46 Set absolute print position

ESC % on page 47 * Enable/disable a user-defined character set

ESC & on page 47 * Define user-defined characters

ESC ? * Cancel the user-defined character

Consumed but not processed.

ESC $ * Delete user-defined characters.

Consumed but not processed.

ESC * on page 48 Specify bit image mode

ESC - on page 49 Turn underline mode on/off

ESC 2 on page 49 Select default line spacing

ESC 3 on page 50 Set line spacing

ESC = Select peripheral device

Consumed but not processed.

ESC @ on page 50 Initialize printer

ESC D on page 51 Set horizontal tab positions

ESC E on page 51 Turn emphasized mode on/off

ESC G on page 52 Turn double-strike mode on/off

ESC J on page 52 Print and feed paper

ESC L on page 53 Select Page mode

ESC M on page 54 Select character font

ESC R on page 55 Specify an international character set

* Support for this command was added after the initial release. To use the command, download

the latest version of the latest version of the app.

08/28/2018 Virtual Device-E User Guide P1067298-003

Page 38

Commands

Supported Commands

Command Function

ESC S on page 56 Select Standard mode

ESC T on page 57 Select print direction (in Page mode)

ESC W on page 58 Set print area (in Page mode)

ESC \ on page 59 Set relative print position

ESC a on page 60 Set position alignment

ESC d on page 60 Print and feed a specified number of lines

ESC t on page 61 Select character code table

ESC { on page 62 Select upside-down printing mode

FS p on page 63 Print the download nonvolatile bit images

FS q on page 64 Define the download nonvolatile bit image

GS ! on page 66 Select character size

GS $ on page 67

Set absolute vertical print position

(in Page mode)

GS ( A on page 68 Execute test print

GS ( F on page 69 Set black mark control functions

GS ( k on page 71 Specify and print the symbol

GS ( E on page 97 Set nonvolatile user memory area

GS ( L, GS 8 L on page 108 Select graphics data

GS : on page 116 Start/end macro definition

GS B on page 116 Turn reverse printing mode on/off

GS H on page 117 Select print position of HRI characters

GS I on page 118 Transmit printer ID

GS I b on page 119 Transmit battery status

GS L on page 120 Set left margin

GS T on page 121 Set print position to the beginning of print line

GS W on page 122 Set print area width

GS \ on page 123 Set relative vertical print position (in Page mode)

GS ^ on page 124 Execute macro

GS a Enable/disable Automatic Status Back (ASB)

Consumed, but not processed.

GS f on page 127 Select font for HRI characters

GS h on page 127 Specify barcode height

GS k on page 128 Print barcode

GS r on page 130 Transmit status

GS v 0 on page 131 Print raster bit image

GS w on page 132 Set barcode width

BS L A on page 133 Execute automatic calibration in Label mode

P1067298-003 Virtual Device-E User Guide 08/28/2018

Page 39

Command Function

BS L L on page 133 Select Label mode

BS L R on page 134 Select Receipt mode

BS M on page 134 Specify font type

BS M S Define Sentinel characters.

Consumed but not processed.

Commands

Supported Commands

08/28/2018 Virtual Device-E User Guide P1067298-003

Page 40

Commands

Command Format

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

Command

Description Command Function

Syntax Command format in ASCII followed by Hexadecimal and decimal equivalents

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

EOTn

ASCII

Hex

Decimal

Range The values that can be used for n

Default Initial value of n (if any)

Notes In-depth description of the command function

Differences Variations of the command, status, or results (if any)

EOT n

04 n

4 n

P1067298-003 Virtual Device-E User Guide 08/28/2018

Page 41

Virtual Device-E Commands

EOT

Description Transmit Status

Commands

Virtual Device-E Commands

Syntax

Range 1 to 4

Default none

Notes Upon request, the printer status is transmitted to the host, which can check the printer

operating conditions and take appropriate measures.

Based on the value of n, the printer transmits the following status information.

n = 1: Transmit printer status

EOTn

ASCII EOT n

Hex 04 n

Decimal 4 n

Bit Binary Hex Decimal Status

00000Not used. Fixed to Off

11022Not used. Fixed to On

20000Not used. Fixed to Off

1044Not used. Fixed to Off

30000Not used. Fixed to Off

1088Not used. Fixed to Off

4 1 10 16 Not used. Fixed to On

50000Not used. Fixed to Off

60000Not used. Fixed to Off

70000Not used. Fixed to Off

08/28/2018 Virtual Device-E User Guide P1067298-003

Page 42

Commands

Virtual Device-E Commands

n = 2: Transmit offline status

Bit Off/On Hex Decimal

Status

0Off000Not used. Fixed to Off

1On02 2Fixed to On

2Off000Cover is closed

On 04 4 Cover is open

3Off000Not used. Fixed to Off

On 08 8 Not used. Fixed to Off

4On1016Fixed to On

5Off00 0Paper is loaded in the printer.

On 20 32 The printer is out of paper. (Media

out)

6Off000Not used. Fixed to Off

On 40 64 Not used. Fixed to Off

7Off000Not used. Fixed to Off

n = 3: Transmit error status

Bit Binary Hex Decimal

Status

00000Not used. Fixed to Off

11022Not used. Fixed to On

20000Not used. Fixed to Off

1044Not used. Fixed to Off

30000Not used. Fixed to Off

1088Not used. Fixed to Off

4 1 10 16 Not used. Fixed to On

50000Not used. Fixed to Off

12032Not used. Fixed to Off

60000Not used. Fixed to Off

14064Not used. Fixed to Off

70000Not used. Fixed to Off

P1067298-003 Virtual Device-E User Guide 08/28/2018

Page 43

n = 4: Transmit paper sensor status

Commands

Virtual Device-E Commands

Bit Binary Hex Decimal

00000Not used. Fixed to Off

11022Not used. Fixed to On

2,3 00 00 0 Not used. Fixed to Off

11 0C 12 Not used. Fixed to Off

4 1 10 16 Not used. Fixed to On

5,6 00 00 0 Paper end sensor: paper present

11 60 96 Paper end sensor: paper not present

70000Not used. Fixed to Off

Description Horizontal Tab

Syntax

ASCII HT Hex 09 Decimal 9

Status

Notes This command moves the print position to the next horizontal tab position. If a

horizontal tab position was not set using ESC D on page 51, the printer ignores this command.

When in underline mode, the printer does not underline the space created by this command.

Description Print and Line Feed

Syntax

Notes In Standard mode, this command prints the data in the print buffer and feeds

one line based on the current set line spacing. In Page mode, the printer does not print, but simply moves the print position to the beginning of the next line.

ASCII LF Hex 0A Decimal 10

08/28/2018 Virtual Device-E User Guide P1067298-003

Page 44

Commands

Virtual Device-E Commands

Description Form Feed (Page mode)

Syntax

Notes This command works in Page mode, which is enabled by ESC L on page 53.

When FF is executed, the printer prints all data from the print buffer in Page mode, deletes the data, and then returns the print position to the beginning of the next line in Standard mode.

Differences After completion of printing, the printer does not clear the print buffer, and the print position moves to the beginning of the line.

ASCII FF Hex 0C Decimal 12

CAN

ESC FF

Description Cancel Print Data (Page mode)

CAN

Syntax

Notes CAN clears the print buffer.

This command works in Page mode, which is enabled by ESC L on page 53.

Description Print Data (Page mode)

Syntax

ASCII CAN Hex 18 Decimal 24

<ESC>FF

ASCII ESC FF Hex 1B 0C Decimal 27 12

Notes ESC FF prints the data in the print buffer. After printing, the data in the print buffer and the setting values are not cleared, allowing the printer to print the data in the print buffer repeatedly using this command.

This command works in Page mode, which is enabled by ESC L on page 53. To return the printer to Standard mode, use ESC S on page 56 or ESC @ on page 50.

P1067298-003 Virtual Device-E User Guide 08/28/2018

Page 45

ESC SP

Commands

Virtual Device-E Commands

Description Set the Character Right Space

<ESC>SPn

Syntax

Range n = 0 to 255

Default n = 0

Notes This command sets the amount of space to the right of a character.

In a double-width mode, the right space is doubled.

Differences Horizontal motion unit varies depending on the printhead resolution.

ASCII ESC SP n Hex 1B 20 n Decimal 27 32 n

Right space = n × [horizontal motion units].

ESC !

For a 203 dpi printer, horizontal motion unit = 0.125 mm (1/203 inch)

Description Set Print Modes

<ESC>!n

Syntax

Range n = 0 to 255

Default n = 0

Notes As alternatives to this command, the following commands can be used:

ASCII ESC ! n Hex 1B 21 n Decimal 27 33 n

• ESC M on page 54 to select character font

• ESC E on page 51 to select emphasized mode

• ESC - on page 49 to select underline mode. When in underline mode, the printer does not underline the space created by horizontal tabs.

Based on the value of n, the printer

08/28/2018 Virtual Device-E User Guide P1067298-003

selects print mode(s) as follows.

Page 46

Commands

Virtual Device-E Commands

Bit Off/On Hex Decimal

Function

0Off000Character font A selected

On 01 1 Character font B selected

1,2 Off 00 0 Reserved

3Off000Emphasized mode not selected

On 08 8 Emphasized mode selected

4Off000Double-height mode not selected

On 10 16 Double-height mode selected

5Off000Double-width mode not selected

On 20 32 Double-width mode selected

6Off000Reserved

7Off000Underline mode not selected

On 80 128 Underline mode selected

Differences Character configuration (Font A, Font B): Font A (12 × 24), Font B (9 ×

17)

ESC $

Description Set an Absolute Print Position

<ESC>$nLnH

Syntax

ASCII ESC $ nL nH Hex 1B 24 nL nH Decimal 27 36 nL nH

Range nL = 0 to 255

nH = 0 to 255

Default None

Notes This command specifies the next print starting position in reference to the left

edge of the print area. The printing start position is calculated using:

(nL + nH × 256) × (vertical or horizontal motion units)

• In Standard mode, the horizontal motion unit is used for the calculation.

• In Page mode, the horizontal motion unit is used for the calculation when the print start position is defined to the upper right or lower right of print area (using ESC T

on page 57). Otherwise, the vertical motion unit is used.

The printer ignores any setting values that would cause printing outside of the printable area.

P1067298-003 Virtual Device-E User Guide 08/28/2018

Page 47

ESC %

Commands

Virtual Device-E Commands

Differences Horizontal and vertical motion units vary depending on the printhead resolution. For a 203 dpi printer, horizontal and vertical motion units = 0.125 mm (1/203 inch).

Description Enable/disable a user-defined character set

<ESC % n

Syntax

Range n = 0 to 255

Default n = 0

ASCII ESC % n

Hex 1B 25 n

Decimal 27 37 n

Notes ESC % enables or disables a user-defined character set by assigning the

Least Significant Bit (LSB) of parameter n. When the user-defined character set is disabled, the internal character set is enabled automatically.

• When n = 0, the user-defined character set is disabled

• When n = 1, the user-defined character set is enabled

ESC &

Description Define user-defined characters

<ESC & y c1 c2 [x1 d1...d(y × x1)] ... [xk d1...d(y ×

Syntax

ASCII ESC & y c1 c2 x1 d1...d(y × x1)] ...

Hex 1B 26 y c1 c2 x1 d1...d(y × x1)] ...

Decimal 27 38 y c1 c2 x1 d1...d(y × x1)] ...

Range

xk)]

[xk d1...d(y × xk)

y =

3 Font A (12x24)

2 Font B (8x16)

32 c1c2126

08/28/2018 Virtual Device-E User Guide P1067298-003

Page 48

Commands

Virtual Device-E Commands

x =

12 Font A (12x24)

8 Font B (8x16)

d1...d (y × xk) = 0 to 255

k = c2 – c1 + 1

Parameter y defines the number of bytes in the vertical direction while parameter x specifies the number of horizontal dots for the font of the user-defined character.

Parameters c1 and c2 specify the starting and ending code of the characters, respectively. If only one character is defined, c1 = c2.

Parameters d1, d2, ... d(y × xk) are the dot data of the metrics of user-defined characters.To print a dot, dn = 1.

y × x bytes = the total length of the data of the user-defined characters. The

maximum for Font A is 36 bytes and for Font B is 16 bytes.

Example

Notes ESC & creates user-defined characters. This command can define user-

defined characters of the same code for different fonts.

User-defined characters are cleared when the following occur:

• ESC @ is executed

• ESC ? is executed

• The printer is reset or power cycled.

ESC *

Description Specify Bit Image Mode

<ESC>*mnLnH d1...dk

Syntax

Range m = 0, 1, 32, 33

ASCII ESC * m nL nH d1...dk Hex 1B 2A m nL nH d1...dk Decimal 27 42 m nL nH d1...dk

nL = 0 to 255 nH = 0 to 3 d = 0 to 255

• d specifies the bit image data with 1 for printed data and 0 for not printed.

• k denotes the number of horizontal dots.

Default None

Notes ESC * specifies the bit image for the mode (m) as to the number of dots

specified by nL and nH.

P1067298-003 Virtual Device-E User Guide 08/28/2018

Page 49

ESC -

Commands

Virtual Device-E Commands

Description Turn Underline Mode On/Off

<ESC>-n

Syntax

Range n = 0, 1, 2, 48, 49, 50

Default n = 0

Notes This command enables the text following it to be underlined. Using bit 7 of

ESC ! on page 45 also activates/deactivates underline mode.

The underline style varies depending on the value of n:

n Function

ASCII ESC - n Hex 1B 2D n Decimal 27 45 n

ESC 2

0, 48 Turns off underline mode

1, 49 Turns on underline mode, set at 1-dot thick

2, 50 Turns on underline mode, set at 2-dot thick

When in underline mode, the printer does not underline the space created by horizontal tabs.

Description Select Default Line Spacing

<ESC>2

Syntax

Notes This command changes the default line spacing, which can be set for

Standard mode and Page mode independently of each other. The initial default line spacing is 3.75 mm (30 dots).

This command remains in effect until one of the following occurs: ESC ! on page 45 or

ESC @ on page 50 is run, the printer defaults are reset, or the printer is power cycled.

ASCII ESC 2 Hex 1B 32 Decimal 27 50

08/28/2018 Virtual Device-E User Guide P1067298-003

Page 50

Commands

Virtual Device-E Commands

ESC 3

ESC @

Description Set Line Spacing

<ESC>3n

Syntax

Range n = 0 to 255

Default 3.75 mm (30 dots) or the line spacing defined by ESC 2 on page 49

Notes Line spacing can be set for Standard mode and Page mode independently of

each other.

ASCII ESC 3 n Hex 1B 33 n Decimal 27 51 n

Description Initialize Printer

<ESC>@

Syntax

Notes This command cancels conditions previously set and resets the printer to the

conditions that existed at power on:

When the printer receives this command in Page mode, the printer removes the data in print areas, restores the initial settings, and returns to Standard mode.

ASCII ESC @ Hex 1B 40 Decimal 27 64

• The data in the print buffer is cleared.

• The data in the receive buffer is not discarded.

• All settings, such as print mode and line feed, are cleared.

• Nonvolatile graphics and nonvolatile user memory are not cleared.

P1067298-003 Virtual Device-E User Guide 08/28/2018

Page 51

ESC D

Commands

Virtual Device-E Commands

Description Set Horizontal Tab Position

<ESC>DnNUL

Syntax

Range n = 1 to 255

Default n = 8

Notes This command sets a horizontal tab position at n, which indicates the number

of columns from the beginning of the line to the tab position. The horizontal tab position is stored as a value of [character width × n] measured form the beginning of the line.

ASCII ESC D n NUL Hex 1B 44 n 00 Decimal 27 68 n 0

• The data n signifies the set position and ends with a NUL code. The command reads until the NUL code, but only the first value is used for the horizontal tab position.

ESC E

• ESC D NUL cancels all horizontal tab positions.

• Tab position is set at the value of [character width × n] from the beginning of the line. The character width includes the space to the right of the character. This width is doubled when double width characters are selected.

• The horizontal tab position remains unchanged if the character width changes.

Description Turn Emphasized Mode On/Off

<ESC>En

Syntax

Range n = 0 to 255

Default n = 0

Notes ESC E turns emphasized mode on or off by toggling the least significant bit

(LSB) of n as follows.

ASCII ESC E n Hex 1B 45 n Decimal 27 69 n

• When the LSB of n is 0, emphasized mode is turned off.

• When the LSB of n is 1, emphasized mode is turned on.

This command remains in effect until one of the following occurs: ESC ! on page 45 or

ESC @ on page 50 is run, the printer defaults are reset, or the printer is power cycled.

08/28/2018 Virtual Device-E User Guide P1067298-003

Page 52

Commands

Virtual Device-E Commands

ESC G

Description Turn Double-Strike Mode On/Off

<ESC>Gn

Syntax

Range n = 0 to 255

Default n = 0

Notes ESC E turns double-strike mode on or off by toggling the least significant bit

(LSB) of n as follows.

ASCII ESC G n Hex 1B 47 n Decimal 27 71 n

• When the LSB of n is 0, double-strike mode is turned off.

• When the LSB of n is 1, double-strike mode is turned on.

ESC J

This command remains in effect until one of the following occurs: ESC ! on page 45 or

ESC @ on page 50 is run, the printer defaults are reset, or the printer is power cycled.

Description Print and Feed Paper

<ESC>Jn

Syntax

Range n = 0 to 255 dots

Default None

Notes ESC J prints the data in the print buffer and feeds the paper by the number of

dots specified by n.

ASCII ESC J n Hex 1B 4A n Decimal 27 74 n

P1067298-003 Virtual Device-E User Guide 08/28/2018

Page 53

ESC L

Commands

Virtual Device-E Commands

Description Select Page Mode

<ESC>L

Syntax

ASCII ESC L Hex 1B 4C Decimal 27 76

Notes This command switches the printer from Standard mode to Page mode. For printing in Page mode, ESC T on page 57 defines the print direction and starting position within the print area specified by ESC W on page 58.

The following commands are defined independently in Standard mode and Page mode.

• ESC SP on page 45

• ESC 2 on page 49

• ESC 3 on page 50

The following commands are inactive in Page mode.

• ESC L on page 53

• FS q on page 64

• GS ( A on page 68

• GS ( E on page 97

• GS T on page 121

The following commands are ignored in Page mode. Any conditions set by these commands in Page mode are available when the printer returns to Standard mode.

• ESC a on page 60

• ESC { on page 62

• GS L on page 120

• GS W on page 122

The printer returns to Standard mode when you use the following commands:

• FF on page 44

• ESC @ on page 50

• ESC S on page 56

In Page mode, the Form Feed command (FF on page 44) prompts printing of data in the print buffer. LF on page 43, ESC D on page 51, and ESC J on page 52 move the print position without actually printing.

08/28/2018 Virtual Device-E User Guide P1067298-003

Page 54

Commands

Virtual Device-E Commands

ESC M

Description Select Character Font

<ESC>Mn

Syntax

ASCII ESC M n Hex 1B 4D n Decimal 27 77 n

Range n = 0, 1, 2, 48, 49, 50, 67, 68, 69, 70, 71, 72, 73

Default n = 0

Notes This command selects 1-byte character fonts as defined by n.

n Function

0, 48 Character Font A (12 × 24) selected

1, 49 Character Font B (9 × 17) selected

2, 50 Character Font C (9 × 24) selected

This command remains in effect until one of the following occurs: ESC ! on page 45 or

ESC @ on page 50 is run, the printer defaults are reset, or the printer is power cycled.

Differences Configuration of Fonts A, B, and C: Font A (12 × 24), Font B (9 × 17), Font C (9 × 24)

P1067298-003 Virtual Device-E User Guide 08/28/2018

Page 55

ESC R

Description Specify International Character Set

<ESC>Rn

Syntax

Range n = 0 to 10

Default n = 0

Notes This command specifies international characters.

n Character set n Character set

0 U.S.A. 5 Sweden

ASCII ESC R n Hex 1B 52 n Decimal 27 82

Commands

Virtual Device-E Commands

1 France 6 Italy

2 Germany 7 Spain I

3U.K 9Norway

4 Denmark I 10 Denmark II

This command remains in effect until one of the following occurs: ESC ! on page 45 or

ESC @ on page 50 is run, the printer defaults are reset, or the printer is power cycled.

08/28/2018 Virtual Device-E User Guide P1067298-003

Page 56

Commands

Virtual Device-E Commands

ESC S

Description Select Standard Mode

<ESC>S

Syntax

ASCII ESC S Hex 1B 53 Decimal 27 83

Notes This command enables Standard mode.

The data in the print buffer is cleared, and any changes made by ESC W on page 58 return to the default.

The following commands are defined independently in Standard mode and Page mode.

• ESC SP on page 45

• ESC 2 on page 49

• ESC 3 on page 50

The following commands are ignored in Standard mode.

• CAN on page 44

• ESC FF on page 44

• GS $ on page 67

• GS \ on page 123

P1067298-003 Virtual Device-E User Guide 08/28/2018

Page 57

ESC T

Virtual Device-E Commands

Description Select Print Direction (Page mode)

<ESC>Tn

Syntax

ASCII ESC T n Hex 1B 54 n Decimal 27 84 n

Range n = 0 to 3, 48 to 51

n Print Direction Starting Print Position

0, 48 Left right Upper left

1,49 Bottom to top Lower left

2, 50 Right left Lower right

3, 51 Top bottom Upper right

Commands

Default n = 0

Notes In Page mode, ESC T specifies the print direction and the starting print

position. In Standard mode, ESC T specifies the print direction but does not effect the starting print position. If the command is processed in Standard mode, any changes take effect when the printer changes to Page mode.

The starting print position set by this command determines whether the horizontal motion unit or vertical motion unit is used for some commands.

When the starting print position is the...

upper left or lower right of the print area

upper right or lower left of the print area

Horizontal motion unit is used for:

• ESC SP on page 45

• ESC $ on page 46

• ESC \ on page 59

• ESC 3 on page 50

• ESC J on page 52

• GS $ on page 67

• GS \ on page 123

Vertical motion unit is used for:

• ESC 3 on page 50

• ESC J on page 52

• GS $ on page 67

• GS \ on page 123

• ESC SP on page 45

• ESC $ on page 46

• ESC \ on page 59

This command remains in effect until one of the following occurs: ESC ! on page 45 or

ESC @ on page 50 is run, the printer defaults are reset, or the printer is power cycled.

08/28/2018 Virtual Device-E User Guide P1067298-003

Page 58

Commands

Virtual Device-E Commands

ESC W

Description Set Print Area (Page mode)

<ESC>W xL xH yL yH dxL dxH dyL dyH

Syntax

ASCII ESC W

xL xH yL yH dxL dxH dyL dyH

Hex 1B 57 xL xH yL yH dxL dxH dyL dyH Decimal 27 87 xL xH yL yH dxL dxH dyL dyH

Range

0 ? (xL + xH × 256) ? 65535 (0 ? xL ? 255, 0 ? xH ? 255) 0 ? (yL + yH × 256) ? 65535 (0 ? yL ? 255, 0 ? yH ? 255) 1 ? (dxL + dxH × 256) ? 65535 (0 ? dxL ? 255, 0 ? dxH ? 255) 1 ? (dyL + dyH × 256) ? 65535 (0 ? dyL ? 255, 0 ? dyH ? 255)

Default When paper width of 48mm is selected:

(xL + xH × 256) = 0 (xL = 0, xH = 0) (yL + yH × 256) = 0 (yL = 0, yH = 0) (dxL + dxH × 256) = 384 (dxL = 80, dxH = 1) (dyL + dyH × 256) = 2400 (dyL = 60, dyH = 9)

Notes ESC W sets the position and the size of the printing area in Page mode as

follows.

• Horizontal starting position = [(xL + xH × 256) × (horizontal motion units)]

• Vertical starting position = [(yL + yH × 256) × (vertical motion units)]

• Horizontal printing area width = [(dxL + dxH × 256) × (horizontal motion units)]

• Vertical printing area width = [(dyL + dyH × 256) × (vertical motion units)]

If the following condition exists...

The horizontal and vertical starting positions are out of the

Then...

The ESC W command is ignored, and any data that follows is processed normally.

printable area

(Horizontal starting position + Horizontal printing area width) is outside of the printable area

(Vertical starting position + Vertical printing area width) is outside of the printable area

P1067298-003 Virtual Device-E User Guide 08/28/2018

The Horizontal printing area width is set to (Horizontal printing area - Horizontal starting position).

The Vertical printing area width is set to (Vertical printing area - Vertical starting position).

Page 59

ESC \

Commands

Virtual Device-E Commands

In Standard mode, ESC W is ignored. If the command is processed in Standard mode, any changes take effect when the printer changes to Page mode.

This command remains in effect until one of the following occurs: ESC ! on page 45 or

ESC @ on page 50 is run, the printer defaults are reset, or the printer is power cycled.

Differences The maximum printable area varies by printer model.

Description Set Relative Print Position

Syntax

<ESC>\nLnH

ASCII ESC

nL nH

Hex 1B 5C nL nH Decimal 27 92 nL nH

Range nL = 0 to 255, nH = 0 to 255

0 ? (nL + nH × 256) ? 65535

Default None

Notes This command sets the print starting position based on the current position to

[(nL + nH × 256) × horizontal or vertical motion unit]

The print starting position is moved to (nL + nH × 256) in the right direction based on the current position. The printer ignores this command when any setting exceeds the print area.

• In Standard mode, the vertical motion unit is used for the calculation.

• In Page mode, the horizontal motion unit is used for the calculation when the print start position is defined to the upper right or lower right of print area (using ESC T

on page 57). Otherwise, the vertical motion unit is used.

When in underline mode, the printer does not underline the space created by this command.

08/28/2018 Virtual Device-E User Guide P1067298-003

Page 60

Commands

Virtual Device-E Commands

ESC a

Description Set Position Alignment

<ESC>an

Syntax

Range n = 0 to 2, 48 to 50

n Alignment

0, 48 Left alignment

1, 49 Center alignment

2, 50 Right alignment

Default n = 0

ASCII ESC a n Hex 1B 61 n Decimal 27 97 n

ESC d

Notes In Standard mode, ESC a specifies position alignment for all data in one line.

In Page mode, ESC a is ignored. If the command is processed in Page mode, any changes take effect when the printer changes to Standard mode.

This command remains in effect until one of the following occurs: ESC ! on page 45 or

ESC @ on page 50 is run, the printer defaults are reset, or the printer is power cycled.

Description Print and Feed a Specified Number of Lines

<ESC>dn

Syntax

Range n = 0 to 255

Default None

Notes This command feeds the paper by n lines after printing the data in the print

buffer. In Page mode, the printer does not print, but simply moves the print position the specified number of lines. The amount fed for each line is based on the values set by the line spacing commands (ESC 2 on page 49 and ESC 3 on page 50).

ASCII ESC d n Hex 1B 64 n Decimal 27 100 n

If the feed amount is set to a value greater than the maximum feed value of 255 lines, the printer defaults to 255.

P1067298-003 Virtual Device-E User Guide 08/28/2018

Page 61

ESC t

Description Select a Character Code Table

<ESC>tn

Syntax

ASCII ESC t n Hex 1B 74 n Decimal 27 116 n

Range n = one of the following values:

n Code page

Commands

Virtual Device-E Commands

Page 0 437 (USA, Standard Europe)

Page 2 850 (Multilingual)

16 Page 16 1252 (Latin 1)

28 Page 28 1251 (Cyrillic)

For additional code page support, contact Zebra Technologies.

Default n = 0

Notes This command assigns the code page specified by n.

This command remains in effect until one of the following occurs: ESC ! on page 45 or

ESC @ on page 50 is run, the printer defaults are reset, or the printer is power cycled.

08/28/2018 Virtual Device-E User Guide P1067298-003

Page 62

Commands

Virtual Device-E Commands

ESC {

Description Set Upside-Down Printing Mode

<ESC>{n

Syntax

ASCII ESC { n Hex 1B 7B n Decimal 27 123 n

Range n = 0 to 255

Default n = 0

Notes In Standard mode, this command specifies upside-down printing mode

according to the least significant bit (LSB). This command is valid only when entered at the beginning of the line.

In Page mode, ESC {is ignored. If the command is processed in Page mode, any changes take effect when the printer changes to Standard mode.

LSB

0 Turned off

Upside-down mode

Example of non-rotated text (characters print right-side-up from left to right)

1 Turned on

(characters print upside-down from right to left)

This command remains in effect until one of the following occurs: ESC ! on page 45 or

ESC @ on page 50 is run, the printer defaults are reset, or the printer is power cycled.

Example of rotated text

P1067298-003 Virtual Device-E User Guide 08/28/2018

Page 63

FS p

Commands

Virtual Device-E Commands

Description Print Nonvolatile Bit Images

FSpnm

Syntax

ASCII FS p nm Hex 1C 70 nm

Decimal 28 112 nm

Range n = 1 to 255

m = 0 to 3, 48 to 51

Default None

Notes This command prints the nonvolatile bit images (n) using the mode specified

by m. The download nonvolatile bit image refers to the image that was defined by FS q

on page 64 in the nonvolatile memory. If the image is not defined, this command is

invalid.

m Mode Vertical dot density (DPI)

Horizontal dot density (DPI)

0, 48 Normal 203 203

1, 49 Double-width 203 203/2

2, 50 Double-height 203/2 203

3, 51 Quadruple 203/2 203/2

In Standard mode, this command is valid only when the print buffer is empty. In Page mode, this command is invalid. Printing modes other than upside-down printing are unaffected by this command.

When the print area set by the functions GS L on page 120 and GS W on page 122 is not enough for one vertical line of the download NV bit image, the line is dealt with as follows. One vertical line of the bit image is one dot in normal mode (m = 0, 48) and double height mode (m = 2, 50). It is two dots in double width mode (m = 1, 49) and quadruple size mode (m =3, 51).

1. The printing area is extended to the right side within the limits of the printing area

so that one vertical line of the download NV bit image can be printed.

2. When a sufficient printing area cannot be maintained even after executing number

1, the printing area is extended to the left side. (The left margin is reduced.)

When the size of a bit image exceeds the limits of the print area, the printer prints the data inside the limits of the print area, but not the parts exceeding the limit. When bit image printing is complete, the head of the line is used for the next printing position, and normal data processing takes place.

08/28/2018 Virtual Device-E User Guide P1067298-003

Page 64

Commands

Virtual Device-E Commands

FS q

No matter what line feed distance is set with ESC 2 on page 49 and ESC 3

on page 50, normal mode and double width mode execute a paper feed equal to the

height n of the nonvolatile bit image (in dots) while double height mode and quadruple size mode execute a paper feed equal to the height n of the nonvolatile bit image × 2 (in dots).

Description Define Nonvolatile Bit Images

Syntax

FSqn[xL xH yL yH d1...dk]1 ... [xL xH yL yH d1...dk]n

ASCII FS q n [xL xH yL yH

d1...dk]1

Hex 1C 71 n [xL xH yL yH

d1...dk]1

Decimal 29 33 n [xL xH yL yH

d1...dk]1

Range n = 1 to 255 = the number of bit images to be defined

xL = 0 to 255 xH = 0 to 3, 1 ? (xL + xH × 256) ? 1023 yL = 0 to 255 yH = 0 to 1, 1 ? (yL + yH × 256) ? 288 d = 0 to 255 = the definition data. Bits that correspond to dots that are to be

printed are designated as “1”, and those not to be printed as “0.”

k = (xL + xH × 256) × (yL + yH × 256) × 8

Total definition area = 2 Megabits (256 Kbytes)

xL, xH define the horizontal size of a bit image as (xL + xH × 256) × 8 yL, yH define the vertical size of a bit image as (yL + yH × 256) × 8

[xL xH yL yH

d1...dk]n

[xL xH yL yH

d1...dk]n

[xL xH yL yH

d1...dk]n

Default n = 0

Notes This command defines the specified nonvolatile bit image. A nonvolatile bit

image refers to a bit image that is defined by this command in the nonvolatile memory and printed by FS p on page 63. Existing nonvolatile bit images are not erased by the

ESC @ command or when the printer is reset or power cycled.

This command deletes all of the nonvolatile bit images previously defined and stored by this command, meaning that it is not possible to retain any of the previously defined images. All of the data must be resent.

In Standard mode, this command is valid only when it is written at the head of a line. In Page mode, this command is invalid.

This command becomes valid after the 7 bytes of <FS q n xL xH yL yH> are processed as normal values.

P1067298-003 Virtual Device-E User Guide 08/28/2018

Page 65

Commands

Virtual Device-E Commands

When data that exceeds the remaining capacity of the defined area is specified by xL,

xH, yL, yH, outside-defined-area arguments are processed. When outside-defined-

area arguments are processed for the first bit image data group, this command becomes invalid. If outside-defined-area arguments are processed for the second or subsequent nonvolatile bit image data groups, the printer stops processing this command and begins writing into the nonvolatile memory. At this time, the nonvolatile bit image being defined becomes invalid (undefined), but the preceding nonvolatile bit images remain valid.

The first data group, which is defined by [xL xH yL yH d1…dk], becomes nonvolatile bit image number 01H, and the last data group becomes nonvolatile bit image number

0nH. The number n of nonvolatile bit images coincides with those specified by FS p

on page 63. If only one nonvolatile bit image is defined (n = 1), the data group is

manipulated once, and the following determines the number of bytes of non-volatile memory used to store it.

[Bit image data: ((xL + xH × 256) × (yL + yH × 256) × 8) + Header: (4 bytes)]

The maximum bit image size for this printer is 2 Mbits (256 Kbytes). Multiple nonvolatile bit images can be defined, but the total size of a bit image (Bit image data + Header) may not exceed 2 Mbits (256 Kbytes).

This example shows the bit image area defined when xL = 64, xH = 0, yL = 96, and yH = 0:

08/28/2018 Virtual Device-E User Guide P1067298-003

Page 66

Commands

Hex Decimal Enlargement

00 0 1 time (standard)

01 1 2 times

02 2 3 times

03 3 4 times

04 4 5 times

05 5 6 times

06 6 7 times

07 7 8 times

Hex Decimal Enlargement

00 0 1 time (standard)

10 16 2 times

20 32 3 times

30 48 4 times

40 64 5 times

50 80 6 times

60 96 7 times

70 112 8 times

Virtual Device-E Commands

GS !

Description Specify Character Size

GS!n

Syntax

Range n = 0 to 255

Default n = 0

Notes This command specifies the character height and width using bits 0 to 7 as

follows:

Bit Function Setting

ASCII GS ! n Hex 1D 21 n Decimal 29 33 n

(Vertical enlargement = 1 to 8, Horizontal enlargement = 1 to 8)

0 Specifies the number of times to

enlarge the font size vertically

4 Specifies the number of times to

enlarge the font size horizontally

P1067298-003 Virtual Device-E User Guide 08/28/2018

Page 67

GS $

Commands

Virtual Device-E Commands

The character size set by this command is valid for alphanumeric characters, userdefined characters, and multi-byte code characters (such as Chinese, Japanese, and Korean). Double-width and double-height modes can also be set by ESC !

on page 45.

This command remains in effect until one of the following occurs: ESC @ on page 50 is run, the printer defaults are reset, or the printer is power cycled.

Description Set Absolute Vertical Print Position ( Page Mode)

Syntax

GS$nLnH

ASCII GS $ nL nH Hex 1D 24 nL nH Decimal 29 36 nL nH

Range nL = 0 to 255, nH = 0 to 255

0 ? (nL + nH × 256) ? 65535

Default None

Notes GS $ is ignored in Standard mode.In Page mode, GS $ sets the absolute

vertical print starting position to

[(nL + nH × 256) × (vertical or horizontal motion unit)]

Depending on the print direction set by ESC T on page 57, the vertical motion unit is used for the calculation when the print start position is defined as the upper left or lower right of the print area (using ESC T on page 57). Otherwise, the horizontal motion unit is used.

The printer ignores any setting values that would cause printing outside of the print area set by ESC W on page 58.

08/28/2018 Virtual Device-E User Guide P1067298-003

Page 68

Commands

Virtual Device-E Commands

GS ( A

Description Execute Test Print

GS(ApLpHnm

Syntax

ASCII GS ( A pL pH n m Hex 1D 28 41 pL pH n m Decimal 29 40 65 pL pH n m

Range n = 0 to 2, 48 to 50

m = 1 to 3, 49 to 51

(pL + pH × 256) = 2 (pL = 2, pH = 0)

Default None

Notes This command prints a specified pattern for testing on a roll paper.

• Roll paper is specified by n.

nPaper type

0, 48

Roll paper 1, 49 2, 50

• The type of test print is specified by m.

m Test print

1, 49 Hexadecimal dump mode (The printer prints all of

the data transmitted from the host to the printer.)

2, 50 Printer configuration printing

3, 51 Rolling pattern printing

After completion of this command, a software reset is executed automatically to restore the printer status set during power cycling. If this command is processed while a macro definition is in progress, the printer cancels the macro definition, and the macro becomes invalid.

The real-time command and ASB operations are not executed during the printing of printer configuration (m = 2, 50) and rolling pattern (m = 3, 51).

P1067298-003 Virtual Device-E User Guide 08/28/2018

Page 69

Commands

Virtual Device-E Commands

GS ( F

Description Set Black Mark Control Functions

Notes This command performs various functions to control the black mark media

when the black mark sensor is used. The command is stored and processed in the order it was received, so you may notice a delay in execution of this command.

m Format Function

2 GS ( F pL pH m a nL nH Sets the paper feed amount to adjust the paper

cutting position after sensing the black mark.

112 GS ( F pL pH m aL aH bL bH Specifies the black mark paper format.

pL, pH specifies (pL + (pH × 256)) as the number of bytes after pH (m and other

parameters).

<Function 2> (m = 2)

Description Adjust Black Mark Paper Position

Syntax

ASCII GS ( F pL pH m a nL nH

Hex 1D 28 46 04 00 02 a nL nH

Decimal 29 40 70 402anLnH

Range (pL + pH × 256) = 4 (pL = 4, pH = 0)

Default nL = 0, nH = 0

Notes This command adjusts the paper position after the printer senses a black

mark.

• pL, pH specifies (pL + pH × 256) as the number of bytes after pH (m, a, nL, and nH)

GS ( F

m = 2 a = 0, 48

0 ? (nL + nH × 256) ? 65535 (nL = 0 to 255, nH = 0 to 255)

—

GS ( F

pL pH m a nL nH

• nL, nH specifies [(nL + nH × 256) × vertical motion units] as the adjustment value.

This command applies only toward forward paper feeding.

If the adjustment value specified is greater than the maximum adjustable length of 400 mm, the printer defaults to 400 mm.

08/28/2018 Virtual Device-E User Guide P1067298-003

Page 70

Commands

Virtual Device-E Commands

<Function 112> (m = 112)

Description Set Black Mark Paper Format

Syntax

ASCII GS ( F pLpH m aLaHbLbH Hex 1D 28 46 05 00 70 aL aH bL bH Decimal 29 40 70

Range (pL + pH × 256) = 5 (pL = 5, pH = 0)

Default aL = 141, aH = 0 (black mark height (from the top of a mark to the bottom): 20

mm)

Notes This command sets the black mark paper format.

• pL, pH specifies (pL + pH × 256) as the number of bytes after pH (m, aL, aH, bL, bH).

GS ( F

m = 112

0 ? (aL + aH × 256) ? 65535 (aL = 0 to 255, aH = 0 to 255) 0 ? (bL + bH × 256) ? 65535 (bL 0 to 255, bH = 0 to 255)

bL = 20, bH = 11 (black mark interval (top of a black mark to the top of the next

one): 400 mm)

—

GS ( F

pL pH m aL aH bL bH

5 0 112 aL aH bL bH

pL pH m aL aH bL bH

• aL, aH specifies [(aL + aH × 256) × vertical motion units] as the black mark height.

• bL, bH specifies as [(bL + bH × 256) × vertical motion units] as the black mark interval.

The available black mark height ranges from 4 to 20 mm. If the black mark height specified is out of range, this command is ignored.

The black mark interval ranges from 40 to 400 mm. If the black mark interval specified is out of range, this command is ignored.

P1067298-003 Virtual Device-E User Guide 08/28/2018

Page 71

GS ( k

Description Specify and Print Symbols

Notes

This command specifies data for two-dimensional codes.

• cn = symbol type

• fn = function code

cn Two-Dimensional Code

48 PDF417

49 QR CODE

50 MAXI CODE

51 DATA MATRIX

cn fn Function

Commands

Virtual Device-E Commands

48 65 <Function 065> (fn = 65)

on page 74

66 <Function 066> (fn = 66)

on page 75

67 <Function 067> (fn = 67)

on page 76

68 <Function 068> (fn = 68)

on page 76

69 <Function 069> (fn = 69)

on page 77

70 <Function 070> (fn = 70)

on page 78

80 <Function 080> (fn = 80)

on page 79

81 <Function 081> (fn = 81)

on page 80

82 <Function 082> (fn = 82)

on page 82

PDF417: Specify the number of columns

PDF417: Specify the number of rows

PDF417: Specify the width of module

PDF417: Specify the module height

PDF417: Specify the error correction level

PDF417: Specify the option

PDF417: Store the received data in the symbol storage area

PDF417: Print the symbol data in the symbol storage area

PDF417: Send the size information of the symbol data in the symbol storage area

08/28/2018 Virtual Device-E User Guide P1067298-003

Page 72

Commands

Virtual Device-E Commands

49 65 <Function 165> (fn = 65)

on page 83

67 <Function 167> (fn = 67)

on page 84

69 <Function 169> (fn = 69)

on page 85

80 <Function 180> (fn = 80)

on page 86

81 <Function 181> (fn = 81)

on page 87

82 <Function 182> (fn = 82)

on page 89

50 65 <Function 265> (fn = 65)

on page 90

80 <Function 280> (fn = 80)

on page 91

81 <Function 281> (fn = 81)

on page 92

51 67 <Function 367> (fn = 67)

on page 94

QR CODE: Select the module

QR CODE: Select the size of module

QR CODE: Select the error correction level

QR CODE: Store the data in the symbol storage area

QR CODE: Print the data in the symbol storage area

QR CODE: Transmit the size information of the symbol data in the symbol storage area

MAXI CODE: Select the mode

MAXI CODE: Store the data in the symbol storage area

MAXI CODE: Print the symbol data saved in the symbol storage area

DATA MATRIX: Select the size of module

80 <Function 380> (fn = 80)

on page 95

DATA MATRIX: Store the symbol data in the

symbol storage area

81 <Function 381> (fn = 81)

on page 96

DATA MATRIX: Print the symbol data in the storage area

PDF417 Symbol Data (when cn = 48)

The symbol data is defined, stored to the symbol storage area by <Function 080> (fn

= 80) on page 79 and printed by the specification of <Function 081> (fn = 81) on page 80. The symbol data in the area remains reserved until one the following

processes is executed:

• Performing <Function 080> (fn = 80) on page 79

• Performing ESC @ on page 50

• Resetting the printer defaults or power cycling the printer

The setting values of Functions 065 to 070 are utilized for the processing of <Function

080> (fn = 80) on page 79 or <Function 082> (fn = 82) on page 82. The printable area

must be large enough to accommodate different-sized symbols. If not, the symbol may not be printed.

• Print the same symbol data repeatedly by executing <Function 081> (fn = 81)

on page 80 after performing Function 080.

P1067298-003 Virtual Device-E User Guide 08/28/2018

Page 73

Commands

Virtual Device-E Commands

• The same symbol data is printed differently by executing <Function 081> (fn = 81)

on page 80 after setting the feature of the symbol by using Functions 065 through

070.

• By using <Function 082> (fn = 82) on page 82, the symbol size printed by

<Function 081> (fn = 81) on page 80 is Available.

QR Code® Symbol Data (cn = 49)

The symbol data is defined, stored to the symbol storage area by <Function 180> (fn

= 80) on page 86 and printed by the specification of <Function 181> (fn = 81) on page 87. The symbol data in the area remains reserved until one the following

processes is executed:

• Performing Function 180

• Performing ESC @ on page 50

• Resetting the printer defaults or power cycling the printer

The setting values of Functions 165 to 169 are utilized for the processing of <Function

180> (fn = 80) on page 86 or <Function 182> (fn = 82) on page 89. The printable area

must be large enough to accommodate different-sized symbols. If not, the symbol may not be printed.

Print the symbol data repeatedly by executing <Function 181> (fn = 81) on page 87 after performing <Function 180> (fn = 80) on page 86.

The same symbol data is printed differently by executing <Function 181> (fn = 81)

on page 87 after setting the feature of the symbol by using Functions 165 through

169.

By using <Function 182> (fn = 82) on page 89, the symbol size printed by <Function

181> (fn = 81) on page 87 is available.

MaxiCode Symbol Data (cn = 50)

The symbol data is defined, stored to the symbol storage area by <Function 280> (fn

= 80) on page 91 and printed by the specification of <Function 281> (fn = 81) on page 92. The symbol data in the area remains reserved until one the following

processes is executed:

• Performing <Function 280> (fn = 80) on page 91

• Performing ESC @ on page 50

• Resetting the printer defaults or power cycling the printer

The setting value of <Function 265> (fn = 65) on page 90 is utilized for the processing of <Function 281> (fn = 81) on page 92. The printable area must be large enough to accommodate different-sized symbols. If not, the symbol may not be printed.

The same symbol data is repeatedly printed by executing <Function 281> (fn = 81)

on page 92 after performing <Function 280> (fn = 80) on page 91.

The same symbol data is printed differently by executing <Function 281> (fn = 81)

on page 92 after setting the mode by using <Function 265> (fn = 65) on page 90.

08/28/2018 Virtual Device-E User Guide P1067298-003

Page 74

Commands

Virtual Device-E Commands

Data Matrix Symbol Data (cn = 51)

The symbol data is defined, stored to the symbol storage area by <Function 380> (fn

= 80) on page 95 and printed by the specification of <Function 381> (fn = 81) on page 96. The symbol data in the area remains reserved until the following

processes are executed:

• Performing <Function 380> (fn = 80) on page 95

• Performing ESC @ on page 50

• Resetting the printer defaults or power cycling the printer

The setting value of <Function 367> (fn = 67) on page 94 is utilized for the processing of <Function 381> (fn = 81) on page 96. The printable area must be large enough to accommodate different-size symbols. If not, the symbol may not be printed.

The same symbol data is repeatedly printed by executing <Function 381> (fn = 81)

on page 96 after performing <Function 380> (fn = 80) on page 95.

The same symbol data is printed differently by executing <Function 381> (fn = 81)

on page 96 after setting the mode by using <Function 367> (fn = 67) on page 94.

<Function 065> (fn = 65)

Description

Syntax

Specify Number of Columns for PDF417

GS ( k pL pH cn fn n

— GS ( k pL pH cn fn n

ASCII GS ( k pL pH cn fn n Hex 1D 28 6B 03 00 30 41 n Decimal 29 40 107 3 0 48 65 n

Range (pL + pH × 256) = 3 (pL = 3, pH = 0)

cn = 48, fn = 65

n = 0 to 30

Default n = 0

Notes This command specifies the number of columns in the data area of PDF417.

• When n = 0, automatic processing is set.

• When n does not equal 0, the number of columns of the data area is set to n.

The settings of this function affect the processing of <Function 081> (fn = 81)

on page 80 and <Function 082> (fn = 82) on page 82.

The following data is excluded from the number of columns:

Start and stop patterns

•

Indicator code word of left and right

•

P1067298-003 Virtual Device-E User Guide 08/28/2018

Page 75

Commands

Virtual Device-E Commands

With auto processing (n = 0) specified, the maximum number of columns in the data area is set to 30 columns. The actual number of columns is calculated using the following information:

• Print area when processing <Function 081> (fn = 81) on page 80 or <Function

082> (fn = 82) on page 82

• Module width (<Function 067> (fn = 67) on page 76)

• Option setting (<Function 070> (fn = 70) on page 78)

This command remains in effect until one of the following occurs: ESC ! on page 45 or

ESC @ on page 50 is run, the printer defaults are reset, or the printer is power cycled.

<Function 066> (fn = 66)

— GS ( k pL pH cn fn n

Description Specify Number of Rows for PDF417

GS ( k pL pH cn fn n

Syntax

ASCII GS ( k pL pH cn fn n Hex 1D 28 6B 03 00 30 42 n Decimal 29 40 107 304866n

Range (pL + pH × 256) = 3 (pL = 3, pH = 0)

cn = 48 fn = 66 n = 0, 3 to 90

Default n = 0

Notes This command specifies the number of rows in the data area of PDF417.

• When n = 0, automatic processing is set

• When n does not equal 0, the number of rows is set to n rows.

The settings of this function affect the processing of <Function 081> (fn = 81)

on page 80 and <Function 082> (fn = 82) on page 82.

With auto processing (n = 0) specified, the maximum number of rows is set to 90. The actual number of rows is calculated by using the following information:

• Print area when processing <Function 081> (fn = 81) on page 80 or <Function

082> (fn = 82) on page 82

• Module height (<Function 068> (fn = 68) on page 76)

This command remains in effect until one of the following occurs: ESC ! on page 45 or

ESC @ on page 50 is run, the printer defaults are reset, or the printer is power cycled.

08/28/2018 Virtual Device-E User Guide P1067298-003

Page 76

Commands

Virtual Device-E Commands

<Function 067> (fn = 67)

Description

Syntax

ASCII GS ( k pL pH cn fn n Hex 1D 28 6B 03 00 30 43 n Decimal 29 40 107 304867n

Range (pL + pH × 256) = 3 (pL = 3, pH = 0)

Default n = 3

Notes This command sets the width of the module of the PDF417 symbol to n dots.

The settings of this function affect the processing of <Function 081> (fn = 81)

on page 80 and <Function 082> (fn = 82) on page 82.

This command remains in effect until one of the following occurs: ESC ! on page 45 or

ESC @ on page 50 is run, the printer defaults are reset, or the printer is power cycled.

Specify Width of Module for PDF417

GS ( k pL pH cn fn n

cn = 48 fn = 67 n = 2, 3

—

GS ( k pL pH cn fn n

<Function 068> (fn = 68)

Description

Syntax

ASCII GS ( k pL pH cn fn n Hex 1D 28 6B 03 00 30 44 n Decimal 29 40 107 3 0 48 68 n

Range (pL + pH × 256) = 3 (pL = 3, pH = 0)

Default n = 3

Notes This command sets the module height of PDF417 to [the module width × n]

The settings of this function affect the processing of <Function 081> (fn = 81)

on page 80 and <Function 082> (fn = 82) on page 82.

This command remains in effect until one of the following occurs: ESC ! on page 45 or

ESC @ on page 50 is run, the printer defaults are reset, or the printer is power cycled.

Specify Module Height for PDF417

GS ( k pL pH cn fn n

cn = 48 fn = 68 n = 2 to 8

—

GS ( k pL pH cn fn n

P1067298-003 Virtual Device-E User Guide 08/28/2018

Page 77

Commands

Virtual Device-E Commands

<Function 069> (fn = 69)

Description

Syntax

Specify Error Correction Level for PDF417

GS ( k pL pH cn fn m n

— GS ( k

pL pH cn fn m n

ASCII GS ( k pL pH cn fn m n Hex 1D 28 6B 04 00 30 45 m n Decimal 29 40 107 404869mn

Range (pL + pH × 256) = 4 (pL = 4, pH = 0)

cn = 48 fn = 69 m = 48

n = 0 to 8, 48 to 56

Default None

Notes This command specifies the error correction level for PDF417. The settings of

this function affect the processing of <Function 081> (fn = 81) on page 80 and

<Function 082> (fn = 82) on page 82.

Error correction level specified by “level” (m = 48) is as follows:

• The number of the error correction codeword is unchanged regardless of the number of codeword in the data area.

n Function

Number of error correction codeword

48 Error correction level 0 2

49 Error correction level 1 4

50 Error correction level 2 8

51 Error correction level 3 16

52 Error correction level 4 32

53 Error correction level 5 64

54 Error correction level 6 128

55 Error correction level 7 256

56 Error correction level 8 512

This command remains in effect until one of the following occurs: ESC ! on page 45 or

ESC @ on page 50 is run, the printer defaults are reset, or the printer is power cycled.

08/28/2018 Virtual Device-E User Guide P1067298-003

Page 78

Commands

Virtual Device-E Commands

<Function 070> (fn = 70)

Description

Syntax

Select the PDF417 Option

GS ( k pL pH cn fn m

— GS ( k

pL pH cn fn m

ASCII GS ( k pL pH cn fn m Hex 1D 28 6B 03 00 30 46 m Decimal 29 40 107 3 0 48 70 m

Range (pL + pH × 256) = 3 (pL = 3, pH = 0)

cn = 48 fn = 70 m = 0, 1

Default m = 0

Notes This command selects the option for PDF417.

m Function

0 Select the standard PDF417

1 Select the simplified PDF417

The settings of this function affect the processing of <Function 081> (fn = 81)

on page 80 and <Function 082> (fn = 82) on page 82.

When simplified PDF417 symbol is canceled, the printer defaults to standard PDF417.

This command remains in effect until one of the following occurs: ESC ! on page 45 or

ESC @ on page 50 is run, the printer defaults are reset, or the printer is power cycled.

P1067298-003 Virtual Device-E User Guide 08/28/2018

Page 79

Commands

Virtual Device-E Commands

<Function 080> (fn = 80)

Description

Syntax

ASCII GS ( k pL pH cn fn m d1...dk Hex 1D 28 6B pL pH 30 50 30 d1...dk Decimal 29 40 107 pL pH 48 80 48 d1...dk

Range 4 ? (pL + pH × 256) ? 65535 (pL = 0 to 255, pH = 0 to 255)

Default None

Notes This command stores the PDF417 symbol data (d1...dk) in the symbol

storage area.

The data stored in the symbol storage area by this command remains reserved after processing <Function 081> (fn = 81) on page 80 or <Function 082> (fn = 82)

on page 82.

Store PDF417 Symbol Data

GS ( k pL pH cn fn m d1...dk

cn = 48 fn = 80 m = 48 d = 0 to 255 k = (pL + pH × 256) – 3

—

GS ( k pL pH cn fn m d1...dk

The following data should not be included in the symbol data (d1...dk) because this information is automatically added by the printer:

• Start pattern and stop pattern.

• Indicator codeword of left and right.

• The descriptor of symbol length. (the first code word in the data area)

• The error correction codeword calculated by modulus 929.

This command remains in effect until the following processing is performed:

• Executing <Function 080> (fn = 80) on page 79

• Executing ESC @ on page 50

• The printer defaults are reset, or the printer is power cycled

08/28/2018 Virtual Device-E User Guide P1067298-003

Page 80

Commands

Virtual Device-E Commands

<Function 081> (fn = 81)

Description

Syntax

ASCII GS ( k pL pH cn fn m Hex 1D 28 6B 03 00 30 51 m Decimal 29 40 107 3 0 48 81 m

Range (pL + pH × 256) = 3 (pL = 3, pH = 0)

Default None

Notes This function encodes and prints the PDF417 symbol data in the symbol save

area.

In Standard mode, this command is available only when the printer is at the beginning of a line or when the print buffer is empty. The paper feed amount set by the paper feed setting command does not affect printing of the symbol. The printing position returns to the left side of the printable area after printing the symbol. In Page mode, the printer stores the symbol data in the print buffer without printing.

Encode and Print PDF417 Symbol Data

GS ( k pL pH cn fn m

cn = 48 fn = 81 m = 48

—

GS ( k pL pH cn fn m

The printer cannot print a symbol that exceeds the printing area in size. Print modes (such as emphasized or double-strike) do not affect the printing of a symbol. Exceptions are the character size and upside-down printing.

Printing operation is not processed under the following conditions:

• There is no data (<Function 080> (fn = 80) on page 79 is not processed).

• The (number of columns × number of rows) is less than the number of codewords when automatic processing is specified for the number of columns and number of rows.

• More than 928 codewords exist in the data area.

The following data is added automatically by the encode processing:

• Start pattern and stop pattern.

• Indicator codeword of left or right.

• The descriptor of symbol length (the first codeword in the data area).

• The error correction codeword that was calculated by modulus 929.

• A pad codeword.

P1067298-003 Virtual Device-E User Guide 08/28/2018

Page 81

Commands

Virtual Device-E Commands

The data area includes the following codewords:

• Data specified by <Function 080> (fn = 80) on page 79.

• The descriptor of symbol length (the first codeword in the data area).

• The error correction codeword that was calculated by modulus 929.

• A pad codeword.

When automatic processing (<Function 065> (fn = 65) on page 74) is specified, the printer calculates the number of columns (maximum of 30) using the following information:

• The current printing area

• The module width (<Function 067> (fn = 67) on page 76)

• The option setting (<Function 070> (fn = 70) on page 78)

• The codeword in the data area

When automatic processing (<Function 066> (fn = 66) on page 75) is specified in Page mode, the printer calculates the number of rows (maximum of 90) using the following information:

• Current printing area

• Module height (<Function 068> (fn = 68) on page 76)

• Codeword in the data area

A quiet zone (the spaces surrounding the symbol such as upper, lower, left, and right spaces) is not included in the printing data. Make sure to include an adequate quiet zone for execution of this command.

08/28/2018 Virtual Device-E User Guide P1067298-003

Page 82

Commands

Virtual Device-E Commands

<Function 082> (fn = 82)

Description

Syntax

Encode and Send Size Information for PDF417 Symbol Data

GS ( k pL pH cn fn m

—

GS ( k pL pH cn fn m

ASCII GS ( k pL pH cn fn m Hex 1D 28 6B 03 00 30 52 m Decimal 29 40 107 304882m

Range (pL + pH × 256) = 3 (pL = 3, pH = 0)

cn = 48 fn = 82 m = 48

Default None

Notes This command encodes and sends the size information of the PDF417 symbol

data in the symbol storage area. In Standard mode, this command is available only when the printer is at the beginning of a line or when the print buffer is empty.

The size information for the data is as follows:

Send data Hex Decimal Data

Header 37H 55 1 byte

Identifier 2FH 47 1 byte

Horizontal size 30H – 39H 48 – 57 1 – 5 byte

Separator 1FH 31 1 byte

Vertical size 30H – 39H 48 – 57 1 – 5 byte

Separator 1FH 31 1 byte

Fixed value 31H 49 1 byte

Separator 1FH 31 1 byte

Other information 30H or 31H 48 or 49 1 byte

NUL 00H 0 1 byte

The following indicates whether or not printing of the symbol is possible:

Hex Decimal Condition

30H 48 Printing is possible

31H 49 Printing is impossible

P1067298-003 Virtual Device-E User Guide 08/28/2018

Page 83

Commands

Virtual Device-E Commands

<Function 165> (fn = 65)

Description

Syntax

Set the QR Code Model

GS ( k pL pH cn fn n1 n2

— GS ( k

pL pH cn fn n1 n2

ASCII GS ( k pL pH cn fn n1 n2 Hex 1D 28 6B 04 00 31 41 n1 n2 Decimal 29 40 107 4 0 49 65 n1 n2

Range (pL + pH × 256) = 3 (pL = 3, pH = 0)

cn = 49 fn = 65 n1 = 49, 50 n2 = 0

Default n1 = 50

n2 = 0

Notes This command sets the QR Code model as follows:

n1 Function

49 Model 1

50 Model 2

The settings of this function affect the processing of <Function 181> (fn = 81)

on page 87 and <Function 182> (fn = 82) on page 89.

This command remains in effect until one of the following occurs: ESC @ on page 50 is run, the printer defaults are reset, or the printer is power cycled.

08/28/2018 Virtual Device-E User Guide P1067298-003

Page 84

Commands

Virtual Device-E Commands

<Function 167> (fn = 67)

ASCII Hex Decimal

Description

Syntax

GS ( k pL pH cn fn n 1D 28 6B 03 00 31 43 n 29 40 107 3 0 49 67 n

Range (pL + pH × 256) = 3 (pL = 3, pH = 0)

cn = 49

fn = 67

n = 0 to 9

Default n = 3

Notes This command sets the size of the QR Code module to n dots. Because a QR

Code module is square, n = both the module width and the module height.

The settings of this function affect the processing of <Function 181> (fn = 81)

on page 87 and <Function 182> (fn = 82) on page 89.

Set the Size of the QR Code Module

GS ( k pL pH cn n

—

GS ( k pL pH cn n

This command remains in effect until one of the following occurs: ESC @ on page 50 is run, the printer defaults are reset, or the printer is power cycled.

P1067298-003 Virtual Device-E User Guide 08/28/2018

Page 85

Commands

Virtual Device-E Commands

<Function 169> (fn = 69)

Description

Syntax

ASCII GS ( k pL pH cn fn n Hex 1D 28 6B 03 00 31 45 n Decimal 29 40 107 3 0 49 69 n

Range (pL + pH × 256) = 3 (pL = 3, pH = 0)

Default n = 48

Notes This command sets the error correction level for the QR Code. The printer

uses Reed-Solomon correction to generate a series of error correction codewords.

n Function Recovery Amount (%)

48 Error Correction Level L 7

Set the Error Correction Level for QR Code

GS ( k pL pH cn n

cn = 49 fn = 69 n = 48 to 51

—

GS ( k pL pH cn n

49 Error Correction Level M 15

50 Error Correction Level Q 25

51 Error Correction Level H 30

The settings of this function affect the processing of <Function 181> (fn = 81)

on page 87 and <Function 182> (fn = 82) on page 89.

This command remains in effect until one of the following occurs: ESC @ on page 50 is run, the printer defaults are reset, or the printer is power cycled.

08/28/2018 Virtual Device-E User Guide P1067298-003

Page 86

Commands

Virtual Device-E Commands

<Function 180> (fn = 80)

Description

Syntax

ASCII GS ( k pL pH cn fn m d1...dk Hex 1D 28 6B pL pH 31 50 30 d1...dk Decimal 29 40 107 pL pH 49 80 48 d1...dk

Range 4 ? (pL + pH × 256) ? 7092 (pL = 0 to 255, pH = 0 to 27)

Default None

Notes This command saves the symbol data of the QR Code to the symbol storage

area.

This function defines and stores the symbol data to the symbol storage area.

<Function 181> (fn = 81) on page 87 prints that symbol data. The data remains

reserved after completion of printing.

Save QR Code Symbol Data

GS ( k pL pH cn fn m d1...dk

cn = 49 fn = 8 m = 48 d = 0 to 255 k = (pL + pH × 256) – 3

—

GS ( k pL pH cn fn m d1...dk

The following shows the data available for encoding a QR code.

Character Type Usable Characters

Numeric Data “0” ~ “9”

Alphanumeric Data “0” ~ “9”, “A” ~ “Z”, SP, $, %, *, +, -, ., /, :

Kanji Data Shift JIS value

8bit Byte Data 00H ~ FFH

This command remains in effect until the following processing is performed:

• Executing <Function 180> (fn = 80) on page 86

• Executing ESC @ on page 50

• The printer defaults are reset, or the printer is power cycled

P1067298-003 Virtual Device-E User Guide 08/28/2018

Page 87

Commands

Virtual Device-E Commands

<Function 181> (fn = 81)

Description

Syntax

ASCII GS ( k pL pH cn fn m Hex 1D 28 6B 03 00 31 51 m Decimal 29 40 107 3 0 49 81 m

Range (pL + pH × 256) = 3 (pL = 3, pH = 0)

Default None

Notes This command encodes and prints the QR Code symbol data that was saved

in the symbol storage area.

Encode and Print QR Code Symbol Data

GS ( k pL pH cn fn m

cn = 49 fn = 81 m = 48

—

GS ( k pL pH cn fn m

Printing operation is not processed under the following conditions:

• There is no data. (<Function 180> (fn = 80) on page 86 is not executed)

• If (number of columns × number of rows) is less than the number of codewords, the numbers of columns and rows are automatically processed.

Based on the symbol data in the data storage area, the printer automatically selects the best compression mode from these four types:

• Numeric Data Code

• Alphanumeric Data mode

• Kanji Data mode

• 8 bit Data mode

The following data is added automatically by the encoding processing:

• Position sensor pattern

• Segregator for the position sensor pattern

• Timing pattern

• Format information

08/28/2018 Virtual Device-E User Guide P1067298-003

Page 88

Commands

Virtual Device-E Commands

• Version information

• Error correction code text

• Pad code text

• Indicator for counting bits of bytes

• Mode indicator

• Concluder

• Queue pattern (when model 2 is selected)

• Expansion pattern (when model 1 is selected)

P1067298-003 Virtual Device-E User Guide 08/28/2018

Page 89

Commands

Virtual Device-E Commands

<Function 182> (fn = 82)

Description

Syntax

Transmit Size Information for QR Code Symbol Data

GS ( k pL pH cn fn m

—

GS ( k pL pH cn fn m

ASCII GS ( k pL pH cn fn m Hex 1D 28 6B 03 00 31 52 m Decimal 29 40 107 3 0 49 82 m

Range (pL + pH × 256) = 3 (pL = 3, pH = 0)

cn = 49 fn = 82 m = 48

Default None

Notes This command transmits the size information of the QR Code symbol data that

was encoded by <Function 180> (fn = 80) on page 86. In Standard mode, this command is available only when the printer is at the beginning of a line or when the print buffer is empty.

The size information of each data is as follows:

Send data Hex Decimal Data

Header 37H 55 1 byte

Flag 36H 54 1 byte

Horizontal size 30H – 39H 48 – 57 1 – 5 byte

Separator 1FH 31 1 byte

Vertical size 30H – 39H 48 – 57 1 – 5 byte

Separator 1FH 31 1 byte

Fixed Value 31H 49 1 byte

Separator 1FH 31 1 byte

Other Information 30H or 31H 48 or 49 1 byte

NUL 00H 0 1 byte

A quiet zone (the spaces surrounding the symbol such as upper, lower, left, and right spaces) is not included in the size information. Make sure to include an adequate quiet zone for execution of this command.

The following data indicates whether or not printing of the symbol is possible:

Hex Decimal Condition

30H 48 Printing is possible

31H 49 Printing is impossible

08/28/2018 Virtual Device-E User Guide P1067298-003

Page 90

Commands

Virtual Device-E Commands

<Function 265> (fn = 65)

Description

Syntax

ASCII GS ( k pL pH cn fn n Hex 1D 28 6B 03 00 32 41 n Decimal 29 40 107 3 0 50 65 n

Range (pL + pH × 256) = 3 (pL = 3, pH = 0)

Default n = 50

Notes This command selects the mode for MaxiCode:

n Function

50 Mode 2 setting

51 Mode 3 setting

Set the Mode for MaxiCode

GS ( k pL pH cn fn n1 n2

cn = 50 fn = 65 n = 50 to 52

—

GS ( k pL pH cn fn n1 n2

52 Mode 4 setting

The settings of this function affect the processing of <Function 281> (fn = 81)

on page 92.

This command remains in effect until one of the following occurs: ESC @ on page 50 is run, the printer defaults are reset, or the printer is power cycled.

P1067298-003 Virtual Device-E User Guide 08/28/2018

Page 91

Commands

Virtual Device-E Commands

<Function 280> (fn = 80)

Description

Syntax

ASCII GS ( k pL pH cn fn m d1...dk Hex 1D 28 6B pL pH 32 50 30 d1...dk Decimal 29 40 107 pL pH 50 80 48 d1...dk

Range 4 ? (pL + pH × 256) ? 141 (pL = 4 to 141, pH = 0)

Default None

Notes This command stores Maxi Code symbol data in the symbol storage area.

The data stored in the symbol storage area by this command is processed by

<Function 281> (fn = 81) on page 92. The data remains reserved in the storage.

Store the MaxiCode Symbol Data

GS ( k pL pH cn fn m d1...dk

cn = 50 fn = 80 m = 48 d = 0 to 255 k = (pL + pH × 256) – 3

—

GS ( k pL pH cn fn m d1...dk

This command remains in effect until the following processing is performed:

• Executing <Function 280> (fn = 80) on page 91

• Executing ESC @ on page 50

• The printer defaults are reset, or the printer is power cycled

08/28/2018 Virtual Device-E User Guide P1067298-003

Page 92

Commands

Virtual Device-E Commands

<Function 281> (fn = 81)

Description

Syntax

Encode and Print MaxiCode Symbol Data

GS ( k pL pH cn fn m

—

GS ( k pL pH cn fn m

ASCII GS ( k pL pH cn fn m Hex 1D 28 6B 03 00 32 51 m Decimal 29 40 107 3 0 50 81 m

Range (pL + pH × 256) = 3 (pL = 3, pH = 0)

cn = 50 fn = 81 m = 48

Default None

Notes This command encodes and prints the Maxi Code symbol data that was saved

in the storage area. The printer uses Reed-Solomon correction to generate a series of error correction codewords.

The printer cannot print a symbol that exceeds the printing area in size.

Printing operation is not processed under the following conditions:

• There is no data. (<Function 280> (fn = 80) on page 91 is not executed)

• The number of numeric characters exceeds 138

• The number of alphanumeric characters exceeds 93

When mode 2 is selected, the primary message does not include the following:

Primary Message Data Number Character

Postal code 1~9 Numeric

ISO country code 1~3 Numeric

Service type code 1~3 Numeric

When mode 3 is selected, the primary message does not include the following:

Primary Message Data Number Character

Postal code 1~6 Setting Code A

ISO country code 1~3 Numeric

Service type code 1~3 Numeric

P1067298-003 Virtual Device-E User Guide 08/28/2018

Page 93

Commands

Virtual Device-E Commands

Modes 2 and 3 are executed according to the following.

• 9-byte data including [)>, RS, 01, GS, and yy are regarded as the Header. (RS and GS indicate MAXI CODE control code while y indicates the 2-byte numeric data.)

• The data that immediately follows the Header is the Primary Message.

• When printing, the Header is placed at the beginning of the Secondary Message.

• When Header data is absent, the data are regarded as Primary Message.

• In the Primary Message, GS is used as the separator that divides message into Postal code, ISO country code, and Class of service. This GS is ignored.

• All data of the Secondary Message is regarded as symbol data.

In modes 4, 5, and 6, the printer regards all of the data in the symbol storage area as Primary Message and Secondary Message.

The following data is automatically added during the encoding process:

• Position sensor pattern

• Position pattern

• Error correction code text

• Mode separator

• Pad code text

08/28/2018 Virtual Device-E User Guide P1067298-003

Page 94

Commands

Virtual Device-E Commands

<Function 367> (fn = 67)

Description

Syntax

ASCII GS ( k pL pH cn fn n Hex 1D 28 6B 03 00 33 43 n Decimal 29 40 107 3 0 51 67 n

Range (pL + pH × 256) = 3 (pL = 3, pH = 0)

Default n = 3

Notes This command sets the Data Matrix Code size. Because a Data Matrix Code

module is square, n = both the module width and the module height.

The settings of this function affect the processing of <Function 381> (fn = 81)

on page 96.

Set the Data Matrix Code Size

GS ( k pL pH cn n

cn = 51 fn = 67 n = 2 to 3

— GS ( k

pL pH cn n

This command remains in effect until one of the following occurs: ESC @ on page 50 is run, the printer defaults are reset, or the printer is power cycled.

P1067298-003 Virtual Device-E User Guide 08/28/2018

Page 95

Commands

Virtual Device-E Commands

<Function 380> (fn = 80)

Description

Syntax

Store the Data Matrix Symbol Data

GS ( k pL pH cn fn m d1...dk

— GS ( k

pL pH cn fn m d1...dk

ASCII GS ( k pL pH cn fn m d1...dk Hex 1D 28 6B pL pH 33 50 30 d1...dk Decimal 29 40 107 pL pH 51 80 48 d1...dk

Range 0 ? (pL + pH × 256) ? 3116 (pL = 0 to 255, pH = 0 to 13)

cn = 51 fn = 80 m = 48 d = 0 to 255 k = (pL + pH × 256) – 3

Default None

Notes This command stores the Data Matrix symbol data in the symbol storage area.

The data stored to the symbol storage area by this command is executed by

<Function 381> (fn = 81) on page 96. The data remains reserved in the symbol

storage area.

This command remains in effect until the following processing is performed:

• Executing <Function 380> (fn = 80) on page 95

• Executing ESC @ on page 50

• The printer defaults are reset, or the printer is power cycled

08/28/2018 Virtual Device-E User Guide P1067298-003

Page 96

Commands

Virtual Device-E Commands

<Function 381> (fn = 81)

Description

Syntax

ASCII GS ( k pL pH cn fn m Hex 1D 28 6B 03 00 33 51 m Decimal 29 40 107 305181m

Range pL + pH × 256) = 3 (pL = 3, pH = 0)

Default None

Notes This command encodes and prints the Data Matrix symbol data saved in the

storage area. The printer uses Reed-Solomon correction to generate a series of error correction codewords.

In Standard mode, this command is available only when the printer is at the beginning of a line or when the print buffer is empty.

Encode and Print Data Matrix Symbol Data

GS ( k pL pH cn fn m

cn = 51 fn = 81 m = 48

— GS ( k

pL pH cn fn m

A symbol exceeding the printing area in size can not be printed.

Printing operation is not processed under the following conditions:

• There is no data. (<Function 380> (fn = 80) on page 95 cannot be executed)

• The number of alphanumeric characters exceeds 2334.

• The number of 8 bit byte characters exceeds 1558.

• The number of numeric characters exceeds 3116.

Data Matrix uses ECC 200 symbols.

The following data is automatically added during the encoding process:

• Position pattern

• Error correction code text

• Mode separator

• Pad code text

In Standard mode, the paper feed amount set by the paper feed setting command does not affect printing of the symbol. The printing position returns to the left side of the printable area after printing the symbol. In Page mode, the printer stores the symbol data in the print buffer without executing actual printing.

P1067298-003 Virtual Device-E User Guide 08/28/2018

Page 97

GS ( E

Commands

Virtual Device-E Commands

Description Set Nonvolatile User Memory Area

Notes GS (E stores the customized values to the nonvolatile user memory area and

uses them for printer operation. The table below explains the functions available in this command.

Format

No.

Purpose

1 GS ( E pL pH fn d1 d2 1 Start the user setting mode

2 GS ( E pL pH fn d1 d2 d3 2 End the user setting mode

(performs a soft reset)

3 GS ( E pL pH fn [a1 b18...b11]...

[ak bk8...bk1]

3 Set value(s) for the memory

switch

4 GS ( E pL pH fn a 4 Transmit the settings of the

memory switch to the host

11 GS ( E pL pH fn a d1...dk 11 Set the communication

conditions for the serial interface

12 GS ( E pL pH fn a 12 Transmit the communication

conditions for the serial interface

pL and pH are used to set the number of bytes that follow pH to (pL + pH × 256).

You must enter the user setting mode to change the items of the nonvolatile user memory. After the user setting mode is terminated (<Function 2> (fn = 2) on page 99), the printer resets its software and restores the initial settings in effect at power on. Receive and print buffers also are cleared.

08/28/2018 Virtual Device-E User Guide P1067298-003

Page 98

Commands

Virtual Device-E Commands

<Function 1> (fn = 1)

Description

Syntax

Start User Setting Mode

GS ( E pL pH fn d1 d2

— GS ( E

pL pH fn d1 d2

ASCII GS ( E pL pH fn d1 d2 Hex 1D 28 45 pL pH fn d1 d2 Decimal 29 40 69 pL pH fn d1 d2

Range (pL + pH × 256) = 3, (pL = 3, pH = 0)

fn = 1 d1 = 73 d2 = 78

Default None

Notes This function enables User Setting mode. Enable this mode before processing

Functions 2 through 12. If User Setting mode is not enabled, those functions are ignored.

Mode change feedback enables the printer to notify that the mode has changed as follows:

Hexadecimal Decimal Number of Data

Header 37H 55 1 byte

Flag 20H 32 1 byte

NUL 00H 0 1 byte

After the printer enters the user setting mode by this command, the printer transmits “mode change feedback” to the host. After confirming that this was sent to the host, send the command to reconfigure the nonvolatile user memory.

This command is effective only in Standard mode.

P1067298-003 Virtual Device-E User Guide 08/28/2018

Page 99

Commands

Virtual Device-E Commands

<Function 2> (fn = 2)

Description

Syntax

End User Setting Mode

GS ( E pL pH fn d1 d2 d3

— GS ( E

pL pH fn d1 d2 d3

ASCII GS ( E pL pH fn d1 d2 d3 Hex 1D 28 45 pL pH fn d1 d2 d3 Decimal 29 40 69 pL pH fn d1 d2 d3

Range (pL + pH × 256) = 4 (pL = 4, pH = 0)

fn = 2 d1 = 79 d2 = 85 d3 = 84

Default None

Notes This command terminates the user setting mode and performs a software

reset. After the reset, the printer resets its software and restores the initial settings in effect at power on.

All changes in settings that are made in user setting mode take effect only after this command is executed.

08/28/2018 Virtual Device-E User Guide P1067298-003

Page 100

100

Commands

Virtual Device-E Commands

<Function 3> (fn = 3)

Description

Syntax

Change Memory Switch Values

GS ( E pL pH fn [a1 b18...b11]...[ak bk8...bk1]

— GS ( E

pL pH fn [a1 b18...b11]...[ak bk8...bk1]

ASCII GS ( E pL pH fn [b18...b11]... [bk8...bk1] Hex 1D 28 45 pL pH fn [b18...b11]... [bk8...bk1] Decimal 29 40 69 pL pH fn [b18...b11]... [bk8...bk1]

Range 10 ? (pL + pH × 256) ? 65535

fn = 3 a = 1, 2, 5, 6, 7, 8 b = 48, 49, 50 k = 1 to 10

Default Varies based on the printer model

Notes This command simultaneously changes Memory Switches (Msw) 1 through 8

to the value specified by b in the following way:

• When b = 48, 49, the corresponding bits are set to Off and On, respectively.

• When b = 50, no change occurs in the memory switch.

Msw Value Function

Settings for memory switch 1

321

1-1~3 48 48 48 Print density 130%

48 48 49 Print density 120%

48 49 48 Print density 110%

48 49 49 Print density 150%

49 48 48 Print density 100%

49 48 49 Print density 140%

49 49 48 Print density 90%

49 49 49 Print density 80%

1-4 48 2-byte character mode not selected

49 2-byte character mode selected

1-5 48 Print speed 90 mm/sec

49 Print speed 50 mm/sec

1-6 48 Reserved

P1067298-003 Virtual Device-E User Guide 08/28/2018