Changes between Version 3 and Version 4 of HowTo

Timestamp:

Aug 14, 2008, 9:29:05 PM (16 years ago)

Author:

losepete

Comment:

--

HowTo

@@ +1 @@
+A CUPS and eCS (OS/2) How To: Revision 1 14/08/2008
+
+Author: Peter Brown
+email: losepete@ntlworld.com
+
+
+
+
+CONTENTS
+
+
+Brief Preamble
+
+Why install CUPS? - and what is it?
+
+List of required software
+
+Brief description of the software packages
+
+Installation
+
+Configuration of CUPS Printer
+
+        USB printers
+
+        CUPS printer
+
+Creating a Desktop Printer Object to use with CUPS
+
+
+
+
+
+Brief Preamble
+==============
+
+
+Hopefully this text will provide a clear enough "How To" for anyone to be able to follow.
+
+I am using my experience of getting a Canon PIXMA iP4000 inkjet printer working with, firstly, CUPS and then creating an OS/2 Printer Object that is capable of outputting print jobs through CUPS.
+
+I do use specific Drive Letter(s) in the following text that would need to be changed to reflect the correct drive letter on other systems. Most of the Paths used are specific to the CUPS installation; those that are not would need to be changed for other systems.
+
+
+
+
+Why install CUPS? - and what is it?
+===================================
+
+
+Common Unix Printing System answers the "what is it?" bit.
+
+
+Why install CUPS? - Simply because it is capable of supporting a lot of modern printers and is continually updated. The old OS/2 printer drivers are not that good, if you can find a driver that works, with modern raster printers and those drivers will not be updated.
+
+CUPS can provide drivers for more current printers - and should provide any extra capabilities missing from the OS/2 drivers.
+
+
+The object of the exercise is to end up with an eCS(OS/2) postscript printer object that prints using CUPS.
+
+
+
+
+List of required software
+=========================
+
+
+CUPS port - http://download.smedley.info/cups-1.3.7-gplgs-8.62-gutenprint-5.2.0-beta3-os2-20080616.zip
+
+LibC files required - http://download.smedley.info/libc064x.zip
+                    - ftp://ftp.netlabs.org/pub/gcc/libc-0.6.3-csd3.zip
+
+Gutenprint printer driver package http://download.smedley.info/gutenprt-5.2.0-beta3-os2-20080713.zip
+
+eCUPS printer port - http://download.smedley.info/cupsportdriver-20080628.zip
+
+PRNDRV.EXE - http://www.os2site.com/sw/comm/faxworks/prndrv.exe
+
+
+
+
+Brief description of the software packages
+==========================================
+
+
+CUPS consists of several packages that work together to provide postscript printing on raster printers
+
+The LibC files are required support files
+
+The Gutenprint package is a replacement for the OS/2 pscript.drv package and has most of the popular CUPS PPD (simplified) files already included
+
+The eCuPS printer port provides the "hook up" between the OS/2 Printer Object and the CUPS printer
+
+PRNDRV.EXE - a useful command line utility for listing installed printers and deleting those that are not wanted
+
+
+
+
+Installation
+============
+
+
+Put the PRNDRV.EXE file somewhere that you can find it; I put it into J:\Programs\Utils\PrnDrv
+
+The libc0*.dll files should be put into either \ecs\dll or \os2\dll 
+
+The basic CUPS Install consists of unzipping the package:
+
+The CUPS package MUST be unzipped to the ROOT of the drive, which should give you 3 new directories: \cups, \gutenprint and \gs
+NOTE: the readme.os2 file will end up in the drive root directory unless unzipped seperately into the \cups directory - which is how I unzipped it.
+
+Have a read of the readme.os2 before proceeding just to get an idea of what you are going to do; especially if attempting to setup a USB printer.
+
+
+Other files are unzipped later as/when/if they are required
+
+
+
+
+Configuration of CUPS Printer
+=============================
+
+
+
+USB printers
+------------
+
+
+CUPS does not currently support printing to USB printers but there is a workaround.
+
+1] Create a Printer object using the Null printer driver and select the USB port as the Output Port in the printer object Properties
+
+2] Start the OS/2 lpd daemon (\tcpip\bin\lpd.exe)
+
+
+When creating the CUPS printer in the below section (CUPS printer) use lpd://localhost/<printer_name> as the Device URI:  where <printer_name> is the name given to the OS/2 Printer object created in 1] above.
+
+
+
+CUPS printer
+------------
+
+Start \cups\sbin\cupsd.exe
+
+I created a program object for this with the Start Minimized and Close Window on exit checked in the Properties, Session tab. This object can be put in the Startup folder so that cupsd.exe is started automatically at bootup.
+
+
+As the CUPS browser admin interface seems to be working here I recommend using that interface to Add a Printer. Fire up your browser and point it at http://localhost:631/ (cups home page) and when that has loaded click Add Printer.
+
+
+I added the following Canon PIXMA P4000 colour inkjet (raster) printer and will be using this printer as the example. The text after the "-" is to outline the purpose
+
+Name: PIXMA  - what you want to call the printer
+
+Location: Router LPT1  - where it is physically located; ie connected to the Router's LPT1 port
+
+Description: Canon PIXMA iP4000 Inkjet - brief description of printer
+
+Continue -  click when happy with above section
+
+
+Device: LPD/LPR Host or Printer -  type of Device connection
+
+Continue -  click when happy with above section
+
+ 
+Device URI: lpd://192.168.2.1/lpt1 -  address of device
+
+Continue -  click when happy with above section
+
+
+Make: Canon -  select printer make
+
+Continue -  click when happy with above section
+
+
+Model: Canon PIXMA iP4000 - CUPS+Gutenprint v5.2.0-beta3(en) Simplified -  select correct driver; Simplified recommended
+
+Add Printer -  click when happy with above section
+
+
+
+After clicking Add Printer the interface informs me that the printer has been added and loads the options for the printer - this can take a little while. It is a good idea to have a look through and make sure the options look useable - especially Media Size, Resolution and Image Type. When satisfied click Set Printer Options and the interface reports "Printer PIXMA has been configured successfully."
+
+I then clicked on the Printers tab and then clicked the Print Test Page button. Shortly after the Test Page popped out of the printer looking fine.
+
+Well, that is the very easy bit finished...
+
+
+ 
+Referring to the readme.os2 file I used the command line to print a 2 page document; I opened a command line window in \cups\bin and gave it a try:-
+
+
+[H:\cups\bin]lpr -P PIXMA \cups\share\cups\data\PReCS20.ps
+
+
+After a short wait the printer burst into action and delivered 2 pages of output that look fine.
+
+
+That is the next easy bit finished...
+
+
+
+
+
+
+Creating a Desktop Printer Object to use with CUPS
+==================================================
+
+
+Now to hook CUPS up to the rest of the system so that CUPS can be used for output by applications such as OpenOffice Writer (wordprocessor) and PMView (images).
+
+
+Unzip cupsportdriver-20080628.zip
+
+        cups.pdr into h:\os2\dll
+
+        cupslpr.exe into h:\tcpip\bin
+
+
+
+
+Right Mouse Button on the new Desktop Printer Object and select Properties
+
+        Select Printer driver tab
+        Check the Default printer driver is correctly selected
+        Set Job Properties: Paper Size, Tray, Media Type, Resolution must match the settings in the CUPS printer - and Save
+        
+        Select Output port tab
+        Click Install new port button
+        Select the CUPS1 port and click Install
+                - if the port is not visible but the CUPS.pdr file is in \os2\dll Click New port drivers and set the 
+                  directory to \os2\dll and click Find. The CUPS ports should appear.
+        The settings for the CUPS port are
+                Host: localhost - or use 127.0.0.1
+                Printer: PIXMA  (this should be the same name as used for the CUPS printer)
+
+        Close Printer Properties
+
+
+That should be setup complete so time to print a test page
+
+        Verify that cupsd.exe is running *Before* testing
+
+        Drag'n'Drop \cups\share\cups\data\testprint.ps onto the new Desktop Printer Object
+        
+        Select Printer-specific in the following dialog
+
+
+You should get the CUPS Test Page printed from your OS/2 Desktop Printer Object 
+
+You can repeat the above test using the \cups\share\cups\data\PReCS20.ps file to test 2 page document printing.
+
+
+Both tests were successful here.
+
+
+
+
+
+
+
+
+An earlier version of the How To:-
 
 == A CUPS and eCS (OS/2) How To ==