Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
cwstudio(1)							     cwstudio(1)

NAME
     cwstudio - lightweight and portable CW signals generator with Curses UI

SYNOPSIS
     cwstudio  [--play]  [--noplay]  [--silent] [--verbose] [--groups] [--words]
     [--calls] [--agc 0-100] [--bits  bits]  [--click  0-100]  [--chars  nchars]
     [--charset  charset]  [--cspaces  0-100]  [--dashlen  100-10000]  [--detune
     0-100] [--even 0-100] [--freq  50-4000]  [--number  1-100]  [--hand  0-100]
     [--highcut  300-10000]  [--hum  0-100]  [--lowcut	50-1000] [--noise 0-100]
     [--odd 0-100] [--output outfile] [--qsb  0-100]  [--samplerate  samplerate]
     [--seed  1-32767]	[--shape  -10  - 10] [--signals 1-5] [--spacelen 20-300]
     [--sweep -4000 - 4000] [--sweepness 0 - 10000]  [--tempo  5-500]  [--window
     0-1000] [--wordset 0-1000] [--wspaces 0-100]

DESCRIPTION
     Curses-based  CW  signal  generator.  F1 shows help in interactive mode. In
     batch mode (--noplay), senerates 1-5 mixed CW signals  of	various  proper-
     ties, adds optional noise and saves it to a WAV file. If compiled on proper
     environment,  it  can play the result. Command line parameters are also in-
     terpreted in interactive mode!

     In batch mode all text output is written to  stderr;  if  stdout  is  redi-
     rected,  the created file is written here. If stdin is redirected, the gen-
     erated text is taken from it.

     Optional CWPARAM environment variable can be set to hold  some  parameters,
     for example CWPARAM="--even 10 --odd 10".

OPTIONS
     --play --noplay
	    Play the result (default), otherwise only save the WAV file.

     --silent --verbose
	    Verbose  mode gives full output (default), silent mode presents only
	    generated text.

     --groups --words --calls
	    The "groups" mode generates random five-letter groups.  The  "words"
	    mode generates most common English words. The "calls" mode generates
	    real amateur callsigns.

     --agc 0-100
	    Simulate  AGC response of receiver by varying noise volume along RMS
	    of the signal. Default is 100.

     --bits bits
	    Set bitrate. Default is 16.

     --click 0-100
	    Simulate click by lowering sustain part of tone at given  level  (in
	    dB) below attack phase. Default is 1 dB.

     --chars nchars
	    Take first "nchars" from default charset in "groups" mode.

     --charset charset
	    Set customized charset for random group generation in "groups" mode.

     --cspaces 0-100
	    Set  additional  spaces  (one  space  has a length of a dot) between
	    chars. Default is 0.

     --dashlen 100-1000
	    Length of dash, in percentage of dot. Default is 300% (3:1).

     --detune 0-100
	    Simulate frequency drift of the signal. Default is 0.

     --even 0-100
	    Enhance the signal by given percent of even harmonics. Default is 0.
	    Values 0-5 are most valuable in practice.

     --freq 50-4000
	    Use given frequency in Hz..

     --number 1-100
	    Generate given number of groups/words/calls. Default is 20.

     --hand 0-100
	    Simulate hand transmitting by introduce random  errors  in	dash/dot
	    lengths.

     --highcut 300-10000
	    Set high cutoff frequency (Hz) of generated noise. Default is 2400.

     --hum 0-100
	    Add given percentage of 50 Hz mains hum. Default is 0.

     --lowcut 50-1000
	    Set low cutoff frequency (Hz) of generated noise. Default is 300.

     --noise 0-100
	    Add given percentage of noise. Default is 100.

     --odd odd
	    Enhance  the signal by given percent of odd harmonics. Default is 0.
	    Values 0-5 are most valuable in practice.

     --output outfile
	    Store the result in a WAV file of given name. Default is output.wav.

     --qsb 0-100
	    Add given amount of signal QSB. Default is 0.

     --samplerate samplerate
	    Set given samplerate. Default is 44100.

     --seed 0-32767
	    Set explicitly the seed of random generator. If not set or set to 0,
	    seed is also random generated. Otherwise it is set to  given  value,
	    resulting in a possibility of repetitive random content generation.

     --shape -50 - +50
	    Set  the shape of random generated numbers. Positive value increases
	    the fraction of higher numbers (last letters, words,  calls).  Nega-
	    tive values prefer first ones. Zero means flat uniform distribution.
	    Can  be  used to increase the number of newly learned letters/words.
	    In practice, values -10 to 10 are well working.

     --signals 1-5
	    Generate given number of mixed signals, each of hardcoded  frequency
	    ratio,  tempo ratio and amplitude ratio. Every signal plays the same
	    text in a loop. Default is 3.

     --spacelen 20-300
	    Space length (between dots and dashes) in percentage of dot. Default
	    is 100% (1:1).

     --sweep -4000 - 4000
	    Simulate sweep (chirp or filter ringing according to parameters)  by
	    starting  each tone from given frequency (can be negative, which re-
	    sults in zero crossing). Frequency is then changed exponentially  to
	    this given in --freq with a rate given by --sweepness. Default is 0.

     --sweepness 0-10000
	    The rate of exponential frequency change from --sweep to --freq. De-
	    fault is 0 (no sweep).

     --tempo 5-500
	    Tempo  of  generated main signal in cpm (chars per minute) according
	    to PARIS group.

     --window 0-1000
	    Raised cosine window width (used to avoid clicks in each tone).  De-
	    fault is 100 samples.

     --wordset 0-1000
	    Take only first given number of most common English words in "words"
	    mode.

     --wspaces 0-100
	    Set additional spaces between words/groups/calls. Default is zero.

EXIT STATUS
     CWStudio  returns 0 if everything is OK. In the case of error, return value
     is different.

AUTHOR
     Lukasz Komsta, SP8QED, 2008-2013

				 April 24, 2013 		     cwstudio(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=cwstudio&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help