File: utilities.adoc

package info (click to toggle)
wsjtx-improved 3.0.0%2B250924%2Brepack-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 86,260 kB
  • sloc: cpp: 105,882; f90: 60,117; python: 27,241; ansic: 13,372; fortran: 2,382; makefile: 197; sh: 135
file content (154 lines) | stat: -rwxr-xr-x 8,257 bytes parent folder | download | duplicates (2)
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
The _WSJT-X_ packages include program *`rigctl-wsjtx[.exe]`*, which
can be used to send CAT sequences to a rig from the command line, or
from a batch file or shell script; and program *`rigctld-wsjtx[.exe]`*,
which allows other compatible applications to share a CAT connection
to a rig.  These program versions include the latest _Hamlib_ rig
drivers -- the same ones used by _WSJT-X_ itself.

Additional utility programs *`jt4code`*, *`jt9code`*, and *`jt65code`*
let you explore the conversion of user-level messages into channel
symbols or "`tone numbers,`" and back again.  These programs can be
useful to someone designing a beacon generator, for understanding the
permissible structure of transmitted messages, and for studying
behavior of the error-control codes.

Channel-symbol values for JT4 run from 0 to 3.  The total number of
symbols in a transmitted message is 206.  To run `jt4code`, enter the
program name followed by a JT4 message enclosed in quotes.  In Windows
the command and program output might look like this:

 C:\WSJTX\bin> jt4code "G0XYZ K1ABC FN42"
      Message                 Decoded                Err? Type
 -------------------------------------------------------------------
  1.  G0XYZ K1ABC FN42        G0XYZ K1ABC FN42            1: Std Msg

 Channel symbols
  2 0 0 1 3 2 0 2 3 1 0 3 3 2 2 1 2 1 0 0 0 2 0 0 2 1 1 2 0 0
  2 0 2 0 2 0 2 0 2 3 0 3 1 0 3 1 0 3 0 1 1 1 1 1 0 1 0 0 2 3
  2 2 3 0 2 1 3 3 3 3 2 0 2 1 2 3 0 0 2 3 1 1 1 0 3 1 2 0 3 2
  0 2 3 3 0 1 2 1 2 1 0 1 0 1 1 1 1 3 0 3 0 3 2 3 3 0 3 0 1 0
  3 3 3 0 0 3 2 1 3 2 3 1 3 3 2 2 0 2 3 3 2 1 1 0 2 2 3 3 1 2
  3 1 1 2 1 1 1 0 2 1 2 0 2 3 1 2 3 1 2 2 1 2 0 0 3 3 1 1 1 1
  2 0 3 3 0 2 2 2 3 3 0 0 0 1 2 3 3 2 1 1 1 3 2 3 0 3

Channel-symbol values for JT9 run from 0 to 8, with 0 representing the
sync tone.  The total number of symbols in a transmitted message is
85.  Enter the program name followed by a JT9 message enclosed in
quotes:

 C:\WSJTX\bin> jt9code "G0XYZ K1ABC FN42"
      Message                 Decoded                Err? Type
 -------------------------------------------------------------------
  1.  G0XYZ K1ABC FN42        G0XYZ K1ABC FN42            1: Std Msg

 Channel symbols
  0 0 7 3 0 3 2 5 4 0 1 7 7 7 8 0 4 8 8 2 2 1 0 1 1 3 5 4 5 6
  8 7 0 6 0 1 8 3 3 7 8 1 1 2 4 5 8 1 5 2 0 0 8 6 0 5 8 5 1 0
  5 8 7 7 2 0 4 6 6 6 7 6 0 1 8 8 5 7 2 5 1 5 0 4 0

For the corresponding program *`jt65code`* only the
information-carrying channel symbols are shown, and the symbol values
range from 0 to 63.  Sync symbols lie two tone intervals below data
tone 0, and the sequential locations of sync symbols are described in
the <<JT65PRO,JT65 Protocol>> section of this Guide.

A typical execution of `jt65code` is shown below.  The program
displays the packed message of 72 bits, shown here as 12 six-bit
symbol values, followed by the channel symbols:

 C:\WSJTX\bin> jt65code "G0XYZ K1ABC FN42"
      Message                 Decoded                Err? Type
 ----------------------------------------------------------------------
  1.  G0XYZ K1ABC FN42        G0XYZ K1ABC FN42            1:    Std Msg

 Packed message, 6-bit symbols  61 36 45 30  3 55  3  2 14  5 33 40

 Information-carrying channel symbols
    56 40  8 40 51 47 50 34 44 53 22 53 28 31 13 60 46  2 14 58 43
    41 58 35  8 35  3 24  1 21 41 43  0 25 54  9 41 54  7 25 21  9
    62 59  7 43 31 21 57 13 59 41 17 49 19 54 21 39 33 42 18  2 60

For an illustration of the power of the strong error-control coding in
JT9 and JT65, try looking at the channel symbols after changing a
single character in the message.  For example, change the grid locator
from FN42 to FN43 in the JT65 message:

 C:\WSJTX\bin> jt65code "G0XYZ K1ABC FN43"
      Message                 Decoded                Err? Type
 ----------------------------------------------------------------------
  1.  G0XYZ K1ABC FN43        G0XYZ K1ABC FN43            1:    Std Msg

 Packed message, 6-bit symbols  61 36 45 30  3 55  3  2 14  5 33 41

 Information-carrying channel symbols
    25 35 47  8 13  9 61 40 44  9 51  6  8 40 38 34  8  2 21 23 30
    51 32 56 39 35  3 50 48 30  8  5 40 18 54  9 24 30 26 61 23 11
     3 59  7  7 39  1 25 24  4 50 17 49 52 19 34  7  4 34 61  2 61

