Skip to contentSkip to conversation

Documentation: firmware-guide: gpio-properties: Add note to SPI CS case

PATCH Applied Andy Shevchenko 2 participants 2 messages Apr 24, 2021 – Apr 28, 2021

Subsystems (3)
lore
Share & tools
lore

Andy Shevchenko

author maintainer
#0 lore raw

PATCH 1/1 Documentation: firmware-guide: gpio-properties: Add note to SPI CS case

Historically ACPI has no means of the GPIO polarity and thus the SPISerialBus() resource defines it on the per-chip basis. In order to avoid an ambiguity, the GPIO polarity is considered being always Active High.

Add note about this to the respective documentation file.

---
 Documentation/firmware-guide/acpi/gpio-properties.rst | 6 ++++++
 1 file changed, 6 insertions(+)
Documentation/firmware-guide/acpi/gpio-properties.rst +6 -0
index 4e264c16ddff..df4b711053ee 100644
@@ -99,6 +99,12 @@ native::
       }
   }
 
+Note, that historically ACPI has no means of the GPIO polarity and thus
+the SPISerialBus() resource defines it on the per-chip basis. In order
+to avoid a chain of negations, the GPIO polarity is considered being
+Active High. Even for the cases when _DSD() is involved (see the example
+above) the GPIO CS polarity must be defined Active High to avoid ambiguity.
+
 Other supported properties
 ==========================
 
Signature · 1 line
2.30.2
maintainer Applied
#1 lore raw
Quoted 21 lines · Andy Shevchenko

Historically ACPI has no means of the GPIO polarity and thus the SPISerialBus() resource defines it on the per-chip basis. In order to avoid an ambiguity, the GPIO polarity is considered being always Active High.

Add note about this to the respective documentation file.

---
 Documentation/firmware-guide/acpi/gpio-properties.rst | 6 ++++++
 1 file changed, 6 insertions(+)
Documentation/firmware-guide/acpi/gpio-properties.rst +0 -0
index 4e264c16ddff..df4b711053ee 100644
@@ -99,6 +99,12 @@ native::
       }
   }
 

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

Quoted 10 lines
Documentation/firmware-guide/acpi/gpio-properties.rst +6 -1
+Note, that historically ACPI has no means of the GPIO polarity and thus
+the SPISerialBus() resource defines it on the per-chip basis. In order
+to avoid a chain of negations, the GPIO polarity is considered being
+Active High. Even for the cases when _DSD() is involved (see the example
+above) the GPIO CS polarity must be defined Active High to avoid ambiguity.
+
 Other supported properties
 ==========================
 
--

Applied as 5.13-rc material, thanks!