linux.git/Documentation/i2c, branch v5.8

i2c: slave-eeprom: update documentation

2020-07-04T06:17:53+00:00

Add more details which have either been missing ever since or describe
recent additions.

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

Documentation/i2c: SMBus start signal is S not A

2020-06-19T07:21:48+00:00

Just like all other I2C/SMBus commands, the start signal for the SMBus
Quick Command is S, not A.

Fixes: 1da177e4c3f4 ("Linux-2.6.12-rc2")
Signed-off-by: Daniel Schaefer 
Signed-off-by: Wolfram Sang

docs: i2c: rename i2c.svg to i2c_bus.svg

2020-04-20T21:45:41+00:00

When generating the PDF output, the Documentation/i2c dir
will generate an i2c.pdf. The same happens with i2c.svg:
it will also produce a file with the same name, at the same dir.

This causes errors when building the PDF output. So, rename the
image to i2c_bus.svg.

Signed-off-by: Mauro Carvalho Chehab 
Acked-by: Wolfram Sang 
Link: https://lore.kernel.org/r/ecf3d51909ce46b3e84a1df4b36f07d76989e5da.1586881715.git.mchehab+huawei@kernel.org
Signed-off-by: Jonathan Corbet

i2c: convert SMBus alert setup function to return an ERRPTR

2020-03-10T11:19:52+00:00

Only few drivers use this call, so drivers and I2C core are converted at
once with this patch. By simply using i2c_new_client_device() instead of
i2c_new_device(), we easily can return an ERRPTR for this function as
well. To make out of tree users aware that something changed, the
function is renamed to i2c_new_smbus_alert_device().

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

docs: i2c: writing-clients: properly name the stop condition

2020-01-29T21:02:09+00:00

In I2C there is no such thing as a "stop bit". Use the proper naming: "stop
condition".

Signed-off-by: Luca Ceresoli 
Reported-by: Jean Delvare 
Reviewed-by: Jean Delvare 
Signed-off-by: Wolfram Sang

docs: i2c: i2c-protocol: use same wording as smbus-protocol

2020-01-29T21:02:07+00:00

In smbus-protocol.rst we use the text "Implemented by" for the same meaning
as "This corresponds to". Change everything to "Implemented by" for
coherency.

Signed-off-by: Luca Ceresoli 
Reported-by: Jean Delvare 
Reviewed-by: Jean Delvare 
Signed-off-by: Wolfram Sang

docs: i2c: rename sections so the overall picture is clearer

2020-01-29T21:02:06+00:00

Some of the section names are not very clear. Reading those names in the
index.rst page does not help much in grasping what the content is supposed
to be.

Rename those sections to clarify their content, especially when reading
the index page.

Signed-off-by: Luca Ceresoli 
Acked-by: Peter Rosin 
Reviewed-by: Jean Delvare 
Signed-off-by: Wolfram Sang

docs: i2c: old-module-parameters: use monospace instead of ""

2020-01-29T21:01:59+00:00

Use a monospace (literal) formatting for better readability of sysfs
attributes and the "dummy" client name. This looks much more readable in
ReST-generated output.

Signed-off-by: Luca Ceresoli 
Reviewed-by: Jean Delvare 
Signed-off-by: Wolfram Sang

docs: i2c: old-module-parameters: clarify this is for obsolete kernels

2020-01-29T21:01:57+00:00

This section applies only to code for very old kernels. Avoid people
reading this unnecessarily.

Signed-off-by: Luca Ceresoli 
Reviewed-by: Jean Delvare 
Signed-off-by: Wolfram Sang

docs: i2c: old-module-parameters: fix internal hyperlink

2020-01-29T21:01:56+00:00

Use ReST syntax so that a proper hyperlink is generated.

Signed-off-by: Luca Ceresoli 
Reviewed-by: Jean Delvare 
Signed-off-by: Wolfram Sang