Honeywell Verifier Integration Interface User manual

Verifier Integration Interface

For PX940V Printer

Command Reference
Disclaimer
Honeywell International Inc. (“HII”) reserves the right to make changes in specifications and other information contained in this document without prior notice, and the reader should in all cases consult HII to determine whether any such changes have been made. The information in this publication does not represent a commitment on the part of HII.
This document contains proprietary information that is protected by copyright. All rights are reserved. No part of this doc­ument may be photocopied, reproduced, or translated into another language without the prior written consent of HII.
Copyright 2020 Honeywell International Inc. All rights reserved.
Web Address:
www.honeywellaidc.com
Patents
For patent information, refer to www.hsmpats.com.
TABLE OF CONTENTS
Customer Support ....................................................................................................................... vii
Technical Assistance ............................................................................................................ vii
Product Service and Repair ............................................................................................... vii
Limited Warranty ................................................................................................................... vii
Chapter 1 - Get Started ....................................................................................1
Features ............................................................................................................................................. 1
About this Manual.......................................................................................................................... 1
Interface Diagram ..........................................................................................................................2
Data Protocol ................................................................................................................................... 2
Network Interface...........................................................................................................................2
Chapter 2 - Printer and Host PC Setup.........................................................3
Set Up Printer................................................................................................................................... 3
Access the Printer Web Page............................................................................................... 3
Configure VII.............................................................................................................................. 3
Execution Mode................................................................................................................. 5
Verifier Mode.......................................................................................................................5
Command Channel, Feedback Channel, and Image Channel........................6
Set Up Host PC................................................................................................................................6
Command Channel.................................................................................................................7
Configure Command Channel.....................................................................................7
Feedback Channel................................................................................................................... 7
Configuring Feedback Channel .................................................................................. 8
Image Channel.......................................................................................................................... 8
VII Command Reference iii
Configuring Image Channel..........................................................................................8
Chapter 3 - Commands and Responses ........................................................9
Commands ........................................................................................................................................9
Response.........................................................................................................................................10
GetPrinterInfo ...............................................................................................................................11
CancelAllJobs................................................................................................................................12
GetLabelImage .............................................................................................................................13
GetPrinterStatus ..........................................................................................................................14
ImageTransfer...............................................................................................................................15
PausePrintJob...............................................................................................................................16
PrinterError ....................................................................................................................................17
PrintJobStatus..............................................................................................................................18
ReprintPrintJob ............................................................................................................................ 19
ResetVerificationResult.............................................................................................................20
ResumePrintJob...........................................................................................................................21
RetractLabel ..................................................................................................................................22
ReverifyLabel.................................................................................................................................23
SendVerificationResult.............................................................................................................. 24
SetCommandChannelPort.......................................................................................................25
SetExecutionMode......................................................................................................................26
SetFeedbackChannelPort ........................................................................................................27
SetImageChannelPort ...............................................................................................................28
SetVerifierMode............................................................................................................................ 29
VerificationResult ........................................................................................................................30
VoidLabel ........................................................................................................................................31
Error Codes.....................................................................................................................................32
Chapter 4 - Troubleshooting........................................................................ 33
Problems and Possible Solutions..........................................................................................33
Chapter 5 - Use Case Sequence Diagram .................................................. 35
Printer Error ...................................................................................................................................35
iv VII Command Reference
Print Job - Pause, Resume, Cancel .......................................................................................36
Appendix A - Verification Report .................................................................37
Sample Verification Report ......................................................................................................37
VII Command Reference v
vi VII Command Reference

Customer Support

Technical Assistance

To search our knowledge base for a solution or to log in to the Technical Support portal and report a problem, go to www.hsmcontactsupport.com.
For our latest contact information, see www.honeywellaidc.com/locations.

Product Service and Repair

Honeywell International Inc. provides service for all of its products through service centers throughout the world. To obtain warranty or non-warranty service, return your product to Honeywell (postage paid) with a copy of the dated purchase record. To learn more, go to www.honeywellaidc.com and select Service and Repair at the bottom of the page.

Limited Warranty

For warranty information, go to www.honeywellaidc.com and click Get Resources > Product Warranty.
VII Command Reference vii
viii VII Command Reference
CHAPTER
1

GET STARTED

