第 8 章的 只是「申報」：告訴 OS 我的暫存器在哪、佔多大， 請 OS 別把資源分給別人。但 AML 自己也常要動手碰硬體—— 要讀狀態暫存器、 要寫預設值、EC 的電池電量要一個 byte 一個 byte 讀出來。ACPI 給 AML 的存取機制分成兩層：本章的 負責「在某個位址空間開一扇窗」， 第 10 章的 Field 再把窗內切成一顆顆具名暫存器。

先窗後刀。本章專心把「窗」講透：四個參數、九種位址空間、 「宣告不碰硬體」的 lazy 語意，以及 就緒通知。

一行宣告，四個參數

先看課綱指定的範例——在 SystemIO 空間開一扇 16 byte 的窗：

四個參數各司其職：

這行宣告的白話翻譯：「以後我會從 IO port 0x300 開始、長度 16 byte 的範圍讀寫，這扇窗叫 REG0。」值得一提的是，Offset 與 Length 不必是常數——它們是 TermArg，可以放運算式或 Named object。 基底位址開機才知道時（例如先從別的暫存器讀出 BAR）， 就靠這個特性動態決定窗口位置。

OperationRegion 在整個存取體系中的位置如下，這張層次圖請刻在腦中：

九種 Address Space

第二個參數 RegionSpace 決定「0x300 這個數字要怎麼解讀」—— 是實體記憶體位址？IO port？還是 PCI config space 的偏移？ ACPI 6.5 定義的標準空間如下：

九種空間可以分成三類來記：

• 位址直通型（SystemMemory、SystemIO、PCI_Config、 EmbeddedControl）：offset 就是某種「位址」，讀寫欄位 對應一筆匯流排交易。

• 交易式（SMBus、GenericSerialBus、PCC）：offset 其實是「命令編號」，一次欄位存取展開成一整筆協定交易， 資料以 buffer 進出（第 10 章的 BufferAcc、第 11 章實戰）。

• 特殊型（GeneralPurposeIO、FFixedHW）：GPIO 的 offset 是 pin 的位元索引，必須搭配 Connection（第 11 章）； FFixedHW 的解讀由 CPU 廠商自訂，多用於處理器電源介面。

規格裡還有 （5）、PciBarTarget（6）、IPMI（7） 等較少見的空間，以及留給平台自訂的區段；日常 bring-up 會遇到的， 上表九種已經涵蓋。

SystemMemory 與 PCI_Config 實例

SystemIO 的例子已在上節出現（port 0x300），這節補齊另外兩個 最常用的空間。先看 SystemMemory——課綱指定的 MMIO 範例， 0xFED00000 是 Intel 平台 HPET 計時器的慣用基底：

Field 的語法下一章才正式教，這裡先看形狀：宣告窗口之後，把開頭 兩個 DWord 命名為 、，之後讀 就是讀實體位址 0xFED00000。再看 PCI_Config：

PCI_Config 的 offset 是「某一顆 PCI function 的 config space 內偏移」。哪一顆？由 region 所在的 Device 決定： interpreter 沿著 Namespace 往上找，用該裝置的 （配合上層 bridge 鏈與 ／）定位到 bus/device/function。所以這段 region 必須宣告在 裝置底下才有意義——搬到別的 Scope，讀到的就是別顆裝置的 config space。

Region 只是窗口：宣告不等於存取

一個容易誤解的重點：OperationRegion 的宣告不會產生任何 匯流排交易。interpreter 只是記下「有這麼一扇窗」；真正碰硬體的 時刻，是第一次讀寫掛在窗上的 Field Unit。這個 lazy 語意有兩個 實務後果：

• 宣告錯誤不會當場爆炸。位址寫錯的 region 可以安靜地躺在 DSDT 裡好幾年，直到某天有人存取它的欄位。

