小白都能看懂的DSDT电量显示补丁教程

xiegengcai

简介
知识储备

• DSDT
• 正则匹配（不懂就依葫芦画瓢）
  

背景
由于普通PC的电池设备并不兼容与苹果的SMbus设备，所以，对于黑苹果，只能够通过ACPI来获取电池状态。为了解决电量显示我可是爬了不少帖子、花了不少时间呢。但是从我参考的中外教程来看，我觉得都不太理想，作为一个程序员的我都要看好几遍，普通用户怕是望而却步。再说作为小白用户其实没必要搞清楚里面的弯弯道道，能正常显示电量就是目标，所以萌生了写这篇文章的念头。

参考资料

• 修改DSDT实现电量显示方法【转载】
  

• [Guide] How to patch DSDT for working battery status
  

• Laptop-DSDT-Patch)下载了battery_HP-Envy-14（我的是HP Envy 13，当时认为应该是最接近的）参考对照，补丁和源文件都有的留下，补丁有源文件没有的删了，再依葫芦画瓢把源文件有补丁没有的补上，最后编译，除了16位、32位拆字节补丁无效（也就是类似下面的代码），其它的都正常，然后就傻不拉几的手工拆
  1. into device label H_EC code_regex BDC0,\s+16 replace_matched begin DC00,8,DC01,8 end;//我确定自己的设备标识也是H_EC
     
  2. ……

  复制代码
  特别注意类型如下代码
  1.     # 0x10即上面找出来的BDN0偏移量
     
  2.     into method label GBTI code_regex \(BDN0, replaceall_matched begin (RECB(0x10,56), end;
     
  3.     # 0x20即上面找出来的BMN0偏移量
     
  4.     into method label GBTI code_regex \(BMN0, replaceall_matched begin (RECB(0x20,128), end;
     
  5.     # 0x31即上面找出来的BCT0偏移量
     
  6.     into method label GBTI code_regex \(BCT0, replaceall_matched begin (RECB(0x31,128), end;

  复制代码
  编译成功另存为aml文件替换重启正常显示电量。至此，如果你不想继续看，用我一样的笨方法理论上是能解决问题的。码农天生喜欢折腾，不然也不会玩黑苹果了，于是我把补丁文件研究了一番寻求优雅方式
  
  高级进阶
  通过分析补丁文件，我发现了一个特点，就是除了增加方法，其它的都是正则匹配替换（在这里我假设你懂正则），于是我去看了Patching Syntax Grammar，下面我简单说明一下
  
  • 第一部分into|into_all就是在什么范围（后面跟着的限定），into应该的匹配第一个，into_all有多少匹配多少
  • 第二部分即限定，可以有All|DefinitionBlock|Scope|Method|Device|Processor|ThermalZone这些值
  • 第三部分即名称标识啥的了，支持标签名称、正则匹配、父项名称等
  • 第四部分selector，即选择器（支持正则）
  • 第五部分动作（就是在匹配项里干什么），支持insert|set_label|replace_matched|replaceall_matched|remove_matched|removeall_matched|remove_entry|replace_content|store_%8|store_%9这些
  • begin end里面的就是主体
    
  
  拆字节补丁例子
  1. # 在范围为^LPCB中查找（即）BDC0, 16的内容（s+就是有至少一个空格），替换成DC00,8,DC01,8
     
  2. # 也就是将BDC0, 16拆成两个字节DC00,8,DC01,8
     
  3. # 注意这里16后面没有逗号(,)，替换第二个8后面也没有，所以即使是}前一个也是通用的
     
  4. # 这个是GitHub下载补丁里的，我的设备标识是H_EC，但我发现无效，原因未知，于是我改了
     
  5. 
     
  6. into device label H_EC code_regex BDC0,\s+16 replace_matched begin DC00,8,DC01,8 end;
     
  7. into scope label ^^LPCB code_regex BDC0,\s+16 replace_matched begin DC00,8,DC01,8 end;
     
  8. # 拆分32位属性
     
  9. into scope code_regex BTY0,\s+32 replace_matched begin TY00,8,TY01,8,TY02,8,TY03,8 end;
     
  10. # 所有大于32位的都不用拆

  复制代码
  
  
  从上面的图片可以看到补丁完美实现拆字节，下面再看看调用例子
  
  访问属性补丁例子
  

  
      # 16位属性访问替换补丁
      # 注意BFC0在两个方法中有调用，都要写补丁替换
      into method label BTIF code_regex \(BFC0, replaceall_matched begin (B1B2(FC00,FC01), end;
      into method label _Q09 code_regex \^\^BFC0\) replaceall_matched begin ^^B1B2(FC00,FC01)) end;
      # 32位属性访问替换补丁
      into method label GBTI code_regex \(BTY0, replaceall_matched begin (B1B4(TY00,TY01,TY02,TY03), end;
      # 56位属性替换补丁
      into method label GBTI code_regex \(BDN0, replaceall_matched begin (RECB(0x10,56), end;
      # 128位属性替换补丁
      into method label GBTI code_regex \(BMN0, replaceall_matched begin (RECB(0x20,128), end;
      # 从56位和128位属性访问补丁可以看到是通过RECB(偏移量, 位数)这个方法实现的，理论上16位、32位的也可以不拆，访问的时候用这个方法，但是回到准备阶段第4部我们发现算每个属性的偏移量这工作比拆字节还头大

  
  
  其它举例
  

  # 在做Thinakpad E430电量补丁的时候发现有类型\_SB.PCI0.LPCB.EC.HWAK这样的调用，我用下面的补丁修正
  into method label _L43 code_regex \(\\\_SB.PCI0.LPCB.EC.HWAK replaceall_matched begin \(\\_SB.B1B2(\\_SB.PCI0.LPCB.EC.AK00, \\_SB.PCI0.LPCB.EC.AK01) end;
  # 理论上不需要上面那个补丁应该都能替换掉所有的，但发现不彻底，原因未知
  into ALL code_regex \(\\\_SB.PCI0.LPCB.EC.HWAK replaceall_matched begin \(\\_SB.B1B2(\\_SB.PCI0.LPCB.EC.AK00, \\_SB.PCI0.LPCB.EC.AK01) end;

  
  
  ehabMan大神提供通用代码
  ## RehabMan大神提供通用代码
  1. # 这部分之间拷贝到你的补丁文件前面
     
  2. # 特别注意部分行后面的\n，因为补丁里你即使输入了换行也是当一行出来的，所以加入了硬换行代码
     
  3. # 删除原有B1B2方法（一般都没）
     
  4. into method label B1B2 remove_entry;
     
  5. # 新插入B1B2方法
     
  6. # 这里需要注意一下，一般情况下默认的都没问题
     
  7. # 有些型号可能会导致打完补丁的少量代码访问不了B1B2方法
     
  8. # 这时候要么调整补丁绝对路径访问，要么插入的时候改个位置
     
  9. into definitionblock code_regex . insert
     
  10. # into Scope label \_SB code_regex . insert // 这是我改的位置
      
  11. begin
      
  12. Method (B1B2, 2, NotSerialized) { Return(Or(Arg0, ShiftLeft(Arg1, 8))) }
      
  13. end;
      
  14. 
      
  15. into method label B1B4 remove_entry;
      
  16. into definitionblock code_regex . insert
      
  17. begin
      
  18. Method (B1B4, 4, NotSerialized)\n
      
  19. {\n
      
  20. Store(Arg3, Local0)\n
      
  21. Or(Arg2, ShiftLeft(Local0, 8), Local0)\n
      
  22. Or(Arg1, ShiftLeft(Local0, 8), Local0)\n
      
  23. Or(Arg0, ShiftLeft(Local0, 8), Local0)\n
      
  24. Return(Local0)\n
      
  25. }\n
      
  26. end;
      
  27. 
      
  28. into method label RE1B parent_label EC0 remove_entry;
      
  29. into method label RECB parent_label EC0 remove_entry;
      
  30. into device label EC0 insert
      
  31. begin\n
      
  32. Method (RE1B, 1, NotSerialized)\n
      
  33. // Arg0 - offset in bytes from zero-based EC\n
      
  34. {\n
      
  35. OperationRegion(ECOR, EmbeddedControl, Arg0, 1)\n
      
  36. Field(ECOR, ByteAcc, NoLock, Preserve) { BYTE, 8 }\n
      
  37. Return(BYTE)\n
      
  38. }\n
      
  39. Method (RECB, 2, Serialized)\n
      
  40. // Arg0 - offset in bytes from zero-based EC\n
      
  41. // Arg1 - size of buffer in bits\n
      
  42. {\n
      
  43. ShiftRight(Arg1, 3, Arg1)\n
      
  44. Name(TEMP, Buffer(Arg1) { })\n
      
  45. Add(Arg0, Arg1, Arg1)\n
      
  46. Store(0, Local0)\n
      
  47. While (LLess(Arg0, Arg1))\n
      
  48. {\n
      
  49. Store(RE1B(Arg0), Index(TEMP, Local0))
      
  50. Increment(Arg0)
      
  51. Increment(Local0)
      
  52. }
      
  53. Return(TEMP)\n
      
  54. }\n
      
  55. end;
      
  56. 
      
  57. into method label RE1B parent_label EC remove_entry;
      
  58. into method label RECB parent_label EC remove_entry;
      
  59. into device label EC insert
      
  60. begin
      
  61. Method (RE1B, 1, NotSerialized)\n
      
  62. // Arg0 - offset in bytes from zero-based EC\n
      
  63. {\n
      
  64. OperationRegion(ECOR, EmbeddedControl, Arg0, 1)\n
      
  65. Field(ECOR, ByteAcc, NoLock, Preserve) { BYTE, 8 }\n
      
  66. Return(BYTE)\n
      
  67. }\n
      
  68. Method (RECB, 2, Serialized)\n
      
  69. // Arg0 - offset in bytes from zero-based EC\n
      
  70. // Arg1 - size of buffer in bits\n
      
  71. {\n
      
  72. ShiftRight(Arg1, 3, Arg1)\n
      
  73. Name(TEMP, Buffer(Arg1) { })\n
      
  74. Add(Arg0, Arg1, Arg1)\n
      
  75. Store(0, Local0)\n
      
  76. While (LLess(Arg0, Arg1))\n
      
  77. {\n
      
  78. Store(RE1B(Arg0), Index(TEMP, Local0))\n
      
  79. Increment(Arg0)\n
      
  80. Increment(Local0)\n
      
  81. }\n
      
  82. Return(TEMP)\n
      
  83. }\n
      
  84. end;

  复制代码
  补丁例子
  提供我做的两个型号（HP-ENVY-13及ThinkaPad E430）的补丁及原始DSL文件参考
  链接: https://pan.baidu.com/s/1Y8Vcnzn-SFTEZ_itMcRvKw 密码: gryy

jibem

谢谢分享　　　占楼备用

LiuJiangshan

谢谢分享。。

xiegengcai

因为发这贴的时候一直被拦截，删掉了一下内容才发成功，然后又进入审核，审核过了又没法再次编辑，
嗯，远景发帖很蛋疼
完整阅读请移步blog
http://xiegengcai.github.io/2018/05/05/how-to-create-battery-dsdt-fix/

kind1501

我是小白，小白是我，嘻嘻。

sarentunala

谢谢 分享

NoctisX

非常感谢，爬楼好久才找到这教程，谢谢

syreiz

非常感谢，爬楼好久才找到这教程，谢谢

wqznh

这种普及型的帖子多点最好 。感谢分享。

dantaona

感谢分享。

希批

谢谢分享~   

liugj47

希望提供word教程下载。

爱之特使

感谢对小白的支持，很有用处

13172668650

收藏了，感谢楼主

万个蛋

看不懂xili

厉害楼主

xiegengcai

应回复提供附件文档

xiegengcai

liugj47 发表于 2018-6-9 20:36
希望提供word教程下载。

远景动不动要审核，很麻烦，4楼有我博客的地址

kidddjh

技术贴吧支持

Aimisoy糊涂

感谢分享，DSDT太复杂了

baobao031

写的好详细，可以好好的研究一下，不在做伸手党