This file contains common libraries used for testing. More...

#include "test_library.h"
#include "math.h"
#include <assert.h>
#include <fcntl.h>
#include <stdio.h>
#include <sys/mman.h>
#include <vector>

Include dependency graph for test_library.cpp:

Go to the source code of this file.

Macros
#define	SYSFS_PATH_MAX 63

Functions
void	mlir_aie_deinit_libxaie (aie_libxaie_ctx_t *ctx)
	Release access to the libXAIE context.

int	mlir_aie_init_device (aie_libxaie_ctx_t *ctx, uint32_t device_id)
	Initialize the device represented by the context.

int	mlir_aie_acquire_lock (aie_libxaie_ctx_t *ctx, int col, int row, int lockid, int lockval, int timeout)
	Acquire a physical lock.

int	mlir_aie_release_lock (aie_libxaie_ctx_t *ctx, int col, int row, int lockid, int lockval, int timeout)
	Release a physical lock.

u32	mlir_aie_read32 (aie_libxaie_ctx_t *ctx, u64 addr)
	Read the AIE configuration memory at the given physical address.

void	mlir_aie_write32 (aie_libxaie_ctx_t *ctx, u64 addr, u32 val)
	Write the AIE configuration memory at the given physical address.

u32	mlir_aie_data_mem_rd_word (aie_libxaie_ctx_t *ctx, int col, int row, u64 addr)
	Read a value from the data memory of a particular tile memory.

void	mlir_aie_data_mem_wr_word (aie_libxaie_ctx_t *ctx, int col, int row, u64 addr, u32 data)
	Write a value to the data memory of a particular tile memory.

u64	mlir_aie_get_tile_addr (aie_libxaie_ctx_t *ctx, int col, int row)
	Return the base address of the given tile.

void	mlir_aie_dump_tile_memory (aie_libxaie_ctx_t *ctx, int col, int row)
	Dump the tile memory of the given tile Values that are zero are not shown.

void	mlir_aie_clear_tile_memory (aie_libxaie_ctx_t *ctx, int col, int row)
	Fill the tile memory of the given tile with zeros.

void	mlir_aie_print_dma_status (aie_libxaie_ctx_t *ctx, int col, int row)
	Print a summary of the status of the given Tile DMA.

void	print_aie2_lock_status (aie_libxaie_ctx_t ctx, int col, int row, const char type, int lockOffset, int locks)

void	mlir_aie_print_memtiledma_status (aie_libxaie_ctx_t *ctx, int col, int row)
	Print a summary of the status of the given MemTile DMA.

void	mlir_aie_print_shimdma_status (aie_libxaie_ctx_t *ctx, int col, int row)
	Print a summary of the status of the given Shim DMA.

void	mlir_aie_print_tile_status (aie_libxaie_ctx_t *ctx, int col, int row)
	Print the status of a core represented by the given tile, at the given coordinates.

void	mlir_aie_clear_config (aie_libxaie_ctx_t *ctx, int col, int row)
	Clear the configuration of the given (non-shim) tile.

void	mlir_aie_clear_shim_config (aie_libxaie_ctx_t *ctx, int col, int row)
	Clear the configuration of the given shim tile.

void	computeStats (u32 performance_counter[], int n)
	Given an array of values, compute and print statistics about those values.

Detailed Description

This file contains common libraries used for testing.

Many of these functions are relatively thin wrappers around underlying libXAIE call and are provided to expose a relatively consistent API. Others are more complex.

Definition in file test_library.cpp.

Macro Definition Documentation

◆ SYSFS_PATH_MAX

#define SYSFS_PATH_MAX 63

Definition at line 25 of file test_library.cpp.

Function Documentation

◆ computeStats()

void computeStats	(	u32	performance_counter[],
		int	n
	)

Given an array of values, compute and print statistics about those values.

Parameters

performance_counter	An array of values
n	The number of values

Definition at line 1104 of file test_library.cpp.

◆ mlir_aie_acquire_lock()

int mlir_aie_acquire_lock	(	aie_libxaie_ctx_t *	ctx,
		int	col,
		int	row,
		int	lockid,
		int	lockval,
		int	timeout
	)

Acquire a physical lock.

Parameters

ctx	The context
col	The column of the lock
row	The row of the lock
lockid	The ID of the lock in the tile.
lockval	The value to acquire the lock with.
timeout	The number of microseconds to wait

Returns: Return non-zero on success, i.e. the operation did not timeout.

