Re: [PATCH v2 3/4] media: ov2685: add support for OV2685 sensor

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 




Hi Shunqian,

Please see my comments below.

On Fri, Dec 29, 2017 at 04:08:24PM +0800, Shunqian Zheng wrote:
> This patch adds driver for Omnivision's ov2685 sensor.
> Though the ov2685 can output yuv data, this driver only
> supports the raw bayer format, including the following features:
>   - output 1600x1200 at 30fps
>   - test patterns
>   - manual exposure/gain control
>   - vblank and hblank
>   - media controller
>   - runtime pm
> 
> Signed-off-by: Shunqian Zheng <zhengsq@xxxxxxxxxxxxxx>
> ---
>  drivers/media/i2c/Kconfig  |  12 +
>  drivers/media/i2c/Makefile |   1 +
>  drivers/media/i2c/ov2685.c | 841 +++++++++++++++++++++++++++++++++++++++++++++
>  3 files changed, 854 insertions(+)
>  create mode 100644 drivers/media/i2c/ov2685.c
> 
> diff --git a/drivers/media/i2c/Kconfig b/drivers/media/i2c/Kconfig
> index 55b37c8..63a175d 100644
> --- a/drivers/media/i2c/Kconfig
> +++ b/drivers/media/i2c/Kconfig
> @@ -586,6 +586,18 @@ config VIDEO_OV2659
>  	  To compile this driver as a module, choose M here: the
>  	  module will be called ov2659.
>  
> +config VIDEO_OV2685
> +	tristate "OmniVision OV2685 sensor support"
> +	depends on VIDEO_V4L2 && I2C && MEDIA_CONTROLLER
> +	depends on MEDIA_CAMERA_SUPPORT
> +	select V4L2_FWNODE
> +	---help---
> +	  This is a Video4Linux2 sensor-level driver for the OmniVision
> +	  OV2685 camera.
> +
> +	  To compile this driver as a module, choose M here: the
> +	  module will be called ov2685.
> +
>  config VIDEO_OV5640
>  	tristate "OmniVision OV5640 sensor support"
>  	depends on OF
> diff --git a/drivers/media/i2c/Makefile b/drivers/media/i2c/Makefile
> index a063030..3054c69 100644
> --- a/drivers/media/i2c/Makefile
> +++ b/drivers/media/i2c/Makefile
> @@ -61,6 +61,7 @@ obj-$(CONFIG_VIDEO_SONY_BTF_MPX) += sony-btf-mpx.o
>  obj-$(CONFIG_VIDEO_UPD64031A) += upd64031a.o
>  obj-$(CONFIG_VIDEO_UPD64083) += upd64083.o
>  obj-$(CONFIG_VIDEO_OV2640) += ov2640.o
> +obj-$(CONFIG_VIDEO_OV2685) += ov2685.o
>  obj-$(CONFIG_VIDEO_OV5640) += ov5640.o
>  obj-$(CONFIG_VIDEO_OV5645) += ov5645.o
>  obj-$(CONFIG_VIDEO_OV5647) += ov5647.o
> diff --git a/drivers/media/i2c/ov2685.c b/drivers/media/i2c/ov2685.c
> new file mode 100644
> index 0000000..e037d20
> --- /dev/null
> +++ b/drivers/media/i2c/ov2685.c
> @@ -0,0 +1,841 @@
> +/*
> + * ov2685 driver
> + *
> + * Copyright (C) 2017 Fuzhou Rockchip Electronics Co., Ltd.
> + *
> + * This program is free software; you can redistribute it and/or modify
> + * it under the terms of the GNU General Public License as published by
> + * the Free Software Foundation; either version 2 of the License, or
> + * (at your option) any later version.
> + */
> +
> +#include <linux/clk.h>
> +#include <linux/device.h>
> +#include <linux/delay.h>
> +#include <linux/gpio/consumer.h>
> +#include <linux/i2c.h>
> +#include <linux/module.h>
> +#include <linux/pm_runtime.h>
> +#include <linux/regulator/consumer.h>
> +#include <linux/sysfs.h>
> +#include <media/media-entity.h>
> +#include <media/v4l2-async.h>
> +#include <media/v4l2-ctrls.h>
> +#include <media/v4l2-subdev.h>
> +
> +#define CHIP_ID				0x2685
> +#define OV2685_REG_CHIP_ID		0x300a
> +
> +#define REG_SC_CTRL_MODE		0x0100
> +#define     SC_CTRL_MODE_STANDBY	0x0
> +#define     SC_CTRL_MODE_STREAMING	BIT(0)
> +
> +#define OV2685_REG_EXPOSURE		0x3500
> +#define	OV2685_EXPOSURE_MIN		4
> +#define	OV2685_EXPOSURE_STEP		1
> +
> +#define OV2685_REG_VTS			0x380e
> +#define OV2685_VTS_MAX			0x7fff
> +
> +#define OV2685_REG_GAIN			0x350a
> +#define OV2685_GAIN_MIN			0
> +#define OV2685_GAIN_MAX			0x07ff
> +#define OV2685_GAIN_STEP		0x1
> +#define OV2685_GAIN_DEFAULT		0x0036
> +
> +#define OV2685_REG_TEST_PATTERN		0x5080
> +#define OV2685_TEST_PATTERN_DISABLED		0x00
> +#define OV2685_TEST_PATTERN_COLOR_BAR		0x80
> +#define OV2685_TEST_PATTERN_RND			0x81
> +#define OV2685_TEST_PATTERN_COLOR_BAR_FADE	0x88
> +#define OV2685_TEST_PATTERN_BW_SQUARE		0x92
> +#define OV2685_TEST_PATTERN_COLOR_SQUARE	0x82
> +
> +#define REG_NULL			0xFFFF
> +
> +#define OV2685_REG_VALUE_08BIT		1
> +#define OV2685_REG_VALUE_16BIT		2
> +#define OV2685_REG_VALUE_24BIT		3
> +
> +#define OV2685_LANES			1
> +#define OV2685_BITS_PER_SAMPLE		10
> +
> +struct regval {
> +	u16 addr;
> +	u8 val;
> +};
> +
> +struct ov2685_mode {
> +	u32 width;
> +	u32 height;
> +	u32 exp_def;
> +	u32 hts_def;
> +	u32 vts_def;
> +	const struct regval *reg_list;
> +};
> +
> +struct ov2685 {
> +	struct i2c_client	*client;
> +	struct clk		*xvclk;
> +	struct regulator	*avdd_regulator;	/* Analog power */
> +	struct regulator	*dovdd_regulator;	/* Digital I/O power */
> +				/* use internal DVDD power */
> +	struct gpio_desc	*reset_gpio;
> +
> +	bool			streaming;
> +	struct mutex		mutex;
> +	struct v4l2_subdev	subdev;
> +	struct media_pad	pad;
> +	struct v4l2_ctrl	*anal_gain;
> +	struct v4l2_ctrl	*exposure;
> +	struct v4l2_ctrl	*hblank;
> +	struct v4l2_ctrl	*vblank;
> +	struct v4l2_ctrl	*test_pattern;
> +	struct v4l2_ctrl_handler ctrl_handler;
> +
> +	const struct ov2685_mode *cur_mode;
> +};
> +#define to_ov2685(sd) container_of(sd, struct ov2685, subdev)
> +
> +/* PLL settings bases on 24M xvclk */
> +static struct regval ov2685_1600x1200_regs[] = {
> +	{0x0103, 0x01},
> +	{0x0100, 0x00},
> +	{0x3002, 0x00},
> +	{0x3016, 0x1c},
> +	{0x3018, 0x44},
> +	{0x301d, 0xf0},
> +	{0x3020, 0x00},
> +	{0x3082, 0x37},
> +	{0x3083, 0x03},
> +	{0x3084, 0x09},
> +	{0x3085, 0x04},
> +	{0x3086, 0x00},
> +	{0x3087, 0x00},
> +	{0x3501, 0x4e},
> +	{0x3502, 0xe0},
> +	{0x3503, 0x07},
> +	{0x350b, 0x36},
> +	{0x3600, 0xb4},
> +	{0x3603, 0x35},
> +	{0x3604, 0x24},
> +	{0x3605, 0x00},
> +	{0x3620, 0x24},
> +	{0x3621, 0x34},
> +	{0x3622, 0x03},
> +	{0x3628, 0x10},
> +	{0x3705, 0x3c},
> +	{0x370a, 0x21},
> +	{0x370c, 0x50},
> +	{0x370d, 0xc0},
> +	{0x3717, 0x58},
> +	{0x3718, 0x80},
> +	{0x3720, 0x00},
> +	{0x3721, 0x09},
> +	{0x3722, 0x06},
> +	{0x3723, 0x59},
> +	{0x3738, 0x99},
> +	{0x3781, 0x80},
> +	{0x3784, 0x0c},
> +	{0x3789, 0x60},
> +	{0x3800, 0x00},
> +	{0x3801, 0x00},
> +	{0x3802, 0x00},
> +	{0x3803, 0x00},
> +	{0x3804, 0x06},
> +	{0x3805, 0x4f},
> +	{0x3806, 0x04},
> +	{0x3807, 0xbf},
> +	{0x3808, 0x06},
> +	{0x3809, 0x40},
> +	{0x380a, 0x04},
> +	{0x380b, 0xb0},
> +	{0x380c, 0x06},
> +	{0x380d, 0xa4},
> +	{0x380e, 0x05},
> +	{0x380f, 0x0e},
> +	{0x3810, 0x00},
> +	{0x3811, 0x08},
> +	{0x3812, 0x00},
> +	{0x3813, 0x08},
> +	{0x3814, 0x11},
> +	{0x3815, 0x11},
> +	{0x3819, 0x04},
> +	{0x3820, 0xc0},
> +	{0x3821, 0x00},
> +	{0x3a06, 0x01},
> +	{0x3a07, 0x84},
> +	{0x3a08, 0x01},
> +	{0x3a09, 0x43},
> +	{0x3a0a, 0x24},
> +	{0x3a0b, 0x60},
> +	{0x3a0c, 0x28},
> +	{0x3a0d, 0x60},
> +	{0x3a0e, 0x04},
> +	{0x3a0f, 0x8c},
> +	{0x3a10, 0x05},
> +	{0x3a11, 0x0c},
> +	{0x4000, 0x81},
> +	{0x4001, 0x40},
> +	{0x4008, 0x02},
> +	{0x4009, 0x09},
> +	{0x4300, 0x00},
> +	{0x430e, 0x00},
> +	{0x4602, 0x02},
> +	{0x481b, 0x40},
> +	{0x481f, 0x40},
> +	{0x4837, 0x18},
> +	{0x5000, 0x1f},
> +	{0x5001, 0x05},
> +	{0x5002, 0x30},
> +	{0x5003, 0x04},
> +	{0x5004, 0x00},
> +	{0x5005, 0x0c},
> +	{0x5280, 0x15},
> +	{0x5281, 0x06},
> +	{0x5282, 0x06},
> +	{0x5283, 0x08},
> +	{0x5284, 0x1c},
> +	{0x5285, 0x1c},
> +	{0x5286, 0x20},
> +	{0x5287, 0x10},
> +	{REG_NULL, 0x00}
> +};
> +
> +#define OV2685_LINK_FREQ_330MHZ		330000000
> +static const s64 link_freq_menu_items[] = {
> +	OV2685_LINK_FREQ_330MHZ
> +};
> +
> +static const char * const ov2685_test_pattern_menu[] = {
> +	"Disabled",
> +	"Color Bar",
> +	"RND PATTERN",
> +	"Color Bar FADE",
> +	"BW SQUARE",
> +	"COLOR SQUARE"

Could you spell out the abbreviations and use capitalisation consistently?

> +};
> +
> +static const int ov2685_test_pattern_val[] = {
> +	OV2685_TEST_PATTERN_DISABLED,
> +	OV2685_TEST_PATTERN_COLOR_BAR,
> +	OV2685_TEST_PATTERN_RND,
> +	OV2685_TEST_PATTERN_COLOR_BAR_FADE,
> +	OV2685_TEST_PATTERN_BW_SQUARE,
> +	OV2685_TEST_PATTERN_COLOR_SQUARE,
> +};
> +
> +static const struct ov2685_mode supported_modes[] = {
> +	{
> +		.width = 1600,
> +		.height = 1200,
> +		.exp_def = 0x04ee,
> +		.hts_def = 0x06a4,
> +		.vts_def = 0x050e,
> +		.reg_list = ov2685_1600x1200_regs,
> +	},
> +};
> +
> +/* Write registers up to 4 at a time */
> +static int ov2685_write_reg(struct i2c_client *client, u16 reg,
> +			    unsigned int len, u32 val)
> +{
> +	int buf_i;
> +	int val_i;

unsigned int?

> +	u8 buf[6];
> +	u8 *val_p;
> +	__be32 val_be;
> +
> +	if (len > 4)
> +		return -EINVAL;
> +
> +	buf[0] = reg >> 8;
> +	buf[1] = reg & 0xff;
> +
> +	val_be = cpu_to_be32(val);
> +	val_p = (u8 *)&val_be;
> +	buf_i = 2;
> +	val_i = 4 - len;
> +
> +	while (val_i < 4)
> +		buf[buf_i++] = val_p[val_i++];
> +
> +	if (i2c_master_send(client, buf, len + 2) != len + 2)
> +		return -EIO;
> +
> +	return 0;
> +}
> +
> +static int ov2685_write_array(struct i2c_client *client,
> +			      const struct regval *regs)
> +{
> +	int i, ret = 0;

unsigned int i?

> +
> +	for (i = 0; ret == 0 && regs[i].addr != REG_NULL; i++)
> +		ret = ov2685_write_reg(client, regs[i].addr,
> +				       OV2685_REG_VALUE_08BIT, regs[i].val);
> +
> +	return ret;
> +}
> +
> +/* Read registers up to 4 at a time */
> +static int ov2685_read_reg(struct i2c_client *client, u16 reg,
> +			   unsigned int len, u32 *val)
> +{
> +	struct i2c_msg msgs[2];
> +	u8 *data_be_p;
> +	__be32 data_be = 0;
> +	__be16 reg_addr_be = cpu_to_be16(reg);
> +	int ret;
> +
> +	if (len > 4)
> +		return -EINVAL;
> +
> +	data_be_p = (u8 *)&data_be;
> +	/* Write register address */
> +	msgs[0].addr = client->addr;
> +	msgs[0].flags = 0;
> +	msgs[0].len = 2;
> +	msgs[0].buf = (u8 *)&reg_addr_be;
> +
> +	/* Read data from register */
> +	msgs[1].addr = client->addr;
> +	msgs[1].flags = I2C_M_RD;
> +	msgs[1].len = len;
> +	msgs[1].buf = &data_be_p[4 - len];
> +
> +	ret = i2c_transfer(client->adapter, msgs, ARRAY_SIZE(msgs));
> +	if (ret != ARRAY_SIZE(msgs))
> +		return -EIO;
> +
> +	*val = be32_to_cpu(data_be);
> +
> +	return 0;
> +}
> +
> +static void ov2685_fill_fmt(struct ov2685 *ov2685,
> +			    struct v4l2_mbus_framefmt *fmt)
> +{
> +	fmt->code = MEDIA_BUS_FMT_SBGGR10_1X10;
> +	fmt->width = ov2685->cur_mode->width;
> +	fmt->height = ov2685->cur_mode->height;
> +	fmt->field = V4L2_FIELD_NONE;
> +}
> +
> +static int ov2685_set_fmt(struct v4l2_subdev *sd,
> +			  struct v4l2_subdev_pad_config *cfg,
> +			  struct v4l2_subdev_format *fmt)
> +{
> +	struct ov2685 *ov2685 = to_ov2685(sd);
> +	struct v4l2_mbus_framefmt *mbus_fmt = &fmt->format;
> +
> +	ov2685_fill_fmt(ov2685, mbus_fmt);
> +
> +	return 0;
> +}
> +
> +static int ov2685_get_fmt(struct v4l2_subdev *sd,
> +			  struct v4l2_subdev_pad_config *cfg,
> +			  struct v4l2_subdev_format *fmt)
> +{
> +	struct ov2685 *ov2685 = to_ov2685(sd);
> +	struct v4l2_mbus_framefmt *mbus_fmt = &fmt->format;
> +
> +	ov2685_fill_fmt(ov2685, mbus_fmt);
> +
> +	return 0;
> +}
> +
> +static int ov2685_enum_mbus_code(struct v4l2_subdev *sd,
> +				 struct v4l2_subdev_pad_config *cfg,
> +				 struct v4l2_subdev_mbus_code_enum *code)
> +{
> +	if (code->index >= ARRAY_SIZE(supported_modes))
> +		return -EINVAL;
> +
> +	code->code = MEDIA_BUS_FMT_SBGGR10_1X10;

Newline here?

> +	return 0;
> +}
> +
> +static int ov2685_enum_frame_sizes(struct v4l2_subdev *sd,
> +				   struct v4l2_subdev_pad_config *cfg,
> +				   struct v4l2_subdev_frame_size_enum *fse)
> +{
> +	int index = fse->index;
> +
> +	if (index >= ARRAY_SIZE(supported_modes))
> +		return -EINVAL;
> +
> +	fse->code = MEDIA_BUS_FMT_SBGGR10_1X10;
> +
> +	fse->min_width  = supported_modes[index].width;
> +	fse->max_width  = supported_modes[index].width;
> +	fse->max_height = supported_modes[index].height;
> +	fse->min_height = supported_modes[index].height;
> +
> +	return 0;
> +}
> +
> +static inline void ov2685_set_exposure(struct ov2685 *ov2685, s32 val)
> +{
> +	ov2685_write_reg(ov2685->client, OV2685_REG_EXPOSURE,
> +			 OV2685_REG_VALUE_24BIT, val << 4);

How about checking the return value for errors? Same elsewhere.

It'd also be simpler to move these to the s_ctrl callback handler below.

> +}
> +
> +static inline void ov2685_set_gain(struct ov2685 *ov2685, s32 val)
> +{
> +	ov2685_write_reg(ov2685->client, OV2685_REG_GAIN,
> +			 OV2685_REG_VALUE_16BIT, val & OV2685_GAIN_MAX);
> +}
> +
> +static inline void ov2685_set_vts(struct ov2685 *ov2685, s32 val)
> +{
> +	val += ov2685->cur_mode->height;
> +	ov2685_write_reg(ov2685->client, OV2685_REG_VTS,
> +			 OV2685_REG_VALUE_16BIT, val);
> +}
> +
> +static inline void ov2685_enable_test_pattern(struct ov2685 *ov2685, u32 pat)
> +{
> +	ov2685_write_reg(ov2685->client, OV2685_REG_TEST_PATTERN,
> +			 OV2685_REG_VALUE_08BIT, ov2685_test_pattern_val[pat]);
> +}
> +
> +static int __ov2685_power_on(struct ov2685 *ov2685)
> +{
> +	int ret;
> +	struct device *dev = &ov2685->client->dev;
> +
> +	ret = clk_prepare_enable(ov2685->xvclk);
> +	if (ret < 0) {
> +		dev_err(dev, "Failed to enable xvclk\n");
> +		return ret;
> +	}
> +	clk_set_rate(ov2685->xvclk, 24000000);
> +
> +	gpiod_set_value_cansleep(ov2685->reset_gpio, 1);
> +	/* AVDD and DOVDD may rise in any order */
> +	ret = regulator_enable(ov2685->avdd_regulator);
> +	if (ret < 0) {
> +		dev_err(dev, "Failed to enable AVDD regulator\n");
> +		goto disable_xvclk;
> +	}
> +	ret = regulator_enable(ov2685->dovdd_regulator);
> +	if (ret < 0) {
> +		dev_err(dev, "Failed to enable DOVDD regulator\n");
> +		goto disable_avdd;
> +	}
> +	/* The minimum delay between AVDD and reset rising can be 0 */
> +	gpiod_set_value_cansleep(ov2685->reset_gpio, 0);
> +	/* 8192 xvclk cycles prior to the first SCCB transaction.
> +	 * NOTE: An additional 1ms must be added to wait for
> +	 *       SCCB to become stable when using internal DVDD.
> +	 */
> +	usleep_range(1350, 1500);
> +
> +	/* HACK: ov2685 would output messy data after reset(R0103),
> +	 * writing register before .s_stream() as a workaround
> +	 */
> +	ret = ov2685_write_array(ov2685->client, ov2685->cur_mode->reg_list);
> +
> +	return ret;
> +disable_avdd:
> +	regulator_disable(ov2685->avdd_regulator);
> +disable_xvclk:
> +	clk_disable_unprepare(ov2685->xvclk);
> +
> +	return ret;
> +}
> +
> +static void __ov2685_power_off(struct ov2685 *ov2685)
> +{
> +	/* 512 xvclk cycles after the last SCCB transaction or MIPI frame end */

Could you calculate the delay if it's dependent on the clock frequency?

> +	usleep_range(30, 50);
> +	clk_disable_unprepare(ov2685->xvclk);
> +	gpiod_set_value_cansleep(ov2685->reset_gpio, 1);
> +	regulator_disable(ov2685->dovdd_regulator);
> +	regulator_disable(ov2685->avdd_regulator);
> +}
> +
> +static int ov2685_s_power(struct v4l2_subdev *sd, int on)
> +{
> +	struct ov2685 *ov2685 = to_ov2685(sd);
> +	int ret = 0;
> +
> +	mutex_lock(&ov2685->mutex);
> +
> +	if (on)
> +		ret = pm_runtime_get_sync(&ov2685->client->dev);

If pm_runtime_get_sync fails, you need to decrement the usage count by
calling e.g. pm_runtime_put_noidle on the device.

If you move the power management to s_stream callback, you can remove the
s_power callback altogether --- these are essentially where the registers
are generally accessed, apart from the driver's probe function.

> +	else
> +		ret = pm_runtime_put(&ov2685->client->dev);
> +
> +	mutex_unlock(&ov2685->mutex);
> +
> +	return ret;
> +}
> +
> +static int ov2685_s_stream(struct v4l2_subdev *sd, int on)
> +{
> +	struct ov2685 *ov2685 = to_ov2685(sd);
> +	struct i2c_client *client = ov2685->client;
> +	int ret = 0;
> +
> +	mutex_lock(&ov2685->mutex);
> +
> +	on = !!on;
> +	if (on == ov2685->streaming)
> +		goto unlock_and_return;
> +
> +	if (on) {
> +		/* In case these controls are set before streaming */
> +		ov2685_set_exposure(ov2685, ov2685->exposure->val);
> +		ov2685_set_gain(ov2685, ov2685->anal_gain->val);
> +		ov2685_set_vts(ov2685, ov2685->vblank->val);
> +		ov2685_enable_test_pattern(ov2685, ov2685->test_pattern->val);

You should use __v4l2_ctrl_handler_setup() here. Or put that to the
driver's runtime_resume function. That actually might be better.

> +
> +		ret = ov2685_write_reg(client, REG_SC_CTRL_MODE,
> +				OV2685_REG_VALUE_08BIT, SC_CTRL_MODE_STREAMING);
> +		if (ret)
> +			goto unlock_and_return;
> +	} else {
> +		ret = ov2685_write_reg(client, REG_SC_CTRL_MODE,
> +				OV2685_REG_VALUE_08BIT, SC_CTRL_MODE_STANDBY);
> +		if (ret)
> +			goto unlock_and_return;
> +	}
> +
> +	ov2685->streaming = on;
> +
> +unlock_and_return:
> +	mutex_unlock(&ov2685->mutex);
> +	return ret;
> +}
> +
> +#ifdef CONFIG_VIDEO_V4L2_SUBDEV_API
> +static int ov2685_open(struct v4l2_subdev *sd, struct v4l2_subdev_fh *fh)
> +{
> +	struct ov2685 *ov2685 = to_ov2685(sd);
> +	struct v4l2_mbus_framefmt *try_fmt;
> +
> +	mutex_lock(&ov2685->mutex);
> +
> +	try_fmt = v4l2_subdev_get_try_format(sd, fh->pad, 0);
> +	/* Initialize try_fmt */
> +	ov2685_fill_fmt(ov2685, try_fmt);

The default try format should not be dependent on current device
configuration but... the default configuration.

> +
> +	mutex_unlock(&ov2685->mutex);
> +
> +	return 0;
> +}
> +#endif
> +
> +static int ov2685_runtime_resume(struct device *dev)
> +{
> +	struct i2c_client *client = to_i2c_client(dev);
> +	struct v4l2_subdev *sd = i2c_get_clientdata(client);
> +	struct ov2685 *ov2685 = to_ov2685(sd);
> +	int ret;
> +
> +	ret = __ov2685_power_on(ov2685);
> +	if (ret)
> +		return ret;
> +
> +	if (ov2685->streaming) {

This would be suitable for system sleep PM op, not runtime PM which sets
device power state while the entire system is up and running.

> +		ret = ov2685_s_stream(sd, 1);
> +		if (ret)
> +			__ov2685_power_off(ov2685);
> +	}
> +
> +	return ret;
> +}
> +
> +static int ov2685_runtime_suspend(struct device *dev)
> +{
> +	struct i2c_client *client = to_i2c_client(dev);
> +	struct v4l2_subdev *sd = i2c_get_clientdata(client);
> +	struct ov2685 *ov2685 = to_ov2685(sd);
> +
> +	__ov2685_power_off(ov2685);
> +
> +	return 0;
> +}
> +
> +static const struct dev_pm_ops ov2685_pm_ops = {
> +	SET_RUNTIME_PM_OPS(ov2685_runtime_suspend,
> +			   ov2685_runtime_resume, NULL)
> +};
> +
> +static int ov2685_set_ctrl(struct v4l2_ctrl *ctrl)
> +{
> +	struct ov2685 *ov2685 = container_of(ctrl->handler,
> +					     struct ov2685, ctrl_handler);
> +	struct i2c_client *client = ov2685->client;
> +	s64 max;
> +	int ret = 0;
> +
> +	/* Propagate change of current control to all related controls */
> +	switch (ctrl->id) {
> +	case V4L2_CID_VBLANK:
> +		/* Update max exposure while meeting expected vblanking */
> +		max = ov2685->cur_mode->height + ctrl->val - 4;
> +		__v4l2_ctrl_modify_range(ov2685->exposure,
> +					 ov2685->exposure->minimum, max,
> +					 ov2685->exposure->step,
> +					 ov2685->exposure->default_value);
> +		break;
> +	}
> +
> +	pm_runtime_get_sync(&client->dev);

Instead you could do as the ov13868 driver:

	if (pm_runtime_get_if_in_use(&client->dev) <= 0)
		return 0;

That way the device wouldn't need to be powered on (and likely off right
away) just for the sake of writing a register.

