/* * Copyright 2023 jacqueline * * SPDX-License-Identifier: GPL-3.0-only */ #include "i2s_dac.hpp" #include #include #include "assert.h" #include "driver/i2c.h" #include "driver/i2s_common.h" #include "driver/i2s_std.h" #include "esp_attr.h" #include "esp_err.h" #include "esp_log.h" #include "freertos/portmacro.h" #include "freertos/projdefs.h" #include "hal/gpio_types.h" #include "hal/i2c_types.h" #include "gpios.hpp" #include "hal/i2s_types.h" #include "i2c.hpp" #include "soc/clk_tree_defs.h" #include "sys/_stdint.h" namespace drivers { static const char* kTag = "i2s_dac"; static const i2s_port_t kI2SPort = I2S_NUM_0; auto I2SDac::create(IGpios* expander) -> std::optional { i2s_chan_handle_t i2s_handle; i2s_chan_config_t channel_config = I2S_CHANNEL_DEFAULT_CONFIG(kI2SPort, I2S_ROLE_MASTER); // Use the maximum possible DMA buffer size, since a smaller number of large // copies is faster than a large number of small copies. channel_config.dma_frame_num = 1024; // Triple buffering should be enough to keep samples flowing smoothly. // TODO(jacqueline): verify this with 192kHz 32bps. channel_config.dma_desc_num = 4; // channel_config.auto_clear = true; ESP_ERROR_CHECK(i2s_new_channel(&channel_config, &i2s_handle, NULL)); // // First, instantiate the instance so it can do all of its power on // configuration. std::unique_ptr dac = std::make_unique(expander, i2s_handle); // Whilst we wait for the initial boot, we can work on installing the I2S // driver. i2s_std_config_t i2s_config = { .clk_cfg = dac->clock_config_, .slot_cfg = dac->slot_config_, .gpio_cfg = {.mclk = GPIO_NUM_0, .bclk = GPIO_NUM_26, .ws = GPIO_NUM_27, .dout = GPIO_NUM_5, .din = I2S_GPIO_UNUSED, .invert_flags = { .mclk_inv = false, .bclk_inv = false, .ws_inv = true, }}, }; if (esp_err_t err = i2s_channel_init_std_mode(i2s_handle, &i2s_config) != ESP_OK) { ESP_LOGE(kTag, "failed to initialise i2s channel %x", err); return {}; } return dac.release(); } I2SDac::I2SDac(IGpios* gpio, i2s_chan_handle_t i2s_handle) : gpio_(gpio), i2s_handle_(i2s_handle), i2s_active_(false), active_page_(), clock_config_(I2S_STD_CLK_DEFAULT_CONFIG(44100)), slot_config_(I2S_STD_MSB_SLOT_DEFAULT_CONFIG(I2S_DATA_BIT_WIDTH_16BIT, I2S_SLOT_MODE_STEREO)) { clock_config_.clk_src = I2S_CLK_SRC_PLL_160M; gpio_->WriteSync(IGpios::Pin::kAmplifierEnable, false); } I2SDac::~I2SDac() { Stop(); i2s_del_channel(i2s_handle_); } auto I2SDac::Start() -> void { gpio_->WriteSync(IGpios::Pin::kAmplifierEnable, true); vTaskDelay(pdMS_TO_TICKS(1)); i2s_channel_enable(i2s_handle_); i2s_active_ = true; } auto I2SDac::Stop() -> void { i2s_channel_disable(i2s_handle_); vTaskDelay(pdMS_TO_TICKS(1)); gpio_->WriteSync(IGpios::Pin::kAmplifierEnable, false); i2s_active_ = false; } auto I2SDac::Reconfigure(Channels ch, BitsPerSample bps, SampleRate rate) -> void { if (i2s_active_) { i2s_channel_disable(i2s_handle_); } switch (ch) { case CHANNELS_MONO: slot_config_.slot_mode = I2S_SLOT_MODE_MONO; break; case CHANNELS_STEREO: slot_config_.slot_mode = I2S_SLOT_MODE_STEREO; break; } switch (bps) { case BPS_16: slot_config_.data_bit_width = I2S_DATA_BIT_WIDTH_16BIT; break; case BPS_24: slot_config_.data_bit_width = I2S_DATA_BIT_WIDTH_24BIT; break; case BPS_32: slot_config_.data_bit_width = I2S_DATA_BIT_WIDTH_32BIT; break; } ESP_ERROR_CHECK(i2s_channel_reconfig_std_slot(i2s_handle_, &slot_config_)); clock_config_.sample_rate_hz = rate; // If we have an MCLK/SCK, then it must be a multiple of both the sample rate // and the bit clock. At 24 BPS, we therefore have to change the MCLK multiple // to avoid issues at some sample rates. (e.g. 48KHz) clock_config_.mclk_multiple = bps == BPS_24 ? I2S_MCLK_MULTIPLE_384 : I2S_MCLK_MULTIPLE_256; ESP_ERROR_CHECK(i2s_channel_reconfig_std_clock(i2s_handle_, &clock_config_)); if (i2s_active_) { i2s_channel_enable(i2s_handle_); } } auto I2SDac::WriteData(const cpp::span& data) -> void { std::size_t bytes_written = 0; esp_err_t err = i2s_channel_write(i2s_handle_, data.data(), data.size_bytes(), &bytes_written, portMAX_DELAY); if (err != ESP_ERR_TIMEOUT) { ESP_ERROR_CHECK(err); } } extern "C" IRAM_ATTR auto callback(i2s_chan_handle_t handle, i2s_event_data_t* event, void* user_ctx) -> bool { if (event == nullptr || user_ctx == nullptr) { return false; } if (event->data == nullptr || event->size == 0) { return false; } uint8_t** buf = reinterpret_cast(event->data); StreamBufferHandle_t src = reinterpret_cast(user_ctx); BaseType_t ret = false; std::size_t bytes_received = xStreamBufferReceiveFromISR(src, *buf, event->size, &ret); if (bytes_received < event->size) { memset(*buf + bytes_received, 0, event->size - bytes_received); } return ret; } auto I2SDac::SetSource(StreamBufferHandle_t buffer) -> void { if (i2s_active_) { ESP_ERROR_CHECK(i2s_channel_disable(i2s_handle_)); } i2s_event_callbacks_t callbacks{ .on_recv = NULL, .on_recv_q_ovf = NULL, .on_sent = NULL, .on_send_q_ovf = NULL, }; if (buffer != nullptr) { callbacks.on_sent = &callback; } i2s_channel_register_event_callback(i2s_handle_, &callbacks, buffer); if (i2s_active_) { ESP_ERROR_CHECK(i2s_channel_enable(i2s_handle_)); } } } // namespace drivers