ieee154_esp_sdr.h

Go to the documentation of this file.

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

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


struct ieee154_esp_sdr_stats {
        uint32_t captures, capture_errors;
        uint32_t frames, frames_dropped;
        uint32_t tx_frames, tx_errors;
        uint32_t acks, no_acks;
        int32_t tx_last_err;
        uint32_t filter_us, phy_us;
        uint32_t ring_status, ring_units, ring_lost, phy_skipped, phy_read;
        uint32_t ring_cycles_x100, ring_slice_max, ring_abandoned;
        uint32_t ring_irq_windows, ring_irq_lines;
        uint32_t ring_late_max;
        uint32_t verdict_n, verdict_min_us, verdict_max_us, verdict_sum_us;
        uint32_t ack_due, ack_arm_failed, ack_fired, ack_fire_failed, ack_cancelled;
        uint32_t ack_unsupported;
        uint32_t ack_verdict_max_us, ack_verdict_sum_us, ack_verdict_late, ack_lag_max_us;
};
 
struct net_pkt;

typedef void (*ieee154_esp_sdr_rx_cb_t)(struct net_pkt *pkt);

void ieee154_esp_sdr_set_rx_cb(ieee154_esp_sdr_rx_cb_t cb);

void ieee154_esp_sdr_set_invert(bool rx_inv, bool tx_inv);

int ieee154_esp_sdr_set_lo_above(bool above);

struct ieee154_esp_sdr_measurement {
        int32_t cfo_hz;
        int32_t coarse_cfo_hz;
        int32_t power_dbfs;
        uint32_t samples_used;
        uint32_t steps[8];
};

int ieee154_esp_sdr_measure(struct ieee154_esp_sdr_measurement *m);

int ieee154_esp_sdr_set_rx_gain(int index);

typedef void (*ieee154_esp_sdr_dump_cb_t)(const int16_t *iq, size_t n, void *user);

int ieee154_esp_sdr_dump(ieee154_esp_sdr_dump_cb_t out, void *user);

enum ieee154_esp_sdr_event {
        IEEE154_ESP_SDR_EV_TAKE = 1, /* radio taken, argument: waiters before */
        IEEE154_ESP_SDR_EV_GIVE,     /* radio released */
        IEEE154_ESP_SDR_EV_RING,     /* ring run starts */
        IEEE154_ESP_SDR_EV_RING_END, /* ring run ended, argument: status */
        IEEE154_ESP_SDR_EV_TX,       /* transmission starts, argument: PSDU length */
        IEEE154_ESP_SDR_EV_TX_END,   /* transmission ended, argument: -error */
        IEEE154_ESP_SDR_EV_CAPTURE,  /* bank capture (ACK window, measure, dump, burst receive) */
        IEEE154_ESP_SDR_EV_BOOT,     /* driver init */
};

size_t ieee154_esp_sdr_get_trail(uint32_t *out, size_t max);

size_t ieee154_esp_sdr_get_stall(uint32_t *pc, uint32_t *ls, size_t max);

void ieee154_esp_sdr_get_stats(struct ieee154_esp_sdr_stats *stats);
 
struct ieee154_esp_sdr_bench {
        uint32_t ack_build_cyc, ack_gen_cyc, ack_tail_cyc, ack_words;
        uint32_t to_tx_us, to_rx_us;
};

int ieee154_esp_sdr_bench(struct ieee154_esp_sdr_bench *b);

int ieee154_esp_sdr_set_ack_timing(uint32_t delay_us, uint32_t limit_us);

int ieee154_esp_sdr_ack_test(uint8_t seq);

void ieee154_esp_sdr_clear_stats(void);

int ieee154_esp_sdr_set_ring_unit(uint32_t pairs);

void *ieee154_esp_sdr_high_ram(size_t size);

 
#ifdef __cplusplus
}
#endif
 
#endif /* ESP_SDR_IEEE154_ESP_SDR_H_ */