Changeset 510


Ignore:
Timestamp:
Jul 11, 2010, 5:36:19 PM (15 years ago)
Author:
David Azarewicz
Message:

readme and changelog updates

Location:
OCO/trunk/install
Files:
3 edited

Legend:

Unmodified
Added
Removed

  • OCO/trunk/install/CHANGELOG.TXT

    r403 r510  
    22UNIAUD CHANGELOG
    33================
     4
     5===== 1.9.3 and 1.9.23 : July 10, 2010 =====
     6
     7 * Malloc fixes
     8
     9 * Packages are now labeled with both the uniaud16 and the uniaud32
     10   version numbers. The first is the uniaud16 version and the second
     11   is the uniaud32 version.
     12
     13 * Improved buffer management (uniaud16)
     14
     15 * Bug fixes in pause/resume (uniaud16)
     16
     17 * Application level buffer underrun detection and recovery (uniaud16)
     18
     19 * Driver level underrun detection and attempted recovery (uniaud32
     20   and uniaud16)
     21
     22 * Removed all debug output from release versions (uniaud16 and uniaud32)
     23
     24 * Bug fixes for sound capture.
     25
     26 * Various trap and hang fixes.
     27
     28 * All above changes by David Azarewicz
    429
    530
    … …  
    833 * Improved ACPI support, with better support for high IRQ's,
    934    [Pavel Schtemenko]
    10    
     35
    1136 * Improved interrupt handling and fixes for stream processing
    1237    [Rich Jerant]
    13  
     38
    1439 * No longer leaves devices in "improper state" (ticket #102)
    1540    [Paul Smedley]
    16    
     41
    1742 * Fixed trap on shutdown with SB Live (ticket #109)
    1843    [Brendan Oakley]
    19    
     44
    2045 * Simplified, self-contained install, and a new uninstaller
    2146    [Lars Erdmann]
    22    
     47
    2348 * Revised, and more correct and thorough "README" documentation.
    2449    [Lewis Rosenthal]
    … …  
    2651 * No longer includes support for HDA.
    2752    Please use Paul's 1.9.x Uniaud32.sys for HDA hardware.
    28    
     53
    2954===== 1.1.4RC6: April 6, 2008 =====
    3055

  • OCO/trunk/install/README.DEBUG

    r415 r510  
     1Description of This Package
     2---------------------------
    13
    2 Uniaud Debug Package 1.1.4RC6
     4This package is intended to aid in the debugging of Uniaud. It includes
     5both the release and the debug versions of the Uniaud audio drivers
     6(uniaud16.sys and uniaud32.sys).
    37
    4 This package is intended to aid in the debugging of Uniaud. It includes:
     8The production version in the Release directory is compiled without debug
     9output statements and is intended for production use.
    510
    6  *  Uniaud32.sys and uniaud16.sys built with DEBUG enabled, from the same source in the same manner
    7         as the release.
    8 
    9  *  Accompanying map and sym files for use with a debugger or for referencing symbols from the ALSAHLP$ log.
     11The debug version in the Debug directory is compiled with debug output
     12statements enabled, and is intended to be used in situations where there
     13is a problem and additional debug information is requested from a developer.
     14The Debug directory also contains MAP and SYM files for use with a debugger.
    1015
    1116
    12 Changes from 1.1.4RC6
     17Installation
     18------------
    1319
    14  *  No changes with respect to debug builds
     20You must already have Uniaud installed to use this package.
    1521
    16  *  Make clean target works now
     22To install the debug version, simply copy the contents of the Debug directory
     23to the \MMOS2 directory on your boot disk and reboot.
     24For example: "copy Debug\* d:\mmos2".
     25
     26To install the production version, simply copy the contents of the Release
     27directory to the \MMOS2 directory on your boot disk and reboot.
     28For example: "copy Release\* d:\mmos2".
     29
     30You may wish to backup your existing uniaud16.sys and uniaud32.sys files in
     31the \MMOS2 directory first.
    1732
    1833
    19 Note that the Uniaud project consists of several components. Only the Uniaud32.sys driver component is
    20 distributed under the terms of the GNU General Public License Version 2. The text of the license is in
    21 COPYING.
     34How to use the debug version
     35----------------------------
    2236
    23 To use the debug versions, make a backup copy of your Release uniaud32.sys and uniaud16.sys and copy one
    24 or both of the included debug versions in their place. They output more information to the alsahlp$ log
    25 than the Release. To create the log file, open an OS/2 command prompt and enter:
     37To use the debug versions, make a backup copy of your Release uniaud32.sys and
     38uniaud16.sys and copy the debug versions in their place. They debug versions
     39output information to the alsahlp$ log and the release versions do not.
     40
     41To gather all the information needed to report a problem, download UniLog.cmd
     42from the netlabs ftp:
     43
     44ftp://ftp.netlabs.org/pub/uniaud/UniLog.zip
     45
     46To create the log file, simply run UniLog.cmd, type a simple 1 line description
     47of the problem, and include the resulting zip file with your problem report.
     48
     49To only see the alsahlp$ information yourself, you can open an OS/2 command
     50prompt and enter:
    2651
    2752 copy alsahlp$ uniaud.log
    2853
    29 Compiling Uniaud32 requires OpenWatcom 1.7. Either ilink 5.0 or wlink may be used. To use wlink, set
    30 USE_WLINK=1 before building. Note also that you must have the DDK and the OS/2 Developer's Toolkit
    31 installed.
     54However this log does not contain enough information to debug a problem, so always
     55use the UniLog.cmd program to produce logs to include with a problem report.
    3256
    33 Uniaud32 can be built with or without ACPI. The acpidrv.lib api library is required for ACPI support.
     57The Uniaud project site is http://svn.netlabs.org/uniaud. The user mailing list
     58is uniaud-user@netlabs.org, and the developer's mailing list is uniaud-dev@netlabs.org.
     59To subscribe, append "-subscribe" to the portion of the address before the @. The
     60lists are archived on Gmane.org.
    3461
    35 To build, first run Configure.cmd. Then run !m_kee.cmd, !m_w4.cmd, or !m_kee_debug.cmd.
    36 
    37 The Uniaud project site is http://svn.netlabs.org/uniaud. The user mailing list is uniaud-user@netlabs.org,
    38 and the developer's mailing list is uniaud-dev@netlabs.org. To subscribe, append "-subscribe" to the
    39 portion of the address before the @. The lists are archived on Gmane.org.
    40 
    41 See also UniInfo.zip, for easily gathering data about a problem for reporting, available from Netlabs FTP.

  • OCO/trunk/install/README.TXT

    r409 r510  
    2828with integrated audio, built during or after 2004.
    2929
    30 HDA is currently better supported in the experimental builds of uniaud32.sys
    31 which may be downloaded from Paul Smedley's download page:
    32 
    33   http://download.smedley.info
    34 
    35 Look for the latest uniaud32-1.9.x build, and see installation notes, below.
    36 
    3730Uniaud also supports some legacy audio hardware.
    3831
    … …  
    5649through the process.
    5750
    58 If you are not installing support for an HDA card, then simply reboot at the
    59 end of the installation; you are likely done (restarting the desktop will not
    60 suffice, as the driver needs to be loaded from CONFIG.SYS). If you are
    61 installing HDA support, then one file must be overlaid (see the next section
    62 for details). DO NOT REBOOT FOLLOWING THE INITIAL INSTALLATION.
    63 
    64   2.3 Installing HDA Support
    65   ----------------------------
    66 
    67 To provide HDA support, you should download the (experimental) HDA-enabled
    68 uniaud32.sys as mentioned above. Unzip the distribution to a safe location,
    69 peruse the readme, and copy uniaud32.sys on top of the one previously
    70 installed in your \MMOS2 directory. Once this is done, as an added precaution,
    71 you may want to disable system sounds (these have been known to cause hangs as
    72 the desktop comes up, presumably due to the overlapping of them as one event
    73 follows quickly after the other). Shut down and reboot (the driver must be
    74 loaded from CONFIG.SYS, so merely restarting the desktop will not produce the
    75 desired effect).
     51Then simply reboot at the end of the installation. Restarting the desktop
     52will not suffice, as the driver needs to be loaded from CONFIG.SYS.
    7653
    7754  2.4 Device Driver Load Options
    … …  
    128105  4.1 No Sound
    129106  --------------
    130  This is typically caused by one of two different issues. Either the speaker
     107This is typically caused by one of two different issues. Either the speaker
    131108output levels are set very low (or muted) or the audio device has not not been
    132109activated (incorrect identification, incorrect/incompatible IRQ, etc.)
    … …  
    191168  -------------------
    192169
    193 This is a close cousin to the condition described in _4.2 Distorted Sound_,
     170Looping sound is defined as a very small fraction of a second of audio playing
     171over and over very rapidly. If you have more than a fraction of a second of
     172audio repeating, such as a whole system sound repeating, that is not a uniaud
     173driver problem and is not covered here.
     174
     175Looping sound is a close cousin to the condition described in _4.2 Distorted Sound_,
    194176and in fact, is a particular type of distortion. Looping is usually caused by
    195177a card mis-detection or an IRQ conflict. Review the procedures outlined in
    … …  
    271253
    272254The best option is to use the corresponding debug package for this version
    273 of Uniaud and UniInfo.zip, both of which are available from the Netlabs ftp
     255of Uniaud and UniLog.zip, both of which are available from the Netlabs ftp
    274256site:
    275 ftp.netlabs.org/pub/uniaud .
     257ftp.netlabs.org/pub/uniaud
    276258
    277259After replacing uniaud16.sys and uniaud32.sys with their debug counterparts,
    … …  
    279261system to load the debug builds.
    280262
    281 Extract UniInfo.zip to a safe directory, and run uniinfo.cmd from there. This
    282 will generate a number of logs and will zip them into a single archive,
    283 removing the individual log files it has just created. The archive will be
    284 located in the directory from which you run uniinfo.cmd. Attach this archive
    285 to your bug report.
     263Extract UniLog.zip to a safe directory, and run UniLog.cmd from there. This
     264will create a log file and will zip it into an archive. The archive will be
     265located in the directory defined by your TMP environment variable. Attach
     266this archive to your bug report.
    286267
    287268All bug reports should go to Uniaud Trac which may be found on:
    … …  
    296277troubleshooting steps you have attempted prior to raising the ticket.
    297278
    298 Finally, per the above recommendation, attach the unilog.zip archive to the
     279Finally, per the above recommendation, attach the unilog zip archive to the
    299280ticket.
    300281
    … …  
    323304
    324305Q. I installed MIDI support, but when I click on a Midi file I hear no music.
    325    What is happening ? 
     306   What is happening ?
    326307
    327308A. Most audio cards don't support MIDI. So if there is no MIDI playback
Note: See TracChangeset for help on using the changeset viewer.