kopia lustrzana https://github.com/Hamlib/Hamlib
671 wiersze
22 KiB
C
671 wiersze
22 KiB
C
/* hamlib - (C) Frank Singleton 2000 (vk3fcs@ix.netcom.com)
|
|
*
|
|
* rig.h - Copyright (C) 2000 Frank Singleton and Stephane Fillod
|
|
* This program defines the Hamlib API and rig capabilities structures that
|
|
* will be used for obtaining rig capabilities.
|
|
*
|
|
*
|
|
* $Id: rig.h,v 1.8 2000-10-30 21:45:27 f4cfe Exp $ *
|
|
*
|
|
*
|
|
* This program is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU 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 General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU General Public License
|
|
* along with this program; if not, write to the Free Software
|
|
* Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
|
|
*
|
|
*/
|
|
|
|
#ifndef _RIG_H
|
|
#define _RIG_H 1
|
|
|
|
#include <hamlib/riglist.h> /* list in another file to not mess up w/ this one */
|
|
#include <stdio.h> /* required for FILE definition */
|
|
#include <sys/time.h> /* required for struct timeval */
|
|
|
|
/*
|
|
* Error codes that can be returned by the Hamlib functions
|
|
*/
|
|
#define RIG_OK 0 /* completed sucessfully */
|
|
#define RIG_EINVAL 1 /* invalid parameter */
|
|
#define RIG_ECONF 2 /* invalid configuration (serial,..) */
|
|
#define RIG_ENOMEM 3 /* memory shortage */
|
|
#define RIG_ENIMPL 4 /* function not implemented, but will be */
|
|
#define RIG_ETIMEOUT 5 /* communication timed out */
|
|
#define RIG_EIO 6 /* IO error, including open failed */
|
|
#define RIG_EINTERNAL 7 /* Internal Hamlib error, huh! */
|
|
#define RIG_EPROTO 8 /* Protocol error */
|
|
#define RIG_ERJCTED 9 /* Command rejected by the rig */
|
|
#define RIG_ETRUNC 10 /* Command performed, but arg truncated */
|
|
#define RIG_ENAVAIL 11 /* function not available */
|
|
|
|
|
|
/* Forward struct references */
|
|
|
|
struct rig;
|
|
struct rig_state;
|
|
|
|
typedef struct rig RIG;
|
|
|
|
|
|
|
|
/*
|
|
* REM: Numeric order matters for debug level
|
|
*/
|
|
enum rig_debug_level_e {
|
|
RIG_DEBUG_NONE = 0,
|
|
RIG_DEBUG_ERR,
|
|
RIG_DEBUG_VERBOSE,
|
|
RIG_DEBUG_TRACE
|
|
};
|
|
|
|
/*
|
|
* Rig capabilities
|
|
*
|
|
* Basic rig type, can store some useful
|
|
* info about different radios. Each lib must
|
|
* be able to populate this structure, so we can make
|
|
* useful enquiries about capablilities.
|
|
*/
|
|
|
|
|
|
|
|
enum rig_port_e {
|
|
RIG_PORT_SERIAL = 0,
|
|
RIG_PORT_NETWORK,
|
|
RIG_PORT_DEVICE, /* Device driver, like for the WinRADIO */
|
|
RIG_PORT_ULTRA /* IrDA Ultra protocol! */
|
|
};
|
|
|
|
enum serial_parity_e {
|
|
RIG_PARITY_NONE = 0,
|
|
RIG_PARITY_ODD,
|
|
RIG_PARITY_EVEN
|
|
};
|
|
|
|
enum serial_handshake_e {
|
|
RIG_HANDSHAKE_NONE = 0,
|
|
RIG_HANDSHAKE_XONXOFF,
|
|
RIG_HANDSHAKE_HARDWARE
|
|
};
|
|
|
|
|
|
enum rig_type_e {
|
|
RIG_TYPE_TRANSCEIVER = 0, /* aka base station */
|
|
RIG_TYPE_HANDHELD,
|
|
RIG_TYPE_MOBILE,
|
|
RIG_TYPE_RECEIVER,
|
|
RIG_TYPE_SCANNER,
|
|
RIG_TYPE_COMPUTER, /* eg. Pegasus */
|
|
/* etc. */
|
|
RIG_TYPE_OTHER
|
|
};
|
|
|
|
/*
|
|
* Development status of the backend
|
|
*/
|
|
enum rig_status_e {
|
|
RIG_STATUS_ALPHA = 0,
|
|
RIG_STATUS_UNTESTED, /* written from specs, rig unavailable for test, feedback most wanted! */
|
|
RIG_STATUS_BETA,
|
|
RIG_STATUS_STABLE,
|
|
RIG_STATUS_BUGGY, /* was stable, but something broke it! */
|
|
RIG_STATUS_NEW
|
|
};
|
|
|
|
enum rptr_shift_e {
|
|
RIG_RPT_SHIFT_NONE = 0,
|
|
RIG_RPT_SHIFT_MINUS,
|
|
RIG_RPT_SHIFT_PLUS
|
|
};
|
|
|
|
typedef enum rptr_shift_e rptr_shift_t;
|
|
|
|
enum split_e {
|
|
RIG_SPLIT_OFF = 0,
|
|
RIG_SPLIT_ON,
|
|
};
|
|
|
|
typedef enum split_e split_t;
|
|
|
|
enum vfo_e {
|
|
RIG_VFO_MAIN = 0,
|
|
RIG_VFO_SUB,
|
|
RIG_VFO_SAT,
|
|
RIG_VFO_A = RIG_VFO_MAIN,
|
|
RIG_VFO_B = RIG_VFO_SUB,
|
|
RIG_VFO_C = RIG_VFO_SAT
|
|
};
|
|
|
|
typedef enum vfo_e vfo_t;
|
|
|
|
enum passband_width_e {
|
|
RIG_PASSBAND_NORMAL = 0,
|
|
RIG_PASSBAND_NARROW,
|
|
RIG_PASSBAND_WIDE
|
|
};
|
|
|
|
typedef enum passband_width_e pbwidth_t;
|
|
|
|
enum ptt_e {
|
|
RIG_PTT_OFF = 0,
|
|
RIG_PTT_ON
|
|
};
|
|
|
|
typedef enum ptt_e ptt_t;
|
|
|
|
enum ptt_type_e {
|
|
RIG_PTT_RIG = 0, /* legacy PTT */
|
|
RIG_PTT_SERIAL, /* PTT accessed through CTS/RTS */
|
|
RIG_PTT_PARALLEL, /* PTT accessed through DATA0 */
|
|
RIG_PTT_NONE /* not available */
|
|
};
|
|
|
|
typedef enum ptt_type_e ptt_type_t;
|
|
|
|
|
|
enum mem_vfo_op_e {
|
|
RIG_MVOP_VFO_MODE = 0,
|
|
RIG_MVOP_MEM_MODE,
|
|
RIG_MVOP_VFO_CPY, /* VFO A = VFO B */
|
|
RIG_MVOP_VFO_XCHG, /* Exchange VFO A/B */
|
|
RIG_MVOP_DUAL_OFF, /* Dual watch off */
|
|
RIG_MVOP_DUAL_ON, /* Dual watch on */
|
|
RIG_MVOP_FROM_VFO, /* VFO->MEM */
|
|
RIG_MVOP_TO_VFO, /* MEM->VFO */
|
|
RIG_MVOP_MCL /* Memory clear */
|
|
};
|
|
|
|
typedef enum mem_vfo_op_e mv_op_t;
|
|
|
|
|
|
/* When optional speech synthesizer is installed */
|
|
enum ann_level_e {
|
|
RIG_ANN_OFF = 0,
|
|
RIG_ANN_FREQ,
|
|
RIG_ANN_RXMODE,
|
|
RIG_ANN_ALL
|
|
};
|
|
|
|
enum agc_level_e {
|
|
RIG_AGC_OFF = 0,
|
|
RIG_AGC_SUPERFAST,
|
|
RIG_AGC_FAST,
|
|
RIG_AGC_SLOW
|
|
};
|
|
|
|
/*
|
|
* Universal approach for use by set_level/get_level
|
|
*/
|
|
union value_u {
|
|
int i;
|
|
float f;
|
|
};
|
|
typedef union value_u value_t;
|
|
|
|
#define RIG_LEVEL_PREAMP (1<<0) /* Preamp, arg int (db) */
|
|
#define RIG_LEVEL_ATT (1<<1) /* Attenuator, arg int (db) */
|
|
#define RIG_LEVEL_ANT (1<<2) /* Antenna, arg int (numbering from 0) */
|
|
#define RIG_LEVEL_AF (1<<3) /* Volume, arg float [0.0..1.0] */
|
|
#define RIG_LEVEL_RF (1<<4) /* RF gain (not TX power), arg float [0.0..1.0] */
|
|
#define RIG_LEVEL_SQL (1<<5) /* Squelch, arg float [0.0 .. 1.0] */
|
|
#define RIG_LEVEL_IF (1<<6) /* IF, arg int (Hz) */
|
|
#define RIG_LEVEL_APF (1<<7) /* APF?, arg float [0.0 .. 1.0] */
|
|
#define RIG_LEVEL_NR (1<<8) /* Noise Reduction, arg float [0.0 .. 1.0] */
|
|
#define RIG_LEVEL_PBT_IN (1<<9) /* Twin PBT (inside), arg float [0.0 .. 1.0] */
|
|
#define RIG_LEVEL_PBT_OUT (1<<10) /* Twin PBT (outside), arg float [0.0 .. 1.0] */
|
|
#define RIG_LEVEL_CWPITCH (1<<11) /* CW pitch, arg int (Hz) */
|
|
#define RIG_LEVEL_RFPOWER (1<<12) /* RF Power, arg float [0.0 .. 1.0] */
|
|
#define RIG_LEVEL_MICGAIN (1<<13) /* MIC Gain, arg float [0.0 .. 1.0] */
|
|
#define RIG_LEVEL_KEYSPD (1<<14) /* Key Speed, arg int (WPM) */
|
|
#define RIG_LEVEL_NOTCHF (1<<15) /* Notch Freq., arg int (Hz) */
|
|
#define RIG_LEVEL_COMP (1<<16) /* Compressor, arg float [0.0 .. 1.0] */
|
|
#define RIG_LEVEL_AGC (1<<17) /* AGC, arg int (see enum agc_level_e) */
|
|
#define RIG_LEVEL_BKINDL (1<<18) /* BKin Delay, arg int (tenth of dots) */
|
|
#define RIG_LEVEL_BALANCE (1<<19) /* Balance (Dual Watch), arg float [0.0 .. 1.0] */
|
|
#define RIG_LEVEL_ANN (1<<20) /* Announce, arg int (see enum ann_level_e) */
|
|
/* These ones are not settable */
|
|
#define RIG_LEVEL_SQLSTAT (1<<30) /* SQL status, arg int (open=1/closed=0) */
|
|
#define RIG_LEVEL_STRENGTH (1<<31) /* Signal strength, arg int (db) */
|
|
|
|
typedef unsigned long setting_t; /* at least 32 bits */
|
|
|
|
/*
|
|
* tranceive mode, ie. the rig notify the host of any event,
|
|
* like freq changed, mode changed, etc.
|
|
*/
|
|
#define RIG_TRN_OFF 0
|
|
#define RIG_TRN_ON 1
|
|
|
|
|
|
/*
|
|
* These are activated functions.
|
|
*/
|
|
#define RIG_FUNC_FAGC (1<<0) /* Fast AGC */
|
|
#define RIG_FUNC_NB (1<<1) /* Noise Blanker */
|
|
#define RIG_FUNC_COMP (1<<2) /* Compression */
|
|
#define RIG_FUNC_VOX (1<<3) /* VOX */
|
|
#define RIG_FUNC_TONE (1<<4) /* Tone */
|
|
#define RIG_FUNC_TSQL (1<<5) /* may require a tone field */
|
|
#define RIG_FUNC_SBKIN (1<<6) /* Semi Break-in (is it the rigth name?) */
|
|
#define RIG_FUNC_FBKIN (1<<7) /* Full Break-in, for CW mode */
|
|
#define RIG_FUNC_ANF (1<<8) /* Automatic Notch Filter (DSP) */
|
|
#define RIG_FUNC_NR (1<<9) /* Noise Reduction (DSP) */
|
|
|
|
|
|
|
|
/*
|
|
* frequency type in Hz, must be >32bits for SHF!
|
|
*/
|
|
typedef long long freq_t;
|
|
|
|
#define Hz(f) ((freq_t)(f))
|
|
#define KHz(f) ((freq_t)((f)*1000))
|
|
#define MHz(f) ((freq_t)((f)*1000000L))
|
|
#define GHz(f) ((freq_t)((f)*1000000000LL))
|
|
|
|
/*
|
|
* power unit macros, converts to mW
|
|
*/
|
|
#define mW(p) ((int)(p))
|
|
#define Watts(p) ((int)((p)*1000))
|
|
#define KW(p) ((int)((p)*1000000L))
|
|
|
|
typedef unsigned int rmode_t; /* radio mode */
|
|
|
|
/* Do not use an enum since this will be used w/ rig_mode_t bit fields */
|
|
#define RIG_MODE_NONE 0
|
|
#define RIG_MODE_AM (1<<0)
|
|
#define RIG_MODE_CW (1<<1)
|
|
#define RIG_MODE_USB (1<<2) /* select somewhere else the filters ? */
|
|
#define RIG_MODE_LSB (1<<3)
|
|
#define RIG_MODE_RTTY (1<<4)
|
|
#define RIG_MODE_FM (1<<5)
|
|
|
|
/* The following are deprecated */
|
|
/* use the get/set_filter to manipulate these bits */
|
|
#if 0
|
|
#define RIG_MODE_WFM (1<<6)
|
|
#define RIG_MODE_CWR (1<<7) /* CW reverse sideband*/
|
|
#define RIG_MODE_RTTYR (1<<8) /* RTTY reverse sideband */
|
|
|
|
#define RIG_MODE_NFM (1<<19) /* should we distinguish modes w/ filers? */
|
|
#define RIG_MODE_NAM (1<<20) /* Narrow AM */
|
|
#define RIG_MODE_WAM (1<<9) /* Wide AM */
|
|
#define RIG_MODE_NCW (1<<10)
|
|
#define RIG_MODE_WCW (1<<11)
|
|
#define RIG_MODE_NUSB (1<<13)
|
|
#define RIG_MODE_WUSB (1<<14)
|
|
#define RIG_MODE_NLSB (1<<15)
|
|
#define RIG_MODE_WLSB (1<<16)
|
|
#define RIG_MODE_NRTTY (1<<17)
|
|
#define RIG_MODE_WRTTY (1<<18)
|
|
#endif
|
|
|
|
|
|
#define RIGNAMSIZ 30
|
|
#define RIGVERSIZ 8
|
|
#define FILPATHLEN 100
|
|
#define FRQRANGESIZ 30
|
|
#define MAXCHANDESC 30 /* describe channel eg: "WWV 5Mhz" */
|
|
#define TSLSTSIZ 20 /* max tuning step list size, zero ended */
|
|
|
|
|
|
/*
|
|
* Put together a bunch of this struct in an array to define
|
|
* what your rig have access to
|
|
*/
|
|
struct freq_range_list {
|
|
freq_t start;
|
|
freq_t end;
|
|
rmode_t modes; /* bitwise OR'ed RIG_MODE_* */
|
|
int low_power; /* in mW, -1 for no power (ie. rx list) */
|
|
int high_power; /* in mW, -1 for no power (ie. rx list) */
|
|
};
|
|
typedef struct freq_range_list freq_range_t;
|
|
|
|
/*
|
|
* Lists the tuning steps available for each mode
|
|
*/
|
|
struct tuning_step_list {
|
|
rmode_t modes; /* bitwise OR'ed RIG_MODE_* */
|
|
unsigned long ts; /* tuning step in Hz */
|
|
};
|
|
|
|
|
|
|
|
/*
|
|
* Convenience struct, describes a freq/vfo/mode combo
|
|
* Also useful for memory handling -- FS
|
|
*
|
|
*/
|
|
|
|
struct channel {
|
|
int channel_num;
|
|
freq_t freq;
|
|
rmode_t mode;
|
|
vfo_t vfo;
|
|
int power; /* in mW */
|
|
int att; /* in db */
|
|
int preamp; /* in db */
|
|
int ant; /* antenna number */
|
|
unsigned long tuning_step; /* */
|
|
unsigned char channel_desc[MAXCHANDESC];
|
|
};
|
|
|
|
typedef struct channel channel_t;
|
|
|
|
/* Basic rig type, can store some useful
|
|
* info about different radios. Each lib must
|
|
* be able to populate this structure, so we can make
|
|
* useful enquiries about capablilities.
|
|
*/
|
|
|
|
/*
|
|
* The main idea of this struct is that it will be defined by the backend
|
|
* rig driver, and will remain readonly for the application.
|
|
* Fields that need to be modifiable by the application are
|
|
* copied into the struct rig_state, which is a kind of private
|
|
* of the RIG instance.
|
|
* This way, you can have several rigs running within the same application,
|
|
* sharing the struct rig_caps of the backend, while keeping their own
|
|
* customized data.
|
|
*/
|
|
struct rig_caps {
|
|
rig_model_t rig_model; /* eg. RIG_MODEL_FT847 */
|
|
unsigned char model_name[RIGNAMSIZ]; /* eg "ft847" */
|
|
unsigned char mfg_name[RIGNAMSIZ]; /* eg "Yeasu" */
|
|
char version[RIGVERSIZ]; /* driver version, eg "0.5" */
|
|
enum rig_status_e status; /* among ALPHA, BETA, STABLE, NEW */
|
|
enum rig_type_e rig_type;
|
|
enum ptt_type_e ptt_type; /* how we will key the rig */
|
|
int serial_rate_min; /* eg 4800 */
|
|
int serial_rate_max; /* eg 9600 */
|
|
int serial_data_bits; /* eg 8 */
|
|
int serial_stop_bits; /* eg 2 */
|
|
enum serial_parity_e serial_parity; /* */
|
|
enum serial_handshake_e serial_handshake; /* */
|
|
int write_delay; /* delay in ms between each byte sent out */
|
|
int post_write_delay; /* optional delay after sending last cmd sequence (yaesu) -- FS */
|
|
int timeout; /* in ms */
|
|
int retry; /* maximum number of retries, 0 to disable */
|
|
setting_t has_func; /* bitwise OR'ed RIG_FUNC_FAGC, NG, etc. */
|
|
setting_t has_level; /* bitwise OR'ed RIG_LEVEL_* */
|
|
setting_t has_set_level; /* bitwise OR'ed RIG_LEVEL_* */
|
|
int chan_qty; /* number of channels */
|
|
#if 0
|
|
int chan_desc_sz; /* memory channel size, 0 if none */
|
|
#endif
|
|
int transceive; /* the rig is able to generate events, to be used by callbacks */
|
|
freq_range_t rx_range_list[FRQRANGESIZ];
|
|
freq_range_t tx_range_list[FRQRANGESIZ];
|
|
struct tuning_step_list tuning_steps[TSLSTSIZ];
|
|
|
|
/*
|
|
* Rig Admin API
|
|
*
|
|
*/
|
|
|
|
int (*rig_init)(RIG *rig); /* setup *priv */
|
|
int (*rig_cleanup)(RIG *rig);
|
|
int (*rig_open)(RIG *rig); /* called when port just opened */
|
|
int (*rig_close)(RIG *rig); /* called before port is to close */
|
|
int (*rig_probe)(RIG *rig); /* Experimental: may work.. */
|
|
|
|
/*
|
|
* General API commands, from most primitive to least.. :()
|
|
* List Set/Get functions pairs
|
|
*/
|
|
|
|
int (*set_freq)(RIG *rig, freq_t freq); /* select freq */
|
|
int (*get_freq)(RIG *rig, freq_t *freq); /* get freq */
|
|
|
|
int (*set_mode)(RIG *rig, rmode_t mode); /* select mode */
|
|
int (*get_mode)(RIG *rig, rmode_t *mode); /* get mode */
|
|
|
|
int (*set_vfo)(RIG *rig, vfo_t vfo); /* select vfo (A,B, etc.) */
|
|
int (*get_vfo)(RIG *rig, vfo_t *vfo); /* get vfo */
|
|
|
|
int (*set_ptt)(RIG *rig, ptt_t ptt); /* ptt on/off */
|
|
int (*get_ptt)(RIG *rig, ptt_t *ptt); /* get ptt status */
|
|
|
|
int (*set_passband)(RIG *rig, pbwidth_t width); /* select width */
|
|
int (*get_passband)(RIG *rig, pbwidth_t *width); /* get width */
|
|
|
|
int (*set_rptr_shift)(RIG *rig, rptr_shift_t rptr_shift); /* set repeater shift */
|
|
int (*get_rptr_shift)(RIG *rig, rptr_shift_t *rptr_shift); /* get repeater shift */
|
|
|
|
int (*set_rptr_offs)(RIG *rig, unsigned long offs);/*set duplex offset freq*/
|
|
int (*get_rptr_offs)(RIG *rig, unsigned long *offs);/*get duplex offset freq*/
|
|
|
|
int (*set_split_freq)(RIG *rig, freq_t rx_freq, freq_t tx_freq);
|
|
int (*get_split_freq)(RIG *rig, freq_t *rx_freq, freq_t *tx_freq);
|
|
int (*set_split)(RIG *rig, split_t split);
|
|
int (*get_split)(RIG *rig, split_t *split);
|
|
|
|
int (*set_ts)(RIG *rig, unsigned long ts); /* set tuning step */
|
|
int (*get_ts)(RIG *rig, unsigned long *ts); /* get tuning step */
|
|
|
|
int (*set_dcs)(RIG *rig, unsigned int code);
|
|
int (*get_dcs)(RIG *rig, unsigned int *code);
|
|
int (*set_ctcss)(RIG *rig, unsigned int tone);
|
|
int (*get_ctcss)(RIG *rig, unsigned int *tone);
|
|
|
|
/*
|
|
* It'd be nice to have a power2mW and mW2power functions
|
|
* that could tell at what power (watts) the rig is running.
|
|
* Unfortunately, on most rigs, the formula is not the same
|
|
* on all bands/modes. Have to work this out.. --SF
|
|
*/
|
|
int (*power2mW)(RIG *rig, unsigned int *mwpower, float power, freq_t freq, rmode_t mode);
|
|
int (*mW2power)(RIG *rig, float *power, unsigned int mwpower, freq_t freq, rmode_t mode);
|
|
|
|
int (*set_poweron)(RIG *rig);
|
|
int (*set_poweroff)(RIG *rig);
|
|
|
|
int (*set_level)(RIG *rig, setting_t level, value_t val);/* set level setting */
|
|
int (*get_level)(RIG *rig, setting_t level, value_t *val);/* set level setting*/
|
|
|
|
int (*set_func)(RIG *rig, setting_t func, int status); /* activate the function(s) */
|
|
int (*get_func)(RIG *rig, setting_t *func); /* get the setting from rig */
|
|
|
|
int (*set_bank)(RIG *rig, int bank); /* set memory bank number */
|
|
int (*set_mem)(RIG *rig, int ch); /* set memory channel number */
|
|
int (*get_mem)(RIG *rig, int *ch); /* get memory channel number */
|
|
int (*mv_ctl)(RIG *rig, mv_op_t op); /* Mem/VFO operation */
|
|
|
|
int (*set_trn)(RIG *rig, int trn); /* activate transceive mode on radio */
|
|
int (*get_trn)(RIG *rig, int *trn); /* PCR-1000 can do that, ICR75 too */
|
|
|
|
|
|
int (*decode_event)(RIG *rig); /* When transceive on, find out which callback to call, and call it */
|
|
|
|
/*
|
|
* Convenience Functions
|
|
*/
|
|
|
|
int (*set_channel)(RIG *rig, const channel_t *chan);
|
|
int (*get_channel)(RIG *rig, channel_t *chan);
|
|
|
|
/* more to come... */
|
|
};
|
|
|
|
/*
|
|
* example of 3.5MHz -> 3.8MHz, 100W transmit range
|
|
* tx_range_list = {{3500000,3800000,RIG_MODE_AM|RIG_MODE_CW,100000},0}
|
|
*
|
|
*/
|
|
|
|
|
|
/*
|
|
* Rig state
|
|
*/
|
|
struct rig_state {
|
|
enum rig_port_e port_type; /* serial, network, etc. */
|
|
int serial_rate;
|
|
int serial_data_bits; /* eg 8 */
|
|
int serial_stop_bits; /* eg 2 */
|
|
enum serial_parity_e serial_parity; /* */
|
|
enum serial_handshake_e serial_handshake; /* */
|
|
int write_delay; /* delay in ms between each byte sent out */
|
|
int post_write_delay; /* for some yaesu rigs */
|
|
struct timeval post_write_date; /* hamlib internal use */
|
|
int timeout; /* in ms */
|
|
int retry; /* maximum number of retries, 0 to disable */
|
|
enum ptt_type_e ptt_type; /* how we will key the rig */
|
|
char ptt_path[FILPATHLEN]; /* path to the keying device (serial,//) */
|
|
double vfo_comp; /* VFO compensation in PPM, 0.0 to disable */
|
|
char rig_path[FILPATHLEN]; /* serial port/network path(host:port) */
|
|
int fd; /* serial port/socket file handle */
|
|
FILE *stream; /* serial port/socket (buffered) stream handle */
|
|
int transceive; /* wether the transceive mode is on */
|
|
int hold_decode;/* set to 1 to hold the event decoder (async) otherwise 0 */
|
|
/*
|
|
* Pointer to private data
|
|
* tuff like CI_V_address for Icom goes in this *priv 51 area
|
|
*/
|
|
void *priv; /* pointer to private data */
|
|
|
|
/* etc... */
|
|
};
|
|
|
|
/*
|
|
* Rig callbacks
|
|
* ie., the rig notify the host computer someone changed
|
|
* the freq/mode from the panel, depressed a button, etc.
|
|
* In order to achieve this, the hamlib would have to run
|
|
* an internal thread listening the rig with a select(),
|
|
* or poll regularly...
|
|
*
|
|
* Event based programming, really appropriate in a GUI.
|
|
* So far, Icoms are able to do that in Transceive mode, and PCR-1000 too.
|
|
*/
|
|
struct rig_callbacks {
|
|
int (*freq_event)(RIG *rig, freq_t freq);
|
|
int (*mode_event)(RIG *rig, rmode_t mode);
|
|
int (*vfo_event)(RIG *rig, vfo_t vfo);
|
|
int (*ptt_event)(RIG *rig, ptt_t mode);
|
|
/* etc.. */
|
|
};
|
|
|
|
/*
|
|
* struct rig is the master data structure,
|
|
* acting as a handle for the controlled rig.
|
|
*/
|
|
struct rig {
|
|
const struct rig_caps *caps;
|
|
struct rig_state state;
|
|
struct rig_callbacks callbacks;
|
|
};
|
|
|
|
|
|
|
|
/* --------------- API function prototypes -----------------*/
|
|
|
|
extern RIG *rig_init(rig_model_t rig_model);
|
|
extern int rig_open(RIG *rig);
|
|
|
|
/*
|
|
* General API commands, from most primitive to least.. :()
|
|
* List Set/Get functions pairs
|
|
*/
|
|
|
|
extern int rig_set_freq(RIG *rig, freq_t freq); /* select freq */
|
|
extern int rig_get_freq(RIG *rig, freq_t *freq); /* get freq */
|
|
|
|
extern int rig_set_mode(RIG *rig, rmode_t mode); /* select mode */
|
|
extern int rig_get_mode(RIG *rig, rmode_t *mode); /* get mode */
|
|
|
|
extern int rig_set_passband(RIG *rig, pbwidth_t width); /* select width */
|
|
extern int rig_get_passband(RIG *rig, pbwidth_t *width); /* get width */
|
|
|
|
extern int rig_set_vfo(RIG *rig, vfo_t vfo); /* select vfo */
|
|
extern int rig_get_vfo(RIG *rig, vfo_t *vfo); /* get vfo */
|
|
|
|
extern int rig_set_ptt(RIG *rig, ptt_t ptt); /* ptt on/off */
|
|
extern int rig_get_ptt(RIG *rig, ptt_t *ptt); /* get ptt status */
|
|
|
|
extern int rig_set_rptr_shift(RIG *rig, rptr_shift_t rptr_shift); /* set repeater shift */
|
|
extern int rig_get_rptr_shift(RIG *rig, rptr_shift_t *rptr_shift); /* get repeater shift */
|
|
extern int rig_set_rptr_offs(RIG *rig, unsigned long rptr_offs); /* set repeater offset */
|
|
extern int rig_get_rptr_offs(RIG *rig, unsigned long *rptr_offs); /* get repeater offset */
|
|
|
|
extern int rig_set_ctcss(RIG *rig, unsigned int tone);
|
|
extern int rig_get_ctcss(RIG *rig, unsigned int *tone);
|
|
extern int rig_set_dcs(RIG *rig, unsigned int code);
|
|
extern int rig_get_dcs(RIG *rig, unsigned int *code);
|
|
|
|
extern int rig_set_split_freq(RIG *rig, freq_t rx_freq, freq_t tx_freq);
|
|
extern int rig_get_split_freq(RIG *rig, freq_t *rx_freq, freq_t *tx_freq);
|
|
extern int rig_set_split(RIG *rig, split_t split);
|
|
extern int rig_get_split(RIG *rig, split_t *split);
|
|
|
|
extern int rig_set_ts(RIG *rig, unsigned long ts); /* set tuning step */
|
|
extern int rig_get_ts(RIG *rig, unsigned long *ts); /* get tuning step */
|
|
|
|
extern int rig_power2mW(RIG *rig, unsigned int *mwpower, float power, freq_t freq, rmode_t mode);
|
|
extern int rig_mW2power(RIG *rig, float *power, unsigned int mwpower, freq_t freq, rmode_t mode);
|
|
|
|
extern int rig_set_level(RIG *rig, setting_t level, value_t val);
|
|
extern int rig_get_level(RIG *rig, setting_t level, value_t *val);
|
|
|
|
#define rig_get_strength(r,s) rig_get_level((r), RIG_LEVEL_STRENGTH, (value_t*)(s))
|
|
|
|
extern int rig_set_poweron(RIG *rig);
|
|
extern int rig_set_poweroff(RIG *rig);
|
|
|
|
/* more to come -- FS */
|
|
|
|
extern int rig_close(RIG *rig);
|
|
extern int rig_cleanup(RIG *rig);
|
|
|
|
extern RIG *rig_probe(const char *rig_path);
|
|
|
|
extern setting_t rig_has_level(RIG *rig, setting_t level);
|
|
extern setting_t rig_has_set_level(RIG *rig, setting_t level);
|
|
|
|
extern setting_t rig_has_func(RIG *rig, setting_t func); /* is part of capabilities? */
|
|
extern int rig_set_func(RIG *rig, setting_t func, int status); /* activate the function(s) */
|
|
extern int rig_get_func(RIG *rig, setting_t *func); /* get the setting from rig */
|
|
|
|
extern int rig_set_bank(RIG *rig, int bank); /* set memory bank number */
|
|
extern int rig_set_mem(RIG *rig, int ch); /* set memory channel number */
|
|
extern int rig_get_mem(RIG *rig, int *ch); /* get memory channel number */
|
|
extern int rig_mv_ctl(RIG *rig, mv_op_t op); /* Mem/VFO operation */
|
|
|
|
extern int rig_set_channel(RIG *rig, const channel_t *chan);
|
|
extern int rig_get_channel(RIG *rig, channel_t *chan);
|
|
|
|
extern int rig_set_trn(RIG *rig, int trn); /* activate the transceive mode */
|
|
extern int rig_get_trn(RIG *rig, int *trn);
|
|
|
|
extern const struct rig_caps *rig_get_caps(rig_model_t rig_model);
|
|
const freq_range_t *rig_get_range(const freq_range_t range_list[], freq_t freq, rmode_t mode);
|
|
|
|
extern const char *rigerror(int errnum);
|
|
|
|
/*
|
|
* Even if these functions are prefixed with "rig_", they are not rig specific
|
|
* Maybe "hamlib_" would have been better. Let me know. --SF
|
|
*/
|
|
void rig_set_debug(enum rig_debug_level_e debug_level);
|
|
int rig_need_debug(enum rig_debug_level_e debug_level);
|
|
void rig_debug(enum rig_debug_level_e debug_level, const char *fmt, ...);
|
|
|
|
int rig_register(const struct rig_caps *caps);
|
|
int rig_unregister(rig_model_t rig_model);
|
|
int rig_list_foreach(int (*cfunc)(const struct rig_caps*,void*),void *data);
|
|
int rig_load_backend(const char *be_name);
|
|
|
|
#endif /* _RIG_H */
|
|
|
|
|