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 的起始位置。