Gutenprint + CUPS backends for Dye Sublimation printers
Go to file
Solomon Peachy c3b9e14aea kodak6800: Finish merging into new multi-call paradigm. 2013-07-18 20:32:44 -04:00
icm icm: Add ICC profiles for Shinko/Sinfonia S2145 2013-07-06 11:01:21 -04:00
testjobs sony_updr150: Add a new experimental backend for the Sony UP-DR150 printer. 2013-07-14 15:55:35 -04:00
.gitattributes Initial commit of current sources. 2012-10-26 22:06:47 -04:00
.gitignore kodak6800: 75% of new backend migration completed. Main loop is all that's left. 2013-07-18 18:03:40 -04:00
COPYING [misc] Add GPLv3 license text. 2012-10-26 23:41:11 -04:00
Makefile kodak6800: 75% of new backend migration completed. Main loop is all that's left. 2013-07-18 18:03:40 -04:00
README documentation updates to reflect global EXTRA_VID/PID/TYPE 2013-07-18 00:09:59 -04:00
backend_common.c kodak6800: 75% of new backend migration completed. Main loop is all that's left. 2013-07-18 18:03:40 -04:00
backend_common.h kodak6800: 75% of new backend migration completed. Main loop is all that's left. 2013-07-18 18:03:40 -04:00
kodak1400_print.c all: Unify find_and_enumerate function. 2013-07-17 23:39:31 -04:00
kodak6800_print.c kodak6800: Finish merging into new multi-call paradigm. 2013-07-18 20:32:44 -04:00
selphy_print.c all: Unify find_and_enumerate function. 2013-07-17 23:39:31 -04:00
shinko_s2145_print.c all: Unify find_and_enumerate function. 2013-07-17 23:39:31 -04:00
sony_updr150_print.c common: Finish multi-exec handling, including auto backend detection based on environment and/or argv[0] 2013-07-18 12:45:35 -04:00

