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: www.zebra.com/copyright
WARRANTY: www.zebra.com/warranty
END USER LICENSE AGREEMENT: www.zebra.com/eula
SOFTWARE: www.zebra.com/linkoslegal
Terms of Use
Proprietary Statement
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.
The Virtual Device-L application enables Zebra mobile and tabletop printers to work
with many host systems that are using Labelpoint
changes will be required to the host application. This feature can help customers to
make a smooth transition to Zebra printers and save them the time and expense of
having to rewrite their host software.
Virtual Device-L Features
The Virtual Device-L application:
• Uses existing features of Zebra printers, when available.
• Supports the Bluetooth
• Offers many outline fonts, barcodes, and specific commands and features of
target printer models (see Supported Fonts on page 43).
• Provides support of Labelpoint commands (see Commands on page 33).
®
printers. In most cases, no
®
, Serial, Ethernet, WLAN, and USB interfaces.
P1074583-004Virtual Device-L User Guide08/06/2018
Supported Printers
This manual describes the Virtual Device-L language for Zebra mobile and tabletop
printers and should be used by any person who needs to support that language on
one of the following Zebra printers:
PrinterFirmware
iMZ SeriesV73.19.6Z and later
QLn SeriesV68.19.6Z and later
ZT200 SeriesV72.19.6Z and later
ZT400 SeriesV75.19.7Z and later
ZT510V80.20.02Z and later
ZT600 SeriesV80.20.02Z and later
ZD400 SeriesV77.19.14Z or V84.20.05Z and later
ZD500 SeriesV74.19.6Z and later
ZD600 SeriesV84.20.05Z and later
Introduction
Supported Printers
7
ZQ300 SeriesV81.20.06Z and later
ZQ500 SeriesV76.19.10Z and later
Note • The Virtual Device-L 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 (a/b/g/n)—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/06/2018Virtual Device-L User GuideP1074583-004
Introduction
8
Notes
Notes
• Other command languages are disabled when running Virtual Device-L. However,
Set/Get/Do (SGD) commands and file download all operate properly with
Virtual Device-L enabled.
• Virtual Device-L fonts can only be used with Virtual Device-L commands. They
cannot be used with other languages.
• The Virtual Device-L mode application will not respond to CPCL, ZPL, or EPL
commands. Instead, commands will be processed by the Virtual Device-L
application.
P1074583-004Virtual Device-L User Guide08/06/2018
Install, Register, and
Enable Virtual Device-L
This section provides you with instructions on how to install and enable the
Virtual Device-L application on one or more Zebra printers.
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.
P1074583-004Virtual Device-L User Guide08/06/2018
Downloading the Virtual Device-L Application
Downloading the Virtual Device-L Application
Zebra provides two options to download the Virtual Device-L 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 55.
• 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 www.zebra.com/setup.
Using ZDownloader
The ZDownloader application can update Virtual Device-L files in Zebra printers
connected by Serial, Parallel, USB, and IP Ethernet networks.
Getting Started
11
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/06/2018Virtual Device-L User GuideP1074583-004
Getting Started
12
Downloading the Virtual Device-L 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).
P1074583-004Virtual Device-L User Guide08/06/2018
Getting Started
Downloading the Virtual Device-L Application
To Auto-Detect printers connected via the USB or IP Ethernet interfaces,
perform the following steps:
1. In the ZDownloader toolbar, select Printer > Auto-Detect.
OR
Right-click in the ZDownloader window and select Auto-Detect Printers.
The printers detected are added to the printer list.
13
Manually Add Printers
To manually add printers connected via the Serial, Parallel, or Network
interfaces, perform the following steps:
1. In the ZDownloader toolbar, select Printer > Add….
OR
Right-click in the ZDownloader window and select Add Printer….
The following window appears.
08/06/2018Virtual Device-L User GuideP1074583-004
Getting Started
14
Downloading the Virtual Device-L 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 PrinterGo to Adding a Serial Printer.
Parallel PrinterGo to Adding a Parallel Printer on page 16.
Network PrinterGo to Adding a Network Printer on page 17.
Adding a Serial Printer
4. Select the serial port to which the printer is connected.
P1074583-004Virtual Device-L User Guide08/06/2018
5. Click Port Settings.
The following window appears.
Getting Started
Downloading the Virtual Device-L Application
15
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/06/2018Virtual Device-L User GuideP1074583-004
Getting Started
16
Downloading the Virtual Device-L 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.
P1074583-004Virtual Device-L User Guide08/06/2018
Adding a Network Printer
12. Set Communication Type to Network.
The following window appears.
Getting Started
Downloading the Virtual Device-L Application
17
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/06/2018Virtual Device-L User GuideP1074583-004
Getting Started
18
Downloading the Virtual Device-L Application
2. In the toolbar, select Printer > Modify Printer….
OR
Right-click on the printer and select Modify Printer….
The printer settings for the selected printer are displayed.
3. Modify the settings as desired.
4. Click OK to save the settings.
Deleting Printers from the List
To delete printers from the list, perform the following steps:
1. Select one or more printers to delete.
P1074583-004Virtual Device-L User Guide08/06/2018
Downloading the Virtual Device-L Application
2. In the toolbar, select Printer > Delete.
OR
Right-click on one of the selected printers and select Delete Printer(s).
The printer is removed from the list.
Getting Started
19
Downloading the Virtual Device App to Selected Printers
To download the Virtual Device-L 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/06/2018Virtual Device-L User GuideP1074583-004
Getting Started
20
Downloading the Virtual Device-L 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-L app file. To
select multiple printers, hold down the Ctrl or Shift key, and then click on the
desired printers.
2. In the toolbar, select File > Select Firmware File….
OR
Right-click on one of the selected printers and select Select Firmware File….
3. Navigate to the Virtual Device app file that you acquired previously.
4. Click Open.
The file that you selected appears under Download File for the selected printers.
Printers that are present in the list but that do not have a file selected will be
ignored when Downloading starts.
P1074583-004Virtual Device-L User Guide08/06/2018
Getting Started
Downloading the Virtual Device-L Application
5. Start the download process by doing one of the following:
•Select Printer > Download to Selected.
•Select the printer(s) of interest and select the Printer and then select
Download To Selected.
6. In the toolbar, select Printer > Download All.
OR
Right-click in the ZDownloader window and select Download All.
After downloading has begun, the progress of each printer will be shown in the
Download Status column.
21
Canceling a Download in Progress
The Cancel Download toolbar button and the Printer > Cancel Download menu
options become active when the files are downloading.
To cancel downloading to ALL printers in the list, perform the following step:
1. Click Printer > Cancel Download.
OR
Right-click in the ZDownloader window and select Cancel Download.
To cancel downloading to SPECIFIC printers in the list, perform the following step:
1. Select one or more printers with a download in progress.
2. Click Printer > Cancel Download.
OR
Right-click on a selected printer and select Cancel Download.
08/06/2018Virtual Device-L User GuideP1074583-004
Getting Started
22
Registering the Virtual Device
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.
P1074583-004Virtual Device-L User Guide08/06/2018
Enabling the Virtual Device
You can enable Virtual Device-L 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-L on your printer, send the following command:
! U1 setvar "apl.enable" "apl-l"
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 41.
Getting Started
Enabling the Virtual Device
23
Using the User Menus
This section includes instructions for the following printers:
• QLn420 Printers on page 24
• QLn320 and QLn220 Printers on page 27
• ZT230, ZT400 Series, ZT510, ZT600 Series, ZD500 Series, and ZD600 Series
Printers on page 30
If necessary, refer to the User Guide for your printer for additional information about
your printer’s control panel.
08/06/2018Virtual Device-L User GuideP1074583-004
Getting Started
PRINTER READY
VXXXXXXX
SETTINGS
LANGUAGE
24
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.
P1074583-004Virtual Device-L User Guide08/06/2018
3. Press the OK button.
LANGUAGE
▼ENGLISH▲
VIRTUAL DEVICE
▼NONE▲
The printer displays the LANGUAGE selection screen.
Getting Started
Enabling the Virtual Device
25
4. Use the LEFT or RIGHT ARROW to navigate to the VIRTUAL DEVICE selection
screen.
08/06/2018Virtual Device-L User GuideP1074583-004
Getting Started
VIRTUAL DEVICE
▼APL-L▲
USE
26
Enabling the Virtual Device
5. Use the UP or DOWN ARROW to scroll to the APL-L option.
6. Press the RIGHT SOFT KEY to select USE.
The printer restarts and uses the Virtual Device that you selected.
P1074583-004Virtual Device-L User Guide08/06/2018
QLn320 and QLn220 Printers
Zebra QLn320
FW ver:XXXXXXXXXX
Baud Rate:115200
Batteryok
IP Addr:10.14.205.138
Menu
CommunicationBack
SettingsBack
1. From the printer’s idle display screen, press the LEFT SOFT KEY to select the
Home icon.
Getting Started
Enabling the Virtual Device
27
The printer displays the Home Menu.
2. Use the ARROWS to navigate to the SETTINGS menu.
08/06/2018Virtual Device-L User GuideP1074583-004
Getting Started
Virtual Dev: none ▲▼
MenuUseBack
Virtual Dev: apl‐l ▲? ▼
MenuUseBack
28
Enabling the Virtual Device
3. Press the OK button.
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-L
option.
P1074583-004Virtual Device-L User Guide08/06/2018
6. Press the LEFT ARROW to highlight APL-L
7. Press OK to select USE.
The printer restarts and uses the Virtual Device that you selected.
Getting Started
Enabling the Virtual Device
29
08/06/2018Virtual Device-L User GuideP1074583-004
Getting Started
PRINTER READY
VXXXXXXX
HOME MENU
SETTINGS
30
Enabling the Virtual Device
ZT230, ZT400 Series, ZT510, ZT600 Series, ZD500 Series, and ZD600 Series
Printers
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.
P1074583-004Virtual Device-L User Guide08/06/2018
2. Use the ARROWS to navigate to the LANGUAGE menu.
HOME MENU
SETTINGS
▼
LANGUAGE
ENGLISH
▲
Getting Started
Enabling the Virtual Device
31
3. Press the OK button.
The printer displays the LANGUAGE selection screen.
08/06/2018Virtual Device-L User GuideP1074583-004
Getting Started
▼
VIRTUAL DEVICE
NONE
▲
▼
VIRTUAL DEVICE
APL-L
▲
USE
32
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-L option.
P1074583-004Virtual Device-L User Guide08/06/2018
6. Press the RIGHT SOFT KEY or OK to select USE.
▼
VIRTUAL DEVICE
APL-L
▲
USE
Getting Started
Enabling the Virtual Device
33
The printer restarts and uses the Virtual Device that you selected.
08/06/2018Virtual Device-L User GuideP1074583-004
Commands
This section provides a listing of commands for use on your Zebra printer with the
Virtual Device-L app.
In the following commands, the parameters shown in carets < > are required while
those shown in brackets [ ] are optional.
SyntaxCommand Function
Command Summary
Supported
(X)
!CClear the label layoutX
!D D SDocument start—
!D D EDocument end—
!D T MTurn off automatic cutter
—
mode
!D T ATurn on automatic cutter
—
mode
!D T TExecute a cut when in
—
manual cutting mode
!D L 0Turn off the take-label
—
sensor
!D L 1Turn on the take-label
—
sensor
!K <n>Feed out n/10 mm of
—
paper
!L G "<name>"Load the specified
X
graphics file
!L M "<name>"Load the specified macroX
!LTerminate loadingX
!M "<name>"Execute the specified
X
macro
!N<n> <v> <i> <w> <u>Initialize the countersX
!P <n>PrintX
!p <n>Dormant print (printkey
—
mode)
!RClearing variable
X
information
!S <n>Status requestX
!W <n> "<data>"Changing a single variableX
P1074583-004Virtual Device-L User Guide08/06/2018
Commands
Table of Supported Commands
35
SyntaxCommand Function
Label Layout Definition Commands
Format 1
Scalable text fieldX
Supported
(X)
!F S <u> <b> <p> <a> <h> <s> <f> [wa] <"text">
Format 2
!F S <u> <b> <p> <a> <h> <w> <f> [s] <"text">
!F T <u> <b> <p> <a> <h> <w> <f> <”text”>Bitmap text field
(deprecated)
!F C <u> <b> <p> <a> <h> <w> <s> [d] <”text”> Defining a barcode fieldX
!F C <u> <b> <p> <a> <h> <w> <o> [d] <”text”> Defining a 2D barcode
field
Format 1
Defining a line/box fieldX
!F B <u> <b> <p> <a> <h> <w> <b>
Format 2
!F B D <y0> <x0> <lw> <y1> <x1>
!F G <u> <b> <p> <a> <h> <w> <"name"> Defining a graphics fieldX
Service Commands
X
X
!V 9 [m]Return software revision
level
!V11Return software dateX
!V12Return label countX
!V13Return available dynamic
RAM (in bytes)
!V16Return PROM numberX
!V17Return total paper
movement (in meters)
!V19Return available file
system memory (in bytes)
!V20 <hh:mm:ss>Set the time on the
printer’s clock
!V21 <yy‐mm‐dd>
or
Set the date on the
printer’s clock
!V21 <yyyy‐mm‐dd>
!V22 [m]Return printer date and
time
!V23 <m>Return the font numberX
X
X
X
X
X
X
X
!V24 <"name">Return logo informationX
!V25 <m>Return information about
X
the logo specified
08/06/2018Virtual Device-L User GuideP1074583-004
Commands
36
Table of Supported Commands
SyntaxCommand Function
!V26 <"name">Display the content of a
macro
!V31Return the length of the
last paper movement (in
1/10 mm)
!V32 <m>Return the current state of
the specified counter
!V33Return the number of
failing dots on the
printhead
!V34 <m>Return the position of
failing dots identified by
service command 33
!V39Return the number of
dormant printouts since
the last !p<n> command
!V40 <m>Return the bitmap font
number, where <m> is the
physical number of the
font, not the mapped
number
Supported
(X)
X
X
X
X
X
X
X
!V44Automatically set the
sensitivity of the paper
sensor
!V45Set the default character
spacing for all bitmap fonts
!V48 <m>Return information on the
specified printer file
system
!V61 <s> [r] [c]Set security level for
PDF417
!V63Return the printer serial
number
!V80 <m>Show typeface by index
<m>
!V81 <m>Show typeface by index
<m>
!V93 [m]Return number of dormant
printouts
!V100Set the network IP
address
X
—
—
X
X
X
—
—
X
!V101Return the network IP
X
address
P1074583-004Virtual Device-L User Guide08/06/2018
Commands
Table of Supported Commands
37
SyntaxCommand Function
Supported
(X)
!V102 <a>.<b>.<c>.<d>Set the network IP maskX
!V103Return the network IP
X
mask
!V104 <"host">Set the network host nameX
!V105Return the network host
X
name
!V106 <"m">Set the domain name—
!V107Return the domain name—
!V108 [m]Return any DHCP
X
information received from
the DHCP server
!V109Get MAC addressX
!V110 <a>.<b>.<c>.<d>Set the network default
X
gateway
!V111Return the network default
X
gateway
!V114Return the serial number
—
of an RFID tag
!V115Set a login script—
!V116Return a login script—
!V117Return the active portX
!V120Return the printer modelX
!V3194 [m]Delete specified macro,
X
graphic, or font from the
printer. If not specified, all
files are deleted.
!V3196Restart the printerX
!V3200Reset all printer
X
parameters to their
defaults
!V3201Disconnect port—
!V3209 <m>In Setup mode, set
—
password for web server
!V35183Enter User mode—
!V38153Enter Setup mode—
Printer Configuration Commands
!Y2 <n>Print speedX
!Y3 <n>Barcode speed—
!Y4 <n>Blank feed speed—
08/06/2018Virtual Device-L User GuideP1074583-004
Commands
38
Table of Supported Commands
SyntaxCommand Function
Supported
(X)
!Y5 <n>Printhead type—
!Y6Number of dots per mm of
—
printhead
!Y7 <n>Motor steps per mm—
!Y8 <n>Printhead width in dotsX
!Y9 <n>Dot mode—
!Y10Manufacturing date—
!Y16 <n>Force DTX
!Y20 <n>Photosensor threshold
—
level
!Y21 <n>Photosensor current level—
!Y23 <n>Maximum paper feed
X
length (in 1/10 mm)
!Y24 <n>Dispensing feed (in
X
1/10 mm)
!Y25 <n>COM2 baud rate—
!Y26 <n>COM2 parity—
!Y27 <n>COM2 word length—
!Y28 <n>COM2 stop bits—
!Y29 <n>COM2 input buffer sizeX
!Y30 <n>COM1 baud rateX
!Y31 <n>COM1 parityX
!Y32 <n>COM1 word lengthX
!Y33 <n>COM1 stop bitsX
!Y34 <n>COM1 input buffer size—
!Y35 <n>Character set, supported
X
code pages
!Y36 <n>ASCII code of the
X
command character
!Y39 <n>LTS enableX
!Y40 <n>Minimum paper length to
X
feed during a print cycle
!Y42 <n>Printing of bar code
X
interpretation
!Y44 <n>Alternate end-of-line
X
(EOL) character
!Y45 <n>Disable CR as end-of-lineX
!Y46 <n>Strobe time—
P1074583-004Virtual Device-L User Guide08/06/2018
Commands
Table of Supported Commands
39
SyntaxCommand Function
Supported
(X)
!Y50 <n>Silent mode—
!Y62 Printer production year—
!Y63Printer serial number—
!Y66 <n>Enable application—
!Y67 <n>Printkey mode—
!Y68 <n>Horizontal print position
X
adjustment (in 1/10 mm
increments)
!Y69 <n>Vertical print position
X
adjustment (in 1/10 mm
increments)
!Y72 <n> to !Y79 <n>Map physical font to
—
logical number
!Y89 <n>Allow command character
X
anywhere on the line
!Y92 <n>Stacked printers mode
—
(daisy chaining)
!Y93 <n>LTS auto repeat—
!Y100 <n>Automatically reverse
—
paper feed before printing
!Y101 <n> to !Y106 <n>Set the intercharacter
X
spacing for the specified
bitmap font
!Y132 <n>Enable mapping of
—
barcode information
!Y134 <n>Enable a recover page—
!Y136 <n>Set PDF417 code security
X
level
!Y137 <n>Set maximum number of
X
columns for PDF417
!Y138 <n>Set maximum number of
X
rows for PDF417
!Y145 <n>Set timeout valueX
!Y146 <n>Set line spacing, based on
X
a percentage of the font
height
!Y150 <n>COM1 communication
—
mode
!Y151 <n>COM1 TCP port—
08/06/2018Virtual Device-L User GuideP1074583-004
Commands
40
Table of Supported Commands
SyntaxCommand Function
!Y152 <n>COM2 communication
Supported
(X)
—
mode
!Y153 <n>COM1 TCP port—
!Y156 <n>COM1 flow controlX
!Y157 <n>COM2 flow control—
!Y162 <n>Enable reverse video
X
mode for text fields
!Y167 <n>Set sensor typeX
!Y168 <n>Set historic control—
!Y170 <n>Sensor detect—
!Y178 <n>Set maximum label width
X
(in 1/10 mm increments)
!Y179 <n>Set maximum label height
X
(in 1/10 mm increments)
!Y180 <n>Specify raw data port
X
number
!Y185 <n>Update best-before date
X
update day
!Y186 <n>Update best-before date
truncation day
X
P1074583-004Virtual Device-L User Guide08/06/2018
Set/Get/Do (SGD) Commands
The following SGD commands were added for use with your Virtual Device app. For
more detailed information on SGD commands, see the Programming Guide for
®
ZPL II
Guide).
apl.enable
Description This command enables or disables a Virtual Device app.
Note •
•ZPL and CPCL may not function normally when a Virtual Device app is enabled.
•You must restart the printer after changing the value of apl.enable.
Type setvar
CommandsDetails
, ZBI 2, Set/Get/Do, Mirror, and WML (formerly the ZPL II Programming
Commands
Set/Get/Do (SGD) Commands
41
setvar
apl.version
This command instructs the printer to enable a virtual device.
Format: ! U1 setvar "apl.enable" "value"
Values:
"apl-l" = enable Virtual Device-L
"none" = disable any Virtual Device app (ZPL and CPCL function normally)
Example 1 • This example shows how to enable the Virtual Device-L app:
! U1 setvar "apl.enable" "apl-l"
Example 2 • This example shows how to disable the Virtual Device-L app:
! U1 setvar "apl.enable" "none"
Description This command returns the version of the currently running Virtual
Device app.
Type getvar
CommandsDetails
getvarFormat: ! U1 getvar "apl.version"
08/06/2018Virtual Device-L User GuideP1074583-004
Commands
42
Set/Get/Do (SGD) Commands
apl.framework_version
Description This command returns the level of support for Virtual Devices in the
printer operating system.
Type getvar
CommandsDetails
getvarFormat: ! U1 getvar "apl.framework_version"
P1074583-004Virtual Device-L User Guide08/06/2018
Supported Fonts
This section provides you with examples of the fonts available on the Zebra printers
with Virtual Device-L.
08/06/2018Virtual Device-L User GuideP1074583-004
Supported Fonts
44
FontExamples
1Standard
Table 1 • Supported Fonts
Code Page 850Code Page 852
Code Page 1143 StandardCode Page 1143 Special
Code Page 1252
P1074583-004Virtual Device-L User Guide08/06/2018
FontExamples
2Standard
Code Page 850Code Page 852
Table 1 • Supported Fonts (Continued)
Supported Fonts
45
Code Page 1143 StandardCode Page 1143 Special
08/06/2018Virtual Device-L User GuideP1074583-004
Supported Fonts
46
FontExamples
2
Table 1 • Supported Fonts (Continued)
Code Page 1252
P1074583-004Virtual Device-L User Guide08/06/2018
FontExamples
3Standard
Code Page 850Code Page 852
Table 1 • Supported Fonts (Continued)
Supported Fonts
47
Code Page 1143 StandardCode Page 1143 Special
08/06/2018Virtual Device-L User GuideP1074583-004
Supported Fonts
48
FontExamples
5Standard
Table 1 • Supported Fonts (Continued)
Code Page 850Code Page 852
Code Page 1143 StandardCode Page 1143 Special
P1074583-004Virtual Device-L User Guide08/06/2018
FontExamples
6Standard
Code Page 850Code Page 852
Table 1 • Supported Fonts (Continued)
Supported Fonts
49
Code Page 1143 StandardCode Page 1143 Special
08/06/2018Virtual Device-L User GuideP1074583-004
Supported Fonts
50
Table 1 • Supported Fonts (Continued)
FontExamples
24455 StandardCode Page 850
Code Page 852Code Page 1143 Standard
Code Page 1143 SpecialCode Page 1152
P1074583-004Virtual Device-L User Guide08/06/2018
FontExamples
94021 Standard
Code Page 850Code Page 852
Table 1 • Supported Fonts (Continued)
Supported Fonts
51
Code Page 1143 StandardCode Page 1143 Special
08/06/2018Virtual Device-L User GuideP1074583-004
Supported Fonts
52
FontExamples
94023 Standard
Table 1 • Supported Fonts (Continued)
Code Page 850Code Page 852
Code Page 1143 StandardCode Page 1143 Special
P1074583-004Virtual Device-L User Guide08/06/2018
FontExamples
94029 Standard
Code Page 850Code Page 852
Table 1 • Supported Fonts (Continued)
Supported Fonts
53
Code Page 1143 Standard
[
08/06/2018Virtual Device-L User GuideP1074583-004
Code Page 1143 Special
Supported Fonts
54
Table 1 • Supported Fonts (Continued)
FontExamples
94030 StandardCode Page 850
Code Page 852Code Page 1143
Code Page 1252 StandardCode Page 8859
P1074583-004Virtual Device-L User Guide08/06/2018
ZDownloader Utility
This section provides you with the instructions for downloading and installing the
ZDownloader Utility.