Citizen CMP-20 Troubleshooting guide

MOBILE THERMAL PRINTER
MODEL CMP-20 series
Windows CE and Windows Mobile Module
Program Manual
Rev.1.00

- 2 -
1. Instruction.
2. Method.
2.1. OpenPort
2.2. ClosePort
2.3. PrintNormal
2.4. PrintString
2.5. PrintText
2.6. PrintBitmap
2.7. PrintBarCode
2.8. LineFeed
2.9. PrinterCheck
2.10. status
2.11. PrintNVBitmap
2.12. MSRSelectTrack
2.13. MSRReadTrackDual
2.14. MSRReadCancel
2.15. PrintText2Image
2.16. PrintPDF417
2.17. PrintQRCode
3. Command List supported by PrintNormal() function in OLE
POS Command.
TABLE OF CONTENTS

- 3 -
1. Instruction.
This Windows CE and Windows Mobile Module Program Manual describes the function
which is exposed from DDL file needed in developing Windows CE & Mobile OS application.

- 4 -
2. Method.
-Functions for using in dll are defined in CITIZEN2.h file.
Development environment is based on Evc++.
2.1.OpenPort
This function is used for opening ports in order to use Moldule(DLL).
long
OpenPort(
LPCTSTR PortName,
long BaudRate
)
[Parameter]
* PortName
- Pointer to a null-terminated Unicode string that specifies the name of the object, such
as COM port. When connecting Bluetooth it sets virtual port name of connected device.
When connecting Wi-Fi it sets IP Address of connected device.
* BaudRate
- In order to set up the transmission speed of connected device, it sets speed.
When connecting Bluetooth, it sets virtual port speed of the connected device.
When connecting Wi-Fi, it sets port number of the connected device.
[Return Values]
LK_SUCCESS : This value returns when a function succeeds.
LK_FAIL : This value returns when a function fails.
2.2. ClosePort
This function is used for closing ports to cancel the use of Module(DLL).
long
ClosePort()
[Return Values]
LK_SUCCESS : This value returns when a function succeeds.
LK_FAIL : This value returns when a function fails.

- 5 -
2.3. PrintNormal
This function is used for supporting text printing and OLE POS command.
long
PrintNormal(
LPCTSTR Data
)
[Parameter]
* Data
- Pointer to a null-terminated Unicode string. It is same as PrintNormal function in OLE
POS Command.
For command list, please refer to the Page-16 ~ Page-18.
[Return Values]
LK_SUCCESS : This value returns when a function succeeds.
LK_FAIL : This value returns when a function fails.
2.4. PrintString
This function is used for supporting text printing with ESC command.
long
PrintString(
LPCTSTR Data
)
[Parameter]
* Data
- Pointer to a null-terminated Unicode string. It sets Unicode String to print.
[Return Values]
LK_SUCCESS : This value returns when a function succeeds.
LK_FAIL : This value returns when a function fails.

- 6 -
2.5. PrintText
This function is used for supporting text printing
long
PrintText(
LPCTSTR Data,
long Alignment,
long Attribute,
long TextSize
)
[Parameter]
* Data
- Pointer to a null-terminated Unicode string. It sets Unicode text to print.
* Alignment
- This value is alignment. It sets text alignment.
Variable Description
LK_ALIGNMENT_LEFT Left alignment
LK_ALIGNMENT_CENTER Center alignment
LK_ALIGNMENT_RIGHT Right alignment
* Attribute
- This value is text attributes. It sets text attributes to print.
Variable Description
LK_FNT_DEFAULT FontA, Set up as a standard
LK_FNT_FONTB Set up as FontB
LK_FNT_BOLD Set up as Bold attribute
LK_FNT_UNDERLINE Set up as Underline attribute
* TextSize
- This value is text size. It sets text size to print.
Variable (Set up width ratio) Description
LK_TXT_1WIDTH Set up width ratio as x1
LK_TXT_2WIDTH Set up width ratio as x2
LK_TXT_3WIDTH Set up width ratio as x3
LK_TXT_4WIDTH Set up width ratio as x4
LK_TXT_5WIDTH Set up width ratio as x5
LK_TXT_6WIDTH Set up width ratio as x6
LK_TXT_7WIDTH Set up width ratio as x7
LK_TXT_8WIDTH Set up width ratio as x8

