/* * Hamlib Interface - rig state cache routines * Copyright (c) 2000-2012 by Stephane Fillod * Copyright (c) 2000-2003 by Frank Singleton * * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 of the License, or (at your option) any later version. * * This library is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, write to the Free Software * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA * */ #include "cache.h" #include "misc.h" #define CHECK_RIG_ARG(r) (!(r) || !(r)->caps || !(r)->state.comm_state) /** * \addtogroup rig * @{ */ int rig_set_cache_mode(RIG *rig, vfo_t vfo, rmode_t mode, pbwidth_t width) { ENTERFUNC; rig_cache_show(rig, __func__, __LINE__); if (vfo == RIG_VFO_CURR) { // if CURR then update this before we figure out the real VFO vfo = rig->state.current_vfo; } // pick a sane default if (vfo == RIG_VFO_NONE || vfo == RIG_VFO_CURR) { vfo = RIG_VFO_A; } if (vfo == RIG_VFO_SUB && rig->state.cache.satmode) { vfo = RIG_VFO_SUB_A; }; if (vfo == RIG_VFO_OTHER) { vfo = vfo_fixup(rig, vfo, rig->state.cache.split); } switch (vfo) { case RIG_VFO_ALL: // we'll use NONE to reset all VFO caches elapsed_ms(&rig->state.cache.time_modeMainA, HAMLIB_ELAPSED_INVALIDATE); elapsed_ms(&rig->state.cache.time_modeMainB, HAMLIB_ELAPSED_INVALIDATE); elapsed_ms(&rig->state.cache.time_modeMainC, HAMLIB_ELAPSED_INVALIDATE); elapsed_ms(&rig->state.cache.time_widthMainA, HAMLIB_ELAPSED_INVALIDATE); elapsed_ms(&rig->state.cache.time_widthMainB, HAMLIB_ELAPSED_INVALIDATE); elapsed_ms(&rig->state.cache.time_widthMainC, HAMLIB_ELAPSED_INVALIDATE); break; case RIG_VFO_A: case RIG_VFO_VFO: case RIG_VFO_MAIN: case RIG_VFO_MAIN_A: rig->state.cache.modeMainA = mode; if (width > 0) { rig->state.cache.widthMainA = width; } elapsed_ms(&rig->state.cache.time_modeMainA, HAMLIB_ELAPSED_SET); elapsed_ms(&rig->state.cache.time_widthMainA, HAMLIB_ELAPSED_SET); break; case RIG_VFO_B: case RIG_VFO_SUB: case RIG_VFO_MAIN_B: rig->state.cache.modeMainB = mode; if (width > 0) { rig->state.cache.widthMainB = width; } elapsed_ms(&rig->state.cache.time_modeMainB, HAMLIB_ELAPSED_SET); elapsed_ms(&rig->state.cache.time_widthMainB, HAMLIB_ELAPSED_SET); break; case RIG_VFO_C: case RIG_VFO_MAIN_C: rig->state.cache.modeMainC = mode; if (width > 0) { rig->state.cache.widthMainC = width; } elapsed_ms(&rig->state.cache.time_modeMainC, HAMLIB_ELAPSED_SET); elapsed_ms(&rig->state.cache.time_widthMainC, HAMLIB_ELAPSED_SET); break; case RIG_VFO_MEM: rig->state.cache.modeMem = mode; elapsed_ms(&rig->state.cache.time_modeMem, HAMLIB_ELAPSED_SET); break; default: rig_debug(RIG_DEBUG_WARN, "%s: unknown vfo=%s\n", __func__, rig_strvfo(vfo)); RETURNFUNC(-RIG_EINTERNAL); } rig_cache_show(rig, __func__, __LINE__); RETURNFUNC(RIG_OK); } int rig_set_cache_freq(RIG *rig, vfo_t vfo, freq_t freq) { int flag = HAMLIB_ELAPSED_SET; if (rig_need_debug(RIG_DEBUG_CACHE)) { rig_cache_show(rig, __func__, __LINE__); } rig_debug(RIG_DEBUG_CACHE, "%s: vfo=%s, current_vfo=%s\n", __func__, rig_strvfo(vfo), rig_strvfo(rig->state.current_vfo)); if (vfo == RIG_VFO_CURR) { // if CURR then update this before we figure out the real VFO vfo = rig->state.current_vfo; } // if freq == 0 then we are asking to invalidate the cache if (freq == 0) { flag = HAMLIB_ELAPSED_INVALIDATE; } // pick a sane default if (vfo == RIG_VFO_NONE || vfo == RIG_VFO_CURR) { vfo = RIG_VFO_A; } if (vfo == RIG_VFO_SUB && rig->state.cache.satmode) { vfo = RIG_VFO_SUB_A; }; if (rig_need_debug(RIG_DEBUG_CACHE)) { rig_debug(RIG_DEBUG_CACHE, "%s: set vfo=%s to freq=%.0f\n", __func__, rig_strvfo(vfo), freq); } switch (vfo) { case RIG_VFO_ALL: // we'll use NONE to reset all VFO caches elapsed_ms(&rig->state.cache.time_freqMainA, HAMLIB_ELAPSED_INVALIDATE); elapsed_ms(&rig->state.cache.time_freqMainB, HAMLIB_ELAPSED_INVALIDATE); elapsed_ms(&rig->state.cache.time_freqMainC, HAMLIB_ELAPSED_INVALIDATE); elapsed_ms(&rig->state.cache.time_freqSubA, HAMLIB_ELAPSED_INVALIDATE); elapsed_ms(&rig->state.cache.time_freqSubB, HAMLIB_ELAPSED_INVALIDATE); elapsed_ms(&rig->state.cache.time_freqSubC, HAMLIB_ELAPSED_INVALIDATE); elapsed_ms(&rig->state.cache.time_freqMem, HAMLIB_ELAPSED_INVALIDATE); elapsed_ms(&rig->state.cache.time_vfo, HAMLIB_ELAPSED_INVALIDATE); elapsed_ms(&rig->state.cache.time_modeMainA, HAMLIB_ELAPSED_INVALIDATE); elapsed_ms(&rig->state.cache.time_modeMainB, HAMLIB_ELAPSED_INVALIDATE); elapsed_ms(&rig->state.cache.time_modeMainC, HAMLIB_ELAPSED_INVALIDATE); elapsed_ms(&rig->state.cache.time_widthMainA, HAMLIB_ELAPSED_INVALIDATE); elapsed_ms(&rig->state.cache.time_widthMainB, HAMLIB_ELAPSED_INVALIDATE); elapsed_ms(&rig->state.cache.time_widthMainC, HAMLIB_ELAPSED_INVALIDATE); elapsed_ms(&rig->state.cache.time_ptt, HAMLIB_ELAPSED_INVALIDATE); elapsed_ms(&rig->state.cache.time_split, HAMLIB_ELAPSED_INVALIDATE); break; case RIG_VFO_A: case RIG_VFO_VFO: case RIG_VFO_MAIN: case RIG_VFO_MAIN_A: rig->state.cache.freqMainA = freq; elapsed_ms(&rig->state.cache.time_freqMainA, flag); break; case RIG_VFO_B: case RIG_VFO_MAIN_B: case RIG_VFO_SUB: rig->state.cache.freqMainB = freq; elapsed_ms(&rig->state.cache.time_freqMainB, flag); break; case RIG_VFO_C: case RIG_VFO_MAIN_C: rig->state.cache.freqMainC = freq; elapsed_ms(&rig->state.cache.time_freqMainC, flag); break; case RIG_VFO_SUB_A: rig->state.cache.freqSubA = freq; elapsed_ms(&rig->state.cache.time_freqSubA, flag); break; case RIG_VFO_SUB_B: rig->state.cache.freqSubB = freq; elapsed_ms(&rig->state.cache.time_freqSubB, flag); break; case RIG_VFO_SUB_C: rig->state.cache.freqSubC = freq; elapsed_ms(&rig->state.cache.time_freqSubC, flag); break; case RIG_VFO_MEM: rig->state.cache.freqMem = freq; elapsed_ms(&rig->state.cache.time_freqMem, flag); break; default: rig_debug(RIG_DEBUG_ERR, "%s: unknown vfo?, vfo=%s\n", __func__, rig_strvfo(vfo)); return (-RIG_EINVAL); } if (rig_need_debug(RIG_DEBUG_CACHE)) { rig_cache_show(rig, __func__, __LINE__); return (RIG_OK); } return (RIG_OK); } /** * \brief get cached values for a VFO * \param rig The rig handle * \param vfo The VFO to get information from * \param freq The frequency is stored here * \param cache_ms_freq The age of the last frequency update in ms * \param mode The mode is stored here * \param cache_ms_mode The age of the last mode update in ms * \param width The width is stored here * \param cache_ms_width The age of the last width update in ms * * Use this to query the cache and then determine to actually fetch data from * the rig. * * \note All pointers must be given. No pointer can be left at NULL * * \return RIG_OK if the operation has been successful, otherwise * a negative value if an error occurred (in which case, cause is * set appropriately). * */ int rig_get_cache(RIG *rig, vfo_t vfo, freq_t *freq, int *cache_ms_freq, rmode_t *mode, int *cache_ms_mode, pbwidth_t *width, int *cache_ms_width) { if (CHECK_RIG_ARG(rig) || !freq || !cache_ms_freq || !mode || !cache_ms_mode || !width || !cache_ms_width) { RETURNFUNC(-RIG_EINVAL); } if (rig_need_debug(RIG_DEBUG_CACHE)) { ENTERFUNC2; } rig_debug(RIG_DEBUG_CACHE, "%s: vfo=%s, current_vfo=%s\n", __func__, rig_strvfo(vfo), rig_strvfo(rig->state.current_vfo)); if (vfo == RIG_VFO_CURR) { vfo = rig->state.current_vfo; } else if (vfo == RIG_VFO_OTHER) { switch (rig->state.current_vfo) { case RIG_VFO_OTHER: vfo = RIG_VFO_OTHER; break; case RIG_VFO_A: vfo = RIG_VFO_B; break; case RIG_VFO_MAIN_A: vfo = RIG_VFO_MAIN_B; break; case RIG_VFO_MAIN: vfo = RIG_VFO_SUB; break; case RIG_VFO_B: vfo = RIG_VFO_A; break; case RIG_VFO_MAIN_B: vfo = RIG_VFO_MAIN_A; break; case RIG_VFO_SUB_A: vfo = RIG_VFO_SUB_B; break; case RIG_VFO_SUB_B: vfo = RIG_VFO_SUB_A; break; default: rig_debug(RIG_DEBUG_ERR, "%s: unknown vfo=%s\n", __func__, rig_strvfo(vfo)); } } // pick a sane default if (vfo == RIG_VFO_CURR || vfo == RIG_VFO_NONE) { vfo = RIG_VFO_A; } // If we're in satmode we map SUB to SUB_A if (vfo == RIG_VFO_SUB && rig->state.cache.satmode) { vfo = RIG_VFO_SUB_A; }; switch (vfo) { case RIG_VFO_CURR: *freq = rig->state.cache.freqCurr; *mode = rig->state.cache.modeCurr; *width = rig->state.cache.widthCurr; *cache_ms_freq = elapsed_ms(&rig->state.cache.time_freqCurr, HAMLIB_ELAPSED_GET); *cache_ms_mode = elapsed_ms(&rig->state.cache.time_modeCurr, HAMLIB_ELAPSED_GET); *cache_ms_width = elapsed_ms(&rig->state.cache.time_widthCurr, HAMLIB_ELAPSED_GET); break; case RIG_VFO_OTHER: *freq = rig->state.cache.freqOther; *mode = rig->state.cache.modeOther; *width = rig->state.cache.widthOther; *cache_ms_freq = elapsed_ms(&rig->state.cache.time_freqOther, HAMLIB_ELAPSED_GET); *cache_ms_mode = elapsed_ms(&rig->state.cache.time_modeOther, HAMLIB_ELAPSED_GET); *cache_ms_width = elapsed_ms(&rig->state.cache.time_widthOther, HAMLIB_ELAPSED_GET); break; case RIG_VFO_A: case RIG_VFO_VFO: case RIG_VFO_MAIN: case RIG_VFO_MAIN_A: *freq = rig->state.cache.freqMainA; *mode = rig->state.cache.modeMainA; *width = rig->state.cache.widthMainA; *cache_ms_freq = elapsed_ms(&rig->state.cache.time_freqMainA, HAMLIB_ELAPSED_GET); *cache_ms_mode = elapsed_ms(&rig->state.cache.time_modeMainA, HAMLIB_ELAPSED_GET); *cache_ms_width = elapsed_ms(&rig->state.cache.time_widthMainA, HAMLIB_ELAPSED_GET); break; case RIG_VFO_B: case RIG_VFO_SUB: case RIG_VFO_MAIN_B: *freq = rig->state.cache.freqMainB; *mode = rig->state.cache.modeMainB; *width = rig->state.cache.widthMainB; *cache_ms_freq = elapsed_ms(&rig->state.cache.time_freqMainB, HAMLIB_ELAPSED_GET); *cache_ms_mode = elapsed_ms(&rig->state.cache.time_modeMainB, HAMLIB_ELAPSED_GET); *cache_ms_width = elapsed_ms(&rig->state.cache.time_widthMainB, HAMLIB_ELAPSED_GET); break; case RIG_VFO_SUB_A: *freq = rig->state.cache.freqSubA; *mode = rig->state.cache.modeSubA; *width = rig->state.cache.widthSubA; *cache_ms_freq = elapsed_ms(&rig->state.cache.time_freqSubA, HAMLIB_ELAPSED_GET); *cache_ms_mode = elapsed_ms(&rig->state.cache.time_modeSubA, HAMLIB_ELAPSED_GET); *cache_ms_width = elapsed_ms(&rig->state.cache.time_widthSubA, HAMLIB_ELAPSED_GET); break; case RIG_VFO_SUB_B: *freq = rig->state.cache.freqSubB; *mode = rig->state.cache.modeSubB; *width = rig->state.cache.widthSubB; *cache_ms_freq = elapsed_ms(&rig->state.cache.time_freqSubB, HAMLIB_ELAPSED_GET); *cache_ms_mode = elapsed_ms(&rig->state.cache.time_modeSubB, HAMLIB_ELAPSED_GET); *cache_ms_width = elapsed_ms(&rig->state.cache.time_widthSubB, HAMLIB_ELAPSED_GET); break; case RIG_VFO_C: //case RIG_VFO_MAINC: // not used by any rig yet *freq = rig->state.cache.freqMainC; *mode = rig->state.cache.modeMainC; *width = rig->state.cache.widthMainC; *cache_ms_freq = elapsed_ms(&rig->state.cache.time_freqMainC, HAMLIB_ELAPSED_GET); *cache_ms_mode = elapsed_ms(&rig->state.cache.time_modeMainC, HAMLIB_ELAPSED_GET); *cache_ms_width = elapsed_ms(&rig->state.cache.time_widthMainC, HAMLIB_ELAPSED_GET); break; case RIG_VFO_SUB_C: *freq = rig->state.cache.freqSubC; *mode = rig->state.cache.modeSubC; *width = rig->state.cache.widthSubC; *cache_ms_freq = elapsed_ms(&rig->state.cache.time_freqSubC, HAMLIB_ELAPSED_GET); *cache_ms_mode = elapsed_ms(&rig->state.cache.time_modeSubC, HAMLIB_ELAPSED_GET); *cache_ms_width = elapsed_ms(&rig->state.cache.time_widthSubC, HAMLIB_ELAPSED_GET); break; case RIG_VFO_MEM: *freq = rig->state.cache.freqMem; *mode = rig->state.cache.modeMem; *width = rig->state.cache.widthMem; *cache_ms_freq = elapsed_ms(&rig->state.cache.time_freqMem, HAMLIB_ELAPSED_GET); *cache_ms_mode = elapsed_ms(&rig->state.cache.time_modeMem, HAMLIB_ELAPSED_GET); *cache_ms_width = elapsed_ms(&rig->state.cache.time_widthMem, HAMLIB_ELAPSED_GET); break; default: rig_debug(RIG_DEBUG_ERR, "%s: unknown vfo?, vfo=%s\n", __func__, rig_strvfo(vfo)); RETURNFUNC(-RIG_EINVAL); } rig_debug(RIG_DEBUG_CACHE, "%s: vfo=%s, freq=%.0f, mode=%s, width=%d\n", __func__, rig_strvfo(vfo), (double)*freq, rig_strrmode(*mode), (int)*width); if (rig_need_debug(RIG_DEBUG_CACHE)) { RETURNFUNC(RIG_OK); } return RIG_OK; } void rig_cache_show(RIG *rig, const char *func, int line) { rig_debug(RIG_DEBUG_CACHE, "%s(%d): freqMainA=%.0f, modeMainA=%s, widthMainA=%d\n", func, line, rig->state.cache.freqMainA, rig_strrmode(rig->state.cache.modeMainA), (int)rig->state.cache.widthMainA); rig_debug(RIG_DEBUG_CACHE, "%s(%d): freqMainB=%.0f, modeMainB=%s, widthMainB=%d\n", func, line, rig->state.cache.freqMainB, rig_strrmode(rig->state.cache.modeMainB), (int)rig->state.cache.widthMainB); if (rig->state.vfo_list & RIG_VFO_SUB_A) { rig_debug(RIG_DEBUG_CACHE, "%s(%d): freqSubA=%.0f, modeSubA=%s, widthSubA=%d\n", func, line, rig->state.cache.freqSubA, rig_strrmode(rig->state.cache.modeSubA), (int)rig->state.cache.widthSubA); rig_debug(RIG_DEBUG_CACHE, "%s(%d): freqSubB=%.0f, modeSubB=%s, widthSubB=%d\n", func, line, rig->state.cache.freqSubB, rig_strrmode(rig->state.cache.modeSubB), (int)rig->state.cache.widthSubB); } } /*! @} */