drivers/staging/media/ipu7/ipu7-isys-queue.h
Source file repositories/reference/linux-study-clean/drivers/staging/media/ipu7/ipu7-isys-queue.h
File Facts
- System
- Linux kernel
- Corpus path
drivers/staging/media/ipu7/ipu7-isys-queue.h- Extension
.h- Size
- 1922 bytes
- Lines
- 73
- Domain
- Driver Families
- Bucket
- drivers/staging
- 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/atomic.hlinux/container_of.hlinux/list.hlinux/spinlock_types.hmedia/videobuf2-v4l2.h
Detected Declarations
struct devicestruct ipu7_isys_streamstruct ipu7_insys_respstruct ipu7_insys_buffsetstruct ipu7_isys_queuestruct ipu7_isys_bufferstruct ipu7_isys_video_bufferstruct ipu7_isys_buffer_list
Annotated Snippet
struct ipu7_isys_queue {
struct vb2_queue vbq;
struct list_head node;
struct device *dev;
spinlock_t lock;
struct list_head active;
struct list_head incoming;
unsigned int fw_output;
};
struct ipu7_isys_buffer {
struct list_head head;
atomic_t str2mmio_flag;
};
struct ipu7_isys_video_buffer {
struct vb2_v4l2_buffer vb_v4l2;
struct ipu7_isys_buffer ib;
dma_addr_t dma_addr;
};
#define IPU_ISYS_BUFFER_LIST_FL_INCOMING BIT(0)
#define IPU_ISYS_BUFFER_LIST_FL_ACTIVE BIT(1)
#define IPU_ISYS_BUFFER_LIST_FL_SET_STATE BIT(2)
struct ipu7_isys_buffer_list {
struct list_head head;
unsigned int nbufs;
};
#define vb2_queue_to_isys_queue(__vb2) \
container_of(__vb2, struct ipu7_isys_queue, vbq)
#define ipu7_isys_to_isys_video_buffer(__ib) \
container_of(__ib, struct ipu7_isys_video_buffer, ib)
#define vb2_buffer_to_ipu7_isys_video_buffer(__vvb) \
container_of(__vvb, struct ipu7_isys_video_buffer, vb_v4l2)
#define ipu7_isys_buffer_to_vb2_buffer(__ib) \
(&ipu7_isys_to_isys_video_buffer(__ib)->vb_v4l2.vb2_buf)
void ipu7_isys_buffer_list_queue(struct ipu7_isys_buffer_list *bl,
unsigned long op_flags,
enum vb2_buffer_state state);
void ipu7_isys_buffer_to_fw_frame_buff(struct ipu7_insys_buffset *set,
struct ipu7_isys_stream *stream,
struct ipu7_isys_buffer_list *bl);
void ipu7_isys_queue_buf_ready(struct ipu7_isys_stream *stream,
struct ipu7_insys_resp *info);
int ipu7_isys_queue_init(struct ipu7_isys_queue *aq);
#endif /* IPU7_ISYS_QUEUE_H */
Annotation
- Immediate include surface: `linux/atomic.h`, `linux/container_of.h`, `linux/list.h`, `linux/spinlock_types.h`, `media/videobuf2-v4l2.h`.
- Detected declarations: `struct device`, `struct ipu7_isys_stream`, `struct ipu7_insys_resp`, `struct ipu7_insys_buffset`, `struct ipu7_isys_queue`, `struct ipu7_isys_buffer`, `struct ipu7_isys_video_buffer`, `struct ipu7_isys_buffer_list`.
- Atlas domain: Driver Families / drivers/staging.
- 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.