Definition at line 304 of file test_library.cpp.

References aie_libxaie_ctx_t::DevInst.

◆ mlir_aie_clear_config()

void mlir_aie_clear_config	(	aie_libxaie_ctx_t *	ctx,
		int	col,
		int	row
	)

Clear the configuration of the given (non-shim) tile.

Zero out the program and configuration memory of the tile.

This includes: clearing the program memory, data memory, DMA descriptors, and stream switch configuration.

Definition at line 1046 of file test_library.cpp.

References aie_libxaie_ctx_t::DevInst, and mlir_aie_get_tile_addr().

◆ mlir_aie_clear_shim_config()

void mlir_aie_clear_shim_config	(	aie_libxaie_ctx_t *	ctx,
		int	col,
		int	row
	)

Clear the configuration of the given shim tile.

Zero out the configuration memory of the shim tile.

This includes: clearing the program memory, data memory, DMA descriptors, and stream switch configuration.

Definition at line 1076 of file test_library.cpp.

References aie_libxaie_ctx_t::DevInst, and mlir_aie_get_tile_addr().

◆ mlir_aie_clear_tile_memory()

void mlir_aie_clear_tile_memory	(	aie_libxaie_ctx_t *	ctx,
		int	col,
		int	row
	)

Fill the tile memory of the given tile with zeros.

Clear the contents of the memory associated with the given tile.

Values that are zero are not shown

Definition at line 378 of file test_library.cpp.

References aie_libxaie_ctx_t::DevInst.

◆ mlir_aie_data_mem_rd_word()

u32 mlir_aie_data_mem_rd_word	(	aie_libxaie_ctx_t *	ctx,
		int	col,
		int	row,
		u64	addr
	)

Read a value from the data memory of a particular tile memory.

Parameters

addr	The address in the given tile.

Returns: The data

Definition at line 341 of file test_library.cpp.

References aie_libxaie_ctx_t::DevInst.

◆ mlir_aie_data_mem_wr_word()

void mlir_aie_data_mem_wr_word	(	aie_libxaie_ctx_t *	ctx,
		int	col,
		int	row,
		u64	addr,
		u32	data
	)

Write a value to the data memory of a particular tile memory.

Parameters

addr	The address in the given tile.
data	The data

Definition at line 351 of file test_library.cpp.

References aie_libxaie_ctx_t::DevInst.

◆ mlir_aie_deinit_libxaie()

void mlir_aie_deinit_libxaie ( aie_libxaie_ctx_t * ctx )

Release access to the libXAIE context.

Parameters

ctx	The context

Definition at line 153 of file test_library.cpp.

References aie_libxaie_ctx_t::DevInst.

◆ mlir_aie_dump_tile_memory()

void mlir_aie_dump_tile_memory	(	aie_libxaie_ctx_t *	ctx,
		int	col,
		int	row
	)

Dump the tile memory of the given tile Values that are zero are not shown.

Dump the contents of the memory associated with the given tile.

Definition at line 366 of file test_library.cpp.

References aie_libxaie_ctx_t::DevInst.

◆ mlir_aie_get_tile_addr()

u64 mlir_aie_get_tile_addr	(	aie_libxaie_ctx_t *	ctx,
		int	col,
		int	row
	)

Return the base address of the given tile.

The configuration address space of most tiles is very similar, relative to this base address.

Definition at line 359 of file test_library.cpp.

References aie_libxaie_ctx_t::DevInst.

Referenced by mlir_aie_clear_config(), mlir_aie_clear_shim_config(), mlir_aie_print_dma_status(), mlir_aie_print_memtiledma_status(), mlir_aie_print_shimdma_status(), mlir_aie_print_tile_status(), and print_aie2_lock_status().

◆ mlir_aie_init_device()

int mlir_aie_init_device	(	aie_libxaie_ctx_t *	ctx,
		uint32_t	device_id
	)

Initialize the device represented by the context.

Parameters

ctx	The context

Returns: Zero on success

Definition at line 171 of file test_library.cpp.

References aie_libxaie_ctx_t::AieConfigPtr, aie_libxaie_ctx_t::DevInst, and SYSFS_PATH_MAX.

◆ mlir_aie_print_dma_status()

void mlir_aie_print_dma_status	(	aie_libxaie_ctx_t *	ctx,
		int	col,
		int	row
	)

Print a summary of the status of the given Tile DMA.

Print the status of a dma represented by the given tile.

Definition at line 508 of file test_library.cpp.

