天津工程建设信息网站青岛品牌策划公司排名

张

张建站

2026/4/5 23:06:17

10分钟阅读

天津工程建设信息网站,青岛品牌策划公司排名,wordpress游戏代码仓鼠,餐饮网站建设目标1. 从零开始#xff1a;为什么你需要了解U-Boot的SF命令#xff1f; 如果你正在玩嵌入式开发#xff0c;尤其是基于ARM、RISC-V这类处理器的板子#xff0c;那你肯定绕不开U-Boot。它就像你板子的“临时管家”#xff0c;负责在Linux内核启动前#xff0c;完成最基础的硬…1. 从零开始为什么你需要了解U-Boot的SF命令如果你正在玩嵌入式开发尤其是基于ARM、RISC-V这类处理器的板子那你肯定绕不开U-Boot。它就像你板子的“临时管家”负责在Linux内核启动前完成最基础的硬件初始化、加载内核和文件系统。在这个过程中有一个存储设备你几乎一定会用到那就是SPI Flash。它体积小、功耗低、接口简单非常适合用来存放U-Boot本身、设备树DTB以及内核镜像。那么问题来了当你的板子刚焊好或者SPI Flash里空空如也时你怎么把U-Boot写进去呢又或者当你想更新内核时怎么操作最方便答案就是U-Boot自带的sf命令。这个命令就是U-Boot世界里专门用来和SPI Flash“对话”的工具。你可以用它来读取read、写入write、擦除eraseFlash里的数据甚至还能做保护和解锁操作。听起来很简单对吧但我在实际项目中踩过不少坑。比如明明照着教程配好了sf probe命令就是找不到Flash芯片或者写数据时总是失败返回一堆看不懂的错误。后来我才明白光知道敲命令是不够的必须得理解sf命令背后那一整套驱动框架是怎么运转的。只有搞懂了从命令行输入到SPI控制器真正发出信号的完整链条你才能从容应对各种稀奇古怪的问题真正把SPI Flash玩转。所以这篇文章我就结合自己调试的经验带你深入U-Boot的源码把sf命令的实现、配置以及背后的驱动模型DM, Driver Model掰开揉碎了讲清楚。我们不光要会用还要知道为什么这么用。2. 动手之前关键的配置宏与设备树想让sf命令在你的板子上跑起来第一步不是写代码而是做好配置。这就像盖房子要先打地基配置就是U-Boot驱动SPI Flash的地基。主要涉及两部分Kconfig配置宏和设备树DTS。2.1 核心配置宏打开SPI Flash的大门U-Boot使用Kconfig系统来管理功能模块的编译。要让sf命令和相关驱动生效你需要在板级配置头文件通常是include/configs/你的板子.h或者通过make menuconfig界面确保以下关键宏被正确启用。我通常会在配置文件里直接定义这样一目了然/* SPI Flash 支持 */ #define CONFIG_SPI_FLASH y /* 启用SPI Flash通用驱动框架 */ #define CONFIG_DM_SPI_FLASH y /* 启用基于驱动模型(DM)的SPI Flash驱动这是现代U-Boot的标配 */ /* SF 命令 */ #define CONFIG_CMD_SF y /* 启用 sf 命令本身 */ #define CONFIG_CMD_SF_TEST y /* 可选启用 sf 测试子命令方便调试 */ /* SPI 控制器支持 */ #define CONFIG_SPI y /* 启用SPI子系统 */ #define CONFIG_DM_SPI y /* 启用基于DM的SPI总线驱动 */ #define CONFIG_SPI_MEM y /* 启用SPI内存操作接口对Flash操作很重要 */ /* 默认SPI参数这些值通常会被DTS覆盖但可以作为保底配置 */ #define CONFIG_SF_DEFAULT_BUS 0 /* 默认SPI总线号 */ #define CONFIG_SF_DEFAULT_CS 0 /* 默认片选号 */ #define CONFIG_SF_DEFAULT_MODE SPI_MODE_0 /* 默认SPI模式通常是0 */ #define CONFIG_SF_DEFAULT_SPEED 1000000 /* 默认频率1MHz初始化时用后续可提频 */ /* Flash芯片特性 */ #define CONFIG_SPI_FLASH_USE_4K_SECTORS y /* 启用4K小扇区擦除支持很多现代Flash需要 */ /* #define CONFIG_SPI_FLASH_BAR y */ /* 如果你的Flash支持Bank地址寄存器(BAR)再打开 */这里有几个坑我提醒你注意CONFIG_DM_SPI_FLASH和CONFIG_DM_SPI这两个一定要开。DM是U-Boot现在主流的驱动框架它用设备树来管理硬件让驱动更清晰、更容易移植。如果你看到老教程里没提这个那很可能已经过时了。默认参数CONFIG_SF_DEFAULT_*这几个宏定义了sf probe命令不指定参数时的默认值。但优先级最高的是设备树里的设置。所以这里配个安全的低频比如1MHz就行具体工作频率在DTS里设。芯片支持最关键的一步是让你板子上用的那颗具体的SPI Flash芯片被驱动识别。U-Boot在drivers/mtd/spi/spi-nor-ids.c文件中维护了一个巨大的Flash信息表spi_nor_ids[]。你需要确认你的Flash型号在里面。比如我用过一颗镁光Micron的 MT25QU256A如果不在列表里我就得手动添加#ifdef CONFIG_SPI_FLASH_MICRO /* 这个宏可以自己定义比如在板级配置里 */ /* MICRON (Micron Technology, Inc.) */ { .name MT25QU256A, .id {0x20, 0xbb, 0x19}, /* 制造商ID和设备ID */ .id_len 3, .sector_size 64 * 1024, /* 擦除扇区大小64KB */ .n_sectors 512, /* 扇区数量512个总容量64KB*51232MB */ .flags SPI_NOR_4B_OPCODES | SPI_NOR_HAS_LOCK | SPI_NOR_HAS_TB | SECT_4K, /* 支持4字节地址模式、有写保护锁、有顶部/底部块保护、支持4K子扇区擦除 */ }, #endif添加完后记得在配置里加上#define CONFIG_SPI_FLASH_MICRO y来启用这个代码块。识别信息主要来自芯片的数据手册Datasheet找对JEDEC ID是关键。2.2 设备树配置告诉U-Boot硬件怎么连配置宏是开关设备树就是地图。它精确地描述了SPI控制器和Flash芯片在硬件上的连接关系以及它们的参数。这是现代U-Boot驱动绑定的依据。假设你的SoC有4个SPI控制器spi0到spi3Flash接在spi2总线的CS0上。你的设备树源文件.dts或.dtsi里需要这样写/* 首先确保SPI控制器节点本身是启用的 */ spi2 { status okay; /* 最关键把状态从disabled改为okay */ pinctrl-names default; pinctrl-0 pinctrl_spi2; /* 关联正确的引脚复用配置 */ clocks clk_spi2; /* 关联时钟 */ clock-names spi; /* 以下属性定义了该总线下的子设备即Flash的寻址方式 */ #address-cells 1; /* 子设备reg地址用1个cell表示 */ #size-cells 0; /* 子设备reg大小用0个cell表示通常SPI设备不需要 */ /* 这就是SPI Flash设备节点 */ flash0 { compatible jedec,spi-nor; /* 兼容性字符串驱动靠这个匹配 */ reg 0; /* 片选号0表示CS0 */ spi-max-frequency 50000000; /* 最大SPI时钟频率单位Hz这里设50MHz */ /* 以下是一些可选的芯片特性设置驱动可能会读取 */ spi-tx-bus-width 1; /* 发送数据线宽度1表示单线 */ spi-rx-bus-width 4; /* 接收数据线宽度4表示支持四线读取QSPI */ #address-cells 1; #size-cells 1; }; };几个容易出错的地方status okay我忘了不下三次DTS里默认很多节点是disabled不改成okayU-Boot根本不会去初始化这个SPI控制器。compatible字符串必须和驱动里spi_flash_std_ids[]或jedec_spi_nor驱动里的匹配。jedec,spi-nor是通用SPI NOR Flash的匹配字符串大多数情况都用这个。spi-max-frequency这个值不是随便设的。要查你的Flash芯片手册看它最高支持多少频率。同时也要考虑你的SoC SPI控制器的能力。初期调试可以设低一点比如10MHz稳定后再提高。引脚复用Pinctrl这是另一个大坑。光在SPI节点里启用还不够必须确保对应的SPI引脚MISO, MOSI, SCLK, CS已经通过引脚控制器Pinctrl正确复用了SPI功能。这部分配置通常在iomuxc或类似的节点里需要根据你的板子原理图来设置。配置好并编译U-Boot后如果一切顺利在启动日志里你应该能看到类似这样的信息表明SPI Flash驱动已经成功绑定并识别了芯片SF: Detected MT25QU256A with page size 256 Bytes, erase size 4 KiB, total 32 MiB3. 庖丁解牛SF命令的代码实现流程配置好了命令也能用了但我们不能只停留在表面。当你在U-Boot命令行输入sf read 82000000 0 1000时背后到底发生了什么我们深入代码把整个过程走一遍。理解这个对你调试和解决复杂问题有巨大帮助。3.1 命令的入口U_BOOT_CMD与do_spi_flash所有U-Boot命令都是通过U_BOOT_CMD宏来定义的。sf命令的定义在cmd/sf.c文件中U_BOOT_CMD( sf, /* 命令名 */ 5, /* 命令最大参数个数含命令本身 */ 1, /* 是否允许重复执行按回车重复上一次命令 */ do_spi_flash, /* 命令处理函数 */ SPI flash sub-system, /* 简短描述 */ probe [[bus:]cs] [hz] [mode] - init flash device on given SPI bus and chip select\n sf read addr offset|partition len - read len bytes starting at\n offset or from start of mtd partitionto memory at addr\n sf write addr offset|partition len - write len bytes from memory\n at addr to flash at offset or to start of mtd partition\n sf erase offset|partition []len - erase len bytes from offset\n or from start of mtd partition\n len round up len to block size\n sf update addr offset|partition len - erase and write len bytes from memory\n at addr to flash at offset or to start of mtd partition\n sf protect lock/unlock sector len - protect/unprotect len bytes starting\n at address sector\n SF_TEST_HELP );这个宏展开后会在编译时创建一个类型为cmd_tbl_t的结构体变量并把它放到一个叫做.u_boot_cmd的特殊段section里。U-Boot启动时会把所有在这个段里的命令结构体收集起来形成一个命令表。当你输入命令时U-Boot就在这个表里查找并调用对应的处理函数do_spi_flash。do_spi_flash函数是这个命令的“总调度中心”它根据你输入的子命令probe,read,write,erase,update,protect来调用不同的处理函数do_spi_flash_probe 初始化并探测SPI Flash设备。do_spi_flash_read_write 处理读和写操作。do_spi_flash_erase 处理擦除操作。do_spi_protect 处理写保护操作。do_spi_flash_test 运行测试如果使能了CONFIG_CMD_SF_TEST。3.2 灵魂步骤probe的详细旅程sf probe是使用任何sf命令的前提。它负责找到SPI总线、找到Flash芯片、初始化驱动并建立起一个可用的struct spi_flash对象。这个过程完美展示了U-Boot驱动模型DM的工作方式。当你输入sf probe 2:0表示总线2片选0时do_spi_flash_probe被调用其核心是spi_flash_probe_bus_cs函数。让我们一步步拆解第一步根据总线号和片选号找到设备。函数首先调用spi_get_bus_and_cs。这个函数内部会查找SPI总线设备通过uclass_get_device_by_seq(UCLASS_SPI, busnum, bus)根据总线号比如2在UCLASS_SPI这个“SPI总线类”下找到对应的udevice设备对象。这个udevice就是在设备树里定义的spi2控制器节点。查找SPI从设备通过spi_find_chip_select(bus, cs, dev)在刚才找到的SPI总线设备下寻找片选号比如0匹配的子设备。这个子设备udevice就是设备树里挂在spi2节点下的flash0节点。第二步激活probe设备。找到的devFlash设备对象可能还处于“未初始化”状态。device_probe(dev)这个函数非常关键它是一个递归函数会做以下几件事如果父设备SPI总线控制器也没初始化就先初始化父设备。这会调用SPI控制器的驱动probe函数比如dw_spi_probe配置好控制器的寄存器、时钟等。然后初始化Flash设备本身。这会调用Flash驱动的probe函数也就是spi_flash_std_probe。第三步Flash驱动的probe。在spi_flash_std_probe函数里发生了最核心的硬件交互获取SPI从设备句柄struct spi_slave *slave dev_get_parent_priv(dev);。这个slave对象代表了SPI总线上的一个从设备它是在SPI总线驱动初始化时根据UCLASS_DRIVER(spi)的.per_child_auto大小自动分配的内存。获取Flash私有数据struct spi_flash *flash dev_get_uclass_priv(dev);。这个flash对象是Flash驱动操作的核心它根据U_BOOT_DRIVER(jedec_spi_nor)的.priv_auto大小分配。建立关联flash-dev dev;和flash-spi slave;把设备对象和从设备句柄关联到flash结构体。发起真正的探测调用spi_flash_probe_slave(flash)。这个函数会 a.声明总线spi_claim_bus(slave)确保当前可以独占使用这条SPI总线。 b.读取芯片ID通过SPI总线发送0x9F命令Read ID读取Flash的制造商ID和设备ID。 c.匹配芯片表将读到的ID与spi_nor_ids[]表进行比对找到对应的芯片信息struct flash_info。这就是为什么我们之前要在spi-nor-ids.c里添加芯片信息的原因。 d.初始化NOR核心调用spi_nor_scan根据芯片信息设置读写擦除的函数指针、页大小、扇区大小、总容量等。最终一个完整的struct spi_flash对象就准备好了后续的读、写、擦除操作都通过它来进行。整个probe过程是U-Boot DM框架的一个经典案例通过设备树描述硬件拓扑 - U-Boot解析并创建udevice - 根据compatible匹配驱动 - 按需probe设备 - 建立起可操作的驱动对象。理解了这个流程你对U-Boot驱动工作的认识会上一个台阶。3.3 读写擦除最终如何操作硬件probe成功之后struct spi_flash *flash这个对象就包含了操作这块特定Flash芯片的所有方法。当我们执行sf read/write/erase时最终都会落到这个对象的方法上。以sf read 82000000 0 1000为例调用链是这样的do_spi_flash_read_write-spi_flash_read(flash, offset, len, buf)spi_flash_read-spi_flash_read_dm(flash-dev, offset, len, buf)spi_flash_read_dm-sf_get_ops(dev)-read(dev, offset, len, buf)这个sf_get_ops(dev)-read就是跳转到具体的驱动操作函数。对于标准的“jedec,spi-nor”兼容驱动这个函数指针指向spi_flash_std_read在sf_probe.c中定义。而spi_flash_std_read内部又会调用到更底层的spi_nor_read_data等函数。最关键的一步发生在SPI控制器驱动层。无论上层的NOR Flash驱动多么复杂它最终都需要通过SPI总线发送数据。这是通过struct dm_spi_ops中的.xfer函数指针实现的。以常见的DesignWare SPI控制器驱动为例这个指针指向dw_spi_xfer函数。在dw_spi_xfer函数里驱动会根据SPI模式CPOL, CPHA配置控制器寄存器。将要发送的数据对于读操作是命令字和地址对于写操作是命令、地址和待写数据填入Tx FIFO。启动传输等待传输完成。对于读操作从Rx FIFO中取出Flash返回的数据。这里有一个非常重要的优化点QSPIQuad SPI模式。你可能会在设备树里设置spi-rx-bus-width 4。这告诉驱动这颗Flash支持四线数据读取。在probe阶段如果驱动检测到Flash支持和控制器都支持QSPI它会将读操作的函数指针替换为更快的四线读取函数例如spi_nor_read_data_quad。这样在执行sf read时数据吞吐量会是标准SPI的4倍对于加载大型内核镜像速度提升非常明显。擦除erase和写入write的流程与读取类似但更复杂因为它们需要遵循Flash的编程规范写入前必须先擦除通常为1变0擦除是以扇区Sector或块Block为单位进行的。驱动内部会处理地址对齐、检查是否已擦除、发送写使能命令WREN、等待写操作完成检查状态寄存器BUSY位等细节。sf update命令则是一个更智能的封装它会在写入前比较目标区域的数据只有不同的扇区才执行擦除和写入节省了大量时间。4. 实战与调试让SF命令稳定工作理论懂了配置也配了但实际调不通怎么办这一部分我分享一些实战中排查问题的经验和技巧。4.1 常见问题排查清单sf probe失败提示 “No SPI flash detected” 或 “Invalid bus 0 (err-19)”检查DTS状态首先确认你的SPI控制器节点和Flash子节点的status属性是okay不是disabled。这是我犯过最多的低级错误。检查引脚复用使用pinmux命令如果U-Boot支持或在源码中检查确保SPI所需的SCLK、MOSI、MISO、CS引脚正确复用了SPI功能而不是被用作GPIO或其他功能。检查时钟确认SPI控制器的时钟已经使能并在设备树中正确引用。有时需要先在时钟控制器节点中使能SPI时钟。检查电源和上拉硬件上确保Flash芯片供电正常SPI数据线根据需要是否有上拉电阻。sf probe成功但识别出的容量或型号不对核对JEDEC ID用sf probe初始化后可以尝试用底层命令读取ID。有时需要自己写个小循环通过spi_xfer直接发0x9F命令读取3个字节打印出来。与数据手册对比看是否一致。不一致可能是电平问题或接线问题。检查驱动支持确认spi-nor-ids.c里你芯片的ID和参数扇区大小、容量是否正确。容量算错往往是n_sectors参数不对。sf read正常但sf write或sf erase失败检查写保护很多Flash有硬件写保护引脚WP#和软件写保护状态寄存器。确保硬件WP#引脚被拉高解除保护。可以通过sf protect unlock 0 1000尝试解除软件保护注意不是所有区域都能解锁。检查地址对齐擦除操作必须对齐到扇区边界如4K、64K。写入操作虽然可以按字节但必须在页Page通常是256字节内连续写入跨页需要分多次。sf命令内部会处理对齐但如果你直接调用驱动API需要注意。检查供电稳定性Flash在写入和擦除时功耗较大确保电源纹波在合理范围内。不稳定电源会导致写入数据错误或操作失败。操作速度非常慢提升时钟频率检查设备树中spi-max-frequency设置是否太低。在确保信号完整性的前提下可以逐步提高频率测试。启用QSPI/DSPI如果硬件支持务必在设备树中配置spi-rx-bus-width和spi-tx-bus-width并在驱动中启用对应的支持宏如CONFIG_SPI_FLASH_QUAD以启用多线模式大幅提升读取速度。4.2 利用U-Boot内置工具进行调试U-Boot提供了一些有用的调试命令和信息查看命令dm tree 如果你配置了CONFIG_CMD_DMy这个命令可以打印出整个驱动模型的设备树查看SPI总线和Flash设备是否成功绑定以及它们的序列号seq。dm uclass 列出所有uclass查看UCLASS_SPI和UCLASS_SPI_FLASH下有哪些设备。sf info probe之后这个命令可以显示探测到的Flash的详细信息包括制造商、容量、页大小、扇区大小、支持的读写模式等。sf test 如果使能了CONFIG_CMD_SF_TEST这个命令可以对Flash进行读写擦除的完整性测试非常有助于验证驱动和硬件的稳定性。4.3 进阶为新的SPI控制器添加支持有时候你用的SoC的SPI控制器可能不在U-Boot的标准支持列表里。你需要自己添加驱动。步骤其实很清晰实现struct dm_spi_ops 这是核心至少需要实现.xfer数据传输、.set_speed设置频率、.set_mode设置SPI模式这三个回调函数。定义U_BOOT_DRIVER 用你的驱动名和兼容性字符串compatible定义一个驱动结构体并指向你实现的ops。在设备树中匹配确保你的SPI控制器节点的compatible属性与你驱动中定义的字符串一致。添加到Makefile 将你的驱动源文件加入到drivers/spi/Makefile的编译列表中。整个过程其实就是遵循U-Boot DM框架的模板最复杂的部分通常是.xfer函数的实现需要仔细阅读你所用SPI控制器的数据手册正确配置寄存器、操作FIFO、处理中断或轮询状态。调试新驱动时我习惯先用一个简单的回环测试Loopback Test将MOSI和MISO短接然后在U-Boot里写个小循环通过spi_xfer发送特定数据并接收看是否能原样返回。这能最快地验证SPI控制器底层通信是否正常排除了Flash芯片本身的问题。通过这样从配置、到原理、再到实战和调试的完整梳理相信你对U-Boot中的SPI Flash驱动和SF命令已经有了一个立体而深入的理解。下次再遇到SPI Flash相关的问题你就能有的放矢快速定位到是配置问题、设备树问题、驱动问题还是硬件问题了。嵌入式开发就是这样知其然更要知其所以然功夫下在平时调试的时候才能游刃有余。