/* Copyright (c) 2021 Advanced Micro Devices, Inc. All rights reserved. Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANNTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER INN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR INN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */ // Testcase Description: // 1) Verifies the working of Memcpy2DAsync API negative scenarios by // Pass NULL to destination pointer // Pass NULL to Source pointer // Pass width greater than spitch/dpitch // 2) Verifies hipMemcpy2DAsync API by // pass 0 to destionation pitch // pass 0 to source pitch // pass 0 to width // pass 0 to height // 3) Verifies working of Memcpy2DAsync API on host memory // and pinned host memory by // performing D2H, D2D and H2D memory kind copies on same GPU // 4) Verifies working of Memcpy2DAsync API on host memory // and pinned host memory by // performing D2H, D2D and H2D memory kind copies on peer GPU // 5) Verifies working of Memcpy2DAsync API where memory is allocated // in GPU-0 and stream is created on GPU-1 #include #include static constexpr auto NUM_W{16}; static constexpr auto NUM_H{16}; static constexpr auto COLUMNS{6}; static constexpr auto ROWS{6}; /* This performs the following scenarios of hipMemcpy2DAsync API on same GPU 1. H2D-D2D-D2H for Host Memory<-->Device Memory 2. H2D-D2D-D2H for Pinned Host Memory<-->Device Memory Input : "A_h" initialized based on data type "A_h" --> "A_d" using H2D copy "A_d" --> "B_d" using D2D copy "B_d" --> "B_h" using D2H copy Output: Validating A_h with B_h both should be equal for the number of COLUMNS and ROWS copied */ TEMPLATE_TEST_CASE("Unit_hipMemcpy2DAsync_Host&PinnedMem", "" , int, float, double) { // 1 refers to pinned host memory auto mem_type = GENERATE(0, 1); HIP_CHECK(hipSetDevice(0)); TestType *A_h{nullptr}, *B_h{nullptr}, *C_h{nullptr}, *A_d{nullptr}, *B_d{nullptr}; size_t pitch_A, pitch_B; size_t width{NUM_W * sizeof(TestType)}; hipStream_t stream; HIP_CHECK(hipStreamCreate(&stream)); // Allocating memory if (mem_type) { HipTest::initArrays(nullptr, nullptr, nullptr, &A_h, &B_h, &C_h, NUM_W*NUM_H, true); } else { HipTest::initArrays(nullptr, nullptr, nullptr, &A_h, &B_h, &C_h, NUM_W*NUM_H, false); } HIP_CHECK(hipMallocPitch(reinterpret_cast(&A_d), &pitch_A, width, NUM_H)); HIP_CHECK(hipMallocPitch(reinterpret_cast(&B_d), &pitch_B, width, NUM_H)); // Initialize the data HipTest::setDefaultData(NUM_W*NUM_H, A_h, B_h, C_h); SECTION("Calling Async apis with stream object created by user") { // Host to Device HIP_CHECK(hipMemcpy2DAsync(A_d, pitch_A, A_h, COLUMNS*sizeof(TestType), COLUMNS*sizeof(TestType), ROWS, hipMemcpyHostToDevice, stream)); // Performs D2D on same GPU device HIP_CHECK(hipMemcpy2DAsync(B_d, pitch_B, A_d, pitch_A, COLUMNS*sizeof(TestType), ROWS, hipMemcpyDeviceToDevice, stream)); // hipMemcpy2DAsync Device to Host HIP_CHECK(hipMemcpy2DAsync(B_h, COLUMNS*sizeof(TestType), B_d, pitch_B, COLUMNS*sizeof(TestType), ROWS, hipMemcpyDeviceToHost, stream)); HIP_CHECK(hipStreamSynchronize(stream)); } SECTION("Calling Async apis with hipStreamPerThread") { // Host to Device HIP_CHECK(hipMemcpy2DAsync(A_d, pitch_A, A_h, COLUMNS*sizeof(TestType), COLUMNS*sizeof(TestType), ROWS, hipMemcpyHostToDevice, hipStreamPerThread)); // Performs D2D on same GPU device HIP_CHECK(hipMemcpy2DAsync(B_d, pitch_B, A_d, pitch_A, COLUMNS*sizeof(TestType), ROWS, hipMemcpyDeviceToDevice, hipStreamPerThread)); // hipMemcpy2DAsync Device to Host HIP_CHECK(hipMemcpy2DAsync(B_h, COLUMNS*sizeof(TestType), B_d, pitch_B, COLUMNS*sizeof(TestType), ROWS, hipMemcpyDeviceToHost, hipStreamPerThread)); HIP_CHECK(hipStreamSynchronize(hipStreamPerThread)); } // Validating the result REQUIRE(HipTest::checkArray(A_h, B_h, COLUMNS, ROWS) == true); // DeAllocating the memory HIP_CHECK(hipFree(A_d)); HIP_CHECK(hipFree(B_d)); if (mem_type) { HipTest::freeArrays(nullptr, nullptr, nullptr, A_h, B_h, C_h, true); } else { HipTest::freeArrays(nullptr, nullptr, nullptr, A_h, B_h, C_h, false); } HIP_CHECK(hipStreamDestroy(stream)); } /* This testcases performs the following scenarios of hipMemcpy2DAsync API on Peer GPU 1. H2D-D2D-D2H for Host Memory<-->Device Memory 2. H2D-D2D-D2H for Pinned Host Memory<-->Device Memory Input : "A_h" initialized based on data type "A_h" --> "A_d" using H2D copy "A_d" --> "X_d" using D2D copy "X_d" --> "B_h" using D2H copy Output: Validating A_h with B_h both should be equal for the number of COLUMNS and ROWS copied */ TEMPLATE_TEST_CASE("Unit_hipMemcpy2DAsync_multiDevice-Host&PinnedMem", "" , int, float, double) { auto mem_type = GENERATE(0, 1); int numDevices = 0; int canAccessPeer = 0; TestType* A_h{nullptr}, *B_h{nullptr}, *C_h{nullptr}, *A_d{nullptr}; size_t pitch_A; size_t width{NUM_W * sizeof(TestType)}; HIP_CHECK(hipGetDeviceCount(&numDevices)); hipStream_t stream; if (numDevices > 1) { hipDeviceCanAccessPeer(&canAccessPeer, 0, 1); if (canAccessPeer) { HIP_CHECK(hipSetDevice(0)); HIP_CHECK(hipStreamCreate(&stream)); // Allocating memory if (mem_type) { HipTest::initArrays(nullptr, nullptr, nullptr, &A_h, &B_h, &C_h, NUM_W*NUM_H, true); } else { HipTest::initArrays(nullptr, nullptr, nullptr, &A_h, &B_h, &C_h, NUM_W*NUM_H, false); } HIP_CHECK(hipMallocPitch(reinterpret_cast(&A_d), &pitch_A, width, NUM_H)); // Initialize the data HipTest::setDefaultData(NUM_W*NUM_H, A_h, B_h, C_h); // Host to Device HIP_CHECK(hipMemcpy2DAsync(A_d, pitch_A, A_h, COLUMNS*sizeof(TestType), COLUMNS*sizeof(TestType), ROWS, hipMemcpyHostToDevice, stream)); // Change device HIP_CHECK(hipSetDevice(1)); char *X_d{nullptr}; size_t pitch_X; HIP_CHECK(hipMallocPitch(reinterpret_cast(&X_d), &pitch_X, width, NUM_H)); // Device to Device HIP_CHECK(hipMemcpy2DAsync(X_d, pitch_X, A_d, pitch_A, COLUMNS*sizeof(TestType), ROWS, hipMemcpyDeviceToDevice, stream)); // Device to Host HIP_CHECK(hipMemcpy2DAsync(B_h, COLUMNS*sizeof(TestType), X_d, pitch_X, COLUMNS*sizeof(TestType), ROWS, hipMemcpyDeviceToHost, stream)); HIP_CHECK(hipStreamSynchronize(stream)); // Validating the result REQUIRE(HipTest::checkArray(A_h, B_h, COLUMNS, ROWS) == true); // DeAllocating the memory HIP_CHECK(hipFree(A_d)); if (mem_type) { HipTest::freeArrays(nullptr, nullptr, nullptr, A_h, B_h, C_h, true); } else { HipTest::freeArrays(nullptr, nullptr, nullptr, A_h, B_h, C_h, false); } HIP_CHECK(hipFree(X_d)); HIP_CHECK(hipStreamDestroy(stream)); } else { SUCCEED("Machine does not seem to have P2P"); } } else { SUCCEED("skipped the testcase as no of devices is less than 2"); } } /* This testcases performs the following scenarios of hipMemcpy2DAsync API on Peer GPU 1. H2D-D2D-D2H for Host Memory<-->Device Memory 2. H2D-D2D-D2H for Pinned Host Memory<-->Device Memory Memory is allocated in GPU-0 and Stream is created in GPU-1 Input : "A_h" initialized based on data type "A_h" --> "A_d" using H2D copy "A_d" --> "X_d" using D2D copy "X_d" --> "B_h" using D2H copy Output: Validating A_h with B_h both should be equal for the number of COLUMNS and ROWS copied */ TEMPLATE_TEST_CASE("Unit_hipMemcpy2DAsync_multiDevice-StreamOnDiffDevice", "" , int, float, double) { auto mem_type = GENERATE(0, 1); int numDevices = 0; int canAccessPeer = 0; TestType* A_h{nullptr}, *B_h{nullptr}, *C_h{nullptr}, *A_d{nullptr}; size_t pitch_A; size_t width{NUM_W * sizeof(TestType)}; HIP_CHECK(hipGetDeviceCount(&numDevices)); hipStream_t stream; if (numDevices > 1) { hipDeviceCanAccessPeer(&canAccessPeer, 0, 1); if (canAccessPeer) { HIP_CHECK(hipSetDevice(0)); // Allocating memory if (mem_type) { HipTest::initArrays(nullptr, nullptr, nullptr, &A_h, &B_h, &C_h, NUM_W*NUM_H, true); } else { HipTest::initArrays(nullptr, nullptr, nullptr, &A_h, &B_h, &C_h, NUM_W*NUM_H, false); } HIP_CHECK(hipMallocPitch(reinterpret_cast(&A_d), &pitch_A, width, NUM_H)); char *X_d{nullptr}; size_t pitch_X; HIP_CHECK(hipMallocPitch(reinterpret_cast(&X_d), &pitch_X, width, NUM_H)); // Initialize the data HipTest::setDefaultData(NUM_W*NUM_H, A_h, B_h, C_h); // Change device HIP_CHECK(hipSetDevice(1)); HIP_CHECK(hipStreamCreate(&stream)); // Host to Device HIP_CHECK(hipMemcpy2DAsync(A_d, pitch_A, A_h, COLUMNS*sizeof(TestType), COLUMNS*sizeof(TestType), ROWS, hipMemcpyHostToDevice, stream)); // Device to Device HIP_CHECK(hipMemcpy2DAsync(X_d, pitch_X, A_d, pitch_A, COLUMNS*sizeof(TestType), ROWS, hipMemcpyDeviceToDevice, stream)); // Device to Host HIP_CHECK(hipMemcpy2DAsync(B_h, COLUMNS*sizeof(TestType), X_d, pitch_X, COLUMNS*sizeof(TestType), ROWS, hipMemcpyDeviceToHost, stream)); HIP_CHECK(hipStreamSynchronize(stream)); // Validating the result REQUIRE(HipTest::checkArray(A_h, B_h, COLUMNS, ROWS) == true); // DeAllocating the memory HIP_CHECK(hipFree(A_d)); if (mem_type) { HipTest::freeArrays(nullptr, nullptr, nullptr, A_h, B_h, C_h, true); } else { HipTest::freeArrays(nullptr, nullptr, nullptr, A_h, B_h, C_h, false); } HIP_CHECK(hipFree(X_d)); HIP_CHECK(hipStreamDestroy(stream)); } else { SUCCEED("Machine does not seem to have P2P"); } } else { SUCCEED("skipped the testcase as no of devices is less than 2"); } } /* This testcase verifies the null checks of hipMemcpy2DAsync API */ TEST_CASE("Unit_hipMemcpy2DAsync_SizeCheck") { HIP_CHECK(hipSetDevice(0)); int* A_h{nullptr}, *A_d{nullptr}; size_t pitch_A; size_t width{NUM_W * sizeof(int)}; hipStream_t stream; HIP_CHECK(hipStreamCreate(&stream)); // Allocating memory HipTest::initArrays(nullptr, nullptr, nullptr, &A_h, nullptr, nullptr, NUM_W*NUM_H); HIP_CHECK(hipMallocPitch(reinterpret_cast(&A_d), &pitch_A, width, NUM_H)); // Initialize the data HipTest::setDefaultData(NUM_W*NUM_H, A_h, nullptr, nullptr); SECTION("hipMemcpy2DAsync API where Source Pitch is zero") { REQUIRE(hipMemcpy2DAsync(A_h, 0, A_d, pitch_A, NUM_W, NUM_H, hipMemcpyDeviceToHost, stream) != hipSuccess); } SECTION("hipMemcpy2DAsync API where Destination Pitch is zero") { REQUIRE(hipMemcpy2DAsync(A_h, width, A_d, 0, NUM_W, NUM_H, hipMemcpyDeviceToHost, stream) != hipSuccess); } SECTION("hipMemcpy2DAsync API where height is zero") { REQUIRE(hipMemcpy2DAsync(A_h, width, A_d, pitch_A, NUM_W, 0, hipMemcpyDeviceToHost, stream) == hipSuccess); } SECTION("hipMemcpy2DAsync API where width is zero") { REQUIRE(hipMemcpy2DAsync(A_h, width, A_d, pitch_A, 0, NUM_H, hipMemcpyDeviceToHost, stream) == hipSuccess); } // DeAllocating the memory HIP_CHECK(hipFree(A_d)); free(A_h); } /* This testcase performs the negative scenarios of hipMemcpy2DAsync API */ TEST_CASE("Unit_hipMemcpy2DAsync_Negative") { HIP_CHECK(hipSetDevice(0)); int* A_h{nullptr}, *A_d{nullptr}; size_t pitch_A; size_t width{NUM_W * sizeof(int)}; hipStream_t stream; HIP_CHECK(hipStreamCreate(&stream)); // Allocating memory HipTest::initArrays(nullptr, nullptr, nullptr, &A_h, nullptr, nullptr, NUM_W*NUM_H); HIP_CHECK(hipMallocPitch(reinterpret_cast(&A_d), &pitch_A, width, NUM_H)); // Initialize the data HipTest::setDefaultData(NUM_W*NUM_H, A_h, nullptr, nullptr); SECTION("hipMemcpy2DAsync API by Passing nullptr to destination") { REQUIRE(hipMemcpy2DAsync(nullptr, width, A_d, pitch_A, COLUMNS*sizeof(int), ROWS, hipMemcpyDeviceToHost, stream) != hipSuccess); } SECTION("hipMemcpy2DAsync API by Passing nullptr to destination") { REQUIRE(hipMemcpy2DAsync(nullptr, width, nullptr, pitch_A, COLUMNS*sizeof(int), ROWS, hipMemcpyDeviceToHost, stream) != hipSuccess); } SECTION("hipMemcpy2DAsync API where width is > destination pitch") { REQUIRE(hipMemcpy2DAsync(A_h, 10, A_d, pitch_A, COLUMNS*sizeof(int), ROWS, hipMemcpyDeviceToHost, stream) != hipSuccess); } // DeAllocating the memory HIP_CHECK(hipFree(A_d)); HIP_CHECK(hipStreamDestroy(stream)); free(A_h); }