[mirror_ubuntu-zesty-kernel.git] / include / media / soc_camera.h

/*
 * camera image capture (abstract) bus driver header
 *
 * Copyright (C) 2006, Sascha Hauer, Pengutronix
 * Copyright (C) 2008, Guennadi Liakhovetski <kernel@pengutronix.de>
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License version 2 as
 * published by the Free Software Foundation.
 */

#ifndef SOC_CAMERA_H
#define SOC_CAMERA_H

#include <linux/videodev2.h>
#include <media/videobuf-core.h>

struct soc_camera_device {
	struct list_head list;
	struct device dev;
	struct device *control;
	unsigned short width;		/* Current window */
	unsigned short height;		/* sizes */
	unsigned short x_min;		/* Camera capabilities */
	unsigned short y_min;
	unsigned short x_current;	/* Current window location */
	unsigned short y_current;
	unsigned short width_min;
	unsigned short width_max;
	unsigned short height_min;
	unsigned short height_max;
	unsigned short y_skip_top;	/* Lines to skip at the top */
	unsigned short gain;
	unsigned short exposure;
	unsigned char iface;		/* Host number */
	unsigned char devnum;		/* Device number per host */
	unsigned char buswidth;		/* See comment in .c */
	struct soc_camera_ops *ops;
	struct video_device *vdev;
	const struct soc_camera_data_format *current_fmt;
	const struct soc_camera_data_format *formats;
	int num_formats;
	struct module *owner;
	/* soc_camera.c private count. Only accessed with video_lock held */
	int use_count;
};

struct soc_camera_file {
	struct soc_camera_device *icd;
	struct videobuf_queue vb_vidq;
	spinlock_t *lock;
};

struct soc_camera_host {
	struct list_head list;
	struct device dev;
	unsigned char nr;				/* Host number */
	void *priv;
	char *drv_name;
	struct soc_camera_host_ops *ops;
};

struct soc_camera_host_ops {
	struct module *owner;
	int (*add)(struct soc_camera_device *);
	void (*remove)(struct soc_camera_device *);
	int (*set_fmt_cap)(struct soc_camera_device *, __u32,
			   struct v4l2_rect *);
	int (*try_fmt_cap)(struct soc_camera_device *, struct v4l2_format *);
	void (*init_videobuf)(struct videobuf_queue*, spinlock_t *,
			      struct soc_camera_device *);
	int (*reqbufs)(struct soc_camera_file *, struct v4l2_requestbuffers *);
	int (*querycap)(struct soc_camera_host *, struct v4l2_capability *);
	int (*try_bus_param)(struct soc_camera_device *, __u32);
	int (*set_bus_param)(struct soc_camera_device *, __u32);
	unsigned int (*poll)(struct file *, poll_table *);
	spinlock_t* (*spinlock_alloc)(struct soc_camera_file *);
	void (*spinlock_free)(spinlock_t *);
};

struct soc_camera_link {
	/* Camera bus id, used to match a camera and a bus */
	int bus_id;
	/* GPIO number to switch between 8 and 10 bit modes */
	unsigned int gpio;
};

static inline struct soc_camera_device *to_soc_camera_dev(struct device *dev)
{
	return container_of(dev, struct soc_camera_device, dev);
}

static inline struct soc_camera_host *to_soc_camera_host(struct device *dev)
{
	return container_of(dev, struct soc_camera_host, dev);
}

extern int soc_camera_host_register(struct soc_camera_host *ici);
extern void soc_camera_host_unregister(struct soc_camera_host *ici);
extern int soc_camera_device_register(struct soc_camera_device *icd);
extern void soc_camera_device_unregister(struct soc_camera_device *icd);

extern int soc_camera_video_start(struct soc_camera_device *icd);
extern void soc_camera_video_stop(struct soc_camera_device *icd);

struct soc_camera_data_format {
	char *name;
	unsigned int depth;
	__u32 fourcc;
	enum v4l2_colorspace colorspace;
};

