1 // SPDX-License-Identifier: GPL-2.0 2 /* 3 * Sony IMX290 CMOS Image Sensor Driver 4 * 5 * Copyright (C) 2019 FRAMOS GmbH. 6 * 7 * Copyright (C) 2019 Linaro Ltd. 8 * Author: Manivannan Sadhasivam <manivannan.sadhasivam@linaro.org> 9 */ 10 11 #include <linux/clk.h> 12 #include <linux/delay.h> 13 #include <linux/gpio/consumer.h> 14 #include <linux/i2c.h> 15 #include <linux/module.h> 16 #include <linux/pm_runtime.h> 17 #include <linux/regmap.h> 18 #include <linux/regulator/consumer.h> 19 #include <media/media-entity.h> 20 #include <media/v4l2-ctrls.h> 21 #include <media/v4l2-device.h> 22 #include <media/v4l2-fwnode.h> 23 #include <media/v4l2-subdev.h> 24 25 #define IMX290_STANDBY 0x3000 26 #define IMX290_REGHOLD 0x3001 27 #define IMX290_XMSTA 0x3002 28 #define IMX290_FR_FDG_SEL 0x3009 29 #define IMX290_BLKLEVEL_LOW 0x300a 30 #define IMX290_BLKLEVEL_HIGH 0x300b 31 #define IMX290_GAIN 0x3014 32 #define IMX290_HMAX_LOW 0x301c 33 #define IMX290_HMAX_HIGH 0x301d 34 #define IMX290_PGCTRL 0x308c 35 #define IMX290_PHY_LANE_NUM 0x3407 36 #define IMX290_CSI_LANE_MODE 0x3443 37 38 #define IMX290_PGCTRL_REGEN BIT(0) 39 #define IMX290_PGCTRL_THRU BIT(1) 40 #define IMX290_PGCTRL_MODE(n) ((n) << 4) 41 42 static const char * const imx290_supply_name[] = { 43 "vdda", 44 "vddd", 45 "vdddo", 46 }; 47 48 #define IMX290_NUM_SUPPLIES ARRAY_SIZE(imx290_supply_name) 49 50 struct imx290_regval { 51 u16 reg; 52 u8 val; 53 }; 54 55 struct imx290_mode { 56 u32 width; 57 u32 height; 58 u32 hmax; 59 u8 link_freq_index; 60 61 const struct imx290_regval *data; 62 u32 data_size; 63 }; 64 65 struct imx290 { 66 struct device *dev; 67 struct clk *xclk; 68 struct regmap *regmap; 69 u8 nlanes; 70 u8 bpp; 71 72 struct v4l2_subdev sd; 73 struct media_pad pad; 74 struct v4l2_mbus_framefmt current_format; 75 const struct imx290_mode *current_mode; 76 77 struct regulator_bulk_data supplies[IMX290_NUM_SUPPLIES]; 78 struct gpio_desc *rst_gpio; 79 80 struct v4l2_ctrl_handler ctrls; 81 struct v4l2_ctrl *link_freq; 82 struct v4l2_ctrl *pixel_rate; 83 84 struct mutex lock; 85 }; 86 87 struct imx290_pixfmt { 88 u32 code; 89 u8 bpp; 90 }; 91 92 static const struct imx290_pixfmt imx290_formats[] = { 93 { MEDIA_BUS_FMT_SRGGB10_1X10, 10 }, 94 { MEDIA_BUS_FMT_SRGGB12_1X12, 12 }, 95 }; 96 97 static const struct regmap_config imx290_regmap_config = { 98 .reg_bits = 16, 99 .val_bits = 8, 100 .cache_type = REGCACHE_RBTREE, 101 }; 102 103 static const char * const imx290_test_pattern_menu[] = { 104 "Disabled", 105 "Sequence Pattern 1", 106 "Horizontal Color-bar Chart", 107 "Vertical Color-bar Chart", 108 "Sequence Pattern 2", 109 "Gradation Pattern 1", 110 "Gradation Pattern 2", 111 "000/555h Toggle Pattern", 112 }; 113 114 static const struct imx290_regval imx290_global_init_settings[] = { 115 { 0x3007, 0x00 }, 116 { 0x3018, 0x65 }, 117 { 0x3019, 0x04 }, 118 { 0x301a, 0x00 }, 119 { 0x3444, 0x20 }, 120 { 0x3445, 0x25 }, 121 { 0x303a, 0x0c }, 122 { 0x3040, 0x00 }, 123 { 0x3041, 0x00 }, 124 { 0x303c, 0x00 }, 125 { 0x303d, 0x00 }, 126 { 0x3042, 0x9c }, 127 { 0x3043, 0x07 }, 128 { 0x303e, 0x49 }, 129 { 0x303f, 0x04 }, 130 { 0x304b, 0x0a }, 131 { 0x300f, 0x00 }, 132 { 0x3010, 0x21 }, 133 { 0x3012, 0x64 }, 134 { 0x3016, 0x09 }, 135 { 0x3070, 0x02 }, 136 { 0x3071, 0x11 }, 137 { 0x309b, 0x10 }, 138 { 0x309c, 0x22 }, 139 { 0x30a2, 0x02 }, 140 { 0x30a6, 0x20 }, 141 { 0x30a8, 0x20 }, 142 { 0x30aa, 0x20 }, 143 { 0x30ac, 0x20 }, 144 { 0x30b0, 0x43 }, 145 { 0x3119, 0x9e }, 146 { 0x311c, 0x1e }, 147 { 0x311e, 0x08 }, 148 { 0x3128, 0x05 }, 149 { 0x313d, 0x83 }, 150 { 0x3150, 0x03 }, 151 { 0x317e, 0x00 }, 152 { 0x32b8, 0x50 }, 153 { 0x32b9, 0x10 }, 154 { 0x32ba, 0x00 }, 155 { 0x32bb, 0x04 }, 156 { 0x32c8, 0x50 }, 157 { 0x32c9, 0x10 }, 158 { 0x32ca, 0x00 }, 159 { 0x32cb, 0x04 }, 160 { 0x332c, 0xd3 }, 161 { 0x332d, 0x10 }, 162 { 0x332e, 0x0d }, 163 { 0x3358, 0x06 }, 164 { 0x3359, 0xe1 }, 165 { 0x335a, 0x11 }, 166 { 0x3360, 0x1e }, 167 { 0x3361, 0x61 }, 168 { 0x3362, 0x10 }, 169 { 0x33b0, 0x50 }, 170 { 0x33b2, 0x1a }, 171 { 0x33b3, 0x04 }, 172 }; 173 174 static const struct imx290_regval imx290_1080p_settings[] = { 175 /* mode settings */ 176 { 0x3007, 0x00 }, 177 { 0x303a, 0x0c }, 178 { 0x3414, 0x0a }, 179 { 0x3472, 0x80 }, 180 { 0x3473, 0x07 }, 181 { 0x3418, 0x38 }, 182 { 0x3419, 0x04 }, 183 { 0x3012, 0x64 }, 184 { 0x3013, 0x00 }, 185 { 0x305c, 0x18 }, 186 { 0x305d, 0x03 }, 187 { 0x305e, 0x20 }, 188 { 0x305f, 0x01 }, 189 { 0x315e, 0x1a }, 190 { 0x3164, 0x1a }, 191 { 0x3480, 0x49 }, 192 /* data rate settings */ 193 { 0x3405, 0x10 }, 194 { 0x3446, 0x57 }, 195 { 0x3447, 0x00 }, 196 { 0x3448, 0x37 }, 197 { 0x3449, 0x00 }, 198 { 0x344a, 0x1f }, 199 { 0x344b, 0x00 }, 200 { 0x344c, 0x1f }, 201 { 0x344d, 0x00 }, 202 { 0x344e, 0x1f }, 203 { 0x344f, 0x00 }, 204 { 0x3450, 0x77 }, 205 { 0x3451, 0x00 }, 206 { 0x3452, 0x1f }, 207 { 0x3453, 0x00 }, 208 { 0x3454, 0x17 }, 209 { 0x3455, 0x00 }, 210 }; 211 212 static const struct imx290_regval imx290_720p_settings[] = { 213 /* mode settings */ 214 { 0x3007, 0x10 }, 215 { 0x303a, 0x06 }, 216 { 0x3414, 0x04 }, 217 { 0x3472, 0x00 }, 218 { 0x3473, 0x05 }, 219 { 0x3418, 0xd0 }, 220 { 0x3419, 0x02 }, 221 { 0x3012, 0x64 }, 222 { 0x3013, 0x00 }, 223 { 0x305c, 0x20 }, 224 { 0x305d, 0x00 }, 225 { 0x305e, 0x20 }, 226 { 0x305f, 0x01 }, 227 { 0x315e, 0x1a }, 228 { 0x3164, 0x1a }, 229 { 0x3480, 0x49 }, 230 /* data rate settings */ 231 { 0x3405, 0x10 }, 232 { 0x3446, 0x4f }, 233 { 0x3447, 0x00 }, 234 { 0x3448, 0x2f }, 235 { 0x3449, 0x00 }, 236 { 0x344a, 0x17 }, 237 { 0x344b, 0x00 }, 238 { 0x344c, 0x17 }, 239 { 0x344d, 0x00 }, 240 { 0x344e, 0x17 }, 241 { 0x344f, 0x00 }, 242 { 0x3450, 0x57 }, 243 { 0x3451, 0x00 }, 244 { 0x3452, 0x17 }, 245 { 0x3453, 0x00 }, 246 { 0x3454, 0x17 }, 247 { 0x3455, 0x00 }, 248 }; 249 250 static const struct imx290_regval imx290_10bit_settings[] = { 251 { 0x3005, 0x00}, 252 { 0x3046, 0x00}, 253 { 0x3129, 0x1d}, 254 { 0x317c, 0x12}, 255 { 0x31ec, 0x37}, 256 { 0x3441, 0x0a}, 257 { 0x3442, 0x0a}, 258 { 0x300a, 0x3c}, 259 { 0x300b, 0x00}, 260 }; 261 262 static const struct imx290_regval imx290_12bit_settings[] = { 263 { 0x3005, 0x01 }, 264 { 0x3046, 0x01 }, 265 { 0x3129, 0x00 }, 266 { 0x317c, 0x00 }, 267 { 0x31ec, 0x0e }, 268 { 0x3441, 0x0c }, 269 { 0x3442, 0x0c }, 270 { 0x300a, 0xf0 }, 271 { 0x300b, 0x00 }, 272 }; 273 274 /* supported link frequencies */ 275 #define FREQ_INDEX_1080P 0 276 #define FREQ_INDEX_720P 1 277 static const s64 imx290_link_freq_2lanes[] = { 278 [FREQ_INDEX_1080P] = 445500000, 279 [FREQ_INDEX_720P] = 297000000, 280 }; 281 static const s64 imx290_link_freq_4lanes[] = { 282 [FREQ_INDEX_1080P] = 222750000, 283 [FREQ_INDEX_720P] = 148500000, 284 }; 285 286 /* 287 * In this function and in the similar ones below We rely on imx290_probe() 288 * to ensure that nlanes is either 2 or 4. 289 */ 290 static inline const s64 *imx290_link_freqs_ptr(const struct imx290 *imx290) 291 { 292 if (imx290->nlanes == 2) 293 return imx290_link_freq_2lanes; 294 else 295 return imx290_link_freq_4lanes; 296 } 297 298 static inline int imx290_link_freqs_num(const struct imx290 *imx290) 299 { 300 if (imx290->nlanes == 2) 301 return ARRAY_SIZE(imx290_link_freq_2lanes); 302 else 303 return ARRAY_SIZE(imx290_link_freq_4lanes); 304 } 305 306 /* Mode configs */ 307 static const struct imx290_mode imx290_modes_2lanes[] = { 308 { 309 .width = 1920, 310 .height = 1080, 311 .hmax = 0x1130, 312 .link_freq_index = FREQ_INDEX_1080P, 313 .data = imx290_1080p_settings, 314 .data_size = ARRAY_SIZE(imx290_1080p_settings), 315 }, 316 { 317 .width = 1280, 318 .height = 720, 319 .hmax = 0x19c8, 320 .link_freq_index = FREQ_INDEX_720P, 321 .data = imx290_720p_settings, 322 .data_size = ARRAY_SIZE(imx290_720p_settings), 323 }, 324 }; 325 326 static const struct imx290_mode imx290_modes_4lanes[] = { 327 { 328 .width = 1920, 329 .height = 1080, 330 .hmax = 0x0898, 331 .link_freq_index = FREQ_INDEX_1080P, 332 .data = imx290_1080p_settings, 333 .data_size = ARRAY_SIZE(imx290_1080p_settings), 334 }, 335 { 336 .width = 1280, 337 .height = 720, 338 .hmax = 0x0ce4, 339 .link_freq_index = FREQ_INDEX_720P, 340 .data = imx290_720p_settings, 341 .data_size = ARRAY_SIZE(imx290_720p_settings), 342 }, 343 }; 344 345 static inline const struct imx290_mode *imx290_modes_ptr(const struct imx290 *imx290) 346 { 347 if (imx290->nlanes == 2) 348 return imx290_modes_2lanes; 349 else 350 return imx290_modes_4lanes; 351 } 352 353 static inline int imx290_modes_num(const struct imx290 *imx290) 354 { 355 if (imx290->nlanes == 2) 356 return ARRAY_SIZE(imx290_modes_2lanes); 357 else 358 return ARRAY_SIZE(imx290_modes_4lanes); 359 } 360 361 static inline struct imx290 *to_imx290(struct v4l2_subdev *_sd) 362 { 363 return container_of(_sd, struct imx290, sd); 364 } 365 366 static inline int imx290_read_reg(struct imx290 *imx290, u16 addr, u8 *value) 367 { 368 unsigned int regval; 369 int ret; 370 371 ret = regmap_read(imx290->regmap, addr, ®val); 372 if (ret) { 373 dev_err(imx290->dev, "I2C read failed for addr: %x\n", addr); 374 return ret; 375 } 376 377 *value = regval & 0xff; 378 379 return 0; 380 } 381 382 static int imx290_write_reg(struct imx290 *imx290, u16 addr, u8 value) 383 { 384 int ret; 385 386 ret = regmap_write(imx290->regmap, addr, value); 387 if (ret) { 388 dev_err(imx290->dev, "I2C write failed for addr: %x\n", addr); 389 return ret; 390 } 391 392 return ret; 393 } 394 395 static int imx290_set_register_array(struct imx290 *imx290, 396 const struct imx290_regval *settings, 397 unsigned int num_settings) 398 { 399 unsigned int i; 400 int ret; 401 402 for (i = 0; i < num_settings; ++i, ++settings) { 403 ret = imx290_write_reg(imx290, settings->reg, settings->val); 404 if (ret < 0) 405 return ret; 406 } 407 408 /* Provide 10ms settle time */ 409 usleep_range(10000, 11000); 410 411 return 0; 412 } 413 414 static int imx290_write_buffered_reg(struct imx290 *imx290, u16 address_low, 415 u8 nr_regs, u32 value) 416 { 417 unsigned int i; 418 int ret; 419 420 ret = imx290_write_reg(imx290, IMX290_REGHOLD, 0x01); 421 if (ret) { 422 dev_err(imx290->dev, "Error setting hold register\n"); 423 return ret; 424 } 425 426 for (i = 0; i < nr_regs; i++) { 427 ret = imx290_write_reg(imx290, address_low + i, 428 (u8)(value >> (i * 8))); 429 if (ret) { 430 dev_err(imx290->dev, "Error writing buffered registers\n"); 431 return ret; 432 } 433 } 434 435 ret = imx290_write_reg(imx290, IMX290_REGHOLD, 0x00); 436 if (ret) { 437 dev_err(imx290->dev, "Error setting hold register\n"); 438 return ret; 439 } 440 441 return ret; 442 } 443 444 static int imx290_set_gain(struct imx290 *imx290, u32 value) 445 { 446 int ret; 447 448 ret = imx290_write_buffered_reg(imx290, IMX290_GAIN, 1, value); 449 if (ret) 450 dev_err(imx290->dev, "Unable to write gain\n"); 451 452 return ret; 453 } 454 455 /* Stop streaming */ 456 static int imx290_stop_streaming(struct imx290 *imx290) 457 { 458 int ret; 459 460 ret = imx290_write_reg(imx290, IMX290_STANDBY, 0x01); 461 if (ret < 0) 462 return ret; 463 464 msleep(30); 465 466 return imx290_write_reg(imx290, IMX290_XMSTA, 0x01); 467 } 468 469 static int imx290_set_ctrl(struct v4l2_ctrl *ctrl) 470 { 471 struct imx290 *imx290 = container_of(ctrl->handler, 472 struct imx290, ctrls); 473 int ret = 0; 474 475 /* V4L2 controls values will be applied only when power is already up */ 476 if (!pm_runtime_get_if_in_use(imx290->dev)) 477 return 0; 478 479 switch (ctrl->id) { 480 case V4L2_CID_GAIN: 481 ret = imx290_set_gain(imx290, ctrl->val); 482 break; 483 case V4L2_CID_TEST_PATTERN: 484 if (ctrl->val) { 485 imx290_write_reg(imx290, IMX290_BLKLEVEL_LOW, 0x00); 486 imx290_write_reg(imx290, IMX290_BLKLEVEL_HIGH, 0x00); 487 usleep_range(10000, 11000); 488 imx290_write_reg(imx290, IMX290_PGCTRL, 489 (u8)(IMX290_PGCTRL_REGEN | 490 IMX290_PGCTRL_THRU | 491 IMX290_PGCTRL_MODE(ctrl->val))); 492 } else { 493 imx290_write_reg(imx290, IMX290_PGCTRL, 0x00); 494 usleep_range(10000, 11000); 495 if (imx290->bpp == 10) 496 imx290_write_reg(imx290, IMX290_BLKLEVEL_LOW, 497 0x3c); 498 else /* 12 bits per pixel */ 499 imx290_write_reg(imx290, IMX290_BLKLEVEL_LOW, 500 0xf0); 501 imx290_write_reg(imx290, IMX290_BLKLEVEL_HIGH, 0x00); 502 } 503 break; 504 default: 505 ret = -EINVAL; 506 break; 507 } 508 509 pm_runtime_put(imx290->dev); 510 511 return ret; 512 } 513 514 static const struct v4l2_ctrl_ops imx290_ctrl_ops = { 515 .s_ctrl = imx290_set_ctrl, 516 }; 517 518 static int imx290_enum_mbus_code(struct v4l2_subdev *sd, 519 struct v4l2_subdev_state *sd_state, 520 struct v4l2_subdev_mbus_code_enum *code) 521 { 522 if (code->index >= ARRAY_SIZE(imx290_formats)) 523 return -EINVAL; 524 525 code->code = imx290_formats[code->index].code; 526 527 return 0; 528 } 529 530 static int imx290_enum_frame_size(struct v4l2_subdev *sd, 531 struct v4l2_subdev_state *sd_state, 532 struct v4l2_subdev_frame_size_enum *fse) 533 { 534 const struct imx290 *imx290 = to_imx290(sd); 535 const struct imx290_mode *imx290_modes = imx290_modes_ptr(imx290); 536 537 if ((fse->code != imx290_formats[0].code) && 538 (fse->code != imx290_formats[1].code)) 539 return -EINVAL; 540 541 if (fse->index >= imx290_modes_num(imx290)) 542 return -EINVAL; 543 544 fse->min_width = imx290_modes[fse->index].width; 545 fse->max_width = imx290_modes[fse->index].width; 546 fse->min_height = imx290_modes[fse->index].height; 547 fse->max_height = imx290_modes[fse->index].height; 548 549 return 0; 550 } 551 552 static int imx290_get_fmt(struct v4l2_subdev *sd, 553 struct v4l2_subdev_state *sd_state, 554 struct v4l2_subdev_format *fmt) 555 { 556 struct imx290 *imx290 = to_imx290(sd); 557 struct v4l2_mbus_framefmt *framefmt; 558 559 mutex_lock(&imx290->lock); 560 561 if (fmt->which == V4L2_SUBDEV_FORMAT_TRY) 562 framefmt = v4l2_subdev_get_try_format(&imx290->sd, sd_state, 563 fmt->pad); 564 else 565 framefmt = &imx290->current_format; 566 567 fmt->format = *framefmt; 568 569 mutex_unlock(&imx290->lock); 570 571 return 0; 572 } 573 574 static inline u8 imx290_get_link_freq_index(struct imx290 *imx290) 575 { 576 return imx290->current_mode->link_freq_index; 577 } 578 579 static s64 imx290_get_link_freq(struct imx290 *imx290) 580 { 581 u8 index = imx290_get_link_freq_index(imx290); 582 583 return *(imx290_link_freqs_ptr(imx290) + index); 584 } 585 586 static u64 imx290_calc_pixel_rate(struct imx290 *imx290) 587 { 588 s64 link_freq = imx290_get_link_freq(imx290); 589 u8 nlanes = imx290->nlanes; 590 u64 pixel_rate; 591 592 /* pixel rate = link_freq * 2 * nr_of_lanes / bits_per_sample */ 593 pixel_rate = link_freq * 2 * nlanes; 594 do_div(pixel_rate, imx290->bpp); 595 return pixel_rate; 596 } 597 598 static int imx290_set_fmt(struct v4l2_subdev *sd, 599 struct v4l2_subdev_state *sd_state, 600 struct v4l2_subdev_format *fmt) 601 { 602 struct imx290 *imx290 = to_imx290(sd); 603 const struct imx290_mode *mode; 604 struct v4l2_mbus_framefmt *format; 605 unsigned int i; 606 607 mutex_lock(&imx290->lock); 608 609 mode = v4l2_find_nearest_size(imx290_modes_ptr(imx290), 610 imx290_modes_num(imx290), width, height, 611 fmt->format.width, fmt->format.height); 612 613 fmt->format.width = mode->width; 614 fmt->format.height = mode->height; 615 616 for (i = 0; i < ARRAY_SIZE(imx290_formats); i++) 617 if (imx290_formats[i].code == fmt->format.code) 618 break; 619 620 if (i >= ARRAY_SIZE(imx290_formats)) 621 i = 0; 622 623 fmt->format.code = imx290_formats[i].code; 624 fmt->format.field = V4L2_FIELD_NONE; 625 626 if (fmt->which == V4L2_SUBDEV_FORMAT_TRY) { 627 format = v4l2_subdev_get_try_format(sd, sd_state, fmt->pad); 628 } else { 629 format = &imx290->current_format; 630 imx290->current_mode = mode; 631 imx290->bpp = imx290_formats[i].bpp; 632 633 if (imx290->link_freq) 634 __v4l2_ctrl_s_ctrl(imx290->link_freq, 635 imx290_get_link_freq_index(imx290)); 636 if (imx290->pixel_rate) 637 __v4l2_ctrl_s_ctrl_int64(imx290->pixel_rate, 638 imx290_calc_pixel_rate(imx290)); 639 } 640 641 *format = fmt->format; 642 643 mutex_unlock(&imx290->lock); 644 645 return 0; 646 } 647 648 static int imx290_entity_init_cfg(struct v4l2_subdev *subdev, 649 struct v4l2_subdev_state *sd_state) 650 { 651 struct v4l2_subdev_format fmt = { 0 }; 652 653 fmt.which = sd_state ? V4L2_SUBDEV_FORMAT_TRY : V4L2_SUBDEV_FORMAT_ACTIVE; 654 fmt.format.width = 1920; 655 fmt.format.height = 1080; 656 657 imx290_set_fmt(subdev, sd_state, &fmt); 658 659 return 0; 660 } 661 662 static int imx290_write_current_format(struct imx290 *imx290) 663 { 664 int ret; 665 666 switch (imx290->current_format.code) { 667 case MEDIA_BUS_FMT_SRGGB10_1X10: 668 ret = imx290_set_register_array(imx290, imx290_10bit_settings, 669 ARRAY_SIZE( 670 imx290_10bit_settings)); 671 if (ret < 0) { 672 dev_err(imx290->dev, "Could not set format registers\n"); 673 return ret; 674 } 675 break; 676 case MEDIA_BUS_FMT_SRGGB12_1X12: 677 ret = imx290_set_register_array(imx290, imx290_12bit_settings, 678 ARRAY_SIZE( 679 imx290_12bit_settings)); 680 if (ret < 0) { 681 dev_err(imx290->dev, "Could not set format registers\n"); 682 return ret; 683 } 684 break; 685 default: 686 dev_err(imx290->dev, "Unknown pixel format\n"); 687 return -EINVAL; 688 } 689 690 return 0; 691 } 692 693 static int imx290_set_hmax(struct imx290 *imx290, u32 val) 694 { 695 int ret; 696 697 ret = imx290_write_reg(imx290, IMX290_HMAX_LOW, (val & 0xff)); 698 if (ret) { 699 dev_err(imx290->dev, "Error setting HMAX register\n"); 700 return ret; 701 } 702 703 ret = imx290_write_reg(imx290, IMX290_HMAX_HIGH, ((val >> 8) & 0xff)); 704 if (ret) { 705 dev_err(imx290->dev, "Error setting HMAX register\n"); 706 return ret; 707 } 708 709 return 0; 710 } 711 712 /* Start streaming */ 713 static int imx290_start_streaming(struct imx290 *imx290) 714 { 715 int ret; 716 717 /* Set init register settings */ 718 ret = imx290_set_register_array(imx290, imx290_global_init_settings, 719 ARRAY_SIZE( 720 imx290_global_init_settings)); 721 if (ret < 0) { 722 dev_err(imx290->dev, "Could not set init registers\n"); 723 return ret; 724 } 725 726 /* Apply the register values related to current frame format */ 727 ret = imx290_write_current_format(imx290); 728 if (ret < 0) { 729 dev_err(imx290->dev, "Could not set frame format\n"); 730 return ret; 731 } 732 733 /* Apply default values of current mode */ 734 ret = imx290_set_register_array(imx290, imx290->current_mode->data, 735 imx290->current_mode->data_size); 736 if (ret < 0) { 737 dev_err(imx290->dev, "Could not set current mode\n"); 738 return ret; 739 } 740 ret = imx290_set_hmax(imx290, imx290->current_mode->hmax); 741 if (ret < 0) 742 return ret; 743 744 /* Apply customized values from user */ 745 ret = v4l2_ctrl_handler_setup(imx290->sd.ctrl_handler); 746 if (ret) { 747 dev_err(imx290->dev, "Could not sync v4l2 controls\n"); 748 return ret; 749 } 750 751 ret = imx290_write_reg(imx290, IMX290_STANDBY, 0x00); 752 if (ret < 0) 753 return ret; 754 755 msleep(30); 756 757 /* Start streaming */ 758 return imx290_write_reg(imx290, IMX290_XMSTA, 0x00); 759 } 760 761 static int imx290_set_stream(struct v4l2_subdev *sd, int enable) 762 { 763 struct imx290 *imx290 = to_imx290(sd); 764 int ret = 0; 765 766 if (enable) { 767 ret = pm_runtime_resume_and_get(imx290->dev); 768 if (ret < 0) 769 goto unlock_and_return; 770 771 ret = imx290_start_streaming(imx290); 772 if (ret) { 773 dev_err(imx290->dev, "Start stream failed\n"); 774 pm_runtime_put(imx290->dev); 775 goto unlock_and_return; 776 } 777 } else { 778 imx290_stop_streaming(imx290); 779 pm_runtime_put(imx290->dev); 780 } 781 782 unlock_and_return: 783 784 return ret; 785 } 786 787 static int imx290_get_regulators(struct device *dev, struct imx290 *imx290) 788 { 789 unsigned int i; 790 791 for (i = 0; i < IMX290_NUM_SUPPLIES; i++) 792 imx290->supplies[i].supply = imx290_supply_name[i]; 793 794 return devm_regulator_bulk_get(dev, IMX290_NUM_SUPPLIES, 795 imx290->supplies); 796 } 797 798 static int imx290_set_data_lanes(struct imx290 *imx290) 799 { 800 int ret = 0, laneval, frsel; 801 802 switch (imx290->nlanes) { 803 case 2: 804 laneval = 0x01; 805 frsel = 0x02; 806 break; 807 case 4: 808 laneval = 0x03; 809 frsel = 0x01; 810 break; 811 default: 812 /* 813 * We should never hit this since the data lane count is 814 * validated in probe itself 815 */ 816 dev_err(imx290->dev, "Lane configuration not supported\n"); 817 ret = -EINVAL; 818 goto exit; 819 } 820 821 ret = imx290_write_reg(imx290, IMX290_PHY_LANE_NUM, laneval); 822 if (ret) { 823 dev_err(imx290->dev, "Error setting Physical Lane number register\n"); 824 goto exit; 825 } 826 827 ret = imx290_write_reg(imx290, IMX290_CSI_LANE_MODE, laneval); 828 if (ret) { 829 dev_err(imx290->dev, "Error setting CSI Lane mode register\n"); 830 goto exit; 831 } 832 833 ret = imx290_write_reg(imx290, IMX290_FR_FDG_SEL, frsel); 834 if (ret) 835 dev_err(imx290->dev, "Error setting FR/FDG SEL register\n"); 836 837 exit: 838 return ret; 839 } 840 841 static int imx290_power_on(struct device *dev) 842 { 843 struct v4l2_subdev *sd = dev_get_drvdata(dev); 844 struct imx290 *imx290 = to_imx290(sd); 845 int ret; 846 847 ret = clk_prepare_enable(imx290->xclk); 848 if (ret) { 849 dev_err(dev, "Failed to enable clock\n"); 850 return ret; 851 } 852 853 ret = regulator_bulk_enable(IMX290_NUM_SUPPLIES, imx290->supplies); 854 if (ret) { 855 dev_err(dev, "Failed to enable regulators\n"); 856 clk_disable_unprepare(imx290->xclk); 857 return ret; 858 } 859 860 usleep_range(1, 2); 861 gpiod_set_value_cansleep(imx290->rst_gpio, 0); 862 usleep_range(30000, 31000); 863 864 /* Set data lane count */ 865 imx290_set_data_lanes(imx290); 866 867 return 0; 868 } 869 870 static int imx290_power_off(struct device *dev) 871 { 872 struct v4l2_subdev *sd = dev_get_drvdata(dev); 873 struct imx290 *imx290 = to_imx290(sd); 874 875 clk_disable_unprepare(imx290->xclk); 876 gpiod_set_value_cansleep(imx290->rst_gpio, 1); 877 regulator_bulk_disable(IMX290_NUM_SUPPLIES, imx290->supplies); 878 879 return 0; 880 } 881 882 static const struct dev_pm_ops imx290_pm_ops = { 883 SET_RUNTIME_PM_OPS(imx290_power_off, imx290_power_on, NULL) 884 }; 885 886 static const struct v4l2_subdev_video_ops imx290_video_ops = { 887 .s_stream = imx290_set_stream, 888 }; 889 890 static const struct v4l2_subdev_pad_ops imx290_pad_ops = { 891 .init_cfg = imx290_entity_init_cfg, 892 .enum_mbus_code = imx290_enum_mbus_code, 893 .enum_frame_size = imx290_enum_frame_size, 894 .get_fmt = imx290_get_fmt, 895 .set_fmt = imx290_set_fmt, 896 }; 897 898 static const struct v4l2_subdev_ops imx290_subdev_ops = { 899 .video = &imx290_video_ops, 900 .pad = &imx290_pad_ops, 901 }; 902 903 static const struct media_entity_operations imx290_subdev_entity_ops = { 904 .link_validate = v4l2_subdev_link_validate, 905 }; 906 907 /* 908 * Returns 0 if all link frequencies used by the driver for the given number 909 * of MIPI data lanes are mentioned in the device tree, or the value of the 910 * first missing frequency otherwise. 911 */ 912 static s64 imx290_check_link_freqs(const struct imx290 *imx290, 913 const struct v4l2_fwnode_endpoint *ep) 914 { 915 int i, j; 916 const s64 *freqs = imx290_link_freqs_ptr(imx290); 917 int freqs_count = imx290_link_freqs_num(imx290); 918 919 for (i = 0; i < freqs_count; i++) { 920 for (j = 0; j < ep->nr_of_link_frequencies; j++) 921 if (freqs[i] == ep->link_frequencies[j]) 922 break; 923 if (j == ep->nr_of_link_frequencies) 924 return freqs[i]; 925 } 926 return 0; 927 } 928 929 static int imx290_probe(struct i2c_client *client) 930 { 931 struct device *dev = &client->dev; 932 struct fwnode_handle *endpoint; 933 /* Only CSI2 is supported for now: */ 934 struct v4l2_fwnode_endpoint ep = { 935 .bus_type = V4L2_MBUS_CSI2_DPHY 936 }; 937 struct imx290 *imx290; 938 u32 xclk_freq; 939 s64 fq; 940 int ret; 941 942 imx290 = devm_kzalloc(dev, sizeof(*imx290), GFP_KERNEL); 943 if (!imx290) 944 return -ENOMEM; 945 946 imx290->dev = dev; 947 imx290->regmap = devm_regmap_init_i2c(client, &imx290_regmap_config); 948 if (IS_ERR(imx290->regmap)) { 949 dev_err(dev, "Unable to initialize I2C\n"); 950 return -ENODEV; 951 } 952 953 endpoint = fwnode_graph_get_next_endpoint(dev_fwnode(dev), NULL); 954 if (!endpoint) { 955 dev_err(dev, "Endpoint node not found\n"); 956 return -EINVAL; 957 } 958 959 ret = v4l2_fwnode_endpoint_alloc_parse(endpoint, &ep); 960 fwnode_handle_put(endpoint); 961 if (ret == -ENXIO) { 962 dev_err(dev, "Unsupported bus type, should be CSI2\n"); 963 goto free_err; 964 } else if (ret) { 965 dev_err(dev, "Parsing endpoint node failed\n"); 966 goto free_err; 967 } 968 969 /* Get number of data lanes */ 970 imx290->nlanes = ep.bus.mipi_csi2.num_data_lanes; 971 if (imx290->nlanes != 2 && imx290->nlanes != 4) { 972 dev_err(dev, "Invalid data lanes: %d\n", imx290->nlanes); 973 ret = -EINVAL; 974 goto free_err; 975 } 976 977 dev_dbg(dev, "Using %u data lanes\n", imx290->nlanes); 978 979 if (!ep.nr_of_link_frequencies) { 980 dev_err(dev, "link-frequency property not found in DT\n"); 981 ret = -EINVAL; 982 goto free_err; 983 } 984 985 /* Check that link frequences for all the modes are in device tree */ 986 fq = imx290_check_link_freqs(imx290, &ep); 987 if (fq) { 988 dev_err(dev, "Link frequency of %lld is not supported\n", fq); 989 ret = -EINVAL; 990 goto free_err; 991 } 992 993 /* get system clock (xclk) */ 994 imx290->xclk = devm_clk_get(dev, "xclk"); 995 if (IS_ERR(imx290->xclk)) { 996 dev_err(dev, "Could not get xclk"); 997 ret = PTR_ERR(imx290->xclk); 998 goto free_err; 999 } 1000 1001 ret = fwnode_property_read_u32(dev_fwnode(dev), "clock-frequency", 1002 &xclk_freq); 1003 if (ret) { 1004 dev_err(dev, "Could not get xclk frequency\n"); 1005 goto free_err; 1006 } 1007 1008 /* external clock must be 37.125 MHz */ 1009 if (xclk_freq != 37125000) { 1010 dev_err(dev, "External clock frequency %u is not supported\n", 1011 xclk_freq); 1012 ret = -EINVAL; 1013 goto free_err; 1014 } 1015 1016 ret = clk_set_rate(imx290->xclk, xclk_freq); 1017 if (ret) { 1018 dev_err(dev, "Could not set xclk frequency\n"); 1019 goto free_err; 1020 } 1021 1022 ret = imx290_get_regulators(dev, imx290); 1023 if (ret < 0) { 1024 dev_err(dev, "Cannot get regulators\n"); 1025 goto free_err; 1026 } 1027 1028 imx290->rst_gpio = devm_gpiod_get_optional(dev, "reset", 1029 GPIOD_OUT_HIGH); 1030 if (IS_ERR(imx290->rst_gpio)) { 1031 dev_err(dev, "Cannot get reset gpio\n"); 1032 ret = PTR_ERR(imx290->rst_gpio); 1033 goto free_err; 1034 } 1035 1036 mutex_init(&imx290->lock); 1037 1038 /* 1039 * Initialize the frame format. In particular, imx290->current_mode 1040 * and imx290->bpp are set to defaults: imx290_calc_pixel_rate() call 1041 * below relies on these fields. 1042 */ 1043 imx290_entity_init_cfg(&imx290->sd, NULL); 1044 1045 v4l2_ctrl_handler_init(&imx290->ctrls, 4); 1046 1047 v4l2_ctrl_new_std(&imx290->ctrls, &imx290_ctrl_ops, 1048 V4L2_CID_GAIN, 0, 72, 1, 0); 1049 1050 imx290->link_freq = 1051 v4l2_ctrl_new_int_menu(&imx290->ctrls, &imx290_ctrl_ops, 1052 V4L2_CID_LINK_FREQ, 1053 imx290_link_freqs_num(imx290) - 1, 0, 1054 imx290_link_freqs_ptr(imx290)); 1055 if (imx290->link_freq) 1056 imx290->link_freq->flags |= V4L2_CTRL_FLAG_READ_ONLY; 1057 1058 imx290->pixel_rate = v4l2_ctrl_new_std(&imx290->ctrls, &imx290_ctrl_ops, 1059 V4L2_CID_PIXEL_RATE, 1060 1, INT_MAX, 1, 1061 imx290_calc_pixel_rate(imx290)); 1062 1063 v4l2_ctrl_new_std_menu_items(&imx290->ctrls, &imx290_ctrl_ops, 1064 V4L2_CID_TEST_PATTERN, 1065 ARRAY_SIZE(imx290_test_pattern_menu) - 1, 1066 0, 0, imx290_test_pattern_menu); 1067 1068 imx290->sd.ctrl_handler = &imx290->ctrls; 1069 1070 if (imx290->ctrls.error) { 1071 dev_err(dev, "Control initialization error %d\n", 1072 imx290->ctrls.error); 1073 ret = imx290->ctrls.error; 1074 goto free_ctrl; 1075 } 1076 1077 v4l2_i2c_subdev_init(&imx290->sd, client, &imx290_subdev_ops); 1078 imx290->sd.flags |= V4L2_SUBDEV_FL_HAS_DEVNODE; 1079 imx290->sd.dev = &client->dev; 1080 imx290->sd.entity.ops = &imx290_subdev_entity_ops; 1081 imx290->sd.entity.function = MEDIA_ENT_F_CAM_SENSOR; 1082 1083 imx290->pad.flags = MEDIA_PAD_FL_SOURCE; 1084 ret = media_entity_pads_init(&imx290->sd.entity, 1, &imx290->pad); 1085 if (ret < 0) { 1086 dev_err(dev, "Could not register media entity\n"); 1087 goto free_ctrl; 1088 } 1089 1090 ret = v4l2_async_register_subdev(&imx290->sd); 1091 if (ret < 0) { 1092 dev_err(dev, "Could not register v4l2 device\n"); 1093 goto free_entity; 1094 } 1095 1096 /* Power on the device to match runtime PM state below */ 1097 ret = imx290_power_on(dev); 1098 if (ret < 0) { 1099 dev_err(dev, "Could not power on the device\n"); 1100 goto free_entity; 1101 } 1102 1103 pm_runtime_set_active(dev); 1104 pm_runtime_enable(dev); 1105 pm_runtime_idle(dev); 1106 1107 v4l2_fwnode_endpoint_free(&ep); 1108 1109 return 0; 1110 1111 free_entity: 1112 media_entity_cleanup(&imx290->sd.entity); 1113 free_ctrl: 1114 v4l2_ctrl_handler_free(&imx290->ctrls); 1115 mutex_destroy(&imx290->lock); 1116 free_err: 1117 v4l2_fwnode_endpoint_free(&ep); 1118 1119 return ret; 1120 } 1121 1122 static int imx290_remove(struct i2c_client *client) 1123 { 1124 struct v4l2_subdev *sd = i2c_get_clientdata(client); 1125 struct imx290 *imx290 = to_imx290(sd); 1126 1127 v4l2_async_unregister_subdev(sd); 1128 media_entity_cleanup(&sd->entity); 1129 v4l2_ctrl_handler_free(sd->ctrl_handler); 1130 1131 mutex_destroy(&imx290->lock); 1132 1133 pm_runtime_disable(imx290->dev); 1134 if (!pm_runtime_status_suspended(imx290->dev)) 1135 imx290_power_off(imx290->dev); 1136 pm_runtime_set_suspended(imx290->dev); 1137 1138 return 0; 1139 } 1140 1141 static const struct of_device_id imx290_of_match[] = { 1142 { .compatible = "sony,imx290" }, 1143 { /* sentinel */ } 1144 }; 1145 MODULE_DEVICE_TABLE(of, imx290_of_match); 1146 1147 static struct i2c_driver imx290_i2c_driver = { 1148 .probe_new = imx290_probe, 1149 .remove = imx290_remove, 1150 .driver = { 1151 .name = "imx290", 1152 .pm = &imx290_pm_ops, 1153 .of_match_table = of_match_ptr(imx290_of_match), 1154 }, 1155 }; 1156 1157 module_i2c_driver(imx290_i2c_driver); 1158 1159 MODULE_DESCRIPTION("Sony IMX290 CMOS Image Sensor Driver"); 1160 MODULE_AUTHOR("FRAMOS GmbH"); 1161 MODULE_AUTHOR("Manivannan Sadhasivam <manivannan.sadhasivam@linaro.org>"); 1162 MODULE_LICENSE("GPL v2"); 1163