记录下 Mtk的Hal3架构笔记,正在进行学习,后续仍会更新
一.MtkCam3的代码结构及学习资料
mtk online里搜Camera 可以搜到很全面的Mtk Hal3的学习文档,Mtk整理的文档很棒,简单到位!
https://online.mediatek.com/QuickStart/2a17666a-9d46-4686-9222-610ec0f087cc
下述的代码结构只是列出了mtk平台的camera路径，Android Camera相关路径并未记录
APP
MTK Camera
vendor/mediatek/proprietary/packages/apps/
HAL
MTK Camera Hal,目前最新Android Camera Api2下用的都是HAL3的内存,HAL3主要代码在mtkcam3中,有些工具类复用了mtkcam中
vendor/mediatek/proprietary/hardware/mtkcam/
vendor/mediatek/proprietary/hardware/mtkcam3/
以下是和camera强相关
vendor/mediatek/proprietary/hardware/jpeg/
vendor/mediatek/proprietary/hardware/bwc/
vendor/mediatek/proprietary/hardware/m4u/
Kernel
kernel-x.xx/drivers/misc/mediatek/imgsensor/
二.MtkCam3设计架构概览
MtkCam3实现了Android定义的几个HAL3的接口:ICameraProvider, ICameraDevice, ICameraDeviceSession, ICameraDeviceCallback;ICameraProvider 的实现类CameraProviderImpl包在 camera device manager 外围，只是一个 adapter, 适配不同版本的 camera device interface。 Camera Service(指的是camera android层的进程: cameraserver ) 可以通过 ICameraProvider 去拿到 ICameraDevice 。ICameraDevice 和 ICameraDeviceSession 的实现类 CameraDevice3Impl, CameraDevice3SessionImpl 。用于Camera Service 去操作每一个 camera。 比如: open, close, configureStreams, processCaptureRequest 。
AppStreamManager位于framework与pipeline之间，主要职责有如下三条：
1、 Callback result to Android framework according to the returning rules which are defined in camera3.h
2、Update vendor defined gralloc usage
3、Android/ MTK streamInfo conversion
IPipelineModel的角色
在open/close stage，Power on/off sensor；在config stage，根据APP的createCaptureSession里面带下来的surface list，推测Output以及按照Topological推测Pipeline各个Node是否需要创建以及各个Node的I/O buffer，建立整条PipelineModel；在Request Stage，接到上层queue下来的request，转化为Pipleline统一的IPipelineFrame，决定这个request的I/O buffer、Topological、sub frame、dummy frame、feature set等信息；
HWNode是大Node,三方算法的挂载在这些node里面,作为小node.
P1Node负责输出raw图,P2CaptureNode主要负责拍照的frame的处理，P2StreamingNode主要负责录像预览的数据处理,JpegNode的输入时main YUV、Thumbnail YUV及metadata，输出是Jpeg及App metadata。
三. MtkCam3代码跟读
3.1 Camera HAL3 init
3.2 OpenCamera
3.3 ConfigureStream
3.4 Request
四. MtkCam3 Debug
1.Mtk日志开关
设置log level,cameraHalserver重启生效
persist.vendor.mtk.camera.log_level
控制代码如下:
#define CAM_ULOGMD(fmt, arg...) ALOGD(fmt, ##arg)
mtkcam/include/mtkcam/utils/std/Log.h
#define CAM_LOGD(fmt, arg...) do{ if(0!=mtkcam_testLog(LOG_TAG, 'D')) ALOGD(fmt, ##arg); } while(0)
mtkcam/utils/std/Misc.cpp
static int32_t determinePersistLogLevel()
{
int32_t level = ::property_get_int32("persist.vendor.mtk.camera.log_level", -1);
CAM_ULOGMD("###### get camera log property =%d", level);
if (-1 == level) {
level = MTKCAM_LOG_LEVEL_DEFAULT;
}
return level;
}
__BEGIN_DECLS
static int32_t gLogLevel = determinePersistLogLevel();
int mtkcam_testLog(char const* /*tag*/, int prio)
{
switch (prio)
{
case 'V': return (gLogLevel>=4);
case 'D': return (gLogLevel>=3);
case 'I': return (gLogLevel>=2);
case 'W': return (gLogLevel>=1);
case 'E': return (1);
default: break;
}
return 0;
}
