Logo Search packages:      
Sourcecode: hamlib version File versions  Download package

int HAMLIB_API rig_recv_dtmf ( RIG rig,
vfo_t  vfo,
char *  digits,
int *  length 
)

receive DTMF digits

Parameters:
rigThe rig handle
vfoThe target VFO
digitsLocation where the digits are to be stored
lengthin: max length of buffer, out: number really read.

Receives DTMF digits (not blocking). See DTMF change speed, etc. (TODO).

Returns:
RIG_OK if the operation has been sucessful, otherwise a negative value if an error occured (in which case, cause is set appropriately).

Definition at line 2723 of file rig.c.

References caps, rig_state::current_vfo, RIG_EINVAL, RIG_ENAVAIL, RIG_ENTARGET, RIG_OK, RIG_VFO_CURR, state, and rig_caps::targetable_vfo.

{
      const struct rig_caps *caps;
      int retcode;
      vfo_t curr_vfo;

      if (CHECK_RIG_ARG(rig) || !digits || !length)
            return -RIG_EINVAL;

      caps = rig->caps;

      if (caps->recv_dtmf == NULL)
            return -RIG_ENAVAIL;

      if ((caps->targetable_vfo&RIG_TARGETABLE_PURE) ||
                  vfo == RIG_VFO_CURR || vfo == rig->state.current_vfo)
            return caps->recv_dtmf(rig, vfo, digits, length);

      if (!caps->set_vfo)
            return -RIG_ENTARGET;
      curr_vfo = rig->state.current_vfo;
      retcode = caps->set_vfo(rig, vfo);
      if (retcode != RIG_OK)
            return retcode;

      retcode = caps->recv_dtmf(rig, vfo, digits, length);
      caps->set_vfo(rig, curr_vfo);
      return retcode;
}

Generated by  Doxygen 1.6.0   Back to index