Settings.cpp

//==============================================================================
//  SDR plugin wrapper for Fobos SDR API
//  V.T.
//  LGPL-2.1 or above LICENSE
//  05.06.2024
//  10.11.2025 - open by index support
//  15.01.2026 - open by serial, specify clock_source by @oleksandrchumakovpaysera 
//  01.04.2026 - added support for fobos-sdr-agile
//==============================================================================

#include "SoapyFobosSDR.hpp"
#include <SoapySDR/Time.hpp>
#include <algorithm>
#include <cstring>

SoapyFobosSDR::SoapyFobosSDR(const SoapySDR::Kwargs &args):
    _device_index(0),
    _dev_stock(nullptr),
    _dev_agile(nullptr), 
    _sample_rate(25000000.0),
    _center_frequency(100000000.0),
    _direct_sampling(0),
    _clock_source(0),
    _lna_gain(0),
    _lna_gain_scale(1.0 / 16.0),
    _vga_gain(0),
    _vga_gain_scale(1.0 / 2.0),
    _rx_bufs(0),
    _rx_buffs_count(DEFAULT_BUFS_COUNT),
    _rx_buff_len(DEFAULT_BUFF_LEN),
    _rx_filled(0)
{
#ifdef SOAPY_FOBOS_PRINT_DEBUG  
    printf(">>> %s::%s()\n", __CLASS__, __FUNCTION__);
    for (auto & arg : args)
    {
        printf("args[]: %s = %s\n", arg.first.c_str(), arg.second.c_str());
    }
#endif    
    _lna_gain_scale = 1.0 / 16.0;
    _vga_gain_scale = 1.0 / 2.0;

    int result = 0;
    int count_stock = 0;
    int count_agile = 0;
    char serials[256] = {0};

    fobos_rx_get_api_info(lib_stock_version, drv_stock_version);
    printf("API Info lib (stock): %s drv: %s\n", lib_stock_version, drv_stock_version); 
    fobos_sdr_get_api_info(lib_agile_version, drv_agile_version);
    printf("         lib (agile): %s drv: %s\n", lib_agile_version, drv_agile_version); 

    if (args.count("label") != 0)
    {
        SoapySDR_logf(SOAPY_SDR_INFO, "Opening %s...", args.at("label").c_str());
    }

    if (args.count("serial") != 0)
    {
        // Find device by serial number
        count_stock = fobos_rx_list_devices(serials);
        count_agile = fobos_sdr_list_devices(serials);
        if (count_stock + count_agile > 0)
        {
            char serials_copy[256];
            strncpy(serials_copy, serials, sizeof(serials_copy) - 1);
            serials_copy[sizeof(serials_copy) - 1] = '\0';
            
            char* pserial = strtok(serials_copy, " ");
            int found_index = -1;
            
            // Search for device with specified serial number
            for (int idx = 0; idx < count_stock + count_agile; idx++)
            {
                if (pserial && args.at("serial") == std::string(pserial))
                {
                    found_index = idx;
                    SoapySDR_logf(SOAPY_SDR_INFO, 
                        "Found device with serial '%s' at index %d", 
                        pserial, idx);
                    break;
                }
                pserial = strtok(nullptr, " ");
            }
            
            if (found_index >= 0)
            {
                _device_index = found_index;
            }
            else
            {
                SoapySDR_logf(SOAPY_SDR_ERROR, 
                    "Device with serial '%s' not found. Available devices: %s", 
                    args.at("serial").c_str(), serials);
            }
        }
        else
        {
            SoapySDR_logf(SOAPY_SDR_ERROR, "No Fobos devices found");
        }
    } 
    else
    {
        // Use index if serial not specified
        count_stock = fobos_rx_list_devices(0);
        const auto it = args.find("index");
        if (it != args.end())
        {
            _device_index = std::stoi(it->second);
        }
    }
    SoapySDR_logf(SOAPY_SDR_DEBUG, "opening device #%d", _device_index);

    if (_device_index < count_stock)
    {
        result = fobos_rx_open(&_dev_stock, _device_index);
        if (result != 0) 
        {
            throw std::runtime_error("Unable to open Fobos SDR device");
        }
        result = fobos_rx_get_board_info(_dev_stock, hw_revision, fw_version, manufacturer, product, serial);       
        if (result != 0) 
        {
            SoapySDR_logf(SOAPY_SDR_ERROR, "Unable to obtain devoce info");
        }
    }
    else
    {
        result = fobos_sdr_open(&_dev_agile, _device_index);
        if (result != 0) 
        {
            throw std::runtime_error("Unable to open Fobos SDR device");
        }
        result = fobos_sdr_get_board_info(_dev_agile, hw_revision, fw_version, manufacturer, product, serial);       
        if (result != 0) 
        {
            SoapySDR_logf(SOAPY_SDR_ERROR, "Unable to obtain devoce info");
        }
    }
}

