linux/drivers/media/usb/pwc/pwc-v4l.c
<<
>>
Prefs
   1// SPDX-License-Identifier: GPL-2.0-or-later
   2/* Linux driver for Philips webcam
   3   USB and Video4Linux interface part.
   4   (C) 1999-2004 Nemosoft Unv.
   5   (C) 2004-2006 Luc Saillard (luc@saillard.org)
   6   (C) 2011 Hans de Goede <hdegoede@redhat.com>
   7
   8   NOTE: this version of pwc is an unofficial (modified) release of pwc & pcwx
   9   driver and thus may have bugs that are not present in the original version.
  10   Please send bug reports and support requests to <luc@saillard.org>.
  11   The decompression routines have been implemented by reverse-engineering the
  12   Nemosoft binary pwcx module. Caveat emptor.
  13
  14
  15*/
  16
  17#include <linux/errno.h>
  18#include <linux/init.h>
  19#include <linux/mm.h>
  20#include <linux/module.h>
  21#include <linux/poll.h>
  22#include <linux/vmalloc.h>
  23#include <linux/jiffies.h>
  24#include <asm/io.h>
  25
  26#include "pwc.h"
  27
  28#define PWC_CID_CUSTOM(ctrl) ((V4L2_CID_USER_BASE | 0xf000) + custom_ ## ctrl)
  29
  30static int pwc_g_volatile_ctrl(struct v4l2_ctrl *ctrl);
  31static int pwc_s_ctrl(struct v4l2_ctrl *ctrl);
  32
  33static const struct v4l2_ctrl_ops pwc_ctrl_ops = {
  34        .g_volatile_ctrl = pwc_g_volatile_ctrl,
  35        .s_ctrl = pwc_s_ctrl,
  36};
  37
  38enum { awb_indoor, awb_outdoor, awb_fl, awb_manual, awb_auto };
  39enum { custom_autocontour, custom_contour, custom_noise_reduction,
  40        custom_awb_speed, custom_awb_delay,
  41        custom_save_user, custom_restore_user, custom_restore_factory };
  42
  43static const char * const pwc_auto_whitebal_qmenu[] = {
  44        "Indoor (Incandescant Lighting) Mode",
  45        "Outdoor (Sunlight) Mode",
  46        "Indoor (Fluorescent Lighting) Mode",
  47        "Manual Mode",
  48        "Auto Mode",
  49        NULL
  50};
  51
  52static const struct v4l2_ctrl_config pwc_auto_white_balance_cfg = {
  53        .ops    = &pwc_ctrl_ops,
  54        .id     = V4L2_CID_AUTO_WHITE_BALANCE,
  55        .type   = V4L2_CTRL_TYPE_MENU,
  56        .max    = awb_auto,
  57        .qmenu  = pwc_auto_whitebal_qmenu,
  58};
  59
  60static const struct v4l2_ctrl_config pwc_autocontour_cfg = {
  61        .ops    = &pwc_ctrl_ops,
  62        .id     = PWC_CID_CUSTOM(autocontour),
  63        .type   = V4L2_CTRL_TYPE_BOOLEAN,
  64        .name   = "Auto contour",
  65        .min    = 0,
  66        .max    = 1,
  67        .step   = 1,
  68};
  69
  70static const struct v4l2_ctrl_config pwc_contour_cfg = {
  71        .ops    = &pwc_ctrl_ops,
  72        .id     = PWC_CID_CUSTOM(contour),
  73        .type   = V4L2_CTRL_TYPE_INTEGER,
  74        .name   = "Contour",
  75        .flags  = V4L2_CTRL_FLAG_SLIDER,
  76        .min    = 0,
  77        .max    = 63,
  78        .step   = 1,
  79};
  80
  81static const struct v4l2_ctrl_config pwc_backlight_cfg = {
  82        .ops    = &pwc_ctrl_ops,
  83        .id     = V4L2_CID_BACKLIGHT_COMPENSATION,
  84        .type   = V4L2_CTRL_TYPE_BOOLEAN,
  85        .min    = 0,
  86        .max    = 1,
  87        .step   = 1,
  88};
  89
  90static const struct v4l2_ctrl_config pwc_flicker_cfg = {
  91        .ops    = &pwc_ctrl_ops,
  92        .id     = V4L2_CID_BAND_STOP_FILTER,
  93        .type   = V4L2_CTRL_TYPE_BOOLEAN,
  94        .min    = 0,
  95        .max    = 1,
  96        .step   = 1,
  97};
  98
  99static const struct v4l2_ctrl_config pwc_noise_reduction_cfg = {
 100        .ops    = &pwc_ctrl_ops,
 101        .id     = PWC_CID_CUSTOM(noise_reduction),
 102        .type   = V4L2_CTRL_TYPE_INTEGER,
 103        .name   = "Dynamic Noise Reduction",
 104        .min    = 0,
 105        .max    = 3,
 106        .step   = 1,
 107};
 108
 109static const struct v4l2_ctrl_config pwc_save_user_cfg = {
 110        .ops    = &pwc_ctrl_ops,
 111        .id     = PWC_CID_CUSTOM(save_user),
 112        .type   = V4L2_CTRL_TYPE_BUTTON,
 113        .name    = "Save User Settings",
 114};
 115
 116static const struct v4l2_ctrl_config pwc_restore_user_cfg = {
 117        .ops    = &pwc_ctrl_ops,
 118        .id     = PWC_CID_CUSTOM(restore_user),
 119        .type   = V4L2_CTRL_TYPE_BUTTON,
 120        .name    = "Restore User Settings",
 121};
 122
 123static const struct v4l2_ctrl_config pwc_restore_factory_cfg = {
 124        .ops    = &pwc_ctrl_ops,
 125        .id     = PWC_CID_CUSTOM(restore_factory),
 126        .type   = V4L2_CTRL_TYPE_BUTTON,
 127        .name    = "Restore Factory Settings",
 128};
 129
 130static const struct v4l2_ctrl_config pwc_awb_speed_cfg = {
 131        .ops    = &pwc_ctrl_ops,
 132        .id     = PWC_CID_CUSTOM(awb_speed),
 133        .type   = V4L2_CTRL_TYPE_INTEGER,
 134        .name   = "Auto White Balance Speed",
 135        .min    = 1,
 136        .max    = 32,
 137        .step   = 1,
 138};
 139
 140static const struct v4l2_ctrl_config pwc_awb_delay_cfg = {
 141        .ops    = &pwc_ctrl_ops,
 142        .id     = PWC_CID_CUSTOM(awb_delay),
 143        .type   = V4L2_CTRL_TYPE_INTEGER,
 144        .name   = "Auto White Balance Delay",
 145        .min    = 0,
 146        .max    = 63,
 147        .step   = 1,
 148};
 149
 150int pwc_init_controls(struct pwc_device *pdev)
 151{
 152        struct v4l2_ctrl_handler *hdl;
 153        struct v4l2_ctrl_config cfg;
 154        int r, def;
 155
 156        hdl = &pdev->ctrl_handler;
 157        r = v4l2_ctrl_handler_init(hdl, 20);
 158        if (r)
 159                return r;
 160
 161        /* Brightness, contrast, saturation, gamma */
 162        r = pwc_get_u8_ctrl(pdev, GET_LUM_CTL, BRIGHTNESS_FORMATTER, &def);
 163        if (r || def > 127)
 164                def = 63;
 165        pdev->brightness = v4l2_ctrl_new_std(hdl, &pwc_ctrl_ops,
 166                                V4L2_CID_BRIGHTNESS, 0, 127, 1, def);
 167
 168        r = pwc_get_u8_ctrl(pdev, GET_LUM_CTL, CONTRAST_FORMATTER, &def);
 169        if (r || def > 63)
 170                def = 31;
 171        pdev->contrast = v4l2_ctrl_new_std(hdl, &pwc_ctrl_ops,
 172                                V4L2_CID_CONTRAST, 0, 63, 1, def);
 173
 174        if (pdev->type >= 675) {
 175                if (pdev->type < 730)
 176                        pdev->saturation_fmt = SATURATION_MODE_FORMATTER2;
 177                else
 178                        pdev->saturation_fmt = SATURATION_MODE_FORMATTER1;
 179                r = pwc_get_s8_ctrl(pdev, GET_CHROM_CTL, pdev->saturation_fmt,
 180                                    &def);
 181                if (r || def < -100 || def > 100)
 182                        def = 0;
 183                pdev->saturation = v4l2_ctrl_new_std(hdl, &pwc_ctrl_ops,
 184                                      V4L2_CID_SATURATION, -100, 100, 1, def);
 185        }
 186
 187        r = pwc_get_u8_ctrl(pdev, GET_LUM_CTL, GAMMA_FORMATTER, &def);
 188        if (r || def > 31)
 189                def = 15;
 190        pdev->gamma = v4l2_ctrl_new_std(hdl, &pwc_ctrl_ops,
 191                                V4L2_CID_GAMMA, 0, 31, 1, def);
 192
 193        /* auto white balance, red gain, blue gain */
 194        r = pwc_get_u8_ctrl(pdev, GET_CHROM_CTL, WB_MODE_FORMATTER, &def);
 195        if (r || def > awb_auto)
 196                def = awb_auto;
 197        cfg = pwc_auto_white_balance_cfg;
 198        cfg.name = v4l2_ctrl_get_name(cfg.id);
 199        cfg.def = def;
 200        pdev->auto_white_balance = v4l2_ctrl_new_custom(hdl, &cfg, NULL);
 201        /* check auto controls to avoid NULL deref in v4l2_ctrl_auto_cluster */
 202        if (!pdev->auto_white_balance)
 203                return hdl->error;
 204
 205        r = pwc_get_u8_ctrl(pdev, GET_CHROM_CTL,
 206                            PRESET_MANUAL_RED_GAIN_FORMATTER, &def);
 207        if (r)
 208                def = 127;
 209        pdev->red_balance = v4l2_ctrl_new_std(hdl, &pwc_ctrl_ops,
 210                                V4L2_CID_RED_BALANCE, 0, 255, 1, def);
 211
 212        r = pwc_get_u8_ctrl(pdev, GET_CHROM_CTL,
 213                            PRESET_MANUAL_BLUE_GAIN_FORMATTER, &def);
 214        if (r)
 215                def = 127;
 216        pdev->blue_balance = v4l2_ctrl_new_std(hdl, &pwc_ctrl_ops,
 217                                V4L2_CID_BLUE_BALANCE, 0, 255, 1, def);
 218
 219        v4l2_ctrl_auto_cluster(3, &pdev->auto_white_balance, awb_manual, true);
 220
 221        /* autogain, gain */
 222        r = pwc_get_u8_ctrl(pdev, GET_LUM_CTL, AGC_MODE_FORMATTER, &def);
 223        if (r || (def != 0 && def != 0xff))
 224                def = 0;
 225        /* Note a register value if 0 means auto gain is on */
 226        pdev->autogain = v4l2_ctrl_new_std(hdl, &pwc_ctrl_ops,
 227                                V4L2_CID_AUTOGAIN, 0, 1, 1, def == 0);
 228        if (!pdev->autogain)
 229                return hdl->error;
 230
 231        r = pwc_get_u8_ctrl(pdev, GET_LUM_CTL, PRESET_AGC_FORMATTER, &def);
 232        if (r || def > 63)
 233                def = 31;
 234        pdev->gain = v4l2_ctrl_new_std(hdl, &pwc_ctrl_ops,
 235                                V4L2_CID_GAIN, 0, 63, 1, def);
 236
 237        /* auto exposure, exposure */
 238        if (DEVICE_USE_CODEC2(pdev->type)) {
 239                r = pwc_get_u8_ctrl(pdev, GET_LUM_CTL, SHUTTER_MODE_FORMATTER,
 240                                    &def);
 241                if (r || (def != 0 && def != 0xff))
 242                        def = 0;
 243                /*
 244                 * def = 0 auto, def = ff manual
 245                 * menu idx 0 = auto, idx 1 = manual
 246                 */
 247                pdev->exposure_auto = v4l2_ctrl_new_std_menu(hdl,
 248                                        &pwc_ctrl_ops,
 249                                        V4L2_CID_EXPOSURE_AUTO,
 250                                        1, 0, def != 0);
 251                if (!pdev->exposure_auto)
 252                        return hdl->error;
 253
 254                /* GET_LUM_CTL, PRESET_SHUTTER_FORMATTER is unreliable */
 255                r = pwc_get_u16_ctrl(pdev, GET_STATUS_CTL,
 256                                     READ_SHUTTER_FORMATTER, &def);
 257                if (r || def > 655)
 258                        def = 655;
 259                pdev->exposure = v4l2_ctrl_new_std(hdl, &pwc_ctrl_ops,
 260                                        V4L2_CID_EXPOSURE, 0, 655, 1, def);
 261                /* CODEC2: separate auto gain & auto exposure */
 262                v4l2_ctrl_auto_cluster(2, &pdev->autogain, 0, true);
 263                v4l2_ctrl_auto_cluster(2, &pdev->exposure_auto,
 264                                       V4L2_EXPOSURE_MANUAL, true);
 265        } else if (DEVICE_USE_CODEC3(pdev->type)) {
 266                /* GET_LUM_CTL, PRESET_SHUTTER_FORMATTER is unreliable */
 267                r = pwc_get_u16_ctrl(pdev, GET_STATUS_CTL,
 268                                     READ_SHUTTER_FORMATTER, &def);
 269                if (r || def > 255)
 270                        def = 255;
 271                pdev->exposure = v4l2_ctrl_new_std(hdl, &pwc_ctrl_ops,
 272                                        V4L2_CID_EXPOSURE, 0, 255, 1, def);
 273                /* CODEC3: both gain and exposure controlled by autogain */
 274                pdev->autogain_expo_cluster[0] = pdev->autogain;
 275                pdev->autogain_expo_cluster[1] = pdev->gain;
 276                pdev->autogain_expo_cluster[2] = pdev->exposure;
 277                v4l2_ctrl_auto_cluster(3, pdev->autogain_expo_cluster,
 278                                       0, true);
 279        }
 280
 281        /* color / bw setting */
 282        r = pwc_get_u8_ctrl(pdev, GET_CHROM_CTL, COLOUR_MODE_FORMATTER,
 283                         &def);
 284        if (r || (def != 0 && def != 0xff))
 285                def = 0xff;
 286        /* def = 0 bw, def = ff color, menu idx 0 = color, idx 1 = bw */
 287        pdev->colorfx = v4l2_ctrl_new_std_menu(hdl, &pwc_ctrl_ops,
 288                                V4L2_CID_COLORFX, 1, 0, def == 0);
 289
 290        /* autocontour, contour */
 291        r = pwc_get_u8_ctrl(pdev, GET_LUM_CTL, AUTO_CONTOUR_FORMATTER, &def);
 292        if (r || (def != 0 && def != 0xff))
 293                def = 0;
 294        cfg = pwc_autocontour_cfg;
 295        cfg.def = def == 0;
 296        pdev->autocontour = v4l2_ctrl_new_custom(hdl, &cfg, NULL);
 297        if (!pdev->autocontour)
 298                return hdl->error;
 299
 300        r = pwc_get_u8_ctrl(pdev, GET_LUM_CTL, PRESET_CONTOUR_FORMATTER, &def);
 301        if (r || def > 63)
 302                def = 31;
 303        cfg = pwc_contour_cfg;
 304        cfg.def = def;
 305        pdev->contour = v4l2_ctrl_new_custom(hdl, &cfg, NULL);
 306
 307        v4l2_ctrl_auto_cluster(2, &pdev->autocontour, 0, false);
 308
 309        /* backlight */
 310        r = pwc_get_u8_ctrl(pdev, GET_LUM_CTL,
 311                            BACK_LIGHT_COMPENSATION_FORMATTER, &def);
 312        if (r || (def != 0 && def != 0xff))
 313                def = 0;
 314        cfg = pwc_backlight_cfg;
 315        cfg.name = v4l2_ctrl_get_name(cfg.id);
 316        cfg.def = def == 0;
 317        pdev->backlight = v4l2_ctrl_new_custom(hdl, &cfg, NULL);
 318
 319        /* flikker rediction */
 320        r = pwc_get_u8_ctrl(pdev, GET_LUM_CTL,
 321                            FLICKERLESS_MODE_FORMATTER, &def);
 322        if (r || (def != 0 && def != 0xff))
 323                def = 0;
 324        cfg = pwc_flicker_cfg;
 325        cfg.name = v4l2_ctrl_get_name(cfg.id);
 326        cfg.def = def == 0;
 327        pdev->flicker = v4l2_ctrl_new_custom(hdl, &cfg, NULL);
 328
 329        /* Dynamic noise reduction */
 330        r = pwc_get_u8_ctrl(pdev, GET_LUM_CTL,
 331                            DYNAMIC_NOISE_CONTROL_FORMATTER, &def);
 332        if (r || def > 3)
 333                def = 2;
 334        cfg = pwc_noise_reduction_cfg;
 335        cfg.def = def;
 336        pdev->noise_reduction = v4l2_ctrl_new_custom(hdl, &cfg, NULL);
 337
 338        /* Save / Restore User / Factory Settings */
 339        pdev->save_user = v4l2_ctrl_new_custom(hdl, &pwc_save_user_cfg, NULL);
 340        pdev->restore_user = v4l2_ctrl_new_custom(hdl, &pwc_restore_user_cfg,
 341                                                  NULL);
 342        if (pdev->restore_user)
 343                pdev->restore_user->flags |= V4L2_CTRL_FLAG_UPDATE;
 344        pdev->restore_factory = v4l2_ctrl_new_custom(hdl,
 345                                                     &pwc_restore_factory_cfg,
 346                                                     NULL);
 347        if (pdev->restore_factory)
 348                pdev->restore_factory->flags |= V4L2_CTRL_FLAG_UPDATE;
 349
 350        /* Auto White Balance speed & delay */
 351        r = pwc_get_u8_ctrl(pdev, GET_CHROM_CTL,
 352                            AWB_CONTROL_SPEED_FORMATTER, &def);
 353        if (r || def < 1 || def > 32)
 354                def = 1;
 355        cfg = pwc_awb_speed_cfg;
 356        cfg.def = def;
 357        pdev->awb_speed = v4l2_ctrl_new_custom(hdl, &cfg, NULL);
 358
 359        r = pwc_get_u8_ctrl(pdev, GET_CHROM_CTL,
 360                            AWB_CONTROL_DELAY_FORMATTER, &def);
 361        if (r || def > 63)
 362                def = 0;
 363        cfg = pwc_awb_delay_cfg;
 364        cfg.def = def;
 365        pdev->awb_delay = v4l2_ctrl_new_custom(hdl, &cfg, NULL);
 366
 367        if (!(pdev->features & FEATURE_MOTOR_PANTILT))
 368                return hdl->error;
 369
 370        /* Motor pan / tilt / reset */
 371        pdev->motor_pan = v4l2_ctrl_new_std(hdl, &pwc_ctrl_ops,
 372                                V4L2_CID_PAN_RELATIVE, -4480, 4480, 64, 0);
 373        if (!pdev->motor_pan)
 374                return hdl->error;
 375        pdev->motor_tilt = v4l2_ctrl_new_std(hdl, &pwc_ctrl_ops,
 376                                V4L2_CID_TILT_RELATIVE, -1920, 1920, 64, 0);
 377        pdev->motor_pan_reset = v4l2_ctrl_new_std(hdl, &pwc_ctrl_ops,
 378                                V4L2_CID_PAN_RESET, 0, 0, 0, 0);
 379        pdev->motor_tilt_reset = v4l2_ctrl_new_std(hdl, &pwc_ctrl_ops,
 380                                V4L2_CID_TILT_RESET, 0, 0, 0, 0);
 381        v4l2_ctrl_cluster(4, &pdev->motor_pan);
 382
 383        return hdl->error;
 384}
 385
 386static void pwc_vidioc_fill_fmt(struct v4l2_format *f,
 387        int width, int height, u32 pixfmt)
 388{
 389        memset(&f->fmt.pix, 0, sizeof(struct v4l2_pix_format));
 390        f->fmt.pix.width        = width;
 391        f->fmt.pix.height       = height;
 392        f->fmt.pix.field        = V4L2_FIELD_NONE;
 393        f->fmt.pix.pixelformat  = pixfmt;
 394        f->fmt.pix.bytesperline = f->fmt.pix.width;
 395        f->fmt.pix.sizeimage    = f->fmt.pix.height * f->fmt.pix.width * 3 / 2;
 396        f->fmt.pix.colorspace   = V4L2_COLORSPACE_SRGB;
 397        PWC_DEBUG_IOCTL("pwc_vidioc_fill_fmt() width=%d, height=%d, bytesperline=%d, sizeimage=%d, pixelformat=%c%c%c%c\n",
 398                        f->fmt.pix.width,
 399                        f->fmt.pix.height,
 400                        f->fmt.pix.bytesperline,
 401                        f->fmt.pix.sizeimage,
 402                        (f->fmt.pix.pixelformat)&255,
 403                        (f->fmt.pix.pixelformat>>8)&255,
 404                        (f->fmt.pix.pixelformat>>16)&255,
 405                        (f->fmt.pix.pixelformat>>24)&255);
 406}
 407
 408/* ioctl(VIDIOC_TRY_FMT) */
 409static int pwc_vidioc_try_fmt(struct pwc_device *pdev, struct v4l2_format *f)
 410{
 411        int size;
 412
 413        if (f->type != V4L2_BUF_TYPE_VIDEO_CAPTURE) {
 414                PWC_DEBUG_IOCTL("Bad video type must be V4L2_BUF_TYPE_VIDEO_CAPTURE\n");
 415                return -EINVAL;
 416        }
 417
 418        switch (f->fmt.pix.pixelformat) {
 419                case V4L2_PIX_FMT_YUV420:
 420                        break;
 421                case V4L2_PIX_FMT_PWC1:
 422                        if (DEVICE_USE_CODEC23(pdev->type)) {
 423                                PWC_DEBUG_IOCTL("codec1 is only supported for old pwc webcam\n");
 424                                f->fmt.pix.pixelformat = V4L2_PIX_FMT_YUV420;
 425                        }
 426                        break;
 427                case V4L2_PIX_FMT_PWC2:
 428                        if (DEVICE_USE_CODEC1(pdev->type)) {
 429                                PWC_DEBUG_IOCTL("codec23 is only supported for new pwc webcam\n");
 430                                f->fmt.pix.pixelformat = V4L2_PIX_FMT_YUV420;
 431                        }
 432                        break;
 433                default:
 434                        PWC_DEBUG_IOCTL("Unsupported pixel format\n");
 435                        f->fmt.pix.pixelformat = V4L2_PIX_FMT_YUV420;
 436        }
 437
 438        size = pwc_get_size(pdev, f->fmt.pix.width, f->fmt.pix.height);
 439        pwc_vidioc_fill_fmt(f,
 440                            pwc_image_sizes[size][0],
 441                            pwc_image_sizes[size][1],
 442                            f->fmt.pix.pixelformat);
 443
 444        return 0;
 445}
 446
 447/* ioctl(VIDIOC_SET_FMT) */
 448
 449static int pwc_s_fmt_vid_cap(struct file *file, void *fh, struct v4l2_format *f)
 450{
 451        struct pwc_device *pdev = video_drvdata(file);
 452        int ret, pixelformat, compression = 0;
 453
 454        ret = pwc_vidioc_try_fmt(pdev, f);
 455        if (ret < 0)
 456                return ret;
 457
 458        if (vb2_is_busy(&pdev->vb_queue))
 459                return -EBUSY;
 460
 461        pixelformat = f->fmt.pix.pixelformat;
 462
 463        PWC_DEBUG_IOCTL("Trying to set format to: width=%d height=%d fps=%d format=%c%c%c%c\n",
 464                        f->fmt.pix.width, f->fmt.pix.height, pdev->vframes,
 465                        (pixelformat)&255,
 466                        (pixelformat>>8)&255,
 467                        (pixelformat>>16)&255,
 468                        (pixelformat>>24)&255);
 469
 470        ret = pwc_set_video_mode(pdev, f->fmt.pix.width, f->fmt.pix.height,
 471                                 pixelformat, 30, &compression, 0);
 472
 473        PWC_DEBUG_IOCTL("pwc_set_video_mode(), return=%d\n", ret);
 474
 475        pwc_vidioc_fill_fmt(f, pdev->width, pdev->height, pdev->pixfmt);
 476        return ret;
 477}
 478
 479static int pwc_querycap(struct file *file, void *fh, struct v4l2_capability *cap)
 480{
 481        struct pwc_device *pdev = video_drvdata(file);
 482
 483        strscpy(cap->driver, PWC_NAME, sizeof(cap->driver));
 484        strscpy(cap->card, pdev->vdev.name, sizeof(cap->card));
 485        usb_make_path(pdev->udev, cap->bus_info, sizeof(cap->bus_info));
 486        return 0;
 487}
 488
 489static int pwc_enum_input(struct file *file, void *fh, struct v4l2_input *i)
 490{
 491        if (i->index)   /* Only one INPUT is supported */
 492                return -EINVAL;
 493
 494        strscpy(i->name, "Camera", sizeof(i->name));
 495        i->type = V4L2_INPUT_TYPE_CAMERA;
 496        return 0;
 497}
 498
 499static int pwc_g_input(struct file *file, void *fh, unsigned int *i)
 500{
 501        *i = 0;
 502        return 0;
 503}
 504
 505static int pwc_s_input(struct file *file, void *fh, unsigned int i)
 506{
 507        return i ? -EINVAL : 0;
 508}
 509
 510static int pwc_g_volatile_ctrl(struct v4l2_ctrl *ctrl)
 511{
 512        struct pwc_device *pdev =
 513                container_of(ctrl->handler, struct pwc_device, ctrl_handler);
 514        int ret = 0;
 515
 516        switch (ctrl->id) {
 517        case V4L2_CID_AUTO_WHITE_BALANCE:
 518                if (pdev->color_bal_valid &&
 519                        (pdev->auto_white_balance->val != awb_auto ||
 520                         time_before(jiffies,
 521                                pdev->last_color_bal_update + HZ / 4))) {
 522                        pdev->red_balance->val  = pdev->last_red_balance;
 523                        pdev->blue_balance->val = pdev->last_blue_balance;
 524                        break;
 525                }
 526                ret = pwc_get_u8_ctrl(pdev, GET_STATUS_CTL,
 527                                      READ_RED_GAIN_FORMATTER,
 528                                      &pdev->red_balance->val);
 529                if (ret)
 530                        break;
 531                ret = pwc_get_u8_ctrl(pdev, GET_STATUS_CTL,
 532                                      READ_BLUE_GAIN_FORMATTER,
 533                                      &pdev->blue_balance->val);
 534                if (ret)
 535                        break;
 536                pdev->last_red_balance  = pdev->red_balance->val;
 537                pdev->last_blue_balance = pdev->blue_balance->val;
 538                pdev->last_color_bal_update = jiffies;
 539                pdev->color_bal_valid = true;
 540                break;
 541        case V4L2_CID_AUTOGAIN:
 542                if (pdev->gain_valid && time_before(jiffies,
 543                                pdev->last_gain_update + HZ / 4)) {
 544                        pdev->gain->val = pdev->last_gain;
 545                        break;
 546                }
 547                ret = pwc_get_u8_ctrl(pdev, GET_STATUS_CTL,
 548                                      READ_AGC_FORMATTER, &pdev->gain->val);
 549                if (ret)
 550                        break;
 551                pdev->last_gain = pdev->gain->val;
 552                pdev->last_gain_update = jiffies;
 553                pdev->gain_valid = true;
 554                if (!DEVICE_USE_CODEC3(pdev->type))
 555                        break;
 556                /* For CODEC3 where autogain also controls expo */
 557                fallthrough;
 558        case V4L2_CID_EXPOSURE_AUTO:
 559                if (pdev->exposure_valid && time_before(jiffies,
 560                                pdev->last_exposure_update + HZ / 4)) {
 561                        pdev->exposure->val = pdev->last_exposure;
 562                        break;
 563                }
 564                ret = pwc_get_u16_ctrl(pdev, GET_STATUS_CTL,
 565                                       READ_SHUTTER_FORMATTER,
 566                                       &pdev->exposure->val);
 567                if (ret)
 568                        break;
 569                pdev->last_exposure = pdev->exposure->val;
 570                pdev->last_exposure_update = jiffies;
 571                pdev->exposure_valid = true;
 572                break;
 573        default:
 574                ret = -EINVAL;
 575        }
 576
 577        if (ret)
 578                PWC_ERROR("g_ctrl %s error %d\n", ctrl->name, ret);
 579
 580        return ret;
 581}
 582
 583static int pwc_set_awb(struct pwc_device *pdev)
 584{
 585        int ret;
 586
 587        if (pdev->auto_white_balance->is_new) {
 588                ret = pwc_set_u8_ctrl(pdev, SET_CHROM_CTL,
 589                                      WB_MODE_FORMATTER,
 590                                      pdev->auto_white_balance->val);
 591                if (ret)
 592                        return ret;
 593
 594                if (pdev->auto_white_balance->val != awb_manual)
 595                        pdev->color_bal_valid = false; /* Force cache update */
 596
 597                /*
 598                 * If this is a preset, update our red / blue balance values
 599                 * so that events get generated for the new preset values
 600                 */
 601                if (pdev->auto_white_balance->val == awb_indoor ||
 602                    pdev->auto_white_balance->val == awb_outdoor ||
 603                    pdev->auto_white_balance->val == awb_fl)
 604                        pwc_g_volatile_ctrl(pdev->auto_white_balance);
 605        }
 606        if (pdev->auto_white_balance->val != awb_manual)
 607                return 0;
 608
 609        if (pdev->red_balance->is_new) {
 610                ret = pwc_set_u8_ctrl(pdev, SET_CHROM_CTL,
 611                                      PRESET_MANUAL_RED_GAIN_FORMATTER,
 612                                      pdev->red_balance->val);
 613                if (ret)
 614                        return ret;
 615        }
 616
 617        if (pdev->blue_balance->is_new) {
 618                ret = pwc_set_u8_ctrl(pdev, SET_CHROM_CTL,
 619                                      PRESET_MANUAL_BLUE_GAIN_FORMATTER,
 620                                      pdev->blue_balance->val);
 621                if (ret)
 622                        return ret;
 623        }
 624        return 0;
 625}
 626
 627/* For CODEC2 models which have separate autogain and auto exposure */
 628static int pwc_set_autogain(struct pwc_device *pdev)
 629{
 630        int ret;
 631
 632        if (pdev->autogain->is_new) {
 633                ret = pwc_set_u8_ctrl(pdev, SET_LUM_CTL,
 634                                      AGC_MODE_FORMATTER,
 635                                      pdev->autogain->val ? 0 : 0xff);
 636                if (ret)
 637                        return ret;
 638
 639                if (pdev->autogain->val)
 640                        pdev->gain_valid = false; /* Force cache update */
 641        }
 642
 643        if (pdev->autogain->val)
 644                return 0;
 645
 646        if (pdev->gain->is_new) {
 647                ret = pwc_set_u8_ctrl(pdev, SET_LUM_CTL,
 648                                      PRESET_AGC_FORMATTER,
 649                                      pdev->gain->val);
 650                if (ret)
 651                        return ret;
 652        }
 653        return 0;
 654}
 655
 656/* For CODEC2 models which have separate autogain and auto exposure */
 657static int pwc_set_exposure_auto(struct pwc_device *pdev)
 658{
 659        int ret;
 660        int is_auto = pdev->exposure_auto->val == V4L2_EXPOSURE_AUTO;
 661
 662        if (pdev->exposure_auto->is_new) {
 663                ret = pwc_set_u8_ctrl(pdev, SET_LUM_CTL,
 664                                      SHUTTER_MODE_FORMATTER,
 665                                      is_auto ? 0 : 0xff);
 666                if (ret)
 667                        return ret;
 668
 669                if (is_auto)
 670                        pdev->exposure_valid = false; /* Force cache update */
 671        }
 672
 673        if (is_auto)
 674                return 0;
 675
 676        if (pdev->exposure->is_new) {
 677                ret = pwc_set_u16_ctrl(pdev, SET_LUM_CTL,
 678                                       PRESET_SHUTTER_FORMATTER,
 679                                       pdev->exposure->val);
 680                if (ret)
 681                        return ret;
 682        }
 683        return 0;
 684}
 685
 686/* For CODEC3 models which have autogain controlling both gain and exposure */
 687static int pwc_set_autogain_expo(struct pwc_device *pdev)
 688{
 689        int ret;
 690
 691        if (pdev->autogain->is_new) {
 692                ret = pwc_set_u8_ctrl(pdev, SET_LUM_CTL,
 693                                      AGC_MODE_FORMATTER,
 694                                      pdev->autogain->val ? 0 : 0xff);
 695                if (ret)
 696                        return ret;
 697
 698                if (pdev->autogain->val) {
 699                        pdev->gain_valid     = false; /* Force cache update */
 700                        pdev->exposure_valid = false; /* Force cache update */
 701                }
 702        }
 703
 704        if (pdev->autogain->val)
 705                return 0;
 706
 707        if (pdev->gain->is_new) {
 708                ret = pwc_set_u8_ctrl(pdev, SET_LUM_CTL,
 709                                      PRESET_AGC_FORMATTER,
 710                                      pdev->gain->val);
 711                if (ret)
 712                        return ret;
 713        }
 714
 715        if (pdev->exposure->is_new) {
 716                ret = pwc_set_u16_ctrl(pdev, SET_LUM_CTL,
 717                                       PRESET_SHUTTER_FORMATTER,
 718                                       pdev->exposure->val);
 719                if (ret)
 720                        return ret;
 721        }
 722        return 0;
 723}
 724
 725static int pwc_set_motor(struct pwc_device *pdev)
 726{
 727        int ret;
 728
 729        pdev->ctrl_buf[0] = 0;
 730        if (pdev->motor_pan_reset->is_new)
 731                pdev->ctrl_buf[0] |= 0x01;
 732        if (pdev->motor_tilt_reset->is_new)
 733                pdev->ctrl_buf[0] |= 0x02;
 734        if (pdev->motor_pan_reset->is_new || pdev->motor_tilt_reset->is_new) {
 735                ret = send_control_msg(pdev, SET_MPT_CTL,
 736                                       PT_RESET_CONTROL_FORMATTER,
 737                                       pdev->ctrl_buf, 1);
 738                if (ret < 0)
 739                        return ret;
 740        }
 741
 742        memset(pdev->ctrl_buf, 0, 4);
 743        if (pdev->motor_pan->is_new) {
 744                pdev->ctrl_buf[0] = pdev->motor_pan->val & 0xFF;
 745                pdev->ctrl_buf[1] = (pdev->motor_pan->val >> 8);
 746        }
 747        if (pdev->motor_tilt->is_new) {
 748                pdev->ctrl_buf[2] = pdev->motor_tilt->val & 0xFF;
 749                pdev->ctrl_buf[3] = (pdev->motor_tilt->val >> 8);
 750        }
 751        if (pdev->motor_pan->is_new || pdev->motor_tilt->is_new) {
 752                ret = send_control_msg(pdev, SET_MPT_CTL,
 753                                       PT_RELATIVE_CONTROL_FORMATTER,
 754                                       pdev->ctrl_buf, 4);
 755                if (ret < 0)
 756                        return ret;
 757        }
 758
 759        return 0;
 760}
 761
 762static int pwc_s_ctrl(struct v4l2_ctrl *ctrl)
 763{
 764        struct pwc_device *pdev =
 765                container_of(ctrl->handler, struct pwc_device, ctrl_handler);
 766        int ret = 0;
 767
 768        switch (ctrl->id) {
 769        case V4L2_CID_BRIGHTNESS:
 770                ret = pwc_set_u8_ctrl(pdev, SET_LUM_CTL,
 771                                      BRIGHTNESS_FORMATTER, ctrl->val);
 772                break;
 773        case V4L2_CID_CONTRAST:
 774                ret = pwc_set_u8_ctrl(pdev, SET_LUM_CTL,
 775                                      CONTRAST_FORMATTER, ctrl->val);
 776                break;
 777        case V4L2_CID_SATURATION:
 778                ret = pwc_set_s8_ctrl(pdev, SET_CHROM_CTL,
 779                                      pdev->saturation_fmt, ctrl->val);
 780                break;
 781        case V4L2_CID_GAMMA:
 782                ret = pwc_set_u8_ctrl(pdev, SET_LUM_CTL,
 783                                      GAMMA_FORMATTER, ctrl->val);
 784                break;
 785        case V4L2_CID_AUTO_WHITE_BALANCE:
 786                ret = pwc_set_awb(pdev);
 787                break;
 788        case V4L2_CID_AUTOGAIN:
 789                if (DEVICE_USE_CODEC2(pdev->type))
 790                        ret = pwc_set_autogain(pdev);
 791                else if (DEVICE_USE_CODEC3(pdev->type))
 792                        ret = pwc_set_autogain_expo(pdev);
 793                else
 794                        ret = -EINVAL;
 795                break;
 796        case V4L2_CID_EXPOSURE_AUTO:
 797                if (DEVICE_USE_CODEC2(pdev->type))
 798                        ret = pwc_set_exposure_auto(pdev);
 799                else
 800                        ret = -EINVAL;
 801                break;
 802        case V4L2_CID_COLORFX:
 803                ret = pwc_set_u8_ctrl(pdev, SET_CHROM_CTL,
 804                                      COLOUR_MODE_FORMATTER,
 805                                      ctrl->val ? 0 : 0xff);
 806                break;
 807        case PWC_CID_CUSTOM(autocontour):
 808                if (pdev->autocontour->is_new) {
 809                        ret = pwc_set_u8_ctrl(pdev, SET_LUM_CTL,
 810                                        AUTO_CONTOUR_FORMATTER,
 811                                        pdev->autocontour->val ? 0 : 0xff);
 812                }
 813                if (ret == 0 && pdev->contour->is_new) {
 814                        ret = pwc_set_u8_ctrl(pdev, SET_LUM_CTL,
 815                                              PRESET_CONTOUR_FORMATTER,
 816                                              pdev->contour->val);
 817                }
 818                break;
 819        case V4L2_CID_BACKLIGHT_COMPENSATION:
 820                ret = pwc_set_u8_ctrl(pdev, SET_LUM_CTL,
 821                                      BACK_LIGHT_COMPENSATION_FORMATTER,
 822                                      ctrl->val ? 0 : 0xff);
 823                break;
 824        case V4L2_CID_BAND_STOP_FILTER:
 825                ret = pwc_set_u8_ctrl(pdev, SET_LUM_CTL,
 826                                      FLICKERLESS_MODE_FORMATTER,
 827                                      ctrl->val ? 0 : 0xff);
 828                break;
 829        case PWC_CID_CUSTOM(noise_reduction):
 830                ret = pwc_set_u8_ctrl(pdev, SET_LUM_CTL,
 831                                      DYNAMIC_NOISE_CONTROL_FORMATTER,
 832                                      ctrl->val);
 833                break;
 834        case PWC_CID_CUSTOM(save_user):
 835                ret = pwc_button_ctrl(pdev, SAVE_USER_DEFAULTS_FORMATTER);
 836                break;
 837        case PWC_CID_CUSTOM(restore_user):
 838                ret = pwc_button_ctrl(pdev, RESTORE_USER_DEFAULTS_FORMATTER);
 839                break;
 840        case PWC_CID_CUSTOM(restore_factory):
 841                ret = pwc_button_ctrl(pdev,
 842                                      RESTORE_FACTORY_DEFAULTS_FORMATTER);
 843                break;
 844        case PWC_CID_CUSTOM(awb_speed):
 845                ret = pwc_set_u8_ctrl(pdev, SET_CHROM_CTL,
 846                                      AWB_CONTROL_SPEED_FORMATTER,
 847                                      ctrl->val);
 848                break;
 849        case PWC_CID_CUSTOM(awb_delay):
 850                ret = pwc_set_u8_ctrl(pdev, SET_CHROM_CTL,
 851                                      AWB_CONTROL_DELAY_FORMATTER,
 852                                      ctrl->val);
 853                break;
 854        case V4L2_CID_PAN_RELATIVE:
 855                ret = pwc_set_motor(pdev);
 856                break;
 857        default:
 858                ret = -EINVAL;
 859        }
 860
 861        if (ret)
 862                PWC_ERROR("s_ctrl %s error %d\n", ctrl->name, ret);
 863
 864        return ret;
 865}
 866
 867static int pwc_enum_fmt_vid_cap(struct file *file, void *fh, struct v4l2_fmtdesc *f)
 868{
 869        struct pwc_device *pdev = video_drvdata(file);
 870
 871        /* We only support two format: the raw format, and YUV */
 872        switch (f->index) {
 873        case 0:
 874                /* RAW format */
 875                f->pixelformat = pdev->type <= 646 ? V4L2_PIX_FMT_PWC1 : V4L2_PIX_FMT_PWC2;
 876                break;
 877        case 1:
 878                f->pixelformat = V4L2_PIX_FMT_YUV420;
 879                break;
 880        default:
 881                return -EINVAL;
 882        }
 883        return 0;
 884}
 885
 886static int pwc_g_fmt_vid_cap(struct file *file, void *fh, struct v4l2_format *f)
 887{
 888        struct pwc_device *pdev = video_drvdata(file);
 889
 890        if (f->type != V4L2_BUF_TYPE_VIDEO_CAPTURE)
 891                return -EINVAL;
 892
 893        PWC_DEBUG_IOCTL("ioctl(VIDIOC_G_FMT) return size %dx%d\n",
 894                        pdev->width, pdev->height);
 895        pwc_vidioc_fill_fmt(f, pdev->width, pdev->height, pdev->pixfmt);
 896        return 0;
 897}
 898
 899static int pwc_try_fmt_vid_cap(struct file *file, void *fh, struct v4l2_format *f)
 900{
 901        struct pwc_device *pdev = video_drvdata(file);
 902
 903        return pwc_vidioc_try_fmt(pdev, f);
 904}
 905
 906static int pwc_enum_framesizes(struct file *file, void *fh,
 907                                         struct v4l2_frmsizeenum *fsize)
 908{
 909        struct pwc_device *pdev = video_drvdata(file);
 910        unsigned int i = 0, index = fsize->index;
 911
 912        if (fsize->pixel_format == V4L2_PIX_FMT_YUV420 ||
 913            (fsize->pixel_format == V4L2_PIX_FMT_PWC1 &&
 914                        DEVICE_USE_CODEC1(pdev->type)) ||
 915            (fsize->pixel_format == V4L2_PIX_FMT_PWC2 &&
 916                        DEVICE_USE_CODEC23(pdev->type))) {
 917                for (i = 0; i < PSZ_MAX; i++) {
 918                        if (!(pdev->image_mask & (1UL << i)))
 919                                continue;
 920                        if (!index--) {
 921                                fsize->type = V4L2_FRMSIZE_TYPE_DISCRETE;
 922                                fsize->discrete.width = pwc_image_sizes[i][0];
 923                                fsize->discrete.height = pwc_image_sizes[i][1];
 924                                return 0;
 925                        }
 926                }
 927        }
 928        return -EINVAL;
 929}
 930
 931static int pwc_enum_frameintervals(struct file *file, void *fh,
 932                                           struct v4l2_frmivalenum *fival)
 933{
 934        struct pwc_device *pdev = video_drvdata(file);
 935        int size = -1;
 936        unsigned int i;
 937
 938        for (i = 0; i < PSZ_MAX; i++) {
 939                if (pwc_image_sizes[i][0] == fival->width &&
 940                                pwc_image_sizes[i][1] == fival->height) {
 941                        size = i;
 942                        break;
 943                }
 944        }
 945
 946        /* TODO: Support raw format */
 947        if (size < 0 || fival->pixel_format != V4L2_PIX_FMT_YUV420)
 948                return -EINVAL;
 949
 950        i = pwc_get_fps(pdev, fival->index, size);
 951        if (!i)
 952                return -EINVAL;
 953
 954        fival->type = V4L2_FRMIVAL_TYPE_DISCRETE;
 955        fival->discrete.numerator = 1;
 956        fival->discrete.denominator = i;
 957
 958        return 0;
 959}
 960
 961static int pwc_g_parm(struct file *file, void *fh,
 962                      struct v4l2_streamparm *parm)
 963{
 964        struct pwc_device *pdev = video_drvdata(file);
 965
 966        if (parm->type != V4L2_BUF_TYPE_VIDEO_CAPTURE)
 967                return -EINVAL;
 968
 969        memset(parm, 0, sizeof(*parm));
 970
 971        parm->type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
 972        parm->parm.capture.readbuffers = MIN_FRAMES;
 973        parm->parm.capture.capability |= V4L2_CAP_TIMEPERFRAME;
 974        parm->parm.capture.timeperframe.denominator = pdev->vframes;
 975        parm->parm.capture.timeperframe.numerator = 1;
 976
 977        return 0;
 978}
 979
 980static int pwc_s_parm(struct file *file, void *fh,
 981                      struct v4l2_streamparm *parm)
 982{
 983        struct pwc_device *pdev = video_drvdata(file);
 984        int compression = 0;
 985        int ret, fps;
 986
 987        if (parm->type != V4L2_BUF_TYPE_VIDEO_CAPTURE)
 988                return -EINVAL;
 989
 990        /* If timeperframe == 0, then reset the framerate to the nominal value.
 991           We pick a high framerate here, and let pwc_set_video_mode() figure
 992           out the best match. */
 993        if (parm->parm.capture.timeperframe.numerator == 0 ||
 994            parm->parm.capture.timeperframe.denominator == 0)
 995                fps = 30;
 996        else
 997                fps = parm->parm.capture.timeperframe.denominator /
 998                      parm->parm.capture.timeperframe.numerator;
 999
1000        if (vb2_is_busy(&pdev->vb_queue))
1001                return -EBUSY;
1002
1003        ret = pwc_set_video_mode(pdev, pdev->width, pdev->height, pdev->pixfmt,
1004                                 fps, &compression, 0);
1005
1006        pwc_g_parm(file, fh, parm);
1007
1008        return ret;
1009}
1010
1011const struct v4l2_ioctl_ops pwc_ioctl_ops = {
1012        .vidioc_querycap                    = pwc_querycap,
1013        .vidioc_enum_input                  = pwc_enum_input,
1014        .vidioc_g_input                     = pwc_g_input,
1015        .vidioc_s_input                     = pwc_s_input,
1016        .vidioc_enum_fmt_vid_cap            = pwc_enum_fmt_vid_cap,
1017        .vidioc_g_fmt_vid_cap               = pwc_g_fmt_vid_cap,
1018        .vidioc_s_fmt_vid_cap               = pwc_s_fmt_vid_cap,
1019        .vidioc_try_fmt_vid_cap             = pwc_try_fmt_vid_cap,
1020        .vidioc_reqbufs                     = vb2_ioctl_reqbufs,
1021        .vidioc_querybuf                    = vb2_ioctl_querybuf,
1022        .vidioc_qbuf                        = vb2_ioctl_qbuf,
1023        .vidioc_dqbuf                       = vb2_ioctl_dqbuf,
1024        .vidioc_streamon                    = vb2_ioctl_streamon,
1025        .vidioc_streamoff                   = vb2_ioctl_streamoff,
1026        .vidioc_log_status                  = v4l2_ctrl_log_status,
1027        .vidioc_enum_framesizes             = pwc_enum_framesizes,
1028        .vidioc_enum_frameintervals         = pwc_enum_frameintervals,
1029        .vidioc_g_parm                      = pwc_g_parm,
1030        .vidioc_s_parm                      = pwc_s_parm,
1031        .vidioc_subscribe_event             = v4l2_ctrl_subscribe_event,
1032        .vidioc_unsubscribe_event           = v4l2_event_unsubscribe,
1033};
1034