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

uniden.c

/*
 *  Hamlib Uniden backend - main file
 *  Copyright (c) 2001-2008 by Stephane Fillod
 *
 *    $Id: uniden.c,v 1.15 2008/10/07 18:58:08 fillods Exp $
 *
 *   This library is free software; you can redistribute it and/or modify
 *   it under the terms of the GNU Library General Public License as
 *   published by the Free Software Foundation; either version 2 of
 *   the License, or (at your option) any later version.
 *
 *   This program 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 Library General Public License for more details.
 *
 *   You should have received a copy of the GNU Library General Public
 *   License along with this library; if not, write to the Free Software
 *   Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
 *
 */

#ifdef HAVE_CONFIG_H
#include "config.h"
#endif

#include <stdio.h>
#include <stdlib.h>
#include <string.h>  /* String function definitions */
#include <unistd.h>  /* UNIX standard function definitions */
#include <math.h>

#include "hamlib/rig.h"
#include "serial.h"
#include "misc.h"
#include "register.h"
#include "idx_builtin.h"

#include "uniden.h"


static const struct { rig_model_t model; const char *id; }
uniden_id_string_list[] = {
      { RIG_MODEL_BC780,  "BC780" },
      { RIG_MODEL_BC245,  "BC245XLT" },
      { RIG_MODEL_BC250,  "BC250D" },
      { RIG_MODEL_BC895,  "BC895" },
      { RIG_MODEL_BC235,  "BC235XLT" },
      { RIG_MODEL_BC785,  "BC785" },
      { RIG_MODEL_BC786,  "BC786D" },
      { RIG_MODEL_PRO2052,"PRO2052" }, /* ?? */
      { RIG_MODEL_BCT8,   "BCT8" },  /* ?? */
      { RIG_MODEL_NONE, NULL },     /* end marker */
};


const tone_t uniden_ctcss_list[] = {
 670,  719,  744,  770,  797,  825,  854,  885,  915,
  948, 974, 1000, 1035, 1072, 1109, 1148, 1188, 1230,
1273, 1318, 1365, 1413, 1462, 1514, 1567, 1622, 1679,
1738, 1799, 1862, 1928, 2035, 2107, 2181, 2257, 2336,
2418, 2503
};

const tone_t uniden_dcs_list[] = {
 23,  25,  26,  31,  32,  36,  43,  47,  51,  53,
 54,  65,  71,  72,  73,  74, 114, 115, 116, 122,
125, 131, 132, 134, 143, 145, 152, 155, 156, 162,
165, 172, 174, 205, 212, 223, 225, 226, 243, 244,
245, 246, 251, 252, 255, 261, 263, 265, 266, 271,
274, 306, 311, 315, 325, 331, 332, 343, 346, 351,
356, 364, 365, 371, 411, 412, 413, 423, 431, 432,
445, 446, 452, 454, 455, 462, 464, 465, 466, 503,
506, 516, 523, 526, 532, 546, 565, 606, 612, 624,
627, 631, 632, 654, 662, 664, 703, 712, 723, 731,
732, 734, 743, 754
};

/*
 * Uniden backend: should work for:
 * BC235XLT, BC895XLT, BC245XLT, BC780XLT, BC250D,  BC785D and BCT8
 * and most probably for the RadioShack PRO-2052.
 *
 * Protocol information available at http://www.cantonmaine.com/pro2052.htm
 * and http://www.freqofnature.com/software/protocols.html
 *
 * It seems like these rigs have no VFO, I mean only mem channels.
 * Is that correct? --SF
 */

#define EOM "\r"

#define BUFSZ 64

