Linux(28)-sysfs层次分析
宏观分析
sysfs 是一个纯粹基于 RAM 的内存文件系统。它将内核内存中抽象的设备模型数据结构,以直观的树状目录形式呈现给用户态。 根目录 /sys 下的各个子目录,分别映射了内核设备模型中的不同维度:
/sys/
├── devices/ # 核心:物理设备的真实级联拓扑树
├── bus/ # 维度一:按总线类型分类(pci, usb, i2c, platform...)
├── class/ # 维度二:按设备功能分类(net, block, sound, input...)
├── dev/ # 维度三:按设备号快速索引(char/, block/)
├── module/ # 视图四:内核已加载模块的状态与导出参数
└── firmware/ # 视图五:系统固件与设备树镜像 (devicetree/base/)
-
devices:它完全按照硬件真实的物理连接级联关系(如:CPU/根复合体 ➔ PCI 桥 ➔ 控制器 ➔ 设备)构建。sysfs 中其他目录下的硬件节点,绝大多数只是指向该目录具体节点的符号链接.
-
bus/(总线视角):按照总线协议划分子目录(如 pci、usb、i2c、platform)。每个总线目录下固定包含两个子目录
-
devices/:挂载在该总线上的所有设备(软链接至 /sys/devices/)
-
drivers/:在当前总线上注册的所有驱动程序。
-
-
class/(功能类视角):纯粹按设备的功能进行分类,如 net 网卡、sound 声卡、input 输入设备、block 块设备等
-
dev/(设备号快捷索引):包含 block/ 与 char/ 两个子目录,内部以 主设备号:次设备号(例如 8:0)命名的软链接快捷定位设备
-
module/(内核模块视图):展示系统中已加载的每一个内核模块(.ko)及其导出的参数(/sys/module/<mod_name>/parameters/)与运行状态。
-
firmware/(固件与引导视图):展示系统固件暴露的信息。其中最关键的节点是 /sys/firmware/devicetree/base/,它是 Bootloader 在启动阶段传入内核的设备树(Device Tree)二进制镜像在 sysfs 中的完全解包映射。
宏观例子
1.设备树(DTS)定义
以一个常见的 I2C 总线温度传感器(如 TMP102 / MPU6050 类型) 为例,拆解设备树节点从系统启动到最终被应用层使用的全过程。
&i2c1 {
status = "okay";
clock-frequency = <100000>;
/* 定义 I2C1 总线下的子设备:温度传感器 */
my_sensor: tmp102@48 {
compatible = "ti,tmp102"; /* 核心:与内核驱动进行匹配的标识 */
reg = <0x48>; /* I2C 从机设备地址 */
interrupt-parent = <&gpio1>; /* 中断控制器 */
interrupts = <20 IRQ_TYPE_EDGE_FALLING>; /* 中断引脚 GPIO1_20 */
};
};
2.内核启动与驱动加载过程
当内核启动并加载了对应的驱动程序(tmp102.ko)后,系统会自动在 sysfs 和 /dev 中进行多维度的映射建立
/sys/devices/:内核根据硬件真实的连接关系建立目录,这是传感器在系统中的唯一真实节点:
/sys/devices/platform/soc/30a20000.i2c/i2c-0/0-0048/
- 含义:SOC 平台 I2C 控制器(地址 0x30a20000) I2C 总线 0 地址为 0x48 的从设备。
/sys/bus/:传感器连接在 I2C 总线上,内核在 i2c 总线目录下生成软链接:
/sys/bus/i2c/devices/0-0048 -> ../../../devices/platform/soc/30a20000.i2c/i2c-0/0-0048
/sys/bus/i2c/drivers/tmp102/
- 含义:devices/ 下通过软链接映射该物理设备,drivers/tmp102/ 目录下展示匹配成功的驱动信息。
3.功能分类层:/sys/class/
驱动在 probe() 函数中将其注册为"硬件监控类(hwmon)"或"工业 IO 类(iio)",屏蔽总线细节:
/sys/class/hwmon/hwmon0 -> ../../devices/platform/soc/30a20000.i2c/i2c-0/0-0048/hwmon/hwmon0
- 含义:无论设备挂载在 I2C、SPI 还是 PCIe 上,应用层只需去 /sys/class/hwmon/寻找温度传感器。
4.设备号索引层:/sys/dev/
驱动程序为传感器申请了字符设备号(假设主设备号 241,次设备号 0):
/sys/dev/char/241:0 -> ../../devices/platform/soc/30a20000.i2c/i2c-0/0-0048/hwmon/hwmon0
- 含义:通过设备号快速查找和定位设备对应的物理节点。
**5.模块视图层:/sys/module/**加载了驱动模块 tmp102.ko 后:
/sys/module/tmp102/
├── parameters/ # 模块导出参数
├── refcnt # 引用计数
└── drivers/ # 绑定的驱动列表
6.应用层调用
设备加载完成后,应用层根据业务场景,通过 sysfs 或 字符设备节点 /dev 两种主要方式读写数据。
-
方式 1:通过 sysfs 属性读取(低频控制 / 查看状态)
-
传感器驱动在 /sys/class/hwmon/hwmon0/ 目录下创建了 temp1_input 文件(对应 struct attribute 的 show() 回调): Shell 命令行直接读取
$ cat /sys/class/hwmon/hwmon0/temp1_input
25000 # 代表 25.000 ℃(千分之一摄氏度单位)
-
cpp
#include <stdio.h>
int main() {
FILE *fp = fopen("/sys/class/hwmon/hwmon0/temp1_input", "r");
if (!fp) return -1;
int raw_temp = 0;
fscanf(fp, "%d", &raw_temp);
fclose(fp);
printf("当前温度为: %.2f ℃\n", raw_temp / 1000.0);
return 0;
}
- 方式 2:通过 /dev/ 设备节点读写(大流量数据 / 连续采样)如果驱动向系统注册了 /dev/temp_sensor0 字符设备节点:
cpp
#include <stdio.h>
#include <fcntl.h>
#include <unistd.h>
int main() {
// 1. 打开驱动生成的设备节点
int fd = open("/dev/temp_sensor0", O_RDONLY);
if (fd < 0) return -1;
// 2. 直接从设备读取原始数据流
short raw_data = 0;
read(fd, &raw_data, sizeof(raw_data));
close(fd);
printf("读取到的原始温度寄存器数值: 0x%04X\n", raw_data);
return 0;
}
微观分析
sysfs 严谨的树状目录,在内核 C 语言底层完全由统一设备模型的三大结构体(kobject、kset、attribute)驱动和支撑。

-
kobject:目录的物理实体struct kobject是 Linux 内核设备模型的基石,每个实例在sysfs中具象为一个目录。它通过parent指针构建树状层级,支撑设备拓扑;内置struct kref实现原子级引用计数,保障对象安全释放;其name字段直接决定该目录在sysfs中的路径名。 -
kset:目录容器与热插拔事件源struct kset作为逻辑容器,聚合同类kobject(如所有 PCI 设备或所有 USB 类设备),在sysfs中表现为分类目录(如/sys/bus/pci或/sys/class/net)。它不仅提供统一的注册/注销入口,更关键的是:当成员kobject动态增删时,kset触发uevent,向用户态广播事件,驱动udev自动同步/dev/下的设备节点。 -
attribute:目录中的文件与读写接口struct attribute映射为sysfs目录下的单值文本文件(如/sys/class/leds/xxx/brightness),严格遵循 One Value Per File 原则。其行为由struct sysfs_ops的两个回调定义:show()将内核数据序列化为字符串供cat读取;store()解析用户写入的字符串,完成参数更新或硬件控制,实现用户态与内核态的轻量交互。
微观例子
kobject 实现sysfs 的目录创建

如上图在sys 下是没办法手动创建任何文件夹因为没有权限,下面使用代码中的kobject 实现sys 下的目录创建。
cpp
#include <linux/init.h>
#include <linux/kobject.h>
#include <linux/module.h>
#include <linux/slab.h>
#include <linux/sysfs.h>
static struct kobject *demo_kobj;
static int demo_value;
/* 读取 /sys/study_demo/value 时会进这个回调 */
static ssize_t value_show(struct kobject *kobj, struct kobj_attribute *attr, char *buf)
{
return scnprintf(buf, PAGE_SIZE, "%d\n", demo_value);
}
/* 向 /sys/study_demo/value echo 123 > /sys/study_demo/value 写入数据时会进这个回调 */
static ssize_t value_store(struct kobject *kobj, struct kobj_attribute *attr,
const char *buf, size_t count)
{
int ret;
ret = kstrtoint(buf, 10, &demo_value);
if (ret)
return ret;
return count;
}
/* 创建一个可读写的 sysfs 属性节点 */
static struct kobj_attribute value_attr = __ATTR(value, 0664, value_show, value_store);
static int __init kobject_demo_init(void)
{
int ret;
/* 在 /sys 下创建 study_demo 目录 */
demo_kobj = kobject_create_and_add("study_demo", NULL);
if (!demo_kobj)
return -ENOMEM;
/* 在目录里创建 value 属性文件 */
ret = sysfs_create_file(demo_kobj, &value_attr.attr);
if (ret) {
kobject_put(demo_kobj);
return ret;
}
pr_info("kobject_demo loaded: /sys/study_demo/value\n");
return 0;
}
static void __exit kobject_demo_exit(void)
{
/* 卸载模块前清理 sysfs 节点和 kobject */
if (demo_kobj) {
sysfs_remove_file(demo_kobj, &value_attr.attr);
kobject_put(demo_kobj);
}
pr_info("kobject_demo unloaded\n");
}
module_init(kobject_demo_init);
module_exit(kobject_demo_exit);
MODULE_LICENSE("GPL");
MODULE_AUTHOR("Xiaoqian");
MODULE_DESCRIPTION("kobject demo for RK3568");

