SF32LB52 audio

Audio devices of the SF32LB52: the audio codec DAC and the PDM interface. More...

Data Structures
struct	pbl_audio_sf32lb52_audcodec
	Audio codec DAC. More...
struct	pbl_audio_sf32lb52_pdm
	PDM microphone interface. More...

Macros
#define	PBL_AUDIO_SF32LB52_AUDCODEC_DEFINE(sym, _name, _dma, _dma_irq, _link)
	Define the audio codec DAC, a playback device.
#define	PBL_AUDIO_SF32LB52_PDM_DEFINE(sym, _name, _pinctrl, _irq, _dma, _dma_irq, _vdd)
	Define the PDM interface, a capture device.

Functions
void	pbl_audio_sf32lb52_pdm_irq_handler (const struct pbl_audio_sf32lb52_pdm *pdm)
	PDM interrupt handler, to connect with PBL_IRQ_CONNECT().

Detailed Description

Audio devices of the SF32LB52: the audio codec DAC and the PDM interface.

The audio codec (AUDCODEC) plays mono through its DAC, with its analog bias, PLL and output stage, at 8 to 48 kHz; its digital gain runs from -36 to 0 dB. The PDM interface records one or two digital microphones at 8 to 48 kHz, mono taking the left channel; its gain runs from -15 to +45 dB. Both stream through a cyclic DMA channel of SF32LB52_DMAC1, so rings have two periods, of a multiple of 4 bytes; the board connects and gives the channel interrupt. The CPU does not enter deep sleep while they stream.

static const struct pbl_dma_chan s_dac_dma =
    PBL_DMA_CHAN(SF32LB52_DMAC1, 3, SF32LB52_DMA_REQ_AUDAC_CH0, SF32LB52_DMA_PL_HIGH);
PBL_AUDIO_SF32LB52_AUDCODEC_DEFINE(s_speaker, "speaker", &s_dac_dma, PBL_IRQN(DMAC1_CH4),
                                   &s_speaker_link);
PBL_IRQ_CONNECT(DMAC1_CH4, 5, pbl_dma_sf32lb52_irq_handler, &s_dac_dma, 0);

---

Data Structure Documentation

pbl_audio_sf32lb52_audcodec

struct pbl_audio_sf32lb52_audcodec

Audio codec DAC.

Data Fields
struct pbl_audio	audio	Audio device.
const struct pbl_dma_chan *	dma	DAC DMA channel.
pbl_irq_t	dma_irq	Interrupt of the DMA channel.
struct pbl_audio_sf32lb52_audcodec_state *	state	Driver runtime state.

pbl_audio_sf32lb52_pdm

struct pbl_audio_sf32lb52_pdm

PDM microphone interface.

Data Fields
struct pbl_audio	audio	Audio device.
const struct pbl_dma_chan *	dma	DMA channel.
pbl_irq_t	dma_irq	Interrupt of the DMA channel.
pbl_irq_t	irq	PDM interrupt, reporting FIFO overflows.
const struct pbl_pinctrl *	pinctrl	Clock and data pins.
struct pbl_audio_sf32lb52_pdm_state *	state	Driver runtime state.
const struct pbl_regulator *	vdd	Microphone supply, on while recording, or NULL.

Macro Definition Documentation

PBL_AUDIO_SF32LB52_AUDCODEC_DEFINE

#define PBL_AUDIO_SF32LB52_AUDCODEC_DEFINE	(		sym,
			_name,
			_dma,
			_dma_irq,
			_link
	)

Value:

  PBL_AUDIO_STATE_DEFINE(sym);                                                                \
  static struct pbl_audio_sf32lb52_audcodec_state sym##_audcodec_state;                       \
  static const struct pbl_audio_sf32lb52_audcodec sym = {                                     \
    .audio = PBL_AUDIO_INIT(sym, _name, PBL_AUDIO_PLAYBACK, &pbl_audio_sf32lb52_audcodec_ops, \
                            _link, PBL_DEVICE_DEPS(&(_dma)->ctrl->dev)),                      \
    .dma = (_dma),                                                                            \
    .dma_irq = (_dma_irq),                                                                    \
    .state = &sym##_audcodec_state,                                                           \
  };                                                                                          \
  PBL_DEVICE_REGISTER(sym, &sym.audio.dev)

Define the audio codec DAC, a playback device.

Parameters

sym	Symbol of the device.
_name	Device name.
_dma	DAC DMA channel, on SF32LB52_DMAC1 with request SF32LB52_DMA_REQ_AUDAC_CH0.
_dma_irq	Interrupt of the DMA channel.
_link	What the DAC is wired to, or NULL.

PBL_AUDIO_SF32LB52_PDM_DEFINE

#define PBL_AUDIO_SF32LB52_PDM_DEFINE	(		sym,
			_name,
			_pinctrl,
			_irq,
			_dma,
			_dma_irq,
			_vdd
	)

Value:

  PBL_AUDIO_STATE_DEFINE(sym);                                                                   \
  static struct pbl_audio_sf32lb52_pdm_state sym##_pdm_state;                                    \
  static const struct pbl_pinctrl sym##_pdm_pins = _pinctrl;                                     \
  static const struct pbl_audio_sf32lb52_pdm sym = {                                             \
    .audio = PBL_AUDIO_INIT(sym, _name, PBL_AUDIO_CAPTURE, &pbl_audio_sf32lb52_pdm_ops, nullptr, \
                            PBL_DEVICE_DEPS(&(_dma)->ctrl->dev)),                                \
    .pinctrl = &sym##_pdm_pins,                                                                  \
    .irq = (_irq),                                                                               \
    .dma = (_dma),                                                                               \
    .dma_irq = (_dma_irq),                                                                       \
    .vdd = (_vdd),                                                                               \
    .state = &sym##_pdm_state,                                                                   \
  };                                                                                             \
  PBL_DEVICE_REGISTER(sym, &sym.audio.dev)

Define the PDM interface, a capture device.

Parameters

sym	Symbol of the device.
_name	Device name.
_pinctrl	Clock and data pins, from PBL_PINCTRL().
_irq	PDM interrupt; the board connects pbl_audio_sf32lb52_pdm_irq_handler() to it.
_dma	DMA channel, on SF32LB52_DMAC1 with request SF32LB52_DMA_REQ_PDM1_L.
_dma_irq	Interrupt of the DMA channel.
_vdd	Microphone supply, or NULL.

Function Documentation

pbl_audio_sf32lb52_pdm_irq_handler()

void pbl_audio_sf32lb52_pdm_irq_handler

(

const struct pbl_audio_sf32lb52_pdm *

pdm

)

PDM interrupt handler, to connect with PBL_IRQ_CONNECT().

Parameters

pdm	PDM interface.