ATEST(1)

πŸ“¦
version 1.8.1 Β· 3 versions
, in alpine 3.24, fedora 43, fedora 44, nixos 26.05, nixpkgs unstable

πŸŽ€ ATEST(1) β€” General Commands Manual πŸŽ€

okay so bestie, you're looking at the ATEST(1) page from the General Commands Manual, and honestly? it's lowkey iconic. let's get into it πŸ’…


✨ NAME ✨

atest β€” Decode AX.25 frames from an audio file. that's it, that's the vibe. πŸ¦‹


🌸 SYNOPSIS 🌸

atest [ options ] wav-file-in

and wav-file-in is a WAV format audio file. like, an actual WAV. that's the whole assignment. πŸŽ€


πŸ’– DESCRIPTION πŸ’–

so atest is a test application which decodes AX.25 frames from an audio recording. girl, it's literally the easiest way to test Dire Wolf decoding performance β€” way quicker than doing it in normal real time. no cap, you just point it at a file and it goes. ⭐


πŸ‘‘ OPTIONS πŸ‘‘

okay here's the whole menu, don't skip a single one, they all matter:

  • -B n β€” Data rate in bits/sec. Standard values are 300, 1200, 2400, 4800, 9600.
    • 300 bps defaults to AFSK tones of 1600 & 1800.
    • 1200 bps uses AFSK tones of 1200 & 2200.
    • 2400 bps uses QPSK based on V.26 standard.
    • 4800 bps uses 8PSK based on V.27 standard.
    • 9600 bps and up uses K9NG/G3RUH standard.
    • AIS for ship Automatic Identification System.
    • EAS for Emergency Alert System (EAS) Specific Area Message Encoding (SAME).
  • -g β€” Force G3RUH modem regardless of data rate. it does not care about your data rate, it's giving main character energy.
  • -j β€” 2400 bps QPSK compatible with Dire Wolf <= 1.5.
  • -J β€” 2400 bps QPSK compatible with MFJ-2400.
  • -D n β€” Divide audio sample rate by n.
  • -h β€” Print frame contents as hexadecimal bytes.
  • -F n β€” Amount of effort to try fixing frames with an invalid CRC. 0 (default) = consider only correct frames. 1 = Try to fix only a single bit. more = Try modifying more bits to get a good CRC.
  • -L β€” Error if Less than this number decoded.
  • -G β€” Error if Greater than this number decoded.
  • -P m β€” Select the demodulator type such as D (default for 300 bps), E+ (default for 1200 bps), PQRS for 2400 bps, etc.

🧚 EXAMPLES 🧚

first up, the classic 1200 setup:

gen_packets -o test1.wav
atest test1.wav

then we slow it all the way down to 300:

gen_packets -B 300 -o test3.wav
atest -B 300 test3.wav

and then we go zoomies at 9600:

gen_packets -B 9600 -o test9.wav
atest -B 9600 test9.wav
This generates and decodes 3 test files with 1200, 300, and 9600 bits per second. three whole files, obsessed. 🌈

now for the experiment era β€” try different combinations of options to compare decoding performance:

atest 02_Track_2.wav
atest -P E- 02_Track_2.wav
atest -F 1 02_Track_2.wav
atest -P E- -F 1 02_Track_2.wav
Try different combinations of options to compare decoding performance. this is your little science lab, have fun with it πŸ”₯

πŸ’œ SEE ALSO πŸ’œ

More detailed information is in the pdf files in /usr/local/share/doc/direwolf, or possibly /usr/share/doc/direwolf, depending on installation location. iykyk, check both. 🫢

Applications in this package: aclients, atest, cm108, decode_aprs, direwolf, gen_packets, kissutil, ll2utm, log2gpx, text2tt, tt2text, utm2ll β€” the whole squad, we love a full roster πŸ‘‘


and that's the page, bestie πŸ’– this was ATEST(1) from the General Commands Manual, signing off β€” mwah, go decode some frames πŸŽ€πŸ’