/**
 * uniden_transaction
 * Assumes rig!=NULL rig->state!=NULL rig->caps!=NULL
 *
 * cmdstr - Command to be sent to the rig. Cmdstr can also be NULL, indicating
 *          that only a reply is needed (nothing will be send).
 * replystr - Reply prefix to be expected. Replystr can also be NULL, indicating
 *          that the prefix is either the cmdstr prefix or OK.
 * data - Buffer for reply string.  Can be NULL, indicating that no reply is
 *        is needed and will return with RIG_OK after command was sent.
 * datasize - in: Size of buffer. It is the caller's responsibily to provide
 *            a large enough buffer for all possible replies for a command.
 *            out: location where to store number of bytes read.
 *
 * returns:
 *   RIG_OK  -  if no error occured.
 *   RIG_EIO  -  if an I/O error occured while sending/receiving data.
 *   RIG_ETIMEOUT  -  if timeout expires without any characters received.
 *   RIG_REJECTED  -  if a negative acknowledge was received or command not
 *                    recognized by rig.
 */
int
uniden_transaction (RIG *rig, const char *cmdstr, int cmd_len, const char *replystr,
                        char *data, size_t *datasize)
{
    struct rig_state *rs;
    int retval;
    int retry_read = 0;
    char replybuf[BUFSZ];
    size_t reply_len=BUFSZ;

    rs = &rig->state;
    rs->hold_decode = 1;

transaction_write:

    serial_flush(&rs->rigport);

    if (cmdstr) {
        retval = write_block(&rs->rigport, cmdstr, strlen(cmdstr));
        if (retval != RIG_OK)
            goto transaction_quit;
    }

    /* Always read the reply to known if it went OK */
    if (!data)
          data = replybuf;
    if (!datasize)
          datasize = &reply_len;

    memset(data,0,*datasize);
    retval = read_string(&rs->rigport, data, *datasize, EOM, strlen(EOM));
    if (retval < 0) {
        if (retry_read++ < rig->state.rigport.retry)
            goto transaction_write;
        goto transaction_quit;
    } else
          *datasize = retval;

    /* Check that command termination is correct */
    if (strchr(EOM, data[strlen(data)-1])==NULL) {
        rig_debug(RIG_DEBUG_ERR, "%s: Command is not correctly terminated '%s'\n", __FUNCTION__, data);
        if (retry_read++ < rig->state.rigport.retry)
            goto transaction_write;
        retval = -RIG_EPROTO;
        goto transaction_quit;
    }

    if (strcmp(data, "OK"EOM)) {
          /* everything is fine */
          retval = RIG_OK;
          goto transaction_quit;
    }

    /*  Any syntax returning NG indicates a VALID Command but not entered
     *  in the right mode or using the correct parameters. ERR indicates
     *  an INVALID Command.
     */
    if (strcmp(data, "NG"EOM) || strcmp(data, "ORER"EOM)) {
          /* Invalid command */
          rig_debug(RIG_DEBUG_VERBOSE, "%s: NG/Overflow for '%s'\n", __FUNCTION__, cmdstr);
          retval = -RIG_EPROTO;
          goto transaction_quit;
    }

    if (strcmp(data, "ERR"EOM)) {
          /*  Command format error */
          rig_debug(RIG_DEBUG_VERBOSE, "%s: Error for '%s'\n", __FUNCTION__, cmdstr);
          retval = -RIG_EINVAL;
          goto transaction_quit;
    }

#define CONFIG_STRIP_CMDTRM 1
#ifdef CONFIG_STRIP_CMDTRM
    if (strlen(data) > 0)
      data[strlen(data)-1] = '\0';  /* not very elegant, but should work. */
    else
      data[0] = '\0';
#endif

    /* Special case for SQuelch */
    if (!memcmp(cmdstr,"SQ",2) && (replystr[0] == '-' || replystr[0] == '+')) {
          retval = RIG_OK;
          goto transaction_quit;
      }

    /* Command prefix if no replystr supplied */
    if (!replystr)
          replystr = cmdstr;
    /*
     * Check that received the correct reply. The first two characters
     * should be the same as command.
     */
    if (replystr && replystr[0] && (data[0] != replystr[0] || 
                      (replystr[1] && data[1] != replystr[1]))) {
         /*
          * TODO: When RIG_TRN is enabled, we can pass the string
          *       to the decoder for callback. That way we don't ignore
          *       any commands.
          */
        rig_debug(RIG_DEBUG_ERR, "%s: Unexpected reply '%s'\n", __FUNCTION__, data);
        if (retry_read++ < rig->state.rigport.retry)
            goto transaction_write;

        retval =  -RIG_EPROTO;
        goto transaction_quit;
    }

    retval = RIG_OK;
transaction_quit:
    rs->hold_decode = 0;
    return retval;
}

