[原创]BIOS知识点滴Follow Bini系列之---WMI ACPI

bini

因看论坛一些用户问到这块，我在这里也献丑给大家“简单”介绍一下。如果能为你节省开发时间，下次碰到我记得请我吃饭。

        Microsoft® Windows® Management Instrumentation（WMI）是微软提供的Windows环境自动管理方案，它建立在“公共信息模型”（CIM）这个工业标准的基础上。
+ t; S1 d) O0 T. b& X  u, W
WBEM ： WBEM（Web-Based Enterprise Management）作为一项业界倡议，起始于1996年，它规范了企业网络中受管资源的描述与使用。WBEM由以下几个组件组成：
. A$ N% e* F1 v4 D! P" U1） CIM 公共信息模型 (CIM――Common Information Model)是一种机制，用于为受管资源建模并以受管对象格式 (MOF) 表现这些模型。使用CIM和MOF，组成受管资源或资源网络的组件可以象在面向对象设计过程中使用的组件一样被建模和看待。
2） 受管对象格式 (MOF) 是源自CIM模型中的类和关联的正规描述。MOF有它独有的语法，但使用来自于DMTF中的DTD可将它转化为XML。
4 ?0 X* C/ W) C4 R0 r3） 标准化模型是一个CIM类集合，用于表现一个特殊的管理域。模型可以表现核心CIM类、网络类、软件类和更多的类。
4） CIM对象管理器 (CIMOM) 是CIM类实例的一个数据库。CIMOM是访问管理资源的重点。
5） XML API提供对数据的标准化访问并启用针对CIMOM中显示的受管资源的操作。
4 ]. B4 |4 K+ m, d. {) U) S' R
1 m2 b+ n$ D+ e0 d, ]/ ^& |各个公司提供自己对WBEM的实现，它们都必须遵循由DMTF提出的规范。所有符合WBEM的技术必须接受由DMTF发行的标准化模型并且所有关联的CIMOM都可通过标准XML API访问。MSDN上所提供的WMI架构图：


4 A  V0 j2 g2 ]" I- m5 ?( @, c    关于WMI的具体资料，请在微软相关的网站查找。（官方MSDN地址：http://msdn.microsoft.com/en-us/library/aa394582.aspx ）

事前准备：
1、装好(windows 2000或以上) DDK，我用的是Windows DDK 3790.1830
! o) j9 m6 K2 f% r2、准备好你的BIOS源码，含DSDT源码。
# N3 ]/ y  I4 H可选学习的准备：
1、Windows System Administration Scripting Guide - Script Repository （练习一些管理脚本的编写）
7 T+ |- y. R. K0 d; E6 ?        地址：http://www.ufoit.com/bbs/thread-351-1-1.html
- `8 m/ w- e) G/ [2、WMI-ACPI白皮书（Windows 2000 Instrumentation: WMI and ACPI），见后面附件(Attachment）。

WMI ACPI数据处理介绍：
2 n0 O% ~% K" Y. P( V1、ACPI驱动依据受管对象格式 (MOF) 所描述的对象，进行数据收集，如在ACPI BIOS内，就会访问ACPI BIOS进行数据收集。
' W" w1 o2 x0 B  u- e) B2、上层软件既可对WMI所受管的对象进行数据访问。
! ^6 y' Y( p' l
( A/ z! S4 ?: X, O1 J( o我们要做的几个步骤：
* t, }5 d# d4 V3 P" C$ ~: E2 c1、编好对象格式 (MOF)文件。
( W( d( y5 Z. l0 F8 o% D1 t& s2、用DDK编译对象格式 (MOF)文件成为资源文件之后，参照wmi acpi白皮书，进行wmi-acpi注册，以让wmi acpi driver接管。
5 _/ a' ]0 {+ _* f8 g4 V3、BIOS按wmi acpi白皮书中的方法，对应MOF文件的数据或方法进行描述。编译BIOS刷入。
  h  _1 C) g# M3 O. |1 d      PS: pnp0c14 is the ID assigned by Microsoft to the WMI to ACPI mapper，   Name(_HID, "*pnp0c14")
8 }8 M" M, s; O" x4、重启，至此，在OS中可用上层软件进行与BIOS通信。大功告成！

分解慢动作：
0 Z+ w! Q6 o1 P5 S4 M7 X1、分解MOF文件.

1. // Author: bini.Yi易祝兵 http://www.ufoit.com 2008-09-24
   
2. // File: demowmi.mof
   
3. //{39142400-C6A3-40fa-BADB-8A2652834100}
   
4. //IMPLEMENT_OLECREATE(<<class>>, <<external_name>>,
   & P$ R, Q% N5 U9 f7 n8 k3 |4 Z
5. //0x39142400, 0xc6a3, 0x40fa, 0xba, 0xdb, 0x8a, 0x26, 0x52, 0x83, 0x41, 0x00);
   
6. 
   ! x0 q  f& _+ R1 U2 R# Y. }
7. [WMI,
   
8. Dynamic,
   3 C6 ?+ B/ o: R0 N/ @1 L. i
9. Provider("WmiProv"),
   ; ]6 W% s$ t& Z; L3 z5 }6 {3 e
10. Locale("MS\\0x409"),
    . ~5 h( E; O3 |$ k; f( j) D
11. Description("Events"),
    
12. guid("{39142400-C6A3-40fa-BADB-8A2652834100}")
    2 }+ S8 `: @' {- n2 v( N4 c4 C
