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
|