This is merely a historical archive of years 2008-2021, before the migration to mailman3.
A maintained and still updated list archive can be found at https://lists.osmocom.org/hyperkitty/list/gerrit-log@lists.osmocom.org/.
Harald Welte gerrit-no-reply at lists.osmocom.orgHarald Welte has submitted this change and it was merged. Change subject: reformat README file as markdown ...................................................................... reformat README file as markdown Change-Id: I7b2602fa1614cafcfb6e6c4fad0d15ba183b0d1d --- R README.md 1 file changed, 31 insertions(+), 21 deletions(-) Approvals: Harald Welte: Looks good to me, approved; Verified diff --git a/README b/README.md similarity index 68% rename from README rename to README.md index 30188a2..1b4b1ec 100644 --- a/README +++ b/README.md @@ -1,6 +1,7 @@ TETRA MAC/PHY layer experimentation code +======================================== + (C) 2010-2016 by Harald Welte <laforge at gnumonks.org> and contributors -====================================================================== This code aims to implement the sending and receiving part of the TETRA MAC/PHY layer. @@ -15,17 +16,21 @@ You will need libosmocore (http://bb.osmocom.org/trac/wiki/libosmocore) to link. -== Demodulator == +Demodulator +=========== src/demod/python/cpsk.py - * contains a gnuradio based pi4/DQPSK demodulator, courtesy of KA1RBI + * contains a gnuradio based pi4/DQPSK demodulator, courtesy of KA1RBI + src/demod/python/osmosdr-tetra_demod_fft.py - * call demodulator on any source supported by gr-osmosdr - (uhd, fcd, hackrf, blaerf, etc.) + * call demodulator on any source supported by gr-osmosdr + (uhd, fcd, hackrf, blaerf, etc.) + src/demod/python/simdemod2.py - * call demodulator on a 'cfile' containing complex baseband samples + * call demodulator on a 'cfile' containing complex baseband samples + src/demod/python/{uhd,fcdp}-tetra_demod.py - * use demodulator directly with UHd or FCDP hadware (no gr-osmosdr) + * use demodulator directly with UHd or FCDP hadware (no gr-osmosdr) The output of the demodulator is a file containing one float value for each symbol, containing the phase shift (in units of pi/4) relative to the previous symbol. @@ -34,37 +39,41 @@ bits, i.e. 1-bit-per-byte -== PHY/MAC layer == +PHY/MAC layer +============= -=== library code === +library code +------------ Specifically, it implements: lower_mac/crc_simple.[ch] - * CRC16-CCITT (currently defunct/broken as we need it for - non-octet-aligned bitfields) +* CRC16-CCITT (currently defunct/broken as we need it for + non-octet-aligned bitfields) lower_mac/tetra_conv_enc.[ch] - * 16-state Rate-Compatible Punctured Convolutional (RCPC) coder +* 16-state Rate-Compatible Punctured Convolutional (RCPC) coder lower_mac/tetra_interleave.[ch] - * Block interleaving (over a single block only) +* Block interleaving (over a single block only) lower_mac/tetra_rm3014.[ch] - * (30, 14) Reed-Muller code for the ACCH (broadcast block of - each downlink burst) +* (30, 14) Reed-Muller code for the ACCH (broadcast block of + each downlink burst) lower_mac/tetra_scramb.[ch] - * Scrambling +* Scrambling lower_mac/viterbi*.[ch] - * Convolutional decoder for signalling and voice channels +* Convolutional decoder for signalling and voice channels phy/tetra_burst.[ch] - * Routines to encode continuous normal and sync bursts +* Routines to encode continuous normal and sync bursts phy/tetra_burst_sync.[ch] -=== Receiver Program === +Receiver Program +---------------- The main receiver program 'tetra-rx' expects an input file containing a stream of unpacked bits, i.e. 1-bit-per-byte. -=== Transmitter Program === +Transmitter Program +------------------- The main program conv_enc_test.c generates a single continuous downlinc sync burst (SB), contining: @@ -77,7 +86,8 @@ It does not actually modulate and/or transmit yet. -== Quick example == +Quick example +============= # assuming you have generated a file samples.cfile at a sample rate of # 195.312kHz (100MHz/512 == USRP2 at decimation 512) -- To view, visit https://gerrit.osmocom.org/2106 To unsubscribe, visit https://gerrit.osmocom.org/settings Gerrit-MessageType: merged Gerrit-Change-Id: I7b2602fa1614cafcfb6e6c4fad0d15ba183b0d1d Gerrit-PatchSet: 1 Gerrit-Project: osmo-tetra Gerrit-Branch: master Gerrit-Owner: Harald Welte <laforge at gnumonks.org> Gerrit-Reviewer: Harald Welte <laforge at gnumonks.org>