https://github.com/swharden/numberspeaker

Arduino library for reading numbers using a speaker
https://github.com/swharden/numberspeaker

accessibility arduino audio speaker voice

Last synced: 3 months ago
JSON representation

Arduino library for reading numbers using a speaker

• Host: GitHub
• URL: https://github.com/swharden/numberspeaker
• Owner: swharden
• License: mit
• Created: 2023-08-19T02:08:23.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2023-09-17T22:18:29.000Z (over 1 year ago)
• Last Synced: 2024-05-29T17:16:39.228Z (8 months ago)
• Topics: accessibility, arduino, audio, speaker, voice
• Language: C
• Homepage: https://swharden.com/blog/2023-08-19-speaking-microcontroller/
• Size: 637 KB
• Stars: 5
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# NumberSpeaker

[![CI](https://github.com/swharden/NumberSpeaker/actions/workflows/arduino.yaml/badge.svg)](https://github.com/swharden/NumberSpeaker/actions/workflows/arduino.yaml)

**NumberSpeaker is an Arduino library for reading numbers using a speaker.** A human voice from WAV files is encoded into bytes which are stored in program memory and played back using PWM to drive a speaker. The audio waveforms are stored in memory and occupy about half of the Arduino's program space.

**Example (Video):** https://swharden.com/static/2023/08/19/numbers.webm

![](dev/arduino-speaker.jpg)

## Quickstart

* Connect a speaker to `pin 11`

* Open the Arduino IDE and create a new sketch

* Press `CTRL+SHIFT+i` to open the library manager

* Search for `NumberSpeaker` and select `Install`

* Paste the following into your sketch

```cpp

#include 

NumberSpeaker numberSpeaker = NumberSpeaker();

void setup() {

  numberSpeaker.begin(); // connect a speaker to pin 11

}

void loop() {

  numberSpeaker.speak_int(1234567);

  delay(500);

  numberSpeaker.speak_float(123.4567);

  delay(500);

  numberSpeaker.speak_string("69.420.42");

  delay(500);

  numberSpeaker.speak_char('6');

  numberSpeaker.speak_char('.');

  numberSpeaker.speak_char('9');

  delay(500);

  for (;;) {}

}

```

## Additional Resources

* [Speaking Numbers with a Microcontroller](https://swharden.com/blog/2023-08-19-speaking-microcontroller/) - A blog post describing the strategy used to encode audio files, store them in program memory, and play them back using a speaker.

* [Play Audio from SPI Flash with a Microcontroller](https://swharden.com/blog/2023-08-26-spi-flash-audio/) - A blog post describing how to use a microcontroller to drive a speaker using PWM from audio levels stored in a SPI flash chip. This strategy is useful for users who wish to play longer audio clips or use less program memory.

* [Talkie](https://www.arduino.cc/reference/en/libraries/talkie/) is an official Arduino speech synthesis library. It is a software implementation of the [Texas Instruments speech synthesis architecture](https://en.wikipedia.org/wiki/Texas_Instruments_LPC_Speech_Chips) from the late 1970s. I found the voice to be poor quality for reading numbers, but it may be useful to users seeking more complex phrases or who are concerned about demands on program memory.