esp_sdr_rx.h

Go to the documentation of this file.

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

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


#define ESP_SDR_RX_GAIN_AUTO (-1)

#define ESP_SDR_RX_LPF_AUTO (-1)
#define ESP_SDR_RX_LPF_MAX  63

#define ESP_SDR_RX_DECIM_MIN 2U
#define ESP_SDR_RX_DECIM_MAX 160U

#define ESP_SDR_RX_FOLD_MIN 2U
#define ESP_SDR_RX_FOLD_MAX 160U

struct esp_sdr_rx_burst {
        uint32_t *words;
        size_t count;
        uint32_t elapsed_us;
};

int esp_sdr_rx_set_gain(int index);

int esp_sdr_rx_get_gain(void);

int esp_sdr_rx_gain_max(void);

int esp_sdr_rx_set_bandwidth(uint32_t mhz);

void esp_sdr_rx_bandwidth_range(uint32_t *min, uint32_t *max);

int esp_sdr_rx_set_lpf(int code);

int esp_sdr_rx_get_lpf(void);

int esp_sdr_rx_capture(enum esp_sdr_rate rate, size_t count, struct esp_sdr_rx_burst *burst);

int esp_sdr_rx_capture_iq(enum esp_sdr_rate rate, size_t count, struct esp_sdr_iq16 *out,
                          uint64_t *first_ns);

int esp_sdr_rx_capture_bank(enum esp_sdr_rate rate, size_t count, int bank,
                            struct esp_sdr_rx_burst *burst);

int esp_sdr_rx_capture_decimated(enum esp_sdr_rate rate, size_t count, unsigned int m,
                                 struct esp_sdr_iq16 *out, size_t max_out, size_t *n_out,
                                 uint64_t *first_ns);

int esp_sdr_rx_capture_folded(enum esp_sdr_rate rate, size_t count, unsigned int n,
                              struct esp_sdr_iq16 *out, size_t max_out, size_t *n_out,
                              uint64_t *first_ns);

uint32_t esp_sdr_rx_rate_hz(enum esp_sdr_rate rate);
 
/*
 * Receive words carry Q in the low field: with I low, a tone below the LO
 * showed up above it (checked by detuning the receiver against a known
 * carrier). Transmit words are the other way round, see esp_sdr_tx_word().
 */

static inline int16_t esp_sdr_rx_i(uint32_t word)
{
        return (int16_t)((int32_t)(word << 12) >> 22);
}

static inline int16_t esp_sdr_rx_q(uint32_t word)
{
        return (int16_t)((int32_t)(word << 22) >> 22);
}

size_t esp_sdr_rx_pack_iq8(const uint32_t *words, size_t count, uint8_t *out);

size_t esp_sdr_rx_pack_iq10(const uint32_t *words, size_t count, uint8_t *out);

 
#ifdef __cplusplus
}
#endif
 
#endif /* ESP_SDR_ESP_SDR_RX_H_ */