rig_caps Struct Reference
[Rig (transceiver) API]

Rig data structure. More...

#include <rig.h>

Data Fields
rig_model_t	rig_model
const char *	model_name
const char *	mfg_name
const char *	version
const char *	copyright
enum rig_status_e	status
int	rig_type
ptt_type_t	ptt_type
dcd_type_t	dcd_type
rig_port_t	port_type
int	serial_rate_min
int	serial_rate_max
int	serial_data_bits
int	serial_stop_bits
enum serial_parity_e	serial_parity
enum serial_handshake_e	serial_handshake
int	write_delay
int	post_write_delay
int	timeout
int	retry
setting_t	has_get_func
setting_t	has_set_func
setting_t	has_get_level
setting_t	has_set_level
setting_t	has_get_parm
setting_t	has_set_parm
gran_t	level_gran [RIG_SETTING_MAX]
gran_t	parm_gran [RIG_SETTING_MAX]
struct confparams *	extparms
struct confparams *	extlevels
const tone_t *	ctcss_list
const tone_t *	dcs_list
int	preamp [MAXDBLSTSIZ]
int	attenuator [MAXDBLSTSIZ]
shortfreq_t	max_rit
shortfreq_t	max_xit
shortfreq_t	max_ifshift
ann_t	announces
vfo_op_t	vfo_ops
scan_t	scan_ops
int	targetable_vfo
int	transceive
int	bank_qty
int	chan_desc_sz
chan_t	chan_list [CHANLSTSIZ]
freq_range_t	rx_range_list1 [FRQRANGESIZ]
freq_range_t	tx_range_list1 [FRQRANGESIZ]
freq_range_t	rx_range_list2 [FRQRANGESIZ]
freq_range_t	tx_range_list2 [FRQRANGESIZ]
struct tuning_step_list	tuning_steps [TSLSTSIZ]
struct filter_list	filters [FLTLSTSIZ]
cal_table_t	str_cal
struct confparams *	cfgparams
const rig_ptr_t	priv
const char *	clone_combo_set
const char *	clone_combo_get

---

Detailed Description

Rig data structure.

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 inquiries about capabilities.

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. NB: don't move fields around, as backend depends on it when initializing their caps.

---

Field Documentation

ann_t rig_caps::announces

Announces bit field list

int rig_caps::attenuator[MAXDBLSTSIZ]

Preamp list in dB, 0 terminated

int rig_caps::bank_qty

Number of banks

struct confparams* rig_caps::cfgparams

Configuration parametres.

int rig_caps::chan_desc_sz

Max length of memory channel name

chan_t rig_caps::chan_list[CHANLSTSIZ]

Channel list, zero ended

const char* rig_caps::clone_combo_get

String describing key combination to enter save cloning mode

const char* rig_caps::clone_combo_set

String describing key combination to enter load cloning mode

const char* rig_caps::copyright

Copyright info.

const tone_t* rig_caps::ctcss_list

CTCSS tones list, zero ended

dcd_type_t rig_caps::dcd_type

Type of the DCD port.

const tone_t* rig_caps::dcs_list

DCS code list, zero ended

struct confparams* rig_caps::extlevels

Extension level list,

See also:

ext.c

struct confparams* rig_caps::extparms

Extension parm list,

See also:

ext.c

struct filter_list rig_caps::filters[FLTLSTSIZ]

mode/filter table, at -6dB

setting_t rig_caps::has_get_func

List of get functions

setting_t rig_caps::has_get_level

List of get level

setting_t rig_caps::has_get_parm

List of get parm

setting_t rig_caps::has_set_func

List of set functions

setting_t rig_caps::has_set_level

List of set level

setting_t rig_caps::has_set_parm

List of set parm

gran_t rig_caps::level_gran[RIG_SETTING_MAX]

level granularity (i.e. steps)

shortfreq_t rig_caps::max_ifshift

max absolute IF-SHIFT

shortfreq_t rig_caps::max_rit

max absolute RIT

shortfreq_t rig_caps::max_xit

max absolute XIT

const char* rig_caps::mfg_name

Manufacturer.

const char* rig_caps::model_name

Model name.

gran_t rig_caps::parm_gran[RIG_SETTING_MAX]

parm granularity (i.e. steps)

rig_port_t rig_caps::port_type

Type of communication port.

int rig_caps::post_write_delay

Delay between each commands send out, in mS

int rig_caps::preamp[MAXDBLSTSIZ]

Preamp list in dB, 0 terminated

const rig_ptr_t rig_caps::priv

Private data.

ptt_type_t rig_caps::ptt_type

Type of the PTT port.

int rig_caps::retry

Maximum number of retries if command fails, 0 to disable

rig_model_t rig_caps::rig_model

Rig model.

int rig_caps::rig_type

Rig type.

freq_range_t rig_caps::rx_range_list1[FRQRANGESIZ]

Receive frequency range list for ITU region 1

freq_range_t rig_caps::rx_range_list2[FRQRANGESIZ]

Receive frequency range list for ITU region 2

scan_t rig_caps::scan_ops

Scan bit field list

int rig_caps::serial_data_bits

Number of data bits.

enum serial_handshake_e rig_caps::serial_handshake

Handshake.

enum serial_parity_e rig_caps::serial_parity

Parity.

int rig_caps::serial_rate_max

Maximum serial speed.

int rig_caps::serial_rate_min

Minimum serial speed.

int rig_caps::serial_stop_bits

Number of stop bits.

enum rig_status_e rig_caps::status

Driver status.

cal_table_t rig_caps::str_cal

S-meter calibration table

int rig_caps::targetable_vfo

Bit field list of direct VFO access commands

int rig_caps::timeout

Timeout, in mS

int rig_caps::transceive

Supported transceive mode

struct tuning_step_list rig_caps::tuning_steps[TSLSTSIZ]

Tuning step list

freq_range_t rig_caps::tx_range_list1[FRQRANGESIZ]

Transmit frequency range list for ITU region 1

freq_range_t rig_caps::tx_range_list2[FRQRANGESIZ]

Transmit frequency range list for ITU region 2

const char* rig_caps::version

Driver version.

vfo_op_t rig_caps::vfo_ops

VFO op bit field list

int rig_caps::write_delay

Delay between each byte sent out, in mS

---

The documentation for this struct was generated from the following file:

• rig.h