The APPLE II Mockingboard card - Manual (ASCII text format) From: Charles T. 'Dr. Tom' Turley Date: 6/19/99 Email: cturley@grin.net My special thanks go to laserdog for the OCR scan from the original and sending it to me in MS Word (rlf) file format, within a zip file archive. The original of this is also included in the file: mockingboard.zip, for those who can also process it, view it and use it, in it's original file format. Many thanks also go to Rubywand for helping with conversion from MS Word to ASCII text file format and sending it to me for compiling this 8 part text file series. I hope it's not to complicated for your needs and proves to be of some useful reference value. Cheers, Tom ---------------------------------------------------------------------------------- CONTENTS PREFACE 0-1 CONTENTS 0-2 SYSTEM REQUIREMENT 0-4 MOCKINGBOARD DIAGRAM 0-5 INSTALLATION 0-6 INTRODUCTION TO THE MANUAL 0-8 SPEECH 1-1 Add Inflection with the Director's Cues 1-2 Add Texture to the Voice 1-5 Soft to Loud Voice 1-6 Low to High Voice 1-6 Slow to Fast Voice 1-7 Alter the Voice Quality 1-7 Pulling it All Together 1-8 Save the Words Created 1-8 The Rule Table 1-9 A Word About Phonemes 1-9 How To Make Changes To the Rule Table 1-10 Let's Hear It 1-12 Locate the Source of the Problem 1-13 How to Read a Rule 1-13 Create a New Rule 1-17 Make Corrections 1-19 Save the Changes 1-20 Delete a Rule 1-21 Other Useful Commands 1-22 One Final Instruction 1-23 SOUND 2-1 A Few Words About the Sound Utility 2-1 What You Need to Know About Sound 2-2 SOUND (continued) MOCKINGBOARD "Knobs" 2-3 Getting Acquainted 2-3 Noise Only Sound Effects 2-7 Turn On Noise Only 2-8 Setting Amplitude 2-9 What Makes a Train Sound Not a Gunshot? 2-9 How Fast is the Train Going? 2-10 Change a Train into a Helicopter 2-11 Change a Helicopter into a Gunshot 2-11 Tone Only Sound Effects 2-11 Start Fresh with a Clean Screen 2-13 Turn On Tone Only 2-13 Set the Amplitude 2-13 Create Musical Notes 2-13 Play a Note 2-14 Play a Chord 2-14 Play Two Chords 2-14 PROGRAMMING 3-1 The Sound Chips 3-2 How the Sound Parameters are Set on the Chip 3-2 Summary of Primary Routines and Table Access Routine 3-5 Siren Sound Effect 3-6 The Speech Chips 3-12 Using Text to Speech and the Rule Table in Your Program 3-15 APPENDIX A Phoneme Charts A-1 APPENDIX B Programmable Sound Generator Registers A-3 APPENDIX C Noise and Tone Enable Register A-4 APPENDIX D Envelope Shape Register A-5 APPENDIX E Equal Tempered Chromatic Scale A-6 APPENDIX F Assembly Language Program Listing A-9 LIMITED WARRANTY O-4 SYSTEM REQUIREMENT Apple II, II+ or Ile 48K RAM 1 Disk Drive Monitor 2 External 8 ohm Speakers CAUTION The demonstration disk included in the package contains a wide variety of demonstrations and utilities which uses most of the available disk space. Utilities such as the Rule Editor for the text to speech portion and Sound Utility allow you to save additional files. If you plan to use the utilities, please separate the sound and speech portions so that you will have adequate room to expand. The following procedure should be followed. Catalog your disk and note the file name "S/ONLY." Below this file are all the files related to the speech demonstration. Save these files onto a fresh disk with S/ONLY and use the new disk as a work disk. Your HELLO or file name used to init the disk should run the file name S/ONLY. Load SPEECH from the new disk and change line #I 50 to read I 50 END and delete line #75. You may also wish to do the same with the remaining sound portion and save the original disk as back up. MAKE A BACK UP DISK BEFORE USING THE UTILITIES. Included on the demonstration disk are two speech r elated programs to allow you to enter unlimited words and have them spoken back. Also, the Text Reader program will read back any text saved as a text file, not just those created using Text Maker. To use the Text Reader and Maker, please run Text Reader and enter the file name HELP. This file was created using Text Maker and will provide you with the necessary instructions to utilize both programs. 0-5 1. 2-Sound Chip 2. 2-6522 Versatile Interface Adapter 3. Volume Control for Top Row of Sound/Speech Chips 4. Volume Control for Bottom Row of Sound/Speech Chips 5. Audio Cable Connector 6. 2-½ watt Audio Amplifier Chip 7. Speech Chips/Sockets for Speech Chip 8. Gold Placed Edge Connector Audio Cable a. Female Plug b. 2-RCA Phono Jacks 0-6 INSTALLATION We know lots of companies claim a child can install their products. But, what does one do if no child is available? Sweet Micro Systems has written these installation instructions for adults. SETUP 1. Turn off your computer and remove its cover. 2. Discharge any static electricity by touching the metal power supply casing. 3. Remove MOCKINGBOARD and audio cable (9) from the package. Hold MOCKINGBOARD by its edges. Avoid touching the gold plated edge connector (8). The oil from your hands may contaminate the connector and cause a poor electrical connection. 4. Extend the audio cable (9) fully. 5. Connect the female plug (9a) end of the cable to the audio cable connector (5) located on MOCICINGBOARD. 6. Insert MOCKINGBOARD into slot 4 of the Apple's peripheral slots located at the rear of the Apple. Gently rock MOCKINGBOARD until it is properly seated. MOCKINGBOARD is not slot dependent. While MOCK- INGBOARD can be configured for any slot except Slot 0, the demonstration disk was specifically written for slot 4. 7. Connect the RCA phono jack-ends of the audio cable (9b) to the speakers. MOCKINGBOARD has two ½ watt amplifier chips (6) on board to directly connect it to your speakers. You may use an external amplifier. If you do so, connect the RCA phono jack-end of the cable to the stereo amplifier auxiliary inputs. GETTING STARTED 8.Leave the cover off the computer until you have had a chance to adjust the volume. The volume control knobs (3) and (4) are grey disks located at the top rear of the board. These knobs are thumbwheel devices. No tool is necessary to make adjustments, just your thumb. Simply roll the wheel back and forth to adjust the volume. 0-7 9. Place the demonstration disk in the drive and boot the disk. Select SOUND EFFECTS DEMONSTRATION from the menu. This demonstration is presented in a menu form. You may hear the sound effects in any order and as many times as you wish. The sounds alternate between speakers, that is, the first selection is played on one speaker, the next sound effect is on the other speaker. 10. Type A for GUNSHOT. Adjust the volume with one of the volume control knobs, (3) or (4). To lower the volume, roll the knob away from you as MOCKINGBOARD sits in the computer, or towards you to raise it. Type B for MACHINE GUN. Adjust the volume with the other volume control knob. Lower or raise the volume as described above. The BOMB sound effect jumps from one speaker to the other. Some, like CLOCK, play continuously until you select another letter. You may also play two sounds at the same time on separate speakers. A and B will play at the same time, but A and C will not because they use the same speaker. 11. To return to the Main Menu, press the key. 12. Select A from the Main Menu for speech and select A again for a message from Sweet Micro Systems. If your board has the gift of speech, your message will be audible. 13. If your MOCKINGBOARD has a speech chip, select Text To Speech to type and have MOCKINGBOARD speak. When MOCKINGBOARD is ready, a question mark will appear at the top of the screen. Type any word or phrase and then press the return key. When MOCKINGBOARD has finished speaking what you have typed, the question mark will reappear. Type some more words or phrases. You may type as many as 239 characters at one time. To return to the Main Menu, type QUIT. This demonstration disk contains other examples of MOCKINGBOARD's capabilities. In addition, utilities have been included to allow you to further explore both sound and speech. Have fun. In order that you may progress at your own pace, this manual has been separated into sections. The first section is Speech. Here, you will learn to develop different personalities for MOCKINGBOARD using interesting expressions and voices. If you would like to, delve deeper and learn to correct mispronounced words. 0-8 The second section is Sound. learn to develop, modify or completely change sound effects. Take a ping and change it to a plunk or start with an explosion and change it into a train. Learn about how MOCKINGBOARD produces sounds and how to create them from scratch. The third section is Programming. Learn how to include sound and speech you created into your own programs. if you don't have a program in mind, you will after you explore the many possibilities for sound and speech enhancements. INTRODUCTION TO THE MANUAL Think of MOCKINGBOARD as the telephone of a friend you wish to call. In order to call a friend, you need the area code and phone number. During the conversation, information flows back and forth. Communication with MOCKINGBOARD is almost as simple as calling someone on the phone. The concept of communicating to MOCKINGBOARD is often over looked. When you ran the demonstration, you made sounds flow from your speakers just by pushing a few keys. Trying to duplicate these sounds in your own programs takes a bit more effort. The programming is simple; the concepts behind it are not. Telephones are connected to each other by lines through which our conversations are transmitted. Since we share lines with others, a direct line must be opened specifically for the two phones. This line is opened when you dial a phone number and someone picks up that phone. Communicating to MOCKINGBOARD works the same way. The circuitry in your Apple allows you to transmit information directly to MOCKINGBOARD, but a direct line must first be opened. The slot number in which MOCKINGBOARD resides can be thought of as an area code, The "phone number" pinpoints a chip on MOCKINGBOARD. MOCKINGBOARD has two chips which have their own "phone number" and may be "called" individually. These chips act as a switchboard routing all in-coming and outgoing "calls" to and from the Apple and MOCKINGBOARD's sound and speech chips. You are the director/composer of MOCKINGBOARD sounds and speeches. This manual will step you through their creation and give you the necessary background information required along the way. First, we'll create sound/speech using the utilities provided on the demonstration disk. Then, we'll show you how to use the sounds created in a program. 1-1 SPEECH Man's ability to articulate sounds for the purpose of communicating ideas distinguishes him from the rest of the animal kingdom. This ability, which we now take so much for granted, was once thought to have been conferred upon man by the gods themselves. In the Book of Genesis, for example, Adam is given the power of speech by the Lord in order to name the animals, thereby demonstrating his likeness to God. Given such history, it is not surprising that man perceived the power of speech as an integral part of his quest for divinity. As man evolved and had more needs and desires to articulate, a complex system of speech organs was developed in order to provide a more varied and sophisticated means of expression. The human voice is now capable of a wide range of sounds from grunts to operatic cadences. It was only natural that, as man's brainchild, the computer became more complex and imitative of human abilities, it would reach a stage of evolution which would require the ability to communicate in a more human fashion. MOCKINGBOARD gives your computer the power of speech. Like a human, it will read text aloud pronouncing each word according to a series of rules. These rules are the basis for Sweet Micro Systems' method of converting text into a code MOCKINGBOARD can understand. MOCKINGBOARD will allow you to introduce expression into the voice. Expression is important to the intelligibility and the meaning of the words spoken. The Sweet text to speech program automatically sets the speech parameter s for general use and allows you to introduce stress and intonation to text by using special markers. You may change these parameters to create interesting voices. There are many exceptions to standard pronunciation rules. Names are especially difficult and are frequently mispronounced. Remember how your teacher stumbled through her class list on the first day of school? How disappointed you must have been if your name was incorrectly announced to the class! If MOCKINGBOARD has trouble with your name or names of family members and friends, you can easily correct it and we'll show you how. We know the name, Robert, is mispronounced. We will step through the corrections necessary, and in the process tell you about MOCKINGBOARD's features, capabilities and our method of converting text into speech. 1-2 A special section explains how to enhance your programs with speech you create using the Rule Editor or using the text to speech program right in a program of your own creation. ADD INFLECTION WITH THE DIRECTOR'S CUES MOCKINGBOARD is all set to start talking. With a little assistance, MOCKINGBOARD will express itself with the use of inflection or pitch patterns, and show emotion. Limited use of inflection is automatically performed by the program. For example, it recognizes punctuation marks and responds accordingly. You will be able to employ inflection more creativity as you compose your sentences. Boot your demonstration disk and select A for speech and then select the Rule Editor from the Speech menu. You will be asked to SELECT CHARACTER TABLE TO EDIT. Type A and the A rule table will appear. Type T for Test Mode at ENTER COMMAND. Now we are ready to proceed. The cursor, next to the question mark, is ready for you to type in a word. After you type the word, press the return key. The word will be spoken at an average speed, in an average voice with minimal variation or emotional coloring. These speech characteristics have been preset to normally used values. If you would like MOCKINGBOARD to be more expressive, you may take advantage of its interpretive talents. MOCKINGBOARD's theatrical abilities are not to be underestimated. Fine actors, regardless of their talent, require good directors. MOCKINGBOARD may be directed by inserting special markers into the text as it is typed in. These markers will tell MOCKINGBOARD when to show emotion, It already recognizes normal punctuation marks, such as commas, periods and question marks, and will respond with an appropriate pause, or raise or lower its voice. You may also place emphasis on a particular word or syllable, by inserting slash key stress markers (/) as cues to indicate when MOCKINGBOARD should play up a scene. From the Test Mode, enter the word, "Hello," at the prompt. Think, like a good director, of the different ways that HELLO can be interpreted. When an actor speaks, he conveys emotion by changing the pitch, volume, and rate at which he speaks. Press return and listen. How could you make this word more expressive? Try typing in the following examples. Each time you wish to clear an entry, type N for new entry. Should you wish MOCKINGBOARD to repeat itself, type R for repeat. The comments to the right explain 1-3 what effect the markers have on the word. (Note: You do not have to type the question mark, it will appear automatically. ?HELLO ....would have no variation in stress ?/HE/LLO ....would stress HE ?HELL/O/ ....would stress O ?HELLO? ....would cause a rise in pitch at the end ?HELLO. ....would cause a drop in pitch at the end Other combinations of punctuation marks and stress marks are also possible. Stress markers generally work in pairs, but you may insert any number of them into a text. The number of stress markers and their position will determine how each word or syllable will be spoken. Be experimental! Try typing the following examples, and listen to MOCKINGBOARD perform. INFLECTION DIAGRAM I: DECLARATIVE SENTENCE Mary had a /li/ttle lamb. MOCKINGBOARD has just described Mary's pet. Diagram I shows the inflection pattern, or the rate of change of pitch, for a basic declarative sentence, which emphasizes the lamb's size. The English language has several levels of pitch. Our text to speech method approximates these levels by using four main pitch levels. These levels are designated by the digits which appear on the left side of the diagram. "Mary had a little lamb" is spoken at pitch level two until the first stress marker is encountered. At the first stress marker, the pitch rises from level 2 to level 3. It will remain at level three until another marker is encountered. At the second stress marker, the pitch will glide up or down depending on the final punctuation. A period at the end of a sentence, as in this example, indicates a drop in pitch. If no final punctuation mark exists, then a period is assumed. 1-4 lf we want MOCKINGBOARD to show more feeling, we must give it additional direction. Try typing, "/Mar/y had a/li/ttle lamb." INFLECTION DIAGRAM 2 /Mar/y had a /li/ttle lamb. This diagram shows the change of pitch for a declarative sentence with more than two stress markers. In this example, the pitch starts at level 3 and rises to level 4 upon reaching the first marker. The second marker signals a drop in pitch to level 2. Upon reaching the next pair of markers, the pitch level will again rise and then fall until the period is encountered. MOCKINGBOARD's recitation of "Mary had a little lamb" deserves an ovation. The dual stress pattern was interpreted with greater emphasis on the first pair of markers than on the second, Such a stress pattern, in which the initial stress is more emphatic than stresses which follow, is typical of the English language, Perhaps you would like MOCKINGBOARD to ask some questions about Mary?. Let's change some of the cues and try some interrogatives. Type "Mary had a/li/ttle lamb?" INFLECTION DIAGRAM 3, INTERROGATORY STATEMENT Mary had a /li/ttle lamb? If you compare this recitation with INFLECTION DIAGRAM I, you will see that the performance differs only at the end where the different cue has caused a rise in pitch instead of a drop. The difference in pitch may appear to be insignificant, but we must remember that pitch assists us in interpreting a speaker's intent and helps us to recognize when he is stating or questioning. We are now doubting the lamb's small size. 1-5 The director's cues are actually much more sophisticated than they may appear. The stress markers not only cause MOCKINGBOARD to change its pitch, but also its volume, the number of words spoken per second and finally, the voice itself. When a syllable is stressed, it generally becomes louder, the speech rate slows to make the syllable longer, and the voice quality changes slightly. You can achieve all of these theatrical effects simply by typing in normal punctuation and experimenting with the stress markers. -end of Part 1-