Outputs to ESP32 DAC through the ULP (Ultra> Low Power coprocessor), freeing I2S for other uses. Connect left channel on pin 25 Connect right channel on pin 26. More...

#include <AudioESP32ULP.h>

Inheritance diagram for AudioESP32ULP:

Public Member Functions
virtual void	addNotifyAudioChange (AudioInfoSupport &bi)
	Adds target to be notified about audio changes.

virtual AudioInfo	audioInfo () override
	provides the actual input AudioInfo

virtual AudioInfo	audioInfoOut ()

int	availableForWrite ()

virtual bool	begin ()

bool	begin (AudioInfo info)
	Starts the processing. I the output is mono, we can determine the output pin by selecting DAC1 (gpio25) or DAC2 (gpio26)

virtual void	clearNotifyAudioChange ()
	Deletes all change notify subscriptions.

AudioInfo	defaultConfig ()

void	end ()

virtual void	flush ()

virtual bool	isDeletable ()
	If true we need to release the related memory in the destructor.

bool	isNotifyActive ()
	Checks if the automatic AudioInfo update is active.

virtual	operator bool ()

virtual bool	removeNotifyAudioChange (AudioInfoSupport &bi)
	Removes a target in order not to be notified about audio changes.

virtual void	setAudioInfo (AudioInfo newInfo) override
	Defines the input AudioInfo.

void	setMinWriteBytes (int bytes)
	Selects the limit for the availableForWrite to report the data.

void	setMonoDAC (UlpDac dac)
	Selects the DAC when we have a mono signal.

void	setNotifyActive (bool flag)
	Deactivate/Reactivate automatic AudioInfo updates: (default is active)

size_t	write (const uint8_t *data, size_t len)

virtual size_t	write (uint8_t ch) override

virtual void	writeSilence (size_t len)

Protected Member Functions
uint32_t	create_I_BXI (uint32_t imm_pc)

uint32_t	create_I_WR_REG (uint32_t reg, uint32_t low_bit, uint32_t high_bit, uint32_t val)

void	notifyAudioChange (AudioInfo info)

bool	setup ()

bool	writeFrame (int16_t sample[2])

Protected Attributes
int	_timeout = 10

int	activeDACs = 3

uint8_t	bufferedOddSample = 128

const uint32_t	bufferStart = indexAddress + 1

AudioInfo	cfg

const uint32_t	dacTableStart1 = 2048 - 512

const uint32_t	dacTableStart2 = dacTableStart1 - 512

int	hertz

const uint32_t	indexAddress = opcodeCount

bool	is_active = false

bool	is_notify_active = true

int	lastFilledWord = 0

int	min_write_bytes = 128

Vector< AudioInfoSupport * >	notify_vector

const int	opcodeCount = 20

UlpDac	selected_mono_dac = ULP_DAC1

bool	stereoOutput = true

SingleBuffer< uint8_t >	tmp {MAX_SINGLE_CHARS}

int	tmpPos = 0

const int	totalSamples = totalSampleWords * 2

uint32_t	totalSampleWords

bool	waitingOddSample = true

Detailed Description

Outputs to ESP32 DAC through the ULP (Ultra> Low Power coprocessor), freeing I2S for other uses. Connect left channel on pin 25 Connect right channel on pin 26.

Version: 0.1

Date: 2023-03-26

Copyright: (C) 2020 Martin Laclaustra, based on bitluni's code

Member Function Documentation

◆ addNotifyAudioChange()

virtual void addNotifyAudioChange ( AudioInfoSupport & bi )

inlinevirtualinherited

Adds target to be notified about audio changes.

Reimplemented in CodecNOP, EncodedAudioOutput, EncodedAudioStream, AACDecoderFDK, DecoderBasic, CodecChain, MP3DecoderHelix, MP3DecoderMAD, OggContainerDecoder, RTSPClient< TcpClient, UdpSocket >, Pipeline, and Pipeline::ModifyingStreamAdapter.

◆ audioInfo()

virtual AudioInfo audioInfo ( )

inlineoverridevirtualinherited

provides the actual input AudioInfo

Implements AudioInfoSupport.

Reimplemented in AdapterPrintToAudioOutput, EncodedAudioOutput, and AdapterAudioStreamToAudioOutput.

◆ audioInfoOut()

virtual AudioInfo audioInfoOut ( )

inlinevirtualinherited

provides the actual output AudioInfo: this is usually the same as audioInfo() unless we use a transforming stream

Reimplemented in PureDataStream, PWMAudioOutput, ChannelFormatConverterStreamT< T >, ChannelFormatConverterStream, NumberFormatConverterStreamT< TFrom, TTo >, NumberFormatConverterStream, FormatConverterStream, Pipeline, ResampleStream, and ResampleStreamT< TInterpolator >.

◆ availableForWrite()

int availableForWrite ( )

inlinevirtual

Reimplemented from AudioOutput.

◆ begin() [1/2]

virtual bool begin ( )

inlinevirtualinherited

Reimplemented in OSCContainerEncoder::OSCOutput, AudioOutputWithCallback, AudioServerEx, RTSPOutput< Platform >, PitchShiftOutput< T, BufferT >, PWMAudioOutput, RTTTLOutput< T >, EncodedAudioOutput, OggContainerOutput, FFTEffect, FFTPitchShift, R2ROutput, AdapterAudioStreamToAudioOutput, ChannelsSelectOutput, MetaDataFilter, CsvOutput< T >, HexDumpOutput, MemoryOutput, and RTTTLOutput< T >.

