Information in this document is subject to change without notice. The software described in this document
is furnished under a license agreement or nondisclosure agreement. The software may be used or copied
only in accordance with the terms of those agreements.
For further information regarding legal and proprietary statements, please go to:
SOFTWARE:zebra.com/linkoslegal
COPYRIGHTS:zebra.com/copyright
WARRANTY:zebra.com/warranty
END USER LICENSE AGREEMENT: zebra.com/eula
Terms of Use
Proprietary Statement
This manual contains proprietary information of Zebra Technologies Corporation 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.
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.
Publication Date
September 24, 2021
3
Contents
About This Document ........................................................................................................................... 6
Who Should Use This Document..................................................................................... 6
How This Document Is Organized ................................................................................... 6
Bluetooth Connector Setup .................................................................................... 15
Connect a Printer to your Android Device .............................................................. 18
Connect to Your MDM ............................................................................................ 23
Create a QR Code ........................................................................................................ 27
App Use .............................................................................................................................................. 28
Connection Manager Screens and Functions................................................................ 28
Connection Manager Main Screen ......................................................................... 28
QLn Printer Support ....................................................................................................... 45
5
About This Document
This section provides you with contact information, document structure and organization, and additional
reference documents.
Who Should Use This Document
This User Guide is intended for use by IT personnel or company associates who need to perform routine
maintenance, upgrade, or troubleshoot problems with mobile printers via Bluetooth.
How This Document Is Organized
The User Guide is set up as follows:
SectionDescription
Android Device SetupThis section provides an introduction, and setup
procedures for your Android device.
App UseThis section details other screens and functions
for Bluetooth Connector and Connection
Manager apps.
TroubleshootingThis section will assist you with troubleshooting
issues.
Key ConsiderationsThis section provides things to consider and
important dependencies.
AppendixThis section provides a list of unsupported
printers.
6
Android Device Setup
This section provides an introduction, and setup procedures for your Android device.
Overview
Bluetooth Printer Management provides real-time visibility into the operations and settings on all your
Link-OS printers that are connected via Bluetooth to your Android devices. Bluetooth Printer Management
consists of the Bluetooth Connector and Connection Manager applications. Together, these applications
on your Android device create a gateway between the Bluetooth connected printer and either Zebra’s
Printer Profile Manager Enterprise or SOTI MobiControl*, providing real-time visibility and management.
As a result, you can update, monitor, and troubleshoot all from a remote central location.
* Zebra’s SOTI MobiControl Connector is required for use with SOTI MobiControl.
Figure 1 provides a view of the Bluetooth Printer Management system.
Figure 1 System Diagram
7
Android Device Setup
Figure 2 shows the Home screen. In this example, it indicates a successful end-to-end connection from the
Mobile Device Management (MDM) application through the Android device to the Bluetooth connected
printer.
Figure 2 Home Screen
1
2
3
4
5
1
Overflow icon
2
Status and Discover Printers
tabs
3
Connected icon
6
4
Friendly name of the printer
5
MAC Address of the printer
6
Weblink Connection bar
8
System Requirements
The following sections will assist you in setting up your Android device.
Minimum Requirements
You will need to have one from each of the categories below.
Software and Servers
•On-premise instance of Printer Profile Manager Enterprise v2.0.6353 or later
•On-premise or cloud instance of SOTI MobiControl v13.3.0.3064 or later and Zebra’s SOTI MobiControl
Connector v1.06 or later
•The Bluetooth Connector app requires the use of the Basic Printer Connection (SHA-1 certificate)
option in Printer Profile Manager Enterprise 3.x versions.
Android Devices
Devices supported include:
Android Device Setup
•MC40 & MC40 HC
•TC51 & TC55
•TC70 & TC75
•TC8000
•ET50
•ET55
•MC9200
•Nexus 4
•Nexus 5X
•Nexus 6P
•Nexus 7
•Google Pixel C
•Samsung Galaxy S6
Connectivity
•WiFi or cellular data connection to the MDM server
Android OS Versions
•4.4
•5.1
•6.0
•6.01
9
•7.0
•7.1
Link-OS Printers
Your Zebra printers must be running firmware version x.19.13Z or higher and must be one of the following
models:
•QLn series (See Appendix on page 45 for important information on specific models supported.)
•ZD400 series
•ZD500 series
•ZQ300 series
•ZQ500 series
•ZR600 series
Before you start
You will need the following additional information to get started.
Android Device Setup
1. Company specific network information, if required
•Your company’s Proxy Server URL
•Any authentication credentials for Internet or network access
2. Zebra Bluetooth printer
•Zebra recommends using the simple tap and pair method to connect the printer. In cases where that
may not be possible, the printer’s friendly name and MAC address should be known, so it can be
manually entered or identified in the list of discovered printers.
3. The Weblink server URL for either Printer Profile Manager Enterprise or SOTI MobiControl Connector.
Your IT administrator will need to provide this information.
•How to Obtain the Printer Profile Manager Enterprise Weblink server URL
The Weblink URL can be obtained from the Configuration section in Printer Profile Manager
Enterprise.
The Weblink URL is the URL shown in the Whole URL field. See Figure 3 on page 11.
•How to obtain the SOTI MobiControl Connector Weblink server URL.
Consult your IT administrator to get the Fully Qualified Domain Name (FQDN) of the Printer
Administration Server (PAS) where the SOTI MobiControl Connector is installed.
The Weblink URL will be:
where FQDN is the Fully Qualified Domain Name of the Printer Administration Server (PAS) on
which the SOTI MobiControl Connector is installed.
If your printer does not appear in the Printer Profile Manager Enterprise or SOTI MobiControl console,
see Server Connection Issues on page 39.
Printers tab to verify that your printer is
25
Android Device Setup
Figure 18 SOTI MobiControl Printers
26
Create a QR Code
This procedure will guide you through the steps to create a QR code containing the Weblink URL of your
MDM, which can then be scanned in the Bluetooth Connector app.
There are many websites available that provide the ability to create a QR code at no cost. Zebra
recommends an Internet search of the term “QR code generator” to find an appropriate site.
To generate a QR Code, perform the following steps:
1. See Figure 19. In your browser, visit a QR code generator website.
2. To create the QR code, enter or copy the MDM Weblink server URL into the URL field on the QR code
generator web page.
•For Printer Profile Manager Enterprise, the Weblink URL can be found via the menu at:
Admin > Configuration > Whole URL
•For SOTI MobiControl, enter the following:
https://FQDN:443/zebra/weblink/
where FQDN is your SOTI MobiControl Connector server name.
Android Device Setup
NOTE: Spaces are not permitted in the URL fields. You may convert spaces to percent encoding.
Figure 19 QR Code Generator Web Page
(Example)
27
App Use
This section details other screens and functions for Bluetooth Connector and Connection Manager apps.
Connection Manager Screens and Functions
Connection Manager Main Screen
See Figure 20. This screen shows the currently connected printer.
NOTE: The information on this screen is not updated when the application is running in the background.
Figure 20 Connection Manager Main Screen
28
Connection Manager Settings
These settings are used to configure the how frequently the printer status is checked, and whether error
and use reports are enabled or disabled.
To view the Settings menu, perform the following steps:
1. See Figure 21. Tap the Overflowicon, and tap Settings.
Figure 21 Connection Manager Settings Menu
App Use
2. For more detailed information about specific settings, see Connection Manager Setup on page 12.
29
Connection Manager Log
The Connection Manager log will provide the following data:
•Connection Manager exceptions and errors
•Printer connections and disconnections
To view the log, perform the following steps:
1. From Connection Manager, tap the Overflow icon, and tap Settings.
2. See Figure 22. Tap View Log.
If this is your first time using the app, the log will not display any data.
NOTE: The Log will only contain a maximum of 1000 entries. (The oldest entries will be deleted
automatically.)
Figure 22 Connection Manager Log
App Use
3. Tap Email Log to send your log to Technical Support via email.
4. Tap Close to close the log.
30
Connection Manager About
The Connection Manager About screen displays the version and provides a link to open the source
licenses.
To open the About screen, perform the following steps:
1. From Connection Manager, tap the Overflow icon, and tap Settings.
2. Tap About.
3. See Figure 23. Tap Open source licenses link to view the licenses.
4. Tap Dismiss to close the About screen.
Figure 23 Connection Manager About Screen
App Use
31
App Use
Bluetooth Connector Screens and Functions
Bluetooth Connector Main Screen
This screen shows the currently selected printer.
To deselect a printer, perform the following step:
1. See Figure 24. From the area containing the Blue tooth icon, swipe left to reveal the Disconnect button.
2. Tap Disconnect button to deselect the printer.
Figure 24 Bluetooth Connector Main Screen
32
Bluetooth Connector Settings
These settings are used to configure the Weblink Server URL, proxy URL, authentication, and several
general connection choices.
To view the Settings menu, perform the following step:
1. See Figure 25. Tap the Overflowicon, and tap Settings.
Figure 25 Bluetooth Connector Settings Menu
App Use
2. For more detailed information about specific settings, see Bluetooth Connector Setup on page 15.
33
Bluetooth Connector Log
The Bluetooth Connector log will provide the following data:
•Bluetooth Connector exceptions and errors
•Weblink connection information
To view the log, perform the following steps:
1. From Bluetooth Connector, tap the Overflow icon, and tap Settings.
2. See Figure 26. Tap View Log.
If you have not connected to the MDM, the log will not display any data.
NOTE: The Log will only contain a maximum of 1000 entries. (The oldest entries will be deleted
automatically.)
Figure 26 Bluetooth Connector Log
App Use
3. Tap Email Log to send your log to Technical Support via email.
4. Tap Close to close the log.
34
Bluetooth Connector About
The Bluetooth Connector About screen displays the version and provides a link to open the source
licenses.
To open the About screen, perform the following steps:
1. From Bluetooth Connector, tap the Overflow icon, and tap Settings.
2. Tap About.
3. See Figure 27. Tap Open source licenses link to view the licenses.
4. Tap Dismiss to close the About screen.
Figure 27 Bluetooth Connector About Screen
App Use
35
Troubleshooting
This section will assist you with troubleshooting issues.
Installation Issues
Initial Installation
•You must download and install both apps, Bluetooth Connector and Connection Manager.
•Verify the operating system is one supported. (See Android OS Versions on page 9.)
•Check app permissions. In Android version 6 and later, permissions must be enabled at runtime, not at
installation time as in previous Android versions. Appropriate permissions must be set in order for the
apps to work correctly. If you open Bluetooth Connector app before granting the permissions for
Connection Manager, you will be prompted to do so. (See Figure 28.)
Figure 28 Set Permissions for Connection Manager
36
Printer Discovery
Application Permissions
If you are unable to discover printers, check that the Connection Manager permissions have been
accepted. (This applies to Android version 6 and later.)
1. Open the Connection Manager app.
2. See Figure 29. The app prompts you for the permissions.
3. Click OKAY to grant the requested permissions.
Figure 29 Open Connection ManagerScreen
Troubleshooting
37
Manually Set Permissions
If, for any reason, the permissions for both applications are changed, you will see Figure 30 in Bluetooth
Connector. This indicates that permissions must be granted again before either of the applications will
work.
Figure 30 Bluetooth ConnectorPermission Notice
Troubleshooting
•Open Connection Manager and grant the requested permissions. (Applies to Android version 6 or
later.)
To manually fix permissions for both applications, perform the following steps:
1. From your Android device, go to Settings > Apps (or Application manager) > Bluetooth Connector or
Connection Manager > Permissions.
2. Set all permissions listed to ON.
3. Restart both applications for the permission changes to take effect.
Check Bluetooth is Enabled on the Printer
Check your printer configuration label to determine whether your bluetooth setting is enabled.
Refer to your printer’s user guide for information about how to print a configuration label.
38
Connection Issues
Server Connection Issues
Weblink Server URL
If Bluetooth Connector cannot connect to your MDM, check the Weblink server URL in the Bluetooth
Connector settings.
•Verify with your system administrator that you have the correct server URL.
•There should not be any spaces in the server URL.
WiFi and Cellular Connectivity
•Check that you have access to your MDM through your WiFi and/or cellular data connection. You may
need to contact your system administrator for information on any requirements or rules that exist which
permit connections to the address and port specified in
Troubleshooting
Settings menu of the Bluetooth Connector app.
•If the
Keep WiFi on During Sleep setting on your Android device is set to Never, you will lose your
connection to the MDM when your Android device goes to sleep. Check this option in the WiFi settings
on your Android device.
Printer Periodically Disconnects from MDM
Some printers have a sleep mode function to conserve battery life. If your printer has sleep mode enabled
and it goes to sleep, it will cause the printer to disconnect from the MDM.
The sleep mode function includes a “
automatically wake upon receiving data. Once awake, the printer should automatically reconnect to the
MDM.
To avoid these periodic disconnects, disable the sleep mode function on your printer.
Sleep mode can be disabled by issuing the following Set-Get-Do command:
! U1 setvar "power.sleep.enable" "off"
Printer Connection Issues
What do I do if I lose my printer connection?
Verify the following:
•Your Android device must remain within 30 ft. of the printer to maintain a connection.
Wake on Bluetooth” feature, which means the printer will
•Bluetooth setting must remain on for both the Android device and the printer.
39
Troubleshooting
Miscellaneous
Why do I see printer commands on my label?
Some printers ship with Line Print Mode as the default print mode. In this mode, the printer prints text
directly without requiring extra formatting commands. If you perform functions from either Printer Profile
Manager Enterprise or SOTI MobiControl and you see the printer commands on the label, this indicates
that your printer is in Line Mode.
The Print Mode may be changed using the device.languages Set-Get-Do command. For more specific
information about this command, see the Zebra Programming Guide.
Contact Zebra Support
For further assistance with Bluetooth Printer Management, contact Zebra Support at zebra.com/support.
40
Key Considerations
This section provides things to consider and important dependencies.
Bluetooth Connection Overview
Link-OS printers with firmware version x.19.10Z and later support both a printing channel and status
channel over the Bluetooth connection.
These two channels allow for monitoring the printer status through the status channel while the printing
channel is being used for printing and/or printer configuration operations.
Connection Manager supports using these two channels.
Only one connection from any application can be made to the printer’s status channel at any one time. If
an application using Connection Manager tries to open a connection to a printer’s status channel which is
already in use, an error value will be returned. (Error responses will be documented in the SDK
documentation)
An application using Connection Manager can open a printer’s status channel even if another application
has opened the printer’s printing channel. This allows one application to be printing while another
application is getting printer status.
The status channel only supports JSON formatted commands. It does not support commands such as Set
Get Do, formatting commands or other commands that require the ZPL parser. Firmware downloads are
not supported via this channel.
(JSON formatted commands are documented in the programmer’s manual.)
Printing Channel
•If an application has the printing channel open when Bluetooth Connector tries to connect to a printer,
Bluetooth Connector will only establish a connection with the printer’s status channel.
•If Bluetooth Connector has established a connection with a printer’s printing channel and/or status
channel, it can establish a connection with Printer Profile Manager Enterprise or SOTI MobiControl.
Once the connection is established, the printer will appear as online by either Printer Profile Manager
Enterprise or SOTI MobiControl.
•Printer Profile Manager Enterprise performs most of its operations through the status channel. If Printer
Profile Manager Enterprise tries to perform an operation that requires the printing channel, it will display
failed operation.
•SOTI MobiControl relies mostly on the printing channel for printer management, configuration, alerts
and status monitoring.
41
Status Channel
•Printer Profile Manager Enterprise uses this status channel for operations other than firmware
downloads, sending profiles, and files.
•SOTI MobiControl does not primarily use the status channel.
General Information
•Once the Android device has connected to the wireless internal network, any time the Android device is
within range of the internal network, it will automatically connect to that network. When the Android
device is out of range of the secured network, it will automatically connect to the cellular network and
the data plan.
•Remote transfer speeds will be dependent on the cellular data plan’s bandwidths and connection signal
strength.
•Care should be taken when doing firmware or large data downloads. Consider signal strength, a
consistent connection, and your data plan limits.
•There is no functional difference between Bluetooth Connector using a Wi-Fi network or a cellular
network.
Key Considerations
•If the connection to a printer is dropped, the connection to the MDM is also dropped.
•Bluetooth Connector will automatically try to reconnect to the MDM if the connection is dropped.
Other Considerations
Firmware Downloads
For SOTI MobiControl, a firmware download process is treated as a general file download. However, the
printer connection must be maintained during the file download. For additional details, refer to
Dependencies for Bluetooth-Only Printers.
Dependencies for Bluetooth-Only Printers
If you must download firmware to a Bluetooth-only printer, consider the following before you proceed:
•Before starting a firmware download, be sure the battery is fully charged.
•The printer and phone must be within 30 ft. of each other for the entire duration of the download.
•The Bluetooth printer must remain powered on during the download.
•Do not perform ANY function with the printer during the process. You must not print, turn it off, or
query for status.
•Must maintain a network connection between the Android device and the MDM (Printer Profile Manager
Enterprise or SOTI MobiControl).
•Must limit other app usage during the download.
•Do not turn off Bluetooth on the Android device (no Airplane mode).
•Do not force quit either the Bluetooth Connector or Connection Manager apps.
42
Using Bluetooth Connections
Bluetooth Connector receives status and alert information via the status channel. Operations such as
firmware and font downloads are performed via the printing channel. If Bluetooth Connector sees that the
printing channel is in use, it will only use the status channel.
The present version of Printer Setup for Android can be active while Bluetooth Connector and Connection
Manager are active. Printer Setup for Android only establishes a connection (mainly via the printing
channel) to the printer when there is a request or operation to perform.
Printer Profile Manager Enterprise
•The primary channel Bluetooth Connector uses is the status channel. Printer Setup for Android and 3rd
party applications will primarily use the printing channel, so there is a minimal chance of conflicts.
•When Bluetooth Connector does require the printing channel, if the channel is in use, Bluetooth
Connector will inform Printer Profile Manager Enterprise that the printer is not available for the
operation requiring the printing channel.
•Printer Profile Manager Enterprise uses the printing channel for:
•Firmware downloads, send resources, or send files byte-by-byte
•All other requests and operations are done via the status channel
Key Considerations
•If Bluetooth Connector has a valid Weblink URL to Printer Profile Manager Enterprise and it can
connect to a printer through either of the channels, Printer Profile Manager Enterprise will indicate that
the printer is online.
SOTI MobiControl Connector
•The primary channel SOTI MobiControl Connector uses is the Weblink printing channel to
communicate with Bluetooth Connector.
•If Printer Setup for Android or a 3rd party application requests the printing channel to a printer and
Connection Manager has established a connection to the printer, this connection is severed, and
Printer Setup for Android or the 3rd party app is now connected to the printer.
•Even though the connection between Connection Manager and the printer has been severed, the
Weblink connection between SOTI MobiControl Connector and Bluetooth Connector is still active.
•If Printer Setup for Android or a 3rd party application has released its connection to the printer, when
SOTI MobiControl Connector tries to communicate with the printer again, Connection Manager will
re-establish connection to the printer and SOTI MobiControl Connector functions as normal. If Printer
Setup for Android or 3rd party application has not released its connection, SOTI MobiControl Connector
will indicate the operation has failed because the printer is offline.
43
Key Considerations
Functional differences when using Printer Profile Manager Enterprise
Some functions in Printer Profile Manager Enterprise are affected when using Bluetooth Connector:
•The printer may not have an IP (0.0.0.0) in the printer listing or landing page.
•Printer Profile Manager Enterprise will not have access to a printer’s IP address.
•Any activity that requires a direct TCP connection will not work. They are as follows:
•Printer Web Page
•Adding and discovering a printer via Bluetooth Connector
•The Weblink Info tab on the Printer Landing page
Managing Printers over Bluetooth vs. Network Connections
The only way for an MDM (Printer Profile Manager Enterprise or
•
Bluetooth printer is via Bluetooth Connector.
Bluetooth Connector
•
status or perform operations.
•A Bluetooth connection may not be as reliable as a network connection and as such requires periodic
reconnections that need to be planned into the management process and process recovery.
•Printer status
•Unlike a network connection, printer status needs to be requested over the Bluetooth connection.
Bluetooth Connector
•
requires a connection to both the MDM and the Bluetooth printer to communicate
checks printer status at defined intervals to reduce battery drain.
SOTI MobiControl
) to manage a
44
Appendix
This section provides a list of unsupported printers.
QLn Printer Support
Bluetooth Connector does not support some QLn printer models. If you try to connect a model that is not
supported, Figure 31 will appear.
Figure 31 Unsupported Bluetooth Radio Screen
45
Appendix
Table 1 is a list of the unsupported printer models. If your model number appears in column 1, and the
serial number is between the first and last serial number (inclusive), your printer is not supported.
Table 1 Unsupported QLn Printer Models
Model NumberFirst Serial NumberLast Serial Number
QN2-AUBA0000-00XXQPJ133801044XXQPJ141700794
QN2-AUBA00B0-00XXQPJ132500001XXQPJ132500060
QN2-AUBA0E00-00XXQPJ130600164XXQPJ141900370
QN2-AUBA0E00-01XXQPJ133801603XXQPJ141300009
QN2-AUBAE010-00XXQPJ130100001XXQPJ131100030
QN2-AUBAEE10-00XXQPJ130100011XXQPJ141700680
QN3-AUBA0000-00XXQLJ112700607XXQLJ141400040
QN3-AUBA00B0-00XXQLJ132300001XXQLJ133700829
QN3-AUBA0E00-00XXQLJ120900571XXQLJ133900105
QN3-AUBA0E01-00XXQLJ130900916XXQLJ130900925
QN3-AUBA0EB0-43SYQLJ131400461SYQLJ140202171
QN3-AUBAEE11-00XXQLJ131600001XXQLJ141103288
46
zebra.com
Loading...
+ hidden pages
You need points to download manuals.
1 point = 1 manual.
You can buy points or you can get point for every manual you upload.