• 每種空間的存取都由對應的 代勞。 SystemMemory 與 SystemIO 的 handler 由 OS 內建、永遠可用； PCI_Config 名義上也內建，但依賴 PCI 列舉完成； EmbeddedControl、GenericSerialBus、GeneralPurposeIO 的 handler 則由對應的 driver 註冊，開機初期不存在。

handler 什麼時候可用？OS 會呼叫 Scope 內的 通知：

收兩個參數：Arg0 是空間 ID、Arg1 是可用性。 上例把「EC 就緒」記在 旗標裡，其他 method 存取 EC 欄位前先看旗標——第 8 章 warnbox 裡「觸控板消失」的事故， 就是少了這道門。

綜合範例：Debug Port 裝置

把第 8 章的 Device 骨架與本章的 region 合體：一張插在 port 0x300 的 POST code debug 卡，完整可編譯：

逐行拆解：

• 用 巨集向 OS 申報 「port 0x300 起 16 個 port 是我的」。

• 向 interpreter 開窗——注意位址與 申報的完全一致，這是鐵律：兩者各走各的，沒有人幫你核對。

• 把窗口第一個 byte 命名為 ； method 寫它，等同對 port 0x300 做一次 指令。

• 之後 AML 任何地方呼叫 （例如在 裡打進度碼），debug 卡上的數字 就會跳動——AML 版的 printf 除錯就是這麼做的。

Field

窗開好了，這一章動刀： 把 OperationRegion 切成 一個個具名的 ——從此「讀寫一個變數」就是 「讀寫一顆硬體暫存器」。這是 ASL 最漂亮的抽象：C driver 工程師 眼裡的 ／ 與 MMIO 指標，在 ASL 裡 全部化成一個等號。

但等號背後藏著三個必答題：一次交易敲多寬（AccessType）？ 要不要跟韌體搶鎖（LockRule）？沒被寫到的位元怎麼辦（UpdateRule）？ 本章逐一拆解，最後用 IndexField 與 BankField 收拾兩種 「不走尋常路」的暫存器。

Field：把窗口切成具名暫存器

先看課綱指定的範例——把上一章的 切成三顆暫存器：

Field 的第一個參數是 region 名稱，後三個參數是「存取規則」， 本章後面各給一節。大括號內是欄位清單：依宣告順序 從 region 開頭排下去，每項給名稱與位元寬度。排出來的版圖如下：

之後讀寫這些名字，interpreter 就替你產生對應的 IO 交易：

課綱指定的 、 是 ASL 2.0 的 symbolic 寫法；老 DSDT 裡等價的樣子是 。 兩者編譯出的 AML 完全相同，讀舊碼、寫新碼都得認得。 Field Unit 的物件型別是 ：讀取時，寬度不超過 64 bit 的欄位轉成 Integer 回來，更寬的欄位回 Buffer （Module 3 的轉型規則在此適用）。

AccessType：一次交易敲多寬

Field 的第二個參數告訴 interpreter：對這個 region 的每筆交易 應該用多大的存取單位。

AccessType 本質上是對硬體的承諾。datasheet 常見這種話： 「本暫存器僅支援 32-bit 對齊存取」——這時必須用 ； 若貪方便寫 ，interpreter 會產生四筆 8-bit 交易， 硬體可能直接忽略或行為錯亂，而 AML 端不會有任何錯誤訊息。 反過來，欄位比存取寬度窄或跨越邊界時，interpreter 會自動用 多筆交易讀出、組合、寫回（代價見下一節的 UpdateRule）。

是完全不同的物種：欄位讀寫不再是「位址上的值」， 而是一整包協定交易的資料緩衝區，用於 SMBus、GenericSerialBus 這類「一次存取等於一筆匯流排協定交易」的空間。第 11 章的 I2C 感測器會完整示範。順帶一提：EC 介面天生一次一個 byte， EmbeddedControl region 用 就對了。

LockRule：與韌體共搶硬體

第三個參數只有兩個值： 與 。寫 時，interpreter 在每次欄位存取前取得 ，結束後釋放。

