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

orion.h

Go to the documentation of this file.
/*
 *  Hamlib TenTenc backend - TT-565 headers
 *  Copyright (c) 2004-2006 by Stephane Fillod & Martin Ewing
 *
 *
 *   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.
 *
 */

/**
 * \addtogroup tentec_orion
 * @{ */

/**
 * \file orion.h
 * \brief Backend for Tentec Orion 565 / 566
 *
 * This documentation is experimental, to see how we can do it for the backends.
 * \n This backend tested mostly with firmware version 1.372
 */

#define TT565_BUFSIZE 16

/**
 * \brief Memory capability
 *
 * Orion's own  memory channel holds a freq, mode, and bandwidth.
 * May be captured from VFO A or B and applied to VFO A or B.
 * It cannot directly be read or written from the computer! 
 */
00043 #define TT565_MEM_CAP {        \
      .freq = 1,      \
      .mode = 1,      \
      .width = 1,     \
}

static int tt565_init(RIG *rig);
static int tt565_cleanup(RIG *rig);
static int tt565_set_freq(RIG *rig, vfo_t vfo, freq_t freq);
static int tt565_get_freq(RIG *rig, vfo_t vfo, freq_t *freq);
static int tt565_set_vfo(RIG *rig, vfo_t vfo);
static int tt565_get_vfo(RIG *rig, vfo_t *vfo);
static int tt565_set_mode(RIG *rig, vfo_t vfo, rmode_t mode, pbwidth_t width);
static int tt565_get_mode(RIG *rig, vfo_t vfo, rmode_t *mode, pbwidth_t *width);
static int tt565_set_split_vfo(RIG *rig, vfo_t vfo, split_t split, vfo_t tx_vfo);
static int tt565_get_split_vfo(RIG *rig, vfo_t vfo, split_t *split, vfo_t *tx_vfo);
static int tt565_set_ptt(RIG *rig, vfo_t vfo, ptt_t ptt);
static int tt565_get_ptt(RIG *rig, vfo_t vfo, ptt_t *ptt);
static int tt565_reset(RIG *rig, reset_t reset);
static int tt565_set_mem(RIG * rig, vfo_t vfo, int ch);
static int tt565_get_mem(RIG * rig, vfo_t vfo, int *ch);
static int tt565_vfo_op(RIG * rig, vfo_t vfo, vfo_op_t op);
static int tt565_set_ts(RIG *rig, vfo_t vfo, shortfreq_t ts);
static int tt565_get_ts(RIG *rig, vfo_t vfo, shortfreq_t *ts);
static int tt565_set_rit(RIG * rig, vfo_t vfo, shortfreq_t rit);
static int tt565_get_rit(RIG * rig, vfo_t vfo, shortfreq_t *rit);
static int tt565_set_xit(RIG * rig, vfo_t vfo, shortfreq_t xit);
static int tt565_get_xit(RIG * rig, vfo_t vfo, shortfreq_t *xit);
static int tt565_set_level(RIG * rig, vfo_t vfo, setting_t level, value_t val);
static int tt565_get_level(RIG * rig, vfo_t vfo, setting_t level, value_t *val);
static const char* tt565_get_info(RIG *rig);
static int tt565_send_morse(RIG *rig, vfo_t vfo, const char *msg);
static int tt565_get_func(RIG *rig, vfo_t vfo, setting_t func, int *status);
static int tt565_set_func(RIG *rig, vfo_t vfo, setting_t func, int status);
static int tt565_set_ant(RIG * rig, vfo_t vfo, ant_t ant);
static int tt565_get_ant(RIG *rig, vfo_t vfo, ant_t *ant);

/** \brief Orion private data */
00081 struct tt565_priv_data {
00082       int ch;           /*!< memory channel */
00083       vfo_t vfo_curr; /*!< Currently selected VFO */
};

/** \brief Orion Supported Modes */
00087 #define TT565_MODES (RIG_MODE_FM|RIG_MODE_CW|RIG_MODE_CWR|RIG_MODE_SSB|\
                  RIG_MODE_RTTY|RIG_MODE_AM)
/** \brief Orion Receiver Modes */
00090 #define TT565_RXMODES (TT565_MODES)

/** \brief Orion Supported Functions */
00093 #define TT565_FUNCS (RIG_FUNC_LOCK|RIG_FUNC_TUNER|RIG_FUNC_VOX|RIG_FUNC_NB)

/** \brief Orion Supported Levels */
00096 #define TT565_LEVELS (RIG_LEVEL_RAWSTR| \
                        RIG_LEVEL_CWPITCH| \
                        RIG_LEVEL_SQL|RIG_LEVEL_IF| \
                        RIG_LEVEL_RFPOWER|RIG_LEVEL_KEYSPD| \
                        RIG_LEVEL_RF|RIG_LEVEL_NR| \
                        RIG_LEVEL_MICGAIN| \
                        RIG_LEVEL_AF|RIG_LEVEL_AGC| \
                        RIG_LEVEL_VOXGAIN|RIG_LEVEL_VOX|RIG_LEVEL_ANTIVOX| \
                        RIG_LEVEL_COMP|RIG_LEVEL_PREAMP| \
                        RIG_LEVEL_SWR|RIG_LEVEL_ATT)

