Function rig_get_level

src/settings.c:157–233

* \brief get the value of a level * \param rig The rig handle * \param vfo The target VFO * \param level The level setting * \param val The location where to store the value of \a level * * Retrieves the value of a \a level. * The level value \a val can be a float or an integer. See #value_t * for more information. * * RIG_LEVEL_STRENGTH: \a val is an integer, representing

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

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

    if (CHECK_RIG_ARG(rig) || !val)
    {
        return -RIG_EINVAL;
    }

    caps = rig->caps;

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

    rig_lock(rig, 1); // Keep Out!
    /*
     * Special case(frontend emulation): calibrated S-meter reading
     */
    if (level == RIG_LEVEL_STRENGTH
            && (caps->has_get_level & RIG_LEVEL_STRENGTH) == 0
            && rig_has_get_level(rig, RIG_LEVEL_RAWSTR)
            && rs->str_cal.size)
    {

        value_t rawstr;

        retcode = rig_get_level(rig, vfo, RIG_LEVEL_RAWSTR, &rawstr);

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

        val->i = (int)rig_raw2val(rawstr.i, &rs->str_cal);
        rig_lock(rig, 0);
        return RIG_OK;
    }


    if ((caps->targetable_vfo & RIG_TARGETABLE_LEVEL)
            || vfo == RIG_VFO_CURR
            || vfo == rs->current_vfo)
    {
        retcode = caps->get_level(rig, vfo, level, val);
        rig_lock(rig, 0);
        return retcode;
    }

    if (!caps->set_vfo)