Subversion Repositories test_project

/*

 * include/media/v4l2-int-device.h

 *

 * V4L2 internal ioctl interface.

 *

 * Copyright (C) 2007 Nokia Corporation.

 *

 * Contact: Sakari Ailus <sakari.ailus@nokia.com>

 *

 * 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.

 *

 * 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.

 *

 * You should have received a copy of the GNU General Public License

 * along with this program; if not, write to the Free Software

 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA

 * 02110-1301 USA

 */

#ifndef V4L2_INT_DEVICE_H

#define V4L2_INT_DEVICE_H

#include <linux/module.h>

#include <media/v4l2-common.h>

#define V4L2NAMESIZE 32

/*

 *

 * The internal V4L2 device interface core.

 *

 */

enum v4l2_int_type {

        v4l2_int_type_master = 1,

        v4l2_int_type_slave

};

struct v4l2_int_device;

struct v4l2_int_master {

        int (*attach)(struct v4l2_int_device *master,

                      struct v4l2_int_device *slave);

        void (*detach)(struct v4l2_int_device *master);

};

typedef int (v4l2_int_ioctl_func)(struct v4l2_int_device *);

typedef int (v4l2_int_ioctl_func_0)(struct v4l2_int_device *);

typedef int (v4l2_int_ioctl_func_1)(struct v4l2_int_device *, void *);

struct v4l2_int_ioctl_desc {

        int num;

        v4l2_int_ioctl_func *func;

};

struct v4l2_int_slave {

        /* Don't touch master. */

        struct v4l2_int_device *master;

        char attach_to[V4L2NAMESIZE];

        int num_ioctls;

        struct v4l2_int_ioctl_desc *ioctls;

};

struct v4l2_int_device {

        /* Don't touch head. */

        struct list_head head;

        struct module *module;

        char name[V4L2NAMESIZE];

        enum v4l2_int_type type;

        union {

                struct v4l2_int_master *master;

                struct v4l2_int_slave *slave;

        } u;

        void *priv;

};

int v4l2_int_device_register(struct v4l2_int_device *d);

void v4l2_int_device_unregister(struct v4l2_int_device *d);

int v4l2_int_ioctl_0(struct v4l2_int_device *d, int cmd);

int v4l2_int_ioctl_1(struct v4l2_int_device *d, int cmd, void *arg);

/*

 *

 * Types and definitions for IOCTL commands.

 *

 */

/* Slave interface type. */

enum v4l2_if_type {

        /*

         * Parallel 8-, 10- or 12-bit interface, used by for example

         * on certain image sensors.

         */

        V4L2_IF_TYPE_BT656,

};

enum v4l2_if_type_bt656_mode {

        /*

         * Modes without Bt synchronisation codes. Separate

         * synchronisation signal lines are used.

         */

        V4L2_IF_TYPE_BT656_MODE_NOBT_8BIT,

        V4L2_IF_TYPE_BT656_MODE_NOBT_10BIT,

        V4L2_IF_TYPE_BT656_MODE_NOBT_12BIT,

        /*

         * Use Bt synchronisation codes. The vertical and horizontal

         * synchronisation is done based on synchronisation codes.

         */

        V4L2_IF_TYPE_BT656_MODE_BT_8BIT,

        V4L2_IF_TYPE_BT656_MODE_BT_10BIT,

};

struct v4l2_if_type_bt656 {

        /*

         * 0: Frame begins when vsync is high.

         * 1: Frame begins when vsync changes from low to high.

         */

        unsigned frame_start_on_rising_vs:1;

        /* Use Bt synchronisation codes for sync correction. */

        unsigned bt_sync_correct:1;

        /* Swap every two adjacent image data elements. */

        unsigned swap:1;

        /* Inverted latch clock polarity from slave. */

        unsigned latch_clk_inv:1;

        /* Hs polarity. 0 is active high, 1 active low. */

        unsigned nobt_hs_inv:1;

        /* Vs polarity. 0 is active high, 1 active low. */

        unsigned nobt_vs_inv:1;

        enum v4l2_if_type_bt656_mode mode;

        /* Minimum accepted bus clock for slave (in Hz). */

        u32 clock_min;

        /* Maximum accepted bus clock for slave. */

        u32 clock_max;

        /*

         * Current wish of the slave. May only change in response to

         * ioctls that affect image capture.

         */

        u32 clock_curr;

};

struct v4l2_ifparm {

        enum v4l2_if_type if_type;

        union {

                struct v4l2_if_type_bt656 bt656;

        } u;

};

/* IOCTL command numbers. */

enum v4l2_int_ioctl_num {

