esp_sdr_tx.h

Go to the documentation of this file.

/*
 * SPDX-License-Identifier: GPL-3.0-or-later
 */

 
#ifndef ESP_SDR_ESP_SDR_TX_H_
#define ESP_SDR_ESP_SDR_TX_H_
 
#include <stdbool.h>
#include <stddef.h>
#include <stdint.h>
 
#include <esp_sdr/esp_sdr.h>
 
#ifdef __cplusplus
extern "C" {
#endif

 
#if defined(CONFIG_SOC_SERIES_ESP32S3)
int esp_sdr_tx_set_gain(int index);

int esp_sdr_tx_get_gain(void);

int esp_sdr_tx_gain_max(void);

int esp_sdr_tx_gain_power(int index);
#endif

int esp_sdr_tx_set_lpf(int code_a, int code_b);
 
#if defined(CONFIG_SOC_SERIES_ESP32S3)
uint32_t esp_sdr_tx_rate_hz(enum esp_sdr_rate rate);
#endif

static inline uint32_t esp_sdr_tx_word(int16_t i, int16_t q)
{
        return ((uint32_t)i & 0x3ffU) | (((uint32_t)q & 0x3ffU) << 10);
}
 
#if defined(CONFIG_SOC_SERIES_ESP32S3)
int esp_sdr_tx_play(enum esp_sdr_rate rate, const uint32_t *words, size_t count);

#define ESP_SDR_TX_PLAY_MAX_MS 5000U

int esp_sdr_tx_play_for(enum esp_sdr_rate rate, const uint32_t *words, size_t count,
                        uint32_t duration_ms, uint32_t *bursts);

struct esp_sdr_tx_sweep_stats {
        uint32_t segments;
        uint32_t samples;
        uint32_t elapsed_ms;
};

int esp_sdr_tx_sweep(enum esp_sdr_rate rate, float f0_hz, float f1_hz, uint32_t duration_ms,
                     int amp, struct esp_sdr_tx_sweep_stats *stats);


int esp_sdr_tx_loop_begin(enum esp_sdr_rate rate);

uint32_t *esp_sdr_tx_loop_buf(int bank, size_t *words);

int esp_sdr_tx_loop_start(int bank, size_t count);

void esp_sdr_tx_loop_halt(void);

void esp_sdr_tx_loop_end(void);

#endif /* CONFIG_SOC_SERIES_ESP32S3 */

struct esp_sdr_tx_backend {
        const char *name;
        int (*start)(uint64_t freq_hz, uint32_t rate_hz);
        int (*write)(const struct esp_sdr_iq16 *samples, size_t count);
        int (*stop)(void);
};

struct esp_sdr_tx_stats {
        uint64_t samples;
        uint32_t writes;
        uint32_t errors;
};
 
#if defined(CONFIG_ESP_SDR_TX)
int esp_sdr_tx_set_backend(const struct esp_sdr_tx_backend *backend);

const struct esp_sdr_tx_backend *esp_sdr_tx_get_backend(void);

int esp_sdr_tx_start(uint64_t freq_hz, uint32_t rate_hz);

int esp_sdr_tx_write(const struct esp_sdr_iq16 *samples, size_t count);

int esp_sdr_tx_stop(void);

bool esp_sdr_tx_active(void);

void esp_sdr_tx_get_stats(struct esp_sdr_tx_stats *stats);

extern const struct esp_sdr_tx_backend esp_sdr_tx_stub_backend;
#endif /* CONFIG_ESP_SDR_TX */

struct esp_sdr_tx_dac_stats {
        uint64_t played, dropped;
        uint32_t underruns, overruns;
        uint32_t switches, errors;
        uint32_t interp, elapsed_us;
        uint32_t fill_us[2], fill_blocks[2], fill_cpu[2];
        bool simd;
        uint32_t switch_us_sum, switch_us_max;
        int32_t slack_us_min;
        uint32_t restarts;
        uint32_t fill_us_max, wake_late_us_max, idle_us_max;
        int32_t start_margin_us;
};
 
#if defined(CONFIG_ESP_SDR_TX_DAC)
extern const struct esp_sdr_tx_backend esp_sdr_tx_dac_backend;

void esp_sdr_tx_dac_get_stats(struct esp_sdr_tx_dac_stats *stats);

typedef void (*esp_sdr_tx_dac_gen_t)(void *user, uint32_t *dst, uint64_t index, uint32_t n);

int esp_sdr_tx_dac_play_gen(esp_sdr_tx_dac_gen_t gen, void *user, uint64_t samples);

uint32_t esp_sdr_tx_dac_queued(void);
#endif

 
#ifdef __cplusplus
}
#endif
 
#endif /* ESP_SDR_ESP_SDR_TX_H_ */