1c942fddfSThomas Gleixner /* SPDX-License-Identifier: GPL-2.0-or-later */
20c0d06caSMauro Carvalho Chehab /*
30c0d06caSMauro Carvalho Chehab * STK1160 driver
40c0d06caSMauro Carvalho Chehab *
50c0d06caSMauro Carvalho Chehab * Copyright (C) 2012 Ezequiel Garcia
60c0d06caSMauro Carvalho Chehab * <elezegarcia--a.t--gmail.com>
70c0d06caSMauro Carvalho Chehab *
80c0d06caSMauro Carvalho Chehab * Based on Easycap driver by R.M. Thomas
90c0d06caSMauro Carvalho Chehab * Copyright (C) 2010 R.M. Thomas
100c0d06caSMauro Carvalho Chehab * <rmthomas--a.t--sciolus.org>
110c0d06caSMauro Carvalho Chehab */
120c0d06caSMauro Carvalho Chehab
130c0d06caSMauro Carvalho Chehab #include <linux/i2c.h>
140c0d06caSMauro Carvalho Chehab #include <sound/core.h>
150c0d06caSMauro Carvalho Chehab #include <sound/ac97_codec.h>
16c139990eSJunghak Sung #include <media/videobuf2-v4l2.h>
170c0d06caSMauro Carvalho Chehab #include <media/v4l2-device.h>
180c0d06caSMauro Carvalho Chehab #include <media/v4l2-ctrls.h>
19*68d0c331SDafna Hirschfeld #include <linux/usb.h>
20*68d0c331SDafna Hirschfeld #include <linux/usb/hcd.h>
210c0d06caSMauro Carvalho Chehab
220c0d06caSMauro Carvalho Chehab #define STK1160_VERSION "0.9.5"
230c0d06caSMauro Carvalho Chehab #define STK1160_VERSION_NUM 0x000905
240c0d06caSMauro Carvalho Chehab
252902fb7eSEzequiel Garcia /* Decide on number of packets for each buffer */
260c0d06caSMauro Carvalho Chehab #define STK1160_NUM_PACKETS 64
270c0d06caSMauro Carvalho Chehab
280c0d06caSMauro Carvalho Chehab /* Number of buffers for isoc transfers */
292902fb7eSEzequiel Garcia #define STK1160_NUM_BUFS 16
302902fb7eSEzequiel Garcia #define STK1160_MIN_BUFS 1
310c0d06caSMauro Carvalho Chehab
320c0d06caSMauro Carvalho Chehab /* TODO: This endpoint address should be retrieved */
330c0d06caSMauro Carvalho Chehab #define STK1160_EP_VIDEO 0x82
340c0d06caSMauro Carvalho Chehab #define STK1160_EP_AUDIO 0x81
350c0d06caSMauro Carvalho Chehab
360c0d06caSMauro Carvalho Chehab /* Max and min video buffers */
370c0d06caSMauro Carvalho Chehab #define STK1160_MIN_VIDEO_BUFFERS 8
380c0d06caSMauro Carvalho Chehab #define STK1160_MAX_VIDEO_BUFFERS 32
390c0d06caSMauro Carvalho Chehab
400c0d06caSMauro Carvalho Chehab #define STK1160_MIN_PKT_SIZE 3072
410c0d06caSMauro Carvalho Chehab
4256a960bfSEzequiel Garcia #define STK1160_MAX_INPUT 4
4356a960bfSEzequiel Garcia #define STK1160_SVIDEO_INPUT 4
440c0d06caSMauro Carvalho Chehab
459a4825edSMarcel Hasler #define STK1160_AC97_TIMEOUT 50
469a4825edSMarcel Hasler
470c0d06caSMauro Carvalho Chehab #define STK1160_I2C_TIMEOUT 100
480c0d06caSMauro Carvalho Chehab
490c0d06caSMauro Carvalho Chehab /* TODO: Print helpers
500c0d06caSMauro Carvalho Chehab * I could use dev_xxx, pr_xxx, v4l2_xxx or printk.
510c0d06caSMauro Carvalho Chehab * However, there isn't a solid consensus on which
520c0d06caSMauro Carvalho Chehab * new drivers should use.
530c0d06caSMauro Carvalho Chehab *
540c0d06caSMauro Carvalho Chehab */
550c0d06caSMauro Carvalho Chehab #ifdef DEBUG
560c0d06caSMauro Carvalho Chehab #define stk1160_dbg(fmt, args...) \
570c0d06caSMauro Carvalho Chehab printk(KERN_DEBUG "stk1160: " fmt, ## args)
580c0d06caSMauro Carvalho Chehab #else
590c0d06caSMauro Carvalho Chehab #define stk1160_dbg(fmt, args...)
600c0d06caSMauro Carvalho Chehab #endif
610c0d06caSMauro Carvalho Chehab
620c0d06caSMauro Carvalho Chehab #define stk1160_info(fmt, args...) \
630c0d06caSMauro Carvalho Chehab pr_info("stk1160: " fmt, ## args)
640c0d06caSMauro Carvalho Chehab
650c0d06caSMauro Carvalho Chehab #define stk1160_warn(fmt, args...) \
660c0d06caSMauro Carvalho Chehab pr_warn("stk1160: " fmt, ## args)
670c0d06caSMauro Carvalho Chehab
680c0d06caSMauro Carvalho Chehab #define stk1160_err(fmt, args...) \
690c0d06caSMauro Carvalho Chehab pr_err("stk1160: " fmt, ## args)
700c0d06caSMauro Carvalho Chehab
710c0d06caSMauro Carvalho Chehab /* Buffer for one video frame */
720c0d06caSMauro Carvalho Chehab struct stk1160_buffer {
730c0d06caSMauro Carvalho Chehab /* common v4l buffer stuff -- must be first */
742d700715SJunghak Sung struct vb2_v4l2_buffer vb;
750c0d06caSMauro Carvalho Chehab struct list_head list;
760c0d06caSMauro Carvalho Chehab
770c0d06caSMauro Carvalho Chehab void *mem;
780c0d06caSMauro Carvalho Chehab unsigned int length; /* buffer length */
790c0d06caSMauro Carvalho Chehab unsigned int bytesused; /* bytes written */
800c0d06caSMauro Carvalho Chehab int odd; /* current oddity */
810c0d06caSMauro Carvalho Chehab
820c0d06caSMauro Carvalho Chehab /*
830c0d06caSMauro Carvalho Chehab * Since we interlace two fields per frame,
840c0d06caSMauro Carvalho Chehab * this is different from bytesused.
850c0d06caSMauro Carvalho Chehab */
860c0d06caSMauro Carvalho Chehab unsigned int pos; /* current pos inside buffer */
870c0d06caSMauro Carvalho Chehab };
880c0d06caSMauro Carvalho Chehab
8969fd04d0SDafna Hirschfeld struct stk1160_urb {
9069fd04d0SDafna Hirschfeld struct urb *urb;
9169fd04d0SDafna Hirschfeld char *transfer_buffer;
92*68d0c331SDafna Hirschfeld struct sg_table *sgt;
93*68d0c331SDafna Hirschfeld struct stk1160 *dev;
94*68d0c331SDafna Hirschfeld dma_addr_t dma;
9569fd04d0SDafna Hirschfeld };
9669fd04d0SDafna Hirschfeld
970c0d06caSMauro Carvalho Chehab struct stk1160_isoc_ctl {
980c0d06caSMauro Carvalho Chehab /* max packet size of isoc transaction */
990c0d06caSMauro Carvalho Chehab int max_pkt_size;
1000c0d06caSMauro Carvalho Chehab
1010c0d06caSMauro Carvalho Chehab /* number of allocated urbs */
1020c0d06caSMauro Carvalho Chehab int num_bufs;
1030c0d06caSMauro Carvalho Chehab
10469fd04d0SDafna Hirschfeld struct stk1160_urb urb_ctl[STK1160_NUM_BUFS];
1050c0d06caSMauro Carvalho Chehab
1060c0d06caSMauro Carvalho Chehab /* current buffer */
1070c0d06caSMauro Carvalho Chehab struct stk1160_buffer *buf;
1080c0d06caSMauro Carvalho Chehab };
1090c0d06caSMauro Carvalho Chehab
1100c0d06caSMauro Carvalho Chehab struct stk1160_fmt {
1110c0d06caSMauro Carvalho Chehab u32 fourcc; /* v4l2 format id */
1120c0d06caSMauro Carvalho Chehab int depth;
1130c0d06caSMauro Carvalho Chehab };
1140c0d06caSMauro Carvalho Chehab
1150c0d06caSMauro Carvalho Chehab struct stk1160 {
1160c0d06caSMauro Carvalho Chehab struct v4l2_device v4l2_dev;
1170c0d06caSMauro Carvalho Chehab struct video_device vdev;
1180c0d06caSMauro Carvalho Chehab struct v4l2_ctrl_handler ctrl_handler;
1190c0d06caSMauro Carvalho Chehab
1200c0d06caSMauro Carvalho Chehab struct device *dev;
1210c0d06caSMauro Carvalho Chehab struct usb_device *udev;
1220c0d06caSMauro Carvalho Chehab
1230c0d06caSMauro Carvalho Chehab /* saa7115 subdev */
1240c0d06caSMauro Carvalho Chehab struct v4l2_subdev *sd_saa7115;
1250c0d06caSMauro Carvalho Chehab
1260c0d06caSMauro Carvalho Chehab /* isoc control struct */
1270c0d06caSMauro Carvalho Chehab struct list_head avail_bufs;
1280c0d06caSMauro Carvalho Chehab
1290c0d06caSMauro Carvalho Chehab /* video capture */
1300c0d06caSMauro Carvalho Chehab struct vb2_queue vb_vidq;
1310c0d06caSMauro Carvalho Chehab
1320c0d06caSMauro Carvalho Chehab /* max packet size of isoc transaction */
1330c0d06caSMauro Carvalho Chehab int max_pkt_size;
1340c0d06caSMauro Carvalho Chehab /* array of wMaxPacketSize */
1350c0d06caSMauro Carvalho Chehab unsigned int *alt_max_pkt_size;
1360c0d06caSMauro Carvalho Chehab /* alternate */
1370c0d06caSMauro Carvalho Chehab int alt;
1380c0d06caSMauro Carvalho Chehab /* Number of alternative settings */
1390c0d06caSMauro Carvalho Chehab int num_alt;
1400c0d06caSMauro Carvalho Chehab
1410c0d06caSMauro Carvalho Chehab struct stk1160_isoc_ctl isoc_ctl;
1420c0d06caSMauro Carvalho Chehab
1430c0d06caSMauro Carvalho Chehab /* frame properties */
1440c0d06caSMauro Carvalho Chehab int width; /* current frame width */
1450c0d06caSMauro Carvalho Chehab int height; /* current frame height */
1460c0d06caSMauro Carvalho Chehab unsigned int ctl_input; /* selected input */
1470c0d06caSMauro Carvalho Chehab v4l2_std_id norm; /* current norm */
1480c0d06caSMauro Carvalho Chehab struct stk1160_fmt *fmt; /* selected format */
1490c0d06caSMauro Carvalho Chehab
150e3e30f63SHans Verkuil unsigned int sequence;
1510c0d06caSMauro Carvalho Chehab
1520c0d06caSMauro Carvalho Chehab /* i2c i/o */
1530c0d06caSMauro Carvalho Chehab struct i2c_adapter i2c_adap;
1540c0d06caSMauro Carvalho Chehab struct i2c_client i2c_client;
1550c0d06caSMauro Carvalho Chehab
1560c0d06caSMauro Carvalho Chehab struct mutex v4l_lock;
1570c0d06caSMauro Carvalho Chehab struct mutex vb_queue_lock;
1580c0d06caSMauro Carvalho Chehab spinlock_t buf_lock;
1590c0d06caSMauro Carvalho Chehab
1600c0d06caSMauro Carvalho Chehab struct file *fh_owner; /* filehandle ownership */
1610c0d06caSMauro Carvalho Chehab
1620c0d06caSMauro Carvalho Chehab /* EXPERIMENTAL */
1630c0d06caSMauro Carvalho Chehab struct snd_card *snd_card;
1640c0d06caSMauro Carvalho Chehab };
1650c0d06caSMauro Carvalho Chehab
1660c0d06caSMauro Carvalho Chehab struct regval {
1670c0d06caSMauro Carvalho Chehab u16 reg;
1680c0d06caSMauro Carvalho Chehab u16 val;
1690c0d06caSMauro Carvalho Chehab };
1700c0d06caSMauro Carvalho Chehab
1710c0d06caSMauro Carvalho Chehab /* Provided by stk1160-v4l.c */
1720c0d06caSMauro Carvalho Chehab int stk1160_vb2_setup(struct stk1160 *dev);
1730c0d06caSMauro Carvalho Chehab int stk1160_video_register(struct stk1160 *dev);
1740c0d06caSMauro Carvalho Chehab void stk1160_video_unregister(struct stk1160 *dev);
175fbe04b49SDafna Hirschfeld void stk1160_clear_queue(struct stk1160 *dev, enum vb2_buffer_state vb2_state);
1760c0d06caSMauro Carvalho Chehab
1770c0d06caSMauro Carvalho Chehab /* Provided by stk1160-video.c */
1780c0d06caSMauro Carvalho Chehab int stk1160_alloc_isoc(struct stk1160 *dev);
1790c0d06caSMauro Carvalho Chehab void stk1160_free_isoc(struct stk1160 *dev);
1800c0d06caSMauro Carvalho Chehab void stk1160_cancel_isoc(struct stk1160 *dev);
1810c0d06caSMauro Carvalho Chehab void stk1160_uninit_isoc(struct stk1160 *dev);
1820c0d06caSMauro Carvalho Chehab
1830c0d06caSMauro Carvalho Chehab /* Provided by stk1160-i2c.c */
1840c0d06caSMauro Carvalho Chehab int stk1160_i2c_register(struct stk1160 *dev);
1850c0d06caSMauro Carvalho Chehab int stk1160_i2c_unregister(struct stk1160 *dev);
1860c0d06caSMauro Carvalho Chehab
1870c0d06caSMauro Carvalho Chehab /* Provided by stk1160-core.c */
1880c0d06caSMauro Carvalho Chehab int stk1160_read_reg(struct stk1160 *dev, u16 reg, u8 *value);
1890c0d06caSMauro Carvalho Chehab int stk1160_write_reg(struct stk1160 *dev, u16 reg, u16 value);
1900c0d06caSMauro Carvalho Chehab int stk1160_write_regs_req(struct stk1160 *dev, u8 req, u16 reg,
1910c0d06caSMauro Carvalho Chehab char *buf, int len);
1920c0d06caSMauro Carvalho Chehab int stk1160_read_reg_req_len(struct stk1160 *dev, u8 req, u16 reg,
1930c0d06caSMauro Carvalho Chehab char *buf, int len);
1940c0d06caSMauro Carvalho Chehab void stk1160_select_input(struct stk1160 *dev);
1950c0d06caSMauro Carvalho Chehab
1960c0d06caSMauro Carvalho Chehab /* Provided by stk1160-ac97.c */
197e36e6b5fSMarcel Hasler void stk1160_ac97_setup(struct stk1160 *dev);
198*68d0c331SDafna Hirschfeld
stk1160_get_dmadev(struct stk1160 * dev)199*68d0c331SDafna Hirschfeld static inline struct device *stk1160_get_dmadev(struct stk1160 *dev)
200*68d0c331SDafna Hirschfeld {
201*68d0c331SDafna Hirschfeld return bus_to_hcd(dev->udev->bus)->self.sysdev;
202*68d0c331SDafna Hirschfeld }
203