ECHO II SPEECH SYNTHESIZER - INSTALLATION AND OPERATING INSTRUCTIONS

NOTICE

Street Electronics Corporation reserves the right to make improvements in the product described in this manual at any time and without notice.

DISCLAIMER OF ALL WARRANTIES AND LIABILITY

Street Electronics Corporation makes no warranites, either express or implied except as explicitly set forth in the Limited Warranty, with respect to this manual or with respect to the software described in this manual, its quality, performance, merchantability, or fitness for any particular purpose. Street Electronics Corporation software is sold or licensed "as is." The entire risk as to its quality and performance is with the buyer. Should the programs prove defective following their purchase, the buyer (and not Street Electronics Corporation, its distributor, or its retailer) assumes the entire cost of all necessary servicing, repair, or correction and any incidental or consequential damages. In no event will Street Electronics Corporation be liable for direct, indirect, incidental, or consequential damages resulting from any defect in the software, even if Street Electronics Corporation has been advised of the possibility of such damages. Some states do not allow the exclusion or limitation of implied warranties or liability for incidental or consequential damages, so the above limitation or exclusion may not apply to you.

This manual is copyrighted. All rights reserved. This document may not, in whole or in part, be copied, photocopied, reproduced, translated or reduced to any electronic medium or machine readable form without prior consent, in writing, from Street Electronics Corporation.

Copyright 1982 by Street Electronics Corporation 1140 Mark Ave. Carpinteria, California 93013 (805) 684-4593

Apple and Apple Two are trademarks of Apple Computer Inc.

ECHO, ECHO Two, ECHO GP, TEXTALKER and SPEAKEASY are all trademarks of Street Electronics Corporation.

This manual was supplied on floppy disk by Street Electroics Corporation. It was processed by David Holladay and Marko Pinter on the BRAILLE-EDIT system which is available from Raised Dot Computing, 310 S. 7th, Lewisburg, PA 17837 (717) 523-6739

The text has been automatically translated into grade two braille. Portions trapped between @- and the @l remain untranslated, and hence in computer braille. This is mostly done to accurately represent computer program listings and keyboard sessions. There is a description of the computer braille code in the VersaBraille P-2 manual. If you have any questions about this manual, do not hesitate to contact Raised Dot Computing.

Congratulations on choosing the Street Electronics ECHO Two speech synthesis system. Whether you will be using it for games, education, aiding the handicapped or any of its other applications, you will find that the ECHO Two's superior ease of use and speech quality make it the most versatile Apple compatible plug-in speech board on the market today. We are confident that this is only the beginning of a long and satisfying relationship between yourself and the ECHO Two. The first thing that you will probably want to do is to sit down and try it out for yourself. That's a good attitude. All we ask is that you control yourself for ten minutes, sit down at your computer with this entire pac age, and continue reading through this Introduction, the Table of Contents, the Introduction to the Manual, and the Installation instructions. We know that you want to do this right! Within 10 minutes you will be listening to speech from your Apple Two!

TABLE OF CONTENTS

Introduction to the Manual - 1 Installation Instructions - 2 Testing - 3 Keyboard Notation - 3 Error Messages - 4 Booting a Diskette - 4 The Catalog - 6 Software - 8 TEXTALKER Tutorial - 11 Mispronunciation - 13 Print or Question Mark - 15 TEXTALKER Commands - 16 Using the ECHO within a Program - 18 A BASIC Primer - 19 Rate Modes - 23 Pronunciation Modes - 24 Punctuation Modes - 24 Pitch Modes - 25 Volume Modes - 26 List Control Commands - 27 SPEAKEASY Tutorial - 29 Encoding Phonemes - 30 The Phoneme Editor - 32 Inflection/Stress - 33 Pitch and Rate - 33 Volume Control - 35 Pauses - 35 Features to Aid Blind Users - 37 Technical or Advanced Information - 43 TEXTALKER and PR#0 - 43 Using TEXTALKER and SPEAKEASY From Machine Language - 44 Changing the Frequency - 45 SPEAKEASY Phoneme Categories - 45 Using the ECHO Two Within Commercial Programs - 47 Appendix A (Sample Phoneme Vocabulary) - 48 Appendix B (Using the ECHO to Answer a Telephone with an Apple Cat Modem) - 50

INTRODUCTION TO THE MANUAL

We have attempted to make this manual both informative and easy-to-use. It was designed to accomodate the not-so-experienced user as well as the more experienced. Each section is meant to be read from beginning to end and to be used in conjunction with the ECHO Two. By the end of each section you should have not only an understanding of the material covered, but also experience with it.

The 3 main sections of the manual concern (1) installation of and introduction to the ECHO Two, its software and this manual, also some very basic help for the less experienced Apple user; (2) The TEXTALKER (TM) software tutorial and (3) the SPEAKEASY(TM) software tutorial. There is also a section on the ECHO's exclusive features to aid blind users, a technical or advanced section and various appendices. These sections are all outlined in more detail in the table of contents. Turn the page for installation instructions and you are on your way.

INSTALLATION INSTRUCTIONS

TESTING

If you have some experience with the Apple, you may now test the ECHO by booting the diskette that came with it and running the program called SEC DEMO. This program shows some of the features of the ECHO. To end the program type a Control-C. You should now also copy your diskette. If you do not understand what was just said, don't worry. You will be able to test the ECHO after reading the following two sections on "KEYBOARD NOTATION" and "BOOTING A DISKETTE."

KEYBOARD NOTATION

