include/exynos_v4l2.h

   1 /*
   2  * Copyright (C) 2011 The Android Open Source Project
   3  *
   4  * Licensed under the Apache License, Version 2.0 (the "License");
   5  * you may not use this file except in compliance with the License.
   6  * You may obtain a copy of the License at
   7  *
   8  *      http://www.apache.org/licenses/LICENSE-2.0
   9  *
  10  * Unless required by applicable law or agreed to in writing, software
  11  * distributed under the License is distributed on an "AS IS" BASIS,
  12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  13  * See the License for the specific language governing permissions and
  14  * limitations under the License.
  15  */
  16
  17 /*!
  18  * \file      exynos_v4l2.h
  19  * \brief     header file for libv4l2
  20  * \author    Jinsung Yang (jsgood.yang@samsung.com)
  21  * \date      2011/12/15
  22  *
  23  * <b>Revision History: </b>
  24  * - 2011/12/15 : Jinsung Yang (jsgood.yang@samsung.com) \n
  25  *   Initial version
  26  *
  27  */
  28
  29 /*!
  30  * \defgroup exynos_v4l2
  31  * \brief API for v4l2
  32  * \addtogroup Exynos
  33  */
  34
  35 #ifndef __EXYNOS_LIB_V4L2_H__
  36 #define __EXYNOS_LIB_V4L2_H__
  37
  38 #ifdef __cplusplus
  39 extern "C" {
  40 #endif
  41
  42 /* V4L2 */
  43 #include <stdbool.h>
  44 #include "videodev2.h" /* vendor specific videodev2.h */
  45 #include "videodev2_exynos_media.h"
  46
  47 /*! \ingroup exynos_v4l2 */
  48 int exynos_v4l2_open(const char *filename, int oflag, ...);
  49 /*! \ingroup exynos_v4l2 */
  50 int exynos_v4l2_open_devname(const char *devname, int oflag, ...);
  51 /*! \ingroup exynos_v4l2 */
  52 int exynos_v4l2_close(int fd);
  53 /*! \ingroup exynos_v4l2 */
  54 bool exynos_v4l2_enuminput(int fd, int index, char *input_name_buf);
  55 /*! \ingroup exynos_v4l2 */
  56 int exynos_v4l2_s_input(int fd, int index);
  57 /*! \ingroup exynos_v4l2 */
  58 bool exynos_v4l2_querycap(int fd, unsigned int need_caps);
  59 /*! \ingroup exynos_v4l2 */
  60 bool exynos_v4l2_enum_fmt(int fd, enum v4l2_buf_type type, unsigned int fmt);
  61 /*! \ingroup exynos_v4l2 */
  62 int exynos_v4l2_g_fmt(int fd, struct v4l2_format *fmt);
  63 /*! \ingroup exynos_v4l2 */
  64 int exynos_v4l2_s_fmt(int fd, struct v4l2_format *fmt);
  65 /*! \ingroup exynos_v4l2 */
  66 int exynos_v4l2_try_fmt(int fd, struct v4l2_format *fmt);
  67 /*! \ingroup exynos_v4l2 */
  68 int exynos_v4l2_reqbufs(int fd, struct v4l2_requestbuffers *req);
  69 /*! \ingroup exynos_v4l2 */
  70 int exynos_v4l2_querybuf(int fd, struct v4l2_buffer *buf);
  71 /*! \ingroup exynos_v4l2 */
  72 int exynos_v4l2_qbuf(int fd, struct v4l2_buffer *buf);
  73 /*! \ingroup exynos_v4l2 */
  74 int exynos_v4l2_dqbuf(int fd, struct v4l2_buffer *buf);
  75 /*! \ingroup exynos_v4l2 */
  76 int exynos_v4l2_streamon(int fd, enum v4l2_buf_type type);
  77 /*! \ingroup exynos_v4l2 */
  78 int exynos_v4l2_streamoff(int fd, enum v4l2_buf_type type);
  79 /*! \ingroup exynos_v4l2 */
  80 int exynos_v4l2_cropcap(int fd, struct v4l2_cropcap *crop);
  81 /*! \ingroup exynos_v4l2 */
  82 int exynos_v4l2_g_crop(int fd, struct v4l2_crop *crop);
  83 /*! \ingroup exynos_v4l2 */
  84 int exynos_v4l2_s_crop(int fd, struct v4l2_crop *crop);
  85 /*! \ingroup exynos_v4l2 */
  86 int exynos_v4l2_g_ctrl(int fd, unsigned int id, int *value);
  87 /*! \ingroup exynos_v4l2 */
  88 int exynos_v4l2_s_ctrl(int fd, unsigned int id, int value);
  89 /*! \ingroup exynos_v4l2 */
  90 int exynos_v4l2_g_parm(int fd, struct v4l2_streamparm *streamparm);
  91 /*! \ingroup exynos_v4l2 */
  92 int exynos_v4l2_s_parm(int fd, struct v4l2_streamparm *streamparm);
  93 /*! \ingroup exynos_v4l2 */
  94 int exynos_v4l2_g_ext_ctrl(int fd, struct v4l2_ext_controls *ctrl);
  95 /*! \ingroup exynos_v4l2 */
  96 int exynos_v4l2_s_ext_ctrl(int fd, struct v4l2_ext_controls *ctrl);
  97
  98 /* V4L2_SUBDEV */
  99 #include <v4l2-subdev.h>
 100
 101 /*! \ingroup exynos_v4l2 */
 102 int exynos_subdev_open(const char *filename, int oflag, ...);
 103 /*! \ingroup exynos_v4l2 */
 104 int exynos_subdev_get_node_num(const char *devname, int oflag, ...);
 105 /*! \ingroup exynos_v4l2 */
 106 int exynos_subdev_open_devname(const char *devname, int oflag, ...);
 107 /*! \ingroup exynos_v4l2 */
 108 int exynos_subdev_close(int fd);
 109 /*! \ingroup exynos_v4l2 */
 110 int exynos_subdev_enum_frame_size(int fd, struct v4l2_subdev_frame_size_enum *frame_size_enum);
 111 /*! \ingroup exynos_v4l2 */
 112 int exynos_subdev_g_fmt(int fd, struct v4l2_subdev_format *fmt);
 113 /*! \ingroup exynos_v4l2 */
 114 int exynos_subdev_s_fmt(int fd, struct v4l2_subdev_format *fmt);
 115 /*! \ingroup exynos_v4l2 */
 116 int exynos_subdev_g_crop(int fd, struct v4l2_subdev_crop *crop);
 117 /*! \ingroup exynos_v4l2 */
 118 int exynos_subdev_s_crop(int fd, struct v4l2_subdev_crop *crop);
 119 /*! \ingroup exynos_v4l2 */
 120 int exynos_subdev_enum_frame_interval(int fd, struct v4l2_subdev_frame_interval_enum *frame_internval_enum);
 121 /*! \ingroup exynos_v4l2 */
 122 int exynos_subdev_g_frame_interval(int fd, struct v4l2_subdev_frame_interval *frame_internval_enum);
 123 /*! \ingroup exynos_v4l2 */
 124 int exynos_subdev_s_frame_interval(int fd, struct v4l2_subdev_frame_interval *frame_internval_enum);
 125 /*! \ingroup exynos_v4l2 */
 126 int exynos_subdev_enum_mbus_code(int fd, struct v4l2_subdev_mbus_code_enum *mbus_code_enum);
 127
 128 /* MEDIA CONTORLLER */
 129 #include <media.h>
 130
 131 /*! media_link
 132  * \ingroup exynos_v4l2
 133  */
 134 struct media_link {
 135     struct media_pad *source;
 136     struct media_pad *sink;
 137     struct media_link *twin;
 138     __u32 flags;
 139     __u32 padding[3];
 140 };
 141
 142 /*! media_link
 143  * \ingroup exynos_v4l2
 144  */
 145 struct media_pad {
 146     struct media_entity *entity;
 147     __u32 index;
 148     __u32 flags;
 149     __u32 padding[3];
 150 };
 151
 152 /*! media_link
 153  * \ingroup exynos_v4l2
 154  */
 155 struct media_entity {
 156     struct media_device *media;
 157     struct media_entity_desc info;
 158     struct media_pad *pads;
 159     struct media_link *links;
 160     unsigned int max_links;
 161     unsigned int num_links;
 162
 163     char devname[32];
 164     int fd;
 165     __u32 padding[6];
 166 };
 167
 168 /*! media_link
 169  * \ingroup exynos_v4l2
 170  */
 171 struct media_device {
 172     int fd;
 173     struct media_entity *entities;
 174     unsigned int entities_count;
 175     void (*debug_handler)(void *, ...);
 176     void *debug_priv;
 177     __u32 padding[6];
 178 };
 179
 180 /*! \ingroup exynos_v4l2 */
 181 struct media_device *exynos_media_open(const char *filename);
 182 /*! \ingroup exynos_v4l2 */
 183 void exynos_media_close(struct media_device *media);
 184 /*! \ingroup exynos_v4l2 */
 185 struct media_pad *exynos_media_entity_remote_source(struct media_pad *pad);
 186 /*! \ingroup exynos_v4l2 */
 187 struct media_entity *exynos_media_get_entity_by_name(struct media_device *media, const char *name, size_t length);
 188 /*! \ingroup exynos_v4l2 */
 189 struct media_entity *exynos_media_get_entity_by_id(struct media_device *media, __u32 id);
 190 /*! \ingroup exynos_v4l2 */
 191 int exynos_media_setup_link(struct media_device *media, struct media_pad *source, struct media_pad *sink, __u32 flags);
 192 /*! \ingroup exynos_v4l2 */
 193 int exynos_media_reset_links(struct media_device *media);
 194 /*! \ingroup exynos_v4l2 */
 195 struct media_pad *exynos_media_parse_pad(struct media_device *media, const char *p, char **endp);
 196 /*! \ingroup exynos_v4l2 */
 197 struct media_link *exynos_media_parse_link(struct media_device *media, const char *p, char **endp);
 198 /*! \ingroup exynos_v4l2 */
 199 int exynos_media_parse_setup_link(struct media_device *media, const char *p, char **endp);
 200 /*! \ingroup exynos_v4l2 */
 201 int exynos_media_parse_setup_links(struct media_device *media, const char *p);
 202
 203 #ifdef __cplusplus
 204 }
 205 #endif
 206
 207 #endif /* __EXYNOS_LIB_V4L2_H__ */