xref: /linux/drivers/media/usb/stk1160/stk1160.h (revision 4f2c0a4acffbec01079c28f839422e64ddeff004)
1 /* SPDX-License-Identifier: GPL-2.0-or-later */
2 /*
3  * STK1160 driver
4  *
5  * Copyright (C) 2012 Ezequiel Garcia
6  * <elezegarcia--a.t--gmail.com>
7  *
8  * Based on Easycap driver by R.M. Thomas
9  *	Copyright (C) 2010 R.M. Thomas
10  *	<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	0x000905
24 
25 /* Decide on number of packets for each buffer */
26 #define STK1160_NUM_PACKETS 64
27 
28 /* Number of buffers for isoc transfers */
29 #define STK1160_NUM_BUFS 16
30 #define STK1160_MIN_BUFS 1
31 
32 /* TODO: This endpoint address should be retrieved */
33 #define STK1160_EP_VIDEO 0x82
34 #define STK1160_EP_AUDIO 0x81
35 
36 /* Max and min video buffers */
37 #define STK1160_MIN_VIDEO_BUFFERS 8
38 #define STK1160_MAX_VIDEO_BUFFERS 32
39 
40 #define STK1160_MIN_PKT_SIZE 3072
41 
42 #define STK1160_MAX_INPUT 4
43 #define STK1160_SVIDEO_INPUT 4
44 
45 #define STK1160_AC97_TIMEOUT 50
46 
47 #define STK1160_I2C_TIMEOUT 100
48 
49 /* TODO: Print helpers
50  * I could use dev_xxx, pr_xxx, v4l2_xxx or printk.
51  * However, there isn't a solid consensus on which
52  * new drivers should use.
53  *
54  */
55 #ifdef DEBUG
56 #define stk1160_dbg(fmt, args...) \
57 	printk(KERN_DEBUG "stk1160: " fmt,  ## args)
58 #else
59 #define stk1160_dbg(fmt, args...)
60 #endif
61 
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 */
72 struct 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 
89 struct 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 
97 struct 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 
110 struct stk1160_fmt {
111 	u32   fourcc;          /* v4l2 format id */
112 	int   depth;
113 };
114 
115 struct 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 
166 struct regval {
167 	u16 reg;
168 	u16 val;
169 };
170 
171 /* Provided by stk1160-v4l.c */
172 int stk1160_vb2_setup(struct stk1160 *dev);
173 int stk1160_video_register(struct stk1160 *dev);
174 void stk1160_video_unregister(struct stk1160 *dev);
175 void stk1160_clear_queue(struct stk1160 *dev, enum vb2_buffer_state vb2_state);
176 
177 /* Provided by stk1160-video.c */
178 int stk1160_alloc_isoc(struct stk1160 *dev);
179 void stk1160_free_isoc(struct stk1160 *dev);
180 void stk1160_cancel_isoc(struct stk1160 *dev);
181 void stk1160_uninit_isoc(struct stk1160 *dev);
182 
183 /* Provided by stk1160-i2c.c */
184 int stk1160_i2c_register(struct stk1160 *dev);
185 int stk1160_i2c_unregister(struct stk1160 *dev);
186 
187 /* Provided by stk1160-core.c */
188 int stk1160_read_reg(struct stk1160 *dev, u16 reg, u8 *value);
189 int stk1160_write_reg(struct stk1160 *dev, u16 reg, u16 value);
190 int stk1160_write_regs_req(struct stk1160 *dev, u8 req, u16 reg,
191 		char *buf, int len);
192 int stk1160_read_reg_req_len(struct stk1160 *dev, u8 req, u16 reg,
193 		char *buf, int len);
194 void stk1160_select_input(struct stk1160 *dev);
195 
196 /* Provided by stk1160-ac97.c */
197 void stk1160_ac97_setup(struct stk1160 *dev);
198 
stk1160_get_dmadev(struct stk1160 * dev)199 static inline struct device *stk1160_get_dmadev(struct stk1160 *dev)
200 {
201 	return bus_to_hcd(dev->udev->bus)->self.sysdev;
202 }
203