• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1 /*
2  * stk-webcam.h : Driver for Syntek 1125 USB webcam controller
3  *
4  * Copyright (C) 2006 Nicolas VIVIEN
5  * Copyright 2007-2008 Jaime Velasco Juan <jsagarribay@gmail.com>
6  *
7  * This program is free software; you can redistribute it and/or modify
8  * it under the terms of the GNU General Public License as published by
9  * the Free Software Foundation; either version 2 of the License, or
10  * any later version.
11  *
12  * This program is distributed in the hope that it will be useful,
13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15  * GNU General Public License for more details.
16  *
17  * You should have received a copy of the GNU General Public License
18  * along with this program; if not, write to the Free Software
19  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
20  */
21 
22 #ifndef STKWEBCAM_H
23 #define STKWEBCAM_H
24 
25 #include <linux/usb.h>
26 #include <media/v4l2-device.h>
27 #include <media/v4l2-ctrls.h>
28 #include <media/v4l2-common.h>
29 
30 #define DRIVER_VERSION		"v0.0.1"
31 #define DRIVER_VERSION_NUM	0x000001
32 
33 #define MAX_ISO_BUFS		3
34 #define ISO_FRAMES_PER_DESC	16
35 #define ISO_MAX_FRAME_SIZE	3 * 1024
36 #define ISO_BUFFER_SIZE		(ISO_FRAMES_PER_DESC * ISO_MAX_FRAME_SIZE)
37 
38 
39 #define PREFIX				"stkwebcam: "
40 #define STK_INFO(str, args...)		printk(KERN_INFO PREFIX str, ##args)
41 #define STK_ERROR(str, args...)		printk(KERN_ERR PREFIX str, ##args)
42 #define STK_WARNING(str, args...)	printk(KERN_WARNING PREFIX str, ##args)
43 
44 struct stk_iso_buf {
45 	void *data;
46 	int length;
47 	int read;
48 	struct urb *urb;
49 };
50 
51 /* Streaming IO buffers */
52 struct stk_sio_buffer {
53 	struct v4l2_buffer v4lbuf;
54 	char *buffer;
55 	int mapcount;
56 	struct stk_camera *dev;
57 	struct list_head list;
58 };
59 
60 enum stk_mode {MODE_VGA, MODE_SXGA, MODE_CIF, MODE_QVGA, MODE_QCIF};
61 
62 struct stk_video {
63 	enum stk_mode mode;
64 	__u32 palette;
65 	int hflip;
66 	int vflip;
67 };
68 
69 enum stk_status {
70 	S_PRESENT = 1,
71 	S_INITIALISED = 2,
72 	S_MEMALLOCD = 4,
73 	S_STREAMING = 8,
74 };
75 #define is_present(dev)		((dev)->status & S_PRESENT)
76 #define is_initialised(dev)	((dev)->status & S_INITIALISED)
77 #define is_streaming(dev)	((dev)->status & S_STREAMING)
78 #define is_memallocd(dev)	((dev)->status & S_MEMALLOCD)
79 #define set_present(dev)	((dev)->status = S_PRESENT)
80 #define unset_present(dev)	((dev)->status &= \
81 					~(S_PRESENT|S_INITIALISED|S_STREAMING))
82 #define set_initialised(dev)	((dev)->status |= S_INITIALISED)
83 #define unset_initialised(dev)	((dev)->status &= ~S_INITIALISED)
84 #define set_memallocd(dev)	((dev)->status |= S_MEMALLOCD)
85 #define unset_memallocd(dev)	((dev)->status &= ~S_MEMALLOCD)
86 #define set_streaming(dev)	((dev)->status |= S_STREAMING)
87 #define unset_streaming(dev)	((dev)->status &= ~S_STREAMING)
88 
89 struct regval {
90 	unsigned reg;
91 	unsigned val;
92 };
93 
94 struct stk_camera {
95 	struct v4l2_device v4l2_dev;
96 	struct v4l2_ctrl_handler hdl;
97 	struct video_device vdev;
98 	struct usb_device *udev;
99 	struct usb_interface *interface;
100 	int webcam_model;
101 	struct file *owner;
102 	struct mutex lock;
103 	int first_init;
104 
105 	u8 isoc_ep;
106 
107 	/* Not sure if this is right */
108 	atomic_t urbs_used;
109 
110 	struct stk_video vsettings;
111 
112 	enum stk_status status;
113 
114 	spinlock_t spinlock;
115 	wait_queue_head_t wait_frame;
116 
117 	struct stk_iso_buf *isobufs;
118 
119 	int frame_size;
120 	/* Streaming buffers */
121 	int reading;
122 	unsigned int n_sbufs;
123 	struct stk_sio_buffer *sio_bufs;
124 	struct list_head sio_avail;
125 	struct list_head sio_full;
126 	unsigned sequence;
127 };
128 
129 #define vdev_to_camera(d) container_of(d, struct stk_camera, vdev)
130 
131 int stk_camera_write_reg(struct stk_camera *, u16, u8);
132 int stk_camera_read_reg(struct stk_camera *, u16, int *);
133 
134 int stk_sensor_init(struct stk_camera *);
135 int stk_sensor_configure(struct stk_camera *);
136 int stk_sensor_sleep(struct stk_camera *dev);
137 int stk_sensor_wakeup(struct stk_camera *dev);
138 int stk_sensor_set_brightness(struct stk_camera *dev, int br);
139 
140 #endif
141