README

 ***************************************************************************

  CUPS Backends for various Dye-Sublimation photo printers

  (c) 2007-2013 Solomon Peachy <pizza@shaftnet.org>

  The latest version of these programs can be found at
  
    http://git.shaftnet.org/git/gitweb.cgi?p=selphy_print.git

  For a list of known bugs and development plans, see:

    http://bugs.shaftnet.org/index.php?project=4

 ***************************************************************************
  Supported Printers for each backend:

   canon-selphy: All Canon SELPHY ES and SELPHY CP printer models 
   	           (see below)
   kodak-1400:   Kodak Professional 1400
                 Kodak 805 Photo Printer
   kodak-6800:   Kodak 6800 Photo Printer
   skinko-s2145: Shinko/Sinfonia CHC-S2145 
   sony-updr150: Sony UP-DR150

 ***************************************************************************
  Compilation:

     You will need libusb-1.0 to build this tool.

     Fedora/RedHat:
	yum install libusb1-devel
     Debian/Ubuntu
	apt-get install libusb-1.0-0-dev

   And all you need to do after that is type 'make'

 ***************************************************************************
  CUPS backend usage:

   The simple method is to use Gutenprint 5.2.10 or newer, which bundles 
   (possibly older versions of) these backends.  Without Gutenprint to
   rasterize the print data, these backends are useless.

   The backends need to be owned by root, with 0700 file permissions in order
   to function properly.

   To install these backends for use with CUPS, simply type 'make install'.

   You may need to restart CUPS afterwards.

 ***************************************************************************
  Standalone usage:

  	backend filename
	backend - < filename
	somecommand | backend -

     [[ where 'backend' is the program name, eg 'canon-selphy_print' ]]

   NOTE: The 'filename' here refers to the raw spool data generated by
         Gutenprint (eg via its gimp plugin) or the Windows print-to-file 
	 output.

         If there is more than one device present that the backend handles,
   	 the backend will choose the first supported device it finds. If you
	 wish to specify the specific device when operating in standalone 
	 mode, set the 'DEVICE' environment variable to the target device's
	 serial number. For example:

	  	  DEVICE=N782 backend filename

         All backends support an additional operational mode, to test out
	 unknown models. To use this mode, specify the VID, PID and its 
	 type as environment variables. For example:

	 	EXTRA_VID=04a9 EXTRA_PID=3ab1 EXTRA_TYPE=3 backend filename

		EXTRA_VID is the USB VID, in hex
		EXTRA_PID is the USB PID, in hex
		EXTRA_TYPE is:	3 for SELPHY CP790
			   	4 for SELPHY CP520 (or other CP-series model)

	 If you have a model the spooler doesn't recognize but it works with
	 a VID/PID/TYPE specification, please let me know via e-mail.

  	 Finally, some backends may support additional arguments; see below:

 *************************************************************************** 
  canon-selphy backend:

   Verified supported printers:
  
     ES1, ES2, ES3, ES30, ES40, CP-100, CP-200, CP-300, CP-330, CP400, 
     CP500, CP510, CP710, CP720, CP730, CP740, CP750, CP760, CP770, CP780, 
     CP800, CP900

   Unverified/untested, but should work:

     ES20, CP-220, CP530, CP600, CP810

   Semi-supported (has problems)

     CP-10

   NOT currently supported by libusb backend:  (USB PIDs unknown)  **
	
     CP520, CP790

    ** Note that a VID/PID can be supplied on the command line, see above.
       Once the VIDs/PIDs are known, these printers are expected to work.

 *************************************************************************** 
  kodak-1400 backend:

   This backend fully supports the Kodak 1400 and Kodak 805 medium-format
   printers.

   This backend supports additional commands:

      kodak-1400_print [command [arg] ]

   Valid commands:

     -stc filename      Set tone curve [1]

  Notes:

    [1]  Format of curvedata file:

    	 256 entries each of Yellow, Magenta, Cyan mappings:
	 Values are unsigned 16-bit big endian, between 0 and ???
	 (unsure as to the bit usage)

 *************************************************************************** 
  kodak-6800 backend:

   This backend fully supports the Kodak 6800 kiosk printer.

   The Kodak 6850 is likely supported, but needs testing.

   This backend supports additional commands:

      kodak-6800_print [command [arg] ]

   Valid commands:

     -qtc filename      Query tone curve [1]
     -stc filename      Set tone curve   [1]

  Notes:

    [1]  Format of curvedata file:

    	 256 entries each of Yellow, Magenta, Cyan mappings:
	 Values are unsigned 16-bit big endian, between 0 and 16383
	 (ie 14-bit)

 *************************************************************************** 
  shinko-s2145 backend:

   This backend fully supports the Shinko/Sinfonia CHC-S2145 kiosk printer.

   Development was sponsored by:

        LiveLink Technology [ www.livelinktechnology.net ]

   In order to use this backend, you will need to ensure the printer is
   configured to use the 'DRV' (as opposed to 'DLL') operating mode.  See 
   the printer documentation for details on how to set this.

   This backend supports additional commands:

      shinko-s2145_print [command [arg] ]

   Valid commands:

     -qs                Query printer status
     -qm		Query media information
     -qf		Query firmware version
     -qe		Query Error log
     -qu		Query User String
     -qtu filename	Query User tone curve (stored in flash)  [2]
     -qtc filename	Query Current tone curve (stored in RAM) [2]
     -su  somestring    Set User String to 'somestring'
     -stu filename      Set User tone curve (stored in flash)    [2]
     -stc filename      Set Current tone curve (stored in RAM)   [2]
     -pc  id            Cancel print job 'id'                    [1]
     -fl  		Flash printer LEDs for five seconds.
     -ru		Reset User tone curve to default         [3]
     -rp		Reset printer to factory defaults
     -b1		Enable printer control panel buttons
     -b0		Disable printer control panel buttons

  Notes:

    [1]  Job ID is the Internal Job ID (reported via status)
    	   This cancels a multi-copy print job.
	   To see which jobs are active/pending, see the output of the
	   '-qs' command, specifically the 'Bank' output.

    [2]  Format of curvedata file:

    	 256 entries each of Yellow, Magenta, Cyan mappings:
	 Values are unsigned 16-bit big endian, between 0 and 2047 
	 (ie only 11 bits used)

    [3]  Default printer tone curve is a linear 'val << 3'

 *************************************************************************** 
  sony-updr150 backend:

   This backend fully supports the Sony UP-DR150 Digital Photo Printer.