home *** CD-ROM | disk | FTP | other *** search
/ Peanuts NeXT Software Archives / Peanuts-2.iso / Developer / hardware / dsp / gcc56k.README < prev    next >
Encoding:
Text File  |  1991-12-10  |  4.4 KB  |  97 lines
  1.  
  2.                 GCC56K -- GCC Compiler for the DSP56000/1
  3.                GCC5616 -- GCC Compiler for the DSP5616 series
  4.                               Version 0.1
  5.  
  6. This package contains GCC machine descriptions for the Motorola DSP56000
  7. (or DSP56001) DSP chip and the DSP5616 series (including the DSP56116 and
  8. the DSP56156).  Using the machine description files, a GCC compiler can be 
  9. created which will generate assembly code suitable for processing by 
  10. Motorola's assemblers.
  11.  
  12. The machine description is based upon version 1.40 of GCC.  It has not been
  13. tried with any other version of GCC.  If you do not have GCC 1.40, I
  14. believe that it is available from many different sites.  Two that I know of
  15. are anonymous FTP sites: crl.dec.com and prep.ai.mit.edu.  The latter
  16. address has a substantial list of where you can obtain GNU software.
  17.  
  18. Before going any further, please understand that the GCC56 compilers are
  19. limited in many ways and require some in-depth understanding of their 
  20. implementation.  I urge you to read the accompanying documentation
  21. thoroughly before attempting to write code.  This is a "hacker's compiler",
  22. not a well-polished product.
  23.  
  24. Here is a quick summary of the compiler's features and foibles -- don't
  25. bother compiling the compiler if the foibles are too restrictive:
  26.  
  27. --- The Good News
  28.     * (GCC56K) The compiler can generate code for either X-space or Y-space 
  29.       for both the stack and data areas independently.  As long as the stack 
  30.       space is consistent for all source files, the data spaces can be mixed 
  31.       and matched.
  32.  
  33.     * (GCC56K) The compiler can generate references to L-space for long 
  34.       variables and constants (with restrictions).
  35.  
  36.     * Several section macro references are generated which allow
  37.       segregation of constant data with writable data (I needed this for my
  38.       applications).
  39.  
  40. --- The Bad News
  41.     * The code that is generated is not terribly efficient.  I wouldn't
  42.       even dream of writing real "DSP" code with it.  It is suitable,
  43.       however, for writing "support" code for the real DSP.
  44.  
  45.     * The native modes of the processor are supported - and that is all.
  46.       Most notably, floating point numbers are restricted to the range
  47.       [-1,1) (I'm not kidding) and there is no support for unsigned numbers
  48.       (I'm still not kidding).  If you write 'float a=2.0' you will get a
  49.       compiler error.  If you have two variables declared as 'unsigned'
  50.       named 'i' and 'j', the comparison (i > j) will perform a signed test.
  51.  
  52.     * There is no advantage taken of the parallel move capability of the
  53.       processors.
  54.  
  55.     * There is no attempt made to reorder instructions to avoid pipeline
  56.       delays.  The assembler must be executed with an option that instructs
  57.       it to insert 'nop's when necessary.
  58.  
  59.     * The code generated is not compatible with that of Motorola's C
  60.       compiler.
  61.  
  62.     * The compiler is not fully tested.  This version is a beta release.
  63.  
  64. Having said all of the above, let me say that I *have* found the compilers
  65. useful.  I've noticed that my DSP applications are about 10% hard-core DSP
  66. and 90% support code.  The 10% is written in assembly language, of course.
  67. The remaining 90% can be written in C.  The reduction in development and
  68. maintenance time is dramatic.
  69.  
  70. I am open to comments and suggestions on improving the compiler.  I can be
  71. reached at 'asterian@bnr.ca' or post to the 'comp.dsp' newsgroup, which I
  72. read regularly.
  73.  
  74. If someone would like to "take over" the development of this compiler, they 
  75. are welcome to do so.  The time that I have to spend on improving it (or 
  76. fixing bugs) is limited.
  77.  
  78. The full documentation for the compilers is contained in the files
  79. 'DOC.56K' for GCC56K and 'DOC.5616' for GCC5616.  The compilers are
  80. different enough to warrant separate documentation files.  Please excuse
  81. the cut-and-paste mistakes.  Note that where the entire package is being 
  82. referred to, the name GCC56 is used.
  83.  
  84. As stated above, this is a beta release.  I've gotten the compilers working
  85. to the point where they generate working code for my projects.  I have no
  86. well-crafted test suite to exercise all aspects of the compiler.  I started
  87. writing the 56K compiler first but my development switched to the 56156
  88. soon thereafter.  I mostly use the GCC5616 compiler now so it is the better
  89. tested of the two.  For those brave souls who are willing to use these
  90. compilers, your bug reports will be much appreciated and will help create
  91. a stable product.
  92.  
  93. Best of luck!
  94.  
  95. Andrew Sterian
  96.  
  97.