1 // SPDX-License-Identifier: GPL-2.0 2 /* 3 * A V4L2 driver for Sony IMX219 cameras. 4 * Copyright (C) 2019, Raspberry Pi (Trading) Ltd 5 * 6 * Based on Sony imx258 camera driver 7 * Copyright (C) 2018 Intel Corporation 8 * 9 * DT / fwnode changes, and regulator / GPIO control taken from imx214 driver 10 * Copyright 2018 Qtechnology A/S 11 * 12 * Flip handling taken from the Sony IMX319 driver. 13 * Copyright (C) 2018 Intel Corporation 14 * 15 */ 16 17 #include <linux/clk.h> 18 #include <linux/delay.h> 19 #include <linux/gpio/consumer.h> 20 #include <linux/i2c.h> 21 #include <linux/minmax.h> 22 #include <linux/module.h> 23 #include <linux/pm_runtime.h> 24 #include <linux/regulator/consumer.h> 25 26 #include <media/v4l2-cci.h> 27 #include <media/v4l2-ctrls.h> 28 #include <media/v4l2-device.h> 29 #include <media/v4l2-event.h> 30 #include <media/v4l2-fwnode.h> 31 #include <media/v4l2-mediabus.h> 32 33 /* Chip ID */ 34 #define IMX219_REG_CHIP_ID CCI_REG16(0x0000) 35 #define IMX219_CHIP_ID 0x0219 36 37 #define IMX219_REG_MODE_SELECT CCI_REG8(0x0100) 38 #define IMX219_MODE_STANDBY 0x00 39 #define IMX219_MODE_STREAMING 0x01 40 41 #define IMX219_REG_CSI_LANE_MODE CCI_REG8(0x0114) 42 #define IMX219_CSI_2_LANE_MODE 0x01 43 #define IMX219_CSI_4_LANE_MODE 0x03 44 45 #define IMX219_REG_DPHY_CTRL CCI_REG8(0x0128) 46 #define IMX219_DPHY_CTRL_TIMING_AUTO 0 47 #define IMX219_DPHY_CTRL_TIMING_MANUAL 1 48 49 #define IMX219_REG_EXCK_FREQ CCI_REG16(0x012a) 50 #define IMX219_EXCK_FREQ(n) ((n) * 256) /* n expressed in MHz */ 51 52 /* Analog gain control */ 53 #define IMX219_REG_ANALOG_GAIN CCI_REG8(0x0157) 54 #define IMX219_ANA_GAIN_MIN 0 55 #define IMX219_ANA_GAIN_MAX 232 56 #define IMX219_ANA_GAIN_STEP 1 57 #define IMX219_ANA_GAIN_DEFAULT 0x0 58 59 /* Digital gain control */ 60 #define IMX219_REG_DIGITAL_GAIN CCI_REG16(0x0158) 61 #define IMX219_DGTL_GAIN_MIN 0x0100 62 #define IMX219_DGTL_GAIN_MAX 0x0fff 63 #define IMX219_DGTL_GAIN_DEFAULT 0x0100 64 #define IMX219_DGTL_GAIN_STEP 1 65 66 /* Exposure control */ 67 #define IMX219_REG_EXPOSURE CCI_REG16(0x015a) 68 #define IMX219_EXPOSURE_MIN 4 69 #define IMX219_EXPOSURE_STEP 1 70 #define IMX219_EXPOSURE_DEFAULT 0x640 71 #define IMX219_EXPOSURE_MAX 65535 72 73 /* V_TIMING internal */ 74 #define IMX219_REG_VTS CCI_REG16(0x0160) 75 #define IMX219_VTS_MAX 0xffff 76 77 #define IMX219_VBLANK_MIN 4 78 79 /* HBLANK control - read only */ 80 #define IMX219_PPL_DEFAULT 3448 81 82 #define IMX219_REG_LINE_LENGTH_A CCI_REG16(0x0162) 83 #define IMX219_REG_X_ADD_STA_A CCI_REG16(0x0164) 84 #define IMX219_REG_X_ADD_END_A CCI_REG16(0x0166) 85 #define IMX219_REG_Y_ADD_STA_A CCI_REG16(0x0168) 86 #define IMX219_REG_Y_ADD_END_A CCI_REG16(0x016a) 87 #define IMX219_REG_X_OUTPUT_SIZE CCI_REG16(0x016c) 88 #define IMX219_REG_Y_OUTPUT_SIZE CCI_REG16(0x016e) 89 #define IMX219_REG_X_ODD_INC_A CCI_REG8(0x0170) 90 #define IMX219_REG_Y_ODD_INC_A CCI_REG8(0x0171) 91 #define IMX219_REG_ORIENTATION CCI_REG8(0x0172) 92 93 /* Binning Mode */ 94 #define IMX219_REG_BINNING_MODE_H CCI_REG8(0x0174) 95 #define IMX219_REG_BINNING_MODE_V CCI_REG8(0x0175) 96 #define IMX219_BINNING_NONE 0x00 97 #define IMX219_BINNING_X2 0x01 98 #define IMX219_BINNING_X2_ANALOG 0x03 99 100 #define IMX219_REG_CSI_DATA_FORMAT_A CCI_REG16(0x018c) 101 102 /* PLL Settings */ 103 #define IMX219_REG_VTPXCK_DIV CCI_REG8(0x0301) 104 #define IMX219_REG_VTSYCK_DIV CCI_REG8(0x0303) 105 #define IMX219_REG_PREPLLCK_VT_DIV CCI_REG8(0x0304) 106 #define IMX219_REG_PREPLLCK_OP_DIV CCI_REG8(0x0305) 107 #define IMX219_REG_PLL_VT_MPY CCI_REG16(0x0306) 108 #define IMX219_REG_OPPXCK_DIV CCI_REG8(0x0309) 109 #define IMX219_REG_OPSYCK_DIV CCI_REG8(0x030b) 110 #define IMX219_REG_PLL_OP_MPY CCI_REG16(0x030c) 111 112 /* Test Pattern Control */ 113 #define IMX219_REG_TEST_PATTERN CCI_REG16(0x0600) 114 #define IMX219_TEST_PATTERN_DISABLE 0 115 #define IMX219_TEST_PATTERN_SOLID_COLOR 1 116 #define IMX219_TEST_PATTERN_COLOR_BARS 2 117 #define IMX219_TEST_PATTERN_GREY_COLOR 3 118 #define IMX219_TEST_PATTERN_PN9 4 119 120 /* Test pattern colour components */ 121 #define IMX219_REG_TESTP_RED CCI_REG16(0x0602) 122 #define IMX219_REG_TESTP_GREENR CCI_REG16(0x0604) 123 #define IMX219_REG_TESTP_BLUE CCI_REG16(0x0606) 124 #define IMX219_REG_TESTP_GREENB CCI_REG16(0x0608) 125 #define IMX219_TESTP_COLOUR_MIN 0 126 #define IMX219_TESTP_COLOUR_MAX 0x03ff 127 #define IMX219_TESTP_COLOUR_STEP 1 128 129 #define IMX219_REG_TP_WINDOW_WIDTH CCI_REG16(0x0624) 130 #define IMX219_REG_TP_WINDOW_HEIGHT CCI_REG16(0x0626) 131 132 /* External clock frequency is 24.0M */ 133 #define IMX219_XCLK_FREQ 24000000 134 135 /* Pixel rate is fixed for all the modes */ 136 #define IMX219_PIXEL_RATE 182400000 137 #define IMX219_PIXEL_RATE_4LANE 280800000 138 139 #define IMX219_DEFAULT_LINK_FREQ 456000000 140 #define IMX219_DEFAULT_LINK_FREQ_4LANE 363000000 141 142 /* IMX219 native and active pixel array size. */ 143 #define IMX219_NATIVE_WIDTH 3296U 144 #define IMX219_NATIVE_HEIGHT 2480U 145 #define IMX219_PIXEL_ARRAY_LEFT 8U 146 #define IMX219_PIXEL_ARRAY_TOP 8U 147 #define IMX219_PIXEL_ARRAY_WIDTH 3280U 148 #define IMX219_PIXEL_ARRAY_HEIGHT 2464U 149 150 /* Mode : resolution and related config&values */ 151 struct imx219_mode { 152 /* Frame width */ 153 unsigned int width; 154 /* Frame height */ 155 unsigned int height; 156 157 /* V-timing */ 158 unsigned int vts_def; 159 }; 160 161 static const struct cci_reg_sequence imx219_common_regs[] = { 162 { IMX219_REG_MODE_SELECT, 0x00 }, /* Mode Select */ 163 164 /* To Access Addresses 3000-5fff, send the following commands */ 165 { CCI_REG8(0x30eb), 0x0c }, 166 { CCI_REG8(0x30eb), 0x05 }, 167 { CCI_REG8(0x300a), 0xff }, 168 { CCI_REG8(0x300b), 0xff }, 169 { CCI_REG8(0x30eb), 0x05 }, 170 { CCI_REG8(0x30eb), 0x09 }, 171 172 /* PLL Clock Table */ 173 { IMX219_REG_VTPXCK_DIV, 5 }, 174 { IMX219_REG_VTSYCK_DIV, 1 }, 175 { IMX219_REG_PREPLLCK_VT_DIV, 3 }, /* 0x03 = AUTO set */ 176 { IMX219_REG_PREPLLCK_OP_DIV, 3 }, /* 0x03 = AUTO set */ 177 { IMX219_REG_PLL_VT_MPY, 57 }, 178 { IMX219_REG_OPSYCK_DIV, 1 }, 179 { IMX219_REG_PLL_OP_MPY, 114 }, 180 181 /* Undocumented registers */ 182 { CCI_REG8(0x455e), 0x00 }, 183 { CCI_REG8(0x471e), 0x4b }, 184 { CCI_REG8(0x4767), 0x0f }, 185 { CCI_REG8(0x4750), 0x14 }, 186 { CCI_REG8(0x4540), 0x00 }, 187 { CCI_REG8(0x47b4), 0x14 }, 188 { CCI_REG8(0x4713), 0x30 }, 189 { CCI_REG8(0x478b), 0x10 }, 190 { CCI_REG8(0x478f), 0x10 }, 191 { CCI_REG8(0x4793), 0x10 }, 192 { CCI_REG8(0x4797), 0x0e }, 193 { CCI_REG8(0x479b), 0x0e }, 194 195 /* Frame Bank Register Group "A" */ 196 { IMX219_REG_LINE_LENGTH_A, 3448 }, 197 { IMX219_REG_X_ODD_INC_A, 1 }, 198 { IMX219_REG_Y_ODD_INC_A, 1 }, 199 200 /* Output setup registers */ 201 { IMX219_REG_DPHY_CTRL, IMX219_DPHY_CTRL_TIMING_AUTO }, 202 { IMX219_REG_EXCK_FREQ, IMX219_EXCK_FREQ(IMX219_XCLK_FREQ / 1000000) }, 203 }; 204 205 static const s64 imx219_link_freq_menu[] = { 206 IMX219_DEFAULT_LINK_FREQ, 207 }; 208 209 static const s64 imx219_link_freq_4lane_menu[] = { 210 IMX219_DEFAULT_LINK_FREQ_4LANE, 211 }; 212 213 static const char * const imx219_test_pattern_menu[] = { 214 "Disabled", 215 "Color Bars", 216 "Solid Color", 217 "Grey Color Bars", 218 "PN9" 219 }; 220 221 static const int imx219_test_pattern_val[] = { 222 IMX219_TEST_PATTERN_DISABLE, 223 IMX219_TEST_PATTERN_COLOR_BARS, 224 IMX219_TEST_PATTERN_SOLID_COLOR, 225 IMX219_TEST_PATTERN_GREY_COLOR, 226 IMX219_TEST_PATTERN_PN9, 227 }; 228 229 /* regulator supplies */ 230 static const char * const imx219_supply_name[] = { 231 /* Supplies can be enabled in any order */ 232 "VANA", /* Analog (2.8V) supply */ 233 "VDIG", /* Digital Core (1.8V) supply */ 234 "VDDL", /* IF (1.2V) supply */ 235 }; 236 237 #define IMX219_NUM_SUPPLIES ARRAY_SIZE(imx219_supply_name) 238 239 /* 240 * The supported formats. 241 * This table MUST contain 4 entries per format, to cover the various flip 242 * combinations in the order 243 * - no flip 244 * - h flip 245 * - v flip 246 * - h&v flips 247 */ 248 static const u32 imx219_mbus_formats[] = { 249 MEDIA_BUS_FMT_SRGGB10_1X10, 250 MEDIA_BUS_FMT_SGRBG10_1X10, 251 MEDIA_BUS_FMT_SGBRG10_1X10, 252 MEDIA_BUS_FMT_SBGGR10_1X10, 253 254 MEDIA_BUS_FMT_SRGGB8_1X8, 255 MEDIA_BUS_FMT_SGRBG8_1X8, 256 MEDIA_BUS_FMT_SGBRG8_1X8, 257 MEDIA_BUS_FMT_SBGGR8_1X8, 258 }; 259 260 /* 261 * Initialisation delay between XCLR low->high and the moment when the sensor 262 * can start capture (i.e. can leave software stanby) must be not less than: 263 * t4 + max(t5, t6 + <time to initialize the sensor register over I2C>) 264 * where 265 * t4 is fixed, and is max 200uS, 266 * t5 is fixed, and is 6000uS, 267 * t6 depends on the sensor external clock, and is max 32000 clock periods. 268 * As per sensor datasheet, the external clock must be from 6MHz to 27MHz. 269 * So for any acceptable external clock t6 is always within the range of 270 * 1185 to 5333 uS, and is always less than t5. 271 * For this reason this is always safe to wait (t4 + t5) = 6200 uS, then 272 * initialize the sensor over I2C, and then exit the software standby. 273 * 274 * This start-up time can be optimized a bit more, if we start the writes 275 * over I2C after (t4+t6), but before (t4+t5) expires. But then sensor 276 * initialization over I2C may complete before (t4+t5) expires, and we must 277 * ensure that capture is not started before (t4+t5). 278 * 279 * This delay doesn't account for the power supply startup time. If needed, 280 * this should be taken care of via the regulator framework. E.g. in the 281 * case of DT for regulator-fixed one should define the startup-delay-us 282 * property. 283 */ 284 #define IMX219_XCLR_MIN_DELAY_US 6200 285 #define IMX219_XCLR_DELAY_RANGE_US 1000 286 287 /* Mode configs */ 288 static const struct imx219_mode supported_modes[] = { 289 { 290 /* 8MPix 15fps mode */ 291 .width = 3280, 292 .height = 2464, 293 .vts_def = 3526, 294 }, 295 { 296 /* 1080P 30fps cropped */ 297 .width = 1920, 298 .height = 1080, 299 .vts_def = 1763, 300 }, 301 { 302 /* 2x2 binned 30fps mode */ 303 .width = 1640, 304 .height = 1232, 305 .vts_def = 1763, 306 }, 307 { 308 /* 640x480 30fps mode */ 309 .width = 640, 310 .height = 480, 311 .vts_def = 1763, 312 }, 313 }; 314 315 struct imx219 { 316 struct v4l2_subdev sd; 317 struct media_pad pad; 318 319 struct regmap *regmap; 320 struct clk *xclk; /* system clock to IMX219 */ 321 u32 xclk_freq; 322 323 struct gpio_desc *reset_gpio; 324 struct regulator_bulk_data supplies[IMX219_NUM_SUPPLIES]; 325 326 struct v4l2_ctrl_handler ctrl_handler; 327 /* V4L2 Controls */ 328 struct v4l2_ctrl *pixel_rate; 329 struct v4l2_ctrl *link_freq; 330 struct v4l2_ctrl *exposure; 331 struct v4l2_ctrl *vflip; 332 struct v4l2_ctrl *hflip; 333 struct v4l2_ctrl *vblank; 334 struct v4l2_ctrl *hblank; 335 336 /* Two or Four lanes */ 337 u8 lanes; 338 }; 339 340 static inline struct imx219 *to_imx219(struct v4l2_subdev *_sd) 341 { 342 return container_of(_sd, struct imx219, sd); 343 } 344 345 /* Get bayer order based on flip setting. */ 346 static u32 imx219_get_format_code(struct imx219 *imx219, u32 code) 347 { 348 unsigned int i; 349 350 for (i = 0; i < ARRAY_SIZE(imx219_mbus_formats); i++) 351 if (imx219_mbus_formats[i] == code) 352 break; 353 354 if (i >= ARRAY_SIZE(imx219_mbus_formats)) 355 i = 0; 356 357 i = (i & ~3) | (imx219->vflip->val ? 2 : 0) | 358 (imx219->hflip->val ? 1 : 0); 359 360 return imx219_mbus_formats[i]; 361 } 362 363 /* ----------------------------------------------------------------------------- 364 * Controls 365 */ 366 367 static int imx219_set_ctrl(struct v4l2_ctrl *ctrl) 368 { 369 struct imx219 *imx219 = 370 container_of(ctrl->handler, struct imx219, ctrl_handler); 371 struct i2c_client *client = v4l2_get_subdevdata(&imx219->sd); 372 const struct v4l2_mbus_framefmt *format; 373 struct v4l2_subdev_state *state; 374 int ret = 0; 375 376 state = v4l2_subdev_get_locked_active_state(&imx219->sd); 377 format = v4l2_subdev_state_get_format(state, 0); 378 379 if (ctrl->id == V4L2_CID_VBLANK) { 380 int exposure_max, exposure_def; 381 382 /* Update max exposure while meeting expected vblanking */ 383 exposure_max = format->height + ctrl->val - 4; 384 exposure_def = (exposure_max < IMX219_EXPOSURE_DEFAULT) ? 385 exposure_max : IMX219_EXPOSURE_DEFAULT; 386 __v4l2_ctrl_modify_range(imx219->exposure, 387 imx219->exposure->minimum, 388 exposure_max, imx219->exposure->step, 389 exposure_def); 390 } 391 392 /* 393 * Applying V4L2 control value only happens 394 * when power is up for streaming 395 */ 396 if (pm_runtime_get_if_in_use(&client->dev) == 0) 397 return 0; 398 399 switch (ctrl->id) { 400 case V4L2_CID_ANALOGUE_GAIN: 401 cci_write(imx219->regmap, IMX219_REG_ANALOG_GAIN, 402 ctrl->val, &ret); 403 break; 404 case V4L2_CID_EXPOSURE: 405 cci_write(imx219->regmap, IMX219_REG_EXPOSURE, 406 ctrl->val, &ret); 407 break; 408 case V4L2_CID_DIGITAL_GAIN: 409 cci_write(imx219->regmap, IMX219_REG_DIGITAL_GAIN, 410 ctrl->val, &ret); 411 break; 412 case V4L2_CID_TEST_PATTERN: 413 cci_write(imx219->regmap, IMX219_REG_TEST_PATTERN, 414 imx219_test_pattern_val[ctrl->val], &ret); 415 break; 416 case V4L2_CID_HFLIP: 417 case V4L2_CID_VFLIP: 418 cci_write(imx219->regmap, IMX219_REG_ORIENTATION, 419 imx219->hflip->val | imx219->vflip->val << 1, &ret); 420 break; 421 case V4L2_CID_VBLANK: 422 cci_write(imx219->regmap, IMX219_REG_VTS, 423 format->height + ctrl->val, &ret); 424 break; 425 case V4L2_CID_TEST_PATTERN_RED: 426 cci_write(imx219->regmap, IMX219_REG_TESTP_RED, 427 ctrl->val, &ret); 428 break; 429 case V4L2_CID_TEST_PATTERN_GREENR: 430 cci_write(imx219->regmap, IMX219_REG_TESTP_GREENR, 431 ctrl->val, &ret); 432 break; 433 case V4L2_CID_TEST_PATTERN_BLUE: 434 cci_write(imx219->regmap, IMX219_REG_TESTP_BLUE, 435 ctrl->val, &ret); 436 break; 437 case V4L2_CID_TEST_PATTERN_GREENB: 438 cci_write(imx219->regmap, IMX219_REG_TESTP_GREENB, 439 ctrl->val, &ret); 440 break; 441 default: 442 dev_info(&client->dev, 443 "ctrl(id:0x%x,val:0x%x) is not handled\n", 444 ctrl->id, ctrl->val); 445 ret = -EINVAL; 446 break; 447 } 448 449 pm_runtime_put(&client->dev); 450 451 return ret; 452 } 453 454 static const struct v4l2_ctrl_ops imx219_ctrl_ops = { 455 .s_ctrl = imx219_set_ctrl, 456 }; 457 458 static unsigned long imx219_get_pixel_rate(struct imx219 *imx219) 459 { 460 return (imx219->lanes == 2) ? IMX219_PIXEL_RATE : IMX219_PIXEL_RATE_4LANE; 461 } 462 463 /* Initialize control handlers */ 464 static int imx219_init_controls(struct imx219 *imx219) 465 { 466 struct i2c_client *client = v4l2_get_subdevdata(&imx219->sd); 467 const struct imx219_mode *mode = &supported_modes[0]; 468 struct v4l2_ctrl_handler *ctrl_hdlr; 469 struct v4l2_fwnode_device_properties props; 470 int exposure_max, exposure_def, hblank; 471 int i, ret; 472 473 ctrl_hdlr = &imx219->ctrl_handler; 474 ret = v4l2_ctrl_handler_init(ctrl_hdlr, 12); 475 if (ret) 476 return ret; 477 478 /* By default, PIXEL_RATE is read only */ 479 imx219->pixel_rate = v4l2_ctrl_new_std(ctrl_hdlr, &imx219_ctrl_ops, 480 V4L2_CID_PIXEL_RATE, 481 imx219_get_pixel_rate(imx219), 482 imx219_get_pixel_rate(imx219), 1, 483 imx219_get_pixel_rate(imx219)); 484 485 imx219->link_freq = 486 v4l2_ctrl_new_int_menu(ctrl_hdlr, &imx219_ctrl_ops, 487 V4L2_CID_LINK_FREQ, 488 ARRAY_SIZE(imx219_link_freq_menu) - 1, 0, 489 (imx219->lanes == 2) ? imx219_link_freq_menu : 490 imx219_link_freq_4lane_menu); 491 if (imx219->link_freq) 492 imx219->link_freq->flags |= V4L2_CTRL_FLAG_READ_ONLY; 493 494 /* Initial vblank/hblank/exposure parameters based on current mode */ 495 imx219->vblank = v4l2_ctrl_new_std(ctrl_hdlr, &imx219_ctrl_ops, 496 V4L2_CID_VBLANK, IMX219_VBLANK_MIN, 497 IMX219_VTS_MAX - mode->height, 1, 498 mode->vts_def - mode->height); 499 hblank = IMX219_PPL_DEFAULT - mode->width; 500 imx219->hblank = v4l2_ctrl_new_std(ctrl_hdlr, &imx219_ctrl_ops, 501 V4L2_CID_HBLANK, hblank, hblank, 502 1, hblank); 503 if (imx219->hblank) 504 imx219->hblank->flags |= V4L2_CTRL_FLAG_READ_ONLY; 505 exposure_max = mode->vts_def - 4; 506 exposure_def = (exposure_max < IMX219_EXPOSURE_DEFAULT) ? 507 exposure_max : IMX219_EXPOSURE_DEFAULT; 508 imx219->exposure = v4l2_ctrl_new_std(ctrl_hdlr, &imx219_ctrl_ops, 509 V4L2_CID_EXPOSURE, 510 IMX219_EXPOSURE_MIN, exposure_max, 511 IMX219_EXPOSURE_STEP, 512 exposure_def); 513 514 v4l2_ctrl_new_std(ctrl_hdlr, &imx219_ctrl_ops, V4L2_CID_ANALOGUE_GAIN, 515 IMX219_ANA_GAIN_MIN, IMX219_ANA_GAIN_MAX, 516 IMX219_ANA_GAIN_STEP, IMX219_ANA_GAIN_DEFAULT); 517 518 v4l2_ctrl_new_std(ctrl_hdlr, &imx219_ctrl_ops, V4L2_CID_DIGITAL_GAIN, 519 IMX219_DGTL_GAIN_MIN, IMX219_DGTL_GAIN_MAX, 520 IMX219_DGTL_GAIN_STEP, IMX219_DGTL_GAIN_DEFAULT); 521 522 imx219->hflip = v4l2_ctrl_new_std(ctrl_hdlr, &imx219_ctrl_ops, 523 V4L2_CID_HFLIP, 0, 1, 1, 0); 524 if (imx219->hflip) 525 imx219->hflip->flags |= V4L2_CTRL_FLAG_MODIFY_LAYOUT; 526 527 imx219->vflip = v4l2_ctrl_new_std(ctrl_hdlr, &imx219_ctrl_ops, 528 V4L2_CID_VFLIP, 0, 1, 1, 0); 529 if (imx219->vflip) 530 imx219->vflip->flags |= V4L2_CTRL_FLAG_MODIFY_LAYOUT; 531 532 v4l2_ctrl_new_std_menu_items(ctrl_hdlr, &imx219_ctrl_ops, 533 V4L2_CID_TEST_PATTERN, 534 ARRAY_SIZE(imx219_test_pattern_menu) - 1, 535 0, 0, imx219_test_pattern_menu); 536 for (i = 0; i < 4; i++) { 537 /* 538 * The assumption is that 539 * V4L2_CID_TEST_PATTERN_GREENR == V4L2_CID_TEST_PATTERN_RED + 1 540 * V4L2_CID_TEST_PATTERN_BLUE == V4L2_CID_TEST_PATTERN_RED + 2 541 * V4L2_CID_TEST_PATTERN_GREENB == V4L2_CID_TEST_PATTERN_RED + 3 542 */ 543 v4l2_ctrl_new_std(ctrl_hdlr, &imx219_ctrl_ops, 544 V4L2_CID_TEST_PATTERN_RED + i, 545 IMX219_TESTP_COLOUR_MIN, 546 IMX219_TESTP_COLOUR_MAX, 547 IMX219_TESTP_COLOUR_STEP, 548 IMX219_TESTP_COLOUR_MAX); 549 /* The "Solid color" pattern is white by default */ 550 } 551 552 if (ctrl_hdlr->error) { 553 ret = ctrl_hdlr->error; 554 dev_err(&client->dev, "%s control init failed (%d)\n", 555 __func__, ret); 556 goto error; 557 } 558 559 ret = v4l2_fwnode_device_parse(&client->dev, &props); 560 if (ret) 561 goto error; 562 563 ret = v4l2_ctrl_new_fwnode_properties(ctrl_hdlr, &imx219_ctrl_ops, 564 &props); 565 if (ret) 566 goto error; 567 568 imx219->sd.ctrl_handler = ctrl_hdlr; 569 570 return 0; 571 572 error: 573 v4l2_ctrl_handler_free(ctrl_hdlr); 574 575 return ret; 576 } 577 578 static void imx219_free_controls(struct imx219 *imx219) 579 { 580 v4l2_ctrl_handler_free(imx219->sd.ctrl_handler); 581 } 582 583 /* ----------------------------------------------------------------------------- 584 * Subdev operations 585 */ 586 587 static int imx219_set_framefmt(struct imx219 *imx219, 588 struct v4l2_subdev_state *state) 589 { 590 const struct v4l2_mbus_framefmt *format; 591 const struct v4l2_rect *crop; 592 unsigned int bpp; 593 u64 bin_h, bin_v; 594 int ret = 0; 595 596 format = v4l2_subdev_state_get_format(state, 0); 597 crop = v4l2_subdev_state_get_crop(state, 0); 598 599 switch (format->code) { 600 case MEDIA_BUS_FMT_SRGGB8_1X8: 601 case MEDIA_BUS_FMT_SGRBG8_1X8: 602 case MEDIA_BUS_FMT_SGBRG8_1X8: 603 case MEDIA_BUS_FMT_SBGGR8_1X8: 604 bpp = 8; 605 break; 606 607 case MEDIA_BUS_FMT_SRGGB10_1X10: 608 case MEDIA_BUS_FMT_SGRBG10_1X10: 609 case MEDIA_BUS_FMT_SGBRG10_1X10: 610 case MEDIA_BUS_FMT_SBGGR10_1X10: 611 default: 612 bpp = 10; 613 break; 614 } 615 616 cci_write(imx219->regmap, IMX219_REG_X_ADD_STA_A, 617 crop->left - IMX219_PIXEL_ARRAY_LEFT, &ret); 618 cci_write(imx219->regmap, IMX219_REG_X_ADD_END_A, 619 crop->left - IMX219_PIXEL_ARRAY_LEFT + crop->width - 1, &ret); 620 cci_write(imx219->regmap, IMX219_REG_Y_ADD_STA_A, 621 crop->top - IMX219_PIXEL_ARRAY_TOP, &ret); 622 cci_write(imx219->regmap, IMX219_REG_Y_ADD_END_A, 623 crop->top - IMX219_PIXEL_ARRAY_TOP + crop->height - 1, &ret); 624 625 switch (crop->width / format->width) { 626 case 1: 627 default: 628 bin_h = IMX219_BINNING_NONE; 629 break; 630 case 2: 631 bin_h = bpp == 8 ? IMX219_BINNING_X2_ANALOG : IMX219_BINNING_X2; 632 break; 633 } 634 635 switch (crop->height / format->height) { 636 case 1: 637 default: 638 bin_v = IMX219_BINNING_NONE; 639 break; 640 case 2: 641 bin_v = bpp == 8 ? IMX219_BINNING_X2_ANALOG : IMX219_BINNING_X2; 642 break; 643 } 644 645 cci_write(imx219->regmap, IMX219_REG_BINNING_MODE_H, bin_h, &ret); 646 cci_write(imx219->regmap, IMX219_REG_BINNING_MODE_V, bin_v, &ret); 647 648 cci_write(imx219->regmap, IMX219_REG_X_OUTPUT_SIZE, 649 format->width, &ret); 650 cci_write(imx219->regmap, IMX219_REG_Y_OUTPUT_SIZE, 651 format->height, &ret); 652 653 cci_write(imx219->regmap, IMX219_REG_TP_WINDOW_WIDTH, 654 format->width, &ret); 655 cci_write(imx219->regmap, IMX219_REG_TP_WINDOW_HEIGHT, 656 format->height, &ret); 657 658 cci_write(imx219->regmap, IMX219_REG_CSI_DATA_FORMAT_A, 659 (bpp << 8) | bpp, &ret); 660 cci_write(imx219->regmap, IMX219_REG_OPPXCK_DIV, bpp, &ret); 661 662 return ret; 663 } 664 665 static int imx219_configure_lanes(struct imx219 *imx219) 666 { 667 return cci_write(imx219->regmap, IMX219_REG_CSI_LANE_MODE, 668 imx219->lanes == 2 ? IMX219_CSI_2_LANE_MODE : 669 IMX219_CSI_4_LANE_MODE, NULL); 670 }; 671 672 static int imx219_start_streaming(struct imx219 *imx219, 673 struct v4l2_subdev_state *state) 674 { 675 struct i2c_client *client = v4l2_get_subdevdata(&imx219->sd); 676 int ret; 677 678 ret = pm_runtime_resume_and_get(&client->dev); 679 if (ret < 0) 680 return ret; 681 682 /* Send all registers that are common to all modes */ 683 ret = cci_multi_reg_write(imx219->regmap, imx219_common_regs, 684 ARRAY_SIZE(imx219_common_regs), NULL); 685 if (ret) { 686 dev_err(&client->dev, "%s failed to send mfg header\n", __func__); 687 goto err_rpm_put; 688 } 689 690 /* Configure two or four Lane mode */ 691 ret = imx219_configure_lanes(imx219); 692 if (ret) { 693 dev_err(&client->dev, "%s failed to configure lanes\n", __func__); 694 goto err_rpm_put; 695 } 696 697 /* Apply format and crop settings. */ 698 ret = imx219_set_framefmt(imx219, state); 699 if (ret) { 700 dev_err(&client->dev, "%s failed to set frame format: %d\n", 701 __func__, ret); 702 goto err_rpm_put; 703 } 704 705 /* Apply customized values from user */ 706 ret = __v4l2_ctrl_handler_setup(imx219->sd.ctrl_handler); 707 if (ret) 708 goto err_rpm_put; 709 710 /* set stream on register */ 711 ret = cci_write(imx219->regmap, IMX219_REG_MODE_SELECT, 712 IMX219_MODE_STREAMING, NULL); 713 if (ret) 714 goto err_rpm_put; 715 716 /* vflip and hflip cannot change during streaming */ 717 __v4l2_ctrl_grab(imx219->vflip, true); 718 __v4l2_ctrl_grab(imx219->hflip, true); 719 720 return 0; 721 722 err_rpm_put: 723 pm_runtime_put(&client->dev); 724 return ret; 725 } 726 727 static void imx219_stop_streaming(struct imx219 *imx219) 728 { 729 struct i2c_client *client = v4l2_get_subdevdata(&imx219->sd); 730 int ret; 731 732 /* set stream off register */ 733 ret = cci_write(imx219->regmap, IMX219_REG_MODE_SELECT, 734 IMX219_MODE_STANDBY, NULL); 735 if (ret) 736 dev_err(&client->dev, "%s failed to set stream\n", __func__); 737 738 __v4l2_ctrl_grab(imx219->vflip, false); 739 __v4l2_ctrl_grab(imx219->hflip, false); 740 741 pm_runtime_put(&client->dev); 742 } 743 744 static int imx219_set_stream(struct v4l2_subdev *sd, int enable) 745 { 746 struct imx219 *imx219 = to_imx219(sd); 747 struct v4l2_subdev_state *state; 748 int ret = 0; 749 750 state = v4l2_subdev_lock_and_get_active_state(sd); 751 752 if (enable) 753 ret = imx219_start_streaming(imx219, state); 754 else 755 imx219_stop_streaming(imx219); 756 757 v4l2_subdev_unlock_state(state); 758 return ret; 759 } 760 761 static void imx219_update_pad_format(struct imx219 *imx219, 762 const struct imx219_mode *mode, 763 struct v4l2_mbus_framefmt *fmt, u32 code) 764 { 765 /* Bayer order varies with flips */ 766 fmt->code = imx219_get_format_code(imx219, code); 767 fmt->width = mode->width; 768 fmt->height = mode->height; 769 fmt->field = V4L2_FIELD_NONE; 770 fmt->colorspace = V4L2_COLORSPACE_RAW; 771 fmt->ycbcr_enc = V4L2_YCBCR_ENC_601; 772 fmt->quantization = V4L2_QUANTIZATION_FULL_RANGE; 773 fmt->xfer_func = V4L2_XFER_FUNC_NONE; 774 } 775 776 static int imx219_enum_mbus_code(struct v4l2_subdev *sd, 777 struct v4l2_subdev_state *state, 778 struct v4l2_subdev_mbus_code_enum *code) 779 { 780 struct imx219 *imx219 = to_imx219(sd); 781 782 if (code->index >= (ARRAY_SIZE(imx219_mbus_formats) / 4)) 783 return -EINVAL; 784 785 code->code = imx219_get_format_code(imx219, imx219_mbus_formats[code->index * 4]); 786 787 return 0; 788 } 789 790 static int imx219_enum_frame_size(struct v4l2_subdev *sd, 791 struct v4l2_subdev_state *state, 792 struct v4l2_subdev_frame_size_enum *fse) 793 { 794 struct imx219 *imx219 = to_imx219(sd); 795 u32 code; 796 797 if (fse->index >= ARRAY_SIZE(supported_modes)) 798 return -EINVAL; 799 800 code = imx219_get_format_code(imx219, fse->code); 801 if (fse->code != code) 802 return -EINVAL; 803 804 fse->min_width = supported_modes[fse->index].width; 805 fse->max_width = fse->min_width; 806 fse->min_height = supported_modes[fse->index].height; 807 fse->max_height = fse->min_height; 808 809 return 0; 810 } 811 812 static int imx219_set_pad_format(struct v4l2_subdev *sd, 813 struct v4l2_subdev_state *state, 814 struct v4l2_subdev_format *fmt) 815 { 816 struct imx219 *imx219 = to_imx219(sd); 817 const struct imx219_mode *mode; 818 struct v4l2_mbus_framefmt *format; 819 struct v4l2_rect *crop; 820 unsigned int bin_h, bin_v; 821 822 mode = v4l2_find_nearest_size(supported_modes, 823 ARRAY_SIZE(supported_modes), 824 width, height, 825 fmt->format.width, fmt->format.height); 826 827 imx219_update_pad_format(imx219, mode, &fmt->format, fmt->format.code); 828 829 format = v4l2_subdev_state_get_format(state, 0); 830 *format = fmt->format; 831 832 /* 833 * Use binning to maximize the crop rectangle size, and centre it in the 834 * sensor. 835 */ 836 bin_h = min(IMX219_PIXEL_ARRAY_WIDTH / format->width, 2U); 837 bin_v = min(IMX219_PIXEL_ARRAY_HEIGHT / format->height, 2U); 838 839 crop = v4l2_subdev_state_get_crop(state, 0); 840 crop->width = format->width * bin_h; 841 crop->height = format->height * bin_v; 842 crop->left = (IMX219_NATIVE_WIDTH - crop->width) / 2; 843 crop->top = (IMX219_NATIVE_HEIGHT - crop->height) / 2; 844 845 if (fmt->which == V4L2_SUBDEV_FORMAT_ACTIVE) { 846 int exposure_max; 847 int exposure_def; 848 int hblank; 849 850 /* Update limits and set FPS to default */ 851 __v4l2_ctrl_modify_range(imx219->vblank, IMX219_VBLANK_MIN, 852 IMX219_VTS_MAX - mode->height, 1, 853 mode->vts_def - mode->height); 854 __v4l2_ctrl_s_ctrl(imx219->vblank, 855 mode->vts_def - mode->height); 856 /* Update max exposure while meeting expected vblanking */ 857 exposure_max = mode->vts_def - 4; 858 exposure_def = (exposure_max < IMX219_EXPOSURE_DEFAULT) ? 859 exposure_max : IMX219_EXPOSURE_DEFAULT; 860 __v4l2_ctrl_modify_range(imx219->exposure, 861 imx219->exposure->minimum, 862 exposure_max, imx219->exposure->step, 863 exposure_def); 864 /* 865 * Currently PPL is fixed to IMX219_PPL_DEFAULT, so hblank 866 * depends on mode->width only, and is not changeble in any 867 * way other than changing the mode. 868 */ 869 hblank = IMX219_PPL_DEFAULT - mode->width; 870 __v4l2_ctrl_modify_range(imx219->hblank, hblank, hblank, 1, 871 hblank); 872 } 873 874 return 0; 875 } 876 877 static int imx219_get_selection(struct v4l2_subdev *sd, 878 struct v4l2_subdev_state *state, 879 struct v4l2_subdev_selection *sel) 880 { 881 switch (sel->target) { 882 case V4L2_SEL_TGT_CROP: { 883 sel->r = *v4l2_subdev_state_get_crop(state, 0); 884 return 0; 885 } 886 887 case V4L2_SEL_TGT_NATIVE_SIZE: 888 sel->r.top = 0; 889 sel->r.left = 0; 890 sel->r.width = IMX219_NATIVE_WIDTH; 891 sel->r.height = IMX219_NATIVE_HEIGHT; 892 893 return 0; 894 895 case V4L2_SEL_TGT_CROP_DEFAULT: 896 case V4L2_SEL_TGT_CROP_BOUNDS: 897 sel->r.top = IMX219_PIXEL_ARRAY_TOP; 898 sel->r.left = IMX219_PIXEL_ARRAY_LEFT; 899 sel->r.width = IMX219_PIXEL_ARRAY_WIDTH; 900 sel->r.height = IMX219_PIXEL_ARRAY_HEIGHT; 901 902 return 0; 903 } 904 905 return -EINVAL; 906 } 907 908 static int imx219_init_state(struct v4l2_subdev *sd, 909 struct v4l2_subdev_state *state) 910 { 911 struct v4l2_subdev_format fmt = { 912 .which = V4L2_SUBDEV_FORMAT_TRY, 913 .pad = 0, 914 .format = { 915 .code = MEDIA_BUS_FMT_SRGGB10_1X10, 916 .width = supported_modes[0].width, 917 .height = supported_modes[0].height, 918 }, 919 }; 920 921 imx219_set_pad_format(sd, state, &fmt); 922 923 return 0; 924 } 925 926 static const struct v4l2_subdev_core_ops imx219_core_ops = { 927 .subscribe_event = v4l2_ctrl_subdev_subscribe_event, 928 .unsubscribe_event = v4l2_event_subdev_unsubscribe, 929 }; 930 931 static const struct v4l2_subdev_video_ops imx219_video_ops = { 932 .s_stream = imx219_set_stream, 933 }; 934 935 static const struct v4l2_subdev_pad_ops imx219_pad_ops = { 936 .enum_mbus_code = imx219_enum_mbus_code, 937 .get_fmt = v4l2_subdev_get_fmt, 938 .set_fmt = imx219_set_pad_format, 939 .get_selection = imx219_get_selection, 940 .enum_frame_size = imx219_enum_frame_size, 941 }; 942 943 static const struct v4l2_subdev_ops imx219_subdev_ops = { 944 .core = &imx219_core_ops, 945 .video = &imx219_video_ops, 946 .pad = &imx219_pad_ops, 947 }; 948 949 static const struct v4l2_subdev_internal_ops imx219_internal_ops = { 950 .init_state = imx219_init_state, 951 }; 952 953 /* ----------------------------------------------------------------------------- 954 * Power management 955 */ 956 957 static int imx219_power_on(struct device *dev) 958 { 959 struct v4l2_subdev *sd = dev_get_drvdata(dev); 960 struct imx219 *imx219 = to_imx219(sd); 961 int ret; 962 963 ret = regulator_bulk_enable(IMX219_NUM_SUPPLIES, 964 imx219->supplies); 965 if (ret) { 966 dev_err(dev, "%s: failed to enable regulators\n", 967 __func__); 968 return ret; 969 } 970 971 ret = clk_prepare_enable(imx219->xclk); 972 if (ret) { 973 dev_err(dev, "%s: failed to enable clock\n", 974 __func__); 975 goto reg_off; 976 } 977 978 gpiod_set_value_cansleep(imx219->reset_gpio, 1); 979 usleep_range(IMX219_XCLR_MIN_DELAY_US, 980 IMX219_XCLR_MIN_DELAY_US + IMX219_XCLR_DELAY_RANGE_US); 981 982 return 0; 983 984 reg_off: 985 regulator_bulk_disable(IMX219_NUM_SUPPLIES, imx219->supplies); 986 987 return ret; 988 } 989 990 static int imx219_power_off(struct device *dev) 991 { 992 struct v4l2_subdev *sd = dev_get_drvdata(dev); 993 struct imx219 *imx219 = to_imx219(sd); 994 995 gpiod_set_value_cansleep(imx219->reset_gpio, 0); 996 regulator_bulk_disable(IMX219_NUM_SUPPLIES, imx219->supplies); 997 clk_disable_unprepare(imx219->xclk); 998 999 return 0; 1000 } 1001 1002 /* ----------------------------------------------------------------------------- 1003 * Probe & remove 1004 */ 1005 1006 static int imx219_get_regulators(struct imx219 *imx219) 1007 { 1008 struct i2c_client *client = v4l2_get_subdevdata(&imx219->sd); 1009 unsigned int i; 1010 1011 for (i = 0; i < IMX219_NUM_SUPPLIES; i++) 1012 imx219->supplies[i].supply = imx219_supply_name[i]; 1013 1014 return devm_regulator_bulk_get(&client->dev, 1015 IMX219_NUM_SUPPLIES, 1016 imx219->supplies); 1017 } 1018 1019 /* Verify chip ID */ 1020 static int imx219_identify_module(struct imx219 *imx219) 1021 { 1022 struct i2c_client *client = v4l2_get_subdevdata(&imx219->sd); 1023 int ret; 1024 u64 val; 1025 1026 ret = cci_read(imx219->regmap, IMX219_REG_CHIP_ID, &val, NULL); 1027 if (ret) { 1028 dev_err(&client->dev, "failed to read chip id %x\n", 1029 IMX219_CHIP_ID); 1030 return ret; 1031 } 1032 1033 if (val != IMX219_CHIP_ID) { 1034 dev_err(&client->dev, "chip id mismatch: %x!=%llx\n", 1035 IMX219_CHIP_ID, val); 1036 return -EIO; 1037 } 1038 1039 return 0; 1040 } 1041 1042 static int imx219_check_hwcfg(struct device *dev, struct imx219 *imx219) 1043 { 1044 struct fwnode_handle *endpoint; 1045 struct v4l2_fwnode_endpoint ep_cfg = { 1046 .bus_type = V4L2_MBUS_CSI2_DPHY 1047 }; 1048 int ret = -EINVAL; 1049 1050 endpoint = fwnode_graph_get_next_endpoint(dev_fwnode(dev), NULL); 1051 if (!endpoint) { 1052 dev_err(dev, "endpoint node not found\n"); 1053 return -EINVAL; 1054 } 1055 1056 if (v4l2_fwnode_endpoint_alloc_parse(endpoint, &ep_cfg)) { 1057 dev_err(dev, "could not parse endpoint\n"); 1058 goto error_out; 1059 } 1060 1061 /* Check the number of MIPI CSI2 data lanes */ 1062 if (ep_cfg.bus.mipi_csi2.num_data_lanes != 2 && 1063 ep_cfg.bus.mipi_csi2.num_data_lanes != 4) { 1064 dev_err(dev, "only 2 or 4 data lanes are currently supported\n"); 1065 goto error_out; 1066 } 1067 imx219->lanes = ep_cfg.bus.mipi_csi2.num_data_lanes; 1068 1069 /* Check the link frequency set in device tree */ 1070 if (!ep_cfg.nr_of_link_frequencies) { 1071 dev_err(dev, "link-frequency property not found in DT\n"); 1072 goto error_out; 1073 } 1074 1075 if (ep_cfg.nr_of_link_frequencies != 1 || 1076 (ep_cfg.link_frequencies[0] != ((imx219->lanes == 2) ? 1077 IMX219_DEFAULT_LINK_FREQ : IMX219_DEFAULT_LINK_FREQ_4LANE))) { 1078 dev_err(dev, "Link frequency not supported: %lld\n", 1079 ep_cfg.link_frequencies[0]); 1080 goto error_out; 1081 } 1082 1083 ret = 0; 1084 1085 error_out: 1086 v4l2_fwnode_endpoint_free(&ep_cfg); 1087 fwnode_handle_put(endpoint); 1088 1089 return ret; 1090 } 1091 1092 static int imx219_probe(struct i2c_client *client) 1093 { 1094 struct device *dev = &client->dev; 1095 struct imx219 *imx219; 1096 int ret; 1097 1098 imx219 = devm_kzalloc(&client->dev, sizeof(*imx219), GFP_KERNEL); 1099 if (!imx219) 1100 return -ENOMEM; 1101 1102 v4l2_i2c_subdev_init(&imx219->sd, client, &imx219_subdev_ops); 1103 imx219->sd.internal_ops = &imx219_internal_ops; 1104 1105 /* Check the hardware configuration in device tree */ 1106 if (imx219_check_hwcfg(dev, imx219)) 1107 return -EINVAL; 1108 1109 imx219->regmap = devm_cci_regmap_init_i2c(client, 16); 1110 if (IS_ERR(imx219->regmap)) { 1111 ret = PTR_ERR(imx219->regmap); 1112 dev_err(dev, "failed to initialize CCI: %d\n", ret); 1113 return ret; 1114 } 1115 1116 /* Get system clock (xclk) */ 1117 imx219->xclk = devm_clk_get(dev, NULL); 1118 if (IS_ERR(imx219->xclk)) { 1119 dev_err(dev, "failed to get xclk\n"); 1120 return PTR_ERR(imx219->xclk); 1121 } 1122 1123 imx219->xclk_freq = clk_get_rate(imx219->xclk); 1124 if (imx219->xclk_freq != IMX219_XCLK_FREQ) { 1125 dev_err(dev, "xclk frequency not supported: %d Hz\n", 1126 imx219->xclk_freq); 1127 return -EINVAL; 1128 } 1129 1130 ret = imx219_get_regulators(imx219); 1131 if (ret) { 1132 dev_err(dev, "failed to get regulators\n"); 1133 return ret; 1134 } 1135 1136 /* Request optional enable pin */ 1137 imx219->reset_gpio = devm_gpiod_get_optional(dev, "reset", 1138 GPIOD_OUT_HIGH); 1139 1140 /* 1141 * The sensor must be powered for imx219_identify_module() 1142 * to be able to read the CHIP_ID register 1143 */ 1144 ret = imx219_power_on(dev); 1145 if (ret) 1146 return ret; 1147 1148 ret = imx219_identify_module(imx219); 1149 if (ret) 1150 goto error_power_off; 1151 1152 /* 1153 * Sensor doesn't enter LP-11 state upon power up until and unless 1154 * streaming is started, so upon power up switch the modes to: 1155 * streaming -> standby 1156 */ 1157 ret = cci_write(imx219->regmap, IMX219_REG_MODE_SELECT, 1158 IMX219_MODE_STREAMING, NULL); 1159 if (ret < 0) 1160 goto error_power_off; 1161 1162 usleep_range(100, 110); 1163 1164 /* put sensor back to standby mode */ 1165 ret = cci_write(imx219->regmap, IMX219_REG_MODE_SELECT, 1166 IMX219_MODE_STANDBY, NULL); 1167 if (ret < 0) 1168 goto error_power_off; 1169 1170 usleep_range(100, 110); 1171 1172 ret = imx219_init_controls(imx219); 1173 if (ret) 1174 goto error_power_off; 1175 1176 /* Initialize subdev */ 1177 imx219->sd.flags |= V4L2_SUBDEV_FL_HAS_DEVNODE | 1178 V4L2_SUBDEV_FL_HAS_EVENTS; 1179 imx219->sd.entity.function = MEDIA_ENT_F_CAM_SENSOR; 1180 1181 /* Initialize source pad */ 1182 imx219->pad.flags = MEDIA_PAD_FL_SOURCE; 1183 1184 ret = media_entity_pads_init(&imx219->sd.entity, 1, &imx219->pad); 1185 if (ret) { 1186 dev_err(dev, "failed to init entity pads: %d\n", ret); 1187 goto error_handler_free; 1188 } 1189 1190 imx219->sd.state_lock = imx219->ctrl_handler.lock; 1191 ret = v4l2_subdev_init_finalize(&imx219->sd); 1192 if (ret < 0) { 1193 dev_err(dev, "subdev init error: %d\n", ret); 1194 goto error_media_entity; 1195 } 1196 1197 ret = v4l2_async_register_subdev_sensor(&imx219->sd); 1198 if (ret < 0) { 1199 dev_err(dev, "failed to register sensor sub-device: %d\n", ret); 1200 goto error_subdev_cleanup; 1201 } 1202 1203 /* Enable runtime PM and turn off the device */ 1204 pm_runtime_set_active(dev); 1205 pm_runtime_enable(dev); 1206 pm_runtime_idle(dev); 1207 1208 return 0; 1209 1210 error_subdev_cleanup: 1211 v4l2_subdev_cleanup(&imx219->sd); 1212 1213 error_media_entity: 1214 media_entity_cleanup(&imx219->sd.entity); 1215 1216 error_handler_free: 1217 imx219_free_controls(imx219); 1218 1219 error_power_off: 1220 imx219_power_off(dev); 1221 1222 return ret; 1223 } 1224 1225 static void imx219_remove(struct i2c_client *client) 1226 { 1227 struct v4l2_subdev *sd = i2c_get_clientdata(client); 1228 struct imx219 *imx219 = to_imx219(sd); 1229 1230 v4l2_async_unregister_subdev(sd); 1231 v4l2_subdev_cleanup(sd); 1232 media_entity_cleanup(&sd->entity); 1233 imx219_free_controls(imx219); 1234 1235 pm_runtime_disable(&client->dev); 1236 if (!pm_runtime_status_suspended(&client->dev)) 1237 imx219_power_off(&client->dev); 1238 pm_runtime_set_suspended(&client->dev); 1239 } 1240 1241 static const struct of_device_id imx219_dt_ids[] = { 1242 { .compatible = "sony,imx219" }, 1243 { /* sentinel */ } 1244 }; 1245 MODULE_DEVICE_TABLE(of, imx219_dt_ids); 1246 1247 static const struct dev_pm_ops imx219_pm_ops = { 1248 SET_RUNTIME_PM_OPS(imx219_power_off, imx219_power_on, NULL) 1249 }; 1250 1251 static struct i2c_driver imx219_i2c_driver = { 1252 .driver = { 1253 .name = "imx219", 1254 .of_match_table = imx219_dt_ids, 1255 .pm = &imx219_pm_ops, 1256 }, 1257 .probe = imx219_probe, 1258 .remove = imx219_remove, 1259 }; 1260 1261 module_i2c_driver(imx219_i2c_driver); 1262 1263 MODULE_AUTHOR("Dave Stevenson <dave.stevenson@raspberrypi.com"); 1264 MODULE_DESCRIPTION("Sony IMX219 sensor driver"); 1265 MODULE_LICENSE("GPL v2"); 1266