SoapyFobosSDR::~SoapyFobosSDR(void)
{
#ifdef SOAPY_FOBOS_PRINT_DEBUG  
    printf(">>> %s::%s()\n", __CLASS__, __FUNCTION__);
#endif
    if (_dev_stock)
    {
        fobos_rx_close(_dev_stock);
    }
    if (_dev_agile)
    {
        fobos_sdr_close(_dev_agile);
    }
}

/*******************************************************************
 * Identification API
 ******************************************************************/

std::string SoapyFobosSDR::getDriverKey(void) const
{
    return "FobosSDR";
}

std::string SoapyFobosSDR::getHardwareKey(void) const
{
    return std::string(hw_revision);
}

SoapySDR::Kwargs SoapyFobosSDR::getHardwareInfo(void) const
{
    SoapySDR::Kwargs args;
    args["lib_stock_version"] = std::string(lib_stock_version);
    args["lib_agile_version"] = std::string(lib_agile_version);
    args["drv_stock_version"] = std::string(drv_stock_version);
    args["drv_agile_version"] = std::string(drv_agile_version);
    args["hw_revision"] = std::string(hw_revision);
    args["fw_version"] = std::string(fw_version);
    args["manufacturer"] = std::string(manufacturer);
    if (_dev_stock)
    {
        args["product"] = std::string(product);
    }
    else if (_dev_agile)
    {
        args["product"] = std::string(product) + " (agile)";
    }
    args["serial"] = std::string(serial);
    args["index"] = std::to_string(_device_index);
    return args;
}

/*******************************************************************
 * Channels API
 ******************************************************************/

size_t SoapyFobosSDR::getNumChannels(const int dir) const
{
    return (dir == SOAPY_SDR_RX) ? 1 : 0;
}

bool SoapyFobosSDR::getFullDuplex(const int direction, const size_t channel) const
{
    (void)direction;
    (void)channel;
    return false;
}

/*******************************************************************
 * Antenna API
 ******************************************************************/

std::vector<std::string> SoapyFobosSDR::listAntennas(const int direction, const size_t channel) const
{
#ifdef SOAPY_FOBOS_PRINT_DEBUG  
    printf(">>> %s::%s(%d, %d)\n", __CLASS__, __FUNCTION__, direction, (int)channel);
#endif      
    std::vector<std::string> antennas;
    if ((direction == SOAPY_SDR_RX) && (channel == 0))
    {
        antennas.push_back("RX");
    }
    return antennas;
}

void SoapyFobosSDR::setAntenna(const int direction, const size_t channel, const std::string &name)
{
#ifdef SOAPY_FOBOS_PRINT_DEBUG  
    printf(">>> %s::%s(%d, %d, %s)\n", __CLASS__, __FUNCTION__, direction, (int)channel, name.c_str());
#endif   
    if ((direction == SOAPY_SDR_RX) && (channel == 0) && (name == "RX"))
    {
    }
    else
    {
        throw std::runtime_error("setAntena() not supported");
    }
}