13. ]
    0 v8 O9 T$ I( r. K. {% Z: x
14. class DemoWMIData
    
15. {
    
16.     [key, read]
    . N9 e: M5 O2 P- `' M7 l# s
17.      string InstanceName;
    * i! o. }: D0 w7 s
18.     [read] boolean Active;
    
19. 
    
20.     [WmiDataId(1),
    / y3 _4 M4 G; P3 R$ K$ D, G. u
21.      read, write,
    
22.      Description("description")
    ) X6 v/ ~% V$ W8 j0 D* y. ^
23.     ] uint32 Data;
    ' [: l: g4 x1 q/ @( p7 D
24. };

复制代码

2、第二步用DDK编译MOF文件分解

1. rem makedemo.bat ,by bini.yi for teaching.
   2 r' \+ F0 O( Q' ~. g7 \# v- [
2. Mofcomp -B:demowmi.bmf demowmi.mof
   
3. wmimofck -tdemowmi.vbs demowmi.bmf
     K/ w* J& `6 }( y
4. rc demowmi.rc
   
5. Link /DEF:demowmi.DEF demowmi.res /NOENTRY /DLL /MACHINE:Ix86 /OUT:demowmi.dll

复制代码

注：用上步骤编译后会自动参生 vbs脚本，用于验证。
; O7 K* y7 A/ K3 u4 S- w& C然后按WMI ACPI白皮书的方法加入注册表。

3、第三步分解：ACPI BIOS DSDT中加入代码，编好刷入。

1. // Author: bini.Yi易祝兵 http://www.ufoit.com 2008-09-24
   
2. // File: demowmi.ASL
   # s# u/ R+ v5 z, I4 R- i4 }1 t
3. 
   + Y6 |9 e. j8 ~5 \
4. Device(DWMI)
   5 q: H( s; R3 w: u: ^
5. {
   ; l( w5 }, X# E0 M0 |& l; ^3 c
6. // PNP0C14 is PNP ID assigned to WMI mapper
   ' n/ A+ k# t7 l* s& V
7. Name(_HID, EISAID("PNP0C14"))
   " v& _' {: A+ |5 q  S+ ?
8. Name(_UID, 0x0)
   " R! a9 A- _. w0 U+ [4 O4 R! d+ ]7 A
9. 
   
10. Name(_WDG, Buffer(){
    
11. // {39142400-C6A3-40fa-BADB-8A2652834100}
    + k4 _( L# X  n% m  ~4 F+ r8 R
12. 0x00, 0x24, 0x14, 0x39, 0xA3, 0xC6, 0xFA, 0x40, 0xBA, 0xDB, 0x8A, 0x26, 0x52, 0x83, 0x41, 0x00, 0x30, 0x30, 0x01, 0x01, // 00 = Demo
    * y* i7 j3 ?9 v7 S: {0 ?6 A, p
13. })
    
14. 
    
15. Name(DD00, 0)
    9 a6 m2 J" M3 G1 C/ w5 D2 o
16. 
    2 C1 Y/ Y8 B+ E0 S+ v/ `" p1 [4 U/ L& F
17. Method(WQ00, 1)
    & E5 t9 j8 c9 ], Y
18. {
    2 P& g. H2 ]8 |1 x! h* @; G8 t
19.    //DBGS("Demo Wmi Get Function:")
    
20.    //DW2H(DD00)
    2 ~$ S6 }7 c3 L+ ~1 f
21.    //尝试一下发一些看得见摸得着的东西出来
    
22. Return(DD00)
    5 Z2 g1 z. ~* c! T  }
23. }
    
24. 
    * m1 w5 `0 C7 w) h: i% b
25. Method(WS00, 2)
    
26. {
    4 Y% v6 N* ^$ Y1 k
27.    //DBGS("Demo Wmi Set Function:")
    " F- O7 p( D4 F) K2 Z8 N! V
28.    //DW2H(ARG1)
    
29.    //尝试一下发一些看得见摸得着的东西出来
    7 Q' d4 V" U9 M& \5 O
30. Store(ARG1, DD00)
    5 i6 q7 T7 l3 J! b- T4 Q
31. }
    
32. }

复制代码

4、什么？死机....还要拆机！....不关我的事。
# }$ b; }7 D1 z; R& j( r; l5 R
9 @* {( i! t0 w. ?$ _运行一下VBS看看，怎么样？有没有兴趣整一个acpi debugger或者写一个与BIOS通信的Application了呢？那就敢快出手吧~！

2 h6 t# j" w: o最后，我自己写的两个Dll及文档，以及其它东西都在附件里。(仅对个人学习用，如用于商业行为，后果自负）

ljk19841115

呵呵，又有更新了赶紧学习！@！！

peterhu

太强了，顶你！
8 X3 z8 Y( r5 e, D; O; W% P我们家的上层AP使用上述架构。

david

各位, 别放过了, 值得研究!
+ v+ f. l$ Q, [6 E4 q, n国内第一台笔记本的 Controll Application 就是这只狼搞的, 用的就是这个! 可不是像网上的那些写的空洞的理论的, 这可是他的心得和实践啊!

xtdumpling

非常难得啊！！
/ c) f0 a+ d1 J: k学习~

wki

这样的话，只有BIOS的SourceCode和编译环境才能验证，是吧？
我们最近也想搞一个类似的东西，方向不是太明确。
8 s2 E. G% s/ [4 v不知道楼主这个方法是不是通过WMIACPI.sys来实现的？是的话，XP下是怎么做的，因为XP默认是没有WMIACPI.sys的。

[ 本帖最后由 wki 于 2009-1-12 22:19 编辑 ]

wki

不好意思，刚接触这方面的知识，现在知道了，似乎是一旦在BIOS中加入ASL，系统会自己加载WMIACPI.sys，具体还是需要验证。。。

go_ahead

很感谢！需要好好学习

A_jack

bini我有一个疑问。用你的这种方法，能不能访问除了Device(DWMI)之外的device.

woshids

学习了~~~~~~~~~~~~~~~

wzh0591

很有借鉴价值，谢谢楼主！

plt1628

请教！我在用隐藏分区恢复系统的时候提示 WMI ACPI is not surpport
这是什么意思呀？我的电脑是宏碁的笔记本

cola2427

感恩啦^^好工具激發學習原動力^^

frank

rttt
* A% w: ]+ r1 A* Q$ w( L9 k
* u* k: ^; j- k+ }1 K[ 本帖最后由 frank 于 2010-8-19 11:22 编辑 ]

bayni_1980

运行makedemo.bat出现问题，少了个demowmi.rc

lightsome

看不太懂，努力学习

蓝色永恒

很不错，经过努力学习，已经利用DemoWmi 实践Ok，谢谢
同时 也用WDK 6000中的src\ WMI \ wmiacpi 中的sample code 实践成功

不过仍然对于MOF注册有点疑问：
      我一直使用的是 修改注册表的方式 （因为是在实验阶段）
6 F, `7 w$ M  @2 T如果我要写App 用在量产阶段，那应该要用一个Special GUID 把MOF data  Embeded into  ASL 。
   现在有一点不确定的是：这里的MOF data 是指的是用 MOF source build 出来的BSF file 吗？
( B1 g4 |) d* `% \4 q    还有，如果是BSF file 是不是Copy 过去ASL中就可以了？
白皮书Sample 里建立的  Buffer  Size 为 926 ，我的BSF file Size 是 2.15K ，是不是要建立一个 Buffer 为 2150？
2 k) |; r6 E$ f! E: e    希望大家不吝赐教，谢谢啦
. M8 N5 m! k7 v9 n
" z7 z! [6 X9 o' [- J- u: A$ Y8 e' q[ 本帖最后由 蓝色永恒 于 2011-3-11 10:24 编辑 ]

benbenben007

sample code简单易懂