drivers/staging/media/ipu7/ipu7-isys.c
Source file repositories/reference/linux-study-clean/drivers/staging/media/ipu7/ipu7-isys.c
File Facts
- System
- Linux kernel
- Corpus path
drivers/staging/media/ipu7/ipu7-isys.c- Extension
.c- Size
- 30459 bytes
- Lines
- 1167
- 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.
- Touches IRQ or DMA behavior; this matters for the representative real-device path.
- Allocates kernel memory; connect allocation flags and lifetime to context constraints.
- Defines or uses C structs; map object ownership, embedded links, reference counts, and lock ownership.
Dependency Surface
linux/auxiliary_bus.hlinux/bitfield.hlinux/bits.hlinux/bug.hlinux/completion.hlinux/container_of.hlinux/delay.hlinux/device.hlinux/dma-mapping.hlinux/err.hlinux/firmware.hlinux/list.hlinux/module.hlinux/mutex.hlinux/pci.hlinux/pm_runtime.hlinux/pm_qos.hlinux/slab.hlinux/spinlock.hlinux/string.hlinux/types.hmedia/ipu-bridge.hmedia/media-entity.hmedia/v4l2-async.hmedia/v4l2-device.hmedia/v4l2-fwnode.hmedia/v4l2-subdev.habi/ipu7_fw_isys_abi.hipu7-bus.hipu7-buttress-regs.hipu7-cpd.hipu7-dma.h
Detected Declarations
struct ipu7_csi2_errorstruct resp_to_msgfunction Copyrightfunction isys_stream_initfunction isys_fw_log_initfunction isys_notifier_boundfunction isys_notifier_completefunction isys_notifier_initfunction isys_notifier_cleanupfunction isys_unregister_video_devicesfunction isys_register_video_devicesfunction isys_csi2_unregister_subdevicesfunction isys_csi2_register_subdevicesfunction isys_csi2_create_media_linksfunction isys_register_devicesfunction isys_unregister_devicesfunction enable_csi2_legacy_irqfunction enable_to_sw_irqfunction ipu7_isys_setup_hwfunction isys_cleanup_hwfunction isys_runtime_pm_resumefunction isys_runtime_pm_suspendfunction isys_suspendfunction isys_resumefunction isys_removefunction alloc_fw_msg_bufsfunction ipu7_cleanup_fw_msg_bufsfunction ipu7_put_fw_msg_buffunction isys_probefunction ipu7_isys_register_errorsfunction ipu7_isys_csi2_errorfunction isys_isr_onefunction ipu7_isys_csi2_isrfunction isys_isr
Annotated Snippet
struct ipu7_csi2_error {
const char *error_string;
bool is_info_only;
};
/*
* Strings corresponding to CSI-2 receiver errors are here.
* Corresponding macros are defined in the header file.
*/
static const struct ipu7_csi2_error dphy_rx_errors[] = {
{ "Error handler FIFO full", false },
{ "Reserved Short Packet encoding detected", true },
{ "Reserved Long Packet encoding detected", true },
{ "Received packet is too short", false},
{ "Received packet is too long", false},
{ "Short packet discarded due to errors", false },
{ "Long packet discarded due to errors", false },
{ "CSI Combo Rx interrupt", false },
{ "IDI CDC FIFO overflow(remaining bits are reserved as 0)", false },
{ "Received NULL packet", true },
{ "Received blanking packet", true },
{ "Tie to 0", true },
{ }
};
static void ipu7_isys_register_errors(struct ipu7_isys_csi2 *csi2)
{
u32 offset = IS_IO_CSI2_ERR_LEGACY_IRQ_CTL_BASE(csi2->port);
u32 status = readl(csi2->base + offset + IRQ_CTL_STATUS);
u32 mask = IPU7_CSI_RX_ERROR_IRQ_MASK;
if (!status)
return;
dev_dbg(&csi2->isys->adev->auxdev.dev, "csi2-%u error status 0x%08x\n",
csi2->port, status);
writel(status & mask, csi2->base + offset + IRQ_CTL_CLEAR);
csi2->receiver_errors |= status & mask;
}
static void ipu7_isys_csi2_error(struct ipu7_isys_csi2 *csi2)
{
struct ipu7_csi2_error const *errors;
unsigned int i;
u32 status;
/* Register errors once more in case of error interrupts are disabled */
ipu7_isys_register_errors(csi2);
status = csi2->receiver_errors;
csi2->receiver_errors = 0;
errors = dphy_rx_errors;
for (i = 0; i < CSI_RX_NUM_ERRORS_IN_IRQ; i++) {
if (status & BIT(i))
dev_err_ratelimited(&csi2->isys->adev->auxdev.dev,
"csi2-%i error: %s\n",
csi2->port,
errors[i].error_string);
}
}
struct resp_to_msg {
enum ipu7_insys_resp_type type;
const char *msg;
};
static const struct resp_to_msg is_fw_msg[] = {
{IPU_INSYS_RESP_TYPE_STREAM_OPEN_DONE,
"IPU_INSYS_RESP_TYPE_STREAM_OPEN_DONE"},
{IPU_INSYS_RESP_TYPE_STREAM_START_AND_CAPTURE_ACK,
"IPU_INSYS_RESP_TYPE_STREAM_START_AND_CAPTURE_ACK"},
{IPU_INSYS_RESP_TYPE_STREAM_CAPTURE_ACK,
"IPU_INSYS_RESP_TYPE_STREAM_CAPTURE_ACK"},
{IPU_INSYS_RESP_TYPE_STREAM_ABORT_ACK,
"IPU_INSYS_RESP_TYPE_STREAM_ABORT_ACK"},
{IPU_INSYS_RESP_TYPE_STREAM_FLUSH_ACK,
"IPU_INSYS_RESP_TYPE_STREAM_FLUSH_ACK"},
{IPU_INSYS_RESP_TYPE_STREAM_CLOSE_ACK,
"IPU_INSYS_RESP_TYPE_STREAM_CLOSE_ACK"},
{IPU_INSYS_RESP_TYPE_PIN_DATA_READY,
"IPU_INSYS_RESP_TYPE_PIN_DATA_READY"},
{IPU_INSYS_RESP_TYPE_FRAME_SOF, "IPU_INSYS_RESP_TYPE_FRAME_SOF"},
{IPU_INSYS_RESP_TYPE_FRAME_EOF, "IPU_INSYS_RESP_TYPE_FRAME_EOF"},
{IPU_INSYS_RESP_TYPE_STREAM_START_AND_CAPTURE_DONE,
"IPU_INSYS_RESP_TYPE_STREAM_START_AND_CAPTURE_DONE"},
{IPU_INSYS_RESP_TYPE_STREAM_CAPTURE_DONE,
"IPU_INSYS_RESP_TYPE_STREAM_CAPTURE_DONE"},
{N_IPU_INSYS_RESP_TYPE, "N_IPU_INSYS_RESP_TYPE"},
};
Annotation
- Immediate include surface: `linux/auxiliary_bus.h`, `linux/bitfield.h`, `linux/bits.h`, `linux/bug.h`, `linux/completion.h`, `linux/container_of.h`, `linux/delay.h`, `linux/device.h`.
- Detected declarations: `struct ipu7_csi2_error`, `struct resp_to_msg`, `function Copyright`, `function isys_stream_init`, `function isys_fw_log_init`, `function isys_notifier_bound`, `function isys_notifier_complete`, `function isys_notifier_init`, `function isys_notifier_cleanup`, `function isys_unregister_video_devices`.
- 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.
- 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.