mirror of https://github.com/saitohirga/WSJT-X.git
155 lines
7.9 KiB
Plaintext
155 lines
7.9 KiB
Plaintext
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
|