[mirror_ubuntu-artful-kernel.git] / drivers / media / usb / stkwebcam / stk-webcam.h

/*
 * stk-webcam.h : Driver for Syntek 1125 USB webcam controller
 *
 * Copyright (C) 2006 Nicolas VIVIEN
 * Copyright 2007-2008 Jaime Velasco Juan <jsagarribay@gmail.com>
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation; either version 2 of the License, or
 * any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
 * GNU General Public License for more details.
 */

#ifndef STKWEBCAM_H
#define STKWEBCAM_H

#include <linux/usb.h>
#include <media/v4l2-device.h>
#include <media/v4l2-ctrls.h>
#include <media/v4l2-common.h>

#define DRIVER_VERSION		"v0.0.1"
#define DRIVER_VERSION_NUM	0x000001

#define MAX_ISO_BUFS		3
#define ISO_FRAMES_PER_DESC	16
#define ISO_MAX_FRAME_SIZE	3 * 1024
#define ISO_BUFFER_SIZE		(ISO_FRAMES_PER_DESC * ISO_MAX_FRAME_SIZE)


#define PREFIX				"stkwebcam: "
#define STK_INFO(str, args...)		printk(KERN_INFO PREFIX str, ##args)
#define STK_ERROR(str, args...)		printk(KERN_ERR PREFIX str, ##args)
#define STK_WARNING(str, args...)	printk(KERN_WARNING PREFIX str, ##args)

struct stk_iso_buf {
	void *data;
	int length;
	int read;
	struct urb *urb;
};

/* Streaming IO buffers */
struct stk_sio_buffer {
	struct v4l2_buffer v4lbuf;
	char *buffer;
	int mapcount;
	struct stk_camera *dev;
	struct list_head list;
};

enum stk_mode {MODE_VGA, MODE_SXGA, MODE_CIF, MODE_QVGA, MODE_QCIF};

struct stk_video {
	enum stk_mode mode;
	__u32 palette;
	int hflip;
	int vflip;
};

enum stk_status {
	S_PRESENT = 1,
	S_INITIALISED = 2,
	S_MEMALLOCD = 4,
	S_STREAMING = 8,
};
#define is_present(dev)		((dev)->status & S_PRESENT)
#define is_initialised(dev)	((dev)->status & S_INITIALISED)
#define is_streaming(dev)	((dev)->status & S_STREAMING)
#define is_memallocd(dev)	((dev)->status & S_MEMALLOCD)
#define set_present(dev)	((dev)->status = S_PRESENT)
#define unset_present(dev)	((dev)->status &= \
					~(S_PRESENT|S_INITIALISED|S_STREAMING))
#define set_initialised(dev)	((dev)->status |= S_INITIALISED)
#define unset_initialised(dev)	((dev)->status &= ~S_INITIALISED)
#define set_memallocd(dev)	((dev)->status |= S_MEMALLOCD)
#define unset_memallocd(dev)	((dev)->status &= ~S_MEMALLOCD)
#define set_streaming(dev)	((dev)->status |= S_STREAMING)
#define unset_streaming(dev)	((dev)->status &= ~S_STREAMING)

struct regval {
	unsigned reg;
	unsigned val;
};

struct stk_camera {
	struct v4l2_device v4l2_dev;
	struct v4l2_ctrl_handler hdl;
	struct video_device vdev;
	struct usb_device *udev;
	struct usb_interface *interface;
	int webcam_model;
	struct file *owner;
	struct mutex lock;
	int first_init;

	u8 isoc_ep;

	/* Not sure if this is right */
	atomic_t urbs_used;

	struct stk_video vsettings;

	enum stk_status status;

	spinlock_t spinlock;
	wait_queue_head_t wait_frame;

	struct stk_iso_buf *isobufs;

	int frame_size;
	/* Streaming buffers */
	int reading;
	unsigned int n_sbufs;
	struct stk_sio_buffer *sio_bufs;
	struct list_head sio_avail;
	struct list_head sio_full;
	unsigned sequence;
};

#define vdev_to_camera(d) container_of(d, struct stk_camera, vdev)

int stk_camera_write_reg(struct stk_camera *, u16, u8);
int stk_camera_read_reg(struct stk_camera *, u16, u8 *);

int stk_sensor_init(struct stk_camera *);
int stk_sensor_configure(struct stk_camera *);
int stk_sensor_sleep(struct stk_camera *dev);
int stk_sensor_wakeup(struct stk_camera *dev);
int stk_sensor_set_brightness(struct stk_camera *dev, int br);

#endif
Commit	Line	Data
ec16dae5 JVJ	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.
ec16dae5 JVJ	16	*/
	17
	18	#ifndef STKWEBCAM_H
	19	#define STKWEBCAM_H
	20
	21	#include <linux/usb.h>
