diff options
Diffstat (limited to 'drivers/staging/media/atomisp/pci/atomisp2/css2400/ia_css_frame_public.h')
-rw-r--r-- | drivers/staging/media/atomisp/pci/atomisp2/css2400/ia_css_frame_public.h | 352 |
1 files changed, 0 insertions, 352 deletions
diff --git a/drivers/staging/media/atomisp/pci/atomisp2/css2400/ia_css_frame_public.h b/drivers/staging/media/atomisp/pci/atomisp2/css2400/ia_css_frame_public.h deleted file mode 100644 index 0beb7347a4f3..000000000000 --- a/drivers/staging/media/atomisp/pci/atomisp2/css2400/ia_css_frame_public.h +++ /dev/null @@ -1,352 +0,0 @@ -/* - * Support for Intel Camera Imaging ISP subsystem. - * Copyright (c) 2015, Intel Corporation. - * - * This program is free software; you can redistribute it and/or modify it - * under the terms and conditions of the GNU General Public License, - * version 2, as published by the Free Software Foundation. - * - * This program is distributed in the hope it will be useful, but WITHOUT - * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or - * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for - * more details. - */ - -#ifndef __IA_CSS_FRAME_PUBLIC_H -#define __IA_CSS_FRAME_PUBLIC_H - -/* @file - * This file contains structs to describe various frame-formats supported by the ISP. - */ - -#include <type_support.h> -#include "ia_css_err.h" -#include "ia_css_types.h" -#include "ia_css_frame_format.h" -#include "ia_css_buffer.h" - -/* For RAW input, the bayer order needs to be specified separately. There - * are 4 possible orders. The name is constructed by taking the first two - * colors on the first line and the first two colors from the second line. - */ -enum ia_css_bayer_order { - IA_CSS_BAYER_ORDER_GRBG, /** GRGRGRGRGR .. BGBGBGBGBG */ - IA_CSS_BAYER_ORDER_RGGB, /** RGRGRGRGRG .. GBGBGBGBGB */ - IA_CSS_BAYER_ORDER_BGGR, /** BGBGBGBGBG .. GRGRGRGRGR */ - IA_CSS_BAYER_ORDER_GBRG, /** GBGBGBGBGB .. RGRGRGRGRG */ -}; -#define IA_CSS_BAYER_ORDER_NUM (IA_CSS_BAYER_ORDER_GBRG + 1) - -/* Frame plane structure. This describes one plane in an image - * frame buffer. - */ -struct ia_css_frame_plane { - unsigned int height; /** height of a plane in lines */ - unsigned int width; /** width of a line, in DMA elements, note that - for RGB565 the three subpixels are stored in - one element. For all other formats this is - the number of subpixels per line. */ - unsigned int stride; /** stride of a line in bytes */ - unsigned int offset; /** offset in bytes to start of frame data. - offset is wrt data field in ia_css_frame */ -}; - -/* Binary "plane". This is used to story binary streams such as jpeg - * images. This is not actually a real plane. - */ -struct ia_css_frame_binary_plane { - unsigned int size; /** number of bytes in the stream */ - struct ia_css_frame_plane data; /** plane */ -}; - -/* Container for planar YUV frames. This contains 3 planes. - */ -struct ia_css_frame_yuv_planes { - struct ia_css_frame_plane y; /** Y plane */ - struct ia_css_frame_plane u; /** U plane */ - struct ia_css_frame_plane v; /** V plane */ -}; - -/* Container for semi-planar YUV frames. - */ -struct ia_css_frame_nv_planes { - struct ia_css_frame_plane y; /** Y plane */ - struct ia_css_frame_plane uv; /** UV plane */ -}; - -/* Container for planar RGB frames. Each color has its own plane. - */ -struct ia_css_frame_rgb_planes { - struct ia_css_frame_plane r; /** Red plane */ - struct ia_css_frame_plane g; /** Green plane */ - struct ia_css_frame_plane b; /** Blue plane */ -}; - -/* Container for 6-plane frames. These frames are used internally - * in the advanced ISP only. - */ -struct ia_css_frame_plane6_planes { - struct ia_css_frame_plane r; /** Red plane */ - struct ia_css_frame_plane r_at_b; /** Red at blue plane */ - struct ia_css_frame_plane gr; /** Red-green plane */ - struct ia_css_frame_plane gb; /** Blue-green plane */ - struct ia_css_frame_plane b; /** Blue plane */ - struct ia_css_frame_plane b_at_r; /** Blue at red plane */ -}; - -/* Crop info struct - stores the lines to be cropped in isp */ -struct ia_css_crop_info { - /* the final start column and start line - * sum of lines to be cropped + bayer offset - */ - unsigned int start_column; - unsigned int start_line; -}; - -/* Frame info struct. This describes the contents of an image frame buffer. - */ -struct ia_css_frame_info { - struct ia_css_resolution res; /** Frame resolution (valid data) */ - unsigned int padded_width; /** stride of line in memory (in pixels) */ - enum ia_css_frame_format format; /** format of the frame data */ - unsigned int raw_bit_depth; /** number of valid bits per pixel, - only valid for RAW bayer frames */ - enum ia_css_bayer_order raw_bayer_order; /** bayer order, only valid - for RAW bayer frames */ - /* the params below are computed based on bayer_order - * we can remove the raw_bayer_order if it is redundant - * keeping it for now as bxt and fpn code seem to use it - */ - struct ia_css_crop_info crop_info; -}; - -#define IA_CSS_BINARY_DEFAULT_FRAME_INFO \ -(struct ia_css_frame_info) { \ - .format = IA_CSS_FRAME_FORMAT_NUM, \ - .raw_bayer_order = IA_CSS_BAYER_ORDER_NUM, \ -} - -/** - * Specifies the DVS loop delay in "frame periods" - */ -enum ia_css_frame_delay { - IA_CSS_FRAME_DELAY_0, /** Frame delay = 0 */ - IA_CSS_FRAME_DELAY_1, /** Frame delay = 1 */ - IA_CSS_FRAME_DELAY_2 /** Frame delay = 2 */ -}; - -enum ia_css_frame_flash_state { - IA_CSS_FRAME_FLASH_STATE_NONE, - IA_CSS_FRAME_FLASH_STATE_PARTIAL, - IA_CSS_FRAME_FLASH_STATE_FULL -}; - -/* Frame structure. This structure describes an image buffer or frame. - * This is the main structure used for all input and output images. - */ -struct ia_css_frame { - struct ia_css_frame_info info; /** info struct describing the frame */ - ia_css_ptr data; /** pointer to start of image data */ - unsigned int data_bytes; /** size of image data in bytes */ - /* LA: move this to ia_css_buffer */ - /* - * -1 if data address is static during life time of pipeline - * >=0 if data address can change per pipeline/frame iteration - * index to dynamic data: ia_css_frame_in, ia_css_frame_out - * ia_css_frame_out_vf - * index to host-sp queue id: queue_0, queue_1 etc. - */ - int dynamic_queue_id; - /* - * if it is dynamic frame, buf_type indicates which buffer type it - * should use for event generation. we have this because in vf_pp - * binary, we use output port, but we expect VF_OUTPUT_DONE event - */ - enum ia_css_buffer_type buf_type; - enum ia_css_frame_flash_state flash_state; - unsigned int exp_id; - /** exposure id, see ia_css_event_public.h for more detail */ - uint32_t isp_config_id; /** Unique ID to track which config was actually applied to a particular frame */ - bool valid; /** First video output frame is not valid */ - bool contiguous; /** memory is allocated physically contiguously */ - union { - unsigned int _initialisation_dummy; - struct ia_css_frame_plane raw; - struct ia_css_frame_plane rgb; - struct ia_css_frame_rgb_planes planar_rgb; - struct ia_css_frame_plane yuyv; - struct ia_css_frame_yuv_planes yuv; - struct ia_css_frame_nv_planes nv; - struct ia_css_frame_plane6_planes plane6; - struct ia_css_frame_binary_plane binary; - } planes; /** frame planes, select the right one based on - info.format */ -}; - -#define DEFAULT_FRAME \ -(struct ia_css_frame) { \ - .info = IA_CSS_BINARY_DEFAULT_FRAME_INFO, \ - .dynamic_queue_id = SH_CSS_INVALID_QUEUE_ID, \ - .buf_type = IA_CSS_BUFFER_TYPE_INVALID, \ - .flash_state = IA_CSS_FRAME_FLASH_STATE_NONE, \ -} - -/* @brief Fill a frame with zeros - * - * @param frame The frame. - * @return None - * - * Fill a frame with pixel values of zero - */ -void ia_css_frame_zero(struct ia_css_frame *frame); - -/* @brief Allocate a CSS frame structure - * - * @param frame The allocated frame. - * @param width The width (in pixels) of the frame. - * @param height The height (in lines) of the frame. - * @param format The frame format. - * @param stride The padded stride, in pixels. - * @param raw_bit_depth The raw bit depth, in bits. - * @return The error code. - * - * Allocate a CSS frame structure. The memory for the frame data will be - * allocated in the CSS address space. - */ -enum ia_css_err -ia_css_frame_allocate(struct ia_css_frame **frame, - unsigned int width, - unsigned int height, - enum ia_css_frame_format format, - unsigned int stride, - unsigned int raw_bit_depth); - -/* @brief Allocate a CSS frame structure using a frame info structure. - * - * @param frame The allocated frame. - * @param[in] info The frame info structure. - * @return The error code. - * - * Allocate a frame using the resolution and format from a frame info struct. - * This is a convenience function, implemented on top of - * ia_css_frame_allocate(). - */ -enum ia_css_err -ia_css_frame_allocate_from_info(struct ia_css_frame **frame, - const struct ia_css_frame_info *info); -/* @brief Free a CSS frame structure. - * - * @param[in] frame Pointer to the frame. - * @return None - * - * Free a CSS frame structure. This will free both the frame structure - * and the pixel data pointer contained within the frame structure. - */ -void -ia_css_frame_free(struct ia_css_frame *frame); - -/* @brief Allocate a contiguous CSS frame structure - * - * @param frame The allocated frame. - * @param width The width (in pixels) of the frame. - * @param height The height (in lines) of the frame. - * @param format The frame format. - * @param stride The padded stride, in pixels. - * @param raw_bit_depth The raw bit depth, in bits. - * @return The error code. - * - * Contiguous frame allocation, only for FPGA display driver which needs - * physically contiguous memory. - * Deprecated. - */ -enum ia_css_err -ia_css_frame_allocate_contiguous(struct ia_css_frame **frame, - unsigned int width, - unsigned int height, - enum ia_css_frame_format format, - unsigned int stride, - unsigned int raw_bit_depth); - -/* @brief Allocate a contiguous CSS frame from a frame info structure. - * - * @param frame The allocated frame. - * @param[in] info The frame info structure. - * @return The error code. - * - * Allocate a frame using the resolution and format from a frame info struct. - * This is a convenience function, implemented on top of - * ia_css_frame_allocate_contiguous(). - * Only for FPGA display driver which needs physically contiguous memory. - * Deprecated. - */ -enum ia_css_err -ia_css_frame_allocate_contiguous_from_info(struct ia_css_frame **frame, - const struct ia_css_frame_info *info); - -/* @brief Allocate a CSS frame structure using a frame info structure. - * - * @param frame The allocated frame. - * @param[in] info The frame info structure. - * @return The error code. - * - * Allocate an empty CSS frame with no data buffer using the parameters - * in the frame info. - */ -enum ia_css_err -ia_css_frame_create_from_info(struct ia_css_frame **frame, - const struct ia_css_frame_info *info); - -/* @brief Set a mapped data buffer to a CSS frame - * - * @param[in] frame Valid CSS frame pointer - * @param[in] mapped_data Mapped data buffer to be assigned to the CSS frame - * @param[in] data_size_bytes Size of the mapped_data in bytes - * @return The error code. - * - * Sets a mapped data buffer to this frame. This function can be called multiple - * times with different buffers or NULL to reset the data pointer. This API - * would not try free the mapped_data and its the callers responsiblity to - * free the mapped_data buffer. However if ia_css_frame_free() is called and - * the frame had a valid data buffer, it would be freed along with the frame. - */ -enum ia_css_err -ia_css_frame_set_data(struct ia_css_frame *frame, - const ia_css_ptr mapped_data, - size_t data_size_bytes); - -/* @brief Map an existing frame data pointer to a CSS frame. - * - * @param frame Pointer to the frame to be initialized - * @param[in] info The frame info. - * @param[in] data Pointer to the allocated frame data. - * @param[in] attribute Attributes to be passed to mmgr_mmap. - * @param[in] context Pointer to the a context to be passed to mmgr_mmap. - * @return The allocated frame structure. - * - * This function maps a pre-allocated pointer into a CSS frame. This can be - * used when an upper software layer is responsible for allocating the frame - * data and it wants to share that frame pointer with the CSS code. - * This function will fill the CSS frame structure just like - * ia_css_frame_allocate() does, but instead of allocating the memory, it will - * map the pre-allocated memory into the CSS address space. - */ -enum ia_css_err -ia_css_frame_map(struct ia_css_frame **frame, - const struct ia_css_frame_info *info, - const void *data, - uint16_t attribute, - void *context); - -/* @brief Unmap a CSS frame structure. - * - * @param[in] frame Pointer to the CSS frame. - * @return None - * - * This function unmaps the frame data pointer within a CSS frame and - * then frees the CSS frame structure. Use this for frame pointers created - * using ia_css_frame_map(). - */ -void -ia_css_frame_unmap(struct ia_css_frame *frame); - -#endif /* __IA_CSS_FRAME_PUBLIC_H */ |