Merge branch 'gh-pages' of github.com:gnss-sdr/geniuss-place

Gemfile.lock

@@ -36,8 +36,9 @@ GEM
     eventmachine (1.2.7)
     eventmachine (1.2.7-x64-mingw32)
     execjs (2.9.1)
-    faraday (2.11.0)
+    faraday (2.12.0)
       faraday-net_http (>= 2.0, < 3.4)
+      json
       logger
     faraday-net_http (3.3.0)
       net-http
@@ -100,7 +101,7 @@ GEM
       activesupport (>= 2)
       nokogiri (>= 1.4)
     http_parser.rb (0.8.0)
-    i18n (1.14.5)
+    i18n (1.14.6)
       concurrent-ruby (~> 1.0)
     jekyll (3.10.0)
       addressable (~> 2.4)
@@ -212,6 +213,7 @@ GEM
       gemoji (>= 3, < 5)
       html-pipeline (~> 2.2)
       jekyll (>= 3.0, < 5.0)
+    json (2.7.2)
     kramdown (2.4.0)
       rexml
     kramdown-parser-gfm (1.1.0)
@@ -267,7 +269,7 @@ GEM
       tzinfo (>= 1.0.0)
     unicode-display_width (1.8.0)
     uri (0.13.1)
-    webrick (1.8.1)
+    webrick (1.8.2)
 
 PLATFORMS
   ruby

_posts/2017-03-07-configuration-options-building-time.md

@@ -197,8 +197,9 @@ package (`sudo apt-get install gnss-sdr`), the option `ENABLE_OSMOSDR` is set to
 | `-DENABLE_ARMA_NO_DEBUG`     |    `ON` / `OFF`     |    `OFF`    | If set to `ON`, it defines the macro `ARMA_NO_DEBUG`, which disables all run-time checks, such as bounds checking, in the [Armadillo](https://arma.sourceforge.net/) library. This will result in a faster executable. This option is set automatically to `ON` if `ENABLE_PACKAGING` is `ON`.            |
 | `-DENABLE_OWN_GLOG`          |    `ON` / `OFF`     |    `OFF`    | If set to `ON`, it forces to download, build and link a working version of [glog](https://github.com/google/glog) locally, even if it is already installed. If [GFlags](https://github.com/gflags/gflags) is not found, it will also download, build and link it.                                        |
 | `-DENABLE_GLOG_AND_GFLAGS`          |    `ON` / `OFF`     |    `OFF`    | If set to `ON`, it forces to use Glog and GFlas, even if a valid version of Abseil is present in the system. <span style="color: orange">This configuration option is only present in the `next` branch of the upstream repository and it will be present in the next stable release.</span> |
-| `-DENABLE_OWN_ABSEIL`          |    `ON` / `OFF`     |    `OFF`    | If set to `ON`, it forces to download, build and link a working version of [Abseil](https://github.com/abseil/abseil-cpp) locally, even if it is already installed. It supersedes `ENABLE_GLOG_AND_GFLAGS` and `ENABLE_OWN_GLOG`. Requires CMake >= 3.24, <span style="color: orange">This configuration option is only present in the `next` branch of the upstream repository and it will be present in the next stable release.</span> |
+| `-DENABLE_OWN_ABSEIL`          |    `ON` / `OFF`     |    `OFF`    | If set to `ON`, it forces to download, build and link a working version of [Abseil](https://github.com/abseil/abseil-cpp) locally, even if it is already installed. It supersedes `ENABLE_GLOG_AND_GFLAGS` and `ENABLE_OWN_GLOG`. Requires CMake >= 3.24. <span style="color: orange">This configuration option is only present in the `next` branch of the upstream repository and it will be present in the next stable release.</span> |
 | `-DENABLE_LOG`               |    `ON` / `OFF`     |    `ON`     | If set to `OFF`, it disables runtime logging. This can be useful in storage-limited systems. GNSS-SDR will still produce outputs such as RINEX or KML files.                                                                                                 |
+| `-DENABLE_GNUTLS`             |    `ON` / `OFF`     |    `OFF`    | If set to `ON`, it forces linking against GnuTLS instead of OpenSSL. <span style="color: orange">This configuration option is only present in the `next` branch of the upstream repository and it will be present in the next stable release.</span> |
 | `-DENABLE_STRIP`             |    `ON` / `OFF`     |    `OFF`    | If set to `ON`, it activates the generation of stripped binaries (without debugging information), smaller in size and potentially providing better performance than non-stripped counterparts. Only valid when using the `Release` build mode and `ENABLE_PACKAGING` is set to `OFF`, otherwise ignored. |
 | `-DENABLE_CPUFEATURES`       |    `ON` / `OFF`     |    `ON`     | The building makes use of the `cpu_features` library unless this option is set to `OFF`.                                                                                                                                                                                                                 |
 | ----------                   |

_sp-blocks/01-global-parameters.md

@@ -92,6 +92,46 @@ GNSS-SDR.observable_interval_ms=10
 ```
 
 
+## Open Service Navigation Message Authentication (OSNMA)
+
+The Galileo OSNMA service is enabled by default if the configuration file defines `1B` (that is, Galileo E1 OS) channels. 
+
+Users must register and log in on the [European GNSS Service Centre website](https://www.gsc-europa.eu/), and download the OSNMA public key ("GSC Products > OSNMA_PublicKey", the file with `.crt` format) and the OSNMA Merkle Tree root file ("GSC Products > OSNMA_MerkleTree", in `.xml` format), and set the corresponding options in the GNSS-SDR configuration file:
+
+|----------
+| **Parameter**  | **Description**                                   | **Required** |
+| :------------: | :------------------------------------------------ | :----------: |
+| `osnma_enable`  | [`true`, `false`]: Enables or disables the OSNMA service. It defaults to `true`. |   Optional   |
+| `osnma_public_key` | Path to the OSNMA Public Key (`.crt` file). it defaults to `./OSNMA_PublicKey_20240115100000_newPKID_1.crt` |   Optional   |
+| `osnma_merkletree` | Path to the Merkle Tree root (`.xml` file). It defaults to `./OSNMA_MerkleTree_20240115100000_newPKID_1.xml` |   Optional |
+| `osnma_mode` | If set to `strict`, only authenticated satellites are used in the PVT computation. If not set, the receiver will only log OSNMA events and warn the user in case of authentication failures. Please note that the `strict` mode requires the host computer's internal date and time to be synchronized with the Galileo System Time, allowing a tolerance of ±30 seconds, so it is only intended for real-time operation. No other systems than Galileo will be used in the PVT solution. |   Optional |
+| -------------- |
+
+Example in the configuration file:
+
+```ini
+GNSS-SDR.osnma_public_key=./OSNMA_PublicKey_20240115100000_newPKID_1.crt
+GNSS-SDR.osnma_merkletree=./OSNMA_MerkleTree_20240115100000_newPKID_1.xml
+```
+
+The same, but with the strict mode:
+
+```ini
+GNSS-SDR.osnma_public_key=./OSNMA_PublicKey_20240115100000_newPKID_1.crt
+GNSS-SDR.osnma_merkletree=./OSNMA_MerkleTree_20240115100000_newPKID_1.xml
+GNSS-SDR.osnma_mode=strict
+```
+
+Example to turn off the OSNMA reception:
+
+```ini
+GNSS-SDR.osnma_enable=false
+```
+
+**NOTE**: The OSNMA service is only available from the `next` branch of the upstream repository, and it will be present in the next stable release of GNSS-SDR.
+{: .notice--warning}
+
+
 ## Telecommand via TCP/IP
 
 The user can access the receiver interactive interface by connecting a TCP/IP