cw - En ligne dans le Cloud

PROGRAMME:

Nom

cw - caractères sonores sous forme de code Morse sur la carte son ou le haut-parleur de la console

SYNOPSIS

cw [-s --système=SYSTÈME] [-d --appareil=DISPOSITIF] [-w --wpm=WPM] [-t --tone=HZ]
[-v --volume=POUR CENT] [-g --écart=GAP] [-k --pondération=POIDS] [-e --noecho]
[-m --nomssages] [-c --nocommands] [-o --nocombinations] [-p --nocomments]
[-f --infile=DOSSIER] [-h --help] [-V --version]

cw installé sur les systèmes GNU/Linux comprend à la fois la forme courte et la ligne de commande longue
options. cw installés sur d'autres systèmes d'exploitation peuvent comprendre uniquement la forme abrégée
options.

Il n'y a pas d'options obligatoires.

Les options peuvent être prédéfinies dans la variable d'environnement CW_OPTIONS. S'ils sont définis, ces
les options sont utilisées en premier ; les options de ligne de commande sont prioritaires.

DESCRIPTION

cw lit les caractères d'un fichier d'entrée ou d'une entrée standard et émet un son valide
caractère sous forme de code Morse sur la carte son système ou sur le haut-parleur de la console système.
Après ça sonne un personnage, cw le renvoie à la sortie standard. Le flux d'entrée peut
contiennent des chaînes de commande intégrées. Ceux-ci modifient les paramètres utilisés lors du son du
Morse. cw signale toute erreur dans les commandes intégrées sur l'erreur standard.

Utilisez la combinaison de touches 'Ctrl+D' pour quitter cw.

COMMAND LINE OPTIONS
cw comprend les options de ligne de commande suivantes. Les options du formulaire long peuvent ne pas être
disponible dans les versions non-LINUX.

-Oui, --system=SYSTÈME
Spécifie la façon dont cw génère des tons. Les valeurs valides sont : nul pour pas de tons,
juste les horaires, console pour les tonalités via le haut-parleur de la console, prends-le pour les tons
généré via la carte son du système en utilisant le système de son ALSA, Centre pour les tons
généré via la carte son du système à l'aide du système de son OSS, son d'impulsion pour les tons
généré par la carte son du système à l'aide du système de son PulseAudio, carte son pour
tonalités générées via la carte son du système, mais sans sélection explicite de
systeme audio. Ces valeurs peuvent être raccourcies en 'n', 'c', 'a', 'o', 'p' ou 's',
respectivement. La valeur par défaut est 'pulseaudio' (sur les systèmes avec PulseAudio
installé), suivi de 'oss'.

-ré, --device=APPAREIL
Spécifie le fichier de périphérique à ouvrir pour générer un son. cw utilisera par défaut
périphérique si aucun n'est spécifié. Les appareils par défaut sont : /dév/console pour le son
produit via la console, défaut pour système audio ALSA, /dev/audio pour le son OSS
, a défaut dispositif pour le système audio PulseAudio. Voir également NOTES ON EN UTILISANT A
SOUND CARTE ci-dessous.

-w, --wpm=MPM
Définit la vitesse d'envoi initiale en mots par minute. La valeur doit être comprise entre 4
et 60. La valeur par défaut est 12 WPM.

-t, --tone=Hz
Définit la hauteur initiale de la sirène en Hz. Cette valeur doit être comprise entre 0 et 4,000 XNUMX. UNE
la valeur 0 sélectionne un fonctionnement silencieux et peut être utilisée pour des contrôles de synchronisation ou d'autres
essai. La valeur par défaut est de 800 Hz,

-dans, --volume=POURCENT
Définit le volume d'envoi initial, en pourcentage du volume à pleine échelle. La valeur
doit être compris entre 0 et 100. La valeur par défaut est 70 %. Les volumes sonores fonctionnent pleinement
pour les sons de la carte son, mais cw impossible de contrôler le volume des tonalités depuis la console
conférencier. Dans ce cas, un volume de zéro est silencieux et toutes les autres valeurs de volume sont
simplement sonné.