The PX940V is a rugged label printer with ANSI Grade (ISO15415/15416) verification for label printing.
The Verifier Integration Interface of the PX940V printer allows you to communicate with the printer through a host PC setup. Using the Verifier Integration Interface (VII), verification data can be collected as images and XML reports.
A TCP/IP connection needs to be configured between the printer and host PC for communication.

Features

The verifier identifies and verifies the printed barcode using supported command languages.
The VII can be used for the following:
Label validation
Secondary Grading
Grading Barcodes
Storing Audit Trails
Label Duplication Detection
Label Serialization Detection

About this Manual

This command reference provides you information about the interface between the printer with the verifier and a host PC and a set of commands to help you create applications for the PX940V Printer.
The following abbreviations are used in this guide:
VII - Verifier Integration Interface
VII Command Reference 1
TPH - Thermal PrintHead
(ANSI GRADING)
Printing
VII
Printjob
DAEMON PROCESS
VII DAEMON
PROCESS

Interface Diagram

The interface between the VII and the host PC is illustrated below:
SYNC
Verification
PRINTER
HOST PC
Feedback
Command Channel
Image Channel
Feedback Channel
Image/Result
:

Data Protocol

XML is the data format set for the host PC to communicate with Verifier Integration Interface.

Network Interface

A TCP/IP network interface is set up for the host PC to access the printer.
Note: While one host can be connected to multiple printers, each printer can only be
connected to a single host at a time.
2 VII Command Reference
CHAPTER

PRINTER AND HOST PC SETUP

2
This chapter provides details to set up communication between VII and Host PC.

Set Up Printer

User can set up the printer through a web page or the printer LCD.
Access the Printer Web Page
1. Open a browser window on your PC.
2. In the location or address bar, type the printer IP address and press Enter.
3. Click Login. The login page appears.
You will be prompted to enter a username and password. The defaults are:
After logging In, you will be prompted to change the password.
Configure VII
Before being able to configure the verifier integration interface service, it must be enabled in the Manage service configuration.
To enable the verifier integration interface service through the web page, click Configure > System Settings > Manage Services.
or
Through the front touch panel.
User Name: itadmin
Password: pass
VII Command Reference 3
Once the VII is enabled in the Manage services section, you can configure VII in detail through the web page.
Click Configure > Network Services > VII.
or
Through the front touch panel.
The options for the VII are as follows:
Execution Mode
Verifier Mode
Command Channel
Image Channel
Feedback Channel
4 VII Command Reference
Execution Mode
The Execution Mode allows you to control the synchronization between label printing and printed label capture and verification.
Asynchronous Mode
One label is inspected while the next label is being printed and/or having its image scanned.
Synchronous Mode
A single label is printed, image scanned and fully inspected before any other labels are printed.
The default value is Asynchronous.
Verifier Mode
The verification modes define the types of the verification process. For the VII, there are three types of verification modes:
1. Mode1 - Scan
2. Mode2 - Scan and grade
3. Mode3 - Scan, grade and control
Verifier Modes and Description
Modes Operation Description
Mode1 Scan The verifier will only scan the printed image, it will not do barcode
inspection. The host retrieves the image, analyzes it and control the printer action.
Mode2 Scan and
grade
Mode3 Scan, grade
and control
The verifier will inspect the barcode. The host controls the printer action and could also analyze the image. If the image channel is enabled from host, the label image will be sent to host, otherwise the label image will not be sent to host.
The verifier inspect barcode and do failure action handling. The host captures reports and images for storage. The barcode verification result will be sent to host via feedback channel. If image channel is enabled from host, the label image will be sent to host, otherwise the label image will not be sent to host.
For verifier modes 1 and 2, the printer will wait for the verification result from host. In Synchronous Mode on page 5, if printer does not receive verification result from host, printer will stop after printing 1 label.
In Asynchronous Mode on page 5, printer will stop after printing X number of labels depending on the label length as indicated in the table below.
VII Command Reference 5
Label number and Label Length range
Label Length Range (inches) Number of labels (X)
> 4.00 3
> 0.68 4
> 0.52 5
> 0.41 6
> 0.35 7
> 0.30 8
> 0.26 9
> 0.24 10
> 0.00 11
Command Channel, Feedback Channel, and Image Channel
Defines the port used for the host to connect to the printer. The range of the port number is 9301 - 65535.
Note: Your firewall must be configured to allow these ports to be accessible otherwise a
failure may occur.
All the three communication channels must be opened to send or receive any data from the printer. For example, if the image channel is closed, the printer cannot send raw image data to the host.

