home *** CD-ROM | disk | FTP | other *** search
/ Gold Fish 3 / goldfish_volume_3.bin / files / dev / cross / tms32010 / readme < prev    next >
Text File  |  1994-12-13  |  4KB  |  87 lines
  1. /* TMS320 shareware package readme file */
  2.  
  3. ******* CONTENTS *******
  4.  
  5.     This package contains five files:
  6. X320: The TMS32010 cross assembler program
  7. X320.c: it's source file
  8. L320: The linker from my own object code to Intel's hex format
  9. L320.c: it's source file
  10. readme: this readme file
  11.  
  12. ******* DISCLAIMER *******
  13.  
  14.     The two programs contained in this package had been tested and
  15. they probed to be reliable. However, I can not (and I will not) be
  16. responsible for any damage resulting of their use. It's your own risk and
  17. responsability.
  18.  
  19. ******* HISTORY *******
  20.  
  21.     I refused to start new projects using the TMS32010 DSP because of
  22. the lack of a cross assembler, not even running on stupid PCs.
  23.     Then, I decided to write my own.
  24.  
  25. *******  COPYRIGHT *******
  26.  
  27.     This is an unregistered work, it's shareware, and what I try to
  28. mean is "should you like it, use it; if you find it useful, send a $10
  29. donation to my address. Please keep all files together and do not change
  30. the copyright.
  31.  
  32. ******* DESCRIPTION *******
  33.  
  34.     The assembler program performs two passes, one to fetch all labels
  35. and AORG directives and the second to assemble the code. I preferred to
  36. treat each kind of instruction separately because it's easier to debug and
  37. to adapt it to assemble different processors in the future.
  38.     You have two assembly options: "x" that generates a simple cross
  39. reference listing on the standard output, and "L" that calls the linker to
  40. obtain the code in a single instruction.
  41.     The object code is a simple address-instruction format in ASCII,
  42. and it makes easy for the linker to obtain the Intel hex format which you
  43. can then send to a programmer.
  44.     The assembler takes an input file and generates other with the
  45. name you gave or the same name as the input file plus the ".obj"
  46. extension.
  47.     The linker takes a ".obj" file as it's input (note that you don't
  48. need to add ".obj" to the name when calling the linker, but you can if you
  49. wish) and generates two files with the name you gave or the same name as
  50. the input file (without the ".obj" extension) plus the ".low" and ".high"
  51. extensions for the low and high order bytes respectively.
  52.     Both programs are CLI only.
  53.  
  54. ******* FUTURE ********
  55.  
  56.     I am planing to convert this programs to handle all current 8 bit
  57. microprocessors and microcontrollers, so Amiga users will not need to use
  58. boring PCs.
  59.  
  60. ******* BUGS *******
  61.  
  62.     The assembler supports Texas notation for hexadecimal numbers
  63. (>1234) as well as C notation (0x1234 for hexa,01234 for octal, 1234 for
  64. decimal), so be careful when writing numbers as a leading zero means
  65. octal.
  66.     The DATA directive suppports multiple operands, so you don't need
  67. to write many DATAS. Operands are currently only labels or positive
  68. numbers.
  69.     The label "$" means actual PC, and there are no restricted words,
  70. so the label ADD is valid.
  71.     The only syntactic constrain is that the assembler decides that if
  72. the first character of a line is a blank (tab or space), then the first
  73. valid word is a mnemonic; otherwise, the first word is a label.
  74.     I have modified a part of the standard syntax, that is, you can't
  75. use the "*" to signal comments. You use ";" instead. This is because "*"
  76. is also used to mark indirect addressing and it complicates the string
  77. handling so I decided to alter the syntax, since I'm not a programmer and
  78. this joke was growing so faster...
  79.     Please send any bugs, comments, suggestions, programs, and of
  80. course donations to the following address:
  81.  
  82.     Sergio R. Caprile
  83.     Pje. Terrada 4789
  84.     (1874) Avellaneda
  85.     Bs.As. - Argentina
  86.  
  87. I can be reached at sergio.caprile@itbace.edu.ar