-g, --écart=ÉCART
Définit l'espace supplémentaire initial, en longueurs de points, entre les caractères (le "Farnsworth"
retard). Il doit être compris entre 0 et 60. La valeur par défaut est 0.

-k, --pondération=POIDS
Définit la pondération initiale, en pourcentage de la longueur des points. Il doit être compris entre 20
et 80. La valeur par défaut est 50.

-e, --noecho
Arrête cw caractères en écho sur la sortie standard après qu'ils aient retenti. Le défaut
est d'avoir un écho.

-m, --pas de messages
Arrête cw impression de messages d'erreur sur erreur standard. La valeur par défaut est d'imprimer
des messages.

-c, --nocommandes
Arrête cw d'interpréter les commandes intégrées dans le flux d'entrée. La valeur par défaut est
pour interpréter les commandes intégrées.

-o, --nocombinaisons
Arrête cw de traiter les chaînes de caractères entre crochets [...] comme une seule combinaison
personnage. La valeur par défaut est d'honorer les combinaisons.

-p, --Sans commentaires
Arrête cw de traiter les chaînes de caractères entre crochets {...} comme des « commentaires ».
Les caractères à l'intérieur de ces accolades seront renvoyés à la sortie standard, mais pas sonnés.
Lorsque les commentaires sont honorés, toutes les commandes intégrées à l'intérieur des accolades seront
ignoré. La valeur par défaut est d'honorer les commentaires.

-F, --infile=FICHIER
Spécifie un fichier texte qui cw peut lire pour configurer son texte de pratique.

-h, --Aidez-moi
Imprime un court message d'aide.

-V, --version
Imprime des informations sur la version du programme, les auteurs et la licence.

SONDAGE PERSONNAGES
cw lit les caractères, un par un, à partir de son entrée standard ou de son fichier d'entrée.
Les lettres minuscules sont converties en interne en majuscules. La liste suivante montre les
caractères IS0 8859-1 (Latin-1) valides pouvant être prononcés par cw:

ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789"$()+-./:;=?_@ et espace

De plus, le programme comprend également les normes ISO 8859-1 et ISO 8859-2 accentuées
personnages:

ÜÄÇÖÉÈÀÑŞ (S avec cédille), Ž (Z avec caron/hacek),

et accepte ce qui suit en tant que formes à caractère unique des signaux procéduraux courants :

<>!&^~

See cw(7,LOCAL) pour plus d'informations sur les caractères ci-dessus et le code Morse.

If cw reçoit un caractère qui n'est pas dans cet ensemble, il imprime un message d'erreur '?c', où c is
le caractère d'erreur. Les seules exceptions à cela peuvent être le cw caractère d'échappement de commande
'%', la combinaison des caractères de début et de fin '[' et ']', et le commentaire de début et de fin
les caractères '{' et '}'. Voir EMBEDDED COMMANDES et Mousser CODE COMBINAISONS ci-dessous.

EMBEDDED COMMANDES
cw reconnaît les séquences spéciales dans le flux d'entrée en tant que commandes intégrées. Ces commandes
modifier les paramètres de la cw pendant son exécution, ou interroger les valeurs actuelles. Toutes les commandes
sont préfixés par le caractère d'échappement de la commande '%', et ceux qui définissent une valeur se terminent par un
point-virgule.

Le format d'une commande intégrée pour modifier une valeur de paramètre est

%Valeur C;

où C est une lettre de commande indiquant quelle action cw est de prendre, et Plus-value est le
argument ou valeur de la commande.

Les lettres de commande valides sont

T Définit la hauteur de ton utilisée pour émettre un caractère.

W Définit la vitesse d'envoi.

G Définit l'écart « Farnsworth » entre les caractères.

K Définit la pondération.

E Désactive ou réactive l'écho des caractères envoyés sur la sortie standard.

M Désactive ou réactive les messages d'erreur en cas d'erreur standard.

S Désactive ou réactive la génération de tonalité du haut-parleur.

C Désactive le traitement des commandes intégrées. Notez qu'une fois désactivée, cette commande
ne peut pas les réactiver.

O Désactive ou réactive la reconnaissance des [...] combinaisons de caractères.