        /*

         *

         * "Proper" V4L ioctls, as in struct video_device.

         *

         */

        vidioc_int_enum_fmt_cap_num = 1,

        vidioc_int_g_fmt_cap_num,

        vidioc_int_s_fmt_cap_num,

        vidioc_int_try_fmt_cap_num,

        vidioc_int_queryctrl_num,

        vidioc_int_g_ctrl_num,

        vidioc_int_s_ctrl_num,

        vidioc_int_g_parm_num,

        vidioc_int_s_parm_num,

        /*

         *

         * Strictly internal ioctls.

         *

         */

        /* Initialise the device when slave attaches to the master. */

        vidioc_int_dev_init_num = 1000,

        /* Delinitialise the device at slave detach. */

        vidioc_int_dev_exit_num,

        /* Set device power state: 0 is off, non-zero is on. */

        vidioc_int_s_power_num,

        /* Get slave interface parameters. */

        vidioc_int_g_ifparm_num,

        /* Does the slave need to be reset after VIDIOC_DQBUF? */

        vidioc_int_g_needs_reset_num,

        /*

         *

         * VIDIOC_INT_* ioctls.

         *

         */

        /* VIDIOC_INT_RESET */

        vidioc_int_reset_num,

        /* VIDIOC_INT_INIT */

        vidioc_int_init_num,

        /* VIDIOC_INT_G_CHIP_IDENT */

        vidioc_int_g_chip_ident_num,

        /*

         *

         * Start of private ioctls.

         *

         */

        vidioc_int_priv_start_num = 2000,

};

/*

 *

 * IOCTL wrapper functions for better type checking.

 *

 */

#define V4L2_INT_WRAPPER_0(name)                                        \

        static inline int vidioc_int_##name(struct v4l2_int_device *d)  \

        {                                                               \

                return v4l2_int_ioctl_0(d, vidioc_int_##name##_num);    \

        }                                                               \

                                                                        \

        static inline struct v4l2_int_ioctl_desc                        \

        vidioc_int_##name##_cb(int (*func)                              \

                               (struct v4l2_int_device *))              \

        {                                                               \

                struct v4l2_int_ioctl_desc desc;                        \

                                                                        \

                desc.num = vidioc_int_##name##_num;                     \

                desc.func = (v4l2_int_ioctl_func *)func;                \

                                                                        \

                return desc;                                            \

        }

#define V4L2_INT_WRAPPER_1(name, arg_type, asterisk)                    \

        static inline int vidioc_int_##name(struct v4l2_int_device *d,  \

                                            arg_type asterisk arg)      \

        {                                                               \

                return v4l2_int_ioctl_1(d, vidioc_int_##name##_num,     \

                                        (void *)(unsigned long)arg);    \

        }                                                               \

                                                                        \

        static inline struct v4l2_int_ioctl_desc                        \

        vidioc_int_##name##_cb(int (*func)                              \

                               (struct v4l2_int_device *,               \

                                arg_type asterisk))                     \

        {                                                               \

                struct v4l2_int_ioctl_desc desc;                        \

                                                                        \

                desc.num = vidioc_int_##name##_num;                     \

                desc.func = (v4l2_int_ioctl_func *)func;                \

                                                                        \

                return desc;                                            \

        }

V4L2_INT_WRAPPER_1(enum_fmt_cap, struct v4l2_fmtdesc, *);

V4L2_INT_WRAPPER_1(g_fmt_cap, struct v4l2_format, *);

V4L2_INT_WRAPPER_1(s_fmt_cap, struct v4l2_format, *);

V4L2_INT_WRAPPER_1(try_fmt_cap, struct v4l2_format, *);

V4L2_INT_WRAPPER_1(queryctrl, struct v4l2_queryctrl, *);

V4L2_INT_WRAPPER_1(g_ctrl, struct v4l2_control, *);

V4L2_INT_WRAPPER_1(s_ctrl, struct v4l2_control, *);

V4L2_INT_WRAPPER_1(g_parm, struct v4l2_streamparm, *);

V4L2_INT_WRAPPER_1(s_parm, struct v4l2_streamparm, *);

V4L2_INT_WRAPPER_0(dev_init);

V4L2_INT_WRAPPER_0(dev_exit);

V4L2_INT_WRAPPER_1(s_power, int, );

V4L2_INT_WRAPPER_1(g_ifparm, struct v4l2_ifparm, *);

V4L2_INT_WRAPPER_1(g_needs_reset, void, *);

V4L2_INT_WRAPPER_0(reset);

V4L2_INT_WRAPPER_0(init);

V4L2_INT_WRAPPER_1(g_chip_ident, int, *);

#endif