In this section you will be introduced to a simple notation system which will show you exactly what to type on your Apple keyboard. For instance, when we want you to type the word "HELLO" you will see: H E L L O [transcriber's note: the manual has special boxes to enclose each keystroke. In this version, the keystrokes will be in computer braille and spaced apart]

Each boxed letter represents a key on your Apple's keyboard. Of course, for some characters you are required to hold down one key while pressing another.

For example, to type an exclamation point (!), you must hold down the SHIFT key while pressing the 1 key (just as you would on an ordinary typewriter). However, we show only the exclamation point.

!

When it is necessary for you to type a "control character" we will print this:

The upper key should be held down while you press the lower key. So, typing a Control-E is similar to typing a Shift-E except that you press the CTRL key instead of SHIFT. Note that when you type a control character nothing will appear on the screen.

If you accidently misspell something then, most likely, the Apple will reject it by printing "SYNTAX ERROR" on your screen and emitting a "beep" from its speaker. This is not a problem, but you will need to type the line over again. REMEMBER: Don't ignore syntax errors - you must retype the line!

Several programs are included for use with your ECHO and they can be found on the diskette that came with the ECHO. To discover exactly what programs are on the diskette, you must "boot" and "CATALOG" this diskette. The process of adding DOS (Disk Operating System) commands to your Apple is called "booting" the diskette and is accomplished by following the simple steps outlined below.

1. Insert the diskette into the disk drive with the label facing upwards. The edge of the diskette with the label should enter the drive last. If you have more than one drive, place the diskette in Drive #1.

2. Turn on the power to your Apple. If it is already on, then turn it off and then on again. This clears the memory and, on most Apples, automatically boots the diskette. If the disk drive is now making a whirring noise and the red "in use" light on the drive is lit - Congratulations! The deed is done. The diskette is booted and you should skip to step 4. If, on the the other hand, your disk drive is just sitting there not making a sound, and there is an asterisk (*) in the lower lefthand corner of the screen, then proceed to step 3. Now if your disk drive is not whirring or showing any other signs of activity, and your screen does not show an asterisk (you did remember to turn on your t.v. or monitor, right?), then please check your DOS manual to make sure that your disk drive is installed properly.

Now it should boot. Congratulations. (If it still does not work, then check your DOS manual.)

Follow the instructions with this program and when you are finished put the original diskette in a safe place and boot the copy. You should always use a copy.

If you have not already done so, please boot the ECHO diskette. The Apple will now respond to commands concerning the diskette. Type:

A "listing" or "catalog" of program names and other information will appear. We will now show you how to interpret and use this information.

At the top of the catalog the words "DISK VOLUME 254" appear. Every diskette is assigned a volume number when it is set up to store programs. The volume does not concern us here, so we will not discuss it any further. (If you are really curious you can check your DOS manual). The next line of the catalog looks like this:

The word "HELLO" is the name of the first program on the diskette. Whenever this diskette is booted, HELLO is automatically run. This program simply prints a short message and a copyright notice. The number to the left of the program name (002) is a measure of the space on the diskette that is used to store this program. Disks are divided into "sectors," and each sector can hold 256 characters. The HELLO program uses 2 sectors of storage. The letter "A" to the left of the "002" indicates that the program is written in APPLESOFT(TM). APPLESOFT is a version of the BASIC programming language. We will be writing a short and simple APPLESOFT program later on in this manual, and all of our examples will assume that you are using APPLESOFT. You can tell if your Apple is ready to understand APPLESOFT by checking the "prompt" on your screen. If this character, which appears before the flashing square (the "cursor"), is a "]" then your Apple is ready for commands in APPLESOFT. If the prompt is just a flashing square that means that there is more to the catalog. Press any key you like and the catalog will continue to list, one full screen at a time, until the entire catalog has been listed. At this point, the normal prompt will appear (usually a "]" followed by a flashing square).

Instead of the letter "A" you may find any of the following letters:

I - This means that the program is written in "INTEGER BASIC" which is another of the programming languages available for the Apple.

B - This means that the information stored here is stored in "Binary" form. It may be a program; it may be data; it could even be a high resolution picture. There is no way to tell from looking at the catalog listing. You just have to trust the literature that comes with the diskette (in this case, you have got to trust us!) T - The "T" indicates that this is a text file. A text file is characters: letters, words, etc.- that is, "text," stored as a group (file) on the diskette.

The asterisk (*) which precedes the catalog entry indicates that this entry is "locked." "Locking" a program is a way of protecting the program from being accidentally deleted or erased from the diskette. If you did want to erase the program, you would first need to "unlock" it. This procedure is explained in more detail in your DOS manual. Now that you have some familiarity with the catalog, we will now offer a brief explanation of what each of the programs listed on your diskette can do.

In order for you to get the ECHO to speak you must use one of the following programs: TEXTALKER(TM), TEXTALKER.RAM(TM), TEXTALKER.BLIND(TM) or SPEAKEASY(TM). Once you have run one of these programs you will not need to run it again unless you re-boot a diskette or turn the computer off. Each of these programs, when run, will slightly modify your DOS (Disk Operating System). Because of this it is a good idea for you to initialize any new diskettes with an unmodified DOS, like that on your system master diskette. In the following sections we will assume that you are using the TEXTALKER program. All of the commands used in TEXTALKER are also used in TEXTALKER.RAM and TEXTALKER.BLIND. TEXTALKER.RAM and TEXTALKER.BLIND have a few additional commands designed for users who are blind. These additional commands are covered in the section titled "Features to Aid Blind Users." To run TEXTALKER type:

Note that you should type "BRUN" and not "RUN." If you typed "RUN" your Apple responded with a"FILE TYPE MISMATCH ERROR" because this is a binary file and not an APPLESOFT file. If you made this error you should simply retype the line. After the disk drive stops whirring you will see the following message on your screen:

Do not worry if the version number is different. Running TEXTALKER.RAM or TEXTALKER.BLIND is accomplished in the same way (except that you would type a different program name of course). We will cover SPEAKEASY in a separate section.

You are probably ready to hear the ECHO speak. Type:

You probably noticed that the ECHO said each letter as you typed it and, when you pressed RETURN, that it said the word "HELLO." If this was not the case, then make sure that you typed exactly what is shown above, especially the quotes. (Notice that the ECHO did not say anything when you typed the quotation marks. Later we will show you how to have punctuation spoken.) If you want to hear it again, then just type it again. What did we just do anyway? Well, the word "PRINT" is an APPLESOFT BASIC command. Anything in quotation marks that follows this command will be printed on the screen. The TEXTALKER program is also at work. It looks at everything printed to the screen and pronounces it to the best of its ability. Pressing the RETURN key signals the Apple that this is the end of the command, and that it should now carry out that command - in this case it should print and speak the word "HELLO." Using this information you can now make the ECHO say anything that you want. For example, you could type:

Go ahead and play around a little, it will help you to get a feel for the ECHO and also allow your ear to become better accustomed to the ECHO's speech. Try CATALOGing the diskette again and listen to the ECHO read it to you.

Welcome back. While typing in phrases for the ECHO to speak, you may have come across a word or two which the ECHO has mispronounced. Although the TEXTALKER program uses many rules (almost 400 in fact) to guide it in correctly pronouncing your text, English is so full of exceptions to these rules, such as compound words and foreign words, that it is simply not feasible to make a perfect speech synthesizer for a microcomputer. With a few simple guidelines, you can help to bridge the gap between the ECHO and perfection. Our first example involves a compound word, but the solution to the problem applies to more than just this type of exceptional word. Type:

Often breaking up the word is all that is needed to correct the pronunciation of an exceptional word. For more examples of this, type: "equals" (E QUALS), "create" (CRE ATE), and "program" (PRO GRAM).

Other words may need to be misspelled for them to be pronounced correctly. For instance, type:

Notice that the first "O" is mispronounced. We need to change the vowel sound from a short sound to a long sound. (Remember "sounding out" words phonetically when you learned to read? If you don't remember--the "short o" sound is the "o" in "rock" and the "long" sound is found in "row." The long sound of each vowel is its name.) Try typing "ROWBOT" instead of "ROBOT." By following the "o" with a "w" we have made the pronunciation of the "o" as a long "o" more consistent with the patterns of English speech. (The word "robot" is foreign.) Along the same lines we can change the short "a" sound to a long one by spelling it "ay," and the short "e" will be pronounced "long" if it is doubled ("ee"). To make a vowel go from long to short, try doubling the following consonant. Using these hints, your own common-sense knowledge of English, and experimentation (which is really the key), correct pronunciation will be made simple. Now, what if you want the ECHO to pronounce one of these exceptional words correctly and also print it on the screen spelled correctly? This is not difficult and we will show you how soon.

PRINT or ?

This is a good time to look at an easier way to type PRINT. APPLESOFT BASIC allows an abbreviation for the word "PRINT" and that is the question mark (?). Try it.

We will continue to use PRINT in our examples, but feel free to type the question mark instead. Also, notice that you have been hitting the RETURN key at the end of each line. We are going to stop telling you do this each time. You must take care to remember to hit RETURN after each command, however, so that the Apple knows that you are done with that line. Another point of general interest concerns the RESET key. When you press RESET, or CTRL and RESET on newer Apples, the TEXTALKER program no longer works. The program is still there, but it can not react to what is being printed to the screen, so it just sits there. To revive TEXTALKER (or TEXTALKER.RAM or TEXTALKER.BLIND) type:

Note that the last character is a zero, not the letter "O". Give it a try; press RESET and then type PR#0 as shown above.

The TEXTALKER program has several different modes in which it can operate. The rest of this tutorial will explain these to you. Type:

or...

? " CTRL/E O "

Are you still remembering to press RETURN? If you are carefully following instructions, you did not type a space after control-E. You should never type a space after control-E. Now type:

The ECHO did not make a sound! Control-E (common notation for the result of pressing the control key and another letter at the same time) precedes all ECHO commands so ,whenever you print a Control-E, the TEXTALKER program interprets the following characters as a command. In this case the character following was an "O." This command puts the ECHO into "Output only" mode (get it? "O" for "Output"). In this mode the computer will print to the screen but the ECHO will remains silent. Now type:

This command puts the ECHO into a "Talk only" mode. In this mode the ECHO will speak, but nothing will be shown on the screen. Type:

Test this mode by printing a message on the screen.

Notice that all of the commands have been preceded by a Control-E. Now suppose that for some very practical reason (or even a totally impractical reason) you do not wish to use Control-E to indicate a TEXTALKER command. You have to ability to change this if you so desire. To change the Control-E to Control-Q type:

Now Control-Q is the new command character. To double-check the change, type the following commands:

Notice that "HELLO" was printed on the screen, which it should not have been if we had activated the "Talk only" mode in this usual way. Now type:

Now the "Talk only" mode is in effect. Return to the "Both" mode by typing:

And let us also change the command character back to a Control-E. Type:

You may change the command character to any control character. But you should not make it Control-M (which will act just like the RETURN key), Control-U (the -> ), Control-H (the <- ) or Control-J (a linefeed).

To demonstrate how to use the ECHO from within your own program, we will now write a short APPLESOFT BASIC program. To speed things up, first issue the "Output only" command (CONTROL-E O), and then type:

to let your Apple know you are about to type a "new" program. Now type the following lines exactly as shown (including the line numbers). End each line by pressing the RETURN key, of course.

and double check your listed program with the program in the manual. If there is a mistake you just have to retype the line containing the mistake (including the line number).

Those of you who know BASIC should skip this section. If you do not know much BASIC--stick around. The three line program that you just typed in is a BASIC program. In BASIC, each command or instruction must be preceded by a number, which is called a line number. The Apple will perform these commands in numerical order. The numbers do not need to be in increments of one however. (For example, in your program the computer will do line 10 and then line 20--it will not sit there waiting for line 11.) Our program will therefore perform as follows... The first line (line 10) uses the BASIC command "INPUT." When the Apple encounters this command it will print a question mark and wait for the user (that's you) to type a response as an input. The program will store what you have typed in its memory and label it "A$." We will assume that you type in the word "HELLO" as an input. Line 20 contains the "PRINT" command. We have used the PRINT command before, but only as followed by a phrase within quotation marks. Since A$ is not in quotes, the computer will not print the characters "A" and "$," but will instead print the "value" of A$, which is the input/response to line 10--the word "HELLO." Therefore, when the Apple encounters line 20, it will print "HELLO." Line 30 simply tells the computer to "GO TO" line 10 and start all over again by first asking for an input and then printing the input and then starting all over again... Let's try running the program. Type:

Enter any word you like when you see the question mark, and press RETURN. The Apple will obediently print the word that you entered and then ask you for another word. To end this limited game, type:

in response to the input request (the question mark). The program will stop and your Apple will tell you that you stopped it at line 10 of your program, or, in its words, "BREAK IN LINE 10." Now you can turn the speech function back on and have both that and the screen output by issuing the now familiar ECHO command:

Now RUN the program again. Note that you do not have to put quotation marks around your response to the input request to hear it spoken unless the phrase contains a comma. Also, keep your response down to less than six lines (your Apple manuals can explain the reason for this if you are curious). Type in a few of your favorite phrases, and also try typing the commands that you have learned. If you do type a phrase which contains a comma, the ECHO will pause at the comma. Also note that if you type:

the TEXTALKER program will stop printing to the screen as soon as you enter the T command--even before you press RETURN.

To make our program even easier to use, we will modify it slightly. First, exit the program by typing:

These lines will automatically assume their place in proper numerical order within your program. Now change line 30 by typing:

The Apple will automatically replace the old line 30 with the new one. Now type:

Compare your program to the following listing. If there are any mistakes, just retype the line containing the mistake.

Again, if you know BASIC, skip this section. You see that the new line 5 uses the now familiar PRINT command, but that following it we have "CHR$(5)." This is a BASIC command equivalent to typing Control-E. (E is the fifth letter of the alphabet, hence the "5" in parenthesis.) After this comes the letter "O" in quotes. These two parts of line 5 combine to be the equivalent of typing "Control-E O." The reason we use the CHR$ command is that when you type Control-E, nothing shows on the screen, but while using the new command we can now easily check to see if we remembered to enter Control-E in the program. Line 15 prints out the ECHO's "Both" command and line 30 now jumps to line 5, the new beginning of the program.

Our new program works as follows: Line 5 puts the ECHO in "Output only" mode. This way, when you type your response to line 10, the ECHO will not speak, which allows you to type faster. Line 15 puts the ECHO in "Both" mode, so that line 20 both prints and speaks your input. Line 30 starts the program over again. You may stop the program as you did before by typing a Control-C instead of an input.

You can probably now see how we would have a word spelled correctly on the screen, and yet spelled incorrectly for the ECHO to pronounce. First we would put the ECHO in "Output only" mode and print the correctly spelled word (e.g. ROBOT). Then we would put the ECHO in "Talk only" mode and print the word spelled as we would spell it for pronunciation (i.e. ROWBOT).

We are now ready to cover some additional modes. First, if it is not already running, RUN the program that you typed in. Now enter a sentence at least a few words long (e.g. "RUBBER BABY BUGGY BUMPERS"), then type:

Now type the same sentence again. You are now in "Compressed" mode in which the speech is compressed--that is, faster. Some people find the fast mode difficult to understand at first, but only until they have become accustomed to it. Once you have more experience with the ECHO, you may find that you are always using the compressed mode. To return to the slower mode type:

You are now in "Expanded" mode in which the sounds are expanded and, therefore, slower. Type in another phrase to make sure you entered the "Expanded" mode command correctly.

Currently you are in "Word" mode, in which the ECHO pronounces whatever you type as a word. You may also have it spell out everything letter by letter by typing:

You may remember that, earlier in this tutorial, we promised to show you how to get the ECHO to say the quotation marks as you typed them in; we will do that now. The punctuation mode that you are in now pronounces only unusual punctuation (e.g. "#", "$", "%", "&", "=", "@", "+", "<", ">" and "/") and also a "." if followed immediately by another character. (For an example of this last point have the ECHO say "2.9%.") This mode is known as the "Some punctuation" mode. To get the ECHO to pronounce Most of the punctuation characters type:

The ECHO will now pronounce all punctuation characters except spaces, line feeds (Control-J) and carriage returns (Control-M or RETURN). The ECHO will say even these if you type:

This command puts you in "All punctuation" mode. To return to the standard "Some punctuation" mode, enter:

It is also possible to adjust the "Pitch" of the ECHO. Type:

Type in a short phrase. Notice that the voice of the Echo has a higher pitch now. You may vary the pitch by varying the number in the command from 1 to 63. Try some different pitches now. When you are done, return the pitch level to a middle value, or back to the original pitch level of 22. Now type "ARE YOU HAPPY?". Listen carefully as the ECHO's pitch changes at the end of the sentence. Since the sentence ends in a question mark, the pitch rises, just as it does in normal human speech. Compare this with "ARE YOU HAPPY" (no punctuation) and "ARE YOU HAPPY." (with a period). When the sentence ends in a period, exclamation point or a colon, the ECHO's pitch will drop. If the sentence ends with a question mark or semi-colon the pitch will rise. Notice too that some variations in pitch exist within each word.

If you would like the ECHO to speak in a robotic tone, you can put it in "Flat pitch" mode by typing:

You may vary the pitch by changing the number here from 1 through 63 also. Type in a few phrases and notice that when the ECHO speaks now, its pitch does not vary within the sentence.

If you are working/playing with the ECHO late at night, you, or perhaps a loved one, may appreciate the ECHO's ability to speak at different volume levels. To set the volume, use the ECHO command :

The number may vary from 0 through 15. You may also use this mode to create special effects such as an "echo" for the ECHO. Try setting the volume at different levels. Notice that at the higher levels, the volume of fricatives (F,H,S,SH,TH) increases without a corresponding increase in the the volume of some of the other sounds. Also, the lower levels sound like a whisper. To adjust the volume without these effects, you may turn the volume potentiometer on the ECHO itself. The potentiometer is the small knob near the top of the ECHO with word "VOL" located to its immediate left. Turning the knob counter clockwise lowers the volume and turning it clockwise increases the volume.

The last two commands can best be explained without running the program that you have typed in. Remember that to stop the program you type:

To continue the catalog press any key. Now type:

Note that the catalog continues to list, but that the ECHO remains silent. Control-X puts the ECHO in "Output only" mode until the Apple requests an input. After the catalog stops listing, the Apple waits for a command (input) which puts the ECHO back into "Both" mode.

This about concludes our discussion of the TEXTALKER commands and operating modes. You should know that you may combine the modes in many different combinations. You can have, for example, the "Flat pitch" mode and "Letter" mode and the "All punctuation" mode all active at the same time. If you need to review these commands; see the reference card for a complete listing, along with brief explanations of the commands.

The SPEAKEASY program generates speech very differently from the TEXTALKER programs. In the TEXTALKER programs, you printed a word and the ECHO spoke the word. In SPEAKEASY you will be printing phonemes to generate speech. Phonemes are the smallest distinguishable sound units of a language. The word "speech," for example, is composed of six letters, but only four phonemes: they represent the "s" sound, the "p" sound, the "long e" sound and the "ch" sound. Since SPEAKEASY works at the phoneme level, you will be able to have words pronounced exactly as you wish. SPEAKEASY was developed to be used within your programs, to give them new animation and uses. Also, if you do not have a RAM card or can not spare the 8K of memory that the TEXTALKER programs require, SPEAKEASY will give you speech capability while using only 3K of memory.

There are a couple of ways to run SPEAKEASY. The TEXTALKER programs contain SPEAKEASY, so if you have already put TEXTALKER into memory, then SPEAKEASY is also already in memory. If you want to just use SPEAKEASY, and we will assume in our examples that this is the case, then just "boot" the diskette (this procedure is explained in detail in the section called "Booting a Diskette") and type:

Using the SPEAKEASY (TM) program rather than a TEXTALKER program insures that SPEAKEASY will work even if you press RESET or issue a "PR#" command. Your monitor or television screen should look like this:

COPYRIGHT 1981 STREET ELECTRONICS CORP.

Don't worry if your version number is different.

To use SPEAKEASY you will need to have the reference card handy. There you will find a table which shows all of the phonemes and associated SPEAKEASY codes that you will be using to create speech. The first column contains an example of a common word containing a clear instance of a sound. The second column shows the common dictionary symbol for the sound, and the third shows the symbol that you will actually be typing into the computer to represent that sound. Using this table we can see that the word "speech" (to continue with our previous example) would be written in SPEAKEASY code as SP&C. The word "echo" would be EKO.

To actually hear the ECHO speak these words, type in the following short program:

Double check your listing of the program you just typed in against the listing in this manual. As always, if there are any mistakes retype the line and list again. The way this program will work is that line 20 will make "V$" equal to a Control-V ("V" being the 22nd letter of the alphabet). This is done because every word that you want to have spoken by SPEAKEASY will have to be preceded by a Control-V. Line 30 will print the "value" of V$ (Control-V), thus alerting the SPEAKEASY program that it must speak the phoneme codes which follow it (E,K, and O). Line 40 will similarly say "S," "P," "&" and "C." Line 50 will print "DONE" without speaking because there is no Control-V preceding it. Try the program now by typing:

It is useful to note that SPEAKEASY will pronounce everything following a Control-V until it encounters a "carriage return." In BASIC a carriage return is automatically generated at the end of each PRINT command unless it is followed by a semi-colon (;). To better understand and use this feature, retype lines 30 and 40 like this:

Type "LIST" to review the program and double check your changes and then "RUN" the program again. This time the ECHO said both "EKO" and "SP&C" even though, on line 40, "SP&C" was not preceded by a Control-V (V$). This is because line 30 ended with a semi-colon which cancelled the carriage return which would have told SPEAKEASY to stop speaking.

SPEAKEASY also includes a phoneme editor which makes experimentation with putting words into their phoneme codes easier. To enter the editor simply type:

You will now see a quotation mark for a prompt. Now type:

The ECHO will say "EKO." Note that a Control-V was not necessary. You can continue to type in words and hear them pronounced in this manner, making changes using the Apple's normal editing commands. You may also type in more than one encoded word at a time. Try typing "I am ECHO" which encodes as:

When you are finished experimenting, you can quit the editor by pressing RETURN instead of entering any phoneme codes. Use this editor to type in the words for the rest of the examples presented.

Listen carefully. Now type:

Note that this time the "E" is more stressed. The number 0,1,2 or 3 following a vowel, diphthong or "r-colored vowel" (you will see these categories on your reference card) determines the stress of that phoneme. If no stress number is given then a value of 2 is used. Using a 3 gives greater stress by making the phoneme higher in pitch, longer in duration, or both. Try retyping "E3KO" and substituting 2,1 and 0 for the 3. The 1 reduces the stress placed on the phoneme by making it lower in pitch and shorter. A stress of 0 reduces the sound to what is termed a "schwa." The schwa also has its own code (') which can be used.

The base pitch of the ECHO is set using the same commands that we used in TEXTALKER (i.e. Control-E40P, Control-E40F...). These are outlined in more detail in the TEXTALKER tutorial. You may also set the rate of speech (speed) using TEXTALKER commands (i.e. Control-E C and Control-E E).These commands can not be issued from within the phoneme editor, however. (If you have already tried it, press Control-RESET.) To issue these commands, exit the editor by pressing RETURN instead of entering any phonemes. Now enter the command as you would in TEXTALKER, for example:

SPEAKEASY allows you to adjust the pitch within a word too. Simply insert a number from 1 through 9 anywhere within a word except following a vowel or a diphthong (where it would be considered a stress number). The base pitch is 5 and 9 is the highest pitch. The pitch will remain at the new level until it is reset, or until the first "stop consonant" or "fricative" is encountered. Try typing: **************

F5 .RM+20 999 ! 3 777 A M 555 A N 333 E 3 K 111 O 3 .RM-20 $p********** The numbers in bold print set the pitch level, while the numbers following the vowels set the stress level as explained earlier. This may seem a little confusing at first, so try experimenting with different combinations and familiarize yourself with the system.

Another way to modify the pitch is by using the symbols ">," "<" and "=." The ">" symbol will set up a pattern of rising pitch, the "<" symbol sets up a pattern of falling pitch, and flat pitch is set up using the "=" symbol. All sounds will continue to vary in the pitch pattern that you have set until either a fricative, stop consonant, or a pitch level change is encountered. Try typing the word "help" using these symbols. You might type:

or...

SPEAKEASY allows you to adjust the volume of speech within your programs by using "+" and "-." Typing a "+" increases the volume and the "-" decreases it. You may also type a series of "+"s or "-"s, just as you did with the pitch symbols. For example type:

E K O - - E K O - - E K O - - E K O + + + + + + E K O RETURN

The volume will remain modified until it is explicitly changed again using the "+" or "-" commands. When TEXTALKER or SPEAKEASY is first RUN, the volume is already set at about the maximum level. Increasing the volume one level above this will increase the volume of fricatives without a corresponding increase in the voiced sounds.

The SPEAKEASY program ignores spaces between words although we recommend that you type them for better legibility. To make SPEAKEASY pause, use a comma. The comma may be followed by a number to vary the length of the pause. A 1 is a short pause while a 9 gives a long pause. Type in this demonstration:

If no number is used, a value of 2 is assumed. Try:

The pauses between the words are identical.

SPEAKEASY is really not difficult to use, though, due to its high degree of flexibility, you probably feel that there is an awful lot to remember. Practice by using the sample vocabulary in Appendix A and also a dictionary, which will help you encode words when used in conjunction with your reference card. There is also a program on the diskette called "PHONEME TRANSLATOR". This program will show the phonemes that TEXTALKER generates when it translates text to speech. FEATURES TO AID BLIND USERS

Extra commands designed to help the blind user are contained in both TEXTALKER.RAM and TEXTALKER.BLIND. You will want to use TEXTALKER.RAM if you own a RAM card; otherwise use TEXTALKER.BLIND. Type:

Type in the word "PRINT", but do not press RETURN. Now press the left arrow key ( <- ) a few times. Notice that as you back up the cursor, the ECHO will pronounce the letters that the arrow is passing over. Now press the right arrow key ( -> ) a few times. It also speaks. The right arrow will do this in all versions of TEXTALKER, but the left arrow speaks only in TEXTALKER.RAM and TEXTALKER.BLIND. Only the characters normally pronounced in the punctuation mode currently set will be spoken.

LINE REVIEW MODE: provides a controllable audio cursor. You may move this invisible cursor around the screen to review what is currently on the screen. To explore this, first type:

This is an APPLESOFT command which clears the screen. Now type:

Since TEXTALKER begins in the "Both" mode, the catalog will be both spoken and printed to the screen. To review the catalog which is now on the screen you must first type in the Line Review command:

The ECHO responded to this command by saying "review." It is now expecting Line Review commands. When you first enter Line Review mode you may enter any of the following commands (but do not type anything yet).

Any letter from A through X: Typing one of these letters will cause the audio cursor to be positioned at the beginning of the line which numerically corresponds to the letter selected. Pressing the letter "A" will position the cursor at the beginning of the first line. Pressing "B" will place it at the beginning of the second line, and so on to the twenty-fourth line (X).

Z : Pressing Z will place the audio cursor at the same vertical and horizontal position as the normal video cursor.

SPACE BAR: Pressing the Space Bar will cause the ECHO to tell you the current vertical and horizontal position of the cursor. It will then exit line review mode.

A Control Character: Typing a Control character will change the command used to enter Line Review mode. This procedure is identical to that used to change the Control-E command in TEXTALKER.

Now press the Space Bar. The ECHO responded by saying a letter, corresponding to the vertical position of the cursor, and then two numbers, which correspond to the horizontal position of the cursor. The leftmost position is zero. To reenter the Line Review mode type:

and then...

D

The ECHO confirmed your choice by saying "Line D." There are now several new commands available to you. You may find it helpful to use your reference card as we explain them to you.

Press the right arrow twice:

Please remember that commands in Line Review mode should not be followed by pressing RETURN.

The ECHO just said "disk volume." Now press the left arrow once:

The ECHO said "volume." (The last word it had spoken.) Now type:

The ECHO said the letters "v," "o" and "l." What did we just do? When you first entered Line Review mode you were also in Word mode; that is, pressing the arrow keys moved the cursor right or left by one word at a time. Pressing the letter "T" allows you to Toggle between (switch between) Word mode and Letter mode. In Letter mode the cursor moves letter by letter. Press "T" again. You are now back in Word mode. Press the arrow keys and check if you are not convinced. Now return the cursor to the beginning of the line, using the <- key, and press:

The ECHO said "Disk Volume 254." This is because pressing the RETURN key causes the ECHO to speak the entire line, starting from its current position. When it finishes speaking the line, the cursor will be back at the leftmost position of the same line.

To move the cursor from line to line type:

and you will move up one line. To move down one line type:

When moving up and down the cursor will always move to the beginning of the new line. Try moving to line F (the fifth line) and experiment with these new commands on the first catalog entry. Now move back to line C and type a comma:

The ECHO will say "to" and wait for you to indicate up to what line you would like it to read. You will respond with a letter corresponding to a line number greater than (further along in the text than) the current line. For example press:

The ECHO will now read lines C through G to you.

Finally, pressing:

will exit Line Review Mode, leaving you exactly where you were before you entered it. Since Line Review mode exits with all APPLESOFT variables and pointers intact, you may enter Line Review mode any time a program prompts you for a answer. Simply type:

then review the screen using the appropriate commands and exit Review mode before answering the question.

The heart of the ECHO Two is Texas Instruments' TMS 5200 speech processor. This circuit is an upgraded version of the one used in the Speak & Spell (trademark of Texas Instruments) which models the human vocal tract using LPC (Linear Predictive Coding). Instead of storing the actual speech signal, only those parameters needed to describe each speech sound are stored. This accounts for the compactness of the TEXTALKER system, which takes up no more memory than a HIRES page.

TEXTALKER uses nearly 400 rules of pronunciation and many common exceptions to these rules to analyze a word. After analyzing the word, TEXTALKER generates the standard SPEAKEASY phoneme and pitch codes. TEXTALKER then sends these codes to SPEAKEASY which actually pronounces the word. TEXTALKER is ,therefore, just a simpler way for the user to access SPEAKEASY. You may see the actual codes that TEXTALKER generates by running the PHONEME TRANSLATOR program that you will find on your TEXTALKER MASTER disk.

If you type PR#0 when TEXTALKER is installed, TEXTALKER actually does the equivalent of a PR#0 and an IN#0. Therefere, any device previously activated by a IN#n will be disconected.

To use TEXTALKER when programming in machine language simply do a JSR to "COUT" ($FDED) putting the character to be sent into the accumulator. For example, the following program will result in the ECHO saying "HI."

SPEAKEASY is accessed similarly except that that all phoneme strings must begin with a Control-V ($96) and end with a RETURN ($8D). For example, to say "HI" you would write the following routine:

CHANGING THE FREQUENCY

All ECHOs are set at the factory to speak at the same pitch and rate of speed. However, you may modify this by adjusting the frequency potentiometer (pot) on the ECHO. Adjusting this pot will modify both the pitch and rate of speech. A higher frequency will cause the ECHO to speak faster and with a higher pitch. Lowering the frequency will do the opposite. The pot is in the upper left hand corner of the ECHO, under the word ECHO and above the word "FREQ". Before you make any adjustments, you should do two things: first, turn off the power; second, you should make a small mark on the pot so you will be able to return it to its original position if you desire. Now, insert a small screwdriver in the slot on the pot, and turn it counter clockwise to lower the frequency and clockwise to increase the frequency.

The types of sounds represented by the phoneme codes are divided into six categories. A brief description of each category follows. (It is NOT necessary that you understand these definitions for you to be able to use SPEAKEASY. These brief explanations are provided for your personal enrichment.)

VOWELS: In pronouncing vowels the air flows uninterrupted though the vocal cords and lips. (The English vowels are a,e,i,o and u.)

DIPHTHONGS: These are the combination of two vowel sounds within one syllable. (Commonly there is only one vowel per syllable.) To get a feel for this phenomenon, say the word "cake" very slowly and listen to how the "long a" sound moves into a "y" sound before the final "k."

"R" COLORED VOWELS: The "r" following these vowels modifies the sound of the vowel.

VOICED CONSONANTS and UNVOICED FRICATIVES: Each of the voiced consonants is created by vibrating your vocal cords. Place your fingertips against your adam's apple and say the voiced consonant "zzzzzzzzzz." The sensation you feel with your fingertips is the vibration of the vocal cords. Contrast this with with the lack of sensation which should result when you say the unvoiced fricative "sssssssssss." The "s" sound is not produced by vibrating the vocal cords, but through friction, produced as air flows over various parts of the vocal tract.

STOP CONSONANTS: The flow of air is completely cut off before we pronounce a stop consonant. Say the word "tall." Because the "l" is not a stop consonant, we flow smoothly from the "a" sound to the "l" sound. Now say "tab." "B" is a stop consonant and you will find that you actually pause, very briefly, before you pronounce the "b."

You may use TEXTALKER to make some programs speak which were not explicitly designed to run with a speech synthesizer. You would do this by running a TEXTALKER program before running your program. However, there are limitations:

APPENDIX A - SAMPLE PHONEME VOCABULARY

The ECHO may be used in conjunction with a modem with "automatic answer" capability, to enable you to receive information over the telephone. It can even be used this way as a telephone answering machine. We are including a listing of a sample program which uses the ECHO Two and an Apple-Cat (TM of Novation Inc.) modem with the Touch Tone (TM of the Bell System) decoding option.

This program allows you to telephone your Apple computer and to check and modify an itemized inventory. By following the instructions included with the Apple-Cat modem, you could also develop the capability of storing voice messages on a tape recorder like an answering machine.

Our sample program does the following things. First, when you call your Apple, the modem will answer the phone. The ECHO will then ask you for a password, and then an inventory item number. You respond to these prompts by simply typing in the numbers on any Touch Tone telephone. The modem will decode the Touch Tones and make them available to the program, which will send them to the ECHO to be spoken.

The program has quite a few remark statements, which should help you follow and better understand its logic.

You connect the ECHO to the Apple-Cat as follows:

1. Purchase a cable which has a mini-jack on one end, and stripped wires on the other end. Radio Shack sells one as part number 42-2434.

3. Connect the stripped ends of the cable to the Apple-Cat so that the wire which corresponds to the tip of the cable (positive) is connected to pin 24 of the interface pins on the Apple-Cat. The other wire (negative) must be connected to pin 25. If you are unable to purchase a connector to fit on these pins, you will have to solder the connection. Soldering may, however, void your Apple-Cat warranty - check with Novation.

0 REM ECHO AND APPLE CAT EXAMPLE 4 SL = 2: REM SLOT NUMBER OF CAT 5 DIM C(20),N(20) 7 D$ = CHR$ (4) 8 PW$ = "321": REM THIS IS YOUR PASSWORD 10 REM CAT INVENTORY 20 GOSUB 1000 30 POKE 2040 + SL,0: REM FORCE INITIALIZATION 40 PRINT D$"PR#"SL: PRINT CHR$ (16): PRINT D$"PR#0": REM ENTER PHONE MODE (16= CTRL P) 50 PRINT D$"IN#"SL: REM WAIT FOR A PHONE CALL 60 GET A$: IF A$ = CHR$ (13) THEN 100: REM WE GOT A PHONE CALL 70 IF A$ = "Q" THEN END : REM IF A Q WAS TYPED AT THE KEYBOARD THEN QUIT 80 GOTO 60: REM IF NOT Q THEN TRY AGAIN 100 REM ANSWER PHONE 105 P$ = "" 115 PRINT ",,,,,,,,,,": REM DELAY 120 PRINT "HELLO, PLEASE TYPE IN YOUR PASSWORD" 140 GET A$: IF A$ = CHR$ (13) THEN 900: REM TIME OUT SO HANG UP 150 IF A$ = "#" THEN PRINT : GOTO 170 160 P$ = P$ + A$: GOTO 140 170 IF P$ < > PW$ THEN 900: REM WRONG PASSWORD SO HANG UP 180 PRINT 190 PRINT "PLEASE ENTER PART NUMBER" 195 C$ = "" 210 GET A$: IF A$ = CHR$ (13) THEN 900: REM TIMEOUT SO HANGUP 220 IF A$ = "#" THEN 300: REM END OF PART NUMBER 230 IF A$ = "*" THEN 180: REM '*' MEANS START OVER 240 C$ = C$ + A$ 250 PRINT A$: GOTO 210 300 REM SEE IF VALID PART NUMBER 305 PRINT 310 C = VAL (C$) 320 FOR A = 1 TO X: IF C(A) = C THEN 340 325 NEXT A 330 PRINT "BAD PART NUMBER": GOTO 900: REM IF BAD PART THEN HANG UP 340 PRINT "THE CURRENT INVENTORY OF PART NUMBER "C",IS "N(A)",ITEMS" 350 PRINT ",,,,": REM PAUSE 360 PRINT "ENTER A ONE IF YOU WOULD LIKE TO REMOVE ITEMS FROM INVENTORY" 370 PRINT ",,," 380 PRINT "ENTER A TWO TO CHECK THE INVENTORY OF ANOTHER PART" 390 PRINT ",,," 400 PRINT "ENTER A STAR IF YOU ARE DONE" 420 GET A$: IF A$ = CHR$ (13) THEN 500 430 IF A$ = "*" THEN 900 440 IF A$ = "2" THEN 180 450 IF A$ < > "1" THEN 500 462 K$ = "" 465 PRINT "PLEASE ENTER AMOUNT TO REMOVE" 470 GET A$: IF A$ = CHR$ (13) THEN 500 475 IF A$ = "#" THEN 500 480 IF A$ = "*" THEN 460 490 PRINT A$ 495 K$ = K$ + A$: GOTO 470 500 REM REMOVE ITEMS FROM INVENTORY 510 N(A) = N(A) - VAL (K$) 530 GOTO 340 900 REM HANG UP 905 PRINT "GOOD BYE" 910 PRINT D$"PR#"SL: PRINT CHR$ (26): PRINT D$"PR#0" 920 GOTO 40 1000 REM INIT ARRAY 1010 X = 1 1020 READ C(X),N(X) 1030 IF C(X) = 9999 THEN RETURN 1040 X = X + 1: GOTO 1020 2000 DATA 1234,500 2010 DATA 321,250 2020 DATA 555,365 7060 GET A$: IF A$ = CHR$ (13) THEN 100 9999 DATA 9999,9999