MATHLIB Build Process

---

Contents

<ul>
  <li> @ref ccs_build
  <li> @ref gnu_build
</ul>

---

CCS Build Process

To build any specific kernel for test, benchmarking or to pull in source code changes -
just locate the associated project file, load it and run within the CCS environment.
The sections below provide all necessary details to get started.

  -# Required Tools
  -# Re-build MATHLIB Library
  -# Build Individual MATHLIB Kernel

The sections that follow detail each item above.

Required Tools

The following tools are required to build MATHLIB using CCS (links provided).
Download and install all tools to a single local (@c @b C:) directory, 
for example, <tt><b>c:\\ti</b></tt>.

- <a target=_blank href="https://www-a.ti.com/downloads/sds_support/TICodegenerationTools/download.htm">Code Generation Tools</a>
- <a target=_blank href="http://processors.wiki.ti.com/index.php/Download_CCS">Code Composer Studio</a>

@ *

Note

A "My.TI" account is required for download and can be registered at my.ti.com

Procedure for MATHLIB

The MATHLIB supports CCSV5.2 & above. The MATHLIB may be built following the procedure below:

 -# Open the CCSv5 application
 -# Import the MATHLIB @b makefile based project 
   - Open the @b Project menu
   - Select <b>Import Existing Eclipse Project</b>
   - Import from the MATHLIB @c @b packages/ti/mathlib/lib directory
 -# Build the project
   - Select <b>Rebuild Active Project</b> from @b Project menu 

Procedure for Individual Kernels

Any individual kernel within MATHLIB may be tested via CCS following 
the procedure below:

 -# Open the CCSv5 application
 -# Import the MATHLIB kernel unit test project 
   - Open the @b Project menu
   - Select <b>Import Existing Eclipse Project</b>
   - Import from the MATHLIB @c @b /packages/ti/mathlib/src/\<kernel\> directory
 -# Use the @b Debug profile for debugging kernel unit tests
   - Open the @b Project menu
   - Select <b>Active Build Configuration</b> and set to @b Debug/Release
 -# Build and test the project
   - Select <b>Rebuild Active Project</b> from @b Project menu 
   - Test using the proper target configuration

---

Makefile Build Process

A GNU @b makefile is also provided for rebuilding MATHLIB via GNU make utility. This file 
is located in the @c @b packages/ti/mathlib folder. The makefile provides a list 
of all tools, common build utilities and build rules required for generating 
MATHLIB binary. 

Required Tools

The following tools are required to build MATHLIB using GNU make (links provided).
Download and install all tools to a single local (@c @b C:) directory, 
for example, <tt><b>c:\\ti</b></tt>.

- <a target=_blank href="https://www-a.ti.com/downloads/sds_support/TICodegenerationTools/download.htm">Code Generation Tools</a>
- GNU Make (External Tool)

@note  A "My.TI" account is required for download and can be registered at <a target=_blank href="http://my.ti.com">my.ti.com</a>

Procedure for MATHLIB

The MATHLIB may be built using GNU make following the procedure below:

 -# Add @b cygwin/bin to the environment PATH (Windows only)
 -# Correct the @b C6x_GEN_INSTALL_DIR path in the @b makefile (two options)
   - Directly modify the makefile OR
   - Set the @b C6x_GEN_INSTALL_DIR in the environment with the proper tools path  
 -# Build the library
   - Enter <b><tt>make all</tt></b> to build the library
   - Enter <b><tt>make clean</tt></b> to clean all generated object files and artifacts