
>>>>>>>> CW Pileup trainer Ped.exe Ver 5.13 by JE3MAS <<<<<<<<
           Copyright(C) 1993-1998 by MasIII H.Kozu

   /* This is a free software.   It should be freely distributed. */

  *---------------------------------------------------------------*
  | This is a pileup trainer for IBM PC and Sound Blaster users.  |
  | You can run a 7 station pileup when using monoral sound card. |
  | 16 stations when using stereo sound card.                     |
  | 1 station with beep sound for users without a sound card.     |
  | Enjoy pileups with QSB and Noise.                             |
  | DOS and a SoundBlaser compatible card is required for this    |
  | software.                                                     |
  *---------------------------------------------------------------*

  * Ped is written for DOS and is not written for any version of
    Windows.
    Ped may work accidentally with Windows but that is because of
    just a good luck.
  * More than 240Kbyte free conventional memories are required.

*****  Menu      *****
1) Pileup Trainer    : You can experimentally try a pileup with
                      various setting.
                      You can change Noise, QSB, Broken CW, and Transparent
                      mode setting while running a pileup.
                      Ped will keep Hi-scores of this mode but these HI-
                      scores are not suitable to be compared to others.
                      The figure in the right end of the menu is a number
                      of stations calling.
                      You can select this number with right or left arrow.
                      When you select 'AUTO', the number of calling stations
                      varies according how well you run the pileup.
2) Competition       : This is a mode whose Hi-score has enough sense to
                      be compared to others.
                      Score-sensitive parameters (like noise) are prevented
                      from changing during a trial.
                      You can select competition level from LEVEL0 to LEVEL9
                      by left or right arrow.
                      CUSOM is a competition defined PED.CFG file.
3) Japanese Split    : Enjoy two near frequency, near strength stations
                      pileup. It's hard!
4) Pileup generator  : It generates pileup. You can add QSB, Noise...
5) Demonstration     : Just a demonstration.
                       When you set TRANS=ON, you can call the computer
                       operator running pileup.
                       Use F4 for a call, F2 for transmitting exchange.
                       The callsign in the F4 key changes every time you make
                       a good contact for your convenience to make another call.
6) Change data       : changes data.
7) Append data       : appends data.
8) Text out          : reads text files and generates CW.
                      You can add QSB, Noise and even broken CW.
                      Text file must have extension 'txt'.
9) End               : Back to OS
0) RTTY Pileup Generator: It's just a joke. I don't know how to utilize it.
A) Mode              : Select Normal QSO or Contest QSO.
B) Time limit        : You can select time limit using right or left arrow keys.
C) Callsign          : Please type your callsign.
                      This callsign will be a target of FIX_MINE when log
                      examination.
D) Number            : Please type your contest number.
E) Randomize         : If you want to have the same series of callsigns calling
                      select 'NO'.
                      'START REC' randomize only the start record for reading out
                       pileup stations data.
                      'SHUFFLE' randomize position of every data in the database.
F) Auto Log          : This function is for HST use.
                       (HST: World Championship in High Speed Telegraphy)
                       If this option is ON, QSO is logged automatically only
                       when you make a good contact.
                       This is not good for normal training.
                       Please set this option OFF normally.

*****  Log examination *********
Points: total number of impulses in a callsign you worked.
        Example: letter 'A' has 5 impulses (1 for a dot, 3 for a dash
                 and 1 for a space between dot and dash).
                 So one normal letter 'A' has 5 points.

                *Ped will generate abnormal dot-dash ratio CW.
                 In such a case total number of impulses is different
                 from that of normal CW.

Multi:  No multipliers.

After a trial of Pileup trainer or Competition, your log will be cross
checked and examined.
Similar notations as the UBN-report in the CQ-World Wide Contest will be
attached to the log.

The meaning of these notations is as follows.

U+1:Broken call with only one letter miscopied. Zero point.
B  :Broken call. Zero point.
N  :Not in the log. Zero point.

For these three above, following 3 contacts are removed as a penalty.

P  :Callsign is ok but this contact is removed as a penalty.
    Zero point.
M  :Broken number (only in the contest mode).
    Zero point. No penalty.
R  :contact with no number in the Contest mode.
    Your own callsign appeared. (Fix_mine) Point zero. No penalty.
OK :Good contact.

*****  Saving a log *****
You can save your log and summery if you like.
All logs are appended into the file 'PED.LOG'.
All summaries are appended into the file 'PED.SUM'.

