1. 项目概述一次对Linux内核“家底”的深度盘点在Linux内核开发的日常工作中无论是为一块新的开发板适配驱动还是排查一个诡异的硬件初始化问题我们常常会面临一个基础却又关键的问题当前系统里到底有哪些“平台设备”正在运行这里的“平台设备”指的就是那些通过platform_device机制管理的、通常与特定SoC片上系统或开发板紧密绑定的硬件资源比如GPIO控制器、I2C总线、SPI控制器、定时器、DMA引擎等等。它们不像PCI、USB设备那样有标准的枚举机制其存在和配置信息往往“写死”在内核的设备树Device Tree或早期的板级文件Board File里。因此搞清楚“Linux内核中现存的所有platform_device”就像是为整个系统的硬件基石做一次全面的“资产盘点”这对于驱动开发者、系统移植工程师和内核调试者来说是一项极具价值的底层探索。这个项目的目的就是系统地梳理和展示如何在内核运行时动态地、全面地列举出所有的platform_device实例。这不仅仅是调用一个现成的API那么简单它涉及到对platform总线模型、内核设备模型Device Model以及相关数据结构的深入理解。通过这次探索你不仅能获得一份清晰的设备清单更能透彻理解这些设备是如何被内核组织和管理起来的为后续的驱动开发、问题定位和性能优化打下坚实的基础。无论你是刚接触Linux驱动的新手还是希望深化内核理解的老手这次“盘点”之旅都将让你对系统的硬件抽象层有全新的认识。2. 平台设备模型核心原理与数据结构探秘要列举所有platform_device我们必须先理解它在内核中的“户口”是如何登记的以及它被存放在哪个“花名册”里。这一切都围绕着Linux内核强大的设备模型展开。2.1 Platform Bus与设备模型的基石Linux内核为了统一管理五花八门的硬件设备抽象出了一套设备模型。其核心是总线Bus、设备Device和驱动Driver的三角关系。platform是一种虚拟总线用于连接那些不具备传统总线如PCI枚举能力的“平台设备”和对应的“平台驱动”。struct platform_device 描述一个平台设备。它内嵌了一个标准的struct device用于接入设备模型。其关键成员包括name: 设备名称用于与驱动匹配。id: 设备ID用于区分同名设备。resource: 指向该设备所占用的硬件资源如内存地址、中断号数组。num_resources: 资源数量。dev.of_node: 如果使用设备树这里指向对应的设备树节点。driver_override: 可强制指定绑定的驱动名。struct bus_type platform_bus_type 这就是platform虚拟总线本身。它是所有平台设备和平台驱动的“管理者”。其最重要的一个职责是维护两个核心链表p-klist_devices: 内核链表链接了所有已注册到这条总线上的设备即platform_device。p-klist_drivers: 内核链表链接了所有已注册到这条总线上的驱动即platform_driver。我们的目标——列举所有platform_device——其数据源头正是platform_bus_type.klist_devices这个链表。内核通过platform_device_register()函数将一个新的platform_device添加到这个链表中。2.2 设备树Device Tree与平台设备的创建在现代ARM等架构的Linux内核中platform_device的创建主要来源于设备树DT。系统启动时内核的OFOpen Firmware核心会解析传递给它的DT Blob。DT匹配与创建 内核会根据设备树中compatible属性等规则调用相应的“机器描述”代码或内置的of_platform代码为设备树中定义的节点动态生成对应的platform_device。资源转换 设备树节点中的reg内存区域、interrupts中断等属性会被解析并填充到platform_device.resource数组中。注册 生成的platform_device最终通过platform_device_register()或of_platform_populate()等API注册到platform_bus_type上。因此最终我们看到的platform_device列表是设备树描述的系统硬件资源的直接运行时映射。理解这一点就能明白为什么列举这些设备对于验证设备树是否正确生效至关重要。注意 除了设备树旧式的“板级文件”Board File中通过platform_device_register()直接注册的设备依然可以工作但在新项目中设备树是首选和标准方式。3. 动态列举Platform Device的多种实战方法掌握了原理我们就可以动手“盘点”了。下面介绍几种从用户空间和内核空间进行列举的实用方法各有其适用场景。3.1 用户空间视角通过Sysfs文件系统这是最直接、最常用的方法无需编写内核代码。Linux设备模型将内核对象导出到用户空间形成了/sys文件系统。操作路径与步骤所有注册到platform总线的设备都会在/sys/bus/platform/devices/目录下有一个以设备名命名的子目录例如/sys/bus/platform/devices/10000000.serial。列出所有设备ls /sys/bus/platform/devices/这条命令会直接列出所有platform_device对应的目录名。这些目录名通常就是设备的platform_device.name对于设备树来源的设备名字通常由节点地址和节点名组成如1c28000.mmc。查看单个设备的详细信息 进入任意一个设备目录你可以查看其众多属性文件。# 查看设备驱动绑定的驱动名 cat /sys/bus/platform/devices/1c28000.mmc/driver/module/name # 查看设备树节点路径如果来源于设备树 cat /sys/bus/platform/devices/1c28000.mmc/of_node/name # 查看设备的物理资源如地址 cat /sys/bus/platform/devices/1c28000.mmc/resource # 查看设备的uevent信息包含主要设备号等 cat /sys/bus/platform/devices/1c28000.mmc/uevent使用udevadm工具进行高级查询udevadm是管理设备事件的强大工具可以格式化输出更清晰的信息。# 列出所有platform设备并显示其sysfs路径和驱动 udevadm info -a -p /sys/bus/platform/devices/1c28000.mmc | less # 或者使用find和udevadm组合 find /sys/bus/platform/devices/ -name “*” -exec udevadm info -q property {} \;实操心得/sys/bus/platform/devices/下的列表是最权威的运行时设备清单。如果设备树中定义了一个节点但这里没有出现通常意味着内核的OF代码没有成功为其创建platform_device需要检查设备树节点的status属性是否为“okay”或者compatible属性是否被内核支持。通过对比/sys/firmware/devicetree/base/下的设备树节点可以验证DT到platform_device的转换是否完整。3.2 内核模块视角遍历总线设备链表如果你需要在内核驱动或模块中编程获取设备列表或者需要更灵活地处理设备信息直接遍历内核链表是最强大的方式。编写一个内核模块示例#include linux/init.h #include linux/module.h #include linux/platform_device.h #include linux/device.h static int __init list_platform_devices_init(void) { struct device *dev; struct platform_device *pdev; pr_info(“开始遍历所有已注册的platform设备\n”); // 方法遍历platform总线上的每一个设备 // bus_for_each_dev()是一个辅助宏用于遍历指定总线上的所有设备 bus_for_each_dev(platform_bus_type, NULL, NULL, [](struct device *dev, void *data) - int { pdev to_platform_device(dev); pr_info(“设备名: %s, 设备ID: %d\n”, pdev-name, pdev-id); // 可以进一步打印资源信息 // for (i 0; i pdev-num_resources; i) { // pr_info(“ 资源%d: 起始 0x%llx, 大小 %llu\n”, i, // pdev-resource[i].start, // resource_size(pdev-resource[i])); // } return 0; // 返回0继续遍历 }); pr_info(“遍历结束。\n”); return 0; } static void __exit list_platform_devices_exit(void) { pr_info(“模块卸载。\n”); } module_init(list_platform_devices_init); module_exit(list_platform_devices_exit); MODULE_LICENSE(“GPL”); MODULE_AUTHOR(“Your Name”); MODULE_DESCRIPTION(“List all platform devices”);代码解析与注意事项头文件linux/platform_device.h和linux/device.h是必须的。bus_for_each_dev宏这是遍历总线上所有设备的标准方法。它接受一个回调函数对每个设备调用一次。这里使用了C11风格的lambda表达式需要内核配置支持CONFIG_CC_HAS_AUTO等在纯C环境中你需要定义一个独立的静态函数作为回调。to_platform_device宏将通用的struct device*安全地转换回struct platform_device*。资源访问注释掉的循环展示了如何访问设备的硬件资源内存/IO区域、中断等。这在调试资源冲突时非常有用。并发安全bus_for_each_dev在遍历时持有总线的读锁bus-subsys.rwsem因此遍历期间设备列表是稳定的。但请注意不要在回调函数中进行可能导致睡眠或长时间持有的操作以免影响系统性能或造成死锁。模块安全确保你的模块编译配置正确并且目标内核支持模块功能。在生产环境使用前务必在测试系统上验证。3.3 调试工具视角使用/proc接口与内核调试器对于更底层的调试还有一些特殊方法。/proc/device-tree 这个虚拟文件系统以目录结构呈现了内核解析后的设备树。你可以通过它查看原始的DT节点信息与/sys/bus/platform/devices/下的设备进行对照。find /proc/device-tree -name “compatible” -exec cat {} \;内核调试器KGDB/KDB 在极端调试场景下如果系统已经挂起可以通过内核调试器直接检查内核数据结构。在KDB中你可以尝试查看platform_bus_type的地址然后手动遍历链表。但这需要深厚的内核内存布局知识和调试技巧一般不推荐普通开发者使用。方法对比与选型建议方法适用场景优点缺点Sysfs (/sys) 查询日常开发、快速验证、脚本化检查无需编码安全信息直观可脚本化信息分散需要解析多个文件无法编程处理复杂逻辑内核模块遍历驱动开发、内核调试、需要编程处理设备信息功能最强大可获取所有内部数据可集成到自定义工具中需要编写、编译、加载模块有潜在风险需要内核知识/proc与调试器深度调试、设备树问题排查、系统崩溃分析提供最原始数据可用于诊断复杂问题使用复杂信息可读性差风险高对于绝大多数情况使用/sys/bus/platform/devices/目录进行查看和脚本处理已经足够。编写内核模块的方法则适用于当你需要在内核层面自动执行某些基于设备列表的操作时。4. 从设备列表到深度分析典型应用场景与问题排查仅仅列出设备名只是第一步。真正的价值在于如何利用这份清单去解决实际问题。4.1 场景一验证设备树配置的正确性这是最常见的用途。你修改了设备树.dts文件编译成.dtb并加载到板子上如何确认内核真的识别并创建了你想要的设备排查步骤检查设备是否存在 在目标系统上执行ls /sys/bus/platform/devices/查看目标设备如fe201000.spi是否出现在列表中。检查驱动绑定 如果设备存在进入其目录查看是否有driver符号链接。如果有说明驱动已成功匹配并绑定。如果没有可能原因有对应的platform_driver未编译进内核或未加载。驱动和设备的compatible字符串不匹配。驱动探测probe函数失败。对比设备树源 使用dtc工具反编译/sys/firmware/fdt如果支持或直接查看你的.dts源文件确认节点定义无误特别是reg、interrupts、clocks等关键属性。检查内核启动日志dmesg | grep -i “fe201000.spi”或dmesg | grep -i “spi”查看内核在初始化阶段是否有关于该设备的成功或错误日志。4.2 场景二诊断驱动绑定失败与资源冲突当某个外设如I2C触摸屏无法工作时设备列表是重要的切入点。排查流程确认设备已注册 首先在/sys/bus/platform/devices/下找到对应的设备目录。如果找不到回到场景一进行排查。确认驱动已注册 在/sys/bus/platform/drivers/下查看对应的驱动目录是否存在。例如对于at24EEPROM驱动可以看/sys/bus/platform/drivers/at24/是否存在。检查绑定状态 进入设备目录检查driver链接。如果未绑定尝试手动绑定需要驱动支持echo -n “fe201000.spi” /sys/bus/platform/drivers/your_spi_driver/bind观察dmesg输出通常会打印出详细的失败原因如“probe failed with error -16”这通常是资源冲突如IRQ已被占用或设备初始化失败。分析资源冲突 如果怀疑是内存或中断冲突可以通过内核模块遍历的方法见3.2节打印出所有platform_device的资源信息进行交叉对比。更直接的方法是查看/proc/iomem和/proc/interrupts确认设备声明的资源是否被其他设备占用。4.3 场景三系统裁剪与优化参考在嵌入式产品开发中系统资源内存、ROM往往非常紧张。一份完整的platform_device列表可以帮助你进行精准的裁剪。识别未使用的设备 遍历列表对于每个设备检查其driver是否绑定。如果一个设备始终没有驱动绑定且产品功能不需要它那么可以考虑在设备树中将其status设置为“disabled”。在内核配置中不编译对应的驱动支持。这可以减少内核镜像大小并缩短内核启动时遍历和初始化设备的时间。分析初始化顺序 内核在启动时会按顺序初始化platform_device。通过分析列表和dmesg日志你可以了解设备初始化的耗时情况。对于非关键的、耗时的设备初始化如某些PHY可以考虑将其驱动改为模块在需要时动态加载以加快启动速度。实操心得手动绑定/解绑驱动是一个强大的调试功能但并非所有驱动都完美支持。有些驱动在probe失败后可能无法正确处理bind/unbind。资源冲突的日志有时比较隐晦。除了-16 (-EBUSY)错误-12 (-ENOMEM)也可能是devm_ioremap_resource()失败其根本原因是资源冲突。仔细核对/proc/iomem是关键。在裁剪系统时务必进行全面的功能测试。有些设备虽然主功能不用但可能被其他驱动或子系统间接依赖例如一个未使用的I2C控制器所在的时钟、电源域可能影响其他设备。5. 进阶技巧编写脚本自动化分析与监控将上述手动操作脚本化可以极大提升效率并实现持续监控。5.1 基础信息收集脚本下面是一个简单的Bash脚本示例用于收集所有platform_device的基本信息并生成报告。#!/bin/bash # list_platform_devices.sh REPORT_FILE“platform_devices_report_$(date %Y%m%d_%H%M%S).txt” echo “ Linux Platform Devices Inventory Report ” $REPORT_FILE echo “Generated on: $(date)” $REPORT_FILE echo “” $REPORT_FILE echo “” $REPORT_FILE for dev_dir in /sys/bus/platform/devices/*; do if [ -d “$dev_dir” ]; then dev_name$(basename “$dev_dir”) echo “设备: $dev_name” $REPORT_FILE echo “-----------------------------------” $REPORT_FILE # 检查驱动绑定 if [ -L “$dev_dir/driver” ]; then driver_name$(basename $(readlink “$dev_dir/driver”)) echo “ 绑定驱动: $driver_name” $REPORT_FILE else echo “ 绑定驱动: (无)” $REPORT_FILE fi # 检查设备树节点 if [ -d “$dev_dir/of_node” ]; then # 尝试获取compatible属性 if [ -f “$dev_dir/of_node/compatible” ]; then echo “ 设备树兼容性: $(cat $dev_dir/of_node/compatible)” $REPORT_FILE fi fi # 获取uevent信息中的主要信息 if [ -f “$dev_dir/uevent” ]; then echo “ Uevent信息:” $REPORT_FILE grep -E “^(DRIVER|MODALIAS|MAJOR)” “$dev_dir/uevent” | sed ‘s/^/ /’ $REPORT_FILE fi echo “” $REPORT_FILE fi done echo “报告已生成: $REPORT_FILE”这个脚本会遍历所有设备记录名称、绑定驱动、设备树兼容性等关键信息输出到一个带时间戳的文本文件中。5.2 监控设备动态注册与注销在某些调试场景你可能需要知道设备是何时被注册或注销的。这可以通过内核的动态调试Dynamic Debug或事件跟踪Trace Events来实现。使用动态调试跟踪platform_device_register# 首先确保内核配置了CONFIG_DYNAMIC_DEBUG # 打开platform_device_register相关函数的动态打印 echo ‘file drivers/base/platform.c p’ /sys/kernel/debug/dynamic_debug/control echo ‘func platform_device_register p’ /sys/kernel/debug/dynamic_debug/control # 然后重新加载你的模块或触发设备注册dmesg中就会显示详细的调用信息。使用Trace Events更高效 Linux内核为许多关键操作提供了tracepoint。platform相关的事件可能在/sys/kernel/debug/tracing/events/platform/下。# 查看可用的platform事件 ls /sys/kernel/debug/tracing/events/platform/ # 启用‘platform_device_add’事件 echo 1 /sys/kernel/debug/tracing/events/platform/platform_device_add/enable # 开始追踪 echo 1 /sys/kernel/debug/tracing/tracing_on # ... 执行你的操作 ... # 停止并查看 echo 0 /sys/kernel/debug/tracing/tracing_on cat /sys/kernel/debug/tracing/trace跟踪事件对系统性能影响极小可以长时间开启是监控设备热插拔或模块加载/卸载导致设备变更的利器。5.3 集成到CI/CD流程在持续集成环境中你可以在每次构建并烧写新镜像到测试板后自动运行上述信息收集脚本将生成的报告与一个“黄金参考报告”进行对比。利用diff工具可以自动检测出是否有预期的设备丢失设备树配置错误是否有多余的设备出现内核配置或设备树包含错误是否有设备的驱动绑定状态发生改变驱动兼容性问题这种自动化检查能在早期发现因内核配置或设备树修改引入的回归问题保证硬件基础层的稳定性。踩过的坑脚本中读取/sys文件系统时要注意某些文件可能以换行符结尾使用cat或$(file)时用tr -d ‘\n’处理一下会更干净。动态调试会生成大量日志在生产环境或性能敏感的场景中谨慎使用并记得事后关闭echo ‘file drivers/base/platform.c -p’ …。Trace events的路径和可用性取决于内核配置CONFIG_FTRACE和CONFIG_PLATFORM_TRACER等在编写自动化脚本前需先确认目标内核是否支持。