Commit 05bd0728 authored by Wolfram Sang's avatar Wolfram Sang Committed by Wolfram Sang

i2c: gpio: fault-injector: better SPHINX style in docs

We don't use SPHINX currently in I2C documentation; but preparing the
I2C fault injector docs already is a good idea since it makes it easier
to read. Especially as new stuff is going to be added soon.
Signed-off-by: default avatarWolfram Sang <wsa+renesas@sang-engineering.com>
Signed-off-by: default avatarWolfram Sang <wsa@the-dreams.de>
parent c6324fad
=========================
Linux I2C fault injection Linux I2C fault injection
========================= =========================
...@@ -13,6 +14,9 @@ mounted at /sys/kernel/debug. There will be a separate subdirectory per GPIO ...@@ -13,6 +14,9 @@ mounted at /sys/kernel/debug. There will be a separate subdirectory per GPIO
driven I2C bus. Each subdirectory will contain files to trigger the fault driven I2C bus. Each subdirectory will contain files to trigger the fault
injection. They will be described now along with their intended use-cases. injection. They will be described now along with their intended use-cases.
Wire states
===========
"scl" "scl"
----- -----
...@@ -34,10 +38,10 @@ I2C specification version 4, section 3.1.16) using the helpers of the Linux I2C ...@@ -34,10 +38,10 @@ I2C specification version 4, section 3.1.16) using the helpers of the Linux I2C
core (see 'struct bus_recovery_info'). However, the bus recovery will not core (see 'struct bus_recovery_info'). However, the bus recovery will not
succeed because SDA is still pinned low until you manually release it again succeed because SDA is still pinned low until you manually release it again
with "echo 1 > sda". A test with an automatic release can be done with the with "echo 1 > sda". A test with an automatic release can be done with the
following class of fault injectors. "incomplete transfers" class of fault injectors.
Introduction to incomplete transfers Incomplete transfers
------------------------------------ ====================
The following fault injectors create situations where SDA will be held low by a The following fault injectors create situations where SDA will be held low by a
device. Bus recovery should be able to fix these situations. But please note: device. Bus recovery should be able to fix these situations. But please note:
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment