magogi/prod/: mgf-tele-teltonika-0.1.6 metadata and description

Simple index Newer version available

Teltonika Codec 8 / 8 Extended decoder + TelematicsProvider implementation — the first vendor package in the mgf-tele-* family, built on mgf-tele-core. Sibling of mgf-common under the mgf.* namespace.

author Bassam Alsanie, mgf-tele-teltonika contributors
classifiers
  • Development Status :: 3 - Alpha
  • Intended Audience :: Developers
  • License :: OSI Approved :: MIT License
  • Programming Language :: Python :: 3
  • Programming Language :: Python :: 3.11
  • Programming Language :: Python :: 3.12
  • Programming Language :: Python :: 3.13
  • Topic :: Software Development :: Libraries
  • Typing :: Typed
description_content_type text/markdown
keywords avl, codec8, fmb, gps, telematics, teltonika
license MIT
license_file
  • LICENSE
metadata_version 2.4
requires_dist
  • mgf-common<0.47,>=0.41
  • mgf-tele-core<0.2,>=0.1
  • hypothesis>=6.0; extra == 'dev'
  • import-linter>=2.0; extra == 'dev'
  • mgf-test-supervisor<0.2,>=0.1.2; extra == 'dev'
  • mypy>=1.10; extra == 'dev'
  • pytest-asyncio>=0.23; extra == 'dev'
  • pytest-cov>=5.0; extra == 'dev'
  • pytest-timeout>=2.3; extra == 'dev'
  • pytest>=8.0; extra == 'dev'
  • ruff>=0.4; extra == 'dev'
  • mgf-common[standards]<0.47,>=0.46; extra == 'standards'
requires_python >=3.11

Because this project isn't in the mirror_whitelist, no releases from root/pypi are included.

File Tox results History
mgf_tele_teltonika-0.1.6-py3-none-any.whl
Size
18 KB
Type
Python Wheel
Python
3

mgf-tele-teltonika

Teltonika Codec 8 / 8 Extended decoder + a TelematicsProvider implementation for FMB/FMC/FMM devices. The first vendor package in the mgf-tele-* family — it builds on mgf-tele-core (the vendor-neutral seam) and never the other way around.

Extracted from PlasmaMapper's ingest path.

Install

pip install mgf-tele-teltonika

Use

from mgf.tele.teltonika import TeltonikaProvider, decode_avl_packet

# Decoder (pure: bytes -> mgf.tele.core.DecodedAvlRecord[]):
records = decode_avl_packet(wire_bytes)

# Provider (the mgf.tele.core.TelematicsProvider seam) in an ingest loop:
provider = TeltonikaProvider(imei_authoriser=my_registry_lookup)
handle = await provider.open_session(reader, writer)   # IMEI handshake
packet = await provider.receive_packet(handle)         # ReceivedPacket

What's in it

Name What
decode_avl_packet / decode_codec8 / decode_codec8e pure decoders → mgf.tele.core.DecodedAvlRecord; unsupported codecs raise mgf.tele.core.UnsupportedCodecError
TeltonikaProvider / TeltonikaSessionHandle the TelematicsProvider concrete (TCP handshake → receive → ack → close)
mgf.tele.teltonika._crc.crc16_ibm the CRC-16/IBM primitive
mgf.tele.teltonika._packets wire-packet encoders (round-trip testing)

Codec 12 RX (command responses), 13/14/15, and 16 are not yet implemented and raise UnsupportedCodecError.

Design