- 7 -
Variable (Set up height ratio) Description
LK_TXT_1HEIGHT Set up height ratio as x1
LK_TXT_2HEIGHT Set up height ratio as x2
LK_TXT_3HEIGHT Set up height ratio as x3
LK_TXT_4HEIGHT Set up height ratio as x4
LK_TXT_5HEIGHT Set up height ratio as x5
LK_TXT_6HEIGHT Set up height ratio as x6
LK_TXT_7HEIGHT Set up height ratio as x7
LK_TXT_8HEIGHT Set up height ratio as x8
[Return Values]
LK_SUCCESS : This value returns when a function succeeds.
LK_FAIL : This value returns when a function fails.
2.6. PrintBitmap
This function is used for printing image files[Bmp file].
long
PrintBitmap(
LPCTSTR BitmapName,
long Alignment,
long Mode
)
[Parameter]
* BitmapName
- Pointer to a null-terminated Unicode string. This value is the bitmap file name with full
path of bitmap file.
* Alignment
- This value is alignment. It sets image alignment..
Variable Description
LK_ALIGNMENT_LEFT Left alignment
LK_ALIGNMENT_CENTER Center alignment
LK_ALIGNMENT_RIGHT Right alignment
* Mode
- This value is dithering mode. It sets dithering mode.
Variable Description
LK_BITMAP_NO_DITHER Process image as B/W Level
LK_BITMAP_ERROR_DIFFUSION Process image as Error Diffusion Level
LK_BITMAP_ORDERED_DITHER Process image as Ordered Dither Level

- 8 -
[Return Values]
LK_SUCCESS : This value returns when a function succeeds.
LK_FAIL : This value returns when a function fails.
2.7. PrintBarCode
This function is used for supporting barcode printing.
long
PrintBarCode(
LPCTSTR Data,
long Symbology,
long Height,
long Width,
long Alignment,
long TextPosition)
[Parameter]
* Data
- Pointer to a null-terminated Unicode string. It sets the barcode data to print.
* Symbology
- This value is barcode symbol type. It sets barcode type to print.
Variable Description
LK_BCS_UPCA Print UPC A BarCode
LK_BCS_UPCE Print UPC E BarCode
LK_BCS_EAN8 Print EAN-8 BarCode
LK_BCS_EAN13 Print EAN-13 BarCode
LK_BCS_JAN8 Print JAN-8 BarCode
LK_BCS_JAN13 Print JAN-13 BarCode
LK_BCS_ITF Print Interleaved 2 of 5
LK_BCS_Codabar Print Codabar BarCode
LK_BCS_Code39 Print Code 3 of 9 BarCode
LK_BCS_Code93 Print Code 93 BarCode
LK_BCS_Code128 Print Code 128 BarCode
LK_BCS_3OF5 Print 3 out of 5(KorMail) BarCode
* Height
- This value is barcode height in Dot Units. It sets barcode height to print.
* Width
- This values barcode width in Dot Units. It sets total barcode width to print.
* Alignment
- This value is alignment. It sets barcode alignment.

- 9 -
Variable Description
LK_ALIGNMENT_LEFT Left alignment
LK_ALIGNMENT_CENTER Center alignment
LK_ALIGNMENT_RIGHT Right alignment
* TextPosition
- This value is printing position of barcode HRI letters(barcode data).
Variable Description
LK_HRI_TEXT_NONE Do not print barcode data
LK_HRI_TEXT_ABOVE Print barcode data above the barcode
LK_HRI_TEXT_BELOW Print barcode data below the barcode
[Return Values]
LK_SUCCESS : This value returns when a function succeeds.
LK_FAIL : This value returns when a function fails.
2.8. LineFeed
This function is used for sending feeding command to printer.
long
LineFeed(
long LFCount
)
[Parameter]
* LFCount
- This value is the number of lines for line feeding. It sets line feeding counter.
[Return Values]
LK_SUCCESS : This value returns when a function succeeds.
LK_FAIL : This value returns when a function fails.

- 10 -
2.9. PrinterCheck
This function is used for printer status checking.
long
PrinterCheck()
[Return Values]
LK_SUCCESS : This value returns when a function succeeds.
LK_FAIL : This value returns when a function fails.
2.10. status
This function is used for getting the printer status.
long
status()
[Return Values]
LK_STS_NORMAL: Printer Status is No Error and MSR is not Ready.
LK_PAPER_EMPTY : Printer Status is no paper.
LK_COVER_OPEN : Printer Cover is open.
LK_BATTERY_LOW : Printer battery capacity is low.
LK_STS_MSR_READ : Currently MSR in read mode, printing is impossible.
2.11. PrintNVBitmap
This function is used to support the Bitmap Image printing stored in Flash Memory.
long
PrintNVBitmap (long NVImageNumber)
[Parameter]
* NVImageNumber
- It sets the Number image stored in Flash Memory to print.
[Return Values]
LK_SUCCESS : This value returns when a function succeeds.