203 lines · c
1/* SPDX-License-Identifier: GPL-2.0-or-later */2/*3 * STK1160 driver4 *5 * Copyright (C) 2012 Ezequiel Garcia6 * <elezegarcia--a.t--gmail.com>7 *8 * Based on Easycap driver by R.M. Thomas9 * Copyright (C) 2010 R.M. Thomas10 * <rmthomas--a.t--sciolus.org>11 */12 13#include <linux/i2c.h>14#include <sound/core.h>15#include <sound/ac97_codec.h>16#include <media/videobuf2-v4l2.h>17#include <media/v4l2-device.h>18#include <media/v4l2-ctrls.h>19#include <linux/usb.h>20#include <linux/usb/hcd.h>21 22#define STK1160_VERSION "0.9.5"23#define STK1160_VERSION_NUM 0x00090524 25/* Decide on number of packets for each buffer */26#define STK1160_NUM_PACKETS 6427 28/* Number of buffers for isoc transfers */29#define STK1160_NUM_BUFS 1630#define STK1160_MIN_BUFS 131 32/* TODO: This endpoint address should be retrieved */33#define STK1160_EP_VIDEO 0x8234#define STK1160_EP_AUDIO 0x8135 36/* Max and min video buffers */37#define STK1160_MIN_VIDEO_BUFFERS 838#define STK1160_MAX_VIDEO_BUFFERS 3239 40#define STK1160_MIN_PKT_SIZE 307241 42#define STK1160_MAX_INPUT 443#define STK1160_SVIDEO_INPUT 444 45#define STK1160_AC97_TIMEOUT 5046 47#define STK1160_I2C_TIMEOUT 10048 49/* TODO: Print helpers50 * I could use dev_xxx, pr_xxx, v4l2_xxx or printk.51 * However, there isn't a solid consensus on which52 * new drivers should use.53 *54 */55#ifdef DEBUG56#define stk1160_dbg(fmt, args...) \57 printk(KERN_DEBUG "stk1160: " fmt, ## args)58#else59#define stk1160_dbg(fmt, args...)60#endif61 62#define stk1160_info(fmt, args...) \63 pr_info("stk1160: " fmt, ## args)64 65#define stk1160_warn(fmt, args...) \66 pr_warn("stk1160: " fmt, ## args)67 68#define stk1160_err(fmt, args...) \69 pr_err("stk1160: " fmt, ## args)70 71/* Buffer for one video frame */72struct stk1160_buffer {73 /* common v4l buffer stuff -- must be first */74 struct vb2_v4l2_buffer vb;75 struct list_head list;76 77 void *mem;78 unsigned int length; /* buffer length */79 unsigned int bytesused; /* bytes written */80 int odd; /* current oddity */81 82 /*83 * Since we interlace two fields per frame,84 * this is different from bytesused.85 */86 unsigned int pos; /* current pos inside buffer */87};88 89struct stk1160_urb {90 struct urb *urb;91 char *transfer_buffer;92 struct sg_table *sgt;93 struct stk1160 *dev;94 dma_addr_t dma;95};96 97struct stk1160_isoc_ctl {98 /* max packet size of isoc transaction */99 int max_pkt_size;100 101 /* number of allocated urbs */102 int num_bufs;103 104 struct stk1160_urb urb_ctl[STK1160_NUM_BUFS];105 106 /* current buffer */107 struct stk1160_buffer *buf;108};109 110struct stk1160_fmt {111 u32 fourcc; /* v4l2 format id */112 int depth;113};114 115struct stk1160 {116 struct v4l2_device v4l2_dev;117 struct video_device vdev;118 struct v4l2_ctrl_handler ctrl_handler;119 120 struct device *dev;121 struct usb_device *udev;122 123 /* saa7115 subdev */124 struct v4l2_subdev *sd_saa7115;125 126 /* isoc control struct */127 struct list_head avail_bufs;128 129 /* video capture */130 struct vb2_queue vb_vidq;131 132 /* max packet size of isoc transaction */133 int max_pkt_size;134 /* array of wMaxPacketSize */135 unsigned int *alt_max_pkt_size;136 /* alternate */137 int alt;138 /* Number of alternative settings */139 int num_alt;140 141 struct stk1160_isoc_ctl isoc_ctl;142 143 /* frame properties */144 int width; /* current frame width */145 int height; /* current frame height */146 unsigned int ctl_input; /* selected input */147 v4l2_std_id norm; /* current norm */148 struct stk1160_fmt *fmt; /* selected format */149 150 unsigned int sequence;151 152 /* i2c i/o */153 struct i2c_adapter i2c_adap;154 struct i2c_client i2c_client;155 156 struct mutex v4l_lock;157 struct mutex vb_queue_lock;158 spinlock_t buf_lock;159 160 struct file *fh_owner; /* filehandle ownership */161 162 /* EXPERIMENTAL */163 struct snd_card *snd_card;164};165 166struct regval {167 u16 reg;168 u16 val;169};170 171/* Provided by stk1160-v4l.c */172int stk1160_vb2_setup(struct stk1160 *dev);173int stk1160_video_register(struct stk1160 *dev);174void stk1160_video_unregister(struct stk1160 *dev);175void stk1160_clear_queue(struct stk1160 *dev, enum vb2_buffer_state vb2_state);176 177/* Provided by stk1160-video.c */178int stk1160_alloc_isoc(struct stk1160 *dev);179void stk1160_free_isoc(struct stk1160 *dev);180void stk1160_cancel_isoc(struct stk1160 *dev);181void stk1160_uninit_isoc(struct stk1160 *dev);182 183/* Provided by stk1160-i2c.c */184int stk1160_i2c_register(struct stk1160 *dev);185int stk1160_i2c_unregister(struct stk1160 *dev);186 187/* Provided by stk1160-core.c */188int stk1160_read_reg(struct stk1160 *dev, u16 reg, u8 *value);189int stk1160_write_reg(struct stk1160 *dev, u16 reg, u16 value);190int stk1160_write_regs_req(struct stk1160 *dev, u8 req, u16 reg,191 char *buf, int len);192int stk1160_read_reg_req_len(struct stk1160 *dev, u8 req, u16 reg,193 char *buf, int len);194void stk1160_select_input(struct stk1160 *dev);195 196/* Provided by stk1160-ac97.c */197void stk1160_ac97_setup(struct stk1160 *dev);198 199static inline struct device *stk1160_get_dmadev(struct stk1160 *dev)200{201 return bus_to_hcd(dev->udev->bus)->self.sysdev;202}203