/* 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. */ /* This testfile verifies the following scenarios of hipMemcpyParam2D API 1. Negative Scenarios 2. Extent Validation Scenarios 3. D2D copy for different datatypes 4. H2D and D2H copy for different datatypes */ #include #include static constexpr size_t NUM_W{10}; static constexpr size_t NUM_H{10}; /* * This testcase verifies D2D functionality of hipMemcpyParam2D API * Input: Intializing "A_d" device variable with "C_h" host variable * Output: "A_d" device variable to "E_d" device variable * * Validating the result by copying "E_d" to "A_h" and checking * it with the initalized data "C_h". * */ TEMPLATE_TEST_CASE("Unit_hipMemcpyParam2D_multiDevice-D2D", "[hipMemcpyParam2D]", char, float, int, double, long double) { int numDevices = 0; HIP_CHECK(hipGetDeviceCount(&numDevices)); if (numDevices > 1) { // Initialize and Allocating Memory HIP_CHECK(hipSetDevice(0)); TestType* A_h{nullptr}, *C_h{nullptr}, *A_d{nullptr}; size_t pitch_A; size_t width{NUM_W * sizeof(TestType)}; HIP_CHECK(hipMallocPitch(reinterpret_cast(&A_d), &pitch_A, width, NUM_H)); HipTest::initArrays(nullptr, nullptr, nullptr, &A_h, nullptr, &C_h, width*NUM_H, false); HipTest::setDefaultData(NUM_W*NUM_H, A_h, nullptr, C_h); int peerAccess = 0; HIP_CHECK(hipDeviceCanAccessPeer(&peerAccess, 1, 0)); if (!peerAccess) { SUCCEED("Skipped the test as there is no peer access"); } else { HIP_CHECK(hipSetDevice(1)); char *E_d; size_t pitch_E; HIP_CHECK(hipMallocPitch(reinterpret_cast(&E_d), &pitch_E, width, NUM_H)); // Initalizing A_d with C_h HIP_CHECK(hipMemcpy2D(A_d, pitch_A, C_h, width, NUM_W * sizeof(TestType), NUM_H, hipMemcpyHostToDevice)); // Device to Device hip_Memcpy2D desc = {}; #ifdef __HIP_PLATFORM_NVCC__ desc.srcMemoryType = CU_MEMORYTYPE_DEVICE; #else desc.srcMemoryType = hipMemoryTypeDevice; #endif desc.srcHost = A_d; desc.srcDevice = hipDeviceptr_t(A_d); desc.srcPitch = pitch_A; #ifdef __HIP_PLATFORM_NVCC__ desc.dstMemoryType = CU_MEMORYTYPE_DEVICE; #else desc.dstMemoryType = hipMemoryTypeDevice; #endif desc.dstHost = E_d; desc.dstDevice = hipDeviceptr_t(E_d); desc.dstPitch = pitch_E; desc.WidthInBytes = NUM_W * sizeof(TestType); desc.Height = NUM_H; REQUIRE(hipMemcpyParam2D(&desc) == hipSuccess); // Copying E_d to A_h HIP_CHECK(hipMemcpy2D(A_h, width, E_d, pitch_E, NUM_W * sizeof(TestType), NUM_H, hipMemcpyDeviceToHost)); // Validating the result REQUIRE(HipTest::checkArray(A_h, C_h, NUM_W, NUM_H) == true); // DeAllocating the memory HIP_CHECK(hipFree(A_d)); HipTest::freeArrays(nullptr, nullptr, nullptr, A_h, nullptr, C_h, false); } } else { SUCCEED("skipping the testcases as numDevices < 2"); } } /* * This testcase verifies H2D & D2H functionality of hipMemcpyParam2D API * H2D case: * Input: "C_h" host variable initialized with default data * Output: "A_d" device variable * * D2H case: * Input: "A_d" device variable from the previous output * OutPut: "A_h" variable * * Validating the result by comparing "A_h" to "C_h" */ TEMPLATE_TEST_CASE("Unit_hipMemcpyParam2D_multiDevice-H2D-D2H", "[hipMemcpyParam2D]", char, float, int, double, long double) { // 1 refers to pinned host memory and 0 refers // to unpinned memory auto memory_type = GENERATE(0, 1); int numDevices = 0; HIP_CHECK(hipGetDeviceCount(&numDevices)); if (numDevices > 1) { HIP_CHECK(hipSetDevice(0)); // Initialize and Allocating Memory TestType* A_h{nullptr}, *C_h{nullptr}, *A_d{nullptr}; size_t pitch_A; size_t width{NUM_W * sizeof(TestType)}; HIP_CHECK(hipMallocPitch(reinterpret_cast(&A_d), &pitch_A, width, NUM_H)); // Based on memory type (pinned/unpinned) allocating memory if (memory_type) { HipTest::initArrays(nullptr, nullptr, nullptr, &A_h, nullptr, &C_h, width*NUM_H, true); } else { HipTest::initArrays(nullptr, nullptr, nullptr, &A_h, nullptr, &C_h, width*NUM_H, false); } HipTest::setDefaultData(NUM_W*NUM_H, A_h, nullptr, C_h); int peerAccess = 0; HIP_CHECK(hipDeviceCanAccessPeer(&peerAccess, 1, 0)); if (!peerAccess) { SUCCEED("Skipped the test as there is no peer access"); } else { // Host to Device hip_Memcpy2D desc = {}; #ifdef __HIP_PLATFORM_NVCC__ desc.srcMemoryType = CU_MEMORYTYPE_HOST; #else desc.srcMemoryType = hipMemoryTypeHost; #endif desc.srcHost = C_h; desc.srcDevice = hipDeviceptr_t(C_h); desc.srcPitch = width; #ifdef __HIP_PLATFORM_NVCC__ desc.dstMemoryType = CU_MEMORYTYPE_DEVICE; #else desc.dstMemoryType = hipMemoryTypeDevice; #endif desc.dstHost = A_d; desc.dstDevice = hipDeviceptr_t(A_d); desc.dstPitch = pitch_A; desc.WidthInBytes = NUM_W*sizeof(TestType); desc.Height = NUM_H; REQUIRE(hipMemcpyParam2D(&desc) == hipSuccess); // Device to Host memset(&desc, 0x0, sizeof(hip_Memcpy2D)); #ifdef __HIP_PLATFORM_NVCC__ desc.srcMemoryType = CU_MEMORYTYPE_DEVICE; #else desc.srcMemoryType = hipMemoryTypeDevice; #endif desc.srcHost = A_d; desc.srcDevice = hipDeviceptr_t(A_d); desc.srcPitch = pitch_A; #ifdef __HIP_PLATFORM_NVCC__ desc.dstMemoryType = CU_MEMORYTYPE_HOST; #else desc.dstMemoryType = hipMemoryTypeHost; #endif desc.dstHost = A_h; desc.dstDevice = hipDeviceptr_t(A_h); desc.dstPitch = width; desc.WidthInBytes = NUM_W*sizeof(TestType); desc.Height = NUM_H; REQUIRE(hipMemcpyParam2D(&desc) == hipSuccess); // Validating the result REQUIRE(HipTest::checkArray(A_h, C_h, NUM_W, NUM_H) == true); // DeAllocating the Memory HIP_CHECK(hipFree(A_d)); if (memory_type) { HipTest::freeArrays(nullptr, nullptr, nullptr, A_h, nullptr, C_h, true); } else { HipTest::freeArrays(nullptr, nullptr, nullptr, A_h, nullptr, C_h, false); } } } else { SUCCEED("skipping the testcases as numDevices < 2"); } } /* * This testcase verifies the extent validation scenarios */ TEST_CASE("Unit_hipMemcpyParam2D_ExtentValidation") { // Allocating memory and Initializing the data HIP_CHECK(hipSetDevice(0)); char* A_h{nullptr}, *B_h{nullptr}, *C_h{nullptr}, * A_d{nullptr}; size_t pitch_A; size_t width{NUM_W * sizeof(char)}; constexpr auto memsetval{100}; HIP_CHECK(hipMallocPitch(reinterpret_cast(&A_d), &pitch_A, width, NUM_H)); HipTest::initArrays(nullptr, nullptr, nullptr, &A_h, nullptr, &C_h, width*NUM_H, false); HipTest::initArrays(nullptr, nullptr, nullptr, &B_h, nullptr, nullptr, width*NUM_H, false); HipTest::setDefaultData(NUM_W*NUM_H, A_h, nullptr, C_h); HipTest::setDefaultData(NUM_W*NUM_H, B_h, nullptr, nullptr); HIP_CHECK(hipMemset2D(A_d, pitch_A, memsetval, NUM_W, NUM_H)); // Device to Host hip_Memcpy2D desc = {}; #ifdef __HIP_PLATFORM_NVCC__ desc.srcMemoryType = CU_MEMORYTYPE_DEVICE; #else desc.srcMemoryType = hipMemoryTypeDevice; #endif desc.srcHost = A_d; desc.srcDevice = hipDeviceptr_t(A_d); desc.srcPitch = pitch_A; #ifdef __HIP_PLATFORM_NVCC__ desc.dstMemoryType = CU_MEMORYTYPE_HOST; #else desc.dstMemoryType = hipMemoryTypeHost; #endif desc.dstHost = A_h; desc.dstDevice = hipDeviceptr_t(A_h); desc.dstPitch = width; desc.WidthInBytes = NUM_W; desc.Height = NUM_H; SECTION("Destination Pitch is 0") { desc.dstPitch = 0; REQUIRE(hipMemcpyParam2D(&desc) == hipSuccess); } SECTION("Source Pitch is 0") { desc.srcPitch = 0; REQUIRE(hipMemcpyParam2D(&desc) == hipSuccess); } SECTION("Height is 0") { desc.Height = 0; REQUIRE(hipMemcpyParam2D(&desc) == hipSuccess); REQUIRE(HipTest::checkArray(A_h, B_h, NUM_W, NUM_H) == true); } SECTION("Width is 0") { desc.WidthInBytes = 0; REQUIRE(hipMemcpyParam2D(&desc) == hipSuccess); REQUIRE(HipTest::checkArray(A_h, B_h, NUM_W, NUM_H) == true); } // DeAllocating the Memory HIP_CHECK(hipFree(A_d)); HipTest::freeArrays(nullptr, nullptr, nullptr, A_h, B_h, C_h, false); } /* * This testcase verifies the negative scenarios */ TEST_CASE("Unit_hipMemcpyParam2D_Negative") { HIP_CHECK(hipSetDevice(0)); // Allocating and Initializing the data float* A_h{nullptr}, *B_h{nullptr}, *C_h{nullptr}, * A_d{nullptr}; size_t pitch_A; size_t width{NUM_W * sizeof(float)}; constexpr auto memsetval{100}; HIP_CHECK(hipMallocPitch(reinterpret_cast(&A_d), &pitch_A, width, NUM_H)); HipTest::initArrays(nullptr, nullptr, nullptr, &A_h, &B_h, &C_h, width*NUM_H, false); HipTest::setDefaultData(NUM_W*NUM_H, A_h, B_h, C_h); HIP_CHECK(hipMemset2D(A_d, pitch_A, memsetval, NUM_W, NUM_H)); hip_Memcpy2D desc = {}; #ifdef __HIP_PLATFORM_NVCC__ desc.srcMemoryType = CU_MEMORYTYPE_DEVICE; #else desc.srcMemoryType = hipMemoryTypeDevice; #endif desc.srcHost = A_d; desc.srcDevice = hipDeviceptr_t(A_d); desc.srcPitch = pitch_A; #ifdef __HIP_PLATFORM_NVCC__ desc.dstMemoryType = CU_MEMORYTYPE_HOST; #else desc.dstMemoryType = hipMemoryTypeHost; #endif desc.dstHost = A_h; desc.dstDevice = hipDeviceptr_t(A_h); desc.dstPitch = width; desc.WidthInBytes = NUM_W; desc.Height = NUM_H; SECTION("Null Pointer to Source Device Pointer") { desc.srcDevice = hipDeviceptr_t(nullptr); REQUIRE(hipMemcpyParam2D(&desc) != hipSuccess); } SECTION("Null Pointer to Destination Device Pointer") { memset(&desc, 0x0, sizeof(hip_Memcpy2D)); #ifdef __HIP_PLATFORM_NVCC__ desc.srcMemoryType = CU_MEMORYTYPE_HOST; #else desc.srcMemoryType = hipMemoryTypeHost; #endif desc.srcHost = A_h; desc.srcDevice = hipDeviceptr_t(A_h); desc.srcPitch = width; #ifdef __HIP_PLATFORM_NVCC__ desc.dstMemoryType = CU_MEMORYTYPE_DEVICE; #else desc.dstMemoryType = hipMemoryTypeDevice; #endif desc.dstHost = A_d; desc.dstDevice = hipDeviceptr_t(nullptr); desc.dstPitch = pitch_A; desc.WidthInBytes = NUM_W; desc.Height = NUM_H; REQUIRE(hipMemcpyParam2D(&desc) != hipSuccess); } SECTION("Null Pointer to both Src & Dst Device Pointer") { desc.srcDevice = hipDeviceptr_t(nullptr); desc.dstDevice = hipDeviceptr_t(nullptr); REQUIRE(hipMemcpyParam2D(&desc) != hipSuccess); } SECTION("Width > src/dest pitches") { desc.WidthInBytes = pitch_A+1; REQUIRE(hipMemcpyParam2D(&desc) != hipSuccess); } // DeAllocating the Memory HIP_CHECK(hipFree(A_d)); HipTest::freeArrays(nullptr, nullptr, nullptr, A_h, B_h, C_h, false); }