struct soc_camera_ops {
	struct module *owner;
	int (*probe)(struct soc_camera_device *);
	void (*remove)(struct soc_camera_device *);
	int (*init)(struct soc_camera_device *);
	int (*release)(struct soc_camera_device *);
	int (*start_capture)(struct soc_camera_device *);
	int (*stop_capture)(struct soc_camera_device *);
	int (*set_fmt_cap)(struct soc_camera_device *, __u32,
			   struct v4l2_rect *);
	int (*try_fmt_cap)(struct soc_camera_device *, struct v4l2_format *);
	unsigned long (*query_bus_param)(struct soc_camera_device *);
	int (*set_bus_param)(struct soc_camera_device *, unsigned long);
	int (*get_chip_id)(struct soc_camera_device *,
			   struct v4l2_chip_ident *);
#ifdef CONFIG_VIDEO_ADV_DEBUG
	int (*get_register)(struct soc_camera_device *, struct v4l2_register *);
	int (*set_register)(struct soc_camera_device *, struct v4l2_register *);
#endif
	int (*get_control)(struct soc_camera_device *, struct v4l2_control *);
	int (*set_control)(struct soc_camera_device *, struct v4l2_control *);
	const struct v4l2_queryctrl *controls;
	int num_controls;
};

static inline struct v4l2_queryctrl const *soc_camera_find_qctrl(
	struct soc_camera_ops *ops, int id)
{
	int i;

	for (i = 0; i < ops->num_controls; i++)
		if (ops->controls[i].id == id)
			return &ops->controls[i];

	return NULL;
}

#define SOCAM_MASTER			(1 << 0)
#define SOCAM_SLAVE			(1 << 1)
#define SOCAM_HSYNC_ACTIVE_HIGH		(1 << 2)
#define SOCAM_HSYNC_ACTIVE_LOW		(1 << 3)
#define SOCAM_VSYNC_ACTIVE_HIGH		(1 << 4)
#define SOCAM_VSYNC_ACTIVE_LOW		(1 << 5)
#define SOCAM_DATAWIDTH_8		(1 << 6)
#define SOCAM_DATAWIDTH_9		(1 << 7)
#define SOCAM_DATAWIDTH_10		(1 << 8)
#define SOCAM_PCLK_SAMPLE_RISING	(1 << 9)
#define SOCAM_PCLK_SAMPLE_FALLING	(1 << 10)

#define SOCAM_DATAWIDTH_MASK (SOCAM_DATAWIDTH_8 | SOCAM_DATAWIDTH_9 | \
			      SOCAM_DATAWIDTH_10)

static inline unsigned long soc_camera_bus_param_compatible(
			unsigned long camera_flags, unsigned long bus_flags)
{
	unsigned long common_flags, hsync, vsync, pclk;

	common_flags = camera_flags & bus_flags;

	hsync = common_flags & (SOCAM_HSYNC_ACTIVE_HIGH | SOCAM_HSYNC_ACTIVE_LOW);
	vsync = common_flags & (SOCAM_VSYNC_ACTIVE_HIGH | SOCAM_VSYNC_ACTIVE_LOW);
	pclk = common_flags & (SOCAM_PCLK_SAMPLE_RISING | SOCAM_PCLK_SAMPLE_FALLING);

	return (!hsync || !vsync || !pclk) ? 0 : common_flags;
}

#endif
Commit	Line	Data
e55222ef GL	1	/*
	2	* camera image capture (abstract) bus driver header
	3	*
	4	* Copyright (C) 2006, Sascha Hauer, Pengutronix
	5	* Copyright (C) 2008, Guennadi Liakhovetski <kernel@pengutronix.de>
	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 version 2 as
	9	* published by the Free Software Foundation.
	10	*/
	11
	12	#ifndef SOC_CAMERA_H
	13	#define SOC_CAMERA_H
	14
	15	#include <linux/videodev2.h>
