1 // SPDX-License-Identifier: GPL-2.0-only 2 /* 3 * DMA Engine test module 4 * 5 * Copyright (C) 2007 Atmel Corporation 6 * Copyright (C) 2013 Intel Corporation 7 */ 8 #define pr_fmt(fmt) KBUILD_MODNAME ": " fmt 9 10 #include <linux/err.h> 11 #include <linux/delay.h> 12 #include <linux/dma-mapping.h> 13 #include <linux/dmaengine.h> 14 #include <linux/freezer.h> 15 #include <linux/init.h> 16 #include <linux/kthread.h> 17 #include <linux/sched/task.h> 18 #include <linux/module.h> 19 #include <linux/moduleparam.h> 20 #include <linux/random.h> 21 #include <linux/slab.h> 22 #include <linux/wait.h> 23 24 static unsigned int test_buf_size = 16384; 25 module_param(test_buf_size, uint, 0644); 26 MODULE_PARM_DESC(test_buf_size, "Size of the memcpy test buffer"); 27 28 static char test_device[32]; 29 module_param_string(device, test_device, sizeof(test_device), 0644); 30 MODULE_PARM_DESC(device, "Bus ID of the DMA Engine to test (default: any)"); 31 32 static unsigned int threads_per_chan = 1; 33 module_param(threads_per_chan, uint, 0644); 34 MODULE_PARM_DESC(threads_per_chan, 35 "Number of threads to start per channel (default: 1)"); 36 37 static unsigned int max_channels; 38 module_param(max_channels, uint, 0644); 39 MODULE_PARM_DESC(max_channels, 40 "Maximum number of channels to use (default: all)"); 41 42 static unsigned int iterations; 43 module_param(iterations, uint, 0644); 44 MODULE_PARM_DESC(iterations, 45 "Iterations before stopping test (default: infinite)"); 46 47 static unsigned int dmatest; 48 module_param(dmatest, uint, 0644); 49 MODULE_PARM_DESC(dmatest, 50 "dmatest 0-memcpy 1-memset (default: 0)"); 51 52 static unsigned int xor_sources = 3; 53 module_param(xor_sources, uint, 0644); 54 MODULE_PARM_DESC(xor_sources, 55 "Number of xor source buffers (default: 3)"); 56 57 static unsigned int pq_sources = 3; 58 module_param(pq_sources, uint, 0644); 59 MODULE_PARM_DESC(pq_sources, 60 "Number of p+q source buffers (default: 3)"); 61 62 static int timeout = 3000; 63 module_param(timeout, int, 0644); 64 MODULE_PARM_DESC(timeout, "Transfer Timeout in msec (default: 3000), " 65 "Pass -1 for infinite timeout"); 66 67 static bool noverify; 68 module_param(noverify, bool, 0644); 69 MODULE_PARM_DESC(noverify, "Disable data verification (default: verify)"); 70 71 static bool norandom; 72 module_param(norandom, bool, 0644); 73 MODULE_PARM_DESC(norandom, "Disable random offset setup (default: random)"); 74 75 static bool verbose; 76 module_param(verbose, bool, 0644); 77 MODULE_PARM_DESC(verbose, "Enable \"success\" result messages (default: off)"); 78 79 static int alignment = -1; 80 module_param(alignment, int, 0644); 81 MODULE_PARM_DESC(alignment, "Custom data address alignment taken as 2^(alignment) (default: not used (-1))"); 82 83 static unsigned int transfer_size; 84 module_param(transfer_size, uint, 0644); 85 MODULE_PARM_DESC(transfer_size, "Optional custom transfer size in bytes (default: not used (0))"); 86 87 static bool polled; 88 module_param(polled, bool, 0644); 89 MODULE_PARM_DESC(polled, "Use polling for completion instead of interrupts"); 90 91 /** 92 * struct dmatest_params - test parameters. 93 * @buf_size: size of the memcpy test buffer 94 * @channel: bus ID of the channel to test 95 * @device: bus ID of the DMA Engine to test 96 * @threads_per_chan: number of threads to start per channel 97 * @max_channels: maximum number of channels to use 98 * @iterations: iterations before stopping test 99 * @xor_sources: number of xor source buffers 100 * @pq_sources: number of p+q source buffers 101 * @timeout: transfer timeout in msec, -1 for infinite timeout 102 * @noverify: disable data verification 103 * @norandom: disable random offset setup 104 * @alignment: custom data address alignment taken as 2^alignment 105 * @transfer_size: custom transfer size in bytes 106 * @polled: use polling for completion instead of interrupts 107 */ 108 struct dmatest_params { 109 unsigned int buf_size; 110 char channel[20]; 111 char device[32]; 112 unsigned int threads_per_chan; 113 unsigned int max_channels; 114 unsigned int iterations; 115 unsigned int xor_sources; 116 unsigned int pq_sources; 117 int timeout; 118 bool noverify; 119 bool norandom; 120 int alignment; 121 unsigned int transfer_size; 122 bool polled; 123 }; 124 125 /** 126 * struct dmatest_info - test information. 127 * @params: test parameters 128 * @channels: channels under test 129 * @nr_channels: number of channels under test 130 * @lock: access protection to the fields of this structure 131 * @did_init: module has been initialized completely 132 * @last_error: test has faced configuration issues 133 */ 134 static struct dmatest_info { 135 /* Test parameters */ 136 struct dmatest_params params; 137 138 /* Internal state */ 139 struct list_head channels; 140 unsigned int nr_channels; 141 int last_error; 142 struct mutex lock; 143 bool did_init; 144 } test_info = { 145 .channels = LIST_HEAD_INIT(test_info.channels), 146 .lock = __MUTEX_INITIALIZER(test_info.lock), 147 }; 148 149 static int dmatest_run_set(const char *val, const struct kernel_param *kp); 150 static int dmatest_run_get(char *val, const struct kernel_param *kp); 151 static const struct kernel_param_ops run_ops = { 152 .set = dmatest_run_set, 153 .get = dmatest_run_get, 154 }; 155 static bool dmatest_run; 156 module_param_cb(run, &run_ops, &dmatest_run, 0644); 157 MODULE_PARM_DESC(run, "Run the test (default: false)"); 158 159 static int dmatest_chan_set(const char *val, const struct kernel_param *kp); 160 static int dmatest_chan_get(char *val, const struct kernel_param *kp); 161 static const struct kernel_param_ops multi_chan_ops = { 162 .set = dmatest_chan_set, 163 .get = dmatest_chan_get, 164 }; 165 166 static char test_channel[20]; 167 static struct kparam_string newchan_kps = { 168 .string = test_channel, 169 .maxlen = 20, 170 }; 171 module_param_cb(channel, &multi_chan_ops, &newchan_kps, 0644); 172 MODULE_PARM_DESC(channel, "Bus ID of the channel to test (default: any)"); 173 174 static int dmatest_test_list_get(char *val, const struct kernel_param *kp); 175 static const struct kernel_param_ops test_list_ops = { 176 .get = dmatest_test_list_get, 177 }; 178 module_param_cb(test_list, &test_list_ops, NULL, 0444); 179 MODULE_PARM_DESC(test_list, "Print current test list"); 180 181 /* Maximum amount of mismatched bytes in buffer to print */ 182 #define MAX_ERROR_COUNT 32 183 184 /* 185 * Initialization patterns. All bytes in the source buffer has bit 7 186 * set, all bytes in the destination buffer has bit 7 cleared. 187 * 188 * Bit 6 is set for all bytes which are to be copied by the DMA 189 * engine. Bit 5 is set for all bytes which are to be overwritten by 190 * the DMA engine. 191 * 192 * The remaining bits are the inverse of a counter which increments by 193 * one for each byte address. 194 */ 195 #define PATTERN_SRC 0x80 196 #define PATTERN_DST 0x00 197 #define PATTERN_COPY 0x40 198 #define PATTERN_OVERWRITE 0x20 199 #define PATTERN_COUNT_MASK 0x1f 200 #define PATTERN_MEMSET_IDX 0x01 201 202 /* Fixed point arithmetic ops */ 203 #define FIXPT_SHIFT 8 204 #define FIXPNT_MASK 0xFF 205 #define FIXPT_TO_INT(a) ((a) >> FIXPT_SHIFT) 206 #define INT_TO_FIXPT(a) ((a) << FIXPT_SHIFT) 207 #define FIXPT_GET_FRAC(a) ((((a) & FIXPNT_MASK) * 100) >> FIXPT_SHIFT) 208 209 /* poor man's completion - we want to use wait_event_freezable() on it */ 210 struct dmatest_done { 211 bool done; 212 wait_queue_head_t *wait; 213 }; 214 215 struct dmatest_data { 216 u8 **raw; 217 u8 **aligned; 218 unsigned int cnt; 219 unsigned int off; 220 }; 221 222 struct dmatest_thread { 223 struct list_head node; 224 struct dmatest_info *info; 225 struct task_struct *task; 226 struct dma_chan *chan; 227 struct dmatest_data src; 228 struct dmatest_data dst; 229 enum dma_transaction_type type; 230 wait_queue_head_t done_wait; 231 struct dmatest_done test_done; 232 bool done; 233 bool pending; 234 }; 235 236 struct dmatest_chan { 237 struct list_head node; 238 struct dma_chan *chan; 239 struct list_head threads; 240 }; 241 242 static DECLARE_WAIT_QUEUE_HEAD(thread_wait); 243 static bool wait; 244 245 static bool is_threaded_test_run(struct dmatest_info *info) 246 { 247 struct dmatest_chan *dtc; 248 249 list_for_each_entry(dtc, &info->channels, node) { 250 struct dmatest_thread *thread; 251 252 list_for_each_entry(thread, &dtc->threads, node) { 253 if (!thread->done && !thread->pending) 254 return true; 255 } 256 } 257 258 return false; 259 } 260 261 static bool is_threaded_test_pending(struct dmatest_info *info) 262 { 263 struct dmatest_chan *dtc; 264 265 list_for_each_entry(dtc, &info->channels, node) { 266 struct dmatest_thread *thread; 267 268 list_for_each_entry(thread, &dtc->threads, node) { 269 if (thread->pending) 270 return true; 271 } 272 } 273 274 return false; 275 } 276 277 static int dmatest_wait_get(char *val, const struct kernel_param *kp) 278 { 279 struct dmatest_info *info = &test_info; 280 struct dmatest_params *params = &info->params; 281 282 if (params->iterations) 283 wait_event(thread_wait, !is_threaded_test_run(info)); 284 wait = true; 285 return param_get_bool(val, kp); 286 } 287 288 static const struct kernel_param_ops wait_ops = { 289 .get = dmatest_wait_get, 290 .set = param_set_bool, 291 }; 292 module_param_cb(wait, &wait_ops, &wait, 0444); 293 MODULE_PARM_DESC(wait, "Wait for tests to complete (default: false)"); 294 295 static bool dmatest_match_channel(struct dmatest_params *params, 296 struct dma_chan *chan) 297 { 298 if (params->channel[0] == '\0') 299 return true; 300 return strcmp(dma_chan_name(chan), params->channel) == 0; 301 } 302 303 static bool dmatest_match_device(struct dmatest_params *params, 304 struct dma_device *device) 305 { 306 if (params->device[0] == '\0') 307 return true; 308 return strcmp(dev_name(device->dev), params->device) == 0; 309 } 310 311 static unsigned long dmatest_random(void) 312 { 313 unsigned long buf; 314 315 prandom_bytes(&buf, sizeof(buf)); 316 return buf; 317 } 318 319 static inline u8 gen_inv_idx(u8 index, bool is_memset) 320 { 321 u8 val = is_memset ? PATTERN_MEMSET_IDX : index; 322 323 return ~val & PATTERN_COUNT_MASK; 324 } 325 326 static inline u8 gen_src_value(u8 index, bool is_memset) 327 { 328 return PATTERN_SRC | gen_inv_idx(index, is_memset); 329 } 330 331 static inline u8 gen_dst_value(u8 index, bool is_memset) 332 { 333 return PATTERN_DST | gen_inv_idx(index, is_memset); 334 } 335 336 static void dmatest_init_srcs(u8 **bufs, unsigned int start, unsigned int len, 337 unsigned int buf_size, bool is_memset) 338 { 339 unsigned int i; 340 u8 *buf; 341 342 for (; (buf = *bufs); bufs++) { 343 for (i = 0; i < start; i++) 344 buf[i] = gen_src_value(i, is_memset); 345 for ( ; i < start + len; i++) 346 buf[i] = gen_src_value(i, is_memset) | PATTERN_COPY; 347 for ( ; i < buf_size; i++) 348 buf[i] = gen_src_value(i, is_memset); 349 buf++; 350 } 351 } 352 353 static void dmatest_init_dsts(u8 **bufs, unsigned int start, unsigned int len, 354 unsigned int buf_size, bool is_memset) 355 { 356 unsigned int i; 357 u8 *buf; 358 359 for (; (buf = *bufs); bufs++) { 360 for (i = 0; i < start; i++) 361 buf[i] = gen_dst_value(i, is_memset); 362 for ( ; i < start + len; i++) 363 buf[i] = gen_dst_value(i, is_memset) | 364 PATTERN_OVERWRITE; 365 for ( ; i < buf_size; i++) 366 buf[i] = gen_dst_value(i, is_memset); 367 } 368 } 369 370 static void dmatest_mismatch(u8 actual, u8 pattern, unsigned int index, 371 unsigned int counter, bool is_srcbuf, bool is_memset) 372 { 373 u8 diff = actual ^ pattern; 374 u8 expected = pattern | gen_inv_idx(counter, is_memset); 375 const char *thread_name = current->comm; 376 377 if (is_srcbuf) 378 pr_warn("%s: srcbuf[0x%x] overwritten! Expected %02x, got %02x\n", 379 thread_name, index, expected, actual); 380 else if ((pattern & PATTERN_COPY) 381 && (diff & (PATTERN_COPY | PATTERN_OVERWRITE))) 382 pr_warn("%s: dstbuf[0x%x] not copied! Expected %02x, got %02x\n", 383 thread_name, index, expected, actual); 384 else if (diff & PATTERN_SRC) 385 pr_warn("%s: dstbuf[0x%x] was copied! Expected %02x, got %02x\n", 386 thread_name, index, expected, actual); 387 else 388 pr_warn("%s: dstbuf[0x%x] mismatch! Expected %02x, got %02x\n", 389 thread_name, index, expected, actual); 390 } 391 392 static unsigned int dmatest_verify(u8 **bufs, unsigned int start, 393 unsigned int end, unsigned int counter, u8 pattern, 394 bool is_srcbuf, bool is_memset) 395 { 396 unsigned int i; 397 unsigned int error_count = 0; 398 u8 actual; 399 u8 expected; 400 u8 *buf; 401 unsigned int counter_orig = counter; 402 403 for (; (buf = *bufs); bufs++) { 404 counter = counter_orig; 405 for (i = start; i < end; i++) { 406 actual = buf[i]; 407 expected = pattern | gen_inv_idx(counter, is_memset); 408 if (actual != expected) { 409 if (error_count < MAX_ERROR_COUNT) 410 dmatest_mismatch(actual, pattern, i, 411 counter, is_srcbuf, 412 is_memset); 413 error_count++; 414 } 415 counter++; 416 } 417 } 418 419 if (error_count > MAX_ERROR_COUNT) 420 pr_warn("%s: %u errors suppressed\n", 421 current->comm, error_count - MAX_ERROR_COUNT); 422 423 return error_count; 424 } 425 426 427 static void dmatest_callback(void *arg) 428 { 429 struct dmatest_done *done = arg; 430 struct dmatest_thread *thread = 431 container_of(done, struct dmatest_thread, test_done); 432 if (!thread->done) { 433 done->done = true; 434 wake_up_all(done->wait); 435 } else { 436 /* 437 * If thread->done, it means that this callback occurred 438 * after the parent thread has cleaned up. This can 439 * happen in the case that driver doesn't implement 440 * the terminate_all() functionality and a dma operation 441 * did not occur within the timeout period 442 */ 443 WARN(1, "dmatest: Kernel memory may be corrupted!!\n"); 444 } 445 } 446 447 static unsigned int min_odd(unsigned int x, unsigned int y) 448 { 449 unsigned int val = min(x, y); 450 451 return val % 2 ? val : val - 1; 452 } 453 454 static void result(const char *err, unsigned int n, unsigned int src_off, 455 unsigned int dst_off, unsigned int len, unsigned long data) 456 { 457 if (IS_ERR_VALUE(data)) { 458 pr_info("%s: result #%u: '%s' with src_off=0x%x dst_off=0x%x len=0x%x (%ld)\n", 459 current->comm, n, err, src_off, dst_off, len, data); 460 } else { 461 pr_info("%s: result #%u: '%s' with src_off=0x%x dst_off=0x%x len=0x%x (%lu)\n", 462 current->comm, n, err, src_off, dst_off, len, data); 463 } 464 } 465 466 static void dbg_result(const char *err, unsigned int n, unsigned int src_off, 467 unsigned int dst_off, unsigned int len, 468 unsigned long data) 469 { 470 pr_debug("%s: result #%u: '%s' with src_off=0x%x dst_off=0x%x len=0x%x (%lu)\n", 471 current->comm, n, err, src_off, dst_off, len, data); 472 } 473 474 #define verbose_result(err, n, src_off, dst_off, len, data) ({ \ 475 if (verbose) \ 476 result(err, n, src_off, dst_off, len, data); \ 477 else \ 478 dbg_result(err, n, src_off, dst_off, len, data);\ 479 }) 480 481 static unsigned long long dmatest_persec(s64 runtime, unsigned int val) 482 { 483 unsigned long long per_sec = 1000000; 484 485 if (runtime <= 0) 486 return 0; 487 488 /* drop precision until runtime is 32-bits */ 489 while (runtime > UINT_MAX) { 490 runtime >>= 1; 491 per_sec <<= 1; 492 } 493 494 per_sec *= val; 495 per_sec = INT_TO_FIXPT(per_sec); 496 do_div(per_sec, runtime); 497 498 return per_sec; 499 } 500 501 static unsigned long long dmatest_KBs(s64 runtime, unsigned long long len) 502 { 503 return FIXPT_TO_INT(dmatest_persec(runtime, len >> 10)); 504 } 505 506 static void __dmatest_free_test_data(struct dmatest_data *d, unsigned int cnt) 507 { 508 unsigned int i; 509 510 for (i = 0; i < cnt; i++) 511 kfree(d->raw[i]); 512 513 kfree(d->aligned); 514 kfree(d->raw); 515 } 516 517 static void dmatest_free_test_data(struct dmatest_data *d) 518 { 519 __dmatest_free_test_data(d, d->cnt); 520 } 521 522 static int dmatest_alloc_test_data(struct dmatest_data *d, 523 unsigned int buf_size, u8 align) 524 { 525 unsigned int i = 0; 526 527 d->raw = kcalloc(d->cnt + 1, sizeof(u8 *), GFP_KERNEL); 528 if (!d->raw) 529 return -ENOMEM; 530 531 d->aligned = kcalloc(d->cnt + 1, sizeof(u8 *), GFP_KERNEL); 532 if (!d->aligned) 533 goto err; 534 535 for (i = 0; i < d->cnt; i++) { 536 d->raw[i] = kmalloc(buf_size + align, GFP_KERNEL); 537 if (!d->raw[i]) 538 goto err; 539 540 /* align to alignment restriction */ 541 if (align) 542 d->aligned[i] = PTR_ALIGN(d->raw[i], align); 543 else 544 d->aligned[i] = d->raw[i]; 545 } 546 547 return 0; 548 err: 549 __dmatest_free_test_data(d, i); 550 return -ENOMEM; 551 } 552 553 /* 554 * This function repeatedly tests DMA transfers of various lengths and 555 * offsets for a given operation type until it is told to exit by 556 * kthread_stop(). There may be multiple threads running this function 557 * in parallel for a single channel, and there may be multiple channels 558 * being tested in parallel. 559 * 560 * Before each test, the source and destination buffer is initialized 561 * with a known pattern. This pattern is different depending on 562 * whether it's in an area which is supposed to be copied or 563 * overwritten, and different in the source and destination buffers. 564 * So if the DMA engine doesn't copy exactly what we tell it to copy, 565 * we'll notice. 566 */ 567 static int dmatest_func(void *data) 568 { 569 struct dmatest_thread *thread = data; 570 struct dmatest_done *done = &thread->test_done; 571 struct dmatest_info *info; 572 struct dmatest_params *params; 573 struct dma_chan *chan; 574 struct dma_device *dev; 575 struct device *dma_dev; 576 unsigned int error_count; 577 unsigned int failed_tests = 0; 578 unsigned int total_tests = 0; 579 dma_cookie_t cookie; 580 enum dma_status status; 581 enum dma_ctrl_flags flags; 582 u8 *pq_coefs = NULL; 583 int ret; 584 unsigned int buf_size; 585 struct dmatest_data *src; 586 struct dmatest_data *dst; 587 int i; 588 ktime_t ktime, start, diff; 589 ktime_t filltime = 0; 590 ktime_t comparetime = 0; 591 s64 runtime = 0; 592 unsigned long long total_len = 0; 593 unsigned long long iops = 0; 594 u8 align = 0; 595 bool is_memset = false; 596 dma_addr_t *srcs; 597 dma_addr_t *dma_pq; 598 599 set_freezable(); 600 601 ret = -ENOMEM; 602 603 smp_rmb(); 604 thread->pending = false; 605 info = thread->info; 606 params = &info->params; 607 chan = thread->chan; 608 dev = chan->device; 609 dma_dev = dmaengine_get_dma_device(chan); 610 611 src = &thread->src; 612 dst = &thread->dst; 613 if (thread->type == DMA_MEMCPY) { 614 align = params->alignment < 0 ? dev->copy_align : 615 params->alignment; 616 src->cnt = dst->cnt = 1; 617 } else if (thread->type == DMA_MEMSET) { 618 align = params->alignment < 0 ? dev->fill_align : 619 params->alignment; 620 src->cnt = dst->cnt = 1; 621 is_memset = true; 622 } else if (thread->type == DMA_XOR) { 623 /* force odd to ensure dst = src */ 624 src->cnt = min_odd(params->xor_sources | 1, dev->max_xor); 625 dst->cnt = 1; 626 align = params->alignment < 0 ? dev->xor_align : 627 params->alignment; 628 } else if (thread->type == DMA_PQ) { 629 /* force odd to ensure dst = src */ 630 src->cnt = min_odd(params->pq_sources | 1, dma_maxpq(dev, 0)); 631 dst->cnt = 2; 632 align = params->alignment < 0 ? dev->pq_align : 633 params->alignment; 634 635 pq_coefs = kmalloc(params->pq_sources + 1, GFP_KERNEL); 636 if (!pq_coefs) 637 goto err_thread_type; 638 639 for (i = 0; i < src->cnt; i++) 640 pq_coefs[i] = 1; 641 } else 642 goto err_thread_type; 643 644 /* Check if buffer count fits into map count variable (u8) */ 645 if ((src->cnt + dst->cnt) >= 255) { 646 pr_err("too many buffers (%d of 255 supported)\n", 647 src->cnt + dst->cnt); 648 goto err_free_coefs; 649 } 650 651 buf_size = params->buf_size; 652 if (1 << align > buf_size) { 653 pr_err("%u-byte buffer too small for %d-byte alignment\n", 654 buf_size, 1 << align); 655 goto err_free_coefs; 656 } 657 658 if (dmatest_alloc_test_data(src, buf_size, align) < 0) 659 goto err_free_coefs; 660 661 if (dmatest_alloc_test_data(dst, buf_size, align) < 0) 662 goto err_src; 663 664 set_user_nice(current, 10); 665 666 srcs = kcalloc(src->cnt, sizeof(dma_addr_t), GFP_KERNEL); 667 if (!srcs) 668 goto err_dst; 669 670 dma_pq = kcalloc(dst->cnt, sizeof(dma_addr_t), GFP_KERNEL); 671 if (!dma_pq) 672 goto err_srcs_array; 673 674 /* 675 * src and dst buffers are freed by ourselves below 676 */ 677 if (params->polled) { 678 flags = DMA_CTRL_ACK; 679 } else { 680 if (dma_has_cap(DMA_INTERRUPT, dev->cap_mask)) { 681 flags = DMA_CTRL_ACK | DMA_PREP_INTERRUPT; 682 } else { 683 pr_err("Channel does not support interrupt!\n"); 684 goto err_pq_array; 685 } 686 } 687 688 ktime = ktime_get(); 689 while (!(kthread_should_stop() || 690 (params->iterations && total_tests >= params->iterations))) { 691 struct dma_async_tx_descriptor *tx = NULL; 692 struct dmaengine_unmap_data *um; 693 dma_addr_t *dsts; 694 unsigned int len; 695 696 total_tests++; 697 698 if (params->transfer_size) { 699 if (params->transfer_size >= buf_size) { 700 pr_err("%u-byte transfer size must be lower than %u-buffer size\n", 701 params->transfer_size, buf_size); 702 break; 703 } 704 len = params->transfer_size; 705 } else if (params->norandom) { 706 len = buf_size; 707 } else { 708 len = dmatest_random() % buf_size + 1; 709 } 710 711 /* Do not alter transfer size explicitly defined by user */ 712 if (!params->transfer_size) { 713 len = (len >> align) << align; 714 if (!len) 715 len = 1 << align; 716 } 717 total_len += len; 718 719 if (params->norandom) { 720 src->off = 0; 721 dst->off = 0; 722 } else { 723 src->off = dmatest_random() % (buf_size - len + 1); 724 dst->off = dmatest_random() % (buf_size - len + 1); 725 726 src->off = (src->off >> align) << align; 727 dst->off = (dst->off >> align) << align; 728 } 729 730 if (!params->noverify) { 731 start = ktime_get(); 732 dmatest_init_srcs(src->aligned, src->off, len, 733 buf_size, is_memset); 734 dmatest_init_dsts(dst->aligned, dst->off, len, 735 buf_size, is_memset); 736 737 diff = ktime_sub(ktime_get(), start); 738 filltime = ktime_add(filltime, diff); 739 } 740 741 um = dmaengine_get_unmap_data(dma_dev, src->cnt + dst->cnt, 742 GFP_KERNEL); 743 if (!um) { 744 failed_tests++; 745 result("unmap data NULL", total_tests, 746 src->off, dst->off, len, ret); 747 continue; 748 } 749 750 um->len = buf_size; 751 for (i = 0; i < src->cnt; i++) { 752 void *buf = src->aligned[i]; 753 struct page *pg = virt_to_page(buf); 754 unsigned long pg_off = offset_in_page(buf); 755 756 um->addr[i] = dma_map_page(dma_dev, pg, pg_off, 757 um->len, DMA_TO_DEVICE); 758 srcs[i] = um->addr[i] + src->off; 759 ret = dma_mapping_error(dma_dev, um->addr[i]); 760 if (ret) { 761 result("src mapping error", total_tests, 762 src->off, dst->off, len, ret); 763 goto error_unmap_continue; 764 } 765 um->to_cnt++; 766 } 767 /* map with DMA_BIDIRECTIONAL to force writeback/invalidate */ 768 dsts = &um->addr[src->cnt]; 769 for (i = 0; i < dst->cnt; i++) { 770 void *buf = dst->aligned[i]; 771 struct page *pg = virt_to_page(buf); 772 unsigned long pg_off = offset_in_page(buf); 773 774 dsts[i] = dma_map_page(dma_dev, pg, pg_off, um->len, 775 DMA_BIDIRECTIONAL); 776 ret = dma_mapping_error(dma_dev, dsts[i]); 777 if (ret) { 778 result("dst mapping error", total_tests, 779 src->off, dst->off, len, ret); 780 goto error_unmap_continue; 781 } 782 um->bidi_cnt++; 783 } 784 785 if (thread->type == DMA_MEMCPY) 786 tx = dev->device_prep_dma_memcpy(chan, 787 dsts[0] + dst->off, 788 srcs[0], len, flags); 789 else if (thread->type == DMA_MEMSET) 790 tx = dev->device_prep_dma_memset(chan, 791 dsts[0] + dst->off, 792 *(src->aligned[0] + src->off), 793 len, flags); 794 else if (thread->type == DMA_XOR) 795 tx = dev->device_prep_dma_xor(chan, 796 dsts[0] + dst->off, 797 srcs, src->cnt, 798 len, flags); 799 else if (thread->type == DMA_PQ) { 800 for (i = 0; i < dst->cnt; i++) 801 dma_pq[i] = dsts[i] + dst->off; 802 tx = dev->device_prep_dma_pq(chan, dma_pq, srcs, 803 src->cnt, pq_coefs, 804 len, flags); 805 } 806 807 if (!tx) { 808 result("prep error", total_tests, src->off, 809 dst->off, len, ret); 810 msleep(100); 811 goto error_unmap_continue; 812 } 813 814 done->done = false; 815 if (!params->polled) { 816 tx->callback = dmatest_callback; 817 tx->callback_param = done; 818 } 819 cookie = tx->tx_submit(tx); 820 821 if (dma_submit_error(cookie)) { 822 result("submit error", total_tests, src->off, 823 dst->off, len, ret); 824 msleep(100); 825 goto error_unmap_continue; 826 } 827 828 if (params->polled) { 829 status = dma_sync_wait(chan, cookie); 830 dmaengine_terminate_sync(chan); 831 if (status == DMA_COMPLETE) 832 done->done = true; 833 } else { 834 dma_async_issue_pending(chan); 835 836 wait_event_freezable_timeout(thread->done_wait, 837 done->done, 838 msecs_to_jiffies(params->timeout)); 839 840 status = dma_async_is_tx_complete(chan, cookie, NULL, 841 NULL); 842 } 843 844 if (!done->done) { 845 result("test timed out", total_tests, src->off, dst->off, 846 len, 0); 847 goto error_unmap_continue; 848 } else if (status != DMA_COMPLETE && 849 !(dma_has_cap(DMA_COMPLETION_NO_ORDER, 850 dev->cap_mask) && 851 status == DMA_OUT_OF_ORDER)) { 852 result(status == DMA_ERROR ? 853 "completion error status" : 854 "completion busy status", total_tests, src->off, 855 dst->off, len, ret); 856 goto error_unmap_continue; 857 } 858 859 dmaengine_unmap_put(um); 860 861 if (params->noverify) { 862 verbose_result("test passed", total_tests, src->off, 863 dst->off, len, 0); 864 continue; 865 } 866 867 start = ktime_get(); 868 pr_debug("%s: verifying source buffer...\n", current->comm); 869 error_count = dmatest_verify(src->aligned, 0, src->off, 870 0, PATTERN_SRC, true, is_memset); 871 error_count += dmatest_verify(src->aligned, src->off, 872 src->off + len, src->off, 873 PATTERN_SRC | PATTERN_COPY, true, is_memset); 874 error_count += dmatest_verify(src->aligned, src->off + len, 875 buf_size, src->off + len, 876 PATTERN_SRC, true, is_memset); 877 878 pr_debug("%s: verifying dest buffer...\n", current->comm); 879 error_count += dmatest_verify(dst->aligned, 0, dst->off, 880 0, PATTERN_DST, false, is_memset); 881 882 error_count += dmatest_verify(dst->aligned, dst->off, 883 dst->off + len, src->off, 884 PATTERN_SRC | PATTERN_COPY, false, is_memset); 885 886 error_count += dmatest_verify(dst->aligned, dst->off + len, 887 buf_size, dst->off + len, 888 PATTERN_DST, false, is_memset); 889 890 diff = ktime_sub(ktime_get(), start); 891 comparetime = ktime_add(comparetime, diff); 892 893 if (error_count) { 894 result("data error", total_tests, src->off, dst->off, 895 len, error_count); 896 failed_tests++; 897 } else { 898 verbose_result("test passed", total_tests, src->off, 899 dst->off, len, 0); 900 } 901 902 continue; 903 904 error_unmap_continue: 905 dmaengine_unmap_put(um); 906 failed_tests++; 907 } 908 ktime = ktime_sub(ktime_get(), ktime); 909 ktime = ktime_sub(ktime, comparetime); 910 ktime = ktime_sub(ktime, filltime); 911 runtime = ktime_to_us(ktime); 912 913 ret = 0; 914 err_pq_array: 915 kfree(dma_pq); 916 err_srcs_array: 917 kfree(srcs); 918 err_dst: 919 dmatest_free_test_data(dst); 920 err_src: 921 dmatest_free_test_data(src); 922 err_free_coefs: 923 kfree(pq_coefs); 924 err_thread_type: 925 iops = dmatest_persec(runtime, total_tests); 926 pr_info("%s: summary %u tests, %u failures %llu.%02llu iops %llu KB/s (%d)\n", 927 current->comm, total_tests, failed_tests, 928 FIXPT_TO_INT(iops), FIXPT_GET_FRAC(iops), 929 dmatest_KBs(runtime, total_len), ret); 930 931 /* terminate all transfers on specified channels */ 932 if (ret || failed_tests) 933 dmaengine_terminate_sync(chan); 934 935 thread->done = true; 936 wake_up(&thread_wait); 937 938 return ret; 939 } 940 941 static void dmatest_cleanup_channel(struct dmatest_chan *dtc) 942 { 943 struct dmatest_thread *thread; 944 struct dmatest_thread *_thread; 945 int ret; 946 947 list_for_each_entry_safe(thread, _thread, &dtc->threads, node) { 948 ret = kthread_stop(thread->task); 949 pr_debug("thread %s exited with status %d\n", 950 thread->task->comm, ret); 951 list_del(&thread->node); 952 put_task_struct(thread->task); 953 kfree(thread); 954 } 955 956 /* terminate all transfers on specified channels */ 957 dmaengine_terminate_sync(dtc->chan); 958 959 kfree(dtc); 960 } 961 962 static int dmatest_add_threads(struct dmatest_info *info, 963 struct dmatest_chan *dtc, enum dma_transaction_type type) 964 { 965 struct dmatest_params *params = &info->params; 966 struct dmatest_thread *thread; 967 struct dma_chan *chan = dtc->chan; 968 char *op; 969 unsigned int i; 970 971 if (type == DMA_MEMCPY) 972 op = "copy"; 973 else if (type == DMA_MEMSET) 974 op = "set"; 975 else if (type == DMA_XOR) 976 op = "xor"; 977 else if (type == DMA_PQ) 978 op = "pq"; 979 else 980 return -EINVAL; 981 982 for (i = 0; i < params->threads_per_chan; i++) { 983 thread = kzalloc(sizeof(struct dmatest_thread), GFP_KERNEL); 984 if (!thread) { 985 pr_warn("No memory for %s-%s%u\n", 986 dma_chan_name(chan), op, i); 987 break; 988 } 989 thread->info = info; 990 thread->chan = dtc->chan; 991 thread->type = type; 992 thread->test_done.wait = &thread->done_wait; 993 init_waitqueue_head(&thread->done_wait); 994 smp_wmb(); 995 thread->task = kthread_create(dmatest_func, thread, "%s-%s%u", 996 dma_chan_name(chan), op, i); 997 if (IS_ERR(thread->task)) { 998 pr_warn("Failed to create thread %s-%s%u\n", 999 dma_chan_name(chan), op, i); 1000 kfree(thread); 1001 break; 1002 } 1003 1004 /* srcbuf and dstbuf are allocated by the thread itself */ 1005 get_task_struct(thread->task); 1006 list_add_tail(&thread->node, &dtc->threads); 1007 thread->pending = true; 1008 } 1009 1010 return i; 1011 } 1012 1013 static int dmatest_add_channel(struct dmatest_info *info, 1014 struct dma_chan *chan) 1015 { 1016 struct dmatest_chan *dtc; 1017 struct dma_device *dma_dev = chan->device; 1018 unsigned int thread_count = 0; 1019 int cnt; 1020 1021 dtc = kmalloc(sizeof(struct dmatest_chan), GFP_KERNEL); 1022 if (!dtc) { 1023 pr_warn("No memory for %s\n", dma_chan_name(chan)); 1024 return -ENOMEM; 1025 } 1026 1027 dtc->chan = chan; 1028 INIT_LIST_HEAD(&dtc->threads); 1029 1030 if (dma_has_cap(DMA_COMPLETION_NO_ORDER, dma_dev->cap_mask) && 1031 info->params.polled) { 1032 info->params.polled = false; 1033 pr_warn("DMA_COMPLETION_NO_ORDER, polled disabled\n"); 1034 } 1035 1036 if (dma_has_cap(DMA_MEMCPY, dma_dev->cap_mask)) { 1037 if (dmatest == 0) { 1038 cnt = dmatest_add_threads(info, dtc, DMA_MEMCPY); 1039 thread_count += cnt > 0 ? cnt : 0; 1040 } 1041 } 1042 1043 if (dma_has_cap(DMA_MEMSET, dma_dev->cap_mask)) { 1044 if (dmatest == 1) { 1045 cnt = dmatest_add_threads(info, dtc, DMA_MEMSET); 1046 thread_count += cnt > 0 ? cnt : 0; 1047 } 1048 } 1049 1050 if (dma_has_cap(DMA_XOR, dma_dev->cap_mask)) { 1051 cnt = dmatest_add_threads(info, dtc, DMA_XOR); 1052 thread_count += cnt > 0 ? cnt : 0; 1053 } 1054 if (dma_has_cap(DMA_PQ, dma_dev->cap_mask)) { 1055 cnt = dmatest_add_threads(info, dtc, DMA_PQ); 1056 thread_count += cnt > 0 ? cnt : 0; 1057 } 1058 1059 pr_info("Added %u threads using %s\n", 1060 thread_count, dma_chan_name(chan)); 1061 1062 list_add_tail(&dtc->node, &info->channels); 1063 info->nr_channels++; 1064 1065 return 0; 1066 } 1067 1068 static bool filter(struct dma_chan *chan, void *param) 1069 { 1070 return dmatest_match_channel(param, chan) && dmatest_match_device(param, chan->device); 1071 } 1072 1073 static void request_channels(struct dmatest_info *info, 1074 enum dma_transaction_type type) 1075 { 1076 dma_cap_mask_t mask; 1077 1078 dma_cap_zero(mask); 1079 dma_cap_set(type, mask); 1080 for (;;) { 1081 struct dmatest_params *params = &info->params; 1082 struct dma_chan *chan; 1083 1084 chan = dma_request_channel(mask, filter, params); 1085 if (chan) { 1086 if (dmatest_add_channel(info, chan)) { 1087 dma_release_channel(chan); 1088 break; /* add_channel failed, punt */ 1089 } 1090 } else 1091 break; /* no more channels available */ 1092 if (params->max_channels && 1093 info->nr_channels >= params->max_channels) 1094 break; /* we have all we need */ 1095 } 1096 } 1097 1098 static void add_threaded_test(struct dmatest_info *info) 1099 { 1100 struct dmatest_params *params = &info->params; 1101 1102 /* Copy test parameters */ 1103 params->buf_size = test_buf_size; 1104 strlcpy(params->channel, strim(test_channel), sizeof(params->channel)); 1105 strlcpy(params->device, strim(test_device), sizeof(params->device)); 1106 params->threads_per_chan = threads_per_chan; 1107 params->max_channels = max_channels; 1108 params->iterations = iterations; 1109 params->xor_sources = xor_sources; 1110 params->pq_sources = pq_sources; 1111 params->timeout = timeout; 1112 params->noverify = noverify; 1113 params->norandom = norandom; 1114 params->alignment = alignment; 1115 params->transfer_size = transfer_size; 1116 params->polled = polled; 1117 1118 request_channels(info, DMA_MEMCPY); 1119 request_channels(info, DMA_MEMSET); 1120 request_channels(info, DMA_XOR); 1121 request_channels(info, DMA_PQ); 1122 } 1123 1124 static void run_pending_tests(struct dmatest_info *info) 1125 { 1126 struct dmatest_chan *dtc; 1127 unsigned int thread_count = 0; 1128 1129 list_for_each_entry(dtc, &info->channels, node) { 1130 struct dmatest_thread *thread; 1131 1132 thread_count = 0; 1133 list_for_each_entry(thread, &dtc->threads, node) { 1134 wake_up_process(thread->task); 1135 thread_count++; 1136 } 1137 pr_info("Started %u threads using %s\n", 1138 thread_count, dma_chan_name(dtc->chan)); 1139 } 1140 } 1141 1142 static void stop_threaded_test(struct dmatest_info *info) 1143 { 1144 struct dmatest_chan *dtc, *_dtc; 1145 struct dma_chan *chan; 1146 1147 list_for_each_entry_safe(dtc, _dtc, &info->channels, node) { 1148 list_del(&dtc->node); 1149 chan = dtc->chan; 1150 dmatest_cleanup_channel(dtc); 1151 pr_debug("dropped channel %s\n", dma_chan_name(chan)); 1152 dma_release_channel(chan); 1153 } 1154 1155 info->nr_channels = 0; 1156 } 1157 1158 static void start_threaded_tests(struct dmatest_info *info) 1159 { 1160 /* we might be called early to set run=, defer running until all 1161 * parameters have been evaluated 1162 */ 1163 if (!info->did_init) 1164 return; 1165 1166 run_pending_tests(info); 1167 } 1168 1169 static int dmatest_run_get(char *val, const struct kernel_param *kp) 1170 { 1171 struct dmatest_info *info = &test_info; 1172 1173 mutex_lock(&info->lock); 1174 if (is_threaded_test_run(info)) { 1175 dmatest_run = true; 1176 } else { 1177 if (!is_threaded_test_pending(info)) 1178 stop_threaded_test(info); 1179 dmatest_run = false; 1180 } 1181 mutex_unlock(&info->lock); 1182 1183 return param_get_bool(val, kp); 1184 } 1185 1186 static int dmatest_run_set(const char *val, const struct kernel_param *kp) 1187 { 1188 struct dmatest_info *info = &test_info; 1189 int ret; 1190 1191 mutex_lock(&info->lock); 1192 ret = param_set_bool(val, kp); 1193 if (ret) { 1194 mutex_unlock(&info->lock); 1195 return ret; 1196 } else if (dmatest_run) { 1197 if (!is_threaded_test_pending(info)) { 1198 /* 1199 * We have nothing to run. This can be due to: 1200 */ 1201 ret = info->last_error; 1202 if (ret) { 1203 /* 1) Misconfiguration */ 1204 pr_err("Channel misconfigured, can't continue\n"); 1205 mutex_unlock(&info->lock); 1206 return ret; 1207 } else { 1208 /* 2) We rely on defaults */ 1209 pr_info("No channels configured, continue with any\n"); 1210 if (!is_threaded_test_run(info)) 1211 stop_threaded_test(info); 1212 add_threaded_test(info); 1213 } 1214 } 1215 start_threaded_tests(info); 1216 } else { 1217 stop_threaded_test(info); 1218 } 1219 1220 mutex_unlock(&info->lock); 1221 1222 return ret; 1223 } 1224 1225 static int dmatest_chan_set(const char *val, const struct kernel_param *kp) 1226 { 1227 struct dmatest_info *info = &test_info; 1228 struct dmatest_chan *dtc; 1229 char chan_reset_val[20]; 1230 int ret; 1231 1232 mutex_lock(&info->lock); 1233 ret = param_set_copystring(val, kp); 1234 if (ret) { 1235 mutex_unlock(&info->lock); 1236 return ret; 1237 } 1238 /*Clear any previously run threads */ 1239 if (!is_threaded_test_run(info) && !is_threaded_test_pending(info)) 1240 stop_threaded_test(info); 1241 /* Reject channels that are already registered */ 1242 if (is_threaded_test_pending(info)) { 1243 list_for_each_entry(dtc, &info->channels, node) { 1244 if (strcmp(dma_chan_name(dtc->chan), 1245 strim(test_channel)) == 0) { 1246 dtc = list_last_entry(&info->channels, 1247 struct dmatest_chan, 1248 node); 1249 strlcpy(chan_reset_val, 1250 dma_chan_name(dtc->chan), 1251 sizeof(chan_reset_val)); 1252 ret = -EBUSY; 1253 goto add_chan_err; 1254 } 1255 } 1256 } 1257 1258 add_threaded_test(info); 1259 1260 /* Check if channel was added successfully */ 1261 if (!list_empty(&info->channels)) { 1262 /* 1263 * if new channel was not successfully added, revert the 1264 * "test_channel" string to the name of the last successfully 1265 * added channel. exception for when users issues empty string 1266 * to channel parameter. 1267 */ 1268 dtc = list_last_entry(&info->channels, struct dmatest_chan, node); 1269 if ((strcmp(dma_chan_name(dtc->chan), strim(test_channel)) != 0) 1270 && (strcmp("", strim(test_channel)) != 0)) { 1271 ret = -EINVAL; 1272 strlcpy(chan_reset_val, dma_chan_name(dtc->chan), 1273 sizeof(chan_reset_val)); 1274 goto add_chan_err; 1275 } 1276 1277 } else { 1278 /* Clear test_channel if no channels were added successfully */ 1279 strlcpy(chan_reset_val, "", sizeof(chan_reset_val)); 1280 ret = -EBUSY; 1281 goto add_chan_err; 1282 } 1283 1284 info->last_error = ret; 1285 mutex_unlock(&info->lock); 1286 1287 return ret; 1288 1289 add_chan_err: 1290 param_set_copystring(chan_reset_val, kp); 1291 info->last_error = ret; 1292 mutex_unlock(&info->lock); 1293 1294 return ret; 1295 } 1296 1297 static int dmatest_chan_get(char *val, const struct kernel_param *kp) 1298 { 1299 struct dmatest_info *info = &test_info; 1300 1301 mutex_lock(&info->lock); 1302 if (!is_threaded_test_run(info) && !is_threaded_test_pending(info)) { 1303 stop_threaded_test(info); 1304 strlcpy(test_channel, "", sizeof(test_channel)); 1305 } 1306 mutex_unlock(&info->lock); 1307 1308 return param_get_string(val, kp); 1309 } 1310 1311 static int dmatest_test_list_get(char *val, const struct kernel_param *kp) 1312 { 1313 struct dmatest_info *info = &test_info; 1314 struct dmatest_chan *dtc; 1315 unsigned int thread_count = 0; 1316 1317 list_for_each_entry(dtc, &info->channels, node) { 1318 struct dmatest_thread *thread; 1319 1320 thread_count = 0; 1321 list_for_each_entry(thread, &dtc->threads, node) { 1322 thread_count++; 1323 } 1324 pr_info("%u threads using %s\n", 1325 thread_count, dma_chan_name(dtc->chan)); 1326 } 1327 1328 return 0; 1329 } 1330 1331 static int __init dmatest_init(void) 1332 { 1333 struct dmatest_info *info = &test_info; 1334 struct dmatest_params *params = &info->params; 1335 1336 if (dmatest_run) { 1337 mutex_lock(&info->lock); 1338 add_threaded_test(info); 1339 run_pending_tests(info); 1340 mutex_unlock(&info->lock); 1341 } 1342 1343 if (params->iterations && wait) 1344 wait_event(thread_wait, !is_threaded_test_run(info)); 1345 1346 /* module parameters are stable, inittime tests are started, 1347 * let userspace take over 'run' control 1348 */ 1349 info->did_init = true; 1350 1351 return 0; 1352 } 1353 /* when compiled-in wait for drivers to load first */ 1354 late_initcall(dmatest_init); 1355 1356 static void __exit dmatest_exit(void) 1357 { 1358 struct dmatest_info *info = &test_info; 1359 1360 mutex_lock(&info->lock); 1361 stop_threaded_test(info); 1362 mutex_unlock(&info->lock); 1363 } 1364 module_exit(dmatest_exit); 1365 1366 MODULE_AUTHOR("Haavard Skinnemoen (Atmel)"); 1367 MODULE_LICENSE("GPL v2"); 1368