為什麼需要它？歷史原因是 OS 與韌體共用硬體。EC 與 CMOS 這類資源，OS 的 AML 在存取，SMM 韌體（處理 SMI 的那段 BIOS 碼） 也在存取；雙方各自 read-modify-write，不加鎖就會互相踩掉對方的 修改。ACPI 因此定義了一把橫跨 OS 與韌體的鎖。

UpdateRule：沒被寫到的位元怎麼辦

第四個參數回答一個微妙的問題。假設欄位只佔暫存器的一部分：

寫 時，交易單位是一整個 byte，但你只指定了 高 4 位——低 4 位該寫什麼？三種 UpdateRule 三種答案：

三者的成本與風險：

• ：先讀後寫，兩筆交易。最直覺、最常用， 鄰居位元保持原狀；但多出一次隱藏的讀取。

• ／：不讀，直接寫， 一筆交易。用在「其餘位元寫 1（或 0）無副作用」的硬體， 或刻意避開隱藏讀取時。

Offset()、位元欄位與跨 byte 欄位

真實 datasheet 的暫存器版圖不會乖乖連續。三個工具讓 Field 精準對齊： 跳到指定 byte、匿名欄位「」 跳過 n 個 bit、任意 bit 寬度的欄位（可以只有 1 bit，也可以 跨越 byte 邊界）。以筆電 EC 為例：

逐行拆解：

• ：游標直接跳到 region 內偏移 0x20， 中間的 0x00–0x1F 不命名、也永遠不會被這個 Field 碰到。

• ：1-bit 欄位。第 1 章那個 的謎底在此——讀它，interpreter 讀出 0x23 整個 byte，右移、遮罩，只回傳 bit 0。

• ：匿名跳過保留位元，讓後面的欄位對齊。

• ：跨兩個 byte 的欄位。 之下 interpreter 拆成兩筆交易再拼裝——不是 atomic， 若硬體在兩筆交易之間更新數值，你會讀到「上半新、下半舊」 的縫合怪。對會跳動的計數器，寧可分開讀兩個 byte 再自行判斷。

• 注意這個 Field 宣告了 ：EC 正是「OS 與韌體 共搶」的經典案例。

IndexField 與 BankField

有些硬體暫存器太多、位址口太小，於是發明了「間接存取」： 先把想存取的暫存器編號寫進 index port，再從 data port 讀寫值。CMOS RTC（port 0x70/0x71）、 SuperIO（0x2E/0x2F）都是這一族。手寫兩步驟太囉唆， 把它自動化：

拆解：先用普通 Field 把 index／data 兩個 port 命名為 、； 再宣告一層虛擬 region——欄位的 offset 不是 IO 位址， 而是「要寫進 index port 的編號」。讀 時 interpreter 自動做兩步：把 0x00 寫進 ，再從 讀值。 （小提醒：某些晶片組的 port 0x70 bit 7 兼任 NMI 遮罩， 動 CMOS 前先讀平台文件。）

處理另一種怪招——「分頁」暫存器：同一段 位址視 bank 暫存器的值切換內容。宣告時多帶 bank 暫存器與 bank 值兩個參數：

存取 時，interpreter 先寫 切頁， 再存取 offset 0x00。SuperIO 的 logical device 切換是最常見的 應用場景。

綜合範例：MMIO 控制器

集大成：一顆虛構的 MMIO 控制器，同一個 region 疊兩層 Field （整暫存器視角與位元視角），加上輪詢邏輯，完整可編譯：

逐行拆解：

• 同一個 疊了兩個 Field：第一層以 32-bit 為 單位看整顆暫存器，第二層鑽進位元。兩層描述同一塊硬體， interpreter 不在乎重疊——這是對照 datasheet 寫碼的 常用手法。

• 對 寫 1 再寫 0，做出 reset 脈衝；每次寫入在 之下都是 「讀 CTRL、改 bit 1、寫回」。

• 輪詢 ，每輪 忙等 10 微秒； 不會讓出 CPU，單次別超過 100 微秒，長等待改用 （Module 6 詳述）。