Set Up Host PC

Verifier Integration interface allows you to transfer data between printer and host and control the printer from the host.
The host PC communicates with the printer using certain commands. To send the commands, user has to set up the communication channel and configure accordingly.
The communication channels are,
Command Channel
Feedback Channel
Image Channel
Command Channel
The command channel is used to issue commands from host to printer. The commands can be sent based on the feedback result received from the printer to host or to get printing information.
6 VII Command Reference
There are four types of commands that can be sent through command channel, namely,
Query Information Command
Configuration Command
Printing Control Command
Update Command
The types of commands that can be sent through the command channel from the host PC to the printer are detailed here.
Query Information command
GetPrinterInfo
GetPrinterStatus
GetLabelImage
Configure Command Channel
Setup a TCP/IP connection between host PC and printer to open the command channel.
Command channel need to be connected before connecting Feedback channel. The Feedback channel will only accept connection from Command channel's Host (same IP), else, even if it shows connection OK, there won't be any output from this channel.
Configuration command
SetExecutionMode CancelAllJobs SendVerificationResult
SetVerifierMode PausePrintJob
SetCommandChannelPort ResumePrintJob
SetFeedbackChannelPort ReprintPrintJob
SetImageChannelPort VoidLabel
ResetVerificationResult RetractLabel
Printing control command
ReverifyLabel
Update command
Feedback Channel
The feedback channel is used by the printer to send the print job status, verification result, or error result to host. These are sent by the printer automatically.
The responses from the feedback channel are:
PrintJobStatus
VerificationResult
PrinterError
Configuring Feedback Channel
Setup a TCP/IP connection between the host PC and printer to open the feedback channel.
VII Command Reference 7
The command channel must be open before the feedback channel as both the channel share the same IP address.
Note: Command channel need to be connected before connecting Feedback channel,
Feedback channel will only accept connections from Command channel's Host (same IP).
Image Channel
The image channel is used to send the label images from printer to host. The images can be BMP or raw image data. The image data is automatically sent from the printer without any request from the host.
The responses for the image channel are,
ImageTransfer
Configuring Image Channel
Setup a TCP/IP connection between the host PC and printer to open the image channel.
The Image channel must be configured if the host PC expects to receive raw image data from the printer. If the raw image data is not needed, then the image channel need not be configured.
8 VII Command Reference
CHAPTER
3
This chapter provides details about the Commands and Responses of all the functionality of the verifier integration interface.

Commands

COMMANDS AND RESPONSES

Command Name Purpose
GetPrinterInfo Returns the printer information such as printer serial number, printer
model etc.
CancelAllJobs To instruct the printer to cancel all the pending print jobs.
GetLabelImage Returns label image based on label ID.
GetPrinterStatus Returns the printer status such as busy or available.
PausePrintJob To instruct the printer to stop printing.
ReprintPrintJob To instruct the printer to reprint the label specified by the host.
ResetVerificationResult To reset the verification result database stored in printer.
ResumePrintJob To instruct printer to resume from a printer pause mode.
RetractLabel To instruct printer to retract the label specified by the host using Label ID.
PausePrintJob To instruct the printer to stop printing.
ReprintPrintJob To instruct the printer to reprint the label specified by the host.
ResetVerificationResult To reset the verification result database stored in printer.
VII Command Reference 9

Response

The feedback channel and image channel returns response automatically without any request from host.
Command Name Purpose
ImageTransfer To send label image from the printer to host.
PrinterError To send the printer error information to host.
PrintJobStatus To send print job status from the printer to host.
VerificationResult To send Barcode verification result from the printer to the host.
10 VII Command Reference

GetPrinterInfo

This command returns printer information such as printer serial number, printer model etc.
XML Request
<VII Action=“GetPrinterInfo”> </VII>
XML Response
<VII Action="GetPrinterInfo" Status="00">
<PrinterName>[printer name]</PrinterName> <ModelName>[model name]</ModelName> <SerialNumber>[serial number]</SerialNumber> <VerifierResolution>[resolution]</VerifierResolution>
</VII>
Parameter
Elements Description
PrinterName
ModeName
SerialNumber
VerifierResolution
In case of error, the XML response will be,
<VII Action="GetPrinterInfo" Status=[error code]> </VII>
For error codes, refer to Error Codes.
Name of the printer
Model name of the printer
Serial number of the printer
Verifier resolution of the printer. The resolution is in dpi unit, for example <VerifierResolution>600</VerifierResolution>
VII Command Reference 11