092d3921	16	#include <media/videobuf-core.h>
e55222ef GL	17
	18	struct soc_camera_device {
	19	struct list_head list;
	20	struct device dev;
	21	struct device *control;
	22	unsigned short width; /* Current window */
	23	unsigned short height; /* sizes */
	24	unsigned short x_min; /* Camera capabilities */
	25	unsigned short y_min;
	26	unsigned short x_current; /* Current window location */
	27	unsigned short y_current;
	28	unsigned short width_min;
	29	unsigned short width_max;
	30	unsigned short height_min;
	31	unsigned short height_max;
	32	unsigned short y_skip_top; /* Lines to skip at the top */
	33	unsigned short gain;
	34	unsigned short exposure;
	35	unsigned char iface; /* Host number */
	36	unsigned char devnum; /* Device number per host */
ad5f2e85	37	unsigned char buswidth; /* See comment in .c */
e55222ef GL	38	struct soc_camera_ops *ops;
	39	struct video_device *vdev;
	40	const struct soc_camera_data_format *current_fmt;
26f1b942 GL	41	const struct soc_camera_data_format *formats;
26f1b942 GL	42	int num_formats;
e55222ef	43	struct module *owner;
9dc4e48f GL	44	/* soc_camera.c private count. Only accessed with video_lock held */
9dc4e48f GL	45	int use_count;
e55222ef GL	46	};
	47
	48	struct soc_camera_file {
	49	struct soc_camera_device *icd;
	50	struct videobuf_queue vb_vidq;
1a0063a9	51	spinlock_t *lock;
e55222ef GL	52	};
	53
	54	struct soc_camera_host {
	55	struct list_head list;
	56	struct device dev;
	57	unsigned char nr; /* Host number */
e55222ef GL	58	void *priv;
e55222ef GL	59	char *drv_name;
b8d9904c GL	60	struct soc_camera_host_ops *ops;
	61	};
	62
	63	struct soc_camera_host_ops {
	64	struct module *owner;
e55222ef GL	65	int (add)(struct soc_camera_device );
e55222ef GL	66	void (remove)(struct soc_camera_device );
ad5f2e85 GL	67	int (set_fmt_cap)(struct soc_camera_device , __u32,
	68	struct v4l2_rect *);
	69	int (try_fmt_cap)(struct soc_camera_device , struct v4l2_format *);
092d3921 PZ	70	void (init_videobuf)(struct videobuf_queue, spinlock_t *,
092d3921 PZ	71	struct soc_camera_device *);
e55222ef GL	72	int (reqbufs)(struct soc_camera_file , struct v4l2_requestbuffers *);
e55222ef GL	73	int (querycap)(struct soc_camera_host , struct v4l2_capability *);
ad5f2e85 GL	74	int (try_bus_param)(struct soc_camera_device , __u32);
ad5f2e85 GL	75	int (set_bus_param)(struct soc_camera_device , __u32);
e55222ef	76	unsigned int (poll)(struct file , poll_table *);
1a0063a9 GL	77	spinlock_t* (spinlock_alloc)(struct soc_camera_file );
1a0063a9 GL	78	void (spinlock_free)(spinlock_t );
e55222ef GL	79	};
	80
	81	struct soc_camera_link {
	82	/* Camera bus id, used to match a camera and a bus */
	83	int bus_id;
	84	/* GPIO number to switch between 8 and 10 bit modes */
	85	unsigned int gpio;
	86	};
	87
	88	static inline struct soc_camera_device to_soc_camera_dev(struct device dev)
	89	{
	90	return container_of(dev, struct soc_camera_device, dev);
	91	}
	92
	93	static inline struct soc_camera_host to_soc_camera_host(struct device dev)
	94	{
	95	return container_of(dev, struct soc_camera_host, dev);
	96	}
	97