std::string SoapyFobosSDR::getAntenna(const int direction, const size_t channel) const
{
#ifdef SOAPY_FOBOS_PRINT_DEBUG  
    printf(">>> %s::%s(%d, %d)\n", __CLASS__, __FUNCTION__, direction, (int)channel);
#endif   
    if ((direction == SOAPY_SDR_RX) && (channel == 0))
    {
        return "RX";
    }    
    return "";
}

/*******************************************************************
 * Frontend corrections API
 ******************************************************************/

bool SoapyFobosSDR::hasDCOffsetMode(const int direction, const size_t channel) const
{
    (void)direction;
    (void)channel;
    return false;
}

bool SoapyFobosSDR::hasFrequencyCorrection(const int direction, const size_t channel) const
{
    (void)direction;
    (void)channel;
    return false;
}

/*******************************************************************
 * Gain API
 ******************************************************************/

std::vector<std::string> SoapyFobosSDR::listGains(const int direction, const size_t channel) const
{
#ifdef SOAPY_FOBOS_PRINT_DEBUG  
    printf(">>> %s::%s(%d, %d)\n", __CLASS__, __FUNCTION__, direction, (int)channel);
#endif  
    std::vector<std::string> results;
    if ((direction == SOAPY_SDR_RX) && (channel == 0))
    {    
        results.push_back("LNA");
        results.push_back("VGA");
    }
    return results;
}

bool SoapyFobosSDR::hasGainMode(const int direction, const size_t channel) const
{
    (void)direction;
    (void)channel;
    return false;
}

void SoapyFobosSDR::setGain(const int direction, const size_t channel, const double value)
{
#ifdef SOAPY_FOBOS_PRINT_DEBUG  
    printf(">>> %s::%s(%d, %d, %f)\n", __CLASS__, __FUNCTION__, direction, (int)channel, value);
#endif  
    //set the overall gain by distributing it across available gain elements
    //OR delete this function to use SoapySDR's default gain distribution algorithm...
    if ((direction == SOAPY_SDR_RX) && (channel == 0))
    {
        SoapySDR::Device::setGain(direction, channel, value);
    }
}

void SoapyFobosSDR::setGain(const int direction, const size_t channel, const std::string &name, const double value)
{
#ifdef SOAPY_FOBOS_PRINT_DEBUG  
    printf(">>> %s::%s(%d, %d, %s, %f)\n", __CLASS__, __FUNCTION__, direction, (int)channel, name.c_str(),  value);
#endif    
    if ((direction == SOAPY_SDR_RX) && (channel == 0))
    {
        if (name == "LNA")
        {
            this->_lna_gain = value;
            unsigned int idx = (round(value * _lna_gain_scale)) + 1;
            if (_dev_stock)
            {
                fobos_rx_set_lna_gain(_dev_stock, idx);
            }
            else if (_dev_agile)
            {
                fobos_sdr_set_lna_gain(_dev_agile, idx);
            }
        }
        else if (name == "VGA")
        {
            this->_vga_gain = value;
            unsigned int idx = uint8_t(round(value * _vga_gain_scale));
            if (_dev_stock)
            {
                fobos_rx_set_vga_gain(_dev_stock, idx);
            }
            else if (_dev_agile)
            {
                fobos_sdr_set_vga_gain(_dev_agile, idx);
            }
        }
    }
}

double SoapyFobosSDR::getGain(const int direction, const size_t channel, const std::string &name) const
{
#ifdef SOAPY_FOBOS_PRINT_DEBUG  
    printf(">>> %s::%s(%d, %d)\n", __CLASS__, __FUNCTION__, direction, (int)channel);

#endif  
    if ((direction == SOAPY_SDR_RX) && (channel == 0))
    {
        if (name == "LNA")
        {
            return this->_lna_gain;
        }
        if (name == "VGA")
        {
            return this->_vga_gain;
        }
    }
    return 0.0;
}

