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
|
#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_QUEUE_H
#define __IA_CSS_QUEUE_H
#include <platform_support.h>
#include <type_support.h>
#include "ia_css_queue_comm.h"
#include "../src/queue_access.h"
/* Local Queue object descriptor */
struct ia_css_queue_local {
ia_css_circbuf_desc_t *cb_desc; /*Circbuf desc for local queues*/
ia_css_circbuf_elem_t *cb_elems; /*Circbuf elements*/
};
typedef struct ia_css_queue_local ia_css_queue_local_t;
/* Handle for queue object*/
typedef struct ia_css_queue ia_css_queue_t;
/*****************************************************************************
* Queue Public APIs
*****************************************************************************/
/* @brief Initialize a local queue instance.
*
* @param[out] qhandle. Handle to queue instance for use with API
* @param[in] desc. Descriptor with queue properties filled-in
* @return 0 - Successful init of local queue instance.
* @return EINVAL - Invalid argument.
*
*/
extern int ia_css_queue_local_init(
ia_css_queue_t *qhandle,
ia_css_queue_local_t *desc);
/* @brief Initialize a remote queue instance
*
* @param[out] qhandle. Handle to queue instance for use with API
* @param[in] desc. Descriptor with queue properties filled-in
* @return 0 - Successful init of remote queue instance.
* @return EINVAL - Invalid argument.
*/
extern int ia_css_queue_remote_init(
ia_css_queue_t *qhandle,
ia_css_queue_remote_t *desc);
/* @brief Uninitialize a queue instance
*
* @param[in] qhandle. Handle to queue instance
* @return 0 - Successful uninit.
*
*/
extern int ia_css_queue_uninit(
ia_css_queue_t *qhandle);
/* @brief Enqueue an item in the queue instance
*
* @param[in] qhandle. Handle to queue instance
* @param[in] item. Object to be enqueued.
* @return 0 - Successful enqueue.
* @return EINVAL - Invalid argument.
* @return ENOBUFS - Queue is full.
*
*/
extern int ia_css_queue_enqueue(
ia_css_queue_t *qhandle,
uint32_t item);
/* @brief Dequeue an item from the queue instance
*
* @param[in] qhandle. Handle to queue instance
* @param[out] item. Object to be dequeued into this item.
* @return 0 - Successful dequeue.
* @return EINVAL - Invalid argument.
* @return ENODATA - Queue is empty.
*
*/
extern int ia_css_queue_dequeue(
ia_css_queue_t *qhandle,
uint32_t *item);
/* @brief Check if the queue is empty
*
* @param[in] qhandle. Handle to queue instance
* @param[in] is_empty True if empty, False if not.
* @return 0 - Successful access state.
* @return EINVAL - Invalid argument.
* @return ENOSYS - Function not implemented.
*
*/
extern int ia_css_queue_is_empty(
ia_css_queue_t *qhandle,
bool *is_empty);
/* @brief Check if the queue is full
*
* @param[in] qhandle. Handle to queue instance
* @param[in] is_full True if Full, False if not.
* @return 0 - Successfully access state.
* @return EINVAL - Invalid argument.
* @return ENOSYS - Function not implemented.
*
*/
extern int ia_css_queue_is_full(
ia_css_queue_t *qhandle,
bool *is_full);
/* @brief Get used space in the queue
*
* @param[in] qhandle. Handle to queue instance
* @param[in] size Number of available elements in the queue
* @return 0 - Successfully access state.
* @return EINVAL - Invalid argument.
*
*/
extern int ia_css_queue_get_used_space(
ia_css_queue_t *qhandle,
uint32_t *size);
/* @brief Get free space in the queue
*
* @param[in] qhandle. Handle to queue instance
* @param[in] size Number of free elements in the queue
* @return 0 - Successfully access state.
* @return EINVAL - Invalid argument.
*
*/
extern int ia_css_queue_get_free_space(
ia_css_queue_t *qhandle,
uint32_t *size);
/* @brief Peek at an element in the queue
*
* @param[in] qhandle. Handle to queue instance
* @param[in] offset Offset of element to peek,
* starting from head of queue
* @param[in] element Value of element returned
* @return 0 - Successfully access state.
* @return EINVAL - Invalid argument.
*
*/
extern int ia_css_queue_peek(
ia_css_queue_t *qhandle,
uint32_t offset,
uint32_t *element);
/* @brief Get the usable size for the queue
*
* @param[in] qhandle. Handle to queue instance
* @param[out] size Size value to be returned here.
* @return 0 - Successful get size.
* @return EINVAL - Invalid argument.
* @return ENOSYS - Function not implemented.
*
*/
extern int ia_css_queue_get_size(
ia_css_queue_t *qhandle,
uint32_t *size);
#endif /* __IA_CSS_QUEUE_H */
|
