SoC中通常有很多IP，按邏輯可以把幾個相關(guān)功能的IP劃為一個電源域。一個電源域內(nèi)的IP，通常按相同的方式由同一個硬件模塊PMIC供電，電壓一樣并且電源管理例如休眠喚醒一致。

為什么有設(shè)備電源管理還需要power domain劃分？

對每個設(shè)備電源管理太細化了，會造成額外的開銷。通常幾個設(shè)備可以一塊進行管理更加的方便，例如一個子系統(tǒng)，要么全工作要么全關(guān)閉，不會子系統(tǒng)內(nèi)的某個設(shè)備單獨工作。這時候為了簡化管理工作就需要劃分出來一個domain。SOC上眾多電源域組成了一個電源域樹，他們之間存在著相互的約束關(guān)系，子電源域打開前，需要父電源域打開，父電源域下所有子電源域關(guān)閉，父電源域才能關(guān)閉。

Domain這個詞一般在權(quán)限管理中經(jīng)常遇到，用于隔離，Domain內(nèi)共進退。

雖然電源域的好處多多，卻不是越多越好，因為劃分電源域是需要成本的（需要在PMU中使用模擬電路完成，包括金錢成本和空間成本）。因此，大多數(shù)系統(tǒng)會根據(jù)功能，設(shè)置有限的幾個電源域，例如：CPU core（1、2、3…）；GPU；NAND；DDR；USB；Display；Codec等等。

這種設(shè)計引出一個問題：存在多個模塊共用一個電源域的情況。因而要求在對模塊power on/off的時候，考慮power共用的情況：只要一個模塊工作，就要power on；直到所有模塊停止工作，才能power off。

1. 框架介紹

Kernel的PM domain framework（位于drivers/base/power/domain.c中），提供了管理和使用系統(tǒng)power domain的統(tǒng)一方法：

對底層power domain硬件的操作

對power domain hw的開啟操作，包括開鐘、上電、解復(fù)位、解除電源隔離等操作的功能封裝；

對power domain hw的關(guān)閉操作，包括關(guān)鐘、斷電、復(fù)位、做電源隔離等操作的功能封裝；

內(nèi)部邏輯實現(xiàn)

通過dts描述power domain框架的設(shè)備節(jié)點，并描述每個power domain節(jié)點。提供出一個power domain framework的設(shè)備節(jié)點，及每個power domain子設(shè)備的節(jié)點，并指定power-domain-ccell = <1>，這樣可以通過power domain framework的設(shè)備及power domain的編號查找具體的power domain；

實現(xiàn)dts解析邏輯，獲取power domain的配置信息，并通過初始化函數(shù)對每個power domain進行初始化，所有的power domain統(tǒng)一的放在一個全局鏈表中，將power domain下所有的設(shè)備，放到其下的一個設(shè)備鏈表中；

為runtime pm、系統(tǒng)休眠喚醒等框架，注冊相應(yīng)的回調(diào)函數(shù)，并實現(xiàn)具體的回調(diào)函數(shù)對應(yīng)的power domain的開關(guān)函數(shù)；

上層使用power domain的上游驅(qū)動、框架及debug fs

linux系統(tǒng)的runtime power manager 框架通過提供runtime_pm_get_xxx/runtime_pm_put_xxx類接口給其他的drivers，對設(shè)備的開、關(guān)做引用計數(shù)，當(dāng)引用計數(shù)從1->0時，會進一步調(diào)到power domain注冊的runtime_suspend回調(diào)，回調(diào)函數(shù)里會先調(diào)用設(shè)備的runtime_suspend回調(diào)，然后判斷power domain下的設(shè)備鏈表中所有的設(shè)備是否已經(jīng)suspend，若已經(jīng)suspend才真正關(guān)閉power domain。當(dāng)引用計數(shù)從0->1時，會先調(diào)用到power domain使用的runtime_resume回調(diào)，回調(diào)函數(shù)里會先調(diào)用power domain的開啟操作，然后調(diào)用設(shè)備注冊的runtime_resume回調(diào)函數(shù)；

系統(tǒng)休眠喚醒在suspend_noirq/resume_noirq時會進行power domain的關(guān)閉與開啟的操作；

使用power domain的上游驅(qū)動：power domain內(nèi)部ip的驅(qū)動。比如，dsp子系統(tǒng)power domain下面，有多個dsp核，每個dsp核對應(yīng)一個power domain。這樣，每個dsp核設(shè)備驅(qū)動都要關(guān)聯(lián)到對應(yīng)的dsp核power domain上，通過dsp核設(shè)備的dts里power-domains的屬性引用（power domain framework的節(jié)點引用及具體power domain的編號），將dsp核設(shè)備與相應(yīng)的power domain關(guān)聯(lián)起來；

使用power domain的框架：runtime pm/系統(tǒng)休眠喚醒；

power domain也提供了一些debug fs文件節(jié)點供用戶debug使用，主要就是/sys/kernel/debug/pm_genpd/目錄及power domain名字目錄下的一些文件節(jié)點：

pm_genpd_summary：打印所有的power domain、狀態(tài)及下面所掛的設(shè)備狀態(tài)

power_domain名字目錄/current_state：power domain當(dāng)前的狀態(tài)

power_domain名字目錄/sub_domains：power domain當(dāng)前的子power domain有哪些