◆ begin() [2/2]

bool begin ( AudioInfo info )

inlinevirtual

Starts the processing. I the output is mono, we can determine the output pin by selecting DAC1 (gpio25) or DAC2 (gpio26)

Reimplemented from AudioOutput.

◆ clearNotifyAudioChange()

virtual void clearNotifyAudioChange ( )

inlinevirtualinherited

Deletes all change notify subscriptions.

Reimplemented in RTSPClient< TcpClient, UdpSocket >.

◆ create_I_BXI()

uint32_t create_I_BXI ( uint32_t imm_pc )

inlineprotected

◆ create_I_WR_REG()

uint32_t create_I_WR_REG	(	uint32_t	reg,
		uint32_t	low_bit,
		uint32_t	high_bit,
		uint32_t	val
	)

inlineprotected

◆ defaultConfig()

AudioInfo defaultConfig ( )

inline

◆ end()

void end ( )

inlinevirtual

Reimplemented from AudioOutput.

◆ flush()

virtual void flush ( )

inlinevirtualinherited

Reimplemented from Print.

Reimplemented in MultiOutput, and HexDumpOutput.

◆ isDeletable()

virtual bool isDeletable ( )

inlinevirtualinherited

If true we need to release the related memory in the destructor.

Reimplemented in AdapterPrintToAudioOutput, and AdapterAudioStreamToAudioOutput.

◆ isNotifyActive()

bool isNotifyActive ( )

inlineinherited

Checks if the automatic AudioInfo update is active.

◆ notifyAudioChange()

void notifyAudioChange ( AudioInfo info )

inlineprotectedinherited

◆ operator bool()

virtual operator bool ( )

inlinevirtualinherited

Reimplemented in RTSPOutput< Platform >, EncodedAudioOutput, and AdapterAudioStreamToAudioOutput.

◆ removeNotifyAudioChange()

virtual bool removeNotifyAudioChange ( AudioInfoSupport & bi )

inlinevirtualinherited

Removes a target in order not to be notified about audio changes.

Reimplemented in RTSPClient< TcpClient, UdpSocket >.

◆ setAudioInfo()

virtual void setAudioInfo ( AudioInfo info )

inlineoverridevirtualinherited

Defines the input AudioInfo.

Implements AudioInfoSupport.

Reimplemented in ChannelsSelectOutput, AdapterPrintToAudioOutput, MultiOutput, AdapterAudioStreamToAudioOutput, CsvOutput< T >, PWMAudioOutput, and EncodedAudioOutput.

◆ setMinWriteBytes()

void setMinWriteBytes ( int bytes )

inline

Selects the limit for the availableForWrite to report the data.

◆ setMonoDAC()

void setMonoDAC ( UlpDac dac )

inline

Selects the DAC when we have a mono signal.

◆ setNotifyActive()

void setNotifyActive ( bool flag )

inlineinherited

Deactivate/Reactivate automatic AudioInfo updates: (default is active)

◆ setup()

bool setup ( )

inlineprotected

◆ write() [1/2]

size_t write	(	const uint8_t *	data,
		size_t	len
	)

inlinevirtual

Implements AudioOutput.

◆ write() [2/2]

virtual size_t write ( uint8_t ch )

inlineoverridevirtualinherited

Reimplemented in MetaDataOutput, and MultiOutput.

◆ writeFrame()

bool writeFrame ( int16_t sample[2] )

inlineprotected

◆ writeSilence()

virtual void writeSilence ( size_t len )

inlinevirtualinherited

Writes n 0 values (= silence)

Parameters

uint32_t totalSampleWords

protected

Initial value:

=

2048 - 512 - 512 - (opcodeCount + 1)

audio_tools::AudioESP32ULP::opcodeCount

const int opcodeCount

Definition AudioESP32ULP.h:127

◆ waitingOddSample

bool waitingOddSample = true

protected

The documentation for this class was generated from the following file:

src/AudioTools/AudioLibs/AudioESP32ULP.h

Public Member Functions

Protected Member Functions

Protected Attributes

Detailed Description

Member Function Documentation

◆ addNotifyAudioChange()

◆ audioInfo()

◆ audioInfoOut()

◆ availableForWrite()

◆ begin() [1/2]

◆ begin() [2/2]

◆ clearNotifyAudioChange()

◆ create_I_BXI()

◆ create_I_WR_REG()

◆ defaultConfig()

◆ end()

◆ flush()

◆ isDeletable()

◆ isNotifyActive()

◆ notifyAudioChange()

◆ operator bool()

◆ removeNotifyAudioChange()

◆ setAudioInfo()

◆ setMinWriteBytes()

◆ setMonoDAC()

◆ setNotifyActive()

◆ setup()

◆ write() [1/2]

◆ write() [2/2]

◆ writeFrame()

◆ writeSilence()

Member Data Documentation

◆ _timeout

◆ activeDACs

◆ bufferedOddSample

◆ bufferStart

◆ cfg

◆ dacTableStart1

◆ dacTableStart2

◆ hertz

◆ indexAddress

◆ is_active

◆ is_notify_active

◆ lastFilledWord

◆ min_write_bytes

◆ notify_vector

◆ opcodeCount

◆ selected_mono_dac

◆ stereoOutput

◆ tmp

◆ tmpPos

◆ totalSamples

◆ totalSampleWords

◆ waitingOddSample