OpenFPGA/openfpga/src/fabric/build_top_module_utils.cpp

/********************************************************************
 * This file include most utilized functions for building the module
 * graph for FPGA fabric
 *******************************************************************/
/* Headers from vtrutil library */
#include "vtr_assert.h"

/* Headers from vpr library */
#include "openfpga_naming.h"
#include "vpr_utils.h"

/* Module builder headers */
#include "build_top_module_utils.h"

/* begin namespace openfpga */
namespace openfpga {

/********************************************************************
 * Generate the name for a grid block, by considering
 * 1. if it locates on the border with given device size
 * 2. its type
 *
 * This function is mainly used in the top-level module generation
 *******************************************************************/
std::string generate_grid_block_module_name_in_top_module(
  const std::string& prefix, const DeviceGrid& grids,
  const vtr::Point<size_t>& grid_coord) {
  /* Determine if the grid locates at the border */
  vtr::Point<size_t> device_size(grids.width(), grids.height());
  e_side border_side = find_grid_border_side(device_size, grid_coord);
  t_physical_tile_type_ptr phy_tile_type =
    grids.get_physical_type(grid_coord.x(), grid_coord.y());

  return generate_grid_block_module_name(
    prefix, std::string(phy_tile_type->name), is_io_type(phy_tile_type),
    border_side);
}

/********************************************************************
 * Find the cb_type of a GSB in the top-level module
 * depending on the side of SB
 * TOP/BOTTOM side: CHANY
 * RIGHT/LEFT side: CHANX
 *******************************************************************/
t_rr_type find_top_module_cb_type_by_sb_side(const e_side& sb_side) {
  VTR_ASSERT(NUM_SIDES != sb_side);

  if ((TOP == sb_side) || (BOTTOM == sb_side)) {
    return CHANY;
  }

  VTR_ASSERT((RIGHT == sb_side) || (LEFT == sb_side));
  return CHANX;
}

/********************************************************************
 * Find the GSB coordinate for a CB in the top-level module
 * depending on the side of a SB
 * TODO: use vtr::Point<size_t> to replace DeviceCoordinator
 *******************************************************************/
vtr::Point<size_t> find_top_module_gsb_coordinate_by_sb_side(
  const RRGSB& rr_gsb, const e_side& sb_side) {
  VTR_ASSERT(NUM_SIDES != sb_side);

  vtr::Point<size_t> gsb_coordinate;

  if ((TOP == sb_side) || (LEFT == sb_side)) {
    gsb_coordinate.set_x(rr_gsb.get_x());
    gsb_coordinate.set_y(rr_gsb.get_y());
    return gsb_coordinate;
  }

  VTR_ASSERT((RIGHT == sb_side) || (BOTTOM == sb_side));

  /* RIGHT side: x + 1 */
  if (RIGHT == sb_side) {
    gsb_coordinate.set_x(rr_gsb.get_x() + 1);
    gsb_coordinate.set_y(rr_gsb.get_y());
  }

  /* BOTTOM side: y - 1 */
  if (BOTTOM == sb_side) {
    gsb_coordinate.set_x(rr_gsb.get_x());
    gsb_coordinate.set_y(rr_gsb.get_y() - 1);
  }

  return gsb_coordinate;
}

} /* end namespace openfpga */