Skip to main content
C7-based MCU projects using the DSPLIB library leverage the DSP accelerator unit within the processor. This enables hardware acceleration of basic DSP operations such as filtering, convolution, correlation, and similar tasks, resulting in high performance in real-time applications.

​
Example Project

A working example project that you can examine as a reference for DSPLIB library integration is provided in the MCU directory within T3 Gemstone’s GitHub examples repository. While inside the devbox shell within the examples repository, you should run the following command. 
PROJECT=mcu task clean build
The dsplib_demo.out file located in examples/mcu/dsplib_demo/j722s-evm/c75ss0-0_freertos/ti-c7000 and examples/mcu/dsplib_demo/j722s-evm/c75ss1-0_freertos/ti-c7000 is now ready to run on the C7 cores. To run it on the development board, you can follow the steps in the Running the compiled project at the U-Boot stage section. In this example project, the generated outputs are transmitted via the UART1 interface. You can find the related pin connections in the Pinout documentation. The terminal output of the DSPLIB example project is as follows. 
DSPLIB Demo start

------------------------------------
      T3 Gemstone DSPLIB Test              
------------------------------------

0.716499  +   nane-308 =    0.716499
0.135435  +   0.785398 =    0.920833
0.509235  +    1.57080 =    2.08003
0.541196  +    2.35619 =    2.89739
0.192425  +    3.14159 =    3.33402
0.383086  +    3.92699 =    4.31008
0.563632  +    4.71239 =    5.27602
0.245671  +    5.49779 =    5.74346
0.0562966 +   nane-308 =    0.0562966
0.991528  +   0.785398 =    1.77693
0.479954  +    1.57080 =    2.05075
0.973097  +    2.35619 =    3.32929
0.798400  +    3.14159 =    3.93999
0.0669125 +    3.92699 =    3.99390

​
Integrating into an Existing MCU Project via MakeFile

To integrate the DSPLIB library into your existing MCU project, you need to define the root directory path of the SDK and the .cpp file you will use. 
SDK_ROOT_PATH := ${MCU_PLUS_SDK_PATH}/..

FILES_cpp := \
	dsplib_demo.cpp \
Then, you should add DSPLIB’s src directory to the list of included folders (INCLUDES_common variable) as follows. You may need to adjust the path according to your DSPLIB version. 
-I${SDK_ROOT_PATH}/dsplib/src \
You must add the following necessary definitions to the compiler FLAGS parameters (CFLAGS_common variable) for the library to compile correctly. 
-DMCU_PLUS_SDK \
-DBUILD_C7X \
-DSOC=j722s \
--silicon_version=7524 \
You should add DSPLIB’s compiled library directory to the library path definitions (LIBS_PATH_common variable). 
-i${SDK_ROOT_PATH}/dsplib/lib/Release \
You need to add the name of the DSPLIB library to the list of included library files (LIBS_common variable) as follows. 
-lDSPLIB_C7524.lib \
-lDSPLIB_common_C7524.lib \
To enable the compilation of .cpp files in the project, the following additions must be made right below the line where OBJS and DEPS definitions are made. 
OBJS += $(FILES_cpp:%.cpp=%.obj)
DEPS := $(FILES:%.cpp=%.dpp)
vpath %.cpp $(FILES_PATH)

$(OBJDIR)/%.obj %.obj: %.cpp
	@echo  Compiling: j722s:c75ss0-0:freertos:ti-c7000 $(OUTNAME): $<
	$(CC) $(CFLAGS) $(INCLUDES) $(DEFINES) -ppd=$(OBJDIR)/$(basename $@).dpp -ppa -fr=$(OBJDIR)/ -fp=$<
Upon completion of these steps, the DSPLIB library will be successfully integrated into the project via Makefile.

​
Integrating DSPLIB into an Existing CPP File

After completing the necessary configurations via Makefile, to use the DSPLIB library, you need to include its header file in the .cpp file within your project. Following this step, you can directly use DSPLIB’s functions and definitions within your existing project. You can access all modules available in the DSPLIB library via this link. 
#include <dsplib.h>
With this process, the DSPLIB integration will be complete.