linux.git/include/linux/i2c.h, branch v5.7-rc2

i2c: remove i2c_new_probed_device API

2020-04-15T09:48:21+00:00

All in-tree users have been converted to the new i2c_new_scanned_device
function, so remove this deprecated one.

Signed-off-by: Wolfram Sang 
Signed-off-by: Wolfram Sang

Merge branch 'i2c/for-5.7' of git://git.kernel.org/pub/scm/linux/kernel/git/wsa/linux

2020-04-02T22:54:13+00:00

Pull i2c updates from Wolfram Sang:
 "I2C has:

   - using defines for bus speeds to avoid mistakes in hardcoded values;
     lots of small driver updates because of that. Thanks, Andy!

   - API change: i2c_setup_smbus_alert() was renamed to
     i2c_new_smbus_alert_device() and returns ERRPTR now. All in-tree
     users have been converted

   - in the core, a rare race condition when deleting the cdev has been
     fixed. Thanks, Kevin!

   - lots of driver updates. Thanks, everyone!

  I also want to mention: The amount of review and testing tags given
  was quite high this time. Thank you to these people, too. I hope we
  can keep it like this!"

* 'i2c/for-5.7' of git://git.kernel.org/pub/scm/linux/kernel/git/wsa/linux: (34 commits)
  i2c: rcar: clean up after refactoring i2c_timings
  macintosh: convert to i2c_new_scanned_device
  i2c: drivers: Use generic definitions for bus frequencies
  i2c: algo: Use generic definitions for bus frequencies
  i2c: stm32f7: switch to I²C generic property parsing
  i2c: rcar: Consolidate timings calls in rcar_i2c_clock_calculate()
  i2c: core: Allow override timing properties with 0
  i2c: core: Provide generic definitions for bus frequencies
  i2c: mxs: Use dma_request_chan() instead dma_request_slave_channel()
  i2c: imx: remove duplicate print after platform_get_irq()
  i2c: designware: Fix spelling typos in the comments
  i2c: designware: Discard i2c_dw_read_comp_param() function
  i2c: designware: Detect the FIFO size in the common code
  i2c: dev: Fix the race between the release of i2c_dev and cdev
  i2c: qcom-geni: Drop of_platform.h include
  i2c: qcom-geni: Grow a dev pointer to simplify code
  i2c: qcom-geni: Let firmware specify irq trigger flags
  i2c: stm32f7: do not backup read-only PECR register
  i2c: smbus: remove outdated references to irq level triggers
  i2c: convert SMBus alert setup function to return an ERRPTR
  ...

i2c: core: Provide generic definitions for bus frequencies

2020-03-24T20:58:51+00:00

There are few maximum bus frequencies being used in the I²C core code.
Provide generic definitions for bus frequencies and use them in the core.

The drivers may use predefined constants where it is appropriate.
Some of them are already using these under slightly different names.
We will convert them later to use newly introduced defines.

Note, the name of modes are chosen to follow well established naming
scheme [1].

These definitions will also help to avoid typos in the numbers that
may lead to subtle errors.

[1]: https://en.wikipedia.org/wiki/I%C2%B2C#Differences_between_modes

Acked-by: Mika Westerberg 
Signed-off-by: Andy Shevchenko 
Signed-off-by: Wolfram Sang

i2c: fix a doc warning

2020-03-23T10:17:22+00:00

Don't let non-letters inside a literal block without escaping it, as
the toolchain would mis-interpret it:

./include/linux/i2c.h:518: WARNING: Inline strong start-string without end-string.

Signed-off-by: Mauro Carvalho Chehab 
Signed-off-by: Wolfram Sang

i2c: remove unneeded 'extern' from function declatations

2019-12-17T15:48:34+00:00

According to coding-style.rst, extern should not be specified for
exported functions.

Signed-off-by: Luca Ceresoli 
Signed-off-by: Wolfram Sang

i2c: add helper to check if a client has a driver attached

2019-12-11T07:39:07+00:00

As a preparation for an API conversion, factor out something frequently
used in the media subsystem. As an improvement, it bails out on both,
NULL and ERRPTR to handle the old and new API.

Signed-off-by: Wolfram Sang 
Signed-off-by: Wolfram Sang

i2c: fix header file kernel-doc warning

2019-12-10T22:16:10+00:00

Fix kernel-doc warning in .

../include/linux/i2c.h:337: warning: Function parameter or member 'init_irq' not described in 'i2c_client'

Signed-off-by: Randy Dunlap 
Signed-off-by: Wolfram Sang

i2c: remove i2c_new_dummy() API

2019-12-10T22:15:09+00:00

All in-kernel users have been converted to
{devm_}i2c_new_dummy_device(). Remove the old API.

Signed-off-by: Wolfram Sang 
Reviewed-by: Niklas Söderlund 
Tested-by: Luca Ceresoli 
Reviewed-by: Luca Ceresoli 
Signed-off-by: Wolfram Sang

i2c: replace i2c_new_probed_device with an ERR_PTR variant

2019-11-28T16:15:21+00:00

In the general move to have i2c_new_*_device functions which return
ERR_PTR instead of NULL, this patch converts i2c_new_probed_device().

There are only few users, so this patch converts the I2C core and all
users in one go. The function gets renamed to i2c_new_scanned_device()
so out-of-tree users will get a build failure to understand they need to
adapt their error checking code.

Signed-off-by: Wolfram Sang 
Reviewed-by: Luca Ceresoli 
Reviewed-by: Max Staudt 
Signed-off-by: Wolfram Sang

i2c: remove helpers for ref-counting clients

2019-11-15T21:04:48+00:00

There are no in-tree users of these helpers anymore, and there
shouldn't. Most use cases went away once the driver model started to
refcount for us. There have been users like the media subsystem, but
they all switched to better refcounting methods meanwhile. Media did
this in 2008. Last user (IPMI) left 2018. Remove this cruft.

Signed-off-by: Wolfram Sang 
Reviewed-by: Niklas Söderlund 
Reviewed-by: Jean Delvare 
Tested-by: Luca Ceresoli 
Reviewed-by: Luca Ceresoli 
Reviewed-by: Geert Uytterhoeven