/** \brief Orion Tx/Rx Antennas*/
00108 #define TT565_ANTS (RIG_ANT_1|RIG_ANT_2) 
/** \brief Orion Rx Antennas*/
00110 #define TT565_RXANTS (TT565_ANTS|RIG_ANT_3) 

/** \brief Orion Parameters */
00113 #define TT565_PARMS (RIG_PARM_NONE)

/**
 * \brief Orion VFOs - A and B
 */
00118 #define TT565_VFO (RIG_VFO_A|RIG_VFO_B)
/**
 * \brief Orion VFO Operations
 *
 * Allowed operations
 */
00124 #define TT565_VFO_OPS (RIG_OP_UP|RIG_OP_DOWN|\
            RIG_OP_TO_VFO|RIG_OP_FROM_VFO| \
            RIG_OP_TUNE)

/**
 * \brief S-Meter Calibration list
 *
 * List format: { hardware units, dB relative to S9}
 *
 * This calibration function is likely to be different
 * for different firmware releases and between the Orion (565) and
 * Orion II (566).  How to handle distinguish these cases?
 *
 * Checked on one physical unit 3/29/05 (v 1.372 probably) 
 */
00139 #define TT565_STR_CAL { 15,  { \
            {  10, -45 }, /* S 1.5 min meter indication */ \
                {  13, -42 }, \
                {  18, -36 }, \
                {  22, -30 }, \
                {  27, -24 }, \
                {  30, -18 }, \
                {  34, -12 }, \
                {  38,  -6 }, \
                {  43,   0 }, /* S9 */ \
                {  48,  10 }, \
                {  55,  20 }, \
                {  62,  30 }, \
                {  70,  40 }, \
                {  78,  48 }, /* severe dsp quantization error */ \
                { 101,  65 }, /* at high end of scale */ \
        } }

#undef TT565_TIME       /* Define to enable time checks */

/**
 * 
 * \brief tt565 transceiver capabilities.
 *
 * All of the Orion's personality is defined here!
 *
 * Protocol is documented at Tentec's firmware site
 *          http://www.rfsquared.com/
 */
