mirror of
				https://github.com/torvalds/linux.git
				synced 2025-11-04 02:30:34 +02:00 
			
		
		
		
	drm/xe: Add xe_mmio_init() initialization function
Add a convenience function for minimal initialization of struct xe_mmio. This function also validates that the entirety of the provided mmio region is usable with struct xe_reg. v2: Modify commit message, add kernel doc, refactor assert (Michal) v3: Fix off-by-one bug, add clarifying macro (Michal) v4: Derive bitfield width from size (Michal) Signed-off-by: Ilia Levi <ilia.levi@intel.com> Reviewed-by: Michal Wajdeczko <michal.wajdeczko@intel.com> Reviewed-by: Lucas De Marchi <lucas.demarchi@intel.com> Link: https://patchwork.freedesktop.org/patch/msgid/20250213093559.204652-1-ilia.levi@intel.com Signed-off-by: Lucas De Marchi <lucas.demarchi@intel.com>
This commit is contained in:
		
							parent
							
								
									5bee1e2de3
								
							
						
					
					
						commit
						eb79d71e50
					
				
					 4 changed files with 39 additions and 16 deletions
				
			
		| 
						 | 
					@ -7,9 +7,21 @@
 | 
				
			||||||
#define _XE_REG_DEFS_H_
 | 
					#define _XE_REG_DEFS_H_
 | 
				
			||||||
 | 
					
 | 
				
			||||||
#include <linux/build_bug.h>
 | 
					#include <linux/build_bug.h>
 | 
				
			||||||
 | 
					#include <linux/log2.h>
 | 
				
			||||||
 | 
					#include <linux/sizes.h>
 | 
				
			||||||
 | 
					
 | 
				
			||||||
#include "compat-i915-headers/i915_reg_defs.h"
 | 
					#include "compat-i915-headers/i915_reg_defs.h"
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					/**
 | 
				
			||||||
 | 
					 * XE_REG_ADDR_MAX - The upper limit on MMIO register address
 | 
				
			||||||
 | 
					 *
 | 
				
			||||||
 | 
					 * This macro specifies the upper limit (not inclusive) on MMIO register offset
 | 
				
			||||||
 | 
					 * supported by struct xe_reg and functions based on struct xe_mmio.
 | 
				
			||||||
 | 
					 *
 | 
				
			||||||
 | 
					 * Currently this is defined as 4 MiB.
 | 
				
			||||||
 | 
					 */
 | 
				
			||||||
 | 
					#define XE_REG_ADDR_MAX	SZ_4M
 | 
				
			||||||
 | 
					
 | 
				
			||||||
