当前位置：首页 > news >正文

高通Camera驱动（4）-- 从configure_streams到Usecase的创建与匹配

news 2026/4/18 17:41:18

1. configure_streams到Usecase的转换机制

当Android框架调用configure_streams接口后，高通Camera HAL会经历从流配置到具体场景(Usecase)创建的复杂决策过程。这个过程就像餐厅的点餐系统：顾客（框架）提交订单（stream configuration），厨房（HAL）需要根据订单内容选择对应的烹饪方案（Usecase）。

在代码层面，HALDevice::ConfigureStreams()会先销毁之前的会话（如果存在），然后通过CHIModuleInitialize()触发以下关键操作：

// 资源消耗评估示例代码 m_pResourcesUsedLock->Lock(); if (m_totalResourceBudget > CostOfAnyCurrentlyOpenLogicalCameras()) { UINT32 myLogicalCamCost = CostOfLogicalCamera(logicalCameraId, pStreamConfig); if (myLogicalCamCost > (m_totalResourceBudget - CostOfAnyCurrentlyOpenLogicalCameras())) { CHX_LOG_ERROR("Insufficient HW resources!"); result = CamxResultEResource; } } m_pResourcesUsedLock->Unlock();

这个阶段会进行三项核心检查：

流类型分析：检测是否存在视频编码流(GrallocUsageHwVideoEncoder)
帧率计算：根据operation_mode确定目标FPS
硬件资源评估：计算当前配置所需的ISP、内存等资源消耗

2. UsecaseSelector的决策逻辑

UsecaseSelector就像个智能路由表，通过分析流配置的多个维度参数来匹配最佳场景。其决策路径主要考虑以下因素：

2.1 多摄场景判断

当检测到物理摄像头数量大于1时：

if ((NULL != pCamInfo) && (pCamInfo->numPhysicalCameras > 1)) { if (VRDCEnable) { usecaseId = UsecaseId::MultiCameraVR; // 虚拟现实双摄 } else { usecaseId = UsecaseId::MultiCamera; // 普通多摄 } }

2.2 特殊模式识别

通过operation_mode判断特殊场景：

| 模式标志位 | 对应Usecase | |----------------------------|----------------------| | StreamConfigModeVideoHdr | HDR视频模式 | | StreamConfigModeQTITorch | 闪光灯模式 | | StreamConfigModeFastShutter | 极速抓拍模式 |

2.3 流数量与类型组合

不同流组合会触发不同策略：

2个流：可能为ZSL（预览+拍照）或Raw+JPEG
3个流：常见于视频+预览+拍照场景
4个流：可能涉及YUV回调+Blob输出

3. 典型Usecase创建流程

以最常见的ZSL（Zero Shutter Lag）场景为例，其创建过程包含以下关键步骤：

3.1 Usecase对象实例化

通过工厂模式创建具体Usecase：

pUsecase = AdvancedCameraUsecase::Create(pLogicalCameraInfo, pStreamConfig, usecaseId);

3.2 特征配置(FeatureSetup)

加载XML中预定义的特性配置：

pAdvancedUsecase = GetXMLUsecaseByName("UsecaseZSL"); if (NULL == pAdvancedUsecase) { CHX_LOG_ERROR("Fail to get ZSL usecase from XML!"); }

3.3 管道(Pipeline)构建

每个Usecase包含多个处理管道，例如ZSL场景典型包含：

ZSLPreviewRaw：实时预览管道
ZSLSnapshotYUV：YUV数据处理管道
InternalZSLYuv2Jpeg：JPEG编码管道

管道创建时会绑定具体的硬件单元：

result = CreatePipeline(m_pPipelineToCamera[i], &m_pChiUsecase->pPipelineTargetCreateDesc[i], &m_sessions[sessionId].pipelines[pipelineId], pStreamConfig);

4. 资源管理与优化策略

4.1 批处理帧数计算

对于高帧率(HFR)场景：

if ((StreamConfigModeConstrainedHighSpeed == pStreamConfig->operation_mode) || (StreamConfigModeSuperSlowMotionFRC == pStreamConfig->operation_mode)) { SearchNumBatchedFrames(logicalCameraId, pStreamConfig, &m_usecaseNumBatchedFrames, &m_usecaseMaxFPS, maxSessionFps); }

4.2 功耗模式选择

根据帧率动态调整功耗策略：

if (480 > m_usecaseMaxFPS) { m_CurrentpowerHint = PERF_LOCK_POWER_HINT_VIDEO_ENCODE_HFR; } else { m_CurrentpowerHint = PERF_LOCK_POWER_HINT_VIDEO_ENCODE_HFR_480FPS; }

4.3 元数据管理

每个管道会注册独立的metadata client：

m_metadataClients[index] = m_pMetadataManager->RegisterClient( pPipeline->IsRealTime(), pPipeline->GetTagList(), pPipeline->GetTagCount(), pPipeline->GetPartialTagCount(), pPipeline->GetMetadataBufferCount() + BufferQueueDepth, ChiMetadataUsage::RealtimeOutput);

5. 调试与问题排查

5.1 关键日志分析

在logcat中关注以下标签：

CamX: 核心HAL层日志
CHIUSECASE: Usecase选择过程
CHXMETADATA: 元数据操作记录

典型错误场景：

E CHIUSECASE: [CONFIG] chxusecaseutils.cpp:613 GetMatchingUsecase() No matching usecase for stream config! E CamX: [ERROR] camxpipeline.cpp:1356 CreateNodes() Failed to link BPS to IPE nodes