Files
luban-lite/doc/topics/sdk/bringup/lite-bringup-display_背光配置.html
刘可亮 11c97ef399 v1.2.1
2025-07-22 11:15:46 +08:00

207 lines
24 KiB
HTML
Raw Permalink 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.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="根据是否需要调节背光亮度,用户可以选择以下任意方式控制背光: GPIO 控制背光 :如果没有调节背光亮度需求,仅仅是亮或黑屏。 打开 menuconfig 配置界面,选择 GPIO 方式控制背光,以字符串的形式指定 GPIO 引脚,背光 GPIO 引脚默认高电平有效。 Board options ---&gt; [*] Using Display Engine (DE) Display ..."/><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/bringup/lite-bringup-display.html"/><meta name="DC.relation" content="../../../topics/sdk/bringup/lite-bringup-display_mipi-dbi.html"/><meta name="DC.relation" content="../../../topics/sdk/bringup/lite-bringup-display_启动_log.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="section_ib4_x5b_bdc"/><title>背光配置</title><!-- Generated with build number 2025051600. --><meta name="wh-path2root" content="../../../"/><meta name="wh-toc-id" content="section_ib4_x5b_bdc-d3752e2361"/><meta name="wh-source-relpath" content="topics/sdk/bringup/lite-bringup-display_背光配置.dita"/><meta name="wh-out-relpath" content="topics/sdk/bringup/lite-bringup-display_背光配置.html"/>
<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"/>
<script src="../../../webhelp/app/options/properties.js?buildId=20250519091401"></script>
<script src="../../../webhelp/app/localization/strings.js?buildId=2024041900"></script>
<script src="../../../webhelp/app/search/index/keywords.js?buildId=20250519091401"></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>
<body id="section_ib4_x5b_bdc" 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 xmlns:whc="http://www.oxygenxml.com/webhelp/components" 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="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>
</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>
</div></div>
</div>
</header>
<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/bringup/chapter-bringup.html">BringUp</a><div class="wh-tooltip"><p class="shortdesc">主要描述板卡的各项配置,使 SDK 的环境和板卡匹配,并确保 SDK 编译后的固件能够在板子上正常运行。</p></div></div></div></li><li><div class="topicref" data-id="id"><div class="title"><a href="../../../topics/sdk/bringup/lite-bringup-display.html">屏幕配置</a></div></div></li><li class="active"><div class="topicref" data-id="section_ib4_x5b_bdc"><div class="title"><a href="../../../topics/sdk/bringup/lite-bringup-display_%E8%83%8C%E5%85%89%E9%85%8D%E7%BD%AE.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/bringup/lite-bringup-display_mipi-dbi.html" title="MIPI-DBI" aria-label="上一主题: MIPI-DBI" rel="prev"></a></span>
<span class="navnext"><a class="- topic/link link" href="../../../topics/sdk/bringup/lite-bringup-display_%E5%90%AF%E5%8A%A8_log.html" title="启动 log" aria-label="下一主题: 启动 log" 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-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 在不同应用场景中的配置和使用包括系统更新、OTA、安全方案等。</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="true"><div data-tocid="id-d3752e2022" class="topicref" data-id="id" data-state="expanded"><span role="button" tabindex="0" aria-labelledby="button-collapse-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><ul role="group" class="navbar-nav nav-list"><li role="treeitem" aria-expanded="false"><div data-tocid="id-d3752e2039" class="topicref" data-id="id" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action id-d3752e2039-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/bringup/lite-bringup-prepare.html" id="id-d3752e2039-link">准备工作</a></div></div></li><li role="treeitem"><div data-tocid="id-d3752e2097" class="topicref" data-id="id" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/bringup/lite-bringup-soc.html" id="id-d3752e2097-link">引脚配置</a></div></div></li><li role="treeitem"><div data-tocid="id-d3752e2111" class="topicref" data-id="id" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/bringup/lite-bringup-ram.html" id="id-d3752e2111-link">内存配置</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="id-d3752e2125" class="topicref" data-id="id" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action id-d3752e2125-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/bringup/lite-bringup-storage.html" id="id-d3752e2125-link">存储配置</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="id-d3752e2233" class="topicref" data-id="id" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action id-d3752e2233-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/advanced/partition_config_2.html" id="id-d3752e2233-link">配置分区</a></div></div></li><li role="treeitem"><div data-tocid="id-d3752e2277" class="topicref" data-id="id" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/bringup/lite-bringup-console.html" id="id-d3752e2277-link">调试配置</a></div></div></li><li role="treeitem" aria-expanded="true"><div data-tocid="id-d3752e2291" class="topicref" data-id="id" data-state="expanded"><span role="button" tabindex="0" aria-labelledby="button-collapse-action id-d3752e2291-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/bringup/lite-bringup-display.html" id="id-d3752e2291-link">屏幕配置</a></div></div><ul role="group" class="navbar-nav nav-list"><li role="treeitem"><div data-tocid="section_etw_v5b_bdc-d3752e2305" class="topicref" data-id="section_etw_v5b_bdc" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/bringup/lite-bringup-display_rgb.html" id="section_etw_v5b_bdc-d3752e2305-link">RGB</a></div></div></li><li role="treeitem"><div data-tocid="section_nch_w5b_bdc-d3752e2319" class="topicref" data-id="section_nch_w5b_bdc" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/bringup/lite-bringup-display_lvds.html" id="section_nch_w5b_bdc-d3752e2319-link">LVDS</a></div></div></li><li role="treeitem"><div data-tocid="section_f4q_w5b_bdc-d3752e2333" class="topicref" data-id="section_f4q_w5b_bdc" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/bringup/lite-bringup-display_mipi.html" id="section_f4q_w5b_bdc-d3752e2333-link">MIPI</a></div></div></li><li role="treeitem"><div data-tocid="section_t5h_xxn_42c-d3752e2347" class="topicref" data-id="section_t5h_xxn_42c" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/bringup/lite-bringup-display_mipi-dbi.html" id="section_t5h_xxn_42c-d3752e2347-link">MIPI-DBI</a></div></div></li><li role="treeitem" class="active"><div data-tocid="section_ib4_x5b_bdc-d3752e2361" class="topicref" data-id="section_ib4_x5b_bdc" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/bringup/lite-bringup-display_%E8%83%8C%E5%85%89%E9%85%8D%E7%BD%AE.html" id="section_ib4_x5b_bdc-d3752e2361-link">背光配置</a></div></div></li><li role="treeitem"><div data-tocid="section_rqc_hg4_42c-d3752e2375" class="topicref" data-id="section_rqc_hg4_42c" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/bringup/lite-bringup-display_%E5%90%AF%E5%8A%A8_log.html" id="section_rqc_hg4_42c-d3752e2375-link">启动 log</a></div></div></li><li role="treeitem"><div data-tocid="concept_smb_cl3_pzb-d3752e2389" class="topicref" data-id="concept_smb_cl3_pzb" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/display/display_faq_screen.html" id="concept_smb_cl3_pzb-d3752e2389-link">调屏常见问题</a></div></div></li></ul></li><li role="treeitem"><div data-tocid="id-d3752e2403" class="topicref" data-id="id" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/bringup/lite-bringup-samples.html" id="id-d3752e2403-link">示例程序</a></div></div></li></ul></li><li role="treeitem" aria-expanded="false"><div data-tocid="id-d3752e2418" class="topicref" data-id="id" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-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></li></ul></div>
</div>
</nav>
<div class="col-lg-9 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>
<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/bringup/lite-bringup-display_%E8%83%8C%E5%85%89%E9%85%8D%E7%BD%AE.dita">Edit online</a></span><h1 class="- topic/title title topictitle1" id="ariaid-title1">背光配置</h1>
<div class="date inPage">16 May 2025</div><div style="color: gray;">
Read time: 1 minute(s)
</div>
<div class="- topic/body body">
<div class="- topic/p p" data-ofbid="d85128e28__20250519091513">根据是否需要调节背光亮度,用户可以选择以下任意方式控制背光:<ul class="- topic/ul ul" id="section_ib4_x5b_bdc__ul_n4p_czb_bdc" data-ofbid="section_ib4_x5b_bdc__ul_n4p_czb_bdc">
<li class="- topic/li li" data-ofbid="d85128e32__20250519091513"><strong class="+ topic/ph hi-d/b ph b">GPIO 控制背光</strong>:如果没有调节背光亮度需求,仅仅是亮或黑屏。<p class="- topic/p p" data-ofbid="d85128e36__20250519091513">打开 menuconfig 配置界面,选择 GPIO
方式控制背光,以字符串的形式指定 GPIO 引脚,背光 GPIO
引脚默认高电平有效。</p><pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="section_ib4_x5b_bdc__pre_mb4_x5b_bdc" data-ofbid="section_ib4_x5b_bdc__pre_mb4_x5b_bdc">Board options ---&gt;
[*] Using Display Engine (DE)
Display Parameter ---&gt;
panel backlight control (gpio) ---&gt;
(PE.<span class="hl-number">19</span>) panel backlight enable pin
[ ] panel backlight enable pin low active</pre></li>
<li class="- topic/li li" data-ofbid="d85128e41__20250519091513"><strong class="+ topic/ph hi-d/b ph b">PWM 控制背光</strong>:如果有调节背光亮度的需求。<ol class="- topic/ol ol" id="section_ib4_x5b_bdc__ol_a1k_jzb_bdc" data-ofbid="section_ib4_x5b_bdc__ol_a1k_jzb_bdc">
<li class="- topic/li li" data-ofbid="d85128e47__20250519091513">打开 menuconfig 配置界面。,</li>
<li class="- topic/li li" data-ofbid="d85128e50__20250519091513">使能 PWM选择 PWM
方式控制背光。<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="section_ib4_x5b_bdc__pre_nb4_x5b_bdc" data-ofbid="section_ib4_x5b_bdc__pre_nb4_x5b_bdc">Board options ---&gt;
[*] Using PWM3</pre></li>
<li class="- topic/li li" data-ofbid="d85128e55__20250519091513">配置 PWM-BACKLIGHT 的通道和默认占空比 [0,
100]<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="section_ib4_x5b_bdc__pre_ob4_x5b_bdc" data-ofbid="section_ib4_x5b_bdc__pre_ob4_x5b_bdc">Board options ---&gt;
[*] Using Display Engine (DE)
Display Parameter ---&gt;
panel backlight control (pwm) ---&gt;
(<span class="hl-number">3</span>) pwm backlight channel
(<span class="hl-number">80</span>)<strong class="hl-keyword">default</strong> brightness level</pre></li>
<li class="- topic/li li" data-ofbid="d85128e60__20250519091513">如果需要修改 PWM-BACKLIGHT 频率,如下:<p class="- topic/p p" data-ofbid="d85128e62__20250519091513">部分 PWM 频点可能会导致啸叫,修改源码
<span class="+ topic/ph sw-d/filepath ph filepath">bsp/artinchip/drv/display/panel/panel_com.c</span></p><pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="section_ib4_x5b_bdc__codeblock_h1v_dg4_42c" data-ofbid="section_ib4_x5b_bdc__codeblock_h1v_dg4_42c"><strong class="hl-keyword">void</strong> panel_backlight_enable(<strong class="hl-keyword">struct</strong> aic_panel *panel, u32 ms)
{
...
<em class="hl-comment">// 默认 1KHz</em>
<em class="hl-comment">/* pwm frequency: 1KHz = 1000000ns */</em>
rt_pwm_set(pwm_dev, AIC_PWM_BACKLIGHT_CHANNEL,
<span class="hl-number">1000000</span>, <span class="hl-number">10000</span> * AIC_PWM_BRIGHTNESS_LEVEL);
}</pre></li>
</ol></li>
</ul></div>
</div>
</article></main></div>
</div>
</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-2025 广东匠芯创科技有限公司. All rights reserved.</p>
</div>
<div>
<div class="generation_time">
Update Time: 2025-05-19
</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>