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

Packit 534379
// Copyright(c) 2017-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
#include <opae/fpga.h>
Packit 534379
#include <algorithm>
Packit 534379
#include "gtest/gtest.h"
Packit 534379
#include "mock/test_system.h"
Packit 534379
#include "types_int.h"
Packit 534379
#include "xfpga.h"
Packit 534379
#include "props.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
using namespace opae::testing;
Packit 534379
Packit 534379
class properties_c_p : public ::testing::TestWithParam<std::string> {
Packit 534379
 protected:
Packit 534379
  properties_c_p()
Packit 534379
      : tokens_accel_{{nullptr, nullptr}},
Packit 534379
        tokens_dev_{{nullptr, nullptr}},
Packit 534379
        prop_(nullptr),
Packit 534379
        filter_accel_(nullptr),
Packit 534379
        filter_dev_(nullptr),
Packit 534379
        handle_accel_(nullptr),
Packit 534379
        handle_dev_(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
    ASSERT_EQ(xfpga_plugin_initialize(), FPGA_OK);
Packit 534379
    ASSERT_EQ(xfpga_fpgaGetProperties(nullptr, &filter_accel_), FPGA_OK);
Packit 534379
    auto accel_dev_id = platform_.devices[0].device_id + platform_.devices[0].num_vfs;
Packit 534379
    ASSERT_EQ(fpgaPropertiesSetDeviceID(filter_accel_, accel_dev_id), 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(), tokens_accel_.size(),
Packit 534379
                            &num_matches_), FPGA_OK);
Packit 534379
    EXPECT_EQ(num_matches_, platform_.devices.size());
Packit 534379
    ASSERT_EQ(xfpga_fpgaOpen(tokens_accel_[0], &handle_accel_, 0), FPGA_OK);
Packit 534379
    ASSERT_EQ(fpgaClearProperties(filter_accel_), FPGA_OK);
Packit 534379
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(), tokens_dev_.size(),
Packit 534379
                            &num_matches_), FPGA_OK);
Packit 534379
    EXPECT_EQ(num_matches_, platform_.devices.size());
Packit 534379
    ASSERT_EQ(xfpga_fpgaOpen(tokens_dev_[0], &handle_dev_, 0), FPGA_OK);
Packit 534379
    ASSERT_EQ(fpgaClearProperties(filter_dev_), FPGA_OK);
Packit 534379
Packit 534379
    num_matches_ = 0xc01a;
Packit 534379
    invalid_device_ = test_device::unknown();
Packit 534379
    prop_ = nullptr;
Packit 534379
  }
Packit 534379
Packit 534379
  virtual void TearDown() override {
Packit 534379
    if (prop_) { EXPECT_EQ(fpgaDestroyProperties(&prop_), FPGA_OK); };
Packit 534379
Packit 534379
    if (filter_accel_) { EXPECT_EQ(fpgaDestroyProperties(&filter_accel_), FPGA_OK); }
Packit 534379
    if (filter_dev_) { EXPECT_EQ(fpgaDestroyProperties(&filter_dev_), FPGA_OK); }
Packit 534379
    if (handle_accel_) { EXPECT_EQ(xfpga_fpgaClose(handle_accel_), FPGA_OK); }
Packit 534379
    if (handle_dev_) { EXPECT_EQ(xfpga_fpgaClose(handle_dev_), FPGA_OK); }
Packit 534379
Packit 534379
    for (auto &t : tokens_accel_) {
Packit 534379
      if (t) {
Packit 534379
        EXPECT_EQ(xfpga_fpgaDestroyToken(&t), FPGA_OK);
Packit 534379
        t = nullptr;
Packit 534379
      }
Packit 534379
    }
Packit 534379
Packit 534379
    for (auto &t : tokens_dev_) {
Packit 534379
      if (t) {
Packit 534379
        EXPECT_EQ(xfpga_fpgaDestroyToken(&t), FPGA_OK);
Packit 534379
        t = nullptr;
Packit 534379
      }
Packit 534379
    }
Packit 534379
    xfpga_plugin_finalize();
Packit 534379
    system_->finalize();
Packit 534379
  }
Packit 534379
Packit 534379
  std::array<fpga_token, 2> tokens_accel_;
