M17_Project
/
gr-m17
mirror of https://github.com/M17-Project/gr-m17.git
1
0
Fork 0
Code Issues Releases Wiki Activity
GNU Radio M17 protocol implementation
10 Commits
2 Branches
0 Tags
3.2 MiB
Python 55.8%
CMake 41.5%
C 1.7%
Shell 0.8%
C++ 0.2%
 
 
 
 
 
Go to file
Jean-Michel Friedt cf99c8674c add debug flag to decoder and coder function of GNU Radio 3.10 2023-02-21 19:03:23 +01:00
M17_Implementations@cad279a3eb update submodule version 2023-02-21 07:23:14 +01:00
apps initial commit GNU Radio 3.10 2023-02-20 18:27:58 +01:00
cmake initial commit GNU Radio 3.10 2023-02-20 18:27:58 +01:00
docs match new file layout 2023-02-20 20:14:34 +01:00
examples META as GNU Radio variable 2023-02-21 07:28:21 +01:00
grc add debug flag to decoder and coder function of GNU Radio 3.10 2023-02-21 19:03:23 +01:00
include/gnuradio/m17 add debug flag to decoder and coder function of GNU Radio 3.10 2023-02-21 19:03:23 +01:00
lib add debug flag to decoder and coder function of GNU Radio 3.10 2023-02-21 19:03:23 +01:00
python/m17 match new file layout 2023-02-20 20:14:34 +01:00
.gitmodules Initial commit of submodule 2023-02-20 17:32:52 +01:00
CMakeLists.txt initial commit GNU Radio 3.10 2023-02-20 18:27:58 +01:00
LICENSE
…
MANIFEST.md initial commit GNU Radio 3.10 2023-02-20 18:27:58 +01:00
README.md final README after testing 2023-02-21 07:57:22 +01:00

README.md

Compiling for GNU Radio

The default targetted version is GNU Radio 3.10 (main branch). For GNU Radio 3.8, insert git checkout 3.8 after the git clone ... command and check the 3.8 branch version of the README.md for LD_LIBRARY_PATH and PYTHONPATH tested on Debian/stable.

git clone --recursive https://github.com/M17-Project/gr-m17
cd gr-m17
mkdir build
cd build
cmake ../
make -j12
sudo make install

will finish with a statement such as

-- Set runtime path of "/usr/local/lib/python3.11/dist-packages/gnuradio/m17/m17_python.cpython-311-x86_64-linux-gnu.so" to ""

meaning that variables must be set (tested with Debian/sid) to help GNU Radio Companion find the Python libraries:

export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/local/lib/x86_64-linux-gnu/
export PYTHONPATH=/usr/local/lib/python3.11/dist-packages/

where the LD_LIBRARY_PATH setting results from

find /usr/local/ -name libgnuradio-m17.so.1.0.0 -print

When running the flowgraph found in examples with gnuradio-companion ../examples/m17_streamer.grc

the output should be

Generating: '.../M17_Implementations/SP5WWP/gr-m17/examples/m17_streamer.py'

Executing: /usr/bin/python3 -u .../M17_Implementations/SP5WWP/gr-m17/examples/m17_streamer.py

new meta: helloworld
new SRC ID: 1 2 3 4 5 6
new DST ID: 255 255 255 255 255 255
New sampling rate: 8800.000000
new type: 0 0
got_lsf=1
LSF
DST: #BCAST    SRC: FPR-4U3F  TYPE: 0000 META: 68656C6C6F776F726C6400000000 LSF_CRC_OK 
FN: 0000 PLD: 00000000000000000000000000000000
FN: 0001 PLD: 00000000000000000000000000000000
FN: 0002 PLD: 00000000000000000000000000000000
FN: 0003 PLD: 00000000000000000000000000000000
FN: 0004 PLD: 00000000000000000000000000000000
DST: #BCAST    SRC: FPR-4U3F  TYPE: 0000 META: 68656C6C6F776F726C6400000000 LSF_CRC_OK 
FN: 0005 PLD: 00000000000000000000000000000000
FN: 0006 PLD: 00000000000000000000000000000000
FN: 0007 PLD: 00000000000000000000000000000000
FN: 0008 PLD: 00000000000000000000000000000000
FN: 0009 PLD: 00000000000000000000000000000000
FN: 000A PLD: 00000000000000000000000000000000
DST: #BCAST    SRC: FPR-4U3F  TYPE: 0000 META: 68656C6C6F776F726C6400000000 LSF_CRC_OK 
FN: 000B PLD: 00000000000000000000000000000000
FN: 000C PLD: 00000000000000000000000000000000
FN: 000D PLD: 00000000000000000000000000000000
FN: 000E PLD: 00000000000000000000000000000000
FN: 000F PLD: 00000000000000000000000000000000

but will end up desynchronizing at some point if not straight from the beginning.

Warning: the default gr_modtool informs GNU Radio Companion to import m17 rather than from gnuradio import m17. This has to be changed in the YML files manually as the template is erroneous.

Developer note

In case of error related to Python bindings for m17_coder.h are out of sync after changing header files in include/gnuradio/m17, make sure that

md5sum include/gnuradio/m17/m17_decoder.h

match the information in python/m17/bindings/*cc.

TODO:

  • Check non-16 multiple buffer size -- cause of desynchronization? At least avoid crash !
  • How to handle fixed symbol rate but varying output rate?
  • How to modulate the RF transmitted with the real output?