OvmfPkg: add comments to the DSDT, remove trailing empty line

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Laszlo Ersek <lersek@redhat.com>
Reviewed-by: Jordan Justen <jordan.l.justen@intel.com>
git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@13622 6f19259b-4bc3-4df7-8a09-765794883524

diff --git a/OvmfPkg/AcpiTables/Dsdt.asl b/OvmfPkg/AcpiTables/Dsdt.asl
index e12c3e9a07d180a860b341ef1a4027e550f96091..91d412b6d51d80ab6fee5e20f19a2aa8e2937ac0 100644 (file)
--- a/OvmfPkg/AcpiTables/Dsdt.asl
+++ b/OvmfPkg/AcpiTables/Dsdt.asl
@@ -213,12 +213,13 @@ DefinitionBlock ("Dsdt.aml", "DSDT", 1, "INTEL ", "OVMF    ", 3) {
 \r
       //\r
       // PCI to ISA Bridge (Bus 0, Device 1, Function 0)\r
+      // "Low Pin Count"\r
       //\r
       Device (LPC) {\r
         Name (_ADR, 0x00010000)\r
 \r
         //\r
-        // PCI Interrupt Routing Configuration Registers\r
+        // PCI Interrupt Routing Configuration Registers, PIRQRC[A:D]\r
         //\r
         OperationRegion (PRR0, PCI_Config, 0x60, 0x04)\r
         Field (PRR0, ANYACC, NOLOCK, PRESERVE) {\r
@@ -230,17 +231,19 @@ DefinitionBlock ("Dsdt.aml", "DSDT", 1, "INTEL ", "OVMF    ", 3) {
 \r
         //\r
         // _STA method for LNKA, LNKB, LNKC, LNKD\r
+        // Arg0[in]: value of PIRA / PIRB / PIRC / PIRD\r
         //\r
         Method (PSTA, 1, NotSerialized) {\r
-          If (And (Arg0, 0x80)) {\r
-            Return (0x9)\r
+          If (And (Arg0, 0x80)) { // disable-bit set?\r
+            Return (0x9)          // "device present" | "functioning properly"\r
           } Else {\r
-            Return (0xB)\r
+            Return (0xB)          // same | "enabled and decoding resources"\r
           }\r
         }\r
 \r
         //\r
         // _CRS method for LNKA, LNKB, LNKC, LNKD\r
+        // Arg0[in]: value of PIRA / PIRB / PIRC / PIRD\r
         //\r
         Method (PCRS, 1, NotSerialized) {\r
           //\r
@@ -527,4 +530,3 @@ DefinitionBlock ("Dsdt.aml", "DSDT", 1, "INTEL ", "OVMF    ", 3) {
     }\r
   }\r
 }\r
-\r