linux/drivers/media/v4l2-core/v4l2-subdev.c
<<
>>
Prefs
   1/*
   2 * V4L2 sub-device
   3 *
   4 * Copyright (C) 2010 Nokia Corporation
   5 *
   6 * Contact: Laurent Pinchart <laurent.pinchart@ideasonboard.com>
   7 *          Sakari Ailus <sakari.ailus@iki.fi>
   8 *
   9 * This program is free software; you can redistribute it and/or modify
  10 * it under the terms of the GNU General Public License version 2 as
  11 * published by the Free Software Foundation.
  12 *
  13 * This program is distributed in the hope that it will be useful,
  14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
  15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  16 * GNU General Public License for more details.
  17 *
  18 * You should have received a copy of the GNU General Public License
  19 * along with this program; if not, write to the Free Software
  20 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  21 */
  22
  23#include <linux/ioctl.h>
  24#include <linux/slab.h>
  25#include <linux/types.h>
  26#include <linux/videodev2.h>
  27#include <linux/export.h>
  28
  29#include <media/v4l2-ctrls.h>
  30#include <media/v4l2-device.h>
  31#include <media/v4l2-ioctl.h>
  32#include <media/v4l2-fh.h>
  33#include <media/v4l2-event.h>
  34
  35static int subdev_fh_init(struct v4l2_subdev_fh *fh, struct v4l2_subdev *sd)
  36{
  37#if defined(CONFIG_VIDEO_V4L2_SUBDEV_API)
  38        if (sd->entity.num_pads) {
  39                fh->pad = v4l2_subdev_alloc_pad_config(sd);
  40                if (fh->pad == NULL)
  41                        return -ENOMEM;
  42        }
  43#endif
  44        return 0;
  45}
  46
  47static void subdev_fh_free(struct v4l2_subdev_fh *fh)
  48{
  49#if defined(CONFIG_VIDEO_V4L2_SUBDEV_API)
  50        v4l2_subdev_free_pad_config(fh->pad);
  51        fh->pad = NULL;
  52#endif
  53}
  54
  55static int subdev_open(struct file *file)
  56{
  57        struct video_device *vdev = video_devdata(file);
  58        struct v4l2_subdev *sd = vdev_to_v4l2_subdev(vdev);
  59        struct v4l2_subdev_fh *subdev_fh;
  60#if defined(CONFIG_MEDIA_CONTROLLER)
  61        struct media_entity *entity = NULL;
  62#endif
  63        int ret;
  64
  65        subdev_fh = kzalloc(sizeof(*subdev_fh), GFP_KERNEL);
  66        if (subdev_fh == NULL)
  67                return -ENOMEM;
  68
  69        ret = subdev_fh_init(subdev_fh, sd);
  70        if (ret) {
  71                kfree(subdev_fh);
  72                return ret;
  73        }
  74
  75        v4l2_fh_init(&subdev_fh->vfh, vdev);
  76        v4l2_fh_add(&subdev_fh->vfh);
  77        file->private_data = &subdev_fh->vfh;
  78#if defined(CONFIG_MEDIA_CONTROLLER)
  79        if (sd->v4l2_dev->mdev) {
  80                entity = media_entity_get(&sd->entity);
  81                if (!entity) {
  82                        ret = -EBUSY;
  83                        goto err;
  84                }
  85        }
  86#endif
  87
  88        if (sd->internal_ops && sd->internal_ops->open) {
  89                ret = sd->internal_ops->open(sd, subdev_fh);
  90                if (ret < 0)
  91                        goto err;
  92        }
  93
  94        return 0;
  95
  96err:
  97#if defined(CONFIG_MEDIA_CONTROLLER)
  98        media_entity_put(entity);
  99#endif
 100        v4l2_fh_del(&subdev_fh->vfh);
 101        v4l2_fh_exit(&subdev_fh->vfh);
 102        subdev_fh_free(subdev_fh);
 103        kfree(subdev_fh);
 104
 105        return ret;
 106}
 107
 108static int subdev_close(struct file *file)
 109{
 110        struct video_device *vdev = video_devdata(file);
 111        struct v4l2_subdev *sd = vdev_to_v4l2_subdev(vdev);
 112        struct v4l2_fh *vfh = file->private_data;
 113        struct v4l2_subdev_fh *subdev_fh = to_v4l2_subdev_fh(vfh);
 114
 115        if (sd->internal_ops && sd->internal_ops->close)
 116                sd->internal_ops->close(sd, subdev_fh);
 117#if defined(CONFIG_MEDIA_CONTROLLER)
 118        if (sd->v4l2_dev->mdev)
 119                media_entity_put(&sd->entity);
 120#endif
 121        v4l2_fh_del(vfh);
 122        v4l2_fh_exit(vfh);
 123        subdev_fh_free(subdev_fh);
 124        kfree(subdev_fh);
 125        file->private_data = NULL;
 126
 127        return 0;
 128}
 129
 130#if defined(CONFIG_VIDEO_V4L2_SUBDEV_API)
 131static int check_format(struct v4l2_subdev *sd,
 132                        struct v4l2_subdev_format *format)
 133{
 134        if (format->which != V4L2_SUBDEV_FORMAT_TRY &&
 135            format->which != V4L2_SUBDEV_FORMAT_ACTIVE)
 136                return -EINVAL;
 137
 138        if (format->pad >= sd->entity.num_pads)
 139                return -EINVAL;
 140
 141        return 0;
 142}
 143
 144static int check_crop(struct v4l2_subdev *sd, struct v4l2_subdev_crop *crop)
 145{
 146        if (crop->which != V4L2_SUBDEV_FORMAT_TRY &&
 147            crop->which != V4L2_SUBDEV_FORMAT_ACTIVE)
 148                return -EINVAL;
 149
 150        if (crop->pad >= sd->entity.num_pads)
 151                return -EINVAL;
 152
 153        return 0;
 154}
 155
 156static int check_selection(struct v4l2_subdev *sd,
 157                           struct v4l2_subdev_selection *sel)
 158{
 159        if (sel->which != V4L2_SUBDEV_FORMAT_TRY &&
 160            sel->which != V4L2_SUBDEV_FORMAT_ACTIVE)
 161                return -EINVAL;
 162
 163        if (sel->pad >= sd->entity.num_pads)
 164                return -EINVAL;
 165
 166        return 0;
 167}
 168
 169static int check_edid(struct v4l2_subdev *sd, struct v4l2_subdev_edid *edid)
 170{
 171        if (edid->pad >= sd->entity.num_pads)
 172                return -EINVAL;
 173
 174        if (edid->blocks && edid->edid == NULL)
 175                return -EINVAL;
 176
 177        return 0;
 178}
 179#endif
 180
 181static long subdev_do_ioctl(struct file *file, unsigned int cmd, void *arg)
 182{
 183        struct video_device *vdev = video_devdata(file);
 184        struct v4l2_subdev *sd = vdev_to_v4l2_subdev(vdev);
 185        struct v4l2_fh *vfh = file->private_data;
 186#if defined(CONFIG_VIDEO_V4L2_SUBDEV_API)
 187        struct v4l2_subdev_fh *subdev_fh = to_v4l2_subdev_fh(vfh);
 188        int rval;
 189#endif
 190
 191        switch (cmd) {
 192        case VIDIOC_QUERYCTRL:
 193                return v4l2_queryctrl(vfh->ctrl_handler, arg);
 194
 195        case VIDIOC_QUERY_EXT_CTRL:
 196                return v4l2_query_ext_ctrl(vfh->ctrl_handler, arg);
 197
 198        case VIDIOC_QUERYMENU:
 199                return v4l2_querymenu(vfh->ctrl_handler, arg);
 200
 201        case VIDIOC_G_CTRL:
 202                return v4l2_g_ctrl(vfh->ctrl_handler, arg);
 203
 204        case VIDIOC_S_CTRL:
 205                return v4l2_s_ctrl(vfh, vfh->ctrl_handler, arg);
 206
 207        case VIDIOC_G_EXT_CTRLS:
 208                return v4l2_g_ext_ctrls(vfh->ctrl_handler, arg);
 209
 210        case VIDIOC_S_EXT_CTRLS:
 211                return v4l2_s_ext_ctrls(vfh, vfh->ctrl_handler, arg);
 212
 213        case VIDIOC_TRY_EXT_CTRLS:
 214                return v4l2_try_ext_ctrls(vfh->ctrl_handler, arg);
 215
 216        case VIDIOC_DQEVENT:
 217                if (!(sd->flags & V4L2_SUBDEV_FL_HAS_EVENTS))
 218                        return -ENOIOCTLCMD;
 219
 220                return v4l2_event_dequeue(vfh, arg, file->f_flags & O_NONBLOCK);
 221
 222        case VIDIOC_SUBSCRIBE_EVENT:
 223                return v4l2_subdev_call(sd, core, subscribe_event, vfh, arg);
 224
 225        case VIDIOC_UNSUBSCRIBE_EVENT:
 226                return v4l2_subdev_call(sd, core, unsubscribe_event, vfh, arg);
 227
 228#ifdef CONFIG_VIDEO_ADV_DEBUG
 229        case VIDIOC_DBG_G_REGISTER:
 230        {
 231                struct v4l2_dbg_register *p = arg;
 232
 233                if (!capable(CAP_SYS_ADMIN))
 234                        return -EPERM;
 235                return v4l2_subdev_call(sd, core, g_register, p);
 236        }
 237        case VIDIOC_DBG_S_REGISTER:
 238        {
 239                struct v4l2_dbg_register *p = arg;
 240
 241                if (!capable(CAP_SYS_ADMIN))
 242                        return -EPERM;
 243                return v4l2_subdev_call(sd, core, s_register, p);
 244        }
 245#endif
 246
 247        case VIDIOC_LOG_STATUS: {
 248                int ret;
 249
 250                pr_info("%s: =================  START STATUS  =================\n",
 251                        sd->name);
 252                ret = v4l2_subdev_call(sd, core, log_status);
 253                pr_info("%s: ==================  END STATUS  ==================\n",
 254                        sd->name);
 255                return ret;
 256        }
 257
 258#if defined(CONFIG_VIDEO_V4L2_SUBDEV_API)
 259        case VIDIOC_SUBDEV_G_FMT: {
 260                struct v4l2_subdev_format *format = arg;
 261
 262                rval = check_format(sd, format);
 263                if (rval)
 264                        return rval;
 265
 266                return v4l2_subdev_call(sd, pad, get_fmt, subdev_fh->pad, format);
 267        }
 268
 269        case VIDIOC_SUBDEV_S_FMT: {
 270                struct v4l2_subdev_format *format = arg;
 271
 272                rval = check_format(sd, format);
 273                if (rval)
 274                        return rval;
 275
 276                return v4l2_subdev_call(sd, pad, set_fmt, subdev_fh->pad, format);
 277        }
 278
 279        case VIDIOC_SUBDEV_G_CROP: {
 280                struct v4l2_subdev_crop *crop = arg;
 281                struct v4l2_subdev_selection sel;
 282
 283                rval = check_crop(sd, crop);
 284                if (rval)
 285                        return rval;
 286
 287                memset(&sel, 0, sizeof(sel));
 288                sel.which = crop->which;
 289                sel.pad = crop->pad;
 290                sel.target = V4L2_SEL_TGT_CROP;
 291
 292                rval = v4l2_subdev_call(
 293                        sd, pad, get_selection, subdev_fh->pad, &sel);
 294
 295                crop->rect = sel.r;
 296
 297                return rval;
 298        }
 299
 300        case VIDIOC_SUBDEV_S_CROP: {
 301                struct v4l2_subdev_crop *crop = arg;
 302                struct v4l2_subdev_selection sel;
 303
 304                rval = check_crop(sd, crop);
 305                if (rval)
 306                        return rval;
 307
 308                memset(&sel, 0, sizeof(sel));
 309                sel.which = crop->which;
 310                sel.pad = crop->pad;
 311                sel.target = V4L2_SEL_TGT_CROP;
 312                sel.r = crop->rect;
 313
 314                rval = v4l2_subdev_call(
 315                        sd, pad, set_selection, subdev_fh->pad, &sel);
 316
 317                crop->rect = sel.r;
 318
 319                return rval;
 320        }
 321
 322        case VIDIOC_SUBDEV_ENUM_MBUS_CODE: {
 323                struct v4l2_subdev_mbus_code_enum *code = arg;
 324
 325                if (code->which != V4L2_SUBDEV_FORMAT_TRY &&
 326                    code->which != V4L2_SUBDEV_FORMAT_ACTIVE)
 327                        return -EINVAL;
 328
 329                if (code->pad >= sd->entity.num_pads)
 330                        return -EINVAL;
 331
 332                return v4l2_subdev_call(sd, pad, enum_mbus_code, subdev_fh->pad,
 333                                        code);
 334        }
 335
 336        case VIDIOC_SUBDEV_ENUM_FRAME_SIZE: {
 337                struct v4l2_subdev_frame_size_enum *fse = arg;
 338
 339                if (fse->which != V4L2_SUBDEV_FORMAT_TRY &&
 340                    fse->which != V4L2_SUBDEV_FORMAT_ACTIVE)
 341                        return -EINVAL;
 342
 343                if (fse->pad >= sd->entity.num_pads)
 344                        return -EINVAL;
 345
 346                return v4l2_subdev_call(sd, pad, enum_frame_size, subdev_fh->pad,
 347                                        fse);
 348        }
 349
 350        case VIDIOC_SUBDEV_G_FRAME_INTERVAL: {
 351                struct v4l2_subdev_frame_interval *fi = arg;
 352
 353                if (fi->pad >= sd->entity.num_pads)
 354                        return -EINVAL;
 355
 356                return v4l2_subdev_call(sd, video, g_frame_interval, arg);
 357        }
 358
 359        case VIDIOC_SUBDEV_S_FRAME_INTERVAL: {
 360                struct v4l2_subdev_frame_interval *fi = arg;
 361
 362                if (fi->pad >= sd->entity.num_pads)
 363                        return -EINVAL;
 364
 365                return v4l2_subdev_call(sd, video, s_frame_interval, arg);
 366        }
 367
 368        case VIDIOC_SUBDEV_ENUM_FRAME_INTERVAL: {
 369                struct v4l2_subdev_frame_interval_enum *fie = arg;
 370
 371                if (fie->which != V4L2_SUBDEV_FORMAT_TRY &&
 372                    fie->which != V4L2_SUBDEV_FORMAT_ACTIVE)
 373                        return -EINVAL;
 374
 375                if (fie->pad >= sd->entity.num_pads)
 376                        return -EINVAL;
 377
 378                return v4l2_subdev_call(sd, pad, enum_frame_interval, subdev_fh->pad,
 379                                        fie);
 380        }
 381
 382        case VIDIOC_SUBDEV_G_SELECTION: {
 383                struct v4l2_subdev_selection *sel = arg;
 384
 385                rval = check_selection(sd, sel);
 386                if (rval)
 387                        return rval;
 388
 389                return v4l2_subdev_call(
 390                        sd, pad, get_selection, subdev_fh->pad, sel);
 391        }
 392
 393        case VIDIOC_SUBDEV_S_SELECTION: {
 394                struct v4l2_subdev_selection *sel = arg;
 395
 396                rval = check_selection(sd, sel);
 397                if (rval)
 398                        return rval;
 399
 400                return v4l2_subdev_call(
 401                        sd, pad, set_selection, subdev_fh->pad, sel);
 402        }
 403
 404        case VIDIOC_G_EDID: {
 405                struct v4l2_subdev_edid *edid = arg;
 406
 407                rval = check_edid(sd, edid);
 408                if (rval)
 409                        return rval;
 410
 411                return v4l2_subdev_call(sd, pad, get_edid, edid);
 412        }
 413
 414        case VIDIOC_S_EDID: {
 415                struct v4l2_subdev_edid *edid = arg;
 416
 417                rval = check_edid(sd, edid);
 418                if (rval)
 419                        return rval;
 420
 421                return v4l2_subdev_call(sd, pad, set_edid, edid);
 422        }
 423
 424        case VIDIOC_SUBDEV_DV_TIMINGS_CAP: {
 425                struct v4l2_dv_timings_cap *cap = arg;
 426
 427                if (cap->pad >= sd->entity.num_pads)
 428                        return -EINVAL;
 429
 430                return v4l2_subdev_call(sd, pad, dv_timings_cap, cap);
 431        }
 432
 433        case VIDIOC_SUBDEV_ENUM_DV_TIMINGS: {
 434                struct v4l2_enum_dv_timings *dvt = arg;
 435
 436                if (dvt->pad >= sd->entity.num_pads)
 437                        return -EINVAL;
 438
 439                return v4l2_subdev_call(sd, pad, enum_dv_timings, dvt);
 440        }
 441
 442        case VIDIOC_SUBDEV_QUERY_DV_TIMINGS:
 443                return v4l2_subdev_call(sd, video, query_dv_timings, arg);
 444
 445        case VIDIOC_SUBDEV_G_DV_TIMINGS:
 446                return v4l2_subdev_call(sd, video, g_dv_timings, arg);
 447
 448        case VIDIOC_SUBDEV_S_DV_TIMINGS:
 449                return v4l2_subdev_call(sd, video, s_dv_timings, arg);
 450#endif
 451        default:
 452                return v4l2_subdev_call(sd, core, ioctl, cmd, arg);
 453        }
 454
 455        return 0;
 456}
 457
 458static long subdev_ioctl(struct file *file, unsigned int cmd,
 459        unsigned long arg)
 460{
 461        return video_usercopy(file, cmd, arg, subdev_do_ioctl);
 462}
 463
 464#ifdef CONFIG_COMPAT
 465static long subdev_compat_ioctl32(struct file *file, unsigned int cmd,
 466        unsigned long arg)
 467{
 468        struct video_device *vdev = video_devdata(file);
 469        struct v4l2_subdev *sd = vdev_to_v4l2_subdev(vdev);
 470
 471        return v4l2_subdev_call(sd, core, compat_ioctl32, cmd, arg);
 472}
 473#endif
 474
 475static unsigned int subdev_poll(struct file *file, poll_table *wait)
 476{
 477        struct video_device *vdev = video_devdata(file);
 478        struct v4l2_subdev *sd = vdev_to_v4l2_subdev(vdev);
 479        struct v4l2_fh *fh = file->private_data;
 480
 481        if (!(sd->flags & V4L2_SUBDEV_FL_HAS_EVENTS))
 482                return POLLERR;
 483
 484        poll_wait(file, &fh->wait, wait);
 485
 486        if (v4l2_event_pending(fh))
 487                return POLLPRI;
 488
 489        return 0;
 490}
 491
 492const struct v4l2_file_operations v4l2_subdev_fops = {
 493        .owner = THIS_MODULE,
 494        .open = subdev_open,
 495        .unlocked_ioctl = subdev_ioctl,
 496#ifdef CONFIG_COMPAT
 497        .compat_ioctl32 = subdev_compat_ioctl32,
 498#endif
 499        .release = subdev_close,
 500        .poll = subdev_poll,
 501};
 502
 503#ifdef CONFIG_MEDIA_CONTROLLER
 504int v4l2_subdev_link_validate_default(struct v4l2_subdev *sd,
 505                                      struct media_link *link,
 506                                      struct v4l2_subdev_format *source_fmt,
 507                                      struct v4l2_subdev_format *sink_fmt)
 508{
 509        /* The width, height and code must match. */
 510        if (source_fmt->format.width != sink_fmt->format.width
 511            || source_fmt->format.height != sink_fmt->format.height
 512            || source_fmt->format.code != sink_fmt->format.code)
 513                return -EPIPE;
 514
 515        /* The field order must match, or the sink field order must be NONE
 516         * to support interlaced hardware connected to bridges that support
 517         * progressive formats only.
 518         */
 519        if (source_fmt->format.field != sink_fmt->format.field &&
 520            sink_fmt->format.field != V4L2_FIELD_NONE)
 521                return -EPIPE;
 522
 523        return 0;
 524}
 525EXPORT_SYMBOL_GPL(v4l2_subdev_link_validate_default);
 526
 527static int
 528v4l2_subdev_link_validate_get_format(struct media_pad *pad,
 529                                     struct v4l2_subdev_format *fmt)
 530{
 531        if (is_media_entity_v4l2_subdev(pad->entity)) {
 532                struct v4l2_subdev *sd =
 533                        media_entity_to_v4l2_subdev(pad->entity);
 534
 535                fmt->which = V4L2_SUBDEV_FORMAT_ACTIVE;
 536                fmt->pad = pad->index;
 537                return v4l2_subdev_call(sd, pad, get_fmt, NULL, fmt);
 538        }
 539
 540        WARN(pad->entity->function != MEDIA_ENT_F_IO_V4L,
 541             "Driver bug! Wrong media entity type 0x%08x, entity %s\n",
 542             pad->entity->function, pad->entity->name);
 543
 544        return -EINVAL;
 545}
 546
 547int v4l2_subdev_link_validate(struct media_link *link)
 548{
 549        struct v4l2_subdev *sink;
 550        struct v4l2_subdev_format sink_fmt, source_fmt;
 551        int rval;
 552
 553        rval = v4l2_subdev_link_validate_get_format(
 554                link->source, &source_fmt);
 555        if (rval < 0)
 556                return 0;
 557
 558        rval = v4l2_subdev_link_validate_get_format(
 559                link->sink, &sink_fmt);
 560        if (rval < 0)
 561                return 0;
 562
 563        sink = media_entity_to_v4l2_subdev(link->sink->entity);
 564
 565        rval = v4l2_subdev_call(sink, pad, link_validate, link,
 566                                &source_fmt, &sink_fmt);
 567        if (rval != -ENOIOCTLCMD)
 568                return rval;
 569
 570        return v4l2_subdev_link_validate_default(
 571                sink, link, &source_fmt, &sink_fmt);
 572}
 573EXPORT_SYMBOL_GPL(v4l2_subdev_link_validate);
 574
 575struct v4l2_subdev_pad_config *
 576v4l2_subdev_alloc_pad_config(struct v4l2_subdev *sd)
 577{
 578        struct v4l2_subdev_pad_config *cfg;
 579        int ret;
 580
 581        if (!sd->entity.num_pads)
 582                return NULL;
 583
 584        cfg = kcalloc(sd->entity.num_pads, sizeof(*cfg), GFP_KERNEL);
 585        if (!cfg)
 586                return NULL;
 587
 588        ret = v4l2_subdev_call(sd, pad, init_cfg, cfg);
 589        if (ret < 0 && ret != -ENOIOCTLCMD) {
 590                kfree(cfg);
 591                return NULL;
 592        }
 593
 594        return cfg;
 595}
 596EXPORT_SYMBOL_GPL(v4l2_subdev_alloc_pad_config);
 597
 598void v4l2_subdev_free_pad_config(struct v4l2_subdev_pad_config *cfg)
 599{
 600        kfree(cfg);
 601}
 602EXPORT_SYMBOL_GPL(v4l2_subdev_free_pad_config);
 603#endif /* CONFIG_MEDIA_CONTROLLER */
 604
 605void v4l2_subdev_init(struct v4l2_subdev *sd, const struct v4l2_subdev_ops *ops)
 606{
 607        INIT_LIST_HEAD(&sd->list);
 608        BUG_ON(!ops);
 609        sd->ops = ops;
 610        sd->v4l2_dev = NULL;
 611        sd->flags = 0;
 612        sd->name[0] = '\0';
 613        sd->grp_id = 0;
 614        sd->dev_priv = NULL;
 615        sd->host_priv = NULL;
 616#if defined(CONFIG_MEDIA_CONTROLLER)
 617        sd->entity.name = sd->name;
 618        sd->entity.obj_type = MEDIA_ENTITY_TYPE_V4L2_SUBDEV;
 619        sd->entity.function = MEDIA_ENT_F_V4L2_SUBDEV_UNKNOWN;
 620#endif
 621}
 622EXPORT_SYMBOL(v4l2_subdev_init);
 623
 624void v4l2_subdev_notify_event(struct v4l2_subdev *sd,
 625                              const struct v4l2_event *ev)
 626{
 627        v4l2_event_queue(sd->devnode, ev);
 628        v4l2_subdev_notify(sd, V4L2_DEVICE_NOTIFY_EVENT, (void *)ev);
 629}
 630EXPORT_SYMBOL_GPL(v4l2_subdev_notify_event);
 631