From 4a07047f3bcd67ccff56ea8b6adb7dbf3536ba8a Mon Sep 17 00:00:00 2001
From: Zilog80 <rs1729@users.noreply.github.com>
Date: Sat, 25 Jan 2020 00:22:03 +0100
Subject: [PATCH] compile/usage info update

---
 demod/mod/README.md   | 18 ++++++++++++++++--
 demod/mod/rs41mod.c   |  2 +-
 demod/mod/rs92mod.c   |  2 +-
 demod/multi/README.md | 26 ++++++++++++++++++++++++++
 4 files changed, 44 insertions(+), 4 deletions(-)
 create mode 100644 demod/multi/README.md

diff --git a/demod/mod/README.md b/demod/mod/README.md
index eef06db..aaa4989 100644
--- a/demod/mod/README.md
+++ b/demod/mod/README.md
@@ -20,9 +20,23 @@ alternative decoders using cross-correlation for better header-synchronization
   `gcc rs92mod.c demod_mod.o bch_ecc_mod.o -lm -o rs92mod` (needs `RS/rs92/nav_gps_vel.c`)
 
 #### Usage/Examples
-  `./rs41mod --ecc2 --crc -vx --ptu <audio.wav>` <br />
-  `./dfm09mod --ecc -v --ptu <audio.wav>` (add `-i` for dfm06)<br />
+  `./rs41mod --ecc2 -vx --ptu <audio.wav>` <br />
+  `./dfm09mod --ecc -v --ptu <audio.wav>` (add `-i` for dfm06; or use `--auto`) <br />
   `./m10mod --dc -vv --ptu -c <audio.wav>` <br />
   `./lms6Xmod --vit --ecc -v <audio.wav>` <br />
 
+  IQ data:<br />
+  If the IQ data is downsampled and centered (IF band), use <br />
+  `./rs41mod --iq2 <iq_data.wav>` <br />
+  or with lowpass filter <br />
+  `./rs41mod --iq2 --lp <iq_data.wav>` <br />
+  For baseband IQ data, use
+  `./rs41mod --IQ <fq> <iq_data.wav>` <br />
+  where `<fq>` is the relative frequency in `-0.5 .. 0.5`;
+  e.g. if the receiver is tuned to 403MHz and the (complex) sample rate is 2MHz,
+  a signal at 402.5MHz would be -0.5MHz off, i.e. `<fq> = -0.5/2 = -0.25`. <br />
+  For IQ data (i.e. 2 channels) it is possible to read raw data (without wav header): <br />
+  `./rs41mod --IQ <fq> - <sr> <bs> <iq_data.raw>` <br />
+  &nbsp;&nbsp;&nbsp;&nbsp; `<sr>`: sample rate <br />
+  &nbsp;&nbsp;&nbsp;&nbsp; `<bs>=8,16,32`: bits per (real) sample (u8, s16 or f32)
 
diff --git a/demod/mod/rs41mod.c b/demod/mod/rs41mod.c
index 02e5bff..521a421 100644
--- a/demod/mod/rs41mod.c
+++ b/demod/mod/rs41mod.c
@@ -2,7 +2,7 @@
 /*
  *  rs41
  *  sync header: correlation/matched filter
- *  files: rs41mod.c bch_ecc_mod.c demod_mod.c demod_mod.h
+ *  files: rs41mod.c bch_ecc_mod.c bch_ecc_mod.h demod_mod.c demod_mod.h
  *  compile, either (a) or (b):
  *  (a)
  *      gcc -c demod_mod.c
diff --git a/demod/mod/rs92mod.c b/demod/mod/rs92mod.c
index a6ec8ff..ac93e62 100644
--- a/demod/mod/rs92mod.c
+++ b/demod/mod/rs92mod.c
@@ -2,7 +2,7 @@
 /*
  *  rs92
  *  sync header: correlation/matched filter
- *  files: rs92mod.c nav_gps_vel.c bch_ecc_mod.c demod_mod.c demod_mod.h
+ *  files: rs92mod.c nav_gps_vel.c bch_ecc_mod.c bch_ecc_mod.h demod_mod.c demod_mod.h
  *  compile:
  *  (a)
  *      gcc -c demod_mod.c
diff --git a/demod/multi/README.md b/demod/multi/README.md
new file mode 100644
index 0000000..682009a
--- /dev/null
+++ b/demod/multi/README.md
@@ -0,0 +1,26 @@
+
+## Radiosonde decoders
+
+simultaneous decoding
+
+
+#### Compile
+  `gcc -Ofast -c demod_base.c` <br />
+  `gcc -O2 -c bch_ecc_mod.c` <br />
+  `gcc -O2 -c rs41base.c` <br />
+  `gcc -O2 -c dfm09base.c` <br />
+  `gcc -O2 -c m10base.c` <br />
+  `gcc -O2 -c lms6Xbase.c` <br />
+  `gcc -O2 rs_multi.c demod_base.o bch_ecc_mod.o rs41base.o dfm09base.o m10base.o lms6Xbase.o -lm -pthread -o rs_multi`
+
+#### Usage/Examples
+  `./rs_multi --rs41 <fq0> --dfm <fq1> --m10 <fq2> --lms <fq3> <iq_baseband.wav>` <br />
+  `./rs_multi --rs41 <fq0> --dfm <fq1> --m10 <fq2> --lms <fq3> - <sr> <bs> <iq_baseband.raw>` <br />
+  where <br />
+  &nbsp;&nbsp;&nbsp;&nbsp; `-0.5 < fq < 0.5`: (relative) frequency, `fq=freq/sr` <br />
+  &nbsp;&nbsp;&nbsp;&nbsp; `<sr>`: sample rate <br />
+  &nbsp;&nbsp;&nbsp;&nbsp; `<bs>=8,16,32`: bits per (real) sample (u8, s16 or f32) <br />
+  decodes up to `MAX_FQ=5 (demod_base.h)` signals. Decoding more signals than number of CPUs/cores is not recommended. <br />
+  c.f.
+  https://youtu.be/5YXP9LYUgLs
+