acarsdec

an ACARS decoder
git clone git://r-36.net/acarsdec
Log | Files | Refs | README

README.mod (1505B)


      1 INTRODUCTION
      2 
      3 This acarsdec was modified by
      4 	2010 - 2012 Christoph Lohmann <20h@r-36.net>
      5 	2012 Wilson Costrino <wilsonc4@gmail.com>
      6 
      7 In addition to this, stdinsrv.py was added, for additionaly functionality.
      8 See the examples for how to use these possibilities.
      9 
     10 
     11 INSTALLATION
     12 
     13  % make
     14  % cp acarsdec /usr/bin
     15  % cp stdinsrv.py /usr/bin/stdinsrv
     16 
     17 
     18 STARTUP
     19 
     20 For a daemon mode, using stdinsrv, see the rc.d/* files. For now there
     21 are the example files for an Archlinux installation.
     22 
     23 
     24 EXAMPLES
     25 
     26 Reading from first alsa device, only processing the right stereo channel,
     27 outputting to stdout, in a parseable format and multiplexing it to the
     28 network on port 5102.
     29 
     30  % acarsdec -d hw0,0 -p -R | stdinsrv -p 5102 
     31 
     32 Decoding a recorded ACARS example wav file (48000!) on stdin, to the original
     33 acarsdec format:
     34 
     35  % cat examples/acars.wav | acarsdec -t
     36 
     37 
     38 COMPLEX EXAMPLE
     39 
     40 Server: ACARS receiver -> sound in
     41 Client: We want to hear the ACARS signal and see the decoded message for
     42 	a comparison, whether the acarsdec decodes them right. (See the
     43 	examples folder for listening to an example ACARS message.) 
     44 
     45 Client:
     46  % socat - TCP-L:5467 | aplay &
     47 
     48 Server:
     49  % mkfifo /tmp/acarsdec
     50  % arecord -f dat | tee /tmp/acarsdec | socat - TCP:$ClientIP:5467 &
     51  % acarsdec -f /tmp/acarsdec -p | stdinsrv -p 5102
     52 
     53 Client:
     54  % socat - TCP:$ServerIP:5102
     55 
     56 
     57 OTHER FLAGS
     58 
     59 There is flag -v (verbose), which forces stdout output during the -s mode.
     60 The -e flag enables some debugging output, you might find interesting.
     61 
     62 Have fun!
     63