Skip to content

Commit 3082d7e

Browse files
andy-shevrafaeljw
authored andcommitted
Documentation: firmware-guide: gpio-properties: Clarify Explicit and Implicit
Clarify the Explicit and Implicit meanings in the table of Pull Bias. While at it, distinguish pull bias keywords used in ACPI by using bold font in the table of the respective terms. Signed-off-by: Andy Shevchenko <[email protected]> Signed-off-by: Rafael J. Wysocki <[email protected]>
1 parent faffb08 commit 3082d7e

File tree

1 file changed

+24
-11
lines changed

1 file changed

+24
-11
lines changed

Documentation/firmware-guide/acpi/gpio-properties.rst

Lines changed: 24 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -67,17 +67,30 @@ state of the output pin which driver should use during its initialization.
6767
Linux tries to use common sense here and derives the state from the bias
6868
and polarity settings. The table below shows the expectations:
6969

70-
========= ============= ==============
71-
Pull Bias Polarity Requested...
72-
========= ============= ==============
73-
Implicit x AS IS (assumed firmware configured for us)
74-
Explicit x (no _DSD) as Pull Bias (Up == High, Down == Low),
75-
assuming non-active (Polarity = !Pull Bias)
76-
Down Low as low, assuming active
77-
Down High as low, assuming non-active
78-
Up Low as high, assuming non-active
79-
Up High as high, assuming active
80-
========= ============= ==============
70+
+-------------+-------------+-----------------------------------------------+
71+
| Pull Bias | Polarity | Requested... |
72+
+=============+=============+===============================================+
73+
| Implicit |
74+
+-------------+-------------+-----------------------------------------------+
75+
| **Default** | x | AS IS (assumed firmware configured it for us) |
76+
+-------------+-------------+-----------------------------------------------+
77+
| Explicit |
78+
+-------------+-------------+-----------------------------------------------+
79+
| **None** | x | AS IS (assumed firmware configured it for us) |
80+
| | | with no Pull Bias |
81+
+-------------+-------------+-----------------------------------------------+
82+
| **Up** | x (no _DSD) | |
83+
| +-------------+ as high, assuming non-active |
84+
| | Low | |
85+
| +-------------+-----------------------------------------------+
86+
| | High | as high, assuming active |
87+
+-------------+-------------+-----------------------------------------------+
88+
| **Down** | x (no _DSD) | |
89+
| +-------------+ as low, assuming non-active |
90+
| | High | |
91+
| +-------------+-----------------------------------------------+
92+
| | Low | as low, assuming active |
93+
+-------------+-------------+-----------------------------------------------+
8194

8295
That said, for our above example the both GPIOs, since the bias setting
8396
is explicit and _DSD is present, will be treated as active with a high

0 commit comments

Comments
 (0)