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
|
/* SPDX-License-Identifier: GPL-2.0-or-later */
/*
* Video4Linux2 generic ISP parameters and statistics support
*
* Copyright (C) 2025 Ideas On Board Oy
* Author: Jacopo Mondi <jacopo.mondi@ideasonboard.com>
*/
#ifndef _V4L2_ISP_H_
#define _V4L2_ISP_H_
#include <linux/media/v4l2-isp.h>
struct device;
struct vb2_buffer;
/**
* v4l2_isp_params_buffer_size - Calculate size of v4l2_isp_params_buffer
* @max_params_size: The total size of the ISP configuration blocks
*
* Users of the v4l2 extensible parameters will have differing sized data arrays
* depending on their specific parameter buffers. Drivers and userspace will
* need to be able to calculate the appropriate size of the struct to
* accommodate all ISP configuration blocks provided by the platform.
* This macro provides a convenient tool for the calculation.
*/
#define v4l2_isp_params_buffer_size(max_params_size) \
(offsetof(struct v4l2_isp_params_buffer, data) + (max_params_size))
/**
* v4l2_isp_params_validate_buffer_size - Validate a V4L2 ISP buffer sizes
* @dev: the driver's device pointer
* @vb: the videobuf2 buffer
* @max_size: the maximum allowed buffer size
*
* This function performs validation of the size of a V4L2 ISP parameters buffer
* before the driver can access the actual data buffer content.
*
* After the sizes validation, drivers should copy the buffer content to a
* kernel-only memory area to prevent userspace from modifying it,
* before completing validation using v4l2_isp_params_validate_buffer().
*
* The @vb buffer as received from the vb2 .buf_prepare() operation is checked
* against @max_size and it's validated to be large enough to accommodate at
* least one ISP configuration block.
*/
int v4l2_isp_params_validate_buffer_size(struct device *dev,
struct vb2_buffer *vb,
size_t max_size);
/**
* struct v4l2_isp_params_block_type_info - V4L2 ISP per-block-type info
* @size: the block type expected size
*
* The v4l2_isp_params_block_type_info collects information of the ISP
* configuration block types for validation purposes. It currently only contains
* the expected block type size.
*
* Drivers shall prepare a list of block type info, indexed by block type, one
* for each supported ISP block type and correctly populate them with the
* expected block type size.
*/
struct v4l2_isp_params_block_type_info {
size_t size;
};
/**
* v4l2_isp_params_validate_buffer - Validate a V4L2 ISP parameters buffer
* @dev: the driver's device pointer
* @vb: the videobuf2 buffer
* @buffer: the V4L2 ISP parameters buffer
* @type_info: the array of per-block-type validation info
* @num_block_types: the number of block types in the type_info array
*
* This function completes the validation of a V4L2 ISP parameters buffer,
* verifying each configuration block correctness before the driver can use
* them to program the hardware.
*
* Drivers should use this function after having validated the correctness of
* the vb2 buffer sizes by using the v4l2_isp_params_validate_buffer_size()
* helper first. Once the buffer size has been validated, drivers should
* perform a copy of the user provided buffer into a kernel-only memory buffer
* to prevent userspace from modifying its content after it has been submitted
* to the driver, and then call this function to complete validation.
*/
int v4l2_isp_params_validate_buffer(struct device *dev, struct vb2_buffer *vb,
const struct v4l2_isp_params_buffer *buffer,
const struct v4l2_isp_params_block_type_info *type_info,
size_t num_block_types);
#endif /* _V4L2_ISP_H_ */
|
