LPM11162 Arduino Library
Autore: LP ELETTRONICA
Contatti: info@lpelettronica.it
www.lpelettronica.it
LPM11162 Arduino Library
History
2011-05-04: Release iniziale per Arduino (v.1)
Indice
LPM11162 Arduino Library
Introduzione
LPM11162 è un modulo audio dotato di memoria flash interna che consente di memorizzare e successivamente riprodurre file audio in formato WAV.
L'interfaccia seriale consente il collegamento diretto ad un PC per la memorizzazione dei file audio. Collegandolo poi ad una scheda con microcontrollore (ad esempio Arduino) è possibile richiamare per nome i singoli file memorizzati e riprodurli istantaneamente sull'uscita analogica.
La LPM11162 Arduino Library rende immediato tutto questo, così la riproduzione di file WAV diventa estremamente semplice.
Funzioni
begin(txpin, resetpin, busypin, baudrate)
Apre la comunicazione con il modulo audio LPM11162 dopo aver opportunamente configurato i pin da utilizzare su Arduino.
end()
Chiude la comunicazione con il modulo LPM11162.
play(FileName)
Inizia istantaneamente la riproduzione di un file WAV. Il nome del file viene passato come parametro alla funzione.
stop()
Interrompe istantaneamente la riproduzione del file WAV in corso.
volume(volume)
Imposta il livello di volume per la riproduzione. Il parametro passato alla funzione è un numero 0-100 che rappresenta la percentuale di volume (0%-minimo, 100%-massimo).
isBusy()
Durante la riproduzione di un file audio il pin /BUSY del modulo LPM11162 resta a livello basso per indicare che il modulo è occupato nella riproduzione. Questo consente al microcontrollore di sapere se la riproduzione precedentemente avviata con la funzione play() è terminata oppure no, in modo da poter accodare diversi suoni come ad esempio messaggi vocali.
La funzione isBusy() consente di monitorare lo stato del pin /BUSY e di sapere se la riproduzione è in corso.
reset(resetLevel)
Pilota direttamente il pin di /RESET del modulo LPM11162. Generalmente non è usata poichè la linea di /RESET è automaticamente controllata chiamando la funzione begin(), ma può essere utile in qualche caso particolare.
Esempio di utilizzo
Il seguente esempio mostra come configurare la libreria per LPM11162 per utilizzare il pin 4 di Arduino per controllare il TX del modulo LPM11162, il pin 3 per il /RESET ed il pin 2 per /BUSY. Inoltre, sempre con la chiamata alla Begin() viene indicato il baudrate da utilizzare (9600 bps).
L'inizializzazione si conclude impostando il volume di uscita del modulo audio LPM11162 al 50% con la chiamata alla volume().
Il loop eseguito da questa semplice applicazione di esempio è costituito dalla chiamata alla funzione play() a cui viene passato il nome del file da riprodurre ("MyFile.wav"), che deve essere stato precedentemente memorizzato nella memoria flash interna al modulo LPM11162. Segue un delay di 2 sec. per poi riprodurre nuovamente il suono memorizzato.
NOTA: la libreria si appoggia alla libreria NewSoftSerial per la comunicazione seriale. Pertanto è necessario installarla e provvedere all'inclusione tramite la direttiva di #include come nel seguente esempio.
#include <NewSoftSerial.h>
#include <LPM11162.h>
LPM11162 AudioModule;
void setup()
{
//Begin parameters: tx pin, reset pin, busy pin, baudrate.
AudioModule.begin(4, 3, 2, 9600);
AudioModule.volume(50);
}
void loop()
{
AudioModule.play("MyFile.wav");
delay( 2000 );
}
Download
Installazione
Decomprimere lo ZIP sotto <Arduino Folder>/libraries/.