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

393 lines
46 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="如何添加新的 SPI NAND 设备 驱动层次关系 SPI NAND 属于 SPI 的从设备,在内核中相关驱动通过 SPI MEM 对接到 SPI 子系统,如 内核 SPI 框图 所示。 在 SPI 控制器初始化时SPI 驱动会检查该控制器下是否有挂载的 SPI NAND有则添加到 SPI BUS 中。 aic_spi_probe(dev); |-&gt; ..."/><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/spi/spi_user_guide.html"/><meta name="DC.relation" content="../../../topics/sdk/spi/spi_interface.html"/><meta name="DC.relation" content="../../../topics/sdk/psadc/psadc_user_guide.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="spi_common_issues"/><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="spi_common_issues-d4445e7060"/><meta name="wh-source-relpath" content="topics/sdk/spi/spi_faq.dita"/><meta name="wh-out-relpath" content="topics/sdk/spi/spi_faq.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="spi_common_issues" 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_nww_hzh_pzb"><div class="title"><a href="../../../topics/chapter-title/chapter-interface-sdk.html">接口</a><div class="wh-tooltip"><p class="shortdesc">CAN、CIR、GPAI、GPIO、I2C、PSADC、PWM 等接口模块的介绍和使用说明。</p></div></div></div></li><li><div class="topicref" data-id="spi"><div class="title"><a href="../../../topics/sdk/spi/spi_user_guide.html">SPI 使用指南</a></div></div></li><li class="active"><div class="topicref" data-id="spi_common_issues"><div class="title"><a href="../../../topics/sdk/spi/spi_faq.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/spi/spi_interface.html" title="接口设计" aria-label="上一主题: 接口设计" rel="prev"></a></span>
<span class="navnext"><a class="- topic/link link" href="../../../topics/sdk/psadc/psadc_user_guide.html" title="PSADC 使用指南" aria-label="下一主题: PSADC 使用指南" 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="false"><div data-tocid="concept_mcc_32s_nbc-d4445e4438" class="topicref" data-id="concept_mcc_32s_nbc" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-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></li><li role="treeitem" aria-expanded="true"><div data-tocid="concept_nww_hzh_pzb-d4445e5947" class="topicref" data-id="concept_nww_hzh_pzb" data-state="expanded"><span role="button" tabindex="0" aria-labelledby="button-collapse-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><ul role="group" class="navbar-nav nav-list"><li role="treeitem" aria-expanded="false"><div data-tocid="can-d4445e5964" class="topicref" data-id="can" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action can-d4445e5964-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/can/can_user_guide.html" id="can-d4445e5964-link">CAN 使用指南</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="cir-d4445e6020" class="topicref" data-id="cir" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action cir-d4445e6020-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/cir/cir_user_guide.html" id="cir-d4445e6020-link">CIR 使用指南</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="gpai-user-guide-d4445e6146" class="topicref" data-id="gpai-user-guide" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action gpai-user-guide-d4445e6146-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/gpai/gpai_user_guide.html" id="gpai-user-guide-d4445e6146-link">GPAI 使用指南</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="i2c_user_guide-d4445e6288" class="topicref" data-id="i2c_user_guide" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action i2c_user_guide-d4445e6288-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/i2c/i2c_user_guide.html" id="i2c_user_guide-d4445e6288-link">I2C 使用指南</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="id-d4445e6400" class="topicref" data-id="id" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action id-d4445e6400-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/mac/mac_user_guide.html" id="id-d4445e6400-link">MAC 使用指南</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="pbus_user_guide-d4445e6514" class="topicref" data-id="pbus_user_guide" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action pbus_user_guide-d4445e6514-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/pbus/pbus-user-guide.html" id="pbus_user_guide-d4445e6514-link">PBUS 使用指南</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="pinctrl_user_guide-d4445e6598" class="topicref" data-id="pinctrl_user_guide" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action pinctrl_user_guide-d4445e6598-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/pinctrl/pinctrl-user-guide.html" id="pinctrl_user_guide-d4445e6598-link">PINCTRL 使用指南</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="id-d4445e6738" class="topicref" data-id="id" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action id-d4445e6738-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/pwm/pwm_user_guide.html" id="id-d4445e6738-link">PWM 使用指南</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="rtp-user-guide-d4445e6822" class="topicref" data-id="rtp-user-guide" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action rtp-user-guide-d4445e6822-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/rtp/rtp_user_guide.html" id="rtp-user-guide-d4445e6822-link">RTP 使用指南</a></div></div></li><li role="treeitem" aria-expanded="true"><div data-tocid="spi-d4445e6962" class="topicref" data-id="spi" data-state="expanded"><span role="button" tabindex="0" aria-labelledby="button-collapse-action spi-d4445e6962-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/spi/spi_user_guide.html" id="spi-d4445e6962-link">SPI 使用指南</a></div></div><ul role="group" class="navbar-nav nav-list"><li role="treeitem"><div data-tocid="spi_configuration-d4445e6976" class="topicref" data-id="spi_configuration" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/spi/spi_config.html" id="spi_configuration-d4445e6976-link">SPI 配置</a></div></div></li><li role="treeitem"><div data-tocid="spi_debug_guide-d4445e6990" class="topicref" data-id="spi_debug_guide" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/spi/spi_debug.html" id="spi_debug_guide-d4445e6990-link">调试指南</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="spi_design_intro-d4445e7004" class="topicref" data-id="spi_design_intro" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action spi_design_intro-d4445e7004-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/spi/spi_design.html" id="spi_design_intro-d4445e7004-link">设计说明</a></div></div></li><li role="treeitem" class="active"><div data-tocid="spi_common_issues-d4445e7060" class="topicref" data-id="spi_common_issues" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/spi/spi_faq.html" id="spi_common_issues-d4445e7060-link">常见问题</a></div></div></li></ul></li><li role="treeitem" aria-expanded="false"><div data-tocid="id-d4445e7075" class="topicref" data-id="id" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action id-d4445e7075-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/psadc/psadc_user_guide.html" id="id-d4445e7075-link">PSADC 使用指南</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="uart_user_guide-d4445e7215" class="topicref" data-id="uart_user_guide" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action uart_user_guide-d4445e7215-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/uart/uart_user_guide.html" id="uart_user_guide-d4445e7215-link">UART 使用指南</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="usb_user_guide-d4445e7299" class="topicref" data-id="usb_user_guide" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action usb_user_guide-d4445e7299-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/usb/usb_user_guide.html" id="usb_user_guide-d4445e7299-link">USB 使用指南</a></div></div></li></ul></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/spi/spi_faq.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: 5 minute(s)
</div>
<div class="- topic/body concept/conbody body conbody">
<section class="- topic/section section" id="spi_common_issues__section_xzs_2xy_21c" data-ofbid="spi_common_issues__section_xzs_2xy_21c"><h2 class="- topic/title title sectiontitle">如何添加新的 SPI NAND 设备</h2>
<div class="- topic/p p" data-ofbid="d111929e38__20250123155209">
<ol class="- topic/ol ol" id="spi_common_issues__ol_n2g_gxy_21c" data-ofbid="spi_common_issues__ol_n2g_gxy_21c">
<li class="- topic/li li" data-ofbid="d111929e42__20250123155209">驱动层次关系<div class="- topic/p p" data-ofbid="d111929e44__20250123155209">SPI NAND 属于 SPI 的从设备,在内核中相关驱动通过 <code class="+ topic/ph pr-d/codeph ph codeph">SPI MEM</code> 对接到 SPI
子系统,如<a xml:lang="zh-CN" lang="zh-CN" class="- topic/xref xref" href="spi_design.html#spi_design_intro__fig_flw_rwy_21c">内核 SPI 框图</a>所示。 在 SPI
控制器初始化时SPI 驱动会检查该控制器下是否有挂载的 SPI NAND有则添加到 SPI BUS
中。<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="spi_common_issues__codeblock_c4x_kxy_21c" data-ofbid="spi_common_issues__codeblock_c4x_kxy_21c"><code>aic_spi_probe(dev);
|-&gt; spi_register_controller(ctlr);/spi_register_master(ctlr);
| <em class="hl-comment">// spi_register_master 是一个宏</em>
|
|-&gt; of_register_spi_devices(ctlr);
|-&gt; spi = of_register_spi_device(ctlr, nc);
|-&gt; spi = spi_alloc_device(ctlr);
|-&gt; of_spi_parse_dt(ctlr, spi, nc);
|-&gt; rc = spi_add_device(spi);
<em class="hl-comment">// 将 SPI device 添加到 SPI 总线 spi_bus_type 中</em></code></pre></div><p class="- topic/p p" data-ofbid="d111929e55__20250123155209">在调用
<code class="+ topic/ph pr-d/codeph ph codeph">spi_add_device</code> 的过程中,会查找和匹配对应设备的驱动程序(如果这时候对
应的驱动程序还没有被添加到系统中,则在这里先将设备添加到 Bus等到对应驱动程序 被添加进来时,再进行匹配。)</p><div class="table-container"><table class="- topic/table table frame-all" id="spi_common_issues__table_zzs_2xy_21c" data-ofbid="spi_common_issues__table_zzs_2xy_21c" data-cols="2"><caption></caption><colgroup><col style="width:28.49002849002849%"/><col style="width:71.5099715099715%"/></colgroup><thead class="- topic/thead thead">
<tr class="- topic/row">
<th class="- topic/entry entry colsep-1 rowsep-1" id="spi_common_issues__table_zzs_2xy_21c__entry__1">模块</th>
<th class="- topic/entry entry colsep-0 rowsep-1" id="spi_common_issues__table_zzs_2xy_21c__entry__2">驱动源码路径</th>
</tr>
</thead><tbody class="- topic/tbody tbody">
<tr class="- topic/row">
<td class="- topic/entry entry colsep-1 rowsep-0" headers="spi_common_issues__table_zzs_2xy_21c__entry__1">SPI NAND</td>
<td class="- topic/entry entry colsep-0 rowsep-0" headers="spi_common_issues__table_zzs_2xy_21c__entry__2"><span class="+ topic/ph sw-d/filepath ph filepath">source/linux-5.10/drivers/mtd/nand/spi/</span></td>
</tr>
</tbody></table></div></li>
<li class="- topic/li li" data-ofbid="d111929e95__20250123155209">检查和添加新设备<div class="- topic/p p" data-ofbid="d111929e97__20250123155209">内核中所支持的 SPI NAND 设备通过两级列表进行设置。<ol class="- topic/ol ol" type="a" id="spi_common_issues__ul_n34_mxy_21c" data-ofbid="spi_common_issues__ul_n34_mxy_21c">
<li class="- topic/li li" data-ofbid="d111929e101__20250123155209">检查
<code class="+ topic/ph pr-d/codeph ph codeph">source/linux-5.10/drivers/mtd/nand/spi/core.c</code>
中的 <code class="+ topic/ph pr-d/codeph ph codeph">spinand_manufacturers</code>,
查看新设备的厂商是否在列表之中:<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="spi_common_issues__codeblock_wsd_nxy_21c" data-ofbid="spi_common_issues__codeblock_wsd_nxy_21c"><code><strong class="hl-keyword">static</strong> <strong class="hl-keyword">const</strong> <strong class="hl-keyword">struct</strong> spinand_manufacturer *spinand_manufacturers[] = {
&amp;gigadevice_spinand_manufacturer,
&amp;macronix_spinand_manufacturer,
&amp;micron_spinand_manufacturer,
&amp;paragon_spinand_manufacturer,
&amp;toshiba_spinand_manufacturer,
&amp;winbond_spinand_manufacturer,
};</code></pre></li>
<li class="- topic/li li" data-ofbid="d111929e112__20250123155209">检查具体的设备厂商文件,具体的型号是否在列表之中( 以 gigadevice
为例):<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="spi_common_issues__codeblock_azy_nxy_21c" data-ofbid="spi_common_issues__codeblock_azy_nxy_21c"><code><strong class="hl-keyword">static</strong> <strong class="hl-keyword">const</strong> <strong class="hl-keyword">struct</strong> spinand_info gigadevice_spinand_table[] = {
SPINAND_INFO(<span class="hl-string">"GD5F1GQ4UExxG"</span>,
SPINAND_ID(SPINAND_READID_METHOD_OPCODE_ADDR, <span class="hl-number">0xd1</span>),
NAND_MEMORG(<span class="hl-number">1</span>, <span class="hl-number">2048</span>, <span class="hl-number">128</span>, <span class="hl-number">64</span>, <span class="hl-number">1024</span>, <span class="hl-number">20</span>, <span class="hl-number">1</span>, <span class="hl-number">1</span>, <span class="hl-number">1</span>),
NAND_ECCREQ(<span class="hl-number">8</span>, <span class="hl-number">512</span>),
SPINAND_INFO_OP_VARIANTS(&amp;read_cache_variants,
&amp;write_cache_variants,
&amp;update_cache_variants),
SPINAND_HAS_QE_BIT,
SPINAND_ECCINFO(&amp;gd5fxgq4_variant2_ooblayout,
gd5fxgq4uexxg_ecc_get_status)),
......
};</code></pre><p class="- topic/p p" data-ofbid="d111929e116__20250123155209">此处检查,需要查找新设备的 Datasheet找到该设备的 Device ID可在
Datasheet 中直接搜索 “Device ID”。 并查看该 Device ID 是否出现在列表中。例如此处
<code class="+ topic/ph pr-d/codeph ph codeph">SPINAND_ID(SPINAND_READID_METHOD_OPCODE_ADDR,
0xd1),</code> 的最后一个数值 <code class="+ topic/ph pr-d/codeph ph codeph">0xd1</code> 就是 一个
Device ID 值。</p><p class="- topic/p p" data-ofbid="d111929e124__20250123155209">如果不存在,则参考上述例子,添加一个新的设备记录。</p></li>
</ol></div></li>
<li class="- topic/li li" data-ofbid="d111929e128__20250123155209">修改 DTS<div class="- topic/p p" data-ofbid="d111929e130__20250123155209">
<ol class="- topic/ol ol" type="a" id="spi_common_issues__ol_qfl_qxy_21c" data-ofbid="spi_common_issues__ol_qfl_qxy_21c">
<li class="- topic/li li" data-ofbid="d111929e134__20250123155209">在实际项目中使用 SPI NAND 设备,还需要修改 DTS 配置。<div class="- topic/p p" data-ofbid="d111929e136__20250123155209"><span class="+ topic/ph sw-d/filepath ph filepath">board.dts</span>
应在具体的 SPI 控制器下添加 <code class="+ topic/ph pr-d/codeph ph codeph">spi-nand</code>
设备。<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="spi_common_issues__pre_e1t_2xy_21c" data-ofbid="spi_common_issues__pre_e1t_2xy_21c"><code>&amp;spi1 {
pinctrl-names = <span class="hl-string">"default"</span>;
pinctrl-<span class="hl-number">0</span> = &lt;&amp;spi1_pins_a&gt;;
status = <span class="hl-string">"okay"</span>;
spi-max-frequency = &lt;<span class="hl-number">100000000</span>&gt;;
spi-flash@<span class="hl-number">0</span> {
#address-cells = &lt;<span class="hl-number">1</span>&gt;;
#size-cells = &lt;<span class="hl-number">1</span>&gt;;
compatible = <span class="hl-string">"spi-nand"</span>;
spi-max-frequency = &lt;<span class="hl-number">100000000</span>&gt;;
spi-tx-bus-width = &lt;<span class="hl-number">4</span>&gt;;
spi-rx-bus-width = &lt;<span class="hl-number">4</span>&gt;;
reg = &lt;<span class="hl-number">0</span>&gt;;
status = <span class="hl-string">"okay"</span>;
};
};
</code></pre></div></li>
<li class="- topic/li li" data-ofbid="d111929e146__20250123155209"><span class="+ topic/ph sw-d/filepath ph filepath">board-u-boot.dtsi</span> 文件中,将该设备标记为
<code class="+ topic/ph pr-d/codeph ph codeph">u-boot,dm-pre-reloc</code> ,不然 SPL
无法识别和使用。<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="spi_common_issues__pre_f1t_2xy_21c" data-ofbid="spi_common_issues__pre_f1t_2xy_21c"><code>&amp;spi1 {
u-boot,dm-pre-reloc;
spi-flash@<span class="hl-number">0</span> {
u-boot,dm-pre-reloc;
};
};
</code></pre></li>
</ol>
</div></li>
</ol>
</div>
</section>
<section class="- topic/section section" id="spi_common_issues__section_kz4_sxy_21c" data-ofbid="spi_common_issues__section_kz4_sxy_21c"><h2 class="- topic/title title sectiontitle">如何添加新的 SPI NOR 设备</h2>
<div class="- topic/p p" data-ofbid="d111929e167__20250123155209">
<ol class="- topic/ol ol" id="spi_common_issues__ol_qv1_txy_21c" data-ofbid="spi_common_issues__ol_qv1_txy_21c">
<li class="- topic/li li" data-ofbid="d111929e171__20250123155209">驱动层次关系<div class="- topic/p p" data-ofbid="d111929e173__20250123155209">SPI NOR 属于 SPI 的从设备,在内核中相关驱动通过 <code class="+ topic/ph pr-d/codeph ph codeph">SPI MEM</code> 对接到 SPI
子系统,如 <a xml:lang="zh-CN" lang="zh-CN" class="- topic/xref xref" href="spi_design.html#spi_design_intro__fig_flw_rwy_21c">内核 SPI 框图</a> 所示。
在 SPI 控制器初始化时SPI 驱动会检查该控制器下是否有挂载的 SPI NOR有则添加到 SPI BUS
中。<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="spi_common_issues__codeblock_zzl_xxy_21c" data-ofbid="spi_common_issues__codeblock_zzl_xxy_21c"><code>aic_spi_probe(dev);
|-&gt; spi_register_controller(ctlr);/spi_register_master(ctlr);
| <em class="hl-comment">// spi_register_master 是一个宏</em>
|
|-&gt; of_register_spi_devices(ctlr);
|-&gt; spi = of_register_spi_device(ctlr, nc);
|-&gt; spi = spi_alloc_device(ctlr);
|-&gt; of_spi_parse_dt(ctlr, spi, nc);
|-&gt; rc = spi_add_device(spi);
<em class="hl-comment">// 将 SPI device 添加到 SPI 总线 spi_bus_type 中</em></code></pre></div><p class="- topic/p p" data-ofbid="d111929e184__20250123155209">在调用
<code class="+ topic/ph pr-d/codeph ph codeph">spi_add_device</code> 的过程中,会查找和匹配对应设备的驱动程序(如果这时候对
应的驱动程序还没有被添加到系统中,则在这里先将设备添加到 Bus等到对应驱动程序 被添加进来时,再进行匹配。)</p><div class="table-container"><table class="- topic/table table frame-all" id="spi_common_issues__table_zk5_xxy_21c" data-ofbid="spi_common_issues__table_zk5_xxy_21c" data-cols="2"><caption></caption><colgroup><col style="width:26.595744680851062%"/><col style="width:73.40425531914893%"/></colgroup><thead class="- topic/thead thead">
<tr class="- topic/row">
<th class="- topic/entry entry colsep-1 rowsep-1" id="spi_common_issues__table_zk5_xxy_21c__entry__1">模块</th>
<th class="- topic/entry entry colsep-0 rowsep-1" id="spi_common_issues__table_zk5_xxy_21c__entry__2">驱动源码路径</th>
</tr>
</thead><tbody class="- topic/tbody tbody">
<tr class="- topic/row">
<td class="- topic/entry entry colsep-1 rowsep-0" headers="spi_common_issues__table_zk5_xxy_21c__entry__1">SPI NOR</td>
<td class="- topic/entry entry colsep-0 rowsep-0" headers="spi_common_issues__table_zk5_xxy_21c__entry__2"><span class="+ topic/ph sw-d/filepath ph filepath">source/linux-5.10/drivers/mtd/spi-nor/</span></td>
</tr>
</tbody></table></div></li>
<li class="- topic/li li" data-ofbid="d111929e224__20250123155209">检查和添加新设备<p class="- topic/p p" data-ofbid="d111929e226__20250123155209">内核中所支持的 SPI NOR 设备通过两级列表进行设置。</p><ol class="- topic/ol ol" type="a" id="spi_common_issues__ol_zzj_1yy_21c" data-ofbid="spi_common_issues__ol_zzj_1yy_21c">
<li class="- topic/li li" data-ofbid="d111929e230__20250123155209">
<div class="- topic/p p" data-ofbid="d111929e232__20250123155209">检查 <code class="+ topic/ph pr-d/codeph ph codeph">source/linux-5.10/drivers/mtd/spi-nor/core.c</code>
中的 <code class="+ topic/ph pr-d/codeph ph codeph">manufacturers</code>,
查看新设备的厂商是否在列表之中:<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="spi_common_issues__codeblock_c1h_byy_21c" data-ofbid="spi_common_issues__codeblock_c1h_byy_21c"><code><strong class="hl-keyword">static</strong> <strong class="hl-keyword">const</strong> <strong class="hl-keyword">struct</strong> spi_nor_manufacturer *manufacturers[] = {
&amp;spi_nor_atmel,
&amp;spi_nor_catalyst,
&amp;spi_nor_eon,
&amp;spi_nor_esmt,
&amp;spi_nor_everspin,
&amp;spi_nor_fujitsu,
&amp;spi_nor_gigadevice,
&amp;spi_nor_intel,
&amp;spi_nor_issi,
&amp;spi_nor_macronix,
&amp;spi_nor_micron,
&amp;spi_nor_st,
&amp;spi_nor_spansion,
&amp;spi_nor_sst,
&amp;spi_nor_winbond,
&amp;spi_nor_xilinx,
&amp;spi_nor_xmc,
&amp;spi_nor_boya,
};</code></pre></div>
</li>
<li class="- topic/li li" data-ofbid="d111929e244__20250123155209">检查具体的设备厂商文件,具体的型号是否在列表之中( 以 gigadevice
为例):<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="spi_common_issues__codeblock_bry_byy_21c" data-ofbid="spi_common_issues__codeblock_bry_byy_21c"><code><strong class="hl-keyword">static</strong> <strong class="hl-keyword">const</strong> <strong class="hl-keyword">struct</strong> flash_info gigadevice_parts[] = {
......
{ <span class="hl-string">"gd25q256"</span>, INFO(<span class="hl-number">0xc84019</span>, <span class="hl-number">0</span>, <span class="hl-number">64</span> * <span class="hl-number">1024</span>, <span class="hl-number">512</span>,
SECT_<span class="hl-number">4</span>K | SPI_NOR_DUAL_READ | SPI_NOR_QUAD_READ |
SPI_NOR_<span class="hl-number">4</span>B_OPCODES | SPI_NOR_HAS_LOCK |
SPI_NOR_HAS_TB | SPI_NOR_TB_SR_BIT6)
.fixups = &amp;gd25q256_fixups },
......
};</code></pre><p class="- topic/p p" data-ofbid="d111929e248__20250123155209">此处检查,需要查找新设备的 Datasheet找到该设备的 Manufacture 和
Device ID并查看该 ID 是否出现在列表中。 例如此处为 <code class="+ topic/ph pr-d/codeph ph codeph">0xc84019</code> ,其中
Manufacture ID = <code class="+ topic/ph pr-d/codeph ph codeph">0xc8</code>, Device ID ID[15~8] =
<code class="+ topic/ph pr-d/codeph ph codeph">0x40</code>, ID[7~0] = <code class="+ topic/ph pr-d/codeph ph codeph">0x19</code>
</p><p class="- topic/p p" data-ofbid="d111929e262__20250123155209">如果不存在,则参考上述例子,添加一个新的设备记录。</p></li>
</ol></li>
<li class="- topic/li li" data-ofbid="d111929e266__20250123155209">修改 DTS<p class="- topic/p p" data-ofbid="d111929e268__20250123155209">要在实际项目中使用 SPI NOR 设备,还需要修改 DTS 配置。</p><p class="- topic/p p" data-ofbid="d111929e270__20250123155209"><span class="+ topic/ph sw-d/filepath ph filepath">board.dts</span>
应在具体的 SPI 控制器下添加 <code class="+ topic/ph pr-d/codeph ph codeph">jedec,spi-nor</code>
设备。</p><pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="spi_common_issues__pre_rk4_dyy_21c" data-ofbid="spi_common_issues__pre_rk4_dyy_21c"><code>&amp;spi0 {
pinctrl-names = <span class="hl-string">"default"</span>;
pinctrl-<span class="hl-number">0</span> = &lt;&amp;spi0_pins_a&gt;;
status = <span class="hl-string">"okay"</span>;
spi-max-frequency = &lt;<span class="hl-number">100000000</span>&gt;;
spi-flash@<span class="hl-number">0</span> {
#address-cells = &lt;<span class="hl-number">1</span>&gt;;
#size-cells = &lt;<span class="hl-number">1</span>&gt;;
compatible = <span class="hl-string">"jedec,spi-nor"</span>;
spi-max-frequency = &lt;<span class="hl-number">100000000</span>&gt;;
spi-tx-bus-width = &lt;<span class="hl-number">4</span>&gt;;
spi-rx-bus-width = &lt;<span class="hl-number">4</span>&gt;;
reg = &lt;<span class="hl-number">0</span>&gt;;
status = <span class="hl-string">"okay"</span>;
};
};
</code></pre><p class="- topic/p p" data-ofbid="d111929e279__20250123155209">同时还需在 <span class="+ topic/ph sw-d/filepath ph filepath">board-u-boot.dtsi</span> 文件中,将该设备标记为
<code class="+ topic/ph pr-d/codeph ph codeph">u-boot,dm-pre-reloc</code> ,不然 SPL
无法识别和使用。</p><pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="spi_common_issues__pre_sk4_dyy_21c" data-ofbid="spi_common_issues__pre_sk4_dyy_21c"><code>&amp;spi0 {
u-boot,dm-pre-reloc;
spi-flash@<span class="hl-number">0</span> {
u-boot,dm-pre-reloc;
};
};
</code></pre></li>
</ol>
</div>
</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="#spi_common_issues__section_xzs_2xy_21c" data-tocid="spi_common_issues__section_xzs_2xy_21c">如何添加新的 SPI NAND 设备</a></div></li><li class="section-item"><div class="section-title"><a href="#spi_common_issues__section_kz4_sxy_21c" data-tocid="spi_common_issues__section_kz4_sxy_21c">如何添加新的 SPI NOR 设备</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>