/*
 * uniden_set_freq
 * Assumes rig!=NULL
 */
int uniden_set_freq(RIG *rig, vfo_t vfo, freq_t freq)
{
      char freqbuf[BUFSZ];
      size_t freq_len=BUFSZ;

      /* freq in hundreds of Hz */
      freq /= 100;

      /* exactly 8 digits */
      freq_len = sprintf(freqbuf, "RF%08u" EOM, (unsigned)freq);

      return uniden_transaction (rig, freqbuf, freq_len, NULL, NULL, NULL);
}

/*
 * uniden_get_freq
 * Assumes rig!=NULL
 */
int uniden_get_freq(RIG *rig, vfo_t vfo, freq_t *freq)
{
      char freqbuf[BUFSZ];
      size_t freq_len=BUFSZ;
      int ret;

      ret = uniden_transaction (rig, "RF" EOM, 3, NULL, freqbuf, &freq_len);
      if (ret != RIG_OK)
            return ret;

      if (freq_len < 10)
            return -RIG_EPROTO;

      sscanf(freqbuf+2, "%"SCNfreq, freq);
      /* returned freq in hundreds of Hz */
      *freq *= 100;

      return RIG_OK;
}

int uniden_set_mode(RIG *rig, vfo_t vfo, rmode_t mode, pbwidth_t width)
{
      const char *modebuf;

      switch (mode) {
            case RIG_MODE_AM:
                  modebuf = "RM AM"EOM;
                  break;
            case RIG_MODE_FM:
                  if (width > 0 && width < rig_passband_normal(rig, mode))
                        modebuf = "RM NFM"EOM;
                  else
                        modebuf = "RM FM"EOM;
                  break;
            case RIG_MODE_WFM:
                  modebuf = "RM WFM"EOM;
                  break;
            default:
                  return -RIG_EINVAL;
      }

      return uniden_transaction (rig, modebuf, strlen(modebuf), NULL, NULL, NULL);
}

int uniden_get_mode(RIG *rig, vfo_t vfo, rmode_t *mode, pbwidth_t *width)
{
      char modebuf[BUFSZ];
      size_t mode_len=BUFSZ;
      int ret;

      ret = uniden_transaction (rig, "RM" EOM, 3, NULL, modebuf, &mode_len);
      if (ret != RIG_OK)
            return ret;

      if (mode_len < 4)
            return -RIG_EPROTO;

      *width = 0;
      if (!strcmp(modebuf+3, "AM"))
            *mode = RIG_MODE_AM;
      else if (!strcmp(modebuf+3, "WFM"))
            *mode = RIG_MODE_AM;
      else if (!strcmp(modebuf+3, "FM"))
            *mode = RIG_MODE_FM;
      else if (!strcmp(modebuf+3, "NFM")) {
            *mode = RIG_MODE_FM;
            *width = rig_passband_narrow(rig, RIG_MODE_FM);
      }

      if (*width == 0)
            *width = rig_passband_normal(rig, *mode);

      return RIG_OK;
}

int uniden_set_level(RIG *rig, vfo_t vfo, setting_t level, value_t val)
{
      char levelbuf[16];
      size_t level_len=16;
      int retval;

      switch (level) {
      case RIG_LEVEL_ATT:
            if (rig->state.attenuator[0] == 0)
                  return -RIG_EINVAL;

            level_len = sprintf(levelbuf, "AT%c"EOM,
                        val.i != 0 ? 'N':'F');
            break;
            
      default:
            rig_debug(RIG_DEBUG_ERR,"Unsupported set_level %d", level);
            return -RIG_EINVAL;
      }

      retval = uniden_transaction (rig, levelbuf, level_len, NULL, NULL, NULL);

      if (retval != RIG_OK)
            return retval;

      return RIG_OK;
}