P Désactive ou réactive la reconnaissance de {...} commentaires. Lorsque les commentaires sont
reconnu, tout caractère après une ouverture '{' et avant toute fermeture '}' sera
fait écho à la sortie standard, mais ne retentira pas ou n'aura aucun autre effet.

Par exemple, la séquence de commandes intégrée

%W25;%T1200;

va définir cw à une vitesse de 25 WPM et une tonalité de 1200 Hz.

Les commandes 'T', 'W', 'G' et 'A' prennent des valeurs avec la commande. Les limites de
les valeurs données pour les commandes intégrées sont les mêmes que les limites disponibles pour la ligne de commande
options, détaillées ci-dessus.

Les commandes 'E', 'M', 'S', 'C' et 'O' sont des indicateurs, et traitent une valeur de zéro comme claire, et
toute autre valeur définie. Ainsi, par exemple, la séquence

%M0;%C0;

désactivera les messages d'erreur, puis désactivera le traitement des commandes intégrées.

Si un paramètre est défini avec succès, cw signale le nouveau paramètre sur l'erreur standard (sauf
si aucun message d'erreur n'est défini). Si une erreur est détectée dans une commande intégrée, cw (lire ici)
une erreur. Pour les formats des messages d'erreur, voir le MESSAGE FORMATS section ci-dessous.

Les valeurs actuelles des paramètres dans cw peut être interrogé, ainsi que défini. La commande
le format

%?C

interroge la valeur du paramètre normalement défini avec la commande C. cw rapporte le courant
valeur sur erreur standard, en utilisant le même format que lorsque de nouvelles valeurs sont définies.

Les valeurs actuelles des paramètres dans cw peut également être demandé comme sortie en code Morse.
Le format de commande

%>C

générera une sortie Morse rapportant la valeur du paramètre normalement défini avec la commande
C.

Si les commandes intégrées sont désactivées, les caractères '%' sont traités comme n'importe quel autre (dans ce cas,
invalide) caractère d'entrée.

Une fois le traitement des commandes embarquées désactivé, toute commande pour
la fonction réactivée ne sera pas reconnue. C'est-à-dire, après '%C0;', un '%C1;' ne sera pas
reconnu.

Il y a une commande supplémentaire, et c'est '%Q'. Cette commande ferme tous les fichiers ouverts et
se termine cw. Tous les caractères après cette commande dans le flux d'entrée seront perdus.

Le fichier cw.h fournit un ensemble complet de définitions pour les commandes, les caractères spéciaux et
codes d'état de cw.

MESSAGE FORMATS
Lorsqu'une valeur de paramètre est définie correctement avec une commande intégrée, le format du message

=Valeur C

Est retourné. C est la commande utilisée, et Plus-value est la nouvelle valeur.

Si une valeur non valide est fournie pour un paramètre dans une commande intégrée, un message

?Valeur C

Est retourné.

Lorsqu'une commande non valide est rencontrée, le format du message

?%C

est utilisé. Pour une requête invalide, le message est

??C

et pour une requête invalide pour un paramètre en code Morse le message est

?>C

Un caractère dans le flux d'entrée qui ne peut pas être émis produit un message

?C

Ces messages ne sont pas destinés à être conviviaux, mais sont conçus pour être facilement et
rapidement interprété par un autre programme. De même, le format des commandes intégrées est
plus informatique que convivial.

Si les messages d'erreur sont désactivés, aucun message de quelque type que ce soit n'est imprimé sur l'erreur standard.

Mousser CODE COMBINAISONS
Le jeu de caractères standard proposé par cw peut ne pas être suffisant à certaines fins. Pour
exemple, certains caractères internationaux n'ont pas d'équivalent ISO 8859-1 et ISO 8859-2
qui cw peut sonner directement.

Pour aider à sonner de tels caractères, cw offre la possibilité de former des caractères combinés
en plaçant des éléments de caractère individuels entre parenthèses. Cw sons personnages
à l'intérieur d'une combinaison sans l'écart habituel entre eux. De cette façon, tout manque
caractère dans l'ensemble peut être construit.

Par exemple

[VIRGINIE]

est une façon de former le signal procédural VA, bien que

[SK]

fonctionne tout aussi bien. Le signal d'erreur à huit points peut être émis avec

