Changeset 392


Ignore:
Timestamp:
Oct 9, 2008, 3:55:26 AM (17 years ago)
Author:
Brendan Oakley
Message:

Readme updates, from Lewis

File:
1 edited

Legend:

Unmodified
Added
Removed

  • OCO/trunk/install/README.TXT

    r341 r392  
    22========================================================================
    33
    4 Thank you for downloading Uniaud
    5 Uniaud is still under development and we need your feedback to improve
    6 uniaud. Its very important that you also report soundcards that work!
     4Thank you for downloading Uniaud, the Universal Audio Support Driver for
     5OS/2 and eComStation. Uniaud is still under development and we need your
     6feedback to improve it. It is very important that you report your experiences,
     7both for sound cards which work and for those which may have problems (see
     8Supported Hardware).
    79
    8 Uniaud is project created by InnoTek Systemberatung GmbH
     10Uniaud was a project created by InnoTek Systemberatung GmbH, now hosted
     11by Netlabs.
    912
    1013Uniaud is based on the Linux ALSA project. Uniaud supports a broad range
    11 of PCI audio cards/chipsets and AC 97 audio codecs. AC 97 audio codecs
    12 you will find in modern systems with a Pentium II or higher build onto the
    13 motherboard. AC 97 depends for a part of the motherboard chipset
    14 and a small audio codec.
     14of PCI audio cards/chipsets, including AC'97 and HDA audio codecs. AC'97
     15audio codecs will be found in systems with integrated (onboard) audio,
     16typically built up through 2004. HDA codecs will be found in modern systems
     17with integrated audio, built during or after 2004.
    1518
    16 Uniaud supports most audio chipsets on the market.
     19Uniaud also supports some legacy audio hardware.
    1720
    1821How to report bugs
    … …  
    2023
    2124The best option is to use the corresponding debug package for this version
    22 of Uniaud, and UniInfo.zip, both available from Netlabs ftp.
     25of Uniaud and UniInfo.zip, both of which are available from the Netlabs ftp
     26site:
     27ftp.netlabs.org/pub/uniaud .
    2328
    24 All bug reports should goto Uniaud Trac which
    25 can be found on: http://svn.netlabs.org/uniaud/report
    26 If you do not have a login, you can login as guest with password netlabs.
     29All bug reports should go to Uniaud Trac which may be found on:
     30http://svn.netlabs.org/uniaud/report . If you do not have your own login
     31credentials, you can request one at:
     32http://www.netlabs.org/en/site/member/member.xml .
    2733
    28 Describe your bug briefly. Most importantly include the following files:
     34Describe your bug briefly, but be as specific as possible. If your system has
     35some exotic hardware which may or may not be involved, mention this in your
     36report. Describe whatever steps you deem necessary to recreate the condition,
     37whether the condition occurs sometimes, always, or very rarely. Mention any
     38troubleshooting steps you have attempted prior to raising the ticket.
    2939
    30 1. If your system boots, but you don't get sound or sound is broken
    31 or played to fast, goto an OS/2 command line. And type the following:
    32 "copy alsahlp$ uniaud.log".
    33 
    34 2. Next from the command line run "unimix.exe -list >mixer.txt".
    35 
    36 3. Download pci.exe Veit Kannegieser from
    37 http://hobbes.nmsu.edu/cgi-bin/h-browse?sh=1&dir=//pub/os2/util/misc
    38 In this directory you will find a file called
    39 pciXXXvka.zip. Where XXX is the version number. Use the search option
    40 in your webbrowser to search this page for the text PCI.
    41 Download this file and unzip it in a directory.
    42 From a command line run PCI.EXE >hardware.txt.
    43 This will generate an overview off all hardware in your system.
    44 
    45 When you have entered your bug in Track you can attach the files to
    46 the bug via your web browser.
     40Finally, per the above recommendation, attach the unilog.zip archive to the
     41ticket.
    4742
    4843What todo with a TRAP screen:
    4944=============================
    5045
    51 If you get a TRAP (a black screen with for example
    52 TRAP 000e) after you installed UNIAUD. You should only do this
    53 if you have a floppy drive in your system or a memory dump partition
    54 (we provide no support on how to put up this last item).
     46N.B.: You should only do this if you have a floppy drive in your system or a
     47memory dump partition. Support and directions for setting up the latter are
     48beyond the scope of this document, but detailed instructions may be found at
     49the following url:
     50http://home.earthlink.net/~steve53/os2diags/TrapDumpRef.txt
    5551
    56 Press CTRL ALT F10 twice (note never do this on a running system!!).
    57 You will now be asked to insert a diskette (please note the complete
    58 diskette will be wiped!!). You _only_ need to fill up one diskette
    59 to get the trap screen. Then restart your system, you can run this script:
    60 http://home.earthlink.net/~steve53/os2diags/DumpTrapScreen.zip
    61 to extract the trap s creen from the diskette.
     52      1. Press Ctrl-Alt-F10 twice (note never do this on a running system!!).
     53         You will be asked to insert a diskette (please note the complete
     54         diskette will be wiped!!). You _only_ need to fill up one diskette to
     55         get the trap screen.
     56      2. Insert the diskette.
     57      3. When prompted to insert the next diskette, reboot with Ctrl-Alt-Del,
     58         and either allow the system to boot normally, or follow one of the
     59         recovery procedures outlined above to temporarily disable Uniaud.
     60      4. Upon a successful boot, you may download and run this script:
     61         http://home.earthlink.net/~steve53/os2diags/DumpTrapScreen.zip to
     62         extract the trap screen from the diskette.
    6263
     64Trap screen data is extremely helpful when raising a support ticket.
    6365
    6466F.A.Q.
    6567=====
    6668Q. What is OS/2?
    67 A1. If You ask this You really don't need UniAud.
    68 A2. Go to: www.eComStation.com.
     69A. If you ask this one, you probably don't need UniAud. Go to
     70 www.eComStation.com to get more information or to purchase a license.
    6971
    70 Q. What is UniAud?
    71 A. The UniAud project is the universal audio driver for OS/2 or eComStation OS,
    72    based on ALSA project
     72Q. What is Uniaud?
     73A. Uniaud is the Universal Audio Support driver for OS/2 and eComStation,
     74   based on the Linux ALSA project (http://www.alsa.com ).
    7375
    74 Q. Uniaud detected my card successfully but no sound
     76Q. Uniaud detected my card successfully but I have no sound
    7577A. Try to install uniaud with amount of installed cards = 0 (see section below)
    7678   reboot and then install uniaud with amount of cards = 1
    … …  
    9597========================
    9698
    97 If Uniaud is already installed, it is safest to make a backup of your old
    98 drivers and just copy uniaud32.sys and uniaud16.sys over them.
     99If Uniaud is already installed, it is safest to make a backup of your existing
     100drivers located in x:\MMOS2 (where x: is your boot volume) and just copy
     101uniaud32.sys and uniaud16.sys over them.
    99102
    100103Otherwise:
    101104
    102 Start install.cmd and click on click on yes or OK where requested by
    103 minstall. You will get 1 or 2 dialogs where you can toggle the amount
    104 of installed cards between 0 to 1. This is set by default to
    105 1 don not change this setting. After minstall is finished reboot your
    106 system.
     105Uniaud installs using the built-in multimedia installer in OS/2 or
     106eComStation. Therefore, once you have downloaded the file(s) mentioned above,
     107simply unzip the package to a safe place and run install.cmd from that
     108directory. This will launch the multimedia installer which will guide you
     109through the process.
    107110
    108 If you are having loops in the sound (when audio is played).
    109 Or you get lockups of your system or a kerneltrap, do the following.
    110 Restart your system. And when in he upper left hand in the corner
    111 of the screen you see a white little blob. This little blob
    112 is shown before the boot logo (with the OS/2 or eComStation logo is shown).
    113 Press the key combination ALT F1. Then choose from the "Recovery Choices"
    114 choose "F5 full hardware detection".
     111If you are not installing support for an HDA card, then simply reboot at the
     112end of the installation; you are likely done (restarting the desktop will not
     113suffice, as the driver needs to be loaded from CONFIG.SYS). If you are
     114installing HDA support, then one file must be overlaid (see the next section
     115for details). DO NOT REBOOT FOLLOWING THE INITIAL INSTALLATION.
    115116
    116 You can check the so called buildlevel of the Uniaud32.sys
    117 and uniaud16.sys by typing bldlevel.exe driveletter:\MMOS2\UNIAUDXX.SYS
    118 and you will see the buildlevel of the files you have.
    119 If you already have UNIAUD installed and you have updated drivers
    120 you can copy the UNIAUD16.SYS and UNIAUD32.SYS to \MMOS2 manualy.
     117To provide HDA support, you should download the (experimental) HDA-enabled
     118uniaud32.sys as mentioned above. Unzip the distribution to a safe location,
     119peruse the readme, and copy uniaud32.sys on top of the one previously
     120installed in your \MMOS2 directory. Once this is done, as an added precaution,
     121you may want to disable system sounds (these have been known to cause hangs as
     122the desktop comes up, presumably due to the overlapping of them as one event
     123follows quickly after the other). Shut down and reboot (the driver must be
     124loaded from CONFIG.SYS, so merely restarting the desktop will not produce the
     125desired effect).
    121126
    122127How to uninstall Uniaud
    123128========================
    124129
    125 If for some reason you are having trouble with Uniaud. Putting a REM in the
    126 config.sys is not the proper way to uninstall Uniaud. Start
    127 install.cmd again. Click on yes or OK where asked and for the "amount of
    128 cards" change the 1 into a 0. After minstall is finished.
    129 Reboot your machine.
     130To temporarily disable Uniaud, simply comment the following two lines in
     131CONFIG.SYS:
    130132
    131 If already have minstall installed on your system and you are upgrading
    132 to a new release you don't need to uninstall the old version of Uniaud.
     133DEVICE=x:\MMOS2\UNIAUD32.SYS
     134DEVICE=x:\MMOS2\UNIAUD16.SYS
     135
     136To uninstall Uniaud, run install.cmd again. When prompted by the multimendia
     137installer, select the option to remove an installed feature.
    133138
    134139How can I support the project ?
    135140================================
    136141
    137 We need your feedback. Make a donation and of course report bugs.
    138 You can always get the latest version of uniaud from:
    139 ftp://ftp.netlabs.org/pub/uniaud/
     142We need your feedback! Consider making a donation, and of course, report bugs.
    140143
    141 Making a donation to the project
    142 ================================
    143 Via Mensys website you can a make a financial donation:
    144 http://shop.mensys.nl/uk/netlabs
     144To make a financial contribution to the project, please visit the Mensys
     145website: http://shop.mensys.nl/uk/netlabs
    145146
    146147
    … …  
    148149========================================
    149150
    150 DEVICE=D:\MMOS2\UNIAUD32.SYS /V /C:CARDNAME
    151 - /V    Verbose
    152 - /C:CARDNAME
    153         Where CARDNAME is :
    154         - SBLIVE      : Sound Blaster Live!
    155         - CS4281      : Cirrus Logic CS4281
    156         - ALS4000     : Avance Logic ALS4000
    157         - CMEDIA      : C-Media CMI8738, CMI8338
    158         - ICH         : Intel ICHx, NFORCE1/2/3
    159         - CS46XX      : Cirrus Logic CS4280, CS46XX
    160         - VIA82XX     : VIA VT82C686A/B/C, VT8233A/C, VT8235
    161         - ESS1938     : ESS Solo-1 (ESS 1938)
    162         - MAESTRO     : ESS Maestro1/2/2E, TerraTec DMX
    163         - MAESTRO3    : ESS Maestro3/Allegro/Canyon3D-2
    164         - YAMAHA      : Yamaha YMF 724/724F/740/740C/744/754
    165         - ENSONIQ     : Ensoniq AudioPCI ES1371/73, Creative Labs SB PCI64/128
    166         - ALI5451     : ALI 5451
    167         - TRIDENT     : Trident 4D Wave, SI7018
    168        Force detection of specified audio hardware
     151DEVICE=x:\MMOS2\UNIAUD32.SYS /V /C:CARDNAME
     152  - /V - Verbose
     153  - /C:CARDNAME - Force detection of specified audio hardware
     154        Where CARDNAME is:
     155      - SBLIVE      : Sound Blaster Live!
     156      - CS4281      : Cirrus Logic CS4281
     157      - ALS4000     : Avance Logic ALS4000
     158      - CMEDIA      : C-Media CMI8738, CMI8338
     159      - ICH         : Intel ICHx, NFORCE1/2/3
     160      - CS46XX      : Cirrus Logic CS4280, CS46XX
     161      - VIA82XX     : VIA VT82C686A/B/C, VT8233A/C, VT8235
     162      - ESS1938     : ESS Solo-1 (ESS 1938)
     163      - MAESTRO     : ESS Maestro1/2/2E, TerraTec DMX
     164      - MAESTRO3    : ESS Maestro3/Allegro/Canyon3D-2
     165      - YAMAHA      : Yamaha YMF 724/724F/740/740C/744/754
     166      - ENSONIQ     : Ensoniq AudioPCI ES1371/73, Creative Labs SB PCI64/128
     167      - ALI5451     : ALI 5451
     168      - TRIDENT     : Trident 4D Wave, SI7018
    169169
    170 DEVICE=D:\MMOS2\UNIAUD16.SYS /V /C /M /L
    171 - /V    Verbose
    172 - /C    Enable CD output
    173 - /M    Enable Microphone output
    174 - /L    Enable Line-In output
     170Default: /V (verbose messages; card detected automatically)
    175171
     172DEVICE=x:\MMOS2\UNIAUD16.SYS /V /C /M /L
     173  - /V - Verbose
     174  - /C - Enable CD output
     175  - /M - Enable Microphone output
     176  - /L - Enable Line-In output
     177
     178Default: /V /C ((verbose messages; CD output enabled)
Note: See TracChangeset for help on using the changeset viewer.