25c4d74ea6
Pixel format requested by the user is not necessarily the same, as what a sensor driver provides. There are situations, when a camera host driver provides the required format, but requires a different format from the sensor. Further, the list of formats, supported by sensors is pretty static and can be pretty good described with a constant list of structures. Whereas decisions, made by camera host drivers to support requested formats can be quite complex, therefore it is better to let the host driver do the work. Signed-off-by: Guennadi Liakhovetski <g.liakhovetski@gmx.de> Signed-off-by: Mauro Carvalho Chehab <mchehab@redhat.com>
188 lines
6.1 KiB
C
188 lines
6.1 KiB
C
/*
|
|
* 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>
|
|
#include <linux/pm.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;
|
|
};
|
|
|
|
struct soc_camera_host {
|
|
struct list_head list;
|
|
struct device dev;
|
|
unsigned char nr; /* Host number */
|
|
void *priv;
|
|
const 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 (*suspend)(struct soc_camera_device *, pm_message_t state);
|
|
int (*resume)(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 *,
|
|
struct soc_camera_device *);
|
|
int (*reqbufs)(struct soc_camera_file *, struct v4l2_requestbuffers *);
|
|
int (*querycap)(struct soc_camera_host *, struct v4l2_capability *);
|
|
int (*set_bus_param)(struct soc_camera_device *, __u32);
|
|
unsigned int (*poll)(struct file *, poll_table *);
|
|
};
|
|
|
|
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;
|
|
/* Optional callbacks to power on or off and reset the sensor */
|
|
int (*power)(struct device *, int);
|
|
int (*reset)(struct device *);
|
|
};
|
|
|
|
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);
|
|
|
|
extern const struct soc_camera_data_format *soc_camera_format_by_fourcc(
|
|
struct soc_camera_device *icd, unsigned int fourcc);
|
|
|
|
struct soc_camera_data_format {
|
|
const 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 (*suspend)(struct soc_camera_device *, pm_message_t state);
|
|
int (*resume)(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_DATAWIDTH_16 (1 << 9)
|
|
#define SOCAM_PCLK_SAMPLE_RISING (1 << 10)
|
|
#define SOCAM_PCLK_SAMPLE_FALLING (1 << 11)
|
|
|
|
#define SOCAM_DATAWIDTH_MASK (SOCAM_DATAWIDTH_8 | SOCAM_DATAWIDTH_9 | \
|
|
SOCAM_DATAWIDTH_10 | SOCAM_DATAWIDTH_16)
|
|
|
|
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
|