CHAPTER 2

INSTALLING outSPOKEN FOR WINDOWS

Chapter Summary

This chapter provides step-by-step instructions on installing outSPOKEN 
for Windows. Section 2.1 indicates what to do before beginning to work 
with outSPOKEN's installer. Section 2.2 explains how to use the 
installation program, OSINSTAL.EXE. Section 2.2 is separated into three 
sections. Section 2.2.1 explains how to use the installer from the command 
line and describes the proper format of the parameters. This section is 
recommended if no DOS screen reader or sighted assistance is available. 
Section 2.2.2 gives instructions on using the interactive installer. This 
section is recommended if you do have a DOS screen reader. Section 2.2.3 
explains the meanings of the tones generated by the installer. These tones 
are extremely informative if you do not have a DOS screen reader or a 
sighted assistant. Section 2.3 explains how to install outSPOKEN without 
the installer. This section provides details about where outSPOKEN's files 
are stored, what files must be modified for proper installation, and 
alternative ways of installing and launching outSPOKEN. This section is 
not recommended for beginners. Section 2.4 gives simple instructions for 
getting started once outSPOKEN is installed. 

2.1   Before Installing outSPOKEN

Before installing outSPOKEN, whether with or without the installer, the 
following three steps must be taken.

1.   Attach your speech synthesizer to your computer according to the 
manufacturer's directions. 

2.   Install the manufacturer's speech synthesizer drivers, if any, 
according to the installation directions in the synthesizer's 
documentation. 

3.   Install Microsoft Windows on your computer with the Microsoft Windows 
master disks (not included with outSPOKEN). If you need help with this 
step, more information is available in Appendix C, "Tips on Installing 
Microsoft Windows."

Now you are ready to install outSPOKEN for Windows.

2.2   outSPOKEN's Installer

outSPOKEN's installer is a DOS application called OSINSTAL.EXE. It will not 
talk under its own power. If you are accustomed to using a DOS screen 
reader, we strongly recommend launching it before running the installer. 

outSPOKEN's installer can be used in two ways: from the DOS command line 
(Section 2.2.1) or as an interactive program (Section 2.2.2). If you do have 
a DOS screen reader, the interactive installer is the most straightforward 
method of installation. In this case, please skip directly to Section 2.2.2. 
If you are not using a DOS screen reader, and you are not able to read the 
screen without one, the installer uses a series of tones to provide feedback 
on the status of the installation process (Section 2.2.3).

The outSPOKEN installer makes changes to three files on your hard drive: 
AUTOEXEC.BAT, WIN.INI, and SYSTEM.INI. Before making any changes, the 
installer makes copies of the original files and gives them the file 
extension ".OSW". For example, the copy of AUTOEXEC.BAT is named 
AUTOEXEC.OSW. For more information about these modifications, read 
"Installing outSPOKEN Without The Installer" (Section 2.3).

2.2.1   The Command Line Installer

The easiest way to install outSPOKEN is to run the program OSINSTAL.EXE. 

Insert the outSPOKEN floppy disk into a disk drive. 

Make that drive the current one by typing its drive letter, followed by a 
colon, then pressing ENTER.

Run the installer by typing a line of the following form. A detailed 
explanation of each part of the line follows:

OSINSTAL [<outSPOKEN drive letter+path> <Windows Path> <Synthesizer 
Driver> [<Port>]]

Each piece of this command gives OSINSTAL some information about how to 
proceed with the installation. All parameters except for the final one, the 
port number, MUST be included or outSPOKEN's installer will not run 
properly. If no port is specified on the command line, OSINSTAL.EXE assumes 
a port number of 0 (indicating an internal synthesizer). Each separate 
parameter is explained below. For further clarification, see the example at 
the end of this section.

outSPOKEN drive letter+path:

This is the letter of the drive on which you want to install outSPOKEN, plus 
the directory to be created where outSPOKEN will be stored. The suggested 
location is C:\OSW. 

Windows Path:

This is the path (including drive letter) where Microsoft Windows is 
located. The most common location for Windows to be found is C:\WINDOWS.

Synthesizer Driver:

