Home
====

.. image:: images/protobuf.jpeg
   :width: 400
   :height: 300
   :alt: Texte alternatif de l'image

.. toctree::
   :maxdepth: 2
   :caption: Contents:

   self
   ./how_to_use.rst
   ./message_logging.rst
   ./api_description.rst


Description
============

Protobuf is used as the primary serialization format for hardware transmission and exchanges between the different components
of the platform. Messages struct are defined in .proto files and generated with protoc.

.. tip::
   Protobuf is easier to handle than MAVLINK for example, the code to send and receive is way more compact and generic,
   the messages structuration is more flexible thanks to protoc code generation which explains why we use it as the primary
   serialization format.

.. warning::
   For easy manipulation, users are recommended to use libDM_msg_center library which provides easy handling of protobuf messages + can, mavlink...
   `libDM_msg_center <../libdm_msg_center/index.html>`_.