http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/2c998465/modules/testutil/index.html ---------------------------------------------------------------------- diff --git a/modules/testutil/index.html b/modules/testutil/index.html new file mode 100644 index 0000000..467eb8f --- /dev/null +++ b/modules/testutil/index.html @@ -0,0 +1,537 @@ +<!DOCTYPE html> +<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]--> +<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]--> +<head> + <meta charset="utf-8"> + <meta name="viewport" content="width=device-width, initial-scale=1.0"> + + <title>Test Utilities - Mynewt</title> + + + <link rel="shortcut icon" href="../../img/favicon.ico"> + + + <link href='https://fonts.googleapis.com/css?family=Lato:400,700|Roboto+Slab:400,700|Inconsolata:400,700' rel='stylesheet' type='text/css'> + + <link rel="stylesheet" href="../../css/theme.css" type="text/css" /> + <link rel="stylesheet" href="../../css/theme_extra.css" type="text/css" /> + <link rel="stylesheet" href="../../css/highlight.css"> + <link href="../../extra.css" rel="stylesheet"> + + + <script> + // Current page data + var mkdocs_page_name = "Test Utilities"; + </script> + + <script src="../../js/jquery-2.1.1.min.js"></script> + <script src="../../js/modernizr-2.8.3.min.js"></script> + <script type="text/javascript" src="../../js/highlight.pack.js"></script> + <script src="../../js/theme.js"></script> + + +</head> + +<body class="wy-body-for-nav" role="document"> + + <div class="wy-grid-for-nav"> + + + <nav data-toggle="wy-nav-shift" class="wy-nav-side stickynav"> + <div class="wy-side-nav-search"> + <a href="../.." class="icon icon-home"> Mynewt</a> + <div role="search"> + <form id ="rtd-search-form" class="wy-form" action="../../search.html" method="get"> + <input type="text" name="q" placeholder="Search docs" /> + </form> +</div> + </div> + + <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation"> + <ul class="current"> + + <li> + <li class="toctree-l1 "> + <a class="" href="../..">Home</a> + + </li> +<li> + + <li> + <ul class="subnav"> + <li><span>Get Started</span></li> + + + + <li class="toctree-l1 "> + <a class="" href="../../get_started/newt_concepts/">Newt Concepts</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../../get_started/project1/">Blinky, The First Project</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../../get_started/how_to_edit_docs/">How to edit docs</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../../get_started/try_markdown/">Sample doc to edit</a> + + </li> + + + </ul> +<li> + + <li> + <ul class="subnav"> + <li><span>Get Acclimated</span></li> + + + + <li class="toctree-l1 "> + <a class="" href="../../get_acclimated/vocabulary/">Understanding Newt Terms</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../../get_acclimated/project2/">Project 2</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../../get_acclimated/project3/">Project 3</a> + + </li> + + + </ul> +<li> + + <li> + <ul class="subnav"> + <li><span>Newt Tool</span></li> + + + + <li class="toctree-l1 "> + <a class="" href="../../newt/newt_ops/">Command structure</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../../newt/newt_tool_reference/">Command list</a> + + </li> + + + </ul> +<li> + + <li> + <ul class="subnav"> + <li><span>Mynewt OS</span></li> + + + + <li class="toctree-l1 "> + <a class="" href="../../os/mynewt_os/">Overview</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../../os/context_switch/">Scheduler/Context Switching</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../../os/time/">Time</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../../os/task/">Tasks</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../../os/event_queue/">Event Queues</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../../os/semaphore/">Semaphores</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../../os/mutex/">Mutexes</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../../os/memory_pool/">Memory Pools</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../../os/heap/">Heap</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../../os/mbufs/">Mbufs</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../../os/sanity/">Sanity</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../../os/callout/">Callout Functions</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../../os/port_os/">Porting to other Platforms</a> + + </li> + + + </ul> +<li> + + <li> + <ul class="subnav"> + <li><span>Chapter5 - Modules</span></li> + + + + <li class="toctree-l1 "> + <a class="" href="../console/">Console</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../shell/">Shell</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../bootloader/">Bootloader</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../filesystem/">File System</a> + + </li> + + + + <li class="toctree-l1 current"> + <a class="current" href="./">Test Utilities</a> + + <ul> + + <li class="toctree-l3"><a href="#testutil">testutil</a></li> + + <li><a class="toctree-l4" href="#description">Description</a></li> + + <li><a class="toctree-l4" href="#data-structures">Data structures</a></li> + + <li><a class="toctree-l4" href="#list-of-functions">List of Functions</a></li> + + <li><a class="toctree-l4" href="#function-reference">Function Reference</a></li> + + + </ul> + + </li> + + + </ul> +<li> + + <li> + <ul class="subnav"> + <li><span>Chapter6 - Packaging it</span></li> + + + + <li class="toctree-l1 "> + <a class="" href="../../packaging/dist/">Creating Packages</a> + + </li> + + + </ul> +<li> + + </ul> + </div> + + </nav> + + <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"> + + + <nav class="wy-nav-top" role="navigation" aria-label="top navigation"> + <i data-toggle="wy-nav-top" class="fa fa-bars"></i> + <a href="../..">Mynewt</a> + </nav> + + + <div class="wy-nav-content"> + <div class="rst-content"> + <div role="navigation" aria-label="breadcrumbs navigation"> + <ul class="wy-breadcrumbs"> + <li><a href="../..">Docs</a> »</li> + + + + <li>Chapter5 - Modules »</li> + + + + <li>Test Utilities</li> + <li class="wy-breadcrumbs-aside"> + + </li> + </ul> + <hr/> +</div> + <div role="main"> + <div class="section"> + + <h1 id="testutil">testutil<a class="headerlink" href="#testutil" title="Permanent link">¶</a></h1> +<p>Insert synopsis here</p> +<h2 id="description">Description<a class="headerlink" href="#description" title="Permanent link">¶</a></h2> +<p>Describe module here, special features, how pieces fit together etc.</p> +<h2 id="data-structures">Data structures<a class="headerlink" href="#data-structures" title="Permanent link">¶</a></h2> +<p>Replace this with the list of data structures used, why, any neat features</p> +<h2 id="list-of-functions">List of Functions<a class="headerlink" href="#list-of-functions" title="Permanent link">¶</a></h2> +<p><List all the functions here. Note how the anchors work. You put the text you want to show up as a link within [] and the relevant #heading within (). Note that the words of the heading need to be connected with a dash for the anchor to work. Hence the word "function" and the function name is connected with a dash, not underscore! And the header has to have at least 2 words for the anchor to work - that's how it is.></p> +<p>The functions available in this OS feature are:</p> +<ul> +<li><a href="#function-tu_init">tu_init</a></li> +<li><a href="#function-tu_restart">tu_restart</a></li> +<li>add the rest</li> +</ul> +<h2 id="function-reference">Function Reference<a class="headerlink" href="#function-reference" title="Permanent link">¶</a></h2> +<hr /> +<h3 id="function-tu_init"><font color="2980b9">function tu_init </font><a class="headerlink" href="#function-tu_init" title="Permanent link">¶</a></h3> +<pre><code> int + tu_init(void) + +</code></pre> + +<p><Insert short description></p> +<h4 id="arguments">Arguments<a class="headerlink" href="#arguments" title="Permanent link">¶</a></h4> +<table> +<thead> +<tr> +<th>Arguments</th> +<th>Description</th> +</tr> +</thead> +<tbody> +<tr> +<td>xx</td> +<td>explain argument xx</td> +</tr> +<tr> +<td>yy</td> +<td>explain argument yy</td> +</tr> +</tbody> +</table> +<h4 id="returned-values">Returned values<a class="headerlink" href="#returned-values" title="Permanent link">¶</a></h4> +<p>List any values returned. +Error codes?</p> +<h4 id="notes">Notes<a class="headerlink" href="#notes" title="Permanent link">¶</a></h4> +<p>Any special feature/special benefit that we want to tout. +Does it need to be used with some other specific functions? +Any caveats to be careful about (e.g. high memory requirements).</p> +<h4 id="example">Example<a class="headerlink" href="#example" title="Permanent link">¶</a></h4> +<p><Add text to set up the context for the example here></p> +<pre><code> +<Insert the code snippet here> + +</code></pre> + +<hr /> +<h3 id="function-tu_restart"><font color="#2980b9"> function tu_restart </font><a class="headerlink" href="#function-tu_restart" title="Permanent link">¶</a></h3> +<pre><code> <Insert function callout here > + +</code></pre> + +<p><Insert short description></p> +<h4 id="arguments_1">Arguments<a class="headerlink" href="#arguments_1" title="Permanent link">¶</a></h4> +<table> +<thead> +<tr> +<th>Arguments</th> +<th>Description</th> +</tr> +</thead> +<tbody> +<tr> +<td>xx</td> +<td>explain argument xx</td> +</tr> +<tr> +<td>yy</td> +<td>explain argument yy</td> +</tr> +</tbody> +</table> +<h4 id="returned-values_1">Returned values<a class="headerlink" href="#returned-values_1" title="Permanent link">¶</a></h4> +<p>List any values returned. +Error codes?</p> +<h4 id="notes_1">Notes<a class="headerlink" href="#notes_1" title="Permanent link">¶</a></h4> +<p>Any special feature/special benefit that we want to tout. +Does it need to be used with some other specific functions? +Any caveats to be careful about (e.g. high memory requirements).</p> +<h4 id="example_1">Example<a class="headerlink" href="#example_1" title="Permanent link">¶</a></h4> +<p><Add text to set up the context for the example here></p> +<pre><code> +<Insert the code snippet here> + +</code></pre> + +<hr /> +<h3 id="function-next_one"><font color="#2980b9"> function next_one </font><a class="headerlink" href="#function-next_one" title="Permanent link">¶</a></h3> +<pre><code> <Insert function callout here > + +</code></pre> + +<p><Insert short description></p> +<h4 id="arguments_2">Arguments<a class="headerlink" href="#arguments_2" title="Permanent link">¶</a></h4> +<table> +<thead> +<tr> +<th>Arguments</th> +<th>Description</th> +</tr> +</thead> +<tbody> +<tr> +<td>xx</td> +<td>explain argument xx</td> +</tr> +<tr> +<td>yy</td> +<td>explain argument yy</td> +</tr> +</tbody> +</table> +<h4 id="returned-values_2">Returned values<a class="headerlink" href="#returned-values_2" title="Permanent link">¶</a></h4> +<p>List any values returned. +Error codes?</p> +<h4 id="notes_2">Notes<a class="headerlink" href="#notes_2" title="Permanent link">¶</a></h4> +<p>Any special feature/special benefit that we want to tout. +Does it need to be used with some other specific functions? +Any caveats to be careful about (e.g. high memory requirements).</p> +<h4 id="example_2">Example<a class="headerlink" href="#example_2" title="Permanent link">¶</a></h4> +<p><Add text to set up the context for the example here></p> +<pre><code> +<Insert the code snippet here> + +</code></pre> + +<hr /> + + </div> + </div> + <footer> + + <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation"> + + <a href="../../packaging/dist/" class="btn btn-neutral float-right" title="Creating Packages"/>Next <span class="icon icon-circle-arrow-right"></span></a> + + + <a href="../filesystem/" class="btn btn-neutral" title="File System"><span class="icon icon-circle-arrow-left"></span> Previous</a> + + </div> + + + <hr/> + + <div role="contentinfo"> + <!-- Copyright etc --> + + </div> + + Built with <a href="http://www.mkdocs.org";>MkDocs</a> using a <a href="https://github.com/snide/sphinx_rtd_theme";>theme</a> provided by <a href="https://readthedocs.org";>Read the Docs</a>. +</footer> + + </div> + </div> + + </section> + + </div> + +<div class="rst-versions" role="note" style="cursor: pointer"> + <span class="rst-current-version" data-toggle="rst-current-version"> + + + <span><a href="../filesystem/" style="color: #fcfcfc;">« Previous</a></span> + + + <span style="margin-left: 15px"><a href="../../packaging/dist/" style="color: #fcfcfc">Next »</a></span> + + </span> +</div> + +</body> +</html>
http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/2c998465/newt/newt_ops/index.html ---------------------------------------------------------------------- diff --git a/newt/newt_ops/index.html b/newt/newt_ops/index.html new file mode 100644 index 0000000..29bad23 --- /dev/null +++ b/newt/newt_ops/index.html @@ -0,0 +1,426 @@ +<!DOCTYPE html> +<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]--> +<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]--> +<head> + <meta charset="utf-8"> + <meta name="viewport" content="width=device-width, initial-scale=1.0"> + + <title>Command structure - Mynewt</title> + + + <link rel="shortcut icon" href="../../img/favicon.ico"> + + + <link href='https://fonts.googleapis.com/css?family=Lato:400,700|Roboto+Slab:400,700|Inconsolata:400,700' rel='stylesheet' type='text/css'> + + <link rel="stylesheet" href="../../css/theme.css" type="text/css" /> + <link rel="stylesheet" href="../../css/theme_extra.css" type="text/css" /> + <link rel="stylesheet" href="../../css/highlight.css"> + <link href="../../extra.css" rel="stylesheet"> + + + <script> + // Current page data + var mkdocs_page_name = "Command structure"; + </script> + + <script src="../../js/jquery-2.1.1.min.js"></script> + <script src="../../js/modernizr-2.8.3.min.js"></script> + <script type="text/javascript" src="../../js/highlight.pack.js"></script> + <script src="../../js/theme.js"></script> + + +</head> + +<body class="wy-body-for-nav" role="document"> + + <div class="wy-grid-for-nav"> + + + <nav data-toggle="wy-nav-shift" class="wy-nav-side stickynav"> + <div class="wy-side-nav-search"> + <a href="../.." class="icon icon-home"> Mynewt</a> + <div role="search"> + <form id ="rtd-search-form" class="wy-form" action="../../search.html" method="get"> + <input type="text" name="q" placeholder="Search docs" /> + </form> +</div> + </div> + + <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation"> + <ul class="current"> + + <li> + <li class="toctree-l1 "> + <a class="" href="../..">Home</a> + + </li> +<li> + + <li> + <ul class="subnav"> + <li><span>Get Started</span></li> + + + + <li class="toctree-l1 "> + <a class="" href="../../get_started/newt_concepts/">Newt Concepts</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../../get_started/project1/">Blinky, The First Project</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../../get_started/how_to_edit_docs/">How to edit docs</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../../get_started/try_markdown/">Sample doc to edit</a> + + </li> + + + </ul> +<li> + + <li> + <ul class="subnav"> + <li><span>Get Acclimated</span></li> + + + + <li class="toctree-l1 "> + <a class="" href="../../get_acclimated/vocabulary/">Understanding Newt Terms</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../../get_acclimated/project2/">Project 2</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../../get_acclimated/project3/">Project 3</a> + + </li> + + + </ul> +<li> + + <li> + <ul class="subnav"> + <li><span>Newt Tool</span></li> + + + + <li class="toctree-l1 current"> + <a class="current" href="./">Command structure</a> + + <ul> + + <li class="toctree-l3"><a href="#command-structure">Command Structure</a></li> + + + </ul> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../newt_tool_reference/">Command list</a> + + </li> + + + </ul> +<li> + + <li> + <ul class="subnav"> + <li><span>Mynewt OS</span></li> + + + + <li class="toctree-l1 "> + <a class="" href="../../os/mynewt_os/">Overview</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../../os/context_switch/">Scheduler/Context Switching</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../../os/time/">Time</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../../os/task/">Tasks</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../../os/event_queue/">Event Queues</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../../os/semaphore/">Semaphores</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../../os/mutex/">Mutexes</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../../os/memory_pool/">Memory Pools</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../../os/heap/">Heap</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../../os/mbufs/">Mbufs</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../../os/sanity/">Sanity</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../../os/callout/">Callout Functions</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../../os/port_os/">Porting to other Platforms</a> + + </li> + + + </ul> +<li> + + <li> + <ul class="subnav"> + <li><span>Chapter5 - Modules</span></li> + + + + <li class="toctree-l1 "> + <a class="" href="../../modules/console/">Console</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../../modules/shell/">Shell</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../../modules/bootloader/">Bootloader</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../../modules/filesystem/">File System</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../../modules/testutil/">Test Utilities</a> + + </li> + + + </ul> +<li> + + <li> + <ul class="subnav"> + <li><span>Chapter6 - Packaging it</span></li> + + + + <li class="toctree-l1 "> + <a class="" href="../../packaging/dist/">Creating Packages</a> + + </li> + + + </ul> +<li> + + </ul> + </div> + + </nav> + + <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"> + + + <nav class="wy-nav-top" role="navigation" aria-label="top navigation"> + <i data-toggle="wy-nav-top" class="fa fa-bars"></i> + <a href="../..">Mynewt</a> + </nav> + + + <div class="wy-nav-content"> + <div class="rst-content"> + <div role="navigation" aria-label="breadcrumbs navigation"> + <ul class="wy-breadcrumbs"> + <li><a href="../..">Docs</a> »</li> + + + + <li>Newt Tool »</li> + + + + <li>Command structure</li> + <li class="wy-breadcrumbs-aside"> + + </li> + </ul> + <hr/> +</div> + <div role="main"> + <div class="section"> + + <h2 id="command-structure">Command Structure<a class="headerlink" href="#command-structure" title="Permanent link">¶</a></h2> +<p>In the newt tool, commands represent actions and flags are modifiers for those actions. A command can have children commands which are also simply referred to as commands. One or more arguments may need to be provided to a command to execute it correctly. </p> +<p>In the example below, the <code>newt</code> command has the child command <code>target set</code>. The first argument 'my_target1' is the name of the target whose attributes are being set. The second argument 'arch=cortex_m4' specifies the value to set the attribute (variable) 'arch' to, which in this case is 'cortex_m4'. </p> +<pre><code>newt target set my_target1 arch=cortex_m4 +</code></pre> +<p>Global flags work on all newt commands in the same way. An example is the flag <code>-v, --verbose</code> to ask for a verbose output while executing a command. The help flag <code>-h</code> or <code>--help</code> is available on all commands but provides command specific output, of course. These flags may be specified in either a long or a short form. </p> +<p>A command may additionally take flags specific to it. For example, the <code>-b</code> flag may be used with <code>newt egg install</code> to tell it which branch to install the egg from. </p> +<pre><code>newt egg install -b <branchname> <eggname> +</code></pre> +<p>In addition to the newt tool <a href="../newt_tool_reference/">reference</a> in this documentation set, command-line help is available for each command (and child command). Simply use the flag <code>-h</code> or <code>--help</code> as shown below:</p> +<pre><code>$ newt target export --help +Export build targets from the current nest, and print them to +standard output. If the -a (or -export-all) option is specified, +then all targets will be exported. Otherwise, <target-name> +must be specified, and only that target will be exported. + +Usage: + newt target export [flags] + +Examples: + newt target export [-a -export-all] [<target-name>] + newt target export -a > my_exports.txt + newt target export my_target > my_target_export.txt + +Flags: + -a, --export-all=false: If present, export all targets + -h, --help=false: help for export + +Global Flags: + -l, --loglevel="WARN": Log level, defaults to WARN. + -q, --quiet=false: Be quiet; only display error output. + -s, --silent=false: Be silent; don't output anything. + -v, --verbose=false: Enable verbose output when executing commands. +</code></pre> + + </div> + </div> + <footer> + + <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation"> + + <a href="../newt_tool_reference/" class="btn btn-neutral float-right" title="Command list"/>Next <span class="icon icon-circle-arrow-right"></span></a> + + + <a href="../../get_acclimated/project3/" class="btn btn-neutral" title="Project 3"><span class="icon icon-circle-arrow-left"></span> Previous</a> + + </div> + + + <hr/> + + <div role="contentinfo"> + <!-- Copyright etc --> + + </div> + + Built with <a href="http://www.mkdocs.org";>MkDocs</a> using a <a href="https://github.com/snide/sphinx_rtd_theme";>theme</a> provided by <a href="https://readthedocs.org";>Read the Docs</a>. +</footer> + + </div> + </div> + + </section> + + </div> + +<div class="rst-versions" role="note" style="cursor: pointer"> + <span class="rst-current-version" data-toggle="rst-current-version"> + + + <span><a href="../../get_acclimated/project3/" style="color: #fcfcfc;">« Previous</a></span> + + + <span style="margin-left: 15px"><a href="../newt_tool_reference/" style="color: #fcfcfc">Next »</a></span> + + </span> +</div> + +</body> +</html> http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/2c998465/newt/newt_tool_reference/index.html ---------------------------------------------------------------------- diff --git a/newt/newt_tool_reference/index.html b/newt/newt_tool_reference/index.html new file mode 100644 index 0000000..5c0aa3f --- /dev/null +++ b/newt/newt_tool_reference/index.html @@ -0,0 +1,925 @@ +<!DOCTYPE html> +<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]--> +<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]--> +<head> + <meta charset="utf-8"> + <meta name="viewport" content="width=device-width, initial-scale=1.0"> + + <title>Command list - Mynewt</title> + + + <link rel="shortcut icon" href="../../img/favicon.ico"> + + + <link href='https://fonts.googleapis.com/css?family=Lato:400,700|Roboto+Slab:400,700|Inconsolata:400,700' rel='stylesheet' type='text/css'> + + <link rel="stylesheet" href="../../css/theme.css" type="text/css" /> + <link rel="stylesheet" href="../../css/theme_extra.css" type="text/css" /> + <link rel="stylesheet" href="../../css/highlight.css"> + <link href="../../extra.css" rel="stylesheet"> + + + <script> + // Current page data + var mkdocs_page_name = "Command list"; + </script> + + <script src="../../js/jquery-2.1.1.min.js"></script> + <script src="../../js/modernizr-2.8.3.min.js"></script> + <script type="text/javascript" src="../../js/highlight.pack.js"></script> + <script src="../../js/theme.js"></script> + + +</head> + +<body class="wy-body-for-nav" role="document"> + + <div class="wy-grid-for-nav"> + + + <nav data-toggle="wy-nav-shift" class="wy-nav-side stickynav"> + <div class="wy-side-nav-search"> + <a href="../.." class="icon icon-home"> Mynewt</a> + <div role="search"> + <form id ="rtd-search-form" class="wy-form" action="../../search.html" method="get"> + <input type="text" name="q" placeholder="Search docs" /> + </form> +</div> + </div> + + <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation"> + <ul class="current"> + + <li> + <li class="toctree-l1 "> + <a class="" href="../..">Home</a> + + </li> +<li> + + <li> + <ul class="subnav"> + <li><span>Get Started</span></li> + + + + <li class="toctree-l1 "> + <a class="" href="../../get_started/newt_concepts/">Newt Concepts</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../../get_started/project1/">Blinky, The First Project</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../../get_started/how_to_edit_docs/">How to edit docs</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../../get_started/try_markdown/">Sample doc to edit</a> + + </li> + + + </ul> +<li> + + <li> + <ul class="subnav"> + <li><span>Get Acclimated</span></li> + + + + <li class="toctree-l1 "> + <a class="" href="../../get_acclimated/vocabulary/">Understanding Newt Terms</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../../get_acclimated/project2/">Project 2</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../../get_acclimated/project3/">Project 3</a> + + </li> + + + </ul> +<li> + + <li> + <ul class="subnav"> + <li><span>Newt Tool</span></li> + + + + <li class="toctree-l1 "> + <a class="" href="../newt_ops/">Command structure</a> + + </li> + + + + <li class="toctree-l1 current"> + <a class="current" href="./">Command list</a> + + <ul> + + <li class="toctree-l3"><a href="#command-list">Command List</a></li> + + <li><a class="toctree-l4" href="#available-high-level-commands">Available high-level commands</a></li> + + <li><a class="toctree-l4" href="#version">version</a></li> + + <li><a class="toctree-l4" href="#help">help</a></li> + + <li><a class="toctree-l4" href="#nest">nest</a></li> + + <li><a class="toctree-l4" href="#egg">egg</a></li> + + <li><a class="toctree-l4" href="#target">target</a></li> + + + </ul> + + </li> + + + </ul> +<li> + + <li> + <ul class="subnav"> + <li><span>Mynewt OS</span></li> + + + + <li class="toctree-l1 "> + <a class="" href="../../os/mynewt_os/">Overview</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../../os/context_switch/">Scheduler/Context Switching</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../../os/time/">Time</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../../os/task/">Tasks</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../../os/event_queue/">Event Queues</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../../os/semaphore/">Semaphores</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../../os/mutex/">Mutexes</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../../os/memory_pool/">Memory Pools</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../../os/heap/">Heap</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../../os/mbufs/">Mbufs</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../../os/sanity/">Sanity</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../../os/callout/">Callout Functions</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../../os/port_os/">Porting to other Platforms</a> + + </li> + + + </ul> +<li> + + <li> + <ul class="subnav"> + <li><span>Chapter5 - Modules</span></li> + + + + <li class="toctree-l1 "> + <a class="" href="../../modules/console/">Console</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../../modules/shell/">Shell</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../../modules/bootloader/">Bootloader</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../../modules/filesystem/">File System</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../../modules/testutil/">Test Utilities</a> + + </li> + + + </ul> +<li> + + <li> + <ul class="subnav"> + <li><span>Chapter6 - Packaging it</span></li> + + + + <li class="toctree-l1 "> + <a class="" href="../../packaging/dist/">Creating Packages</a> + + </li> + + + </ul> +<li> + + </ul> + </div> + + </nav> + + <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"> + + + <nav class="wy-nav-top" role="navigation" aria-label="top navigation"> + <i data-toggle="wy-nav-top" class="fa fa-bars"></i> + <a href="../..">Mynewt</a> + </nav> + + + <div class="wy-nav-content"> + <div class="rst-content"> + <div role="navigation" aria-label="breadcrumbs navigation"> + <ul class="wy-breadcrumbs"> + <li><a href="../..">Docs</a> »</li> + + + + <li>Newt Tool »</li> + + + + <li>Command list</li> + <li class="wy-breadcrumbs-aside"> + + </li> + </ul> + <hr/> +</div> + <div role="main"> + <div class="section"> + + <h2 id="command-list">Command List<a class="headerlink" href="#command-list" title="Permanent link">¶</a></h2> +<h3 id="available-high-level-commands">Available high-level commands<a class="headerlink" href="#available-high-level-commands" title="Permanent link">¶</a></h3> +<pre><code>version Display the Newt version number +help Help about any command +nest Commands to manage nests & clutches (remote egg repositories) +egg Commands to list and inspect eggs on a nest +target Set and view target information +</code></pre> + +<h3 id="version"><em>version</em><a class="headerlink" href="#version" title="Permanent link">¶</a></h3> +<h4 id="usage">Usage:<a class="headerlink" href="#usage" title="Permanent link">¶</a></h4> +<pre><code>newt version [flags] +</code></pre> +<p>Flags:</p> +<pre><code>-h, --help=false: help for version +</code></pre> +<p>Global Flags:</p> +<pre><code>-h, --help=false: help for newt +</code></pre> +<p>Examples</p> +<table> +<thead> +<tr> +<th>Sub-command</th> +<th>Usage</th> +<th>Explanation</th> +</tr> +</thead> +<tbody> +<tr> +<td>version</td> +<td>newt version</td> +<td>Displays the version of newt tool installed</td> +</tr> +</tbody> +</table> +<h3 id="help"><em>help</em><a class="headerlink" href="#help" title="Permanent link">¶</a></h3> +<h4 id="usage_1">Usage:<a class="headerlink" href="#usage_1" title="Permanent link">¶</a></h4> +<pre><code>newt help [input1] +</code></pre> +<p>Flags:</p> +<pre><code> +-h, --help=false: help for newt +-l, --loglevel="WARN": Log level, defaults to WARN. +-q, --quiet=false: Be quiet; only display error output. +-s, --silent=false: Be silent; don't output anything. +-v, --verbose=false: Enable verbose output when executing commands. +</code></pre> + +<p>Examples</p> +<table> +<thead> +<tr> +<th>Sub-command</th> +<th>Usage</th> +<th>Explanation</th> +</tr> +</thead> +<tbody> +<tr> +<td>help</td> +<td>newt help target</td> +<td>Displays the help text for the newt command 'target'</td> +</tr> +<tr> +<td>help</td> +<td>newt help</td> +<td>Displays the help text for newt tool</td> +</tr> +</tbody> +</table> +<h3 id="nest"><em>nest</em><a class="headerlink" href="#nest" title="Permanent link">¶</a></h3> +<h4 id="usage_2">Usage:<a class="headerlink" href="#usage_2" title="Permanent link">¶</a></h4> +<pre><code>newt nest [command][flags] input1 input2... +</code></pre> +<p>Available commands: </p> +<pre><code>create Create a new nest +generate-clutch Generate a clutch file from the eggs in the current directory +add-clutch Add a remote clutch, and put it in the current nest +list-clutches List the clutches installed in the current nest +show-clutch Show an individual clutch in the current nest +</code></pre> +<p>Flags:</p> +<pre><code>-h, --help=false: help for nest +</code></pre> +<p>Global Flags:</p> +<pre><code>-h, --help=false: help for newt +-l, --loglevel="WARN": Log level, defaults to WARN. +-q, --quiet=false: Be quiet; only display error output. +-s, --silent=false: Be silent; don't output anything. +-v, --verbose=false: Enable verbose output when executing commands. +</code></pre> +<p>Description</p> +<table> +<thead> +<tr> +<th>Sub-command</th> +<th>Explanation</th> +</tr> +</thead> +<tbody> +<tr> +<td>create</td> +<td>Downloads the skeleton of a nest on your local machine from the optional <code>input2</code>nest url, if specified, and creates a new nest directory by the name of <code>input1</code> If <code>input2</code>is not specified, then a default skeleton from the <code>tadpole</code>nest on Mynewt is downloaded. The command lays out a generic directory structure for the nest you are going to build under it and includes some default eggs in it.</td> +</tr> +<tr> +<td>generate-clutch</td> +<td>Takes a snapshot of the eggs in the current local directory and combines them into a clutch by the name of <code>input1</code>and with the url of <code>input2</code>and generates a standard output of the clutch details that can be redirected to a <code>.yml</code>clutch file. Typically the clutch file name is chosen to match the clutch name which means the standard output should be directed to a clutch file named <code>input1.yml</code></td> +</tr> +<tr> +<td>add-clutch</td> +<td>Downloads the clutch of the name <code>input1</code>from the master branch of the github repository <code>input2</code>into the current nest. A file named <code>input1.yml</code>file is added in the <code>.nest/clutches</code>subdirectory inside the current local nest. The <code>.nest/</code>directory structure is created automatically if it does not exist.</td> +</tr> +<tr> +<td>list-clutches</td> +<td>Lists all the clutches present in the current nest, including clutches that may have been added from other nests on github. The output shows all the remote clutch names and the total eggshells in each of the clutches.</td> +</tr> +<tr> +<td>show-clutch</td> +<td>Shows information about the clutch that has the name given in the <code>input1</code>argument. Output includes the clutch name, url, and all the constituent eggs with their version numbers.</td> +</tr> +</tbody> +</table> +<p>Command-specific flags</p> +<table> +<thead> +<tr> +<th>Sub-command</th> +<th>Available flags</th> +<th>Explanation</th> +</tr> +</thead> +<tbody> +<tr> +<td>add-clutch</td> +<td>-b, --branch="<branch-name>"</td> +<td>Fetches the clutch file with name <code>input1</code>from the specified branch at <code>input1</code>url of the github repository. All subsequent egg installations will be done from that branch.</td> +</tr> +</tbody> +</table> +<p>Examples</p> +<table> +<thead> +<tr> +<th>Sub-command</th> +<th>Usage</th> +<th>Explanation</th> +</tr> +</thead> +<tbody> +<tr> +<td>create</td> +<td>newt nest create test_project</td> +<td>Creates a new nest named "test_project " using the default skeleton0</td> +</tr> +<tr> +<td>create</td> +<td>newt nest create mynest <nest-url></td> +<td>Creates a new nest named "mynest" using the skeleton at the <nest-url> specified</td> +</tr> +<tr> +<td>generate-clutch</td> +<td>newt nest generate-clutch myclutch https://www.github.com/mynewt/larva > myclutch.yml</td> +<td>Takes a snapshot of the eggs in the current nest to form a clutch named myclutch with the url https://www.github.com/mynewt/larva. The output is written to a file named <code>myclutch.yml</code>and describes the properties and contents of the clutch (name, url, eggs).</td> +</tr> +<tr> +<td>add-clutch</td> +<td>newt nest add-clutch larva https://www.github.com/mynewt/larva</td> +<td>Adds the remote clutch named larva at www.github.com/mynewt/larva to the local nest.</td> +</tr> +<tr> +<td>list-clutches</td> +<td>newt nest list-clutches</td> +<td>Shows all the remote clutch description files that been downloaded into the current nest</td> +</tr> +<tr> +<td>show-clutch</td> +<td>newt nest show-clutch larva</td> +<td>Outputs the details of the clutch named larva such as the github url where the remote sits, the constituent eggs and their versions</td> +</tr> +</tbody> +</table> +<h3 id="egg"><em>egg</em><a class="headerlink" href="#egg" title="Permanent link">¶</a></h3> +<h4 id="usage_3">Usage:<a class="headerlink" href="#usage_3" title="Permanent link">¶</a></h4> +<pre><code>newt egg [command][flag] input1 input2 +</code></pre> +<p>Available Commands: </p> +<pre><code>list List eggs in the current nest +checkdeps Check egg dependencies +hunt Search for egg from clutches +show Show the contents of an egg. +install Install an egg +remove Remove an egg +</code></pre> +<p>Flags:</p> +<pre><code>-h, --help=false: help for egg +</code></pre> +<p>Global Flags:</p> +<pre><code>-l, --loglevel="WARN": Log level, defaults to WARN. +-q, --quiet=false: Be quiet; only display error output. +-s, --silent=false: Be silent; don't output anything. +-v, --verbose=false: Enable verbose output when executing commands. +</code></pre> +<p>Description</p> +<table> +<thead> +<tr> +<th>Sub-command</th> +<th>Explanation</th> +</tr> +</thead> +<tbody> +<tr> +<td>list</td> +<td>List all the eggs in the current nest. The output shows the name, version, path, and any additional attributes of each egg in the nest such as dependencies, capabilities, and linker scripts. The newt command gets the attributes of each egg from the corresponsing egg.yml description file.</td> +</tr> +<tr> +<td>checkdeps</td> +<td>Resolve all dependencies in the local nest. This command goes through all eggs currently installed, checks their dependencies, and prints any unresolved dependencies between eggs.</td> +</tr> +<tr> +<td>hunt</td> +<td>Hunts for an egg, specified by <code>input1</code> The local nest, along with all remote nests (clutches) are searched. All matched eggs are shown along with the clutch informaton. Installed eggs are called out as such. The command can be invoked from anywhere in the nest.</td> +</tr> +<tr> +<td>show</td> +<td>Show the contents of the egg named <code>input2</code>found in the clutch named <code>input1</code> The clutch name is optional; if only the egg name is given as the argument it is resolved using all the clutches installed in the current nest. If the egg is present in multiple clutches it will list all of them along with the clutch information for each.</td> +</tr> +<tr> +<td>install</td> +<td>Install the egg specified by <code>input2</code>from the clutch named <code>input1</code> The command downloads the egg from the github repository using the URL in the clutch description file (typically donwloaded as 'input1@<branch-name>.yml' in .nest/clutches). It also downloads all the dependencies (constituent eggs) as decribed in the egg's description file ('egg.yml') and installs all of them. The clutch name is optional. If only the egg name is given as the argument, the command looks for the egg name in all the clutches in the local nest and installs accordingly. An egg is installed by this command only if it has not already been installed.</td> +</tr> +<tr> +<td>remove</td> +<td>Remove an egg named <code>input2</code>from clutch <code>input1</code> if clutch is specified. Otherwise only one input required - that of the name of the egg to be removed from the local nest.</td> +</tr> +</tbody> +</table> +<p>Command-specific flags</p> +<table> +<thead> +<tr> +<th>Sub-command</th> +<th>Available flags</th> +<th>Explanation</th> +</tr> +</thead> +<tbody> +<tr> +<td>install</td> +<td>-b, --branch="<branch-name>"</td> +<td>Installs the eggs from the branch name or tag of the clutch specified</td> +</tr> +</tbody> +</table> +<p>Examples</p> +<table> +<thead> +<tr> +<th>Sub-command</th> +<th>Usage</th> +<th>Explanation</th> +</tr> +</thead> +<tbody> +<tr> +<td>list</td> +<td>newt egg list</td> +<td>CList all of the eggs in the current nest and the details of the eggs.</td> +</tr> +<tr> +<td>checkdeps</td> +<td>newt egg checkdeps</td> +<td>Checks all the dependencies between eggs in the nest. Lists any unresolved dependencies.</td> +</tr> +<tr> +<td>hunt</td> +<td>newt egg hunt blinky</td> +<td>Hunts for the egg named 'blinky'. The command can be invoked from anywhere in the nest. Results show if the egg is installed and which clutch, if any, has the egg.</td> +</tr> +<tr> +<td>show</td> +<td>newt egg show larva libs/os</td> +<td>Show the contents of the egg named 'libs/os' in the clutch named larva. The contents are essentially derived from the egg's 'egg.yml' file.</td> +</tr> +<tr> +<td>install</td> +<td>newt egg install hw/bsp/stm32f3discovery</td> +<td>Downloads and installs the egg named "stm32f3discovery" (specified with its full path name inside the remote nest) along with all its dependencies from the remote nest on github. Since no clutch is specified, the URL for the remote nest in the clutch description file found in the local nest (in .nest/clutches for the project) is used.</td> +</tr> +<tr> +<td>remove</td> +<td>newt egg remove larva blinky</td> +<td>Removes the egg named blinky only from the clutch named larva</td> +</tr> +<tr> +<td>remove</td> +<td>newt egg remove blinky</td> +<td>Removes the egg named blinky from the local nest</td> +</tr> +</tbody> +</table> +<h3 id="target"><em>target</em><a class="headerlink" href="#target" title="Permanent link">¶</a></h3> +<h4 id="usage_4">Usage:<a class="headerlink" href="#usage_4" title="Permanent link">¶</a></h4> +<p>Usage: </p> +<pre><code>newt target [command] input1 [flag1] [flag2] +</code></pre> +<p>Available Commands: </p> +<pre><code>set Set target configuration variable +unset Unset target configuration variable +delete Delete target +create Create a target +show View target configuration variables +build Build target +test Test target +export Export target +import Import target +download Download image to target +debug Download image to target and start an openocd/gdb session +</code></pre> +<p>Flags:</p> +<pre><code>-h, --help=false: help for target +</code></pre> +<p>Global Flags:</p> +<pre><code>-l, --loglevel="WARN": Log level, defaults to WARN. +-q, --quiet=false: Be quiet; only display error output. +-s, --silent=false: Be silent; don't output anything. +-v, --verbose=false: Enable verbose output when executing commands. +</code></pre> +<p>Description</p> +<table> +<thead> +<tr> +<th>Sub-command</th> +<th>Explanation</th> +</tr> +</thead> +<tbody> +<tr> +<td>set</td> +<td>Set attributes of the target. Currently the list of possible attributes are:<code>arch, compiler, compiler_def, project, bsp, egg, identities, capabilities, dependencies, cflags, lflags</code> Typically only the first 5 need to be set for a hardware target. For a simulated target, e.g. for software testing purposes, <code>arch=sim</code> <code>compiler=sim</code> and <code>egg=<egg name to be tested></code> You cannot set both the project and egg for a target.</td> +</tr> +<tr> +<td>unset</td> +<td>Unset attributes of the target in its configuration.</td> +</tr> +<tr> +<td>delete</td> +<td>Deletes only the description for the target. Does not delete the target directory with associated binaries. If you want to clean out the binaries, list files, and executables use<code>newt target build <target-name> clean</code><strong>before</strong> deleting the target!</td> +</tr> +<tr> +<td>create</td> +<td>Creates a target description or build definition by the name <code>input1</code> By default it assigns the sim (simulator) architecture to it which allows you to build new projects and software on your native OS and try it out.</td> +</tr> +<tr> +<td>show</td> +<td>Display the configuration defined for the target named <code>input1</code> If no <code>input1</code>is specified then show the details for all the targets in the nest.</td> +</tr> +<tr> +<td>build</td> +<td>Build the source code into an image that can be loaded on the hardware associated with the target named <code>input1</code>to do the application enabled by the 'project' associated with that target (via the target definition). It creates 'bin/' and 'bin/<input1>/' subdirectories inside the base directory for the project, compiles and generates binaries and executables, and places them in 'bin/<input1>/.</td> +</tr> +<tr> +<td>test</td> +<td>Test an egg on the target named <code>input1</code> The egg is either supplied as an argument to the command line invocation of <code>newt target test</code>or added as part of the target definition. If only the target is specified as <code>input1</code> then the egg in the target's definition is automatically chosen to be tested. You currently cannot test an entire project on a hardware target. The test command is envisioned for use if one or two eggs gets updated and each needs to be tested against a target. Alternatively, a script may be written for a series of tests on several eggs.</td> +</tr> +<tr> +<td>export</td> +<td>Exports the configurations of the specified target <code>input1</code> If -a or -export-all flag is used, then all targets are exported and printed out to standard out. You may redirect the output to a file.</td> +</tr> +<tr> +<td>import</td> +<td>Import one or more target configuration from standard input or a file. Each target starts with <code>@target=<target-name></code>followed by the attributes. The list of targets should end with <code>@endtargets</code></td> +</tr> +<tr> +<td>size</td> +<td>Outputs the RAM and flash consumption by the components of the specified target <code>input1</code></td> +</tr> +<tr> +<td>download</td> +<td>Downloads the binary executable <code><target-name>.elf.bin</code>to the board.</td> +</tr> +<tr> +<td>debug</td> +<td>Downloads the binary executable <code><target-name>.elf.bin</code>to the board and starts up the openocd/gdb combination session. gdb takes over the terminal.</td> +</tr> +</tbody> +</table> +<p>Command-specific flags</p> +<table> +<thead> +<tr> +<th>Sub-command</th> +<th>Available flags</th> +<th>Explanation</th> +</tr> +</thead> +<tbody> +<tr> +<td>build</td> +<td>clean</td> +<td>All the binaries and object files for the specified target will be removed. The subdirectory named after the specified target within that project is removed.</td> +</tr> +<tr> +<td>build clean</td> +<td>all</td> +<td>All the binaries and object files for all targets are removed, and subdirectories of all targets for the project are removed. However, the entire repository is not emptied since any eggs or projects that the specified target doesn't reference are not touched.</td> +</tr> +<tr> +<td>export</td> +<td>-a, -export-all</td> +<td>Export all targets. <code>input1</code>is not necessary when this flag is used.</td> +</tr> +<tr> +<td>import</td> +<td>-a, -import-all</td> +<td>Import all targets typed into standard input or redirected from a file.</td> +</tr> +</tbody> +</table> +<p>Examples</p> +<table> +<thead> +<tr> +<th>Sub-command</th> +<th>Usage</th> +<th>Explanation</th> +</tr> +</thead> +<tbody> +<tr> +<td>set</td> +<td>newt target set myblinky compiler=arm-none-eabi-m4</td> +<td>Set the compiler for the 'myblinky' target to the gcc compiler for embedded ARM chips.</td> +</tr> +<tr> +<td>unset</td> +<td>newt target unset myblinky compiler</td> +<td>Remove the setting for the compiler for the 'myblinky' target.</td> +</tr> +<tr> +<td>delete</td> +<td>newt target delete myblinky</td> +<td>Delete the target description for the target named 'myblinky'. Note that it does not remove any binaries or clean out the directory for this target.</td> +</tr> +<tr> +<td>create</td> +<td>newt target create blink_f3disc</td> +<td>Create a new target description by the name 'blink_f3disc'. The architecture is 'sim' by default and can be changed using subcommand 'set' above.</td> +</tr> +<tr> +<td>show</td> +<td>newt target show myblinky</td> +<td>Show the target attributes set for 'myblinky'</td> +</tr> +<tr> +<td>build</td> +<td>newt target build blink_f3disc</td> +<td>Compile the source code for the target named blink_f3disc and generate binaries that can be loaded into the target hardware.</td> +</tr> +<tr> +<td>test</td> +<td>newt target test test_target egg=libs/os</td> +<td>Tests the egg named 'libs/os' against the target named 'test_target'</td> +</tr> +<tr> +<td>export</td> +<td>newt target export -a > my_exports.txt</td> +<td>Export all build targets from the current nest, and redirect output to a file named 'my_exports.txt'.</td> +</tr> +<tr> +<td>export</td> +<td>newt target export -export-all</td> +<td>Export all build targets from the current nest, and print them to standard output on the screen.</td> +</tr> +<tr> +<td>export</td> +<td>newt target export my_target</td> +<td>Export only target named 'my_target' and print it to standard output on the screen.</td> +</tr> +<tr> +<td>import</td> +<td>newt target import ex_tgt_1 < exported_targets.txt</td> +<td>Imports the target configuration for 'ex_tgt_1' in 'exported_targets.txt'.</td> +</tr> +<tr> +<td>import</td> +<td>newt target import -a < in_targets.txt</td> +<td>Imports all the targets specified in the file named <code>in_targets.txt</code> A sample file is shown after this table.</td> +</tr> +<tr> +<td>size</td> +<td>newt target size blink_nordic</td> +<td>Inspects and lists the RAM and Flash memory use by each component (object files and libraries) of the target.</td> +</tr> +<tr> +<td>download</td> +<td>newt target -v -lVERBOSE download blinky</td> +<td>Downloads <code>blinky.elf.bin</code>to the hardware in verbose mode with logging turned on at VERBOSE level.</td> +</tr> +<tr> +<td>debug</td> +<td>newt target debug blinky</td> +<td>Downloads <code>blinky.elf.bin</code>to the hardware, opens up a gdb session with <code>blinky.elf</code>in the terminal, and halts for further input in gdb.</td> +</tr> +</tbody> +</table> +<p>Example content for <code>in_targets.txt</code> file used for importing targets <code>test3</code> and <code>test4</code>. </p> +<blockquote> +<p>@target=test3<br /> +project=blinked<br /> +arch=sim<br /> +compiler_def=debug<br /> +compiler=arm-none-eabi-m4<br /> +@target=test4<br /> +project=super_blinky<br /> +arch=sim<br /> +compiler_def=debug<br /> +compiler=arm-none-eabi-m4<br /> +@endtargets</p> +</blockquote> + + </div> + </div> + <footer> + + <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation"> + + <a href="../../os/mynewt_os/" class="btn btn-neutral float-right" title="Overview"/>Next <span class="icon icon-circle-arrow-right"></span></a> + + + <a href="../newt_ops/" class="btn btn-neutral" title="Command structure"><span class="icon icon-circle-arrow-left"></span> Previous</a> + + </div> + + + <hr/> + + <div role="contentinfo"> + <!-- Copyright etc --> + + </div> + + Built with <a href="http://www.mkdocs.org";>MkDocs</a> using a <a href="https://github.com/snide/sphinx_rtd_theme";>theme</a> provided by <a href="https://readthedocs.org";>Read the Docs</a>. +</footer> + + </div> + </div> + + </section> + + </div> + +<div class="rst-versions" role="note" style="cursor: pointer"> + <span class="rst-current-version" data-toggle="rst-current-version"> + + + <span><a href="../newt_ops/" style="color: #fcfcfc;">« Previous</a></span> + + + <span style="margin-left: 15px"><a href="../../os/mynewt_os/" style="color: #fcfcfc">Next »</a></span> + + </span> +</div> + +</body> +</html> http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/2c998465/os/callout/index.html ---------------------------------------------------------------------- diff --git a/os/callout/index.html b/os/callout/index.html new file mode 100644 index 0000000..9ae4625 --- /dev/null +++ b/os/callout/index.html @@ -0,0 +1,536 @@ +<!DOCTYPE html> +<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]--> +<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]--> +<head> + <meta charset="utf-8"> + <meta name="viewport" content="width=device-width, initial-scale=1.0"> + + <title>Callout Functions - Mynewt</title> + + + <link rel="shortcut icon" href="../../img/favicon.ico"> + + + <link href='https://fonts.googleapis.com/css?family=Lato:400,700|Roboto+Slab:400,700|Inconsolata:400,700' rel='stylesheet' type='text/css'> + + <link rel="stylesheet" href="../../css/theme.css" type="text/css" /> + <link rel="stylesheet" href="../../css/theme_extra.css" type="text/css" /> + <link rel="stylesheet" href="../../css/highlight.css"> + <link href="../../extra.css" rel="stylesheet"> + + + <script> + // Current page data + var mkdocs_page_name = "Callout Functions"; + </script> + + <script src="../../js/jquery-2.1.1.min.js"></script> + <script src="../../js/modernizr-2.8.3.min.js"></script> + <script type="text/javascript" src="../../js/highlight.pack.js"></script> + <script src="../../js/theme.js"></script> + + +</head> + +<body class="wy-body-for-nav" role="document"> + + <div class="wy-grid-for-nav"> + + + <nav data-toggle="wy-nav-shift" class="wy-nav-side stickynav"> + <div class="wy-side-nav-search"> + <a href="../.." class="icon icon-home"> Mynewt</a> + <div role="search"> + <form id ="rtd-search-form" class="wy-form" action="../../search.html" method="get"> + <input type="text" name="q" placeholder="Search docs" /> + </form> +</div> + </div> + + <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation"> + <ul class="current"> + + <li> + <li class="toctree-l1 "> + <a class="" href="../..">Home</a> + + </li> +<li> + + <li> + <ul class="subnav"> + <li><span>Get Started</span></li> + + + + <li class="toctree-l1 "> + <a class="" href="../../get_started/newt_concepts/">Newt Concepts</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../../get_started/project1/">Blinky, The First Project</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../../get_started/how_to_edit_docs/">How to edit docs</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../../get_started/try_markdown/">Sample doc to edit</a> + + </li> + + + </ul> +<li> + + <li> + <ul class="subnav"> + <li><span>Get Acclimated</span></li> + + + + <li class="toctree-l1 "> + <a class="" href="../../get_acclimated/vocabulary/">Understanding Newt Terms</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../../get_acclimated/project2/">Project 2</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../../get_acclimated/project3/">Project 3</a> + + </li> + + + </ul> +<li> + + <li> + <ul class="subnav"> + <li><span>Newt Tool</span></li> + + + + <li class="toctree-l1 "> + <a class="" href="../../newt/newt_ops/">Command structure</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../../newt/newt_tool_reference/">Command list</a> + + </li> + + + </ul> +<li> + + <li> + <ul class="subnav"> + <li><span>Mynewt OS</span></li> + + + + <li class="toctree-l1 "> + <a class="" href="../mynewt_os/">Overview</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../context_switch/">Scheduler/Context Switching</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../time/">Time</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../task/">Tasks</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../event_queue/">Event Queues</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../semaphore/">Semaphores</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../mutex/">Mutexes</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../memory_pool/">Memory Pools</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../heap/">Heap</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../mbufs/">Mbufs</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../sanity/">Sanity</a> + + </li> + + + + <li class="toctree-l1 current"> + <a class="current" href="./">Callout Functions</a> + + <ul> + + <li class="toctree-l3"><a href="#callout">Callout</a></li> + + <li><a class="toctree-l4" href="#description">Description</a></li> + + <li><a class="toctree-l4" href="#data-structures">Data structures</a></li> + + <li><a class="toctree-l4" href="#list-of-functions">List of Functions</a></li> + + <li><a class="toctree-l4" href="#function-reference">Function Reference</a></li> + + + </ul> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../port_os/">Porting to other Platforms</a> + + </li> + + + </ul> +<li> + + <li> + <ul class="subnav"> + <li><span>Chapter5 - Modules</span></li> + + + + <li class="toctree-l1 "> + <a class="" href="../../modules/console/">Console</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../../modules/shell/">Shell</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../../modules/bootloader/">Bootloader</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../../modules/filesystem/">File System</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../../modules/testutil/">Test Utilities</a> + + </li> + + + </ul> +<li> + + <li> + <ul class="subnav"> + <li><span>Chapter6 - Packaging it</span></li> + + + + <li class="toctree-l1 "> + <a class="" href="../../packaging/dist/">Creating Packages</a> + + </li> + + + </ul> +<li> + + </ul> + </div> + + </nav> + + <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"> + + + <nav class="wy-nav-top" role="navigation" aria-label="top navigation"> + <i data-toggle="wy-nav-top" class="fa fa-bars"></i> + <a href="../..">Mynewt</a> + </nav> + + + <div class="wy-nav-content"> + <div class="rst-content"> + <div role="navigation" aria-label="breadcrumbs navigation"> + <ul class="wy-breadcrumbs"> + <li><a href="../..">Docs</a> »</li> + + + + <li>Mynewt OS »</li> + + + + <li>Callout Functions</li> + <li class="wy-breadcrumbs-aside"> + + </li> + </ul> + <hr/> +</div> + <div role="main"> + <div class="section"> + + <h1 id="callout">Callout<a class="headerlink" href="#callout" title="Permanent link">¶</a></h1> +<h2 id="description">Description<a class="headerlink" href="#description" title="Permanent link">¶</a></h2> +<p>Describe OS feature here </p> +<h2 id="data-structures">Data structures<a class="headerlink" href="#data-structures" title="Permanent link">¶</a></h2> +<p>Replace this with the list of data structures used, why, any neat features</p> +<h2 id="list-of-functions">List of Functions<a class="headerlink" href="#list-of-functions" title="Permanent link">¶</a></h2> +<p><List all the functions here. Note how the anchors work. You put the text you want to show up as a link within [] and the relevant #heading within (). Note that the words of the heading need to be connected with a dash for the anchor to work. Hence the word "function" and the function name is connected with a dash, not underscore! And the header has to have at least 2 words for the anchor to work - that's how it is.></p> +<p>The functions available in this OS feature are:</p> +<ul> +<li><a href="#function-os_callout_init">os_callout_init</a></li> +<li><a href="#function-os_callout_func_init">os_callout_func_init</a></li> +<li>add the rest</li> +</ul> +<h2 id="function-reference">Function Reference<a class="headerlink" href="#function-reference" title="Permanent link">¶</a></h2> +<hr /> +<h3 id="function-os_callout_init"><font color="2980b9">function os_callout_init</font><a class="headerlink" href="#function-os_callout_init" title="Permanent link">¶</a></h3> +<pre><code> void + os_callout_init(struct os_callout *c, struct os_eventq *evq, void *ev_arg) + +</code></pre> + +<p><Insert short description></p> +<h4 id="arguments">Arguments<a class="headerlink" href="#arguments" title="Permanent link">¶</a></h4> +<table> +<thead> +<tr> +<th>Arguments</th> +<th>Description</th> +</tr> +</thead> +<tbody> +<tr> +<td>xx</td> +<td>explain argument xx</td> +</tr> +<tr> +<td>yy</td> +<td>explain argument yy</td> +</tr> +</tbody> +</table> +<h4 id="returned-values">Returned values<a class="headerlink" href="#returned-values" title="Permanent link">¶</a></h4> +<p>List any values returned. +Error codes?</p> +<h4 id="notes">Notes<a class="headerlink" href="#notes" title="Permanent link">¶</a></h4> +<p>Any special feature/special benefit that we want to tout. +Does it need to be used with some other specific functions? +Any caveats to be careful about (e.g. high memory requirements).</p> +<h4 id="example">Example<a class="headerlink" href="#example" title="Permanent link">¶</a></h4> +<p><Add text to set up the context for the example here></p> +<pre><code> +<Insert the code snippet here> + +</code></pre> + +<hr /> +<h3 id="function-os_callout_func_init"><font color="#2980b9"> function os_callout_func_init</font><a class="headerlink" href="#function-os_callout_func_init" title="Permanent link">¶</a></h3> +<pre><code> <Insert function callout here > + +</code></pre> + +<p><Insert short description></p> +<h4 id="arguments_1">Arguments<a class="headerlink" href="#arguments_1" title="Permanent link">¶</a></h4> +<table> +<thead> +<tr> +<th>Arguments</th> +<th>Description</th> +</tr> +</thead> +<tbody> +<tr> +<td>xx</td> +<td>explain argument xx</td> +</tr> +<tr> +<td>yy</td> +<td>explain argument yy</td> +</tr> +</tbody> +</table> +<h4 id="returned-values_1">Returned values<a class="headerlink" href="#returned-values_1" title="Permanent link">¶</a></h4> +<p>List any values returned. +Error codes?</p> +<h4 id="notes_1">Notes<a class="headerlink" href="#notes_1" title="Permanent link">¶</a></h4> +<p>Any special feature/special benefit that we want to tout. +Does it need to be used with some other specific functions? +Any caveats to be careful about (e.g. high memory requirements).</p> +<h4 id="example_1">Example<a class="headerlink" href="#example_1" title="Permanent link">¶</a></h4> +<p><Add text to set up the context for the example here></p> +<pre><code> +<Insert the code snippet here> + +</code></pre> + +<hr /> +<h3 id="function-next_one"><font color="#2980b9"> function next_one </font><a class="headerlink" href="#function-next_one" title="Permanent link">¶</a></h3> +<pre><code> <Insert function callout here > + +</code></pre> + +<p><Insert short description></p> +<h4 id="arguments_2">Arguments<a class="headerlink" href="#arguments_2" title="Permanent link">¶</a></h4> +<table> +<thead> +<tr> +<th>Arguments</th> +<th>Description</th> +</tr> +</thead> +<tbody> +<tr> +<td>xx</td> +<td>explain argument xx</td> +</tr> +<tr> +<td>yy</td> +<td>explain argument yy</td> +</tr> +</tbody> +</table> +<h4 id="returned-values_2">Returned values<a class="headerlink" href="#returned-values_2" title="Permanent link">¶</a></h4> +<p>List any values returned. +Error codes?</p> +<h4 id="notes_2">Notes<a class="headerlink" href="#notes_2" title="Permanent link">¶</a></h4> +<p>Any special feature/special benefit that we want to tout. +Does it need to be used with some other specific functions? +Any caveats to be careful about (e.g. high memory requirements).</p> +<h4 id="example_2">Example<a class="headerlink" href="#example_2" title="Permanent link">¶</a></h4> +<p><Add text to set up the context for the example here></p> +<pre><code> +<Insert the code snippet here> + +</code></pre> + +<hr /> + + </div> + </div> + <footer> + + <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation"> + + <a href="../port_os/" class="btn btn-neutral float-right" title="Porting to other Platforms"/>Next <span class="icon icon-circle-arrow-right"></span></a> + + + <a href="../sanity/" class="btn btn-neutral" title="Sanity"><span class="icon icon-circle-arrow-left"></span> Previous</a> + + </div> + + + <hr/> + + <div role="contentinfo"> + <!-- Copyright etc --> + + </div> + + Built with <a href="http://www.mkdocs.org";>MkDocs</a> using a <a href="https://github.com/snide/sphinx_rtd_theme";>theme</a> provided by <a href="https://readthedocs.org";>Read the Docs</a>. +</footer> + + </div> + </div> + + </section> + + </div> + +<div class="rst-versions" role="note" style="cursor: pointer"> + <span class="rst-current-version" data-toggle="rst-current-version"> + + + <span><a href="../sanity/" style="color: #fcfcfc;">« Previous</a></span> + + + <span style="margin-left: 15px"><a href="../port_os/" style="color: #fcfcfc">Next »</a></span> + + </span> +</div> + +</body> +</html> http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/2c998465/os/context_switch/index.html ---------------------------------------------------------------------- diff --git a/os/context_switch/index.html b/os/context_switch/index.html new file mode 100644 index 0000000..53ae7d4 --- /dev/null +++ b/os/context_switch/index.html @@ -0,0 +1,536 @@ +<!DOCTYPE html> +<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]--> +<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]--> +<head> + <meta charset="utf-8"> + <meta name="viewport" content="width=device-width, initial-scale=1.0"> + + <title>Scheduler/Context Switching - Mynewt</title> + + + <link rel="shortcut icon" href="../../img/favicon.ico"> + + + <link href='https://fonts.googleapis.com/css?family=Lato:400,700|Roboto+Slab:400,700|Inconsolata:400,700' rel='stylesheet' type='text/css'> + + <link rel="stylesheet" href="../../css/theme.css" type="text/css" /> + <link rel="stylesheet" href="../../css/theme_extra.css" type="text/css" /> + <link rel="stylesheet" href="../../css/highlight.css"> + <link href="../../extra.css" rel="stylesheet"> + + + <script> + // Current page data + var mkdocs_page_name = "Scheduler/Context Switching"; + </script> + + <script src="../../js/jquery-2.1.1.min.js"></script> + <script src="../../js/modernizr-2.8.3.min.js"></script> + <script type="text/javascript" src="../../js/highlight.pack.js"></script> + <script src="../../js/theme.js"></script> + + +</head> + +<body class="wy-body-for-nav" role="document"> + + <div class="wy-grid-for-nav"> + + + <nav data-toggle="wy-nav-shift" class="wy-nav-side stickynav"> + <div class="wy-side-nav-search"> + <a href="../.." class="icon icon-home"> Mynewt</a> + <div role="search"> + <form id ="rtd-search-form" class="wy-form" action="../../search.html" method="get"> + <input type="text" name="q" placeholder="Search docs" /> + </form> +</div> + </div> + + <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation"> + <ul class="current"> + + <li> + <li class="toctree-l1 "> + <a class="" href="../..">Home</a> + + </li> +<li> + + <li> + <ul class="subnav"> + <li><span>Get Started</span></li> + + + + <li class="toctree-l1 "> + <a class="" href="../../get_started/newt_concepts/">Newt Concepts</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../../get_started/project1/">Blinky, The First Project</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../../get_started/how_to_edit_docs/">How to edit docs</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../../get_started/try_markdown/">Sample doc to edit</a> + + </li> + + + </ul> +<li> + + <li> + <ul class="subnav"> + <li><span>Get Acclimated</span></li> + + + + <li class="toctree-l1 "> + <a class="" href="../../get_acclimated/vocabulary/">Understanding Newt Terms</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../../get_acclimated/project2/">Project 2</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../../get_acclimated/project3/">Project 3</a> + + </li> + + + </ul> +<li> + + <li> + <ul class="subnav"> + <li><span>Newt Tool</span></li> + + + + <li class="toctree-l1 "> + <a class="" href="../../newt/newt_ops/">Command structure</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../../newt/newt_tool_reference/">Command list</a> + + </li> + + + </ul> +<li> + + <li> + <ul class="subnav"> + <li><span>Mynewt OS</span></li> + + + + <li class="toctree-l1 "> + <a class="" href="../mynewt_os/">Overview</a> + + </li> + + + + <li class="toctree-l1 current"> + <a class="current" href="./">Scheduler/Context Switching</a> + + <ul> + + <li class="toctree-l3"><a href="#schedulercontext-switching">Scheduler/Context Switching</a></li> + + <li><a class="toctree-l4" href="#description">Description</a></li> + + <li><a class="toctree-l4" href="#data-structures">Data structures</a></li> + + <li><a class="toctree-l4" href="#list-of-functions">List of Functions</a></li> + + <li><a class="toctree-l4" href="#function-reference">Function Reference</a></li> + + + </ul> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../time/">Time</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../task/">Tasks</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../event_queue/">Event Queues</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../semaphore/">Semaphores</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../mutex/">Mutexes</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../memory_pool/">Memory Pools</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../heap/">Heap</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../mbufs/">Mbufs</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../sanity/">Sanity</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../callout/">Callout Functions</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../port_os/">Porting to other Platforms</a> + + </li> + + + </ul> +<li> + + <li> + <ul class="subnav"> + <li><span>Chapter5 - Modules</span></li> + + + + <li class="toctree-l1 "> + <a class="" href="../../modules/console/">Console</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../../modules/shell/">Shell</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../../modules/bootloader/">Bootloader</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../../modules/filesystem/">File System</a> + + </li> + + + + <li class="toctree-l1 "> + <a class="" href="../../modules/testutil/">Test Utilities</a> + + </li> + + + </ul> +<li> + + <li> + <ul class="subnav"> + <li><span>Chapter6 - Packaging it</span></li> + + + + <li class="toctree-l1 "> + <a class="" href="../../packaging/dist/">Creating Packages</a> + + </li> + + + </ul> +<li> + + </ul> + </div> + + </nav> + + <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"> + + + <nav class="wy-nav-top" role="navigation" aria-label="top navigation"> + <i data-toggle="wy-nav-top" class="fa fa-bars"></i> + <a href="../..">Mynewt</a> + </nav> + + + <div class="wy-nav-content"> + <div class="rst-content"> + <div role="navigation" aria-label="breadcrumbs navigation"> + <ul class="wy-breadcrumbs"> + <li><a href="../..">Docs</a> »</li> + + + + <li>Mynewt OS »</li> + + + + <li>Scheduler/Context Switching</li> + <li class="wy-breadcrumbs-aside"> + + </li> + </ul> + <hr/> +</div> + <div role="main"> + <div class="section"> + + <h1 id="schedulercontext-switching">Scheduler/Context Switching<a class="headerlink" href="#schedulercontext-switching" title="Permanent link">¶</a></h1> +<p>Insert synopsis here</p> +<h2 id="description">Description<a class="headerlink" href="#description" title="Permanent link">¶</a></h2> +<p>Describe scheduler here</p> +<h2 id="data-structures">Data structures<a class="headerlink" href="#data-structures" title="Permanent link">¶</a></h2> +<p>Replace this with the list of data structures used, why, any neat features</p> +<h2 id="list-of-functions">List of Functions<a class="headerlink" href="#list-of-functions" title="Permanent link">¶</a></h2> +<p><List all the functions here. Note how the anchors work. You put the text you want to show up as a link within [] and the relevant #heading within (). Note that the words of the heading need to be connected with a dash for the anchor to work. Hence the word "function" and the function name is connected with a dash, not underscore! And the header has to have at least 2 words for the anchor to work - that's how it is.></p> +<p>The functions available in the scheduler are:</p> +<ul> +<li><a href="#function-os_sched_insert">os_sched_insert</a></li> +<li><a href="#function-os_sched_walk">os_sched_walk</a></li> +<li>add the rest</li> +</ul> +<h2 id="function-reference">Function Reference<a class="headerlink" href="#function-reference" title="Permanent link">¶</a></h2> +<hr /> +<h3 id="function-os_sched_insert"><font color="2980b9">function os_sched_insert</font><a class="headerlink" href="#function-os_sched_insert" title="Permanent link">¶</a></h3> +<pre><code> os_error_t + os_sched_insert(struct os_task *t) +</code></pre> + +<p><Insert short description></p> +<h4 id="arguments">Arguments<a class="headerlink" href="#arguments" title="Permanent link">¶</a></h4> +<table> +<thead> +<tr> +<th>Arguments</th> +<th>Description</th> +</tr> +</thead> +<tbody> +<tr> +<td>xx</td> +<td>explain argument xx</td> +</tr> +<tr> +<td>yy</td> +<td>explain argument yy</td> +</tr> +</tbody> +</table> +<h4 id="returned-values">Returned values<a class="headerlink" href="#returned-values" title="Permanent link">¶</a></h4> +<p>List any values returned. +Error codes?</p> +<h4 id="notes">Notes<a class="headerlink" href="#notes" title="Permanent link">¶</a></h4> +<p>Any special feature/special benefit that we want to tout. +Does it need to be used with some other specific functions? +Any caveats to be careful about (e.g. high memory requirements).</p> +<h4 id="example">Example<a class="headerlink" href="#example" title="Permanent link">¶</a></h4> +<p><Add text to set up the context for the example here></p> +<pre><code> +<Insert the code snippet here> + +</code></pre> + +<hr /> +<h3 id="function-os_sched_walk"><font color="#2980b9"> function os_sched_walk</font><a class="headerlink" href="#function-os_sched_walk" title="Permanent link">¶</a></h3> +<pre><code> <Insert function callout here > + +</code></pre> + +<p><Insert short description></p> +<h4 id="arguments_1">Arguments<a class="headerlink" href="#arguments_1" title="Permanent link">¶</a></h4> +<table> +<thead> +<tr> +<th>Arguments</th> +<th>Description</th> +</tr> +</thead> +<tbody> +<tr> +<td>xx</td> +<td>explain argument xx</td> +</tr> +<tr> +<td>yy</td> +<td>explain argument yy</td> +</tr> +</tbody> +</table> +<h4 id="returned-values_1">Returned values<a class="headerlink" href="#returned-values_1" title="Permanent link">¶</a></h4> +<p>List any values returned. +Error codes?</p> +<h4 id="notes_1">Notes<a class="headerlink" href="#notes_1" title="Permanent link">¶</a></h4> +<p>Any special feature/special benefit that we want to tout. +Does it need to be used with some other specific functions? +Any caveats to be careful about (e.g. high memory requirements).</p> +<h4 id="example_1">Example<a class="headerlink" href="#example_1" title="Permanent link">¶</a></h4> +<p><Add text to set up the context for the example here></p> +<pre><code> +<Insert the code snippet here> + +</code></pre> + +<hr /> +<h3 id="function-next_one"><font color="#2980b9"> function next_one </font><a class="headerlink" href="#function-next_one" title="Permanent link">¶</a></h3> +<pre><code> <Insert function callout here > + +</code></pre> + +<p><Insert short description></p> +<h4 id="arguments_2">Arguments<a class="headerlink" href="#arguments_2" title="Permanent link">¶</a></h4> +<table> +<thead> +<tr> +<th>Arguments</th> +<th>Description</th> +</tr> +</thead> +<tbody> +<tr> +<td>xx</td> +<td>explain argument xx</td> +</tr> +<tr> +<td>yy</td> +<td>explain argument yy</td> +</tr> +</tbody> +</table> +<h4 id="returned-values_2">Returned values<a class="headerlink" href="#returned-values_2" title="Permanent link">¶</a></h4> +<p>List any values returned. +Error codes?</p> +<h4 id="notes_2">Notes<a class="headerlink" href="#notes_2" title="Permanent link">¶</a></h4> +<p>Any special feature/special benefit that we want to tout. +Does it need to be used with some other specific functions? +Any caveats to be careful about (e.g. high memory requirements).</p> +<h4 id="example_2">Example<a class="headerlink" href="#example_2" title="Permanent link">¶</a></h4> +<p><Add text to set up the context for the example here></p> +<pre><code> +<Insert the code snippet here> + +</code></pre> + +<hr /> + + </div> + </div> + <footer> + + <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation"> + + <a href="../time/" class="btn btn-neutral float-right" title="Time"/>Next <span class="icon icon-circle-arrow-right"></span></a> + + + <a href="../mynewt_os/" class="btn btn-neutral" title="Overview"><span class="icon icon-circle-arrow-left"></span> Previous</a> + + </div> + + + <hr/> + + <div role="contentinfo"> + <!-- Copyright etc --> + + </div> + + Built with <a href="http://www.mkdocs.org";>MkDocs</a> using a <a href="https://github.com/snide/sphinx_rtd_theme";>theme</a> provided by <a href="https://readthedocs.org";>Read the Docs</a>. +</footer> + + </div> + </div> + + </section> + + </div> + +<div class="rst-versions" role="note" style="cursor: pointer"> + <span class="rst-current-version" data-toggle="rst-current-version"> + + + <span><a href="../mynewt_os/" style="color: #fcfcfc;">« Previous</a></span> + + + <span style="margin-left: 15px"><a href="../time/" style="color: #fcfcfc">Next »</a></span> + + </span> +</div> + +</body> +</html>
