高通thermal-engine配置文件格式详解

本文基于高通msm8939/8994平台文档及源码。

说明文档： vendor/qcom/proprietary/thermal-engine/readme.txt；

源码文件： venror/qcom/proprietary/thermal-engine/thermal_config_v2.c；

实际配置文件： vendor/qcom/proprietary/thermal-engine/thermal-engine.conf。

关注源码文件的global_table,pid_table, tm_table, ss_table, v_table, eq_table声明。其中global_table为全局配置选项，对应2.1中的算法实例标签之前的部分；pid_table对应pid算法配置格式；tm_table对应monitor算法配置格式；ss_table对应ss算法配置格式；v_table对应virtual算法配置格式；eq_table对应equilibrium配置格式(此格式暂时未见使用)。

配置文件基本格式

{debug} //可选，若有此选项表示使能调试信息

sampling // 默认采样率，以ms为单位

[<算法实例标签>] // 算法实例标签

algo_type // 算法类型，必须是算法实例的第一个字段

disable //可选，用于默认情况下禁止该算法实例起作用

…

算法类型

算法类型共有4种： monitor, pid, ss, virtual。每种的格式各不一样。

算法类型对应thermal_config.h(vendor/qcom/proprietary/thermal-engine/inc)中的algo_type枚举类型，实际上有5种，除以上4种外，还有一个equilibrium类型。但从algos数组声明(thermal_configi_v2.c)可以看出，equilibrium还未被使用。

monitor算法配置格式

[<算法实例标签>]

algo_type          monitor
sensor                 <传感器名称>
sampling            <采样率(ms)>
descending                 //       可选，默认门限是升序，有此字段后门限顺序为降序
thresholds     <门限值(mC/mA)>
thresholds_clr  <清除门限值>
actions        <达到门限时的动作，多个动作时用'+'连接>
action_info    <动作额外信息，多个额外信息间用'+'连接>

pid算法配置格式

[<算法实例标签>]

algo_type          pid
sampling            <采样率(ms)>
sensor                 <传感器名称>
device                <被PID算法调制的设备>
set_point           <PID算法调整的目标值(mC/mA)>
set_point_clr     <PID算法停止调整的值>
p_const              <PID算法中的P常量>
i_const               <PID算法中的I常量>
d_const              <PID算法中的D常量>
i_samples          <积分组件报错时的积分样本数>
dev_units_per_calc  <积分算法输出调整单元值(每次调整的值)>

ss算法配置格式

[<算法实例标签>]

algo_type          ss
sampling            <采样率(ms)>
sensor                 <传感器名称>
device                <被PID算法调整的设备>
set_point           <PID算法调整的目标值(mC/mA)>
set_point_clr     <PID算法停止调整的值>
time_constant  <当当前和上一个错误采样值相等时的延迟调整系数>
device_max_limit     <设备最大值(mC/mA)>            // 可选

virtual算法配置格式

该算法实际作用是用已存在的传感器模拟出一个新的传感器。

[<虚拟传感器名字>]

algo_type          virtual
trip_sensor        <传感器名称>
set_point           <当高于此温度时，虚拟传感器开始polling模式>
set_point_clr     <当高于此温度时，虚拟传感器停止polling模式>
sensors               <用于计算温度总和的传感器数组>
weights               <权重值数组>
sampling            <默认采样率>

配置文件字段解释

thresholds取值

‘thresholds’/‘thresholds_clr’/‘actions’/'action_info’接受最多8级以空格分开的门限。

action取值

‘none’:

actions: 无动作

action_info: 忽略

‘report’:

actions: 报告"穿过门限消息"给UI

action_info: 忽略

备注：

"穿过门限消息"以每行独立的格式报告给THERMALD_UI（一个抽象的本地socket）;

清除或触发门限会导致消息上报，比如n+1级门限被清除或者触发了n级门限；其它

动作是达到门限时才触发；

参数按以下顺序发送：sensorname, temperature, current_threshold_level, is_trigger。其中：

current_threshold_level为当前被触发/清除的门限；is_trigger为true时表示触发，为false

时表示清除。

‘cpu’:

actions: 调整cpu频率

action_info: cpu最大允许频率，单位：KHz

‘cpuN’:

actions: 调整第N个cpu频率

action_info: cpuN最大允许频率，单位：KHz

‘hotplug_N’:

actions: 拔掉第N个cpu(cpu_down)

action_info: 0: 插上cpu(cpu_up), 1:拔掉cpu(cpu_down)

‘lcd’:

actions: 限制lcd亮度

action_info: lcd最大亮度，取值范围：0-255

‘modem’:

actions: 请求限制modem功能

action_info: modem的限制级别，取值范围:0-3

‘fusion’????)

