docs: i2c: replace "I2C-transfer" -> "I2C transfer" consistently
"I2C transfer" is a legitimate english sentence, no need for a hyphen between the two words, as as such it is used in most of the documentation. Remove the hyphen in the few places where it is present. 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>
This commit is contained in:
Родитель
40c573d12e
Коммит
48ca3b7fb8
|
@ -137,14 +137,14 @@ Mux-locked Example
|
||||||
|
|
||||||
When there is an access to D1, this happens:
|
When there is an access to D1, this happens:
|
||||||
|
|
||||||
1. Someone issues an I2C-transfer to D1.
|
1. Someone issues an I2C transfer to D1.
|
||||||
2. M1 locks muxes on its parent (the root adapter in this case).
|
2. M1 locks muxes on its parent (the root adapter in this case).
|
||||||
3. M1 calls ->select to ready the mux.
|
3. M1 calls ->select to ready the mux.
|
||||||
4. M1 (presumably) does some I2C-transfers as part of its select.
|
4. M1 (presumably) does some I2C transfers as part of its select.
|
||||||
These transfers are normal I2C-transfers that locks the parent
|
These transfers are normal I2C transfers that locks the parent
|
||||||
adapter.
|
adapter.
|
||||||
5. M1 feeds the I2C-transfer from step 1 to its parent adapter as a
|
5. M1 feeds the I2C transfer from step 1 to its parent adapter as a
|
||||||
normal I2C-transfer that locks the parent adapter.
|
normal I2C transfer that locks the parent adapter.
|
||||||
6. M1 calls ->deselect, if it has one.
|
6. M1 calls ->deselect, if it has one.
|
||||||
7. Same rules as in step 4, but for ->deselect.
|
7. Same rules as in step 4, but for ->deselect.
|
||||||
8. M1 unlocks muxes on its parent.
|
8. M1 unlocks muxes on its parent.
|
||||||
|
@ -169,7 +169,7 @@ PL1. If you build a topology with a parent-locked mux being the child
|
||||||
of another mux, this might break a possible assumption from the
|
of another mux, this might break a possible assumption from the
|
||||||
child mux that the root adapter is unused between its select op
|
child mux that the root adapter is unused between its select op
|
||||||
and the actual transfer (e.g. if the child mux is auto-closing
|
and the actual transfer (e.g. if the child mux is auto-closing
|
||||||
and the parent mux issues I2C-transfers as part of its select).
|
and the parent mux issues I2C transfers as part of its select).
|
||||||
This is especially the case if the parent mux is mux-locked, but
|
This is especially the case if the parent mux is mux-locked, but
|
||||||
it may also happen if the parent mux is parent-locked.
|
it may also happen if the parent mux is parent-locked.
|
||||||
|
|
||||||
|
@ -197,15 +197,15 @@ Parent-locked Example
|
||||||
|
|
||||||
When there is an access to D1, this happens:
|
When there is an access to D1, this happens:
|
||||||
|
|
||||||
1. Someone issues an I2C-transfer to D1.
|
1. Someone issues an I2C transfer to D1.
|
||||||
2. M1 locks muxes on its parent (the root adapter in this case).
|
2. M1 locks muxes on its parent (the root adapter in this case).
|
||||||
3. M1 locks its parent adapter.
|
3. M1 locks its parent adapter.
|
||||||
4. M1 calls ->select to ready the mux.
|
4. M1 calls ->select to ready the mux.
|
||||||
5. If M1 does any I2C-transfers (on this root adapter) as part of
|
5. If M1 does any I2C transfers (on this root adapter) as part of
|
||||||
its select, those transfers must be unlocked I2C-transfers so
|
its select, those transfers must be unlocked I2C transfers so
|
||||||
that they do not deadlock the root adapter.
|
that they do not deadlock the root adapter.
|
||||||
6. M1 feeds the I2C-transfer from step 1 to the root adapter as an
|
6. M1 feeds the I2C transfer from step 1 to the root adapter as an
|
||||||
unlocked I2C-transfer, so that it does not deadlock the parent
|
unlocked I2C transfer, so that it does not deadlock the parent
|
||||||
adapter.
|
adapter.
|
||||||
7. M1 calls ->deselect, if it has one.
|
7. M1 calls ->deselect, if it has one.
|
||||||
8. Same rules as in step 5, but for ->deselect.
|
8. Same rules as in step 5, but for ->deselect.
|
||||||
|
@ -293,7 +293,7 @@ device lockups and/or other problems.
|
||||||
|
|
||||||
The topology is especially troublesome if M2 is an auto-closing
|
The topology is especially troublesome if M2 is an auto-closing
|
||||||
mux. In that case, any interleaved accesses to D4 might close M2
|
mux. In that case, any interleaved accesses to D4 might close M2
|
||||||
prematurely, as might any I2C-transfers part of M1->select.
|
prematurely, as might any I2C transfers part of M1->select.
|
||||||
|
|
||||||
But if M2 is not making the above stated assumption, and if M2 is not
|
But if M2 is not making the above stated assumption, and if M2 is not
|
||||||
auto-closing, the topology is fine.
|
auto-closing, the topology is fine.
|
||||||
|
|
Загрузка…
Ссылка в новой задаче