1 // SPDX-License-Identifier: GPL-2.0
3 * Driver for RJ54N1CB0C CMOS Image Sensor from Sharp
5 * Copyright (C) 2018, Jacopo Mondi <jacopo@jmondi.org>
7 * Copyright (C) 2009, Guennadi Liakhovetski <g.liakhovetski@gmx.de>
10 #include <linux/clk.h>
11 #include <linux/delay.h>
12 #include <linux/gpio/consumer.h>
13 #include <linux/i2c.h>
14 #include <linux/module.h>
15 #include <linux/slab.h>
16 #include <linux/v4l2-mediabus.h>
17 #include <linux/videodev2.h>
19 #include <media/i2c/rj54n1cb0c.h>
20 #include <media/v4l2-device.h>
21 #include <media/v4l2-ctrls.h>
22 #include <media/v4l2-subdev.h>
24 #define RJ54N1_DEV_CODE 0x0400
25 #define RJ54N1_DEV_CODE2 0x0401
26 #define RJ54N1_OUT_SEL 0x0403
27 #define RJ54N1_XY_OUTPUT_SIZE_S_H 0x0404
28 #define RJ54N1_X_OUTPUT_SIZE_S_L 0x0405
29 #define RJ54N1_Y_OUTPUT_SIZE_S_L 0x0406
30 #define RJ54N1_XY_OUTPUT_SIZE_P_H 0x0407
31 #define RJ54N1_X_OUTPUT_SIZE_P_L 0x0408
32 #define RJ54N1_Y_OUTPUT_SIZE_P_L 0x0409
33 #define RJ54N1_LINE_LENGTH_PCK_S_H 0x040a
34 #define RJ54N1_LINE_LENGTH_PCK_S_L 0x040b
35 #define RJ54N1_LINE_LENGTH_PCK_P_H 0x040c
36 #define RJ54N1_LINE_LENGTH_PCK_P_L 0x040d
37 #define RJ54N1_RESIZE_N 0x040e
38 #define RJ54N1_RESIZE_N_STEP 0x040f
39 #define RJ54N1_RESIZE_STEP 0x0410
40 #define RJ54N1_RESIZE_HOLD_H 0x0411
41 #define RJ54N1_RESIZE_HOLD_L 0x0412
42 #define RJ54N1_H_OBEN_OFS 0x0413
43 #define RJ54N1_V_OBEN_OFS 0x0414
44 #define RJ54N1_RESIZE_CONTROL 0x0415
45 #define RJ54N1_STILL_CONTROL 0x0417
46 #define RJ54N1_INC_USE_SEL_H 0x0425
47 #define RJ54N1_INC_USE_SEL_L 0x0426
48 #define RJ54N1_MIRROR_STILL_MODE 0x0427
49 #define RJ54N1_INIT_START 0x0428
50 #define RJ54N1_SCALE_1_2_LEV 0x0429
51 #define RJ54N1_SCALE_4_LEV 0x042a
52 #define RJ54N1_Y_GAIN 0x04d8
53 #define RJ54N1_APT_GAIN_UP 0x04fa
54 #define RJ54N1_RA_SEL_UL 0x0530
55 #define RJ54N1_BYTE_SWAP 0x0531
56 #define RJ54N1_OUT_SIGPO 0x053b
57 #define RJ54N1_WB_SEL_WEIGHT_I 0x054e
58 #define RJ54N1_BIT8_WB 0x0569
59 #define RJ54N1_HCAPS_WB 0x056a
60 #define RJ54N1_VCAPS_WB 0x056b
61 #define RJ54N1_HCAPE_WB 0x056c
62 #define RJ54N1_VCAPE_WB 0x056d
63 #define RJ54N1_EXPOSURE_CONTROL 0x058c
64 #define RJ54N1_FRAME_LENGTH_S_H 0x0595
65 #define RJ54N1_FRAME_LENGTH_S_L 0x0596
66 #define RJ54N1_FRAME_LENGTH_P_H 0x0597
67 #define RJ54N1_FRAME_LENGTH_P_L 0x0598
68 #define RJ54N1_PEAK_H 0x05b7
69 #define RJ54N1_PEAK_50 0x05b8
70 #define RJ54N1_PEAK_60 0x05b9
71 #define RJ54N1_PEAK_DIFF 0x05ba
72 #define RJ54N1_IOC 0x05ef
73 #define RJ54N1_TG_BYPASS 0x0700
74 #define RJ54N1_PLL_L 0x0701
75 #define RJ54N1_PLL_N 0x0702
76 #define RJ54N1_PLL_EN 0x0704
77 #define RJ54N1_RATIO_TG 0x0706
78 #define RJ54N1_RATIO_T 0x0707
79 #define RJ54N1_RATIO_R 0x0708
80 #define RJ54N1_RAMP_TGCLK_EN 0x0709
81 #define RJ54N1_OCLK_DSP 0x0710
82 #define RJ54N1_RATIO_OP 0x0711
83 #define RJ54N1_RATIO_O 0x0712
84 #define RJ54N1_OCLK_SEL_EN 0x0713
85 #define RJ54N1_CLK_RST 0x0717
86 #define RJ54N1_RESET_STANDBY 0x0718
87 #define RJ54N1_FWFLG 0x07fe
89 #define E_EXCLK (1 << 7)
90 #define SOFT_STDBY (1 << 4)
91 #define SEN_RSTX (1 << 2)
92 #define TG_RSTX (1 << 1)
93 #define DSP_RSTX (1 << 0)
95 #define RESIZE_HOLD_SEL (1 << 2)
96 #define RESIZE_GO (1 << 1)
99 * When cropping, the camera automatically centers the cropped region, there
100 * doesn't seem to be a way to specify an explicit location of the rectangle.
102 #define RJ54N1_COLUMN_SKIP 0
103 #define RJ54N1_ROW_SKIP 0
104 #define RJ54N1_MAX_WIDTH 1600
105 #define RJ54N1_MAX_HEIGHT 1200
110 /* I2C addresses: 0x50, 0x51, 0x60, 0x61 */
112 /* RJ54N1CB0C has only one fixed colorspace per pixelcode */
113 struct rj54n1_datafmt {
115 enum v4l2_colorspace colorspace;
118 /* Find a data format by a pixel code in an array */
119 static const struct rj54n1_datafmt *rj54n1_find_datafmt(
120 u32 code, const struct rj54n1_datafmt *fmt,
124 for (i = 0; i < n; i++)
125 if (fmt[i].code == code)
131 static const struct rj54n1_datafmt rj54n1_colour_fmts[] = {
132 {MEDIA_BUS_FMT_YUYV8_2X8, V4L2_COLORSPACE_JPEG},
133 {MEDIA_BUS_FMT_YVYU8_2X8, V4L2_COLORSPACE_JPEG},
134 {MEDIA_BUS_FMT_RGB565_2X8_LE, V4L2_COLORSPACE_SRGB},
135 {MEDIA_BUS_FMT_RGB565_2X8_BE, V4L2_COLORSPACE_SRGB},
136 {MEDIA_BUS_FMT_SBGGR10_2X8_PADHI_LE, V4L2_COLORSPACE_SRGB},
137 {MEDIA_BUS_FMT_SBGGR10_2X8_PADLO_LE, V4L2_COLORSPACE_SRGB},
138 {MEDIA_BUS_FMT_SBGGR10_2X8_PADHI_BE, V4L2_COLORSPACE_SRGB},
139 {MEDIA_BUS_FMT_SBGGR10_2X8_PADLO_BE, V4L2_COLORSPACE_SRGB},
140 {MEDIA_BUS_FMT_SBGGR10_1X10, V4L2_COLORSPACE_SRGB},
143 struct rj54n1_clock_div {
144 u8 ratio_tg; /* can be 0 or an odd number */
152 struct v4l2_subdev subdev;
153 struct v4l2_ctrl_handler hdl;
155 struct gpio_desc *pwup_gpio;
156 struct gpio_desc *enable_gpio;
157 struct rj54n1_clock_div clk_div;
158 const struct rj54n1_datafmt *fmt;
159 struct v4l2_rect rect; /* Sensor window */
160 unsigned int tgclk_mhz;
162 unsigned short width; /* Output window */
163 unsigned short height;
164 unsigned short resize; /* Sensor * 1024 / resize = Output */
165 unsigned short scale;
169 struct rj54n1_reg_val {
174 static const struct rj54n1_reg_val bank_4[] = {
195 static const struct rj54n1_reg_val bank_5[] = {
216 static const struct rj54n1_reg_val bank_7[] = {
224 static const struct rj54n1_reg_val bank_8[] = {
412 static const struct rj54n1_reg_val bank_10[] = {
416 /* Clock dividers - these are default register values, divider = register + 1 */
417 static const struct rj54n1_clock_div clk_div = {
418 .ratio_tg = 3 /* default: 5 */,
419 .ratio_t = 4 /* default: 1 */,
420 .ratio_r = 4 /* default: 0 */,
421 .ratio_op = 1 /* default: 5 */,
422 .ratio_o = 9 /* default: 0 */,
425 static struct rj54n1 *to_rj54n1(const struct i2c_client *client)
427 return container_of(i2c_get_clientdata(client), struct rj54n1, subdev);
430 static int reg_read(struct i2c_client *client, const u16 reg)
432 struct rj54n1 *rj54n1 = to_rj54n1(client);
436 if (rj54n1->bank != reg >> 8) {
437 dev_dbg(&client->dev, "[0x%x] = 0x%x\n", 0xff, reg >> 8);
438 ret = i2c_smbus_write_byte_data(client, 0xff, reg >> 8);
441 rj54n1->bank = reg >> 8;
443 return i2c_smbus_read_byte_data(client, reg & 0xff);
446 static int reg_write(struct i2c_client *client, const u16 reg,
449 struct rj54n1 *rj54n1 = to_rj54n1(client);
453 if (rj54n1->bank != reg >> 8) {
454 dev_dbg(&client->dev, "[0x%x] = 0x%x\n", 0xff, reg >> 8);
455 ret = i2c_smbus_write_byte_data(client, 0xff, reg >> 8);
458 rj54n1->bank = reg >> 8;
460 dev_dbg(&client->dev, "[0x%x] = 0x%x\n", reg & 0xff, data);
461 return i2c_smbus_write_byte_data(client, reg & 0xff, data);
464 static int reg_set(struct i2c_client *client, const u16 reg,
465 const u8 data, const u8 mask)
469 ret = reg_read(client, reg);
472 return reg_write(client, reg, (ret & ~mask) | (data & mask));
475 static int reg_write_multiple(struct i2c_client *client,
476 const struct rj54n1_reg_val *rv, const int n)
480 for (i = 0; i < n; i++) {
481 ret = reg_write(client, rv->reg, rv->val);
490 static int rj54n1_enum_mbus_code(struct v4l2_subdev *sd,
491 struct v4l2_subdev_pad_config *cfg,
492 struct v4l2_subdev_mbus_code_enum *code)
494 if (code->pad || code->index >= ARRAY_SIZE(rj54n1_colour_fmts))
497 code->code = rj54n1_colour_fmts[code->index].code;
501 static int rj54n1_s_stream(struct v4l2_subdev *sd, int enable)
503 struct i2c_client *client = v4l2_get_subdevdata(sd);
505 /* Switch between preview and still shot modes */
506 return reg_set(client, RJ54N1_STILL_CONTROL, (!enable) << 7, 0x80);
509 static int rj54n1_set_rect(struct i2c_client *client,
510 u16 reg_x, u16 reg_y, u16 reg_xy,
511 u32 width, u32 height)
515 ret = reg_write(client, reg_xy,
516 ((width >> 4) & 0x70) |
517 ((height >> 8) & 7));
520 ret = reg_write(client, reg_x, width & 0xff);
522 ret = reg_write(client, reg_y, height & 0xff);
528 * Some commands, specifically certain initialisation sequences, require
529 * a commit operation.
531 static int rj54n1_commit(struct i2c_client *client)
533 int ret = reg_write(client, RJ54N1_INIT_START, 1);
536 ret = reg_write(client, RJ54N1_INIT_START, 0);
540 static int rj54n1_sensor_scale(struct v4l2_subdev *sd, s32 *in_w, s32 *in_h,
541 s32 *out_w, s32 *out_h);
543 static int rj54n1_set_selection(struct v4l2_subdev *sd,
544 struct v4l2_subdev_pad_config *cfg,
545 struct v4l2_subdev_selection *sel)
547 struct i2c_client *client = v4l2_get_subdevdata(sd);
548 struct rj54n1 *rj54n1 = to_rj54n1(client);
549 const struct v4l2_rect *rect = &sel->r;
550 int output_w, output_h, input_w = rect->width, input_h = rect->height;
553 if (sel->which != V4L2_SUBDEV_FORMAT_ACTIVE ||
554 sel->target != V4L2_SEL_TGT_CROP)
557 /* arbitrary minimum width and height, edges unimportant */
558 v4l_bound_align_image(&input_w, 8, RJ54N1_MAX_WIDTH, 0,
559 &input_h, 8, RJ54N1_MAX_HEIGHT, 0, 0);
561 output_w = (input_w * 1024 + rj54n1->resize / 2) / rj54n1->resize;
562 output_h = (input_h * 1024 + rj54n1->resize / 2) / rj54n1->resize;
564 dev_dbg(&client->dev, "Scaling for %dx%d : %u = %dx%d\n",
565 input_w, input_h, rj54n1->resize, output_w, output_h);
567 ret = rj54n1_sensor_scale(sd, &input_w, &input_h, &output_w, &output_h);
571 rj54n1->width = output_w;
572 rj54n1->height = output_h;
573 rj54n1->resize = ret;
574 rj54n1->rect.width = input_w;
575 rj54n1->rect.height = input_h;
580 static int rj54n1_get_selection(struct v4l2_subdev *sd,
581 struct v4l2_subdev_pad_config *cfg,
582 struct v4l2_subdev_selection *sel)
584 struct i2c_client *client = v4l2_get_subdevdata(sd);
585 struct rj54n1 *rj54n1 = to_rj54n1(client);
587 if (sel->which != V4L2_SUBDEV_FORMAT_ACTIVE)
590 switch (sel->target) {
591 case V4L2_SEL_TGT_CROP_BOUNDS:
592 case V4L2_SEL_TGT_CROP_DEFAULT:
593 sel->r.left = RJ54N1_COLUMN_SKIP;
594 sel->r.top = RJ54N1_ROW_SKIP;
595 sel->r.width = RJ54N1_MAX_WIDTH;
596 sel->r.height = RJ54N1_MAX_HEIGHT;
598 case V4L2_SEL_TGT_CROP:
599 sel->r = rj54n1->rect;
606 static int rj54n1_get_fmt(struct v4l2_subdev *sd,
607 struct v4l2_subdev_pad_config *cfg,
608 struct v4l2_subdev_format *format)
610 struct v4l2_mbus_framefmt *mf = &format->format;
611 struct i2c_client *client = v4l2_get_subdevdata(sd);
612 struct rj54n1 *rj54n1 = to_rj54n1(client);
617 mf->code = rj54n1->fmt->code;
618 mf->colorspace = rj54n1->fmt->colorspace;
619 mf->ycbcr_enc = V4L2_YCBCR_ENC_601;
620 mf->xfer_func = V4L2_XFER_FUNC_SRGB;
621 mf->quantization = V4L2_QUANTIZATION_DEFAULT;
622 mf->field = V4L2_FIELD_NONE;
623 mf->width = rj54n1->width;
624 mf->height = rj54n1->height;
630 * The actual geometry configuration routine. It scales the input window into
631 * the output one, updates the window sizes and returns an error or the resize
632 * coefficient on success. Note: we only use the "Fixed Scaling" on this camera.
634 static int rj54n1_sensor_scale(struct v4l2_subdev *sd, s32 *in_w, s32 *in_h,
635 s32 *out_w, s32 *out_h)
637 struct i2c_client *client = v4l2_get_subdevdata(sd);
638 struct rj54n1 *rj54n1 = to_rj54n1(client);
639 unsigned int skip, resize, input_w = *in_w, input_h = *in_h,
640 output_w = *out_w, output_h = *out_h;
641 u16 inc_sel, wb_bit8, wb_left, wb_right, wb_top, wb_bottom;
642 unsigned int peak, peak_50, peak_60;
646 * We have a problem with crops, where the window is larger than 512x384
647 * and output window is larger than a half of the input one. In this
648 * case we have to either reduce the input window to equal or below
649 * 512x384 or the output window to equal or below 1/2 of the input.
651 if (output_w > max(512U, input_w / 2)) {
652 if (2 * output_w > RJ54N1_MAX_WIDTH) {
653 input_w = RJ54N1_MAX_WIDTH;
654 output_w = RJ54N1_MAX_WIDTH / 2;
656 input_w = output_w * 2;
659 dev_dbg(&client->dev, "Adjusted output width: in %u, out %u\n",
663 if (output_h > max(384U, input_h / 2)) {
664 if (2 * output_h > RJ54N1_MAX_HEIGHT) {
665 input_h = RJ54N1_MAX_HEIGHT;
666 output_h = RJ54N1_MAX_HEIGHT / 2;
668 input_h = output_h * 2;
671 dev_dbg(&client->dev, "Adjusted output height: in %u, out %u\n",
675 /* Idea: use the read mode for snapshots, handle separate geometries */
676 ret = rj54n1_set_rect(client, RJ54N1_X_OUTPUT_SIZE_S_L,
677 RJ54N1_Y_OUTPUT_SIZE_S_L,
678 RJ54N1_XY_OUTPUT_SIZE_S_H, output_w, output_h);
680 ret = rj54n1_set_rect(client, RJ54N1_X_OUTPUT_SIZE_P_L,
681 RJ54N1_Y_OUTPUT_SIZE_P_L,
682 RJ54N1_XY_OUTPUT_SIZE_P_H, output_w, output_h);
687 if (output_w > input_w && output_h > input_h) {
693 unsigned int resize_x, resize_y;
694 resize_x = (input_w * 1024 + output_w / 2) / output_w;
695 resize_y = (input_h * 1024 + output_h / 2) / output_h;
697 /* We want max(resize_x, resize_y), check if it still fits */
698 if (resize_x > resize_y &&
699 (output_h * resize_x + 512) / 1024 > RJ54N1_MAX_HEIGHT)
700 resize = (RJ54N1_MAX_HEIGHT * 1024 + output_h / 2) /
702 else if (resize_y > resize_x &&
703 (output_w * resize_y + 512) / 1024 > RJ54N1_MAX_WIDTH)
704 resize = (RJ54N1_MAX_WIDTH * 1024 + output_w / 2) /
707 resize = max(resize_x, resize_y);
709 /* Prohibited value ranges */
720 case 16320 ... 16384:
726 ret = reg_write(client, RJ54N1_RESIZE_HOLD_L, resize & 0xff);
728 ret = reg_write(client, RJ54N1_RESIZE_HOLD_H, resize >> 8);
734 * Configure a skipping bitmask. The sensor will select a skipping value
735 * among set bits automatically. This is very unclear in the datasheet
736 * too. I was told, in this register one enables all skipping values,
737 * that are required for a specific resize, and the camera selects
738 * automatically, which ones to use. But it is unclear how to identify,
739 * which cropping values are needed. Secondly, why don't we just set all
740 * bits and let the camera choose? Would it increase processing time and
741 * reduce the framerate? Using 0xfffc for INC_USE_SEL doesn't seem to
742 * improve the image quality or stability for larger frames (see comment
743 * above), but I didn't check the framerate.
745 skip = min(resize / 1024, 15U);
751 else if (resize & 1023 && skip < 15)
752 inc_sel |= 1 << (skip + 1);
754 ret = reg_write(client, RJ54N1_INC_USE_SEL_L, inc_sel & 0xfc);
756 ret = reg_write(client, RJ54N1_INC_USE_SEL_H, inc_sel >> 8);
758 if (!rj54n1->auto_wb) {
759 /* Auto white balance window */
760 wb_left = output_w / 16;
761 wb_right = (3 * output_w / 4 - 3) / 4;
762 wb_top = output_h / 16;
763 wb_bottom = (3 * output_h / 4 - 3) / 4;
764 wb_bit8 = ((wb_left >> 2) & 0x40) | ((wb_top >> 4) & 0x10) |
765 ((wb_right >> 6) & 4) | ((wb_bottom >> 8) & 1);
768 ret = reg_write(client, RJ54N1_BIT8_WB, wb_bit8);
770 ret = reg_write(client, RJ54N1_HCAPS_WB, wb_left);
772 ret = reg_write(client, RJ54N1_VCAPS_WB, wb_top);
774 ret = reg_write(client, RJ54N1_HCAPE_WB, wb_right);
776 ret = reg_write(client, RJ54N1_VCAPE_WB, wb_bottom);
780 peak = 12 * RJ54N1_MAX_WIDTH * (1 << 14) * resize / rj54n1->tgclk_mhz /
786 ret = reg_write(client, RJ54N1_PEAK_H,
787 ((peak_50 >> 4) & 0xf0) | (peak_60 >> 8));
789 ret = reg_write(client, RJ54N1_PEAK_50, peak_50);
791 ret = reg_write(client, RJ54N1_PEAK_60, peak_60);
793 ret = reg_write(client, RJ54N1_PEAK_DIFF, peak / 150);
797 ret = reg_write(client, RJ54N1_RESIZE_CONTROL,
798 RESIZE_HOLD_SEL | RESIZE_GO | 1);
803 /* Constant taken from manufacturer's example */
806 ret = reg_write(client, RJ54N1_RESIZE_CONTROL, RESIZE_HOLD_SEL | 1);
810 *in_w = (output_w * resize + 512) / 1024;
811 *in_h = (output_h * resize + 512) / 1024;
815 dev_dbg(&client->dev, "Scaled for %dx%d : %u = %ux%u, skip %u\n",
816 *in_w, *in_h, resize, output_w, output_h, skip);
821 static int rj54n1_set_clock(struct i2c_client *client)
823 struct rj54n1 *rj54n1 = to_rj54n1(client);
826 /* Enable external clock */
827 ret = reg_write(client, RJ54N1_RESET_STANDBY, E_EXCLK | SOFT_STDBY);
828 /* Leave stand-by. Note: use this when implementing suspend / resume */
830 ret = reg_write(client, RJ54N1_RESET_STANDBY, E_EXCLK);
833 ret = reg_write(client, RJ54N1_PLL_L, PLL_L);
835 ret = reg_write(client, RJ54N1_PLL_N, PLL_N);
839 ret = reg_write(client, RJ54N1_RATIO_TG,
840 rj54n1->clk_div.ratio_tg);
842 ret = reg_write(client, RJ54N1_RATIO_T,
843 rj54n1->clk_div.ratio_t);
845 ret = reg_write(client, RJ54N1_RATIO_R,
846 rj54n1->clk_div.ratio_r);
848 /* Enable TGCLK & RAMP */
850 ret = reg_write(client, RJ54N1_RAMP_TGCLK_EN, 3);
852 /* Disable clock output */
854 ret = reg_write(client, RJ54N1_OCLK_DSP, 0);
858 ret = reg_write(client, RJ54N1_RATIO_OP,
859 rj54n1->clk_div.ratio_op);
861 ret = reg_write(client, RJ54N1_RATIO_O,
862 rj54n1->clk_div.ratio_o);
866 ret = reg_write(client, RJ54N1_OCLK_SEL_EN, 1);
868 /* Use PLL for Timing Generator, write 2 to reserved bits */
870 ret = reg_write(client, RJ54N1_TG_BYPASS, 2);
872 /* Take sensor out of reset */
874 ret = reg_write(client, RJ54N1_RESET_STANDBY,
878 ret = reg_write(client, RJ54N1_PLL_EN, 1);
880 /* Wait for PLL to stabilise */
883 /* Enable clock to frequency divider */
885 ret = reg_write(client, RJ54N1_CLK_RST, 1);
888 ret = reg_read(client, RJ54N1_CLK_RST);
890 dev_err(&client->dev,
891 "Resetting RJ54N1CB0C clock failed: %d!\n", ret);
896 ret = reg_set(client, RJ54N1_OCLK_DSP, 1, 1);
900 ret = reg_write(client, RJ54N1_OCLK_SEL_EN, 1);
905 static int rj54n1_reg_init(struct i2c_client *client)
907 struct rj54n1 *rj54n1 = to_rj54n1(client);
908 int ret = rj54n1_set_clock(client);
911 ret = reg_write_multiple(client, bank_7, ARRAY_SIZE(bank_7));
913 ret = reg_write_multiple(client, bank_10, ARRAY_SIZE(bank_10));
915 /* Set binning divisors */
917 ret = reg_write(client, RJ54N1_SCALE_1_2_LEV, 3 | (7 << 4));
919 ret = reg_write(client, RJ54N1_SCALE_4_LEV, 0xf);
921 /* Switch to fixed resize mode */
923 ret = reg_write(client, RJ54N1_RESIZE_CONTROL,
924 RESIZE_HOLD_SEL | 1);
928 ret = reg_write(client, RJ54N1_Y_GAIN, 0x84);
931 * Mirror the image back: default is upside down and left-to-right...
932 * Set manual preview / still shot switching
935 ret = reg_write(client, RJ54N1_MIRROR_STILL_MODE, 0x27);
938 ret = reg_write_multiple(client, bank_4, ARRAY_SIZE(bank_4));
940 /* Auto exposure area */
942 ret = reg_write(client, RJ54N1_EXPOSURE_CONTROL, 0x80);
943 /* Check current auto WB config */
945 ret = reg_read(client, RJ54N1_WB_SEL_WEIGHT_I);
947 rj54n1->auto_wb = ret & 0x80;
948 ret = reg_write_multiple(client, bank_5, ARRAY_SIZE(bank_5));
951 ret = reg_write_multiple(client, bank_8, ARRAY_SIZE(bank_8));
954 ret = reg_write(client, RJ54N1_RESET_STANDBY,
955 E_EXCLK | DSP_RSTX | SEN_RSTX);
959 ret = rj54n1_commit(client);
961 /* Take DSP, TG, sensor out of reset */
963 ret = reg_write(client, RJ54N1_RESET_STANDBY,
964 E_EXCLK | DSP_RSTX | TG_RSTX | SEN_RSTX);
966 /* Start register update? Same register as 0x?FE in many bank_* sets */
968 ret = reg_write(client, RJ54N1_FWFLG, 2);
970 /* Constant taken from manufacturer's example */
976 static int rj54n1_set_fmt(struct v4l2_subdev *sd,
977 struct v4l2_subdev_pad_config *cfg,
978 struct v4l2_subdev_format *format)
980 struct v4l2_mbus_framefmt *mf = &format->format;
981 struct i2c_client *client = v4l2_get_subdevdata(sd);
982 struct rj54n1 *rj54n1 = to_rj54n1(client);
983 const struct rj54n1_datafmt *fmt;
984 int output_w, output_h, max_w, max_h,
985 input_w = rj54n1->rect.width, input_h = rj54n1->rect.height;
986 int align = mf->code == MEDIA_BUS_FMT_SBGGR10_1X10 ||
987 mf->code == MEDIA_BUS_FMT_SBGGR10_2X8_PADHI_BE ||
988 mf->code == MEDIA_BUS_FMT_SBGGR10_2X8_PADLO_BE ||
989 mf->code == MEDIA_BUS_FMT_SBGGR10_2X8_PADHI_LE ||
990 mf->code == MEDIA_BUS_FMT_SBGGR10_2X8_PADLO_LE;
996 dev_dbg(&client->dev, "%s: code = %d, width = %u, height = %u\n",
997 __func__, mf->code, mf->width, mf->height);
999 fmt = rj54n1_find_datafmt(mf->code, rj54n1_colour_fmts,
1000 ARRAY_SIZE(rj54n1_colour_fmts));
1003 mf->code = fmt->code;
1006 mf->field = V4L2_FIELD_NONE;
1007 mf->colorspace = fmt->colorspace;
1009 v4l_bound_align_image(&mf->width, 112, RJ54N1_MAX_WIDTH, align,
1010 &mf->height, 84, RJ54N1_MAX_HEIGHT, align, 0);
1012 if (format->which == V4L2_SUBDEV_FORMAT_TRY) {
1018 * Verify if the sensor has just been powered on. TODO: replace this
1019 * with proper PM, when a suitable API is available.
1021 ret = reg_read(client, RJ54N1_RESET_STANDBY);
1025 if (!(ret & E_EXCLK)) {
1026 ret = rj54n1_reg_init(client);
1031 /* RA_SEL_UL is only relevant for raw modes, ignored otherwise. */
1033 case MEDIA_BUS_FMT_YUYV8_2X8:
1034 ret = reg_write(client, RJ54N1_OUT_SEL, 0);
1036 ret = reg_set(client, RJ54N1_BYTE_SWAP, 8, 8);
1038 case MEDIA_BUS_FMT_YVYU8_2X8:
1039 ret = reg_write(client, RJ54N1_OUT_SEL, 0);
1041 ret = reg_set(client, RJ54N1_BYTE_SWAP, 0, 8);
1043 case MEDIA_BUS_FMT_RGB565_2X8_LE:
1044 ret = reg_write(client, RJ54N1_OUT_SEL, 0x11);
1046 ret = reg_set(client, RJ54N1_BYTE_SWAP, 8, 8);
1048 case MEDIA_BUS_FMT_RGB565_2X8_BE:
1049 ret = reg_write(client, RJ54N1_OUT_SEL, 0x11);
1051 ret = reg_set(client, RJ54N1_BYTE_SWAP, 0, 8);
1053 case MEDIA_BUS_FMT_SBGGR10_2X8_PADLO_LE:
1054 ret = reg_write(client, RJ54N1_OUT_SEL, 4);
1056 ret = reg_set(client, RJ54N1_BYTE_SWAP, 8, 8);
1058 ret = reg_write(client, RJ54N1_RA_SEL_UL, 0);
1060 case MEDIA_BUS_FMT_SBGGR10_2X8_PADHI_LE:
1061 ret = reg_write(client, RJ54N1_OUT_SEL, 4);
1063 ret = reg_set(client, RJ54N1_BYTE_SWAP, 8, 8);
1065 ret = reg_write(client, RJ54N1_RA_SEL_UL, 8);
1067 case MEDIA_BUS_FMT_SBGGR10_2X8_PADLO_BE:
1068 ret = reg_write(client, RJ54N1_OUT_SEL, 4);
1070 ret = reg_set(client, RJ54N1_BYTE_SWAP, 0, 8);
1072 ret = reg_write(client, RJ54N1_RA_SEL_UL, 0);
1074 case MEDIA_BUS_FMT_SBGGR10_2X8_PADHI_BE:
1075 ret = reg_write(client, RJ54N1_OUT_SEL, 4);
1077 ret = reg_set(client, RJ54N1_BYTE_SWAP, 0, 8);
1079 ret = reg_write(client, RJ54N1_RA_SEL_UL, 8);
1081 case MEDIA_BUS_FMT_SBGGR10_1X10:
1082 ret = reg_write(client, RJ54N1_OUT_SEL, 5);
1088 /* Special case: a raw mode with 10 bits of data per clock tick */
1090 ret = reg_set(client, RJ54N1_OCLK_SEL_EN,
1091 (mf->code == MEDIA_BUS_FMT_SBGGR10_1X10) << 1, 2);
1096 /* Supported scales 1:1 >= scale > 1:16 */
1097 max_w = mf->width * (16 * 1024 - 1) / 1024;
1098 if (input_w > max_w)
1100 max_h = mf->height * (16 * 1024 - 1) / 1024;
1101 if (input_h > max_h)
1104 output_w = mf->width;
1105 output_h = mf->height;
1107 ret = rj54n1_sensor_scale(sd, &input_w, &input_h, &output_w, &output_h);
1111 fmt = rj54n1_find_datafmt(mf->code, rj54n1_colour_fmts,
1112 ARRAY_SIZE(rj54n1_colour_fmts));
1115 rj54n1->resize = ret;
1116 rj54n1->rect.width = input_w;
1117 rj54n1->rect.height = input_h;
1118 rj54n1->width = output_w;
1119 rj54n1->height = output_h;
1121 mf->width = output_w;
1122 mf->height = output_h;
1123 mf->field = V4L2_FIELD_NONE;
1124 mf->colorspace = fmt->colorspace;
1129 #ifdef CONFIG_VIDEO_ADV_DEBUG
1130 static int rj54n1_g_register(struct v4l2_subdev *sd,
1131 struct v4l2_dbg_register *reg)
1133 struct i2c_client *client = v4l2_get_subdevdata(sd);
1135 if (reg->reg < 0x400 || reg->reg > 0x1fff)
1136 /* Registers > 0x0800 are only available from Sharp support */
1140 reg->val = reg_read(client, reg->reg);
1142 if (reg->val > 0xff)
1148 static int rj54n1_s_register(struct v4l2_subdev *sd,
1149 const struct v4l2_dbg_register *reg)
1151 struct i2c_client *client = v4l2_get_subdevdata(sd);
1153 if (reg->reg < 0x400 || reg->reg > 0x1fff)
1154 /* Registers >= 0x0800 are only available from Sharp support */
1157 if (reg_write(client, reg->reg, reg->val) < 0)
1164 static int rj54n1_s_power(struct v4l2_subdev *sd, int on)
1166 struct i2c_client *client = v4l2_get_subdevdata(sd);
1167 struct rj54n1 *rj54n1 = to_rj54n1(client);
1170 if (rj54n1->pwup_gpio)
1171 gpiod_set_value(rj54n1->pwup_gpio, 1);
1172 if (rj54n1->enable_gpio)
1173 gpiod_set_value(rj54n1->enable_gpio, 1);
1177 return clk_prepare_enable(rj54n1->clk);
1180 clk_disable_unprepare(rj54n1->clk);
1182 if (rj54n1->enable_gpio)
1183 gpiod_set_value(rj54n1->enable_gpio, 0);
1184 if (rj54n1->pwup_gpio)
1185 gpiod_set_value(rj54n1->pwup_gpio, 0);
1190 static int rj54n1_s_ctrl(struct v4l2_ctrl *ctrl)
1192 struct rj54n1 *rj54n1 = container_of(ctrl->handler, struct rj54n1, hdl);
1193 struct v4l2_subdev *sd = &rj54n1->subdev;
1194 struct i2c_client *client = v4l2_get_subdevdata(sd);
1198 case V4L2_CID_VFLIP:
1200 data = reg_set(client, RJ54N1_MIRROR_STILL_MODE, 0, 1);
1202 data = reg_set(client, RJ54N1_MIRROR_STILL_MODE, 1, 1);
1206 case V4L2_CID_HFLIP:
1208 data = reg_set(client, RJ54N1_MIRROR_STILL_MODE, 0, 2);
1210 data = reg_set(client, RJ54N1_MIRROR_STILL_MODE, 2, 2);
1215 if (reg_write(client, RJ54N1_Y_GAIN, ctrl->val * 2) < 0)
1218 case V4L2_CID_AUTO_WHITE_BALANCE:
1219 /* Auto WB area - whole image */
1220 if (reg_set(client, RJ54N1_WB_SEL_WEIGHT_I, ctrl->val << 7,
1223 rj54n1->auto_wb = ctrl->val;
1230 static const struct v4l2_ctrl_ops rj54n1_ctrl_ops = {
1231 .s_ctrl = rj54n1_s_ctrl,
1234 static const struct v4l2_subdev_core_ops rj54n1_subdev_core_ops = {
1235 #ifdef CONFIG_VIDEO_ADV_DEBUG
1236 .g_register = rj54n1_g_register,
1237 .s_register = rj54n1_s_register,
1239 .s_power = rj54n1_s_power,
1242 static const struct v4l2_subdev_video_ops rj54n1_subdev_video_ops = {
1243 .s_stream = rj54n1_s_stream,
1246 static const struct v4l2_subdev_pad_ops rj54n1_subdev_pad_ops = {
1247 .enum_mbus_code = rj54n1_enum_mbus_code,
1248 .get_selection = rj54n1_get_selection,
1249 .set_selection = rj54n1_set_selection,
1250 .get_fmt = rj54n1_get_fmt,
1251 .set_fmt = rj54n1_set_fmt,
1254 static const struct v4l2_subdev_ops rj54n1_subdev_ops = {
1255 .core = &rj54n1_subdev_core_ops,
1256 .video = &rj54n1_subdev_video_ops,
1257 .pad = &rj54n1_subdev_pad_ops,
1261 * Interface active, can use i2c. If it fails, it can indeed mean, that
1262 * this wasn't our capture interface, so, we wait for the right one
1264 static int rj54n1_video_probe(struct i2c_client *client,
1265 struct rj54n1_pdata *priv)
1267 struct rj54n1 *rj54n1 = to_rj54n1(client);
1271 ret = rj54n1_s_power(&rj54n1->subdev, 1);
1275 /* Read out the chip version register */
1276 data1 = reg_read(client, RJ54N1_DEV_CODE);
1277 data2 = reg_read(client, RJ54N1_DEV_CODE2);
1279 if (data1 != 0x51 || data2 != 0x10) {
1281 dev_info(&client->dev, "No RJ54N1CB0C found, read 0x%x:0x%x\n",
1286 /* Configure IOCTL polarity from the platform data: 0 or 1 << 7. */
1287 ret = reg_write(client, RJ54N1_IOC, priv->ioctl_high << 7);
1291 dev_info(&client->dev, "Detected a RJ54N1CB0C chip ID 0x%x:0x%x\n",
1294 ret = v4l2_ctrl_handler_setup(&rj54n1->hdl);
1297 rj54n1_s_power(&rj54n1->subdev, 0);
1301 static int rj54n1_probe(struct i2c_client *client,
1302 const struct i2c_device_id *did)
1304 struct rj54n1 *rj54n1;
1305 struct i2c_adapter *adapter = client->adapter;
1306 struct rj54n1_pdata *rj54n1_priv;
1309 if (!client->dev.platform_data) {
1310 dev_err(&client->dev, "RJ54N1CB0C: missing platform data!\n");
1314 rj54n1_priv = client->dev.platform_data;
1316 if (!i2c_check_functionality(adapter, I2C_FUNC_SMBUS_BYTE_DATA)) {
1317 dev_warn(&adapter->dev,
1318 "I2C-Adapter doesn't support I2C_FUNC_SMBUS_BYTE\n");
1322 rj54n1 = devm_kzalloc(&client->dev, sizeof(struct rj54n1), GFP_KERNEL);
1326 v4l2_i2c_subdev_init(&rj54n1->subdev, client, &rj54n1_subdev_ops);
1327 v4l2_ctrl_handler_init(&rj54n1->hdl, 4);
1328 v4l2_ctrl_new_std(&rj54n1->hdl, &rj54n1_ctrl_ops,
1329 V4L2_CID_VFLIP, 0, 1, 1, 0);
1330 v4l2_ctrl_new_std(&rj54n1->hdl, &rj54n1_ctrl_ops,
1331 V4L2_CID_HFLIP, 0, 1, 1, 0);
1332 v4l2_ctrl_new_std(&rj54n1->hdl, &rj54n1_ctrl_ops,
1333 V4L2_CID_GAIN, 0, 127, 1, 66);
1334 v4l2_ctrl_new_std(&rj54n1->hdl, &rj54n1_ctrl_ops,
1335 V4L2_CID_AUTO_WHITE_BALANCE, 0, 1, 1, 1);
1336 rj54n1->subdev.ctrl_handler = &rj54n1->hdl;
1337 if (rj54n1->hdl.error)
1338 return rj54n1->hdl.error;
1340 rj54n1->clk_div = clk_div;
1341 rj54n1->rect.left = RJ54N1_COLUMN_SKIP;
1342 rj54n1->rect.top = RJ54N1_ROW_SKIP;
1343 rj54n1->rect.width = RJ54N1_MAX_WIDTH;
1344 rj54n1->rect.height = RJ54N1_MAX_HEIGHT;
1345 rj54n1->width = RJ54N1_MAX_WIDTH;
1346 rj54n1->height = RJ54N1_MAX_HEIGHT;
1347 rj54n1->fmt = &rj54n1_colour_fmts[0];
1348 rj54n1->resize = 1024;
1349 rj54n1->tgclk_mhz = (rj54n1_priv->mclk_freq / PLL_L * PLL_N) /
1350 (clk_div.ratio_tg + 1) / (clk_div.ratio_t + 1);
1352 rj54n1->clk = clk_get(&client->dev, NULL);
1353 if (IS_ERR(rj54n1->clk)) {
1354 ret = PTR_ERR(rj54n1->clk);
1358 rj54n1->pwup_gpio = gpiod_get_optional(&client->dev, "powerup",
1360 if (IS_ERR(rj54n1->pwup_gpio)) {
1361 dev_info(&client->dev, "Unable to get GPIO \"powerup\": %ld\n",
1362 PTR_ERR(rj54n1->pwup_gpio));
1363 ret = PTR_ERR(rj54n1->pwup_gpio);
1367 rj54n1->enable_gpio = gpiod_get_optional(&client->dev, "enable",
1369 if (IS_ERR(rj54n1->enable_gpio)) {
1370 dev_info(&client->dev, "Unable to get GPIO \"enable\": %ld\n",
1371 PTR_ERR(rj54n1->enable_gpio));
1372 ret = PTR_ERR(rj54n1->enable_gpio);
1376 ret = rj54n1_video_probe(client, rj54n1_priv);
1380 ret = v4l2_async_register_subdev(&rj54n1->subdev);
1387 if (rj54n1->enable_gpio)
1388 gpiod_put(rj54n1->enable_gpio);
1390 if (rj54n1->pwup_gpio)
1391 gpiod_put(rj54n1->pwup_gpio);
1394 clk_put(rj54n1->clk);
1397 v4l2_ctrl_handler_free(&rj54n1->hdl);
1402 static int rj54n1_remove(struct i2c_client *client)
1404 struct rj54n1 *rj54n1 = to_rj54n1(client);
1406 if (rj54n1->enable_gpio)
1407 gpiod_put(rj54n1->enable_gpio);
1408 if (rj54n1->pwup_gpio)
1409 gpiod_put(rj54n1->pwup_gpio);
1411 clk_put(rj54n1->clk);
1412 v4l2_ctrl_handler_free(&rj54n1->hdl);
1413 v4l2_async_unregister_subdev(&rj54n1->subdev);
1418 static const struct i2c_device_id rj54n1_id[] = {
1419 { "rj54n1cb0c", 0 },
1422 MODULE_DEVICE_TABLE(i2c, rj54n1_id);
1424 static struct i2c_driver rj54n1_i2c_driver = {
1426 .name = "rj54n1cb0c",
1428 .probe = rj54n1_probe,
1429 .remove = rj54n1_remove,
1430 .id_table = rj54n1_id,
1433 module_i2c_driver(rj54n1_i2c_driver);
1435 MODULE_DESCRIPTION("Sharp RJ54N1CB0C Camera driver");
1436 MODULE_AUTHOR("Guennadi Liakhovetski <g.liakhovetski@gmx.de>");
1437 MODULE_LICENSE("GPL v2");