1834 lines
52 KiB
C
1834 lines
52 KiB
C
/****************************************************************************
|
|
* drivers/audio/wm8904.c
|
|
*
|
|
* Audio device driver for Wolfson Microelectronics WM8904 Audio codec.
|
|
*
|
|
* Copyright (C) 2014 Gregory Nutt. All rights reserved.
|
|
* Author: Gregory Nutt <gnutt@nuttx.org>
|
|
*
|
|
* References:
|
|
* - "WM8904 Ultra Low Power CODEC for Portable Audio Applications, Pre-
|
|
* Production", September 2012, Rev 3.3, Wolfson Microelectronics
|
|
*
|
|
* - The framework for this driver is based on Ken Pettit's VS1053 driver.
|
|
*
|
|
* Redistribution and use in source and binary forms, with or without
|
|
* modification, are permitted provided that the following conditions
|
|
* are met:
|
|
*
|
|
* 1. Redistributions of source code must retain the above copyright
|
|
* notice, this list of conditions and the following disclaimer.
|
|
* 2. Redistributions in binary form must reproduce the above copyright
|
|
* notice, this list of conditions and the following disclaimer in
|
|
* the documentation and/or other materials provided with the
|
|
* distribution.
|
|
* 3. Neither the name NuttX nor the names of its contributors may be
|
|
* used to endorse or promote products derived from this software
|
|
* without specific prior written permission.
|
|
*
|
|
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
|
|
* "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
|
|
* LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
|
|
* FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
|
|
* COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
|
|
* INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
|
|
* BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
|
|
* OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
|
|
* AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
|
* LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
|
|
* ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
|
|
* POSSIBILITY OF SUCH DAMAGE.
|
|
*
|
|
****************************************************************************/
|
|
|
|
/****************************************************************************
|
|
* Included Files
|
|
****************************************************************************/
|
|
|
|
#include <nuttx/config.h>
|
|
|
|
#include <sys/types.h>
|
|
#include <sys/ioctl.h>
|
|
|
|
#include <stdint.h>
|
|
#include <stdio.h>
|
|
#include <fcntl.h>
|
|
#include <string.h>
|
|
#include <errno.h>
|
|
#include <fixedmath.h>
|
|
#include <queue.h>
|
|
#include <debug.h>
|
|
|
|
#include <nuttx/kmalloc.h>
|
|
#include <nuttx/clock.h>
|
|
#include <nuttx/i2c.h>
|
|
#include <nuttx/fs/fs.h>
|
|
#include <nuttx/fs/ioctl.h>
|
|
#include <nuttx/audio/i2s.h>
|
|
#include <nuttx/audio/audio.h>
|
|
#include <nuttx/audio/wm8904.h>
|
|
#include <nuttx/math.h>
|
|
|
|
#include "wm8904.h"
|
|
|
|
/****************************************************************************
|
|
* Private Definitions
|
|
****************************************************************************/
|
|
|
|
#define WM8904_DUMMY 0xff
|
|
#define WM8904_DEFAULT_XTALI 12288000
|
|
#define WM8904_DATA_FREQ 20000000
|
|
#define WM8904_RST_USECS 2000
|
|
|
|
/****************************************************************************
|
|
* Private Types
|
|
****************************************************************************/
|
|
|
|
struct wm8904_dev_s
|
|
{
|
|
/* We are an audio lower half driver (We are also the upper "half" of
|
|
* the WM8904 driver with respect to the board lower half driver).
|
|
*
|
|
* Terminology: Our "lower" half audio instances will be called dev for the
|
|
* publicly visible version and "priv" for the version that only this driver
|
|
* knows. From the point of view of this driver, it is the board lower
|
|
* "half" that is referred to as "lower".
|
|
*/
|
|
|
|
struct audio_lowerhalf_s dev; /* WM8904 audio lower half (this drive) */
|
|
|
|
/* Our specific driver data goes here */
|
|
|
|
const FAR struct wm8904_lower_s *lower; /* Pointer to the board lower functions */
|
|
FAR struct i2c_dev_s *i2c; /* I2C driver to use */
|
|
FAR struct i2s_dev_s *i2s; /* I2S driver to use */
|
|
struct dq_queue_s pendq; /* Queue of pending buffers to be sent */
|
|
struct dq_queue_s doneq; /* Queue of sent buffers to be returned */
|
|
mqd_t mq; /* Message queue for receiving messages */
|
|
char mqname[16]; /* Our message queue name */
|
|
pthread_t threadid; /* ID of our thread */
|
|
sem_t pendsem; /* Protect pendq */
|
|
#ifndef CONFIG_AUDIO_EXCLUDE_VOLUME
|
|
#ifndef CONFIG_AUDIO_EXCLUDE_BALANCE
|
|
uint16_t balance; /* Current balance level (b16) */
|
|
#endif /* CONFIG_AUDIO_EXCLUDE_BALANCE */
|
|
uint8_t volume; /* Current volume level {0..63} */
|
|
#endif /* CONFIG_AUDIO_EXCLUDE_VOLUME */
|
|
volatile uint8_t inflight; /* Number of audio buffers in-flight */
|
|
bool running; /* True: Worker thread is running */
|
|
bool paused; /* True: Playing is paused */
|
|
bool mute; /* True: Output is muted */
|
|
#ifndef CONFIG_AUDIO_EXCLUDE_STOP
|
|
bool terminating; /* True: Stop requested */
|
|
#endif
|
|
bool reserved; /* True: Device is reserved */
|
|
volatile int result; /* The result of the last transfer */
|
|
};
|
|
|
|
/****************************************************************************
|
|
* Private Function Prototypes
|
|
****************************************************************************/
|
|
|
|
static uint16_t wm8904_readreg(FAR struct wm8904_dev_s *priv,
|
|
uint8_t regaddr);
|
|
static void wm8904_writereg(FAR struct wm8904_dev_s *priv,
|
|
uint8_t regaddr, uint16_t regval);
|
|
static void wm8904_takesem(sem_t *sem);
|
|
#define wm8904_givesem(s) sem_post(s)
|
|
|
|
#ifndef CONFIG_AUDIO_EXCLUDE_VOLUME
|
|
static inline uint16_t wm8904_scalevolume(uint16_t volume, b16_t scale);
|
|
static void wm8904_setvolume(FAR struct wm8904_dev_s *priv,
|
|
uint16_t volume, bool mute);
|
|
#endif
|
|
#ifndef CONFIG_AUDIO_EXCLUDE_TONE
|
|
static void wm8904_setbass(FAR struct wm8904_dev_s *priv, uint8_t bass);
|
|
static void wm8904_settreble(FAR struct wm8904_dev_s *priv, uint8_t treble);
|
|
#endif
|
|
static int wm8904_getcaps(FAR struct audio_lowerhalf_s *dev, int type,
|
|
FAR struct audio_caps_s *caps);
|
|
#ifdef CONFIG_AUDIO_MULTI_SESSION
|
|
static int wm8904_configure(FAR struct audio_lowerhalf_s *dev,
|
|
FAR void *session, FAR const struct audio_caps_s *caps);
|
|
#else
|
|
static int wm8904_configure(FAR struct audio_lowerhalf_s *dev,
|
|
FAR const struct audio_caps_s *caps);
|
|
#endif
|
|
static int wm8904_reset(FAR struct wm8904_dev_s *priv);
|
|
static int wm8904_shutdown(FAR struct audio_lowerhalf_s *dev);
|
|
static void wm8904_senddone(FAR struct i2s_dev_s *i2s,
|
|
FAR struct ap_buffer_s *apb, FAR void *arg, int result);
|
|
static void wm8904_returnbuffers(FAR struct wm8904_dev_s *priv);
|
|
static int wm8904_sendbuffer(FAR struct wm8904_dev_s *priv);
|
|
static int wm8904_interrupt(FAR const struct wm8904_lower_s *lower,
|
|
FAR void *arg);
|
|
static void *wm8904_workerthread(pthread_addr_t pvarg);
|
|
#ifdef CONFIG_AUDIO_MULTI_SESSION
|
|
static int wm8904_start(FAR struct audio_lowerhalf_s *dev,
|
|
FAR void *session);
|
|
#else
|
|
static int wm8904_start(FAR struct audio_lowerhalf_s *dev);
|
|
#endif
|
|
#ifndef CONFIG_AUDIO_EXCLUDE_STOP
|
|
#ifdef CONFIG_AUDIO_MULTI_SESSION
|
|
static int wm8904_stop(FAR struct audio_lowerhalf_s *dev,
|
|
FAR void* session);
|
|
#else
|
|
static int wm8904_stop(FAR struct audio_lowerhalf_s *dev);
|
|
#endif
|
|
#endif
|
|
#ifndef CONFIG_AUDIO_EXCLUDE_PAUSE_RESUME
|
|
#ifdef CONFIG_AUDIO_MULTI_SESSION
|
|
static int wm8904_pause(FAR struct audio_lowerhalf_s *dev,
|
|
FAR void* session);
|
|
#else
|
|
static int wm8904_pause(FAR struct audio_lowerhalf_s *dev);
|
|
#endif
|
|
#endif
|
|
#ifndef CONFIG_AUDIO_EXCLUDE_PAUSE_RESUME
|
|
#ifdef CONFIG_AUDIO_MULTI_SESSION
|
|
static int wm8904_resume(FAR struct audio_lowerhalf_s *dev,
|
|
FAR void* session);
|
|
#else
|
|
static int wm8904_resume(FAR struct audio_lowerhalf_s *dev);
|
|
#endif
|
|
#endif
|
|
static int wm8904_enqueuebuffer(FAR struct audio_lowerhalf_s *dev,
|
|
FAR struct ap_buffer_s *apb);
|
|
static int wm8904_cancelbuffer(FAR struct audio_lowerhalf_s *dev,
|
|
FAR struct ap_buffer_s *apb);
|
|
static int wm8904_ioctl(FAR struct audio_lowerhalf_s *dev, int cmd,
|
|
unsigned long arg);
|
|
#ifdef CONFIG_AUDIO_MULTI_SESSION
|
|
static int wm8904_reserve(FAR struct audio_lowerhalf_s *dev,
|
|
FAR void **session);
|
|
#else
|
|
static int wm8904_reserve(FAR struct audio_lowerhalf_s *dev);
|
|
#endif
|
|
#ifdef CONFIG_AUDIO_MULTI_SESSION
|
|
static int wm8904_release(FAR struct audio_lowerhalf_s *dev,
|
|
FAR void *session);
|
|
#else
|
|
static int wm8904_release(FAR struct audio_lowerhalf_s *dev);
|
|
#endif
|
|
|
|
/* Initialization */
|
|
|
|
static void wm8904_audio_output(FAR struct wm8904_dev_s *priv);
|
|
#if 0 /* Not used */
|
|
static void wm8904_audio_input(FAR struct wm8904_dev_s *priv);
|
|
#endif
|
|
|
|
/****************************************************************************
|
|
* Private Data
|
|
****************************************************************************/
|
|
|
|
static const struct audio_ops_s g_audioops =
|
|
{
|
|
wm8904_getcaps, /* getcaps */
|
|
wm8904_configure, /* configure */
|
|
wm8904_shutdown, /* shutdown */
|
|
wm8904_start, /* start */
|
|
#ifndef CONFIG_AUDIO_EXCLUDE_STOP
|
|
wm8904_stop, /* stop */
|
|
#endif
|
|
#ifndef CONFIG_AUDIO_EXCLUDE_PAUSE_RESUME
|
|
wm8904_pause, /* pause */
|
|
wm8904_resume, /* resume */
|
|
#endif
|
|
NULL, /* allocbuffer */
|
|
NULL, /* freebuffer */
|
|
wm8904_enqueuebuffer, /* enqueue_buffer */
|
|
wm8904_cancelbuffer, /* cancel_buffer */
|
|
wm8904_ioctl, /* ioctl */
|
|
NULL, /* read */
|
|
NULL, /* write */
|
|
wm8904_reserve, /* reserve */
|
|
wm8904_release /* release */
|
|
};
|
|
|
|
/****************************************************************************
|
|
* Private Functions
|
|
****************************************************************************/
|
|
|
|
/****************************************************************************
|
|
* Name: wm8904_readreg
|
|
*
|
|
* Description
|
|
* Read the specified 16-bit register from the WM8904 device.
|
|
*
|
|
****************************************************************************/
|
|
|
|
static uint16_t wm8904_readreg(FAR struct wm8904_dev_s *priv, uint8_t regaddr)
|
|
{
|
|
int retries;
|
|
|
|
/* Try up to three times to read the register */
|
|
|
|
for (retries = 1; retries <= 3; retries++)
|
|
{
|
|
struct i2c_msg_s msg[2];
|
|
uint8_t data[2];
|
|
int ret;
|
|
|
|
/* Set up to write the address */
|
|
|
|
msg[0].addr = priv->lower->address;
|
|
msg[0].flags = 0;
|
|
msg[0].buffer = ®addr;
|
|
msg[0].length = 1;
|
|
|
|
/* Followed by the read data */
|
|
|
|
msg[1].addr = priv->lower->address;
|
|
msg[1].flags = I2C_M_READ;
|
|
msg[1].buffer = data;
|
|
msg[1].length = 2;
|
|
|
|
/* Read the register data. The returned value is the number messages
|
|
* completed.
|
|
*/
|
|
|
|
ret = I2C_TRANSFER(priv->i2c, msg, 2);
|
|
if (ret < 0)
|
|
{
|
|
#ifdef CONFIG_I2C_RESET
|
|
/* Perhaps the I2C bus is locked up? Try to shake the bus free */
|
|
|
|
auddbg("WARNING: I2C_TRANSFER failed: %d ... Resetting\n", ret);
|
|
|
|
ret = up_i2creset(priv->i2c);
|
|
if (ret < 0)
|
|
{
|
|
auddbg("ERROR: up_i2creset failed: %d\n", ret);
|
|
break;
|
|
}
|
|
#else
|
|
auddbg("ERROR: I2C_TRANSFER failed: %d\n", ret);
|
|
#endif
|
|
}
|
|
else
|
|
{
|
|
uint16_t regval;
|
|
|
|
/* The I2C transfer was successful... break out of the loop and
|
|
* return the value read.
|
|
*/
|
|
|
|
regval = ((uint16_t)data[0] << 8) | (uint16_t)data[1];
|
|
audvdbg("READ: %02x -> %04x\n", regaddr, regval);
|
|
return regval;
|
|
}
|
|
|
|
audvdbg("retries=%d regaddr=%02x\n", retries, regaddr);
|
|
}
|
|
|
|
/* No error indication is returned on a failure... just return zero */
|
|
|
|
return 0;
|
|
}
|
|
|
|
/************************************************************************************
|
|
* Name: wm8904_writereg
|
|
*
|
|
* Description:
|
|
* Write the specified 16-bit register to the WM8904 device.
|
|
*
|
|
************************************************************************************/
|
|
|
|
static void wm8904_writereg(FAR struct wm8904_dev_s *priv, uint8_t regaddr,
|
|
uint16_t regval)
|
|
{
|
|
int retries;
|
|
|
|
/* Try up to three times to read the register */
|
|
|
|
for (retries = 1; retries <= 3; retries++)
|
|
{
|
|
struct i2c_msg_s msg[2];
|
|
uint8_t data[2];
|
|
int ret;
|
|
|
|
/* Set up to write the address */
|
|
|
|
msg[0].addr = priv->lower->address;
|
|
msg[0].flags = 0;
|
|
msg[0].buffer = ®addr;
|
|
msg[0].length = 1;
|
|
|
|
/* Followed by the read data */
|
|
|
|
data[0] = regval >> 8;
|
|
data[1] = regval & 0xff;
|
|
|
|
msg[1].addr = priv->lower->address;
|
|
msg[1].flags = I2C_M_NORESTART;
|
|
msg[1].buffer = data;
|
|
msg[1].length = 2;
|
|
|
|
/* Read the register data. The returned value is the number messages
|
|
* completed.
|
|
*/
|
|
|
|
ret = I2C_TRANSFER(priv->i2c, msg, 2);
|
|
if (ret < 0)
|
|
{
|
|
#ifdef CONFIG_I2C_RESET
|
|
/* Perhaps the I2C bus is locked up? Try to shake the bus free */
|
|
|
|
auddbg("WARNING: I2C_TRANSFER failed: %d ... Resetting\n", ret);
|
|
|
|
ret = up_i2creset(priv->i2c);
|
|
if (ret < 0)
|
|
{
|
|
auddbg("ERROR: up_i2creset failed: %d\n", ret);
|
|
break;
|
|
}
|
|
#else
|
|
auddbg("ERROR: I2C_TRANSFER failed: %d\n", ret);
|
|
#endif
|
|
}
|
|
else
|
|
{
|
|
/* The I2C transfer was successful... break out of the loop and
|
|
* return the value read.
|
|
*/
|
|
|
|
audvdbg("Write: %02x <- %04x\n", regaddr, regval);
|
|
return;
|
|
}
|
|
|
|
audvdbg("retries=%d regaddr=%02x\n", retries, regaddr);
|
|
}
|
|
}
|
|
|
|
/************************************************************************************
|
|
* Name: wm8904_takesem
|
|
*
|
|
* Description:
|
|
* Take a semaphore count, handling the nasty EINTR return if we are interrupted
|
|
* by a signal.
|
|
*
|
|
************************************************************************************/
|
|
|
|
static void wm8904_takesem(sem_t *sem)
|
|
{
|
|
int ret;
|
|
|
|
do
|
|
{
|
|
ret = sem_wait(sem);
|
|
DEBUGASSERT(ret == 0 || errno == EINTR);
|
|
}
|
|
while (ret < 0);
|
|
}
|
|
|
|
/************************************************************************************
|
|
* Name: wm8904_scalevolume
|
|
*
|
|
* Description:
|
|
* Set the right and left volume values in the WM8904 device based on the current
|
|
* volume and balance settings.
|
|
*
|
|
************************************************************************************/
|
|
|
|
#ifndef CONFIG_AUDIO_EXCLUDE_VOLUME
|
|
static inline uint16_t wm8904_scalevolume(uint16_t volume, b16_t scale)
|
|
{
|
|
return b16toi((b16_t)volume * scale);
|
|
}
|
|
#endif
|
|
|
|
/************************************************************************************
|
|
* Name: wm8904_setvolume
|
|
*
|
|
* Description:
|
|
* Set the right and left volume values in the WM8904 device based on the current
|
|
* volume and balance settings.
|
|
*
|
|
************************************************************************************/
|
|
|
|
#ifndef CONFIG_AUDIO_EXCLUDE_VOLUME
|
|
static void wm8904_setvolume(FAR struct wm8904_dev_s *priv, uint16_t volume,
|
|
bool mute)
|
|
{
|
|
uint32_t leftlevel;
|
|
uint32_t rightlevel;
|
|
uint16_t regval;
|
|
|
|
#ifndef CONFIG_AUDIO_EXCLUDE_BALANCE
|
|
/* Calculate the left channel volume level {0..1000} */
|
|
|
|
if (priv->balance <= 500)
|
|
{
|
|
leftlevel = volume;
|
|
}
|
|
else if (priv->balance == 1000)
|
|
{
|
|
leftlevel = 0;
|
|
}
|
|
else
|
|
{
|
|
leftlevel = wm8904_scalevolume(volume, b16ONE - (b16_t)priv->balance);
|
|
}
|
|
|
|
/* Calculate the right channel volume level {0..1000} */
|
|
|
|
if (priv->balance >= 500)
|
|
{
|
|
rightlevel = volume;
|
|
}
|
|
else if (priv->balance == 0)
|
|
{
|
|
rightlevel = 0;
|
|
}
|
|
else
|
|
{
|
|
rightlevel = wm8904_scalevolume(volume, (b16_t)priv->balance);
|
|
}
|
|
#else
|
|
leftlevel = priv->volume;
|
|
rightlevel = priv->volume;
|
|
#endif
|
|
|
|
/* Set the volume */
|
|
|
|
regval = WM8904_HPOUTZC | WM8904_HPOUT_VOL(leftlevel);
|
|
if (mute)
|
|
{
|
|
regval |= WM8904_HPOUT_MUTE;
|
|
}
|
|
|
|
wm8904_writereg(priv, WM8904_ANA_LEFT_OUT1, regval);
|
|
|
|
regval = WM8904_HPOUTZC | WM8904_HPOUT_VOL(rightlevel);
|
|
if (mute)
|
|
{
|
|
regval |= WM8904_HPOUT_MUTE;
|
|
}
|
|
|
|
wm8904_writereg(priv, WM8904_ANA_RIGHT_OUT1, regval);
|
|
|
|
/* Remember the volume level and mute settings */
|
|
|
|
priv->volume = volume;
|
|
priv->mute = mute;
|
|
}
|
|
#endif /* CONFIG_AUDIO_EXCLUDE_VOLUME */
|
|
|
|
/************************************************************************************
|
|
* Name: wm8904_setbass
|
|
*
|
|
* Description:
|
|
* Set the bass level.
|
|
*
|
|
* The level and range are in whole percentage levels (0-100).
|
|
*
|
|
************************************************************************************/
|
|
|
|
#ifndef CONFIG_AUDIO_EXCLUDE_TONE
|
|
static void wm8904_setbass(FAR struct wm8904_dev_s *priv, uint8_t bass)
|
|
{
|
|
#warning Missing logic
|
|
}
|
|
#endif /* CONFIG_AUDIO_EXCLUDE_TONE */
|
|
|
|
/************************************************************************************
|
|
* Name: wm8904_settreble
|
|
*
|
|
* Description:
|
|
* Set the treble level .
|
|
*
|
|
* The level and range are in whole percentage levels (0-100).
|
|
*
|
|
************************************************************************************/
|
|
|
|
#ifndef CONFIG_AUDIO_EXCLUDE_TONE
|
|
static void wm8904_settreble(FAR struct wm8904_dev_s *priv, uint8_t treble)
|
|
{
|
|
#warning Missing logic
|
|
}
|
|
#endif /* CONFIG_AUDIO_EXCLUDE_TONE */
|
|
|
|
/****************************************************************************
|
|
* Name: wm8904_getcaps
|
|
*
|
|
* Description: Get the audio device capabilities
|
|
*
|
|
****************************************************************************/
|
|
|
|
static int wm8904_getcaps(FAR struct audio_lowerhalf_s *dev, int type,
|
|
FAR struct audio_caps_s *caps)
|
|
{
|
|
audvdbg("Entry\n");
|
|
|
|
/* Validate the structure */
|
|
|
|
DEBUGASSERT(caps->ac_len >= sizeof(struct audio_caps_s));
|
|
|
|
/* Fill in the caller's structure based on requested info */
|
|
|
|
caps->ac_format[0] = 0;
|
|
caps->ac_format[1] = 0;
|
|
caps->ac_controls[0] = 0;
|
|
caps->ac_controls[1] = 0;
|
|
caps->ac_controls[2] = 0;
|
|
caps->ac_controls[3] = 0;
|
|
|
|
switch (caps->ac_type)
|
|
{
|
|
/* Caller is querying for the types of units we support */
|
|
|
|
case AUDIO_TYPE_QUERY:
|
|
|
|
/* Provide our overall capabilities. The interfacing software
|
|
* must then call us back for specific info for each capability.
|
|
*/
|
|
|
|
caps->ac_channels = 2; /* Stereo output */
|
|
|
|
switch (caps->ac_subtype)
|
|
{
|
|
case AUDIO_TYPE_QUERY:
|
|
/* We don't decode any formats! Only something above us in
|
|
* the audio stream can perform decoding on our behalf.
|
|
*/
|
|
|
|
/* The types of audio units we implement */
|
|
|
|
caps->ac_controls[0] = AUDIO_TYPE_OUTPUT | AUDIO_TYPE_FEATURE |
|
|
AUDIO_TYPE_PROCESSING;
|
|
|
|
break;
|
|
|
|
case AUDIO_FMT_MIDI:
|
|
/* We only support Format 0 */
|
|
|
|
caps->ac_controls[0] = AUDIO_SUBFMT_END;
|
|
break;
|
|
|
|
default:
|
|
caps->ac_controls[0] = AUDIO_SUBFMT_END;
|
|
break;
|
|
}
|
|
|
|
break;
|
|
|
|
/* Provide capabilities of our OUTPUT unit */
|
|
|
|
case AUDIO_TYPE_OUTPUT:
|
|
|
|
caps->ac_channels = 2;
|
|
|
|
switch (caps->ac_subtype)
|
|
{
|
|
case AUDIO_TYPE_QUERY:
|
|
|
|
/* Report the Sample rates we support */
|
|
|
|
caps->ac_controls[0] = AUDIO_SAMP_RATE_8K | AUDIO_SAMP_RATE_11K |
|
|
AUDIO_SAMP_RATE_16K | AUDIO_SAMP_RATE_22K |
|
|
AUDIO_SAMP_RATE_32K | AUDIO_SAMP_RATE_44K |
|
|
AUDIO_SAMP_RATE_48K;
|
|
break;
|
|
|
|
case AUDIO_FMT_MP3:
|
|
case AUDIO_FMT_WMA:
|
|
case AUDIO_FMT_PCM:
|
|
break;
|
|
|
|
default:
|
|
break;
|
|
}
|
|
|
|
break;
|
|
|
|
/* Provide capabilities of our FEATURE units */
|
|
|
|
case AUDIO_TYPE_FEATURE:
|
|
|
|
/* If the sub-type is UNDEF, then report the Feature Units we support */
|
|
|
|
if (caps->ac_subtype == AUDIO_FU_UNDEF)
|
|
{
|
|
/* Fill in the ac_controls section with the Feature Units we have */
|
|
|
|
caps->ac_controls[0] = AUDIO_FU_VOLUME | AUDIO_FU_BASS | AUDIO_FU_TREBLE;
|
|
caps->ac_controls[1] = AUDIO_FU_BALANCE >> 8;
|
|
}
|
|
else
|
|
{
|
|
/* TODO: Do we need to provide specific info for the Feature Units,
|
|
* such as volume setting ranges, etc.?
|
|
*/
|
|
}
|
|
|
|
break;
|
|
|
|
/* Provide capabilities of our PROCESSING unit */
|
|
|
|
case AUDIO_TYPE_PROCESSING:
|
|
|
|
switch (caps->ac_subtype)
|
|
{
|
|
case AUDIO_PU_UNDEF:
|
|
|
|
/* Provide the type of Processing Units we support */
|
|
|
|
caps->ac_controls[0] = AUDIO_PU_STEREO_EXTENDER;
|
|
break;
|
|
|
|
case AUDIO_PU_STEREO_EXTENDER:
|
|
|
|
/* Provide capabilities of our Stereo Extender */
|
|
|
|
caps->ac_controls[0] = AUDIO_STEXT_ENABLE | AUDIO_STEXT_WIDTH;
|
|
break;
|
|
|
|
default:
|
|
|
|
/* Other types of processing uint we don't support */
|
|
|
|
break;
|
|
}
|
|
|
|
break;
|
|
|
|
/* All others we don't support */
|
|
|
|
default:
|
|
|
|
/* Zero out the fields to indicate no support */
|
|
|
|
caps->ac_subtype = 0;
|
|
caps->ac_channels = 0;
|
|
|
|
break;
|
|
}
|
|
|
|
/* Return the length of the audio_caps_s struct for validation of
|
|
* proper Audio device type.
|
|
*/
|
|
|
|
return caps->ac_len;
|
|
}
|
|
|
|
/****************************************************************************
|
|
* Name: wm8904_configure
|
|
*
|
|
* Description:
|
|
* Configure the audio device for the specified mode of operation.
|
|
*
|
|
****************************************************************************/
|
|
|
|
#ifdef CONFIG_AUDIO_MULTI_SESSION
|
|
static int wm8904_configure(FAR struct audio_lowerhalf_s *dev,
|
|
FAR void *session,
|
|
FAR const struct audio_caps_s *caps)
|
|
#else
|
|
static int wm8904_configure(FAR struct audio_lowerhalf_s *dev,
|
|
FAR const struct audio_caps_s *caps)
|
|
#endif
|
|
{
|
|
#if !defined(CONFIG_AUDIO_EXCLUDE_VOLUME) || !defined(CONFIG_AUDIO_EXCLUDE_TONE)
|
|
FAR struct wm8904_dev_s *priv = (FAR struct wm8904_dev_s *)dev;
|
|
#endif
|
|
int ret = OK;
|
|
|
|
audvdbg("Entry\n");
|
|
|
|
/* Process the configure operation */
|
|
|
|
switch (caps->ac_type)
|
|
{
|
|
case AUDIO_TYPE_FEATURE:
|
|
|
|
/* Process based on Feature Unit */
|
|
|
|
switch (*((uint16_t *)caps->ac_format))
|
|
{
|
|
#ifndef CONFIG_AUDIO_EXCLUDE_VOLUME
|
|
case AUDIO_FU_VOLUME:
|
|
{
|
|
/* Set the volume */
|
|
|
|
uint16_t volume = *(uint16_t *)caps->ac_controls;
|
|
if (volume >= 0 && volume <= 1000)
|
|
{
|
|
/* Scale the volume setting to the range {0.. 63} */
|
|
|
|
wm8904_setvolume(priv, (63 * volume / 1000), priv->mute);
|
|
}
|
|
else
|
|
{
|
|
ret = -EDOM;
|
|
}
|
|
}
|
|
break;
|
|
#endif /* CONFIG_AUDIO_EXCLUDE_VOLUME */
|
|
|
|
#ifndef CONFIG_AUDIO_EXCLUDE_TONE
|
|
case AUDIO_FU_BASS:
|
|
{
|
|
/* Set the bass. The percentage level (0-100) is in the
|
|
* ac_controls[0] parameter.
|
|
*/
|
|
|
|
uint8_t bass = caps->ac_controls[0];
|
|
if (bass <= 100)
|
|
{
|
|
wm8904_setbass(priv, bass);
|
|
}
|
|
else
|
|
{
|
|
ret = -EDOM;
|
|
}
|
|
}
|
|
break;
|
|
|
|
case AUDIO_FU_TREBLE:
|
|
{
|
|
/* Set the treble. The percentage level (0-100) is in the
|
|
* ac_controls[0] parameter.
|
|
*/
|
|
|
|
uint8_t treble = caps->ac_controls[0];
|
|
if (treble <= 100)
|
|
{
|
|
wm8904_settreble(priv, treble);
|
|
}
|
|
else
|
|
{
|
|
ret = -EDOM;
|
|
}
|
|
}
|
|
break;
|
|
#endif /* CONFIG_AUDIO_EXCLUDE_TONE */
|
|
|
|
default:
|
|
ret = -ENOTTY;
|
|
break;
|
|
}
|
|
break;
|
|
|
|
case AUDIO_TYPE_PROCESSING:
|
|
{
|
|
/* We only support STEREO_EXTENDER */
|
|
|
|
if (*((uint16_t *) caps->ac_format) == AUDIO_PU_STEREO_EXTENDER)
|
|
{
|
|
}
|
|
}
|
|
break;
|
|
}
|
|
|
|
return ret;
|
|
}
|
|
|
|
/****************************************************************************
|
|
* Name: wm8904_reset
|
|
*
|
|
* Description:
|
|
* Performs a soft reset on the WM8904 chip by writing to the SWRST
|
|
* register.
|
|
*
|
|
****************************************************************************/
|
|
|
|
static int wm8904_reset(FAR struct wm8904_dev_s *priv)
|
|
{
|
|
/* First disable interrupts */
|
|
|
|
WM8904_DISABLE(priv->lower);
|
|
|
|
/* Now issue a reset command */
|
|
|
|
wm8904_writereg(priv, WM8904_SWRST, 0);
|
|
return OK;
|
|
}
|
|
|
|
/****************************************************************************
|
|
* Name: wm8904_shutdown
|
|
*
|
|
* Description:
|
|
* Shutdown the WM8904 chip and put it in the lowest power state possible.
|
|
*
|
|
****************************************************************************/
|
|
|
|
static int wm8904_shutdown(FAR struct audio_lowerhalf_s *dev)
|
|
{
|
|
FAR struct wm8904_dev_s *priv = (FAR struct wm8904_dev_s *)dev;
|
|
|
|
wm8904_reset(priv);
|
|
return OK;
|
|
}
|
|
|
|
/****************************************************************************
|
|
* Name: wm8904_senddone
|
|
*
|
|
* Description:
|
|
* This is the I2S callback function that is invoked when the transfer
|
|
* completes.
|
|
*
|
|
****************************************************************************/
|
|
|
|
static void wm8904_senddone(FAR struct i2s_dev_s *i2s,
|
|
FAR struct ap_buffer_s *apb, FAR void *arg,
|
|
int result)
|
|
{
|
|
FAR struct wm8904_dev_s *priv = (FAR struct wm8904_dev_s *)arg;
|
|
struct audio_msg_s msg;
|
|
irqstate_t flags;
|
|
int ret;
|
|
|
|
DEBUGASSERT(i2s && priv && priv->running && apb);
|
|
|
|
/* We do not place any restriction on the context in which this function
|
|
* is called. It may be called from an interrupt handler. Therefore, the
|
|
* doneq and in-flight values might be accessed from the interrupt level.
|
|
* Not the best design. But we will use interrupt controls to protect
|
|
* against that possibility.
|
|
*/
|
|
|
|
flags = irqsave();
|
|
|
|
/* Add the completed buffer to the end of our doneq. We do not yet
|
|
* decrement the reference count.
|
|
*/
|
|
|
|
dq_addlast((FAR dq_entry_t *)apb, &priv->doneq);
|
|
|
|
/* And decrement the number of buffers in-flight */
|
|
|
|
DEBUGASSERT(priv->inflight > 0);
|
|
priv->inflight--;
|
|
|
|
/* Save the result of the transfer */
|
|
/* REVISIT: This can be overwritten */
|
|
|
|
priv->result = result;
|
|
irqrestore(flags);
|
|
|
|
/* Now send a message to the worker thread, informing it that there are
|
|
* buffers in the done queue that need to be cleaned up.
|
|
*/
|
|
|
|
msg.msgId = AUDIO_MSG_COMPLETE;
|
|
ret = mq_send(priv->mq, &msg, sizeof(msg), CONFIG_WM8904_MSG_PRIO);
|
|
if (ret < 0)
|
|
{
|
|
audlldbg("ERROR: mq_send failed: %d\n", errno);
|
|
}
|
|
}
|
|
|
|
/****************************************************************************
|
|
* Name: wm8904_returnbuffers
|
|
*
|
|
* Description:
|
|
* This function is called after the complete of one or more data
|
|
* transfers. This function will empty the done queue and release our
|
|
* reference to each buffer.
|
|
*
|
|
****************************************************************************/
|
|
|
|
static void wm8904_returnbuffers(FAR struct wm8904_dev_s *priv)
|
|
{
|
|
FAR struct ap_buffer_s *apb;
|
|
irqstate_t flags;
|
|
|
|
/* The doneq and in-flight values might be accessed from the interrupt
|
|
* level in some implementations. Not the best design. But we will
|
|
* use interrupt controls to protect against that possibility.
|
|
*/
|
|
|
|
flags = irqsave();
|
|
while (dq_peek(&priv->doneq) != NULL)
|
|
{
|
|
/* Take next buffer from the queue of completed transfers */
|
|
|
|
apb = (FAR struct ap_buffer_s *)dq_remfirst(&priv->doneq);
|
|
irqrestore(flags);
|
|
|
|
/* Release our reference to the audio buffer */
|
|
|
|
apb_free(apb);
|
|
flags = irqsave();
|
|
}
|
|
|
|
irqrestore(flags);
|
|
}
|
|
|
|
/****************************************************************************
|
|
* Name: wm8904_sendbuffer
|
|
*
|
|
* Description:
|
|
* Start the transfer an audio buffer to the WM8904 via I2S. This
|
|
* will not wait for the transfer to complete but will return immediately.
|
|
* the wmd8904_senddone called will be invoked when the transfer
|
|
* completes, stimulating the worker thread to call this function again.
|
|
*
|
|
****************************************************************************/
|
|
|
|
static int wm8904_sendbuffer(FAR struct wm8904_dev_s *priv)
|
|
{
|
|
FAR struct ap_buffer_s *apb;
|
|
irqstate_t flags;
|
|
int ret = OK;
|
|
|
|
/* Loop while there are audio buffers to be sent and we have few than
|
|
* CONFIG_WM8904_INFLIGHT then "in-flight"
|
|
*
|
|
* The 'inflight' value might be modified from the interrupt level in some
|
|
* implementations. We will use interrupt controls to protect against
|
|
* that possibility.
|
|
*
|
|
* The 'pendq', on the other hand, is protected via a semaphore. Let's
|
|
* hold the semaphore while we are busy here and disable the interrupts
|
|
* only while accessing 'inflight'.
|
|
*/
|
|
|
|
wm8904_takesem(&priv->pendsem);
|
|
while (priv->inflight < CONFIG_WM8904_INFLIGHT &&
|
|
dq_peek(&priv->pendq) != NULL && !priv->paused)
|
|
{
|
|
/* Take next buffer from the queue of pending transfers */
|
|
|
|
apb = (FAR struct ap_buffer_s *)dq_remfirst(&priv->pendq);
|
|
audvdbg("Sending apb=%p, size=%d\n", apb, apb->nbytes);
|
|
|
|
/* Increment the number of buffers in-flight before sending in order
|
|
* to avoid a possible race condition.
|
|
*/
|
|
|
|
flags = irqsave();
|
|
priv->inflight++;
|
|
irqrestore(flags);
|
|
|
|
/* Send the entire audio buffer via I2S */
|
|
|
|
ret = I2S_SEND(priv->i2s, apb, wm8904_senddone, priv, 500 / MSEC_PER_TICK);
|
|
if (ret < 0)
|
|
{
|
|
auddbg("ERROR: I2S_SEND failed: %d\n", ret);
|
|
break;
|
|
}
|
|
}
|
|
|
|
wm8904_givesem(&priv->pendsem);
|
|
return ret;
|
|
}
|
|
|
|
/****************************************************************************
|
|
* Name: wm8904_interrupt
|
|
*
|
|
* This is the ISR that services the WM8904 pin from the WM8904, which
|
|
* indicates the chip is ready to receive additional data. We use it to
|
|
* send a message to our worker thread message queue so it knows to wake
|
|
* up and send more data.
|
|
*
|
|
****************************************************************************/
|
|
|
|
static int wm8904_interrupt(FAR const struct wm8904_lower_s *lower,
|
|
FAR void *arg)
|
|
{
|
|
FAR struct wm8904_dev_s *priv = (FAR struct wm8904_dev_s *)arg;
|
|
struct audio_msg_s msg;
|
|
int ret;
|
|
|
|
DEBUGASSERT(lower && priv);
|
|
|
|
/* Create a message and send it to the worker thread */
|
|
/* REVISIT this */
|
|
|
|
if (priv->running)
|
|
{
|
|
msg.msgId = AUDIO_MSG_DATA_REQUEST;
|
|
ret = mq_send(priv->mq, &msg, sizeof(msg), CONFIG_WM8904_MSG_PRIO);
|
|
if (ret < 0)
|
|
{
|
|
audlldbg("ERROR: mq_send failed: %d\n", errno);
|
|
}
|
|
}
|
|
|
|
return OK;
|
|
}
|
|
|
|
/****************************************************************************
|
|
* Name: wm8904_workerthread
|
|
*
|
|
* This is the thread that feeds data to the chip and keeps the audio
|
|
* stream going.
|
|
*
|
|
****************************************************************************/
|
|
|
|
static void *wm8904_workerthread(pthread_addr_t pvarg)
|
|
{
|
|
FAR struct wm8904_dev_s *priv = (struct wm8904_dev_s *) pvarg;
|
|
struct audio_msg_s msg;
|
|
FAR struct ap_buffer_s *apb;
|
|
int msglen;
|
|
int prio;
|
|
|
|
audvdbg("Entry\n");
|
|
|
|
#ifndef CONFIG_AUDIO_EXCLUDE_STOP
|
|
priv->terminating = false;
|
|
#endif
|
|
|
|
/* Mark ourself as running and make sure that WM8904 interrupts are
|
|
* enabled.
|
|
*/
|
|
|
|
priv->running = true;
|
|
WM8904_ENABLE(priv->lower);
|
|
wm8904_setvolume(priv, priv->volume, false);
|
|
|
|
/* Loop as long as we are supposed to be running */
|
|
|
|
while (priv->running || priv->inflight > 0)
|
|
{
|
|
/* Check if we have been asked to terminate. We have to check if we
|
|
* still have buffers in-flight. If we do, then we can't stop until
|
|
* birds come back to roost.
|
|
*/
|
|
|
|
if (priv->terminating && priv->inflight <= 0)
|
|
{
|
|
/* We are IDLE. Break out of the loop and exit. */
|
|
|
|
break;
|
|
}
|
|
else
|
|
{
|
|
/* Check if we can send more audio buffers to the WM8904 */
|
|
|
|
wm8904_sendbuffer(priv);
|
|
}
|
|
|
|
/* Wait for messages from our message queue */
|
|
|
|
msglen = mq_receive(priv->mq, &msg, sizeof(msg), &prio);
|
|
|
|
/* Handle the case when we return with no message */
|
|
|
|
if (msglen < sizeof(struct audio_msg_s))
|
|
{
|
|
auddbg("ERROR: Message too small: %d\n", msglen);
|
|
continue;
|
|
}
|
|
|
|
/* Process the message */
|
|
|
|
switch (msg.msgId)
|
|
{
|
|
/* The ISR has requested more data. We will catch this case at
|
|
* the top of the loop.
|
|
*/
|
|
|
|
case AUDIO_MSG_DATA_REQUEST:
|
|
/* REVISIT this */
|
|
break;
|
|
|
|
/* Stop the playback */
|
|
|
|
#ifndef CONFIG_AUDIO_EXCLUDE_STOP
|
|
case AUDIO_MSG_STOP:
|
|
/* Indicate that we are terminating */
|
|
|
|
priv->terminating = true;
|
|
break;
|
|
#endif
|
|
|
|
/* We have a new buffer to send. We will catch this case at
|
|
* the top of the loop.
|
|
*/
|
|
|
|
case AUDIO_MSG_ENQUEUE:
|
|
break;
|
|
|
|
/* We will wake up from the I2S callback with this message */
|
|
|
|
case AUDIO_MSG_COMPLETE:
|
|
wm8904_returnbuffers(priv);
|
|
break;
|
|
|
|
default:
|
|
auddbg("ERROR: Ignoring message ID %d\n", msg.msgId);
|
|
break;
|
|
}
|
|
}
|
|
|
|
/* Disable the WM8904 interrupt */
|
|
|
|
WM8904_DISABLE(priv->lower);
|
|
wm8904_setvolume(priv, priv->volume, true);
|
|
|
|
/* Return any pending buffers in our pending queue */
|
|
|
|
wm8904_takesem(&priv->pendsem);
|
|
while ((apb = (FAR struct ap_buffer_s *)dq_remfirst(&priv->pendq)) != NULL)
|
|
{
|
|
/* Release our reference to the buffer */
|
|
|
|
apb_free(apb);
|
|
}
|
|
wm8904_givesem(&priv->pendsem);
|
|
|
|
/* Return any pending buffers in our done queue */
|
|
|
|
wm8904_returnbuffers(priv);
|
|
|
|
/* Close the message queue */
|
|
|
|
mq_close(priv->mq);
|
|
mq_unlink(priv->mqname);
|
|
priv->mq = NULL;
|
|
|
|
/* Send an AUDIO_MSG_COMPLETE message to the client */
|
|
|
|
#ifdef CONFIG_AUDIO_MULTI_SESSION
|
|
priv->dev.upper(priv->dev.priv, AUDIO_CALLBACK_COMPLETE, NULL, OK, NULL);
|
|
#else
|
|
priv->dev.upper(priv->dev.priv, AUDIO_CALLBACK_COMPLETE, NULL, OK);
|
|
#endif
|
|
|
|
audvdbg("Exit\n");
|
|
return NULL;
|
|
}
|
|
|
|
/****************************************************************************
|
|
* Name: wm8904_start
|
|
*
|
|
* Description:
|
|
* Start the configured operation (audio streaming, volume enabled, etc.).
|
|
*
|
|
****************************************************************************/
|
|
|
|
#ifdef CONFIG_AUDIO_MULTI_SESSION
|
|
static int wm8904_start(FAR struct audio_lowerhalf_s *dev, FAR void *session)
|
|
#else
|
|
static int wm8904_start(FAR struct audio_lowerhalf_s *dev)
|
|
#endif
|
|
{
|
|
FAR struct wm8904_dev_s *priv = (FAR struct wm8904_dev_s *)dev;
|
|
struct sched_param sparam;
|
|
struct mq_attr attr;
|
|
pthread_attr_t tattr;
|
|
FAR void *value;
|
|
int ret;
|
|
|
|
audvdbg("Entry\n");
|
|
|
|
/* Do a soft reset, just in case */
|
|
|
|
wm8904_reset(priv);
|
|
|
|
/* Exit reduced power modes of operation */
|
|
/* REVISIT */
|
|
|
|
/* Create a message queue for the worker thread */
|
|
|
|
snprintf(priv->mqname, sizeof(priv->mqname), "/tmp/%X", priv);
|
|
|
|
attr.mq_maxmsg = 16;
|
|
attr.mq_msgsize = sizeof(struct audio_msg_s);
|
|
attr.mq_curmsgs = 0;
|
|
attr.mq_flags = 0;
|
|
|
|
priv->mq = mq_open(priv->mqname, O_RDWR | O_CREAT, 0644, &attr);
|
|
if (priv->mq == NULL)
|
|
{
|
|
/* Error creating message queue! */
|
|
|
|
auddbg("ERROR: Couldn't allocate message queue\n");
|
|
return -ENOMEM;
|
|
}
|
|
|
|
/* Join any old worker thread we had created to prevent a memory leak */
|
|
|
|
if (priv->threadid != 0)
|
|
{
|
|
audvdbg("Joining old thread\n");
|
|
pthread_join(priv->threadid, &value);
|
|
}
|
|
|
|
/* Start our thread for sending data to the device */
|
|
|
|
pthread_attr_init(&tattr);
|
|
sparam.sched_priority = sched_get_priority_max(SCHED_FIFO) - 3;
|
|
(void)pthread_attr_setschedparam(&tattr, &sparam);
|
|
(void)pthread_attr_setstacksize(&tattr, CONFIG_WM8904_WORKER_STACKSIZE);
|
|
|
|
audvdbg("Starting worker thread\n");
|
|
ret = pthread_create(&priv->threadid, &tattr, wm8904_workerthread,
|
|
(pthread_addr_t)priv);
|
|
if (ret != OK)
|
|
{
|
|
auddbg("ERROR: pthread_create failed: %d\n", ret);
|
|
}
|
|
else
|
|
{
|
|
pthread_setname_np(priv->threadid, "wm8904");
|
|
audvdbg("Created worker thread\n");
|
|
}
|
|
|
|
return ret;
|
|
}
|
|
|
|
/****************************************************************************
|
|
* Name: wm8904_stop
|
|
*
|
|
* Description: Stop the configured operation (audio streaming, volume
|
|
* disabled, etc.).
|
|
*
|
|
****************************************************************************/
|
|
|
|
#ifndef CONFIG_AUDIO_EXCLUDE_STOP
|
|
#ifdef CONFIG_AUDIO_MULTI_SESSION
|
|
static int wm8904_stop(FAR struct audio_lowerhalf_s *dev, FAR void* session)
|
|
#else
|
|
static int wm8904_stop(FAR struct audio_lowerhalf_s *dev)
|
|
#endif
|
|
{
|
|
FAR struct wm8904_dev_s *priv = (FAR struct wm8904_dev_s *)dev;
|
|
struct audio_msg_s term_msg;
|
|
FAR void *value;
|
|
|
|
/* Send a message to stop all audio streaming */
|
|
|
|
term_msg.msgId = AUDIO_MSG_STOP;
|
|
term_msg.u.data = 0;
|
|
mq_send(priv->mq, &term_msg, sizeof(term_msg), CONFIG_WM8904_MSG_PRIO);
|
|
|
|
/* Join the worker thread */
|
|
|
|
pthread_join(priv->threadid, &value);
|
|
priv->threadid = 0;
|
|
|
|
/* Enter into a reduced power usage mode */
|
|
/* REVISIT: */
|
|
|
|
return OK;
|
|
}
|
|
#endif
|
|
|
|
/****************************************************************************
|
|
* Name: wm8904_pause
|
|
*
|
|
* Description: Pauses the playback.
|
|
*
|
|
****************************************************************************/
|
|
|
|
#ifndef CONFIG_AUDIO_EXCLUDE_PAUSE_RESUME
|
|
#ifdef CONFIG_AUDIO_MULTI_SESSION
|
|
static int wm8904_pause(FAR struct audio_lowerhalf_s *dev, FAR void* session)
|
|
#else
|
|
static int wm8904_pause(FAR struct audio_lowerhalf_s *dev)
|
|
#endif
|
|
{
|
|
FAR struct wm8904_dev_s *priv = (FAR struct wm8904_dev_s *)dev;
|
|
|
|
if (priv->running && !priv->paused)
|
|
{
|
|
/* Disable interrupts to prevent us from suppling any more data */
|
|
|
|
priv->paused = true;
|
|
wm8904_setvolume(priv, priv->volume, true);
|
|
WM8904_DISABLE(priv->lower);
|
|
}
|
|
|
|
return OK;
|
|
}
|
|
#endif /* CONFIG_AUDIO_EXCLUDE_PAUSE_RESUME */
|
|
|
|
/****************************************************************************
|
|
* Name: wm8904_resume
|
|
*
|
|
* Description: Resumes the playback.
|
|
*
|
|
****************************************************************************/
|
|
|
|
#ifndef CONFIG_AUDIO_EXCLUDE_PAUSE_RESUME
|
|
#ifdef CONFIG_AUDIO_MULTI_SESSION
|
|
static int wm8904_resume(FAR struct audio_lowerhalf_s *dev, FAR void* session)
|
|
#else
|
|
static int wm8904_resume(FAR struct audio_lowerhalf_s *dev)
|
|
#endif
|
|
{
|
|
FAR struct wm8904_dev_s *priv = (FAR struct wm8904_dev_s *)dev;
|
|
|
|
if (priv->running && priv->paused)
|
|
{
|
|
priv->paused = false;
|
|
wm8904_setvolume(priv, priv->volume, false);
|
|
|
|
/* Enable interrupts to allow sampling data */
|
|
|
|
wm8904_sendbuffer(priv);
|
|
WM8904_ENABLE(priv->lower);
|
|
}
|
|
|
|
return OK;
|
|
}
|
|
#endif /* CONFIG_AUDIO_EXCLUDE_PAUSE_RESUME */
|
|
|
|
/****************************************************************************
|
|
* Name: wm8904_enqueuebuffer
|
|
*
|
|
* Description: Enqueue an Audio Pipeline Buffer for playback/ processing.
|
|
*
|
|
****************************************************************************/
|
|
|
|
static int wm8904_enqueuebuffer(FAR struct audio_lowerhalf_s *dev,
|
|
FAR struct ap_buffer_s *apb)
|
|
{
|
|
FAR struct wm8904_dev_s *priv = (FAR struct wm8904_dev_s *)dev;
|
|
struct audio_msg_s term_msg;
|
|
int ret = -EAGAIN;
|
|
|
|
audvdbg("Entry\n");
|
|
|
|
/* Take a reference on the new audio buffer */
|
|
|
|
apb_reference(apb);
|
|
|
|
/* Add the new buffer to the tail of pending audio buffers */
|
|
|
|
wm8904_takesem(&priv->pendsem);
|
|
apb->flags = AUDIO_APB_OUTPUT_ENQUEUED;
|
|
dq_addlast(&apb->dq_entry, &priv->pendq);
|
|
wm8904_givesem(&priv->pendsem);
|
|
|
|
/* Send a message indicating a new buffer enqueued */
|
|
|
|
if (priv->mq != NULL)
|
|
{
|
|
term_msg.msgId = AUDIO_MSG_ENQUEUE;
|
|
term_msg.u.data = 0;
|
|
ret = mq_send(priv->mq, &term_msg, sizeof(term_msg), CONFIG_WM8904_MSG_PRIO);
|
|
if (ret < 0)
|
|
{
|
|
int errcode = errno;
|
|
DEBUGASSERT(errcode > 0);
|
|
auddbg("ERROR: mq_send failed: %d\n", errcode);
|
|
UNUSED(errcode);
|
|
}
|
|
}
|
|
|
|
return ret;
|
|
}
|
|
|
|
/****************************************************************************
|
|
* Name: wm8904_cancelbuffer
|
|
*
|
|
* Description: Called when an enqueued buffer is being cancelled.
|
|
*
|
|
****************************************************************************/
|
|
|
|
static int wm8904_cancelbuffer(FAR struct audio_lowerhalf_s *dev,
|
|
FAR struct ap_buffer_s *apb)
|
|
{
|
|
return OK;
|
|
}
|
|
|
|
/****************************************************************************
|
|
* Name: wm8904_ioctl
|
|
*
|
|
* Description: Perform a device ioctl
|
|
*
|
|
****************************************************************************/
|
|
|
|
static int wm8904_ioctl(FAR struct audio_lowerhalf_s *dev, int cmd,
|
|
unsigned long arg)
|
|
{
|
|
#ifdef CONFIG_AUDIO_DRIVER_SPECIFIC_BUFFERS
|
|
FAR struct ap_buffer_info_s *bufinfo;
|
|
#endif
|
|
|
|
/* Deal with ioctls passed from the upper-half driver */
|
|
|
|
switch (cmd)
|
|
{
|
|
/* Check for AUDIOIOC_HWRESET ioctl. This ioctl is passed straight
|
|
* through from the upper-half audio driver.
|
|
*/
|
|
|
|
case AUDIOIOC_HWRESET:
|
|
wm8904_reset((FAR struct wm8904_dev_s *)dev);
|
|
break;
|
|
|
|
/* Report our preferred buffer size and quantity */
|
|
|
|
#ifdef CONFIG_AUDIO_DRIVER_SPECIFIC_BUFFERS
|
|
case AUDIOIOC_GETBUFFERINFO:
|
|
|
|
bufinfo = (FAR struct ap_buffer_info_s *) arg;
|
|
bufinfo->buffer_size = CONFIG_WM8904_BUFFER_SIZE;
|
|
bufinfo->nbuffers = CONFIG_WM8904_NUM_BUFFERS;
|
|
break;
|
|
#endif
|
|
|
|
default:
|
|
break;
|
|
}
|
|
|
|
return OK;
|
|
}
|
|
|
|
/****************************************************************************
|
|
* Name: wm8904_reserve
|
|
*
|
|
* Description: Reserves a session (the only one we have).
|
|
*
|
|
****************************************************************************/
|
|
|
|
#ifdef CONFIG_AUDIO_MULTI_SESSION
|
|
static int wm8904_reserve(FAR struct audio_lowerhalf_s *dev,
|
|
FAR void **session)
|
|
#else
|
|
static int wm8904_reserve(FAR struct audio_lowerhalf_s *dev)
|
|
#endif
|
|
{
|
|
FAR struct wm8904_dev_s *priv = (FAR struct wm8904_dev_s *) dev;
|
|
int ret = OK;
|
|
|
|
/* Borrow the APBQ semaphore for thread sync */
|
|
|
|
wm8904_takesem(&priv->pendsem);
|
|
if (priv->reserved)
|
|
{
|
|
ret = -EBUSY;
|
|
}
|
|
else
|
|
{
|
|
/* Initialize the session context */
|
|
|
|
#ifdef CONFIG_AUDIO_MULTI_SESSION
|
|
*session = NULL;
|
|
#endif
|
|
priv->inflight = 0;
|
|
priv->running = false;
|
|
priv->paused = false;
|
|
#ifndef CONFIG_AUDIO_EXCLUDE_STOP
|
|
priv->terminating = false;
|
|
#endif
|
|
priv->reserved = true;
|
|
}
|
|
|
|
wm8904_givesem(&priv->pendsem);
|
|
|
|
return ret;
|
|
}
|
|
|
|
/****************************************************************************
|
|
* Name: wm8904_release
|
|
*
|
|
* Description: Releases the session (the only one we have).
|
|
*
|
|
****************************************************************************/
|
|
|
|
#ifdef CONFIG_AUDIO_MULTI_SESSION
|
|
static int wm8904_release(FAR struct audio_lowerhalf_s *dev,
|
|
FAR void *session)
|
|
#else
|
|
static int wm8904_release(FAR struct audio_lowerhalf_s *dev)
|
|
#endif
|
|
{
|
|
FAR struct wm8904_dev_s *priv = (FAR struct wm8904_dev_s *)dev;
|
|
void *value;
|
|
|
|
/* Join any old worker thread we had created to prevent a memory leak */
|
|
|
|
if (priv->threadid != 0)
|
|
{
|
|
pthread_join(priv->threadid, &value);
|
|
priv->threadid = 0;
|
|
}
|
|
|
|
/* Borrow the APBQ semaphore for thread sync */
|
|
|
|
wm8904_takesem(&priv->pendsem);
|
|
|
|
/* Really we should free any queued buffers here */
|
|
|
|
priv->reserved = false;
|
|
wm8904_givesem(&priv->pendsem);
|
|
|
|
return OK;
|
|
}
|
|
|
|
/****************************************************************************
|
|
* Name: wm8904_audio_output
|
|
*
|
|
* Description:
|
|
* Initialize and configure the WM8904 device as an audio output device.
|
|
*
|
|
* Input Parameters:
|
|
* priv - A reference to the driver state structure
|
|
*
|
|
* Returned Value:
|
|
* None. No failures are detected.
|
|
*
|
|
****************************************************************************/
|
|
|
|
static void wm8904_audio_output(FAR struct wm8904_dev_s *priv)
|
|
{
|
|
uint16_t regval;
|
|
|
|
/* Bias Control.
|
|
* Preserve undocumented default bit.WM8904_DUMMY
|
|
*/
|
|
|
|
regval = WM8904_ISEL_HIGH | WM8904_BIAS_ENA | 0x0010;
|
|
wm8904_writereg(priv, WM8904_BIAS_CTRL, regval);
|
|
|
|
/* VMID Control */
|
|
|
|
regval = WM8904_VMID_BUF_ENA | WM8904_VMID_RES_NORMAL | WM8904_VMID_ENA;
|
|
wm8904_writereg(priv, WM8904_VMID_CTRL, regval);
|
|
|
|
/* Mic Bias Control 0 */
|
|
/* MICDET_ENA=1, MICBIAS_ENA=1 */
|
|
|
|
regval = WM8904_MICDET_ENA | WM8904_MICBIAS_ENA;
|
|
wm8904_writereg(priv, WM8904_MIC_BIAS_CTRL0, regval);
|
|
|
|
/* Mic Bias Control 1. */
|
|
|
|
wm8904_writereg(priv, WM8904_MIC_BIAS_CTRL1, 0xc000);
|
|
|
|
/* Power Management 0 */
|
|
|
|
regval = WM8904_INL_ENA | WM8904_INR_ENA;
|
|
wm8904_writereg(priv, WM8904_PM0, regval);
|
|
|
|
/* Power Management 2 */
|
|
|
|
regval = WM8904_HPL_PGA_ENA | WM8904_HPR_PGA_ENA;
|
|
wm8904_writereg(priv, WM8904_PM2, regval);
|
|
|
|
/* Power Management 6 */
|
|
/* DACL_ENA=1, DACR_ENA=1, ADCL_ENA=1, ADCR_ENA=1 */
|
|
|
|
regval = WM8904_DACL_ENA | WM8904_DACR_ENA | WM8904_ADCL_ENA | WM8904_ADCR_ENA;
|
|
wm8904_writereg(priv, WM8904_PM6, regval);
|
|
|
|
/* Clock Rates 0.
|
|
*
|
|
* This value sets TOCLK_RATE_DIV16=0, TOCLK_RATE_X4=0, and MCLK_DIV=0 while
|
|
* preserving the state of some undocumented bits (see wm8904.h).
|
|
*/
|
|
|
|
wm8904_writereg(priv, WM8904_CLKRATE0, 0x845e);
|
|
|
|
/* Clock Rates 2 */
|
|
|
|
regval = WM8904_SYSCLK_SRC | WM8904_CLK_SYS_ENA | WM8904_CLK_DSP_ENA;
|
|
wm8904_writereg(priv, WM8904_CLKRATE2, regval);
|
|
|
|
/* Audio Interface 1.
|
|
*
|
|
* This value sets AIFADC_TDM=0, AIFADC_TDM_CHAN=0, BCLK_DIR=1 while preserving
|
|
* the state of some undocumented bits (see wm8904.h).
|
|
*/
|
|
|
|
wm8904_writereg(priv, WM8904_AIF1, 0x404A);
|
|
|
|
/* Audio Interface 3 */
|
|
|
|
regval = WM8904_LRCLK_DIR | WM8904_LRCLK_RATE(64);
|
|
wm8904_writereg(priv, WM8904_AIF3, regval);
|
|
|
|
/* DAC Digital 1 */
|
|
|
|
wm8904_writereg(priv, WM8904_DAC_DIGI1, 0);
|
|
|
|
/* Analogue Left Input 0 */
|
|
/* Analogue Right Input 0 */
|
|
|
|
regval = WM8904_IN_VOL(5);
|
|
wm8904_writereg(priv, WM8904_ANA_LEFT_IN0, regval);
|
|
wm8904_writereg(priv, WM8904_ANA_RIGHT_IN0, regval);
|
|
|
|
/* Analogue Left Input 1 */
|
|
|
|
wm8904_writereg(priv, WM8904_ANA_LEFT_IN1, 0);
|
|
wm8904_writereg(priv, WM8904_ANA_RIGHT_IN1, 0);
|
|
|
|
/* Analogue OUT1 Left */
|
|
/* Analogue OUT1 Right */
|
|
|
|
wm8904_setvolume(priv, CONFIG_WM8904_INITVOLUME, true);
|
|
|
|
/* DC Servo 0 */
|
|
|
|
regval = WM8904_DCS_ENA_CHAN_1 | WM8904_DCS_ENA_CHAN_0;
|
|
wm8904_writereg(priv, WM8904_DC_SERVO0, regval);
|
|
|
|
/* Analogue HP 0 */
|
|
|
|
regval = WM8904_HPL_RMV_SHORT | WM8904_HPL_ENA_OUTP | WM8904_HPL_ENA_DLY | WM8904_HPL_ENA |
|
|
WM8904_HPR_RMV_SHORT | WM8904_HPR_ENA_OUTP | WM8904_HPR_ENA_DLY | WM8904_HPR_ENA;
|
|
wm8904_writereg(priv, WM8904_ANA_HP0, regval);
|
|
|
|
/* Charge Pump 0 */
|
|
|
|
wm8904_writereg(priv, WM8904_CHG_PUMP0, WM8904_CP_ENA);
|
|
|
|
/* Class W 0 */
|
|
|
|
regval = WM8904_CP_DYN_PWR | 0x0004;
|
|
wm8904_writereg(priv, WM8904_CLASS_W0, regval);
|
|
|
|
/* FLL Control 1 */
|
|
|
|
wm8904_writereg(priv, WM8904_FLL_CTRL1, 0);
|
|
|
|
regval = WM8904_FLL_FRACN_ENA | WM8904_FLL_ENA;
|
|
wm8904_writereg(priv, WM8904_FLL_CTRL1, regval);
|
|
|
|
/* FLL Control 2 */
|
|
|
|
regval = WM8904_FLL_OUTDIV(8) | WM8904_FLL_FRATIO_DIV16;
|
|
wm8904_writereg(priv, WM8904_FLL_CTRL2, regval);
|
|
|
|
/* FLL Control 3 */
|
|
|
|
wm8904_writereg(priv, WM8904_FLL_CTRL3, 16384);
|
|
|
|
/* FLL Control 4 */
|
|
|
|
regval = WM8904_FLL_N(187) | WM8904_FLL_GAIN_X1;
|
|
wm8904_writereg(priv, WM8904_FLL_CTRL4, regval);
|
|
|
|
wm8904_writereg(priv, WM8904_DUMMY, 0x55AA);
|
|
}
|
|
|
|
/****************************************************************************
|
|
* Name: wm8904_audio_input
|
|
*
|
|
* Description:
|
|
* Initialize and configure the WM8904 device as an audio output device
|
|
* (Right input only).
|
|
*
|
|
* Input Parameters:
|
|
* prive - A reference to the driver state structure
|
|
*
|
|
* Returned Value:
|
|
* None. No failures are detected.
|
|
*
|
|
****************************************************************************/
|
|
|
|
#if 0 /* Not used */
|
|
static void wm8904_audio_input(FAR struct wm8904_dev_s *priv)
|
|
{
|
|
/* Analogue Left Input 0 */
|
|
|
|
wm8904_writereg(priv, WM8904_ANA_LEFT_IN0, WM8904_INMUTE);
|
|
|
|
/* Analogue Right Input 0 */
|
|
|
|
wm8904_writereg(priv, WM8904_ANA_RIGHT_IN0, WM8904_IN_VOL(5));
|
|
|
|
/* Analogue Left Input 1 */
|
|
|
|
wm8904_writereg(priv, WM8904_ANA_LEFT_IN1, 0);
|
|
|
|
/* Analogue Right Input 1 */
|
|
|
|
wm8904_writereg(priv, WM8904_ANA_RIGHT_IN1, WM8904_IP_SEL_N_IN2L);
|
|
}
|
|
#endif
|
|
|
|
/****************************************************************************
|
|
* Public Functions
|
|
****************************************************************************/
|
|
|
|
/****************************************************************************
|
|
* Name: wm8904_initialize
|
|
*
|
|
* Description:
|
|
* Initialize the WM8904 device.
|
|
*
|
|
* Input Parameters:
|
|
* i2c - An I2C driver instance
|
|
* i2s - An I2S driver instance
|
|
* lower - Persistent board configuration data
|
|
*
|
|
* Returned Value:
|
|
* A new lower half audio interface is returned for the WM8904 device is
|
|
* returned on success; NULL is returned on failure.
|
|
*
|
|
****************************************************************************/
|
|
|
|
FAR struct audio_lowerhalf_s *
|
|
wm8904_initialize(FAR struct i2c_dev_s *i2c, FAR struct i2s_dev_s *i2s,
|
|
FAR const struct wm8904_lower_s *lower)
|
|
{
|
|
FAR struct wm8904_dev_s *priv;
|
|
uint16_t regval;
|
|
|
|
/* Sanity check */
|
|
|
|
DEBUGASSERT(i2c && i2s && lower);
|
|
|
|
/* Allocate a WM8904 device structure */
|
|
|
|
priv = (FAR struct wm8904_dev_s *)kzalloc(sizeof(struct wm8904_dev_s));
|
|
if (priv)
|
|
{
|
|
/* Initialize the WM8904 device structure. Since we used kzalloc,
|
|
* only the non-zero elements of the structure need to be initialized.
|
|
*/
|
|
|
|
priv->dev.ops = &g_audioops;
|
|
priv->lower = lower;
|
|
priv->i2c = i2c;
|
|
#if !defined(CONFIG_AUDIO_EXCLUDE_VOLUME) && !defined(CONFIG_AUDIO_EXCLUDE_BALANCE)
|
|
priv->balance = b16HALF; /* Center balance */
|
|
#endif
|
|
|
|
sem_init(&priv->pendsem, 0, 1);
|
|
dq_init(&priv->pendq);
|
|
dq_init(&priv->doneq);
|
|
|
|
/* Initialize I2C */
|
|
|
|
auddbg("address=%02x frequency=%d\n", lower->address, lower->frequency);
|
|
I2C_SETFREQUENCY(i2c, lower->frequency);
|
|
I2C_SETADDRESS(i2c, lower->address, 7);
|
|
|
|
/* Software reset */
|
|
|
|
wm8904_writereg(priv, WM8904_SWRST, 0);
|
|
|
|
/* Verify that WM8904 is present and available on this I2C */
|
|
|
|
regval = wm8904_readreg(priv, WM8904_ID);
|
|
if (regval != WM8904_SW_RST_DEV_ID1)
|
|
{
|
|
auddbg("ERROR: WM8904 not found: ID=%04x\n", regval);
|
|
goto errout_with_dev;
|
|
}
|
|
|
|
/* Configure the WM8904 hardware as an audio input device */
|
|
|
|
wm8904_audio_output(priv);
|
|
|
|
/* Attach our ISR to this device */
|
|
|
|
WM8904_ATTACH(lower, wm8904_interrupt, priv);
|
|
|
|
/* Put the driver in the 'shutdown' state */
|
|
|
|
wm8904_shutdown(&priv->dev);
|
|
return &priv->dev;
|
|
}
|
|
|
|
return NULL;
|
|
|
|
errout_with_dev:
|
|
sem_destroy(&priv->pendsem);
|
|
kfree(priv);
|
|
return NULL;
|
|
}
|