SoConnect (SC) is a benchmark-oriented framework for fastly developping DPDK application, which integrate DOCA and CUDA support, one can use this framework for rapidly developping your own benchmark that can be tested on either x86 server or ARM SoC.

1. Install DPDK and setup DPDK environment (e.g. hugepage, etc.)

2. (Optional) Install and setup DOCA and CUDA environment

3. Install other dependencies

sudo apt-get install libgmp3-dev
python3 -m pip install meson
python3 -m pip install ninja

1. Change the app within meson.build to build your desired application, full application list can be found under src/apps/.app_list;

2. Run the following command to build your application

meson build && cd build
ninja

3. Change the configurations under conf, these configuration files include:

4. To execute the application binary, run (p.s. assume echo_client was built):

sudo ./echo_client

Assume your new benchmark application's name is newapp:

1. Add Configuration File: add custom configuration file newapp.conf to conf/apps

2. Add Headers:

   • Duplicate include/apps/sc_template under include/apps as include/apps/sc_newapp;
   • Change filename of include/apps/sc_newapp/template.hpp to include/apps/sc_newapp/newapp.hpp;
   • Change the macro _SC_TEMPLATE_H_ within include/apps/sc_newapp/newapp.hpp to _SC_NEWAPP_;

3. Add Headers:

   • Duplicate src/apps/sc_template under src/apps as src/apps/sc_newapp;
   • Change filename of src/apps/sc_newapp/template.cpp to include/apps/sc_newapp/newapp.cpp;
   • Change the macro include/apps/sc_newapp/newapp.cpp to include sc_newapp/newapp.h instead of sc_template/template.h;

4. Add newapp into src/apps/.app_list;

   TODO: Develop a automatical script to finish above 1~4's logic

5. Start develop your benchmark's logic;

6. Change the selected application inside meson.build to build your benchmark