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 /* Exposure control */
48 #define IMX708_REG_EXPOSURE 0x0202
49 #define IMX708_EXPOSURE_OFFSET 48
50 #define IMX708_EXPOSURE_DEFAULT 0x640
51 #define IMX708_EXPOSURE_STEP 1
52 #define IMX708_EXPOSURE_MIN 1
53 #define IMX708_EXPOSURE_MAX (IMX708_FRAME_LENGTH_MAX - \
54 IMX708_EXPOSURE_OFFSET)
56 /* Analog gain control */
57 #define IMX708_REG_ANALOG_GAIN 0x0204
58 #define IMX708_ANA_GAIN_MIN 112
59 #define IMX708_ANA_GAIN_MAX 960
60 #define IMX708_ANA_GAIN_STEP 1
61 #define IMX708_ANA_GAIN_DEFAULT IMX708_ANA_GAIN_MIN
63 /* Digital gain control */
64 #define IMX708_REG_DIGITAL_GAIN 0x020e
65 #define IMX708_DGTL_GAIN_MIN 0x0100
66 #define IMX708_DGTL_GAIN_MAX 0xffff
67 #define IMX708_DGTL_GAIN_DEFAULT 0x0100
68 #define IMX708_DGTL_GAIN_STEP 1
70 /* Colour balance controls */
71 #define IMX708_REG_COLOUR_BALANCE_RED 0x0b90
72 #define IMX708_REG_COLOUR_BALANCE_BLUE 0x0b92
73 #define IMX708_COLOUR_BALANCE_MIN 0x01
74 #define IMX708_COLOUR_BALANCE_MAX 0xffff
75 #define IMX708_COLOUR_BALANCE_STEP 0x01
76 #define IMX708_COLOUR_BALANCE_DEFAULT 0x100
78 /* Test Pattern Control */
79 #define IMX708_REG_TEST_PATTERN 0x0600
80 #define IMX708_TEST_PATTERN_DISABLE 0
81 #define IMX708_TEST_PATTERN_SOLID_COLOR 1
82 #define IMX708_TEST_PATTERN_COLOR_BARS 2
83 #define IMX708_TEST_PATTERN_GREY_COLOR 3
84 #define IMX708_TEST_PATTERN_PN9 4
86 /* Test pattern colour components */
87 #define IMX708_REG_TEST_PATTERN_R 0x0602
88 #define IMX708_REG_TEST_PATTERN_GR 0x0604
89 #define IMX708_REG_TEST_PATTERN_B 0x0606
90 #define IMX708_REG_TEST_PATTERN_GB 0x0608
91 #define IMX708_TEST_PATTERN_COLOUR_MIN 0
92 #define IMX708_TEST_PATTERN_COLOUR_MAX 0x0fff
93 #define IMX708_TEST_PATTERN_COLOUR_STEP 1
95 #define IMX708_REG_BASE_SPC_GAINS_L 0x7b10
96 #define IMX708_REG_BASE_SPC_GAINS_R 0x7c00
98 /* HDR exposure ratio (long:med == med:short) */
99 #define IMX708_HDR_EXPOSURE_RATIO 4
100 #define IMX708_REG_MID_EXPOSURE 0x3116
101 #define IMX708_REG_SHT_EXPOSURE 0x0224
102 #define IMX708_REG_MID_ANALOG_GAIN 0x3118
103 #define IMX708_REG_SHT_ANALOG_GAIN 0x0216
106 * Metadata buffer holds a variety of data, all sent with the same VC/DT (0x12).
107 * It comprises two scanlines (of up to 5760 bytes each, for 4608 pixels)
108 * of embedded data, one line of PDAF data, and two lines of AE-HIST data
109 * (AE histograms are valid for HDR mode and empty in non-HDR modes).
111 #define IMX708_EMBEDDED_LINE_WIDTH (5 * 5760)
112 #define IMX708_NUM_EMBEDDED_LINES 1
120 /* IMX708 native and active pixel array size. */
121 #define IMX708_NATIVE_WIDTH 4640U
122 #define IMX708_NATIVE_HEIGHT 2658U
123 #define IMX708_PIXEL_ARRAY_LEFT 16U
124 #define IMX708_PIXEL_ARRAY_TOP 24U
125 #define IMX708_PIXEL_ARRAY_WIDTH 4608U
126 #define IMX708_PIXEL_ARRAY_HEIGHT 2592U
133 struct imx708_reg_list {
134 unsigned int num_of_regs;
135 const struct imx708_reg *regs;
138 /* Mode : resolution and related config&values */
146 /* H-timing in pixels */
147 unsigned int line_length_pix;
149 /* Analog crop rectangle. */
150 struct v4l2_rect crop;
152 /* Highest possible framerate. */
153 unsigned int vblank_min;
155 /* Default framerate. */
156 unsigned int vblank_default;
158 /* Default register values */
159 struct imx708_reg_list reg_list;
161 /* Not all modes have the same pixel rate. */
164 /* Not all modes have the same minimum exposure. */
165 u32 exposure_lines_min;
167 /* Not all modes have the same exposure lines step. */
168 u32 exposure_lines_step;
170 /* HDR flag, currently not used at runtime */
174 /* Default PDAF pixel correction gains */
175 static const u8 pdaf_gains[2][9] = {
176 { 0x4c, 0x4c, 0x4c, 0x46, 0x3e, 0x38, 0x35, 0x35, 0x35 },
177 { 0x35, 0x35, 0x35, 0x38, 0x3e, 0x46, 0x4c, 0x4c, 0x4c }
180 static const struct imx708_reg mode_common_regs[] = {
232 static const struct imx708_reg mode_4608x2592_regs[] = {
330 static const struct imx708_reg mode_2x2binned_regs[] = {
426 static const struct imx708_reg mode_2x2binned_720p_regs[] = {
522 static const struct imx708_reg mode_hdr_regs[] = {
536 {0x0222, IMX708_HDR_EXPOSURE_RATIO},
620 /* Mode configs. Keep separate lists for when HDR is enabled or not. */
621 static const struct imx708_mode supported_modes_10bit_no_hdr[] = {
623 /* Full resolution. */
626 .line_length_pix = 0x3d20,
628 .left = IMX708_PIXEL_ARRAY_LEFT,
629 .top = IMX708_PIXEL_ARRAY_TOP,
634 .vblank_default = 58,
636 .num_of_regs = ARRAY_SIZE(mode_4608x2592_regs),
637 .regs = mode_4608x2592_regs,
639 .pixel_rate = 595200000,
640 .exposure_lines_min = 8,
641 .exposure_lines_step = 1,
645 /* regular 2x2 binned. */
648 .line_length_pix = 0x1e90,
650 .left = IMX708_PIXEL_ARRAY_LEFT,
651 .top = IMX708_PIXEL_ARRAY_TOP,
656 .vblank_default = 1198,
658 .num_of_regs = ARRAY_SIZE(mode_2x2binned_regs),
659 .regs = mode_2x2binned_regs,
661 .pixel_rate = 585600000,
662 .exposure_lines_min = 4,
663 .exposure_lines_step = 2,
667 /* 2x2 binned and cropped for 720p. */
670 .line_length_pix = 0x1460,
672 .left = IMX708_PIXEL_ARRAY_LEFT,
673 .top = IMX708_PIXEL_ARRAY_TOP,
678 .vblank_default = 2755,
680 .num_of_regs = ARRAY_SIZE(mode_2x2binned_720p_regs),
681 .regs = mode_2x2binned_720p_regs,
683 .pixel_rate = 566400000,
684 .exposure_lines_min = 4,
685 .exposure_lines_step = 2,
690 static const struct imx708_mode supported_modes_10bit_hdr[] = {
692 /* There's only one HDR mode, which is 2x2 downscaled */
695 .line_length_pix = 0x1460,
697 .left = IMX708_PIXEL_ARRAY_LEFT,
698 .top = IMX708_PIXEL_ARRAY_TOP,
703 .vblank_default = 3673,
705 .num_of_regs = ARRAY_SIZE(mode_hdr_regs),
706 .regs = mode_hdr_regs,
708 .pixel_rate = 777600000,
709 .exposure_lines_min = 8 * IMX708_HDR_EXPOSURE_RATIO * IMX708_HDR_EXPOSURE_RATIO,
710 .exposure_lines_step = 2 * IMX708_HDR_EXPOSURE_RATIO * IMX708_HDR_EXPOSURE_RATIO,
716 * The supported formats.
717 * This table MUST contain 4 entries per format, to cover the various flip
718 * combinations in the order
724 static const u32 codes[] = {
726 MEDIA_BUS_FMT_SRGGB10_1X10,
727 MEDIA_BUS_FMT_SGRBG10_1X10,
728 MEDIA_BUS_FMT_SGBRG10_1X10,
729 MEDIA_BUS_FMT_SBGGR10_1X10,
732 static const char * const imx708_test_pattern_menu[] = {
740 static const int imx708_test_pattern_val[] = {
741 IMX708_TEST_PATTERN_DISABLE,
742 IMX708_TEST_PATTERN_COLOR_BARS,
743 IMX708_TEST_PATTERN_SOLID_COLOR,
744 IMX708_TEST_PATTERN_GREY_COLOR,
745 IMX708_TEST_PATTERN_PN9,
748 /* regulator supplies */
749 static const char * const imx708_supply_name[] = {
750 /* Supplies can be enabled in any order */
751 "VANA1", /* Analog1 (2.8V) supply */
752 "VANA2", /* Analog2 (1.8V) supply */
753 "VDIG", /* Digital Core (1.1V) supply */
754 "VDDL", /* IF (1.8V) supply */
757 #define IMX708_NUM_SUPPLIES ARRAY_SIZE(imx708_supply_name)
760 * Initialisation delay between XCLR low->high and the moment when the sensor
761 * can start capture (i.e. can leave software standby), given by T7 in the
762 * datasheet is 8ms. This does include I2C setup time as well.
764 * Note, that delay between XCLR low->high and reading the CCI ID register (T6
765 * in the datasheet) is much smaller - 600us.
767 #define IMX708_XCLR_MIN_DELAY_US 8000
768 #define IMX708_XCLR_DELAY_RANGE_US 1000
771 struct v4l2_subdev sd;
772 struct media_pad pad[NUM_PADS];
774 struct v4l2_mbus_framefmt fmt;
779 struct gpio_desc *reset_gpio;
780 struct regulator_bulk_data supplies[IMX708_NUM_SUPPLIES];
782 struct v4l2_ctrl_handler ctrl_handler;
784 struct v4l2_ctrl *pixel_rate;
785 struct v4l2_ctrl *exposure;
786 struct v4l2_ctrl *vflip;
787 struct v4l2_ctrl *hflip;
788 struct v4l2_ctrl *vblank;
789 struct v4l2_ctrl *hblank;
790 struct v4l2_ctrl *red_balance;
791 struct v4l2_ctrl *blue_balance;
792 struct v4l2_ctrl *notify_gains;
793 struct v4l2_ctrl *hdr_mode;
796 const struct imx708_mode *mode;
799 * Mutex for serialized access:
800 * Protect sensor module set pad format and start/stop streaming safely.
804 /* Streaming on/off */
807 /* Rewrite common registers on stream on? */
808 bool common_regs_written;
811 static inline struct imx708 *to_imx708(struct v4l2_subdev *_sd)
813 return container_of(_sd, struct imx708, sd);
816 static inline void get_mode_table(unsigned int code,
817 const struct imx708_mode **mode_list,
818 unsigned int *num_modes,
823 case MEDIA_BUS_FMT_SRGGB10_1X10:
824 case MEDIA_BUS_FMT_SGRBG10_1X10:
825 case MEDIA_BUS_FMT_SGBRG10_1X10:
826 case MEDIA_BUS_FMT_SBGGR10_1X10:
828 *mode_list = supported_modes_10bit_hdr;
829 *num_modes = ARRAY_SIZE(supported_modes_10bit_hdr);
831 *mode_list = supported_modes_10bit_no_hdr;
832 *num_modes = ARRAY_SIZE(supported_modes_10bit_no_hdr);
841 /* Read registers up to 2 at a time */
842 static int imx708_read_reg(struct imx708 *imx708, u16 reg, u32 len, u32 *val)
844 struct i2c_client *client = v4l2_get_subdevdata(&imx708->sd);
845 struct i2c_msg msgs[2];
846 u8 addr_buf[2] = { reg >> 8, reg & 0xff };
847 u8 data_buf[4] = { 0, };
853 /* Write register address */
854 msgs[0].addr = client->addr;
856 msgs[0].len = ARRAY_SIZE(addr_buf);
857 msgs[0].buf = addr_buf;
859 /* Read data from register */
860 msgs[1].addr = client->addr;
861 msgs[1].flags = I2C_M_RD;
863 msgs[1].buf = &data_buf[4 - len];
865 ret = i2c_transfer(client->adapter, msgs, ARRAY_SIZE(msgs));
866 if (ret != ARRAY_SIZE(msgs))
869 *val = get_unaligned_be32(data_buf);
874 /* Write registers up to 2 at a time */
875 static int imx708_write_reg(struct imx708 *imx708, u16 reg, u32 len, u32 val)
877 struct i2c_client *client = v4l2_get_subdevdata(&imx708->sd);
883 put_unaligned_be16(reg, buf);
884 put_unaligned_be32(val << (8 * (4 - len)), buf + 2);
885 if (i2c_master_send(client, buf, len + 2) != len + 2)
891 /* Write a list of registers */
892 static int imx708_write_regs(struct imx708 *imx708,
893 const struct imx708_reg *regs, u32 len)
895 struct i2c_client *client = v4l2_get_subdevdata(&imx708->sd);
899 for (i = 0; i < len; i++) {
900 ret = imx708_write_reg(imx708, regs[i].address, 1, regs[i].val);
902 dev_err_ratelimited(&client->dev,
903 "Failed to write reg 0x%4.4x. error = %d\n",
904 regs[i].address, ret);
913 /* Get bayer order based on flip setting. */
914 static u32 imx708_get_format_code(struct imx708 *imx708)
918 lockdep_assert_held(&imx708->mutex);
920 i = (imx708->vflip->val ? 2 : 0) |
921 (imx708->hflip->val ? 1 : 0);
926 static void imx708_set_default_format(struct imx708 *imx708)
928 struct v4l2_mbus_framefmt *fmt = &imx708->fmt;
930 /* Set default mode to max resolution */
931 imx708->mode = &supported_modes_10bit_no_hdr[0];
933 /* fmt->code not set as it will always be computed based on flips */
934 fmt->colorspace = V4L2_COLORSPACE_RAW;
935 fmt->ycbcr_enc = V4L2_MAP_YCBCR_ENC_DEFAULT(fmt->colorspace);
936 fmt->quantization = V4L2_MAP_QUANTIZATION_DEFAULT(true,
939 fmt->xfer_func = V4L2_MAP_XFER_FUNC_DEFAULT(fmt->colorspace);
940 fmt->width = imx708->mode->width;
941 fmt->height = imx708->mode->height;
942 fmt->field = V4L2_FIELD_NONE;
945 static int imx708_open(struct v4l2_subdev *sd, struct v4l2_subdev_fh *fh)
947 struct imx708 *imx708 = to_imx708(sd);
948 struct v4l2_mbus_framefmt *try_fmt_img =
949 v4l2_subdev_get_try_format(sd, fh->state, IMAGE_PAD);
950 struct v4l2_mbus_framefmt *try_fmt_meta =
951 v4l2_subdev_get_try_format(sd, fh->state, METADATA_PAD);
952 struct v4l2_rect *try_crop;
954 mutex_lock(&imx708->mutex);
956 /* Initialize try_fmt for the image pad */
957 if (imx708->hdr_mode->val) {
958 try_fmt_img->width = supported_modes_10bit_hdr[0].width;
959 try_fmt_img->height = supported_modes_10bit_hdr[0].height;
961 try_fmt_img->width = supported_modes_10bit_no_hdr[0].width;
962 try_fmt_img->height = supported_modes_10bit_no_hdr[0].height;
964 try_fmt_img->code = imx708_get_format_code(imx708);
965 try_fmt_img->field = V4L2_FIELD_NONE;
967 /* Initialize try_fmt for the embedded metadata pad */
968 try_fmt_meta->width = IMX708_EMBEDDED_LINE_WIDTH;
969 try_fmt_meta->height = IMX708_NUM_EMBEDDED_LINES;
970 try_fmt_meta->code = MEDIA_BUS_FMT_SENSOR_DATA;
971 try_fmt_meta->field = V4L2_FIELD_NONE;
973 /* Initialize try_crop */
974 try_crop = v4l2_subdev_get_try_crop(sd, fh->state, IMAGE_PAD);
975 try_crop->left = IMX708_PIXEL_ARRAY_LEFT;
976 try_crop->top = IMX708_PIXEL_ARRAY_TOP;
977 try_crop->width = IMX708_PIXEL_ARRAY_WIDTH;
978 try_crop->height = IMX708_PIXEL_ARRAY_HEIGHT;
980 mutex_unlock(&imx708->mutex);
985 static int imx708_set_exposure(struct imx708 *imx708, unsigned int val)
989 val = max(val, imx708->mode->exposure_lines_min);
990 val -= val % imx708->mode->exposure_lines_step;
993 * In HDR mode this will set the longest exposure. The sensor
994 * will automatically divide the medium and short ones by 4,16.
996 ret = imx708_write_reg(imx708, IMX708_REG_EXPOSURE,
997 IMX708_REG_VALUE_16BIT, val);
1002 static void imx708_adjust_exposure_range(struct imx708 *imx708,
1003 struct v4l2_ctrl *ctrl)
1005 int exposure_max, exposure_def;
1007 /* Honour the VBLANK limits when setting exposure. */
1008 exposure_max = imx708->mode->height + imx708->vblank->val -
1009 IMX708_EXPOSURE_OFFSET;
1010 exposure_def = min(exposure_max, imx708->exposure->val);
1011 __v4l2_ctrl_modify_range(imx708->exposure, imx708->exposure->minimum,
1012 exposure_max, imx708->exposure->step,
1016 static int imx708_set_analogue_gain(struct imx708 *imx708, unsigned int val)
1021 * In HDR mode this will set the gain for the longest exposure,
1022 * and by default the sensor uses the same gain for all of them.
1024 ret = imx708_write_reg(imx708, IMX708_REG_ANALOG_GAIN,
1025 IMX708_REG_VALUE_16BIT, val);
1030 static void imx708_set_framing_limits(struct imx708 *imx708)
1032 unsigned int hblank;
1033 const struct imx708_mode *mode = imx708->mode;
1035 __v4l2_ctrl_modify_range(imx708->pixel_rate,
1036 mode->pixel_rate, mode->pixel_rate,
1037 1, mode->pixel_rate);
1039 /* Update limits and set FPS to default */
1040 __v4l2_ctrl_modify_range(imx708->vblank, mode->vblank_min,
1041 IMX708_FRAME_LENGTH_MAX - mode->height,
1042 1, mode->vblank_default);
1045 * Currently PPL is fixed to the mode specified value, so hblank
1046 * depends on mode->width only, and is not changeable in any
1047 * way other than changing the mode.
1049 hblank = mode->line_length_pix - mode->width;
1050 __v4l2_ctrl_modify_range(imx708->hblank, hblank, hblank, 1, hblank);
1053 static int imx708_set_ctrl(struct v4l2_ctrl *ctrl)
1055 struct imx708 *imx708 =
1056 container_of(ctrl->handler, struct imx708, ctrl_handler);
1057 struct i2c_client *client = v4l2_get_subdevdata(&imx708->sd);
1058 const struct imx708_mode *mode_list;
1059 unsigned int code, num_modes;
1063 * The VBLANK control may change the limits of usable exposure, so check
1064 * and adjust if necessary.
1066 if (ctrl->id == V4L2_CID_VBLANK)
1067 imx708_adjust_exposure_range(imx708, ctrl);
1070 * Applying V4L2 control value only happens
1071 * when power is up for streaming
1073 if (pm_runtime_get_if_in_use(&client->dev) == 0)
1077 case V4L2_CID_ANALOGUE_GAIN:
1078 imx708_set_analogue_gain(imx708, ctrl->val);
1080 case V4L2_CID_EXPOSURE:
1081 ret = imx708_set_exposure(imx708, ctrl->val);
1083 case V4L2_CID_DIGITAL_GAIN:
1084 ret = imx708_write_reg(imx708, IMX708_REG_DIGITAL_GAIN,
1085 IMX708_REG_VALUE_16BIT, ctrl->val);
1087 case V4L2_CID_TEST_PATTERN:
1088 ret = imx708_write_reg(imx708, IMX708_REG_TEST_PATTERN,
1089 IMX708_REG_VALUE_16BIT,
1090 imx708_test_pattern_val[ctrl->val]);
1092 case V4L2_CID_TEST_PATTERN_RED:
1093 ret = imx708_write_reg(imx708, IMX708_REG_TEST_PATTERN_R,
1094 IMX708_REG_VALUE_16BIT, ctrl->val);
1096 case V4L2_CID_TEST_PATTERN_GREENR:
1097 ret = imx708_write_reg(imx708, IMX708_REG_TEST_PATTERN_GR,
1098 IMX708_REG_VALUE_16BIT, ctrl->val);
1100 case V4L2_CID_TEST_PATTERN_BLUE:
1101 ret = imx708_write_reg(imx708, IMX708_REG_TEST_PATTERN_B,
1102 IMX708_REG_VALUE_16BIT, ctrl->val);
1104 case V4L2_CID_TEST_PATTERN_GREENB:
1105 ret = imx708_write_reg(imx708, IMX708_REG_TEST_PATTERN_GB,
1106 IMX708_REG_VALUE_16BIT, ctrl->val);
1108 case V4L2_CID_HFLIP:
1109 case V4L2_CID_VFLIP:
1110 ret = imx708_write_reg(imx708, IMX708_REG_ORIENTATION, 1,
1111 imx708->hflip->val |
1112 imx708->vflip->val << 1);
1114 case V4L2_CID_VBLANK:
1115 ret = imx708_write_reg(imx708, IMX708_REG_FRAME_LENGTH,
1116 IMX708_REG_VALUE_16BIT,
1117 imx708->mode->height + ctrl->val);
1119 case V4L2_CID_NOTIFY_GAINS:
1120 ret = imx708_write_reg(imx708, IMX708_REG_COLOUR_BALANCE_BLUE,
1121 IMX708_REG_VALUE_16BIT,
1122 imx708->notify_gains->p_new.p_u32[0]);
1125 ret = imx708_write_reg(imx708, IMX708_REG_COLOUR_BALANCE_RED,
1126 IMX708_REG_VALUE_16BIT,
1127 imx708->notify_gains->p_new.p_u32[3]);
1129 case V4L2_CID_WIDE_DYNAMIC_RANGE:
1130 code = imx708_get_format_code(imx708);
1131 get_mode_table(code, &mode_list, &num_modes, ctrl->val);
1132 imx708->mode = v4l2_find_nearest_size(mode_list,
1135 imx708->mode->width,
1136 imx708->mode->height);
1137 imx708_set_framing_limits(imx708);
1140 dev_info(&client->dev,
1141 "ctrl(id:0x%x,val:0x%x) is not handled\n",
1142 ctrl->id, ctrl->val);
1147 pm_runtime_put(&client->dev);
1152 static const struct v4l2_ctrl_ops imx708_ctrl_ops = {
1153 .s_ctrl = imx708_set_ctrl,
1156 static int imx708_enum_mbus_code(struct v4l2_subdev *sd,
1157 struct v4l2_subdev_state *sd_state,
1158 struct v4l2_subdev_mbus_code_enum *code)
1160 struct imx708 *imx708 = to_imx708(sd);
1162 if (code->pad >= NUM_PADS)
1165 if (code->pad == IMAGE_PAD) {
1166 if (code->index >= (ARRAY_SIZE(codes) / 4))
1169 code->code = imx708_get_format_code(imx708);
1171 if (code->index > 0)
1174 code->code = MEDIA_BUS_FMT_SENSOR_DATA;
1180 static int imx708_enum_frame_size(struct v4l2_subdev *sd,
1181 struct v4l2_subdev_state *sd_state,
1182 struct v4l2_subdev_frame_size_enum *fse)
1184 struct imx708 *imx708 = to_imx708(sd);
1186 if (fse->pad >= NUM_PADS)
1189 if (fse->pad == IMAGE_PAD) {
1190 const struct imx708_mode *mode_list;
1191 unsigned int num_modes;
1193 get_mode_table(fse->code, &mode_list, &num_modes,
1194 imx708->hdr_mode->val);
1196 if (fse->index >= num_modes)
1199 if (fse->code != imx708_get_format_code(imx708))
1202 fse->min_width = mode_list[fse->index].width;
1203 fse->max_width = fse->min_width;
1204 fse->min_height = mode_list[fse->index].height;
1205 fse->max_height = fse->min_height;
1207 if (fse->code != MEDIA_BUS_FMT_SENSOR_DATA || fse->index > 0)
1210 fse->min_width = IMX708_EMBEDDED_LINE_WIDTH;
1211 fse->max_width = fse->min_width;
1212 fse->min_height = IMX708_NUM_EMBEDDED_LINES;
1213 fse->max_height = fse->min_height;
1219 static void imx708_reset_colorspace(struct v4l2_mbus_framefmt *fmt)
1221 fmt->colorspace = V4L2_COLORSPACE_RAW;
1222 fmt->ycbcr_enc = V4L2_MAP_YCBCR_ENC_DEFAULT(fmt->colorspace);
1223 fmt->quantization = V4L2_MAP_QUANTIZATION_DEFAULT(true,
1226 fmt->xfer_func = V4L2_MAP_XFER_FUNC_DEFAULT(fmt->colorspace);
1229 static void imx708_update_image_pad_format(struct imx708 *imx708,
1230 const struct imx708_mode *mode,
1231 struct v4l2_subdev_format *fmt)
1233 fmt->format.width = mode->width;
1234 fmt->format.height = mode->height;
1235 fmt->format.field = V4L2_FIELD_NONE;
1236 imx708_reset_colorspace(&fmt->format);
1239 static void imx708_update_metadata_pad_format(struct v4l2_subdev_format *fmt)
1241 fmt->format.width = IMX708_EMBEDDED_LINE_WIDTH;
1242 fmt->format.height = IMX708_NUM_EMBEDDED_LINES;
1243 fmt->format.code = MEDIA_BUS_FMT_SENSOR_DATA;
1244 fmt->format.field = V4L2_FIELD_NONE;
1247 static int imx708_get_pad_format(struct v4l2_subdev *sd,
1248 struct v4l2_subdev_state *sd_state,
1249 struct v4l2_subdev_format *fmt)
1251 struct imx708 *imx708 = to_imx708(sd);
1253 if (fmt->pad >= NUM_PADS)
1256 mutex_lock(&imx708->mutex);
1258 if (fmt->which == V4L2_SUBDEV_FORMAT_TRY) {
1259 struct v4l2_mbus_framefmt *try_fmt =
1260 v4l2_subdev_get_try_format(&imx708->sd, sd_state,
1262 /* update the code which could change due to vflip or hflip */
1263 try_fmt->code = fmt->pad == IMAGE_PAD ?
1264 imx708_get_format_code(imx708) :
1265 MEDIA_BUS_FMT_SENSOR_DATA;
1266 fmt->format = *try_fmt;
1268 if (fmt->pad == IMAGE_PAD) {
1269 imx708_update_image_pad_format(imx708, imx708->mode,
1271 fmt->format.code = imx708_get_format_code(imx708);
1273 imx708_update_metadata_pad_format(fmt);
1277 mutex_unlock(&imx708->mutex);
1281 static int imx708_set_pad_format(struct v4l2_subdev *sd,
1282 struct v4l2_subdev_state *sd_state,
1283 struct v4l2_subdev_format *fmt)
1285 struct v4l2_mbus_framefmt *framefmt;
1286 const struct imx708_mode *mode;
1287 struct imx708 *imx708 = to_imx708(sd);
1289 if (fmt->pad >= NUM_PADS)
1292 mutex_lock(&imx708->mutex);
1294 if (fmt->pad == IMAGE_PAD) {
1295 const struct imx708_mode *mode_list;
1296 unsigned int num_modes;
1298 /* Bayer order varies with flips */
1299 fmt->format.code = imx708_get_format_code(imx708);
1301 get_mode_table(fmt->format.code, &mode_list, &num_modes,
1302 imx708->hdr_mode->val);
1304 mode = v4l2_find_nearest_size(mode_list,
1308 fmt->format.height);
1309 imx708_update_image_pad_format(imx708, mode, fmt);
1310 if (fmt->which == V4L2_SUBDEV_FORMAT_TRY) {
1311 framefmt = v4l2_subdev_get_try_format(sd, sd_state,
1313 *framefmt = fmt->format;
1315 imx708->mode = mode;
1316 imx708_set_framing_limits(imx708);
1319 if (fmt->which == V4L2_SUBDEV_FORMAT_TRY) {
1320 framefmt = v4l2_subdev_get_try_format(sd, sd_state,
1322 *framefmt = fmt->format;
1324 /* Only one embedded data mode is supported */
1325 imx708_update_metadata_pad_format(fmt);
1329 mutex_unlock(&imx708->mutex);
1334 static const struct v4l2_rect *
1335 __imx708_get_pad_crop(struct imx708 *imx708, struct v4l2_subdev_state *sd_state,
1336 unsigned int pad, enum v4l2_subdev_format_whence which)
1339 case V4L2_SUBDEV_FORMAT_TRY:
1340 return v4l2_subdev_get_try_crop(&imx708->sd, sd_state, pad);
1341 case V4L2_SUBDEV_FORMAT_ACTIVE:
1342 return &imx708->mode->crop;
1348 static int imx708_get_selection(struct v4l2_subdev *sd,
1349 struct v4l2_subdev_state *sd_state,
1350 struct v4l2_subdev_selection *sel)
1352 switch (sel->target) {
1353 case V4L2_SEL_TGT_CROP: {
1354 struct imx708 *imx708 = to_imx708(sd);
1356 mutex_lock(&imx708->mutex);
1357 sel->r = *__imx708_get_pad_crop(imx708, sd_state, sel->pad,
1359 mutex_unlock(&imx708->mutex);
1364 case V4L2_SEL_TGT_NATIVE_SIZE:
1367 sel->r.width = IMX708_NATIVE_WIDTH;
1368 sel->r.height = IMX708_NATIVE_HEIGHT;
1372 case V4L2_SEL_TGT_CROP_DEFAULT:
1373 case V4L2_SEL_TGT_CROP_BOUNDS:
1374 sel->r.left = IMX708_PIXEL_ARRAY_LEFT;
1375 sel->r.top = IMX708_PIXEL_ARRAY_TOP;
1376 sel->r.width = IMX708_PIXEL_ARRAY_WIDTH;
1377 sel->r.height = IMX708_PIXEL_ARRAY_HEIGHT;
1385 /* Start streaming */
1386 static int imx708_start_streaming(struct imx708 *imx708)
1388 struct i2c_client *client = v4l2_get_subdevdata(&imx708->sd);
1389 const struct imx708_reg_list *reg_list;
1393 if (!imx708->common_regs_written) {
1394 ret = imx708_write_regs(imx708, mode_common_regs,
1395 ARRAY_SIZE(mode_common_regs));
1397 dev_err(&client->dev, "%s failed to set common settings\n",
1402 ret = imx708_read_reg(imx708, IMX708_REG_BASE_SPC_GAINS_L,
1403 IMX708_REG_VALUE_08BIT, &val);
1404 if (ret == 0 && val == 0x40) {
1405 for (i = 0; i < 54 && ret == 0; i++) {
1406 ret = imx708_write_reg(imx708,
1407 IMX708_REG_BASE_SPC_GAINS_L + i,
1408 IMX708_REG_VALUE_08BIT,
1409 pdaf_gains[0][i % 9]);
1411 for (i = 0; i < 54 && ret == 0; i++) {
1412 ret = imx708_write_reg(imx708,
1413 IMX708_REG_BASE_SPC_GAINS_R + i,
1414 IMX708_REG_VALUE_08BIT,
1415 pdaf_gains[1][i % 9]);
1419 dev_err(&client->dev, "%s failed to set PDAF gains\n",
1424 imx708->common_regs_written = true;
1427 /* Apply default values of current mode */
1428 reg_list = &imx708->mode->reg_list;
1429 ret = imx708_write_regs(imx708, reg_list->regs, reg_list->num_of_regs);
1431 dev_err(&client->dev, "%s failed to set mode\n", __func__);
1435 /* Apply customized values from user */
1436 ret = __v4l2_ctrl_handler_setup(imx708->sd.ctrl_handler);
1440 /* set stream on register */
1441 return imx708_write_reg(imx708, IMX708_REG_MODE_SELECT,
1442 IMX708_REG_VALUE_08BIT, IMX708_MODE_STREAMING);
1445 /* Stop streaming */
1446 static void imx708_stop_streaming(struct imx708 *imx708)
1448 struct i2c_client *client = v4l2_get_subdevdata(&imx708->sd);
1451 /* set stream off register */
1452 ret = imx708_write_reg(imx708, IMX708_REG_MODE_SELECT,
1453 IMX708_REG_VALUE_08BIT, IMX708_MODE_STANDBY);
1455 dev_err(&client->dev, "%s failed to set stream\n", __func__);
1458 static int imx708_set_stream(struct v4l2_subdev *sd, int enable)
1460 struct imx708 *imx708 = to_imx708(sd);
1461 struct i2c_client *client = v4l2_get_subdevdata(sd);
1464 mutex_lock(&imx708->mutex);
1465 if (imx708->streaming == enable) {
1466 mutex_unlock(&imx708->mutex);
1471 ret = pm_runtime_get_sync(&client->dev);
1473 pm_runtime_put_noidle(&client->dev);
1478 * Apply default & customized values
1479 * and then start streaming.
1481 ret = imx708_start_streaming(imx708);
1485 imx708_stop_streaming(imx708);
1486 pm_runtime_put(&client->dev);
1489 imx708->streaming = enable;
1491 /* vflip/hflip and hdr mode cannot change during streaming */
1492 __v4l2_ctrl_grab(imx708->vflip, enable);
1493 __v4l2_ctrl_grab(imx708->hflip, enable);
1494 __v4l2_ctrl_grab(imx708->hdr_mode, enable);
1496 mutex_unlock(&imx708->mutex);
1501 pm_runtime_put(&client->dev);
1503 mutex_unlock(&imx708->mutex);
1508 /* Power/clock management functions */
1509 static int imx708_power_on(struct device *dev)
1511 struct i2c_client *client = to_i2c_client(dev);
1512 struct v4l2_subdev *sd = i2c_get_clientdata(client);
1513 struct imx708 *imx708 = to_imx708(sd);
1516 ret = regulator_bulk_enable(IMX708_NUM_SUPPLIES,
1519 dev_err(&client->dev, "%s: failed to enable regulators\n",
1524 ret = clk_prepare_enable(imx708->xclk);
1526 dev_err(&client->dev, "%s: failed to enable clock\n",
1531 gpiod_set_value_cansleep(imx708->reset_gpio, 1);
1532 usleep_range(IMX708_XCLR_MIN_DELAY_US,
1533 IMX708_XCLR_MIN_DELAY_US + IMX708_XCLR_DELAY_RANGE_US);
1538 regulator_bulk_disable(IMX708_NUM_SUPPLIES, imx708->supplies);
1542 static int imx708_power_off(struct device *dev)
1544 struct i2c_client *client = to_i2c_client(dev);
1545 struct v4l2_subdev *sd = i2c_get_clientdata(client);
1546 struct imx708 *imx708 = to_imx708(sd);
1548 gpiod_set_value_cansleep(imx708->reset_gpio, 0);
1549 regulator_bulk_disable(IMX708_NUM_SUPPLIES, imx708->supplies);
1550 clk_disable_unprepare(imx708->xclk);
1552 /* Force reprogramming of the common registers when powered up again. */
1553 imx708->common_regs_written = false;
1558 static int __maybe_unused imx708_suspend(struct device *dev)
1560 struct i2c_client *client = to_i2c_client(dev);
1561 struct v4l2_subdev *sd = i2c_get_clientdata(client);
1562 struct imx708 *imx708 = to_imx708(sd);
1564 if (imx708->streaming)
1565 imx708_stop_streaming(imx708);
1570 static int __maybe_unused imx708_resume(struct device *dev)
1572 struct i2c_client *client = to_i2c_client(dev);
1573 struct v4l2_subdev *sd = i2c_get_clientdata(client);
1574 struct imx708 *imx708 = to_imx708(sd);
1577 if (imx708->streaming) {
1578 ret = imx708_start_streaming(imx708);
1586 imx708_stop_streaming(imx708);
1587 imx708->streaming = 0;
1591 static int imx708_get_regulators(struct imx708 *imx708)
1593 struct i2c_client *client = v4l2_get_subdevdata(&imx708->sd);
1596 for (i = 0; i < IMX708_NUM_SUPPLIES; i++)
1597 imx708->supplies[i].supply = imx708_supply_name[i];
1599 return devm_regulator_bulk_get(&client->dev,
1600 IMX708_NUM_SUPPLIES,
1604 /* Verify chip ID */
1605 static int imx708_identify_module(struct imx708 *imx708)
1607 struct i2c_client *client = v4l2_get_subdevdata(&imx708->sd);
1611 ret = imx708_read_reg(imx708, IMX708_REG_CHIP_ID,
1612 IMX708_REG_VALUE_16BIT, &val);
1614 dev_err(&client->dev, "failed to read chip id %x, with error %d\n",
1615 IMX708_CHIP_ID, ret);
1619 if (val != IMX708_CHIP_ID) {
1620 dev_err(&client->dev, "chip id mismatch: %x!=%x\n",
1621 IMX708_CHIP_ID, val);
1625 ret = imx708_read_reg(imx708, 0x0000, IMX708_REG_VALUE_16BIT, &val);
1627 dev_info(&client->dev, "camera module ID 0x%04x\n", val);
1628 snprintf(imx708->sd.name, sizeof(imx708->sd.name), "imx708%s%s",
1629 val & 0x02 ? "_wide" : "",
1630 val & 0x80 ? "_noir" : "");
1636 static const struct v4l2_subdev_core_ops imx708_core_ops = {
1637 .subscribe_event = v4l2_ctrl_subdev_subscribe_event,
1638 .unsubscribe_event = v4l2_event_subdev_unsubscribe,
1641 static const struct v4l2_subdev_video_ops imx708_video_ops = {
1642 .s_stream = imx708_set_stream,
1645 static const struct v4l2_subdev_pad_ops imx708_pad_ops = {
1646 .enum_mbus_code = imx708_enum_mbus_code,
1647 .get_fmt = imx708_get_pad_format,
1648 .set_fmt = imx708_set_pad_format,
1649 .get_selection = imx708_get_selection,
1650 .enum_frame_size = imx708_enum_frame_size,
1653 static const struct v4l2_subdev_ops imx708_subdev_ops = {
1654 .core = &imx708_core_ops,
1655 .video = &imx708_video_ops,
1656 .pad = &imx708_pad_ops,
1659 static const struct v4l2_subdev_internal_ops imx708_internal_ops = {
1660 .open = imx708_open,
1663 static const struct v4l2_ctrl_config imx708_notify_gains_ctrl = {
1664 .ops = &imx708_ctrl_ops,
1665 .id = V4L2_CID_NOTIFY_GAINS,
1666 .type = V4L2_CTRL_TYPE_U32,
1667 .min = IMX708_COLOUR_BALANCE_MIN,
1668 .max = IMX708_COLOUR_BALANCE_MAX,
1669 .step = IMX708_COLOUR_BALANCE_STEP,
1670 .def = IMX708_COLOUR_BALANCE_DEFAULT,
1672 .elem_size = sizeof(u32),
1675 /* Initialize control handlers */
1676 static int imx708_init_controls(struct imx708 *imx708)
1678 struct v4l2_ctrl_handler *ctrl_hdlr;
1679 struct i2c_client *client = v4l2_get_subdevdata(&imx708->sd);
1680 struct v4l2_fwnode_device_properties props;
1684 ctrl_hdlr = &imx708->ctrl_handler;
1685 ret = v4l2_ctrl_handler_init(ctrl_hdlr, 16);
1689 mutex_init(&imx708->mutex);
1690 ctrl_hdlr->lock = &imx708->mutex;
1692 /* By default, PIXEL_RATE is read only */
1693 imx708->pixel_rate = v4l2_ctrl_new_std(ctrl_hdlr, &imx708_ctrl_ops,
1694 V4L2_CID_PIXEL_RATE,
1695 IMX708_INITIAL_PIXEL_RATE,
1696 IMX708_INITIAL_PIXEL_RATE, 1,
1697 IMX708_INITIAL_PIXEL_RATE);
1700 * Create the controls here, but mode specific limits are setup
1701 * in the imx708_set_framing_limits() call below.
1703 imx708->vblank = v4l2_ctrl_new_std(ctrl_hdlr, &imx708_ctrl_ops,
1704 V4L2_CID_VBLANK, 0, 0xffff, 1, 0);
1705 imx708->hblank = v4l2_ctrl_new_std(ctrl_hdlr, &imx708_ctrl_ops,
1706 V4L2_CID_HBLANK, 0, 0xffff, 1, 0);
1708 imx708->exposure = v4l2_ctrl_new_std(ctrl_hdlr, &imx708_ctrl_ops,
1710 IMX708_EXPOSURE_MIN,
1711 IMX708_EXPOSURE_MAX,
1712 IMX708_EXPOSURE_STEP,
1713 IMX708_EXPOSURE_DEFAULT);
1715 v4l2_ctrl_new_std(ctrl_hdlr, &imx708_ctrl_ops, V4L2_CID_ANALOGUE_GAIN,
1716 IMX708_ANA_GAIN_MIN, IMX708_ANA_GAIN_MAX,
1717 IMX708_ANA_GAIN_STEP, IMX708_ANA_GAIN_DEFAULT);
1719 v4l2_ctrl_new_std(ctrl_hdlr, &imx708_ctrl_ops, V4L2_CID_DIGITAL_GAIN,
1720 IMX708_DGTL_GAIN_MIN, IMX708_DGTL_GAIN_MAX,
1721 IMX708_DGTL_GAIN_STEP, IMX708_DGTL_GAIN_DEFAULT);
1723 imx708->hflip = v4l2_ctrl_new_std(ctrl_hdlr, &imx708_ctrl_ops,
1724 V4L2_CID_HFLIP, 0, 1, 1, 0);
1726 imx708->vflip = v4l2_ctrl_new_std(ctrl_hdlr, &imx708_ctrl_ops,
1727 V4L2_CID_VFLIP, 0, 1, 1, 0);
1729 v4l2_ctrl_new_std_menu_items(ctrl_hdlr, &imx708_ctrl_ops,
1730 V4L2_CID_TEST_PATTERN,
1731 ARRAY_SIZE(imx708_test_pattern_menu) - 1,
1732 0, 0, imx708_test_pattern_menu);
1733 for (i = 0; i < 4; i++) {
1735 * The assumption is that
1736 * V4L2_CID_TEST_PATTERN_GREENR == V4L2_CID_TEST_PATTERN_RED + 1
1737 * V4L2_CID_TEST_PATTERN_BLUE == V4L2_CID_TEST_PATTERN_RED + 2
1738 * V4L2_CID_TEST_PATTERN_GREENB == V4L2_CID_TEST_PATTERN_RED + 3
1740 v4l2_ctrl_new_std(ctrl_hdlr, &imx708_ctrl_ops,
1741 V4L2_CID_TEST_PATTERN_RED + i,
1742 IMX708_TEST_PATTERN_COLOUR_MIN,
1743 IMX708_TEST_PATTERN_COLOUR_MAX,
1744 IMX708_TEST_PATTERN_COLOUR_STEP,
1745 IMX708_TEST_PATTERN_COLOUR_MAX);
1746 /* The "Solid color" pattern is white by default */
1749 imx708->notify_gains = v4l2_ctrl_new_custom(ctrl_hdlr,
1750 &imx708_notify_gains_ctrl, NULL);
1752 imx708->hdr_mode = v4l2_ctrl_new_std(ctrl_hdlr, &imx708_ctrl_ops,
1753 V4L2_CID_WIDE_DYNAMIC_RANGE,
1756 ret = v4l2_fwnode_device_parse(&client->dev, &props);
1760 v4l2_ctrl_new_fwnode_properties(ctrl_hdlr, &imx708_ctrl_ops, &props);
1762 if (ctrl_hdlr->error) {
1763 ret = ctrl_hdlr->error;
1764 dev_err(&client->dev, "%s control init failed (%d)\n",
1769 imx708->hblank->flags |= V4L2_CTRL_FLAG_READ_ONLY;
1770 imx708->hflip->flags |= V4L2_CTRL_FLAG_MODIFY_LAYOUT;
1771 imx708->vflip->flags |= V4L2_CTRL_FLAG_MODIFY_LAYOUT;
1772 imx708->hdr_mode->flags |= V4L2_CTRL_FLAG_MODIFY_LAYOUT;
1774 imx708->sd.ctrl_handler = ctrl_hdlr;
1776 /* Setup exposure and frame/line length limits. */
1777 imx708_set_framing_limits(imx708);
1782 v4l2_ctrl_handler_free(ctrl_hdlr);
1783 mutex_destroy(&imx708->mutex);
1788 static void imx708_free_controls(struct imx708 *imx708)
1790 v4l2_ctrl_handler_free(imx708->sd.ctrl_handler);
1791 mutex_destroy(&imx708->mutex);
1794 static int imx708_check_hwcfg(struct device *dev)
1796 struct fwnode_handle *endpoint;
1797 struct v4l2_fwnode_endpoint ep_cfg = {
1798 .bus_type = V4L2_MBUS_CSI2_DPHY
1802 endpoint = fwnode_graph_get_next_endpoint(dev_fwnode(dev), NULL);
1804 dev_err(dev, "endpoint node not found\n");
1808 if (v4l2_fwnode_endpoint_alloc_parse(endpoint, &ep_cfg)) {
1809 dev_err(dev, "could not parse endpoint\n");
1813 /* Check the number of MIPI CSI2 data lanes */
1814 if (ep_cfg.bus.mipi_csi2.num_data_lanes != 2) {
1815 dev_err(dev, "only 2 data lanes are currently supported\n");
1819 /* Check the link frequency set in device tree */
1820 if (!ep_cfg.nr_of_link_frequencies) {
1821 dev_err(dev, "link-frequency property not found in DT\n");
1825 if (ep_cfg.nr_of_link_frequencies != 1 ||
1826 ep_cfg.link_frequencies[0] != IMX708_DEFAULT_LINK_FREQ) {
1827 dev_err(dev, "Link frequency not supported: %lld\n",
1828 ep_cfg.link_frequencies[0]);
1835 v4l2_fwnode_endpoint_free(&ep_cfg);
1836 fwnode_handle_put(endpoint);
1841 static int imx708_probe(struct i2c_client *client)
1843 struct device *dev = &client->dev;
1844 struct imx708 *imx708;
1847 imx708 = devm_kzalloc(&client->dev, sizeof(*imx708), GFP_KERNEL);
1851 v4l2_i2c_subdev_init(&imx708->sd, client, &imx708_subdev_ops);
1853 /* Check the hardware configuration in device tree */
1854 if (imx708_check_hwcfg(dev))
1857 /* Get system clock (xclk) */
1858 imx708->xclk = devm_clk_get(dev, NULL);
1859 if (IS_ERR(imx708->xclk)) {
1860 dev_err(dev, "failed to get xclk\n");
1861 return PTR_ERR(imx708->xclk);
1864 imx708->xclk_freq = clk_get_rate(imx708->xclk);
1865 if (imx708->xclk_freq != IMX708_XCLK_FREQ) {
1866 dev_err(dev, "xclk frequency not supported: %d Hz\n",
1871 ret = imx708_get_regulators(imx708);
1873 dev_err(dev, "failed to get regulators\n");
1877 /* Request optional enable pin */
1878 imx708->reset_gpio = devm_gpiod_get_optional(dev, "reset",
1882 * The sensor must be powered for imx708_identify_module()
1883 * to be able to read the CHIP_ID register
1885 ret = imx708_power_on(dev);
1889 ret = imx708_identify_module(imx708);
1891 goto error_power_off;
1893 /* Initialize default format */
1894 imx708_set_default_format(imx708);
1896 /* Enable runtime PM and turn off the device */
1897 pm_runtime_set_active(dev);
1898 pm_runtime_enable(dev);
1899 pm_runtime_idle(dev);
1901 /* This needs the pm runtime to be registered. */
1902 ret = imx708_init_controls(imx708);
1904 goto error_power_off;
1906 /* Initialize subdev */
1907 imx708->sd.internal_ops = &imx708_internal_ops;
1908 imx708->sd.flags |= V4L2_SUBDEV_FL_HAS_DEVNODE |
1909 V4L2_SUBDEV_FL_HAS_EVENTS;
1910 imx708->sd.entity.function = MEDIA_ENT_F_CAM_SENSOR;
1912 /* Initialize source pads */
1913 imx708->pad[IMAGE_PAD].flags = MEDIA_PAD_FL_SOURCE;
1914 imx708->pad[METADATA_PAD].flags = MEDIA_PAD_FL_SOURCE;
1916 ret = media_entity_pads_init(&imx708->sd.entity, NUM_PADS, imx708->pad);
1918 dev_err(dev, "failed to init entity pads: %d\n", ret);
1919 goto error_handler_free;
1922 ret = v4l2_async_register_subdev_sensor(&imx708->sd);
1924 dev_err(dev, "failed to register sensor sub-device: %d\n", ret);
1925 goto error_media_entity;
1931 media_entity_cleanup(&imx708->sd.entity);
1934 imx708_free_controls(imx708);
1937 pm_runtime_disable(&client->dev);
1938 pm_runtime_set_suspended(&client->dev);
1939 imx708_power_off(&client->dev);
1944 static int imx708_remove(struct i2c_client *client)
1946 struct v4l2_subdev *sd = i2c_get_clientdata(client);
1947 struct imx708 *imx708 = to_imx708(sd);
1949 v4l2_async_unregister_subdev(sd);
1950 media_entity_cleanup(&sd->entity);
1951 imx708_free_controls(imx708);
1953 pm_runtime_disable(&client->dev);
1954 if (!pm_runtime_status_suspended(&client->dev))
1955 imx708_power_off(&client->dev);
1956 pm_runtime_set_suspended(&client->dev);
1961 static const struct of_device_id imx708_dt_ids[] = {
1962 { .compatible = "sony,imx708" },
1965 MODULE_DEVICE_TABLE(of, imx708_dt_ids);
1967 static const struct dev_pm_ops imx708_pm_ops = {
1968 SET_SYSTEM_SLEEP_PM_OPS(imx708_suspend, imx708_resume)
1969 SET_RUNTIME_PM_OPS(imx708_power_off, imx708_power_on, NULL)
1972 static struct i2c_driver imx708_i2c_driver = {
1975 .of_match_table = imx708_dt_ids,
1976 .pm = &imx708_pm_ops,
1978 .probe_new = imx708_probe,
1979 .remove = imx708_remove,
1982 module_i2c_driver(imx708_i2c_driver);
1984 MODULE_AUTHOR("David Plowman <david.plowman@raspberrypi.com>");
1985 MODULE_DESCRIPTION("Sony IMX708 sensor driver");
1986 MODULE_LICENSE("GPL v2");