SoapySDR::Range SoapyFobosSDR::getGainRange(const int direction, const size_t channel, const std::string &name) const
{
#ifdef SOAPY_FOBOS_PRINT_DEBUG  
    printf(">>> %s::%s(%d, %d, %s)\n", __CLASS__, __FUNCTION__, direction, (int)channel, name.c_str());
#endif  
    if ((direction == SOAPY_SDR_RX) && (channel == 0))
    {
        if (name == "LNA")
        {
            return SoapySDR::Range(0.0, 33.0);
        }
        if (name == "VGA")
        {
            return SoapySDR::Range(0.0, 30.0);
        }
    }
    return SoapySDR::Range(0, 0);
}
/******************************************************************************/
/******************************************************************************
 * Frequency API
 ******************************************************************************/
/******************************************************************************/
void SoapyFobosSDR::setFrequency(
        const int direction,
        const size_t channel,
        const std::string &name,
        const double frequency,
        const SoapySDR::Kwargs &args)
{
#ifdef SOAPY_FOBOS_PRINT_DEBUG  
    printf(">>> %s::%s(%d, %d, %s, %f)\n", __CLASS__, __FUNCTION__, direction, (int)channel, name.c_str(),  frequency);
#endif  
    (void)args;
    double actual;
    int r = -1;
    if ((direction == SOAPY_SDR_RX) && (channel == 0) && (name == "RF"))
    {
        SoapySDR_logf(SOAPY_SDR_DEBUG, "Setting center freq: %f", frequency);
        if (_dev_stock)
        {
            r = fobos_rx_set_frequency(_dev_stock, frequency, &actual);
            _center_frequency = actual;
        }
        else if (_dev_agile)
        {
            r = fobos_sdr_set_frequency(_dev_agile, frequency);
            _center_frequency = frequency;
        }
        if (r != 0)
        {
            throw std::runtime_error("setFrequency failed");
        }
    }
}
/******************************************************************************/
double SoapyFobosSDR::getFrequency(const int direction, const size_t channel, const std::string &name) const
{
#ifdef SOAPY_FOBOS_PRINT_DEBUG  
    printf(">>> %s::%s(%d, %d, %s)\n", __CLASS__, __FUNCTION__, direction, (int)channel, name.c_str());
#endif     
    if ((direction == SOAPY_SDR_RX) && (channel == 0) && (name == "RF"))
    {
        return _center_frequency;
    }
    return 0.0;
}
/******************************************************************************/
std::vector<std::string> SoapyFobosSDR::listFrequencies(const int direction, const size_t channel) const
{
#ifdef SOAPY_FOBOS_PRINT_DEBUG  
    printf(">>> %s::%s(%d, %d)\n", __CLASS__, __FUNCTION__, direction, (int)channel);
#endif     
    std::vector<std::string> names;
    if ((direction == SOAPY_SDR_RX) && (channel == 0))
    {
        names.push_back("RF");
    }
    return names;
}
/******************************************************************************/
SoapySDR::RangeList SoapyFobosSDR::getFrequencyRange(
        const int direction,
        const size_t channel,
        const std::string &name) const
{
    SoapySDR::RangeList results;
    if ((direction == SOAPY_SDR_RX) && (channel == 0) && (name == "RF"))
    {
        if (hw_revision[0] == '4')
        {
            results.push_back(SoapySDR::Range(50E6, 9100E6));
        }
        else
        {
            results.push_back(SoapySDR::Range(50E6, 6000E6));
        }
    }
    return results;
}
/******************************************************************************/
SoapySDR::ArgInfoList SoapyFobosSDR::getFrequencyArgsInfo(const int direction, const size_t channel) const
{
    SoapySDR::ArgInfoList freqArgs;
    if ((direction == SOAPY_SDR_RX) && (channel == 0))
    {
        // TODO: frequency arguments
        return freqArgs;
    }
    return freqArgs;
}

