DA8xx Creation of work area

NOTE:
This page has been updated for SDK 5.
SDK 100713Users: Please see "17:29, 30 June 2010" version

Introduction

This page talks about how to create the work area for custom code

Preparation

1. Map T: drive to the empty work folder. Here is the example in case of your empty work folder is C:\TI_DSP\work
   

   C:\> subst T: C:\TI_DSP\work

2. Assign a cNN: 'c' indicate custom. 'NN' is a number for customer board which will be provided by TI. If you got some custom release from TI, you can use it. If you do customization completely by yourself, you can use any number what you want.
3. Then follow Creating Work Area and Adding Source Files But here is some explanation of outline.
   • You will create pa/cust and its sub folders as work folder. You will extract pa_fd_da8xx_yymmdd.zip but cust and its sub folders for custom code are not be there. Then create folders under t:/pa/cust area. e.g. t:/pa/cust/vendor/c999 Typically the name of your company is assigned for vendor.
   • This will be the top level folder for all custom files.
   • If there are more than one DSPs on a board, make d1, d2, ..., dN sub-folders for each DSP and then use that folder as top level folder for all custom files for each DSP.
   • Will put all documents under t:/pa/cust/vendor/c999/doc folder.

GEL file customization

• Create custom GEL file using procedure described here and place them under gel folder.
• Store all data files that are used in the process (.pin file, CalcTool.xls, etc) under t:/pa/cust/vendor/c999/doc folder for future reference / updates.

Creating work area

1. You can access all zip files used here from release note (Start Menu->All Programs->Texas Instruments->PA SDK yymmdd->Release Notes)
2. Extract pa_fd_da8xx_yymmdd.zip and pa_sd_da8xx_yymmdd.zip to T: drive. You will see below folders.

T:.
da/dmax
da/dmax/v0
da/dmax/v0/da8xx
da/psp
da/psp/dat
pa/asp
pa/asp/arc1
pa/asp/ass3
pa/asp/ass3/alpha
pa/asp/com
pa/asp/dem
pa/asp/dem/alpha
pa/asp/dm
pa/asp/dm/alpha
pa/asp/ml0
pa/asp/ml0/alpha
pa/asp/rel
pa/asp/rel/pl2x
pa/asp/rel/pl2x/alg
pa/asp/rel/sfx
pa/asp/rel/sfx/mtx
pa/asp/rel/sfx/mtx/alg
pa/asp/rel/sfx/mtx/alpha
pa/asp/rel/sfx/rvb1
pa/asp/rel/sfx/rvb1/alg
pa/asp/rel/sfx/rvb1/alpha
pa/asp/rel/sfx/rvb1/include
pa/asp/src4
pa/asp/src4/alpha
pa/asp/std
pa/bin
pa/boards
pa/boards/drivers
pa/boards/e17
pa/boards/e17/drivers
pa/boards/e17/drivers/demo
pa/build
pa/build/c674x
pa/build/c674x/release
pa/chip
pa/chip/da8xx
pa/chip/primus
pa/chip/primus/csl
pa/chip/primus/csl/c674x
pa/dec
pa/dec/com
pa/dec/dwr
pa/dec/pcm1
pa/dec/pcm1/alpha
pa/dec/sng1
pa/dec/sng1/alpha
pa/enc
pa/enc/pce2
pa/enc/pce2/alpha
pa/f
pa/f/alpha
pa/f/include
pa/f/s19
pa/f/s19/i12
pa/f/s19/i12/alpha
pa/f/s19/i12/evmda830
pa/f/s19/i12/evmda830/.settings
pa/f/s19/i12/evmda830/alpha
pa/f/s19/i12/evmda850
pa/f/s19/i14
pa/f/s19/i14/alpha
pa/f/s19/i14/evmda830
pa/f/s19/i14/evmda830/.settings
pa/f/s19/i14/evmda830/alpha
pa/f/s19/i4
pa/f/s19/i4/evmda830
pa/f/s19/simda830
pa/f/s19/y13
pa/f/s19/y13/alpha
pa/f/s19/y13/evmda830
pa/f/s19/y13/evmda830/.settings
pa/f/s19/y13/evmda830/alpha
pa/f/s3
pa/gel
pa/i
pa/i/d800k001
pa/i/d800k001/irom
pa/i/d800k001/irom/rtd
pa/i/d800k001/pa
pa/i/d800k001/pa/asp
pa/i/d800k001/pa/asp/bm2
pa/i/d800k001/pa/asp/bm2/alpha
pa/i/d800k001/pa/asp/bm22
pa/i/d800k001/pa/asp/fil
pa/i/d800k001/pa/asp/fil/alg
pa/i/d800k001/pa/asp/fil/src
pa/i/d800k001/pa/asp/rel
pa/i/d800k001/pa/asp/rel/sfx
pa/i/d800k001/pa/asp/rel/sfx/geq3
pa/i/d800k001/pa/asp/rel/sfx/geq3/alpha
pa/i/d800k001/pa/build
pa/i/d800k001/pa/build/c674x
pa/i/d800k001/pa/build/c674x/release
pa/sio
pa/sio/acp1
pa/sio/acp1/alpha
pa/sio/dap
pa/sio/dcs6
pa/sio/dri
pa/sio/dro
pa/sio/paf