actions: 请求限制 fusion modem功能

action_info: fusion modem的限制级别，取值范围:0-3

‘battery’:

actions: 限制电池充电电流

action_info: 电池充电电流限制级别，取值范围:0-3

‘gpu’:

actions: 调整gpu频率

action_info: gpu最大允许频率，单位：KHz

‘wlan’:

actions: wlan(无线局域网)限制

action_info: WLAN限制级别，取值范围0-4

‘shutdown’:

actions: 关机

action_info: 关机延迟时间,单位:ms

备注：

从gen_dev_list变量声明(vendor/qcom/proprietary/thermal-engine/devices/devices.c)可以看出，还有如下取值：‘vdd_restriction’, ‘kernel’, ‘camera’,‘camcorder’, ‘vdd_dig_swmode’,‘opt_curr_req’,

‘venus’,‘modem_cx’。从gen_dev_list及hotplug_dev_list可以总结出各action字段及动作函数的对应关系：

动作名称	执行动作函数	动作信息
‘cpu’	cpu_all_action()	最大频率
‘cpuN’	cpu_action()	最大频率
‘hotplug_N’	hotplug_action()	1级
‘wlan’	wlan_action()	MAX_WLAN_MITIGATION_LEVEL(4)
‘battery’	battery_action()	MAX_BATTERY_MITIGATION_LEVEL(3)
‘lcd’	lcd_action()	255级亮度
‘shutdown’	ts_shutdown_action()	UINT32_MAX
‘none’
‘report’	ts_report_action()
‘modem’	modem_action()	3
‘fusion’	fusion_modem_action()	3
‘vdd_restriction’	vdd_restriction_action()	1
‘kernel’	kernel_mitigation_action()	1
‘camera’	camera_action()	MAX_CAMERA_MITIGATION_LEVEL(10)
‘camcorder’	camcorder_action()	MAX_CAMCORDER_MITIGATION_LEVEL(10)
‘vdd_dig_swmode’	vdd_dig_automode_diable_action()	1
‘opt_curr_req’	optimum_current_request_action	1
‘mdp’	mdp_action()	MAX_MDP_MITIGATION_LEVEL(3)
‘venus’	venus_action()	MAX_VENUS_MITIGATION_LEVEL(3)
‘modem_cx’	modem_cx_limit_action()	3
‘gpu’	gpu_action()	最大频率

表 1 action属性

device取值

‘cpu’:

actions: 调整cpu频率

action_info: cpu最大允许频率，单位：KHz

‘cpuN’:

actions: 调整第N个cpu频率

action_info: cpuN最大允许频率，单位：KHz

备注：

device还可取以下值： ‘gpu’, ‘clusterN’

配置文件示例

示例1

配置文件：

[PMIC_THERM_MON]
algo_type        monitor
sensor           PMIC_THERM
sampling         5000
thresholds       40200          45000      50000
thresholds_clr   38000          43000      48000
actions          cpu+report       cpu       cpu
action_info      1188000+0      368640     245760

描述：

默认采样率为1s；
PMIC_THERM传感器采样率为5s；
当温度升到到40.2度以上时，触发门限1，调节cpu最大允许频率为1188000KHz，在本例中，由于此频率是最大值，因此实际无动作；同时上报此消息，action_info值0被忽略；
当温度降低到38度以下时，清除门限1，并上报此消息；
当温度升高到45度以上时，触发门限2，调节cpu最大允许频率为368640KHz；
当温度降低到43度以下时，清除门限2，调节cpu最大允许频率为1188000KHz。

示例2

配置文件：

[bcl_monitor]
algo_type        monitor
descending
sensor           bcl
sampling        2000
thresholds       100         0
thresholds_clr   500        100
actions           report         report
action_info       0            0

描述：

使能调试信息输出；
默认采样率为2s；
对于电池电流限制(battery current limit)传感器，采样率为1s；
当电池电流升到imax - 100mA时，触发门限1，并上报此消息；
当电池电流降到imax - 500mA时，清除门限1，并上报此消息；
当电池电流升到imax时，触发门限2，并上报此消息；
当电池电流降到imax -100mA时，清除门限2，并上报此消息。

示例3

配置文件：

[TEST_PID]
algo_type          pid
sensor             tsens_tz_sensor0
device             cpu
sampling           1000
set_point          85000
set_point_clr      65000
p_const            1.0
i_const            1.0
d_const            1.0
i_samples          10
dev_units_per_calc 10000

描述：

