Virtual Device-Ax
User Guide
P1079049-003
© 2018 ZIH Corp. All rights reserved. ZEBRA and the stylized Zebra head are trademarks of ZIH Corp.,
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
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.
Part Number: P1079049-003 Rev. A
Contents
2 • Contents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
1 • Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Virtual Device-Ax Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Supported Printers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Configuring Network Connectivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
2 • Install, Register, and Enable Virtual Device-Ax . . . . . . . . . . . . . . . . . . . . . . . 9
Acquiring the Virtual Device Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Downloading the Virtual Device-Ax Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Adding Printers to the ZDownloader List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Modifying Printers in the List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Deleting Printers from the List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Downloading the Virtual Device App to Selected Printers . . . . . . . . . . . . . . . . . . . . . 19
Canceling a Download in Progress . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Registering the Virtual Device . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
ZDownloader Log File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Enabling the Virtual Device . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Using an SGD Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Using the User Menus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
3 • Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
Table of Supported Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
Set/Get/Do (SGD) Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
apl.enable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
apl.version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
apl.framework_version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
08/28/2018 Virtual Device-Ax User Guide P1079049-003
Contents
4
4 • Supported Fonts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
Supported Fonts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
5 • ZDownloader Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
Downloading the ZDownloader Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
Installing the ZDownloader Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
1 • Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
P1079049-003 Virtual Device-Ax User Guide 08/28/2018
Introduction
This section describes the features and functions of a Zebra printer that is running the
Virtual Device-Ax application.
Contents
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Virtual Device-Ax Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Virtual Device-Ax Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Configuring Network Connectivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
08/28/2018 Virtual Device-Ax User Guide P1079049-003
Introduction
6
Overview
Overview
The Virtual Device-Ax application enables Zebra Link-OS printers to work with many
host systems that are using Datamax-O’Neil Apex 3 or Apex 4 printers. In most cases,
no 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-Ax Features
The Virtual Device-Ax 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 and specific commands and features of target printer
models (see Supported Fonts on page 42).
®
, Serial, Ethernet, WLAN, and USB interfaces.
• Provides support of Datamax-O’Neil commands (see Commands on page 34).
P1079049-003 Virtual Device-Ax User Guide 08/28/2018
Supported Printers
This manual describes the Virtual Device-Ax 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
7
ZQ300 Series V81.20.06Z and later
ZQ500 Series V76.19.10Z and later
Note • The Virtual Device-Ax 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-Ax User Guide P1079049-003
Introduction
8
Notes
Notes
• Other command languages are disabled when running Virtual Device-Ax.
However, Set/Get/Do (SGD) commands and file download all operate properly
with Virtual Device-Ax enabled.
• Virtual Device-Ax fonts can only be used with Virtual Device-Ax commands. They
cannot be used with other languages.
• The Virtual Device-Ax mode application will not respond to CPCL, ZPL, or EPL
commands. Instead, commands will be processed by the Virtual Device-Ax
application.
P1079049-003 Virtual Device-Ax User Guide 08/28/2018
Install, Register, and
Enable Virtual Device-Ax
This section provides you with instructions on how to install and enable the
Virtual Device-Ax application on one or more Zebra printers.
Contents
Acquiring the Virtual Device Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Downloading the Virtual Device-Ax Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Using ZDownloader . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Adding Printers to the ZDownloader List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Auto-Detect Printers. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Manually Add Printers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Modifying Printers in the List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Deleting Printers from the List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Downloading the Virtual Device App to Selected Printers . . . . . . . . . . . . . . . . . . . . 19
Registering the Virtual Device . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Enabling the Virtual Device . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Using an SGD Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Using the User Menus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
QLn420 Printers. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
QLn320 and QLn220 Printers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Supported ZTxxx and ZDxxx Printers with a Display. . . . . . . . . . . . . . . . . . . . . . . . 30
08/28/2018 Virtual Device-Ax User Guide P1079049-003
Getting Started
10
Acquiring the Virtual Device Application
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.
P1079049-003 Virtual Device-Ax User Guide 08/28/2018
Downloading the Virtual Device-Ax Application
Downloading the Virtual Device-Ax Application
Zebra provides two options to download the Virtual Device-Ax 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 45.
• 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-Ax 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/28/2018 Virtual Device-Ax User Guide P1079049-003
Getting Started
12
Downloading the Virtual Device-Ax 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).
P1079049-003 Virtual Device-Ax User Guide 08/28/2018
Getting Started
Downloading the Virtual Device-Ax 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/28/2018 Virtual Device-Ax User Guide P1079049-003
Getting Started
14
Downloading the Virtual Device-Ax 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 16.
Network Printer Go to Adding a Network Printer on page 17.
Adding a Serial Printer
4. Select the serial port to which the printer is connected.
P1079049-003 Virtual Device-Ax User Guide 08/28/2018
5. Click Port Settings.
The following window appears.
Getting Started
Downloading the Virtual Device-Ax 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/28/2018 Virtual Device-Ax User Guide P1079049-003
Getting Started
16
Downloading the Virtual Device-Ax 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.
P1079049-003 Virtual Device-Ax User Guide 08/28/2018
Adding a Network Printer
12. Set Communication Type to Network.
The following window appears.
Getting Started
Downloading the Virtual Device-Ax 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/28/2018 Virtual Device-Ax User Guide P1079049-003
Getting Started
18
Downloading the Virtual Device-Ax 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.
P1079049-003 Virtual Device-Ax User Guide 08/28/2018
Downloading the Virtual Device-Ax 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-Ax 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-Ax User Guide P1079049-003
Getting Started
20
Downloading the Virtual Device-Ax 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-Ax 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.
P1079049-003 Virtual Device-Ax User Guide 08/28/2018
Getting Started
Downloading the Virtual Device-Ax 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/28/2018 Virtual Device-Ax User Guide P1079049-003
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.
P1079049-003 Virtual Device-Ax User Guide 08/28/2018
Enabling the Virtual Device
You can enable Virtual Device-Ax 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-Ax on your printer, send the following command:
! U1 setvar "apl.enable" "apl-ax"
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 40.
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
• Supported ZTxxx and ZDxxx Printers with a Display on page 30
If necessary, refer to the User Guide for your printer for additional information about
your printer’s control panel.
08/28/2018 Virtual Device-Ax User Guide P1079049-003
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.
P1079049-003 Virtual Device-Ax User Guide 08/28/2018
3. Press OK.
LANGUAGE
▼ ENGLISH ▲
VIRTUAL DEVICE
▼ NONE ▲
The printer displays the LANGUAGE selection screen.
Getting Started
Enabling the Virtual Device
25
4. Use the LEFT or RIGHT ARROW to navigate to the VIRTUAL DEVICE selection
screen.
08/28/2018 Virtual Device-Ax User Guide P1079049-003
Getting Started
VIRTUAL DEVICE
▼ APL-AX ▲
USE
26
Enabling the Virtual Device
5. Use the UP or DOWN ARROW to scroll to the APL-Ax option.
6. Press the RIGHT SOFT KEY to select USE.
The printer restarts and uses the Virtual Device that you selected.
P1079049-003 Virtual Device-Ax User Guide 08/28/2018
QLn320 and QLn220 Printers
Zebra QLn320
FW ver: XXXXXXXXXX
Baud Rate: 115200
Battery ok
IP Addr: 10.14.205.138
Menu
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
27
The printer displays the Home Menu.
2. Use the ARROWS to navigate to the SETTINGS menu.
08/28/2018 Virtual Device-Ax User Guide P1079049-003
Getting Started
Virtual Dev: none ▲▼
Menu Use Back
Virtual Dev: apl‐ax ▲? ▼
Menu Use Back
28
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-Ax
option.
P1079049-003 Virtual Device-Ax User Guide 08/28/2018
6. Press the LEFT ARROW to highlight APL-Ax
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/28/2018 Virtual Device-Ax User Guide P1079049-003
Getting Started
PRINTER READY
VXXXXXXX
HOME MENU
SETTINGS
30
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.
P1079049-003 Virtual Device-Ax User Guide 08/28/2018
2. Use the ARROWS to navigate to the LANGUAGE menu.
HOME MENU
SETTINGS
▼
LANGUAGE
ENGLISH
▲
Getting Started
Enabling the Virtual Device
31
3. Press OK.
The printer displays the LANGUAGE selection screen.
08/28/2018 Virtual Device-Ax User Guide P1079049-003
Getting Started
▼
VIRTUAL DEVICE
NONE
▲
▼
VIRTUAL DEVICE
APL-AX
▲
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-Ax option.
P1079049-003 Virtual Device-Ax User Guide 08/28/2018
6. Press the RIGHT SOFT KEY or OK to select USE.
▼
VIRTUAL DEVICE
APL-AX
▲
USE
Getting Started
Enabling the Virtual Device
33
The printer restarts and uses the Virtual Device that you selected.
08/28/2018 Virtual Device-Ax User Guide P1079049-003
Commands
This section provides a listing of commands for use on your Zebra printer with the
Virtual Device-Ax app.
Contents
Table of Supported Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
Set/Get/Do (SGD) Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
08/28/2018 Virtual Device-Ax User Guide P1079049-003
Table of Supported Commands
For more information about the commands, refer to the documentation that came with
your printer.
Commands
Table of Supported Commands
35
Syntax Command Function
Communications
EOT End of Transmission/Print Buffer
Contents
XON Transmitter ON —
XOFF Transmitter OFF —
Character Sets
ESC F n Select Character Set
ESC K n CR Select Character Pitch: Mode 1
ESC kn Select Character Pitch: Mode 2
SO Double Wide ON —
SI Double Wide OFF —
FS Double High ON —
GS Double High OFF —
ESC a n Set Text Line Spacing
Supported
(
✓ )
✓
✓
✓
✓
✓
Notes
Fonts 2, 4, 5, 7, 12, 13,
and 15 are supported.
Fonts 2, 4, and 5 are
supported.
Character Attributes
ESC U n
n = 0 or 1 Emphasized Printing Mode (Bold)
n = U or u Underline Printing Mode
n = R or n Reverse Print —
ESC F n Right to Left and Left to Right
Printing
Horizontal Position
CR Carriage Return —
BS Backspace —
HT Horizontal Tab —
ESC T H n Set Horizontal Tab Width
✓
✓
—
✓
08/28/2018 Virtual Device-Ax User Guide P1079049-003
Commands
36
Table of Supported Commands
Syntax Command Function
Vertical Position
LF Line Feed —
ESC J n Variable Size Line Feed
ESC Q J n Variable Size Reverse Line Feed
VT Vertical Tab —
ESC T V n Set Vertical Tab Height
FF Form Feed —
ESC T F n1 n2 Set Form Feed Length in Dot
Lines
Bar Codes
ESC z t n h data CR LFPrint Barcode
ESC Z t n h data CR LFPrint Barcode with Human
Readable Text
ESC z h n Barcode Height Multiplier
Graphics
Supported
(
✓ )
✓
✓
✓
✓
✓
✓
✓
Notes
ESC V n1 n2 data 8-Bit Graphics —
ESC v h w counter
8-Bit Compressed Graphics
data
Printer Controls—Data Processing
ESC P $ Enable Buffer Mode
ESC P # Disable Buffer Mode
EOT Print Buffer Contents
ESC P + Enable EOT Control Character
Transmission
ESC P ‐ Disable EOT Control Character
Transmission
Printer Controls—Printed Output Adjust
ESC P n Print Contrast —
Printer Controls—Reset
CAN Cancel —
ESC @ Reset Printer and Load Default
Setup
✓
✓
✓
✓
—
—
✓
Consumed but not
processed
P1079049-003 Virtual Device-Ax User Guide 08/28/2018
Commands
Table of Supported Commands
37
Syntax Command Function
Printer Controls—Power
ESC M n m 0 CR Auto Power Down Command
ESC M HH MM SS 0 CR Extended Auto Power Down
Command
Printer Status
STX Query Print Buffer and Timer-
MCR Status
SYN Query Print Buffer, Battery
Voltage, Timer-MCR, and
Printhead Temperature
ESC P ^ Print Battery Voltage —
ESC P ( Query Printer Firmware Version —
ESC P ) Query Printer Model and
Hardware Revision Level
Magnetic Card Reader
ESC M n1 n2 t (CR)
Read Magnetic Card Data
ESC m n1 n2 t (CR)
Supported
(
✓ )
✓
✓
✓
—
—
✓
Notes
ESC C Cancel Magnetic Card Data Read
Command
Black Mark Sensing Control
ESC Q Q n CR Set Paper-Out Sensitivity
ESC Q R CR Enable Black Mark Reporting
ESC Q r CR Disable Black Mark Reporting
Black Mark Sensing Command Mode
ESC Q F n CR Forward Seek Black Mark
ESC Q B n CR Reverse Seek Black Mark
ESC Q ? ? n1 n2 Black Mark Found (response from
printer)
ESC Q 0 0 n1 n2 Black Mark Not Found (response
from printer)
—
✓
✓
✓
✓
✓
✓
✓
08/28/2018 Virtual Device-Ax User Guide P1079049-003
Commands
38
Table of Supported Commands
Syntax Command Function
Black Mark Sensing Auto Mode
ESC Q f e CR Enable Front Black Mark Sensor
ESC Q f d CR Disable Front Black Mark Sensor
ESC Q b e CR Enable Back Black Mark Sensor
ESC Q b d CR Disable Back Black Mark Sensor
ESC Q f x CR
ESC Q b x CR
ESC Q D + n
ESC Q P n
Disable Both Front and Back
Black Mark Sensors
Printed Receipt/Label Presenter
Positive Adjust
ESC Q D ‐ n Printed Receipt/Label Presenter
Negative Adjust
ESC Q n1n2 Advance n1n2 from Q mark
(Line Print mode emulation only)
Page Print Commands—Configuration
ESC P P Enter Page Printing Mode
BeginPage(); Mark Beginning of a Page
SetPageSize (w,h); Define the Page Size
SetMargin (lm,tm) Set Margins
EndPage(); Mark Page End, Print, and Exit
Supported
(
✓ )
✓
✓
✓
✓
✓
✓
✓
✓
✓
✓
✓
✓
✓
Notes
Page Print Commands—Draw Commands
DrawText (x,y,
Draw Text
color, angle,
"string");
DrawRectange
Draw Rectangle
(x1,y1,x2,y2,
color,width);
DrawBarcode
Draw Barcode
(x,y,angle,
annotate,
type,height,
"data");
Download—Printer Default Setup
ESC D S Select Setup Download Mode
ESC S L Start Default Download Process —
ESC S T 0xFF CR Stop Download Process —
ESC S B CR Store In Flash Default Setup Data —
✓
• Angle parameter is
consumed but not
processed
• Setting Font with
<f=value> within
"string" is supported
✓
✓
✓
P1079049-003 Virtual Device-Ax User Guide 08/28/2018
Commands
Table of Supported Commands
39
Syntax Command Function
Download—Self Test Message Hardware Information
Supported
(
✓ )
ESC D S Select Setup Download Mode —
ESC S I Start Hardare Information Process
Download
ESC S T 0xFF CR Stop Download Process —
ESC S B CR Store In Flash Default Setup Data —
ESC L g 8 Print Hardware Information —
Download—Logo
ESC D L CR LF Select Logo Download Mode —
ESC L G n CR LF Select Logo Download Memory
Location
ESC L G 0xFF CR LF Stop Logo Download Process —
ESC L g n Print Logo —
Download—Fonts
ESC D F CR Enable Font Downloading —
Notes
—
—
ESC F I CR
Display Tables Information —
ESC D I CR
ESC F X Disable Font Download Mode —
ESC F S m t k f CR Display Font Download Current
Settings
ESC F P m t k f CR Set Font Download Parameters —
ESC F M m CR Select Load Operating Mode —
ESC F F f CR Select Font Row —
ESC F K k CR Select Font Column —
ESC F L t CR Select File Type —
ESC F B CR Save Font File in Flash —
Bluetooth and Wifi Setup Commands
ESC P U n1 U n2
T t0 t1 t2 (CR)
Emulation
Select Pass-Thru Command
Mode
ESC E n Select Emulation
—
—
✓
08/28/2018 Virtual Device-Ax User Guide P1079049-003
Commands
40
Set/Get/Do (SGD) Commands
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
Commands Details
, ZBI 2, Set/Get/Do, Mirror, and WML (formerly the ZPL II Programming
setvar
apl.version
This command instructs the printer to enable a virtual device.
Format: ! U1 setvar "apl.enable" "value"
Values:
"apl-ax" = enable Virtual Device-Ax
"none" = disable any Virtual Device app (ZPL and CPCL function normally)
Example 1 • This example shows how to enable the Virtual Device-Ax app:
! U1 setvar "apl.enable" "apl-ax"
Example 2 • This example shows how to disable the Virtual Device-Ax app:
! U1 setvar "apl.enable" "none"
Description This command returns the version of the currently running Virtual
Device app.
Type getvar
Commands Details
getvar Format: ! U1 getvar "apl.version"
P1079049-003 Virtual Device-Ax User Guide 08/28/2018
apl.framework_version
Description This command returns the level of support for Virtual Devices in the
printer operating system.
Type getvar
Commands Details
getvar Format: ! U1 getvar "apl.framework_version"
Commands
Set/Get/Do (SGD) Commands
41
08/28/2018 Virtual Device-Ax User Guide P1079049-003
Supported Fonts
This section provides you with examples of the fonts available on the Zebra printers
with Virtual Device-Ax.
Contents
Supported Fonts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
08/28/2018 Virtual Device-Ax User Guide P1079049-003
Supported Fonts
Table 1 • Supported Fonts
Supported Fonts
Supported Fonts
43
08/28/2018 Virtual Device-Ax User Guide P1079049-003
Supported Fonts
44
Supported Fonts
Table 1 • Supported Fonts (Continued)
P1079049-003 Virtual Device-Ax User Guide 08/28/2018
ZDownloader Utility
This section provides you with the instructions for downloading and installing the
ZDownloader Utility.
Contents
Downloading the ZDownloader Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
Installing the ZDownloader Utility. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
08/28/2018 Virtual Device-Ax User Guide P1079049-003
ZDownloader Utility
46
Downloading the ZDownloader Utility
Downloading the ZDownloader Utility
To download the ZDownloader Utility, perform the following from your
computer:
1. Open a web browser and navigate to http://www.zebra.com.
2. Click on the Support & Downloads header on the web page.
3. Select a printer.
4. When the printer page opens, locate and select the Software Utilities tab.
5. Scroll down to the ZDownloader Utility and select the Download link.
Note • You will be prompted to create a user profile or login to
http://www.zebra.com with an existing profile to download the ZDownloader Utility.
6. Click on the Accept and Begin Download Now button.
The installation file download will begin.
P1079049-003 Virtual Device-Ax User Guide 08/28/2018
Installing the ZDownloader Utility
To install the ZDownloader Utility, perform the following from your computer:
1. Run the installation file after the download is complete.
2. If you are prompted to allow the application to make changes to your computer,
click Yes.
The utility installs on your computer. When installation is complete, the Firmware
Downloader and ZBI Key Manager installation wizard appears.
ZDownloader Utility
Installing the ZDownloader Utility
47
3. Click Next.
The End User License Agreement appears.
08/28/2018 Virtual Device-Ax User Guide P1079049-003
ZDownloader Utility
48
Installing the ZDownloader Utility
4. Read the terms of the agreement.
5. Click the checkbox to accept the terms.
6. Click Next.
The installation wizard displays information about the installation.
P1079049-003 Virtual Device-Ax User Guide 08/28/2018
7. Click Next.
The installation wizard installs the application.
ZDownloader Utility
Installing the ZDownloader Utility
49
8. Click Finish to close the wizard.
08/28/2018 Virtual Device-Ax User Guide P1079049-003
Index
A
application installation
acquiring the app, 10
canceling a download in progress, 21
downloading the app to printers, 19
auto-detect printers, 12
C
commands and command parameters, 35
connectivity options, 7
D
disabling the Virtual Device
by apl.enable SGD command, 40
through the control panel
QLn320 and QLn220 printers, 27
QLn420 printers, 24
Supported ZTxxx and ZDxxx Printers with a
Display, 30
ways to enable/disable, 23
E
enabling the Virtual Device
by apl.enable SGD command, 40
through the control panel
QLn320 and QLn220 printers, 27
QLn420 printers, 24
Supported ZTxxx and ZDxxx Printers with a
Display, 30
ways to enable/disable, 23
F
features, 6
fonts, 42
I
IP Ethernet printers
auto-detect, 12
manually add, 13
L
liability, 2
M
manually add printers, 13
modifying printer communication settings
through ZDownloader, 17
P
parallel printers, 13
print servers, 7
S
serial interface
add printers, 13
Set/Get/Do (SGD) commands, 40
supported fonts, 42
U
USB printers, 12
08/28/2018 Virtual Device-Ax User Guide P1079049-003
Index
51
V
version
level of support for Virtual Devices, 41
of Virtual Device, 40
Virtual Device version, 40
W
wired print server
auto detect, 12
for more information, 7
manually add, 13
wireless print server
auto detect, 12
for more information, 7
manually add, 13
Z
ZDownloader
adding printers, 11
canceling a download in progress, 21
deleting printers, 18
downloading the Virtual Device app to printers,
19
downloading ZDownloader, 46
installing ZDownloader, 47
modifying printer settings, 17
zebra printer setup utility for android devices, 11
08/28/2018 Virtual Device-Ax User Guide P1079049-003
Corporate Headquarters
Zebra Technologies Corporation
3 Overlook Point
Lincolnshire, IL 60069 USA
T: +1 847 634 6700
Toll-free +1 866 230 9494
F: +1 847 913 8766
http://www.zebra.com
P1079049-003
Loading...