Cino 3.00.01 User Manual

Programming Reference
International Edition, Rev. 2.2 Beta Release
1
Programming Reference
Firmware

Revision Sheet

Version
Command
FS 2
Define user-defined Kanji characters
US B
IrDA setting
US C
Bluetooth setting
US b
Get IrDA configurations
RS i
Draw graphics
US 7
Paper sensor setting
US g
Get printer configuration
3.00.01
Can only be used in Japanese 2-byte fonts Add Traditional and Simplified Chinese
fonts
Cancelled
Bluetooth Setting-
Cancel Enable/Disable parameter
Cancelled
Can only draw line / box Add draw circle function, parameters and
bytes are different
[Default] n1=1; n2=0 [Default] n1=1; n2=1
Paper Sensor Setting 0x01: Reflective, Light from bottom to top
Paper Sensor Setting 0x01: Reflective, Light from top to bottom
3.00.02
0x05: Reflective top to bottom
0x05: Reflective bottom to top
This Programming Reference (Rev. 2.2) is applied for firmware 3.00.02 version. If your printer is used the previous firmware 3.00.01 version, please upgrade the firmware to 3.00.02 version.
Programming Reference
Proprietary Statement
The information contained herein is proprietary and is provided sorely for the purpose of allowing customers to operate and maintain the equipment described herein. PC Worth Int’l Co., Ltd. reserves the right to make changes in specifications and other information contained in this document without prior notice.
Liability Disclaimer
PC Worth makes no warranty of any kind with regard to this publication, including, but not limited to, the implied warranty of merchantability and fitness for any particular purpose. PC Worth shall not be liable for technical or editorial errors or omissions contained herein; nor for incidental consequential damages in connection with the furnishing, performance, or use of this publication. This publication contains proprietary information that is protected by copyright. All rights are reserved. No part of this publication may be photocopied, reproduced or translated into any language, in any forms, in an electronic retrieval system or otherwise, without the prior written permission of PC Worth.
No Liability for Consequential Damage
In no event shall PC Worth 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, damages for loss of business profits, business interruption, loss of business information, or other pecuniary loss) arising out of the use of or the results of use of or inability to use such product, even if PC Worth has been advised of the possibility of such damages.
Trademarks & Copyright
All registered and unregistered trademarks used herein are the exclusive property of their respective owners.
© Copyright PC Worth Int'l Co., Ltd. © Copyright Cino Group
Programming Reference

Table of Contents

