esp_sdr_diag.h

Go to the documentation of this file.

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

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


#define ESP_SDR_DIAG_PINS 8U

#define ESP_SDR_DIAG_BLOCK 8192U

#define ESP_SDR_DIAG_RING 57344U

#define ESP_SDR_DIAG_LSB_AUTO 0xffU

#define ESP_SDR_DIAG_LSB_MAX 6U

typedef void (*esp_sdr_diag_sink_t)(void *user, const uint8_t *blk, size_t n, uint64_t index);

typedef void (*esp_sdr_diag_iq_sink_t)(void *user, const int32_t *iq, size_t n, uint64_t index);

#define ESP_SDR_DIAG_DECIM_MIN 8U
#define ESP_SDR_DIAG_DECIM_MAX 255U
 
struct esp_sdr_diag_cfg {
        const int8_t *pins;
        uint8_t lsb;
        uint8_t clk_div;
        bool falling_edge;
        uint32_t seconds;
        esp_sdr_diag_sink_t sink;
        void *user;
        uint8_t decim;
        esp_sdr_diag_iq_sink_t iq_sink;
        void *iq_user;
};
 
struct esp_sdr_diag_stats {
        uint64_t bytes;
        uint64_t consumed;
        uint32_t skips;
        uint32_t skipped_blocks;
        bool overrun;
        int32_t ppm_x100;
        uint8_t lsb;
        uint32_t sink_cycles_x100;
        uint32_t byte_rate;
        uint32_t iq_rate;
        uint32_t isrs, dma_raw, dw0[4];
};

int esp_sdr_diag_run(const struct esp_sdr_diag_cfg *cfg, struct esp_sdr_diag_stats *stats);

void esp_sdr_diag_stop(void);

bool esp_sdr_diag_active(void);

int esp_sdr_diag_level(uint8_t *lsb);

void esp_sdr_diag_armed_hook(void);

 
#ifdef __cplusplus
}
#endif
 
#endif /* ESP_SDR_ESP_SDR_DIAG_H_ */