TI J721E Imaging User Guide
j7_kernels_imaging_aewb.h
Go to the documentation of this file.
1 /*
2  *
3  * Copyright (c) 2017 Texas Instruments Incorporated
4  *
5  * All rights reserved not granted herein.
6  *
7  * Limited License.
8  *
9  * Texas Instruments Incorporated grants a world-wide, royalty-free, non-exclusive
10  * license under copyrights and patents it now or hereafter owns or controls to make,
11  * have made, use, import, offer to sell and sell ("Utilize") this software subject to the
12  * terms herein. With respect to the foregoing patent license, such license is granted
13  * solely to the extent that any such patent is necessary to Utilize the software alone.
14  * The patent license shall not apply to any combinations which include this software,
15  * other than combinations with devices manufactured by or for TI ("TI Devices").
16  * No hardware patent is licensed hereunder.
17  *
18  * Redistributions must preserve existing copyright notices and reproduce this license
19  * (including the above copyright notice and the disclaimer and (if applicable) source
20  * code license limitations below) in the documentation and/or other materials provided
21  * with the distribution
22  *
23  * Redistribution and use in binary form, without modification, are permitted provided
24  * that the following conditions are met:
25  *
26  * * No reverse engineering, decompilation, or disassembly of this software is
27  * permitted with respect to any software provided in binary form.
28  *
29  * * any redistribution and use are licensed by TI for use only with TI Devices.
30  *
31  * * Nothing shall obligate TI to provide you with source code for the software
32  * licensed and provided to you in object code.
33  *
34  * If software source code is provided to you, modification and redistribution of the
35  * source code are permitted provided that the following conditions are met:
36  *
37  * * any redistribution and use of the source code, including any resulting derivative
38  * works, are licensed by TI for use only with TI Devices.
39  *
40  * * any redistribution and use of any object code compiled from the source code
41  * and any resulting derivative works, are licensed by TI for use only with TI Devices.
42  *
43  * Neither the name of Texas Instruments Incorporated nor the names of its suppliers
44  *
45  * may be used to endorse or promote products derived from this software without
46  * specific prior written permission.
47  *
48  * DISCLAIMER.
49  *
50  * THIS SOFTWARE IS PROVIDED BY TI AND TI'S LICENSORS "AS IS" AND ANY EXPRESS
51  * OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
52  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
53  * IN NO EVENT SHALL TI AND TI'S LICENSORS BE LIABLE FOR ANY DIRECT, INDIRECT,
54  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
55  * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
56  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
57  * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE
58  * OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
59  * OF THE POSSIBILITY OF SUCH DAMAGE.
60  *
61  */
62 
63 #ifndef J7_IMG_AEWB_KERNELS_H_
64 #define J7_IMG_AEWB_KERNELS_H_
65 
66 #include <VX/vx.h>
67 #include <VX/vx_kernels.h>
68 
69 #ifdef __cplusplus
70 extern "C" {
71 #endif
72 
81 #define TIVX_MODULE_NAME_IMAGING "imaging"
82 
101 #define TIVX_KERNEL_AEWB_NAME "com.ti.imaging.aewb"
102 
109 void tivxImagingLoadKernels(vx_context context);
110 
115 void tivxImagingUnLoadKernels(vx_context context);
116 
122 
128 
133 void tivxImagingPrintPerformance(vx_perf_t performance, uint32_t numPixels, const char* testName);
134 
135 
140 typedef struct
141 {
142  uint16_t sensor_dcc_id;
145  uint8_t awb_mode;
146  uint8_t ae_mode;
149  uint8_t channel_id;
151 
155  typedef struct {
156  uint16_t subSampleAcc[4];
157  uint16_t saturatorAcc[4];
159 
163  typedef struct {
164  uint16_t unsatCount[8];
166 
167 
171  typedef struct _aewDataEntry {
172  uint16_t window_data[8][8];
173  uint16_t unsat_block_ct[8];
175 
176 
181 #define H3A_MAX_WINH 56
182 #define H3A_MAX_WINV 128
183 
184 typedef struct
185 {
186  uint16_t rows;
187  uint16_t cols;
188  uint8_t bpp;
189  uint32_t numPixWin;
190  uint16_t rdata[H3A_MAX_WINH*H3A_MAX_WINV];
191  uint16_t gdata[H3A_MAX_WINH*H3A_MAX_WINV];
192  uint16_t bdata[H3A_MAX_WINH*H3A_MAX_WINV];
193  uint16_t adata[H3A_MAX_WINH*H3A_MAX_WINV];
195 
201 {
202  uint32_t histogram[256][32];
204 
205 #define MAX_H3A_HORZ_WINDOWS H3A_MAX_WINH
206 #define MAX_H3A_VERT_WINDOWS H3A_MAX_WINV
207 
208 #ifdef __cplusplus
209 }
210 #endif
211 
212 #endif /* J7_IMG_AEWB_KERNELS_H_ */
213 
214 
#define H3A_MAX_WINH
tivx_h3a_image_t parameters
Definition: j7_kernels_imaging_aewb.h:181
uint16_t cols
Definition: j7_kernels_imaging_aewb.h:187
uint8_t awb_mode
Definition: j7_kernels_imaging_aewb.h:145
uint8_t awb_num_skip_frames
Definition: j7_kernels_imaging_aewb.h:147
tivx_aewb_config_t parameters
Definition: j7_kernels_imaging_aewb.h:140
void tivxImagingPrintPerformance(vx_perf_t performance, uint32_t numPixels, const char *testName)
Used to print the performance of the kernels.
uint16_t sensor_dcc_id
Definition: j7_kernels_imaging_aewb.h:142
uint8_t ae_num_skip_frames
Definition: j7_kernels_imaging_aewb.h:148
tivx_aewb_hist_t parameters
Definition: j7_kernels_imaging_aewb.h:200
void tivxRegisterImagingTargetAewbKernels(void)
Function to register IMAGING Kernels on the aewb Target.
void tivxImagingLoadKernels(vx_context context)
Used for the Application to load the imaging kernels into the context.
AE/AWB packet format for sum-only mode.
Definition: j7_kernels_imaging_aewb.h:155
uint16_t rows
Definition: j7_kernels_imaging_aewb.h:186
uint8_t sensor_img_phase
Definition: j7_kernels_imaging_aewb.h:144
uint8_t channel_id
Definition: j7_kernels_imaging_aewb.h:149
AE/AWB unsaturated block count.
Definition: j7_kernels_imaging_aewb.h:163
uint32_t numPixWin
Definition: j7_kernels_imaging_aewb.h:189
uint8_t ae_mode
Definition: j7_kernels_imaging_aewb.h:146
#define H3A_MAX_WINV
Definition: j7_kernels_imaging_aewb.h:182
AEWWB Data Entry Structure.
Definition: j7_kernels_imaging_aewb.h:171
uint8_t bpp
Definition: j7_kernels_imaging_aewb.h:188
uint8_t sensor_img_format
Definition: j7_kernels_imaging_aewb.h:143
void tivxUnRegisterImagingTargetAewbKernels(void)
Function to un-register IMAGING Kernels on the aewb Target.
Definition: j7_kernels_imaging_aewb.h:184
void tivxImagingUnLoadKernels(vx_context context)
Used for the Application to unload the imaging kernels from the context.
struct tivx_aewb_hist_t tivx_aewb_hist_t