Re: [PATCH v11 2/2] media: i2c: Add driver for AMS-OSRAM Mira220

[Sakari Ailus]

Hi Jacopo,

Just a few comments...

On Fri, Jul 31, 2026 at 05:28:20PM +0200, Jacopo Mondi wrote:
> From: Philippe Baetens <philippebaetens@xxxxxxxxx>
> 
> Add a V4L2 subdev driver for driver for the AMS-OSRAM Mira220 image
> sensor.
> 
> Mira220 is a global shutter image sensor with a resolution of 1600x1400
> pixels.
> 
> The driver implements support for mono and RGB 12, 10 and 8 bits
> formats. The output data-rate per lane is 1500Mbit/s, with a maximum
> frame rate up to 90 fps.
> 
> Signed-off-by: Philippe Baetens <philippebaetens@xxxxxxxxx>

Should there be Co-developed-by: tag here?

> Signed-off-by: Jacopo Mondi <jacopo.mondi@xxxxxxxxxxxxxxxx>
> Reviewed-by: Jai Luthra <jai.luthra@xxxxxxxxxxxxxxxx>
> 

...

> +/* Initialize control handlers */
> +static int mira220_init_controls(struct mira220 *mira220)
> +{
> +	struct i2c_client *client = v4l2_get_subdevdata(&mira220->sd);
> +	struct v4l2_ctrl_handler *ctrl_hdlr;
> +	struct v4l2_fwnode_device_properties props;
> +	struct v4l2_ctrl *link_freq;
> +	struct v4l2_ctrl *hblank;
> +	u32 max_exposure = 0;
> +	u32 min_vblank;
> +	u32 hblank_val;
> +	int ret;
> +
> +	ctrl_hdlr = &mira220->ctrl_handler;
> +	ret = v4l2_ctrl_handler_init(ctrl_hdlr, 12);
> +	if (ret)
> +		return ret;
> +
> +	/* By default, PIXEL_RATE is read only */
> +	v4l2_ctrl_new_std(ctrl_hdlr, &mira220_ctrl_ops, V4L2_CID_PIXEL_RATE,
> +			  MIRA220_PIXEL_RATE, MIRA220_PIXEL_RATE, 1,
> +			  MIRA220_PIXEL_RATE);
> +
> +	min_vblank = mira220_calc_min_vblank(mira220);
> +	mira220->vblank = v4l2_ctrl_new_std(ctrl_hdlr, &mira220_ctrl_ops,
> +					    V4L2_CID_VBLANK,
> +					    min_vblank, MIRA220_MAX_VBLANK, 1,
> +					    min_vblank);
> +
> +	link_freq = v4l2_ctrl_new_int_menu(ctrl_hdlr, NULL, V4L2_CID_LINK_FREQ,
> +					   0, 0, &mira220_link_freqs[0]);
> +
> +	/*
> +	 * Scale hblank according to the number of enabled data lanes to match
> +	 * row_length.
> +	 */
> +	hblank_val = MIRA220_LLP_1600x1400_304 * (2 / mira220->lanes)
> +		   - MIRA220_PIXEL_ARRAY_WIDTH;
> +	hblank = v4l2_ctrl_new_std(ctrl_hdlr, NULL, V4L2_CID_HBLANK, hblank_val,
> +				   hblank_val, 1, hblank_val);
> +
> +	/* Max exposure is determined by vblank + vsize and Tglob. */
> +	max_exposure = mira220_calc_exposure(mira220,
> +					     MIRA220_PIXEL_ARRAY_HEIGHT,
> +					     min_vblank);
> +	mira220->exposure = v4l2_ctrl_new_std(ctrl_hdlr, &mira220_ctrl_ops,
> +					      V4L2_CID_EXPOSURE,
> +					      MIRA220_EXPOSURE_MIN,
> +					      max_exposure, 1,
> +					      MIRA220_DEFAULT_EXPOSURE);
> +
> +	v4l2_ctrl_new_std(ctrl_hdlr, NULL, V4L2_CID_ANALOGUE_GAIN,
> +			  MIRA220_ANALOG_GAIN_MIN, MIRA220_ANALOG_GAIN_MAX,
> +			  MIRA220_ANALOG_GAIN_STEP,
> +			  MIRA220_ANALOG_GAIN_DEFAULT);
> +
> +	mira220->hflip = v4l2_ctrl_new_std(ctrl_hdlr, &mira220_ctrl_ops,
> +					   V4L2_CID_HFLIP, 0, 1, 1, 0);
> +
> +	mira220->vflip = v4l2_ctrl_new_std(ctrl_hdlr, &mira220_ctrl_ops,
> +					   V4L2_CID_VFLIP, 0, 1, 1, 0);
> +
> +	v4l2_ctrl_new_std_menu_items(ctrl_hdlr, &mira220_ctrl_ops,
> +				     V4L2_CID_TEST_PATTERN,
> +				     ARRAY_SIZE(mira220_test_pattern_menu) - 1,
> +				     0, 0, mira220_test_pattern_menu);
> +
> +	v4l2_fwnode_device_parse(&client->dev, &props);
> +	v4l2_ctrl_new_fwnode_properties(ctrl_hdlr, &mira220_ctrl_ops,
> +					&props);
> +
> +	if (ctrl_hdlr->error) {
> +		ret = ctrl_hdlr->error;
> +		goto error;
> +	}
> +
> +	mira220->vflip->flags |= V4L2_CTRL_FLAG_MODIFY_LAYOUT;
> +	mira220->hflip->flags |= V4L2_CTRL_FLAG_MODIFY_LAYOUT;
> +	link_freq->flags |= V4L2_CTRL_FLAG_READ_ONLY;
> +	hblank->flags |= V4L2_CTRL_FLAG_READ_ONLY;
> +
> +	mira220->sd.ctrl_handler = ctrl_hdlr;
> +
> +	return 0;
> +
> +error:
> +	v4l2_ctrl_handler_free(ctrl_hdlr);
> +	return ret;

You can return ctrl_hdlr->error here and omit assigning ret.

> +}
> +
> +static int mira220_parse_endpoint(struct device *dev, struct mira220 *mira220)
> +{
> +	struct fwnode_handle *endpoint __free(fwnode_handle) = NULL;
> +	struct v4l2_fwnode_endpoint ep_cfg = {
> +		.bus_type = V4L2_MBUS_CSI2_DPHY
> +	};
> +	unsigned long bitmap;
> +
> +	endpoint = fwnode_graph_get_endpoint_by_id(dev_fwnode(dev), 0, 0, 0);
> +	if (v4l2_fwnode_endpoint_alloc_parse(endpoint, &ep_cfg))
> +		return dev_err_probe(dev, -EINVAL, "Failed to parse endpoint\n");
> +
> +	/* Non-continuous mode not implemented. */
> +	if (ep_cfg.bus.mipi_csi2.flags & V4L2_MBUS_CSI2_NONCONTINUOUS_CLOCK) {
> +		v4l2_fwnode_endpoint_free(&ep_cfg);

I recall I've commented about this before -- please do switch to goto-based
error handling when you need to unwind something in more than one case.

These probably apply to the mira016 driver, too. How much do these two have
in common btw.?

> +		return dev_err_probe(dev, -EINVAL,
> +				     "clock non-continuous mode not supported\n");
> +	}
> +
> +	/*
> +	 * Link frequencies: the driver supports a single link frequency,
> +	 * no need to check bitmap after this call.
> +	 */
> +	if (v4l2_link_freq_to_bitmap(dev, ep_cfg.link_frequencies,
> +				     ep_cfg.nr_of_link_frequencies,
> +				     mira220_link_freqs,
> +				     ARRAY_SIZE(mira220_link_freqs),
> +				     &bitmap)) {
> +		v4l2_fwnode_endpoint_free(&ep_cfg);
> +		return -EINVAL;
> +	}
> +
> +	/* Check the number of MIPI CSI2 data lanes */
> +	if (ep_cfg.bus.mipi_csi2.num_data_lanes != 1 &&
> +	    ep_cfg.bus.mipi_csi2.num_data_lanes != 2) {
> +		v4l2_fwnode_endpoint_free(&ep_cfg);
> +		return dev_err_probe(dev, -EINVAL,
> +				     "%u data lanes are not supported\n",
> +				      ep_cfg.bus.mipi_csi2.num_data_lanes);
> +	}
> +
> +	mira220->lanes = ep_cfg.bus.mipi_csi2.num_data_lanes;
> +	v4l2_fwnode_endpoint_free(&ep_cfg);
> +
> +	return 0;
> +}
> +
> +static int mira220_probe(struct i2c_client *client)
> +{
> +	struct device *dev = &client->dev;
> +	struct mira220 *mira220;
> +	int ret;
> +
> +	mira220 = devm_kzalloc(&client->dev, sizeof(*mira220), GFP_KERNEL);
> +	if (!mira220)
> +		return -ENOMEM;
> +
> +	v4l2_i2c_subdev_init(&mira220->sd, client, &mira220_subdev_ops);
> +	mira220->sd.internal_ops = &mira220_internal_ops;
> +
> +	ret = mira220_parse_endpoint(dev, mira220);
> +	if (ret)
> +		return ret;
> +
> +	mira220->regmap = devm_cci_regmap_init_i2c(client, 16);
> +	if (IS_ERR(mira220->regmap))
> +		return dev_err_probe(dev, PTR_ERR(mira220->regmap),
> +				     "failed to initialize CCI\n");
> +
> +	/* Get system clock (xclk) */
> +	mira220->xclk = devm_v4l2_sensor_clk_get(dev, NULL);
> +	if (IS_ERR(mira220->xclk))
> +		return dev_err_probe(dev, PTR_ERR(mira220->xclk),
> +				     "failed to get xclk\n");
> +
> +	mira220->xclk_freq = clk_get_rate(mira220->xclk);
> +	if (mira220->xclk_freq != MIRA220_SUPPORTED_XCLK_FREQ) {
> +		dev_err(dev, "xclk frequency not supported: %d Hz\n",
> +			mira220->xclk_freq);
> +		return -EINVAL;
> +	}
> +
> +	ret = mira220_get_regulators(mira220);
> +	if (ret)
> +		return dev_err_probe(dev, ret, "failed to get regulators\n");
> +
> +	mira220->reset_gpio = devm_gpiod_get_optional(dev, "reset",
> +						      GPIOD_OUT_HIGH);
> +	if (IS_ERR(mira220->reset_gpio))
> +		return dev_err_probe(dev, PTR_ERR(mira220->reset_gpio),
> +				     "failed to get reset gpio\n");
> +
> +	ret = mira220_power_on(dev);
> +	if (ret)
> +		return ret;
> +
> +	/* Enable runtime PM and power on the device */
> +	pm_runtime_set_active(dev);
> +	pm_runtime_enable(dev);
> +
> +	ret = mira220_identify_module(mira220);
> +	if (ret)
> +		goto error_power_off;
> +
> +	ret = mira220_init_controls(mira220);
> +	if (ret)
> +		goto error_power_off;
> +
> +	/* Initialize subdev */
> +	mira220->sd.internal_ops = &mira220_internal_ops;
> +	mira220->sd.flags |= V4L2_SUBDEV_FL_HAS_DEVNODE;
> +	mira220->sd.entity.function = MEDIA_ENT_F_CAM_SENSOR;
> +
> +	/* Initialize source pads */
> +	mira220->pad.flags = MEDIA_PAD_FL_SOURCE;
> +
> +	ret = media_entity_pads_init(&mira220->sd.entity, 1, &mira220->pad);
> +	if (ret) {
> +		dev_err_probe(dev, ret, "failed to init entity pads\n");
> +		goto error_handler_free;
> +	}
> +
> +	mira220->sd.state_lock = mira220->ctrl_handler.lock;
> +	ret = v4l2_subdev_init_finalize(&mira220->sd);
> +	if (ret < 0) {
> +		dev_err_probe(dev, ret, "subdev init error\n");
> +		goto error_media_entity;
> +	}
> +
> +	ret = v4l2_async_register_subdev_sensor(&mira220->sd);
> +	if (ret < 0) {
> +		dev_err_probe(dev, ret,
> +			      "failed to register sensor sub-device\n");
> +		goto error_subdev_cleanup;
> +	}
> +
> +	pm_runtime_set_autosuspend_delay(dev, 1000);
> +	pm_runtime_use_autosuspend(dev);
> +	pm_runtime_idle(dev);
> +
> +	return 0;
> +
> +error_subdev_cleanup:
> +	v4l2_subdev_cleanup(&mira220->sd);
> +error_media_entity:
> +	media_entity_cleanup(&mira220->sd.entity);
> +error_handler_free:
> +	v4l2_ctrl_handler_free(mira220->sd.ctrl_handler);
> +error_power_off:
> +	pm_runtime_disable(dev);
> +	mira220_power_off(dev);
> +	pm_runtime_set_suspended(dev);
> +	return ret;
> +}
> +
> +static void mira220_remove(struct i2c_client *client)
> +{
> +	struct v4l2_subdev *sd = i2c_get_clientdata(client);
> +	struct mira220 *mira220 = to_mira220(sd);
> +
> +	v4l2_async_unregister_subdev(sd);
> +	v4l2_subdev_cleanup(&mira220->sd);
> +	media_entity_cleanup(&sd->entity);
> +
> +	v4l2_ctrl_handler_free(mira220->sd.ctrl_handler);
> +
> +	pm_runtime_disable(&client->dev);
> +	if (!pm_runtime_status_suspended(&client->dev))
> +		mira220_power_off(&client->dev);
> +	pm_runtime_set_suspended(&client->dev);

This needs to be conditional to the device not being suspended.

> +}
> +
> +static const struct dev_pm_ops mira220_pm_ops = {
> +	SET_RUNTIME_PM_OPS(mira220_power_off, mira220_power_on, NULL)
> +};
> +
> +static const struct of_device_id mira220_dt_ids[] = {
> +	{ .compatible = "ams,mira220" },
> +	{ /* sentinel */ }
> +};
> +MODULE_DEVICE_TABLE(of, mira220_dt_ids);
> +
> +static struct i2c_driver mira220_i2c_driver = {
> +	.driver = {
> +		.name = "mira220",
> +		.of_match_table	= mira220_dt_ids,
> +		.pm = pm_ptr(&mira220_pm_ops),
> +	},
> +	.probe = mira220_probe,
> +	.remove = mira220_remove,
> +};
> +
> +module_i2c_driver(mira220_i2c_driver);
> +
> +MODULE_AUTHOR("Philippe Baetens <philippe.baetens@xxxxxxxxxxxxx>");
> +MODULE_DESCRIPTION("ams MIRA220 sensor driver");
> +MODULE_LICENSE("GPL");
> 

-- 
Kind regards,

Sakari Ailus