#include <i2s_audio_microphone.h>

Inheritance diagram for esphome::i2s_audio::I2SAudioMicrophone:

Public Member Functions
void	setup () override

void	dump_config () override

void	start () override

void	stop () override

void	loop () override

void	set_correct_dc_offset (bool correct_dc_offset)

void	set_din_pin (int8_t pin)

void	set_din_pin (int8_t pin)

void	set_pdm (bool pdm)

void	set_adc_channel (adc_channel_t channel)

Public Member Functions inherited from esphome::i2s_audio::I2SAudioBase
void	set_i2s_mode (i2s_mode_t mode)

void	set_channel (i2s_channel_fmt_t channel)

void	set_bits_per_sample (i2s_bits_per_sample_t bits_per_sample)

void	set_bits_per_channel (i2s_bits_per_chan_t bits_per_channel)

void	set_i2s_role (i2s_role_t role)

void	set_slot_mode (i2s_slot_mode_t slot_mode)

void	set_std_slot_mask (i2s_std_slot_mask_t std_slot_mask)

void	set_slot_bit_width (i2s_slot_bit_width_t slot_bit_width)

void	set_sample_rate (uint32_t sample_rate)

void	set_use_apll (uint32_t use_apll)

void	set_mclk_multiple (i2s_mclk_multiple_t mclk_multiple)

Public Member Functions inherited from esphome::Parented< I2SAudioComponent >
	Parented ()

	Parented (I2SAudioComponent *parent)

I2SAudioComponent *	get_parent () const
	Get the parent of this object.

void	set_parent (I2SAudioComponent *parent)
	Set the parent of this object.

Public Member Functions inherited from esphome::microphone::Microphone
void	add_data_callback (std::function< void(const std::vector< uint8_t > &)> &&data_callback)

bool	is_running () const

bool	is_stopped () const

void	set_mute_state (bool is_muted)

bool	get_mute_state ()

audio::AudioStreamInfo	get_audio_stream_info ()

Public Member Functions inherited from esphome::Component
virtual float	get_setup_priority () const
	priority of setup().

float	get_actual_setup_priority () const

void	set_setup_priority (float priority)

virtual float	get_loop_priority () const
	priority of loop().

void	call ()

virtual void	on_shutdown ()

virtual void	on_safe_shutdown ()

virtual bool	teardown ()
	Called during teardown to allow component to gracefully finish operations.

virtual void	on_powerdown ()
	Called after teardown is complete to power down hardware.

uint8_t	get_component_state () const

void	reset_to_construction_state ()
	Reset this component back to the construction state to allow setup to run again.

bool	is_in_loop_state () const
	Check if this component has completed setup and is in the loop state.

bool	is_idle () const
	Check if this component is idle.

virtual void	mark_failed ()
	Mark this component as failed.

	ESPDEPRECATED ("Use mark_failed(LOG_STR(\"static string literal\")) instead. Do NOT use .c_str() from temporary " "strings. Will stop working in 2026.6.0", "2025.12.0") void mark_failed(const char *message)

void	mark_failed (const LogString *message)

void	disable_loop ()
	Disable this component's loop.

void	enable_loop ()
	Enable this component's loop.

void	enable_loop_soon_any_context ()
	Thread and ISR-safe version of enable_loop() that can be called from any context.

bool	is_failed () const

bool	is_ready () const

virtual bool	can_proceed ()

bool	status_has_warning () const

bool	status_has_error () const

void	status_set_warning (const char *message=nullptr)

void	status_set_warning (const LogString *message)

void	status_set_error ()

	ESPDEPRECATED ("Use status_set_error(LOG_STR(\"static string literal\")) instead. Do NOT use .c_str() from temporary " "strings. Will stop working in 2026.6.0", "2025.12.0") void status_set_error(const char *message)

void	status_set_error (const LogString *message)

void	status_clear_warning ()

void	status_clear_error ()