*****  Reference *****

<< running ped >>
     1)Booting as a Pileup Trainer
            Ped [-H|-?][-Axxx][-B][-C][-NM][-EMS]
                      ;-H,-?   This option showes a simple help message.
                      ;-Axxx   You can specify the I/O address of
                               your sound card in case ped fails to detect
                               it.
                               xxx should be one the followings.

                               210,220,230,240,250,260,280,388,389

                               If you don't know the address try
                               -A388(monoral) or -A389(stereo) first.

                      ;-B      stars ped with BEEP-TONE mode.
                      ;-C      convers ped ver4 data into ped ver5 data.
                               Ped ver5 can read both ver4 and ver5 files
                               but Ped ver4 can't read ver5 files, so you
                               have to keep ver4 data files if you want to
                               keep ped ver4 using.
                               Ver5 data format is simpler than that of ver4.
                      ;-NM     Ped starts without resetting mixer.

                      ;-EMS    stores MASTER.DTA in EMS memory if it is
                               available and has enough capacity.

     2)Booting as a FileConverter 1
            Ped < CT Bin filename(xxx.bin) > < Ped data file name (yyy.dat) >

            example: Ped WWCW98.BIN WWCW98.PED

            When you start Ped with two filespec, ped will be booted as a
            file converter which converts CT Ver9 ,Ver8
            and maybe Ver7 Bin file into Ped data file.

     3)Booting as a FileConverter 2
            Ped < CT Bin filename(xxx.bin) > < ASCII file name (yyy.asc) >

            example: Ped WWCW98.BIN WWCW98.ASC
            This converter generates an ASCII callsign file
            from a CT Bin file.


     4)Booting as a FileConverter 3
            Ped < Ped data filename(xxx.ped) > < ASCII file name (yyy.asc) >

            example: Ped WWCW98.PED WWCW98.ASC
            This converter generates an ASCII callsign file
            from a PED data file.

     5)Booting as a FileConverter 4
            Ped < ASCII filename(xxx.asc) > < SCP Database (yyy.dta) >

            example: Ped WWCW98.ASC WWCW98.DTA

            This converter generates a database for Super Check Partial
            function which has the same format as MASTER.DTA distributed
            with CT.


     6)Booting as a FileConverter 5
            Ped < SCP Database (xxx.dta) > < ASCII file name (yyy.asc) >

            example: Ped MASTER.DTA WWCW98.ASC

            This converter generates an ASCII callsign file from
            a Super Check Partial Database.

     7)Booting as an ID translator
            Ped <ID>
            example: Ped  0C031200
            
            Ped tralates ID and output every parameters.

     8)Booting as a data validity checker
            Ped <Callsign> <Score> <ID> <Password>
            example: Ped je3mas 1234 0c031200 abcde

            Ped checks validity of data given.


<< Keys equivalent to CT >>

      HOME,CTRL-A        :Start of field
      END,CTRL-E         :End of field
      BS, CTRL-H         :Backspace
      DEL,CTRL-D         :Delete character
      CTRL-K             :Delete to end of field
      CTRL-W             :Delete field
      Right Arrow,CTRL-F :Forward character
      Left Arrow,CTRL-B  :Backward character
      Upper Arrow        :move cursor back one log line
      Lower Arrow        :move cursor forward one log line
      Alt-F8,Alt-W,F11   :Wipe QSO
      Alt-F9             :QRS
      Alt-F10            :QRQ
      Alt-Q              :Quit
      Alt-H              :Display control key assignment
      Alt-U,F8           :Super Check Partial

      F1                 :Send CQ message
      F2                 :Send exchange message
      F3                 :Send confirm message
      F4                 :Send my call
      F5                 :Send his call
      F6                 :Send cl?
      F7                 :Send ?

      return,CTRL-M      :Log QSO
      Ins                :F5 and F2
      ESC                :Panic stop
      +                  :F3 and Return
      Spacebar           :Toggle call and No.(Only for CT trainer)

      shift+F1           :Set F1 message
      shift+F2           :Set F2 message
      shift+F3           :Set F3 message
      shift+F4           :Set F4 message
      shift+F6           :Set F6 message
      shift+F7           :Set F7 message


<< Keys not equivalent to CT >>
[PCDGTB] represent key which can be used in the following mode
respectively.

P:Pileup Trainer C:Competition G:Pileup Generator D:Demonstration
B:Beepmode

