drivers/media/platform/ti/omap3isp/ispvideo.h
Source file repositories/reference/linux-study-clean/drivers/media/platform/ti/omap3isp/ispvideo.h
File Facts
- System
- Linux kernel
- Corpus path
drivers/media/platform/ti/omap3isp/ispvideo.h- Extension
.h- Size
- 6503 bytes
- Lines
- 219
- Domain
- Driver Families
- Bucket
- drivers/media
- Inferred role
- Driver Families: implementation source
- Status
- source implementation candidate
Why This File Exists
Repeatable hardware-adapter layer. Deep compatibility for every driver is out of scope; this atlas records patterns, probe lifecycles, bus glue, IRQ/DMA usage, and links back to core abstractions.
- Repeatable hardware-adapter layer. Deep compatibility for every driver is out of scope; this atlas records patterns, probe lifecycles, bus glue, IRQ/DMA usage, and links back to core abstractions.
- 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/v4l2-mediabus.hmedia/media-entity.hmedia/v4l2-dev.hmedia/v4l2-fh.hmedia/videobuf2-v4l2.h
Detected Declarations
struct isp_devicestruct isp_videostruct v4l2_mbus_framefmtstruct v4l2_pix_formatstruct isp_format_infostruct isp_pipelinestruct isp_bufferstruct isp_video_operationsstruct isp_videostruct isp_video_fhenum isp_pipeline_stream_stateenum isp_pipeline_stateenum isp_video_dmaqueue_flagsfunction isp_pipeline_ready
Annotated Snippet
struct isp_format_info {
u32 code;
u32 truncated;
u32 uncompressed;
u32 flavor;
u32 pixelformat;
unsigned int width;
unsigned int bpp;
};
enum isp_pipeline_stream_state {
ISP_PIPELINE_STREAM_STOPPED = 0,
ISP_PIPELINE_STREAM_CONTINUOUS = 1,
ISP_PIPELINE_STREAM_SINGLESHOT = 2,
};
enum isp_pipeline_state {
/* The stream has been started on the input video node. */
ISP_PIPELINE_STREAM_INPUT = 1,
/* The stream has been started on the output video node. */
ISP_PIPELINE_STREAM_OUTPUT = 2,
/* At least one buffer is queued on the input video node. */
ISP_PIPELINE_QUEUE_INPUT = 4,
/* At least one buffer is queued on the output video node. */
ISP_PIPELINE_QUEUE_OUTPUT = 8,
/* The input entity is idle, ready to be started. */
ISP_PIPELINE_IDLE_INPUT = 16,
/* The output entity is idle, ready to be started. */
ISP_PIPELINE_IDLE_OUTPUT = 32,
/* The pipeline is currently streaming. */
ISP_PIPELINE_STREAM = 64,
};
/*
* struct isp_pipeline - An ISP hardware pipeline
* @field: The field being processed by the pipeline
* @error: A hardware error occurred during capture
* @ent_enum: Entities in the pipeline
*/
struct isp_pipeline {
struct media_pipeline pipe;
spinlock_t lock; /* Pipeline state and queue flags */
unsigned int state;
enum isp_pipeline_stream_state stream_state;
struct isp_video *input;
struct isp_video *output;
struct media_entity_enum ent_enum;
unsigned long l3_ick;
unsigned int max_rate;
enum v4l2_field field;
atomic_t frame_number;
bool do_propagation; /* of frame number */
bool error;
struct v4l2_fract max_timeperframe;
struct v4l2_subdev *external;
unsigned int external_rate;
unsigned int external_width;
};
static inline struct isp_pipeline *to_isp_pipeline(struct media_entity *entity)
{
struct media_pipeline *pipe = media_entity_pipeline(entity);
if (!pipe)
return NULL;
return container_of(pipe, struct isp_pipeline, pipe);
}
static inline int isp_pipeline_ready(struct isp_pipeline *pipe)
{
return pipe->state == (ISP_PIPELINE_STREAM_INPUT |
ISP_PIPELINE_STREAM_OUTPUT |
ISP_PIPELINE_QUEUE_INPUT |
ISP_PIPELINE_QUEUE_OUTPUT |
ISP_PIPELINE_IDLE_INPUT |
ISP_PIPELINE_IDLE_OUTPUT);
}
/**
* struct isp_buffer - ISP video buffer
* @vb: videobuf2 buffer
* @irqlist: List head for insertion into IRQ queue
* @dma: DMA address
*/
struct isp_buffer {
struct vb2_v4l2_buffer vb;
struct list_head irqlist;
dma_addr_t dma;
};
Annotation
- Immediate include surface: `linux/v4l2-mediabus.h`, `media/media-entity.h`, `media/v4l2-dev.h`, `media/v4l2-fh.h`, `media/videobuf2-v4l2.h`.
- Detected declarations: `struct isp_device`, `struct isp_video`, `struct v4l2_mbus_framefmt`, `struct v4l2_pix_format`, `struct isp_format_info`, `struct isp_pipeline`, `struct isp_buffer`, `struct isp_video_operations`, `struct isp_video`, `struct isp_video_fh`.
- Atlas domain: Driver Families / drivers/media.
- 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.