drivers/net/ipa/ipa_gsi.h

Source file repositories/reference/linux-study-clean/drivers/net/ipa/ipa_gsi.h

File Facts

System
Linux kernel
Corpus path
drivers/net/ipa/ipa_gsi.h
Extension
.h
Size
2320 bytes
Lines
72
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

#ifndef _IPA_GSI_TRANS_H_
#define _IPA_GSI_TRANS_H_

#include <linux/types.h>

struct gsi;
struct gsi_trans;
struct ipa_gsi_endpoint_data;

/**
 * ipa_gsi_trans_complete() - GSI transaction completion callback
 * @trans:	Transaction that has completed
 *
 * This called from the GSI layer to notify the IPA layer that a
 * transaction has completed.
 */
void ipa_gsi_trans_complete(struct gsi_trans *trans);

/**
 * ipa_gsi_trans_release() - GSI transaction release callback
 * @trans:	Transaction whose resources should be freed
 *
 * This called from the GSI layer to notify the IPA layer that a
 * transaction is about to be freed, so any resources associated
 * with it should be released.
 */
void ipa_gsi_trans_release(struct gsi_trans *trans);

/**
 * ipa_gsi_channel_tx_queued() - GSI queued to hardware notification
 * @gsi:	GSI pointer
 * @channel_id:	Channel number
 * @count:	Number of transactions queued
 * @byte_count:	Number of bytes to transfer represented by transactions
 *
 * This called from the GSI layer to notify the IPA layer that some
 * number of transactions have been queued to hardware for execution.
 */
void ipa_gsi_channel_tx_queued(struct gsi *gsi, u32 channel_id, u32 count,
			       u32 byte_count);

/**
 * ipa_gsi_channel_tx_completed() - GSI transaction completion callback
 * @gsi:	GSI pointer
 * @channel_id:	Channel number
 * @count:	Number of transactions completed since last report
 * @byte_count:	Number of bytes transferred represented by transactions
 *
 * This called from the GSI layer to notify the IPA layer that the hardware
 * has reported the completion of some number of transactions.
 */
void ipa_gsi_channel_tx_completed(struct gsi *gsi, u32 channel_id, u32 count,
				  u32 byte_count);

/* ipa_gsi_endpoint_data_empty() - Empty endpoint config data test
 * @data:	endpoint configuration data
 *
 * Determines whether an endpoint configuration data entry is empty,
 * meaning it contains no valid configuration information and should
 * be ignored.
 *
 * Return:	true if empty; false otherwise
 */
bool ipa_gsi_endpoint_data_empty(const struct ipa_gsi_endpoint_data *data);

#endif /* _IPA_GSI_TRANS_H_ */

Annotation

Implementation Notes