Blame opae-libs/tests/opae-c/test_umsg_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
extern "C" {
Packit 534379
Packit 534379
#include <json-c/json.h>
Packit 534379
#include <uuid/uuid.h>
Packit 534379
#include "opae_int.h"
Packit 534379
Packit 534379
}
Packit 534379
Packit 534379
#include <opae/fpga.h>
Packit 534379
#include "intel-fpga.h"
Packit 534379
#include <linux/ioctl.h>
Packit 534379
Packit 534379
#include <array>
Packit 534379
#include <cstdlib>
Packit 534379
#include <cstdarg>
Packit 534379
#include <map>
Packit 534379
#include <memory>
Packit 534379
#include <string>
Packit 534379
#include <vector>
Packit 534379
#include "gtest/gtest.h"
Packit 534379
#include "mock/test_system.h"
Packit 534379
Packit 534379
using namespace opae::testing;
Packit 534379
Packit 534379
int umsg_port_info(mock_object * m, int request, va_list argp){
Packit 534379
    int retval = -1;
Packit 534379
    errno = EINVAL;
Packit 534379
    static bool gEnableIRQ = false;
Packit 534379
    UNUSED_PARAM(m);
Packit 534379
    UNUSED_PARAM(request);
Packit 534379
    struct fpga_port_info *pinfo = va_arg(argp, struct fpga_port_info *);
Packit 534379
    if (!pinfo) {
Packit 534379
        FPGA_MSG("pinfo is NULL");
Packit 534379
        goto out_EINVAL;
Packit 534379
    }
Packit 534379
    if (pinfo->argsz != sizeof(*pinfo)) {
Packit 534379
        FPGA_MSG("wrong structure size");
Packit 534379
        goto out_EINVAL;
Packit 534379
    }
Packit 534379
    pinfo->flags = 0;
Packit 534379
    pinfo->num_regions = 1;
Packit 534379
    pinfo->num_umsgs = 8;
Packit 534379
    if (gEnableIRQ) {
Packit 534379
        pinfo->capability = FPGA_PORT_CAP_ERR_IRQ | FPGA_PORT_CAP_UAFU_IRQ;
Packit 534379
        pinfo->num_uafu_irqs = 1;
Packit 534379
    } else {
Packit 534379
        pinfo->capability = 0;
Packit 534379
        pinfo->num_uafu_irqs = 0;
Packit 534379
    }
Packit 534379
    retval = 0;
Packit 534379
    errno = 0;
Packit 534379
out:
Packit 534379
    return retval;
Packit 534379
Packit 534379
out_EINVAL:
Packit 534379
    retval = -1;
Packit 534379
    errno = EINVAL;
Packit 534379
    goto out;
Packit 534379
}
Packit 534379
Packit 534379
int umsg_set_mode(mock_object * m, int request, va_list argp){
Packit 534379
    int retval = -1;
Packit 534379
    errno = EINVAL;
Packit 534379
    UNUSED_PARAM(m);
Packit 534379
    UNUSED_PARAM(request);
Packit 534379
    struct fpga_port_umsg_cfg *ucfg = va_arg(argp, struct fpga_port_umsg_cfg *);
Packit 534379
    if (!ucfg) {
Packit 534379
    	FPGA_MSG("ucfg is NULL");
Packit 534379
    	goto out_EINVAL;
Packit 534379
    }
Packit 534379
    if (ucfg->argsz != sizeof(*ucfg)) {
Packit 534379
    	FPGA_MSG("wrong structure size");
Packit 534379
    	goto out_EINVAL;
Packit 534379
    }
Packit 534379
    if (ucfg->flags != 0) {
Packit 534379
    	FPGA_MSG("unexpected flags %u", ucfg->flags);
Packit 534379
    	goto out_EINVAL;
Packit 534379
    }
Packit 534379
    /* TODO: check hint_bitmap */
Packit 534379
    if (ucfg->hint_bitmap >> 8) {
Packit 534379
    	FPGA_MSG("invalid hint_bitmap 0x%x", ucfg->hint_bitmap);
Packit 534379
    	goto out_EINVAL;
Packit 534379
    }
Packit 534379
    retval = 0;
Packit 534379
    errno = 0;
Packit 534379
out:
Packit 534379
    return retval;
Packit 534379
Packit 534379
out_EINVAL:
Packit 534379
    retval = -1;
Packit 534379
    errno = EINVAL;
Packit 534379
    goto out;
Packit 534379
}
Packit 534379
Packit 534379
class umsg_c_p : public ::testing::TestWithParam<std::string> {
Packit 534379
 protected:
Packit 534379
  umsg_c_p() : tokens_{{nullptr, 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
    filter_ = nullptr;
Packit 534379
    ASSERT_EQ(fpgaInitialize(NULL), FPGA_OK);
Packit 534379
    ASSERT_EQ(fpgaGetProperties(nullptr, &filter_), FPGA_OK);
Packit 534379
    ASSERT_EQ(fpgaPropertiesSetDeviceID(filter_, platform_.devices[0].device_id), FPGA_OK);
Packit 534379
    ASSERT_EQ(fpgaPropertiesSetObjectType(filter_, FPGA_ACCELERATOR), FPGA_OK);
Packit 534379
    num_matches_ = 0;
Packit 534379
    ASSERT_EQ(fpgaEnumerate(&filter_, 1, tokens_.data(), tokens_.size(),
Packit 534379
                            &num_matches_), FPGA_OK);
Packit 534379
    EXPECT_GT(num_matches_, 0);
Packit 534379
    dev_ = nullptr;
Packit 534379
    ASSERT_EQ(fpgaOpen(tokens_[0], &dev_, 0), FPGA_OK);
Packit 534379
    system_->register_ioctl_handler(FPGA_PORT_GET_INFO, umsg_port_info);
Packit 534379
    system_->register_ioctl_handler(FPGA_PORT_UMSG_SET_MODE, umsg_set_mode);
Packit 534379
  }
Packit 534379
Packit 534379
  virtual void TearDown() override {
Packit 534379
    EXPECT_EQ(fpgaDestroyProperties(&filter_), FPGA_OK);
Packit 534379
    if (dev_) {
Packit 534379
        EXPECT_EQ(fpgaClose(dev_), FPGA_OK);
Packit 534379
        dev_ = nullptr;
Packit 534379
    }
Packit 534379
    for (auto &t : tokens_) {
Packit 534379
      if (t) {
Packit 534379
        EXPECT_EQ(fpgaDestroyToken(&t), FPGA_OK);
Packit 534379
        t = nullptr;
Packit 534379
      }
Packit 534379
    }
Packit 534379
    fpgaFinalize();
Packit 534379
    system_->finalize();
Packit 534379
  }
Packit 534379
Packit 534379
  std::array<fpga_token, 2> tokens_;
Packit 534379
  fpga_properties filter_;
Packit 534379
  fpga_handle dev_;
Packit 534379
  test_platform platform_;
Packit 534379
  uint32_t num_matches_;
Packit 534379
  test_system *system_;
Packit 534379
};
Packit 534379
Packit 534379
/**
Packit 534379
 * @test       get_num
Packit 534379
 * @brief      Test: fpgaGetNumUmsg
Packit 534379
 * @details    When fpgaGetNumUmsg retrieves the number of UMsgs,
Packit 534379
 *             the number of Umsgs is greater than 0,
Packit 534379
 *             and the fn returns FPGA_OK.
Packit 534379
 */
Packit 534379
TEST_P(umsg_c_p, get_num) {
Packit 534379
  uint64_t num = 0;
Packit 534379
  EXPECT_EQ(fpgaGetNumUmsg(dev_, &num), FPGA_OK);
Packit 534379
  EXPECT_GT(num, 0);
Packit 534379
}
Packit 534379
Packit 534379
/**
Packit 534379
 * @test       set_attr
Packit 534379
 * @brief      Test: fpgaSetUmsgAttributes
Packit 534379
 * @details    When fpgaSetUmsgAttributes is called with valid values,
Packit 534379
 *             then the fn returns FPGA_OK.
Packit 534379
 */
Packit 534379
TEST_P(umsg_c_p, set_attr) {
Packit 534379
  uint64_t enable  = 0xff;
Packit 534379
  uint64_t disable = 0;
Packit 534379
  EXPECT_EQ(fpgaSetUmsgAttributes(dev_, enable), FPGA_OK);
Packit 534379
  EXPECT_EQ(fpgaSetUmsgAttributes(dev_, disable), FPGA_OK);
Packit 534379
}
Packit 534379
Packit 534379
INSTANTIATE_TEST_CASE_P(umsg_c, umsg_c_p, 
Packit 534379
                        ::testing::ValuesIn(test_platform::platforms({ "skx-p"})));
Packit 534379
Packit 534379
class umsg_c_mock_p: public umsg_c_p{
Packit 534379
  protected:
Packit 534379
    umsg_c_mock_p() {};
Packit 534379
};
Packit 534379
/**
Packit 534379
 * @test       trigger
Packit 534379
 * @brief      Test: fpgaTriggerUmsg
Packit 534379
 * @details    When Umsgs are enabled and
Packit 534379
 *             fpgaTriggerUmsg is called with a valid value,
Packit 534379
 *             then the fn returns FPGA_OK.
Packit 534379
 */
Packit 534379
TEST_P(umsg_c_mock_p, trigger) {
Packit 534379
  uint64_t enable  = 0xff;
Packit 534379
  uint64_t disable = 0;
Packit 534379
  EXPECT_EQ(fpgaSetUmsgAttributes(dev_, enable), FPGA_OK);
Packit 534379
  EXPECT_EQ(fpgaTriggerUmsg(dev_, 1), FPGA_OK);
Packit 534379
  EXPECT_EQ(fpgaSetUmsgAttributes(dev_, disable), FPGA_OK);
Packit 534379
}
Packit 534379
Packit 534379
/**
Packit 534379
 * @test       get_ptr
Packit 534379
 * @brief      Test: fpgaGetUmsgPtr
Packit 534379
 * @details    When Umsgs are enabled and
Packit 534379
 *             fpgaGetUmsgPtr is called with a valid value,
Packit 534379
 *             then the fn returns FPGA_OK.
Packit 534379
 */
Packit 534379
TEST_P(umsg_c_mock_p, get_ptr) {
Packit 534379
  uint64_t enable  = 0xff;
Packit 534379
  uint64_t disable = 0;
Packit 534379
  uint64_t *umsg_ptr = nullptr;
Packit 534379
  EXPECT_EQ(fpgaSetUmsgAttributes(dev_, enable), FPGA_OK);
Packit 534379
  EXPECT_EQ(fpgaGetUmsgPtr(dev_, &umsg_ptr), FPGA_OK);
Packit 534379
  EXPECT_NE(umsg_ptr, nullptr);
Packit 534379
  EXPECT_EQ(fpgaSetUmsgAttributes(dev_, disable), FPGA_OK);
Packit 534379
}
Packit 534379
Packit 534379
INSTANTIATE_TEST_CASE_P(umsg_c, umsg_c_mock_p, 
Packit 534379
                        ::testing::ValuesIn(test_platform::mock_platforms({ "skx-p"})));
Packit 534379