M17_Project
/
gr-m17
mirror of https://github.com/M17-Project/gr-m17.git
1
0
Fork 0
Code Issues Releases Wiki Activity
gr-m17/examples
History
Jean-Michel Friedt 203850491b add scrambler key field in encoder block 2024-12-24 08:40:12 +01:00
..
2024-06-07-132848_2704x1050_scrot.png hardware demonstration 2024-06-07 13:36:30 +02:00
README.md update examples to make them functional demonstrations of gr-m17 features with default settings 2024-06-09 12:52:08 +02:00
audiocoder.grc audio coder benchmark to assess M17 proper operation 2024-06-08 12:42:05 +02:00
m17_loopback.grc add scrambler key field in encoder block 2024-12-24 08:40:12 +01:00
m17_loopback.png getting ready for AES and ECC, not yet implemented 2024-06-20 18:01:32 +02:00
m17_loopback_noisy.grc tested noisy loopback demo 2024-06-07 11:50:15 +02:00
m17_loopback_noisy.png check examples + PNG outputs 2024-01-27 08:33:42 +01:00
m17_loopback_noisychannel.grc check examples + PNG outputs 2024-01-27 08:33:42 +01:00
m17_loopback_noisychannel.png check examples + PNG outputs 2024-01-27 08:33:42 +01:00
m17_rx.grc update GRC examples with new interfaces 2024-12-22 20:03:18 +01:00
m17_rx.png TX block 2024-06-07 11:31:05 +02:00
m17_tx.grc update GRC examples with new interfaces 2024-12-22 20:03:18 +01:00
m17_tx.png TX block 2024-06-07 11:31:05 +02:00
receiverRTLSDR.grc rx freq as a variable 2024-09-24 13:36:53 +02:00
receiverRTLSDR.png hardware demonstration 2024-06-07 13:36:30 +02:00
transmitterPLUTOSDR.grc updated option tree in GRC 2024-06-08 12:54:12 +02:00
transmitterPLUTOSDR.png hardware demonstration 2024-06-07 13:36:30 +02:00

README.md

gr-m17 examples

For a first test, jump to m17_loopback.grc which does not use external tools but is GNU Radio only. The two m17_rx.grc and m17_tx.grc are for debugging and validation purposes of the conversion from libm17 to GNU Radio block.

m17_rx.grc

This receiver testing example relies on ../M17_Implementations/SP5WWP/m17-coder/m17-coder-sym to broadcast a signal. Following this unit testing example, run this flowchart along with

mkfifo /tmp/fifo1
mkfifo /tmp/fifo2
python3 ../M17_Implementations/SP5WWP/grc/m17_streamer.py
../M17_Implementations/SP5WWP/m17-coder/m17-coder-sym < /tmp/fifo1 > /tmp/fifo2 &

and the output of python3 ./m17_rx.py should be

...
DST: ALL       SRC: AB1CDE    TYPE: 0005 META: 0000000000000000000000000000 LSF_CRC_OK 
DST: ALL       SRC: AB1CDE    TYPE: 0005 META: 0000000000000000000000000000 LSF_CRC_OK 
DST: ALL       SRC: AB1CDE    TYPE: 0005 META: 0000000000000000000000000000 LSF_CRC_OK 
DST: ALL       SRC: AB1CDE    TYPE: 0005 META: 0000000000000000000000000000 LSF_CRC_OK 
DST: ALL       SRC: AB1CDE    TYPE: 0005 META: 0000000000000000000000000000 LSF_CRC_OK 
...

It would be wise to execute from a terminal rather than the GNU Radio Companion graphical interface to avoid flooding the console.

m17_tx.grc

This transmitter testing example relies on ../M17_Implementations/SP5WWP/m17-decoder/m17-decoder-sym to decode a signal. Following this unit testing example, run this flowchart along with

mkfifo /tmp/fifo1
mkfifo /tmp/fifo2
../M17_Implementations/SP5WWP/m17-decoder/m17-decoder-sym < /tmp/fifo2

and the output of python3 ./m17_tx.py should be

DST: AB2CDE    SRC: AB1CDE    TYPE: 0005 META: 48656C6C6F210000000000000000 LSF_CRC_OK 
FN: 0018 PLD: 01020304050600000000000000000000 e=0.0
FN: 0019 PLD: 01020304050600000000000000000000 e=0.0
FN: 001A PLD: 01020304050600000000000000000000 e=0.0
FN: 001B PLD: 01020304050600000000000000000000 e=0.0
FN: 001C PLD: 01020304050600000000000000000000 e=0.0
FN: 001D PLD: 01020304050600000000000000000000 e=0.0
DST: AB2CDE    SRC: AB1CDE    TYPE: 0005 META: 48656C6C6F210000000000000000 LSF_CRC_OK 
FN: 001E PLD: 01020304050600000000000000000000 e=0.0

m17_loopback.grc

Loopback demo with TX and RX both in GNU Radio.

The output should be

DST: AB2CDE    SRC: AB1CDE    TYPE: 0005 META: 48656C6C6F210000000000000000 LSF_CRC_OK 
DST: AB2CDE    SRC: AB1CDE    TYPE: 0005 META: 48656C6C6F210000000000000000 LSF_CRC_OK 
DST: AB2CDE    SRC: AB1CDE    TYPE: 0005 META: 48656C6C6F210000000000000000 LSF_CRC_OK 
DST: AB2CDE    SRC: AB1CDE    TYPE: 0005 META: 48656C6C6F210000000000000000 LSF_CRC_OK 
DST: AB2CDE    SRC: AB1CDE    TYPE: 0005 META: 48656C6C6F210000000000000000 LSF_CRC_OK 
DST: AB2CDE    SRC: AB1CDE    TYPE: 0005 META: 48656C6C6F210000000000000000 LSF_CRC_OK

m17_loopback_noisy.grc

Loopback demo with the addition of noise, no modulation/no channnel.

m17_loopback_noisychannel.grc

Loopback demo with a noisy channel, including full modulation & demodulation.

transmitterPLUTOSDR.grc

M17 transmitter with ADALM Pluto SDR or Ettus Research B210.

receiverRTLSDR.grc

M17 receiver with RTL-SDR. Automatic Frequency Correction can be enabled as an option.

Complete demonstration

Resulting demonstration of wireless communication between a B210 emitting the signal and RTL-SDR dongle as receiver.