CancelAllJobs

This command instructs the printer to cancel all pending print jobs.
XML Request
<VII Action="CancelAllJobs"> </VII>
XML Response
<VII Action="CancelAllJobs" Status="00"> </VII>
In case of error, the XML response will be,
<VII Action="CancelAllJobs" Status=[error code]> </VII>
For error codes, refer to Error Codes.
12 VII Command Reference

GetLabelImage

This command retrieves the label image based on the specified label ID.
XML Request
<VII Action="GetLabelImage"> <LabelID>[label ID]</LabelID> </VII>
Elements Description
LabelID
XML Response
In case of successful command execution, the specified label image will be sent to host via command channel.
<VII Action="GetLabelImage" Status="00" Type="BMP" ID="1" Size="XYZ">
<Image>[Data Block]</Image> </VII>
Unique identifier for the labels. LabelID can be retrieved from PrintJobStatus, and VerificationResult responses. The LabelID must be the LabelID reported back in the last response by feedback channel.
Parameters
In case of error, the XML response will be,
<VII Action="GetLabelImage" Status=[error code]> </VII>
For error codes, refer to Error Codes.
Name Description
Type
ID
Size
Data Block
Label image in BMP format
Label ID for each label
Data size of actual image
BMP data including BMP header
VII Command Reference 13

GetPrinterStatus

This command is to check current printer status. It will help to check if the printer is busy or available.
For all supported status, see “Error Codes section under Fingerprint Command Reference Manual”.
XML Request
<VII Action="GetPrinterStatus"> </VII>
XML Response
<VII Action="GetPrinterStatus" Status="00">
<PrinterStatus>[status message]</PrinterStatus>
</VII>
Parameter
Elements Description
PrinterStatus Printer status message.
Status message does not support localization. The status messages can be,
Busy
Available
Out of media
Printhead lifted
Front arm lifted
Out of ribbon
Label not found
Test feed not done
Ribbon installed
Printhead too hot
Remove Label
In case of error, “GetPrinterStatus” XML response will be as listed below:
<VII Action="GetPrinterStatus" Status=[error code]> </VII>
For error codes, refer to Error Codes.
14 VII Command Reference

ImageTransfer

This is the response to send label image from printer to host.
XML Format
The XML format of image data transferred via image channel.
<VII Action="ImageTransfer" Type="RAW" ID="1" Width="XYZ"> <Image>[Data Block]</Image> </VII>
Parameter
Name Description
Type
ID
Width
Data Block
Label image in raw format
Label ID for each label
Width of image data block
Raw image data block
VII Command Reference 15

PausePrintJob

This command is to instruct the printer to pause from printing.
XML Request
<VII Action="PausePrintJob"> </VII>
XML Response
<VII Action="PausePrintJob" Status="00"> </VII>
In case of error, 'PausePrintJob' XML response will be,
<VII Action="PausePrintJob" Status=[error code]> </VII>
For error codes, refer to Error Codes.
16 VII Command Reference

PrinterError

This is the response to feedback any printer error, for example “Out of media”.
This is automatically sent from printer to host.
XML Response
<VII Action="PrinterError">
<PrinterError>[printer error]</PrinterError>
</VII>
Printer error can be as Follows:
Printhead lifted
Front arm lifted
Next label not found
Out of media
Out of ribbon
Ribbon installed
Note: For use case sequence diagram, refer to Printer Error.
VII Command Reference 17

PrintJobStatus

This is a response to feedback print job status from printer to host. After each label is printed, the label printing status will be sent to host.
XML Response
<VII Action="PrintJobStatus">
<LabelID>[label ID]</LabelID> <PrintJobStatus>[print job status]</PrintJobStatus>
</VII>
Print job status can be “Printed” or “Printing Failed”.
18 VII Command Reference

ReprintPrintJob

