dmr_utils/README.rst

51 lines
2.1 KiB
ReStructuredText

dmr_utils
_________
Utilities for working with Digital Moble Radio (DMR) in python. Includes routines for assembling and disasembling packets and encoding/removing FEC/ECC routines. The utilities are intended primarily for processing on the "network" side of DMR, not the air interface -- such as for building network linking tools, and as such, routines mostly remove FEC/ECC rather than appy repeairs, which should be done at the air interface first.
**Files in this repository and what they do**
const.py
some stuff
utils.py
some stuff
encode.py
some stuff
decode.py
some stuff
btpc.py
Contains block product turbo code generators, extractors and related routines
- *decode_full_lc(_data)* -- Extracts the useful FULL LC data without checking for errors. Accepts one argument of type bitarray and returns one item of type bitarray.
- *interleave_19696(_data)* -- Accepts one argument of type bitarray and returns a bitarray interlieaved.
- *encode_19696(_data)* -- Accepts an LC as a 12-byte string (LC and RS1293 FEC) encodes it into a 196bit bitarray and builds the proper row and column structure with hamming codes and returns a type bitarray
- *encode_header_lc(_lc) -- Accpets LC data as a bitarray, applies the header mask and appends RS1293 FEC, encodes BPTC19696, interleaves for transmition. Returns a type bitarray that is the full DMR LC header packet.
- *encode_terminator_ls(_lc) -- Accepts LC data as a bitarray, applies the terminator mask and appends RS1293 FEC, encodes BPTC19696, interleaves for transmition. Returns a type bitarray that is the full DMR LC terminator packet.
- *decode_emblc(_elc) -- Extracts the useful EMBEDDED LC data without checking for errors. Accepts a type bitarray and returns type string.
- *encode_emblc(_lc) -- Accepts 12 byte LC as a string, adds 5-byte checksum, adds row hamming bits, column partiy bits and arranges the matrix for transmission. Returns a type dict with 4 key/value pairs. Keys 1-4 are DMR bursts b-e respectively, such that burst "B" is key 1's associated value and so on.
crc.py
some stuff
rs129.py
some stuff
golay.py
some stuff
hamming.py
some stuff
qr.py
some stuff