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

261 lines
23 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="Luban-Lite 可以实现按键矩阵功能。矩阵键盘是一种通过行列扫描技术来检测多个按键状态的输入设备,广泛应用于需要大量按键输入的场景,如计算器、遥控器、游戏控制器等。它能有效节省 I/O 资源,同时提供灵活的按键布局方式。 如需实现按键矩阵功能,可执行以下操作流程。 配置 GPAI 在 Luban-Lite 根目录下执行 scons --menuconfig ,进入 menuconfig ..."/><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/peripheral/peripheral-intro.html"/><meta name="DC.relation" content="../../../topics/sdk/peripheral/peripheral-intro.html"/><meta name="DC.relation" content="../../../topics/sdk/peripheral/touch.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-d5856e2136"/><meta name="wh-source-relpath" content="topics/sdk/peripheral/keyadc.dita"/><meta name="wh-out-relpath" content="topics/sdk/peripheral/keyadc.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/peripheral/peripheral-intro.html">外设移植</a><div class="wh-tooltip"><p class="shortdesc"><span class="ph">CTP、U 盘、SD 卡、有线和无线网络</span>等外设的介绍和使用说明。</p></div></div></div></li><li class="active"><div class="topicref" data-id="id"><div class="title"><a href="../../../topics/sdk/peripheral/keyadc.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/peripheral/peripheral-intro.html" title="外设移植" aria-label="上一主题: 外设移植" rel="prev"></a></span>
<span class="navnext"><a class="- topic/link link" href="../../../topics/sdk/peripheral/touch.html" title="CTP 移植指南" aria-label="下一主题: CTP 移植指南" 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="false"><div data-tocid="id-d5856e1152" class="topicref" data-id="id" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-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></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="true"><div data-tocid="id-d5856e2119" class="topicref" data-id="id" data-state="expanded"><span role="button" tabindex="0" aria-labelledby="button-collapse-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><ul role="group" class="navbar-nav nav-list"><li role="treeitem" class="active"><div data-tocid="id-d5856e2136" class="topicref" data-id="id" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/peripheral/keyadc.html" id="id-d5856e2136-link">按键矩阵</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="id-d5856e2148" class="topicref" data-id="id" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action id-d5856e2148-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/peripheral/touch.html" id="id-d5856e2148-link">CTP 移植指南</a></div></div></li><li role="treeitem"><div data-tocid="id-d5856e2232" class="topicref" data-id="id" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/peripheral/wifi.html" id="id-d5856e2232-link">无线网络</a></div></div></li></ul></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/peripheral/keyadc.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: 2 minute(s)
</div><div class="- topic/body body"><p class="- topic/p p" data-ofbid="d53243e19__20250121171519"><span class="- topic/ph ph">Luban-Lite</span>
可以实现按键矩阵功能。矩阵键盘是一种通过行列扫描技术来检测多个按键状态的输入设备,广泛应用于需要大量按键输入的场景,如计算器、遥控器、游戏控制器等。它能有效节省
I/O 资源,同时提供灵活的按键布局方式。</p><p class="- topic/p p" data-ofbid="d53243e23__20250121171519">如需实现按键矩阵功能,可执行以下操作流程。</p><section class="- topic/section section" id="id__section_cdn_j55_1dc" data-ofbid="id__section_cdn_j55_1dc"><h2 class="- topic/title title sectiontitle">配置 GPAI</h2>
<p class="- topic/p p" data-ofbid="d53243e30__20250121171519"><span class="- topic/ph ph">Luban-Lite</span> 根目录下执行 <span class="+ topic/keyword sw-d/cmdname keyword cmdname">scons --menuconfig</span>,进入
menuconfig
的功能配置界面。根据原理图配置
keyadc
所用通道,例如选择
GPAI6</p>
<div class="- topic/div div highlight-kconfig notranslate">
<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="id__pre_lw3_2xv_wcc" data-ofbid="id__pre_lw3_2xv_wcc">Board options ---&gt;
[*] Using GPAI
GPAI options ---&gt;
[ ] Using GPAI0
[ ] Using GPAI1
[ ] Using GPAI2
[ ] Using GPAI3
[ ] Using GPAI4
[ ] Using GPAI5
[*] Using GPAI6
[ ] Using GPAI7
GPAI6 Parameter ---&gt;
obtaning data mode (CPU interrupt mode) ---&gt;
period mode (period mode)
(<span class="hl-number">1</span>) sample period time (us)
(<span class="hl-number">2</span>x2f) ADC Acquisition Time
</pre>
</div>
</section><section class="- topic/section section" id="id__section_bdn_j55_1dc" data-ofbid="id__section_bdn_j55_1dc"><h2 class="- topic/title title sectiontitle">配置 test_keyadc</h2>
<p class="- topic/p p" data-ofbid="d53243e50__20250121171519">
<span class="- topic/ph ph">Luban-Lite</span> 根目录下执行 <span class="+ topic/keyword sw-d/cmdname keyword cmdname">scons --menuconfig</span>,进入
menuconfig
的功能配置界面,按如下选择:</p>
<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="id__pre_nw3_2xv_wcc" data-ofbid="id__pre_nw3_2xv_wcc">Drivers options ---&gt;
Drivers examples ---&gt;
[*] Enable KEYADC driver test command
</pre>
</section><section class="- topic/section section" id="id__section_ycn_j55_1dc" data-ofbid="id__section_ycn_j55_1dc"><h2 class="- topic/title title sectiontitle">测试验证</h2>
<div class="- topic/p p" data-ofbid="d53243e67__20250121171519">编译并运行 <span class="+ topic/keyword sw-d/cmdname keyword cmdname">test_keyadc</span> 命令。例如:<ol class="- topic/ol ol" id="id__ul_bbp_ky4_tdc" data-ofbid="id__ul_bbp_ky4_tdc"><li class="- topic/li li" data-ofbid="d53243e73__20250121171519">
<div class="- topic/p p" data-ofbid="d53243e75__20250121171519">设置采样通道为
2<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="id__codeblock_i3m_lgf_1dc" data-ofbid="id__codeblock_i3m_lgf_1dc">test_keyadc -c <span class="hl-number">2</span></pre></div>
</li><li class="- topic/li li" data-ofbid="d53243e80__20250121171519">设置按键 adc 值可允许波动范围为
50<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="id__codeblock_vkd_my4_tdc" data-ofbid="id__codeblock_vkd_my4_tdc">test_keyadc -s <span class="hl-number">50</span></pre></li><li class="- topic/li li" data-ofbid="d53243e84__20250121171519">开始按键矩阵判断。<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="id__codeblock_tqv_my4_tdc" data-ofbid="id__codeblock_tqv_my4_tdc">test_keyadc -g</pre></li></ol></div>
<div class="- topic/div div section" id="id__id3">
<p class="- topic/p p" data-ofbid="d53243e91__20250121171519">在打开 test_keyadc 的编译后,板子上可直接运行 <code class="+ topic/ph pr-d/codeph ph codeph">test_keyadc</code> 命令。执行下列命令,可以查看
<code class="+ topic/ph pr-d/codeph ph codeph">test_keyadc</code>
命令参数:</p><pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="id__pre_ow3_2xv_wcc" data-ofbid="id__pre_ow3_2xv_wcc">test_keyadc -h</pre><pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="id__codeblock_ng1_pw4_tdc" data-ofbid="id__codeblock_ng1_pw4_tdc">Compile time: Mar <span class="hl-number">16202409</span>:<span class="hl-number">58</span>:<span class="hl-number">21</span>
Usage: test_keyadc [options]
-c, --channel Select one channel in[<span class="hl-number">0</span>, <span class="hl-number">7</span>], <strong class="hl-keyword">default</strong> is <span class="hl-number">2</span>
-s, --scale Set the adc scale,<strong class="hl-keyword">default</strong> is <span class="hl-number">50</span>
-g, --get Get the adc value
-h, --help
Example: test_keyadc -c <span class="hl-number">2</span> -g
</pre> 执行上述操作后,可以获得按键矩阵的按键状态和采样通道号以及 adc
采样值:<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="id__codeblock_frh_4gf_1dc" data-ofbid="id__codeblock_frh_4gf_1dc">[key2] ch2: <span class="hl-number">3369</span> # [按键] 采样通道号: adc 采样值
LONG Press # 当前正在进行长按操作</pre><div class="- topic/div div highlight-shell notranslate">
<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="id__pre_pw3_2xv_wcc" data-ofbid="id__pre_pw3_2xv_wcc">test_keyadc -c <span class="hl-number">2</span># 设置采样通道
test_keyadc -s <span class="hl-number">50</span># 设置按键 adc 值可允许波动范围
test_keyadc -g # 开始按键矩阵判断[key2] ch2: <span class="hl-number">3369</span># [按键] 采样通道号: adc 采样值[key2] ch2: <span class="hl-number">3369</span>
LONG Press # 当前正在进行长按操作</pre>
</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__section_cdn_j55_1dc" data-tocid="id__section_cdn_j55_1dc">配置 GPAI</a></div></li><li class="section-item"><div class="section-title"><a href="#id__section_bdn_j55_1dc" data-tocid="id__section_bdn_j55_1dc">配置 test_keyadc</a></div></li><li class="section-item"><div class="section-title"><a href="#id__section_ycn_j55_1dc" data-tocid="id__section_ycn_j55_1dc">测试验证</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>