扣丁书屋

使用 vendor ndk 实现 Android Camera preview

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 function

2.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 --


https://mp.weixin.qq.com/s/W3XAWR_0fAnfU12ckeizTw

最多阅读

简化Android的UI开发 3年以前  |  515542次阅读
Android 深色模式适配原理分析 2年以前  |  27080次阅读
Android 样式系统 | 主题背景覆盖 2年以前  |  8428次阅读
Android Studio 生成so文件 及调用 2年以前  |  6330次阅读
30分钟搭建一个android的私有Maven仓库 3年以前  |  5194次阅读
Android设计与开发工作流 3年以前  |  4904次阅读
Google Enjarify:可代替dex2jar的dex反编译 3年以前  |  4773次阅读
移动端常见崩溃指标 2年以前  |  4666次阅读
Android内存异常机制(用户空间)_NE 2年以前  |  4391次阅读
Android多渠道打包工具:apptools 3年以前  |  4379次阅读
Android-模块化-面向接口编程 2年以前  |  4341次阅读
Google Java编程风格规范(中文版) 3年以前  |  4258次阅读
Android死锁初探 2年以前  |  4147次阅读
Android UI基本技术点 3年以前  |  4075次阅读

手机扫码阅读