diff mbox series

[v1,1/1] i2c: designware: Add a note about struct dw_scl_sda_cfg usage

Message ID 20211203171318.62503-1-andriy.shevchenko@linux.intel.com
State Superseded
Headers show
Series [v1,1/1] i2c: designware: Add a note about struct dw_scl_sda_cfg usage | expand

Commit Message

Andy Shevchenko Dec. 3, 2021, 5:13 p.m. UTC
Add a note about struct dw_scl_sda_cfg usage to discourage people
of using this structure on new platforms. Instead they should try
hard to put the needed information into firmware descriptions.

Signed-off-by: Andy Shevchenko <andriy.shevchenko@linux.intel.com>
---
 drivers/i2c/busses/i2c-designware-pcidrv.c | 7 +++++++
 1 file changed, 7 insertions(+)

Comments

Andy Shevchenko Dec. 7, 2021, 6:41 p.m. UTC | #1
On Fri, Dec 03, 2021 at 07:13:18PM +0200, Andy Shevchenko wrote:
> Add a note about struct dw_scl_sda_cfg usage to discourage people
> of using this structure on new platforms. Instead they should try
> hard to put the needed information into firmware descriptions.

Scratch this, I will send a bigger series where I incorporate this one into.
diff mbox series

Patch

diff --git a/drivers/i2c/busses/i2c-designware-pcidrv.c b/drivers/i2c/busses/i2c-designware-pcidrv.c
index 0f409a4c2da0..3ba506c3a9a9 100644
--- a/drivers/i2c/busses/i2c-designware-pcidrv.c
+++ b/drivers/i2c/busses/i2c-designware-pcidrv.c
@@ -38,6 +38,13 @@  enum dw_pci_ctl_id_t {
 	navi_amd,
 };
 
+/*
+ * This is a legacy structure to describe the hardware counters
+ * to configure signal timings on the bus. For Device Tree platforms
+ * one should use the respective properties and for ACPI there is
+ * a set of ACPI methods that provide these counters. No new
+ * platform should use this structure.
+ */
 struct dw_scl_sda_cfg {
 	u32 ss_hcnt;
 	u32 fs_hcnt;