bl_iot_sdk/docs/html/Examples/demo_system_cli/cli.html

313 lines
13 KiB
HTML
Raw Normal View History

2020-10-26 12:43:20 +00:00
<!DOCTYPE html>
<html class="writer-html5" lang="zh" >
<head>
<meta charset="utf-8">
2020-11-08 19:32:47 +00:00
2020-10-26 12:43:20 +00:00
<meta name="viewport" content="width=device-width, initial-scale=1.0">
2020-11-08 19:32:47 +00:00
2020-10-26 12:43:20 +00:00
<title>10. cli &mdash; BL602 IoT SDK release_bl_iot_sdk_1.6.11-1-g66bb28da 文档</title>
2020-11-08 19:32:47 +00:00
2020-10-26 12:43:20 +00:00
<link rel="stylesheet" href="../../_static/css/theme.css" type="text/css" />
<link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../../_static/style.css" type="text/css" />
<link rel="stylesheet" href="../../_static/css/custom.css" type="text/css" />
2020-11-08 19:32:47 +00:00
2020-10-26 12:43:20 +00:00
<!--[if lt IE 9]>
<script src="../../_static/js/html5shiv.min.js"></script>
<![endif]-->
2020-11-08 19:32:47 +00:00
2020-10-26 12:43:20 +00:00
<script type="text/javascript" id="documentation_options" data-url_root="../../" src="../../_static/documentation_options.js"></script>
<script src="../../_static/jquery.js"></script>
<script src="../../_static/underscore.js"></script>
<script src="../../_static/doctools.js"></script>
<script src="../../_static/language_data.js"></script>
2020-11-08 19:32:47 +00:00
2020-10-26 12:43:20 +00:00
<script type="text/javascript" src="../../_static/js/theme.js"></script>
2020-11-08 19:32:47 +00:00
2020-10-26 12:43:20 +00:00
<link rel="index" title="索引" href="../../genindex.html" />
<link rel="search" title="搜索" href="../../search.html" />
<link rel="next" title="11. FDT" href="../demo_system_fdt/fdt.html" />
2020-11-08 19:32:47 +00:00
<link rel="prev" title="9. Romfs" href="../demo_storage_romfs/romfs.html" />
2020-10-26 12:43:20 +00:00
</head>
<body class="wy-body-for-nav">
2020-11-08 19:32:47 +00:00
2020-10-26 12:43:20 +00:00
<div class="wy-grid-for-nav">
2020-11-08 19:32:47 +00:00
2020-10-26 12:43:20 +00:00
<nav data-toggle="wy-nav-shift" class="wy-nav-side">
<div class="wy-side-scroll">
<div class="wy-side-nav-search" >
2020-11-08 19:32:47 +00:00
2020-10-26 12:43:20 +00:00
<a href="../../index.html" class="icon icon-home" alt="Documentation Home"> BL602 IoT SDK
2020-11-08 19:32:47 +00:00
2020-10-26 12:43:20 +00:00
</a>
2020-11-08 19:32:47 +00:00
2020-10-26 12:43:20 +00:00
<div class="version">
release_bl_iot_sdk_1.6.11-1-g66bb28da
</div>
2020-11-08 19:32:47 +00:00
2020-10-26 12:43:20 +00:00
<div role="search">
<form id="rtd-search-form" class="wy-form" action="../../search.html" method="get">
<input type="text" name="q" placeholder="在文档中搜索" />
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
</div>
2020-11-08 19:32:47 +00:00
2020-10-26 12:43:20 +00:00
</div>
2020-11-08 19:32:47 +00:00
2020-10-26 12:43:20 +00:00
<div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
2020-11-08 19:32:47 +00:00
2020-10-26 12:43:20 +00:00
<p class="caption"><span class="caption-text">Developer_Environment</span></p>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../../Developer_Environment/Developer_Environment.html">1. Developer Environment</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../Developer_Environment/BLFlashEnv/BLFlashEnv.html">2. BLFlashEnv</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../Developer_Environment/freedom_studio/freedom_studio.html">3. Freedom Studio</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../Developer_Environment/eclipse/eclipse.html">4. Eclipse</a></li>
</ul>
<p class="caption"><span class="caption-text">Examples</span></p>
<ul class="current">
<li class="toctree-l1"><a class="reference internal" href="../helloworld/helloworld.html">1. Helloword</a></li>
<li class="toctree-l1"><a class="reference internal" href="../demo_aws/aws.html">2. aws</a></li>
<li class="toctree-l1"><a class="reference internal" href="../demo_peripherals_gpio/GPIO.html">3. GPIO</a></li>
<li class="toctree-l1"><a class="reference internal" href="../demo_peripherals_uart_echo/uart_echo.html">4. UART_echo</a></li>
<li class="toctree-l1"><a class="reference internal" href="../demo_peripherals_uart_ioctl/uart_ioctl.html">5. UART_ioctl</a></li>
<li class="toctree-l1"><a class="reference internal" href="../demo_protocols_http/http.html">6. Http client</a></li>
<li class="toctree-l1"><a class="reference internal" href="../demo_protocols_httpc/httpc.html">7. Httpc client</a></li>
<li class="toctree-l1"><a class="reference internal" href="../demo_storage_psm/psm.html">8. PSM</a></li>
<li class="toctree-l1"><a class="reference internal" href="../demo_storage_romfs/romfs.html">9. Romfs</a></li>
<li class="toctree-l1 current"><a class="current reference internal" href="#">10. cli</a><ul>
<li class="toctree-l2"><a class="reference internal" href="#id1">10.1. 总览</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id2">10.2. 使用步骤</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id3">10.3. 应用实例</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="../demo_system_fdt/fdt.html">11. FDT</a></li>
<li class="toctree-l1"><a class="reference internal" href="../demo_wifi/wifi.html">12. WiFi</a></li>
<li class="toctree-l1"><a class="reference internal" href="../demo_ble/ble.html">13. BLE</a></li>
<li class="toctree-l1"><a class="reference internal" href="../demo_mesh/mesh.html">14. Mesh</a></li>
<li class="toctree-l1"><a class="reference internal" href="../demo_blsync_ble/blsync_ble.html">15. BLSYNC-BLE</a></li>
<li class="toctree-l1"><a class="reference internal" href="../sdk_app_easyflash_boottimes/easyflash_boottimes.html">16. Easyflash4 boot times</a></li>
</ul>
<p class="caption"><span class="caption-text">Components</span></p>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../../Components/arch.html">1. arch</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../Components/Command_line/helper.html">2. helper</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../Components/Command_line/aos_cli.html">3. cli</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../Components/Hal_drv/gpio.html">4. GPIO</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../Components/Middleware/bloop/bloop.html">5. BLOOP</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../Components/Middleware/blsync/blsync.html">6. BLSYNC</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../Components/Middleware/dts/devicetree.html">7. device tree</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../Components/Middleware/log/blog.html">8. blog</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../Components/Middleware/security/security.html">9. Security</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../Components/Middleware/vfs/vfs.html">10. AOS VFS</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../Components/Middleware/yloop/yloop.html">11. yloop</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../Components/Network/httpc/httpc.html">12. HTTPC</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../Components/Network/https/https.html">13. HTTPS</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../Components/Network/tls/tls.html">14. TLS</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../Components/BLE/provision_WiFi/provision_WiFi.html">15. Provision_WiFi</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../Components/BLE/mesh/mesh.html">16. Mesh</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../Components/BLE/ble_stack/ble_stack.html">17. BLE</a></li>
</ul>
<p class="caption"><span class="caption-text">API</span></p>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../../API/sys/cronalarms.html">1. cronalarms</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../API/wifi/wifi_mgmr.html">2. Wi-Fi Manager</a></li>
</ul>
2020-11-08 19:32:47 +00:00
2020-10-26 12:43:20 +00:00
</div>
2020-11-08 19:32:47 +00:00
2020-10-26 12:43:20 +00:00
</div>
</nav>
<section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
2020-11-08 19:32:47 +00:00
2020-10-26 12:43:20 +00:00
<nav class="wy-nav-top" aria-label="top navigation">
2020-11-08 19:32:47 +00:00
2020-10-26 12:43:20 +00:00
<i data-toggle="wy-nav-top" class="fa fa-bars"></i>
<a href="../../index.html">BL602 IoT SDK</a>
2020-11-08 19:32:47 +00:00
2020-10-26 12:43:20 +00:00
</nav>
<div class="wy-nav-content">
2020-11-08 19:32:47 +00:00
2020-10-26 12:43:20 +00:00
<div class="rst-content">
2020-11-08 19:32:47 +00:00
2020-10-26 12:43:20 +00:00
<div role="navigation" aria-label="breadcrumbs navigation">
<ul class="wy-breadcrumbs">
2020-11-08 19:32:47 +00:00
2020-10-26 12:43:20 +00:00
<li><a href="../../index.html" class="icon icon-home"></a> &raquo;</li>
2020-11-08 19:32:47 +00:00
2020-10-26 12:43:20 +00:00
<li><span class="section-number">10. </span>cli</li>
2020-11-08 19:32:47 +00:00
2020-10-26 12:43:20 +00:00
<li class="wy-breadcrumbs-aside">
2020-11-08 19:32:47 +00:00
2020-10-26 12:43:20 +00:00
<a href="../../_sources/Examples/demo_system_cli/cli.rst.txt" rel="nofollow"> 查看页面源码</a>
2020-11-08 19:32:47 +00:00
2020-10-26 12:43:20 +00:00
</li>
2020-11-08 19:32:47 +00:00
2020-10-26 12:43:20 +00:00
</ul>
2020-11-08 19:32:47 +00:00
2020-10-26 12:43:20 +00:00
<hr/>
</div>
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
<div itemprop="articleBody">
2020-11-08 19:32:47 +00:00
2020-10-26 12:43:20 +00:00
<div class="section" id="cli">
<h1><span class="section-number">10. </span>cli<a class="headerlink" href="#cli" title="永久链接至标题"></a></h1>
<div class="section" id="id1">
<h2><span class="section-number">10.1. </span>总览<a class="headerlink" href="#id1" title="永久链接至标题"></a></h2>
<p>本实例主要介绍如何增加一个clicommand-line interface</p>
</div>
<div class="section" id="id2">
<h2><span class="section-number">10.2. </span>使用步骤<a class="headerlink" href="#id2" title="永久链接至标题"></a></h2>
<ul class="simple">
<li><p>编译 <code class="docutils literal notranslate"><span class="pre">customer_app/sdk_app_cli</span></code> 工程并下载对应的bin文件。</p></li>
<li><p>使用 <code class="docutils literal notranslate"><span class="pre">test</span></code> 命令即可在终端看到打印的 <code class="docutils literal notranslate"><span class="pre">hello</span> <span class="pre">world</span></code></p></li>
</ul>
</div>
<div class="section" id="id3">
<h2><span class="section-number">10.3. </span>应用实例<a class="headerlink" href="#id3" title="永久链接至标题"></a></h2>
<div class="highlight-c notranslate"><div class="highlight"><pre><span></span><span class="k">static</span> <span class="kt">void</span> <span class="nf">cmd_cli</span><span class="p">(</span><span class="kt">char</span> <span class="o">*</span><span class="n">buf</span><span class="p">,</span> <span class="kt">int</span> <span class="n">len</span><span class="p">,</span> <span class="kt">int</span> <span class="n">argc</span><span class="p">,</span> <span class="kt">char</span> <span class="o">**</span><span class="n">argv</span><span class="p">)</span>
<span class="p">{</span>
<span class="n">printf</span><span class="p">(</span><span class="s">&quot;hello world</span><span class="se">\r\n</span><span class="s">&quot;</span><span class="p">);</span>
<span class="p">}</span>
<span class="k">const</span> <span class="k">static</span> <span class="k">struct</span> <span class="n">cli_command</span> <span class="n">cmds_user</span><span class="p">[]</span> <span class="n">STATIC_CLI_CMD_ATTRIBUTE</span> <span class="o">=</span> <span class="p">{</span>
<span class="p">{</span><span class="s">&quot;test&quot;</span><span class="p">,</span> <span class="s">&quot;cli test&quot;</span><span class="p">,</span> <span class="n">cmd_cli</span><span class="p">},</span>
<span class="p">};</span>
<span class="kt">int</span> <span class="nf">test_cli_init</span><span class="p">(</span><span class="kt">void</span><span class="p">)</span>
<span class="p">{</span>
<span class="c1">// static command(s) do NOT need to call aos_cli_register_command(s) to register.</span>
<span class="c1">// However, calling aos_cli_register_command(s) here is OK but is of no effect as cmds_user are included in cmds list.</span>
<span class="c1">// XXX NOTE: Calling this *empty* function is necessary to make cmds_user in this file to be kept in the final link.</span>
<span class="c1">//return aos_cli_register_commands(cmds_user, sizeof(cmds_user)/sizeof(cmds_user[0]));</span>
<span class="k">return</span> <span class="mi">0</span><span class="p">;</span>
<span class="p">}</span>
</pre></div>
</div>
<p>用户在只需在程序中调用<code class="docutils literal notranslate"><span class="pre">test_cli_init()</span></code>接口之后就可以在shell中<code class="docutils literal notranslate"><span class="pre">test</span></code>,就可以打印<code class="docutils literal notranslate"><span class="pre">hello</span> <span class="pre">world.</span></code>如下所示:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="c1">#</span>
<span class="c1">#</span>
<span class="c1"># test</span>
<span class="n">hello</span> <span class="n">world</span><span class="o">.</span>
<span class="c1">#</span>
<span class="c1">#</span>
</pre></div>
</div>
</div>
</div>
</div>
2020-11-08 19:32:47 +00:00
2020-10-26 12:43:20 +00:00
</div>
<footer>
2020-11-08 19:32:47 +00:00
2020-10-26 12:43:20 +00:00
<div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
2020-11-08 19:32:47 +00:00
2020-10-26 12:43:20 +00:00
<a href="../demo_system_fdt/fdt.html" class="btn btn-neutral float-right" title="11. FDT" accesskey="n" rel="next">下一页 <span class="fa fa-arrow-circle-right"></span></a>
2020-11-08 19:32:47 +00:00
2020-10-26 12:43:20 +00:00
<a href="../demo_storage_romfs/romfs.html" class="btn btn-neutral float-left" title="9. Romfs" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left"></span> 上一页</a>
2020-11-08 19:32:47 +00:00
2020-10-26 12:43:20 +00:00
</div>
2020-11-08 19:32:47 +00:00
2020-10-26 12:43:20 +00:00
<hr/>
<div role="contentinfo">
<p>
2020-11-08 19:32:47 +00:00
2020-10-26 12:43:20 +00:00
&copy; 版权所有 2020, Bouffalo Lab
</p>
</div>
2020-11-08 19:32:47 +00:00
利用 <a href="http://sphinx-doc.org/">Sphinx</a> 构建,使用了
2020-10-26 12:43:20 +00:00
<a href="https://github.com/rtfd/sphinx_rtd_theme">主题</a>
2020-11-08 19:32:47 +00:00
<a href="https://readthedocs.org">Read the Docs</a>开发.
2020-10-26 12:43:20 +00:00
</footer>
</div>
</div>
</section>
</div>
2020-11-08 19:32:47 +00:00
2020-10-26 12:43:20 +00:00
<script type="text/javascript">
jQuery(function () {
SphinxRtdTheme.Navigation.enable(true);
});
</script>
2020-11-08 19:32:47 +00:00
2020-10-26 12:43:20 +00:00
</body>
</html>