media: i2c: ov02e10: Use V4L2 sensor clock helper

Several camera sensor drivers access the "clock-frequency" property
directly to retrieve the external clock rate, or modify the clock rate
of the external clock programmatically. Both behaviours are valid on
a subset of ACPI platforms, but are considered deprecated on OF
platforms, and do not support ACPI platforms that implement MIPI DisCo
for Imaging. Implementing them manually in drivers is deprecated, as
that can encourage cargo-cult and lead to differences in behaviour
between drivers. Instead, drivers should use the
devm_v4l2_sensor_clk_get() helper.

This driver supports ACPI and OF platforms. The "clocks" property is
specified as mandatory in the DT bindings and the "clock-frequency"
property is not allowed. The driver retrieves the clock and its rate if
present, and falls back to retrieving the rate from the
"clock-frequency" property otherwise. If the rate does not match the
expected rate, the driver fails probing. This is correct behaviour for
ACPI, and for OF platforms that comply with the documented DT bindings.

Switch to using the devm_v4l2_sensor_clk_get() helper. This does not
change the behaviour on ACPI platforms that specify a clock-frequency
property and don't provide a clock. On ACPI platforms that provide a
clock, the clock rate will be set to the value of the clock-frequency
property. This should not change the behaviour either as this driver
expects the clock to be set to that rate, and wouldn't operate correctly
otherwise.

The behaviour is also unchanged on OF platforms that comply with the DT
bindings. Non-compliant platforms are not expected, but any regression
could easily be handled by switching to the
devm_v4l2_sensor_clk_get_legacy() helper designed to preserve
non-compliant behaviour.

Signed-off-by: Laurent Pinchart <laurent.pinchart@ideasonboard.com>
Signed-off-by: Sakari Ailus <sakari.ailus@linux.intel.com>
Reviewed-by: Mehdi Djait <mehdi.djait@linux.intel.com>
Signed-off-by: Hans Verkuil <hverkuil+cisco@kernel.org>

diff --git a/drivers/media/i2c/ov02e10.c b/drivers/media/i2c/ov02e10.c
index 4db80227ce93f64bf150851da96df920d0168361..4a64cba99991f302a9501f3c34fc03e0353973a1 100644 (file)
--- a/drivers/media/i2c/ov02e10.c
+++ b/drivers/media/i2c/ov02e10.c
@@ -749,7 +749,6 @@ static int ov02e10_check_hwcfg(struct ov02e10 *ov02e10)
        struct fwnode_handle *ep;
        struct fwnode_handle *fwnode = dev_fwnode(dev);
        unsigned long link_freq_bitmap;
-       u32 ext_clk;
        int ret;
 
        ep = fwnode_graph_get_next_endpoint(fwnode, NULL);
@@ -762,31 +761,6 @@ static int ov02e10_check_hwcfg(struct ov02e10 *ov02e10)
        if (ret)
                return dev_err_probe(dev, ret, "parsing endpoint failed\n");
 
-       ov02e10->img_clk = devm_clk_get_optional(dev, NULL);
-       if (IS_ERR(ov02e10->img_clk)) {
-               ret = dev_err_probe(dev, PTR_ERR(ov02e10->img_clk),
-                                   "failed to get imaging clock\n");
-               goto out_err;
-       }
-
-       if (ov02e10->img_clk) {
-               ext_clk = clk_get_rate(ov02e10->img_clk);
-       } else {
-               ret = fwnode_property_read_u32(dev_fwnode(dev), "clock-frequency",
-                                              &ext_clk);
-               if (ret) {
-                       dev_err(dev, "can't get clock frequency\n");
-                       goto out_err;
-               }
-       }
-
-       if (ext_clk != OV02E10_MCLK) {
-               dev_err(dev, "external clock %d is not supported\n",
-                       ext_clk);
-               ret = -EINVAL;
-               goto out_err;
-       }
-
        if (bus_cfg.bus.mipi_csi2.num_data_lanes != OV02E10_DATA_LANES) {
                dev_err(dev, "number of CSI2 data lanes %d is not supported\n",
                        bus_cfg.bus.mipi_csi2.num_data_lanes);
@@ -838,6 +812,7 @@ static void ov02e10_remove(struct i2c_client *client)
 static int ov02e10_probe(struct i2c_client *client)
 {
        struct ov02e10 *ov02e10;
+       unsigned long freq;
        int ret;
 
        ov02e10 = devm_kzalloc(&client->dev, sizeof(*ov02e10), GFP_KERNEL);
@@ -846,6 +821,17 @@ static int ov02e10_probe(struct i2c_client *client)
 
        ov02e10->dev = &client->dev;
 
+       ov02e10->img_clk = devm_v4l2_sensor_clk_get(ov02e10->dev, NULL);
+       if (IS_ERR(ov02e10->img_clk))
+               return dev_err_probe(ov02e10->dev, PTR_ERR(ov02e10->img_clk),
+                                    "failed to get imaging clock\n");
+
+       freq = clk_get_rate(ov02e10->img_clk);
+       if (freq != OV02E10_MCLK)
+               return dev_err_probe(ov02e10->dev, -EINVAL,
+                                    "external clock %lu is not supported",
+                                    freq);
+
        v4l2_i2c_subdev_init(&ov02e10->sd, client, &ov02e10_subdev_ops);
 
        /* Check HW config */