/*
 * uniden_get_level
 * Assumes rig!=NULL, val!=NULL
 */
int uniden_get_level(RIG *rig, vfo_t vfo, setting_t level, value_t *val)
{
      char lvlbuf[BUFSZ];
      int retval;
      size_t lvl_len=BUFSZ;

      switch (level) {
      case RIG_LEVEL_RAWSTR:
            retval = uniden_transaction (rig, "SG"EOM, 3, "S", lvlbuf, &lvl_len);
            if (retval != RIG_OK)
                  return retval;

            if (lvl_len < 4) {
                  rig_debug(RIG_DEBUG_ERR,"%s: wrong answer len=%d\n",
                              __FUNCTION__, lvl_len);
                  return -RIG_ERJCTED;
            }

            /* S182 F08594375 */
            sscanf(lvlbuf+1, "%d", &val->i);    /* rawstr */
            break;

      case RIG_LEVEL_ATT:
            retval = uniden_transaction (rig, "AT"EOM, 3, NULL, lvlbuf, &lvl_len);
            if (retval != RIG_OK)
                  return retval;

            if (lvl_len < 3) {
                  rig_debug(RIG_DEBUG_ERR,"%s: unexpected answer len=%d\n",
                              __FUNCTION__, lvl_len);
                  return -RIG_ERJCTED;
            }

            val->i = lvlbuf[2] == 'N' ? rig->state.attenuator[0] : 0;
            break;

      default:
            rig_debug(RIG_DEBUG_ERR,"Unsupported get_level %d", level);
            return -RIG_EINVAL;
      }

      return RIG_OK;
}

/*
 * uniden_get_dcd
 * Assumes rig!=NULL
 */
int uniden_get_dcd(RIG *rig, vfo_t vfo, dcd_t *dcd)
{
      char dcdbuf[BUFSZ];
      size_t dcd_len=BUFSZ;
      int ret;

      ret = uniden_transaction (rig, "SQ" EOM, 3, NULL, dcdbuf, &dcd_len);
      if (ret != RIG_OK)
            return ret;

      if (dcd_len < 1 || (dcdbuf[0] != '+' && dcdbuf[0] != '-'))
            return -RIG_EPROTO;

      *dcd = (dcdbuf[0] == '-') ? RIG_DCD_OFF : RIG_DCD_ON;

      return RIG_OK;
}

/*
 * uniden_set_mem
 * Assumes rig!=NULL
 */
int uniden_set_mem(RIG *rig, vfo_t vfo, int ch)
{
      char cmdbuf[BUFSZ];
      size_t cmd_len=BUFSZ;

      cmd_len = sprintf(cmdbuf, "MA%03d" EOM, ch);

      return uniden_transaction (rig, cmdbuf, cmd_len, NULL, NULL, NULL);
}

/*
 * uniden_get_mem
 * Assumes rig!=NULL
 */
int uniden_get_mem(RIG *rig, vfo_t vfo, int *ch)
{
      char membuf[BUFSZ];
      size_t mem_len=BUFSZ;
      int ret;

      ret = uniden_transaction (rig, "MA" EOM, 3, "C", membuf, &mem_len);
      if (ret != RIG_OK)
            return ret;

      if (mem_len < 4)
            return -RIG_EPROTO;

      sscanf(membuf+1, "%d", ch);

      return RIG_OK;
}

/*
 * uniden_get_channel
 * Assumes rig!=NULL
 */
