ESPHome 2026.11.0-dev
Loading...
Searching...
No Matches
resampler_speaker.h
Go to the documentation of this file.
1#pragma once
2
3#ifdef USE_ESP32
4
9
12
13#include <freertos/event_groups.h>
14
15namespace esphome::resampler {
16
17class ResamplerSpeaker final : public Component, public speaker::Speaker {
18 public:
19 void dump_config() override;
20 void setup() override;
21 void loop() override;
22
23 size_t play(const uint8_t *data, size_t length, TickType_t ticks_to_wait) override;
24 size_t play(const uint8_t *data, size_t length) override { return this->play(data, length, 0); }
25
26 void start() override;
27 void stop() override;
28 void finish() override;
29
30 void set_pause_state(bool pause_state) override { this->output_speaker_->set_pause_state(pause_state); }
31 bool get_pause_state() const override { return this->output_speaker_->get_pause_state(); }
32
33 bool has_buffered_data() const override;
34
36 void set_mute_state(bool mute_state) override;
37 bool get_mute_state() override { return this->output_speaker_->get_mute_state(); }
38
40 void set_volume(float volume) override;
41 float get_volume() override { return this->output_speaker_->get_volume(); }
42
43 void set_output_speaker(speaker::Speaker *speaker) { this->output_speaker_ = speaker; }
44 void set_task_stack_in_psram(bool task_stack_in_psram) { this->task_stack_in_psram_ = task_stack_in_psram; }
45
46 void set_target_bits_per_sample(uint8_t target_bits_per_sample) {
47 this->target_bits_per_sample_ = target_bits_per_sample;
48 }
49 void set_target_sample_rate(uint32_t target_sample_rate) { this->target_sample_rate_ = target_sample_rate; }
50
53 void set_passthrough_bits_per_sample(bool passthrough_bits_per_sample) {
54 this->passthrough_bits_per_sample_ = passthrough_bits_per_sample;
55 }
56
57 void set_filters(uint16_t filters) { this->filters_ = filters; }
58 void set_taps(uint16_t taps) { this->taps_ = taps; }
59
60 void set_buffer_duration(uint32_t buffer_duration_ms) { this->buffer_duration_ms_ = buffer_duration_ms; }
61
62 protected:
67 esp_err_t start_();
68
72
74 void set_start_error_(esp_err_t err);
75
77 void send_command_(uint32_t command_bit, bool wake_loop = false);
78
79 inline bool requires_resampling_() const;
80 static void resample_task(void *params);
81
82 EventGroupHandle_t event_group_{nullptr};
83
84 std::weak_ptr<ring_buffer::RingBuffer> ring_buffer_;
85
87
89
91
93
97
98 uint16_t taps_;
99 uint16_t filters_;
100
102
106};
107
108} // namespace esphome::resampler
109
110#endif
Helper for FreeRTOS static task management.
Definition static_task.h:18
void set_start_error_(esp_err_t err)
Sets the appropriate status error based on the start failure reason.
void set_volume(float volume) override
Volume state changes are passed to the parent's output speaker.
void set_target_sample_rate(uint32_t target_sample_rate)
void set_pause_state(bool pause_state) override
void set_target_bits_per_sample(uint8_t target_bits_per_sample)
size_t play(const uint8_t *data, size_t length) override
audio::AudioStreamInfo target_stream_info_
void set_output_speaker(speaker::Speaker *speaker)
void set_buffer_duration(uint32_t buffer_duration_ms)
esp_err_t start_()
Starts the output speaker after setting the resampled stream info.
size_t play(const uint8_t *data, size_t length, TickType_t ticks_to_wait) override
void set_task_stack_in_psram(bool task_stack_in_psram)
void enter_stopping_state_()
Transitions to STATE_STOPPING, records the stopping timestamp, sends the task stop command if the tas...
std::weak_ptr< ring_buffer::RingBuffer > ring_buffer_
void send_command_(uint32_t command_bit, bool wake_loop=false)
Sends a command via event group bits, enables the loop, and optionally wakes the main loop.
void set_passthrough_bits_per_sample(bool passthrough_bits_per_sample)
When enabled, the input bits per sample are passed through to the output speaker unchanged instead of...
void set_mute_state(bool mute_state) override
Mute state changes are passed to the parent's output speaker.
virtual float get_volume()
Definition speaker.h:83
virtual bool get_pause_state() const
Definition speaker.h:64
virtual void set_pause_state(bool pause_state)
Definition speaker.h:63
virtual bool get_mute_state()
Definition speaker.h:91
static void uint32_t