SWDEV-458787 - [catch2][dtest] Basic functional testcase for hipMemcpyAtoA API

Change-Id: Iea35ffde87edf62f8536f4688be2cde669e07f6e


[ROCm/hip-tests commit: 526ec4bb59]

projects/hip-tests/catch/unit/memory/CMakeLists.txt

@@ -52,6 +52,7 @@ set(TEST_SRC
     hipMemcpyAtoH.cc
     hipMemcpyAtoH_old.cc
     hipMemcpyHtoA.cc
+    hipMemcpyAtoA.cc
     hipMemcpyHtoA_old.cc
     hipMemcpyAllApiNegative.cc
     hipMemcpy_MultiThread.cc

projects/hip-tests/catch/unit/memory/hipMemcpyAtoA.cc

@@ -0,0 +1,84 @@
+/*
+Copyright (c) 2024 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 WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS 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 IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
+*/
+
+#include <hip_test_common.hh>
+#include <hip_test_checkers.hh>
+
+/**
+* @addtogroup hipMemcpyAtoA hipMemcpyAtoA
+* @{
+* @ingroup MemoryTest
+* `hipError_t hipMemcpyAtoA(hipArray_t dstArray, size_t dstOffset,
+*                           hipArray_t srcArray, size_t srcOffset,
+*                           size_t ByteCount)` -
+* Copies from one 1D array to another.
+*/
+
+/**
+ * Test Description
+ * ------------------------
+ *  - This testcase initially copies data from host to 1D array and then
+ *  performs hipMemcpyAtoA api call and copies this 1D array to host variable
+ *  and verifies with initial host values.
+ * Test source
+ * ------------------------
+ *  - unit/memory/hipMemcpyAtoA.cc
+ * Test requirements
+ * ------------------------
+ *  - HIP_VERSION >= 6.2
+ */
+
+TEST_CASE("Unit_hipMemcpyAtoA_Basic") {
+#if HT_NVIDIA
+  HipTest::HIP_SKIP_TEST("API currently unsupported on nvidia, skipping...");
+  return;
+#else
+  HIP_CHECK(hipSetDevice(0));
+  int row, col;
+  row = 1;
+  col = GENERATE(3, 4, 100);
+  int *A_h = reinterpret_cast<int*>(malloc(sizeof(int) * row * col));
+  int *B_h = reinterpret_cast<int*>(malloc(sizeof(int) * row * col));
+  for (int i = 0; i < (row * col); i++) {
+    A_h[i] = i;
+  }
+  hipArray_t A_a, B_a;
+  hipChannelFormatDesc desc = hipCreateChannelDesc<int>();
+  HIP_CHECK(hipMallocArray(&A_a, &desc, col, row, hipArrayDefault));
+  HIP_CHECK(hipMallocArray(&B_a, &desc, col, row, hipArrayDefault));
+  HIP_CHECK(hipMemcpy2DToArray(A_a, 0, 0, A_h, col * sizeof(int),
+                               col * sizeof(int), row, hipMemcpyHostToDevice));
+  HIP_CHECK(hipMemcpyAtoA(B_a, 0, A_a, 0, sizeof(int) * row * col));
+  HIP_CHECK(hipMemcpy2DFromArray(B_h, sizeof(int) * col, B_a, 0, 0,
+                                 sizeof(int) * col, row,
+                                 hipMemcpyDeviceToHost));
+  for (int i = 0; i < (row * col); i++) {
+    REQUIRE(A_h[i] == B_h[i]);
+  }
+  HIP_CHECK(hipFreeArray(A_a));
+  HIP_CHECK(hipFreeArray(B_a));
+  free(A_h);
+  free(B_h);
+#endif
+}
+
+/**
+* End doxygen group MemoryTest.
+* @}
+*/