About This Guide
This guide contains instructions for deploying Audio Weaver custom modules to SHARC target hardware. This guide specifically uses the ADI-21569-SOM EVK, but the general process should be applicable for other SHARC target hardware.
General Process Overview
The process of adding custom modules on SHARC target is similar to other platforms, but the toolchain differs. For SHARC target hardware, the Analog Devices CrossCore Embedded Studio (CCES) IDE is needed to build an Audio Weaver custom module pack library and the board support package (BSP). Using the latest version of CCES is recommended.
Dependencies
To deploy Custom Modules to the ADI-21569-SOM SHARC DSP, the following dependencies are needed:
Audio Weaver Pro
CrossCore Embedded Studio IDE
Audio Weaver Custom Module source code
ADI-21569-SOM Audio Weaver BSP
General Steps
1. Build the Audio Weaver custom module static library in CCES
2. Include the Audio Weaver custom module static library in the BSP project linker options
3. Include desired custom modules from the Audio Weaver custom module static library in the ModulesList.h file
4. Build the BSP
NOTE: Depending on the module's size, there may be linker errors, but can be resolved by removing unnecessary module's or adjusting the linker file.
CCES Environment Setup and Custom Module Library Build
CCES Workspace
Download the Analog Devices CCES IDE for SHARC processors from the Analog Devices website: CrossCore Embedded Studio (CCES).
Set up CCES workspace directory:
...
Figure 8: CrossCore Projects and Settings
Custom Module CrossCore Project Properties and Settings
Right click on the ‘SHARC’ project that we created in the previous steps, and navigate to ‘Properties’ in the context window:
...
Figure 13: Custom Module CrossCore Project Settings Change Warning
Building the Custom Module .dlb Library
Now we must add the Custom Module C code.
...
Figure 23: SHARC Release Build Folder
ADI-21569-SOM BSP
Importing the BSP to CCES IDE
From the top CCES IDE menu bar, select ‘File > Import’:
...
Figure 29: 21569_SOM_BSP Imported
Linking Custom Module .dlb Library to BSP
Copy the SHARC.dlb Library we built in Section 3.3 to the ‘<DIR>\awe8-bsp-adi-21569-som\AWECore\Lib\CCES’ folder, such that it shares a common path with AWECore.dlb:
...
Click ‘Ok’ and then ‘Apply and Close’.
Adding Custom Module Objects to ModuleList.h
Navigate to the ‘<DIR>/awe8-bsp-adi-21569-som/SampleApp/21569_SOM/Source’ folder and open ModuleList.h for editing:
...
Save the edited ModuleList.h file.
Build the BSP
Right click on the ‘21569_SOM_BSP’ in the CCES IDE Project Explorer, and select ‘Build Project’ from the context menu:
...