blob: 2e3c3de793a72a2161a2bf1c0ca69fd8c3b91b7c [file] [log] [blame]
Linus Torvalds1da177e2005-04-16 15:20:36 -07001/***************************************************************************
Luca Risoliaf327ebb2007-01-08 10:43:56 -03002 * V4L2 driver for SN9C1xx PC Camera Controllers *
Linus Torvalds1da177e2005-04-16 15:20:36 -07003 * *
Luca Risoliaa966f3e2006-01-05 18:14:04 +00004 * Copyright (C) 2004-2006 by Luca Risolia <luca.risolia@studio.unibo.it> *
Linus Torvalds1da177e2005-04-16 15:20:36 -07005 * *
6 * This program is free software; you can redistribute it and/or modify *
7 * it under the terms of the GNU General Public License as published by *
8 * the Free Software Foundation; either version 2 of the License, or *
9 * (at your option) any later version. *
10 * *
11 * This program is distributed in the hope that it will be useful, *
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of *
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the *
14 * GNU General Public License for more details. *
15 * *
16 * You should have received a copy of the GNU General Public License *
17 * along with this program; if not, write to the Free Software *
18 * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. *
19 ***************************************************************************/
20
21#ifndef _SN9C102_H_
22#define _SN9C102_H_
23
24#include <linux/version.h>
25#include <linux/usb.h>
Luca Risoliacd6fcc52006-01-13 17:19:43 +000026#include <linux/videodev2.h>
27#include <media/v4l2-common.h>
Linus Torvalds1da177e2005-04-16 15:20:36 -070028#include <linux/device.h>
29#include <linux/list.h>
30#include <linux/spinlock.h>
31#include <linux/time.h>
32#include <linux/wait.h>
33#include <linux/types.h>
34#include <linux/param.h>
35#include <linux/rwsem.h>
Arjan van de Ven4186ecf2006-01-11 15:55:29 +010036#include <linux/mutex.h>
Luca Risolia2ffab022006-02-25 06:50:47 +000037#include <linux/string.h>
38#include <linux/stddef.h>
Luca Risolia3770be32007-06-13 14:37:50 -030039#include <linux/kref.h>
Linus Torvalds1da177e2005-04-16 15:20:36 -070040
Luca Risoliaf327ebb2007-01-08 10:43:56 -030041#include "sn9c102_config.h"
Linus Torvalds1da177e2005-04-16 15:20:36 -070042#include "sn9c102_sensor.h"
Luca Risoliaf327ebb2007-01-08 10:43:56 -030043#include "sn9c102_devtable.h"
Linus Torvalds1da177e2005-04-16 15:20:36 -070044
Linus Torvalds1da177e2005-04-16 15:20:36 -070045
46enum sn9c102_frame_state {
47 F_UNUSED,
48 F_QUEUED,
49 F_GRABBING,
50 F_DONE,
51 F_ERROR,
52};
53
54struct sn9c102_frame_t {
55 void* bufmem;
56 struct v4l2_buffer buf;
57 enum sn9c102_frame_state state;
58 struct list_head frame;
59 unsigned long vma_use_count;
60};
61
62enum sn9c102_dev_state {
63 DEV_INITIALIZED = 0x01,
64 DEV_DISCONNECTED = 0x02,
65 DEV_MISCONFIGURED = 0x04,
66};
67
68enum sn9c102_io_method {
69 IO_NONE,
70 IO_READ,
71 IO_MMAP,
72};
73
74enum sn9c102_stream_state {
75 STREAM_OFF,
76 STREAM_INTERRUPT,
77 STREAM_ON,
78};
79
Luca Risoliaf327ebb2007-01-08 10:43:56 -030080typedef char sn9c102_sof_header_t[62];
Linus Torvalds1da177e2005-04-16 15:20:36 -070081
Luca Risoliaf423b9a2007-03-26 16:12:04 -030082struct sn9c102_sof_t {
83 sn9c102_sof_header_t header;
84 u16 bytesread;
85};
86
Linus Torvalds1da177e2005-04-16 15:20:36 -070087struct sn9c102_sysfs_attr {
Luca Risoliaf423b9a2007-03-26 16:12:04 -030088 u16 reg, i2c_reg;
Luca Risoliaf327ebb2007-01-08 10:43:56 -030089 sn9c102_sof_header_t frame_header;
Linus Torvalds1da177e2005-04-16 15:20:36 -070090};
91
92struct sn9c102_module_param {
93 u8 force_munmap;
Luca Risolia2ffab022006-02-25 06:50:47 +000094 u16 frame_timeout;
Linus Torvalds1da177e2005-04-16 15:20:36 -070095};
96
Arjan van de Ven4186ecf2006-01-11 15:55:29 +010097static DEFINE_MUTEX(sn9c102_sysfs_lock);
Luca Risolia3770be32007-06-13 14:37:50 -030098static DECLARE_RWSEM(sn9c102_dev_lock);
Linus Torvalds1da177e2005-04-16 15:20:36 -070099
100struct sn9c102_device {
Linus Torvalds1da177e2005-04-16 15:20:36 -0700101 struct video_device* v4ldev;
102
103 enum sn9c102_bridge bridge;
Luca Risolia2ffab022006-02-25 06:50:47 +0000104 struct sn9c102_sensor sensor;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700105
106 struct usb_device* usbdev;
107 struct urb* urb[SN9C102_URBS];
108 void* transfer_buffer[SN9C102_URBS];
109 u8* control_buffer;
110
111 struct sn9c102_frame_t *frame_current, frame[SN9C102_MAX_FRAMES];
112 struct list_head inqueue, outqueue;
113 u32 frame_count, nbuffers, nreadbuffers;
114
115 enum sn9c102_io_method io;
116 enum sn9c102_stream_state stream;
117
118 struct v4l2_jpegcompression compression;
119
120 struct sn9c102_sysfs_attr sysfs;
Luca Risoliaf423b9a2007-03-26 16:12:04 -0300121 struct sn9c102_sof_t sof;
Luca Risoliaf327ebb2007-01-08 10:43:56 -0300122 u16 reg[384];
Linus Torvalds1da177e2005-04-16 15:20:36 -0700123
124 struct sn9c102_module_param module_param;
125
Luca Risolia3770be32007-06-13 14:37:50 -0300126 struct kref kref;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700127 enum sn9c102_dev_state state;
128 u8 users;
129
Luca Risolia3770be32007-06-13 14:37:50 -0300130 struct completion probe;
131 struct mutex open_mutex, fileop_mutex;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700132 spinlock_t queue_lock;
Luca Risolia3770be32007-06-13 14:37:50 -0300133 wait_queue_head_t wait_open, wait_frame, wait_stream;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700134};
135
136/*****************************************************************************/
137
Luca Risolia2ffab022006-02-25 06:50:47 +0000138struct sn9c102_device*
139sn9c102_match_id(struct sn9c102_device* cam, const struct usb_device_id *id)
140{
Luca Risoliaf327ebb2007-01-08 10:43:56 -0300141 return usb_match_id(usb_ifnum_to_if(cam->usbdev, 0), id) ? cam : NULL;
Luca Risolia2ffab022006-02-25 06:50:47 +0000142}
143
144
Linus Torvalds1da177e2005-04-16 15:20:36 -0700145void
146sn9c102_attach_sensor(struct sn9c102_device* cam,
Luca Risolia480b55c22007-05-02 10:04:03 -0300147 const struct sn9c102_sensor* sensor)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700148{
Luca Risolia2ffab022006-02-25 06:50:47 +0000149 memcpy(&cam->sensor, sensor, sizeof(struct sn9c102_sensor));
Linus Torvalds1da177e2005-04-16 15:20:36 -0700150}
151
Luca Risoliaf327ebb2007-01-08 10:43:56 -0300152
153enum sn9c102_bridge
154sn9c102_get_bridge(struct sn9c102_device* cam)
155{
156 return cam->bridge;
157}
158
159
160struct sn9c102_sensor* sn9c102_get_sensor(struct sn9c102_device* cam)
161{
162 return &cam->sensor;
163}
164
Linus Torvalds1da177e2005-04-16 15:20:36 -0700165/*****************************************************************************/
166
167#undef DBG
168#undef KDBG
169#ifdef SN9C102_DEBUG
170# define DBG(level, fmt, args...) \
Luca Risoliaa966f3e2006-01-05 18:14:04 +0000171do { \
Linus Torvalds1da177e2005-04-16 15:20:36 -0700172 if (debug >= (level)) { \
173 if ((level) == 1) \
Luca Risoliacd6fcc52006-01-13 17:19:43 +0000174 dev_err(&cam->usbdev->dev, fmt "\n", ## args); \
Linus Torvalds1da177e2005-04-16 15:20:36 -0700175 else if ((level) == 2) \
Luca Risoliacd6fcc52006-01-13 17:19:43 +0000176 dev_info(&cam->usbdev->dev, fmt "\n", ## args); \
Linus Torvalds1da177e2005-04-16 15:20:36 -0700177 else if ((level) >= 3) \
Luca Risoliacd6fcc52006-01-13 17:19:43 +0000178 dev_info(&cam->usbdev->dev, "[%s:%d] " fmt "\n", \
Mauro Carvalho Chehabd56410e2006-03-25 09:19:53 -0300179 __FUNCTION__, __LINE__ , ## args); \
Linus Torvalds1da177e2005-04-16 15:20:36 -0700180 } \
Luca Risoliaa966f3e2006-01-05 18:14:04 +0000181} while (0)
Luca Risoliacd6fcc52006-01-13 17:19:43 +0000182# define V4LDBG(level, name, cmd) \
183do { \
184 if (debug >= (level)) \
185 v4l_print_ioctl(name, cmd); \
186} while (0)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700187# define KDBG(level, fmt, args...) \
Luca Risoliaa966f3e2006-01-05 18:14:04 +0000188do { \
Linus Torvalds1da177e2005-04-16 15:20:36 -0700189 if (debug >= (level)) { \
190 if ((level) == 1 || (level) == 2) \
191 pr_info("sn9c102: " fmt "\n", ## args); \
192 else if ((level) == 3) \
Luca Risoliaf423b9a2007-03-26 16:12:04 -0300193 pr_debug("sn9c102: [%s:%d] " fmt "\n", \
194 __FUNCTION__, __LINE__ , ## args); \
Linus Torvalds1da177e2005-04-16 15:20:36 -0700195 } \
Luca Risoliaa966f3e2006-01-05 18:14:04 +0000196} while (0)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700197#else
Luca Risoliaa966f3e2006-01-05 18:14:04 +0000198# define DBG(level, fmt, args...) do {;} while(0)
Luca Risoliacd6fcc52006-01-13 17:19:43 +0000199# define V4LDBG(level, name, cmd) do {;} while(0)
200# define KDBG(level, fmt, args...) do {;} while(0)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700201#endif
202
203#undef PDBG
204#define PDBG(fmt, args...) \
Luca Risoliaf423b9a2007-03-26 16:12:04 -0300205dev_info(&cam->usbdev->dev, "[%s:%s:%d] " fmt "\n", __FILE__, __FUNCTION__, \
206 __LINE__ , ## args)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700207
208#undef PDBGG
Luca Risoliaa966f3e2006-01-05 18:14:04 +0000209#define PDBGG(fmt, args...) do {;} while(0) /* placeholder */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700210
211#endif /* _SN9C102_H_ */