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/** 24ddc026e39344169f64f4696174a4d1269d069557Eino-Ville Talvala * Camera device HAL 2.0 [ CAMERA_DEVICE_API_VERSION_2_0 ] 258bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala * 268bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala * EXPERIMENTAL. 278bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala * 288bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala * Supports both the android.hardware.ProCamera and 298bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala * android.hardware.Camera APIs. 308bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala * 318bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala * Camera devices that support this version of the HAL must return 32ddc026e39344169f64f4696174a4d1269d069557Eino-Ville Talvala * CAMERA_DEVICE_API_VERSION_2_0 in camera_device_t.common.version and in 338bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala * camera_info_t.device_version (from camera_module_t.get_camera_info). 348bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala * 358bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala * Camera modules that may contain version 2.0 devices must implement at least 368bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala * version 2.0 of the camera module interface (as defined by 378bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala * camera_module_t.common.module_api_version). 388bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala * 39567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * See camera_common.h for more versioning details. 408bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala * 418bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala */ 428bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala 438bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala__BEGIN_DECLS 448bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala 45fed0c0244b569e0bae4280af145a94ef3b1a1468Eino-Ville Talvalastruct camera2_device; 46fed0c0244b569e0bae4280af145a94ef3b1a1468Eino-Ville Talvala 47567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala/********************************************************************** 48567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 49567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Input/output stream buffer queue interface definitions 50567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 518bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala */ 528bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala 53567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala/** 54567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Output image stream queue interface. A set of these methods is provided to 55567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * the HAL device in allocate_stream(), and are used to interact with the 56567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * gralloc buffer queue for that stream. They may not be called until after 57567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * allocate_stream returns. 58567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala */ 598bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvalatypedef struct camera2_stream_ops { 60567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala /** 61567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Get a buffer to fill from the queue. The size and format of the buffer 62567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * are fixed for a given stream (defined in allocate_stream), and the stride 63567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * should be queried from the platform gralloc module. The gralloc buffer 64567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * will have been allocated based on the usage flags provided by 65567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * allocate_stream, and will be locked for use. 66567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala */ 6708a6e5e374c57361275173e18eea120587627adfEino-Ville Talvala int (*dequeue_buffer)(const struct camera2_stream_ops* w, 68567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala buffer_handle_t** buffer); 69567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala 70567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala /** 71567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Push a filled buffer to the stream to be used by the consumer. 72567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 73567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * The timestamp represents the time at start of exposure of the first row 74567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * of the image; it must be from a monotonic clock, and is measured in 75567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * nanoseconds. The timestamps do not need to be comparable between 76567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * different cameras, or consecutive instances of the same camera. However, 77567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * they must be comparable between streams from the same camera. If one 78567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * capture produces buffers for multiple streams, each stream must have the 79567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * same timestamp for that buffer, and that timestamp must match the 80567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * timestamp in the output frame metadata. 81567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala */ 8208a6e5e374c57361275173e18eea120587627adfEino-Ville Talvala int (*enqueue_buffer)(const struct camera2_stream_ops* w, 83567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala int64_t timestamp, 84567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala buffer_handle_t* buffer); 85567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala /** 86567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Return a buffer to the queue without marking it as filled. 87567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala */ 8808a6e5e374c57361275173e18eea120587627adfEino-Ville Talvala int (*cancel_buffer)(const struct camera2_stream_ops* w, 89567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala buffer_handle_t* buffer); 90567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala /** 91567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Set the crop window for subsequently enqueued buffers. The parameters are 92567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * measured in pixels relative to the buffer width and height. 93567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala */ 9408a6e5e374c57361275173e18eea120587627adfEino-Ville Talvala int (*set_crop)(const struct camera2_stream_ops *w, 95567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala int left, int top, int right, int bottom); 96567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala 978bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala} camera2_stream_ops_t; 988bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala 992388a2dc91979364d96e49456b189f904f0267f3Eino-Ville Talvala/** 1009633d506b798cfd44172f467b59b2305b19b9b00Eino-Ville Talvala * Temporary definition during transition. 1019633d506b798cfd44172f467b59b2305b19b9b00Eino-Ville Talvala * 1029633d506b798cfd44172f467b59b2305b19b9b00Eino-Ville Talvala * These formats will be removed and replaced with 1039633d506b798cfd44172f467b59b2305b19b9b00Eino-Ville Talvala * HAL_PIXEL_FORMAT_IMPLEMENTATION_DEFINED. To maximize forward compatibility, 1049633d506b798cfd44172f467b59b2305b19b9b00Eino-Ville Talvala * HAL implementations are strongly recommended to treat FORMAT_OPAQUE and 1059633d506b798cfd44172f467b59b2305b19b9b00Eino-Ville Talvala * FORMAT_ZSL as equivalent to HAL_PIXEL_FORMAT_IMPLEMENTATION_DEFINED, and 1069633d506b798cfd44172f467b59b2305b19b9b00Eino-Ville Talvala * return HAL_PIXEL_FORMAT_IMPLEMENTATION_DEFINED in the format_actual output 1079633d506b798cfd44172f467b59b2305b19b9b00Eino-Ville Talvala * parameter of allocate_stream, allowing the gralloc module to select the 1089633d506b798cfd44172f467b59b2305b19b9b00Eino-Ville Talvala * specific format based on the usage flags from the camera and the stream 1099633d506b798cfd44172f467b59b2305b19b9b00Eino-Ville Talvala * consumer. 1109633d506b798cfd44172f467b59b2305b19b9b00Eino-Ville Talvala */ 111567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvalaenum { 1129633d506b798cfd44172f467b59b2305b19b9b00Eino-Ville Talvala CAMERA2_HAL_PIXEL_FORMAT_OPAQUE = HAL_PIXEL_FORMAT_IMPLEMENTATION_DEFINED, 1139633d506b798cfd44172f467b59b2305b19b9b00Eino-Ville Talvala CAMERA2_HAL_PIXEL_FORMAT_ZSL = -1 114567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala}; 115567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala 116567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala/** 117ada3a97820dd48d513350d1365a3040d570bab6eEino-Ville Talvala * Transport header for compressed JPEG buffers in output streams. 118ada3a97820dd48d513350d1365a3040d570bab6eEino-Ville Talvala * 119ada3a97820dd48d513350d1365a3040d570bab6eEino-Ville Talvala * To capture JPEG images, a stream is created using the pixel format 120ada3a97820dd48d513350d1365a3040d570bab6eEino-Ville Talvala * HAL_PIXEL_FORMAT_BLOB, and the static metadata field android.jpeg.maxSize is 121ada3a97820dd48d513350d1365a3040d570bab6eEino-Ville Talvala * used as the buffer size. Since compressed JPEG images are of variable size, 122ada3a97820dd48d513350d1365a3040d570bab6eEino-Ville Talvala * the HAL needs to include the final size of the compressed image using this 123ada3a97820dd48d513350d1365a3040d570bab6eEino-Ville Talvala * structure inside the output stream buffer. The JPEG blob ID field must be set 124ada3a97820dd48d513350d1365a3040d570bab6eEino-Ville Talvala * to CAMERA2_JPEG_BLOB_ID. 125cecacd4e71c35fd50dbe1e9855cbab0faa17b550Alex Ray * 126cecacd4e71c35fd50dbe1e9855cbab0faa17b550Alex Ray * Transport header should be at the end of the JPEG output stream buffer. That 127cecacd4e71c35fd50dbe1e9855cbab0faa17b550Alex Ray * means the jpeg_blob_id must start at byte[android.jpeg.maxSize - 128cecacd4e71c35fd50dbe1e9855cbab0faa17b550Alex Ray * sizeof(camera2_jpeg_blob)]. Any HAL using this transport header must 129cecacd4e71c35fd50dbe1e9855cbab0faa17b550Alex Ray * account for it in android.jpeg.maxSize. The JPEG data itself starts at 130cecacd4e71c35fd50dbe1e9855cbab0faa17b550Alex Ray * byte[0] and should be jpeg_size bytes long. 131ada3a97820dd48d513350d1365a3040d570bab6eEino-Ville Talvala */ 132ada3a97820dd48d513350d1365a3040d570bab6eEino-Ville Talvalatypedef struct camera2_jpeg_blob { 133ada3a97820dd48d513350d1365a3040d570bab6eEino-Ville Talvala uint16_t jpeg_blob_id; 134ada3a97820dd48d513350d1365a3040d570bab6eEino-Ville Talvala uint32_t jpeg_size; 135ada3a97820dd48d513350d1365a3040d570bab6eEino-Ville Talvala}; 136ada3a97820dd48d513350d1365a3040d570bab6eEino-Ville Talvala 137ada3a97820dd48d513350d1365a3040d570bab6eEino-Ville Talvalaenum { 138ada3a97820dd48d513350d1365a3040d570bab6eEino-Ville Talvala CAMERA2_JPEG_BLOB_ID = 0x00FF 139ada3a97820dd48d513350d1365a3040d570bab6eEino-Ville Talvala}; 140ada3a97820dd48d513350d1365a3040d570bab6eEino-Ville Talvala 141ada3a97820dd48d513350d1365a3040d570bab6eEino-Ville Talvala/** 142567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Input reprocess stream queue management. A set of these methods is provided 143fa7a91d3d2a7f99612446f61beb29cc9e215d0baEino-Ville Talvala * to the HAL device in allocate_reprocess_stream(); they are used to interact 144fa7a91d3d2a7f99612446f61beb29cc9e215d0baEino-Ville Talvala * with the reprocess stream's input gralloc buffer queue. 145567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala */ 146567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvalatypedef struct camera2_stream_in_ops { 147567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala /** 148567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Get the next buffer of image data to reprocess. The width, height, and 149567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * format of the buffer is fixed in allocate_reprocess_stream(), and the 150567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * stride and other details should be queried from the platform gralloc 151567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * module as needed. The buffer will already be locked for use. 152567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala */ 15308a6e5e374c57361275173e18eea120587627adfEino-Ville Talvala int (*acquire_buffer)(const struct camera2_stream_in_ops *w, 154567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala buffer_handle_t** buffer); 155567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala /** 156567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Return a used buffer to the buffer queue for reuse. 157567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala */ 15808a6e5e374c57361275173e18eea120587627adfEino-Ville Talvala int (*release_buffer)(const struct camera2_stream_in_ops *w, 159567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala buffer_handle_t* buffer); 160567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala 161567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala} camera2_stream_in_ops_t; 162567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala 163567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala/********************************************************************** 164567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 1658bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala * Metadata queue management, used for requests sent to HAL module, and for 1668bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala * frames produced by the HAL. 167fed0c0244b569e0bae4280af145a94ef3b1a1468Eino-Ville Talvala * 168567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala */ 169567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala 170567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvalaenum { 171567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala CAMERA2_REQUEST_QUEUE_IS_BOTTOMLESS = -1 172567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala}; 173567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala 174567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala/** 175567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Request input queue protocol: 176fed0c0244b569e0bae4280af145a94ef3b1a1468Eino-Ville Talvala * 177567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * The framework holds the queue and its contents. At start, the queue is empty. 178fed0c0244b569e0bae4280af145a94ef3b1a1468Eino-Ville Talvala * 179567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 1. When the first metadata buffer is placed into the queue, the framework 180567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * signals the device by calling notify_request_queue_not_empty(). 181fed0c0244b569e0bae4280af145a94ef3b1a1468Eino-Ville Talvala * 182567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 2. After receiving notify_request_queue_not_empty, the device must call 183fed0c0244b569e0bae4280af145a94ef3b1a1468Eino-Ville Talvala * dequeue() once it's ready to handle the next buffer. 184fed0c0244b569e0bae4280af145a94ef3b1a1468Eino-Ville Talvala * 185567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 3. Once the device has processed a buffer, and is ready for the next buffer, 186567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * it must call dequeue() again instead of waiting for a notification. If 187567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * there are no more buffers available, dequeue() will return NULL. After 188567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * this point, when a buffer becomes available, the framework must call 189567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * notify_request_queue_not_empty() again. If the device receives a NULL 190567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * return from dequeue, it does not need to query the queue again until a 191567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * notify_request_queue_not_empty() call is received from the source. 192567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 193567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 4. If the device calls buffer_count() and receives 0, this does not mean that 194567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * the framework will provide a notify_request_queue_not_empty() call. The 195567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * framework will only provide such a notification after the device has 196567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * received a NULL from dequeue, or on initial startup. 197fed0c0244b569e0bae4280af145a94ef3b1a1468Eino-Ville Talvala * 198567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 5. The dequeue() call in response to notify_request_queue_not_empty() may be 199567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * on the same thread as the notify_request_queue_not_empty() call, and may 200567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * be performed from within the notify call. 201fed0c0244b569e0bae4280af145a94ef3b1a1468Eino-Ville Talvala * 202567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 6. All dequeued request buffers must be returned to the framework by calling 203567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * free_request, including when errors occur, a device flush is requested, or 204567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * when the device is shutting down. 2058bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala */ 206567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvalatypedef struct camera2_request_queue_src_ops { 2078bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala /** 208567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Get the count of request buffers pending in the queue. May return 209567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * CAMERA2_REQUEST_QUEUE_IS_BOTTOMLESS if a repeating request (stream 210567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * request) is currently configured. Calling this method has no effect on 211567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * whether the notify_request_queue_not_empty() method will be called by the 212567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * framework. 2138bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala */ 21408a6e5e374c57361275173e18eea120587627adfEino-Ville Talvala int (*request_count)(const struct camera2_request_queue_src_ops *q); 2158bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala 2168bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala /** 217567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Get a metadata buffer from the framework. Returns OK if there is no 218567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * error. If the queue is empty, returns NULL in buffer. In that case, the 219567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * device must wait for a notify_request_queue_not_empty() message before 220567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * attempting to dequeue again. Buffers obtained in this way must be 221567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * returned to the framework with free_request(). 2228bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala */ 22308a6e5e374c57361275173e18eea120587627adfEino-Ville Talvala int (*dequeue_request)(const struct camera2_request_queue_src_ops *q, 2248bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala camera_metadata_t **buffer); 2258bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala /** 226567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Return a metadata buffer to the framework once it has been used, or if 227567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * an error or shutdown occurs. 2288bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala */ 22908a6e5e374c57361275173e18eea120587627adfEino-Ville Talvala int (*free_request)(const struct camera2_request_queue_src_ops *q, 2308bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala camera_metadata_t *old_buffer); 2318bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala 232567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala} camera2_request_queue_src_ops_t; 2338bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala 234567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala/** 235567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Frame output queue protocol: 236567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 237567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * The framework holds the queue and its contents. At start, the queue is empty. 238567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 239567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 1. When the device is ready to fill an output metadata frame, it must dequeue 240567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * a metadata buffer of the required size. 241567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 242567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 2. It should then fill the metadata buffer, and place it on the frame queue 243567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * using enqueue_frame. The framework takes ownership of the frame. 244567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 245567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 3. In case of an error, a request to flush the pipeline, or shutdown, the 246567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * device must return any affected dequeued frames to the framework by 247567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * calling cancel_frame. 248567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala */ 249567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvalatypedef struct camera2_frame_queue_dst_ops { 2508bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala /** 251567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Get an empty metadata buffer to fill from the framework. The new metadata 252567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * buffer will have room for entries number of metadata entries, plus 253567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * data_bytes worth of extra storage. Frames dequeued here must be returned 254567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * to the framework with either cancel_frame or enqueue_frame. 2558bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala */ 25608a6e5e374c57361275173e18eea120587627adfEino-Ville Talvala int (*dequeue_frame)(const struct camera2_frame_queue_dst_ops *q, 257567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala size_t entries, size_t data_bytes, 258567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala camera_metadata_t **buffer); 259fed0c0244b569e0bae4280af145a94ef3b1a1468Eino-Ville Talvala 260567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala /** 261567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Return a dequeued metadata buffer to the framework for reuse; do not mark it as 262567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * filled. Use when encountering errors, or flushing the internal request queue. 263567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala */ 26408a6e5e374c57361275173e18eea120587627adfEino-Ville Talvala int (*cancel_frame)(const struct camera2_frame_queue_dst_ops *q, 265567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala camera_metadata_t *buffer); 2668bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala 267567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala /** 268567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Place a completed metadata frame on the frame output queue. 269567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala */ 27008a6e5e374c57361275173e18eea120587627adfEino-Ville Talvala int (*enqueue_frame)(const struct camera2_frame_queue_dst_ops *q, 271567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala camera_metadata_t *buffer); 272567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala 273567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala} camera2_frame_queue_dst_ops_t; 274567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala 275567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala/********************************************************************** 276567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 277567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Notification callback and message definition, and trigger definitions 278567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 279567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala */ 2808bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala 2818bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala/** 2828bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala * Asynchronous notification callback from the HAL, fired for various 2838bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala * reasons. Only for information independent of frame capture, or that require 284567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * specific timing. The user pointer must be the same one that was passed to the 285567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * device in set_notify_callback(). 2868bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala */ 2878bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvalatypedef void (*camera2_notify_callback)(int32_t msg_type, 2888bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala int32_t ext1, 2898bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala int32_t ext2, 290567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala int32_t ext3, 2918bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala void *user); 2928bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala 2938bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala/** 2948bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala * Possible message types for camera2_notify_callback 2958bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala */ 2968bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvalaenum { 2978bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala /** 298567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * An error has occurred. Argument ext1 contains the error code, and 299567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * ext2 and ext3 contain any error-specific information. 3008bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala */ 301daacbf40167040991382009523cb29a60b02abf2Eino-Ville Talvala CAMERA2_MSG_ERROR = 0x0001, 3028bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala /** 3038bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala * The exposure of a given request has begun. Argument ext1 contains the 304567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * frame number, and ext2 and ext3 contain the low-order and high-order 305567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * bytes of the timestamp for when exposure began. 306567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * (timestamp = (ext3 << 32 | ext2)) 307567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala */ 308567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala CAMERA2_MSG_SHUTTER = 0x0010, 309567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala /** 310567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * The autofocus routine has changed state. Argument ext1 contains the new 311567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * state; the values are the same as those for the metadata field 312f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * android.control.afState. Ext2 contains the latest trigger ID passed to 313f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * trigger_action(CAMERA2_TRIGGER_AUTOFOCUS) or 314f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * trigger_action(CAMERA2_TRIGGER_CANCEL_AUTOFOCUS), or 0 if trigger has not 315f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * been called with either of those actions. 3168bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala */ 317567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala CAMERA2_MSG_AUTOFOCUS = 0x0020, 318567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala /** 319567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * The autoexposure routine has changed state. Argument ext1 contains the 320567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * new state; the values are the same as those for the metadata field 321f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * android.control.aeState. Ext2 contains the latest trigger ID value passed to 322567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * trigger_action(CAMERA2_TRIGGER_PRECAPTURE_METERING), or 0 if that method 323567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * has not been called. 324567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala */ 325567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala CAMERA2_MSG_AUTOEXPOSURE = 0x0021, 326567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala /** 327567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * The auto-whitebalance routine has changed state. Argument ext1 contains 328567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * the new state; the values are the same as those for the metadata field 329f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * android.control.awbState. Ext2 contains the latest trigger ID passed to 330f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * trigger_action(CAMERA2_TRIGGER_PRECAPTURE_METERING), or 0 if that method 331f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * has not been called. 332567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala */ 333567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala CAMERA2_MSG_AUTOWB = 0x0022 3348bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala}; 3358bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala 3368bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala/** 3378bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala * Error codes for CAMERA_MSG_ERROR 3388bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala */ 3398bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvalaenum { 3408bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala /** 3418bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala * A serious failure occured. Camera device may not work without reboot, and 3428bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala * no further frames or buffer streams will be produced by the 3438bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala * device. Device should be treated as closed. 3448bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala */ 345567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala CAMERA2_MSG_ERROR_HARDWARE = 0x0001, 3468bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala /** 3478bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala * A serious failure occured. No further frames or buffer streams will be 3488bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala * produced by the device. Device should be treated as closed. The client 3498bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala * must reopen the device to use it again. 3508bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala */ 351567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala CAMERA2_MSG_ERROR_DEVICE, 3528bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala /** 353567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * An error has occurred in processing a request. No output (metadata or 354567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * buffers) will be produced for this request. ext2 contains the frame 355567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * number of the request. Subsequent requests are unaffected, and the device 356567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * remains operational. 3578bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala */ 358567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala CAMERA2_MSG_ERROR_REQUEST, 359567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala /** 360567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * An error has occurred in producing an output frame metadata buffer for a 361567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * request, but image buffers for it will still be available. Subsequent 362567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * requests are unaffected, and the device remains operational. ext2 363567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * contains the frame number of the request. 364567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala */ 365567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala CAMERA2_MSG_ERROR_FRAME, 366567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala /** 367567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * An error has occurred in placing an output buffer into a stream for a 368567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * request. The frame metadata and other buffers may still be 369567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * available. Subsequent requests are unaffected, and the device remains 370567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * operational. ext2 contains the frame number of the request, and ext3 371567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * contains the stream id. 372567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala */ 373567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala CAMERA2_MSG_ERROR_STREAM, 374567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala /** 375567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Number of error types 376567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala */ 377567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala CAMERA2_MSG_NUM_ERRORS 3788bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala}; 3798bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala 380567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala/** 381567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Possible trigger ids for trigger_action() 382567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala */ 383567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvalaenum { 3848bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala /** 385567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Trigger an autofocus cycle. The effect of the trigger depends on the 386567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * autofocus mode in effect when the trigger is received, which is the mode 387f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * listed in the latest capture request to be dequeued by the HAL. If the 388f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * mode is OFF, EDOF, or FIXED, the trigger has no effect. In AUTO, MACRO, 389f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * or CONTINUOUS_* modes, see below for the expected behavior. The state of 390567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * the autofocus cycle can be tracked in android.control.afMode and the 391f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * corresponding notifications. 392f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * 393f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala ** 394f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * In AUTO or MACRO mode, the AF state transitions (and notifications) 395f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * when calling with trigger ID = N with the previous ID being K are: 396f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * 397f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * Initial state Transitions 398f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * INACTIVE (K) -> ACTIVE_SCAN (N) -> AF_FOCUSED (N) or AF_NOT_FOCUSED (N) 399f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * AF_FOCUSED (K) -> ACTIVE_SCAN (N) -> AF_FOCUSED (N) or AF_NOT_FOCUSED (N) 400f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * AF_NOT_FOCUSED (K) -> ACTIVE_SCAN (N) -> AF_FOCUSED (N) or AF_NOT_FOCUSED (N) 401f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * ACTIVE_SCAN (K) -> AF_FOCUSED(N) or AF_NOT_FOCUSED(N) 402f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * PASSIVE_SCAN (K) Not used in AUTO/MACRO mode 403f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * PASSIVE_FOCUSED (K) Not used in AUTO/MACRO mode 404f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * 405f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala ** 406f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * In CONTINUOUS_PICTURE mode, triggering AF must lock the AF to the current 407f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * lens position and transition the AF state to either AF_FOCUSED or 408f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * NOT_FOCUSED. If a passive scan is underway, that scan must complete and 409f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * then lock the lens position and change AF state. TRIGGER_CANCEL_AUTOFOCUS 410f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * will allow the AF to restart its operation. 411f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * 412f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * Initial state Transitions 413f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * INACTIVE (K) -> immediate AF_FOCUSED (N) or AF_NOT_FOCUSED (N) 414f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * PASSIVE_FOCUSED (K) -> immediate AF_FOCUSED (N) or AF_NOT_FOCUSED (N) 415f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * PASSIVE_SCAN (K) -> AF_FOCUSED (N) or AF_NOT_FOCUSED (N) 416f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * AF_FOCUSED (K) no effect except to change next notification ID to N 417f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * AF_NOT_FOCUSED (K) no effect except to change next notification ID to N 418f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * 419f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala ** 420f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * In CONTINUOUS_VIDEO mode, triggering AF must lock the AF to the current 421f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * lens position and transition the AF state to either AF_FOCUSED or 422f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * NOT_FOCUSED. If a passive scan is underway, it must immediately halt, in 423f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * contrast with CONTINUOUS_PICTURE mode. TRIGGER_CANCEL_AUTOFOCUS will 424f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * allow the AF to restart its operation. 425f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * 426f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * Initial state Transitions 427f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * INACTIVE (K) -> immediate AF_FOCUSED (N) or AF_NOT_FOCUSED (N) 428f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * PASSIVE_FOCUSED (K) -> immediate AF_FOCUSED (N) or AF_NOT_FOCUSED (N) 429f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * PASSIVE_SCAN (K) -> immediate AF_FOCUSED (N) or AF_NOT_FOCUSED (N) 430f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * AF_FOCUSED (K) no effect except to change next notification ID to N 431f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * AF_NOT_FOCUSED (K) no effect except to change next notification ID to N 432f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * 433f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * Ext1 is an ID that must be returned in subsequent auto-focus state change 434f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * notifications through camera2_notify_callback() and stored in 435f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * android.control.afTriggerId. 4368bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala */ 437567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala CAMERA2_TRIGGER_AUTOFOCUS = 0x0001, 438567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala /** 439f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * Send a cancel message to the autofocus algorithm. The effect of the 440f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * cancellation depends on the autofocus mode in effect when the trigger is 441f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * received, which is the mode listed in the latest capture request to be 442f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * dequeued by the HAL. If the AF mode is OFF or EDOF, the cancel has no 443f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * effect. For other modes, the lens should return to its default position, 444f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * any current autofocus scan must be canceled, and the AF state should be 445f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * set to INACTIVE. 446f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * 447f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * The state of the autofocus cycle can be tracked in android.control.afMode 448f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * and the corresponding notification. Continuous autofocus modes may resume 449f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * focusing operations thereafter exactly as if the camera had just been set 450f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * to a continuous AF mode. 451f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * 452f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * Ext1 is an ID that must be returned in subsequent auto-focus state change 453f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * notifications through camera2_notify_callback() and stored in 454f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * android.control.afTriggerId. 455f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala */ 456f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala CAMERA2_TRIGGER_CANCEL_AUTOFOCUS, 457f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala /** 458567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Trigger a pre-capture metering cycle, which may include firing the flash 459567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * to determine proper capture parameters. Typically, this trigger would be 460567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * fired for a half-depress of a camera shutter key, or before a snapshot 461567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * capture in general. The state of the metering cycle can be tracked in 462567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * android.control.aeMode and the corresponding notification. If the 463f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * auto-exposure mode is OFF, the trigger does nothing. 464f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * 465f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * Ext1 is an ID that must be returned in subsequent 466f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * auto-exposure/auto-white balance state change notifications through 467f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * camera2_notify_callback() and stored in android.control.aePrecaptureId. 468567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala */ 469567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala CAMERA2_TRIGGER_PRECAPTURE_METERING 470567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala}; 4718bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala 472567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala/** 473567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Possible template types for construct_default_request() 474567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala */ 475567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvalaenum { 4768bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala /** 477567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Standard camera preview operation with 3A on auto. 4788bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala */ 479567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala CAMERA2_TEMPLATE_PREVIEW = 1, 480567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala /** 481567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Standard camera high-quality still capture with 3A and flash on auto. 482567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala */ 483567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala CAMERA2_TEMPLATE_STILL_CAPTURE, 484567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala /** 485567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Standard video recording plus preview with 3A on auto, torch off. 486567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala */ 487567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala CAMERA2_TEMPLATE_VIDEO_RECORD, 488567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala /** 489567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * High-quality still capture while recording video. Application will 490567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * include preview, video record, and full-resolution YUV or JPEG streams in 491567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * request. Must not cause stuttering on video stream. 3A on auto. 492567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala */ 493567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala CAMERA2_TEMPLATE_VIDEO_SNAPSHOT, 494567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala /** 495567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Zero-shutter-lag mode. Application will request preview and 496f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala * full-resolution data for each frame, and reprocess it to JPEG when a 497567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * still image is requested by user. Settings should provide highest-quality 498567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * full-resolution images without compromising preview frame rate. 3A on 499567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * auto. 500567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala */ 5016adfd6b8ce32f042d001296f08e5b439af2635c1Eino-Ville Talvala CAMERA2_TEMPLATE_ZERO_SHUTTER_LAG, 5026adfd6b8ce32f042d001296f08e5b439af2635c1Eino-Ville Talvala 5036adfd6b8ce32f042d001296f08e5b439af2635c1Eino-Ville Talvala /* Total number of templates */ 5046adfd6b8ce32f042d001296f08e5b439af2635c1Eino-Ville Talvala CAMERA2_TEMPLATE_COUNT 505567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala}; 5068bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala 507567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala 508567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala/********************************************************************** 509567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 510567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Camera device operations 511567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 512567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala */ 513567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvalatypedef struct camera2_device_ops { 514567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala 515567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala /********************************************************************** 516567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Request and frame queue setup and management methods 517567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala */ 5188bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala 5198bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala /** 520567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Pass in input request queue interface methods. 5218bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala */ 52208a6e5e374c57361275173e18eea120587627adfEino-Ville Talvala int (*set_request_queue_src_ops)(const struct camera2_device *, 52308a6e5e374c57361275173e18eea120587627adfEino-Ville Talvala const camera2_request_queue_src_ops_t *request_src_ops); 5248bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala 525567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala /** 526567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Notify device that the request queue is no longer empty. Must only be 527567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * called when the first buffer is added a new queue, or after the source 528567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * has returned NULL in response to a dequeue call. 529567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala */ 53008a6e5e374c57361275173e18eea120587627adfEino-Ville Talvala int (*notify_request_queue_not_empty)(const struct camera2_device *); 5318bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala 5328bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala /** 533567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Pass in output frame queue interface methods 5348bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala */ 53508a6e5e374c57361275173e18eea120587627adfEino-Ville Talvala int (*set_frame_queue_dst_ops)(const struct camera2_device *, 53608a6e5e374c57361275173e18eea120587627adfEino-Ville Talvala const camera2_frame_queue_dst_ops_t *frame_dst_ops); 5378bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala 5388bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala /** 539567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Number of camera requests being processed by the device at the moment 540567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * (captures/reprocesses that have had their request dequeued, but have not 541567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * yet been enqueued onto output pipeline(s) ). No streams may be released 542567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * by the framework until the in-progress count is 0. 5438bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala */ 54408a6e5e374c57361275173e18eea120587627adfEino-Ville Talvala int (*get_in_progress_count)(const struct camera2_device *); 5458bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala 5468bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala /** 5478bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala * Flush all in-progress captures. This includes all dequeued requests 5488bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala * (regular or reprocessing) that have not yet placed any outputs into a 5498bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala * stream or the frame queue. Partially completed captures must be completed 550567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * normally. No new requests may be dequeued from the request queue until 551567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * the flush completes. 5528bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala */ 55308a6e5e374c57361275173e18eea120587627adfEino-Ville Talvala int (*flush_captures_in_progress)(const struct camera2_device *); 5548bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala 5558bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala /** 556567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Create a filled-in default request for standard camera use cases. 557567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 558567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * The device must return a complete request that is configured to meet the 559567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * requested use case, which must be one of the CAMERA2_TEMPLATE_* 560567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * enums. All request control fields must be included, except for 561fa7a91d3d2a7f99612446f61beb29cc9e215d0baEino-Ville Talvala * android.request.outputStreams. 562567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 563567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * The metadata buffer returned must be allocated with 564567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * allocate_camera_metadata. The framework takes ownership of the buffer. 5658bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala */ 56608a6e5e374c57361275173e18eea120587627adfEino-Ville Talvala int (*construct_default_request)(const struct camera2_device *, 567567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala int request_template, 568567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala camera_metadata_t **request); 5698bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala 570567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala /********************************************************************** 571567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Stream management 5728bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala */ 5738bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala 5748bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala /** 575567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * allocate_stream: 576567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 577567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Allocate a new output stream for use, defined by the output buffer width, 578567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * height, target, and possibly the pixel format. Returns the new stream's 579567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * ID, gralloc usage flags, minimum queue buffer count, and possibly the 580567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * pixel format, on success. Error conditions: 581567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 582567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * - Requesting a width/height/format combination not listed as 583567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * supported by the sensor's static characteristics 584567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 585567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * - Asking for too many streams of a given format type (2 bayer raw 586567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * streams, for example). 587567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 588567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Input parameters: 589567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 590567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * - width, height, format: Specification for the buffers to be sent through 5912388a2dc91979364d96e49456b189f904f0267f3Eino-Ville Talvala * this stream. Format is a value from the HAL_PIXEL_FORMAT_* list. If 5922388a2dc91979364d96e49456b189f904f0267f3Eino-Ville Talvala * HAL_PIXEL_FORMAT_IMPLEMENTATION_DEFINED is used, then the platform 5932388a2dc91979364d96e49456b189f904f0267f3Eino-Ville Talvala * gralloc module will select a format based on the usage flags provided 5942388a2dc91979364d96e49456b189f904f0267f3Eino-Ville Talvala * by the camera HAL and the consumer of the stream. The camera HAL should 5952388a2dc91979364d96e49456b189f904f0267f3Eino-Ville Talvala * inspect the buffers handed to it in the register_stream_buffers call to 5962388a2dc91979364d96e49456b189f904f0267f3Eino-Ville Talvala * obtain the implementation-specific format if necessary. 597567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 598567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * - stream_ops: A structure of function pointers for obtaining and queuing 599567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * up buffers for this stream. The underlying stream will be configured 600567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * based on the usage and max_buffers outputs. The methods in this 601567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * structure may not be called until after allocate_stream returns. 602567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 603567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Output parameters: 604567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 605567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * - stream_id: An unsigned integer identifying this stream. This value is 606567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * used in incoming requests to identify the stream, and in releasing the 607567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * stream. 608567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 609567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * - usage: The gralloc usage mask needed by the HAL device for producing 610567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * the requested type of data. This is used in allocating new gralloc 611567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * buffers for the stream buffer queue. 612567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 613567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * - max_buffers: The maximum number of buffers the HAL device may need to 614567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * have dequeued at the same time. The device may not dequeue more buffers 615567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * than this value at the same time. 616567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 6178bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala */ 618567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala int (*allocate_stream)( 61908a6e5e374c57361275173e18eea120587627adfEino-Ville Talvala const struct camera2_device *, 620567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala // inputs 621567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala uint32_t width, 622567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala uint32_t height, 623567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala int format, 62408a6e5e374c57361275173e18eea120587627adfEino-Ville Talvala const camera2_stream_ops_t *stream_ops, 625567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala // outputs 626567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala uint32_t *stream_id, 6272388a2dc91979364d96e49456b189f904f0267f3Eino-Ville Talvala uint32_t *format_actual, // IGNORED, will be removed 628567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala uint32_t *usage, 629567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala uint32_t *max_buffers); 6308bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala 6318bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala /** 632567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Register buffers for a given stream. This is called after a successful 633567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * allocate_stream call, and before the first request referencing the stream 634567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * is enqueued. This method is intended to allow the HAL device to map or 635567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * otherwise prepare the buffers for later use. num_buffers is guaranteed to 636567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * be at least max_buffers (from allocate_stream), but may be larger. The 637567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * buffers will already be locked for use. At the end of the call, all the 6382388a2dc91979364d96e49456b189f904f0267f3Eino-Ville Talvala * buffers must be ready to be returned to the queue. If the stream format 6392388a2dc91979364d96e49456b189f904f0267f3Eino-Ville Talvala * was set to HAL_PIXEL_FORMAT_IMPLEMENTATION_DEFINED, the camera HAL should 6402388a2dc91979364d96e49456b189f904f0267f3Eino-Ville Talvala * inspect the passed-in buffers here to determine any platform-private 6412388a2dc91979364d96e49456b189f904f0267f3Eino-Ville Talvala * pixel format information. 6428bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala */ 643567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala int (*register_stream_buffers)( 64408a6e5e374c57361275173e18eea120587627adfEino-Ville Talvala const struct camera2_device *, 645567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala uint32_t stream_id, 646567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala int num_buffers, 647567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala buffer_handle_t *buffers); 6488bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala 6498bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala /** 650567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Release a stream. Returns an error if called when get_in_progress_count 651567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * is non-zero, or if the stream id is invalid. 6528bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala */ 6538bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala int (*release_stream)( 65408a6e5e374c57361275173e18eea120587627adfEino-Ville Talvala const struct camera2_device *, 655567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala uint32_t stream_id); 656567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala 657567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala /** 658567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * allocate_reprocess_stream: 659567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 660567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Allocate a new input stream for use, defined by the output buffer width, 661567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * height, and the pixel format. Returns the new stream's ID, gralloc usage 662567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * flags, and required simultaneously acquirable buffer count, on 663567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * success. Error conditions: 664567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 665567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * - Requesting a width/height/format combination not listed as 666567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * supported by the sensor's static characteristics 667567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 668567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * - Asking for too many reprocessing streams to be configured at once. 669567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 670567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Input parameters: 671567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 672567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * - width, height, format: Specification for the buffers to be sent through 673567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * this stream. Format must be a value from the HAL_PIXEL_FORMAT_* list. 674567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 675567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * - reprocess_stream_ops: A structure of function pointers for acquiring 676567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * and releasing buffers for this stream. The underlying stream will be 677567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * configured based on the usage and max_buffers outputs. 678567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 679567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Output parameters: 680567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 681567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * - stream_id: An unsigned integer identifying this stream. This value is 682567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * used in incoming requests to identify the stream, and in releasing the 683567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * stream. These ids are numbered separately from the input stream ids. 684567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 685567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * - consumer_usage: The gralloc usage mask needed by the HAL device for 686567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * consuming the requested type of data. This is used in allocating new 687567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * gralloc buffers for the stream buffer queue. 688567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 689567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * - max_buffers: The maximum number of buffers the HAL device may need to 690567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * have acquired at the same time. The device may not have more buffers 691567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * acquired at the same time than this value. 692567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 693567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala */ 69408a6e5e374c57361275173e18eea120587627adfEino-Ville Talvala int (*allocate_reprocess_stream)(const struct camera2_device *, 695567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala uint32_t width, 696567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala uint32_t height, 697567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala uint32_t format, 69808a6e5e374c57361275173e18eea120587627adfEino-Ville Talvala const camera2_stream_in_ops_t *reprocess_stream_ops, 699567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala // outputs 700567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala uint32_t *stream_id, 701567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala uint32_t *consumer_usage, 702567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala uint32_t *max_buffers); 703567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala 704567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala /** 7057f8dd0ad2d3d40b57c8359971a351fd194668613Eino-Ville Talvala * allocate_reprocess_stream_from_stream: 7067f8dd0ad2d3d40b57c8359971a351fd194668613Eino-Ville Talvala * 7077f8dd0ad2d3d40b57c8359971a351fd194668613Eino-Ville Talvala * Allocate a new input stream for use, which will use the buffers allocated 7087f8dd0ad2d3d40b57c8359971a351fd194668613Eino-Ville Talvala * for an existing output stream. That is, after the HAL enqueues a buffer 7097f8dd0ad2d3d40b57c8359971a351fd194668613Eino-Ville Talvala * onto the output stream, it may see that same buffer handed to it from 7107f8dd0ad2d3d40b57c8359971a351fd194668613Eino-Ville Talvala * this input reprocessing stream. After the HAL releases the buffer back to 7117f8dd0ad2d3d40b57c8359971a351fd194668613Eino-Ville Talvala * the reprocessing stream, it will be returned to the output queue for 7127f8dd0ad2d3d40b57c8359971a351fd194668613Eino-Ville Talvala * reuse. 7137f8dd0ad2d3d40b57c8359971a351fd194668613Eino-Ville Talvala * 7147f8dd0ad2d3d40b57c8359971a351fd194668613Eino-Ville Talvala * Error conditions: 7157f8dd0ad2d3d40b57c8359971a351fd194668613Eino-Ville Talvala * 7167f8dd0ad2d3d40b57c8359971a351fd194668613Eino-Ville Talvala * - Using an output stream of unsuitable size/format for the basis of the 7177f8dd0ad2d3d40b57c8359971a351fd194668613Eino-Ville Talvala * reprocessing stream. 7187f8dd0ad2d3d40b57c8359971a351fd194668613Eino-Ville Talvala * 7197f8dd0ad2d3d40b57c8359971a351fd194668613Eino-Ville Talvala * - Attempting to allocatee too many reprocessing streams at once. 7207f8dd0ad2d3d40b57c8359971a351fd194668613Eino-Ville Talvala * 7217f8dd0ad2d3d40b57c8359971a351fd194668613Eino-Ville Talvala * Input parameters: 7227f8dd0ad2d3d40b57c8359971a351fd194668613Eino-Ville Talvala * 7237f8dd0ad2d3d40b57c8359971a351fd194668613Eino-Ville Talvala * - output_stream_id: The ID of an existing output stream which has 7247f8dd0ad2d3d40b57c8359971a351fd194668613Eino-Ville Talvala * a size and format suitable for reprocessing. 7257f8dd0ad2d3d40b57c8359971a351fd194668613Eino-Ville Talvala * 7267f8dd0ad2d3d40b57c8359971a351fd194668613Eino-Ville Talvala * - reprocess_stream_ops: A structure of function pointers for acquiring 7277f8dd0ad2d3d40b57c8359971a351fd194668613Eino-Ville Talvala * and releasing buffers for this stream. The underlying stream will use 7287f8dd0ad2d3d40b57c8359971a351fd194668613Eino-Ville Talvala * the same graphics buffer handles as the output stream uses. 7297f8dd0ad2d3d40b57c8359971a351fd194668613Eino-Ville Talvala * 7307f8dd0ad2d3d40b57c8359971a351fd194668613Eino-Ville Talvala * Output parameters: 7317f8dd0ad2d3d40b57c8359971a351fd194668613Eino-Ville Talvala * 7327f8dd0ad2d3d40b57c8359971a351fd194668613Eino-Ville Talvala * - stream_id: An unsigned integer identifying this stream. This value is 7337f8dd0ad2d3d40b57c8359971a351fd194668613Eino-Ville Talvala * used in incoming requests to identify the stream, and in releasing the 7347f8dd0ad2d3d40b57c8359971a351fd194668613Eino-Ville Talvala * stream. These ids are numbered separately from the input stream ids. 7357f8dd0ad2d3d40b57c8359971a351fd194668613Eino-Ville Talvala * 7367f8dd0ad2d3d40b57c8359971a351fd194668613Eino-Ville Talvala * The HAL client must always release the reprocessing stream before it 7377f8dd0ad2d3d40b57c8359971a351fd194668613Eino-Ville Talvala * releases the output stream it is based on. 7387f8dd0ad2d3d40b57c8359971a351fd194668613Eino-Ville Talvala * 7397f8dd0ad2d3d40b57c8359971a351fd194668613Eino-Ville Talvala */ 7407f8dd0ad2d3d40b57c8359971a351fd194668613Eino-Ville Talvala int (*allocate_reprocess_stream_from_stream)(const struct camera2_device *, 7417f8dd0ad2d3d40b57c8359971a351fd194668613Eino-Ville Talvala uint32_t output_stream_id, 7427f8dd0ad2d3d40b57c8359971a351fd194668613Eino-Ville Talvala const camera2_stream_in_ops_t *reprocess_stream_ops, 7437f8dd0ad2d3d40b57c8359971a351fd194668613Eino-Ville Talvala // outputs 7447f8dd0ad2d3d40b57c8359971a351fd194668613Eino-Ville Talvala uint32_t *stream_id); 7457f8dd0ad2d3d40b57c8359971a351fd194668613Eino-Ville Talvala 7467f8dd0ad2d3d40b57c8359971a351fd194668613Eino-Ville Talvala /** 747567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Release a reprocessing stream. Returns an error if called when 748567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * get_in_progress_count is non-zero, or if the stream id is not 749567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * valid. 750567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala */ 751567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala int (*release_reprocess_stream)( 75208a6e5e374c57361275173e18eea120587627adfEino-Ville Talvala const struct camera2_device *, 753567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala uint32_t stream_id); 754567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala 755567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala /********************************************************************** 756567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Miscellaneous methods 757567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala */ 758567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala 759567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala /** 760567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Trigger asynchronous activity. This is used for triggering special 761567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * behaviors of the camera 3A routines when they are in use. See the 762567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * documentation for CAMERA2_TRIGGER_* above for details of the trigger ids 763567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * and their arguments. 764567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala */ 76508a6e5e374c57361275173e18eea120587627adfEino-Ville Talvala int (*trigger_action)(const struct camera2_device *, 766567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala uint32_t trigger_id, 767f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala int32_t ext1, 768f7a60c464a03f251deb87489d48d2249e6d31ff2Eino-Ville Talvala int32_t ext2); 769567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala 770567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala /** 771567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Notification callback setup 772567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala */ 77308a6e5e374c57361275173e18eea120587627adfEino-Ville Talvala int (*set_notify_callback)(const struct camera2_device *, 774567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala camera2_notify_callback notify_cb, 775567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala void *user); 7768bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala 7778bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala /** 778fed0c0244b569e0bae4280af145a94ef3b1a1468Eino-Ville Talvala * Get methods to query for vendor extension metadata tag infomation. May 779fed0c0244b569e0bae4280af145a94ef3b1a1468Eino-Ville Talvala * set ops to NULL if no vendor extension tags are defined. 780fed0c0244b569e0bae4280af145a94ef3b1a1468Eino-Ville Talvala */ 78108a6e5e374c57361275173e18eea120587627adfEino-Ville Talvala int (*get_metadata_vendor_tag_ops)(const struct camera2_device*, 782fed0c0244b569e0bae4280af145a94ef3b1a1468Eino-Ville Talvala vendor_tag_query_ops_t **ops); 783fed0c0244b569e0bae4280af145a94ef3b1a1468Eino-Ville Talvala 784fed0c0244b569e0bae4280af145a94ef3b1a1468Eino-Ville Talvala /** 7858bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala * Dump state of the camera hardware 7868bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala */ 78708a6e5e374c57361275173e18eea120587627adfEino-Ville Talvala int (*dump)(const struct camera2_device *, int fd); 7888bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala 7898bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala} camera2_device_ops_t; 7908bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala 791567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala/********************************************************************** 792567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 793567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * Camera device definition 794567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala * 795567b4a24fa9fedf0086af5e0bb8e45bd3294bc9dEino-Ville Talvala */ 7968bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvalatypedef struct camera2_device { 7978bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala /** 798ddc026e39344169f64f4696174a4d1269d069557Eino-Ville Talvala * common.version must equal CAMERA_DEVICE_API_VERSION_2_0 to identify 7998bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala * this device as implementing version 2.0 of the camera device HAL. 8008bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala */ 8018bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala hw_device_t common; 8028bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala camera2_device_ops_t *ops; 8038bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala void *priv; 8048bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala} camera2_device_t; 8058bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala 8068bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala__END_DECLS 8078bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala 8088bf364ef20331ebcc23b1f72121434a98bc5c567Eino-Ville Talvala#endif /* #ifdef ANDROID_INCLUDE_CAMERA2_H */ 809