|
SpeakJet
|
Driver object for SpeakJet chips such as on SparkFun VoiceBox shield https://www.sparkfun.com/products/10661. More...
#include <SpeakJet.h>
Classes | |
| struct | DictionaryEntry |
| Structure for translating text words into SpeakJet codes. More... | |
Public Member Functions | |
| SpeakJet (uint8_t txPin=2, uint8_t resetPin=3, uint8_t readyPin=4) | |
| bool | init () |
| bool | reset () |
| bool | isReady () |
| void | waitReady () |
| void | speakCode (uint8_t code) |
| void | speakCodes (uint8_t *codes) |
| bool | speakDictionaryEntry (DictionaryEntry *dict) |
| bool | speakWordFromDictionary (const char *word, DictionaryEntry *dict) |
| bool | speakWordsFromDictionary (char *words, DictionaryEntry *dict) |
| bool | speakWord (const char *word) |
| bool | speakWords (char *words) |
| bool | speakDigits (const char *digits) |
| bool | speakNumber99 (uint8_t n) |
| bool | speakNumber999 (uint16_t n) |
| bool | speakNumber (uint32_t n) |
Driver object for SpeakJet chips such as on SparkFun VoiceBox shield https://www.sparkfun.com/products/10661.
Uses SoftwareSerial class to send command codes to the SpeakJet chip. Supports a wide range of funcitons for speaking words, phrases, numbers and strings of digits.
Command codes for SpeakJet chip. These can be passed to speakCode(). Arrays of them can be passed to speakCodes(), with an EndOfPhrase at the end. Based on http://www.sparkfun.com/datasheets/Components/General/speakjet-usermanual.pdf
| SpeakJet::SpeakJet | ( | uint8_t | txPin = 2, |
| uint8_t | resetPin = 3, |
||
| uint8_t | readyPin = 4 |
||
| ) |
Constructor. Specifies the Arduino digital pins to use to communicate with the SpeakJet chip. The default values of the arguments are suitable for use with the standard SparkFun VoiceBox shield. You can have multiple instances to talk to different SpeakJet chips, provided they use interface pins.
| [in] | txPin | Digital pin to use to send command codes to the SpeakJet. Defaults to 2. |
| [in] | resetPin | Digital pin to use to force a reset of the SpeakJet. Defaults to 3. |
| [in] | readyPin | Digital pin to use to read if the SpeakJet is ready for another code. Defaults to 4, the SPK pin output from the SpeakJet chip. |
| bool SpeakJet::init | ( | ) |
Object initialiser. This causes the digital interface pins in the constructor to be set for input or output as the case may be The SoftwareSerial interface is initialised to 9600 baud, and the SpeakJet is reset by forcing the Reset pin high for 100ms.
References reset().
| bool SpeakJet::isReady | ( | ) |
Check if the SpeakJet chip is ready to receive another code. Reads the state of the readyPin configured in the constructor. Low is ready.
Referenced by waitReady().
| bool SpeakJet::reset | ( | ) |
| void SpeakJet::speakCode | ( | uint8_t | code | ) |
Speak a single phoneme code. Waits until the SpeakJet chip is ready, then sends a single code (one of the CommandCodes enum entries) This is the basic function used to send all codes to the chip. Can also be used to sen control codes like Pause, Volume Speed etc to control the enunciation of following Phonemes. Returns after the code has been sent.
| [in] | code | One of the CommandCodes enum entries or a raw code number |
References waitReady().
Referenced by speakCodes(), speakDictionaryEntry(), speakDigits(), speakWords(), and speakWordsFromDictionary().
| void SpeakJet::speakCodes | ( | uint8_t * | codes | ) |
Speak a an array of phoneme codes. Waits until the SpeakJet chip is ready, then sends a single code (one of the CommandCodes enum entries) This is the basic function used to send all codes to the chip. Returns after the code has been sent.
| [in] | codes | Array of command codes, terminated by EndOfPhrase (255) |
References EndOfPhrase, and speakCode().
| bool SpeakJet::speakDictionaryEntry | ( | DictionaryEntry * | dict | ) |
Speaks a single dictionary entry This low level function sends the code array of a DictionaryEntry to the SpeakJet chip. You can call it from your own sketches, but it probably rarely necessary.
| [in] | dict | Pointer to a DictionaryEntry in PROGMEM |
References SpeakJet::DictionaryEntry::codes, EndOfPhrase, and speakCode().
Referenced by speakWordFromDictionary().
| bool SpeakJet::speakDigits | ( | const char * | digits | ) |
Speak the digits in a string. Each digit (and some punctuation) is spoken one charavcter at a time. Suported are:
| [in] | digits | String of digits to be spoken, one at a time |
References Pause1, speakCode(), and speakWordFromDictionary().
| bool SpeakJet::speakNumber | ( | uint32_t | n | ) |
Speaks an integer number from 0 to (2^32 -1) Converts the integer into an conventional English phrase for saying he number out loud such as: 0 -> "zero" 9 -> "nine" 10 -> "ten" 999 -> "nine hundred and ninety nine" 1000 -> "one thousand" 1001 -> "one thousand and one" 65377 -> "sixty five thousand three hundred and seventy seven"
| [in] | n | integer number from 0 to (2^32 -1) |
References speakNumber99(), speakNumber999(), and speakWordFromDictionary().
| bool SpeakJet::speakNumber99 | ( | uint8_t | n | ) |
Speaks an integer number from 0 to 99 This low level function is used internally, and you probably would not need to call it from your sketch. See instead speakNumber()
| [in] | n | Integer from 0 to 99. Returns false if the number exceeds 99. |
References speakWordFromDictionary().
Referenced by speakNumber(), and speakNumber999().
| bool SpeakJet::speakNumber999 | ( | uint16_t | n | ) |
Speaks an integer number from 0 to 999 This low level function is used internally, and you probably would not need to call it from your sketch. See instead speakNumber()
| [in] | n | Integer from 0 to 99. Returns false if the number exceeds 999. |
References speakNumber99(), and speakWordFromDictionary().
Referenced by speakNumber().
| bool SpeakJet::speakWord | ( | const char * | word | ) |
Speak a word from the standard Dictionary. If the word is present in the standard dictionary, the codes will be sent to the SpeakJet chip.
| [in] | word | The word to speak in the dictionary |
References speakWordFromDictionary().
Referenced by speakWords().
| bool SpeakJet::speakWordFromDictionary | ( | const char * | word, |
| DictionaryEntry * | dict | ||
| ) |
Speaks a single word from a Dictionary. Searches a Dictionary for an exactly matching word and then sends the corresponding codes to the SpeakJet chip. Caution: A linear search is currently used.
| [in] | word | The word to speak in the dictionary |
| [in] | dict | Pointer to the first of a set of DictionaryEntry structures, one for each word in the Dictionary. |
References speakDictionaryEntry(), and SpeakJet::DictionaryEntry::word.
Referenced by speakDigits(), speakNumber(), speakNumber99(), speakNumber999(), speakWord(), and speakWordsFromDictionary().
| bool SpeakJet::speakWords | ( | char * | words | ) |
Speak a sequence of words from a standard Dictionary.
| [in] | words | String of space separated words |
References Pause1, speakCode(), and speakWord().
| bool SpeakJet::speakWordsFromDictionary | ( | char * | words, |
| DictionaryEntry * | dict | ||
| ) |
Speak a sequence of words from a Dictionary. The sequnce of words is spit by whitespace and the individual words are spoken one after another, with a Pause1 between each word.
| [in] | words | String of space separated words |
| [in] | dict | Pointer to the first of a set of DictionaryEntry structures, one for each word in the Dictionary. |
References Pause1, speakCode(), and speakWordFromDictionary().
| void SpeakJet::waitReady | ( | ) |
Wait until the SpeakJet chip is ready. Blocks until isReady() return true.
References isReady().
Referenced by speakCode().
1.8.1