home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 9 / FreshFishVol9-CD2.bin / bbs / util / dbb-1.1.9.lha / DBB / DBB.doc < prev    next >
Text File  |  1994-03-30  |  27KB  |  814 lines
  1.  
  2.                        Digital Breadboard
  3.                          Version 1.1.9
  4.                       Copyright 1992-1993
  5.  
  6.                         Danny L. Griffin
  7.  
  8.  
  9.  
  10.                             Abstract
  11.  
  12.   Digital Breadboard is a full GUI sequential-solving digital
  13. logic circuit simulator that will allow you to design, build,
  14. and test digital logic circuits in software.
  15.  
  16.  
  17.                             Preface
  18.  
  19. Introduction
  20.  
  21.   Ever since the Amiga's introduction, there has been a
  22. steadily increasing number of scientific applications
  23. available, but one application that many people have been
  24. asking for that is not currently available (that I know of) is
  25. a digital logic circuit simulator. So, rather than just talk
  26. about it, I decided to write one.
  27.  
  28. What it is
  29.  
  30.   Digital Breadboard is a full GUI sequential-solving digital
  31. logic circuit simulator that will allow you to design, build,
  32. and test digital logic circuits in software. In this release,
  33. there are some limitations put on the type of circuits that you
  34. can build, the primary one being the size of the circuit. No
  35. more than forty elements are allowed in this version.
  36.  
  37.   Still, this release does incorporate many useful tools,
  38. allowing Digital Breadboard some small measure of power. Among
  39. these are support for:
  40.  
  41.  - multiple input AND, OR, NAND, and NOR gates
  42.  - XOR and NOT gates
  43.  - D, JK, and SR flip flops
  44.  - multiple user-definable clocks 
  45.  - switched and pulsed inputs
  46.  - event counters
  47.  - outputs
  48.  - independant four-channel trace scope
  49.  - preferences printing
  50.  
  51.   Circuits can, of course, be saved, recalled, and edited at
  52. any time.
  53.  
  54.  
  55.                         Getting Started
  56.  
  57. Requirements
  58.  
  59.   Digital Breadboard requires:
  60.  
  61.  - AmigaOS 2.04 (V37 or higher)
  62.  - reqtools.library (V37 or higher)
  63.  ...that's it!
  64.  
  65. Installation
  66.  
  67.   NOTE: we will use the symbol [DBBdir] throughout this manual
  68. to represent the directory in which the executable program `DBB'
  69. resides.  Digital Breadboard will produce a fully qualified
  70. path for this location whether it was started from the Workbench 
  71. or CLI, even if it is not the current directory (DBB may be 
  72. `path'ed, for example), e.g. [DBBdir]Circuits might represent
  73. DF0:Circuits as well as DH4:Breadboard/Circuits. The user does
  74. not have to do any `assign's.
  75.  
  76.   If you don't already have reqtools.library in your libs:,
  77. move it there. There are no other requirements of Digital 
  78. Breadboard.  You may wish to install the hpcalc font in your 
  79. fonts: directory:
  80.  
  81.  copy fonts fonts: all
  82.  
  83.   However, this is not necessary.  Since hpcalc is not a full 
  84. font, some people may not want to install it in fonts:.  DBB 
  85. will first look in [DBBdir]fonts for the hpcalc font, then 
  86. in fonts:  If Digital Breadboard doesn't find the font it will 
  87. still run, but the Timer window will use Topaz 8 and it will 
  88. look goofy. This font will also be used for the 7-segment display 
  89. element in the next rev. This is the order in which Digital 
  90. Breadboard looks for files:
  91.  
  92.   Fonts        - [DBBdir]fonts, fonts:
  93.   DBB.prefs    - [DBBdir]
  94.   DBB.guide    - [DBBdir]
  95.   Design files - [DBBdir]Circuits, [DBBdir]
  96.  
  97. All icons are saved with a fully qualified Tool path.
  98.  
  99. Start
  100.  
  101.   Digital Breadboard can be started from the CLI by typing DBB
  102. or by double-clicking on the icon. Digital Breadboard will
  103. attempt to open up an overscan interlaced hires screen (682 x
  104. 440 or greater) while taking into account the user preferences,
  105. and two windows will initially appear: the design window and
  106. the tools (Elements) window. However, some people don't use an
  107. overscan display, and so for both of you Digital Breadboard
  108. will limit the horizontal screen size to match the user
  109. preferences rather than have the screen autoscroll left every
  110. time the mouse is moved to the right edge. The Elements window
  111. will overlap the design window. This, however, will be fixed
  112. when a resizeable window is implemented to support the larger
  113. virtual work area in the next revision. PAL screens are
  114. supported.
  115.  
  116.   Digital Breadboard accepts a single command-line argument--
  117. the name of a design file. If given, Digital Breadboard will
  118. load the file upon startup. All other arguments will be
  119. ignored. 
  120.  
  121.   To begin placing objects, simply click on the desired element
  122. with the mouse, move your pointer to where you wish to place
  123. the element, and click the left mouse button to drop it. Then,
  124. click on another element and do the same.
  125.  
  126.   When you're ready to connect the elements, choose the menu
  127. option EDIT/CONNECT. The design window's titlebar will change
  128. to read:
  129.  
  130.  Connect - Select output element
  131.  
  132.   Using the mouse, click on the output element to start with.
  133. When selected, a highlight box will appear around the element.
  134. You do not have to click on a specific output. If an element
  135. has more than one output, as in a D flip flop, a requester
  136. will appear asking you which one you wish to use. Simply select
  137. the appropriate response (see Section 4.1). If you change your
  138. mind, press ESC and the requester will go away and you can
  139. select a different output element.
  140.  
  141.   After you've selected an output, you need to select an input.
  142. The window's titlebar will again prompt you. 
  143.  
  144.  Connect - Select input element
  145.  
  146.   Again, you do not need to click on a specific input, just the
  147. element. An element with multiple inputs will respond with a
  148. requester asking you which input you wish to use. Select the
  149. appropriate response, or press ESC to cancel.
  150.  
  151.   When you have completed wiring your design, you may save it
  152. to disk with PROJECT/SAVE or begin simulation with CONTROL/RUN.
  153. You may at any time return to any of the editing screens (Add,
  154. Connect, Cut, Delete, etc.)
  155.  
  156.   To quit Digital Breadboard, select the menu option
  157. PROJECT/QUIT or press RAmiga-Q. If your work isn't saved, you
  158. will be asked if you wish to save your work before exiting.
  159.  
  160.   These are the basics of operation, but there are many more
  161. features that are described in the following pages. Try loading
  162. one of the sample project files. 
  163.  
  164.  
  165.                              Menus
  166.  
  167. Project
  168.  
  169.  New 
  170.  
  171.   Start a new design. This will replace the current design, and
  172. if you try to overwrite a modified design, a security
  173. requester will pop up giving you a chance to save the current
  174. file before proceeding.
  175.  
  176.  Open
  177.  
  178.   Open an existing Digital Breadboard design file. A
  179. filerequester will appear in which you select the new design
  180. file to load. This file will replace the current one, and if
  181. you try to overwrite a modified design, a security requester
  182. will pop up giving you a chance to save the current file before
  183. proceeding.
  184.  
  185.  Save
  186.  
  187.   Save the current circuit under the current name. If there is
  188. no current filename, a filerequester will appear.
  189.  
  190.  Save As
  191.  
  192.   Save the current circuit under a new name. A filerequester
  193. will appear.
  194.  
  195.  Print
  196.  
  197.   Print the circuit using the preferences printer. Digital
  198. Breadboard will attempt to determine the maximum resolution of
  199. your printer, as selected in Preferences, and print the design
  200. circuit currently displayed. Due to the ability of the user to
  201. select his own screen colors, and to keep as much control in
  202. the hands of the user as possible, Digital Breadboard provides
  203. control of the printer from within the program. This will not
  204. modify the user PrinterGfx Preferences settings. It is
  205. normally a good idea to print with `Black & White' shading, a
  206. reasonable threshold, and the correct Image settings. For the
  207. default WB2.x colors (grey, black, white, and blue), a
  208. Positive image with a threshold of 7 is fine. See Section 3.4,
  209. the Settings menu.
  210.  
  211.  About
  212.  
  213.   Display some useful (?) information.
  214.  
  215.  Quit 
  216.  
  217.   Quit
  218.  
  219.  
  220. Edit
  221.  
  222.  Delete Device 
  223.  
  224.   Remove digital logic elements from the circuit. The window
  225. titlebar will prompt you with:
  226.  
  227.  Delete - Select element to remove
  228.  
  229.   Click on the element to remove from the circuit, and it,
  230. along with any associated connections, will be removed. Press
  231. ESC to cancel.
  232.  
  233.  Cut Connection
  234.  
  235.   Cut a connection between two elements. Use the mouse to click
  236. on the first (output) element, then the second (input)
  237. element. Again, Digital Breadboard responds with positive
  238. feedback by highlighting the first element with a box. The
  239. connection between the two elements will be removed. Press ESC
  240. to cancel.
  241.  
  242.  Move Device
  243.  
  244.   Move an