/*******************************************************************
 * Sample Rate API
 ******************************************************************/

void SoapyFobosSDR::setSampleRate(const int direction, const size_t channel, const double rate)
{
#ifdef SOAPY_FOBOS_PRINT_DEBUG  
    printf(">>> %s::%s(%d, %d, %f)\n", __CLASS__, __FUNCTION__, direction, (int)channel, rate);
#endif  
    SoapySDR_logf(SOAPY_SDR_DEBUG, "Setting sample rate: %f", rate);
    double actual = rate;
    int r = -1;
    if ((direction == SOAPY_SDR_RX) && (channel == 0))
    {
        if (_dev_stock)
        {
            r = fobos_rx_set_samplerate(_dev_stock, rate, &actual);
        }
        else if (_dev_agile)
        {
            r = fobos_sdr_set_samplerate(_dev_agile, rate);
        }
        if (r == 0)
        {
            _sample_rate = actual;
            SoapySDR_logf(SOAPY_SDR_DEBUG, "actual: %f", actual);
        }
        else
        {
            SoapySDR_logf(SOAPY_SDR_DEBUG, "falied, err#: %d", r);
        }
    }
}

double SoapyFobosSDR::getSampleRate(const int direction, const size_t channel) const
{
    if ((direction == SOAPY_SDR_RX) && (channel == 0))
    {
        return _sample_rate;
    }
    return 0.0;
}

std::vector<double> SoapyFobosSDR::listSampleRates(const int direction, const size_t channel) const
{
#ifdef SOAPY_FOBOS_PRINT_DEBUG  
    printf(">>> %s::%s(%d, %d)\n", __CLASS__, __FUNCTION__, direction, (int)channel);
#endif      
    unsigned int count;
    std::vector<double> rates;
    int r = -1;
    if ((direction == SOAPY_SDR_RX) && (channel == 0))
    {
        if (_dev_stock)
        {
            r = fobos_rx_get_samplerates(_dev_stock, 0, &count);
        }
        else if (_dev_agile)
        {
            r = fobos_sdr_get_samplerates(_dev_agile, 0, &count);
        }
        if ((r == 0) && (count > 0))
        {
            rates.resize(count);
            if (_dev_stock)
            {
                fobos_rx_get_samplerates(_dev_stock, rates.data(), &count);
            }
            else if (_dev_agile)
            {
                fobos_sdr_get_samplerates(_dev_agile, rates.data(), &count);
            }
            if (rates[0] > rates[count - 1])
            {
                std::reverse(rates.begin(), rates.end());
            }
        }
    }
    return rates;
}

SoapySDR::RangeList SoapyFobosSDR::getSampleRateRange(const int direction, const size_t channel) const
{
#ifdef SOAPY_FOBOS_PRINT_DEBUG  
    printf(">>> %s::%s(%d, %d)\n", __CLASS__, __FUNCTION__, direction, (int)channel);
#endif      
    SoapySDR::RangeList results;
    if ((direction == SOAPY_SDR_RX) && (channel == 0))
    {
        std::vector<double> rates;
        unsigned int count;
        int r = -1;
        if (_dev_stock)
        {
            r = fobos_rx_get_samplerates(_dev_stock, 0, &count);
        }
        else if (_dev_agile)
        {
            r = fobos_sdr_get_samplerates(_dev_agile, 0, &count);
        }
        if ((r == 0) && (count > 0))
        {
            rates.resize(count);
            if (_dev_stock)
            {
                fobos_rx_get_samplerates(_dev_stock, rates.data(), &count);
            }
            else if (_dev_agile)
            {
                fobos_sdr_get_samplerates(_dev_agile, rates.data(), &count);
            }
            if (rates[0] > rates[count - 1])
            {
                results.push_back(SoapySDR::Range(rates[count - 1], rates[0]));    
            }
            else
            {
                results.push_back(SoapySDR::Range(rates[0], rates[count - 1]));
            }
        }
    }
    return results;
}

