File: README

package info (click to toggle)
pileup 1.1-4
  • links: PTS
  • area: main
  • in suites: slink
  • size: 268 kB
  • ctags: 113
  • sloc: ansic: 698; makefile: 47
file content (93 lines) | stat: -rwxr-xr-x 3,997 bytes parent folder | download | duplicates (3)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
pileup - CW pileup program for Linux
	
This program is based on sccw - Soundcard CW for Linux by Steven J. Merrifield  VK3ESM  
sjm@ee.latrobe.edu.au http://livewire.ee.latrobe.edu.au. I have modified its
use from a morse code tutor into a pileup program using multiple SoundBlaster
voices.

-----------------------------------------------------------------------------

"Pileup" is a morse code program which generates callsigns using
a specified number of the SoundBlaster's voices. This simulates the sound of
a CW pileup. The greater the number of voices the more difficult the program is.

The idea is based on the tapes used at Amateur Radio Conventions to test 
people's CW skills. However it is more random and can be made more difficult!

The callsigns sent are those worked by M6A in the 1996 CQ WW CW contest to
add some realism.

Build instructions:
1. Type "make"  to produce the executable "pileup"
2. As root type "make install". This makes "pileup" a setuid root program.
   This is required as low level code is used to address the SoundBlater 
   card requiring root privileges.

The program uses LinuxThreads by Xavier Leroy (Xavier.Leroy@inria.fr)
(a copy of which is provided with the pileup TAR file). The pileup program 
is by default statically linked with the libpthread.a library (a copy of 
which is provided with the pileup TAR file). The pileup program also requires 
pthread.h (also enclosed with the pileup TAR file).

As LinuxThreads uses the clone() system call a kernel 2.0+ is required.
Version 1.0 of the pileup program (which can be used with a 1.2.* kernel
is available from http://www.babbage.demon.co.uk/pileup.html).

-----------------------------------------------------------------------------

The program can be run in two modes - Competition or Practice. 

a. Competition mode sends 50 callsigns and you enter each callsign copied 
using the keyboard (pressing ENTER after each callsign). Partial callsigns 
are allowed. After the 50 callsigns are sent your score is determined and
the list of 50 sent callsigns displayed along with the received callsigns.
Please send your scores to richard@babbage.demon.co.uk to add to the
Pilup Score List!

b. Practice mode sends the whole contents of the calls.dat file displaying
each callsign as it is sent.

Use:
1. Type "pileup" to run the program
2. The program then prompts for the number of voices. Enter a number from
   1 to 9 inclusive. The higher the number of voices the greater the
   cacophony and the greater the difficulty. A value of 2 is a good starting
   point.
3. The program then prompts for the CW speed. Enter a value in words per
   minutes (e.g 25). Note that this will be the *slowest* speed used!
4. The program then prompts for Competition or Practice mode. Enter 'c'
   for competition mode, 'p' for practice mode.
5. Start copying those callsigns (and typing them into the keyboard if
   you are in competition mode)!

-----------------------------------------------------------------------------

Features v1.0:
1. Up to 9 voices can be sent (I find that 3 voices are enough!);
2. Each voice is faster in speed and lower in volume than the previous to 
   simulate the "layering" of stations found in pileups;
3. The tone of each call is different in the pileup to simulate the
   spread of stations in a pileup;

New Features v1.1:
1. Added a competition mode. 50 callsigns are sent and your copying
   ability is scored. The greater the accuracy the greater the score. A
   list of high scores can be found at 
   http://www.babbage.demon.co.uk/pileup.html
2. Multi-threaded using LinuxThreads.

-----------------------------------------------------------------------------

To do list:
1. Add QRM/QRN noises
2. Add a difficulty level
3. Add curses interface 

Any bugs, suggestions etc to richard@babbage.demon.co.uk

---------------------------------------------------------------------------

Richard Everitt G4ZFE
richard@babbage.demon.co.uk
http://www.babbage.demon.co.uk