This command is to instruct printer to reprint the label specified by host. The label can be specified by the label ID and option.
XML Request
<VII Action="ReprintPrintJob">
<LabelID>[label ID]</LabelID> <Option>[option]</Option>
</VII>
Print job option should be either “Single” or “All”.
If option is “Single”, only the label specified by label ID will be reprinted.
If option is “All”, then the labels between the label specified by label ID and the last printed label will be reprinted.
The reprint range will be from 3 to 11 which decrease when media length is changing from small to big. Refer to Label number and Label Length range on page 6.
For example, if the number of label is 3 and last label ID sent back to host is 5, the host only can send back the label ID for reprint from 3 to 5.
XML Response
<VII Action="ReprintPrintJob" Status="00"> </VII>
In case of error, 'ReprintPrintJob' XML response will be as listed below:
<VII Action="ReprintPrintJob" Status=[error code]> </VII>
For error codes, refer to Error Codes.
VII Command Reference 19

ResetVerificationResult

This command is to reset verification result database stored in printer.
XML Request
<VII Action="ResetVerificationResult"> </VII>
XML Response
<VII Action="ResetVerificationResult" Status="00"> </VII>
In case of error, “ResetVerificationResult" XML response will be as listed below:
<VII Action="ResetVerificationResult" Status=[error code]> </VII>
For error codes, refer to Error Codes.
20 VII Command Reference

ResumePrintJob

This command is to instruct printer to resume printing from a printer pause mode.
XML Request
<VII Action="ResumePrintJob"> </VII>
XML Response
<VII Action="ResumePrintJob" Status="00"> </VII>
In case of error, “ResumePrintJob” XML response will be as listed below:
<VII Action="ResumePrintJob" Status=[error code]> </VII>
For error codes, refer to Error Codes.
VII Command Reference 21

RetractLabel

This command is to instruct the printer to retract the label specified by host using label ID.
XML Request
<VII Action="RetractLabel">
<LabelID>[label ID]</LabelID>
</VII>
The range of how many labels can be retracted is between 3 and 11 which decrease when media length is changing from small to big. Refer to Label number and Label
Length range on page 6.
For example, if the number of label is 3 and last label ID sent back to host is 5, the host only can send back the label ID for retract from 3 to 5.
XML Response
<VII Action="RetractLabel " Status="00"> </VII>
In case of error, “RetractLabel ” XML response will be as listed below:
<VII Action="RetractLabel " Status=[error code]> </VII>
For error codes, refer to Error Codes.
22 VII Command Reference

ReverifyLabel

This command is to instruct printer to re-verify a single label specified by the LabelID.
Note: When a label has been retracted through the TPH, the original grade (first time
verified) may not be accurate anymore. This command lets you regrade the label again.
XML Request
<VII Action="ReverifyLabel">
<LabelID>[label ID]</LabelID>
</VII>
The range of how many labels can be reverified is from 3 to 11 which decrease when media length is changing from small to big. Refer to Label number and Label
Length range on page 6.
For example, if the number of label is 3 and last label ID sent back to host is 5, the host only can send back the label ID for reverify from 3 to 5.
XML Response
<VII Action="ReverifyLabel " Status="00"> </VII>
In case of error, “ReverifyLabel ” XML response will be as shown below:
<VII Action="ReverifyLabel " Status=[error code]> </VII>
This response reply the status of reverify action. The verification result will be same as normal printing verification sent from feedback channel.
For error codes, refer to Error Codes.
VII Command Reference 23

SendVerificationResult

This command is to send barcode/image verification result from the host to the printer.
In Synchronous Mode on page 5, printer will stop subsequent label printing and wait for verification result from host. In Asynchronous Mode on page 5, printer will stop print after all image buffer is used up.
Note: The SendVerificationResult is for verification modes 1 and 2 only.
XML Request
<VII Action="SendVerificationResult">
<LabelID>[label ID]</LabelID>
<VerificationResult>[verification result]</ VerificationResult> </VII>
Verification result can be “Pass” or “Fail”.
XML Response
<VII Action="SendVerificationResult" Status="00"> </VII>
In case of error, “SendVerificationResult” XML response will be as listed below:
<VII Action="SendVerificationResult" Status=[error code]> </VII>
For error codes, refer to Error Codes.
24 VII Command Reference

SetCommandChannelPort

This command is to set the port number of the command channel. The default value is “9301”. The range of the port numbers are 9301 - 65535.
XML Request
<VII Action="SetCommandChannelPort">
<PortNumber>[port number]</PortNumber>
</VII>
XML Response
In case of successful command execution, no response will be sent, as port will be reset to new value.
In case of error, 'SetCommandChannelPort' XML response will be as listed below:
<VII Action="SetCommandChannelPort" Status=[error code]> </VII>
Note: User can reconnect to a new port from the range 9301-65535.
For error codes, refer to Error Codes.
VII Command Reference 25

