// SPDX-License-Identifier: GPL-2.0-only // SPDX-FileCopyrightText: Copyright (c) 2018-2025, NVIDIA CORPORATION & AFFILIATES. All rights reserved. /* * imx390.c - imx390 sensor driver * Copyright (c) 2020, RidgeRun. All rights reserved. * */ #include #include #include #include #include #include #include #include #include #include #include #include "../platform/tegra/camera/camera_gpio.h" #include "imx390_mode_tbls.h" /* imx390 sensor register address */ #define IMX390_PGA_GAIN_SP1H 0x0024 #define IMX390_COARSE_TIME_SHS1_ADDR_MSB 0x000E #define IMX390_COARSE_TIME_SHS1_ADDR_MID 0x000D #define IMX390_COARSE_TIME_SHS1_ADDR_LSB 0x000C #define IMX390_COARSE_TIME_SHS2_ADDR_MSB 0x0012 #define IMX390_COARSE_TIME_SHS2_ADDR_MID 0x0011 #define IMX390_COARSE_TIME_SHS2_ADDR_LSB 0x0010 #define IMX390_GROUP_HOLD_ADDR 0x0008 #define IMX390_DEFAULT_FRAME_LENGTH (1250) static const struct of_device_id imx390_of_match[] = { {.compatible = "sony,imx390",}, {}, }; MODULE_DEVICE_TABLE(of, imx390_of_match); static const u32 ctrl_cid_list[] = { TEGRA_CAMERA_CID_GAIN, TEGRA_CAMERA_CID_EXPOSURE, TEGRA_CAMERA_CID_EXPOSURE_SHORT, TEGRA_CAMERA_CID_FRAME_RATE, TEGRA_CAMERA_CID_HDR_EN, TEGRA_CAMERA_CID_SENSOR_MODE_ID, }; struct imx390 { struct i2c_client *i2c_client; struct v4l2_subdev *subdev; u16 fine_integ_time; u32 frame_length; struct camera_common_data *s_data; struct tegracam_device *tc_dev; }; static const struct regmap_config sensor_regmap_config = { .reg_bits = 16, .val_bits = 8, .cache_type = REGCACHE_NONE, }; static inline void imx390_get_coarse_time_regs_shs1(imx390_reg *regs, u32 coarse_time) { regs->addr = IMX390_COARSE_TIME_SHS1_ADDR_MSB; regs->val = (coarse_time >> 16) & 0x0f; (regs + 1)->addr = IMX390_COARSE_TIME_SHS1_ADDR_MID; (regs + 1)->val = (coarse_time >> 8) & 0xff; (regs + 2)->addr = IMX390_COARSE_TIME_SHS1_ADDR_LSB; (regs + 2)->val = (coarse_time) & 0xff; } static inline void imx390_get_coarse_time_regs_shs2(imx390_reg *regs, u32 coarse_time) { regs->addr = IMX390_COARSE_TIME_SHS2_ADDR_MSB; regs->val = (coarse_time >> 16) & 0x0f; (regs + 1)->addr = IMX390_COARSE_TIME_SHS2_ADDR_MID; (regs + 1)->val = (coarse_time >> 8) & 0xff; (regs + 2)->addr = IMX390_COARSE_TIME_SHS2_ADDR_LSB; (regs + 2)->val = (coarse_time) & 0xff; } static inline void imx390_get_gain_reg(imx390_reg *regs, u16 gain) { regs->addr = IMX390_PGA_GAIN_SP1H + 1; regs->val = (gain >> 8) & 0x03; (regs + 1)->addr = IMX390_PGA_GAIN_SP1H; (regs + 1)->val = gain & 0xff; } static inline int imx390_read_reg(struct camera_common_data *s_data, u16 addr, u8 *val) { int err = 0; u32 reg_val = 0; err = regmap_read(s_data->regmap, addr, ®_val); *val = reg_val & 0xff; return err; } static inline int imx390_write_reg(struct camera_common_data *s_data, u16 addr, u8 val) { int err = 0; err = regmap_write(s_data->regmap, addr, val); if (err) dev_err(s_data->dev, "%s: i2c write failed, 0x%x = %x\n", __func__, addr, val); return err; } static int imx390_write_table(struct imx390 *priv, const imx390_reg table[]) { struct tegracam_device *tc_dev = priv->tc_dev; struct device *dev = tc_dev->dev; int i = 0; int ret = 0; int retry; while (table[i].addr != IMX390_TABLE_END) { retry = 5; if (table[i].addr == IMX390_TABLE_WAIT_MS) { dev_dbg(dev, "%s: sleep %d\n", __func__, table[i].val); msleep(table[i].val); i++; continue; } do { ret = imx390_write_reg(priv->s_data, table[i].addr, table[i].val); if (!ret) break; dev_warn(dev, "imx390_write_reg: try %d\n", retry); msleep(4); retry--; } while (retry > 0); if (retry == 0 && ret) return -EINVAL; i++; } return 0; } static int imx390_set_group_hold(struct tegracam_device *tc_dev, bool val) { struct camera_common_data *s_data = tc_dev->s_data; struct device *dev = tc_dev->dev; int err; err = imx390_write_reg(s_data, IMX390_GROUP_HOLD_ADDR, val); if (err) { dev_dbg(dev, "%s: Group hold control error\n", __func__); return err; } return 0; } static int imx390_set_gain(struct tegracam_device *tc_dev, s64 val) { struct camera_common_data *s_data = tc_dev->s_data; struct device *dev = tc_dev->dev; const struct sensor_mode_properties *mode = &s_data->sensor_props.sensor_modes[s_data->mode_prop_idx]; imx390_reg reg_list[2]; int err, i; u16 gain; gain = (u16)(val / mode->control_properties.step_gain_val); dev_dbg(dev, "%s: val: %lld db: %d\n", __func__, val, gain); imx390_get_gain_reg(reg_list, gain); for (i = 0; i < 2; i++) { err = imx390_write_reg(s_data, reg_list[i].addr, reg_list[i].val); if (err) goto fail; } return 0; fail: dev_info(dev, "%s: GAIN control error\n", __func__); return err; } static int imx390_set_frame_rate(struct tegracam_device *tc_dev, s64 val) { struct imx390 *priv = (struct imx390 *)tegracam_get_privdata(tc_dev); priv->frame_length = IMX390_DEFAULT_FRAME_LENGTH; return 0; } static int imx390_set_exposure(struct tegracam_device *tc_dev, s64 val) { struct imx390 *priv = (struct imx390 *)tegracam_get_privdata(tc_dev); struct camera_common_data *s_data = tc_dev->s_data; const struct sensor_mode_properties *mode = &s_data->sensor_props.sensor_modes[s_data->mode]; imx390_reg reg_list[3]; int err; u32 coarse_time; u32 shs1; int i; /* coarse time in lines */ coarse_time = (u32) (val * s_data->frmfmt[s_data->mode].framerates[0] * priv->frame_length / mode->control_properties.exposure_factor); shs1 = priv->frame_length - coarse_time; /* 0 to 3 are prohibited */ if (shs1 < 4) shs1 = 4; /* over VMAX-5 is prohibited */ if (shs1 > priv->frame_length - 5) shs1 = priv->frame_length - 5; imx390_get_coarse_time_regs_shs1(reg_list, shs1); for (i = 0; i < 3; i++) { err = imx390_write_reg(priv->s_data, reg_list[i].addr, reg_list[i].val); if (err) goto fail; } imx390_get_coarse_time_regs_shs2(reg_list, shs1); for (i = 0; i < 3; i++) { err = imx390_write_reg(priv->s_data, reg_list[i].addr, reg_list[i].val); if (err) goto fail; } dev_dbg(tc_dev->dev, "%s: val=%lld shs1=%u coarse_time=%u frame_len=%u\n", __func__, val, shs1, coarse_time, priv->frame_length); return 0; fail: dev_dbg(&priv->i2c_client->dev, "%s: set coarse time error\n", __func__); return err; } static int imx390_set_exposure_short(struct tegracam_device *tc_dev, s64 val) { struct imx390 *priv = (struct imx390 *)tegracam_get_privdata(tc_dev); struct camera_common_data *s_data = tc_dev->s_data; const struct sensor_mode_properties *mode = &s_data->sensor_props.sensor_modes[s_data->mode]; imx390_reg reg_list[3]; int err; u32 coarse_time; u32 shs1; int i; /* coarse time in lines */ coarse_time = (u32) (val * s_data->frmfmt[s_data->mode].framerates[0] * priv->frame_length / mode->control_properties.exposure_factor); shs1 = priv->frame_length - coarse_time; /* 0 to 3 are prohibited */ if (shs1 < 4) shs1 = 4; /* over VMAX-5 is prohibited */ if (shs1 > priv->frame_length - 5) shs1 = priv->frame_length - 5; imx390_get_coarse_time_regs_shs2(reg_list, shs1); for (i = 0; i < 3; i++) { err = imx390_write_reg(priv->s_data, reg_list[i].addr, reg_list[i].val); if (err) goto fail; } return 0; fail: dev_dbg(&priv->i2c_client->dev, "%s: set coarse time error\n", __func__); return err; } static struct tegracam_ctrl_ops imx390_ctrl_ops = { .numctrls = ARRAY_SIZE(ctrl_cid_list), .ctrl_cid_list = ctrl_cid_list, .set_gain = imx390_set_gain, .set_exposure = imx390_set_exposure, .set_exposure_short = imx390_set_exposure_short, .set_frame_rate = imx390_set_frame_rate, .set_group_hold = imx390_set_group_hold, }; static int imx390_power_on(struct camera_common_data *s_data) { int err = 0; struct camera_common_power_rail *pw = s_data->power; struct camera_common_pdata *pdata = s_data->pdata; struct device *dev = s_data->dev; dev_err(dev, "%s: power on\n", __func__); if (pdata && pdata->power_on) { err = pdata->power_on(pw); if (err) dev_err(dev, "%s failed.\n", __func__); else pw->state = SWITCH_ON; return err; } if (gpio_is_valid(pw->reset_gpio)) { if (gpiod_cansleep(gpio_to_desc(pw->reset_gpio))) gpio_set_value_cansleep(pw->reset_gpio, 0); else gpio_set_value(pw->reset_gpio, 0); } if (unlikely(!(pw->avdd || pw->iovdd || pw->dvdd))) goto skip_power_seqn; usleep_range(10, 20); if (pw->avdd) { err = regulator_enable(pw->avdd); if (err) goto imx390_avdd_fail; } if (pw->iovdd) { err = regulator_enable(pw->iovdd); if (err) goto imx390_iovdd_fail; } if (pw->dvdd) { err = regulator_enable(pw->dvdd); if (err) goto imx390_dvdd_fail; } usleep_range(10, 20); skip_power_seqn: if (gpio_is_valid(pw->reset_gpio)) { if (gpiod_cansleep(gpio_to_desc(pw->reset_gpio))) gpio_set_value_cansleep(pw->reset_gpio, 1); else gpio_set_value(pw->reset_gpio, 1); } /* Need to wait for t4 + t5 + t9 + t10 time as per the data sheet */ /* t4 - 200us, t5 - 21.2ms, t9 - 1.2ms t10 - 270 ms */ usleep_range(300000, 300100); pw->state = SWITCH_ON; return 0; imx390_dvdd_fail: regulator_disable(pw->iovdd); imx390_iovdd_fail: regulator_disable(pw->avdd); imx390_avdd_fail: dev_err(dev, "%s failed.\n", __func__); return -ENODEV; } static int imx390_power_off(struct camera_common_data *s_data) { int err = 0; struct camera_common_power_rail *pw = s_data->power; struct camera_common_pdata *pdata = s_data->pdata; struct device *dev = s_data->dev; dev_dbg(dev, "%s: power off\n", __func__); if (pdata && pdata->power_off) { err = pdata->power_off(pw); if (err) { dev_err(dev, "%s failed.\n", __func__); return err; } } else { if (pw->reset_gpio) { if (gpiod_cansleep(gpio_to_desc(pw->reset_gpio))) gpio_set_value_cansleep(pw->reset_gpio, 0); else gpio_set_value(pw->reset_gpio, 0); } usleep_range(10, 10); if (pw->dvdd) regulator_disable(pw->dvdd); if (pw->iovdd) regulator_disable(pw->iovdd); if (pw->avdd) regulator_disable(pw->avdd); } pw->state = SWITCH_OFF; return 0; } static int imx390_power_put(struct tegracam_device *tc_dev) { struct camera_common_data *s_data = tc_dev->s_data; struct camera_common_power_rail *pw = s_data->power; if (unlikely(!pw)) return -EFAULT; if (likely(pw->dvdd)) devm_regulator_put(pw->dvdd); if (likely(pw->avdd)) devm_regulator_put(pw->avdd); if (likely(pw->iovdd)) devm_regulator_put(pw->iovdd); pw->dvdd = NULL; pw->avdd = NULL; pw->iovdd = NULL; if (likely(pw->reset_gpio)) gpio_free(pw->reset_gpio); return 0; } static int imx390_power_get(struct tegracam_device *tc_dev) { struct device *dev = tc_dev->dev; struct camera_common_data *s_data = tc_dev->s_data; struct camera_common_power_rail *pw = s_data->power; struct camera_common_pdata *pdata = s_data->pdata; struct clk *parent; int err = 0; if (!pdata) { dev_err(dev, "pdata missing\n"); return -EFAULT; } /* Sensor MCLK (aka. INCK) */ if (pdata->mclk_name) { pw->mclk = devm_clk_get(dev, pdata->mclk_name); if (IS_ERR(pw->mclk)) { dev_err(dev, "unable to get clock %s\n", pdata->mclk_name); return PTR_ERR(pw->mclk); } if (pdata->parentclk_name) { parent = devm_clk_get(dev, pdata->parentclk_name); if (IS_ERR(parent)) { dev_err(dev, "unable to get parent clock %s", pdata->parentclk_name); } else clk_set_parent(pw->mclk, parent); } } /* analog 2.8v */ if (pdata->regulators.avdd) err |= camera_common_regulator_get(dev, &pw->avdd, pdata->regulators.avdd); /* IO 1.8v */ if (pdata->regulators.iovdd) err |= camera_common_regulator_get(dev, &pw->iovdd, pdata->regulators.iovdd); /* dig 1.2v */ if (pdata->regulators.dvdd) err |= camera_common_regulator_get(dev, &pw->dvdd, pdata->regulators.dvdd); if (err) dev_err(dev, "%s: unable to get regulator(s)\n", __func__); return err; } static struct camera_common_pdata *imx390_parse_dt(struct tegracam_device *tc_dev) { struct device *dev = tc_dev->dev; struct device_node *np = dev->of_node; struct camera_common_pdata *board_priv_pdata; const struct of_device_id *match; int err = 0; if (!np) return NULL; match = of_match_device(imx390_of_match, dev); if (!match) { dev_err(dev, "Failed to find matching dt id\n"); return NULL; } board_priv_pdata = devm_kzalloc(dev, sizeof(*board_priv_pdata), GFP_KERNEL); if (!board_priv_pdata) return NULL; err = of_property_read_string(np, "mclk", &board_priv_pdata->mclk_name); if (err) dev_dbg(dev, "mclk name not present, " "assume sensor driven externally\n"); err = of_property_read_string(np, "avdd-reg", &board_priv_pdata->regulators.avdd); err |= of_property_read_string(np, "iovdd-reg", &board_priv_pdata->regulators.iovdd); err |= of_property_read_string(np, "dvdd-reg", &board_priv_pdata->regulators.dvdd); if (err) dev_dbg(dev, "avdd, iovdd and/or dvdd reglrs. not present, " "assume sensor powered independently\n"); board_priv_pdata->has_eeprom = of_property_read_bool(np, "has-eeprom"); return board_priv_pdata; } static int imx390_set_mode(struct tegracam_device *tc_dev) { struct imx390 *priv = (struct imx390 *)tegracam_get_privdata(tc_dev); struct camera_common_data *s_data = tc_dev->s_data; int err = 0; dev_dbg(tc_dev->dev, "%s:\n", __func__); err = imx390_write_table(priv, mode_table[s_data->mode]); if (err) { dev_err(tc_dev->dev, "%s: sensor write table failed with error %d\n", __func__, err); return err; } return 0; } static int imx390_start_streaming(struct tegracam_device *tc_dev) { struct imx390 *priv = (struct imx390 *)tegracam_get_privdata(tc_dev); dev_dbg(tc_dev->dev, "%s:\n", __func__); return imx390_write_table(priv, mode_table[IMX390_MODE_START_STREAM]); } static int imx390_stop_streaming(struct tegracam_device *tc_dev) { int err; struct imx390 *priv = (struct imx390 *)tegracam_get_privdata(tc_dev); dev_dbg(tc_dev->dev, "%s:\n", __func__); err = imx390_write_table(priv, mode_table[IMX390_MODE_STOP_STREAM]); return err; } static struct camera_common_sensor_ops imx390_common_ops = { .numfrmfmts = ARRAY_SIZE(imx390_frmfmt), .frmfmt_table = imx390_frmfmt, .power_on = imx390_power_on, .power_off = imx390_power_off, .write_reg = imx390_write_reg, .read_reg = imx390_read_reg, .parse_dt = imx390_parse_dt, .power_get = imx390_power_get, .power_put = imx390_power_put, .set_mode = imx390_set_mode, .start_streaming = imx390_start_streaming, .stop_streaming = imx390_stop_streaming, }; static int imx390_board_setup(struct imx390 *priv) { struct camera_common_data *s_data = priv->s_data; struct device *dev = s_data->dev; int err = 0; /* Skip mclk enable as this camera has an internal oscillator */ err = imx390_power_on(s_data); if (err) dev_err(dev, "error during power on sensor (%d)\n", err); return err; } static int imx390_open(struct v4l2_subdev *sd, struct v4l2_subdev_fh *fh) { struct i2c_client *client = v4l2_get_subdevdata(sd); dev_dbg(&client->dev, "%s:\n", __func__); return 0; } static const struct v4l2_subdev_internal_ops imx390_subdev_internal_ops = { .open = imx390_open, }; #if defined(NV_I2C_DRIVER_STRUCT_PROBE_WITHOUT_I2C_DEVICE_ID_ARG) /* Linux 6.3 */ static int imx390_probe(struct i2c_client *client) #else static int imx390_probe(struct i2c_client *client, const struct i2c_device_id *id) #endif { struct device *dev = &client->dev; struct tegracam_device *tc_dev; struct imx390 *priv; int err; dev_dbg(dev, "probing v4l2 sensor at addr 0x%0x\n", client->addr); if (!IS_ENABLED(CONFIG_OF) || !client->dev.of_node) return -EINVAL; priv = devm_kzalloc(dev, sizeof(struct imx390), GFP_KERNEL); if (!priv) return -ENOMEM; tc_dev = devm_kzalloc(dev, sizeof(struct tegracam_device), GFP_KERNEL); if (!tc_dev) return -ENOMEM; priv->i2c_client = tc_dev->client = client; tc_dev->dev = dev; strscpy(tc_dev->name, "imx390", sizeof(tc_dev->name)); tc_dev->dev_regmap_config = &sensor_regmap_config; tc_dev->sensor_ops = &imx390_common_ops; tc_dev->v4l2sd_internal_ops = &imx390_subdev_internal_ops; tc_dev->tcctrl_ops = &imx390_ctrl_ops; err = tegracam_device_register(tc_dev); if (err) { dev_err(dev, "tegra camera driver registration failed\n"); return err; } priv->tc_dev = tc_dev; priv->s_data = tc_dev->s_data; priv->subdev = &tc_dev->s_data->subdev; tegracam_set_privdata(tc_dev, (void *)priv); err = imx390_board_setup(priv); if (err) { dev_err(dev, "board setup failed\n"); return err; } err = tegracam_v4l2subdev_register(tc_dev, true); if (err) { tegracam_device_unregister(tc_dev); dev_err(dev, "tegra camera subdev registration failed\n"); return err; } dev_dbg(dev, "detected imx390 sensor\n"); return 0; } #if defined(NV_I2C_DRIVER_STRUCT_REMOVE_RETURN_TYPE_INT) /* Linux 6.1 */ static int imx390_remove(struct i2c_client *client) #else static void imx390_remove(struct i2c_client *client) #endif { struct camera_common_data *s_data = to_camera_common_data(&client->dev); struct imx390 *priv = (struct imx390 *)s_data->priv; tegracam_v4l2subdev_unregister(priv->tc_dev); tegracam_device_unregister(priv->tc_dev); #if defined(NV_I2C_DRIVER_STRUCT_REMOVE_RETURN_TYPE_INT) /* Linux 6.1 */ return 0; #endif } static const struct i2c_device_id imx390_id[] = { {"imx390", 0}, {} }; MODULE_DEVICE_TABLE(i2c, imx390_id); static struct i2c_driver imx390_i2c_driver = { .driver = { .name = "imx390", .owner = THIS_MODULE, .of_match_table = of_match_ptr(imx390_of_match), }, .probe = imx390_probe, .remove = imx390_remove, .id_table = imx390_id, }; module_i2c_driver(imx390_i2c_driver); MODULE_DESCRIPTION("Media Controller driver for Sony IMX390"); MODULE_AUTHOR("NVIDIA Corporation"); MODULE_LICENSE("GPL v2");