Function rig_set_split_freq

src/rig.c:4749–4922

* \brief set the split frequencies * \param rig The rig handle * \param vfo The target VFO * \param tx_freq The transmit split frequency to set to * * Sets the split(TX) frequency. * * \return RIG_OK if the operation has been successful, otherwise * a negative value if an error occurred (in which case, cause is * set appropriately). * * \sa rig_get_split_freq(), rig_set_split_vfo

 * \sa rig_get_split_freq(), rig_set_split_vfo()
 */
int HAMLIB_API rig_set_split_freq(RIG *rig, vfo_t vfo, freq_t tx_freq)
{
    const struct rig_caps *caps;
    const struct rig_state *rs;
    struct rig_cache *cachep;
    int retcode, rc2;
    vfo_t curr_vfo, tx_vfo;
    freq_t tfreq = 0;

    if (CHECK_RIG_ARG(rig))
    {
        rig_debug(RIG_DEBUG_ERR, "%s: rig or rig->caps is null\n", __func__);
        return -RIG_EINVAL;
    }

    ENTERFUNC2;
    ELAPSED1;

    rs = STATE(rig);
    caps = rig->caps;
    cachep = CACHE(rig);

    rig_debug(RIG_DEBUG_VERBOSE, "%s called vfo=%s, curr_vfo=%s, tx_freq=%.0f\n",
              __func__,
              rig_strvfo(vfo), rig_strvfo(rs->current_vfo), tx_freq);

    // Always use the previously selected TX VFO for split. The targeted VFO will have no effect.
    tx_vfo = rs->tx_vfo;

    if (cachep->split == RIG_SPLIT_OFF || tx_vfo == RIG_VFO_NONE
            || tx_vfo == RIG_VFO_CURR)
    {
        // Turn split on if not enabled already
        retcode = rig_set_split_vfo(rig, rs->current_vfo, RIG_SPLIT_ON, vfo_fixup(rig,
                                    RIG_VFO_OTHER, RIG_SPLIT_OFF));

        if (retcode != RIG_OK)
        {
            rig_debug(RIG_DEBUG_ERR, "%s: error turning split on: result=%d\n", __func__,
                      retcode);
            ELAPSED2;
            RETURNFUNC2(retcode);
        }
    }

    // TX VFO may change after enabling split
    tx_vfo = rs->tx_vfo;

    rig_get_freq(rig, tx_vfo, &tfreq);

    if (tfreq == tx_freq)
    {
        rig_debug(RIG_DEBUG_TRACE, "%s: freq set not needed\n", __func__);
        ELAPSED2;
        RETURNFUNC2(RIG_OK);
    }

    // Use set_split_freq directly if implemented and frequency is targetable