This repository provides the Javino protocol for Arduino boards. Javino is a serial message's error check protocol for exchanging messages between high-end and low-end IoT devices over serial communication.
When a high-level software needs to act in the environment, it is necessary to transmit its command to the microcontroller where the actuators are connected, providing a bridge between the software's external actions and the microcontroller’s functions. In the same way, when the high-level software needs to sense the environment, the data perceived by sensors has to be sent.
There are some libraries that use the serial port to deal with one-sided messages. However, these libraries just provide message treatment for one platform side (the environment), leaving the other side to the programmer. The Javino aims to fill this gap because it offers a double-sided communication that provides a higher level of correctness in message exchange.
For this reason, every message is composed of a preamble, a field size and the message content. The preamble is a field composed of four hexadecimal characters that are used to identify the beginning of a message sent by an agent. The field size is composed of two hexadecimal characters that are used to calculate the message extension. Finally, the last field is the message content, up to 255 bytes. The preamble and the field size are used together to avoid errors in the event of a loss of information during the message transmission. For the sake of practice, Javino automatically mounts the message.
When a message is sent, the Javino library starts to listen on the serial port for arriving char-to-char messages. If there is any information arriving, the Javino stores this character, analyzing if it is part of the expected preamble. So, this process is repeated until the message has been completely received. Once the preamble is not confirmed, the Javino discards all information received until it finds a valid preamble. Otherwise, the Javino verifies the field size value to identify the message length. This process avoids error insertions and defines where a message starts and ends.
Javino is licensed under a Creative Commons Attribution 4.0 International License. The licensor cannot revoke these freedoms as long as you follow the license terms:
- Attribution — You must give appropriate credit like below:
N. M. Lazarin e C. E. Pantoja, “A robotic-agent platform for embedding software agents using raspberry pi and arduino boards”, in Proceedings of 9th Software Agents, Environments and Applications School (WESAAC 2015), Niteroi: UFF, 2015, p. 13–20. Available at: http://www2.ic.uff.br/~wesaac2015/Proceedings-WESAAC-2015.pdf
@inproceedings{javino,
address = {Niteroi - RJ},
title = {A robotic-agent platform for embedding software agents using raspberry pi and arduino boards},
url = {http://www2.ic.uff.br/~wesaac2015/Proceedings-WESAAC-2015.pdf},
booktitle = {Proceedings of 9th Software Agents, Environments and Applications School (WESAAC 2015)},
publisher = {UFF},
author = {Lazarin, Nilson Mori and Pantoja, Carlos Eduardo},
year = {2015},
pages = {13--20},
note = {ISSN: 2177-2096},
}