diff --git a/docs/api.md b/docs/api.md index f1d1e93..fb0f1c6 100644 --- a/docs/api.md +++ b/docs/api.md @@ -238,113 +238,6 @@ length (int) : number of samples to write nothing -#### Example - -``` -/* - - Demonstrates the use of the Audio library for the Arduino Due - - Hardware required : - *Arduino shield with a SD card on CS 4 (the Ethernet shield will work) - *Audio amplifier circuit with speaker attached to DAC0 - - Original by Massimo Banzi September 20, 2012 - Modified by Scott Fitzgerald October 19, 2012 - -*/ - -#include -#include -#include - -void setup() -{ - // debug output at 9600 baud - Serial.begin(9600); - - // setup SD-card - Serial.print("Initializing SD card..."); - if (!SD.begin(4)) { - Serial.println(" failed!"); - return; - } - Serial.println(" done."); - // hi-speed SPI transfers - SPI.setClockDivider(4); - - // 44100Khz stereo => 88200 sample rate - // 100 mSec of prebuffering. - Audio.begin(88200, 100); -} - -void loop() -{ - int count=0; - - // open wave file from sdcard - File myFile = SD.open("test.wav"); - if (!myFile) { - // if the file didn't open, print an error and stop - Serial.println("error opening test.wav"); - while (true); - } - - const int S=1024; // Number of samples to read in block - short buffer[S]; - - Serial.print("Playing"); - // until the file is not finished - while (myFile.available()) { - // read from the file into buffer - myFile.read(buffer, sizeof(buffer)); - - // Prepare samples - int volume = 1024; - Audio.prepare(buffer, S, volume); - // Feed samples to audio - Audio.write(buffer, S); - - // Every 100 block print a '.' - count++; - if (count == 100) { - Serial.print("."); - count = 0; - } - } - myFile.close(); - - Serial.println("End of file. Thank you for listening!"); - while (true) ; -} -``` - -## Functions - -### `writes()` - -#### Description - -Writes an audio signal from a buffer to DAC0 and DAC1. - - -#### Syntax - -Audio.write(buffer, length); - - -#### Parameters - -buffer (short) : the named buffer with the audio file. - -length (int) : number of samples to write - - -#### Returns - -nothing - - #### Example ```