This is the name of the speech synthesizer driver needed to link your 
particular synthesizer to outSPOKEN for Windows. Below you will find a list 
of supported synthesizers and their corresponding drivers. If your 
synthesizer is not listed here, be sure to check the README file on the 
outSPOKEN program disk for the most recent list of supported synthesizers. 

Synthesizer   Driver

Accent   ACCENT.COM
Apollo   APOLLO.COM
Artic   ARTIC.COM
ASP Synthesizer   ASP.COM
Audapter   AUDAPTER.COM
Braille 'n Speak   BNS.COM
DECtalk Classic   DEC-C.COM
DECtalk PC   DECPC.COM
DoubleTalk   DOUBLE.COM
DoubleTalk-LT   DOUBLE.COM
Echo GP   ECHO.COM
KPR   DEC-C.COM
LiteTalk   DOUBLE.COM
MultiVoice   MULTI.COM
New Echo   ECHO-N.COM
PocketBraille   PB.COM
SoundingBoard   SB.COM
VoTalker   ARTIC.COM
Votrax   ARTIC.COM


Port:

This is the number of the port (usually 1-4) of your speech synthesizer if 
it is an external device. If your external synthesizer is a serial device, 
simply use the number of the com port to which it is attached. If your 
synthesizer is a parallel device, include a letter "L", with no space, 
before the number of the parallel port to which it is attached. If you have 
an internal speech synthesizer, this parameter can be omitted. 



If you've given the install program all the information it needs, the 
installation process is completely automatic. As the installation 
progresses, your computer will make several types of tones, providing 
feedback on the status of the installation (Section 2.2.3). If you are using 
a DOS screen reader, these tones can be ignored. When the installation is 
successful, a series of tones, descending in pitch, will sound, and you will 
be returned to the DOS prompt. At this point, you are ready to restart your 
computer and launch Windows. For help in getting started, see Section 2.4.

If any of the information given on the command line is incorrect, the 
installer stops at that point and proceeds with the interactive installer. 
For information about the prompts and error messages of the interactive 
installer, see the following two sections (Sections 2.2.2-3).

Example:

Command line:
OSINSTAL C:\OSW C:\WINDOWS ACCENT 1

Before typing the above command line, insert the outSPOKEN disk in the disk 
drive and type the letter of the drive, followed by a colon (no space), then 
press ENTER (e.g., A: ENTER). This makes the drive with the outSPOKEN disk 
in it the current drive. When you are prompted by the new drive letter, you 
are ready to type the above command line. The first parameter after 
"OSINSTAL" is "C:\OSW". This tells the installer to create a directory on 
the C drive called "OSW", and to copy all the outSPOKEN files to that 
directory. We recommend that you do not change this parameter. The next 
parameter, "C:\WINDOWS", tells the installer to look for Windows on drive C, 
in a directory called WINDOWS. This is the default location for Microsoft 
Windows. The third parameter, "ACCENT", specifies that the synthesizer 
driver ACCENT.COM should be used to communicate with your synthesizer. This 
parameter will vary depending on your particular synthesizer. Check the 
above list for the appropriate driver for your situation. Remember not to 
include the "COM" part of the driver name. The final parameter, "1", 
indicates that the synthesizer is attached to serial port1. 

If your outSPOKEN disk is in drive B:, change A: in the above example to B:. 
If you want to install outSPOKEN to a drive and directory other than C:\OSW, 
replace the letter C in the first parameter after "OSINSTAL" with the 
preferred drive letter, and replace the path name OSW with the desired 
directory. If Microsoft Windows is installed in a location other than 
C:\WINDOWS, replace the next parameter of this command line with the 
appropriate location. If you are using a speech synthesizer that uses a 
driver other than ACCENT.COM, change the next parameter of the command line 
from "ACCENT" to the appropriate driver (see the above list of drivers and 
synthesizers). If that synthesizer is not internal, a port number (1-4) 
should be specified as the final parameter of this command line. If the 
external synthesizer is parallel, include a letter "L" before the port 
number (e.g., "L2"). If the synthesizer is internal, you do not need to 
include the port number at the end of the command line. 

