File: README

package info (click to toggle)
phaseshift 0.40-13.1
  • links: PTS
  • area: main
  • in suites: lenny
  • size: 856 kB
  • ctags: 447
  • sloc: sh: 4,696; cpp: 3,542; makefile: 64; ansic: 13
file content (155 lines) | stat: -rw-r--r-- 4,272 bytes parent folder | download | duplicates (5)
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
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
                                 PhaseShift

PhaseShift is a program for operating PSK31 on Linux. It makes use of the Qt
library and is based on the PSK31 code writen by Hansi Reiser, dl9rdz and
Ted Williams, wa0eir.


Disclaimer

This project is a weekend toy.

That said, I will try to enhance it and fix bugs whenever time permits.

The program is licensed under GPL. Please read the COPYING file for more
information.


Requirements

   * Troll Tech Qt library version 1.44. The program is not yet compatible
     with Qt 2.0.
   * Linux with soundcard support

Features

   * BPSK and QPSK modes
   * Phase scope
   * Spectrum analyser
   * ADC level indicator
   * Beacon Mode
   * Tune mode
   * Macros
   * Simple sound card mixer
   * Confidence detector
   * Type-ahead buffer
   * Logging
   * ASCII file transmission

Screenshot

[Image]


Installation

./configure

make

and as root:

make install


Make install will install the phaseshift binary in /usr/local/bin and the
PSK31 alphabet in /usr/share/psk31. Once you have compiled and installed the
program, you need to create the configuration file in your home directory. A
template configuration file (phaseshift.conf) is supplied with the
distribution. You can copy the file to your home directory and rename it to
.phasehift.conf (notice the dot). Make sure to edit the file to fit your
needs.


Operation

The program was tested under the following environment:

   * Linux Mandrake 6.0, 6.1, and 7.0
   * Linux Kernels 2.2.13 and 2.2.14
   * Linux Kernel native sound support
   * Creative Labs SoundBlaster 16, 32 AWE, and Live

You should make sure that the record input (the input connected to the ADC)
of your sound card is set correctly. You can check this with most sound
mixers available for Linux. I use rexima, which is a simple text-based sound
mixer.

The squelch control is based on a rudimentary confidence detector which
keeps track of the last 300 phase symbols received. A confidence level of
100% means that the last 300 phase symbols received had less than 3% of
phase distortion. When receiving white noise, the confidence level stays
around 13%.

When the program starts, the default TX line is set to character mode. In
this mode each character typed is sent to the psk31 engine. If in TX, the
character is trnasmited immediately. If in RX, the character is queued for
TX and is transmitted only when the TX is enabled. When the TX line is set
to Line Mode, the text typed is only sent to the psk31 engine when return is
pressed (type-ahead).

Double clicking a macro entry in the macro list will add the macro text to
the transmit queue. The text will be transmited whenever TX is enabled.


Todo

   * Optimize the graphics
   * Implement a water fall display
   * Implement a multi-line receive text area
   * Write documentation

Bugs

   * The TX frequency slider is not yet enabled
   * The frequency sliders are not following AFC and NET frequency changes
   * Sometimes the main display is not refreshed
   * QPSK mode has not been tested
   * The confidence detector code does not work with QPSK yet

End Remarks

Please feel free to notify me about any bugs or anomalies you might notice.
I can be reachd at n1vtn@arrl.net


Download

phaseshift-0.3.tar.gz

Links

   *  The Official PSK31 WWW Page
   *  Troll Tech Qt Library

Changes

Version 0.1 - 20000318

   * Initial release

Version 0.21 - 20000319

   * Fixed few compile problems with Qt 2.0
   * Sound device is now configurable in .phaseshift.conf

Version 0.22 - 20000322

   * Performance enhancements
   * GUI enhancements
   * Serial port (PTT) is now configurable
   * Sound device is now configurable
   * Phase Scope now works during TX
   * PTT control via serial port (RTS) is now implemented

Version 0.3 - 20000429

   * Implemented keyboard hotkeys. CTRL-T switches TX on. CTRL-R immediately
     switches TX off (and flushes any characters in TX buffer). CTRL-E
     switches TX off after all characters in TX buffer were transmited.
   * Implemented emergency TX off icon (same functionality as CTRL-E.
   * Implemented point-and-click tuning for the spectrum scope.

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

Edson Pereira, pu1jte, n1vtn -- n1vtn@arrl.net