18bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala/* 28bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala * Copyright (C) 2012 The Android Open Source Project 38bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala * 48bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala * Licensed under the Apache License, Version 2.0 (the "License"); 58bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala * you may not use this file except in compliance with the License. 68bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala * You may obtain a copy of the License at 78bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala * 88bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala * http://www.apache.org/licenses/LICENSE-2.0 98bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala * 108bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala * Unless required by applicable law or agreed to in writing, software 118bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala * distributed under the License is distributed on an "AS IS" BASIS, 128bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 138bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala * See the License for the specific language governing permissions and 148bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala * limitations under the License. 158bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala */ 168bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala 178bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala#ifndef ANDROID_INCLUDE_CAMERA2_H 188bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala#define ANDROID_INCLUDE_CAMERA2_H 198bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala 208bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala#include "camera_common.h" 21567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala#include "system/camera_metadata.h" 228bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala 238bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala/** 24d76f8af6d4d79e22d9a924710e5d8444c8e4ed8fEino-Ville Talvala * Camera device HAL 2.1 [ CAMERA_DEVICE_API_VERSION_2_0, CAMERA_DEVICE_API_VERSION_2_1 ] 258bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala * 268bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala * EXPERIMENTAL. 278bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala * 28d2a877536a1fe22101cf40def1b6d07e35c3868aEino-Ville Talvala * Supports the android.hardware.Camera APIs. 298bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala * 308bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala * Camera devices that support this version of the HAL must return 31d76f8af6d4d79e22d9a924710e5d8444c8e4ed8fEino-Ville Talvala * CAMERA_DEVICE_API_VERSION_2_1 in camera_device_t.common.version and in 328bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala * camera_info_t.device_version (from camera_module_t.get_camera_info). 338bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala * 34d76f8af6d4d79e22d9a924710e5d8444c8e4ed8fEino-Ville Talvala * Camera modules that may contain version 2.x devices must implement at least 358bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala * version 2.0 of the camera module interface (as defined by 368bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala * camera_module_t.common.module_api_version). 378bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala * 38567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * See camera_common.h for more versioning details. 398bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala * 40d2a877536a1fe22101cf40def1b6d07e35c3868aEino-Ville Talvala * Version history: 41d2a877536a1fe22101cf40def1b6d07e35c3868aEino-Ville Talvala * 42d76f8af6d4d79e22d9a924710e5d8444c8e4ed8fEino-Ville Talvala * 2.0: CAMERA_DEVICE_API_VERSION_2_0. Initial release (Android 4.2): 43d2a877536a1fe22101cf40def1b6d07e35c3868aEino-Ville Talvala * - Sufficient for implementing existing android.hardware.Camera API. 44d2a877536a1fe22101cf40def1b6d07e35c3868aEino-Ville Talvala * - Allows for ZSL queue in camera service layer 45d2a877536a1fe22101cf40def1b6d07e35c3868aEino-Ville Talvala * - Not tested for any new features such manual capture control, 46d2a877536a1fe22101cf40def1b6d07e35c3868aEino-Ville Talvala * Bayer RAW capture, reprocessing of RAW data. 47d76f8af6d4d79e22d9a924710e5d8444c8e4ed8fEino-Ville Talvala * 48d76f8af6d4d79e22d9a924710e5d8444c8e4ed8fEino-Ville Talvala * 2.1: CAMERA_DEVICE_API_VERSION_2_1. Support per-device static metadata: 49d76f8af6d4d79e22d9a924710e5d8444c8e4ed8fEino-Ville Talvala * - Add get_instance_metadata() method to retrieve metadata that is fixed 50d76f8af6d4d79e22d9a924710e5d8444c8e4ed8fEino-Ville Talvala * after device open, but may be variable between open() calls. 518bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala */ 528bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala 538bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala__BEGIN_DECLS 548bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala 55fed0c0244b569e0bae4280af145a94ef3b1a1468Eino-Ville Talvalastruct camera2_device; 56fed0c0244b569e0bae4280af145a94ef3b1a1468Eino-Ville Talvala 57567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala/********************************************************************** 58567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 59567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Input/output stream buffer queue interface definitions 60567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 618bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala */ 628bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala 63567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala/** 64567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Output image stream queue interface. A set of these methods is provided to 65567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * the HAL device in allocate_stream(), and are used to interact with the 66567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * gralloc buffer queue for that stream. They may not be called until after 67567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * allocate_stream returns. 68567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala */ 698bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvalatypedef struct camera2_stream_ops { 70567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala /** 71567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Get a buffer to fill from the queue. The size and format of the buffer 72567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * are fixed for a given stream (defined in allocate_stream), and the stride 73567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * should be queried from the platform gralloc module. The gralloc buffer 74567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * will have been allocated based on the usage flags provided by 75567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * allocate_stream, and will be locked for use. 76567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala */ 7708a6e5e374c57361275173e18eea120587627adfEino-Ville Talvala int (*dequeue_buffer)(const struct camera2_stream_ops* w, 78567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala buffer_handle_t** buffer); 79567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala 80567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala /** 81567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Push a filled buffer to the stream to be used by the consumer. 82567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 83567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * The timestamp represents the time at start of exposure of the first row 84567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * of the image; it must be from a monotonic clock, and is measured in 85567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * nanoseconds. The timestamps do not need to be comparable between 86567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * different cameras, or consecutive instances of the same camera. However, 87567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * they must be comparable between streams from the same camera. If one 88567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * capture produces buffers for multiple streams, each stream must have the 89567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * same timestamp for that buffer, and that timestamp must match the 90567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * timestamp in the output frame metadata. 91567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala */ 9208a6e5e374c57361275173e18eea120587627adfEino-Ville Talvala int (*enqueue_buffer)(const struct camera2_stream_ops* w, 93567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala int64_t timestamp, 94567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala buffer_handle_t* buffer); 95567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala /** 96567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Return a buffer to the queue without marking it as filled. 97567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala */ 9808a6e5e374c57361275173e18eea120587627adfEino-Ville Talvala int (*cancel_buffer)(const struct camera2_stream_ops* w, 99567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala buffer_handle_t* buffer); 100567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala /** 101567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Set the crop window for subsequently enqueued buffers. The parameters are 102567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * measured in pixels relative to the buffer width and height. 103567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala */ 10408a6e5e374c57361275173e18eea120587627adfEino-Ville Talvala int (*set_crop)(const struct camera2_stream_ops *w, 105567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala int left, int top, int right, int bottom); 106567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala 1078bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala} camera2_stream_ops_t; 1088bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala 1092388a2dc91979364d96e49456b189f904f0267f3Eino-Ville Talvala/** 1109633d506b798cfd44172f467b59b2305b19b9b00Eino-Ville Talvala * Temporary definition during transition. 1119633d506b798cfd44172f467b59b2305b19b9b00Eino-Ville Talvala * 1129633d506b798cfd44172f467b59b2305b19b9b00Eino-Ville Talvala * These formats will be removed and replaced with 1139633d506b798cfd44172f467b59b2305b19b9b00Eino-Ville Talvala * HAL_PIXEL_FORMAT_IMPLEMENTATION_DEFINED. To maximize forward compatibility, 1149633d506b798cfd44172f467b59b2305b19b9b00Eino-Ville Talvala * HAL implementations are strongly recommended to treat FORMAT_OPAQUE and 1159633d506b798cfd44172f467b59b2305b19b9b00Eino-Ville Talvala * FORMAT_ZSL as equivalent to HAL_PIXEL_FORMAT_IMPLEMENTATION_DEFINED, and 1169633d506b798cfd44172f467b59b2305b19b9b00Eino-Ville Talvala * return HAL_PIXEL_FORMAT_IMPLEMENTATION_DEFINED in the format_actual output 1179633d506b798cfd44172f467b59b2305b19b9b00Eino-Ville Talvala * parameter of allocate_stream, allowing the gralloc module to select the 1189633d506b798cfd44172f467b59b2305b19b9b00Eino-Ville Talvala * specific format based on the usage flags from the camera and the stream 1199633d506b798cfd44172f467b59b2305b19b9b00Eino-Ville Talvala * consumer. 1209633d506b798cfd44172f467b59b2305b19b9b00Eino-Ville Talvala */ 121567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvalaenum { 1229633d506b798cfd44172f467b59b2305b19b9b00Eino-Ville Talvala CAMERA2_HAL_PIXEL_FORMAT_OPAQUE = HAL_PIXEL_FORMAT_IMPLEMENTATION_DEFINED, 1239633d506b798cfd44172f467b59b2305b19b9b00Eino-Ville Talvala CAMERA2_HAL_PIXEL_FORMAT_ZSL = -1 124567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala}; 125567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala 126567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala/** 127ada3a97820dd48d513350d1365a3040d570bab6eEino-Ville Talvala * Transport header for compressed JPEG buffers in output streams. 128ada3a97820dd48d513350d1365a3040d570bab6eEino-Ville Talvala * 129ada3a97820dd48d513350d1365a3040d570bab6eEino-Ville Talvala * To capture JPEG images, a stream is created using the pixel format 130ada3a97820dd48d513350d1365a3040d570bab6eEino-Ville Talvala * HAL_PIXEL_FORMAT_BLOB, and the static metadata field android.jpeg.maxSize is 131ada3a97820dd48d513350d1365a3040d570bab6eEino-Ville Talvala * used as the buffer size. Since compressed JPEG images are of variable size, 132ada3a97820dd48d513350d1365a3040d570bab6eEino-Ville Talvala * the HAL needs to include the final size of the compressed image using this 133ada3a97820dd48d513350d1365a3040d570bab6eEino-Ville Talvala * structure inside the output stream buffer. The JPEG blob ID field must be set 134ada3a97820dd48d513350d1365a3040d570bab6eEino-Ville Talvala * to CAMERA2_JPEG_BLOB_ID. 135cecacd4e71c35fd50dbe1e9855cbab0faa17b550Alex Ray * 136cecacd4e71c35fd50dbe1e9855cbab0faa17b550Alex Ray * Transport header should be at the end of the JPEG output stream buffer. That 137cecacd4e71c35fd50dbe1e9855cbab0faa17b550Alex Ray * means the jpeg_blob_id must start at byte[android.jpeg.maxSize - 138cecacd4e71c35fd50dbe1e9855cbab0faa17b550Alex Ray * sizeof(camera2_jpeg_blob)]. Any HAL using this transport header must 139cecacd4e71c35fd50dbe1e9855cbab0faa17b550Alex Ray * account for it in android.jpeg.maxSize. The JPEG data itself starts at 140cecacd4e71c35fd50dbe1e9855cbab0faa17b550Alex Ray * byte[0] and should be jpeg_size bytes long. 141ada3a97820dd48d513350d1365a3040d570bab6eEino-Ville Talvala */ 142ada3a97820dd48d513350d1365a3040d570bab6eEino-Ville Talvalatypedef struct camera2_jpeg_blob { 143ada3a97820dd48d513350d1365a3040d570bab6eEino-Ville Talvala uint16_t jpeg_blob_id; 144ada3a97820dd48d513350d1365a3040d570bab6eEino-Ville Talvala uint32_t jpeg_size; 145ada3a97820dd48d513350d1365a3040d570bab6eEino-Ville Talvala}; 146ada3a97820dd48d513350d1365a3040d570bab6eEino-Ville Talvala 147ada3a97820dd48d513350d1365a3040d570bab6eEino-Ville Talvalaenum { 148ada3a97820dd48d513350d1365a3040d570bab6eEino-Ville Talvala CAMERA2_JPEG_BLOB_ID = 0x00FF 149ada3a97820dd48d513350d1365a3040d570bab6eEino-Ville Talvala}; 150ada3a97820dd48d513350d1365a3040d570bab6eEino-Ville Talvala 151ada3a97820dd48d513350d1365a3040d570bab6eEino-Ville Talvala/** 152567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Input reprocess stream queue management. A set of these methods is provided 153fa7a91d3d2a7f99612446f61beb29cc9e215d0baEino-Ville Talvala * to the HAL device in allocate_reprocess_stream(); they are used to interact 154fa7a91d3d2a7f99612446f61beb29cc9e215d0baEino-Ville Talvala * with the reprocess stream's input gralloc buffer queue. 155567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala */ 156567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvalatypedef struct camera2_stream_in_ops { 157567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala /** 158567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Get the next buffer of image data to reprocess. The width, height, and 159567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * format of the buffer is fixed in allocate_reprocess_stream(), and the 160567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * stride and other details should be queried from the platform gralloc 161567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * module as needed. The buffer will already be locked for use. 162567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala */ 16308a6e5e374c57361275173e18eea120587627adfEino-Ville Talvala int (*acquire_buffer)(const struct camera2_stream_in_ops *w, 164567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala buffer_handle_t** buffer); 165567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala /** 166567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Return a used buffer to the buffer queue for reuse. 167567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala */ 16808a6e5e374c57361275173e18eea120587627adfEino-Ville Talvala int (*release_buffer)(const struct camera2_stream_in_ops *w, 169567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala buffer_handle_t* buffer); 170567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala 171567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala} camera2_stream_in_ops_t; 172567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala 173567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala/********************************************************************** 174567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 1758bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala * Metadata queue management, used for requests sent to HAL module, and for 1768bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala * frames produced by the HAL. 177fed0c0244b569e0bae4280af145a94ef3b1a1468Eino-Ville Talvala * 178567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala */ 179567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala 180567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvalaenum { 181567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala CAMERA2_REQUEST_QUEUE_IS_BOTTOMLESS = -1 182567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala}; 183567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala 184567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala/** 185567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Request input queue protocol: 186fed0c0244b569e0bae4280af145a94ef3b1a1468Eino-Ville Talvala * 187567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * The framework holds the queue and its contents. At start, the queue is empty. 188fed0c0244b569e0bae4280af145a94ef3b1a1468Eino-Ville Talvala * 189567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 1. When the first metadata buffer is placed into the queue, the framework 190567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * signals the device by calling notify_request_queue_not_empty(). 191fed0c0244b569e0bae4280af145a94ef3b1a1468Eino-Ville Talvala * 192567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 2. After receiving notify_request_queue_not_empty, the device must call 193fed0c0244b569e0bae4280af145a94ef3b1a1468Eino-Ville Talvala * dequeue() once it's ready to handle the next buffer. 194fed0c0244b569e0bae4280af145a94ef3b1a1468Eino-Ville Talvala * 195567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 3. Once the device has processed a buffer, and is ready for the next buffer, 196567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * it must call dequeue() again instead of waiting for a notification. If 197567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * there are no more buffers available, dequeue() will return NULL. After 198567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * this point, when a buffer becomes available, the framework must call 199567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * notify_request_queue_not_empty() again. If the device receives a NULL 200567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * return from dequeue, it does not need to query the queue again until a 201567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * notify_request_queue_not_empty() call is received from the source. 202567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 203567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 4. If the device calls buffer_count() and receives 0, this does not mean that 204567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * the framework will provide a notify_request_queue_not_empty() call. The 205567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * framework will only provide such a notification after the device has 206567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * received a NULL from dequeue, or on initial startup. 207fed0c0244b569e0bae4280af145a94ef3b1a1468Eino-Ville Talvala * 208567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 5. The dequeue() call in response to notify_request_queue_not_empty() may be 209567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * on the same thread as the notify_request_queue_not_empty() call, and may 210567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * be performed from within the notify call. 211fed0c0244b569e0bae4280af145a94ef3b1a1468Eino-Ville Talvala * 212567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 6. All dequeued request buffers must be returned to the framework by calling 213567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * free_request, including when errors occur, a device flush is requested, or 214567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * when the device is shutting down. 2158bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala */ 216567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvalatypedef struct camera2_request_queue_src_ops { 2178bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala /** 218567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Get the count of request buffers pending in the queue. May return 219567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * CAMERA2_REQUEST_QUEUE_IS_BOTTOMLESS if a repeating request (stream 220567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * request) is currently configured. Calling this method has no effect on 221567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * whether the notify_request_queue_not_empty() method will be called by the 222567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * framework. 2238bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala */ 22408a6e5e374c57361275173e18eea120587627adfEino-Ville Talvala int (*request_count)(const struct camera2_request_queue_src_ops *q); 2258bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala 2268bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala /** 227567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Get a metadata buffer from the framework. Returns OK if there is no 228567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * error. If the queue is empty, returns NULL in buffer. In that case, the 229567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * device must wait for a notify_request_queue_not_empty() message before 230567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * attempting to dequeue again. Buffers obtained in this way must be 231567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * returned to the framework with free_request(). 2328bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala */ 23308a6e5e374c57361275173e18eea120587627adfEino-Ville Talvala int (*dequeue_request)(const struct camera2_request_queue_src_ops *q, 2348bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala camera_metadata_t **buffer); 2358bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala /** 236567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Return a metadata buffer to the framework once it has been used, or if 237567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * an error or shutdown occurs. 2388bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala */ 23908a6e5e374c57361275173e18eea120587627adfEino-Ville Talvala int (*free_request)(const struct camera2_request_queue_src_ops *q, 2408bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala camera_metadata_t *old_buffer); 2418bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala 242567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala} camera2_request_queue_src_ops_t; 2438bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala 244567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala/** 245567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Frame output queue protocol: 246567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 247567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * The framework holds the queue and its contents. At start, the queue is empty. 248567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 249567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 1. When the device is ready to fill an output metadata frame, it must dequeue 250567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * a metadata buffer of the required size. 251567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 252567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 2. It should then fill the metadata buffer, and place it on the frame queue 253567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * using enqueue_frame. The framework takes ownership of the frame. 254567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 255567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 3. In case of an error, a request to flush the pipeline, or shutdown, the 256567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * device must return any affected dequeued frames to the framework by 257567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * calling cancel_frame. 258567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala */ 259567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvalatypedef struct camera2_frame_queue_dst_ops { 2608bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala /** 261567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Get an empty metadata buffer to fill from the framework. The new metadata 262567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * buffer will have room for entries number of metadata entries, plus 263567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * data_bytes worth of extra storage. Frames dequeued here must be returned 264567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * to the framework with either cancel_frame or enqueue_frame. 2658bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala */ 26608a6e5e374c57361275173e18eea120587627adfEino-Ville Talvala int (*dequeue_frame)(const struct camera2_frame_queue_dst_ops *q, 267567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala size_t entries, size_t data_bytes, 268567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala camera_metadata_t **buffer); 269fed0c0244b569e0bae4280af145a94ef3b1a1468Eino-Ville Talvala 270567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala /** 271567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Return a dequeued metadata buffer to the framework for reuse; do not mark it as 272567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * filled. Use when encountering errors, or flushing the internal request queue. 273567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala */ 27408a6e5e374c57361275173e18eea120587627adfEino-Ville Talvala int (*cancel_frame)(const struct camera2_frame_queue_dst_ops *q, 275567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala camera_metadata_t *buffer); 2768bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala 277567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala /** 278567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Place a completed metadata frame on the frame output queue. 279567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala */ 28008a6e5e374c57361275173e18eea120587627adfEino-Ville Talvala int (*enqueue_frame)(const struct camera2_frame_queue_dst_ops *q, 281567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala camera_metadata_t *buffer); 282567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala 283567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala} camera2_frame_queue_dst_ops_t; 284567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala 285567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala/********************************************************************** 286567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 287567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Notification callback and message definition, and trigger definitions 288567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 289567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala */ 2908bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala 2918bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala/** 2928bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala * Asynchronous notification callback from the HAL, fired for various 2938bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala * reasons. Only for information independent of frame capture, or that require 294567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * specific timing. The user pointer must be the same one that was passed to the 295567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * device in set_notify_callback(). 2968bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala */ 2978bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvalatypedef void (*camera2_notify_callback)(int32_t msg_type, 2988bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala int32_t ext1, 2998bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala int32_t ext2, 300567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala int32_t ext3, 3018bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala void *user); 3028bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala 3038bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala/** 3048bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala * Possible message types for camera2_notify_callback 3058bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala */ 3068bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvalaenum { 3078bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala /** 308567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * An error has occurred. Argument ext1 contains the error code, and 309567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * ext2 and ext3 contain any error-specific information. 3108bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala */ 311daacbf40167040991382009523cb29a60b02abf2Eino-Ville Talvala CAMERA2_MSG_ERROR = 0x0001, 3128bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala /** 3138bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala * The exposure of a given request has begun. Argument ext1 contains the 314567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * frame number, and ext2 and ext3 contain the low-order and high-order 315567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * bytes of the timestamp for when exposure began. 316567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * (timestamp = (ext3 << 32 | ext2)) 317567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala */ 318567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala CAMERA2_MSG_SHUTTER = 0x0010, 319567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala /** 320567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * The autofocus routine has changed state. Argument ext1 contains the new 321567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * state; the values are the same as those for the metadata field 322f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * android.control.afState. Ext2 contains the latest trigger ID passed to 323f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * trigger_action(CAMERA2_TRIGGER_AUTOFOCUS) or 324f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * trigger_action(CAMERA2_TRIGGER_CANCEL_AUTOFOCUS), or 0 if trigger has not 325f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * been called with either of those actions. 3268bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala */ 327567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala CAMERA2_MSG_AUTOFOCUS = 0x0020, 328567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala /** 329567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * The autoexposure routine has changed state. Argument ext1 contains the 330567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * new state; the values are the same as those for the metadata field 331f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * android.control.aeState. Ext2 contains the latest trigger ID value passed to 332567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * trigger_action(CAMERA2_TRIGGER_PRECAPTURE_METERING), or 0 if that method 333567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * has not been called. 334567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala */ 335567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala CAMERA2_MSG_AUTOEXPOSURE = 0x0021, 336567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala /** 337567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * The auto-whitebalance routine has changed state. Argument ext1 contains 338567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * the new state; the values are the same as those for the metadata field 339f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * android.control.awbState. Ext2 contains the latest trigger ID passed to 340f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * trigger_action(CAMERA2_TRIGGER_PRECAPTURE_METERING), or 0 if that method 341f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * has not been called. 342567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala */ 343567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala CAMERA2_MSG_AUTOWB = 0x0022 3448bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala}; 3458bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala 3468bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala/** 3478bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala * Error codes for CAMERA_MSG_ERROR 3488bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala */ 3498bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvalaenum { 3508bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala /** 3518bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala * A serious failure occured. Camera device may not work without reboot, and 3528bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala * no further frames or buffer streams will be produced by the 3538bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala * device. Device should be treated as closed. 3548bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala */ 355567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala CAMERA2_MSG_ERROR_HARDWARE = 0x0001, 3568bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala /** 3578bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala * A serious failure occured. No further frames or buffer streams will be 3588bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala * produced by the device. Device should be treated as closed. The client 3598bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala * must reopen the device to use it again. 3608bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala */ 361567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala CAMERA2_MSG_ERROR_DEVICE, 3628bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala /** 363567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * An error has occurred in processing a request. No output (metadata or 364567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * buffers) will be produced for this request. ext2 contains the frame 365567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * number of the request. Subsequent requests are unaffected, and the device 366567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * remains operational. 3678bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala */ 368567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala CAMERA2_MSG_ERROR_REQUEST, 369567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala /** 370567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * An error has occurred in producing an output frame metadata buffer for a 371567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * request, but image buffers for it will still be available. Subsequent 372567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * requests are unaffected, and the device remains operational. ext2 373567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * contains the frame number of the request. 374567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala */ 375567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala CAMERA2_MSG_ERROR_FRAME, 376567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala /** 377567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * An error has occurred in placing an output buffer into a stream for a 378567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * request. The frame metadata and other buffers may still be 379567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * available. Subsequent requests are unaffected, and the device remains 380567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * operational. ext2 contains the frame number of the request, and ext3 381567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * contains the stream id. 382567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala */ 383567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala CAMERA2_MSG_ERROR_STREAM, 384567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala /** 385567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Number of error types 386567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala */ 387567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala CAMERA2_MSG_NUM_ERRORS 3888bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala}; 3898bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala 390567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala/** 391567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Possible trigger ids for trigger_action() 392567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala */ 393567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvalaenum { 3948bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala /** 395567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Trigger an autofocus cycle. The effect of the trigger depends on the 396567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * autofocus mode in effect when the trigger is received, which is the mode 397f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * listed in the latest capture request to be dequeued by the HAL. If the 398f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * mode is OFF, EDOF, or FIXED, the trigger has no effect. In AUTO, MACRO, 399f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * or CONTINUOUS_* modes, see below for the expected behavior. The state of 400567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * the autofocus cycle can be tracked in android.control.afMode and the 401f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * corresponding notifications. 402f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * 403f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala ** 404f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * In AUTO or MACRO mode, the AF state transitions (and notifications) 405f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * when calling with trigger ID = N with the previous ID being K are: 406f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * 407f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * Initial state Transitions 408f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * INACTIVE (K) -> ACTIVE_SCAN (N) -> AF_FOCUSED (N) or AF_NOT_FOCUSED (N) 409f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * AF_FOCUSED (K) -> ACTIVE_SCAN (N) -> AF_FOCUSED (N) or AF_NOT_FOCUSED (N) 410f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * AF_NOT_FOCUSED (K) -> ACTIVE_SCAN (N) -> AF_FOCUSED (N) or AF_NOT_FOCUSED (N) 411f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * ACTIVE_SCAN (K) -> AF_FOCUSED(N) or AF_NOT_FOCUSED(N) 412f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * PASSIVE_SCAN (K) Not used in AUTO/MACRO mode 413f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * PASSIVE_FOCUSED (K) Not used in AUTO/MACRO mode 414f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * 415f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala ** 416f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * In CONTINUOUS_PICTURE mode, triggering AF must lock the AF to the current 417f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * lens position and transition the AF state to either AF_FOCUSED or 418f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * NOT_FOCUSED. If a passive scan is underway, that scan must complete and 419f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * then lock the lens position and change AF state. TRIGGER_CANCEL_AUTOFOCUS 420f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * will allow the AF to restart its operation. 421f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * 422f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * Initial state Transitions 423f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * INACTIVE (K) -> immediate AF_FOCUSED (N) or AF_NOT_FOCUSED (N) 424f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * PASSIVE_FOCUSED (K) -> immediate AF_FOCUSED (N) or AF_NOT_FOCUSED (N) 425f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * PASSIVE_SCAN (K) -> AF_FOCUSED (N) or AF_NOT_FOCUSED (N) 426f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * AF_FOCUSED (K) no effect except to change next notification ID to N 427f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * AF_NOT_FOCUSED (K) no effect except to change next notification ID to N 428f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * 429f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala ** 430f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * In CONTINUOUS_VIDEO mode, triggering AF must lock the AF to the current 431f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * lens position and transition the AF state to either AF_FOCUSED or 432f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * NOT_FOCUSED. If a passive scan is underway, it must immediately halt, in 433f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * contrast with CONTINUOUS_PICTURE mode. TRIGGER_CANCEL_AUTOFOCUS will 434f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * allow the AF to restart its operation. 435f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * 436f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * Initial state Transitions 437f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * INACTIVE (K) -> immediate AF_FOCUSED (N) or AF_NOT_FOCUSED (N) 438f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * PASSIVE_FOCUSED (K) -> immediate AF_FOCUSED (N) or AF_NOT_FOCUSED (N) 439f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * PASSIVE_SCAN (K) -> immediate AF_FOCUSED (N) or AF_NOT_FOCUSED (N) 440f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * AF_FOCUSED (K) no effect except to change next notification ID to N 441f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * AF_NOT_FOCUSED (K) no effect except to change next notification ID to N 442f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * 443f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * Ext1 is an ID that must be returned in subsequent auto-focus state change 444f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * notifications through camera2_notify_callback() and stored in 445f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * android.control.afTriggerId. 4468bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala */ 447567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala CAMERA2_TRIGGER_AUTOFOCUS = 0x0001, 448567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala /** 449f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * Send a cancel message to the autofocus algorithm. The effect of the 450f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * cancellation depends on the autofocus mode in effect when the trigger is 451f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * received, which is the mode listed in the latest capture request to be 452f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * dequeued by the HAL. If the AF mode is OFF or EDOF, the cancel has no 453f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * effect. For other modes, the lens should return to its default position, 454f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * any current autofocus scan must be canceled, and the AF state should be 455f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * set to INACTIVE. 456f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * 457f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * The state of the autofocus cycle can be tracked in android.control.afMode 458f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * and the corresponding notification. Continuous autofocus modes may resume 459f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * focusing operations thereafter exactly as if the camera had just been set 460f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * to a continuous AF mode. 461f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * 462f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * Ext1 is an ID that must be returned in subsequent auto-focus state change 463f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * notifications through camera2_notify_callback() and stored in 464f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * android.control.afTriggerId. 465f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala */ 466f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala CAMERA2_TRIGGER_CANCEL_AUTOFOCUS, 467f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala /** 468567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Trigger a pre-capture metering cycle, which may include firing the flash 469567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * to determine proper capture parameters. Typically, this trigger would be 470567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * fired for a half-depress of a camera shutter key, or before a snapshot 471567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * capture in general. The state of the metering cycle can be tracked in 472567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * android.control.aeMode and the corresponding notification. If the 473f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * auto-exposure mode is OFF, the trigger does nothing. 474f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * 475f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * Ext1 is an ID that must be returned in subsequent 476f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * auto-exposure/auto-white balance state change notifications through 477f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * camera2_notify_callback() and stored in android.control.aePrecaptureId. 478567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala */ 479567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala CAMERA2_TRIGGER_PRECAPTURE_METERING 480567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala}; 4818bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala 482567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala/** 483567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Possible template types for construct_default_request() 484567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala */ 485567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvalaenum { 4868bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala /** 487567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Standard camera preview operation with 3A on auto. 4888bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala */ 489567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala CAMERA2_TEMPLATE_PREVIEW = 1, 490567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala /** 491567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Standard camera high-quality still capture with 3A and flash on auto. 492567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala */ 493567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala CAMERA2_TEMPLATE_STILL_CAPTURE, 494567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala /** 495567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Standard video recording plus preview with 3A on auto, torch off. 496567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala */ 497567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala CAMERA2_TEMPLATE_VIDEO_RECORD, 498567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala /** 499567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * High-quality still capture while recording video. Application will 500567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * include preview, video record, and full-resolution YUV or JPEG streams in 501567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * request. Must not cause stuttering on video stream. 3A on auto. 502567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala */ 503567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala CAMERA2_TEMPLATE_VIDEO_SNAPSHOT, 504567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala /** 505567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Zero-shutter-lag mode. Application will request preview and 506f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * full-resolution data for each frame, and reprocess it to JPEG when a 507567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * still image is requested by user. Settings should provide highest-quality 508567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * full-resolution images without compromising preview frame rate. 3A on 509567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * auto. 510567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala */ 5116adfd6b8ce32f042d001296f08e5b439af2635c1Eino-Ville Talvala CAMERA2_TEMPLATE_ZERO_SHUTTER_LAG, 5126adfd6b8ce32f042d001296f08e5b439af2635c1Eino-Ville Talvala 5136adfd6b8ce32f042d001296f08e5b439af2635c1Eino-Ville Talvala /* Total number of templates */ 5146adfd6b8ce32f042d001296f08e5b439af2635c1Eino-Ville Talvala CAMERA2_TEMPLATE_COUNT 515567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala}; 5168bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala 517567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala 518567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala/********************************************************************** 519567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 520567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Camera device operations 521567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 522567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala */ 523567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvalatypedef struct camera2_device_ops { 524567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala 525567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala /********************************************************************** 526567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Request and frame queue setup and management methods 527567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala */ 5288bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala 5298bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala /** 530567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Pass in input request queue interface methods. 5318bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala */ 53208a6e5e374c57361275173e18eea120587627adfEino-Ville Talvala int (*set_request_queue_src_ops)(const struct camera2_device *, 53308a6e5e374c57361275173e18eea120587627adfEino-Ville Talvala const camera2_request_queue_src_ops_t *request_src_ops); 5348bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala 535567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala /** 536567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Notify device that the request queue is no longer empty. Must only be 537567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * called when the first buffer is added a new queue, or after the source 538567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * has returned NULL in response to a dequeue call. 539567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala */ 54008a6e5e374c57361275173e18eea120587627adfEino-Ville Talvala int (*notify_request_queue_not_empty)(const struct camera2_device *); 5418bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala 5428bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala /** 543567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Pass in output frame queue interface methods 5448bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala */ 54508a6e5e374c57361275173e18eea120587627adfEino-Ville Talvala int (*set_frame_queue_dst_ops)(const struct camera2_device *, 54608a6e5e374c57361275173e18eea120587627adfEino-Ville Talvala const camera2_frame_queue_dst_ops_t *frame_dst_ops); 5478bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala 5488bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala /** 549567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Number of camera requests being processed by the device at the moment 550567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * (captures/reprocesses that have had their request dequeued, but have not 551567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * yet been enqueued onto output pipeline(s) ). No streams may be released 552567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * by the framework until the in-progress count is 0. 5538bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala */ 55408a6e5e374c57361275173e18eea120587627adfEino-Ville Talvala int (*get_in_progress_count)(const struct camera2_device *); 5558bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala 5568bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala /** 5578bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala * Flush all in-progress captures. This includes all dequeued requests 5588bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala * (regular or reprocessing) that have not yet placed any outputs into a 5598bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala * stream or the frame queue. Partially completed captures must be completed 560567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * normally. No new requests may be dequeued from the request queue until 561567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * the flush completes. 5628bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala */ 56308a6e5e374c57361275173e18eea120587627adfEino-Ville Talvala int (*flush_captures_in_progress)(const struct camera2_device *); 5648bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala 5658bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala /** 566567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Create a filled-in default request for standard camera use cases. 567567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 568567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * The device must return a complete request that is configured to meet the 569567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * requested use case, which must be one of the CAMERA2_TEMPLATE_* 570567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * enums. All request control fields must be included, except for 571fa7a91d3d2a7f99612446f61beb29cc9e215d0baEino-Ville Talvala * android.request.outputStreams. 572567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 573567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * The metadata buffer returned must be allocated with 574567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * allocate_camera_metadata. The framework takes ownership of the buffer. 5758bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala */ 57608a6e5e374c57361275173e18eea120587627adfEino-Ville Talvala int (*construct_default_request)(const struct camera2_device *, 577567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala int request_template, 578567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala camera_metadata_t **request); 5798bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala 580567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala /********************************************************************** 581567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Stream management 5828bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala */ 5838bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala 5848bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala /** 585567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * allocate_stream: 586567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 587567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Allocate a new output stream for use, defined by the output buffer width, 588567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * height, target, and possibly the pixel format. Returns the new stream's 589567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * ID, gralloc usage flags, minimum queue buffer count, and possibly the 590567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * pixel format, on success. Error conditions: 591567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 592567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * - Requesting a width/height/format combination not listed as 593567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * supported by the sensor's static characteristics 594567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 595567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * - Asking for too many streams of a given format type (2 bayer raw 596567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * streams, for example). 597567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 598567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Input parameters: 599567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 600567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * - width, height, format: Specification for the buffers to be sent through 6012388a2dc91979364d96e49456b189f904f0267f3Eino-Ville Talvala * this stream. Format is a value from the HAL_PIXEL_FORMAT_* list. If 6022388a2dc91979364d96e49456b189f904f0267f3Eino-Ville Talvala * HAL_PIXEL_FORMAT_IMPLEMENTATION_DEFINED is used, then the platform 6032388a2dc91979364d96e49456b189f904f0267f3Eino-Ville Talvala * gralloc module will select a format based on the usage flags provided 6042388a2dc91979364d96e49456b189f904f0267f3Eino-Ville Talvala * by the camera HAL and the consumer of the stream. The camera HAL should 6052388a2dc91979364d96e49456b189f904f0267f3Eino-Ville Talvala * inspect the buffers handed to it in the register_stream_buffers call to 6062388a2dc91979364d96e49456b189f904f0267f3Eino-Ville Talvala * obtain the implementation-specific format if necessary. 607567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 608567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * - stream_ops: A structure of function pointers for obtaining and queuing 609567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * up buffers for this stream. The underlying stream will be configured 610567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * based on the usage and max_buffers outputs. The methods in this 611567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * structure may not be called until after allocate_stream returns. 612567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 613567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Output parameters: 614567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 615567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * - stream_id: An unsigned integer identifying this stream. This value is 616567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * used in incoming requests to identify the stream, and in releasing the 617567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * stream. 618567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 619567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * - usage: The gralloc usage mask needed by the HAL device for producing 620567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * the requested type of data. This is used in allocating new gralloc 621567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * buffers for the stream buffer queue. 622567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 623567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * - max_buffers: The maximum number of buffers the HAL device may need to 624567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * have dequeued at the same time. The device may not dequeue more buffers 625567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * than this value at the same time. 626567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 6278bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala */ 628567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala int (*allocate_stream)( 62908a6e5e374c57361275173e18eea120587627adfEino-Ville Talvala const struct camera2_device *, 630567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala // inputs 631567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala uint32_t width, 632567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala uint32_t height, 633567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala int format, 63408a6e5e374c57361275173e18eea120587627adfEino-Ville Talvala const camera2_stream_ops_t *stream_ops, 635567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala // outputs 636567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala uint32_t *stream_id, 6372388a2dc91979364d96e49456b189f904f0267f3Eino-Ville Talvala uint32_t *format_actual, // IGNORED, will be removed 638567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala uint32_t *usage, 639567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala uint32_t *max_buffers); 6408bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala 6418bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala /** 642567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Register buffers for a given stream. This is called after a successful 643567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * allocate_stream call, and before the first request referencing the stream 644567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * is enqueued. This method is intended to allow the HAL device to map or 645567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * otherwise prepare the buffers for later use. num_buffers is guaranteed to 646567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * be at least max_buffers (from allocate_stream), but may be larger. The 647567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * buffers will already be locked for use. At the end of the call, all the 6482388a2dc91979364d96e49456b189f904f0267f3Eino-Ville Talvala * buffers must be ready to be returned to the queue. If the stream format 6492388a2dc91979364d96e49456b189f904f0267f3Eino-Ville Talvala * was set to HAL_PIXEL_FORMAT_IMPLEMENTATION_DEFINED, the camera HAL should 6502388a2dc91979364d96e49456b189f904f0267f3Eino-Ville Talvala * inspect the passed-in buffers here to determine any platform-private 6512388a2dc91979364d96e49456b189f904f0267f3Eino-Ville Talvala * pixel format information. 6528bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala */ 653567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala int (*register_stream_buffers)( 65408a6e5e374c57361275173e18eea120587627adfEino-Ville Talvala const struct camera2_device *, 655567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala uint32_t stream_id, 656567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala int num_buffers, 657567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala buffer_handle_t *buffers); 6588bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala 6598bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala /** 660567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Release a stream. Returns an error if called when get_in_progress_count 661567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * is non-zero, or if the stream id is invalid. 6628bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala */ 6638bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala int (*release_stream)( 66408a6e5e374c57361275173e18eea120587627adfEino-Ville Talvala const struct camera2_device *, 665567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala uint32_t stream_id); 666567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala 667567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala /** 668567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * allocate_reprocess_stream: 669567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 670567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Allocate a new input stream for use, defined by the output buffer width, 671567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * height, and the pixel format. Returns the new stream's ID, gralloc usage 672567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * flags, and required simultaneously acquirable buffer count, on 673567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * success. Error conditions: 674567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 675567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * - Requesting a width/height/format combination not listed as 676567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * supported by the sensor's static characteristics 677567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 678567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * - Asking for too many reprocessing streams to be configured at once. 679567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 680567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Input parameters: 681567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 682567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * - width, height, format: Specification for the buffers to be sent through 683567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * this stream. Format must be a value from the HAL_PIXEL_FORMAT_* list. 684567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 685567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * - reprocess_stream_ops: A structure of function pointers for acquiring 686567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * and releasing buffers for this stream. The underlying stream will be 687567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * configured based on the usage and max_buffers outputs. 688567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 689567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Output parameters: 690567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 691567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * - stream_id: An unsigned integer identifying this stream. This value is 692567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * used in incoming requests to identify the stream, and in releasing the 693567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * stream. These ids are numbered separately from the input stream ids. 694567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 695567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * - consumer_usage: The gralloc usage mask needed by the HAL device for 696567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * consuming the requested type of data. This is used in allocating new 697567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * gralloc buffers for the stream buffer queue. 698567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 699567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * - max_buffers: The maximum number of buffers the HAL device may need to 700567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * have acquired at the same time. The device may not have more buffers 701567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * acquired at the same time than this value. 702567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 703567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala */ 70408a6e5e374c57361275173e18eea120587627adfEino-Ville Talvala int (*allocate_reprocess_stream)(const struct camera2_device *, 705567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala uint32_t width, 706567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala uint32_t height, 707567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala uint32_t format, 70808a6e5e374c57361275173e18eea120587627adfEino-Ville Talvala const camera2_stream_in_ops_t *reprocess_stream_ops, 709567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala // outputs 710567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala uint32_t *stream_id, 711567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala uint32_t *consumer_usage, 712567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala uint32_t *max_buffers); 713567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala 714567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala /** 7157f8dd0ad2d3d40b57c8359971a351fd194668613Eino-Ville Talvala * allocate_reprocess_stream_from_stream: 7167f8dd0ad2d3d40b57c8359971a351fd194668613Eino-Ville Talvala * 7177f8dd0ad2d3d40b57c8359971a351fd194668613Eino-Ville Talvala * Allocate a new input stream for use, which will use the buffers allocated 7187f8dd0ad2d3d40b57c8359971a351fd194668613Eino-Ville Talvala * for an existing output stream. That is, after the HAL enqueues a buffer 7197f8dd0ad2d3d40b57c8359971a351fd194668613Eino-Ville Talvala * onto the output stream, it may see that same buffer handed to it from 7207f8dd0ad2d3d40b57c8359971a351fd194668613Eino-Ville Talvala * this input reprocessing stream. After the HAL releases the buffer back to 7217f8dd0ad2d3d40b57c8359971a351fd194668613Eino-Ville Talvala * the reprocessing stream, it will be returned to the output queue for 7227f8dd0ad2d3d40b57c8359971a351fd194668613Eino-Ville Talvala * reuse. 7237f8dd0ad2d3d40b57c8359971a351fd194668613Eino-Ville Talvala * 7247f8dd0ad2d3d40b57c8359971a351fd194668613Eino-Ville Talvala * Error conditions: 7257f8dd0ad2d3d40b57c8359971a351fd194668613Eino-Ville Talvala * 7267f8dd0ad2d3d40b57c8359971a351fd194668613Eino-Ville Talvala * - Using an output stream of unsuitable size/format for the basis of the 7277f8dd0ad2d3d40b57c8359971a351fd194668613Eino-Ville Talvala * reprocessing stream. 7287f8dd0ad2d3d40b57c8359971a351fd194668613Eino-Ville Talvala * 7297f8dd0ad2d3d40b57c8359971a351fd194668613Eino-Ville Talvala * - Attempting to allocatee too many reprocessing streams at once. 7307f8dd0ad2d3d40b57c8359971a351fd194668613Eino-Ville Talvala * 7317f8dd0ad2d3d40b57c8359971a351fd194668613Eino-Ville Talvala * Input parameters: 7327f8dd0ad2d3d40b57c8359971a351fd194668613Eino-Ville Talvala * 7337f8dd0ad2d3d40b57c8359971a351fd194668613Eino-Ville Talvala * - output_stream_id: The ID of an existing output stream which has 7347f8dd0ad2d3d40b57c8359971a351fd194668613Eino-Ville Talvala * a size and format suitable for reprocessing. 7357f8dd0ad2d3d40b57c8359971a351fd194668613Eino-Ville Talvala * 7367f8dd0ad2d3d40b57c8359971a351fd194668613Eino-Ville Talvala * - reprocess_stream_ops: A structure of function pointers for acquiring 7377f8dd0ad2d3d40b57c8359971a351fd194668613Eino-Ville Talvala * and releasing buffers for this stream. The underlying stream will use 7387f8dd0ad2d3d40b57c8359971a351fd194668613Eino-Ville Talvala * the same graphics buffer handles as the output stream uses. 7397f8dd0ad2d3d40b57c8359971a351fd194668613Eino-Ville Talvala * 7407f8dd0ad2d3d40b57c8359971a351fd194668613Eino-Ville Talvala * Output parameters: 7417f8dd0ad2d3d40b57c8359971a351fd194668613Eino-Ville Talvala * 7427f8dd0ad2d3d40b57c8359971a351fd194668613Eino-Ville Talvala * - stream_id: An unsigned integer identifying this stream. This value is 7437f8dd0ad2d3d40b57c8359971a351fd194668613Eino-Ville Talvala * used in incoming requests to identify the stream, and in releasing the 7447f8dd0ad2d3d40b57c8359971a351fd194668613Eino-Ville Talvala * stream. These ids are numbered separately from the input stream ids. 7457f8dd0ad2d3d40b57c8359971a351fd194668613Eino-Ville Talvala * 7467f8dd0ad2d3d40b57c8359971a351fd194668613Eino-Ville Talvala * The HAL client must always release the reprocessing stream before it 7477f8dd0ad2d3d40b57c8359971a351fd194668613Eino-Ville Talvala * releases the output stream it is based on. 7487f8dd0ad2d3d40b57c8359971a351fd194668613Eino-Ville Talvala * 7497f8dd0ad2d3d40b57c8359971a351fd194668613Eino-Ville Talvala */ 7507f8dd0ad2d3d40b57c8359971a351fd194668613Eino-Ville Talvala int (*allocate_reprocess_stream_from_stream)(const struct camera2_device *, 7517f8dd0ad2d3d40b57c8359971a351fd194668613Eino-Ville Talvala uint32_t output_stream_id, 7527f8dd0ad2d3d40b57c8359971a351fd194668613Eino-Ville Talvala const camera2_stream_in_ops_t *reprocess_stream_ops, 7537f8dd0ad2d3d40b57c8359971a351fd194668613Eino-Ville Talvala // outputs 7547f8dd0ad2d3d40b57c8359971a351fd194668613Eino-Ville Talvala uint32_t *stream_id); 7557f8dd0ad2d3d40b57c8359971a351fd194668613Eino-Ville Talvala 7567f8dd0ad2d3d40b57c8359971a351fd194668613Eino-Ville Talvala /** 757567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Release a reprocessing stream. Returns an error if called when 758567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * get_in_progress_count is non-zero, or if the stream id is not 759567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * valid. 760567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala */ 761567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala int (*release_reprocess_stream)( 76208a6e5e374c57361275173e18eea120587627adfEino-Ville Talvala const struct camera2_device *, 763567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala uint32_t stream_id); 764567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala 765567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala /********************************************************************** 766567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Miscellaneous methods 767567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala */ 768567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala 769567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala /** 770567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Trigger asynchronous activity. This is used for triggering special 771567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * behaviors of the camera 3A routines when they are in use. See the 772567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * documentation for CAMERA2_TRIGGER_* above for details of the trigger ids 773567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * and their arguments. 774567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala */ 77508a6e5e374c57361275173e18eea120587627adfEino-Ville Talvala int (*trigger_action)(const struct camera2_device *, 776567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala uint32_t trigger_id, 777f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala int32_t ext1, 778f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala int32_t ext2); 779567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala 780567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala /** 781567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Notification callback setup 782567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala */ 78308a6e5e374c57361275173e18eea120587627adfEino-Ville Talvala int (*set_notify_callback)(const struct camera2_device *, 784567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala camera2_notify_callback notify_cb, 785567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala void *user); 7868bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala 7878bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala /** 788fed0c0244b569e0bae4280af145a94ef3b1a1468Eino-Ville Talvala * Get methods to query for vendor extension metadata tag infomation. May 789fed0c0244b569e0bae4280af145a94ef3b1a1468Eino-Ville Talvala * set ops to NULL if no vendor extension tags are defined. 790fed0c0244b569e0bae4280af145a94ef3b1a1468Eino-Ville Talvala */ 79108a6e5e374c57361275173e18eea120587627adfEino-Ville Talvala int (*get_metadata_vendor_tag_ops)(const struct camera2_device*, 792fed0c0244b569e0bae4280af145a94ef3b1a1468Eino-Ville Talvala vendor_tag_query_ops_t **ops); 793fed0c0244b569e0bae4280af145a94ef3b1a1468Eino-Ville Talvala 794fed0c0244b569e0bae4280af145a94ef3b1a1468Eino-Ville Talvala /** 7958bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala * Dump state of the camera hardware 7968bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala */ 79708a6e5e374c57361275173e18eea120587627adfEino-Ville Talvala int (*dump)(const struct camera2_device *, int fd); 7988bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala 799d76f8af6d4d79e22d9a924710e5d8444c8e4ed8fEino-Ville Talvala /** 800d76f8af6d4d79e22d9a924710e5d8444c8e4ed8fEino-Ville Talvala * Get device-instance-specific metadata. This metadata must be constant for 801d76f8af6d4d79e22d9a924710e5d8444c8e4ed8fEino-Ville Talvala * a single instance of the camera device, but may be different between 802d76f8af6d4d79e22d9a924710e5d8444c8e4ed8fEino-Ville Talvala * open() calls. The returned camera_metadata pointer must be valid until 803d76f8af6d4d79e22d9a924710e5d8444c8e4ed8fEino-Ville Talvala * the device close() method is called. 804d76f8af6d4d79e22d9a924710e5d8444c8e4ed8fEino-Ville Talvala * 805d76f8af6d4d79e22d9a924710e5d8444c8e4ed8fEino-Ville Talvala * Version information: 806d76f8af6d4d79e22d9a924710e5d8444c8e4ed8fEino-Ville Talvala * 807d76f8af6d4d79e22d9a924710e5d8444c8e4ed8fEino-Ville Talvala * CAMERA_DEVICE_API_VERSION_2_0: 808d76f8af6d4d79e22d9a924710e5d8444c8e4ed8fEino-Ville Talvala * 809d76f8af6d4d79e22d9a924710e5d8444c8e4ed8fEino-Ville Talvala * Not available. Framework may not access this function pointer. 810d76f8af6d4d79e22d9a924710e5d8444c8e4ed8fEino-Ville Talvala * 811d76f8af6d4d79e22d9a924710e5d8444c8e4ed8fEino-Ville Talvala * CAMERA_DEVICE_API_VERSION_2_1: 812d76f8af6d4d79e22d9a924710e5d8444c8e4ed8fEino-Ville Talvala * 813d76f8af6d4d79e22d9a924710e5d8444c8e4ed8fEino-Ville Talvala * Valid. Can be called by the framework. 814d76f8af6d4d79e22d9a924710e5d8444c8e4ed8fEino-Ville Talvala * 815d76f8af6d4d79e22d9a924710e5d8444c8e4ed8fEino-Ville Talvala */ 816d76f8af6d4d79e22d9a924710e5d8444c8e4ed8fEino-Ville Talvala int (*get_instance_metadata)(const struct camera2_device *, 817d76f8af6d4d79e22d9a924710e5d8444c8e4ed8fEino-Ville Talvala camera_metadata **instance_metadata); 818d76f8af6d4d79e22d9a924710e5d8444c8e4ed8fEino-Ville Talvala 8198bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala} camera2_device_ops_t; 8208bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala 821567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala/********************************************************************** 822567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 823567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Camera device definition 824567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 825567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala */ 8268bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvalatypedef struct camera2_device { 8278bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala /** 828ddc026e39344169f64f4696174a4d1269d069557Eino-Ville Talvala * common.version must equal CAMERA_DEVICE_API_VERSION_2_0 to identify 8298bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala * this device as implementing version 2.0 of the camera device HAL. 8308bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala */ 8318bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala hw_device_t common; 8328bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala camera2_device_ops_t *ops; 8338bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala void *priv; 8348bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala} camera2_device_t; 8358bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala 8368bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala__END_DECLS 8378bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala 8388bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala#endif /* #ifdef ANDROID_INCLUDE_CAMERA2_H */ 839