[VPR] Rename the overloaded get_physical_pin() function to get_post_placement_physical_pin()

Author: tangxifan

vpr/src/pack/post_routing_pb_pin_fixup.cpp

@@ -115,7 +115,7 @@ static void update_cluster_pin_with_post_routing_results(const DeviceContext& de
         /* Get the ptc num for the pin in rr_graph, we need to consider the sub tile offset here
          * sub tile offset is the location in a sub tile whose capacity is larger than zero
          */
-        int physical_pin = get_physical_pin(physical_tile, logical_block, sub_tile_z, pb_type_pin);
+        int physical_pin = get_post_placement_physical_pin(physical_tile, logical_block, sub_tile_z, pb_type_pin);
         VTR_ASSERT(physical_pin < physical_tile->num_pins);
 
         auto pin_class = physical_tile->pin_class[physical_pin];

vpr/src/util/vpr_utils.cpp

@@ -2337,10 +2337,10 @@ int get_logical_block_physical_sub_tile_index(t_physical_tile_type_ptr physical_
     return sub_tile_index;
 }
 
-int get_physical_pin(t_physical_tile_type_ptr physical_tile,
-                     t_logical_block_type_ptr logical_block,
-                     int sub_tile_capacity,
-                     int pin) {
+int get_post_placement_physical_pin(t_physical_tile_type_ptr physical_tile,
+                                    t_logical_block_type_ptr logical_block,
+                                    int sub_tile_capacity,
+                                    int pin) {
     int sub_tile_index = get_logical_block_physical_sub_tile_index(physical_tile, logical_block, sub_tile_capacity);
 
     if (sub_tile_index == OPEN) {

vpr/src/util/vpr_utils.h

@@ -202,6 +202,8 @@ int get_logical_block_physical_sub_tile_index(t_physical_tile_type_ptr physical_
 //Returns the physical pin index (within 'physical_tile') corresponding to the
 //logical index ('pin' of the first instance of 'logical_block' within the physcial tile.
 //
+//This function is called before/during placement, when a sub tile index was not yet assigned.
+//
 //Throws an exception if the corresponding physical pin can't be found.
 int get_physical_pin(t_physical_tile_type_ptr physical_tile,
                      t_logical_block_type_ptr logical_block,
@@ -217,11 +219,14 @@ int get_logical_block_physical_sub_tile_index(t_physical_tile_type_ptr physical_
 //logical index ('pin' of the first instance of 'logical_block' within the physcial tile.
 //This function considers if a given offset is in the range of sub tile capacity
 //
+//This function is called only after placement is finished, where all the logical
+//blocks are assigned to a specific location of a tile!!!
+//
 //Throws an exception if the corresponding physical pin can't be found.
-int get_physical_pin(t_physical_tile_type_ptr physical_tile,
-                     t_logical_block_type_ptr logical_block,
-                     int sub_tile_capacity,
-                     int pin);
+int get_post_placement_physical_pin(t_physical_tile_type_ptr physical_tile,
+                                    t_logical_block_type_ptr logical_block,
+                                    int sub_tile_capacity,
+                                    int pin);
 
 //Returns the physical pin index (within 'physical_tile') corresponding to the
 //logical index ('pin') of the 'logical_block' at sub-tile location 'sub_tile_index'.