[PCDGTB]
      alt+Upward Arrow,
      shift+f9             :Tone pitch adjust
      
      alt+Downward Arrow,
      shift+f10            :Tone pitch adjust
      Pg Up                :Tuning dial (up)
      Pg Dn                :Tuning dial (down)
      Ctrl-p               :toggle enable/disable keyer
      Alt-F7               :adjust semi-break-in time delay 
      Alt-F8               :adjust semi-break-in time delay

[PCGTD]
      F9                   :Loudness down
      F10                  :Loudness Up

[PGTD]
      F12                  :change band width
      Ctrl-N               :toggle noise enable/disable
      Ctrl-F11             :toggle light static noise enable/disable
      Ctrl-F12             :toggle heavy static noise enable/disable
      Alt-F11              :adjust average S/N ratio
      Alt-F12              :adjust average S/N ratio
      Ctrl-O               :toggle QSB enable/disable
      Ctrl-U               :toggle Broken CW enable/disable
      Ctrl-T               :toggle Transparent mode enable/disable
                            What is a transparent mode? Try it!
      Ctrl-R               :Toggle FSK (RTTY or Packet) QRM
[B]
      Ctrl-U               :toggle Broken CW enable/disable
[TCD]
      Ctrl-<CR>,Ctrl-J     :restart

<< Text commands you can use >>

      QUIT           Quit and return to menu
      CORRECT        Adds hiscall to confirming message when you make
                      any correction.
      NOCORRECT      Disables CORRECT
      DEFINEKEY      Key re-definition
                     (Max. 50 keys can be redifined)

<< How to connect  Keyer >>
  You can use your keyer (electronic keyer or straight keyer)
  parallel to the keyboard in order to cook a pileup effectively.

  Just key between Pin 13 and Pin 18 in the printer port with your
  favorite keyer.
  (Please connect the keyer on your own risk.)

  *Printer port                        
      Pin 13(Select)    -----  Keyer
      Pin 18(Gnd)       -----  GND

<< Data file >>
 Ped has so simple data structure that you can make your own data with
 a text editor.

 format: <CALLSIGN>,<NR><CR>
 example:
         JE3MAS,25
         JA3ZOH,25
         6Y6A,08
         5H1HK,37
         

Extension must be '.PED'.(ex. ARRL.PED)

<< Ped files >>
ped.exe      : ped execution file 
*.ped        : ped data file
ped.ini      : ped initialization file.
               Please don't modify this file.
ped.log      : This file contains all logs.
ped.sum      : This file contains all summaries.
               These two files above are getting fat as you save
               your logs.
               Please delete them in appropriate periods for saving
               your HDD space.

ped.cfg      : This is a definition file for a custom competition.
ped.hsc      : This file contains HI-SCORE information.
               You will lose all HI-SCORE data if you delete this
               file.

_JA_US.PED   : If there is no callsign data file, Ped generates
               this file automatically.
               This file contains Japanese and US callsigns generated
               at random.

master.dta   : This is the well-known database file used for Super Check
               Partial which is distributed with CT.
               You can generate this file using PED file conversion
               functions. 


<< Super Check Partial >>
Super Check Partial is heavy duty process for PED.
You may be required a rather High Speed Machine.
I write PED with a Pentium 133MHz notebook. 
Super Check Partial is working all right on my notebook.
If you feel CW sounds are interfared by Super Check Partial,
please try '-EMS' option.
The only file name which Ped recognizes as Super Check Partial
database is 'MASTER.DTA'.
MASTER.DTA should be in the same directory where ped is or
should be in the directory specified by a CTPATH environment variable.

*You cannot enable Super Check Partial in the Competition mode.


<< Customizing a competition >>

You can define your own competition by adding some modifications to
the "PED.CFG" file.
You can play your custom competition by selecting 'CUSTOM' in the
COMPETITION sub menu.

Following is a sample PED.CFG file.
Lines starting ';' are comments.
You cannot change keywords like 'Noise:' its self.
You can only change numbers following keywords.

PED.CFG stars here=============================
;******************************
;* Sample configuration       *
;*     by MasIII H.Kozu       *
;******************************

;----Start Configuration------------------

:[Noise]----------------------------------
;Noise setting   0:off   1:on
Noise: 1

;[SN]-------------------------------------
;Noise S/N setting  -7.5 to 30 dB 
;  example 6 for 6 dB
SN: 16.5

;[Static1]--------------------------------
:Light Static noise setting  0:off 1:on
Static1: 0