968c60f6	22	#include <media/v4l2-device.h>
dc0fb286	23	#include <media/v4l2-ctrls.h>
ec16dae5 JVJ	24	#include <media/v4l2-common.h>
	25
	26	#define DRIVER_VERSION "v0.0.1"
	27	#define DRIVER_VERSION_NUM 0x000001
	28
	29	#define MAX_ISO_BUFS 3
	30	#define ISO_FRAMES_PER_DESC 16
	31	#define ISO_MAX_FRAME_SIZE 3 * 1024
	32	#define ISO_BUFFER_SIZE (ISO_FRAMES_PER_DESC * ISO_MAX_FRAME_SIZE)
	33
	34
	35	#define PREFIX "stkwebcam: "
	36	#define STK_INFO(str, args...) printk(KERN_INFO PREFIX str, ##args)
	37	#define STK_ERROR(str, args...) printk(KERN_ERR PREFIX str, ##args)
	38	#define STK_WARNING(str, args...) printk(KERN_WARNING PREFIX str, ##args)
	39
	40	struct stk_iso_buf {
	41	void *data;
	42	int length;
	43	int read;
	44	struct urb *urb;
	45	};
	46
	47	/* Streaming IO buffers */
	48	struct stk_sio_buffer {
	49	struct v4l2_buffer v4lbuf;
	50	char *buffer;
	51	int mapcount;
	52	struct stk_camera *dev;
	53	struct list_head list;
	54	};
	55
	56	enum stk_mode {MODE_VGA, MODE_SXGA, MODE_CIF, MODE_QVGA, MODE_QCIF};
	57
	58	struct stk_video {
	59	enum stk_mode mode;
ec16dae5 JVJ	60	__u32 palette;
	61	int hflip;
	62	int vflip;
	63	};
	64
	65	enum stk_status {
	66	S_PRESENT = 1,
	67	S_INITIALISED = 2,
	68	S_MEMALLOCD = 4,
	69	S_STREAMING = 8,
	70	};
	71	#define is_present(dev) ((dev)->status & S_PRESENT)
	72	#define is_initialised(dev) ((dev)->status & S_INITIALISED)
	73	#define is_streaming(dev) ((dev)->status & S_STREAMING)
	74	#define is_memallocd(dev) ((dev)->status & S_MEMALLOCD)
	75	#define set_present(dev) ((dev)->status = S_PRESENT)
	76	#define unset_present(dev) ((dev)->status &= \
	77	~(S_PRESENT\|S_INITIALISED\|S_STREAMING))
	78	#define set_initialised(dev) ((dev)->status \|= S_INITIALISED)
1fdd61c0	79	#define unset_initialised(dev) ((dev)->status &= ~S_INITIALISED)
ec16dae5 JVJ	80	#define set_memallocd(dev) ((dev)->status \|= S_MEMALLOCD)
	81	#define unset_memallocd(dev) ((dev)->status &= ~S_MEMALLOCD)
	82	#define set_streaming(dev) ((dev)->status \|= S_STREAMING)
	83	#define unset_streaming(dev) ((dev)->status &= ~S_STREAMING)
	84
	85	struct regval {
	86	unsigned reg;
	87	unsigned val;
	88	};
	89
	90	struct stk_camera {
968c60f6	91	struct v4l2_device v4l2_dev;
dc0fb286	92	struct v4l2_ctrl_handler hdl;
ec16dae5 JVJ	93	struct video_device vdev;
	94	struct usb_device *udev;
	95	struct usb_interface *interface;
	96	int webcam_model;
	97	struct file *owner;
f80daa2d	98	struct mutex lock;
89ea4706	99	int first_init;
ec16dae5 JVJ	100
	101	u8 isoc_ep;
	102
ec16dae5 JVJ	103	/* Not sure if this is right */
	104	atomic_t urbs_used;
	105
	106	struct stk_video vsettings;
	107
	108	enum stk_status status;
	109
	110	spinlock_t spinlock;
	111	wait_queue_head_t wait_frame;
	112
	113	struct stk_iso_buf *isobufs;
	114
	115	int frame_size;
	116	/* Streaming buffers */
1b499fe5	117	int reading;
ec16dae5 JVJ	118	unsigned int n_sbufs;
	119	struct stk_sio_buffer *sio_bufs;
	120	struct list_head sio_avail;
	121	struct list_head sio_full;
	122	unsigned sequence;
	123	};
	124
ec16dae5 JVJ	125	#define vdev_to_camera(d) container_of(d, struct stk_camera, vdev)
ec16dae5 JVJ	126
ec16dae5	127	int stk_camera_write_reg(struct stk_camera *, u16, u8);
d08876f5	128	int stk_camera_read_reg(struct stk_camera , u16, u8 );
ec16dae5	129
ec16dae5 JVJ	130	int stk_sensor_init(struct stk_camera *);
	131	int stk_sensor_configure(struct stk_camera *);
	132	int stk_sensor_sleep(struct stk_camera *dev);
	133	int stk_sensor_wakeup(struct stk_camera *dev);
	134	int stk_sensor_set_brightness(struct stk_camera *dev, int br);
	135
	136	#endif