drivers/net/can/ctucanfd/ctucanfd.h

Source file repositories/reference/linux-study-clean/drivers/net/can/ctucanfd/ctucanfd.h

File Facts

System
Linux kernel
Corpus path
drivers/net/can/ctucanfd/ctucanfd.h
Extension
.h
Size
2593 bytes
Lines
83
Domain
Driver Families
Bucket
drivers/net
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.

Dependency Surface

Detected Declarations

Annotated Snippet

struct ctucan_priv {
	struct can_priv can; /* must be first member! */

	void __iomem *mem_base;
	u32 (*read_reg)(struct ctucan_priv *priv,
			enum ctu_can_fd_can_registers reg);
	void (*write_reg)(struct ctucan_priv *priv,
			  enum ctu_can_fd_can_registers reg, u32 val);

	unsigned int txb_head;
	unsigned int txb_tail;
	u32 txb_prio;
	unsigned int ntxbufs;
	spinlock_t tx_lock; /* spinlock to serialize allocation and processing of TX buffers */

	struct napi_struct napi;
	struct device *dev;
	struct clk *can_clk;

	int irq_flags;
	unsigned long drv_flags;

	u32 rxfrm_first_word;

	struct list_head peers_on_pdev;
};

/**
 * ctucan_probe_common - Device type independent registration call
 *
 * This function does all the memory allocation and registration for the CAN
 * device.
 *
 * @dev:	Handle to the generic device structure
 * @addr:	Base address of CTU CAN FD core address
 * @irq:	Interrupt number
 * @ntxbufs:	Number of implemented Tx buffers
 * @can_clk_rate: Clock rate, if 0 then clock are taken from device node
 * @pm_enable_call: Whether pm_runtime_enable should be called
 * @set_drvdata_fnc: Function to set network driver data for physical device
 *
 * Return: 0 on success and failure value on error
 */
int ctucan_probe_common(struct device *dev, void __iomem *addr,
			int irq, unsigned int ntxbufs,
			unsigned long can_clk_rate,
			int pm_enable_call,
			void (*set_drvdata_fnc)(struct device *dev,
						struct net_device *ndev));

int ctucan_suspend(struct device *dev) __maybe_unused;
int ctucan_resume(struct device *dev) __maybe_unused;

#endif /*__CTUCANFD__*/

Annotation

Implementation Notes