#!/usr/bin/env python # -*- coding: utf-8 -*- # # (c) Copyright 2003-2006 Hewlett-Packard Development Company, L.P. # # This program is free software; you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by # the Free Software Foundation; either version 2 of the License, or # (at your option) any later version. # # This program is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty of # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the # GNU General Public License for more details. # # You should have received a copy of the GNU General Public License # along with this program; if not, write to the Free Software # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA # # Author: Don Welch # __version__ = '2.5' __title__ = 'Printer Cartridge Alignment Utility' __doc__ = "Cartridge alignment utility for HPLIP supported inkjet printers." # Std Lib import sys import re import getopt # Local from base.g import * from base import device, status, utils, maint from prnt import cups USAGE = [(__doc__, "", "name", True), ("""Usage: hp-align [PRINTER|DEVICE-URI] [OPTIONS]""", "", "summary", True), utils.USAGE_ARGS, utils.USAGE_DEVICE, utils.USAGE_PRINTER, utils.USAGE_SPACE, utils.USAGE_OPTIONS, utils.USAGE_BUS1, utils.USAGE_BUS2, utils.USAGE_LOGGING1, utils.USAGE_LOGGING2, utils.USAGE_LOGGING3, utils.USAGE_HELP, utils.USAGE_EXAMPLES, ("""Align CUPS printer named 'hp5550':""", """$ hp-align -php5550""", "example", False), ("""Align printer with URI of 'hp:/usb/DESKJET_990C?serial=12345':""", """$ hp-align -dhp:/usb/DESKJET_990C?serial=12345""", 'example', False), utils.USAGE_SPACE, utils.USAGE_NOTES, utils.USAGE_STD_NOTES1, utils.USAGE_STD_NOTES2, utils.USAGE_SEEALSO, ("hp-clean", "", "seealso", False), ("hp-colorcal", "", "seealso", False), ] def usage(typ='text'): if typ == 'text': utils.log_title(__title__, __version__) utils.format_text(USAGE, typ, __title__, 'hp-align', __version__) sys.exit(0) def enterNumber(text, minimum, maximum): while True: x = raw_input(utils.bold(text)) if len(x) > 0 and x[0] in ['q', 'Q']: return False, 0 try: x = int(x) except ValueError: log.error("You must enter a numeric value.") continue if x < minimum or x > maximum: log.error("You must enter a number between %d and %d." % (minimum, maximum)) continue break return True, x def enterAlignmentNumber(letter, hortvert, colors, line_count, maximum): return enterNumber("Enter the best aligned value for line %s (1-%d): " % (letter, maximum), 1, maximum) def enterPaperEdge(maximum): return enterNumber("Enter numbered arrow that is best aligned with the paper edge (1-%d): " % maximum, 1, maximum) def colorAdj(line, maximum): return enterNumber("Enter the numbered box on line %s that is best color matched to the background color (1-%d): " % (line, maximum), 1, maximum) def loadPlainPaper(): x = raw_input(utils.bold("An alignment page will be printed.\nPlease load plain paper into the printer. Press to contine or 'q' to quit.")) if len(x) > 0 and x[0].lower() == 'q': return False return True def bothPensRequired(): log.error("Cannot perform alignment with 0 or 1 cartridges installed.\nPlease install both cartridges and try again.") def invalidPen(): log.error("Invalid cartridge(s) installed.\nPlease install valid cartridges and try again.") def invalidPen2(): log.error("Invalid cartridge(s) installed. Cannot align with only the photo cartridge installed.\nPlease install other cartridges and try again.") def aioUI1(): log.info("To perform alignment, you will need the alignment page that is automatically\nprinted after you install a print cartridge.") log.info("If you would like to cancel, enter 'C' or 'c'") log.info("If you do not have this page (and need it to be printed), enter 'N' or 'n'") log.info("If you already have this page, enter 'Y' or 'y'") while 1: x = raw_input(utils.bold("Enter 'C', 'c'; 'Y', 'y'; 'N', or 'n': ")) if len(x) > 0: x = x.lower() if x[0] in ['c', 'y', 'n']: break log.warning("Please enter 'C', 'c'; 'Y', 'y'; 'N' or 'n'.") if x[0] == 'n': return False elif x[0] == 'c': sys.exit(0) elif x[0] == 'y': return True def type10and11Align(pattern, align_type): controls = maint.align10and11Controls(pattern, align_type) values = [] s_controls = controls.keys() s_controls.sort() for line in s_controls: if not controls[line][0]: values.append(0) else: cont, value = enterNumber( "Enter the numbered box on line %s where the inner lines best line up with the outer lines (1-%d): " % ( line, controls[line][1] ), 1, controls[line][1] ) if not cont: sys.exit(0) values.append(value) return values def aioUI2(): log.info("") log.info(utils.bold("Follow these steps to complete the alignment:")) log.info("1. Place the alignment page, with the printed side facing down, ") log.info(" in the scanner.") log.info("2. Press the Enter or Scan button on the printer.") log.info('3. "Alignment Complete" will be displayed when the process is finished (on some models).') try: opts, args = getopt.getopt(sys.argv[1:], 'p:d:hl:b:ag', ['printer=', 'device=', 'help', 'help-rest', 'help-man', 'logging=', 'bus=' ] ) except getopt.GetoptError: usage() log.set_module("hp-align") printer_name = None device_uri = None bus = device.DEFAULT_PROBE_BUS log_level = logger.DEFAULT_LOG_LEVEL align_debug = False if os.getenv("HPLIP_DEBUG"): log.set_level('debug') for o, a in opts: if o in ('-h', '--help'): usage() elif o == '--help-rest': usage('rest') elif o == '--help-man': usage('man') elif o in ('-p', '--printer'): if a.startswith('*'): printer_name = cups.getDefault() else: printer_name = a elif o in ('-d', '--device'): device_uri = a elif o in ('-b', '--bus'): bus = a.lower().strip() if not device.validateBusList(bus): usage() elif o in ('-l', '--logging'): log_level = a.lower().strip() if not log.set_level(log_level): usage() elif o == '-g': log.set_level('debug') elif o == '-a': align_debug = True if device_uri and printer_name: log.error("You may not specify both a printer (-p) and a device (-d).") usage() utils.log_title(__title__, __version__) if not device_uri and not printer_name: try: device_uri = device.getInteractiveDeviceURI(bus) if device_uri is None: sys.exit(0) except Error: log.error("Error occured during interactive mode. Exiting.") sys.exit(0) try: d = device.Device( device_uri, printer_name ) except Error, e: log.error("Unable to open device: %s" % e.msg) sys.exit(0) if d.device_uri is None and printer_name: log.error("Printer '%s' not found." % printer_name) sys.exit(0) if d.device_uri is None and device_uri: log.error("Malformed/invalid device-uri: %s" % device_uri) sys.exit(0) try: try: d.open() except Error: log.error("Device is busy or in an error state. Please check device and try again.") sys.exit(1) if d.isIdleAndNoError(): align_type = d.mq.get('align-type', 0) log.debug("Alignment type=%d" % align_type) if align_type == ALIGN_TYPE_NONE: log.error("Alignment not supported or required by device.") sys.exit(0) if align_type == ALIGN_TYPE_AUTO: maint.AlignType1(d, loadPlainPaper) elif align_type == ALIGN_TYPE_8XX: maint.AlignType2(d, loadPlainPaper, enterAlignmentNumber, bothPensRequired) elif align_type in (ALIGN_TYPE_9XX,ALIGN_TYPE_9XX_NO_EDGE_ALIGN): maint.AlignType3(d, loadPlainPaper, enterAlignmentNumber, enterPaperEdge, update_spinner) elif align_type == ALIGN_TYPE_LIDIL_AIO: maint.AlignType6(d, aioUI1, aioUI2, loadPlainPaper) elif align_type == ALIGN_TYPE_DESKJET_450: maint.AlignType8(d, loadPlainPaper, enterAlignmentNumber) elif align_type in (ALIGN_TYPE_LIDIL_0_3_8, ALIGN_TYPE_LIDIL_0_4_3, ALIGN_TYPE_LIDIL_VIP): maint.AlignxBow(d, align_type, loadPlainPaper, enterAlignmentNumber, enterPaperEdge, invalidPen, colorAdj) elif align_type == ALIGN_TYPE_LBOW: maint.AlignType10(d, loadPlainPaper, type10and11Align) elif align_type == ALIGN_TYPE_LIDIL_0_5_4: maint.AlignType11(d, loadPlainPaper, type10and11Align, invalidPen2) else: log.error("Invalid alignment type.") else: log.error("Device is busy or in an error state. Please check device and try again.") finally: d.close() log.info("") log.info('Done.')