Files
luban-lite/doc/topics/sdk/peripheral/wifi_rtl8189.html
刘可亮 6e36e8e296 v1.2.0
2025-04-23 17:54:31 +08:00

252 lines
24 KiB
HTML
Executable File
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<!DOCTYPE html><html xmlns="http://www.w3.org/1999/xhtml" xml:lang="zh-cn" lang="zh-cn" data-whc_version="26.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="本章节讲解如何在 Luban-Lite 系统中配置 SDIO 接口的 RTL8189 无线网络模块。 配置 SDMC 接口和 WiFi 模组 使用 SDMC 接口前,选中对应的 SDMC 接口,以 D133CBV-QFN88 开发板为例,使用 scons--meunconfig 命令,配置下列内容: Board options [ * ] Using SDMC0 # 硬件连接哪个 SDMC ..."/><meta name="DC.rights.owner" content="(C) 版权 2025"/><meta name="copyright" content="(C) 版权 2025"/><meta name="generator" content="DITA-OT"/><meta name="DC.type" content="topic"/><meta name="DC.relation" content="../../../topics/sdk/peripheral/wifi.html"/><meta name="DC.relation" content="../../../topics/sdk/peripheral/wifi.html"/><meta name="DC.relation" content="../../../topics/sdk/peripheral/wifi_aic8800.html"/><meta name="DC.contributor" content="yan.wang"/><meta name="DC.creator" content="yan.wang"/><meta name="DC.date.modified" content="2025-04-09"/><meta name="DC.format" content="HTML5"/><meta name="DC.identifier" content="wifi-rtl8189"/><title>RTL8189 调试指南</title><meta name="wh-path2root" content="../../../"/><meta name="wh-toc-id" content="wifi-rtl8189-d3703e1986"/><meta name="wh-source-relpath" content="topics/sdk/peripheral/wifi_rtl8189.dita"/><meta name="wh-out-relpath" content="topics/sdk/peripheral/wifi_rtl8189.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=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>
<body id="wifi-rtl8189" 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/peripheral/peripheral-intro.html">外设移植</a><div class="wh-tooltip"><p class="shortdesc"><span class="ph">CTP、U 盘、SD 卡、有线和无线网络</span>等外设的介绍和使用说明。</p></div></div></div></li><li><div class="topicref" data-id="id"><div class="title"><a href="../../../topics/sdk/peripheral/wifi.html">无线网络</a></div></div></li><li class="active"><div class="topicref" data-id="wifi-rtl8189"><div class="title"><a href="../../../topics/sdk/peripheral/wifi_rtl8189.html">RTL8189 调试指南</a></div></div></li></ol></div>
<div class="wh_right_tools">
<button class="wh_hide_highlight" aria-label="切换搜索突出显示" title="切换搜索突出显示"></button>
<button class="webhelp_expand_collapse_sections" data-next-state="collapsed" aria-label="折叠截面" title="折叠截面"></button>
<div class=" wh_navigation_links "><span id="topic_navigation_links" class="navheader">
<span class="navprev"><a class="- topic/link link" href="../../../topics/sdk/peripheral/wifi.html" title="无线网络" aria-label="上一主题: 无线网络" rel="prev"></a></span>
<span class="navnext"><a class="- topic/link link" href="../../../topics/sdk/peripheral/wifi_aic8800.html" title="AIC8800 调试指南" aria-label="下一主题: AIC8800 调试指南" 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-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 在不同应用场景中的配置和使用包括系统更新、OTA、安全方案等。</p></div></div></div></li><li role="treeitem" aria-expanded="true"><div data-tocid="id-d3703e1841" class="topicref" data-id="id" data-state="expanded"><span role="button" tabindex="0" aria-labelledby="button-collapse-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><ul role="group" class="navbar-nav nav-list"><li role="treeitem"><div data-tocid="id-d3703e1860" class="topicref" data-id="id" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/peripheral/keyadc.html" id="id-d3703e1860-link">按键矩阵</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="id-d3703e1874" class="topicref" data-id="id" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action id-d3703e1874-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/peripheral/touch.html" id="id-d3703e1874-link">CTP 移植指南</a></div></div></li><li role="treeitem" aria-expanded="true"><div data-tocid="id-d3703e1972" class="topicref" data-id="id" data-state="expanded"><span role="button" tabindex="0" aria-labelledby="button-collapse-action id-d3703e1972-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/peripheral/wifi.html" id="id-d3703e1972-link">无线网络</a></div></div><ul role="group" class="navbar-nav nav-list"><li role="treeitem" class="active"><div data-tocid="wifi-rtl8189-d3703e1986" class="topicref" data-id="wifi-rtl8189" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/peripheral/wifi_rtl8189.html" id="wifi-rtl8189-d3703e1986-link">RTL8189 调试指南</a></div></div></li><li role="treeitem"><div data-tocid="wifi-aic8800-d3703e2000" class="topicref" data-id="wifi-aic8800" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/peripheral/wifi_aic8800.html" id="wifi-aic8800-d3703e2000-link">AIC8800 调试指南</a></div></div></li></ul></li></ul></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="false"><div data-tocid="id-d3703e2355" class="topicref" data-id="id" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-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></li></ul></div>
</div>
</nav>
<div class="col-lg-7 col-md-9 col-sm-12" id="wh_topic_body">
<button id="wh_close_publication_toc_button" class="close-toc-button d-none" aria-label="Toggle publishing table of content" aria-controls="wh_publication_toc" aria-expanded="true">
<span class="close-toc-icon-container">
<span class="close-toc-icon"></span>
</span>
</button>
<button id="wh_close_topic_toc_button" class="close-toc-button d-none" aria-label="Toggle topic table of content" aria-controls="wh_topic_toc" aria-expanded="true">
<span class="close-toc-icon-container">
<span class="close-toc-icon"></span>
</span>
</button>
<div class=" wh_topic_content body "><main role="main"><article class="- topic/topic topic" role="article" aria-labelledby="ariaid-title1">
<span class="edit-link" style="font-size:12px; opacity:0.6; text-align:right; vertical-align:middle"><a target="_blank" href="http://aicdocco/taskstopics/sdk/peripheral/wifi_rtl8189.dita">Edit online</a></span><h1 class="- topic/title title topictitle1" id="ariaid-title1">RTL8189 调试指南</h1>
<div class="date inPage">9 Apr 2025</div><div style="color: gray;">
Read time: 3 minute(s)
</div>
<div class="- topic/body body">
<p class="- topic/p p" data-ofbid="d211991e28__20250409171055">本章节讲解如何在 <span class="- topic/ph ph">Luban-Lite</span> 系统中配置 SDIO 接口的 RTL8189 无线网络模块。</p>
<section class="- topic/section section" id="wifi-rtl8189__section_csm_vbg_1dc" data-ofbid="wifi-rtl8189__section_csm_vbg_1dc"><h2 class="- topic/title title sectiontitle">配置 SDMC 接口和 WiFi 模组</h2>
<p class="- topic/p p" data-ofbid="d211991e39__20250409171055">使用 SDMC 接口前,选中对应的 SDMC 接口,以
D133CBV-QFN88
开发板为例,使用 <code class="+ topic/ph pr-d/codeph ph codeph">scons--meunconfig</code>
命令,配置下列内容:</p>
<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="wifi-rtl8189__pre_jgx_gxv_wcc" data-ofbid="wifi-rtl8189__pre_jgx_gxv_wcc">Board options
[ * ] Using SDMC0 # 硬件连接哪个 SDMC 接口,选择哪个 SDMC
-*- Enable the interrupt of SDMC
SDMC1 Parameter ---&gt;
Select SDMC1 BUSWIDTH (sdmc <span class="hl-number">4</span>-bit mode) ---&gt;
[ ] Using SDcard hotplug detection (NEW)
[*] SDMC1 connect to a SDIO device
(<span class="hl-number">3</span>) SDMC1 driver phase (NEW)
(<span class="hl-number">0</span>) SDMC1 sample phase (NEW)
(<span class="hl-number">100000000</span>) SDMC1 CMU clock frequency (NEW)
[ * ] Using Wireless lan ---&gt;
[ * ] Using Realtek wlan driver ---&gt;
Select Realtek wlan0 modul (rtl8189)--- &gt; # 以 RTL8189 为例
Realtek wlan0 paramete ---&gt;
(PD.<span class="hl-number">7</span>) realtek wlan0 power on gpio
(<span class="hl-number">192.168</span>.<span class="hl-number">3.20</span>) wlan0 ip addr
(<span class="hl-number">192.168</span>.<span class="hl-number">3.1</span>) wlan0 gateway addr
(<span class="hl-number">255.255</span>.<span class="hl-number">255.0</span>) wlan0 netmask
[*] Enable Realtek driver debug information</pre>
</section>
<section class="- topic/section section" id="wifi-rtl8189__section_dsm_vbg_1dc" data-ofbid="wifi-rtl8189__section_dsm_vbg_1dc"><h2 class="- topic/title title sectiontitle">配置 lwIP</h2>
<p class="- topic/p p" data-ofbid="d211991e65__20250409171055">使用 <span class="+ topic/keyword sw-d/cmdname keyword cmdname">scons --menuconfig</span> 命令进入配置页面,配置如下:</p>
<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="wifi-rtl8189__pre_kgx_gxv_wcc" data-ofbid="wifi-rtl8189__pre_kgx_gxv_wcc">Local packages options ---&gt;
Third-party packages options ---&gt;
LwIP: light weight TCP/IP stack
[*] LwIP Examples ---&gt;
[*] Using net tools
[*] Enble DNS <strong class="hl-keyword">for</strong> name resolution
[*] Enable alloc ip address through DHCP
[*] Enable ping features ---&gt;</pre>
</section>
<section class="- topic/section section" id="wifi-rtl8189__section_esm_vbg_1dc" data-ofbid="wifi-rtl8189__section_esm_vbg_1dc"><h2 class="- topic/title title sectiontitle">配置内核</h2>
<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="wifi-rtl8189__pre_lgx_gxv_wcc" data-ofbid="wifi-rtl8189__pre_lgx_gxv_wcc">Rt-Thread options ---&gt;
RT-Thread Kernel ---&gt;
(<span class="hl-number">4</span>) The priority level value of timer thread
(<span class="hl-number">4096</span>) The stack size of timer thread
RT-Thread Components ---&gt;
Device Drivers ---&gt;
(<span class="hl-number">4096</span>) The stack size <strong class="hl-keyword">for</strong> sdio irq thread
(<span class="hl-number">5</span>) The priority level value of sdio irq thread</pre>
<div class="- topic/note note warning note_warning" id="wifi-rtl8189__note_mvw_bkk_52c" data-ofbid="wifi-rtl8189__note_mvw_bkk_52c"><span class="note__title">警告:</span> 完成内核配置后,如出现类似 <samp class="+ topic/ph sw-d/systemoutput ph systemoutput sysout">d13x_os.itb
file_size: 0x216800 is over much than part_size: 0x200000</samp> 的结果,则调整
OS 分区并使用 <span class="+ topic/keyword sw-d/cmdname keyword cmdname">mb</span> 命令重新编译 BootLoader 和 RTT。</div>
</section>
<section class="- topic/section section" id="wifi-rtl8189__section_fsm_vbg_1dc" data-ofbid="wifi-rtl8189__section_fsm_vbg_1dc"><h2 class="- topic/title title sectiontitle">测试命令</h2>
<p class="- topic/p p" data-ofbid="d211991e98__20250409171055"> 完成所有配置后,保存退出,编译、烧录。待系统启动后,可执行如下命令进行验证:</p>
<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="wifi-rtl8189__pre_ngx_gxv_wcc" data-ofbid="wifi-rtl8189__pre_ngx_gxv_wcc">wlan wifi_scan
wlan wifi_connect SSID PASSWORD <em class="hl-comment">// 连接 wifi</em>
dhcpc WL0 start <em class="hl-comment">// 获取 IP</em>
ifconfig <em class="hl-comment">// 查看当前网卡 IP 及网关 IP</em>
ping <span class="hl-number">192.168</span>.<span class="hl-number">1.1</span> <em class="hl-comment">// 假设网关 IP 为 192.168.1.1ping 一下试试看通路</em></pre>
</section>
</div>
</article></main></div>
</div>
<nav role="navigation" id="wh_topic_toc" aria-label="On this page" class="col-lg-2 d-none d-lg-block navbar d-print-none">
<div id="wh_topic_toc_content">
<div class=" wh_topic_toc "><div class="wh_topic_label">在本页上</div><ul><li class="section-item"><div class="section-title"><a href="#wifi-rtl8189__section_csm_vbg_1dc" data-tocid="wifi-rtl8189__section_csm_vbg_1dc">配置 SDMC 接口和 WiFi 模组</a></div></li><li class="section-item"><div class="section-title"><a href="#wifi-rtl8189__section_dsm_vbg_1dc" data-tocid="wifi-rtl8189__section_dsm_vbg_1dc">配置 lwIP</a></div></li><li class="section-item"><div class="section-title"><a href="#wifi-rtl8189__section_esm_vbg_1dc" data-tocid="wifi-rtl8189__section_esm_vbg_1dc">配置内核</a></div></li><li class="section-item"><div class="section-title"><a href="#wifi-rtl8189__section_fsm_vbg_1dc" data-tocid="wifi-rtl8189__section_fsm_vbg_1dc">测试命令</a></div></li></ul></div>
</div>
</nav>
</div>
</div>
</div>
<footer class="navbar navbar-default wh_footer">
<div class=" footer-container mx-auto ">
<title>footer def</title>
<style>
.p1 {
font-family: FangZhengShuSong, Times, serif;
}
.p2 {
font-family: Arial, Helvetica, sans-serif;
}
.p3 {
font-family: "Lucida Console", "Courier New", monospace;
}
</style>
<div class="webhelp.fragment.footer">
<p class="p1">Copyright © 2019-2025 广东匠芯创科技有限公司. All rights reserved.</p>
</div>
<div>
<div class="generation_time">
Update Time: 2025-04-09
</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>