1 // SPDX-License-Identifier: GPL-2.0
3 * A V4L2 driver for Sony IMX708 cameras.
4 * Copyright (C) 2022, Raspberry Pi Ltd
6 * Based on Sony imx477 camera driver
7 * Copyright (C) 2020 Raspberry Pi Ltd
9 #include <asm/unaligned.h>
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/pm_runtime.h>
16 #include <linux/regulator/consumer.h>
17 #include <media/v4l2-ctrls.h>
18 #include <media/v4l2-device.h>
19 #include <media/v4l2-event.h>
20 #include <media/v4l2-fwnode.h>
21 #include <media/v4l2-mediabus.h>
23 #define IMX708_REG_VALUE_08BIT 1
24 #define IMX708_REG_VALUE_16BIT 2
27 #define IMX708_REG_CHIP_ID 0x0016
28 #define IMX708_CHIP_ID 0x0708
30 #define IMX708_REG_MODE_SELECT 0x0100
31 #define IMX708_MODE_STANDBY 0x00
32 #define IMX708_MODE_STREAMING 0x01
34 #define IMX708_REG_ORIENTATION 0x101
36 #define IMX708_XCLK_FREQ 24000000
38 #define IMX708_DEFAULT_LINK_FREQ 450000000
40 /* Default initial pixel rate, will get updated for each mode. */
41 #define IMX708_INITIAL_PIXEL_RATE 590000000
43 /* V_TIMING internal */
44 #define IMX708_REG_FRAME_LENGTH 0x0340
45 #define IMX708_FRAME_LENGTH_MAX 0xffff
47 /* Long exposure multiplier */
48 #define IMX708_LONG_EXP_SHIFT_MAX 7
49 #define IMX708_LONG_EXP_SHIFT_REG 0x3100
51 /* Exposure control */
52 #define IMX708_REG_EXPOSURE 0x0202
53 #define IMX708_EXPOSURE_OFFSET 48
54 #define IMX708_EXPOSURE_DEFAULT 0x640
55 #define IMX708_EXPOSURE_STEP 1
56 #define IMX708_EXPOSURE_MIN 1
57 #define IMX708_EXPOSURE_MAX (IMX708_FRAME_LENGTH_MAX - \
58 IMX708_EXPOSURE_OFFSET)
60 /* Analog gain control */
61 #define IMX708_REG_ANALOG_GAIN 0x0204
62 #define IMX708_ANA_GAIN_MIN 112
63 #define IMX708_ANA_GAIN_MAX 960
64 #define IMX708_ANA_GAIN_STEP 1
65 #define IMX708_ANA_GAIN_DEFAULT IMX708_ANA_GAIN_MIN
67 /* Digital gain control */
68 #define IMX708_REG_DIGITAL_GAIN 0x020e
69 #define IMX708_DGTL_GAIN_MIN 0x0100
70 #define IMX708_DGTL_GAIN_MAX 0xffff
71 #define IMX708_DGTL_GAIN_DEFAULT 0x0100
72 #define IMX708_DGTL_GAIN_STEP 1
74 /* Colour balance controls */
75 #define IMX708_REG_COLOUR_BALANCE_RED 0x0b90
76 #define IMX708_REG_COLOUR_BALANCE_BLUE 0x0b92
77 #define IMX708_COLOUR_BALANCE_MIN 0x01
78 #define IMX708_COLOUR_BALANCE_MAX 0xffff
79 #define IMX708_COLOUR_BALANCE_STEP 0x01
80 #define IMX708_COLOUR_BALANCE_DEFAULT 0x100
82 /* Test Pattern Control */
83 #define IMX708_REG_TEST_PATTERN 0x0600
84 #define IMX708_TEST_PATTERN_DISABLE 0
85 #define IMX708_TEST_PATTERN_SOLID_COLOR 1
86 #define IMX708_TEST_PATTERN_COLOR_BARS 2
87 #define IMX708_TEST_PATTERN_GREY_COLOR 3
88 #define IMX708_TEST_PATTERN_PN9 4
90 /* Test pattern colour components */
91 #define IMX708_REG_TEST_PATTERN_R 0x0602
92 #define IMX708_REG_TEST_PATTERN_GR 0x0604
93 #define IMX708_REG_TEST_PATTERN_B 0x0606
94 #define IMX708_REG_TEST_PATTERN_GB 0x0608
95 #define IMX708_TEST_PATTERN_COLOUR_MIN 0
96 #define IMX708_TEST_PATTERN_COLOUR_MAX 0x0fff
97 #define IMX708_TEST_PATTERN_COLOUR_STEP 1
99 #define IMX708_REG_BASE_SPC_GAINS_L 0x7b10
100 #define IMX708_REG_BASE_SPC_GAINS_R 0x7c00
102 /* HDR exposure ratio (long:med == med:short) */
103 #define IMX708_HDR_EXPOSURE_RATIO 4
104 #define IMX708_REG_MID_EXPOSURE 0x3116
105 #define IMX708_REG_SHT_EXPOSURE 0x0224
106 #define IMX708_REG_MID_ANALOG_GAIN 0x3118
107 #define IMX708_REG_SHT_ANALOG_GAIN 0x0216
110 * Metadata buffer holds a variety of data, all sent with the same VC/DT (0x12).
111 * It comprises two scanlines (of up to 5760 bytes each, for 4608 pixels)
112 * of embedded data, one line of PDAF data, and two lines of AE-HIST data
113 * (AE histograms are valid for HDR mode and empty in non-HDR modes).
115 #define IMX708_EMBEDDED_LINE_WIDTH (5 * 5760)
116 #define IMX708_NUM_EMBEDDED_LINES 1
124 /* IMX708 native and active pixel array size. */
125 #define IMX708_NATIVE_WIDTH 4640U
126 #define IMX708_NATIVE_HEIGHT 2658U
127 #define IMX708_PIXEL_ARRAY_LEFT 16U
128 #define IMX708_PIXEL_ARRAY_TOP 24U
129 #define IMX708_PIXEL_ARRAY_WIDTH 4608U
130 #define IMX708_PIXEL_ARRAY_HEIGHT 2592U
137 struct imx708_reg_list {
138 unsigned int num_of_regs;
139 const struct imx708_reg *regs;
142 /* Mode : resolution and related config&values */
150 /* H-timing in pixels */
151 unsigned int line_length_pix;
153 /* Analog crop rectangle. */
154 struct v4l2_rect crop;
156 /* Highest possible framerate. */
157 unsigned int vblank_min;
159 /* Default framerate. */
160 unsigned int vblank_default;
162 /* Default register values */
163 struct imx708_reg_list reg_list;
165 /* Not all modes have the same pixel rate. */
168 /* Not all modes have the same minimum exposure. */
169 u32 exposure_lines_min;
171 /* Not all modes have the same exposure lines step. */
172 u32 exposure_lines_step;
174 /* HDR flag, currently not used at runtime */
178 /* Default PDAF pixel correction gains */
179 static const u8 pdaf_gains[2][9] = {
180 { 0x4c, 0x4c, 0x4c, 0x46, 0x3e, 0x38, 0x35, 0x35, 0x35 },
181 { 0x35, 0x35, 0x35, 0x38, 0x3e, 0x46, 0x4c, 0x4c, 0x4c }
184 static const struct imx708_reg mode_common_regs[] = {
236 static const struct imx708_reg mode_4608x2592_regs[] = {
334 static const struct imx708_reg mode_2x2binned_regs[] = {
430 static const struct imx708_reg mode_2x2binned_720p_regs[] = {
526 static const struct imx708_reg mode_hdr_regs[] = {
540 {0x0222, IMX708_HDR_EXPOSURE_RATIO},
624 /* Mode configs. Keep separate lists for when HDR is enabled or not. */
625 static const struct imx708_mode supported_modes_10bit_no_hdr[] = {
627 /* Full resolution. */
630 .line_length_pix = 0x3d20,
632 .left = IMX708_PIXEL_ARRAY_LEFT,
633 .top = IMX708_PIXEL_ARRAY_TOP,
638 .vblank_default = 58,
640 .num_of_regs = ARRAY_SIZE(mode_4608x2592_regs),
641 .regs = mode_4608x2592_regs,
643 .pixel_rate = 595200000,
644 .exposure_lines_min = 8,
645 .exposure_lines_step = 1,
649 /* regular 2x2 binned. */
652 .line_length_pix = 0x1e90,
654 .left = IMX708_PIXEL_ARRAY_LEFT,
655 .top = IMX708_PIXEL_ARRAY_TOP,
660 .vblank_default = 1198,
662 .num_of_regs = ARRAY_SIZE(mode_2x2binned_regs),
663 .regs = mode_2x2binned_regs,
665 .pixel_rate = 585600000,
666 .exposure_lines_min = 4,
667 .exposure_lines_step = 2,
671 /* 2x2 binned and cropped for 720p. */
674 .line_length_pix = 0x1460,
676 .left = IMX708_PIXEL_ARRAY_LEFT,
677 .top = IMX708_PIXEL_ARRAY_TOP,
682 .vblank_default = 2755,
684 .num_of_regs = ARRAY_SIZE(mode_2x2binned_720p_regs),
685 .regs = mode_2x2binned_720p_regs,
687 .pixel_rate = 566400000,
688 .exposure_lines_min = 4,
689 .exposure_lines_step = 2,
694 static const struct imx708_mode supported_modes_10bit_hdr[] = {
696 /* There's only one HDR mode, which is 2x2 downscaled */
699 .line_length_pix = 0x1460,
701 .left = IMX708_PIXEL_ARRAY_LEFT,
702 .top = IMX708_PIXEL_ARRAY_TOP,
707 .vblank_default = 3673,
709 .num_of_regs = ARRAY_SIZE(mode_hdr_regs),
710 .regs = mode_hdr_regs,
712 .pixel_rate = 777600000,
713 .exposure_lines_min = 8 * IMX708_HDR_EXPOSURE_RATIO * IMX708_HDR_EXPOSURE_RATIO,
714 .exposure_lines_step = 2 * IMX708_HDR_EXPOSURE_RATIO * IMX708_HDR_EXPOSURE_RATIO,
720 * The supported formats.
721 * This table MUST contain 4 entries per format, to cover the various flip
722 * combinations in the order
728 static const u32 codes[] = {
730 MEDIA_BUS_FMT_SRGGB10_1X10,
731 MEDIA_BUS_FMT_SGRBG10_1X10,
732 MEDIA_BUS_FMT_SGBRG10_1X10,
733 MEDIA_BUS_FMT_SBGGR10_1X10,
736 static const char * const imx708_test_pattern_menu[] = {
744 static const int imx708_test_pattern_val[] = {
745 IMX708_TEST_PATTERN_DISABLE,
746 IMX708_TEST_PATTERN_COLOR_BARS,
747 IMX708_TEST_PATTERN_SOLID_COLOR,
748 IMX708_TEST_PATTERN_GREY_COLOR,
749 IMX708_TEST_PATTERN_PN9,
752 /* regulator supplies */
753 static const char * const imx708_supply_name[] = {
754 /* Supplies can be enabled in any order */
755 "VANA1", /* Analog1 (2.8V) supply */
756 "VANA2", /* Analog2 (1.8V) supply */
757 "VDIG", /* Digital Core (1.1V) supply */
758 "VDDL", /* IF (1.8V) supply */
761 #define IMX708_NUM_SUPPLIES ARRAY_SIZE(imx708_supply_name)
764 * Initialisation delay between XCLR low->high and the moment when the sensor
765 * can start capture (i.e. can leave software standby), given by T7 in the
766 * datasheet is 8ms. This does include I2C setup time as well.
768 * Note, that delay between XCLR low->high and reading the CCI ID register (T6
769 * in the datasheet) is much smaller - 600us.
771 #define IMX708_XCLR_MIN_DELAY_US 8000
772 #define IMX708_XCLR_DELAY_RANGE_US 1000
775 struct v4l2_subdev sd;
776 struct media_pad pad[NUM_PADS];
778 struct v4l2_mbus_framefmt fmt;
783 struct gpio_desc *reset_gpio;
784 struct regulator_bulk_data supplies[IMX708_NUM_SUPPLIES];
786 struct v4l2_ctrl_handler ctrl_handler;
788 struct v4l2_ctrl *pixel_rate;
789 struct v4l2_ctrl *exposure;
790 struct v4l2_ctrl *vflip;
791 struct v4l2_ctrl *hflip;
792 struct v4l2_ctrl *vblank;
793 struct v4l2_ctrl *hblank;
794 struct v4l2_ctrl *red_balance;
795 struct v4l2_ctrl *blue_balance;
796 struct v4l2_ctrl *notify_gains;
797 struct v4l2_ctrl *hdr_mode;
800 const struct imx708_mode *mode;
803 * Mutex for serialized access:
804 * Protect sensor module set pad format and start/stop streaming safely.
808 /* Streaming on/off */
811 /* Rewrite common registers on stream on? */
812 bool common_regs_written;
814 /* Current long exposure factor in use. Set through V4L2_CID_VBLANK */
815 unsigned int long_exp_shift;
818 static inline struct imx708 *to_imx708(struct v4l2_subdev *_sd)
820 return container_of(_sd, struct imx708, sd);
823 static inline void get_mode_table(unsigned int code,
824 const struct imx708_mode **mode_list,
825 unsigned int *num_modes,
830 case MEDIA_BUS_FMT_SRGGB10_1X10:
831 case MEDIA_BUS_FMT_SGRBG10_1X10:
832 case MEDIA_BUS_FMT_SGBRG10_1X10:
833 case MEDIA_BUS_FMT_SBGGR10_1X10:
835 *mode_list = supported_modes_10bit_hdr;
836 *num_modes = ARRAY_SIZE(supported_modes_10bit_hdr);
838 *mode_list = supported_modes_10bit_no_hdr;
839 *num_modes = ARRAY_SIZE(supported_modes_10bit_no_hdr);
848 /* Read registers up to 2 at a time */
849 static int imx708_read_reg(struct imx708 *imx708, u16 reg, u32 len, u32 *val)
851 struct i2c_client *client = v4l2_get_subdevdata(&imx708->sd);
852 struct i2c_msg msgs[2];
853 u8 addr_buf[2] = { reg >> 8, reg & 0xff };
854 u8 data_buf[4] = { 0, };
860 /* Write register address */
861 msgs[0].addr = client->addr;
863 msgs[0].len = ARRAY_SIZE(addr_buf);
864 msgs[0].buf = addr_buf;
866 /* Read data from register */
867 msgs[1].addr = client->addr;
868 msgs[1].flags = I2C_M_RD;
870 msgs[1].buf = &data_buf[4 - len];
872 ret = i2c_transfer(client->adapter, msgs, ARRAY_SIZE(msgs));
873 if (ret != ARRAY_SIZE(msgs))
876 *val = get_unaligned_be32(data_buf);
881 /* Write registers up to 2 at a time */
882 static int imx708_write_reg(struct imx708 *imx708, u16 reg, u32 len, u32 val)
884 struct i2c_client *client = v4l2_get_subdevdata(&imx708->sd);
890 put_unaligned_be16(reg, buf);
891 put_unaligned_be32(val << (8 * (4 - len)), buf + 2);
892 if (i2c_master_send(client, buf, len + 2) != len + 2)
898 /* Write a list of registers */
899 static int imx708_write_regs(struct imx708 *imx708,
900 const struct imx708_reg *regs, u32 len)
902 struct i2c_client *client = v4l2_get_subdevdata(&imx708->sd);
906 for (i = 0; i < len; i++) {
907 ret = imx708_write_reg(imx708, regs[i].address, 1, regs[i].val);
909 dev_err_ratelimited(&client->dev,
910 "Failed to write reg 0x%4.4x. error = %d\n",
911 regs[i].address, ret);
920 /* Get bayer order based on flip setting. */
921 static u32 imx708_get_format_code(struct imx708 *imx708)
925 lockdep_assert_held(&imx708->mutex);
927 i = (imx708->vflip->val ? 2 : 0) |
928 (imx708->hflip->val ? 1 : 0);
933 static void imx708_set_default_format(struct imx708 *imx708)
935 struct v4l2_mbus_framefmt *fmt = &imx708->fmt;
937 /* Set default mode to max resolution */
938 imx708->mode = &supported_modes_10bit_no_hdr[0];
940 /* fmt->code not set as it will always be computed based on flips */
941 fmt->colorspace = V4L2_COLORSPACE_RAW;
942 fmt->ycbcr_enc = V4L2_MAP_YCBCR_ENC_DEFAULT(fmt->colorspace);
943 fmt->quantization = V4L2_MAP_QUANTIZATION_DEFAULT(true,
946 fmt->xfer_func = V4L2_MAP_XFER_FUNC_DEFAULT(fmt->colorspace);
947 fmt->width = imx708->mode->width;
948 fmt->height = imx708->mode->height;
949 fmt->field = V4L2_FIELD_NONE;
952 static int imx708_open(struct v4l2_subdev *sd, struct v4l2_subdev_fh *fh)
954 struct imx708 *imx708 = to_imx708(sd);
955 struct v4l2_mbus_framefmt *try_fmt_img =
956 v4l2_subdev_get_try_format(sd, fh->state, IMAGE_PAD);
957 struct v4l2_mbus_framefmt *try_fmt_meta =
958 v4l2_subdev_get_try_format(sd, fh->state, METADATA_PAD);
959 struct v4l2_rect *try_crop;
961 mutex_lock(&imx708->mutex);
963 /* Initialize try_fmt for the image pad */
964 if (imx708->hdr_mode->val) {
965 try_fmt_img->width = supported_modes_10bit_hdr[0].width;
966 try_fmt_img->height = supported_modes_10bit_hdr[0].height;
968 try_fmt_img->width = supported_modes_10bit_no_hdr[0].width;
969 try_fmt_img->height = supported_modes_10bit_no_hdr[0].height;
971 try_fmt_img->code = imx708_get_format_code(imx708);
972 try_fmt_img->field = V4L2_FIELD_NONE;
974 /* Initialize try_fmt for the embedded metadata pad */
975 try_fmt_meta->width = IMX708_EMBEDDED_LINE_WIDTH;
976 try_fmt_meta->height = IMX708_NUM_EMBEDDED_LINES;
977 try_fmt_meta->code = MEDIA_BUS_FMT_SENSOR_DATA;
978 try_fmt_meta->field = V4L2_FIELD_NONE;
980 /* Initialize try_crop */
981 try_crop = v4l2_subdev_get_try_crop(sd, fh->state, IMAGE_PAD);
982 try_crop->left = IMX708_PIXEL_ARRAY_LEFT;
983 try_crop->top = IMX708_PIXEL_ARRAY_TOP;
984 try_crop->width = IMX708_PIXEL_ARRAY_WIDTH;
985 try_crop->height = IMX708_PIXEL_ARRAY_HEIGHT;
987 mutex_unlock(&imx708->mutex);
992 static int imx708_set_exposure(struct imx708 *imx708, unsigned int val)
996 val = max(val, imx708->mode->exposure_lines_min);
997 val -= val % imx708->mode->exposure_lines_step;
1000 * In HDR mode this will set the longest exposure. The sensor
1001 * will automatically divide the medium and short ones by 4,16.
1003 ret = imx708_write_reg(imx708, IMX708_REG_EXPOSURE,
1004 IMX708_REG_VALUE_16BIT,
1005 val >> imx708->long_exp_shift);
1010 static void imx708_adjust_exposure_range(struct imx708 *imx708,
1011 struct v4l2_ctrl *ctrl)
1013 int exposure_max, exposure_def;
1015 /* Honour the VBLANK limits when setting exposure. */
1016 exposure_max = imx708->mode->height + imx708->vblank->val -
1017 IMX708_EXPOSURE_OFFSET;
1018 exposure_def = min(exposure_max, imx708->exposure->val);
1019 __v4l2_ctrl_modify_range(imx708->exposure, imx708->exposure->minimum,
1020 exposure_max, imx708->exposure->step,
1024 static int imx708_set_analogue_gain(struct imx708 *imx708, unsigned int val)
1029 * In HDR mode this will set the gain for the longest exposure,
1030 * and by default the sensor uses the same gain for all of them.
1032 ret = imx708_write_reg(imx708, IMX708_REG_ANALOG_GAIN,
1033 IMX708_REG_VALUE_16BIT, val);
1038 static int imx708_set_frame_length(struct imx708 *imx708, unsigned int val)
1042 imx708->long_exp_shift = 0;
1044 while (val > IMX708_FRAME_LENGTH_MAX) {
1045 imx708->long_exp_shift++;
1049 ret = imx708_write_reg(imx708, IMX708_REG_FRAME_LENGTH,
1050 IMX708_REG_VALUE_16BIT, val);
1054 return imx708_write_reg(imx708, IMX708_LONG_EXP_SHIFT_REG,
1055 IMX708_REG_VALUE_08BIT, imx708->long_exp_shift);
1058 static void imx708_set_framing_limits(struct imx708 *imx708)
1060 unsigned int hblank;
1061 const struct imx708_mode *mode = imx708->mode;
1063 /* Default to no long exposure multiplier */
1064 imx708->long_exp_shift = 0;
1066 __v4l2_ctrl_modify_range(imx708->pixel_rate,
1067 mode->pixel_rate, mode->pixel_rate,
1068 1, mode->pixel_rate);
1070 /* Update limits and set FPS to default */
1071 __v4l2_ctrl_modify_range(imx708->vblank, mode->vblank_min,
1072 ((1 << IMX708_LONG_EXP_SHIFT_MAX) *
1073 IMX708_FRAME_LENGTH_MAX) - mode->height,
1074 1, mode->vblank_default);
1077 * Currently PPL is fixed to the mode specified value, so hblank
1078 * depends on mode->width only, and is not changeable in any
1079 * way other than changing the mode.
1081 hblank = mode->line_length_pix - mode->width;
1082 __v4l2_ctrl_modify_range(imx708->hblank, hblank, hblank, 1, hblank);
1085 static int imx708_set_ctrl(struct v4l2_ctrl *ctrl)
1087 struct imx708 *imx708 =
1088 container_of(ctrl->handler, struct imx708, ctrl_handler);
1089 struct i2c_client *client = v4l2_get_subdevdata(&imx708->sd);
1090 const struct imx708_mode *mode_list;
1091 unsigned int code, num_modes;
1095 * The VBLANK control may change the limits of usable exposure, so check
1096 * and adjust if necessary.
1098 if (ctrl->id == V4L2_CID_VBLANK)
1099 imx708_adjust_exposure_range(imx708, ctrl);
1102 * Applying V4L2 control value only happens
1103 * when power is up for streaming
1105 if (pm_runtime_get_if_in_use(&client->dev) == 0)
1109 case V4L2_CID_ANALOGUE_GAIN:
1110 imx708_set_analogue_gain(imx708, ctrl->val);
1112 case V4L2_CID_EXPOSURE:
1113 ret = imx708_set_exposure(imx708, ctrl->val);
1115 case V4L2_CID_DIGITAL_GAIN:
1116 ret = imx708_write_reg(imx708, IMX708_REG_DIGITAL_GAIN,
1117 IMX708_REG_VALUE_16BIT, ctrl->val);
1119 case V4L2_CID_TEST_PATTERN:
1120 ret = imx708_write_reg(imx708, IMX708_REG_TEST_PATTERN,
1121 IMX708_REG_VALUE_16BIT,
1122 imx708_test_pattern_val[ctrl->val]);
1124 case V4L2_CID_TEST_PATTERN_RED:
1125 ret = imx708_write_reg(imx708, IMX708_REG_TEST_PATTERN_R,
1126 IMX708_REG_VALUE_16BIT, ctrl->val);
1128 case V4L2_CID_TEST_PATTERN_GREENR:
1129 ret = imx708_write_reg(imx708, IMX708_REG_TEST_PATTERN_GR,
1130 IMX708_REG_VALUE_16BIT, ctrl->val);
1132 case V4L2_CID_TEST_PATTERN_BLUE:
1133 ret = imx708_write_reg(imx708, IMX708_REG_TEST_PATTERN_B,
1134 IMX708_REG_VALUE_16BIT, ctrl->val);
1136 case V4L2_CID_TEST_PATTERN_GREENB:
1137 ret = imx708_write_reg(imx708, IMX708_REG_TEST_PATTERN_GB,
1138 IMX708_REG_VALUE_16BIT, ctrl->val);
1140 case V4L2_CID_HFLIP:
1141 case V4L2_CID_VFLIP:
1142 ret = imx708_write_reg(imx708, IMX708_REG_ORIENTATION, 1,
1143 imx708->hflip->val |
1144 imx708->vflip->val << 1);
1146 case V4L2_CID_VBLANK:
1147 ret = imx708_set_frame_length(imx708,
1148 imx708->mode->height + ctrl->val);
1150 case V4L2_CID_NOTIFY_GAINS:
1151 ret = imx708_write_reg(imx708, IMX708_REG_COLOUR_BALANCE_BLUE,
1152 IMX708_REG_VALUE_16BIT,
1153 imx708->notify_gains->p_new.p_u32[0]);
1156 ret = imx708_write_reg(imx708, IMX708_REG_COLOUR_BALANCE_RED,
1157 IMX708_REG_VALUE_16BIT,
1158 imx708->notify_gains->p_new.p_u32[3]);
1160 case V4L2_CID_WIDE_DYNAMIC_RANGE:
1161 code = imx708_get_format_code(imx708);
1162 get_mode_table(code, &mode_list, &num_modes, ctrl->val);
1163 imx708->mode = v4l2_find_nearest_size(mode_list,
1166 imx708->mode->width,
1167 imx708->mode->height);
1168 imx708_set_framing_limits(imx708);
1171 dev_info(&client->dev,
1172 "ctrl(id:0x%x,val:0x%x) is not handled\n",
1173 ctrl->id, ctrl->val);
1178 pm_runtime_put(&client->dev);
1183 static const struct v4l2_ctrl_ops imx708_ctrl_ops = {
1184 .s_ctrl = imx708_set_ctrl,
1187 static int imx708_enum_mbus_code(struct v4l2_subdev *sd,
1188 struct v4l2_subdev_state *sd_state,
1189 struct v4l2_subdev_mbus_code_enum *code)
1191 struct imx708 *imx708 = to_imx708(sd);
1193 if (code->pad >= NUM_PADS)
1196 if (code->pad == IMAGE_PAD) {
1197 if (code->index >= (ARRAY_SIZE(codes) / 4))
1200 code->code = imx708_get_format_code(imx708);
1202 if (code->index > 0)
1205 code->code = MEDIA_BUS_FMT_SENSOR_DATA;
1211 static int imx708_enum_frame_size(struct v4l2_subdev *sd,
1212 struct v4l2_subdev_state *sd_state,
1213 struct v4l2_subdev_frame_size_enum *fse)
1215 struct imx708 *imx708 = to_imx708(sd);
1217 if (fse->pad >= NUM_PADS)
1220 if (fse->pad == IMAGE_PAD) {
1221 const struct imx708_mode *mode_list;
1222 unsigned int num_modes;
1224 get_mode_table(fse->code, &mode_list, &num_modes,
1225 imx708->hdr_mode->val);
1227 if (fse->index >= num_modes)
1230 if (fse->code != imx708_get_format_code(imx708))
1233 fse->min_width = mode_list[fse->index].width;
1234 fse->max_width = fse->min_width;
1235 fse->min_height = mode_list[fse->index].height;
1236 fse->max_height = fse->min_height;
1238 if (fse->code != MEDIA_BUS_FMT_SENSOR_DATA || fse->index > 0)
1241 fse->min_width = IMX708_EMBEDDED_LINE_WIDTH;
1242 fse->max_width = fse->min_width;
1243 fse->min_height = IMX708_NUM_EMBEDDED_LINES;
1244 fse->max_height = fse->min_height;
1250 static void imx708_reset_colorspace(struct v4l2_mbus_framefmt *fmt)
1252 fmt->colorspace = V4L2_COLORSPACE_RAW;
1253 fmt->ycbcr_enc = V4L2_MAP_YCBCR_ENC_DEFAULT(fmt->colorspace);
1254 fmt->quantization = V4L2_MAP_QUANTIZATION_DEFAULT(true,
1257 fmt->xfer_func = V4L2_MAP_XFER_FUNC_DEFAULT(fmt->colorspace);
1260 static void imx708_update_image_pad_format(struct imx708 *imx708,
1261 const struct imx708_mode *mode,
1262 struct v4l2_subdev_format *fmt)
1264 fmt->format.width = mode->width;
1265 fmt->format.height = mode->height;
1266 fmt->format.field = V4L2_FIELD_NONE;
1267 imx708_reset_colorspace(&fmt->format);
1270 static void imx708_update_metadata_pad_format(struct v4l2_subdev_format *fmt)
1272 fmt->format.width = IMX708_EMBEDDED_LINE_WIDTH;
1273 fmt->format.height = IMX708_NUM_EMBEDDED_LINES;
1274 fmt->format.code = MEDIA_BUS_FMT_SENSOR_DATA;
1275 fmt->format.field = V4L2_FIELD_NONE;
1278 static int imx708_get_pad_format(struct v4l2_subdev *sd,
1279 struct v4l2_subdev_state *sd_state,
1280 struct v4l2_subdev_format *fmt)
1282 struct imx708 *imx708 = to_imx708(sd);
1284 if (fmt->pad >= NUM_PADS)
1287 mutex_lock(&imx708->mutex);
1289 if (fmt->which == V4L2_SUBDEV_FORMAT_TRY) {
1290 struct v4l2_mbus_framefmt *try_fmt =
1291 v4l2_subdev_get_try_format(&imx708->sd, sd_state,
1293 /* update the code which could change due to vflip or hflip */
1294 try_fmt->code = fmt->pad == IMAGE_PAD ?
1295 imx708_get_format_code(imx708) :
1296 MEDIA_BUS_FMT_SENSOR_DATA;
1297 fmt->format = *try_fmt;
1299 if (fmt->pad == IMAGE_PAD) {
1300 imx708_update_image_pad_format(imx708, imx708->mode,
1302 fmt->format.code = imx708_get_format_code(imx708);
1304 imx708_update_metadata_pad_format(fmt);
1308 mutex_unlock(&imx708->mutex);
1312 static int imx708_set_pad_format(struct v4l2_subdev *sd,
1313 struct v4l2_subdev_state *sd_state,
1314 struct v4l2_subdev_format *fmt)
1316 struct v4l2_mbus_framefmt *framefmt;
1317 const struct imx708_mode *mode;
1318 struct imx708 *imx708 = to_imx708(sd);
1320 if (fmt->pad >= NUM_PADS)
1323 mutex_lock(&imx708->mutex);
1325 if (fmt->pad == IMAGE_PAD) {
1326 const struct imx708_mode *mode_list;
1327 unsigned int num_modes;
1329 /* Bayer order varies with flips */
1330 fmt->format.code = imx708_get_format_code(imx708);
1332 get_mode_table(fmt->format.code, &mode_list, &num_modes,
1333 imx708->hdr_mode->val);
1335 mode = v4l2_find_nearest_size(mode_list,
1339 fmt->format.height);
1340 imx708_update_image_pad_format(imx708, mode, fmt);
1341 if (fmt->which == V4L2_SUBDEV_FORMAT_TRY) {
1342 framefmt = v4l2_subdev_get_try_format(sd, sd_state,
1344 *framefmt = fmt->format;
1346 imx708->mode = mode;
1347 imx708_set_framing_limits(imx708);
1350 if (fmt->which == V4L2_SUBDEV_FORMAT_TRY) {
1351 framefmt = v4l2_subdev_get_try_format(sd, sd_state,
1353 *framefmt = fmt->format;
1355 /* Only one embedded data mode is supported */
1356 imx708_update_metadata_pad_format(fmt);
1360 mutex_unlock(&imx708->mutex);
1365 static const struct v4l2_rect *
1366 __imx708_get_pad_crop(struct imx708 *imx708, struct v4l2_subdev_state *sd_state,
1367 unsigned int pad, enum v4l2_subdev_format_whence which)
1370 case V4L2_SUBDEV_FORMAT_TRY:
1371 return v4l2_subdev_get_try_crop(&imx708->sd, sd_state, pad);
1372 case V4L2_SUBDEV_FORMAT_ACTIVE:
1373 return &imx708->mode->crop;
1379 static int imx708_get_selection(struct v4l2_subdev *sd,
1380 struct v4l2_subdev_state *sd_state,
1381 struct v4l2_subdev_selection *sel)
1383 switch (sel->target) {
1384 case V4L2_SEL_TGT_CROP: {
1385 struct imx708 *imx708 = to_imx708(sd);
1387 mutex_lock(&imx708->mutex);
1388 sel->r = *__imx708_get_pad_crop(imx708, sd_state, sel->pad,
1390 mutex_unlock(&imx708->mutex);
1395 case V4L2_SEL_TGT_NATIVE_SIZE:
1398 sel->r.width = IMX708_NATIVE_WIDTH;
1399 sel->r.height = IMX708_NATIVE_HEIGHT;
1403 case V4L2_SEL_TGT_CROP_DEFAULT:
1404 case V4L2_SEL_TGT_CROP_BOUNDS:
1405 sel->r.left = IMX708_PIXEL_ARRAY_LEFT;
1406 sel->r.top = IMX708_PIXEL_ARRAY_TOP;
1407 sel->r.width = IMX708_PIXEL_ARRAY_WIDTH;
1408 sel->r.height = IMX708_PIXEL_ARRAY_HEIGHT;
1416 /* Start streaming */
1417 static int imx708_start_streaming(struct imx708 *imx708)
1419 struct i2c_client *client = v4l2_get_subdevdata(&imx708->sd);
1420 const struct imx708_reg_list *reg_list;
1424 if (!imx708->common_regs_written) {
1425 ret = imx708_write_regs(imx708, mode_common_regs,
1426 ARRAY_SIZE(mode_common_regs));
1428 dev_err(&client->dev, "%s failed to set common settings\n",
1433 ret = imx708_read_reg(imx708, IMX708_REG_BASE_SPC_GAINS_L,
1434 IMX708_REG_VALUE_08BIT, &val);
1435 if (ret == 0 && val == 0x40) {
1436 for (i = 0; i < 54 && ret == 0; i++) {
1437 ret = imx708_write_reg(imx708,
1438 IMX708_REG_BASE_SPC_GAINS_L + i,
1439 IMX708_REG_VALUE_08BIT,
1440 pdaf_gains[0][i % 9]);
1442 for (i = 0; i < 54 && ret == 0; i++) {
1443 ret = imx708_write_reg(imx708,
1444 IMX708_REG_BASE_SPC_GAINS_R + i,
1445 IMX708_REG_VALUE_08BIT,
1446 pdaf_gains[1][i % 9]);
1450 dev_err(&client->dev, "%s failed to set PDAF gains\n",
1455 imx708->common_regs_written = true;
1458 /* Apply default values of current mode */
1459 reg_list = &imx708->mode->reg_list;
1460 ret = imx708_write_regs(imx708, reg_list->regs, reg_list->num_of_regs);
1462 dev_err(&client->dev, "%s failed to set mode\n", __func__);
1466 /* Apply customized values from user */
1467 ret = __v4l2_ctrl_handler_setup(imx708->sd.ctrl_handler);
1471 /* set stream on register */
1472 return imx708_write_reg(imx708, IMX708_REG_MODE_SELECT,
1473 IMX708_REG_VALUE_08BIT, IMX708_MODE_STREAMING);
1476 /* Stop streaming */
1477 static void imx708_stop_streaming(struct imx708 *imx708)
1479 struct i2c_client *client = v4l2_get_subdevdata(&imx708->sd);
1482 /* set stream off register */
1483 ret = imx708_write_reg(imx708, IMX708_REG_MODE_SELECT,
1484 IMX708_REG_VALUE_08BIT, IMX708_MODE_STANDBY);
1486 dev_err(&client->dev, "%s failed to set stream\n", __func__);
1489 static int imx708_set_stream(struct v4l2_subdev *sd, int enable)
1491 struct imx708 *imx708 = to_imx708(sd);
1492 struct i2c_client *client = v4l2_get_subdevdata(sd);
1495 mutex_lock(&imx708->mutex);
1496 if (imx708->streaming == enable) {
1497 mutex_unlock(&imx708->mutex);
1502 ret = pm_runtime_get_sync(&client->dev);
1504 pm_runtime_put_noidle(&client->dev);
1509 * Apply default & customized values
1510 * and then start streaming.
1512 ret = imx708_start_streaming(imx708);
1516 imx708_stop_streaming(imx708);
1517 pm_runtime_put(&client->dev);
1520 imx708->streaming = enable;
1522 /* vflip/hflip and hdr mode cannot change during streaming */
1523 __v4l2_ctrl_grab(imx708->vflip, enable);
1524 __v4l2_ctrl_grab(imx708->hflip, enable);
1525 __v4l2_ctrl_grab(imx708->hdr_mode, enable);
1527 mutex_unlock(&imx708->mutex);
1532 pm_runtime_put(&client->dev);
1534 mutex_unlock(&imx708->mutex);
1539 /* Power/clock management functions */
1540 static int imx708_power_on(struct device *dev)
1542 struct i2c_client *client = to_i2c_client(dev);
1543 struct v4l2_subdev *sd = i2c_get_clientdata(client);
1544 struct imx708 *imx708 = to_imx708(sd);
1547 ret = regulator_bulk_enable(IMX708_NUM_SUPPLIES,
1550 dev_err(&client->dev, "%s: failed to enable regulators\n",
1555 ret = clk_prepare_enable(imx708->xclk);
1557 dev_err(&client->dev, "%s: failed to enable clock\n",
1562 gpiod_set_value_cansleep(imx708->reset_gpio, 1);
1563 usleep_range(IMX708_XCLR_MIN_DELAY_US,
1564 IMX708_XCLR_MIN_DELAY_US + IMX708_XCLR_DELAY_RANGE_US);
1569 regulator_bulk_disable(IMX708_NUM_SUPPLIES, imx708->supplies);
1573 static int imx708_power_off(struct device *dev)
1575 struct i2c_client *client = to_i2c_client(dev);
1576 struct v4l2_subdev *sd = i2c_get_clientdata(client);
1577 struct imx708 *imx708 = to_imx708(sd);
1579 gpiod_set_value_cansleep(imx708->reset_gpio, 0);
1580 regulator_bulk_disable(IMX708_NUM_SUPPLIES, imx708->supplies);
1581 clk_disable_unprepare(imx708->xclk);
1583 /* Force reprogramming of the common registers when powered up again. */
1584 imx708->common_regs_written = false;
1589 static int __maybe_unused imx708_suspend(struct device *dev)
1591 struct i2c_client *client = to_i2c_client(dev);
1592 struct v4l2_subdev *sd = i2c_get_clientdata(client);
1593 struct imx708 *imx708 = to_imx708(sd);
1595 if (imx708->streaming)
1596 imx708_stop_streaming(imx708);
1601 static int __maybe_unused imx708_resume(struct device *dev)
1603 struct i2c_client *client = to_i2c_client(dev);
1604 struct v4l2_subdev *sd = i2c_get_clientdata(client);
1605 struct imx708 *imx708 = to_imx708(sd);
1608 if (imx708->streaming) {
1609 ret = imx708_start_streaming(imx708);
1617 imx708_stop_streaming(imx708);
1618 imx708->streaming = 0;
1622 static int imx708_get_regulators(struct imx708 *imx708)
1624 struct i2c_client *client = v4l2_get_subdevdata(&imx708->sd);
1627 for (i = 0; i < IMX708_NUM_SUPPLIES; i++)
1628 imx708->supplies[i].supply = imx708_supply_name[i];
1630 return devm_regulator_bulk_get(&client->dev,
1631 IMX708_NUM_SUPPLIES,
1635 /* Verify chip ID */
1636 static int imx708_identify_module(struct imx708 *imx708)
1638 struct i2c_client *client = v4l2_get_subdevdata(&imx708->sd);
1642 ret = imx708_read_reg(imx708, IMX708_REG_CHIP_ID,
1643 IMX708_REG_VALUE_16BIT, &val);
1645 dev_err(&client->dev, "failed to read chip id %x, with error %d\n",
1646 IMX708_CHIP_ID, ret);
1650 if (val != IMX708_CHIP_ID) {
1651 dev_err(&client->dev, "chip id mismatch: %x!=%x\n",
1652 IMX708_CHIP_ID, val);
1656 ret = imx708_read_reg(imx708, 0x0000, IMX708_REG_VALUE_16BIT, &val);
1658 dev_info(&client->dev, "camera module ID 0x%04x\n", val);
1659 snprintf(imx708->sd.name, sizeof(imx708->sd.name), "imx708%s%s",
1660 val & 0x02 ? "_wide" : "",
1661 val & 0x80 ? "_noir" : "");
1667 static const struct v4l2_subdev_core_ops imx708_core_ops = {
1668 .subscribe_event = v4l2_ctrl_subdev_subscribe_event,
1669 .unsubscribe_event = v4l2_event_subdev_unsubscribe,
1672 static const struct v4l2_subdev_video_ops imx708_video_ops = {
1673 .s_stream = imx708_set_stream,
1676 static const struct v4l2_subdev_pad_ops imx708_pad_ops = {
1677 .enum_mbus_code = imx708_enum_mbus_code,
1678 .get_fmt = imx708_get_pad_format,
1679 .set_fmt = imx708_set_pad_format,
1680 .get_selection = imx708_get_selection,
1681 .enum_frame_size = imx708_enum_frame_size,
1684 static const struct v4l2_subdev_ops imx708_subdev_ops = {
1685 .core = &imx708_core_ops,
1686 .video = &imx708_video_ops,
1687 .pad = &imx708_pad_ops,
1690 static const struct v4l2_subdev_internal_ops imx708_internal_ops = {
1691 .open = imx708_open,
1694 static const struct v4l2_ctrl_config imx708_notify_gains_ctrl = {
1695 .ops = &imx708_ctrl_ops,
1696 .id = V4L2_CID_NOTIFY_GAINS,
1697 .type = V4L2_CTRL_TYPE_U32,
1698 .min = IMX708_COLOUR_BALANCE_MIN,
1699 .max = IMX708_COLOUR_BALANCE_MAX,
1700 .step = IMX708_COLOUR_BALANCE_STEP,
1701 .def = IMX708_COLOUR_BALANCE_DEFAULT,
1703 .elem_size = sizeof(u32),
1706 /* Initialize control handlers */
1707 static int imx708_init_controls(struct imx708 *imx708)
1709 struct v4l2_ctrl_handler *ctrl_hdlr;
1710 struct i2c_client *client = v4l2_get_subdevdata(&imx708->sd);
1711 struct v4l2_fwnode_device_properties props;
1715 ctrl_hdlr = &imx708->ctrl_handler;
1716 ret = v4l2_ctrl_handler_init(ctrl_hdlr, 16);
1720 mutex_init(&imx708->mutex);
1721 ctrl_hdlr->lock = &imx708->mutex;
1723 /* By default, PIXEL_RATE is read only */
1724 imx708->pixel_rate = v4l2_ctrl_new_std(ctrl_hdlr, &imx708_ctrl_ops,
1725 V4L2_CID_PIXEL_RATE,
1726 IMX708_INITIAL_PIXEL_RATE,
1727 IMX708_INITIAL_PIXEL_RATE, 1,
1728 IMX708_INITIAL_PIXEL_RATE);
1731 * Create the controls here, but mode specific limits are setup
1732 * in the imx708_set_framing_limits() call below.
1734 imx708->vblank = v4l2_ctrl_new_std(ctrl_hdlr, &imx708_ctrl_ops,
1735 V4L2_CID_VBLANK, 0, 0xffff, 1, 0);
1736 imx708->hblank = v4l2_ctrl_new_std(ctrl_hdlr, &imx708_ctrl_ops,
1737 V4L2_CID_HBLANK, 0, 0xffff, 1, 0);
1739 imx708->exposure = v4l2_ctrl_new_std(ctrl_hdlr, &imx708_ctrl_ops,
1741 IMX708_EXPOSURE_MIN,
1742 IMX708_EXPOSURE_MAX,
1743 IMX708_EXPOSURE_STEP,
1744 IMX708_EXPOSURE_DEFAULT);
1746 v4l2_ctrl_new_std(ctrl_hdlr, &imx708_ctrl_ops, V4L2_CID_ANALOGUE_GAIN,
1747 IMX708_ANA_GAIN_MIN, IMX708_ANA_GAIN_MAX,
1748 IMX708_ANA_GAIN_STEP, IMX708_ANA_GAIN_DEFAULT);
1750 v4l2_ctrl_new_std(ctrl_hdlr, &imx708_ctrl_ops, V4L2_CID_DIGITAL_GAIN,
1751 IMX708_DGTL_GAIN_MIN, IMX708_DGTL_GAIN_MAX,
1752 IMX708_DGTL_GAIN_STEP, IMX708_DGTL_GAIN_DEFAULT);
1754 imx708->hflip = v4l2_ctrl_new_std(ctrl_hdlr, &imx708_ctrl_ops,
1755 V4L2_CID_HFLIP, 0, 1, 1, 0);
1757 imx708->vflip = v4l2_ctrl_new_std(ctrl_hdlr, &imx708_ctrl_ops,
1758 V4L2_CID_VFLIP, 0, 1, 1, 0);
1760 v4l2_ctrl_new_std_menu_items(ctrl_hdlr, &imx708_ctrl_ops,
1761 V4L2_CID_TEST_PATTERN,
1762 ARRAY_SIZE(imx708_test_pattern_menu) - 1,
1763 0, 0, imx708_test_pattern_menu);
1764 for (i = 0; i < 4; i++) {
1766 * The assumption is that
1767 * V4L2_CID_TEST_PATTERN_GREENR == V4L2_CID_TEST_PATTERN_RED + 1
1768 * V4L2_CID_TEST_PATTERN_BLUE == V4L2_CID_TEST_PATTERN_RED + 2
1769 * V4L2_CID_TEST_PATTERN_GREENB == V4L2_CID_TEST_PATTERN_RED + 3
1771 v4l2_ctrl_new_std(ctrl_hdlr, &imx708_ctrl_ops,
1772 V4L2_CID_TEST_PATTERN_RED + i,
1773 IMX708_TEST_PATTERN_COLOUR_MIN,
1774 IMX708_TEST_PATTERN_COLOUR_MAX,
1775 IMX708_TEST_PATTERN_COLOUR_STEP,
1776 IMX708_TEST_PATTERN_COLOUR_MAX);
1777 /* The "Solid color" pattern is white by default */
1780 imx708->notify_gains = v4l2_ctrl_new_custom(ctrl_hdlr,
1781 &imx708_notify_gains_ctrl, NULL);
1783 imx708->hdr_mode = v4l2_ctrl_new_std(ctrl_hdlr, &imx708_ctrl_ops,
1784 V4L2_CID_WIDE_DYNAMIC_RANGE,
1787 ret = v4l2_fwnode_device_parse(&client->dev, &props);
1791 v4l2_ctrl_new_fwnode_properties(ctrl_hdlr, &imx708_ctrl_ops, &props);
1793 if (ctrl_hdlr->error) {
1794 ret = ctrl_hdlr->error;
1795 dev_err(&client->dev, "%s control init failed (%d)\n",
1800 imx708->hblank->flags |= V4L2_CTRL_FLAG_READ_ONLY;
1801 imx708->hflip->flags |= V4L2_CTRL_FLAG_MODIFY_LAYOUT;
1802 imx708->vflip->flags |= V4L2_CTRL_FLAG_MODIFY_LAYOUT;
1803 imx708->hdr_mode->flags |= V4L2_CTRL_FLAG_MODIFY_LAYOUT;
1805 imx708->sd.ctrl_handler = ctrl_hdlr;
1807 /* Setup exposure and frame/line length limits. */
1808 imx708_set_framing_limits(imx708);
1813 v4l2_ctrl_handler_free(ctrl_hdlr);
1814 mutex_destroy(&imx708->mutex);
1819 static void imx708_free_controls(struct imx708 *imx708)
1821 v4l2_ctrl_handler_free(imx708->sd.ctrl_handler);
1822 mutex_destroy(&imx708->mutex);
1825 static int imx708_check_hwcfg(struct device *dev)
1827 struct fwnode_handle *endpoint;
1828 struct v4l2_fwnode_endpoint ep_cfg = {
1829 .bus_type = V4L2_MBUS_CSI2_DPHY
1833 endpoint = fwnode_graph_get_next_endpoint(dev_fwnode(dev), NULL);
1835 dev_err(dev, "endpoint node not found\n");
1839 if (v4l2_fwnode_endpoint_alloc_parse(endpoint, &ep_cfg)) {
1840 dev_err(dev, "could not parse endpoint\n");
1844 /* Check the number of MIPI CSI2 data lanes */
1845 if (ep_cfg.bus.mipi_csi2.num_data_lanes != 2) {
1846 dev_err(dev, "only 2 data lanes are currently supported\n");
1850 /* Check the link frequency set in device tree */
1851 if (!ep_cfg.nr_of_link_frequencies) {
1852 dev_err(dev, "link-frequency property not found in DT\n");
1856 if (ep_cfg.nr_of_link_frequencies != 1 ||
1857 ep_cfg.link_frequencies[0] != IMX708_DEFAULT_LINK_FREQ) {
1858 dev_err(dev, "Link frequency not supported: %lld\n",
1859 ep_cfg.link_frequencies[0]);
1866 v4l2_fwnode_endpoint_free(&ep_cfg);
1867 fwnode_handle_put(endpoint);
1872 static int imx708_probe(struct i2c_client *client)
1874 struct device *dev = &client->dev;
1875 struct imx708 *imx708;
1878 imx708 = devm_kzalloc(&client->dev, sizeof(*imx708), GFP_KERNEL);
1882 v4l2_i2c_subdev_init(&imx708->sd, client, &imx708_subdev_ops);
1884 /* Check the hardware configuration in device tree */
1885 if (imx708_check_hwcfg(dev))
1888 /* Get system clock (xclk) */
1889 imx708->xclk = devm_clk_get(dev, NULL);
1890 if (IS_ERR(imx708->xclk)) {
1891 dev_err(dev, "failed to get xclk\n");
1892 return PTR_ERR(imx708->xclk);
1895 imx708->xclk_freq = clk_get_rate(imx708->xclk);
1896 if (imx708->xclk_freq != IMX708_XCLK_FREQ) {
1897 dev_err(dev, "xclk frequency not supported: %d Hz\n",
1902 ret = imx708_get_regulators(imx708);
1904 dev_err(dev, "failed to get regulators\n");
1908 /* Request optional enable pin */
1909 imx708->reset_gpio = devm_gpiod_get_optional(dev, "reset",
1913 * The sensor must be powered for imx708_identify_module()
1914 * to be able to read the CHIP_ID register
1916 ret = imx708_power_on(dev);
1920 ret = imx708_identify_module(imx708);
1922 goto error_power_off;
1924 /* Initialize default format */
1925 imx708_set_default_format(imx708);
1927 /* Enable runtime PM and turn off the device */
1928 pm_runtime_set_active(dev);
1929 pm_runtime_enable(dev);
1930 pm_runtime_idle(dev);
1932 /* This needs the pm runtime to be registered. */
1933 ret = imx708_init_controls(imx708);
1935 goto error_power_off;
1937 /* Initialize subdev */
1938 imx708->sd.internal_ops = &imx708_internal_ops;
1939 imx708->sd.flags |= V4L2_SUBDEV_FL_HAS_DEVNODE |
1940 V4L2_SUBDEV_FL_HAS_EVENTS;
1941 imx708->sd.entity.function = MEDIA_ENT_F_CAM_SENSOR;
1943 /* Initialize source pads */
1944 imx708->pad[IMAGE_PAD].flags = MEDIA_PAD_FL_SOURCE;
1945 imx708->pad[METADATA_PAD].flags = MEDIA_PAD_FL_SOURCE;
1947 ret = media_entity_pads_init(&imx708->sd.entity, NUM_PADS, imx708->pad);
1949 dev_err(dev, "failed to init entity pads: %d\n", ret);
1950 goto error_handler_free;
1953 ret = v4l2_async_register_subdev_sensor(&imx708->sd);
1955 dev_err(dev, "failed to register sensor sub-device: %d\n", ret);
1956 goto error_media_entity;
1962 media_entity_cleanup(&imx708->sd.entity);
1965 imx708_free_controls(imx708);
1968 pm_runtime_disable(&client->dev);
1969 pm_runtime_set_suspended(&client->dev);
1970 imx708_power_off(&client->dev);
1975 static int imx708_remove(struct i2c_client *client)
1977 struct v4l2_subdev *sd = i2c_get_clientdata(client);
1978 struct imx708 *imx708 = to_imx708(sd);
1980 v4l2_async_unregister_subdev(sd);
1981 media_entity_cleanup(&sd->entity);
1982 imx708_free_controls(imx708);
1984 pm_runtime_disable(&client->dev);
1985 if (!pm_runtime_status_suspended(&client->dev))
1986 imx708_power_off(&client->dev);
1987 pm_runtime_set_suspended(&client->dev);
1992 static const struct of_device_id imx708_dt_ids[] = {
1993 { .compatible = "sony,imx708" },
1996 MODULE_DEVICE_TABLE(of, imx708_dt_ids);
1998 static const struct dev_pm_ops imx708_pm_ops = {
1999 SET_SYSTEM_SLEEP_PM_OPS(imx708_suspend, imx708_resume)
2000 SET_RUNTIME_PM_OPS(imx708_power_off, imx708_power_on, NULL)
2003 static struct i2c_driver imx708_i2c_driver = {
2006 .of_match_table = imx708_dt_ids,
2007 .pm = &imx708_pm_ops,
2009 .probe_new = imx708_probe,
2010 .remove = imx708_remove,
2013 module_i2c_driver(imx708_i2c_driver);
2015 MODULE_AUTHOR("David Plowman <david.plowman@raspberrypi.com>");
2016 MODULE_DESCRIPTION("Sony IMX708 sensor driver");
2017 MODULE_LICENSE("GPL v2");