b8d9904c	98	extern int soc_camera_host_register(struct soc_camera_host *ici);
e55222ef GL	99	extern void soc_camera_host_unregister(struct soc_camera_host *ici);
	100	extern int soc_camera_device_register(struct soc_camera_device *icd);
	101	extern void soc_camera_device_unregister(struct soc_camera_device *icd);
	102
	103	extern int soc_camera_video_start(struct soc_camera_device *icd);
	104	extern void soc_camera_video_stop(struct soc_camera_device *icd);
	105
	106	struct soc_camera_data_format {
	107	char *name;
	108	unsigned int depth;
	109	__u32 fourcc;
	110	enum v4l2_colorspace colorspace;
	111	};
	112
	113	struct soc_camera_ops {
	114	struct module *owner;
26f1b942 GL	115	int (probe)(struct soc_camera_device );
26f1b942 GL	116	void (remove)(struct soc_camera_device );
e55222ef GL	117	int (init)(struct soc_camera_device );
	118	int (release)(struct soc_camera_device );
	119	int (start_capture)(struct soc_camera_device );
	120	int (stop_capture)(struct soc_camera_device );
ad5f2e85 GL	121	int (set_fmt_cap)(struct soc_camera_device , __u32,
ad5f2e85 GL	122	struct v4l2_rect *);
e55222ef	123	int (try_fmt_cap)(struct soc_camera_device , struct v4l2_format *);
ad5f2e85 GL	124	unsigned long (query_bus_param)(struct soc_camera_device );
ad5f2e85 GL	125	int (set_bus_param)(struct soc_camera_device , unsigned long);
e55222ef GL	126	int (get_chip_id)(struct soc_camera_device ,
	127	struct v4l2_chip_ident *);
	128	#ifdef CONFIG_VIDEO_ADV_DEBUG
	129	int (get_register)(struct soc_camera_device , struct v4l2_register *);
	130	int (set_register)(struct soc_camera_device , struct v4l2_register *);
	131	#endif
e55222ef GL	132	int (get_control)(struct soc_camera_device , struct v4l2_control *);
	133	int (set_control)(struct soc_camera_device , struct v4l2_control *);
	134	const struct v4l2_queryctrl *controls;
	135	int num_controls;
e55222ef GL	136	};
	137
	138	static inline struct v4l2_queryctrl const *soc_camera_find_qctrl(
	139	struct soc_camera_ops *ops, int id)
	140	{
	141	int i;
	142
	143	for (i = 0; i < ops->num_controls; i++)
	144	if (ops->controls[i].id == id)
	145	return &ops->controls[i];
	146
	147	return NULL;
	148	}
	149
ad5f2e85 GL	150	#define SOCAM_MASTER (1 << 0)
	151	#define SOCAM_SLAVE (1 << 1)
	152	#define SOCAM_HSYNC_ACTIVE_HIGH (1 << 2)
	153	#define SOCAM_HSYNC_ACTIVE_LOW (1 << 3)
	154	#define SOCAM_VSYNC_ACTIVE_HIGH (1 << 4)
	155	#define SOCAM_VSYNC_ACTIVE_LOW (1 << 5)
	156	#define SOCAM_DATAWIDTH_8 (1 << 6)
	157	#define SOCAM_DATAWIDTH_9 (1 << 7)
	158	#define SOCAM_DATAWIDTH_10 (1 << 8)
	159	#define SOCAM_PCLK_SAMPLE_RISING (1 << 9)
	160	#define SOCAM_PCLK_SAMPLE_FALLING (1 << 10)
	161
	162	#define SOCAM_DATAWIDTH_MASK (SOCAM_DATAWIDTH_8 \| SOCAM_DATAWIDTH_9 \| \
	163	SOCAM_DATAWIDTH_10)
	164
	165	static inline unsigned long soc_camera_bus_param_compatible(
	166	unsigned long camera_flags, unsigned long bus_flags)
	167	{
	168	unsigned long common_flags, hsync, vsync, pclk;
	169
	170	common_flags = camera_flags & bus_flags;
	171
	172	hsync = common_flags & (SOCAM_HSYNC_ACTIVE_HIGH \| SOCAM_HSYNC_ACTIVE_LOW);
	173	vsync = common_flags & (SOCAM_VSYNC_ACTIVE_HIGH \| SOCAM_VSYNC_ACTIVE_LOW);
	174	pclk = common_flags & (SOCAM_PCLK_SAMPLE_RISING \| SOCAM_PCLK_SAMPLE_FALLING);
	175
	176	return (!hsync \|\| !vsync \|\| !pclk) ? 0 : common_flags;
	177	}
e55222ef GL	178
e55222ef GL	179	#endif