home *** CD-ROM | disk | FTP | other *** search
/ Piper's Pit BBS/FTP: ibm 0020 - 0029 / ibm0020-0029 / ibm0028.tar / ibm0028 / DSPCG1.ZIP / README.DOC < prev   
Encoding:
Text File  |  1989-07-07  |  3.8 KB  |  84 lines
  1.                                  CGEN 4.01
  2.      This version of CGEN supports all generations of TI's TMS320 family of 
  3. DSP processors through the latest floating point TMS320C30.
  4.  
  5.                                 INSTALLATION
  6.  
  7.      To install CGEN you should copy all of the files from the root 
  8. directories of the release diskettes to a directory on your hard disk.  If 
  9. you are going to be generating code for ASPI's CHIMERA processor board, you 
  10. should also copy the appropriate main I/O routine from the MAIN_IO directory 
  11. located on one of the release diskettes to the above mentioned directory and 
  12. rename it to TMS320IO.  If you are going to generate code for ASPI's BANSHEE 
  13. processor card you should copy the appropriate main I/O routine from the 
  14. BANSHEE directory located on one of the release diskettes to the directory 
  15. you will be working in.  You should then rename this I/O routine to either 
  16. C_MAIN.C or MAIN.ASM depending on whether you are going to be generating 'C' 
  17. compiler callable code or ASM30 callable code.  You should then compile or 
  18. assemble these two routines to produce C_MAIN.OBJ and MAIN.OBJ.  There is 
  19. more information about these files in the README.DOC files located in these 
  20. directories.
  21.  
  22.      Complete examples of how to use CGEN to generate a complete executable 
  23. filter on one of ASPI's processor cards are given in the README.DOC files 
  24. located in the MAIN_IO and BANSHEE directories on these release diskettes.
  25.  
  26.      In order for CGEN to operate properly, you must set a DOS environment 
  27. variable 'DP'.  CGEN uses this variable to locate parameter files that it 
  28. needs to generate code.  If the 'DP' environment variable is not set, CGEN 
  29. uses the 'PATH' environment variable.  The following example sets the 'DP' 
  30. environment variable to point to the directory C:\ASPI\UTILITY.
  31.  
  32.     SET DP=C:\ASPI\UTILITY
  33.  
  34.     'DP'  can be set so that more than one directory is searched just like 
  35.     'PATH'.  See your DOS manual for further details.
  36.  
  37. Example:
  38.     SET DP=C:\BIN;C:\ASPI\UTILITY
  39.  
  40.  
  41.     If the DP environment variable does not exist, PATH is used.
  42.  
  43. NOTE: CGEN must also be able to locate DFDP.PAR in this same manner.
  44.  
  45. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  46. To use CGEN with the BANSHEE or CHIMERA processor cards you should have
  47. a revision 2.23 or newer TI_LOAD.  If you do not, please contact ASPI
  48. about obtaining a new release of the BANSHEE or CHIMERA software.
  49.  
  50. You should also run 320_SAVE.COM (provided your BANSHEE or CHIMERA
  51. software) at boot time.  This program is used in conjunction with
  52. TI_LOAD to save the sample clock rates.  It is a resindent program
  53. that occupies about 300 bytes of your PC memory.
  54. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  55.  
  56. ***************************************************************************
  57.  
  58.                                 ENHANCEMENTS
  59.  
  60. Another way to execute CGEN from the command line is given below:
  61.  
  62. CGEN FILTER_FILE ASSEMBLY_FILE UNIQUE_NAME {Y|N} PROCESSOR_IMPL
  63.  
  64. where
  65.     FILTER_FILE        is the name of the filter file (.flt default ext).
  66.     ASSEMBLY_FILE      is the name of the output source file.
  67.     UNIQUE_NAME        is the name of the 5 character unique identifier.
  68.     {Y|N}              indicates entering either a Y or an N to select a
  69.                        full implementation (including the main I/O) or not.
  70.     PROCESSOR_IMPL     is the processor implementation number
  71.  
  72. In other words the answers to the questions that CGEN asks when run
  73. interactively
  74.  
  75. Ex: CGEN IIR IIR IIR Y 1
  76.  
  77.  
  78. ---------------------------------------------------------------------------
  79.  
  80.              BUGS FIXED FROM 4.00
  81.  
  82. 1) Removing either the sample by sample or array filter routine from
  83. the super time optimized IIR routine causes linker problems.
  84.