SetExecutionMode

For Execution Mode, Refer to Execution Mode on page 5.
XML Request
<VII Action="SetExecutionMode">
<Option>[option]</Option> </VII>
XML Response
<VII Action="SetExecutionMode" Status="00"> </VII>
In case of error, 'SetExecutionMode' XML response will be as listed below:
<VII Action="SetExecutionMode" Status=[error code]> </VII>
For error codes, refer to Error Codes.
26 VII Command Reference

SetFeedbackChannelPort

This command is to set the port number of the feedback channel. The default value is "9302". The range of the port numbers are 9301 - 65535.
Note: Command port need to be connected before connecting Feedback channel. The
Feedback channel will only accept connection from Command channel's Host (same IP), else, even if it shows connection OK, there won't be any output from this channel.
XML Request
<VII Action="SetFeedbackChannelPort">
<PortNumber>[port number]</PortNumber>
</VII>
XML Response
In case of successful command execution, no response will be sent as port will be reset to new value.
In case of error, “SetFeedbackChannelPort” XML response will be as listed below:
<VII Action="SetFeedbackChannelPort" Status=[error code]> </VII>
Note: User can reconnect to a new port from the range 9301-65535.
For error codes, refer to Error Codes.
VII Command Reference 27

SetImageChannelPort

This command is to set the port number of the image channel. The default value is "9303". The range of the port numbers are 9301 - 65535.
Note: Command port need to be connected before connecting the image channel. The
image channel will only accept connection from the same host (same IP) connected by the command channel, else, even if it shows connection OK, there won't be any output from this channel.
XML Request
<VII Action="SetImageChannelPort">
<PortNumber>[port number]</PortNumber> </VII>
XML Response
In case of successful command execution, no response will be sent, as port will be reset to new value.
In case of error, 'SetImageChannelPort" XML response will be as listed below:
<VII Action="SetImageChannelPort" Status=[error code]> </VII>
Note: User can reconnect to a new port from the range 9301-65535.
For error code, refer to Error Codes.
28 VII Command Reference

SetVerifierMode

This command is to set verifier mode.
XML Request
<VII Action="SetVerifierMode">
<Option>[option]</Option>
</VII>
Verifier option can be below value:
1. Scan
2. Scan and grade
3. Scan, grade and control
Note: The default value is "3".
XML Response
In case of successful command execution, 'SetVerifierMode' XML response will be as listed below:
<VII Action="SetVerifierMode" Status="00"> </VII>
In case of error, “SetVerifierMode” XML response will be as shown below:
<VII Action="SetVerifierMode" Status=[error code]> </VII>
For error codes, refer to Error Codes.
S
VII Command Reference 29

VerificationResult

This is the response to feedback barcode verification result from printer to host. If the barcode inspection is performed by printer verifier, the verification result will be sent to host after each label is inspected.
Note: The verification mode applicable are mode 2 and 3.
XML Response
<VII Action="VerificationResult">
<LabelID>[label ID]</LabelID>
<VerificationResult>[verification result]</ VerificationResult>
<VerificationReport>[verification report]</ VerificationReport> </VII>
Verification result can be "Pass" or "Fail".
The verification report will be XML format, and use UTF-8 as character encoding. For a sample of verification report, refer to Appendix A.
30 VII Command Reference

VoidLabel

This command is to instruct printer to mark up VOID on printed label.
XML Request
</VII>
VoildLabel option should be either "Single" or "All".
If option is "Single", only the label specified by label ID will be VOID.
If option is "All", then the labels between the label specified by label ID and the last printed label will be VOID.
The range of how many labels can be VOID will be based on the Label number and
Label Length range on page 6.
For example, if the number of label is 3 and last label ID sent back to host is 5, the host only can send back the label ID for voiding from 3 to 5.
<VII Action="VoidLabel"> <LabelID>[label ID]</LabelID> <Option>[option]</Option>
XML Response
In case of successful command execution, 'VoidLabel ' XML response will be as listed below:
<VII Action="VoidLabel " Status="00"> </VII>
In case of error, 'VoidLabel ' XML response will be as listed below:
<VII Action="VoidLabel " Status=[error code]> </VII>
For error codes, refer to Error Codes.
VII Command Reference 31

Error Codes

