Intel Parameter-Framework简介

来源：互联网发布：sql 批量replace 编辑：程序博客网时间：2024/05/20 11:32

【Parameter-Framework是什么】

Parameter-Framework 是一种基于插件（plugin-based）和既定规则（rule-based）的，用于处理各种 parameter 的框架。它在运行Android 系统的 Intel 架构设备上（例如智能手机、平板电脑）被广泛使用。它采用 pfw 语言进行记录并保存在后缀为 “.pfw” 的文件中，再通过特定的转换规则被转换成 XML 格式的文件，描述系统的结构和各个参数（parameters）。

【Parameter-Framework的用处】

可以用 Parameter-Framework 基于既定的规则来为智能手机或平板电脑等设备的各个硬件控制部件（这些控制部件可被视为 parameters）设定合适的值。举个例子，为设备的不同的音频应用场景（播放音乐、打电话、QQ语音等）分别采取合适的音频参数设置，这个过程通常被称为 “audio tuning”，就可以采用 Parameter-Framework 来实现。

【Parameter-Framework的文件组织结构】

Parameter-Framework文件的目录结构类似于下图：

最顶层的配置文件的文件名应该以 .in 后缀结尾（比如，ParameterFrameworkConfiguration.xml.in）。如下图：

有 2 个 makefile 文件很重要，它们的概念有相似之处可能引起混淆，简单介绍以示区别：

1、 device.mk

这个文件中列出了所有必须被引用的meta-package

2、 AndroidBoard.mk

这个文件中定义了上述的这些meta-package

【Parameter-Framework的XML格式文件生成规则】

下面的代码是一个示例：

include $(CLEAR_VARS)LOCAL_MODULE := AudioConfigurableDomains-bytcr-rt5640-default.xmlLOCAL_MODULE_TAGS := optionalLOCAL_MODULE_CLASS := ETCLOCAL_MODULE_RELATIVE_PATH := parameter-framework/Settings/Audioinclude $(CLEAR_PFW_VARS)# Refresh tunning + routing domain file for rt5640-defaultLOCAL_REQUIRED_MODULES := \    parameter-framework.audio.common \    parameter-framework.audio.baytrail \    ParameterFrameworkConfiguration-bytcr-rt5640-default.xml \    AudioClass-bytcr-rt5640-default.xml \    CodecSubsystem-bytcr-rt564x-common.xml \    CodecSubsystem-bytcr-rt5640-default.xml \    SstSubsystem-bytcr-rt5640-default.xml \    SstSubsystem-bytcr-rt56xx-common.xml \PFW_TOPLEVEL_FILE := $(TARGET_OUT_ETC)/parameter-framework/ParameterFrameworkConfiguration-bytcr-rt5640-default.xmlPFW_CRITERIA_FILE := $(COMMON_PFW_CONFIG_PATH)/AudioCriteria.txtPFW_TUNING_FILE := $(LOCAL_PATH)/Settings/Audio/AudioConfigurableDomains-bytcr-rt5640-default.Tuning.xmlPFW_EDD_FILES := \    $(PLATFORM_PFW_CONFIG_PATH)/Settings/Audio/routing_scalpe_common.pfw \    $(LOCAL_PATH)/Settings/Audio/bytcr-rt5640-default.pfwPFW_COPYBACK := Settings/Audio/$(LOCAL_MODULE)include $(BUILD_PFW_SETTINGS)

名称带有 PFW_前缀的变量很重要，简单说明一下：

PFW_TOPLEVEL_FILE：用于生成 XML 文件的顶层配置文件
PFW_CRITERIA_FILE：详细记录各个 criteria 的类型和值的文件
PFW_TUNING_FILE （可选文件）：包含已设定参数信息的 XML 文件
PFW_EDD_FILES：记录“.pfw”文件集合的文件
PFW_COPYBACK （可选文件）：如果这个变量被定义了，那么 XML 文件在生成后会被复制到 $(LOCAL_PATH) 变量值指定的目录中。这个配置只是临时生效而非永久效果。

在使用任何以 PFW_ 开头的变量以前，你必须调用 include $(CLEAR_PFW_VARS) 来清除之前的参数设定。在这之后，再调用 include $(BUILD_PFW_SETTINGS)就可以触发 XML 文件的生成过程了。这 2 个变量在文件 AndroidBoard.mk中被定义。

【PFW在android Audio中的运用】

在使用 Intel 平台的 Android 系统中，音频链路的设置使用了 PFW 来完成。既然上文中说到 PFW 是对 parameters 进行设置，那么我们在编写 PFW 文件之前应该先准备好被控制的对象——parameters，它们实际上是 Codec 芯片中的各个 Mixer。

如果在你的设备上音频模块使用了 tinyalsa，那么可以在 adb 登录到 shell 后使用命令 tinymix -D 1查看声卡上的所有 Mixer。

通常这些 Mixer 信息由 Codec 的芯片制造商以 XML 文件的形式给出，在文件中被称作 Component。这个 XML 文件通常会以 Codec 芯片型号来命名，比如叫 Realtek5677Subsystem.xml。文件内容大体格式分为子系统声明（Subsystem）、Component声明（Component Library）和 Component引用（Instance Definition） 3 部分，如下：

在 Component 声明（Component Library）中，使用 <CompnentType> 元素来定义具体的每一个部件的信息（例如 Mixer、Mux 等），它们可以由 IntegerParameter、BooleanParameter、EnumParameter 等 parameters 构成，也可以由别的 ComponentType 元素构成。如果 parameters 中的 Mapping 属性是 Control 类型，那么它的值实际上就是该 parameter 所对应的 Mixer Control 的名字。如下：