References aie_libxaie_ctx_t::AieConfigPtr, aie_libxaie_ctx_t::DevInst, and mlir_aie_get_tile_addr().

◆ mlir_aie_print_memtiledma_status()

void mlir_aie_print_memtiledma_status	(	aie_libxaie_ctx_t *	ctx,
		int	col,
		int	row
	)

Print a summary of the status of the given MemTile DMA.

Print the status of a memtiledma represented by the given location.

Definition at line 713 of file test_library.cpp.

References aie_libxaie_ctx_t::AieConfigPtr, aie_libxaie_ctx_t::DevInst, mlir_aie_get_tile_addr(), and print_aie2_lock_status().

◆ mlir_aie_print_shimdma_status()

void mlir_aie_print_shimdma_status	(	aie_libxaie_ctx_t *	ctx,
		int	col,
		int	row
	)

Print a summary of the status of the given Shim DMA.

Print the status of a shimdma represented by the given location (row = 0).

Definition at line 775 of file test_library.cpp.

References aie_libxaie_ctx_t::AieConfigPtr, aie_libxaie_ctx_t::DevInst, mlir_aie_get_tile_addr(), and print_aie2_lock_status().

◆ mlir_aie_print_tile_status()

void mlir_aie_print_tile_status	(	aie_libxaie_ctx_t *	ctx,
		int	col,
		int	row
	)

Print the status of a core represented by the given tile, at the given coordinates.

Print the status of a core represented by the given tile.

Definition at line 945 of file test_library.cpp.

References aie_libxaie_ctx_t::AieConfigPtr, aie_libxaie_ctx_t::DevInst, mlir_aie_get_tile_addr(), and print_aie2_lock_status().

◆ mlir_aie_read32()

u32 mlir_aie_read32	(	aie_libxaie_ctx_t *	ctx,
		u64	addr
	)

Read the AIE configuration memory at the given physical address.

Definition at line 325 of file test_library.cpp.

References aie_libxaie_ctx_t::DevInst.

◆ mlir_aie_release_lock()

int mlir_aie_release_lock	(	aie_libxaie_ctx_t *	ctx,
		int	col,
		int	row,
		int	lockid,
		int	lockval,
		int	timeout
	)

Release a physical lock.

Parameters

ctx	The context
col	The column of the lock
row	The row of the lock
lockid	The ID of the lock in the tile.
lockval	The value to acquire the lock with.
timeout	The number of microseconds to wait

Returns: Return non-zero on success, i.e. the operation did not timeout.

Definition at line 318 of file test_library.cpp.

References aie_libxaie_ctx_t::DevInst.

◆ mlir_aie_write32()

void mlir_aie_write32	(	aie_libxaie_ctx_t *	ctx,
		u64	addr,
		u32	val
	)

Write the AIE configuration memory at the given physical address.

It's almost always better to use some more indirect method of accessing configuration registers, but this is provided as a last resort.

Definition at line 334 of file test_library.cpp.

References aie_libxaie_ctx_t::DevInst.

◆ print_aie2_lock_status()

void print_aie2_lock_status	(	aie_libxaie_ctx_t *	ctx,
		int	col,
		int	row,
		const char *	type,
		int	lockOffset,
		int	locks
	)

Definition at line 698 of file test_library.cpp.

References aie_libxaie_ctx_t::DevInst, and mlir_aie_get_tile_addr().

Referenced by mlir_aie_print_memtiledma_status(), mlir_aie_print_shimdma_status(), and mlir_aie_print_tile_status().

Macros

Functions

Detailed Description

Macro Definition Documentation

◆ SYSFS_PATH_MAX

Function Documentation

◆ computeStats()

◆ mlir_aie_acquire_lock()

◆ mlir_aie_clear_config()

◆ mlir_aie_clear_shim_config()

◆ mlir_aie_clear_tile_memory()

◆ mlir_aie_data_mem_rd_word()

◆ mlir_aie_data_mem_wr_word()

◆ mlir_aie_deinit_libxaie()

◆ mlir_aie_dump_tile_memory()

◆ mlir_aie_get_tile_addr()

◆ mlir_aie_init_device()

◆ mlir_aie_print_dma_status()

◆ mlir_aie_print_memtiledma_status()

◆ mlir_aie_print_shimdma_status()

◆ mlir_aie_print_tile_status()

◆ mlir_aie_read32()

◆ mlir_aie_release_lock()

◆ mlir_aie_write32()

◆ print_aie2_lock_status()