rotctl - En ligne dans le Cloud

PROGRAMME:

Nom

rotctl - rotateurs d'antenne de contrôle

SYNOPSIS

rotctl [OPTION]... [COMMAND] ...

DESCRIPTION

Rotateurs d'antenne de contrôle. rotctl accepte commandes à partir de la ligne de commande ainsi que dans
mode interactif si aucun n'est fourni sur la ligne de commande.

Gardez à l'esprit que Hamlib est un logiciel de niveau BETA. Alors que beaucoup de bibliothèques backend manquent
prise en charge complète du rig, les fonctions de base sont généralement bien prises en charge. L'API peut changer
sans préavis, tandis qu'un avancement de la version mineure (par exemple 1.1.x à 1.2.x)
indique un tel changement.

Veuillez signaler les bogues et fournir des commentaires à l'adresse e-mail indiquée dans le rapport de bogues
section. Les correctifs et les améliorations de code sont également les bienvenus.

OPTIONS

Ce programme suit la syntaxe habituelle de la ligne de commande GNU, avec de longues options commençant par
deux tirets (`-').

Voici un résumé des options prises en charge :

-m, --model=identifiant
Sélectionnez le numéro de modèle du rotateur. Voir la liste des modèles (utilisez 'rotctl -l').

NB: rotctl (ou un logiciel tiers) utilisera le modèle de plate-forme 1901 lors de l'utilisation rpc.rotd or
modèle de plate-forme 2 pour NET rotctl (rotctld).

-r, --rot-file=périphérique
Utilisez le dispositif comme nom de fichier du port auquel le rotateur est connecté. Souvent une série
port, mais il peut s'agir d'un adaptateur USB vers série ou d'un périphérique de port USB. Typiquement
/dev/ttyS0, /dev/ttyS1, /dev/ttyUSB0, etc. sous Linux ou COM1, COM2, etc. sous Win32.

Également utilisé pour spécifier l'hôte et le port pour se connecter à un démon rotctld d'écoute sur
POSIX :

-r hôtelocal:4533

et sur Win32 :

-r 127.0.0.1h4533

-Oui, --serial-speed=bauds
Réglez la vitesse série sur baud taux. Utilise la vitesse série maximale du backend du rotateur
capacités par défaut.

-t, --send-cmd-term=car
Modifier la résiliation carboniser pour le protocole de texte lors de l'utilisation du envoyer_cmd commander. le
la valeur par défaut est . Les caractères imprimables non ASCII peuvent être spécifiés en ASCII
nombre, au format hexadécimal, précédé de 0x. Vous pouvez passer une chaîne vide pour
pas de caractère de terminaison. La chaîne -1 indique à rotctl de passer au protocole binaire. Voir
le envoyer_cmd commande pour plus d'explications.

-L, --show-conf
Répertoriez tous les paramètres de configuration pour le rotor défini avec -m ci-dessus.

-Ç, --set-conf=parm=val[,parm=val]*
Définir le paramètre de configuration. par exemple --set_conf=stop_bits=2

Utilisez l'option -L pour une liste.

-tu, --dump caps
Capacités de vidage pour le rotor définies avec -m ci-dessus et sortie.

-l, --liste
Répertoriez tous les numéros de modèle définis dans Hamlib et sortie. Depuis 1.2.15.1, la liste est
triés par numéro de modèle.

NB Sous Linux, la liste peut être retournée en utilisant Shift-PageUp/Shift-PageDown, ou
à l'aide des barres de défilement d'un terminal virtuel sous X ou de la fenêtre cmd sous Windows. Les
la sortie peut être redirigée vers « plus » ou « moins », par exemple « rotctl -l | Suite'.

-dans, --verbeux
Définir le mode verbeux, cumulatif (voir DIAGNOSTICS ci-dessous).

-h, --Aidez-moi
Afficher le résumé de ces options et quitter.

-V, --version
Afficher la version de rotctl et sortie.

NB Certaines options peuvent ne pas être implémentées par un backend donné et renverront une erreur.
Ceci est le plus susceptible de se produire avec le --set-conf et --show-conf options.

Veuillez noter que le backend du rotateur à contrôler, ou le rotateur lui-même peut
ne prend pas en charge certaines commandes. Dans ce cas, l'opération échouera avec un Hamlib code d'erreur.

COMMANDES

Les commandes peuvent être saisies soit sous la forme d'un seul caractère, soit sous la forme d'un nom de commande long. Essentiellement,
les commandes ne prennent pas un tiret devant elles, contrairement aux options. Ils peuvent être saisis
lorsqu'il est en mode interactif ou fourni comme argument(s) en mode d'interface de ligne de commande.

Depuis la plupart des Hamlib les opérations ont un set et obtenez méthode, une lettre majuscule sera
être utilisé pour set méthode alors que la lettre minuscule correspondante fait référence à la obtenez
méthode. Chaque opération a également un nom long ; en mode interactif, ajoutez une barre oblique inverse à
entrez un nom de commande long.

Exemple : utilisez "\get_info" pour voir les informations du rotor.

Veuillez noter que le backend du rotateur à contrôler, ou le rotateur lui-même peut
ne prend pas en charge certaines commandes. Dans ce cas, l'opération échouera avec un Hamlib erreur
par voie électronique.

Un résumé des commandes est inclus ci-dessous (dans le cas des commandes "set", la chaîne entre guillemets
est remplacé par la valeur dans la description. Dans le cas des commandes "get", les guillemets
string est le nom de clé de la valeur renvoyée.) :

Q|q, sortie rotctl
Quittez rotctl en mode interactif.

Lorsque rotctl contrôle directement le rotor, ferme le backend du rotor et
Port. Lorsque rotctl est connecté à rotctld (rotor modèle 2), la connexion TCP/IP
to rotctld est fermé et rotctld reste en cours d'exécution, disponible pour un autre TCP/IP
connexion réseau.

P, set_pos 'Azimut' 'Élévation'
Définir la position : Azimut et Élévation en tant que valeurs à virgule flottante en double précision.

p, obtenir_pos
Obtenir la position : « Azimut » et « Élévation » en tant que valeurs à virgule flottante en double précision.

M, Bougez 'Direction' 'La vitesse'
Déplacez le rotateur dans une direction spécifique à la vitesse donnée.

Les valeurs sont des nombres entiers où la direction est définie comme 2 = haut, 4 = bas, 8 = gauche et
16 = Droit. La vitesse est un nombre entier compris entre 1 et 100. Tous les backends ne
implémentez la commande de déplacement utilisez la valeur de vitesse. Pour le moment, seul le gs232a
utilise le paramètre Speed.

S, Arrêtez
Arrêtez le rotateur.

K, parc
Garez l'antenne.

C, set_conf 'Jeton' 'Valeur'
Définissez un paramètre de configuration. Il est prudent de donner à « Jeton » une valeur de « 0 » (zéro).
« Valeur » peut être une chaîne de 20 caractères maximum.
Voir la sortie -L

R, réinitialiser 'Réinitialiser'
Réinitialiser le rotateur.

Valeur entière de « 1 » pour tout réinitialiser.

_, obtenir_info
Obtenez des informations diverses sur le rotateur.

Pour le moment, renvoie 'Nom du modèle'.

w, envoyer_cmd 'Cmd'
Envoyer une chaîne de commande brute au rotateur.
(ou send-cmd-term, voir -t option) est ajouté automatiquement à la fin de la
commande pour les protocoles de texte. Pour les protocoles binaires, entrez les valeurs sous la forme \0xAA\0xBB

Localisateur Commandes

Ces commandes offrent des conversions de Degrés Minutes Secondes vers d'autres formats, Maidenhead
conversions de localisateur carré et conversions de distance et d'azimut.

L, lonlat2loc 'Longitude' 'Latitude' 'Loc Len [2-12]'
Renvoie le localisateur de Maidenhead pour les 'Longitude' et 'Latitude' données.

Les deux sont des valeurs à virgule flottante. La précision du carré retourné est contrôlée
par 'Loc Len' qui doit être un entier pair entre 2 et 12.

Par exemple, "+L -170.000000 -85.000000 12\n" renvoie "Locator : AA55AA00AA00\n".

l, loc2lonlat 'Localisateur'
Renvoie « Longitude » et « Latitude » en degrés décimaux au centre approximatif de
le quadrillage demandé (malgré l'utilisation de variables en double précision
en interne, une erreur d'arrondi se produit). La longitude ouest est exprimée en négatif
valeur. La latitude sud est exprimée par une valeur négative. Le localisateur peut être de 2 à
12 caractères de longueur.

Par exemple, "+l AA55AA00AA00\n" renvoie "Longitude : -169.999983\nLatitude :
-84.999991\n".

D, dms2dec 'Degrés' 'Minutes' 'Secondes' 'S/W'
Renvoie 'Dec Degrees', une valeur à virgule flottante signée.

Les degrés et les minutes sont des valeurs entières et les secondes sont une valeur à virgule flottante. S/W
est un drapeau avec '1' indiquant la latitude sud ou la longitude ouest et '0' le nord ou
Est (le drapeau est nécessaire car les ordinateurs ne reconnaissent pas un zéro signé même si
seule la valeur Degrés est généralement signée en notation DMS).

d, déc2dms 'Déc Degrés'
Renvoie 'Degrés' 'Minutes' 'Secondes' 'S/W'.

Les valeurs sont comme dans dms2dec ci-dessus.

E, dmmm2déc 'Degrés' 'Déc Minutes' 'S/W'
Renvoie 'Dec Degrees', une valeur à virgule flottante signée.

Degrés est une valeur entière et Minutes est une valeur à virgule flottante. S/W est un drapeau
avec '1' indiquant la latitude Sud ou la longitude Ouest et '0' Nord ou Est (le
est nécessaire car les ordinateurs ne reconnaissent pas un zéro signé même si seul le
La valeur des degrés uniquement est généralement signée en notation DMS).

e, déc2dmmm 'Déc Deg'
Renvoie 'Degrés' 'Minutes' 'S/W'.

Les valeurs sont comme dans dmmm2dec ci-dessus.

B, QRB 'Lon 1' 'Lat 1' 'Lon 2' 'Lat 2'
Renvoie « Distance » « Azimut » où la distance est en km et l'azimut est en degrés.

Toutes les valeurs Lon/Lat sont des nombres à virgule flottante signés.

A, a_sp2a_lp 'Court Chemin Deg'
Renvoie 'Long Path Deg' ou -RIG_EINVAL en cas d'erreur de saisie.

Les deux sont des valeurs à virgule flottante comprises entre 0.00 et 360.00.

a, d_sp2d_lp 'Court Chemin km'
Renvoie 'Long Path km'.

Les deux sont des valeurs à virgule flottante.

EXEMPLES

Start rotctl pour RotorEZ utilisant le premier port série sous Linux :

$ rotctl -m 401 -r /dev/ttyS0

Start rotctl pour RotorEZ utilisant COM2 sur Win32 :

C:\> rotctl -m 401 -r COM2

Start rotctl grâce à rpc.rotd et en interrogeant la position :

$ rotctl -m 101 -r hôte local \get_pos

Connectez-vous à une course rotctld avec le modèle de rotor 2 ("NET rotctl") sur l'hôte local et
en spécifiant le port TCP sur POSIX :

$ rotctl -m 2 -r localhost:4533

et sur Win32 :

C:\> rotctl -m 2 -r 127.0.0.1:4533

DIAGNOSTIC

Le site de -v, --version L'option permet de sortir différents niveaux de diagnostics stderr et
correspondent à -v pour BUG, ​​-vv pour ERR, -vvv pour WARN, -vvvv pour VERBOSE ou -vvvvv pour
TRACER.

Un niveau détaillé donné est utile pour fournir les informations de débogage nécessaires à l'e-mail
adresse ci-dessous. Par exemple, la sortie TRACE affiche toutes les valeurs envoyées et reçues
de la radio, ce qui est très utile pour le développement d'une bibliothèque backend radio et peut être
demandé par les développeurs.

EXIT STATUT

rotctl sort avec :
0 si toutes les opérations se sont terminées normalement ;
1 s'il y avait une option ou un argument de ligne de commande non valide ;
2 si une erreur a été renvoyée par Hamlib.

Utilisez rotctl en ligne en utilisant les services onworks.net