]>
git.ipfire.org Git - thirdparty/cups.git/blob - backend/ieee1284.c
2 * "$Id: ieee1284.c 7687 2008-06-24 01:28:36Z mike $"
4 * IEEE-1284 support functions for the Common UNIX Printing System (CUPS).
6 * Copyright 2007-2008 by Apple Inc.
7 * Copyright 1997-2007 by Easy Software Products, all rights reserved.
9 * These coded instructions, statements, and computer programs are the
10 * property of Apple Inc. and are protected by Federal copyright
11 * law. Distribution and use rights are outlined in the file "LICENSE.txt"
12 * "LICENSE" which should have been included with this file. If this
13 * file is missing or damaged, see the license at "http://www.cups.org/".
15 * This file is subject to the Apple OS-Developed Software exception.
19 * backendGetDeviceID() - Get the IEEE-1284 device ID string and
21 * backendGetMakeModel() - Get the make and model string from the device ID.
25 * Include necessary headers.
28 #include "backend-private.h"
31 # include <sys/ioctl.h>
32 # include <linux/lp.h>
33 # define IOCNR_GET_DEVICE_ID 1
34 # define LPIOC_GET_DEVICE_ID(len) _IOC(_IOC_READ, 'P', IOCNR_GET_DEVICE_ID, len)
35 # include <linux/parport.h>
36 # include <linux/ppdev.h>
43 # include <sys/ecppio.h>
45 # include <sys/ioccom.h>
46 # include <sys/ecppsys.h>
52 * 'backendGetDeviceID()' - Get the IEEE-1284 device ID string and
56 int /* O - 0 on success, -1 on failure */
58 int fd
, /* I - File descriptor */
59 char *device_id
, /* O - 1284 device ID */
60 int device_id_size
, /* I - Size of buffer */
61 char *make_model
, /* O - Make/model */
62 int make_model_size
, /* I - Size of buffer */
63 const char *scheme
, /* I - URI scheme */
64 char *uri
, /* O - Device URI */
65 int uri_size
) /* I - Size of buffer */
67 #ifdef __APPLE__ /* This function is a no-op */
70 #else /* Get the device ID from the specified file descriptor... */
72 int length
; /* Length of device ID info */
75 # if defined(__sun) && defined(ECPPIOC_GETDEVID)
76 struct ecpp_device_id did
; /* Device ID buffer */
77 # endif /* __sun && ECPPIOC_GETDEVID */
80 DEBUG_printf(("backendGetDeviceID(fd=%d, device_id=%p, device_id_size=%d, "
81 "make_model=%p, make_model_size=%d, scheme=\"%s\", "
82 "uri=%p, uri_size=%d)\n", fd
, device_id
, device_id_size
,
83 make_model
, make_model_size
, scheme
? scheme
: "(null)",
87 * Range check input...
90 if (!device_id
|| device_id_size
< 32)
92 DEBUG_puts("backendGetDeviceID: Bad args!");
102 * Get the device ID string...
108 if (ioctl(fd
, LPIOC_GET_DEVICE_ID(device_id_size
), device_id
))
111 * Linux has to implement things differently for every device it seems.
112 * Since the standard parallel port driver does not provide a simple
113 * ioctl() to get the 1284 device ID, we have to open the "raw" parallel
114 * device corresponding to this port and do some negotiation trickery
115 * to get the current device ID.
118 if (uri
&& !strncmp(uri
, "parallel:/dev/", 14))
120 char devparport
[16]; /* /dev/parportN */
121 int devparportfd
, /* File descriptor for raw device */
122 mode
; /* Port mode */
126 * Since the Linux parallel backend only supports 4 parallel port
127 * devices, just grab the trailing digit and use it to construct a
128 * /dev/parportN filename...
131 snprintf(devparport
, sizeof(devparport
), "/dev/parport%s",
132 uri
+ strlen(uri
) - 1);
134 if ((devparportfd
= open(devparport
, O_RDWR
| O_NOCTTY
)) != -1)
137 * Claim the device...
140 if (!ioctl(devparportfd
, PPCLAIM
))
142 fcntl(devparportfd
, F_SETFL
, fcntl(devparportfd
, F_GETFL
) | O_NONBLOCK
);
144 mode
= IEEE1284_MODE_COMPAT
;
146 if (!ioctl(devparportfd
, PPNEGOT
, &mode
))
149 * Put the device into Device ID mode...
152 mode
= IEEE1284_MODE_NIBBLE
| IEEE1284_DEVICEID
;
154 if (!ioctl(devparportfd
, PPNEGOT
, &mode
))
157 * Read the 1284 device ID...
160 if ((length
= read(devparportfd
, device_id
,
161 device_id_size
- 1)) >= 2)
163 device_id
[length
] = '\0';
170 * Release the device...
173 ioctl(devparportfd
, PPRELEASE
);
186 * Extract the length of the device ID string from the first two
187 * bytes. The 1284 spec says the length is stored MSB first...
190 length
= (((unsigned)device_id
[0] & 255) << 8) +
191 ((unsigned)device_id
[1] & 255);
194 * Check to see if the length is larger than our buffer; first
195 * assume that the vendor incorrectly implemented the 1284 spec,
196 * and then limit the length to the size of our buffer...
199 if (length
> device_id_size
)
200 length
= (((unsigned)device_id
[1] & 255) << 8) +
201 ((unsigned)device_id
[0] & 255);
203 if (length
> device_id_size
)
204 length
= device_id_size
;
207 * The length field counts the number of bytes in the string
208 * including the length field itself (2 bytes).
214 * Copy the device ID text to the beginning of the buffer and
218 memmove(device_id
, device_id
+ 2, length
);
219 device_id
[length
] = '\0';
223 DEBUG_printf(("backendGetDeviceID: ioctl failed - %s\n",
226 # endif /* __linux */
228 # if defined(__sun) && defined(ECPPIOC_GETDEVID)
229 did
.mode
= ECPP_CENTRONICS
;
230 did
.len
= device_id_size
- 1;
232 did
.addr
= device_id
;
234 if (!ioctl(fd
, ECPPIOC_GETDEVID
, &did
))
237 * Nul-terminate the device ID text.
240 if (did
.rlen
< (device_id_size
- 1))
241 device_id
[did
.rlen
] = '\0';
243 device_id
[device_id_size
- 1] = '\0';
247 DEBUG_printf(("backendGetDeviceID: ioctl failed - %s\n",
250 # endif /* __sun && ECPPIOC_GETDEVID */
253 DEBUG_printf(("backendGetDeviceID: device_id=\"%s\"\n", device_id
));
262 * Get the make and model...
266 backendGetMakeModel(device_id
, make_model
, make_model_size
);
269 * Then generate a device URI...
272 if (scheme
&& uri
&& uri_size
> 32)
274 int num_values
; /* Number of keys and values */
275 cups_option_t
*values
; /* Keys and values in device ID */
276 const char *mfg
, /* Manufacturer */
278 *sern
; /* Serial number */
279 char temp
[256], /* Temporary manufacturer string */
280 *tempptr
; /* Pointer into temp string */
284 * Get the make, model, and serial numbers...
287 num_values
= _ppdGet1284Values(device_id
, &values
);
289 if ((sern
= cupsGetOption("SERIALNUMBER", num_values
, values
)) == NULL
)
290 if ((sern
= cupsGetOption("SERN", num_values
, values
)) == NULL
)
291 sern
= cupsGetOption("SN", num_values
, values
);
293 if ((mfg
= cupsGetOption("MANUFACTURER", num_values
, values
)) == NULL
)
294 mfg
= cupsGetOption("MFG", num_values
, values
);
296 if ((mdl
= cupsGetOption("MODEL", num_values
, values
)) == NULL
)
297 mdl
= cupsGetOption("MDL", num_values
, values
);
301 if (!strcasecmp(mfg
, "Hewlett-Packard"))
303 else if (!strcasecmp(mfg
, "Lexmark International"))
308 strlcpy(temp
, make_model
, sizeof(temp
));
310 if ((tempptr
= strchr(temp
, ' ')) != NULL
)
316 if (!strncasecmp(mdl
, mfg
, strlen(mfg
)))
320 while (isspace(*mdl
& 255))
325 * Generate the device URI from the manufacturer, make_model, and
326 * serial number strings.
329 httpAssembleURIf(HTTP_URI_CODING_ALL
, uri
, uri_size
, scheme
, NULL
, mfg
, 0,
330 "/%s%s%s", mdl
, sern
? "?serial=" : "", sern
? sern
: "");
332 cupsFreeOptions(num_values
, values
);
336 #endif /* __APPLE__ */
341 * 'backendGetMakeModel()' - Get the make and model string from the device ID.
344 int /* O - 0 on success, -1 on failure */
346 const char *device_id
, /* O - 1284 device ID */
347 char *make_model
, /* O - Make/model */
348 int make_model_size
) /* I - Size of buffer */
350 int num_values
; /* Number of keys and values */
351 cups_option_t
*values
; /* Keys and values */
352 const char *mfg
, /* Manufacturer string */
353 *mdl
, /* Model string */
354 *des
; /* Description string */
357 DEBUG_printf(("backendGetMakeModel(device_id=\"%s\", "
358 "make_model=%p, make_model_size=%d)\n", device_id
,
359 make_model
, make_model_size
));
362 * Range check input...
365 if (!device_id
|| !*device_id
|| !make_model
|| make_model_size
< 32)
367 DEBUG_puts("backendGetMakeModel: Bad args!");
374 * Look for the description field...
377 num_values
= _ppdGet1284Values(device_id
, &values
);
379 if ((mdl
= cupsGetOption("MODEL", num_values
, values
)) == NULL
)
380 mdl
= cupsGetOption("MDL", num_values
, values
);
385 * Build a make-model string from the manufacturer and model attributes...
388 if ((mfg
= cupsGetOption("MANUFACTURER", num_values
, values
)) == NULL
)
389 mfg
= cupsGetOption("MFG", num_values
, values
);
391 if (!mfg
|| !strncasecmp(mdl
, mfg
, strlen(mfg
)))
394 * Just copy the model string, since it has the manufacturer...
397 _ppdNormalizeMakeAndModel(mdl
, make_model
, make_model_size
);
402 * Concatenate the make and model...
405 char temp
[1024]; /* Temporary make and model */
407 snprintf(temp
, sizeof(temp
), "%s %s", mfg
, mdl
);
408 _ppdNormalizeMakeAndModel(temp
, make_model
, make_model_size
);
411 else if ((des
= cupsGetOption("DESCRIPTION", num_values
, values
)) != NULL
||
412 (des
= cupsGetOption("DES", num_values
, values
)) != NULL
)
415 * Make sure the description contains something useful, since some
416 * printer manufacturers (HP) apparently don't follow the standards
417 * they helped to define...
419 * Here we require the description to be 8 or more characters in length,
420 * containing at least one space and one letter.
423 if (strlen(des
) >= 8)
425 const char *ptr
; /* Pointer into description */
426 int letters
, /* Number of letters seen */
427 spaces
; /* Number of spaces seen */
430 for (ptr
= des
, letters
= 0, spaces
= 0; *ptr
; ptr
++)
432 if (isspace(*ptr
& 255))
434 else if (isalpha(*ptr
& 255))
437 if (spaces
&& letters
)
441 if (spaces
&& letters
)
442 _ppdNormalizeMakeAndModel(des
, make_model
, make_model_size
);
449 * Use "Unknown" as the printer make and model...
452 strlcpy(make_model
, "Unknown", make_model_size
);
455 cupsFreeOptions(num_values
, values
);
462 * End of "$Id: ieee1284.c 7687 2008-06-24 01:28:36Z mike $".