You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@nuttx.apache.org by gi...@apache.org on 2022/01/18 00:13:19 UTC
[incubator-nuttx-website] branch asf-site updated: Publishing web: adbba922a8890b650c27ecac31f9d26fe25e1ec4 docs: 04723a89f2010f17bc2a18f788eff4a93e292d2d
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/incubator-nuttx-website.git
The following commit(s) were added to refs/heads/asf-site by this push:
new 6f35c69 Publishing web: adbba922a8890b650c27ecac31f9d26fe25e1ec4 docs: 04723a89f2010f17bc2a18f788eff4a93e292d2d
6f35c69 is described below
commit 6f35c6987d1fc4706f11f011436cce7960ec33ac
Author: Alin <al...@sony.com>
AuthorDate: Tue Jan 18 00:09:43 2022 +0000
Publishing web: adbba922a8890b650c27ecac31f9d26fe25e1ec4 docs: 04723a89f2010f17bc2a18f788eff4a93e292d2d
---
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 +-
.../_sources/platforms/risc-v/mpfs/index.rst.txt | 27 ++++++++++++++-----
content/docs/latest/index.html | 2 +-
.../docs/latest/platforms/risc-v/mpfs/index.html | 30 ++++++++++++++++------
content/docs/latest/searchindex.js | 2 +-
content/feed.xml | 4 +--
9 files changed, 51 insertions(+), 22 deletions(-)
diff --git a/content/docs/10.0.0/index.html b/content/docs/10.0.0/index.html
index 398491d..dfae993 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: 17 January 22 at 00:07</p>
+<p>Last Updated: 18 January 22 at 00:06</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 3809989..4af4aa7 100644
--- a/content/docs/10.0.1/index.html
+++ b/content/docs/10.0.1/index.html
@@ -215,7 +215,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: 17 January 22 at 00:07</p>
+<p>Last Updated: 18 January 22 at 00:07</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 e1bfe28..6eced3e 100644
--- a/content/docs/10.1.0/index.html
+++ b/content/docs/10.1.0/index.html
@@ -215,7 +215,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: 17 January 22 at 00:08</p>
+<p>Last Updated: 18 January 22 at 00:07</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 6e1d1d6..7200f3d 100644
--- a/content/docs/10.2.0/index.html
+++ b/content/docs/10.2.0/index.html
@@ -216,7 +216,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: 17 January 22 at 00:08</p>
+<p>Last Updated: 18 January 22 at 00:07</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/latest/_sources/platforms/risc-v/mpfs/index.rst.txt b/content/docs/latest/_sources/platforms/risc-v/mpfs/index.rst.txt
index bb73321..2450545 100644
--- a/content/docs/latest/_sources/platforms/risc-v/mpfs/index.rst.txt
+++ b/content/docs/latest/_sources/platforms/risc-v/mpfs/index.rst.txt
@@ -16,23 +16,38 @@ Like: https://xpack.github.io/riscv-none-embed-gcc or https://github.com/sifive/
Booting
=======
-The NuttX port for now relies on HSS bootloader to carry on some hardware initializations.
+The NuttX works as a standalone operating system that may initialize all the required clocks and
+peripherals including DDR memory. Alternatively, the vendor's HSS bootloader may be used instead to
+perform all the initialization steps.
Building and flashing
=====================
+Configure the NuttX project: ``./tools/configure.sh icicle:nsh``
+Run ``make`` to build the project.
+
+If NuttX is built as a standalone OS with the config option CONFIG_MPFS_BOOTLOADER set, it's important
+to note that the image size is very limited: only (128K - 256) bytes. 256 bytes are reserved for the
+header that must be prepended into the NuttX binary. This binary is called hss-envm-wrapper-bm1-dummySbic.bin
+and may be found from the vendor's HSS implementation. Moreover, after prepending the 256-byte header,
+the LMA section needs to be adjusted, for example::
+
+ riscv64-unknown-elf-objcopy -I binary -O ihex --change-section-lma *+0x20220000 nuttx.bin nuttx.hex
+
+The output binary nuttx.hex may be flashed with the LiberoSoc tool.
+The tool is available from: https://www.microchip.com/en-us/products/fpgas-and-plds/fpga-and-soc-design-tools/fpga/libero-software-later-versions#Documents%20and%20Downloads
+
+There's an alternative way to use NuttX, without the CONFIG_MPFS_BOOTLOADER option set. This expects the
+HSS bootloader sets up the system (memories, caches, initializes clocks etc.).
First make sure that ``hss-payload-generator`` is installed.
Available from: https://github.com/polarfire-soc/hart-software-services
This tool is used to convert the ELF/bin to a compatible HSS payload image
-Configure the NuttX project: ``./tools/configure.sh icicle:nsh``
-Run ``make`` to build the project.
-
Create HSS payload bin::
- hss-payload-generator -v -c hss-nuttx.yml payload.bin
+ hss-payload-generator -v -c hss-nuttx.yml payload.bin
Debugging with OpenOCD
@@ -59,7 +74,7 @@ GPIO Yes
MMUART Yes Uart mode only
SPI Yes
I2C Yes
-eMMC SD/SDIO Yes eMMC not fully tested
+eMMC SD/SDIO Yes No PHY training
Timers No
Watchdog No
RTC No
diff --git a/content/docs/latest/index.html b/content/docs/latest/index.html
index 6e1d1d6..89ff42f 100644
--- a/content/docs/latest/index.html
+++ b/content/docs/latest/index.html
@@ -216,7 +216,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: 17 January 22 at 00:08</p>
+<p>Last Updated: 18 January 22 at 00:08</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/latest/platforms/risc-v/mpfs/index.html b/content/docs/latest/platforms/risc-v/mpfs/index.html
index b54759c..9f92fb0 100644
--- a/content/docs/latest/platforms/risc-v/mpfs/index.html
+++ b/content/docs/latest/platforms/risc-v/mpfs/index.html
@@ -240,15 +240,29 @@ Like: <a class="reference external" href="https://xpack.github.io/riscv-none-emb
</div>
<div class="section" id="booting">
<h2>Booting<a class="headerlink" href="#booting" title="Permalink to this headline">¶</a></h2>
-<p>The NuttX port for now relies on HSS bootloader to carry on some hardware initializations.</p>
+<p>The NuttX works as a standalone operating system that may initialize all the required clocks and
+peripherals including DDR memory. Alternatively, the vendor’s HSS bootloader may be used instead to
+perform all the initialization steps.</p>
</div>
<div class="section" id="building-and-flashing">
<h2>Building and flashing<a class="headerlink" href="#building-and-flashing" title="Permalink to this headline">¶</a></h2>
-<p>First make sure that <code class="docutils literal notranslate"><span class="pre">hss-payload-generator</span></code> is installed.
-Available from: <a class="reference external" href="https://github.com/polarfire-soc/hart-software-services">https://github.com/polarfire-soc/hart-software-services</a></p>
-<p>This tool is used to convert the ELF/bin to a compatible HSS payload image</p>
<p>Configure the NuttX project: <code class="docutils literal notranslate"><span class="pre">./tools/configure.sh</span> <span class="pre">icicle:nsh</span></code>
Run <code class="docutils literal notranslate"><span class="pre">make</span></code> to build the project.</p>
+<p>If NuttX is built as a standalone OS with the config option CONFIG_MPFS_BOOTLOADER set, it’s important
+to note that the image size is very limited: only (128K - 256) bytes. 256 bytes are reserved for the
+header that must be prepended into the NuttX binary. This binary is called hss-envm-wrapper-bm1-dummySbic.bin
+and may be found from the vendor’s HSS implementation. Moreover, after prepending the 256-byte header,
+the LMA section needs to be adjusted, for example:</p>
+<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>riscv64-unknown-elf-objcopy -I binary -O ihex --change-section-lma *+0x20220000 nuttx.bin nuttx.hex
+</pre></div>
+</div>
+<p>The output binary nuttx.hex may be flashed with the LiberoSoc tool.
+The tool is available from: <a class="reference external" href="https://www.microchip.com/en-us/products/fpgas-and-plds/fpga-and-soc-design-tools/fpga/libero-software-later-versions#Documents%20and%20Downloads">https://www.microchip.com/en-us/products/fpgas-and-plds/fpga-and-soc-design-tools/fpga/libero-software-later-versions#Documents%20and%20Downloads</a></p>
+<p>There’s an alternative way to use NuttX, without the CONFIG_MPFS_BOOTLOADER option set. This expects the
+HSS bootloader sets up the system (memories, caches, initializes clocks etc.).
+First make sure that <code class="docutils literal notranslate"><span class="pre">hss-payload-generator</span></code> is installed.
+Available from: <a class="reference external" href="https://github.com/polarfire-soc/hart-software-services">https://github.com/polarfire-soc/hart-software-services</a></p>
+<p>This tool is used to convert the ELF/bin to a compatible HSS payload image</p>
<p>Create HSS payload bin:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>hss-payload-generator -v -c hss-nuttx.yml payload.bin
</pre></div>
@@ -268,9 +282,9 @@ Run <code class="docutils literal notranslate"><span class="pre">make</span></co
<p>The following list indicates the state of peripherals’ support in NuttX:</p>
<table class="docutils align-default">
<colgroup>
-<col style="width: 30%" />
-<col style="width: 18%" />
-<col style="width: 53%" />
+<col style="width: 35%" />
+<col style="width: 21%" />
+<col style="width: 44%" />
</colgroup>
<thead>
<tr class="row-odd"><th class="head"><p>Peripheral</p></th>
@@ -297,7 +311,7 @@ Run <code class="docutils literal notranslate"><span class="pre">make</span></co
</tr>
<tr class="row-even"><td><p>eMMC SD/SDIO</p></td>
<td><p>Yes</p></td>
-<td><p>eMMC not fully tested</p></td>
+<td><p>No PHY training</p></td>
</tr>
<tr class="row-odd"><td><p>Timers</p></td>
<td><p>No</p></td>
diff --git a/content/docs/latest/searchindex.js b/content/docs/latest/searchindex.js
index bda29b2..8bf4d0f 100644
--- a/content/docs/latest/searchindex.js
+++ b/content/docs/latest/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/feed.xml b/content/feed.xml
index ee2a2c2..572ee8f 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>Mon, 17 Jan 2022 00:10:49 +0000</pubDate>
- <lastBuildDate>Mon, 17 Jan 2022 00:10:49 +0000</lastBuildDate>
+ <pubDate>Tue, 18 Jan 2022 00:09:40 +0000</pubDate>
+ <lastBuildDate>Tue, 18 Jan 2022 00:09:40 +0000</lastBuildDate>
<generator>Jekyll v3.8.5</generator>
<item>