Man Linux: Main Page and Category List


       rotd - Hamlib rotator service daemon


       rpc.rotd [OPTION]...


       The  rotd  program  is  a Hamlib rotator daemon that handles RPC client
       requests. This allows multiple user programs to share one rotator.   At
       this time multiple rotator support is not available (help needed!).

       Keep  in  mind  that  Hamlib  is  BETA  level software.  While a lot of
       backend libraries lack complete rig support, the  basic  functions  are
       usually  well supported.  The API may change without publicized notice,
       while an advancement  of  the  minor  version  (e.g.  1.1.x  to  1.2.x)
       indicates such a change.

       Please  report bugs and provide feedback at the e-mail address given in
       the REPORTING BUGS section.  Patches and  code  enhancements  are  also


       This  program  follows  the  usual  GNU  command line syntax, with long
       options starting with two dashes (`-').

       Here is a summary of the supported options:

       -m, --model=id
              Select rotator model number. See model list (use 'rotctl -l').
              NB: rotctl (or third party software) will use  rotor  model  101
              when using rotd.

       -r, --rot-file=device
              Use  device  as  the  file  name  of  the  port  the  rotator is
              connected.  Often a serial port, but could be a  USB  to  serial
              adapter.  Typically /dev/ttyS0, /dev/ttyS1, /dev/ttyUSB0, etc.

       -s, --serial-speed=baud
              Set  serial  speed  to baud rate. Uses maximum serial speed from
              rotor backend as the default.

       -C, --set-conf=parm=val[,parm=val]*
              Set config parameter.  e.g. stop_bits=2
              Use -L option of rotctl for a list.

       -t, --prog=number
              Use number as the RPC program number. The default is  536873369.

       -v, --verbose
              Set verbose mode, cumulative (see DIAGNOSTICS below).

       -h, --help
              Show summary of these options and exit.

       -V, --version
              Show version of rpc.rotd and exit.

       Please  note  that the backend for the rotator to be controlled, or the
       rotator itself may  not  support  some  commands.  In  that  case,  the
       operation will fail with a Hamlib error code.


       Start  rotd  as  root  for  a RotorEZ using a USB to serial adapter and

       # rpc.rotd -m 401 -r /dev/ttyUSB1 &

       Start rotd as root for a RotorEZ  using  COM1  while  generating  TRACE

       # rpc.rotd -m 401 -r /dev/ttyS0 -vvvvv

       Start  rotd  as  root for a RotorEZ using a USB to serial adapter while
       setting baud rate and stop bits and backgrounding:

       # rpc.rotd -m 401 -r /dev/ttyUSB1 -s 4800 -C stop_bits=2 &


       The -v, --version option allows different levels of diagnostics  to  be
       output  to  stderr  and correspond to -v for BUG, -vv for ERR, -vvv for
       WARN, -vvvv for VERBOSE, or -vvvvv for TRACE.

       A  given  verbose  level  is  useful  for  providing  needed  debugging
       information  to  the  email  address  below.  For example, TRACE output
       shows all of the values sent to and received from the rotator which  is
       very  useful  for  rotator  backend  library  development  and  may  be
       requested by the developers.


       No authentication whatsoever; could be done through domain restriction,
       though.  Please ask if stronger security is needed.


       Does  not support more than one communication device for multiple rotor
       control.  (e.g. for Single Operator 2 Radio)  Help needed!


       Report bugs to <>.
       We are already aware of the bug in the previous section :-)


       Written by Stephane Fillod and the Hamlib Group


       Copyright  (C)  2000-2007  Stephane  Fillod  and  the   Hamlib   Group.
       Contributed by Francois Retief <>.
       This is free software; see the source for copying conditions.  There is
       NO warranty; not even for MERCHANTABILITY or FITNESS FOR  A  PARTICULAR


       rotctl(1), hamlib(3)