1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
|
#ifndef ISP2401
/*
* 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.
*/
#else
/**
Support for Intel Camera Imaging ISP subsystem.
Copyright (c) 2010 - 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.
*/
#endif
#ifndef __IA_CSS_PIPELINE_H__
#define __IA_CSS_PIPELINE_H__
#include "sh_css_internal.h"
#include "ia_css_pipe_public.h"
#include "ia_css_pipeline_common.h"
#define IA_CSS_PIPELINE_NUM_MAX (20)
/* Pipeline stage to be executed on SP/ISP */
struct ia_css_pipeline_stage {
unsigned int stage_num;
struct ia_css_binary *binary; /* built-in binary */
struct ia_css_binary_info *binary_info;
const struct ia_css_fw_info *firmware; /* acceleration binary */
/* SP function for SP stage */
enum ia_css_pipeline_stage_sp_func sp_func;
unsigned max_input_width; /* For SP raw copy */
struct sh_css_binary_args args;
int mode;
bool out_frame_allocated[IA_CSS_BINARY_MAX_OUTPUT_PORTS];
bool vf_frame_allocated;
struct ia_css_pipeline_stage *next;
bool enable_zoom;
};
/* Pipeline of n stages to be executed on SP/ISP per stage */
struct ia_css_pipeline {
enum ia_css_pipe_id pipe_id;
uint8_t pipe_num;
bool stop_requested;
struct ia_css_pipeline_stage *stages;
struct ia_css_pipeline_stage *current_stage;
unsigned num_stages;
struct ia_css_frame in_frame;
struct ia_css_frame out_frame[IA_CSS_PIPE_MAX_OUTPUT_STAGE];
struct ia_css_frame vf_frame[IA_CSS_PIPE_MAX_OUTPUT_STAGE];
unsigned int dvs_frame_delay;
unsigned inout_port_config;
int num_execs;
bool acquire_isp_each_stage;
uint32_t pipe_qos_config;
};
#define DEFAULT_PIPELINE \
{ \
IA_CSS_PIPE_ID_PREVIEW, /* pipe_id */ \
0, /* pipe_num */ \
false, /* stop_requested */ \
NULL, /* stages */ \
NULL, /* current_stage */ \
0, /* num_stages */ \
DEFAULT_FRAME, /* in_frame */ \
{DEFAULT_FRAME}, /* out_frame */ \
{DEFAULT_FRAME}, /* vf_frame */ \
IA_CSS_FRAME_DELAY_1, /* frame_delay */ \
0, /* inout_port_config */ \
-1, /* num_execs */ \
true, /* acquire_isp_each_stage */\
QOS_INVALID /* pipe_qos_config */\
}
/* Stage descriptor used to create a new stage in the pipeline */
struct ia_css_pipeline_stage_desc {
struct ia_css_binary *binary;
const struct ia_css_fw_info *firmware;
enum ia_css_pipeline_stage_sp_func sp_func;
unsigned max_input_width;
unsigned int mode;
struct ia_css_frame *in_frame;
struct ia_css_frame *out_frame[IA_CSS_BINARY_MAX_OUTPUT_PORTS];
struct ia_css_frame *vf_frame;
};
/* @brief initialize the pipeline module
*
* @return None
*
* Initializes the pipeline module. This API has to be called
* before any operation on the pipeline module is done
*/
void ia_css_pipeline_init(void);
/* @brief initialize the pipeline structure with default values
*
* @param[out] pipeline structure to be initialized with defaults
* @param[in] pipe_id
* @param[in] pipe_num Number that uniquely identifies a pipeline.
* @return IA_CSS_SUCCESS or error code upon error.
*
* Initializes the pipeline structure with a set of default values.
* This API is expected to be used when a pipeline structure is allocated
* externally and needs sane defaults
*/
enum ia_css_err ia_css_pipeline_create(
struct ia_css_pipeline *pipeline,
enum ia_css_pipe_id pipe_id,
unsigned int pipe_num,
unsigned int dvs_frame_delay);
/* @brief destroy a pipeline
*
* @param[in] pipeline
* @return None
*
*/
void ia_css_pipeline_destroy(struct ia_css_pipeline *pipeline);
/* @brief Starts a pipeline
*
* @param[in] pipe_id
* @param[in] pipeline
* @return None
*
*/
void ia_css_pipeline_start(enum ia_css_pipe_id pipe_id,
struct ia_css_pipeline *pipeline);
/* @brief Request to stop a pipeline
*
* @param[in] pipeline
* @return IA_CSS_SUCCESS or error code upon error.
*
*/
enum ia_css_err ia_css_pipeline_request_stop(struct ia_css_pipeline *pipeline);
/* @brief Check whether pipeline has stopped
*
* @param[in] pipeline
* @return true if the pipeline has stopped
*
*/
bool ia_css_pipeline_has_stopped(struct ia_css_pipeline *pipe);
/* @brief clean all the stages pipeline and make it as new
*
* @param[in] pipeline
* @return None
*
*/
void ia_css_pipeline_clean(struct ia_css_pipeline *pipeline);
/* @brief Add a stage to pipeline.
*
* @param pipeline Pointer to the pipeline to be added to.
* @param[in] stage_desc The description of the stage
* @param[out] stage The successor of the stage.
* @return IA_CSS_SUCCESS or error code upon error.
*
* Add a new stage to a non-NULL pipeline.
* The stage consists of an ISP binary or firmware and input and output
* arguments.
*/
enum ia_css_err ia_css_pipeline_create_and_add_stage(
struct ia_css_pipeline *pipeline,
struct ia_css_pipeline_stage_desc *stage_desc,
struct ia_css_pipeline_stage **stage);
/* @brief Finalize the stages in a pipeline
*
* @param pipeline Pointer to the pipeline to be added to.
* @return None
*
* This API is expected to be called after adding all stages
*/
void ia_css_pipeline_finalize_stages(struct ia_css_pipeline *pipeline,
bool continuous);
/* @brief gets a stage from the pipeline
*
* @param[in] pipeline
* @return IA_CSS_SUCCESS or error code upon error.
*
*/
enum ia_css_err ia_css_pipeline_get_stage(struct ia_css_pipeline *pipeline,
int mode,
struct ia_css_pipeline_stage **stage);
/* @brief Gets a pipeline stage corresponding Firmware handle from the pipeline
*
* @param[in] pipeline
* @param[in] fw_handle
* @param[out] stage Pointer to Stage
*
* @return IA_CSS_SUCCESS or error code upon error.
*
*/
enum ia_css_err ia_css_pipeline_get_stage_from_fw(struct ia_css_pipeline *pipeline,
uint32_t fw_handle,
struct ia_css_pipeline_stage **stage);
/* @brief Gets the Firmware handle correponding the stage num from the pipeline
*
* @param[in] pipeline
* @param[in] stage_num
* @param[out] fw_handle
*
* @return IA_CSS_SUCCESS or error code upon error.
*
*/
enum ia_css_err ia_css_pipeline_get_fw_from_stage(struct ia_css_pipeline *pipeline,
uint32_t stage_num,
uint32_t *fw_handle);
/* @brief gets the output stage from the pipeline
*
* @param[in] pipeline
* @return IA_CSS_SUCCESS or error code upon error.
*
*/
enum ia_css_err ia_css_pipeline_get_output_stage(
struct ia_css_pipeline *pipeline,
int mode,
struct ia_css_pipeline_stage **stage);
/* @brief Checks whether the pipeline uses params
*
* @param[in] pipeline
* @return true if the pipeline uses params
*
*/
bool ia_css_pipeline_uses_params(struct ia_css_pipeline *pipeline);
/**
* @brief get the SP thread ID.
*
* @param[in] key The query key, typical use is pipe_num.
* @param[out] val The query value.
*
* @return
* true, if the query succeeds;
* false, if the query fails.
*/
bool ia_css_pipeline_get_sp_thread_id(unsigned int key, unsigned int *val);
#if defined(USE_INPUT_SYSTEM_VERSION_2401)
/**
* @brief Get the pipeline io status
*
* @param[in] None
* @return
* Pointer to pipe_io_status
*/
struct sh_css_sp_pipeline_io_status *ia_css_pipeline_get_pipe_io_status(void);
#endif
/**
* @brief Map an SP thread to this pipeline
*
* @param[in] pipe_num
* @param[in] map true for mapping and false for unmapping sp threads.
*
*/
void ia_css_pipeline_map(unsigned int pipe_num, bool map);
/**
* @brief Checks whether the pipeline is mapped to SP threads
*
* @param[in] Query key, typical use is pipe_num
*
* return
* true, pipeline is mapped to SP threads
* false, pipeline is not mapped to SP threads
*/
bool ia_css_pipeline_is_mapped(unsigned int key);
/**
* @brief Print pipeline thread mapping
*
* @param[in] none
*
* return none
*/
void ia_css_pipeline_dump_thread_map_info(void);
#endif /*__IA_CSS_PIPELINE_H__*/
|