/**
 | 
					/**
 | 
				
			||||||
 * struct xe_reg - Register definition
 | 
					 * struct xe_reg - Register definition
 | 
				
			||||||
 *
 | 
					 *
 | 
				
			||||||
| 
						 | 
					@ -21,7 +33,7 @@ struct xe_reg {
 | 
				
			||||||
	union {
 | 
						union {
 | 
				
			||||||
		struct {
 | 
							struct {
 | 
				
			||||||
			/** @addr: address */
 | 
								/** @addr: address */
 | 
				
			||||||
			u32 addr:22;
 | 
								u32 addr:const_ilog2(XE_REG_ADDR_MAX);
 | 
				
			||||||
			/**
 | 
								/**
 | 
				
			||||||
			 * @masked: register is "masked", with upper 16bits used
 | 
								 * @masked: register is "masked", with upper 16bits used
 | 
				
			||||||
			 * to identify the bits that are updated on the lower
 | 
								 * to identify the bits that are updated on the lower
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
| 
						 | 
					@ -626,10 +626,9 @@ int xe_gt_init(struct xe_gt *gt)
 | 
				
			||||||
void xe_gt_mmio_init(struct xe_gt *gt)
 | 
					void xe_gt_mmio_init(struct xe_gt *gt)
 | 
				
			||||||
{
 | 
					{
 | 
				
			||||||
	struct xe_tile *tile = gt_to_tile(gt);
 | 
						struct xe_tile *tile = gt_to_tile(gt);
 | 
				
			||||||
 | 
						struct xe_device *xe = tile_to_xe(tile);
 | 
				
			||||||
 | 
					
 | 
				
			||||||
	gt->mmio.regs = tile->mmio.regs;
 | 
						xe_mmio_init(>->mmio, tile, tile->mmio.regs, tile->mmio.regs_size);
 | 
				
			||||||
	gt->mmio.regs_size = tile->mmio.regs_size;
 | 
					 | 
				
			||||||
	gt->mmio.tile = tile;
 | 
					 | 
				
			||||||
 | 
					
 | 
				
			||||||
	if (gt->info.type == XE_GT_TYPE_MEDIA) {
 | 
						if (gt->info.type == XE_GT_TYPE_MEDIA) {
 | 
				
			||||||
		gt->mmio.adj_offset = MEDIA_GT_GSI_OFFSET;
 | 
							gt->mmio.adj_offset = MEDIA_GT_GSI_OFFSET;
 | 
				
			||||||
| 
						 | 
					@ -639,7 +638,7 @@ void xe_gt_mmio_init(struct xe_gt *gt)
 | 
				
			||||||
		gt->mmio.adj_limit = 0;
 | 
							gt->mmio.adj_limit = 0;
 | 
				
			||||||
	}
 | 
						}
 | 
				
			||||||
 | 
					
 | 
				
			||||||
	if (IS_SRIOV_VF(gt_to_xe(gt)))
 | 
						if (IS_SRIOV_VF(xe))
 | 
				
			||||||
		gt->mmio.sriov_vf_gt = gt;
 | 
							gt->mmio.sriov_vf_gt = gt;
 | 
				
			||||||
}
 | 
					}
 | 
				
			||||||
 | 
					
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
| 
						 | 
					@ -55,7 +55,6 @@ static void tiles_fini(void *arg)
 | 
				
			||||||
static void mmio_multi_tile_setup(struct xe_device *xe, size_t tile_mmio_size)
 | 
					static void mmio_multi_tile_setup(struct xe_device *xe, size_t tile_mmio_size)
 | 
				
			||||||
{
 | 
					{
 | 
				
			||||||
	struct xe_tile *tile;
 | 
						struct xe_tile *tile;
 | 
				
			||||||
	void __iomem *regs;
 | 
					 | 
				
			||||||
	u8 id;
 | 
						u8 id;
 | 
				
			||||||
 | 
					
 | 
				
			||||||
	/*
 | 
						/*
 | 
				
			||||||
| 
						 | 
					@ -94,13 +93,8 @@ static void mmio_multi_tile_setup(struct xe_device *xe, size_t tile_mmio_size)
 | 
				
			||||||
		}
 | 
							}
 | 
				
			||||||
	}
 | 
						}
 | 
				
			||||||
 | 
					
 | 
				
			||||||
	regs = xe->mmio.regs;
 | 
						for_each_remote_tile(tile, xe, id)
 | 
				
			||||||
	for_each_tile(tile, xe, id) {
 | 
							xe_mmio_init(&tile->mmio, tile, xe->mmio.regs + id * tile_mmio_size, SZ_4M);
 | 
				
			||||||
		tile->mmio.regs_size = SZ_4M;
 | 
					 | 
				
			||||||
		tile->mmio.regs = regs;
 | 
					 | 
				
			||||||
		tile->mmio.tile = tile;
 | 
					 | 
				
			||||||
		regs += tile_mmio_size;
 | 
					 | 
				
			||||||
	}
 | 
					 | 
				
			||||||
}
 | 
					}
 | 
				
			||||||
 | 
					
 | 
				
			||||||
int xe_mmio_probe_tiles(struct xe_device *xe)
 | 
					int xe_mmio_probe_tiles(struct xe_device *xe)
 | 
				
			||||||
| 
						 | 
					@ -140,13 +134,29 @@ int xe_mmio_probe_early(struct xe_device *xe)
 | 
				
			||||||
	}
 | 
						}
 | 
				
			||||||
 | 
					
 | 
				
			||||||
	/* Setup first tile; other tiles (if present) will be setup later. */
 | 
						/* Setup first tile; other tiles (if present) will be setup later. */
 | 
				
			||||||
	root_tile->mmio.regs_size = SZ_4M;
 | 
						xe_mmio_init(&root_tile->mmio, root_tile, xe->mmio.regs, SZ_4M);
 | 
				
			||||||
	root_tile->mmio.regs = xe->mmio.regs;
 | 
					 | 
				
			||||||
	root_tile->mmio.tile = root_tile;
 | 
					 | 
				
			||||||
 | 
					
 | 
				
			||||||
	return devm_add_action_or_reset(xe->drm.dev, mmio_fini, xe);
 | 
						return devm_add_action_or_reset(xe->drm.dev, mmio_fini, xe);
 | 
				
			||||||
}
 | 
					}
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					/**
 | 
				
			||||||
 | 
					 * xe_mmio_init() - Initialize an MMIO instance
 | 
				
			||||||
 | 
					 * @mmio: Pointer to the MMIO instance to initialize
 | 
				
			||||||
 | 
					 * @tile: The tile to which the MMIO region belongs
 | 
				
			||||||
 | 
					 * @ptr: Pointer to the start of the MMIO region
 | 
				
			||||||
 | 
					 * @size: The size of the MMIO region in bytes
 | 
				
			||||||
 | 
					 *
 | 
				
			||||||
 | 
					 * This is a convenience function for minimal initialization of struct xe_mmio.
 | 
				
			||||||
 | 
					 */
 | 
				
			||||||
 | 
					void xe_mmio_init(struct xe_mmio *mmio, struct xe_tile *tile, void __iomem *ptr, u32 size)
 | 
				
			||||||
 | 
					{
 | 
				
			||||||
 | 
						xe_tile_assert(tile, size <= XE_REG_ADDR_MAX);
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
						mmio->regs = ptr;
 | 
				
			||||||
 | 
						mmio->regs_size = size;
 | 
				
			||||||
 | 
						mmio->tile = tile;
 | 
				
			||||||
 | 
					}
 | 
				
			||||||
 | 
					
 | 
				
			||||||
