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
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
|
#ifndef _BFLB_CAM_H
#define _BFLB_CAM_H
#include "bflb_core.h"
/** @addtogroup LHAL
* @{
*/
/** @addtogroup CAM
* @{
*/
/** @defgroup CAM_INPUT_FORMAT CAMERA input format definition
* @{
*/
#define CAM_INPUT_FORMAT_YUV422_YUYV 0
#define CAM_INPUT_FORMAT_YUV422_YVYU 1
#define CAM_INPUT_FORMAT_YUV422_UYVY 2
#define CAM_INPUT_FORMAT_YUV422_VYUY 3
#define CAM_INPUT_FORMAT_GRAY 4
#define CAM_INPUT_FORMAT_RGB565 5
#define CAM_INPUT_FORMAT_BGR565 6
#define CAM_INPUT_FORMAT_RGB888 7
#define CAM_INPUT_FORMAT_BGR888 8
/**
* @}
*/
/** @defgroup CAM_OUTPUT_FORMAT CAMERA output format definition
* @{
*/
#define CAM_OUTPUT_FORMAT_AUTO 0
#define CAM_OUTPUT_FORMAT_YUV422 1
#define CAM_OUTPUT_FORMAT_GRAY 2
#define CAM_OUTPUT_FORMAT_YUV422_UV 3
#define CAM_OUTPUT_FORMAT_YUV420_UV 4
#define CAM_OUTPUT_FORMAT_RGB565_OR_BGR565 5
#define CAM_OUTPUT_FORMAT_RGB888_OR_BGR888 6
#if !defined(BL702)
#define CAM_OUTPUT_FORMAT_RGB888_TO_RGB565 7
#define CAM_OUTPUT_FORMAT_RGB888_TO_BGR565 8
#define CAM_OUTPUT_FORMAT_RGB888_TO_RGBA8888 9
#endif
/**
* @}
*/
/** @defgroup CAM_INTSTS CAMERA interrupt status definition
* @{
*/
#if defined(BL702)
#define CAM_INTSTS_NORMAL (1 << 0)
#define CAM_INTSTS_MEMORY_OVERWRITE (1 << 2)
#define CAM_INTSTS_FRAME_OVERWRITE (1 << 4)
#define CAM_INTSTS_FIFO_OVERWRITE (1 << 6)
#define CAM_INTSTS_HSYNC_MISMATCH (1 << 8)
#define CAM_INTSTS_VSYNC_MISMATCH (1 << 9)
#else
#define CAM_INTSTS_NORMAL (1 << 12)
#define CAM_INTSTS_MEMORY_OVERWRITE (1 << 13)
#define CAM_INTSTS_FRAME_OVERWRITE (1 << 14)
#define CAM_INTSTS_FIFO_OVERWRITE (1 << 15)
#define CAM_INTSTS_HSYNC_MISMATCH (1 << 21)
#define CAM_INTSTS_VSYNC_MISMATCH (1 << 22)
#endif
/**
* @}
*/
/** @defgroup CAM_INTMASK CAMERA interrupt mask definition
* @{
*/
#if defined(BL702)
#define CAM_INTMASK_NORMAL (1 << 0)
#define CAM_INTMASK_MEMORY_OVERWRITE (1 << 2)
#define CAM_INTMASK_FRAME_OVERWRITE (1 << 3)
#define CAM_INTMASK_FIFO_OVERWRITE (1 << 4)
#define CAM_INTMASK_HSYNC_MISMATCH (1 << 5)
#define CAM_INTMASK_VSYNC_MISMATCH (1 << 6)
#else
#define CAM_INTMASK_NORMAL (1 << 8)
#define CAM_INTMASK_MEMORY_OVERWRITE (1 << 9)
#define CAM_INTMASK_FRAME_OVERWRITE (1 << 10)
#define CAM_INTMASK_FIFO_OVERWRITE (1 << 11)
#define CAM_INTMASK_HSYNC_MISMATCH (1 << 6)
#define CAM_INTMASK_VSYNC_MISMATCH (1 << 7)
#endif
/**
* @}
*/
/** @defgroup CAM_INTCLR CAMERA interrupt clear definition
* @{
*/
#define CAM_INTCLR_NORMAL (1 << 4)
#define CAM_INTCLR_MEMORY_OVERWRITE (1 << 5)
#define CAM_INTCLR_FRAME_OVERWRITE (1 << 6)
#define CAM_INTCLR_FIFO_OVERWRITE (1 << 7)
#define CAM_INTCLR_HSYNC_MISMATCH (1 << 8)
#define CAM_INTCLR_VSYNC_MISMATCH (1 << 9)
/**
* @}
*/
/** @defgroup CAM_POLARITY CAMERA hsync/vsync polarity active level definition
* @{
*/
#define CAM_POLARITY_ACTIVE_LOW 0
#define CAM_POLARITY_ACTIVE_HIGH 1
/**
* @}
*/
/** @defgroup CAM_INPUT_SOURCE CAMERA input source definition
* @{
*/
#define CAM_INPUT_SOURCE_DVP 0
#if defined(BL808)
#define CAM_INPUT_SOURCE_CSI 1
#endif
/**
* @}
*/
/** @defgroup CAM_BURST CAMERA burst length definition
* @{
*/
#define CAM_BURST_INCR1 0
#define CAM_BURST_INCR4 1
#define CAM_BURST_INCR8 2
#define CAM_BURST_INCR16 3
#if !defined(BL702)
#define CAM_BURST_INCR32 5
#define CAM_BURST_INCR64 6
#endif
/**
* @}
*/
/** @defgroup CAM_CMD CAMERA feature control cmd definition
* @{
*/
#define CAM_CMD_SET_VSYNC_POLARITY 1
#define CAM_CMD_SET_HSYNC_POLARITY 2
#define CAM_CMD_SET_BURST 3
#if !defined(BL702)
#define CAM_CMD_SET_RGBA8888_ALPHA 4
#define CAM_CMD_GET_FRAME_ID 5
#endif
#define CAM_CMD_WRAP_MODE 6
#define CAM_CMD_COUNT_TRIGGER_NORMAL_INT 7
#if !defined(BL702)
#define CAM_CMD_FRAME_ID_RESET 8
#define CAM_CMD_INVERSE_VSYNC_POLARITY 9
#define CAM_CMD_INVERSE_HSYNC_POLARITY 10
#endif
/**
* @}
*/
/**
* @brief CAM configuration structure
*
* @param input_format CAM input format, use @ref CAM_INPUT_FORMAT
* @param resolution_x CAM resolution x
* @param resolution_y CAM resolution y
* @param h_blank CAM Hsync blank
* @param pixel_clock CAM pixel clock
* @param with_mjpeg CAM with mjpeg or not
* @param input_source CAM input source, use @ref CAM_INPUT_SOURCE
* @param output_format CAM output format, use @ref CAM_OUTPUT_FORMAT
* @param output_bufaddr CAM output buffer address , must be align 16
* @param output_bufsize CAM output buffer size, should not be less than one frame size
*/
struct bflb_cam_config_s {
uint8_t input_format;
uint16_t resolution_x;
uint16_t resolution_y;
uint16_t h_blank;
uint32_t pixel_clock;
bool with_mjpeg;
uint8_t input_source;
uint8_t output_format;
uint32_t output_bufaddr;
uint32_t output_bufsize;
};
#ifdef __cplusplus
extern "C" {
#endif
/**
* @brief Initialize cam.
*
* @param [in] dev device handle
* @param [in] config pointer to cam configure structure
*/
void bflb_cam_init(struct bflb_device_s *dev, const struct bflb_cam_config_s *config);
/**
* @brief Enable cam.
*
* @param [in] dev device handle
*/
void bflb_cam_start(struct bflb_device_s *dev);
/**
* @brief Disable cam.
*
* @param [in] dev device handle
*/
void bflb_cam_stop(struct bflb_device_s *dev);
/**
* @brief Mask or unmask cam interrupt.
*
* @param [in] dev device handle
* @param [in] int_type cam interrupt mask type, use @ref CAM_INTMASK
* @param [in] mask mask or unmask
*/
void bflb_cam_int_mask(struct bflb_device_s *dev, uint32_t int_type, bool mask);
/**
* @brief Clear cam interrupt.
*
* @param [in] dev device handle
* @param [in] int_type int_type cam interrupt clear type, use @ref CAM_INTCLR
*/
void bflb_cam_int_clear(struct bflb_device_s *dev, uint32_t int_type);
/**
* @brief Crop vsync.
*
* @param [in] dev device handle
* @param [in] start_line start line of window
* @param [in] end_line end line of window, not include
*/
void bflb_cam_crop_vsync(struct bflb_device_s *dev, uint16_t start_line, uint16_t end_line);
/**
* @brief Crop hsync.
*
* @param [in] dev device handle
* @param [in] start_pixel start pixel of each line
* @param [in] end_pixel end pixel of each line, not include
*/
void bflb_cam_crop_hsync(struct bflb_device_s *dev, uint16_t start_pixel, uint16_t end_pixel);
/**
* @brief Pop one frame.
*
* @param [in] dev device handle
*/
void bflb_cam_pop_one_frame(struct bflb_device_s *dev);
#if !defined(BL702)
/**
* @brief Swap input order of y and uv.
*
* @param [in] dev device handle
* @param [in] enable enable or disable
*/
void bflb_cam_swap_input_yu_order(struct bflb_device_s *dev, bool enable);
/**
* @brief Set frame filter, if frame_count = 3, frame_valid = 101b, second frame will be dropped every 3 frames.
*
* @param [in] dev device handle
* @param [in] frame_count frame filter period
* @param [in] frame_valid frame valid
*/
void bflb_cam_filter_frame_period(struct bflb_device_s *dev, uint8_t frame_count, uint32_t frame_valid);
#endif
/**
* @brief Get frame count.
*
* @param [in] dev device handle
* @return Frame count
*/
uint8_t bflb_cam_get_frame_count(struct bflb_device_s *dev);
/**
* @brief Get frame information.
*
* @param [in] dev device handle
* @param [out] pic pointer to frame start address
* @return Size of frame
*/
uint32_t bflb_cam_get_frame_info(struct bflb_device_s *dev, uint8_t **pic);
/**
* @brief Get interrupt status.
*
* @param [in] dev device handle
* @return Interrupt status
*/
uint32_t bflb_cam_get_intstatus(struct bflb_device_s *dev);
/**
* @brief Control cam feature.
*
* @param [in] dev device handle
* @param [in] cmd feature command
* @param [in] arg user data
* @return A negated errno value on failure
*/
int bflb_cam_feature_control(struct bflb_device_s *dev, int cmd, size_t arg);
#ifdef __cplusplus
}
#endif
/**
* @}
*/
/**
* @}
*/
#endif
|
