Windows Driver Specifications (Function, Setting, Specifications) For Ver. 2.28 / Ver.1690 6-1-12 Tanashi-cho, Nishi-Tokyo-shi, Tokyo 188-8511 JAPAN Tel 81-424-68-4631 Fax 81-424-68-4740 sales-op@systems.citizen.co.jp http://www.citizen-systems.co.
Index Index.......................................................................................................................................................- 1 Revision history (2.xx/1.6xx) ..................................................................................................................- 3 Revision history (1.xx) ............................................................................................................................- 3 1. Operating systems..........................
11. Printer Status..................................................................................................................................- 54 11.1 Getting Printer Status ...............................................................................................................- 54 11.2 Enable/Disable Bi-directional Communication ..........................................................................- 56 12. Example of Usage for specific software ............................................
Revision history (2.xx/1.6xx) Date 09/06/25 09/010/29 09/12/15 Version V2.00 V2.01 V2.02 10/05/20 10/5/27 V2.02 (modified) V2.23 10/11/25 V2.24 11/4/13 V2.25/1.660 12/6/15 13/3/1 V2.27/1.680 13/7/22 V2.28/V1.690 Details Issued Added CT-S601 Added CT-S281 and CT-S4000 Windows7 is supported Status function is supported on all the drivers. Driver port setting function is added. Status monitor library is added. Added CT-S651 and CT-S851 Version number is changed to same version as driver itself.
07/3/20 V1.57 07/04/30 V1.57a 07/12/21 V1.581 08/07/02 1.582 08/12/25 1.582a 09/04/08 1.583 09/12/15 1.600 10/2/9 10/6/21 1.610 (not released) 1.630 11/1/6 1.640 Another problem of feed length after barcode printing is fixed. Problem of unstable character size is fixed. CT-S4000 Label driver is added. BD2-2220/2221 is added. “Printer Features“ function is added to print in fixed length. Drivers are adapted to Windows Vista Euro mark problem is solved.
File version of driver and related files Windows Driver : Ver2.28 or Ver.1.690 Status Monitor Library : Ver1.3.4 CITIZEN Printer COM Port : Ver1.1.0 (Installed with 2.xx series driver only) CITIZEN Driver Port Setting : Ver2.0.0 (Installed with 2.xx series driver only) Journal Viewer : Ver1.4.0.0 (Installed and working with 2.xx series driver only) TCP/IP Port Monitor : Ver1.
Caution (1) You are hereby notified that any dissemination, distribution or copying of this document without written consent is strictly prohibited. (2) The contents of this document are subject to change without prior notice. (3) We tried to ensure the content of this document but if you find any mistakes, please let us know. (4) Regardless of article (3), we cannot be responsible for any damages/influences caused by the use of this driver.
1. Operating systems Our drivers are designed to work on any of following operating systems. Microsoft Windows 2000 (SP4) Microsoft Windows XP Microsoft Windows Server 2003 Microsoft Windows Vista Microsoft Windows 7 Microsoft Windows 8 Server OS based on the above 2. Supported printer drivers Supported driver and its function are as follows. Ver.2.
Dot impact printer Control Board CD-S500 CD-S501/503 BD2-222x BD2-428x (ESC/POS)No cut function (ESC/POS)With cut function For LT2xxx mechanism For MLT428x mechanism Remarks: Ver.1.6xx drivers do not support “Electronic Journal”, “Watermark”, “Upside Down”, “Coupon” and “Reprint” function. 3. Supported interfaces Supported interfaces are as follows. Serial / CITIZEN COM Parallel USB USB Virtual COM LAN or Wireless LAN / CITIZEN TCP/IP (This document does not cover TCP/IP port driver.
4. Driver setting Follow the steps bellow to access function to change the printer driver setting 4.1 “General” tab Select the printer properties for the printer driver by right clicking on the printer icon. Then Press the “Preferences” button in the General Tab. Then press the “Advanced” button.
There are some items for the printer setting. 4.1.1 Paper Size You can choose the paper size. Listed paper size depends on the printer driver. Default paper size depends on printer driver. * Custom paper can be used. Please refer to the explanation of paper width and paper length in this document.
4.1.2 NV Logo Process NV logo registration method can be chosen here. When printing logo function is used as mentioned in section 4.1.10 Logo Printing, the chosen method is used. “FS q” is old way “GS (L” is new. Default is basically “GS ( L”. NV logo registration by “FS q” is done altogether for multiple logo data and ID numbers are added sequentially. NV logo registration by “GS ( L” can be done for each logo data individually and key code with 2 characters can be added by user.
4.1.3 Paper Type You can choose Receipt or Ticket as paper types. Receipt allows flexible paper length according to the data length to avoid waste of paper. Ticket print in fixed length even the print data is short. Default setting is “Receipt” 4.1.4 Paper Media Choose the type of the paper to use from either normal paper or label/BM paper. *If Label/Black Mark paper is not supported for the model, you cannot choose Label/BM Paper. * If you use Label/Black mark, 4.1.
4.1.5 Paper Feed Behavior and paper feeding length can be set for end of middle page (Page) and end of last page (Job). Feed Length (dot) : It can be set from 0 to 406 dots. Auto Feed to Cut Position : Automatic paper feeding for the cut can be set for valid/invalid. *If Auto Feed to Cut Position is set for valid and Feed Length is specified, paper feed to cut position is done first then specified paper feed is performed. 4.1.
* Partial cut mean that cutter leaves one tab by the cut. * This menu is not shown on the driver model where the cutter is not equipped. * There is “Partial only” in the memory switch setting. If this setting is valid, “Full Cut” works only as “Partial Cut” automatically. Please refer User’s manual for the details of memory switches. 4.1.7 Cash Drawer #1, #2 Setting of cash drawer 1/2 can be changed. Timing to open drawer, pulse width to send to drawer for opening can be changed.
4.1.8 Buzzer Buzzer function of printer can be utilized from the driver. The timing of buzz can be selected from top of receipt (Job Start) or end of receipt (Job End). Number of buzz can be selected from 1 to 9. Default setting is no buzz. * Driver model which does not have buzzer does not show this menu.
4.1.9 Bar Code Printing HRI character setting can be changed. (HRI character is the character which comes with barcode.) No HRI, Top, Bottom or both (Top and Bottom) can be selected. Default is not HRI characters. Please refer to section of Barcode in this document for the details * Driver model which does not have barcode function does not show this menu. 4.1.10 Logo Printing The setting of NV logo printing function can be changed.
* As mentioned in section “4.1.2 NV Logo Process”, there are 2 different commands to register logo data. Please make sure if the NV logo data is registered by FS q command or GS (L command. Please refer to command reference for the details of the command. * If “FS q” command is used, each logo data is recognized as follows.
4.2 Electronic Journal Data (Ver.2.xx drivers only) Electronic journal is the function to save printed data in the PC. The setting for this function can be done as follows. From the Properties of printer driver, choose "Preferences". Choose “Advanced” tab.
To enable Electronic Journal Viewer function, put the check mark in "Record Journal". Press "Browse" of Base Folder then you can specify the folder to store the journal data. Default folder is "c:¥CITIZEN¥EJD"。 If you want to change the folder, please make the folder in advance.
Press "Apply" or "OK" to finish the setting. It is possible to display/print electronic journal data from journal viewer. Choose “Tool” tab.
Press "Launch" of Journal Viewer Journal Viewer shows up and you can see journal data in the viewer and the data can be printed from viewer * Under the specified folder to save journal data, folders are generated with the name of data in - 21 -
“yymmdd” format and journal data files are saved in the folder with the name of time in “hhmmss.ejd” format. * Each print job is saved as individual journal data file. * The path length of folder to save journal data must be within 100 characters (Unicode). * Do not use network driver for destination folder to save journal data.
4.2.1 Journal Viewer * Journal data is grouped by folder by the date. It is possible to display or print the journal data of the specified day in "Calendar". There are journal data on the date which is shown in bold in the Calendar. * By right-click on the Calendar, the menu to go back today is shown. * "EJD Folder" is the folder that the journal data is stored. Usually, it should be same folder as the one that printer driver specifies for saving the journal data.
* NV logo, printer font and barcode font cannot be shown correctly on the viewer because those are realized by the function of printer side. Substitute image of NV logo, barcode or 2D barcode will replace NV logo data, barcode data and 2D barcode. And generic font replaces printer font on the viewer. Therefore, the impression on the viewer is different from actual printing results. * Journal data which include special function like Control font may show garbage character on the viewer.
4.3 Watermark (Ver.2.xx drivers only) It is possible to print data with overlapping the image data which is specified in advance. From the Properties of printer driver, choose "Preferences". Choose "Advanced" tab.
To enable Water mark function, put check mark in "Embed Watermark" and press "Add" to specify the watermark image data. Then specify the position of overlapping from "Top", "Middle" or "Bottom". * The watermark image data to use for overlapping is black/white bitmap format data only. * Size of watermark image data is limited in horizontally 1023 pixels width. There is no limit for vertical size. Paper size limitation of driver is effective for watermark image size as well.
4.4 Upside Down Printing (Ver.2.xx drivers only) Printing data in upside down can be done by this function. From the Properties of printer driver, choose "Preferences". Choose "Advanced" tab.
To enable upside down printing, put check mark in "Upside Down Printing". * Printer font is printed upside down as well. * NV logo saved by “GS (L” command cannot be printed upside down. Please save the upside down data in advance.
4.5 Coupon printing (Ver.2.xx drivers only) Coupon printing is the function like this. Coupon image data is specified to link with a keyword and if the keyword is found in the print data, the coupon image data is printed automatically. From the Properties of printer driver, choose "Preferences". Choose "Coupon" tab.
To enable coupon function, check mark in "Print Coupon". Add ”Coupon” information * To register the information of the coupon, press “Add”. “Add Coupon Information” dialogue shows up. "Keyword", "Replacing Characters" and "Coupon Image" need to be registered on it as a set. * Coupon information up to 10 can be registered. Coupon information has to be aligned in priority order. Upper information in the list has higher priority and lower information has lower priority.
When the corresponding characters are found, characters are replaced by “Replacing characters” of first coupon information. The same routine is repeated from 2nd coupon information to last coupon information. * Because of the above routine flow, the replaced characters in higher priority coupon information can be re-replaced by the low priority coupon information. ・ *** Limitation of coupon printing function Limitation of character * Character replacing does not work for TrueType font.
4.6 File Sender The data file to send to printer can be transmitted to the printer using this function. There is no data added by the driver and the data file itself is simply transmitted to the printer. From the Properties of printer driver, choose "Tool" tab. Press “Browse of "File Sender" and specify the file to send to the printer. The data is sent to printer by pressing "Send". * This function can be used for the purpose such as loading firmware data.
4.7 POS Printer Utility If the utility software is installed, it can be launched as follows. From the Properties of printer driver, choose "Tool" tab. Press "Launch POS Printer Utility" of "External Tool".
This is the launched screen. Please refer to the HELP file of POS Printer Utility for the details of POS Printer Utility. *Remarks:If the status monitoring function is active, the communication between PC and printer takes longer time. *If the driver is installed with status monitoring function enabled through Plug & Play, interface such as parallel or USB, the communication right after the diver installation may fail. In such case, please reboot PC then the communication becomes stable.
4.8 Reprint (Ver.2.xx drivers only) The last print job can be re-printed by this function. From the Properties of printer driver, choose "Tool" tab. Press “Reprint” of "Reprint". * If printing is done before PC reboot, the last data before the boot can be reprinted. * Target of reprint function is 1 print job. If the print data covers more than 1 page, the reprinted data is not the last page but whole print data of last print job.
* Reprint data is not handled as Electronic journal data. * The print data sent by File Sender cannot be reprinted. To use this reprint function, journal viewer function must be installed.
4.9 Driver Port Setting This is to change the time-out setting etc. for the status monitoring function, when necessary. From Start menu, CITIZEN=> Driver Port => Driver Port Setting 2 Dialog shows up.
・It is possible to set time-out duration for sending/receiving data through each interface (USB, COM, LPT, LAN) ・To change the time-out duration setting, change the number of time-out setting and press “Save” button then at Print Spooler Control, press “Restart” button. (or press “Stop” button and press “Start” button.) ・If ”Driver Watch Mode” is check-marked, printer status is always monitored and the interval to check the status is fixed by “Watch xxx [ms]”.
4.11 Version list List of versions for driver files can be shown. On “Tool” tab of the printer driver property page, press “Version” button. Version information is shown for the each file which consists of printer driver.
5. Printer fonts Printer font is the characters stored in the printer. Printing by printer font is much faster than printing by TrueType font. Therefore, we recommend using these printer fonts for faster printing. Following printer fonts can be selected by using Windows driver. Driver CBM1000II CT-S280 CT-S281 CT-S300 CT-S310 CT-S310II CT-S601 CT-S651 CT-S801 CT-S851 CT-S2000 CT-S4000 CT-P29x PMU2xxx PMU2xxxIIIPresenter PPU-700 BD2-222x BD2-428x Font 15 cpi 15 cpi [Euro] 15 cpi [Ext.
CBM1000II CT-S280 CT-S281 CT-S300 CT-S310 CT-S310II CT-S601 CT-S651 CT-S801 CT-S851 CT-S2000 CT-S4000 CT-P29x PMU2xxx PMU2xxxIIIPresenter PPU-700 BD2-222x BD2-428x 12.5 cpi [Ext.] 12.5 cpi [RED Euro] 12.5 cpi [RED Ext.] 12.5 cpi (RED) 6.25 cpi 6.25 cpi [Euro] 6.25 cpi [Ext.] 6.25 cpi [RED Euro] 6.25 cpi [RED Ext.] 6.25 cpi (RED) 3 cpi 3 cpi [Euro] 3 cpi [Ext.] 3 cpi [RED Euro] 3 cpi [RED Ext.] 3 cpi (RED) FontA11 FontA11 [255] FontA11 [Ext.] FontA12 FontA12 [255] FontA12 [Ext.
FontB44 FontB44 FontB48 FontB48 FontB48 FontB84 FontB84 FontB84 FontB88 FontB88 FontB88 Control CD-S500 series [255] [Ext.] 38.5 (CT-S2000) 54.5 (CT-S310) 77 (CT-S2000) [255] [Ext.] 27 (CT-S310) 38.5 (CT-S2000) [255] [Ext.] 54.5 (CT-S310) 77 (CT-S2000) [255] [Ext.] 16 cpi 16 cpi [Euro] 16 cpi [Ext.] 16 cpi [RED Euro] 16 cpi [RED Ext.] 16 cpi (RED) 8 cpi 8 cpi [Euro] 8 cpi [Ext.] 8 cpi [RED Euro] 8 cpi [RED Ext.] 8 cpi (RED) 12 cpi 12 cpi [Euro] 12 cpi [Ext.] 12 cpi [RED Euro] 12 cpi [RED Ext.
~ FF hex. The details of difference are as follows. Font xxx cpi 80-9F(hex) A0-FF(hex) Special function WPC1252 xxx cpi [Euro] WPC1252 xxx cpi [Ext.] Code Page 437 Special function: Special functions are assigned. (Refer to section 9 for the special functions.) Windows Code: Characters from Windows code table are assigned. Code Page 437: Characters from code page 437 are assigned. * “xx cpi”, “xx cpi(RED)” font: If the number is smaller, character width is larger.
6. Barcode Using following font, barcode can be printed on the printer.
7. 2D Barcode 7.1 Format of the 2D barcode font 2 dimensional barcode symbologies (QR code and PDF417) can be printed by following printer fonts of this driver. 2D Barcode font QR_CONTROL Font size 9.5 Function QR code command setting Control character _M1 _M2 _W01 ~ _W16 _EL _P None Specify the encoded QR data. _D00 ~ _D30 _P Set the number of digits of PDF417. 00 is processed automatically. Process by the number of specified digits excluding 00. Set the number of steps of PDF417.
with 2D barcode font. *As the 2D barcode font is the function of the driver, 2D barcode image cannot be shown on the application software or print preview on the Windows. Only print data is shown as text. *If Orientation is set for Landscape on the printer, 2D barcode cannot be printed. *Printer font cannot be used by Visual Basic.Net, Visual C.Net 7.2 2D Barcode Font Usage The steps to print 2D barcode are as follows.
' Set the format of the QRCode. 'model2, module width 2, error level M, number 33 of QR data. Printer.FontSize = 9.5 Printer.FontName = "QR_CONTROL" Printer.Print "_M2_W02_EM_N0033"; ' Specify the encoded QR data. Printer.FontSize = 9.5 Printer.FontName = "QR_DATA" Printer.Print "http://www.citizen-systems.co.jp/"; 'Print QRCode data. Printer.FontSize = 9.5 Printer.FontName = "QR_CONTROL" Printer.Print "_P"; Printer.EndDoc ‘Set the format of the PDF417.
8. Graphic printing function Graphic printing is supported by this driver. The resolution is as follows. Resolution (DPI) Thermal Printers 203 x 203 TrueType font is printed as graphic by this driver. ・If the long size graphic data is printed with the horizontal paper orientation, a gap about 1mm may be generated. ・Print data size of graphic printing is large. Therefore serial interface is not adequate for graphic printing because of its slow communication speed.
9. Special functions To use special function of printer, it is necessary to send specified character in “Control” font. If other font is used, it does not work for the special functions.
10. Paper sizes By installing driver, paper sizes (combination of supported paper width and various paper lengths) are automatically added. The details of length and width are as follows. A) Length Paper length a) A4 length (297mm) b) B5 length (257mm) c) 6 in Page (6 in) d) Letter length (11 in) e) Executive length (10.5 in) f) Receipt (3276 mm) g) User-Defined size B) Width Model Paper width CT-S280/281 58mm (32Col.) 58mm (30Col.) CT-P290/291 58mm (36Col.) CT-S300/310 80mm (48Col.
CD-S500 series 76mm 69.5mm 58.5mm * As mentioned in previous section, if the “Paper Type” is set for “Receipt” and print data is shorter than paper size, printing is finished before reaching the specified paper size with cutting paper or just stopping printing. If the “Paper Type” is set for “Ticket”, the printer continues paper feeding until reaching the chosen paper size. * It is not possible to choose f) Receipt (3276 mm) size from application software like MS-Word or MS-ACCESS.
* User defined paper can be set up by following way. The size that user can define depends on the printer driver. Windows 7 Open “Devices and Printers” and choose any printer. Then “Print server properties” button is shown on the top menu. Press the button. Other OS From menu of “Printer and Faxes” window, File -> Server Properties "Print Servers Properties" is shown like right picture. On "Forms" tan, put check mark in "Create a new form".
* The range of paper size that user can define is as follows.
11. Printer Status 11.1 Getting Printer Status Uses own language monitor (Status monitor), bidirectional communication is enabled and it get possible to get the printer status through existing Windows driver. Please make sure that “Enable bidirectional support” is chosen. Set the printer memory switch 1-3 Busy condition ON (Full) When printer status is changed, the message on the top of spooler window or status column of driver list is changed immediately.
(Driver list) Shown messages depend on the printer status as follows.
11.2 Enable/Disable Bi-directional Communication Turn the printer on while printer and PC is connected. If checkbox of “Enable bidirectional support” on property page of driver is ticked, bidirectional communication is enabled. If it is not ticked, bidirectional communication is disabled. After changing this setting, please restart printer spooler without fail. Run following command on Command Prompt (On Vista or later, choose “Run as administrator” by right-click) to restart the printer spooler.
net stop spooler net start spooler Stopping printer spooler Starting printer spooler - 57 -
12. Example of Usage for specific software 12.1 Example of usage by Microsoft Word Example to use printer font on MS-Word2003 A.From the menu, click File--> Print --> Printer Name Choose the printer to use then click Close button. B. Then from menu File --> Page setting --> Paper size And choose the paper size to use. C. Then move to Margin tab and Set the proper margins. (If you set the margins to zero, it will be corrected to minimum number automatically after the error message.) D.
12.2 Example of program by Visual Basic Following is the Visual Basic 6.0 program list for “CITIZEN CT-S2000” to utilize various printing and special functions. ' Set “CT-S2000“ as default printer driver Dim X As Printer For Each X In Printers If X.DeviceName = “CITIZEN CT-S2000” Then Set Printer = X Exit For End If Next ‘Printing Windows font Printer.FontSize=10 Printer.FontName=”Arial” Printer.Print “Font Arial / Size 10” ‘Printing Printer font Pritner.FontSize=12 Printer.FontName=”15 cpi” Printer.
12.3 Example of program by Visual C++ Following is the Visual C++ 6.0 program list using MFC library. // Get the DEVMODE structure of printer to use // lpdevmode is the pointer for got DEVMODE structure // Generate device context of specified printer HDC hdc; hdc = CreateDC(_T("CITIZEN CT-S2000"), _T("CITIZEN CT-S2000"), NULL, lpdevmode); if (!hdc) return; // Attach the printer device context to CDC CDC PrinterCDC; PrinterCDC.
PrinterCDC.SelectObject(poldFont); setFont.DeleteObject(); ypos += setSize.cy; // Cash drawer setFont.CreatePointFont(12*10, _T("Control"), &PrinterCDC); poldFont = PrinterCDC.SelectObject(&setFont); txtPrintData = _T("A"); setSize = PrinterCDC.GetTextExtent(txtPrintData); PrinterCDC.TextOut(0, ypos, txtPrintData); PrinterCDC.SelectObject(poldFont); setFont.DeleteObject(); ypos += setSize.cy; // Cut paper setFont.CreatePointFont(12*10, _T("Control"), &PrinterCDC); poldFont = PrinterCDC.