00168 const struct rig_caps tt565_caps = {
.rig_model =  RIG_MODEL_TT565,
.model_name = "TT-565 Orion",
.mfg_name =  "Ten-Tec",
.version =  "0.3",
.copyright =  "LGPL",
.status =  RIG_STATUS_BETA,
.rig_type =  RIG_TYPE_TRANSCEIVER,
.ptt_type =  RIG_PTT_RIG,
.dcd_type =  RIG_DCD_NONE,
.port_type =  RIG_PORT_SERIAL,
.serial_rate_min =  57600,
.serial_rate_max =  57600,
.serial_data_bits =  8,
.serial_stop_bits =  1,
.serial_parity =  RIG_PARITY_NONE,
.serial_handshake =  RIG_HANDSHAKE_HARDWARE,
.write_delay =  0,
.post_write_delay =  10,      /* Needed for CW send + ?? */
.timeout =  400,
.retry =  3,

.has_get_func =  TT565_FUNCS,
.has_set_func =  TT565_FUNCS,
.has_get_level =  TT565_LEVELS,
.has_set_level =  RIG_LEVEL_SET(TT565_LEVELS),
.has_get_parm =  TT565_PARMS,
.has_set_parm =  TT565_PARMS,

.level_gran = {}, 
.parm_gran =  {},
.ctcss_list =  NULL,
.dcs_list =  NULL,
.preamp =   { 20, RIG_DBLST_END },
.attenuator =   { 6, 12, 18, RIG_DBLST_END },
.max_rit =  kHz(8),
.max_xit =  kHz(8),
.max_ifshift =  kHz(8),
.vfo_ops = TT565_VFO_OPS,
.targetable_vfo =  RIG_TARGETABLE_ALL,
.transceive =  RIG_TRN_OFF,
.bank_qty =   0,
.chan_desc_sz =  0,

.chan_list =  {
            {   0, 199, RIG_MTYPE_MEM, TT565_MEM_CAP },
            },

.rx_range_list1 =  {
      FRQ_RNG_HF(1,TT565_RXMODES, -1,-1,RIG_VFO_N(0),TT565_RXANTS),
      {kHz(500),MHz(30),TT565_RXMODES,-1,-1,RIG_VFO_N(1),TT565_RXANTS},
      RIG_FRNG_END,
  },
.tx_range_list1 =  {
      FRQ_RNG_HF(1,TT565_MODES, W(5),W(100),RIG_VFO_N(0),TT565_ANTS),
      RIG_FRNG_END,
  },

.rx_range_list2 =  {
      FRQ_RNG_HF(2,TT565_RXMODES, -1,-1,RIG_VFO_N(0),TT565_RXANTS),
      {MHz(5.25),MHz(5.40),TT565_RXMODES,-1,-1,RIG_VFO_N(0),TT565_RXANTS},
      {kHz(500),MHz(30),TT565_RXMODES,-1,-1,RIG_VFO_N(1),TT565_RXANTS},
      RIG_FRNG_END,
  },
.tx_range_list2 =  {
      FRQ_RNG_HF(2,TT565_MODES, W(5),W(100),RIG_VFO_N(0),TT565_ANTS),
      {MHz(5.25),MHz(5.40),TT565_MODES,W(5),W(100),RIG_VFO_N(0),TT565_ANTS},
      RIG_FRNG_END,
  },

.tuning_steps =  {
       {TT565_RXMODES,1},
       {TT565_RXMODES,10},
       {TT565_RXMODES,100},
       {TT565_RXMODES,kHz(1)},
       {TT565_RXMODES,kHz(10)},
       {TT565_RXMODES,kHz(100)},
       RIG_TS_END,
      },
        /* mode/filter list, remember: order matters! */
.filters =  {
      /* 9MHz IF filters: 15kHz, 6kHz, 2.4kHz, 1.0kHz */
      /* opt: 1.8kHz, 500Hz, 250Hz */
            {RIG_MODE_CW|RIG_MODE_CWR|RIG_MODE_SSB|RIG_MODE_RTTY, kHz(2.4)},
            {RIG_MODE_CW|RIG_MODE_CWR|RIG_MODE_SSB|RIG_MODE_RTTY, 100},
            {RIG_MODE_CW|RIG_MODE_CWR|RIG_MODE_SSB|RIG_MODE_RTTY, kHz(6)},
            {RIG_MODE_CW|RIG_MODE_CWR|RIG_MODE_SSB|RIG_MODE_RTTY, 0}, /* 590 filters */
            {RIG_MODE_AM, kHz(6)},
            {RIG_MODE_AM, kHz(4)},
            {RIG_MODE_FM, kHz(15)},
            RIG_FLT_END,
      },
.priv =  (void*)NULL,

.rig_init =  tt565_init,
.rig_cleanup =  tt565_cleanup,

.set_freq =  tt565_set_freq,
.get_freq =  tt565_get_freq,
.set_vfo =  tt565_set_vfo,
.get_vfo =  tt565_get_vfo,
.set_mode =  tt565_set_mode,
.get_mode =  tt565_get_mode,
.set_split_vfo =  tt565_set_split_vfo,
.get_split_vfo =  tt565_get_split_vfo,
.set_level =  tt565_set_level,
.get_level =  tt565_get_level,
.set_mem =  tt565_set_mem,
.get_mem =  tt565_get_mem,
.set_ptt =  tt565_set_ptt,
.get_ptt =  tt565_get_ptt,
.vfo_op =  tt565_vfo_op,
.set_ts =  tt565_set_ts,
.get_ts =  tt565_get_ts,
.set_rit =  tt565_set_rit,
.get_rit =  tt565_get_rit,
.set_xit =  tt565_set_xit,
.get_xit =  tt565_get_xit,
.reset =  tt565_reset,
.get_info =  tt565_get_info,
.send_morse = tt565_send_morse,
.get_func = tt565_get_func,
.set_func = tt565_set_func,
.get_ant = tt565_get_ant,
.set_ant = tt565_set_ant,

.str_cal = TT565_STR_CAL,
};

/*
 * Function definitions below
 */

/** \brief End of command marker */
00302 #define EOM "\015"      /* CR */
/** \brief USB Mode */
00304 #define TT565_USB '0'
/** \brief LSB Mode */
00306 #define TT565_LSB '1'
/** \brief CW normal Mode */
00308 #define TT565_CW  '2'
/** \brief CW reverse Mode */
00310 #define TT565_CWR '3'
/** \brief AM Mode */
00312 #define TT565_AM  '4'
/** \brief FM Mode */
00314 #define TT565_FM  '5'
/** \brief RTTY Mode */
00316 #define TT565_RTTY '6'

/** \brief minimum sidetone freq., Hz */
00319 #define TT565_TONE_MIN 300
/** \brief maximum sidetone freq., Hz */
00321 #define TT565_TONE_MAX 1200

/** \brief minimum CW keyer rate, wpm */
00324 #define TT565_CW_MIN 10
/** \brief maximum CW keyer rate, wpm */
00326 #define TT565_CW_MAX 60

/** @} */

Generated by  Doxygen 1.6.0   Back to index