最近有機會碰到 ASL code
做個紀錄
1. 範例程式碼
External(\_PR.POWS)
Scope(\_SB.PCI0.LPCB)
{
Device(EC) {
Name(_HID, EISAID("PNP0C09"))
Name(_GPE, 0x00)
Name(_CRS, ResourceTemplate() {
IO(Decode16, 0x62, 0x62, 0x00, 0x01)
IO(Decode16, 0x66, 0x66, 0x00, 0x01)
})
OperationRegion(ERAM,EmbeddedControl,0,0xFF)
Field(ERAM,ByteAcc,Lock,Preserve) {
// Field definitions
}
Method(_QXX) {
...
}
Device(AC) {
Name(_HID, "ACPI0003")
Name(_PCL, Package(1) {\_SB})
Method(_PSR, 0, NotSerialized)
{
...
}
}
}
}
2. External (Declare External Objects)
Syntax
External (ObjectName, ObjectType, ReturnType, ParameterTypes)
用來引用不同 ACPI Table中的 ObjectName時使用
常見於 DSDT和 SSDT之間的互動
舉例
先在 DSDT中宣告
External(\_PR.POWS) // 位於CpuSsdt.asl中的變數
就可直接使用
Store(1, \_PR.POWS) 改變數值
3. Scope (Open Named Scope)
Syntax
Scope (Location) {ObjectList}
Example:
Device(AC) 目前的位置是
\_SB.PCI0.LPCB.EC
如果在外層加上
Scope(\_SB) {
Device(AC) {
...
}
}
則新的
Device(AC)位置會變為
\_SB
用來定義括號包含物件的層級位置，不會受到描寫時的位置影響
4. _HID (Hardware ID)
判斷 Device用的 ID，非必要，主要是提供給 OSPM判斷用的
Example ASL:
Name (_HID, EISAID ("PNP0C0C")) // Control-Method Power Button
Name (_HID, EISAID ("INT0800")) // Firmware Hub
Name (_HID, "ACPI0003") // AC adapter device
Name (_HID, "MSFT0003") // Vendor-defined device
Name (_HID, "80860003") // PCI-assigned device identifier
5. _GPE, _QXX
這兩個是一組的，_QXX是 Q event，也是一種 SCI，由 EC透過 GPIO發出
XX 的值可由對
IO 60h下指令
0x84，再到
IO 64h讀取
_GPE 的值是由 GPIO轉換後對應，OS會將此 GPE發送的訊息傳入
Device(EC)
爾後判斷對應的
_QXX，執行不同的任務
6. OperationRegion()
OperationRegion (Declare Operation Region)
Syntax
OperationRegion (RegionName, RegionSpace, Offset, Length)
用來定義 ASL使用的空間，RegionSpace判斷不同 Type使用
範例
OperationRegion(ERAM,EmbeddedControl,0,0xFF)
指的是在 EC space中，開始位置為 0，範圍 0x100 Bytes，取名 ERAM
7. Field()
Field (Declare Field Objects)
Syntax
Field (RegionName, AccessType, LockRule, UpdateRule) {FieldUnitList}
將取過名的空間作細部配置，可以利用
Offset()做非連續的空間配置
另外
同一空間中可以
不同配置名稱重複定義
Field(
ERAM,ByteAcc,Lock,Preserve) {
AB11, 8, // offset 0x00
AB22, 8, // offset 0x01
AB33, 8, // offset 0x02
Offset(0x21), //
AB33, 8 // offset 0x21
}
Field(
ERAM,ByteAcc,Lock,Preserve) {
CD11, 16, // offset 0x00
CD22, 8, // offset 0x02
}
8. AC Adapters and Power Source Objects
當 device的
_HID為"
ACPI0003"，會被認為是 AC power source
ACPI spec中定義的 Object有以下四種
如果只有單一 AC輸入只需要 _PCL / _PSR就能正常運作
8-1. _PCL (Power Consumer List)
This object evaluates to a list of pointers, each pointing to a device or a bus powered by the power source device.
Pointing to a bus indicates that all devices under the bus are powered by the power source device.
Return Value:
A variable-length Package containing a list of References to devices or buses
8-2. _PSR (Power Source)
Returns whether the power source device is currently in use. This can be used to determine if system is running off this power supply or adapter. On mobile systes this will report that the system is not running on the AC adapter if any of the batteries in the system is being forced to discharge. In systems that contains multiple power sources, this object reports the power source’s online or offline status.
Return Value:
An Integer containing the power source status
0 – Off-line (not on AC power)
1 – On-line
8-3. Notify()
改變 _PSR的狀態可以透過
Notify(AC, 0x80)實現
一般會放在 AC插拔的 Q event中去觸發
Method(_Q0A) {
sleep(500) // 等待hardware反應
Notify(AC, 0x80) // 改變 _PSR
}
