linux/drivers/media/usb/gspca/dtcs033.c

// SPDX-License-Identifier: GPL-2.0-or-later
/*
 * Subdriver for Scopium astro-camera (DTCS033, 0547:7303)
 *
 * Copyright (C) 2014 Robert Butora ([email protected])
 */

#define pr_fmt(fmt) …
#define MODULE_NAME …
#include "gspca.h"

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

struct dtcs033_usb_requests { … };

/* send a usb request */
static void reg_rw(struct gspca_dev *gspca_dev,
		u8 bRequestType, u8 bRequest,
		u16 wValue, u16 wIndex, u16 wLength)
{ … }
/* send several usb in/out requests */
static int reg_reqs(struct gspca_dev *gspca_dev,
		    const struct dtcs033_usb_requests *preqs, int n_reqs)
{ … }

/* -- subdriver interface implementation -- */

#define DT_COLS …
static const struct v4l2_pix_format dtcs033_mode[] = …;

/* config called at probe time */
static int sd_config(struct gspca_dev *gspca_dev,
		const struct usb_device_id *id)
{ … }

/* init called at probe and resume time */
static int sd_init(struct gspca_dev *gspca_dev)
{ … }

/* start stop the camera */
static int  dtcs033_start(struct gspca_dev *gspca_dev);
static void dtcs033_stopN(struct gspca_dev *gspca_dev);

/* intercept camera image data */
static void dtcs033_pkt_scan(struct gspca_dev *gspca_dev,
			u8 *data,  /* packet data */
			int len)   /* packet data length */
{ … }

/* -- controls: exposure and gain -- */

static void dtcs033_setexposure(struct gspca_dev *gspca_dev,
			s32 expo, s32 gain)
{ … }

/* specific webcam descriptor */
struct sd { … };

static int sd_s_ctrl(struct v4l2_ctrl *ctrl)
{ … }

static const struct v4l2_ctrl_ops sd_ctrl_ops = …;

static int dtcs033_init_controls(struct gspca_dev *gspca_dev)
{ … }

/* sub-driver description */
static const struct sd_desc sd_desc = …;

/* -- module initialisation -- */

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

/* device connect */
static int sd_probe(struct usb_interface *intf,
			const struct usb_device_id *id)
{ … }

static struct usb_driver sd_driver = …;
module_usb_driver(…) …;


/* ---------------------------------------------------------
 USB requests to start/stop the camera [USB 2.0 spec Ch.9].

 bRequestType :
 0x40 =  USB_DIR_OUT | USB_TYPE_VENDOR | USB_RECIP_DEVICE,
 0xC0 =  USB_DIR_IN  | USB_TYPE_VENDOR | USB_RECIP_DEVICE,
*/
static const struct dtcs033_usb_requests dtcs033_start_reqs[] = …;

static const struct dtcs033_usb_requests dtcs033_stop_reqs[] = …;
static int dtcs033_start(struct gspca_dev *gspca_dev)
{ … }

static void dtcs033_stopN(struct gspca_dev *gspca_dev)
{ … }