diff --git a/README.md b/README.md index ce3eb11..7717077 100644 --- a/README.md +++ b/README.md @@ -144,6 +144,12 @@ USB-5V -- Speaker + Terminal Basically the transistor acts as a switch and requires only a drive of 1/beta (~1/1000 for the transistor specified) times the speaker current. As shown you've got a max current of (5-0.7)/8=540mA and a power of 0.54^2 * 8 = ~2.3W into the speaker. +## Using external SPI RAM to increase buffer +A class allows you to use a 23lc1024 SPI RAM from Microchip as input buffer. This chip connects to ESP8266 HSPI port and use external SPI RAM library (https://github.com/Gianbacchio/ESP8266_Spiram). +You need to choose another pin than GPIO15 for Cs as this pin is already used by the I2S port. Here is an example with the Cs pin plugged to GPIO00 on NodeMCU board. + +![Example of SPIRAM Schematic](examples/StreamMP3FromHTTP_SPIRAM/Schema_Spiram.png) + ## Notes for using SD cards and ESP8266Audio on Wemos shields I've been told the Wemos SD card shield uses GPIO15 as the SD chip select. This needs to be changed because GPIO15 == I2SBCLK, and is driven even if you're using the NoDAC option. Once you move the CS to another pin and update your program it should work fine. diff --git a/examples/StreamMP3FromHTTP_SPIRAM/Schema_Spiram.png b/examples/StreamMP3FromHTTP_SPIRAM/Schema_Spiram.png new file mode 100644 index 0000000..6633b2e Binary files /dev/null and b/examples/StreamMP3FromHTTP_SPIRAM/Schema_Spiram.png differ diff --git a/examples/StreamMP3FromHTTP_SPIRAM/StreamMP3FromHTTP_SPIRAM.ino b/examples/StreamMP3FromHTTP_SPIRAM/StreamMP3FromHTTP_SPIRAM.ino new file mode 100644 index 0000000..827740a --- /dev/null +++ b/examples/StreamMP3FromHTTP_SPIRAM/StreamMP3FromHTTP_SPIRAM.ino @@ -0,0 +1,62 @@ +#include +#include +#include "AudioFileSourceHTTPStream.h" +#include "AudioFileSourceSPIRAMBuffer.h" +#include "AudioGeneratorMP3.h" +#include "AudioOutputI2SNoDAC.h" + +// To run, set your ESP8266 build to 160MHz, update the SSID info, and upload. + +// Enter your WiFi setup here: +const char *SSID = "....."; +const char *PASSWORD = "....."; + +// Randomly picked URL +const char *URL="http://streaming.shoutcast.com/80sPlanet?lang=en-US"; + +AudioGeneratorMP3 *mp3; +AudioFileSourceHTTPStream *file; +AudioFileSourceSPIRAMBuffer *buff; +AudioOutputI2SNoDAC *out; + +void setup() +{ + Serial.begin(115200); + delay(1000); + Serial.println("Connecting to WiFi"); + + WiFi.disconnect(); + WiFi.softAPdisconnect(true); + WiFi.mode(WIFI_STA); + + WiFi.hostname("melody"); + + byte zero[] = {0,0,0,0}; + WiFi.config(zero, zero, zero, zero); + + WiFi.begin(SSID, PASSWORD); + + // Try forever + while (WiFi.status() != WL_CONNECTED) { + Serial.println("...Connecting to WiFi"); + delay(1000); + } + + file = new AudioFileSourceHTTPStream(URL); + // Initialize 23LC1024 SPI RAM buffer with chip select ion GPIO4 and ram size of 128KByte + buff = new AudioFileSourceSPIRAMBuffer(file, 4, 131072); + out = new AudioOutputI2SNoDAC(); + mp3 = new AudioGeneratorMP3(); + mp3->begin(buff, out); +} + +void loop() +{ + if (mp3->isRunning()) { + if (!mp3->loop()) mp3->stop(); + } else { + Serial.printf("MP3 done\n"); + delay(1000); + } +} + diff --git a/keywords.txt b/keywords.txt index 60df15d..29698b7 100644 --- a/keywords.txt +++ b/keywords.txt @@ -7,6 +7,7 @@ AudioFileSourceICYStream KEYWORD1 AudioFileSourceID3 KEYWORD1 AudioFileSourceSD KEYWORD1 AudioFileSourceBuffer KEYWORD1 +AudioFileSourceSPIRAMBuffer KEYWORD1 AudioGenerator KEYWORD1 AudioGeneratorAAC KEYWORD1 AudioGeneratorFLAC KEYWORD1 diff --git a/src/AudioFileSourceSPIRAMBuffer.cpp b/src/AudioFileSourceSPIRAMBuffer.cpp new file mode 100644 index 0000000..b5f9193 --- /dev/null +++ b/src/AudioFileSourceSPIRAMBuffer.cpp @@ -0,0 +1,153 @@ +/* + AudioFileSourceSPIRAMBuffer + Buffered file source in external SPI RAM + + Copyright (C) 2017 Sebastien Decourriere + Based on AudioFileSourceBuffer class from Earle F. Philhower, III + + This program is free software: you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation, either version 3 of the License, or + (at your option) any later version. + + This program is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + GNU General Public License for more details. + + You should have received a copy of the GNU General Public License + along with this program. If not, see . +*/ + +#include +#include "AudioFileSourceSPIRAMBuffer.h" + +#pragma GCC optimize ("O3") + +AudioFileSourceSPIRAMBuffer::AudioFileSourceSPIRAMBuffer(AudioFileSource *source, uint8_t csPin, uint32_t buffSizeBytes) +{ + Spiram = new ESP8266Spiram(csPin, 40e6); + Spiram->begin(); + Spiram->setSeqMode(); + ramSize = buffSizeBytes; + writePtr = 0; + readPtr = 0; + src = source; + length = 0; + filled = false; + bytesAvailable = 0; + Serial.printf("SPI RAM buffer size: %u Bytes\n", ramSize); +} + +AudioFileSourceSPIRAMBuffer::~AudioFileSourceSPIRAMBuffer() +{ +} + +bool AudioFileSourceSPIRAMBuffer::seek(int32_t pos, int dir) +{ + // Invalidate + readPtr = 0; + writePtr = 0; + length = 0; + return src->seek(pos, dir); +} + +bool AudioFileSourceSPIRAMBuffer::close() +{ + return src->close(); +} + +bool AudioFileSourceSPIRAMBuffer::isOpen() +{ + return src->isOpen(); +} + +uint32_t AudioFileSourceSPIRAMBuffer::getSize() +{ + return src->getSize(); +} + +uint32_t AudioFileSourceSPIRAMBuffer::getPos() +{ + return src->getPos(); +} + +uint32_t AudioFileSourceSPIRAMBuffer::read(void *data, uint32_t len) +{ + uint32_t bytes = 0; + // Check if the buffer isn't empty, otherwise we try to fill completely + if (!filled) { + uint8_t buffer[256]; + writePtr = readPtr = 0; + uint16_t toRead = sizeof(buffer); + // Fill up completely before returning any data at all + Serial.println("Buffering..."); + while (bytesAvailable!=ramSize) { + length = src->read(buffer, toRead); + if(length>0) { + Spiram->write(writePtr, buffer, length); + bytesAvailable+=length; + writePtr = bytesAvailable % ramSize; + if ((ramSize-bytesAvailable)(data); + uint32_t toReadFromBuffer = (len < bytesAvailable) ? len : bytesAvailable; + if (toReadFromBuffer>0) { + // Pull from buffer until we've got none left or we've satisfied the request + Spiram->read(readPtr, ptr, toReadFromBuffer); + readPtr = (readPtr+toReadFromBuffer) % ramSize; + bytes = toReadFromBuffer; + bytesAvailable-=toReadFromBuffer; + len-=toReadFromBuffer; + ptr += toReadFromBuffer; + } + + // If len>O there is no data left in buffer and we try to read more directly from source. + // Then, we trigger a complete buffer refill + if (len) { + bytes += src->read(ptr, len); + bytesAvailable = 0; + filled = false; + } + return bytes; +} + +void AudioFileSourceSPIRAMBuffer::fill() +{ + // Make sure the buffer is pre-filled before make partial fill. + if (!filled) return; + + // Now trying to refill SPI RAM Buffer + uint8_t buffer[128]; + // Make sure there is at least buffer size free in RAM + if ((ramSize - bytesAvailable)readNonBlock(buffer, sizeof(buffer)); + if (cnt) { + Spiram->write(writePtr, buffer, cnt); + bytesAvailable+=cnt; + writePtr = (writePtr + cnt) % ramSize; +#ifdef SPIBUF_DEBUG + Serial.printf("SockRead: %u | RamAvail: %u\n", cnt, bytesAvailable); +#endif + } + return; +} + +bool AudioFileSourceSPIRAMBuffer::loop() +{ + if (!src->loop()) return false; + fill(); + return true; +} diff --git a/src/AudioFileSourceSPIRAMBuffer.h b/src/AudioFileSourceSPIRAMBuffer.h new file mode 100644 index 0000000..2802444 --- /dev/null +++ b/src/AudioFileSourceSPIRAMBuffer.h @@ -0,0 +1,61 @@ +/* + AudioFileSourceSPIRAMBuffer + Buffered file source in external SPI RAM + + Copyright (C) 2017 Sebastien Decourriere + Based on AudioFileSourceBuffer class from Earle F. Philhower, III + + This program is free software: you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation, either version 3 of the License, or + (at your option) any later version. + + This program is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + GNU General Public License for more details. + + You should have received a copy of the GNU General Public License + along with this program. If not, see . +*/ + +#ifndef _AUDIOFILESOURCESPIRAMBUFFER_H +#define _AUDIOFILESOURCESPIRAMBUFFER_H + +#include "AudioFileSource.h" +#include +#include // https://github.com/Gianbacchio/ESP8266_Spiram + +// #define SPIBUF_DEBUG + +class AudioFileSourceSPIRAMBuffer : public AudioFileSource +{ + public: + AudioFileSourceSPIRAMBuffer(AudioFileSource *in, uint8_t csPin, uint32_t bufferBytes); + virtual ~AudioFileSourceSPIRAMBuffer() override; + + virtual uint32_t read(void *data, uint32_t len) override; + virtual bool seek(int32_t pos, int dir) override; + virtual bool close() override; + virtual bool isOpen() override; + virtual uint32_t getSize() override; + virtual uint32_t getPos() override; + virtual bool loop() override; + + private: + virtual void fill(); + + private: + AudioFileSource *src; + ESP8266Spiram *Spiram; + uint32_t ramSize; + uint32_t writePtr; + uint32_t readPtr; + uint16_t length; + uint32_t bytesAvailable; + bool filled; +}; + + +#endif +