• 與 條件裡的 都是 ASL 2.0 語法；legacy 等價寫法是 與 。

• 讀 每次都是真實的 MMIO 讀取——輪詢會不斷 敲硬體，這正是 Field Unit「會碰硬體的變數」本色。

GPIO / I2C / SPI / PCI 實戰

現代機器的裝置掛在五花八門的匯流排上：觸控板在 I2C、感測器在 SPI、藍牙在 UART、LED 與開關在 GPIO、大傢伙在 PCI。本章把 Module 4 的 Device 骨架與前兩章的 region／field 機制組裝起來， 逐一寫出這些匯流排的標準描述；貫穿全章的主軸只有一條： controller 與 consumer 的分工。

Controller 與 Consumer：兩種角色

一條 I2C 匯流排上有兩種東西：（主控端， SoC 裡的 I2C host）與 （掛在線上的裝置， 例如溫度感測器）。ACPI 描述它們的方式截然不同：

• Controller 申報實體資源：它是一顆平台裝置， 放 與 ；PC 上常是 PCI 裝置（）， SoC 平台常以 列舉。

• Consumer 申報連線： 放 、 這類 ——不佔位址，只申報 「一條通往 controller 的線」，用 路徑字串寫明「我掛在哪顆 controller、參數為何」。 OS 讀到它，就把 consumer 掛到對應 controller 的匯流排 底下 probe，driver 再經由 controller driver 存取 consumer。

GPIO：從 Controller 到扳一根 Pin

先立 controller。GPIO controller 是一顆平台裝置，用 列舉、申報自己的 MMIO 與中斷； （ACPI Event Interrupts）也掛在它身上，宣告「哪些 pin 觸發時 請 OSPM 執行對應的 event method」：

的參數依序是：觸發（／）、 極性（／／）、 共享與喚醒（：此 pin 可在睡眠中喚醒 系統）、上下拉、去彈跳時間（單位 0.01 ms，0 = 不指定）， 之後是所有 GPIO 巨集共通的尾巴： （controller 路徑）、index、usage、名稱、vendor data， 大括號內是 pin list。事件 method 的命名規則：pin 編號轉 十六進位接在 （level）或 （edge）後—— pin 43 = 0x2B 就是 ；編號超過 255 改用 。

consumer 端一次到位： 用 把 pin 申報給 driver； region（課綱指定寫法） 加上 ，讓 AML 自己扳 pin：

逐參數解說（依序）：（pin 是否 可共用，幾乎都寫 Exclusive）、（內建上下拉： PullUp／PullDown／PullNone／PullDefault 沿用韌體設定）、 （去彈跳與驅動強度，0 = 預設值）、 （方向限制：None／InputOnly／ OutputOnly）、（controller 完整路徑， ASL 字串中反斜線要寫兩次），尾巴同 ：index、 usage、名稱、vendor data，大括號內是 pin list （controller 相對編號）。

region 這一段三明治再拆一次： 開 1 byte 的虛擬窗（容納 8 根 pin 的 位元欄位）； 宣告「接下來的欄位走這條 GPIO 線」，欄位位元索引對應 pin list 順序，bit 0 是第一根； 於是 就把 pin 27 拉高——經 controller driver 的 region handler 完成，同樣受 約束。注意 的 給 driver 看、 給 AML 用；兩份指同一根 pin， 慣例寫成一模一樣。

I2C：連線描述與 GenericSerialBus 存取

同一套劇本換到 I2C。controller（）與 同一個模子—— 加 MMIO 加中斷，不再重列； 直接看溫度感測器 consumer：

逐參數解說（依序）： 是 slave address（右對齊，不含讀寫位元）； 表示交易由 controller 發起（幾乎永遠如此）； 是 連線速度（Hz），即 Fast Mode 400 kHz； 是 7-bit 定址（另有 10Bit）；再來是 ResourceSource（指向 controller），其後依序為 index、usage、名稱（留空）、 （V2 新增的共享旗標）與 vendor data（留空）。

