This is an automated email from the ASF dual-hosted git repository.
github-bot pushed a commit to branch asf-site
in repository https://gitbox.apache.org/repos/asf/nuttx-website.git
The following commit(s) were added to refs/heads/asf-site by this push:
new 55a369114 Publishing web: 51627ec89e2b02358b2ac0c43bd479968bd14064
docs: ddd8d81874d3358af5100e22c69066b6cca748d9
55a369114 is described below
commit 55a369114587c1073e1126ad888ed17bd759397d
Author: simbit18 <[email protected]>
AuthorDate: Thu Aug 7 00:35:41 2025 +0000
Publishing web: 51627ec89e2b02358b2ac0c43bd479968bd14064 docs:
ddd8d81874d3358af5100e22c69066b6cca748d9
---
content/docs/10.0.0/index.html | 2 +-
content/docs/10.0.1/index.html | 2 +-
content/docs/10.1.0/index.html | 2 +-
content/docs/10.2.0/index.html | 2 +-
content/docs/10.3.0/index.html | 2 +-
content/docs/11.0.0/index.html | 2 +-
content/docs/12.0.0/index.html | 2 +-
content/docs/12.0.0/searchindex.js | 2 +-
content/docs/12.1.0/index.html | 2 +-
content/docs/12.1.0/searchindex.js | 2 +-
content/docs/12.10.0/index.html | 2 +-
content/docs/12.10.0/searchindex.js | 2 +-
content/docs/12.2.0/index.html | 2 +-
.../xtensa/esp32/boards/esp32-audio-kit/index.html | 2 +-
.../xtensa/esp32/boards/esp32-devkitc/index.html | 2 +-
content/docs/12.2.0/searchindex.js | 2 +-
content/docs/12.2.1/index.html | 2 +-
content/docs/12.2.1/searchindex.js | 2 +-
content/docs/12.3.0/index.html | 2 +-
content/docs/12.3.0/searchindex.js | 2 +-
content/docs/12.4.0/index.html | 2 +-
content/docs/12.4.0/searchindex.js | 2 +-
content/docs/12.5.0/index.html | 2 +-
content/docs/12.5.0/searchindex.js | 2 +-
content/docs/12.5.1/index.html | 2 +-
content/docs/12.5.1/searchindex.js | 2 +-
content/docs/12.6.0/index.html | 2 +-
content/docs/12.6.0/searchindex.js | 2 +-
content/docs/12.7.0/index.html | 2 +-
content/docs/12.7.0/searchindex.js | 2 +-
content/docs/12.8.0/index.html | 2 +-
content/docs/12.8.0/searchindex.js | 2 +-
content/docs/12.9.0/index.html | 2 +-
content/docs/12.9.0/searchindex.js | 2 +-
.../components/drivers/special/sensors.rst.txt | 1 +
.../drivers/special/sensors/gnss_lowerhalf.rst.txt | 213 +++++++++
.../drivers/special/sensors/sensors_uorb.rst.txt | 6 +
.../latest/components/drivers/special/segger.html | 4 +-
.../latest/components/drivers/special/sensors.html | 1 +
.../drivers/special/sensors/adt7320.html | 1 +
.../drivers/special/sensors/adxl345.html | 1 +
.../drivers/special/sensors/adxl362.html | 1 +
.../drivers/special/sensors/adxl372.html | 1 +
.../components/drivers/special/sensors/aht10.html | 1 +
.../drivers/special/sensors/ak09912.html | 1 +
.../drivers/special/sensors/gnss_lowerhalf.html | 478 +++++++++++++++++++++
.../components/drivers/special/sensors/l86xxx.html | 5 +-
.../drivers/special/sensors/lis2mdl.html | 1 +
.../components/drivers/special/sensors/lsm330.html | 1 +
.../drivers/special/sensors/lsm6dso32.html | 1 +
.../drivers/special/sensors/mcp9600.html | 1 +
.../drivers/special/sensors/mpl115a.html | 1 +
.../drivers/special/sensors/nau7802.html | 1 +
.../drivers/special/sensors/sensors_cluster.html | 1 +
.../drivers/special/sensors/sensors_legacy.html | 1 +
.../drivers/special/sensors/sensors_uorb.html | 7 +
.../components/drivers/special/sensors/sht4x.html | 1 +
content/docs/latest/guides/fully_linked_elf.html | 2 +-
.../docs/latest/guides/partially_linked_elf.html | 2 +-
content/docs/latest/index.html | 2 +-
content/docs/latest/objects.inv | Bin 158709 -> 158821 bytes
content/docs/latest/searchindex.js | 2 +-
content/feed.xml | 4 +-
63 files changed, 766 insertions(+), 44 deletions(-)
diff --git a/content/docs/10.0.0/index.html b/content/docs/10.0.0/index.html
index 1e69a9ac5..d609e2223 100644
--- a/content/docs/10.0.0/index.html
+++ b/content/docs/10.0.0/index.html
@@ -207,7 +207,7 @@ by following these <a class="reference internal"
href="contributing/documentatio
<div class="section" id="nuttx-documentation">
<h1>NuttX Documentation<a class="headerlink" href="#nuttx-documentation"
title="Permalink to this headline">¶</a></h1>
<p>NuttX is a real-time operating system (RTOS) with an emphasis on standards
compliance and small footprint. Scalable from 8-bit to 32-bit microcontroller
environments, the primary governing standards in NuttX are Posix and ANSI
standards. Additional standard APIs from Unix and other common RTOS’s (such as
VxWorks) are adopted for functionality not available under these standards, or
for functionality that is not appropriate for deeply-embedded environments
(such as fork()).</p>
-<p>Last Updated: 06 August 25 at 00:16</p>
+<p>Last Updated: 07 August 25 at 00:16</p>
<div class="toctree-wrapper compound">
<p class="caption"><span class="caption-text">Table of Contents</span></p>
<ul class="current">
diff --git a/content/docs/10.0.1/index.html b/content/docs/10.0.1/index.html
index 2a878338b..edfcce4f1 100644
--- a/content/docs/10.0.1/index.html
+++ b/content/docs/10.0.1/index.html
@@ -245,7 +245,7 @@ by following these <a class="reference internal"
href="contributing/documentatio
<div class="section" id="nuttx-documentation">
<h1>NuttX Documentation<a class="headerlink" href="#nuttx-documentation"
title="Permalink to this headline">¶</a></h1>
<p>NuttX is a real-time operating system (RTOS) with an emphasis on standards
compliance and small footprint. Scalable from 8-bit to 32-bit microcontroller
environments, the primary governing standards in NuttX are Posix and ANSI
standards. Additional standard APIs from Unix and other common RTOS’s (such as
VxWorks) are adopted for functionality not available under these standards, or
for functionality that is not appropriate for deeply-embedded environments
(such as fork()).</p>
-<p>Last Updated: 06 August 25 at 00:17</p>
+<p>Last Updated: 07 August 25 at 00:17</p>
<div class="toctree-wrapper compound">
<p class="caption"><span class="caption-text">Table of Contents</span></p>
<ul class="current">
diff --git a/content/docs/10.1.0/index.html b/content/docs/10.1.0/index.html
index 9588de13f..61247d5ca 100644
--- a/content/docs/10.1.0/index.html
+++ b/content/docs/10.1.0/index.html
@@ -245,7 +245,7 @@ by following these <a class="reference internal"
href="contributing/documentatio
<div class="section" id="nuttx-documentation">
<h1>NuttX Documentation<a class="headerlink" href="#nuttx-documentation"
title="Permalink to this headline">¶</a></h1>
<p>NuttX is a real-time operating system (RTOS) with an emphasis on standards
compliance and small footprint. Scalable from 8-bit to 64-bit microcontroller
environments, the primary governing standards in NuttX are POSIX and ANSI
standards. Additional standard APIs from Unix and other common RTOS’s (such as
VxWorks) are adopted for functionality not available under these standards, or
for functionality that is not appropriate for deeply-embedded environments
(such as fork()).</p>
-<p>Last Updated: 06 August 25 at 00:17</p>
+<p>Last Updated: 07 August 25 at 00:17</p>
<div class="toctree-wrapper compound">
<p class="caption"><span class="caption-text">Table of Contents</span></p>
<ul class="current">
diff --git a/content/docs/10.2.0/index.html b/content/docs/10.2.0/index.html
index 6a70d07dd..40642f939 100644
--- a/content/docs/10.2.0/index.html
+++ b/content/docs/10.2.0/index.html
@@ -246,7 +246,7 @@ by following these <a class="reference internal"
href="contributing/documentatio
<div class="section" id="nuttx-documentation">
<h1>NuttX Documentation<a class="headerlink" href="#nuttx-documentation"
title="Permalink to this headline">¶</a></h1>
<p>NuttX is a real-time operating system (RTOS) with an emphasis on standards
compliance and small footprint. Scalable from 8-bit to 64-bit microcontroller
environments, the primary governing standards in NuttX are POSIX and ANSI
standards. Additional standard APIs from Unix and other common RTOS’s (such as
VxWorks) are adopted for functionality not available under these standards, or
for functionality that is not appropriate for deeply-embedded environments
(such as fork()).</p>
-<p>Last Updated: 06 August 25 at 00:17</p>
+<p>Last Updated: 07 August 25 at 00:17</p>
<div class="toctree-wrapper compound">
<p class="caption"><span class="caption-text">Table of Contents</span></p>
<ul class="current">
diff --git a/content/docs/10.3.0/index.html b/content/docs/10.3.0/index.html
index ffa827fcf..3b8019f4a 100644
--- a/content/docs/10.3.0/index.html
+++ b/content/docs/10.3.0/index.html
@@ -246,7 +246,7 @@ by following these <a class="reference internal"
href="contributing/documentatio
<div class="section" id="nuttx-documentation">
<h1>NuttX Documentation<a class="headerlink" href="#nuttx-documentation"
title="Permalink to this headline">¶</a></h1>
<p>NuttX is a real-time operating system (RTOS) with an emphasis on standards
compliance and small footprint. Scalable from 8-bit to 64-bit microcontroller
environments, the primary governing standards in NuttX are POSIX and ANSI
standards. Additional standard APIs from Unix and other common RTOS’s (such as
VxWorks) are adopted for functionality not available under these standards, or
for functionality that is not appropriate for deeply-embedded environments
(such as fork()).</p>
-<p>Last Updated: 06 August 25 at 00:18</p>
+<p>Last Updated: 07 August 25 at 00:18</p>
<div class="toctree-wrapper compound">
<p class="caption"><span class="caption-text">Table of Contents</span></p>
<ul class="current">
diff --git a/content/docs/11.0.0/index.html b/content/docs/11.0.0/index.html
index ffa827fcf..3b8019f4a 100644
--- a/content/docs/11.0.0/index.html
+++ b/content/docs/11.0.0/index.html
@@ -246,7 +246,7 @@ by following these <a class="reference internal"
href="contributing/documentatio
<div class="section" id="nuttx-documentation">
<h1>NuttX Documentation<a class="headerlink" href="#nuttx-documentation"
title="Permalink to this headline">¶</a></h1>
<p>NuttX is a real-time operating system (RTOS) with an emphasis on standards
compliance and small footprint. Scalable from 8-bit to 64-bit microcontroller
environments, the primary governing standards in NuttX are POSIX and ANSI
standards. Additional standard APIs from Unix and other common RTOS’s (such as
VxWorks) are adopted for functionality not available under these standards, or
for functionality that is not appropriate for deeply-embedded environments
(such as fork()).</p>
-<p>Last Updated: 06 August 25 at 00:18</p>
+<p>Last Updated: 07 August 25 at 00:18</p>
<div class="toctree-wrapper compound">
<p class="caption"><span class="caption-text">Table of Contents</span></p>
<ul class="current">
diff --git a/content/docs/12.0.0/index.html b/content/docs/12.0.0/index.html
index 53996740e..2da6b00d3 100644
--- a/content/docs/12.0.0/index.html
+++ b/content/docs/12.0.0/index.html
@@ -171,7 +171,7 @@ by following these <a class="reference internal"
href="contributing/documentatio
<section id="nuttx-documentation">
<h1>NuttX Documentation<a class="headerlink" href="#nuttx-documentation"
title="Permalink to this headline"></a></h1>
<p>NuttX is a real-time operating system (RTOS) with an emphasis on standards
compliance and small footprint. Scalable from 8-bit to 64-bit microcontroller
environments, the primary governing standards in NuttX are POSIX and ANSI
standards. Additional standard APIs from Unix and other common RTOS’s (such as
VxWorks) are adopted for functionality not available under these standards, or
for functionality that is not appropriate for deeply-embedded environments
(such as fork()).</p>
-<p>Last Updated: 06 August 25 at 00:18</p>
+<p>Last Updated: 07 August 25 at 00:18</p>
<div class="toctree-wrapper compound">
<p class="caption" role="heading"><span class="caption-text">Table of
Contents</span></p>
<ul class="current">
diff --git a/content/docs/12.0.0/searchindex.js
b/content/docs/12.0.0/searchindex.js
index 24c78db84..6a2509eb9 100644
--- a/content/docs/12.0.0/searchindex.js
+++ b/content/docs/12.0.0/searchindex.js
@@ -1 +1 @@
-Search.setIndex({docnames:["applications/index","applications/nsh/builtin","applications/nsh/commands","applications/nsh/config","applications/nsh/customizing","applications/nsh/index","applications/nsh/installation","applications/nsh/login","applications/nsh/nsh","components/binfmt","components/drivers/block/index","components/drivers/character/analog","components/drivers/character/can","components/drivers/character/foc","components/drivers/character/index","components/drivers/character
[...]
\ No newline at end of file
+Search.setIndex({docnames:["applications/index","applications/nsh/builtin","applications/nsh/commands","applications/nsh/config","applications/nsh/customizing","applications/nsh/index","applications/nsh/installation","applications/nsh/login","applications/nsh/nsh","components/binfmt","components/drivers/block/index","components/drivers/character/analog","components/drivers/character/can","components/drivers/character/foc","components/drivers/character/index","components/drivers/character
[...]
\ No newline at end of file
diff --git a/content/docs/12.1.0/index.html b/content/docs/12.1.0/index.html
index b2448265f..422e96937 100644
--- a/content/docs/12.1.0/index.html
+++ b/content/docs/12.1.0/index.html
@@ -171,7 +171,7 @@ by following these <a class="reference internal"
href="contributing/documentatio
<section id="nuttx-documentation">
<h1>NuttX Documentation<a class="headerlink" href="#nuttx-documentation"
title="Permalink to this headline"></a></h1>
<p>NuttX is a real-time operating system (RTOS) with an emphasis on standards
compliance and small footprint. Scalable from 8-bit to 64-bit microcontroller
environments, the primary governing standards in NuttX are POSIX and ANSI
standards. Additional standard APIs from Unix and other common RTOS’s (such as
VxWorks) are adopted for functionality not available under these standards, or
for functionality that is not appropriate for deeply-embedded environments
(such as fork()).</p>
-<p>Last Updated: 06 August 25 at 00:18</p>
+<p>Last Updated: 07 August 25 at 00:19</p>
<div class="toctree-wrapper compound">
<p class="caption" role="heading"><span class="caption-text">Table of
Contents</span></p>
<ul class="current">
diff --git a/content/docs/12.1.0/searchindex.js
b/content/docs/12.1.0/searchindex.js
index 461025107..236569d56 100644
--- a/content/docs/12.1.0/searchindex.js
+++ b/content/docs/12.1.0/searchindex.js
@@ -1 +1 @@
-Search.setIndex({docnames:["applications/index","applications/nsh/builtin","applications/nsh/commands","applications/nsh/config","applications/nsh/customizing","applications/nsh/index","applications/nsh/installation","applications/nsh/login","applications/nsh/nsh","components/binfmt","components/drivers/block/index","components/drivers/character/analog","components/drivers/character/can","components/drivers/character/foc","components/drivers/character/index","components/drivers/character
[...]
\ No newline at end of file
+Search.setIndex({docnames:["applications/index","applications/nsh/builtin","applications/nsh/commands","applications/nsh/config","applications/nsh/customizing","applications/nsh/index","applications/nsh/installation","applications/nsh/login","applications/nsh/nsh","components/binfmt","components/drivers/block/index","components/drivers/character/analog","components/drivers/character/can","components/drivers/character/foc","components/drivers/character/index","components/drivers/character
[...]
\ No newline at end of file
diff --git a/content/docs/12.10.0/index.html b/content/docs/12.10.0/index.html
index b961d9c92..a7c3c4cf9 100644
--- a/content/docs/12.10.0/index.html
+++ b/content/docs/12.10.0/index.html
@@ -183,7 +183,7 @@ standards. Additional standard APIs from Unix and other
common RTOS’s (such as
VxWorks) are adopted for functionality not available under these standards, or
for functionality that is not appropriate for deeply-embedded environments
(such
as fork()).</p>
-<p>Last Updated: 06 August 25 at 00:31</p>
+<p>Last Updated: 07 August 25 at 00:31</p>
<div class="toctree-wrapper compound">
<p class="caption" role="heading"><span class="caption-text">Table of
Contents</span></p>
<ul class="current">
diff --git a/content/docs/12.10.0/searchindex.js
b/content/docs/12.10.0/searchindex.js
index faaf5c818..53610cd90 100644
--- a/content/docs/12.10.0/searchindex.js
+++ b/content/docs/12.10.0/searchindex.js
@@ -1 +1 @@
-Search.setIndex({"docnames": ["_tags/arch-arm64", "_tags/arch-avr",
"_tags/arch-example", "_tags/chip-a527", "_tags/chip-a64",
"_tags/chip-at90usb", "_tags/chip-atmega", "_tags/chip-atmega2560",
"_tags/chip-bcm2711", "_tags/chip-esp32", "_tags/chip-esp32a1s",
"_tags/chip-esp32picod4", "_tags/chip-esp32s2", "_tags/chip-esp32s3",
"_tags/chip-esp32wroom32", "_tags/chip-esp32wrover32", "_tags/chip-example",
"_tags/chip-fpga", "_tags/chip-imx8", "_tags/chip-imx93", "_tags/chip-nrf52",
"_tags/ [...]
\ No newline at end of file
+Search.setIndex({"docnames": ["_tags/arch-arm64", "_tags/arch-avr",
"_tags/arch-example", "_tags/chip-a527", "_tags/chip-a64",
"_tags/chip-at90usb", "_tags/chip-atmega", "_tags/chip-atmega2560",
"_tags/chip-bcm2711", "_tags/chip-esp32", "_tags/chip-esp32a1s",
"_tags/chip-esp32picod4", "_tags/chip-esp32s2", "_tags/chip-esp32s3",
"_tags/chip-esp32wroom32", "_tags/chip-esp32wrover32", "_tags/chip-example",
"_tags/chip-fpga", "_tags/chip-imx8", "_tags/chip-imx93", "_tags/chip-nrf52",
"_tags/ [...]
\ No newline at end of file
diff --git a/content/docs/12.2.0/index.html b/content/docs/12.2.0/index.html
index 5fc9245f6..9419d15bf 100644
--- a/content/docs/12.2.0/index.html
+++ b/content/docs/12.2.0/index.html
@@ -172,7 +172,7 @@ by following these <a class="reference internal"
href="contributing/documentatio
<section id="nuttx-documentation">
<h1>NuttX Documentation<a class="headerlink" href="#nuttx-documentation"
title="Permalink to this heading"></a></h1>
<p>NuttX is a real-time operating system (RTOS) with an emphasis on standards
compliance and small footprint. Scalable from 8-bit to 64-bit microcontroller
environments, the primary governing standards in NuttX are POSIX and ANSI
standards. Additional standard APIs from Unix and other common RTOS’s (such as
VxWorks) are adopted for functionality not available under these standards, or
for functionality that is not appropriate for deeply-embedded environments
(such as fork()).</p>
-<p>Last Updated: 06 August 25 at 00:19</p>
+<p>Last Updated: 07 August 25 at 00:19</p>
<div class="toctree-wrapper compound">
<p class="caption" role="heading"><span class="caption-text">Table of
Contents</span></p>
<ul class="current">
diff --git
a/content/docs/12.2.0/platforms/xtensa/esp32/boards/esp32-audio-kit/index.html
b/content/docs/12.2.0/platforms/xtensa/esp32/boards/esp32-audio-kit/index.html
index b15c31a89..3585a9a35 100644
---
a/content/docs/12.2.0/platforms/xtensa/esp32/boards/esp32-audio-kit/index.html
+++
b/content/docs/12.2.0/platforms/xtensa/esp32/boards/esp32-audio-kit/index.html
@@ -353,7 +353,7 @@ Serving HTTP on 0.0.0.0 port 8000 (http://0.0.0.0:8000/)
<p>Look for your PC IP address and test playing the prepared audio on your
browser:</p>
<figure class="align-center">
-<img alt="../../../../../_images/esp32-audio-config-file.png"
src="../../../../../_images/esp32-audio-config-file.png" />
+<img alt="../../../../../_images/esp32-audio-config-file1.png"
src="../../../../../_images/esp32-audio-config-file1.png" />
</figure>
<p>After successfully built and flashed, connect the board to the Wi-Fi
network:</p>
<div class="highlight-none notranslate"><div
class="highlight"><pre><span></span>$ nsh> wapi psk wlan0 mypasswd 3
diff --git
a/content/docs/12.2.0/platforms/xtensa/esp32/boards/esp32-devkitc/index.html
b/content/docs/12.2.0/platforms/xtensa/esp32/boards/esp32-devkitc/index.html
index b38a9985a..8dbcc283f 100644
--- a/content/docs/12.2.0/platforms/xtensa/esp32/boards/esp32-devkitc/index.html
+++ b/content/docs/12.2.0/platforms/xtensa/esp32/boards/esp32-devkitc/index.html
@@ -450,7 +450,7 @@ Serving HTTP on 0.0.0.0 port 8000 (http://0.0.0.0:8000/)
<p>Look for your PC IP address and test playing the prepared audio on your
browser:</p>
<figure class="align-center">
-<img alt="../../../../../_images/esp32-audio-config-file1.png"
src="../../../../../_images/esp32-audio-config-file1.png" />
+<img alt="../../../../../_images/esp32-audio-config-file.png"
src="../../../../../_images/esp32-audio-config-file.png" />
</figure>
<p>After successfully built and flashed, connect the board to the Wi-Fi
network:</p>
<div class="highlight-none notranslate"><div
class="highlight"><pre><span></span>nsh> wapi psk wlan0 mypasswd 3
diff --git a/content/docs/12.2.0/searchindex.js
b/content/docs/12.2.0/searchindex.js
index eb081f7bb..06294aeee 100644
--- a/content/docs/12.2.0/searchindex.js
+++ b/content/docs/12.2.0/searchindex.js
@@ -1 +1 @@
-Search.setIndex({"docnames": ["applications/index",
"applications/nsh/builtin", "applications/nsh/commands",
"applications/nsh/config", "applications/nsh/customizing",
"applications/nsh/index", "applications/nsh/installation",
"applications/nsh/login", "applications/nsh/nsh", "applications/nxdiag/config",
"applications/nxdiag/index", "applications/wapi/commands",
"applications/wapi/index", "applications/wapi/wireless", "components/binfmt",
"components/drivers/block/index", "components/dr [...]
\ No newline at end of file
+Search.setIndex({"docnames": ["applications/index",
"applications/nsh/builtin", "applications/nsh/commands",
"applications/nsh/config", "applications/nsh/customizing",
"applications/nsh/index", "applications/nsh/installation",
"applications/nsh/login", "applications/nsh/nsh", "applications/nxdiag/config",
"applications/nxdiag/index", "applications/wapi/commands",
"applications/wapi/index", "applications/wapi/wireless", "components/binfmt",
"components/drivers/block/index", "components/dr [...]
\ No newline at end of file
diff --git a/content/docs/12.2.1/index.html b/content/docs/12.2.1/index.html
index 5fc9245f6..9419d15bf 100644
--- a/content/docs/12.2.1/index.html
+++ b/content/docs/12.2.1/index.html
@@ -172,7 +172,7 @@ by following these <a class="reference internal"
href="contributing/documentatio
<section id="nuttx-documentation">
<h1>NuttX Documentation<a class="headerlink" href="#nuttx-documentation"
title="Permalink to this heading"></a></h1>
<p>NuttX is a real-time operating system (RTOS) with an emphasis on standards
compliance and small footprint. Scalable from 8-bit to 64-bit microcontroller
environments, the primary governing standards in NuttX are POSIX and ANSI
standards. Additional standard APIs from Unix and other common RTOS’s (such as
VxWorks) are adopted for functionality not available under these standards, or
for functionality that is not appropriate for deeply-embedded environments
(such as fork()).</p>
-<p>Last Updated: 06 August 25 at 00:19</p>
+<p>Last Updated: 07 August 25 at 00:19</p>
<div class="toctree-wrapper compound">
<p class="caption" role="heading"><span class="caption-text">Table of
Contents</span></p>
<ul class="current">
diff --git a/content/docs/12.2.1/searchindex.js
b/content/docs/12.2.1/searchindex.js
index 23077efba..babf6f49a 100644
--- a/content/docs/12.2.1/searchindex.js
+++ b/content/docs/12.2.1/searchindex.js
@@ -1 +1 @@
-Search.setIndex({"docnames": ["applications/index",
"applications/nsh/builtin", "applications/nsh/commands",
"applications/nsh/config", "applications/nsh/customizing",
"applications/nsh/index", "applications/nsh/installation",
"applications/nsh/login", "applications/nsh/nsh", "applications/nxdiag/config",
"applications/nxdiag/index", "applications/wapi/commands",
"applications/wapi/index", "applications/wapi/wireless", "components/binfmt",
"components/drivers/block/index", "components/dr [...]
\ No newline at end of file
+Search.setIndex({"docnames": ["applications/index",
"applications/nsh/builtin", "applications/nsh/commands",
"applications/nsh/config", "applications/nsh/customizing",
"applications/nsh/index", "applications/nsh/installation",
"applications/nsh/login", "applications/nsh/nsh", "applications/nxdiag/config",
"applications/nxdiag/index", "applications/wapi/commands",
"applications/wapi/index", "applications/wapi/wireless", "components/binfmt",
"components/drivers/block/index", "components/dr [...]
\ No newline at end of file
diff --git a/content/docs/12.3.0/index.html b/content/docs/12.3.0/index.html
index d4ef9de1e..894db1fe6 100644
--- a/content/docs/12.3.0/index.html
+++ b/content/docs/12.3.0/index.html
@@ -172,7 +172,7 @@ by following these <a class="reference internal"
href="contributing/documentatio
<section id="nuttx-documentation">
<h1>NuttX Documentation<a class="headerlink" href="#nuttx-documentation"
title="Permalink to this heading"></a></h1>
<p>NuttX is a real-time operating system (RTOS) with an emphasis on standards
compliance and small footprint. Scalable from 8-bit to 64-bit microcontroller
environments, the primary governing standards in NuttX are POSIX and ANSI
standards. Additional standard APIs from Unix and other common RTOS’s (such as
VxWorks) are adopted for functionality not available under these standards, or
for functionality that is not appropriate for deeply-embedded environments
(such as fork()).</p>
-<p>Last Updated: 06 August 25 at 00:20</p>
+<p>Last Updated: 07 August 25 at 00:20</p>
<div class="toctree-wrapper compound">
<p class="caption" role="heading"><span class="caption-text">Table of
Contents</span></p>
<ul class="current">
diff --git a/content/docs/12.3.0/searchindex.js
b/content/docs/12.3.0/searchindex.js
index 12acc4ae1..34b4941c0 100644
--- a/content/docs/12.3.0/searchindex.js
+++ b/content/docs/12.3.0/searchindex.js
@@ -1 +1 @@
-Search.setIndex({"docnames": ["applications/index",
"applications/nsh/builtin", "applications/nsh/commands",
"applications/nsh/config", "applications/nsh/customizing",
"applications/nsh/index", "applications/nsh/installation",
"applications/nsh/login", "applications/nsh/nsh", "applications/nxdiag/config",
"applications/nxdiag/index", "applications/wapi/commands",
"applications/wapi/index", "applications/wapi/wireless", "components/binfmt",
"components/drivers/block/index", "components/dr [...]
\ No newline at end of file
+Search.setIndex({"docnames": ["applications/index",
"applications/nsh/builtin", "applications/nsh/commands",
"applications/nsh/config", "applications/nsh/customizing",
"applications/nsh/index", "applications/nsh/installation",
"applications/nsh/login", "applications/nsh/nsh", "applications/nxdiag/config",
"applications/nxdiag/index", "applications/wapi/commands",
"applications/wapi/index", "applications/wapi/wireless", "components/binfmt",
"components/drivers/block/index", "components/dr [...]
\ No newline at end of file
diff --git a/content/docs/12.4.0/index.html b/content/docs/12.4.0/index.html
index 4c5645f91..ab3882553 100644
--- a/content/docs/12.4.0/index.html
+++ b/content/docs/12.4.0/index.html
@@ -179,7 +179,7 @@ standards. Additional standard APIs from Unix and other
common RTOS’s (such as
VxWorks) are adopted for functionality not available under these standards, or
for functionality that is not appropriate for deeply-embedded environments
(such
as fork()).</p>
-<p>Last Updated: 06 August 25 at 00:20</p>
+<p>Last Updated: 07 August 25 at 00:20</p>
<div class="toctree-wrapper compound">
<p class="caption" role="heading"><span class="caption-text">Table of
Contents</span></p>
<ul class="current">
diff --git a/content/docs/12.4.0/searchindex.js
b/content/docs/12.4.0/searchindex.js
index dcfd2fe80..8755b9803 100644
--- a/content/docs/12.4.0/searchindex.js
+++ b/content/docs/12.4.0/searchindex.js
@@ -1 +1 @@
-Search.setIndex({"docnames": ["applications/audioutils/fmsynt/index",
"applications/audioutils/index", "applications/audioutils/mml_parser/index",
"applications/audioutils/nxaudio/index",
"applications/benchmarks/coremark/index", "applications/benchmarks/index",
"applications/boot/index", "applications/boot/mcuboot/index",
"applications/boot/miniboot/index", "applications/canutils/candump/index",
"applications/canutils/canlib/index", "applications/canutils/cansend/index",
"applications/c [...]
\ No newline at end of file
+Search.setIndex({"docnames": ["applications/audioutils/fmsynt/index",
"applications/audioutils/index", "applications/audioutils/mml_parser/index",
"applications/audioutils/nxaudio/index",
"applications/benchmarks/coremark/index", "applications/benchmarks/index",
"applications/boot/index", "applications/boot/mcuboot/index",
"applications/boot/miniboot/index", "applications/canutils/candump/index",
"applications/canutils/canlib/index", "applications/canutils/cansend/index",
"applications/c [...]
\ No newline at end of file
diff --git a/content/docs/12.5.0/index.html b/content/docs/12.5.0/index.html
index a36855bc5..dd1613379 100644
--- a/content/docs/12.5.0/index.html
+++ b/content/docs/12.5.0/index.html
@@ -179,7 +179,7 @@ standards. Additional standard APIs from Unix and other
common RTOS’s (such as
VxWorks) are adopted for functionality not available under these standards, or
for functionality that is not appropriate for deeply-embedded environments
(such
as fork()).</p>
-<p>Last Updated: 06 August 25 at 00:22</p>
+<p>Last Updated: 07 August 25 at 00:22</p>
<div class="toctree-wrapper compound">
<p class="caption" role="heading"><span class="caption-text">Table of
Contents</span></p>
<ul class="current">
diff --git a/content/docs/12.5.0/searchindex.js
b/content/docs/12.5.0/searchindex.js
index 448307a02..51cea51ae 100644
--- a/content/docs/12.5.0/searchindex.js
+++ b/content/docs/12.5.0/searchindex.js
@@ -1 +1 @@
-Search.setIndex({"docnames": ["applications/audioutils/fmsynt/index",
"applications/audioutils/index", "applications/audioutils/mml_parser/index",
"applications/audioutils/nxaudio/index",
"applications/benchmarks/coremark/index", "applications/benchmarks/index",
"applications/boot/index", "applications/boot/mcuboot/index",
"applications/boot/miniboot/index", "applications/canutils/candump/index",
"applications/canutils/canlib/index", "applications/canutils/cansend/index",
"applications/c [...]
\ No newline at end of file
+Search.setIndex({"docnames": ["applications/audioutils/fmsynt/index",
"applications/audioutils/index", "applications/audioutils/mml_parser/index",
"applications/audioutils/nxaudio/index",
"applications/benchmarks/coremark/index", "applications/benchmarks/index",
"applications/boot/index", "applications/boot/mcuboot/index",
"applications/boot/miniboot/index", "applications/canutils/candump/index",
"applications/canutils/canlib/index", "applications/canutils/cansend/index",
"applications/c [...]
\ No newline at end of file
diff --git a/content/docs/12.5.1/index.html b/content/docs/12.5.1/index.html
index 9a48a295d..27a27c03d 100644
--- a/content/docs/12.5.1/index.html
+++ b/content/docs/12.5.1/index.html
@@ -179,7 +179,7 @@ standards. Additional standard APIs from Unix and other
common RTOS’s (such as
VxWorks) are adopted for functionality not available under these standards, or
for functionality that is not appropriate for deeply-embedded environments
(such
as fork()).</p>
-<p>Last Updated: 06 August 25 at 00:23</p>
+<p>Last Updated: 07 August 25 at 00:23</p>
<div class="toctree-wrapper compound">
<p class="caption" role="heading"><span class="caption-text">Table of
Contents</span></p>
<ul class="current">
diff --git a/content/docs/12.5.1/searchindex.js
b/content/docs/12.5.1/searchindex.js
index 655f6ac9e..b6e28d57c 100644
--- a/content/docs/12.5.1/searchindex.js
+++ b/content/docs/12.5.1/searchindex.js
@@ -1 +1 @@
-Search.setIndex({"docnames": ["applications/audioutils/fmsynt/index",
"applications/audioutils/index", "applications/audioutils/mml_parser/index",
"applications/audioutils/nxaudio/index",
"applications/benchmarks/coremark/index", "applications/benchmarks/index",
"applications/boot/index", "applications/boot/mcuboot/index",
"applications/boot/miniboot/index", "applications/canutils/candump/index",
"applications/canutils/canlib/index", "applications/canutils/cansend/index",
"applications/c [...]
\ No newline at end of file
+Search.setIndex({"docnames": ["applications/audioutils/fmsynt/index",
"applications/audioutils/index", "applications/audioutils/mml_parser/index",
"applications/audioutils/nxaudio/index",
"applications/benchmarks/coremark/index", "applications/benchmarks/index",
"applications/boot/index", "applications/boot/mcuboot/index",
"applications/boot/miniboot/index", "applications/canutils/candump/index",
"applications/canutils/canlib/index", "applications/canutils/cansend/index",
"applications/c [...]
\ No newline at end of file
diff --git a/content/docs/12.6.0/index.html b/content/docs/12.6.0/index.html
index cd8d36e62..b8f95e518 100644
--- a/content/docs/12.6.0/index.html
+++ b/content/docs/12.6.0/index.html
@@ -180,7 +180,7 @@ standards. Additional standard APIs from Unix and other
common RTOS’s (such as
VxWorks) are adopted for functionality not available under these standards, or
for functionality that is not appropriate for deeply-embedded environments
(such
as fork()).</p>
-<p>Last Updated: 06 August 25 at 00:24</p>
+<p>Last Updated: 07 August 25 at 00:25</p>
<div class="toctree-wrapper compound">
<p class="caption" role="heading"><span class="caption-text">Table of
Contents</span></p>
<ul class="current">
diff --git a/content/docs/12.6.0/searchindex.js
b/content/docs/12.6.0/searchindex.js
index c2b35a08a..cebf978f6 100644
--- a/content/docs/12.6.0/searchindex.js
+++ b/content/docs/12.6.0/searchindex.js
@@ -1 +1 @@
-Search.setIndex({"docnames": ["applications/audioutils/fmsynt/index",
"applications/audioutils/index", "applications/audioutils/mml_parser/index",
"applications/audioutils/nxaudio/index",
"applications/benchmarks/cachespeed/index",
"applications/benchmarks/coremark-pro/index",
"applications/benchmarks/coremark/index",
"applications/benchmarks/dhrystone/index", "applications/benchmarks/fio/index",
"applications/benchmarks/index", "applications/benchmarks/iozone/index",
"applications/bench [...]
\ No newline at end of file
+Search.setIndex({"docnames": ["applications/audioutils/fmsynt/index",
"applications/audioutils/index", "applications/audioutils/mml_parser/index",
"applications/audioutils/nxaudio/index",
"applications/benchmarks/cachespeed/index",
"applications/benchmarks/coremark-pro/index",
"applications/benchmarks/coremark/index",
"applications/benchmarks/dhrystone/index", "applications/benchmarks/fio/index",
"applications/benchmarks/index", "applications/benchmarks/iozone/index",
"applications/bench [...]
\ No newline at end of file
diff --git a/content/docs/12.7.0/index.html b/content/docs/12.7.0/index.html
index 1d4d9540a..1d07fef11 100644
--- a/content/docs/12.7.0/index.html
+++ b/content/docs/12.7.0/index.html
@@ -179,7 +179,7 @@ standards. Additional standard APIs from Unix and other
common RTOS’s (such as
VxWorks) are adopted for functionality not available under these standards, or
for functionality that is not appropriate for deeply-embedded environments
(such
as fork()).</p>
-<p>Last Updated: 06 August 25 at 00:26</p>
+<p>Last Updated: 07 August 25 at 00:26</p>
<div class="toctree-wrapper compound">
<p class="caption" role="heading"><span class="caption-text">Table of
Contents</span></p>
<ul class="current">
diff --git a/content/docs/12.7.0/searchindex.js
b/content/docs/12.7.0/searchindex.js
index 218af7d73..6af455671 100644
--- a/content/docs/12.7.0/searchindex.js
+++ b/content/docs/12.7.0/searchindex.js
@@ -1 +1 @@
-Search.setIndex({"docnames": ["applications/audioutils/fmsynt/index",
"applications/audioutils/index", "applications/audioutils/mml_parser/index",
"applications/audioutils/nxaudio/index",
"applications/benchmarks/cachespeed/index",
"applications/benchmarks/coremark-pro/index",
"applications/benchmarks/coremark/index",
"applications/benchmarks/dhrystone/index", "applications/benchmarks/fio/index",
"applications/benchmarks/index", "applications/benchmarks/iozone/index",
"applications/bench [...]
\ No newline at end of file
+Search.setIndex({"docnames": ["applications/audioutils/fmsynt/index",
"applications/audioutils/index", "applications/audioutils/mml_parser/index",
"applications/audioutils/nxaudio/index",
"applications/benchmarks/cachespeed/index",
"applications/benchmarks/coremark-pro/index",
"applications/benchmarks/coremark/index",
"applications/benchmarks/dhrystone/index", "applications/benchmarks/fio/index",
"applications/benchmarks/index", "applications/benchmarks/iozone/index",
"applications/bench [...]
\ No newline at end of file
diff --git a/content/docs/12.8.0/index.html b/content/docs/12.8.0/index.html
index 3378c8dbf..99233576e 100644
--- a/content/docs/12.8.0/index.html
+++ b/content/docs/12.8.0/index.html
@@ -179,7 +179,7 @@ standards. Additional standard APIs from Unix and other
common RTOS’s (such as
VxWorks) are adopted for functionality not available under these standards, or
for functionality that is not appropriate for deeply-embedded environments
(such
as fork()).</p>
-<p>Last Updated: 06 August 25 at 00:27</p>
+<p>Last Updated: 07 August 25 at 00:28</p>
<div class="toctree-wrapper compound">
<p class="caption" role="heading"><span class="caption-text">Table of
Contents</span></p>
<ul class="current">
diff --git a/content/docs/12.8.0/searchindex.js
b/content/docs/12.8.0/searchindex.js
index 3f67a84c6..65e83d5e7 100644
--- a/content/docs/12.8.0/searchindex.js
+++ b/content/docs/12.8.0/searchindex.js
@@ -1 +1 @@
-Search.setIndex({"docnames": ["applications/audioutils/fmsynt/index",
"applications/audioutils/index", "applications/audioutils/mml_parser/index",
"applications/audioutils/nxaudio/index",
"applications/benchmarks/cachespeed/index",
"applications/benchmarks/coremark-pro/index",
"applications/benchmarks/coremark/index",
"applications/benchmarks/dhrystone/index", "applications/benchmarks/fio/index",
"applications/benchmarks/index", "applications/benchmarks/iozone/index",
"applications/bench [...]
\ No newline at end of file
+Search.setIndex({"docnames": ["applications/audioutils/fmsynt/index",
"applications/audioutils/index", "applications/audioutils/mml_parser/index",
"applications/audioutils/nxaudio/index",
"applications/benchmarks/cachespeed/index",
"applications/benchmarks/coremark-pro/index",
"applications/benchmarks/coremark/index",
"applications/benchmarks/dhrystone/index", "applications/benchmarks/fio/index",
"applications/benchmarks/index", "applications/benchmarks/iozone/index",
"applications/bench [...]
\ No newline at end of file
diff --git a/content/docs/12.9.0/index.html b/content/docs/12.9.0/index.html
index 1f5a4fb02..97bccbc92 100644
--- a/content/docs/12.9.0/index.html
+++ b/content/docs/12.9.0/index.html
@@ -179,7 +179,7 @@ standards. Additional standard APIs from Unix and other
common RTOS’s (such as
VxWorks) are adopted for functionality not available under these standards, or
for functionality that is not appropriate for deeply-embedded environments
(such
as fork()).</p>
-<p>Last Updated: 06 August 25 at 00:29</p>
+<p>Last Updated: 07 August 25 at 00:29</p>
<div class="toctree-wrapper compound">
<p class="caption" role="heading"><span class="caption-text">Table of
Contents</span></p>
<ul class="current">
diff --git a/content/docs/12.9.0/searchindex.js
b/content/docs/12.9.0/searchindex.js
index f93de1cdd..a2c830cc4 100644
--- a/content/docs/12.9.0/searchindex.js
+++ b/content/docs/12.9.0/searchindex.js
@@ -1 +1 @@
-Search.setIndex({"docnames": ["applications/audioutils/fmsynt/index",
"applications/audioutils/index", "applications/audioutils/mml_parser/index",
"applications/audioutils/nxaudio/index",
"applications/benchmarks/cachespeed/index",
"applications/benchmarks/coremark-pro/index",
"applications/benchmarks/coremark/index",
"applications/benchmarks/cyclictest/index",
"applications/benchmarks/dhrystone/index", "applications/benchmarks/fio/index",
"applications/benchmarks/index", "applications/b [...]
\ No newline at end of file
+Search.setIndex({"docnames": ["applications/audioutils/fmsynt/index",
"applications/audioutils/index", "applications/audioutils/mml_parser/index",
"applications/audioutils/nxaudio/index",
"applications/benchmarks/cachespeed/index",
"applications/benchmarks/coremark-pro/index",
"applications/benchmarks/coremark/index",
"applications/benchmarks/cyclictest/index",
"applications/benchmarks/dhrystone/index", "applications/benchmarks/fio/index",
"applications/benchmarks/index", "applications/b [...]
\ No newline at end of file
diff --git
a/content/docs/latest/_sources/components/drivers/special/sensors.rst.txt
b/content/docs/latest/_sources/components/drivers/special/sensors.rst.txt
index d66d08081..c1857b905 100644
--- a/content/docs/latest/_sources/components/drivers/special/sensors.rst.txt
+++ b/content/docs/latest/_sources/components/drivers/special/sensors.rst.txt
@@ -34,3 +34,4 @@ general interface.
sensors/lsm6dso32.rst
sensors/lis2mdl.rst
sensors/l86xxx.rst
+ sensors/gnss_lowerhalf.rst
diff --git
a/content/docs/latest/_sources/components/drivers/special/sensors/gnss_lowerhalf.rst.txt
b/content/docs/latest/_sources/components/drivers/special/sensors/gnss_lowerhalf.rst.txt
new file mode 100644
index 000000000..3485bf39e
--- /dev/null
+++
b/content/docs/latest/_sources/components/drivers/special/sensors/gnss_lowerhalf.rst.txt
@@ -0,0 +1,213 @@
+===========================
+GNSS Lower Half uORB Driver
+===========================
+
+The GNSS lower half driver is used to create uORB drivers for GNSS/GPS devices.
+The upper-half driver abstracts away the parsing and advertising of NMEA data
+from the device. The way this lower-half is instantiated is similar to lower
+half drivers in the :doc:`uORB framework
+</components/drivers/special/sensors/sensors_uorb>`.
+
+For an example on how to use this lower-half, see
+`</components/drivers/special/sensors/l86xxx>`
+
+Application Programming Interface
+=================================
+
+To use the GNSS lower half in your driver, just include the following header:
+
+.. code-block:: c
+
+ #include <nuttx/sensors/gnss.h>
+
+
+The GNSS driver works similarly to the uORB lower-half driver, where you must
+implement several operations for the upper-half to work. The first step is
+defining a custom type for your GNSS device, which must include a reference to
+the lower-half struct. In this case, the device is UART based, so several
+members are included to facilitate its operation.
+
+.. code-block:: c
+
+ /* Custom GNSS device type */
+
+ typedef struct
+ {
+ FAR struct file uart; /* UART interface to get data */
+ struct gnss_lowerhalf_s lower; /* GNSS lower-half */
+ bool enabled; /* Enabled state */
+ char buffer[256]; /* UART read buffer */
+ mutex_t lock; /* Device lock */
+ sem_t run; /* Start/stop kthread */
+ } my_gnss_dev_s;
+
+
+Then, you can create the operations table.
+
+.. code-block:: c
+
+ static const struct gnss_ops_s g_gnss_ops =
+ {
+ .control = my_gnss_control,
+ .activate = my_gnss_activate,
+ .set_interval = my_gnss_set_interval,
+ }
+
+These functions are very similar to the functions that you use for implementing
+a uORB lower-half.
+
+* The ``control`` function is used to handle ``IOCTL`` commands that aren't
+ implemented by the upper-half
+
+* The ``activate`` function is used to enable/disable the device so that is
+ saves power when not in use
+
+* The ``set_interval`` function is used to set the sampling rate
+
+It is up to you to implement these functions so that they meet the requirements
+of the upper-half driver.
+
+For this implementation, because we are reading data from a UART interface, we
+will read from the ``uart`` member of our ``my_gnss_dev_s`` struct into our
read
+buffer. This takes place in a kernel thread, which polls the UART interface.
+Once the data is read, we just have to send it to the upper-half to parse and
+publish as uORB data.
+
+The data we provide to the upper-half does not have to be null-terminated
+strings, or even a complete NMEA sentence. The upper-half will parse as it
goes,
+and wait until it has a full sentence in its own buffer before parsing.
+
+Here is an excerpt of how to publish that data:
+
+.. code-block:: c
+
+ /* `dev` is a reference to our `my_gnss_dev_s` struct */
+
+ err = nxmutex_lock(&dev->lock);
+ if (err < 0)
+ {
+ snerr("Couldn't lock mutex\n");
+ return err;
+ }
+
+ bw = file_read(&dev->uart, dev->buffer, sizeof(dev->buffer));
+
+ if (bw <= 0)
+ {
+ snerr("No data on UART: %d\n", bw);
+ nxmutex_unlock(&dev->lock);
+ continue;
+ }
+
+ /* Send data read to the lower half for parsing. Does not need to be a
+ * full NMEA sentence to be handled.
+ */
+
+ if (bw > 0)
+ {
+ dev->lower.push_data(dev->lower.priv, dev->buffer, bw, true);
+ }
+
+ nxmutex_unlock(&dev->lock);
+
+Once all of the above has been implemented, in your driver's registration
+function, you'll need to initialize the structure to your GNSS device in the
+registration function.
+
+.. code-block:: c
+
+ /* Registration function for this device type */
+
+ int mygnss_register(FAR char const *uartpath, int devno)
+ {
+ FAR mygnss_dev_s *priv;
+ int err;
+ uint32_t nbuffers[SENSOR_GNSS_IDX_GNSS_MAX];
+
+ /* This is a bare example not considering error handling */
+
+ priv = kmm_zalloc(sizeof(my_gnss_dev_s));
+
+ /* Initialize whatever specific members of your device struct need
+ * initializing here...
+ */
+
+ priv->lower.ops = &g_gnss_ops; /* Ops table */
+ priv->lower.priv = priv; /* Reference to your lower-half */
+
+ /* This selects the buffer sizes for each of the buffers that handle
these
+ * sets of events. The index macros are included in the gnss header file
+ */
+
+ nbuffers[SENSOR_GNSS_IDX_GNSS] = 1;
+ nbuffers[SENSOR_GNSS_IDX_GNSS_SATELLITE] = 1;
+ nbuffers[SENSOR_GNSS_IDX_GNSS_MEASUREMENT] = 1;
+ nbuffers[SENSOR_GNSS_IDX_GNSS_CLOCK] = 1;
+ nbuffers[SENSOR_GNSS_IDX_GNSS_GEOFENCE] = 1;
+
+ /* Register the lower-half driver with our information.
+ * `SENSOR_GNSS_IDX_GNSS_MAX` is the length of our `nbuffers` array.
+ */
+
+ err =
+ gnss_register(&priv->lower, devno, nbuffers,
SENSOR_GNSS_IDX_GNSS_MAX);
+ if (err < 0)
+ {
+ snerr("Failed to register myGNSS driver: %d\n", err);
+ /* You should handle the error by cleaning up resources */
+ }
+
+ /* Here, handle starting up your kernel thread and any other error
+ * cleanup.
+ */
+
+ return err;
+ }
+
+Registration in Device Code
+===========================
+
+To register the driver in device code, simply call the registration function
you
+wrote. You'll have to include your header file.
+
+.. code-block:: c
+
+ #if defined(CONFIG_SENSORS_MYGNSS) /* Change for your GNSS driver */
+ #include <nuttx/sensors/mygnss.h>
+ #endif
+
+ /* Put this inside your board's real bringup function, where other drivers
+ * are being registered.
+ */
+
+ int my_board_bringup(void)
+ {
+ #if defined(CONFIG_SENSORS_MYGNSS)
+ /* Register myGNSS on USART0 */
+
+ ret = l86xxx_register("/dev/ttyS0", 0);
+ if (ret < 0) {
+ syslog(LOG_ERR, "Failed to register myGNSS driver: %d\n", ret);
+ }
+ #endif
+ }
+
+Operation
+=========
+
+Now you should see several different uORB GNSS topics get published under
+``/dev/uorb``. These correspond to all of the different buffer types you
+initialized earlier, like geofence, clock, statellite, etc. The plain
+``sensor_gnss`` device will publish lots of data from the NMEA sentences.
+
+You can use the ``uorb_listener`` application
+(:doc:`/applications/system/uorb/index`) to see if data is being published
+correctly.
+
+.. code-block:: console
+
+ nsh> uorb_listener sensor_gnss
+
+ Monitor objects num:2
+ object_name:sensor_gnss, object_instance:0
+
sensor_gnss(now:237030000):timestamp:237030000,time_utc:1753502745,latitude:xxxxxxxx,longitude:xxxxxxxxxx,altitude:36.900002,altitude_ellipsoid:24.200001,0
diff --git
a/content/docs/latest/_sources/components/drivers/special/sensors/sensors_uorb.rst.txt
b/content/docs/latest/_sources/components/drivers/special/sensors/sensors_uorb.rst.txt
index f038d5fe8..75187b665 100644
---
a/content/docs/latest/_sources/components/drivers/special/sensors/sensors_uorb.rst.txt
+++
b/content/docs/latest/_sources/components/drivers/special/sensors/sensors_uorb.rst.txt
@@ -17,6 +17,12 @@ multiple sensors into one unit, multiple lower halves need
to be instantiated
within the driver, and device nodes are registered separately through the API
(sensor_register) provided by the upper half.
+.. note::
+
+ When writing a uORB driver for GNSS/GPS devices, please use the :doc:`GNSS
+ lower-half driver </components/drivers/special/sensors/gnss_lowerhalf>`.
This
+ driver abstracts parsing and advertising of NMEA information.
+
Naming
======
diff --git a/content/docs/latest/components/drivers/special/segger.html
b/content/docs/latest/components/drivers/special/segger.html
index b9b2e6737..c2b29516d 100644
--- a/content/docs/latest/components/drivers/special/segger.html
+++ b/content/docs/latest/components/drivers/special/segger.html
@@ -47,7 +47,7 @@
<link rel="index" title="Index" href="../../../genindex.html" />
<link rel="search" title="Search" href="../../../search.html" />
<link rel="next" title="SPI Device Drivers" href="spi.html" />
- <link rel="prev" title="L86-XXX" href="sensors/l86xxx.html" />
+ <link rel="prev" title="GNSS Lower Half uORB Driver"
href="sensors/gnss_lowerhalf.html" />
</head>
<body class="wy-body-for-nav">
@@ -305,7 +305,7 @@ Make sure that <code class="docutils literal
notranslate"><span class="pre">CONF
</div>
</div>
<footer><div class="rst-footer-buttons" role="navigation"
aria-label="Footer">
- <a href="sensors/l86xxx.html" class="btn btn-neutral float-left"
title="L86-XXX" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left"
aria-hidden="true"></span> Previous</a>
+ <a href="sensors/gnss_lowerhalf.html" class="btn btn-neutral
float-left" title="GNSS Lower Half uORB Driver" accesskey="p" rel="prev"><span
class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
<a href="spi.html" class="btn btn-neutral float-right" title="SPI
Device Drivers" accesskey="n" rel="next">Next <span class="fa
fa-arrow-circle-right" aria-hidden="true"></span></a>
</div>
diff --git a/content/docs/latest/components/drivers/special/sensors.html
b/content/docs/latest/components/drivers/special/sensors.html
index dc8580153..d3a1393bd 100644
--- a/content/docs/latest/components/drivers/special/sensors.html
+++ b/content/docs/latest/components/drivers/special/sensors.html
@@ -169,6 +169,7 @@
<li class="toctree-l5"><a class="reference internal"
href="sensors/lsm6dso32.html">LSM6DSO32</a></li>
<li class="toctree-l5"><a class="reference internal"
href="sensors/lis2mdl.html">LIS2MDL</a></li>
<li class="toctree-l5"><a class="reference internal"
href="sensors/l86xxx.html">L86-XXX</a></li>
+<li class="toctree-l5"><a class="reference internal"
href="sensors/gnss_lowerhalf.html">GNSS Lower Half uORB Driver</a></li>
</ul>
</li>
<li class="toctree-l4"><a class="reference internal" href="segger.html">Segger
RTT drivers</a></li>
diff --git
a/content/docs/latest/components/drivers/special/sensors/adt7320.html
b/content/docs/latest/components/drivers/special/sensors/adt7320.html
index 92e6e6617..4dbfe44d7 100644
--- a/content/docs/latest/components/drivers/special/sensors/adt7320.html
+++ b/content/docs/latest/components/drivers/special/sensors/adt7320.html
@@ -169,6 +169,7 @@
<li class="toctree-l5"><a class="reference internal"
href="lsm6dso32.html">LSM6DSO32</a></li>
<li class="toctree-l5"><a class="reference internal"
href="lis2mdl.html">LIS2MDL</a></li>
<li class="toctree-l5"><a class="reference internal"
href="l86xxx.html">L86-XXX</a></li>
+<li class="toctree-l5"><a class="reference internal"
href="gnss_lowerhalf.html">GNSS Lower Half uORB Driver</a></li>
</ul>
</li>
<li class="toctree-l4"><a class="reference internal"
href="../segger.html">Segger RTT drivers</a></li>
diff --git
a/content/docs/latest/components/drivers/special/sensors/adxl345.html
b/content/docs/latest/components/drivers/special/sensors/adxl345.html
index d9c61ec7a..74e81082d 100644
--- a/content/docs/latest/components/drivers/special/sensors/adxl345.html
+++ b/content/docs/latest/components/drivers/special/sensors/adxl345.html
@@ -169,6 +169,7 @@
<li class="toctree-l5"><a class="reference internal"
href="lsm6dso32.html">LSM6DSO32</a></li>
<li class="toctree-l5"><a class="reference internal"
href="lis2mdl.html">LIS2MDL</a></li>
<li class="toctree-l5"><a class="reference internal"
href="l86xxx.html">L86-XXX</a></li>
+<li class="toctree-l5"><a class="reference internal"
href="gnss_lowerhalf.html">GNSS Lower Half uORB Driver</a></li>
</ul>
</li>
<li class="toctree-l4"><a class="reference internal"
href="../segger.html">Segger RTT drivers</a></li>
diff --git
a/content/docs/latest/components/drivers/special/sensors/adxl362.html
b/content/docs/latest/components/drivers/special/sensors/adxl362.html
index 5e203f272..688b3d624 100644
--- a/content/docs/latest/components/drivers/special/sensors/adxl362.html
+++ b/content/docs/latest/components/drivers/special/sensors/adxl362.html
@@ -169,6 +169,7 @@
<li class="toctree-l5"><a class="reference internal"
href="lsm6dso32.html">LSM6DSO32</a></li>
<li class="toctree-l5"><a class="reference internal"
href="lis2mdl.html">LIS2MDL</a></li>
<li class="toctree-l5"><a class="reference internal"
href="l86xxx.html">L86-XXX</a></li>
+<li class="toctree-l5"><a class="reference internal"
href="gnss_lowerhalf.html">GNSS Lower Half uORB Driver</a></li>
</ul>
</li>
<li class="toctree-l4"><a class="reference internal"
href="../segger.html">Segger RTT drivers</a></li>
diff --git
a/content/docs/latest/components/drivers/special/sensors/adxl372.html
b/content/docs/latest/components/drivers/special/sensors/adxl372.html
index 81ad1bcad..704b5114b 100644
--- a/content/docs/latest/components/drivers/special/sensors/adxl372.html
+++ b/content/docs/latest/components/drivers/special/sensors/adxl372.html
@@ -169,6 +169,7 @@
<li class="toctree-l5"><a class="reference internal"
href="lsm6dso32.html">LSM6DSO32</a></li>
<li class="toctree-l5"><a class="reference internal"
href="lis2mdl.html">LIS2MDL</a></li>
<li class="toctree-l5"><a class="reference internal"
href="l86xxx.html">L86-XXX</a></li>
+<li class="toctree-l5"><a class="reference internal"
href="gnss_lowerhalf.html">GNSS Lower Half uORB Driver</a></li>
</ul>
</li>
<li class="toctree-l4"><a class="reference internal"
href="../segger.html">Segger RTT drivers</a></li>
diff --git a/content/docs/latest/components/drivers/special/sensors/aht10.html
b/content/docs/latest/components/drivers/special/sensors/aht10.html
index 8ddc31fc9..30207f2e3 100644
--- a/content/docs/latest/components/drivers/special/sensors/aht10.html
+++ b/content/docs/latest/components/drivers/special/sensors/aht10.html
@@ -169,6 +169,7 @@
<li class="toctree-l5"><a class="reference internal"
href="lsm6dso32.html">LSM6DSO32</a></li>
<li class="toctree-l5"><a class="reference internal"
href="lis2mdl.html">LIS2MDL</a></li>
<li class="toctree-l5"><a class="reference internal"
href="l86xxx.html">L86-XXX</a></li>
+<li class="toctree-l5"><a class="reference internal"
href="gnss_lowerhalf.html">GNSS Lower Half uORB Driver</a></li>
</ul>
</li>
<li class="toctree-l4"><a class="reference internal"
href="../segger.html">Segger RTT drivers</a></li>
diff --git
a/content/docs/latest/components/drivers/special/sensors/ak09912.html
b/content/docs/latest/components/drivers/special/sensors/ak09912.html
index bd1607746..e5fc4cc6a 100644
--- a/content/docs/latest/components/drivers/special/sensors/ak09912.html
+++ b/content/docs/latest/components/drivers/special/sensors/ak09912.html
@@ -169,6 +169,7 @@
<li class="toctree-l5"><a class="reference internal"
href="lsm6dso32.html">LSM6DSO32</a></li>
<li class="toctree-l5"><a class="reference internal"
href="lis2mdl.html">LIS2MDL</a></li>
<li class="toctree-l5"><a class="reference internal"
href="l86xxx.html">L86-XXX</a></li>
+<li class="toctree-l5"><a class="reference internal"
href="gnss_lowerhalf.html">GNSS Lower Half uORB Driver</a></li>
</ul>
</li>
<li class="toctree-l4"><a class="reference internal"
href="../segger.html">Segger RTT drivers</a></li>
diff --git
a/content/docs/latest/components/drivers/special/sensors/gnss_lowerhalf.html
b/content/docs/latest/components/drivers/special/sensors/gnss_lowerhalf.html
new file mode 100644
index 000000000..9bc3e66cc
--- /dev/null
+++ b/content/docs/latest/components/drivers/special/sensors/gnss_lowerhalf.html
@@ -0,0 +1,478 @@
+<!--
+ Documentation/_templates/layout.html
+
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership. The
+ ASF licenses this file to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance with the
+ License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+ WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+ License for the specific language governing permissions and limitations
+ under the License.
+-->
+
+
+
+<!DOCTYPE html>
+<html class="writer-html5" lang="en">
+<head>
+ <meta charset="utf-8" /><meta name="generator" content="Docutils 0.19:
https://docutils.sourceforge.io/" />
+
+ <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+ <title>GNSS Lower Half uORB Driver — NuttX latest documentation</title>
+ <link rel="stylesheet" type="text/css"
href="../../../../_static/pygments.css" />
+ <link rel="stylesheet" type="text/css"
href="../../../../_static/css/theme.css" />
+ <link rel="stylesheet" type="text/css"
href="../../../../_static/copybutton.css" />
+ <link rel="stylesheet" type="text/css"
href="../../../../_static/sphinx_collapse.css" />
+ <link rel="stylesheet" type="text/css"
href="../../../../_static/design-style.1e8bd061cd6da7fc9cf755528e8ffc24.min.css"
/>
+ <link rel="stylesheet" type="text/css"
href="../../../../_static/custom.css" />
+
+
+ <link rel="shortcut icon" href="../../../../_static/favicon.ico"/>
+ <script src="../../../../_static/jquery.js"></script>
+ <script
src="../../../../_static/_sphinx_javascript_frameworks_compat.js"></script>
+ <script data-url_root="../../../../" id="documentation_options"
src="../../../../_static/documentation_options.js"></script>
+ <script src="../../../../_static/doctools.js"></script>
+ <script src="../../../../_static/sphinx_highlight.js"></script>
+ <script src="../../../../_static/clipboard.min.js"></script>
+ <script src="../../../../_static/copybutton.js"></script>
+ <script src="../../../../_static/design-tabs.js"></script>
+ <script src="../../../../_static/js/theme.js"></script>
+ <link rel="index" title="Index" href="../../../../genindex.html" />
+ <link rel="search" title="Search" href="../../../../search.html" />
+ <link rel="next" title="Segger RTT drivers" href="../segger.html" />
+ <link rel="prev" title="L86-XXX" href="l86xxx.html" />
+</head>
+
+<body class="wy-body-for-nav">
+ <div class="wy-grid-for-nav">
+ <nav data-toggle="wy-nav-shift" class="wy-nav-side">
+ <div class="wy-side-scroll">
+ <div class="wy-side-nav-search" >
+
+ <a href="../../../../index.html" class="icon icon-home"> NuttX
+
+
+
+ </a>
+
+ <!-- this version selector is quite ugly, should be probably replaced by
something
+ more modern -->
+
+ <div class="version-selector">
+ <select onchange="javascript:location.href = this.value;">
+
+ <option value="../../../../../latest" selected="selected">latest</option>
+
+ <option value="../../../../../10.0.0" >10.0.0</option>
+
+ <option value="../../../../../10.0.1" >10.0.1</option>
+
+ <option value="../../../../../10.1.0" >10.1.0</option>
+
+ <option value="../../../../../10.2.0" >10.2.0</option>
+
+ <option value="../../../../../10.3.0" >10.3.0</option>
+
+ <option value="../../../../../11.0.0" >11.0.0</option>
+
+ <option value="../../../../../12.0.0" >12.0.0</option>
+
+ <option value="../../../../../12.1.0" >12.1.0</option>
+
+ <option value="../../../../../12.2.0" >12.2.0</option>
+
+ <option value="../../../../../12.2.1" >12.2.1</option>
+
+ <option value="../../../../../12.3.0" >12.3.0</option>
+
+ <option value="../../../../../12.4.0" >12.4.0</option>
+
+ <option value="../../../../../12.5.0" >12.5.0</option>
+
+ <option value="../../../../../12.5.1" >12.5.1</option>
+
+ <option value="../../../../../12.6.0" >12.6.0</option>
+
+ <option value="../../../../../12.7.0" >12.7.0</option>
+
+ <option value="../../../../../12.8.0" >12.8.0</option>
+
+ <option value="../../../../../12.9.0" >12.9.0</option>
+
+ <option value="../../../../../12.10.0" >12.10.0</option>
+
+ </select>
+ </div>
+
+
+<div role="search">
+ <form id="rtd-search-form" class="wy-form" action="../../../../search.html"
method="get">
+ <input type="text" name="q" placeholder="Search docs" aria-label="Search
docs" />
+ <input type="hidden" name="check_keywords" value="yes" />
+ <input type="hidden" name="area" value="default" />
+ </form>
+</div>
+
+ </div><div class="wy-menu wy-menu-vertical" data-spy="affix"
role="navigation" aria-label="Navigation menu">
+ <p class="caption" role="heading"><span
class="caption-text">Table of Contents</span></p>
+<ul class="current">
+<li class="toctree-l1"><a class="reference internal"
href="../../../../index.html">Home</a></li>
+<li class="toctree-l1"><a class="reference internal"
href="../../../../introduction/index.html">Introduction</a></li>
+<li class="toctree-l1"><a class="reference internal"
href="../../../../quickstart/index.html">Getting Started</a></li>
+<li class="toctree-l1"><a class="reference internal"
href="../../../../contributing/index.html">Contributing</a></li>
+<li class="toctree-l1"><a class="reference internal"
href="../../../../introduction/inviolables.html">The Inviolable Principles of
NuttX</a></li>
+<li class="toctree-l1"><a class="reference internal"
href="../../../../platforms/index.html">Supported Platforms</a></li>
+<li class="toctree-l1 current"><a class="reference internal"
href="../../../index.html">OS Components</a><ul class="current">
+<li class="toctree-l2"><a class="reference internal"
href="../../../binfmt.html">Binary Loader</a></li>
+<li class="toctree-l2 current"><a class="reference internal"
href="../../index.html">Device Drivers</a><ul class="current">
+<li class="toctree-l3"><a class="reference internal"
href="../../character/index.html">Character Device Drivers</a></li>
+<li class="toctree-l3"><a class="reference internal"
href="../../block/index.html">Block Device Drivers</a></li>
+<li class="toctree-l3 current"><a class="reference internal"
href="../index.html">Specialized Device Drivers</a><ul class="current">
+<li class="toctree-l4"><a class="reference internal"
href="../audio.html">Audio Device Drivers</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../clk.html">Clock
management (CLK)</a></li>
+<li class="toctree-l4"><a class="reference internal"
href="../devicetree.html">Device Tree support</a></li>
+<li class="toctree-l4"><a class="reference internal"
href="../devmem.html">DEVMEM Drivers</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../dma.html">DMA
Drivers</a></li>
+<li class="toctree-l4"><a class="reference internal"
href="../framebuffer.html">Frame Buffer Drivers</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../i2c.html">I2C
Device Drivers</a></li>
+<li class="toctree-l4"><a class="reference internal"
href="../i2c.html#i2c-slave-device-drivers">I2C Slave Device Drivers</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../i3c.html">I3C
Device Drivers</a></li>
+<li class="toctree-l4"><a class="reference internal"
href="../ioexpander.html">IO Expander Device Drivers</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../lcd.html">LCD
Character Drivers</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../mtd.html">Memory
Technology Device Drivers</a></li>
+<li class="toctree-l4"><a class="reference internal"
href="../regmap.html">drivers/regmap</a></li>
+<li class="toctree-l4"><a class="reference internal"
href="../reset.html">Reset Driver</a></li>
+<li class="toctree-l4"><a class="reference internal"
href="../rptun.html">Remote Proc Tunnel Drivers</a></li>
+<li class="toctree-l4"><a class="reference internal"
href="../rwbuffer.html"><code class="docutils literal notranslate"><span
class="pre">rwbuffer.c</span></code></a></li>
+<li class="toctree-l4 current"><a class="reference internal"
href="../sensors.html">Sensor Drivers</a><ul class="current">
+<li class="toctree-l5"><a class="reference internal"
href="sensors_uorb.html">Sensor “uORB” Drivers</a></li>
+<li class="toctree-l5"><a class="reference internal"
href="sensors_legacy.html">Sensor Legacy Drivers</a></li>
+<li class="toctree-l5"><a class="reference internal"
href="sensors_cluster.html">Sensor Cluster (Obsolete)</a></li>
+<li class="toctree-l5"><a class="reference internal"
href="adt7320.html">ADT7320</a></li>
+<li class="toctree-l5"><a class="reference internal"
href="adxl345.html">ADXL345</a></li>
+<li class="toctree-l5"><a class="reference internal"
href="adxl362.html">ADXL362</a></li>
+<li class="toctree-l5"><a class="reference internal"
href="adxl372.html">ADXL372</a></li>
+<li class="toctree-l5"><a class="reference internal"
href="aht10.html">AHT10</a></li>
+<li class="toctree-l5"><a class="reference internal"
href="ak09912.html">AK09912</a></li>
+<li class="toctree-l5"><a class="reference internal"
href="lsm330.html">LSM330_SPI</a></li>
+<li class="toctree-l5"><a class="reference internal"
href="mcp9600.html">MCP9600</a></li>
+<li class="toctree-l5"><a class="reference internal"
href="mpl115a.html">MPL115A</a></li>
+<li class="toctree-l5"><a class="reference internal"
href="nau7802.html">NAU7802</a></li>
+<li class="toctree-l5"><a class="reference internal"
href="sht4x.html">SHT4X</a></li>
+<li class="toctree-l5"><a class="reference internal"
href="lsm6dso32.html">LSM6DSO32</a></li>
+<li class="toctree-l5"><a class="reference internal"
href="lis2mdl.html">LIS2MDL</a></li>
+<li class="toctree-l5"><a class="reference internal"
href="l86xxx.html">L86-XXX</a></li>
+<li class="toctree-l5 current"><a class="current reference internal"
href="#">GNSS Lower Half uORB Driver</a></li>
+</ul>
+</li>
+<li class="toctree-l4"><a class="reference internal"
href="../segger.html">Segger RTT drivers</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../spi.html">SPI
Device Drivers</a></li>
+<li class="toctree-l4"><a class="reference internal"
href="../syslog.html">SYSLOG</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../sdio.html">SDIO
Device Drivers</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../usbdev.html">USB
Device-Side Drivers</a></li>
+<li class="toctree-l4"><a class="reference internal"
href="../usbhost.html">USB Host-Side Drivers</a></li>
+<li class="toctree-l4"><a class="reference internal"
href="../usbmisc.html">USB Miscellaneous Drivers</a></li>
+<li class="toctree-l4"><a class="reference internal"
href="../usbmonitor.html">USB Monitor support</a></li>
+<li class="toctree-l4"><a class="reference internal"
href="../usrsock.html">Usrsock Driver</a></li>
+<li class="toctree-l4"><a class="reference internal"
href="../mmcsd.html">MMCSD Device Drivers</a></li>
+<li class="toctree-l4"><a class="reference internal"
href="../net/index.html">Network interface drivers</a></li>
+<li class="toctree-l4"><a class="reference internal"
href="../pci/index.html">PCI(e) Bus Drivers</a></li>
+<li class="toctree-l4"><a class="reference internal"
href="../pinctrl.html">Pinctrl Device Drivers</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../pipes.html">FIFO
and named pipe drivers</a></li>
+<li class="toctree-l4"><a class="reference internal"
href="../power/index.html">Power-related Drivers</a></li>
+<li class="toctree-l4"><a class="reference internal"
href="../virtio.html">Virtio Device Drivers</a></li>
+<li class="toctree-l4"><a class="reference internal"
href="../video.html">Video Device Drivers</a></li>
+<li class="toctree-l4"><a class="reference internal"
href="../wireless.html">Wireless Drivers</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal"
href="../../thermal/index.html">Thermal Framework</a></li>
+<li class="toctree-l3"><a class="reference internal"
href="../../index.html#lower-half-and-upper-half">Lower-half and
upper-half</a></li>
+<li class="toctree-l3"><a class="reference internal"
href="../../index.html#subdirectories-of-nuttx-drivers">Subdirectories of <code
class="docutils literal notranslate"><span
class="pre">nuttx/drivers</span></code></a></li>
+<li class="toctree-l3"><a class="reference internal"
href="../../index.html#skeleton-files">Skeleton Files</a></li>
+<li class="toctree-l3"><a class="reference internal"
href="../../index.html#drivers-early-initialization">Drivers Early
Initialization</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal"
href="../../../nxflat.html">NXFLAT</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="../../../nxgraphics/index.html">NX Graphics Subsystem</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="../../../paging.html">On-Demand Paging</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="../../../audio/index.html">Audio Subsystem</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="../../../filesystem/index.html">NuttX File System</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="../../../libs/index.html">NuttX libraries</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="../../../net/index.html">Network Support</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="../../../mm/index.html">Memory Management</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="../../../syscall.html">Syscall Layer</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="../../../tools/index.html"><code class="docutils literal
notranslate"><span class="pre">/tools</span></code> Host Tools</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="../../../arch/index.html">Architecture-Specific Code</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="../../../boards.html">Boards Support</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="../../../cmake.html">CMake Support</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="../../../openamp.html">OpenAMP Support</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="../../../video.html">Video Subsystem</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="../../../crypto.html">Crypto API Subsystem</a></li>
+<li class="toctree-l2"><a class="reference internal"
href="../../../wireless.html">Wireless Subsystem</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal"
href="../../../../applications/index.html">Applications</a></li>
+<li class="toctree-l1"><a class="reference internal"
href="../../../../implementation/index.html">Implementation Details</a></li>
+<li class="toctree-l1"><a class="reference internal"
href="../../../../reference/index.html">API Reference</a></li>
+<li class="toctree-l1"><a class="reference internal"
href="../../../../faq/index.html">FAQ</a></li>
+<li class="toctree-l1"><a class="reference internal"
href="../../../../debugging/index.html">Debugging</a></li>
+<li class="toctree-l1"><a class="reference internal"
href="../../../../guides/index.html">Guides</a></li>
+<li class="toctree-l1"><a class="reference internal"
href="../../../../standards/index.html">Standards</a></li>
+<li class="toctree-l1"><a class="reference internal"
href="../../../../glossary.html">Glossary</a></li>
+<li class="toctree-l1"><a class="reference internal"
href="../../../../logos/index.html">NuttX Logos</a></li>
+<li class="toctree-l1"><a class="reference internal"
href="../../../../_tags/tagsindex.html">Tags</a></li>
+</ul>
+
+ </div>
+ </div>
+ </nav>
+
+ <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav
class="wy-nav-top" aria-label="Mobile navigation menu" >
+ <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+ <a href="../../../../index.html">NuttX</a>
+ </nav>
+
+ <div class="wy-nav-content">
+ <div class="rst-content">
+ <div role="navigation" aria-label="Page navigation">
+ <ul class="wy-breadcrumbs">
+ <li><a href="../../../../index.html" class="icon icon-home"
aria-label="Home"></a></li>
+ <li class="breadcrumb-item"><a href="../../../index.html">OS
Components</a></li>
+ <li class="breadcrumb-item"><a href="../../index.html">Device
Drivers</a></li>
+ <li class="breadcrumb-item"><a href="../index.html">Specialized
Device Drivers</a></li>
+ <li class="breadcrumb-item"><a href="../sensors.html">Sensor
Drivers</a></li>
+ <li class="breadcrumb-item active">GNSS Lower Half uORB Driver</li>
+ <li class="wy-breadcrumbs-aside">
+ <a
href="https://github.com/apache/nuttx/blob/master/Documentation/components/drivers/special/sensors/gnss_lowerhalf.rst"
class="fa fa-github"> Edit on GitHub</a>
+ </li>
+ </ul>
+ <hr/>
+</div>
+ <div role="main" class="document" itemscope="itemscope"
itemtype="http://schema.org/Article">
+ <div itemprop="articleBody">
+
+ <section id="gnss-lower-half-uorb-driver">
+<h1>GNSS Lower Half uORB Driver<a class="headerlink"
href="#gnss-lower-half-uorb-driver" title="Permalink to this heading"></a></h1>
+<p>The GNSS lower half driver is used to create uORB drivers for GNSS/GPS
devices.
+The upper-half driver abstracts away the parsing and advertising of NMEA data
+from the device. The way this lower-half is instantiated is similar to lower
+half drivers in the <a class="reference internal"
href="sensors_uorb.html"><span class="doc">uORB framework</span></a>.</p>
+<p>For an example on how to use this lower-half, see
+<cite></components/drivers/special/sensors/l86xxx></cite></p>
+<section id="application-programming-interface">
+<h2>Application Programming Interface<a class="headerlink"
href="#application-programming-interface" title="Permalink to this
heading"></a></h2>
+<p>To use the GNSS lower half in your driver, just include the following
header:</p>
+<div class="highlight-c notranslate"><div
class="highlight"><pre><span></span><span class="cp">#include</span><span
class="w"> </span><span class="cpf"><nuttx/sensors/gnss.h></span>
+</pre></div>
+</div>
+<p>The GNSS driver works similarly to the uORB lower-half driver, where you
must
+implement several operations for the upper-half to work. The first step is
+defining a custom type for your GNSS device, which must include a reference to
+the lower-half struct. In this case, the device is UART based, so several
+members are included to facilitate its operation.</p>
+<div class="highlight-c notranslate"><div
class="highlight"><pre><span></span><span class="cm">/* Custom GNSS device type
*/</span>
+
+<span class="k">typedef</span><span class="w"> </span><span
class="k">struct</span>
+<span class="p">{</span>
+<span class="w"> </span><span class="n">FAR</span><span class="w">
</span><span class="k">struct</span><span class="w"> </span><span
class="nc">file</span><span class="w"> </span><span class="n">uart</span><span
class="p">;</span><span class="w"> </span><span class="cm">/* UART
interface to get data */</span>
+<span class="w"> </span><span class="k">struct</span><span class="w">
</span><span class="nc">gnss_lowerhalf_s</span><span class="w"> </span><span
class="n">lower</span><span class="p">;</span><span class="w"> </span><span
class="cm">/* GNSS lower-half */</span>
+<span class="w"> </span><span class="kt">bool</span><span class="w">
</span><span class="n">enabled</span><span class="p">;</span><span class="w">
</span><span class="cm">/* Enabled state */</span>
+<span class="w"> </span><span class="kt">char</span><span class="w">
</span><span class="n">buffer</span><span class="p">[</span><span
class="mi">256</span><span class="p">];</span><span class="w">
</span><span class="cm">/* UART read buffer */</span>
+<span class="w"> </span><span class="n">mutex_t</span><span class="w">
</span><span class="n">lock</span><span class="p">;</span><span class="w">
</span><span class="cm">/* Device lock */</span>
+<span class="w"> </span><span class="n">sem_t</span><span class="w">
</span><span class="n">run</span><span class="p">;</span><span class="w">
</span><span class="cm">/* Start/stop kthread */</span>
+<span class="p">}</span><span class="w"> </span><span
class="n">my_gnss_dev_s</span><span class="p">;</span>
+</pre></div>
+</div>
+<p>Then, you can create the operations table.</p>
+<div class="highlight-c notranslate"><div
class="highlight"><pre><span></span><span class="k">static</span><span
class="w"> </span><span class="k">const</span><span class="w"> </span><span
class="k">struct</span><span class="w"> </span><span
class="nc">gnss_ops_s</span><span class="w"> </span><span
class="n">g_gnss_ops</span><span class="w"> </span><span class="o">=</span>
+<span class="p">{</span>
+<span class="w"> </span><span class="p">.</span><span
class="n">control</span><span class="w"> </span><span class="o">=</span><span
class="w"> </span><span class="n">my_gnss_control</span><span class="p">,</span>
+<span class="w"> </span><span class="p">.</span><span
class="n">activate</span><span class="w"> </span><span class="o">=</span><span
class="w"> </span><span class="n">my_gnss_activate</span><span
class="p">,</span>
+<span class="w"> </span><span class="p">.</span><span
class="n">set_interval</span><span class="w"> </span><span
class="o">=</span><span class="w"> </span><span
class="n">my_gnss_set_interval</span><span class="p">,</span>
+<span class="p">}</span>
+</pre></div>
+</div>
+<p>These functions are very similar to the functions that you use for
implementing
+a uORB lower-half.</p>
+<ul class="simple">
+<li><p>The <code class="docutils literal notranslate"><span
class="pre">control</span></code> function is used to handle <code
class="docutils literal notranslate"><span class="pre">IOCTL</span></code>
commands that aren’t
+implemented by the upper-half</p></li>
+<li><p>The <code class="docutils literal notranslate"><span
class="pre">activate</span></code> function is used to enable/disable the
device so that is
+saves power when not in use</p></li>
+<li><p>The <code class="docutils literal notranslate"><span
class="pre">set_interval</span></code> function is used to set the sampling
rate</p></li>
+</ul>
+<p>It is up to you to implement these functions so that they meet the
requirements
+of the upper-half driver.</p>
+<p>For this implementation, because we are reading data from a UART interface,
we
+will read from the <code class="docutils literal notranslate"><span
class="pre">uart</span></code> member of our <code class="docutils literal
notranslate"><span class="pre">my_gnss_dev_s</span></code> struct into our read
+buffer. This takes place in a kernel thread, which polls the UART interface.
+Once the data is read, we just have to send it to the upper-half to parse and
+publish as uORB data.</p>
+<p>The data we provide to the upper-half does not have to be null-terminated
+strings, or even a complete NMEA sentence. The upper-half will parse as it
goes,
+and wait until it has a full sentence in its own buffer before parsing.</p>
+<p>Here is an excerpt of how to publish that data:</p>
+<div class="highlight-c notranslate"><div
class="highlight"><pre><span></span><span class="cm">/* `dev` is a reference to
our `my_gnss_dev_s` struct */</span>
+
+<span class="n">err</span><span class="w"> </span><span
class="o">=</span><span class="w"> </span><span
class="n">nxmutex_lock</span><span class="p">(</span><span
class="o">&</span><span class="n">dev</span><span
class="o">-></span><span class="n">lock</span><span class="p">);</span>
+<span class="k">if</span><span class="w"> </span><span class="p">(</span><span
class="n">err</span><span class="w"> </span><span class="o"><</span><span
class="w"> </span><span class="mi">0</span><span class="p">)</span>
+<span class="w"> </span><span class="p">{</span>
+<span class="w"> </span><span class="n">snerr</span><span
class="p">(</span><span class="s">"Couldn't lock mutex</span><span
class="se">\n</span><span class="s">"</span><span class="p">);</span>
+<span class="w"> </span><span class="k">return</span><span class="w">
</span><span class="n">err</span><span class="p">;</span>
+<span class="w"> </span><span class="p">}</span>
+
+<span class="n">bw</span><span class="w"> </span><span class="o">=</span><span
class="w"> </span><span class="n">file_read</span><span class="p">(</span><span
class="o">&</span><span class="n">dev</span><span
class="o">-></span><span class="n">uart</span><span class="p">,</span><span
class="w"> </span><span class="n">dev</span><span class="o">-></span><span
class="n">buffer</span><span class="p">,</span><span class="w"> </span><span
class="k">sizeof</span><span class="p">(</spa [...]
+
+<span class="k">if</span><span class="w"> </span><span class="p">(</span><span
class="n">bw</span><span class="w"> </span><span class="o"><=</span><span
class="w"> </span><span class="mi">0</span><span class="p">)</span>
+<span class="w"> </span><span class="p">{</span>
+<span class="w"> </span><span class="n">snerr</span><span
class="p">(</span><span class="s">"No data on UART: %d</span><span
class="se">\n</span><span class="s">"</span><span class="p">,</span><span
class="w"> </span><span class="n">bw</span><span class="p">);</span>
+<span class="w"> </span><span class="n">nxmutex_unlock</span><span
class="p">(</span><span class="o">&</span><span class="n">dev</span><span
class="o">-></span><span class="n">lock</span><span class="p">);</span>
+<span class="w"> </span><span class="k">continue</span><span
class="p">;</span>
+<span class="w"> </span><span class="p">}</span>
+
+<span class="cm">/* Send data read to the lower half for parsing. Does not
need to be a</span>
+<span class="cm"> * full NMEA sentence to be handled.</span>
+<span class="cm"> */</span>
+
+<span class="k">if</span><span class="w"> </span><span class="p">(</span><span
class="n">bw</span><span class="w"> </span><span class="o">></span><span
class="w"> </span><span class="mi">0</span><span class="p">)</span>
+<span class="w"> </span><span class="p">{</span>
+<span class="w"> </span><span class="n">dev</span><span
class="o">-></span><span class="n">lower</span><span class="p">.</span><span
class="n">push_data</span><span class="p">(</span><span
class="n">dev</span><span class="o">-></span><span
class="n">lower</span><span class="p">.</span><span class="n">priv</span><span
class="p">,</span><span class="w"> </span><span class="n">dev</span><span
class="o">-></span><span class="n">buffer</span><span
class="p">,</span><span class="w" [...]
+<span class="w"> </span><span class="p">}</span>
+
+<span class="n">nxmutex_unlock</span><span class="p">(</span><span
class="o">&</span><span class="n">dev</span><span
class="o">-></span><span class="n">lock</span><span class="p">);</span>
+</pre></div>
+</div>
+<p>Once all of the above has been implemented, in your driver’s registration
+function, you’ll need to initialize the structure to your GNSS device in the
+registration function.</p>
+<div class="highlight-c notranslate"><div
class="highlight"><pre><span></span><span class="cm">/* Registration function
for this device type */</span>
+
+<span class="kt">int</span><span class="w"> </span><span
class="nf">mygnss_register</span><span class="p">(</span><span
class="n">FAR</span><span class="w"> </span><span class="kt">char</span><span
class="w"> </span><span class="k">const</span><span class="w"> </span><span
class="o">*</span><span class="n">uartpath</span><span class="p">,</span><span
class="w"> </span><span class="kt">int</span><span class="w"> </span><span
class="n">devno</span><span class="p">)</span>
+<span class="p">{</span>
+<span class="w"> </span><span class="n">FAR</span><span class="w">
</span><span class="n">mygnss_dev_s</span><span class="w"> </span><span
class="o">*</span><span class="n">priv</span><span class="p">;</span>
+<span class="w"> </span><span class="kt">int</span><span class="w">
</span><span class="n">err</span><span class="p">;</span>
+<span class="w"> </span><span class="kt">uint32_t</span><span class="w">
</span><span class="n">nbuffers</span><span class="p">[</span><span
class="n">SENSOR_GNSS_IDX_GNSS_MAX</span><span class="p">];</span>
+
+<span class="w"> </span><span class="cm">/* This is a bare example not
considering error handling */</span>
+
+<span class="w"> </span><span class="n">priv</span><span class="w">
</span><span class="o">=</span><span class="w"> </span><span
class="n">kmm_zalloc</span><span class="p">(</span><span
class="k">sizeof</span><span class="p">(</span><span
class="n">my_gnss_dev_s</span><span class="p">));</span>
+
+<span class="w"> </span><span class="cm">/* Initialize whatever specific
members of your device struct need</span>
+<span class="cm"> * initializing here...</span>
+<span class="cm"> */</span>
+
+<span class="w"> </span><span class="n">priv</span><span
class="o">-></span><span class="n">lower</span><span class="p">.</span><span
class="n">ops</span><span class="w"> </span><span class="o">=</span><span
class="w"> </span><span class="o">&</span><span
class="n">g_gnss_ops</span><span class="p">;</span><span class="w">
</span><span class="cm">/* Ops table */</span>
+<span class="w"> </span><span class="n">priv</span><span
class="o">-></span><span class="n">lower</span><span class="p">.</span><span
class="n">priv</span><span class="w"> </span><span class="o">=</span><span
class="w"> </span><span class="n">priv</span><span class="p">;</span><span
class="w"> </span><span class="cm">/* Reference to your lower-half */</span>
+
+<span class="w"> </span><span class="cm">/* This selects the buffer sizes
for each of the buffers that handle these</span>
+<span class="cm"> * sets of events. The index macros are included in the
gnss header file</span>
+<span class="cm"> */</span>
+
+<span class="w"> </span><span class="n">nbuffers</span><span
class="p">[</span><span class="n">SENSOR_GNSS_IDX_GNSS</span><span
class="p">]</span><span class="w"> </span><span class="o">=</span><span
class="w"> </span><span class="mi">1</span><span class="p">;</span>
+<span class="w"> </span><span class="n">nbuffers</span><span
class="p">[</span><span class="n">SENSOR_GNSS_IDX_GNSS_SATELLITE</span><span
class="p">]</span><span class="w"> </span><span class="o">=</span><span
class="w"> </span><span class="mi">1</span><span class="p">;</span>
+<span class="w"> </span><span class="n">nbuffers</span><span
class="p">[</span><span class="n">SENSOR_GNSS_IDX_GNSS_MEASUREMENT</span><span
class="p">]</span><span class="w"> </span><span class="o">=</span><span
class="w"> </span><span class="mi">1</span><span class="p">;</span>
+<span class="w"> </span><span class="n">nbuffers</span><span
class="p">[</span><span class="n">SENSOR_GNSS_IDX_GNSS_CLOCK</span><span
class="p">]</span><span class="w"> </span><span class="o">=</span><span
class="w"> </span><span class="mi">1</span><span class="p">;</span>
+<span class="w"> </span><span class="n">nbuffers</span><span
class="p">[</span><span class="n">SENSOR_GNSS_IDX_GNSS_GEOFENCE</span><span
class="p">]</span><span class="w"> </span><span class="o">=</span><span
class="w"> </span><span class="mi">1</span><span class="p">;</span>
+
+<span class="w"> </span><span class="cm">/* Register the lower-half driver
with our information.</span>
+<span class="cm"> * `SENSOR_GNSS_IDX_GNSS_MAX` is the length of our
`nbuffers` array.</span>
+<span class="cm"> */</span>
+
+<span class="w"> </span><span class="n">err</span><span class="w">
</span><span class="o">=</span>
+<span class="w"> </span><span class="n">gnss_register</span><span
class="p">(</span><span class="o">&</span><span class="n">priv</span><span
class="o">-></span><span class="n">lower</span><span class="p">,</span><span
class="w"> </span><span class="n">devno</span><span class="p">,</span><span
class="w"> </span><span class="n">nbuffers</span><span class="p">,</span><span
class="w"> </span><span class="n">SENSOR_GNSS_IDX_GNSS_MAX</span><span
class="p">);</span>
+<span class="w"> </span><span class="k">if</span><span class="w">
</span><span class="p">(</span><span class="n">err</span><span class="w">
</span><span class="o"><</span><span class="w"> </span><span
class="mi">0</span><span class="p">)</span>
+<span class="w"> </span><span class="p">{</span>
+<span class="w"> </span><span class="n">snerr</span><span
class="p">(</span><span class="s">"Failed to register myGNSS driver:
%d</span><span class="se">\n</span><span class="s">"</span><span
class="p">,</span><span class="w"> </span><span class="n">err</span><span
class="p">);</span>
+<span class="w"> </span><span class="cm">/* You should handle the error
by cleaning up resources */</span>
+<span class="w"> </span><span class="p">}</span>
+
+<span class="w"> </span><span class="cm">/* Here, handle starting up your
kernel thread and any other error</span>
+<span class="cm"> * cleanup.</span>
+<span class="cm"> */</span>
+
+<span class="w"> </span><span class="k">return</span><span class="w">
</span><span class="n">err</span><span class="p">;</span>
+<span class="p">}</span>
+</pre></div>
+</div>
+</section>
+<section id="registration-in-device-code">
+<h2>Registration in Device Code<a class="headerlink"
href="#registration-in-device-code" title="Permalink to this heading"></a></h2>
+<p>To register the driver in device code, simply call the registration
function you
+wrote. You’ll have to include your header file.</p>
+<div class="highlight-c notranslate"><div
class="highlight"><pre><span></span><span class="cp">#if
defined(CONFIG_SENSORS_MYGNSS) </span><span class="cm">/* Change for your GNSS
driver */</span>
+<span class="cp">#include</span><span class="w"> </span><span
class="cpf"><nuttx/sensors/mygnss.h></span>
+<span class="cp">#endif</span>
+
+<span class="cm">/* Put this inside your board's real bringup function,
where other drivers</span>
+<span class="cm"> * are being registered.</span>
+<span class="cm"> */</span>
+
+<span class="kt">int</span><span class="w"> </span><span
class="nf">my_board_bringup</span><span class="p">(</span><span
class="kt">void</span><span class="p">)</span>
+<span class="p">{</span>
+<span class="w"> </span><span class="cp">#if
defined(CONFIG_SENSORS_MYGNSS)</span>
+<span class="w"> </span><span class="cm">/* Register myGNSS on USART0
*/</span>
+
+<span class="w"> </span><span class="n">ret</span><span class="w">
</span><span class="o">=</span><span class="w"> </span><span
class="n">l86xxx_register</span><span class="p">(</span><span
class="s">"/dev/ttyS0"</span><span class="p">,</span><span class="w">
</span><span class="mi">0</span><span class="p">);</span>
+<span class="w"> </span><span class="k">if</span><span class="w">
</span><span class="p">(</span><span class="n">ret</span><span class="w">
</span><span class="o"><</span><span class="w"> </span><span
class="mi">0</span><span class="p">)</span><span class="w"> </span><span
class="p">{</span>
+<span class="w"> </span><span class="n">syslog</span><span
class="p">(</span><span class="n">LOG_ERR</span><span class="p">,</span><span
class="w"> </span><span class="s">"Failed to register myGNSS driver:
%d</span><span class="se">\n</span><span class="s">"</span><span
class="p">,</span><span class="w"> </span><span class="n">ret</span><span
class="p">);</span>
+<span class="w"> </span><span class="p">}</span>
+<span class="w"> </span><span class="cp">#endif</span>
+<span class="p">}</span>
+</pre></div>
+</div>
+</section>
+<section id="operation">
+<h2>Operation<a class="headerlink" href="#operation" title="Permalink to this
heading"></a></h2>
+<p>Now you should see several different uORB GNSS topics get published under
+<code class="docutils literal notranslate"><span
class="pre">/dev/uorb</span></code>. These correspond to all of the different
buffer types you
+initialized earlier, like geofence, clock, statellite, etc. The plain
+<code class="docutils literal notranslate"><span
class="pre">sensor_gnss</span></code> device will publish lots of data from the
NMEA sentences.</p>
+<p>You can use the <code class="docutils literal notranslate"><span
class="pre">uorb_listener</span></code> application
+(<a class="reference internal"
href="../../../../applications/system/uorb/index.html"><span class="doc">uorb
uorb(micro object request broker)</span></a>) to see if data is being published
+correctly.</p>
+<div class="highlight-console notranslate"><div
class="highlight"><pre><span></span><span class="go">nsh> uorb_listener
sensor_gnss</span>
+
+<span class="go">Monitor objects num:2</span>
+<span class="go">object_name:sensor_gnss, object_instance:0</span>
+<span
class="go">sensor_gnss(now:237030000):timestamp:237030000,time_utc:1753502745,latitude:xxxxxxxx,longitude:xxxxxxxxxx,altitude:36.900002,altitude_ellipsoid:24.200001,0</span>
+</pre></div>
+</div>
+</section>
+</section>
+
+
+ </div>
+ </div>
+ <footer><div class="rst-footer-buttons" role="navigation"
aria-label="Footer">
+ <a href="l86xxx.html" class="btn btn-neutral float-left"
title="L86-XXX" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left"
aria-hidden="true"></span> Previous</a>
+ <a href="../segger.html" class="btn btn-neutral float-right"
title="Segger RTT drivers" accesskey="n" rel="next">Next <span class="fa
fa-arrow-circle-right" aria-hidden="true"></span></a>
+ </div>
+
+ <hr/>
+
+ <div role="contentinfo">
+ <p>© Copyright 2023, The Apache Software Foundation.</p>
+ </div>
+
+
+
+</footer>
+ </div>
+ </div>
+ </section>
+ </div>
+ <script>
+ jQuery(function () {
+ SphinxRtdTheme.Navigation.enable(true);
+ });
+ </script>
+
+</body>
+</html>
\ No newline at end of file
diff --git a/content/docs/latest/components/drivers/special/sensors/l86xxx.html
b/content/docs/latest/components/drivers/special/sensors/l86xxx.html
index 060044ecc..a05755bd9 100644
--- a/content/docs/latest/components/drivers/special/sensors/l86xxx.html
+++ b/content/docs/latest/components/drivers/special/sensors/l86xxx.html
@@ -46,7 +46,7 @@
<script src="../../../../_static/js/theme.js"></script>
<link rel="index" title="Index" href="../../../../genindex.html" />
<link rel="search" title="Search" href="../../../../search.html" />
- <link rel="next" title="Segger RTT drivers" href="../segger.html" />
+ <link rel="next" title="GNSS Lower Half uORB Driver"
href="gnss_lowerhalf.html" />
<link rel="prev" title="LIS2MDL" href="lis2mdl.html" />
</head>
@@ -169,6 +169,7 @@
<li class="toctree-l5"><a class="reference internal"
href="lsm6dso32.html">LSM6DSO32</a></li>
<li class="toctree-l5"><a class="reference internal"
href="lis2mdl.html">LIS2MDL</a></li>
<li class="toctree-l5 current"><a class="current reference internal"
href="#">L86-XXX</a></li>
+<li class="toctree-l5"><a class="reference internal"
href="gnss_lowerhalf.html">GNSS Lower Half uORB Driver</a></li>
</ul>
</li>
<li class="toctree-l4"><a class="reference internal"
href="../segger.html">Segger RTT drivers</a></li>
@@ -435,7 +436,7 @@ Supported baud rates for the L86-XXX series of GNSS modules
are:</p>
</div>
<footer><div class="rst-footer-buttons" role="navigation"
aria-label="Footer">
<a href="lis2mdl.html" class="btn btn-neutral float-left"
title="LIS2MDL" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left"
aria-hidden="true"></span> Previous</a>
- <a href="../segger.html" class="btn btn-neutral float-right"
title="Segger RTT drivers" accesskey="n" rel="next">Next <span class="fa
fa-arrow-circle-right" aria-hidden="true"></span></a>
+ <a href="gnss_lowerhalf.html" class="btn btn-neutral float-right"
title="GNSS Lower Half uORB Driver" accesskey="n" rel="next">Next <span
class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
</div>
<hr/>
diff --git
a/content/docs/latest/components/drivers/special/sensors/lis2mdl.html
b/content/docs/latest/components/drivers/special/sensors/lis2mdl.html
index af1f3e8dc..e5a74916b 100644
--- a/content/docs/latest/components/drivers/special/sensors/lis2mdl.html
+++ b/content/docs/latest/components/drivers/special/sensors/lis2mdl.html
@@ -169,6 +169,7 @@
<li class="toctree-l5"><a class="reference internal"
href="lsm6dso32.html">LSM6DSO32</a></li>
<li class="toctree-l5 current"><a class="current reference internal"
href="#">LIS2MDL</a></li>
<li class="toctree-l5"><a class="reference internal"
href="l86xxx.html">L86-XXX</a></li>
+<li class="toctree-l5"><a class="reference internal"
href="gnss_lowerhalf.html">GNSS Lower Half uORB Driver</a></li>
</ul>
</li>
<li class="toctree-l4"><a class="reference internal"
href="../segger.html">Segger RTT drivers</a></li>
diff --git a/content/docs/latest/components/drivers/special/sensors/lsm330.html
b/content/docs/latest/components/drivers/special/sensors/lsm330.html
index a1ab7dc48..b3ae95c7c 100644
--- a/content/docs/latest/components/drivers/special/sensors/lsm330.html
+++ b/content/docs/latest/components/drivers/special/sensors/lsm330.html
@@ -169,6 +169,7 @@
<li class="toctree-l5"><a class="reference internal"
href="lsm6dso32.html">LSM6DSO32</a></li>
<li class="toctree-l5"><a class="reference internal"
href="lis2mdl.html">LIS2MDL</a></li>
<li class="toctree-l5"><a class="reference internal"
href="l86xxx.html">L86-XXX</a></li>
+<li class="toctree-l5"><a class="reference internal"
href="gnss_lowerhalf.html">GNSS Lower Half uORB Driver</a></li>
</ul>
</li>
<li class="toctree-l4"><a class="reference internal"
href="../segger.html">Segger RTT drivers</a></li>
diff --git
a/content/docs/latest/components/drivers/special/sensors/lsm6dso32.html
b/content/docs/latest/components/drivers/special/sensors/lsm6dso32.html
index 643fa2d1f..eed15fadb 100644
--- a/content/docs/latest/components/drivers/special/sensors/lsm6dso32.html
+++ b/content/docs/latest/components/drivers/special/sensors/lsm6dso32.html
@@ -169,6 +169,7 @@
<li class="toctree-l5 current"><a class="current reference internal"
href="#">LSM6DSO32</a></li>
<li class="toctree-l5"><a class="reference internal"
href="lis2mdl.html">LIS2MDL</a></li>
<li class="toctree-l5"><a class="reference internal"
href="l86xxx.html">L86-XXX</a></li>
+<li class="toctree-l5"><a class="reference internal"
href="gnss_lowerhalf.html">GNSS Lower Half uORB Driver</a></li>
</ul>
</li>
<li class="toctree-l4"><a class="reference internal"
href="../segger.html">Segger RTT drivers</a></li>
diff --git
a/content/docs/latest/components/drivers/special/sensors/mcp9600.html
b/content/docs/latest/components/drivers/special/sensors/mcp9600.html
index 84f5fe9f3..91296ba5e 100644
--- a/content/docs/latest/components/drivers/special/sensors/mcp9600.html
+++ b/content/docs/latest/components/drivers/special/sensors/mcp9600.html
@@ -169,6 +169,7 @@
<li class="toctree-l5"><a class="reference internal"
href="lsm6dso32.html">LSM6DSO32</a></li>
<li class="toctree-l5"><a class="reference internal"
href="lis2mdl.html">LIS2MDL</a></li>
<li class="toctree-l5"><a class="reference internal"
href="l86xxx.html">L86-XXX</a></li>
+<li class="toctree-l5"><a class="reference internal"
href="gnss_lowerhalf.html">GNSS Lower Half uORB Driver</a></li>
</ul>
</li>
<li class="toctree-l4"><a class="reference internal"
href="../segger.html">Segger RTT drivers</a></li>
diff --git
a/content/docs/latest/components/drivers/special/sensors/mpl115a.html
b/content/docs/latest/components/drivers/special/sensors/mpl115a.html
index 50828f28f..62ff408d8 100644
--- a/content/docs/latest/components/drivers/special/sensors/mpl115a.html
+++ b/content/docs/latest/components/drivers/special/sensors/mpl115a.html
@@ -169,6 +169,7 @@
<li class="toctree-l5"><a class="reference internal"
href="lsm6dso32.html">LSM6DSO32</a></li>
<li class="toctree-l5"><a class="reference internal"
href="lis2mdl.html">LIS2MDL</a></li>
<li class="toctree-l5"><a class="reference internal"
href="l86xxx.html">L86-XXX</a></li>
+<li class="toctree-l5"><a class="reference internal"
href="gnss_lowerhalf.html">GNSS Lower Half uORB Driver</a></li>
</ul>
</li>
<li class="toctree-l4"><a class="reference internal"
href="../segger.html">Segger RTT drivers</a></li>
diff --git
a/content/docs/latest/components/drivers/special/sensors/nau7802.html
b/content/docs/latest/components/drivers/special/sensors/nau7802.html
index 27fd0a08d..f572161e9 100644
--- a/content/docs/latest/components/drivers/special/sensors/nau7802.html
+++ b/content/docs/latest/components/drivers/special/sensors/nau7802.html
@@ -169,6 +169,7 @@
<li class="toctree-l5"><a class="reference internal"
href="lsm6dso32.html">LSM6DSO32</a></li>
<li class="toctree-l5"><a class="reference internal"
href="lis2mdl.html">LIS2MDL</a></li>
<li class="toctree-l5"><a class="reference internal"
href="l86xxx.html">L86-XXX</a></li>
+<li class="toctree-l5"><a class="reference internal"
href="gnss_lowerhalf.html">GNSS Lower Half uORB Driver</a></li>
</ul>
</li>
<li class="toctree-l4"><a class="reference internal"
href="../segger.html">Segger RTT drivers</a></li>
diff --git
a/content/docs/latest/components/drivers/special/sensors/sensors_cluster.html
b/content/docs/latest/components/drivers/special/sensors/sensors_cluster.html
index db616fe30..265ef60e7 100644
---
a/content/docs/latest/components/drivers/special/sensors/sensors_cluster.html
+++
b/content/docs/latest/components/drivers/special/sensors/sensors_cluster.html
@@ -169,6 +169,7 @@
<li class="toctree-l5"><a class="reference internal"
href="lsm6dso32.html">LSM6DSO32</a></li>
<li class="toctree-l5"><a class="reference internal"
href="lis2mdl.html">LIS2MDL</a></li>
<li class="toctree-l5"><a class="reference internal"
href="l86xxx.html">L86-XXX</a></li>
+<li class="toctree-l5"><a class="reference internal"
href="gnss_lowerhalf.html">GNSS Lower Half uORB Driver</a></li>
</ul>
</li>
<li class="toctree-l4"><a class="reference internal"
href="../segger.html">Segger RTT drivers</a></li>
diff --git
a/content/docs/latest/components/drivers/special/sensors/sensors_legacy.html
b/content/docs/latest/components/drivers/special/sensors/sensors_legacy.html
index d67962851..6386216a0 100644
--- a/content/docs/latest/components/drivers/special/sensors/sensors_legacy.html
+++ b/content/docs/latest/components/drivers/special/sensors/sensors_legacy.html
@@ -169,6 +169,7 @@
<li class="toctree-l5"><a class="reference internal"
href="lsm6dso32.html">LSM6DSO32</a></li>
<li class="toctree-l5"><a class="reference internal"
href="lis2mdl.html">LIS2MDL</a></li>
<li class="toctree-l5"><a class="reference internal"
href="l86xxx.html">L86-XXX</a></li>
+<li class="toctree-l5"><a class="reference internal"
href="gnss_lowerhalf.html">GNSS Lower Half uORB Driver</a></li>
</ul>
</li>
<li class="toctree-l4"><a class="reference internal"
href="../segger.html">Segger RTT drivers</a></li>
diff --git
a/content/docs/latest/components/drivers/special/sensors/sensors_uorb.html
b/content/docs/latest/components/drivers/special/sensors/sensors_uorb.html
index ef89ba932..8538e3c68 100644
--- a/content/docs/latest/components/drivers/special/sensors/sensors_uorb.html
+++ b/content/docs/latest/components/drivers/special/sensors/sensors_uorb.html
@@ -169,6 +169,7 @@
<li class="toctree-l5"><a class="reference internal"
href="lsm6dso32.html">LSM6DSO32</a></li>
<li class="toctree-l5"><a class="reference internal"
href="lis2mdl.html">LIS2MDL</a></li>
<li class="toctree-l5"><a class="reference internal"
href="l86xxx.html">L86-XXX</a></li>
+<li class="toctree-l5"><a class="reference internal"
href="gnss_lowerhalf.html">GNSS Lower Half uORB Driver</a></li>
</ul>
</li>
<li class="toctree-l4"><a class="reference internal"
href="../segger.html">Segger RTT drivers</a></li>
@@ -270,6 +271,12 @@ application advertisements or subscriptions. For devices
like IMUs, which integr
multiple sensors into one unit, multiple lower halves need to be instantiated
within the driver, and device nodes are registered separately through the API
(sensor_register) provided by the upper half.</p>
+<div class="admonition note">
+<p class="admonition-title">Note</p>
+<p>When writing a uORB driver for GNSS/GPS devices, please use the <a
class="reference internal" href="gnss_lowerhalf.html"><span class="doc">GNSS
+lower-half driver</span></a>. This
+driver abstracts parsing and advertising of NMEA information.</p>
+</div>
<section id="naming">
<h2>Naming<a class="headerlink" href="#naming" title="Permalink to this
heading"></a></h2>
<p>The name used for this component in NuttX may be misleading because this
sensor
diff --git a/content/docs/latest/components/drivers/special/sensors/sht4x.html
b/content/docs/latest/components/drivers/special/sensors/sht4x.html
index d1119ef71..346540405 100644
--- a/content/docs/latest/components/drivers/special/sensors/sht4x.html
+++ b/content/docs/latest/components/drivers/special/sensors/sht4x.html
@@ -169,6 +169,7 @@
<li class="toctree-l5"><a class="reference internal"
href="lsm6dso32.html">LSM6DSO32</a></li>
<li class="toctree-l5"><a class="reference internal"
href="lis2mdl.html">LIS2MDL</a></li>
<li class="toctree-l5"><a class="reference internal"
href="l86xxx.html">L86-XXX</a></li>
+<li class="toctree-l5"><a class="reference internal"
href="gnss_lowerhalf.html">GNSS Lower Half uORB Driver</a></li>
</ul>
</li>
<li class="toctree-l4"><a class="reference internal"
href="../segger.html">Segger RTT drivers</a></li>
diff --git a/content/docs/latest/guides/fully_linked_elf.html
b/content/docs/latest/guides/fully_linked_elf.html
index 313679c5a..227a70594 100644
--- a/content/docs/latest/guides/fully_linked_elf.html
+++ b/content/docs/latest/guides/fully_linked_elf.html
@@ -475,7 +475,7 @@ NuttX package: <code class="docutils literal
notranslate"><span class="pre">nutt
<div
class="admonition-here-is-an-alternative-minimal-and-possibly-outdated-version
admonition">
<p class="admonition-title">Here is an alternative minimal (and possibly
outdated) version</p>
<div class="sphinx_collapse docutils">
-<input class="sphinx_collapse__input"
id="425d4cee-6c19-4c08-b09a-149f90e8d6f1"
name="425d4cee-6c19-4c08-b09a-149f90e8d6f1" type="checkbox"><label
class="sphinx_collapse__label" for="425d4cee-6c19-4c08-b09a-149f90e8d6f1"><i
class="sphinx_collapse__icon"></i>Show content:</label><div
class="sphinx_collapse__content docutils">
+<input class="sphinx_collapse__input"
id="b1e0d66a-ef7c-421f-9ffd-20a080f7d8b1"
name="b1e0d66a-ef7c-421f-9ffd-20a080f7d8b1" type="checkbox"><label
class="sphinx_collapse__label" for="b1e0d66a-ef7c-421f-9ffd-20a080f7d8b1"><i
class="sphinx_collapse__icon"></i>Show content:</label><div
class="sphinx_collapse__content docutils">
<div class="highlight-text notranslate"><div
class="highlight"><pre><span></span>SECTIONS
{
.text 0x00000000 :
diff --git a/content/docs/latest/guides/partially_linked_elf.html
b/content/docs/latest/guides/partially_linked_elf.html
index 32b56b032..f3dc000a0 100644
--- a/content/docs/latest/guides/partially_linked_elf.html
+++ b/content/docs/latest/guides/partially_linked_elf.html
@@ -501,7 +501,7 @@ NuttX package: <code class="docutils literal
notranslate"><span class="pre">nutt
<div
class="admonition-here-is-an-alternative-minimal-and-possibly-outdated-version
admonition">
<p class="admonition-title">Here is an alternative minimal (and possibly
outdated) version</p>
<div class="sphinx_collapse docutils">
-<input class="sphinx_collapse__input"
id="b2b1d03d-e773-453e-80ed-5179a8d86b81"
name="b2b1d03d-e773-453e-80ed-5179a8d86b81" type="checkbox"><label
class="sphinx_collapse__label" for="b2b1d03d-e773-453e-80ed-5179a8d86b81"><i
class="sphinx_collapse__icon"></i>Show content:</label><div
class="sphinx_collapse__content docutils">
+<input class="sphinx_collapse__input"
id="10a4a253-826b-4f68-b237-94044cc142ae"
name="10a4a253-826b-4f68-b237-94044cc142ae" type="checkbox"><label
class="sphinx_collapse__label" for="10a4a253-826b-4f68-b237-94044cc142ae"><i
class="sphinx_collapse__icon"></i>Show content:</label><div
class="sphinx_collapse__content docutils">
<div class="highlight-text notranslate"><div
class="highlight"><pre><span></span>SECTIONS
{
.text 0x00000000 :
diff --git a/content/docs/latest/index.html b/content/docs/latest/index.html
index 91c23ea96..0b595fd4a 100644
--- a/content/docs/latest/index.html
+++ b/content/docs/latest/index.html
@@ -185,7 +185,7 @@ standards. Additional standard APIs from Unix and other
common RTOS’s (such as
VxWorks) are adopted for functionality not available under these standards, or
for functionality that is not appropriate for deeply-embedded environments
(such
as fork()).</p>
-<p>Last Updated: 06 August 25 at 00:32</p>
+<p>Last Updated: 07 August 25 at 00:33</p>
<div class="toctree-wrapper compound">
<p class="caption" role="heading"><span class="caption-text">Table of
Contents</span></p>
<ul class="current">
diff --git a/content/docs/latest/objects.inv b/content/docs/latest/objects.inv
index ab52c7e0b..3a32134ba 100644
Binary files a/content/docs/latest/objects.inv and
b/content/docs/latest/objects.inv differ
diff --git a/content/docs/latest/searchindex.js
b/content/docs/latest/searchindex.js
index da6df6cff..8c3ca8fcf 100644
--- a/content/docs/latest/searchindex.js
+++ b/content/docs/latest/searchindex.js
@@ -1 +1 @@
-Search.setIndex({"docnames": ["_tags/arch-arm64", "_tags/arch-avr",
"_tags/arch-example", "_tags/chip-a527", "_tags/chip-a64",
"_tags/chip-at90usb", "_tags/chip-atmega", "_tags/chip-atmega2560",
"_tags/chip-bcm2711", "_tags/chip-esp32", "_tags/chip-esp32a1s",
"_tags/chip-esp32picod4", "_tags/chip-esp32s2", "_tags/chip-esp32s3",
"_tags/chip-esp32wroom32", "_tags/chip-esp32wrover32", "_tags/chip-example",
"_tags/chip-fpga", "_tags/chip-imx8", "_tags/chip-imx93", "_tags/chip-imx95",
"_tags/ [...]
\ No newline at end of file
+Search.setIndex({"docnames": ["_tags/arch-arm64", "_tags/arch-avr",
"_tags/arch-example", "_tags/chip-a527", "_tags/chip-a64",
"_tags/chip-at90usb", "_tags/chip-atmega", "_tags/chip-atmega2560",
"_tags/chip-bcm2711", "_tags/chip-esp32", "_tags/chip-esp32a1s",
"_tags/chip-esp32picod4", "_tags/chip-esp32s2", "_tags/chip-esp32s3",
"_tags/chip-esp32wroom32", "_tags/chip-esp32wrover32", "_tags/chip-example",
"_tags/chip-fpga", "_tags/chip-imx8", "_tags/chip-imx93", "_tags/chip-imx95",
"_tags/ [...]
\ No newline at end of file
diff --git a/content/feed.xml b/content/feed.xml
index 711194dfd..40a1df93e 100644
--- a/content/feed.xml
+++ b/content/feed.xml
@@ -5,8 +5,8 @@
<description></description>
<link>/</link>
<atom:link href="/feed.xml" rel="self" type="application/rss+xml"/>
- <pubDate>Wed, 06 Aug 2025 00:34:54 +0000</pubDate>
- <lastBuildDate>Wed, 06 Aug 2025 00:34:54 +0000</lastBuildDate>
+ <pubDate>Thu, 07 Aug 2025 00:35:24 +0000</pubDate>
+ <lastBuildDate>Thu, 07 Aug 2025 00:35:24 +0000</lastBuildDate>
<generator>Jekyll v4.3.2</generator>
<item>