From: Peter Marshall <pm@petermarshall.ca>
To: Sakari Ailus <sakari.ailus@linux.intel.com>,
Mauro Carvalho Chehab <mchehab@kernel.org>,
Benjamin Mugnier <benjamin.mugnier@foss.st.com>,
Sylvain Petinot <sylvain.petinot@foss.st.com>
Cc: linux-kernel@vger.kernel.org, devicetree@vger.kernel.org,
linux-media@vger.kernel.org, platform-driver-x86@vger.kernel.org,
Peter Marshall <pm@petermarshall.ca>
Subject: [PATCH 5/7] media: i2c: st-vd55g: Add generic driver and VD55G0 support
Date: Wed, 2 Sep 2026 16:45:44 -0400 [thread overview]
Message-ID: <20260902204549.657228-6-pm@petermarshall.ca> (raw)
In-Reply-To: <20260902204549.657228-1-pm@petermarshall.ca>
Rewrite the existing vd55g1 module supporting ST VD55G1 and VD65G4 to
make it generic for ST VD55G family global-shutter camera sensors.
Registers and supported features differ between sensor generations.
Replace the static register addresses and revision-specific branches
with a per-chip info struct.
Add support for the VD55G0 monochrome camera sensor. The VD55G0 has
a native resolution of 644 x 604 pixels and does not support HDR via
internal subtraction.
Add a quirk limiting exposure duty cycle with strobe illumination
enabled to avoid tripping overcurrent protection.
Special thanks to GitHub user @femito1 (Fernando Rimoli) for testing and helping
with bug fixes.
Signed-off-by: Peter Marshall <pm@petermarshall.ca>
---
drivers/media/i2c/Kconfig | 11 +
drivers/media/i2c/Makefile | 1 +
drivers/media/i2c/vd55g.c | 2166 ++++++++++++++++++++++++++++++++++++
3 files changed, 2178 insertions(+)
create mode 100644 drivers/media/i2c/vd55g.c
diff --git a/drivers/media/i2c/Kconfig b/drivers/media/i2c/Kconfig
index 5d173e0ec..b2a39ff4b 100644
--- a/drivers/media/i2c/Kconfig
+++ b/drivers/media/i2c/Kconfig
@@ -815,6 +815,17 @@ config VIDEO_T4KA3
To compile this driver as a module, choose M here: the
module will be called t4ka3.
+config VIDEO_VD55G
+ tristate "ST VD55G family sensor support"
+ select V4L2_CCI_I2C
+ depends on GPIOLIB
+ help
+ This is a Video4Linux2 sensor driver for the ST VD55G family
+ of camera sensors.
+
+ To compile this driver as a module, choose M here: the
+ module will be called vd55g.
+
config VIDEO_VD55G1
tristate "ST VD55G1 sensor support"
select V4L2_CCI_I2C
diff --git a/drivers/media/i2c/Makefile b/drivers/media/i2c/Makefile
index e45359efe..d87b64893 100644
--- a/drivers/media/i2c/Makefile
+++ b/drivers/media/i2c/Makefile
@@ -164,6 +164,7 @@ obj-$(CONFIG_VIDEO_TW9910) += tw9910.o
obj-$(CONFIG_VIDEO_UDA1342) += uda1342.o
obj-$(CONFIG_VIDEO_UPD64031A) += upd64031a.o
obj-$(CONFIG_VIDEO_UPD64083) += upd64083.o
+obj-$(CONFIG_VIDEO_VD55G) += vd55g.o
obj-$(CONFIG_VIDEO_VD55G1) += vd55g1.o
obj-$(CONFIG_VIDEO_VD56G3) += vd56g3.o
obj-$(CONFIG_VIDEO_VGXY61) += vgxy61.o
diff --git a/drivers/media/i2c/vd55g.c b/drivers/media/i2c/vd55g.c
new file mode 100644
index 000000000..627e2d31f
--- /dev/null
+++ b/drivers/media/i2c/vd55g.c
@@ -0,0 +1,2166 @@
+// SPDX-License-Identifier: GPL-2.0
+/*
+ * Driver for VD55G family global shutter sensors
+ *
+ * Copyright (C) 2025 STMicroelectronics SA
+ */
+
+#include <linux/clk.h>
+#include <linux/delay.h>
+#include <linux/gpio/consumer.h>
+#include <linux/i2c.h>
+#include <linux/iopoll.h>
+#include <linux/module.h>
+#include <linux/pm_runtime.h>
+#include <linux/property.h>
+#include <linux/regmap.h>
+#include <linux/regulator/consumer.h>
+#include <linux/unaligned.h>
+#include <linux/units.h>
+#include <linux/firmware.h>
+
+#include <media/mipi-csi2.h>
+#include <media/v4l2-async.h>
+#include <media/v4l2-cci.h>
+#include <media/v4l2-ctrls.h>
+#include <media/v4l2-device.h>
+#include <media/v4l2-event.h>
+#include <media/v4l2-fwnode.h>
+#include <media/v4l2-subdev.h>
+
+/* Register Map */
+#define VD55G_REG_MODEL_ID CCI_REG32_LE(0x0000)
+#define VD55G_REG_REVISION CCI_REG16_LE(0x0004)
+#define VD55G_REG_FWPATCH_START_ADDR CCI_REG8(0x2000)
+#define VD55G_SYSTEM_FSM_READY_TO_BOOT 0x01
+#define VD55G_SYSTEM_FSM_SW_STBY 0x02
+#define VD55G_SYSTEM_FSM_STREAMING 0x03
+#define VD55G_REG_BOOT CCI_REG8(0x0200)
+#define VD55G_BOOT_BOOT 1
+#define VD55G_BOOT_PATCH 2
+#define VD55G_REG_STBY CCI_REG8(0x0201)
+#define VD55G_STBY_START_STREAM 1
+#define VD55G_REG_STREAMING CCI_REG8(0x0202)
+#define VD55G_STREAMING_STOP_STREAM 1
+#define VD55G_REG_EXT_CLOCK CCI_REG32_LE(0x0220)
+#define VD55G_REG_LINE_LENGTH CCI_REG16_LE(0x0300)
+#define VD55G_REG_ORIENTATION CCI_REG8(0x0302)
+#define VD55G_REG_FORMAT_CTRL CCI_REG8(0x030a)
+#define VD55G_REG_OIF_CTRL CCI_REG16_LE(0x030c)
+#define VD55G_REG_OIF_IMG_CTRL CCI_REG8(0x030f)
+#define VD55G_REG_MIPI_DATA_RATE CCI_REG32_LE(0x0224)
+#define VD55G_PATGEN_TYPE_SHIFT 4
+#define VD55G_PATGEN_ENABLE BIT(0)
+#define VD55G_READOUT_CTRL_BIN_MODE_NORMAL 0
+#define VD55G_READOUT_CTRL_BIN_MODE_DIGITAL_X2 1
+#define VD55G_DUSTER_ENABLE BIT(0)
+#define VD55G_DUSTER_DISABLE 0
+#define VD55G_DUSTER_DYN_ENABLE BIT(1)
+#define VD55G_DUSTER_RING_ENABLE BIT(4)
+#define VD55G1_EXPOSURE_USE_CASES_MULTI_CONTEXT BIT(2)
+#define VD55G1_EXPOSURE_MAX_COARSE_SUB 446
+
+#define VD55G_REG_EXP_MODE(sensor, ctx) \
+ CCI_REG8(vd55g_get_ctx_addr(sensor, REG_CTX_EXP_MODE, ctx))
+#define VD55G_REG_FRAME_LENGTH(sensor, ctx) \
+ CCI_REG32_LE(vd55g_get_ctx_addr(sensor, REG_CTX_FRAME_LENGTH, ctx))
+#define VD55G_REG_X_START(sensor, ctx) \
+ CCI_REG16_LE(vd55g_get_ctx_addr(sensor, REG_CTX_X_START, ctx))
+#define VD55G_REG_X_WIDTH_OR_END(sensor, ctx) \
+ CCI_REG16_LE(vd55g_get_ctx_addr(sensor, REG_CTX_X_WIDTH_OR_END, ctx))
+#define VD55G_REG_Y_START(sensor, ctx) \
+ CCI_REG16_LE(vd55g_get_ctx_addr(sensor, REG_CTX_Y_START, ctx))
+#define VD55G_REG_Y_HEIGHT_OR_END(sensor, ctx) \
+ CCI_REG16_LE(vd55g_get_ctx_addr(sensor, REG_CTX_Y_HEIGHT_OR_END, ctx))
+#define VD55G_REG_GPIO_CTRL(sensor, ctx, led) \
+ CCI_REG8(vd55g_get_ctx_addr(sensor, REG_CTX_GPIO_0_CTRL, ctx) + (led))
+#define VD55G_GPIO_MODE_IN 0x01
+#define VD55G_GPIO_MODE_STROBE 0x02
+#define VD55G_REG_VT_MODE(sensor, ctx) \
+ CCI_REG8(vd55g_get_ctx_addr(sensor, REG_CTX_VT_MODE, ctx))
+#define VD55G1_VT_MODE_NORMAL 0
+#define VD55G1_VT_MODE_SUBTRACTION 1
+#define VD55G_REG_MASK_FRAME_CTRL(sensor, ctx) \
+ CCI_REG8(vd55g_get_ctx_addr(sensor, REG_CTX_MASK_FRAME_CTRL, ctx))
+#define VD55G1_MASK_FRAME_CTRL_OUTPUT 0
+#define VD55G1_MASK_FRAME_CTRL_MASK 1
+#define VD55G_REG_EXPOSURE_INSTANCE(sensor, ctx) \
+ CCI_REG32_LE(vd55g_get_ctx_addr(sensor, REG_CTX_EXPOSURE_INSTANCE, ctx))
+
+#define VD55G0_WIDTH 644
+#define VD55G0_HEIGHT 604
+#define VD55G1_WIDTH 804
+#define VD55G1_HEIGHT 704
+#define VD55G_MODE_DEF 0
+#define VD55G_NB_GPIOS 4
+#define VD55G_MBUS_CODE_DEF 0
+#define VD55G_DGAIN_DEF 256
+#define VD55G_AGAIN_DEF 19
+#define VD55G_EXPO_MAX_TERM 64
+#define VD55G_EXPO_DEF 500
+#define VD55G_LINE_LENGTH_MIN 1200
+#define VD55G1_LINE_LENGTH_SUB_MIN 1344
+#define VD55G_VBLANK_MIN 86
+#define VD55G_VBLANK_MAX 0xffff
+#define VD55G_FRAME_LENGTH_DEF 1860 /* 60 fps */
+#define VD55G_MIPI_MARGIN 900
+#define VD55G_XCLK_FREQ_MIN (6 * HZ_PER_MHZ)
+#define VD55G_XCLK_FREQ_MAX (27 * HZ_PER_MHZ)
+#define VD55G1_MIPI_RATE_MIN (250 * MEGA)
+#define VD55G1_MIPI_RATE_MAX (1200 * MEGA)
+#define VD55G0_MIPI_RATE_MIN (750 * MEGA)
+#define VD55G0_MIPI_RATE_MAX (1200 * MEGA)
+
+static const char *const vd55g_tp_menu[] = {
+ "Disabled",
+ "Diagonal Grey Scale",
+ "Pseudo-random Noise",
+};
+
+static const s64 vd55g_ev_bias_menu[] = {
+ -3000, -2500, -2000, -1500, -1000, -500, 0,
+ 500, 1000, 1500, 2000, 2500, 3000,
+};
+
+static const char *const vd55g1_hdr_menu[] = {
+ "No HDR",
+ /*
+ * This mode acquires 2 frames on the sensor, the first one is ditched
+ * out and only used for auto exposure data, the second one is output to
+ * the host
+ */
+ "Internal subtraction",
+};
+
+static const char *const vd55g_supply_name[] = {
+ "vcore",
+ "vddio",
+ "vana",
+};
+
+enum vd55g1_hdr_mode {
+ VD55G1_NO_HDR,
+ VD55G1_HDR_SUB,
+};
+
+struct vd55g_mode {
+ u32 width;
+ u32 height;
+};
+
+static const u32 vd55g_mbus_formats_mono[] = {
+ MEDIA_BUS_FMT_Y8_1X8,
+ MEDIA_BUS_FMT_Y10_1X10,
+};
+
+/* Format order is : no flip, hflip, vflip, both */
+static const u32 vd55g_mbus_formats_bayer[][4] = {
+ {
+ MEDIA_BUS_FMT_SRGGB8_1X8,
+ MEDIA_BUS_FMT_SGRBG8_1X8,
+ MEDIA_BUS_FMT_SGBRG8_1X8,
+ MEDIA_BUS_FMT_SBGGR8_1X8,
+ },
+ {
+ MEDIA_BUS_FMT_SRGGB10_1X10,
+ MEDIA_BUS_FMT_SGRBG10_1X10,
+ MEDIA_BUS_FMT_SGBRG10_1X10,
+ MEDIA_BUS_FMT_SBGGR10_1X10,
+ },
+};
+
+static const struct vd55g_mode vd55g0_supported_modes[] = {
+ {
+ .width = VD55G0_WIDTH,
+ .height = VD55G0_HEIGHT,
+ },
+ {
+ .width = 640,
+ .height = 600,
+ },
+ {
+ .width = 640,
+ .height = 480,
+ },
+ {
+ .width = 320,
+ .height = 240,
+ },
+};
+
+static const struct vd55g_mode vd55g1_supported_modes[] = {
+ {
+ .width = VD55G1_WIDTH,
+ .height = VD55G1_HEIGHT,
+ },
+ {
+ .width = 800,
+ .height = VD55G1_HEIGHT,
+ },
+ {
+ .width = 800,
+ .height = 600,
+ },
+ {
+ .width = 640,
+ .height = 480,
+ },
+ {
+ .width = 320,
+ .height = 240,
+ },
+};
+
+enum vd55g_expo_state {
+ VD55G1_EXP_AUTO,
+ VD55G1_EXP_FREEZE,
+ VD55G1_EXP_MANUAL,
+ VD55G1_EXP_SINGLE_STEP,
+ VD55G1_EXP_BYPASS,
+};
+
+struct vd55g_vblank_limits {
+ u16 min;
+ u16 def;
+ u16 max;
+};
+
+struct vd55g_frame_timings {
+ u16 frame_length;
+ u16 expo_max;
+};
+
+enum vd55g_reg_id {
+ REG_SYSTEM_FSM,
+ REG_ISL_ENABLE,
+ REG_FWPATCH_REVISION,
+ REG_PATGEN_CTRL,
+ REG_READOUT_CTRL,
+ REG_DUSTER_CTRL,
+ REG_AE_TARGET_PERCENTAGE,
+ REG_MANUAL_ANALOG_GAIN,
+ REG_MANUAL_COARSE_EXPOSURE,
+ REG_MANUAL_DIGITAL_GAIN,
+ REG_APPLIED_COARSE_EXPOSURE,
+ REG_APPLIED_ANALOG_GAIN,
+ REG_APPLIED_DIGITAL_GAIN,
+ REG_AE_FORCE_COLDSTART,
+ REG_AE_COLDSTART_EXPOSURE_US,
+ REG_AE_COLDSTART_COARSE_EXPOSURE,
+ /* HDR-specific */
+ REG_NEXT_CTX,
+ REG_EXPOSURE_USE_CASES,
+ REG_EXPOSURE_MAX_COARSE,
+ REG_CTX_REPEAT_COUNT_CTX0,
+ REG_CTX_REPEAT_COUNT_CTX1,
+
+ /* Context-specific register bases */
+ REG_CTX_STRIDE, /* Not a real register, stores the context bank offset */
+ REG_CTX_REPEAT_COUNT,
+ REG_CTX_EXP_MODE,
+ REG_CTX_FRAME_LENGTH,
+ REG_CTX_X_START,
+ REG_CTX_X_WIDTH_OR_END,
+ REG_CTX_Y_START,
+ REG_CTX_Y_HEIGHT_OR_END,
+ REG_CTX_GPIO_0_CTRL,
+ /* HDR-specific */
+ REG_CTX_VT_MODE,
+ REG_CTX_MASK_FRAME_CTRL,
+ REG_CTX_EXPOSURE_INSTANCE,
+
+ REG_MAX_INDEX /* Keeps track of enum size */
+};
+
+static const int vd55g0_reg_map[REG_MAX_INDEX] = {
+ [REG_SYSTEM_FSM] = CCI_REG8(0x002c),
+ [REG_ISL_ENABLE] = CCI_REG8(0x0329),
+ [REG_FWPATCH_REVISION] = CCI_REG16_LE(0x0022),
+ [REG_PATGEN_CTRL] = CCI_REG16_LE(0x0400),
+ [REG_READOUT_CTRL] = CCI_REG8(0x047a),
+ [REG_DUSTER_CTRL] = CCI_REG8(0x0316),
+ [REG_AE_TARGET_PERCENTAGE] = CCI_REG8(0x0440),
+ [REG_MANUAL_ANALOG_GAIN] = CCI_REG8(0x044d),
+ [REG_MANUAL_COARSE_EXPOSURE] = CCI_REG16_LE(0x044e),
+ [REG_MANUAL_DIGITAL_GAIN] = CCI_REG16_LE(0x0450),
+ [REG_APPLIED_COARSE_EXPOSURE] = CCI_REG16_LE(0x0064),
+ [REG_APPLIED_ANALOG_GAIN] = CCI_REG16_LE(0x0066),
+ [REG_APPLIED_DIGITAL_GAIN] = CCI_REG16_LE(0x0068),
+ [REG_AE_FORCE_COLDSTART] = CCI_REG8(0x042c),
+ [REG_AE_COLDSTART_COARSE_EXPOSURE] = CCI_REG32_LE(0x042e),
+ [REG_NEXT_CTX] = CCI_REG16_LE(0x0478),
+ [REG_EXPOSURE_MAX_COARSE] = CCI_REG16_LE(0x096c),
+ [REG_CTX_REPEAT_COUNT_CTX0] = CCI_REG16_LE(0x0476),
+ [REG_CTX_REPEAT_COUNT_CTX1] = CCI_REG16_LE(0x04a6),
+
+ /* Context properties */
+ [REG_CTX_STRIDE] = 0x30,
+ [REG_CTX_EXP_MODE] = 0x044c,
+ [REG_CTX_FRAME_LENGTH] = 0x0458,
+ [REG_CTX_X_START] = 0x045e,
+ [REG_CTX_X_WIDTH_OR_END] = 0x0460,
+ [REG_CTX_Y_START] = 0x0462,
+ [REG_CTX_Y_HEIGHT_OR_END] = 0x0464,
+ [REG_CTX_GPIO_0_CTRL] = 0x0467,
+};
+
+static const int vd55g1_reg_map[REG_MAX_INDEX] = {
+ [REG_SYSTEM_FSM] = CCI_REG8(0x001c),
+ [REG_ISL_ENABLE] = CCI_REG8(0x0326),
+ [REG_FWPATCH_REVISION] = CCI_REG16_LE(0x0012),
+ [REG_PATGEN_CTRL] = CCI_REG16_LE(0x0304),
+ [REG_READOUT_CTRL] = CCI_REG8(0x057e),
+ [REG_DUSTER_CTRL] = CCI_REG8(0x03ae),
+ [REG_AE_TARGET_PERCENTAGE] = CCI_REG8(0x0486),
+ [REG_MANUAL_ANALOG_GAIN] = CCI_REG8(0x0501),
+ [REG_MANUAL_COARSE_EXPOSURE] = CCI_REG16_LE(0x0502),
+ [REG_MANUAL_DIGITAL_GAIN] = CCI_REG16_LE(0x0504),
+ [REG_APPLIED_COARSE_EXPOSURE] = CCI_REG16_LE(0x00e8),
+ [REG_APPLIED_ANALOG_GAIN] = CCI_REG16_LE(0x00ea),
+ [REG_APPLIED_DIGITAL_GAIN] = CCI_REG16_LE(0x00ec),
+ [REG_AE_FORCE_COLDSTART] = CCI_REG8(0x0308),
+ [REG_AE_COLDSTART_EXPOSURE_US] = CCI_REG32_LE(0x0374),
+ [REG_NEXT_CTX] = CCI_REG16_LE(0x03e4),
+ [REG_EXPOSURE_USE_CASES] = CCI_REG8(0x0312),
+ [REG_EXPOSURE_MAX_COARSE] = CCI_REG16_LE(0x0372),
+ [REG_CTX_REPEAT_COUNT_CTX0] = CCI_REG16_LE(0x03dc),
+ [REG_CTX_REPEAT_COUNT_CTX1] = CCI_REG16_LE(0x03de),
+
+ /* Context properties */
+ [REG_CTX_STRIDE] = 0x50,
+ [REG_CTX_EXP_MODE] = 0x0500,
+ [REG_CTX_FRAME_LENGTH] = 0x050c,
+ [REG_CTX_X_START] = 0x0514,
+ [REG_CTX_X_WIDTH_OR_END] = 0x0516,
+ [REG_CTX_Y_START] = 0x0510,
+ [REG_CTX_Y_HEIGHT_OR_END] = 0x0512,
+ [REG_CTX_GPIO_0_CTRL] = 0x051d,
+ [REG_CTX_VT_MODE] = 0x0536,
+ [REG_CTX_MASK_FRAME_CTRL] = 0x0537,
+ [REG_CTX_EXPOSURE_INSTANCE] = 0x052d,
+};
+
+#include "vd55g-fw.h"
+
+struct vd55g_patch_header {
+ __le16 patch_size;
+ u8 minor;
+ u8 major;
+} __packed;
+
+struct vd55g_fw_revision_map {
+ u64 revision;
+ bool needs_patch;
+ const char *fw_name;
+ const struct firmware *builtin_fw;
+};
+
+struct vd55g_chip_info {
+ unsigned int id;
+ const char *name;
+ const struct vd55g_mode *modes;
+ u16 num_modes;
+ const int *reg_map;
+ const struct vd55g_fw_revision_map *fw_maps;
+ u16 num_fw_maps;
+ bool needs_patch_boot;
+ u32 mipi_rate_min;
+ u32 mipi_rate_max;
+ u16 width;
+ u16 height;
+ bool bayer;
+ bool hdr;
+ bool absolute_endpoints;
+ bool ae_coldstart_exposure_in_us;
+ bool limit_flash_duty_cycle;
+};
+
+static const struct vd55g_fw_revision_map vd55g0_fw_maps[] = {
+ {
+ .revision = 0x1111,
+ .needs_patch = true,
+ .fw_name = "vd55g0-cut1.bin"
+ },
+ {
+ .revision = 0x1120,
+ .needs_patch = true,
+ .fw_name = "vd55g0-cut2.bin"
+ },
+};
+
+static const struct firmware vd55g1_builtin_fw = {
+ .data = vd55g1_patch_array, .size = ARRAY_SIZE(vd55g1_patch_array)
+};
+
+static const struct vd55g_fw_revision_map vd55g1_fw_maps[] = {
+ {
+ .revision = 0x2020,
+ .needs_patch = true,
+ .fw_name = "vd55g1.bin",
+ .builtin_fw = &vd55g1_builtin_fw
+ },
+};
+
+static const struct vd55g_fw_revision_map vd65g4_fw_maps[] = {
+ { .revision = 0x3030, .needs_patch = false },
+};
+
+static const struct vd55g_chip_info vd55g0_chip_info = {
+ .id = 0x53354730,
+ .name = "vd55g0",
+ .modes = vd55g0_supported_modes,
+ .num_modes = ARRAY_SIZE(vd55g0_supported_modes),
+ .reg_map = vd55g0_reg_map,
+ .fw_maps = vd55g0_fw_maps,
+ .num_fw_maps = ARRAY_SIZE(vd55g0_fw_maps),
+ .needs_patch_boot = true,
+ .mipi_rate_min = VD55G0_MIPI_RATE_MIN,
+ .mipi_rate_max = VD55G0_MIPI_RATE_MAX,
+ .width = VD55G0_WIDTH,
+ .height = VD55G0_HEIGHT,
+ .bayer = false,
+ .hdr = false,
+ .absolute_endpoints = true,
+ .ae_coldstart_exposure_in_us = false,
+ .limit_flash_duty_cycle = true,
+};
+
+static const struct vd55g_chip_info vd55g1_chip_info = {
+ .id = 0x53354731,
+ .name = "vd55g1",
+ .modes = vd55g1_supported_modes,
+ .num_modes = ARRAY_SIZE(vd55g1_supported_modes),
+ .reg_map = vd55g1_reg_map,
+ .fw_maps = vd55g1_fw_maps,
+ .num_fw_maps = ARRAY_SIZE(vd55g1_fw_maps),
+ .needs_patch_boot = false,
+ .mipi_rate_min = VD55G1_MIPI_RATE_MIN,
+ .mipi_rate_max = VD55G1_MIPI_RATE_MAX,
+ .width = VD55G1_WIDTH,
+ .height = VD55G1_HEIGHT,
+ .bayer = false,
+ .hdr = true,
+ .absolute_endpoints = false,
+ .ae_coldstart_exposure_in_us = true,
+ .limit_flash_duty_cycle = false,
+};
+
+static const struct vd55g_chip_info vd65g4_chip_info = {
+ .id = 0x53354733,
+ .name = "vd65g4",
+ .modes = vd55g1_supported_modes,
+ .num_modes = ARRAY_SIZE(vd55g1_supported_modes),
+ .reg_map = vd55g1_reg_map,
+ .fw_maps = vd65g4_fw_maps,
+ .num_fw_maps = ARRAY_SIZE(vd65g4_fw_maps),
+ .width = VD55G1_WIDTH,
+ .height = VD55G1_HEIGHT,
+ .bayer = true,
+ .hdr = true,
+ .absolute_endpoints = false,
+ .ae_coldstart_exposure_in_us = true,
+ .limit_flash_duty_cycle = false,
+};
+
+struct vd55g {
+ struct device *dev;
+ struct v4l2_subdev sd;
+ struct media_pad pad;
+ struct regulator_bulk_data supplies[ARRAY_SIZE(vd55g_supply_name)];
+ struct gpio_desc *reset_gpio;
+ struct clk *xclk;
+ struct regmap *regmap;
+ const struct vd55g_chip_info *info;
+ u32 xclk_freq;
+ u16 oif_ctrl;
+ u8 gpios[VD55G_NB_GPIOS];
+ unsigned long ext_leds_mask;
+ u32 mipi_rate;
+ u32 pixel_clock;
+ u64 link_freq;
+ struct v4l2_ctrl_handler ctrl_handler;
+ struct v4l2_ctrl *pixel_rate_ctrl;
+ struct v4l2_ctrl *vblank_ctrl;
+ struct v4l2_ctrl *hblank_ctrl;
+ struct {
+ struct v4l2_ctrl *hflip_ctrl;
+ struct v4l2_ctrl *vflip_ctrl;
+ };
+ struct v4l2_ctrl *patgen_ctrl;
+ struct {
+ struct v4l2_ctrl *ae_ctrl;
+ struct v4l2_ctrl *expo_ctrl;
+ struct v4l2_ctrl *again_ctrl;
+ struct v4l2_ctrl *dgain_ctrl;
+ };
+ struct v4l2_ctrl *ae_lock_ctrl;
+ struct v4l2_ctrl *ae_bias_ctrl;
+ struct v4l2_ctrl *led_ctrl;
+ struct v4l2_ctrl *hdr_ctrl;
+};
+
+static inline struct vd55g *to_vd55g(struct v4l2_subdev *sd)
+{
+ return container_of_const(sd, struct vd55g, sd);
+}
+
+static inline struct vd55g *ctrl_to_vd55g(struct v4l2_ctrl *ctrl)
+{
+ struct v4l2_subdev *sd =
+ &container_of_const(ctrl->handler, struct vd55g, ctrl_handler)
+ ->sd;
+
+ return to_vd55g(sd);
+}
+
+static inline int vd55g_get_ctx_addr(struct vd55g *sensor,
+ enum vd55g_reg_id reg, u8 ctx)
+{
+ u16 base_addr = sensor->info->reg_map[reg];
+ u16 stride = sensor->info->reg_map[REG_CTX_STRIDE];
+
+ return base_addr + (stride * ctx);
+}
+
+static unsigned int vd55g_get_fmt_bpp(u32 code)
+{
+ switch (code) {
+ case MEDIA_BUS_FMT_Y8_1X8:
+ case MEDIA_BUS_FMT_SRGGB8_1X8:
+ case MEDIA_BUS_FMT_SGRBG8_1X8:
+ case MEDIA_BUS_FMT_SGBRG8_1X8:
+ case MEDIA_BUS_FMT_SBGGR8_1X8:
+ default:
+ return 8;
+
+ case MEDIA_BUS_FMT_Y10_1X10:
+ case MEDIA_BUS_FMT_SRGGB10_1X10:
+ case MEDIA_BUS_FMT_SGRBG10_1X10:
+ case MEDIA_BUS_FMT_SGBRG10_1X10:
+ case MEDIA_BUS_FMT_SBGGR10_1X10:
+ return 10;
+ }
+}
+
+static unsigned int vd55g_get_fmt_data_type(u32 code)
+{
+ switch (code) {
+ case MEDIA_BUS_FMT_Y8_1X8:
+ case MEDIA_BUS_FMT_SRGGB8_1X8:
+ case MEDIA_BUS_FMT_SGRBG8_1X8:
+ case MEDIA_BUS_FMT_SGBRG8_1X8:
+ case MEDIA_BUS_FMT_SBGGR8_1X8:
+ default:
+ return MIPI_CSI2_DT_RAW8;
+
+ case MEDIA_BUS_FMT_Y10_1X10:
+ case MEDIA_BUS_FMT_SRGGB10_1X10:
+ case MEDIA_BUS_FMT_SGRBG10_1X10:
+ case MEDIA_BUS_FMT_SGBRG10_1X10:
+ case MEDIA_BUS_FMT_SBGGR10_1X10:
+ return MIPI_CSI2_DT_RAW10;
+ }
+}
+
+static u32 vd55g_get_fmt_code(struct vd55g *sensor, u32 code)
+{
+ unsigned int i, j;
+
+ if (!sensor->info->bayer)
+ return code;
+
+ for (i = 0; i < ARRAY_SIZE(vd55g_mbus_formats_bayer); i++) {
+ for (j = 0; j < ARRAY_SIZE(vd55g_mbus_formats_bayer[i]); j++) {
+ if (vd55g_mbus_formats_bayer[i][j] == code)
+ goto adapt_bayer_pattern;
+ }
+ }
+ dev_warn(sensor->dev, "Unsupported mbus format\n");
+
+ return code;
+
+adapt_bayer_pattern:
+ j = 0;
+ /* In first init_state() call, controls might not be initialized yet */
+ if (sensor->hflip_ctrl && sensor->vflip_ctrl) {
+ j = (sensor->hflip_ctrl->val ? 1 : 0) +
+ (sensor->vflip_ctrl->val ? 2 : 0);
+ }
+
+ return vd55g_mbus_formats_bayer[i][j];
+}
+
+static s32 vd55g_get_pixel_rate(struct vd55g *sensor,
+ struct v4l2_mbus_framefmt *format)
+{
+ return sensor->mipi_rate / vd55g_get_fmt_bpp(format->code);
+}
+
+static unsigned int vd55g_get_hblank_min(struct vd55g *sensor,
+ struct v4l2_mbus_framefmt *format,
+ struct v4l2_rect *crop)
+{
+ u32 mipi_req_line_time;
+ u32 mipi_req_line_length;
+ u32 min_line_length;
+
+ /* MIPI required time */
+ mipi_req_line_time = (crop->width * vd55g_get_fmt_bpp(format->code) +
+ VD55G_MIPI_MARGIN) /
+ (sensor->mipi_rate / MEGA);
+ mipi_req_line_length =
+ mipi_req_line_time * sensor->pixel_clock / HZ_PER_MHZ;
+
+ /* Absolute time required for ADCs to convert pixels */
+ min_line_length = VD55G_LINE_LENGTH_MIN;
+ if (sensor->info->hdr)
+ if (sensor->hdr_ctrl->val == VD55G1_HDR_SUB)
+ min_line_length = VD55G1_LINE_LENGTH_SUB_MIN;
+
+ /* Respect both constraint */
+ min_line_length = max(min_line_length, mipi_req_line_length);
+
+ return min_line_length - crop->width;
+}
+
+static void vd55g_get_vblank_limits(struct vd55g *sensor,
+ struct v4l2_rect *crop,
+ struct vd55g_vblank_limits *limits)
+{
+ limits->min = VD55G_VBLANK_MIN;
+ limits->def = VD55G_FRAME_LENGTH_DEF - crop->height;
+ limits->max = VD55G_VBLANK_MAX - crop->height;
+}
+
+static void vd55g_get_frame_timings(struct vd55g *sensor,
+ struct v4l2_rect *crop,
+ struct vd55g_frame_timings *timings)
+{
+ timings->frame_length = crop->height + sensor->vblank_ctrl->val;
+
+ timings->expo_max = timings->frame_length - VD55G_EXPO_MAX_TERM;
+
+ if (sensor->info->limit_flash_duty_cycle &&
+ sensor->led_ctrl->val == V4L2_FLASH_LED_MODE_FLASH) {
+ timings->expo_max = timings->expo_max / 2;
+ }
+}
+
+#define vd55g_read(sensor, reg, val, err) \
+ cci_read((sensor)->regmap, reg, val, err)
+
+#define vd55g_write(sensor, reg, val, err) \
+ cci_write((sensor)->regmap, reg, val, err)
+
+static int vd55g_cci_read(struct vd55g *sensor, enum vd55g_reg_id reg, u64 *val,
+ int *err)
+{
+ u32 physical_addr;
+
+ if (err && *err)
+ return *err;
+
+ physical_addr = sensor->info->reg_map[reg];
+
+ if (!physical_addr) {
+ dev_err(sensor->dev,
+ "Register %d not supported on this variant\n", reg);
+ if (err)
+ *err = -EOPNOTSUPP;
+ return -EOPNOTSUPP;
+ }
+
+ return cci_read(sensor->regmap, physical_addr, val, err);
+}
+
+static int vd55g_cci_write(struct vd55g *sensor, enum vd55g_reg_id reg, u32 val,
+ int *err)
+{
+ u32 physical_addr;
+
+ if (err && *err)
+ return *err;
+
+ physical_addr = sensor->info->reg_map[reg];
+
+ if (!physical_addr) {
+ dev_err(sensor->dev,
+ "Register %d not supported on this variant\n", reg);
+ if (err)
+ *err = -EOPNOTSUPP;
+ return -EOPNOTSUPP;
+ }
+
+ return cci_write(sensor->regmap, physical_addr, val, err);
+}
+
+static int vd55g_write_array(struct vd55g *sensor, u32 reg, unsigned int len,
+ const u8 *array, int *err)
+{
+ unsigned int chunk_sz = 1024;
+ unsigned int sz;
+ int ret = 0;
+
+ if (err && *err)
+ return *err;
+
+ /*
+ * This loop isn't necessary but in certains conditions (platforms, cpu
+ * load, etc.) it has been observed that the bulk write could timeout.
+ */
+ while (len) {
+ sz = min(len, chunk_sz);
+ ret = regmap_bulk_write(sensor->regmap, reg, array, sz);
+ if (ret < 0)
+ goto out;
+ len -= sz;
+ reg += sz;
+ array += sz;
+ }
+
+out:
+ if (ret && err)
+ *err = ret;
+
+ return ret;
+}
+
+static int vd55g_poll_reg(struct vd55g *sensor, u32 reg, u8 poll_val, int *err)
+{
+ unsigned int val = 0;
+ int ret;
+
+ if (err && *err)
+ return *err;
+
+ ret = regmap_read_poll_timeout(sensor->regmap, CCI_REG_ADDR(reg), val,
+ (val == poll_val), 2000,
+ 500 * USEC_PER_MSEC);
+
+ if (ret && err)
+ *err = ret;
+
+ return ret;
+}
+
+static int vd55g_wait_state(struct vd55g *sensor, int state, int *err)
+{
+ u32 reg = sensor->info->reg_map[REG_SYSTEM_FSM];
+
+ return vd55g_poll_reg(sensor, reg, state, err);
+}
+
+static int vd55g_prepare_clock_tree(struct vd55g *sensor)
+{
+ u32 sys_clk, mipi_div, pixel_div;
+
+ if (sensor->xclk_freq < VD55G_XCLK_FREQ_MIN ||
+ sensor->xclk_freq > VD55G_XCLK_FREQ_MAX) {
+ dev_err(sensor->dev,
+ "Only %luMhz-%luMhz clock range supported. Provided %lu MHz\n",
+ VD55G_XCLK_FREQ_MIN / HZ_PER_MHZ,
+ VD55G_XCLK_FREQ_MAX / HZ_PER_MHZ,
+ sensor->xclk_freq / HZ_PER_MHZ);
+ return -EINVAL;
+ }
+
+ /* MIPI bus is double data rate */
+ sensor->mipi_rate = sensor->link_freq * 2;
+
+ if (sensor->mipi_rate < sensor->info->mipi_rate_min ||
+ sensor->mipi_rate > sensor->info->mipi_rate_max) {
+ dev_err(sensor->dev,
+ "Only %luMbps-%luMbps data rate range supported. Provided %lu Mbps\n",
+ sensor->info->mipi_rate_min / MEGA,
+ sensor->info->mipi_rate_max / MEGA,
+ sensor->mipi_rate / MEGA);
+ return -EINVAL;
+ }
+
+ if (sensor->mipi_rate <= 300 * MEGA)
+ mipi_div = 4;
+ else if (sensor->mipi_rate <= 600 * MEGA)
+ mipi_div = 2;
+ else
+ mipi_div = 1;
+
+ sys_clk = sensor->mipi_rate * mipi_div;
+
+ if (sys_clk <= 780 * HZ_PER_MHZ)
+ pixel_div = 5;
+ else if (sys_clk <= 900 * HZ_PER_MHZ)
+ pixel_div = 6;
+ else
+ pixel_div = 8;
+
+ sensor->pixel_clock = sys_clk / pixel_div;
+
+ return 0;
+}
+
+static int vd55g_update_patgen(struct vd55g *sensor, u32 patgen_index)
+{
+ static const u8 index2val[] = { 0x0, 0x22, 0x28 };
+ u32 pattern = index2val[patgen_index];
+ u32 reg = pattern << VD55G_PATGEN_TYPE_SHIFT;
+ u8 duster = VD55G_DUSTER_RING_ENABLE | VD55G_DUSTER_DYN_ENABLE |
+ VD55G_DUSTER_ENABLE;
+ int ret = 0;
+
+ BUILD_BUG_ON(ARRAY_SIZE(index2val) != ARRAY_SIZE(vd55g_tp_menu));
+
+ if (pattern != 0) {
+ reg |= VD55G_PATGEN_ENABLE;
+ /* Take care of duster to not mess up the test pattern output */
+ duster = VD55G_DUSTER_DISABLE;
+ }
+
+ vd55g_cci_write(sensor, REG_DUSTER_CTRL, duster, &ret);
+ vd55g_cci_write(sensor, REG_PATGEN_CTRL, reg, &ret);
+
+ return ret;
+}
+
+static int vd55g_update_expo_cluster(struct vd55g *sensor, bool is_auto)
+{
+ enum vd55g_expo_state expo_state = is_auto ? VD55G1_EXP_AUTO :
+ VD55G1_EXP_MANUAL;
+ int ret = 0;
+
+ if (sensor->ae_ctrl->is_new) {
+ vd55g_write(sensor, VD55G_REG_EXP_MODE(sensor, 0), expo_state,
+ &ret);
+ vd55g_cci_write(sensor, REG_EXPOSURE_MAX_COARSE,
+ sensor->expo_ctrl->maximum, &ret);
+ }
+
+ if (sensor->info->hdr) {
+ if (sensor->hdr_ctrl->val == VD55G1_HDR_SUB &&
+ sensor->hdr_ctrl->is_new) {
+ vd55g_write(sensor, VD55G_REG_EXP_MODE(sensor, 1),
+ VD55G1_EXP_BYPASS, &ret);
+ if (ret)
+ return ret;
+ }
+ }
+
+ if (!is_auto && sensor->expo_ctrl->is_new)
+ vd55g_cci_write(sensor, REG_MANUAL_COARSE_EXPOSURE,
+ sensor->expo_ctrl->val, &ret);
+
+ if (!is_auto && sensor->again_ctrl->is_new)
+ vd55g_cci_write(sensor, REG_MANUAL_ANALOG_GAIN,
+ sensor->again_ctrl->val, &ret);
+
+ if (!is_auto && sensor->dgain_ctrl->is_new)
+ vd55g_cci_write(sensor, REG_MANUAL_DIGITAL_GAIN,
+ sensor->dgain_ctrl->val, &ret);
+
+ return ret;
+}
+
+static int vd55g_lock_exposure(struct vd55g *sensor, u32 lock_val)
+{
+ bool ae_lock = lock_val & V4L2_LOCK_EXPOSURE;
+ enum vd55g_expo_state expo_state = ae_lock ? VD55G1_EXP_FREEZE :
+ VD55G1_EXP_AUTO;
+ int ret = 0;
+
+ if (sensor->ae_ctrl->val == V4L2_EXPOSURE_AUTO)
+ vd55g_write(sensor, VD55G_REG_EXP_MODE(sensor, 0), expo_state,
+ &ret);
+
+ return ret;
+}
+
+static int vd55g_read_expo_cluster(struct vd55g *sensor)
+{
+ u64 exposure = 0;
+ u64 again = 0;
+ u64 dgain = 0;
+ int ret = 0;
+
+ vd55g_cci_read(sensor, REG_APPLIED_COARSE_EXPOSURE, &exposure, &ret);
+ vd55g_cci_read(sensor, REG_APPLIED_ANALOG_GAIN, &again, &ret);
+ vd55g_cci_read(sensor, REG_APPLIED_DIGITAL_GAIN, &dgain, &ret);
+ if (ret)
+ return ret;
+
+ sensor->expo_ctrl->cur.val = exposure;
+ sensor->again_ctrl->cur.val = again;
+ sensor->dgain_ctrl->cur.val = dgain;
+
+ return 0;
+}
+
+static int vd55g_update_frame_length(struct vd55g *sensor,
+ unsigned int frame_length)
+{
+ int ret = 0;
+
+ if (sensor->info->hdr)
+ if (sensor->hdr_ctrl->val == VD55G1_HDR_SUB)
+ vd55g_write(sensor, VD55G_REG_FRAME_LENGTH(sensor, 1),
+ frame_length, &ret);
+ vd55g_write(sensor, VD55G_REG_FRAME_LENGTH(sensor, 0), frame_length,
+ &ret);
+
+ return ret;
+}
+
+static int vd55g_update_exposure_target(struct vd55g *sensor, int index)
+{
+ /*
+ * Find auto exposure target with: default target exposure * 2^EV
+ * Defaut target exposure being 27 for the sensor.
+ */
+ static const unsigned int index2exposure_target[] = {
+ 3, 5, 7, 10, 14, 19, 27, 38, 54, 76, 108, 153, 216,
+ };
+ int exposure_target = index2exposure_target[index];
+
+ return vd55g_cci_write(sensor, REG_AE_TARGET_PERCENTAGE,
+ exposure_target, NULL);
+}
+
+static int vd55g_apply_cold_start(struct vd55g *sensor, struct v4l2_rect *crop)
+{
+ int ret;
+
+ if (sensor->info->ae_coldstart_exposure_in_us) {
+ /*
+ * Cold start register is a single register expressed as exposure time
+ * in us. This differ from status registers being a combination of
+ * exposure, digital gain, and analog gain, requiring the following
+ * format conversion.
+ */
+ unsigned int line_length =
+ crop->width + sensor->hblank_ctrl->val;
+ unsigned int line_time_us =
+ DIV_ROUND_UP(line_length * MEGA, sensor->pixel_clock);
+ u8 d_gain = DIV_ROUND_CLOSEST(sensor->dgain_ctrl->val, 1 << 8);
+ u8 a_gain =
+ DIV_ROUND_CLOSEST(32, (32 - sensor->again_ctrl->val));
+ unsigned int expo_us =
+ sensor->expo_ctrl->val * d_gain * a_gain * line_time_us;
+ vd55g_cci_write(sensor, REG_AE_COLDSTART_EXPOSURE_US, expo_us,
+ &ret);
+ } else {
+ vd55g_cci_write(sensor, REG_AE_COLDSTART_COARSE_EXPOSURE,
+ sensor->expo_ctrl->val, &ret);
+ }
+
+ vd55g_cci_write(sensor, REG_AE_FORCE_COLDSTART, 1, &ret);
+
+ return ret;
+}
+
+static void vd55g_update_pad_fmt(struct vd55g *sensor,
+ const struct vd55g_mode *mode, u32 code,
+ struct v4l2_mbus_framefmt *fmt)
+{
+ fmt->code = vd55g_get_fmt_code(sensor, code);
+ fmt->width = mode->width;
+ fmt->height = mode->height;
+ fmt->colorspace = V4L2_COLORSPACE_RAW;
+ fmt->field = V4L2_FIELD_NONE;
+ fmt->ycbcr_enc = V4L2_YCBCR_ENC_DEFAULT;
+ fmt->quantization = V4L2_QUANTIZATION_DEFAULT;
+ fmt->xfer_func = V4L2_XFER_FUNC_DEFAULT;
+}
+
+static int vd55g_update_hdr_mode(struct vd55g *sensor)
+{
+ int ret = 0;
+
+ if (!sensor->info->hdr)
+ return -EINVAL;
+
+ switch (sensor->hdr_ctrl->val) {
+ case VD55G1_NO_HDR:
+ vd55g_cci_write(sensor, REG_EXPOSURE_MAX_COARSE,
+ sensor->expo_ctrl->maximum, &ret);
+ vd55g_cci_write(sensor, REG_EXPOSURE_USE_CASES, 0, &ret);
+ vd55g_cci_write(sensor, REG_NEXT_CTX, 0x0, &ret);
+
+ vd55g_cci_write(sensor, REG_CTX_REPEAT_COUNT_CTX0, 0, &ret);
+
+ vd55g_write(sensor, VD55G_REG_VT_MODE(sensor, 0),
+ VD55G1_VT_MODE_NORMAL, &ret);
+ vd55g_write(sensor, VD55G_REG_MASK_FRAME_CTRL(sensor, 0),
+ VD55G1_MASK_FRAME_CTRL_OUTPUT, &ret);
+ break;
+ case VD55G1_HDR_SUB:
+ vd55g_cci_write(sensor, REG_EXPOSURE_MAX_COARSE,
+ VD55G1_EXPOSURE_MAX_COARSE_SUB, &ret);
+ vd55g_cci_write(sensor, REG_EXPOSURE_USE_CASES,
+ VD55G1_EXPOSURE_USE_CASES_MULTI_CONTEXT, &ret);
+ vd55g_cci_write(sensor, REG_NEXT_CTX, 0x0001, &ret);
+
+ vd55g_cci_write(sensor, REG_CTX_REPEAT_COUNT_CTX0, 1, &ret);
+ vd55g_cci_write(sensor, REG_CTX_REPEAT_COUNT_CTX1, 1, &ret);
+
+ vd55g_write(sensor, VD55G_REG_VT_MODE(sensor, 0),
+ VD55G1_VT_MODE_NORMAL, &ret);
+ vd55g_write(sensor, VD55G_REG_MASK_FRAME_CTRL(sensor, 0),
+ VD55G1_MASK_FRAME_CTRL_MASK, &ret);
+ vd55g_write(sensor, VD55G_REG_EXPOSURE_INSTANCE(sensor, 0), 0,
+ &ret);
+ vd55g_write(sensor, VD55G_REG_VT_MODE(sensor, 1),
+ VD55G1_VT_MODE_SUBTRACTION, &ret);
+ vd55g_write(sensor, VD55G_REG_MASK_FRAME_CTRL(sensor, 1),
+ VD55G1_MASK_FRAME_CTRL_OUTPUT, &ret);
+ vd55g_write(sensor, VD55G_REG_EXPOSURE_INSTANCE(sensor, 1), 1,
+ &ret);
+ break;
+ default:
+ ret = -EINVAL;
+ }
+
+ return ret;
+}
+
+static int vd55g_set_framefmt(struct vd55g *sensor,
+ struct v4l2_mbus_framefmt *format,
+ struct v4l2_rect *crop)
+{
+ u8 binning;
+ int ret = 0;
+ int x_val, y_val;
+
+ vd55g_write(sensor, VD55G_REG_FORMAT_CTRL,
+ vd55g_get_fmt_bpp(format->code), &ret);
+ vd55g_write(sensor, VD55G_REG_OIF_IMG_CTRL,
+ vd55g_get_fmt_data_type(format->code), &ret);
+
+ switch (crop->width / format->width) {
+ case 1:
+ default:
+ binning = VD55G_READOUT_CTRL_BIN_MODE_NORMAL;
+ break;
+ case 2:
+ binning = VD55G_READOUT_CTRL_BIN_MODE_DIGITAL_X2;
+ break;
+ }
+ vd55g_cci_write(sensor, REG_READOUT_CTRL, binning, &ret);
+
+ if (sensor->info->absolute_endpoints) {
+ x_val = crop->left + crop->width - 1;
+ y_val = crop->top + crop->height - 1;
+ } else {
+ x_val = crop->width;
+ y_val = crop->height;
+ }
+
+ vd55g_write(sensor, VD55G_REG_X_START(sensor, 0), crop->left, &ret);
+ vd55g_write(sensor, VD55G_REG_X_WIDTH_OR_END(sensor, 0), x_val, &ret);
+ vd55g_write(sensor, VD55G_REG_Y_START(sensor, 0), crop->top, &ret);
+ vd55g_write(sensor, VD55G_REG_Y_HEIGHT_OR_END(sensor, 0), y_val, &ret);
+
+ if (sensor->info->hdr) {
+ vd55g_write(sensor, VD55G_REG_X_START(sensor, 1), crop->left,
+ &ret);
+ vd55g_write(sensor, VD55G_REG_X_WIDTH_OR_END(sensor, 1), x_val,
+ &ret);
+ vd55g_write(sensor, VD55G_REG_Y_START(sensor, 1), crop->top,
+ &ret);
+ vd55g_write(sensor, VD55G_REG_Y_HEIGHT_OR_END(sensor, 1), y_val,
+ &ret);
+ }
+
+ return ret;
+}
+
+static int vd55g_update_gpios(struct vd55g *sensor, unsigned long gpio_mask)
+{
+ unsigned long io;
+ u8 gpio_val;
+ int ret = 0;
+
+ for_each_set_bit(io, &gpio_mask, VD55G_NB_GPIOS) {
+ gpio_val = sensor->gpios[io];
+
+ if (gpio_val == VD55G_GPIO_MODE_STROBE &&
+ sensor->led_ctrl->val == V4L2_FLASH_LED_MODE_NONE) {
+ gpio_val = VD55G_GPIO_MODE_IN;
+ if (sensor->info->hdr) {
+ if (sensor->hdr_ctrl->val == VD55G1_HDR_SUB) {
+ /* Make its context 1 counterpart strobe too */
+ vd55g_write(sensor,
+ VD55G_REG_GPIO_CTRL(sensor,
+ 1, io),
+ gpio_val, &ret);
+ }
+ }
+ }
+
+ ret = vd55g_write(sensor, VD55G_REG_GPIO_CTRL(sensor, 0, io),
+ gpio_val, &ret);
+ }
+
+ return ret;
+}
+
+static int vd55g_ro_ctrls_setup(struct vd55g *sensor, struct v4l2_rect *crop)
+{
+ return vd55g_write(sensor, VD55G_REG_LINE_LENGTH,
+ crop->width + sensor->hblank_ctrl->val, NULL);
+}
+
+static void vd55g_grab_ctrls(struct vd55g *sensor, bool enable)
+{
+ /* These settings cannot change during stream */
+ v4l2_ctrl_grab(sensor->hflip_ctrl, enable);
+ v4l2_ctrl_grab(sensor->vflip_ctrl, enable);
+ v4l2_ctrl_grab(sensor->patgen_ctrl, enable);
+ v4l2_ctrl_grab(sensor->hdr_ctrl, enable);
+}
+
+static int vd55g_enable_streams(struct v4l2_subdev *sd,
+ struct v4l2_subdev_state *state, u32 pad,
+ u64 streams_mask)
+{
+ struct vd55g *sensor = to_vd55g(sd);
+ struct v4l2_rect *crop = v4l2_subdev_state_get_crop(state, 0);
+ struct v4l2_mbus_framefmt *format =
+ v4l2_subdev_state_get_format(state, 0);
+ int ret;
+
+ ret = pm_runtime_resume_and_get(sensor->dev);
+ if (ret < 0)
+ return ret;
+
+ /* Configure output */
+ vd55g_write(sensor, VD55G_REG_MIPI_DATA_RATE, sensor->mipi_rate, &ret);
+ vd55g_write(sensor, VD55G_REG_OIF_CTRL, sensor->oif_ctrl, &ret);
+ vd55g_cci_write(sensor, REG_ISL_ENABLE, 0, &ret);
+ if (ret)
+ goto err_rpm_put;
+
+ ret = vd55g_set_framefmt(sensor, format, crop);
+ if (ret)
+ goto err_rpm_put;
+
+ /* Setup default GPIO values; could be overridden by V4L2 ctrl setup */
+ ret = vd55g_update_gpios(sensor, GENMASK(VD55G_NB_GPIOS - 1, 0));
+ if (ret)
+ goto err_rpm_put;
+
+ ret = vd55g_apply_cold_start(sensor, crop);
+ if (ret)
+ goto err_rpm_put;
+
+ /* Apply settings from V4L2 ctrls */
+ ret = __v4l2_ctrl_handler_setup(&sensor->ctrl_handler);
+ if (ret)
+ goto err_rpm_put;
+
+ /* Also apply settings from read-only V4L2 ctrls */
+ ret = vd55g_ro_ctrls_setup(sensor, crop);
+ if (ret)
+ goto err_rpm_put;
+
+ /* Start streaming */
+ vd55g_write(sensor, VD55G_REG_STBY, VD55G_STBY_START_STREAM, &ret);
+ vd55g_poll_reg(sensor, VD55G_REG_STBY, 0, &ret);
+ vd55g_wait_state(sensor, VD55G_SYSTEM_FSM_STREAMING, &ret);
+ if (ret)
+ goto err_rpm_put;
+
+ vd55g_grab_ctrls(sensor, true);
+
+ return 0;
+
+err_rpm_put:
+ pm_runtime_put(sensor->dev);
+ return -EINVAL;
+}
+
+static int vd55g_disable_streams(struct v4l2_subdev *sd,
+ struct v4l2_subdev_state *state, u32 pad,
+ u64 streams_mask)
+{
+ struct vd55g *sensor = to_vd55g(sd);
+ int ret = 0;
+
+ /* Retrieve Expo cluster to enable coldstart of AE */
+ ret = vd55g_read_expo_cluster(sensor);
+
+ vd55g_write(sensor, VD55G_REG_STREAMING, VD55G_STREAMING_STOP_STREAM,
+ &ret);
+ vd55g_poll_reg(sensor, VD55G_REG_STREAMING, 0, &ret);
+ vd55g_wait_state(sensor, VD55G_SYSTEM_FSM_SW_STBY, &ret);
+
+ if (ret)
+ dev_warn(sensor->dev, "Can't disable stream\n");
+
+ vd55g_grab_ctrls(sensor, false);
+
+ pm_runtime_put_autosuspend(sensor->dev);
+
+ return ret;
+}
+
+static int vd55g_load_and_apply_patch(struct vd55g *sensor,
+ const struct vd55g_fw_revision_map *fw_info)
+{
+ const struct firmware *fw;
+ const struct vd55g_patch_header *hdr;
+ u16 payload_len;
+ u64 hardware_version;
+ int ret;
+
+ ret = request_firmware(&fw, fw_info->fw_name, sensor->dev);
+
+ if (ret == -ENOENT && fw_info->builtin_fw) {
+ dev_info(sensor->dev,
+ "External firmware %s not found, using built-in defaults\n",
+ fw_info->fw_name);
+ fw = fw_info->builtin_fw;
+ } else if (ret) {
+ dev_err(sensor->dev,
+ "Failed to load required firmware %s: %d\n",
+ fw_info->fw_name,
+ ret);
+ return ret;
+ }
+
+ if (fw->size < sizeof(*hdr)) {
+ dev_err(sensor->dev,
+ "Patch file is too small to contain a header\n");
+ return -EINVAL;
+ }
+
+ hdr = (const struct vd55g_patch_header *)fw->data;
+ payload_len = le16_to_cpu(hdr->patch_size);
+
+ if (payload_len > fw->size) {
+ dev_err(sensor->dev,
+ "Patch payload length mismatch in header\n");
+ return -EINVAL;
+ }
+
+ vd55g_write_array(sensor, VD55G_REG_FWPATCH_START_ADDR, fw->size,
+ fw->data, &ret);
+ vd55g_write(sensor, VD55G_REG_BOOT, VD55G_BOOT_PATCH, &ret);
+ vd55g_poll_reg(sensor, VD55G_REG_BOOT, 0, &ret);
+ if (ret) {
+ dev_err(sensor->dev, "Failed to apply patch\n");
+ return ret;
+ }
+
+ ret = vd55g_cci_read(sensor, REG_FWPATCH_REVISION, &hardware_version,
+ &ret);
+ if (ret)
+ return ret;
+
+ if ((hardware_version & 0xFFFF) != ((hdr->major << 8) | hdr->minor)) {
+ dev_err(sensor->dev,
+ "Bad patch version expected %d.%d got %d.%d\n",
+ hdr->major, hdr->minor, (u8)(hardware_version >> 8),
+ (u8)(hardware_version & 0xff));
+ return -ENODEV;
+ }
+
+ dev_dbg(sensor->dev, "patch %d.%d applied\n",
+ (u8)(hardware_version >> 8), (u8)(hardware_version & 0xff));
+ return 0;
+}
+
+static int vd55g_get_firmware_name(struct vd55g *sensor, u64 revision,
+ const struct vd55g_fw_revision_map **fw_info)
+{
+ for (int i = 0; i < sensor->info->num_fw_maps; i++) {
+ const struct vd55g_fw_revision_map *map = &sensor->info->fw_maps[i];
+
+ if (map->revision == revision) {
+ *fw_info = map;
+ return 0;
+ }
+ }
+
+ return -ENOENT;
+}
+
+static int vd55g_boot(struct vd55g *sensor)
+{
+ int ret = 0;
+ u64 rev;
+ const struct vd55g_fw_revision_map *fw_info;
+
+ ret = vd55g_read(sensor, VD55G_REG_REVISION, &rev, NULL);
+ if (ret)
+ return ret;
+
+ ret = vd55g_get_firmware_name(sensor, rev, &fw_info);
+ if (ret == -ENOENT) {
+ dev_err(sensor->dev,
+ "Unsupported sensor revision 0x%x for sensor %s\n",
+ (u16)rev, sensor->info->name);
+ return -ENODEV;
+ }
+
+ if (fw_info->needs_patch)
+ vd55g_load_and_apply_patch(sensor, fw_info);
+
+ if (!fw_info->needs_patch || sensor->info->needs_patch_boot) {
+ vd55g_write(sensor, VD55G_REG_BOOT, VD55G_BOOT_BOOT, &ret);
+ vd55g_poll_reg(sensor, VD55G_REG_BOOT, 0, &ret);
+ if (ret) {
+ dev_err(sensor->dev, "Failed to boot\n");
+ return ret;
+ }
+ }
+
+ ret = vd55g_wait_state(sensor, VD55G_SYSTEM_FSM_SW_STBY, NULL);
+ if (ret) {
+ dev_err(sensor->dev, "Sensor waiting after boot failed\n");
+ return ret;
+ }
+
+ return 0;
+}
+
+static int vd55g_get_selection(struct v4l2_subdev *sd,
+ struct v4l2_subdev_state *sd_state,
+ struct v4l2_subdev_selection *sel)
+{
+ struct vd55g *sensor = to_vd55g(sd);
+ const struct v4l2_rect *crop = v4l2_subdev_state_get_crop(sd_state, 0);
+
+ switch (sel->target) {
+ case V4L2_SEL_TGT_CROP:
+ sel->r = *crop;
+ return 0;
+ case V4L2_SEL_TGT_NATIVE_SIZE:
+ case V4L2_SEL_TGT_CROP_DEFAULT:
+ case V4L2_SEL_TGT_CROP_BOUNDS:
+ sel->r.top = 0;
+ sel->r.left = 0;
+ sel->r.width = sensor->info->width;
+ sel->r.height = sensor->info->height;
+ return 0;
+ }
+
+ return -EINVAL;
+}
+
+static int vd55g_enum_mbus_code(struct v4l2_subdev *sd,
+ struct v4l2_subdev_state *sd_state,
+ struct v4l2_subdev_mbus_code_enum *code)
+{
+ struct vd55g *sensor = to_vd55g(sd);
+ u32 base_code;
+
+ if (!sensor->info->bayer) {
+ if (code->index >= ARRAY_SIZE(vd55g_mbus_formats_mono))
+ return -EINVAL;
+ base_code = vd55g_mbus_formats_mono[code->index];
+ } else {
+ if (code->index >= ARRAY_SIZE(vd55g_mbus_formats_bayer))
+ return -EINVAL;
+ base_code = vd55g_mbus_formats_bayer[code->index][0];
+ }
+ code->code = vd55g_get_fmt_code(sensor, base_code);
+
+ return 0;
+}
+
+static int vd55g_new_format_change_controls(struct vd55g *sensor,
+ struct v4l2_mbus_framefmt *format,
+ struct v4l2_rect *crop)
+{
+ struct vd55g_vblank_limits vblank;
+ struct vd55g_frame_timings timings;
+ unsigned int hblank;
+ int ret;
+
+ /* Reset vblank and frame length to default */
+ vd55g_get_vblank_limits(sensor, crop, &vblank);
+ ret = __v4l2_ctrl_modify_range(sensor->vblank_ctrl, vblank.min,
+ vblank.max, 1, vblank.def);
+ if (ret)
+ return ret;
+
+ /* Max exposure changes with vblank */
+ vd55g_get_frame_timings(sensor, crop, &timings);
+ ret = __v4l2_ctrl_modify_range(sensor->expo_ctrl, 0, timings.expo_max,
+ 1, VD55G_EXPO_DEF);
+ if (ret)
+ return ret;
+
+ /* Update pixel rate to reflect new bpp */
+ ret = __v4l2_ctrl_s_ctrl_int64(sensor->pixel_rate_ctrl,
+ vd55g_get_pixel_rate(sensor, format));
+ if (ret)
+ return ret;
+
+ /* Update hblank according to new width */
+ hblank = vd55g_get_hblank_min(sensor, format, crop);
+ ret = __v4l2_ctrl_modify_range(sensor->hblank_ctrl, hblank, hblank, 1,
+ hblank);
+
+ return ret;
+}
+
+static int vd55g_set_pad_fmt(struct v4l2_subdev *sd,
+ struct v4l2_subdev_state *sd_state,
+ struct v4l2_subdev_format *sd_fmt)
+{
+ struct vd55g *sensor = to_vd55g(sd);
+ const struct vd55g_mode *new_mode;
+ struct v4l2_mbus_framefmt *format;
+ struct v4l2_rect pad_crop;
+ unsigned int binning;
+
+ new_mode = v4l2_find_nearest_size(sensor->info->modes,
+ sensor->info->num_modes, width,
+ height, sd_fmt->format.width,
+ sd_fmt->format.height);
+
+ vd55g_update_pad_fmt(sensor, new_mode, sd_fmt->format.code,
+ &sd_fmt->format);
+
+ /*
+ * Use binning to maximize the crop rectangle size, and centre it in the
+ * sensor.
+ */
+ binning = min(sensor->info->width / sd_fmt->format.width,
+ sensor->info->height / sd_fmt->format.height);
+ binning = min(binning, 2U);
+ pad_crop.width = sd_fmt->format.width * binning;
+ pad_crop.height = sd_fmt->format.height * binning;
+ pad_crop.left = (sensor->info->width - pad_crop.width) / 2;
+ pad_crop.top = (sensor->info->height - pad_crop.height) / 2;
+
+ format = v4l2_subdev_state_get_format(sd_state, sd_fmt->pad);
+
+ *format = sd_fmt->format;
+
+ *v4l2_subdev_state_get_crop(sd_state, sd_fmt->pad) = pad_crop;
+ if (sd_fmt->which == V4L2_SUBDEV_FORMAT_ACTIVE)
+ return vd55g_new_format_change_controls(sensor, &sd_fmt->format,
+ &pad_crop);
+
+ return 0;
+}
+
+static int vd55g_init_state(struct v4l2_subdev *sd,
+ struct v4l2_subdev_state *sd_state)
+{
+ struct vd55g *sensor = to_vd55g(sd);
+ struct v4l2_subdev_format fmt = { 0 };
+ struct v4l2_subdev_route routes[] = {
+ { .flags = V4L2_SUBDEV_ROUTE_FL_ACTIVE }
+ };
+ struct v4l2_subdev_krouting routing = {
+ .num_routes = ARRAY_SIZE(routes),
+ .routes = routes,
+ };
+ int ret;
+
+ /* Needed by v4l2_subdev_s_stream_helper(), even with 1 stream only */
+ ret = v4l2_subdev_set_routing(sd, sd_state, &routing);
+ if (ret)
+ return ret;
+
+ vd55g_update_pad_fmt(sensor, &sensor->info->modes[VD55G_MODE_DEF],
+ vd55g_get_fmt_code(sensor, VD55G_MBUS_CODE_DEF),
+ &fmt.format);
+
+ return vd55g_set_pad_fmt(sd, sd_state, &fmt);
+}
+
+static int vd55g_enum_frame_size(struct v4l2_subdev *sd,
+ struct v4l2_subdev_state *sd_state,
+ struct v4l2_subdev_frame_size_enum *fse)
+{
+ struct vd55g *sensor = to_vd55g(sd);
+ u32 code;
+
+ if (fse->index >= sensor->info->num_modes)
+ return -EINVAL;
+
+ code = vd55g_get_fmt_code(sensor, fse->code);
+ if (fse->code != code)
+ return -EINVAL;
+
+ fse->min_width = sensor->info->modes[fse->index].width;
+ fse->max_width = fse->min_width;
+ fse->min_height = sensor->info->modes[fse->index].height;
+ fse->max_height = fse->min_height;
+
+ return 0;
+}
+
+static const struct v4l2_subdev_internal_ops vd55g_internal_ops = {
+ .init_state = vd55g_init_state,
+};
+
+static const struct v4l2_subdev_pad_ops vd55g_pad_ops = {
+ .enum_mbus_code = vd55g_enum_mbus_code,
+ .get_fmt = v4l2_subdev_get_fmt,
+ .set_fmt = vd55g_set_pad_fmt,
+ .get_selection = vd55g_get_selection,
+ .enum_frame_size = vd55g_enum_frame_size,
+ .enable_streams = vd55g_enable_streams,
+ .disable_streams = vd55g_disable_streams,
+};
+
+static const struct v4l2_subdev_video_ops vd55g_video_ops = {
+ .s_stream = v4l2_subdev_s_stream_helper,
+};
+
+static const struct v4l2_subdev_ops vd55g_subdev_ops = {
+ .video = &vd55g_video_ops,
+ .pad = &vd55g_pad_ops,
+};
+
+static int vd55g_g_volatile_ctrl(struct v4l2_ctrl *ctrl)
+{
+ struct vd55g *sensor = ctrl_to_vd55g(ctrl);
+ int ret = 0;
+
+ /* Interact with HW only when it is powered ON */
+ if (!pm_runtime_get_if_in_use(sensor->dev))
+ return 0;
+
+ switch (ctrl->id) {
+ case V4L2_CID_EXPOSURE_AUTO:
+ ret = vd55g_read_expo_cluster(sensor);
+ break;
+ default:
+ ret = -EINVAL;
+ break;
+ }
+
+ pm_runtime_put_autosuspend(sensor->dev);
+
+ return ret;
+}
+
+static int vd55g_s_ctrl(struct v4l2_ctrl *ctrl)
+{
+ struct vd55g *sensor = ctrl_to_vd55g(ctrl);
+ struct v4l2_subdev_state *state =
+ v4l2_subdev_get_locked_active_state(&sensor->sd);
+ struct v4l2_rect *crop = v4l2_subdev_state_get_crop(state, 0);
+ struct v4l2_mbus_framefmt *format =
+ v4l2_subdev_state_get_format(state, 0);
+ unsigned int hblank = vd55g_get_hblank_min(sensor, format, crop);
+ struct vd55g_frame_timings timings;
+ bool is_auto = false;
+ int ret = 0;
+
+ if (ctrl->flags & V4L2_CTRL_FLAG_READ_ONLY)
+ return 0;
+
+ /* Update controls state, range, etc. whatever the state of the HW */
+ switch (ctrl->id) {
+ case V4L2_CID_VBLANK:
+ case V4L2_CID_FLASH_LED_MODE:
+ vd55g_get_frame_timings(sensor, crop, &timings);
+ ret = __v4l2_ctrl_modify_range(sensor->expo_ctrl, 0,
+ timings.expo_max, 1,
+ VD55G_EXPO_DEF);
+ break;
+ case V4L2_CID_EXPOSURE_AUTO:
+ is_auto = (ctrl->val == V4L2_EXPOSURE_AUTO);
+ __v4l2_ctrl_grab(sensor->ae_lock_ctrl, !is_auto);
+ __v4l2_ctrl_grab(sensor->ae_bias_ctrl, !is_auto);
+ break;
+ case V4L2_CID_HDR_SENSOR_MODE:
+ /* Discriminate if the userspace changed the control value */
+ if (ctrl->val != ctrl->cur.val) {
+ /* Max horizontal blanking changes with hdr mode */
+ ret = __v4l2_ctrl_modify_range(sensor->hblank_ctrl,
+ hblank, hblank, 1,
+ hblank);
+ }
+ break;
+ default:
+ break;
+ }
+
+ /* Don't modify hardware if controls modification failed */
+ if (ret)
+ return ret;
+
+ /* Interact with HW only when it is powered ON */
+ if (!pm_runtime_get_if_in_use(sensor->dev))
+ return 0;
+
+ switch (ctrl->id) {
+ case V4L2_CID_HFLIP:
+ ret = vd55g_write(sensor, VD55G_REG_ORIENTATION,
+ sensor->hflip_ctrl->val |
+ (sensor->vflip_ctrl->val << 1),
+ NULL);
+ break;
+ case V4L2_CID_TEST_PATTERN:
+ ret = vd55g_update_patgen(sensor, ctrl->val);
+ break;
+ case V4L2_CID_EXPOSURE_AUTO:
+ ret = vd55g_update_expo_cluster(sensor, is_auto);
+ break;
+ case V4L2_CID_3A_LOCK:
+ ret = vd55g_lock_exposure(sensor, ctrl->val);
+ break;
+ case V4L2_CID_AUTO_EXPOSURE_BIAS:
+ /*
+ * We use auto exposure target percentage register to control
+ * exposure bias for more precision.
+ */
+ ret = vd55g_update_exposure_target(sensor, ctrl->val);
+ break;
+ case V4L2_CID_VBLANK:
+ ret = vd55g_update_frame_length(sensor, timings.frame_length);
+ break;
+ case V4L2_CID_FLASH_LED_MODE:
+ ret = vd55g_update_gpios(sensor, sensor->ext_leds_mask);
+ break;
+ case V4L2_CID_HDR_SENSOR_MODE:
+ ret = vd55g_update_hdr_mode(sensor);
+ break;
+ default:
+ ret = -EINVAL;
+ break;
+ }
+
+ pm_runtime_put_autosuspend(sensor->dev);
+
+ return ret;
+}
+
+static const struct v4l2_ctrl_ops vd55g_ctrl_ops = {
+ .g_volatile_ctrl = vd55g_g_volatile_ctrl,
+ .s_ctrl = vd55g_s_ctrl,
+};
+
+static int vd55g_init_ctrls(struct vd55g *sensor)
+{
+ const struct v4l2_ctrl_ops *ops = &vd55g_ctrl_ops;
+ struct v4l2_ctrl_handler *hdl = &sensor->ctrl_handler;
+ struct v4l2_ctrl *ctrl;
+ struct v4l2_fwnode_device_properties fwnode_props;
+ struct vd55g_vblank_limits vblank;
+ unsigned int hblank;
+ struct v4l2_subdev_state *state =
+ v4l2_subdev_lock_and_get_active_state(&sensor->sd);
+ struct v4l2_rect *crop = v4l2_subdev_state_get_crop(state, 0);
+ struct v4l2_mbus_framefmt *format =
+ v4l2_subdev_state_get_format(state, 0);
+ s32 pixel_rate = vd55g_get_pixel_rate(sensor, format);
+ int ret;
+
+ v4l2_ctrl_handler_init(hdl, 16);
+
+ /* Flip cluster */
+ sensor->hflip_ctrl =
+ v4l2_ctrl_new_std(hdl, ops, V4L2_CID_HFLIP, 0, 1, 1, 0);
+ if (sensor->hflip_ctrl)
+ sensor->hflip_ctrl->flags |= V4L2_CTRL_FLAG_MODIFY_LAYOUT;
+ sensor->vflip_ctrl =
+ v4l2_ctrl_new_std(hdl, ops, V4L2_CID_VFLIP, 0, 1, 1, 0);
+ if (sensor->vflip_ctrl)
+ sensor->vflip_ctrl->flags |= V4L2_CTRL_FLAG_MODIFY_LAYOUT;
+ v4l2_ctrl_cluster(2, &sensor->hflip_ctrl);
+
+ /* Exposition cluster */
+ sensor->ae_ctrl = v4l2_ctrl_new_std_menu(hdl, ops,
+ V4L2_CID_EXPOSURE_AUTO, 1,
+ ~0x3, V4L2_EXPOSURE_AUTO);
+ sensor->again_ctrl = v4l2_ctrl_new_std(hdl, ops, V4L2_CID_ANALOGUE_GAIN,
+ 0, 0x1c, 1, VD55G_AGAIN_DEF);
+ sensor->dgain_ctrl = v4l2_ctrl_new_std(hdl, ops, V4L2_CID_DIGITAL_GAIN,
+ 256, 0xffff, 1, VD55G_DGAIN_DEF);
+ sensor->expo_ctrl =
+ v4l2_ctrl_new_std(hdl, ops, V4L2_CID_EXPOSURE, 0,
+ VD55G_FRAME_LENGTH_DEF - VD55G_EXPO_MAX_TERM,
+ 1, VD55G_EXPO_DEF);
+ v4l2_ctrl_auto_cluster(4, &sensor->ae_ctrl, V4L2_EXPOSURE_MANUAL, true);
+
+ sensor->patgen_ctrl =
+ v4l2_ctrl_new_std_menu_items(hdl, ops, V4L2_CID_TEST_PATTERN,
+ ARRAY_SIZE(vd55g_tp_menu) - 1, 0,
+ 0, vd55g_tp_menu);
+ ctrl = v4l2_ctrl_new_int_menu(hdl, ops, V4L2_CID_LINK_FREQ, 0, 0,
+ &sensor->link_freq);
+ if (ctrl)
+ ctrl->flags |= V4L2_CTRL_FLAG_READ_ONLY;
+ sensor->pixel_rate_ctrl = v4l2_ctrl_new_std(hdl, ops,
+ V4L2_CID_PIXEL_RATE, 1,
+ INT_MAX, 1, pixel_rate);
+ if (sensor->pixel_rate_ctrl)
+ sensor->pixel_rate_ctrl->flags |= V4L2_CTRL_FLAG_READ_ONLY;
+ sensor->ae_lock_ctrl =
+ v4l2_ctrl_new_std(hdl, ops, V4L2_CID_3A_LOCK, 0, 1, 0, 0);
+ sensor->ae_bias_ctrl =
+ v4l2_ctrl_new_int_menu(hdl, ops, V4L2_CID_AUTO_EXPOSURE_BIAS,
+ ARRAY_SIZE(vd55g_ev_bias_menu) - 1,
+ ARRAY_SIZE(vd55g_ev_bias_menu) / 2,
+ vd55g_ev_bias_menu);
+ if (sensor->info->hdr) {
+ sensor->hdr_ctrl =
+ v4l2_ctrl_new_std_menu_items(hdl, ops,
+ V4L2_CID_HDR_SENSOR_MODE,
+ ARRAY_SIZE(vd55g1_hdr_menu) - 1,
+ 0, VD55G1_NO_HDR,
+ vd55g1_hdr_menu);
+ }
+ hblank = vd55g_get_hblank_min(sensor, format, crop);
+ sensor->hblank_ctrl = v4l2_ctrl_new_std(hdl, ops, V4L2_CID_HBLANK,
+ hblank, hblank, 1, hblank);
+ if (sensor->hblank_ctrl)
+ sensor->hblank_ctrl->flags |= V4L2_CTRL_FLAG_READ_ONLY;
+ vd55g_get_vblank_limits(sensor, crop, &vblank);
+ sensor->vblank_ctrl = v4l2_ctrl_new_std(hdl, ops, V4L2_CID_VBLANK,
+ vblank.min, vblank.max, 1,
+ vblank.def);
+
+ /* Additional controls based on device tree properties */
+ if (sensor->ext_leds_mask) {
+ sensor->led_ctrl =
+ v4l2_ctrl_new_std_menu(hdl, ops,
+ V4L2_CID_FLASH_LED_MODE,
+ V4L2_FLASH_LED_MODE_FLASH, 0,
+ V4L2_FLASH_LED_MODE_NONE);
+ }
+
+ ret = v4l2_fwnode_device_parse(sensor->dev, &fwnode_props);
+ if (ret)
+ goto free_ctrls;
+
+ ret = v4l2_ctrl_new_fwnode_properties(hdl, ops, &fwnode_props);
+ if (ret)
+ goto free_ctrls;
+
+ sensor->sd.ctrl_handler = hdl;
+ goto unlock_state;
+
+free_ctrls:
+ v4l2_ctrl_handler_free(hdl);
+unlock_state:
+ v4l2_subdev_unlock_state(state);
+ return ret;
+}
+
+static int vd55g_detect(struct vd55g *sensor)
+{
+ const struct vd55g_chip_info *info;
+ u64 id;
+ int ret;
+
+ info = device_get_match_data(sensor->dev);
+
+ sensor->info = info;
+
+ ret = vd55g_wait_state(sensor, VD55G_SYSTEM_FSM_READY_TO_BOOT, NULL);
+ if (ret)
+ return ret;
+
+ ret = vd55g_read(sensor, VD55G_REG_MODEL_ID, &id, NULL);
+ if (ret)
+ return ret;
+
+ if (id != sensor->info->id) {
+ dev_err(sensor->dev,
+ "Expected %s (0x%x), but detected mismatched sensor id 0x%x\n",
+ sensor->info->name, (u32)sensor->info->id, (u32)id);
+ return -ENODEV;
+ }
+
+ return 0;
+}
+
+static int vd55g_power_on(struct device *dev)
+{
+ struct v4l2_subdev *sd = dev_get_drvdata(dev);
+ struct vd55g *sensor = to_vd55g(sd);
+ int ret;
+
+ ret = regulator_bulk_enable(ARRAY_SIZE(vd55g_supply_name),
+ sensor->supplies);
+ if (ret) {
+ dev_err(dev, "Failed to enable regulators %d\n", ret);
+ return ret;
+ }
+
+ ret = clk_prepare_enable(sensor->xclk);
+ if (ret) {
+ dev_err(dev, "Failed to enable clock %d\n", ret);
+ goto disable_bulk;
+ }
+
+ gpiod_set_value_cansleep(sensor->reset_gpio, 0);
+ usleep_range(5000, 10000);
+ ret = vd55g_detect(sensor);
+ if (ret) {
+ dev_err(dev, "Sensor detect failed %d\n", ret);
+ goto disable_clock;
+ }
+
+ ret = vd55g_prepare_clock_tree(sensor);
+ if (ret)
+ goto disable_clock;
+
+ /* Setup clock now to advance through system FSM states */
+ vd55g_write(sensor, VD55G_REG_EXT_CLOCK, sensor->xclk_freq, &ret);
+
+ ret = vd55g_boot(sensor);
+ if (ret) {
+ dev_err(dev, "Sensor boot failed %d\n", ret);
+ goto disable_clock;
+ }
+
+ return 0;
+
+disable_clock:
+ gpiod_set_value_cansleep(sensor->reset_gpio, 1);
+ clk_disable_unprepare(sensor->xclk);
+disable_bulk:
+ regulator_bulk_disable(ARRAY_SIZE(vd55g_supply_name), sensor->supplies);
+
+ return ret;
+}
+
+static int vd55g_power_off(struct device *dev)
+{
+ struct v4l2_subdev *sd = dev_get_drvdata(dev);
+ struct vd55g *sensor = to_vd55g(sd);
+
+ gpiod_set_value_cansleep(sensor->reset_gpio, 1);
+ clk_disable_unprepare(sensor->xclk);
+ regulator_bulk_disable(ARRAY_SIZE(sensor->supplies), sensor->supplies);
+
+ return 0;
+}
+
+static int vd55g_check_csi_conf(struct vd55g *sensor,
+ struct fwnode_handle *endpoint)
+{
+ struct v4l2_fwnode_endpoint ep = { .bus_type = V4L2_MBUS_CSI2_DPHY };
+ u8 n_lanes;
+ int ret;
+
+ ret = v4l2_fwnode_endpoint_alloc_parse(endpoint, &ep);
+ fwnode_handle_put(endpoint);
+ if (ret)
+ return ret;
+
+ /* Check lanes number */
+ n_lanes = ep.bus.mipi_csi2.num_data_lanes;
+ if (n_lanes != 1) {
+ dev_err(sensor->dev, "Sensor only supports 1 lane, found %d\n",
+ n_lanes);
+ ret = -EINVAL;
+ goto done;
+ }
+
+ /* Clock lane must be first */
+ if (ep.bus.mipi_csi2.clock_lane != 0) {
+ dev_err(sensor->dev, "Clock lane must be mapped to lane 0\n");
+ ret = -EINVAL;
+ goto done;
+ }
+
+ /* Handle polarities in sensor configuration */
+ sensor->oif_ctrl = (ep.bus.mipi_csi2.lane_polarities[0] << 3) |
+ (ep.bus.mipi_csi2.lane_polarities[1] << 6);
+
+ /* Check the link frequency set in device tree */
+ if (!ep.nr_of_link_frequencies) {
+ dev_err(sensor->dev,
+ "link-frequency property not found in DT\n");
+ ret = -EINVAL;
+ goto done;
+ }
+ if (ep.nr_of_link_frequencies != 1) {
+ dev_err(sensor->dev,
+ "Multiple link frequencies not supported\n");
+ ret = -EINVAL;
+ goto done;
+ }
+ sensor->link_freq = ep.link_frequencies[0];
+
+done:
+ v4l2_fwnode_endpoint_free(&ep);
+
+ return ret;
+}
+
+static int vd55g_parse_dt_gpios_array(struct vd55g *sensor, char *prop_name,
+ u32 *array, int *nb)
+{
+ unsigned int i;
+ int ret;
+
+ *nb = device_property_count_u32(sensor->dev, prop_name);
+ if (*nb == -EINVAL) {
+ /* Property not found */
+ *nb = 0;
+ return 0;
+ }
+
+ ret = device_property_read_u32_array(sensor->dev, prop_name, array,
+ *nb);
+ if (ret) {
+ dev_err(sensor->dev, "Failed to read %s prop\n", prop_name);
+ return ret;
+ }
+ for (i = 0; i < *nb; i++) {
+ if (array[i] >= VD55G_NB_GPIOS) {
+ dev_err(sensor->dev, "Invalid GPIO number %d\n",
+ array[i]);
+ return -EINVAL;
+ }
+ }
+
+ return 0;
+}
+
+static int vd55g_parse_dt_gpios(struct vd55g *sensor)
+{
+ u32 led_gpios[VD55G_NB_GPIOS];
+ int nb_gpios_leds;
+ unsigned int i;
+ int ret;
+
+ /* Initialize GPIOs to default */
+ for (i = 0; i < VD55G_NB_GPIOS; i++)
+ sensor->gpios[i] = VD55G_GPIO_MODE_IN;
+ sensor->ext_leds_mask = 0;
+
+ /* Take into account optional 'st,leds' output for GPIOs */
+ ret = vd55g_parse_dt_gpios_array(sensor, "st,leds", led_gpios,
+ &nb_gpios_leds);
+ if (ret)
+ return ret;
+
+ for (i = 0; i < nb_gpios_leds; i++) {
+ sensor->gpios[led_gpios[i]] = VD55G_GPIO_MODE_STROBE;
+ set_bit(led_gpios[i], &sensor->ext_leds_mask);
+ }
+
+ if (nb_gpios_leds == 0) {
+ sensor->gpios[1] = VD55G_GPIO_MODE_STROBE;
+ set_bit(1, &sensor->ext_leds_mask);
+ }
+
+ return 0;
+}
+
+static int vd55g_parse_dt(struct vd55g *sensor)
+{
+ struct fwnode_handle *endpoint;
+ int ret;
+
+ endpoint =
+ fwnode_graph_get_next_endpoint(dev_fwnode(sensor->dev), NULL);
+ if (!endpoint)
+ return dev_err_probe(sensor->dev, -EPROBE_DEFER,
+ "waiting for fwnode graph endpoint\n");
+
+ ret = vd55g_check_csi_conf(sensor, endpoint);
+ if (ret)
+ return ret;
+
+ return vd55g_parse_dt_gpios(sensor);
+}
+
+static int vd55g_subdev_init(struct vd55g *sensor)
+{
+ int ret;
+
+ /* Init sub device */
+ sensor->sd.flags |= V4L2_SUBDEV_FL_HAS_DEVNODE;
+ sensor->sd.internal_ops = &vd55g_internal_ops;
+
+ /* Init source pad */
+ sensor->pad.flags = MEDIA_PAD_FL_SOURCE;
+ sensor->sd.entity.function = MEDIA_ENT_F_CAM_SENSOR;
+ ret = media_entity_pads_init(&sensor->sd.entity, 1, &sensor->pad);
+ if (ret) {
+ dev_err(sensor->dev, "Failed to init media entity: %d\n", ret);
+ return ret;
+ }
+
+ sensor->sd.state_lock = sensor->ctrl_handler.lock;
+ ret = v4l2_subdev_init_finalize(&sensor->sd);
+ if (ret) {
+ dev_err(sensor->dev, "Subdev init error: %d\n", ret);
+ goto err_ctrls;
+ }
+
+ /*
+ * Initialize controls after v4l2_subdev_init_finalize() to make sure
+ * active state is set
+ */
+ ret = vd55g_init_ctrls(sensor);
+ if (ret) {
+ dev_err(sensor->dev, "Controls initialization failed %d\n",
+ ret);
+ goto err_media;
+ }
+
+ return 0;
+
+err_ctrls:
+ v4l2_ctrl_handler_free(sensor->sd.ctrl_handler);
+
+err_media:
+ media_entity_cleanup(&sensor->sd.entity);
+ return ret;
+}
+
+static void vd55g_subdev_cleanup(struct vd55g *sensor)
+{
+ v4l2_async_unregister_subdev(&sensor->sd);
+ v4l2_subdev_cleanup(&sensor->sd);
+ media_entity_cleanup(&sensor->sd.entity);
+ v4l2_ctrl_handler_free(sensor->sd.ctrl_handler);
+}
+
+static int vd55g_get_regulators(struct vd55g *sensor)
+{
+ unsigned int i;
+
+ for (i = 0; i < ARRAY_SIZE(vd55g_supply_name); i++)
+ sensor->supplies[i].supply = vd55g_supply_name[i];
+
+ return devm_regulator_bulk_get(sensor->dev,
+ ARRAY_SIZE(vd55g_supply_name),
+ sensor->supplies);
+}
+
+static int vd55g_probe(struct i2c_client *client)
+{
+ struct device *dev = &client->dev;
+ struct vd55g *sensor;
+ int ret;
+
+ sensor = devm_kzalloc(dev, sizeof(*sensor), GFP_KERNEL);
+ if (!sensor)
+ return -ENOMEM;
+ sensor->dev = &client->dev;
+
+ v4l2_i2c_subdev_init(&sensor->sd, client, &vd55g_subdev_ops);
+
+ ret = vd55g_parse_dt(sensor);
+ if (ret)
+ return dev_err_probe(dev, ret, "Failed to parse Device Tree\n");
+
+ /* Get (and check) resources : power regs, ext clock, reset gpio */
+ ret = vd55g_get_regulators(sensor);
+ if (ret)
+ return dev_err_probe(dev, ret, "Failed to get regulators\n");
+
+ sensor->xclk = devm_v4l2_sensor_clk_get(dev, NULL);
+ if (IS_ERR(sensor->xclk))
+ return dev_err_probe(dev, PTR_ERR(sensor->xclk),
+ "Failed to get xclk\n");
+
+ sensor->xclk_freq = clk_get_rate(sensor->xclk);
+
+ sensor->reset_gpio =
+ devm_gpiod_get_optional(dev, "reset", GPIOD_OUT_HIGH);
+ if (IS_ERR(sensor->reset_gpio))
+ return dev_err_probe(dev, PTR_ERR(sensor->reset_gpio),
+ "Failed to get reset gpio\n");
+
+ sensor->regmap = devm_cci_regmap_init_i2c(client, 16);
+ if (IS_ERR(sensor->regmap))
+ return dev_err_probe(dev, PTR_ERR(sensor->regmap),
+ "Failed to init regmap\n");
+
+ /* Detect if sensor is present and if its revision is supported */
+ ret = vd55g_power_on(dev);
+ if (ret)
+ return ret;
+
+ /* Enable pm_runtime and power off the sensor */
+ pm_runtime_set_active(dev);
+ pm_runtime_get_noresume(dev);
+ pm_runtime_enable(dev);
+ pm_runtime_set_autosuspend_delay(dev, 4000);
+ pm_runtime_use_autosuspend(dev);
+ pm_runtime_put_autosuspend(dev);
+
+ ret = vd55g_subdev_init(sensor);
+ if (ret) {
+ dev_err(dev, "V4l2 init failed: %d\n", ret);
+ goto err_power_off;
+ }
+
+ ret = v4l2_async_register_subdev(&sensor->sd);
+ if (ret) {
+ dev_err(dev, "async subdev register failed %d\n", ret);
+ goto err_subdev;
+ }
+
+ return 0;
+
+err_subdev:
+ vd55g_subdev_cleanup(sensor);
+err_power_off:
+ pm_runtime_disable(dev);
+ pm_runtime_put_noidle(dev);
+ pm_runtime_dont_use_autosuspend(dev);
+ vd55g_power_off(dev);
+
+ return ret;
+}
+
+static void vd55g_remove(struct i2c_client *client)
+{
+ struct v4l2_subdev *sd = i2c_get_clientdata(client);
+ struct vd55g *sensor = to_vd55g(sd);
+
+ vd55g_subdev_cleanup(sensor);
+
+ pm_runtime_disable(&client->dev);
+ if (!pm_runtime_status_suspended(&client->dev))
+ vd55g_power_off(&client->dev);
+ pm_runtime_set_suspended(&client->dev);
+ pm_runtime_dont_use_autosuspend(&client->dev);
+}
+
+static const struct acpi_device_id vd55g_acpi_match[] = {
+ { "SMO55F0", (kernel_ulong_t)&vd55g0_chip_info },
+ { /* sentinel */ }
+};
+MODULE_DEVICE_TABLE(acpi, vd55g_acpi_match);
+
+static const struct of_device_id vd55g_dt_ids[] = {
+ { .compatible = "st,vd55g0", .data = &vd55g0_chip_info },
+ { .compatible = "st,vd55g1", .data = &vd55g1_chip_info },
+ { .compatible = "st,vd65g4", .data = &vd65g4_chip_info },
+ { /* sentinel */ }
+};
+MODULE_DEVICE_TABLE(of, vd55g_dt_ids);
+
+static const struct dev_pm_ops vd55g_pm_ops = {
+ SET_RUNTIME_PM_OPS(vd55g_power_off, vd55g_power_on, NULL)
+};
+
+static struct i2c_driver vd55g_i2c_driver = {
+ .driver = {
+ .name = "vd55g",
+ .acpi_match_table = vd55g_acpi_match,
+ .of_match_table = vd55g_dt_ids,
+ .pm = &vd55g_pm_ops,
+ },
+ .probe = vd55g_probe,
+ .remove = vd55g_remove,
+};
+
+module_i2c_driver(vd55g_i2c_driver);
+
+MODULE_AUTHOR("Peter Marshall <pm@petermarshall.ca>");
+MODULE_AUTHOR("Benjamin Mugnier <benjamin.mugnier@foss.st.com>");
+MODULE_AUTHOR("Sylvain Petinot <sylvain.petinot@foss.st.com>");
+MODULE_DESCRIPTION("VD55G camera subdev driver");
+MODULE_FIRMWARE("vd55g0-cut1.bin");
+MODULE_FIRMWARE("vd55g0-cut2.bin");
+MODULE_FIRMWARE("vd55g1.bin");
+MODULE_LICENSE("GPL");
--
2.55.0
next prev parent reply other threads:[~2026-09-02 20:48 UTC|newest]
Thread overview: 16+ messages / expand[flat|nested] mbox.gz Atom feed top
2026-09-02 20:45 [PATCH 0/7] media: i2c: st-vd55g1: Genericize driver and add VD55G0 support Peter Marshall
2026-09-02 20:45 ` [PATCH 1/7] media: i2c: vd55g: move patch array to a separate firmware header Peter Marshall
2026-09-03 13:37 ` Krzysztof Kozlowski
2026-09-02 20:45 ` [PATCH 2/7] dt-bindings: media: i2c: st,vd55g: rename and add VD55G0 variant Peter Marshall
2026-09-03 13:36 ` Krzysztof Kozlowski
2026-09-02 20:45 ` [PATCH 3/7] media: ipu-bridge: Add VD55G0 to the list of supported sensors Peter Marshall
2026-09-02 20:45 ` [PATCH 4/7] platform/x86: int3472: Add VD55G0 supply GPIO mapping Peter Marshall
2026-09-02 20:45 ` Peter Marshall [this message]
2026-09-03 13:41 ` [PATCH 5/7] media: i2c: st-vd55g: Add generic driver and VD55G0 support Krzysztof Kozlowski
2026-09-11 23:16 ` Peter Marshall
2026-09-02 20:45 ` [PATCH 6/7] media: i2c: st-vd55g: Remove legacy vd55g1 remnants Peter Marshall
2026-09-03 13:43 ` Krzysztof Kozlowski
2026-09-02 20:45 ` [PATCH 7/7] MAINTAINERS: Update ST VD55G camera driver entry Peter Marshall
2026-09-03 13:43 ` Krzysztof Kozlowski
2026-09-04 12:06 ` [PATCH 0/7] media: i2c: st-vd55g1: Genericize driver and add VD55G0 support Benjamin Mugnier
[not found] ` <DL6TUYCM6AE9.3SFNKPI5T7CVS@petermarshall.ca>
2026-09-08 8:48 ` Benjamin Mugnier
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20260902204549.657228-6-pm@petermarshall.ca \
--to=pm@petermarshall.ca \
--cc=benjamin.mugnier@foss.st.com \
--cc=devicetree@vger.kernel.org \
--cc=linux-kernel@vger.kernel.org \
--cc=linux-media@vger.kernel.org \
--cc=mchehab@kernel.org \
--cc=platform-driver-x86@vger.kernel.org \
--cc=sakari.ailus@linux.intel.com \
--cc=sylvain.petinot@foss.st.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.