如果 parameters 中的 Mapping 属性是 Amend 类型，那么它的值可以用于替换前文中的 %1、%2 等变量。如下图中的 'Algo%1 Param1' 最终会被替换成 'Algo1 Param1' 或者 'Algo2 Param1'：

Component 声明中的 <ComponentType> 除了可以由其它 ComponentType 构成，也可以继承自其它的 ComponentType。使用 Extends 属性可以实现这个功能。如下图中名为 “OUTPUT_TYPE” 的 ComponentType 继承自名为 “INPUT_TYPE” 的 ComponentType，下辖的 parameter 既有本身的 VOLUME 又有继承而来的 SWITCH：

我们最后再来看一个综合了以上所有特性的 Component 声明的例子。如下图中的写法，我们将会声明 6 个 Mixer Control，分别是：

Control:'SpeakerPhone Digital Switch'

Control:'SpeakerPhone Digital Volume'

Control:'LineOut Analog Switch'

Control:'LineOut Analog Volume'

Control:'HeadPhone Analog Switch'

Control:'HeadPhone Analog Volume'

经过上述各部分的定义，它们在 PFW 文件中对应的元素，即被控制的 parameters 就可以生成了。如下：

/Audio/MYCODEC/SOUND_CARD/MIXER/PARAM1[IntegerParameter] name='Mixer param1'

/Audio/MYCODEC/SOUND_CARD/MIXER/PARAM2[BooleanParameter] name='Mixer param2'

/Audio/MYCODEC/SOUND_CARD/EQUALIZER/PARAM1[IntegerParameter] name='Equalizer param1'

/Audio/MYCODEC/SOUND_CARD/EQUALIZER/PARAM2[BooleanParameter] name='Equalizer param2'

/Audio/MYCODEC/SOUND_CARD/ALGO1/PARAM1[IntegerParameter] name='Algo1 param1'

/Audio/MYCODEC/SOUND_CARD/ALGO1/PARAM2[EnumParameter] name='Algo1 param2'

/Audio/MYCODEC/SOUND_CARD/ALGO2/PARAM1[IntegerParameter] name='Algo2 param1'

/Audio/MYCODEC/SOUND_CARD/ALGO2/PARAM2[EnumParameter] name='Algo2 param2'

/Audio/MYCODEC/SOUND_CARD/OUTPUTS/SPEAKERPHONE/VOLUME[IntegerParameter] name='Speakerphone Digital Volume'

/Audio/MYCODEC/SOUND_CARD/OUTPUTS/SPEAKERPHONE/SWITCH[IntegerParameter] name='Speakerphone Digital Switch'

/Audio/MYCODEC/SOUND_CARD/OUTPUTS/LINE_OUT/VOLUME[IntegerParameter] name='LineOut Analog Volume'

/Audio/MYCODEC/SOUND_CARD/OUTPUTS/LINE_OUT/SWITCH[IntegerParameter] name='LineOut Analog Switch'

/Audio/MYCODEC/SOUND_CARD/OUTPUTS/HEADPHONE/VOLUME[IntegerParameter] name='Headphone Analog Volume'

/Audio/MYCODEC/SOUND_CARD/OUTPUTS/HEADPHONE/SWITCH[IntegerParameter] name='Headphone Analog Switch'

有了 parameters 后就可以编写 PFW 文件对其进行控制了。

我们再来看 PFW 文件中的内容和格式，如下图可分为域（supDomain / domainGroup / domain）、配置规则（conf）等，而绿色部分的 parameter 就是通过上文中 XML 文件所得到的：

最终 PFW 文件也会被转换成 XML 格式的文件，例如上方这段 PFW 信息会被转换成下方的 XML 内容：

具体分析一下 PFW 文件中的音频链路设定（Audio Route）规则。音频链路设定的过程可以分为 3 个阶段，分别是 Flow、Path 和 Configure。其中 Flow 阶段控制是否允许音频数据的输出，Path 阶段控制是否打通某条音频链路，Configure 阶段对链路上传输的音频格式进行配置。具体到代码中，不管是 Routing 还是 Re-Routing 的过程对应的函数也分为这 3 个大阶段，如下：

而这每个阶段则都是按照使用场景的需求从 PFW 文件中读取相应的 parameter 进行设定，如下：

上方截图展示的是 Flow 阶段的实际代码实现，Path 和 Configure 阶段也是类似的。

PFW 文件中 Flow 阶段的内容如下图，当设备上插入了耳机或带麦克风的耳机，并且设备当前处于通话或播放多媒体的状态时，耳机链路的数据输出开关将被打开，即 /AUDIO/REALTEK/SOUND_CARD/OUTPUT/HEADPHONE/SWITCH 参数的值被设置为 1：

PFW 文件中 Path 阶段的内容如下图，当设备处于通话或播放多媒体的状态时，耳机链路将被选通即 /Audio/REALTEK/SOUND_CARD/MIXER/DIGITAL/DAC_MIXER/STEREO/RIGHT/1/SWITCH 和 /Audio/REALTEK/SOUND_CARD/MIXER/DIGITAL/DAC_MIXER/STEREO/LEFT/1/SWITCH 被设置为 1：

PFW 文件中 Configure 阶段的内容如下图，将 Codec 芯片中输出的音频数据配置为 16 位深度、双声道输出、48000Hz 采样率：

【实例分析】

上面讲了这么多，都是从意义、语法规则等全局层面来讲解的，可能还是有点抽象。下面从工程中的一个 PFW 文件里截取一行用于 route 控制的语句，再结合上文描述的规则进行具体分析，应该能让大家理解得更清晰。

在文件 device/intel/common/audio/parameter-framework/Settings/Audio/routing_realtek5677.pfw 中有下面这条控制语句：