diff options
| author | Mauro Carvalho Chehab <mchehab+samsung@kernel.org> | 2019-07-26 14:51:16 +0200 |
|---|---|---|
| committer | Jonathan Corbet <corbet@lwn.net> | 2019-07-31 21:25:27 +0200 |
| commit | ccf988b66d697efcd0ceccc2398e0d9b909cd17c (patch) | |
| tree | 94022b812a20419675e4cac5af1540d75523d31d /Documentation/i2c/ten-bit-addresses | |
| parent | docs: ubifs-authentication.md: convert to ReST (diff) | |
| download | linux-ccf988b66d697efcd0ceccc2398e0d9b909cd17c.tar.xz linux-ccf988b66d697efcd0ceccc2398e0d9b909cd17c.zip | |
docs: i2c: convert to ReST and add to driver-api bookset
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>
Diffstat (limited to 'Documentation/i2c/ten-bit-addresses')
| -rw-r--r-- | Documentation/i2c/ten-bit-addresses | 28 |
1 files changed, 0 insertions, 28 deletions
diff --git a/Documentation/i2c/ten-bit-addresses b/Documentation/i2c/ten-bit-addresses deleted file mode 100644 index 7b2d11e53a49..000000000000 --- a/Documentation/i2c/ten-bit-addresses +++ /dev/null @@ -1,28 +0,0 @@ -The I2C protocol knows about two kinds of device addresses: normal 7 bit -addresses, and an extended set of 10 bit addresses. The sets of addresses -do not intersect: the 7 bit address 0x10 is not the same as the 10 bit -address 0x10 (though a single device could respond to both of them). -To avoid ambiguity, the user sees 10 bit addresses mapped to a different -address space, namely 0xa000-0xa3ff. The leading 0xa (= 10) represents the -10 bit mode. This is used for creating device names in sysfs. It is also -needed when instantiating 10 bit devices via the new_device file in sysfs. - -I2C messages to and from 10-bit address devices have a different format. -See the I2C specification for the details. - -The current 10 bit address support is minimal. It should work, however -you can expect some problems along the way: -* Not all bus drivers support 10-bit addresses. Some don't because the - hardware doesn't support them (SMBus doesn't require 10-bit address - support for example), some don't because nobody bothered adding the - code (or it's there but not working properly.) Software implementation - (i2c-algo-bit) is known to work. -* Some optional features do not support 10-bit addresses. This is the - case of automatic detection and instantiation of devices by their, - drivers, for example. -* Many user-space packages (for example i2c-tools) lack support for - 10-bit addresses. - -Note that 10-bit address devices are still pretty rare, so the limitations -listed above could stay for a long time, maybe even forever if nobody -needs them to be fixed. |