The following table details the possible causes or error and its description.
Error Codes Command Possible Cause Description
00 NA NA Command status is OK
01 NA Invalid XML Wrong syntax for the respective XML
02 NA Label ID Not Found The specified label ID cannot be found in
03 NA Command Error Error in command handling
04 NA Unknown Error Invalid command/other errors
commands used
printer
32 VII Command Reference
CHAPTER

TROUBLESHOOTING

4

Problems and Possible Solutions

Problems Possible Solution
The Ethernet or wireless network connection is not working correctly
Printing stops May happen on VII mode 1/2 due to missing command from
Printer does not print label in batch mode for batch printing
Missing result/Image files Try these possible solutions:
Printer is not voiding the full label Try these possible solutions:
Try these possible solutions:
Make sure your network cable is securely connected to your printer and is straight pin-to-pin cable, not a crossover cable.
Make sure your PC is correctly configured for and connected to your network.
Make sure your printer is correctly configured for your network.
Host to printer. Drop the current connection and force the printer to discard its current state.
Try these possible solutions:
Lower the printing speed.
Reduce the network route (move the printer and host pc to the same network).
Use Ethernet connection instead of Wireless connection.
Reset Verification result by UI/Webpage/VII command.
Lower the printing speed.
Reduce the network route (move the printer and host pc to the same network).
Use Ethernet connection instead of Wireless connection.
Change the Host application implementation dedicated process/thread for receiving data rather than using the same thread/process for receiving and data handling.
Set the correct void length in printer setting
Adjust the TPH pressure to avoid media slipping.
VII Command Reference 33
Problems Possible Solution
Not able to connect to printer Try these possible solutions:
Check network status, and make sure your host PC is able to ping the printer IP address.
Check your printer setting, and make sure your printer VII service is enabled.
Check your printer setting, and make sure the expected VII ports are used.
Printer might be connected to another Host PC, disconnect the current connection.
Check your Host PC port, and make sure VII ports are not being used by other processes.
Check your firewall setting, make sure VII ports are not blocked by firewall.
Image data is not received Try these possible solutions:
Check network status, and make sure your host PC is able to ping the printer IP address
Check your printer setting, and make sure your printer VII service is enabled.
Check your printer setting, and make sure the expected VII ports are used.
Printer might be connected to another Host PC, disconnect the current connection.
Check your Host PC port, and make sure VII ports are not being used by other processes.
Check your firewall setting, make sure VII ports are not blocked by firewall.
Report data is not received Try these possible solutions:
Check network status, and make sure your host PC is able to ping the printer IP address.
Check your printer setting, and make sure your printer VII service is enabled.
Check your printer setting, and make sure the expected VII ports are used.
Printer might be connected to another Host PC, disconnect the current connection.
Check your Host PC port, and make sure VII ports are not being used by other processes.
Check your firewall setting, make sure VII ports are not blocked by firewall.
Image data is not received in real time
Try these possible solutions:
Reduce print speed
Reduce traffic congestion on network
34 VII Command Reference
CHAPTER

USE CASE SEQUENCE DIAGRAM

5

Printer Error

The use case show when printer error happen before/during printing.
VII Command Reference 35

Print Job - Pause, Resume, Cancel

This use case displays the host request to Pause/Print/Cancel print job.
Note: The pause will be executed on the next label.
36 VII Command Reference
APPENDIX

VERIFICATION REPORT

A

Sample Verification Report

