Android : android 8.0 audio 接口分析
1、HIDL 的概念
HIDL 读作 hide-l,全称是 Hardware Interface Definition Language。它在 Android Project Treble 中被起草,在 Android 8.0 中被全面使用,其诞生目的是使 Android 可以在不重新编译 HAL 的情况下对 Framework 进行 OTA 升级。
使用 HIDL 描述的 HAL 描述文件替换旧的用头文件描述的 HAL 文件的过程称为 * HAL 的 binder 化(binderization)。所有运行 Android O 的设备都必须只支持 binder 化后的 HAL 模块。
已发布的 HIDL package包位于 Android 代码库的hardware/interfaces/
或vendor/<vendorName>
目录下。使用 HDIL 描述的 HAL 接口存放在这些目录下的.hal
文件中。比如我们可以在hardware/interfaces/audio/2.0/
目录下找到部分 Audio HAL 描述文件,如下:
Android.bp
Android.mk
IDevice.hal
IDevicesFactory.hal
IPrimaryDevice.hal
IStream.hal
IStreamIn.hal
IStreamOutCallback.hal
IStreamOut.hal
types.hal
另外在frameworks/av/media/下多了个文件夹 libaudiohal :
Android.mk DeviceHalLocal.h DevicesFactoryHalLocal.h EffectHalHidl.h EffectsFactoryHalLocal.h StreamHalLocal.h
ConversionHelperHidl.cpp DevicesFactoryHalHidl.cpp EffectBufferHalHidl.cpp EffectHalLocal.cpp HalDeathHandlerHidl.cpp
ConversionHelperHidl.h DevicesFactoryHalHidl.h EffectBufferHalHidl.h EffectHalLocal.h include
DeviceHalHidl.cpp DevicesFactoryHalHybrid.cpp EffectBufferHalLocal.cpp EffectsFactoryHalHidl.cpp StreamHalHidl.cpp
DeviceHalHidl.h DevicesFactoryHalHybrid.h EffectBufferHalLocal.h EffectsFactoryHalHidl.h StreamHalHidl.h
DeviceHalLocal.cpp DevicesFactoryHalLocal.cpp EffectHalHidl.cpp EffectsFactoryHalLocal.cpp StreamHalLocal.cpp
从文件名命名方式来看,一类是以Hidl结尾,一类是Local结尾,Local结尾的应该是兼容之前的方式,即谷歌在文档里描述的:
HIDL 旨在用于进程间通信 (IPC)。进程之间的通信经过 Binder 化。对于必须与进程相关联的代码库,还可以使用直通模式(在 Java 中不受支持):
要将运行早期版本的 Android 的设备更新为使用 Android O,您可以将惯用的(和旧版)HAL 封装在一个新 HIDL 接口中,该接口将在绑定式模式和同进程(直通)模式提供 HAL。这种封装对于 HAL 和 Android 框架来说都是透明的。直通模式仅适用于 C++ 客户端和实现。运行早期版本的 Android 的设备没有用 Java 编写的 HAL,因此 Java HAL 自然而然经过 Binder 化。
直通式标头文件:
编译 .hal
文件时,除了用于 Binder 通信的标头之外,hidl-gen
还会生成一个额外的直通标头文件 BsFoo.h
;此标头定义了会被执行 dlopen
操作的函数。由于直通式 HAL 在它们被调用的同一进程中运行,因此在大多数情况下,直通方法由直接函数调用(同一线程)来调用。oneway
方法在各自的线程中运行,因为它们不需要等待 HAL 来处理它们(这意味着,在直通模式下使用 oneway
方法的所有 HAL 对于线程必须是安全的)。
如果有一个 IFoo.hal
,BsFoo.h
会封装 HIDL 生成的方法,以提供额外的功能(例如使 oneway
事务在其他线程中运行)。该文件类似于 BpFoo.h
,不过,所需函数是直接调用的,并未使用 Binder 传递调用 IPC。未来,HAL 的实现可能提供多种实现结果,例如 FooFast HAL 和 FooAccurate HAL。在这种情况下,系统会针对每个额外的实现结果创建一个文件(例如 PTFooFast.cpp
和 PTFooAccurate.cpp
)。
2、Audio Record 调用分析:
(1) Java层调用Android的SDK中的API实例化一个AudioRecord对象
-》 \android-8.0.0_r4\frameworks\av\media\libaudioclient\AudioRecord.cpp -》 AudioRecord::AudioRecord
(2) 设置相应参数
-》 mStatus = set(inputSource, sampleRate, format, channelMask, frameCount, cbf, user,
notificationFrames, false /*threadCanCallJava*/, sessionId, transferType, flags,
uid, pid, pAttributes);
(3)打开录音接口
-》 // create the IAudioRecord
status_t status = openRecord_l(0 /*epoch*/, mOpPackageName);
(4) 获取输入设备属性:
status = AudioSystem::getInputForAttr(&mAttributes, &input,
mSessionId,
// FIXME compare to AudioTrack
mClientPid,
mClientUid,
&config,
mFlags, mSelectedDeviceId, &mPortId);
其中是通过获取audio_policy_service建立binder接口:
// establish binder interface to AudioPolicy service
const sp<IAudioPolicyService> AudioSystem::get_audio_policy_service()
(5) 调用AudioPolicyManager的接口 : \android-8.0.0_r4\frameworks\av\services\audiopolicy\managerdefault\AudioPolicyManager.cpp
aps->getInputForAttr -》 AudioPolicyManager::getInputForAttr
(6) 根据app传下的参数获取对应的设备类型:
device = getDeviceAndMixForInputSource(inputSource, &policyMix);
-》Engine::getDeviceForInputSource (\android-8.0.0_r4\frameworks\av\services\audiopolicy\enginedefault\src\Engine.cpp)
一般录音软件是:AUDIO_SOURCE_MIC ,google 语音引擎是:AUDIO_SOURCE_VOICE_RECOGNITION
再根据当前系统支持的输入设备返回对应的录音设备:(默认的内置mic就是 AUDIO_DEVICE_IN_BUILTIN_MIC)
if (mForceUse[AUDIO_POLICY_FORCE_FOR_RECORD] == AUDIO_POLICY_FORCE_BT_SCO &&
availableDeviceTypes & AUDIO_DEVICE_IN_BLUETOOTH_SCO_HEADSET) {
device = AUDIO_DEVICE_IN_BLUETOOTH_SCO_HEADSET;
} else if (availableDeviceTypes & AUDIO_DEVICE_IN_WIRED_HEADSET) {
device = AUDIO_DEVICE_IN_WIRED_HEADSET;
} else if (availableDeviceTypes & AUDIO_DEVICE_IN_USB_HEADSET) {
device = AUDIO_DEVICE_IN_USB_HEADSET;
} else if (availableDeviceTypes & AUDIO_DEVICE_IN_USB_DEVICE) {
device = AUDIO_DEVICE_IN_USB_DEVICE;
} else if (availableDeviceTypes & AUDIO_DEVICE_IN_BUILTIN_MIC) {
device = AUDIO_DEVICE_IN_BUILTIN_MIC;
}
PS:通过 dumpsys media.audio_policy 指令查看当前系统所支持的设备模块及类型。
可通过\android-8.0.0_r4\frameworks\av\services\audiopolicy目录里面 audio_policy.conf或者audio_policy_configuration.xml配置设备加载,
使用.conf还是.xml取决于frameworks/av/services/audiopolicy/Android.mk 通过宏USE_XML_AUDIO_POLICY_CONF - 1 : 使用 .xml , 0: 使用 .conf。
(7) 根据返回的device类型获取对应录音设备:
*input = getInputForDevice(device, address, session, uid, inputSource,
config->sample_rate, config->format, config->channel_mask, flags,
policyMix);
(8) 调用getInputProfile函数根据传进来的声音采样率、声音格式、通道掩码等参数与获得的设备支持的Input Profile比较返回一个与设备Profile匹配的IOProfile-》
profile = getInputProfile(device, address,
profileSamplingRate, profileFormat, profileChannelMask,
profileFlags);
(9) 根据返回的profile调用初始化时加载好的client接口:
status_t status = mpClientInterface->openInput(profile->getModuleHandle(),
&input,
&config,
&device,
address,
halInputSource,
profileFlags);
PS: mpClientInterface是由AudioPolicyService中加载对应模块传递过来:
void AudioPolicyService::onFirstRef()
{
{
Mutex::Autolock _l(mLock);
// start tone playback thread
mTonePlaybackThread = new AudioCommandThread(String8("ApmTone"), this);
// start audio commands thread
mAudioCommandThread = new AudioCommandThread(String8("ApmAudio"), this);
// start output activity command thread
mOutputCommandThread = new AudioCommandThread(String8("ApmOutput"), this);
mAudioPolicyClient = new AudioPolicyClient(this);
mAudioPolicyManager = createAudioPolicyManager(mAudioPolicyClient); //对应的模块加载放在AudioPolicyManager的构造函数中
}
// load audio processing modules
sp<AudioPolicyEffects>audioPolicyEffects = new AudioPolicyEffects();
{
Mutex::Autolock _l(mLock);
mAudioPolicyEffects = audioPolicyEffects;
}
}
AudioPolicyManager构造函数中根据宏定义判断通过audio_policy.conf还是audio_policy_configuration.xml解析加载对应的so:
#ifdef USE_XML_AUDIO_POLICY_CONF
mVolumeCurves = new VolumeCurvesCollection();
AudioPolicyConfig config(mHwModules, mAvailableOutputDevices, mAvailableInputDevices,
mDefaultOutputDevice, speakerDrcEnabled,
static_cast<VolumeCurvesCollection *>(mVolumeCurves));
if (deserializeAudioPolicyXmlConfig(config) != NO_ERROR) {
#else
mVolumeCurves = new StreamDescriptorCollection();
AudioPolicyConfig config(mHwModules, mAvailableOutputDevices, mAvailableInputDevices,
mDefaultOutputDevice, speakerDrcEnabled);
if ((ConfigParsingUtils::loadConfig(AUDIO_POLICY_VENDOR_CONFIG_FILE, config) != NO_ERROR) &&
(ConfigParsingUtils::loadConfig(AUDIO_POLICY_CONFIG_FILE, config) != NO_ERROR)) {
#endif
加载模块:
mHwModules[i]->mHandle = mpClientInterface->loadHwModule(mHwModules[i]->getName());
if (mHwModules[i]->mHandle == 0) {
ALOGW("could not open HW module %s", mHwModules[i]->getName());
continue;
}
具体加载过程:
AudioFlinger::loadHwModule_l
-》mDevicesFactoryHal->openDevice(name, &dev);
-》DevicesFactoryHalHidl::openDevice(const char *name, sp<DeviceHalInterface> *device)
-》DevicesFactory::openDevice(IDevicesFactory::Device device, openDevice_cb _hidl_cb) //对应hardware/interfaces/audio/2.0/
目录下IDevicesFactory.hal所描述接口
-》loadAudioInterface(moduleName, &halDevice);
-》DevicesFactory::loadAudioInterface(const char *if_name, audio_hw_device_t **dev)
//加载so,后面最终通过dlopen加载了/system/lib/hw/下对应的so。
rc = hw_get_module_by_class(AUDIO_HARDWARE_MODULE_ID, if_name, &mod); if (rc) { ALOGE("%s couldn't load audio hw module %s.%s (%s)", __func__, AUDIO_HARDWARE_MODULE_ID, if_name, strerror(-rc)); goto out; }
//实际调用到了audio_hw.c中adev_open(),只会被调用一次,也就是给硬件模块中的函数指针赋值open()。 rc = audio_hw_device_open(mod, dev); if (rc) { ALOGE("%s couldn't open audio hw device in %s.%s (%s)", __func__, AUDIO_HARDWARE_MODULE_ID, if_name, strerror(-rc)); goto out; } if ((*dev)->common.version < AUDIO_DEVICE_API_VERSION_MIN) { ALOGE("%s wrong audio hw device version %04x", __func__, (*dev)->common.version); rc = -EINVAL; audio_hw_device_close(*dev); goto out; }
(10) 再回到AudioPolicyManager::getInputForDevice 中的 mpClientInterface->openInput调用流程:
AudioFlinger::openInput -》
AudioFlinger::openInput_l -》
sp<DeviceHalInterface> inHwHal = inHwDev->hwDevice();
...
inHwHal->openInputStream -》
DeviceHalHidl::openInputStream
Return<void> ret = mDevice->openInputStream(
handle,
hidlDevice,
hidlConfig,
AudioInputFlag(flags),
AudioSource(source),
[&](Result r, const sp<IStreamIn>& result, const AudioConfig& suggestedConfig) {
retval = r;
if (retval == Result::OK) {
*inStream = new StreamInHalHidl(result); //audio_hw.c中adev_open_input_stream的参数stream_in在这里创建并传入
}
HidlUtils::audioConfigToHal(suggestedConfig, config);
});
return processReturn("openInputStream", ret, retval);
-》最终调用到了audio_hw.c中的:
static int adev_open_input_stream(struct audio_hw_device *dev,
audio_io_handle_t handle,
audio_devices_t devices,
struct audio_config *config,
struct audio_stream_in **stream_in,
audio_input_flags_t flags,
const char *address __unused,
audio_source_t source )
adev_open_input_stream中对sp<StreamInHalInterface> *inStream指针的各成员进行赋值,进一步调用底层的接口获取音频数据。
PS:默认使用上层传下来的config参数,也可以手动更新stream_in的参数,比如 采样率:stream_in->config.rate,自己实现数据获取接口:stream_in->stream.read = my_read 等;
-end-
posted on 2018-03-27 10:54 sheldon_blogs 阅读(9096) 评论(0) 编辑 收藏 举报