openwrt spi flash 分区适配过程
openwrt spi flash 分区适配过程
这里基于 openwrt mt7620a 平台来跟踪，主要是想理清 dts 里的分区描述是如何一步步转化成内核分区行为。
先来看看 dts 中关于分区的描述：
palmbus@10000000 {
spi@b00 {
status = "okay";
m25p80@0 {
#address-cells = <1>;
#size-cells = <1>;
compatible = "w25q128";
reg = <0 0>;
linux,modalias = "m25p80", "w25q128";
spi-max-frequency = <10000000>;
partition@0 {
label = "u-boot";
reg = <0x0 0x30000>;
read-only;
};
partition@30000 {
label = "u-boot-env";
reg = <0x30000 0x10000>;
read-only;
};
factory: partition@40000 {
label = "factory";
reg = <0x40000 0x10000>;
read-only;
};
partition@50000 {
label = "firmware";
reg = <0x50000 0xfb0000>;
};
};
};
dts 描述的是一个树状结构。spi 控制器挂在 platform 总线上，spi flash (w25q128) 挂在 spi 总线上。 探测到 spi flash 的流程如下：
- plat_of_setup() 遍历 palmbus 上的设备，并为每一个动态创建 platform_device，添加到系统总线上 device_add()。对于 spi 这里会创建一个名为 "ralink,rt2880-spi" 的 platfrom_device 并添加到系统中。
- drivers/spi/spi-rt2880.c 中会注册 spi 的 platform_driver，与上一步的 platfrom_device match 上了之后，触发调用 rt2880_spi_probe() 。
- spi_register_master() 向系统注册 spi 主控制器，并最后调用 of_register_spi_devices(master) 看看 dts 中在 spi 总线上有哪些设备。
- 对 dts 中描述的每一个 spi 总线下的设备，为其创建相应的 spi_device，同时根据 dts 中描述的 reg, spi-cpha, spi-cpol, spi-cs-high, spi-3wire, spi-max-frequency 等属性来配置该 spi 设备。对于这里，创建了一个名为 “m25p80” 的 spi_device。
- drivers/mtd/device/m25p80.c 中有名为 “m25p80" 的 spi_driver，于是 match 上了。触发执行 m25p_probe()。
- m25p_probe() 中读到了这颗 spi flash 的 id 后，确认了一些基本信息（如页大小、块大小）, 最后调用 mtd_device_parse_register() 开始真正的分区。
分区解析器
part_parser 用来按照某种规则将分区信息解析出来。这些规则可以有很多，内核里调用 register_mtd_parser() 即可注册一个新的解析器。
drivers/mtd/mtdpart.c 中维护了一个链表 part_parsers，解析器按注册顺序添加到这个链表里。
parse_mtd_partitions() 中，如果未指定解析器的话，则默认只允许用 cmdlinepart, ofpart 两种解析器。对于我们这里，实际上起作用的是 ofpart。
static struct mtd_part_parser ofpart_parser = {
.owner = THIS_MODULE,
.parse_fn = parse_ofpart_partitions,
.name = "ofpart",
};
parse_ofpart_partitions() 遍历 dts 中 spi flash 设备下的分区描述信息，取出其中的 reg, label, name, read-only, lock 等信息以填充一个 struct mtd_partition 结构体。上面 dts 里描述了 4 个分区， 就有一个大小为 4 的 struct mtd_partition 数组，最后由 add_mtd_partitions() 添加为各 mtd 分区。
分区的情况可以待系统启动后在 /proc/mtd 文件中查看到。
# cat /proc/mtd
dev: size erasesize name
mtd0: 00030000 00010000 "u-boot"
mtd1: 00010000 00010000 "u-boot-env"
mtd2: 00010000 00010000 "factory"
mtd3: 00fb0000 00010000 "firmware"
mtd4: 00ea9283 00010000 "rootfs"
mtd5: 00b30000 00010000 "rootfs_data"
根文件系统的解析
上面 /proc/mtd 的内容中相比 dts 中的描述多了两个分区 rootfs, rootfs_data。这两个分区是何时添加的呢？
看看添加 mtd 分区的函数：
int add_mtd_partitions(struct mtd_info *master,
const struct mtd_partition *parts,
int nbparts)
{
struct mtd_part *slave;
uint64_t cur_offset = 0;
int i;
printk(KERN_NOTICE "Creating %d MTD partitions on \"%s\":\n", nbparts, master->name);
for (i = 0; i < nbparts; i++) {
slave = allocate_partition(master, parts + i, i, cur_offset);
if (IS_ERR(slave))
return PTR_ERR(slave);
mutex_lock(&mtd_partitions_mutex);
list_add(&slave->list, &mtd_partitions);
mutex_unlock(&mtd_partitions_mutex);
add_mtd_device(&slave->mtd);
mtd_partition_split(master, slave);
cur_offset = slave->offset + slave->mtd.size;
}
return 0;
}
最后调用了 mtd_partition_split()。
static void mtd_partition_split(struct mtd_info *master, struct mtd_part *part)
{
static int rootfs_found = 0;
if (rootfs_found)
return;
if (!strcmp(part->mtd.name, "rootfs")) {
rootfs_found = 1;
if (config_enabled(CONFIG_MTD_ROOTFS_SPLIT))
split_rootfs_data(master, part);
}
if (!strcmp(part->mtd.name, SPLIT_FIRMWARE_NAME) &&
config_enabled(CONFIG_MTD_SPLIT_FIRMWARE))
split_firmware(master, part);
arch_split_mtd_part(master, part->mtd.name, part->offset,
part->mtd.size);
}
如果：
- rootfs 还没有被找到
- 当前分区名是 "firmware"
- 内核配置时开启了 CONFIG_MTD_SPLIT_FIRMWARE
则调用 split_firmware() 来解析。在该函数中做了以下几件事：
- 找 type 为 MTD_PARSER_TYPE_FIRMWARE 的分区解析器来分析。
- "uimage-fw" 解析器读出 firmware 分区的头部，成功找到一个 uImage。
- 跃过 uImage，紧接着成功找到 squashfs 的头信息，于是找到了格式为 squashfs 的 rootfs。
- 解析器在找到一个分区后，会调用 __mtd_add_partition() 将此分区添加到系统中。
- __mtd_add_partition() 最后又调用 mtd_partition_split()，因为此时 rootfs 已经找到，所以会调用 split_rootfs_data() 找 rootfs_data 分区。
- rootfs 为 squashfs 分区，该格式的文件系统只读，且头信息里有标记分区大小。所以很容易就可以找到 rootfs_data 的起始位置。