/*******************************************************************
 * Settings API
 ******************************************************************/

SoapySDR::ArgInfoList SoapyFobosSDR::getSettingInfo(void) const
{
#ifdef SOAPY_FOBOS_PRINT_DEBUG  
    printf(">>> %s::%s()\n", __CLASS__, __FUNCTION__);
#endif      
    SoapySDR::ArgInfoList args;
    {
        SoapySDR::ArgInfo info;
        info.key = "direct_samp";
        info.value = "0";
        info.name = "Direct Sampling";
        info.description = " HF1/HF2 Direct Sampling Mode";
        info.type = SoapySDR::ArgInfo::STRING;
        info.options.push_back("0");
        info.optionNames.push_back("Off");
        info.options.push_back("1");
        info.optionNames.push_back("On");
        args.push_back(info);
    }
    {
        SoapySDR::ArgInfo info;
        info.key = "clock_source";
        info.value = "0";
        info.name = "Clock Source";
        info.description = "Clock source: 0=Internal (default), 1=External";
        info.type = SoapySDR::ArgInfo::STRING;
        info.options.push_back("0");
        info.optionNames.push_back("Internal");
        info.options.push_back("1");
        info.optionNames.push_back("External");
        args.push_back(info);
    }
    return args;
}

void SoapyFobosSDR::writeSetting(const std::string &key, const std::string &value)
{
#ifdef SOAPY_FOBOS_PRINT_DEBUG  
    printf(">>> %s::%s()\n", __CLASS__, __FUNCTION__);
#endif      
    int r = -1;
    if (key == "direct_samp")
    {
        if (value == "1" || value == "On" || value == "on")
        {
            _direct_sampling = 1;
        }
        else if (value == "0" || value == "Off" || value == "off")
        {
            _direct_sampling = 0;
        }
        else
        {
            SoapySDR_logf(SOAPY_SDR_ERROR, "Invalid direct sampling mode '%s', [0:Off, 1:On]", value.c_str());
            _direct_sampling = 0;
        }
        SoapySDR_logf(SOAPY_SDR_DEBUG, "Direct sampling mode: %d", _direct_sampling);
        if (_dev_stock)
        {
            r = fobos_rx_set_direct_sampling(_dev_stock, _direct_sampling);
        }
        else if (_dev_agile)
        {
            r = fobos_sdr_set_direct_sampling(_dev_agile, _direct_sampling);
        }
        if (r != 0)
        {
            SoapySDR_logf(SOAPY_SDR_ERROR, "set direct_samp failed with code %d", r);
        }
    }
    else if (key == "clock_source")
    {
        if (value == "1" || value == "External" || value == "slave")
        {
            _clock_source = 1;
        }
        else if (value == "0" || value == "Internal" || value == "master")
        {
            _clock_source = 0;
        }
        else
        {
            SoapySDR_logf(SOAPY_SDR_ERROR, "Invalid clock source '%s', use: 0/internal/master or 1/external/slave", value.c_str());
            return;
        }
        
        SoapySDR_logf(SOAPY_SDR_INFO, "Setting clock source: %d (%s)", _clock_source, _clock_source ? "external" : "internal");
        if (_dev_stock)
        {
            r = fobos_rx_set_clk_source(_dev_stock, _clock_source);
        }
        else if (_dev_agile)
        {
            r = fobos_sdr_set_clk_source(_dev_agile, _clock_source);
        }
        if (r != 0)
        {
            SoapySDR_logf(SOAPY_SDR_ERROR, "set clock_source failed with code %d", r);
        }
    }
}

std::string SoapyFobosSDR::readSetting(const std::string &key) const
{
    if (key == "direct_samp") 
    {
        return std::to_string(_direct_sampling);
    }
    if (key == "clock_source")
    {
        return std::to_string(_clock_source);
    }
    return "";
}