TI J721E Imaging User Guide
app_hwa.h
Go to the documentation of this file.
1 /*
2  *
3  * Copyright (c) 2018 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 APP_HWA_H_
64 #define APP_HWA_H_
65 
66 #include <stdint.h>
67 
71 #define APP_VHWA_SERVICE_NAME "com.ti.vhwa_remote_service"
72 
76 #define APP_DMPAC_SDE_SL2_FREE (0x0001)
77 
80 #define APP_DMPAC_DOF_SL2_FREE (0x0002)
81 
84 #define APP_DMPAC_SDE_SL2_REALLOC (0x0003)
85 
88 #define APP_DMPAC_DOF_SL2_REALLOC (0x0004)
89 
92 #define APP_VPAC_720_DMPAC_480 (0x0005)
93 
96 #define APP_VPAC_650_DMPAC_520 (0x0006)
97 
101 #define APP_SDE_DEFAULT_DIS_BUFF_DEPTH (2U)
102 
105 #define APP_SDE_SR_192 (2U)
106 
109 #define APP_FVID2_CCSF_BITS12_UNPACKED16 ((uint32_t) 0x11U)
110 
111 
115 #define APP_DOF_DEFAULT_REF_BUFF_DEPTH (2U)
116 
120 #define APP_DOF_DEFAULT_CUR_BUFF_DEPTH (2U)
121 
125 #define APP_DOF_DEFAULT_FV_BUFF_DEPTH (4U)
126 
127 
134 typedef struct
135 {
140  uint32_t maxImgWidth;
142  uint32_t inCcsf;
144  uint32_t searchRange;
146  uint32_t disBuffDepth;
149 
150 
157 typedef struct
158 {
163  uint32_t maxImgWidth;
165  uint32_t inCcsf;
167  uint32_t refBuffDepth;
171  uint32_t currBuffDepth;
174  uint32_t fvBuffDepth;
176  uint32_t topSR;
178  uint32_t botSR;
181 
182 
197 int32_t appFvid2Init(void);
198 
202 int32_t appCsi2RxInit(void);
203 
207 int32_t appCsi2TxInit(void);
208 
212 int32_t appVhwaVpacInit(uint32_t vpacInst);
213 int32_t appVhwaDmpacInit(void);
214 
218 int32_t appCsi2RxDeInit(void);
219 
223 int32_t appCsi2TxDeInit(void);
224 
228 int32_t appFvid2DeInit(void);
229 
230 
234 int32_t appVhwaVpacDeInit(void);
235 int32_t appVhwaDmpacDeInit(void);
236 
240 int32_t appVhwaRemoteServiceInit();
241 
246 
250 int32_t appVissRemoteServiceInit();
251 
256 
257 #if defined(SOC_J722S)
258 
265 int32_t appUdmaCsirxCsitxInit(void);
266 
273 int32_t appUdmaCsirxCsitxDeInit(void);
274 
275 #endif
276 
277 /* @} */
278 
279 #endif
280 
int32_t appFvid2DeInit(void)
Performs de-initializations needed for Fvid2.
Definition: app_hwa.c:176
uint32_t fvBuffDepth
Definition: app_hwa.h:174
int32_t appVissRemoteServiceDeInit()
Performs unregistration of remote service for VISS node.
Definition: app_hwa.c:808
int32_t appVhwaRemoteServiceDeInit()
Performs unregistration of remote service for SL2.
Definition: app_hwa.c:795
uint32_t topSR
Definition: app_hwa.h:176
int32_t appVhwaRemoteServiceInit()
Performs registration of remote service for SL2.
Definition: app_hwa.c:782
int32_t appVhwaDmpacDeInit(void)
Definition: app_hwa.c:417
Init Parameters required to allocate SDE driver. This should be identical to Vhwa_m2mSdeSl2AllocPrms...
Definition: app_hwa.h:134
int32_t appVissRemoteServiceInit()
Performs registration of remote service for VISS node.
Definition: app_hwa.c:821
int32_t appCsi2RxInit(void)
Performs initializations needed for CSI2RX driver.
Definition: app_csi.c:151
uint32_t inCcsf
Definition: app_hwa.h:165
uint32_t searchRange
Definition: app_hwa.h:144
Init Parameters required to allocate DOF driver This should be identical to Vhwa_m2mDofSl2AllocPrms. It is defined locally for application to use the same params.
Definition: app_hwa.h:157
int32_t appFvid2Init(void)
Performs initializations needed for Fvid2 must be called before capture, display and other HWA init...
Definition: app_hwa.c:157
int32_t appVhwaVpacInit(uint32_t vpacInst)
Performs initializations needed for VHWA drivers.
Definition: app_hwa.c:431
int32_t appCsi2TxInit(void)
Performs initializations needed for CSI2TX driver.
Definition: app_hwa.c:222
uint32_t refBuffDepth
Definition: app_hwa.h:167
uint32_t inCcsf
Definition: app_hwa.h:142
uint32_t maxImgWidth
Definition: app_hwa.h:140
int32_t appVhwaVpacDeInit(void)
Performs de-initializations needed for VHWA drivers.
Definition: app_hwa.c:672
uint32_t maxImgWidth
Definition: app_hwa.h:163
int32_t appVhwaDmpacInit(void)
Definition: app_hwa.c:317
uint32_t disBuffDepth
Definition: app_hwa.h:146
int32_t appCsi2TxDeInit(void)
Performs de-initializations needed for CSI2TX driver.
Definition: app_hwa.c:303
uint32_t botSR
Definition: app_hwa.h:178
int32_t appCsi2RxDeInit(void)
Performs de-initializations needed for CSI2RX driver.
Definition: app_csi.c:185
uint32_t currBuffDepth
Definition: app_hwa.h:171