drivers/staging/media/ipu7/ipu7-buttress.h

File Facts

System

Linux kernel

Corpus path

drivers/staging/media/ipu7/ipu7-buttress.h

Extension

.h

Size

2291 bytes

Lines

78

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.
• Touches IRQ or DMA behavior; this matters for the representative real-device path.
• Defines or uses C structs; map object ownership, embedded links, reference counts, and lock ownership.

Dependency Surface

• linux/completion.h
• linux/irqreturn.h
• linux/list.h
• linux/mutex.h

Detected Declarations

• struct device
• struct ipu7_device
• struct ipu_buttress_ctrl
• struct ipu_buttress_ipc
• struct ipu_buttress

Annotated Snippet

struct ipu_buttress_ctrl {
	u32 subsys_id;
	u32 freq_ctl, pwr_sts_shift, pwr_sts_mask, pwr_sts_on, pwr_sts_off;
	u32 ratio;
	u32 ratio_shift;
	u32 cdyn;
	u32 cdyn_shift;
	u32 ovrd_clk;
	u32 own_clk_ack;
};

struct ipu_buttress_ipc {
	struct completion send_complete;
	struct completion recv_complete;
	u32 nack;
	u32 nack_mask;
	u32 recv_data;
	u32 csr_out;
	u32 csr_in;
	u32 db0_in;
	u32 db0_out;
	u32 data0_out;
	u32 data0_in;
};

struct ipu_buttress {
	struct mutex power_mutex, auth_mutex, cons_mutex, ipc_mutex;
	struct ipu_buttress_ipc cse;
	u32 psys_min_freq;
	u32 wdt_cached_value;
	u8 psys_force_ratio;
	bool force_suspend;
	u32 ref_clk;
};

int ipu_buttress_ipc_reset(struct ipu7_device *isp,
			   struct ipu_buttress_ipc *ipc);
int ipu_buttress_powerup(struct device *dev,
			 const struct ipu_buttress_ctrl *ctrl);
int ipu_buttress_powerdown(struct device *dev,
			   const struct ipu_buttress_ctrl *ctrl);
bool ipu_buttress_get_secure_mode(struct ipu7_device *isp);
int ipu_buttress_authenticate(struct ipu7_device *isp);
int ipu_buttress_reset_authentication(struct ipu7_device *isp);
bool ipu_buttress_auth_done(struct ipu7_device *isp);
int ipu_buttress_get_isys_freq(struct ipu7_device *isp, u32 *freq);
int ipu_buttress_get_psys_freq(struct ipu7_device *isp, u32 *freq);
int ipu_buttress_start_tsc_sync(struct ipu7_device *isp);
void ipu_buttress_tsc_read(struct ipu7_device *isp, u64 *val);
u64 ipu_buttress_tsc_ticks_to_ns(u64 ticks, const struct ipu7_device *isp);

irqreturn_t ipu_buttress_isr(int irq, void *isp_ptr);
irqreturn_t ipu_buttress_isr_threaded(int irq, void *isp_ptr);
int ipu_buttress_init(struct ipu7_device *isp);
void ipu_buttress_exit(struct ipu7_device *isp);
void ipu_buttress_csi_port_config(struct ipu7_device *isp,
				  u32 legacy, u32 combo);
void ipu_buttress_restore(struct ipu7_device *isp);
void ipu_buttress_wakeup_is_uc(const struct ipu7_device *isp);
void ipu_buttress_wakeup_ps_uc(const struct ipu7_device *isp);
#endif /* IPU7_BUTTRESS_H */

Annotation

• Immediate include surface: `linux/completion.h`, `linux/irqreturn.h`, `linux/list.h`, `linux/mutex.h`.
• Detected declarations: `struct device`, `struct ipu7_device`, `struct ipu_buttress_ctrl`, `struct ipu_buttress_ipc`, `struct ipu_buttress`.
• Atlas domain: Driver Families / drivers/staging.
• Implementation status: source implementation candidate.
• IRQ or DMA behavior appears here, which is relevant to the selected PCIe/NVMe device path.

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.