Function rig_set_mode

src/rig.c:2838–3015

* \brief set the mode of the target VFO * \param rig The rig handle * \param vfo The target VFO * \param mode The mode to set to * \param width The passband width to set to * * Sets the mode and associated passband of the target VFO. The * passband \a width must be supported by the backend of the rig or * the special value RIG_PASSBAND_NOCHANGE which leaves the passband * unchanged

 * \sa rig_get_mode()
 */
int HAMLIB_API rig_set_mode(RIG *rig, vfo_t vfo, rmode_t mode, pbwidth_t width)
{
    const struct rig_caps *caps;
    struct rig_state *rs;
    int retcode;
    int locked_mode;
    struct rig_cache *cachep;

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

    rs = STATE(rig);
    cachep = CACHE(rig);

    ENTERFUNC;
    ELAPSED1;
    LOCK(1);

    rig_debug(RIG_DEBUG_VERBOSE,
              "%s called, vfo=%s, mode=%s, width=%d, curr_vfo=%s\n", __func__,
              rig_strvfo(vfo), rig_strrmode(mode), (int)width,
              rig_strvfo(rs->current_vfo));

    rig_get_lock_mode(rig, &locked_mode);

    if (locked_mode)
    {
        ELAPSED2;
        LOCK(0);
        RETURNFUNC(RIG_OK);
    }

    // do not mess with mode while PTT is on
    if (cachep->ptt)
    {
        rig_debug(RIG_DEBUG_VERBOSE, "%s PTT on so set_mode ignored\n", __func__);
        ELAPSED2;
        LOCK(0);
        RETURNFUNC(RIG_OK);
    }

    caps = rig->caps;

    if (caps->set_mode == NULL)
    {
        ELAPSED2;
        LOCK(0);
        RETURNFUNC(-RIG_ENAVAIL);
    }

    if (vfo == RIG_VFO_CURR)
    {
        vfo = rs->current_vfo;
    }