2 * Support for Intel Camera Imaging ISP subsystem.
3 * Copyright (c) 2015, Intel Corporation.
5 * This program is free software; you can redistribute it and/or modify it
6 * under the terms and conditions of the GNU General Public License,
7 * version 2, as published by the Free Software Foundation.
9 * This program is distributed in the hope it will be useful, but WITHOUT
10 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
11 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
15 #ifndef __IA_CSS_MIPI_H
16 #define __IA_CSS_MIPI_H
19 * This file contains MIPI support functionality
22 #include <type_support.h>
23 #include "ia_css_err.h"
24 #include "ia_css_stream_format.h"
25 #include "ia_css_input_port.h"
27 /** Backward compatible for CSS API 2.0 only
28 * TO BE REMOVED when all drivers move to CSS API 2.1.
30 /** @brief Specify a CSS MIPI frame buffer.
32 * @param[in] size_mem_words The frame size in memory words (32B).
33 * @param[in] contiguous Allocate memory physically contiguously or not.
34 * @return The error code.
36 * \deprecated{Use ia_css_mipi_buffer_config instead.}
38 * Specifies a CSS MIPI frame buffer: size in memory words (32B).
41 ia_css_mipi_frame_specify(const unsigned int size_mem_words,
42 const bool contiguous);
44 #if !defined(HAS_NO_INPUT_SYSTEM)
45 /** @brief Register size of a CSS MIPI frame for check during capturing.
47 * @param[in] port CSI-2 port this check is registered.
48 * @param[in] size_mem_words The frame size in memory words (32B).
49 * @return Return the error in case of failure. E.g. MAX_NOF_ENTRIES REACHED
51 * Register size of a CSS MIPI frame to check during capturing. Up to
52 * IA_CSS_MIPI_SIZE_CHECK_MAX_NOF_ENTRIES entries per port allowed. Entries are reset
53 * when stream is stopped.
58 ia_css_mipi_frame_enable_check_on_size(const enum ia_css_csi2_port port,
59 const unsigned int size_mem_words);
62 /** @brief Calculate the size of a mipi frame.
64 * @param[in] width The width (in pixels) of the frame.
65 * @param[in] height The height (in lines) of the frame.
66 * @param[in] format The frame (MIPI) format.
67 * @param[in] hasSOLandEOL Whether frame (MIPI) contains (optional) SOL and EOF packets.
68 * @param[in] embedded_data_size_words Embedded data size in memory words.
69 * @param size_mem_words The mipi frame size in memory words (32B).
70 * @return The error code.
72 * Calculate the size of a mipi frame, based on the resolution and format.
75 ia_css_mipi_frame_calculate_size(const unsigned int width,
76 const unsigned int height,
77 const enum ia_css_stream_format format,
78 const bool hasSOLandEOL,
79 const unsigned int embedded_data_size_words,
80 unsigned int *size_mem_words);
82 #endif /* __IA_CSS_MIPI_H */