2025-04-23 17:54:31 +08:00
<!DOCTYPE html> < html xmlns = "http://www.w3.org/1999/xhtml" xml:lang = "zh-cn" lang = "zh-cn" data-whc_version = "26.1" >
< 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 = "源码说明 源代码位于 bsp/artinchip/ ： ， ， ， / > < 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/cap/cap_user_guide.html" / > < meta name = "DC.relation" content = "../../../topics/sdk/cap/cap_test.html" / > < meta name = "DC.relation" content = "../../../topics/sdk/cap/cap_faq.html" / > < meta name = "DC.contributor" content = "yan.wang" / > < meta name = "DC.contributor" content = "yan.wang" / > < meta name = "DC.date.modified" content = "2025-04-09" / > < meta name = "DC.format" content = "HTML5" / > < meta name = "DC.identifier" content = "id" / > < meta name = "DC.language" content = "zh-CN" / > < title > 设计说明< / title > < meta name = "wh-path2root" content = "../../../" / > < meta name = "wh-toc-id" content = "id-d3703e5567" / > < meta name = "wh-source-relpath" content = "topics/sdk/cap/cap_design.dita" / > < meta name = "wh-out-relpath" content = "topics/sdk/cap/cap_design.html" / >
2025-01-23 16:37:00 +08:00
2025-04-23 17:54:31 +08:00
< link rel = "stylesheet" type = "text/css" href = "../../../webhelp/app/commons.css?buildId=2024041900" / >
< link rel = "stylesheet" type = "text/css" href = "../../../webhelp/app/topic.css?buildId=2024041900" / >
2025-01-23 16:37:00 +08:00
2025-04-23 17:54:31 +08:00
< script src = "../../../webhelp/app/options/properties.js?buildId=20250409170918" > < / script >
< script src = "../../../webhelp/app/localization/strings.js?buildId=2024041900" > < / script >
< script src = "../../../webhelp/app/search/index/keywords.js?buildId=20250409170918" > < / script >
< script defer = "defer" src = "../../../webhelp/app/commons.js?buildId=2024041900" > < / script >
< script defer = "defer" src = "../../../webhelp/app/topic.js?buildId=2024041900" > < / script >
< link rel = "stylesheet" type = "text/css" href = "../../../webhelp/template/css/aic-styles-web-internal.css?buildId=2024041900" / > < link rel = "stylesheet" type = "text/css" href = "../../../webhelp/template/css/notes.css?buildId=2024041900" / > < link rel = "stylesheet" type = "text/css" href = "../../../webhelp/template/css/aic-common.css?buildId=2024041900" / > < link rel = "stylesheet" type = "text/css" href = "../../../webhelp/template/css/aic-images.css?buildId=2024041900" / > < link rel = "stylesheet" type = "text/css" href = "../../../webhelp/template/css/footnote.css?buildId=2024041900" / > < link rel = "stylesheet" type = "text/css" href = "../../../webhelp/template/css/aic-highlight-changes.css?buildId=2024041900" / > < link rel = "stylesheet" type = "text/css" href = "../../../webhelp/template/css/search-in-header.css?buildId=2024041900" / > < link rel = "stylesheet" type = "text/css" href = "../../../webhelp/template/css/topic-body-list.css?buildId=2024041900" / > < / head >
2025-01-23 16:37:00 +08:00
< 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" >
2025-04-23 17:54:31 +08:00
< div xmlns:whc = "http://www.oxygenxml.com/webhelp/components" class = "wh_header_flex_container navbar-nav navbar-expand-md navbar-dark" >
2025-01-23 16:37:00 +08:00
< div class = "wh_logo_and_publication_title_container" >
< div class = "wh_logo_and_publication_title" >
2025-04-23 17:54:31 +08:00
< a href = "https://www.artinchip.com" class = " wh_logo d-none d-sm-block " > < img src = "../../../company-logo.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 >
2025-01-23 16:37:00 +08:00
< / div >
< / div >
< div class = "wh_top_menu_and_indexterms_link collapse navbar-collapse" id = "wh_top_menu_and_indexterms_link" >
< / div >
< 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 >
2025-04-23 17:54:31 +08:00
< / div > < / div >
< / div >
< / header >
2025-01-23 16:37:00 +08:00
< 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/chapter-advanced-app.html" > 高级应用< / a > < div class = "wh-tooltip" > < p class = "shortdesc" > 系统、存储、多媒体、接口、安全等模块的详细配置和设计说明。< / p > < / div > < / div > < / div > < / li > < li > < div class = "topicref" data-id = "concept_nww_hzh_pzb" > < div class = "title" > < a href = "../../../topics/chapter-title/chapter-interface-sdk.html" > 接口< / a > < div class = "wh-tooltip" > < p class = "shortdesc" > CAN< span class = "ph" > 、CAP< / span > 、CIR、GPAI、GPIO、I2C、PSADC、PWM 等接口模块的介绍和使用说明。< / p > < / div > < / div > < / div > < / li > < li > < div class = "topicref" data-id = "id" > < div class = "title" > < a href = "../../../topics/sdk/cap/cap_user_guide.html" > CAP 使用指南< / a > < / div > < / div > < / li > < li class = "active" > < div class = "topicref" data-id = "id" > < div class = "title" > < a href = "../../../topics/sdk/cap/cap_design.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/cap/cap_test.html" title = "测试指南" aria-label = "上一主题: 测试指南" rel = "prev" > < / a > < / span >
< span class = "navnext" > < a class = "- topic/link link" href = "../../../topics/sdk/cap/cap_faq.html" title = "常见问题" aria-label = "下一主题: 常见问题" 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" >
2025-04-23 17:54:31 +08:00
< 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-d3703e457" 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-d3703e457-link" > 修订记录< / a > < / div > < / div > < / li > < li role = "treeitem" aria-expanded = "false" > < div data-tocid = "id-d3703e479" class = "topicref" data-id = "id" data-state = "not-ready" > < span role = "button" tabindex = "0" aria-labelledby = "button-expand-action id-d3703e479-link" class = "wh-expand-btn" > < / span > < div class = "title" > < a href = "../../../topics/sdk/env/sdk-compile.html" id = "id-d3703e479-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-d3703e601" class = "topicref" data-id = "id" data-state = "not-ready" > < span role = "button" tabindex = "0" aria-labelledby = "button-expand-action id-d3703e601-link" class = "wh-expand-btn" > < / span > < div class = "title" > < a href = "../../../topics/sdk/advanced/sdk-usage.html" id = "id-d3703e601-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-d3703e1001" 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-d3703e1001-link" class = "wh-expand-btn" > < / span > < div class = "title" > < a href = "../../../topics/sdk/chapter-app.html" id = "concept_rcx_czh_pzb-d3703e1001-link" > 应用场景< / a > < div class = "wh-tooltip" > < p class = "shortdesc" > 描述了 SDK 在不同应用场景中的配置和使用， < / p > < / div > < / div > < / div > < / li > < li role = "treeitem" aria-expanded = "false" > < div data-tocid = "id-d3703e1841" class = "topicref" data-id = "id" data-state = "not-ready" > < span role = "button" tabindex = "0" aria-labelledby = "button-expand-action id-d3703e1841-link" class = "wh-expand-btn" > < / span > < div class = "title" > < a href = "../../../topics/sdk/peripheral/peripheral-intro.html" id = "id-d3703e1841-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-d3703e2015" class = "topicref" data-id = "id" data-state = "not-ready" > < span role = "button" tabindex = "0" aria-labelledby = "button-expand-action id-d3703e2015-link" class = "wh-expand-btn" > < / span > < div class = "title" > < a href = "../../../topics/sdk/bringup/chapter-bringup.html" id = "id-d3703e2015-link" > BringUp< / a > < div class = "wh-tooltip" > < p class = "shortdesc" > 在硬件上电后快速初始化系统，为操作系统的启动准备好必要的硬件环境。< / p > < / div > < / div > < / div > < / li > < li role = "treeitem" aria-expanded = "true" > < div data-tocid = "id-d3703e2355" class = "topicref" data-id = "id" data-state = "expanded" > < span role = "button" tabindex = "0" aria-labelledby = "button-collapse-action id-d3703e2355-link" class = "wh-expand-btn" > < / span > < div class = "title" > < a href = "../../../topics/sdk/chapter-advanced-app.html" id = "id-d3703e2355-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 = "_0-d3703e2372" class = "topicref" data-id = "_0" data-state = "
2025-01-23 16:37:00 +08:00
< / 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 >
2025-04-23 17:54:31 +08:00
< 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://aicdocco/taskstopics/sdk/cap/cap_design.dita" > Edit online< / a > < / span > < h1 class = "- topic/title title topictitle1" id = "ariaid-title1" > 设计说明< / h1 >
< div class = "date inPage" > 9 Apr 2025< / div > < div style = "color: gray;" >
Read time: 5 minute(s)
< / div >
< div class = "- topic/body body" >
< section class = "- topic/section section" id = "id__section_y5v_gpf_fdc" data-ofbid = "id__section_y5v_gpf_fdc" > < h2 class = "- topic/title title sectiontitle" > 源码说明< / h2 >
2025-01-23 16:37:00 +08:00
2025-04-23 17:54:31 +08:00
< p class = "- topic/p p" data-ofbid = "d122852e33__20250409171044" > 源代码位于 < span class = "+ topic/ph sw-d/filepath ph filepath" > bsp/artinchip/< / span > ： < / p >
< ul class = "- topic/ul ul simple" id = "id__ul_azy_svh_fdc" data-ofbid = "id__ul_azy_svh_fdc" >
< li class = "- topic/li li" data-ofbid = "d122852e41__20250409171044" >
< p class = "- topic/p p" data-ofbid = "d122852e43__20250409171044" > < span class = "+ topic/ph sw-d/filepath ph filepath" > bsp/artinchip/drv/cap/drv_cap.c< / span > ， < / p >
< / li >
< li class = "- topic/li li" data-ofbid = "d122852e49__20250409171044" >
< p class = "- topic/p p" data-ofbid = "d122852e51__20250409171044" > < span class = "+ topic/ph sw-d/filepath ph filepath" > bsp/artinchip/hal/pwmcs/hal_cap.c< / span > ，
2025-01-23 16:37:00 +08:00
层实现< / p >
2025-04-23 17:54:31 +08:00
< / li >
< li class = "- topic/li li" data-ofbid = "d122852e57__20250409171044" >
< p class = "- topic/p p" data-ofbid = "d122852e59__20250409171044" > < span class = "+ topic/ph sw-d/filepath ph filepath" > bsp/artinchip/include/hal/hal_cap.h< / span > ，
2025-01-23 16:37:00 +08:00
层接口头文件< / p >
2025-04-23 17:54:31 +08:00
< / li >
< / ul >
< / section >
< section class = "- topic/section section" id = "id__section_k2y_jwh_fdc" data-ofbid = "id__section_k2y_jwh_fdc" > < h2 class = "- topic/title title sectiontitle" > 模块架构< / h2 >
2025-01-23 16:37:00 +08:00
2025-04-23 17:54:31 +08:00
< p class = "- topic/p p" data-ofbid = "d122852e72__20250409171044" > CAP 驱动 Driver 层采用 RT-Thread 的 INPUT CAPTURE 设备驱动框架，如果只使用 HAL 层也可以支持 Baremetal
2025-01-23 16:37:00 +08:00
方式的应用场景。< / p >
2025-04-23 17:54:31 +08:00
< figure class = "- topic/fig fig fignone" id = "id__id7" data-ofbid = "id__id7" >
< br / > < div class = "imagecenter" > < img class = "- topic/image image imagecenter" id = "id__image_bzy_svh_fdc" src = "../../../images/cap/cap_sw_system.png" alt = "sw_system" / > < / div > < br / >
< figcaption data-caption-side = "bottom" class = "- topic/title title figcapcenter" > < span class = "figtitleprefix fig--title-label" > 图< span class = "fig--title-label-number" > 1< / span > < span class = "fig--title-label-punctuation" > . < / span > < / span > < span class = "fig--title" > CAP 驱动的软件架构图< / span > < / figcaption > < / figure >
< / section >
< section class = "- topic/section section" id = "id__section_lxl_lwh_fdc" data-ofbid = "id__section_lxl_lwh_fdc" > < h2 class = "- topic/title title sectiontitle" > 关键流程设计< / h2 >
2025-01-23 16:37:00 +08:00
< div class = "- topic/div div section" id = "id__id5" >
< strong class = "+ topic/ph hi-d/b ph b" > 初始化流程< / strong >
2025-04-23 17:54:31 +08:00
< p class = "- topic/p p" data-ofbid = "d122852e98__20250409171044" > CAP 驱动的初始化接口通过 < span class = "+ topic/keyword pr-d/apiname keyword apiname" > INIT_DEVICE_EXPORT(drv_cap_init)< / span > 完成，主要是通过调用 INPUT
CAPTURE 子系统的接口 rt_device_inputcapture_register() 注册一个 CAP 设备。< / p > < p class = "- topic/p p" data-ofbid = "d122852e103__20250409171044" > CAP
控制器的配置过程，主要步骤有：< / p > < ol class = "- topic/ol ol arabic simple" id = "id__ol_czy_svh_fdc" data-ofbid = "id__ol_czy_svh_fdc" >
< li class = "- topic/li li" data-ofbid = "d122852e107__20250409171044" >
< p class = "- topic/p p" data-ofbid = "d122852e109__20250409171044" > 初始化 PWMCS 模块的 clk< / p >
< / li >
< li class = "- topic/li li" data-ofbid = "d122852e113__20250409171044" >
< p class = "- topic/p p" data-ofbid = "d122852e115__20250409171044" > 使能 CAP 指定通道的 clk< / p >
< / li >
< li class = "- topic/li li" data-ofbid = "d122852e119__20250409171044" >
< p class = "- topic/p p" data-ofbid = "d122852e121__20250409171044" > 设置 CAP 捕捉事件< / p >
< / li >
< li class = "- topic/li li" data-ofbid = "d122852e125__20250409171044" >
< p class = "- topic/p p" data-ofbid = "d122852e127__20250409171044" > 使能 CAP 的中断< / p >
< / li >
< li class = "- topic/li li" data-ofbid = "d122852e131__20250409171044" >
< p class = "- topic/p p" data-ofbid = "d122852e133__20250409171044" > 启动 CAP 计数< / p >
< / li >
< / ol > < / div >
< / section >
< section class = "- topic/section section" id = "id__section_swl_lwh_fdc" data-ofbid = "id__section_swl_lwh_fdc" > < h2 class = "- topic/title title sectiontitle" > 数据结构设计< / h2 >
2025-01-23 16:37:00 +08:00
< div class = "- topic/div div section" id = "id__struct-aic-cap-data" >
< strong class = "+ topic/ph hi-d/b ph b" > struct aic_cap_data< / strong >
2025-04-23 17:54:31 +08:00
< div class = "- topic/p p" data-ofbid = "d122852e149__20250409171044" > 属于 HAL 层接口，记录每一个 CAP
2025-01-23 16:37:00 +08:00
通道的捕捉数据信息：< pre class = "+ topic/pre pr-d/codeblock pre codeblock language-c" id = "id__codeblock_bfv_qwh_fdc" data-ofbid = "id__codeblock_bfv_qwh_fdc" > < strong class = "hl-keyword" > struct< / strong > aic_cap_data {
u8 id;
u32 freq;
< strong class = "hl-keyword" > float< / strong > duty;
};< / pre > < / div >
< / div >
< div class = "- topic/div div section" id = "id__struct-aic-cap" >
< strong class = "+ topic/ph hi-d/b ph b" > struct aic_cap< / strong >
2025-04-23 17:54:31 +08:00
< div class = "- topic/p p" data-ofbid = "d122852e160__20250409171044" > 属于 Driver 层接口，记录一个 CAP
2025-01-23 16:37:00 +08:00
设备的配置信息：< pre class = "+ topic/pre pr-d/codeblock pre codeblock language-c" id = "id__codeblock_zfz_qwh_fdc" data-ofbid = "id__codeblock_zfz_qwh_fdc" > < strong class = "hl-keyword" > struct< / strong > aic_cap {
< strong class = "hl-keyword" > struct< / strong > rt_inputcapture_device rtdev;
< strong class = "hl-keyword" > struct< / strong > aic_cap_data *data;
};< / pre > < / div >
< / div >
< div class = "- topic/div div section" id = "id__driver" >
< strong class = "+ topic/ph hi-d/b ph b" > Driver 层接口设计< / strong >
2025-04-23 17:54:31 +08:00
< div class = "- topic/p p" data-ofbid = "d122852e171__20250409171044" > 以下接口是 INPUT CAPTURE
2025-01-23 16:37:00 +08:00
设备驱动框架的标准接口。< pre class = "+ topic/pre pr-d/codeblock pre codeblock language-c" id = "id__codeblock_j54_rwh_fdc" data-ofbid = "id__codeblock_j54_rwh_fdc" > < strong class = "hl-keyword" > struct< / strong > rt_inputcapture_ops
{
rt_err_t (*init)(< strong class = "hl-keyword" > struct< / strong > rt_inputcapture_device *inputcapture);
rt_err_t (*open)(< strong class = "hl-keyword" > struct< / strong > rt_inputcapture_device *inputcapture);
rt_err_t (*close)(< strong class = "hl-keyword" > struct< / strong > rt_inputcapture_device *inputcapture);
rt_err_t (*get_pulsewidth)(< strong class = "hl-keyword" > struct< / strong > rt_inputcapture_device *inputcapture, rt_uint32_t *pulsewidth_us);
2025-04-23 17:54:31 +08:00
};< / pre > < / div > < div class = "table-container" > < table class = "- topic/table table frame-all" id = "id__table_dzy_svh_fdc" data-ofbid = "id__table_dzy_svh_fdc" 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" > aic_cap_init< / span > < / caption > < colgroup > < col style = "width:16.666666666666664%" / > < col style = "width:83.33333333333334%" / > < / colgroup > < thead class = "- topic/thead thead" >
< tr class = "- topic/row" >
< th class = "- topic/entry entry colsep-1 rowsep-1" id = "id__table_dzy_svh_fdc__entry__1" > < p class = "- topic/p p" data-ofbid = "d122852e191__20250409171044" > 函数原型< / p > < / th >
< th class = "- topic/entry entry colsep-0 rowsep-1" id = "id__table_dzy_svh_fdc__entry__2" > < p class = "- topic/p p" data-ofbid = "d122852e195__20250409171044" > static rt_err_t aic_cap_init(struct rt_inputcapture_device
*capture)< / p > < / th >
< / tr >
< / thead > < tbody class = "- topic/tbody tbody" >
< tr class = "- topic/row" >
< td class = "- topic/entry entry colsep-1 rowsep-1" headers = "id__table_dzy_svh_fdc__entry__1" > < p class = "- topic/p p" data-ofbid = "d122852e205__20250409171044" > 功能说明< / p > < / td >
< td class = "- topic/entry entry colsep-0 rowsep-1" headers = "id__table_dzy_svh_fdc__entry__2" > < p class = "- topic/p p" data-ofbid = "d122852e209__20250409171044" > 初始化配置一路 CAP< / p > < / td >
< / tr >
< tr class = "- topic/row" >
< td class = "- topic/entry entry colsep-1 rowsep-1" headers = "id__table_dzy_svh_fdc__entry__1" > < p class = "- topic/p p" data-ofbid = "d122852e216__20250409171044" > 参数定义< / p > < / td >
< td class = "- topic/entry entry colsep-0 rowsep-1" headers = "id__table_dzy_svh_fdc__entry__2" > < p class = "- topic/p p" data-ofbid = "d122852e220__20250409171044" >
2025-01-23 16:37:00 +08:00
< div class = "- topic/div div" >
< div class = "- topic/div div" > capture - 指向 rt_inputcapture_device 设备的指针< / div >
< / div >
2025-04-23 17:54:31 +08:00
< / p > < / td >
< / tr >
< tr class = "- topic/row" >
< td class = "- topic/entry entry colsep-1 rowsep-1" headers = "id__table_dzy_svh_fdc__entry__1" > < p class = "- topic/p p" data-ofbid = "d122852e233__20250409171044" > 返回值< / p > < / td >
< td class = "- topic/entry entry colsep-0 rowsep-1" headers = "id__table_dzy_svh_fdc__entry__2" > < p class = "- topic/p p" data-ofbid = "d122852e237__20250409171044" > 0， ； < 0， < / p > < / td >
< / tr >
< tr class = "- topic/row" >
< td class = "- topic/entry entry colsep-1 rowsep-0" headers = "id__table_dzy_svh_fdc__entry__1" > < p class = "- topic/p p" data-ofbid = "d122852e244__20250409171044" > 注意事项< / p > < / td >
< td class = "- topic/entry entry colsep-0 rowsep-0" headers = "id__table_dzy_svh_fdc__entry__2" > < p class = "- topic/p p" data-ofbid = "d122852e248__20250409171044" > - < / p > < / td >
< / tr >
< / tbody > < / table > < / div > < div class = "table-container" > < table class = "- topic/table table frame-all" id = "id__table_ezy_svh_fdc" data-ofbid = "id__table_ezy_svh_fdc" 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" > 2< / span > < span class = "table--title-label-punctuation" > . < / span > < / span > < span class = "table--title" > aic_cap_open< / span > < / caption > < colgroup > < col style = "width:16.666666666666664%" / > < col style = "width:83.33333333333334%" / > < / colgroup > < thead class = "- topic/thead thead" >
< tr class = "- topic/row" >
< th class = "- topic/entry entry colsep-1 rowsep-1" id = "id__table_ezy_svh_fdc__entry__1" > < p class = "- topic/p p" data-ofbid = "d122852e270__20250409171044" > 函数原型< / p > < / th >
< th class = "- topic/entry entry colsep-0 rowsep-1" id = "id__table_ezy_svh_fdc__entry__2" > < p class = "- topic/p p" data-ofbid = "d122852e274__20250409171044" > static rt_err_t aic_cap_open(struct rt_inputcapture_device
*capture)< / p > < / th >
< / tr >
< / thead > < tbody class = "- topic/tbody tbody" >
< tr class = "- topic/row" >
< td class = "- topic/entry entry colsep-1 rowsep-1" headers = "id__table_ezy_svh_fdc__entry__1" > < p class = "- topic/p p" data-ofbid = "d122852e284__20250409171044" > 功能说明< / p > < / td >
< td class = "- topic/entry entry colsep-0 rowsep-1" headers = "id__table_ezy_svh_fdc__entry__2" > < p class = "- topic/p p" data-ofbid = "d122852e288__20250409171044" > 打开 CAP< / p > < / td >
< / tr >
< tr class = "- topic/row" >
< td class = "- topic/entry entry colsep-1 rowsep-1" headers = "id__table_ezy_svh_fdc__entry__1" > < p class = "- topic/p p" data-ofbid = "d122852e295__20250409171044" > 参数定义< / p > < / td >
< td class = "- topic/entry entry colsep-0 rowsep-1" headers = "id__table_ezy_svh_fdc__entry__2" > < p class = "- topic/p p" data-ofbid = "d122852e299__20250409171044" >
2025-01-23 16:37:00 +08:00
< div class = "- topic/div div" >
< div class = "- topic/div div" > capture - 指向 rt_inputcapture_device 设备的指针< / div >
< / div >
2025-04-23 17:54:31 +08:00
< / p > < / td >
< / tr >
< tr class = "- topic/row" >
< td class = "- topic/entry entry colsep-1 rowsep-1" headers = "id__table_ezy_svh_fdc__entry__1" > < p class = "- topic/p p" data-ofbid = "d122852e312__20250409171044" > 返回值< / p > < / td >
< td class = "- topic/entry entry colsep-0 rowsep-1" headers = "id__table_ezy_svh_fdc__entry__2" > < p class = "- topic/p p" data-ofbid = "d122852e316__20250409171044" > 0， ； < 0， < / p > < / td >
< / tr >
< tr class = "- topic/row" >
< td class = "- topic/entry entry colsep-1 rowsep-0" headers = "id__table_ezy_svh_fdc__entry__1" > < p class = "- topic/p p" data-ofbid = "d122852e323__20250409171044" > 注意事项< / p > < / td >
< td class = "- topic/entry entry colsep-0 rowsep-0" headers = "id__table_ezy_svh_fdc__entry__2" > < p class = "- topic/p p" data-ofbid = "d122852e327__20250409171044" > - < / p > < / td >
< / tr >
< / tbody > < / table > < / div > < div class = "table-container" > < table class = "- topic/table table frame-all" id = "id__table_fzy_svh_fdc" data-ofbid = "id__table_fzy_svh_fdc" 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" > 3< / span > < span class = "table--title-label-punctuation" > . < / span > < / span > < span class = "table--title" > aic_cap_close< / span > < / caption > < colgroup > < col style = "width:16.666666666666664%" / > < col style = "width:83.33333333333334%" / > < / colgroup > < thead class = "- topic/thead thead" >
< tr class = "- topic/row" >
< th class = "- topic/entry entry colsep-1 rowsep-1" id = "id__table_fzy_svh_fdc__entry__1" > < p class = "- topic/p p" data-ofbid = "d122852e349__20250409171044" > 函数原型< / p > < / th >
< th class = "- topic/entry entry colsep-0 rowsep-1" id = "id__table_fzy_svh_fdc__entry__2" > < p class = "- topic/p p" data-ofbid = "d122852e353__20250409171044" > static rt_err_t aic_cap_close(struct rt_inputcapture_device
*capture)< / p > < / th >
< / tr >
< / thead > < tbody class = "- topic/tbody tbody" >
< tr class = "- topic/row" >
< td class = "- topic/entry entry colsep-1 rowsep-1" headers = "id__table_fzy_svh_fdc__entry__1" > < p class = "- topic/p p" data-ofbid = "d122852e363__20250409171044" > 功能说明< / p > < / td >
< td class = "- topic/entry entry colsep-0 rowsep-1" headers = "id__table_fzy_svh_fdc__entry__2" > < p class = "- topic/p p" data-ofbid = "d122852e367__20250409171044" > 关闭 CAP< / p > < / td >
< / tr >
< tr class = "- topic/row" >
< td class = "- topic/entry entry colsep-1 rowsep-1" headers = "id__table_fzy_svh_fdc__entry__1" > < p class = "- topic/p p" data-ofbid = "d122852e374__20250409171044" > 参数定义< / p > < / td >
< td class = "- topic/entry entry colsep-0 rowsep-1" headers = "id__table_fzy_svh_fdc__entry__2" > < p class = "- topic/p p" data-ofbid = "d122852e378__20250409171044" >
2025-01-23 16:37:00 +08:00
< div class = "- topic/div div" >
< div class = "- topic/div div" > capture - 指向 rt_inputcapture_device 设备的指针< / div >
< / div >
2025-04-23 17:54:31 +08:00
< / p > < / td >
< / tr >
< tr class = "- topic/row" >
< td class = "- topic/entry entry colsep-1 rowsep-1" headers = "id__table_fzy_svh_fdc__entry__1" > < p class = "- topic/p p" data-ofbid = "d122852e391__20250409171044" > 返回值< / p > < / td >
< td class = "- topic/entry entry colsep-0 rowsep-1" headers = "id__table_fzy_svh_fdc__entry__2" > < p class = "- topic/p p" data-ofbid = "d122852e395__20250409171044" > 0， ； < 0， < / p > < / td >
< / tr >
< tr class = "- topic/row" >
< td class = "- topic/entry entry colsep-1 rowsep-0" headers = "id__table_fzy_svh_fdc__entry__1" > < p class = "- topic/p p" data-ofbid = "d122852e402__20250409171044" > 注意事项< / p > < / td >
< td class = "- topic/entry entry colsep-0 rowsep-0" headers = "id__table_fzy_svh_fdc__entry__2" > < p class = "- topic/p p" data-ofbid = "d122852e406__20250409171044" > - < / p > < / td >
< / tr >
< / tbody > < / table > < / div > < div class = "table-container" > < table class = "- topic/table table frame-all" id = "id__table_gzy_svh_fdc" data-ofbid = "id__table_gzy_svh_fdc" 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" > 4< / span > < span class = "table--title-label-punctuation" > . < / span > < / span > < span class = "table--title" > aic_cap_get_pulsewidth< / span > < / caption > < colgroup > < col style = "width:16.666666666666664%" / > < col style = "width:83.33333333333334%" / > < / colgroup > < thead class = "- topic/thead thead" >
< tr class = "- topic/row" >
< th class = "- topic/entry entry colsep-1 rowsep-1" id = "id__table_gzy_svh_fdc__entry__1" > < p class = "- topic/p p" data-ofbid = "d122852e428__20250409171044" > 函数原型< / p > < / th >
< th class = "- topic/entry entry colsep-0 rowsep-1" id = "id__table_gzy_svh_fdc__entry__2" > < p class = "- topic/p p" data-ofbid = "d122852e432__20250409171044" > static rt_err_t aic_cap_get_pulsewidth(struct
2025-01-23 16:37:00 +08:00
rt_inputcapture_device *capture, rt_uint32_t
2025-04-23 17:54:31 +08:00
*pulsewidth_us)< / p > < / th >
< / tr >
< / thead > < tbody class = "- topic/tbody tbody" >
< tr class = "- topic/row" >
< td class = "- topic/entry entry colsep-1 rowsep-1" headers = "id__table_gzy_svh_fdc__entry__1" > < p class = "- topic/p p" data-ofbid = "d122852e442__20250409171044" > 功能说明< / p > < / td >
< td class = "- topic/entry entry colsep-0 rowsep-1" headers = "id__table_gzy_svh_fdc__entry__2" > < p class = "- topic/p p" data-ofbid = "d122852e446__20250409171044" > 计算占空比与周期值< / p > < / td >
< / tr >
< tr class = "- topic/row" >
< td class = "- topic/entry entry colsep-1 rowsep-1" headers = "id__table_gzy_svh_fdc__entry__1" > < p class = "- topic/p p" data-ofbid = "d122852e453__20250409171044" > 参数定义< / p > < / td >
< td class = "- topic/entry entry colsep-0 rowsep-1" headers = "id__table_gzy_svh_fdc__entry__2" > < p class = "- topic/p p" data-ofbid = "d122852e457__20250409171044" >
2025-01-23 16:37:00 +08:00
< div class = "- topic/div div" >
< div class = "- topic/div div" > capture - 指向 rt_inputcapture_device 设备的指针< / div >
< div class = "- topic/div div" > pulsewidth_us - RT-Thread 回调参数脉冲间隔变量的指针< / div >
< / div >
2025-04-23 17:54:31 +08:00
< / p > < / td >
< / tr >
< tr class = "- topic/row" >
< td class = "- topic/entry entry colsep-1 rowsep-1" headers = "id__table_gzy_svh_fdc__entry__1" > < p class = "- topic/p p" data-ofbid = "d122852e473__20250409171044" > 返回值< / p > < / td >
< td class = "- topic/entry entry colsep-0 rowsep-1" headers = "id__table_gzy_svh_fdc__entry__2" > < p class = "- topic/p p" data-ofbid = "d122852e477__20250409171044" > 0， ； < 0， < / p > < / td >
< / tr >
< tr class = "- topic/row" >
< td class = "- topic/entry entry colsep-1 rowsep-0" headers = "id__table_gzy_svh_fdc__entry__1" > < p class = "- topic/p p" data-ofbid = "d122852e484__20250409171044" > 注意事项< / p > < / td >
< td class = "- topic/entry entry colsep-0 rowsep-0" headers = "id__table_gzy_svh_fdc__entry__2" > < p class = "- topic/p p" data-ofbid = "d122852e488__20250409171044" > AIC 除了提供标准回调参数 pulsewidth_us 外，另外提供了回调参数：频率与占空比< / p > < / td >
< / tr >
< / tbody > < / table > < / div > < / div >
2025-01-23 16:37:00 +08:00
< div class = "- topic/div div section" id = "id__hal" >
< strong class = "+ topic/ph hi-d/b ph b" > HAL 层接口设计< / strong >
2025-04-23 17:54:31 +08:00
< div class = "- topic/p p" data-ofbid = "d122852e500__20250409171044" > HAL 层的函数接口声明存放在 hal_cap.h
2025-01-23 16:37:00 +08:00
中，主要接口有：< pre class = "+ topic/pre pr-d/codeblock pre codeblock language-c" id = "id__codeblock_k1m_twh_fdc" data-ofbid = "id__codeblock_k1m_twh_fdc" > < strong class = "hl-keyword" > void< / strong > hal_cap_ch_init(u32 ch);
< strong class = "hl-keyword" > void< / strong > hal_cap_ch_deinit(u32 ch);
< strong class = "hl-keyword" > void< / strong > hal_cap_int_enable(u32 ch, < strong class = "hl-keyword" > int< / strong > enable);
u32 hal_cap_int_sta(< strong class = "hl-keyword" > void< / strong > );
u32 hal_cap_is_pending(u32 ch);
< strong class = "hl-keyword" > int< / strong > hal_cap_set_freq(u32 ch, u32 freq);
< strong class = "hl-keyword" > int< / strong > hal_cap_set_cnt(u32 ch, u32 cnt);
< strong class = "hl-keyword" > int< / strong > hal_cap_get(u32 ch);
< strong class = "hl-keyword" > int< / strong > hal_cap_in_config(u32 ch);
u32 hal_cap_reg0(u32 ch);
u32 hal_cap_reg1(u32 ch);
u32 hal_cap_reg2(u32 ch);
u32 hal_cap_int_flg(u32 ch);
< strong class = "hl-keyword" > void< / strong > hal_cap_clr_flg(u32 ch, u32 stat);
< strong class = "hl-keyword" > int< / strong > hal_cap_enable(u32 ch);
< strong class = "hl-keyword" > int< / strong > hal_cap_disable(u32 ch);
< strong class = "hl-keyword" > void< / strong > hal_cap_cnt_start(u32 ch);
< strong class = "hl-keyword" > void< / strong > hal_cap_cnt_stop(u32 ch);
< strong class = "hl-keyword" > int< / strong > hal_cap_init(< strong class = "hl-keyword" > void< / strong > );
< strong class = "hl-keyword" > int< / strong > hal_cap_deinit(< strong class = "hl-keyword" > void< / strong > );
< strong class = "hl-keyword" > void< / strong > hal_cap_status_show(< strong class = "hl-keyword" > void< / strong > );< / pre > < / div > < / div >
2025-04-23 17:54:31 +08:00
< / section >
< section class = "- topic/section section" id = "id__section_adb_nwh_fdc" data-ofbid = "id__section_adb_nwh_fdc" > < h2 class = "- topic/title title sectiontitle" > Demo< / h2 >
2025-01-23 16:37:00 +08:00
2025-04-23 17:54:31 +08:00
< div class = "- topic/p p" data-ofbid = "d122852e511__20250409171044" > 本 Demo 是 test_cap
2025-01-23 16:37:00 +08:00
的部分源码（ ） ： < pre class = "+ topic/pre pr-d/codeblock pre codeblock language-c" id = "id__codeblock_stc_5wh_fdc" data-ofbid = "id__codeblock_stc_5wh_fdc" > #< span class = "hl-directive" > define< / span > WATER_MARK < span class = "hl-number" > 50< / span >
< strong class = "hl-keyword" > struct< / strong > aic_cap_usr {
rt_uint8_t id;
rt_uint32_t freq;
< strong class = "hl-keyword" > float< / strong > duty;
};
< em class = "hl-comment" > /* callback function */< / em >
< strong class = "hl-keyword" > static< / strong > rt_err_t cap_cb(rt_device_t dev, rt_size_t size)
{
< strong class = "hl-keyword" > struct< / strong > rt_inputcapture_data inputcap_data[WATER_MARK];
rt_device_read(dev, < span class = "hl-number" > 0< / span > , (< strong class = "hl-keyword" > void< / strong > *)inputcap_data, size);
#ifdef ULOG_USING_ISR_LOG
< strong class = "hl-keyword" > struct< / strong > aic_cap_usr *data = (< strong class = "hl-keyword" > struct< / strong > aic_cap_usr *)dev-> user_data;
rt_kprintf(< span class = "hl-string" > "cap%d: freq:%dHz, duty:%d.%02d%%\n"< / span > ,
data-> id, data-> freq, (rt_uint32_t)data-> duty, (rt_uint32_t)(data-> duty * < span class = "hl-number" > 100< / span > ) % < span class = "hl-number" > 100< / span > );
< strong class = "hl-keyword" > for< / strong > (< strong class = "hl-keyword" > int< / strong > i = < span class = "hl-number" > 0< / span > ; i < size; i++)
rt_kprintf(< span class = "hl-string" > "%s: pulsewidth:%d us\n"< / span > , & dev-> parent.name, inputcap_data[i].pulsewidth_us);
#endif
< strong class = "hl-keyword" > return< / strong > RT_EOK;
}
< strong class = "hl-keyword" > int< / strong > test_cap(< strong class = "hl-keyword" > int< / strong > argc, < strong class = "hl-keyword" > char< / strong > **argv)
{
rt_uint32_t watermark = WATER_MARK;
rt_device_t cap_dev = RT_NULL;
< strong class = "hl-keyword" > char< / strong > device_name[< span class = "hl-number" > 8< / span > ] = {< span class = "hl-string" > "cap"< / span > };
< strong class = "hl-keyword" > int< / strong > ret;
< strong class = "hl-keyword" > if< / strong > (argc != < span class = "hl-number" > 2< / span > ) {
rt_kprintf(< span class = "hl-string" > "Usage: test_cap < channel> \n"< / span > );
< strong class = "hl-keyword" > return< / strong > -RT_ERROR;
}
strcat(device_name, argv[< span class = "hl-number" > 1< / span > ]);
cap_dev = rt_device_find(device_name);
< strong class = "hl-keyword" > if< / strong > (cap_dev == RT_NULL) {
rt_kprintf(< span class = "hl-string" > "Can't find %s device!\n"< / span > , device_name);
< strong class = "hl-keyword" > return< / strong > -RT_ERROR;
}
< em class = "hl-comment" > /* set callback function */< / em >
rt_device_set_rx_indicate(cap_dev, cap_cb);
ret = rt_device_control(cap_dev, INPUTCAPTURE_CMD_SET_WATERMARK, & watermark);
< strong class = "hl-keyword" > if< / strong > (ret != RT_EOK) {
rt_kprintf(< span class = "hl-string" > "Failed to set %s device watermark!\n"< / span > , device_name);
< strong class = "hl-keyword" > return< / strong > ret;
}
ret = rt_device_open(cap_dev, RT_DEVICE_OFLAG_RDWR);
< strong class = "hl-keyword" > if< / strong > (ret != RT_EOK) {
rt_kprintf(< span class = "hl-string" > "Failed to open %s device!\n"< / span > , device_name);
< strong class = "hl-keyword" > return< / strong > ret;
}
rt_kprintf(< span class = "hl-string" > "cap%d open.\n"< / span > , atoi(argv[< span class = "hl-number" > 1< / span > ]));
< strong class = "hl-keyword" > return< / strong > RT_EOK;
}
MSH_CMD_EXPORT_ALIAS(test_cap, test_cap, Test the cap);< / pre > < / div >
2025-04-23 17:54:31 +08:00
< / section >
< / div >
< / article > < / main > < / div >
2025-01-23 16:37:00 +08:00
< / 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_y5v_gpf_fdc" data-tocid = "id__section_y5v_gpf_fdc" > 源码说明< / a > < / div > < / li > < li class = "section-item" > < div class = "section-title" > < a href = "#id__section_k2y_jwh_fdc" data-tocid = "id__section_k2y_jwh_fdc" > 模块架构< / a > < / div > < / li > < li class = "section-item" > < div class = "section-title" > < a href = "#id__section_lxl_lwh_fdc" data-tocid = "id__section_lxl_lwh_fdc" > 关键流程设计< / a > < / div > < / li > < li class = "section-item" > < div class = "section-title" > < a href = "#id__section_swl_lwh_fdc" data-tocid = "id__section_swl_lwh_fdc" > 数据结构设计< / a > < / div > < / li > < li class = "section-item" > < div class = "section-title" > < a href = "#id__section_adb_nwh_fdc" data-tocid = "id__section_adb_nwh_fdc" > Demo< / 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 >
2025-04-23 17:54:31 +08:00
< style >
2025-01-23 16:37:00 +08:00
.p1 {
font-family: FangZhengShuSong, Times, serif;
}
.p2 {
font-family: Arial, Helvetica, sans-serif;
}
.p3 {
font-family: "Lucida Console", "Courier New", monospace;
}
2025-04-23 17:54:31 +08:00
< / style >
2025-01-23 16:37:00 +08:00
< div class = "webhelp.fragment.footer" >
2025-04-23 17:54:31 +08:00
< p class = "p1" > Copyright © 2019-2025 广东匠芯创科技有限公司. All rights reserved.< / p >
< / div >
< div >
2025-01-23 16:37:00 +08:00
< div class = "generation_time" >
2025-04-23 17:54:31 +08:00
Update Time: 2025-04-09
2025-01-23 16:37:00 +08:00
< / div >
2025-04-23 17:54:31 +08:00
< / div >
2025-01-23 16:37:00 +08:00
< / 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 >
