Skip to content

Commit

Permalink
Merge pull request #550 from nasa/issue-548-users-guide
Browse files Browse the repository at this point in the history
Update links to F Prime docs in User's Guide
  • Loading branch information
bocchino authored Dec 11, 2024
2 parents 9c37f47 + 0eee5a1 commit db5e1d2
Show file tree
Hide file tree
Showing 6 changed files with 68 additions and 64 deletions.
2 changes: 1 addition & 1 deletion docs/fpp-spec.html
Original file line number Diff line number Diff line change
Expand Up @@ -10579,7 +10579,7 @@ <h3 id="Analysis-and-Translation_Translation-Tools">22.4. Translation Tools</h3>
</div>
<div id="footer">
<div id="footer-text">
Last updated 2024-12-04 15:30:17 -0800
Last updated 2024-12-09 16:59:12 -0800
</div>
</div>
<script src="code-prettify/run_prettify.js"></script>
Expand Down
66 changes: 34 additions & 32 deletions docs/fpp-users-guide.html
Original file line number Diff line number Diff line change
Expand Up @@ -756,7 +756,7 @@ <h2 id="Introduction">1. Introduction</h2>
SmallSat 2018</a>
provides an overview of F Prime.
For more detailed information about F Prime, see the
<a href="https://github.com/nasa/fprime/blob/devel/docs/UsersGuide/guide.md">F Prime User&#8217;s Guide</a>.</p>
<a href="https://fprime.jpl.nasa.gov/latest/documentation/user-manual/">F Prime User Manual</a>.</p>
</div>
<div class="paragraph">
<p>The goals of FPP are as follows:</p>
Expand Down Expand Up @@ -3635,7 +3635,7 @@ <h3 id="Defining-State-Machines_Writing-a-State-Machine-Definition">9.1. Writing
of FPP state machines.
For more details about the C&#43;&#43; code generation
for state machines, see the
<a href="https://github.com/nasa/fprime/blob/devel/docs/Design/general.md">F Prime design
<a href="https://fprime.jpl.nasa.gov/latest/documentation/user-manual/">F Prime design
documentation</a>.</p>
</div>
</div>
Expand Down Expand Up @@ -5794,7 +5794,7 @@ <h4 id="Defining-Components_Port-Instances_Basic-Port-Instances">10.2.1. Basic P
base class with a virtual handler function, and then override that virtual
function in a derived class that you write.
For further details about implementing F Prime components, see the
<a href="https://github.com/nasa/fprime/blob/master/docs/UsersGuide/guide.md">F Prime User&#8217;s Guide</a>.</p>
<a href="https://fprime.jpl.nasa.gov/latest/documentation/user-manual/">F Prime User Manual</a>.</p>
</div>
<div class="paragraph">
<p><strong>Note on terminology:</strong> As explained above, there is a technical
Expand Down Expand Up @@ -6089,7 +6089,7 @@ <h4 id="Defining-Components_Port-Instances_Serial-Port-Instances">10.2.6. Serial
This flexibility comes at the cost that you lose the type
compile-time type checking provided by port connections with named types.
For more information about serial ports and their use, see
the <a href="https://github.com/nasa/fprime/blob/master/docs/UsersGuide/guide.md">F Prime User&#8217;s Guide</a>.</p>
the <a href="https://fprime.jpl.nasa.gov/latest/documentation/user-manual/">F Prime User Manual</a>.</p>
</div>
</div>
</div>
Expand Down Expand Up @@ -6228,7 +6228,7 @@ <h4 id="Defining-Components_Special-Port-Instances_Command-Ports">10.3.1. Comman
<div class="paragraph">
<p>For further information about command registration, receipt, and
response, and implementing command handlers, see the
<a href="https://github.com/nasa/fprime/blob/master/docs/UsersGuide/guide.md">F Prime User&#8217;s Guide</a>.</p>
<a href="https://fprime.jpl.nasa.gov/latest/documentation/user-manual/">F Prime User Manual</a>.</p>
</div>
</div>
<div class="sect3">
Expand Down Expand Up @@ -6309,7 +6309,7 @@ <h4 id="Defining-Components_Special-Port-Instances_Event-Ports">10.3.2. Event Po
</div>
<div class="paragraph">
<p>For further information about events in F Prime, see the
<a href="https://github.com/nasa/fprime/blob/master/docs/UsersGuide/guide.md">F Prime User&#8217;s Guide</a>.</p>
<a href="https://fprime.jpl.nasa.gov/latest/documentation/user-manual/">F Prime User Manual</a>.</p>
</div>
</div>
<div class="sect3">
Expand Down Expand Up @@ -6358,7 +6358,7 @@ <h4 id="Defining-Components_Special-Port-Instances_Telemetry-Ports">10.3.3. Tele
</div>
<div class="paragraph">
<p>For further information about telemetry in F Prime, see the
<a href="https://github.com/nasa/fprime/blob/master/docs/UsersGuide/guide.md">F Prime User&#8217;s Guide</a>.</p>
<a href="https://fprime.jpl.nasa.gov/latest/documentation/user-manual/">F Prime User Manual</a>.</p>
</div>
</div>
<div class="sect3">
Expand Down Expand Up @@ -6443,7 +6443,7 @@ <h4 id="Defining-Components_Special-Port-Instances_Parameter-Ports">10.3.4. Para
</div>
<div class="paragraph">
<p>For further information about parameters in F Prime, see the
<a href="https://github.com/nasa/fprime/blob/master/docs/UsersGuide/guide.md">F Prime User&#8217;s Guide</a>.</p>
<a href="https://fprime.jpl.nasa.gov/latest/documentation/user-manual/">F Prime User Manual</a>.</p>
</div>
</div>
<div class="sect3">
Expand Down Expand Up @@ -6493,7 +6493,7 @@ <h4 id="Defining-Components_Special-Port-Instances_Time-Get-Ports">10.3.5. Time
</div>
<div class="paragraph">
<p>For further information about time in F Prime, see the
<a href="https://github.com/nasa/fprime/blob/master/docs/UsersGuide/guide.md">F Prime User&#8217;s Guide</a>.</p>
<a href="https://fprime.jpl.nasa.gov/latest/documentation/user-manual/">F Prime User Manual</a>.</p>
</div>
</div>
<div class="sect3">
Expand Down Expand Up @@ -6616,8 +6616,8 @@ <h4 id="Defining-Components_Special-Port-Instances_Data-Product-Ports">10.3.6. D
</div>
<div class="paragraph">
<p>For further information about data products in F Prime, see the
<a href="https://github.com/nasa/fprime/blob/devel/docs/Design/data-products.md">data products documentation</a>
in the F Prime repository.</p>
<a href="https://fprime.jpl.nasa.gov/latest/documentation/user-manual/design/data-products/">data
products documentation</a> in the F Prime repository.</p>
</div>
</div>
</div>
Expand Down Expand Up @@ -6761,7 +6761,7 @@ <h3 id="Defining-Components_Commands">10.5. Commands</h3>
<div class="paragraph">
<p>For complete information about F Prime command dispatch and
handling, see the
<a href="https://github.com/nasa/fprime/blob/master/docs/UsersGuide/guide.md">F Prime User&#8217;s Guide</a>.
<a href="https://fprime.jpl.nasa.gov/latest/documentation/user-manual/">F Prime User Manual</a>.
Here we concentrate on how to specify commands in FPP.</p>
</div>
<div class="sect3">
Expand Down Expand Up @@ -7124,7 +7124,7 @@ <h3 id="Defining-Components_Events">10.6. Events</h3>
<div class="paragraph">
<p>For complete information about F Prime event
handling, see the
<a href="https://github.com/nasa/fprime/blob/master/docs/UsersGuide/guide.md">F Prime User&#8217;s Guide</a>.
<a href="https://fprime.jpl.nasa.gov/latest/documentation/user-manual/">F Prime User Manual</a>.
Here we concentrate on how to specify events in FPP.</p>
</div>
<div class="sect3">
Expand Down Expand Up @@ -7423,7 +7423,7 @@ <h4 id="Defining-Components_Events_Throttling">10.6.4. Throttling</h4>
emit the event until the throttling is canceled.
Typically, the canceling happens via a FSW command.
For details, see the
<a href="https://github.com/nasa/fprime/blob/master/docs/UsersGuide/guide.md">F Prime User&#8217;s Guide</a>.</p>
<a href="https://fprime.jpl.nasa.gov/latest/documentation/user-manual/">F Prime User Manual</a>.</p>
</div>
</div>
</div>
Expand All @@ -7444,7 +7444,7 @@ <h3 id="Defining-Components_Telemetry">10.7. Telemetry</h3>
<div class="paragraph">
<p>For complete information about F Prime telemetry
handling, see the
<a href="https://github.com/nasa/fprime/blob/master/docs/UsersGuide/guide.md">F Prime User&#8217;s Guide</a>.
<a href="https://fprime.jpl.nasa.gov/latest/documentation/user-manual/">F Prime User Manual</a>.
Here we concentrate on how to specify telemetry channels in FPP.</p>
</div>
<div class="sect3">
Expand Down Expand Up @@ -7804,7 +7804,7 @@ <h3 id="Defining-Components_Parameters">10.8. Parameters</h3>
database component for storing parameters in a non-volatile
manner (e.g., on a file system).
For complete information about F Prime parameters, see the
<a href="https://github.com/nasa/fprime/blob/master/docs/UsersGuide/guide.md">F Prime User&#8217;s Guide</a>.
<a href="https://fprime.jpl.nasa.gov/latest/documentation/user-manual/">F Prime User Manual</a>.
Here we concentrate on how to specify parameters in FPP.</p>
</div>
<div class="sect3">
Expand Down Expand Up @@ -8135,8 +8135,8 @@ <h3 id="Defining-Components_Data-Products">10.9. Data Products</h3>
(2) writing data products to the file system; and (3)
cataloging stored data products for downlink in priority order.
For more information about these F Prime features, see the
<a href="https://github.com/nasa/fprime/blob/devel/docs/Design/data-products.md">F Prime
data products documentation</a>.</p>
<a href="https://fprime.jpl.nasa.gov/latest/documentation/user-manual/">F Prime data
products documentation</a>.</p>
</div>
<div class="sect3">
<h4 id="Defining-Components_Data-Products_Basic-Data-Products">10.9.1. Basic Data Products</h4>
Expand All @@ -8149,7 +8149,7 @@ <h4 id="Defining-Components_Data-Products_Basic-Data-Products">10.9.1. Basic Dat
representing a list of serialized <strong>records</strong>.
A record is a unit of data.
For a complete specification of the container format, see the
<a href="https://github.com/nasa/fprime/blob/devel/Fw/Dp/docs/sdd.md">documentation</a>
<a href="https://fprime.jpl.nasa.gov/latest/documentation/reference/api/cpp/html/_fw_dp.html">documentation</a>
on F Prime framework support for data products.</p>
</div>
<div class="paragraph">
Expand Down Expand Up @@ -8215,7 +8215,7 @@ <h4 id="Defining-Components_Data-Products_Basic-Data-Products">10.9.1. Basic Dat
<p>The FPP back end uses this specification to generate code for requesting
buffers to hold containers and for serializing records into containers.
See the
<a href="https://github.com/nasa/fprime/blob/devel/docs/Design/data-products.md">F
<a href="https://fprime.jpl.nasa.gov/latest/documentation/user-manual/design/data-products/">F
Prime data products documentation</a> for the details.</p>
</div>
<div class="paragraph">
Expand Down Expand Up @@ -8456,7 +8456,7 @@ <h3 id="Defining-Components_State-Machine-Instances">10.10. State Machine Instan
machine definitions may be internal (specified in FPP) or external (specified
by an external tool). For more details about the C&#43;&#43; code generation for
instances of internal state machines, see the
<a href="https://github.com/nasa/fprime/blob/devel/docs/Design/general.md">F Prime design
<a href="https://fprime.jpl.nasa.gov/latest/documentation/user-manual/">F Prime design
documentation</a>.</p>
</div>
</div>
Expand Down Expand Up @@ -12988,25 +12988,26 @@ <h4 id="Analyzing-and-Translating-Models_Generating-C-Plus-Plus_Types-Ports-Stat
<div class="paragraph">
<p>Once you generate C&#43;&#43; code for these definitions, you can use it to
write a flight software implementation.
The <a href="https://github.com/nasa/fprime/blob/master/docs/UsersGuide/guide.md">F
Prime User&#8217;s Guide</a> explains how to do this.</p>
The <a href="https://fprime.jpl.nasa.gov/latest/documentation/user-manual/">F
User Manual</a> explains how to do this.</p>
</div>
<div class="paragraph">
<p>For more information about the generated code for data products,
for state machines, and for state machine instances, see the
<a href="https://github.com/nasa/fprime/blob/devel/docs/Design/general.md">F Prime design
documentation</a>.</p>
<a href="https://fprime.jpl.nasa.gov/latest/documentation/user-manual/">F
Prime design documentation</a>.</p>
</div>
</div>
<div class="sect3">
<h4 id="Analyzing-and-Translating-Models_Generating-C-Plus-Plus_Component-Implementation-and-Unit-Test-Code">14.3.3. Component Implementation and Unit Test Code</h4>
<div class="paragraph">
<p><code>fpp-to-cpp</code> has options <code>-t</code> and <code>-u</code> for generating component &#8220;templates&#8221; or
<p><code>fpp-to-cpp</code> has options <code>-t</code> and <code>-u</code> for generating component &#8220;templates&#8221;
or
partial implementations and for generating unit test code.
Here we cover the mechanics of using these options.
For more information on implementing and testing components in F Prime, see
the <a href="https://github.com/nasa/fprime/blob/master/docs/UsersGuide/guide.md">F
Prime User&#8217;s Guide</a>.</p>
the <a href="https://fprime.jpl.nasa.gov/latest/documentation/user-manual/">F
Prime User Manual</a>.</p>
</div>
<div class="paragraph">
<p><strong>Generating implementation templates:</strong>
Expand Down Expand Up @@ -13915,12 +13916,13 @@ <h3 id="Analyzing-and-Translating-Models_Generating-Ground-Dictionaries">14.8. G
</div>
<div class="paragraph">
<p><strong>Tool behavior:</strong>
For each topology <em>T</em> defined in the input files <em>F</em>, <code>fpp-to-dict</code> writes a file
For each topology <em>T</em> defined in the input files <em>F</em>, <code>fpp-to-dict</code> writes a
file
<em>T</em> <code>TopologyDictionary.json</code>.
The dictionary is specified in JavaScript Object Notation (JSON) format.
The JSON format is specified in the
<a href="https://github.com/nasa/fprime/blob/devel/docs/Design/fpp-json-dict.md">F Prime
dictionary documentation</a>.</p>
<a href="https://fprime.jpl.nasa.gov/latest/documentation/user-manual/design/fpp-json-dict/">F
Prime dictionary documentation</a>.</p>
</div>
<div class="paragraph">
<p>Here is a common use case:</p>
Expand Down Expand Up @@ -14754,7 +14756,7 @@ <h4 id="Writing-C-Plus-Plus-Implementations_Implementing-Deployments_Public-Symb
</div>
<div id="footer">
<div id="footer-text">
Last updated 2024-12-04 15:31:01 -0800
Last updated 2024-12-09 16:59:59 -0800
</div>
</div>
<script src="code-prettify/run_prettify.js"></script>
Expand Down
22 changes: 12 additions & 10 deletions docs/users-guide/Analyzing-and-Translating-Models.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -566,22 +566,23 @@ uses the name `A_B_CComponentAc_HPP` in its include guard.