power_domain名字目錄/idle_states：power domain對應(yīng)的所有idle狀態(tài)及其off狀態(tài)的時間

power_domain名字目錄/active_states：power domain處于on狀態(tài)的時間

power_domain名字目錄/total_idle_time：power domain所有idle狀態(tài)的off時間總和

power_domain名字目錄/devices：power domain下所掛的所有devices

相關(guān)數(shù)據(jù)結(jié)構(gòu)：

image.png

初始化流程（以scmi power domain的驅(qū)動框架為例）：

image.png

2. 如何使用power domain

在dts中定義一個power domain節(jié)點，同時在驅(qū)動中注冊該power domain即可

//DTS中定義powerdomain節(jié)點，這里以內(nèi)核文檔提供的例程  
parent:power-controller@12340000{  
compatible="foo,power-controller";  
reg=<0x12340000?0x1000>;  
#power-domain-cells=<1>;//這里表明parent節(jié)點是一個powerdomain，也就是內(nèi)核文檔所形容的provider，parent管理它下面掛接著的其它模塊，為它們提供電源  
};  
  
child:power-controller@12341000{  
compatible="foo,power-controller";  
reg=<0x12341000?0x1000>;  
power-domains=<&parent?0>;//這里表明child節(jié)點是parent下面的一個模塊，它使用parent提供的電源  
#power-domain-cells=<1>;  
};

從上面的dts語法中可以看出，一個系統(tǒng)的電源域從dts中可以很容易就看出來，#power-domain-cells聲明該節(jié)點是一個power domain，power-domains = <&xxx x>表明該節(jié)點屬于xxx電源域，那么系統(tǒng)中某個電源域下面有多少個模塊就從dts中看有多少個節(jié)點引用了該電源域即可。

3. provider

intpm_genpd_init(structgeneric_pm_domain*genpd,  
structdev_power_governor*gov,boolis_off)//初始化一個generic_pm_domain實例  
  
//下面兩個接口都可以用來向內(nèi)核注冊一個powerdomian  
intof_genpd_add_provider_onecell(structdevice_node*np,  
structgenpd_onecell_data*data)  
intof_genpd_add_provider_simple(structdevice_node*np,  
structgeneric_pm_domain*genpd)

pm_genpd_init這個函數(shù)從注釋可以看出它初始化了一個power domain實例，從入口參數(shù)結(jié)合具體的實現(xiàn)代碼，可以很容易得到 structgeneric_pm_domain結(jié)構(gòu)體就對應(yīng)著一個power domain實例。

structgeneric_pm_domain{  
structdev_pm_domaindomain;/*PMdomainoperations*/  
constchar*name;  
atomic_tsd_count;/*Numberofsubdomainswithpower"on"*/  
enumgpd_statusstatus;/*Currentstateofthedomain*/  
unsignedintdevice_count;/*Numberofdevices*/  
unsignedintsuspended_count;/*Systemsuspenddevicecounter*/  
unsignedintprepared_count;/*Suspendcounterofprepareddevices*/  
int(*power_off)(structgeneric_pm_domain*domain);//驅(qū)動只要實現(xiàn)該函數(shù)即可  
int(*power_on)(structgeneric_pm_domain*domain);//驅(qū)動只要實現(xiàn)該函數(shù)即可

真正需要驅(qū)動去賦值的成員只有兩個，那就是int (*power_off)(struct generic_pm_domain *domain); 與int (*power_on)(struct generic_pm_domain *domain);，其它的power domain framework已經(jīng)幫我們做好了，這里我們也可以猜到一個電源域的打開與關(guān)閉最終是通過驅(qū)動注冊的這兩個函數(shù)操作的，

當(dāng)驅(qū)動得到一個power domain實例后，便可以調(diào)用of_genpd_add_provider_simple函數(shù)向內(nèi)核注冊一個power domain了，來進入該函數(shù)看看，做了哪些事情，看不太懂，但是從入口參數(shù)看，傳進去了驅(qū)動實現(xiàn)的struct generic_pm_domain和power domain的node節(jié)點。后續(xù)這兩個參數(shù)應(yīng)該會有作用。

4. Consumer

Cousumer可能是一個驅(qū)動程序或者sysfs，在驅(qū)動probe函數(shù)中調(diào)用dev_pm_domain_attach

ret=dev_pm_domain_attach(_dev,true);//將設(shè)備與電源域進行耦合

驅(qū)動在probe的時候會調(diào)用dev_pm_domain_attach函數(shù)檢查設(shè)備是否屬于power domain設(shè)備，如果是，則獲取設(shè)備的power domain信息，從哪里獲取信息？就是從前面power domain驅(qū)動調(diào)用of_genpd_add_provider_simple函數(shù)注冊進來的信息。

調(diào)用genpd_add_device函數(shù)，將設(shè)備添加到該power domain中，主要完成一些struct generic_pm_domain成員的賦值操作。

最后最重要的就是調(diào)用dev_pm_domain_set該函數(shù)，設(shè)置了struct device中的struct dev_pm_domain成員，該成員被賦值為struct generic_pm_domain中的struct dev_pm_domain成員。

后記

power domain在底層的處理通常需要PPU硬件的參與管理，可以控制這個電源域的時鐘、電壓、供電等屬性，從而達到對電源和功耗的管理。