Back to home page

OSCL-LXR

 
 

    


0001 // SPDX-License-Identifier: GPL-2.0-or-later
0002 /*
0003  * Copyright 2020 Kévin L'hôpital <kevin.lhopital@bootlin.com>
0004  * Copyright 2020 Bootlin
0005  * Author: Paul Kocialkowski <paul.kocialkowski@bootlin.com>
0006  */
0007 
0008 #include <linux/clk.h>
0009 #include <linux/delay.h>
0010 #include <linux/device.h>
0011 #include <linux/i2c.h>
0012 #include <linux/mod_devicetable.h>
0013 #include <linux/module.h>
0014 #include <linux/of_graph.h>
0015 #include <linux/pm_runtime.h>
0016 #include <linux/regulator/consumer.h>
0017 #include <linux/videodev2.h>
0018 #include <media/v4l2-ctrls.h>
0019 #include <media/v4l2-device.h>
0020 #include <media/v4l2-fwnode.h>
0021 #include <media/v4l2-image-sizes.h>
0022 #include <media/v4l2-mediabus.h>
0023 
0024 /* Register definitions */
0025 
0026 /* System */
0027 
0028 #define OV8865_SW_STANDBY_REG           0x100
0029 #define OV8865_SW_STANDBY_STREAM_ON     BIT(0)
0030 
0031 #define OV8865_SW_RESET_REG         0x103
0032 #define OV8865_SW_RESET_RESET           BIT(0)
0033 
0034 #define OV8865_PLL_CTRL0_REG            0x300
0035 #define OV8865_PLL_CTRL0_PRE_DIV(v)     ((v) & GENMASK(2, 0))
0036 #define OV8865_PLL_CTRL1_REG            0x301
0037 #define OV8865_PLL_CTRL1_MUL_H(v)       (((v) & GENMASK(9, 8)) >> 8)
0038 #define OV8865_PLL_CTRL2_REG            0x302
0039 #define OV8865_PLL_CTRL2_MUL_L(v)       ((v) & GENMASK(7, 0))
0040 #define OV8865_PLL_CTRL3_REG            0x303
0041 #define OV8865_PLL_CTRL3_M_DIV(v)       (((v) - 1) & GENMASK(3, 0))
0042 #define OV8865_PLL_CTRL4_REG            0x304
0043 #define OV8865_PLL_CTRL4_MIPI_DIV(v)        ((v) & GENMASK(1, 0))
0044 #define OV8865_PLL_CTRL5_REG            0x305
0045 #define OV8865_PLL_CTRL5_SYS_PRE_DIV(v)     ((v) & GENMASK(1, 0))
0046 #define OV8865_PLL_CTRL6_REG            0x306
0047 #define OV8865_PLL_CTRL6_SYS_DIV(v)     (((v) - 1) & BIT(0))
0048 
0049 #define OV8865_PLL_CTRL8_REG            0x308
0050 #define OV8865_PLL_CTRL9_REG            0x309
0051 #define OV8865_PLL_CTRLA_REG            0x30a
0052 #define OV8865_PLL_CTRLA_PRE_DIV_HALF(v)    (((v) - 1) & BIT(0))
0053 #define OV8865_PLL_CTRLB_REG            0x30b
0054 #define OV8865_PLL_CTRLB_PRE_DIV(v)     ((v) & GENMASK(2, 0))
0055 #define OV8865_PLL_CTRLC_REG            0x30c
0056 #define OV8865_PLL_CTRLC_MUL_H(v)       (((v) & GENMASK(9, 8)) >> 8)
0057 #define OV8865_PLL_CTRLD_REG            0x30d
0058 #define OV8865_PLL_CTRLD_MUL_L(v)       ((v) & GENMASK(7, 0))
0059 #define OV8865_PLL_CTRLE_REG            0x30e
0060 #define OV8865_PLL_CTRLE_SYS_DIV(v)     ((v) & GENMASK(2, 0))
0061 #define OV8865_PLL_CTRLF_REG            0x30f
0062 #define OV8865_PLL_CTRLF_SYS_PRE_DIV(v)     (((v) - 1) & GENMASK(3, 0))
0063 #define OV8865_PLL_CTRL10_REG           0x310
0064 #define OV8865_PLL_CTRL11_REG           0x311
0065 #define OV8865_PLL_CTRL12_REG           0x312
0066 #define OV8865_PLL_CTRL12_PRE_DIV_HALF(v)   ((((v) - 1) << 4) & BIT(4))
0067 #define OV8865_PLL_CTRL12_DAC_DIV(v)        (((v) - 1) & GENMASK(3, 0))
0068 
0069 #define OV8865_PLL_CTRL1B_REG           0x31b
0070 #define OV8865_PLL_CTRL1C_REG           0x31c
0071 
0072 #define OV8865_PLL_CTRL1E_REG           0x31e
0073 #define OV8865_PLL_CTRL1E_PLL1_NO_LAT       BIT(3)
0074 
0075 #define OV8865_PAD_OEN0_REG         0x3000
0076 
0077 #define OV8865_PAD_OEN2_REG         0x3002
0078 
0079 #define OV8865_CLK_RST5_REG         0x3005
0080 
0081 #define OV8865_CHIP_ID_HH_REG           0x300a
0082 #define OV8865_CHIP_ID_HH_VALUE         0x00
0083 #define OV8865_CHIP_ID_H_REG            0x300b
0084 #define OV8865_CHIP_ID_H_VALUE          0x88
0085 #define OV8865_CHIP_ID_L_REG            0x300c
0086 #define OV8865_CHIP_ID_L_VALUE          0x65
0087 #define OV8865_PAD_OUT2_REG         0x300d
0088 
0089 #define OV8865_PAD_SEL2_REG         0x3010
0090 #define OV8865_PAD_PK_REG           0x3011
0091 #define OV8865_PAD_PK_DRIVE_STRENGTH_1X     (0 << 5)
0092 #define OV8865_PAD_PK_DRIVE_STRENGTH_2X     (1 << 5)
0093 #define OV8865_PAD_PK_DRIVE_STRENGTH_3X     (2 << 5)
0094 #define OV8865_PAD_PK_DRIVE_STRENGTH_4X     (3 << 5)
0095 
0096 #define OV8865_PUMP_CLK_DIV_REG         0x3015
0097 #define OV8865_PUMP_CLK_DIV_PUMP_N(v)       (((v) << 4) & GENMASK(6, 4))
0098 #define OV8865_PUMP_CLK_DIV_PUMP_P(v)       ((v) & GENMASK(2, 0))
0099 
0100 #define OV8865_MIPI_SC_CTRL0_REG        0x3018
0101 #define OV8865_MIPI_SC_CTRL0_LANES(v)       ((((v) - 1) << 5) & \
0102                          GENMASK(7, 5))
0103 #define OV8865_MIPI_SC_CTRL0_MIPI_EN        BIT(4)
0104 #define OV8865_MIPI_SC_CTRL0_UNKNOWN        BIT(1)
0105 #define OV8865_MIPI_SC_CTRL0_LANES_PD_MIPI  BIT(0)
0106 #define OV8865_MIPI_SC_CTRL1_REG        0x3019
0107 #define OV8865_CLK_RST0_REG         0x301a
0108 #define OV8865_CLK_RST1_REG         0x301b
0109 #define OV8865_CLK_RST2_REG         0x301c
0110 #define OV8865_CLK_RST3_REG         0x301d
0111 #define OV8865_CLK_RST4_REG         0x301e
0112 
0113 #define OV8865_PCLK_SEL_REG         0x3020
0114 #define OV8865_PCLK_SEL_PCLK_DIV_MASK       BIT(3)
0115 #define OV8865_PCLK_SEL_PCLK_DIV(v)     ((((v) - 1) << 3) & BIT(3))
0116 
0117 #define OV8865_MISC_CTRL_REG            0x3021
0118 #define OV8865_MIPI_SC_CTRL2_REG        0x3022
0119 #define OV8865_MIPI_SC_CTRL2_CLK_LANES_PD_MIPI  BIT(1)
0120 #define OV8865_MIPI_SC_CTRL2_PD_MIPI_RST_SYNC   BIT(0)
0121 
0122 #define OV8865_MIPI_BIT_SEL_REG         0x3031
0123 #define OV8865_MIPI_BIT_SEL(v)          (((v) << 0) & GENMASK(4, 0))
0124 #define OV8865_CLK_SEL0_REG         0x3032
0125 #define OV8865_CLK_SEL0_PLL1_SYS_SEL(v)     (((v) << 7) & BIT(7))
0126 #define OV8865_CLK_SEL1_REG         0x3033
0127 #define OV8865_CLK_SEL1_MIPI_EOF        BIT(5)
0128 #define OV8865_CLK_SEL1_UNKNOWN         BIT(2)
0129 #define OV8865_CLK_SEL1_PLL_SCLK_SEL_MASK   BIT(1)
0130 #define OV8865_CLK_SEL1_PLL_SCLK_SEL(v)     (((v) << 1) & BIT(1))
0131 
0132 #define OV8865_SCLK_CTRL_REG            0x3106
0133 #define OV8865_SCLK_CTRL_SCLK_DIV(v)        (((v) << 4) & GENMASK(7, 4))
0134 #define OV8865_SCLK_CTRL_SCLK_PRE_DIV(v)    (((v) << 2) & GENMASK(3, 2))
0135 #define OV8865_SCLK_CTRL_UNKNOWN        BIT(0)
0136 
0137 /* Exposure/gain */
0138 
0139 #define OV8865_EXPOSURE_CTRL_HH_REG     0x3500
0140 #define OV8865_EXPOSURE_CTRL_HH(v)      (((v) & GENMASK(19, 16)) >> 16)
0141 #define OV8865_EXPOSURE_CTRL_H_REG      0x3501
0142 #define OV8865_EXPOSURE_CTRL_H(v)       (((v) & GENMASK(15, 8)) >> 8)
0143 #define OV8865_EXPOSURE_CTRL_L_REG      0x3502
0144 #define OV8865_EXPOSURE_CTRL_L(v)       ((v) & GENMASK(7, 0))
0145 #define OV8865_EXPOSURE_GAIN_MANUAL_REG     0x3503
0146 #define OV8865_INTEGRATION_TIME_MARGIN      8
0147 
0148 #define OV8865_GAIN_CTRL_H_REG          0x3508
0149 #define OV8865_GAIN_CTRL_H(v)           (((v) & GENMASK(12, 8)) >> 8)
0150 #define OV8865_GAIN_CTRL_L_REG          0x3509
0151 #define OV8865_GAIN_CTRL_L(v)           ((v) & GENMASK(7, 0))
0152 
0153 /* Timing */
0154 
0155 #define OV8865_CROP_START_X_H_REG       0x3800
0156 #define OV8865_CROP_START_X_H(v)        (((v) & GENMASK(11, 8)) >> 8)
0157 #define OV8865_CROP_START_X_L_REG       0x3801
0158 #define OV8865_CROP_START_X_L(v)        ((v) & GENMASK(7, 0))
0159 #define OV8865_CROP_START_Y_H_REG       0x3802
0160 #define OV8865_CROP_START_Y_H(v)        (((v) & GENMASK(11, 8)) >> 8)
0161 #define OV8865_CROP_START_Y_L_REG       0x3803
0162 #define OV8865_CROP_START_Y_L(v)        ((v) & GENMASK(7, 0))
0163 #define OV8865_CROP_END_X_H_REG         0x3804
0164 #define OV8865_CROP_END_X_H(v)          (((v) & GENMASK(11, 8)) >> 8)
0165 #define OV8865_CROP_END_X_L_REG         0x3805
0166 #define OV8865_CROP_END_X_L(v)          ((v) & GENMASK(7, 0))
0167 #define OV8865_CROP_END_Y_H_REG         0x3806
0168 #define OV8865_CROP_END_Y_H(v)          (((v) & GENMASK(11, 8)) >> 8)
0169 #define OV8865_CROP_END_Y_L_REG         0x3807
0170 #define OV8865_CROP_END_Y_L(v)          ((v) & GENMASK(7, 0))
0171 #define OV8865_OUTPUT_SIZE_X_H_REG      0x3808
0172 #define OV8865_OUTPUT_SIZE_X_H(v)       (((v) & GENMASK(11, 8)) >> 8)
0173 #define OV8865_OUTPUT_SIZE_X_L_REG      0x3809
0174 #define OV8865_OUTPUT_SIZE_X_L(v)       ((v) & GENMASK(7, 0))
0175 #define OV8865_OUTPUT_SIZE_Y_H_REG      0x380a
0176 #define OV8865_OUTPUT_SIZE_Y_H(v)       (((v) & GENMASK(11, 8)) >> 8)
0177 #define OV8865_OUTPUT_SIZE_Y_L_REG      0x380b
0178 #define OV8865_OUTPUT_SIZE_Y_L(v)       ((v) & GENMASK(7, 0))
0179 #define OV8865_HTS_H_REG            0x380c
0180 #define OV8865_HTS_H(v)             (((v) & GENMASK(11, 8)) >> 8)
0181 #define OV8865_HTS_L_REG            0x380d
0182 #define OV8865_HTS_L(v)             ((v) & GENMASK(7, 0))
0183 #define OV8865_VTS_H_REG            0x380e
0184 #define OV8865_VTS_H(v)             (((v) & GENMASK(11, 8)) >> 8)
0185 #define OV8865_VTS_L_REG            0x380f
0186 #define OV8865_VTS_L(v)             ((v) & GENMASK(7, 0))
0187 #define OV8865_TIMING_MAX_VTS           0xffff
0188 #define OV8865_TIMING_MIN_VTS           0x04
0189 #define OV8865_OFFSET_X_H_REG           0x3810
0190 #define OV8865_OFFSET_X_H(v)            (((v) & GENMASK(15, 8)) >> 8)
0191 #define OV8865_OFFSET_X_L_REG           0x3811
0192 #define OV8865_OFFSET_X_L(v)            ((v) & GENMASK(7, 0))
0193 #define OV8865_OFFSET_Y_H_REG           0x3812
0194 #define OV8865_OFFSET_Y_H(v)            (((v) & GENMASK(14, 8)) >> 8)
0195 #define OV8865_OFFSET_Y_L_REG           0x3813
0196 #define OV8865_OFFSET_Y_L(v)            ((v) & GENMASK(7, 0))
0197 #define OV8865_INC_X_ODD_REG            0x3814
0198 #define OV8865_INC_X_ODD(v)         ((v) & GENMASK(4, 0))
0199 #define OV8865_INC_X_EVEN_REG           0x3815
0200 #define OV8865_INC_X_EVEN(v)            ((v) & GENMASK(4, 0))
0201 #define OV8865_VSYNC_START_H_REG        0x3816
0202 #define OV8865_VSYNC_START_H(v)         (((v) & GENMASK(15, 8)) >> 8)
0203 #define OV8865_VSYNC_START_L_REG        0x3817
0204 #define OV8865_VSYNC_START_L(v)         ((v) & GENMASK(7, 0))
0205 #define OV8865_VSYNC_END_H_REG          0x3818
0206 #define OV8865_VSYNC_END_H(v)           (((v) & GENMASK(15, 8)) >> 8)
0207 #define OV8865_VSYNC_END_L_REG          0x3819
0208 #define OV8865_VSYNC_END_L(v)           ((v) & GENMASK(7, 0))
0209 #define OV8865_HSYNC_FIRST_H_REG        0x381a
0210 #define OV8865_HSYNC_FIRST_H(v)         (((v) & GENMASK(15, 8)) >> 8)
0211 #define OV8865_HSYNC_FIRST_L_REG        0x381b
0212 #define OV8865_HSYNC_FIRST_L(v)         ((v) & GENMASK(7, 0))
0213 
0214 #define OV8865_FORMAT1_REG          0x3820
0215 #define OV8865_FORMAT1_FLIP_VERT_ISP_EN     BIT(2)
0216 #define OV8865_FORMAT1_FLIP_VERT_SENSOR_EN  BIT(1)
0217 #define OV8865_FORMAT2_REG          0x3821
0218 #define OV8865_FORMAT2_HSYNC_EN         BIT(6)
0219 #define OV8865_FORMAT2_FST_VBIN_EN      BIT(5)
0220 #define OV8865_FORMAT2_FST_HBIN_EN      BIT(4)
0221 #define OV8865_FORMAT2_ISP_HORZ_VAR2_EN     BIT(3)
0222 #define OV8865_FORMAT2_FLIP_HORZ_ISP_EN     BIT(2)
0223 #define OV8865_FORMAT2_FLIP_HORZ_SENSOR_EN  BIT(1)
0224 #define OV8865_FORMAT2_SYNC_HBIN_EN     BIT(0)
0225 
0226 #define OV8865_INC_Y_ODD_REG            0x382a
0227 #define OV8865_INC_Y_ODD(v)         ((v) & GENMASK(4, 0))
0228 #define OV8865_INC_Y_EVEN_REG           0x382b
0229 #define OV8865_INC_Y_EVEN(v)            ((v) & GENMASK(4, 0))
0230 
0231 #define OV8865_ABLC_NUM_REG         0x3830
0232 #define OV8865_ABLC_NUM(v)          ((v) & GENMASK(4, 0))
0233 
0234 #define OV8865_ZLINE_NUM_REG            0x3836
0235 #define OV8865_ZLINE_NUM(v)         ((v) & GENMASK(4, 0))
0236 
0237 #define OV8865_AUTO_SIZE_CTRL_REG       0x3841
0238 #define OV8865_AUTO_SIZE_CTRL_OFFSET_Y_REG  BIT(5)
0239 #define OV8865_AUTO_SIZE_CTRL_OFFSET_X_REG  BIT(4)
0240 #define OV8865_AUTO_SIZE_CTRL_CROP_END_Y_REG    BIT(3)
0241 #define OV8865_AUTO_SIZE_CTRL_CROP_END_X_REG    BIT(2)
0242 #define OV8865_AUTO_SIZE_CTRL_CROP_START_Y_REG  BIT(1)
0243 #define OV8865_AUTO_SIZE_CTRL_CROP_START_X_REG  BIT(0)
0244 #define OV8865_AUTO_SIZE_X_OFFSET_H_REG     0x3842
0245 #define OV8865_AUTO_SIZE_X_OFFSET_L_REG     0x3843
0246 #define OV8865_AUTO_SIZE_Y_OFFSET_H_REG     0x3844
0247 #define OV8865_AUTO_SIZE_Y_OFFSET_L_REG     0x3845
0248 #define OV8865_AUTO_SIZE_BOUNDARIES_REG     0x3846
0249 #define OV8865_AUTO_SIZE_BOUNDARIES_Y(v)    (((v) << 4) & GENMASK(7, 4))
0250 #define OV8865_AUTO_SIZE_BOUNDARIES_X(v)    ((v) & GENMASK(3, 0))
0251 
0252 /* PSRAM */
0253 
0254 #define OV8865_PSRAM_CTRL8_REG          0x3f08
0255 
0256 /* Black Level */
0257 
0258 #define OV8865_BLC_CTRL0_REG            0x4000
0259 #define OV8865_BLC_CTRL0_TRIG_RANGE_EN      BIT(7)
0260 #define OV8865_BLC_CTRL0_TRIG_FORMAT_EN     BIT(6)
0261 #define OV8865_BLC_CTRL0_TRIG_GAIN_EN       BIT(5)
0262 #define OV8865_BLC_CTRL0_TRIG_EXPOSURE_EN   BIT(4)
0263 #define OV8865_BLC_CTRL0_TRIG_MANUAL_EN     BIT(3)
0264 #define OV8865_BLC_CTRL0_FREEZE_EN      BIT(2)
0265 #define OV8865_BLC_CTRL0_ALWAYS_EN      BIT(1)
0266 #define OV8865_BLC_CTRL0_FILTER_EN      BIT(0)
0267 #define OV8865_BLC_CTRL1_REG            0x4001
0268 #define OV8865_BLC_CTRL1_DITHER_EN      BIT(7)
0269 #define OV8865_BLC_CTRL1_ZERO_LINE_DIFF_EN  BIT(6)
0270 #define OV8865_BLC_CTRL1_COL_SHIFT_256      (0 << 4)
0271 #define OV8865_BLC_CTRL1_COL_SHIFT_128      (1 << 4)
0272 #define OV8865_BLC_CTRL1_COL_SHIFT_64       (2 << 4)
0273 #define OV8865_BLC_CTRL1_COL_SHIFT_32       (3 << 4)
0274 #define OV8865_BLC_CTRL1_OFFSET_LIMIT_EN    BIT(2)
0275 #define OV8865_BLC_CTRL1_COLUMN_CANCEL_EN   BIT(1)
0276 #define OV8865_BLC_CTRL2_REG            0x4002
0277 #define OV8865_BLC_CTRL3_REG            0x4003
0278 #define OV8865_BLC_CTRL4_REG            0x4004
0279 #define OV8865_BLC_CTRL5_REG            0x4005
0280 #define OV8865_BLC_CTRL6_REG            0x4006
0281 #define OV8865_BLC_CTRL7_REG            0x4007
0282 #define OV8865_BLC_CTRL8_REG            0x4008
0283 #define OV8865_BLC_CTRL9_REG            0x4009
0284 #define OV8865_BLC_CTRLA_REG            0x400a
0285 #define OV8865_BLC_CTRLB_REG            0x400b
0286 #define OV8865_BLC_CTRLC_REG            0x400c
0287 #define OV8865_BLC_CTRLD_REG            0x400d
0288 #define OV8865_BLC_CTRLD_OFFSET_TRIGGER(v)  ((v) & GENMASK(7, 0))
0289 
0290 #define OV8865_BLC_CTRL1F_REG           0x401f
0291 #define OV8865_BLC_CTRL1F_RB_REVERSE        BIT(3)
0292 #define OV8865_BLC_CTRL1F_INTERPOL_X_EN     BIT(2)
0293 #define OV8865_BLC_CTRL1F_INTERPOL_Y_EN     BIT(1)
0294 
0295 #define OV8865_BLC_ANCHOR_LEFT_START_H_REG  0x4020
0296 #define OV8865_BLC_ANCHOR_LEFT_START_H(v)   (((v) & GENMASK(11, 8)) >> 8)
0297 #define OV8865_BLC_ANCHOR_LEFT_START_L_REG  0x4021
0298 #define OV8865_BLC_ANCHOR_LEFT_START_L(v)   ((v) & GENMASK(7, 0))
0299 #define OV8865_BLC_ANCHOR_LEFT_END_H_REG    0x4022
0300 #define OV8865_BLC_ANCHOR_LEFT_END_H(v)     (((v) & GENMASK(11, 8)) >> 8)
0301 #define OV8865_BLC_ANCHOR_LEFT_END_L_REG    0x4023
0302 #define OV8865_BLC_ANCHOR_LEFT_END_L(v)     ((v) & GENMASK(7, 0))
0303 #define OV8865_BLC_ANCHOR_RIGHT_START_H_REG 0x4024
0304 #define OV8865_BLC_ANCHOR_RIGHT_START_H(v)  (((v) & GENMASK(11, 8)) >> 8)
0305 #define OV8865_BLC_ANCHOR_RIGHT_START_L_REG 0x4025
0306 #define OV8865_BLC_ANCHOR_RIGHT_START_L(v)  ((v) & GENMASK(7, 0))
0307 #define OV8865_BLC_ANCHOR_RIGHT_END_H_REG   0x4026
0308 #define OV8865_BLC_ANCHOR_RIGHT_END_H(v)    (((v) & GENMASK(11, 8)) >> 8)
0309 #define OV8865_BLC_ANCHOR_RIGHT_END_L_REG   0x4027
0310 #define OV8865_BLC_ANCHOR_RIGHT_END_L(v)    ((v) & GENMASK(7, 0))
0311 
0312 #define OV8865_BLC_TOP_ZLINE_START_REG      0x4028
0313 #define OV8865_BLC_TOP_ZLINE_START(v)       ((v) & GENMASK(5, 0))
0314 #define OV8865_BLC_TOP_ZLINE_NUM_REG        0x4029
0315 #define OV8865_BLC_TOP_ZLINE_NUM(v)     ((v) & GENMASK(4, 0))
0316 #define OV8865_BLC_TOP_BLKLINE_START_REG    0x402a
0317 #define OV8865_BLC_TOP_BLKLINE_START(v)     ((v) & GENMASK(5, 0))
0318 #define OV8865_BLC_TOP_BLKLINE_NUM_REG      0x402b
0319 #define OV8865_BLC_TOP_BLKLINE_NUM(v)       ((v) & GENMASK(4, 0))
0320 #define OV8865_BLC_BOT_ZLINE_START_REG      0x402c
0321 #define OV8865_BLC_BOT_ZLINE_START(v)       ((v) & GENMASK(5, 0))
0322 #define OV8865_BLC_BOT_ZLINE_NUM_REG        0x402d
0323 #define OV8865_BLC_BOT_ZLINE_NUM(v)     ((v) & GENMASK(4, 0))
0324 #define OV8865_BLC_BOT_BLKLINE_START_REG    0x402e
0325 #define OV8865_BLC_BOT_BLKLINE_START(v)     ((v) & GENMASK(5, 0))
0326 #define OV8865_BLC_BOT_BLKLINE_NUM_REG      0x402f
0327 #define OV8865_BLC_BOT_BLKLINE_NUM(v)       ((v) & GENMASK(4, 0))
0328 
0329 #define OV8865_BLC_OFFSET_LIMIT_REG     0x4034
0330 #define OV8865_BLC_OFFSET_LIMIT(v)      ((v) & GENMASK(7, 0))
0331 
0332 /* VFIFO */
0333 
0334 #define OV8865_VFIFO_READ_START_H_REG       0x4600
0335 #define OV8865_VFIFO_READ_START_H(v)        (((v) & GENMASK(15, 8)) >> 8)
0336 #define OV8865_VFIFO_READ_START_L_REG       0x4601
0337 #define OV8865_VFIFO_READ_START_L(v)        ((v) & GENMASK(7, 0))
0338 
0339 /* MIPI */
0340 
0341 #define OV8865_MIPI_CTRL0_REG           0x4800
0342 #define OV8865_MIPI_CTRL1_REG           0x4801
0343 #define OV8865_MIPI_CTRL2_REG           0x4802
0344 #define OV8865_MIPI_CTRL3_REG           0x4803
0345 #define OV8865_MIPI_CTRL4_REG           0x4804
0346 #define OV8865_MIPI_CTRL5_REG           0x4805
0347 #define OV8865_MIPI_CTRL6_REG           0x4806
0348 #define OV8865_MIPI_CTRL7_REG           0x4807
0349 #define OV8865_MIPI_CTRL8_REG           0x4808
0350 
0351 #define OV8865_MIPI_FCNT_MAX_H_REG      0x4810
0352 #define OV8865_MIPI_FCNT_MAX_L_REG      0x4811
0353 
0354 #define OV8865_MIPI_CTRL13_REG          0x4813
0355 #define OV8865_MIPI_CTRL14_REG          0x4814
0356 #define OV8865_MIPI_CTRL15_REG          0x4815
0357 #define OV8865_MIPI_EMBEDDED_DT_REG     0x4816
0358 
0359 #define OV8865_MIPI_HS_ZERO_MIN_H_REG       0x4818
0360 #define OV8865_MIPI_HS_ZERO_MIN_L_REG       0x4819
0361 #define OV8865_MIPI_HS_TRAIL_MIN_H_REG      0x481a
0362 #define OV8865_MIPI_HS_TRAIL_MIN_L_REG      0x481b
0363 #define OV8865_MIPI_CLK_ZERO_MIN_H_REG      0x481c
0364 #define OV8865_MIPI_CLK_ZERO_MIN_L_REG      0x481d
0365 #define OV8865_MIPI_CLK_PREPARE_MAX_REG     0x481e
0366 #define OV8865_MIPI_CLK_PREPARE_MIN_REG     0x481f
0367 #define OV8865_MIPI_CLK_POST_MIN_H_REG      0x4820
0368 #define OV8865_MIPI_CLK_POST_MIN_L_REG      0x4821
0369 #define OV8865_MIPI_CLK_TRAIL_MIN_H_REG     0x4822
0370 #define OV8865_MIPI_CLK_TRAIL_MIN_L_REG     0x4823
0371 #define OV8865_MIPI_LPX_P_MIN_H_REG     0x4824
0372 #define OV8865_MIPI_LPX_P_MIN_L_REG     0x4825
0373 #define OV8865_MIPI_HS_PREPARE_MIN_REG      0x4826
0374 #define OV8865_MIPI_HS_PREPARE_MAX_REG      0x4827
0375 #define OV8865_MIPI_HS_EXIT_MIN_H_REG       0x4828
0376 #define OV8865_MIPI_HS_EXIT_MIN_L_REG       0x4829
0377 #define OV8865_MIPI_UI_HS_ZERO_MIN_REG      0x482a
0378 #define OV8865_MIPI_UI_HS_TRAIL_MIN_REG     0x482b
0379 #define OV8865_MIPI_UI_CLK_ZERO_MIN_REG     0x482c
0380 #define OV8865_MIPI_UI_CLK_PREPARE_REG      0x482d
0381 #define OV8865_MIPI_UI_CLK_POST_MIN_REG     0x482e
0382 #define OV8865_MIPI_UI_CLK_TRAIL_MIN_REG    0x482f
0383 #define OV8865_MIPI_UI_LPX_P_MIN_REG        0x4830
0384 #define OV8865_MIPI_UI_HS_PREPARE_REG       0x4831
0385 #define OV8865_MIPI_UI_HS_EXIT_MIN_REG      0x4832
0386 #define OV8865_MIPI_PKT_START_SIZE_REG      0x4833
0387 
0388 #define OV8865_MIPI_PCLK_PERIOD_REG     0x4837
0389 #define OV8865_MIPI_LP_GPIO0_REG        0x4838
0390 #define OV8865_MIPI_LP_GPIO1_REG        0x4839
0391 
0392 #define OV8865_MIPI_CTRL3C_REG          0x483c
0393 #define OV8865_MIPI_LP_GPIO4_REG        0x483d
0394 
0395 #define OV8865_MIPI_CTRL4A_REG          0x484a
0396 #define OV8865_MIPI_CTRL4B_REG          0x484b
0397 #define OV8865_MIPI_CTRL4C_REG          0x484c
0398 #define OV8865_MIPI_LANE_TEST_PATTERN_REG   0x484d
0399 #define OV8865_MIPI_FRAME_END_DELAY_REG     0x484e
0400 #define OV8865_MIPI_CLOCK_TEST_PATTERN_REG  0x484f
0401 #define OV8865_MIPI_LANE_SEL01_REG      0x4850
0402 #define OV8865_MIPI_LANE_SEL01_LANE0(v)     (((v) << 0) & GENMASK(2, 0))
0403 #define OV8865_MIPI_LANE_SEL01_LANE1(v)     (((v) << 4) & GENMASK(6, 4))
0404 #define OV8865_MIPI_LANE_SEL23_REG      0x4851
0405 #define OV8865_MIPI_LANE_SEL23_LANE2(v)     (((v) << 0) & GENMASK(2, 0))
0406 #define OV8865_MIPI_LANE_SEL23_LANE3(v)     (((v) << 4) & GENMASK(6, 4))
0407 
0408 /* ISP */
0409 
0410 #define OV8865_ISP_CTRL0_REG            0x5000
0411 #define OV8865_ISP_CTRL0_LENC_EN        BIT(7)
0412 #define OV8865_ISP_CTRL0_WHITE_BALANCE_EN   BIT(4)
0413 #define OV8865_ISP_CTRL0_DPC_BLACK_EN       BIT(2)
0414 #define OV8865_ISP_CTRL0_DPC_WHITE_EN       BIT(1)
0415 #define OV8865_ISP_CTRL1_REG            0x5001
0416 #define OV8865_ISP_CTRL1_BLC_EN         BIT(0)
0417 #define OV8865_ISP_CTRL2_REG            0x5002
0418 #define OV8865_ISP_CTRL2_DEBUG          BIT(3)
0419 #define OV8865_ISP_CTRL2_VARIOPIXEL_EN      BIT(2)
0420 #define OV8865_ISP_CTRL2_VSYNC_LATCH_EN     BIT(0)
0421 #define OV8865_ISP_CTRL3_REG            0x5003
0422 
0423 #define OV8865_ISP_GAIN_RED_H_REG       0x5018
0424 #define OV8865_ISP_GAIN_RED_H(v)        (((v) & GENMASK(13, 6)) >> 6)
0425 #define OV8865_ISP_GAIN_RED_L_REG       0x5019
0426 #define OV8865_ISP_GAIN_RED_L(v)        ((v) & GENMASK(5, 0))
0427 #define OV8865_ISP_GAIN_GREEN_H_REG     0x501a
0428 #define OV8865_ISP_GAIN_GREEN_H(v)      (((v) & GENMASK(13, 6)) >> 6)
0429 #define OV8865_ISP_GAIN_GREEN_L_REG     0x501b
0430 #define OV8865_ISP_GAIN_GREEN_L(v)      ((v) & GENMASK(5, 0))
0431 #define OV8865_ISP_GAIN_BLUE_H_REG      0x501c
0432 #define OV8865_ISP_GAIN_BLUE_H(v)       (((v) & GENMASK(13, 6)) >> 6)
0433 #define OV8865_ISP_GAIN_BLUE_L_REG      0x501d
0434 #define OV8865_ISP_GAIN_BLUE_L(v)       ((v) & GENMASK(5, 0))
0435 
0436 /* VarioPixel */
0437 
0438 #define OV8865_VAP_CTRL0_REG            0x5900
0439 #define OV8865_VAP_CTRL1_REG            0x5901
0440 #define OV8865_VAP_CTRL1_HSUB_COEF(v)       ((((v) - 1) << 2) & \
0441                          GENMASK(3, 2))
0442 #define OV8865_VAP_CTRL1_VSUB_COEF(v)       (((v) - 1) & GENMASK(1, 0))
0443 
0444 /* Pre-DSP */
0445 
0446 #define OV8865_PRE_CTRL0_REG            0x5e00
0447 #define OV8865_PRE_CTRL0_PATTERN_EN     BIT(7)
0448 #define OV8865_PRE_CTRL0_ROLLING_BAR_EN     BIT(6)
0449 #define OV8865_PRE_CTRL0_TRANSPARENT_MODE   BIT(5)
0450 #define OV8865_PRE_CTRL0_SQUARES_BW_MODE    BIT(4)
0451 #define OV8865_PRE_CTRL0_PATTERN_COLOR_BARS 0
0452 #define OV8865_PRE_CTRL0_PATTERN_RANDOM_DATA    1
0453 #define OV8865_PRE_CTRL0_PATTERN_COLOR_SQUARES  2
0454 #define OV8865_PRE_CTRL0_PATTERN_BLACK      3
0455 
0456 /* Pixel Array */
0457 
0458 #define OV8865_NATIVE_WIDTH         3296
0459 #define OV8865_NATIVE_HEIGHT            2528
0460 #define OV8865_ACTIVE_START_LEFT        16
0461 #define OV8865_ACTIVE_START_TOP         40
0462 #define OV8865_ACTIVE_WIDTH         3264
0463 #define OV8865_ACTIVE_HEIGHT            2448
0464 
0465 /* Macros */
0466 
0467 #define ov8865_subdev_sensor(s) \
0468     container_of(s, struct ov8865_sensor, subdev)
0469 
0470 #define ov8865_ctrl_subdev(c) \
0471     (&container_of((c)->handler, struct ov8865_sensor, \
0472                ctrls.handler)->subdev)
0473 
0474 /* Data structures */
0475 
0476 struct ov8865_register_value {
0477     u16 address;
0478     u8 value;
0479     unsigned int delay_ms;
0480 };
0481 
0482 /*
0483  * PLL1 Clock Tree:
0484  *
0485  * +-< EXTCLK
0486  * |
0487  * +-+ pll_pre_div_half (0x30a [0])
0488  *   |
0489  *   +-+ pll_pre_div (0x300 [2:0], special values:
0490  *     |              0: 1, 1: 1.5, 3: 2.5, 4: 3, 5: 4, 7: 8)
0491  *     +-+ pll_mul (0x301 [1:0], 0x302 [7:0])
0492  *       |
0493  *       +-+ m_div (0x303 [3:0])
0494  *       | |
0495  *       | +-> PHY_SCLK
0496  *       | |
0497  *       | +-+ mipi_div (0x304 [1:0], special values: 0: 4, 1: 5, 2: 6, 3: 8)
0498  *       |   |
0499  *       |   +-+ pclk_div (0x3020 [3])
0500  *       |     |
0501  *       |     +-> PCLK
0502  *       |
0503  *       +-+ sys_pre_div (0x305 [1:0], special values: 0: 3, 1: 4, 2: 5, 3: 6)
0504  *         |
0505  *         +-+ sys_div (0x306 [0])
0506  *           |
0507  *           +-+ sys_sel (0x3032 [7], 0: PLL1, 1: PLL2)
0508  *             |
0509  *             +-+ sclk_sel (0x3033 [1], 0: sys_sel, 1: PLL2 DAC_CLK)
0510  *               |
0511  *               +-+ sclk_pre_div (0x3106 [3:2], special values:
0512  *                 |               0: 1, 1: 2, 2: 4, 3: 1)
0513  *                 |
0514  *                 +-+ sclk_div (0x3106 [7:4], special values: 0: 1)
0515  *                   |
0516  *                   +-> SCLK
0517  */
0518 
0519 struct ov8865_pll1_config {
0520     unsigned int pll_pre_div_half;
0521     unsigned int pll_pre_div;
0522     unsigned int pll_mul;
0523     unsigned int m_div;
0524     unsigned int mipi_div;
0525     unsigned int pclk_div;
0526     unsigned int sys_pre_div;
0527     unsigned int sys_div;
0528 };
0529 
0530 /*
0531  * PLL2 Clock Tree:
0532  *
0533  * +-< EXTCLK
0534  * |
0535  * +-+ pll_pre_div_half (0x312 [4])
0536  *   |
0537  *   +-+ pll_pre_div (0x30b [2:0], special values:
0538  *     |              0: 1, 1: 1.5, 3: 2.5, 4: 3, 5: 4, 7: 8)
0539  *     +-+ pll_mul (0x30c [1:0], 0x30d [7:0])
0540  *       |
0541  *       +-+ dac_div (0x312 [3:0])
0542  *       | |
0543  *       | +-> DAC_CLK
0544  *       |
0545  *       +-+ sys_pre_div (0x30f [3:0])
0546  *         |
0547  *         +-+ sys_div (0x30e [2:0], special values:
0548  *           |          0: 1, 1: 1.5, 3: 2.5, 4: 3, 5: 3.5, 6: 4, 7:5)
0549  *           |
0550  *           +-+ sys_sel (0x3032 [7], 0: PLL1, 1: PLL2)
0551  *             |
0552  *             +-+ sclk_sel (0x3033 [1], 0: sys_sel, 1: PLL2 DAC_CLK)
0553  *               |
0554  *               +-+ sclk_pre_div (0x3106 [3:2], special values:
0555  *                 |               0: 1, 1: 2, 2: 4, 3: 1)
0556  *                 |
0557  *                 +-+ sclk_div (0x3106 [7:4], special values: 0: 1)
0558  *                   |
0559  *                   +-> SCLK
0560  */
0561 
0562 struct ov8865_pll2_config {
0563     unsigned int pll_pre_div_half;
0564     unsigned int pll_pre_div;
0565     unsigned int pll_mul;
0566     unsigned int dac_div;
0567     unsigned int sys_pre_div;
0568     unsigned int sys_div;
0569 };
0570 
0571 struct ov8865_sclk_config {
0572     unsigned int sys_sel;
0573     unsigned int sclk_sel;
0574     unsigned int sclk_pre_div;
0575     unsigned int sclk_div;
0576 };
0577 
0578 struct ov8865_pll_configs {
0579     const struct ov8865_pll1_config *pll1_config;
0580     const struct ov8865_pll2_config *pll2_config_native;
0581     const struct ov8865_pll2_config *pll2_config_binning;
0582 };
0583 
0584 /* Clock rate */
0585 
0586 enum extclk_rate {
0587     OV8865_19_2_MHZ,
0588     OV8865_24_MHZ,
0589     OV8865_NUM_SUPPORTED_RATES
0590 };
0591 
0592 static const unsigned long supported_extclk_rates[] = {
0593     [OV8865_19_2_MHZ] = 19200000,
0594     [OV8865_24_MHZ] = 24000000,
0595 };
0596 
0597 /*
0598  * General formulas for (array-centered) mode calculation:
0599  * - photo_array_width = 3296
0600  * - crop_start_x = (photo_array_width - output_size_x) / 2
0601  * - crop_end_x = crop_start_x + offset_x + output_size_x - 1
0602  *
0603  * - photo_array_height = 2480
0604  * - crop_start_y = (photo_array_height - output_size_y) / 2
0605  * - crop_end_y = crop_start_y + offset_y + output_size_y - 1
0606  */
0607 
0608 struct ov8865_mode {
0609     unsigned int crop_start_x;
0610     unsigned int offset_x;
0611     unsigned int output_size_x;
0612     unsigned int crop_end_x;
0613     unsigned int hts;
0614 
0615     unsigned int crop_start_y;
0616     unsigned int offset_y;
0617     unsigned int output_size_y;
0618     unsigned int crop_end_y;
0619     unsigned int vts;
0620 
0621     /* With auto size, only output and total sizes need to be set. */
0622     bool size_auto;
0623     unsigned int size_auto_boundary_x;
0624     unsigned int size_auto_boundary_y;
0625 
0626     bool binning_x;
0627     bool binning_y;
0628     bool variopixel;
0629     unsigned int variopixel_hsub_coef;
0630     unsigned int variopixel_vsub_coef;
0631 
0632     /* Bits for the format register, used for binning. */
0633     bool sync_hbin;
0634     bool horz_var2;
0635 
0636     unsigned int inc_x_odd;
0637     unsigned int inc_x_even;
0638     unsigned int inc_y_odd;
0639     unsigned int inc_y_even;
0640 
0641     unsigned int vfifo_read_start;
0642 
0643     unsigned int ablc_num;
0644     unsigned int zline_num;
0645 
0646     unsigned int blc_top_zero_line_start;
0647     unsigned int blc_top_zero_line_num;
0648     unsigned int blc_top_black_line_start;
0649     unsigned int blc_top_black_line_num;
0650 
0651     unsigned int blc_bottom_zero_line_start;
0652     unsigned int blc_bottom_zero_line_num;
0653     unsigned int blc_bottom_black_line_start;
0654     unsigned int blc_bottom_black_line_num;
0655 
0656     u8 blc_col_shift_mask;
0657 
0658     unsigned int blc_anchor_left_start;
0659     unsigned int blc_anchor_left_end;
0660     unsigned int blc_anchor_right_start;
0661     unsigned int blc_anchor_right_end;
0662 
0663     bool pll2_binning;
0664 
0665     const struct ov8865_register_value *register_values;
0666     unsigned int register_values_count;
0667 };
0668 
0669 struct ov8865_state {
0670     const struct ov8865_mode *mode;
0671     u32 mbus_code;
0672 
0673     bool streaming;
0674 };
0675 
0676 struct ov8865_ctrls {
0677     struct v4l2_ctrl *link_freq;
0678     struct v4l2_ctrl *pixel_rate;
0679     struct v4l2_ctrl *hblank;
0680     struct v4l2_ctrl *vblank;
0681     struct v4l2_ctrl *exposure;
0682 
0683     struct v4l2_ctrl_handler handler;
0684 };
0685 
0686 struct ov8865_sensor {
0687     struct device *dev;
0688     struct i2c_client *i2c_client;
0689     struct gpio_desc *reset;
0690     struct gpio_desc *powerdown;
0691     struct regulator *avdd;
0692     struct regulator *dvdd;
0693     struct regulator *dovdd;
0694 
0695     unsigned long extclk_rate;
0696     const struct ov8865_pll_configs *pll_configs;
0697     struct clk *extclk;
0698 
0699     struct v4l2_fwnode_endpoint endpoint;
0700     struct v4l2_subdev subdev;
0701     struct media_pad pad;
0702 
0703     struct mutex mutex;
0704 
0705     struct ov8865_state state;
0706     struct ov8865_ctrls ctrls;
0707 };
0708 
0709 /* Static definitions */
0710 
0711 /*
0712  * PHY_SCLK = 720 MHz
0713  * MIPI_PCLK = 90 MHz
0714  */
0715 
0716 static const struct ov8865_pll1_config ov8865_pll1_config_native_19_2mhz = {
0717         .pll_pre_div_half   = 1,
0718         .pll_pre_div        = 2,
0719         .pll_mul        = 75,
0720         .m_div          = 1,
0721         .mipi_div       = 3,
0722         .pclk_div       = 1,
0723         .sys_pre_div        = 1,
0724         .sys_div        = 2,
0725 };
0726 
0727 static const struct ov8865_pll1_config ov8865_pll1_config_native_24mhz = {
0728         .pll_pre_div_half   = 1,
0729         .pll_pre_div        = 0,
0730         .pll_mul        = 30,
0731         .m_div          = 1,
0732         .mipi_div       = 3,
0733         .pclk_div       = 1,
0734         .sys_pre_div        = 1,
0735         .sys_div        = 2,
0736 };
0737 
0738 /*
0739  * DAC_CLK = 360 MHz
0740  * SCLK = 144 MHz
0741  */
0742 
0743 static const struct ov8865_pll2_config ov8865_pll2_config_native_19_2mhz = {
0744         .pll_pre_div_half   = 1,
0745         .pll_pre_div        = 5,
0746         .pll_mul        = 75,
0747         .dac_div        = 1,
0748         .sys_pre_div        = 1,
0749         .sys_div        = 3,
0750 };
0751 
0752 static const struct ov8865_pll2_config ov8865_pll2_config_native_24mhz = {
0753         .pll_pre_div_half   = 1,
0754         .pll_pre_div        = 0,
0755         .pll_mul        = 30,
0756         .dac_div        = 2,
0757         .sys_pre_div        = 5,
0758         .sys_div        = 0,
0759 };
0760 
0761 /*
0762  * DAC_CLK = 360 MHz
0763  * SCLK = 72 MHz
0764  */
0765 
0766 static const struct ov8865_pll2_config ov8865_pll2_config_binning_19_2mhz = {
0767     .pll_pre_div_half   = 1,
0768     .pll_pre_div        = 2,
0769     .pll_mul        = 75,
0770     .dac_div        = 2,
0771     .sys_pre_div        = 10,
0772     .sys_div        = 0,
0773 };
0774 
0775 static const struct ov8865_pll2_config ov8865_pll2_config_binning_24mhz = {
0776     .pll_pre_div_half   = 1,
0777     .pll_pre_div        = 0,
0778     .pll_mul        = 30,
0779     .dac_div        = 2,
0780     .sys_pre_div        = 10,
0781     .sys_div        = 0,
0782 };
0783 
0784 static const struct ov8865_pll_configs ov8865_pll_configs_19_2mhz = {
0785     .pll1_config = &ov8865_pll1_config_native_19_2mhz,
0786     .pll2_config_native = &ov8865_pll2_config_native_19_2mhz,
0787     .pll2_config_binning = &ov8865_pll2_config_binning_19_2mhz,
0788 };
0789 
0790 static const struct ov8865_pll_configs ov8865_pll_configs_24mhz = {
0791     .pll1_config = &ov8865_pll1_config_native_24mhz,
0792     .pll2_config_native = &ov8865_pll2_config_native_24mhz,
0793     .pll2_config_binning = &ov8865_pll2_config_binning_24mhz,
0794 };
0795 
0796 static const struct ov8865_pll_configs *ov8865_pll_configs[] = {
0797     &ov8865_pll_configs_19_2mhz,
0798     &ov8865_pll_configs_24mhz,
0799 };
0800 
0801 static const struct ov8865_sclk_config ov8865_sclk_config_native = {
0802     .sys_sel        = 1,
0803     .sclk_sel       = 0,
0804     .sclk_pre_div       = 0,
0805     .sclk_div       = 0,
0806 };
0807 
0808 static const struct ov8865_register_value ov8865_register_values_native[] = {
0809     /* Sensor */
0810 
0811     { 0x3700, 0x48 },
0812     { 0x3701, 0x18 },
0813     { 0x3702, 0x50 },
0814     { 0x3703, 0x32 },
0815     { 0x3704, 0x28 },
0816     { 0x3706, 0x70 },
0817     { 0x3707, 0x08 },
0818     { 0x3708, 0x48 },
0819     { 0x3709, 0x80 },
0820     { 0x370a, 0x01 },
0821     { 0x370b, 0x70 },
0822     { 0x370c, 0x07 },
0823     { 0x3718, 0x14 },
0824     { 0x3712, 0x44 },
0825     { 0x371e, 0x31 },
0826     { 0x371f, 0x7f },
0827     { 0x3720, 0x0a },
0828     { 0x3721, 0x0a },
0829     { 0x3724, 0x04 },
0830     { 0x3725, 0x04 },
0831     { 0x3726, 0x0c },
0832     { 0x3728, 0x0a },
0833     { 0x3729, 0x03 },
0834     { 0x372a, 0x06 },
0835     { 0x372b, 0xa6 },
0836     { 0x372c, 0xa6 },
0837     { 0x372d, 0xa6 },
0838     { 0x372e, 0x0c },
0839     { 0x372f, 0x20 },
0840     { 0x3730, 0x02 },
0841     { 0x3731, 0x0c },
0842     { 0x3732, 0x28 },
0843     { 0x3736, 0x30 },
0844     { 0x373a, 0x04 },
0845     { 0x373b, 0x18 },
0846     { 0x373c, 0x14 },
0847     { 0x373e, 0x06 },
0848     { 0x375a, 0x0c },
0849     { 0x375b, 0x26 },
0850     { 0x375d, 0x04 },
0851     { 0x375f, 0x28 },
0852     { 0x3767, 0x1e },
0853     { 0x3772, 0x46 },
0854     { 0x3773, 0x04 },
0855     { 0x3774, 0x2c },
0856     { 0x3775, 0x13 },
0857     { 0x3776, 0x10 },
0858     { 0x37a0, 0x88 },
0859     { 0x37a1, 0x7a },
0860     { 0x37a2, 0x7a },
0861     { 0x37a3, 0x02 },
0862     { 0x37a5, 0x09 },
0863     { 0x37a7, 0x88 },
0864     { 0x37a8, 0xb0 },
0865     { 0x37a9, 0xb0 },
0866     { 0x37aa, 0x88 },
0867     { 0x37ab, 0x5c },
0868     { 0x37ac, 0x5c },
0869     { 0x37ad, 0x55 },
0870     { 0x37ae, 0x19 },
0871     { 0x37af, 0x19 },
0872     { 0x37b3, 0x84 },
0873     { 0x37b4, 0x84 },
0874     { 0x37b5, 0x66 },
0875 
0876     /* PSRAM */
0877 
0878     { OV8865_PSRAM_CTRL8_REG, 0x16 },
0879 
0880     /* ADC Sync */
0881 
0882     { 0x4500, 0x68 },
0883 };
0884 
0885 static const struct ov8865_register_value ov8865_register_values_binning[] = {
0886     /* Sensor */
0887 
0888     { 0x3700, 0x24 },
0889     { 0x3701, 0x0c },
0890     { 0x3702, 0x28 },
0891     { 0x3703, 0x19 },
0892     { 0x3704, 0x14 },
0893     { 0x3706, 0x38 },
0894     { 0x3707, 0x04 },
0895     { 0x3708, 0x24 },
0896     { 0x3709, 0x40 },
0897     { 0x370a, 0x00 },
0898     { 0x370b, 0xb8 },
0899     { 0x370c, 0x04 },
0900     { 0x3718, 0x12 },
0901     { 0x3712, 0x42 },
0902     { 0x371e, 0x19 },
0903     { 0x371f, 0x40 },
0904     { 0x3720, 0x05 },
0905     { 0x3721, 0x05 },
0906     { 0x3724, 0x02 },
0907     { 0x3725, 0x02 },
0908     { 0x3726, 0x06 },
0909     { 0x3728, 0x05 },
0910     { 0x3729, 0x02 },
0911     { 0x372a, 0x03 },
0912     { 0x372b, 0x53 },
0913     { 0x372c, 0xa3 },
0914     { 0x372d, 0x53 },
0915     { 0x372e, 0x06 },
0916     { 0x372f, 0x10 },
0917     { 0x3730, 0x01 },
0918     { 0x3731, 0x06 },
0919     { 0x3732, 0x14 },
0920     { 0x3736, 0x20 },
0921     { 0x373a, 0x02 },
0922     { 0x373b, 0x0c },
0923     { 0x373c, 0x0a },
0924     { 0x373e, 0x03 },
0925     { 0x375a, 0x06 },
0926     { 0x375b, 0x13 },
0927     { 0x375d, 0x02 },
0928     { 0x375f, 0x14 },
0929     { 0x3767, 0x1c },
0930     { 0x3772, 0x23 },
0931     { 0x3773, 0x02 },
0932     { 0x3774, 0x16 },
0933     { 0x3775, 0x12 },
0934     { 0x3776, 0x08 },
0935     { 0x37a0, 0x44 },
0936     { 0x37a1, 0x3d },
0937     { 0x37a2, 0x3d },
0938     { 0x37a3, 0x01 },
0939     { 0x37a5, 0x08 },
0940     { 0x37a7, 0x44 },
0941     { 0x37a8, 0x58 },
0942     { 0x37a9, 0x58 },
0943     { 0x37aa, 0x44 },
0944     { 0x37ab, 0x2e },
0945     { 0x37ac, 0x2e },
0946     { 0x37ad, 0x33 },
0947     { 0x37ae, 0x0d },
0948     { 0x37af, 0x0d },
0949     { 0x37b3, 0x42 },
0950     { 0x37b4, 0x42 },
0951     { 0x37b5, 0x33 },
0952 
0953     /* PSRAM */
0954 
0955     { OV8865_PSRAM_CTRL8_REG, 0x0b },
0956 
0957     /* ADC Sync */
0958 
0959     { 0x4500, 0x40 },
0960 };
0961 
0962 static const struct ov8865_mode ov8865_modes[] = {
0963     /* 3264x2448 */
0964     {
0965         /* Horizontal */
0966         .output_size_x          = 3264,
0967         .hts                = 3888,
0968 
0969         /* Vertical */
0970         .output_size_y          = 2448,
0971         .vts                = 2470,
0972 
0973         .size_auto          = true,
0974         .size_auto_boundary_x       = 8,
0975         .size_auto_boundary_y       = 4,
0976 
0977         /* Subsample increase */
0978         .inc_x_odd          = 1,
0979         .inc_x_even         = 1,
0980         .inc_y_odd          = 1,
0981         .inc_y_even         = 1,
0982 
0983         /* VFIFO */
0984         .vfifo_read_start       = 16,
0985 
0986         .ablc_num           = 4,
0987         .zline_num          = 1,
0988 
0989         /* Black Level */
0990 
0991         .blc_top_zero_line_start    = 0,
0992         .blc_top_zero_line_num      = 2,
0993         .blc_top_black_line_start   = 4,
0994         .blc_top_black_line_num     = 4,
0995 
0996         .blc_bottom_zero_line_start = 2,
0997         .blc_bottom_zero_line_num   = 2,
0998         .blc_bottom_black_line_start    = 8,
0999         .blc_bottom_black_line_num  = 2,
1000 
1001         .blc_anchor_left_start      = 576,
1002         .blc_anchor_left_end        = 831,
1003         .blc_anchor_right_start     = 1984,
1004         .blc_anchor_right_end       = 2239,
1005 
1006         /* PLL */
1007         .pll2_binning           = false,
1008 
1009         /* Registers */
1010         .register_values    = ov8865_register_values_native,
1011         .register_values_count  =
1012             ARRAY_SIZE(ov8865_register_values_native),
1013     },
1014     /* 3264x1836 */
1015     {
1016         /* Horizontal */
1017         .output_size_x          = 3264,
1018         .hts                = 3888,
1019 
1020         /* Vertical */
1021         .output_size_y          = 1836,
1022         .vts                = 2470,
1023 
1024         .size_auto          = true,
1025         .size_auto_boundary_x       = 8,
1026         .size_auto_boundary_y       = 4,
1027 
1028         /* Subsample increase */
1029         .inc_x_odd          = 1,
1030         .inc_x_even         = 1,
1031         .inc_y_odd          = 1,
1032         .inc_y_even         = 1,
1033 
1034         /* VFIFO */
1035         .vfifo_read_start       = 16,
1036 
1037         .ablc_num           = 4,
1038         .zline_num          = 1,
1039 
1040         /* Black Level */
1041 
1042         .blc_top_zero_line_start    = 0,
1043         .blc_top_zero_line_num      = 2,
1044         .blc_top_black_line_start   = 4,
1045         .blc_top_black_line_num     = 4,
1046 
1047         .blc_bottom_zero_line_start = 2,
1048         .blc_bottom_zero_line_num   = 2,
1049         .blc_bottom_black_line_start    = 8,
1050         .blc_bottom_black_line_num  = 2,
1051 
1052         .blc_anchor_left_start      = 576,
1053         .blc_anchor_left_end        = 831,
1054         .blc_anchor_right_start     = 1984,
1055         .blc_anchor_right_end       = 2239,
1056 
1057         /* PLL */
1058         .pll2_binning           = false,
1059 
1060         /* Registers */
1061         .register_values    = ov8865_register_values_native,
1062         .register_values_count  =
1063             ARRAY_SIZE(ov8865_register_values_native),
1064     },
1065     /* 1632x1224 */
1066     {
1067         /* Horizontal */
1068         .output_size_x          = 1632,
1069         .hts                = 1923,
1070 
1071         /* Vertical */
1072         .output_size_y          = 1224,
1073         .vts                = 1248,
1074 
1075         .size_auto          = true,
1076         .size_auto_boundary_x       = 8,
1077         .size_auto_boundary_y       = 8,
1078 
1079         /* Subsample increase */
1080         .inc_x_odd          = 3,
1081         .inc_x_even         = 1,
1082         .inc_y_odd          = 3,
1083         .inc_y_even         = 1,
1084 
1085         /* Binning */
1086         .binning_y          = true,
1087         .sync_hbin          = true,
1088 
1089         /* VFIFO */
1090         .vfifo_read_start       = 116,
1091 
1092         .ablc_num           = 8,
1093         .zline_num          = 2,
1094 
1095         /* Black Level */
1096 
1097         .blc_top_zero_line_start    = 0,
1098         .blc_top_zero_line_num      = 2,
1099         .blc_top_black_line_start   = 4,
1100         .blc_top_black_line_num     = 4,
1101 
1102         .blc_bottom_zero_line_start = 2,
1103         .blc_bottom_zero_line_num   = 2,
1104         .blc_bottom_black_line_start    = 8,
1105         .blc_bottom_black_line_num  = 2,
1106 
1107         .blc_anchor_left_start      = 288,
1108         .blc_anchor_left_end        = 415,
1109         .blc_anchor_right_start     = 992,
1110         .blc_anchor_right_end       = 1119,
1111 
1112         /* PLL */
1113         .pll2_binning           = true,
1114 
1115         /* Registers */
1116         .register_values    = ov8865_register_values_binning,
1117         .register_values_count  =
1118             ARRAY_SIZE(ov8865_register_values_binning),
1119     },
1120     /* 800x600 (SVGA) */
1121     {
1122         /* Horizontal */
1123         .output_size_x          = 800,
1124         .hts                = 1250,
1125 
1126         /* Vertical */
1127         .output_size_y          = 600,
1128         .vts                = 640,
1129 
1130         .size_auto          = true,
1131         .size_auto_boundary_x       = 8,
1132         .size_auto_boundary_y       = 8,
1133 
1134         /* Subsample increase */
1135         .inc_x_odd          = 3,
1136         .inc_x_even         = 1,
1137         .inc_y_odd          = 5,
1138         .inc_y_even         = 3,
1139 
1140         /* Binning */
1141         .binning_y          = true,
1142         .variopixel         = true,
1143         .variopixel_hsub_coef       = 2,
1144         .variopixel_vsub_coef       = 1,
1145         .sync_hbin          = true,
1146         .horz_var2          = true,
1147 
1148         /* VFIFO */
1149         .vfifo_read_start       = 80,
1150 
1151         .ablc_num           = 8,
1152         .zline_num          = 2,
1153 
1154         /* Black Level */
1155 
1156         .blc_top_zero_line_start    = 0,
1157         .blc_top_zero_line_num      = 2,
1158         .blc_top_black_line_start   = 2,
1159         .blc_top_black_line_num     = 2,
1160 
1161         .blc_bottom_zero_line_start = 0,
1162         .blc_bottom_zero_line_num   = 0,
1163         .blc_bottom_black_line_start    = 4,
1164         .blc_bottom_black_line_num  = 2,
1165 
1166         .blc_col_shift_mask = OV8865_BLC_CTRL1_COL_SHIFT_128,
1167 
1168         .blc_anchor_left_start      = 288,
1169         .blc_anchor_left_end        = 415,
1170         .blc_anchor_right_start     = 992,
1171         .blc_anchor_right_end       = 1119,
1172 
1173         /* PLL */
1174         .pll2_binning           = true,
1175 
1176         /* Registers */
1177         .register_values    = ov8865_register_values_binning,
1178         .register_values_count  =
1179             ARRAY_SIZE(ov8865_register_values_binning),
1180     },
1181 };
1182 
1183 static const u32 ov8865_mbus_codes[] = {
1184     MEDIA_BUS_FMT_SBGGR10_1X10,
1185 };
1186 
1187 static const struct ov8865_register_value ov8865_init_sequence[] = {
1188     /* Analog */
1189 
1190     { 0x3604, 0x04 },
1191     { 0x3602, 0x30 },
1192     { 0x3605, 0x00 },
1193     { 0x3607, 0x20 },
1194     { 0x3608, 0x11 },
1195     { 0x3609, 0x68 },
1196     { 0x360a, 0x40 },
1197     { 0x360c, 0xdd },
1198     { 0x360e, 0x0c },
1199     { 0x3610, 0x07 },
1200     { 0x3612, 0x86 },
1201     { 0x3613, 0x58 },
1202     { 0x3614, 0x28 },
1203     { 0x3617, 0x40 },
1204     { 0x3618, 0x5a },
1205     { 0x3619, 0x9b },
1206     { 0x361c, 0x00 },
1207     { 0x361d, 0x60 },
1208     { 0x3631, 0x60 },
1209     { 0x3633, 0x10 },
1210     { 0x3634, 0x10 },
1211     { 0x3635, 0x10 },
1212     { 0x3636, 0x10 },
1213     { 0x3638, 0xff },
1214     { 0x3641, 0x55 },
1215     { 0x3646, 0x86 },
1216     { 0x3647, 0x27 },
1217     { 0x364a, 0x1b },
1218 
1219     /* Sensor */
1220 
1221     { 0x3700, 0x24 },
1222     { 0x3701, 0x0c },
1223     { 0x3702, 0x28 },
1224     { 0x3703, 0x19 },
1225     { 0x3704, 0x14 },
1226     { 0x3705, 0x00 },
1227     { 0x3706, 0x38 },
1228     { 0x3707, 0x04 },
1229     { 0x3708, 0x24 },
1230     { 0x3709, 0x40 },
1231     { 0x370a, 0x00 },
1232     { 0x370b, 0xb8 },
1233     { 0x370c, 0x04 },
1234     { 0x3718, 0x12 },
1235     { 0x3719, 0x31 },
1236     { 0x3712, 0x42 },
1237     { 0x3714, 0x12 },
1238     { 0x371e, 0x19 },
1239     { 0x371f, 0x40 },
1240     { 0x3720, 0x05 },
1241     { 0x3721, 0x05 },
1242     { 0x3724, 0x02 },
1243     { 0x3725, 0x02 },
1244     { 0x3726, 0x06 },
1245     { 0x3728, 0x05 },
1246     { 0x3729, 0x02 },
1247     { 0x372a, 0x03 },
1248     { 0x372b, 0x53 },
1249     { 0x372c, 0xa3 },
1250     { 0x372d, 0x53 },
1251     { 0x372e, 0x06 },
1252     { 0x372f, 0x10 },
1253     { 0x3730, 0x01 },
1254     { 0x3731, 0x06 },
1255     { 0x3732, 0x14 },
1256     { 0x3733, 0x10 },
1257     { 0x3734, 0x40 },
1258     { 0x3736, 0x20 },
1259     { 0x373a, 0x02 },
1260     { 0x373b, 0x0c },
1261     { 0x373c, 0x0a },
1262     { 0x373e, 0x03 },
1263     { 0x3755, 0x40 },
1264     { 0x3758, 0x00 },
1265     { 0x3759, 0x4c },
1266     { 0x375a, 0x06 },
1267     { 0x375b, 0x13 },
1268     { 0x375c, 0x40 },
1269     { 0x375d, 0x02 },
1270     { 0x375e, 0x00 },
1271     { 0x375f, 0x14 },
1272     { 0x3767, 0x1c },
1273     { 0x3768, 0x04 },
1274     { 0x3769, 0x20 },
1275     { 0x376c, 0xc0 },
1276     { 0x376d, 0xc0 },
1277     { 0x376a, 0x08 },
1278     { 0x3761, 0x00 },
1279     { 0x3762, 0x00 },
1280     { 0x3763, 0x00 },
1281     { 0x3766, 0xff },
1282     { 0x376b, 0x42 },
1283     { 0x3772, 0x23 },
1284     { 0x3773, 0x02 },
1285     { 0x3774, 0x16 },
1286     { 0x3775, 0x12 },
1287     { 0x3776, 0x08 },
1288     { 0x37a0, 0x44 },
1289     { 0x37a1, 0x3d },
1290     { 0x37a2, 0x3d },
1291     { 0x37a3, 0x01 },
1292     { 0x37a4, 0x00 },
1293     { 0x37a5, 0x08 },
1294     { 0x37a6, 0x00 },
1295     { 0x37a7, 0x44 },
1296     { 0x37a8, 0x58 },
1297     { 0x37a9, 0x58 },
1298     { 0x3760, 0x00 },
1299     { 0x376f, 0x01 },
1300     { 0x37aa, 0x44 },
1301     { 0x37ab, 0x2e },
1302     { 0x37ac, 0x2e },
1303     { 0x37ad, 0x33 },
1304     { 0x37ae, 0x0d },
1305     { 0x37af, 0x0d },
1306     { 0x37b0, 0x00 },
1307     { 0x37b1, 0x00 },
1308     { 0x37b2, 0x00 },
1309     { 0x37b3, 0x42 },
1310     { 0x37b4, 0x42 },
1311     { 0x37b5, 0x33 },
1312     { 0x37b6, 0x00 },
1313     { 0x37b7, 0x00 },
1314     { 0x37b8, 0x00 },
1315     { 0x37b9, 0xff },
1316 
1317     /* ADC Sync */
1318 
1319     { 0x4503, 0x10 },
1320 };
1321 
1322 static const s64 ov8865_link_freq_menu[] = {
1323     360000000,
1324 };
1325 
1326 static const char *const ov8865_test_pattern_menu[] = {
1327     "Disabled",
1328     "Random data",
1329     "Color bars",
1330     "Color bars with rolling bar",
1331     "Color squares",
1332     "Color squares with rolling bar"
1333 };
1334 
1335 static const u8 ov8865_test_pattern_bits[] = {
1336     0,
1337     OV8865_PRE_CTRL0_PATTERN_EN | OV8865_PRE_CTRL0_PATTERN_RANDOM_DATA,
1338     OV8865_PRE_CTRL0_PATTERN_EN | OV8865_PRE_CTRL0_PATTERN_COLOR_BARS,
1339     OV8865_PRE_CTRL0_PATTERN_EN | OV8865_PRE_CTRL0_ROLLING_BAR_EN |
1340     OV8865_PRE_CTRL0_PATTERN_COLOR_BARS,
1341     OV8865_PRE_CTRL0_PATTERN_EN | OV8865_PRE_CTRL0_PATTERN_COLOR_SQUARES,
1342     OV8865_PRE_CTRL0_PATTERN_EN | OV8865_PRE_CTRL0_ROLLING_BAR_EN |
1343     OV8865_PRE_CTRL0_PATTERN_COLOR_SQUARES,
1344 };
1345 
1346 /* Input/Output */
1347 
1348 static int ov8865_read(struct ov8865_sensor *sensor, u16 address, u8 *value)
1349 {
1350     unsigned char data[2] = { address >> 8, address & 0xff };
1351     struct i2c_client *client = sensor->i2c_client;
1352     int ret;
1353 
1354     ret = i2c_master_send(client, data, sizeof(data));
1355     if (ret < 0) {
1356         dev_dbg(&client->dev, "i2c send error at address %#04x\n",
1357             address);
1358         return ret;
1359     }
1360 
1361     ret = i2c_master_recv(client, value, 1);
1362     if (ret < 0) {
1363         dev_dbg(&client->dev, "i2c recv error at address %#04x\n",
1364             address);
1365         return ret;
1366     }
1367 
1368     return 0;
1369 }
1370 
1371 static int ov8865_write(struct ov8865_sensor *sensor, u16 address, u8 value)
1372 {
1373     unsigned char data[3] = { address >> 8, address & 0xff, value };
1374     struct i2c_client *client = sensor->i2c_client;
1375     int ret;
1376 
1377     ret = i2c_master_send(client, data, sizeof(data));
1378     if (ret < 0) {
1379         dev_dbg(&client->dev, "i2c send error at address %#04x\n",
1380             address);
1381         return ret;
1382     }
1383 
1384     return 0;
1385 }
1386 
1387 static int ov8865_write_sequence(struct ov8865_sensor *sensor,
1388                  const struct ov8865_register_value *sequence,
1389                  unsigned int sequence_count)
1390 {
1391     unsigned int i;
1392     int ret = 0;
1393 
1394     for (i = 0; i < sequence_count; i++) {
1395         ret = ov8865_write(sensor, sequence[i].address,
1396                    sequence[i].value);
1397         if (ret)
1398             break;
1399 
1400         if (sequence[i].delay_ms)
1401             msleep(sequence[i].delay_ms);
1402     }
1403 
1404     return ret;
1405 }
1406 
1407 static int ov8865_update_bits(struct ov8865_sensor *sensor, u16 address,
1408                   u8 mask, u8 bits)
1409 {
1410     u8 value = 0;
1411     int ret;
1412 
1413     ret = ov8865_read(sensor, address, &value);
1414     if (ret)
1415         return ret;
1416 
1417     value &= ~mask;
1418     value |= bits;
1419 
1420     return ov8865_write(sensor, address, value);
1421 }
1422 
1423 /* Sensor */
1424 
1425 static int ov8865_sw_reset(struct ov8865_sensor *sensor)
1426 {
1427     return ov8865_write(sensor, OV8865_SW_RESET_REG, OV8865_SW_RESET_RESET);
1428 }
1429 
1430 static int ov8865_sw_standby(struct ov8865_sensor *sensor, int standby)
1431 {
1432     u8 value = 0;
1433 
1434     if (!standby)
1435         value = OV8865_SW_STANDBY_STREAM_ON;
1436 
1437     return ov8865_write(sensor, OV8865_SW_STANDBY_REG, value);
1438 }
1439 
1440 static int ov8865_chip_id_check(struct ov8865_sensor *sensor)
1441 {
1442     u16 regs[] = { OV8865_CHIP_ID_HH_REG, OV8865_CHIP_ID_H_REG,
1443                OV8865_CHIP_ID_L_REG };
1444     u8 values[] = { OV8865_CHIP_ID_HH_VALUE, OV8865_CHIP_ID_H_VALUE,
1445             OV8865_CHIP_ID_L_VALUE };
1446     unsigned int i;
1447     u8 value;
1448     int ret;
1449 
1450     for (i = 0; i < ARRAY_SIZE(regs); i++) {
1451         ret = ov8865_read(sensor, regs[i], &value);
1452         if (ret < 0)
1453             return ret;
1454 
1455         if (value != values[i]) {
1456             dev_err(sensor->dev,
1457                 "chip id value mismatch: %#x instead of %#x\n",
1458                 value, values[i]);
1459             return -EINVAL;
1460         }
1461     }
1462 
1463     return 0;
1464 }
1465 
1466 static int ov8865_charge_pump_configure(struct ov8865_sensor *sensor)
1467 {
1468     return ov8865_write(sensor, OV8865_PUMP_CLK_DIV_REG,
1469                 OV8865_PUMP_CLK_DIV_PUMP_P(1));
1470 }
1471 
1472 static int ov8865_mipi_configure(struct ov8865_sensor *sensor)
1473 {
1474     struct v4l2_mbus_config_mipi_csi2 *bus_mipi_csi2 =
1475         &sensor->endpoint.bus.mipi_csi2;
1476     unsigned int lanes_count = bus_mipi_csi2->num_data_lanes;
1477     int ret;
1478 
1479     ret = ov8865_write(sensor, OV8865_MIPI_SC_CTRL0_REG,
1480                OV8865_MIPI_SC_CTRL0_LANES(lanes_count) |
1481                OV8865_MIPI_SC_CTRL0_MIPI_EN |
1482                OV8865_MIPI_SC_CTRL0_UNKNOWN);
1483     if (ret)
1484         return ret;
1485 
1486     ret = ov8865_write(sensor, OV8865_MIPI_SC_CTRL2_REG,
1487                OV8865_MIPI_SC_CTRL2_PD_MIPI_RST_SYNC);
1488     if (ret)
1489         return ret;
1490 
1491     if (lanes_count >= 2) {
1492         ret = ov8865_write(sensor, OV8865_MIPI_LANE_SEL01_REG,
1493                    OV8865_MIPI_LANE_SEL01_LANE0(0) |
1494                    OV8865_MIPI_LANE_SEL01_LANE1(1));
1495         if (ret)
1496             return ret;
1497     }
1498 
1499     if (lanes_count >= 4) {
1500         ret = ov8865_write(sensor, OV8865_MIPI_LANE_SEL23_REG,
1501                    OV8865_MIPI_LANE_SEL23_LANE2(2) |
1502                    OV8865_MIPI_LANE_SEL23_LANE3(3));
1503         if (ret)
1504             return ret;
1505     }
1506 
1507     ret = ov8865_update_bits(sensor, OV8865_CLK_SEL1_REG,
1508                  OV8865_CLK_SEL1_MIPI_EOF,
1509                  OV8865_CLK_SEL1_MIPI_EOF);
1510     if (ret)
1511         return ret;
1512 
1513     /*
1514      * This value might need to change depending on PCLK rate,
1515      * but it's unclear how. This value seems to generally work
1516      * while the default value was found to cause transmission errors.
1517      */
1518     return ov8865_write(sensor, OV8865_MIPI_PCLK_PERIOD_REG, 0x16);
1519 }
1520 
1521 static int ov8865_black_level_configure(struct ov8865_sensor *sensor)
1522 {
1523     int ret;
1524 
1525     /* Trigger BLC on relevant events and enable filter. */
1526     ret = ov8865_write(sensor, OV8865_BLC_CTRL0_REG,
1527                OV8865_BLC_CTRL0_TRIG_RANGE_EN |
1528                OV8865_BLC_CTRL0_TRIG_FORMAT_EN |
1529                OV8865_BLC_CTRL0_TRIG_GAIN_EN |
1530                OV8865_BLC_CTRL0_TRIG_EXPOSURE_EN |
1531                OV8865_BLC_CTRL0_FILTER_EN);
1532     if (ret)
1533         return ret;
1534 
1535     /* Lower BLC offset trigger threshold. */
1536     ret = ov8865_write(sensor, OV8865_BLC_CTRLD_REG,
1537                OV8865_BLC_CTRLD_OFFSET_TRIGGER(16));
1538     if (ret)
1539         return ret;
1540 
1541     ret = ov8865_write(sensor, OV8865_BLC_CTRL1F_REG, 0);
1542     if (ret)
1543         return ret;
1544 
1545     /* Increase BLC offset maximum limit. */
1546     return ov8865_write(sensor, OV8865_BLC_OFFSET_LIMIT_REG,
1547                 OV8865_BLC_OFFSET_LIMIT(63));
1548 }
1549 
1550 static int ov8865_isp_configure(struct ov8865_sensor *sensor)
1551 {
1552     int ret;
1553 
1554     /* Disable lens correction. */
1555     ret = ov8865_write(sensor, OV8865_ISP_CTRL0_REG,
1556                OV8865_ISP_CTRL0_WHITE_BALANCE_EN |
1557                OV8865_ISP_CTRL0_DPC_BLACK_EN |
1558                OV8865_ISP_CTRL0_DPC_WHITE_EN);
1559     if (ret)
1560         return ret;
1561 
1562     return ov8865_write(sensor, OV8865_ISP_CTRL1_REG,
1563                 OV8865_ISP_CTRL1_BLC_EN);
1564 }
1565 
1566 static unsigned long ov8865_mode_pll1_rate(struct ov8865_sensor *sensor,
1567                        const struct ov8865_mode *mode)
1568 {
1569     const struct ov8865_pll1_config *config;
1570     unsigned long pll1_rate;
1571 
1572     config = sensor->pll_configs->pll1_config;
1573     pll1_rate = sensor->extclk_rate * config->pll_mul / config->pll_pre_div_half;
1574 
1575     switch (config->pll_pre_div) {
1576     case 0:
1577         break;
1578     case 1:
1579         pll1_rate *= 3;
1580         pll1_rate /= 2;
1581         break;
1582     case 3:
1583         pll1_rate *= 5;
1584         pll1_rate /= 2;
1585         break;
1586     case 4:
1587         pll1_rate /= 3;
1588         break;
1589     case 5:
1590         pll1_rate /= 4;
1591         break;
1592     case 7:
1593         pll1_rate /= 8;
1594         break;
1595     default:
1596         pll1_rate /= config->pll_pre_div;
1597         break;
1598     }
1599 
1600     return pll1_rate;
1601 }
1602 
1603 static int ov8865_mode_pll1_configure(struct ov8865_sensor *sensor,
1604                       const struct ov8865_mode *mode,
1605                       u32 mbus_code)
1606 {
1607     const struct ov8865_pll1_config *config;
1608     u8 value;
1609     int ret;
1610 
1611     config = sensor->pll_configs->pll1_config;
1612 
1613     switch (mbus_code) {
1614     case MEDIA_BUS_FMT_SBGGR10_1X10:
1615         value = OV8865_MIPI_BIT_SEL(10);
1616         break;
1617     default:
1618         return -EINVAL;
1619     }
1620 
1621     ret = ov8865_write(sensor, OV8865_MIPI_BIT_SEL_REG, value);
1622     if (ret)
1623         return ret;
1624 
1625     ret = ov8865_write(sensor, OV8865_PLL_CTRLA_REG,
1626                OV8865_PLL_CTRLA_PRE_DIV_HALF(config->pll_pre_div_half));
1627     if (ret)
1628         return ret;
1629 
1630     ret = ov8865_write(sensor, OV8865_PLL_CTRL0_REG,
1631                OV8865_PLL_CTRL0_PRE_DIV(config->pll_pre_div));
1632     if (ret)
1633         return ret;
1634 
1635     ret = ov8865_write(sensor, OV8865_PLL_CTRL1_REG,
1636                OV8865_PLL_CTRL1_MUL_H(config->pll_mul));
1637     if (ret)
1638         return ret;
1639 
1640     ret = ov8865_write(sensor, OV8865_PLL_CTRL2_REG,
1641                OV8865_PLL_CTRL2_MUL_L(config->pll_mul));
1642     if (ret)
1643         return ret;
1644 
1645     ret = ov8865_write(sensor, OV8865_PLL_CTRL3_REG,
1646                OV8865_PLL_CTRL3_M_DIV(config->m_div));
1647     if (ret)
1648         return ret;
1649 
1650     ret = ov8865_write(sensor, OV8865_PLL_CTRL4_REG,
1651                OV8865_PLL_CTRL4_MIPI_DIV(config->mipi_div));
1652     if (ret)
1653         return ret;
1654 
1655     ret = ov8865_update_bits(sensor, OV8865_PCLK_SEL_REG,
1656                  OV8865_PCLK_SEL_PCLK_DIV_MASK,
1657                  OV8865_PCLK_SEL_PCLK_DIV(config->pclk_div));
1658     if (ret)
1659         return ret;
1660 
1661     ret = ov8865_write(sensor, OV8865_PLL_CTRL5_REG,
1662                OV8865_PLL_CTRL5_SYS_PRE_DIV(config->sys_pre_div));
1663     if (ret)
1664         return ret;
1665 
1666     ret = ov8865_write(sensor, OV8865_PLL_CTRL6_REG,
1667                OV8865_PLL_CTRL6_SYS_DIV(config->sys_div));
1668     if (ret)
1669         return ret;
1670 
1671     return ov8865_update_bits(sensor, OV8865_PLL_CTRL1E_REG,
1672                   OV8865_PLL_CTRL1E_PLL1_NO_LAT,
1673                   OV8865_PLL_CTRL1E_PLL1_NO_LAT);
1674 }
1675 
1676 static int ov8865_mode_pll2_configure(struct ov8865_sensor *sensor,
1677                       const struct ov8865_mode *mode)
1678 {
1679     const struct ov8865_pll2_config *config;
1680     int ret;
1681 
1682     config = mode->pll2_binning ? sensor->pll_configs->pll2_config_binning :
1683                       sensor->pll_configs->pll2_config_native;
1684 
1685     ret = ov8865_write(sensor, OV8865_PLL_CTRL12_REG,
1686                OV8865_PLL_CTRL12_PRE_DIV_HALF(config->pll_pre_div_half) |
1687                OV8865_PLL_CTRL12_DAC_DIV(config->dac_div));
1688     if (ret)
1689         return ret;
1690 
1691     ret = ov8865_write(sensor, OV8865_PLL_CTRLB_REG,
1692                OV8865_PLL_CTRLB_PRE_DIV(config->pll_pre_div));
1693     if (ret)
1694         return ret;
1695 
1696     ret = ov8865_write(sensor, OV8865_PLL_CTRLC_REG,
1697                OV8865_PLL_CTRLC_MUL_H(config->pll_mul));
1698     if (ret)
1699         return ret;
1700 
1701     ret = ov8865_write(sensor, OV8865_PLL_CTRLD_REG,
1702                OV8865_PLL_CTRLD_MUL_L(config->pll_mul));
1703     if (ret)
1704         return ret;
1705 
1706     ret = ov8865_write(sensor, OV8865_PLL_CTRLF_REG,
1707                OV8865_PLL_CTRLF_SYS_PRE_DIV(config->sys_pre_div));
1708     if (ret)
1709         return ret;
1710 
1711     return ov8865_write(sensor, OV8865_PLL_CTRLE_REG,
1712                 OV8865_PLL_CTRLE_SYS_DIV(config->sys_div));
1713 }
1714 
1715 static int ov8865_mode_sclk_configure(struct ov8865_sensor *sensor,
1716                       const struct ov8865_mode *mode)
1717 {
1718     const struct ov8865_sclk_config *config = &ov8865_sclk_config_native;
1719     int ret;
1720 
1721     ret = ov8865_write(sensor, OV8865_CLK_SEL0_REG,
1722                OV8865_CLK_SEL0_PLL1_SYS_SEL(config->sys_sel));
1723     if (ret)
1724         return ret;
1725 
1726     ret = ov8865_update_bits(sensor, OV8865_CLK_SEL1_REG,
1727                  OV8865_CLK_SEL1_PLL_SCLK_SEL_MASK,
1728                  OV8865_CLK_SEL1_PLL_SCLK_SEL(config->sclk_sel));
1729     if (ret)
1730         return ret;
1731 
1732     return ov8865_write(sensor, OV8865_SCLK_CTRL_REG,
1733                 OV8865_SCLK_CTRL_UNKNOWN |
1734                 OV8865_SCLK_CTRL_SCLK_DIV(config->sclk_div) |
1735                 OV8865_SCLK_CTRL_SCLK_PRE_DIV(config->sclk_pre_div));
1736 }
1737 
1738 static int ov8865_mode_binning_configure(struct ov8865_sensor *sensor,
1739                      const struct ov8865_mode *mode)
1740 {
1741     unsigned int variopixel_hsub_coef, variopixel_vsub_coef;
1742     u8 value;
1743     int ret;
1744 
1745     ret = ov8865_write(sensor, OV8865_FORMAT1_REG, 0);
1746     if (ret)
1747         return ret;
1748 
1749     value = OV8865_FORMAT2_HSYNC_EN;
1750 
1751     if (mode->binning_x)
1752         value |= OV8865_FORMAT2_FST_HBIN_EN;
1753 
1754     if (mode->binning_y)
1755         value |= OV8865_FORMAT2_FST_VBIN_EN;
1756 
1757     if (mode->sync_hbin)
1758         value |= OV8865_FORMAT2_SYNC_HBIN_EN;
1759 
1760     if (mode->horz_var2)
1761         value |= OV8865_FORMAT2_ISP_HORZ_VAR2_EN;
1762 
1763     ret = ov8865_write(sensor, OV8865_FORMAT2_REG, value);
1764     if (ret)
1765         return ret;
1766 
1767     ret = ov8865_update_bits(sensor, OV8865_ISP_CTRL2_REG,
1768                  OV8865_ISP_CTRL2_VARIOPIXEL_EN,
1769                  mode->variopixel ?
1770                  OV8865_ISP_CTRL2_VARIOPIXEL_EN : 0);
1771     if (ret)
1772         return ret;
1773 
1774     if (mode->variopixel) {
1775         /* VarioPixel coefs needs to be > 1. */
1776         variopixel_hsub_coef = mode->variopixel_hsub_coef;
1777         variopixel_vsub_coef = mode->variopixel_vsub_coef;
1778     } else {
1779         variopixel_hsub_coef = 1;
1780         variopixel_vsub_coef = 1;
1781     }
1782 
1783     ret = ov8865_write(sensor, OV8865_VAP_CTRL1_REG,
1784                OV8865_VAP_CTRL1_HSUB_COEF(variopixel_hsub_coef) |
1785                OV8865_VAP_CTRL1_VSUB_COEF(variopixel_vsub_coef));
1786     if (ret)
1787         return ret;
1788 
1789     ret = ov8865_write(sensor, OV8865_INC_X_ODD_REG,
1790                OV8865_INC_X_ODD(mode->inc_x_odd));
1791     if (ret)
1792         return ret;
1793 
1794     ret = ov8865_write(sensor, OV8865_INC_X_EVEN_REG,
1795                OV8865_INC_X_EVEN(mode->inc_x_even));
1796     if (ret)
1797         return ret;
1798 
1799     ret = ov8865_write(sensor, OV8865_INC_Y_ODD_REG,
1800                OV8865_INC_Y_ODD(mode->inc_y_odd));
1801     if (ret)
1802         return ret;
1803 
1804     return ov8865_write(sensor, OV8865_INC_Y_EVEN_REG,
1805                 OV8865_INC_Y_EVEN(mode->inc_y_even));
1806 }
1807 
1808 static int ov8865_mode_black_level_configure(struct ov8865_sensor *sensor,
1809                          const struct ov8865_mode *mode)
1810 {
1811     int ret;
1812 
1813     /* Note that a zero value for blc_col_shift_mask is the default 256. */
1814     ret = ov8865_write(sensor, OV8865_BLC_CTRL1_REG,
1815                mode->blc_col_shift_mask |
1816                OV8865_BLC_CTRL1_OFFSET_LIMIT_EN);
1817     if (ret)
1818         return ret;
1819 
1820     /* BLC top zero line */
1821 
1822     ret = ov8865_write(sensor, OV8865_BLC_TOP_ZLINE_START_REG,
1823                OV8865_BLC_TOP_ZLINE_START(mode->blc_top_zero_line_start));
1824     if (ret)
1825         return ret;
1826 
1827     ret = ov8865_write(sensor, OV8865_BLC_TOP_ZLINE_NUM_REG,
1828                OV8865_BLC_TOP_ZLINE_NUM(mode->blc_top_zero_line_num));
1829     if (ret)
1830         return ret;
1831 
1832     /* BLC top black line */
1833 
1834     ret = ov8865_write(sensor, OV8865_BLC_TOP_BLKLINE_START_REG,
1835                OV8865_BLC_TOP_BLKLINE_START(mode->blc_top_black_line_start));
1836     if (ret)
1837         return ret;
1838 
1839     ret = ov8865_write(sensor, OV8865_BLC_TOP_BLKLINE_NUM_REG,
1840                OV8865_BLC_TOP_BLKLINE_NUM(mode->blc_top_black_line_num));
1841     if (ret)
1842         return ret;
1843 
1844     /* BLC bottom zero line */
1845 
1846     ret = ov8865_write(sensor, OV8865_BLC_BOT_ZLINE_START_REG,
1847                OV8865_BLC_BOT_ZLINE_START(mode->blc_bottom_zero_line_start));
1848     if (ret)
1849         return ret;
1850 
1851     ret = ov8865_write(sensor, OV8865_BLC_BOT_ZLINE_NUM_REG,
1852                OV8865_BLC_BOT_ZLINE_NUM(mode->blc_bottom_zero_line_num));
1853     if (ret)
1854         return ret;
1855 
1856     /* BLC bottom black line */
1857 
1858     ret = ov8865_write(sensor, OV8865_BLC_BOT_BLKLINE_START_REG,
1859                OV8865_BLC_BOT_BLKLINE_START(mode->blc_bottom_black_line_start));
1860     if (ret)
1861         return ret;
1862 
1863     ret = ov8865_write(sensor, OV8865_BLC_BOT_BLKLINE_NUM_REG,
1864                OV8865_BLC_BOT_BLKLINE_NUM(mode->blc_bottom_black_line_num));
1865     if (ret)
1866         return ret;
1867 
1868     /* BLC anchor */
1869 
1870     ret = ov8865_write(sensor, OV8865_BLC_ANCHOR_LEFT_START_H_REG,
1871                OV8865_BLC_ANCHOR_LEFT_START_H(mode->blc_anchor_left_start));
1872     if (ret)
1873         return ret;
1874 
1875     ret = ov8865_write(sensor, OV8865_BLC_ANCHOR_LEFT_START_L_REG,
1876                OV8865_BLC_ANCHOR_LEFT_START_L(mode->blc_anchor_left_start));
1877     if (ret)
1878         return ret;
1879 
1880     ret = ov8865_write(sensor, OV8865_BLC_ANCHOR_LEFT_END_H_REG,
1881                OV8865_BLC_ANCHOR_LEFT_END_H(mode->blc_anchor_left_end));
1882     if (ret)
1883         return ret;
1884 
1885     ret = ov8865_write(sensor, OV8865_BLC_ANCHOR_LEFT_END_L_REG,
1886                OV8865_BLC_ANCHOR_LEFT_END_L(mode->blc_anchor_left_end));
1887     if (ret)
1888         return ret;
1889 
1890     ret = ov8865_write(sensor, OV8865_BLC_ANCHOR_RIGHT_START_H_REG,
1891                OV8865_BLC_ANCHOR_RIGHT_START_H(mode->blc_anchor_right_start));
1892     if (ret)
1893         return ret;
1894 
1895     ret = ov8865_write(sensor, OV8865_BLC_ANCHOR_RIGHT_START_L_REG,
1896                OV8865_BLC_ANCHOR_RIGHT_START_L(mode->blc_anchor_right_start));
1897     if (ret)
1898         return ret;
1899 
1900     ret = ov8865_write(sensor, OV8865_BLC_ANCHOR_RIGHT_END_H_REG,
1901                OV8865_BLC_ANCHOR_RIGHT_END_H(mode->blc_anchor_right_end));
1902     if (ret)
1903         return ret;
1904 
1905     return ov8865_write(sensor, OV8865_BLC_ANCHOR_RIGHT_END_L_REG,
1906                 OV8865_BLC_ANCHOR_RIGHT_END_L(mode->blc_anchor_right_end));
1907 }
1908 
1909 static int ov8865_mode_configure(struct ov8865_sensor *sensor,
1910                  const struct ov8865_mode *mode, u32 mbus_code)
1911 {
1912     int ret;
1913 
1914     /* Output Size X */
1915 
1916     ret = ov8865_write(sensor, OV8865_OUTPUT_SIZE_X_H_REG,
1917                OV8865_OUTPUT_SIZE_X_H(mode->output_size_x));
1918     if (ret)
1919         return ret;
1920 
1921     ret = ov8865_write(sensor, OV8865_OUTPUT_SIZE_X_L_REG,
1922                OV8865_OUTPUT_SIZE_X_L(mode->output_size_x));
1923     if (ret)
1924         return ret;
1925 
1926     /* Horizontal Total Size */
1927 
1928     ret = ov8865_write(sensor, OV8865_HTS_H_REG, OV8865_HTS_H(mode->hts));
1929     if (ret)
1930         return ret;
1931 
1932     ret = ov8865_write(sensor, OV8865_HTS_L_REG, OV8865_HTS_L(mode->hts));
1933     if (ret)
1934         return ret;
1935 
1936     /* Output Size Y */
1937 
1938     ret = ov8865_write(sensor, OV8865_OUTPUT_SIZE_Y_H_REG,
1939                OV8865_OUTPUT_SIZE_Y_H(mode->output_size_y));
1940     if (ret)
1941         return ret;
1942 
1943     ret = ov8865_write(sensor, OV8865_OUTPUT_SIZE_Y_L_REG,
1944                OV8865_OUTPUT_SIZE_Y_L(mode->output_size_y));
1945     if (ret)
1946         return ret;
1947 
1948     /* Vertical Total Size */
1949 
1950     ret = ov8865_write(sensor, OV8865_VTS_H_REG, OV8865_VTS_H(mode->vts));
1951     if (ret)
1952         return ret;
1953 
1954     ret = ov8865_write(sensor, OV8865_VTS_L_REG, OV8865_VTS_L(mode->vts));
1955     if (ret)
1956         return ret;
1957 
1958     if (mode->size_auto) {
1959         /* Auto Size */
1960 
1961         ret = ov8865_write(sensor, OV8865_AUTO_SIZE_CTRL_REG,
1962                    OV8865_AUTO_SIZE_CTRL_OFFSET_Y_REG |
1963                    OV8865_AUTO_SIZE_CTRL_OFFSET_X_REG |
1964                    OV8865_AUTO_SIZE_CTRL_CROP_END_Y_REG |
1965                    OV8865_AUTO_SIZE_CTRL_CROP_END_X_REG |
1966                    OV8865_AUTO_SIZE_CTRL_CROP_START_Y_REG |
1967                    OV8865_AUTO_SIZE_CTRL_CROP_START_X_REG);
1968         if (ret)
1969             return ret;
1970 
1971         ret = ov8865_write(sensor, OV8865_AUTO_SIZE_BOUNDARIES_REG,
1972                    OV8865_AUTO_SIZE_BOUNDARIES_Y(mode->size_auto_boundary_y) |
1973                    OV8865_AUTO_SIZE_BOUNDARIES_X(mode->size_auto_boundary_x));
1974         if (ret)
1975             return ret;
1976     } else {
1977         /* Crop Start X */
1978 
1979         ret = ov8865_write(sensor, OV8865_CROP_START_X_H_REG,
1980                    OV8865_CROP_START_X_H(mode->crop_start_x));
1981         if (ret)
1982             return ret;
1983 
1984         ret = ov8865_write(sensor, OV8865_CROP_START_X_L_REG,
1985                    OV8865_CROP_START_X_L(mode->crop_start_x));
1986         if (ret)
1987             return ret;
1988 
1989         /* Offset X */
1990 
1991         ret = ov8865_write(sensor, OV8865_OFFSET_X_H_REG,
1992                    OV8865_OFFSET_X_H(mode->offset_x));
1993         if (ret)
1994             return ret;
1995 
1996         ret = ov8865_write(sensor, OV8865_OFFSET_X_L_REG,
1997                    OV8865_OFFSET_X_L(mode->offset_x));
1998         if (ret)
1999             return ret;
2000 
2001         /* Crop End X */
2002 
2003         ret = ov8865_write(sensor, OV8865_CROP_END_X_H_REG,
2004                    OV8865_CROP_END_X_H(mode->crop_end_x));
2005         if (ret)
2006             return ret;
2007 
2008         ret = ov8865_write(sensor, OV8865_CROP_END_X_L_REG,
2009                    OV8865_CROP_END_X_L(mode->crop_end_x));
2010         if (ret)
2011             return ret;
2012 
2013         /* Crop Start Y */
2014 
2015         ret = ov8865_write(sensor, OV8865_CROP_START_Y_H_REG,
2016                    OV8865_CROP_START_Y_H(mode->crop_start_y));
2017         if (ret)
2018             return ret;
2019 
2020         ret = ov8865_write(sensor, OV8865_CROP_START_Y_L_REG,
2021                    OV8865_CROP_START_Y_L(mode->crop_start_y));
2022         if (ret)
2023             return ret;
2024 
2025         /* Offset Y */
2026 
2027         ret = ov8865_write(sensor, OV8865_OFFSET_Y_H_REG,
2028                    OV8865_OFFSET_Y_H(mode->offset_y));
2029         if (ret)
2030             return ret;
2031 
2032         ret = ov8865_write(sensor, OV8865_OFFSET_Y_L_REG,
2033                    OV8865_OFFSET_Y_L(mode->offset_y));
2034         if (ret)
2035             return ret;
2036 
2037         /* Crop End Y */
2038 
2039         ret = ov8865_write(sensor, OV8865_CROP_END_Y_H_REG,
2040                    OV8865_CROP_END_Y_H(mode->crop_end_y));
2041         if (ret)
2042             return ret;
2043 
2044         ret = ov8865_write(sensor, OV8865_CROP_END_Y_L_REG,
2045                    OV8865_CROP_END_Y_L(mode->crop_end_y));
2046         if (ret)
2047             return ret;
2048     }
2049 
2050     /* VFIFO */
2051 
2052     ret = ov8865_write(sensor, OV8865_VFIFO_READ_START_H_REG,
2053                OV8865_VFIFO_READ_START_H(mode->vfifo_read_start));
2054     if (ret)
2055         return ret;
2056 
2057     ret = ov8865_write(sensor, OV8865_VFIFO_READ_START_L_REG,
2058                OV8865_VFIFO_READ_START_L(mode->vfifo_read_start));
2059     if (ret)
2060         return ret;
2061 
2062     ret = ov8865_write(sensor, OV8865_ABLC_NUM_REG,
2063                OV8865_ABLC_NUM(mode->ablc_num));
2064     if (ret)
2065         return ret;
2066 
2067     ret = ov8865_write(sensor, OV8865_ZLINE_NUM_REG,
2068                OV8865_ZLINE_NUM(mode->zline_num));
2069     if (ret)
2070         return ret;
2071 
2072     /* Binning */
2073 
2074     ret = ov8865_mode_binning_configure(sensor, mode);
2075     if (ret)
2076         return ret;
2077 
2078     /* Black Level */
2079 
2080     ret = ov8865_mode_black_level_configure(sensor, mode);
2081     if (ret)
2082         return ret;
2083 
2084     /* PLLs */
2085 
2086     ret = ov8865_mode_pll1_configure(sensor, mode, mbus_code);
2087     if (ret)
2088         return ret;
2089 
2090     ret = ov8865_mode_pll2_configure(sensor, mode);
2091     if (ret)
2092         return ret;
2093 
2094     ret = ov8865_mode_sclk_configure(sensor, mode);
2095     if (ret)
2096         return ret;
2097 
2098     /* Extra registers */
2099 
2100     if (mode->register_values) {
2101         ret = ov8865_write_sequence(sensor, mode->register_values,
2102                         mode->register_values_count);
2103         if (ret)
2104             return ret;
2105     }
2106 
2107     return 0;
2108 }
2109 
2110 static unsigned long ov8865_mode_mipi_clk_rate(struct ov8865_sensor *sensor,
2111                            const struct ov8865_mode *mode)
2112 {
2113     const struct ov8865_pll1_config *config;
2114     unsigned long pll1_rate;
2115 
2116     config = sensor->pll_configs->pll1_config;
2117 
2118     pll1_rate = ov8865_mode_pll1_rate(sensor, mode);
2119 
2120     return pll1_rate / config->m_div / 2;
2121 }
2122 
2123 /* Exposure */
2124 
2125 static int ov8865_exposure_configure(struct ov8865_sensor *sensor, u32 exposure)
2126 {
2127     int ret;
2128 
2129     /* The sensor stores exposure in units of 1/16th of a line */
2130     exposure *= 16;
2131 
2132     ret = ov8865_write(sensor, OV8865_EXPOSURE_CTRL_HH_REG,
2133                OV8865_EXPOSURE_CTRL_HH(exposure));
2134     if (ret)
2135         return ret;
2136 
2137     ret = ov8865_write(sensor, OV8865_EXPOSURE_CTRL_H_REG,
2138                OV8865_EXPOSURE_CTRL_H(exposure));
2139     if (ret)
2140         return ret;
2141 
2142     return ov8865_write(sensor, OV8865_EXPOSURE_CTRL_L_REG,
2143                 OV8865_EXPOSURE_CTRL_L(exposure));
2144 }
2145 
2146 /* Gain */
2147 
2148 static int ov8865_analog_gain_configure(struct ov8865_sensor *sensor, u32 gain)
2149 {
2150     int ret;
2151 
2152     ret = ov8865_write(sensor, OV8865_GAIN_CTRL_H_REG,
2153                OV8865_GAIN_CTRL_H(gain));
2154     if (ret)
2155         return ret;
2156 
2157     return ov8865_write(sensor, OV8865_GAIN_CTRL_L_REG,
2158                 OV8865_GAIN_CTRL_L(gain));
2159 }
2160 
2161 /* White Balance */
2162 
2163 static int ov8865_red_balance_configure(struct ov8865_sensor *sensor,
2164                     u32 red_balance)
2165 {
2166     int ret;
2167 
2168     ret = ov8865_write(sensor, OV8865_ISP_GAIN_RED_H_REG,
2169                OV8865_ISP_GAIN_RED_H(red_balance));
2170     if (ret)
2171         return ret;
2172 
2173     return ov8865_write(sensor, OV8865_ISP_GAIN_RED_L_REG,
2174                 OV8865_ISP_GAIN_RED_L(red_balance));
2175 }
2176 
2177 static int ov8865_blue_balance_configure(struct ov8865_sensor *sensor,
2178                      u32 blue_balance)
2179 {
2180     int ret;
2181 
2182     ret = ov8865_write(sensor, OV8865_ISP_GAIN_BLUE_H_REG,
2183                OV8865_ISP_GAIN_BLUE_H(blue_balance));
2184     if (ret)
2185         return ret;
2186 
2187     return ov8865_write(sensor, OV8865_ISP_GAIN_BLUE_L_REG,
2188                 OV8865_ISP_GAIN_BLUE_L(blue_balance));
2189 }
2190 
2191 /* Flip */
2192 
2193 static int ov8865_flip_vert_configure(struct ov8865_sensor *sensor, bool enable)
2194 {
2195     u8 bits = OV8865_FORMAT1_FLIP_VERT_ISP_EN |
2196           OV8865_FORMAT1_FLIP_VERT_SENSOR_EN;
2197 
2198     return ov8865_update_bits(sensor, OV8865_FORMAT1_REG, bits,
2199                   enable ? bits : 0);
2200 }
2201 
2202 static int ov8865_flip_horz_configure(struct ov8865_sensor *sensor, bool enable)
2203 {
2204     u8 bits = OV8865_FORMAT2_FLIP_HORZ_ISP_EN |
2205           OV8865_FORMAT2_FLIP_HORZ_SENSOR_EN;
2206 
2207     return ov8865_update_bits(sensor, OV8865_FORMAT2_REG, bits,
2208                   enable ? bits : 0);
2209 }
2210 
2211 /* Test Pattern */
2212 
2213 static int ov8865_test_pattern_configure(struct ov8865_sensor *sensor,
2214                      unsigned int index)
2215 {
2216     if (index >= ARRAY_SIZE(ov8865_test_pattern_bits))
2217         return -EINVAL;
2218 
2219     return ov8865_write(sensor, OV8865_PRE_CTRL0_REG,
2220                 ov8865_test_pattern_bits[index]);
2221 }
2222 
2223 /* Blanking */
2224 
2225 static int ov8865_vts_configure(struct ov8865_sensor *sensor, u32 vblank)
2226 {
2227     u16 vts = sensor->state.mode->output_size_y + vblank;
2228     int ret;
2229 
2230     ret = ov8865_write(sensor, OV8865_VTS_H_REG, OV8865_VTS_H(vts));
2231     if (ret)
2232         return ret;
2233 
2234     return ov8865_write(sensor, OV8865_VTS_L_REG, OV8865_VTS_L(vts));
2235 }
2236 
2237 /* State */
2238 
2239 static int ov8865_state_mipi_configure(struct ov8865_sensor *sensor,
2240                        const struct ov8865_mode *mode,
2241                        u32 mbus_code)
2242 {
2243     struct ov8865_ctrls *ctrls = &sensor->ctrls;
2244     struct v4l2_mbus_config_mipi_csi2 *bus_mipi_csi2 =
2245         &sensor->endpoint.bus.mipi_csi2;
2246     unsigned long mipi_clk_rate;
2247     unsigned int bits_per_sample;
2248     unsigned int lanes_count;
2249     unsigned int i, j;
2250     s64 mipi_pixel_rate;
2251 
2252     mipi_clk_rate = ov8865_mode_mipi_clk_rate(sensor, mode);
2253     if (!mipi_clk_rate)
2254         return -EINVAL;
2255 
2256     for (i = 0; i < ARRAY_SIZE(ov8865_link_freq_menu); i++) {
2257         s64 freq = ov8865_link_freq_menu[i];
2258 
2259         if (freq == mipi_clk_rate)
2260             break;
2261     }
2262 
2263     for (j = 0; j < sensor->endpoint.nr_of_link_frequencies; j++) {
2264         u64 freq = sensor->endpoint.link_frequencies[j];
2265 
2266         if (freq == mipi_clk_rate)
2267             break;
2268     }
2269 
2270     if (i == ARRAY_SIZE(ov8865_link_freq_menu)) {
2271         dev_err(sensor->dev,
2272             "failed to find %lu clk rate in link freq\n",
2273             mipi_clk_rate);
2274     } else if (j == sensor->endpoint.nr_of_link_frequencies) {
2275         dev_err(sensor->dev,
2276             "failed to find %lu clk rate in endpoint link-frequencies\n",
2277             mipi_clk_rate);
2278     } else {
2279         __v4l2_ctrl_s_ctrl(ctrls->link_freq, i);
2280     }
2281 
2282     switch (mbus_code) {
2283     case MEDIA_BUS_FMT_SBGGR10_1X10:
2284         bits_per_sample = 10;
2285         break;
2286     default:
2287         return -EINVAL;
2288     }
2289 
2290     lanes_count = bus_mipi_csi2->num_data_lanes;
2291     mipi_pixel_rate = mipi_clk_rate * 2 * lanes_count / bits_per_sample;
2292 
2293     __v4l2_ctrl_s_ctrl_int64(ctrls->pixel_rate, mipi_pixel_rate);
2294 
2295     return 0;
2296 }
2297 
2298 static int ov8865_state_configure(struct ov8865_sensor *sensor,
2299                   const struct ov8865_mode *mode,
2300                   u32 mbus_code)
2301 {
2302     int ret;
2303 
2304     if (sensor->state.streaming)
2305         return -EBUSY;
2306 
2307     /* State will be configured at first power on otherwise. */
2308     if (pm_runtime_enabled(sensor->dev) &&
2309         !pm_runtime_suspended(sensor->dev)) {
2310         ret = ov8865_mode_configure(sensor, mode, mbus_code);
2311         if (ret)
2312             return ret;
2313     }
2314 
2315     ret = ov8865_state_mipi_configure(sensor, mode, mbus_code);
2316     if (ret)
2317         return ret;
2318 
2319     sensor->state.mode = mode;
2320     sensor->state.mbus_code = mbus_code;
2321 
2322     return 0;
2323 }
2324 
2325 static int ov8865_state_init(struct ov8865_sensor *sensor)
2326 {
2327     return ov8865_state_configure(sensor, &ov8865_modes[0],
2328                       ov8865_mbus_codes[0]);
2329 }
2330 
2331 /* Sensor Base */
2332 
2333 static int ov8865_sensor_init(struct ov8865_sensor *sensor)
2334 {
2335     int ret;
2336 
2337     ret = ov8865_sw_reset(sensor);
2338     if (ret) {
2339         dev_err(sensor->dev, "failed to perform sw reset\n");
2340         return ret;
2341     }
2342 
2343     ret = ov8865_sw_standby(sensor, 1);
2344     if (ret) {
2345         dev_err(sensor->dev, "failed to set sensor standby\n");
2346         return ret;
2347     }
2348 
2349     ret = ov8865_chip_id_check(sensor);
2350     if (ret) {
2351         dev_err(sensor->dev, "failed to check sensor chip id\n");
2352         return ret;
2353     }
2354 
2355     ret = ov8865_write_sequence(sensor, ov8865_init_sequence,
2356                     ARRAY_SIZE(ov8865_init_sequence));
2357     if (ret) {
2358         dev_err(sensor->dev, "failed to write init sequence\n");
2359         return ret;
2360     }
2361 
2362     ret = ov8865_charge_pump_configure(sensor);
2363     if (ret) {
2364         dev_err(sensor->dev, "failed to configure pad\n");
2365         return ret;
2366     }
2367 
2368     ret = ov8865_mipi_configure(sensor);
2369     if (ret) {
2370         dev_err(sensor->dev, "failed to configure MIPI\n");
2371         return ret;
2372     }
2373 
2374     ret = ov8865_isp_configure(sensor);
2375     if (ret) {
2376         dev_err(sensor->dev, "failed to configure ISP\n");
2377         return ret;
2378     }
2379 
2380     ret = ov8865_black_level_configure(sensor);
2381     if (ret) {
2382         dev_err(sensor->dev, "failed to configure black level\n");
2383         return ret;
2384     }
2385 
2386     /* Configure current mode. */
2387     ret = ov8865_state_configure(sensor, sensor->state.mode,
2388                      sensor->state.mbus_code);
2389     if (ret) {
2390         dev_err(sensor->dev, "failed to configure state\n");
2391         return ret;
2392     }
2393 
2394     return 0;
2395 }
2396 
2397 static int ov8865_sensor_power(struct ov8865_sensor *sensor, bool on)
2398 {
2399     /* Keep initialized to zero for disable label. */
2400     int ret = 0;
2401 
2402     if (on) {
2403         gpiod_set_value_cansleep(sensor->reset, 1);
2404         gpiod_set_value_cansleep(sensor->powerdown, 1);
2405 
2406         ret = regulator_enable(sensor->dovdd);
2407         if (ret) {
2408             dev_err(sensor->dev,
2409                 "failed to enable DOVDD regulator\n");
2410             return ret;
2411         }
2412 
2413         ret = regulator_enable(sensor->avdd);
2414         if (ret) {
2415             dev_err(sensor->dev,
2416                 "failed to enable AVDD regulator\n");
2417             goto disable_dovdd;
2418         }
2419 
2420         ret = regulator_enable(sensor->dvdd);
2421         if (ret) {
2422             dev_err(sensor->dev,
2423                 "failed to enable DVDD regulator\n");
2424             goto disable_avdd;
2425         }
2426 
2427         ret = clk_prepare_enable(sensor->extclk);
2428         if (ret) {
2429             dev_err(sensor->dev, "failed to enable EXTCLK clock\n");
2430             goto disable_dvdd;
2431         }
2432 
2433         gpiod_set_value_cansleep(sensor->reset, 0);
2434         gpiod_set_value_cansleep(sensor->powerdown, 0);
2435 
2436         /* Time to enter streaming mode according to power timings. */
2437         usleep_range(10000, 12000);
2438     } else {
2439         gpiod_set_value_cansleep(sensor->powerdown, 1);
2440         gpiod_set_value_cansleep(sensor->reset, 1);
2441 
2442         clk_disable_unprepare(sensor->extclk);
2443 
2444 disable_dvdd:
2445         regulator_disable(sensor->dvdd);
2446 disable_avdd:
2447         regulator_disable(sensor->avdd);
2448 disable_dovdd:
2449         regulator_disable(sensor->dovdd);
2450     }
2451 
2452     return ret;
2453 }
2454 
2455 /* Controls */
2456 
2457 static int ov8865_s_ctrl(struct v4l2_ctrl *ctrl)
2458 {
2459     struct v4l2_subdev *subdev = ov8865_ctrl_subdev(ctrl);
2460     struct ov8865_sensor *sensor = ov8865_subdev_sensor(subdev);
2461     unsigned int index;
2462     int ret;
2463 
2464     /* If VBLANK is altered we need to update exposure to compensate */
2465     if (ctrl->id == V4L2_CID_VBLANK) {
2466         int exposure_max;
2467 
2468         exposure_max = sensor->state.mode->output_size_y + ctrl->val -
2469                    OV8865_INTEGRATION_TIME_MARGIN;
2470         __v4l2_ctrl_modify_range(sensor->ctrls.exposure,
2471                      sensor->ctrls.exposure->minimum,
2472                      exposure_max,
2473                      sensor->ctrls.exposure->step,
2474                      min(sensor->ctrls.exposure->val,
2475                          exposure_max));
2476     }
2477 
2478     /* Wait for the sensor to be on before setting controls. */
2479     if (pm_runtime_suspended(sensor->dev))
2480         return 0;
2481 
2482     switch (ctrl->id) {
2483     case V4L2_CID_EXPOSURE:
2484         ret = ov8865_exposure_configure(sensor, ctrl->val);
2485         if (ret)
2486             return ret;
2487         break;
2488     case V4L2_CID_ANALOGUE_GAIN:
2489         ret = ov8865_analog_gain_configure(sensor, ctrl->val);
2490         if (ret)
2491             return ret;
2492         break;
2493     case V4L2_CID_RED_BALANCE:
2494         return ov8865_red_balance_configure(sensor, ctrl->val);
2495     case V4L2_CID_BLUE_BALANCE:
2496         return ov8865_blue_balance_configure(sensor, ctrl->val);
2497     case V4L2_CID_HFLIP:
2498         return ov8865_flip_horz_configure(sensor, !!ctrl->val);
2499     case V4L2_CID_VFLIP:
2500         return ov8865_flip_vert_configure(sensor, !!ctrl->val);
2501     case V4L2_CID_TEST_PATTERN:
2502         index = (unsigned int)ctrl->val;
2503         return ov8865_test_pattern_configure(sensor, index);
2504     case V4L2_CID_VBLANK:
2505         return ov8865_vts_configure(sensor, ctrl->val);
2506     default:
2507         return -EINVAL;
2508     }
2509 
2510     return 0;
2511 }
2512 
2513 static const struct v4l2_ctrl_ops ov8865_ctrl_ops = {
2514     .s_ctrl         = ov8865_s_ctrl,
2515 };
2516 
2517 static int ov8865_ctrls_init(struct ov8865_sensor *sensor)
2518 {
2519     struct ov8865_ctrls *ctrls = &sensor->ctrls;
2520     struct v4l2_ctrl_handler *handler = &ctrls->handler;
2521     const struct v4l2_ctrl_ops *ops = &ov8865_ctrl_ops;
2522     const struct ov8865_mode *mode = &ov8865_modes[0];
2523     struct v4l2_fwnode_device_properties props;
2524     unsigned int vblank_max, vblank_def;
2525     unsigned int hblank;
2526     int ret;
2527 
2528     v4l2_ctrl_handler_init(handler, 32);
2529 
2530     /* Use our mutex for ctrl locking. */
2531     handler->lock = &sensor->mutex;
2532 
2533     /* Exposure */
2534 
2535     ctrls->exposure = v4l2_ctrl_new_std(handler, ops, V4L2_CID_EXPOSURE, 2,
2536                         65535, 1, 32);
2537 
2538     /* Gain */
2539 
2540     v4l2_ctrl_new_std(handler, ops, V4L2_CID_ANALOGUE_GAIN, 128, 2048, 128,
2541               128);
2542 
2543     /* White Balance */
2544 
2545     v4l2_ctrl_new_std(handler, ops, V4L2_CID_RED_BALANCE, 1, 32767, 1,
2546               1024);
2547 
2548     v4l2_ctrl_new_std(handler, ops, V4L2_CID_BLUE_BALANCE, 1, 32767, 1,
2549               1024);
2550 
2551     /* Flip */
2552 
2553     v4l2_ctrl_new_std(handler, ops, V4L2_CID_HFLIP, 0, 1, 1, 0);
2554     v4l2_ctrl_new_std(handler, ops, V4L2_CID_VFLIP, 0, 1, 1, 0);
2555 
2556     /* Test Pattern */
2557 
2558     v4l2_ctrl_new_std_menu_items(handler, ops, V4L2_CID_TEST_PATTERN,
2559                      ARRAY_SIZE(ov8865_test_pattern_menu) - 1,
2560                      0, 0, ov8865_test_pattern_menu);
2561 
2562     /* Blanking */
2563     hblank = mode->hts - mode->output_size_x;
2564     ctrls->hblank = v4l2_ctrl_new_std(handler, ops, V4L2_CID_HBLANK, hblank,
2565                       hblank, 1, hblank);
2566 
2567     if (ctrls->hblank)
2568         ctrls->hblank->flags |= V4L2_CTRL_FLAG_READ_ONLY;
2569 
2570     vblank_max = OV8865_TIMING_MAX_VTS - mode->output_size_y;
2571     vblank_def = mode->vts - mode->output_size_y;
2572     ctrls->vblank = v4l2_ctrl_new_std(handler, ops, V4L2_CID_VBLANK,
2573                       OV8865_TIMING_MIN_VTS, vblank_max, 1,
2574                       vblank_def);
2575 
2576     /* MIPI CSI-2 */
2577 
2578     ctrls->link_freq =
2579         v4l2_ctrl_new_int_menu(handler, NULL, V4L2_CID_LINK_FREQ,
2580                        ARRAY_SIZE(ov8865_link_freq_menu) - 1,
2581                        0, ov8865_link_freq_menu);
2582 
2583     ctrls->pixel_rate =
2584         v4l2_ctrl_new_std(handler, NULL, V4L2_CID_PIXEL_RATE, 1,
2585                   INT_MAX, 1, 1);
2586 
2587     /* set properties from fwnode (e.g. rotation, orientation) */
2588     ret = v4l2_fwnode_device_parse(sensor->dev, &props);
2589     if (ret)
2590         goto error_ctrls;
2591 
2592     ret = v4l2_ctrl_new_fwnode_properties(handler, ops, &props);
2593     if (ret)
2594         goto error_ctrls;
2595 
2596     if (handler->error) {
2597         ret = handler->error;
2598         goto error_ctrls;
2599     }
2600 
2601     ctrls->link_freq->flags |= V4L2_CTRL_FLAG_READ_ONLY;
2602     ctrls->pixel_rate->flags |= V4L2_CTRL_FLAG_READ_ONLY;
2603 
2604     sensor->subdev.ctrl_handler = handler;
2605 
2606     return 0;
2607 
2608 error_ctrls:
2609     v4l2_ctrl_handler_free(handler);
2610 
2611     return ret;
2612 }
2613 
2614 /* Subdev Video Operations */
2615 
2616 static int ov8865_s_stream(struct v4l2_subdev *subdev, int enable)
2617 {
2618     struct ov8865_sensor *sensor = ov8865_subdev_sensor(subdev);
2619     struct ov8865_state *state = &sensor->state;
2620     int ret;
2621 
2622     if (enable) {
2623         ret = pm_runtime_resume_and_get(sensor->dev);
2624         if (ret < 0)
2625             return ret;
2626     }
2627 
2628     mutex_lock(&sensor->mutex);
2629     ret = ov8865_sw_standby(sensor, !enable);
2630     mutex_unlock(&sensor->mutex);
2631 
2632     if (ret)
2633         return ret;
2634 
2635     state->streaming = !!enable;
2636 
2637     if (!enable)
2638         pm_runtime_put(sensor->dev);
2639 
2640     return 0;
2641 }
2642 
2643 static int ov8865_g_frame_interval(struct v4l2_subdev *subdev,
2644                    struct v4l2_subdev_frame_interval *interval)
2645 {
2646     struct ov8865_sensor *sensor = ov8865_subdev_sensor(subdev);
2647     const struct ov8865_mode *mode;
2648     unsigned int framesize;
2649     unsigned int fps;
2650 
2651     mutex_lock(&sensor->mutex);
2652 
2653     mode = sensor->state.mode;
2654     framesize = mode->hts * (mode->output_size_y +
2655                  sensor->ctrls.vblank->val);
2656     fps = DIV_ROUND_CLOSEST(sensor->ctrls.pixel_rate->val, framesize);
2657 
2658     interval->interval.numerator = 1;
2659     interval->interval.denominator = fps;
2660 
2661     mutex_unlock(&sensor->mutex);
2662 
2663     return 0;
2664 }
2665 
2666 static const struct v4l2_subdev_video_ops ov8865_subdev_video_ops = {
2667     .s_stream       = ov8865_s_stream,
2668     .g_frame_interval   = ov8865_g_frame_interval,
2669     .s_frame_interval   = ov8865_g_frame_interval,
2670 };
2671 
2672 /* Subdev Pad Operations */
2673 
2674 static int ov8865_enum_mbus_code(struct v4l2_subdev *subdev,
2675                  struct v4l2_subdev_state *sd_state,
2676                  struct v4l2_subdev_mbus_code_enum *code_enum)
2677 {
2678     if (code_enum->index >= ARRAY_SIZE(ov8865_mbus_codes))
2679         return -EINVAL;
2680 
2681     code_enum->code = ov8865_mbus_codes[code_enum->index];
2682 
2683     return 0;
2684 }
2685 
2686 static void ov8865_mbus_format_fill(struct v4l2_mbus_framefmt *mbus_format,
2687                     u32 mbus_code,
2688                     const struct ov8865_mode *mode)
2689 {
2690     mbus_format->width = mode->output_size_x;
2691     mbus_format->height = mode->output_size_y;
2692     mbus_format->code = mbus_code;
2693 
2694     mbus_format->field = V4L2_FIELD_NONE;
2695     mbus_format->colorspace = V4L2_COLORSPACE_RAW;
2696     mbus_format->ycbcr_enc =
2697         V4L2_MAP_YCBCR_ENC_DEFAULT(mbus_format->colorspace);
2698     mbus_format->quantization = V4L2_QUANTIZATION_FULL_RANGE;
2699     mbus_format->xfer_func =
2700         V4L2_MAP_XFER_FUNC_DEFAULT(mbus_format->colorspace);
2701 }
2702 
2703 static int ov8865_get_fmt(struct v4l2_subdev *subdev,
2704               struct v4l2_subdev_state *sd_state,
2705               struct v4l2_subdev_format *format)
2706 {
2707     struct ov8865_sensor *sensor = ov8865_subdev_sensor(subdev);
2708     struct v4l2_mbus_framefmt *mbus_format = &format->format;
2709 
2710     mutex_lock(&sensor->mutex);
2711 
2712     if (format->which == V4L2_SUBDEV_FORMAT_TRY)
2713         *mbus_format = *v4l2_subdev_get_try_format(subdev, sd_state,
2714                                format->pad);
2715     else
2716         ov8865_mbus_format_fill(mbus_format, sensor->state.mbus_code,
2717                     sensor->state.mode);
2718 
2719     mutex_unlock(&sensor->mutex);
2720 
2721     return 0;
2722 }
2723 
2724 static int ov8865_set_fmt(struct v4l2_subdev *subdev,
2725               struct v4l2_subdev_state *sd_state,
2726               struct v4l2_subdev_format *format)
2727 {
2728     struct ov8865_sensor *sensor = ov8865_subdev_sensor(subdev);
2729     struct v4l2_mbus_framefmt *mbus_format = &format->format;
2730     const struct ov8865_mode *mode;
2731     u32 mbus_code = 0;
2732     unsigned int hblank;
2733     unsigned int index;
2734     int exposure_max;
2735     int ret = 0;
2736 
2737     mutex_lock(&sensor->mutex);
2738 
2739     if (sensor->state.streaming) {
2740         ret = -EBUSY;
2741         goto complete;
2742     }
2743 
2744     /* Try to find requested mbus code. */
2745     for (index = 0; index < ARRAY_SIZE(ov8865_mbus_codes); index++) {
2746         if (ov8865_mbus_codes[index] == mbus_format->code) {
2747             mbus_code = mbus_format->code;
2748             break;
2749         }
2750     }
2751 
2752     /* Fallback to default. */
2753     if (!mbus_code)
2754         mbus_code = ov8865_mbus_codes[0];
2755 
2756     /* Find the mode with nearest dimensions. */
2757     mode = v4l2_find_nearest_size(ov8865_modes, ARRAY_SIZE(ov8865_modes),
2758                       output_size_x, output_size_y,
2759                       mbus_format->width, mbus_format->height);
2760     if (!mode) {
2761         ret = -EINVAL;
2762         goto complete;
2763     }
2764 
2765     ov8865_mbus_format_fill(mbus_format, mbus_code, mode);
2766 
2767     if (format->which == V4L2_SUBDEV_FORMAT_TRY)
2768         *v4l2_subdev_get_try_format(subdev, sd_state, format->pad) =
2769             *mbus_format;
2770     else if (sensor->state.mode != mode ||
2771          sensor->state.mbus_code != mbus_code)
2772         ret = ov8865_state_configure(sensor, mode, mbus_code);
2773 
2774     __v4l2_ctrl_modify_range(sensor->ctrls.vblank, OV8865_TIMING_MIN_VTS,
2775                  OV8865_TIMING_MAX_VTS - mode->output_size_y,
2776                  1, mode->vts - mode->output_size_y);
2777 
2778     hblank = mode->hts - mode->output_size_x;
2779     __v4l2_ctrl_modify_range(sensor->ctrls.hblank, hblank, hblank, 1,
2780                  hblank);
2781 
2782     exposure_max = mode->vts - OV8865_INTEGRATION_TIME_MARGIN;
2783     __v4l2_ctrl_modify_range(sensor->ctrls.exposure,
2784                  sensor->ctrls.exposure->minimum, exposure_max,
2785                  sensor->ctrls.exposure->step,
2786                  min(sensor->ctrls.exposure->val,
2787                      exposure_max));
2788 
2789 complete:
2790     mutex_unlock(&sensor->mutex);
2791 
2792     return ret;
2793 }
2794 
2795 static int ov8865_enum_frame_size(struct v4l2_subdev *subdev,
2796                   struct v4l2_subdev_state *sd_state,
2797                   struct v4l2_subdev_frame_size_enum *size_enum)
2798 {
2799     const struct ov8865_mode *mode;
2800 
2801     if (size_enum->index >= ARRAY_SIZE(ov8865_modes))
2802         return -EINVAL;
2803 
2804     mode = &ov8865_modes[size_enum->index];
2805 
2806     size_enum->min_width = size_enum->max_width = mode->output_size_x;
2807     size_enum->min_height = size_enum->max_height = mode->output_size_y;
2808 
2809     return 0;
2810 }
2811 
2812 static void
2813 __ov8865_get_pad_crop(struct ov8865_sensor *sensor,
2814               struct v4l2_subdev_state *state, unsigned int pad,
2815               enum v4l2_subdev_format_whence which, struct v4l2_rect *r)
2816 {
2817     const struct ov8865_mode *mode = sensor->state.mode;
2818 
2819     switch (which) {
2820     case V4L2_SUBDEV_FORMAT_TRY:
2821         *r = *v4l2_subdev_get_try_crop(&sensor->subdev, state, pad);
2822         break;
2823     case V4L2_SUBDEV_FORMAT_ACTIVE:
2824         r->height = mode->output_size_y;
2825         r->width = mode->output_size_x;
2826         r->top = (OV8865_NATIVE_HEIGHT - mode->output_size_y) / 2;
2827         r->left = (OV8865_NATIVE_WIDTH - mode->output_size_x) / 2;
2828         break;
2829     }
2830 }
2831 
2832 static int ov8865_get_selection(struct v4l2_subdev *subdev,
2833                 struct v4l2_subdev_state *state,
2834                 struct v4l2_subdev_selection *sel)
2835 {
2836     struct ov8865_sensor *sensor = ov8865_subdev_sensor(subdev);
2837 
2838     switch (sel->target) {
2839     case V4L2_SEL_TGT_CROP:
2840         mutex_lock(&sensor->mutex);
2841         __ov8865_get_pad_crop(sensor, state, sel->pad,
2842                       sel->which, &sel->r);
2843         mutex_unlock(&sensor->mutex);
2844         break;
2845     case V4L2_SEL_TGT_NATIVE_SIZE:
2846         sel->r.top = 0;
2847         sel->r.left = 0;
2848         sel->r.width = OV8865_NATIVE_WIDTH;
2849         sel->r.height = OV8865_NATIVE_HEIGHT;
2850         break;
2851     case V4L2_SEL_TGT_CROP_BOUNDS:
2852     case V4L2_SEL_TGT_CROP_DEFAULT:
2853         sel->r.top = OV8865_ACTIVE_START_TOP;
2854         sel->r.left = OV8865_ACTIVE_START_LEFT;
2855         sel->r.width = OV8865_ACTIVE_WIDTH;
2856         sel->r.height = OV8865_ACTIVE_HEIGHT;
2857         break;
2858     default:
2859         return -EINVAL;
2860     }
2861 
2862     return 0;
2863 }
2864 
2865 static const struct v4l2_subdev_pad_ops ov8865_subdev_pad_ops = {
2866     .enum_mbus_code     = ov8865_enum_mbus_code,
2867     .get_fmt        = ov8865_get_fmt,
2868     .set_fmt        = ov8865_set_fmt,
2869     .enum_frame_size    = ov8865_enum_frame_size,
2870     .get_selection      = ov8865_get_selection,
2871     .set_selection      = ov8865_get_selection,
2872 };
2873 
2874 static const struct v4l2_subdev_ops ov8865_subdev_ops = {
2875     .video      = &ov8865_subdev_video_ops,
2876     .pad        = &ov8865_subdev_pad_ops,
2877 };
2878 
2879 static int ov8865_suspend(struct device *dev)
2880 {
2881     struct i2c_client *client = to_i2c_client(dev);
2882     struct v4l2_subdev *subdev = i2c_get_clientdata(client);
2883     struct ov8865_sensor *sensor = ov8865_subdev_sensor(subdev);
2884     struct ov8865_state *state = &sensor->state;
2885     int ret = 0;
2886 
2887     mutex_lock(&sensor->mutex);
2888 
2889     if (state->streaming) {
2890         ret = ov8865_sw_standby(sensor, true);
2891         if (ret)
2892             goto complete;
2893     }
2894 
2895     ret = ov8865_sensor_power(sensor, false);
2896     if (ret)
2897         ov8865_sw_standby(sensor, false);
2898 
2899 complete:
2900     mutex_unlock(&sensor->mutex);
2901 
2902     return ret;
2903 }
2904 
2905 static int ov8865_resume(struct device *dev)
2906 {
2907     struct i2c_client *client = to_i2c_client(dev);
2908     struct v4l2_subdev *subdev = i2c_get_clientdata(client);
2909     struct ov8865_sensor *sensor = ov8865_subdev_sensor(subdev);
2910     struct ov8865_state *state = &sensor->state;
2911     int ret = 0;
2912 
2913     mutex_lock(&sensor->mutex);
2914 
2915     ret = ov8865_sensor_power(sensor, true);
2916     if (ret)
2917         goto complete;
2918 
2919     ret = ov8865_sensor_init(sensor);
2920     if (ret)
2921         goto error_power;
2922 
2923     ret = __v4l2_ctrl_handler_setup(&sensor->ctrls.handler);
2924     if (ret)
2925         goto error_power;
2926 
2927     if (state->streaming) {
2928         ret = ov8865_sw_standby(sensor, false);
2929         if (ret)
2930             goto error_power;
2931     }
2932 
2933     goto complete;
2934 
2935 error_power:
2936     ov8865_sensor_power(sensor, false);
2937 
2938 complete:
2939     mutex_unlock(&sensor->mutex);
2940 
2941     return ret;
2942 }
2943 
2944 static int ov8865_probe(struct i2c_client *client)
2945 {
2946     struct device *dev = &client->dev;
2947     struct fwnode_handle *handle;
2948     struct ov8865_sensor *sensor;
2949     struct v4l2_subdev *subdev;
2950     struct media_pad *pad;
2951     unsigned int rate = 0;
2952     unsigned int i;
2953     int ret;
2954 
2955     sensor = devm_kzalloc(dev, sizeof(*sensor), GFP_KERNEL);
2956     if (!sensor)
2957         return -ENOMEM;
2958 
2959     sensor->dev = dev;
2960     sensor->i2c_client = client;
2961 
2962     /* Regulators */
2963 
2964     /* DVDD: digital core */
2965     sensor->dvdd = devm_regulator_get(dev, "dvdd");
2966     if (IS_ERR(sensor->dvdd))
2967         return dev_err_probe(dev, PTR_ERR(sensor->dvdd),
2968                      "cannot get DVDD regulator\n");
2969 
2970     /* DOVDD: digital I/O */
2971     sensor->dovdd = devm_regulator_get(dev, "dovdd");
2972     if (IS_ERR(sensor->dovdd))
2973         return dev_err_probe(dev, PTR_ERR(sensor->dovdd),
2974                      "cannot get DOVDD regulator\n");
2975 
2976     /* AVDD: analog */
2977     sensor->avdd = devm_regulator_get(dev, "avdd");
2978     if (IS_ERR(sensor->avdd))
2979         return dev_err_probe(dev, PTR_ERR(sensor->avdd),
2980                      "cannot get AVDD (analog) regulator\n");
2981 
2982     /* Graph Endpoint */
2983 
2984     handle = fwnode_graph_get_next_endpoint(dev_fwnode(dev), NULL);
2985     if (!handle)
2986         return -EPROBE_DEFER;
2987 
2988     sensor->endpoint.bus_type = V4L2_MBUS_CSI2_DPHY;
2989 
2990     ret = v4l2_fwnode_endpoint_alloc_parse(handle, &sensor->endpoint);
2991     fwnode_handle_put(handle);
2992     if (ret) {
2993         dev_err(dev, "failed to parse endpoint node\n");
2994         return ret;
2995     }
2996 
2997     /* GPIOs */
2998 
2999     sensor->powerdown = devm_gpiod_get_optional(dev, "powerdown",
3000                             GPIOD_OUT_HIGH);
3001     if (IS_ERR(sensor->powerdown)) {
3002         ret = PTR_ERR(sensor->powerdown);
3003         goto error_endpoint;
3004     }
3005 
3006     sensor->reset = devm_gpiod_get_optional(dev, "reset", GPIOD_OUT_HIGH);
3007     if (IS_ERR(sensor->reset)) {
3008         ret = PTR_ERR(sensor->reset);
3009         goto error_endpoint;
3010     }
3011 
3012     /* External Clock */
3013 
3014     sensor->extclk = devm_clk_get(dev, NULL);
3015     if (PTR_ERR(sensor->extclk) == -ENOENT) {
3016         dev_info(dev, "no external clock found, continuing...\n");
3017         sensor->extclk = NULL;
3018     } else if (IS_ERR(sensor->extclk)) {
3019         dev_err(dev, "failed to get external clock\n");
3020         ret = PTR_ERR(sensor->extclk);
3021         goto error_endpoint;
3022     }
3023 
3024     /*
3025      * We could have either a 24MHz or 19.2MHz clock rate from either dt or
3026      * ACPI...but we also need to support the weird IPU3 case which will
3027      * have an external clock AND a clock-frequency property. Check for the
3028      * clock-frequency property and if found, set that rate if we managed
3029      * to acquire a clock. This should cover the ACPI case. If the system
3030      * uses devicetree then the configured rate should already be set, so
3031      * we can just read it.
3032      */
3033     ret = fwnode_property_read_u32(dev_fwnode(dev), "clock-frequency",
3034                        &rate);
3035     if (!ret && sensor->extclk) {
3036         ret = clk_set_rate(sensor->extclk, rate);
3037         if (ret)
3038             return dev_err_probe(dev, ret,
3039                          "failed to set clock rate\n");
3040     } else if (ret && !sensor->extclk) {
3041         return dev_err_probe(dev, ret, "invalid clock config\n");
3042     }
3043 
3044     sensor->extclk_rate = rate ? rate : clk_get_rate(sensor->extclk);
3045 
3046     for (i = 0; i < ARRAY_SIZE(supported_extclk_rates); i++) {
3047         if (sensor->extclk_rate == supported_extclk_rates[i])
3048             break;
3049     }
3050 
3051     if (i == ARRAY_SIZE(supported_extclk_rates)) {
3052         dev_err(dev, "clock rate %lu Hz is unsupported\n",
3053             sensor->extclk_rate);
3054         ret = -EINVAL;
3055         goto error_endpoint;
3056     }
3057 
3058     sensor->pll_configs = ov8865_pll_configs[i];
3059 
3060     /* Subdev, entity and pad */
3061 
3062     subdev = &sensor->subdev;
3063     v4l2_i2c_subdev_init(subdev, client, &ov8865_subdev_ops);
3064 
3065     subdev->flags |= V4L2_SUBDEV_FL_HAS_DEVNODE;
3066     subdev->entity.function = MEDIA_ENT_F_CAM_SENSOR;
3067 
3068     pad = &sensor->pad;
3069     pad->flags = MEDIA_PAD_FL_SOURCE;
3070 
3071     ret = media_entity_pads_init(&subdev->entity, 1, pad);
3072     if (ret)
3073         goto error_entity;
3074 
3075     /* Mutex */
3076 
3077     mutex_init(&sensor->mutex);
3078 
3079     /* Sensor */
3080 
3081     ret = ov8865_ctrls_init(sensor);
3082     if (ret)
3083         goto error_mutex;
3084 
3085     mutex_lock(&sensor->mutex);
3086     ret = ov8865_state_init(sensor);
3087     mutex_unlock(&sensor->mutex);
3088     if (ret)
3089         goto error_ctrls;
3090 
3091     /* Runtime PM */
3092 
3093     pm_runtime_set_suspended(sensor->dev);
3094     pm_runtime_enable(sensor->dev);
3095 
3096     /* V4L2 subdev register */
3097 
3098     ret = v4l2_async_register_subdev_sensor(subdev);
3099     if (ret)
3100         goto error_pm;
3101 
3102     return 0;
3103 
3104 error_pm:
3105     pm_runtime_disable(sensor->dev);
3106 
3107 error_ctrls:
3108     v4l2_ctrl_handler_free(&sensor->ctrls.handler);
3109 
3110 error_mutex:
3111     mutex_destroy(&sensor->mutex);
3112 
3113 error_entity:
3114     media_entity_cleanup(&sensor->subdev.entity);
3115 
3116 error_endpoint:
3117     v4l2_fwnode_endpoint_free(&sensor->endpoint);
3118 
3119     return ret;
3120 }
3121 
3122 static int ov8865_remove(struct i2c_client *client)
3123 {
3124     struct v4l2_subdev *subdev = i2c_get_clientdata(client);
3125     struct ov8865_sensor *sensor = ov8865_subdev_sensor(subdev);
3126 
3127     v4l2_async_unregister_subdev(subdev);
3128     pm_runtime_disable(sensor->dev);
3129     v4l2_ctrl_handler_free(&sensor->ctrls.handler);
3130     mutex_destroy(&sensor->mutex);
3131     media_entity_cleanup(&subdev->entity);
3132 
3133     v4l2_fwnode_endpoint_free(&sensor->endpoint);
3134 
3135     return 0;
3136 }
3137 
3138 static const struct dev_pm_ops ov8865_pm_ops = {
3139     SET_RUNTIME_PM_OPS(ov8865_suspend, ov8865_resume, NULL)
3140 };
3141 
3142 static const struct acpi_device_id ov8865_acpi_match[] = {
3143     {"INT347A"},
3144     { }
3145 };
3146 MODULE_DEVICE_TABLE(acpi, ov8865_acpi_match);
3147 
3148 static const struct of_device_id ov8865_of_match[] = {
3149     { .compatible = "ovti,ov8865" },
3150     { }
3151 };
3152 MODULE_DEVICE_TABLE(of, ov8865_of_match);
3153 
3154 static struct i2c_driver ov8865_driver = {
3155     .driver = {
3156         .name = "ov8865",
3157         .of_match_table = ov8865_of_match,
3158         .acpi_match_table = ov8865_acpi_match,
3159         .pm = &ov8865_pm_ops,
3160     },
3161     .probe_new = ov8865_probe,
3162     .remove  = ov8865_remove,
3163 };
3164 
3165 module_i2c_driver(ov8865_driver);
3166 
3167 MODULE_AUTHOR("Paul Kocialkowski <paul.kocialkowski@bootlin.com>");
3168 MODULE_DESCRIPTION("V4L2 driver for the OmniVision OV8865 image sensor");
3169 MODULE_LICENSE("GPL v2");