drivers/accel/amdxdna/amdxdna_gem.h

Source file repositories/reference/linux-study-clean/drivers/accel/amdxdna/amdxdna_gem.h

File Facts

System
Linux kernel
Corpus path
drivers/accel/amdxdna/amdxdna_gem.h
Extension
.h
Size
3477 bytes
Lines
120
Domain
Driver Families
Bucket
drivers/accel
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 amdxdna_umap {
	struct vm_area_struct		*vma;
	struct mmu_interval_notifier	notifier;
	struct hmm_range		range;
	struct work_struct		hmm_unreg_work;
	struct amdxdna_gem_obj		*abo;
	struct list_head		node;
	struct kref			refcnt;
	bool				invalid;
	bool				unmapped;
};

struct amdxdna_mem {
	void				*kva;
	u64				dma_addr;
	size_t				size;
	struct list_head		umap_list;
	bool				map_invalid;
	/*
	 * Cache the first mmap uva as PASID addr, which can be accessed by driver
	 * without taking notifier_lock.
	 */
	u64				uva;
};

struct amdxdna_gem_obj {
	struct drm_gem_shmem_object	base;
	struct amdxdna_client		*client;
	u8				type;
	bool				pinned;
	struct mutex			lock; /* Protects: pinned, mem.kva, open_ref */
	struct amdxdna_mem		mem;
	int				open_ref;

	/* Below members are initialized when needed */
	struct drm_mm_node		mm_node; /* For AMDXDNA_BO_DEV */
	u32				heap_start_id;
	u32				heap_end_id;
	u64				dev_addr; /* For heap bo */
	u32				assigned_hwctx;
	struct dma_buf			*dma_buf;
	struct dma_buf_attachment	*attach;

	/* True, if BO is managed by XRT, not application */
	bool				internal;
	/* True, if BO is not exportable */
	bool				private_buffer;
};

#define to_gobj(obj)    (&(obj)->base.base)
#define is_import_bo(obj) ((obj)->attach)

static inline struct amdxdna_gem_obj *to_xdna_obj(struct drm_gem_object *gobj)
{
	return container_of(gobj, struct amdxdna_gem_obj, base.base);
}

struct amdxdna_gem_obj *amdxdna_gem_get_obj(struct amdxdna_client *client,
					    u32 bo_hdl, u8 bo_type);
static inline void amdxdna_gem_put_obj(struct amdxdna_gem_obj *abo)
{
	drm_gem_object_put(to_gobj(abo));
}

/*
 * Obtain the user virtual address for accessing the BO.
 * It can be used for device to access the BO when PASID is enabled.
 */
static inline u64 amdxdna_gem_uva(struct amdxdna_gem_obj *abo)
{
	return abo->mem.uva;
}

void *amdxdna_gem_vmap(struct amdxdna_gem_obj *abo);
u64 amdxdna_gem_dev_addr(struct amdxdna_gem_obj *abo);

static inline u64 amdxdna_dev_bo_offset(struct amdxdna_gem_obj *abo)
{
	return amdxdna_gem_dev_addr(abo) - abo->client->xdna->dev_info->dev_mem_base;
}

static inline u64 amdxdna_obj_dma_addr(struct amdxdna_gem_obj *abo)
{
	return amdxdna_pasid_on(abo->client) ? amdxdna_gem_uva(abo) : abo->mem.dma_addr;
}

void amdxdna_umap_put(struct amdxdna_umap *mapp);

struct drm_gem_object *
amdxdna_gem_create_shmem_object_cb(struct drm_device *dev, size_t size);

Annotation

Implementation Notes