Output Directory - 2020.2 English

aie_system.h

#ifndef __XMC_AIE_SYSTEM_H__
#define __XMC_AIE_SYSTEM_H__
 
#include <adf.h>
#include "kernels/inc/hb_27_2i.h"
#include "kernels/inc/polar_clip.h"
#include "kernels/inc/hb_27_2d.h"
 
class Aie_system : public adf::graph {
private:
   adf::kernel fir_27t_sym_hb_2i_0;
   adf::kernel polar_clip_0;
   adf::kernel fir_27taps_symm_hb_dec2_0;
 
public:
   adf::input_port In1;
   adf::output_port Out1;
 
   Aie_system() {
      // create kernel fir_27t_sym_hb_2i_0
      fir_27t_sym_hb_2i_0 = adf::kernel::create(fir_27t_sym_hb_2i);
      adf::source(fir_27t_sym_hb_2i_0) = "kernels/src/hb_27_2i.cpp";
      adf::runtime<ratio>(fir_27t_sym_hb_2i_0) = 0.9;
 
      // create kernel polar_clip_0
      polar_clip_0 = adf::kernel::create(polar_clip);
      adf::source(polar_clip_0) = "kernels/src/polar_clip.cpp";
      adf::runtime<ratio>(polar_clip_0) = 0.9;
 
      // create kernel fir_27taps_symm_hb_dec2_0
      fir_27taps_symm_hb_dec2_0 = adf::kernel::create(fir_27taps_symm_hb_dec2);
      adf::source(fir_27taps_symm_hb_dec2_0) = "kernels/src/hb_27_2d.cpp";
      adf::runtime<ratio>(fir_27taps_symm_hb_dec2_0) = 0.9;
 
      // create nets to specify connections
      adf::connect< adf::window<512,64> > net0 (In1, fir_27t_sym_hb_2i_0.in[0]);
      adf::connect< adf::window<1024>, adf::stream > net1 (fir_27t_sym_hb_2i_0.out[0], polar_clip_0.in[0]);
      adf::connect< adf::stream, adf::window<1024,128> > net2 (polar_clip_0.out[0], fir_27taps_symm_hb_dec2_0.in[0]);
      adf::connect< adf::window<512> > net3 (fir_27taps_symm_hb_dec2_0.out[0], Out1);
   }
};
 
#endif // __XMC_AIE_SYSTEM_H__

Model composer automatically generates the graph header file aie_system.h which contains the dataflow graph corresponding to the subsystem name specified in the Model Composer Hub block. The connection between the AI Engine kernel or graph as well as the configuration parameters such as window size, window margin and so on, which are specified in the AI Engine kernel block, are automatically reflected in the generated graph code.

Model Composer also generates the aie_system.cpp file, which is a control program that connects the dataflow graph with the simulation platform, and the main() function is defined to initialize, run and end the simulation using the control APIs.

aie_system.cpp

#include "aie_system.h"
 
// Mapping inputs to PLIO
adf::PLIO *in1 = new adf::PLIO("In1", adf::plio_32_bits, "In1.txt");
 
// Mapping outputs to PLIO
adf::PLIO *out1 = new adf::PLIO("Out1", adf::plio_32_bits, "Out1.txt");
 
// instantiate adf dataflow graph
Aie_system mygraph;
 
// connect dataflow graph to simulation platform
// To generate input and expected_output data files,
// select 'Create and execute testbench' option on the Model Composer Hub block.
adf::simulation::platform<1,1> platform(in1, out1);
adf::connect<> net1(platform.src[0], mygraph.In1);
adf::connect<> net2(mygraph.Out1, platform.sink[0]);
 
// initialize and run the dataflow graph
#ifdef __AIESIM__
int main(void) {
   mygraph.init();
   mygraph.run();
   mygraph.end();
   return 0;
}
#endif

Limitations

• AI Engine code cannot be generated if a top-level subsystem's output port is connected to a synchronous run-time parameter port.
• The value of an input run-time parameter port can only be updated once at the beginning when running the generated graph.