summaryrefslogtreecommitdiffstats
path: root/Documentation/i2c/i2c-protocol.rst
Commit message (Collapse)AuthorAgeFilesLines
* docs: i2c: i2c-protocol: remove unused legend itemsLuca Ceresoli2022-08-111-5/+1
| | | | | | | "Comm", "Count", "DataLow", "DataHigh" are not used in this section. Signed-off-by: Luca Ceresoli <luca.ceresoli@bootlin.com> Signed-off-by: Wolfram Sang <wsa@kernel.org>
* docs: i2c: i2c-protocol,smbus-protocol: remove nonsense wordsLuca Ceresoli2022-08-111-1/+1
| | | | | | | | "as usual" does not mean much here, especially as these are introductory sections and 10-bit addressing hasn't been introduced yet. Signed-off-by: Luca Ceresoli <luca.ceresoli@bootlin.com> Signed-off-by: Wolfram Sang <wsa@kernel.org>
* docs: i2c: i2c-protocol: update introductory paragraphLuca Ceresoli2022-08-111-1/+2
| | | | | | | | | | | This sentence dates back to the pre-git era and it does not look very professional... As there is no clear definition of "finished", and given this page is already a pretty good overview, not to mention it is not the kernel responsibility to document the protocol in detail, let's update the text accordingly. Signed-off-by: Luca Ceresoli <luca.ceresoli@bootlin.com> Signed-off-by: Wolfram Sang <wsa@kernel.org>
* docs: i2c: i2c-protocol: use same wording as smbus-protocolLuca Ceresoli2020-01-291-3/+3
| | | | | | | | | | | 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 <luca@lucaceresoli.net> Reported-by: Jean Delvare <jdelvare@suse.de> Reviewed-by: Jean Delvare <jdelvare@suse.de> Signed-off-by: Wolfram Sang <wsa@the-dreams.de>
* docs: i2c: rename sections so the overall picture is clearerLuca Ceresoli2020-01-291-3/+3
| | | | | | | | | | | | | | 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 <luca@lucaceresoli.net> Acked-by: Peter Rosin <peda@axentia.se> Reviewed-by: Jean Delvare <jdelvare@suse.de> Signed-off-by: Wolfram Sang <wsa@the-dreams.de>
* docs: i2c: i2c-protocol: use proper names for ACK and NACKLuca Ceresoli2020-01-291-1/+1
| | | | | | | | | Use the proper ACK and NACK naming from the I2C specification instead of "accept" and "reverse accept". Signed-off-by: Luca Ceresoli <luca@lucaceresoli.net> Reviewed-by: Jean Delvare <jdelvare@suse.de> Signed-off-by: Wolfram Sang <wsa@the-dreams.de>
* docs: i2c: i2c-protocol: remove unneeded colons from tableLuca Ceresoli2020-01-291-9/+9
| | | | | | | | | | | | These colons are not needed: the columns already nicely separate the symbols from their description. They are also inconsistently preceded by whitespace. Remove the colons completely to simplify and clean up. Signed-off-by: Luca Ceresoli <luca@lucaceresoli.net> Reviewed-by: Jean Delvare <jdelvare@suse.de> Signed-off-by: Wolfram Sang <wsa@the-dreams.de>
* docs: i2c: i2c-protocol: properly name start and stop conditionsLuca Ceresoli2020-01-291-7/+8
| | | | | | | | | In I2C there is no such thing as a "start bit" or a "stop bit". Use the proper naming: "start condition" and "stop condition". Signed-off-by: Luca Ceresoli <luca@lucaceresoli.net> Reviewed-by: Jean Delvare <jdelvare@suse.de> Signed-off-by: Wolfram Sang <wsa@the-dreams.de>
* docs: i2c: i2c-protocol: fix kernel-doc function syntaxLuca Ceresoli2020-01-291-3/+3
| | | | | | | | | This clarifies these are functions and adds a hyperlink to the function documentation. Signed-off-by: Luca Ceresoli <luca@lucaceresoli.net> Reviewed-by: Jean Delvare <jdelvare@suse.de> Signed-off-by: Wolfram Sang <wsa@the-dreams.de>
* docs: i2c: call it "I2C" consistentlyLuca Ceresoli2020-01-291-2/+2
| | | | | | | | | | Uppercase "I2C" is used almost everywhere in the docs, but the lowercase version "i2c" is used somewhere. Use the uppercase form consistently. Signed-off-by: Luca Ceresoli <luca@lucaceresoli.net> Acked-by: Peter Rosin <peda@axentia.se> Reviewed-by: Jean Delvare <jdelvare@suse.de> Signed-off-by: Wolfram Sang <wsa@the-dreams.de>
* docs: i2c: convert to ReST and add to driver-api booksetMauro Carvalho Chehab2019-07-311-0/+98
Convert each file at I2C subsystem, renaming them to .rst and adding to the driver-api book. Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org> Acked-by: Wolfram Sang <wsa@the-dreams.de> Acked-by: Alexandre Belloni <alexandre.belloni@bootlin.com> Acked-by: Jonathan Cameron <Jonathan.Cameron@huawei.com> Signed-off-by: Jonathan Corbet <corbet@lwn.net>