[HSE]

ou le C-cédille en code Morse international avec

[CE]

Il peut y avoir autant de lettres, chiffres ou chiffres valides entre parenthèses que
obligatoire. Par exemple, une autre façon d'envoyer le signal d'erreur pourrait être

[EEEEEEEEE]

Enfin, trois modes alternatifs d'envoi 73 pourraient être

[TTEEE][EEETT]
[TDE][UET]
[GEE] [VT]

Les commandes intégrées peuvent être placées dans des [...] combinaisons si nécessaire. Les combinaisons font
pas de nid.

Cette fonction peut être désactivée en utilisant le -O or --nocombinaisons indicateurs de ligne de commande, ou
avec la commande intégrée 'O'. Si les combinaisons sont désactivées, les caractères '[' et ']' sont
traité comme tout autre caractère d'entrée (invalide).

NOTES ON EN UTILISANT A SOUND CARTE
Par défaut, cw essaie d'ouvrir PulseAudio par défaut. Si le serveur PulseAudio n'est pas accessible,
cw essaie d'ouvrir le périphérique OSS "/dev/audio" pour accéder à la carte son du système. C'est
généralement le bon appareil à utiliser, mais pour les systèmes avec des exigences particulières, ou ceux
avec plusieurs cartes son, l'option -d or --dispositif, combiné avec -s or --système peuvent être
utilisé pour spécifier le périphérique et le système audio pour l'accès à la carte son. Si la carte son
l'appareil ne peut pas être configuré, cw imprime le message d'erreur

impossible de configurer le son de la carte son

et sort.

Les périphériques de carte son, lorsqu'ils sont ouverts via le système audio OSS, sont généralement à accès unique
périphériques, de sorte que lorsqu'un processus a ouvert le périphérique, d'autres processus sont empêchés
de l'utiliser. Dans ces cas cw sera bien sûr en conflit avec tout autre programme qui
attendez-vous à l'utilisation exclusive de la carte son du système (par exemple, les lecteurs MP3). Si cw trouve
que la carte son est déjà occupée, il imprime le message d'erreur

open /dev/audio : périphérique ou ressource occupé

et sort.

La carte son n'est pas utilisée si cw envoie uniquement des tonalités sur le haut-parleur de la console.

AUDIO SORTIE - DEFAUTS ET SÉLECTION
cw essaie d'abord d'accéder à la carte son à l'aide du système audio PulseAudio, en utilisant le périphérique par défaut
nom, à moins que l'utilisateur ne spécifie un autre périphérique audio avec l'option -d or --dispositif.

cw essaie ensuite d'accéder à la carte son à l'aide du système audio OSS et du périphérique audio OSS par défaut
name ('/dev/audio'), à moins que l'utilisateur ne spécifie un autre périphérique audio avec l'option -d or --dispositif.

Si l'ouverture de la carte son via OSS échoue, cw essaie d'accéder à la carte son en utilisant ALSA audio
système et le nom du périphérique audio ALSA par défaut (« par défaut »), à moins que l'utilisateur ne spécifie d'autres
appareil avec option -d or --dispositif.

Si l'ouverture de la carte son via ALSA échoue également, cw essaie d'accéder au buzzer de la console système
en utilisant le périphérique buzzer par défaut '/dev/console', à moins que l'utilisateur ne spécifie un autre périphérique audio avec
option -d or --dispositif.

Il est très courant que pour accéder à la console, l'utilisateur de l'appareil doit avoir la racine
privilèges. Pour cette raison, essayer d'ouvrir le buzzer de la console échoue presque toujours. C'est
pas un bogue de programme, c'est le résultat des restrictions du système d'exploitation. Fabrication cw an
suid binaire contourne cette restriction. Le programme ne fork () ou exec (), donc faire
il devrait être relativement sûr. Notez cependant que cette pratique est déconseillée pour les
raisons de sécurité.

Comme indiqué, l'utilisateur peut dire cw quel appareil utiliser, en utilisant -d or --dispositif option. Lequel
les fichiers de l'appareil conviennent dépendra du système d'exploitation en cours d'exécution, du système
l'ID utilisateur s'exécute cw, et à quels groupes d'utilisateurs l'utilisateur appartient.

