audio.h

/*---------------------------------------------------------------------------------

        ARM7 audio control

        Copyright (C) 2005
                Michael Noland (joat)
                Jason Rogers (dovoto)
                Dave Murphy (WinterMute)

        This software is provided 'as-is', without any express or implied
        warranty.  In no event will the authors be held liable for any
        damages arising from the use of this software.

        Permission is granted to anyone to use this software for any
        purpose, including commercial applications, and to alter it and
        redistribute it freely, subject to the following restrictions:

        1.      The origin of this software must not be misrepresented; you
                must not claim that you wrote the original software. If you use
                this software in a product, an acknowledgment in the product
                documentation would be appreciated but is not required.
        2.      Altered source versions must be plainly marked as such, and
                must not be misrepresented as being the original software.
        3.      This notice may not be removed or altered from any source
                distribution.

---------------------------------------------------------------------------------*/

#ifndef AUDIO_ARM7_INCLUDE
#define AUDIO_ARM7_INCLUDE

//---------------------------------------------------------------------------------
// Sound (ARM7 only)
//---------------------------------------------------------------------------------
#ifndef ARM7
#error Audio is only available on the ARM7
#endif

#ifdef __cplusplus
extern "C" {
#endif

#include <nds/arm7/serial.h>
#include <nds/system.h>

#define SOUND_VOL(n)    (n)
#define SOUND_FREQ(n)   ((-0x1000000 / (n)))
#define SOUND_ENABLE    BIT(15)

#define SOUND_REPEAT    BIT(27)
#define SOUND_ONE_SHOT  BIT(28)

#define SOUND_FORMAT_16BIT (1<<29)
#define SOUND_FORMAT_8BIT       (0<<29)
#define SOUND_FORMAT_PSG    (3<<29)
#define SOUND_FORMAT_ADPCM  (2<<29)

#define SOUND_PAN(n)    ((n) << 16)

#define SCHANNEL_ENABLE BIT(31)

//---------------------------------------------------------------------------------
// registers
//---------------------------------------------------------------------------------

#define REG_MASTER_VOLUME       (*(vu8*)0x4000500)
#define REG_SOUNDCNT            (*(vu16*)0x4000500)
#define REG_SOUNDBIAS           (*(vu32*)0x4000504)


#define SCHANNEL_CR(n)                          (*(vu32*)(0x04000400 + ((n)<<4)))
#define SCHANNEL_VOL(n)                         (*(vu8*)(0x04000400 + ((n)<<4)))
#define SCHANNEL_PAN(n)                         (*(vu8*)(0x04000402 + ((n)<<4)))
#define SCHANNEL_SOURCE(n)                      (*(vu32*)(0x04000404 + ((n)<<4)))
#define SCHANNEL_TIMER(n)                       (*(vu16*)(0x04000408 + ((n)<<4)))
#define SCHANNEL_REPEAT_POINT(n)        (*(vu16*)(0x0400040A + ((n)<<4)))
#define SCHANNEL_LENGTH(n)                      (*(vu32*)(0x0400040C + ((n)<<4)))


//---------------------------------------------------------------------------------
// Sound Capture Registers
//---------------------------------------------------------------------------------
#define REG_SNDCAP0CNT  (*(vu8*)0x04000508)
#define REG_SNDCAP1CNT  (*(vu8*)0x04000509)

#define REG_SNDCAP0DAD  (*(vu32*)0x04000510)
#define REG_SNDCAP0LEN  (*(vu16*)0x04000514)
#define REG_SNDCAP1DAD  (*(vu32*)0x04000518)
#define REG_SNDCAP1LEN  (*(vu16*)0x0400051C)

typedef void (*MIC_BUF_SWAP_CB)(u8* completedBuffer, int length);




/*---------------------------------------------------------------------------------
        microphone code based on neimod's microphone example.
        See: http://neimod.com/dstek/ 
        Chris Double (chris.double@double.co.nz)
        http://www.double.co.nz/nintendo_ds
---------------------------------------------------------------------------------*/


/*---------------------------------------------------------------------------------
        Read a byte from the microphone
---------------------------------------------------------------------------------*/
u8 micReadData8();
u16 micReadData12();

/*---------------------------------------------------------------------------------
        Fill the buffer with data from the microphone. The buffer will be
        signed sound data at 16kHz. Once the length of the buffer is
        reached, no more data will be stored. Uses ARM7 timer 0.  
---------------------------------------------------------------------------------*/
void micStartRecording(u8* buffer, int length, int freq, int timer, bool eightBitSample, MIC_BUF_SWAP_CB bufferSwapCallback);

/*---------------------------------------------------------------------------------
        Stop recording data, and return the length of data recorded.
---------------------------------------------------------------------------------*/
int micStopRecording(void);

/* This must be called during IRQ_TIMER0 */
void micTimerHandler(void);

void micSetAmp(u8 control, u8 gain);

//---------------------------------------------------------------------------------
// Turn the microphone on 
//---------------------------------------------------------------------------------
static inline void micOn(void) {
//---------------------------------------------------------------------------------
  micSetAmp(PM_AMP_ON, PM_GAIN_160);
}


//---------------------------------------------------------------------------------
// Turn the microphone off 
//---------------------------------------------------------------------------------
static inline void micOff(void) {
//---------------------------------------------------------------------------------
  micSetAmp(PM_AMP_OFF, 0);
}

void installSoundFIFO(void);

#ifdef __cplusplus
}
#endif

#endif

---