;[Static2]--------------------------------
;Heavy  Static noise setting   0:off 1:on
Static2: 1

;[Broken]--------------------------------
;Broken CW setting  0:off 1:on
Broken: 1

;[QSB]------------------------------------
;QSB setting  0:off 1:on
QSB: 1

;[FskQRM]--------------------------------
;Rtty and Packet QRM setting
;   0:OFF 1:RTTY 2:PACKET
;   3:Alternative(RTTY or PACKET)
FskQRM: 1

;[Pileups]--------------------------------
;Number of station setting 
; for stereo sound card:  1-16
; for monoral sound card: 1-7
; Automatic             : 0
Pileups: 0

;[Bandwidth]------------------------------
;Band width setting  0-5
;  125Hz:0   250 Hz:1  500Hz :2  1KHz:3
;  2KHz:4    4KHz  :5
;
Bandwidth: 3

;[Opmode]---------------------------------
;Operation mode setting (0-1)
;  DX'pedition: 0
;  Contest: 1
Opmode: 0

;[Timelimit]------------------------------
;Duration for competition 
;
;  5(mins):0 10(mins):1 20(mins):3
; 30(mins):4 40(mins):5 50(mins):6
; 60(mins):7
;  
Timelimit: 0

;[Scramble Data]--------------------------
; No scramble: 1
; Shuffle data: 0
; Randomize only read-out-starting record: 2
Scramble: 1

;[Auto Log]-------------------------------
; Disable Auto Log: 0
; Enable Auto Log: 1
AutoLog: 1

;[Super Check Partial]--------------------
; Disable Super Check Partial :0
; Enable Super Check Partial  :1
SuperCheckPartial: 0

;---- End of sample setting------------------
End of PED.CFG============================

(CT is  real time contest logging software written by Ken Wolff, K1EA)
(Sound Blaster/Sound Blaster Pro are trademarks of CREATIVE LABS,INC.)

If you find any bugs, please send me a report. Thank you!

JE3MAS
MasIII H.Kozu
10-20-906, Chuo-3, Joto-ku,
Osaka 536-0005,Japan
INTERNET:  masiii@aa.mbn.or.jp


Bug fix--------------
98.10. 9 V5.00 release 
98.10.11 V5.01 number of pileups were wrong when restart. fixed.
98.10.12 V5.02 Changed time constant of panic stop.
               Added a function to change WPM in the main memu.
               Use ALT-F9,F10.
98.10.12 V5.03 Set volume a little louder.
98.10.12 V5.04 Fixed mis-calculated S/N ratio.
98.10.13 V5.05 Fixed a bug in the read data routine.
98.10.14 V5.06 Fixed a few small bugs.
               Added FSK QRM.
98.10.18 V5.07 Fixed cursor position when FSK QRM
               Added a CT-bin file to Ped-data file converter.
               Added a function to call pileup in the demonstration mode.
98.10.19 V5.08 Fixed a small bug.
98.10.19 V5.09 Fixed a small bug in Japanese split mode.
               Sometimes Pileup generator couldn't be terminated. Fixed.
               Changed the specification of log browser.
               Changed the time constant of panic stop.
98.10.20 V5.10 Printer port check in start up failed. Fixed.
               File converter now can treat Bin files of CT Ver 7, 8 and 9. 
               Rescued not in the log for the last logged station.
               Changed the method of data scramble.
               Changed the procedure of getting new callsign from the
               callsign bank.
               Ped could not read the number in the first record of the
               new format data. Fixed.
               Added a Key-remapper.
98.11.5 V5.11  Added an Auto Log mode.
               A bug in reading PED.CGF fixed.
               Alt-H displays control key assignment.
               Added an ID translation function.
               Added a data validity check function.
               Ped can start up even without any callsign data, using
               random generated Japanese and US callsigns.
98.11.18 V5.12 Fixed Runtime error R6009.
               Now Ped saves function key settings for each contest 
               mode and Dxpedition mode.
               Added Super Check Partial.
               Enhanced file converter functions.
98.11.18 V5.13 Fixed conflict between Super Check Partial & Help windows
               No Time Limit for Demonstration, Pileup generators & Text
               Out by by hitting ctrl-return at the main manue.
               You can customize competition mode to make Super Check
               Partial enable.
               Now lower case characters are ok in converting *.asc to *.dta.
               Ped.ini got damaged when Function key strings contained spaces.
               Fixed.
               Changed SCP search method.
