NAME¶
rotd - Hamlib rotator service daemon
SYNOPSIS¶
rpc.rotd [
OPTION]...
DESCRIPTION¶
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 welcome.
OPTIONS¶
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.
EXAMPLES¶
Start
rotd as root for a RotorEZ using a USB to serial adapter and
backgrounding:
# rpc.rotd -m 401 -r /dev/ttyUSB1 &
Start
rotd as root for a RotorEZ using COM1 while generating TRACE
output:
# 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 &
DIAGNOSTICS¶
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.
SECURITY¶
No authentication whatsoever; could be done through domain restriction, though.
Please ask if stronger security is needed.
BUGS¶
Does not support more than one communication device for multiple rotor control.
(e.g. for Single Operator 2 Radio) Help needed!
REPORTING BUGS¶
Report bugs to <hamlib-developer@lists.sourceforge.net>.
We are already aware of the bug in the previous section :-)
AUTHORS¶
Written by Stephane Fillod and the Hamlib Group
<
http://www.hamlib.org>.
COPYRIGHT¶
Copyright © 2000-2007 Stephane Fillod and the Hamlib Group. Contributed
by Francois Retief <fgretief@sun.ac.za>.
This is free software; see the source for copying conditions. There is NO
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
SEE ALSO¶
rotctl(1),
hamlib(3)