linuxOS_D21X/doc/topics/sdk/display/display_panel_port.html
2025-01-23 16:35:08 +08:00

375 lines
41 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<!DOCTYPE html><html xmlns="http://www.w3.org/1999/xhtml" xml:lang="zh-cn" lang="zh-cn" data-whc_version="27.0">
<head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/><meta name="viewport" content="width=device-width, initial-scale=1.0"/><meta http-equiv="X-UA-Compatible" content="IE=edge"/><meta name="description" content="本章节介绍 LCD 外设在 Luban 上的适配方法。用户可选择以下任意方式配置屏参数: 将以下屏参数写入 panel 驱动源码中: 注: 对于屏时序参数,只有当 board.dts 文件的 panel 结点没有设置 display-timings 子节点时,此方式才会生效。 时序参数 /* Init the videomode parameter, dts will override the ..."/><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="concept"/><meta name="DC.relation" content="../../../topics/sdk/display/display_user_guide.html"/><meta name="DC.relation" content="../../../topics/sdk/display/display_demo.html"/><meta name="DC.relation" content="../../../topics/sdk/display/display_driver-intro.html"/><meta name="DC.relation" content="../../../topics/sdk/display/display_driver-intro.html"/><meta name="DC.contributor" content="yan.wang"/><meta name="DC.contributor" content="yan.wang"/><meta name="DC.date.modified" content="2024-01-15"/><meta name="DC.format" content="HTML5"/><meta name="DC.identifier" content="display_screen_configuration"/><meta name="DC.language" content="zh-CN"/><title>屏适配指南</title><!-- Generated with build number 2024112209. --><meta name="wh-path2root" content="../../../"/><meta name="wh-toc-id" content="display_screen_configuration-d4445e5106"/><meta name="wh-source-relpath" content="topics/sdk/display/display_panel_port.dita"/><meta name="wh-out-relpath" content="topics/sdk/display/display_panel_port.html"/>
<link rel="stylesheet" type="text/css" href="../../../webhelp/app/commons.css?buildId=2024112209"/>
<link rel="stylesheet" type="text/css" href="../../../webhelp/app/topic.css?buildId=2024112209"/>
<script src="../../../webhelp/app/options/properties.js?buildId=20250123154945"></script>
<script src="../../../webhelp/app/localization/strings.js?buildId=2024112209"></script>
<script src="../../../webhelp/app/search/index/keywords.js?buildId=20250123154945"></script>
<script defer="defer" src="../../../webhelp/app/commons.js?buildId=2024112209"></script>
<script defer="defer" src="../../../webhelp/app/topic.js?buildId=2024112209"></script>
<link rel="stylesheet" type="text/css" href="../../../webhelp/template/aic-styles-web.css?buildId=2024112209"/><link rel="stylesheet" type="text/css" href="../../../webhelp/template/notes.css?buildId=2024112209"/><link rel="stylesheet" type="text/css" href="../../../webhelp/template/aic-common.css?buildId=2024112209"/><link rel="stylesheet" type="text/css" href="../../../webhelp/template/aic-images.css?buildId=2024112209"/><link rel="stylesheet" type="text/css" href="../../../webhelp/template/footnote.css?buildId=2024112209"/><link rel="stylesheet" type="text/css" href="../../../webhelp/template/aic-web-watermark.css?buildId=2024112209"/><link rel="stylesheet" type="text/css" href="../../../webhelp/template/topic-body-list.css?buildId=2024112209"/></head>
<body id="display_screen_configuration" class="wh_topic_page frmBody">
<a href="#wh_topic_body" class="sr-only sr-only-focusable">
跳转到主要内容
</a>
<header class="navbar navbar-default wh_header">
<div class="container-fluid">
<div class="wh_header_flex_container navbar-nav navbar-expand-md navbar-dark">
<div class="wh_logo_and_publication_title_container">
<div class="wh_logo_and_publication_title">
<a href="http://www.artinchip.com" class=" wh_logo d-none d-sm-block "><img src="../../../company-logo-white.png" alt=" Linux SDK 使用指南 SDK 指南文件 "/></a>
<div class=" wh_publication_title "><a href="../../../index.html"><span class="booktitle"> <span class="ph mainbooktitle">Linux SDK 使用指南</span> <span class="ph booktitlealt">SDK 指南文件</span> </span></a></div>
</div>
</div>
<div class="wh_top_menu_and_indexterms_link collapse navbar-collapse" id="wh_top_menu_and_indexterms_link">
</div>
</div>
</div>
</header>
<div class=" wh_search_input navbar-form wh_topic_page_search search " role="form">
<form id="searchForm" method="get" role="search" action="../../../search.html"><div><input type="search" placeholder="搜索 " class="wh_search_textfield" id="textToSearch" name="searchQuery" aria-label="搜索查询" required="required"/><button type="submit" class="wh_search_button" aria-label="搜索"><span class="search_input_text">搜索</span></button></div></form>
</div>
<div class="container-fluid" id="wh_topic_container">
<div class="row">
<nav class="wh_tools d-print-none navbar-expand-md" aria-label="Tools">
<div data-tooltip-position="bottom" class=" wh_breadcrumb "><ol class="d-print-none"><li><span class="home"><a href="../../../index.html"><span>主页</span></a></span></li><li><div class="topicref" data-id="id"><div class="title"><a href="../../../topics/sdk/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/display/display_user_guide.html">Display 使用指南</a></div></div></li><li class="active"><div class="topicref" data-id="display_screen_configuration"><div class="title"><a href="../../../topics/sdk/display/display_panel_port.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/display/display_demo.html" title="Demo" aria-label="上一主题: Demo" rel="prev"></a></span>
<span class="navnext"><a class="- topic/link link" href="../../../topics/sdk/display/display_driver-intro.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">
<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-d4445e1079" 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_linux.html" id="revinfo_linux-d4445e1079-link">修订记录</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="id-d4445e1096" class="topicref" data-id="id" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action id-d4445e1096-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/env/sdk-compile.html" id="id-d4445e1096-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="tocId-d4445e1240" class="topicref" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action tocId-d4445e1240-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/advanced/lb_usage_commands.html" id="tocId-d4445e1240-link">使用指南</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="concept_rcx_czh_pzb-d4445e1360" 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-d4445e1360-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/chapter-app.html" id="concept_rcx_czh_pzb-d4445e1360-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-d4445e1678" class="topicref" data-id="id" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action id-d4445e1678-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/peripheral/peripheral-intro.html" id="id-d4445e1678-link">外设移植</a><div class="wh-tooltip"><p class="shortdesc"><span class="ph">触摸屏、显示器、WIFI 模块、按键</span>等外设的介绍和使用说明。</p></div></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="id-d4445e1964" class="topicref" data-id="id" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action id-d4445e1964-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/bringup/chapter-bringup.html" id="id-d4445e1964-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-d4445e2153" class="topicref" data-id="id" data-state="expanded"><span role="button" tabindex="0" aria-labelledby="button-collapse-action id-d4445e2153-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/chapter-advanced-app.html" id="id-d4445e2153-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="uBoot-d4445e2170" class="topicref" data-id="uBoot" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action uBoot-d4445e2170-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/boot/uboot-module.html" id="uBoot-d4445e2170-link">U-Boot</a><div class="wh-tooltip"><p class="shortdesc">启动支持的基本功能以及运行时的基本硬件环境。</p></div></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="concept_mtx_tk3_pzb-d4445e3028" class="topicref" data-id="concept_mtx_tk3_pzb" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action concept_mtx_tk3_pzb-d4445e3028-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/linux/chapter_linux.html" id="concept_mtx_tk3_pzb-d4445e3028-link">Linux</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="chapter-system-d4445e3198" class="topicref" data-id="chapter-system" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action chapter-system-d4445e3198-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/chapter-title/chapter-system.html" id="chapter-system-d4445e3198-link">系统</a><div class="wh-tooltip"><p class="shortdesc"></p></div></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="chapter-memory-d4445e4054" class="topicref" data-id="chapter-memory" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action chapter-memory-d4445e4054-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/chapter-title/chapter-memory-sdk.html" id="chapter-memory-d4445e4054-link">存储</a><div class="wh-tooltip"><p class="shortdesc">SDMC、SPI NAND、SPI NOR 等存储模块的介绍和使用说明。</p></div></div></div></li><li role="treeitem" aria-expanded="true"><div data-tocid="concept_mcc_32s_nbc-d4445e4438" class="topicref" data-id="concept_mcc_32s_nbc" data-state="expanded"><span role="button" tabindex="0" aria-labelledby="button-collapse-action concept_mcc_32s_nbc-d4445e4438-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/chapter-title/chapter-multi-media-sdk.html" id="concept_mcc_32s_nbc-d4445e4438-link">多媒体</a><div class="wh-tooltip"><p class="shortdesc">GE、VE、Display、DVP、MPP、MPP 播放器等多媒体模块的介绍和使用说明。</p></div></div></div><ul role="group" class="navbar-nav nav-list"><li role="treeitem" aria-expanded="false"><div data-tocid="ge-d4445e4455" class="topicref" data-id="ge" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action ge-d4445e4455-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/ge/ge_user_guide.html" id="ge-d4445e4455-link">GE 使用指南</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="ve-d4445e4637" class="topicref" data-id="ve" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action ve-d4445e4637-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/ve/ve-user-guide.html" id="ve-d4445e4637-link">VE 使用指南</a></div></div></li><li role="treeitem" aria-expanded="true"><div data-tocid="id-d4445e4777" class="topicref" data-id="id" data-state="expanded"><span role="button" tabindex="0" aria-labelledby="button-collapse-action id-d4445e4777-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/display/display_user_guide.html" id="id-d4445e4777-link">Display 使用指南</a></div></div><ul role="group" class="navbar-nav nav-list"><li role="treeitem" aria-expanded="false"><div data-tocid="display_configuration-d4445e4791" class="topicref" data-id="display_configuration" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action display_configuration-d4445e4791-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/display/display_config.html" id="display_configuration-d4445e4791-link">Display 配置</a><div class="wh-tooltip"><p class="shortdesc">显示模块的参数配置,包括 menuconfig 配置 和 dts 配置。</p></div></div></div></li><li role="treeitem"><div data-tocid="display_debug_guide-d4445e4965" class="topicref" data-id="display_debug_guide" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/display/display_debug.html" id="display_debug_guide-d4445e4965-link">调试指南</a></div></div></li><li role="treeitem"><div data-tocid="display_test_guide-d4445e4979" class="topicref" data-id="display_test_guide" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/display/display_test_guide.html" id="display_test_guide-d4445e4979-link">测试指南</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="display_design_intro-d4445e4993" class="topicref" data-id="display_design_intro" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action display_design_intro-d4445e4993-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/display/display-design_intro.html" id="display_design_intro-d4445e4993-link">设计说明</a></div></div></li><li role="treeitem" aria-expanded="true" class="active"><div data-tocid="display_screen_configuration-d4445e5106" class="topicref" data-id="display_screen_configuration" data-state="expanded"><span role="button" tabindex="0" aria-labelledby="button-collapse-action display_screen_configuration-d4445e5106-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/display/display_panel_port.html" id="display_screen_configuration-d4445e5106-link">屏适配指南</a></div></div><ul role="group" class="navbar-nav nav-list"><li role="treeitem"><div data-tocid="display_driver_intro-d4445e5120" class="topicref" data-id="display_driver_intro" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/display/display_driver-intro.html" id="display_driver_intro-d4445e5120-link">屏驱动支持</a></div></div></li></ul></li><li role="treeitem" aria-expanded="false"><div data-tocid="concept_xpy_32b_ybc-d4445e5134" class="topicref" data-id="concept_xpy_32b_ybc" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action concept_xpy_32b_ybc-d4445e5134-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/display/display_fb_rotation.html" id="concept_xpy_32b_ybc-d4445e5134-link">屏幕旋转</a></div></div></li><li role="treeitem"><div data-tocid="display_change_color-d4445e5162" class="topicref" data-id="display_change_color" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/display/display_color_property.html" id="display_change_color-d4445e5162-link">色彩调整</a></div></div></li><li role="treeitem"><div data-tocid="display_boot_logo-d4445e5176" class="topicref" data-id="display_boot_logo" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/display/display_boot_logo.html" id="display_boot_logo-d4445e5176-link">Boot Logo</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="display_common_issues-d4445e5190" class="topicref" data-id="display_common_issues" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action display_common_issues-d4445e5190-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/display/display_faqs.html" id="display_common_issues-d4445e5190-link">常见问题</a></div></div></li></ul></li><li role="treeitem" aria-expanded="false"><div data-tocid="concept_h4d_fwt_tzb-d4445e5218" class="topicref" data-id="concept_h4d_fwt_tzb" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action concept_h4d_fwt_tzb-d4445e5218-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/dvp/dvp_user_guide.html" id="concept_h4d_fwt_tzb-d4445e5218-link">DVP 使用指南</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="mpp-d4445e5358" class="topicref" data-id="mpp" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action mpp-d4445e5358-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/mpp/mpp_user_guide.html" id="mpp-d4445e5358-link">MPP 使用指南</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="mpp_0-d4445e5498" class="topicref" data-id="mpp_0" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action mpp_0-d4445e5498-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/mpp/mpp_player_user_guide.html" id="mpp_0-d4445e5498-link">MPP 播放器使用指南</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="gstreamer-d4445e5582" class="topicref" data-id="gstreamer" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action gstreamer-d4445e5582-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/gstreamer/gstreamer-user-guide.html" id="gstreamer-d4445e5582-link">Gstreamer 使用指南</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="i2s-d4445e5680" class="topicref" data-id="i2s" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action i2s-d4445e5680-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/i2s/i2s_user_guide.html" id="i2s-d4445e5680-link">I2S 使用指南</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="audio_codec_user_guide-d4445e5806" class="topicref" data-id="audio_codec_user_guide" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action audio_codec_user_guide-d4445e5806-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/audio_codec/audio-codec-user-guide.html" id="audio_codec_user_guide-d4445e5806-link">Audio Codec 使用指南</a></div></div></li></ul></li><li role="treeitem" aria-expanded="false"><div data-tocid="concept_nww_hzh_pzb-d4445e5947" class="topicref" data-id="concept_nww_hzh_pzb" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action concept_nww_hzh_pzb-d4445e5947-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/chapter-title/chapter-interface-sdk.html" id="concept_nww_hzh_pzb-d4445e5947-link">接口</a><div class="wh-tooltip"><p class="shortdesc">CAN、CIR、GPAI、GPIO、I2C、PSADC、PWM 等接口模块的介绍和使用说明。</p></div></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="chapter-safety-d4445e7944" class="topicref" data-id="chapter-safety" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action chapter-safety-d4445e7944-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/chapter-title/chapter-safety-sdk.html" id="chapter-safety-d4445e7944-link">安全</a><div class="wh-tooltip"><p class="shortdesc">SPI ENC、CE、eFuse 等安全模块的介绍和使用说明。</p></div></div></div></li></ul></li></ul></div>
</div>
</nav>
<div class="col-lg-7 col-md-9 col-sm-12" id="wh_topic_body">
<button id="wh_close_publication_toc_button" class="close-toc-button d-none" aria-label="Toggle publishing table of content" aria-controls="wh_publication_toc" aria-expanded="true">
<span class="close-toc-icon-container">
<span class="close-toc-icon"></span>
</span>
</button>
<button id="wh_close_topic_toc_button" class="close-toc-button d-none" aria-label="Toggle topic table of content" aria-controls="wh_topic_toc" aria-expanded="true">
<span class="close-toc-icon-container">
<span class="close-toc-icon"></span>
</span>
</button>
<div class=" wh_topic_content body "><main role="main"><article class="- topic/topic concept/concept topic concept" 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" title="Edit this document" href="http://172.16.35.88/tasks/jdssno1uvvbf2mltu9kb9v3if05d5gopuakboe8hlud18rma/edit/F:/aicdita/aicdita-cn/topics/sdk/display/display_panel_port.dita">Edit online</a></span><h1 class="- topic/title title topictitle1" id="ariaid-title1">屏适配指南</h1>
<div class="date inPage">15 Jan 2024</div><div style="color: gray;">
Read time: 4 minute(s)
</div>
<div class="- topic/body concept/conbody body conbody">
<p class="- topic/p p" data-ofbid="d139431e33__20250123155213">本章节介绍 LCD 外设在 <span class="- topic/ph ph">Luban</span> 上的适配方法。用户可选择以下任意方式配置屏参数:</p>
<div class="- topic/p p" data-ofbid="d139431e39__20250123155213">
<ul class="- topic/ul ul" id="display_screen_configuration__ul_zzy_l2g_d1c" data-ofbid="display_screen_configuration__ul_zzy_l2g_d1c">
<li class="- topic/li li" data-ofbid="d139431e43__20250123155213">将以下屏参数写入 panel 驱动源码中:<div class="- topic/note note note note_note" id="display_screen_configuration__note_yzz_q2g_d1c" data-ofbid="display_screen_configuration__note_yzz_q2g_d1c"><span class="note__title">注:</span> <div class="note__body">
<p class="- topic/p p" data-ofbid="d139431e47__20250123155213">对于屏时序参数,只有当 <span class="+ topic/ph sw-d/filepath ph filepath">board.dts</span> 文件的 panel 结点没有设置
display-timings 子节点时,此方式才会生效。</p>
</div></div><ul class="- topic/ul ul" id="display_screen_configuration__ul_jqw_f2g_d1c" data-ofbid="display_screen_configuration__ul_jqw_f2g_d1c">
<li class="- topic/li li" data-ofbid="d139431e55__20250123155213">时序参数<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="display_screen_configuration__codeblock_nhl_hfg_d1c" data-ofbid="display_screen_configuration__codeblock_nhl_hfg_d1c"><code><em class="hl-comment">/* Init the videomode parameter, dts will override the initial value. */</em>
<strong class="hl-keyword">static</strong> <strong class="hl-keyword">struct</strong> videomode panel_vm = {
.pixelclock = <span class="hl-number">130000000</span>,
.hactive = <span class="hl-number">1080</span>,
.hfront_porch = <span class="hl-number">160</span>,
.hback_porch = <span class="hl-number">160</span>,
.hsync_len = <span class="hl-number">40</span>,
.vactive = <span class="hl-number">1920</span>,
.vfront_porch = <span class="hl-number">10</span>,
.vback_porch = <span class="hl-number">20</span>,
.vsync_len = <span class="hl-number">8</span>,
.flags = DISPLAY_FLAGS_HSYNC_LOW | DISPLAY_FLAGS_VSYNC_LOW |
DISPLAY_FLAGS_DE_HIGH | DISPLAY_FLAGS_PIXDATA_POSEDGE
};
</code></pre></li>
<li class="- topic/li li" data-ofbid="d139431e60__20250123155213">屏接口参数<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="display_screen_configuration__codeblock_hbp_hfg_d1c" data-ofbid="display_screen_configuration__codeblock_hbp_hfg_d1c"><code><strong class="hl-keyword">static</strong> <strong class="hl-keyword">int</strong> panel_bind(<strong class="hl-keyword">struct</strong> device *dev, <strong class="hl-keyword">struct</strong> device *master, <strong class="hl-keyword">void</strong> *data)
{
...
dsi-&gt;format = DSI_FMT_RGB888;
dsi-&gt;mode = DSI_MOD_VID_PULSE;
dsi-&gt;lane_num = <span class="hl-number">4</span>;
...
}</code></pre></li>
</ul></li>
</ul>
</div>
<section class="- topic/section section" id="display_screen_configuration__section_rjf_4gk_ndc" data-ofbid="display_screen_configuration__section_rjf_4gk_ndc"><h2 class="- topic/title title sectiontitle">屏配置方式</h2>
<div class="- topic/p p" data-ofbid="d139431e73__20250123155213">
<div class="- topic/div div" id="display_screen_configuration__div_qrj_xhs_2dc">
<p class="- topic/p p" data-ofbid="d139431e77__20250123155213">方式一:将屏参数写入到 <span class="+ topic/ph sw-d/filepath ph filepath">board.dts</span> 文件中。关于 <span class="+ topic/keyword pr-d/parmname keyword parmname">panel_lvds</span>
参数,可查看 <a class="- topic/xref xref" href="display_parameter_panel_lvds.html">Panel_LVDS</a></p>
</div>
<div class="- topic/div div" id="display_screen_configuration__div_qmp_xhs_2dc">
<p class="- topic/p p" data-ofbid="d139431e93__20250123155213">方式二:将屏参数写入 panel 驱动源码中。</p>
<div class="- topic/note note tip note_tip" id="display_screen_configuration__note_xf4_qn3_ddc" data-ofbid="display_screen_configuration__note_xf4_qn3_ddc"><span class="note__title">提示:</span> <div class="note__body">
<p class="- topic/p p" data-ofbid="d139431e98__20250123155213">仅在 <span class="+ topic/ph sw-d/filepath ph filepath">board.dts</span> 文件的 panel 结点不存在
<span class="+ topic/keyword pr-d/parmname keyword parmname">display-timings</span> 子节点,方式二才会生效。</p>
</div></div>
<ul class="- topic/ul ul simple" id="display_screen_configuration__ul_s1f_4gs_2dc" data-ofbid="display_screen_configuration__ul_s1f_4gs_2dc">
<li class="- topic/li li" data-ofbid="d139431e110__20250123155213">
<p class="- topic/p p" data-ofbid="d139431e112__20250123155213">时序参数</p>
<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="display_screen_configuration__codeblock_gcb_rgs_2dc" data-ofbid="display_screen_configuration__codeblock_gcb_rgs_2dc"><code><em class="hl-comment">/* Init the videomode parameter, dts will override the initial value. */</em>
<strong class="hl-keyword">static</strong> <strong class="hl-keyword">struct</strong> videomode panel_vm = {
.pixelclock = <span class="hl-number">130000000</span>,
.hactive = <span class="hl-number">1080</span>,
.hfront_porch = <span class="hl-number">160</span>,
.hback_porch = <span class="hl-number">160</span>,
.hsync_len = <span class="hl-number">40</span>,
.vactive = <span class="hl-number">1920</span>,
.vfront_porch = <span class="hl-number">10</span>,
.vback_porch = <span class="hl-number">20</span>,
.vsync_len = <span class="hl-number">8</span>,
.flags = DISPLAY_FLAGS_HSYNC_LOW | DISPLAY_FLAGS_VSYNC_LOW |
DISPLAY_FLAGS_DE_HIGH | DISPLAY_FLAGS_PIXDATA_POSEDGE
};</code></pre>
</li>
<li class="- topic/li li" data-ofbid="d139431e119__20250123155213">
<p class="- topic/p p" data-ofbid="d139431e121__20250123155213">屏接口参数</p>
<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="display_screen_configuration__codeblock_o1k_rgs_2dc" data-ofbid="display_screen_configuration__codeblock_o1k_rgs_2dc"><code><strong class="hl-keyword">struct</strong> panel_dsi dsi = {
.mode = DSI_MOD_VID_BURST,
.format = DSI_FMT_RGB888,
.lane_num = <span class="hl-number">4</span>,
};</code></pre>
</li>
</ul>
</div>
</div>
</section>
<section class="- topic/section section" id="display_screen_configuration__section_iqw_f2g_d1c" data-ofbid="display_screen_configuration__section_iqw_f2g_d1c"><h2 class="- topic/title title sectiontitle">屏配置步骤</h2>
<p class="- topic/p p" data-ofbid="d139431e137__20250123155213">屏配置需要以下操作:</p>
<ol class="- topic/ol ol" id="display_screen_configuration__ol_oqw_f2g_d1c" data-ofbid="display_screen_configuration__ol_oqw_f2g_d1c">
<li class="- topic/li li" data-ofbid="d139431e142__20250123155213">为 LCD 适配一款 panel 驱动。</li>
<li class="- topic/li li" data-ofbid="d139431e145__20250123155213">确保一条正确的数据通路。</li>
</ol>
<div class="- topic/p p" data-ofbid="d139431e149__20250123155213">具体配置步骤如下:<ol class="- topic/ol ol" id="display_screen_configuration__ol_mwz_v2g_d1c" data-ofbid="display_screen_configuration__ol_mwz_v2g_d1c">
<li class="- topic/li li" data-ofbid="d139431e153__20250123155213">配置 panel 驱动:<ul class="- topic/ul ul" id="display_screen_configuration__ul_osf_csj_ndc" data-ofbid="display_screen_configuration__ul_osf_csj_ndc">
<li class="- topic/li li" data-ofbid="d139431e157__20250123155213">
<p class="- topic/p p" data-ofbid="d139431e159__20250123155213">使能 Luban SDK 提供的 RGB/ LVDS panel 驱动,详见 <a class="- topic/xref xref" href="display_menuconfig.html#display_menuconfig_configuration__li_enable_panel_drivers">Panel
配置</a></p>
</li>
<li class="- topic/li li" data-ofbid="d139431e167__20250123155213">
<p class="- topic/p p" data-ofbid="d139431e169__20250123155213">编写一个 panel 驱动,详情可查看<a xml:lang="zh-CN" lang="zh-CN" class="- topic/xref xref" href="display_driver-intro.html">屏驱动支持</a></p>
</li>
</ul></li>
<li class="- topic/li li" data-ofbid="d139431e178__20250123155213">数据通路<div class="- topic/p p" data-ofbid="d139431e180__20250123155213">LCD
正常显示时,显示模块会形成一条完整的数据通道。<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="display_screen_configuration__codeblock_ahl_hsh_mbc" data-ofbid="display_screen_configuration__codeblock_ahl_hsh_mbc"><code>fb0 --&gt; display engine --&gt; display interface --&gt; panel</code></pre></div><div class="- topic/p p" data-ofbid="d139431e184__20250123155213">数据通道的关系在
<span class="+ topic/ph sw-d/filepath ph filepath">board.dts</span> 中体现,以 LVDS
屏幕为例:<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="display_screen_configuration__codeblock_y3n_lfg_d1c" data-ofbid="display_screen_configuration__codeblock_y3n_lfg_d1c"><code>&amp;fb0 {
port {
fb0_out: endpoint {
remote-endpoint = &lt;&amp;de0_in&gt;;
};
};
};
&amp;de0 {
status = <span class="hl-string">"okay"</span>;
port@<span class="hl-number">0</span> {
reg = &lt;<span class="hl-number">0</span>&gt;;
de0_in: endpoint {
remote-endpoint = &lt;&amp;fb0_out&gt;;
};
};
port@<span class="hl-number">1</span> {
reg = &lt;<span class="hl-number">1</span>&gt;;
de0_out: endpoint {
remote-endpoint = &lt;&amp;lvds0_in&gt;;
};
};
};
&amp;rgb0 {
status = <span class="hl-string">"disabled"</span>;
port@<span class="hl-number">0</span> {
reg = &lt;<span class="hl-number">0</span>&gt;;
rgb0_in: endpoint {
remote-endpoint = &lt;&amp;rgb0_in&gt;;
};
};
port@<span class="hl-number">1</span> {
reg = &lt;<span class="hl-number">1</span>&gt;;
rgb0_out: endpoint {
remote-endpoint = &lt;&amp;panel_rgb_in&gt;;
};
};
};
&amp;lvds0 {
status = <span class="hl-string">"okay"</span>;
port@<span class="hl-number">0</span> {
reg = &lt;<span class="hl-number">0</span>&gt;;
lvds0_in: endpoint {
remote-endpoint = &lt;&amp;de0_out&gt;;
};
};
port@<span class="hl-number">1</span> {
reg = &lt;<span class="hl-number">1</span>&gt;;
lvds0_out: endpoint {
remote-endpoint = &lt;&amp;panel_lvds_in&gt;;
};
};
};
&amp;dsi0 {
status = <span class="hl-string">"disabled"</span>;
port@<span class="hl-number">0</span> {
reg = &lt;<span class="hl-number">0</span>&gt;;
dsi0_in: endpoint {
remote-endpoint = &lt;&amp;dsi0_in&gt;;
};
};
port@<span class="hl-number">1</span> {
reg = &lt;<span class="hl-number">1</span>&gt;;
dsi0_out: endpoint {
remote-endpoint = &lt;&amp;panel_dsi_in&gt;;
};
};
};</code></pre></div><div class="- topic/p p" data-ofbid="d139431e191__20250123155213">在上述例子中,<span class="+ topic/ph sw-d/filepath ph filepath">board.dts</span> 通过 port 和
status
结点,配置了一条数据通道。<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="display_screen_configuration__codeblock_hmw_lsh_mbc" data-ofbid="display_screen_configuration__codeblock_hmw_lsh_mbc"><code>fb | de | | lvds | panel
port --&gt; port0 port1 --&gt; port0 port1 --&gt; port</code></pre></div><p class="- topic/p p" data-ofbid="d139431e198__20250123155213">如果
<span class="+ topic/ph sw-d/filepath ph filepath">board.dts</span> 中没有正确配置一条数据通道,显示驱动无法完成初始化。</p></li>
</ol></div>
</section>
</div>
</article></main></div>
<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/display/display_driver-intro.html">屏驱动支持</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="#display_screen_configuration__section_rjf_4gk_ndc" data-tocid="display_screen_configuration__section_rjf_4gk_ndc">屏配置方式</a></div></li><li class="section-item"><div class="section-title"><a href="#display_screen_configuration__section_iqw_f2g_d1c" data-tocid="display_screen_configuration__section_iqw_f2g_d1c">屏配置步骤</a></div></li></ul></div>
</div>
</nav>
</div>
</div>
</div>
<footer class="navbar navbar-default wh_footer">
<div class=" footer-container mx-auto ">
<title>footer def</title>
<style><!--
.p1 {
font-family: FangZhengShuSong, Times, serif;
}
.p2 {
font-family: Arial, Helvetica, sans-serif;
}
.p3 {
font-family: "Lucida Console", "Courier New", monospace;
}
--></style>
<div class="webhelp.fragment.footer">
<p class="p1">Copyright © 2019-2024 广东匠芯创科技有限公司. All rights reserved.</p>
</div><div>
<div class="generation_time">
Update Time: 2025-01-23
</div>
</div>
</div>
</footer>
<button id="go2top" class="d-print-none" title="返回顶部">
<span class="oxy-icon oxy-icon-up"></span>
</button>
<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>