|  | PandA-2024.02
    | 
Allocation memory class. More...
#include <memory_allocation.hpp>


| Public Member Functions | |
| memory_allocation (const ParameterConstRef _parameters, const HLS_managerRef HLSMgr, const DesignFlowManagerConstRef design_flow_manager, const HLSFlowStep_Type hls_flow_step_type, const HLSFlowStepSpecializationConstRef hls_flow_step_specialization=HLSFlowStepSpecializationConstRef()) | |
| Constructor.  More... | |
| ~memory_allocation () override | |
| Destructor.  More... | |
| void | allocate_parameters (unsigned int functionId, memoryRef Rmem=nullptr) | 
| Allocate parameters for given function.  More... | |
| bool | HasToBeExecuted () const override | 
| Check if this step has actually to be executed.  More... | |
| DesignFlowStep_Status | Exec () override | 
| Execute the step.  More... | |
|  Public Member Functions inherited from HLS_step | |
| HLS_step (const ParameterConstRef _parameters, const HLS_managerRef HLSMgr, const DesignFlowManagerConstRef design_flow_manager, const HLSFlowStep_Type hls_flow_step_type, const HLSFlowStepSpecializationConstRef hls_flow_step_specialization=HLSFlowStepSpecializationConstRef()) | |
| Constructor.  More... | |
| ~HLS_step () override | |
| Destructor.  More... | |
| std::string | GetSignature () const override | 
| Return a unified identifier of this design step.  More... | |
| std::string | GetName () const override | 
| Return the name of this design step.  More... | |
| virtual std::string | GetKindText () const | 
| Return the name of the type of this frontend flow step.  More... | |
| DesignFlowStepFactoryConstRef | CGetDesignFlowStepFactory () const final | 
| Return the factory to create this type of steps.  More... | |
| void | ComputeRelationships (DesignFlowStepSet &design_flow_step_set, const DesignFlowStep::RelationshipType relationship_type) override | 
| Compute the relationships of a step with other steps.  More... | |
|  Public Member Functions inherited from DesignFlowStep | |
| DesignFlowStep (const DesignFlowManagerConstRef design_flow_manager, const ParameterConstRef parameters) | |
| Constructor.  More... | |
| virtual | ~DesignFlowStep () | 
| Destructor.  More... | |
| virtual void | Initialize () | 
| Initialize the step (i.e., like a constructor, but executed just before exec.  More... | |
| DesignFlowStep_Status | GetStatus () const | 
| Return the status of this design step.  More... | |
| virtual void | WriteDot (std::ostream &out) const | 
| Write the label for a dot graph.  More... | |
| bool | IsComposed () const | 
| Returns if this step is composed.  More... | |
| int | CGetDebugLevel () const | 
| Return the debug level of the step.  More... | |
| virtual void | PrintInitialIR () const | 
| Dump the initial intermediate representation.  More... | |
| virtual void | PrintFinalIR () const | 
| Dump the final intermediate representation.  More... | |
| Protected Member Functions | |
| void | setup_memory_allocation () | 
| Prepares the data structures for the memory allocation.  More... | |
| void | finalize_memory_allocation () | 
| Performs a final analysis of the memory allocation to finalize the data-structure.  More... | |
| const CustomUnorderedSet< std::tuple< HLSFlowStep_Type, HLSFlowStepSpecializationConstRef, HLSFlowStep_Relationship > > | ComputeHLSRelationships (const DesignFlowStep::RelationshipType relationship_type) const override | 
| Compute the relationship of this step.  More... | |
| virtual DesignFlowStep_Status | InternalExec ()=0 | 
| Execute the step.  More... | |
| Protected Attributes | |
| CustomOrderedSet< unsigned int > | func_list | 
| list of functions to be analyzed  More... | |
| unsigned int | memory_version | 
| The version of memory representation on which this step was applied.  More... | |
| std::map< unsigned int, unsigned int > | last_bb_ver | 
| The version of BB IR representation on which this step was applied.  More... | |
| std::map< unsigned int, unsigned int > | last_bitvalue_ver | 
| The version of bit value IR representation on which this step was applied.  More... | |
|  Protected Attributes inherited from HLS_step | |
| const HLS_managerRef | HLSMgr | 
| information about all the HLS synthesis  More... | |
| const HLSFlowStep_Type | hls_flow_step_type | 
| The type of this step.  More... | |
| const HLSFlowStepSpecializationConstRef | hls_flow_step_specialization | 
| The information about specialization.  More... | |
|  Protected Attributes inherited from DesignFlowStep | |
| bool | composed | 
| True if this step represents a composition of design flow steps (e.g., a flow); must be set by specialized constructors.  More... | |
| const Wrefcount< const DesignFlowManager > | design_flow_manager | 
| The design flow manager.  More... | |
| const ParameterConstRef | parameters | 
| Set of input parameters.  More... | |
| int | debug_level | 
| The debug level.  More... | |
| const int | output_level | 
| The output level.  More... | |
| Additional Inherited Members | |
|  Public Types inherited from DesignFlowStep | |
| enum | RelationshipType { DEPENDENCE_RELATIONSHIP, INVALIDATION_RELATIONSHIP, PRECEDENCE_RELATIONSHIP } | 
| The relationship type.  More... | |
|  Static Public Member Functions inherited from HLS_step | |
| static std::string | EnumToName (const HLSFlowStep_Type hls_flow_step_type) | 
| Given a HLS flow step type, return the name of the type.  More... | |
| static const std::string | ComputeSignature (const HLSFlowStep_Type hls_flow_step_type, const HLSFlowStepSpecializationConstRef hls_flow_step_specialization) | 
| Compute the signature of a hls flow step.  More... | |
|  Static Protected Attributes inherited from HLS_step | |
| static CustomUnorderedMap< std::string, HLSFlowStep_Type > | command_line_name_to_enum | 
| Map hls step name to enum.  More... | |
Allocation memory class.
Definition at line 120 of file memory_allocation.hpp.
| memory_allocation::memory_allocation | ( | const ParameterConstRef | _parameters, | 
| const HLS_managerRef | HLSMgr, | ||
| const DesignFlowManagerConstRef | design_flow_manager, | ||
| const HLSFlowStep_Type | hls_flow_step_type, | ||
| const HLSFlowStepSpecializationConstRef | hls_flow_step_specialization = HLSFlowStepSpecializationConstRef() | ||
| ) | 
Constructor.
| design_flow_manager | is the design flow manager | 
| hls_flow_step_type | is the algorithm to be used | 
Definition at line 135 of file memory_allocation.cpp.
References DesignFlowStep::debug_level, GET_CLASS, DesignFlowStep::parameters, and ~memory_allocation().

| 
 | overridedefault | 
| void memory_allocation::allocate_parameters | ( | unsigned int | functionId, | 
| memoryRef | Rmem = nullptr | ||
| ) | 
Allocate parameters for given function.
| functionId | Id of the function to allocate paramters for | 
| Rmem | memory object ref to use (Rmem from HLS manager used if nullptr) | 
Definition at line 636 of file memory_allocation.cpp.
References memory::add_parameter(), tree_helper::CGetType(), compute_n_bytes(), memory::get_parameter_base_address(), HLS_step::HLSMgr, INDENT_OUT_MEX, tree_helper::name_function(), DesignFlowStep::output_level, OUTPUT_LEVEL_NONE, OUTPUT_LEVEL_VERBOSE, tree_helper::Size(), and STR.
Referenced by mem_dominator_allocation::InternalExec().


| 
 | overrideprotectedvirtual | 
Compute the relationship of this step.
| relationship_type | is the type of relationship to be considered | 
Reimplemented from HLS_step.
Definition at line 155 of file memory_allocation.cpp.
References ALL_FUNCTIONS, DesignFlowStep::DEPENDENCE_RELATIONSHIP, INITIALIZE_HLS, DesignFlowStep::INVALIDATION_RELATIONSHIP, DesignFlowStep::parameters, DesignFlowStep::PRECEDENCE_RELATIONSHIP, THROW_UNREACHABLE, and WHOLE_APPLICATION.
| 
 | overridevirtual | 
Execute the step.
Implements DesignFlowStep.
Definition at line 708 of file memory_allocation.cpp.
References HLS_step::HLSMgr, InternalExec(), last_bb_ver, last_bitvalue_ver, and memory_version.
Referenced by mem_dominator_allocation_cs::Exec().


| 
 | protected | 
Performs a final analysis of the memory allocation to finalize the data-structure.
looking for the maximum data bus size needed
check for packed struct/union accesses
check if a global variable may be accessed from an external component
an external component can access the var possibly (global and volatile vars)
Definition at line 211 of file memory_allocation.cpp.
References tree_helper::AccessedMaximumBitsize(), ALL_BRAM, ceil_log2(), FunctionBehavior::CFG, tree_helper::CGetType(), HLS_manager::check_bitwidth(), DesignFlowStep::debug_level, DEBUG_LEVEL_VERBOSE, DEBUG_LEVEL_VERY_PEDANTIC, func_list, GET_CONST_NODE, GET_NAME, GET_NODE, GET_TYPE, tree_helper::GetBaseVariable(), tree_helper::GetFunctionReturnType(), HLS_step::HLSMgr, INDENT_DBG_MEX, INDENT_OUT_MEX, index, tree_node::index, tree_helper::is_a_misaligned_vector(), tree_helper::is_a_pointer(), tree_helper::is_packed_access(), tree_helper::IsComplexType(), tree_helper::IsStructType(), tree_helper::IsUnionType(), tree_helper::IsVolatile(), max, MEMCMP, MEMCPY, MEMSET, DesignFlowStep::output_level, OUTPUT_LEVEL_MINIMUM, OUTPUT_LEVEL_NONE, OUTPUT_LEVEL_VERBOSE, DesignFlowStep::parameters, PRINT_DBG_MEX, tree_helper::Size(), STR, THROW_ASSERT, THROW_ERROR, THROW_WARNING, test_panda::type, TYPE_LOAD, and TYPE_STORE.
Referenced by mem_dominator_allocation::InternalExec().


| 
 | overridevirtual | 
Check if this step has actually to be executed.
Implements DesignFlowStep.
Definition at line 690 of file memory_allocation.cpp.
References HLS_step::HLSMgr, last_bb_ver, last_bitvalue_ver, and memory_version.
| 
 | protectedpure virtual | 
Execute the step.
Implemented in mem_dominator_allocation.
Referenced by Exec().

| 
 | protected | 
Prepares the data structures for the memory allocation.
the analysis has to be performed only on the reachable functions
add parm_decls that have to be copied
add parm_decls that have to be stored
add actual parameters that have to be loaded
Definition at line 182 of file memory_allocation.cpp.
References func_list, and HLS_step::HLSMgr.
Referenced by mem_dominator_allocation::InternalExec().

| 
 | protected | 
list of functions to be analyzed
Definition at line 124 of file memory_allocation.hpp.
Referenced by finalize_memory_allocation(), mem_dominator_allocation::InternalExec(), and setup_memory_allocation().
| 
 | protected | 
The version of BB IR representation on which this step was applied.
Definition at line 130 of file memory_allocation.hpp.
Referenced by Exec(), and HasToBeExecuted().
| 
 | protected | 
The version of bit value IR representation on which this step was applied.
Definition at line 133 of file memory_allocation.hpp.
Referenced by Exec(), and HasToBeExecuted().
| 
 | protected | 
The version of memory representation on which this step was applied.
Definition at line 127 of file memory_allocation.hpp.
Referenced by Exec(), and HasToBeExecuted().
 1.8.13
 1.8.13