mirror of https://github.com/torvalds/linux.git
92 lines
3.5 KiB
C
92 lines
3.5 KiB
C
/* 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_ */
|