Changeset 108557 in vbox for trunk/include

Timestamp:

Mar 14, 2025 9:52:06 AM (5 weeks ago)

Author:

vboxsync

svn:sync-xref-src-repo-rev:

167954

Message:

Runtime/RTAcpi*: Some additions to create GpioInt() resource descriptors, bugref:10732

Location:

trunk/include/iprt

Files:

• acpi.h (modified) (2 diffs)
• mangling.h (modified) (2 diffs)

trunk/include/iprt/acpi.h

@@ -387 +387 @@
  */
 RTDECL(int) RTAcpiTblMethodStart(RTACPITBL hAcpiTbl, const char *pszName, uint8_t cArgs, uint32_t fFlags, uint8_t uSyncLvl);
+
+
+/**
+ * Starts a new method object for the given ACPI table in the current scope.
+ *
+ * @returns IPRT status code.
+ * @param   hAcpiTbl            The ACPI table handle.
+ * @param   fFlags              AML method flags, see RTACPI_METHOD_F_XXX.
+ * @param   cArgs               Number of arguments this method takes.
+ * @param   uSyncLvl            The sync level.
+ * @param   pszNameFmt          The method name format string.
+ * @param   ...                 Format string arguments.
+ */
+RTDECL(int) RTAcpiTblMethodStartF(RTACPITBL hAcpiTbl, uint8_t cArgs, uint32_t fFlags, uint8_t uSyncLvl,
+                                  const char *pszNameFmt, ...) RT_IPRT_FORMAT_ATTR(5, 6);
+
+
+/**
+ * Starts a new method object for the given ACPI table in the current scope.
+ *
+ * @returns IPRT status code.
+ * @param   hAcpiTbl            The ACPI table handle.
+ * @param   fFlags              AML method flags, see RTACPI_METHOD_F_XXX.
+ * @param   cArgs               Number of arguments this method takes.
+ * @param   uSyncLvl            The sync level.
+ * @param   pszNameFmt          The method name format string.
+ * @param   va                  Format string arguments.
+ */
+RTDECL(int) RTAcpiTblMethodStartV(RTACPITBL hAcpiTbl, uint8_t cArgs, uint32_t fFlags, uint8_t uSyncLvl,
+                                  const char *pszNameFmt, va_list va) RT_IPRT_FORMAT_ATTR(5, 0);
 
 
@@ -1420 +1450 @@
                                  RTACPIRESDMATRANSFERTYPE enmTransferType, uint8_t bmChannels);
 
+
+/**
+ * GPIO Interrupt type.
+ */
+typedef enum RTACPIRESGPIOMOD
+{
+    /** Invalid type. */
+    kAcpiResGpioMod_Invalid = 0,
+    /** Edge interrupt type. */
+    kAcpiResGpioMod_Edge,
+    /** Level interrupt type. */
+    kAcpiResGpioMod_Level,
+    /** 32-bit blowup hack. */
+    kAcpiResGpioMod_32Bit_Hack = 0x7fffffff
+} RTACPIRESGPIOMOD;
+
+
+/**
+ * GPIO polarity config.
+ */
+typedef enum RTACPIRESGPIOPOL
+{
+    /** Invalid type. */
+    kAcpiResGpioPol_Invalid = 0,
+    /** Active if input is high. */
+    kAcpiResGpioPol_ActiveHigh,
+    /** Active if input is low. */
+    kAcpiResGpioPol_ActiveLow,
+    /** Active on both (only supported if interrupt type is Edge). */
+    kAcpiResGpioPol_ActiveBoth,
+    /** 32-bit blowup hack. */
+    kAcpiResGpioPol_32Bit_Hack = 0x7fffffff
+} RTACPIRESGPIOPOL;
+
+
+/**
+ * GPIO shared/exclusive config.
+ */
+typedef enum RTACPIRESGPIOSHR
+{
+    /** Invalid type. */
+    kAcpiResGpioShr_Invalid = 0,
+    /** GPIO pins are shared. */
+    kAcpiResGpioShr_Shared,
+    /** GPIO pins are exclusive. */
+    kAcpiResGpioShr_Exclusive,
+    /** GPIO pins are shared and capabale to wake the system. */
+    kAcpiResGpioShr_SharedAndWake,
+    /** GPIO pins are exclusive and capabale to wake the system. */
+    kAcpiResGpioShr_ExclusiveAndWake,
+    /** 32-bit blowup hack. */
+    kAcpiResGpioShr_32Bit_Hack = 0x7fffffff
+} RTACPIRESGPIOSHR;
+
+
+/**
+ * GPIO pin config.
+ */
+typedef enum RTACPIRESGPIOPPI
+{
+    /** Invalid config. */
+    kAcpiResGpioPpi_Invalid = 0,
+    /** Default pull up/down config. */
+    kAcpiResGpioPpi_PullDefault,
+    /** Pin is pulled up. */
+    kAcpiResGpioPpi_PullUp,
+    /** Pin is pulled down. */
+    kAcpiResGpioPpi_PullDown,
+    /** Pin has no pull up/down resistor attached and is floating. */
+    kAcpiResGpioPpi_PullNone,
+    /** 32-bit blowup hack. */
+    kAcpiResGpioPpi_32Bit_Hack = 0x7fffffff
+} RTACPIRESGPIOPPI;
+
+
+/**
+ * Adds a GPIO connection descriptor suitable for GPIO input pins with interrupt support
+ * with the given configuration to the given ACPI resource.
+ *
+ * @returns IPRT status code.
+ * @param   hAcpiRes            The ACPI resource handle.
+ */
+RTDECL(int) RTAcpiResourceAddGpioInt(RTACPIRES hAcpiRes, RTACPIRESGPIOMOD enmMod, RTACPIRESGPIOPOL enmPol, RTACPIRESGPIOSHR enmShr,
+                                     RTACPIRESGPIOPPI enmPpi, uint16_t u16DebounceWait, const char *pszRsrcSrc,
+                                     uint16_t *pau16Pins, uint16_t cPins);
+
 /** @} */
 

trunk/include/iprt/mangling.h

@@ -382 +382 @@
 # define RTAcpiResourceAddDWordMemoryRangeEx            RT_MANGLER(RTAcpiResourceAddDWordMemoryRangeEx)
 # define RTAcpiResourceAddExtendedInterrupt             RT_MANGLER(RTAcpiResourceAddExtendedInterrupt)
+# define RTAcpiResourceAddGpioInt                       RT_MANGLER(RTAcpiResourceAddGpioInt)
 # define RTAcpiResourceAddIo                            RT_MANGLER(RTAcpiResourceAddIo)
 # define RTAcpiResourceAddIrq                           RT_MANGLER(RTAcpiResourceAddIrq)
@@ -428 +429 @@
 # define RTAcpiTblLocalOpAppend                         RT_MANGLER(RTAcpiTblLocalOpAppend)
 # define RTAcpiTblMethodStart                           RT_MANGLER(RTAcpiTblMethodStart)
+# define RTAcpiTblMethodStartF                          RT_MANGLER(RTAcpiTblMethodStartF)
+# define RTAcpiTblMethodStartV                          RT_MANGLER(RTAcpiTblMethodStartV)
 # define RTAcpiTblMethodFinalize                        RT_MANGLER(RTAcpiTblMethodFinalize)
 # define RTAcpiTblNameAppend                            RT_MANGLER(RTAcpiTblNameAppend)