需求:
一款基于zynq架构的产品,只有qspi flash,并没有其他的存储设备,
现在的要求固化某个应用程序app,设置开机启动,
但是根据厂家提供的sdk,编译出的镜像重启后,文件系统的内容都会还原,
之前的方案是每次都要把程序放到buildroot下,
然后重新编译,将rootfs、内核镜像、设备树打包到image.ub.bin中,
然后用jtag重新烧录到flash中。
这很不合理,所以要我们需要对flash进行分区,
然后将需要固化的程序通过flashcp烧写到flash中,然后在用dd命令导出该文件。
0. MTD基础
该操作依赖linux的MTD子系统。
MTD(Memory Technology Device)是内存技术设备,它为原始闪存设备(例如NAND,OneNAND,NOR 等)提供了一个抽象层。
这些不同类型的Flash都可以使用相同的API。
通常内核都默认支持MTD驱动。
MTD字符设备-通常称为/dev/mtd0,/dev/mtd1等。
这些字符设备提供对原始闪存的I/O访问。
它们支持许多ioctl调用,用于擦除擦除块,将其标记为不良或检查擦除块是否不良,获取有关MTD设备的信息等。
sysfs接口,它提供有关系统中每个MTD设备的完整信息。 此接口易于扩展,并且鼓励开发人员尽可能使用sysfs接口,而不是较旧的ioctl或/proc/mtd接口。
mtd子系统的sysfs接口已在内核中进行了说明,当前可在Documentation/ABI/ testing/sysfs-class-mtd中找到。
/proc/mtd proc文件系统文件提供常规的MTD信息。 这是旧版界面,而sysfs界面提供了更多信息。
MTD子系统支持带有软件和硬件ECC的 raw NAND闪存,OneNAND闪存,CFI(通用闪存接口)NOR闪存以及其他类型的闪存。
1. 查看qspi flash大小
进入uboot
fmsh> sf probe 0
SF: Detected n25q256 with page size 256 Bytes, erase size 4 KiB, total 32 MiB
该命令式查看设备信息。
可以看到qspi flash容量为32MB,即0x1E84800
2. 需要固化镜像分区地址设置
一口君使用的平台需要固化2个文件:cfg(存储配置信息)、app(可执行程序)
加上必须烧录的boot.bin、image.ub.bin,一共有4个文件,
所以我们需要配置4个分区。
1) boot.bin、image.ub.bin地址
其中boot.bin包含了fpga的ip核和启动必要的文件信息,地址固定为0
image.ub.bin的地址通常厂家也会给出默认地址,
进入uboot打印环境信息:
fmsh> printenv
fit_size=0x153f000
flash_off=0x500000
load_addr=0x2000000
qspiboot=echo Copying FIT from SPI flash to RAM...
&& sf probe && sf read ${load_addr} ${flash_off} ${fit_size} && bootm ${load_addr}
echo Copying FIT from SPI flash to RAM... :
打印提示信息
sf probe:
查看设备硬件信息
sf read ${load_addr} ${flash_off} ${fit_size},
从flash地址flash_off开始读取fit_size个字节到ram地址load_addr
bootm ${load_addr}:
启动内核
可以看到flash地址是flash_off:0x500000
2) 分区划分
那现在我们就可以给这4个文件设置分区信息了
镜像 | 文件实际大小(hex) | 起始地址 | offset | 块数 |
---|---|---|---|---|
boot.bin | 3D0900 | 0x00000 | 0x500000 | 61-80 |
image.ub.bin | D59F80 | 0x500000 | 0x1100000 | 214-272 |
cfg.bin | 200 | 0x1600000 | 0x10000 | 1 |
app.bin | 7800 | 0x1610000 | 0x30000 | 3 |
注意:
offset大小必须是 0x10000整数倍,这个是擦除的最小单位-块。
每个分区大小结合要固化的程序,合理分配,既要考虑后面程序升级需要预留足够空间,也不要太大,造成浪费
分区划分不能超过flash最大值32M
3. 设备树
flash分区设备树说明如下:
Documentation\devicetree\bindings\mtd\partition.txt
Fixed Partitions
================
Partitions can be represented by sub-nodes of a flash device. This can be used
on platforms which have strong conventions about which portions of a flash are
used for what purposes, but which don't use an on-flash partition table such
as RedBoot.
The partition table should be a subnode of the flash node and should be named
'partitions'. This node should have the following property:
- compatible : (required) must be "fixed-partitions"
Partitions are then defined in subnodes of the partitions node.
For backwards compatibility partitions as direct subnodes of the flash device are
supported. This use is discouraged.
NOTE: also for backwards compatibility, direct subnodes that have a compatible
string are not considered partitions, as they may be used for other bindings.
#address-cells & #size-cells must both be present in the partitions subnode of the
flash device. There are two valid values for both:
<1>: for partitions that require a single 32-bit cell to represent their
size/address (aka the value is below 4 GiB)
<2>: for partitions that require two 32-bit cells to represent their
size/address (aka the value is 4 GiB or greater).
Required properties:
- reg : The partition's offset and size within the flash
Optional properties:
- label : The label / name for this partition. If omitted, the label is taken
from the node name (excluding the unit address).
- read-only : This parameter, if present, is a hint to Linux that this
partition should only be mounted read-only. This is usually used for flash
partitions containing early-boot firmware images or data which should not be
clobbered.
- lock : Do not unlock the partition at initialization time (not supported on
all devices)
我们只需要关注分区的子节点说明即可:
-
reg
描述某个flash分区的offset和size
-
label(可选)
分区名字
-
read-only(可选)
该分区只读
根据前面所有分析内容,最终我们修改设备信息如下:
&qspi0 {
status = "okay";
flash0: s25fl256s@0 {
compatible = "spi-flash","spansion,s25fl256s1", "jedec,spi-nor";
reg = <0>; /* chip select */
spi-max-frequency = <50000000>;
m25p,fast-read;
page-size = <256>;
block-size = <16>; /* 2^16, 64KB */
cdns,read-delay = <2>;
cdns,tshsl-ns = <0>;
cdns,tsd2d-ns = <0>;
cdns,tchsh-ns = <0>;
cdns,tslch-ns = <0>;
#address-cells = <1>;
#size-cells = <1>;
partition@boot {
label = "boot";
reg = <0x0000000 0x500000>;
};
[email protected] {
label = "uimage.ub";
reg = <0x500000 0x1100000>;
};
partition@prm {
label = "cfg";
reg = <0x1600000 0x10000>;
};
partition@kk_ap {
label = "app";
reg = <0x1610000 0x30000>;
};
};
};
重新编译rootfs打包后重新启动即可。
4. 查看分区信息
# cat /proc/mtd
dev: size erasesize name
mtd0: 00500000 00010000 "boot"
mtd1: 01100000 00010000 "uimage.ub"
mtd2: 00010000 00010000 "cfg"
mtd3: 00030000 00010000 "app"
# ls /dev/mtd* -l
crw------- 1 root root 90, 0 Jan 1 00:00 /dev/mtd0
crw------- 1 root root 90, 1 Jan 1 00:00 /dev/mtd0ro
crw------- 1 root root 90, 2 Jan 1 00:00 /dev/mtd1
crw------- 1 root root 90, 3 Jan 1 00:00 /dev/mtd1ro
crw------- 1 root root 90, 4 Jan 1 00:00 /dev/mtd2
crw------- 1 root root 90, 5 Jan 1 00:00 /dev/mtd2ro
crw------- 1 root root 90, 6 Jan 1 00:00 /dev/mtd3
crw------- 1 root root 90, 7 Jan 1 00:00 /dev/mtd3ro
brw------- 1 root root 31, 0 Jan 1 00:00 /dev/mtdblock0
brw------- 1 root root 31, 1 Jan 1 00:00 /dev/mtdblock1
brw------- 1 root root 31, 2 Jan 1 00:00 /dev/mtdblock2
brw------- 1 root root 31, 3 Jan 1 00:00 /dev/mtdblock3
/dev/mtd0,/dev/mtd0ro,/dev/mtdblock0代表的是同一个MTD分区,但是/dev/mtd0,/dev/mtd0ro都是字符设备,其中/dev/mtd0ro是只读字符设备,/dev/mtdblock0是块设备。
常见的mtd-utils,nand_write等工具只能操作/dev/mtdX字符设备,因为只有字符设备才支持ioctl操作。
5. 拷贝读取 MTD 分区
-
查看 MTD 分区
cat /proc/mtd
-
擦除 MTD 分区
flash_eraseall /dev/mtdX
擦除/dev/mtd0分区的第1块数据。
flash_erase /dev/mtd0 0x0 1
-
写 MTD 分区 NOR Flash
flashcp /tmp/mtd.bin /dev/mtdX
-
写 MTD 分区 NAND Flash
nandwrite /tmp/image.bin /dev/mtdX
-
读 MTD 分区
dd if=/dev/mtdX of=/tmp/mtd.bin
a) 烧写cfg.bin文件到mtd2
首先需要下载文件导开发板,可以用sd卡、网口(tftp)、串口(rz命令),根据自己的开发板资源。
执行下面命令烧录:
flash_erase /dev/mtd2 0x0 1
flashcp cfg.bin /dev/mtd2
导出分区文件
dd if=/dev/mtd2 of=/mnt/cfg.bin
b) 烧写app.bin到mtd3
flash_erase /dev/mtd3 0x0 3
flashcp app /dev/mtd3
导出分区文件
dd if=/dev/mtd3 of=/mnt/app.bin
6. 还原文件
注意导出的文件除了我们烧录的文件之外,
尾部还有多余FF,所以还需要去掉这些多余的部分,
所以我们必须要还原文件。
如下图所示:
【文件必须以二进制形式打开才能看到,彭老师用的Hex Editor Neo】
下载地址:
https://hhdsoftware.com/free-hex-editor
还原文件有很多方法,一口君自己写了个小程序,
原理:
逐字节读取文件,然后判断是否是0xFF,连续读取到16个0xff(防止文件中也由多个0XFF出现),
则认为读到了有效文件尾部,记录有效文件长度,然后根据该长度,复制成最终文件,该文件就是我们所需要的最终文件。
源码:
#include <stdio.h>
#include <stdlib.h>
#include <fcntl.h>
#include <unistd.h>
#include <sys/stat.h>
#include <sys/types.h>
int main(int argc, char** argv)
{
int fd_p;
int fdw_p;
unsigned char c;
int count = 0;
int pos = 0;
int i;
if(argc != 3)
{
printf("argument error\n");
for(int i = 0; i < argc ; i++)
{
printf("argv[%d] = %s\n", i, argv[i]);
}
}
fd_p = open(argv[1], O_RDWR);
if(fd_p < 0){
printf("open file %s failed\n", argv[1]);
return -1;
}
fdw_p = open(argv[2], O_RDWR | O_CREAT);
if(fdw_p < 0){
printf("open file %s failed\n", argv[2]);
return -1;
}
while(1){
read(fd_p, &c, 1);
if(c == 0xff){
count++;
if(count >= 16){
break;
}
}
else{
count = 0;
}
pos++;
}
lseek(fd_p, SEEK_SET, 0);
for(i=0; i<pos-15; i++){
read(fd_p, &c, 1);
write(fdw_p, &c, 1);
}
return 0;
}
测试:
可见写入到分区的文件和我们从分区读取后再还原的文件时一致的。
重启后,再验证
从MD5校验码可知,可执行程序还原正确。
7. 开机自动还原文件
要想开机后自动还原该文件,并启动程序app,步骤如下:
- 将exportimg拷贝文件系统/mnt下,(目录有执行权限即可)
- 设置开机子启动脚本
sdk/buildroot-xxxxxx/output/target/etc/init.d/rcS
文件尾部添加:
dd if=/dev/mtd2 of=/mnt/cfg.bin
dd if=/dev/mtd3 of=/mnt/app.bin
touch /mnt/app
touch /mnt/cfg
chmod 777 /mnt/app
chmod 777 /mnt/cfg
/mnt/exportimg /mnt/app.bin /mnt/app
/mnt/exportimg /mnt/cfg.bin /mnt/cfg
rm /mnt/cfg.bin
rm /mnt/app.bin
/mnt/app &
本例在复旦微fmsh平台测试通过。
zynq平台应该也没问题。