WSJT-X/manpages/man1/jt65code.1.txt
Bill Somerville 5f2ba00bb8
Add Version Info resources to Windows executables where needed.
Version information  and more  in the  Windows resources  for main
    applications, installer and un-installer.

    Update  CMake   policies  for  new  project()   command,  and  DEB
    dependency changes

    Support  older  libgfortran  packages,  and  other  Linux  package
    dependencies.

    Use new project description file in Debian packaging.

    Linux packaging dependency adjustments  for Debian style packages,
    including  a machine  readable  Debian  copyright format,  project
    description in separate file for  CPack compatibility, and use for
    DEB packaging.

    Configure check for need to link libm Standard C Math Library.

    CMake compatibility for <3.17.
2020-10-10 13:38:15 +01:00

180 lines
6.0 KiB
Plaintext

:doctype: manpage
:man source: AsciiDoc
:man version: {VERSION}
:man manual: WSJT-X Manual
= jt65code(1)
== NAME
jt65code, jt9code, jt4code, qra64code, ft8code, msk144code - Weak signal communications encoding support utilities.
== SYNOPSIS
*jt65code* "'MESSAGE'"
*jt65code* ['OPTIONS']
*jt9code* "'MESSAGE'"
*jt9code* ['OPTIONS']
*jt4code* "'MESSAGE'"
*jt4code* ['OPTIONS']
*qra64code* "'MESSAGE'"
*qra64code* ['OPTIONS']
*ft8code* "'MESSAGE'"
*ft8code* ['OPTIONS']
== OPTIONS
*-t*::
Prints a selection of messages alongside their corresponding decoded
form and types. With *ft8code* prints a selection of short format
messages
*-T*::
As *-T* but for *ft8code* prints long format messages.
== DESCRIPTION
*jt65code*, *jt9code*, *jt4code*, and *ft8code* are utility programs
that let you explore the conversion of user-level messages into
channel symbols or “tone numbers.” These programs can be useful to
someone designing a beacon generator for JT9 or JT65, or for studying
behavior of the error-control codes for each of the protocols.
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. To run jt9code, enter the program name followed by a JT9 message
enclosed in quotes. In Windows the command and program output might
look like this:
.....
$ jt9code "G0XYZ K1ABC FN42"
Message: G0XYZ K1ABC FN42
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
Decoded message: G0XYZ K1ABC FN42
.....
For the corresponding program jt65code only the information-carrying
channel symbols are shown, and the symbol values range from 0 to
63. Sync synbols lie two tone intervals below data tone 0, and the
sequential locations of sync symbols are described in the 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:
.....
$ jt65code "G0XYZ K1ABC FN42"
Message: G0XYZ K1ABC FN42
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
Decoded message: G0XYZ K1ABC FN42
.....
For an illustration of the power of the strong error-control coding in
JT9, JT65 and JT4, try looking at the channel symbols after changing a
single character in the message. For example, change the grid locater
from FN42 to FN43 in the JT65 message:
.....
$ jt65code "G0XYZ K1ABC FN43"
Message: G0XYZ K1ABC FN43
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
Decoded message: G0XYZ K1ABC FN43
.....
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.
.....
$ qra64code "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
61 36 45 30 3 55 3 2 14 5 33 41 14 28 2 7 58 45 9 43 20 48 29 55 43 24 3 13 18 21
40 3 17 28 59 62 2 50 26 24 2 1 2 61 10 9 16 40 1 18 28 30 33 39 60 45 16 21 60 11
9 40 14
Channel symbols including sync
20 50 60 0 40 10 30 61 36 45 30 3 55 3 2 14 5 33 41 14 28 2 7 58 45 9 43 20 48 29
55 43 24 3 13 18 21 40 3 20 50 60 0 40 10 30 17 28 59 62 2 50 26 24 2 1 2 61 10 9
16 40 1 18 28 30 33 39 60 45 16 21 60 11 9 40 14 20 50 60 0 40 10 30
.....
.....
$ msk144code "G0XYZ K1ABC FN43"
Message Decoded Err i3.n3
----------------------------------------------------------------------------------------------------
1. G0XYZ K1ABC FN43 G0XYZ K1ABC FN43 1. Standard msg
Channel symbols
110000110100110001010010011100110010010110000011011001001100001101111010
110010110111111100001101001111000111101011111011100001110000011101110110
.....
.....
$ ft8code "G0XYZ K1ABC FN43"
Message Decoded Err i3.n3
----------------------------------------------------------------------------------------------------
1. G0XYZ K1ABC FN43 G0XYZ K1ABC FN43 1. Standard msg
Source-encoded message, 77 bits:
00001000111111010001110111010000010011011110111100011010100010100001100111001
14-bit CRC:
00110001001011
83 Parity bits:
10000110000001010101100000100110100110100000111000101110000110001001110000000110011
Channel symbols (79 tones):
Sync Data Sync Data Sync
3140652 03174526450547670460602143205 3140652 64040136505454507064041140042 3140652
.....
WSJT-X home page:: https://www.physics.princeton.edu/pulsar/K1JT/wsjtx.html
WSJT-X User's Guide::
https://www.physics.princeton.edu/pulsar/K1JT/wsjtx-doc/wsjtx-main-{VERSION}.html
== AUTHOR
Joe Taylor, K1JT.
== COPYING
*jt65code*, *jt9code*, *jt4code*, and *ft8code* are Copyright (C) 2001
- 2020 by Joseph H. Taylor, Jr., K1JT, with contributions from
additional authors. WSJT-X is Open Source software, licensed under
the GNU General Public License (GPLv3).
These programs are distributed in the hope that they 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.