pa-sd/alpha
pa-sd/bin
pa-sd/pa_i12_evmda830
pa-sd/pa_i14_evmda830
pa-sd/pa_y13_evmda830

Adding source files

• Note:Please refer CHAPTER 1.2 and 1.3 of PA/F Reference Guide (Start Menu->All Programs->Texas Instruments->PA SDK yymmdd->PAF Reference Guide) to know toplogy and feature set. Then select appropriate one for your project.

Y13

1. Go to T: drive. Then make below directories.

   $ set CUSTFLDR=vender\c999\d1

   $ set CUSTTPFS=y13

   $ md t:\pa\cust\%CUSTFLDR%\%CUSTTPFS%

   $ md t:\pa\cust\%CUSTFLDR%\%CUSTTPFS%\alpha

   $ md t:\pa\cust\%CUSTFLDR%\%CUSTTPFS%\evmda830\alpha

   $ md t:\pa\cust\%CUSTFLDR%\%CUSTTPFS%\cus\alpha

2. Copy all source files from s19 area to cust area:

   $ copy t:\pa\f\s19\*.* t:\pa\cust\%CUSTFLDR%

   $ copy t:\pa\f\s19\%CUSTTPFS%\*.c t:\pa\cust\%CUSTFLDR%\%CUSTTPFS%

   $ copy t:\pa\f\s19\%CUSTTPFS%\alpha\*.h t:\pa\cust\%CUSTFLDR%\%CUSTTPFS%\alpha

   $ copy t:\pa\f\s19\%CUSTTPFS%\evmda830\*.c t:\pa\cust\%CUSTFLDR%\%CUSTTPFS%\evmda830

   $ copy t:\pa\f\s19\%CUSTTPFS%\evmda830\*.cmd t:\pa\cust\%CUSTFLDR%\%CUSTTPFS%\evmda830

   $ copy t:\pa\f\s19\%CUSTTPFS%\evmda830\*.c t:\pa\cust\%CUSTFLDR%\%CUSTTPFS%\cus

   $ copy t:\pa\f\s19\%CUSTTPFS%\evmda830\*.cmd t:\pa\cust\%CUSTFLDR%\%CUSTTPFS%\cus

   $ copy t:\pa\f\s19\%CUSTTPFS%\evmda830\alpha\*.h t:\pa\cust\%CUSTFLDR%\%CUSTTPFS%\evmda830\alpha

3. For DSP-only devices, since we will not use DSPLINK, perform following changes:

   $ del t:\pa\cust\vender\c999\d1\*_link.c

   $ del t:\pa\cust\vender\c999\d1\*_link.h