static void mmio_flush_pending_writes(struct xe_mmio *mmio)
 | 
					static void mmio_flush_pending_writes(struct xe_mmio *mmio)
 | 
				
			||||||
{
 | 
					{
 | 
				
			||||||
#define DUMMY_REG_OFFSET	0x130030
 | 
					#define DUMMY_REG_OFFSET	0x130030
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
| 
						 | 
					@ -14,6 +14,8 @@ struct xe_reg;
 | 
				
			||||||
int xe_mmio_probe_early(struct xe_device *xe);
 | 
					int xe_mmio_probe_early(struct xe_device *xe);
 | 
				
			||||||
int xe_mmio_probe_tiles(struct xe_device *xe);
 | 
					int xe_mmio_probe_tiles(struct xe_device *xe);
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					void xe_mmio_init(struct xe_mmio *mmio, struct xe_tile *tile, void __iomem *ptr, u32 size);
 | 
				
			||||||
 | 
					
 | 
				
			||||||
u8 xe_mmio_read8(struct xe_mmio *mmio, struct xe_reg reg);
 | 
					u8 xe_mmio_read8(struct xe_mmio *mmio, struct xe_reg reg);
 | 
				
			||||||
u16 xe_mmio_read16(struct xe_mmio *mmio, struct xe_reg reg);
 | 
					u16 xe_mmio_read16(struct xe_mmio *mmio, struct xe_reg reg);
 | 
				
			||||||
void xe_mmio_write32(struct xe_mmio *mmio, struct xe_reg reg, u32 val);
 | 
					void xe_mmio_write32(struct xe_mmio *mmio, struct xe_reg reg, u32 val);
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
		Loading…
	
		Reference in a new issue