#include "target.h"
#include <stdio.h>
#include <stdlib.h>

Include dependency graph for test_library.h:

This graph shows which files directly or indirectly include this file:

Classes
class	EventMonitor

Macros
#define	mlir_aie_check(s, r, v, errors)

#define	mlir_aie_check_float(s, r, v, errors)

Functions
aie_libxaie_ctx_t *	mlir_aie_init_libxaie ()
	Initialize libXAIE and allocate a new context object.

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

int	mlir_aie_init_device (aie_libxaie_ctx_t *ctx, uint32_t device_id=0)
	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 contents of the memory associated with the given tile.

void	mlir_aie_clear_tile_memory (aie_libxaie_ctx_t *ctx, int col, int row)
	Clear the contents of the memory associated with the given tile.

void	mlir_aie_print_dma_status (aie_libxaie_ctx_t *ctx, int col, int row)
	Print the status of a dma represented by the given tile.

void	mlir_aie_print_memtiledma_status (aie_libxaie_ctx_t *ctx, int col, int row)
	Print the status of a memtiledma represented by the given location.

void	mlir_aie_print_shimdma_status (aie_libxaie_ctx_t *ctx, int col, int row)
	Print the status of a shimdma represented by the given location (row = 0).

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.

void	mlir_aie_clear_config (aie_libxaie_ctx_t *ctx, int col, int row)
	Zero out the program and configuration memory of the tile.

void	mlir_aie_clear_shim_config (aie_libxaie_ctx_t *ctx, int col, int row)
	Zero out the configuration memory of the shim tile.

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

Macro Definition Documentation

◆ mlir_aie_check

#define mlir_aie_check	(	s,
		r,
		v,
		errors
	)

Value:

  if (r != v) {                                                                \
    printf("ERROR %s: %s expected %d, but was %d!\n", s, #r, v, r);            \
    errors++;                                                                  \
  }

Definition at line 32 of file test_library.h.

◆ mlir_aie_check_float

#define mlir_aie_check_float	(	s,
		r,
		v,
		errors
	)

Value:

  if (r != v) {                                                                \
    printf("ERROR %s: %s expected %f, but was %f!\n", s, #r, v, r);            \
    errors++;                                                                  \
  }

Definition at line 37 of file test_library.h.

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 1113 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 307 of file test_library.cpp.

References aie_libxaie_ctx_t::XAieDevInst.

◆ mlir_aie_clear_config()

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

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 1055 of file test_library.cpp.

References mlir_aie_get_tile_addr(), and aie_libxaie_ctx_t::XAieDevInst.

◆ mlir_aie_clear_shim_config()

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

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 1085 of file test_library.cpp.

References mlir_aie_get_tile_addr(), and aie_libxaie_ctx_t::XAieDevInst.

◆ mlir_aie_clear_tile_memory()

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

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

Values that are zero are not shown

Definition at line 387 of file test_library.cpp.

References aie_libxaie_ctx_t::XAieDevInst.

◆ 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

ctx	The AIE context
col	The column coordinate of the tile
row	The row coordinate of the tile
addr	The address within the tile\'s data memory

Returns: The 32-bit data value read from the specified address

Definition at line 347 of file test_library.cpp.

References aie_libxaie_ctx_t::XAieDevInst.

◆ 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

ctx	The AIE context
col	The column coordinate of the tile
row	The row coordinate of the tile
addr	The address within the tile\'s data memory
data	The 32-bit data value to write

Definition at line 360 of file test_library.cpp.

References aie_libxaie_ctx_t::XAieDevInst.

◆ 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::XAieConfig, and aie_libxaie_ctx_t::XAieDevInst.

◆ mlir_aie_dump_tile_memory()

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

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

Definition at line 375 of file test_library.cpp.

References aie_libxaie_ctx_t::XAieDevInst.

◆ 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 368 of file test_library.cpp.

References aie_libxaie_ctx_t::XAieDevInst.

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 AIE context
device_id	The device ID to initialize

Returns: Zero on success, negative value on error

Definition at line 174 of file test_library.cpp.

References SYSFS_PATH_MAX, aie_libxaie_ctx_t::XAieConfig, and aie_libxaie_ctx_t::XAieDevInst.

◆ mlir_aie_init_libxaie()

aie_libxaie_ctx_t * mlir_aie_init_libxaie ( )

Initialize libXAIE and allocate a new context object.

Returns: A pointer to the context

◆ mlir_aie_print_dma_status()

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

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

Definition at line 517 of file test_library.cpp.

References mlir_aie_get_tile_addr(), aie_libxaie_ctx_t::XAieConfig, and aie_libxaie_ctx_t::XAieDevInst.

◆ mlir_aie_print_memtiledma_status()

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

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

Definition at line 722 of file test_library.cpp.

References mlir_aie_get_tile_addr(), print_aie2_lock_status(), aie_libxaie_ctx_t::XAieConfig, and aie_libxaie_ctx_t::XAieDevInst.

◆ mlir_aie_print_shimdma_status()

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

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

Definition at line 784 of file test_library.cpp.

References mlir_aie_get_tile_addr(), print_aie2_lock_status(), aie_libxaie_ctx_t::XAieConfig, and aie_libxaie_ctx_t::XAieDevInst.

◆ 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.

Definition at line 954 of file test_library.cpp.

References mlir_aie_get_tile_addr(), print_aie2_lock_status(), aie_libxaie_ctx_t::XAieConfig, and aie_libxaie_ctx_t::XAieDevInst.

◆ 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 328 of file test_library.cpp.

References aie_libxaie_ctx_t::XAieDevInst.

◆ 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 321 of file test_library.cpp.

References aie_libxaie_ctx_t::XAieDevInst.

◆ 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 337 of file test_library.cpp.

References aie_libxaie_ctx_t::XAieDevInst.

Classes

Macros

Functions

Macro Definition Documentation

◆ mlir_aie_check

◆ mlir_aie_check_float

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_init_libxaie()

◆ 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()