2.2.2   The Interactive Installer

This section describes how to use outSPOKEN's installer interactively. 
Remember to perform the steps in "Before Installing" (Section 2.1) prior to 
installing outSPOKEN. If you are accustomed to using a DOS screen reader, we 
recommend that you launch it before running the interactive installer. If 
you do not have a DOS screen reader, but cannot read the screen without one, 
the next section (Section 2.2.3) describes the installer's feedback tones. 
Another alternative is to have a sighted assistant available to read the 
screen. 

To run the installer, insert the outSPOKEN diskette into your A: drive, type 
the following command, and then press ENTER:

A:OSINSTAL

If the outSPOKEN disk is in a drive other than A, replace the letter "A" 
above with the appropriate drive letter.

The installer requests the following information:

   "Which drive are you installing outSPOKEN to?"

If you simply press ENTER, outSPOKEN will be installed on drive C, in a 
directory called OSW. If you wish to install outSPOKEN elsewhere, type the 
drive and path of the desired location, and press ENTER.

   "In what directory is Windows installed?"

If you simply press ENTER, the installer will look for Windows on the C 
drive, in a directory called WINDOWS. If you have Windows located elsewhere, 
enter the drive and path name of your Windows directory, and press ENTER.

   "Which speech synthesizer driver should be installed?"

The installer requests you to type the name of the driver that supports your 
synthesizer. A list of these drivers is displayed on the screen. The list of 
drivers and supported synthesizers can also be found in the previous section 
(Section 2.2.1). If your synthesizer is not listed here, check the README 
file on the outSPOKEN disk for up-to-date synthesizer and driver 
information.

    "Which port is your synthesizer attached to?"

 If you have an external speech synthesizer attached to a COM (serial) port, 
type the number of the port to which it is attached. If you have an internal 
synthesizer, type 0 for your port number. If your external synthesizer is 
attached to a parallel port, include the letter "L" before the port number.

When the installation is successful, the installer plays a series of 
descending tones, and you are returned to the DOS prompt. At this point, you 
are ready to restart your computer and launch Windows. 

2.2.3   Installer Feedback Tones

Although we recommend using a DOS screen reader for the installation 
process, it is possible to run OSINSTAL.EXE without running any speech 
program, even if you cannot read the screen. OSINSTAL plays various tone 
sequences to inform you of the installation progress. 

There are three basic tone sequences that the installer uses: the prompt 
tones, the progress tones, and the error tones.

As the installer proceeds through each step in the installation process, you 
will hear one to four ascending progress tones. The first tone is associated 
with the outSPOKEN directory verification, the second with the Windows path 
name, the third with the synthesizer driver, and the last with the 
synthesizer's port. If you are running OSINSTAL with command line input, as 
each part of the command line is verified, the corresponding tones are 
played. If the interactive installer is being used, each new series of tones 
will indicate what information is being requested. As with the command line 
installer, the first tone indicates that you should enter the path for 
outSPOKEN, the second indicates a request for the Windows path, etc. For a 
description of proper responses to these prompts, see "The Interactive 
Installer" (Section 2.2.2). When installation is complete, these four tones 
will sound in reverse order (highest to lowest), signalling that the 
installation has been successful, and you will be returned to the DOS 
prompt.

The prompt tones indicate that the installer is waiting for you to enter 
some information. The prompt tones are comprised of two quick beepsfirst a 
high one, then a low one. If you are running the interactive installer, each 
new progress tone is followed by the prompt tones. If you hear the prompt 
tones when running the command line installer, this indicates that one of 
the pieces of information supplied on the command line was incorrect. You 
will know which piece of information you are being asked to re-enter by the 
progress tones associated with the prompt. 

The error tones are a set of three or more low, ominous-sounding beeps. If 
one of the pieces of information supplied, either on the command line or via 
the interactive installer, is incorrect, a set of three tones will sound. 
The error tones will be followed by the prompt tones, and you may re-enter 
whatever information was incorrect. If more than three error tones sound, 
there has been a problem with the file copying or modification portion of 
the installation. If you hear error tones, a detailed error message is also 
displayed on the screen. A complete list of the meanings of these error 
tones follows. 

