1. 项目概述为什么需要TFTP烧写文件系统拿到一块像飞凌嵌入式RK3568这样的高性能开发板第一件事就是给它“装系统”。对于嵌入式开发者和硬件工程师来说这几乎是家常便饭。我们有很多种方式可以完成这个任务通过SD卡、通过USB线缆、或者通过串口。但当你需要频繁地更换、测试不同的文件系统镜像或者你的开发板没有预留SD卡槽又或者你希望实现一种更自动化、更“网络化”的部署流程时TFTPTrivial File Transfer Protocol烧写方式就展现出了它独特的魅力。简单来说TFTP是一种基于UDP协议、设计极其简单的文件传输协议。它没有复杂的认证和目录浏览功能但正因如此它在局域网内的传输速度非常快特别适合在开发板Bootloader引导程序阶段通过网络从一台主机服务器上拉取固件镜像。对于RK3568这种集成了千兆以太网MAC的芯片利用TFTP进行系统烧写速度远超传统的串口Xmodem协议效率提升不是一星半点。想象一下一个几百兆的文件系统镜像通过串口可能要烧写几十分钟而通过TFTP在千兆局域网环境下可能只需要一两分钟这种时间成本的节约在快速迭代的开发过程中是至关重要的。本指南就是为你详细拆解如何在飞凌嵌入式RK3568开发板上从零开始搭建TFTP服务器环境并一步步引导开发板从网络启动、加载并烧写文件系统到eMMC或NAND Flash中的全过程。无论你是刚接触这块板子的新手还是希望优化现有工作流的老手这篇基于实操经验的总结都能提供清晰的路径和避坑参考。2. 环境准备与核心原理拆解在动手操作之前我们需要先理清整个流程的脉络和所需的“舞台”。TFTP烧写并非一个单点操作而是一个涉及开发主机Server、开发板Client和网络环境的三方协作过程。2.1 网络拓扑与角色定义一个典型的TFTP烧写环境拓扑如下TFTP服务器开发主机通常是一台运行Linux如Ubuntu的PC或虚拟机。它需要安装并运行TFTP服务软件并存放待烧写的文件系统镜像如rootfs.img、system.img等。TFTP客户端RK3568开发板开发板在上电后首先运行芯片内置的ROM Code然后加载SPLSecondary Program Loader进而启动U-Boot。我们需要在U-Boot阶段配置网络参数并启用TFTP客户端功能。网络连接开发板和主机必须位于同一个局域网段内。最直接可靠的方式是用一根网线将开发板的以太网口与主机的以太网口直连或者通过交换机/路由器连接。强烈建议在初次配置时使用直连方式以排除路由器DHCP等复杂因素的干扰。整个流程的核心原理是开发板在U-Boot阶段根据预设的IP地址、服务器IP和文件名通过TFTP协议从主机下载镜像文件到开发板的内存DDR中然后再通过U-Boot的存储设备命令如mmc write,nand write将内存中的镜像数据写入到板载的永久存储设备eMMC/NAND的指定位置。2.2 主机端TFTP服务器搭建在Ubuntu系统上搭建TFTP服务器非常简便。我们以最常用的tftpd-hpa为例。步骤一安装软件包打开终端执行以下命令sudo apt update sudo apt install tftpd-hpatftpd-hpa是一个性能更好、功能更全的TFTP服务器守护进程。步骤二配置TFTP服务器安装完成后需要编辑其配置文件sudo vim /etc/default/tftpd-hpa将文件内容修改或确保如下# /etc/default/tftpd-hpa TFTP_USERNAMEtftp TFTP_DIRECTORY/var/lib/tftpboot TFTP_ADDRESS:69 TFTP_OPTIONS--secure --create关键参数解析TFTP_DIRECTORY: 这是TFTP服务器的根目录。客户端请求的文件都从这个目录下查找。我们后续需要把烧写镜像放在这里。TFTP_OPTIONS:--secure选项将TFTP服务限制在上述目录内禁止访问目录外的文件增强安全性。--create允许客户端上传文件虽然烧写场景主要是下载。步骤三创建目录并设置权限确保目录存在并具有合适权限sudo mkdir -p /var/lib/tftpboot sudo chown -R tftp:tftp /var/lib/tftpboot sudo chmod -R 777 /var/lib/tftpboot # 为方便起见此处设为777生产环境建议更严格的权限步骤四重启服务并验证sudo systemctl restart tftpd-hpa sudo systemctl status tftpd-hpa看到active (running)状态即表示服务启动成功。你还可以用netstat -anu | grep 69命令检查69端口是否在监听。注意如果主机开启了防火墙如ufw需要放行TFTP使用的UDP 69端口sudo ufw allow 69/udp。2.3 开发板U-Boot网络配置准备这是最关键的一步需要确保开发板U-Boot能正确获取IP并连接到你的TFTP服务器。你需要准备一个串口调试工具如MobaXterm, minicom, picocom连接开发板的调试串口。给开发板上电在串口终端中快速敲击任意键如空格中断U-Boot的自动启动进入U-Boot命令行模式。首先设置开发板客户端和服务器主机的IP地址。你需要根据你的网络环境来设置。场景A直连网络推荐当开发板与主机用网线直连时它们处于一个孤立的二层网络。我们需要手动为双方配置同一网段的静态IP。设置主机IP在Ubuntu主机上为用于直连的网卡设置一个静态IP例如192.168.1.100子网掩码255.255.255.0。sudo nmcli con mod 你的有线连接名 ipv4.addresses 192.168.1.100/24 ipv4.method manual sudo nmcli con up 你的有线连接名设置开发板IP在U-Boot命令行中设置环境变量 setenv ipaddr 192.168.1.101 # 开发板IP与主机同一网段即可 setenv serverip 192.168.1.100 # 主机TFTP服务器IP setenv netmask 255.255.255.0场景B通过路由器/交换机连接如果开发板和主机都连接到一个开启了DHCP功能的路由器那么可以自动获取IP。确保路由器DHCP功能开启。在U-Boot中设置使用DHCP获取IP并指定服务器IP如果路由器分配的IP不固定可能需要先查看主机IP。 setenv autoload no dhcp # 执行dhcp后会显示获取到的ipaddr和gatewayip等信息 setenv serverip 192.168.1.xxx # 将此处替换为你主机的实际IP地址实操心得在U-Boot中serverip这个变量不会通过DHCP自动获取必须手动设置为你主机的IP这是最容易忽略导致tftp命令失败的点。验证网络连通性 配置好IP后使用U-Boot的ping命令测试与主机的连通性。注意U-Boot的ping命令目标机主机必须能响应U-Boot发出的ARP请求且主机不能屏蔽ICMP回显请求。 ping 192.168.1.100 Using ethernetfe010000 device host 192.168.1.100 is alive看到is alive表示网络层通信正常可以进行TFTP传输了。如果失败请检查网线、IP配置、主机防火墙是否阻止了ICMP或ARP。3. 获取与准备烧写镜像文件在进行烧写前你必须准备好正确的镜像文件。飞凌嵌入式通常会为RK3568开发板提供完整的SDK发布包其中包含编译好的各种镜像。3.1 镜像文件解读在SDK的rockdev/目录下你通常会找到以下关键镜像具体名称可能因版本而异MiniLoaderAll.bin或uboot.img: 第一级引导加载程序。parameter.txt: 分区表文件定义了eMMC/NAND上各个分区如boot, rootfs, userdata的起始位置和大小。boot.img: 包含内核kernel和设备树dtb的启动镜像。rootfs.img: 文件系统镜像包含了操作系统的基本命令、库和应用程序。这通常是我们需要通过TFTP烧写的主要大文件。misc.img,oem.img,userdata.img等: 其他分区镜像。对于TFTP烧写文件系统我们最关注的是rootfs.img。有时也可能是一个包含了所有分区的统一镜像如update.img但通过TFTP烧写大体积的update.img并不高效更常见的做法是只更新文件系统分区。3.2 放置镜像到TFTP目录将你需要通过网络烧写的镜像文件例如rootfs.img复制到主机的TFTP服务器根目录sudo cp /path/to/your/rootfs.img /var/lib/tftpboot/为了在U-Boot中方便输入建议给镜像文件起一个简短且无空格的名字例如rootfs.img本身就不错。同时确保文件有读取权限。4. U-Boot TFTP烧写全流程实操现在进入核心操作环节。请确保你已经主机TFTP服务正常运行。镜像文件已放入/var/lib/tftpboot。开发板串口终端已进入U-Boot命令行且网络ping测试通过。4.1 将镜像加载到开发板内存在U-Boot中使用tftp命令将文件从服务器加载到开发板的内存中。命令基本格式为tftp [loadAddress] [filename]loadAddress: 指定文件下载到开发板DDR内存中的起始地址。这个地址必须是一段未被使用的安全内存区域。filename: 位于TFTP服务器根目录下的文件名。对于RK3568其DDR容量通常为1GB、2GB或更高地址空间从0x00开始。一个常用的、安全的内存加载地址是0x08000000128MB偏移处。这个地址远离U-Boot自身运行代码和堆栈区足够容纳几百MB的镜像。执行下载 tftp 0x08000000 rootfs.img Using ethernetfe010000 device TFTP from server 192.168.1.100; our IP address is 192.168.1.101 Filename rootfs.img. Load address: 0x8000000 Loading: ################################################## # 进度会动态显示 6.1 MiB/s done Bytes transferred 536870912 (512 MiB) # 这里显示实际传输的字节数看到done和传输字节数表示文件已成功下载到开发板内存的0x08000000位置。注意事项内存地址选择地址0x08000000是一个经验值。如果烧写时出现奇怪错误如写入失败、系统重启可以尝试更换到更高地址如0x10000000。绝对不要使用0x0附近的地址。文件大小确保你选择的内存地址之后有足够的连续空间容纳整个镜像文件。例如一个512MB的镜像从0x08000000加载会占用到大约0x28000000的空间这个区间不能被其他数据占用。传输速度速度取决于网络质量和芯片性能。如果速度异常慢如低于1MB/s请检查网线、网络模式是否协商成千兆、以及主机和路由器的性能。4.2 识别存储设备与分区在将内存中的数据写入存储设备前需要先明确目标设备。RK3568开发板通常使用eMMC作为主要存储。在U-Boot中使用mmc list命令查看所有MMC设备。 mmc list FSL_SDHC: 0 (eMMC) # 这里显示设备0是eMMC FSL_SDHC: 1 (SD) # 设备1可能是SD卡槽这里FSL_SDHC: 0就是我们要操作的eMMC设备。在后续命令中我们用mmc dev 0来切换到该设备。接下来需要知道文件系统对应的分区号。这需要参考parameter.txt分区表文件。例如一个典型的分区表可能定义FIRMWARE_VER: 1.0 MACHINE_MODEL: RK3568 MACHINE_ID: 007 MANUFACTURER: RRKB MAGIC: 0x5041524B ATAG: 0x00200800 MACHINE: 0xffffffff CHECK_MASK: 0x80 PWR_HLD: 0,0,A,0,1 TYPE: GPT CMDLINE: mtdpartsrk29xxnand:0x000020000x00004000(uboot),0x000020000x00006000(misc),...或者更直观的0x000020000x00004000(uboot) 0x000020000x00006000(misc) 0x000080000x00008000(boot) 0x000100000x00010000(recovery) 0x000200000x00020000(backup) 0x000400000x00040000(rootfs) # 这是rootfs分区 0x000800000x00080000(oem) 0x000004000x00100000(metadata) 0x000004000x00100400(frp) 0x000100000x00100800(userdata)对于eMMC分区通常以编号形式存在。你可以通过part list mmc 0命令来查看eMMC设备0上的所有分区信息。 mmc dev 0 part list mmc 0 Partition Map for MMC device 0 -- Partition Type: EFI Part Start LBA End LBA Name Attributes Type GUID Partition GUID 1 0x00000040 0x0000037f uboot 2 0x00000380 0x0000039f misc 3 0x000003a0 0x000007df boot 4 0x000007e0 0x00000c1f recovery 5 0x00000c20 0x0000149f backup 6 0x000014a0 0x0000249f rootfs # 这是我们要写的分区假设是第6分区 7 0x000024a0 0x0000449f oem 8 0x000044a0 0x000044df metadata 9 0x000044e0 0x000044ff frp 10 0x00004500 0x000054ff userdata记下rootfs分区对应的分区号这里是6。同时记录其Start LBA起始扇区号这里是0x000014a0在某些写入命令中可能会用到。4.3 执行烧写操作我们将内存0x08000000处加载的镜像写入到eMMC的rootfs分区。U-Boot中写入MMC设备的命令通常是mmc write。命令格式mmc write 内存地址 设备扇区号 写入的扇区数量内存地址我们之前加载镜像的地址0x08000000。设备扇区号目标分区在存储设备上的起始扇区号LBA。从上一步可知rootfs分区的Start LBA是0x000014a0十进制为5280。写入的扇区数量需要计算。公式为镜像文件大小字节 / 扇区大小通常为512字节。从之前的tftp命令输出可知Bytes transferred 536870912。扇区大小一般为512字节。计算536870912 / 512 1048576个扇区。在十六进制中1048576 0x100000。执行烧写命令 mmc dev 0 mmc write 0x08000000 0x14a0 0x100000 MMC write: dev # 0, block # 5280, count 1048576 ... 1048576 blocks written: OK这个命令的含义是从内存地址0x08000000开始将0x1000001048576个扇区的数据写入到MMC设备0从扇区号0x14a05280开始的位置。重要安全提示mmc write是一个底层直接写盘操作一旦指定错误的扇区号极有可能覆盖掉uboot、boot等其他关键分区导致开发板彻底变砖。因此在执行前务必双重确认part list显示的分区信息。确认parameter.txt文件中的分区布局与你板子的实际布局一致。对于rootfs分区其前面的分区如boot通常有足够的间隙但操作时仍需万分谨慎。4.4 验证烧写结果可选但建议烧写完成后可以读取刚写入的数据进行简单校验。使用mmc read命令将刚才写入的扇区读回到内存的另一处然后使用cmp命令比较两块内存区域的内容。 mmc read 0x09000000 0x14a0 0x100000 # 读到另一块内存 cmp.b 0x08000000 0x09000000 0x20000000 # 比较长度可以用文件字节数536870912如果比较结果没有输出错误或者提示所有字节相同则说明写入的数据与源数据一致烧写成功。你也可以直接重启系统尝试从新的文件系统启动来验证。5. 自动化脚本与高级技巧对于需要反复烧写测试的场景每次手动输入一系列命令非常低效。U-Boot支持将命令写入环境变量并制作成自动化脚本。5.1 制作TFTP烧写脚本我们可以将整个流程的命令整合到一个环境变量中例如命名为tftp_flash_rootfs。 setenv tftp_flash_rootfs echo Starting TFTP flash...; tftp 0x08000000 rootfs.img; echo Writing to eMMC...; mmc dev 0; mmc write 0x08000000 0x14a0 0x100000; echo Done. saveenv这样下次进入U-Boot后只需要执行run tftp_flash_rootfs就会自动执行下载和烧写流程。5.2 使用bootcmd实现上电自动烧写更进一步你可以修改bootcmd环境变量让开发板上电后自动执行网络烧写。注意这是一个高风险操作仅用于特定生产或测试环境日常开发切勿设置否则每次启动都会擦写eMMC setenv bootcmd run tftp_flash_rootfs; # 将启动命令替换为我们的烧写脚本 saveenv在特定流水线作业中这可以实现无人值守的自动烧录。5.3 处理大镜像与内存不足如果文件系统镜像非常大比如超过1GB而开发板内存有限无法一次性加载可以采用“分块加载-写入”的策略。思路是将镜像在主机上分割成多个小文件在U-Boot中循环执行tftp和mmc write每次写入一部分并更新内存地址和目标扇区号。这需要更复杂的脚本编写但原理是相通的。6. 常见问题排查与解决实录在实际操作中你几乎一定会遇到一些问题。下面是我踩过的一些坑和解决方案。6.1 TFTP下载失败现象执行tftp命令后提示TIMEOUT、Retry count exceeded或Server IP address not set。排查步骤检查serverip这是最常见的原因。用printenv serverip确认serverip是否已正确设置为你的主机IP。检查网络连通性用ping $serverip测试。如果ping不通检查网线、IP是否在同一网段、主机防火墙是否屏蔽了所有UDP包可以暂时关闭防火墙测试sudo ufw disable。检查TFTP服务器在主机上使用sudo netstat -anu | grep :69确认tftpd-hpa服务正在监听。检查/var/lib/tftpboot目录下是否有目标文件权限是否为可读。检查文件名U-Boot中的文件名必须与tftpboot目录下的文件名完全一致包括大小写。尝试简单文件先在tftpboot目录下放一个很小的测试文件如test.txt尝试tftp加载它以排除大文件传输过程中的意外问题。6.2 烧写过程报错或系统无法启动现象mmc write命令执行失败或写入后系统无法启动卡在某个阶段。排查步骤确认分区信息再次用part list mmc 0核对rootfs分区的起始扇区号。不同版本固件的分区表可能有差异。确认镜像格式确保你下载的rootfs.img是适合直接写入原始分区的镜像如ext4格式的raw image而不是一个需要解压的打包文件。有时厂商提供的可能是rootfs.tar.gz或rootfs.ext4.gz需要先在主机解压或使用gunzip命令在内存中解压如果U-Boot支持。计算扇区数重新计算镜像大小/512确保扇区数计算正确。可以使用U-Boot的filesize环境变量它在tftp命令成功后会自动设置为传输的字节数。因此烧写命令可以优化为 tftp 0x08000000 rootfs.img mmc write 0x08000000 0x14a0 ${filesize}注意${filesize}需要转换为扇区数。但mmc write命令要求的是扇区数而filesize是字节数。一个更稳妥的方法是使用setexpr命令计算setexpr blkcnt ${filesize} / 0x200因为0x200512。内存地址冲突尝试更换一个更高的加载地址如0x10000000。存储设备只读或损坏极少数情况下eMMC可能处于写保护状态或物理损坏。可以尝试用mmc write 0x08000000 0x14a0 1先写一个扇区测试。6.3 传输速度慢现象TFTP传输速度远低于网络理论速度。可能原因与解决网络模式确保网线连接正常并协商成千兆模式1Gbps。在U-Boot中可能看不到协商速率但在主机端可以用ethtool 网卡名查看。U-Boot驱动有些早期或定制的U-Boot版本其以太网驱动可能未做充分优化。可以尝试更新到官方或厂商提供的最新U-Boot。服务器性能如果主机是虚拟机请确保虚拟网卡模式是“桥接”或“NAT模式已开启性能优化”并且为虚拟机分配了足够的CPU资源。使用更快的协议如果TFTP始终不理想可以考虑在U-Boot中尝试使用nfs命令挂载网络文件系统来直接运行或更新文件但这需要更复杂的NFS服务器配置。6.4 环境变量保存失败现象执行saveenv后提示成功但重启后环境变量恢复默认。解决这通常是因为环境变量保存的分区通常是eMMC上的一个特定区域如“env”分区不存在或损坏。需要检查U-Boot的默认环境变量存储设备配置CONFIG_ENV_IS_IN_MMC等。在飞凌的板子上通常已经配置好。如果问题持续可以尝试在saveenv前用env default -a恢复默认环境然后再重新设置并保存。最根本的解决方法是重新烧写完整的U-Boot镜像。整个TFTP烧写流程从环境搭建到命令执行再到问题排查其核心在于对网络、存储和U-Boot命令的精确理解。一旦跑通它就会成为你嵌入式开发工具箱里一件高效可靠的利器。尤其是在需要为多块板子部署相同系统或者进行持续集成测试时这种网络化的方法能节省大量物理插拔SD卡的时间。最后一个小建议在第一次成功烧写后最好将正确的、完整的一套命令序列保存到本地文档或U-Boot脚本中以后就可以一键执行了。
RK3568开发板TFTP烧写文件系统：原理、配置与实战指南
1. 项目概述为什么需要TFTP烧写文件系统拿到一块像飞凌嵌入式RK3568这样的高性能开发板第一件事就是给它“装系统”。对于嵌入式开发者和硬件工程师来说这几乎是家常便饭。我们有很多种方式可以完成这个任务通过SD卡、通过USB线缆、或者通过串口。但当你需要频繁地更换、测试不同的文件系统镜像或者你的开发板没有预留SD卡槽又或者你希望实现一种更自动化、更“网络化”的部署流程时TFTPTrivial File Transfer Protocol烧写方式就展现出了它独特的魅力。简单来说TFTP是一种基于UDP协议、设计极其简单的文件传输协议。它没有复杂的认证和目录浏览功能但正因如此它在局域网内的传输速度非常快特别适合在开发板Bootloader引导程序阶段通过网络从一台主机服务器上拉取固件镜像。对于RK3568这种集成了千兆以太网MAC的芯片利用TFTP进行系统烧写速度远超传统的串口Xmodem协议效率提升不是一星半点。想象一下一个几百兆的文件系统镜像通过串口可能要烧写几十分钟而通过TFTP在千兆局域网环境下可能只需要一两分钟这种时间成本的节约在快速迭代的开发过程中是至关重要的。本指南就是为你详细拆解如何在飞凌嵌入式RK3568开发板上从零开始搭建TFTP服务器环境并一步步引导开发板从网络启动、加载并烧写文件系统到eMMC或NAND Flash中的全过程。无论你是刚接触这块板子的新手还是希望优化现有工作流的老手这篇基于实操经验的总结都能提供清晰的路径和避坑参考。2. 环境准备与核心原理拆解在动手操作之前我们需要先理清整个流程的脉络和所需的“舞台”。TFTP烧写并非一个单点操作而是一个涉及开发主机Server、开发板Client和网络环境的三方协作过程。2.1 网络拓扑与角色定义一个典型的TFTP烧写环境拓扑如下TFTP服务器开发主机通常是一台运行Linux如Ubuntu的PC或虚拟机。它需要安装并运行TFTP服务软件并存放待烧写的文件系统镜像如rootfs.img、system.img等。TFTP客户端RK3568开发板开发板在上电后首先运行芯片内置的ROM Code然后加载SPLSecondary Program Loader进而启动U-Boot。我们需要在U-Boot阶段配置网络参数并启用TFTP客户端功能。网络连接开发板和主机必须位于同一个局域网段内。最直接可靠的方式是用一根网线将开发板的以太网口与主机的以太网口直连或者通过交换机/路由器连接。强烈建议在初次配置时使用直连方式以排除路由器DHCP等复杂因素的干扰。整个流程的核心原理是开发板在U-Boot阶段根据预设的IP地址、服务器IP和文件名通过TFTP协议从主机下载镜像文件到开发板的内存DDR中然后再通过U-Boot的存储设备命令如mmc write,nand write将内存中的镜像数据写入到板载的永久存储设备eMMC/NAND的指定位置。2.2 主机端TFTP服务器搭建在Ubuntu系统上搭建TFTP服务器非常简便。我们以最常用的tftpd-hpa为例。步骤一安装软件包打开终端执行以下命令sudo apt update sudo apt install tftpd-hpatftpd-hpa是一个性能更好、功能更全的TFTP服务器守护进程。步骤二配置TFTP服务器安装完成后需要编辑其配置文件sudo vim /etc/default/tftpd-hpa将文件内容修改或确保如下# /etc/default/tftpd-hpa TFTP_USERNAMEtftp TFTP_DIRECTORY/var/lib/tftpboot TFTP_ADDRESS:69 TFTP_OPTIONS--secure --create关键参数解析TFTP_DIRECTORY: 这是TFTP服务器的根目录。客户端请求的文件都从这个目录下查找。我们后续需要把烧写镜像放在这里。TFTP_OPTIONS:--secure选项将TFTP服务限制在上述目录内禁止访问目录外的文件增强安全性。--create允许客户端上传文件虽然烧写场景主要是下载。步骤三创建目录并设置权限确保目录存在并具有合适权限sudo mkdir -p /var/lib/tftpboot sudo chown -R tftp:tftp /var/lib/tftpboot sudo chmod -R 777 /var/lib/tftpboot # 为方便起见此处设为777生产环境建议更严格的权限步骤四重启服务并验证sudo systemctl restart tftpd-hpa sudo systemctl status tftpd-hpa看到active (running)状态即表示服务启动成功。你还可以用netstat -anu | grep 69命令检查69端口是否在监听。注意如果主机开启了防火墙如ufw需要放行TFTP使用的UDP 69端口sudo ufw allow 69/udp。2.3 开发板U-Boot网络配置准备这是最关键的一步需要确保开发板U-Boot能正确获取IP并连接到你的TFTP服务器。你需要准备一个串口调试工具如MobaXterm, minicom, picocom连接开发板的调试串口。给开发板上电在串口终端中快速敲击任意键如空格中断U-Boot的自动启动进入U-Boot命令行模式。首先设置开发板客户端和服务器主机的IP地址。你需要根据你的网络环境来设置。场景A直连网络推荐当开发板与主机用网线直连时它们处于一个孤立的二层网络。我们需要手动为双方配置同一网段的静态IP。设置主机IP在Ubuntu主机上为用于直连的网卡设置一个静态IP例如192.168.1.100子网掩码255.255.255.0。sudo nmcli con mod 你的有线连接名 ipv4.addresses 192.168.1.100/24 ipv4.method manual sudo nmcli con up 你的有线连接名设置开发板IP在U-Boot命令行中设置环境变量 setenv ipaddr 192.168.1.101 # 开发板IP与主机同一网段即可 setenv serverip 192.168.1.100 # 主机TFTP服务器IP setenv netmask 255.255.255.0场景B通过路由器/交换机连接如果开发板和主机都连接到一个开启了DHCP功能的路由器那么可以自动获取IP。确保路由器DHCP功能开启。在U-Boot中设置使用DHCP获取IP并指定服务器IP如果路由器分配的IP不固定可能需要先查看主机IP。 setenv autoload no dhcp # 执行dhcp后会显示获取到的ipaddr和gatewayip等信息 setenv serverip 192.168.1.xxx # 将此处替换为你主机的实际IP地址实操心得在U-Boot中serverip这个变量不会通过DHCP自动获取必须手动设置为你主机的IP这是最容易忽略导致tftp命令失败的点。验证网络连通性 配置好IP后使用U-Boot的ping命令测试与主机的连通性。注意U-Boot的ping命令目标机主机必须能响应U-Boot发出的ARP请求且主机不能屏蔽ICMP回显请求。 ping 192.168.1.100 Using ethernetfe010000 device host 192.168.1.100 is alive看到is alive表示网络层通信正常可以进行TFTP传输了。如果失败请检查网线、IP配置、主机防火墙是否阻止了ICMP或ARP。3. 获取与准备烧写镜像文件在进行烧写前你必须准备好正确的镜像文件。飞凌嵌入式通常会为RK3568开发板提供完整的SDK发布包其中包含编译好的各种镜像。3.1 镜像文件解读在SDK的rockdev/目录下你通常会找到以下关键镜像具体名称可能因版本而异MiniLoaderAll.bin或uboot.img: 第一级引导加载程序。parameter.txt: 分区表文件定义了eMMC/NAND上各个分区如boot, rootfs, userdata的起始位置和大小。boot.img: 包含内核kernel和设备树dtb的启动镜像。rootfs.img: 文件系统镜像包含了操作系统的基本命令、库和应用程序。这通常是我们需要通过TFTP烧写的主要大文件。misc.img,oem.img,userdata.img等: 其他分区镜像。对于TFTP烧写文件系统我们最关注的是rootfs.img。有时也可能是一个包含了所有分区的统一镜像如update.img但通过TFTP烧写大体积的update.img并不高效更常见的做法是只更新文件系统分区。3.2 放置镜像到TFTP目录将你需要通过网络烧写的镜像文件例如rootfs.img复制到主机的TFTP服务器根目录sudo cp /path/to/your/rootfs.img /var/lib/tftpboot/为了在U-Boot中方便输入建议给镜像文件起一个简短且无空格的名字例如rootfs.img本身就不错。同时确保文件有读取权限。4. U-Boot TFTP烧写全流程实操现在进入核心操作环节。请确保你已经主机TFTP服务正常运行。镜像文件已放入/var/lib/tftpboot。开发板串口终端已进入U-Boot命令行且网络ping测试通过。4.1 将镜像加载到开发板内存在U-Boot中使用tftp命令将文件从服务器加载到开发板的内存中。命令基本格式为tftp [loadAddress] [filename]loadAddress: 指定文件下载到开发板DDR内存中的起始地址。这个地址必须是一段未被使用的安全内存区域。filename: 位于TFTP服务器根目录下的文件名。对于RK3568其DDR容量通常为1GB、2GB或更高地址空间从0x00开始。一个常用的、安全的内存加载地址是0x08000000128MB偏移处。这个地址远离U-Boot自身运行代码和堆栈区足够容纳几百MB的镜像。执行下载 tftp 0x08000000 rootfs.img Using ethernetfe010000 device TFTP from server 192.168.1.100; our IP address is 192.168.1.101 Filename rootfs.img. Load address: 0x8000000 Loading: ################################################## # 进度会动态显示 6.1 MiB/s done Bytes transferred 536870912 (512 MiB) # 这里显示实际传输的字节数看到done和传输字节数表示文件已成功下载到开发板内存的0x08000000位置。注意事项内存地址选择地址0x08000000是一个经验值。如果烧写时出现奇怪错误如写入失败、系统重启可以尝试更换到更高地址如0x10000000。绝对不要使用0x0附近的地址。文件大小确保你选择的内存地址之后有足够的连续空间容纳整个镜像文件。例如一个512MB的镜像从0x08000000加载会占用到大约0x28000000的空间这个区间不能被其他数据占用。传输速度速度取决于网络质量和芯片性能。如果速度异常慢如低于1MB/s请检查网线、网络模式是否协商成千兆、以及主机和路由器的性能。4.2 识别存储设备与分区在将内存中的数据写入存储设备前需要先明确目标设备。RK3568开发板通常使用eMMC作为主要存储。在U-Boot中使用mmc list命令查看所有MMC设备。 mmc list FSL_SDHC: 0 (eMMC) # 这里显示设备0是eMMC FSL_SDHC: 1 (SD) # 设备1可能是SD卡槽这里FSL_SDHC: 0就是我们要操作的eMMC设备。在后续命令中我们用mmc dev 0来切换到该设备。接下来需要知道文件系统对应的分区号。这需要参考parameter.txt分区表文件。例如一个典型的分区表可能定义FIRMWARE_VER: 1.0 MACHINE_MODEL: RK3568 MACHINE_ID: 007 MANUFACTURER: RRKB MAGIC: 0x5041524B ATAG: 0x00200800 MACHINE: 0xffffffff CHECK_MASK: 0x80 PWR_HLD: 0,0,A,0,1 TYPE: GPT CMDLINE: mtdpartsrk29xxnand:0x000020000x00004000(uboot),0x000020000x00006000(misc),...或者更直观的0x000020000x00004000(uboot) 0x000020000x00006000(misc) 0x000080000x00008000(boot) 0x000100000x00010000(recovery) 0x000200000x00020000(backup) 0x000400000x00040000(rootfs) # 这是rootfs分区 0x000800000x00080000(oem) 0x000004000x00100000(metadata) 0x000004000x00100400(frp) 0x000100000x00100800(userdata)对于eMMC分区通常以编号形式存在。你可以通过part list mmc 0命令来查看eMMC设备0上的所有分区信息。 mmc dev 0 part list mmc 0 Partition Map for MMC device 0 -- Partition Type: EFI Part Start LBA End LBA Name Attributes Type GUID Partition GUID 1 0x00000040 0x0000037f uboot 2 0x00000380 0x0000039f misc 3 0x000003a0 0x000007df boot 4 0x000007e0 0x00000c1f recovery 5 0x00000c20 0x0000149f backup 6 0x000014a0 0x0000249f rootfs # 这是我们要写的分区假设是第6分区 7 0x000024a0 0x0000449f oem 8 0x000044a0 0x000044df metadata 9 0x000044e0 0x000044ff frp 10 0x00004500 0x000054ff userdata记下rootfs分区对应的分区号这里是6。同时记录其Start LBA起始扇区号这里是0x000014a0在某些写入命令中可能会用到。4.3 执行烧写操作我们将内存0x08000000处加载的镜像写入到eMMC的rootfs分区。U-Boot中写入MMC设备的命令通常是mmc write。命令格式mmc write 内存地址 设备扇区号 写入的扇区数量内存地址我们之前加载镜像的地址0x08000000。设备扇区号目标分区在存储设备上的起始扇区号LBA。从上一步可知rootfs分区的Start LBA是0x000014a0十进制为5280。写入的扇区数量需要计算。公式为镜像文件大小字节 / 扇区大小通常为512字节。从之前的tftp命令输出可知Bytes transferred 536870912。扇区大小一般为512字节。计算536870912 / 512 1048576个扇区。在十六进制中1048576 0x100000。执行烧写命令 mmc dev 0 mmc write 0x08000000 0x14a0 0x100000 MMC write: dev # 0, block # 5280, count 1048576 ... 1048576 blocks written: OK这个命令的含义是从内存地址0x08000000开始将0x1000001048576个扇区的数据写入到MMC设备0从扇区号0x14a05280开始的位置。重要安全提示mmc write是一个底层直接写盘操作一旦指定错误的扇区号极有可能覆盖掉uboot、boot等其他关键分区导致开发板彻底变砖。因此在执行前务必双重确认part list显示的分区信息。确认parameter.txt文件中的分区布局与你板子的实际布局一致。对于rootfs分区其前面的分区如boot通常有足够的间隙但操作时仍需万分谨慎。4.4 验证烧写结果可选但建议烧写完成后可以读取刚写入的数据进行简单校验。使用mmc read命令将刚才写入的扇区读回到内存的另一处然后使用cmp命令比较两块内存区域的内容。 mmc read 0x09000000 0x14a0 0x100000 # 读到另一块内存 cmp.b 0x08000000 0x09000000 0x20000000 # 比较长度可以用文件字节数536870912如果比较结果没有输出错误或者提示所有字节相同则说明写入的数据与源数据一致烧写成功。你也可以直接重启系统尝试从新的文件系统启动来验证。5. 自动化脚本与高级技巧对于需要反复烧写测试的场景每次手动输入一系列命令非常低效。U-Boot支持将命令写入环境变量并制作成自动化脚本。5.1 制作TFTP烧写脚本我们可以将整个流程的命令整合到一个环境变量中例如命名为tftp_flash_rootfs。 setenv tftp_flash_rootfs echo Starting TFTP flash...; tftp 0x08000000 rootfs.img; echo Writing to eMMC...; mmc dev 0; mmc write 0x08000000 0x14a0 0x100000; echo Done. saveenv这样下次进入U-Boot后只需要执行run tftp_flash_rootfs就会自动执行下载和烧写流程。5.2 使用bootcmd实现上电自动烧写更进一步你可以修改bootcmd环境变量让开发板上电后自动执行网络烧写。注意这是一个高风险操作仅用于特定生产或测试环境日常开发切勿设置否则每次启动都会擦写eMMC setenv bootcmd run tftp_flash_rootfs; # 将启动命令替换为我们的烧写脚本 saveenv在特定流水线作业中这可以实现无人值守的自动烧录。5.3 处理大镜像与内存不足如果文件系统镜像非常大比如超过1GB而开发板内存有限无法一次性加载可以采用“分块加载-写入”的策略。思路是将镜像在主机上分割成多个小文件在U-Boot中循环执行tftp和mmc write每次写入一部分并更新内存地址和目标扇区号。这需要更复杂的脚本编写但原理是相通的。6. 常见问题排查与解决实录在实际操作中你几乎一定会遇到一些问题。下面是我踩过的一些坑和解决方案。6.1 TFTP下载失败现象执行tftp命令后提示TIMEOUT、Retry count exceeded或Server IP address not set。排查步骤检查serverip这是最常见的原因。用printenv serverip确认serverip是否已正确设置为你的主机IP。检查网络连通性用ping $serverip测试。如果ping不通检查网线、IP是否在同一网段、主机防火墙是否屏蔽了所有UDP包可以暂时关闭防火墙测试sudo ufw disable。检查TFTP服务器在主机上使用sudo netstat -anu | grep :69确认tftpd-hpa服务正在监听。检查/var/lib/tftpboot目录下是否有目标文件权限是否为可读。检查文件名U-Boot中的文件名必须与tftpboot目录下的文件名完全一致包括大小写。尝试简单文件先在tftpboot目录下放一个很小的测试文件如test.txt尝试tftp加载它以排除大文件传输过程中的意外问题。6.2 烧写过程报错或系统无法启动现象mmc write命令执行失败或写入后系统无法启动卡在某个阶段。排查步骤确认分区信息再次用part list mmc 0核对rootfs分区的起始扇区号。不同版本固件的分区表可能有差异。确认镜像格式确保你下载的rootfs.img是适合直接写入原始分区的镜像如ext4格式的raw image而不是一个需要解压的打包文件。有时厂商提供的可能是rootfs.tar.gz或rootfs.ext4.gz需要先在主机解压或使用gunzip命令在内存中解压如果U-Boot支持。计算扇区数重新计算镜像大小/512确保扇区数计算正确。可以使用U-Boot的filesize环境变量它在tftp命令成功后会自动设置为传输的字节数。因此烧写命令可以优化为 tftp 0x08000000 rootfs.img mmc write 0x08000000 0x14a0 ${filesize}注意${filesize}需要转换为扇区数。但mmc write命令要求的是扇区数而filesize是字节数。一个更稳妥的方法是使用setexpr命令计算setexpr blkcnt ${filesize} / 0x200因为0x200512。内存地址冲突尝试更换一个更高的加载地址如0x10000000。存储设备只读或损坏极少数情况下eMMC可能处于写保护状态或物理损坏。可以尝试用mmc write 0x08000000 0x14a0 1先写一个扇区测试。6.3 传输速度慢现象TFTP传输速度远低于网络理论速度。可能原因与解决网络模式确保网线连接正常并协商成千兆模式1Gbps。在U-Boot中可能看不到协商速率但在主机端可以用ethtool 网卡名查看。U-Boot驱动有些早期或定制的U-Boot版本其以太网驱动可能未做充分优化。可以尝试更新到官方或厂商提供的最新U-Boot。服务器性能如果主机是虚拟机请确保虚拟网卡模式是“桥接”或“NAT模式已开启性能优化”并且为虚拟机分配了足够的CPU资源。使用更快的协议如果TFTP始终不理想可以考虑在U-Boot中尝试使用nfs命令挂载网络文件系统来直接运行或更新文件但这需要更复杂的NFS服务器配置。6.4 环境变量保存失败现象执行saveenv后提示成功但重启后环境变量恢复默认。解决这通常是因为环境变量保存的分区通常是eMMC上的一个特定区域如“env”分区不存在或损坏。需要检查U-Boot的默认环境变量存储设备配置CONFIG_ENV_IS_IN_MMC等。在飞凌的板子上通常已经配置好。如果问题持续可以尝试在saveenv前用env default -a恢复默认环境然后再重新设置并保存。最根本的解决方法是重新烧写完整的U-Boot镜像。整个TFTP烧写流程从环境搭建到命令执行再到问题排查其核心在于对网络、存储和U-Boot命令的精确理解。一旦跑通它就会成为你嵌入式开发工具箱里一件高效可靠的利器。尤其是在需要为多块板子部署相同系统或者进行持续集成测试时这种网络化的方法能节省大量物理插拔SD卡的时间。最后一个小建议在第一次成功烧写后最好将正确的、完整的一套命令序列保存到本地文档或U-Boot脚本中以后就可以一键执行了。
