1 /* SPDX-License-Identifier: GPL-2.0 */
2 /*
3  * Support for Intel Camera Imaging ISP subsystem.
4  * Copyright (c) 2015, Intel Corporation.
5  *
6  * This program is free software; you can redistribute it and/or modify it
7  * under the terms and conditions of the GNU General Public License,
8  * version 2, as published by the Free Software Foundation.
9  *
10  * This program is distributed in the hope it will be useful, but WITHOUT
11  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
12  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
13  * more details.
14  */
15 
16 #ifndef __IA_CSS_MIPI_H
17 #define __IA_CSS_MIPI_H
18 
19 /* @file
20  * This file contains MIPI support functionality
21  */
22 
23 #include <type_support.h>
24 #include "ia_css_err.h"
25 #include "ia_css_stream_format.h"
26 #include "ia_css_input_port.h"
27 
28 /* @brief Register size of a CSS MIPI frame for check during capturing.
29  *
30  * @param[in]	port	CSI-2 port this check is registered.
31  * @param[in]	size_mem_words	The frame size in memory words (32B).
32  * @return		Return the error in case of failure. E.g. MAX_NOF_ENTRIES REACHED
33  *
34  * Register size of a CSS MIPI frame to check during capturing. Up to
35  *		IA_CSS_MIPI_SIZE_CHECK_MAX_NOF_ENTRIES entries per port allowed. Entries are reset
36  *		when stream is stopped.
37  *
38  *
39  */
40 int
41 ia_css_mipi_frame_enable_check_on_size(const enum mipi_port_id port,
42 				       const unsigned int	size_mem_words);
43 
44 /* @brief Calculate the size of a mipi frame.
45  *
46  * @param[in]	width		The width (in pixels) of the frame.
47  * @param[in]	height		The height (in lines) of the frame.
48  * @param[in]	format		The frame (MIPI) format.
49  * @param[in]	hasSOLandEOL	Whether frame (MIPI) contains (optional) SOL and EOF packets.
50  * @param[in]	embedded_data_size_words		Embedded data size in memory words.
51  * @param		size_mem_words					The mipi frame size in memory words (32B).
52  * @return		The error code.
53  *
54  * Calculate the size of a mipi frame, based on the resolution and format.
55  */
56 int
57 ia_css_mipi_frame_calculate_size(const unsigned int width,
58 				 const unsigned int height,
59 				 const enum atomisp_input_format format,
60 				 const bool hasSOLandEOL,
61 				 const unsigned int embedded_data_size_words,
62 				 unsigned int *size_mem_words);
63 
64 #endif /* __IA_CSS_MIPI_H */
65