1
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
4
<META NAME="GENERATOR" CONTENT="SGML-Tools 1.0.9">
5
<TITLE>The LinPsk Handbook: Usage </TITLE>
6
<LINK HREF="index-4.html" REL=next>
7
<LINK HREF="index-2.html" REL=previous>
8
<LINK HREF="index.html#toc3" REL=contents>
11
<A HREF="index-4.html">Next</A>
12
<A HREF="index-2.html">Previous</A>
13
<A HREF="index.html#toc3">Contents</A>
15
<H2><A NAME="s3">3. Usage </A></H2>
17
<P>LinPsk supports two modes:
22
<P>On the first start Linpsk is in demomode.You can run the demomode even without a soundcard installed.
23
<P>Starting LinPsk you'll get the following window:
27
<IMG SRC="img/Start.png">
30
<H2><A NAME="ss3.1">3.1 The menu</A>
35
<H3><A NAME="FileMenu"></A> The File menu</H3>
37
<P>The File Menu consists of following items
41
<IMG SRC="img/File.png">
44
<H3>Open DemoFile</H3>
46
<P>You can select a file for running different demos. Depending on the type of file you choosed in your setup
47
the selection is restricted to the resulting file type.
51
<IMG SRC="img/DemoFile.png">
57
<P>Terminates the program
59
<H2><A NAME="ss3.2">3.2 Setup</A>
62
<P>The settings menu contains the following items
66
<IMG SRC="img/Settings.png">
71
<P>Selecting Settings results in the following window
74
<EPS FILE="SettingsSubmenu">
75
<IMG SRC="img/SettingsSubmenu.png">
80
<P>Here you decide whether to use LinPsk in Demomode or not.
81
<P>In Demomode you can choose an input file to play with in the
82
<A HREF="#FileMenu">File menu</A> Two different modes are supported
84
<LI> Textfile<P>The distribution contains two textfiles
90
<P>These files contain demosample computed with the software made by w5xd.
91
<P>Having clicked the RX - button you should read
94
<P>in the RX- window , if you selected the bpsk.out file and
96
<P><B>cq cq cq de DL1KSV</B>
97
<P>if you selected the qpsk.out file.
98
<P>At the same time the RX on the button changes to TX.
101
<LI> wav File <P>Because of the size of the files the distribution doesn't contain wav -files. But you can
102
download some samples from my homepage.
104
<A HREF="http://linpsk.sourceforge.net">http://linpsk.sourceforge.net</A><P>
105
<P>The files were sampled with the rec program and contain a short part of real qso's
109
<P>You can try the impacts of the different buttons in the demo mode.
114
<P>Enter your callsign. You can use it in different macros.Some
115
<A HREF="#Macros">macros</A>
116
won't work without a callsign set.
118
<H3><A NAME="UserDefinedButton"></A> Name of userdefined button</H3>
120
<P>You can name a button named
121
<A HREF="#Macros">' user defined button'</A> as
122
you like.If you are in TX- Mode pushing this button the content of the file you entered in
123
<A HREF="#CorrespondingFile">Corresponding file</A> will be sent..
124
Pushing this button in RX mode will have no effect.
126
<H3><A NAME="CorrespondingFile"></A> Corresponding file</H3>
128
<P>Here you define the name of the file that should be transmitted when you press the
129
<A HREF="#UserDefinedButton">user defined button.</A> If this file doesn't reside in your home directory
130
you have to enter the filename including the absolute path.
132
<H3>Input selection</H3>
134
<P>Select the input device (mic or line) depending on your installation.
138
<P>Select the input level. Don't overdrive the soundcard input!
139
<P>Have a close look to the spectrum display.
140
If the plot changes to red then the level is too
142
You can control the level using a common mixer program or the Input Level control.
145
<H3><A NAME="OutputControl"></A> Output level</H3>
147
<P>Sselect the outputlevel carefully !
148
<P>You should set the outputlevel as low as the ALC of your transmitter doesn't
150
<P>Setting output level too high will cause a broadband signal with much
151
splatter instead of narrow band signal!!!!!!!!!!!.
154
<H3>Display zero as slashed zero</H3>
156
<P>You can select whether a zero is be displayed with or without a slash.This option only influences
157
how a zero is displayed. A zero will be transmitted as character 0 in any case.
161
<P>LinPSk tries to detect the usable com ports for switch RX/TX mode of your transmitter.
162
Select the one you use to control your transmitter.Linpsk drives the RTS/DTR pins.
165
<H3>Time offset to UTC</H3>
167
<P>Insert the offset from UTC to the time you use for your computer clock.
169
<H3>Station File </H3>
171
<P>Insert the name of the file that contains your station description. If the file doesn't reside in your home
172
directory enter the name including the absolute path.
173
<P>Of course you can enter different contents in this file, too.
175
<H3><A NAME="RXChannels"></A> Number of RX Channels</H3>
177
<P>Here you select ( up to to 4) the number of channels you wish to receive simultaneuosly. How many channels work properly
178
depends on your processor power. Due to a bug changing the number of rx channels leads to a wrong display.
179
Don't be confused . Save the
180
<A HREF="#SaveSettings">settings</A> and restart LinPsk.
182
<H3>Font Settings</H3>
184
<P>Selecting fonts settings you reach the following menu
188
<IMG SRC="img/fonts.png">
191
<P>Independently you can choose the fonts for the different rx windows and the tx - window.
192
For both submenus you get the same looking window.
195
<EPS FILE="fontsselect">
196
<IMG SRC="img/fontsselect.png">
199
<P>Make the selection of your choise.
203
<H3>Colour Settings</H3>
205
<P>Selecting Colour settings you'll get a submenu where you can select a colour settings menu for
206
each rx- window depending on the
207
<A HREF="#RXChannels">numbers of rx channels</A>
209
<P>The colour you've choosen is used for the window heading , the display text and button text in the
210
<A HREF="#SelectWindow">select window menu</A>.
211
<P>The colour settings menu looks like the following
215
<IMG SRC="img/ColourSettings.png">
218
<P>Make the selection of your choise.
221
<H3><A NAME="EditMacros"></A> Edit Macros</H3>
223
<P>To simplify qso'ing you can define macros.
224
<P>Selecting Edit Macros you'll get the following window:
227
<EPS FILE="EditMacros">
228
<IMG SRC="img/EditMacros.png">
231
<P>Here you can define or change Macros.
232
<P>Beside plain text you can use variables in the text. Using these variables in a macro
233
causes in replacing the variables by their actual values.
234
<P>The variables are:
236
<LI>@CALLSIGN@<P>The callsign as defined in the setup.
239
<LI>@THEIRCALL@<P>The content of the Their Call box. You can change its content by edititing
240
the box by hand or by double clicking in front of a callsign in the receive window.
243
<LI>@NAME@<P>The name of the remote op as defined in the Name field
246
<LI>@CWID@<P>This variable will be replaced by "de @CALLSIGN@ kn" and be sent in cw.
250
<P>Here are some examples for macro definition:
252
<LI>@THEIRCALL@ @THEIRCALL@ de @CALLSIGN@ @CALLSIGN@ @CALLSIGN@ pse k
255
<LI>So btu @NAME@ @THEIRCALL@ de @CALLSIGN@ pse k
258
<LI>cq cq cq de @CALLSIGN@ @CALLSIGN@ @CALLSIGN@ \n cq cq cq de @CALLSIGN@ @CALLSIGN@ @CALLSIGN@ \n cq cq cq de @CALLSIGN@ @CALLSIGN@ @CALLSIGN@ @CALLSIGN@ pse kkk \n
265
<H3><A NAME="SaveSettings"></A> Save Settings</H3>
267
<P>This will save your actual configuration to a file named LinPsk.config, which will be loaded
268
every time you start LinPsk.
271
<H2><A NAME="ss3.3">3.3 Parameters to change in the LinPsk.config file</A>
274
<P>The Linpsk.config file is located in your home directory. There are a few paramters that can only
275
be modified by editing this config file. These paramters are:
277
<LI>MinimumWindowWidth=xxx<P>Defines the minimum width of the LinPsk main window, default width is 640.
280
<LI>MinimumWindowHeight=xxx<P>Defines the minimum height of the LinPsk main window, default height is 540.
283
<LI>StatusBarHeight=xx<P>Height of the statusbar. Default height is 20
288
<H2><A NAME="ss3.4">3.4 The control elements</A>
295
<P>For each RX window a trigger text may be defined independently. If the trigger is activated and
296
the defined text is detected in the text just received you'll get a beep and the window will be
297
the active RX window.The trigger itself will be deactivated by this action.
298
<P>This feature for instance gives the oportunity to read a running qso while waiting for
302
<H3><A NAME="RXFrequency"></A> RX Frequency</H3>
304
<P>You can select the RX - frequency by directly entering the frequecny in the frequency box by
305
clicking the up and down arrows of the frequency box or by directly clicking on the signal in the
306
<A HREF="#SpectrumDisplay">spectrum display</A>.
307
<P>If you activate AFC (Automatic Frequency Control), the frequency will be adjusted to the center of the PSK
308
signal. AFC works in a range of about 50Hz around the signal.
309
<P>At the moment AFC doesn't work for RTTY:
313
<P>Select the mode of operation you intend to work on. The mode is set independently for each RX window.
314
<P>In one window you can listen to an psk qso meanwhile in the other you're listening to RTTY.
315
<P>Receiving in RX mode you may see a <F> This means that the followings displayed character had
320
<P>Activating this feature, up from now the text, received in this window, will be written to a file named
321
Rx_Debug_x. x ranges form 0 to 3 and corresponds to windownumber -1 .
325
<P>The squelch control is used to set a threshold to inhibit signal reception beyond a specified level.
326
The colour of the squelch bar changes from blue to yellow if the squelch opens.
327
<P>To change the squelch level simply click into the control.
330
<H3>TX Frequency</H3>
332
<P>You can select the TX frequency in the same way you select the
333
<A HREF="#RXFrequency">RX frequency</A>.
334
If you've activated NET the TX frequency will be the same as the RX frequency. The X frequency will be adjusted,
335
when you change from RX to TX mode.
339
<P>The RX/TX button is a toggle button. It's label describes what happens if you press the button.
340
If LinPsk starts, the button is labeld with RX. This ensures that the first possible operation
341
is to listen on the band.
342
<P>Pressing the button the label changes to TX signaling the next
343
possible operation is to transmit.
345
<H3><A NAME="SelectWindow"></A> Selection of the active RX Window</H3>
347
<P>This control lets you select the active RX window. If you change from RX to TX, the TX operation always
348
uses the parameters (mode of operation, etc.) of the active RX- window.
351
<H3><A NAME="SpectrumDisplay"></A> Spectrum Display</H3>
353
<P>The spectrum display and the included phase display are the main tuning aid. You can choose a direct
354
frequency representation or the waterfall representation.
355
<P>You select the appropriate mode by clicking the tab bar.
356
<P>In the waterfall a stronger amplitude results in a brighter colour.As time goes on each horizontal frequency
357
sample line shifts down and the new one is placed on top.This gives the appearance of an waterfall.
358
<P>Normally the spectrum reaches from 100 Hz to 2200 Hz. Changing the endpoints of the spectrum zooms the display.
359
<P>By clicking into the display you can select the frequency of the active RX window.
360
<P>If you overdrive your soundcard the colour of the spectrum turns to red.
365
<P>Pressing Tune you 'll send a steady carrier. With the
366
<A HREF="#OutputControl">output control</A>
367
in the settings menu you can adjust the output level. Don't overdrive your transmitter.The ALC of your transmitter shouldn't
372
<P>Pressing this button sends "de @CALLSIGN@ pse k" in CW.
375
<H3>Clear RX Window</H3>
377
<P>Clears the content of active RX - Window
380
<H3>Clear QSO Info</H3>
382
<P>Clears the contents of the QSO - Info fields
387
<P>Here you can fill in some QSO - Infos. These are used in some macros
391
<P>The callsign of the remote station. You can enter it by clicking into this field and
392
typing the callsign on the keyboard or you doubleclick in the active RX - window
393
in front of the callsign and it will be copied in this field
398
<P>Click into this field and enter the remote op's name by the keyboard
401
<H3><A NAME="Macros"></A> Macros</H3>
403
<P>The contents of the macros will be defined in the
404
<A HREF="#EditMacros">Edit Macros</A>
405
section of the setup menu
409
<P>Only works in RX mode and switches to TX mode, sends the start macro and switches back to RX mode
413
<P>Only works in TX mode. Sends the BTU macro and switches back to RX mode.
416
<P>Works in RX and in TX mode. If you're in RX- Mode it switches into TX mode , send the Final macro and switches
418
In TX mode the Final macro text is sent and then the mode switches to RX mode.
422
<P>Only works in RX mode. It is switched to TX mode, the cq macro is sent and then switched back to RX mode.
424
<H3>Send Station File</H3>
426
<P>This only works in TX mode. In TX mode the content of the station file is send.
427
The macro variables won't be evaluated at the monment.
430
<H3>undefined button</H3>
432
<P>If you defined this button in the setup menu, the content of the correspondig file will be
433
sent, if you're in TX mode. In RX mode nothing happens.
434
<P>The macro variables won't be evaluated at the monment.
435
<P>Personally I use a file to introduce myself.
439
<A HREF="index-4.html">Next</A>
440
<A HREF="index-2.html">Previous</A>
441
<A HREF="index.html#toc3">Contents</A>
added
removed
linpsk/docs/en/index-3.html