NOTES

Malgré le fait que cette page de manuel fait constamment et systématiquement référence au code Morse
éléments comme des points et des tirets, NE pensez PAS en ces termes lorsque vous essayez d'apprendre le code Morse.
Considérez-les toujours comme des « dits » et des « dahs ».

La table du code Morse dans le cw(7,LOCAL) la page de manuel est fournie à titre de référence uniquement. Si
apprendre pour la première fois, vous apprendrez beaucoup mieux en écoutant le
caractères envoyés, plutôt qu'en regardant le tableau.

D'autres programmes exécutés dans le système peuvent interférer avec la synchronisation du code Morse qui
cw Envoie. S'il s'agit d'un problème, essayez de l'exécuter sur un système inactif ou essayez
Running cw avec nice(1L,C,1). UNIX n'est pas vraiment conçu pour les programmes de niveau utilisateur à faire
le genre de minutage nécessaire pour envoyer le code Morse. cw est donc plus sensible que
la plupart des programmes à d'autres activités du système.

cw utilise des temporisateurs système pour sa synchronisation interne. Sur la plupart des versions UNIX, les temporisateurs ne sont pas
garantis de signaler un programme exactement à l'heure spécifiée, et ils offrent généralement un
résolution qu'aussi bonne que la résolution normale du système de « tick d'horloge ». Un temporisateur SIGALRM
tombe généralement sur un tick d'horloge système, ce qui la rend précise à pas mieux que 10 mS sur un
noyau 100 Hz typique.

L'effet de ceci est qu'une période de temporisateur est généralement soit exactement comme spécifié, soit,
plus probablement, un peu plus longtemps. Avec des paramètres WPM plus élevés, l'effet cumulatif de ce
affecte la précision de la synchronisation, car à des vitesses plus élevées, il y a moins de tops d'horloge de 10 mS dans un
point point. Par exemple, à 12 WPM, la longueur de point est de 100 mS, assez pour contenir cinq
ticks d'horloge du noyau. Mais à 60 WPM, la longueur de point est de 20 mS, ou juste deux horloges de noyau
tiques. Ainsi, à des vitesses plus élevées, l'effet des résolutions de minuterie devient plus prononcé.

Pour tester le chronométrage, essayez d'abord

X="PARIS PARIS PARIS PARIS "

echo "$X" | temps cw -w 4

et notez le temps écoulé, qui devrait être très proche d'une minute. Ensuite, essayez

echo "$X$X$X$X$X$X$X$X$X$X$X$X" | heure cw -w 48

Le temps écoulé doit être le même. S'il a augmenté, c'est l'effet du système
temporisateurs retardant légèrement plus longtemps que la période spécifiée (des taux de WPM plus élevés rendent plus
appels de minuterie). Ce sont des minuteurs pour vous, pas parfaits pour ce travail, mais le meilleur qui soit
sans écrire une partie, et peut-être beaucoup de code du noyau.

À l'exception de zéro, qui est silencieux, les valeurs de tonalité inférieures à 10 Hz peuvent ne pas sonner au
hauteur attendue.

EXEMPLES

Envoyez une chaîne de caractères à 25 WPM, 700 Hz, sans espace supplémentaire :

echo "UNIX CW SOUNDER" | cw -w 25 -t 700

Envoyer une chaîne à différentes vitesses et tonalités sur le haut-parleur de la console, en spécifiant un système
appareil console :

echo "%W12;%T400;400HZ 12WPM %W25;%T1500;1500HZ 25WPM" | cw -m -sc -d /dev/tty2

Envoyez C-cedilla, VA et un rapport du réglage WPM, avec un espacement supplémentaire à la moitié du volume :

echo "[CE] [VA] %>W" | cw -g 10 -v 50

LES ERREURS ET OMISSIONS

Les numéros de coupe ne sont pas fournis, bien qu'ils puissent être émulés, jusqu'à un certain point, par pré-
filtration.

Une sortie vers un périphérique externe en option, par exemple, la saisie d'une ligne sur le port parallèle,
ou une ligne série, peut également être utile.

Utilisez cw en ligne en utilisant les services onworks.net