Chapter 1 Introduction.................................................................................................. 1
JCL Command Sets ...........................................................................................................................2
Commands Comparison between JCL and ESC/POS.......................................................................3
ESC / POS Emulation ...............................................................................................................3
JCL Feature Command Sets.....................................................................................................7
Chapter 2 Command Overview...................................................................................10
Command Notation .......................................................................................................................... 11
Explanation of Terms........................................................................................................................ 12
Supported Commands ....................................................................................................................15
Commands Listed by Function................................................................................................. 16
Commands Listed in Alphanumeric Order................................................................................ 22
Chapter 3 Command Descriptions..............................................................................28
HT…………………………………………………………………………………………………………...…29
LF……………………………………………………………………………………………………………....30
FF………………………………………………………………………………………………………………31 CR……………………………………………………………………………………………………………...32
CAN.................................................................................................................................................. 33
ESC FF ............................................................................................................................................ 34
ESC SP ............................................................................................................................................35
Programming Reference
ESC !................................................................................................................................................36
ESC $............................................................................................................................................... 37
ESC %.............................................................................................................................................. 38
ESC & .............................................................................................................................................. 39
ESC * ...............................................................................................................................................41
ESC -................................................................................................................................................ 43
ESC 2............................................................................................................................................... 44
ESC 3............................................................................................................................................... 45
ESC ?............................................................................................................................................... 46
ESC @ .............................................................................................................................................47
ESC {................................................................................................................................................48
ESC D .............................................................................................................................................. 49
ESC E .............................................................................................................................................. 51
ESC G ..............................................................................................................................................52
ESC J ...............................................................................................................................................53
ESC L............................................................................................................................................... 55
ESC M.............................................................................................................................................. 57
ESC R .............................................................................................................................................. 58
ESC S .............................................................................................................................................. 59
ESC T............................................................................................................................................... 60
ESC V .............................................................................................................................................. 62
ESC W ............................................................................................................................................. 63
ESC \................................................................................................................................................ 66
ESC a............................................................................................................................................... 67
ESC d............................................................................................................................................... 68
ESC t................................................................................................................................................69
Programming Reference
FS !...................................................................................................................................................70
FS & ................................................................................................................................................. 72
FS - ..................................................................................................................................................73
FS 2..................................................................................................................................................74
FS S ................................................................................................................................................. 75
FS W ................................................................................................................................................ 77
FS p..................................................................................................................................................78
FS q..................................................................................................................................................79
GS !.................................................................................................................................................. 82
GS $................................................................................................................................................. 85
GS ( K ..............................................................................................................................................86
GS ( k ...............................................................................................................................................88
GS *................................................................................................................................................134
GS /................................................................................................................................................ 136
GS :................................................................................................................................................ 138
GS ^ ............................................................................................................................................... 140
GS B...............................................................................................................................................142
GS C 0 ...........................................................................................................................................143
GS C 1 ...........................................................................................................................................145
GS C 2 ...........................................................................................................................................147
GS H ..............................................................................................................................................148
GS I................................................................................................................................................ 149
GS L............................................................................................................................................... 150
GS P...............................................................................................................................................152
GS W..............................................................................................................................................154
GS \…………………………………………………………………………………………………………..155
Programming Reference
GS c ...............................................................................................................................................156
GS f................................................................................................................................................ 158
GS h............................................................................................................................................... 159
GS k ...............................................................................................................................................160
GS v 0 ............................................................................................................................................ 169
GS w ..............................................................................................................................................171
RS A............................................................................................................................................... 172
RS B............................................................................................................................................... 173
RS E............................................................................................................................................... 174
RS F ...............................................................................................................................................175
RS G .............................................................................................................................................. 176
RS J ............................................................................................................................................... 177
RS L ............................................................................................................................................... 178
RS a ............................................................................................................................................... 179
RS e ............................................................................................................................................... 181
RS i ................................................................................................................................................ 182
RS m .............................................................................................................................................. 189
RS n ............................................................................................................................................... 190
RS p ............................................................................................................................................... 190
RS q ............................................................................................................................................... 193
RS r................................................................................................................................................195
RS t ................................................................................................................................................ 197
RS u ............................................................................................................................................... 199
US 1 ............................................................................................................................................... 201
US 2 ............................................................................................................................................... 202
US 3 ............................................................................................................................................... 203
Programming Reference
US 4 ............................................................................................................................................... 204
US 7 ............................................................................................................................................... 205
US A............................................................................................................................................... 206
US C............................................................................................................................................... 208
US G .............................................................................................................................................. 209
US H............................................................................................................................................... 210
US I ................................................................................................................................................ 211
US J ............................................................................................................................................... 212
US K............................................................................................................................................... 213
US L ............................................................................................................................................... 214
US M .............................................................................................................................................. 215
US a ............................................................................................................................................... 216
US c ............................................................................................................................................... 218
US g ............................................................................................................................................... 220
US h ............................................................................................................................................... 222
US k ............................................................................................................................................... 224
US m .............................................................................................................................................. 225
US n ............................................................................................................................................... 226
US r................................................................................................................................................227
Programming Reference

Introduction

Thank you for choosing Cino VersaJet Mobile Printer. The VersaJet mobile printer is designed with rugged yet lightweight architecture, delivering the ultimate convenience of mobility to meet your on-demand labels and receipts printing requirements.
Besides RS232 communication interfaces, the VersaJet is compatible with most Bluetooth-enabled devices by incorporating Bluetooth
This Programming Guide provides complete descriptions on command functions and instructs programmer to configure your VersaJet efficiently. If you need more information, please contact your supplier or visit our web site for details.
This guide is organized into the following chapters:
Introduction
Commands Overview
2.0 wireless technology. You can select the most suitable model to fulfill your demand.
Commands Descriptions
1
Programming Reference

JCL Command Sets

ESC/POS (Epson Standard Code for Point of Sales) is one of the most world-popular command sets, which was designed to provide the expandability and universal applicability demanded by the market. The JCL (Job Control Language) is the proprietary printer language of Cino mobile printer supporting ESC/POS emulation. This not only shortens user’s learning cycle, but also minimizes the system integration efforts.
Furthermore, the VersaJet possesses more practical and useful command sets than ESC/POS., such as the manipulation on serialization, graphics and 2D bar codes printing. You may refer to “Command Comparison between JCL and ESC/POS “ for more details.
2
Programming Reference
Commands Comparison between JCL and ESC/POS
ESC / POS Emulation
Command Descriptions
HT LF FF Print and return to standard mode (in page mode) CR CAN ESC FF ESC SP ESC ! ESC $ ESC % ESC & ESC * ESC -
Set right-side character spacing
Horizontal tab
Print and line feed
Print and carriage return
Cancel print data in page mode
Print data in page mode
Select print mode(s)
Set absolute print position
Select/cancel user-defined character set
Define user-defined characters
Select bit-image mode
Turn underline mode on/off
ESC 2 ESC 3
3
Select default line spacing
Set line spacing
Programming Reference
Command Descriptions
ESC ? ESC @ ESC { ESC D ESC E ESC G ESC J ESC L ESC M ESC R ESC S ESC T ESC V
Print and feed paper
Select page mode
Select print direction in page mode
Cancel user-defined characters
Initialize printer
Turn upside-down printing mode on/off
Set horizontal tab positions
Turn emphasized mode on/off
Turn double-strike mode on/off
Select character font
Select an international character set
Turn 90 colockwise rotation mode on/off
Select standard mode
ESC W ESC \ ESC a ESC d ESC t
4
Set printing area in page mode
Set relative print position
Select justification
Print and feed n lines
Select character code table
Programming Reference
Command Descriptions
FS ! FS & FS ­FS 2 FS S FS W FS p FS q
GS ! Select character size GS $ Set absolute vertical print position in page mode GS ( K Adjust printing density GS * Define downloaded bit image GS / Print downloaded bit image
Set print mode(s) for Kanji characters
Select Kanji character mode
Turn underline mode on/off for Kanji character
Define user-defined Kanji characters
Set left – and right –side Kanji character spacing
Turn quadruple-size mode on/off for Kanji characters
Read the image file from flash memory
Define image, write to flash memory
GS : Start/end macro definition GS I
GS L
Set horizontal and vertical motion units
GS P
5
Transmit printer ID
Set left margin
Programming Reference
Command Descriptions
GS \ GS ^ GS H
Select font for HRI characters
GS f GS h
Print bar code
GS k GS v 0 GS W GS w GS B
Print raster bit image
Set bar code width
Set relative vertical print position in page mode
Execute macro
Select printing position of Human Readable Interpretation (HRI) characters
Set bar code height
Set printing area width
Turn white/black reverse printing mode on/off
6
Programming Reference
JCL Feature Command Sets
Command Descriptions
GS C 0 GS C 1 GS C 2 GS c GS ( k RS A RS B
Clear buffer
RS E RS F RS G RS J RS L RS a
Select counter print mode
Select counter mode
Sets the serial number counter value
Print counter setup
Specify and print the symbol
Label length measurement
Restore factory default
Remote power off
Paper feed to TOF position
Rewind command (back feed)
Print self-test (Pre-defined)
Bit-map text format setting
RS e RS i RS m
7
1D bar code generic setting
Draw graphics
Save *.bmp image into flash
Programming Reference
Command Descriptions
RS n RS p RS q RS r RS t RS u US 1 US 2 US 3 US 4 US 7 US A US C
Print *.bmp image
Set number of copies of printing data
Serialization setting
Print serialization
Define flash macro
Execute macro
Top of form control
Top of form offset setting
Auto tear-off control
Tear-off offset setting
Paper sensor setting
RS232 setting
Bluetooth setting
US G US H US I US J
US K
Buzzer control
Auto power off duration setting
Set printing intensity (darkness)
Automatic status feedback
Default operation mode setup
8
Programming Reference
Command Descriptions
US L US M US a US c US g US h US k US m US n US r
Feed key control
Panel buttons control
Get RS232 configurations
Get Bluetooth configurations
Get printer configurations
Get system information
Get head resistance
Get printing log
Get battery status
Get printer status
9
Programming Reference

Command Overview

This chapter covers following topics to present the supported commands that are used with VersaJet:
Command Notation
Explanations of Terms
Supported Commands
10
Programming Reference

Command Notation

[Name] The name of the command. [Format] The code sequence. [Range] Gives the allowable ranges for the arguments. [Default] Gives the default values, if any, for the command parameters. [Description] Describes the command’s function. [Notes] Provides important information on setting and using the printer command, if necessary.
Hex indicates the hexadecimal equivalents. Decimal indicates the decimal equivalents.
[ ]k indicates the contents of the [ ] should be repeated k times.
11
Programming Reference

Explanation of Terms

(1) Receive buffer
The receive buffer is a buffer that stores, as is, the data received from the host (the reception data). The reception data is stored in the receive buffer temporarily, and is then processed sequentially.
(2) Print buffer
The print buffer is a buffer that stores the image data to be printed.
(3) Print buffer full
This is the state where the print buffer is full. If new print data is input while the print buffer is full, the data in the print buffer is printed out and a line feed is executed. This is the same operation as the LF operation.
(4) Start of line
The start of line state satisfies the following condition:
There is no print data (including spaces and portions of data skipped due to bit image data) currently in
the print buffer.
There is no print data (including portions of data skipped due to HT) The print position is not specified by the ESC $ or ESC \ command.
12
Programming Reference
(5) Printable area
The maximum range within which printing is possible under the printer specifications. The printable area for this printer is as follows:
The length of the horizontal direction in standard mode:
approximately 48 mm {1.89 “}
The length of the vertical direction in page mode:
approximately 160 mm {6.3 “}
(6) Printing area
Printing range is set by the command. It must be printing area printable area.
(7) Ignore
The state in which all codes, including parameters, are read in and discarded, and nothing happens.
(7) Inch
An unit of length. One inch is 25.4 mm.
(8) MSB
Most Significant Bit
13
Programming Reference
(9) LSB
Least Significant Bit
(11) Base line
Standard position when character data is stored in the print buffer.
Normal character in standard mode and page mode:
A y *
* When font A (12×24 dots) is selected, this height is for 24 dots.
* When font B (9×24 dots) is selected, this height is for 24 dots.
Base line
Rotated character in standard mode (only when font A is selected):
10 dots
Base line
14
Programming Reference

Supported Commands

In these tables, click any name to see the command description. Please refer following instructions before you utilize these commands to configure your VersaJet:
Standard mode
: Enabled. () : Enabled only when the command is used at the beginning of command codes. : Enabled only when data is not present in the printer buffer. Ignored : All command codes including parameters are ignored.
Page mode
 : Enabled.
: Only for value setting. Disabled : Parameters are processed as printable data. Ignored : All command codes including parameters are ignored.
Classification
Executing : The changes do not affect the following data. Setting : The changes do affect the following data until power off.
Note : The changes caused by “Flash Command” will be still valid after power on/off .
15
Programming Reference

Commands Listed by Function

Function
Type
Command
Name
Command
Descriptions
Classification Standard
Mode
Page
Mode
Print LF Print and line feed Executing
Print FF Print and return to standard mode (in page mode) Executing Ignored
Print CR Print and carriage return Executing
Print ESC FF Print data in page mode Executing Ignored
Print ESC J Print and feed paper (distance controlled by “GS P”) Executing
Print ESC d Print and feed n lines Executing
Line Spacing ESC 2 Select default line spacing Setting
Line Spacing ESC 3 Set line spacing Setting
Character CAN Cancel print data in page mode Executing Ignored
Character ESC SP Set right-side character spacing Setting
Character ESC ! Select print mode(s) Setting
Character ESC % Select/cancel user-defined character set Setting
Character ESC & Define user-defined characters Setting
Character ESC – Turn underline mode on/off Setting
Character ESC ? Cancel user-defined characters Setting
Character ESC { Turn upside-down printing mode on/off Setting ()
Character ESC E Turn emphasized mode on/off Setting
Character ESC G Turn double-strike mode on/off Setting
16
Programming Reference
Function
Type
Command
Name
Command
Descriptions
Classification Standard
Mode
Page
Mode
Character ESC M Select character font Setting
Character ESC R Select an international character set Setting
Character ESC V Turn 90° clockwise rotation mode on/off Setting
Character ESC t Select character code table Setting
Character GS ! Select character size Setting
Character GS B Turn white/black reverse printing mode on/off Setting
Character RS a Bit-map Text Format Setting Setting
Print Position ESC $ Set absolute print position Executing
Print Position ESC \ Set relative print position Executing
Print Position ESC D Set horizontal tab positions Setting
Print Position ESC T Select print direction in page mode Setting
Print Position ESC W Set printing area in page mode Setting
Print Position ESC a Select justification Setting ()
Print Position GS $ Set absolute vertical print position in page mode Executing Ignored
Print Position GS \ Set relative vertical print position in page mode Executing Ignored
Print Position GS L Set left margin Setting ()
Print Position GS W Set printing area width Setting ()
Print Position HT Horizontal tab Executing
17
Programming Reference
Function
Type
Command
Name
Command
Descriptions
Classification Standard
Mode
Page
Mode
Bit Image ESC * Select bit-image mode Executing
Bit Image GS * Define downloaded bit image Setting
Bit Image GS / Print downloaded bit image Executing
Bit Image GS v 0 Print raster bit image Executing
Bit Image FS p Read the image file from flash memory Executing
Bit Image FS q Define image, write to flash memory Executing
BMP Image RS m Save *.bmp image into flash Setting
BMP Image RS n Print *.bmp image Executing
Graphics RS i Draw Line/Box Executing Ignored
Executing
Macro GS : Start/end RAM macro definition
Setting
Macro GS ^ Execute RAM macro Executing
Macro RS t Define Flash macro Setting+Executing
Macro RS u Execute Flash macro Executing
Kanji FS ! Set print mode(s) for Kanji characters Setting
Kanji FS - Turn underline mode on/off for Kanji characters Setting
Kanji FS & Select Kanji character mode Setting
Kanji FS 2 Define user-defined Kanji characters Setting
18
Programming Reference
Function Type
Command
Name
Command
Descriptions
Classification Standard
Mode
Page
Mode
Kanji FS S Set left- and right-side Kanji character spacing Setting
Kanji FS W Turn quadruple-size mode on/off for Kanji character Setting
Miscellaneous ESC @ Initialize printer
Miscellaneous ESC L Select page mode Executing () Ignored
Miscellaneous ESC S Select standard mode Executing Ignored
Miscellaneous GS ( K [49] Printing density setup Executing
Miscellaneous GS I Transmit printer ID Executing
Miscellaneous GS P Set horizontal and vertical motion units Setting
Miscellaneous GS c Print counter Executing
Miscellaneous RS p Set number of copies of printing data Setting+Executing
Bar Code GS ( k Specify and print the symbol Executing
Bar Code
GS H
Select printing position of Human Readable
Interpretation (HRI) characters
Executing
Setting
Setting
Bar Code
Bar Code
Bar Code
Bar Code
Bar Code RS e 1D Bar code Generic Setting Setting
GS f Select font for HRI characters Setting
GS h Set bar code height Setting
GS k Print bar code Executing
GS w Set bar code width Setting
19
A
A
Programming Reference
Function
Type
Command
Name
Command
Descriptions
Classification Standard
Mode
Page
Mode
Set configuration
Set configuration
Set configuration
Set configuration
Set configuration
Set configuration
Set configuration
Set configuration
Set configuration
Get configuration
Get configuration US c Get Bluetooth configurations Executing
Get configuration US g Get printer configurations Executing
Get configuration US h Get system information Executing
US A RS232 Setting Setting
US C Bluetooth setting Setting
US G Buzzer control Setting
US H
US I Set printing intensity (darkness) Setting
US J
US K Default operation mode setup Setting
US L Feed key control Setting
US M Panel buttons control Setting
US a Get RS232 configurations Executing
uto power off duration setting Setting
utomatic status feedback Setting
Get configuration US k Get head resistance Executing
Get configuration US m Get printing log Executing
Get configuration US n Get battery status Executing
Get configuration US r Get printer status Executing
20
A
A
A
A
A
A
A
A
A
Programming Reference
Function
Type
Command
Name
Command
Descriptions
Classification Standard
Mode
Page
Mode
ction Command RS A Label length measurement Executing
ction Command RS B Restore factory default Executing
ction Command RS E Clear buffer Executing
ction Command RS F Remote power off Executing
ction Command RS G Paper feed to TOF position Executing
ction Command RS J Rewind distance (back feed) Executing
ction Command RS L Print self-test (pre-defined) Executing
Paper Sensor US 1 Top of form control Setting
Paper Sensor US 2 Top of form offset setting Setting
Paper Sensor US 3
Paper Sensor US 4
Paper Sensor US 7 Paper sensor setting Setting
Serialization GS C 0 Select counter print mode Setting
uto tear-off control Setting
uto Tear-off offset setting Setting
Serialization GS C 1 Select counter mode Setting
Serialization GS C 2 Sets the counter value Setting
Serialization RS q Serialization setting Setting
Serialization RS r Print Serialization Executing
21
Programming Reference
Commands Listed in Alphanumeric Order
Command
Name
Function
Type
Command
Descriptions
Classification Standard
Mode
Page
Mode
HT Print Position Horizontal tab Executing
LF Print Print and line feed Executing
FF Print Print and return to standard mode (in page mode) Executing Ignored
CR
CAN Character Cancel print data in page mode Executing Ignored
ESC FF Print Print data in page mode Executing Ignored
ESC SP Character Set right-side character spacing Setting
ESC ! Character Select print mode(s) Setting
ESC $ Print Position Set absolute print position Executing
ESC % Character Select/cancel user-defined character set Setting
ESC & Character Define user-defined characters Setting
ESC * Bit Image Select bit-image mode Executing
ESC – Character Turn underline mode on/off Setting
Print Print and carriage return Executing
ESC 2 Line Spacing Select default line spacing Setting
ESC 3 Line Spacing Set line spacing Setting
ESC ? Character Cancel user-defined characters Setting
Executing+
ESC @ Miscellaneous Initialize printer
Setting
22
Loading...
+ 205 hidden pages