I14

1. Go to T: drive. Then make below directories.

   $ set CUSTFLDR=vender\c999\d1

   $ set CUSTTPFS=i14

   $ md t:\pa\cust\%CUSTFLDR%\%CUSTTPFS%

   $ md t:\pa\cust\%CUSTFLDR%\%CUSTTPFS%\alpha

   $ md t:\pa\cust\%CUSTFLDR%\%CUSTTPFS%\evmda830\alpha

   $ md t:\pa\cust\%CUSTFLDR%\%CUSTTPFS%\cus\alpha

2. Copy all source files from s19 area to cust area:

   $ copy t:\pa\f\s19\*.* t:\pa\cust\%CUSTFLDR%

   $ copy t:\pa\f\s19\%CUSTTPFS%\*.c t:\pa\cust\%CUSTFLDR%\%CUSTTPFS%

   $ copy t:\pa\f\s19\%CUSTTPFS%\alpha\*.h t:\pa\cust\%CUSTFLDR%\%CUSTTPFS%\alpha

   $ copy t:\pa\f\s19\%CUSTTPFS%\evmda830\*.c t:\pa\cust\%CUSTFLDR%\%CUSTTPFS%\evmda830

   $ copy t:\pa\f\s19\%CUSTTPFS%\evmda830\*.cmd t:\pa\cust\%CUSTFLDR%\%CUSTTPFS%\evmda830

   $ copy t:\pa\f\s19\%CUSTTPFS%\evmda830\*.c t:\pa\cust\%CUSTFLDR%\%CUSTTPFS%\cus

   $ copy t:\pa\f\s19\%CUSTTPFS%\evmda830\*.cmd t:\pa\cust\%CUSTFLDR%\%CUSTTPFS%\cus

   $ copy t:\pa\f\s19\%CUSTTPFS%\evmda830\alpha\*.h t:\pa\cust\%CUSTFLDR%\%CUSTTPFS%\evmda830\alpha

3. For DSP-only devices, since we will not use DSPLINK, perform following changes:

   $ del t:\pa\cust\vender\c999\d1\*_link.c

   $ del t:\pa\cust\vender\c999\d1\*_link.h

Making CCS5 project

Y13

1. Select a new location for workspace so that different workspaces can be used for different boards / DSPs.
2. Change to the ccsv5\eclipse directory of the CCS 5.3 installation in the DOS prompt.
3. Open the t:\pa\bin\da8xx\y13.projectspec file in any editor and replace f/s19 by cust/vender/c999/d1. Save the file.
4. Run the following command in the DOS prompt (assuming d:\workspace is the new workspace directory)

   .\eclipsec.exe -noSplash -data d:\workspace  -clean -application com.ti.ccstudio.apps.projectCreate  -ccs.projectSpec t:\pa\bin\da8xx\y13.projectspec

5. This will create the CCSv5 project at T:/pa/cust/vender/c999/d1
6. Open the project in CCSv5.
7. Go to Properties->General->RTSC. Change the XDC tools version to 3.16.2.32, Inter-processor communication to 1.0.5.60,SYS/Bios to 6.21.0.13 and XDAIS to 6.25.1.08. Click OK.
8. You can either build the project in CCS or use the following command in the DOS prompt.

   .\eclipsec.exe -noSplash -data d:\workspace -clean -application com.ti.ccstudio.apps.projectBuild -ccs.workspace -ccs.configuration Release

Structure of cust area

