home *** CD-ROM | disk | FTP | other *** search
/ Crawly Crypt Collection 1 / crawlyvol1.bin / apps / misc / fsm_des / readme.txt < prev    next >
Text File  |  1993-12-05  |  6KB  |  134 lines
  1. CLA-FSMedit v1                                                 3/12/93
  2. ©1993,by Craig Graham
  3. =====================
  4.  
  5. Summary
  6. -------
  7. This program allows you to design finite state machines graphicaly, and 
  8. implement them in hardware using a p22v10 Programable Logic Array Chip.
  9. This program comes as part of the CLA Digital Design System, although
  10. it is not integrated in this version.
  11.  
  12. THIS IS NOT A MANUAL, IT'S A DESCRIPTION.
  13.  
  14. Introduction
  15. ------------
  16. Most programs in the CLA design suite have their drawbacks & faults. The
  17. major one's with this program come from it being a rushed job. I needed
  18. to design a finite state machine (actually, the Digitiser Control FSM
  19. which is included as an example), so I wrote this program to help me do
  20. it. I'd been intending to write one for a while, so it wasn't a real
  21. hardship.
  22.  
  23. (Note:This program represets 4 days of intense work start to finish.)
  24.  
  25. Registration
  26. ------------
  27.  Since this version was written, a few features will have been added to the
  28. designer such as a simulation function & an interface to the rest of CLA, so
  29. it pay's to register you copy of CLA, as this comes in with that registration
  30. fee. (I'm actively using this program at the moment in my MEng Microelectronics
  31. project).
  32.  
  33. Unlike the rest of CLA, you are welcome to use this without registering, but
  34. remember that a better version will come with registering the rest of CLA, so
  35. it's worth your while.
  36.  
  37. Limitations on this version
  38. ---------------------------
  39. o Only p22v10's are supported.
  40. o No output to CLA .NET format is supported.
  41. o Only colour machines are supported (get a Falcon man...).
  42. o Evaluated conditions are not finished.
  43.  
  44. System Required
  45. ---------------
  46. You don't need a massive system to run this program, however......
  47.  
  48. The GUI is only designed for COLOUR monitors. I use colours for highlighting
  49. in the editor & for the dialogs. TOS4.x 3D objects are used as well, so some
  50. dialogs will look silly on older machines - get multiTOS see what you're 
  51. missing. The registered version will behave as does the rest of CLA & use two
  52. seperate RCS files. I simply didn't have time to do it for this version.
  53.  
  54. You will need to get a copy of PASSM for the Atari to make this program useful.
  55. This is available via FTP. Don't worry that most of the manual document is
  56. missing from the PASSM archive, I've worked it out from the source code, and
  57. you'll never actually have to write any PALASM code yourself as CLA-FSMedit
  58. does that bit for you.
  59.  
  60. Note however, that PASSM does have some bugs in it - you would be better to
  61. use PALASM2 on a PC for the time being.
  62.  
  63. This is the design path I use at the moment :-
  64.  
  65. 1) Atari Falcon running FSMedit to design & document the state machine.
  66.  
  67.       Export .PL2 file for PALASM2.
  68.  
  69. 2) PC running PALASM2 for compiling & simulating.
  70.  
  71.       Export .JED file for device programming.
  72.  
  73. 3) Universal Programmer for programming the device.
  74.  
  75.       PAL22V10 chip for testing.
  76.  
  77. 4) Hewlett Packard Logic Analyser for testing the actual device.
  78.  
  79. File Formats
  80. ------------
  81. This program generates 4 types of file.
  82.  
  83.  1) .FSM files are the CLA-FSMedit native file format, which it stores FSM's
  84.     in.
  85.  
  86.     .PAL, .PL2 & .GEM files are exported via the TOOLBOX dialog window.
  87.  
  88.  2) .PAL files are output from CLA-FSMedit on demand and are PASSM source
  89.     files, targetted for a p22v10. These can then be compiled using ST-PASSM
  90.     to produce JEDEC fuse maps for programming a PAL. If you wish to aim for a
  91.     different PAL, then REGISTER THE BLOODY PROGRAM, then  perhaps I'll help
  92.     you. Watch out for the bugs in PASSM.
  93.  
  94.  3) .PL2 files contain the same information as .PAL files, but in PALASM2
  95.     format. It must be said that using PALASM2 to compile designs is MUCH
  96.     better than using PASSM, as you can target almost any device, and can
  97.     run simulations & produce test vectors using the software - unfortunately
  98.     it only runs on a PC. I will eventually get PALASM out of the loop by
  99.     generating the JEDEC files direct, and allowing simulation of the PLD
  100.     inside the main program, but for now I  have to recomend that you get
  101.     PALASM2 and use a PC for final testing & PLD programming.
  102.  
  103.  4) .REP files are generated at the same time as .PAL & .PL2 files, and contain
  104.     more detailled information about the FSM (eg, easily read pinouts, state bit
  105.     assignments, transistion conditions, output variable states, etc).
  106.  
  107.  5) .GEM files are the standard GEM metafile format we all know & love.
  108.     Works fine as long as you have GDOS installed with the metafile driver as
  109.     device 31. Works with NVDI & Speedo. Note that the .GEM's are in colour.
  110.  
  111. Examples
  112. --------
  113. There are two example files included, B.FSM  &  V6.FSM.
  114.  
  115. B.FSM is the simple 3-state FSM which I used as a test piece for the program.
  116. This will compile quite happily with PASSM on an ST, but isn't very complex.
  117.  
  118. V6.FSM is the state machine which I wrote the program to design in the first
  119. place (it's the controller for a video digitiser/frame grabber).
  120. You would require PALASM2 on a PC to compile this state machine due to the bug
  121. in PASSM on the ST.
  122.  
  123. IMPORTANT NOTES:
  124. ---------------
  125. As it's not immediately obvious, the  button at the far right of the editor
  126. widget bar is the SELECT/EDIT icon - it allows you to select which state you
  127. wish to edit, and also to drag that state to a new posistion on screen.
  128.  
  129. For the Output Metafile option to work, the GDOS META.SYS driver should be
  130. installed as device 31.
  131.  
  132. FSMedit will accept a command line filename of an FSM - so you can use install
  133. application from the desktop, using the document type .FSM
  134.