Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
MODULETRX.CONF(5)		 File Formats		     MODULETRX.CONF(5)

NAME
       ModuleTrx.conf -	Configuration file for the SvxLink transceiver control
       module

DESCRIPTION
       svxlink is a general purpose voice service system for  ham  radio  use.
       This  man-page describe the SvxLink server configuration	for the	trans-
       ceiver control module.

       The transceiver control module is used to remotely control and  operate
       a  transceiver through a	SvxLink	node. The module is configured by set-
       ting up one or more bands to operate the	transceiver  on.  It  is  even
       possible	to support multiple transceivers by having multiple band defi-
       nitions but with	differing RX and TX configurations. This make it  pos-
       sible to	for example support HF,	VHF, UHF etc using the same module.

       It  is only possible to select the operating frequency through the com-
       mand interface but with intelligent band	configurations it is  possible
       to select the modulation	and other parameters as	well, like listen only
       bands.

       It is also possible to select a band through a shortcut.	The configured
       default	frequency for the band will then be selected. Single frequency
       channels	are configured by setting up a band that span  only  one  fre-
       quency.	The channel can	then be	selected by either entering a possibly
       configured shortcut or the frequency for	the channel.

       When entering a frequency on the	control	interface, a band is  selected
       that  match the entered frequency. If there are more than one band that
       match the frequency there are some rules	for which of the bands to  se-
       lect.

	      o	  If  the  new frequency falls within a	band that is a subband
		  of another band, the subband is selected. This make it  pos-
		  sible	to configure regions of	a larger band differently than
		  the whole band, like making parts of a band listen  only  or
		  selecting  another  modulation.  It also make	it possible to
		  define channels within the band that have different settings
		  like repeater	shift.

	      o	  If the new frequency falls within a band that	is overlapping
		  with the current band	but that is not	a subband of the  cur-
		  rent	band,  the band	having the lowest valued shortcut will
		  be selected. If there	is no shortcut	configured,  the  band
		  with the lowest lower	frequency limit	will be	selected.

	      o	  If  there  is	 a band	currently selected and the new band is
		  not a	subband, the transceiver will prefer to	 stay  on  the
		  current  band.  Another  band	 can be	selected explicitly by
		  setting a shortcut on	it and	first  use  that  shortcut  to
		  switch to the	other band.

	      o	  If  the above	rules does not appy it is undefined which band
		  get selected.

CONFIGURATION VARIABLES
       There are a couple of configuration variables that are  common  to  all
       modules.	   The	 documentation	 for   these   can  be	found  in  the
       svxlink.conf(5) manual page.

       Here is the description of all module specific configuration  variables
       that the	SvxLink	transceiver control module understands.	The configura-
       tion file consists of one global	section, that  by  default  is	called
       ModuleTrx,  and then there are one or more band configuration sections.
       The global configuration	variables will serve as	a default for all band
       configuration sections.

   ModuleTrx
       RX     Specify  a receiver configration section in the same way that it
	      is done in the rest of SvxLink. It is even possible to  use  re-
	      ceivers  defined	in other SvxLink configuration files. If a re-
	      ceiver is	defined	in the ModuleTrx configuration file it is good
	      practise,	 but not required, to prefix the configuration section
	      name with	ModuleTrx:, like [ModuleTrx:Rx1].

       TX     Specify a	transmitter configration section in the	same way  that
	      it  is  done  in the rest	of SvxLink. It is even possible	to use
	      transmitters defined in other SvxLink configuration files. If  a
	      transmitter is defined in	the ModuleTrx configuration file it is
	      good practise, but not required,	to  prefix  the	 configuration
	      section name with	ModuleTrx:, like [ModuleTrx:Tx1].

       RX_TIMEOUT
	      Specify  a  timeout,  in	seconds, after which the audio is sup-
	      pressed from the receiver. The audio will	 be  suppressed	 until
	      the squelch is closed.

       MODULATION
	      Specify  which  modulation  to  use. For a list of valid modula-
	      tions, have a look at the	documentation for the MODULATION vari-
	      able in the svxlink.conf(5) manual page.

       SHIFT  Specify  the  repeater  shift (e.g. split	transmit frequency) in
	      kHz.

   Band	Configuration Section
       A  band	specific  configuration	 section  must	be  named  like	 [Mod-
       uleTrx:Band:BANDNAME],  where BANDNAME should be	replaced with a	unique
       band name.

       A band specific configuration section may contain  the  same  variables
       that is listed above for	the ModuleTrx section. Setting the correspond-
       ing configuration variable here will override  the  global  default.  A
       band  configuration section may in addition have	the following configu-
       ration variables.

       FQ     This variable is required	and define the lower  and  upper  fre-
	      quencies	for the	band. The frequencies are in kHz and should be
	      given on the form	lower-upper.   For  a  single  frequency  band
	      (i.e. a channel) it is sufficient	to only	specify	the first fre-
	      quency.

       FQ_DEFAULT
	      This is the default frequency in kHz for a band. It is  used  to
	      set  the initial frequency for a band that is selected through a
	      shortcut.	If it is not set, the lower band limit will be used as
	      the default frequency.

       SHORTCUT
	      Define  a	 shortcut for a	band. The shortcut may be any positive
	      number except 0-9	which is reserved for module commands. If  the
	      shortcut	match  a command entered on the	command	interface, the
	      band will	be selected  immediately  and  the  frequency  set  by
	      FQ_DEFAULT  will	be  set.  If  more than	one band have the same
	      shortcut it is undefined which one will get selected.

FILES
       /etc/svxlink/svxlink.conf (or deprecated	/etc/svxlink.conf)
	      The system wide configuration file.

       ~/.svxlink/svxlink.conf
	      Per user configuration file.

       /etc/svxlink/svxlink.d/ModuleTrx.conf
	      Global modularized configuration file. Depends  on  the  CFG_DIR
	      configuration variable setting.

       ~/.svxlink/svxlink.d/ModuleTrx.conf
	      Per  user	modularized configuration file.	Depends	on the CFG_DIR
	      configuration variable setting.

AUTHOR
       Tobias Blomberg (SM0SVX)	<sm0svx	at users dot sourceforge dot net>

SEE ALSO
       svxlink.conf(5)

Linux				 JANUARI 2018		     MODULETRX.CONF(5)

NAME | DESCRIPTION | CONFIGURATION VARIABLES | FILES | AUTHOR | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=ModuleTrx.conf&sektion=5&manpath=FreeBSD+12.2-RELEASE+and+Ports>

home | help