Codec and server wizard
From disptec
Codec wizard
Now is time to make an algorithm that follows TI's eXtreme Dsp Interoperability Standard, commonly named XDAIS. The standard consist of a set of general rules and guidelines that should be applied to all algorithms to ensure fair play between them. For specialized codecs TI offers xDM standard that defines APIs through which an application invokes a particular class of codec, such as video decode or audio encode. In our case we will be using iUniversal, which is a generic class of codec that allows to integrate modules, that don't implicate multimedia applications. To ease this, TI offers an API called IALG, that creates an interface between our algorithms and the guidelines with memory usage.
To integrate these concepts will be using TI's codec wizard available in RidgeRun SDK.
First step is to update XDCtools. To do this download the latest version from TI website:
http://software-dl.ti.com/dsps/dsps_public_sw/sdo_sb/targetcontent/rtsc/3_20_04_68/index_FDS.html
Modifying DVSDK makefile to invoke wizard
Using your favorite text editor, open DVSDK makefile that is in following path.
# cd $(DEVDIR)/propietary/dvsdk_1_00_00
Note: Remember $(DEVDIR) is your SDK installation directory.
1. Change your XDC_INSTALL_DIR
Find the line where XDC_INSTALL_DIR is set and modify it with your new XDCtools installation directory. It should look like the following:
XDC_INSTALL_DIR = (installation_dir)/xdctools_3_20_01_51
Note: The installation_dir is of location where you previously installed XDCtools
2. Append the following target to your makefile
gencodecpkg:
(tab) $(XDC_INSTALL_DIR)/xs --xdcpath="$(CE_INSTALL_DIR)/packages;$(XDAIS_INSTALL_DIR)/packages" ti.sdo.ce.wizards.gencodecpkg
Note: Please, note that second line starts with one tab.
3. Save changes and start wizard
In that same directory type the following:
# make gencodecpkg
If an error message with the following is displayed:
Rules.make:21: *** ====== DEVDIR variable is empty, invoke this Makefile from the BSP root, or provide the path to it =====. Stop.
Type the following:
#`make -sC $(DEVDIR)/ env`
4. Start wizard
The wizard's first screen should look like the following:
a. Select Create a CE-compatible codec package from scratch
b. Set XDAIS install Dir (this option is usually set by default), if not, set it to $(DEVDIR)/proprietary/dvsdk_1_00_00/OMAP_L138_arm_1_00_00_08/xdais_6_25_01_08
c. Set C6000 TI 'cgtools' Dir (/opt/TI/TI_CGT_C6000_6.1.9)
The wizard's second screen should look like the following:
a. Type your codec name
b. Type the name of your organization
c. Select IUNIVERSAL as Base Interface.
d. Type the package name (the points in your package name will be translated in subdirectories), in our example we have three subdirectories: disptec, codecs and finally fir.
e. Select ti.targets.C674 as target.
f. Set output repository for you project.
Finally your codec was created.
Compile codec
5. Move to your newly created codec directory (the one containing all the sources, headers and configuration files)
For example:
# cd ~/disptec/codecs/fir/
6. Compile the codec by typing:
# make VERBOSE=1
Server Wizard
Modifying DVSDK makefile to invoke wizard
Using your favorite text editor, open DVSDK makefile that is in following path.
# cd $(DEVDIR)/propietary/dvsdk_1_00_00
Note: Remember $(DEVDIR) is your SDK installation directory.
1. Append the following target to your makefile
genserver:
(tab) $(XDC_INSTALL_DIR)/xs --xdcpath="$(CE_INSTALL_DIR)/packages;$(XDAIS_INSTALL_DIR)/packages" ti.sdo.ce.wizards.genserver
Note: Please, note that second line starts with one tab.
2. Save changes and start wizard
In that same directory type the following:
# make genserver
If an error message with the following is displayed:
Rules.make:21: *** ====== DEVDIR variable is empty, invoke this Makefile from the BSP root, or provide the path to it =====. Stop.
Type the following:
#`make -sC $(DEVDIR)/ env`
3. Start wizard
The wizard's first screen should look like the following:
a. Select ti.platforms.evmOMAPL138 as Platform.
b. Type the server package name (the points in your package name will be translated in subdirectories), in our example we have three subdirectories: disptec, servers and finally fir.
c. Set output repository for you project.
d. Set C6000 TI 'cgtools' Dir (/opt/TI/TI_CGT_C6000_6.1.9).
e. Set Package Search Path. The wizard's screen should look like the following:
Note: You should add the path where is your project and select OK.
f. Search for Codecs.
The wizard's screen should look like the following:
Select your codec.
Note: One server can contain several codecs.
The wizard's second screen should look like the following:
The wizard's third screen should look like the following:
Select Use defaults.
Finally appear the question: Would you like to save the values entered into the Codec Engine GenServer Wizard?, Select Yes and the last wizard's screen should look like the following:
Save the file anywhere but is recommend save the file in the fir server directory.
Finally your server was created.
4.Modifying fir server makefile to include different packages: DSP/BIOS, biosutils, Framework Components and DSP Link.
Compile server
5. Move to your newly created server directory (the one containing all the sources, headers and configuration files)
For example:
# cd ~/disptec/servers/fir/
6. Compile the server by typing:
# make VERBOSE=1