使能调试信息输出；
本PID算法实例标签为TEST_PID；
使用tsens_tz_sensor0传感器；
被调节设备是CPU；
采样率为1s；
set_point值是PID调节算法的门限值和PID算法的设定值；
set_point_clr是停止PID调节算法的门限值；
p_const, i_const, d_const是PID等式中的p,i,d常量；
i_samples是PID等式中的积分错误采样次数；
dev_units_per_calc 10000 kHz(设备是CPU，因此单位是kHz)是PID输出增加的步进值（即按10000KHz为步长调整？？）；

示例4

配置文件：

[virtual_sensor-0]
algo_type             virtual
sensor                tsens_tz_sensor8
set_point             35000
set_point_clr         30000
sensors               tsens_tz_sensor1  tsens_tz_sensor5
weights               40  60
sampling              250[Test-PID]
algo_type             pid
sensor                virtual-sensor-0
device                cpu1
sampling              250
set_point             55000
set_point_clr         50000
p_const               1.25
i_const               0.8
d_const               0.5
i_samples             10
dev_units_per_calc    5000

描述：

PID实例Test-PID基于virtual-sensor-0的结果；
virtual-sensor-0需要用户手动定义；
trip_sensor 用来指示虚拟传感器何时开始进入polling模式(轮询)，trip_sensor必须为常规传感器，不能为另外一个虚拟传感器；
set_point是trip sensor的门限值，当高于此门限值时，trip sensor将从中断模式进入轮询模式，轮询频率由虚拟传感器的sampling字段设置；
set_point_clr是trip sensor的门限值，当低于此门限值时，trip sensor将停止轮询模式然后等待下一个门限事件；
weights给定了传感器数组的权重值；
虚拟传感器的set_point必须小于pid算法的set_point，以便当达到set_point时pid能收到通知，另外，如果虚拟传感器未进入轮询模式，pid将不能获取到它的温度；
如果tirp sensor不支持从中断模式到查询模式的改变，第8条可以被忽略。此时虚拟传感器的采样率将应该和pid的采样率一致。

示例5

配置文件：

[bcm_monitor]
algo_type             monitor
sensor                bcm
sampling              1000
thresholds            70000         90000                 // 注意，单位为m%
thresholds_clr        69000         89000
actions               cpu             cpu
action_info           768000       384000

描述：

使能调试信息输出；
当采样电流达到imax的70%时，门限1触发，调整cpu最大允许频率为768000KHz；
当采样电流达到imax的90%时，门限2触发，调整cpu最大允许频率为384000KHz；
bcm仅支持2级门限调节；
有效的门限值取值为：40000,50000,60000,70000,80000,90000。

示例6

pix3 Android 10.0.0 中配置的config内容如下:

[SS-SKIN-HIGH-CPU4]
algo_type ss
sampling 2000
sensor fps-therm-adc
device cpu4
set_point 39000
set_point_clr 38000
device_max_limit 1996800
time_constant 0[SS-SKIN-MID-CPU4]
algo_type ss
sampling 2000
sensor fps-therm-adc
device cpu4
set_point 41000
set_point_clr 40000
device_max_limit 1689600
time_constant 0[SS-SKIN-LOW-CPU4]
algo_type ss
sampling 2000
sensor fps-therm-adc
device cpu4
set_point 43000
set_point_clr 42000
device_max_limit 1363200
time_constant 0[HOT-SKIN-VIRTUAL]
algo_type               virtual
trip_sensor             fps-therm-adc
sensors                 gpu0-usr cpu0-silver-usr
list_cnt                2
weights                 1 -1
set_point               40000
set_point_clr           37000
sampling                1000
math                    0[VIRTUAL-SS-GPU-SKIN]
algo_type               ss
sensor                  HOT-SKIN-VIRTUAL
device                  gpu
sampling                1000
set_point               8000
set_point_clr           2000
device_max_limit        414000000[SKIN-MONITOR]
algo_type       monitor
sampling        1000
sensor          fps-therm-adc
thresholds      45000               47000               57000
thresholds_clr      43000               45000               56000
actions         cpu0+cpu4+gpu         cpu0+cpu4+gpu         shutdown
action_info     979200+1056000+414000000  748800+825600+257000000       1[BATTERY-MONITOR]
algo_type           monitor
sampling            2000
sensor          fps-therm-adc
thresholds          39000       41000       43000       48000
thresholds_clr      38000       40000       42000       46000
actions         battery     battery     battery     battery
action_info     1       2       3       4[MNH-MONITOR]
algo_type           monitor
sampling            2000
sensor          fps-therm-adc
thresholds          45000       47000
thresholds_clr      44000       46000
actions         mnh     mnh
action_info     3       4[MODEM-MONITOR]
algo_type       monitor
sampling        1000
sensor          fps-therm-adc
thresholds      48000           53000
thresholds_clr      45000           51000
actions             modem+modem_proc       modem+modem_proc
action_info     1+1                    3+3