Support running driver's probe for a device powered off
Subsystems (8)
Sakari Ailus
maintainerv5 cover Support running driver's probe for a device powered off
Hi all,
These patches enable calling (and finishing) a driver's probe function without powering on the respective device on busses where the practice is to power on the device for probe. While it generally is a driver's job to check the that the device is there, there are cases where it might be undesirable. (In this case it stems from a combination of hardware design and user expectations; see below.) The downside with this change is that if there is something wrong with the device, it will only be found at the time the device is used. In this case (the camera sensors + EEPROM in a sensor) I don't see any tangible harm from that though.
An indication both from the driver and the firmware is required to allow the device's power state to remain off during probe (see the first patch).
The use case is such that there is a privacy LED next to an integrated user-facing laptop camera, and this LED is there to signal the user that the camera is recording a video or capturing images. That LED also happens to be wired to one of the power supplies of the camera, so whenever you power on the camera, the LED will be lit, whether images are captured from the camera --- or not. There's no way to implement this differently without additional software control (allowing of which is itself a hardware design decision) on most CSI-2-connected camera sensors as they simply have no pin to signal the camera streaming state.
This is also what happens during driver probe: the camera will be powered on by the I²C subsystem calling dev_pm_domain_attach() and the device is already powered on when the driver's own probe function is called. To the user this visible during the boot process as a blink of the privacy LED, suggesting that the camera is recording without the user having used an application to do that. From the end user's point of view the behaviour is not expected and for someone unfamiliar with internal workings of a computer surely seems quite suspicious --- even if images are not being actually captured.
I've tested these on linux-next master. They also apply to Wolfram's i2c/for-next branch, there's a patch that affects the I²C core changes here (see below). The patches apart from that apply to Bartosz's at24/for-next as well as Mauro's linux-media master branch.
since v4 <URL:https://lore.kernel.org/linux-acpi/[email protected]/>:
- Rename "probe-low-power" property as "allow-low-power-probe". This is taken into account in function and file naming, too.
- Turn probe_low_power field in struct i2c_driver into flags field.
- Rebase on Wolfram's i2c/for-next branch that contains the removal of the support for disabling I²C core IRQ mappings (commit 0c2a34937f7e4c4776bb261114c475392da2355c).
- Change wording for "allow-low-power-probe" property in ACPI documentation.
since v3 <URL:https://lore.kernel.org/linux-acpi/[email protected]/T/#t>:
- Rework the 2nd patch based on Rafael's comments
- Rework description of the ACPI low power state helper function, according to Rafael's text.
- Rename and rework the same function as
acpi_dev_state_low_power().
- Reflect the changes in commit message as well.
- Added a patch to document the probe-low-power _DSD property.
since v2 <URL:https://patchwork.kernel.org/cover/11114255/>:
- Remove extra CONFIG_PM ifdefs; these are not needed.
- Move the checks for power state hints from drivers/base/dd.c to drivers/i2c/i2c-base-core.c; these are I²C devices anyway.
- Move the probe_low_power field from struct device_driver to struct i2c_driver.
since v1:
- Rename probe_powered_off struct device field as probe_low_power and reflect the similar naming to the patches overall.
- Work with CONFIG_PM disabled, too.
Rajmohan Mani (1):
media: i2c: imx319: Support probe while the device is off
Sakari Ailus (5):
i2c: Allow driver to manage the device's power state during probe
ACPI: Add a convenience function to tell a device is in low power
state
ov5670: Support probe whilst the device is in a low power state
at24: Support probing while off
Documentation: ACPI: Document allow-low-power-probe _DSD property
.../acpi/dsd/allow-low-power-probe.rst | 28 +++++++++++++ Documentation/firmware-guide/acpi/index.rst | 1 + drivers/acpi/device_pm.c | 31 ++++++++++++++ drivers/i2c/i2c-core-base.c | 17 ++++++-- drivers/media/i2c/imx319.c | 23 ++++++----- drivers/media/i2c/ov5670.c | 23 ++++++----- drivers/misc/eeprom/at24.c | 40 ++++++++++++------- include/linux/acpi.h | 5 +++ include/linux/i2c.h | 14 +++++++ 9 files changed, 146 insertions(+), 36 deletions(-) create mode 100644 Documentation/firmware-guide/acpi/dsd/allow-low-power-probe.rst
Signature · 1 line
2.20.1
Sakari Ailus
maintainerPATCH v5 1/6 i2c: Allow driver to manage the device's power state during probe
Enable drivers to tell ACPI that there's no need to power on a device for probe. Drivers should still perform this by themselves if there's a need to. In some cases powering on the device during probe is undesirable, and this change enables a driver to choose what fits best for it.
Add a field called "flags" into struct i2c_driver for driver flags, and a flag I2C_DRV_FL_ALLOW_LOW_POWER_PROBE to tell a driver supports probe in low power state.
--- drivers/i2c/i2c-core-base.c | 17 ++++++++++++++--- include/linux/i2c.h | 14 ++++++++++++++ 2 files changed, 28 insertions(+), 3 deletions(-)
drivers/i2c/i2c-core-base.c +14 -3
@@ -436,6 +436,14 @@ static int i2c_smbus_host_notify_to_irq(const struct i2c_client *client)return irq >0 ? irq : -ENXIO ; } +static bool allow_low_power_probe (struct device *dev) +{ +struct i2c_driver *driver =to_i2c_driver (dev->driver); + +return driver->flags &I2C_DRV_FL_ALLOW_LOW_POWER_PROBE && +device_property_present (dev,"allow-low-power-probe" ); +} +static int i2c_device_probe (struct device *dev) {struct i2c_client *client =i2c_verify_client (dev);
@@ -514,7 +522,8 @@ static int i2c_device_probe(struct device *dev)if (status <0 ) goto err_clear_wakeup_irq; - status =dev_pm_domain_attach (&client->dev, true); + status =dev_pm_domain_attach (&client->dev, + !allow_low_power_probe (&client->dev));if (status) goto err_clear_wakeup_irq;
@@ -536,7 +545,8 @@ static int i2c_device_probe(struct device *dev)return 0 ; err_detach_pm_domain: -dev_pm_domain_detach (&client->dev, true); +dev_pm_domain_detach (&client->dev, + !allow_low_power_probe (&client->dev)); err_clear_wakeup_irq:dev_pm_clear_wake_irq (&client->dev);device_init_wakeup (&client->dev, false);
@@ -562,7 +572,8 @@ static int i2c_device_remove(struct device *dev) status = driver->remove (client); } -dev_pm_domain_detach (&client->dev, true); +dev_pm_domain_detach (&client->dev, + !allow_low_power_probe (&client->dev));dev_pm_clear_wake_irq (&client->dev);device_init_wakeup (&client->dev, false);
include/linux/i2c.h +14 -0
@@ -11,6 +11,7 @@#define _LINUX_I2C_H#include <linux/acpi.h> /* for acpi_handle */ +#include <linux/bits.h> #include <linux/mod_devicetable.h> #include <linux/device.h> /* for struct device */ #include <linux/sched.h> /* for completion */
@@ -217,6 +218,16 @@ enum i2c_alert_protocol { I2C_PROTOCOL_SMBUS_HOST_NOTIFY, }; +/** +* enum i2c_driver_flags - Flags for an I2C device driver +* +* @I2C_DRV_FL_ALLOW_LOW_POWER_PROBE: Let the driver manage the device's power +* state during probe and remove +*/ +enum i2c_driver_flags { +I2C_DRV_FL_ALLOW_LOW_POWER_PROBE =BIT (0 ), +}; +/** * struct i2c_driver - represent an I2C device driver * @class: What kind of i2c device we instantiate (for detect)
@@ -231,6 +242,7 @@ enum i2c_alert_protocol {* @detect: Callback for device detection * @address_list: The I2C addresses to probe (for detect) * @clients: List of detected clients we created (for i2c-core use only) +* @flags: A bitmask of flags defined in &enum i2c_driver_flags * * The driver.owner field should be set to the module owner of this driver. * The driver.name field should be set to the name of this driver.
@@ -289,6 +301,8 @@ struct i2c_driver {int (*detect)(struct i2c_client *client,struct i2c_board_info *info);const unsigned short *address_list;struct list_head clients; + +unsigned int flags; };#define to_i2c_driver (d) container_of(d, struct i2c_driver, driver)
Signature · 1 line
2.20.1
Re: [PATCH v5 1/6] i2c: Allow driver to manage the device's power state during probe
Quoted 20 lines · Sakari Ailus
Enable drivers to tell ACPI that there's no need to power on a device for probe. Drivers should still perform this by themselves if there's a need to. In some cases powering on the device during probe is undesirable, and this change enables a driver to choose what fits best for it.
Add a field called "flags" into struct
i2c_driverfor driver flags, and a flagI2C_DRV_FL_ALLOW_LOW_POWER_PROBEto tell a driver supports probe in low power state.Signed-off-by Sakari Ailus <[email protected]>--- drivers/i2c/i2c-core-base.c | 17 ++++++++++++++--- include/linux/i2c.h | 14 ++++++++++++++ 2 files changed, 28 insertions(+), 3 deletions(-)drivers/i2c/i2c-core-base.c +0
-0
drivers/i2c/i2c-core-base.c static int i2c_smbus_host_notify_to_irq(const struct i2c_client *client) · line 444
Quoted 9 lines
drivers/i2c/i2c-core-base.c +6
-0@@ -436,6 +436,14 @@ static int i2c_smbus_host_notify_to_irq(const struct i2c_client *client)return irq >0 ? irq : -ENXIO ; } +static bool allow_low_power_probe (struct device *dev) +{ +struct i2c_driver *driver =to_i2c_driver (dev->driver); + +return driver->flags &I2C_DRV_FL_ALLOW_LOW_POWER_PROBE && +device_property_present (dev,"allow-low-power-probe" );
I assume this change makes even the DT property "allow-low-power-probe" work in the same way. Should we have proper DT binding for that ?
This comment applies for any property using device_property_* but has no explicit DT binding ? Just asking the question to know the strategy followed. Sorry if this is redundant question, feel free to point me to the past discussions.
--
Regards,
Sudeep
Sakari Ailus
maintainerRe: [PATCH v5 1/6] i2c: Allow driver to manage the device's power state during probe
Hi Sudeep,
Thanks for the review.
Quoted 34 lines · Sudeep Holla
Quoted 20 lines · Sakari Ailus
Enable drivers to tell ACPI that there's no need to power on a device for probe. Drivers should still perform this by themselves if there's a need to. In some cases powering on the device during probe is undesirable, and this change enables a driver to choose what fits best for it.
Add a field called "flags" into struct
i2c_driverfor driver flags, and a flagI2C_DRV_FL_ALLOW_LOW_POWER_PROBEto tell a driver supports probe in low power state.Signed-off-by Sakari Ailus <[email protected]>--- drivers/i2c/i2c-core-base.c | 17 ++++++++++++++--- include/linux/i2c.h | 14 ++++++++++++++ 2 files changed, 28 insertions(+), 3 deletions(-)drivers/i2c/i2c-core-base.c +0
-0drivers/i2c/i2c-core-base.c static int i2c_smbus_host_notify_to_irq(const struct i2c_client *client) · line 444
Quoted 9 lines
drivers/i2c/i2c-core-base.c +6
-0@@ -436,6 +436,14 @@ static int i2c_smbus_host_notify_to_irq(const struct i2c_client *client)return irq >0 ? irq : -ENXIO ; } +static bool allow_low_power_probe (struct device *dev) +{ +struct i2c_driver *driver =to_i2c_driver (dev->driver); + +return driver->flags &I2C_DRV_FL_ALLOW_LOW_POWER_PROBE && +device_property_present (dev,"allow-low-power-probe" );I assume this change makes even the DT property "allow-low-power-probe" work in the same way. Should we have proper DT binding for that ?
Quoted 4 lines
This comment applies for any property using device_property_* but has no explicit DT binding ? Just asking the question to know the strategy followed. Sorry if this is redundant question, feel free to point me to the past discussions.
It's not a redundant question, no.
I²C drivers on OF are responsible for controlling device's power state already (using runtime PM or without) so I think the drivers could use the property directly on OF systems (and document the property in DT bindings first) if there's a need to. IOW this code isn't needed on OF.
Note that the power_on or power_off arguments are not used by genpd_dev_pm_attach() or genpd_dev_pm_detach() so this patch only affects ACPI. I think I should check the device is an ACPI device above, for clarity.
Cc also DT list. The entire set is here:
<URL:https://lore.kernel.org/linux-acpi/[email protected]/>
Signature · 3 lines
Kind regards, Sakari Ailus
Sakari Ailus
maintainerPATCH v5 2/6 ACPI: Add a convenience function to tell a device is in low power state
In reply to Sakari AilusAdd a convenience function to tell whether a device is in low power state, primarily for use in drivers' probe or remove functions on busses where the custom is to power on the device for the duration of both.
Returns false on non-ACPI systems.
--- drivers/acpi/device_pm.c | 31 +++++++++++++++++++++++++++++++ include/linux/acpi.h | 5 +++++ 2 files changed, 36 insertions(+)
drivers/acpi/device_pm.c +31 -0
@@ -1344,4 +1344,35 @@ int acpi_dev_pm_attach(struct device *dev, bool power_on) return 1; }EXPORT_SYMBOL_GPL (acpi_dev_pm_attach); + +/** +* acpi_dev_state_low_power - Check the current ACPI power state of a device. +* @dev: Physical device the ACPI power state of which to check +* +* On a system without ACPI, return false. On a system with ACPI, return true if +* the current ACPI power state of the device is not D0, or false otherwise. +* +* Note that the power state of a device is not well-defined after it has been +* passed to acpi_device_set_power() and before that function returns, so it is +* not valid to ask for the ACPI power state of the device in that time frame. +*/ +bool acpi_dev_state_low_power (struct device *dev) +{ +struct acpi_device *adev =ACPI_COMPANION (dev); +int power_state; +int ret; + +if (!adev) +return false; + + ret =acpi_device_get_power (adev, &power_state); +if (ret) { +dev_dbg (dev,"Cannot obtain power state (%d)\n" , ret); +return false; + } + +return power_state !=ACPI_STATE_D0 ; +} +EXPORT_SYMBOL_GPL (acpi_dev_state_low_power); +#endif /* CONFIG_PM */
include/linux/acpi.h +5 -0
@@ -976,6 +976,7 @@ int acpi_dev_resume(struct device *dev);int acpi_subsys_runtime_suspend (struct device *dev);int acpi_subsys_runtime_resume (struct device *dev);int acpi_dev_pm_attach (struct device *dev,bool power_on); +bool acpi_dev_state_low_power (struct device *dev);#else static inline int acpi_dev_runtime_suspend (struct device *dev) {return 0 ; }static inline int acpi_dev_runtime_resume (struct device *dev) {return 0 ; }
@@ -985,6 +986,10 @@ static inline int acpi_dev_pm_attach(struct device *dev, bool power_on) {return 0 ; } +static inline bool acpi_dev_state_low_power (struct device *dev) +{ +return false; +}#endif #if defined(CONFIG_ACPI ) && defined(CONFIG_PM_SLEEP )
Signature · 1 line
2.20.1
Sakari Ailus
maintainerPATCH v5 3/6 ov5670: Support probe whilst the device is in a low power state
In reply to Sakari AilusTell ACPI device PM code that the driver supports the device being in a low power state when the driver's probe function is entered.
--- drivers/media/i2c/ov5670.c | 23 ++++++++++++++--------- 1 file changed, 14 insertions(+), 9 deletions(-)
drivers/media/i2c/ov5670.c +14 -9
@@ -2456,6 +2456,7 @@ static int ov5670_probe(struct i2c_client *client)struct ov5670 *ov5670;const char *err_msg;u32 input_clk =0 ; +bool low_power;int ret;device_property_read_u32 (&client->dev,"clock-frequency" , &input_clk);
@@ -2472,11 +2473,14 @@ static int ov5670_probe(struct i2c_client *client)/* Initialize subdev */ v4l2_i2c_subdev_init (&ov5670->sd, client, &ov5670_subdev_ops); -/* Check module identity */ - ret =ov5670_identify_module (ov5670); -if (ret) { - err_msg ="ov5670_identify_module() error" ; - goto error_print; + low_power =acpi_dev_state_low_power (&client->dev); +if (!low_power) { +/* Check module identity */ + ret =ov5670_identify_module (ov5670); +if (ret) { + err_msg ="ov5670_identify_module() error" ; + goto error_print; + } }mutex_init (&ov5670->mutex);
@@ -2513,10 +2517,10 @@ static int ov5670_probe(struct i2c_client *client) ov5670->streaming = false;/* -* Device is already turned on by i2c-core with ACPI domain PM. -* Enable runtime PM and turn off the device. +* Don't set the device's state to active if it's in a low power state. */ -pm_runtime_set_active (&client->dev); +if (!low_power) +pm_runtime_set_active (&client->dev);pm_runtime_enable (&client->dev);pm_runtime_idle (&client->dev);
@@ -2558,7 +2562,7 @@ static const struct dev_pm_ops ov5670_pm_ops = {#ifdef CONFIG_ACPI static const struct acpi_device_id ov5670_acpi_ids[] = { - {"INT3479" }, + {"INT3479" }, {/* sentinel */ } };
@@ -2573,6 +2577,7 @@ static struct i2c_driver ov5670_i2c_driver = { }, .probe_new = ov5670_probe, .remove = ov5670_remove, + .flags = I2C_DRV_FL_ALLOW_LOW_POWER_PROBE, };module_i2c_driver (ov5670_i2c_driver);
Signature · 1 line
2.20.1
Re: [PATCH v5 3/6] ov5670: Support probe whilst the device is in a low power state
Quoted 27 lines · Sakari Ailus
Tell ACPI device PM code that the driver supports the device being in a low power state when the driver's probe function is entered.
Signed-off-by Sakari Ailus <[email protected]>--- drivers/media/i2c/ov5670.c | 23 ++++++++++++++--------- 1 file changed, 14 insertions(+), 9 deletions(-)drivers/media/i2c/ov5670.c +1
-3@@ -2456,6 +2456,7 @@ static int ov5670_probe(struct i2c_client *client)struct ov5670 *ov5670;const char *err_msg;u32 input_clk =0 ; +bool low_power;int ret;device_property_read_u32 (&client->dev,"clock-frequency" , &input_clk);@@ -2472,11 +2473,14 @@ static int ov5670_probe(struct i2c_client *client)/* Initialize subdev */ v4l2_i2c_subdev_init (&ov5670->sd, client, &ov5670_subdev_ops); -/* Check module identity */ - ret =ov5670_identify_module (ov5670); -if (ret) {
drivers/media/i2c/ov5670.c static int ov5670_probe(struct i2c_client *client) · line 2483
Quoted 10 lines
drivers/media/i2c/ov5670.c +8
-2- err_msg ="ov5670_identify_module() error" ; - goto error_print; + low_power =acpi_dev_state_low_power (&client->dev); +if (!low_power) { +/* Check module identity */ + ret =ov5670_identify_module (ov5670); +if (ret) { + err_msg ="ov5670_identify_module() error" ; + goto error_print; +
Sakari, thanks for your patch.
one question - With this change, there will be no chance for driver to guarantee that the camera sensor plugged in is the camera that the matched driver actually can drive until try to streaming the camera, so is it necessary to return appropriate error in .s_stream ops to notify user it is not the hardware that current driver can drive? if no other better way.
Signature · 2 lines
Best regards, Bingbu Cao
Sakari Ailus
maintainerRe: [PATCH v5 3/6] ov5670: Support probe whilst the device is in a low power state
Hi Bingbu,
Thanks for the review.
Quoted 39 lines · Bingbu Cao
Quoted 36 lines · Sakari Ailus
Tell ACPI device PM code that the driver supports the device being in a low power state when the driver's probe function is entered.
Signed-off-by Sakari Ailus <[email protected]>--- drivers/media/i2c/ov5670.c | 23 ++++++++++++++--------- 1 file changed, 14 insertions(+), 9 deletions(-)drivers/media/i2c/ov5670.c +8
-5@@ -2456,6 +2456,7 @@ static int ov5670_probe(struct i2c_client *client)struct ov5670 *ov5670;const char *err_msg;u32 input_clk =0 ; +bool low_power;int ret;device_property_read_u32 (&client->dev,"clock-frequency" , &input_clk);@@ -2472,11 +2473,14 @@ static int ov5670_probe(struct i2c_client *client)/* Initialize subdev */ v4l2_i2c_subdev_init (&ov5670->sd, client, &ov5670_subdev_ops); -/* Check module identity */ - ret =ov5670_identify_module (ov5670); -if (ret) { - err_msg ="ov5670_identify_module() error" ; - goto error_print; + low_power =acpi_dev_state_low_power (&client->dev); +if (!low_power) { +/* Check module identity */ + ret =ov5670_identify_module (ov5670); +if (ret) { + err_msg ="ov5670_identify_module() error" ; + goto error_print;
Quoted 8 lines
drivers/media/i2c/ov5670.c static int ov5670_probe(struct i2c_client *client) · line 2483
Quoted 1 line
drivers/media/i2c/ov5670.c +1
-0+Sakari, thanks for your patch.
one question - With this change, there will be no chance for driver to guarantee that the camera sensor plugged in is the camera that the matched driver actually can drive until try to streaming the camera, so is it necessary to return appropriate error in .s_stream ops to notify user it is not the hardware that current driver can drive? if no other better way.
Indeed sensor identification is now skipped in probe. I'll add that for v6 --- and check other drivers, too.
Signature · 3 lines
Kind regards, Sakari Ailus
Re: [PATCH v5 3/6] ov5670: Support probe whilst the device is in a low power state
In reply to Bingbu CaoQuoted 39 lines · Bingbu Cao
Quoted 36 lines · Sakari Ailus
Tell ACPI device PM code that the driver supports the device being in a low power state when the driver's probe function is entered.
Signed-off-by Sakari Ailus <[email protected]>--- drivers/media/i2c/ov5670.c | 23 ++++++++++++++--------- 1 file changed, 14 insertions(+), 9 deletions(-)drivers/media/i2c/ov5670.c +8
-5@@ -2456,6 +2456,7 @@ static int ov5670_probe(struct i2c_client *client)struct ov5670 *ov5670;const char *err_msg;u32 input_clk =0 ; +bool low_power;int ret;device_property_read_u32 (&client->dev,"clock-frequency" , &input_clk);@@ -2472,11 +2473,14 @@ static int ov5670_probe(struct i2c_client *client)/* Initialize subdev */ v4l2_i2c_subdev_init (&ov5670->sd, client, &ov5670_subdev_ops); -/* Check module identity */ - ret =ov5670_identify_module (ov5670); -if (ret) { - err_msg ="ov5670_identify_module() error" ; - goto error_print; + low_power =acpi_dev_state_low_power (&client->dev); +if (!low_power) { +/* Check module identity */ + ret =ov5670_identify_module (ov5670); +if (ret) { + err_msg ="ov5670_identify_module() error" ; + goto error_print;
Quoted 8 lines
drivers/media/i2c/ov5670.c static int ov5670_probe(struct i2c_client *client) · line 2483
Quoted 1 line
drivers/media/i2c/ov5670.c +1
-0+Sakari, thanks for your patch.
one question - With this change, there will be no chance for driver to guarantee that the camera sensor plugged in is the camera that the matched driver actually can drive until try to streaming the camera, so is it necessary to return appropriate error in .s_stream ops to notify user it is not the hardware that current driver can drive? if no other better way.
Sakari, please ignore my previous comment, it is not related to this change. I see the sub device open is caused by v4l_id program from udev.
Quoted 1 line
Signature · 2 lines
Best regards, Bingbu Cao
Sakari Ailus
maintainerPATCH v5 4/6 media: i2c: imx319: Support probe while the device is off
In reply to Sakari AilusFrom: Rajmohan Mani <[email protected]>
Tell ACPI device PM code that the driver supports the device being powered off when the driver's probe function is entered.
--- drivers/media/i2c/imx319.c | 23 ++++++++++++++--------- 1 file changed, 14 insertions(+), 9 deletions(-)
drivers/media/i2c/imx319.c +14 -9
@@ -2424,6 +2424,7 @@ static struct imx319_hwcfg *imx319_get_hwcfg(struct device *dev)static int imx319_probe (struct i2c_client *client) {struct imx319 *imx319; +bool low_power;int ret;u32 i;
@@ -2436,11 +2437,14 @@ static int imx319_probe(struct i2c_client *client)/* Initialize subdev */ v4l2_i2c_subdev_init (&imx319->sd, client, &imx319_subdev_ops); -/* Check module identity */ - ret =imx319_identify_module (imx319); -if (ret) { -dev_err (&client->dev,"failed to find sensor: %d" , ret); - goto error_probe; + low_power =acpi_dev_state_low_power (&client->dev); +if (!low_power) { +/* Check module identity */ + ret =imx319_identify_module (imx319); +if (ret) { +dev_err (&client->dev,"failed to find sensor: %d" , ret); + goto error_probe; + } } imx319->hwcfg =imx319_get_hwcfg (&client->dev);
@@ -2493,10 +2497,10 @@ static int imx319_probe(struct i2c_client *client) goto error_media_entity;/* -* Device is already turned on by i2c-core with ACPI domain PM. -* Enable runtime PM and turn off the device. +* Don't set the device's state to active if it's in a low power state. */ -pm_runtime_set_active (&client->dev); +if (!low_power) +pm_runtime_set_active (&client->dev);pm_runtime_enable (&client->dev);pm_runtime_idle (&client->dev);
@@ -2536,7 +2540,7 @@ static const struct dev_pm_ops imx319_pm_ops = { };static const struct acpi_device_id imx319_acpi_ids[] = { - {"SONY319A" }, + {"SONY319A" , }, {/* sentinel */ } };MODULE_DEVICE_TABLE (acpi, imx319_acpi_ids);
@@ -2549,6 +2553,7 @@ static struct i2c_driver imx319_i2c_driver = { }, .probe_new = imx319_probe, .remove = imx319_remove, + .flags = I2C_DRV_FL_ALLOW_LOW_POWER_PROBE, };module_i2c_driver (imx319_i2c_driver);
Signature · 1 line
2.20.1
Sakari Ailus
maintainerPATCH v5 5/6 at24: Support probing while off
In reply to Sakari AilusIn certain use cases (where the chip is part of a camera module, and the camera module is wired together with a camera privacy LED), powering on the device during probe is undesirable. Add support for the at24 to execute probe while being powered off. For this to happen, a hint in form of a device property is required from the firmware.
--- drivers/misc/eeprom/at24.c | 40 ++++++++++++++++++++++++-------------- 1 file changed, 25 insertions(+), 15 deletions(-)
drivers/misc/eeprom/at24.c +25 -15
@@ -561,6 +561,7 @@ static int at24_probe(struct i2c_client *client)bool i2c_fn_i2c, i2c_fn_block;unsigned int i, num_addresses;struct at24_data *at24; +bool low_power;struct regmap *regmap;bool writable;u8 test_byte;
@@ -698,25 +699,30 @@ static int at24_probe(struct i2c_client *client)i2c_set_clientdata (client, at24); - err =regulator_enable (at24->vcc_reg); -if (err) { -dev_err (dev,"Failed to enable vcc regulator\n" ); -return err; - } + low_power =acpi_dev_state_low_power (&client->dev); +if (!low_power) { + err =regulator_enable (at24->vcc_reg); +if (err) { +dev_err (dev,"Failed to enable vcc regulator\n" ); +return err; + } -/* enable runtime pm */ -pm_runtime_set_active (dev); +pm_runtime_set_active (dev); + }pm_runtime_enable (dev);/* -* Perform a one-byte test read to verify that the -* chip is functional. +* Perform a one-byte test read to verify that the chip is functional, +* unless powering on the device is to be avoided during probe (i.e. +* it's powered off right now). */ - err =at24_read (at24,0 , &test_byte,1 ); -if (err) { -pm_runtime_disable (dev); -regulator_disable (at24->vcc_reg); -return -ENODEV ; +if (!low_power) { + err =at24_read (at24,0 , &test_byte,1 ); +if (err) { +pm_runtime_disable (dev); +regulator_disable (at24->vcc_reg); +return -ENODEV ; + } }pm_runtime_idle (dev);
@@ -734,11 +740,14 @@ static int at24_probe(struct i2c_client *client)static int at24_remove (struct i2c_client *client) {struct at24_data *at24 =i2c_get_clientdata (client); +bool low_power;pm_runtime_disable (&client->dev);if (!pm_runtime_status_suspended (&client->dev))regulator_disable (at24->vcc_reg); -pm_runtime_set_suspended (&client->dev); + low_power =acpi_dev_state_low_power (&client->dev); +if (!low_power) +pm_runtime_set_suspended (&client->dev);return 0 ; }
@@ -775,6 +784,7 @@ static struct i2c_driver at24_driver = { .probe_new = at24_probe, .remove = at24_remove, .id_table = at24_ids, + .flags = I2C_DRV_FL_ALLOW_LOW_POWER_PROBE, };static int __init at24_init (void )
Signature · 1 line
2.20.1
Sakari Ailus
maintainerPATCH v5 6/6 Documentation: ACPI: Document allow-low-power-probe _DSD property
In reply to Sakari AilusDocument the probe-low-power _DSD property and how it is used with I²C drivers.
--- .../acpi/dsd/allow-low-power-probe.rst | 28 +++++++++++++++++++ Documentation/firmware-guide/acpi/index.rst | 1 + 2 files changed, 29 insertions(+) create mode 100644 Documentation/firmware-guide/acpi/dsd/allow-low-power-probe.rst
Documentation/firmware-guide/acpi/dsd/allow-low-power-probe.rst new file +28 -0
@@ -0,0 +1,28 @@ +.. SPDX-License-Identifier: GPL-2.0 + +====================================== +Probing I²C devices in low power state +====================================== + +Introduction +============ + +In some cases it may be preferred to leave certain devices powered off for the +entire system bootup if powering on these devices has adverse side effects, +beyond just powering on the said device. Linux recognizes the _DSD property +"allow-low-power-probe" that can be used for this purpose. + +How it works +============ + +The property "allow-low-power-probe" boolean property may be used to tell Linux +that the I²C framework should instruct the kernel ACPI framework to leave the +device in the low power state. If the driver indicates its support for this by +setting the I2C_DRV_FL_ALLOW_LOW_POWER_PROBE flag in struct i2c_driver.flags +field and the "allow-low-power-probe" property is present, the device will not +be powered on for probe. + +The downside is that as the device is not powered on, even if there's a problem +with the device, the driver likely probes just fine but the first user will +find out the device doesn't work, instead of a failure at probe time. This +feature should thus be used sparingly.
Documentation/firmware-guide/acpi/index.rst +1 -0
@@ -11,6 +11,7 @@ ACPI Support dsd/graph dsd/data-node-references dsd/leds + dsd/allow-low-power-probe enumeration osi method-customizing
Signature · 1 line
2.20.1
Quoted 2 lines · Sakari Ailus
Hi all,
...snip...
Quoted 21 lines
The use case is such that there is a privacy LED next to an integrated user-facing laptop camera, and this LED is there to signal the user that the camera is recording a video or capturing images. That LED also happens to be wired to one of the power supplies of the camera, so whenever you power on the camera, the LED will be lit, whether images are captured from the camera --- or not. There's no way to implement this differently without additional software control (allowing of which is itself a hardware design decision) on most CSI-2-connected camera sensors as they simply have no pin to signal the camera streaming state.
This is also what happens during driver probe: the camera will be powered on by the I²C subsystem calling
dev_pm_domain_attach()and the device is already powered on when the driver's own probe function is called. To the user this visible during the boot process as a blink of the privacy LED, suggesting that the camera is recording without the user having used an application to do that. From the end user's point of view the behaviour is not expected and for someone unfamiliar with internal workings of a computer surely seems quite suspicious --- even if images are not being actually captured.
Quoted 4 lines
I've tested these on linux-next master. They also apply to Wolfram's i2c/for-next branch, there's a patch that affects the I²C core changes here (see below). The patches apart from that apply to Bartosz's at24/for-next as well as Mauro's linux-media master branch.
Sakari, we meet one issue - once the vcm sub-device registered, the user space will try to open the VCM (I have not figure out who did that), it will also trigger the acpi pm resume/suspend, as the VCM always shares same power rail with camera sensor, so the privacy LED still has a blink.
Quoted 1 line
...snip...
Signature · 2 lines
Best regards, Bingbu Cao
Quoted 32 lines · Bingbu Cao
Quoted 2 lines · Sakari Ailus
Hi all,
...snip...
Quoted 21 lines
The use case is such that there is a privacy LED next to an integrated user-facing laptop camera, and this LED is there to signal the user that the camera is recording a video or capturing images. That LED also happens to be wired to one of the power supplies of the camera, so whenever you power on the camera, the LED will be lit, whether images are captured from the camera --- or not. There's no way to implement this differently without additional software control (allowing of which is itself a hardware design decision) on most CSI-2-connected camera sensors as they simply have no pin to signal the camera streaming state.
This is also what happens during driver probe: the camera will be powered on by the I²C subsystem calling
dev_pm_domain_attach()and the device is already powered on when the driver's own probe function is called. To the user this visible during the boot process as a blink of the privacy LED, suggesting that the camera is recording without the user having used an application to do that. From the end user's point of view the behaviour is not expected and for someone unfamiliar with internal workings of a computer surely seems quite suspicious --- even if images are not being actually captured.Quoted 4 lines
I've tested these on linux-next master. They also apply to Wolfram's i2c/for-next branch, there's a patch that affects the I²C core changes here (see below). The patches apart from that apply to Bartosz's at24/for-next as well as Mauro's linux-media master branch.
Quoted 4 lines
Sakari, we meet one issue - once the vcm sub-device registered, the user space will try to open the VCM (I have not figure out who did that), it will also trigger the acpi pm resume/suspend, as the VCM always shares same power rail with camera sensor, so the privacy LED still has a blink.
Sakari, please ignore my previous comment, it is not related to this change. I see the sub device open is caused by v4l_id program from udev.
Quoted 4 lines
Quoted 2 lines
...snip...
Signature · 2 lines
Best regards, Bingbu Cao
Quoted 33 lines · Bingbu Cao
Quoted 2 lines · Sakari Ailus
Hi all,
...snip...
Quoted 21 lines
The use case is such that there is a privacy LED next to an integrated user-facing laptop camera, and this LED is there to signal the user that the camera is recording a video or capturing images. That LED also happens to be wired to one of the power supplies of the camera, so whenever you power on the camera, the LED will be lit, whether images are captured from the camera --- or not. There's no way to implement this differently without additional software control (allowing of which is itself a hardware design decision) on most CSI-2-connected camera sensors as they simply have no pin to signal the camera streaming state.
This is also what happens during driver probe: the camera will be powered on by the I²C subsystem calling
dev_pm_domain_attach()and the device is already powered on when the driver's own probe function is called. To the user this visible during the boot process as a blink of the privacy LED, suggesting that the camera is recording without the user having used an application to do that. From the end user's point of view the behaviour is not expected and for someone unfamiliar with internal workings of a computer surely seems quite suspicious --- even if images are not being actually captured.Quoted 4 lines
I've tested these on linux-next master. They also apply to Wolfram's i2c/for-next branch, there's a patch that affects the I²C core changes here (see below). The patches apart from that apply to Bartosz's at24/for-next as well as Mauro's linux-media master branch.
Quoted 4 lines
Sakari, we meet one issue - once the vcm sub-device registered, the user space will try to open the VCM (I have not figure out who did that), it will also trigger the acpi pm resume/suspend, as the VCM always shares same power rail with camera sensor, so the privacy LED still has a blink.
It's not always the case, as on some designs there are multiple power rails to the sensor and one drives the LED, while the other drives the VCM. That said, it would be still good to solve it in either case.
Perhaps we need some more general discussion on the side effects of simply opening and querying a device. Most of V4L2 drivers these days are designed to avoid powering up the hardware until it's absolutely needed to do so. However, for non-streaming subdevs that are directly controlled by the userspace, like VCM, it's a common practice to power up on open and down on release. This is because they don't have a "streaming" state, so the driver has no way to determine when the power is needed. I wonder if there is a way to improve this.
Best regards,
Tomasz
Sakari Ailus
maintainerHi Tomasz, Bingbu,
Quoted 43 lines · Tomasz Figa
Quoted 33 lines · Bingbu Cao
Quoted 2 lines · Sakari Ailus
Hi all,
...snip...
Quoted 21 lines
The use case is such that there is a privacy LED next to an integrated user-facing laptop camera, and this LED is there to signal the user that the camera is recording a video or capturing images. That LED also happens to be wired to one of the power supplies of the camera, so whenever you power on the camera, the LED will be lit, whether images are captured from the camera --- or not. There's no way to implement this differently without additional software control (allowing of which is itself a hardware design decision) on most CSI-2-connected camera sensors as they simply have no pin to signal the camera streaming state.
This is also what happens during driver probe: the camera will be powered on by the I²C subsystem calling
dev_pm_domain_attach()and the device is already powered on when the driver's own probe function is called. To the user this visible during the boot process as a blink of the privacy LED, suggesting that the camera is recording without the user having used an application to do that. From the end user's point of view the behaviour is not expected and for someone unfamiliar with internal workings of a computer surely seems quite suspicious --- even if images are not being actually captured.Quoted 4 lines
I've tested these on linux-next master. They also apply to Wolfram's i2c/for-next branch, there's a patch that affects the I²C core changes here (see below). The patches apart from that apply to Bartosz's at24/for-next as well as Mauro's linux-media master branch.
Quoted 4 lines
Sakari, we meet one issue - once the vcm sub-device registered, the user space will try to open the VCM (I have not figure out who did that), it will also trigger the acpi pm resume/suspend, as the VCM always shares same power rail with camera sensor, so the privacy LED still has a blink.
It's not always the case, as on some designs there are multiple power rails to the sensor and one drives the LED, while the other drives the VCM. That said, it would be still good to solve it in either case.
Quoted 8 lines
Perhaps we need some more general discussion on the side effects of simply opening and querying a device. Most of V4L2 drivers these days are designed to avoid powering up the hardware until it's absolutely needed to do so. However, for non-streaming subdevs that are directly controlled by the userspace, like VCM, it's a common practice to power up on open and down on release. This is because they don't have a "streaming" state, so the driver has no way to determine when the power is needed. I wonder if there is a way to improve this.
Good question.
I think in this particular case the device could be powered on only when there's an open file handle and current is applied on the coil (i.e. the control's value is non-zero).
But in general case more IOCTLs would be needed. PM QoS framework could be used for the purpose based on wakeup latency. I guess no-one has needed it badly enough to implement the support? This would be actually a better approach. In any case in the case of the lens it requires that the current behaviour of powering on the device based on just open file handles would have to change.
Signature · 3 lines
Kind regards, Sakari Ailus