00001
00002
00003
00004
00005
00006
00007
00008
00009
00010
00011
00012
00013
00014
00015
00016
00017
00018
00019
00020
00021
00022
00023
00024 #ifndef _RIG_H
00025 #define _RIG_H 1
00026
00027 #include <stdio.h>
00028 #include <stdarg.h>
00029
00030 #include <hamlib/riglist.h>
00031
00045
00046
00047
00048 #undef __BEGIN_DECLS
00049 #undef __END_DECLS
00050 #ifdef __cplusplus
00051 # define __BEGIN_DECLS extern "C" {
00052 # define __END_DECLS }
00053 #else
00054 # define __BEGIN_DECLS
00055 # define __END_DECLS
00056 #endif
00057
00058
00059
00060
00061 #undef HAMLIB_PARAMS
00062 #if defined (__STDC__) || defined (_AIX) || (defined (__mips) && defined (_SYSTYPE_SVR4)) || defined(__CYGWIN__) || defined(_WIN32) || defined(__cplusplus)
00063 # define HAMLIB_PARAMS(protos) protos
00064 # define rig_ptr_t void*
00065 #else
00066 # define HAMLIB_PARAMS(protos) ()
00067 # define rig_ptr_t char*
00068 #endif
00069
00070 #include <hamlib/rig_dll.h>
00071
00072
00073 __BEGIN_DECLS
00074
00075 extern HAMLIB_EXPORT_VAR(const char) hamlib_version[];
00076 extern HAMLIB_EXPORT_VAR(const char) hamlib_copyright[];
00077
00082 enum rig_errcode_e {
00083 RIG_OK=0,
00084 RIG_EINVAL,
00085 RIG_ECONF,
00086 RIG_ENOMEM,
00087 RIG_ENIMPL,
00088 RIG_ETIMEOUT,
00089 RIG_EIO,
00090 RIG_EINTERNAL,
00091 RIG_EPROTO,
00092 RIG_ERJCTED,
00093 RIG_ETRUNC,
00094 RIG_ENAVAIL,
00095 RIG_ENTARGET,
00096 RIG_BUSERROR,
00097 RIG_BUSBUSY,
00098 RIG_EARG,
00099 RIG_EVFO,
00100 RIG_EDOM
00101 };
00102
00110 enum rig_debug_level_e {
00111 RIG_DEBUG_NONE = 0,
00112 RIG_DEBUG_BUG,
00113 RIG_DEBUG_ERR,
00114 RIG_DEBUG_WARN,
00115 RIG_DEBUG_VERBOSE,
00116 RIG_DEBUG_TRACE
00117 };
00118
00119
00120
00121
00122
00123 struct rig;
00124 struct rig_state;
00125
00129 typedef struct rig RIG;
00130
00131 #define RIGNAMSIZ 30
00132 #define RIGVERSIZ 8
00133 #define FILPATHLEN 100
00134 #define FRQRANGESIZ 30
00135 #define MAXCHANDESC 30
00136 #define TSLSTSIZ 20
00137 #define FLTLSTSIZ 42
00138 #define MAXDBLSTSIZ 8
00139 #define CHANLSTSIZ 16
00140 #define MAX_CAL_LENGTH 32
00141
00142
00153 typedef unsigned int tone_t;
00154
00158 typedef enum rig_port_e {
00159 RIG_PORT_NONE = 0,
00160 RIG_PORT_SERIAL,
00161 RIG_PORT_NETWORK,
00162 RIG_PORT_DEVICE,
00163 RIG_PORT_PACKET,
00164 RIG_PORT_DTMF,
00165 RIG_PORT_ULTRA,
00166 RIG_PORT_RPC,
00167 RIG_PORT_PARALLEL,
00168 RIG_PORT_USB
00169 } rig_port_t;
00170
00174 enum serial_parity_e {
00175 RIG_PARITY_NONE = 0,
00176 RIG_PARITY_ODD,
00177 RIG_PARITY_EVEN
00178 };
00179
00183 enum serial_handshake_e {
00184 RIG_HANDSHAKE_NONE = 0,
00185 RIG_HANDSHAKE_XONXOFF,
00186 RIG_HANDSHAKE_HARDWARE
00187 };
00188
00189
00193 enum serial_control_state_e {
00194 RIG_SIGNAL_UNSET = 0,
00195 RIG_SIGNAL_ON,
00196 RIG_SIGNAL_OFF
00197 };
00198
00200 typedef enum {
00201 RIG_FLAG_RECEIVER = (1<<1),
00202 RIG_FLAG_TRANSMITTER = (1<<2),
00203 RIG_FLAG_SCANNER = (1<<3),
00205 RIG_FLAG_MOBILE = (1<<4),
00206 RIG_FLAG_HANDHELD = (1<<5),
00207 RIG_FLAG_COMPUTER = (1<<6),
00208 RIG_FLAG_TRUNKING = (1<<7),
00209 RIG_FLAG_APRS = (1<<8),
00210 RIG_FLAG_TNC = (1<<9),
00211 RIG_FLAG_DXCLUSTER = (1<<10),
00212 RIG_FLAG_TUNER = (1<<11)
00213 } rig_type_t;
00214
00215 #define RIG_FLAG_TRANSCEIVER (RIG_FLAG_RECEIVER|RIG_FLAG_TRANSMITTER)
00216 #define RIG_TYPE_MASK (RIG_FLAG_TRANSCEIVER|RIG_FLAG_SCANNER|RIG_FLAG_MOBILE|RIG_FLAG_HANDHELD|RIG_FLAG_COMPUTER|RIG_FLAG_TRUNKING|RIG_FLAG_TUNER)
00217
00218 #define RIG_TYPE_OTHER 0
00219 #define RIG_TYPE_TRANSCEIVER RIG_FLAG_TRANSCEIVER
00220 #define RIG_TYPE_HANDHELD (RIG_FLAG_TRANSCEIVER|RIG_FLAG_HANDHELD)
00221 #define RIG_TYPE_MOBILE (RIG_FLAG_TRANSCEIVER|RIG_FLAG_MOBILE)
00222 #define RIG_TYPE_RECEIVER RIG_FLAG_RECEIVER
00223 #define RIG_TYPE_PCRECEIVER (RIG_FLAG_COMPUTER|RIG_FLAG_RECEIVER)
00224 #define RIG_TYPE_SCANNER (RIG_FLAG_SCANNER|RIG_FLAG_RECEIVER)
00225 #define RIG_TYPE_TRUNKSCANNER (RIG_TYPE_SCANNER|RIG_FLAG_TRUNKING)
00226 #define RIG_TYPE_COMPUTER (RIG_FLAG_TRANSCEIVER|RIG_FLAG_COMPUTER)
00227 #define RIG_TYPE_TUNER RIG_FLAG_TUNER
00228
00229
00233 enum rig_status_e {
00234 RIG_STATUS_ALPHA = 0,
00235 RIG_STATUS_UNTESTED,
00236 RIG_STATUS_BETA,
00237 RIG_STATUS_STABLE,
00238 RIG_STATUS_BUGGY,
00239 RIG_STATUS_NEW
00240 };
00241
00245 typedef enum {
00246 RIG_RPT_SHIFT_NONE = 0,
00247 RIG_RPT_SHIFT_MINUS,
00248 RIG_RPT_SHIFT_PLUS
00249 } rptr_shift_t;
00250
00254 typedef enum {
00255 RIG_SPLIT_OFF = 0,
00256 RIG_SPLIT_ON
00257 } split_t;
00258
00263 typedef double freq_t;
00265 #define PRIfreq "f"
00266
00267 #define SCNfreq "lf"
00268 #define FREQFMT SCNfreq
00269
00274 typedef signed long shortfreq_t;
00275
00276 #define Hz(f) ((freq_t)(f))
00277 #define kHz(f) ((freq_t)((f)*(freq_t)1000))
00278 #define MHz(f) ((freq_t)((f)*(freq_t)1000000))
00279 #define GHz(f) ((freq_t)((f)*(freq_t)1000000000))
00280
00281 #define s_Hz(f) ((shortfreq_t)(f))
00282 #define s_kHz(f) ((shortfreq_t)((f)*(shortfreq_t)1000))
00283 #define s_MHz(f) ((shortfreq_t)((f)*(shortfreq_t)1000000))
00284 #define s_GHz(f) ((shortfreq_t)((f)*(shortfreq_t)1000000000))
00285
00286 #define RIG_FREQ_NONE Hz(0)
00287
00288
00303 typedef int vfo_t;
00304
00306 #define RIG_VFO_NONE 0
00307
00308 #define RIG_VFO_TX_FLAG ((vfo_t)(1<<30))
00309
00311 #define RIG_VFO_CURR ((vfo_t)(1<<29))
00312
00314 #define RIG_VFO_MEM ((vfo_t)(1<<28))
00315
00317 #define RIG_VFO_VFO ((vfo_t)(1<<27))
00318
00319 #define RIG_VFO_TX_VFO(v) ((v)|RIG_VFO_TX_FLAG)
00320
00322 #define RIG_VFO_TX RIG_VFO_TX_VFO(RIG_VFO_CURR)
00323
00325 #define RIG_VFO_RX RIG_VFO_CURR
00326
00328 #define RIG_VFO_MAIN ((vfo_t)(1<<26))
00329
00330 #define RIG_VFO_SUB ((vfo_t)(1<<25))
00331
00332 #define RIG_VFO_N(n) ((vfo_t)(1<<(n)))
00333
00335 #define RIG_VFO_A RIG_VFO_N(0)
00336
00337 #define RIG_VFO_B RIG_VFO_N(1)
00338
00339 #define RIG_VFO_C RIG_VFO_N(2)
00340
00341
00342
00343
00344
00345
00346 #define RIG_TARGETABLE_NONE 0
00347 #define RIG_TARGETABLE_FREQ (1<<0)
00348 #define RIG_TARGETABLE_MODE (1<<1)
00349 #define RIG_TARGETABLE_PURE (1<<2)
00350 #define RIG_TARGETABLE_ALL 0x7fffffff
00351
00352
00353 #define RIG_PASSBAND_NORMAL s_Hz(0)
00354
00358 typedef shortfreq_t pbwidth_t;
00359
00360
00364 typedef enum dcd_e {
00365 RIG_DCD_OFF = 0,
00366 RIG_DCD_ON
00367 } dcd_t;
00368
00373 typedef enum {
00374 RIG_DCD_NONE = 0,
00375 RIG_DCD_RIG,
00376 RIG_DCD_SERIAL_DSR,
00377 RIG_DCD_SERIAL_CTS,
00378 RIG_DCD_SERIAL_CAR,
00379 RIG_DCD_PARALLEL
00380 } dcd_type_t;
00381
00382
00386 typedef enum {
00387 RIG_PTT_OFF = 0,
00388 RIG_PTT_ON
00389 } ptt_t;
00390
00395 typedef enum {
00396 RIG_PTT_NONE = 0,
00397 RIG_PTT_RIG,
00398 RIG_PTT_SERIAL_DTR,
00399 RIG_PTT_SERIAL_RTS,
00400 RIG_PTT_PARALLEL
00401 } ptt_type_t;
00402
00406 typedef enum {
00407 RIG_POWER_OFF = 0,
00408 RIG_POWER_ON = (1<<0),
00409 RIG_POWER_STANDBY = (1<<1)
00410 } powerstat_t;
00411
00415 typedef enum {
00416 RIG_RESET_NONE = 0,
00417 RIG_RESET_SOFT = (1<<0),
00418 RIG_RESET_VFO = (1<<1),
00419 RIG_RESET_MCALL = (1<<2),
00420 RIG_RESET_MASTER = (1<<3)
00421 } reset_t;
00422
00423
00435 typedef enum {
00436 RIG_OP_NONE = 0,
00437 RIG_OP_CPY = (1<<0),
00438 RIG_OP_XCHG = (1<<1),
00439 RIG_OP_FROM_VFO = (1<<2),
00440 RIG_OP_TO_VFO = (1<<3),
00441 RIG_OP_MCL = (1<<4),
00442 RIG_OP_UP = (1<<5),
00443 RIG_OP_DOWN = (1<<6),
00444 RIG_OP_BAND_UP = (1<<7),
00445 RIG_OP_BAND_DOWN = (1<<8),
00446 RIG_OP_LEFT = (1<<9),
00447 RIG_OP_RIGHT = (1<<10),
00448 RIG_OP_TUNE = (1<<11),
00449 RIG_OP_TOGGLE = (1<<12)
00450 } vfo_op_t;
00451
00452
00456 typedef enum {
00457 RIG_SCAN_NONE = 0,
00458 RIG_SCAN_STOP = RIG_SCAN_NONE,
00459 RIG_SCAN_MEM = (1<<0),
00460 RIG_SCAN_SLCT = (1<<1),
00461 RIG_SCAN_PRIO = (1<<2),
00462 RIG_SCAN_PROG = (1<<3),
00463 RIG_SCAN_DELTA = (1<<4),
00464 RIG_SCAN_VFO = (1<<5),
00465 RIG_SCAN_PLT = (1<<6)
00466 } scan_t;
00467
00471 typedef long token_t;
00472
00473 #define RIG_CONF_END 0
00474
00478
00479 enum rig_conf_e {
00480 RIG_CONF_STRING,
00481 RIG_CONF_COMBO,
00482 RIG_CONF_NUMERIC,
00483 RIG_CONF_CHECKBUTTON
00484 };
00485
00486 #define RIG_COMBO_MAX 8
00487
00491 struct confparams {
00492 token_t token;
00493 const char *name;
00494 const char *label;
00495 const char *tooltip;
00496 const char *dflt;
00497 enum rig_conf_e type;
00498 union {
00499 struct {
00500 float min;
00501 float max;
00502 float step;
00503 } n;
00504 struct {
00505 const char *combostr[RIG_COMBO_MAX];
00506 } c;
00507 } u;
00508 };
00509
00513 typedef enum {
00514 RIG_ANN_NONE = 0,
00515 RIG_ANN_OFF = RIG_ANN_NONE,
00516 RIG_ANN_FREQ = (1<<0),
00517 RIG_ANN_RXMODE = (1<<1),
00518 RIG_ANN_CW = (1<<2),
00519 RIG_ANN_ENG = (1<<3),
00520 RIG_ANN_JAP = (1<<4)
00521 } ann_t;
00522
00523
00524
00525 typedef int ant_t;
00526
00527 #define RIG_ANT_NONE 0
00528 #define RIG_ANT_N(n) ((ant_t)1<<(n))
00529 #define RIG_ANT_1 RIG_ANT_N(0)
00530 #define RIG_ANT_2 RIG_ANT_N(1)
00531 #define RIG_ANT_3 RIG_ANT_N(2)
00532 #define RIG_ANT_4 RIG_ANT_N(3)
00533
00537
00538 enum agc_level_e {
00539 RIG_AGC_OFF = 0,
00540 RIG_AGC_SUPERFAST,
00541 RIG_AGC_FAST,
00542 RIG_AGC_SLOW,
00543 RIG_AGC_USER,
00544 RIG_AGC_MEDIUM
00545 };
00546
00550 enum meter_level_e {
00551 RIG_METER_NONE = 0,
00552 RIG_METER_SWR = (1<<0),
00553 RIG_METER_COMP = (1<<1),
00554 RIG_METER_ALC = (1<<2),
00555 RIG_METER_IC = (1<<3),
00556 RIG_METER_DB = (1<<4)
00557 };
00558
00563 typedef union {
00564 signed int i;
00565 float f;
00566 char *s;
00567 const char *cs;
00568 } value_t;
00569
00571 enum rig_level_e {
00572 RIG_LEVEL_NONE = 0,
00573 RIG_LEVEL_PREAMP = (1<<0),
00574 RIG_LEVEL_ATT = (1<<1),
00575 RIG_LEVEL_VOX = (1<<2),
00576 RIG_LEVEL_AF = (1<<3),
00577 RIG_LEVEL_RF = (1<<4),
00578 RIG_LEVEL_SQL = (1<<5),
00579 RIG_LEVEL_IF = (1<<6),
00580 RIG_LEVEL_APF = (1<<7),
00581 RIG_LEVEL_NR = (1<<8),
00582 RIG_LEVEL_PBT_IN = (1<<9),
00583 RIG_LEVEL_PBT_OUT = (1<<10),
00584 RIG_LEVEL_CWPITCH = (1<<11),
00585 RIG_LEVEL_RFPOWER = (1<<12),
00586 RIG_LEVEL_MICGAIN = (1<<13),
00587 RIG_LEVEL_KEYSPD = (1<<14),
00588 RIG_LEVEL_NOTCHF = (1<<15),
00589 RIG_LEVEL_COMP = (1<<16),
00590 RIG_LEVEL_AGC = (1<<17),
00591 RIG_LEVEL_BKINDL = (1<<18),
00592 RIG_LEVEL_BALANCE = (1<<19),
00593 RIG_LEVEL_METER = (1<<20),
00595 RIG_LEVEL_VOXGAIN = (1<<21),
00596 RIG_LEVEL_VOXDELAY = RIG_LEVEL_VOX,
00597 RIG_LEVEL_ANTIVOX = (1<<22),
00598
00599
00601 RIG_LEVEL_RAWSTR = (1<<26),
00602 RIG_LEVEL_SQLSTAT = (1<<27),
00603 RIG_LEVEL_SWR = (1<<28),
00604 RIG_LEVEL_ALC = (1<<29),
00605 RIG_LEVEL_STRENGTH = (1<<30)
00606
00607 };
00608
00609 #define RIG_LEVEL_FLOAT_LIST (RIG_LEVEL_AF|RIG_LEVEL_RF|RIG_LEVEL_SQL|RIG_LEVEL_APF|RIG_LEVEL_NR|RIG_LEVEL_PBT_IN|RIG_LEVEL_PBT_OUT|RIG_LEVEL_RFPOWER|RIG_LEVEL_MICGAIN|RIG_LEVEL_COMP|RIG_LEVEL_BALANCE|RIG_LEVEL_SWR|RIG_LEVEL_ALC|RIG_LEVEL_VOXGAIN|RIG_LEVEL_ANTIVOX)
00610
00611 #define RIG_LEVEL_READONLY_LIST (RIG_LEVEL_SQLSTAT|RIG_LEVEL_SWR|RIG_LEVEL_ALC|RIG_LEVEL_STRENGTH|RIG_LEVEL_RAWSTR)
00612
00613 #define RIG_LEVEL_IS_FLOAT(l) ((l)&RIG_LEVEL_FLOAT_LIST)
00614 #define RIG_LEVEL_SET(l) ((l)&~RIG_LEVEL_READONLY_LIST)
00615
00616
00621 enum rig_parm_e {
00622 RIG_PARM_NONE = 0,
00623 RIG_PARM_ANN = (1<<0),
00624 RIG_PARM_APO = (1<<1),
00625 RIG_PARM_BACKLIGHT = (1<<2),
00626 RIG_PARM_BEEP = (1<<4),
00627 RIG_PARM_TIME = (1<<5),
00628 RIG_PARM_BAT = (1<<6),
00629 RIG_PARM_KEYLIGHT = (1<<7)
00630 };
00631
00632 #define RIG_PARM_FLOAT_LIST (RIG_PARM_BACKLIGHT|RIG_PARM_BAT)
00633 #define RIG_PARM_READONLY_LIST (RIG_PARM_BAT)
00634
00635 #define RIG_PARM_IS_FLOAT(l) ((l)&RIG_PARM_FLOAT_LIST)
00636 #define RIG_PARM_SET(l) ((l)&~RIG_PARM_READONLY_LIST)
00637
00638 #define RIG_SETTING_MAX 32
00639
00645 typedef unsigned long setting_t;
00646
00647
00648
00649
00650
00651 #define RIG_TRN_OFF 0
00652 #define RIG_TRN_RIG 1
00653 #define RIG_TRN_POLL 2
00654
00655
00659 enum rig_func_e {
00660 RIG_FUNC_NONE = 0,
00661 RIG_FUNC_FAGC = (1<<0),
00662 RIG_FUNC_NB = (1<<1),
00663 RIG_FUNC_COMP = (1<<2),
00664 RIG_FUNC_VOX = (1<<3),
00665 RIG_FUNC_TONE = (1<<4),
00666 RIG_FUNC_TSQL = (1<<5),
00667 RIG_FUNC_SBKIN = (1<<6),
00668 RIG_FUNC_FBKIN = (1<<7),
00669 RIG_FUNC_ANF = (1<<8),
00670 RIG_FUNC_NR = (1<<9),
00671 RIG_FUNC_AIP = (1<<10),
00672 RIG_FUNC_APF = (1<<11),
00673 RIG_FUNC_MON = (1<<12),
00674 RIG_FUNC_MN = (1<<13),
00675 RIG_FUNC_RF = (1<<14),
00676 RIG_FUNC_ARO = (1<<15),
00677 RIG_FUNC_LOCK = (1<<16),
00678 RIG_FUNC_MUTE = (1<<17),
00679 RIG_FUNC_VSC = (1<<18),
00680 RIG_FUNC_REV = (1<<19),
00681 RIG_FUNC_SQL = (1<<20),
00682 RIG_FUNC_ABM = (1<<21),
00683 RIG_FUNC_BC = (1<<22),
00684 RIG_FUNC_MBC = (1<<23),
00685
00686 RIG_FUNC_AFC = (1<<25),
00687 RIG_FUNC_SATMODE = (1<<26),
00688 RIG_FUNC_SCOPE = (1<<27),
00689 RIG_FUNC_RESUME = (1<<28),
00690 RIG_FUNC_TBURST = (1<<29),
00691 RIG_FUNC_TUNER = (1<<30)
00692 };
00693
00694
00695
00696
00697
00698 #define mW(p) ((int)(p))
00699 #define Watts(p) ((int)((p)*1000))
00700 #define W(p) Watts(p)
00701 #define kW(p) ((int)((p)*1000000L))
00702
00706 typedef enum {
00707 RIG_MODE_NONE = 0,
00708 RIG_MODE_AM = (1<<0),
00709 RIG_MODE_CW = (1<<1),
00710 RIG_MODE_USB = (1<<2),
00711 RIG_MODE_LSB = (1<<3),
00712 RIG_MODE_RTTY = (1<<4),
00713 RIG_MODE_FM = (1<<5),
00714 RIG_MODE_WFM = (1<<6),
00715 RIG_MODE_CWR = (1<<7),
00716 RIG_MODE_RTTYR = (1<<8),
00717 RIG_MODE_AMS = (1<<9),
00718 RIG_MODE_PKTLSB = (1<<10),
00719 RIG_MODE_PKTUSB = (1<<11),
00720 RIG_MODE_PKTFM = (1<<12),
00721 RIG_MODE_ECSSUSB = (1<<13),
00722 RIG_MODE_ECSSLSB = (1<<14),
00723 RIG_MODE_FAX = (1<<15),
00724 RIG_MODE_SAM = (1<<16),
00725 RIG_MODE_SAL = (1<<17),
00726 RIG_MODE_SAH = (1<<18)
00728 } rmode_t;
00729
00731 #define RIG_MODE_SSB (RIG_MODE_USB|RIG_MODE_LSB)
00732
00734 #define RIG_MODE_ECSS (RIG_MODE_ECSSUSB|RIG_MODE_ECSSLSB)
00735
00736
00737 #define RIG_DBLST_END 0
00738 #define RIG_IS_DBLST_END(d) ((d)==0)
00739
00746 typedef struct freq_range_list {
00747 freq_t start;
00748 freq_t end;
00749 rmode_t modes;
00750 int low_power;
00751 int high_power;
00752 vfo_t vfo;
00753 ant_t ant;
00754 } freq_range_t;
00755
00756 #define RIG_FRNG_END {Hz(0),Hz(0),RIG_MODE_NONE,0,0,RIG_VFO_NONE}
00757 #define RIG_IS_FRNG_END(r) ((r).start == Hz(0) && (r).end == Hz(0))
00758
00759 #define RIG_ITU_REGION1 1
00760 #define RIG_ITU_REGION2 2
00761 #define RIG_ITU_REGION3 3
00762
00782 struct tuning_step_list {
00783 rmode_t modes;
00784 shortfreq_t ts;
00785 };
00786
00787 #define RIG_TS_ANY 0
00788 #define RIG_TS_END {RIG_MODE_NONE,0}
00789 #define RIG_IS_TS_END(t) ((t).modes == RIG_MODE_NONE && (t).ts == 0)
00790
00817 struct filter_list {
00818 rmode_t modes;
00819 pbwidth_t width;
00820 };
00821
00822 #define RIG_FLT_ANY 0
00823 #define RIG_FLT_END {RIG_MODE_NONE,0}
00824 #define RIG_IS_FLT_END(f) ((f).modes == RIG_MODE_NONE)
00825
00826
00827
00828
00829
00830 #define RIG_CHFLAG_NONE 0
00831 #define RIG_CHFLAG_SKIP (1<<0)
00832
00833 #define RIG_CHFLAG_DATA (1<<1)
00834
00839 struct ext_list {
00840 token_t token;
00841 value_t val;
00842 };
00843
00844 #define RIG_EXT_END {0, {.i=0}}
00845 #define RIG_IS_EXT_END(x) ((x).token == 0)
00846
00854 struct channel {
00855 int channel_num;
00856 int bank_num;
00857 vfo_t vfo;
00858 int ant;
00859 freq_t freq;
00860 rmode_t mode;
00861 pbwidth_t width;
00863 freq_t tx_freq;
00864 rmode_t tx_mode;
00865 pbwidth_t tx_width;
00867 split_t split;
00868 vfo_t tx_vfo;
00870 rptr_shift_t rptr_shift;
00871 shortfreq_t rptr_offs;
00872 shortfreq_t tuning_step;
00873 shortfreq_t rit;
00874 shortfreq_t xit;
00875 setting_t funcs;
00876 value_t levels[RIG_SETTING_MAX];
00877 tone_t ctcss_tone;
00878 tone_t ctcss_sql;
00879 tone_t dcs_code;
00880 tone_t dcs_sql;
00881 int scan_group;
00882 int flags;
00883 char channel_desc[MAXCHANDESC];
00884 struct ext_list *ext_levels;
00885 };
00887 typedef struct channel channel_t;
00888
00894 struct channel_cap {
00895 unsigned bank_num:1;
00896 unsigned vfo:1;
00897 unsigned ant:1;
00898 unsigned freq:1;
00899 unsigned mode:1;
00900 unsigned width:1;
00902 unsigned tx_freq:1;
00903 unsigned tx_mode:1;
00904 unsigned tx_width:1;
00906 unsigned split:1;
00907 unsigned tx_vfo:1;
00908 unsigned rptr_shift:1;
00909 unsigned rptr_offs:1;
00910 unsigned tuning_step:1;
00911 unsigned rit:1;
00912 unsigned xit:1;
00913 setting_t funcs;
00914 setting_t levels;
00915 unsigned ctcss_tone:1;
00916 unsigned ctcss_sql:1;
00917 unsigned dcs_code:1;
00918 unsigned dcs_sql:1;
00919 unsigned scan_group:1;
00920 unsigned flags:1;
00921 unsigned channel_desc:1;
00922 unsigned ext_levels:1;
00923 };
00924
00926 typedef struct channel_cap channel_cap_t;
00927
00928
00939 typedef enum {
00940 RIG_MTYPE_NONE=0,
00941 RIG_MTYPE_MEM,
00942 RIG_MTYPE_EDGE,
00943 RIG_MTYPE_CALL,
00944 RIG_MTYPE_MEMOPAD,
00945 RIG_MTYPE_SAT
00946 } chan_type_t;
00947
00961 struct chan_list {
00962 int start;
00963 int end;
00964 chan_type_t type;
00965 channel_cap_t mem_caps;
00966 };
00967
00968 #define RIG_CHAN_END {0,0,RIG_MTYPE_NONE}
00969 #define RIG_IS_CHAN_END(c) ((c).type == RIG_MTYPE_NONE)
00970
00972 typedef struct chan_list chan_t;
00973
00985 struct gran {
00986 value_t min;
00987 value_t max;
00988 value_t step;
00989 };
00990
00992 typedef struct gran gran_t;
00993
00994
00996 struct cal_table {
00997 int size;
00998 struct {
00999 int raw;
01000 int val;
01001 } table[MAX_CAL_LENGTH];
01002 };
01003
01016 typedef struct cal_table cal_table_t;
01017
01018 #define EMPTY_STR_CAL { 0, { { 0, 0 }, } }
01019
01020
01021 typedef int (*chan_cb_t) (RIG *, channel_t**, int, const chan_t*, rig_ptr_t);
01022 typedef int (*confval_cb_t) (RIG *, const struct confparams *, value_t *, rig_ptr_t);
01023
01042 struct rig_caps {
01043 rig_model_t rig_model;
01044 const char *model_name;
01045 const char *mfg_name;
01046 const char *version;
01047 const char *copyright;
01048 enum rig_status_e status;
01050 int rig_type;
01051 ptt_type_t ptt_type;
01052 dcd_type_t dcd_type;
01053 rig_port_t port_type;
01055 int serial_rate_min;
01056 int serial_rate_max;
01057 int serial_data_bits;
01058 int serial_stop_bits;
01059 enum serial_parity_e serial_parity;
01060 enum serial_handshake_e serial_handshake;
01062 int write_delay;
01063 int post_write_delay;
01064 int timeout;
01065 int retry;
01067 setting_t has_get_func;
01068 setting_t has_set_func;
01069 setting_t has_get_level;
01070 setting_t has_set_level;
01071 setting_t has_get_parm;
01072 setting_t has_set_parm;
01074 gran_t level_gran[RIG_SETTING_MAX];
01075 gran_t parm_gran[RIG_SETTING_MAX];
01077 const struct confparams *extparms;
01078 const struct confparams *extlevels;
01080 const tone_t *ctcss_list;
01081 const tone_t *dcs_list;
01083 int preamp[MAXDBLSTSIZ];
01084 int attenuator[MAXDBLSTSIZ];
01085 shortfreq_t max_rit;
01086 shortfreq_t max_xit;
01087 shortfreq_t max_ifshift;
01089 ann_t announces;
01091 vfo_op_t vfo_ops;
01092 scan_t scan_ops;
01093 int targetable_vfo;
01094 int transceive;
01096 int bank_qty;
01097 int chan_desc_sz;
01099 chan_t chan_list[CHANLSTSIZ];
01101 freq_range_t rx_range_list1[FRQRANGESIZ];
01102 freq_range_t tx_range_list1[FRQRANGESIZ];
01103 freq_range_t rx_range_list2[FRQRANGESIZ];
01104 freq_range_t tx_range_list2[FRQRANGESIZ];
01106 struct tuning_step_list tuning_steps[TSLSTSIZ];
01107 struct filter_list filters[FLTLSTSIZ];
01109 cal_table_t str_cal;
01111 const struct confparams *cfgparams;
01112 const rig_ptr_t priv;
01114
01115
01116
01117
01118
01119 int (*rig_init) (RIG * rig);
01120 int (*rig_cleanup) (RIG * rig);
01121 int (*rig_open) (RIG * rig);
01122 int (*rig_close) (RIG * rig);
01123
01124
01125
01126
01127
01128
01129 int (*set_freq) (RIG * rig, vfo_t vfo, freq_t freq);
01130 int (*get_freq) (RIG * rig, vfo_t vfo, freq_t * freq);
01131
01132 int (*set_mode) (RIG * rig, vfo_t vfo, rmode_t mode,
01133 pbwidth_t width);
01134 int (*get_mode) (RIG * rig, vfo_t vfo, rmode_t * mode,
01135 pbwidth_t * width);
01136
01137 int (*set_vfo) (RIG * rig, vfo_t vfo);
01138 int (*get_vfo) (RIG * rig, vfo_t * vfo);
01139
01140 int (*set_ptt) (RIG * rig, vfo_t vfo, ptt_t ptt);
01141 int (*get_ptt) (RIG * rig, vfo_t vfo, ptt_t * ptt);
01142 int (*get_dcd) (RIG * rig, vfo_t vfo, dcd_t * dcd);
01143
01144 int (*set_rptr_shift) (RIG * rig, vfo_t vfo,
01145 rptr_shift_t rptr_shift);
01146 int (*get_rptr_shift) (RIG * rig, vfo_t vfo,
01147 rptr_shift_t * rptr_shift);
01148
01149 int (*set_rptr_offs) (RIG * rig, vfo_t vfo, shortfreq_t offs);
01150 int (*get_rptr_offs) (RIG * rig, vfo_t vfo, shortfreq_t * offs);
01151
01152 int (*set_split_freq) (RIG * rig, vfo_t vfo, freq_t tx_freq);
01153 int (*get_split_freq) (RIG * rig, vfo_t vfo, freq_t * tx_freq);
01154 int (*set_split_mode) (RIG * rig, vfo_t vfo, rmode_t tx_mode,
01155 pbwidth_t tx_width);
01156 int (*get_split_mode) (RIG * rig, vfo_t vfo, rmode_t * tx_mode,
01157 pbwidth_t * tx_width);
01158
01159 int (*set_split_vfo) (RIG * rig, vfo_t vfo, split_t split, vfo_t tx_vfo);
01160 int (*get_split_vfo) (RIG * rig, vfo_t vfo, split_t * split, vfo_t *tx_vfo);
01161
01162 int (*set_rit) (RIG * rig, vfo_t vfo, shortfreq_t rit);
01163 int (*get_rit) (RIG * rig, vfo_t vfo, shortfreq_t * rit);
01164 int (*set_xit) (RIG * rig, vfo_t vfo, shortfreq_t xit);
01165 int (*get_xit) (RIG * rig, vfo_t vfo, shortfreq_t * xit);
01166
01167 int (*set_ts) (RIG * rig, vfo_t vfo, shortfreq_t ts);
01168 int (*get_ts) (RIG * rig, vfo_t vfo, shortfreq_t * ts);
01169
01170 int (*set_dcs_code) (RIG * rig, vfo_t vfo, tone_t code);
01171 int (*get_dcs_code) (RIG * rig, vfo_t vfo, tone_t * code);
01172 int (*set_tone) (RIG * rig, vfo_t vfo, tone_t tone);
01173 int (*get_tone) (RIG * rig, vfo_t vfo, tone_t * tone);
01174 int (*set_ctcss_tone) (RIG * rig, vfo_t vfo, tone_t tone);
01175 int (*get_ctcss_tone) (RIG * rig, vfo_t vfo, tone_t * tone);
01176
01177 int (*set_dcs_sql) (RIG * rig, vfo_t vfo, tone_t code);
01178 int (*get_dcs_sql) (RIG * rig, vfo_t vfo, tone_t * code);
01179 int (*set_tone_sql) (RIG * rig, vfo_t vfo, tone_t tone);
01180 int (*get_tone_sql) (RIG * rig, vfo_t vfo, tone_t * tone);
01181 int (*set_ctcss_sql) (RIG * rig, vfo_t vfo, tone_t tone);
01182 int (*get_ctcss_sql) (RIG * rig, vfo_t vfo, tone_t * tone);
01183
01184 int (*power2mW) (RIG * rig, unsigned int *mwpower, float power,
01185 freq_t freq, rmode_t mode);
01186 int (*mW2power) (RIG * rig, float *power, unsigned int mwpower,
01187 freq_t freq, rmode_t mode);
01188
01189 int (*set_powerstat) (RIG * rig, powerstat_t status);
01190 int (*get_powerstat) (RIG * rig, powerstat_t * status);
01191 int (*reset) (RIG * rig, reset_t reset);
01192
01193 int (*set_ant) (RIG * rig, vfo_t vfo, ant_t ant);
01194 int (*get_ant) (RIG * rig, vfo_t vfo, ant_t * ant);
01195
01196 int (*set_level) (RIG * rig, vfo_t vfo, setting_t level,
01197 value_t val);
01198 int (*get_level) (RIG * rig, vfo_t vfo, setting_t level,
01199 value_t * val);
01200
01201 int (*set_func) (RIG * rig, vfo_t vfo, setting_t func, int status);
01202 int (*get_func) (RIG * rig, vfo_t vfo, setting_t func,
01203 int *status);
01204
01205 int (*set_parm) (RIG * rig, setting_t parm, value_t val);
01206 int (*get_parm) (RIG * rig, setting_t parm, value_t * val);
01207
01208 int (*set_ext_level)(RIG *rig, vfo_t vfo, token_t token, value_t val);
01209 int (*get_ext_level)(RIG *rig, vfo_t vfo, token_t token, value_t *val);
01210
01211 int (*set_ext_parm)(RIG *rig, token_t token, value_t val);
01212 int (*get_ext_parm)(RIG *rig, token_t token, value_t *val);
01213
01214 int (*set_conf) (RIG * rig, token_t token, const char *val);
01215 int (*get_conf) (RIG * rig, token_t token, char *val);
01216
01217 int (*send_dtmf) (RIG * rig, vfo_t vfo, const char *digits);
01218 int (*recv_dtmf) (RIG * rig, vfo_t vfo, char *digits, int *length);
01219 int (*send_morse) (RIG * rig, vfo_t vfo, const char *msg);
01220
01221 int (*set_bank) (RIG * rig, vfo_t vfo, int bank);
01222 int (*set_mem) (RIG * rig, vfo_t vfo, int ch);
01223 int (*get_mem) (RIG * rig, vfo_t vfo, int *ch);
01224 int (*vfo_op) (RIG * rig, vfo_t vfo, vfo_op_t op);
01225 int (*scan) (RIG * rig, vfo_t vfo, scan_t scan, int ch);
01226
01227 int (*set_trn) (RIG * rig, int trn);
01228 int (*get_trn) (RIG * rig, int *trn);
01229
01230 int (*decode_event) (RIG * rig);
01231
01232 int (*set_channel) (RIG * rig, const channel_t * chan);
01233 int (*get_channel) (RIG * rig, channel_t * chan);
01234
01235 const char *(*get_info) (RIG * rig);
01236
01237 int (*set_chan_all_cb) (RIG * rig, chan_cb_t chan_cb, rig_ptr_t);
01238 int (*get_chan_all_cb) (RIG * rig, chan_cb_t chan_cb, rig_ptr_t);
01239
01240 int (*set_mem_all_cb) (RIG * rig, chan_cb_t chan_cb, confval_cb_t parm_cb, rig_ptr_t);
01241 int (*get_mem_all_cb) (RIG * rig, chan_cb_t chan_cb, confval_cb_t parm_cb, rig_ptr_t);
01242
01243 const char *clone_combo_set;
01244 const char *clone_combo_get;
01245 };
01246
01252 typedef struct {
01253 union {
01254 rig_port_t rig;
01255 ptt_type_t ptt;
01256 dcd_type_t dcd;
01257 } type;
01258 int fd;
01259 void* handle;
01261 int write_delay;
01262 int post_write_delay;
01263 struct { int tv_sec,tv_usec; } post_write_date;
01264 int timeout;
01265 int retry;
01267 char pathname[FILPATHLEN];
01268 union {
01269 struct {
01270 int rate;
01271 int data_bits;
01272 int stop_bits;
01273 enum serial_parity_e parity;
01274 enum serial_handshake_e handshake;
01275 enum serial_control_state_e rts_state;
01276 enum serial_control_state_e dtr_state;
01277 } serial;
01278 struct {
01279 int pin;
01280 } parallel;
01281 struct {
01282 int vid;
01283 int pid;
01284 int conf;
01285 int iface;
01286 int alt;
01287 } usb;
01288 } parm;
01289 } hamlib_port_t;
01290
01291 #if !defined(__APPLE__) || !defined(__cplusplus)
01292 typedef hamlib_port_t port_t;
01293 #endif
01294
01295
01305 struct rig_state {
01306
01307
01308
01309 hamlib_port_t rigport;
01310 hamlib_port_t pttport;
01311 hamlib_port_t dcdport;
01313 double vfo_comp;
01315 int itu_region;
01316 freq_range_t rx_range_list[FRQRANGESIZ];
01317 freq_range_t tx_range_list[FRQRANGESIZ];
01319 struct tuning_step_list tuning_steps[TSLSTSIZ];
01321 struct filter_list filters[FLTLSTSIZ];
01323 cal_table_t str_cal;
01325 chan_t chan_list[CHANLSTSIZ];
01327 shortfreq_t max_rit;
01328 shortfreq_t max_xit;
01329 shortfreq_t max_ifshift;
01331 ann_t announces;
01333 int preamp[MAXDBLSTSIZ];
01334 int attenuator[MAXDBLSTSIZ];
01336 setting_t has_get_func;
01337 setting_t has_set_func;
01338 setting_t has_get_level;
01339 setting_t has_set_level;
01340 setting_t has_get_parm;
01341 setting_t has_set_parm;
01343 gran_t level_gran[RIG_SETTING_MAX];
01344 gran_t parm_gran[RIG_SETTING_MAX];
01347
01348
01349
01350
01351 int hold_decode;
01352 vfo_t current_vfo;
01353 int vfo_list;
01354 int comm_state;
01355 rig_ptr_t priv;
01356 rig_ptr_t obj;
01358 int transceive;
01359 int poll_interval;
01360 freq_t current_freq;
01361 rmode_t current_mode;
01362 pbwidth_t current_width;
01364 };
01365
01366
01367 typedef int (*vprintf_cb_t) (enum rig_debug_level_e, rig_ptr_t, const char *, va_list);
01368
01369 typedef int (*freq_cb_t) (RIG *, vfo_t, freq_t, rig_ptr_t);
01370 typedef int (*mode_cb_t) (RIG *, vfo_t, rmode_t, pbwidth_t, rig_ptr_t);
01371 typedef int (*vfo_cb_t) (RIG *, vfo_t, rig_ptr_t);
01372 typedef int (*ptt_cb_t) (RIG *, vfo_t, ptt_t, rig_ptr_t);
01373 typedef int (*dcd_cb_t) (RIG *, vfo_t, dcd_t, rig_ptr_t);
01374 typedef int (*pltune_cb_t) (RIG *, vfo_t, freq_t *, rmode_t *, pbwidth_t *, rig_ptr_t);
01375
01393 struct rig_callbacks {
01394 freq_cb_t freq_event;
01395 rig_ptr_t freq_arg;
01396 mode_cb_t mode_event;
01397 rig_ptr_t mode_arg;
01398 vfo_cb_t vfo_event;
01399 rig_ptr_t vfo_arg;
01400 ptt_cb_t ptt_event;
01401 rig_ptr_t ptt_arg;
01402 dcd_cb_t dcd_event;
01403 rig_ptr_t dcd_arg;
01404 pltune_cb_t pltune;
01405 rig_ptr_t pltune_arg;
01406
01407 };
01408
01418 struct rig {
01419 struct rig_caps *caps;
01420 struct rig_state state;
01421 struct rig_callbacks callbacks;
01422 };
01423
01424
01425
01426
01427
01428 extern HAMLIB_EXPORT(RIG *) rig_init HAMLIB_PARAMS((rig_model_t rig_model));
01429 extern HAMLIB_EXPORT(int) rig_open HAMLIB_PARAMS((RIG *rig));
01430
01431
01432
01433
01434
01435
01436 extern HAMLIB_EXPORT(int) rig_set_freq HAMLIB_PARAMS((RIG *rig, vfo_t vfo, freq_t freq));
01437 extern HAMLIB_EXPORT(int) rig_get_freq HAMLIB_PARAMS((RIG *rig, vfo_t vfo, freq_t *freq));
01438
01439 extern HAMLIB_EXPORT(int) rig_set_mode HAMLIB_PARAMS((RIG *rig, vfo_t vfo, rmode_t mode, pbwidth_t width));
01440 extern HAMLIB_EXPORT(int) rig_get_mode HAMLIB_PARAMS((RIG *rig, vfo_t vfo, rmode_t *mode, pbwidth_t *width));
01441
01442 extern HAMLIB_EXPORT(int) rig_set_vfo HAMLIB_PARAMS((RIG *rig, vfo_t vfo));
01443 extern HAMLIB_EXPORT(int) rig_get_vfo HAMLIB_PARAMS((RIG *rig, vfo_t *vfo));
01444
01445 extern HAMLIB_EXPORT(int) rig_set_ptt HAMLIB_PARAMS((RIG *rig, vfo_t vfo, ptt_t ptt));
01446 extern HAMLIB_EXPORT(int) rig_get_ptt HAMLIB_PARAMS((RIG *rig, vfo_t vfo, ptt_t *ptt));
01447
01448 extern HAMLIB_EXPORT(int) rig_get_dcd HAMLIB_PARAMS((RIG *rig, vfo_t vfo, dcd_t *dcd));
01449
01450 extern HAMLIB_EXPORT(int) rig_set_rptr_shift HAMLIB_PARAMS((RIG *rig, vfo_t vfo, rptr_shift_t rptr_shift));
01451 extern HAMLIB_EXPORT(int) rig_get_rptr_shift HAMLIB_PARAMS((RIG *rig, vfo_t vfo, rptr_shift_t *rptr_shift));
01452 extern HAMLIB_EXPORT(int) rig_set_rptr_offs HAMLIB_PARAMS((RIG *rig, vfo_t vfo, shortfreq_t rptr_offs));
01453 extern HAMLIB_EXPORT(int) rig_get_rptr_offs HAMLIB_PARAMS((RIG *rig, vfo_t vfo, shortfreq_t *rptr_offs));
01454
01455 extern HAMLIB_EXPORT(int) rig_set_ctcss_tone HAMLIB_PARAMS((RIG *rig, vfo_t vfo, tone_t tone));
01456 extern HAMLIB_EXPORT(int) rig_get_ctcss_tone HAMLIB_PARAMS((RIG *rig, vfo_t vfo, tone_t *tone));
01457 extern HAMLIB_EXPORT(int) rig_set_dcs_code HAMLIB_PARAMS((RIG *rig, vfo_t vfo, tone_t code));
01458 extern HAMLIB_EXPORT(int) rig_get_dcs_code HAMLIB_PARAMS((RIG *rig, vfo_t vfo, tone_t *code));
01459
01460 extern HAMLIB_EXPORT(int) rig_set_ctcss_sql HAMLIB_PARAMS((RIG *rig, vfo_t vfo, tone_t tone));
01461 extern HAMLIB_EXPORT(int) rig_get_ctcss_sql HAMLIB_PARAMS((RIG *rig, vfo_t vfo, tone_t *tone));
01462 extern HAMLIB_EXPORT(int) rig_set_dcs_sql HAMLIB_PARAMS((RIG *rig, vfo_t vfo, tone_t code));
01463 extern HAMLIB_EXPORT(int) rig_get_dcs_sql HAMLIB_PARAMS((RIG *rig, vfo_t vfo, tone_t *code));
01464
01465 extern HAMLIB_EXPORT(int) rig_set_split_freq HAMLIB_PARAMS((RIG *rig, vfo_t vfo, freq_t tx_freq));
01466 extern HAMLIB_EXPORT(int) rig_get_split_freq HAMLIB_PARAMS((RIG *rig, vfo_t vfo, freq_t *tx_freq));
01467 extern HAMLIB_EXPORT(int) rig_set_split_mode HAMLIB_PARAMS((RIG *rig, vfo_t vfo, rmode_t tx_mode, pbwidth_t tx_width));
01468 extern HAMLIB_EXPORT(int) rig_get_split_mode HAMLIB_PARAMS((RIG *rig, vfo_t vfo, rmode_t *tx_mode, pbwidth_t *tx_width));
01469 extern HAMLIB_EXPORT(int) rig_set_split_vfo HAMLIB_PARAMS((RIG*, vfo_t rx_vfo, split_t split, vfo_t tx_vfo));
01470 extern HAMLIB_EXPORT(int) rig_get_split_vfo HAMLIB_PARAMS((RIG*, vfo_t rx_vfo, split_t *split, vfo_t *tx_vfo));
01471 #define rig_set_split(r,v,s) rig_set_split_vfo((r),(v),(s),RIG_VFO_CURR)
01472 #define rig_get_split(r,v,s) ({ vfo_t _tx_vfo; rig_get_split_vfo((r),(v),(s),&_tx_vfo); })
01473
01474 extern HAMLIB_EXPORT(int) rig_set_rit HAMLIB_PARAMS((RIG *rig, vfo_t vfo, shortfreq_t rit));
01475 extern HAMLIB_EXPORT(int) rig_get_rit HAMLIB_PARAMS((RIG *rig, vfo_t vfo, shortfreq_t *rit));
01476 extern HAMLIB_EXPORT(int) rig_set_xit HAMLIB_PARAMS((RIG *rig, vfo_t vfo, shortfreq_t xit));
01477 extern HAMLIB_EXPORT(int) rig_get_xit HAMLIB_PARAMS((RIG *rig, vfo_t vfo, shortfreq_t *xit));
01478
01479 extern HAMLIB_EXPORT(int) rig_set_ts HAMLIB_PARAMS((RIG *rig, vfo_t vfo, shortfreq_t ts));
01480 extern HAMLIB_EXPORT(int) rig_get_ts HAMLIB_PARAMS((RIG *rig, vfo_t vfo, shortfreq_t *ts));
01481
01482 extern HAMLIB_EXPORT(int) rig_power2mW HAMLIB_PARAMS((RIG *rig, unsigned int *mwpower, float power, freq_t freq, rmode_t mode));
01483 extern HAMLIB_EXPORT(int) rig_mW2power HAMLIB_PARAMS((RIG *rig, float *power, unsigned int mwpower, freq_t freq, rmode_t mode));
01484
01485 extern HAMLIB_EXPORT(shortfreq_t) rig_get_resolution HAMLIB_PARAMS((RIG *rig, rmode_t mode));
01486
01487 extern HAMLIB_EXPORT(int) rig_set_level HAMLIB_PARAMS((RIG *rig, vfo_t vfo, setting_t level, value_t val));
01488 extern HAMLIB_EXPORT(int) rig_get_level HAMLIB_PARAMS((RIG *rig, vfo_t vfo, setting_t level, value_t *val));
01489
01490 #define rig_get_strength(r,v,s) rig_get_level((r),(v),RIG_LEVEL_STRENGTH, (value_t*)(s))
01491
01492 extern HAMLIB_EXPORT(int) rig_set_parm HAMLIB_PARAMS((RIG *rig, setting_t parm, value_t val));
01493 extern HAMLIB_EXPORT(int) rig_get_parm HAMLIB_PARAMS((RIG *rig, setting_t parm, value_t *val));
01494
01495 extern HAMLIB_EXPORT(int) rig_set_conf HAMLIB_PARAMS((RIG *rig, token_t token, const char *val));
01496 extern HAMLIB_EXPORT(int) rig_get_conf HAMLIB_PARAMS((RIG *rig, token_t token, char *val));
01497
01498 extern HAMLIB_EXPORT(int) rig_set_powerstat HAMLIB_PARAMS((RIG *rig, powerstat_t status));
01499 extern HAMLIB_EXPORT(int) rig_get_powerstat HAMLIB_PARAMS((RIG *rig, powerstat_t *status));
01500
01501 extern HAMLIB_EXPORT(int) rig_reset HAMLIB_PARAMS((RIG *rig, reset_t reset));
01502
01503 extern HAMLIB_EXPORT(int) rig_set_ext_level HAMLIB_PARAMS((RIG *rig, vfo_t vfo,
01504 token_t token, value_t val));
01505 extern HAMLIB_EXPORT(int) rig_get_ext_level HAMLIB_PARAMS((RIG *rig, vfo_t vfo,
01506 token_t token, value_t *val));
01507
01508 extern HAMLIB_EXPORT(int) rig_set_ext_parm HAMLIB_PARAMS((RIG *rig, token_t token, value_t val));
01509 extern HAMLIB_EXPORT(int) rig_get_ext_parm HAMLIB_PARAMS((RIG *rig, token_t token, value_t *val));
01510
01511 extern HAMLIB_EXPORT(int) rig_ext_level_foreach HAMLIB_PARAMS((RIG *rig, int (*cfunc)(RIG*, const struct confparams *, rig_ptr_t), rig_ptr_t data));
01512 extern HAMLIB_EXPORT(int) rig_ext_parm_foreach HAMLIB_PARAMS((RIG *rig, int (*cfunc)(RIG*, const struct confparams *, rig_ptr_t), rig_ptr_t data));
01513 extern HAMLIB_EXPORT(const struct confparams*) rig_ext_lookup HAMLIB_PARAMS((RIG *rig, const char *name));
01514 extern HAMLIB_EXPORT(const struct confparams *) rig_ext_lookup_tok HAMLIB_PARAMS((RIG *rig, token_t token));
01515 extern HAMLIB_EXPORT(token_t) rig_ext_token_lookup HAMLIB_PARAMS((RIG *rig, const char *name));
01516
01517
01518 extern HAMLIB_EXPORT(int) rig_token_foreach HAMLIB_PARAMS((RIG *rig, int (*cfunc)(const struct confparams *, rig_ptr_t), rig_ptr_t data));
01519 extern HAMLIB_EXPORT(const struct confparams*) rig_confparam_lookup HAMLIB_PARAMS((RIG *rig, const char *name));
01520 extern HAMLIB_EXPORT(token_t) rig_token_lookup HAMLIB_PARAMS((RIG *rig, const char *name));
01521
01522 extern HAMLIB_EXPORT(int) rig_close HAMLIB_PARAMS((RIG *rig));
01523 extern HAMLIB_EXPORT(int) rig_cleanup HAMLIB_PARAMS((RIG *rig));
01524
01525 extern HAMLIB_EXPORT(int) rig_set_ant HAMLIB_PARAMS((RIG *rig, vfo_t vfo, ant_t ant));
01526 extern HAMLIB_EXPORT(int) rig_get_ant HAMLIB_PARAMS((RIG *rig, vfo_t vfo, ant_t *ant));
01527
01528 extern HAMLIB_EXPORT(setting_t) rig_has_get_level HAMLIB_PARAMS((RIG *rig, setting_t level));
01529 extern HAMLIB_EXPORT(setting_t) rig_has_set_level HAMLIB_PARAMS((RIG *rig, setting_t level));
01530
01531 extern HAMLIB_EXPORT(setting_t) rig_has_get_parm HAMLIB_PARAMS((RIG *rig, setting_t parm));
01532 extern HAMLIB_EXPORT(setting_t) rig_has_set_parm HAMLIB_PARAMS((RIG *rig, setting_t parm));
01533
01534 extern HAMLIB_EXPORT(setting_t) rig_has_get_func HAMLIB_PARAMS((RIG *rig, setting_t func));
01535 extern HAMLIB_EXPORT(setting_t) rig_has_set_func HAMLIB_PARAMS((RIG *rig, setting_t func));
01536
01537 extern HAMLIB_EXPORT(int) rig_set_func HAMLIB_PARAMS((RIG *rig, vfo_t vfo, setting_t func, int status));
01538 extern HAMLIB_EXPORT(int) rig_get_func HAMLIB_PARAMS((RIG *rig, vfo_t vfo, setting_t func, int *status));
01539
01540 extern HAMLIB_EXPORT(int) rig_send_dtmf HAMLIB_PARAMS((RIG *rig, vfo_t vfo, const char *digits));
01541 extern HAMLIB_EXPORT(int) rig_recv_dtmf HAMLIB_PARAMS((RIG *rig, vfo_t vfo, char *digits, int *length));
01542 extern HAMLIB_EXPORT(int) rig_send_morse HAMLIB_PARAMS((RIG *rig, vfo_t vfo, const char *msg));
01543
01544 extern HAMLIB_EXPORT(int) rig_set_bank HAMLIB_PARAMS((RIG *rig, vfo_t vfo, int bank));
01545 extern HAMLIB_EXPORT(int) rig_set_mem HAMLIB_PARAMS((RIG *rig, vfo_t vfo, int ch));
01546 extern HAMLIB_EXPORT(int) rig_get_mem HAMLIB_PARAMS((RIG *rig, vfo_t vfo, int *ch));
01547 extern HAMLIB_EXPORT(int) rig_vfo_op HAMLIB_PARAMS((RIG *rig, vfo_t vfo, vfo_op_t op));
01548 extern HAMLIB_EXPORT(vfo_op_t) rig_has_vfo_op HAMLIB_PARAMS((RIG *rig, vfo_op_t op));
01549 extern HAMLIB_EXPORT(int) rig_scan HAMLIB_PARAMS((RIG *rig, vfo_t vfo, scan_t scan, int ch));
01550 extern HAMLIB_EXPORT(scan_t) rig_has_scan HAMLIB_PARAMS((RIG *rig, scan_t scan));
01551
01552 extern HAMLIB_EXPORT(int) rig_set_channel HAMLIB_PARAMS((RIG *rig, const channel_t *chan));
01553 extern HAMLIB_EXPORT(int) rig_get_channel HAMLIB_PARAMS((RIG *rig, channel_t *chan));
01554
01555 extern HAMLIB_EXPORT(int) rig_set_chan_all HAMLIB_PARAMS((RIG *rig, const channel_t chans[]));
01556 extern HAMLIB_EXPORT(int) rig_get_chan_all HAMLIB_PARAMS((RIG *rig, channel_t chans[]));
01557 extern HAMLIB_EXPORT(int) rig_set_chan_all_cb HAMLIB_PARAMS((RIG *rig, chan_cb_t chan_cb, rig_ptr_t));
01558 extern HAMLIB_EXPORT(int) rig_get_chan_all_cb HAMLIB_PARAMS((RIG *rig, chan_cb_t chan_cb, rig_ptr_t));
01559
01560 extern HAMLIB_EXPORT(int) rig_set_mem_all_cb HAMLIB_PARAMS((RIG *rig, chan_cb_t chan_cb, confval_cb_t parm_cb, rig_ptr_t));
01561 extern HAMLIB_EXPORT(int) rig_get_mem_all_cb HAMLIB_PARAMS((RIG *rig, chan_cb_t chan_cb, confval_cb_t parm_cb, rig_ptr_t));
01562 extern HAMLIB_EXPORT(int) rig_set_mem_all HAMLIB_PARAMS((RIG *rig, const channel_t *chan, const struct confparams *, const value_t *));
01563 extern HAMLIB_EXPORT(int) rig_get_mem_all HAMLIB_PARAMS((RIG *rig, channel_t *chan, const struct confparams *, value_t *));
01564
01565 extern HAMLIB_EXPORT(int) rig_set_trn HAMLIB_PARAMS((RIG *rig, int trn));
01566 extern HAMLIB_EXPORT(int) rig_get_trn HAMLIB_PARAMS((RIG *rig, int *trn));
01567 extern HAMLIB_EXPORT(int) rig_set_freq_callback HAMLIB_PARAMS((RIG *, freq_cb_t, rig_ptr_t));
01568 extern HAMLIB_EXPORT(int) rig_set_mode_callback HAMLIB_PARAMS((RIG *, mode_cb_t, rig_ptr_t));
01569 extern HAMLIB_EXPORT(int) rig_set_vfo_callback HAMLIB_PARAMS((RIG *, vfo_cb_t, rig_ptr_t));
01570 extern HAMLIB_EXPORT(int) rig_set_ptt_callback HAMLIB_PARAMS((RIG *, ptt_cb_t, rig_ptr_t));
01571 extern HAMLIB_EXPORT(int) rig_set_dcd_callback HAMLIB_PARAMS((RIG *, dcd_cb_t, rig_ptr_t));
01572 extern HAMLIB_EXPORT(int) rig_set_pltune_callback HAMLIB_PARAMS((RIG *, pltune_cb_t, rig_ptr_t));
01573
01574 extern HAMLIB_EXPORT(const char *) rig_get_info HAMLIB_PARAMS((RIG *rig));
01575
01576 extern HAMLIB_EXPORT(const struct rig_caps *) rig_get_caps HAMLIB_PARAMS((rig_model_t rig_model));
01577 extern HAMLIB_EXPORT(const freq_range_t *) rig_get_range HAMLIB_PARAMS((const freq_range_t range_list[], freq_t freq, rmode_t mode));
01578
01579 extern HAMLIB_EXPORT(pbwidth_t) rig_passband_normal HAMLIB_PARAMS((RIG *rig, rmode_t mode));
01580 extern HAMLIB_EXPORT(pbwidth_t) rig_passband_narrow HAMLIB_PARAMS((RIG *rig, rmode_t mode));
01581 extern HAMLIB_EXPORT(pbwidth_t) rig_passband_wide HAMLIB_PARAMS((RIG *rig, rmode_t mode));
01582
01583 extern HAMLIB_EXPORT(const char *) rigerror HAMLIB_PARAMS((int errnum));
01584
01585 extern HAMLIB_EXPORT(int) rig_setting2idx HAMLIB_PARAMS((setting_t s));
01586 #define rig_idx2setting(i) (1UL<<(i))
01587
01588
01589
01590
01591
01592 extern HAMLIB_EXPORT(void) rig_set_debug HAMLIB_PARAMS((enum rig_debug_level_e debug_level));
01593 #define rig_set_debug_level(level) rig_set_debug(level)
01594 extern HAMLIB_EXPORT(int) rig_need_debug HAMLIB_PARAMS((enum rig_debug_level_e debug_level));
01595 extern HAMLIB_EXPORT(void) rig_debug HAMLIB_PARAMS((enum rig_debug_level_e debug_level, const char *fmt, ...));
01596 extern HAMLIB_EXPORT(vprintf_cb_t) rig_set_debug_callback HAMLIB_PARAMS((vprintf_cb_t cb, rig_ptr_t arg));
01597 extern HAMLIB_EXPORT(FILE*) rig_set_debug_file HAMLIB_PARAMS((FILE *stream));
01598
01599 extern HAMLIB_EXPORT(int) rig_register HAMLIB_PARAMS((const struct rig_caps *caps));
01600 extern HAMLIB_EXPORT(int) rig_unregister HAMLIB_PARAMS((rig_model_t rig_model));
01601 extern HAMLIB_EXPORT(int) rig_list_foreach HAMLIB_PARAMS((int (*cfunc)(const struct rig_caps*, rig_ptr_t), rig_ptr_t data));
01602 extern HAMLIB_EXPORT(int) rig_load_backend HAMLIB_PARAMS((const char *be_name));
01603 extern HAMLIB_EXPORT(int) rig_check_backend HAMLIB_PARAMS((rig_model_t rig_model));
01604 extern HAMLIB_EXPORT(int) rig_load_all_backends HAMLIB_PARAMS((void));
01605
01606 typedef int (*rig_probe_func_t)(const hamlib_port_t *, rig_model_t, rig_ptr_t);
01607 extern HAMLIB_EXPORT(int) rig_probe_all HAMLIB_PARAMS((hamlib_port_t *p, rig_probe_func_t, rig_ptr_t));
01608 extern HAMLIB_EXPORT(rig_model_t) rig_probe HAMLIB_PARAMS((hamlib_port_t *p));
01609
01610
01611
01612 extern HAMLIB_EXPORT(const char *) rig_strrmode(rmode_t mode);
01613 extern HAMLIB_EXPORT(const char *) rig_strvfo(vfo_t vfo);
01614 extern HAMLIB_EXPORT(const char *) rig_strfunc(setting_t);
01615 extern HAMLIB_EXPORT(const char *) rig_strlevel(setting_t);
01616 extern HAMLIB_EXPORT(const char *) rig_strparm(setting_t);
01617 extern HAMLIB_EXPORT(const char *) rig_strptrshift(rptr_shift_t);
01618 extern HAMLIB_EXPORT(const char *) rig_strvfop(vfo_op_t op);
01619 extern HAMLIB_EXPORT(const char *) rig_strscan(scan_t scan);
01620 extern HAMLIB_EXPORT(const char *) rig_strstatus(enum rig_status_e status);
01621
01622 extern HAMLIB_EXPORT(rmode_t) rig_parse_mode(const char *s);
01623 extern HAMLIB_EXPORT(vfo_t) rig_parse_vfo(const char *s);
01624 extern HAMLIB_EXPORT(setting_t) rig_parse_func(const char *s);
01625 extern HAMLIB_EXPORT(setting_t) rig_parse_level(const char *s);
01626 extern HAMLIB_EXPORT(setting_t) rig_parse_parm(const char *s);
01627 extern HAMLIB_EXPORT(vfo_op_t) rig_parse_vfo_op(const char *s);
01628 extern HAMLIB_EXPORT(scan_t) rig_parse_scan(const char *s);
01629 extern HAMLIB_EXPORT(rptr_shift_t) rig_parse_rptr_shift(const char *s);
01630
01631
01632 __END_DECLS
01633
01634 #endif
01635