void	status_momentary_warning (const char *name, uint32_t length=5000)
	Set warning status flag and automatically clear it after a timeout.

void	status_momentary_error (const char *name, uint32_t length=5000)
	Set error status flag and automatically clear it after a timeout.

bool	has_overridden_loop () const

void	set_component_source (const LogString *source)
	Set where this component was loaded from for some debug messages.

const LogString *	get_component_log_str () const
	Get the integration where this component was declared as a LogString for logging.

bool	should_warn_of_blocking (uint32_t blocking_time)

Protected Member Functions
void	configure_stream_settings_ ()
	Starts the I2S driver.

Protected Member Functions inherited from esphome::Component
virtual void	call_loop ()

virtual void	call_setup ()

virtual void	call_dump_config ()

void	set_component_state_ (uint8_t state)
	Helper to set component state (clears state bits and sets new state)

void	set_interval (uint32_t id, uint32_t interval, std::function< void()> &&f)
	Set an interval function with a numeric ID (zero heap allocation).

void	set_interval (InternalSchedulerID id, uint32_t interval, std::function< void()> &&f)

void	set_interval (uint32_t interval, std::function< void()> &&f)

bool	cancel_interval (uint32_t id)

bool	cancel_interval (InternalSchedulerID id)

ESPDEPRECATED("set_retry is deprecated and will be removed in 2026.8.0. Use set_timeout or set_interval instead.", "2026.2.0") void set_retry(const std	ESPDEPRECATED ("set_retry is deprecated and will be removed in 2026.8.0. Use set_timeout or set_interval instead.", "2026.2.0") void set_retry(const char *name

	ESPDEPRECATED ("set_retry is deprecated and will be removed in 2026.8.0. Use set_timeout or set_interval instead.", "2026.2.0") void set_retry(uint32_t id

	ESPDEPRECATED ("set_retry is deprecated and will be removed in 2026.8.0. Use set_timeout or set_interval instead.", "2026.2.0") void set_retry(uint32_t initial_wait_time

ESPDEPRECATED("cancel_retry is deprecated and will be removed in 2026.8.0.", "2026.2.0") bool cancel_retry(const std	ESPDEPRECATED ("cancel_retry is deprecated and will be removed in 2026.8.0.", "2026.2.0") bool cancel_retry(const char *name)

	ESPDEPRECATED ("cancel_retry is deprecated and will be removed in 2026.8.0.", "2026.2.0") bool cancel_retry(uint32_t id)

void	set_timeout (uint32_t id, uint32_t timeout, std::function< void()> &&f)
	Set a timeout function with a numeric ID (zero heap allocation).

void	set_timeout (InternalSchedulerID id, uint32_t timeout, std::function< void()> &&f)

void	set_timeout (uint32_t timeout, std::function< void()> &&f)

bool	cancel_timeout (uint32_t id)

bool	cancel_timeout (InternalSchedulerID id)

void	defer (std::function< void()> &&f)
	Defer a callback to the next loop() call.

void	defer (uint32_t id, std::function< void()> &&f)
	Defer a callback with a numeric ID (zero heap allocation)

bool	cancel_defer (uint32_t id)

Static Protected Member Functions
static void	mic_task (void *params)

Protected Attributes
SemaphoreHandle_t	active_listeners_semaphore_ {nullptr}

EventGroupHandle_t	event_group_ {nullptr}

TaskHandle_t	task_handle_ {nullptr}

int8_t	din_pin_ {I2S_PIN_NO_CHANGE}

adc1_channel_t	adc_channel_ {ADC1_CHANNEL_MAX}

bool	adc_ {false}

gpio_num_t	din_pin_ {I2S_GPIO_UNUSED}

i2s_chan_handle_t	rx_handle_

bool	pdm_ {false}

bool	correct_dc_offset_

bool	locked_driver_ {false}

int32_t	dc_offset_prev_input_ {0}

int32_t	dc_offset_prev_output_ {0}

Protected Attributes inherited from esphome::i2s_audio::I2SAudioBase
i2s_mode_t	i2s_mode_ {}

i2s_channel_fmt_t	channel_

i2s_bits_per_sample_t	bits_per_sample_

i2s_bits_per_chan_t	bits_per_channel_

i2s_role_t	i2s_role_ {}

i2s_slot_mode_t	slot_mode_

i2s_std_slot_mask_t	std_slot_mask_

i2s_slot_bit_width_t	slot_bit_width_

uint32_t	sample_rate_

bool	use_apll_

i2s_mclk_multiple_t	mclk_multiple_

Protected Attributes inherited from esphome::Parented< I2SAudioComponent >
I2SAudioComponent *	parent_

Protected Attributes inherited from esphome::microphone::Microphone
State	state_ {STATE_STOPPED}

bool	mute_state_ {false}

audio::AudioStreamInfo	audio_stream_info_

CallbackManager< void(const std::vector< uint8_t > &)>	data_callbacks_ {}

Protected Attributes inherited from esphome::Component
ESPDEPRECATED("Use const char* or uint32_t overload instead. Removed in 2026.7.0", "2026.1.0") void set_interval(const std voi	set_interval )(const char *name, uint32_t interval, std::function< void()> &&f)
	Set an interval function with a unique name.

ESPDEPRECATED("Use const char* or uint32_t overload instead. Removed in 2026.7.0", "2026.1.0") bool cancel_interval(const std boo	cancel_interval )(const char *name)
	Cancel an interval function.

ESPDEPRECATED("set_retry is deprecated and will be removed in 2026.8.0. Use set_timeout or set_interval instead.", "2026.2.0") void set_retry(const std uint32_t	initial_wait_time

ESPDEPRECATED("set_retry is deprecated and will be removed in 2026.8.0. Use set_timeout or set_interval instead.", "2026.2.0") void set_retry(const std uint32_t uint8_t	max_attempts

ESPDEPRECATED("set_retry is deprecated and will be removed in 2026.8.0. Use set_timeout or set_interval instead.", "2026.2.0") void set_retry(const std uint32_t uint8_t std::function< RetryResult(uint8_t)> &&	f

ESPDEPRECATED("set_retry is deprecated and will be removed in 2026.8.0. Use set_timeout or set_interval instead.", "2026.2.0") void set_retry(const std uint32_t uint8_t std::function< RetryResult(uint8_t)> float	backoff_increase_factor = 1.0f)

uint32_t	initial_wait_time

uint32_t uint8_t	max_attempts

uint32_t uint8_t std::function< RetryResult(uint8_t)> &&	f

uint32_t uint8_t std::function< RetryResult(uint8_t)> float	backoff_increase_factor = 1.0f)

uint8_t	max_attempts

uint8_t std::function< RetryResult(uint8_t)> &&	f

uint8_t std::function< RetryResult(uint8_t)> float	backoff_increase_factor = 1.0f)

ESPDEPRECATED("Use const char* or uint32_t overload instead. Removed in 2026.7.0", "2026.1.0") void set_timeout(const std voi	set_timeout )(const char *name, uint32_t timeout, std::function< void()> &&f)
	Set a timeout function with a unique name.

ESPDEPRECATED("Use const char* or uint32_t overload instead. Removed in 2026.7.0", "2026.1.0") bool cancel_timeout(const std boo	cancel_timeout )(const char *name)
	Cancel a timeout function.

ESPDEPRECATED("Use const char* overload instead. Removed in 2026.7.0", "2026.1.0") void defer(const std voi	defer )(const char *name, std::function< void()> &&f)
	Defer a callback to the next loop() call.

ESPDEPRECATED("Use const char* overload instead. Removed in 2026.7.0", "2026.1.0") bool cancel_defer(const std boo	cancel_defer )(const char *name)
	Cancel a defer callback using the specified name, name must not be empty.

const LogString *	component_source_ {nullptr}

uint16_t	warn_if_blocking_over_ {WARN_IF_BLOCKING_OVER_MS}
	Warn if blocked for this many ms (max 65.5s)

uint8_t	component_state_ {0x00}
	State of this component - each bit has a purpose: Bits 0-2: Component state (0x00=CONSTRUCTION, 0x01=SETUP, 0x02=LOOP, 0x03=FAILED, 0x04=LOOP_DONE) Bit 3: STATUS_LED_WARNING Bit 4: STATUS_LED_ERROR Bits 5-7: Unused - reserved for future expansion.

volatile bool	pending_enable_loop_ {false}
	ISR-safe flag for enable_loop_soon_any_context.

Detailed Description

Definition at line 18 of file i2s_audio_microphone.h.

Member Function Documentation

◆ configure_stream_settings_()

void esphome::i2s_audio::I2SAudioMicrophone::configure_stream_settings_ ( )

protected

Starts the I2S driver.

Updates the audio_stream_info_ member variable with the current setttings. /

Returns: True if succesful, false otherwise bool start_driver_();

/ Stops the I2S driver. void stop_driver_();

/ Attempts to correct a microphone DC offset; e.g., a microphones silent level is offset from 0. Applies a / correction offset that is updated using an exponential moving average for all samples away from 0. /

Parameters

data	void fix_dc_offset_(std::vector<uint8_t> &data);

size_t read_(uint8_t *buf, size_t len, TickType_t ticks_to_wait);

/ Sets the Microphone audio_stream_info_ member variable to the configured I2S settings.

Definition at line 87 of file i2s_audio_microphone.cpp.

◆ dump_config()

void esphome::i2s_audio::I2SAudioMicrophone::dump_config ( )

overridevirtual

Reimplemented from esphome::Component.

Definition at line 78 of file i2s_audio_microphone.cpp.

◆ loop()

void esphome::i2s_audio::I2SAudioMicrophone::loop ( )

overridevirtual

Reimplemented from esphome::Component.

Definition at line 470 of file i2s_audio_microphone.cpp.

◆ mic_task()

void esphome::i2s_audio::I2SAudioMicrophone::mic_task ( void * params )

staticprotected

Definition at line 346 of file i2s_audio_microphone.cpp.

◆ set_adc_channel()

void esphome::i2s_audio::I2SAudioMicrophone::set_adc_channel ( adc_channel_t channel )

inline

Definition at line 39 of file i2s_audio_microphone.h.

◆ set_correct_dc_offset()

void esphome::i2s_audio::I2SAudioMicrophone::set_correct_dc_offset ( bool correct_dc_offset )

inline

Definition at line 27 of file i2s_audio_microphone.h.

◆ set_din_pin() [1/2]

void esphome::i2s_audio::I2SAudioMicrophone::set_din_pin ( int8_t pin )

inline

Definition at line 30 of file i2s_audio_microphone.h.

◆ set_din_pin() [2/2]

void esphome::i2s_audio::I2SAudioMicrophone::set_din_pin ( int8_t pin )

inline

Definition at line 32 of file i2s_audio_microphone.h.

◆ set_pdm()

void esphome::i2s_audio::I2SAudioMicrophone::set_pdm ( bool pdm )

inline

Definition at line 35 of file i2s_audio_microphone.h.

◆ setup()

void esphome::i2s_audio::I2SAudioMicrophone::setup ( )

overridevirtual

Reimplemented from esphome::Component.

Definition at line 39 of file i2s_audio_microphone.cpp.

◆ start()

void esphome::i2s_audio::I2SAudioMicrophone::start ( )

overridevirtual

Implements esphome::microphone::Microphone.

Definition at line 124 of file i2s_audio_microphone.cpp.

◆ stop()

void esphome::i2s_audio::I2SAudioMicrophone::stop ( )

overridevirtual

Implements esphome::microphone::Microphone.

Definition at line 296 of file i2s_audio_microphone.cpp.

Field Documentation

◆ active_listeners_semaphore_

SemaphoreHandle_t esphome::i2s_audio::I2SAudioMicrophone::active_listeners_semaphore_ {nullptr}

protected

Definition at line 66 of file i2s_audio_microphone.h.

◆ adc_

bool esphome::i2s_audio::I2SAudioMicrophone::adc_ {false}

protected

Definition at line 75 of file i2s_audio_microphone.h.

◆ adc_channel_

adc1_channel_t esphome::i2s_audio::I2SAudioMicrophone::adc_channel_ {ADC1_CHANNEL_MAX}

protected

Definition at line 74 of file i2s_audio_microphone.h.

◆ correct_dc_offset_

bool esphome::i2s_audio::I2SAudioMicrophone::correct_dc_offset_

protected

Definition at line 83 of file i2s_audio_microphone.h.

◆ dc_offset_prev_input_

int32_t esphome::i2s_audio::I2SAudioMicrophone::dc_offset_prev_input_ {0}

protected

Definition at line 85 of file i2s_audio_microphone.h.

◆ dc_offset_prev_output_

int32_t esphome::i2s_audio::I2SAudioMicrophone::dc_offset_prev_output_ {0}

protected

Definition at line 86 of file i2s_audio_microphone.h.

◆ din_pin_ [1/2]

int8_t esphome::i2s_audio::I2SAudioMicrophone::din_pin_ {I2S_PIN_NO_CHANGE}

protected

Definition at line 72 of file i2s_audio_microphone.h.

◆ din_pin_ [2/2]

gpio_num_t esphome::i2s_audio::I2SAudioMicrophone::din_pin_ {I2S_GPIO_UNUSED}

protected

Definition at line 78 of file i2s_audio_microphone.h.

◆ event_group_

EventGroupHandle_t esphome::i2s_audio::I2SAudioMicrophone::event_group_ {nullptr}

protected

Definition at line 67 of file i2s_audio_microphone.h.

◆ locked_driver_

bool esphome::i2s_audio::I2SAudioMicrophone::locked_driver_ {false}

protected

Definition at line 84 of file i2s_audio_microphone.h.

◆ pdm_

bool esphome::i2s_audio::I2SAudioMicrophone::pdm_ {false}

protected

Definition at line 81 of file i2s_audio_microphone.h.

◆ rx_handle_

i2s_chan_handle_t esphome::i2s_audio::I2SAudioMicrophone::rx_handle_

protected

Definition at line 79 of file i2s_audio_microphone.h.

◆ task_handle_

TaskHandle_t esphome::i2s_audio::I2SAudioMicrophone::task_handle_ {nullptr}

protected

Definition at line 69 of file i2s_audio_microphone.h.

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

esphome/components/i2s_audio/microphone/i2s_audio_microphone.h
esphome/components/i2s_audio/microphone/i2s_audio_microphone.cpp

Public Member Functions

Protected Member Functions

Static Protected Member Functions

Protected Attributes

Detailed Description

Member Function Documentation

◆ configure_stream_settings_()

◆ dump_config()

◆ loop()

◆ mic_task()

◆ set_adc_channel()

◆ set_correct_dc_offset()

◆ set_din_pin() [1/2]

◆ set_din_pin() [2/2]

◆ set_pdm()

◆ setup()

◆ start()

◆ stop()

Field Documentation

◆ active_listeners_semaphore_

◆ adc_

◆ adc_channel_

◆ correct_dc_offset_

◆ dc_offset_prev_input_

◆ dc_offset_prev_output_

◆ din_pin_ [1/2]

◆ din_pin_ [2/2]

◆ event_group_

◆ locked_driver_

◆ pdm_

◆ rx_handle_

◆ task_handle_