T:\pa\cust
└─vender
    └─c999
        └─d1
            │  acp_main_cus.c
            │  afp6_params.c
            │  afp6_params.h
            │  config.bld
            │  main.c
            │  nic_gpio.c
            │  pa.cfg
            │  std_incl.opt
            │  thx_incl.opt
            │
            └─y13
                │  acp_main_thx.c
                │  default_cus.c
                │  identify.c
                │  ipce_y13.c
                │  params.c
                │  patchs.c
                │  system.c
                │
                ├─alpha
                │      y13_a.h
                │
                ├─cus
                │  │  .ccsproject
                │  │  .cdtbuild
                │  │  .cdtproject
                │  │  .project
                │  │  atboot.c
                │  │  board_init.c
                │  │  io.c
                │  │  pa.cmd
                │  │
                │  ├─.settings
                │  │      org.eclipse.cdt.core.prefs
                │  │      org.eclipse.cdt.managedbuilder.core.prefs
                │  │
                │  └─alpha
                └─evmda830
                    │  .ccsproject
                    │  .cdtbuild
                    │  .cdtproject
                    │  .project
                    │  atboot.c
                    │  board_init.c
                    │  io.c
                    │  pa.cmd
                    │
                    ├─.settings
                    │      org.eclipse.cdt.core.prefs
                    │      org.eclipse.cdt.managedbuilder.core.prefs
                    │
                    └─alpha
                            pa_y13_evmda830_io_a.h

I14

1. Select a new location for workspace so that different workspaces can be used for different boards / DSPs.
2. Change to the ccsv5/eclipse directory of the CCS 5.3 installation in the DOS prompt.
3. Open the t:\pa\bin\da8xx\i14.projectspec file in any editor and replace 'f/s19' by 'cust/vender/c999/d1'. Save the file.
4. Run the following command in the DOS prompt (assuming d:\workspace is the new workspace directory)

   .\eclipsec.exe -noSplash -data d:\workspace  -clean -application com.ti.ccstudio.apps.projectCreate  -ccs.projectSpec t:\pa\bin\da8xx\i14.projectspec

5. This will create the CCSv5 project at T:/pa/cust/vender/c999/d1
6. Open the project in CCSv5.
7. Go to Properties->General->RTSC. Change the XDC tools version to 3.16.2.32, Inter-processor communication to 1.0.5.60,SYS/Bios to 6.21.0.13 and XDAIS to 6.25.1.08. Click OK.
8. You can either build the project in CCS or use the following command in the DOS prompt.

   .\eclipsec.exe -noSplash -data d:\workspace -clean -application com.ti.ccstudio.apps.projectBuild -ccs.workspace -ccs.configuration Release

Structure of cust area

T:\pa\cust
└─vender
    └─c999
        └─d1
            │  acp_main_cus.c
            │  afp6_params.c
            │  afp6_params.h
            │  config.bld
            │  main.c
            │  nic_gpio.c
            │  pa.cfg
            │  std_incl.opt
            │  thx_incl.opt
            │
            └─i14
                │  cus-algkey.c
                │  default_cus.c
                │  identify.c
                │  ipce_i14.c
                │  params.c
                │  patchs.c
                │  system.c
                │
                ├─alpha
                │      i14_a.h
                │
                ├─cus
                │  │  .ccsproject
                │  │  .cdtbuild
                │  │  .cdtproject
                │  │  .project
                │  │  atboot.c
                │  │  board_init.c
                │  │  io.c
                │  │  pa.cmd
                │  │
                │  ├─.settings
                │  │      org.eclipse.cdt.core.prefs
                │  │      org.eclipse.cdt.managedbuilder.core.prefs
                │  │
                │  └─alpha
                └─evmda830
                    │  .ccsproject
                    │  .cdtbuild
                    │  .cdtproject
                    │  .project
                    │  atboot.c
                    │  board_init.c
                    │  io.c
                    │  pa.cmd
                    │
                    ├─.settings
                    │      org.eclipse.cdt.core.prefs
                    │      org.eclipse.cdt.managedbuilder.core.prefs
                    │
                    └─alpha
                            pa_i14_evmda830_io_a.h

MISC

1. Please refer Algorithm Selection to know how to add/delete ip packages.
2. Please refer to http://processors.wiki.ti.com/index.php/Projects_-_Command_Line_Build/Create#Build_a_Project for more information on CCS command line tools.