README.mod - acarsdec - an ACARS decoder
 (HTM) git clone git://r-36.net/acarsdec
 (DIR) Log
 (DIR) Files
 (DIR) Refs
 (DIR) 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