-
Notifications
You must be signed in to change notification settings - Fork 1
/
Copy pathHelp.html
751 lines (700 loc) · 32.5 KB
/
Help.html
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
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<head>
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
<title>VE2ZAZ - Si5351 QRSS Transmitter (Beacon) Configuration
Software</title>
<meta name="generator" content="LibreOffice 6.0.7.3 (Linux)">
<meta name="created" content="00:00:00">
<meta name="changed" content="2019-11-07T20:07:18.401989250">
<style type="text/css">
@page { margin: 0.79in }
p { margin-bottom: 0.1in; line-height: 115% }
h2.western { font-family: "Liberation Sans", sans-serif; font-size: 16pt }
h2.cjk { font-family: "Noto Sans CJK SC Regular"; font-size: 16pt }
h2.ctl { font-family: "Lohit Devanagari"; font-size: 16pt }
h4.western { font-family: "Liberation Sans", sans-serif; font-size: 13pt; font-style: italic }
h4.cjk { font-family: "Noto Sans CJK SC Regular"; font-size: 13pt; font-style: italic }
h4.ctl { font-family: "Lohit Devanagari"; font-size: 13pt; font-style: italic }
a:link { so-language: zxx }
</style>
</head>
<body dir="ltr" vlink="#551A8B" text="#000000" bgcolor="#eeeeee"
alink="#EE0000" link="#0000EE" lang="en-US">
<font face="Helvetica, Arial, sans-serif"> </font>
<h1 style="margin-top: 0.17in; margin-bottom: 0.08in; line-height:
100%; page-break-after: avoid" align="center"><font
face="Helvetica, Arial, sans-serif" color="#0066b3"><font
style="font-size: 22pt" size="6"><b>Si5351 QRSS Transmitter
(Beacon) Configuration Software</b></font></font></h1>
<font face="Helvetica, Arial, sans-serif"> </font>
<h1 align="center"><font style="font-size: 14pt" size="4"
face="Helvetica, Arial, sans-serif">Version 0.1, November 2019</font></h1>
<font face="Helvetica, Arial, sans-serif"> </font>
<p style="margin-top: 0.04in; margin-bottom: 0.08in; line-height:
100%; page-break-after: avoid" align="center"><font
style="font-size: 14pt" size="4" face="Helvetica, Arial,
sans-serif"> by Bert, VE2ZAZ (http://ve2zaz<font
face="Helvetica, Arial, sans-serif">.net</font>)</font></p>
<p> </p>
<h2 class="western"><font face="Helvetica, Arial, sans-serif">Description</font></h2>
<p><font face="Helvetica, Arial, sans-serif">This software allows to
configure Silicon Laboratories Si5351A/C Synthesizer chips for
QRSS beacon transmission, when supervised by an Arduino Uno or
Nano board. After the Arduino has received a configuration from
the software, it will re-load the Si5351 chip with that same
configuration at every power up or reset. The Arduino (properly
configured by this software) is required, as the Si5351 chip
does not retain its configuration when power is removed; it must
be re-configured at power up.<br>
</font><a href="Images/Linux_Software_Window.png"><font
face="Helvetica, Arial, sans-serif"><img alt=""
src="Images/Linux_Software_Window.png" vspace="10"
align="right" hspace="10" width="400" border="1"
height="407"></font></a><br>
<font face="Helvetica, Arial, sans-serif">This software was
written in FreePascal programming language within the Lazarus
IDE. Being a cross-platform compiler, the executable can be made
to run in any Linux, Windows or Mac OS environment when compiled
in that environment. See the "Prerequisites and Installation"
section below for more details specific to the operating system
you are running.</font></p>
<p><font face="Helvetica, Arial, sans-serif">This software was
developed on a VE2ZAZ synthesizer board (below, left) hosting an
Arduino-nano and an Si5351C Clock Synthesizer chip. The board
can alternately be equipped with the Chinese-made Si5351A board
(below, right). The main difference between the A and C versions
of the Si5351 is that the C version can lock to an external
frequency reference between 10 and 40 Mhz (usable down to 5
MHz). All produced output frequencies are then PLL-locked to
that reference. The A version relies solely on the accompanying
on-board 25 or 27 MHz crystal for its reference. Another
advantage of the VE2ZAZ board is that it includes an external
reference scaling/shaping circuit, which provides the proper
amplitude to the Si5351C, regardless of the shape or amplitude
of the input signal. For more information on the </font><font
face="Helvetica, Arial, sans-serif"><font face="Helvetica,
Arial, sans-serif">VE2ZAZ synthesizer board, please visit the
<a href="http://ve2zaz.net/Si5351_Synth/Si5351_Synth.htm">VE2ZAZ
website</a>.<br>
</font></font></p>
<p><font face="Helvetica, Arial, sans-serif"><font face="Helvetica,
Arial, sans-serif">Note that this software is not designed to
run exclusively on the VE2ZAZ Synthesizer board. As a minimum,
one can build this beacon on a solderless prototype board
using an Arduino Nano, an off-the-shelf</font><font
face="Helvetica, Arial, sans-serif"><font face="Helvetica,
Arial, sans-serif"> Si5351A board, and the I2C line
conversion circuit, also available </font></font><font
face="Helvetica, Arial, sans-serif"><font face="Helvetica,
Arial, sans-serif"><font face="Helvetica, Arial, sans-serif">off-the-shelf</font>.
External +5V and +3.3V supplies are required. See the </font></font><font
face="Helvetica, Arial, sans-serif"><font face="Helvetica,
Arial, sans-serif"><font face="Helvetica, Arial, sans-serif">VE2ZAZ's
Si5351A/C Synthesizer board Circuit Schematic (above).<br>
</font></font></font></font></p>
<p><font face="Helvetica, Arial, sans-serif">The software offers
three QRSS transmit modes: </font></p>
<p> </p>
<p> </p>
<p> </p>
<p> </p>
<p> </p>
<ol>
<li>
<p> </p>
<p><font face="Helvetica, Arial, sans-serif"><b>ASK-CW</b>,
which is more or less regular CW, but stretched in time.<br>
</font> </p>
<p> </p>
</li>
</ol>
<p> </p>
<p> </p>
<p> </p>
<ol>
<li>
<p> </p>
<p><font face="Helvetica, Arial, sans-serif"><b>FSK-CW</b>,
which is an always-on mode using frequency shifting to
differentate between dits/dahs and silences. <br>
</font> </p>
<p> </p>
</li>
</ol>
<p> </p>
<p> </p>
<p> </p>
<ol>
<li>
<p> </p>
<p><font face="Helvetica, Arial, sans-serif"><b>MFSK-Text</b>,
which uses multiple tone frequencies to encode a text
message's pixels. </font></p>
<p> </p>
</li>
</ol>
<p> </p>
<p> </p>
<p> </p>
<p> <font face="Helvetica, Arial, sans-serif">Among available
settings, the Morse code 'dit' duration, the FSK frequency shift
and the external reference frequency can be set. An optional
fast CW identification can be inserted after each transmission
cycle, so that anyone can decode who is sending the tones,
without the need of waterfall display capabilities. </font></p>
<tb></tb>
<table cellspacing="2" cellpadding="2" align="center" width="100%"
border="0">
<tbody>
<tr>
<td valign="top" align="center" width="50%"><font
face="Helvetica, Arial, sans-serif"><img
src="Images/VE2ZAZ_Si5351C_Board.JPG" alt="" width="444"
border="1" height="250"><br>
</font>
<p><font face="Helvetica, Arial, sans-serif"> VE2ZAZ's
Si5351A/C Synthesizer board (populated with Arduino Nano
and Si5351C)</font></p>
<p> </p>
</td>
<td valign="top" align="center"><font face="Helvetica, Arial,
sans-serif"><img src="Images/Si5351A_board.jpg" alt=""
width="250" border="1" height="250"><br>
</font>
<p> <font face="Helvetica, Arial, sans-serif">Chinese-made
Si5351A board</font></p>
</td>
</tr>
<tr align="center">
<td colspan="1" valign="top"><a
href="Images/VE2ZAZ_Si5351_Synth_v1.1.png"><img
src="Images/VE2ZAZ_Si5351_Synth_v1.1.png" alt=""
width="362" border="0" height="250"></a><br>
<font face="Helvetica, Arial, sans-serif">VE2ZAZ's Si5351A/C
Synthesizer board Circuit Schematic<br>
(click on image to enlarge)<br>
</font></td>
<td valign="top"><font face="Helvetica, Arial, sans-serif"><img
src="Images/QRSS_ASK.jpg" alt="" width="477" border="1"
height="83"><br>
</font><font face="Helvetica, Arial, sans-serif"><img
src="Images/QRSS_FSK.jpg" alt="" width="477" border="1"
height="83"><br>
</font><font face="Helvetica, Arial, sans-serif"><img
src="Images/QRSS_MFSK.jpg" alt="" width="477" border="1"
height="83"><br>
</font><font face="Helvetica, Arial, sans-serif">The
available QRSS Transmit modes seen on an horizontal
waterfall display, <br>
from top to bottom: ASK-CW, FSK-CW and MFSK-Text</font><br>
</td>
</tr>
</tbody>
</table>
<br>
<font face="Helvetica, Arial, sans-serif"><u><b>IMPORTANT NOTES:</b></u>
<br>
</font>
<ul>
<li>
<p><font face="Helvetica, Arial, sans-serif">The Si5351's output
pulse shape is square. This produces significant spurious
odd-harmonics, the 3rd harmonic being only 10dB down from
the fundamental. A low pass or band-pass filter is <font
color="#660000">MANDATORY</font> between the Si5351 and
the Antenna, otherwise regulations may not be met. For
example, assuming a transmit frequency of 7 or 10 MHz, a 7th
order LC low-pass filter with a cutoff frequency of 15 MHz
should be suitable. This can be hand-made using a few pieces
of wire and capacitors...and online filter calculators are
readily available.</font></p>
</li>
<li>
<p><font face="Helvetica, Arial, sans-serif"><font
face="Helvetica, Arial, sans-serif">In order to remain
legal, at the very least, the transmitted message should
contain the amateur radio call sign, but the text mode
could instead display a website or email address
containing the call sign.</font></font></p>
</li>
</ul>
<font face="Helvetica, Arial, sans-serif"><font face="Helvetica,
Arial, sans-serif"><br>
</font></font><br>
<font face="Helvetica, Arial, sans-serif"> </font> <font
face="Helvetica, Arial, sans-serif"> </font>
<h2 class="western"><font face="Helvetica, Arial, sans-serif">Prerequisites
and Installation<br>
</font></h2>
<font face="Helvetica, Arial, sans-serif"> </font>
<ul>
<li>
<p><font face="Helvetica, Arial, sans-serif">This software is
non-invasive:</font></p>
</li>
<ul>
<li>
<p><font face="Helvetica, Arial, sans-serif">No installation
program is required to run this software. Simply
double-click on the "QRSS_Xmitter_Configurator" executable
file to launch the program. <br>
</font></p>
</li>
<li>
<p><font face="Helvetica, Arial, sans-serif">Everything
happens in the local directory and sub-directories where
the executable is located. <br>
</font></p>
</li>
<li>
<p><font face="Helvetica, Arial, sans-serif">No Windows
registry writes are deliberately performed by the
software.No Windows environment variables are modified or
added.<br>
</font></p>
</li>
</ul>
<li>
<p><font face="Helvetica, Arial, sans-serif">This software uses
the LazSerial 3rd-party Lazarus component. In the situation
where this software must be re-compiled, the LazSerial
component must be installed in Lazarus IDE prior to
compiling the software. See the "Recompiling" section below
for more detail on the compilation process.</font></p>
</li>
</ul>
<h3><font face="Helvetica, Arial, sans-serif">Arduino</font></h3>
<ul>
<li>
<p style="margin-bottom: 0in; line-height: 100%"><font
face="Helvetica, Arial, sans-serif">The accompanying Arduino
software (sketch) must be used in conjunction with this
software, otherwise the latter will not function. </font> </p>
<p> </p>
</li>
<li>
<p style="margin-bottom: 0in; line-height: 100%"><font
face="Helvetica, Arial, sans-serif">The Arduino sketch uses
Jason Mildrum's Etherkit Si5351Arduino library (<a
href="https://github.com/etherkit/Si5351Arduino">https://github.com/etherkit/Si5351Arduino</a>).
To recompile/install the Arduino sketch, that library must
first be installed in the Arduino IDE via the Library
Manager (Menu: Sketch -> Include Library -> Manage
Libraries...).</font></p>
</li>
</ul>
<font face="Helvetica, Arial, sans-serif"> </font>
<h3 class="western"><font face="Helvetica, Arial, sans-serif">Windows</font></h3>
<font face="Helvetica, Arial, sans-serif"> </font>
<ul>
<li>
<p style="margin-bottom: 0in; line-height: 100%"><font
face="Helvetica, Arial, sans-serif">The proper Arduino
USB-Serial virtual port driver must be installed prior to
using this software. This is normally the case with Windows
versions prior to Windows 10. Note that this driver is
typically installed during the Arduino IDE installation.</font></p>
<p> </p>
</li>
<li>
<p style="margin-bottom: 0in; line-height: 100%"><font
face="Helvetica, Arial, sans-serif">This project is supplied
with an executable (.exe) that was compiled in Windows 7
32-bits. The supplied executable has been verified to work
correctly in Windows 7 32-bits and in Windows 10
64-bits.Thus it is expected to run properly in the Windows
7, 8 and 10 (both 32 and 64-bit) operating systems.
Providing a 32-bit executable will be possible for as long
as the 32-bit version of Lazarus is available. Note that
re-compiling is always possible. General instructions on how
to compile the software are provided below.</font> </p>
<p> </p>
</li>
</ul>
<h3 class="western"><font face="Helvetica, Arial, sans-serif">Linux</font></h3>
<font face="Helvetica, Arial, sans-serif"> </font>
<ul>
<li>
<p style="margin-bottom: 0in; line-height: 100%"><font
face="Helvetica, Arial, sans-serif">This project is supplied
with an executable that was compiled in Linux Xubuntu 18.04
LTS 64-bits. The Linux executable may not run in other Linux
distros due to some library dependencies. Re-compiling may
be required. General instructions on how to compile the
software are provided below. <br>
</font></p>
</li>
<li>
<p style="margin-bottom: 0in; line-height: 100%"><font
face="Helvetica, Arial, sans-serif">The Arduino USB-Serial
virtual port driver is typically included with most Linux
distributions. The Arduino Nano virtual port should
automatically be detected.</font></p>
</li>
</ul>
<h3><font face="Helvetica, Arial, sans-serif">Mac OS</font></h3>
<ul>
<li>
<p><font face="Helvetica, Arial, sans-serif">Although it has not
been tested, the software should also run properly on the
Mac OS once compiled in that OS. Similar serial port
considerations also apply.<br>
</font></p>
</li>
</ul>
<h3><font face="Helvetica, Arial, sans-serif">Recompiling</font></h3>
<p><font face="Helvetica, Arial, sans-serif">When needed, the
program can be easily recompiled in the Lazarus IDE environment,
which is available free of charge.<br>
</font></p>
<p> </p>
<p> </p>
<ol>
<li>
<p><font face="Helvetica, Arial, sans-serif">Decompress and save
this project (the entire directory and its content) on your
local drive.<br>
</font></p>
</li>
<li>
<p><font face="Helvetica, Arial, sans-serif">Download and
install the Lazarus IDE package (select the version based on
the current operating system) from the Lazarus website: <a
href="https://www.lazarus-ide.org/">https://www.lazarus-ide.org/</a></font></p>
</li>
<li>
<p><font face="Helvetica, Arial, sans-serif">In Lazarus IDE,
install the Lazserial component using the Online Package
Manager (Menu: Package -> Online Package Manager). Check
mark "LazSerial" and click on the "Install" button.<br>
</font></p>
</li>
<li>
<p><font face="Helvetica, Arial, sans-serif">In Lazarus IDE,
open the "QRSS_Xmitter_Configurator.lpi" project file (Menu:
Project -> Open Project...)</font></p>
</li>
<li>
<p><font face="Helvetica, Arial, sans-serif">In Lazarus IDE,
build the project (Menu: Run -> Build or Run).</font></p>
</li>
</ol>
<font face="Helvetica, Arial, sans-serif"><br>
</font>
<p> </p>
<h2 class="western"><font face="Helvetica, Arial, sans-serif">Operation</font></h2>
<h3><font face="Helvetica, Arial, sans-serif">General<br>
</font></h3>
<font face="Helvetica, Arial, sans-serif"> </font>
<ul>
<li>
<p><font face="Helvetica, Arial, sans-serif">Launching the
software is done by simply double-clicking on the
"QRSS_Xmitter_Configurator" executable file (in Windows,
"QRSS_Xmitter_Configurator.exe"). In linux, if the program
does not launch, verify that the "executable" file flag is
set.<br>
</font></p>
</li>
<li>
<p><font face="Helvetica, Arial, sans-serif">Hints pop-up when
the mouse cursor hovers over an entry field. This provides
instantaneous info on the function of each field. </font></p>
</li>
<li>
<p><font face="Helvetica, Arial, sans-serif">The software saves
the various field values and the window position in a text
file named "saved_settings.cfg" in the same directory as the
executable file. This is performed at program exit.
Reloading of the field values is done at program launch by
reading the file. The absence of that file in the directory
will force the program to revert to default values at
program launch. </font></p>
</li>
<li>
<p> <font face="Helvetica, Arial, sans-serif">This software
uses Output-0 (the first Si5351 output) as the transmitting
port. Other ports are left non-configured.</font> </p>
</li>
<li>
<p style="margin-bottom: 0in; line-height: 100%"><font
face="Helvetica, Arial, sans-serif">All frequencies must be
entered in Hertz, for example 24.123456 MHz is entered as
"24123456". A frequency may be entered with up to 2
decimals, for example 10 MHz can be entered as
"10000000.00".</font></p>
</li>
</ul>
<h3><font face="Helvetica, Arial, sans-serif">Field Description</font></h3>
<h4><font face="Helvetica, Arial, sans-serif">
Frequency Configuration Zone</font></h4>
<ul>
<li>
<p><font face="Helvetica, Arial, sans-serif"><b>Tx Carrier
Frequency:</b> Carrier frequency of the transmitted
signal, expressed in Hertz. </font></p>
</li>
<ul>
<li>
<p><font face="Helvetica, Arial, sans-serif">In ASK-CW mode,
this is the frequency of the CW signal.</font></p>
</li>
<li>
<p><font face="Helvetica, Arial, sans-serif">In FSK-CW mode,
this is the frequency of the dits and dahs tone of the CW
signal. The frequency of the alternate tone (when no dits
or dahs are being sent) is lower by the Frequency Shift
value.</font></p>
</li>
<li>
<p><font face="Helvetica, Arial, sans-serif">In MFSK Text
mode, this frequency corresponds to tone of the lowest row
of pixels forming the characters.</font></p>
</li>
</ul>
</ul>
<ul>
<li>
<p><font face="Helvetica, Arial, sans-serif"><b>QRSS Mode:</b>
Selects which type of QRSS signal the system will produce.</font></p>
</li>
<ul>
<li>
<p><font face="Helvetica, Arial, sans-serif">ASK-CW: Regular
on-off CW (dits and dahs) carrier.<br>
</font></p>
</li>
<li>
<p><font face="Helvetica, Arial, sans-serif">FSK-CW: Frequency
Shifting CW carrier. Instead of an on-off carrier, a
frequency shift is generated when no dits or dahs are
being sent.<br>
</font></p>
</li>
<li>
<p><font face="Helvetica, Arial, sans-serif">MFSK Text: The
transmitted message is made of a string of characters,
each made of an array of 8 x 5 pixels, readable on an
horizontal waterfall display. The eight "horizontal" rows
of pixels are generated by frequency-shifting the carrier
by the Frequency Shift value. The five "vertical" columns
of pixels are sequentially sent in time, with a spacing
set by the QRSS Text Pixel Duration value.<br>
</font></p>
</li>
</ul>
</ul>
<ul>
<li>
<p><font face="Helvetica, Arial, sans-serif"><b>Frequency Shift
(Hz):</b> Frequency change produced to modulate the
QRSS signal in the FSK-CW and MFSK-Text modes.</font></p>
</li>
<ul>
<li><font face="Helvetica, Arial, sans-serif">In FSK-CW mode,
this sets the downward frequency shift (from the Tx carrier
frequency) that is generated when no dits or dahs are being
sent. A suggested value is 5 Hertz.</font></li>
<li><font face="Helvetica, Arial, sans-serif">In MFSK-Text mode,
this sets the upward frequency shift (from the Tx carrier
frequency) that is generated to produce each of the eight
"horizontal" rows of pixels. A suggested value is 3 Hertz.<br>
</font></li>
</ul>
<li>
<p><font face="Helvetica, Arial, sans-serif"><b>Output_Power:</b>
This allows to select which output drive current (2, 4, 6 or
8 mA) that the Si5351 uses on its RF output. This
corresponds to the proposed <u>approximate</u> output
powers of 2, 5, 10 and 12 milliWatts, as measured by the
author at 10 MHz on a 50-Ohm terminated power meter.<br>
</font></p>
</li>
<li>
<p><font face="Helvetica, Arial, sans-serif"><b>Reference
Selection:</b> Selects the reference signal that
cadences the entire Si5351 clock generation.<br>
</font></p>
</li>
<ul>
<li>
<p><font face="Helvetica, Arial, sans-serif">On-board Crystal:
This selects the on-board free-running crystal (either 25
or 27 MHz, depending on the crystal connected to the
Si5351) as the reference. This selection can be made for
both the Si5351<b>A</b> and Si5351<b>C</b> synthesizer
chips.<br>
</font></p>
</li>
<li>
<p><font face="Helvetica, Arial, sans-serif">External Input:
This selects the external input as the reference, which
can accept a frequency range of 10 MHz to 40 MHz.
Typically, a 10 MHz reference signal is used. Only usable
with an Si5351<b>C</b> synthesizer chip. </font> </p>
</li>
</ul>
<li>
<p><font face="Helvetica, Arial, sans-serif"><b>Reference
Frequency:</b> This <u>must contain</u> the
reference frequency, whether the 25 or 27 MHz on-board
crystal or the external reference input is used. Entering a
wrong reference frequency will produce a wrong output
frequency. It must be expressed in Hertz, for example
"25000000".<br>
</font></p>
</li>
<li>
<p><font face="Helvetica, Arial, sans-serif"><b>Frequency
Offset:</b> Provides the ability to correct for
inaccuracies in the reference frequency by entering the
offset from nominal in Parts-Per-Million. A positive value
will correct a reference frequency that sits too high. A
negative value will correct a reference frequency that sits
too low. Obviously if the exact reference frequency is
known, it can also be entered in the Reference Frequency
field; this will have the same effect as entering an offset
in PPM. This field accepts a number with up to two decimals.</font>
</p>
</li>
</ul>
<h4><font face="Helvetica, Arial, sans-serif">
Message Configuration Zone<br>
</font></h4>
<ul>
<li>
<p><font face="Helvetica, Arial, sans-serif"><b>QRSS / CW ID
Call Sign:</b> This is the call sign that is sent in
the QRSS CW modes. The optional Fast CW Identification also
uses this call sign. Only letters, digits, the '/' slash and
the space characters are accepted. Lowercase characters get
converted to uppercase before transmission.<br>
</font></p>
</li>
<li>
<p><font face="Helvetica, Arial, sans-serif"><b>QRSS CW Dit
Duration:</b> Sets the duration of the "dit" (Morse
code dot) during QRSS CW transmissions. The "dah" (Morse
code dash) will be three times that duration, and spaces
will use the same proportion. Entered in milliseconds. A
suggested value is 5000 milliseconds.<br>
</font></p>
</li>
<li>
<p><font face="Helvetica, Arial, sans-serif"><b>QRSS Text:</b>
This is the text message that is sent in the MFSK-Text mode.
A call sign, email address or web site address can be used.
To remain legal, it is strongly suggested that the string
includes the call sign. Most letters, digits and other ASCII
symbols are accepted. The maximum message length is 30
characters, including spaces. Lowercase characters get
converted to uppercase before transmission. <br>
</font></p>
</li>
<li>
<p><font face="Helvetica, Arial, sans-serif"><b>QRSS Text Pixel
Duration:</b> Sets the duration of each character
"pixel" sent during MFSK-Text transmissions. Entered in
milliseconds. A suggested value is 1000 ms.<br>
</font></p>
</li>
<li>
<p><font face="Helvetica, Arial, sans-serif"><b>Insert Fast CW
ID:</b> This enables the optional Fast (normal
speed) CW Identification. This feature allows others to
identify who is sending the signal, without the need for any
computer to decode QRSS. When checked, the QRSS / CW ID Call
Sign is inserted at the end of each QRSS transmission cycle.
<br>
</font></p>
</li>
<li>
<p><font face="Helvetica, Arial, sans-serif"><b>Fast CW Dit
Duration (ms):</b> Sets the duration of the "dit"
(Morse code dot) during Fast CW ID transmissions. Entered in
milliseconds. A typical value range is between 50 and 100
milliseconds.<br>
</font></p>
</li>
<li>
<p><font face="Helvetica, Arial, sans-serif"><b>Serial Port
Field:</b> This sets which serial port will be used
by the software to communicate with the Arduino.</font></p>
</li>
<ul>
<li>
<p><font face="Helvetica, Arial, sans-serif">In Windows, the
syntax used in the Serial Port field is "COMx", for
example "COM6". The user shall find out which COM port is
associated with the USB-serial adapter on the Arduino
board by consulting the Windows Device Manager or the
Arduino IDE (Menu: Tools -> Port).</font></p>
</li>
<li>
<p><font face="Helvetica, Arial, sans-serif">In Linux, the
syntax used in the Serial Port field is "/dev/ttyUSBx",
for example "/dev/ttyUSB0". The user shall find out which
serial port is associated with the USB-serial adapter on
the Arduino board by consulting the "/dev" device
directory, or the Arduino IDE (Menu: Tools -> Port).</font></p>
</li>
</ul>
<li>
<p><font face="Helvetica, Arial, sans-serif"><b>Transfer Button:</b>
This initiates a configuration transfer to the Arduino. The
user shall monitor the Status Message Field to receive
progress reports of the configuration transfer.<br>
</font></p>
</li>
<li>
<p><font face="Helvetica, Arial, sans-serif"><b>Help... Button:</b>
Opens this page in the default web browser.<br>
</font></p>
</li>
<li>
<p><font face="Helvetica, Arial, sans-serif"><b>Quit Button:</b>
Terminates this program gracefully. Before the window
closes, the configuration data contained in the various
window fields is saved to the local drive.<br>
</font></p>
</li>
<li>
<p><font face="Helvetica, Arial, sans-serif"><b>Status Message
Field:</b> This read-only box displays progress
messages during the configuration transfer process. It also
displays program errors.<br>
<br>
</font></p>
</li>
</ul>
<h2 class="western"><font face="Helvetica, Arial, sans-serif">Legal
Notice</font></h2>
<font face="Helvetica, Arial, sans-serif"> </font>
<p style="margin-bottom: 0in; line-height: 100%"><font
face="Helvetica, Arial, sans-serif">This software, along with
all accompanying files and scripts, is free software: you can
redistribute it and/or modify it under the terms of the GNU
General Public License as published by the Free Software
Foundation, either version 3 of the License, or any later
version. This program is distributed in the hope that it will be
useful, but WITHOUT ANY WARRANTY; without even the implied
warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
PURPOSE. See the GNU General Public License for more
details. You should have received a copy of the GNU General
Public License along with this program. If not, see
<https://www.gnu.org/licenses/>. When modifying the
software, a mention of the original author, namely Bert-VE2ZAZ,
would be a gracious consideration.<br>
<br>
</font></p>
<font face="Helvetica, Arial, sans-serif"> </font>
<h2 class="western"><font face="Helvetica, Arial, sans-serif">Note </font></h2>
<font face="Helvetica, Arial, sans-serif"> </font>
<p style="margin-bottom: 0in; line-height: 100%"><font
face="Helvetica, Arial, sans-serif">This text is extracted from
the "Help.html" file (and the "Images" directory) provided with
this software.</font></p>
<font face="Helvetica, Arial, sans-serif"> </font>
</body>
</html>