i2c: designware: Improve device disable handling
Subsystems (3)
v4 cover i2c: designware: Improve device disable handling
When the I2C controller attempts a new transaction while the target controller is shutting down or restarting, it can lead to bus lockups and system bootloops if the hardware enters an inconsistent state.
This patch series addresses this by ensuring that the internal state machines are properly cleared when disabling the controller if target activity is detected.
Additionally, it adds a shutdown hook that gracefully sets the target disable bit before disabling the controller. This guarantees that any incoming requests from the controller are immediately NACKed during shutdown, preventing the bus from hanging.
---
Changes in v4:
- Updated language to use inclusive terms
- Refactored some minor comment / code nits
- Link to v3: https://lore.kernel.org/r/[email protected]
Changes in v3:
- Split the monolithic patch into 4 logical patches
- Reverted stray formatting change in the PCI driver's dw_i2c_driver struct. Changes in v2:
- Fix description footers
- Fix emails
---
William A. Kennington III (4):
i2c: designware: Introduce shutdown exported function
i2c: designware: Convert PCI driver to use shutdown hook
i2c: designware: Convert platform driver to use shutdown hook
i2c: designware: Handle active target cleanly
drivers/i2c/busses/i2c-designware-common.c | 32 +++++++++++++++++++++++++++++ drivers/i2c/busses/i2c-designware-core.h | 1 + drivers/i2c/busses/i2c-designware-master.c | 31 +++++++++++++++++----------- drivers/i2c/busses/i2c-designware-pcidrv.c | 14 +++++++++++++ drivers/i2c/busses/i2c-designware-platdrv.c | 14 +++++++++++++ 5 files changed, 80 insertions(+), 12 deletions(-)
---
base-commit: 5862221fddede6bb15566ab3c1f23a3c353da5e1
change-id: 20260504-dw-i2c-d5a1b1a0036a
Best regards,
Signature · 1 line
William A. Kennington III <[email protected]>
PATCH v4 1/4 i2c: designware: Introduce shutdown exported function
Introduce an exported shutdown function to safely shutdown the DesignWare I2C controller.
This shutdown hook gracefully sets the target disable bit before disabling the controller. This guarantees that any incoming requests from the controller are immediately NACKed during shutdown, preventing the bus from hanging.
--- drivers/i2c/busses/i2c-designware-common.c | 24 ++++++++++++++++++++++++ drivers/i2c/busses/i2c-designware-core.h | 1 + 2 files changed, 25 insertions(+)
drivers/i2c/busses/i2c-designware-common.c +24 -0
@@ -1028,5 +1028,29 @@ EXPORT_GPL_DEV_PM_OPS(i2c_dw_dev_pm_ops) = { RUNTIME_PM_OPS(i2c_dw_runtime_suspend, i2c_dw_runtime_resume, NULL) }; +void i2c_dw_shutdown (struct dw_i2c_dev *dev) +{ +unsigned int con; + +/* +* We only need to handle shutdown for target mode to ensure +* we NACK any incoming controller requests. Master mode cleanup +* is handled after each transfer in i2c_dw_xfer(). +*/ +if (dev->mode !=DW_IC_SLAVE ) +return ; + +/* +* To quickly NACK the controller during shutdown, we set the target +* disable bit while the controller is still enabled. +*/ +regmap_read (dev->map,DW_IC_CON , &con); + con |=DW_IC_CON_SLAVE_DISABLE ; +regmap_write (dev->map,DW_IC_CON , con); + +i2c_dw_disable (dev); +} +EXPORT_SYMBOL_GPL (i2c_dw_shutdown); +MODULE_DESCRIPTION ("Synopsys DesignWare I2C bus adapter core" );MODULE_LICENSE ("GPL" );
drivers/i2c/busses/i2c-designware-core.h +1 -0
@@ -417,6 +417,7 @@ static inline void i2c_dw_configure(struct dw_i2c_dev *dev)int i2c_dw_probe (struct dw_i2c_dev *dev);int i2c_dw_init (struct dw_i2c_dev *dev); +void i2c_dw_shutdown (struct dw_i2c_dev *dev);void i2c_dw_set_mode (struct dw_i2c_dev *dev,int mode);#if IS_ENABLED (CONFIG_I2C_DESIGNWARE_BAYTRAIL )
Signature · 1 line
2.54.0.563.g4f69b47b94-goog
Andy Shevchenko
reviewerRe: [PATCH v4 1/4] i2c: designware: Introduce shutdown exported function
Quoted 7 lines · William A. Kennington III
Introduce an exported shutdown function to safely shutdown the DesignWare I2C controller.
This shutdown hook gracefully sets the target disable bit before disabling the controller. This guarantees that any incoming requests from the controller are immediately NACKed during shutdown, preventing the bus from hanging.
...
drivers/i2c/busses/i2c-designware-common.c EXPORT_GPL_DEV_PM_OPS(i2c_dw_dev_pm_ops) = { · line 1037
Quoted 3 lines
drivers/i2c/busses/i2c-designware-common.c +3
-0+/* +* We only need to handle shutdown for target mode to ensure +* we NACK any incoming controller requests. Master mode cleanup
Master --> Controller
Quoted 2 lines
(quoted diff) +2
-0+ * is handled after each transfer in i2c_dw_xfer(). + */
Signature · 2 lines
With Best Regards, Andy Shevchenko
Re: [PATCH v4 1/4] i2c: designware: Introduce shutdown exported function
Quoted 1 line · Andy Shevchenko
On Thu, May 07, 2026 at 08:05:15PM +0000, William A. Kennington III wrote:
...
Quoted 8 lines
drivers/i2c/busses/i2c-designware-common.c EXPORT_GPL_DEV_PM_OPS(i2c_dw_dev_pm_ops) = { · line 1037
Quoted 3 lines
drivers/i2c/busses/i2c-designware-common.c +3
-0+/* +* We only need to handle shutdown for target mode to ensure +* we NACK any incoming controller requests. Master mode cleanup Master --> Controller
Review
Quoted 2 lines
(quoted diff) +2
-0+ * is handled after each transfer in i2c_dw_xfer(). + */
With that fixed,
Signature · 2 lines
With Best Regards, Andy Shevchenko
PATCH v4 2/4 i2c: designware: Convert PCI driver to use shutdown hook
In reply to William A. Kennington IIIConvert the PCI driver to use the new i2c_dw_shutdown() hook, allowing the controller to gracefully NACK master requests during system shutdown.
--- drivers/i2c/busses/i2c-designware-pcidrv.c | 14 ++++++++++++++ 1 file changed, 14 insertions(+)
drivers/i2c/busses/i2c-designware-pcidrv.c +14 -0
@@ -356,10 +356,24 @@ static const struct pci_device_id i2c_designware_pci_ids[] = { };MODULE_DEVICE_TABLE (pci, i2c_designware_pci_ids); +static void i2c_dw_pci_shutdown (struct pci_dev *pdev) +{ +struct dw_i2c_dev *i_dev; + + i_dev =pci_get_drvdata (pdev); +if (!i_dev) +return ; + +pm_runtime_disable (&pdev->dev); +if (!pm_runtime_status_suspended (&pdev->dev)) +i2c_dw_shutdown (i_dev); +} +static struct pci_driver dw_i2c_driver = { .name =DRIVER_NAME , .probe = i2c_dw_pci_probe, .remove = i2c_dw_pci_remove, + .shutdown = i2c_dw_pci_shutdown, .driver = { .pm =pm_ptr (&i2c_dw_dev_pm_ops), },
Signature · 1 line
2.54.0.563.g4f69b47b94-goog
Andy Shevchenko
reviewerRe: [PATCH v4 2/4] i2c: designware: Convert PCI driver to use shutdown hook
Quoted 2 lines · William A. Kennington III
Convert the PCI driver to use the new
i2c_dw_shutdown()hook, allowing the controller to gracefully NACK master requests during system shutdown.
...
drivers/i2c/busses/i2c-designware-pcidrv.c static const struct pci_device_id i2c_designware_pci_ids[] = { · line 368
Quoted 11 lines
drivers/i2c/busses/i2c-designware-pcidrv.c +10
-0+static void i2c_dw_pci_shutdown (struct pci_dev *pdev) +{ +struct dw_i2c_dev *i_dev; + + i_dev =pci_get_drvdata (pdev); +if (!i_dev) +return ; + +pm_runtime_disable (&pdev->dev); +if (!pm_runtime_status_suspended (&pdev->dev))
There is a difference between pm_runtime_status_suspended() and pm_runtime_suspended(). Are you sure you use the proper call here? (Please, double check.)
Quoted 2 lines
drivers/i2c/busses/i2c-designware-pcidrv.c +2
-0+i2c_dw_shutdown (i_dev); +}
Signature · 2 lines
With Best Regards, Andy Shevchenko
Re: [PATCH v4 2/4] i2c: designware: Convert PCI driver to use shutdown hook
Quoted 4 lines · Andy Shevchenko
Quoted 2 lines · William A. Kennington III
Convert the PCI driver to use the new
i2c_dw_shutdown()hook, allowing the controller to gracefully NACK master requests during system shutdown....
Done
Quoted 14 lines
drivers/i2c/busses/i2c-designware-pcidrv.c static const struct pci_device_id i2c_designware_pci_ids[] = { · line 368
Quoted 11 lines
drivers/i2c/busses/i2c-designware-pcidrv.c +10
-0+static void i2c_dw_pci_shutdown (struct pci_dev *pdev) +{ +struct dw_i2c_dev *i_dev; + + i_dev =pci_get_drvdata (pdev); +if (!i_dev) +return ; + +pm_runtime_disable (&pdev->dev); +if (!pm_runtime_status_suspended (&pdev->dev))There is a difference between
pm_runtime_status_suspended()andpm_runtime_suspended(). Are you sure you use the proper call here? (Please, double check.)
pm_runtime_suspend() would always return false after pm_runtime_disable()
Quoted 3 lines
Quoted 3 lines
drivers/i2c/busses/i2c-designware-pcidrv.c +2
-0+i2c_dw_shutdown (i_dev); +}
PATCH v4 3/4 i2c: designware: Convert platform driver to use shutdown hook
In reply to William A. Kennington IIIConvert the platform driver to use the new i2c_dw_shutdown() hook, allowing the controller to gracefully NACK master requests during system shutdown.
--- drivers/i2c/busses/i2c-designware-platdrv.c | 14 ++++++++++++++ 1 file changed, 14 insertions(+)
drivers/i2c/busses/i2c-designware-platdrv.c +14 -0
@@ -289,9 +289,23 @@ static const struct platform_device_id dw_i2c_platform_ids[] = { };MODULE_DEVICE_TABLE (platform, dw_i2c_platform_ids); +static void dw_i2c_plat_shutdown (struct platform_device *pdev) +{ +struct dw_i2c_dev *i_dev; + + i_dev =platform_get_drvdata (pdev); +if (!i_dev) +return ; + +pm_runtime_disable (&pdev->dev); +if (!pm_runtime_status_suspended (&pdev->dev)) +i2c_dw_shutdown (i_dev); +} +static struct platform_driver dw_i2c_driver = { .probe = dw_i2c_plat_probe, .remove = dw_i2c_plat_remove, + .shutdown = dw_i2c_plat_shutdown, .driver = { .name ="i2c_designware" , .of_match_table = dw_i2c_of_match,
Signature · 1 line
2.54.0.563.g4f69b47b94-goog
Andy Shevchenko
reviewerRe: [PATCH v4 3/4] i2c: designware: Convert platform driver to use shutdown hook
Quoted 3 lines · William A. Kennington III
Convert the platform driver to use the new
i2c_dw_shutdown()hook, allowing the controller to gracefully NACK master requests during system shutdown.
...
drivers/i2c/busses/i2c-designware-platdrv.c static const struct platform_device_id dw_i2c_platform_ids[] = { · line 301
Quoted 1 line
drivers/i2c/busses/i2c-designware-platdrv.c +1
-0+if (!pm_runtime_status_suspended (&pdev->dev))
Same question here.
Signature · 2 lines
With Best Regards, Andy Shevchenko
Re: [PATCH v4 3/4] i2c: designware: Convert platform driver to use shutdown hook
Quoted 8 lines · Andy Shevchenko
Quoted 3 lines · William A. Kennington III
Convert the platform driver to use the new
i2c_dw_shutdown()hook, allowing the controller to gracefully NACK master requests during system shutdown....
drivers/i2c/busses/i2c-designware-platdrv.c static const struct platform_device_id dw_i2c_platform_ids[] = { · line 301
Quoted 1 line
drivers/i2c/busses/i2c-designware-platdrv.c +1
-0+if (!pm_runtime_status_suspended (&pdev->dev))Same question here.
ACK on previous message
PATCH v4 4/4 i2c: designware: Handle active target cleanly
In reply to William A. Kennington IIIWhen the I2C controller attempts a new transaction while the target controller is shutting down or restarting, it can lead to bus lockups and system bootloops if the hardware enters an inconsistent state.
Address this by ensuring that the internal state machines are properly cleared when disabling the controller if target activity is detected.
If the controller remains active after disabling, perform a bus recovery to reset it to a known good state.
--- drivers/i2c/busses/i2c-designware-common.c | 8 ++++++++ drivers/i2c/busses/i2c-designware-master.c | 31 ++++++++++++++++++------------ 2 files changed, 27 insertions(+), 12 deletions(-)
drivers/i2c/busses/i2c-designware-common.c +8 -0
@@ -633,6 +633,14 @@ void __i2c_dw_disable(struct dw_i2c_dev *dev) abort_needed = (raw_intr_stats &DW_IC_INTR_MST_ON_HOLD ) || (ic_stats &DW_IC_STATUS_MASTER_HOLD_TX_FIFO_EMPTY ); + +/* +* If we are in target mode and there is activity, we should also +* trigger an abort to clear the internal state machines. +*/ +if (dev->mode ==DW_IC_SLAVE && (ic_stats &DW_IC_STATUS_SLAVE_ACTIVITY )) + abort_needed = true; +if (abort_needed) {if (!(enable &DW_IC_ENABLE_ENABLE )) {regmap_write (dev->map,DW_IC_ENABLE ,DW_IC_ENABLE_ENABLE );
drivers/i2c/busses/i2c-designware-master.c +19 -12
@@ -785,18 +785,25 @@ __i2c_dw_xfer_one_part(struct dw_i2c_dev *dev, struct i2c_msg *msgs, size_t num)* IC_RAW_INTR_STAT.MASTER_ON_HOLD holding SCL low. Check if * controller is still ACTIVE before disabling I2C. */ -if (i2c_dw_is_controller_active (dev)) -dev_err (dev->dev,"controller active\n" ); - -/* -* We must disable the adapter before returning and signaling the end -* of the current transfer. Otherwise the hardware might continue -* generating interrupts which in turn causes a race condition with -* the following transfer. Needs some more investigation if the -* additional interrupts are a hardware bug or this driver doesn't -* handle them correctly yet. -*/ -__i2c_dw_disable_nowait (dev); +if (i2c_dw_is_controller_active (dev)) { +/* +* If the controller is still active after the timeout, attempt a +* bus recovery to clear any potentially locked state. +*/ +dev_err (dev->dev,"controller active after xfer, recovering\n" ); +i2c_recover_bus (&dev->adapter); +i2c_dw_init (dev); + }else { +/* +* We must disable the adapter before returning and signaling the end +* of the current transfer. Otherwise the hardware might continue +* generating interrupts which in turn causes a race condition with +* the following transfer. Needs some more investigation if the +* additional interrupts are a hardware bug or this driver doesn't +* handle them correctly yet. +*/ +__i2c_dw_disable_nowait (dev); + }if (dev->msg_err)return dev->msg_err;
Signature · 1 line
2.54.0.563.g4f69b47b94-goog
Re: [PATCH v4 4/4] i2c: designware: Handle active target cleanly
Quoted 9 lines · William A. Kennington III
When the I2C controller attempts a new transaction while the target controller is shutting down or restarting, it can lead to bus lockups and system bootloops if the hardware enters an inconsistent state.
Address this by ensuring that the internal state machines are properly cleared when disabling the controller if target activity is detected.
If the controller remains active after disabling, perform a bus recovery to reset it to a known good state.
Signature · 2 lines
With Best Regards, Andy Shevchenko