Files
luban-lite-t3e-pro/doc/topics/sdk/advanced/app.html
2025-01-23 16:37:00 +08:00

305 lines
36 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<!DOCTYPE html><html xmlns="http://www.w3.org/1999/xhtml" xml:lang="zh-cn" lang="zh-cn" data-whc_version="26.0">
<head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/><meta name="viewport" content="width=device-width, initial-scale=1.0"/><meta http-equiv="X-UA-Compatible" content="IE=edge"/><meta name="description" content="GT911 电容屏测试程序是一个硬件与软件结合的复杂项目,主要用于测试和验证电容触摸屏的性能和功能。 本节以 GT911 电容屏测试程序为例,演示添加应用的步骤和编译流程。 添加源码 在 bsp 目录下执行下列命令,可查看 GT911 电容屏测试程序的目录结构: tree 输出示例如下: . ├── Kconfig # 编译配置文件 ... ├── SConscript # 固定模板 └── ..."/><meta name="DC.rights.owner" content="(C) 版权 2025"/><meta name="copyright" content="(C) 版权 2025"/><meta name="generator" content="DITA-OT"/><meta name="DC.type" content="topic"/><meta name="DC.relation" content="../../../topics/sdk/advanced/sdk-usage.html"/><meta name="DC.relation" content="../../../topics/sdk/advanced/driver.html"/><meta name="DC.relation" content="../../../topics/sdk/advanced/hellowold.html"/><meta name="DC.contributor" content="yan.wang"/><meta name="DC.contributor" content="yan.wang"/><meta name="DC.date.modified" content="2024-01-15"/><meta name="DC.format" content="HTML5"/><meta name="DC.identifier" content="id"/><meta name="DC.language" content="zh-CN"/><title>添加应用</title><!-- Build number 2023110923. --><meta name="wh-path2root" content="../../../"/><meta name="wh-toc-id" content="id-d5856e1379"/><meta name="wh-source-relpath" content="topics/sdk/advanced/app.dita"/><meta name="wh-out-relpath" content="topics/sdk/advanced/app.html"/>
<link rel="stylesheet" type="text/css" href="../../../webhelp/app/commons.css?buildId=2023110923"/>
<link rel="stylesheet" type="text/css" href="../../../webhelp/app/topic.css?buildId=2023110923"/>
<script src="../../../webhelp/app/options/properties.js?buildId=20250121171154"></script>
<script src="../../../webhelp/app/localization/strings.js?buildId=2023110923"></script>
<script src="../../../webhelp/app/search/index/keywords.js?buildId=20250121171154"></script>
<script defer="defer" src="../../../webhelp/app/commons.js?buildId=2023110923"></script>
<script defer="defer" src="../../../webhelp/app/topic.js?buildId=2023110923"></script>
<link rel="stylesheet" type="text/css" href="../../../webhelp/template/aic-styles-web.css?buildId=2023110923"/><link rel="stylesheet" type="text/css" href="../../../webhelp/template/notes.css?buildId=2023110923"/><link rel="stylesheet" type="text/css" href="../../../webhelp/template/aic-common.css?buildId=2023110923"/><link rel="stylesheet" type="text/css" href="../../../webhelp/template/aic-images.css?buildId=2023110923"/><link rel="stylesheet" type="text/css" href="../../../webhelp/template/footnote.css?buildId=2023110923"/><link rel="stylesheet" type="text/css" href="../../../webhelp/template/aic-web-watermark.css?buildId=2023110923"/><link rel="stylesheet" type="text/css" href="../../../webhelp/template/topic-body-list.css?buildId=2023110923"/></head>
<body id="id" class="wh_topic_page frmBody">
<a href="#wh_topic_body" class="sr-only sr-only-focusable">
跳转到主要内容
</a>
<header class="navbar navbar-default wh_header">
<div class="container-fluid">
<div class="wh_header_flex_container navbar-nav navbar-expand-md navbar-dark">
<div class="wh_logo_and_publication_title_container">
<div class="wh_logo_and_publication_title">
<a href="http://www.artinchip.com" class=" wh_logo d-none d-sm-block "><img src="../../../company-logo-white.png" alt="RTOS SDK 使用指南SDK 指南文件"/></a>
<div class=" wh_publication_title "><a href="../../../index.html"><span class="booktitle"><span class="ph mainbooktitle">RTOS SDK 使用指南</span><span class="ph booktitlealt">SDK 指南文件</span></span></a></div>
</div>
</div>
<div class="wh_top_menu_and_indexterms_link collapse navbar-collapse" id="wh_top_menu_and_indexterms_link">
</div>
</div>
</div>
</header>
<div class=" wh_search_input navbar-form wh_topic_page_search search " role="form">
<form id="searchForm" method="get" role="search" action="../../../search.html"><div><input type="search" placeholder="搜索 " class="wh_search_textfield" id="textToSearch" name="searchQuery" aria-label="搜索查询" required="required"/><button type="submit" class="wh_search_button" aria-label="搜索"><span class="search_input_text">搜索</span></button></div></form>
</div>
<div class="container-fluid" id="wh_topic_container">
<div class="row">
<nav class="wh_tools d-print-none navbar-expand-md" aria-label="Tools">
<div data-tooltip-position="bottom" class=" wh_breadcrumb "><ol class="d-print-none"><li><span class="home"><a href="../../../index.html"><span>主页</span></a></span></li><li><div class="topicref" data-id="id"><div class="title"><a href="../../../topics/sdk/advanced/sdk-usage.html">使用指南</a><div class="wh-tooltip"><p class="shortdesc">系统镜像、编译选项、开发板、应用等相关的详细使用说明。</p></div></div></div></li><li class="active"><div class="topicref" data-id="id"><div class="title"><a href="../../../topics/sdk/advanced/app.html">添加应用</a></div></div></li></ol></div>
<div class="wh_right_tools">
<button class="wh_hide_highlight" aria-label="切换搜索突出显示" title="切换搜索突出显示"></button>
<button class="webhelp_expand_collapse_sections" data-next-state="collapsed" aria-label="折叠截面" title="折叠截面"></button>
<div class=" wh_navigation_links "><span id="topic_navigation_links" class="navheader">
<span class="navprev"><a class="- topic/link link" href="../../../topics/sdk/advanced/driver.html" title="添加驱动" aria-label="上一主题: 添加驱动" rel="prev"></a></span>
<span class="navnext"><a class="- topic/link link" href="../../../topics/sdk/advanced/hellowold.html" title="hellowold" aria-label="下一主题: hellowold" rel="next"></a></span> </span></div>
<div class=" wh_print_link print d-none d-md-inline-block "><button onClick="window.print()" title="打印此页" aria-label="打印此页"></button></div>
<button type="button" id="wh_toc_button" class="custom-toggler navbar-toggler collapsed wh_toggle_button navbar-light" aria-expanded="false" aria-label="Toggle publishing table of content" aria-controls="wh_publication_toc">
<span class="navbar-toggler-icon"></span>
</button>
</div>
</nav>
</div>
<div class="wh_content_area">
<div class="row">
<nav id="wh_publication_toc" class="col-lg-3 col-md-3 col-sm-12 d-md-block d-none d-print-none" aria-label="Table of Contents Container">
<div id="wh_publication_toc_content">
<div class=" wh_publication_toc " data-tooltip-position="right"><span class="expand-button-action-labels"><span id="button-expand-action" role="button" aria-label="Expand"></span><span id="button-collapse-action" role="button" aria-label="Collapse"></span><span id="button-pending-action" role="button" aria-label="Pending"></span></span><ul role="tree" aria-label="Table of Contents"><li role="treeitem"><div data-tocid="revinfo_linux-d5856e989" class="topicref" data-id="revinfo_linux" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/revinfo/revinfo_rtos.html" id="revinfo_linux-d5856e989-link">修订记录</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="id-d5856e1003" class="topicref" data-id="id" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action id-d5856e1003-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/env/sdk-compile.html" id="id-d5856e1003-link">SDK 编译</a><div class="wh-tooltip"><p class="shortdesc">介绍不同编译环境下 SDK 的详细编译流程。</p></div></div></div></li><li role="treeitem" aria-expanded="true"><div data-tocid="id-d5856e1152" class="topicref" data-id="id" data-state="expanded"><span role="button" tabindex="0" aria-labelledby="button-collapse-action id-d5856e1152-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/advanced/sdk-usage.html" id="id-d5856e1152-link">使用指南</a><div class="wh-tooltip"><p class="shortdesc">系统镜像、编译选项、开发板、应用等相关的详细使用说明。</p></div></div></div><ul role="group" class="navbar-nav nav-list"><li role="treeitem" aria-expanded="false"><div data-tocid="id-d5856e1169" class="topicref" data-id="id" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action id-d5856e1169-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/advanced/commands.html" id="id-d5856e1169-link">命令详解 </a></div></div></li><li role="treeitem"><div data-tocid="id-d5856e1207" class="topicref" data-id="id" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/advanced/architecture.html" id="id-d5856e1207-link">设计框架</a></div></div></li><li role="treeitem"><div data-tocid="id-d5856e1219" class="topicref" data-id="id" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/advanced/sconstruct.html" id="id-d5856e1219-link">SConstruct </a></div></div></li><li role="treeitem"><div data-tocid="id-d5856e1231" class="topicref" data-id="id" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/advanced/compile.html" id="id-d5856e1231-link">编译选项介绍</a></div></div></li><li role="treeitem"><div data-tocid="id-d5856e1243" class="topicref" data-id="id" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/advanced/partition.html" id="id-d5856e1243-link">配置分区</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="id-d5856e1255" class="topicref" data-id="id" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action id-d5856e1255-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/advanced/image_burn_and_config.html" id="id-d5856e1255-link">配置烧录镜像</a></div></div></li><li role="treeitem"><div data-tocid="id-d5856e1339" class="topicref" data-id="id" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/advanced/gdb.html" id="id-d5856e1339-link">GDB 调试</a></div></div></li><li role="treeitem"><div data-tocid="id-d5856e1353" class="topicref" data-id="id" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/advanced/pinmux.html" id="id-d5856e1353-link">引脚配置</a></div></div></li><li role="treeitem"><div data-tocid="id-d5856e1367" class="topicref" data-id="id" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/advanced/driver.html" id="id-d5856e1367-link">添加驱动</a></div></div></li><li role="treeitem" class="active"><div data-tocid="id-d5856e1379" class="topicref" data-id="id" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/advanced/app.html" id="id-d5856e1379-link">添加应用</a></div></div></li><li role="treeitem"><div data-tocid="id-d5856e1392" class="topicref" data-id="id" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/advanced/hellowold.html" id="id-d5856e1392-link">hellowold</a></div></div></li><li role="treeitem"><div data-tocid="id-d5856e1404" class="topicref" data-id="id" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/advanced/burnin_test.html" id="id-d5856e1404-link">烤机测试</a></div></div></li></ul></li><li role="treeitem" aria-expanded="false"><div data-tocid="concept_rcx_czh_pzb-d5856e1416" class="topicref" data-id="concept_rcx_czh_pzb" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action concept_rcx_czh_pzb-d5856e1416-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/chapter-app.html" id="concept_rcx_czh_pzb-d5856e1416-link">应用场景</a><div class="wh-tooltip"><p class="shortdesc">描述了 SDK 在不同应用场景中的配置和使用包括系统更新、OTA、安全方案等。</p></div></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="id-d5856e2119" class="topicref" data-id="id" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action id-d5856e2119-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/peripheral/peripheral-intro.html" id="id-d5856e2119-link">外设移植</a><div class="wh-tooltip"><p class="shortdesc"><span class="ph">CTP、U 盘、SD 卡、有线和无线网络</span>等外设的介绍和使用说明。</p></div></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="id-d5856e2244" class="topicref" data-id="id" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action id-d5856e2244-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/bringup/chapter-bringup.html" id="id-d5856e2244-link">BringUp</a><div class="wh-tooltip"><p class="shortdesc">在硬件上电后快速初始化系统,为操作系统的启动准备好必要的硬件环境。</p></div></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="id-d5856e2345" class="topicref" data-id="id" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action id-d5856e2345-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/chapter-advanced-app.html" id="id-d5856e2345-link">高级应用</a><div class="wh-tooltip"><p class="shortdesc">系统、存储、多媒体、接口、安全等模块的详细配置和设计说明。</p></div></div></div></li></ul></div>
</div>
</nav>
<div class="col-lg-7 col-md-9 col-sm-12" id="wh_topic_body">
<button id="wh_close_publication_toc_button" class="close-toc-button d-none" aria-label="Toggle publishing table of content" aria-controls="wh_publication_toc" aria-expanded="true">
<span class="close-toc-icon-container">
<span class="close-toc-icon"></span>
</span>
</button>
<button id="wh_close_topic_toc_button" class="close-toc-button d-none" aria-label="Toggle topic table of content" aria-controls="wh_topic_toc" aria-expanded="true">
<span class="close-toc-icon-container">
<span class="close-toc-icon"></span>
</span>
</button>
<div class=" wh_topic_content body "><main role="main"><article class="- topic/topic topic" role="article" aria-labelledby="ariaid-title1"><span class="edit-link" style="font-size:12px; opacity:0.6; text-align:right; vertical-align:middle"><a target="_blank" href="http://172.16.35.88/tasks/jdssno1uvvbf2mltu9kb9v3if05d5gopuakboe8hlud18rma/edit/F:/aicdita/aicdita-cn/topics/sdk/advanced/app.dita">Edit online</a></span><h1 class="- topic/title title topictitle1" id="ariaid-title1">添加应用</h1><div class="date inPage">15 Jan 2024</div><div style="color: gray;">
Read time: 3 minute(s)
</div><div class="- topic/body body"><p class="- topic/p p" data-ofbid="d89101e22__20250121171530">GT911 电容屏测试程序是一个硬件与软件结合的复杂项目,主要用于测试和验证电容触摸屏的性能和功能。</p><p class="- topic/p p" data-ofbid="d89101e24__20250121171530">本节以 GT911 电容屏测试程序为例,演示添加应用的步骤和编译流程。</p><section class="- topic/section section" id="id__id2" data-ofbid="id__id2"><h2 class="- topic/title title sectiontitle">添加源码</h2>
<div class="- topic/p p" data-ofbid="d89101e31__20250121171530"><span class="+ topic/ph sw-d/filepath ph filepath">bsp</span> 目录下执行下列命令,可查看 GT911
电容屏测试程序的目录结构:<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="id__codeblock_pj4_hkq_gdc" data-ofbid="id__codeblock_pj4_hkq_gdc">tree</pre></div>
<div class="- topic/p p" data-ofbid="d89101e39__20250121171530">输出示例如下:<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="id__codeblock_ysv_5sz_sdc" data-ofbid="id__codeblock_ysv_5sz_sdc">.
├── Kconfig # 编译配置文件
...
├── SConscript # 固定模板
└── examples
├── SConscript # 固定模板
...
├── test-ctp
│ ├── test_gt911.c # 源代码
│ └── SConscript # 源码结构文件
...</pre><ul class="- topic/ul ul" id="id__ul_fcr_mdc_5cc" data-ofbid="id__ul_fcr_mdc_5cc"><li class="- topic/li li" data-ofbid="d89101e44__20250121171530"><span class="+ topic/ph sw-d/filepath ph filepath">Kconfig</span>
文件:负责编译配置,定义了需要被编译进最终操作系统镜像中的文件,允许根据需求开启或关闭特定功能,从而提供灵活性并减少不必要的资源占用。</li><li class="- topic/li li" data-ofbid="d89101e48__20250121171530"><span class="+ topic/ph sw-d/filepath ph filepath">SConscript</span>
文件:负责指导编译系统编译源码的脚本文件,定义了构建过程的规则,例如依赖关系、编译顺序等。</li><li class="- topic/li li" data-ofbid="d89101e52__20250121171530"><span class="+ topic/ph sw-d/filepath ph filepath">examples</span> 文件:包含实际测试程序源码和主要功能实现代码的示例文件。</li></ul></div>
<div class="- topic/p p" data-ofbid="d89101e57__20250121171530">详细配置流程如下所示:<ol class="- topic/ol ol" id="id__ol_ozl_3kq_gdc" data-ofbid="id__ol_ozl_3kq_gdc"><li class="- topic/li li" data-ofbid="d89101e60__20250121171530">
<div class="- topic/div div section" id="id__kconfig"><span class="+ topic/ph sw-d/filepath ph filepath">Kconfig</span>
配置文件中,添加一个新的配置项,例如
<span class="+ topic/keyword pr-d/parmname keyword parmname">AIC_TP_DRV_TEST</span>,用于启用或禁用触摸面板驱动程序测试功能:<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="id__codeblock_s5n_kkq_gdc" data-ofbid="id__codeblock_s5n_kkq_gdc">config AIC_TP_DRV_TEST
bool <span class="hl-string">"Enable touch panel driver test command"</span>
<strong class="hl-keyword">default</strong> n
depends on AIC_TOUCH_PANEL_GT911</pre><ul class="- topic/ul ul" id="id__ul_ktc_r2c_5cc" data-ofbid="id__ul_ktc_r2c_5cc"><li class="- topic/li li" data-ofbid="d89101e73__20250121171530"><span class="+ topic/keyword pr-d/parmname keyword parmname">AIC_TP_DRV_TEST</span>:新的配置项名称</li><li class="- topic/li li" data-ofbid="d89101e77__20250121171530"><span class="+ topic/keyword pr-d/parmname keyword parmname">bool "Enable touch panel driver test
command"</span>:用于启用或禁用触摸面板驱动程序测试功能。</li><li class="- topic/li li" data-ofbid="d89101e81__20250121171530"><span class="+ topic/keyword pr-d/parmname keyword parmname">default
n</span><span class="+ topic/keyword pr-d/parmname keyword parmname">AIC_TP_DRV_TEST</span>
设为默认关闭。</li><li class="- topic/li li" data-ofbid="d89101e88__20250121171530"><span class="+ topic/keyword pr-d/parmname keyword parmname">depends on
AIC_TOUCH_PANEL_GT911</span>:配置项依赖于<code class="+ topic/ph pr-d/codeph ph codeph">AIC_TOUCH_PANEL_GT911</code></li></ul></div>
</li><li class="- topic/li li" data-ofbid="d89101e96__20250121171530"><span class="+ topic/ph sw-d/filepath ph filepath">SConscript</span> 文件中导入必要的模块 AIC_ROOT 和
PRJ_KERNEL。<p class="- topic/p p" data-ofbid="d89101e101__20250121171530"><span class="+ topic/ph sw-d/filepath ph filepath">SConscript</span>
文件决定参与编译的文件、目录等相关信息,具体语法请参考 <a class="- topic/xref xref" href="sconstruct.html">SConstruct</a></p><div class="- topic/p p" data-ofbid="d89101e109__20250121171530">本例程
<span class="+ topic/ph sw-d/filepath ph filepath">SConscript</span>
源码示例如下:<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="id__codeblock_tgj_mkq_gdc" data-ofbid="id__codeblock_tgj_mkq_gdc">Import(<span class="hl-string">'AIC_ROOT'</span>)
Import(<span class="hl-string">'PRJ_KERNEL'</span>)
from building import *
cwd = GetCurrentDir()
CPPPATH = []
src = []
<strong class="hl-keyword">if</strong> GetDepend(<span class="hl-string">'AIC_TP_DRV_TEST'</span>):
src = Glob(<span class="hl-string">'*.c'</span>)
group = DefineGroup(<span class="hl-string">'test-touch'</span>, src, depend = [<span class="hl-string">''</span>], CPPPATH = CPPPATH)
Return(<span class="hl-string">'group'</span>)</pre><ul class="- topic/ul ul" id="id__ul_grf_3fc_5cc" data-ofbid="id__ul_grf_3fc_5cc"><li class="- topic/li li" data-ofbid="d89101e117__20250121171530"><span class="+ topic/keyword pr-d/apiname keyword apiname">Import('AIC_ROOT')</span>
<span class="+ topic/keyword pr-d/apiname keyword apiname">Import('PRJ_KERNEL')</span>:导入必要模块。</li><li class="- topic/li li" data-ofbid="d89101e124__20250121171530">根据需要设置编译选项,例如 CPPPATH 等。</li><li class="- topic/li li" data-ofbid="d89101e126__20250121171530">
<p class="- topic/p p" data-ofbid="d89101e128__20250121171530">使用 <span class="+ topic/keyword pr-d/apiname keyword apiname">Glob('*.c')</span> 获取所有源代码文件,并将其添加到一个名为
<code class="+ topic/ph pr-d/codeph ph codeph">test-touch</code> 组中。</p>
</li><li class="- topic/li li" data-ofbid="d89101e137__20250121171530">返回 <code class="+ topic/ph pr-d/codeph ph codeph">test-touch</code> 组,以便将其加入到构建过程中。</li></ul></div></li><li class="- topic/li li" data-ofbid="d89101e143__20250121171530">使用宏定义将应用程序添加到 <span class="+ topic/ph sw-d/filepath ph filepath">$(SDK)/bsp/test/test-touch/gt911_sample.c</span>
的初始化函数列表中,确保系统启动时能被调用:<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="id__codeblock_evf_qkq_gdc" data-ofbid="id__codeblock_evf_qkq_gdc">...
<strong class="hl-keyword">static</strong> <strong class="hl-keyword">void</strong> gt911_sample(<strong class="hl-keyword">void</strong> *parameter)
{
...
}
MSH_CMD_EXPORT(gt911_sample, gt911 sample);</pre><p class="- topic/p p" data-ofbid="d89101e150__20250121171530">使用 RT-Thread
宏定义导入应用程序时,推荐使用 <code class="+ topic/ph pr-d/codeph ph codeph">INIT_APP_EXPORT(fn)</code>
<code class="+ topic/ph pr-d/codeph ph codeph">MSH_CMD_EXPORT(fn)</code> 宏定义。关于宏定义的详细说明,可查看<a class="- topic/xref xref" href="app.html#id__section_yvz_c5z_sdc">宏接口优先级及描述</a></p><p class="- topic/p p" data-ofbid="d89101e162__20250121171530">值得关注的是文件最后的导出命令
<span class="+ topic/keyword sw-d/cmdname keyword cmdname">MSH_CMD_EXPORT</span>,在系统启动之后,通过命令
<span class="+ topic/keyword sw-d/cmdname keyword cmdname">gt911_sample</span>
运行。</p></li></ol></div>
</section><section class="- topic/section section" id="id__id5" data-ofbid="id__id5"><h2 class="- topic/title title sectiontitle">编译</h2>
<ol class="- topic/ol ol" id="id__ol_b2f_tkq_gdc" data-ofbid="id__ol_b2f_tkq_gdc"><li class="- topic/li li" data-ofbid="d89101e180__20250121171530">
<div class="- topic/p p" data-ofbid="d89101e182__20250121171530">执行 <span class="+ topic/keyword sw-d/cmdname keyword cmdname">scons --menuconfig</span><span class="+ topic/keyword sw-d/cmdname keyword cmdname">me</span>OneStep
命令),进入配置界面,按照以下步骤操作:<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="id__codeblock_eld_5kq_gdc" data-ofbid="id__codeblock_eld_5kq_gdc">Drivers options ---&gt;
Drivers examples ---&gt;
[*] Enable touch panel driver test command</pre></div>
</li><li class="- topic/li li" data-ofbid="d89101e193__20250121171530">
<p class="- topic/p p" data-ofbid="d89101e195__20250121171530">保存配置并退出。</p>
</li><li class="- topic/li li" data-ofbid="d89101e198__20250121171530">
<p class="- topic/p p" data-ofbid="d89101e200__20250121171530">运行 <span class="+ topic/keyword sw-d/cmdname keyword cmdname">scons</span> 命令或 <span class="+ topic/keyword sw-d/cmdname keyword cmdname">m</span>OneStep 命令)开始编译。</p>
<p class="- topic/p p" data-ofbid="d89101e209__20250121171530">编译结束后会生成镜像文件。将生成的镜像文件烧录到目标设备上。</p>
</li></ol>
</section><section class="- topic/section section" id="id__id8" data-ofbid="id__id8"><h2 class="- topic/title title sectiontitle">验证</h2>
<p class="- topic/p p" data-ofbid="d89101e218__20250121171530">烧录镜像并运行系统后,使用 <span class="+ topic/ph ui-d/uicontrol ph uicontrol">Tab</span> 键查看应用命令是否添加成功。</p>
<ol class="- topic/ol ol" id="id__ol_lc2_jmm_tdc" data-ofbid="id__ol_lc2_jmm_tdc"><li class="- topic/li li" data-ofbid="d89101e225__20250121171530">
<div class="- topic/p p" data-ofbid="d89101e227__20250121171530">烧录镜像并运行系统,系统输出示例如下:<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="id__codeblock_g1j_zkq_gdc" data-ofbid="id__codeblock_g1j_zkq_gdc">Startup reason: Power-On-Reset
Startup time: <span class="hl-number">0.601</span> sec (from Power-On-Reset)
os : system memory alloc <span class="hl-number">320</span> bytes
flsh: UFFS consume spare data size <span class="hl-number">36</span>
os : system memory alloc <span class="hl-number">84480</span> bytes
os : system memory alloc <span class="hl-number">53200</span> bytes
os : system memory alloc <span class="hl-number">7168</span> bytes
tree: DIR <span class="hl-number">1</span>, FILE <span class="hl-number">1</span>, DATA <span class="hl-number">22</span>
info.bits_per_pixel: <span class="hl-number">32</span>
info.width: <span class="hl-number">1024</span>, info.height: <span class="hl-number">600</span>
lv_draw_aic_ctx_init:<span class="hl-number">1024</span>, <span class="hl-number">600</span>
id = GT911
range_x = <span class="hl-number">1024</span>
range_y = <span class="hl-number">600</span>
point_num = <span class="hl-number">1</span></pre></div>
</li><li class="- topic/li li" data-ofbid="d89101e232__20250121171530">
<div class="- topic/p p" data-ofbid="d89101e234__20250121171530">使用 <span class="+ topic/ph ui-d/uicontrol ph uicontrol">Tab</span>
键查看应用命令是否添加成功:<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="id__codeblock_imt_2mm_tdc" data-ofbid="id__codeblock_imt_2mm_tdc">&lt;tab&gt; # 单击 Tab 键</pre></div>
</li><li class="- topic/li li" data-ofbid="d89101e242__20250121171530">
<p class="- topic/p p" data-ofbid="d89101e244__20250121171530">系统罗列出可用命令列表。</p>
<div class="- topic/p p" data-ofbid="d89101e247__20250121171530">如果命令列表中出现
<code class="+ topic/ph pr-d/codeph ph codeph">test_gt911</code>,说明添加成功,输出示例如下<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="id__codeblock_t2w_hmm_tdc" data-ofbid="id__codeblock_t2w_hmm_tdc">RT-Thread shell commands:
...
test_gt911 - test gt911 sample
...</pre></div>
</li></ol>
</section><section class="- topic/section section" id="id__section_yvz_c5z_sdc" data-ofbid="id__section_yvz_c5z_sdc"><h2 class="- topic/title title sectiontitle">宏接口优先级及描述</h2>
<div class="- topic/p p" data-ofbid="d89101e261__20250121171530">RT-Thread 有一套启动优先级设置的宏,可根据不同的软件模块分类设置。具体接口及描述如下:<div class="table-container"><table class="- topic/table table frame-all" id="id__table_rbq_jdc_5cc" data-ofbid="id__table_rbq_jdc_5cc" data-cols="2"><caption class="- topic/title title tablecap" data-caption-side="top" data-is-repeated="true"><span class="table--title-label"><span class="table--title-label-number"> 1</span><span class="table--title-label-punctuation">. </span></span><span class="table--title">宏接口和描述</span></caption><colgroup><col style="width:40.322580645161295%"/><col style="width:59.67741935483871%"/></colgroup><thead class="- topic/thead thead"><tr class="- topic/row"><th class="- topic/entry entry colsep-1 rowsep-1" id="id__table_rbq_jdc_5cc__entry__1">宏接口</th><th class="- topic/entry entry colsep-0 rowsep-1" id="id__table_rbq_jdc_5cc__entry__2">描述</th></tr></thead><tbody class="- topic/tbody tbody"><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="id__table_rbq_jdc_5cc__entry__1">INIT_BOARD_EXPORT(fn)</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="id__table_rbq_jdc_5cc__entry__2">非常早期的初始化,此时调度器还未启动; 使用该宏后fn 将属于 “board init
functions”</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="id__table_rbq_jdc_5cc__entry__1">INIT_PREV_EXPORT(fn)</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="id__table_rbq_jdc_5cc__entry__2">主要是用于纯软件的初始化、没有太多依赖的函数使用该宏后fn 将属于 “pre-initialization
functions”</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="id__table_rbq_jdc_5cc__entry__1">INIT_DEVICE_EXPORT(fn)</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="id__table_rbq_jdc_5cc__entry__2">外设驱动初始化相关比如网卡设备使用该宏后fn 将属于 “device init functions”</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="id__table_rbq_jdc_5cc__entry__1">INIT_COMPONENT_EXPORT(fn)</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="id__table_rbq_jdc_5cc__entry__2">组件初始化,比如文件系统或者 LWIP使用该宏后fn 将属于 “components init
functions”</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="id__table_rbq_jdc_5cc__entry__1">INIT_ENV_EXPORT(fn)</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="id__table_rbq_jdc_5cc__entry__2">系统环境初始化比如挂载文件系统使用该宏后fn 将属于 “enviroment init
functions”</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="id__table_rbq_jdc_5cc__entry__1">INIT_APP_EXPORT(fn)</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="id__table_rbq_jdc_5cc__entry__2">应用初始化,比如 GUI 应用使用该宏后fn 将属于 “application init
functions”</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-0" headers="id__table_rbq_jdc_5cc__entry__1">MSH_CMD_EXPORT(fn)</td><td class="- topic/entry entry colsep-0 rowsep-0" headers="id__table_rbq_jdc_5cc__entry__2">将应用程序导出为 Msh 命令;通过手动方式运行;</td></tr></tbody></table></div></div>
</section></div></article></main></div>
</div>
<nav role="navigation" id="wh_topic_toc" aria-label="On this page" class="col-lg-2 d-none d-lg-block navbar d-print-none">
<div id="wh_topic_toc_content">
<div class=" wh_topic_toc "><div class="wh_topic_label">在本页上</div><ul><li class="section-item"><div class="section-title"><a href="#id__id2" data-tocid="id__id2">添加源码</a></div></li><li class="section-item"><div class="section-title"><a href="#id__id5" data-tocid="id__id5">编译</a></div></li><li class="section-item"><div class="section-title"><a href="#id__id8" data-tocid="id__id8">验证</a></div></li><li class="section-item"><div class="section-title"><a href="#id__section_yvz_c5z_sdc" data-tocid="id__section_yvz_c5z_sdc">宏接口优先级及描述</a></div></li></ul></div>
</div>
</nav>
</div>
</div>
</div>
<footer class="navbar navbar-default wh_footer">
<div class=" footer-container mx-auto ">
<title>footer def</title>
<style><!--
.p1 {
font-family: FangZhengShuSong, Times, serif;
}
.p2 {
font-family: Arial, Helvetica, sans-serif;
}
.p3 {
font-family: "Lucida Console", "Courier New", monospace;
}
--></style>
<div class="webhelp.fragment.footer">
<p class="p1">Copyright © 2019-2024 广东匠芯创科技有限公司. All rights reserved.</p>
</div><div>
<div class="generation_time">
Update Time: 2025-01-21
</div>
</div>
</div>
</footer>
<div id="go2top" class="d-print-none">
<span class="oxy-icon oxy-icon-up"></span>
</div>
<div id="modal_img_large" class="modal">
<span class="close oxy-icon oxy-icon-remove"></span>
<div id="modal_img_container"></div>
<div id="caption"></div>
</div>
<script src="${pd}/publishing/publishing-styles-AIC-template/js/custom.js" defer="defer"></script>
</body>
</html>