hardware.hpp

/*
 * See LICENSE for more information about licensing
 *
 * Copyright 2023
 * Author: Luis G. Leon-Vega <luis.leon@ieee.org>
 *         Diego Arturo Avila Torres <diego.avila@uned.cr>
 *
 */
#pragma once
 
#pragma GCC diagnostic push
#pragma GCC diagnostic ignored "-Wpedantic"
#include <xrt.h>
#include <xrt/xrt_device.h>
#pragma GCC diagnostic pop
 
#include <cstdint>
#include <cynq/dma/datamover.hpp>
#include <cynq/enums.hpp>
#include <cynq/hardware.hpp>
#include <cynq/mmio/accelerator.hpp>
#include <cynq/status.hpp>
#include <memory>
#include <string>
#include <vector>
 
namespace cynq {
struct UltraScaleClocks {
  inline static constexpr int max_clocks = 4;
  std::array<bool, max_clocks> pl_active = {false};
  std::array<bool, max_clocks> pl_valid = {false};
  std::array<float, max_clocks> src_freq = {0.f};
  std::array<uint32_t, max_clocks> pl_reg;
  std::array<uint32_t, max_clocks> src_reg;
  std::array<float, 4> target_clocks_mhz = {-1.f};
  std::array<float, 4> current_clocks_mhz = {-1.f};
};
 
struct UltraScaleParameters : public HardwareParameters {
  xrt::device device_;
  xrt::xclbin xclbin_;
  UltraScaleClocks clocks_;
  virtual ~UltraScaleParameters() = default;
};
 
class UltraScale : public IHardware {
 public:
  UltraScale(const std::string &bitstream_file, const std::string &xclbin_file);
  UltraScale() = delete;
  virtual ~UltraScale();
  Status Reset() override;
  std::shared_ptr<IDataMover> GetDataMover(const uint64_t address) override;
  std::shared_ptr<IAccelerator> GetAccelerator(
      const std::string &kernelname) override;
 
  std::shared_ptr<IAccelerator> GetAccelerator(const uint64_t address) override;
  Status DeviceQuery();
  Status KernelQuery();
 
  std::vector<float> GetClocks() noexcept override;
  Status SetClocks(const std::vector<float> &clocks) override;
 
 private:
  std::shared_ptr<HardwareParameters> parameters_;
  Status LoadBitstream(const std::string &bitstream_file);
  Status ConfigureBuses();
  Status GetClocksInformation(const uint number_pl_clocks = 1);
  Status ConfigureClocks();
  Status LoadXclBin(const std::string &xclbin_file, const int device_idx = 0);
};
}  // namespace cynq