本系列文章将分析Linux对于OMAP的电源管理功能,以AM33XX作为实例(目前的硬件平台先主要关注AM335xStarterKit开发板),在必要时穿插其他相关内容。
在linux-3.8.1/arch/arm/mach-omap2/board-generic.c中有如下定义(分析某个开发板的内核,自然从board file的machine desc开始):
其中与比较关键的电源管理相关的代码是am33xx_init_early()函数。该函数在linux-3.8.1/arch/arm/mach-omap2/io.c中。
下面我们从am33xx_voltagedomains_init(),am33xx_powerdomains_init(),am33xx_clockdomains_init()等几个函数分析。
下面的文档定义了什么是Voltage Domain【参考TI的PRCM文档SPRUFA5】。
根据这个定义,我们可以得出Voltage Domain的功能包括下面几项:
- 一个Voltage Domain由一个Voltage Regulator供电
- 有一个独立的可控开关
- 不同Voltage Domain可以有不同电压
- Voltage Domain的电压可以Scale ,可以基于普通DVFS,或者OPP,当然也可固定
- 当选定某个电压后,还可用类似SmartReflex的技术微调(软件透明,也可不透明)
- 可以完全关闭
- 可以支持唤醒(wake-up)
- 一个Voltage Domain可以有多个Power Domain
因此,如果要自己设计一个Voltage Domain的结构,可以考虑在其中支持一个voltage_control()的接口,参数可以是0到最大OPP电压,而全范围的OPP可以作为该结构的附加数据提供。不过我们还是先来看Linux的实现如何。
首先是am33xx_voltagedomains_init()的Voltage Domain初始化,在内核的linux-3.8.1/arch/arm/mach-omap2/voltagedomains33xx_data.c。
这里将MPU和CORE分成单独的Voltage Domain。但是实际上,根据《AM335x ARM® Cortex™-A8 Microprocessors (MPUs)》文档在"Power-Up Sequencing"一节中描述,应该可以合并这两个Voltage Domain。
{
When using the ZCZ package option, VDD_MPU and VDD_CORE power inputs may be powered from the same source if the application only uses operating performance points (OPPs) that define a common power supply voltage for VDD_MPU and VDD_CORE. The ZCE package option has the VDD_MPU domain merged with the VDD_CORE domain.
}
每个Voltage Domain由一个struct voltagedomain来表示。
注意,尽管TPS65910的文档上说明了该PMIC支持8个可编程的LDO,且在AM335xStarterKit开发板上的确通过AM335X_I2C0链接了这个PMIC的I2C,但是由于这些LDO连接的都是些常规I/O,限定了要求的电压范围(不可使用DVFS这样的方式来类似调整Voltage Domain的电压一样来调整输出电压),因此这里不把这些LDO看做独立的Voltage Domain。但是,实际上如果这些对应的模块不需要的话,应该还是可以在初始化时将其LDO电源关掉。
再注意到,TPS65910的文档上说明了该PMIC支持通过SmartReflex接口(实际上是独立的I2C接口)来控制Processor Core的Power。但是实际的AM335xStarterKit开发板上却没有连接这个SmartReflex接口。有一点需要注意,TPS65910实现的是SmartReflex Class-3,而AM335x实现的是SmartReflex Class-2B。下面的文字来自TPS65910文档。
关于SmartReflex的支持,可以参考这个GitHub的patch,但是这是针对AM335X EVM或者BeagleBone开发板的。在AM3359 - TMDXIDK3359开发板中,SmartReflex的I2C接口是接上的。
实际上,在TPS65910的文档中还说明了这个PMIC的SmartReflex寄存器是可以通过Control I2C和SmartReflex I2C访问的,但是需要通过Control I2C先配置其DEVCTRL_REG寄存器的SR_CTL_I2C_SEL位来选择。
下面简单分析对struct voltagedomain的管理。
首先是平台初始化代码通过voltdm_init()来把自己支持的Voltage Domain注册到系统中,实际上这是通过调用_voltdm_register()来实现的,并且是将这个struct voltagedomain加入到一个全局的voltdm_list中。从而,也就可以对这个voltdm_list进行查找,所以又有voltdm_lookup()函数。
另外,为了方便起见,还提供一个voltdm_for_each()函数,通过扫描这个voltdm_list,每当发现一个Voltage Domain,就调用指定的函数指针,从而可以实现对所有的Voltage Domain都执行某种操作的功能。由于每个Voltage Domain可以有多个Power Domain,因此voltdm_add_pwrdm()就被用来向一个Voltage Domain添加一个Power Domain(将这些Power Domain连接到这个Voltage Domain的pwrdm_list中)。类似的,还提供了一个voltdm_for_each_pwrdm()来对一个Voltage Domain的所有Power Domain执行指定的操作函数。
对于每个Voltage Domain,由于可以有不同的Scale的方法(比如可以使用Voltage Controller,也可以用Voltage Processor来实现),因此提供omap_change_voltscale_method()来改变相应的Scale方法。其实这一点,如果为了通用起见,应该让平台代码直接实现Scale方法就行了,也就是可以直接用xxx_set_scale_method()就可以。
omap_voltage_register_pmic()被用来设置struct voltagedomain的pmic字段。omap_voltage_get_voltdata()用来返回对应电压的相关数据(这里使用voltage table实现),即OPP数据。omap_voltage_get_volttable()就是用来返回这个voltage table的。voltdm_reset()将这个Voltage Domain的电压设置为当前OPP,实际调用的是voltdm_scale()实现的。voltdm_scale()就是用来实现Voltage Scale功能的,根据参数指定电压,在该Voltage Domain自己的voltage table中找到一项恰好大于该指定电压的"标称电压",用来设置对应的Regulator。voltdm_get_voltage()用来获得该Voltage Domain的当前标称电压nominal_volt。