First GAUDOUT work. Still incomplete but compiling.

Also moved drivers/gaudin to drivers/audio as most audio codecs support input and output in a single device.

11 files changed, 686 insertions, 0 deletions

diff --git a/drivers/audio/Win32/driver.mk b/drivers/audio/Win32/driver.mk
new file mode 100644
index 00000000..6f4ef084
--- /dev/null
+++ b/drivers/audio/Win32/driver.mk
@@ -0,0 +1,6 @@
+# List the required driver.
+GFXSRC += $(GFXLIB)/drivers/audio/Win32/gaudin_lld.c	\
+			$(GFXLIB)/drivers/audio/Win32/gaudout_lld.c
+
+# Required include directories
+GFXINC += $(GFXLIB)/drivers/audio/Win32
diff --git a/drivers/audio/Win32/gaudin_lld.c b/drivers/audio/Win32/gaudin_lld.c
new file mode 100644
index 00000000..2c8431cf
--- /dev/null
+++ b/drivers/audio/Win32/gaudin_lld.c
@@ -0,0 +1,170 @@
+/*
+ * This file is subject to the terms of the GFX License. If a copy of
+ * the license was not distributed with this file, you can obtain one at:
+ *
+ *              http://ugfx.org/license.html
+ */
+
+/**
+ * @file    drivers/audio/Win32/gaudin_lld.c
+ * @brief   GAUDIN - Driver file for Win32.
+ */
+
+#include "gfx.h"
+
+#if GFX_USE_GAUDIN
+
+/* Include the driver defines */
+#include "src/gaudin/driver.h"
+
+#undef Red
+#undef Green
+#undef Blue
+#define WIN32_LEAN_AND_MEAN
+#include <windows.h>
+#include <stdio.h>
+#include <mmsystem.h>
+
+static HWAVEIN		ah;
+static volatile int	nQueuedBuffers;
+static bool_t		isClosing;
+static WAVEHDR		*pWaveHdrs;
+static HANDLE		waveThread;
+static DWORD		threadID;
+
+/*
+static void PrintWaveErrorMsg(DWORD err, TCHAR * str)
+{
+	#define BUFFERSIZE 128
+	char	buffer[BUFFERSIZE];
+
+	fprintf(stderr, "GAUDIN: ERROR 0x%08X: %s\r\n", err, str);
+	if (mciGetErrorString(err, &buffer[0], sizeof(buffer)))
+		fprintf(stderr, "%s\r\n", &buffer[0]);
+	else
+		fprintf(stderr, "0x%08X returned!\r\n", err);
+}
+*/
+
+/**************************** waveProc() *******************************
+ * We don't use CALLBACK_FUNCTION because it is restricted to calling only
+ * a few particular Windows functions, namely some of the time functions,
+ * and a few of the Low Level MIDI API. If you violate this rule, your app can
+ * hang inside of the callback). One of the Windows API that a callback can't
+ * call is waveInAddBuffer() which is what we need to use whenever we receive a
+ * MM_WIM_DATA. My callback would need to defer that job to another thread
+ * anyway, so instead just use CALLBACK_THREAD here instead.
+ *************************************************************************/
+
+static DWORD WINAPI waveProc(LPVOID arg) {
+	MSG		msg;
+	(void)	arg;
+
+	while (GetMessage(&msg, 0, 0, 0)) {
+		switch (msg.message) {
+			case MM_WIM_DATA:
+				GAUDIN_ISR_CompleteI((audin_sample_t *)((WAVEHDR *)msg.lParam)->lpData, ((WAVEHDR *)msg.lParam)->dwBytesRecorded/sizeof(audin_sample_t));
+
+				/* Are we closing? */
+				if (isClosing) {
+					/* Yes. We aren't recording, so another WAVEHDR has been returned to us after recording has stopped.
+					 * When we get all of them back, things can be cleaned up
+					 */
+					nQueuedBuffers--;
+					waveInUnprepareHeader(ah, (WAVEHDR *)msg.lParam, sizeof(WAVEHDR));
+				} else {
+					/* No. Now we need to requeue this buffer so the driver can use it for another block of audio
+					 * data. NOTE: We shouldn't need to waveInPrepareHeader() a WAVEHDR that has already been prepared once.
+					 * Note: We are assuming here that both the application can still access the buffer while
+					 * it is on the queue.
+					 */
+					waveInAddBuffer(ah, (WAVEHDR *)msg.lParam, sizeof(WAVEHDR));
+				}
+
+                break;
+		}
+	}
+	return 0;
+}
+
+/*===========================================================================*/
+/* External declarations.                                                    */
+/*===========================================================================*/
+
+void gaudin_lld_deinit(void) {
+	if (ah) {
+		isClosing = TRUE;
+		waveInReset(ah);
+		while(nQueuedBuffers) Sleep(1);
+		waveInClose(ah);
+		ah = 0;
+		if (pWaveHdrs) gfxFree(pWaveHdrs);
+		pWaveHdrs = 0;
+		isClosing = FALSE;
+	}
+}
+
+void gaudin_lld_init(const gaudin_params *paud) {
+	WAVEFORMATEX	wfx;
+	size_t			spaceleft;
+	audin_sample_t	*p;
+	WAVEHDR			*phdr;
+	size_t			nBuffers;
+	size_t			sz;
+
+	if (!waveThread) {
+		if (!(waveThread = CreateThread(0, 0, (LPTHREAD_START_ROUTINE)waveProc, 0, 0, &threadID))) {
+			fprintf(stderr, "GAUDIN/GAUDOUT: Can't create WAVE recording thread\n");
+			return;
+		}
+		CloseHandle(waveThread);
+	}
+
+	gaudin_lld_deinit();
+
+	wfx.wFormatTag = WAVE_FORMAT_PCM;
+	wfx.nChannels = paud->channel == GAUDIN_STEREO ? 2 : 1;
+	wfx.nSamplesPerSec = paud->frequency;
+	wfx.nBlockAlign = wfx.nChannels * sizeof(audin_sample_t);
+	wfx.nAvgBytesPerSec = wfx.nSamplesPerSec * wfx.nBlockAlign;
+	wfx.wBitsPerSample = sizeof(audin_sample_t) * 8;
+	wfx.cbSize = 0;
+
+	if (waveInOpen(&ah, WAVE_MAPPER, &wfx, (DWORD_PTR)threadID, (DWORD_PTR)paud, CALLBACK_THREAD)) {
+		fprintf(stderr, "GAUDIN: Can't open WAVE recording device\n");
+		return;
+	}
+
+	/* We need to allocate a wave header for each buffer */
+	nBuffers = (paud->bufcount + paud->samplesPerEvent - 1) / paud->samplesPerEvent;
+	if (!(pWaveHdrs = gfxAlloc(nBuffers * sizeof(WAVEHDR)))) {
+		fprintf(stderr, "GAUDIN: Buffer header allocation failed\n");
+		return;
+	}
+
+	/* Prepare each buffer and send to the wavein device */
+	spaceleft = paud->bufcount;
+	for(p = paud->buffer, phdr = pWaveHdrs, spaceleft = paud->bufcount; spaceleft; p += sz, phdr++, spaceleft -= sz) {
+		sz = spaceleft > paud->samplesPerEvent ? paud->samplesPerEvent : spaceleft;
+		phdr->dwBufferLength = sz * sizeof(audin_sample_t);
+		phdr->lpData = (LPSTR)p;
+		phdr->dwFlags = 0;
+		if (!waveInPrepareHeader(ah, phdr, sizeof(WAVEHDR))
+				&& !waveInAddBuffer(ah, phdr, sizeof(WAVEHDR)))
+			nQueuedBuffers++;
+		else
+			fprintf(stderr, "GAUDIN: Buffer prepare failed\n");
+	}
+	if (!nQueuedBuffers)
+		fprintf(stderr, "GAUDIN: Failed to prepare any buffers\n");
+}
+
+void gaudin_lld_start(void) {
+	waveInStart(ah);
+}
+
+void gaudin_lld_stop(void) {
+	waveInStop(ah);
+}
+
+#endif /* GFX_USE_GAUDIN */
diff --git a/drivers/audio/Win32/gaudin_lld_config.h b/drivers/audio/Win32/gaudin_lld_config.h
new file mode 100644
index 00000000..78ddffaa
--- /dev/null
+++ b/drivers/audio/Win32/gaudin_lld_config.h
@@ -0,0 +1,64 @@
+/*
+ * This file is subject to the terms of the GFX License. If a copy of
+ * the license was not distributed with this file, you can obtain one at:
+ *
+ *              http://ugfx.org/license.html
+ */
+
+/**
+ * @file    drivers/audio/Win32/gaudin_lld_config.h
+ * @brief   GAUDIN Driver config file.
+ *
+ * @addtogroup GAUDIN
+ * @{
+ */
+
+#ifndef GAUDIN_LLD_CONFIG_H
+#define GAUDIN_LLD_CONFIG_H
+
+#if GFX_USE_GAUDIN
+
+/*===========================================================================*/
+/* Driver hardware support.                                                  */
+/*===========================================================================*/
+
+/**
+ * @brief	The audio input sample type
+ */
+//typedef uint8_t		audin_sample_t;
+typedef int16_t		audin_sample_t;
+
+/**
+ * @brief	The maximum sample frequency supported by this audio device
+ */
+#define GAUDIN_MAX_SAMPLE_FREQUENCY			44100
+
+/**
+ * @brief	The number of bits in a sample
+ */
+//#define GAUDIN_BITS_PER_SAMPLE				8
+#define GAUDIN_BITS_PER_SAMPLE				16
+
+/**
+ * @brief	The format of an audio sample
+ */
+//#define GAUDIN_SAMPLE_FORMAT				ARRAY_DATA_8BITUNSIGNED
+#define GAUDIN_SAMPLE_FORMAT				ARRAY_DATA_16BITSIGNED
+
+/**
+ * @brief	The number of audio channels supported by this driver
+ */
+#define GAUDIN_NUM_CHANNELS					2
+
+/**
+ * @brief	The list of audio channels and their uses
+ * @{
+ */
+#define	GAUDIN_MONO							0
+#define	GAUDIN_STEREO						1
+/** @} */
+
+#endif	/* GFX_USE_GAUDIN */
+
+#endif	/* GAUDIN_LLD_CONFIG_H */
+/** @} */
diff --git a/drivers/audio/Win32/gaudout_lld.c b/drivers/audio/Win32/gaudout_lld.c
new file mode 100644
index 00000000..9581fa45
--- /dev/null
+++ b/drivers/audio/Win32/gaudout_lld.c
@@ -0,0 +1,190 @@
+/*
+ * This file is subject to the terms of the GFX License. If a copy of
+ * the license was not distributed with this file, you can obtain one at:
+ *
+ *              http://ugfx.org/license.html
+ */
+
+/**
+ * @file    drivers/audio/Win32/gaudout_lld.c
+ * @brief   GAUDOUT - Driver file for Win32.
+ */
+
+#include "gfx.h"
+
+#if GFX_USE_GAUDOUT
+
+/* Include the driver defines */
+#include "src/gaudout/driver.h"
+
+#undef Red
+#undef Green
+#undef Blue
+#define WIN32_LEAN_AND_MEAN
+#include <windows.h>
+#include <stdio.h>
+#include <mmsystem.h>
+
+#define MAX_WAVE_HEADERS		2				// Larger numbers enable more buffering which is good for ensuring
+												// there are no skips due to data not being available, however larger
+												// numbers of buffers also create higher latency.
+
+static HWAVEOUT		ah = 0;
+static volatile int	nQueuedBuffers;
+static bool_t		isRunning;
+static WAVEHDR		WaveHdrs[MAX_WAVE_HEADERS];
+static HANDLE		waveThread;
+static DWORD		threadID;
+
+/*
+static void PrintWaveErrorMsg(DWORD err, TCHAR * str)
+{
+	#define BUFFERSIZE 128
+	char	buffer[BUFFERSIZE];
+
+	fprintf(stderr, "GAUDOUT: ERROR 0x%08X: %s\r\n", err, str);
+	if (mciGetErrorString(err, &buffer[0], sizeof(buffer)))
+		fprintf(stderr, "%s\r\n", &buffer[0]);
+	else
+		fprintf(stderr, "0x%08X returned!\r\n", err);
+}
+*/
+
+/**************************** waveProc() *******************************
+ * We don't use CALLBACK_FUNCTION because it is restricted to calling only
+ * a few particular Windows functions, namely some of the time functions,
+ * and a few of the Low Level MIDI API. If you violate this rule, your app can
+ * hang inside of the callback). One of the Windows API that a callback can't
+ * call is waveOutUnPrepareBuffer() which is what we need to use whenever we receive a
+ * MM_WOM_DONE. My callback would need to defer that job to another thread
+ * anyway, so instead just use CALLBACK_THREAD here instead.
+ *************************************************************************/
+
+static bool_t senddata(WAVEHDR *pwh) {
+	GAudioData *paud;
+
+	// Get the next data block to send
+	if (!(paud = gaudoutGetDataBlockI()))
+		return FALSE;
+
+	// Prepare the wave header for Windows
+	pwh->dwUser = (DWORD_PTR)paud;
+	pwh->lpData = (LPSTR)(paud+1);			// The data is on the end of the structure
+	pwh->dwBufferLength = paud->len;
+	pwh->dwFlags = 0;
+	pwh->dwLoops = 0;
+	if (waveOutPrepareHeader(ah, pwh, sizeof(WAVEHDR))) {
+		pwh->lpData = 0;
+		fprintf(stderr, "GAUDOUT: Failed to prepare a buffer");
+		return FALSE;
+	}
+
+	// Send it to windows
+	if (waveOutWrite(ah, pwh, sizeof(WAVEHDR))) {
+		pwh->lpData = 0;
+		fprintf(stderr, "GAUDOUT: Failed to write the buffer");
+		return FALSE;
+	}
+
+	nQueuedBuffers++;
+	return TRUE;
+}
+
+static DWORD WINAPI waveProc(LPVOID arg) {
+	MSG			msg;
+	WAVEHDR		*pwh;
+	(void)		arg;
+
+	while (GetMessage(&msg, 0, 0, 0)) {
+		switch (msg.message) {
+			case MM_WOM_DONE:
+				pwh = (WAVEHDR *)msg.lParam;
+
+				// Windows - Let go!
+				waveOutUnprepareHeader(ah, pwh, sizeof(WAVEHDR));
+
+				// Give the buffer back to the Audio Free List
+				gaudoutReleaseDataBlockI((GAudioData *)pwh->dwUser);
+				pwh->lpData = 0;
+				nQueuedBuffers--;
+
+				// Try and get a new block
+				if (isRunning)
+					senddata(pwh);
+                break;
+		}
+	}
+	return 0;
+}
+
+/*===========================================================================*/
+/* External declarations.                                                    */
+/*===========================================================================*/
+
+void gaudout_lld_deinit() {
+	if (ah) {
+		isRunning = FALSE;
+		waveOutReset(ah);
+		while(nQueuedBuffers) Sleep(1);
+		waveOutClose(ah);
+		ah = 0;
+	}
+}
+
+bool_t gaudout_lld_init(uint16_t channel, uint32_t frequency) {
+	WAVEFORMATEX	wfx;
+
+	if (!waveThread) {
+		if (!(waveThread = CreateThread(0, 0, (LPTHREAD_START_ROUTINE)waveProc, 0, 0, &threadID))) {
+			fprintf(stderr, "GAUDOUT: Can't create WAVE play-back thread\n");
+			return FALSE;
+		}
+		CloseHandle(waveThread);
+	}
+
+	wfx.wFormatTag = WAVE_FORMAT_PCM;
+	wfx.nChannels = channel == GAUDOUT_STEREO ? 2 : 1;
+	wfx.nSamplesPerSec = frequency;
+	wfx.nBlockAlign = wfx.nChannels * sizeof(audout_sample_t);
+	wfx.nAvgBytesPerSec = wfx.nSamplesPerSec * wfx.nBlockAlign;
+	wfx.wBitsPerSample = sizeof(audout_sample_t) * 8;
+	wfx.cbSize = 0;
+
+	if (waveOutOpen(&ah, WAVE_MAPPER, &wfx, (DWORD_PTR)threadID, 0, CALLBACK_THREAD)) {
+		fprintf(stderr, "GAUDOUT: Can't open WAVE play-back device\n");
+		return FALSE;
+	}
+
+	return TRUE;
+}
+
+bool_t gaudout_lld_set_volume(uint8_t vol) {
+	if (!ah)
+		return FALSE;
+	return waveOutSetVolume(ah, (((uint16_t)vol)<<8)|vol) != 0;
+}
+
+void gaudout_lld_start(void) {
+	WAVEHDR		*pwh;
+
+	if (!ah)
+		return;
+
+	isRunning = TRUE;
+	while (nQueuedBuffers < MAX_WAVE_HEADERS) {
+		// Find the empty one - there will always be at least one.
+		for(pwh = WaveHdrs; pwh->lpData; pwh++);
+
+		// Grab the next audio block from the Audio Out Queue
+		if (!senddata(pwh))
+			break;
+	}
+}
+
+void gaudout_lld_stop(void) {
+	isRunning = FALSE;
+	if (ah)
+		waveOutReset(ah);
+}
+
+#endif /* GFX_USE_GAUDOUT */
diff --git a/drivers/audio/Win32/gaudout_lld_config.h b/drivers/audio/Win32/gaudout_lld_config.h
new file mode 100644
index 00000000..157f33f0
--- /dev/null
+++ b/drivers/audio/Win32/gaudout_lld_config.h
@@ -0,0 +1,64 @@
+/*
+ * This file is subject to the terms of the GFX License. If a copy of
+ * the license was not distributed with this file, you can obtain one at:
+ *
+ *              http://ugfx.org/license.html
+ */
+
+/**
+ * @file    drivers/audio/Win32/gaudout_lld_config.h
+ * @brief   GAUDOUT Driver config file.
+ *
+ * @addtogroup GAUDOUT
+ * @{
+ */
+
+#ifndef GAUDOUT_LLD_CONFIG_H
+#define GAUDIN_LLD_CONFIG_H
+
+#if GFX_USE_GAUDOUT
+
+/*===========================================================================*/
+/* Driver hardware support.                                                  */
+/*===========================================================================*/
+
+/**
+ * @brief	The audio input sample type
+ */
+//typedef uint8_t		audout_sample_t;
+typedef int16_t		audout_sample_t;
+
+/**
+ * @brief	The maximum sample frequency supported by this audio device
+ */
+#define GAUDOUT_MAX_SAMPLE_FREQUENCY			44100
+
+/**
+ * @brief	The number of bits in a sample
+ */
+//#define GAUDOUT_BITS_PER_SAMPLE				8
+#define GAUDOUT_BITS_PER_SAMPLE				16
+
+/**
+ * @brief	The format of an audio sample
+ */
+//#define GAUDOUT_SAMPLE_FORMAT				ARRAY_DATA_8BITUNSIGNED
+#define GAUDOUT_SAMPLE_FORMAT				ARRAY_DATA_16BITSIGNED
+
+/**
+ * @brief	The number of audio channels supported by this driver
+ */
+#define GAUDOUT_NUM_CHANNELS				2
+
+/**
+ * @brief	The list of audio channels and their uses
+ * @{
+ */
+#define	GAUDOUT_MONO						0
+#define	GAUDOUT_STEREO						1
+/** @} */
+
+#endif	/* GFX_USE_GAUDOUT */
+
+#endif	/* GAUDOUT_LLD_CONFIG_H */
+/** @} */
diff --git a/drivers/audio/Win32/readme.txt b/drivers/audio/Win32/readme.txt
new file mode 100644
index 00000000..784f0a89
--- /dev/null
+++ b/drivers/audio/Win32/readme.txt
@@ -0,0 +1,10 @@
+This driver uses the Win32 audio system to provide GAUDIN and GAUDOUT channels.
+
+For GAUDIN  - It supports 2 channels, Channel 0 being a mono channel and Channel 1 being a stereo channel.
+For GAUDOUT - It supports 2 channels, Channel 0 being a mono channel and Channel 1 being a stereo channel.
+
+For stereo, the samples are interleaved. Remember to allocate enough space for two samples per
+sample period.
+
+This is a simple driver that makes no changes to the mixer so set up the audio mixer using
+the windows control panel audio mixer before starting recording/playback.
diff --git a/drivers/audio/gadc/driver.mk b/drivers/audio/gadc/driver.mk
new file mode 100644
index 00000000..b991ede8
--- /dev/null
+++ b/drivers/audio/gadc/driver.mk
@@ -0,0 +1,5 @@
+# List the required driver.
+GFXSRC += $(GFXLIB)/drivers/gaudin/gadc/gaudin_lld.c
+
+# Required include directories
+GFXINC += $(GFXLIB)/drivers/audio/gadc
diff --git a/drivers/audio/gadc/gaudin_lld.c b/drivers/audio/gadc/gaudin_lld.c
new file mode 100644
index 00000000..002d9e9b
--- /dev/null
+++ b/drivers/audio/gadc/gaudin_lld.c
@@ -0,0 +1,62 @@
+/*
+ * This file is subject to the terms of the GFX License. If a copy of
+ * the license was not distributed with this file, you can obtain one at:
+ *
+ *              http://ugfx.org/license.html
+ */
+
+/**
+ * @file    drivers/gaudin/gadc/gaudin_lld.c
+ * @brief   GAUDIN - Driver file for using the cpu ADC (via GADC).
+ *
+ * @addtogroup GAUDIN
+ *
+ * @{
+ */
+
+/**
+ * We are now implementing the driver - pull in our channel table
+ * from the board definitions.
+ */
+#define GAUDIN_LLD_IMPLEMENTATION
+
+
+#include "gfx.h"
+
+#if GFX_USE_GAUDIN
+
+/* Double check the GADC system is turned on */
+#if !GFX_USE_GADC
+	#error "GAUDIN - The GADC driver for GAUDIN requires GFX_USE_GADC to be TRUE"
+#endif
+
+/* Include the driver defines */
+#include "src/gaudin/driver.h"
+
+/*===========================================================================*/
+/* External declarations.                                                    */
+/*===========================================================================*/
+
+void gaudin_lld_init(const gaudin_params *paud) {
+	/* Setup the high speed GADC */
+	gadcHighSpeedInit(gaudin_lld_physdevs[paud->channel], paud->frequency, paud->buffer, paud->bufcount, paud->samplesPerEvent);
+
+	/* Register ourselves for ISR callbacks */
+	gadcHighSpeedSetISRCallback(GAUDIN_ISR_CompleteI);
+
+	/**
+	 * The gadc driver handles any errors for us by restarting the transaction so there is
+	 * no need for us to setup anything for GAUDIN_ISR_ErrorI()
+	 */
+}
+
+void gaudin_lld_start(void) {
+	gadcHighSpeedStart();
+}
+
+void gaudin_lld_stop(void) {
+	gadcHighSpeedStop();
+}
+
+#endif /* GFX_USE_GAUDIN */
+/** @} */
diff --git a/drivers/audio/gadc/gaudin_lld_board_template.h b/drivers/audio/gadc/gaudin_lld_board_template.h
new file mode 100644
index 00000000..89cc0c12
--- /dev/null
+++ b/drivers/audio/gadc/gaudin_lld_board_template.h
@@ -0,0 +1,50 @@
+/*
+ * This file is subject to the terms of the GFX License. If a copy of
+ * the license was not distributed with this file, you can obtain one at:
+ *
+ *              http://ugfx.org/license.html
+ */
+
+/**
+ * @file    drivers/gaudin/gadc/gaudin_lld_board_template.h
+ * @brief   GAUDIN Driver board config board file
+ *
+ * @addtogroup GAUDIN
+ * @{
+ */
+
+#ifndef _GAUDIN_LLD_BOARD_H
+#define _GAUDIN_LLD_BOARD_H
+
+/*===========================================================================*/
+/* Audio inputs on this board                                                */
+/*===========================================================================*/
+
+/**
+ * @brief	The number of audio channels supported by this driver
+ * @note	This is an example
+ */
+#define GAUDIN_NUM_CHANNELS					1
+
+/**
+ * @brief	The list of audio channels and their uses
+ * @note	This is an example
+ * @{
+ */
+#define	GAUDIN_MICROPHONE					0
+/** @} */
+
+/**
+ * @brief	The audio channel to GADC physical device assignment
+ * @note	This is an example
+ * @{
+ */
+#ifdef GAUDIN_LLD_IMPLEMENTATION
+	static uint32_t gaudin_lld_physdevs[GAUDIN_NUM_CHANNELS] = {
+			GADC_PHYSDEV_MICROPHONE,
+			};
+#endif
+/** @} */
+
+#endif	/* _GAUDIN_LLD_BOARD_H */
+/** @} */
diff --git a/drivers/audio/gadc/gaudin_lld_config.h b/drivers/audio/gadc/gaudin_lld_config.h
new file mode 100644
index 00000000..a9fd02ae
--- /dev/null
+++ b/drivers/audio/gadc/gaudin_lld_config.h
@@ -0,0 +1,59 @@
+/*
+ * This file is subject to the terms of the GFX License. If a copy of
+ * the license was not distributed with this file, you can obtain one at:
+ *
+ *              http://ugfx.org/license.html
+ */
+
+/**
+ * @file    drivers/gaudin/gadc/gaudin_lld_config.h
+ * @brief   GAUDIN Driver config file.
+ *
+ * @addtogroup GAUDIN
+ * @{
+ */
+
+#ifndef GAUDIN_LLD_CONFIG_H
+#define GAUDIN_LLD_CONFIG_H
+
+#if GFX_USE_GAUDIN
+
+/*===========================================================================*/
+/* Driver hardware support.                                                  */
+/*===========================================================================*/
+
+/**
+ * @brief	The audio input sample type
+ * @details	For this driver it matches the cpu sample type
+ */
+typedef adcsample_t		audin_sample_t;
+
+/**
+ * @brief	The maximum sample frequency supported by this audio device
+ * @details	For this driver it matches the GADC maximum high speed sample rate
+ */
+#define GAUDIN_MAX_SAMPLE_FREQUENCY			GADC_MAX_HIGH_SPEED_SAMPLERATE
+
+/**
+ * @brief	The number of bits in a sample
+ * @details	For this driver it matches the cpu sample bits
+ */
+#define GAUDIN_BITS_PER_SAMPLE				GADC_BITS_PER_SAMPLE
+
+/**
+ * @brief	The format of an audio sample
+ * @details	For this driver it matches the cpu sample format
+ */
+#define GAUDIN_SAMPLE_FORMAT				GADC_SAMPLE_FORMAT
+
+/**
+ * For the GAUDIN driver that uses GADC - all the remaining config definitions are specific
+ * to the board.
+ */
+/* Include the user supplied board definitions */
+#include "gaudin_lld_board.h"
+
+#endif	/* GFX_USE_GAUDIN */
+
+#endif	/* GAUDIN_LLD_CONFIG_H */
+/** @} */
diff --git a/drivers/audio/gadc/readme.txt b/drivers/audio/gadc/readme.txt
new file mode 100644
index 00000000..1d3877e8
--- /dev/null
+++ b/drivers/audio/gadc/readme.txt
@@ -0,0 +1,6 @@
+This driver uses the generic GADC driver to provide a GAUDIN device.
+
+It supports whatever high speed device channels that your GADC driver and board supports.
+
+For stereo, the samples are interleaved. Remember to allocate enough space for two samples per
+sample period.