You will discover that every possible JT65 message differs from every
other possible JT65 message in at least 52 of the 63
information-carrying channel symbols.

Execution of any of these utility programs with "-t" as the only
command-line argument produces examples of all supported message
types.  For example, using `jt65code -t`:

 C:\WSJTX\bin> jt65code -t
 
      Message                 Decoded                Err? Type
 --------------------------------------------------------------------------
  1.  CQ WB9XYZ EN34          CQ WB9XYZ EN34              1:    Std Msg
  2.  CQ DX WB9XYZ EN34       CQ DX WB9XYZ EN34           1:    Std Msg
  3.  QRZ WB9XYZ EN34         QRZ WB9XYZ EN34             1:    Std Msg
  4.  KA1ABC WB9XYZ EN34      KA1ABC WB9XYZ EN34          1:    Std Msg
  5.  KA1ABC WB9XYZ RO        KA1ABC WB9XYZ RO            1:    Std Msg
  6.  KA1ABC WB9XYZ -21       KA1ABC WB9XYZ -21           1:    Std Msg
  7.  KA1ABC WB9XYZ R-19      KA1ABC WB9XYZ R-19          1:    Std Msg
  8.  KA1ABC WB9XYZ RRR       KA1ABC WB9XYZ RRR           1:    Std Msg
  9.  KA1ABC WB9XYZ 73        KA1ABC WB9XYZ 73            1:    Std Msg
 10.  KA1ABC WB9XYZ           KA1ABC WB9XYZ               1:    Std Msg
 11.  CQ 000 WB9XYZ EN34      CQ 000 WB9XYZ EN34          1:    Std Msg
 12.  CQ 999 WB9XYZ EN34      CQ 999 WB9XYZ EN34          1:    Std Msg
 13.  CQ EU WB9XYZ EN34       CQ EU WB9XYZ EN34           1:    Std Msg
 14.  CQ WY WB9XYZ EN34       CQ WY WB9XYZ EN34           1:    Std Msg
 15.  ZL/KA1ABC WB9XYZ        ZL/KA1ABC WB9XYZ            2:    Type 1 pfx
 16.  KA1ABC ZL/WB9XYZ        KA1ABC ZL/WB9XYZ            2:    Type 1 pfx
 17.  KA1ABC/4 WB9XYZ         KA1ABC/4 WB9XYZ             3:    Type 1 sfx
 18.  KA1ABC WB9XYZ/4         KA1ABC WB9XYZ/4             3:    Type 1 sfx
 19.  CQ ZL4/KA1ABC           CQ ZL4/KA1ABC               4:    Type 2 pfx
 20.  DE ZL4/KA1ABC           DE ZL4/KA1ABC               4:    Type 2 pfx
 21.  QRZ ZL4/KA1ABC          QRZ ZL4/KA1ABC              4:    Type 2 pfx
 22.  CQ WB9XYZ/VE4           CQ WB9XYZ/VE4               5:    Type 2 sfx
 23.  HELLO WORLD             HELLO WORLD                 6:    Free text
 24.  ZL4/KA1ABC 73           ZL4/KA1ABC 73               6:    Free text
 25.  KA1ABC XL/WB9XYZ        KA1ABC XL/WB9            *  6:    Free text
 26.  KA1ABC WB9XYZ/W4        KA1ABC WB9XYZ            *  6:    Free text
 27.  123456789ABCDEFGH       123456789ABCD            *  6:    Free text
 28.  KA1ABC WB9XYZ EN34 OOO  KA1ABC WB9XYZ EN34 OOO      1:    Std Msg
 29.  KA1ABC WB9XYZ OOO       KA1ABC WB9XYZ OOO           1:    Std Msg
 30.  RO                      RO                         -1:    Shorthand
 31.  RRR                     RRR                        -1:    Shorthand
 32.  73                      73                         -1:    Shorthand

MSK144 uses a binary channel code, so transmitted symbols have the value
0 or 1.  Even numbered symbols (index starting at 0) are transmitted on
the I (in-phase) channel, odd numbered symbols on the Q (quadrature)
channel.  A typical execution of `msk144code` is shown below.

 C:\WSJTX\bin> msk144code "K1ABC W9XYZ EN37"

      Message                 Decoded                Err? Type
 --------------------------------------------------------------------------
  1.  K1ABC W9XYZ EN37        K1ABC W9XYZ EN37            1: Std Msg

 Channel symbols
 110000100011001101010101001000111111001001001100110010011100001001000000
 010110001011101111001010111011001100110101011000111101100010111100100011

 C:\WSJTX\bin> msk144code "<KA1ABC WB9XYZ> R-03"
      Message                 Decoded                Err? Type
 --------------------------------------------------------------------------
  1.  <KA1ABC WB9XYZ> R-03    <KA1ABC WB9XYZ> R-03        7: Hashed calls

 Channel symbols
 1000011100001000111011111010011011111010