Blame tests/board/test_board_rc.cpp

Packit 534379
// Copyright(c) 2019-2020, 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
#include <fcntl.h>
Packit 534379
#include <json-c/json.h>
Packit 534379
#include <stdlib.h>
Packit 534379
#include <sys/stat.h>
Packit 534379
#include <sys/types.h>
Packit 534379
#include <uuid/uuid.h>
Packit 534379
}
Packit 534379
Packit 534379
#include <linux/ioctl.h>
Packit 534379
#include <opae/fpga.h>
Packit 534379
#include <array>
Packit 534379
#include <cstdarg>
Packit 534379
#include <cstdlib>
Packit 534379
#include <map>
Packit 534379
#include <memory>
Packit 534379
#include <string>
Packit 534379
#include <vector>
Packit 534379
Packit 534379
#include "gtest/gtest.h"
Packit 534379
#include "intel-fpga.h"
Packit 534379
#include "libboard/board_rc/board_rc.h"
Packit 534379
#include "opae_int.h"
Packit 534379
#include "mock/test_system.h"
Packit 534379
Packit 534379
#define SYSFS_FME_PATH "/sys/class/fpga/intel-fpga-dev.0/intel-fpga-fme.0"
Packit 534379
Packit 534379
#define FPGA_STR_SIZE 256
Packit 534379
#define SDR_HEADER_LEN 3
Packit 534379
#define SDR_MSG_LEN 4
Packit 534379
Packit 534379
typedef struct _bmc_powerdown_cause {
Packit 534379
  uint8_t _header[SDR_HEADER_LEN];
Packit 534379
  uint8_t completion_code;
Packit 534379
  uint8_t iana[SDR_HEADER_LEN];
Packit 534379
  uint8_t count;
Packit 534379
  uint8_t message[SDR_MSG_LEN];
Packit 534379
} bmc_powerdown_cause;
Packit 534379
Packit 534379
typedef struct _bmc_reset_cause {
Packit 534379
  uint8_t _header[SDR_HEADER_LEN];
Packit 534379
  uint8_t completion_code;
Packit 534379
  uint8_t iana[SDR_HEADER_LEN];
Packit 534379
  uint8_t reset_cause;
Packit 534379
} bmc_reset_cause;
Packit 534379
Packit 534379
typedef enum {
Packit 534379
  CHIP_RESET_CAUSE_POR = 0x01,
Packit 534379
  CHIP_RESET_CAUSE_EXTRST = 0x02,
Packit 534379
  CHIP_RESET_CAUSE_BOD_IO = 0x04,
Packit 534379
  CHIP_RESET_CAUSE_WDT = 0x08,
Packit 534379
  CHIP_RESET_CAUSE_OCD = 0x10,
Packit 534379
  CHIP_RESET_CAUSE_SOFT = 0x20,
Packit 534379
  CHIP_RESET_CAUSE_SPIKE = 0x40,
Packit 534379
} bmc_ResetCauses;
Packit 534379
Packit 534379
typedef struct _bmc_device_id {
Packit 534379
  uint8_t _header[SDR_HEADER_LEN];
Packit 534379
  uint8_t completion_code;
Packit 534379
  uint8_t device_id;
Packit 534379
  union {
Packit 534379
    struct {
Packit 534379
      uint8_t device_revision : 3;
Packit 534379
      uint8_t _unused : 3;
Packit 534379
      uint8_t provides_sdrs : 2;
Packit 534379
    } bits;
Packit 534379
    uint8_t _value;
Packit 534379
  } device_revision;
Packit 534379
  union {
Packit 534379
    struct {
Packit 534379
      uint8_t device_available : 7;
Packit 534379
      uint8_t major_fw_revision : 1;
Packit 534379
    } bits;
Packit 534379
    uint8_t _value;
Packit 534379
  } firmware_revision_1;
Packit 534379
  uint8_t firmware_revision_2;
Packit 534379
  uint8_t ipmi_version;
Packit 534379
  union {
Packit 534379
    struct {
Packit 534379
      uint8_t sensor_device : 1;
Packit 534379
      uint8_t sdr_repository_device : 1;
Packit 534379
      uint8_t sel_device : 1;
Packit 534379
      uint8_t fru_inventory_device : 1;
Packit 534379
      uint8_t ipmb_event_receiver : 1;
Packit 534379
      uint8_t ipmb_event_generator : 1;
Packit 534379
      uint8_t bridge : 1;
Packit 534379
      uint8_t chassis_device : 1;
Packit 534379
    } bits;
Packit 534379
    uint8_t _value;
Packit 534379
  } additional_device_support;
Packit 534379
  uint8_t manufacturer_id_0_7;
Packit 534379
  uint8_t manufacturer_id_8_15;
Packit 534379
  uint8_t manufacturer_id_16_23;
Packit 534379
  uint8_t product_id_0_7;
Packit 534379
  uint8_t product_id_8_15;
Packit 534379
  uint8_t aux_fw_rev_0_7;
Packit 534379
  uint8_t aux_fw_rev_8_15;
Packit 534379
  uint8_t aux_fw_rev_16_23;
Packit 534379
  uint8_t aux_fw_rev_24_31;
Packit 534379
} bmc_device_id;
Packit 534379
Packit 534379
using namespace opae::testing;
Packit 534379
Packit 534379
class board_rc_c_p : public ::testing::TestWithParam<std::string> {
Packit 534379
 protected:
Packit 534379
  board_rc_c_p() : tokens_{{nullptr, nullptr}} {}
Packit 534379
Packit 534379
  fpga_result write_sysfs_file(const char *file, void *buf, size_t count);
Packit 534379
  ssize_t eintr_write(int fd, void *buf, size_t count);
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(fpgaPropertiesSetObjectType(filter_, FPGA_DEVICE), FPGA_OK);
Packit 534379
    num_matches_ = 0;
Packit 534379
    ASSERT_EQ(fpgaEnumerate(&filter_, 1, tokens_.data(), tokens_.size(),
Packit 534379
                            &num_matches_),
Packit 534379
              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
  }
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
ssize_t board_rc_c_p::eintr_write(int fd, void *buf, size_t count) {
Packit 534379
  ssize_t bytes_written = 0, total_written = 0;
Packit 534379
  char *ptr = (char *)buf;
Packit 534379
Packit 534379
  if (!buf) {
Packit 534379
    return -1;
Packit 534379
  }
Packit 534379
Packit 534379
  while (total_written < (ssize_t)count) {
Packit 534379
    bytes_written = write(fd, ptr + total_written, count - total_written);
Packit 534379
    if (bytes_written < 0) {
Packit 534379
      if (errno == EINTR) {
Packit 534379
        continue;
Packit 534379
      }
Packit 534379
      return bytes_written;
Packit 534379
    }
Packit 534379
    total_written += bytes_written;
Packit 534379
  }
Packit 534379
  return total_written;
Packit 534379
}
Packit 534379
fpga_result board_rc_c_p::write_sysfs_file(const char *file, void *buf,
Packit 534379
                                           size_t count) {
Packit 534379
  fpga_result res = FPGA_OK;
Packit 534379
  char sysfspath[256];
Packit 534379
  int fd = 0;
Packit 534379
Packit 534379
  snprintf(sysfspath, sizeof(sysfspath), "%s/%s", SYSFS_FME_PATH, file);
Packit 534379
  glob_t pglob;
Packit 534379
  int gres = glob(sysfspath, GLOB_NOSORT, NULL, &pglob);
Packit 534379
  if ((gres) || (1 != pglob.gl_pathc)) {
Packit 534379
    globfree(&pglob);
Packit 534379
    return FPGA_NOT_FOUND;
Packit 534379
  }
Packit 534379
  fd = open(pglob.gl_pathv[0], O_WRONLY);
Packit 534379
  globfree(&pglob);
Packit 534379
  if (fd < 0) {
Packit 534379
    printf("open failed \n");
Packit 534379
    return FPGA_NOT_FOUND;
Packit 534379
  }
Packit 534379
Packit 534379
  ssize_t total_written = eintr_write(fd, buf, count);
Packit 534379
  if (total_written == 0) {
Packit 534379
    close(fd);
Packit 534379
    printf("total_written failed \n");
Packit 534379
    return FPGA_INVALID_PARAM;
Packit 534379
  }
Packit 534379
Packit 534379
  close(fd);
Packit 534379
  return res;
Packit 534379
}
Packit 534379
Packit 534379
/**
Packit 534379
 * @test       board_rc_1
Packit 534379
 * @brief      Tests: read_bmc_version
Packit 534379
 * @details    Validates bmc version  
Packit 534379
 */
Packit 534379
TEST_P(board_rc_c_p, board_rc_1) {
Packit 534379
  int version;
Packit 534379
Packit 534379
  EXPECT_EQ(read_bmc_version(tokens_[0], &version), FPGA_OK);
Packit 534379
Packit 534379
  EXPECT_EQ(read_bmc_version(tokens_[0], NULL), FPGA_INVALID_PARAM);
Packit 534379
Packit 534379
  EXPECT_NE(read_bmc_version(NULL, &version), FPGA_OK);
Packit 534379
}
Packit 534379
Packit 534379
/**
Packit 534379
 * @test       board_rc_2
Packit 534379
 * @brief      Tests: read_bmc_pwr_down_cause
Packit 534379
 * @details    Validates bmc power down root cause 
Packit 534379
 */
Packit 534379
TEST_P(board_rc_c_p, board_rc_2) {
Packit 534379
  char pwr_down_cause[FPGA_STR_SIZE];
Packit 534379
Packit 534379
  EXPECT_EQ(read_bmc_pwr_down_cause(tokens_[0], pwr_down_cause), FPGA_OK);
Packit 534379
Packit 534379
  EXPECT_EQ(read_bmc_pwr_down_cause(tokens_[0], NULL), FPGA_INVALID_PARAM);
Packit 534379
Packit 534379
  EXPECT_NE(read_bmc_pwr_down_cause(NULL, pwr_down_cause), FPGA_OK);
Packit 534379
}
Packit 534379
Packit 534379
/**
Packit 534379
 * @test       board_rc_3
Packit 534379
 * @brief      Tests: read_bmc_pwr_down_cause
Packit 534379
 * @details    Validates bmc reset root cause 
Packit 534379
 */
Packit 534379
TEST_P(board_rc_c_p, board_rc_3) {
Packit 534379
  char reset_cause[FPGA_STR_SIZE];
Packit 534379
Packit 534379
  EXPECT_EQ(read_bmc_reset_cause(tokens_[0], reset_cause), FPGA_OK);
Packit 534379
Packit 534379
  EXPECT_EQ(read_bmc_reset_cause(tokens_[0], NULL), FPGA_INVALID_PARAM);
Packit 534379
Packit 534379
  EXPECT_NE(read_bmc_reset_cause(NULL, reset_cause), FPGA_OK);
Packit 534379
}
Packit 534379
Packit 534379
/**
Packit 534379
 * @test       board_rc_4
Packit 534379
 * @brief      Tests: print_board_info
Packit 534379
 * @details    Validates print board information 
Packit 534379
 */
Packit 534379
TEST_P(board_rc_c_p, board_rc_4) {
Packit 534379
  EXPECT_EQ(print_board_info(tokens_[0]), FPGA_OK);
Packit 534379
  EXPECT_NE(print_board_info(NULL), FPGA_OK);
Packit 534379
}
Packit 534379
Packit 534379
/**
Packit 534379
 * @test       board_rc_5
Packit 534379
 * @brief      Tests: read_bmc_reset_cause
Packit 534379
 * @details    Validates bmc reset root cause with invalid completion code 
Packit 534379
 */
Packit 534379
TEST_P(board_rc_c_p, board_rc_5) {
Packit 534379
  bmc_reset_cause bmc_rc;
Packit 534379
  bmc_rc.completion_code = 1;
Packit 534379
  write_sysfs_file((const char *)"avmmi-bmc.3.auto/bmc_info/reset_cause",
Packit 534379
                   (void *)&bmc_rc, sizeof(bmc_reset_cause));
Packit 534379
  char reset_cause[FPGA_STR_SIZE];
Packit 534379
Packit 534379
  EXPECT_NE(read_bmc_reset_cause(tokens_[0], reset_cause), FPGA_OK);
Packit 534379
}
Packit 534379
Packit 534379
/**
Packit 534379
 * @test       board_rc_6
Packit 534379
 * @brief      Tests: read_bmc_reset_cause
Packit 534379
 * @details    Validates bmc reset root cause with different root cause
Packit 534379
 */
Packit 534379
TEST_P(board_rc_c_p, board_rc_6) {
Packit 534379
  bmc_reset_cause bmc_rc;
Packit 534379
  bmc_rc.completion_code = 0;
Packit 534379
  bmc_rc.reset_cause = CHIP_RESET_CAUSE_POR;
Packit 534379
  write_sysfs_file((const char *)"avmmi-bmc.3.auto/bmc_info/reset_cause",
Packit 534379
                   (void *)&bmc_rc, sizeof(bmc_reset_cause));
Packit 534379
Packit 534379
  char reset_cause[FPGA_STR_SIZE];
Packit 534379
  EXPECT_EQ(read_bmc_reset_cause(tokens_[0], reset_cause), FPGA_OK);
Packit 534379
Packit 534379
  bmc_rc.reset_cause = CHIP_RESET_CAUSE_EXTRST;
Packit 534379
  write_sysfs_file((const char *)"avmmi-bmc.3.auto/bmc_info/reset_cause",
Packit 534379
                   (void *)&bmc_rc, sizeof(bmc_reset_cause));
Packit 534379
  EXPECT_EQ(read_bmc_reset_cause(tokens_[0], reset_cause), FPGA_OK);
Packit 534379
Packit 534379
  bmc_rc.reset_cause = CHIP_RESET_CAUSE_BOD_IO;
Packit 534379
  write_sysfs_file((const char *)"avmmi-bmc.3.auto/bmc_info/reset_cause",
Packit 534379
                   (void *)&bmc_rc, sizeof(bmc_reset_cause));
Packit 534379
  EXPECT_EQ(read_bmc_reset_cause(tokens_[0], reset_cause), FPGA_OK);
Packit 534379
Packit 534379
  bmc_rc.reset_cause = CHIP_RESET_CAUSE_WDT;
Packit 534379
  write_sysfs_file((const char *)"avmmi-bmc.3.auto/bmc_info/reset_cause",
Packit 534379
                   (void *)&bmc_rc, sizeof(bmc_reset_cause));
Packit 534379
  EXPECT_EQ(read_bmc_reset_cause(tokens_[0], reset_cause), FPGA_OK);
Packit 534379
Packit 534379
  bmc_rc.reset_cause = CHIP_RESET_CAUSE_OCD;
Packit 534379
  write_sysfs_file((const char *)"avmmi-bmc.3.auto/bmc_info/reset_cause",
Packit 534379
                   (void *)&bmc_rc, sizeof(bmc_reset_cause));
Packit 534379
  EXPECT_EQ(read_bmc_reset_cause(tokens_[0], reset_cause), FPGA_OK);
Packit 534379
Packit 534379
  bmc_rc.reset_cause = CHIP_RESET_CAUSE_SOFT;
Packit 534379
  write_sysfs_file((const char *)"avmmi-bmc.3.auto/bmc_info/reset_cause",
Packit 534379
                   (void *)&bmc_rc, sizeof(bmc_reset_cause));
Packit 534379
  EXPECT_EQ(read_bmc_reset_cause(tokens_[0], reset_cause), FPGA_OK);
Packit 534379
Packit 534379
  bmc_rc.reset_cause = CHIP_RESET_CAUSE_SPIKE;
Packit 534379
  write_sysfs_file((const char *)"avmmi-bmc.3.auto/bmc_info/reset_cause",
Packit 534379
                   (void *)&bmc_rc, sizeof(bmc_reset_cause));
Packit 534379
  EXPECT_EQ(read_bmc_reset_cause(tokens_[0], reset_cause), FPGA_OK);
Packit 534379
}
Packit 534379
Packit 534379
/**
Packit 534379
 * @test       board_rc_7
Packit 534379
 * @brief      Tests: read_bmc_pwr_down_cause
Packit 534379
 * @details    Validates bmc power down root cause with invalid completion code
Packit 534379
 * 
Packit 534379
 */
Packit 534379
TEST_P(board_rc_c_p, board_rc_7) {
Packit 534379
  bmc_powerdown_cause bmc_pd;
Packit 534379
  bmc_pd.completion_code = 1;
Packit 534379
  write_sysfs_file((const char *)"avmmi-bmc.3.auto/bmc_info/power_down_cause",
Packit 534379
                   (void *)&bmc_pd, sizeof(bmc_powerdown_cause));
Packit 534379
Packit 534379
  char pwr_down_cause[FPGA_STR_SIZE];
Packit 534379
  EXPECT_NE(read_bmc_pwr_down_cause(tokens_[0], pwr_down_cause), FPGA_OK);
Packit 534379
}
Packit 534379
INSTANTIATE_TEST_CASE_P(
Packit 534379
    baord_rc_c, board_rc_c_p,
Packit 534379
    ::testing::ValuesIn(test_platform::mock_platforms({"dcp-rc"})));
Packit 534379
Packit 534379
class board_rc_invalid_c_p : public board_rc_c_p {};
Packit 534379
Packit 534379
/**
Packit 534379
 * @test       board_rc_8
Packit 534379
 * @brief      Tests: read_bmc_version
Packit 534379
 * @details    Validates bmc power down root cause with invalid completion code
Packit 534379
 * 
Packit 534379
 */
Packit 534379
TEST_P(board_rc_invalid_c_p, board_rc_8) {
Packit 534379
  int version;
Packit 534379
  EXPECT_NE(read_bmc_version(tokens_[0], &version), FPGA_OK);
Packit 534379
}
Packit 534379
Packit 534379
/**
Packit 534379
 * @test       board_rc_9
Packit 534379
 * @brief      Tests: read_bmc_pwr_down_cause
Packit 534379
 * @details    Validates bmc power down root cause with invalid completion code
Packit 534379
 * 
Packit 534379
 */
Packit 534379
TEST_P(board_rc_invalid_c_p, board_rc_9) {
Packit 534379
  char pwr_down_cause[FPGA_STR_SIZE];
Packit 534379
  EXPECT_NE(read_bmc_pwr_down_cause(tokens_[0], pwr_down_cause), FPGA_OK);
Packit 534379
}
Packit 534379
Packit 534379
/**
Packit 534379
 * @test       board_rc_9
Packit 534379
 * @brief      Tests: read_bmc_reset_cause
Packit 534379
 * @details    Validates bmc power down root cause with invalid completion code
Packit 534379
 * 
Packit 534379
 */
Packit 534379
TEST_P(board_rc_invalid_c_p, board_rc_10) {
Packit 534379
  char reset_cause[FPGA_STR_SIZE];
Packit 534379
  EXPECT_NE(read_bmc_reset_cause(tokens_[0], reset_cause), FPGA_OK);
Packit 534379
}
Packit 534379
INSTANTIATE_TEST_CASE_P(
Packit 534379
    board_rc_invalid_c, board_rc_invalid_c_p,
Packit 534379
    ::testing::ValuesIn(test_platform::mock_platforms({"skx-p"})));