Packit 534379
  std::array<fpga_token, 2> tokens_dev_;
Packit 534379
  fpga_properties prop_;
Packit 534379
  fpga_properties filter_accel_;
Packit 534379
  fpga_properties filter_dev_;
Packit 534379
  fpga_handle handle_accel_;
Packit 534379
  fpga_handle handle_dev_;
Packit 534379
  uint32_t num_matches_;
Packit 534379
  test_platform platform_;
Packit 534379
  test_device invalid_device_;
Packit 534379
  test_system* system_;
Packit 534379
};
Packit 534379
Packit 534379
/**
Packit 534379
 * @test    from_handle
Packit 534379
 * @brief   Tests: xfpga_fpgaGetPropertiesFromHandle
Packit 534379
 * @details Given a null fpga_properties* object
Packit 534379
 *          When I call xfpga_fpgaGetPropertiesFromHandle with an valid handle,
Packit 534379
 *          expected result is FPGA_OK.
Packit 534379
 */
Packit 534379
TEST_P(properties_c_p, from_handle) {
Packit 534379
  EXPECT_EQ(xfpga_fpgaGetPropertiesFromHandle(handle_accel_, &prop_), FPGA_OK);
Packit 534379
}
Packit 534379
Packit 534379
/**
Packit 534379
 * @test       vendor_id_afu
Packit 534379
 *
Packit 534379
 * @brief      When querying the vendor ID of an AFU,
Packit 534379
 * 	       0x8086 is returned.
Packit 534379
 */
Packit 534379
TEST_P(properties_c_p, vendor_id_afu) {
Packit 534379
#ifndef BUILD_ASE
Packit 534379
  auto device = platform_.devices[0];
Packit 534379
  uint16_t x = 0;
Packit 534379
  ASSERT_EQ(xfpga_fpgaGetPropertiesFromHandle(handle_accel_, &prop_), FPGA_OK);
Packit 534379
  ASSERT_EQ(fpgaPropertiesGetVendorID(prop_, &x), FPGA_OK);
Packit 534379
  EXPECT_EQ(x, device.vendor_id);
Packit 534379
#endif
Packit 534379
}
Packit 534379
Packit 534379
/**
Packit 534379
 * @test       vendor_id_fme
Packit 534379
 *
Packit 534379
 * @brief      When querying the vendor ID of an FME,
Packit 534379
 * 	       0x8086 is returned.
Packit 534379
 */
Packit 534379
TEST_P(properties_c_p, vendor_id_fme) {
Packit 534379
#ifndef BUILD_ASE
Packit 534379
  auto device = platform_.devices[0];
Packit 534379
  uint16_t x = 0;
Packit 534379
  ASSERT_EQ(xfpga_fpgaGetPropertiesFromHandle(handle_dev_, &prop_), FPGA_OK);
Packit 534379
  ASSERT_EQ(fpgaPropertiesGetVendorID(prop_, &x), FPGA_OK);
Packit 534379
  EXPECT_EQ(x, device.vendor_id);
Packit 534379
#endif
Packit 534379
}
Packit 534379
Packit 534379
/**
Packit 534379
 * @test       device_id_afu
Packit 534379
 *
Packit 534379
 * @brief      When querying the device ID of an AFU,
Packit 534379
 * 	       0xbcc0 is returned.
Packit 534379
 */
Packit 534379
TEST_P(properties_c_p, device_id_afu) {
Packit 534379
#ifndef BUILD_ASE
Packit 534379
  auto device = platform_.devices[0];
Packit 534379
  uint16_t x = 0;
Packit 534379
  ASSERT_EQ(xfpga_fpgaGetPropertiesFromHandle(handle_accel_, &prop_), FPGA_OK);
Packit 534379
  ASSERT_EQ(fpgaPropertiesGetDeviceID(prop_, &x), FPGA_OK);
Packit 534379
  auto expected_id = device.device_id + (device.num_vfs > 0 ? 1 : 0);
Packit 534379
  EXPECT_EQ(static_cast<uint32_t>(x), expected_id);
Packit 534379
#endif
Packit 534379
}
Packit 534379
Packit 534379
/**
Packit 534379
 * @test       device_id_fme
Packit 534379
 *
Packit 534379
 * @brief      When querying the device ID of an FME,
Packit 534379
 * 	       0xbcc0 is returned.
Packit 534379
 */
