组件关系
整体流程：
c
camxhal3.cpp:704 open()
camxhal3.cpp:1423 configure_streams()
chxextensionmodule.cpp:2810 InitializeOverrideSession
chxusecaseutils.cpp:850 GetMatchingUsecase()
chxadvancedcamerausecase.cpp:4729 Initialize()
chxadvancedcamerausecase.cpp:5757 SelectFeatures()
usecase ID匹配逻辑
GetMatchingUsecase 函数根据输入的相机信息（pCamInfo）和流配置（pStreamConfig）返回最适合的用例ID（UsecaseId）。
-- UsecaseSelector::GetMatchingUsecase
代码逻辑总结
- 优先级最高的用例：
QuadCFA用例（特定传感器和流配置）
超级慢动作模式 - 多摄像头用例：
如果启用VR模式，选择MultiCameraVR
否则选择MultiCamera - 单摄像头用例：
根据流数量(2/3/4)选择不同的用例
考虑多种功能标志：ZSL、GPU处理、MFNR、EIS等 - 特殊用例：
最后检查是否为手电筒小部件用例 - 默认用例：
如果没有匹配其他条件，使用Default用例
关键判断条件
流数量(num_streams)
摄像头类型和数量
各种功能模块的启用状态(通过ExtensionModule获取)
特定的流配置检查(通过IsXXXStreamConfig函数)
c
UsecaseId UsecaseSelector::GetMatchingUsecase(
const LogicalCameraInfo* pCamInfo, // 摄像头逻辑信息
camera3_stream_configuration_t* pStreamConfig) // 流配置信息
{
UsecaseId usecaseId = UsecaseId::Default; // 默认用例
UINT32 VRDCEnable = ExtensionModule::GetInstance()->GetDCVRMode(); // 获取VR模式设置
// 检查是否为QuadCFA传感器且符合特定条件
if ((pStreamConfig->num_streams == 2) && IsQuadCFASensor(pCamInfo, NULL) &&
(LogicalCameraType_Default == pCamInfo->logicalCameraType))
{
// 如果快照尺寸小于传感器binning尺寸，选择默认ZSL用例
// 只有当快照尺寸大于传感器binning尺寸时，才选择QuadCFA用例
if (TRUE == QuadCFAMatchingUsecase(pCamInfo, pStreamConfig))
{
usecaseId = UsecaseId::QuadCFA;
CHX_LOG_CONFIG("Quad CFA usecase selected");
return usecaseId;
}
}
// 检查是否为超级慢动作模式
if (pStreamConfig->operation_mode == StreamConfigModeSuperSlowMotionFRC)
{
usecaseId = UsecaseId::SuperSlowMotionFRC;
CHX_LOG_CONFIG("SuperSlowMotionFRC usecase selected");
return usecaseId;
}
// 重置用例标志
VideoEISV2Usecase = 0;
VideoEISV3Usecase = 0;
GPURotationUsecase = FALSE;
GPUDownscaleUsecase = FALSE;
// 多摄像头VR用例判断
if ((NULL != pCamInfo) && (pCamInfo->numPhysicalCameras > 1) && VRDCEnable)
{
CHX_LOG_CONFIG("MultiCameraVR usecase selected");
usecaseId = UsecaseId::MultiCameraVR;
}
// 多摄像头用例判断
else if ((NULL != pCamInfo) && (pCamInfo->numPhysicalCameras > 1) && (pStreamConfig->num_streams > 1))
{
CHX_LOG_CONFIG("MultiCamera usecase selected");
usecaseId = UsecaseId::MultiCamera;
}
else
{
SnapshotStreamConfig snapshotStreamConfig;
CHISTREAM** ppChiStreams = reinterpret_cast<CHISTREAM**>(pStreamConfig->streams);
// 根据流数量选择用例
switch (pStreamConfig->num_streams)
{
case 2: // 2个流的情况
if (TRUE == IsRawJPEGStreamConfig(pStreamConfig))
{
CHX_LOG_CONFIG("Raw + JPEG usecase selected");
usecaseId = UsecaseId::RawJPEG;
break;
}
// 检查是否启用ZSL
if (FALSE == m_pExtModule->DisableZSL())
{
if (TRUE == IsPreviewZSLStreamConfig(pStreamConfig))
{
usecaseId = UsecaseId::PreviewZSL;
CHX_LOG_CONFIG("ZSL usecase selected");
}
}
// 检查是否启用GPU旋转
if(TRUE == m_pExtModule->UseGPURotationUsecase())
{
CHX_LOG_CONFIG("GPU Rotation usecase flag set");
GPURotationUsecase = TRUE;
}
// 检查是否启用GPU下采样
if (TRUE == m_pExtModule->UseGPUDownscaleUsecase())
{
CHX_LOG_CONFIG("GPU Downscale usecase flag set");
GPUDownscaleUsecase = TRUE;
}
// 检查是否启用MFNR(多帧降噪)
if (TRUE == m_pExtModule->EnableMFNRUsecase())
{
if (TRUE == MFNRMatchingUsecase(pStreamConfig))
{
usecaseId = UsecaseId::MFNR;
CHX_LOG_CONFIG("MFNR usecase selected");
}
}
// 检查是否启用无3A的HFR(高帧率)
if (TRUE == m_pExtModule->EnableHFRNo3AUsecas())
{
CHX_LOG_CONFIG("HFR without 3A usecase flag set");
HFRNo3AUsecase = TRUE;
}
break;
case 3: // 3个流的情况
// 设置EIS(电子图像稳定)标志
VideoEISV2Usecase = m_pExtModule->EnableEISV2Usecase();
VideoEISV3Usecase = m_pExtModule->EnableEISV3Usecase();
// 检查ZSL预览
if (FALSE == m_pExtModule->DisableZSL() && (TRUE == IsPreviewZSLStreamConfig(pStreamConfig)))
{
usecaseId = UsecaseId::PreviewZSL;
CHX_LOG_CONFIG("ZSL usecase selected");
}
// 检查Raw+JPEG配置
else if(TRUE == IsRawJPEGStreamConfig(pStreamConfig) && FALSE == m_pExtModule->DisableZSL())
{
CHX_LOG_CONFIG("Raw + JPEG usecase selected");
usecaseId = UsecaseId::RawJPEG;
}
// 检查视频实时拍摄配置
else if((FALSE == IsVideoEISV2Enabled(pStreamConfig)) && (FALSE == IsVideoEISV3Enabled(pStreamConfig)) &&
(TRUE == IsVideoLiveShotConfig(pStreamConfig)) && (FALSE == m_pExtModule->DisableZSL()))
{
CHX_LOG_CONFIG("Video With Liveshot, ZSL usecase selected");
usecaseId = UsecaseId::VideoLiveShot;
}
// 处理BPS摄像头和EIS设置
if ((NULL != pCamInfo) && (RealtimeEngineType_BPS == pCamInfo->ppDeviceInfo[0]->pDeviceConfig->realtimeEngine))
{
if((TRUE == IsVideoEISV2Enabled(pStreamConfig)) || (TRUE == IsVideoEISV3Enabled(pStreamConfig)))
{
CHX_LOG_CONFIG("BPS Camera EIS V2 = %d, EIS V3 = %d",
IsVideoEISV2Enabled(pStreamConfig),
IsVideoEISV3Enabled(pStreamConfig));
// 对于BPS摄像头且至少启用一个EIS的情况
// 设置(伪)用例将引导到feature2选择器
usecaseId = UsecaseId::PreviewZSL;
}
}
break;
case 4: // 4个流的情况
GetSnapshotStreamConfiguration(pStreamConfig->num_streams, ppChiStreams, snapshotStreamConfig);
// 检查HEIC格式和Raw流
if ((SnapshotStreamType::HEIC == snapshotStreamConfig.type) && (NULL != snapshotStreamConfig.pRawStream))
{
CHX_LOG_CONFIG("Raw + HEIC usecase selected");
usecaseId = UsecaseId::RawJPEG;
}
break;
default: // 其他情况
CHX_LOG_CONFIG("Default usecase selected");
break;
}
}
// 检查是否为手电筒小部件用例
if (TRUE == ExtensionModule::GetInstance()->IsTorchWidgetUsecase())
{
CHX_LOG_CONFIG("Torch widget usecase selected");
usecaseId = UsecaseId::Torch;
}
CHX_LOG_INFO("usecase ID:%d",usecaseId);
return usecaseId;
}
c
/// @brief Usecase identifying enums
enum class UsecaseId
{
NoMatch = 0,
Default = 1,
Preview = 2,
PreviewZSL = 3,
MFNR = 4,
MFSR = 5,
MultiCamera = 6,
QuadCFA = 7,
RawJPEG = 8,
MultiCameraVR = 9,
Torch = 10,
YUVInBlobOut = 11,
VideoLiveShot = 12,
SuperSlowMotionFRC = 13,
MaxUsecases = 14,
};Feature 匹配
feature的定义
/// @brief Advance feature types
enum AdvanceFeatureType
{
AdvanceFeatureNone = 0x0, ///< mask for none features
AdvanceFeatureZSL = 0x1, ///< mask for feature ZSL
AdvanceFeatureMFNR = 0x2, ///< mask for feature MFNR
AdvanceFeatureHDR = 0x4, ///< mask for feature HDR(AE_Bracket)
AdvanceFeatureSWMF = 0x8, ///< mask for feature SWMF
AdvanceFeatureMFSR = 0x10, ///< mask for feature MFSR
AdvanceFeatureQCFA = 0x20, ///< mask for feature QuadCFA
AdvanceFeature2Wrapper = 0x40, ///< mask for feature2 wrapper
AdvanceFeatureCountMax = AdvanceFeature2Wrapper ///< Max of advance feature mask
};
c
CDKResult AdvancedCameraUsecase::FeatureSetup(
camera3_stream_configuration_t* pStreamConfig)
{
CDKResult result = CDKResultSuccess;
if ((UsecaseId::PreviewZSL == m_usecaseId) ||
(UsecaseId::YUVInBlobOut == m_usecaseId) ||
(UsecaseId::VideoLiveShot == m_usecaseId) ||
(UsecaseId::QuadCFA == m_usecaseId) ||
(UsecaseId::RawJPEG == m_usecaseId))
{
SelectFeatures(pStreamConfig);
}
else if (UsecaseId::MultiCamera == m_usecaseId)
{
SelectFeatures(pStreamConfig);
}
return result;
}
// START of OEM to change section
VOID AdvancedCameraUsecase::SelectFeatures(camera3_stream_configuration_t* pStreamConfig)
{
// OEM to change
// 这个函数根据当前的pStreamConfig和静态设置决定要运行哪些特性
INT32 index = 0;
UINT32 enabledAdvanceFeatures = 0;
// 从ExtensionModule获取已启用的高级特性掩码
enabledAdvanceFeatures = ExtensionModule::GetInstance()->GetAdvanceFeatureMask();
CHX_LOG("SelectFeatures(), enabled feature mask:%x", enabledAdvanceFeatures);
// 如果当前是FastShutter模式，则强制启用SWMF和MFNR特性
if (StreamConfigModeFastShutter == ExtensionModule::GetInstance()->GetOpMode(m_cameraId))
{
enabledAdvanceFeatures = AdvanceFeatureSWMF|AdvanceFeatureMFNR;
}
CHX_LOG("SelectFeatures(), enabled feature mask:%x", enabledAdvanceFeatures);
// 遍历所有物理摄像头设备
for (UINT32 physicalCameraIndex = 0 ; physicalCameraIndex < m_numOfPhysicalDevices ; physicalCameraIndex++)
{
index = 0;
// 检查当前用例是否属于以下类型之一
if ((UsecaseId::PreviewZSL == m_usecaseId) ||
(UsecaseId::MultiCamera == m_usecaseId) ||
(UsecaseId::QuadCFA == m_usecaseId) ||
(UsecaseId::VideoLiveShot == m_usecaseId) ||
(UsecaseId::RawJPEG == m_usecaseId))
{
// 如果启用了MFNR(多帧降噪)特性
if (AdvanceFeatureMFNR == (enabledAdvanceFeatures & AdvanceFeatureMFNR))
{
// 启用离线噪声重处理
m_isOfflineNoiseReprocessEnabled = ExtensionModule::GetInstance()->EnableOfflineNoiseReprocessing();
// 需要FD(人脸检测)流缓冲区
m_isFDstreamBuffersNeeded = TRUE;
}
// 如果启用了SWMF(软件多帧)、HDR或2Wrapper特性
if ((AdvanceFeatureSWMF == (enabledAdvanceFeatures & AdvanceFeatureSWMF)) ||
(AdvanceFeatureHDR == (enabledAdvanceFeatures & AdvanceFeatureHDR)) ||
((AdvanceFeature2Wrapper == (enabledAdvanceFeatures & AdvanceFeature2Wrapper))))
{
// 创建Feature2Wrapper的输入信息结构
Feature2WrapperCreateInputInfo feature2WrapperCreateInputInfo;
feature2WrapperCreateInputInfo.pUsecaseBase = this;
feature2WrapperCreateInputInfo.pMetadataManager = m_pMetadataManager;
feature2WrapperCreateInputInfo.pFrameworkStreamConfig =
reinterpret_cast<ChiStreamConfigInfo*>(pStreamConfig);
// 清除所有流的pHalStream指针
for (UINT32 i = 0; i < feature2WrapperCreateInputInfo.pFrameworkStreamConfig->numStreams; i++)
{
feature2WrapperCreateInputInfo.pFrameworkStreamConfig->pChiStreams[i]->pHalStream = NULL;
}
// 如果Feature2Wrapper尚未创建
if (NULL == m_pFeature2Wrapper)
{
// 如果是多摄像头用例
if (TRUE == IsMultiCameraUsecase())
{
// 如果流配置中不包含融合流，则设置输入输出类型为YUV_OUT
if (FALSE == IsFusionStreamIncluded(pStreamConfig))
{
feature2WrapperCreateInputInfo.inputOutputType =
static_cast<UINT32>(InputOutputType::YUV_OUT);
}
// 添加内部输入流(RDI和FD流)
for (UINT8 streamIndex = 0; streamIndex < m_numOfPhysicalDevices; streamIndex++)
{
feature2WrapperCreateInputInfo.internalInputStreams.push_back(m_pRdiStream[streamIndex]);
feature2WrapperCreateInputInfo.internalInputStreams.push_back(m_pFdStream[streamIndex]);
}
// 需要FD流缓冲区
m_isFDstreamBuffersNeeded = TRUE;
}
// 创建Feature2Wrapper实例
m_pFeature2Wrapper = Feature2Wrapper::Create(&feature2WrapperCreateInputInfo, physicalCameraIndex);
}
// 将创建的Feature2Wrapper添加到启用特性列表中
m_enabledFeatures[physicalCameraIndex][index] = m_pFeature2Wrapper;
index++;
}
}
// 记录当前物理摄像头启用的特性数量
m_enabledFeaturesCount[physicalCameraIndex] = index;
}
// 如果第一个物理摄像头有启用的特性
if (m_enabledFeaturesCount[0] > 0)
{
// 如果还没有活动的特性，则设置为第一个启用的特性
if (NULL == m_pActiveFeature)
{
m_pActiveFeature = m_enabledFeatures[0][0];
}
// 记录日志：选择的特性数量和预览的特性类型
CHX_LOG_INFO("num features selected:%d, FeatureType for preview:%d",
m_enabledFeaturesCount[0], m_pActiveFeature->GetFeatureType());
}
else
{
CHX_LOG_INFO("No features selected");
}
// 将最后一个快照特性设置为当前活动特性
m_pLastSnapshotFeature = m_pActiveFeature;
}Usecase 匹配逻辑
- 如果是PreviewZSL、MultiCamera、QuadCFA等模式，直接ConfigureStream和BuildUsecase
- 其他模式-通过DefaultMatchingUsecase重新匹配
c
CDKResult AdvancedCameraUsecase::SelectUsecaseConfig(
LogicalCameraInfo* pCameraInfo, ///< Camera info
camera3_stream_configuration_t* pStreamConfig) ///< Stream configuration
{
if ((UsecaseId::PreviewZSL == m_usecaseId) ||
(UsecaseId::YUVInBlobOut == m_usecaseId) ||
(UsecaseId::VideoLiveShot == m_usecaseId) ||
(UsecaseId::MultiCamera == m_usecaseId) ||
(UsecaseId::QuadCFA == m_usecaseId) ||
(UsecaseId::RawJPEG == m_usecaseId))
{
ConfigureStream(pCameraInfo, pStreamConfig);
BuildUsecase(pCameraInfo, pStreamConfig);
}
else
{
CHX_LOG("Initializing using default usecase matching");
m_pChiUsecase = UsecaseSelector::DefaultMatchingUsecase(pStreamConfig);
}
}PreviewZSL 模式下
ZSL模式下，pAdvancedUsecase 赋值为UsecaseZSL，
BuildUsecase函数调用CloneUsecase来根据配置选择克隆ZSL调优用例或高级用例，
一般走pAdvancedUsecase
c
AdvancedCameraUsecase::Initialize {}
//这里 ZSL_USECASE_NAME = "UsecaseZSL"
pAdvancedUsecase = GetXMLUsecaseByName(ZSL_USECASE_NAME);
}- BuildUsecase
-
根据feature添加pipeline
-
根据feature克隆并配置用例模板
-
设置管道与会话、相机的映射关系(Map camera ID and session ID for the pipeline and prepare for pipeline/session creation)
-
为feature覆盖流配置
-
c
AdvancedCameraUsecase::BuildUsecase（）{
// 根据配置选择克隆ZSL调优用例或高级用例
if (static_cast<UINT>(UsecaseZSLTuningId) == ExtensionModule::GetInstance()->OverrideUseCase())
{
m_pClonedUsecase = UsecaseSelector::CloneUsecase(pZslTuningUsecase, totalPipelineCount, pipelineIDMap);
}
else
{
m_pClonedUsecase = UsecaseSelector::CloneUsecase(pAdvancedUsecase, totalPipelineCount, pipelineIDMap);
}
}default模式下
调用流程
c
m_pChiUsecase = UsecaseSelector::DefaultMatchingUsecase(pStreamConfig);
--ChiUsecase* GetDefaultMatchingUsecase(camera3_stream_configuration_t* pStreamConfig)
---UsecaseSelector::DefaultMatchingUsecaseSelection(pStreamConfig)
----IsMatchingUsecase(pStreamConfig, pUsecase, &pruneSettings);- DefaultMatchingUsecaseSelection
- 优先匹配Selected EISv3 usecase
- 其次匹配 Selected EISv2 usecase
- 根据pStreamConfig->num_streams匹配
c
extern "C" CAMX_VISIBILITY_PUBLIC ChiUsecase* UsecaseSelector::DefaultMatchingUsecaseSelection(
camera3_stream_configuration_t* pStreamConfig)
{
auto UsecaseMatches = [&pStreamConfig, &pruneSettings](const ChiUsecase* const pUsecase) -> BOOL
{
return IsMatchingUsecase(pStreamConfig, pUsecase, &pruneSettings);
};
if (pStreamConfig->num_streams <= ChiMaxNumTargets)
{
else if (NULL == pSelectedUsecase)
{ //匹配EIS V3算法Usecase
if (TRUE == IsVideoEISV3Enabled(pStreamConfig))
{
···
if (TRUE == UsecaseMatches(&Usecases3Target[usecaseEIS3Id]))
{
CHX_LOG("Selected EISv3 usecase");
pSelectedUsecase = &Usecases3Target[usecaseEIS3Id];
}
}
//匹配EIS V2算法Usecase
if ((TRUE == IsVideoEISV2Enabled(pStreamConfig)) && (NULL == pSelectedUsecase) &&
(TRUE == UsecaseMatches(&Usecases3Target[UsecaseVideoEIS2PreviewEIS2Id])))
{
CHX_LOG("Selected EISv2 usecase");
pSelectedUsecase = &Usecases3Target[UsecaseVideoEIS2PreviewEIS2Id];
}
// This if block is only for kamorta usecases where Preview & Video streams are present
if ((pStreamConfig->num_streams > 1) && (NULL == pSelectedUsecase))
{
// If both Preview and Video < 1080p then only Preview < Video and Preview >Video Scenario occurs
if ((numYUVStreams == 2) && (YUV0Height <= TFEMaxHeight && YUV0Width <= TFEMaxWidth) &&
(YUV1Height <= TFEMaxHeight && YUV1Width <= TFEMaxWidth))
{
switch (pStreamConfig->num_streams)
{
case 2:
if (((YUV0Height * YUV0Width) < (YUV1Height * YUV1Width)) &&
(TRUE == UsecaseMatches(&Usecases2Target[UsecaseVideo_PVLT1080p_PLTVId])))
{
pSelectedUsecase = &Usecases2Target[UsecaseVideo_PVLT1080p_PLTVId];
}
else if (TRUE == UsecaseMatches(&Usecases2Target[UsecaseVideo_PVLT1080p_PGTVId]))
{
pSelectedUsecase = &Usecases2Target[UsecaseVideo_PVLT1080p_PGTVId];
}
break;
case 3:
if (TRUE == bJpegStreamExists)
{
// JPEG is taking from RealTime
if (((YUV0Height * YUV0Width) < (YUV1Height * YUV1Width)) &&
(TRUE == UsecaseMatches(
&Usecases5Target[UsecaseJPEGEncodeLiveSnapshot_BothPVLT1080p_PLTVId])))
{
pSelectedUsecase = &
Usecases5Target[UsecaseJPEGEncodeLiveSnapshot_BothPVLT1080p_PLTVId];
}
else if (TRUE == UsecaseMatches(
&Usecases5Target[UsecaseJPEGEncodeLiveSnapshot_BothPVLT1080p_PGTVId]))
{
pSelectedUsecase = &
Usecases5Target[UsecaseJPEGEncodeLiveSnapshot_BothPVLT1080p_PGTVId];
}
}
break;
// For HEIC
case 4:
if (TRUE == bHEICStreamExists)
{
if (((YUV0Height * YUV0Width) < (YUV1Height * YUV1Width)) &&
(TRUE == UsecaseMatches(
&Usecases5Target[UsecaseJPEGEncodeLiveSnapshot_BothPVLT1080p_PLTVId])))
{
pSelectedUsecase = &
Usecases5Target[UsecaseJPEGEncodeLiveSnapshot_BothPVLT1080p_PLTVId];
}
else if (TRUE == UsecaseMatches(
&Usecases5Target[UsecaseJPEGEncodeLiveSnapshot_BothPVLT1080p_PGTVId]))
{
pSelectedUsecase = &
Usecases5Target[UsecaseJPEGEncodeLiveSnapshot_BothPVLT1080p_PGTVId];
}
}
break;
default:
break;
}
}
}
//如果上面匹配都失败了，pStreamConfig->num_streams -1
if (NULL == pSelectedUsecase)
{
if ((StreamConfigModeQTIEISLookAhead == pStreamConfig->operation_mode) ||
(StreamConfigModeQTIEISRealTime == pStreamConfig->operation_mode))
{
// EIS is disabled, ensure that operation_mode is also set accordingly
pStreamConfig->operation_mode = 0;
}
numTargetsExpected = pStreamConfig->num_streams - 1;
}
for (/* Initialized outside*/; numTargetsExpected < ChiMaxNumTargets; numTargetsExpected++)
{
pChiTargetUsecases = &PerNumTargetUsecases[numTargetsExpected];
if (0 == pChiTargetUsecases->numUsecases)
{
continue;
}
CHX_LOG_INFO("Considering %u usecases that have %u targets", pChiTargetUsecases->numUsecases, numTargetsExpected + 1);
for (UINT i = 0; i < pChiTargetUsecases->numUsecases; i++)
{
const ChiUsecase* pChiUsecaseDescriptor = &pChiTargetUsecases->pChiUsecases[i];
CHX_LOG_INFO("pChiUsecaseDescriptor %s ", pChiUsecaseDescriptor->pUsecaseName);
···
if (TRUE == UsecaseMatches(pChiUsecaseDescriptor))
{
}
}最后代码匹配逻辑：
- pStreamConfig->num_streams -1
- 循环从PerNumTargetUsecases去找Usecase
pStreamConfig->num_streams -1，这里-1是因为
比如2路流，pStreamConfig->num_streams -1 = 2-1 =1
PerNumTargetUsecases[1] 对应的是{16, Usecases2Target},
BOOL UsecaseSelector::IsMatchingUsecase
vendor/qcom/proprietary/chi-cdk/core/chiusecase/chxusecaseutils.cpp
主要匹配逻辑如下：
- IsMatchingVideo ：比较是否是视频模式
- IsMatchingFormat： 比较图像格式
- IsMatchingdirection： 比较图像流是输入还是输出
- IsMatchingDimension：比较图片宽高是否符合要求
streamFormat 匹配格式
c
typedef enum ChiStreamFormat
{
ChiStreamFormatYCrCb420_SP = 0x00000113, ///< YCrCb420_SP is mapped to ChiStreamFormatYCbCr420_888 with ZSL flags
ChiStreamFormatRaw16 = 0x00000020, ///< Blob format
ChiStreamFormatBlob = 0x00000021, ///< Carries data which does not have a standard image structure (e.g. JPEG)
ChiStreamFormatImplDefined = 0x00000022, ///< Format is up to the device-specific Gralloc implementation.
ChiStreamFormatYCbCr420_888 = 0x00000023, ///< Efficient YCbCr/YCrCb 4:2:0 buffer layout, layout-independent
ChiStreamFormatRawOpaque = 0x00000024, ///< Raw Opaque
ChiStreamFormatRaw10 = 0x00000025, ///< Raw 10
ChiStreamFormatRaw12 = 0x00000026, ///< Raw 12
ChiStreamFormatRaw64 = 0x00000027, ///< Blob format
ChiStreamFormatUBWCNV124R = 0x00000028, ///< UBWCNV12-4R
ChiStreamFormatNV12HEIF = 0x00000116, ///< HEIF video YUV420 format
ChiStreamFormatNV12YUVFLEX = 0x00000125, ///< Flex NV12 YUV format with 1 batch
ChiStreamFormatNV12UBWCFLEX = 0x00000126, ///< Flex NV12 UBWC format
ChiStreamFormatY8 = 0x20203859, ///< Y 8
ChiStreamFormatY16 = 0x20363159, ///< Y 16
ChiStreamFormatP010 = 0x7FA30C0A, ///< P010
ChiStreamFormatUBWCTP10 = 0x7FA30C09, ///< UBWCTP10
ChiStreamFormatUBWCNV12 = 0x7FA30C06, ///< UBWCNV12
ChiStreamFormatPD10 = 0x7FA30C08, ///< PD10
} BufferFormat匹配格式
c
/// @brief Buffer Format
typedef enum ChiBufferFormat
{
ChiFormatJpeg = 0, ///< JPEG format.
ChiFormatY8 = 1, ///< Luma only, 8 bits per pixel.
ChiFormatY16 = 2, ///< Luma only, 16 bits per pixel.
ChiFormatYUV420NV12 = 3, ///< YUV 420 format as described by the NV12 fourcc.
ChiFormatYUV420NV21 = 4, ///< YUV 420 format as described by the NV21 fourcc.
ChiFormatYUV420NV16 = 5, ///< YUV 422 format as described by the NV16 fourcc
ChiFormatBlob = 6, ///< Any non image data
ChiFormatRawYUV8BIT = 7, ///< Packed YUV/YVU raw format. 16 bpp: 8 bits Y and 8 bits UV.
/// U and V are interleaved as YUYV or YVYV.
ChiFormatRawPrivate = 8, ///< Private RAW formats where data is packed into 64bit word.
/// 8BPP: 64-bit word contains 8 pixels p0-p7, p0 is stored at LSB.
/// 10BPP: 64-bit word contains 6 pixels p0-p5,
/// most significant 4 bits are set to 0. P0 is stored at LSB.
/// 12BPP: 64-bit word contains 5 pixels p0-p4,
/// most significant 4 bits are set to 0. P0 is stored at LSB.
/// 14BPP: 64-bit word contains 4 pixels p0-p3,
/// most significant 8 bits are set to 0. P0 is stored at LSB.
ChiFormatRawMIPI = 9, ///< MIPI RAW formats based on MIPI CSI-2 specification.
/// 8BPP: Each pixel occupies one bytes, starting at LSB.
/// Output width of image has no restrictions.
/// 10BPP: 4 pixels are held in every 5 bytes.
/// The output width of image must be a multiple of 4 pixels.
ChiFormatRawMIPI10 = ChiFormatRawMIPI, ///< By default 10-bit, ChiFormatRawMIPI10
ChiFormatRawPlain16 = 10, ///< Plain16 RAW format. Single pixel is packed into two bytes,
/// little endian format.
/// Not all bits may be used as RAW data is
/// generally 8, or 10 bits per pixel.
/// Lower order bits are filled first.
ChiFormatRawPlain16LSB10bit = ChiFormatRawPlain16, ///< By default 10-bit, ChiFormatRawPlain16LSB10bit
ChiFormatRawMeta8BIT = 11, ///< Generic 8-bit raw meta data for internal camera usage.
ChiFormatUBWCTP10 = 12, ///< UBWC TP10 format (as per UBWC2.0 design specification)
ChiFormatUBWCNV12 = 13, ///< UBWC NV12 format (as per UBWC2.0 design specification)
ChiFormatUBWCNV124R = 14, ///< UBWC NV12-4R format (as per UBWC2.0 design specification)
ChiFormatYUV420NV12TP10 = 15, ///< YUV 420 format 10bits per comp tight packed format.
ChiFormatYUV420NV21TP10 = 16, ///< YUV 420 format 10bits per comp tight packed format.
ChiFormatYUV422NV16TP10 = 17, ///< YUV 422 format 10bits per comp tight packed format.
ChiFormatPD10 = 18, ///< PD10 format
ChiFormatRawMIPI8 = 19, ///< 8BPP: Each pixel occupies one bytes, starting at LSB.
/// Output width of image has no restrictions.
ChiFormatP010 = 22, ///< P010 format.
ChiFormatRawPlain64 = 23, ///< Raw Plain 64
ChiFormatUBWCP010 = 24, ///< UBWC P010 format.
ChiFormatRawDepth = 25, ///< 16 bit depth
ChiFormatRawMIPI12 = 26, ///< 12BPP: 2 pixels are held in every 3 bytes.
/// The output width of image must be a multiple of 2 pixels.
ChiFormatRawPlain16LSB12bit = 27, ///< Plain16 RAW format. 12 bits per pixel.
ChiFormatRawMIPI14 = 28, /// 14BPP: 4 pixels are held in every 7 bytes.
/// The output width of image must be a multiple of 4 pixels.
ChiFormatRawPlain16LSB14bit = 29, ///< Plain16 RAW format. 14 bits per pixel.
} CHIBUFFERFORMAT;基于log解析代码逻辑
源码实现
c
// 函数：判断当前流配置是否匹配指定的用例
// 参数：
// pStreamConfig - 流配置信息
// pUsecase - 用例信息
// pPruneSettings - 修剪设置（用于排除某些目标）
// 返回值：BOOL - TRUE表示匹配，FALSE表示不匹配
BOOL UsecaseSelector::IsMatchingUsecase(
const camera3_stream_configuration_t* pStreamConfig,
const ChiUsecase* pUsecase,
const PruneSettings* pPruneSettings)
{
// 断言检查输入参数不能为空
CHX_ASSERT(NULL != pStreamConfig);
CHX_ASSERT(NULL != pUsecase);
// 初始化变量
UINT numStreams = pStreamConfig->num_streams; // 流数量
BOOL isMatching = FALSE; // 匹配结果标志
UINT streamConfigMode = pUsecase->streamConfigMode; // 用例的流配置模式
BOOL bTargetVideoCheck = FALSE; // 是否需要检查视频目标
BOOL bHasVideoTarget = FALSE; // 用例是否有视频目标
BOOL bHasVideoStream = FALSE; // 流配置中是否有视频流
UINT videoStreamIdx = 0; // 视频流索引
// 初始化比较掩码：
// compareTargetIndexMask - 用于跟踪需要比较的目标（初始设置为所有目标都需要比较）
// compareStreamIndexMask - 用于跟踪需要比较的流（初始设置为所有流都需要比较）
UINT compareTargetIndexMask = ((1 << pUsecase->numTargets) - 1);
UINT compareStreamIndexMask = ((1 << numStreams) - 1);
// 检查流配置中是否有视频流
for (UINT streamIdx = 0; streamIdx < numStreams; streamIdx++)
{
if(IsVideoStream(pStreamConfig->streams[streamIdx]))
{
bHasVideoStream = TRUE;
videoStreamIdx = streamIdx;
break;
}
}
// 检查用例中是否有视频目标
for (UINT targetIdx = 0; targetIdx < pUsecase->numTargets; targetIdx++)
{
ChiTarget* pTargetInfo = pUsecase->ppChiTargets[targetIdx];
if (!CdkUtils::StrCmp(pTargetInfo->pTargetName, "TARGET_BUFFER_VIDEO"))
{
bHasVideoTarget = TRUE;
break;
}
}
// 设置视频目标检查标志（当既有视频流又有视频目标时需要特殊检查）
bTargetVideoCheck = bHasVideoStream && bHasVideoTarget;
// 检查流配置模式是否匹配
if (streamConfigMode == static_cast<UINT>(pStreamConfig->operation_mode))
{
// 遍历用例中的所有目标
for (UINT targetInfoIdx = 0; targetInfoIdx < pUsecase->numTargets; targetInfoIdx++)
{
ChiTarget* pTargetInfo = pUsecase->ppChiTargets[targetInfoIdx];
// 检查是否需要修剪当前目标（根据修剪设置）
if ((NULL != pUsecase->pTargetPruneSettings) &&
(TRUE == ShouldPrune(pPruneSettings, &pUsecase->pTargetPruneSettings[targetInfoIdx])))
{
CHX_LOG_INFO("Ignoring Target Info because of prune settings: "
"format[0]: %u targetType = %d streamWidth = %d streamHeight = %d",
pTargetInfo->pBufferFormats[0],
pTargetInfo->direction,
pTargetInfo->dimension.maxWidth,
pTargetInfo->dimension.maxHeight);
// 从比较掩码中移除当前目标
compareTargetIndexMask = ChxUtils::BitReset(compareTargetIndexMask, targetInfoIdx);
continue; // 跳过被修剪的目标
}
isMatching = FALSE; // 重置匹配标志
// 检查当前目标是否是视频目标
BOOL bIsVideoTarget = !CdkUtils::StrCmp(pTargetInfo->pTargetName, "TARGET_BUFFER_VIDEO");
// 遍历所有流
for (UINT streamId = 0; streamId < numStreams; streamId++)
{
// 如果当前流已经被匹配过，则跳过
if (FALSE == ChxUtils::IsBitSet(compareStreamIndexMask, streamId))
{
continue;
}
ChiStream* pStream = reinterpret_cast<ChiStream*>(pStreamConfig->streams[streamId]);
CHX_ASSERT(pStream != NULL);
if (NULL != pStream)
{
// 获取流属性
INT streamFormat = pStream->format;
UINT streamType = pStream->streamType;
UINT32 streamWidth = pStream->width;
UINT32 streamHeight = pStream->height;
CHX_LOG("streamType = %d streamFormat = %d streamWidth = %d streamHeight = %d",
streamType, streamFormat, streamWidth, streamHeight);
// 检查格式是否匹配
isMatching = IsMatchingFormat(reinterpret_cast<ChiStream*>(pStream),
pTargetInfo->numFormats,
pTargetInfo->pBufferFormats);
// 检查流类型（方向）是否匹配
if (TRUE == isMatching)
{
isMatching = ((streamType == static_cast<UINT>(pTargetInfo->direction)) ? TRUE : FALSE);
}
// 检查分辨率是否在目标范围内
if (TRUE == isMatching)
{
BufferDimension* pRange = &pTargetInfo->dimension;
if ((streamWidth >= pRange->minWidth) && (streamWidth <= pRange->maxWidth) &&
(streamHeight >= pRange->minHeight) && (streamHeight <= pRange->maxHeight))
{
isMatching = TRUE;
}
else
{
isMatching = FALSE;
}
}
// 特殊处理视频流和目标
if (bTargetVideoCheck)
{
BOOL bIsVideoStream = (videoStreamIdx == streamId);
if(bIsVideoTarget ^ bIsVideoStream) // XOR操作：必须同时是视频或同时不是视频
{
isMatching = FALSE;
}
}
// 如果匹配成功，更新掩码并跳出循环
if (TRUE == isMatching)
{
pTargetInfo->pChiStream = pStream; // 将流与目标关联
// 从比较掩码中移除已匹配的目标和流
compareTargetIndexMask = ChxUtils::BitReset(compareTargetIndexMask, targetInfoIdx);
compareStreamIndexMask = ChxUtils::BitReset(compareStreamIndexMask, streamId);
break; // 处理下一个流
}
}
}
// 如果当前流没有找到匹配的目标，则整个用例不匹配
if (FALSE == isMatching)
{
break;
}
}
}
// 最终检查：所有流都必须找到匹配的目标
if (TRUE == isMatching)
{
isMatching = (0 == compareStreamIndexMask) ? TRUE : FALSE;
}
// 记录调试信息
CHX_LOG_VERBOSE("Target Mask: %x Stream Mask: %x - %s",
compareTargetIndexMask,
compareStreamIndexMask,
pUsecase->pUsecaseName);
return isMatching;
}