Skip to main content

M17 radio (and radio-over-IP) protocol implementation. https://github.com/M17-project/

Project description

Python package for M17 radio and radio-over-IP protocols

M17 is a new, experimental radio protocol similar to DMR/MotoTRBO, P25, D-STAR, and others. It uses the Codec2 vocoder by David Rowe.

Build Status

This package has full python support for handling M17 addresses, framing and parsing, and including a full Python native VoIP client.

Features

Base

  • python -m m17.address <callsign> - print the encoded M17 base40 representation of the callsigns given
  • see frames.py and framer.py in the source for M17 frame classes and example usage.

[Codec2]

  • python -m m17.audio_test 3200 where 3200 can also be 1600, 1200, or other supported Codec2 bitrate. Takes your microphone, encodes and decodes it into Codec2, and plays it back. Useful for getting your microphone input tuned properly for Codec2.

Installation

Pip

You can install with pip install m17, and get a basic feature set including framing and M17 address translation.

However, to get all features that use Codec2, including the full M17 VoIP node and audio_test, you must first have Codec2 installed on your system, including the Codec2 development headers, and Cython. Once that's complete, you can then pip install m17[Codec2] to install all features.

Note that installing Cython separately before pycodec2 seems to be required in order to make sure it's available for pycodec2's setup process.

Here's an example for Arch Linux.

pacman -Syu base-devel codec2 python python-pip python-setuptools
pip install --upgrade pip numpy Cython wheel setuptools
pip install m17[Codec2]

Naturally you need the typical compilation tools, which on Arch are base-devel.

On systems that separate development headers, you need those too for Codec2, i.e. both codec2 and codec2-dev, or whatever the appropriate names are for your distro.

On many Ubuntu and Debian systems, the codec2 packages in the distro repositories is too out of date for use with pycodec2, so you may need to follow the upstream Codec2 instructions and the upstream pycodec2 instructions to get a fully working installation of both.

You may email me with clearly described problems regarding installation and I will do my best to help.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

m17-0.0.3.tar.gz (14.2 kB view details)

Uploaded Source

File details

Details for the file m17-0.0.3.tar.gz.

File metadata

  • Download URL: m17-0.0.3.tar.gz
  • Upload date:
  • Size: 14.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.23.0 setuptools/46.2.0 requests-toolbelt/0.9.1 tqdm/4.46.0 CPython/3.8.2

File hashes

Hashes for m17-0.0.3.tar.gz
Algorithm Hash digest
SHA256 ab4b5c7257aa20ac0876a8e7343f205c897b0bcb6a52efd6df000ae7073c0576
MD5 7c1aa2e4352ae9ab8edf5e10a865bdef
BLAKE2b-256 cfa964307abb7bb087fbcf894c4e5bfe92360371d3a6f370787ab098d20cd8c2

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page