Packit 534379
TEST_P(properties_c_p, device_id_fme) {
Packit 534379
#ifndef BUILD_ASE
Packit 534379
  auto device = platform_.devices[0];
Packit 534379
  uint16_t x = 0;
Packit 534379
  ASSERT_EQ(xfpga_fpgaGetPropertiesFromHandle(handle_dev_, &prop_), FPGA_OK);
Packit 534379
  ASSERT_EQ(fpgaPropertiesGetDeviceID(prop_, &x), FPGA_OK);
Packit 534379
  EXPECT_EQ(static_cast<uint32_t>(x), device.device_id);
Packit 534379
#endif
Packit 534379
}
Packit 534379
Packit 534379
/**
Packit 534379
 * @test       valid_gets
Packit 534379
 *
Packit 534379
 * @brief      When fpgaGetPropertiesFromHandle is called
Packit 534379
 *             with a valid handle.
Packit 534379
 *             The function returns FPGA_OK with the
Packit 534379
 *             returned valid properties for that handle.
Packit 534379
 */
Packit 534379
TEST_P(properties_c_p, valid_gets) {
Packit 534379
  fpga_objtype objtype = FPGA_DEVICE;
Packit 534379
Packit 534379
  ASSERT_EQ(xfpga_fpgaGetPropertiesFromHandle(handle_accel_, &prop_), FPGA_OK);
Packit 534379
  ASSERT_EQ(fpgaPropertiesGetObjectType(prop_, &objtype), FPGA_OK);
Packit 534379
  EXPECT_EQ(objtype, FPGA_ACCELERATOR);
Packit 534379
  EXPECT_EQ(fpgaDestroyProperties(&prop_), FPGA_OK);
Packit 534379
Packit 534379
  prop_ = NULL;
Packit 534379
  objtype = FPGA_ACCELERATOR;
Packit 534379
Packit 534379
  ASSERT_EQ(xfpga_fpgaGetPropertiesFromHandle(handle_dev_, &prop_), FPGA_OK);
Packit 534379
  ASSERT_EQ(fpgaPropertiesGetObjectType(prop_, &objtype), FPGA_OK);
Packit 534379
  EXPECT_EQ(objtype, FPGA_DEVICE);
Packit 534379
}
Packit 534379
Packit 534379
INSTANTIATE_TEST_CASE_P(properties_c, properties_c_p,
Packit 534379
                        ::testing::ValuesIn(test_platform::keys(true)));
Packit 534379
Packit 534379
/**
Packit 534379
 * @test    fpga_get_properties
Packit 534379
 * @brief   Tests: xfpga_fpgaGetProperties
Packit 534379
 * @details Given a null fpga_properties* object
Packit 534379
 *          When I call xfpga_fpgaGetProperties with an invalid token,
Packit 534379
 *          expected result is FPGA_INVALID_PARAM.
Packit 534379
 */
Packit 534379
TEST(properties_c, fpga_get_properties) {
Packit 534379
  char buf[sizeof(_fpga_token)];
Packit 534379
  fpga_token token = buf;
Packit 534379
  ((_fpga_token*)token)->magic = 0xbeef;
Packit 534379
  fpga_properties prop;
Packit 534379
  EXPECT_EQ(xfpga_fpgaGetProperties(token, &prop), FPGA_INVALID_PARAM);
Packit 534379
}
Packit 534379
Packit 534379
/**
Packit 534379
 * @test    invalid_handle
Packit 534379
 * @brief   Tests: xfpga_fpgaGetPropertiesFromHandle
Packit 534379
 * @details Given a null fpga_properties* object
Packit 534379
 *          When I call xfpga_fpgaGetPropertiesFromHandle with an null handle,
Packit 534379
 *          expected result is FPGA_INVALID_PARAM.
Packit 534379
 */
Packit 534379
TEST(properties_c, invalid_handle) {
Packit 534379
  fpga_properties prop = NULL;
Packit 534379
  EXPECT_EQ(xfpga_fpgaGetPropertiesFromHandle(nullptr, &prop), FPGA_INVALID_PARAM);
Packit 534379
}