int uniden_get_channel(RIG *rig, channel_t *chan)
{
      char cmdbuf[BUFSZ], membuf[BUFSZ];
      size_t cmd_len=BUFSZ,mem_len=BUFSZ;
      int ret;
      int tone;

      if (chan->vfo == RIG_VFO_MEM)
            cmd_len = sprintf(cmdbuf, "PM%03d" EOM, chan->channel_num);
      else
            cmd_len = sprintf(cmdbuf, "MA" EOM);

      ret = uniden_transaction (rig, cmdbuf, cmd_len, "C", membuf, &mem_len);
      if (ret != RIG_OK)
            return ret;

      /*
       * 0123456789012345678901234567890123456789
       * C089 F08511625 TN DN LF AF RF N000
       */
      if (mem_len < 30 ||
                  membuf[5] != 'F' ||
                  membuf[25] != 'T' ||
                  membuf[28] != 'D' ||
                  membuf[31] != 'L' ||
                  membuf[34] != 'A' ||
                  membuf[37] != 'R' ||
                  membuf[40] != 'N')
            return -RIG_EPROTO;

      sscanf(membuf+1, "%d", &chan->channel_num);
      sscanf(membuf+6, "%"SCNfreq, &chan->freq);
      /* returned freq in hundreds of Hz */
      chan->freq *= 100;

      /* TODO: Trunk, Delay, Recording */

      chan->flags = (membuf[22] == 'N') ? RIG_CHFLAG_SKIP : 0;
      chan->levels[LVL_ATT].i = (membuf[25] == 'N') ? rig->state.attenuator[0] : 0;
      sscanf(membuf+41, "%d", &tone);
      if (tone >= 1 && tone <= 38)
            chan->ctcss_sql = rig->caps->ctcss_list[tone-1]; /* 1..38 */
      else if (tone > 38)
            chan->dcs_sql = rig->caps->dcs_list[tone-39]; /* 39..142 */

      if (chan->vfo == RIG_VFO_MEM && rig->caps->chan_desc_sz != 0)
      {
            /* only BC780 BC250 BC785 */
            cmd_len = sprintf(cmdbuf, "TA C %03d" EOM, chan->channel_num);

            ret = uniden_transaction (rig, cmdbuf, cmd_len, NULL, membuf, &mem_len);
            if (ret != RIG_OK)
                  return ret;
            if (mem_len < 10 || memcmp(membuf, cmdbuf, 8))
                  return -RIG_EPROTO;
            /*  TA C 001 My Alpha Tag */
            strncpy(chan->channel_desc, membuf+9, rig->caps->chan_desc_sz);
      }

      return RIG_OK;
}

/*
 * uniden_set_channel
 *
 * Only freq can be set?
 */
int uniden_set_channel(RIG *rig, const channel_t *chan)
{
      char cmdbuf[BUFSZ], membuf[BUFSZ];
      size_t cmd_len=BUFSZ,mem_len=BUFSZ;
      int ret;
      int trunked = 0;

      if (chan->vfo != RIG_VFO_MEM)
            return -RIG_EINVAL;

      /* PM089T08511625 */
      cmd_len = sprintf(cmdbuf, "PM%03d%c%08u" EOM, chan->channel_num,
                  trunked ? 'T' : ' ',
                  (unsigned)(chan->freq / 100));

      ret = uniden_transaction (rig, cmdbuf, cmd_len, NULL, membuf, &mem_len);
      if (ret != RIG_OK)
            return ret;

      if (chan->vfo == RIG_VFO_MEM && rig->caps->chan_desc_sz != 0)
      {
            /* only BC780 BC250 BC785 */
            cmd_len = sprintf(cmdbuf, "TA C %03d %s" EOM,
                        chan->channel_num, chan->channel_desc);

            ret = uniden_transaction (rig, cmdbuf, cmd_len, NULL, NULL, NULL);
            if (ret != RIG_OK)
                  return ret;
      }

      return RIG_OK;
}


/*
 * uniden_get_info
 * Assumes rig!=NULL
 */