Once you generate {cpp} code for these definitions, you can use it to
write a flight software implementation.
The https://github.com/nasa/fprime/blob/master/docs/UsersGuide/guide.md[F
Prime User's Guide] explains how to do this.
The https://fprime.jpl.nasa.gov/latest/documentation/user-manual/[F
User Manual] explains how to do this.

For more information about the generated code for data products,
for state machines, and for state machine instances, see the
https://github.com/nasa/fprime/blob/devel/docs/Design/general.md[F Prime design
documentation].
https://fprime.jpl.nasa.gov/latest/documentation/user-manual/[F
Prime design documentation].

==== Component Implementation and Unit Test Code

`fpp-to-cpp` has options `-t` and `-u` for generating component "`templates`" or
`fpp-to-cpp` has options `-t` and `-u` for generating component "`templates`"
or
partial implementations and for generating unit test code.
Here we cover the mechanics of using these options.
For more information on implementing and testing components in F Prime, see
the https://github.com/nasa/fprime/blob/master/docs/UsersGuide/guide.md[F
Prime User's Guide].
the https://fprime.jpl.nasa.gov/latest/documentation/user-manual/[F
Prime User Manual].

*Generating implementation templates:*
When you run `fpp-to-cpp` with option `-t` and without option `-u`,
Expand Down Expand Up @@ -1312,12 +1313,13 @@ Except for the tool name, this procedure is identical to the one given for
either through named files or through standard input.

*Tool behavior:*
For each topology _T_ defined in the input files _F_, `fpp-to-dict` writes a file
For each topology _T_ defined in the input files _F_, `fpp-to-dict` writes a
file
_T_ `TopologyDictionary.json`.
The dictionary is specified in JavaScript Object Notation (JSON) format.
The JSON format is specified in the
https://github.com/nasa/fprime/blob/devel/docs/Design/fpp-json-dict.md[F Prime
dictionary documentation].
https://fprime.jpl.nasa.gov/latest/documentation/user-manual/design/fpp-json-dict/[F
Prime dictionary documentation].

Here is a common use case:

Expand Down
Loading

0 comments on commit db5e1d2

Please sign in to comment.