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:
Ilia Levi 2025-02-13 11:35:59 +02:00 committed by Lucas De Marchi
parent 5bee1e2de3
commit eb79d71e50
4 changed files with 39 additions and 16 deletions

View file

@ -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

View file

@ -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(&gt->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;
} }

View file

@ -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

View file

@ -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);