ROTCTL(1) Hamlib ROTCTL(1) (NAME) rotctl - (SYNOPSIS) rotctl [-hiIlLuV] [-m id] [-r device] [-R device2] [-s baud] [-t char] [-C parm=val] [-o azoffset] [-O eloffset] [-v[-Z]] [command|-] (DESCRIPTION) . rotctl ( ) . Hamlib (BETA) . . . . (OPTIONS) . . (`-') `=' . : -m, --model=id . ( "rotctl -l"). : rotctl ( C API ) NET rotctl ( rotctld) . -r, --rot-file=device device . USB . /dev/ttyS0, /dev/ttyS1, /dev/ttyUSB0 COM1, COM2 . BSD Mac OS/X . . -R, --rot-file2=device device . (Elevation). USB . /dev/ttyS0, /dev/ttyS1, /dev/ttyUSB0 COM1, COM2 . BSD Mac OS/X . . -s, --serial-speed=baud baud ( ). . -t, --send-cmd-term=char char send_cmd. CR (`0x0D') . "0x" . . "-1" rotctl () . send_cmd . : (`;') . -o, --set-azoffset (Azimuth) -- (set) (get) . -O, --set-eloffset (Elevation) -- (set) (get) . -L, --show-conf -m . -C, --set-conf=parm=val[,parm=val] () : stop_bits=2. -L . -u, --dump-caps -m . -l, --list Hamlib . . : Shift-PageUp/Shift-PageDown cmd . more(1) less(1) (pipe) : "rotctl -l | more". -i, --read-history ( $HOME/.rotctl_history) . rotctl Readline ( ). : ROTCTL_HIST_DIR : "ROTCTL_HIST_DIR=$HOME/tmp rotctl -i". ROTCTL_HIST_DIR HOME . -I, --save-history ( -i ) ( $HOME/.rotctl_history) . . rotctl Readline ( ). : ROTCTL_HIST_DIR : "ROTCTL_HIST_DIR=$HOME/tmp rotctl -I". ROTCTL_HIST_DIR HOME . -v, --verbose ( ). -Z, --debug-time-stamps (Timestamp) . -v . -h, --help . -V, --version rotctl . - . . : . --set-conf --show-conf . . Hamlib . (COMMANDS) . . . ( ): P 123 45 Hamlib set get set () get (/) . `\' . : "\get_info" . : . Hamlib . (Standard Input) READLINE rotctl (`-') (stdin) . . `#' `#' . : $ cat <<.EOF. >cmds.txt > # File of commands > set_pos 180.0 10.0 # rotate > pause 30 # wait for action to complete > get_pos # query rotator >.EOF. $ rotctl -m 1 - (Rotator Commands) ( set . get ): Q|q, exit rotctl rotctl . rotctl . rotctl rotctld ( ) TCP/IP rotctld rotctld TCP/IP . P, set_pos 'Azimuth' 'Elevation' . 'Azimuth' 'Elevation' . (Azimuth) - . (Elevation) - . : P 163.0 41.0 : ( ) "0.0" 'Elevation' . p, get_pos . 'Azimuth' 'Elevation' (double precision) . M, move 'Direction' 'Speed' . 'Direction' : `2' UP () `4' DOWN () `8' LEFT CCW ( ) `16' RIGHT CW ( ) `32' UP_LEFT UP_CCW `64' UP_RIGHT UP_CW `128' DOWN_LEFT DOWN_CCW `256' DOWN_RIGHT DOWN_CW. 'Speed' . - . : move Speed . S, stop . K, park . C, set_conf 'Token' 'Value' . 'Token' -C -L . 'Value' . R, reset 'Reset' () . 'Reset' `1' "Reset All" ( ) . _, get_info . 'Info' "Model Name" ( ) . dump_state . 1, dump_caps . w, send_cmd 'Cmd' . CR ( --send-cmd-term -t ) . () "\0xAA\0xBB" . (Locator Commands) Maidenhead . L, lonlat2loc 'Longitude' 'Latitude' 'Loc Len' Maidenhead ('Locator') 'Longitude' ( ) 'Latitude' ( ) . . 'Loc Len' . : L -170.0 -85.0 12 : Locator: AA55AA00AA00 l, loc2lonlat 'Locator' 'Longitude' 'Latitude' Maidenhead . 'Locator' . . . : l AA55AA00AA00 : Longitude: -169.999983 Latitude: -84.999991 : . D, dms2dec 'Degrees' 'Minutes' 'Seconds' 'S/W' 'Dec Degrees' ( ) . 'Degrees' 'Minutes' . 'Seconds' . 'S/W' `1' `0' ( DMS 'Degrees' ). d, dec2dms 'Dec Degrees' 'Degrees' 'Minutes' 'Seconds' 'S/W' . dms2dec . E, dmmm2dec 'Degrees' 'Dec Minutes' 'S/W' 'Dec Degrees' . 'Degrees' . 'Dec Minutes' . 'S/W' dms2dec . e, dec2dmmm 'Dec Deg' 'Degrees' 'Minutes' 'S/W' . dmmm2dec . B, qrb 'Lon 1' 'Lat 1' 'Lon 2' 'Lat 2' 'Distance' 'Azimuth' . 'Distance' () . 'Azimuth' ( ) . Lon/Lat . A, a_sp2a_lp 'Short Path Deg' 'Long Path Deg' . . : . a, d_sp2d_lp 'Short Path km' 'Long Path km' . . pause 'Seconds' 'Seconds' () . (READLINE) Readline rotctl Readline . Readline Readline . rotctl "rotctl" Readline ( $HOME/.inputrc) rotctl . Readline Readline . . . -i/--read-history -I/--save-history rotctl / ( -i -I ) rotctl . . ( ) . $HOME/.rotctl_history ROTCTL_HIST_DIR . ROTCTL_HIST_DIR HOME . . Readline . rotctl Readline . : Readline MS Windows Hamlib . rotctl MS Windows `cmd' . (DIAGNOSTICS) -v, --verbose stderr -v BUG -vv ERR -vvv WARN -vvvv VERBOSE -vvvvv TRACE. . TRACE . (EXIT STATUS) rotctl : 0 1 2 Hamlib . (EXAMPLES) rotctl RotorEZ : $ rotctl -m 401 -r /dev/ttyS0 rotctl RotorEZ COM2 MS Windows: > rotctl -m 401 -r COM2 rotctld ("NET rotctl") TCP : $ rotctl -m 2 -r localhost:4533 t_pos rotctl INDI localhost:5764: $ rotctl -m 2001 -r example.com:12345 rotctl INDI : $ rotctl -m 2001 -r @/tmp/indiserver INDI ( ) LGPLv2 . : indilib.org (BUGS) : Hamlib Developer mailing list (COPYING) Hamlib . (C) 2001-2011 Stephane Fillod (C) 2002-2017 the Hamlib Group ( ) (C) 2003-2020 Nate Bargmann COPYING . . (SEE ALSO) less(1), more(1), rotctld(1), hamlib(7) (COLOPHON) Hamlib Git : hamlib.org . Hamlib 2025-09-01 ROTCTL(1)