═══ 1. Copyright Notice ═══ Mwave Software. (c) Copyright IBM Corp. 1995. All rights reserved. Licensed Material - Property of IBM. This online manual is copyrighted, and all rights are reserved. No part of this manual or the products it describes may be reproduced by any means or in any form, without prior written consent in writing from IBM. ═══ 2. Welcome to Mwave ═══ Getting Started with Mwave Mwave Concepts Overview Using Mwave Games Using Fax Applications with Mwave Troubleshooting Using Readme Information Connecting Devices to the Mwave Adapter Using the Mwave Modem Using the Mwave Configuration Utility Using the Mwave Telephone Network Selection application ═══ 3. Getting Started with Mwave ═══ Mwave is a total multimedia solution which is pre-installed in your personal computer. It consists of the Mwave adapter and software. Together, the Mwave adapter and software provide the following functions to applications running on your personal computer: o A sound system with up to 16-bit 44kHz stereo playback and recording o Sound Blaster** compatibility using Mwave Games support o A telephony system providing a: - speaker phone - telephone answering machine (TAM) - facsimile (fax) modem - data modem The software for the Mwave adapter is pre-loaded in the following operating system environments: o DOS o OS/2 Warp o Windows To better understand how the Mwave system works, read Mwave Concepts. ═══ 3.1. Mwave Features for Windows ═══ Mwave runs under the following Windows environments: o Windows 3.1 or 3.11 o Windows for Workgroups 3.1 or 3.11 o Win-OS/2 under OS/2* Warp. In the Windows environment, the Mwave adapter and software provide the capability for you to run applications that use the following: o Fax and data modem o Games features o Speaker phone and TAM o Country selection for worldwide telephony ═══ 3.2. Mwave Features for OS/2 Warp ═══ In the OS/2* Warp environment, the Mwave adapter and software provide the capability for you to run applications that use the following: o Fax and data modem o Games features o Speaker phone and TAM o Country selection for worldwide telephony ═══ 3.3. Mwave Features for DOS ═══ Mwave runs in under DOS 5.0 or later. In the DOS environment, the Mwave adapter and software provide the capability for you to run applications that use the following: o Fax and data modem o Games features o Country selection for worldwide telephony ═══ 4. Using Mwave Speaker Phone and TAM Features ═══ Mwave software includes device drivers that provide the following functions: o Full duplex speaker phone that enables you to talk and listen on the telephone at the same time using either the telephone handset, headset, or microphone and speakers o TAM functions that enable you to record and playback telephone messages locally or remotely ═══ 5. Using Fax Applications with Mwave ═══ Mwave supports fax modem transfer using class 2 fax. Ongoing testing is being done to determine compatibility between Mwave class 2 fax support and many class 2 fax applications. For more information about which class 2 fax applications have been tested, see the Readme. To view the Readme, go to the Mwave group and click on the icon. ═══ 6. Mwave Concepts Overview ═══ Select the following headings for information about specific aspects of the Mwave adapter and software: o Understanding Functions Provided by Mwave o Understanding the Mwave Hardware Platform o Understanding Mwave System Software o Understanding Mwave Device Drivers o Understanding Dynamic Resource Allocation ═══ 6.1. Understanding the Functions Provided by Mwave ═══ The Mwave adapter and software provide the following functions: o Sound Blaster** compatible emulation for games o Support for playing MPEG waveform files o Modem data transfer at rates of 2400 bps, 14 400 bps, and 28 800 bps using the Mwave Modem o Modem fax transfer at 14 400 bps using the Mwave Modem o Software configuration of hardware settings using the Mwave Hardware Configuration Utility o Support for worldwide telephony using the Mwave Telephone Network Selection application ═══ 6.2. Understanding the Mwave Hardware Platform ═══ The Mwave hardware platform features a DSP specifically designed to meet the demands of multimedia processing. An Mwave DSP can integrate on one chip many of the on-board peripherals required for multimedia application. Instead of requiring separate cards or physical devices to provide multimedia functions such as fax modem, data modem, games support and audio support, the Mwave DSP (in conjunction with the Mwave software) can provide all these functions on a single adapter card. ═══ 6.3. Understanding Mwave Software ═══ Mwave software consists of device drivers for Microsoft** Windows, Operating System/2* (OS/2*) Warp, and DOS, and software. The system software consists of an Mwave manager that runs on the PC and a real-time, multitasking Mwave operating system and virtual hardware tasks that run on the DSP and peripheral hardware. These interfaces make the multimedia capabilities of any PC with an Mwave adapter and software appear merely as extensions to Windows, OS/2 Warp, or DOS. ═══ 6.4. Understanding Mwave Device Drivers ═══ Mwave device drivers are MCI-compliant device drivers that provide the software interface between the application programs running on the PC and the Mwave manager, enabling a single Mwave application to run on a variety of Mwave platforms. The Mwave device drivers include the: o Mwave audio device driver o Mwave telephony devices drivers including modem, FAX and TAM device drivers o Mwave games device driver Application programs call an Mwave device driver when they want to access the multimedia functions provided by that device driver. For example, a fax application calls the FAX device driver when it wants to send or receive a fax. The device driver then sends a message to the Mwave manager, which loads the DSP tasks function requested. The Mwave/OS then schedules when each task can run on the DSP. The task runs and the function is provided to the application program. When more than one device driver wants to load and run DSP tasks at the same time, the Mwave/OS schedules the tasks based on the priority assigned to the driver by the DRA facility. For more information, read Understanding Dynamic Resource Allocation. ═══ 6.4.1. Mwave Audio Device Driver ═══ The Mwave audio device driver provides the following services: o Waveform audio services provide recording and playback of PCM waveform audio data. o MIDI audio services provide support for playback of MIDI data through the Mwave internal synthesizer. o Auxiliary audio device services provide playback of compact disk audio from a CD-ROM disc drive. o MPEG audio services supply Windows and OS/2 device drivers that decode 44 kHz MPEG levels 1 and 2 audio. To use this function, you must have MPEG wave files or an application that uses Windows or OS/2 device drivers to play MPEG audio. Mwave MPEG audio is not ReelMagic** hardware compatible. ═══ 6.4.2. Mwave Telephony Device Drivers ═══ The Mwave telephony device drivers include: o FAX device driver that provides fax send and receive functions and controls the Mwave fax modem. o TAM device drivers for Phone Line and Message. The Phone Line device driver controls all operations that involve the telephone line, such as making a call, answering a call, and remotely reviewing or recording a message. The Message device driver controls the local review and recording of messages. o Modem device driver that provides modem function that enables you to send and receive data or fax information at transfer rates or 2400 bps, 14 400 bps, or 28 000 bps. The modem device driver supports Hayes** AT and S-register commands. (see the help for the Mwave Modem for more information. To access help, double click the Mwave group, then double click the Mwave Modem icon. The Mwave Modem appears. Click the Help pull-down and then click Contents.) The FAX and modem device drivers can operate at different levels of service, depending on how many other applications that use the DSP are running at the same time. These device drivers can operate at a maximum transfer rate of 28 800 bps and a minimum transfer rate of 2400 bps. The default modem transfer rate is set to 14 400 bps to allow rapid transfer and enable other applications that use the DSP to run at the same time. ═══ 6.4.3. Mwave Games Device Drivers ═══ The Mwave games device driver provides support for Sound Blaster** games and audio and allows your computer to work as if a Sound Blaster card is installed. The Mwave games device driver provides support for: o Sound Blaster games o Sound Blaster Pro games o Sound Blaster Pro games with Qsound See Setting Mwave Games Mode for more information. ═══ 6.5. Understanding Dynamic Resource Allocation ═══ Dynamic resource allocation is a feature which reduces conflicts between device drivers competing for DSP resources. By assigning different priorities to the device drivers, the Dynamic Resource Allocation (DRA) facility enables Mwave to transparently control resource allocation and enable device drivers that would otherwise cause conflicts to run at the same time. Resource allocation is based on: o the priority of the device driver entering the system and o the amount of DSP resources that the driver requires to operate. DSP resource consumption also corresponds to the level of service provided by the Mwave device driver. Higher levels of service correspond to faster or more complex functions and generally consume more DSP resources than lower levels of service, which correspond to slower or simpler functions. For example, when the Mwave Modem operates at 28 800 bps, the device driver consumes more DSP resources than when it operates at 14 400 bps or 2400 bps. Similarly, when the MIDI driver provides 32 voice support, it consumes more DSP resources than when it provides 24 or 16 voice support. When one device driver is loaded and consuming DSP resources and another device driver attempts to load: 1. The DRA facility evaluates the priority of each device driver and allocates resources. 2. The device driver with higher priority is allowed to operate at the level of service requested. 3. The DRA facility forces the other device driver to reduce its level of service to accommodate the resource needs of the higher priority driver. In some cases, the DRA facility must force the other device driver to stop temporarily to free sufficient DSP resources. For example, suppose that the high priority driver is the Mwave Modem operating at 28 800 bps and the lower priority driver is Mwave Audio providing 24-voice support for MIDI. The DRA facility allows the Mwave Modem driver to operate at 28 800 bps and forces the Mwave Audio driver to reduce its support from 24-voices to 16-voices to 8-voices as necessary to free resources. When the Mwave Modem driver ceases to consume as many resources, the DRA facility allows the Mwave Audio driver to dynamically increase its level of service according to resource availability to return to 24-voice support. ═══ 7. Troubleshooting ═══ ┌───────────────────────────────────┬───────────────────────────────────┐ │IF THE PROBLEM IS: │HERE'S WHAT TO DO: │ ├───────────────────────────────────┼───────────────────────────────────┤ │I don't hear sound from my audio │Set the modem to operate at a lower│ │application when I start the modem.│transfer rate. │ ├───────────────────────────────────┼───────────────────────────────────┤ │I can't play games, telegame, or │Close all DOS boxes running under │ │use the modem in a DOS box under │OS/2 Warp, then re-open a DOS box. │ │OS/2* Warp. │Start all games in this first DOS │ │ │box. │ └───────────────────────────────────┴───────────────────────────────────┘ ═══ 8. Using Readme Information ═══ The Readme includes last minute information about the Mwave adapter and system software. The Readme also provides: o A list of frequently asked questions o Information about what to do before you call for help o Compatibility information o Installation error information o Technical notes Be sure to read the Readme before calling for help. Click on the icon in the Mwave group to view the Readme. ═══ 9. Connecting Devices to the Mwave Adapter ═══ You can connect the following devices to the Mwave adapter: o Joystick (up to 2 joysticks when you use a MIDI breakout plug) o MIDI devices o Line input devices, including external CD players, tape players, or other audio playback devices o Line output devices, including powered speakers or audio recording devices o Telephony devices, including - industry standard telephone handset - headset or microphone - line for fax or data modem o Microphone Click on the icon in the Mwave group to view a picture of the connectors on the back of the adapter. ═══ 10. Using the Mwave Modem ═══ Setting Mwave Modem Speed in DOS Setting Mwave Modem Speed in OS/2 Warp The Mwave Modem is a fax and data modem that runs in the DOS, Windows 3.1, Win-OS/2, and OS/2* Warp operating environments. The Mwave Modem starts automatically when DOS, Windows, or OS/2 Warp is started. When you open any application that requires a fax or data modem for communication (for example, WinFax Pro for Windows or ProComm Plus for DOS), the Mwave Modem begins to consume DSP resources on your Mwave adapter. Therefore, when you finish using an application that requires the Mwave Modem, you should close the application instead of minimizing it. This allows the Mwave Modem to free system resources for other applications to use. ═══ 10.1. Setting the Mwave Modem Speed in OS/2 Warp ═══ By default, the Mwave Modem is set to 28 800bps. To change the speed of the Mwave Modem: 1. Locate the Mwave Modem icon in the Mwave group on your desktop. 2. Double click the Mwave Modem icon. The Mwave Modem window appears. 3. From the menu bar, click on the Options pull-down menu, and then click on Settings.... The Options window appears. Click 2400, 14 400, or 28 800 to set the speed for this session only. You can also select or deselect the Start Hidden checkbox. Click OK to close the window. 4. Minimize the Mwave Modem window. The Mwave Modem keeps the new setting until you change the setting again. ═══ 10.2. Setting the Mwave Modem Speed in DOS ═══ To change the speed of the Mwave Modem: 1. Use FASTCFG to change DOS settings. 2. Set the application type to Advanced Modem to use the 28.8 Kbps modem or to Telegame to use the 14.4 Kbps fax modem. 3. Click OK to update the values and exit. Note If you run FASTCFG in a DOS box, the changes you make are not applied until you exit Windows and return to native DOS. ═══ 11. Using the Mwave Telephone Network Selection Application ═══ Setting the country in OS/2 Warp Setting the country in DOS Use the Mwave Telephone Network Selection application to indicate the public switched telephone network (PSTN) to which you are connecting the Mwave adapter. The default is US and Canada. By using this application to set the country, you tell your Mwave telephony device drivers what telephone network you are using. The Mwave telephony device drivers include modem, FAX, speaker phone, and TAM. These device drivers use the Network selection information to permit safe and reliable connection to the telephone network. ═══ 11.1. Setting the Country in OS/2 Warp ═══ Warning Improper selection of the telephone network may cause your Mwave telephone applications to operate unreliably. Make sure that the country you select using the Telephone Network Selection application is the actual country for the telephone network to which your computer is connected. For OS/2* Warp, follow these steps to set the country selection: 1. Open the Mwave group on your desktop and double click the Select Country icon. The Mwave Telephone Network Selection window appears. 2. Use the scroll bar to view the country values in the list box. Then use the mouse to select a country. The selected value is highlighted. 3. Press the OK push button to select the value and close the window. 4. Shut down any open applications and press CTRL+ALT+DEL to reboot your system. The changes you made do not take effect until the system is restarted. ═══ 11.2. Setting the Country in DOS ═══ Warning Improper selection of the telephone network may cause your Mwave telephone applications to operate unreliably. Make sure that the country you select using the Telephone Network Selection application is the actual country for the telephone network to which your computer is connected. For DOS, follow these steps to set the country selection: 1. At the DOS command prompt, type country and then press Enter. The Mwave Telephone Network Selection information appears. 2. Use the up and down cursor keys to scroll through the list of country values. The currently selected value is highlighted. To select a country, move the cursor to the country and then press Enter. The selected value is highlighted. To cancel a selection, press Esc. 3. Press Enter to select the value and exit the program. 4. Press CTRL+ALT+DEL to reboot your system. The changes you made do not take effect until the system is restarted. ═══ 12. Using the Mwave Configuration Utility ═══ Changing the Hardware Configuration The Mwave Configuration Utility enables you to view and change the Mwave hardware values (such as DMA or IRQ settings that the hardware devices use). The Configuration Utility is available in DOS, Windows, and OS/2* Warp. ═══ 12.1. Changing the Mwave Hardware Configuration ═══ Warning Changing the Mwave hardware configuration or adding other adapters or devices to your PC may cause system conflicts. Before you change the Mwave hardware configuration or add other adapters or devices, make sure you know how each existing device is configured. The Mwave Hardware Configuration Utility enables you view and change your Mwave hardware configuration. Because the Mwave adapter is pre-installed in your PC, the default hardware configuration is known to be compatible with the other adapters and devices that also are pre-installed. You might need to change the Mwave hardware configuration when you add another adapter or device that conflicts with the default Mwave hardware configuration. Otherwise, you should not change the Mwave hardware configuration. To change the Mwave hardware configuration: 1. Start the Configuration Utility. o In OS/2* Warp, open the Mwave group on your desktop and double click the Hardware Configuration icon. o In DOS, type MWCONFIG at the DOS prompt and press Enter. The Configure Mwave Adapter Hardware Settings window appears. The selected value for each parameter is displayed the right of the parameter. To access help for any value, click on that value and press F1, or press the Help push button. 2. To change a parameter value, use the mouse to click the arrow to the right of the value. A list box appears. Click on the new value and then close the list box. The new value displays. To display additional parameters, click the Advanced push button. The values that appears have been preconfigured to maximize system performance. You should not change these values. After you modify the values to customize your Mwave hardware configuration, click the Update push button. To exit the utility, click on the Exit push button. 3. Shut down any open applications. 4. Press the power button on the front of your system unit to power the system off. Then press the power button again to power the system on. The changes you made are applied. ═══ 13. Mwave Games Support ═══ Introducing Mwave Games Support Using Mwave for Games in DOS Using Mwave for DOS Games in OS/2 Warp Setting Mwave Games Mode Note: For best performance from DOS games, it is recommended that you play the games in native DOS. ═══ 13.1. Introducing Mwave Games Support ═══ Mwave provides support for Sound Blaster** compatibilty for games and audio in native DOS, DOS sessions running under Windows, and DOS sessions running under OS/2* Warp. Mwave Games is not an application; it is a driver that allows your computer to work as if a Sound Blaster card is installed. With Mwave, you can play DOS-based games that require a Sound Blaster card. Mwave handles all the high quality digital sound provided by the game. You can control the capabilites of Mwave Games using the Mwave DOS Software Settings utility. See Setting Mwave Games Mode for more information. ═══ 13.2. Using Mwave for Games in DOS ═══ For best performance from DOS games, it is recommended that you play the games in native DOS. When you open a native DOS session, basic Sound Blaster** emulation is enabled by default. You can also enable Sound Blaster Pro emulation using the Mwave DOS Software Settings utility. See Setting Mwave Games Mode for more information. ═══ 13.3. Using Mwave for DOS Games in OS/2 ═══ Mwave provides OS/2* Warp with support for Sound Blaster-compatible DOS games running in a DOS Full Screen session. Note: Mwave only provides games support in the first DOS session you open from OS/2 Warp. Configuring Games Running in a DOS Session under OS/2 To configure a DOS game under OS/2: 1. Position the mouse pointer over the DOS Full Screen icon, then press the right mouse button. 2. From the menu that appears, click on DOS Sessions. 3. Make sure All DOS Settings is selected, then click OK. 4. Make sure the following options are set: HW_TIMER is ON; VIDEO_8514A_XGA_IOTRAP is Off; INT_DURING_IO is On. To change a DOS setting option, select the desired setting, then click On or Off, as appropriate. 5. Click Save. ═══ 13.4. Setting Mwave Games Mode ═══ Mwave configures its games support based on the settings specified in the Software Configuration Utility. You can configure Mwave in one of two ways: o Basic Sound Blaster** emulation, which includes FM Synthesized sound. With this setting, you can simultaneously operate the 14.4 Kbps modem. o Sound Blaster Pro emulation with the option to set QSound, reverb, and chorus effects. Although you cannot operate the Mwave Modem with this setting, Sound Blaster Pro with effects provides optimum quality to the sound produced by your DOS-based games. See Changing Mwave DOS Software Settings for complete information on changing the configuration of the Mwave software. ═══ ═══ Mwave supports handset that meet the following requirements: o Analog handset o DTMF touch-tone generation (no rotary or pulse tone handsets) ═══ ═══ Mwave supports headsets that meet the following requirements: o Dynamic headset or electret type headset operational with phantom power present at the tip o Monophonic miniature plug (1/8 inch) to attach to the microphone port (1/4 inch plugs use a converter; stereo miniature plugs use a converter to convert to monophonic) o Standard miniature monophonic plug (1/8 inch) to attach to the line out port (1/4 inch plugs use a converter; stereo miniature plugs use a converter to convert to monophonic) ═══ ═══ Mwave supports microphones that meet the following requirements: o Monophonic miniature plug (1/8 inch) to attach to the microphone port (1/4 inch plugs use a converter; stereo miniature plugs use a converter to convert to monophonic) o Dynamic headset or electret type low impedance (nominal impedance of 600 ohms) microphone operational with phantom power present at the tip ═══ ═══ Discrimination is the process of monitoring an incoming telephone call to determine whether the call is destined for a voice application, a data modem application, or a fax modem application. ═══ ═══ Peripheral hardware refers to devices attached to the DSP to provide functions such as switching capability or signal conversion. ═══ ═══ A digital signal processor (DSP) is a special-purpose microprocessor designed specifically to handle processing of real-time signals. ═══ ═══ A DSP task is a program running in the DSP under Mwave/OS that performs a particular function or process. Multiple tasks may be run on the DSP under control of Mwave/OS. ═══ ═══ Mwave Operating System (Mwave/OS) is the real-time, multitasking DSP program that allows concurrent processing of virtual hardware tasks. Mwave/OS schedule the DSP tasks to maximize concurrency. ═══ ═══ Device drivers are programs that enable the application programs running on the PC to communicate with a specific peripheral device; for example, MIDI audio devices, wave audio devices, fax modem, data modem, telephone answering machine, or a CD-ROM drive. ═══ ═══ The following terms are trademarks of IBM: Operating System/2 OS/2 IBM Aptiva ═══ ═══ personal computer (PC) ═══ ═══ The Mwave manager is PC-based software that manages DSP resources and provides a hardware-independent interface layer between the Mwave device drivers and the underlying Mwave hardware. ═══ ═══ DSP resources refer to the system resources available for use by the DSP and include DSP register space, memory (instruction store and data store), bandwidth on the ISA bus, and the number of MIPS that can be processed. ═══ ═══ Millions of instructions per second (MIPS) are one characteristc of a DSP used to measure performance. ═══ ═══ The Media Control Interface (MCI) is a Microsoft** Windows standard interface used for controlling internal and external media devices. ═══ ═══ Musical instruments digital interface (MIDI) is a standard for the communication of musical control information from MIDI devices. ═══ ═══ Waveform audio refers to a stream of digitized audio samples produced by an audio source. It is synonymous with digital audio. ═══ ═══ pulse code modulated (PCM) ═══ ═══ telephone answering machine (TAM) ═══ ═══ Contention refers to a situation in which two or more device drivers are trying to load and use DSP resources at the same time. Without dynamic resource allocation, contention results in an error situation in which one or more of the device drivers cannot load. This would return an error to the application that requested the functions provided by the device drivers. ═══ ═══ Level of service refers to the quality of the function provided by the device driver. For example, the Mwave Modem device driver can operate at 3 levels of services which correspond to modem transfer rates of 2400 bps, 14 400 bps, and 28 000 bps. ═══ ═══ The CCITT standards body is now know as ITU-T. ═══ ═══ MNP is a registered trademark of Microcom, Inc. ═══ ═══ Hayes is a trademark of the Hayes Microcomputer Products, Inc. ═══ ═══ The following terms are trademarks of their respective companies in the United States or other countries: This term... Is a trademark of... Sound Blaster Creative Labs Microsoft Microsoft Corporation Hayes Hayes Microcomputer Products, Inc. Microcom Network Protocol Microcom, Inc. MNP Microcom, Inc. Compuserve Compuserve, Inc. and H and R Block, Inc. America Online America Online, Inc. Prodigy Prodigy Services Company ReelMagic Sigma Designs ═══ ═══ Concurrency refers to the number of applications that use the DSP that can run at the same time. ═══ ═══ Direct Memory Access (DMA) is a technique used to transfer data directly between memory and hardware devices. DMA transfers occur without the CPU saveng as an intermediary and are preferred when using high-speed applications. ═══ ═══ Interrupt Request (IRQ) is a software code sent to the CPU that controls programming activity or system resources. ═══ ═══ Central Processing Unit (CPU) is the part of the computer that includes circuits that control the interpretation and execution of instructions. ═══ ═══ Power on reset (POR) requires that you shut down the operating system and then turn off the system power. Then turn the system power on and restart the system. ═══ ═══ Error Corrected Link. ═══ ═══ Motion Picture Experts' Group.