cs_de.h

Go to the documentation of this file.

/*
 * Copyright (c) 2025 Nordic Semiconductor ASA
 *
 * SPDX-License-Identifier: LicenseRef-Nordic-5-Clause
 */
 
#ifndef CS_DE_H__
#define CS_DE_H__
 
#include <zephyr/bluetooth/conn.h>
#include <zephyr/net_buf.h>
 
#define CS_DE_NUM_CHANNELS (75)
 
typedef struct {
        float i_local[CS_DE_NUM_CHANNELS];
        float q_local[CS_DE_NUM_CHANNELS];
        float i_remote[CS_DE_NUM_CHANNELS];
        float q_remote[CS_DE_NUM_CHANNELS];
} cs_de_iq_tones_t;
 
typedef enum {
        CS_DE_TONE_QUALITY_OK,
        CS_DE_TONE_QUALITY_BAD,
} cs_de_tone_quality_t;
 
typedef struct {
        float ifft;
        float phase_slope;
        float rtt;
        float best;
} cs_de_dist_estimates_t;
 
typedef enum {
        CS_DE_QUALITY_OK,
        CS_DE_QUALITY_DO_NOT_USE,
} cs_de_quality_t;
 
typedef struct {
        enum bt_conn_le_cs_role role;
 
        uint8_t n_ap;
 
        cs_de_iq_tones_t iq_tones[CONFIG_BT_CS_DE_MAX_NUM_ANTENNA_PATHS];
 
        cs_de_tone_quality_t tone_quality[CONFIG_BT_CS_DE_MAX_NUM_ANTENNA_PATHS];
 
        cs_de_dist_estimates_t distance_estimates[CONFIG_BT_CS_DE_MAX_NUM_ANTENNA_PATHS];
 
        int32_t rtt_accumulated_half_ns;
 
        uint8_t rtt_count;
} cs_de_report_t;
 
void cs_de_combined_iq_calculate(cs_de_iq_tones_t *cs_de_iq_tones,
                                 float iq_tones_comb[CS_DE_NUM_CHANNELS * 2]);
 
cs_de_quality_t cs_de_calc(cs_de_report_t *p_report);
 
float cs_de_ifft(float iq_tones_comb[2 * CONFIG_BT_CS_DE_NFFT_SIZE]);
 
float cs_de_rtt(int32_t rtt_accumulated_half_ns, uint8_t rtt_count);
 
float cs_de_phase_slope(float iq_tones_comb[CS_DE_NUM_CHANNELS * 2]);
 
#endif /* CS_DE_H__ */