> +	switch (ctrl->id) {
> +	case V4L2_CID_EXPOSURE:
> +		ov2685_set_exposure(ov2685, ctrl->val);
> +		break;
> +	case V4L2_CID_ANALOGUE_GAIN:
> +		ov2685_set_gain(ov2685, ctrl->val);
> +		break;
> +	case V4L2_CID_VBLANK:
> +		ov2685_set_vts(ov2685, ctrl->val);
> +		break;
> +	case V4L2_CID_TEST_PATTERN:
> +		ov2685_enable_test_pattern(ov2685, ctrl->val);
> +		break;
> +	default:
> +		dev_warn(&client->dev, "%s Unhandled id:0x%x, val:0x%x\n",
> +			 __func__, ctrl->id, ctrl->val);
> +		break;
> +	};
> +	pm_runtime_put(&client->dev);
> +
> +	return ret;
> +}
> +
> +static struct v4l2_subdev_core_ops ov2685_core_ops = {

const. Same below.

> +	.s_power = ov2685_s_power,
> +};
> +
> +static struct v4l2_subdev_video_ops ov2685_video_ops = {
> +	.s_stream = ov2685_s_stream,
> +};
> +
> +static struct v4l2_subdev_pad_ops ov2685_pad_ops = {
> +	.enum_mbus_code = ov2685_enum_mbus_code,
> +	.enum_frame_size = ov2685_enum_frame_sizes,
> +	.get_fmt = ov2685_get_fmt,
> +	.set_fmt = ov2685_set_fmt,
> +};
> +
> +static struct v4l2_subdev_ops ov2685_subdev_ops = {
> +	.core	= &ov2685_core_ops,
> +	.video	= &ov2685_video_ops,
> +	.pad	= &ov2685_pad_ops,
> +};
> +
> +#ifdef CONFIG_VIDEO_V4L2_SUBDEV_API
> +static const struct v4l2_subdev_internal_ops ov2685_internal_ops = {
> +	.open = ov2685_open,
> +};
> +#endif
> +
> +static const struct v4l2_ctrl_ops ov2685_ctrl_ops = {
> +	.s_ctrl = ov2685_set_ctrl,
> +};
> +
> +static int ov2685_initialize_controls(struct ov2685 *ov2685)
> +{
> +	const struct ov2685_mode *mode;
> +	struct v4l2_ctrl_handler *handler;
> +	struct v4l2_ctrl *ctrl;
> +	u64 exposure_max;
> +	u32 pixel_rate, h_blank;
> +	int ret;
> +
> +	handler = &ov2685->ctrl_handler;
> +	mode = ov2685->cur_mode;
> +	ret = v4l2_ctrl_handler_init(handler, 1);

8 would be a better guess.

> +	if (ret)
> +		return ret;
> +	handler->lock = &ov2685->mutex;
> +
> +	ctrl = v4l2_ctrl_new_int_menu(handler, NULL, V4L2_CID_LINK_FREQ,
> +				      0, 0, link_freq_menu_items);
> +	if (ctrl)
> +		ctrl->flags |= V4L2_CTRL_FLAG_READ_ONLY;
> +
> +	pixel_rate = (link_freq_menu_items[0] * 2 * OV2685_LANES) /
> +		     OV2685_BITS_PER_SAMPLE;
> +	v4l2_ctrl_new_std(handler, NULL, V4L2_CID_PIXEL_RATE,
> +			  0, pixel_rate, 1, pixel_rate);
> +
> +	h_blank = mode->hts_def - mode->width;
> +	ov2685->hblank = v4l2_ctrl_new_std(handler, NULL, V4L2_CID_HBLANK,
> +				h_blank, h_blank, 1, h_blank);
> +	if (ov2685->hblank)
> +		ov2685->hblank->flags |= V4L2_CTRL_FLAG_READ_ONLY;
> +
> +	ov2685->vblank = v4l2_ctrl_new_std(handler, &ov2685_ctrl_ops,
> +				V4L2_CID_VBLANK, mode->vts_def - mode->height,
> +				OV2685_VTS_MAX - mode->height, 1,
> +				mode->vts_def - mode->height);
> +
> +	exposure_max = mode->vts_def - 4;
> +	ov2685->exposure = v4l2_ctrl_new_std(handler, &ov2685_ctrl_ops,
> +				V4L2_CID_EXPOSURE, OV2685_EXPOSURE_MIN,
> +				exposure_max, OV2685_EXPOSURE_STEP,
> +				mode->exp_def);
> +
> +	ov2685->anal_gain = v4l2_ctrl_new_std(handler, &ov2685_ctrl_ops,
> +				V4L2_CID_ANALOGUE_GAIN, OV2685_GAIN_MIN,
> +				OV2685_GAIN_MAX, OV2685_GAIN_STEP,
> +				OV2685_GAIN_DEFAULT);
> +
> +	ov2685->test_pattern = v4l2_ctrl_new_std_menu_items(handler,
> +				&ov2685_ctrl_ops, V4L2_CID_TEST_PATTERN,
> +				ARRAY_SIZE(ov2685_test_pattern_menu) - 1,
> +				0, 0, ov2685_test_pattern_menu);
> +
> +	if (handler->error) {
> +		v4l2_ctrl_handler_free(handler);
> +		return handler->error;

v4l2_ctrl_handler_free() sets handler->error to 0 currently.

As a matter of fact, it'd be nice to change that behaviour.

> +	}
> +
> +	ov2685->subdev.ctrl_handler = handler;
> +
> +	return 0;
> +}
> +
> +static int ov2685_check_sensor_id(struct ov2685 *ov2685,
> +				  struct i2c_client *client)
> +{
> +	struct device *dev = &ov2685->client->dev;
> +	int id, ret;
> +
> +	ret = __ov2685_power_on(ov2685);
> +	if (ret)
> +		return ret;

Newline?

> +	ov2685_read_reg(client, OV2685_REG_CHIP_ID,
> +			OV2685_REG_VALUE_16BIT, &id);

How about checking the return value?

> +	__ov2685_power_off(ov2685);
> +
> +	if (id != CHIP_ID) {
> +		dev_err(dev, "Wrong camera sensor id(%04x)\n", id);
> +		return -EINVAL;
> +	}
> +
> +	dev_info(dev, "Detected OV%04x sensor\n", CHIP_ID);
> +
> +	return 0;
> +}
> +
> +static int ov2685_probe(struct i2c_client *client,
> +			const struct i2c_device_id *id)
> +{
> +	struct device *dev = &client->dev;
> +	struct ov2685 *ov2685;
> +	int ret;
> +
> +	ov2685 = devm_kzalloc(dev, sizeof(*ov2685), GFP_KERNEL);
> +	if (!ov2685)
> +		return -ENOMEM;
> +
> +	ov2685->client = client;
> +	ov2685->cur_mode = &supported_modes[0];
> +
> +	ov2685->xvclk = devm_clk_get(dev, "xvclk");
> +	if (IS_ERR(ov2685->xvclk)) {
> +		dev_err(dev, "Failed to get xvclk\n");
> +		return -EINVAL;
> +	}
> +
> +	ov2685->reset_gpio = devm_gpiod_get(dev, "reset", GPIOD_OUT_LOW);
> +	if (IS_ERR(ov2685->reset_gpio)) {
> +		dev_err(dev, "Failed to get reset-gpios\n");
> +		return -EINVAL;
> +	}
> +
> +	ov2685->avdd_regulator = devm_regulator_get(dev, "avdd");
> +	if (IS_ERR(ov2685->avdd_regulator)) {
> +		dev_err(dev, "Failed to get avdd-supply\n");
> +		return -EINVAL;
> +	}
> +	ov2685->dovdd_regulator = devm_regulator_get(dev, "dovdd");
> +	if (IS_ERR(ov2685->dovdd_regulator)) {
> +		dev_err(dev, "Failed to get dovdd-supply\n");
> +		return -EINVAL;
> +	}
> +
> +	mutex_init(&ov2685->mutex);
> +	v4l2_i2c_subdev_init(&ov2685->subdev, client, &ov2685_subdev_ops);
> +	ret = ov2685_initialize_controls(ov2685);
> +	if (ret)
> +		goto destroy_mutex;
> +
> +	ret = ov2685_check_sensor_id(ov2685, client);
> +	if (ret)
> +		return ret;
> +
> +#ifdef CONFIG_VIDEO_V4L2_SUBDEV_API
> +	ov2685->subdev.internal_ops = &ov2685_internal_ops;
> +#endif
> +#if defined(CONFIG_MEDIA_CONTROLLER)
> +	ov2685->pad.flags = MEDIA_PAD_FL_SOURCE;
> +	ov2685->subdev.flags |= V4L2_SUBDEV_FL_HAS_DEVNODE;
> +	ov2685->subdev.entity.function = MEDIA_ENT_F_CAM_SENSOR;
> +	ret = media_entity_pads_init(&ov2685->subdev.entity, 1, &ov2685->pad);
> +	if (ret < 0)
> +		goto free_ctrl_handler;
> +#endif
> +
> +	ret = v4l2_async_register_subdev(&ov2685->subdev);
> +	if (ret) {
> +		dev_err(dev, "v4l2 async register subdev failed\n");
> +		goto clean_entity;
> +	}
> +

The device should be already powered up here... and then:

pm_runtime_set_active(dev);

> +	pm_runtime_enable(dev);

This will then power it down:

pm_runtime_idle(dev);

> +	return 0;
> +
> +clean_entity:
> +#if defined(CONFIG_MEDIA_CONTROLLER)
> +	media_entity_cleanup(&ov2685->subdev.entity);
> +#endif
> +free_ctrl_handler:
> +	v4l2_ctrl_handler_free(&ov2685->ctrl_handler);
> +destroy_mutex:
> +	mutex_destroy(&ov2685->mutex);
> +
> +	return ret;
> +}
> +
> +static int ov2685_remove(struct i2c_client *client)
> +{
> +	struct ov2685 *ov2685 = i2c_get_clientdata(client);
> +
> +	__ov2685_power_off(ov2685);

This goes after unregistering the devices, see below:

> +	v4l2_async_unregister_subdev(&ov2685->subdev);
> +	media_entity_cleanup(&ov2685->subdev.entity);
> +	v4l2_ctrl_handler_free(&ov2685->ctrl_handler);
> +	mutex_destroy(&ov2685->mutex);

pm_runtime_disable(&client->dev);
if (!pm_runtime_status_suspended(&client->dev))
		__ov2685_power_off(ov2685);
pm_runtime_set_suspended(&client->dev);

> +
> +	return 0;
> +}
> +
> +static const struct of_device_id ov2685_of_match[] = {
> +	{ .compatible = "ovti,ov2685" },
> +	{},
> +};
> +
> +static struct i2c_driver ov2685_i2c_driver = {
> +	.driver = {
> +		.name = "ov2685",
> +		.owner = THIS_MODULE,
> +		.pm = &ov2685_pm_ops,
> +		.of_match_table = ov2685_of_match
> +	},
> +	.probe		= &ov2685_probe,
> +	.remove		= &ov2685_remove,
> +};
> +
> +module_i2c_driver(ov2685_i2c_driver);
> +
> +MODULE_DESCRIPTION("OmniVision ov2685 sensor driver");
> +MODULE_LICENSE("GPL v2");

-- 
Regards,

Sakari Ailus
e-mail: sakari.ailus@xxxxxx
--
To unsubscribe from this list: send the line "unsubscribe devicetree" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at  http://vger.kernel.org/majordomo-info.html



[Index of Archives]     [Device Tree Compilter]     [Device Tree Spec]     [Linux Driver Backports]     [Video for Linux]     [Linux USB Devel]     [Linux PCI Devel]     [Linux Audio Users]     [Linux Kernel]     [Linux SCSI]     [XFree86]     [Yosemite Backpacking]


  Powered by Linux