home *** CD-ROM | disk | FTP | other *** search
/ Stars of Shareware: Programmierung / SOURCE.mdf / programm / msdos / c / adlibmsc / main / readme.txt < prev    next >
Encoding:
Text File  |  1989-05-10  |  4.3 KB  |  138 lines
  1. Directory: MAIN
  2.  
  3.  
  4. Ad Lib, May 1989
  5. ----------------
  6.  
  7. Sound driver (SOUND.COM) upgraded to V1.51.
  8.  
  9. Ad Lib, January 1989
  10. --------------------
  11.  
  12. This diskette now contains version 1.5 of the sound driver.  This
  13. version uses a different method of calculating delays (required between
  14. writes to the chip) so that the W option (see Dec-87 below) on fast
  15. machines will no longer be necessary.
  16.  
  17. The instrument file format, as shown in Appendix C of the Programmer's
  18. Manual, has changed and is explained in the file BKFORMAT.TXT.
  19.  
  20. In the event that two different boards use the same port address, it is
  21. useful to be able to change the port address of one of the boards.  As
  22. explained in the Programmer's Manual, the port address of the Ad Lib card
  23. is at 0x388.  However, there exists the possibililty of using three other
  24. addresses: 0x218, 0x288 or 0x318.  The port address is currently hard-wired,
  25. but in future production runs we will be adding a jumper to the card to
  26. facilitate the changing of port addresses.  (To date, conflicts have been
  27. very rare.)  If you are developing software which does not use our sound
  28. driver, we suggest that you allow for the use of different port addresses
  29. as we have done in our driver (see next paragraph).
  30.  
  31. Our sound driver (SOUND.COM) can accomodate the different port addresses.
  32. This is done when loading the driver by giving the argument "p" followed
  33. by the address to be used.  For example:
  34.       > sound p288
  35. This will cause the sound driver to use0x288 as the port address.
  36.  
  37.  
  38. Ad Lib November 1988
  39. --------------------
  40.  
  41.     New Version 1.3:
  42.  
  43.         - Support of two new functions:
  44.  
  45.         function 22:    Use to set the pitch bend range (in half-tones).
  46.                 Argument 1: pitch range, from 1 to 12.
  47.                 Function 0 sets this value to 1 half-tone for
  48.                 compatiblity with software that was designed
  49.                 for the older sound-driver.
  50.  
  51.         function 23:    Use to enable/disable the wave-form parameter.
  52.                 Argument 1: state, 0 == off, 1 == on.
  53.                 Note that the function 0 disables the wave-form
  54.                 parameter, so to enable it, function 23 must be
  55.                 called AFTER function 0.
  56.  
  57.  
  58.  
  59.     If the wave-form is enabled (func. 23), then function 16 (Set timbre)
  60.     expects two more integers at the end of the timbre definition array
  61.     (field 26 & 27), which specify values for the wave-form parameters
  62.     of operators 0 and 1.
  63.  
  64.  
  65.  
  66.     Here is the description of the status register, read from i/o
  67.     address 0x388:
  68.  
  69.     bit #    function
  70.     ------+---------
  71.     d7:    IRQ flag, set if flag T1 or T2 is on
  72.     d6:    T1 flag, set if timer 1 has elapsed. Remains set until it is
  73.         reset by setting bit d7 in the register at address 4
  74.     d5:    T2 flag, same as d6 for timer 2
  75.     d4-d0:    not used.
  76.  
  77.         (This information is missing from the Programmer's Manual.  Note
  78.          however, that the interrupts are not wired, so that the timers are
  79.          of no use given the delivered configuration of the card.  You can
  80.          wire this interrupt yourself if you wish, but this will void your
  81.          warranty.)
  82.  
  83.  
  84.  
  85. Ad Lib April 1988
  86. -----------------
  87.  
  88.     Errors where detected in the Programmer's Manual, here is the
  89.     list:
  90.         page 26, 27 and 28:
  91.            Functions 7, 11 and 13 that are given in your manual are
  92.            not supported (they are not implemented).
  93.  
  94.         page 40:
  95.            The delay times after a read or write are in micro (10E-06)
  96.            seconds.
  97.  
  98.         page 40:
  99.            Register 04 start/stop T1 and T2 should be exchanged
  100.            ( T1=D0, T2=D1 ).
  101.  
  102.         page 43:
  103.            When NOTE-SEL = 0,  FNUM(MSb) are Xs (dont cares).
  104.  
  105.  
  106.  
  107. Ad Lib December 1987
  108. --------------------
  109.  
  110.     This disk contains a new sound driver (sound.com version 1.2)
  111.     update for fast computers with 286 or 386 microprocessors.  This
  112.     new sound driver solves the note-skipping-problem.
  113.     
  114.     All you need to do is replace your old sound driver with the
  115.     new one.  If you still have problems you can change the wait
  116.     parameter as indicated below:
  117.  
  118.         sound Wxx
  119.  
  120.     where 'xx' is the delay value in hexadecimal.  The value ranges 
  121.     from 0 to 10 for normal systems.
  122.  
  123.  
  124.  
  125. Ad Lib November 20th 1987
  126. -------------------------
  127.  
  128.     In regards to the .ROL file formats, certain fields must be set
  129.     to specific values:
  130.  
  131.     -field #1 and #2 should be set to 0 and 4 respectively.
  132.  
  133.     -field #9 should read 0 => percussive, and 1 => melodic.
  134.  
  135.     -field #10 should be set to zero.
  136.  
  137.  
  138.