3 tones means that an error occurred during the verification portion of 
the installation process.

5 tones means that there was a problem copying files from the source 
diskette.

6 tones means that the installer had a problem copying the synthesizer 
driver.

7 tones means that there was a problem copying the keyboard driver.

8 tones means that the installer was unable to modify your WIN.INI 
file.

9 tones means that the installer was unable to modify your SYSTEM.INI 
file.

10 tones means that the installer was unable to modify your 
AUTOEXEC.BAT file.

2.3   Installing outSPOKEN Without The Installer

Installing outSPOKEN without the installer is a relatively simple process. 
It is equivalent to running OSINSTAL, but it does require the use of a text 
editor and some knowledge of DOS and Windows. We do not recommend 
undertaking this process without some means of reading the screen.

To install outSPOKEN to your hard drive, you must copy all files from the 
root directory of the outSPOKEN program disk to a directory on your hard 
disk. We recommend the name C:\OSW for the directory. Also, from the DRIVERS 
directory on your outSPOKEN program disk, you will need to copy the driver 
for your speech synthesizer to your new outSPOKEN directory.

Modify the AUTOEXEC.BAT file to include the new outSPOKEN directory in the 
path statement. If you have an external synthesizer, add a line at the top 
of the file to run its driver. Internal synthesizers should have their 
drivers run as the last line of the AUTOEXEC.BAT file. This loading order 
prevents conflicts with network drivers and other TSRs (terminate and stay 
resident programs). The driver command line should be of the following form:

C:\OSW\DRIVER S1

The word "DRIVER" should be replaced with the name of your synthesizer 
driver (without the .COM extension), and the directory name OSW should be 
changed to reflect any changes you have made to the name of the directory 
where you have installed outSPOKEN. The argument "S1" indicates that the 
synthesizer is attached to the serial port COM1. If you are attaching your 
synthesizer to another COM port, change the number to correspond to that 
port. If your synthesizer is a parallel device, replace the letter "S" with 
the letter "L". The number should be that of the LPT port to which it is 
attached.

The file WIN.INI in your Windows directory needs to have the "Load" line 
modified to include "C:\OSW\GUIACCES.EXE". As above, if you have installed 
outSPOKEN to a directory other than OSW, make sure your Load line reflects 
this. The Load line should appear as the second line of the [Windows] 
section of the WIN.INI file. If no Load line exists, one should be created. 
The Load line is of the form:

load=C:\OSW\GUIACCES.EXE 

There may be more than one program listed on this line (separated by 
spaces), but we recommend that you put outSPOKEN first (right after the 
equals sign). 

Another file in the Windows directory, the SYSTEM.INI file, needs to be 
modified as well. In the [386 Enh] section, the line that reads 
"keyboard=*vkd" should be changed to:

keyboard=C:\OSW\BSIVKD.386

If there is not already a "keyboard=" line, then a line of the above form 
should be added to the [386 Enh] section of the SYSTEM.INI file. The drive 
and path name in this statement should reflect any changes you have made to 
the location of outSPOKEN. 

Once you have made these changes, reboot your computer. When the synthesizer 
driver loads, your synthesizer should say "Voice ready." You are now ready 
to launch Windows with outSPOKEN.

outSPOKEN does not need to be specified on the Load line of the WIN.INI file 
to be launched automatically each time Windows is started. To take advantage 
of the alternatives, however, a degree of familiarity with Windows is 
necessary. The following instructions assume some understanding of Windows 
operation. 

outSPOKEN is a Windows application, and can therefore be launched either 
from Program Manager or from the Windows command line. Provided all other 
modifications are made to the files listed above, outSPOKEN (GUIACCES.EXE) 
can be removed from the Load line and launched at will. 

To launch outSPOKEN from the Windows command line, simply type the following 
command line at the DOS prompt:

WIN \OSW\GUIACCES

If you have installed outSPOKEN to a directory other than the default 
directory, modify the path name in the above command line appropriately. 
When Windows starts, outSPOKEN launches, but Program Manager is minimized. 
To open Program Manager, double-click on the Program Manager icon or press 
ENTER .

