Changeset 108167 in vbox for trunk/include

Timestamp:

Feb 11, 2025 9:22:02 PM (2 months ago)

Author:

vboxsync

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

167482

Message:

Runtime/RTAcpi*: Continue with resource template parsing, bugref:10733

Location:

trunk/include/iprt

Files:

• acpi.h (modified) (1 diff)
• formats/acpi-resources.h (modified) (2 diffs)
• mangling.h (modified) (1 diff)

trunk/include/iprt/acpi.h

@@ -1139 +1139 @@
                                            uint16_t u16OffTrans, uint16_t u16Granularity, uint16_t u16Length);
 
+
+/**
+ * I/O decode type.
+ */
+typedef enum RTACPIRESIODECODETYPE
+{
+    /** Invalid value. */
+    kAcpiResIoDecodeType_Invalid = 0,
+    /** 10-bit decoding. */
+    kAcpiResIoDecodeType_Decode10,
+    /** 16-bit decoding. */
+    kAcpiResIoDecodeType_Decode16,
+    /** 32-bit blowup hack. */
+    kAcpiResIoDecodeType_32BitHack = 0x7fffffff
+} RTACPIRESIODECODETYPE;
+
+
+/**
+ * Adds an I/O port descriptor to the given ACPI resource.
+ *
+ * @returns IPRT status code.
+ * @param   hAcpiRes            The ACPI resource handle.
+ * @param   enmDecode           The decoding type of the range.
+ * @param   u16AddrMin          Minimum base I/O address the range might be configured for.
+ * @param   u16AddrMax          Maximum base I/O address the range might be configured for.
+ * @param   u8AddrAlignment     Alignment of the minimum base address.
+ * @param   u8RangeLength       Number of contiguous I/O ports requested.
+ */
+RTDECL(int) RTAcpiResourceAddIo(RTACPIRES hAcpiRes, RTACPIRESIODECODETYPE enmDecode, uint16_t u16AddrMin, uint16_t u16AddrMax,
+                                uint8_t u8AddrAlignment, uint8_t u8RangeLength);
+
+
+/**
+ * Adds an extended interrupt descriptor with the given configuration to the given ACPI resource.
+ *
+ * @returns IPRT status code.
+ * @param   hAcpiRes            The ACPI resource handle.
+ * @param   fEdgeTriggered      Flag whether the interrupt is edged (true) or level (false) triggered.
+ * @param   fActiveLow          Flag whether the interrupt polarity is active low (true) or active high (false).
+ * @param   fShared             Flag whether the interrupt is shared between different entities (true) or exclusive to the assigned entity (false).
+ * @param   fWakeCapable        Flag whether the interrupt can wake the system (true) or not (false).
+ * @param   bmIntrs             Bitmap of interrupts (0..15) requested.
+ */
+RTDECL(int) RTAcpiResourceAddIrq(RTACPIRES hAcpiRes, bool fEdgeTriggered, bool fActiveLow, bool fShared,
+                                 bool fWakeCapable, uint16_t bmIntrs);
+
 /** @} */
 

trunk/include/iprt/formats/acpi-resources.h

@@ -55 +55 @@
 /** End tag. */
 #define ACPI_RSRCS_TAG_END                              0x79
+
+
+/** @name Small Resource Data Type.
+ * @{ */
+/** The bit identifying a small resource data type. */
+#define ACPI_RSRCS_SMALL_TYPE                           0
+/** IRQ format descriptor. */
+#define ACPI_RSRCS_ITEM_IRQ                             0x04
+/** DMA format descriptor. */
+#define ACPI_RSRCS_ITEM_DMA                             0x05
+/** Start dependent functions descriptor. */
+#define ACPI_RSRCS_ITEM_START_DEP_FN                    0x06
+/** End dependent functions descriptor. */
+#define ACPI_RSRCS_ITEM_END_DEP_FN                      0x07
+/** I/O port descriptor. */
+#define ACPI_RSRCS_ITEM_IO                              0x08
+/** Fixed location I/O port descriptor. */
+#define ACPI_RSRCS_ITEM_FIXED_LOCATION_IO               0x09
+/** Fixed DMA descriptor. */
+#define ACPI_RSRCS_ITEM_FIXED_DMA                       0x0a
+/** End tag descriptor. */
+#define ACPI_RSRCS_ITEM_END_TAG                         0x0f
+/** @} */
 
 
@@ -129 +152 @@
 
 
+/** @name IRQ descriptor related definitions.
+ * @{ */
+/** Interrupt is edge triggered. */
+#define ACPI_RSRCS_IRQ_F_EDGE_TRIGGERED                 RT_BIT(0)
+/** Interrupt is level triggered. */
+#define ACPI_RSRCS_IRQ_F_LEVEL_TRIGGERED                0
+
+/** Interrupt polarity is active low. */
+#define ACPI_RSRCS_IRQ_F_ACTIVE_LOW                     RT_BIT(3)
+/** Interrupt polarity is active high. */
+#define ACPI_RSRCS_IRQ_F_ACTIVE_HIGH                    0
+
+/** Interrupt is shared. */
+#define ACPI_RSRCS_IRQ_F_SHARED                         RT_BIT(4)
+/** Interrupt is exclusive. */
+#define ACPI_RSRCS_IRQ_F_EXCLUSIVE                      0
+
+/** Interrupt is capable of waking the system. */
+#define ACPI_RSRCS_IRQ_F_WAKE_CAP                       RT_BIT(5)
+/** Interrupt is not capable of waking the system. */
+#define ACPI_RSRCS_IRQ_F_NOT_WAKE_CAP                   0
+/** @} */
+
+
 /** @name Address space resource descriptors related definitions.
  * @{ */

trunk/include/iprt/mangling.h

@@ -380 +380 @@
 # define RTAcpiResourceAddDWordMemoryRange              RT_MANGLER(RTAcpiResourceAddDWordMemoryRange)
 # define RTAcpiResourceAddExtendedInterrupt             RT_MANGLER(RTAcpiResourceAddExtendedInterrupt)
+# define RTAcpiResourceAddIo                            RT_MANGLER(RTAcpiResourceAddIo)
+# define RTAcpiResourceAddIrq                           RT_MANGLER(RTAcpiResourceAddIrq)
 # define RTAcpiResourceAddQWordIoRange                  RT_MANGLER(RTAcpiResourceAddQWordIoRange)
 # define RTAcpiResourceAddQWordMemoryRange              RT_MANGLER(RTAcpiResourceAddQWordMemoryRange)