linux/drivers/usb/serial/belkin_sa.c

// SPDX-License-Identifier: GPL-2.0+
/*
 * Belkin USB Serial Adapter Driver
 *
 *  Copyright (C) 2000		William Greathouse ([email protected])
 *  Copyright (C) 2000-2001	Greg Kroah-Hartman ([email protected])
 *  Copyright (C) 2010		Johan Hovold ([email protected])
 *
 *  This program is largely derived from work by the linux-usb group
 *  and associated source files.  Please see the usb/serial files for
 *  individual credits and copyrights.
 *
 * See Documentation/usb/usb-serial.rst for more information on using this
 * driver
 *
 * TODO:
 * -- Add true modem control line query capability.  Currently we track the
 *    states reported by the interrupt and the states we request.
 * -- Add support for flush commands
 */

#include <linux/kernel.h>
#include <linux/errno.h>
#include <linux/slab.h>
#include <linux/tty.h>
#include <linux/tty_driver.h>
#include <linux/tty_flip.h>
#include <linux/module.h>
#include <linux/spinlock.h>
#include <linux/uaccess.h>
#include <linux/usb.h>
#include <linux/usb/serial.h>
#include "belkin_sa.h"

#define DRIVER_AUTHOR …
#define DRIVER_DESC …

/* function prototypes for a Belkin USB Serial Adapter F5U103 */
static int belkin_sa_port_probe(struct usb_serial_port *port);
static void belkin_sa_port_remove(struct usb_serial_port *port);
static int  belkin_sa_open(struct tty_struct *tty,
			struct usb_serial_port *port);
static void belkin_sa_close(struct usb_serial_port *port);
static void belkin_sa_read_int_callback(struct urb *urb);
static void belkin_sa_process_read_urb(struct urb *urb);
static void belkin_sa_set_termios(struct tty_struct *tty,
				  struct usb_serial_port *port,
				  const struct ktermios *old_termios);
static int belkin_sa_break_ctl(struct tty_struct *tty, int break_state);
static int  belkin_sa_tiocmget(struct tty_struct *tty);
static int  belkin_sa_tiocmset(struct tty_struct *tty,
					unsigned int set, unsigned int clear);


static const struct usb_device_id id_table[] = …;
MODULE_DEVICE_TABLE(usb, id_table);

/* All of the device info needed for the serial converters */
static struct usb_serial_driver belkin_device = …;

static struct usb_serial_driver * const serial_drivers[] = …;

struct belkin_sa_private { … };


/*
 * ***************************************************************************
 * Belkin USB Serial Adapter F5U103 specific driver functions
 * ***************************************************************************
 */

#define WDR_TIMEOUT …

/* assumes that struct usb_serial *serial is available */
#define BSA_USB_CMD(c, v) …

static int belkin_sa_port_probe(struct usb_serial_port *port)
{ … }

static void belkin_sa_port_remove(struct usb_serial_port *port)
{ … }

static int belkin_sa_open(struct tty_struct *tty,
					struct usb_serial_port *port)
{ … }

static void belkin_sa_close(struct usb_serial_port *port)
{ … }

static void belkin_sa_read_int_callback(struct urb *urb)
{ … }

static void belkin_sa_process_read_urb(struct urb *urb)
{ … }

static void belkin_sa_set_termios(struct tty_struct *tty,
				  struct usb_serial_port *port,
				  const struct ktermios *old_termios)
{ … }

static int belkin_sa_break_ctl(struct tty_struct *tty, int break_state)
{ … }

static int belkin_sa_tiocmget(struct tty_struct *tty)
{ … }

static int belkin_sa_tiocmset(struct tty_struct *tty,
			       unsigned int set, unsigned int clear)
{ … }

module_usb_serial_driver(…);

MODULE_AUTHOR(…);
MODULE_DESCRIPTION(…);
MODULE_LICENSE(…) …;