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]  [--sig-
       nals  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 prop-
       erties, 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 interpreted	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
       generated text is taken from it.

       Optional	 CWPARAM  environment variable can be set to hold some parame-
       ters, 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 out-
	      put.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 in-
	      creases the fraction of higher  numbers  (last  letters,	words,
	      calls).  Negative	values prefer first ones. Zero means flat uni-
	      form 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  fre-
	      quency  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. De-
	      fault 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 results in zero crossing). Frequency is then changed expo-
	      nentially	 to this given in --freq with a	rate given by --sweep-
	      ness. Default is 0.

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

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

       --window	0-1000
	      Raised cosine window width (used to avoid	clicks in each	tone).
	      Default 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.0.quarterly>

home | help