It is also possible to create a Program Item for outSPOKEN in Program 
Manager. To do this, select the New option from the File menu of Program 
Manager. Press ENTER to select the defaulted option of creating a new 
Program Item. The next dialog box is the Program Item Properties dialog of 
Program Manager. The first field is the Description field; type "outSPOKEN" 
and press TAB. The next field is the Command Line; type "C:\OSW\GUIACCES" 
and press TAB. If you have made any changes to the location of the outSPOKEN 
directory, be sure they are reflected in this command line. The next field 
is Working Directory; type "C:\OSW" unless you have installed outSPOKEN to 
another directory. The next field asks for a Shortcut Key. You may assign 
any shortcut key you wish. This will be the command to launch outSPOKEN once 
the Program Item is completed. A convenient shortcut key is the letter O 
with CTRL and SHIFT. This is the command to turn outSPOKEN off, so assigning 
it as the key to launch outSPOKEN provides a toggle function to this key. It 
must be noted, however, that if outSPOKEN is running when this assignment is 
made, the first press of this key combination turns outSPOKEN off. Once the 
words "Exiting outSPOKEN," are heard, pressing the combination again assigns 
the shortcut key. Pressing ENTER exits the Program Item Properties dialog, 
and a third press of the sequence re-launches outSPOKEN.

It is also simple to run outSPOKEN from the Run dialog of Program Manager. 
Once Program Manager is running, select the Run option from the File menu. 
Type "C:\OSW\GUIACCES" as the command line, and press ENTER. If you have 
installed outSPOKEN to a directory other than OSW, make appropriate changes 
to this command line. 

2.4   Launching outSPOKEN

Once outSPOKEN has been installed, it is easy to launch it. After installing 
the program, restart your computer by pressing the reset button. As your 
computer boots up, the words "Voice ready" should be spoken by your voice 
synthesizer. This signals the speech driver loading into memory. 

We recommend first exploring the outSPOKEN tour, which is a word processor 
document designed for experimentation by a beginning outSPOKEN user. To take 
the tour, type the following command line at the "C:\" prompt. If the boot 
process automatically launches Windows, the DOS prompt will not appear, and 
the tour will need to be started in a different way (see below).

WIN C:\OSW\OSWTOUR.WRI ENTER

This launches Windows and outSPOKEN is automatically loaded. Specifying the 
outSPOKEN tour file (OSWTOUR.WRI) on the command line opens the outSPOKEN 
tour file. Press outSPOKEN's READ REST OF WINDOW command (CTRL-KPD 3) after 
outSPOKEN has been "cleared for takeoff" to get started on the tour. 
outSPOKEN will take you from there.

We do not recommend the outSPOKEN tour as an alternative to this 
manual. We offer this step at this point to satisfy the curious mind, 
but we strongly encourage reading the following chapters before 
experimenting further with Windows and outSPOKEN.

If Windows launches automatically at start-up, there will not be an 
opportunity to type the above command line. outSPOKEN is launched 
automatically. To start the outSPOKEN tour from inside Windows, take the 
following steps after hearing the message "outSPOKEN cleared for takeoff."

1.   Press the Alt key and the letter "F" at the same time (Alt-F) to open 
the File menu.

2.   Type the letter "R" (without the Alt key) to select the "Run" option 
from the menu.

3.   Type "C:\OSW\OSWTOUR.WRI" to specify the outSPOKEN tour file.

4.   Press the ENTER key.

The outSPOKEN tour is now displayed on your screen, and pressing CTRL-KPD 3 
will get you started. 

In general, Windows can be run from the DOS prompt by typing "WIN" then 
ENTER. outSPOKEN is set up to load automatically when Windows is run. The 
messages "outSPOKEN taxiing" and "outSPOKEN cleared for takeoff" are spoken 
after Windows has launched, and while outSPOKEN is in the process of 
loading. Once outSPOKEN is "cleared for takeoff," you are ready to use 
Windows. If these voice messages are not heard, or Windows does not launch 
properly, refer to Chapter 6, "TROUBLESHOOTING outSPOKEN." 