<Label ID="4">
<PrintJobID>4</PrintJobID> <VerificationType>ISO 15415/15416</VerificationType> <PassingGrade>1.5 (C)</PassingGrade> <HardwareAperture>4.8 mils</HardwareAperture> <Date>20190507</Date> <Time>125652</Time> <CalibrationDate>20190221</CalibrationDate> <LabelGrade>3.3 (B)</LabelGrade> <LabelStatus>Pass</LabelStatus> <FailureReason></FailureReason> <Image>PX940V_18333B24D8_4_20190507_125652.jpg</Image> <Barcodes>3</Barcodes> <Barcode ID="1"> <Symbology>CODE39</Symbology> <Size>19.7 mils</Size> <Data>1234</Data> <EncodedData><Start>1234<Stop></EncodedData> <Grade>3.3 (B)/10/660</Grade> <Status>Pass</Status> <ScanLineDataCheck>Pass</ScanLineDataCheck> <XPos>213</XPos> <YPos>396</YPos> <Width>1530 pixels</Width> <Height>682 pixels</Height> <OverallParameter> <RMax>80.5%</RMax> <RMin Grade="4.0">18.2%</RMin> <ECMin Grade="4.0">47.2%</ECMin> <SymbolContrast Grade="3.4">62.3%</SymbolContrast> <Modulation Grade="4.0">75.9%</Modulation> <Defects Grade="4.0">11.5%</Defects> <Decodability Grade="4.0">88.9%</Decodability> <Decode Grade="4.0"/> <QuietZone Grade="4.0"/> <GlobalThreshold>49.4%</GlobalThreshold> <PCS>77.3%</PCS> <BarGain>-5.1%</BarGain> </OverallParameter> <LineProfileParameter>
VII Command Reference 37
<Line ID="1"> <Grade>3.3</Grade> <RMax>80.7%</RMax> <RMin Grade="4.0">19.9%</RMin> <ECMin Grade="4.0">44.6%</ECMin> <SymbolContrast Grade="3.3">60.8%</SymbolContrast> <Modulation Grade="4.0">73.4%</Modulation> <Defects Grade="3.4">18.1%</Defects> <Decodability Grade="4.0">90.5%</Decodability> <Decode Grade="4.0"/> <QuietZone Grade="4.0"/> <GlobalThreshold>50.3%</GlobalThreshold> <PCS>75.3%</PCS> <BarGain>-5.4%</BarGain> </Line> <Line ID="2"> <Grade>3.4</Grade> <RMax>80.7%</RMax> <RMin Grade="4.0">19.6%</RMin> <ECMin Grade="4.0">46.6%</ECMin> <SymbolContrast Grade="3.4">61.1%</SymbolContrast> <Modulation Grade="4.0">76.3%</Modulation> <Defects Grade="4.0">4.7%</Defects> <Decodability Grade="4.0">86.8%</Decodability> <Decode Grade="4.0"/> <QuietZone Grade="4.0"/> <GlobalThreshold>50.1%</GlobalThreshold> <PCS>75.7%</PCS> <BarGain>-5.9%</BarGain> </Line> <Line ID="3"> <Grade>3.4</Grade> <RMax>80.7%</RMax> <RMin Grade="4.0">19.2%</RMin> <ECMin Grade="4.0">47.0%</ECMin> <SymbolContrast Grade="3.4">61.5%</SymbolContrast> <Modulation Grade="4.0">76.5%</Modulation> <Defects Grade="4.0">11.3%</Defects> <Decodability Grade="4.0">90.1%</Decodability> <Decode Grade="4.0"/> <QuietZone Grade="4.0"/> <GlobalThreshold>49.9%</GlobalThreshold> <PCS>76.2%</PCS> <BarGain>-5.4%</BarGain> </Line> <Line ID="4"> <Grade>3.2</Grade> <RMax>80.3%</RMax> <RMin Grade="4.0">19.6%</RMin> <ECMin Grade="4.0">49.0%</ECMin> <SymbolContrast Grade="3.3">60.7%</SymbolContrast> <Modulation Grade="4.0">80.8%</Modulation> <Defects Grade="3.2">19.3%</Defects> <Decodability Grade="4.0">91.4%</Decodability> <Decode Grade="4.0"/> <QuietZone Grade="4.0"/> <GlobalThreshold>49.9%</GlobalThreshold> <PCS>75.5%</PCS>
38 VII Command Reference
<BarGain>-5.2%</BarGain> </Line> <Line ID="5"> <Grade>3.5</Grade> <RMax>80.7%</RMax> <RMin Grade="4.0">17.6%</RMin> <ECMin Grade="4.0">47.4%</ECMin> <SymbolContrast Grade="3.5">63.1%</SymbolContrast> <Modulation Grade="4.0">75.1%</Modulation> <Defects Grade="4.0">7.3%</Defects> <Decodability Grade="4.0">89.8%</Decodability> <Decode Grade="4.0"/> <QuietZone Grade="4.0"/> <GlobalThreshold>49.2%</GlobalThreshold> <PCS>78.1%</PCS> <BarGain>-4.9%</BarGain> </Line> </LineProfileParameter> </Barcode>
</Label>
Note: For more information about the contents in the sample code, refer to PX940 User
Guide.
VII Command Reference 39
40 VII Command Reference
Honeywell 9680 Old Bailes Road Fort Mill, SC 29707
www.honeywellaidc.com
PX940-VII-EN-CR-1 Rev A
03/20
Loading...