Rero is a transmission protocol suitable for efficient, reliable, and robust communication especially well suited for DMA supported MCU operations.
Project description
Rero is an efficient communication protocol intended for transmissions of byte frames over e.g. a serial interface or buses. It builds upon COBS which allows for a minimum encoding overhead. It is perfectly suited for MCUs with DMA support.
Did somebody asked what is it good for? Here are some qualities of Rero:
Quality | How | Good for |
---|---|---|
Reliable | CRC check | Checking integrity of frame |
Robust | COBS and COBSR byte stuffing | Easy to resynchronize byte stream |
Efficient | Exploit properties of COBS and COBSR | Minimum processing overhead |
Scalable | Customize Rero to your needs | Minimize frame overhead |
Bus-capable | Optional address field | Address frame for specific recipient |
Quick start
Rero requires Python 3.5 or newer to run.
$ pip install rero
Usage
import rero
reroPacker = rero.Packer(1) # own address = 1
# Dummy payload
payload = bytes([1, 2, 3, 4])
msgToSend = reroPacker.pack(payload, 20) # Packing with dedicated address = 20
# msgToSend may now be sent e.g. by use of pySerial...
# Unpack received frame
for payloadRcd in reroPacker.unpack(msgToSend):
print(payloadRcd)
Further examples are given in the docs.
Documentation
You can find the documentation at here.
Contribution
For information on how to contribute to the project, please check the Contributor's Guide.
License
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.