rigctl - Online en la nube

PROGRAMA:

NOMBRE

rigctl - transceptores y receptores de radio de control

SINOPSIS

rigctl [OPCIÓN] ... [COMANDO] ...

DESCRIPCIÓN

Control de transceptores y receptores de radio. rigctl acepta comandos desde la linea de comando
así como en modo interactivo si no se proporciona ninguno en la línea de comando.

Tenga en cuenta que Hamlib es un software de nivel BETA. Si bien muchas bibliotecas de backend carecen
soporte completo del equipo, las funciones básicas suelen estar bien soportadas. La API puede cambiar
sin previo aviso, mientras que un avance de la versión menor (por ejemplo, 1.1.xa 1.2.x)
indica tal cambio.

Informe los errores y envíe sus comentarios a la dirección de correo electrónico que se indica en REPORTING BUGS
sección. Los parches y las mejoras de código también son bienvenidos.

OPCIONES

Este programa sigue la sintaxis habitual de la línea de comandos GNU, con opciones largas que comienzan con
dos guiones (`- ').

A continuación, se muestra un resumen de las opciones admitidas:

-metro, --modelo = id
Seleccione el número de modelo de radio. Consulte la lista de modelos (use 'rigctl -l').

NB: rigctl (o software de terceros) utilizará el modelo de plataforma 1901 cuando se utilice rpc.rigd or
modelo de plataforma 2 para NET rigctl (rigctld).

-r, --rig-file = dispositivo
Utilice de dispositivos como el nombre de archivo del puerto al que está conectada la radio. A menudo una serie
puerto, pero podría ser un adaptador USB a serie. Normalmente / dev / ttyS0, / dev / ttyS1,
/ dev / ttyUSB0, etc. en Linux o COM1, COM2, etc. en Win32.

También se usa para especificar el host y el puerto para conectarse a un demonio rotctld de escucha en
POSIX:

-r localhost: 4532

y en Win32:

-r 127.0.0.1:4532

-pag, --ptt-file = dispositivo
Utilice de dispositivos como el nombre de archivo del dispositivo Push-To-Talk usando un archivo de dispositivo como
descrito arriba.

-D, --dcd-file = dispositivo
Utilice de dispositivos como el nombre de archivo del dispositivo Data Carrier Detect usando un archivo de dispositivo
como se describió anteriormente.

-PAG, --ptt-type = tipo
Utilice tipo del dispositivo Push-To-Talk. Los tipos admitidos son RIG, DTR, RTS, PARALLEL,
NINGUNO, prevalece sobre el tipo de PTT definido en el backend del equipo.

Algunos efectos secundarios de este comando son que cuando el tipo se establece en DTR, se lee el estado de PTT
proviene de la interfaz de Hamlib, no se lee de la radio. Cuando se establece en NINGUNO, estado PTT
no se puede leer o configurar incluso si el backend del equipo admite la lectura / configuración del estado de PTT desde
el aparejo.

-RE, --dcd-type = tipo
Utilice tipo del dispositivo Data Carrier Detect. Los tipos admitidos son RIG, DSR, CTS, CD,
PARALELO, NINGUNO.

-s, --serial-speed = baudios
Establezca la velocidad de serie en baudios índice. Utiliza la velocidad de serie máxima desde el backend de la plataforma
capacidades por defecto.

-C, --civaddr = id
Utilice id como la dirección CI-V para comunicarse con el equipo. Solo es útil para equipos Icom.

NB: el id está en notación decimal, a menos que tenga el prefijo 0x, en cuyo caso es
hexadecimal

-t, --send-cmd-term = char
Cambiar la terminación tanque para el protocolo de texto cuando se utiliza el enviar_cmd mando. los
el valor predeterminado es (0x0d). Los caracteres imprimibles no ASCII se pueden especificar como
Número ASCII, en formato hexadecimal, precedido de 0x. Puede pasar un vacío
cadena de caracteres sin terminación. La cadena '-1' le dice a rigctl que cambie a binario
protocolo. Ver el enviar_cmd comando para una explicación más detallada.

Por ejemplo, para especificar un terminador de comando para los comandos de texto de estilo Kenwood, pase
"-t ';'" para rigctl. Vea los EJEMPLOS a continuación.

-l, --show-conf
Enumere todos los parámetros de configuración para la radio definida con -m arriba.

-VS, --set-conf = parm = val [, parm = val] *
Establecer parámetro de configuración. por ejemplo, stop_bits = 2

Utilice la opción -L para una lista.

-yo, --lista
Enumere todos los números de modelo definidos en Hamlib y salir. A partir de 1.2.15.1 la lista es
ordenados por número de modelo.

NB En Linux, la lista se puede desplazar hacia atrás usando Shift-PageUp / Shift-PageDown, o
usando las barras de desplazamiento de un terminal virtual en X o la ventana cmd en Windows. los
la salida se puede canalizar a 'más' o 'menos', por ejemplo, 'rigctl -l | más'.

-tu, - tapas de descarga
Volcar capacidades para la radio definida con -m arriba y salir.

-Oh, --vfo
Configure el modo VFO, requiriendo un argumento VFO adicional delante de cada comando apropiado.
De lo contrario, se asume VFO_CURR cuando esta opción no está configurada.

-v, --verboso
Configure el modo detallado, acumulativo (consulte DIAGNÓSTICO a continuación).

-h, --ayuda
Muestre un resumen de estas opciones y salga.

-V, --versión
Mostrar versión de rigctl y salir

NB Es posible que un backend determinado no implemente algunas opciones y devolverán un error.
Esto es más probable que ocurra con el --set-conf y --show-conf .

Tenga en cuenta que el backend de la radio que se va a controlar, o la radio en sí, puede no
admite algunos comandos. En ese caso, la operación fallará con un Hamlib código de error.

COMANDOS

Los comandos se pueden ingresar como un solo carácter o como un nombre de comando largo. Básicamente,
los comandos no aparecen delante de ellos en la línea de comandos, como lo hacen las opciones.
Se pueden escribir cuando están en modo interactivo o se pueden proporcionar como argumento (s) en la línea de comando
modo de interfaz.

Como la mayoría de los Hamlib las operaciones tienen un . y get método, una letra mayúscula
ser usado para . mientras que la letra minúscula correspondiente se refiere a la get
método. Cada operación también tiene un nombre largo; en modo interactivo, anteponga una barra invertida a
ingrese un nombre de comando largo.

Ejemplo: Utilice "\ dump_caps" para ver lo que puede hacer esta radio.

Tenga en cuenta que el backend de la radio que se va a controlar, o la radio en sí, puede no
admite algunos comandos. En ese caso, la operación fallará con un Hamlib mensaje de error.

A continuación se muestra un resumen de los comandos admitidos (en el caso de los comandos "set", los
La cadena se reemplaza por el valor en la descripción. En el caso de los comandos "get", el
cadena entre comillas es el nombre clave del valor devuelto.):

Q | q, salida rigctl
Salga de rigctl en modo interactivo.

Cuando rigctl esté controlando la plataforma directamente, cerrará el backend y el puerto de la plataforma.
Cuando rigctl está conectado a rigctld (modelo de plataforma 2), la conexión TCP / IP a rigctld
está cerrado y rigctld permanece en ejecución, disponible para otra red TCP / IP
conexión.

F, establecer_frecuencia 'Frecuencia'
Configure la 'Frecuencia', en Hz.

f, obtener_frecuencia
Obtenga 'Frecuencia', en Hz.

M, modo de ajuste 'Modo' 'Banda de paso'
Configure el 'Modo': USB, LSB, CW, CWR, RTTY, RTTYR, AM, FM, WFM, AMS, PKTLSB, PKTUSB,
PKTFM, ECSSUSB, ECSSLSB, FAX, SAM, SAL, SAH, DSB.

Establezca 'Passband' en Hz, o '0' para el backend de Hamlib predeterminado.

m, obtener_modo
Obtenga el 'Modo' 'Banda de paso'.

Devuelve el modo como una cadena de modo de ajuste arriba y Passband en Hz.

V, set_vfo 'VFO'
Configure 'VFO': VFOA, VFOB, VFOC, currVFO, VFO, MEM, Principal, Sub, TX, RX.

En el modo VFO solo se requiere un único parámetro VFO.

v, get_vfo
Obtenga el 'VFO' actual.

Devuelve VFO como una cadena de set_vfo anterior.

J, conjunto_rit 'RIT'
Configure 'RIT', en Hz, puede ser + o -.

Un valor de '0' restablece RIT y * debería * apagar RIT. Si no es así, presente un informe de error
contra el backend de Hamlib.

j, obtener_rit
Obtenga 'RIT', en Hz.

Z, set_xit 'XIT'
Configure 'XIT', en Hz puede ser + o -.

Un valor de '0' restablece RIT y * debería * apagar RIT. Si no es así, presente un informe de error
contra el backend de Hamlib.

z, salir_salir
Obtenga 'XIT', en Hz.

T, establecer_ptt 'PTT'
Configure 'PTT', 0 (RX), 1 (TX), 2 (Micrófono TX), 3 (Datos TX).

t, obtener_ptt
Obtenga el estado 'PTT'.

0x8b, obtener_dcd
Obtener estado 'DCD' (silenciador), 0 (cerrado) o 1 (abierto)

R, set_rptr_shift 'Rptr Cambio'
Establezca 'Rptr Shift': "+", "-" o algo más para ninguno.

r, get_rptr_shift
Obtenga 'Rptr Shift'. Devuelve "+", "-" o "Ninguno".

O, set_rptr_offs 'Rptr Compensar'
Configure 'Rptr Offset', en Hz.

o, get_rptr_offs
Obtenga 'Rptr Offset', en Hz.

C, establecer_ctcss_tono «CTCSS Tono'
Configure 'Tono CTCSS', en décimas de Hz.

c, obtener_ctcss_tono
Obtenga 'CTCSS Tone', en décimas de Hz.

D, set_dcs_code 'DCS Código'
Configure el 'Código DCS'.

d, obtener_dcs_code
Obtenga el 'Código DCS'.

0 x 90, set_ctcss_sql «CTCSS SQL '
Configure el tono 'CTCSS Sql', en décimas de Hz.

0 x 91, get_ctcss_sql
Obtenga el tono 'CTCSS Sql', en décimas de Hz.

0 x 92, conjunto_dcs_sql 'DCS SQL '
Establezca el código 'DCS Sql'.

0 x 93, get_dcs_sql
Obtenga el código 'DCS Sql'.

I, set_split_freq 'Tx Frecuencia'
Configure la 'Frecuencia TX', en Hz.

i, get_split_freq
Obtenga 'Frecuencia TX', en Hz.

X, establecer_modo_dividido 'TX Modo' 'TX Banda de paso '
Configure el 'Modo TX': AM, FM, CW, CWR, USB, LSB, RTTY, RTTYR, WFM, AMS, PKTLSB, PKTUSB,
PKTFM, ECSSUSB, ECSSLSB, FAX, SAM, SAL, SAH, DSB.

La 'TX Passband' es la banda de paso exacta en Hz, o '0' para el backend de Hamlib
predeterminada.

x, get_split_mode
Obtenga 'TX Mode' y 'TX Passband'.

Devuelve el modo TX como una cadena de establecer_modo_dividido por encima y la banda de paso de TX en Hz.

S, set_split_vfo 'Separar' 'TX VFO '
Configure el modo 'Split', '0' o '1' y 'TX VFO' desde set_vfo anterior.

s, get_split_vfo
Obtenga el modo 'Split', '0' o '1' y 'TX VFO'.

N, conjuntos_ts 'Afinación Paso'
Configure el 'Paso de afinación', en Hz.

n, obtener_ts
Obtenga 'Tuning Step', en Hz.

U, establecer_func 'Func' 'Func Estado'
Configure 'Func' 'Func Status'.

Func es uno de los siguientes: FAGC, NB, COMP, VOX, TONE, TSQL, SBKIN, FBKIN, ANF, NR, AIP, APF,
MON, MN, RF, ARO, LOCK, MUTE, VSC, REV, SQL, ABM, BC, MBC, AFC, SATMODE, SCOPE,
RESUMEN, TBURST, SINTONIZADOR.

El argumento Func Status es un valor no nulo para "activar", "desactivar" de lo contrario,
tanto como las definiciones VERDADERO / FALSO en lenguaje C.

u, get_func
Obtenga 'Func' 'Func Status'.

Devuelve Func como una cadena de establecer_func anterior y el estado de Func como un valor no nulo.

L, establecer_nivel 'Nivel' 'Nivel Valor'
Establezca 'Nivel' y 'Valor de nivel'.

El nivel es uno de: PREAMP, ATT, VOX, AF, RF, SQL, IF, APF, NR, PBT_IN, PBT_OUT,
CWPITCH, RFPOWER, MICGAIN, KEYSPD, NOTCHF, COMP, AGC (0: APAGADO, 1: SUPERRÁPIDO, 2: RÁPIDO,
3: LENTO, 4: USUARIO, 5: MEDIO, 6: AUTO), BKINDL, BAL, METER, VOXGAIN, ANTIVOX, SLOPE_LOW,
SLOPE_HIGH, RAWSTR, SWR, ALC, FUERZA.

El valor de nivel puede ser un número flotante o un número entero.

l, obtener_nivel
Obtenga 'Nivel' 'Valor de nivel'.

Devuelve Level como una cadena de establecer_nivel por encima y el valor de nivel como un flotador o
entero.

P, set_parm 'Parm' 'Parm Valor'
Establecer 'Parm' 'Valor de Parm'

Parm es uno de los siguientes: ANN, APO, BACKLIGHT, BEEP, TIME, BAT, KEYLIGHT.

p, obtener_parm
Obtenga 'Parm' 'Parm Value'.

Devuelve Parm como una cadena de set_parm arriba y Parm Value como un número flotante o entero.

B, conjunto_banco 'Banco'
Establezca 'Banco'. Establece el número de banco de memoria actual.

E, conjunto_mem 'Memoria#'
Configure el número de canal 'Memory #'.

e, obtener_mem
Obtenga el número de canal 'Memory #'.

G, vfo_op 'Mem / VFO Op '
Realice 'Mem / VFO Op'.

La operación Mem VFO es una de las siguientes: CPY, XCHG, FROM_VFO, TO_VFO, MCL, UP, DOWN, BAND_UP,
BAND_DOWN, IZQUIERDA, DERECHA, SINTONIZAR, CAMBIAR.

g, escanear 'Escanear Fct ' 'Escanear Canal'
Realice 'Scan Fct' 'Scan Channel'.

La función / canal de escaneo es uno de los siguientes: STOP, MEM, SLCT, PRIO, PROG, DELTA, VFO, PLT.

H, establecer_canal 'Canal'
Configure los datos del 'Canal' de la memoria. Aun no implementado.

h, obtener_canal
Obtener datos de 'Canal' de memoria. Aun no implementado.

A, conjunto_trn 'Transceptor'
Configure el modo 'Transceptor' (reporte de eventos): APAGADO, APAREJO, ENCUESTA.

a, obtener_trn
Obtenga el modo 'Transceive' (evento de informe) como en conjunto_trn anterior.

Y, conjunto_ant 'Antena'
Configure el número de 'Antena' (0, 1, 2, ..).

y, conseguir_ant
Obtenga el número de 'Antena' (0, 1, 2, ..).

*, reajustar 'Reiniciar'
Realice el 'Reset' del equipo.

0 = Ninguno, 1 = Restablecimiento del software, 2 = Restablecimiento del VFO, 4 = Restablecimiento del borrado de la memoria, 8 = Maestro
Reiniciar. Dado que estos valores se definen como una máscara de bits en rig.h, debería ser posible
a Y estos valores juntos para hacer varios restablecimientos a la vez, si el backend admite
o admite una acción de reinicio a través del control de plataforma.

b, enviar_morse 'Morse'
Envíe los símbolos 'Morse'.

0 x 87, set_powerstat 'Poder Estado'
Configure el 'Estado de energía' de Encendido / Apagado / En espera.

0 = Apagar, 1 = Encender, 2 = Energía en espera. Definido como una máscara de bits en rig.h.

0 x 88, get_powerstat
Obtenga el 'Estado de energía' encendido / apagado / en espera como en set_powerstat anterior.

0 x 89, enviar_dtmf 'Dígitos'
Establezca DTMF 'Dígitos'.

0x8a, recv_dtmf
Obtenga DTMF 'Dígitos'.

_, obtener información
Obtenga información miscelánea sobre el equipo (no se pasa ningún VFO en el 'modo VFO' o se pasa un valor).

1, tapas_volcados
No es un comando remoto de plataforma real, solo descarga capacidades, es decir, lo que el backend
conoce este modelo y lo que puede hacer.

TODO: asegúrese de que esté en un formato coherente para que pueda leerse en un hash,
diccionario, etc. Se solicitan informes de errores.

NB: Este comando producirá muchas líneas de salida, así que tenga mucho cuidado si usa un
matriz de longitud fija! Por ejemplo, ejecutar este comando en el backend ficticio
da como resultado más de 5kB de salida de texto.

El parámetro VFO no se utiliza en el 'modo VFO'.

2, potencia2mW 'Poder [0.0..1.0] ' 'Frecuencia' 'Modo'
Devuelve 'Power mW'

Convierte un valor de potencia en un rango de 0.0 ... 1.0 a la potencia de transmisión real en
milivatios (entero). los frecuencia y modo también debe proporcionarse como salida
la potencia puede variar según estos valores.

El parámetro VFO no se utiliza en el 'modo VFO'.

4, potencia mW2 'Poder mW ' 'Frecuencia' 'Modo'
Devuelve 'Potencia [0.0..1.0]'

Convierte la potencia de transmisión real en milivatios (entero) a un valor de potencia en un
gama de 0.0 ... 1.0. frecuencia y modo también debe proporcionarse como salida
la potencia puede variar según estos valores.

El parámetro VFO no se utiliza en el 'modo VFO'.

w, enviar_cmd 'Cmd'
Envíe una cadena de comando sin procesar a la plataforma. Esto es útil para probar y solucionar problemas de la plataforma.
comandos y respuestas al desarrollar un backend.

Para protocolos binarios, ingrese valores como \ 0xAA \ 0xBB. Espere una 'respuesta' de la plataforma
que probablemente será un bloque binario o una cadena ASCII dependiendo de la plataforma
protocolo (consulte la documentación de control de la computadora de su radio).

El terminador de comando, establecido por el enviar-cmd-term opción anterior, terminará cada
cadena de comando enviada a la radio. Este personaje no debe ser parte de la entrada.
cadena.

EJEMPLOS

Sus datos Aqui rigctl para un Yaesu FT-920 usando un adaptador USB a serie en Linux en modo interactivo
modo:

$ rigctl -m 114 -r / dev / ttyUSB1

Sus datos Aqui rigctl para un Yaesu FT-920 usando COM1 en Win32 mientras se genera la salida TRACE para
stderr:

C: \> rigctl -m 114 -r COM1 -vvvvv

Sus datos Aqui rigctl para un Yaesu FT-920 usando un adaptador USB a serie mientras configura la velocidad en baudios y
bits de parada:

$ rigctl -m 114 -r / dev / ttyUSB1 -s 4800 -C stop_bits = 2

Sus datos Aqui rigctl para un Elecraft K3 usando un adaptador USB a serie mientras se especifica un comando
terminador para el comando 'w':

$ rigctl -m 229 -r / dev / ttyUSB0 -t ';'

Sus datos Aqui rigctl usando rpc.rigd y configurar la frecuencia y el modo:

$ rigctl -m 1901 -r servidor local F 7253500 M LSB 0

Conéctese a una carrera rigctld con el modelo de plataforma 2 ("NET rigctl") en el host local y
especificando el puerto TCP en POSIX:

$ rigctl -m 2 -r localhost: 4532

y en Win32:

C: \> rigctl -m 2 -r 127.0.0.1:4532

La diagnostica

La -v, --verboso La opción permite que se envíen diferentes niveles de diagnóstico a stderr y
corresponden a -v para ERROR, -vv para ERR, -vvv para WARN, -vvvv para VERBOSE o -vvvvv para
RASTRO.

Un nivel detallado dado es útil para proporcionar la información de depuración necesaria al correo electrónico
dirección a continuación. Por ejemplo, la salida TRACE muestra todos los valores enviados y recibidos
de la radio, que es muy útil para el desarrollo de bibliotecas de backend de radio y puede ser
solicitado por los desarrolladores.

SALIR ESTADO

rigctl sale con:
0 si todas las operaciones se completaron normalmente;
1 si había una opción o argumento de línea de comando no válido;
2 si un error fue devuelto por Hamlib.

Use rigctl en línea usando los servicios de onworks.net