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" >
2025-07-22 11:15:46 +08:00
< 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/packages/artinchip/lvgl-ui ├── aic_demo // aic lvgl demo ├── lv_driver // lvgl 显示和 2D 加速对接 ├── lvgl // lvgl 库 ├── aic_ui.c // aic demo 入口 ├── aic_ui.h // aic demo 头文件 ├── lv_conf.h // ..." / > < 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/lvgl/lvgl_introduction.html" / > < meta name = "DC.relation" content = "../../../topics/sdk/lvgl/lvgl_test_guide.html" / > < meta name = "DC.relation" content = "../../../topics/sdk/lvgl/lvgl-connecting-display.html" / > < meta name = "DC.relation" content = "../../../topics/sdk/lvgl/lvgl-connecting-display.html" / > < meta name = "DC.relation" content = "../../../topics/sdk/lvgl/lvgl-hw-decoder.html" / > < meta name = "DC.relation" content = "../../../topics/sdk/lvgl/lvgl-freetype.html" / > < meta name = "DC.relation" content = "../../../topics/sdk/lvgl/lvgl-demo.html" / > < meta name = "DC.contributor" content = "yan.wang" / > < meta name = "DC.contributor" content = "yan.wang" / > < meta name = "DC.date.modified" content = "2025-05-16" / > < meta name = "DC.format" content = "HTML5" / > < meta name = "DC.identifier" content = "id" / > < meta name = "DC.language" content = "zh-CN" / > < title > 设计说明< / title > <!-- Generated with build number 2025051600. --> < meta name = "wh-path2root" content = "../../../" / > < meta name = "wh-toc-id" content = "id-d3752e5384" / > < meta name = "wh-source-relpath" content = "topics/sdk/lvgl/lvgl_design_guide.dita" / > < meta name = "wh-out-relpath" content = "topics/sdk/lvgl/lvgl_design_guide.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-07-22 11:15:46 +08:00
< script src = "../../../webhelp/app/options/properties.js?buildId=20250519091401" > < / script >
2025-04-23 17:54:31 +08:00
< script src = "../../../webhelp/app/localization/strings.js?buildId=2024041900" > < / script >
2025-07-22 11:15:46 +08:00
< script src = "../../../webhelp/app/search/index/keywords.js?buildId=20250519091401" > < / script >
2025-04-23 17:54:31 +08:00
< 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_mcc_32s_nbc" > < div class = "title" > < a href = "../../../topics/chapter-title/chapter-multi-media-sdk.html" > 多媒体< / a > < div class = "wh-tooltip" > < p class = "shortdesc" > GE、VE、Display、DVP、MPP、MPP 播放器等多媒体模块的介绍和使用说明。< / p > < / div > < / div > < / div > < / li > < li > < div class = "topicref" data-id = "id" > < div class = "title" > < a href = "../../../topics/sdk/lvgl/lvgl_introduction.html" > LVGL 使用指南< / a > < / div > < / div > < / li > < li class = "active" > < div class = "topicref" data-id = "id" > < div class = "title" > < a href = "../../../topics/sdk/lvgl/lvgl_design_guide.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/lvgl/lvgl_test_guide.html" title = "测试指南" aria-label = "上一主题: 测试指南" rel = "prev" > < / a > < / span >
< span class = "navnext" > < a class = "- topic/link link" href = "../../../topics/sdk/lvgl/lvgl-connecting-display.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-07-22 11:15:46 +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-d3752e463" 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-d3752e463-link" > 修订记录< / a > < / div > < / div > < / li > < li role = "treeitem" aria-expanded = "false" > < div data-tocid = "id-d3752e480" class = "topicref" data-id = "id" data-state = "not-ready" > < span role = "button" tabindex = "0" aria-labelledby = "button-expand-action id-d3752e480-link" class = "wh-expand-btn" > < / span > < div class = "title" > < a href = "../../../topics/sdk/env/sdk-compile.html" id = "id-d3752e480-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-d3752e604" class = "topicref" data-id = "id" data-state = "not-ready" > < span role = "button" tabindex = "0" aria-labelledby = "button-expand-action id-d3752e604-link" class = "wh-expand-btn" > < / span > < div class = "title" > < a href = "../../../topics/sdk/advanced/sdk-usage.html" id = "id-d3752e604-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-d3752e1004" 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-d3752e1004-link" class = "wh-expand-btn" > < / span > < div class = "title" > < a href = "../../../topics/sdk/chapter-app.html" id = "concept_rcx_czh_pzb-d3752e1004-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-d3752e1848" class = "topicref" data-id = "id" data-state = "not-ready" > < span role = "button" tabindex = "0" aria-labelledby = "button-expand-action id-d3752e1848-link" class = "wh-expand-btn" > < / span > < div class = "title" > < a href = "../../../topics/sdk/peripheral/peripheral-intro.html" id = "id-d3752e1848-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-d3752e2022" class = "topicref" data-id = "id" data-state = "not-ready" > < span role = "button" tabindex = "0" aria-labelledby = "button-expand-action id-d3752e2022-link" class = "wh-expand-btn" > < / span > < div class = "title" > < a href = "../../../topics/sdk/bringup/chapter-bringup.html" id = "id-d3752e2022-link" > BringUp< / a > < div class = "wh-tooltip" > < p class = "shortdesc" > 主要描述板卡的各项配置，使 SDK 的环境和板卡匹配，并确保 SDK 编译后的固件能够在板子上正常运行。< / p > < / div > < / div > < / div > < / li > < li role = "treeitem" aria-expanded = "true" > < div data-tocid = "id-d3752e2418" class = "topicref" data-id = "id" data-state = "expanded" > < span role = "button" tabindex = "0" aria-labelledby = "button-collapse-action id-d3752e2418-link" class = "wh-expand-btn" > < / span > < div class = "title" > < a href = "../../../topics/sdk/chapter-advanced-app.html" id = "id-d3752e2418-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-d3752e2435" class
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/lvgl/lvgl_design_guide.dita" > Edit online< / a > < / span > < h1 class = "- topic/title title topictitle1" id = "ariaid-title1" > 设计说明< / h1 >
2025-07-22 11:15:46 +08:00
< div class = "date inPage" > 16 May 2025< / div > < div style = "color: gray;" >
2025-01-23 16:37:00 +08:00
Read time: 3 minute(s)
2025-04-23 17:54:31 +08:00
< / div >
< div class = "- topic/body body" >
< div class = "- topic/div div section" id = "id__id2" >
2025-01-23 16:37:00 +08:00
< strong class = "+ topic/ph hi-d/b ph b" > 代码目录< / strong >
< pre class = "+ topic/pre pr-d/codeblock pre codeblock language-c" id = "id__codeblock_szg_1zf_fdc" data-ofbid = "id__codeblock_szg_1zf_fdc" > luban-lite/packages/artinchip/lvgl-ui
├── aic_demo < em class = "hl-comment" > // aic lvgl demo< / em >
├── lv_driver < em class = "hl-comment" > // lvgl 显示和 2D 加速对接< / em >
├── lvgl < em class = "hl-comment" > // lvgl 库< / em >
├── aic_ui.c < em class = "hl-comment" > // aic demo 入口< / em >
├── aic_ui.h < em class = "hl-comment" > // aic demo 头文件< / em >
├── lv_conf.h < em class = "hl-comment" > // lvgl 配置文件< / em >
├── lv_demo.c < em class = "hl-comment" > // lvgl demo 入口函数< / em >
└── SConscript
2025-04-23 17:54:31 +08:00
< / pre > < / div >
< section class = "- topic/section section" id = "id__section_w32_hpf_fdc" data-ofbid = "id__section_w32_hpf_fdc" > < h2 class = "- topic/title title sectiontitle" > LVGL 整体流程< / h2 >
2025-01-23 16:37:00 +08:00
2025-07-22 11:15:46 +08:00
< div class = "- topic/p p" data-ofbid = "d124040e41__20250519091518" > LVGL 的运行基于定时器 (Timer)，系统需要给 LVGL 一个“心跳”，即定时调用 < span class = "+ topic/keyword pr-d/apiname keyword apiname" > lv_tick_get()< / span >
2025-04-23 17:54:31 +08:00
函数来获取当前时间， < ul class = "- topic/ul ul simple" id = "id__ul_uzg_1zf_fdc" data-ofbid = "id__ul_uzg_1zf_fdc" >
2025-07-22 11:15:46 +08:00
< li class = "- topic/li li" data-ofbid = "d124040e48__20250519091518" >
< p class = "- topic/p p" data-ofbid = "d124040e50__20250519091518" > < span class = "+ topic/keyword pr-d/apiname keyword apiname" > lv_tick_get()< / span > ：获取以毫秒为单位的 tick 时间。< / p >
2025-04-23 17:54:31 +08:00
< / li >
2025-07-22 11:15:46 +08:00
< li class = "- topic/li li" data-ofbid = "d124040e56__20250519091518" >
< p class = "- topic/p p" data-ofbid = "d124040e58__20250519091518" > < span class = "+ topic/keyword pr-d/apiname keyword apiname" > lv_timer_handler()< / span > ：在 while 循环中的基于定时器的任务处理< / p >
< p class = "- topic/p p" data-ofbid = "d124040e63__20250519091518" > 函数 < span class = "+ topic/keyword pr-d/apiname keyword apiname" > lv_task_handler()< / span > 会调用
2025-01-23 16:37:00 +08:00
< span class = "+ topic/keyword pr-d/apiname keyword apiname" > lv_timer_handler()< / span > 。< span class = "+ topic/keyword pr-d/apiname keyword apiname" > lv_tick_get()< / span >
决定了 < span class = "+ topic/keyword pr-d/apiname keyword apiname" > lv_timer_handler()< / span > 基于定时器的任务处理的时间的准确性。< / p >
2025-04-23 17:54:31 +08:00
< / li >
< / ul > < / div >
< figure class = "- topic/fig fig fignone" id = "id__id11" data-ofbid = "id__id11" >
< br / > < div class = "imagecenter" > < img class = "- topic/image image imagecenter" id = "id__image_tzg_1zf_fdc" src = "../../../images/lvgl/key_process.png" alt = "key_process1" / > < / 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" > 整体流程< / span > < / figcaption > < / figure >
2025-01-23 16:37:00 +08:00
2025-07-22 11:15:46 +08:00
< div class = "- topic/div div" > < strong class = "+ topic/ph hi-d/b ph b" > < span class = "+ topic/keyword pr-d/apiname keyword apiname" > lv_tick_get()< / span > 的实现代码< / strong > < div class = "- topic/p p" data-ofbid = "d124040e99__20250519091518" > 在文件
2025-01-23 16:37:00 +08:00
< span class = "+ topic/ph sw-d/filepath ph filepath" > lv_hal_tick.c< / span > 中的 < span class = "+ topic/keyword pr-d/apiname keyword apiname" > lv_tick_get()< / span >
的实现代码如下：< pre class = "+ topic/pre pr-d/codeblock pre codeblock language-c" id = "id__codeblock_j5q_czf_fdc" data-ofbid = "id__codeblock_j5q_czf_fdc" > uint32_t lv_tick_get(< strong class = "hl-keyword" > void< / strong > )
{
#< strong class = "hl-keyword" > if< / strong > LV_TICK_CUSTOM == < span class = "hl-number" > 0< / span >
< em class = "hl-comment" > /*If `lv_tick_inc` is called from an interrupt while `sys_time` is read
*the result might be corrupted.
*This loop detects if `lv_tick_inc` was called while reading `sys_time`.
*If `tick_irq_flag` was cleared in `lv_tick_inc` try to read again
*until `tick_irq_flag` remains `1`.*/< / em >
uint32_t result;
< strong class = "hl-keyword" > do< / strong > {
tick_irq_flag = < span class = "hl-number" > 1< / span > ;
result = sys_time;
} < strong class = "hl-keyword" > while< / strong > (!tick_irq_flag); < em class = "hl-comment" > /*Continue until see a non interrupted cycle*/< / em >
< strong class = "hl-keyword" > return< / strong > result;
#< strong class = "hl-keyword" > else< / strong >
< strong class = "hl-keyword" > return< / strong > LV_TICK_CUSTOM_SYS_TIME_EXPR;
#endif
2025-07-22 11:15:46 +08:00
}< / pre > < / div > < div class = "- topic/p p" data-ofbid = "d124040e109__20250519091518" > 在头文件 < span class = "+ topic/ph sw-d/filepath ph filepath" > lv_rt_thread_conf.h< / span > 中定义了上述函数中的
2025-01-23 16:37:00 +08:00
LV_TICK_CUSTOM_SYS_TIME_EXPR< pre class = "+ topic/pre pr-d/codeblock pre codeblock language-c" id = "id__codeblock_y4x_czf_fdc" data-ofbid = "id__codeblock_y4x_czf_fdc" > #< span class = "hl-directive" > define< / span > LV_TICK_CUSTOM < span class = "hl-number" > 1< / span >
#< span class = "hl-directive" > define< / span > LV_TICK_CUSTOM_INCLUDE LV_RTTHREAD_INCLUDE
2025-07-22 11:15:46 +08:00
#< span class = "hl-directive" > define< / span > LV_TICK_CUSTOM_SYS_TIME_EXPR (rt_tick_get_millisecond()) < em class = "hl-comment" > /*Expression evaluating to current system time in ms*/< / em > < / pre > < / div > < div class = "- topic/p p" data-ofbid = "d124040e116__20250519091518" > 创建
2025-01-23 16:37:00 +08:00
LVGL
线程的代码如下所示：< pre class = "+ topic/pre pr-d/codeblock pre codeblock language-c" id = "id__codeblock_yj3_dzf_fdc" data-ofbid = "id__codeblock_yj3_dzf_fdc" > < strong class = "hl-keyword" > static< / strong > < strong class = "hl-keyword" > void< / strong > lvgl_thread_entry(< strong class = "hl-keyword" > void< / strong > *parameter)
{
#< strong class = "hl-keyword" > if< / strong > LV_USE_LOG
lv_log_register_print_cb(lv_rt_log);
#endif < em class = "hl-comment" > /* LV_USE_LOG */< / em >
lv_init();
lv_port_disp_init();
lv_port_indev_init();
lv_user_gui_init();
< em class = "hl-comment" > /* handle the tasks of LVGL */< / em >
< strong class = "hl-keyword" > while< / strong > (< span class = "hl-number" > 1< / span > )
{
lv_task_handler();
rt_thread_mdelay(SLEEP_PERIOD);
}
}
< strong class = "hl-keyword" > int< / strong > lvgl_thread_init(< strong class = "hl-keyword" > void< / strong > )
{
rt_err_t err;
err = rt_thread_init(& lvgl_thread, < span class = "hl-string" > "LVGL"< / span > , lvgl_thread_entry, RT_NULL,
& lvgl_thread_stack[< span class = "hl-number" > 0< / span > ], < strong class = "hl-keyword" > sizeof< / strong > (lvgl_thread_stack), LPKG_LVGL_THREAD_PRIO, < span class = "hl-number" > 0< / span > );
< strong class = "hl-keyword" > if< / strong > (err != RT_EOK)
{
LOG_E(< span class = "hl-string" > "Failed to create LVGL thread"< / span > );
< strong class = "hl-keyword" > return< / strong > -< span class = "hl-number" > 1< / span > ;
}
rt_thread_startup(& lvgl_thread);
< strong class = "hl-keyword" > return< / strong > < span class = "hl-number" > 0< / span > ;
2025-07-22 11:15:46 +08:00
}< / pre > < / div > < div class = "- topic/p p" data-ofbid = "d124040e120__20250519091518" > LVGL 通过定时器机制来驱动其内部任务处理，用户只需实现下列显示、输入设备和 UI
2025-04-23 17:54:31 +08:00
界面相关的初始化函数，即可快速构建嵌入式系统的图形界面：< ul class = "- topic/ul ul simple" id = "id__ul_vzg_1zf_fdc" data-ofbid = "id__ul_vzg_1zf_fdc" >
2025-07-22 11:15:46 +08:00
< li class = "- topic/li li" data-ofbid = "d124040e124__20250519091518" >
< p class = "- topic/p p" data-ofbid = "d124040e126__20250519091518" > < span class = "+ topic/keyword pr-d/apiname keyword apiname" > lv_port_disp_init()< / span > ：实现显示接口的对接以及硬件 2D 加速的对接< / p >
2025-04-23 17:54:31 +08:00
< / li >
2025-07-22 11:15:46 +08:00
< li class = "- topic/li li" data-ofbid = "d124040e132__20250519091518" >
< p class = "- topic/p p" data-ofbid = "d124040e134__20250519091518" > < span class = "+ topic/keyword pr-d/apiname keyword apiname" > lv_port_indev_init()< / span > ：实现触摸屏的对接< / p >
2025-04-23 17:54:31 +08:00
< / li >
2025-07-22 11:15:46 +08:00
< li class = "- topic/li li" data-ofbid = "d124040e140__20250519091518" >
< p class = "- topic/p p" data-ofbid = "d124040e142__20250519091518" > < span class = "+ topic/keyword pr-d/apiname keyword apiname" > lv_user_gui_init()< / span > ：适配不同 UI 界面的初始化< / p >
2025-04-23 17:54:31 +08:00
< / li >
< / ul > < / div > < / div >
< / section >
< section class = "- topic/section section" id = "id__section_xbw_fzf_fdc" data-ofbid = "id__section_xbw_fzf_fdc" > < h2 class = "- topic/title title sectiontitle" > LVGL 层次结构< / h2 >
2025-01-23 16:37:00 +08:00
2025-07-22 11:15:46 +08:00
< div class = "- topic/p p" data-ofbid = "d124040e156__20250519091518" >
2025-04-23 17:54:31 +08:00
< figure class = "- topic/fig fig fignone" id = "id__id12" data-ofbid = "id__id12" >
< br / > < div class = "imagecenter" > < img class = "- topic/image image imagecenter" id = "id__image_wzg_1zf_fdc" src = "../../../images/lvgl/struct.png" alt = "struct1.png" / > < / div > < br / >
< figcaption data-caption-side = "bottom" class = "- topic/title title figcapcenter" > < span class = "figtitleprefix fig--title-label" > 图< span class = "fig--title-label-number" > 2< / span > < span class = "fig--title-label-punctuation" > . < / span > < / span > < span class = "fig--title" > LVGL 层次结构< / span > < / figcaption > < / figure >
2025-01-23 16:37:00 +08:00
< / div >
2025-07-22 11:15:46 +08:00
< div class = "- topic/p p" data-ofbid = "d124040e171__20250519091518" > LVGL 层次结构主要包括以下几个部分：< ul class = "- topic/ul ul simple" id = "id__ul_xzg_1zf_fdc" data-ofbid = "id__ul_xzg_1zf_fdc" >
< li class = "- topic/li li" data-ofbid = "d124040e175__20250519091518" >
< p class = "- topic/p p" data-ofbid = "d124040e177__20250519091518" > Display： ， < / p >
2025-04-23 17:54:31 +08:00
< / li >
2025-07-22 11:15:46 +08:00
< li class = "- topic/li li" data-ofbid = "d124040e181__20250519091518" >
< p class = "- topic/p p" data-ofbid = "d124040e183__20250519091518" > Screen： ， < / p >
2025-04-23 17:54:31 +08:00
< / li >
2025-07-22 11:15:46 +08:00
< li class = "- topic/li li" data-ofbid = "d124040e187__20250519091518" >
< p class = "- topic/p p" data-ofbid = "d124040e189__20250519091518" > Layer： ， < / p >
2025-04-23 17:54:31 +08:00
< / li >
2025-07-22 11:15:46 +08:00
< li class = "- topic/li li" data-ofbid = "d124040e193__20250519091518" >
< div class = "- topic/p p" data-ofbid = "d124040e195__20250519091518" > 一个 display 包含多个 screen，
2025-04-23 17:54:31 +08:00
按照层级关系叠加在一起，形成最终的显示效果。具体来说：< ul class = "- topic/ul ul" id = "id__ul_kjv_vqg_fdc" data-ofbid = "id__ul_kjv_vqg_fdc" >
2025-07-22 11:15:46 +08:00
< li class = "- topic/li li" data-ofbid = "d124040e199__20250519091518" >
< p class = "- topic/p p" data-ofbid = "d124040e201__20250519091518" > Active Screen： ， ， ， < / p >
< p class = "- topic/p p" data-ofbid = "d124040e204__20250519091518" > 一般在 Active Screen 实现不同的 app 界面，用户可以创建多个 screen，
2025-01-23 16:37:00 +08:00
设置为 Active Screen< / p >
2025-04-23 17:54:31 +08:00
< / li >
2025-07-22 11:15:46 +08:00
< li class = "- topic/li li" data-ofbid = "d124040e208__20250519091518" >
< p class = "- topic/p p" data-ofbid = "d124040e210__20250519091518" > Top layer： < / p >
< p class = "- topic/p p" data-ofbid = "d124040e213__20250519091518" > Top layer 永远在 Active Screen 之上。< / p >
2025-04-23 17:54:31 +08:00
< / li >
2025-07-22 11:15:46 +08:00
< li class = "- topic/li li" data-ofbid = "d124040e217__20250519091518" >
< p class = "- topic/p p" data-ofbid = "d124040e219__20250519091518" > System layer： ， ，
2025-01-23 16:37:00 +08:00
layer， < / p >
2025-04-23 17:54:31 +08:00
< / li >
< / ul > < / div >
< / li >
< / ul > < / div >
2025-07-22 11:15:46 +08:00
< div class = "- topic/p p" data-ofbid = "d124040e226__20250519091518" > 为了更好地理解 LVGL 的层次结构，可以参考以下图层叠加的示意图：< figure class = "- topic/fig fig fignone" id = "id__id13" data-ofbid = "id__id13" >
2025-04-23 17:54:31 +08:00
< br / > < div class = "imagecenter" > < img class = "- topic/image image imagecenter" id = "id__image_yzg_1zf_fdc" src = "../../../images/lvgl/layer.png" alt = "layer1" / > < / div > < br / >
< figcaption data-caption-side = "bottom" class = "- topic/title title figcapcenter" > < span class = "figtitleprefix fig--title-label" > 图< span class = "fig--title-label-number" > 3< / span > < span class = "fig--title-label-punctuation" > . < / span > < / span > < span class = "fig--title" > 图层叠加< / span > < / figcaption > < / figure > < / div >
< / section >
< section class = "- topic/section section" id = "id__section_hmp_fzf_fdc" data-ofbid = "id__section_hmp_fzf_fdc" > < h2 class = "- topic/title title sectiontitle" > 父子结构< / h2 >
2025-01-23 16:37:00 +08:00
2025-07-22 11:15:46 +08:00
< div class = "- topic/p p" data-ofbid = "d124040e246__20250519091518" > 父子结构的设计是 LVGL 面向对象的核心设计之一，使得图形界面的层次关系和布局管理变得非常直观和灵活。父子结构的特点如下所示：< ul class = "- topic/ul ul" id = "id__ul_stx_nrg_fdc" data-ofbid = "id__ul_stx_nrg_fdc" >
< li class = "- topic/li li" data-ofbid = "d124040e250__20250519091518" > 每一个对象都包含一个父对象， < / li >
< li class = "- topic/li li" data-ofbid = "d124040e253__20250519091518" > 一个父对象可以包含任意数量的子对象。< / li >
< li class = "- topic/li li" data-ofbid = "d124040e256__20250519091518" > 创建对象时需要传入父对象的指针，如果父对象为 NULL，
2025-04-23 17:54:31 +08:00
对象。< pre class = "+ topic/pre pr-d/codeblock pre codeblock language-c" id = "id__codeblock_wvl_f1g_fdc" data-ofbid = "id__codeblock_wvl_f1g_fdc" > lv_obj_create(NULL);< / pre > < / li >
2025-07-22 11:15:46 +08:00
< li class = "- topic/li li" data-ofbid = "d124040e261__20250519091518" > 父对象和子对象一起移动。< div class = "- topic/div div section" id = "id__id5" >
2025-01-23 16:37:00 +08:00
< strong class = "+ topic/ph hi-d/b ph b" > 父子对象一起移动< / strong >
2025-04-23 17:54:31 +08:00
< figure class = "- topic/fig fig fignone" id = "id__id14" data-ofbid = "id__id14" >
< br / > < div class = "imagecenter" > < img class = "- topic/image image imagecenter" id = "id__image_zzg_1zf_fdc" src = "../../../images/lvgl/move.png" alt = "move1" / > < / div > < br / >
< figcaption data-caption-side = "bottom" class = "- topic/title title figcapcenter" > < span class = "figtitleprefix fig--title-label" > 图< span class = "fig--title-label-number" > 4< / span > < span class = "fig--title-label-punctuation" > . < / span > < / span > < span class = "fig--title" > 父子对象移动< / span > < / figcaption > < / figure >
< / div > < / li >
2025-07-22 11:15:46 +08:00
< li class = "- topic/li li" data-ofbid = "d124040e281__20250519091518" > 子对象超出父对象部分不可见。< figure class = "- topic/fig fig fignone" id = "id__id15" data-ofbid = "id__id15" >
2025-04-23 17:54:31 +08:00
< br / > < div class = "imagecenter" > < img class = "- topic/image image imagecenter" id = "id__image_a1h_1zf_fdc" src = "../../../images/lvgl/outside1.png" alt = "outside1" / > < / div > < br / >
< figcaption data-caption-side = "bottom" class = "- topic/title title figcapcenter" > < span class = "figtitleprefix fig--title-label" > 图< span class = "fig--title-label-number" > 5< / span > < span class = "fig--title-label-punctuation" > . < / span > < / span > < span class = "fig--title" > 子对象可见区域< / span > < / figcaption > < / figure > < / li >
< / ul > < / div >
< / section >
< / div >
< / article > < / main > < / div >
2025-01-23 16:37:00 +08:00
< div class = " wh_child_links d-print-none " > < nav aria-label = "Child Links" role = "navigation" class = "- topic/related-links related-links" > < ul class = "ullinks" > < li class = "- topic/link link ulchildlink" > < strong > < a href = "../../../topics/sdk/lvgl/lvgl-connecting-display.html" > 显示对接< / a > < / strong > < / li > < li class = "- topic/link link ulchildlink" > < strong > < a href = "../../../topics/sdk/lvgl/lvgl-hw-decoder.html" > 硬件解码对接< / a > < / strong > < / li > < li class = "- topic/link link ulchildlink" > < strong > < a href = "../../../topics/sdk/lvgl/lvgl-freetype.html" > 第三方 FreeType 库支持< / a > < / strong > < / li > < li class = "- topic/link link ulchildlink" > < strong > < a href = "../../../topics/sdk/lvgl/lvgl-demo.html" > LVGL Demo< / a > < / strong > < / li > < / ul > < / nav > < / 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_w32_hpf_fdc" data-tocid = "id__section_w32_hpf_fdc" > LVGL 整体流程< / a > < / div > < / li > < li class = "section-item" > < div class = "section-title" > < a href = "#id__section_xbw_fzf_fdc" data-tocid = "id__section_xbw_fzf_fdc" > LVGL 层次结构< / a > < / div > < / li > < li class = "section-item" > < div class = "section-title" > < a href = "#id__section_hmp_fzf_fdc" data-tocid = "id__section_hmp_fzf_fdc" > 父子结构< / 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-07-22 11:15:46 +08:00
Update Time: 2025-05-19
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 >