kset 实现目录容器
前面的 kobject 不也是可以实现多层目录结构么,kset 有什么特殊之处?
以内核设备模型中的 "网卡驱动(Network Devices)" 为例,对比单纯使用 kobject 和结合使用 kset 的区别:
如果只是使用kobject 构建目录结构
如果你想在 sysfs 中管理两张网卡 eth0 和 eth1,仅使用 kobject 时:
// 1. 手动创建一个父级目录 kobject
struct kobject *net_parent = kobject_create_and_add("net", NULL);
// 2. 创建 eth0,显式将 parent 指向 net_parent
struct kobject *eth0_obj = kobject_create_and_add("eth0", net_parent);
// 3. 创建 eth1,再次显式指定 net_parent
struct kobject *eth1_obj = kobject_create_and_add("eth1", net_parent);
目录结构结果:
/sys/net/
├── eth0
└── eth1
这种方式只是创建了一个节点,但是节点之间有什么关系并没有体现就会出现下面的问题
-
无法遍历:内核本身不知道 net_parent 下面到底有哪些子网卡,除非你在驱动里自己写套 eth0_node、eth1_node 链表来存储。
-
事件孤立:当 eth0 网线插入时,eth0_obj 无法直接通过父节点向用户态(如 NetworkManager)广播网卡状态改变的 uevent 消息。
如果用如果使用 kset 管理网卡集合:
// 1. 创建网卡子系统的 kset 容器
struct kset *net_kset = kset_create_and_add("net", NULL, NULL);
// 2. 创建 eth0 并关联到 net_kset
struct kobject *eth0_obj = kzalloc(sizeof(*eth0_obj), GFP_KERNEL);
eth0_obj->kset = net_kset; // 建立归属关系
kobject_init_and_add(eth0_obj, &net_ktype, NULL, "eth0"); // parent 传 NULL 即可
// 3. 创建 eth1 并关联到 net_kset
struct kobject *eth1_obj = kzalloc(sizeof(*eth1_obj), GFP_KERNEL);
eth1_obj->kset = net_kset;
kobject_init_and_add(eth1_obj, &net_ktype, NULL, "eth1");
目录结构结果:完全相同(/sys/net/eth0 和 /sys/net/eth1)不同的是:
-
内核内部自动将 eth0_obj 和 eth1_obj 挂载到 net_kset->list 链表上。当系统需要遍历所有网卡时,直接执行:
struct kobject *k;
list_for_each_entry(k, &net_kset->list, entry) {
// 一键遍历获取 eth0, eth1 并进行统一操作
} -
统一响应与广播热插拔事件(uevent)当 eth0 启动或断开时,直接调用:
kobject_uevent(eth0_obj, KOBJ_CHANGE);
-
eth0_obj 会通过其所属的 net_kset 统一的 uevent_ops 机制,向用户态发送广播,促使上层网络服务(如 udevd)响应事件并自动配置 IP 地址。
-
eth0 和 eth1 共享 net_kset 提供的公共 net_ktype。读取 eth0/speed 和 eth1/speed 时,内核统一调用同一套 show/store 函数处理,实现代码复用。
cpp
#include <linux/module.h>
#include <linux/kernel.h>
#include <linux/init.h>
#include <linux/kobject.h>
#include <linux/sysfs.h>
#include <linux/slab.h>
#include <linux/list.h>
MODULE_LICENSE("GPL");
MODULE_AUTHOR("Xiaoqian");
MODULE_DESCRIPTION("A simple kernel module demonstrating kset traversal over its kobjects");
static struct kset *my_kset;
static struct kobject *kobj1;
static struct kobject *kobj2;
static int __init traverse_demo_init(void)
{
int ret;
struct kobject *entry;
/* 1. 创建顶层 kset 容器目录:/sys/my_network_kset/ */
my_kset = kset_create_and_add("my_network_kset", NULL, NULL);
if (!my_kset)
return -ENOMEM;
/* 2. 创建并注册第一个子 kobject (eth0) */
kobj1 = kzalloc(sizeof(*kobj1), GFP_KERNEL);
if (!kobj1) {
ret = -ENOMEM;
goto err_kset;
}
kobj1->kset = my_kset; /* 绑定归属关系 */
ret = kobject_init_and_add(kobj1, &dynamic_kobj_ktype, NULL, "eth0");
if (ret) {
kobject_put(kobj1);
goto err_kset;
}
/* 3. 创建并注册第二个子 kobject (eth1) */
kobj2 = kzalloc(sizeof(*kobj2), GFP_KERNEL);
if (!kobj2) {
ret = -ENOMEM;
goto err_kobj1;
}
kobj2->kset = my_kset; /* 绑定归属关系 */
ret = kobject_init_and_add(kobj2, &dynamic_kobj_ktype, NULL, "eth1");
if (ret) {
kobject_put(kobj2);
goto err_kobj1;
}
/* 4. 【核心展示】:通过 kset 的内部链表遍历所有归属的 kobject */
pr_info("--- Traversal started for kset: %s ---\n", kobject_name(&my_kset->kobj));
/* 互斥锁保护,防止链表在遍历时被动态修改 */
spin_lock(&my_kset->list_lock);
list_for_each_entry(entry, &my_kset->list, entry) {
pr_info("Found kobject: %s (Path: %s)\n",
kobject_name(entry), kobject_get_path(entry, GFP_ATOMIC));
}
spin_unlock(&my_kset->list_lock);
pr_info("--- Traversal completed ---\n");
return 0;
err_kobj1:
kobject_put(kobj1);
err_kset:
kset_unregister(my_kset);
return ret;
}
static void __exit traverse_demo_exit(void)
{
/* 清理释放子 kobject 及 kset */
kobject_put(kobj2);
kobject_put(kobj1);
kset_unregister(my_kset);
pr_info("Module unloaded\n");
}
module_init(traverse_demo_init);
module_exit(traverse_demo_exit);
attribute 实现
下面以一个真实的 LED 亮度控制驱动 为例,拆解 struct attribute、struct sysfs_ops 以及 show() / store() 回调在用户态与内核态交互时的具体工作流程。
- 定义数据结构与属性文件
cpp
#include <linux/module.h>
#include <linux/kobject.h>
#include <linux/sysfs.h>
/* 定义设备私有数据结构体 */
struct led_device {
int brightness; /* 记录当前 LED 亮度值 (0-255) */
struct kobject kobj; /* 内嵌 kobject 关联 sysfs 目录 */
};
/* 自定义属性结构体,继承标准的 struct attribute */
struct led_attribute {
struct attribute attr;
ssize_t (*show)(struct led_device *dev, char *buf);
ssize_t (*store)(struct led_device *dev, const char *buf, size_t count);
};
- 2.实现 show() 与 store() 回调
cpp
/* 1. show 回调:响应用户态 cat /sys/demo_led/brightness */
static ssize_t led_brightness_show(struct led_device *dev, char *buf)
{
// 将内核中的 brightness 数值序列化为文本字符串输出
return sysfs_emit(buf, "%d\n", dev->brightness);
}
/* 2. store 回调:响应用户态 echo 128 > /sys/demo_led/brightness */
static ssize_t led_brightness_store(struct led_device *dev, const char *buf, size_t count)
{
int val, ret;
// 解析用户态传入的字符串为整数
ret = kstrtoint(buf, 10, &val);
if (ret < 0)
return ret;
// 参数范围检查
if (val < 0 || val > 255)
return -EINVAL;
// 更新内核状态并模拟控制硬件
dev->brightness = val;
pr_info("[LED Driver] Hardware PWM updated to brightness: %d\n", val);
return count; // 返回写入的字节数,告知内核写入成功
}
/* 实例化属性文件:生成名为 "brightness" 的属性,权限为 0664 (可读写) */
static struct led_attribute brightness_attr = {
.attr = {
.name = "brightness",
.mode = 0664,
},
.show = led_brightness_show,
.store = led_brightness_store,
};
brightness_attr 目前只是被定义和初始化了,但还没有真正"生效"或"注册"到 sysfs 中。
要让它真正出现在 /sys/.../brightness 并响应用户操作,你需要在模块初始化函数(__init)中将其添加到对应的 kobject 上。
以下是 brightness_attr 被用到的具体位置和方式:
1. 在模块初始化时注册(关键步骤)
你需要在 kobject 创建成功后,调用 sysfs_create_file() 将这个属性文件绑定到该 kobject 代表的目录上。
假设你有一个全局的 struct led_device *my_led_dev,并且它的 kobj 已经通过 kobject_init_and_add 创建好了目录(例如 /sys/demo_led),代码如下:
cpp
static struct led_device *my_led_dev;
static int __init led_demo_init(void)
{
int ret;
// 1. 分配内存
my_led_dev = kzalloc(sizeof(*my_led_dev), GFP_KERNEL);
if (!my_led_dev)
return -ENOMEM;
// 2. 初始化 kobject 并添加到 sysfs (创建 /sys/demo_led 目录)
// 注意:这里需要指定 kobj_type,其中包含 sysfs_ops
ret = kobject_init_and_add(&my_led_dev->kobj, &led_ktype, NULL, "demo_led");
if (ret) {
kfree(my_led_dev);
return ret;
}
// 3. 【这里是用到 brightness_attr 的地方】
// 将 brightness_attr 中的 attribute 成员注册到 kobject 下
// 这会在 /sys/demo_led/ 下创建一个名为 "brightness" 的文件
ret = sysfs_create_file(&my_led_dev->kobj, &brightness_attr.attr);
if (ret) {
kobject_put(&my_led_dev->kobj);
kfree(my_led_dev);
return ret;
}
pr_info("LED demo module loaded\n");
return 0;
}
2. 在模块退出时卸载
为了保持内核整洁,防止内存泄漏或悬空指针,在模块卸载时必须移除该属性文件。
cpp
static void __exit led_demo_exit(void)
{
if (my_led_dev) {
// 【这里也是用到 brightness_attr 的地方】
// 从 sysfs 中移除 brightness 文件
sysfs_remove_file(&my_led_dev->kobj, &brightness_attr.attr);
// 释放 kobject 引用
kobject_put(&my_led_dev->kobj);
// 释放内存
kfree(my_led_dev);
}
pr_info("LED demo module unloaded\n");
}
3. 底层回调机制中的间接使用
虽然代码中没有直接写 brightness_attr.show(),但当用户空间执行操作时,内核会间接使用它:
-
用户读取时 (
cat /sys/demo_led/brightness):- VFS 层找到该文件对应的
attribute结构体(即brightness_attr.attr)。 - 通过之前定义的
led_ktype中的sysfs_ops(led_attr_show) 进行分发。 led_attr_show内部通过container_of找到brightness_attr,从而调用你写的led_brightness_show。
- VFS 层找到该文件对应的
-
用户写入时 (
echo 128 > ...):- 同理,内核通过
led_attr_store分发,最终调用brightness_attr.store指向的led_brightness_store函数。
- 同理,内核通过
总结
brightness_attr 主要在以下两个地方被显式调用:
- **
sysfs_create_file(&dev->kobj, &brightness_attr.attr)**:用于创建文件节点。 - **
sysfs_remove_file(&dev->kobj, &brightness_attr.attr)**:用于删除文件节点。
而在运行时,它的 .show 和 .store 函数指针会被内核的 sysfs 核心代码间接调用,以处理具体的读写请求。
-
- 绑定 sysfs_ops 桥接函数sysfs_ops 是连接通用 kobject 与驱动具体属性的桥梁
cpp
/* sysfs 操作接口的通用分发函数 */
static ssize_t led_attr_show(struct kobject *kobj, struct attribute *attr, char *buf)
{
// 通过 container_of 获取外层结构体指针
struct led_device *dev = container_of(kobj, struct led_device, kobj);
struct led_attribute *led_attr = container_of(attr, struct led_attribute, attr);
if (led_attr->show)
return led_attr->show(dev, buf);
return -EIO;
}
static ssize_t led_attr_store(struct kobject *kobj, struct attribute *attr, const char *buf, size_t count)
{
struct led_device *dev = container_of(kobj, struct led_device, kobj);
struct led_attribute *led_attr = container_of(attr, struct led_attribute, attr);
if (led_attr->store)
return led_attr->store(dev, buf, count);
return -EIO;
}
/* 定义系统的 sysfs_ops */
static const struct sysfs_ops led_sysfs_ops = {
.show = led_attr_show,
.store = led_attr_store,
};
static struct kobj_type led_ktype = {
.sysfs_ops = &led_sysfs_ops,
};
执行交互过程分析
场景 1:读取属性(用户态执行 cat /sys/demo_led/brightness)

场景 2:写入控制(用户态执行 echo 200 > /sys/demo_led/brightness)


阅读 121
留言
写留言
还没有留言,来写首评

小嵌同学
赞
17
1
写留言

复制转发划线推荐写评论搜一搜
复制搜一搜
暂无评论