include/media/vsp1.h
Source file repositories/reference/linux-study-clean/include/media/vsp1.h
File Facts
- System
- Linux kernel
- Corpus path
include/media/vsp1.h- Extension
.h- Size
- 7476 bytes
- Lines
- 215
- Domain
- Repository Root And Misc
- Bucket
- include
- Inferred role
- Repository Root And Misc: implementation source
- Status
- source implementation candidate
Why This File Exists
Top-level or miscellaneous repository surface. Use this as map coverage unless a later manual pass promotes the file into a deeper subsystem dossier.
- Top-level or miscellaneous repository surface. Use this as map coverage unless a later manual pass promotes the file into a deeper subsystem dossier.
- Uses kernel synchronization; read lock ordering, sleepability, and interrupt context assumptions before translating.
- Defines or uses C structs; map object ownership, embedded links, reference counts, and lock ownership.
Dependency Surface
linux/scatterlist.hlinux/types.hlinux/videodev2.h
Detected Declarations
struct devicestruct vsp1_dl_liststruct vsp1_du_lif_configstruct vsp1_du_atomic_configstruct vsp1_du_crc_configstruct vsp1_du_writeback_configstruct vsp1_du_atomic_pipe_configstruct vsp1_isp_buffer_descstruct vsp1_isp_job_descstruct vsp1_vspx_frame_endenum vsp1_du_crc_source
Annotated Snippet
struct vsp1_du_lif_config {
unsigned int width;
unsigned int height;
bool interlaced;
void (*callback)(void *data, unsigned int status, u32 crc);
void *callback_data;
};
int vsp1_du_enable(struct device *dev, unsigned int pipe_index,
const struct vsp1_du_lif_config *cfg);
int vsp1_du_disable(struct device *dev, unsigned int pipe_index);
/**
* struct vsp1_du_atomic_config - VSP atomic configuration parameters
* @pixelformat: plane pixel format (V4L2 4CC)
* @pitch: line pitch in bytes for the first plane
* @mem: DMA memory address for each plane of the frame buffer
* @src: source rectangle in the frame buffer (integer coordinates)
* @dst: destination rectangle on the display (integer coordinates)
* @alpha: alpha value (0: fully transparent, 255: fully opaque)
* @zpos: Z position of the plane (from 0 to number of planes minus 1)
* @premult: true for premultiplied alpha
* @color_encoding: color encoding (valid for YUV formats only)
* @color_range: color range (valid for YUV formats only)
*/
struct vsp1_du_atomic_config {
u32 pixelformat;
unsigned int pitch;
dma_addr_t mem[3];
struct v4l2_rect src;
struct v4l2_rect dst;
unsigned int alpha;
unsigned int zpos;
bool premult;
enum v4l2_ycbcr_encoding color_encoding;
enum v4l2_quantization color_range;
};
/**
* enum vsp1_du_crc_source - Source used for CRC calculation
* @VSP1_DU_CRC_NONE: CRC calculation disabled
* @VSP1_DU_CRC_PLANE: Perform CRC calculation on an input plane
* @VSP1_DU_CRC_OUTPUT: Perform CRC calculation on the composed output
*/
enum vsp1_du_crc_source {
VSP1_DU_CRC_NONE,
VSP1_DU_CRC_PLANE,
VSP1_DU_CRC_OUTPUT,
};
/**
* struct vsp1_du_crc_config - VSP CRC computation configuration parameters
* @source: source for CRC calculation
* @index: index of the CRC source plane (when source is set to plane)
*/
struct vsp1_du_crc_config {
enum vsp1_du_crc_source source;
unsigned int index;
};
/**
* struct vsp1_du_writeback_config - VSP writeback configuration parameters
* @pixelformat: plane pixel format (V4L2 4CC)
* @pitch: line pitch in bytes for the first plane
* @mem: DMA memory address for each plane of the frame buffer
*/
struct vsp1_du_writeback_config {
u32 pixelformat;
unsigned int pitch;
dma_addr_t mem[3];
};
/**
* struct vsp1_du_atomic_pipe_config - VSP atomic pipe configuration parameters
* @crc: CRC computation configuration
* @writeback: writeback configuration
*/
struct vsp1_du_atomic_pipe_config {
struct vsp1_du_crc_config crc;
struct vsp1_du_writeback_config writeback;
};
void vsp1_du_atomic_begin(struct device *dev, unsigned int pipe_index);
int vsp1_du_atomic_update(struct device *dev, unsigned int pipe_index,
unsigned int rpf,
const struct vsp1_du_atomic_config *cfg);
void vsp1_du_atomic_flush(struct device *dev, unsigned int pipe_index,
const struct vsp1_du_atomic_pipe_config *cfg);
int vsp1_du_map_sg(struct device *dev, struct sg_table *sgt);
Annotation
- Immediate include surface: `linux/scatterlist.h`, `linux/types.h`, `linux/videodev2.h`.
- Detected declarations: `struct device`, `struct vsp1_dl_list`, `struct vsp1_du_lif_config`, `struct vsp1_du_atomic_config`, `struct vsp1_du_crc_config`, `struct vsp1_du_writeback_config`, `struct vsp1_du_atomic_pipe_config`, `struct vsp1_isp_buffer_desc`, `struct vsp1_isp_job_desc`, `struct vsp1_vspx_frame_end`.
- Atlas domain: Repository Root And Misc / include.
- Implementation status: source implementation candidate.
- Synchronization appears in or near this file; preserve lock ordering, sleepability, and interrupt-context constraints.
Implementation Notes
- This generated page is the file-by-file coverage layer; curated subsystem chapters should link here when they synthesize a multi-file control flow.
- Core OS pages should be promoted from atlas-only to deep-reviewed when they explain data structures, invariants, locking, lifecycle, and C implementation snippets.
- Driver-family pages are intentionally pattern-oriented unless they are part of the selected PCIe/NVMe representative device path.