Skip to content

Commit

Permalink
DSA: refine README
Browse files Browse the repository at this point in the history
Refine README and create tests-bat for sanity tests of IDXD.

Signed-off-by: Yi Sun <[email protected]>
  • Loading branch information
ysun committed May 31, 2024
1 parent c8f4f5c commit 58ab679
Show file tree
Hide file tree
Showing 2 changed files with 26 additions and 15 deletions.
38 changes: 23 additions & 15 deletions BM/dsa/README.md
Original file line number Diff line number Diff line change
@@ -1,37 +1,45 @@
# DSA(Data Streaming Accelerator) Test Cases

## Description
```
Intel DSA is a high-performance data copy and transformation accelerator that
will be integrated in SPR, targeted for optimizing streaming data movement and
transformation operations common with applications for high-performance storage,
networking, persistent memory, and various data processing applications. IAA is
a similar accelerator which is more focused on data encryption and decryption.
DSA and IAA share the same Linux Kernel driver “IDXD”
```

## Usage
```
IDXD is the DSA driver name and enabled after kernel 5.19, it is better to do tests
newer than that.

./dsa_user.sh -t check_dsa_driver
IDXD driver is for both dsa and iaa, check if the driver is loaded.
./dsa_user.sh -t check_dsa0_device
After the driver is loaded, devices are enabled under /sys/bus/dsa/devices.
./dsa_user.sh -t check_shared_mode
If SVM(Shared Virtual Memory) is supported, the pasid_enabled is 1. If it is 0,
the shared mode is not confgurable.
```
## Run
### Manually

Go through file tests-* , each line works as a single test.

### Automatically
Leverage `runtests` in the root folder:

## Expected result
```
All test results should show pass, no fail.
cd lkvs
./runtests BM/dsa/tests-dsa1
```
## Expected result
All test results should show pass, no fail.

## accel-config
```
accel-config - configure and control DSA(data streaminng accelerator) subsystem
devices. The git repo is https://github.com/intel/idxd-config.git.
accel-config -h and accel-config --list-cmds introduce how to use the tool.
`accel-config -h` and `accel-config --list-cmds` introduce how to use the tool.

#### compile
```
cd lkvs/tools/idxd-config
./autogen.sh
./configure CFLAGS='-g -O2' --prefix=/usr --sysconfdir=/etc --libdir=/usr/lib64 --enable-test=yes
make
make install
```

`--enable-test=yes` is required for all DSA and IAX related tests.
3 changes: 3 additions & 0 deletions BM/dsa/tests-bat
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
./dsa_user.sh -t check_dsa_driver
./dsa_user.sh -t check_dsa0_device
./dsa_user.sh -t check_shared_mode

0 comments on commit 58ab679

Please sign in to comment.