2019-04-22 12:01:37 +00:00
|
|
|
# Custom structured data format definitions
|
|
|
|
|
|
2020-02-27 18:50:08 +00:00
|
|
|
<!-- prettier-ignore-start -->
|
2020-02-08 09:52:42 +00:00
|
|
|
[comment]: # (
|
|
|
|
|
SPDX-License-Identifier: GPL-3.0-or-later
|
|
|
|
|
)
|
|
|
|
|
|
|
|
|
|
[comment]: # (
|
|
|
|
|
SPDX-FileCopyrightText: 2011-2020 Carles Fernandez-Prades <carles.fernandez@cttc.es>
|
|
|
|
|
)
|
2020-02-27 18:50:08 +00:00
|
|
|
<!-- prettier-ignore-end -->
|
2020-02-08 09:52:42 +00:00
|
|
|
|
2019-04-22 12:01:37 +00:00
|
|
|
Files in this folder describe structured data formats that are generated by
|
2024-03-29 13:39:32 +00:00
|
|
|
GNSS-SDR. They use [Protocol Buffers](https://protobuf.dev/)'
|
|
|
|
|
[proto3](https://protobuf.dev/programming-guides/proto3/) syntax.
|
2019-04-22 12:01:37 +00:00
|
|
|
|
|
|
|
|
From those files, the protocol buffer compiler creates classes that implement
|
|
|
|
|
automatic encoding and parsing of the protocol buffer data with an efficient
|
|
|
|
|
binary format. The generated classes provide getters and setters for the fields
|
|
|
|
|
that make up a protocol buffer and take care of the details of reading and
|
|
|
|
|
writing it as a unit. Importantly, the protocol buffer format supports the idea
|
|
|
|
|
of extending the format over time in such a way that the code can still read
|
|
|
|
|
data encoded with the old format.
|
|
|
|
|
|
|
|
|
|
Just grab these files if you are developing a client application for GNSS-SDR.
|
|
|
|
|
You are free to use C++, Java, Python, C#, Dart, Go or Ruby, among other
|
|
|
|
|
languages. A tutorial to create a simple application using Protocol Buffers and
|
|
|
|
|
a `.proto` file in C++ is available at
|
|
|
|
|
https://gnss-sdr.org/docs/tutorials/monitoring-software-receiver-internal-status/
|
