Function rig_set_level

src/settings.c:74–130

* \brief set a radio level setting * \param rig The rig handle * \param vfo The target VFO * \param level The level setting * \param val The value to set the level setting to * * Sets the level of a setting. * The level value \a val can be a float or an integer. See #value_t * for more information. * * \return RIG_OK if the operation has been successful, otherwise * a negative val

 * \sa rig_has_set_level(), rig_get_level()
 */
int HAMLIB_API rig_set_level(RIG *rig, vfo_t vfo, setting_t level, value_t val)
{
    const struct rig_caps *caps;
    int retcode;
    vfo_t curr_vfo;

    rig_debug(RIG_DEBUG_VERBOSE, "%s called\n", __func__);

    if (CHECK_RIG_ARG(rig))
    {
        return -RIG_EINVAL;
    }

    caps = rig->caps;

    if (caps->set_level == NULL || !rig_has_set_level(rig, level))
    {
        return -RIG_ENAVAIL;
    }

    rig_lock(rig, 1);
    if ((caps->targetable_vfo & RIG_TARGETABLE_LEVEL)
            || vfo == RIG_VFO_CURR
            || vfo == STATE(rig)->current_vfo)
    {

        if (level == RIG_LEVEL_KEYSPD)
        {
            extern int morse_data_handler_set_keyspd(RIG * rig, int keyspd);
            morse_data_handler_set_keyspd(rig, val.i);
        }

        retcode = caps->set_level(rig, vfo, level, val);
        rig_lock(rig, 0);
        return retcode;
    }

    if (!caps->set_vfo)
    {
        rig_lock(rig, 0);
        return -RIG_ENTARGET;
    }

    curr_vfo = STATE(rig)->current_vfo;
    retcode = caps->set_vfo(rig, vfo);

    if (retcode != RIG_OK)
    {
        rig_lock(rig, 0);
        return retcode;
    }

    retcode = caps->set_level(rig, vfo, level, val);
    caps->set_vfo(rig, curr_vfo);
    rig_lock(rig, 0);
    return retcode;
}