driver 有了這行就能透過 I2C subsystem 收發。但如果AML 自己要跟感測器講話（例如 想確認它活著），就要 動用第 9 章表格裡的交易式空間 ：

這段是本章資訊密度最高的範例，逐層拆解：

• ： 虛擬 region——offset 不是位址，而是 command byte（裝置內的暫存器編號）。 排在 offset 0 就代表 command 0x00， 是 command 0x01。

• ：指定後續欄位的 存取協定為 read/write byte；其他常用協定有 、 與 （固定 n byte，I2C 常用）。

• BufferAcc 的資料不是純量而是一包 buffer，格式固定： offset 0 是 狀態（0 = 成功，非零 = 錯誤碼）、 offset 1 是長度（block 類協定才有意義）、 offset 2 起是資料。 就在這包 buffer 上開具名視窗。

• 讀寫方向由等號方向決定： 觸發一筆 I2C read-byte 交易，結果落進 ；反過來寫 就是一筆 write-byte。任何交易後 先檢查 再用資料——I2C 是會 NAK 的。

SPI 與 UART：其他序列匯流排

SPI 與 UART 的 consumer 寫法與 I2C 同一個模子，換巨集與參數 而已（每個 SerialBus 巨集都有不帶 V2 的舊版；V2 多了 Shared 旗標，新碼一律用 V2）：

參數重點（依序）：chip select 編號 （0 = controller 的 CS0）、CS 極性（ 為 常態）、線制（FourWire／ThreeWire）、資料位寬（8）、發起端、 時脈 1 MHz，然後是決定 SPI mode 的兩兄弟：Polarity 管 CPOL、Phase 管 CPHA， + = mode 0，四種組合對應 mode 0–3， 抄 datasheet 的時序圖就不會錯。

參數重點（依序）：鮑率 115200、資料 位元、停止位元、LinesInUse（bitmask，宣告用到的 modem 控制線， 0x00 = 只有 TX/RX）、位元組序、同位、流控（硬體流控寫 並在 LinesInUse 設 RTS/CTS）、 建議收發緩衝 64 byte，最後同樣以 ResourceSource 指向 controller。

PCI：Root Bridge、_ADR 與 Config Space

PCI 是「可自我列舉」匯流排的代表：子裝置不需要 ， 用第 8 章的 對號即可；但樹的根——PCI root bridge——OS 沒辦法自己發現，必須由 ACPI 以 立起來：

拆解：

• 是 PCIe root bridge 的標準 ID，慣例搭配 ；完整的 root 還要以 ／ 宣告 segment 與 bus 編號、以 申報 bus 範圍與 MMIO window（留給 Module 8）。

• 以 對應 device 0x17、function 0；PCI_Config region 的 offset 相對 這顆 function 的 config space。

• 讀 Vendor ID：PCI 規範空槽讀回全 1，所以 是「裝置在不在」的慣用判斷。

SystemMemory 與 SystemIO：完整裝置範例

回頭補上兩個最樸素的空間，呼應第 9 章：HPET 計時器 （MMIO 0xFED00000）與 debug 卡（port 0x300）：

兩顆裝置各自示範一種空間，共同示範同一條鐵律： 申報給 OS 的位址與 OperationRegion 開窗的位址必須人工 保持一致。region 超出實際硬體範圍去存取，就是第 9 章 warnbox 的劇本。

綜合佈局：EC、I2C 感測器與 GPIO LED

最後把全章角色排進同一棵 Namespace，看清楚彼此的關係：

讀圖重點：controller 與 EC 各自申報實體資源；consumer 平行 掛在 下——樹的位置不決定連線關係， 指向全靠 。事件鏈完整可循：lid 翻動、 pin 43 觸發、OSPM 執行 、 打向 LID0、OS 呼叫 讀狀態——第 1 章的場景， 如今每一站你都寫得出來。