1.项目背景
为了在工厂测试中快速启动芯片外设测试项目,不启动Android系统,使用fastmmi(FFBM: Fast Factory Boot Mode)测试框架。 本人负责测试芯片中的camera外设,保证camera preview function,设置最原始的camera xml参数,preview图像清晰。 fastmmi项目负责人沟通,Android系统UI完全没有启动,其中包含Zygote process,但camera service和camera provider是能够保证启动。fastmmi是编译在system分区下运行。 在这样的前提下选择使用vendor NDK interface开发camera preview function2.vendor ndk和ndk接口的区别
介绍一部分vendor ndk和ndk接口的区别,进而详细说明为什么只能使用Vendor NDK interface。2.1NDK 基础概念:
JNI(Java Native Interface):Java本地接口。是为了方便Java调用c、c++等本地代码所封装的一层接口(也是一个标准)。Java设计之初就考虑了native接口,因为Java语言无法承载所有的业务,native接口是Java能力的补充。 NDK(Native Development Kit) : 原生开发工具包,即帮助开发原生代码的一系列工具,包括但不限于编译工具、一些公共库、开发IDE等。NDK 工具包中提供了完整的一套将 c/c++ 代码编译成静态/动态库的工具,而 Android.mk 和 Application.mk 你可以认为是描述编译参数和一些配置的文件。比如指定使用c++11还是c++14编译,会引用哪些共享库,并描述关系等,还会指定编译的ABI。只有有了这些 NDK 中的编译工具才能准确的编译 c/c++ 代码。
ABI(Application binary interface)应用程序二进制接口。不同的CPU 与指令集的每种组合都有定义的 ABI (应用程序二进制接口),一段程序只有遵循这个接口规范才能在该 CPU 上运行,所以同样的程序代码为了兼容多个不同的CPU,需要为不同的 ABI 构建不同的库文件。当然对于CPU来说,不同的架构并不意味着一定互不兼容。
armeabi设备只兼容armeabi;armeabi-v7a设备兼容armeabi-v7a、armeabi;arm64-v8a设备兼容arm64-v8a、armeabi-v7a、armeabi;X86设备兼容X86、armeabi;X86_64设备兼容X86_64、X86、armeabi;mips64设备兼容mips64、mips;mips只兼容mips;
Java Framework and JNI deference 画一个简单介绍通过NDK interface和Java framework SDK interface调用的区别,如果是使用Java framework就是直接使用Java SDK调用,在通过AIDL interface(binder 跨进程)调用到C framework,camera module is libcameraservice。直接调用底层是C/C++ framework的情况,只能通过 NDK在 Android中使用 JNI 与本地代码(如C、C++)交互。
2.2 Vendor NDk interface基本概念:
VNDK的全称是Vendor Native Development Kit,是Android 8.0引入的一种新技术。它表现一系列库的合集,用于让供应商开发自己的HALs。VNDK 包含在 system.img 中,并在运行时与供应商代码动态关联。 使用vndk的原因是自Android8.0以来,Google引入了Treble架构,希望对vendor和system分区进行解耦处理,期待实现:framwork进程不加载vendor共享库,vendor进程仅加载vendor共享库(和部分framework共享库),而framework进程和vendor进程之间通过HIDL和hwbinder来通信。2.3为什么使用vendor NDK实现camera preview function
fastmmi整个测试框架是编译在system_ext分区中,但camera provider进程是编译在vendor分区中,这是两个完全不同的分区目录,Google对其进行解耦,不能够交叉调用共享库。为了能够在system_ext分区中调用到vendor分区共享库,只能使用vendor NDK interface,而不能使用NDK interface。 如果感兴趣可以进一步了解:Android 共享系统映像,其中这句话很重要:Native interfaces: The native modules in the /product partition must be unbundled from the other partitions. The only allowed dependencies from the product modules are some VNDK libraries (including LLNDK) from the /system partition. JNI libraries that the product apps depend on must be NDK libraries. 个人理解为什么会有VNDK,如果vendor中的程序可以直接调用NDK,这会给C/C++ framework的升级带来很大的影响,CTS测试是会调用NDK的,意味着C/C++ framework升级就必须增加CTS测试项目,并且修改NDK进行对新增项目的支持,这样就会影响到vendor program。 而且很明显NDK部分的代码比VNDK多得多,功能也要丰富很多。所以VNDK的产生就是为了让system 和 vendor分区解耦情况下,对vendor调用system的限制。参考:Google VNDK具体代码逻辑分析
一下为具体代码分析,提取的项目中的VNDK interface(和NDK interface都是相同的功能)主干,这些接口的具体使用可以在Google文档中查询,代码流程都是按照提供的sample借鉴的。 链接: camera2 API.
int mmi_cam_open_camera() { /*open camera */ mDeviceStateCallbacks.onDisconnected = camera_device_on_disconnected; mDeviceStateCallbacks.onError = camera_device_on_error; camera_status = ACameraManager_openCamera( cameraManager, mselectedCameraId, &mDeviceStateCallbacks, &mCameraDevice); if (camera_status != ACAMERA_OK) { MMI_ALOGE("Failed to open camera device (id: %s)", mselectedCameraId); return FAILED; } return SUCCESS; } // Get frame from NDK camera camera_status_t camera_status = ACAMERA_ERROR_UNKNOWN; media_status_t media_status = AMEDIA_OK; cameraManager = ACameraManager_create(); camera_status = ACameraManager_getCameraIdList(cameraManager, &mcameraIdList); if (camera_status != ACAMERA_OK) { ALOGE(" Failed to get camera id list (reason: %d)", camera_status); return FAILED; } // The camera id has been converted to a number, 0,1,2, etc if(cam_id < 0 || cam_id >= mcameraIdList->numCameras) { MMI_ALOGE("Invalid camera index: %d\n", cam_id); return FAILED; } num_cameras = mcameraIdList->numCameras; mselectedCameraId = mcameraIdList->cameraIds[cam_id]; camera_status = ACameraManager_getCameraCharacteristics( cameraManager, mselectedCameraId, &mcameraMetadata); if (camera_status != ACAMERA_OK) { ALOGE(" Failed to get camera meta data of ID:%s", mselectedCameraId); return FAILED; } if(mmi_cam_open_camera() != SUCCESS) { MMI_ALOGE("fail to open camera \n"); return FAILED; } camera_status = ACameraDevice_createCaptureRequest( mCameraDevice, TEMPLATE_PREVIEW, &mCaptureRequest); if (camera_status != ACAMERA_OK) { ALOGE(" Failed to create preview capture request (id: %s)", mselectedCameraId); return FAILED; } // 获取AE的设置property,camera property一般是先get再set,避免直接set出现很多参数为0,效果不正常 ACameraMetadata_const_entry entry; camera_status = ACaptureRequest_getConstEntry( mCaptureRequest, ACAMERA_CONTROL_AE_MODE, &entry); //先建立container,再往container里面放image reader(相当于显示图像的窗口) ACaptureSessionOutputContainer_create(&mCaptureSessionOutputContainer); AImageReader_new(preview_dim.width, preview_dim.height, AIMAGE_FORMAT_YUV_420_888, MAX_BUF_COUNT, &mImageReader); static AImageReader_ImageListener listener{ //context赋值的是class的this指针,result上来可以解析出是谁下发的request。 .context = this, .onImageAvailable = OnImageCallback, }; //创建listener对是否有image的到来做出反应处理。 media_status = AImageReader_setImageListener(mImageReader, &listener); if (media_status != AMEDIA_OK) { ALOGE(" Failed to set image listener"); return FAILED; } media_status = AImageReader_getWindow(mImageReader, &mImgReaderAnw); if (media_status != AMEDIA_OK) { ALOGE(" Failed to get image reader native window"); return FAILED; } camera_status = ACaptureSessionOutput_create(mImgReaderAnw, &mSessionOutput); if (camera_status != ACAMERA_OK) { ALOGE(" Failed to create mSessionOutput, camera_status %d", camera_status); return FAILED; } camera_status = ACaptureSessionOutputContainer_add( mCaptureSessionOutputContainer, mSessionOutput); if (camera_status != ACAMERA_OK) { ALOGE(" Failed to add mSessionOutput in mCaptureSessionOutputContainer, " "camera_status %d", camera_status); return FAILED; } camera_status = ACameraOutputTarget_create(mImgReaderAnw, &mCameraOutputTarget); if (camera_status != ACAMERA_OK) { ALOGE(" Failed to create mCameraOutputTarget, camera_status %d", camera_status); return FAILED; } camera_status = ACaptureRequest_addTarget(mCaptureRequest, mCameraOutputTarget); if (camera_status != ACAMERA_OK) { ALOGE(" Failed to add mCameraOutputTarget in mCaptureRequest, camera_status " "%d", camera_status); return FAILED; } camera_status = ACameraDevice_createCaptureSession( mCameraDevice, mCaptureSessionOutputContainer, &mCaptureSessionStateCallbacks, &mCaptureSession); if (camera_status != ACAMERA_OK) { ALOGE(" Failed to create mCaptureSession by CameraDevice, camera_status %d", camera_status); return FAILED; } int previewSeqId; //当程序执行setRepeatingRequest之后camera service就不断的下发request,直到去stop camera_status = ACameraCaptureSession_setRepeatingRequest( mCaptureSession, NULL, 1, &mCaptureRequest, &previewSeqId); if (camera_status != ACAMERA_OK) { ALOGE(" Failed to setRepeatingRequest by mCaptureSession, camera_status %d", camera_status); return FAILED; } //当camera HAL处理完buffer之后通过camera service callback image interface static void OnImageCallback(AImageReader* reader) { ImageCallback(ctx, reader); } void ImageCallback(void* context, AImageReader *reader) { if (reader == nullptr) { ALOGE(" FaceAuth::ImageCallback AImageReader is null"); return; } media_status_t status; AImage* image = nullptr; //image中存放指向数据buffer指针 status = AImageReader_acquireNextImage(reader, &image); if (status != AMEDIA_OK) { ALOGE(" FaceAuth::ImageCallback Failed to get image"); return; } mmi_cam_display_buffer(image); AImage_delete(image); } void mmi_cam_display_buffer(AImage* image) { int preview_width = preview_dim.width; int preview_height = preview_dim.height; int preview_pixels = preview_width * preview_height; int rotation = sensor_mount_angle; int yPlaneIndex = 0; int uvPlaneIndex = 1; int yPlaneLength, cbcrLength; IMAGE_UV_DATA stYUVData; int32_t yrowStride = 0; int32_t uvrowStride = 0; int32_t format = 0; media_status = AImage_getFormat(image, &format); media_status = AImage_getPlaneRowStride(image, yPlaneIndex, &yrowStride); media_status = AImage_getPlaneRowStride(image, yPlaneIndex, &uvrowStride); media_status = AImage_getPlaneData(image, yPlaneIndex, &stYUVData.yPlanedataPtr, &yPlaneLength); media_status = AImage_getPlaneData(image, uvPlaneIndex, &stYUVData.cbDataPtr, &cbcrLength); if (media_status != AMEDIA_OK) { ALOGE("Failed to image get Plane Data (reason: %d)", media_status); } yPlaneLength, cbcrLength, preview_width, preview_height); for(int i=0; i<yPlaneLength; i+=yrowStride){ memcpy(g_pPreview_Y, (uint8_t *) stYUVData.yPlanedataPtr, preview_width); stYUVData.yPlanedataPtr += yrowStride; g_pPreview_Y += preview_width; } g_pPreview_Y -= preview_pixels; for(int i=0; i<cbcrLength; i+=uvrowStride){ memcpy(g_pPreview_UV, (uint8_t *) stYUVData.cbDataPtr, preview_width); stYUVData.cbDataPtr += uvrowStride; g_pPreview_UV += preview_width; } g_pPreview_UV -= preview_pixels / 2; yuvtorgb8888(preview_width, preview_height, g_pPreview_Y, g_pPreview_UV, g_pPreviewRGB8888); }
对代码总体做一个介绍:
我是使用class来封装camera preview功能,建议这么设计因为下发request的进程需要return,但是主进程并不能结束,不是就无法接收到result返回的callback,所以设置camera参数并且起流的进程需要和主线程并行。 在image listener中注册image callback的回调函数,当result上传buffer的时候就会调用此函数,提取buffer中的图像数据。 image call back函数接收到的buffer数据不一定完全包含image数据,其中可能有padding的补充,所以需要获取plane Row Stride和Plane Data. Row stride的数据大于等于plane data,多余的数据空间就是padding data。 芯片ISP 输出的为YUV数据,排列方式为先Y channel后UV channel,分开提取通过函数转为RGB888进行view显示。CSDN的代码预览没有高亮真的很难看,推荐copy到IDE中观看!
system和vendor分区binder进程间通信
Camera preview由VNDK interface组成的主体就如上一节的code所示,但是当时运行成功之后,在HAL中也能够看到request下发成功,但是怎么都无法接收到result的buffer回调,几乎折腾了一周都不知道为什么。
最后通过头给我查看发现是因为跨system和vendor分区binder通信的问题,provider进程的消息无法传输到fastmmi进程中,因为fastmmi的负责人根本没有考虑会有binder通信的问题。
#include <binder/IPCThreadState.h> #include <binder/IServiceManager.h> #include <binder/ProcessState.h> //binder code android::ProcessState::self()->startThreadPool();
在启动由VNDK interface组成的camera preview功能主进程中,main函数执行最后加入binder code。startThreadPool创建新的binder线程,通过单例模式保证一个进程只有一个线程池。然后调用thread::run方法调用threadloop,进一步调用到joinThreadPool函数循环不断地执行收到消息指令。
通过在主进程中建立binder通信就可以与provider进程进行交互,camera HAL传输buffer到camera service进而call back回调到fastmmi进程中。
具体binder通信可以看这个小哥写的博客,写得非常的不错!链接: 彻底理解Android Binder通信架构** .**
Acknowledge
如果博客有什么不清楚或者错误或者疑惑的地方欢迎大家留言讨论,虚心向大家求教! 工作之后感觉 忙碌了许多,真是要下定决心才能写点技术分享博客,感觉倦怠了,还是不能这样需要更振作一些,努力输出一些有价值的东西和大家分享。 目前开始开发camera HAL(Qualcomm CAMX CHI-CDK)相关的东西不能够放到网上和大家分享,真是挺难受的,希望可以私下交流吧!好啦可以开始第二篇了,通过Camera HIDL interface实现preview function! 谢谢大家!原文链接: https://blog.csdn.net/chinamaoge/article/details/122394759
-- END --
查看更多关于使用 vendor ndk 实现 Android Camera preview的详细内容...