https://github.com/d3f0/maranet

https://github.com/d3f0/maranet

Last synced: 1 day ago
JSON representation

• Host: GitHub
• URL: https://github.com/d3f0/maranet
• Owner: D3f0
• License: mit
• Created: 2017-07-10T22:26:11.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2023-02-08T00:40:59.000Z (almost 2 years ago)
• Last Synced: 2024-04-24T22:01:58.613Z (8 months ago)
• Language: Python
• Homepage:
• Size: 309 KB
• Stars: 0
• Watchers: 2
• Forks: 0
• Open Issues: 3
• Metadata Files:
  • Readme: README.rst
  • Changelog: HISTORY.rst
  • Contributing: CONTRIBUTING.rst
  • License: LICENSE

Awesome Lists containing this project

README

        
=======

MaraNet

=======

.. image:: https://img.shields.io/pypi/v/maranet.svg

        :target: https://pypi.python.org/pypi/maranet

.. image:: https://img.shields.io/travis/D3f0/maranet.svg

        :target: https://travis-ci.org/D3f0/maranet

.. image:: https://readthedocs.org/projects/maranet/badge/?version=latest

        :target: https://maranet.readthedocs.io/en/latest/?badge=latest

        :alt: Documentation Status

.. image:: https://pyup.io/repos/github/D3f0/maranet/shield.svg

     :target: https://pyup.io/repos/github/D3f0/maranet/

     :alt: Updates

A Python client library for MARA protocol. Includes server emulator, although MARA servers are tipically microcontrollers.

* Free software: MIT license

* Documentation: https://maranet.readthedocs.io.

Mara Network Protocol

=====================

Mara is a protocol designed for interaction with a network of embedded devices.

These devices collect state and events from a process (implementations include

traffic light systems and power station monitoring).

Mara 1.0 is source code is implemented on top of Microchip PIC devices and code

can be requested at ricadoalopez at gmail.

Mara 1.6, designed with 16 bit in mind, is implemented on top of Arduino libraries and

should be available soon.

Mara 1.0

--------

Mara packages structure::

    ┌─────┬─────┬─────┬─────┬─────┬─────┬─────┐┌─────┐┌─────┬─────┐

    │ SOF │ SEQ │ QTY │ SRC │ DST │ CMD │ PLD ││ ... ││ BCL │ BCH │

    │     │     │     │     │     │     │     ││     ││     │     │

    └─────┴─────┴─────┴─────┴─────┴─────┴─────┘└─────┘└─────┴─────┘

    ┌─────┬───────────┬───────────┬─────┬───────────┬───────────┐

    │ QSV │ SV0       │ SV1       │ QDI │ DI0       │ DI1       │

    │     │           │           │     │           │           │

    └─────┴───────────┴───────────┴─────┴───────────┴───────────┘

    ┌─────┬───────────┬───────────┬─────┬─────────────────────────┐

    │ QAI │ AI0       │ AI1       │ QEV │ EV..                    .

    │     │           │           │     │                         │

    └─────┴───────────┴───────────┴─────┴─────────────────────────┘

Where:

    * **SOF** Start of frame

    * **SEQ** Sequence number

    * **QTY** Frame length or byte *quantity*

    * **SRC** Source address

    * **DST** Destination address

    * **CMD** Command

    * **PLD** Payload

        - Payload consists of arrays of values