Blame opae-libs/tests/xfpga/test_usrclk_c.cpp

Packit 534379
// Copyright(c) 2018, Intel Corporation
Packit 534379
//
Packit 534379
// Redistribution  and  use  in source  and  binary  forms,  with  or  without
Packit 534379
// modification, are permitted provided that the following conditions are met:
Packit 534379
//
Packit 534379
// * Redistributions of  source code  must retain the  above copyright notice,
Packit 534379
//   this list of conditions and the following disclaimer.
Packit 534379
// * Redistributions in binary form must reproduce the above copyright notice,
Packit 534379
//   this list of conditions and the following disclaimer in the documentation
Packit 534379
//   and/or other materials provided with the distribution.
Packit 534379
// * Neither the name  of Intel Corporation  nor the names of its contributors
Packit 534379
//   may be used to  endorse or promote  products derived  from this  software
Packit 534379
//   without specific prior written permission.
Packit 534379
//
Packit 534379
// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
Packit 534379
// AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING,  BUT NOT LIMITED TO,  THE
Packit 534379
// IMPLIED WARRANTIES OF  MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
Packit 534379
// ARE DISCLAIMED.  IN NO EVENT  SHALL THE COPYRIGHT OWNER  OR CONTRIBUTORS BE
Packit 534379
// LIABLE  FOR  ANY  DIRECT,  INDIRECT,  INCIDENTAL,  SPECIAL,  EXEMPLARY,  OR
Packit 534379
// CONSEQUENTIAL  DAMAGES  (INCLUDING,  BUT  NOT LIMITED  TO,  PROCUREMENT  OF
Packit 534379
// SUBSTITUTE GOODS OR SERVICES;  LOSS OF USE,  DATA, OR PROFITS;  OR BUSINESS
Packit 534379
// INTERRUPTION)  HOWEVER CAUSED  AND ON ANY THEORY  OF LIABILITY,  WHETHER IN
Packit 534379
// CONTRACT,  STRICT LIABILITY,  OR TORT  (INCLUDING NEGLIGENCE  OR OTHERWISE)
Packit 534379
// ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,  EVEN IF ADVISED OF THE
Packit 534379
// POSSIBILITY OF SUCH DAMAGE.
Packit 534379
Packit 534379
#ifdef __cplusplus
Packit 534379
Packit 534379
extern "C" {
Packit 534379
#endif
Packit 534379
#include <opae/enum.h>
Packit 534379
#include <opae/properties.h>
Packit 534379
#undef  _GNU_SOURCE
Packit 534379
#include "usrclk/user_clk_pgm_uclock.h"
Packit 534379
Packit 534379
#ifdef __cplusplus
Packit 534379
}
Packit 534379
#endif
Packit 534379
Packit 534379
Packit 534379
#include "gtest/gtest.h"
Packit 534379
#include "types_int.h"
Packit 534379
#include "mock/test_system.h"
Packit 534379
#include "xfpga.h"
Packit 534379
#include "sysfs_int.h"
Packit 534379
Packit 534379
extern "C" {
Packit 534379
int xfpga_plugin_initialize(void);
Packit 534379
int xfpga_plugin_finalize(void);
Packit 534379
}
Packit 534379
Packit 534379
Packit 534379
using namespace opae::testing;
Packit 534379
Packit 534379
class usrclk_c
Packit 534379
    : public ::testing::TestWithParam<std::string> {
Packit 534379
 protected:
Packit 534379
  usrclk_c()
Packit 534379
  : handle_dev_(nullptr),
Packit 534379
    handle_accel_(nullptr),
Packit 534379
    tokens_dev_{{nullptr, nullptr}},
Packit 534379
    tokens_accel_{{nullptr, nullptr}},
Packit 534379
    filter_dev_(nullptr),
Packit 534379
    filter_accel_(nullptr) {}
Packit 534379
Packit 534379
  virtual void SetUp() override {
Packit 534379
    ASSERT_TRUE(test_platform::exists(GetParam()));
Packit 534379
    platform_ = test_platform::get(GetParam());
Packit 534379
    system_ = test_system::instance();
Packit 534379
    system_->initialize();
Packit 534379
    system_->prepare_syfs(platform_);
Packit 534379
Packit 534379
    ASSERT_EQ(xfpga_plugin_initialize(), FPGA_OK);
Packit 534379
    ASSERT_EQ(xfpga_fpgaGetProperties(nullptr, &filter_dev_), FPGA_OK);
Packit 534379
    ASSERT_EQ(fpgaPropertiesSetDeviceID(filter_dev_,
Packit 534379
                                        platform_.devices[0].device_id), FPGA_OK);
Packit 534379
    ASSERT_EQ(fpgaPropertiesSetObjectType(filter_dev_, FPGA_DEVICE), FPGA_OK);
Packit 534379
    ASSERT_EQ(xfpga_fpgaEnumerate(&filter_dev_, 1, tokens_dev_.data(),
Packit 534379
              tokens_dev_.size(), &num_matches_), FPGA_OK);
Packit 534379
    ASSERT_GT(num_matches_, 0);
Packit 534379
Packit 534379
    ASSERT_EQ(xfpga_fpgaGetProperties(nullptr, &filter_accel_), FPGA_OK);
Packit 534379
    auto devid = platform_.devices[0].device_id + platform_.devices[0].num_vfs;
Packit 534379
    ASSERT_EQ(fpgaPropertiesSetDeviceID(filter_accel_, devid), FPGA_OK);
Packit 534379
    ASSERT_EQ(fpgaPropertiesSetObjectType(filter_accel_, FPGA_ACCELERATOR), FPGA_OK);
Packit 534379
    ASSERT_EQ(xfpga_fpgaEnumerate(&filter_accel_, 1, tokens_accel_.data(),
Packit 534379
              tokens_accel_.size(), &num_matches_), FPGA_OK);
Packit 534379
    ASSERT_GT(num_matches_, 0);
Packit 534379
  }
Packit 534379
Packit 534379
  virtual void TearDown() override {
Packit 534379
    EXPECT_EQ(fpgaDestroyProperties(&filter_dev_), FPGA_OK);
Packit 534379
    EXPECT_EQ(fpgaDestroyProperties(&filter_accel_), FPGA_OK);
Packit 534379
Packit 534379
    for (auto &t : tokens_dev_) {
Packit 534379
      if (t) {
Packit 534379
        EXPECT_EQ(FPGA_OK, xfpga_fpgaDestroyToken(&t);;
Packit 534379
        t = nullptr;
Packit 534379
      }
Packit 534379
    }
Packit 534379
Packit 534379
    for (auto &t : tokens_accel_) {
Packit 534379
      if (t) {
Packit 534379
        EXPECT_EQ(FPGA_OK, xfpga_fpgaDestroyToken(&t);;
Packit 534379
        t = nullptr;
Packit 534379
      }
Packit 534379
    }
Packit 534379
Packit 534379
    if (handle_dev_ != nullptr) { EXPECT_EQ(xfpga_fpgaClose(handle_dev_), FPGA_OK); }
Packit 534379
    if (handle_accel_ != nullptr) { EXPECT_EQ(xfpga_fpgaClose(handle_accel_), FPGA_OK); }
Packit 534379
    xfpga_plugin_finalize();
Packit 534379
    system_->finalize();
Packit 534379
  }
Packit 534379
Packit 534379
  fpga_handle handle_dev_;
Packit 534379
  fpga_handle handle_accel_;
Packit 534379
  std::array<fpga_token, 2> tokens_dev_;
Packit 534379
  std::array<fpga_token, 2> tokens_accel_;
Packit 534379
  fpga_properties filter_dev_;
Packit 534379
  fpga_properties filter_accel_;
Packit 534379
  uint32_t num_matches_;
Packit 534379
  test_platform platform_;
Packit 534379
  test_system *system_;
Packit 534379
};
Packit 534379
Packit 534379
/**
Packit 534379
* @test    afu_usrclk_01
Packit 534379
* @brief   Tests: fpac_GetErrMsg and fv_BugLog
Packit 534379
* @details fpac_GetErrMsg returns error string
Packit 534379
*          fv_BugLog sets bug log
Packit 534379
*/
Packit 534379
TEST(usrclk_c, afu_usrclk_01) {
Packit 534379
  //Get error string
Packit 534379
  const char * pmsg = fpac_GetErrMsg(1);
Packit 534379
  EXPECT_EQ(NULL, !pmsg);
Packit 534379
Packit 534379
  //Get error string
Packit 534379
  pmsg = fpac_GetErrMsg(5);
Packit 534379
  EXPECT_EQ(NULL, !pmsg);
Packit 534379
Packit 534379
  //Get error string
Packit 534379
  pmsg = fpac_GetErrMsg(16);
Packit 534379
  EXPECT_EQ(NULL, !pmsg);
Packit 534379
Packit 534379
  //Get error string for invlaid index
Packit 534379
  pmsg = NULL;
Packit 534379
  pmsg = fpac_GetErrMsg(17);
Packit 534379
  EXPECT_STREQ("ERROR: MSG INDEX OUT OF RANGE", pmsg);
Packit 534379
Packit 534379
  //Get error string for invlaid index
Packit 534379
  pmsg = NULL;
Packit 534379
  pmsg = fpac_GetErrMsg(-1);
Packit 534379
  EXPECT_STREQ("ERROR: MSG INDEX OUT OF RANGE", pmsg);
Packit 534379
Packit 534379
  fv_BugLog(1);
Packit 534379
Packit 534379
  fv_BugLog(2);
Packit 534379
Packit 534379
}
Packit 534379
Packit 534379
/**
Packit 534379
* @test    set_user_clock
Packit 534379
* @brief   Tests: set_userclock
Packit 534379
* @details When the sysfs path is NULL, set_userclock
Packit 534379
*          returns FPGA_INVALID_PARAM.
Packit 534379
*/
Packit 534379
TEST(usrclk_c, set_userclock_null) {
Packit 534379
  fpga_result result;
Packit 534379
Packit 534379
  // Null handle
Packit 534379
  result = set_userclock(NULL, 0, 0);
Packit 534379
  EXPECT_EQ(result, FPGA_INVALID_PARAM);
Packit 534379
}
Packit 534379
Packit 534379
/**
Packit 534379
* @test    get_user_clock
Packit 534379
* @brief   Tests: get_userclock
Packit 534379
* @details When the sysfs path is NULL, get_userclock
Packit 534379
*          returns FPGA_INVALID_PARAM.
Packit 534379
*/
Packit 534379
TEST(usrclk_c, get_userclock_null) {
Packit 534379
  fpga_result result;
Packit 534379
Packit 534379
  // Null handle
Packit 534379
  result = get_userclock(NULL, 0, 0);
Packit 534379
  EXPECT_EQ(result, FPGA_INVALID_PARAM);
Packit 534379
}
Packit 534379
Packit 534379
/**
Packit 534379
* @test    fi_run_initz
Packit 534379
* @brief   Tests: fi_RunInitz
Packit 534379
* @details When the sysfs path is NULL, fi_RunInitz
Packit 534379
*          returns -1.
Packit 534379
*/
Packit 534379
TEST(usrclk_c, fi_run_initz) {
Packit 534379
  EXPECT_EQ(-1, fi_RunInitz(NULL));
Packit 534379
}
Packit 534379
Packit 534379
/**
Packit 534379
* @test    fpga_set_user_clock
Packit 534379
* @brief   Tests: fpgaSetUserClock
Packit 534379
* @details fpgaSetUserClock
Packit 534379
*/
Packit 534379
TEST_P(usrclk_c, set_user_clock_neg) {
Packit 534379
  fpga_result result;
Packit 534379
  int flags = 0;
Packit 534379
Packit 534379
  // Null handle
Packit 534379
  result = xfpga_fpgaSetUserClock(NULL, 0, 0, flags);
Packit 534379
  EXPECT_EQ(result, FPGA_INVALID_PARAM);
Packit 534379
Packit 534379
  // Invalid object type
Packit 534379
  ASSERT_EQ(FPGA_OK, xfpga_fpgaOpen(tokens_dev_[0], &handle_dev_, 0));
Packit 534379
Packit 534379
  // Invalid clk
Packit 534379
  result = xfpga_fpgaSetUserClock(handle_dev_, 0, 0, flags);
Packit 534379
  EXPECT_EQ(result, FPGA_INVALID_PARAM);
Packit 534379
Packit 534379
  // Valid clk
Packit 534379
  result = xfpga_fpgaSetUserClock(handle_dev_, 312, 156, flags);
Packit 534379
  EXPECT_EQ(result, FPGA_INVALID_PARAM);
Packit 534379
Packit 534379
  // Valid object type
Packit 534379
  ASSERT_EQ(FPGA_OK, xfpga_fpgaOpen(tokens_accel_[0], &handle_accel_, 0));
Packit 534379
Packit 534379
  // Invalid clk
Packit 534379
  result = xfpga_fpgaSetUserClock(handle_accel_, 0, 0, flags);
Packit 534379
  EXPECT_EQ(result, FPGA_INVALID_PARAM);
Packit 534379
Packit 534379
  struct _fpga_handle  *_handle = (struct _fpga_handle *)handle_accel_;
Packit 534379
  int fddev = _handle->fddev;
Packit 534379
Packit 534379
  // Token not found
Packit 534379
  _handle->token = NULL;
Packit 534379
  result = xfpga_fpgaSetUserClock(handle_accel_, 312, 156, flags);
Packit 534379
  EXPECT_EQ(result, FPGA_INVALID_PARAM);
Packit 534379
Packit 534379
  // Invalid file handle descriptor
Packit 534379
  _handle->fddev = -1;
Packit 534379
  result = xfpga_fpgaSetUserClock(handle_accel_, 312, 156, flags);
Packit 534379
  EXPECT_EQ(result, FPGA_INVALID_PARAM);
Packit 534379
Packit 534379
  _handle->fddev = fddev;
Packit 534379
}
Packit 534379
Packit 534379
/**
Packit 534379
* @test    fpga_get_user_clock
Packit 534379
* @brief   Tests: fpgaGetUserClock
Packit 534379
* @details fpgaGetUserClock
Packit 534379
*/
Packit 534379
TEST_P(usrclk_c, get_user_clock_neg) {
Packit 534379
  fpga_result result;
Packit 534379
  uint64_t high;
Packit 534379
  uint64_t low;
Packit 534379
  int flags = 0;
Packit 534379
Packit 534379
  // Null handle
Packit 534379
  result = xfpga_fpgaGetUserClock(NULL, &high, &low, flags);
Packit 534379
  EXPECT_EQ(result, FPGA_INVALID_PARAM);
Packit 534379
Packit 534379
  // Invalid object type
Packit 534379
  ASSERT_EQ(FPGA_OK, xfpga_fpgaOpen(tokens_dev_[0], &handle_dev_, 0));
Packit 534379
Packit 534379
  // Valid params, invalid object type
Packit 534379
  result = xfpga_fpgaGetUserClock(handle_dev_, &high, &low, flags);
Packit 534379
  EXPECT_EQ(result, FPGA_INVALID_PARAM);
Packit 534379
Packit 534379
  // Valid object type
Packit 534379
  ASSERT_EQ(FPGA_OK, xfpga_fpgaOpen(tokens_accel_[0], &handle_accel_, 0));
Packit 534379
Packit 534379
  struct _fpga_handle  *_handle = (struct _fpga_handle *)handle_accel_;
Packit 534379
  int fddev = _handle->fddev;
Packit 534379
Packit 534379
  // Token not found
Packit 534379
  _handle->token = NULL;
Packit 534379
  result = xfpga_fpgaGetUserClock(handle_accel_, &high, &low, flags);
Packit 534379
  EXPECT_EQ(result, FPGA_INVALID_PARAM);
Packit 534379
Packit 534379
  // Invalid file handle descriptor
Packit 534379
  _handle->fddev = -1;
Packit 534379
  result = xfpga_fpgaGetUserClock(handle_accel_, &high, &low, flags);
Packit 534379
  EXPECT_EQ(result, FPGA_INVALID_PARAM);
Packit 534379
Packit 534379
  _handle->fddev = fddev;
Packit 534379
}
Packit 534379
Packit 534379
/**
Packit 534379
 * @test    get_user_clock
Packit 534379
 * @brief   Tests: xfpga_fpgaGetUserClock()
Packit 534379
 * @details When the parameters are valid, fpgaGetUserClock returns
Packit 534379
 *          FPGA_OK.
Packit 534379
 */
Packit 534379
TEST_P(usrclk_c, get_user_clock) {
Packit 534379
  uint64_t high = 999;
Packit 534379
  uint64_t low = 999;
Packit 534379
  int flags = 0;
Packit 534379
  ASSERT_EQ(xfpga_fpgaOpen(tokens_accel_[0], &handle_accel_, flags),
Packit 534379
            FPGA_OK);
Packit 534379
  EXPECT_EQ(xfpga_fpgaGetUserClock(handle_accel_, &high, &low, flags),
Packit 534379
            FPGA_OK);
Packit 534379
  EXPECT_NE(high, 999);
Packit 534379
  EXPECT_NE(low, 999);
Packit 534379
}
Packit 534379
Packit 534379
INSTANTIATE_TEST_CASE_P(usrclk, usrclk_c,
Packit 534379
                        ::testing::ValuesIn(test_platform::platforms({ "skx-p","dcp-rc" })));
Packit 534379
Packit 534379
class usrclk_mock_c : public usrclk_c {};
Packit 534379
Packit 534379
/**
Packit 534379
 * @test    set_user_clock
Packit 534379
 * @brief   Tests: xfpga_fpgaSetUserClock()
Packit 534379
 * @details When the parameters are valid, fpgaGetUserClock returns
Packit 534379
 *          FPGA_NOT_SUPPORTED on mock platforms.
Packit 534379
 */
Packit 534379
TEST_P(usrclk_mock_c, set_user_clock) {
Packit 534379
  uint64_t high = 312;
Packit 534379
  uint64_t low = 156;
Packit 534379
  int flags = 0;
Packit 534379
  ASSERT_EQ(xfpga_fpgaOpen(tokens_accel_[0], &handle_accel_, flags),
Packit 534379
            FPGA_OK);
Packit 534379
  EXPECT_EQ(xfpga_fpgaSetUserClock(handle_accel_, high, low, flags),
Packit 534379
            FPGA_NOT_SUPPORTED);
Packit 534379
}
Packit 534379
Packit 534379
INSTANTIATE_TEST_CASE_P(usrclk, usrclk_mock_c,
Packit 534379
                        ::testing::ValuesIn(test_platform::mock_platforms()));
Packit 534379
Packit 534379
class usrclk_hw_c : public usrclk_c {};
Packit 534379
Packit 534379
/**
Packit 534379
 * @test    set_user_clock
Packit 534379
 * @brief   Tests: xfpga_fpgaSetUserClock()
Packit 534379
 * @details When the parameters are valid, fpgaGetUserClock returns
Packit 534379
 *          FPGA_OK.
Packit 534379
 */
Packit 534379
TEST_P(usrclk_hw_c, set_user_clock) {
Packit 534379
uint64_t high = 312;
Packit 534379
  uint64_t low = 156;
Packit 534379
  int flags = 0;
Packit 534379
  ASSERT_EQ(xfpga_fpgaOpen(tokens_accel_[0], &handle_accel_, flags),
Packit 534379
            FPGA_OK);
Packit 534379
  EXPECT_EQ(xfpga_fpgaSetUserClock(handle_accel_, high, low, flags),
Packit 534379
            FPGA_OK);
Packit 534379
}
Packit 534379
Packit 534379
INSTANTIATE_TEST_CASE_P(usrclk, usrclk_hw_c,
Packit 534379
                        ::testing::ValuesIn(test_platform::hw_platforms({ "skx-p","dcp-rc" })));