const char * uniden_get_info(RIG *rig)
{
      static char infobuf[BUFSZ];
      size_t info_len=BUFSZ/2, vrinfo_len=BUFSZ/2;
      int ret;

      ret = uniden_transaction (rig, "SI" EOM, 3, NULL, infobuf, &info_len);
      if (ret != RIG_OK)
            return NULL;

      /* SI BC250D,0000000000,104  */

      if (info_len < 4)
            return NULL;

      if (info_len >= BUFSZ)
            info_len = BUFSZ-1;
      infobuf[info_len] = '\0';

      /* VR not on every rig */
      /* VR1.00 */
      ret = uniden_transaction (rig, "VR" EOM, 3, NULL, infobuf+info_len, &vrinfo_len);
      if (ret == RIG_OK)
      {
            /* overwrite "VR" */
            /* FIXME: need to filter \r or it screws w/ stdout */
            infobuf[info_len] = '\n';
            infobuf[info_len+1] = ' ';
      }
      else
      {
            infobuf[info_len] = '\0';
      }

      /* skip "SI " */
      return infobuf+3;
}


#define IDBUFSZ 32

/*
 * proberigs_uniden
 *
 * Notes:
 * There's only one rig possible per port.
 *
 * rig_model_t probeallrigs_uniden(port_t *port, rig_probe_func_t cfunc, rig_ptr_t data)
 */
DECLARE_PROBERIG_BACKEND(uniden)
{
      char idbuf[IDBUFSZ];
      int id_len=-1, i;
      int retval=-1;
      int rates[] = { 9600, 19200, 0 };   /* possible baud rates */
      int rates_idx;

      if (!port)
            return RIG_MODEL_NONE;

      if (port->type.rig != RIG_PORT_SERIAL)
            return RIG_MODEL_NONE;

      port->write_delay = port->post_write_delay = 0;
      port->parm.serial.stop_bits = 1;
      port->retry = 1;

      /*
       * try for all different baud rates
       */
      for (rates_idx = 0; rates[rates_idx]; rates_idx++) {
            port->parm.serial.rate = rates[rates_idx];
            port->timeout = 2*1000/rates[rates_idx] + 50;
      
            retval = serial_open(port);
            if (retval != RIG_OK)
                  return RIG_MODEL_NONE;
      
            retval = write_block(port, "SI"EOM, 3);
            id_len = read_string(port, idbuf, IDBUFSZ, EOM, 1);
            close(port->fd);

            if (retval != RIG_OK || id_len < 0)
                  continue;
      }

      if (retval != RIG_OK || id_len < 0 || memcmp(idbuf, "SI ", 3))
            return RIG_MODEL_NONE;

      /* 
       * reply should be something like 'SI xxx,xx,xx\x0d'
       */
      if (id_len < 4) {
            idbuf[id_len] = '\0';
            rig_debug(RIG_DEBUG_VERBOSE,"probe_uniden: protocol error,"
                              "  received %d: '%s'\n",
                              id_len, idbuf);
            return RIG_MODEL_NONE;
      }


      /* search ID string */
      for (i=0; uniden_id_string_list[i].model != RIG_MODEL_NONE; i++) {
            if (!memcmp(uniden_id_string_list[i].id, idbuf+3,
                              strlen(uniden_id_string_list[i].id))) {
                  rig_debug(RIG_DEBUG_VERBOSE,"probe_uniden: "
                                          "found '%s'\n", idbuf+3);
                  if (cfunc)
                        (*cfunc)(port, uniden_id_string_list[i].model, data);
                  return uniden_id_string_list[i].model;
            }
      }

      /*
       * not found in known table.... 
       * update uniden_id_list[]!
       */
      rig_debug(RIG_DEBUG_WARN,"probe_uniden: found unknown device "
                        "with ID '%s', please report to Hamlib "
                        "developers.\n", idbuf+3);

      return RIG_MODEL_NONE;
}

/*
 * initrigs_uniden is called by rig_backend_load
 */
DECLARE_INITRIG_BACKEND(uniden)
{
      rig_debug(RIG_DEBUG_VERBOSE, "uniden: _init called\n");

      rig_register(&bc895_caps);
      rig_register(&bc245_caps);
      rig_register(&bc780_caps);
      rig_register(&bc250_caps);

      rig_register(&pro2052_caps);

      rig_register(&bcd396t_caps);
      rig_register(&bcd996t_caps);

      return RIG_OK;
}




Generated by  Doxygen 1.6.0   Back to index