ad9361_ext_band_ctrl.h

Go to the documentation of this file.

/*
 * Copyright (c) 2025-2026 Analog Devices, Inc.
 *
 * SPDX-License-Identifier: BSD-3-Clause
 */
 
#ifndef AD9361_EXT_BAND_CTRL_H_
#define AD9361_EXT_BAND_CTRL_H_
 
#include <stdint.h>
#include <stdbool.h>
#include "no_os_gpio.h"
 
/* Forward declaration — full definition in ad9361.h */
struct ad9361_rf_phy;
 
/* Constants */

#define AD9361_EXT_BAND_MAX_GPIOS   32

#define AD9361_EXT_BAND_MAX_SETTINGS 64

#define AD9361_EXT_BAND_NO_PORT_SEL  ((uint32_t)-1)
 
/* GPIO operation codes */

enum ad9361_ext_band_ctl_op {
    AD9361_EXT_BAND_CTL_OP_LOW   = 0,
    AD9361_EXT_BAND_CTL_OP_HIGH  = 1,
    AD9361_EXT_BAND_CTL_OP_INPUT = 2,
    AD9361_EXT_BAND_CTL_OP_NOP   = 3,
};
 
/* Band setting descriptor */

struct ad9361_band_setting {
    const char *name;

    uint64_t freq_min;
    uint64_t freq_max;

    uint32_t *gpio_values;
    uint32_t  ngpios;

    uint32_t rf_rx_input_sel;

    uint32_t rf_tx_output_sel;

    uint32_t delay_us;

    struct ad9361_band_setting *pre_seq;
    uint32_t pre_seq_len;

    struct ad9361_band_setting *post_seq;
    uint32_t post_seq_len;
};
 
/* Controller descriptor */

struct ad9361_ext_band_ctl {
    struct no_os_gpio_desc *gpios[AD9361_EXT_BAND_MAX_GPIOS];
    int ngpios;

    struct ad9361_band_setting **rx_settings;
    uint32_t rx_count;

    struct ad9361_band_setting **tx_settings;
    uint32_t tx_count;

    struct ad9361_band_setting *current_rx_setting;
    struct ad9361_band_setting *current_tx_setting;
};
 
 
struct ad9361_band_setting *
ad9361_band_setting_alloc(const char *name, uint64_t freq_min,
              uint64_t freq_max, uint32_t ngpios);
 
void ad9361_band_setting_free(struct ad9361_band_setting *s);
 
int  ad9361_band_setting_set_gpio(struct ad9361_band_setting *s,
                  uint32_t gpio_idx, uint32_t op);
 
void ad9361_band_setting_set_rx_port(struct ad9361_band_setting *s,
                     uint32_t port);
 
void ad9361_band_setting_set_tx_port(struct ad9361_band_setting *s,
                     uint32_t port);
 
void ad9361_band_setting_set_delay(struct ad9361_band_setting *s,
                   uint32_t delay_us);
 
struct ad9361_ext_band_ctl *ad9361_ext_band_ctl_alloc(void);
void ad9361_ext_band_ctl_free(struct ad9361_ext_band_ctl *ctl);
 
int ad9361_ext_band_ctl_add_gpio(struct ad9361_ext_band_ctl *ctl,
                 struct no_os_gpio_desc *gpio);
 
int ad9361_ext_band_ctl_add_rx_setting(struct ad9361_ext_band_ctl *ctl,
                       struct ad9361_band_setting *s);
 
int ad9361_ext_band_ctl_add_tx_setting(struct ad9361_ext_band_ctl *ctl,
                       struct ad9361_band_setting *s);
 
 
int32_t ad9361_register_ext_band_control(struct ad9361_rf_phy *phy,
        struct ad9361_ext_band_ctl *ctl);
 
void ad9361_unregister_ext_band_control(struct ad9361_rf_phy *phy);
 
int32_t ad9361_adjust_rx_ext_band_settings(struct ad9361_rf_phy *phy,
        uint64_t freq);
 
int32_t ad9361_adjust_tx_ext_band_settings(struct ad9361_rf_phy *phy,
        uint64_t freq);
 
#endif /* AD9361_EXT_BAND_CTRL_H_ */