2012-03-09 05:18:43 +08:00
|
|
|
/*
|
2012-03-09 05:50:54 +08:00
|
|
|
Some of this code is credited to Linux USB open source files that are
|
|
|
|
distributed with Linux.
|
2012-03-09 05:18:43 +08:00
|
|
|
|
|
|
|
Copyright: 2007 Metrologic Instruments. All rights reserved.
|
|
|
|
Copyright: 2011 Azimut Ltd. <http://azimutrzn.ru/>
|
|
|
|
*/
|
|
|
|
|
|
|
|
#include <linux/kernel.h>
|
|
|
|
#include <linux/init.h>
|
|
|
|
#include <linux/tty.h>
|
|
|
|
#include <linux/module.h>
|
|
|
|
#include <linux/usb.h>
|
|
|
|
#include <linux/errno.h>
|
|
|
|
#include <linux/slab.h>
|
|
|
|
#include <linux/tty_driver.h>
|
|
|
|
#include <linux/tty_flip.h>
|
|
|
|
#include <linux/moduleparam.h>
|
|
|
|
#include <linux/spinlock.h>
|
|
|
|
#include <linux/errno.h>
|
2012-03-09 05:50:54 +08:00
|
|
|
#include <linux/uaccess.h>
|
2012-03-09 05:18:43 +08:00
|
|
|
#include <linux/usb/serial.h>
|
|
|
|
|
|
|
|
/* Version Information */
|
|
|
|
#define DRIVER_VERSION "v1.2.0.0"
|
|
|
|
#define DRIVER_DESC "Metrologic Instruments Inc. - USB-POS driver"
|
|
|
|
|
2012-03-09 05:42:41 +08:00
|
|
|
/* Product information. */
|
|
|
|
#define FOCUS_VENDOR_ID 0x0C2E
|
2012-03-20 04:46:31 +08:00
|
|
|
#define FOCUS_PRODUCT_ID_BI 0x0720
|
|
|
|
#define FOCUS_PRODUCT_ID_UNI 0x0700
|
2012-03-09 05:42:41 +08:00
|
|
|
|
|
|
|
#define METROUSB_SET_REQUEST_TYPE 0x40
|
|
|
|
#define METROUSB_SET_MODEM_CTRL_REQUEST 10
|
|
|
|
#define METROUSB_SET_BREAK_REQUEST 0x40
|
|
|
|
#define METROUSB_MCR_NONE 0x08 /* Deactivate DTR and RTS. */
|
|
|
|
#define METROUSB_MCR_RTS 0x0a /* Activate RTS. */
|
|
|
|
#define METROUSB_MCR_DTR 0x09 /* Activate DTR. */
|
2012-03-09 05:50:54 +08:00
|
|
|
#define WDR_TIMEOUT 5000 /* default urb timeout. */
|
2012-03-09 05:42:41 +08:00
|
|
|
|
|
|
|
/* Private data structure. */
|
|
|
|
struct metrousb_private {
|
|
|
|
spinlock_t lock;
|
|
|
|
int throttled;
|
|
|
|
unsigned long control_state;
|
|
|
|
};
|
|
|
|
|
2012-03-09 05:18:43 +08:00
|
|
|
/* Device table list. */
|
2012-03-09 05:50:54 +08:00
|
|
|
static struct usb_device_id id_table[] = {
|
2012-03-20 04:46:31 +08:00
|
|
|
{ USB_DEVICE(FOCUS_VENDOR_ID, FOCUS_PRODUCT_ID_BI) },
|
2012-03-09 05:18:43 +08:00
|
|
|
{ USB_DEVICE(FOCUS_VENDOR_ID, FOCUS_PRODUCT_ID_UNI) },
|
|
|
|
{ }, /* Terminating entry. */
|
|
|
|
};
|
|
|
|
MODULE_DEVICE_TABLE(usb, id_table);
|
|
|
|
|
|
|
|
/* Input parameter constants. */
|
2012-03-09 05:37:32 +08:00
|
|
|
static bool debug;
|
2012-03-09 05:18:43 +08:00
|
|
|
|
2012-03-09 05:55:41 +08:00
|
|
|
static void metrousb_read_int_callback(struct urb *urb)
|
2012-03-09 05:18:43 +08:00
|
|
|
{
|
2012-03-09 06:00:11 +08:00
|
|
|
struct usb_serial_port *port = urb->context;
|
2012-03-09 05:55:41 +08:00
|
|
|
struct metrousb_private *metro_priv = usb_get_serial_port_data(port);
|
|
|
|
struct tty_struct *tty;
|
|
|
|
unsigned char *data = urb->transfer_buffer;
|
|
|
|
int throttled = 0;
|
|
|
|
int result = 0;
|
|
|
|
unsigned long flags = 0;
|
|
|
|
|
2012-03-09 06:16:12 +08:00
|
|
|
dev_dbg(&port->dev, "%s\n", __func__);
|
2012-03-09 05:18:43 +08:00
|
|
|
|
2012-03-09 05:55:41 +08:00
|
|
|
switch (urb->status) {
|
|
|
|
case 0:
|
|
|
|
/* Success status, read from the port. */
|
|
|
|
break;
|
|
|
|
case -ECONNRESET:
|
|
|
|
case -ENOENT:
|
|
|
|
case -ESHUTDOWN:
|
|
|
|
/* urb has been terminated. */
|
2012-03-09 06:16:12 +08:00
|
|
|
dev_dbg(&port->dev,
|
|
|
|
"%s - urb shutting down, error code=%d\n",
|
|
|
|
__func__, result);
|
2012-03-09 05:55:41 +08:00
|
|
|
return;
|
|
|
|
default:
|
2012-03-09 06:16:12 +08:00
|
|
|
dev_dbg(&port->dev,
|
|
|
|
"%s - non-zero urb received, error code=%d\n",
|
|
|
|
__func__, result);
|
2012-03-09 05:55:41 +08:00
|
|
|
goto exit;
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
/* Set the data read from the usb port into the serial port buffer. */
|
|
|
|
tty = tty_port_tty_get(&port->port);
|
|
|
|
if (!tty) {
|
2012-03-09 06:16:12 +08:00
|
|
|
dev_dbg(&port->dev, "%s - bad tty pointer - exiting\n",
|
|
|
|
__func__);
|
2012-03-09 05:55:41 +08:00
|
|
|
return;
|
|
|
|
}
|
|
|
|
|
|
|
|
if (tty && urb->actual_length) {
|
|
|
|
/* Loop through the data copying each byte to the tty layer. */
|
|
|
|
tty_insert_flip_string(tty, data, urb->actual_length);
|
|
|
|
|
|
|
|
/* Force the data to the tty layer. */
|
|
|
|
tty_flip_buffer_push(tty);
|
|
|
|
}
|
|
|
|
tty_kref_put(tty);
|
|
|
|
|
|
|
|
/* Set any port variables. */
|
|
|
|
spin_lock_irqsave(&metro_priv->lock, flags);
|
|
|
|
throttled = metro_priv->throttled;
|
|
|
|
spin_unlock_irqrestore(&metro_priv->lock, flags);
|
|
|
|
|
|
|
|
/* Continue trying to read if set. */
|
|
|
|
if (!throttled) {
|
|
|
|
usb_fill_int_urb(port->interrupt_in_urb, port->serial->dev,
|
|
|
|
usb_rcvintpipe(port->serial->dev, port->interrupt_in_endpointAddress),
|
|
|
|
port->interrupt_in_urb->transfer_buffer,
|
|
|
|
port->interrupt_in_urb->transfer_buffer_length,
|
|
|
|
metrousb_read_int_callback, port, 1);
|
|
|
|
|
|
|
|
result = usb_submit_urb(port->interrupt_in_urb, GFP_ATOMIC);
|
|
|
|
|
2012-03-09 06:16:12 +08:00
|
|
|
if (result)
|
|
|
|
dev_dbg(&port->dev,
|
|
|
|
"%s - failed submitting interrupt in urb, error code=%d\n",
|
|
|
|
__func__, result);
|
2012-03-09 05:18:43 +08:00
|
|
|
}
|
2012-03-09 05:55:41 +08:00
|
|
|
return;
|
|
|
|
|
|
|
|
exit:
|
|
|
|
/* Try to resubmit the urb. */
|
|
|
|
result = usb_submit_urb(urb, GFP_ATOMIC);
|
2012-03-09 06:16:12 +08:00
|
|
|
if (result)
|
|
|
|
dev_dbg(&port->dev,
|
|
|
|
"%s - failed submitting interrupt in urb, error code=%d\n",
|
|
|
|
__func__, result);
|
2012-03-09 05:18:43 +08:00
|
|
|
}
|
|
|
|
|
2012-03-09 05:55:41 +08:00
|
|
|
static void metrousb_cleanup(struct usb_serial_port *port)
|
2012-03-09 05:18:43 +08:00
|
|
|
{
|
2012-03-09 06:16:12 +08:00
|
|
|
dev_dbg(&port->dev, "%s\n", __func__);
|
2012-03-09 05:55:41 +08:00
|
|
|
|
|
|
|
if (port->serial->dev) {
|
|
|
|
/* Shutdown any interrupt in urbs. */
|
|
|
|
if (port->interrupt_in_urb) {
|
|
|
|
usb_unlink_urb(port->interrupt_in_urb);
|
|
|
|
usb_kill_urb(port->interrupt_in_urb);
|
|
|
|
}
|
|
|
|
}
|
2012-03-09 05:18:43 +08:00
|
|
|
}
|
|
|
|
|
2012-03-09 05:50:54 +08:00
|
|
|
static int metrousb_open(struct tty_struct *tty, struct usb_serial_port *port)
|
2012-03-09 05:18:43 +08:00
|
|
|
{
|
|
|
|
struct usb_serial *serial = port->serial;
|
|
|
|
struct metrousb_private *metro_priv = usb_get_serial_port_data(port);
|
|
|
|
unsigned long flags = 0;
|
|
|
|
int result = 0;
|
|
|
|
|
2012-03-09 06:16:12 +08:00
|
|
|
dev_dbg(&port->dev, "%s\n", __func__);
|
2012-03-09 05:18:43 +08:00
|
|
|
|
|
|
|
/* Make sure the urb is initialized. */
|
|
|
|
if (!port->interrupt_in_urb) {
|
2012-03-09 06:16:12 +08:00
|
|
|
dev_dbg(&port->dev, "%s - interrupt urb not initialized\n",
|
|
|
|
__func__);
|
2012-03-09 05:18:43 +08:00
|
|
|
return -ENODEV;
|
|
|
|
}
|
|
|
|
|
|
|
|
/* Set the private data information for the port. */
|
|
|
|
spin_lock_irqsave(&metro_priv->lock, flags);
|
|
|
|
metro_priv->control_state = 0;
|
|
|
|
metro_priv->throttled = 0;
|
|
|
|
spin_unlock_irqrestore(&metro_priv->lock, flags);
|
|
|
|
|
|
|
|
/*
|
|
|
|
* Force low_latency on so that our tty_push actually forces the data
|
|
|
|
* through, otherwise it is scheduled, and with high data rates (like
|
|
|
|
* with OHCI) data can get lost.
|
|
|
|
*/
|
2012-03-09 05:50:54 +08:00
|
|
|
if (tty)
|
2012-03-09 05:18:43 +08:00
|
|
|
tty->low_latency = 1;
|
|
|
|
|
|
|
|
/* Clear the urb pipe. */
|
|
|
|
usb_clear_halt(serial->dev, port->interrupt_in_urb->pipe);
|
|
|
|
|
|
|
|
/* Start reading from the device */
|
2012-03-09 05:50:54 +08:00
|
|
|
usb_fill_int_urb(port->interrupt_in_urb, serial->dev,
|
|
|
|
usb_rcvintpipe(serial->dev, port->interrupt_in_endpointAddress),
|
2012-03-09 05:18:43 +08:00
|
|
|
port->interrupt_in_urb->transfer_buffer,
|
|
|
|
port->interrupt_in_urb->transfer_buffer_length,
|
|
|
|
metrousb_read_int_callback, port, 1);
|
|
|
|
result = usb_submit_urb(port->interrupt_in_urb, GFP_KERNEL);
|
|
|
|
|
|
|
|
if (result) {
|
2012-03-09 06:16:12 +08:00
|
|
|
dev_dbg(&port->dev,
|
|
|
|
"%s - failed submitting interrupt in urb, error code=%d\n",
|
|
|
|
__func__, result);
|
2012-03-09 05:18:43 +08:00
|
|
|
goto exit;
|
|
|
|
}
|
|
|
|
|
2012-03-09 06:16:12 +08:00
|
|
|
dev_dbg(&port->dev, "%s - port open\n", __func__);
|
2012-03-09 05:18:43 +08:00
|
|
|
exit:
|
|
|
|
return result;
|
|
|
|
}
|
|
|
|
|
|
|
|
static int metrousb_set_modem_ctrl(struct usb_serial *serial, unsigned int control_state)
|
|
|
|
{
|
|
|
|
int retval = 0;
|
|
|
|
unsigned char mcr = METROUSB_MCR_NONE;
|
|
|
|
|
2012-03-09 06:16:12 +08:00
|
|
|
dev_dbg(&serial->dev->dev, "%s - control state = %d\n",
|
|
|
|
__func__, control_state);
|
2012-03-09 05:18:43 +08:00
|
|
|
|
|
|
|
/* Set the modem control value. */
|
|
|
|
if (control_state & TIOCM_DTR)
|
|
|
|
mcr |= METROUSB_MCR_DTR;
|
|
|
|
if (control_state & TIOCM_RTS)
|
|
|
|
mcr |= METROUSB_MCR_RTS;
|
|
|
|
|
|
|
|
/* Send the command to the usb port. */
|
|
|
|
retval = usb_control_msg(serial->dev, usb_sndctrlpipe(serial->dev, 0),
|
|
|
|
METROUSB_SET_REQUEST_TYPE, METROUSB_SET_MODEM_CTRL_REQUEST,
|
|
|
|
control_state, 0, NULL, 0, WDR_TIMEOUT);
|
|
|
|
if (retval < 0)
|
2012-03-09 06:16:12 +08:00
|
|
|
dev_dbg(&serial->dev->dev,
|
|
|
|
"%s - set modem ctrl=0x%x failed, error code=%d\n",
|
|
|
|
__func__, mcr, retval);
|
2012-03-09 05:18:43 +08:00
|
|
|
|
|
|
|
return retval;
|
|
|
|
}
|
|
|
|
|
2012-03-09 05:50:54 +08:00
|
|
|
static void metrousb_shutdown(struct usb_serial *serial)
|
2012-03-09 05:18:43 +08:00
|
|
|
{
|
|
|
|
int i = 0;
|
|
|
|
|
2012-03-09 06:16:12 +08:00
|
|
|
dev_dbg(&serial->dev->dev, "%s\n", __func__);
|
2012-03-09 05:18:43 +08:00
|
|
|
|
|
|
|
/* Stop reading and writing on all ports. */
|
2012-03-09 05:50:54 +08:00
|
|
|
for (i = 0; i < serial->num_ports; ++i) {
|
2012-03-09 05:18:43 +08:00
|
|
|
/* Close any open urbs. */
|
|
|
|
metrousb_cleanup(serial->port[i]);
|
|
|
|
|
|
|
|
/* Free memory. */
|
|
|
|
kfree(usb_get_serial_port_data(serial->port[i]));
|
|
|
|
usb_set_serial_port_data(serial->port[i], NULL);
|
|
|
|
|
2012-03-09 06:16:12 +08:00
|
|
|
dev_dbg(&serial->dev->dev, "%s - freed port number=%d\n",
|
|
|
|
__func__, serial->port[i]->number);
|
2012-03-09 05:18:43 +08:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
static int metrousb_startup(struct usb_serial *serial)
|
|
|
|
{
|
|
|
|
struct metrousb_private *metro_priv;
|
|
|
|
struct usb_serial_port *port;
|
|
|
|
int i = 0;
|
|
|
|
|
2012-03-09 06:16:12 +08:00
|
|
|
dev_dbg(&serial->dev->dev, "%s\n", __func__);
|
2012-03-09 05:18:43 +08:00
|
|
|
|
|
|
|
/* Loop through the serial ports setting up the private structures.
|
|
|
|
* Currently we only use one port. */
|
|
|
|
for (i = 0; i < serial->num_ports; ++i) {
|
|
|
|
port = serial->port[i];
|
|
|
|
|
|
|
|
/* Declare memory. */
|
2012-03-09 06:00:11 +08:00
|
|
|
metro_priv = kzalloc(sizeof(struct metrousb_private), GFP_KERNEL);
|
2012-03-09 05:18:43 +08:00
|
|
|
if (!metro_priv)
|
|
|
|
return -ENOMEM;
|
|
|
|
|
|
|
|
/* Initialize memory. */
|
|
|
|
spin_lock_init(&metro_priv->lock);
|
|
|
|
usb_set_serial_port_data(port, metro_priv);
|
|
|
|
|
2012-03-09 06:16:12 +08:00
|
|
|
dev_dbg(&serial->dev->dev, "%s - port number=%d\n ",
|
|
|
|
__func__, port->number);
|
2012-03-09 05:18:43 +08:00
|
|
|
}
|
|
|
|
|
|
|
|
return 0;
|
|
|
|
}
|
|
|
|
|
2012-03-09 05:50:54 +08:00
|
|
|
static void metrousb_throttle(struct tty_struct *tty)
|
2012-03-09 05:18:43 +08:00
|
|
|
{
|
|
|
|
struct usb_serial_port *port = tty->driver_data;
|
|
|
|
struct metrousb_private *metro_priv = usb_get_serial_port_data(port);
|
|
|
|
unsigned long flags = 0;
|
|
|
|
|
2012-03-09 06:16:12 +08:00
|
|
|
dev_dbg(tty->dev, "%s\n", __func__);
|
2012-03-09 05:18:43 +08:00
|
|
|
|
|
|
|
/* Set the private information for the port to stop reading data. */
|
|
|
|
spin_lock_irqsave(&metro_priv->lock, flags);
|
|
|
|
metro_priv->throttled = 1;
|
|
|
|
spin_unlock_irqrestore(&metro_priv->lock, flags);
|
|
|
|
}
|
|
|
|
|
2012-03-09 05:50:54 +08:00
|
|
|
static int metrousb_tiocmget(struct tty_struct *tty)
|
2012-03-09 05:18:43 +08:00
|
|
|
{
|
|
|
|
unsigned long control_state = 0;
|
|
|
|
struct usb_serial_port *port = tty->driver_data;
|
|
|
|
struct metrousb_private *metro_priv = usb_get_serial_port_data(port);
|
|
|
|
unsigned long flags = 0;
|
|
|
|
|
2012-03-09 06:16:12 +08:00
|
|
|
dev_dbg(tty->dev, "%s\n", __func__);
|
2012-03-09 05:18:43 +08:00
|
|
|
|
|
|
|
spin_lock_irqsave(&metro_priv->lock, flags);
|
|
|
|
control_state = metro_priv->control_state;
|
|
|
|
spin_unlock_irqrestore(&metro_priv->lock, flags);
|
|
|
|
|
|
|
|
return control_state;
|
|
|
|
}
|
|
|
|
|
2012-03-09 05:50:54 +08:00
|
|
|
static int metrousb_tiocmset(struct tty_struct *tty,
|
|
|
|
unsigned int set, unsigned int clear)
|
2012-03-09 05:18:43 +08:00
|
|
|
{
|
|
|
|
struct usb_serial_port *port = tty->driver_data;
|
|
|
|
struct usb_serial *serial = port->serial;
|
|
|
|
struct metrousb_private *metro_priv = usb_get_serial_port_data(port);
|
|
|
|
unsigned long flags = 0;
|
|
|
|
unsigned long control_state = 0;
|
|
|
|
|
2012-03-09 06:16:12 +08:00
|
|
|
dev_dbg(tty->dev, "%s - set=%d, clear=%d\n", __func__, set, clear);
|
2012-03-09 05:18:43 +08:00
|
|
|
|
|
|
|
spin_lock_irqsave(&metro_priv->lock, flags);
|
|
|
|
control_state = metro_priv->control_state;
|
|
|
|
|
2012-03-09 05:50:54 +08:00
|
|
|
/* Set the RTS and DTR values. */
|
2012-03-09 05:18:43 +08:00
|
|
|
if (set & TIOCM_RTS)
|
|
|
|
control_state |= TIOCM_RTS;
|
|
|
|
if (set & TIOCM_DTR)
|
|
|
|
control_state |= TIOCM_DTR;
|
|
|
|
if (clear & TIOCM_RTS)
|
|
|
|
control_state &= ~TIOCM_RTS;
|
|
|
|
if (clear & TIOCM_DTR)
|
|
|
|
control_state &= ~TIOCM_DTR;
|
|
|
|
|
|
|
|
metro_priv->control_state = control_state;
|
|
|
|
spin_unlock_irqrestore(&metro_priv->lock, flags);
|
|
|
|
return metrousb_set_modem_ctrl(serial, control_state);
|
|
|
|
}
|
|
|
|
|
2012-03-09 05:50:54 +08:00
|
|
|
static void metrousb_unthrottle(struct tty_struct *tty)
|
2012-03-09 05:18:43 +08:00
|
|
|
{
|
|
|
|
struct usb_serial_port *port = tty->driver_data;
|
|
|
|
struct metrousb_private *metro_priv = usb_get_serial_port_data(port);
|
|
|
|
unsigned long flags = 0;
|
|
|
|
int result = 0;
|
|
|
|
|
2012-03-09 06:16:12 +08:00
|
|
|
dev_dbg(tty->dev, "%s\n", __func__);
|
2012-03-09 05:18:43 +08:00
|
|
|
|
|
|
|
/* Set the private information for the port to resume reading data. */
|
|
|
|
spin_lock_irqsave(&metro_priv->lock, flags);
|
|
|
|
metro_priv->throttled = 0;
|
|
|
|
spin_unlock_irqrestore(&metro_priv->lock, flags);
|
|
|
|
|
|
|
|
/* Submit the urb to read from the port. */
|
|
|
|
port->interrupt_in_urb->dev = port->serial->dev;
|
|
|
|
result = usb_submit_urb(port->interrupt_in_urb, GFP_ATOMIC);
|
2012-03-09 06:16:12 +08:00
|
|
|
if (result)
|
|
|
|
dev_dbg(tty->dev,
|
|
|
|
"failed submitting interrupt in urb error code=%d\n",
|
|
|
|
result);
|
2012-03-09 05:18:43 +08:00
|
|
|
}
|
|
|
|
|
2012-03-09 05:55:41 +08:00
|
|
|
static struct usb_driver metrousb_driver = {
|
|
|
|
.name = "metro-usb",
|
|
|
|
.probe = usb_serial_probe,
|
|
|
|
.disconnect = usb_serial_disconnect,
|
|
|
|
.id_table = id_table
|
|
|
|
};
|
|
|
|
|
|
|
|
static struct usb_serial_driver metrousb_device = {
|
|
|
|
.driver = {
|
|
|
|
.owner = THIS_MODULE,
|
|
|
|
.name = "metro-usb",
|
|
|
|
},
|
|
|
|
.description = "Metrologic USB to serial converter.",
|
|
|
|
.id_table = id_table,
|
|
|
|
.num_ports = 1,
|
|
|
|
.open = metrousb_open,
|
|
|
|
.close = metrousb_cleanup,
|
|
|
|
.read_int_callback = metrousb_read_int_callback,
|
|
|
|
.attach = metrousb_startup,
|
|
|
|
.release = metrousb_shutdown,
|
|
|
|
.throttle = metrousb_throttle,
|
|
|
|
.unthrottle = metrousb_unthrottle,
|
|
|
|
.tiocmget = metrousb_tiocmget,
|
|
|
|
.tiocmset = metrousb_tiocmset,
|
|
|
|
};
|
|
|
|
|
|
|
|
static struct usb_serial_driver * const serial_drivers[] = {
|
|
|
|
&metrousb_device,
|
|
|
|
NULL,
|
|
|
|
};
|
|
|
|
|
2012-03-09 05:39:53 +08:00
|
|
|
module_usb_serial_driver(metrousb_driver, serial_drivers);
|
|
|
|
|
2012-03-09 05:18:43 +08:00
|
|
|
MODULE_LICENSE("GPL");
|
2012-03-09 05:50:54 +08:00
|
|
|
MODULE_AUTHOR("Philip Nicastro");
|
|
|
|
MODULE_AUTHOR("Aleksey Babahin <tamerlan311@gmail.com>");
|
|
|
|
MODULE_DESCRIPTION(DRIVER_DESC);
|
2012-03-09 05:18:43 +08:00
|
|
|
|
|
|
|
/* Module input parameters */
|
|
|
|
module_param(debug, bool, S_IRUGO | S_IWUSR);
|
|
|
|
MODULE_PARM_DESC(debug, "Print debug info (bool 1=on, 0=off)");
|