ABI 测试符号

文档描述了被认为是稳定的接口，因为该接口的主要开发已完成。

可以更改接口以添加新功能，但除非在其中发现严重错误或安全问题，否则当前接口不会因此而中断。

用户空间程序可以开始依赖这些接口，但他们必须意识到在这些接口被标记为稳定之前可能发生的更改。

强烈建议使用这些接口的程序将其名称添加到这些接口的描述中，以便内核开发人员在发生任何更改时可以轻松通知他们。

.../XXXXXXX.ipa/endpoint_id/

.../XXXXXXX.ipa/endpoint_id/

定义在文件 sysfs-devices-platform-soc-ipa 中

.../XXXXXXX.ipa/endpoint_id/ 目录包含定义与 IPA 端点关联的 ID 的属性。端点名称中的 “rx” 或 “tx” 是从 AP 的角度来看的。端点 ID 是一个小型的无符号整数。

.../XXXXXXX.ipa/endpoint_id/modem_rx

.../XXXXXXX.ipa/endpoint_id/modem_rx

定义在文件 sysfs-devices-platform-soc-ipa 中

.../XXXXXXX.ipa/endpoint_id/modem_rx 文件包含接收来自嵌入式调制解调器的数据包的 AP 端点的 ID。

.../XXXXXXX.ipa/endpoint_id/modem_tx

.../XXXXXXX.ipa/endpoint_id/modem_tx

定义在文件 sysfs-devices-platform-soc-ipa 中

.../XXXXXXX.ipa/endpoint_id/modem_tx 文件包含发送到嵌入式调制解调器的数据包所使用的 AP 端点的 ID。

.../XXXXXXX.ipa/endpoint_id/monitor_rx

.../XXXXXXX.ipa/endpoint_id/monitor_rx

定义在文件 sysfs-devices-platform-soc-ipa 中

.../XXXXXXX.ipa/endpoint_id/monitor_rx 文件包含接收 IPA “监视器” 数据的 AP 端点的 ID。监视器端点提供进入 IPA 硬件进行处理的数据包副本。每个复制的数据包都以固定大小的“ODL”标头开头（请参见上面的 .../XXXXXXX.ipa/feature/monitor）。大型数据包会被截断，以减少提供监视器功能所需的带宽。

.../XXXXXXX.ipa/feature/

.../XXXXXXX.ipa/feature/

定义在文件 sysfs-devices-platform-soc-ipa 中

.../XXXXXXX.ipa/feature/ 目录包含一组描述 IPA 硬件实现的功能的属性。

.../XXXXXXX.ipa/feature/rx_offload

.../XXXXXXX.ipa/feature/rx_offload

定义在文件 sysfs-devices-platform-soc-ipa 中

.../XXXXXXX.ipa/feature/rx_offload 文件包含一个字符串，指示硬件支持的接收校验和卸载的类型。可能的值为 “MAPv4” 或 “MAPv5”。

.../XXXXXXX.ipa/feature/tx_offload

.../XXXXXXX.ipa/feature/tx_offload

定义在文件 sysfs-devices-platform-soc-ipa 中

.../XXXXXXX.ipa/feature/tx_offload 文件包含一个字符串，指示硬件支持的发送校验和卸载的类型。可能的值为 “MAPv4” 或 “MAPv5”。

.../XXXXXXX.ipa/modem/

.../XXXXXXX.ipa/modem/

定义在文件 sysfs-devices-platform-soc-ipa 中

.../XXXXXXX.ipa/modem/ 目录包含描述 SoC 中嵌入的调制解调器的属性。

.../XXXXXXX.ipa/modem/rx_endpoint_id

.../XXXXXXX.ipa/modem/rx_endpoint_id

定义在文件 sysfs-devices-platform-soc-ipa 中

.../XXXXXXX.ipa/modem/rx_endpoint_id 文件复制了 .../XXXXXXX.ipa/endpoint_id/modem_rx 中找到的值。

.../XXXXXXX.ipa/modem/tx_endpoint_id

.../XXXXXXX.ipa/modem/tx_endpoint_id

定义在文件 sysfs-devices-platform-soc-ipa 中

.../XXXXXXX.ipa/modem/tx_endpoint_id 文件复制了 .../XXXXXXX.ipa/endpoint_id/modem_tx 中找到的值。

.../XXXXXXX.ipa/version

.../XXXXXXX.ipa/version

定义在文件 sysfs-devices-platform-soc-ipa 中

.../XXXXXXX.ipa/version 文件包含 IPA 硬件版本，作为一组用句点分隔的两个或三个整数（例如，“3.5.1” 或 “4.2”）。

/config/acpi 下的符号

/config/acpi

定义在文件 configfs-acpi 中

这表示 ACPI 子系统的入口点目录。它包含与 ACPI 可配置选项对应的子组。

/config/acpi/table

定义在文件 configfs-acpi 中

此组包含用户定义的 ACPI 表的配置。用户定义表的属性如下：

aml

  • 一个二进制属性，用户可以使用它来填充 ACPI aml 定义。一旦 aml 数据被写入此文件并关闭该文件，表将被加载并且 ACPI 设备将被枚举。要检查操作是否成功，用户必须检查 close() 的错误代码。如果操作成功，则后续写入此属性将失败。

其余属性是只读的，并且只有在通过填充 aml 条目加载表后才有效。

signature

  • ASCII 表签名

length

  • 表的长度（以字节为单位），包括头部

revision

  • ACPI 规范次版本号

oem_id

  • ASCII OEM 标识

oem_table_id

  • ASCII OEM 表标识

oem_revision

  • OEM 修订号

asl_compiler_id

  • ASCII ASL 编译器供应商 ID

asl_compiler_revision

  • ASL 编译器版本

/config/iio 下的符号

/config/iio

定义在文件 configfs-iio 中

这表示工业 IO 配置入口点目录。它包含与 IIO 对象对应的子组。

/config/iio/devices

定义在文件 configfs-iio 中

工业 IO 软件设备目录。

/config/iio/devices/dummy

定义在文件 configfs-iio 中

虚拟 IIO 设备目录。在此处创建目录将导致在 IIO 子系统中创建虚拟 IIO 设备。

/config/iio/triggers

定义在文件 configfs-iio 中

工业 IO 软件触发器目录。

/config/iio/triggers/hrtimers

定义在文件 configfs-iio 中

高分辨率定时器目录。在此处创建目录将导致在 IIO 子系统中创建 hrtimer 触发器。

/config/pcie-gadget 下的符号

/config/pcie-gadget

定义在文件 configfs-spear-pcie-gadget 中

该接口用于将选定的双模 PCIe 控制器配置为设备，然后对其各种寄存器进行编程，以将其配置为特定的设备类型。此接口可用于显示 spear 的 PCIe 设备功能。

节点仅在挂载 configfs 时可见。要在 /config 目录中挂载 configfs，请使用

# mount -t configfs none /config/

对于第 n 个 PCIe 设备控制器 /config/pcie-gadget.n/

link

用于启用 ltssm 并读取其状态。

int_type

用于配置和读取支持的中断类型

no_of_msi

用于配置所需的 MSI 向量数量并读取授予的 MSI 数量。

inta

写入 1 以断言 INTA，写入 0 以取消断言。

send_msi

写入要发送的 MSI 向量。

vendor_id

用于写入和读取供应商 ID (十六进制)

device_id

用于写入和读取设备 ID (十六进制)

bar0_size

用于写入和读取 bar0_size

bar0_address

用于写入和读取 bar0 映射区域（十六进制）。

bar0_rw_offset

用于写入和读取将写入或读取 bar0_data 的 bar0 偏移量。

bar0_data

用于在 bar0_rw_offset 处写入和读取数据。

/config/rdma_cm 下的符号

/config/rdma_cm

定义在文件 configfs-rdma_cm 中

该接口用于配置关于 RDMA-CM 属性的 RDMA 电缆 HCA。

属性仅在挂载 configfs 时可见。要在 /config 目录中挂载 configfs，请使用：# mount -t configfs none /config/

为了设置与特定 HCA 相关的参数，必须为此 HCA 创建一个目录：mkdir -p /config/rdma_cm/<hca>

/config/rdma_cm/<hca>/ports/<port-num>/default_roce_mode

定义在文件 configfs-rdma_cm 中

来自 HCA <hca> 的端口 <port-num> 的基于 RDMA-CM 的连接将使用此 RoCE 类型作为默认值启动。可能的 RoCE 类型为“IB/RoCE v1”或“RoCE v2”。此参数具有 RW 访问权限。

/config/rdma_cm/<hca>/ports/<port-num>/default_roce_tos

定义在文件 configfs-rdma_cm 中

来自 HCA <hca> 的端口 <port-num> 的 RDMA-CM QP 将使用此 TOS 作为默认值创建。可以使用 rdma_set_option API 覆盖此设置。可能的 RoCE TOS 值为 0-255。

/config/stp-policy 下的符号

/config/stp-policy

定义在文件 configfs-stp-policy 中

此组包含强制执行主/通道分配的策略，供希望通过 STM 设备发送跟踪数据的软件源使用。

/config/stp-policy/<device>.<policy>

定义在文件 configfs-stp-policy 中

此组是策略的根；其名称是将此策略应用到的 stm 设备名称和一个任意字符串串联而成。如果 <device> 部分与现有 stm 设备不匹配，mkdir 将失败并返回 ENODEV；如果该设备已分配有策略，mkdir 将失败并返回 EBUSY。

/config/stp-policy/<device>.<policy>/<node>

定义在文件 configfs-stp-policy 中

策略节点是一个字符串标识符，软件客户端将使用它来请求分配并分配给它们的主/通道。

/config/stp-policy/<device>.<policy>/<node>/channels

定义在文件 configfs-stp-policy 中

从此节点的用户分配的通道范围。写入两个数字：第一个通道和最后一个通道号。

/config/stp-policy/<device>.<policy>/<node>/masters

定义在文件 configfs-stp-policy 中

从此节点的用户分配的主范围。写入两个数字：第一个主站和最后一个主站号。

/config/stp-policy/<device>.<policy>/device

定义在文件 configfs-stp-policy 中

此策略适用的 STM 设备，只读。与其父目录的 <device> 组件相同。

/config/stp-policy/<device>:p_sys-t.<policy>/<node>/clocksync_interval

定义在文件 configfs-stp-policy-p_sys-t 中

以毫秒为单位的时间间隔。如果自从来自此源的上一个 CLOCKSYNC 数据包以来已经过了这么多毫秒，则发送 CLOCKSYNC 数据包。零是默认值，表示“从不发送 CLOCKSYNC”。对于生成恒定和/或周期性数据的源（例如 stm_heartbeat），使用此选项是有意义的。

/config/stp-policy/<device>:p_sys-t.<policy>/<node>/do_len

定义在文件 configfs-stp-policy-p_sys-t 中

在 MIPI SyS-T 标头中包含有效负载长度，布尔值。如果启用，SyS-T 协议编码器将在每个数据包的元数据中包含有效负载长度。如果底层传输协议支持标记消息边界（STP 确实支持），则此项通常是多余的，因此默认情况下是关闭的。

/config/stp-policy/<device>:p_sys-t.<policy>/<node>/ts_interval

定义在文件 configfs-stp-policy-p_sys-t 中

以毫秒为单位的时间间隔。如果自从来自此源的上一个数据包以来已经过了这么多毫秒，则在 MIPI SyS-T 数据包元数据中包含时间戳。零是默认值，表示“从不发送时间戳”。

/config/stp-policy/<device>:p_sys-t.<policy>/<node>/uuid

定义在文件 configfs-stp-policy-p_sys-t 中

UUID 源标识符字符串，RW。默认值在 mkdir <node> 时随机生成。来自使用此 <node> 的跟踪源的数据将在 MIPI SyS-T 数据包流中使用此 UUID 进行标记，以允许解码器区分同一主/通道范围内的不同源，并识别每个源可能需要的高级解码器。

/config/usb-gadget 下的符号

/config/usb-gadget

定义在文件 configfs-usb-gadget 中

此组包含与已创建的 USB 设备对应的子组。

/config/usb-gadget/gadget

定义在文件 configfs-usb-gadget 中

设备的属性

UDC

将设备绑定到 UDC/取消绑定设备；写入在 /sys/class/udc/* 中找到的 UDC 的名称以绑定设备，写入空字符串 "" 以取消绑定。

max_speed

驱动程序支持的最大速度。有效名称为 super-speed-plus、super-speed、high-speed、full-speed 和 low-speed。

bDeviceClass

USB 设备类代码

bDeviceSubClass

USB 设备子类代码

bDeviceProtocol

USB 设备协议代码

bMaxPacketSize0

最大端点 0 数据包大小

bcdDevice

bcd 设备发布号

bcdUSB

bcd USB 规范版本号

idProduct

产品 ID

idVendor

供应商 ID

/config/usb-gadget/gadget/configs

定义在文件 configfs-usb-gadget 中

此组包含 USB 设备的配置

/config/usb-gadget/gadget/configs/config

定义在文件 configfs-usb-gadget 中

配置的属性

bmAttributes

配置特征

MaxPower

总线的最大功耗

/config/usb-gadget/gadget/configs/config/strings

定义在文件 configfs-usb-gadget 中

此组包含此配置的特定于语言的字符串的子目录。

/config/usb-gadget/gadget/configs/config/strings/language

定义在文件 configfs-usb-gadget 中

属性

configuration

配置描述

/config/usb-gadget/gadget/functions

定义在文件 configfs-usb-gadget 中

此组包含此 USB 设备可用的功能。

/config/usb-gadget/gadget/functions/<func>.<inst>/interface.<n>

定义在文件 configfs-usb-gadget 中

此组包含特定于由 IAD 描述的一个设备的 USB 接口或一个接口组的“功能描述符”。

属性

compatible_id

“兼容 ID”的 8 字节字符串

sub_compatible_id

“子兼容 ID”的 8 字节字符串

/config/usb-gadget/gadget/functions/<func>.<inst>/interface.<n>/<property>

定义在文件 configfs-usb-gadget 中

此组包含特定于由 IAD 描述的一个设备的 USB 接口或一个接口组的“扩展属性描述符”。

属性

type

用于解释数据的 1..7 值

  • 1：unicode 字符串

  • 2：带有环境变量的 unicode 字符串

  • 3：二进制

  • 4：小端 32 位

  • 5：大端 32 位

  • 6：带有符号链接的 unicode 字符串

  • 7：多个 unicode 字符串

data

要根据类型解释的数据 blob

/config/usb-gadget/gadget/functions/Loopback.name

定义在文件 configfs-usb-gadget-loopback 中

属性

qlen

环回队列的深度

buflen

缓冲区长度

/config/usb-gadget/gadget/functions/SourceSink.name

定义在文件 configfs-usb-gadget-sourcesink 中

属性

pattern

0（全部为零）、1（mod63）、2（无）

isoc_interval

1..16

isoc_maxpacket

0 - 1023 (fs), 0 - 1024 (hs/ss)

isoc_mult

0..2（仅限 hs/ss）

isoc_maxburst

0..15（仅限 ss）

buflen

缓冲区长度

bulk_qlen

批量队列的深度

iso_qlen

iso 队列的深度

/config/usb-gadget/gadget/functions/acm.name

定义在文件 configfs-usb-gadget-acm 中

此项仅包含一个只读属性：port_num。它包含与 acm 函数的实例“name”关联的 /dev/ttyGS<n> 设备的端口号。

/config/usb-gadget/gadget/functions/acm.name/protocol

定义在文件 configfs-usb-gadget-acm 中

ACM设备的报告的 bInterfaceProtocol。出于历史原因，默认值为 1 (USB_CDC_ACM_PROTO_AT_V25TER)。

/config/usb-gadget/gadget/functions/ecm.name

定义在文件 configfs-usb-gadget-ecm

属性

ifname

  • 与此函数实例关联的网络设备接口名称

qmult

  • 高速和超高速的队列长度乘数

host_addr

  • 此 USB 以太网链路的主机端的 MAC 地址

dev_addr

  • 此 USB 以太网链路的设备端的 MAC 地址

/config/usb-gadget/gadget/functions/eem.name

定义在文件 configfs-usb-gadget-eem

属性

ifname

与此函数实例关联的网络设备接口名称

qmult

高速和超高速的队列长度乘数

host_addr

此 USB 以太网链路的主机端的 MAC 地址

dev_addr

此 USB 以太网链路的设备端的 MAC 地址

/config/usb-gadget/gadget/functions/ffs.name

定义在文件 configfs-usb-gadget-ffs

此目录的目的是创建和删除它。

创建/删除相应的 USB 函数实例。

所有属性都是只读的

ready

如果该函数已准备好使用，则为 1。例如，如果用户空间已将描述符和字符串写入 ep0，则可以启用该设备，否则为 0。

所有其他参数都通过 FunctionFS 设置。

/config/usb-gadget/gadget/functions/geth.name

定义在文件 configfs-usb-gadget-subset

属性

ifname

与此函数实例关联的网络设备接口名称

qmult

高速和超高速的队列长度乘数

host_addr

此 USB 以太网链路的主机端的 MAC 地址

dev_addr

此 USB 以太网链路的设备端的 MAC 地址

/config/usb-gadget/gadget/functions/gser.name

定义在文件 configfs-usb-gadget-serial

此项仅包含一个只读属性：port_num。它包含与 gser 函数实例 “name” 关联的 /dev/ttyGS<n> 设备的端口号。

/config/usb-gadget/gadget/functions/hid.name

定义在文件 configfs-usb-gadget-hid

属性

protocol

要使用的 HID 协议

report_desc

对应于 HID 报告描述符的 blob，除了通过 /dev/hidg<N> 传递的数据。

report_length

HID 报告长度

subclass

要使用的 HID 设备子类

/config/usb-gadget/gadget/functions/mass_storage.name

定义在文件 configfs-usb-gadget-mass-storage

属性

stall

设置为允许函数暂停批量端点。在某些已知无法正常工作的 USB 设备上禁用。应将其设置为 true。

num_buffers

管道缓冲区数量。有效数字为 2..4。仅当设置了 CONFIG_USB_GADGET_DEBUG_FILES 时可用。

/config/usb-gadget/gadget/functions/mass_storage.name/lun.name

定义在文件 configfs-usb-gadget-mass-storage

属性

file

LUN 的后备文件路径。如果 LUN 未标记为可移动，则为必填项。

ro

指定对 LUN 的访问应为只读的标志。如果启用了 CD-ROM 仿真，以及当无法在 R/W 模式下打开 “filename” 时，也会暗示这一点。

removable

指定应将 LUN 指示为可移动的标志。

cdrom

指定应将 LUN 报告为 CD-ROM 的标志。

nofua

指定 SCSI WRITE(10,12) 中 FUA 标志的标志

forced_eject

仅当该功能处于活动状态时，此只写文件才有用。无论主机是否允许，它都会导致后备文件被强制从 LUN 分离。写入任何非零字节数都将导致弹出。

/config/usb-gadget/gadget/functions/midi.name

定义在文件 configfs-usb-gadget-midi

属性

index

USB MIDI 适配器的索引值

id

USB MIDI 适配器的 ID 字符串

buflen

MIDI 缓冲区长度

qlen

USB 读取请求队列长度

in_ports

MIDI 输入端口的数量

out_ports

MIDI 输出端口的数量

/config/usb-gadget/gadget/functions/midi2.name

定义在文件 configfs-usb-gadget-midi2

属性

process_ump

处理 UMP 流消息的标志 (0 或 1)

static_block

静态块的标志 (0 或 1)

iface_name

MIDI 接口名称字符串

/config/usb-gadget/gadget/functions/midi2.name/ep.number

定义在文件 configfs-usb-gadget-midi2

此组包含 UMP 端点配置。新端点从 0 开始，最多可以为 3。

属性

protocol_caps

MIDI 协议功能（对于两者，1、2 或 3）

protocol

默认 MIDI 协议（1 或 2）

ep_name

UMP 端点名称字符串

product_id

产品 ID 字符串

manufacturer

制造 ID (24 位)

family

设备系列 ID (16 位)

model

设备型号 ID (16 位)

sw_revision

软件修订版 (32 位)

/config/usb-gadget/gadget/functions/midi2.name/ep.number/block.number

定义在文件 configfs-usb-gadget-midi2

此组包含 UMP 功能块配置。新块从 0 开始，最多可以为 31。

属性

name

功能块名称字符串

direction

1：输入，2：输出，3：双向

first_group

第一个 UMP 组号 (0-15)

num_groups

此 FB 中的组数 (1-16)

midi1_first_group

MIDI 1.0 的第一个 UMP 组号 (0-15)

midi1_num_groups

MIDI 1.0 的组数 (0-16)

ui_hint

0：未知，1：接收器，2：发送器，3：两者

midi_ci_verison

支持的 MIDI-CI 版本号 (8 位)

is_midi1

旧版 MIDI 1.0 设备 (0、1 或 2)

sysex8_streams

SysEx8 流的最大数量 (8 位)

active

活动 FB 标志 (0 或 1)

/config/usb-gadget/gadget/functions/ncm.name

定义在文件 configfs-usb-gadget-ncm

属性

ifname - 与以下项关联的网络设备接口名称

此函数实例

qmult - 高速和

超高速的队列长度乘数

host_addr - 此主机端的 MAC 地址

USB 以太网链路

dev_addr - 此设备端的 MAC 地址

USB 以太网链路

/config/usb-gadget/gadget/functions/obex.name

定义在文件 configfs-usb-gadget-obex

此项仅包含一个只读属性：port_num。它包含与 obex 函数实例 “name” 关联的 /dev/ttyGS<n> 设备的端口号。

/config/usb-gadget/gadget/functions/phonet.name

定义在文件 configfs-usb-gadget-phonet

此项仅包含一个只读属性：ifname。它包含在网络设备注册期间分配的网络接口名称。

/config/usb-gadget/gadget/functions/printer.name

定义在文件 configfs-usb-gadget-printer

属性

pnp_string

要在 pnp 字符串中传递给主机的数据

q_len

每个端点的请求数量

/config/usb-gadget/gadget/functions/rndis.name

定义在文件 configfs-usb-gadget-rndis

属性

ifname

与此函数实例关联的网络设备接口名称

qmult

高速和超高速的队列长度乘数

host_addr

此 USB 以太网链路的主机端的 MAC 地址

dev_addr

此 USB 以太网链路的设备端的 MAC 地址

class

USB 接口类，默认为 02 (十六进制)

subclass

USB 接口子类，默认为 06 (十六进制)

protocol

USB 接口协议，默认为 00 (十六进制)

/config/usb-gadget/gadget/functions/tcm.name

定义在文件 configfs-usb-gadget-tcm

没有属性，因为所有配置都在 configfs 的 “target” 子系统中执行。

/config/usb-gadget/gadget/functions/uac1.name

定义在文件 configfs-usb-gadget-uac1

属性

c_chmask

捕获通道掩码

c_srate

捕获采样率列表（逗号分隔）

c_ssize

捕获采样大小（字节）

c_mute_present

启用捕获静音控制

c_volume_present

启用捕获音量控制

c_volume_min

捕获音量控制最小值（1/256 dB）

c_volume_max

捕获音量控制最大值（1/256 dB）

c_volume_res

捕获音量控制分辨率（1/256 dB）

p_chmask

播放通道掩码

p_srate

播放采样率列表（逗号分隔）

p_ssize

播放采样大小（字节）

p_mute_present

启用播放静音控制

p_volume_present

启用播放音量控制

p_volume_min

播放音量控制最小值（1/256 dB）

p_volume_max

播放音量控制最大值（1/256 dB）

p_volume_res

播放音量控制分辨率（1/256 dB）

req_number

捕获和播放的预分配请求数

function_name

接口的名称

p_it_name

播放输入终端名称

p_it_ch_name

播放通道名称

p_ot_name

播放输出终端名称

p_fu_vol_name

播放静音/音量功能单元名称

c_it_name

捕获输入终端名称

c_it_ch_name

捕获通道名称

c_ot_name

捕获输出终端名称

c_fu_vol_name

捕获静音/音量功能单元名称

/config/usb-gadget/gadget/functions/uac1_legacy.name

定义在文件 configfs-usb-gadget-uac1_legacy

属性

audio_buf_size - 音频缓冲区大小 fn_cap - 捕获 pcm 设备文件名 fn_cntl - 控制设备文件名 fn_play - 播放 pcm 设备文件名 req_buf_size - ISO OUT 端点请求缓冲区大小 req_count - ISO OUT 端点请求计数

/config/usb-gadget/gadget/functions/uac2.name

定义在文件 configfs-usb-gadget-uac2

属性

c_chmask

捕获通道掩码

c_srate

捕获采样率列表（逗号分隔）

c_ssize

捕获采样大小（字节）

c_hs_bint

HS/SS 的捕获 bInterval (1-4：固定，0：自动)

c_sync

捕获同步类型（异步/自适应）

c_mute_present

启用捕获静音控制

c_volume_present

启用捕获音量控制

c_volume_min

捕获音量控制最小值（1/256 dB）

c_volume_max

捕获音量控制最大值（1/256 dB）

c_volume_res

捕获音量控制分辨率（1/256 dB）

fb_max

异步模式下的最大额外带宽

p_chmask

播放通道掩码

p_srate

播放采样率列表（逗号分隔）

p_ssize

播放采样大小（字节）

p_hs_bint

HS/SS 的播放 bInterval (1-4：固定，0：自动)

p_mute_present

启用播放静音控制

p_volume_present

启用播放音量控制

p_volume_min

播放音量控制最小值（1/256 dB）

p_volume_max

播放音量控制最大值（1/256 dB）

p_volume_res

播放音量控制分辨率（1/256 dB）

req_number

捕获和播放的预分配请求数

function_name

接口的名称

if_ctrl_name

拓扑控制名称

clksrc_in_name

输入时钟名称

clksrc_out_name

输出时钟名称

p_it_name

播放输入终端名称

p_it_ch_name

播放输入第一个通道名称

p_ot_name

播放输出终端名称

p_fu_vol_name

播放静音/音量功能单元名称

c_it_name

捕获输入终端名称

c_it_ch_name

捕获输入第一个通道名称

c_ot_name

捕获输出终端名称

c_fu_vol_name

捕获静音/音量功能单元名称

c_terminal_type

捕获终端类型的代码

p_terminal_type

回放终端类型的代码

/config/usb-gadget/gadget/functions/uvc.name

定义在文件 configfs-usb-gadget-uvc

UVC 功能目录

streaming_maxburst

0..15（仅限 ss）

streaming_maxpacket

1..1023 (fs), 1..3072 (hs/ss)

streaming_interval

1..16

function_name

字符串 [32]

/config/usb-gadget/gadget/functions/uvc.name/control

定义在文件 configfs-usb-gadget-uvc

控制描述符

所有属性都是只读的，除了 enable_interrupt_ep

bInterfaceNumber

此流接口的 USB 接口号

enable_interrupt_ep

启用 VC 接口的中断端点的标志

/config/usb-gadget/gadget/functions/uvc.name/control/class

定义在文件 configfs-usb-gadget-uvc

类描述符

/config/usb-gadget/gadget/functions/uvc.name/control/class/fs

定义在文件 configfs-usb-gadget-uvc

全速控制类描述符

/config/usb-gadget/gadget/functions/uvc.name/control/class/ss

定义在文件 configfs-usb-gadget-uvc

超速控制类描述符

/config/usb-gadget/gadget/functions/uvc.name/control/extensions

定义在文件 configfs-usb-gadget-uvc

扩展单元描述符

/config/usb-gadget/gadget/functions/uvc.name/control/extensions/name

定义在文件 configfs-usb-gadget-uvc

扩展单元 (XU) 描述符

bLength、bUnitID 和 iExtension 是只读的。所有其他的都是可读写的。

bLength

描述符的大小，以字节为单位

bUnitID

此单元的非零 ID

guidExtensionCode

标识 XU 的供应商特定代码

bNumControls

此 XU 中的控件数量

bNrInPins

此单元的输入引脚数量

baSourceID

连接到此 XU 的单元或终端的 ID 列表

bControlSize

bmControls 字段的大小，以字节为单位

bmControls

详细说明支持哪些供应商特定控件的位图列表

iExtension

描述此扩展单元的字符串描述符的索引

/config/usb-gadget/gadget/functions/uvc.name/control/header

定义在文件 configfs-usb-gadget-uvc

控制头描述符

/config/usb-gadget/gadget/functions/uvc.name/control/header/name

定义在文件 configfs-usb-gadget-uvc

特定控制头描述符

dwClockFrequency bcdUVC

/config/usb-gadget/gadget/functions/uvc.name/control/processing

定义在文件 configfs-usb-gadget-uvc

处理单元描述符

/config/usb-gadget/gadget/functions/uvc.name/control/processing/default

定义在文件 configfs-usb-gadget-uvc

默认处理单元描述符

所有属性都是只读的，除了 bmControls，它是可读写的

iProcessing

字符串描述符的索引

bmControls

指定视频流支持哪些控件的位图

wMaxMultiplier

最大数字放大倍数 x100

bSourceID

连接到此单元的终端的 ID

bUnitID

此单元的非零 ID

/config/usb-gadget/gadget/functions/uvc.name/control/terminal

定义在文件 configfs-usb-gadget-uvc

终端描述符

/config/usb-gadget/gadget/functions/uvc.name/control/terminal/camera

定义在文件 configfs-usb-gadget-uvc

摄像头终端描述符

/config/usb-gadget/gadget/functions/uvc.name/control/terminal/camera/default

定义在文件 configfs-usb-gadget-uvc

默认摄像头终端描述符

所有属性都是只读的，除了 bmControls，它是可读写的

bmControls

指定视频流支持哪些控件的位图

wOcularFocalLength

Locular 的值

wObjectiveFocalLengthMax

Lmin 的值

wObjectiveFocalLengthMin

Lmax 的值

iTerminal

字符串描述符的索引

bAssocTerminal

连接到此终端的输出终端的 ID

wTerminalType

终端类型

bTerminalID

此终端的非零 ID

/config/usb-gadget/gadget/functions/uvc.name/control/terminal/output

定义在文件 configfs-usb-gadget-uvc

输出终端描述符

/config/usb-gadget/gadget/functions/uvc.name/control/terminal/output/default

定义在文件 configfs-usb-gadget-uvc

默认输出终端描述符

所有属性都是只读的，除了 bSourceID

iTerminal

字符串描述符的索引

bSourceID

连接到此终端的终端的 ID

bAssocTerminal

与此输出终端关联的输入终端的 ID

wTerminalType

终端类型

bTerminalID

此终端的非零 ID

/config/usb-gadget/gadget/functions/uvc.name/streaming

定义在文件 configfs-usb-gadget-uvc

流描述符

所有属性都是只读的

bInterfaceNumber

此流接口的 USB 接口号

/config/usb-gadget/gadget/functions/uvc.name/streaming/class

定义在文件 configfs-usb-gadget-uvc

流类描述符

/config/usb-gadget/gadget/functions/uvc.name/streaming/class/fs

定义在文件 configfs-usb-gadget-uvc

全速流类描述符

/config/usb-gadget/gadget/functions/uvc.name/streaming/class/hs

定义在文件 configfs-usb-gadget-uvc

高速流类描述符

/config/usb-gadget/gadget/functions/uvc.name/streaming/class/ss

定义在文件 configfs-usb-gadget-uvc

超速流类描述符

/config/usb-gadget/gadget/functions/uvc.name/streaming/color_matching

定义在文件 configfs-usb-gadget-uvc

颜色匹配描述符

/config/usb-gadget/gadget/functions/uvc.name/streaming/color_matching/default

定义在文件 configfs-usb-gadget-uvc

默认颜色匹配描述符

所有属性都是可读写的

bMatrixCoefficients

用于从颜色原色计算亮度和色度值的矩阵

bTransferCharacteristics

源图像的电子光学传输特性，也称为伽玛函数

bColorPrimaries

颜色原色和参考白色

/config/usb-gadget/gadget/functions/uvc.name/streaming/color_matching/name

定义在文件 configfs-usb-gadget-uvc

其他颜色匹配描述符

所有属性都是可读写的

bMatrixCoefficients

用于从颜色原色计算亮度和色度值的矩阵

bTransferCharacteristics

源图像的电子光学传输特性，也称为伽玛函数

bColorPrimaries

颜色原色和参考白色

/config/usb-gadget/gadget/functions/uvc.name/streaming/framebased

定义在文件 configfs-usb-gadget-uvc

基于帧的格式描述符

/config/usb-gadget/gadget/functions/uvc.name/streaming/framebased/name

定义在文件 configfs-usb-gadget-uvc

特定基于帧的格式描述符

bFormatIndex

此格式描述符的唯一 ID；仅在父标头链接到流类后定义；只读

bmaControls

此格式在流标头中用于 bmaControls 的数据

bmInterlaceFlags

指定隔行扫描信息，只读

bAspectRatioY

图片纵横比的 X 尺寸，只读

bAspectRatioX

图片纵横比的 Y 尺寸，只读

bDefaultFrameIndex

此流的最佳帧索引

bBitsPerPixel

用于在解码后的视频帧中指定颜色的每个像素的位数

guidFormat

用于标识流编码格式的全局唯一 ID

/config/usb-gadget/gadget/functions/uvc.name/streaming/framebased/name/name

定义在文件 configfs-usb-gadget-uvc

特定基于帧的帧描述符

bFrameIndex

此帧描述符的唯一 ID；仅在父格式链接到流标头后定义；只读

dwFrameInterval

指示如何编程帧间隔；可以指定由换行符分隔的多个值

dwDefaultFrameInterval

设备希望用作默认值的帧间隔

dwBytesPerLine

指定打包固定帧大小格式的每行视频的字节数，允许接收器执行视频的跨距对齐。如果 bVariableSize 值（如上所述）为 TRUE (1)，或者如果格式不允许进行此类对齐，则此值应设置为零 (0)。

dwMaxBitRate

最短帧间隔时的最大比特率，以 bps 为单位

dwMinBitRate

最长帧间隔时的最小比特率，以 bps 为单位

wHeight

解码后的位图帧的高度，以像素为单位

wWidth

解码后的位图帧的宽度，以像素为单位

bmCapabilities

静止图像支持、固定帧率支持

/config/usb-gadget/gadget/functions/uvc.name/streaming/header

定义在文件 configfs-usb-gadget-uvc

流标头描述符

/config/usb-gadget/gadget/functions/uvc.name/streaming/header/name

定义在文件 configfs-usb-gadget-uvc

特定流标头描述符

所有属性都是只读的

bTriggerUsage

主机软件将如何响应硬件触发中断事件

bTriggerSupport

标志，指定是否支持硬件触发

bStillCaptureMethod

支持的静止图像捕获方法

bTerminalLink

此接口的视频端点连接到的输出终端的 ID

bmInfo

此视频流接口的功能

/config/usb-gadget/gadget/functions/uvc.name/streaming/mjpeg

定义在文件 configfs-usb-gadget-uvc

MJPEG 格式描述符

/config/usb-gadget/gadget/functions/uvc.name/streaming/mjpeg/name

定义在文件 configfs-usb-gadget-uvc

特定 MJPEG 格式描述符

所有属性都是只读的，除了 bmaControls 和 bDefaultFrameIndex

bFormatIndex

此格式描述符的唯一 ID；仅在父标头链接到流类后定义；只读

bmaControls

此格式在流标头中用于 bmaControls 的数据

bmInterlaceFlags

指定隔行扫描信息，只读

bAspectRatioY

图片纵横比的 X 尺寸，只读

bAspectRatioX

图片纵横比的 Y 尺寸，只读

bmFlags

此格式的特征，只读

bDefaultFrameIndex

此流的最佳帧索引

/config/usb-gadget/gadget/functions/uvc.name/streaming/mjpeg/name/name

定义在文件 configfs-usb-gadget-uvc

特定 MJPEG 帧描述符

bFrameIndex

此帧描述符的唯一 ID；仅在父格式链接到流标头后定义；只读

dwFrameInterval

指示如何编程帧间隔；可以指定由换行符分隔的多个值

dwDefaultFrameInterval

设备希望用作默认值的帧间隔

dwMaxVideoFrameBufferSize

压缩器将为视频帧或静止图像生成的最大字节数

dwMaxBitRate

最短帧间隔时的最大比特率，以 bps 为单位

dwMinBitRate

最长帧间隔时的最小比特率，以 bps 为单位

wHeight

解码后的位图帧的高度，以像素为单位

wWidth

解码后的位图帧的宽度，以像素为单位

bmCapabilities

静止图像支持、固定帧率支持

/config/usb-gadget/gadget/functions/uvc.name/streaming/uncompressed

定义在文件 configfs-usb-gadget-uvc

未压缩的格式描述符

/config/usb-gadget/gadget/functions/uvc.name/streaming/uncompressed/name

定义在文件 configfs-usb-gadget-uvc

特定未压缩的格式描述符

bFormatIndex

此格式描述符的唯一 ID；仅在父标头链接到流类后定义；只读

bmaControls

此格式在流标头中用于 bmaControls 的数据

bmInterlaceFlags

指定隔行扫描信息，只读

bAspectRatioY

图片纵横比的 X 尺寸，只读

bAspectRatioX

图片纵横比的 Y 尺寸，只读

bDefaultFrameIndex

此流的最佳帧索引

bBitsPerPixel

用于在解码后的视频帧中指定颜色的每个像素的位数

guidFormat

用于标识流编码格式的全局唯一 ID

/config/usb-gadget/gadget/functions/uvc.name/streaming/uncompressed/name/name

定义在文件 configfs-usb-gadget-uvc

特定未压缩的帧描述符

bFrameIndex

此帧描述符的唯一 ID；仅在父格式链接到流标头后定义；只读

dwFrameInterval

指示如何编程帧间隔；可以指定由换行符分隔的多个值

dwDefaultFrameInterval

设备希望用作默认值的帧间隔

dwMaxVideoFrameBufferSize

压缩器将为视频帧或静止图像生成的最大字节数

dwMaxBitRate

最短帧间隔时的最大比特率，以 bps 为单位

dwMinBitRate

最长帧间隔时的最小比特率，以 bps 为单位

wHeight

解码后的位图帧的高度，以像素为单位

wWidth

解码后的位图帧的宽度，以像素为单位

bmCapabilities

静止图像支持、固定帧率支持

/config/usb-gadget/gadget/os_desc

定义在文件 configfs-usb-gadget 中

此组包含“OS 字符串”扩展处理属性。

use

打开/关闭“OS 描述符”支持的标志

b_vendor_code

用于自定义每个设备和每个接口请求的单字节值

qw_sign

一个标识符，将被报告为正确的“OS 字符串”

/config/usb-gadget/gadget/strings

定义在文件 configfs-usb-gadget 中

此组包含此小工具的特定语言字符串的子目录。

/config/usb-gadget/gadget/strings/language

定义在文件 configfs-usb-gadget 中

属性

serialnumber

小工具的序列号（字符串）

product

小工具的产品描述

manufacturer

小工具的制造商描述

/config/usb-gadget/gadget/webusb

定义在文件 configfs-usb-gadget 中

此组包含“WebUSB”扩展处理属性。

use

打开/关闭“WebUSB”支持的标志

bcdVersion

bcd WebUSB 规范版本号

bVendorCode

用于自定义每个设备的单字节值

landingPage

设备着陆页的 UTF-8 编码 URL

/dev/gpiochip 下的符号

/dev/gpiochip[0-9]+

定义在文件 gpio-cdev

字符设备文件 /dev/gpiochip* 是 GPIO 芯片和用户空间之间的接口。

基于 ioctl(2) 的 ABI 在 [include/uapi]<linux/gpio.h> 中定义，并在 GPIO 字符设备用户空间 API 中进行了文档化。

支持以下文件操作

open(2)

目前唯一有用的标志是 O_RDWR。

ioctl(2)

启动各种操作。

有关所有 ioctl 的描述，请参阅 GPIO 字符设备用户空间 API。

close(2)

停止并释放与文件描述符关联的 I/O 上下文。

用户：待定

/dev/kmsg 下的符号

/dev/kmsg

定义在文件 dev-kmsg

/dev/kmsg 字符设备节点提供对内核 printk 缓冲区的用户空间访问。

注入消息

每次写入 () 到打开的设备节点都会在内核的 printk 缓冲区中放置一个日志条目。

记录的行可以用 <N> syslog 前缀作为前缀，该前缀携带 syslog 优先级和设备。单个十进制前缀数字由最低的 3 位表示 syslog 优先级，接下来的 8 位表示 syslog 设备号组成。

如果未给出前缀，则优先级号是默认的内核日志优先级，设备号设置为 LOG_USER (1)。不可能从用户空间注入设备号为 LOG_KERN (0) 的消息，以确保始终可以可靠地确定消息的来源。

访问缓冲区

每次从打开的设备节点读取 () 都会接收内核 printk 缓冲区的一条记录。

直接在 open() 之后的第一次 read() 始终返回缓冲区中的第一条消息；没有内核内部持久状态；许多读取器可以并发打开设备并从中读取，而不会影响其他读取器。

每次 read() 都会接收下一个可用的记录。如果没有更多可用的记录，read() 将会阻塞，或者如果使用了 O_NONBLOCK，则会返回 -EAGAIN。

记录环形缓冲区中的消息会被整体覆盖，read() 永远不会接收到部分消息。

如果消息在设备保持打开状态时在循环缓冲区中被覆盖，则下一次 read() 将返回 -EPIPE，并且寻道位置将更新为下一个可用记录。随后的 read() 将再次返回可用记录。

与经典的 syslog() 接口不同，64 位记录序列号允许计算消息丢失的数量，以防缓冲区被覆盖。它们还允许在需要时重新连接到缓冲区并重建读取位置，而无需将接口限制为单个读取器。

该设备支持以下参数的 seek 操作

SEEK_SET, 0

定位到缓冲区的第一个条目

SEEK_END, 0

定位到缓冲区中最后一个条目之后

SEEK_DATA, 0

定位到上次发出 SYSLOG_ACTION_CLEAR 时可用的最后一个记录之后。

由于此设备的特殊行为，不支持其他 seek 操作或偏移量。该设备只允许读取或写入存储在环形缓冲区中的整个可变长度消息（记录）。

由于非标准行为，错误值也是非标准的。对于非零偏移量，返回 -ESPIPE。对于其他操作，例如 SEEK_CUR，返回 -EINVAL。此行为和值是历史遗留的，如果修改则可能会破坏用户空间。

输出格式包括一个前缀，该前缀携带 syslog 前缀，包括优先级和设备，64 位消息序列号以及以微秒为单位的单调时间戳和一个标志字段。所有字段都用“,”分隔。

未来的扩展可能会在终止符“;”之前添加更多逗号分隔的值。未知字段和值应被优雅地忽略。

人类可读的文本字符串直接从“;”之后开始，并以“\n”结束。从硬件或其他设施获得的不可信值会被打印出来，因此日志消息中所有不可打印的字符和“'”本身都会使用“x00” C 样式十六进制编码进行转义。

以“ ”开头的行是延续行，它将键/值对添加到日志消息中，为用户空间中的可靠处理提供消息的机器可读上下文。

示例

7,160,424069,-;pci_root PNP0A03:00: host bridge window [io  0x0000-0x0cf7] (ignored)
 SUBSYSTEM=acpi
 DEVICE=+acpi:PNP0A03:00
6,339,5140900,-;NET: Registered protocol family 10
30,340,5690716,-;udevd[80]: starting version 181

DEVICE= 键以下列方式唯一标识设备

b12:8

块设备 dev_t

c127:3

字符设备 dev_t

n8

netdev ifindex

+sound:card0

子系统:devname

标志字段默认携带“-”。“c”表示行的片段。请注意，关于延续行的这些提示不一定是正确的，并且流可能会与不相关的消息交错，但是合并输出中的行通常会产生更好的人类可读结果。当消息打印到控制台、/proc/kmsg 或 syslog() 系统调用时，内部也会使用类似的逻辑。

默认情况下，内核会尝试在可能的情况下通过连接来避免片段，并且片段很少；但是，当启用扩展控制台支持时，内核中的连接将被禁用，并且 /dev/kmsg 输出将包含更多片段。如果日志使用者执行连接，则最终结果应该相同。将来，内核中的连接可能会完全删除，建议 /dev/kmsg 用户实现片段处理。

用户：dmesg(1)、用户空间内核日志消费者

/dev/rtcX 下的符号

/dev/rtcX

定义在文件 rtc-cdev 中

用于实时时钟（RTC）驱动程序的 ioctl 接口。支持以下操作

  • RTC_RD_TIME、RTC_SET_TIME：读取或设置 RTC 时间。时间格式为公历日期和 24 小时制时间。

  • RTC_AIE_ON、RTC_AIE_OFF：启用或禁用支持警报的 RTC 的警报中断

  • RTC_ALM_READ、RTC_ALM_SET：读取或设置支持警报的 RTC 的警报时间。可以设置为最多未来 24 小时。需要单独的 RTC_AIE_ON 调用来启用警报中断。（首选使用 RTC_WKALM_*）

  • RTC_WKALM_RD、RTC_WKALM_SET：对于支持更强大接口的 RTC，该接口可以发出超过 24 小时的警报并在同一请求中启用 IRQ。

  • RTC_PIE_ON、RTC_PIE_OFF：启用或禁用支持周期性中断的 RTC 的周期性中断。

  • RTC_UIE_ON、RTC_UIE_OFF：启用或禁用支持更新中断的 RTC 的更新中断。

  • RTC_IRQP_READ、RTC_IRQP_SET：读取或设置支持周期性中断的 RTC 的周期性中断频率。需要单独的 RTC_PIE_ON 调用来启用周期性中断。

  • RTC_VL_READ：读取支持时 RTC 的电压输入状态。该值是 RTC_VL_* 的位字段，给出主电压和备用电压的状态。

  • RTC_VL_CLEAR：清除 RTC 的电压状态。某些 RTC 在更换或充电备用电源时需要用户交互才能清除状态。

较旧的 /dev/rtc 接口支持的 ioctl() 调用也受较新的 RTC 类框架支持。但是，由于芯片和系统未标准化，因此可能不提供某些 PC/AT 功能。同样，RTC 类框架公开了一些较新的功能（包括 ACPI 启用的功能），但旧驱动程序不支持这些功能。

/dev/wmi 下的符号

/dev/wmi/dell-smbios

定义在文件 dell-smbios-wmi 中

通过 Dell ACPI-WMI 接口在受支持的 Dell 机器上执行 SMBIOS 调用。

IOCTL 和缓冲区格式在：<uapi/linux/wmi.h> 中定义

  1. 要从用户空间执行 SMBIOS 调用，您首先需要确定机器的调用接口缓冲区的最小大小。包含较大缓冲区的平台可以从系统固件返回更大的对象。通常，此大小为 4k 或 32k。

    要确定缓冲区的大小，请从 WMI 字符设备 /dev/wmi/dell-smbios 中 read() 一个 u64 双字。

  2. 确定调用接口缓冲区的最小大小后，可以分配一个表示上面记录的结构的结构。

  3. 在“length”对象中存储您上面确定和分配的缓冲区的大小。

  4. 在此缓冲区对象中，根据需要为感兴趣的 SMBIOS 调用做准备。通常，SMBIOS 缓冲区定义了与您感兴趣的数据一致的值的“class”、“select”和“input”。记录 class/select/input 值不在本文档的范围内。有关这些值的更多文档，请查看 libsmbios 项目。

  1. 使用标头中描述的 ioctl() 运行调用。

  2. 输出将返回到缓冲区对象中。

  3. 请确保释放您分配的对象。

/kvd 下的符号

/kvd/

定义在文件 devlink-resource-mlxsw 中

Spectrum 设备中的主数据库是一个集中的 KVD 数据库，用于配置芯片的许多表，包括 L2 FDB、L3 LPM、ECMP 等。KVD 分为两个部分，第一部分是基于哈希的表，第二部分是线性访问表。线性部分和基于哈希的部分之间的划分是静态的，并且需要重新加载才能使更改生效。

/kvd/hash_double 下的符号

/kvd/hash_double

定义在文件 devlink-resource-mlxsw 中

KVD 的基于哈希的部分由交换机设备管理。在密钥大于 64 位的情况下使用。

/kvd/hash_single 下的符号

/kvd/hash_single

定义在文件 devlink-resource-mlxsw 中

KVD 的基于哈希的部分由交换机设备管理。在密钥大小小于或等于 64 位的情况下使用。

/kvd/linear 下的符号

/kvd/linear

定义在文件 devlink-resource-mlxsw 中

KVD 的线性部分由软件作为使用索引访问的平面内存进行管理。

/proc 下的符号

/proc/*/attr/current

定义在文件 procfs-attr-current 中

系统上活动的 Linux 安全模块（LSM）使用的当前安全信息。从该接口读取并因此获得已标识任务的安全状态所需的权限的详细信息取决于 LSM。除非进程引用自身，否则它不能写入此接口。写入此接口并因此更改已标识任务的安全状态所需的其他权限的详细信息取决于 LSM。此接口使用的数据格式取决于 LSM。SELinux、Smack 和 AppArmor 提供了此接口。

用户：SELinux 用户空间 Smack 用户空间 AppArmor 用户空间

/proc/*/attr/exec

定义在文件 procfs-attr-exec 中

在后续 exec() 调用之后，系统上活动的 Linux 安全模块 (LSM) 将在进程上使用的安全信息。从该接口读取并因此获得已标识任务的安全状态所需的权限的详细信息取决于 LSM。除非进程引用自身，否则它不能写入此接口。写入此接口并因此更改已标识任务的安全状态所需的其他权限的详细信息取决于 LSM。此接口使用的数据格式取决于 LSM。SELinux 和 AppArmor 提供了此接口。

用户：SELinux 用户空间 AppArmor 用户空间

/proc/*/attr/prev

定义在文件 procfs-attr-prev 中

在最近的 exec() 调用之前，系统上活动的 Linux 安全模块 (LSM) 在进程上使用的安全信息。从该接口读取所需的权限的详细信息取决于 LSM。除非进程引用自身，否则它不能写入此接口。写入此接口所需的其他权限的详细信息取决于 LSM。此接口使用的数据格式取决于 LSM。SELinux 和 AppArmor 提供了此接口。

用户：SELinux 用户空间 AppArmor 用户空间

/proc/diskstats 下的符号

/proc/diskstats

定义在文件 procfs-diskstats 中

/proc/diskstats 文件显示块设备的 I/O 统计信息。每行包含以下 14 个字段：

1

主设备号

2

次设备号

3

设备名称

4

成功完成的读取次数

5

合并的读取次数

6

读取的扇区数

7

读取花费的时间 (毫秒)

8

完成的写入次数

9

合并的写入次数

10

写入的扇区数

11

写入花费的时间 (毫秒)

12

当前正在进行的 I/O 操作数

13

执行 I/O 操作花费的时间 (毫秒)

14

加权执行 I/O 操作花费的时间 (毫秒)

Kernel 4.18+ 为丢弃跟踪附加了四个字段，总共达到 18 个字段

15

成功完成的丢弃次数

16

合并的丢弃次数

17

丢弃的扇区数

18

丢弃花费的时间

Kernel 5.5+ 为刷新请求附加了两个字段

19

成功完成的刷新请求次数

20

刷新花费的时间

有关更多详细信息，请参阅 I/O 统计字段

/proc/pid 下的符号

/proc/pid/smaps_rollup

在文件 procfs-smaps_rollup 中定义

此文件提供进程的预先汇总的内存信息。该格式与 /proc/pid/smaps 几乎相同，不同之处在于，smaps_rollup 不是为进程中的每个 VMA 提供一个条目，而是只有一个条目（标记为“[rollup]”），其中每个字段是 /proc/pid/smaps 中所有映射的相应字段的总和。此外，字段 Pss_Anon、Pss_File 和 Pss_Shmem 不存在于 /proc/pid/smaps 中。这些字段表示每种类型（匿名、文件、共享内存）的 Pss 字段的总和。有关更多详细信息，请参阅 /proc 文件系统 和 procfs 手册页。

典型的输出如下所示

00100000-ff709000 ---p 00000000 00:00 0          [rollup]
Size:               1192 kB
KernelPageSize:        4 kB
MMUPageSize:           4 kB
Rss:                 884 kB
Pss:                 385 kB
Pss_Dirty:            68 kB
Pss_Anon:            301 kB
Pss_File:             80 kB
Pss_Shmem:             4 kB
Shared_Clean:        696 kB
Shared_Dirty:          0 kB
Private_Clean:       120 kB
Private_Dirty:        68 kB
Referenced:          884 kB
Anonymous:            68 kB
LazyFree:              0 kB
AnonHugePages:         0 kB
ShmemPmdMapped:        0 kB
Shared_Hugetlb:        0 kB
Private_Hugetlb:       0 kB
Swap:                  0 kB
SwapPss:               0 kB
Locked:              385 kB

/sys 下的符号

/sys/.../<设备>/<UUID>/

在文件 sysfs-bus-vfio-mdev 中定义

此目录表示中介设备的设备目录。它包含所有与中介设备相关的属性。

/sys/.../<设备>/<UUID>/mdev_type

在文件 sysfs-bus-vfio-mdev 中定义

这是指向支持的类型（创建此中介设备的 <type-id> 目录）的符号链接。

/sys/.../<设备>/<UUID>/remove

在文件 sysfs-bus-vfio-mdev 中定义

向此文件写入“1”会销毁中介设备。如果该设备处于活动状态且供应商驱动程序不支持热插拔，则供应商驱动程序可能会使 remove() 回调失败。示例

# echo 1 > /sys/bus/mdev/devices/<UUID>/remove

/sys/.../<设备>/mdev_supported_types/

在文件 sysfs-bus-vfio-mdev 中定义

此目录包含当前支持的中介设备类型及其 <设备> 详细信息的目录列表。支持的类型属性由向中介设备框架注册的供应商驱动程序定义。每个支持的类型都是一个目录，其名称是通过将设备驱动程序字符串作为前缀添加到供应商驱动程序提供的字符串来创建的。

/sys/.../<设备>/mdev_supported_types/<type-id>/

在文件 sysfs-bus-vfio-mdev 中定义

此目录提供支持的类型的详细信息，例如名称、描述、available_instances、device_api 等。“device_api”和“available_instances”是供应商驱动程序必须提供的强制属性。“name”、“description”和其他供应商驱动程序特定的属性是可选的。

/sys/.../<设备>/vfio-dev/vfioX/

在文件 sysfs-devices-vfio-dev 中定义

当设备绑定到 vfio 驱动程序时，将创建此目录。此目录下的布局与标准“struct device”存在的布局匹配。“X”是 vfio 中标记此设备的唯一索引。

/sys/.../events/illuminance_threshY_falling_value

/sys/.../events/illuminance_threshY_raising_value

在文件 sysfs-bus-iio-light-lm3533-als 中定义

指定设备正在比较以用于由 in_illuminance0_thresh_either_en (0..255) 启用的事件的阈值，其中 Y 在 0..3 中。

请注意，threshY_falling 必须小于或等于 threshY_raising。

这些阈值对应于八个区域边界寄存器 (boundaryY_{low,high})，并定义了五个光照区域。

/sys/.../events/in_accel_gesture_doubletap_tap2_min_delay

在文件 sysfs-bus-iio 中定义

指定双击的两次点击之间以秒为单位的最小静止时间。

/sys/.../events/in_accel_gesture_doubletap_tap2_min_delay_available

在文件 sysfs-bus-iio 中定义

列出双击中两次点击之间所有可用的延迟值。单位为秒。

/sys/.../events/in_accel_gesture_singletap_en

/sys/.../events/in_accel_gesture_doubletap_en

在文件 sysfs-bus-iio 中定义

设备在单次或双击时生成事件。

/sys/.../events/in_accel_gesture_singletap_reset_timeout

/sys/.../events/in_accel_gesture_doubletap_reset_timeout

在文件 sysfs-bus-iio 中定义

指定点击检测器在事件发生后不查找另一个点击事件的超时值（以秒为单位）。基本上是两次单次点击或两次双击之间的最小静止时间。

/sys/.../events/in_accel_gesture_singletap_value

/sys/.../events/in_accel_gesture_doubletap_value

在文件 sysfs-bus-iio 中定义

指定设备正在比较以生成点击手势事件的阈值。阈值越低，点击检测的灵敏度越高。单位和值的确切含义是设备特定的。

/sys/.../events/in_accel_gesture_tap_maxtomin_time

在文件 sysfs-bus-iio 中定义

指定为了将其视为有效的点击事件，点击的上限峰值和下限峰值之间允许的最大时间差。单位为秒。

/sys/.../events/in_accel_gesture_tap_maxtomin_time_available

在文件 sysfs-bus-iio 中定义

列出上限峰值到下限峰值之间所有可用的时间值。单位为秒。

/sys/.../events/in_accel_gesture_tap_reset_timeout_available

在文件 sysfs-bus-iio 中定义

列出所有可用的点击重置超时值。单位为秒。

/sys/.../events/in_accel_gesture_tap_value_available

在文件 sysfs-bus-iio 中定义

列出所有可用于修改点击检测灵敏度的可用阈值。

/sys/.../events/in_accel_gesture_tap_wait_dur

在文件 sysfs-bus-iio 中定义

点击手势确认的超时值（以秒为单位）。

/sys/.../events/in_accel_gesture_tap_wait_dur_available

在文件 sysfs-bus-iio 中定义

点击手势确认的可用超时值列表。

/sys/.../events/in_accel_gesture_tap_wait_timeout

在文件 sysfs-bus-iio 中定义

启用带有超时的点击手势确认。

/sys/.../events/in_accel_raw_mag_value

/sys/.../events/in_accel_x_raw_mag_rising_value

/sys/.../events/in_accel_y_raw_mag_rising_value

/sys/.../events/in_accel_z_raw_mag_rising_value

在文件 sysfs-bus-iio 中定义

比较通道幅度的值。如果未指定数字或方向，则适用于此类型的所有通道。

/sys/.../events/in_accel_scale

/sys/.../events/in_accel_peak_scale

/sys/.../events/in_anglvel_scale

/sys/.../events/in_magn_scale

/sys/.../events/in_rot_from_north_magnetic_scale

/sys/.../events/in_rot_from_north_true_scale

/sys/.../events/in_voltage_scale

/sys/.../events/in_voltage_supply_scale

/sys/.../events/in_temp_scale

/sys/.../events/in_illuminance_scale

/sys/.../events/in_proximity_scale

在文件 sysfs-bus-iio 中定义

指定从标准单位到用于设置事件触发阈值的设备特定单位的转换因子。

/sys/.../events/in_accel_thresh_rising_high_pass_filter_3db

/sys/.../events/in_anglvel_thresh_rising_high_pass_filter_3db

/sys/.../events/in_magn_thresh_rising_high_pass_filter_3db

在文件 sysfs-bus-iio 中定义

如果可以将高通滤波器应用于事件生成，则此属性给出其 3db 频率（以 Hz 为单位）。值为零会禁用滤波器。

/sys/.../events/in_accel_thresh_rising_low_pass_filter_3db

/sys/.../events/in_anglvel_thresh_rising_low_pass_filter_3db

/sys/.../events/in_magn_thresh_rising_low_pass_filter_3db

在文件 sysfs-bus-iio 中定义

如果可以将低通滤波器应用于事件生成，则此属性给出其 3db 频率（以 Hz 为单位）。值为零会禁用滤波器。

/sys/.../events/in_accel_thresh_rising_value

/sys/.../events/in_accel_thresh_falling_value

/sys/.../events/in_accel_x_raw_thresh_rising_value

/sys/.../events/in_accel_x_raw_thresh_falling_value

/sys/.../events/in_accel_y_raw_thresh_rising_value

/sys/.../events/in_accel_y_raw_thresh_falling_value

/sys/.../events/in_accel_z_raw_thresh_rising_value

/sys/.../events/in_accel_z_raw_thresh_falling_value

/sys/.../events/in_anglvel_x_raw_thresh_rising_value

/sys/.../events/in_anglvel_x_raw_thresh_falling_value

/sys/.../events/in_anglvel_y_raw_thresh_rising_value

/sys/.../events/in_anglvel_y_raw_thresh_falling_value

/sys/.../events/in_anglvel_z_raw_thresh_rising_value

/sys/.../events/in_anglvel_z_raw_thresh_falling_value

/sys/.../events/in_magn_x_raw_thresh_rising_value

/sys/.../events/in_magn_x_raw_thresh_falling_value

/sys/.../events/in_magn_y_raw_thresh_rising_value

/sys/.../events/in_magn_y_raw_thresh_falling_value

/sys/.../events/in_magn_z_raw_thresh_rising_value

/sys/.../events/in_magn_z_raw_thresh_falling_value

/sys/.../events/in_rot_from_north_magnetic_raw_thresh_rising_value

/sys/.../events/in_rot_from_north_magnetic_raw_thresh_falling_value

/sys/.../events/in_rot_from_north_true_raw_thresh_rising_value

/sys/.../events/in_rot_from_north_true_raw_thresh_falling_value

/sys/.../events/in_rot_from_north_magnetic_tilt_comp_raw_thresh_rising_value

/sys/.../events/in_rot_from_north_magnetic_tilt_comp_raw_thresh_falling_value

/sys/.../events/in_rot_from_north_true_tilt_comp_raw_thresh_rising_value

/sys/.../events/in_rot_from_north_true_tilt_comp_raw_thresh_falling_value

/sys/.../events/in_voltageY_supply_raw_thresh_rising_value

/sys/.../events/in_voltageY_supply_raw_thresh_falling_value

/sys/.../events/in_voltageY_raw_thresh_rising_value

/sys/.../events/in_voltageY_raw_thresh_falling_value

/sys/.../events/in_tempY_raw_thresh_rising_value

/sys/.../events/in_tempY_raw_thresh_falling_value

/sys/.../events/in_illuminance0_thresh_falling_value

/sys/.../events/in_illuminance0_thresh_rising_value

/sys/.../events/in_proximity0_thresh_falling_value

/sys/.../events/in_proximity0_thresh_rising_value

/sys/.../events/in_illuminance_thresh_rising_value

/sys/.../events/in_illuminance_thresh_falling_value

/sys/.../events/in_capacitanceY_thresh_rising_value

/sys/.../events/in_capacitanceY_thresh_falling_value

/sys/.../events/in_capacitanceY_thresh_adaptive_rising_value

/sys/.../events/in_capacitanceY_thresh_falling_rising_value

在文件 sysfs-bus-iio 中定义

指定设备正在比较以用于由 <type>Y[_name]_thresh[_rising|falling]_en 启用的事件的阈值。

如果两个方向存在单独的属性，但此属性未指定方向，则单个阈值适用于两个方向。

名称的原始或输入元素表示该值是以原始设备单位还是以处理后的单位表示（如 sysfs 直接通道读取属性中的 _raw 和 _input 所示）。

/sys/.../events/in_accel_x_raw_roc_rising_value

/sys/.../events/in_accel_x_raw_roc_falling_value

/sys/.../events/in_accel_y_raw_roc_rising_value

/sys/.../events/in_accel_y_raw_roc_falling_value

/sys/.../events/in_accel_z_raw_roc_rising_value

/sys/.../events/in_accel_z_raw_roc_falling_value

/sys/.../events/in_anglvel_x_raw_roc_rising_value

/sys/.../events/in_anglvel_x_raw_roc_falling_value

/sys/.../events/in_anglvel_y_raw_roc_rising_value

/sys/.../events/in_anglvel_y_raw_roc_falling_value

/sys/.../events/in_anglvel_z_raw_roc_rising_value

/sys/.../events/in_anglvel_z_raw_roc_falling_value

/sys/.../events/in_magn_x_raw_roc_rising_value

/sys/.../events/in_magn_x_raw_roc_falling_value

/sys/.../events/in_magn_y_raw_roc_rising_value

/sys/.../events/in_magn_y_raw_roc_falling_value

/sys/.../events/in_magn_z_raw_roc_rising_value

/sys/.../events/in_magn_z_raw_roc_falling_value

/sys/.../events/in_rot_from_north_magnetic_raw_roc_rising_value

/sys/.../events/in_rot_from_north_magnetic_raw_roc_falling_value

/sys/.../events/in_rot_from_north_true_raw_roc_rising_value

/sys/.../events/in_rot_from_north_true_raw_roc_falling_value

/sys/.../events/in_rot_from_north_magnetic_tilt_comp_raw_roc_rising_value

/sys/.../events/in_rot_from_north_magnetic_tilt_comp_raw_roc_falling_value

/sys/.../events/in_rot_from_north_true_tilt_comp_raw_roc_rising_value

/sys/.../events/in_rot_from_north_true_tilt_comp_raw_roc_falling_value

/sys/.../events/in_voltageY_supply_raw_roc_rising_value

/sys/.../events/in_voltageY_supply_raw_roc_falling_value

/sys/.../events/in_voltageY_raw_roc_rising_value

/sys/.../events/in_voltageY_raw_roc_falling_value

/sys/.../events/in_tempY_raw_roc_rising_value

/sys/.../events/in_tempY_raw_roc_falling_value

在文件 sysfs-bus-iio 中定义

指定设备用于比较的速率变化阈值，该阈值用于由 <type>[Y][_name]_roc[_rising|falling]_en 启用的事件。

如果两个方向存在单独的属性，但此属性未指定方向，则单个阈值适用于两个方向。名称的 raw 或 input 元素指示该值是以原始设备单位还是以处理过的单位表示（如 sysfs 直接通道读取属性中的 _raw 和 _input 所示）。

/sys/.../events/in_accel_x_thresh_rising_hysteresis

/sys/.../events/in_accel_x_thresh_falling_hysteresis

/sys/.../events/in_accel_x_thresh_either_hysteresis

/sys/.../events/in_accel_y_thresh_rising_hysteresis

/sys/.../events/in_accel_y_thresh_falling_hysteresis

/sys/.../events/in_accel_y_thresh_either_hysteresis

/sys/.../events/in_accel_z_thresh_rising_hysteresis

/sys/.../events/in_accel_z_thresh_falling_hysteresis

/sys/.../events/in_accel_z_thresh_either_hysteresis

/sys/.../events/in_anglvel_x_thresh_rising_hysteresis

/sys/.../events/in_anglvel_x_thresh_falling_hysteresis

/sys/.../events/in_anglvel_x_thresh_either_hysteresis

/sys/.../events/in_anglvel_y_thresh_rising_hysteresis

/sys/.../events/in_anglvel_y_thresh_falling_hysteresis

/sys/.../events/in_anglvel_y_thresh_either_hysteresis

/sys/.../events/in_anglvel_z_thresh_rising_hysteresis

/sys/.../events/in_anglvel_z_thresh_falling_hysteresis

/sys/.../events/in_anglvel_z_thresh_either_hysteresis

/sys/.../events/in_magn_x_thresh_rising_hysteresis

/sys/.../events/in_magn_x_thresh_falling_hysteresis

/sys/.../events/in_magn_x_thresh_either_hysteresis

/sys/.../events/in_magn_y_thresh_rising_hysteresis

/sys/.../events/in_magn_y_thresh_falling_hysteresis

/sys/.../events/in_magn_y_thresh_either_hysteresis

/sys/.../events/in_magn_z_thresh_rising_hysteresis

/sys/.../events/in_magn_z_thresh_falling_hysteresis

/sys/.../events/in_magn_z_thresh_either_hysteresis

/sys/.../events/in_rot_from_north_magnetic_thresh_rising_hysteresis

/sys/.../events/in_rot_from_north_magnetic_thresh_falling_hysteresis

/sys/.../events/in_rot_from_north_magnetic_thresh_either_hysteresis

/sys/.../events/in_rot_from_north_true_thresh_rising_hysteresis

/sys/.../events/in_rot_from_north_true_thresh_falling_hysteresis

/sys/.../events/in_rot_from_north_true_thresh_either_hysteresis

/sys/.../events/in_rot_from_north_magnetic_tilt_comp_thresh_rising_hysteresis

/sys/.../events/in_rot_from_north_magnetic_tilt_comp_thresh_falling_hysteresis

/sys/.../events/in_rot_from_north_magnetic_tilt_comp_thresh_either_hysteresis

/sys/.../events/in_rot_from_north_true_tilt_comp_thresh_rising_hysteresis

/sys/.../events/in_rot_from_north_true_tilt_comp_thresh_falling_hysteresis

/sys/.../events/in_rot_from_north_true_tilt_comp_thresh_either_hysteresis

/sys/.../events/in_voltageY_thresh_rising_hysteresis

/sys/.../events/in_voltageY_thresh_falling_hysteresis

/sys/.../events/in_voltageY_thresh_either_hysteresis

/sys/.../events/in_tempY_thresh_rising_hysteresis

/sys/.../events/in_tempY_thresh_falling_hysteresis

/sys/.../events/in_tempY_thresh_either_hysteresis

/sys/.../events/in_illuminance0_thresh_falling_hysteresis

/sys/.../events/in_illuminance0_thresh_rising_hysteresis

/sys/.../events/in_illuminance0_thresh_either_hysteresis

/sys/.../events/in_proximity0_thresh_falling_hysteresis

/sys/.../events/in_proximity0_thresh_rising_hysteresis

/sys/.../events/in_proximity0_thresh_either_hysteresis

在文件 sysfs-bus-iio 中定义

指定设备用于比较的阈值的迟滞，该阈值用于由 <type>Y[_name]_thresh[_(rising|falling)]_hysteresis 启用的事件。如果两个方向存在单独的属性，但此属性未指定方向，则单个迟滞值适用于两个方向。

对于下降事件，迟滞会被添加到此事件的 _value 属性中，以获得事件恢复正常时的上限阈值；对于上升事件，迟滞会从 _value 属性中减去。例如，如果 in_voltage0_raw_thresh_rising_value 设置为 1200，in_voltage0_raw_thresh_rising_hysteresis 设置为 50。则一旦 in_voltage0_raw 高于 1200，事件将被激活，而一旦值降至 1150 以下，事件将再次被禁用。

/sys/.../events/in_accel_x_thresh_rising_period

/sys/.../events/in_accel_x_thresh_falling_period

/sys/.../events/in_accel_x_roc_rising_period

/sys/.../events/in_accel_x_roc_falling_period

/sys/.../events/in_accel_y_thresh_rising_period

/sys/.../events/in_accel_y_thresh_falling_period

/sys/.../events/in_accel_y_roc_rising_period

/sys/.../events/in_accel_y_roc_falling_period

/sys/.../events/in_accel_z_thresh_rising_period

/sys/.../events/in_accel_z_thresh_falling_period

/sys/.../events/in_accel_z_roc_rising_period

/sys/.../events/in_accel_z_roc_falling_period

/sys/.../events/in_anglvel_x_thresh_rising_period

/sys/.../events/in_anglvel_x_thresh_falling_period

/sys/.../events/in_anglvel_x_roc_rising_period

/sys/.../events/in_anglvel_x_roc_falling_period

/sys/.../events/in_anglvel_y_thresh_rising_period

/sys/.../events/in_anglvel_y_thresh_falling_period

/sys/.../events/in_anglvel_y_roc_rising_period

/sys/.../events/in_anglvel_y_roc_falling_period

/sys/.../events/in_anglvel_z_thresh_rising_period

/sys/.../events/in_anglvel_z_thresh_falling_period

/sys/.../events/in_anglvel_z_roc_rising_period

/sys/.../events/in_anglvel_z_roc_falling_period

/sys/.../events/in_magn_x_thresh_rising_period

/sys/.../events/in_magn_x_thresh_falling_period

/sys/.../events/in_magn_x_roc_rising_period

/sys/.../events/in_magn_x_roc_falling_period

/sys/.../events/in_magn_y_thresh_rising_period

/sys/.../events/in_magn_y_thresh_falling_period

/sys/.../events/in_magn_y_roc_rising_period

/sys/.../events/in_magn_y_roc_falling_period

/sys/.../events/in_magn_z_thresh_rising_period

/sys/.../events/in_magn_z_thresh_falling_period

/sys/.../events/in_magn_z_roc_rising_period

/sys/.../events/in_magn_z_roc_falling_period

/sys/.../events/in_rot_from_north_magnetic_thresh_rising_period

/sys/.../events/in_rot_from_north_magnetic_thresh_falling_period

/sys/.../events/in_rot_from_north_magnetic_roc_rising_period

/sys/.../events/in_rot_from_north_magnetic_roc_falling_period

/sys/.../events/in_rot_from_north_true_thresh_rising_period

/sys/.../events/in_rot_from_north_true_thresh_falling_period

/sys/.../events/in_rot_from_north_true_roc_rising_period

/sys/.../events/in_rot_from_north_true_roc_falling_period

/sys/.../events/in_rot_from_north_magnetic_tilt_comp_thresh_rising_period

/sys/.../events/in_rot_from_north_magnetic_tilt_comp_thresh_falling_period

/sys/.../events/in_rot_from_north_magnetic_tilt_comp_roc_rising_period

/sys/.../events/in_rot_from_north_magnetic_tilt_comp_roc_falling_period

/sys/.../events/in_rot_from_north_true_tilt_comp_thresh_rising_period

/sys/.../events/in_rot_from_north_true_tilt_comp_thresh_falling_period

/sys/.../events/in_rot_from_north_true_tilt_comp_roc_rising_period

/sys/.../events/in_rot_from_north_true_tilt_comp_roc_falling_period

/sys/.../events/in_voltageY_supply_thresh_rising_period

/sys/.../events/in_voltageY_supply_thresh_falling_period

/sys/.../events/in_voltageY_supply_roc_rising_period

/sys/.../events/in_voltageY_supply_roc_falling_period

/sys/.../events/in_voltageY_thresh_rising_period

/sys/.../events/in_voltageY_thresh_falling_period

/sys/.../events/in_voltageY_roc_rising_period

/sys/.../events/in_voltageY_roc_falling_period

/sys/.../events/in_tempY_thresh_rising_period

/sys/.../events/in_tempY_thresh_falling_period

/sys/.../events/in_tempY_roc_rising_period

/sys/.../events/in_tempY_roc_falling_period

/sys/.../events/in_accel_x&y&z_mag_falling_period

/sys/.../events/in_intensity0_thresh_period

/sys/.../events/in_proximity0_thresh_period

/sys/.../events/in_activity_still_thresh_rising_period

/sys/.../events/in_activity_still_thresh_falling_period

/sys/.../events/in_activity_walking_thresh_rising_period

/sys/.../events/in_activity_walking_thresh_falling_period

/sys/.../events/in_activity_jogging_thresh_rising_period

/sys/.../events/in_activity_jogging_thresh_falling_period

/sys/.../events/in_activity_running_thresh_rising_period

/sys/.../events/in_activity_running_thresh_falling_period

/sys/.../events/in_illuminance_thresh_either_period

在文件 sysfs-bus-iio 中定义

生成事件之前必须满足条件的时间段（以秒为单位）。如果未指定方向，则此时间段适用于两个方向。

/sys/.../events/in_activity_still_thresh_rising_en

/sys/.../events/in_activity_still_thresh_falling_en

/sys/.../events/in_activity_walking_thresh_rising_en

/sys/.../events/in_activity_walking_thresh_falling_en

/sys/.../events/in_activity_jogging_thresh_rising_en

/sys/.../events/in_activity_jogging_thresh_falling_en

/sys/.../events/in_activity_running_thresh_rising_en

/sys/.../events/in_activity_running_thresh_falling_en

在文件 sysfs-bus-iio 中定义

启用或禁用活动事件。根据方向，当传感器进入或离开给定状态时会生成事件。

/sys/.../events/in_activity_still_thresh_rising_value

/sys/.../events/in_activity_still_thresh_falling_value

/sys/.../events/in_activity_walking_thresh_rising_value

/sys/.../events/in_activity_walking_thresh_falling_value

/sys/.../events/in_activity_jogging_thresh_rising_value

/sys/.../events/in_activity_jogging_thresh_falling_value

/sys/.../events/in_activity_running_thresh_rising_value

/sys/.../events/in_activity_running_thresh_falling_value

在文件 sysfs-bus-iio 中定义

用于决定何时生成事件的置信度值（单位为百分比）。例如，对于跑步：如果传感器报告的置信度值大于 in_activity_running_thresh_rising_value，则传感器进入跑步状态。相反，如果传感器报告的置信度值低于 in_activity_running_thresh_falling_value，则传感器正在离开跑步状态。

/sys/.../events/in_capacitanceY_adaptive_thresh_rising_en

/sys/.../events/in_capacitanceY_adaptive_thresh_falling_en

在文件 sysfs-bus-iio 中定义

自适应阈值类似于正常的固定阈值，但该值表示为与提供通道本身的低频近似值的值的偏移量。因此，这些检测是否在指定方向上发生快速变化，该变化超过跟踪值 + 偏移量。跟踪值的计算是特定于设备的。

/sys/.../events/in_illuminance0_threshY_hysteresis

在文件 sysfs-bus-iio-light-lm3533-als 中定义

获取阈值 Y 的迟滞，即 threshY_hysteresis = threshY_raising - threshY_falling

/sys/.../events/in_illuminance0_thresh_either_en

在文件 sysfs-bus-iio-light-lm3533-als 中定义

当通道在每个方向（上升|下降）上通过四个阈值之一并且发生区域更改时，会生成事件。相应的光照区域可以从 in_illuminance0_zone 读取。

/sys/.../events/in_proximity_thresh_either_runningcount

在文件 sysfs-bus-iio 中定义

在运行期间，生成事件之前必须发生的条件数量。

/sys/.../events/in_proximity_thresh_either_runningperiod

在文件 sysfs-bus-iio 中定义

生成事件之前必须发生 in_proximity_thresh_either_runningcount 数量的条件的运行时间段（以秒为单位）。如果未指定方向，则此时间段适用于两个方向。

/sys/.../events/in_steps_change_en

在文件 sysfs-bus-iio 中定义

当通道在值的绝对变化上通过阈值时，会生成事件。例如，对于步数：每次用户走 N 步时，都会生成一个步数变化事件，其中 N 使用 in_steps_change_value 设置。

/sys/.../events/in_steps_change_value

在文件 sysfs-bus-iio 中定义

指定设备用于比较的变化阈值，该阈值用于由 <type>[Y][_name]_roc[_rising|falling|]_en 启用的事件。例如，对于步数：如果设置为 3，则每走 3 步将生成一个步数变化事件。

/sys/.../iio:deviceX/bufferY/in_accel_type

/sys/.../iio:deviceX/bufferY/in_deltaangl_type

/sys/.../iio:deviceX/bufferY/in_deltavelocity_type

/sys/.../iio:deviceX/bufferY/in_anglvel_type

/sys/.../iio:deviceX/bufferY/in_magn_type

/sys/.../iio:deviceX/bufferY/in_incli_type

/sys/.../iio:deviceX/bufferY/in_voltageY_type

/sys/.../iio:deviceX/bufferY/in_voltage_type

/sys/.../iio:deviceX/bufferY/in_voltageY_supply_type

/sys/.../iio:deviceX/bufferY/in_voltageY_i_type

/sys/.../iio:deviceX/bufferY/in_voltageY_q_type

/sys/.../iio:deviceX/bufferY/in_voltage_i_type

/sys/.../iio:deviceX/bufferY/in_voltage_q_type

/sys/.../iio:deviceX/bufferY/in_timestamp_type

/sys/.../iio:deviceX/bufferY/in_pressureY_type

/sys/.../iio:deviceX/bufferY/in_pressure_type

/sys/.../iio:deviceX/bufferY/in_rot_quaternion_type

/sys/.../iio:deviceX/bufferY/in_proximity_type

在文件 sysfs-bus-iio 中定义

描述扫描元素在缓冲区中的数据存储方式，以及从用户空间读取数据的形式。形式为 [be|le]:[s|u]bits/storagebits[>>shift]。be 或 le 指定大端或小端。s 或 u 指定有符号（二进制补码）或无符号。bits 是数据位数，storagebits 是数据在缓冲区中占据的空间（填充后）。如果指定了 shift，则是在屏蔽未使用的位之前需要应用的移位。某些设备将其数据放在传输元素的中间，两侧包含其他信息。请注意，某些设备的未使用位中会包含其他信息，因此要获得干净的值，必须使用 bits 值来适当屏蔽缓冲区输出值。storagebits 值还指定了数据对齐方式。因此，s48/64>>2 将是一个存储在与 64 位边界对齐的 64 位位置的有符号 48 位整数。要获得干净的值，请右移 2 位，并应用掩码将结果的最高 16 位清零。对于其他存储组合，此属性将进行适当扩展。

/sys/.../iio:deviceX/bufferY/in_accel_x_en

/sys/.../iio:deviceX/bufferY/in_accel_y_en

/sys/.../iio:deviceX/bufferY/in_accel_z_en

/sys/.../iio:deviceX/bufferY/in_deltaangl_x_en

/sys/.../iio:deviceX/bufferY/in_deltaangl_y_en

/sys/.../iio:deviceX/bufferY/in_deltaangl_z_en

/sys/.../iio:deviceX/bufferY/in_deltavelocity_x_en

/sys/.../iio:deviceX/bufferY/in_deltavelocity_y_en

/sys/.../iio:deviceX/bufferY/in_deltavelocity_z_en

/sys/.../iio:deviceX/bufferY/in_anglvel_x_en

/sys/.../iio:deviceX/bufferY/in_anglvel_y_en

/sys/.../iio:deviceX/bufferY/in_anglvel_z_en

/sys/.../iio:deviceX/bufferY/in_magn_x_en

/sys/.../iio:deviceX/bufferY/in_magn_y_en

/sys/.../iio:deviceX/bufferY/in_magn_z_en

/sys/.../iio:deviceX/bufferY/in_rot_from_north_magnetic_en

/sys/.../iio:deviceX/bufferY/in_rot_from_north_true_en

/sys/.../iio:deviceX/bufferY/in_rot_from_north_magnetic_tilt_comp_en

/sys/.../iio:deviceX/bufferY/in_rot_from_north_true_tilt_comp_en

/sys/.../iio:deviceX/bufferY/in_timestamp_en

/sys/.../iio:deviceX/bufferY/in_voltageY_supply_en

/sys/.../iio:deviceX/bufferY/in_voltageY_en

/sys/.../iio:deviceX/bufferY/in_voltageY-voltageZ_en

/sys/.../iio:deviceX/bufferY/in_voltageY_i_en

/sys/.../iio:deviceX/bufferY/in_voltageY_q_en

/sys/.../iio:deviceX/bufferY/in_voltage_i_en

/sys/.../iio:deviceX/bufferY/in_voltage_q_en

/sys/.../iio:deviceX/bufferY/in_incli_x_en

/sys/.../iio:deviceX/bufferY/in_incli_y_en

/sys/.../iio:deviceX/bufferY/in_pressureY_en

/sys/.../iio:deviceX/bufferY/in_pressure_en

/sys/.../iio:deviceX/bufferY/in_rot_quaternion_en

/sys/.../iio:deviceX/bufferY/in_proximity_en

在文件 sysfs-bus-iio 中定义

用于触发数据捕获的扫描元素控制。

/sys/.../iio:deviceX/bufferY/in_voltageY_index

/sys/.../iio:deviceX/bufferY/in_voltageY_supply_index

/sys/.../iio:deviceX/bufferY/in_voltageY_i_index

/sys/.../iio:deviceX/bufferY/in_voltageY_q_index

/sys/.../iio:deviceX/bufferY/in_voltage_i_index

/sys/.../iio:deviceX/bufferY/in_voltage_q_index

/sys/.../iio:deviceX/bufferY/in_accel_x_index

/sys/.../iio:deviceX/bufferY/in_accel_y_index

/sys/.../iio:deviceX/bufferY/in_accel_z_index

/sys/.../iio:deviceX/bufferY/in_deltaangl_x_index

/sys/.../iio:deviceX/bufferY/in_deltaangl_y_index

/sys/.../iio:deviceX/bufferY/in_deltaangl_z_index

/sys/.../iio:deviceX/bufferY/in_deltavelocity_x_index

/sys/.../iio:deviceX/bufferY/in_deltavelocity_y_index

/sys/.../iio:deviceX/bufferY/in_deltavelocity_z_index

/sys/.../iio:deviceX/bufferY/in_anglvel_x_index

/sys/.../iio:deviceX/bufferY/in_anglvel_y_index

/sys/.../iio:deviceX/bufferY/in_anglvel_z_index

/sys/.../iio:deviceX/bufferY/in_magn_x_index

/sys/.../iio:deviceX/bufferY/in_magn_y_index

/sys/.../iio:deviceX/bufferY/in_magn_z_index

/sys/.../iio:deviceX/bufferY/in_rot_from_north_magnetic_index

/sys/.../iio:deviceX/bufferY/in_rot_from_north_true_index

/sys/.../iio:deviceX/bufferY/in_rot_from_north_magnetic_tilt_comp_index

/sys/.../iio:deviceX/bufferY/in_rot_from_north_true_tilt_comp_index

/sys/.../iio:deviceX/bufferY/in_incli_x_index

/sys/.../iio:deviceX/bufferY/in_incli_y_index

/sys/.../iio:deviceX/bufferY/in_timestamp_index

/sys/.../iio:deviceX/bufferY/in_pressureY_index

/sys/.../iio:deviceX/bufferY/in_pressure_index

/sys/.../iio:deviceX/bufferY/in_rot_quaternion_index

/sys/.../iio:deviceX/bufferY/in_proximity_index

在文件 sysfs-bus-iio 中定义

一个正整数，指定此扫描元素在缓冲区中的位置。请注意，这些位置不依赖于启用的内容，并且可能不连续。因此，为了让用户空间建立完整的布局，必须结合所有 _en 属性来确定存在哪些通道，并结合相关的 _type 属性来确定数据存储格式。

/sys/.../iio:deviceX/events/in_accel_mag_en

/sys/.../iio:deviceX/events/in_accel_mag_rising_en

/sys/.../iio:deviceX/events/in_accel_mag_falling_en

/sys/.../iio:deviceX/events/in_accel_x_mag_en

/sys/.../iio:deviceX/events/in_accel_x_mag_rising_en

/sys/.../iio:deviceX/events/in_accel_x_mag_falling_en

/sys/.../iio:deviceX/events/in_accel_y_mag_en

/sys/.../iio:deviceX/events/in_accel_y_mag_rising_en

/sys/.../iio:deviceX/events/in_accel_y_mag_falling_en

/sys/.../iio:deviceX/events/in_accel_z_mag_en

/sys/.../iio:deviceX/events/in_accel_z_mag_rising_en

/sys/.../iio:deviceX/events/in_accel_z_mag_falling_en

/sys/.../iio:deviceX/events/in_accel_x&y&z_mag_rising_en

/sys/.../iio:deviceX/events/in_accel_x&y&z_mag_falling_en

在文件 sysfs-bus-iio 中定义

类似于 in_accel_x_thresh[_rising|_falling]_en，但这里是将通道的幅度与阈值进行比较，而不是其有符号值。

/sys/.../iio:deviceX/events/in_accel_mag_referenced_en

/sys/.../iio:deviceX/events/in_accel_mag_referenced_rising_en

/sys/.../iio:deviceX/events/in_accel_mag_referenced_falling_en

/sys/.../iio:deviceX/events/in_accel_y_mag_referenced_en

/sys/.../iio:deviceX/events/in_accel_y_mag_referenced_rising_en

/sys/.../iio:deviceX/events/in_accel_y_mag_referenced_falling_en

在文件 sysfs-bus-iio 中定义

类似于 in_accel_mag[_y][_rising|_falling]_en，但事件值相对于参考幅度。参考幅度包括重力加速度。

/sys/.../iio:deviceX/events/in_accel_mag_referenced_value

/sys/.../iio:deviceX/events/in_accel_mag_referenced_rising_value

/sys/.../iio:deviceX/events/in_accel_mag_referenced_falling_value

/sys/.../iio:deviceX/events/in_accel_y_mag_referenced_value

/sys/.../iio:deviceX/events/in_accel_y_mag_referenced_rising_value

/sys/.../iio:deviceX/events/in_accel_y_mag_referenced_falling_value

在文件 sysfs-bus-iio 中定义

通道的参考幅度与之进行比较的值。如果未指定轴，则它适用于此类型的所有通道。

/sys/.../iio:deviceX/events/in_accel_x_roc_rising_en

/sys/.../iio:deviceX/events/in_accel_x_roc_falling_en

/sys/.../iio:deviceX/events/in_accel_y_roc_rising_en

/sys/.../iio:deviceX/events/in_accel_y_roc_falling_en

/sys/.../iio:deviceX/events/in_accel_z_roc_rising_en

/sys/.../iio:deviceX/events/in_accel_z_roc_falling_en

/sys/.../iio:deviceX/events/in_anglvel_x_roc_rising_en

/sys/.../iio:deviceX/events/in_anglvel_x_roc_falling_en

/sys/.../iio:deviceX/events/in_anglvel_y_roc_rising_en

/sys/.../iio:deviceX/events/in_anglvel_y_roc_falling_en

/sys/.../iio:deviceX/events/in_anglvel_z_roc_rising_en

/sys/.../iio:deviceX/events/in_anglvel_z_roc_falling_en

/sys/.../iio:deviceX/events/in_magn_x_roc_rising_en

/sys/.../iio:deviceX/events/in_magn_x_roc_falling_en

/sys/.../iio:deviceX/events/in_magn_y_roc_rising_en

/sys/.../iio:deviceX/events/in_magn_y_roc_falling_en

/sys/.../iio:deviceX/events/in_magn_z_roc_rising_en

/sys/.../iio:deviceX/events/in_magn_z_roc_falling_en

/sys/.../iio:deviceX/events/in_rot_from_north_magnetic_roc_rising_en

/sys/.../iio:deviceX/events/in_rot_from_north_magnetic_roc_falling_en

/sys/.../iio:deviceX/events/in_rot_from_north_true_roc_rising_en

/sys/.../iio:deviceX/events/in_rot_from_north_true_roc_falling_en

/sys/.../iio:deviceX/events/in_rot_from_north_magnetic_tilt_comp_roc_rising_en

/sys/.../iio:deviceX/events/in_rot_from_north_magnetic_tilt_comp_roc_falling_en

/sys/.../iio:deviceX/events/in_rot_from_north_true_tilt_comp_roc_rising_en

/sys/.../iio:deviceX/events/in_rot_from_north_true_tilt_comp_roc_falling_en

/sys/.../iio:deviceX/events/in_voltageY_supply_roc_rising_en

/sys/.../iio:deviceX/events/in_voltageY_supply_roc_falling_en

/sys/.../iio:deviceX/events/in_voltageY_roc_rising_en

/sys/.../iio:deviceX/events/in_voltageY_roc_falling_en

/sys/.../iio:deviceX/events/in_tempY_roc_rising_en

/sys/.../iio:deviceX/events/in_tempY_roc_falling_en

在文件 sysfs-bus-iio 中定义

当通道在指定 (_rising|_falling) 方向上通过变化率（一阶微分）的阈值时生成事件。如果未指定方向，则无论在哪个方向上通过单个阈值，设备都会报告一个事件（例如，<type>[Y][_name]_<raw|input>_roc_value），或者 <type>[Y][_name]_<raw|input>_roc_rising_value 和 <type>[Y][_name]_<raw|input>_roc_falling_value 可能采用不同的值，但设备只能启用两个变化率阈值或都不启用。

请注意，驱动程序会假定要启用最后请求的 p 个事件，其中 p 是它支持的数量（可能因请求的确切集而异）。因此，如果您想确定已设置了您认为已设置的内容，请在配置完所有内容后检查这些属性的内容。驱动程序可能必须缓冲任何参数，以便在未来某个时间启用给定的事件类型时保持一致（而不是之前启用的任何事件的参数）。

/sys/.../iio:deviceX/events/in_accel_x_thresh_rising_en

/sys/.../iio:deviceX/events/in_accel_x_thresh_falling_en

/sys/.../iio:deviceX/events/in_accel_y_thresh_rising_en

/sys/.../iio:deviceX/events/in_accel_y_thresh_falling_en

/sys/.../iio:deviceX/events/in_accel_z_thresh_rising_en

/sys/.../iio:deviceX/events/in_accel_z_thresh_falling_en

/sys/.../iio:deviceX/events/in_anglvel_x_thresh_rising_en

/sys/.../iio:deviceX/events/in_anglvel_x_thresh_falling_en

/sys/.../iio:deviceX/events/in_anglvel_y_thresh_rising_en

/sys/.../iio:deviceX/events/in_anglvel_y_thresh_falling_en

/sys/.../iio:deviceX/events/in_anglvel_z_thresh_rising_en

/sys/.../iio:deviceX/events/in_anglvel_z_thresh_falling_en

/sys/.../iio:deviceX/events/in_magn_x_thresh_rising_en

/sys/.../iio:deviceX/events/in_magn_x_thresh_falling_en

/sys/.../iio:deviceX/events/in_magn_y_thresh_rising_en

/sys/.../iio:deviceX/events/in_magn_y_thresh_falling_en

/sys/.../iio:deviceX/events/in_magn_z_thresh_rising_en

/sys/.../iio:deviceX/events/in_magn_z_thresh_falling_en

/sys/.../iio:deviceX/events/in_rot_from_north_magnetic_thresh_rising_en

/sys/.../iio:deviceX/events/in_rot_from_north_magnetic_thresh_falling_en

/sys/.../iio:deviceX/events/in_rot_from_north_true_thresh_rising_en

/sys/.../iio:deviceX/events/in_rot_from_north_true_thresh_falling_en

/sys/.../iio:deviceX/events/in_rot_from_north_magnetic_tilt_comp_thresh_rising_en

/sys/.../iio:deviceX/events/in_rot_from_north_magnetic_tilt_comp_thresh_falling_en

/sys/.../iio:deviceX/events/in_rot_from_north_true_tilt_comp_thresh_rising_en

/sys/.../iio:deviceX/events/in_rot_from_north_true_tilt_comp_thresh_falling_en

/sys/.../iio:deviceX/events/in_voltageY_supply_thresh_rising_en

/sys/.../iio:deviceX/events/in_voltageY_supply_thresh_falling_en

/sys/.../iio:deviceX/events/in_voltageY_thresh_rising_en

/sys/.../iio:deviceX/events/in_voltageY_thresh_falling_en

/sys/.../iio:deviceX/events/in_voltageY_thresh_either_en

/sys/.../iio:deviceX/events/in_tempY_thresh_rising_en

/sys/.../iio:deviceX/events/in_tempY_thresh_falling_en

/sys/.../iio:deviceX/events/in_capacitanceY_thresh_rising_en

/sys/.../iio:deviceX/events/in_capacitanceY_thresh_falling_en

在文件 sysfs-bus-iio 中定义

当通道在指定 (_rising|_falling) 方向上通过阈值时生成事件。如果未指定方向，则无论在哪个方向上通过单个阈值，设备都会报告一个事件（例如，<type>[Y][_name]_<raw|input>_thresh_value），或者 <type>[Y][_name]_<raw|input>_thresh_rising_value 和 <type>[Y][_name]_<raw|input>_thresh_falling_value 可能采用不同的值，但设备只能启用两个阈值或都不启用。

请注意，驱动程序会假定要启用最后请求的 p 个事件，其中 p 是它支持的数量（可能因请求的确切集而异）。因此，如果您想确定已设置了您认为已设置的内容，请在配置完所有内容后检查这些属性的内容。驱动程序可能必须缓冲任何参数，以便在未来某个时间启用给定的事件类型时保持一致（而不是之前启用的任何事件的参数）。

/sys/.../iio:deviceX/in_accelX_power_mode

在文件 sysfs-bus-iio 中定义

指定芯片的电源模式。low_noise：降低来自 ADC 的噪声水平，low_power：启用低电流消耗。有关可用输出电源模式的列表，请读取 in_accel_power_mode_available。

/sys/.../iio:deviceX/in_activity_still_input

/sys/.../iio:deviceX/in_activity_walking_input

/sys/.../iio:deviceX/in_activity_jogging_input

/sys/.../iio:deviceX/in_activity_running_input

在文件 sysfs-bus-iio 中定义

此属性用于读取以百分比表示的活动置信度。

/sys/.../iio:deviceX/in_anglvel_z_quadrature_correction_raw

在文件 sysfs-bus-iio 中定义

此属性用于读取设备在给定时间存在的正交误差量。

/sys/.../iio:deviceX/in_attention_input

在文件 sysfs-bus-iio 中定义

表示用户对系统关注程度的值，以百分比表示。这通常意味着用户是否正在看屏幕。

/sys/.../iio:deviceX/in_capacitableY_calibbias_calibration

/sys/.../iio:deviceX/in_capacitableY_calibscale_calibration

定义在文件 sysfs-bus-iio-cdc-ad7746

写入 1 以触发 calibbias 或 calibscale 的校准。对于 calibscale，应将满量程电容连接到电容输入，然后启动 calibscale_calibration。对于 calibbias，请参阅设备数据手册中关于“电容系统偏移校准”的部分。

/sys/.../iio:deviceX/in_capacitanceY-capacitanceZ_raw

在文件 sysfs-bus-iio 中定义

原始差分电容测量值，等效于通道 Y - 通道 Z，其中这些通道号适用于非差分读数单独可用时的物理等效输入。在仅限差分部件中，只需要一致的标签即可。应用比例和偏移后的单位是纳法拉。

/sys/.../iio:deviceX/in_capacitanceY-capacitanceZ_zeropoint

在文件 sysfs-bus-iio 中定义

对于差分通道，这是一个同时应用于两个输入的偏移量。由于读数是两个输入之间的差值，因此用户空间不应将其应用于 _raw 读数（与 _offset 不同），并且与 calibbias 不同，它不会影响测量的差分值，因为 _zeropoint 的影响会在构成差分对的两个输入之间相互抵消。它的目的是在测量差分之前，将各个信号置于设备的测量范围内。选择此名称是因为如果将构成差分对的单独输入以其 _raw 单位绘制在图表上，则这是测量轴上的零点所代表的值。它以与 _raw 相同的比例表示。

/sys/.../iio:deviceX/in_distance_input

/sys/.../iio:deviceX/in_distance_raw

在文件 sysfs-bus-iio 中定义

此属性用于读取测得的到物体的距离，或者自上次重启激活以来用户走过的距离。应用比例后的单位是米。

/sys/.../iio:deviceX/in_energy_en

/sys/.../iio:deviceX/in_distance_en

/sys/.../iio:deviceX/in_velocity_sqrt(x^2+y^2+z^2)_en

/sys/.../iio:deviceX/in_steps_en

在文件 sysfs-bus-iio 中定义

激活在固件/硬件中运行的设备功能。例如，对于步数：计步器在不使用时会节省电量；激活后，它将在固件中计算用户所走的步数，并通过 in_steps_input 导出它们。

/sys/.../iio:deviceX/in_energy_input

/sys/.../iio:deviceX/in_energy_raw

在文件 sysfs-bus-iio 中定义

此属性用于读取设备报告的能量值（例如：人体活动传感器报告用户消耗的能量）。应用比例后的单位是焦耳。

/sys/.../iio:deviceX/in_illuminance_input

/sys/.../iio:deviceX/in_illuminance_raw

/sys/.../iio:deviceX/in_illuminanceY_input

/sys/.../iio:deviceX/in_illuminanceY_raw

/sys/.../iio:deviceX/in_illuminanceY_mean_raw

/sys/.../iio:deviceX/in_illuminance_ir_raw

/sys/.../iio:deviceX/in_illuminance_clear_raw

在文件 sysfs-bus-iio 中定义

光照度测量值，应用比例和偏移后的单位是勒克斯。

/sys/.../iio:deviceX/in_intensityY_raw

/sys/.../iio:deviceX/in_intensityY_ir_raw

/sys/.../iio:deviceX/in_intensityY_both_raw

/sys/.../iio:deviceX/in_intensityY_uv_raw

/sys/.../iio:deviceX/in_intensityY_uva_raw

/sys/.../iio:deviceX/in_intensityY_uvb_raw

/sys/.../iio:deviceX/in_intensityY_duv_raw

在文件 sysfs-bus-iio 中定义

无单位的光强度。修饰符 both 和 ir 表示测量值分别包含可见光和红外光成分，或者仅包含红外光。修饰符 uv 表示测量值包含紫外光成分。修饰符 uva、uvb 和 duv 表示测量值分别包含 A、B 或深（C）紫外光成分。

/sys/.../iio:deviceX/in_intensity_integration_time

/sys/.../iio:deviceX/in_intensity_red_integration_time

/sys/.../iio:deviceX/in_intensity_green_integration_time

/sys/.../iio:deviceX/in_intensity_blue_integration_time

/sys/.../iio:deviceX/in_intensity_clear_integration_time

/sys/.../iio:deviceX/in_illuminance_integration_time

在文件 sysfs-bus-iio 中定义

此属性用于获取/设置以秒为单位的积分时间。如果给定类型的所有通道共享，则使用 <type>_integration_time。

/sys/.../iio:deviceX/in_proximity_raw

/sys/.../iio:deviceX/in_proximity_input

/sys/.../iio:deviceX/in_proximityY_raw

在文件 sysfs-bus-iio 中定义

接近度测量，指示某些物体靠近传感器，通常通过观察发射的红外线或超声波的反射率来实现。

通常，这些传感器没有单位，因此无法转换为国际单位制单位。较高的接近度测量值表示物体更近，反之亦然。应用比例和偏移后的单位是米。

/sys/.../iio:deviceX/in_shunt_resistor

/sys/.../iio:deviceX/in_current_shunt_resistor

/sys/.../iio:deviceX/in_power_shunt_resistor

在文件 sysfs-bus-iio 中定义

分流电阻的阻值，单位为欧姆。

/sys/.../iio:deviceX/in_steps_debounce_count

在文件 sysfs-bus-iio 中定义

指定在 in_steps_filter_debounce_time 内必须发生的步数，以便计步器确定消费者正在迈步。

/sys/.../iio:deviceX/in_steps_debounce_time

在文件 sysfs-bus-iio 中定义

指定我们计算发生的步数的时间（以秒为单位），以便确定消费者是否正在迈步。

/sys/.../iio:deviceX/in_steps_input

在文件 sysfs-bus-iio 中定义

此属性用于读取自上次重启激活以来用户所走的步数。

/sys/.../iio:deviceX/in_uvindex_input

在文件 sysfs-bus-iio 中定义

紫外线强度指数，衡量人体皮肤对不同波长阳光的反应，根据标准化的 CIE 红斑作用光谱进行加权。紫外线指数值范围从 0（低）到 >=11（极端）。

/sys/.../iio:deviceX/in_velocity_sqrt(x^2+y^2+z^2)_input

/sys/.../iio:deviceX/in_velocity_sqrt(x^2+y^2+z^2)_raw

在文件 sysfs-bus-iio 中定义

此属性用于读取用户当前的速率值（即速度矢量的范数或大小）。应用比例后的单位是米/秒。

/sys/.../iio:deviceX/in_velocity_sqrt(x^2+y^2+z^2)_integration_time

在文件 sysfs-bus-iio 中定义

计算速度的时间，单位为秒。

/sys/.../iio:deviceX/out_voltageY_powerdown_mode_available

/sys/.../iio:deviceX/out_voltage_powerdown_mode_available

/sys/.../iio:deviceX/out_altvoltageY_powerdown_mode_available

/sys/.../iio:deviceX/out_altvoltage_powerdown_mode_available

在文件 sysfs-bus-iio 中定义

列出所有可用的输出掉电模式。如果 Y 不存在，则该模式在所有输出之间共享。

/sys/.../iio:deviceX/scan_elements/in_accel_type_available

在文件 sysfs-bus-iio 中定义

如果 type 参数可以采用一小组值之一，则此属性会列出这些值。

/sys/.../in_accel_filter_high_pass_3db_frequency

/sys/.../in_anglvel_filter_high_pass_3db_frequency

/sys/.../in_magn_filter_high_pass_3db_frequency

在文件 sysfs-bus-iio 中定义

如果对底层数据通道应用了已知或可控的高通滤波器，则此参数给出滤波器的 3dB 频率，单位为 Hz。

/sys/.../in_accel_filter_low_pass_3db_frequency

/sys/.../in_magn_filter_low_pass_3db_frequency

/sys/.../in_anglvel_filter_low_pass_3db_frequency

在文件 sysfs-bus-iio 中定义

如果对底层数据通道应用了已知或可控的低通滤波器，则此参数给出滤波器的 3dB 频率，单位为 Hz。

/sys/.../in_capacitanceY_adaptive_thresh_rising_timeout

/sys/.../in_capacitanceY_adaptive_thresh_falling_timeout

在文件 sysfs-bus-iio 中定义

当使用自适应阈值时，跟踪信号的调整可能太慢，无法适应原始信号中的阶跃变化。因此，这些参数指定慢速跟踪信号和原始信号之间的差异允许保持超出范围的时间（以秒为单位），之后会发生重置事件，在该事件中，跟踪信号等于原始信号，从而允许恢复慢速跟踪并使自适应阈值事件检测按预期工作。

/sys/.../mdev_supported_types/<type-id>/available_instances

在文件 sysfs-bus-vfio-mdev 中定义

读取此属性将显示可以创建的 <type-id> 类型的中介设备的数量。这是一个只读文件。

用户

对创建该类型的中介设备感兴趣的用户空间应用程序。用户空间应用程序应检查可以创建的可用实例的数量，然后再创建此类型的中介设备。

/sys/.../mdev_supported_types/<type-id>/create

在文件 sysfs-bus-vfio-mdev 中定义

将 UUID 写入此文件将为父设备 <device> 创建 <type-id> 类型的中介设备。这是一个只写文件。例如

# echo "83b8f4f2-509f-382f-3c1e-e6bfe0fa1001" >       \
     /sys/devices/foo/mdev_supported_types/foo-1/create

/sys/.../mdev_supported_types/<type-id>/description

在文件 sysfs-bus-vfio-mdev 中定义

读取此属性将显示将创建的 <type-id> 类型的中介设备的类型描述。这是一个可选属性。例如：“2 个头，512M FB，最大分辨率 2560x1600”

用户

对了解特定 <type-id> 的详细信息感兴趣的用户空间应用程序，这有助于了解该类型的中介设备提供的功能。

/sys/.../mdev_supported_types/<type-id>/device_api

在文件 sysfs-bus-vfio-mdev 中定义

读取此属性将显示此类型支持的 VFIO 设备 API。例如，PCI 设备的“vfio-pci”，平台设备的“vfio-platform”。

/sys/.../mdev_supported_types/<type-id>/devices/

在文件 sysfs-bus-vfio-mdev 中定义

此目录包含指向此 <type-id> 创建的 mdev 设备 sysfs 条目的符号链接。

/sys/.../mdev_supported_types/<type-id>/name

在文件 sysfs-bus-vfio-mdev 中定义

读取此属性将显示将创建的 <type-id> 类型的中介设备的人类可读名称。这是一个可选属性。例如：“Grid M60-0Q”

用户

对了解特定 <type-id> 的名称感兴趣的用户空间应用程序，这有助于了解中介设备的类型。

/sys/.../uevent

在文件 sysfs-uevent 中定义

允许为通过写入 /sys/.../uevent 文件生成的合成 uevent 传递其他变量。

识别的扩展格式是

ACTION [UUID [KEY=VALUE ...]

ACTION 是强制性的 - 它是 uevent 操作的名称（add，change，remove）。与此处之前的函数相比，没有任何变化。扩展格式的其余部分是可选的。

您需要在任何 KEY=VALUE 对之前传递 UUID。UUID 必须是 xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx 格式，其中 ‘x’ 是十六进制数字。UUID 被视为事务标识符，因此可以为一个或多个合成 uevent 使用相同的 UUID 值，在这种情况下，我们会将这些 uevent 逻辑分组在一起，以供任何用户空间侦听器使用。UUID 值在 uevent 中显示为 SYNTH_UUID=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx 环境变量。

如果未传递 UUID，则生成的合成 uevent 会自动获得 SYNTH_UUID=0 环境变量。

KEY=VALUE 对只能包含字母数字字符。

可以定义零个或多个对 - 每对都用空格字符 ‘ ’ 分隔。每对在合成 uevent 中显示为 SYNTH_ARG_KEY=VALUE。这意味着 KEY 名称会获得 SYNTH_ARG_ 前缀，以避免可能与现有变量发生冲突。

写入 uevent 文件的有效序列示例

add fe4d7c9d-b8c6-4a70-9ef1-3d8a58d18eed A=1 B=abc

这将生成包含这些变量的合成 uevent

ACTION=add
SYNTH_ARG_A=1
SYNTH_ARG_B=abc
SYNTH_UUID=fe4d7c9d-b8c6-4a70-9ef1-3d8a58d18eed

用户

udev、用户空间工具生成合成 uevent

/sys/block 下的符号

/sys/block/*/device/cdl_enable

在文件 sysfs-block-device 中定义

（RW）对于支持命令持续时间限制功能的设备，写入该文件可打开或关闭该功能。默认情况下，此功能处于关闭状态。将“1”写入此文件会启用内核中读写命令的命令持续时间限制的使用，并打开设备上的功能。写入“0”会禁用该功能。

/sys/block/*/device/cdl_supported

在文件 sysfs-block-device 中定义

（RO）指示设备是否支持某些 ATA 和 SCSI 设备中的命令持续时间限制功能。

/sys/block/*/device/ncq_prio_enable

在文件 sysfs-block-device 中定义

（RW）写入该文件可打开或关闭 SATA NCQ（本机命令队列）优先级支持。默认情况下，此功能处于关闭状态。如果设备不支持 SATA NCQ 优先级功能，则将“1”写入此文件会导致错误（请参阅 ncq_prio_supported）。

/sys/block/*/device/ncq_prio_supported

在文件 sysfs-block-device 中定义

（RO）指示设备是否支持 SATA NCQ（本机命令队列）优先级功能。

/sys/block/*/device/sas_ncq_prio_enable

在文件 sysfs-block-device 中定义

（RW）这是连接到 SAS 主机总线适配器（HBA）的 SATA 设备的 ncq_prio_enable 属性文件的等效项，该适配器实现了对 SATA NCQ 优先级功能的支持。如果 HBA 驱动程序未实现对 SATA NCQ 优先级功能的支持，则此文件不存在，无论设备是否支持此功能（请参阅 sas_ncq_prio_supported）。

/sys/block/*/device/sas_ncq_prio_supported

在文件 sysfs-block-device 中定义

（RO）这是连接到 SAS 主机总线适配器（HBA）的 SATA 设备的 ncq_prio_supported 属性文件的等效项，该适配器实现了对 SATA NCQ 优先级功能的支持。如果 HBA 驱动程序未实现对 SATA NCQ 优先级功能的支持，则此文件不存在，无论设备是否支持此功能。

/sys/block/*/device/sw_activity

在文件 sysfs-block-device 中定义

（RW）由支持软件控制的活动 LED 的驱动程序使用。

它具有以下有效值

0

OFF - LED 未在活动时激活

1

BLINK_ON - 检测到活动时，LED 每 10 毫秒闪烁一次。

2

BLINK_OFF - 空闲时 LED 亮起，检测到活动时每 10 毫秒熄灭一次。

请注意，如果用户希望通过 em_message 文件控制活动 LED，则必须关闭 sw_activity。

/sys/block/*/device/unload_heads

在文件 sysfs-block-device 中定义

（读写）硬盘防震保护

向此文件写入一个整数值会将相应驱动器的磁头从盘片上移开，并阻止指定毫秒数的所有 I/O 操作。

  • 如果设备不支持卸载磁头功能，则访问将被拒绝并返回 -EOPNOTSUPP。

  • 接受的最大超时值为 30000 毫秒。

  • 通过指定超时值为 0，可以取消先前设置的超时，并且磁盘可以立即恢复正常操作。

  • 某些硬盘仅符合较早版本的 ATA 标准，但仍然支持卸载功能。 Linux 没有安全的方法来检测这些设备，因此默认情况下不启用此功能。 如果已知您的设备确实支持卸载功能，则可以通过写入 -1 来告知内核启用它。 可以通过写入 -2 再次禁用它。

  • 低于 -2 的值将被拒绝并返回 -EINVAL

有关更多信息，请参见 硬盘防震保护

/sys/block/<device>/iosched/target_latency

在文件 sysfs-cfq-target-latency 中定义

只有当用户将 cfq 设置为 /sys/block/<device>/scheduler 时， /sys/block/<device>/iosched/target_latency 才存在。 它包含 cfq 的估计延迟时间。 cfq 将使用它来计算每个任务使用的时间片。

/sys/block/<disk>/bcache/btree_cache_size

在文件 sysfs-block-bcache 中定义

当前缓存在内存中的 btree 桶/节点的数量； 缓存会动态地增长和缩小，以响应系统中其余部分的内存压力。

/sys/block/<disk>/bcache/btree_written

在文件 sysfs-block-bcache 中定义

对于缓存，以人类可读的单位表示的所有 btree 写入的总和。

/sys/block/<disk>/bcache/bucket_size

在文件 sysfs-block-bcache 中定义

对于缓存，以人类可读的单位表示的桶大小，在创建缓存时设置； 为了获得最佳性能，应该与 SSD 的擦除块大小相匹配。

/sys/block/<disk>/bcache/bypassed

在文件 sysfs-block-bcache 中定义

所有绕过缓存（由于顺序截止）的读取和写入的总和。 以人类可读的单位表示为字节。

/sys/block/<disk>/bcache/cache

在文件 sysfs-block-bcache 中定义

对于具有缓存的后备设备，指向该缓存的 bcache/ 目录的符号链接。

/sys/block/<disk>/bcache/cache_hit_ratio

在文件 sysfs-block-bcache 中定义

对于后备设备：缓存命中率，以百分比表示。

/sys/block/<disk>/bcache/cache_hits

在文件 sysfs-block-bcache 中定义

对于后备设备：每个 bio 计数的完整缓存命中次数的整数值。 部分缓存命中计为未命中。

/sys/block/<disk>/bcache/cache_misses

在文件 sysfs-block-bcache 中定义

对于后备设备：缓存未命中的整数值。

/sys/block/<disk>/bcache/clear_stats

在文件 sysfs-block-bcache 中定义

写入此文件会重置该设备的所有统计信息。

/sys/block/<disk>/bcache/discard

在文件 sysfs-block-bcache 中定义

对于缓存，一个布尔值，允许在设备支持的情况下关闭或重新打开 discard/TRIM。

/sys/block/<disk>/bcache/nbuckets

在文件 sysfs-block-bcache 中定义

对于缓存，可用桶的数量。

/sys/block/<disk>/bcache/sequential_cutoff

在文件 sysfs-block-bcache 中定义

对于后备设备：超过该阈值后，顺序 IO 将跳过缓存。 以人类可读的单位（例如，echo 10M > sequntial_cutoff）读取和写入字节。

/sys/block/<disk>/bcache/synchronous

在文件 sysfs-block-bcache 中定义

对于缓存，一个布尔值，允许打开和关闭同步模式。 在同步模式下，所有写入都按顺序排列，以便缓存可以从不干净的关机中可靠地恢复； 如果禁用，bcache 通常不会等待写入完成，但如果缓存未干净关闭，则缓存中的所有数据都将被丢弃。 不应在启用回写缓存的情况下关闭。

/sys/block/<disk>/bcache/tree_depth

在文件 sysfs-block-bcache 中定义

对于缓存，不包括叶节点的 btree 的高度（即，单节点树的深度为 0）。

/sys/block/<disk>/bcache/unregister

在文件 sysfs-block-bcache 中定义

写入此文件会导致注销后备设备或缓存。 如果后备设备在缓存中有脏数据，则会自动禁用回写模式，并且在注销设备之前会刷新所有脏数据。 缓存在注销自身之前，会注销所有关联的后备设备。

/sys/block/<disk>/bcache/writeback

在文件 sysfs-block-bcache 中定义

对于后备设备：启用时，将启用回写缓存，并且写入将在缓存中缓冲。 关闭时，缓存处于直写模式； 读取和写入将被添加到缓存中，但不会发生写入缓冲。

/sys/block/<disk>/bcache/writeback_delay

在文件 sysfs-block-bcache 中定义

对于后备设备：在回写模式下，当脏数据被写入缓存并且缓存没有为该后备设备保留脏数据时，从缓存到后备设备的回写在此延迟后开始，以秒为单位的整数表示。

/sys/block/<disk>/bcache/writeback_percent

在文件 sysfs-block-bcache 中定义

对于后备设备：如果非零，则仅当缓存使用超过此百分比时，才会发生从缓存到后备设备的回写，从而允许进行更多写入合并，并减少发送到后备设备的写入总数。 介于 0 和 40 之间的整数。

/sys/block/<disk>/bcache/writeback_running

在文件 sysfs-block-bcache 中定义

对于后备设备：关闭时，不会将脏数据从缓存写入后备设备。 缓存仍将用于缓冲写入，直到它基本填满为止，此时写入会透明地恢复到直写模式。 仅用于基准测试/测试。

/sys/block/<disk>/bcache/written

在文件 sysfs-block-bcache 中定义

对于缓存，以人类可读的单位表示的写入缓存的数据总量，不包括所有元数据。

/sys/block/dm-<num>/dm/name

在文件 sysfs-block-dm 中定义

Device-mapper 设备名称。 只读字符串，其中包含映射的设备名称。

用户：util-linux、device-mapper udev 规则

/sys/block/dm-<num>/dm/rq_based_seq_io_merge_deadline

在文件 sysfs-block-dm 中定义

允许控制作为合理合并候选对象的请求在请求队列中排队的时间。 此截止时间的精度为微秒（范围为 1 到 100000 微秒）。 将此属性设置为 0（默认值）将禁用基于请求的 DM 合并启发式算法和相关的额外记帐。 此属性不适用于基于 bio 的 DM 设备，因此它只会为它们报告 0。

/sys/block/dm-<num>/dm/suspended

在文件 sysfs-block-dm 中定义

Device-mapper 设备挂起状态。 当设备挂起时，包含值 1。 否则，它包含 0。只读属性。

用户：util-linux、device-mapper udev 规则

/sys/block/dm-<num>/dm/use_blk_mq

在文件 sysfs-block-dm 中定义

基于请求的 Device-mapper blk-mq I/O 路径模式。 如果设备使用 blk-mq，则包含值 1。 否则，它包含 0。只读属性。

/sys/block/dm-<num>/dm/uuid

在文件 sysfs-block-dm 中定义

Device-mapper 设备 UUID。 只读字符串，其中包含 DM-UUID，如果未设置 DM-UUID，则为空字符串。

用户：util-linux、device-mapper udev 规则

/sys/block/etherd*/firmware-version

在文件 sysfs-block-aoe 中定义

（只读）目标中固件的版本。

/sys/block/etherd*/mac

在文件 sysfs-block-aoe 中定义

（只读）远程以太网光纤通道（AoE）设备的以太网地址。

/sys/block/etherd*/netif

在文件 sysfs-block-aoe 中定义

（只读）本地主机上与远程 AoE 设备通信的网络接口的名称（以逗号分隔）。

/sys/block/etherd*/payload

在文件 sysfs-block-aoe 中定义

（只读）在网络上每个 AoE 命令内部传输的用户数据量（以字节为单位），不包括网络标头。

/sys/block/etherd*/state

在文件 sysfs-block-aoe 中定义

（只读）设备状态。 当设备准备好进行 I/O 时，状态属性为“up”，如果检测到但无法使用，则状态属性为“down”。 “down,closewait”状态表示该设备仍处于打开状态，并且在关闭之前无法再次启动。 “up,kickme”状态表示驱动程序想要向目标发送更多命令，但发现已经有最大数量的命令在等待响应。 它将在被定期计时器处理例程踢后重试。

/sys/block/loopX/loop/autoclear

在文件 sysfs-block-loop 中定义

（只读）显示设备是否处于自动清除模式（“1”或“0”）。 自动清除（如果设置）表示回环设备将在最后一次关闭后自行销毁。

/sys/block/loopX/loop/backing_file

在文件 sysfs-block-loop 中定义

（只读）回环设备将其数据块映射到的后备文件的路径。

/sys/block/loopX/loop/dio

在文件 sysfs-block-loop 中定义

（只读）显示是否正在使用直接 IO 访问后备文件（“1”或“0”）。

/sys/block/loopX/loop/offset

在文件 sysfs-block-loop 中定义

（只读）起始偏移量（以字节为单位）。

/sys/block/loopX/loop/partscan

在文件 sysfs-block-loop 中定义

（只读）显示是否为设备启用了自动分区扫描（“1”或“0”）。 可以在设置期间通过在 ioctl 请求中设置 LO_FLAGS_PARTSCAN 来单独请求每个回环设备。 默认情况下，不会扫描分区表。

/sys/block/loopX/loop/sizelimit

在文件 sysfs-block-loop 中定义

（只读）块设备从偏移量开始映射的大小（以字节为单位）。

/sys/block/rnbd<N>/rnbd/access_mode

在文件 sysfs-block-rnbd 中定义

包含设备访问模式：ro、rw 或迁移。

/sys/block/rnbd<N>/rnbd/mapping_path

在文件 sysfs-block-rnbd 中定义

包含作为“device_path”传递给 map_device 操作的路径。

/sys/block/rnbd<N>/rnbd/nr_poll_queues

在文件 sysfs-block-rnbd 中定义

包含轮询模式队列的数量

/sys/block/rnbd<N>/rnbd/remap_device

在文件 sysfs-block-rnbd 中定义

如果会话尚未销毁，则重新映射断开连接的设备。

/sys/block/rnbd<N>/rnbd/resize

在文件 sysfs-block-rnbd 中定义

写入扇区数以更改磁盘大小。

/sys/block/rnbd<N>/rnbd/session

在文件 sysfs-block-rnbd 中定义

RNBD 使用 RTRS 会话在客户端和服务器之间传输数据。 条目“session”包含用于建立 RTRS 会话的会话名称。 它与作为服务器参数传递给 map_device 条目的名称相同。

/sys/block/rnbd<N>/rnbd/state

在文件 sysfs-block-rnbd 中定义

该文件包含块设备的当前状态。 当设备从服务器成功映射并接受 I/O 请求时，状态文件返回“open”。 如果与服务器的连接因错误（例如，链路故障）而断开，则状态文件将返回“closed”，并且提交给它的所有 I/O 请求都将失败并返回 -EIO。

/sys/block/rnbd<N>/rnbd/unmap_device

在文件 sysfs-block-rnbd 中定义

要取消映射卷，必须将“normal”或“force”写入：/sys/block/rnbd<N>/rnbd/unmap_device

使用“normal”时，如果有任何进程正在使用该设备，则该操作将失败并返回 EBUSY。 使用“force”时，即使设备正在使用，也会取消映射该设备。 所有正在进行的 I/O 都将失败。

示例

# echo "normal" > /sys/block/rnbd0/rnbd/unmap_device

/sys/block/rssd*/status

在文件 sysfs-block-rssd 中定义

这是一个只读文件。 表示设备的状态。

/sys/block/zram<id>/algorithm_params

在文件 sysfs-block-zram 中定义

algorithm_params 文件是只写的，用于设置压缩算法参数。

/sys/block/zram<id>/backing_dev

在文件 sysfs-block-zram 中定义

backing_dev 文件是可读写的，并为 zram 设置后备设备以写入不可压缩的页面。 要使用，用户应启用 CONFIG_ZRAM_WRITEBACK。

/sys/block/zram<id>/bd_stat

在文件 sysfs-block-zram 中定义

bd_stat 文件是只读的，表示后备设备的统计信息（bd_count、bd_reads、bd_writes），格式类似于块层统计文件格式。

/sys/block/zram<id>/comp_algorithm

在文件 sysfs-block-zram 中定义

comp_algorithm 文件是可读写的，允许显示可用和选定的压缩算法，更改压缩算法选择。

/sys/block/zram<id>/compact

在文件 sysfs-block-zram 中定义

compact 文件是只写的，并触发分配器 zrm 使用的压缩。 分配器移动一些对象，以便释放碎片空间。

/sys/block/zram<id>/debug_stat

在文件 sysfs-block-zram 中定义

debug_stat 文件是只读的，表示对内核开发人员有用的各种设备的调试信息。 其格式故意未记录，可能会随时更改，恕不另行通知。

/sys/block/zram<id>/disksize

在文件 sysfs-block-zram 中定义

disksize 文件是可读写的，用于指定磁盘大小，表示该磁盘可存储的未压缩数据的上限。单位：字节

/sys/block/zram<id>/idle

在文件 sysfs-block-zram 中定义

idle 文件是只写的，用于将 zram 插槽标记为空闲。如果系统已挂载 debugfs，用户可以通过 /sys/kernel/debug/zram/zram<id>/block_state 查看哪些插槽是空闲的。

/sys/block/zram<id>/initstate

在文件 sysfs-block-zram 中定义

initstate 文件是只读的，用于显示设备的初始化状态。

/sys/block/zram<id>/io_stat

在文件 sysfs-block-zram 中定义

io_stat 文件是只读的，用于累积设备未被块层计入的 I/O 统计信息。例如，failed_reads、failed_writes 等。文件格式类似于块层统计信息文件格式。

/sys/block/zram<id>/max_comp_streams

在文件 sysfs-block-zram 中定义

max_comp_streams 文件是可读写的，用于指定后端 zcomp_strm 压缩流的数量（并发压缩操作的数量）。

/sys/block/zram<id>/mem_limit

在文件 sysfs-block-zram 中定义

mem_limit 文件是只写的，用于指定 ZRAM 可以用于存储压缩数据的最大内存量。该限制可以在运行时更改，“0”表示禁用该限制。初始状态为无限制。单位：字节

/sys/block/zram<id>/mem_used_max

在文件 sysfs-block-zram 中定义

mem_used_max 文件是只写的，用于重置 zram 存储压缩数据所消耗的最大内存计数器。要重置该值，应写入“0”。否则，将看到 -EINVAL。单位：字节

/sys/block/zram<id>/mm_stat

在文件 sysfs-block-zram 中定义

mm_stat 文件是只读的，用于以类似于块层统计信息文件格式的格式表示设备的 mm 统计信息（orig_data_size、compr_data_size 等）。

/sys/block/zram<id>/recomp_algorithm

在文件 sysfs-block-zram 中定义

recomp_algorithm 文件是可读写的，用于设置或显示辅助压缩算法。

/sys/block/zram<id>/recompress

在文件 sysfs-block-zram 中定义

recompress 文件是只写的，用于触发使用辅助压缩算法的重新压缩。

/sys/block/zram<id>/reset

在文件 sysfs-block-zram 中定义

reset 文件是只写的，用于重置设备。重置操作会释放与此设备关联的所有内存。

/sys/block/zram<id>/writeback

在文件 sysfs-block-zram 中定义

writeback 文件是只写的，用于触发空闲和/或巨页写回到后备设备。

/sys/block/zram<id>/writeback_limit

在文件 sysfs-block-zram 中定义

writeback_limit 文件是可读写的，用于指定 ZRAM 可以执行的最大写回量。该限制可以在运行时更改。

/sys/block/zram<id>/writeback_limit_enable

在文件 sysfs-block-zram 中定义

writeback_limit_enable 文件是可读写的，用于指定 writeback_limit 功能的启用。“1”表示启用该功能。初始状态为无限制 “0”。

/sys/bus 下的符号

/sys/bus/*/drivers/ufshcd/*/auto_hibern8

定义在文件 sysfs-driver-ufs 中

此文件包含 UFS 主机控制器的自动休眠空闲定时器设置。值为“0”表示未启用自动休眠。否则，该值是 UFS 主机控制器将自主将链路置于休眠状态之前的空闲时间（以微秒为单位）。这将节省功耗，但会增加延迟。请注意，硬件支持具有十的幂乘数的 10 位值，最大值可达 102300000。有关更多详细信息，请参阅 UFS 主机控制器接口规范。

/sys/bus/.../drivers/intel-m10-bmc/.../bmc_version

定义在文件 sysfs-driver-intel-m10-bmc 中

只读。返回 Intel MAX10 BMC 芯片的硬件构建版本。格式：“0x%x”。

/sys/bus/.../drivers/intel-m10-bmc/.../bmcfw_version

定义在文件 sysfs-driver-intel-m10-bmc 中

只读。返回 Intel MAX10 BMC 芯片的固件版本。格式：“0x%x”。

/sys/bus/.../drivers/intel-m10-bmc/.../mac_address

定义在文件 sysfs-driver-intel-m10-bmc 中

只读。返回分配给由 Intel MAX10 BMC 管理的板卡的连续 MAC 地址块中的第一个 MAC 地址。它存储在 FLASH 存储中，并镜像到 MAX10 BMC 寄存器空间中。格式：“%02x:%02x:%02x:%02x:%02x:%02x”。

/sys/bus/.../drivers/intel-m10-bmc/.../mac_count

定义在文件 sysfs-driver-intel-m10-bmc 中

只读。返回分配给由 Intel MAX10 BMC 管理的板卡的连续 MAC 地址的数量。此值存储在 FLASH 中，并镜像到 MAX10 BMC 寄存器空间中。格式：“%u”。

/sys/bus/acpi/devices/.../adr

定义在文件 sysfs-bus-acpi 中

此属性包含设备对象的 _ADR 控制方法的输出，该方法存在于具有标准枚举算法的 ACPI 设备对象中，例如 PCI。

/sys/bus/acpi/devices/.../description

定义在文件 sysfs-bus-acpi 中

此属性包含设备对象的 _STR 控制方法的输出（如果存在）。

/sys/bus/acpi/devices/.../eject

定义在文件 sysfs-bus-acpi 中

向此属性写入 1 将触发此设备对象的动态移除。此文件存在于每个具有 _EJ0 方法的设备对象中。

/sys/bus/acpi/devices/.../hid

定义在文件 sysfs-bus-acpi 中

此属性指示设备对象的硬件 ID (_HID)。例如，PNP0103。此文件存在于具有 _HID 控制方法的设备对象中。

/sys/bus/acpi/devices/.../hrv

定义在文件 sysfs-bus-acpi 中

(只读) 如果存在 _HRV 控制方法，则允许用户读取非 PCI 硬件的硬件版本。它主要用于非 PCI 设备，因为 lspci 可以列出 PCI 设备的硬件版本。

/sys/bus/acpi/devices/.../modalias

定义在文件 sysfs-bus-acpi 中

此属性指示设备对象的 PNP ID。即 acpi:HHHHHHHH:[CCCCCCC:]。其中每个 HHHHHHHH 或 CCCCCCCC 都包含设备对象的 PNPID（_HID 或 _CID）。

/sys/bus/acpi/devices/.../path

定义在文件 sysfs-bus-acpi 中

此属性指示与设备对象关联的 ACPI 命名空间对象的完整路径。例如，_SB_.PCI0。

对于表示固定 ACPI 硬件功能（如电源和睡眠按钮）的设备对象，此文件不存在。

/sys/bus/acpi/devices/.../status

定义在文件 sysfs-bus-acpi 中

(只读) 如果存在方法 _STA，则返回 ACPI 设备状态：已启用、已禁用或正在运行或存在。

返回值是一个十进制整数，表示设备的状态位图

位 [0]

如果设备存在，则设置此位。

位 [1]

如果设备已启用并正在解码其资源，则设置此位。

位 [2]

如果设备应在 UI 中显示，则设置此位。

位 [3]

如果设备运行正常（如果设备未通过诊断，则清除此位），则设置此位。

位 [4]

如果存在电池，则设置此位。

位 [31:5]

保留（必须清除）

如果位 [0] 被清除，则位 1 也必须被清除（不存在的设备无法启用）。

位 0 可以被清除（不存在），且位 [3] 被设置（设备功能正常）。这种情况用于指示一个有效的设备，不应为其加载任何设备驱动程序。

ACPI 规范中涵盖了更多特殊情况。

/sys/bus/acpi/devices/.../uid

定义在文件 sysfs-bus-acpi 中

此属性包含设备对象的 _UID 控制方法的输出（如果存在）。

/sys/bus/acpi/intel-rapid-start/wakeup_events

定义在文件 sysfs-driver-intel-rapid-start 中

一个整数，表示一组唤醒事件，如下所示：1：唤醒以在唤醒定时器到期时进入休眠状态 2：唤醒以在电池电量达到临界水平时进入休眠状态

这些值进行 OR 运算。例如，值 3 表示系统将在唤醒定时器到期或电池电量达到临界水平时唤醒以进入休眠状态。

/sys/bus/acpi/intel-rapid-start/wakeup_time

定义在文件 sysfs-driver-intel-rapid-start 中

一个整数，表示系统在唤醒进入休眠状态之前保持休眠状态的时间长度。此值的单位为分钟。

/sys/bus/amba/devices/.../driver_override

定义在文件 sysfs-bus-amba 中

此文件允许指定设备的驱动程序，该驱动程序将覆盖标准的 OF、ACPI、ID 表和名称匹配。指定后，只有名称与写入 driver_override 的值匹配的驱动程序才有机会绑定到该设备。覆盖是通过将字符串写入 driver_override 文件（echo vfio-amba > driver_override）指定的，可以使用空字符串清除（echo > driver_override）。这会将设备返回到标准的匹配规则绑定。写入 driver_override 不会自动将设备从其当前驱动程序中解除绑定，也不会尝试自动加载指定的驱动程序。如果内核中当前没有加载具有匹配名称的驱动程序，则该设备不会绑定到任何驱动程序。这也允许设备使用 driver_override 名称（例如“none”）选择退出驱动程序绑定。覆盖中只能指定一个驱动程序，不支持解析分隔符。

/sys/bus/auxiliary/devices/.../irqs/

定义在文件 sysfs-bus-auxiliary 中

/sys/devices/.../irqs 目录包含一组可变的文件，每个文件的名称都与 PCI PF 或 VF 的 irq 编号类似，位于 msi_irqs 目录中。当为 PCI SF 请求和释放 IRQ 时，会分别动态添加和删除这些 irq 文件。

/sys/bus/auxiliary/devices/intel_vsec.sdsi.X

定义在文件 sysfs-driver-intel_sdsi 中

此目录包含用于访问 CPU 上的 Intel On Demand（以前称为软件定义硅或 SDSi）功能的接口文件。X 表示套接字实例（但不是套接字 ID）。套接字 ID 通过读取 registers 文件并按照规范对其进行解码来确定。

一些文件通过邮箱与 On Demand 硬件进行通信。如果操作失败，可能会返回以下错误代码之一

错误代码

原因

EIO

通用邮箱故障。日志可能会指示原因。

EBUSY

邮箱被另一个代理占用。

EPERM

硬件中未启用 On Demand 功能。

EPROTO

驱动程序检测到邮箱协议中的故障。有关详细信息，请参见日志。

EOVERFLOW

对于配置命令，数据大小超过了可写入的大小。

ESPIPE

不允许查找。

ETIMEDOUT

未及时完成邮箱事务。

/sys/bus/auxiliary/devices/intel_vsec.sdsi.X/guid

定义在文件 sysfs-driver-intel_sdsi 中

(只读) registers 文件的 GUID。GUID 标识此目录中 registers 文件的布局。有关特定 GUID 的寄存器布局的信息，请访问 http://github.com/intel/intel-sdsi

/sys/bus/auxiliary/devices/intel_vsec.sdsi.X/meter_certificate

定义在文件 sysfs-driver-intel_sdsi 中

（只读）用于从 Intel On Demand 硬件读取 CPU 的当前计量证书。计量证书包含已启用 On Demand 功能的利用率指标。邮箱命令。

/sys/bus/auxiliary/devices/intel_vsec.sdsi.X/provision_akc

定义在文件 sysfs-driver-intel_sdsi 中

（只写）用于将身份验证密钥证书 (AKC) 写入 CPU 的 On Demand NVRAM。AKC 用于验证功能激活有效负载。邮箱命令。

/sys/bus/auxiliary/devices/intel_vsec.sdsi.X/provision_cap

定义在文件 sysfs-driver-intel_sdsi 中

（只写）用于将功能激活有效负载 (CAP) 写入 CPU 的 On Demand NVRAM。CAP 用于激活给定的 CPU 功能。CAP 由 On Demand 硬件使用先前配置的 AKC 文件进行验证。成功验证后，CPU 配置会更新。需要冷重启才能完全激活该功能。邮箱命令。

/sys/bus/auxiliary/devices/intel_vsec.sdsi.X/registers

定义在文件 sysfs-driver-intel_sdsi 中

（只读）包含应用程序配置 CPU 和监控状态信息所需的信息。此文件的布局由该目录中的 GUID 确定。有关特定 GUID 布局的信息，请访问 http://github.com/intel/intel-sdsi

/sys/bus/auxiliary/devices/intel_vsec.sdsi.X/state_certificate

定义在文件 sysfs-driver-intel_sdsi 中

（只读）用于从 On Demand 硬件读取 CPU 的当前状态证书。状态证书包含有关 CPU 上当前许可证的信息。邮箱命令。

/sys/bus/bcma/devices/.../class

在文件 sysfs-bus-bcma 中定义

每个 BCMA 内核都由几个字段标识，包括它所属的类。有关可能的值，请参阅 include/linux/bcma/bcma.h。

/sys/bus/bcma/devices/.../id

在文件 sysfs-bus-bcma 中定义

BCMA 内核有几种类型，可以通过 id 字段来标识。

/sys/bus/bcma/devices/.../manuf

在文件 sysfs-bus-bcma 中定义

每个 BCMA 内核都有其制造商 ID。有关可能的值，请参阅 include/linux/bcma/bcma.h。

/sys/bus/bcma/devices/.../rev

在文件 sysfs-bus-bcma 中定义

同一类型的 BCMA 内核可能因其版本而略有不同。使用它进行详细编程。

/sys/bus/cdx/devices/.../class

在文件 sysfs-bus-cdx 中定义

此文件包含 CDX 设备的类，以十六进制表示。类是 24 位标识符，指定设备的功能。

/sys/bus/cdx/devices/.../device

在文件 sysfs-bus-cdx 中定义

此 CDX 设备的设备 ID，以十六进制表示。设备 ID 是 16 位标识符，用于标识设备制造商范围内的设备类型。供应商 ID 和设备 ID 的组合标识一个设备。

/sys/bus/cdx/devices/.../enable

在文件 sysfs-bus-cdx 中定义

在更新 FPGA 中的设备之前，应禁用 CDX 总线。写入 n/0/off 将尝试禁用 CDX 总线。写入 y/1/on 将尝试启用 CDX 总线。读取此文件将给出总线的当前状态，1 表示已启用，0 表示已禁用。

例如

# echo 1 > /sys/bus/cdx/.../enable

/sys/bus/cdx/devices/.../modalias

在文件 sysfs-bus-cdx 中定义

此属性指示设备的 CDX ID。格式为：cdx:vXXXXdXXXXsvXXXXsdXXXXcXXXXXX，其中

  • vXXXX 包含供应商 ID；

  • dXXXX 包含设备 ID；

  • svXXXX 包含子系统供应商 ID；

  • sdXXXX 包含子系统设备 ID；

  • cXXXXXX 包含设备类。

/sys/bus/cdx/devices/.../remove

在文件 sysfs-bus-cdx 中定义

向此文件写入 y/1/on 将从 CDX 总线删除相应的设备。如果要重新配置硬件中的设备，则可以删除该设备，以便设备驱动程序在重新配置时不会访问该设备。

例如

# echo 1 > /sys/bus/cdx/devices/.../remove

/sys/bus/cdx/devices/.../reset

在文件 sysfs-bus-cdx 中定义

向此文件写入 y/1/on 将重置 CDX 设备或总线上的所有设备。重置设备时，会通知相应的驱动程序两次，一次在设备重置之前，另一次在重置完成后。

例如

# echo 1 > /sys/bus/cdx/.../reset

/sys/bus/cdx/devices/.../resource<N>

在文件 sysfs-bus-cdx 中定义

资源二进制文件包含内存区域的内容。这些文件可以从用户空间进行 mmap。

/sys/bus/cdx/devices/.../revision

在文件 sysfs-bus-cdx 中定义

此文件包含 CDX 设备的版本字段，以十六进制表示。版本是设备的 8 位版本标识符。

/sys/bus/cdx/devices/.../subsystem_device

在文件 sysfs-bus-cdx 中定义

此 CDX 设备的子系统设备 ID，以十六进制表示。子系统设备 ID 是特定于卡制造商的 16 位标识符。

/sys/bus/cdx/devices/.../subsystem_vendor

在文件 sysfs-bus-cdx 中定义

此 CDX 设备的子系统供应商 ID，以十六进制表示。子系统供应商 ID 是特定于卡制造商的 16 位标识符。

/sys/bus/cdx/devices/.../vendor

在文件 sysfs-bus-cdx 中定义

此 CDX 设备的供应商 ID，以十六进制表示。供应商 ID 是特定于设备制造商的 16 位标识符。供应商 ID 和设备 ID 的组合标识一个设备。

/sys/bus/cdx/rescan

在文件 sysfs-bus-cdx 中定义

向此文件写入 y/1/on 将导致重新扫描 CDX 总线和设备。将扫描任何新设备并将其添加到 Linux 设备列表中，并且还将从 Linux 中删除任何已删除的设备。

例如

# echo 1 > /sys/bus/cdx/rescan

/sys/bus/coreboot

在文件 sysfs-bus-coreboot 中定义

coreboot 总线提供了各种虚拟设备，用于访问由 Coreboot BIOS 创建的数据结构。

/sys/bus/coreboot/devices/cbmem-<id>

在文件 sysfs-bus-coreboot 中定义

CBMEM 是 Coreboot 创建的向下增长的内存区域，包含标记的数据结构，以便在启动过程和操作系统中与有效负载共享。根据其 ID，每个 CBMEM 条目在 /sys/bus/coreboot/devices 中都有一个目录。Coreboot 已知的 ID 列表可以在 coreboot 源代码树中的 src/commonlib/bsd/include/commonlib/bsd/cbmem_id.h 中找到。

/sys/bus/coreboot/devices/cbmem-<id>/address

在文件 sysfs-bus-coreboot 中定义

这是 CBMEM 条目的数据开始处的物理内存地址，以十六进制表示（例如，0x76ffe000）。

/sys/bus/coreboot/devices/cbmem-<id>/mem

在文件 sysfs-bus-coreboot 中定义

一个文件，用于公开对条目数据的读/写访问。请注意，此文件不支持 mmap()，因为 coreboot 不保证数据会页对齐。

此文件的模式为 0600。虽然 CBMEM 中不应包含任何安全敏感的内容，但考虑到这会公开一小部分物理内存，因此读取访问需要 root 权限。

/sys/bus/coreboot/devices/cbmem-<id>/size

在文件 sysfs-bus-coreboot 中定义

这是 CBMEM 条目的数据大小，以十六进制表示（例如，0x1234）。

/sys/bus/coresight/devices/<cti-name>/channels/chan_clear

在文件 sysfs-bus-coresight-devices-cti 中定义

（写入）停用单个通道。

/sys/bus/coresight/devices/<cti-name>/channels/chan_free

在文件 sysfs-bus-coresight-devices-cti 中定义

（读取）显示没有附加触发信号的通道。

/sys/bus/coresight/devices/<cti-name>/channels/chan_gate_disable

在文件 sysfs-bus-coresight-devices-cti 中定义

（写入）禁用单个通道的 CTIGATE。

/sys/bus/coresight/devices/<cti-name>/channels/chan_gate_enable

在文件 sysfs-bus-coresight-devices-cti 中定义

（读/写）启用单个通道的 CTIGATE（写入）或通过门列出已启用的通道（读取）。

/sys/bus/coresight/devices/<cti-name>/channels/chan_inuse

在文件 sysfs-bus-coresight-devices-cti 中定义

（读取）显示至少有一个附加触发信号的通道。

/sys/bus/coresight/devices/<cti-name>/channels/chan_pulse

在文件 sysfs-bus-coresight-devices-cti 中定义

（写入）脉冲单个通道 - 在一个时钟周期内激活。

/sys/bus/coresight/devices/<cti-name>/channels/chan_set

在文件 sysfs-bus-coresight-devices-cti 中定义

（写入）激活单个通道。

/sys/bus/coresight/devices/<cti-name>/channels/chan_xtrigs_in

在文件 sysfs-bus-coresight-devices-cti 中定义

（读取）读取以查看连接到所选视图通道的输入触发器。

/sys/bus/coresight/devices/<cti-name>/channels/chan_xtrigs_out

在文件 sysfs-bus-coresight-devices-cti 中定义

（读取）读取以查看连接到所选视图通道的输出触发器。

/sys/bus/coresight/devices/<cti-name>/channels/chan_xtrigs_reset

在文件 sysfs-bus-coresight-devices-cti 中定义

（写入）清除所有通道/触发编程。

/sys/bus/coresight/devices/<cti-name>/channels/chan_xtrigs_sel

在文件 sysfs-bus-coresight-devices-cti 中定义

（读/写）写入通道号以选择要查看的通道，读取以查看所选通道号。

/sys/bus/coresight/devices/<cti-name>/channels/trig_filter_enable

在文件 sysfs-bus-coresight-devices-cti 中定义

（读/写）启用或禁用触发输出信号过滤。

/sys/bus/coresight/devices/<cti-name>/channels/trigin_attach

在文件 sysfs-bus-coresight-devices-cti 中定义

（写入）将 CTI 输入触发器附加到 CTM 通道。

/sys/bus/coresight/devices/<cti-name>/channels/trigin_detach

在文件 sysfs-bus-coresight-devices-cti 中定义

（写入）从 CTM 通道分离 CTI 输入触发器。

/sys/bus/coresight/devices/<cti-name>/channels/trigout_attach

在文件 sysfs-bus-coresight-devices-cti 中定义

（写入）将 CTI 输出触发器附加到 CTM 通道。

/sys/bus/coresight/devices/<cti-name>/channels/trigout_detach

在文件 sysfs-bus-coresight-devices-cti 中定义

（写入）从 CTM 通道分离 CTI 输出触发器。

/sys/bus/coresight/devices/<cti-name>/channels/trigout_filtered

在文件 sysfs-bus-coresight-devices-cti 中定义

（读取）跨所有连接过滤的输出触发器列表。

/sys/bus/coresight/devices/<cti-name>/ctmid

在文件 sysfs-bus-coresight-devices-cti 中定义

（读取）显示关联的 CTM ID

/sys/bus/coresight/devices/<cti-name>/enable

在文件 sysfs-bus-coresight-devices-cti 中定义

（读/写）启用/禁用 CTI 硬件。

/sys/bus/coresight/devices/<cti-name>/nr_trigger_cons

在文件 sysfs-bus-coresight-devices-cti 中定义

（读取）连接到此 CTI 上触发器的设备数量

/sys/bus/coresight/devices/<cti-name>/powered

在文件 sysfs-bus-coresight-devices-cti 中定义

（读取）指示 CTI 硬件是否已供电。

/sys/bus/coresight/devices/<cti-name>/regs/appclear

在文件 sysfs-bus-coresight-devices-cti 中定义

（写入）写入 APPCLEAR 寄存器以停用通道。

/sys/bus/coresight/devices/<cti-name>/regs/apppulse

在文件 sysfs-bus-coresight-devices-cti 中定义

（写入）写入 APPPULSE 以在一个时钟周期内脉冲激活通道。

/sys/bus/coresight/devices/<cti-name>/regs/appset

在文件 sysfs-bus-coresight-devices-cti 中定义

（读/写）设置 CTIAPPSET 寄存器以激活通道。回读以确定寄存器的当前值。

/sys/bus/coresight/devices/<cti-name>/regs/asicctl

在文件 sysfs-bus-coresight-devices-cti 中定义

（读/写）读取或写入 ASICCTL 寄存器。

/sys/bus/coresight/devices/<cti-name>/regs/chinstatus

在文件 sysfs-bus-coresight-devices-cti 中定义

（读取）读取通道输入的当前状态。

/sys/bus/coresight/devices/<cti-name>/regs/choutstatus

在文件 sysfs-bus-coresight-devices-cti 中定义

（读取）读取通道输出的当前状态。

/sys/bus/coresight/devices/<cti-name>/regs/gate

在文件 sysfs-bus-coresight-devices-cti 中定义

（读/写）读取或写入 CTIGATE 寄存器。

/sys/bus/coresight/devices/<cti-name>/regs/inen

在文件 sysfs-bus-coresight-devices-cti 中定义

（读/写）读取或写入由 inout_sel 选择的 CTIINEN 寄存器。

/sys/bus/coresight/devices/<cti-name>/regs/inout_sel

在文件 sysfs-bus-coresight-devices-cti 中定义

（读/写）选择 inen 和 outen 寄存器的索引。

/sys/bus/coresight/devices/<cti-name>/regs/intack

在文件 sysfs-bus-coresight-devices-cti 中定义

（写入）写入 INTACK 寄存器。

/sys/bus/coresight/devices/<cti-name>/regs/outen

在文件 sysfs-bus-coresight-devices-cti 中定义

（读/写）读取或写入由 inout_sel 选择的 CTIOUTEN 寄存器。

/sys/bus/coresight/devices/<cti-name>/regs/triginstatus

在文件 sysfs-bus-coresight-devices-cti 中定义

（读取）读取输入触发信号的当前状态

/sys/bus/coresight/devices/<cti-name>/regs/trigoutstatus

在文件 sysfs-bus-coresight-devices-cti 中定义

（读取）读取输出触发信号的当前状态。

/sys/bus/coresight/devices/<cti-name>/triggers<N>/in_signals

在文件 sysfs-bus-coresight-devices-cti 中定义

（读取）来自连接设备 <N> 的输入触发信号

/sys/bus/coresight/devices/<cti-name>/triggers<N>/in_types

在文件 sysfs-bus-coresight-devices-cti 中定义

（读取）来自连接设备 <N> 的输入触发信号的功能类型

/sys/bus/coresight/devices/<cti-name>/triggers<N>/name

在文件 sysfs-bus-coresight-devices-cti 中定义

（读取）连接的设备 <N> 的名称

/sys/bus/coresight/devices/<cti-name>/triggers<N>/out_signals

在文件 sysfs-bus-coresight-devices-cti 中定义

（读取）到连接设备 <N> 的输出触发信号

/sys/bus/coresight/devices/<cti-name>/triggers<N>/out_types

在文件 sysfs-bus-coresight-devices-cti 中定义

（读取）到连接设备 <N> 的输出触发信号的功能类型

/sys/bus/coresight/devices/<memory_map>.[etm|ptm]/addr_acctype

在文件 sysfs-bus-coresight-devices-etm3x 中定义

（读/写）与 @addr_idx 结合使用。指定有关正在配置的地址比较器的特性，例如访问类型、要跟踪的指令类型、要触发的处理器上下文 ID 等。访问类型寄存器中的各个字段可能因跟踪实体的版本而异。

/sys/bus/coresight/devices/<memory_map>.[etm|ptm]/addr_idx

在文件 sysfs-bus-coresight-devices-etm3x 中定义

选择要使用的地址比较器或一对比较器。

/sys/bus/coresight/devices/<memory_map>.[etm|ptm]/addr_range

在文件 sysfs-bus-coresight-devices-etm3x 中定义

（读/写）与 @addr_idx 结合使用。指定要触发的地址范围。包含或排除在相应的访问类型寄存器中指定。

/sys/bus/coresight/devices/<memory_map>.[etm|ptm]/addr_single

在文件 sysfs-bus-coresight-devices-etm3x 中定义

（读/写）与 @addr_idx 结合使用。指定要触发的单个地址，这很大程度上受到相应访问类型寄存器的配置选项的影响。

/sys/bus/coresight/devices/<memory_map>.[etm|ptm]/addr_start

在文件 sysfs-bus-coresight-devices-etm3x 中定义

（读/写）与 @addr_idx 结合使用。指定开始跟踪的单个地址，这很大程度上受到相应访问类型寄存器的配置选项的影响。

/sys/bus/coresight/devices/<memory_map>.[etm|ptm]/addr_stop

在文件 sysfs-bus-coresight-devices-etm3x 中定义

（读/写）与 @addr_idx 结合使用。指定停止跟踪的单个地址，这很大程度上受到相应访问类型寄存器的配置选项的影响。

/sys/bus/coresight/devices/<memory_map>.[etm|ptm]/cntr_event

在文件 sysfs-bus-coresight-devices-etm3x 中定义

(读写) 与 cntr_idx 结合使用，可以访问计数器事件寄存器。

/sys/bus/coresight/devices/<memory_map>.[etm|ptm]/cntr_idx

在文件 sysfs-bus-coresight-devices-etm3x 中定义

(读写) 指定要操作的计数器。

/sys/bus/coresight/devices/<memory_map>.[etm|ptm]/cntr_rld_event

在文件 sysfs-bus-coresight-devices-etm3x 中定义

(读写) 与 cntr_idx 结合使用，可以访问计数器重载事件寄存器。

/sys/bus/coresight/devices/<memory_map>.[etm|ptm]/cntr_rld_val

在文件 sysfs-bus-coresight-devices-etm3x 中定义

(读写) 与 cntr_idx 结合使用，可以访问计数器重载值寄存器。

/sys/bus/coresight/devices/<memory_map>.[etm|ptm]/cntr_val

在文件 sysfs-bus-coresight-devices-etm3x 中定义

(读写) 与 cntr_idx 结合使用，可以访问计数器值寄存器。

/sys/bus/coresight/devices/<memory_map>.[etm|ptm]/cpu

在文件 sysfs-bus-coresight-devices-etm3x 中定义

(只读) 保存此跟踪器绑定的 CPU 编号。

/sys/bus/coresight/devices/<memory_map>.[etm|ptm]/ctxid_idx

在文件 sysfs-bus-coresight-devices-etm3x 中定义

(读写) 指定要选择的上下文 ID 寄存器的索引。

/sys/bus/coresight/devices/<memory_map>.[etm|ptm]/ctxid_mask

在文件 sysfs-bus-coresight-devices-etm3x 中定义

(读写) 应用于所有上下文 ID 比较器的掩码。

/sys/bus/coresight/devices/<memory_map>.[etm|ptm]/ctxid_pid

在文件 sysfs-bus-coresight-devices-etm3x 中定义

(读写) 与 ctxid_idx 结合使用，指定要触发的上下文 ID。

/sys/bus/coresight/devices/<memory_map>.[etm|ptm]/curr_seq_state

在文件 sysfs-bus-coresight-devices-etm3x 中定义

(只读) 保存序列器的当前状态。

/sys/bus/coresight/devices/<memory_map>.[etm|ptm]/enable_event

在文件 sysfs-bus-coresight-devices-etm3x 中定义

(读写) 定义哪个事件触发跟踪。

/sys/bus/coresight/devices/<memory_map>.[etm|ptm]/enable_source

在文件 sysfs-bus-coresight-devices-etm3x 中定义

(读写) 启用/禁用此特定跟踪实体的跟踪。启用源意味着该源已正确配置，并且已为其标识了一个接收器。连接源到接收器的 CoreSight 组件的路径由 CoreSight 框架自动配置和管理。

/sys/bus/coresight/devices/<memory_map>.[etm|ptm]/etmsr

在文件 sysfs-bus-coresight-devices-etm3x 中定义

(读写) 提供对 ETM 状态寄存器的访问，该寄存器保存有关某些事件的编程信息和状态。

/sys/bus/coresight/devices/<memory_map>.[etm|ptm]/fifofull_level

在文件 sysfs-bus-coresight-devices-etm3x 中定义

(读写) FIFO 中剩余的字节数，在被认为满之前。根据跟踪器的版本，还可以保存数据抑制的阈值。

/sys/bus/coresight/devices/<memory_map>.[etm|ptm]/mgmt/etmccer

在文件 sysfs-bus-coresight-devices-etm3x 中定义

(只读) 打印 ETM 配置代码扩展寄存器 (0x1e8) 的内容。该值直接从硬件读取。

/sys/bus/coresight/devices/<memory_map>.[etm|ptm]/mgmt/etmccr

在文件 sysfs-bus-coresight-devices-etm3x 中定义

(只读) 打印 ETM 配置代码寄存器 (0x004) 的内容。该值直接从硬件读取。

/sys/bus/coresight/devices/<memory_map>.[etm|ptm]/mgmt/etmcr

在文件 sysfs-bus-coresight-devices-etm3x 中定义

(只读) 打印 ETM 主控制寄存器 (0x000) 的内容。该值直接从硬件读取。

/sys/bus/coresight/devices/<memory_map>.[etm|ptm]/mgmt/etmidr

在文件 sysfs-bus-coresight-devices-etm3x 中定义

(只读) 打印 ETM ID 寄存器 (0x1e4) 的内容。该值直接从硬件读取。

/sys/bus/coresight/devices/<memory_map>.[etm|ptm]/mgmt/etmscr

在文件 sysfs-bus-coresight-devices-etm3x 中定义

(只读) 打印 ETM 系统配置寄存器 (0x014) 的内容。该值直接从硬件读取。

/sys/bus/coresight/devices/<memory_map>.[etm|ptm]/mgmt/etmtecr1

在文件 sysfs-bus-coresight-devices-etm3x 中定义

(只读) 打印 ETM 启用控制 #1 寄存器 (0x024) 的内容。该值直接从硬件读取。

/sys/bus/coresight/devices/<memory_map>.[etm|ptm]/mgmt/etmtecr2

在文件 sysfs-bus-coresight-devices-etm3x 中定义

(只读) 打印 ETM 启用控制 #2 寄存器 (0x01c) 的内容。该值直接从硬件读取。

/sys/bus/coresight/devices/<memory_map>.[etm|ptm]/mgmt/etmteevr

在文件 sysfs-bus-coresight-devices-etm3x 中定义

(只读) 打印 ETM 跟踪启用事件寄存器 (0x020) 的内容。该值直接从硬件读取。

/sys/bus/coresight/devices/<memory_map>.[etm|ptm]/mgmt/etmtraceidr

在文件 sysfs-bus-coresight-devices-etm3x 中定义

(只读) 打印 ETM 跟踪 ID 寄存器 (0x200) 的内容。该值直接从硬件读取。

/sys/bus/coresight/devices/<memory_map>.[etm|ptm]/mgmt/etmtsscr

在文件 sysfs-bus-coresight-devices-etm3x 中定义

(只读) 打印 ETM 跟踪启动/停止控制寄存器 (0x018) 的内容。该值直接从硬件读取。

/sys/bus/coresight/devices/<memory_map>.[etm|ptm]/mode

在文件 sysfs-bus-coresight-devices-etm3x 中定义

(读写) 与驱动程序的 'mode' 字段交互，控制跟踪实体的各个方面，例如时间戳、上下文 ID 大小和周期精确跟踪。驱动程序特定且可能因驱动程序而异。

/sys/bus/coresight/devices/<memory_map>.[etm|ptm]/nr_addr_cmp

在文件 sysfs-bus-coresight-devices-etm3x 中定义

(只读) 提供跟踪单元上可访问的地址比较器对的数量，由寄存器 ETMCCR 的位 3:0 指定。

/sys/bus/coresight/devices/<memory_map>.[etm|ptm]/nr_cntr

在文件 sysfs-bus-coresight-devices-etm3x 中定义

(只读) 提供跟踪单元上可访问的计数器的数量，由寄存器 ETMCCR 的位 15:13 指定。

/sys/bus/coresight/devices/<memory_map>.[etm|ptm]/nr_ctxid_cmp

在文件 sysfs-bus-coresight-devices-etm3x 中定义

(只读) 提供跟踪单元上可用的上下文 ID 比较器的数量，由寄存器 ETMCCR 的位 25:24 指定。

/sys/bus/coresight/devices/<memory_map>.[etm|ptm]/reset

在文件 sysfs-bus-coresight-devices-etm3x 中定义

(写入) 取消跟踪单元上的所有配置，并将其设置回其启动配置。

/sys/bus/coresight/devices/<memory_map>.[etm|ptm]/seq_12_event

在文件 sysfs-bus-coresight-devices-etm3x 中定义

(读写) 定义导致序列器从状态 1 转换到状态 2 的事件。

/sys/bus/coresight/devices/<memory_map>.[etm|ptm]/seq_13_event

在文件 sysfs-bus-coresight-devices-etm3x 中定义

(读写) 定义导致序列器从状态 1 转换到状态 3 的事件。

/sys/bus/coresight/devices/<memory_map>.[etm|ptm]/seq_21_event

在文件 sysfs-bus-coresight-devices-etm3x 中定义

(读写) 定义导致序列器从状态 2 转换到状态 1 的事件。

/sys/bus/coresight/devices/<memory_map>.[etm|ptm]/seq_23_event

在文件 sysfs-bus-coresight-devices-etm3x 中定义

(读写) 定义导致序列器从状态 2 转换到状态 3 的事件。

/sys/bus/coresight/devices/<memory_map>.[etm|ptm]/seq_31_event

在文件 sysfs-bus-coresight-devices-etm3x 中定义

(读写) 定义导致序列器从状态 3 转换到状态 1 的事件。

/sys/bus/coresight/devices/<memory_map>.[etm|ptm]/seq_32_event

在文件 sysfs-bus-coresight-devices-etm3x 中定义

(读写) 定义导致序列器从状态 3 转换到状态 2 的事件。

/sys/bus/coresight/devices/<memory_map>.[etm|ptm]/sync_freq

在文件 sysfs-bus-coresight-devices-etm3x 中定义

(读写) 保存跟踪同步频率值 - 必须考虑到各种实现行为进行编程。

/sys/bus/coresight/devices/<memory_map>.[etm|ptm]/timestamp_event

在文件 sysfs-bus-coresight-devices-etm3x 中定义

(读写) 定义一个请求将时间戳插入跟踪流中的事件。

/sys/bus/coresight/devices/<memory_map>.[etm|ptm]/traceid

在文件 sysfs-bus-coresight-devices-etm3x 中定义

(只读) 保存将出现在来自此跟踪实体的跟踪流中的跟踪 ID。

/sys/bus/coresight/devices/<memory_map>.[etm|ptm]/trigger_event

在文件 sysfs-bus-coresight-devices-etm3x 中定义

(读写) 定义控制触发的事件。

/sys/bus/coresight/devices/<memory_map>.etb/enable_sink

在文件 sysfs-bus-coresight-devices-etb10 中定义

(读写) 从跟踪路径添加/删除接收器。一个接收器可以有多个源。

示例

echo 1 > /sys/bus/coresight/devices/20010000.etb/enable_sink

/sys/bus/coresight/devices/<memory_map>.etb/mgmt/ctl

在文件 sysfs-bus-coresight-devices-etb10 中定义

(只读) 显示 ETB 控制寄存器保存的值。该值直接从硬件寄存器 CTL (0x020) 读取。

/sys/bus/coresight/devices/<memory_map>.etb/mgmt/ffcr

在文件 sysfs-bus-coresight-devices-etb10 中定义

(只读) 显示 ETB 格式化程序和刷新控制寄存器保存的值。该值直接从硬件寄存器 FFCR (0x304) 读取。

/sys/bus/coresight/devices/<memory_map>.etb/mgmt/ffsr

在文件 sysfs-bus-coresight-devices-etb10 中定义

(只读) 显示 ETB 格式化程序和刷新状态寄存器保存的值。该值直接从硬件寄存器 FFSR (0x300) 读取。

/sys/bus/coresight/devices/<memory_map>.etb/mgmt/rdp

在文件 sysfs-bus-coresight-devices-etb10 中定义

(只读) 定义跟踪 RAM 的深度，以字为单位，以 2 的幂表示。该值直接从硬件寄存器 RDP (0x004) 读取。

/sys/bus/coresight/devices/<memory_map>.etb/mgmt/rrp

在文件 sysfs-bus-coresight-devices-etb10 中定义

(只读) 显示 ETB RAM 读取指针寄存器保存的值，该寄存器用于通过 APB 接口从跟踪 RAM 读取条目。该值直接从硬件寄存器 RRP (0x014) 读取。

/sys/bus/coresight/devices/<memory_map>.etb/mgmt/rwp

在文件 sysfs-bus-coresight-devices-etb10 中定义

(只读) 显示 ETB RAM 写入指针寄存器保存的值，该寄存器用于设置写入指针以将条目从 CoreSight 总线写入到跟踪 RAM 中。该值直接从硬件寄存器 RWP (0x018) 读取。

/sys/bus/coresight/devices/<memory_map>.etb/mgmt/sts

在文件 sysfs-bus-coresight-devices-etb10 中定义

(只读) 显示 ETB 状态寄存器保存的值。该值直接从硬件寄存器 STS (0x00C) 读取。

/sys/bus/coresight/devices/<memory_map>.etb/mgmt/trg

在文件 sysfs-bus-coresight-devices-etb10 中定义

(只读) 与上面的“trigger_cntr”类似，不同之处在于此值直接从硬件寄存器 TRG (0x01C) 读取。

/sys/bus/coresight/devices/<memory_map>.etb/trigger_cntr

在文件 sysfs-bus-coresight-devices-etb10 中定义

(读写) 通过在触发事件后存储了定义数量的字后停止格式化程序来禁用对跟踪 RAM 的写入访问。在触发事件之后写入跟踪 RAM 的 32 位字的数目等于存储在此寄存器中的值 + 1 (来自 ARM ETB-TRM)。

/sys/bus/coresight/devices/<memory_map>.funnel/funnel_ctrl

在文件 sysfs-bus-coresight-devices-funnel 中定义

(读写) 启用从端口并定义从端口的保持时间。

/sys/bus/coresight/devices/<memory_map>.funnel/priority

在文件 sysfs-bus-coresight-devices-funnel 中定义

(读写) 定义输入端口优先级顺序。

/sys/bus/coresight/devices/<memory_map>.stm/enable_source

在文件 sysfs-bus-coresight-devices-stm 中定义

(读写) 启用/禁用此特定跟踪宏单元的跟踪。启用跟踪宏单元意味着它已正确配置，并且已为其标识了一个接收器。连接源到接收器的 CoreSight 组件的路径由 CoreSight 框架自动配置和管理。

/sys/bus/coresight/devices/<memory_map>.stm/hwevent_enable

在文件 sysfs-bus-coresight-devices-stm 中定义

(读写) 提供对 HW 事件启用寄存器的访问，与 HW 事件组选择寄存器结合使用。

/sys/bus/coresight/devices/<memory_map>.stm/hwevent_select

在文件 sysfs-bus-coresight-devices-stm 中定义

(读写) 提供对 HW 事件块选择寄存器 (STMHEBSR) 的访问，以便配置多达 256 个通道。与如上所述的“hwevent_enable”寄存器结合使用。

/sys/bus/coresight/devices/<memory_map>.stm/port_enable

在文件 sysfs-bus-coresight-devices-stm 中定义

(读写) 提供对刺激端口启用寄存器 (STMSPER) 的访问。与下面描述的“port_select”结合使用。

/sys/bus/coresight/devices/<memory_map>.stm/port_select

在文件 sysfs-bus-coresight-devices-stm 中定义

(读写) 用于确定寄存器 STMSPER (见上文) 中的哪个刺激端口位组适用。

/sys/bus/coresight/devices/<memory_map>.stm/status

在文件 sysfs-bus-coresight-devices-stm 中定义

(只读) 列出各种控制和状态寄存器。具体的布局和内容是驱动程序特定的。

/sys/bus/coresight/devices/<memory_map>.stm/traceid

在文件 sysfs-bus-coresight-devices-stm 中定义

(读写) 保存将出现在来自此跟踪实体的跟踪流中的跟踪 ID。

/sys/bus/coresight/devices/<memory_map>.tmc/buf_mode_preferred

在文件 sysfs-bus-coresight-devices-tmc 中定义

(读写) 当前选择了 Coresight TMC-ETR 缓冲模式。但用户只能提供给定 ETR 设备支持的模式。此文件仅适用于 TMC ETR 设备。

/sys/bus/coresight/devices/<memory_map>.tmc/buf_modes_available

在文件 sysfs-bus-coresight-devices-tmc 中定义

(只读) 显示所有支持的 Coresight TMC-ETR 缓冲模式，供用户显式配置。此文件仅适用于 TMC ETR 设备。

/sys/bus/coresight/devices/<memory_map>.tmc/buffer_size

在文件 sysfs-bus-coresight-devices-tmc 中定义

(读写) 在 SYSFS 模式下使用时，TMC-ETR 的跟踪缓冲区大小。仅可为 TMC-ETR 配置写入。该值应与内核页面大小对齐。

/sys/bus/coresight/devices/<memory_map>.tmc/mgmt/ctl

在文件 sysfs-bus-coresight-devices-tmc 中定义

(只读) 显示 TMC 控制寄存器所保存的值。该值直接从硬件寄存器 CTL，0x020 读取。

/sys/bus/coresight/devices/<memory_map>.tmc/mgmt/devid

在文件 sysfs-bus-coresight-devices-tmc 中定义

(只读) 指示 Coresight TMC 的功能。该值直接从 DEVID 寄存器 0xFC8 读取。

/sys/bus/coresight/devices/<memory_map>.tmc/mgmt/ffcr

在文件 sysfs-bus-coresight-devices-tmc 中定义

(只读) 显示 TMC 格式化程序和刷新控制寄存器所保存的值。该值直接从硬件寄存器 FFCR，0x304 读取。

/sys/bus/coresight/devices/<memory_map>.tmc/mgmt/ffsr

在文件 sysfs-bus-coresight-devices-tmc 中定义

(只读) 显示 TMC 格式化程序和刷新状态寄存器所保存的值。该值直接从硬件寄存器 FFSR，0x300 读取。

/sys/bus/coresight/devices/<memory_map>.tmc/mgmt/mode

在文件 sysfs-bus-coresight-devices-tmc 中定义

(只读) 显示 TMC 模式寄存器所保存的值，该值指示设备已配置为执行的模式。该值直接从 MODE 寄存器 0x028 读取。

/sys/bus/coresight/devices/<memory_map>.tmc/mgmt/rrp

在文件 sysfs-bus-coresight-devices-tmc 中定义

(只读) 显示 TMC RAM 读取指针寄存器所保存的值，该寄存器用于通过 APB 接口从跟踪 RAM 读取条目。该值直接从硬件寄存器 RRP，0x014 读取。

/sys/bus/coresight/devices/<memory_map>.tmc/mgmt/rsz

在文件 sysfs-bus-coresight-devices-tmc 中定义

(只读) 定义本地 RAM 缓冲区的大小（以 32 位字为单位）。该值直接从硬件寄存器 RSZ，0x004 读取。

/sys/bus/coresight/devices/<memory_map>.tmc/mgmt/rwp

在文件 sysfs-bus-coresight-devices-tmc 中定义

(只读) 显示 TMC RAM 写入指针寄存器所保存的值，该寄存器用于设置写入指针，以将来自 CoreSight 总线的条目写入跟踪 RAM。该值直接从硬件寄存器 RWP，0x018 读取。

/sys/bus/coresight/devices/<memory_map>.tmc/mgmt/sts

在文件 sysfs-bus-coresight-devices-tmc 中定义

(只读) 显示 TMC 状态寄存器所保存的值。该值直接从硬件寄存器 STS，0x00C 读取。

/sys/bus/coresight/devices/<memory_map>.tmc/mgmt/trg

在文件 sysfs-bus-coresight-devices-tmc 中定义

(只读) 与上面的“trigger_cntr”类似，不同之处在于此值直接从硬件寄存器 TRG (0x01C) 读取。

/sys/bus/coresight/devices/<memory_map>.tmc/trigger_cntr

在文件 sysfs-bus-coresight-devices-tmc 中定义

(读写) 在触发事件后存储了定义数量的字后，通过停止格式化程序来禁用对跟踪 RAM 的写入访问。随着驱动程序的成熟，预计会添加其他接口。

/sys/bus/coresight/devices/<tpdm-name>/cmb_mode

在文件 sysfs-bus-coresight-devices-tpdm 中定义

(写) 设置 CMB tpdm 的数据收集模式。连续更改会在每个 CMBCLK 边沿创建 CMB 数据集元素。仅当新的数据集元素的值与 CMB 数据集中的前一个元素的值不同时，“跟踪更改”才会创建 CMB 数据集元素。

仅接受 2 个值之一 - 0 或 1。0：连续 CMB 收集模式。1：跟踪更改 CMB 收集模式。

/sys/bus/coresight/devices/<tpdm-name>/cmb_msr/msr[0:31]

在文件 sysfs-bus-coresight-devices-tpdm 中定义

(读写) 设置/获取 CMB 子单元 TPDM 的 MSR（多路复用器选择寄存器）。

/sys/bus/coresight/devices/<tpdm-name>/cmb_patt/enable_ts

在文件 sysfs-bus-coresight-devices-tpdm 中定义

(写) 设置 CMB tpdm 的模式时间戳。读取 CMB tpdm 的模式时间戳。

仅接受 2 个值之一 - 0 或 1。0：禁用 CMB 模式时间戳。1：启用 CMB 模式时间戳。

/sys/bus/coresight/devices/<tpdm-name>/cmb_trig_patt/xpmr[0:1]

在文件 sysfs-bus-coresight-devices-tpdm 中定义

(读写) 设置/获取 CMB 子单元 TPDM 的触发模式的掩码。

/sys/bus/coresight/devices/<tpdm-name>/cmb_trig_patt/xpr[0:1]

在文件 sysfs-bus-coresight-devices-tpdm 中定义

(读写) 设置/获取 CMB 子单元 TPDM 的触发模式的值。

/sys/bus/coresight/devices/<tpdm-name>/cmb_trig_ts

在文件 sysfs-bus-coresight-devices-tpdm 中定义

(读写) 设置/获取 tpdm 的 CMB 触发时间戳。

仅接受 2 个值之一 - 0 或 1。0：将 CMB 触发类型设置为 false。1：将 CMB 触发类型设置为 true。

/sys/bus/coresight/devices/<tpdm-name>/cmb_ts_all

在文件 sysfs-bus-coresight-devices-tpdm 中定义

(读写) 读取或写入所有接口上的时间戳状态。只能将值 0 和 1 写入此节点。将此节点设置为 1 以请求所有跟踪数据包的时间戳。仅接受 2 个值之一 - 0 或 1。0：禁用所有跟踪数据包的时间戳。1：启用所有跟踪数据包的时间戳。

/sys/bus/coresight/devices/<tpdm-name>/dsb_edge/ctrl_idx

在文件 sysfs-bus-coresight-devices-tpdm 中定义

(读写) 设置/获取 DSB 子单元 TPDM 的边沿检测的索引号。由于最多有 256 个边沿检测，因此该值的范围为 0 到 255。

/sys/bus/coresight/devices/<tpdm-name>/dsb_edge/ctrl_mask

在文件 sysfs-bus-coresight-devices-tpdm 中定义

写入数据以屏蔽与索引号对应的边沿检测。在将数据写入此 sysfs 文件之前，应首先写入“ctrl_idx”以配置需要屏蔽的边沿检测的索引号。

仅接受 2 个值之一 - 0 或 1。

/sys/bus/coresight/devices/<tpdm-name>/dsb_edge/ctrl_val

在文件 sysfs-bus-coresight-devices-tpdm 中定义

写入数据以控制与索引号对应的边沿检测。在将数据写入此 sysfs 文件之前，应首先写入“ctrl_idx”以配置需要控制的边沿检测的索引号。

仅接受以下值之一。0 - 上升沿检测。1 - 下降沿检测。2 - 上升和下降沿检测（切换检测）。

/sys/bus/coresight/devices/<tpdm-name>/dsb_edge/edcmr[0:7]

在文件 sysfs-bus-coresight-devices-tpdm 中定义

读取 TPDM 中 DSB 的一组边沿控制掩码。

/sys/bus/coresight/devices/<tpdm-name>/dsb_edge/edcr[0:15]

在文件 sysfs-bus-coresight-devices-tpdm 中定义

读取 TPDM 中 DSB 的一组边沿控制值。

/sys/bus/coresight/devices/<tpdm-name>/dsb_mode

在文件 sysfs-bus-coresight-devices-tpdm 中定义

(读写) 设置/获取 tpdm 的 DSB 的编程模式。

接受的值需要大于 0。下面列出了数据位的含义。Bit[0:1]：用于选择输入的测试模式控制位。Bit[3]：设置为 0 表示低性能模式。设置为 1 表示高性能模式。Bit[4:8]：为高性能模式选择字节通道。

/sys/bus/coresight/devices/<tpdm-name>/dsb_msr/msr[0:31]

在文件 sysfs-bus-coresight-devices-tpdm 中定义

(读写) 设置/获取 DSB 子单元 TPDM 的 MSR（多路复用器选择寄存器）。

/sys/bus/coresight/devices/<tpdm-name>/dsb_patt/enable_ts

在文件 sysfs-bus-coresight-devices-tpdm 中定义

(写) 设置 DSB tpdm 的模式时间戳。读取 DSB tpdm 的模式时间戳。

仅接受 2 个值之一 - 0 或 1。0：禁用 DSB 模式时间戳。1：启用 DSB 模式时间戳。

/sys/bus/coresight/devices/<tpdm-name>/dsb_patt/set_type

在文件 sysfs-bus-coresight-devices-tpdm 中定义

(写) 设置 DSB tpdm 的模式类型。读取 DSB tpdm 的模式类型。

仅接受 2 个值之一 - 0 或 1。0：将 DSB 模式类型设置为值。1：将 DSB 模式类型设置为切换。

/sys/bus/coresight/devices/<tpdm-name>/dsb_patt/tpmr[0:1]

在文件 sysfs-bus-coresight-devices-tpdm 中定义

(读写) 设置/获取 CMB 子单元 TPDM 的模式的掩码。

/sys/bus/coresight/devices/<tpdm-name>/dsb_patt/tpmr[0:7]

在文件 sysfs-bus-coresight-devices-tpdm 中定义

(读写) 设置/获取 DSB 子单元 TPDM 的模式的掩码。

/sys/bus/coresight/devices/<tpdm-name>/dsb_patt/tpr[0:1]

在文件 sysfs-bus-coresight-devices-tpdm 中定义

(读写) 设置/获取 CMB 子单元 TPDM 的模式的值。

/sys/bus/coresight/devices/<tpdm-name>/dsb_patt/tpr[0:7]

在文件 sysfs-bus-coresight-devices-tpdm 中定义

(读写) 设置/获取 DSB 子单元 TPDM 的模式的值。

/sys/bus/coresight/devices/<tpdm-name>/dsb_trig_patt/xpmr[0:7]

在文件 sysfs-bus-coresight-devices-tpdm 中定义

(读写) 设置/获取 DSB 子单元 TPDM 的触发模式的掩码。

/sys/bus/coresight/devices/<tpdm-name>/dsb_trig_patt/xpr[0:7]

在文件 sysfs-bus-coresight-devices-tpdm 中定义

(读写) 设置/获取 DSB 子单元 TPDM 的触发模式的值。

/sys/bus/coresight/devices/<tpdm-name>/dsb_trig_ts

在文件 sysfs-bus-coresight-devices-tpdm 中定义

(读写) 设置/获取 tpdm 的 DSB 的触发时间戳。

仅接受 2 个值之一 - 0 或 1。0：将 DSB 触发类型设置为 false。1：将 DSB 触发类型设置为 true。

/sys/bus/coresight/devices/<tpdm-name>/dsb_trig_type

在文件 sysfs-bus-coresight-devices-tpdm 中定义

(读写) 设置/获取 tpdm 的 DSB 的触发类型。

仅接受 2 个值之一 - 0 或 1。0：将 DSB 触发类型设置为 false。1：将 DSB 触发类型设置为 true。

/sys/bus/coresight/devices/<tpdm-name>/integration_test

在文件 sysfs-bus-coresight-devices-tpdm 中定义

(写) 运行 tpdm 的集成测试。集成测试将为 tpdm 生成测试数据。它可以帮助确保跟踪路径已启用且链接配置良好。

仅接受 2 个值之一 - 1 或 2。1：生成 64 位数据。2：生成 32 位数据。

/sys/bus/coresight/devices/<tpdm-name>/reset_dataset

在文件 sysfs-bus-coresight-devices-tpdm 中定义

(写) 重置 tpdm 的数据集。

仅接受一个值 - 1。1：重置 tpdm 的数据集。

/sys/bus/coresight/devices/etm<N>/addr_cmp_view

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(只读) 打印所选地址比较器的当前设置。

/sys/bus/coresight/devices/etm<N>/addr_exlevel_s_ns

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(读写) 为安全和非安全异常级别设置异常级别匹配位。

/sys/bus/coresight/devices/etm<N>/addr_idx

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(读写) 选择要使用的地址比较器或一对比较器。

/sys/bus/coresight/devices/etm<N>/addr_instdatatype

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(读写) 控制跟踪单元执行的比较类型。

/sys/bus/coresight/devices/etm<N>/addr_range

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(读写) 用于设置地址范围比较器的值。

/sys/bus/coresight/devices/etm<N>/addr_single

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(读写) 用于设置单个地址比较器的值。

/sys/bus/coresight/devices/etm<N>/bb_ctrl

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(读写) 控制内存映射中的哪些区域可以启用分支广播。

/sys/bus/coresight/devices/etm<N>/cntr_ctrl

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(读写) 控制所选计数器的操作。

/sys/bus/coresight/devices/etm<N>/cntr_idx

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(读写) 选择要使用的计数器单元。

/sys/bus/coresight/devices/etm<N>/cntr_val

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(读写) 设置或返回特定计数器的当前计数值。

/sys/bus/coresight/devices/etm<N>/cntrldvr

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(读写) 设置或返回特定计数器的重载计数值。

/sys/bus/coresight/devices/etm<N>/cpu

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(只读) 此跟踪实体关联的 CPU。

/sys/bus/coresight/devices/etm<N>/ctxid_idx

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(读写) 选择要使用的上下文 ID 比较器。

/sys/bus/coresight/devices/etm<N>/ctxid_masks

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(读写) 所有 8 个上下文 ID 比较器值寄存器的掩码（如果已实现）。

/sys/bus/coresight/devices/etm<N>/ctxid_pid

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(读写) 获取/设置要触发的上下文 ID 比较器值。

/sys/bus/coresight/devices/etm<N>/cyc_threshold

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(读写) 设置周期计数的阈值。

/sys/bus/coresight/devices/etm<N>/enable_source

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(读写) 启用/禁用此特定跟踪实体的跟踪。启用源意味着该源已正确配置，并且已为其标识了一个接收器。连接源到接收器的 CoreSight 组件的路径由 CoreSight 框架自动配置和管理。

/sys/bus/coresight/devices/etm<N>/event

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(读写) 控制从库 0 到 3 的任意事件的跟踪。

/sys/bus/coresight/devices/etm<N>/event_instren

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(读写) 控制库 0 到 3 中事件的行为。

/sys/bus/coresight/devices/etm<N>/event_ts

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(读写) 控制在跟踪流中插入全局时间戳。

/sys/bus/coresight/devices/etm<N>/event_vinst

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(读写) 控制指令跟踪过滤。

/sys/bus/coresight/devices/etm<N>/mgmt/trcauthstatus

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(只读) 打印身份验证状态寄存器 (0xFB8) 的内容。该值直接取自硬件。

/sys/bus/coresight/devices/etm<N>/mgmt/trcconfig

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(只读) 打印 SW 当前设置的跟踪配置寄存器 (0x010) 的内容。

/sys/bus/coresight/devices/etm<N>/mgmt/trcdevarch

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(只读) 打印设备体系结构寄存器（偏移量 0xFBC）的内容。该值直接从硬件读取。

/sys/bus/coresight/devices/etm<N>/mgmt/trcdevid

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(只读) 打印设备 ID 寄存器 (0xFC8) 的内容。该值直接取自硬件。

/sys/bus/coresight/devices/etm<N>/mgmt/trcdevtype

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(只读) 打印设备类型寄存器 (0xFCC) 的内容。该值直接取自硬件。

/sys/bus/coresight/devices/etm<N>/mgmt/trclsr

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(读取) 打印软件锁状态寄存器 (0xFB4) 的内容。该值直接从硬件获取。

/sys/bus/coresight/devices/etm<N>/mgmt/trcoslsr

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(读取) 打印操作系统锁状态寄存器 (0x304) 的内容。该值直接从硬件获取。

/sys/bus/coresight/devices/etm<N>/mgmt/trcpdcr

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(读取) 打印电源关闭控制寄存器 (0x310) 的内容。该值直接从硬件获取。

/sys/bus/coresight/devices/etm<N>/mgmt/trcpdsr

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(读取) 打印电源关闭状态寄存器 (0x314) 的内容。该值直接从硬件获取。

/sys/bus/coresight/devices/etm<N>/mgmt/trcpidr0

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(读取) 打印外围设备 ID0 寄存器 (0xFE0) 的内容。该值直接从硬件获取。

/sys/bus/coresight/devices/etm<N>/mgmt/trcpidr1

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(读取) 打印外围设备 ID1 寄存器 (0xFE4) 的内容。该值直接从硬件获取。

/sys/bus/coresight/devices/etm<N>/mgmt/trcpidr2

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(读取) 打印外围设备 ID2 寄存器 (0xFE8) 的内容。该值直接从硬件获取。

/sys/bus/coresight/devices/etm<N>/mgmt/trcpidr3

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(读取) 打印外围设备 ID3 寄存器 (0xFEC) 的内容。该值直接从硬件获取。

/sys/bus/coresight/devices/etm<N>/mgmt/trctraceid

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(读取) 打印跟踪 ID 寄存器 (0x040) 的内容。

/sys/bus/coresight/devices/etm<N>/mode

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(读写) 控制此 ETM 支持的各种模式，例如 P0 指令跟踪、分支广播、循环计数和上下文 ID 跟踪。

/sys/bus/coresight/devices/etm<N>/nr_addr_cmp

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(读取) 指示可用于跟踪的地址比较器对的数量。

/sys/bus/coresight/devices/etm<N>/nr_cntr

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(读取) 指示可用于跟踪的计数器数量。

/sys/bus/coresight/devices/etm<N>/nr_ext_inp

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(读取) 指示实现了多少个外部输入。

/sys/bus/coresight/devices/etm<N>/nr_pe_cmp

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(读取) 指示可用于跟踪的 PE 比较器输入数量。

/sys/bus/coresight/devices/etm<N>/nr_resource

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(读取) 指示可用于跟踪的资源选择对的数量。

/sys/bus/coresight/devices/etm<N>/nr_ss_cmp

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(读取) 指示可用于跟踪的单次触发比较器控件的数量。

/sys/bus/coresight/devices/etm<N>/nrseqstate

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(读取) 指示实现的序列器状态的数量。

/sys/bus/coresight/devices/etm<N>/ns_exlevel_vinst

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(读写) 在非安全状态下，每一位控制是否为相应的异常级别启用指令跟踪。

/sys/bus/coresight/devices/etm<N>/numcidc

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(读取) 指示可用于跟踪的上下文 ID 比较器的数量。

/sys/bus/coresight/devices/etm<N>/numvmidc

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(读取) 指示可用于跟踪的 VMID 比较器的数量。

/sys/bus/coresight/devices/etm<N>/pe

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(读写) 控制要跟踪的 PE。

/sys/bus/coresight/devices/etm<N>/res_ctrl

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(读写) 控制跟踪单元中资源的选择。

/sys/bus/coresight/devices/etm<N>/res_idx

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(读写) 选择要使用的资源选择单元。

/sys/bus/coresight/devices/etm<N>/reset

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(写入) 取消跟踪单元上的所有配置，并将其设置回其启动配置。

/sys/bus/coresight/devices/etm<N>/s_exlevel_vinst

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(读写) 在安全状态下，每一位控制是否为相应的异常级别启用指令跟踪。

/sys/bus/coresight/devices/etm<N>/seq_event

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(读写) 将序列器状态移动到特定状态。

/sys/bus/coresight/devices/etm<N>/seq_idx

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(读写) 选择哪个序列器。

/sys/bus/coresight/devices/etm<N>/seq_reset_event

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(读写) 当发生已编程的事件时，将序列器移动到状态 0。

/sys/bus/coresight/devices/etm<N>/seq_state

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(读写) 使用此项设置或读取序列器状态。

/sys/bus/coresight/devices/etm<N>/sshot_ctrl

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(读写) 访问选定的单次触发控制寄存器。

/sys/bus/coresight/devices/etm<N>/sshot_idx

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(读写) 选择要访问的单次触发控制寄存器。

/sys/bus/coresight/devices/etm<N>/sshot_pe_ctrl

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(读写) 访问选定的单次触发 PE 比较器控制寄存器。

/sys/bus/coresight/devices/etm<N>/sshot_status

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(读取) 打印选定的单次触发状态寄存器的当前值。

/sys/bus/coresight/devices/etm<N>/syncfreq

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(读写) 控制跟踪同步请求发生的频率。

/sys/bus/coresight/devices/etm<N>/trcidr/trcidr0

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(读取) 返回跟踪单元的跟踪功能 (0x1E0)。该值直接从硬件获取。

/sys/bus/coresight/devices/etm<N>/trcidr/trcidr1

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(读取) 返回跟踪单元的跟踪功能 (0x1E4)。该值直接从硬件获取。

/sys/bus/coresight/devices/etm<N>/trcidr/trcidr10

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(读取) 返回跟踪单元可以使用的 P1 右侧键的数量 (0x188)。该值直接从硬件获取。

/sys/bus/coresight/devices/etm<N>/trcidr/trcidr11

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(读取) 返回跟踪单元可以使用的特殊 P1 右侧键的数量 (0x18C)。该值直接从硬件获取。

/sys/bus/coresight/devices/etm<N>/trcidr/trcidr12

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(读取) 返回跟踪单元可以使用的条件 P1 右侧键的数量 (0x190)。该值直接从硬件获取。

/sys/bus/coresight/devices/etm<N>/trcidr/trcidr13

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(读取) 返回跟踪单元可以使用的特殊条件 P1 右侧键的数量 (0x194)。该值直接从硬件获取。

/sys/bus/coresight/devices/etm<N>/trcidr/trcidr2

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(读取) 返回跟踪单元中数据值、数据地址、VMID、上下文 ID 和指令地址的最大大小 (0x1E8)。该值直接从硬件获取。

/sys/bus/coresight/devices/etm<N>/trcidr/trcidr3

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(读取) 返回与跟踪单元可用的各种资源关联的值。有关更多详细信息，请参阅跟踪宏单元架构规范 (0x1E8)。该值直接从硬件获取。

/sys/bus/coresight/devices/etm<N>/trcidr/trcidr4

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(读取) 返回跟踪单元支持的资源数量 (0x1F0)。该值直接从硬件获取。

/sys/bus/coresight/devices/etm<N>/trcidr/trcidr5

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(读取) 返回跟踪单元支持的资源数量 (0x1F4)。该值直接从硬件获取。

/sys/bus/coresight/devices/etm<N>/trcidr/trcidr8

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(读取) 返回指令跟踪流的最大推测深度。(0x180)。该值直接从硬件获取。

/sys/bus/coresight/devices/etm<N>/trcidr/trcidr9

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(读取) 返回跟踪单元可以使用的 P0 右侧键的数量 (0x184)。该值直接从硬件获取。

/sys/bus/coresight/devices/etm<N>/ts_source

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(读取) 当实现 FEAT_TRF 时，用于跟踪会话的 TRFCR_ELx.TS 的值。否则，-1 表示未知的时间源。检查 trcidr0.tssize 以查看是否有全局时间戳可用。

/sys/bus/coresight/devices/etm<N>/vinst_pe_cmp_start_stop

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(读写) 访问 PE 输入比较器的启动停止控制寄存器。

/sys/bus/coresight/devices/etm<N>/vmid_idx

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(读写) 选择要使用的虚拟机 ID 比较器。

/sys/bus/coresight/devices/etm<N>/vmid_masks

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(读写) 所有 8 个虚拟机 ID 比较器值寄存器的掩码（如果已实现）。

/sys/bus/coresight/devices/etm<N>/vmid_val

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(读写) 获取/设置要触发的虚拟机 ID 比较器值。

/sys/bus/coresight/devices/trbe<cpu>/align

在文件 sysfs-bus-coresight-devices-trbe 中定义

(读取) 显示 TRBE 写指针对齐方式。此值从 TRBIDR 寄存器获取。

/sys/bus/coresight/devices/trbe<cpu>/flag

在文件 sysfs-bus-coresight-devices-trbe 中定义

(读取) 显示 TRBE 内存中的更新是否也带有访问和脏标志更新。此值从 TRBIDR 寄存器获取。

/sys/bus/coresight/devices/ultra_smb<N>/enable_sink

在文件 sysfs-bus-coresight-devices-ultra_smb 中定义

(读写) 从跟踪路径添加/删除 SMB 设备。单个 SMB 设备可以有多个源。

/sys/bus/coresight/devices/ultra_smb<N>/mgmt/buf_size

在文件 sysfs-bus-coresight-devices-ultra_smb 中定义

(只读) 显示每个 UltraSoc SMB 设备的缓冲区大小。

/sys/bus/coresight/devices/ultra_smb<N>/mgmt/buf_status

在文件 sysfs-bus-coresight-devices-ultra_smb 中定义

(只读) 显示 UltraSoc SMB 状态寄存器的值。BIT(0) 为零表示缓冲区为空。

/sys/bus/coresight/devices/ultra_smb<N>/mgmt/read_pos

在文件 sysfs-bus-coresight-devices-ultra_smb 中定义

(只读) 显示 UltraSoc SMB 读指针寄存器的值。

/sys/bus/coresight/devices/ultra_smb<N>/mgmt/write_pos

在文件 sysfs-bus-coresight-devices-ultra_smb 中定义

(只读) 显示 UltraSoc SMB 写指针寄存器的值。

/sys/bus/counter/devices/counterX/cascade_counts_enable

在文件 sysfs-bus-counter 中定义

指示计数器 X 上计数的级联。

有效的属性值为布尔值。

/sys/bus/counter/devices/counterX/cascade_counts_enable_component_id

/sys/bus/counter/devices/counterX/external_input_phase_clock_select_component_id

/sys/bus/counter/devices/counterX/countY/capture_component_id

/sys/bus/counter/devices/counterX/countY/ceiling_component_id

/sys/bus/counter/devices/counterX/countY/floor_component_id

/sys/bus/counter/devices/counterX/countY/count_mode_component_id

/sys/bus/counter/devices/counterX/countY/direction_component_id

/sys/bus/counter/devices/counterX/countY/enable_component_id

/sys/bus/counter/devices/counterX/countY/error_noise_component_id

/sys/bus/counter/devices/counterX/countY/prescaler_component_id

/sys/bus/counter/devices/counterX/countY/preset_component_id

/sys/bus/counter/devices/counterX/countY/preset_enable_component_id

/sys/bus/counter/devices/counterX/countY/signalZ_action_component_id

/sys/bus/counter/devices/counterX/countY/num_overflows_component_id

/sys/bus/counter/devices/counterX/signalY/cable_fault_component_id

/sys/bus/counter/devices/counterX/signalY/cable_fault_enable_component_id

/sys/bus/counter/devices/counterX/signalY/filter_clock_prescaler_component_id

/sys/bus/counter/devices/counterX/signalY/index_polarity_component_id

/sys/bus/counter/devices/counterX/signalY/polarity_component_id

/sys/bus/counter/devices/counterX/signalY/synchronous_mode_component_id

/sys/bus/counter/devices/counterX/signalY/frequency_component_id

在文件 sysfs-bus-counter 中定义

只读属性，指示各个扩展或 Synapse 的组件 ID。

/sys/bus/counter/devices/counterX/countY/capture

在文件 sysfs-bus-counter 中定义

计数 Y 计数数据的历史捕获。

/sys/bus/counter/devices/counterX/countY/ceiling

在文件 sysfs-bus-counter 中定义

计数 Y 的计数值上限。这是相应计数器的上限。

/sys/bus/counter/devices/counterX/countY/count

在文件 sysfs-bus-counter 中定义

以字符串形式表示的计数 Y 的计数数据。

/sys/bus/counter/devices/counterX/countY/count_mode

在文件 sysfs-bus-counter 中定义

通道 Y 的计数模式。计数 Y 的上限和下限值由需要计数模式使用。提供以下计数模式

正常

计数在任一方向上都是连续的。

范围限制

设置上限或下限，模拟机械部件中的限位开关。上限设置为计数 Y 上限值，而下限设置为计数 Y 下限值。向上计数时，计数器在计数 = 上限时冻结，向下计数时，计数器在计数 = 下限时冻结。在这些限制中的任何一个处，仅当计数方向反转时，计数才会恢复。

非循环

只要发生计数器溢出或下溢，计数器就会被禁用。当通过预设操作或直接写入将新计数值加载到计数器时，计数器将重新启用。

模 N

在计数 Y 下限值和计数 Y 上限值之间设置计数值边界。向上计数时，计数器在计数 = 上限时重置为计数 Y 下限值，而向下计数时，计数器在计数 = 下限时设置为计数 Y 上限值；计数器不会在边界点冻结，而是始终连续计数。

终端计数时中断

输出信号最初为低电平，并且将保持低电平，直到计数器达到零。然后，输出信号变为高电平，并保持高电平，直到设置新的预设值。

硬件可重触发单次触发

输出信号最初为高电平。输出信号将因触发输入信号而变为低电平，并且将保持低电平，直到计数器达到零。然后，输出将变为高电平并保持高电平，直到下一个触发。触发会导致将计数器加载到预设值并将输出信号设置为低电平，从而启动单次触发脉冲。

速率发生器

输出信号最初为高电平。当计数器递减到 1 时，输出信号将变为低电平一个时钟脉冲。然后，输出信号再次变为高电平，计数器重新加载到预设值，并且该过程以这种周期性方式重复进行。

方波模式

输出信号最初为高电平。

如果初始计数为偶数，则计数器在后续时钟脉冲上递减二。当计数到期时，输出信号会更改值，并且计数器重新加载到预设值。该过程以这种周期性方式重复进行。

如果初始计数为奇数，则加载初始计数减一（一个偶数）的值，然后在后续时钟脉冲上减 2。计数到期后一个时钟脉冲，输出信号变为低电平，并且计数器重新加载到预设值减一。后续时钟脉冲将计数减 2。当计数到期时，输出再次变为高电平，计数器重新加载到预设值减一。该过程以周期性的方式重复进行。

软件触发选通

输出信号最初为高电平。当计数到期时，输出将变为低电平一个时钟脉冲，然后再次变为高电平。通过设置预设值来“触发”计数序列。

硬件触发选通

输出信号最初为高电平。计数由触发输入信号启动。当计数到期时，输出信号将变为低电平一个时钟脉冲，然后再次变为高电平。触发会导致计数器加载到预设值。

/sys/bus/counter/devices/counterX/countY/count_mode_available

/sys/bus/counter/devices/counterX/countY/error_noise_available

/sys/bus/counter/devices/counterX/countY/function_available

/sys/bus/counter/devices/counterX/countY/prescaler_available

/sys/bus/counter/devices/counterX/countY/signalZ_action_available

在文件 sysfs-bus-counter 中定义

此文件中列出了各个计数 Y 配置的可用值离散集。值用换行符分隔。

/sys/bus/counter/devices/counterX/countY/direction

在文件 sysfs-bus-counter 中定义

只读属性，指示计数 Y 的计数方向。提供两个计数方向：正向和反向。

一些计数器设备能够确定其计数方向。例如，正交编码计数器可以通过评估各个 A 和 B 正交编码信号的超前相位来确定运动方向。此属性公开了这些计数方向。

/sys/bus/counter/devices/counterX/countY/enable

在文件 sysfs-bus-counter 中定义

是否启用通道 Y 计数器。有效的属性值为布尔值。

此属性旨在用作计数 Y 的暂停/取消暂停机制。假设计数器设备用于计算传送带的总移动量：此属性允许操作员临时暂停计数器，维修传送带，然后最终取消暂停计数器以继续上次停止的位置。

/sys/bus/counter/devices/counterX/countY/error_noise

在文件 sysfs-bus-counter 中定义

只读属性，指示通道 Y 计数器输入端是否存在过多噪声。

/sys/bus/counter/devices/counterX/countY/floor

在文件 sysfs-bus-counter 中定义

计数 Y 的计数值下限。这是各个计数器的下限。

/sys/bus/counter/devices/counterX/countY/function

在文件 sysfs-bus-counter 中定义

计数 Y 的计数功能模式；计数功能评估由计数 Y 的 signalZ_action 属性指定的条件触发。提供以下计数功能

增加

累积计数递增。

减少

累积计数递减。

脉冲方向

信号 A 上的上升沿更新相应的计数。信号 B 的输入电平确定方向。

正交 x1 a

如果方向为正向，则正交对信号 A 上的上升沿更新相应的计数；如果方向为反向，则正交对信号 A 上的下降沿更新相应的计数。正交编码确定方向。

正交 x1 b

如果方向为正向，则正交对信号 B 上的上升沿更新相应的计数；如果方向为反向，则正交对信号 B 上的下降沿更新相应的计数。正交编码确定方向。

正交 x2 a

正交对信号 A 上的任何状态转换都会更新相应的计数。正交编码确定方向。

正交 x2 b

正交对信号 B 上的任何状态转换都会更新相应的计数。正交编码确定方向。

正交 x4

任一正交对信号上的任何状态转换都会更新相应的计数。正交编码确定方向。

/sys/bus/counter/devices/counterX/countY/name

在文件 sysfs-bus-counter 中定义

只读属性，指示计数 Y 的特定于设备的名称。如果可能，这应该与设备数据表中出现的相应通道的名称匹配。

/sys/bus/counter/devices/counterX/countY/num_overflows

在文件 sysfs-bus-counter 中定义

此属性指示计数 Y 的溢出次数。

/sys/bus/counter/devices/counterX/countY/prescaler

在文件 sysfs-bus-counter 中定义

配置与计数 Y 关联的预分频值。在 FlexTimer 上，计数器时钟源通过预分频器（即计数器）。这就像一个时钟分频器。

/sys/bus/counter/devices/counterX/countY/preset

在文件 sysfs-bus-counter 中定义

如果计数器设备支持预设寄存器（用于在设备定义的预设操作触发事件后将计数器通道加载到设置计数的寄存器），则此属性提供通道 Y 的预设计数。

/sys/bus/counter/devices/counterX/countY/preset_enable

在文件 sysfs-bus-counter 中定义

是否启用通道 Y 计数器预设操作。有效的属性值为布尔值。

/sys/bus/counter/devices/counterX/countY/signalZ_action

在文件 sysfs-bus-counter 中定义

信号 Z 的计数 Y 的操作模式。此属性指示信号 Z 的哪个条件触发计数 Y 的计数功能评估。提供以下操作模式

无

信号不触发计数功能。在脉冲方向计数功能模式下，此信号被评估为方向。

上升沿

低状态转换为高状态。

下降沿

高状态转换为低状态。

双边沿

任何状态转换。

/sys/bus/counter/devices/counterX/countY/spike_filter_ns

在文件 sysfs-bus-counter 中定义

如果计数器设备支持可编程尖峰滤波器，则此属性指示以纳秒为单位的值，其中忽略短于或等于配置值的噪声脉冲。值 0 表示禁用滤波器。

/sys/bus/counter/devices/counterX/events_queue_size

在文件 sysfs-bus-counter 中定义

计数器事件队列的大小，以 struct counter_event 数据结构的数量表示。元素数量将向上舍入到 2 的幂。

/sys/bus/counter/devices/counterX/external_input_phase_clock_select

在文件 sysfs-bus-counter 中定义

为计数器 X 的相位计数模式选择外部时钟引脚。

MTCLKA-MTCLKB

选择 MTCLKA 和 MTCLKB 引脚作为外部相位时钟。

MTCLKC-MTCLKD

选择 MTCLKC 和 MTCLKD 引脚作为外部相位时钟。

/sys/bus/counter/devices/counterX/external_input_phase_clock_select_available

在文件 sysfs-bus-counter 中定义

此文件中列出了各个设备配置的可用值离散集。

/sys/bus/counter/devices/counterX/name

在文件 sysfs-bus-counter 中定义

只读属性，指示计数器的特定于设备的名称。这应该与设备在其各自数据表中出现的名称相匹配。

/sys/bus/counter/devices/counterX/num_counts

在文件 sysfs-bus-counter 中定义

只读属性，指示属于计数器的计数总数。

/sys/bus/counter/devices/counterX/num_signals

在文件 sysfs-bus-counter 中定义

只读属性，指示属于计数器的信号总数。

/sys/bus/counter/devices/counterX/signalY/cable_fault

在文件 sysfs-bus-counter 中定义

只读属性，指示是否检测到信号 Y 的相应通道的差分编码器电缆故障（未连接或松动的电线）。有效的属性值为布尔值。必须首先通过相应的 cable_fault_enable 属性启用检测。

/sys/bus/counter/devices/counterX/signalY/cable_fault_enable

在文件 sysfs-bus-counter 中定义

是否启用对信号 Y 的相应通道的差分编码器电缆故障的检测。有效的属性值为布尔值。

/sys/bus/counter/devices/counterX/signalY/filter_clock_prescaler

在文件 sysfs-bus-counter 中定义

输入信号 Y 的滤波器时钟因子。此预分频值会影响两个正交对信号的输入。

/sys/bus/counter/devices/counterX/signalY/frequency

在文件 sysfs-bus-counter 中定义

只读属性，指示信号 Y 的频率，单位为 Hz。

/sys/bus/counter/devices/counterX/signalY/index_polarity

在文件 sysfs-bus-counter 中定义

索引输入信号 Y 的有效电平；在非同步加载模式下无关紧要。

/sys/bus/counter/devices/counterX/signalY/index_polarity_available

/sys/bus/counter/devices/counterX/signalY/synchronous_mode_available

在文件 sysfs-bus-counter 中定义

此文件中列出了各个信号 Y 配置的可用值离散集。

/sys/bus/counter/devices/counterX/signalY/name

在文件 sysfs-bus-counter 中定义

只读属性，指示信号 Y 的特定于设备的名称。如果可能，这应该与设备数据表中出现的相应信号的名称相匹配。

/sys/bus/counter/devices/counterX/signalY/polarity

在文件 sysfs-bus-counter 中定义

信号 Y 的有效电平。提供以下极性值

正极

信号高电平状态被视为有效电平（上升沿）。

负极

信号低电平状态被视为有效电平（下降沿）。

/sys/bus/counter/devices/counterX/signalY/signal

在文件 sysfs-bus-counter 中定义

信号 Y 的信号电平状态。提供以下信号电平状态

低

低电平状态。

高

高电平状态。

/sys/bus/counter/devices/counterX/signalY/synchronous_mode

在文件 sysfs-bus-counter 中定义

为非同步或同步加载模式配置与信号 Y 关联的计数器。在非正交（脉冲方向）时钟模式下，无法选择同步加载模式。

非同步

逻辑低电平是此索引输入的有效电平。索引功能（如通过 preset_enable 启用）直接在索引输入的有效电平上执行。

同步

旨在与正交时钟模式下的编码器索引输出接口。有效电平通过 index_polarity 配置。索引功能（如通过 preset_enable 启用）与索引输入的有效电平上的正交时钟同步执行。

/sys/bus/css/devices/.../driver_override

在文件 sysfs-bus-css 中定义

此文件允许指定设备的驱动程序。指定后，只有名称与写入 driver_override 的值匹配的驱动程序才有机会绑定到该设备。通过向 driver_override 文件写入字符串（echo vfio-ccw > driver_override）来指定覆盖，并且可以使用空字符串清除覆盖（echo > driver_override）。这会将设备返回到标准的匹配规则绑定。写入 driver_override 不会自动将设备与其当前驱动程序取消绑定，也不会尝试自动加载指定的驱动程序。如果内核中当前未加载名称匹配的驱动程序，则设备将不会绑定到任何驱动程序。这也允许设备使用诸如“none”之类的 driver_override 名称来选择不进行驱动程序绑定。覆盖中只能指定单个驱动程序，不支持解析分隔符。

请注意，与 pci 中同名的机制不同，此文件不允许覆盖基本匹配规则。也就是说，驱动程序仍然必须匹配设备的子通道类型。

/sys/bus/css/devices/.../modalias

在文件 sysfs-bus-css 中定义

包含 uevent 报告的模块别名。其格式为 css:t<type>，且存在于所有子通道类型中。

/sys/bus/css/devices/.../type

在文件 sysfs-bus-css 中定义

包含硬件报告的子通道类型。此属性存在于所有子通道类型中。

/sys/bus/css/drivers/io_subchannel/.../chpids

在文件 sysfs-bus-css 中定义

包含此子通道使用的通道路径的 ID，由通道子系统在子通道识别期间报告。

注意：这是一个特定于 I/O 子通道的属性。

用户：s390-tools, HAL

/sys/bus/css/drivers/io_subchannel/.../pimpampom

在文件 sysfs-bus-css 中定义

包含 PIM/PAM/POM 值，由通道子系统在上次由通用 I/O 层查询时报告（这意味着此属性不一定与通道子系统中当前的值同步）。

注意：这是一个特定于 I/O 子通道的属性。

用户：s390-tools, HAL

/sys/bus/cxl/devices/*/devtype

在文件 sysfs-bus-cxl 中定义

（只读）CXL 设备对象导出 devtype 属性，该属性镜像在 “cxl” 总线上设备的 uevent 的 DEVTYPE 环境变量中传递的相同值。

/sys/bus/cxl/devices/*/modalias

在文件 sysfs-bus-cxl 中定义

（只读）CXL 设备对象导出 modalias 属性，该属性镜像在 “cxl” 总线上设备的 uevent 的 MODALIAS 环境变量中传递的相同值。

/sys/bus/cxl/devices/decoderX.Y

在文件 sysfs-bus-cxl 中定义

（只读）CXL 解码器对象从平台固件描述或 PCIe 设备中的 CXL HDM 解码器寄存器集枚举而来（请参阅 CXL 2.0 章节 8.2.5.12 CXL HDM 解码器功能结构）。decoderX.Y 中的 “X” 表示此解码器的 cxl_port 容器，“Y” 表示给定解码器资源的实例 ID。

/sys/bus/cxl/devices/decoderX.Y/cap_{pmem,ram,type2,type3}

在文件 sysfs-bus-cxl 中定义

（只读）当 CXL 解码器的 devtype 为 “cxl_decoder_root” 时，它表示由平台固件标识的固定内存窗口。固定窗口可能仅支持一部分内存类型。“cap_*” 属性指示是否可以在此解码器的内存窗口后面映射持久内存、易失性内存、加速器内存和/或扩展器内存。

/sys/bus/cxl/devices/decoderX.Y/create_{pmem,ram}_region

在文件 sysfs-bus-cxl 中定义

（读写）写入 “regionZ” 形式的字符串，以启动在根解码器 “decoderX.Y” 边界的解码范围内定义新的持久或易失性内存区域（交织集）的过程。写入的值必须与从读取此属性返回的当前值匹配。在写入时执行原子比较交换操作，以将请求的 ID 分配给区域，并为下一次创建尝试分配区域 ID。如果写入的区域名称与当前缓存的值不匹配，则返回 EBUSY。

/sys/bus/cxl/devices/decoderX.Y/delete_region

在文件 sysfs-bus-cxl 中定义

（只写）写入 “regionZ” 形式的字符串以删除该区域，前提是该区域当前处于空闲状态/未绑定到驱动程序。

/sys/bus/cxl/devices/decoderX.Y/dpa_resource

在文件 sysfs-bus-cxl 中定义

（只读）当 CXL 解码器的 devtype 为 “cxl_decoder_endpoint” 且其 “dpa_size” 属性为非零时，此属性指示分配的设备物理地址 (DPA) 基地址。

/sys/bus/cxl/devices/decoderX.Y/dpa_size

在文件 sysfs-bus-cxl 中定义

（读写）当 CXL 解码器的 devtype 为 “cxl_decoder_endpoint” 时，它将主机物理地址范围转换为设备本地地址范围。分配给此解码器的 DPA 的范围（基地址加字节长度）在这 2 个属性中传达。只要解码器处于禁用状态，就可以更改分配。“dpa_size” 的写入会释放之前的 DPA 分配，然后尝试从 “decoderX.Y/mode” 引用的设备分区中的可用容量进行分配。分配和释放请求只能在具有非零大小的最高实例号禁用解码器上执行。也就是说，强制分配以递增的 “decoderX.Y/id” 顺序发生，并且强制释放以递减的 “decoderX.Y/id” 顺序发生。

/sys/bus/cxl/devices/decoderX.Y/interleave_granularity

在文件 sysfs-bus-cxl 中定义

（只读）此解码器在地址 N 处声明的主机物理地址空间连续字节数，然后解码在地址 N + interleave_granularity 处轮换到交织中的下一个目标（假设 N 与 interleave_granularity 对齐）。

/sys/bus/cxl/devices/decoderX.Y/interleave_ways

在文件 sysfs-bus-cxl 中定义

（只读）此解码器的主机物理地址 (HPA) 内存范围在其间交织的目标数。设备将每个 N 个 HPA 块（大小 == “interleave_granularity”）映射到连续的 DPA 地址。解码器在交织中的位置由设备（端点或交换机）的交换机祖先确定。对于根解码器，它们的交织由平台固件指定，并且它们仅为主机桥指定下游目标顺序。

/sys/bus/cxl/devices/decoderX.Y/locked

在文件 sysfs-bus-cxl 中定义

（只读）CXL HDM 解码器具有锁定配置的功能，直到下次设备重置。对于 devtype 为 “cxl_decoder_root” 的解码器，没有标准工具来解锁它们。对于 devtype 为 “cxl_decoder_switch” 的解码器，为该解码器的 uport 提供总线的 PCIe 桥的辅助总线重置会解锁/重置解码器。

/sys/bus/cxl/devices/decoderX.Y/mode

在文件 sysfs-bus-cxl 中定义

（读写）当 CXL 解码器的 devtype 为 “cxl_decoder_endpoint” 时，它将主机物理地址范围转换为设备本地地址范围。设备本地地址范围进一步分为 “ram”（易失性内存）范围和 “pmem”（持久内存）范围。“mode” 属性发出 “ram”、“pmem”、“mixed” 或 “none” 中的一个。“mixed” 指示用于解码器跨越易失性/持久性分区边界的错误情况，“none” 指示解码器未主动解码，或者未设置任何 DPA 分配策略。

当解码器处于 “disabled” 状态时，可以使用 “ram” 或 “pmem” 写入 “mode”，以设置下一次分配的边界。

/sys/bus/cxl/devices/decoderX.Y/qos_class

在文件 sysfs-bus-cxl 中定义

（只读）对于支持“QoS 遥测”的 CXL 主机平台，此仅限根解码器的属性传递一个平台特定的 cookie，该 cookie 标识 CXL 窗口的 QoS 性能类。可以将此类 ID 与每个端点支持的每种内存类型发布的类似 “qos_class” 进行比较。虽然不需要端点将其本地内存类映射到匹配的平台类，但不建议不匹配，并且可能会产生平台特定的副作用。

/sys/bus/cxl/devices/decoderX.Y/target_list

在文件 sysfs-bus-cxl 中定义

（只读）显示当前解码器目标配置的逗号分隔列表。该列表按解码器的 dport 实例的当前配置交织顺序排序。列表中的每个条目都是一个 dport id。

/sys/bus/cxl/devices/decoderX.Y/target_type

在文件 sysfs-bus-cxl 中定义

（只读）当 CXL 解码器的 devtype 为 “cxl_decoder_switch” 时，它可以选择解码加速器内存（type-2）或扩展器内存（type-3）。“target_type” 属性指示当前设置，该设置可能会根据此解码层次结构中激活的内存区域动态更改。

/sys/bus/cxl/devices/decoderX.Y/{start,size}

在文件 sysfs-bus-cxl 中定义

（只读）“start” 和 “size” 属性一起传达解码器解码窗口中映射的物理地址基地址和字节数。对于 devtype 为 “cxl_decoder_root” 的解码器，地址范围是固定的。对于 devtype 为 “cxl_decoder_switch” 的解码器，地址受解码器的 cxl_port 祖先的 cxl_port 的解码范围限制，并根据该地址空间中的活动内存区域动态更新。

/sys/bus/cxl/devices/endpointX/CDAT

在文件 sysfs-bus-cxl 中定义

（只读）如果此 sysfs 条目不存在，则表示未找到支持 CDAT 数据的 DOE 邮箱。如果它存在且数据长度为 0，则表示读取 CDAT 数据失败。否则，将报告 CDAT 数据。

/sys/bus/cxl/devices/memX/firmware/

在文件 sysfs-bus-cxl 中定义

（读写）固件上传机制。此目录下的不同文件可用于为 CXL 设备上传和激活新固件。此下的接口记录在 sysfs-class-firmware 中。

/sys/bus/cxl/devices/memX/firmware_version

在文件 sysfs-bus-cxl 中定义

（只读）CXL-2.0 规范中“识别内存设备输出有效负载”报告的“固件版本”字符串。

/sys/bus/cxl/devices/memX/numa_node

在文件 sysfs-bus-cxl 中定义

（只读）如果启用了 NUMA 并且平台已为此内存设备关联了主机 PCI 设备，则发出此设备的 CPU 节点关联。

/sys/bus/cxl/devices/memX/pmem/qos_class

在文件 sysfs-bus-cxl 中定义

（只读）对于支持“QoS 遥测”的 CXL 主机平台，此属性传递一个以逗号分隔的平台特定 cookie 列表，该列表标识 CXL mem 设备的持久分区的 QoS 性能类。可以将这些类 ID 与为根解码器发布的类似 “qos_class” 进行比较。虽然不需要端点将其本地内存类映射到匹配的平台类，但不建议不匹配，并且可能会产生平台特定的性能相关副作用。显示第一个类 ID。

/sys/bus/cxl/devices/memX/pmem/size

在文件 sysfs-bus-cxl 中定义

（只读）以字节为单位的“仅持久容量”。表示 CXL-2.0 规范中“识别内存设备输出有效负载”中同名的字段。

/sys/bus/cxl/devices/memX/ram/qos_class

在文件 sysfs-bus-cxl 中定义

（只读）对于支持“QoS 遥测”的 CXL 主机平台，此属性传递一个以逗号分隔的平台特定 cookie 列表，该列表标识 CXL mem 设备的易失性分区的 QoS 性能类。可以将这些类 ID 与为根解码器发布的类似 “qos_class” 进行比较。虽然不需要端点将其本地内存类映射到匹配的平台类，但不建议不匹配，并且可能会产生平台特定的性能相关副作用。显示第一个类 ID。

/sys/bus/cxl/devices/memX/ram/size

在文件 sysfs-bus-cxl 中定义

（只读）以字节为单位的“仅易失性容量”。表示 CXL-2.0 规范中“识别内存设备输出有效负载”中同名的字段。

/sys/bus/cxl/devices/memX/security/sanitize

在文件 sysfs-bus-cxl 中定义

（只写）向此属性写入布尔值 “true” 字符串值，以清理设备以安全地重新利用或停用它。这是通过确保所有用户数据和元数据（无论它们位于持久容量、易失性容量还是 LSA 中）都通过适合媒体类型的任何方式永久不可用来完成的。此功能要求设备处于禁用状态，也就是说，不主动解码任何 HPA 范围。这允许避免显式的全局 CPU 缓存管理，而是依赖于在区域在软件编程状态和硬件提交状态之间转换时完成此操作。如果此文件不存在，则表示没有硬件支持此操作。

什么 /sys/bus/cxl/devices/memX/security/erase （只写）向此属性写入布尔值 “true” 字符串值，通过更改设备所有用户数据区域的媒体加密密钥来安全地擦除用户数据。此功能要求设备处于禁用状态，也就是说，不主动解码任何 HPA 范围。这允许避免显式的全局 CPU 缓存管理，而是依赖于在区域在软件编程状态和硬件提交状态之间转换时完成此操作。如果此文件不存在，则表示没有硬件支持此操作。

/sys/bus/cxl/devices/memX/security/state

在文件 sysfs-bus-cxl 中定义

（只读）读取此文件将显示该设备的 CXL 安全状态。此类状态可以是：“disabled”、“sanitize”（当当前正在进行清理时）；或那些仅适用于持久内存的状态：“locked”、“unlocked” 或 “frozen”。此 sysfs 条目可以从用户空间选择/轮询，以便在清理操作完成时通知。

/sys/bus/cxl/devices/memX/serial

在文件 sysfs-bus-cxl 中定义

（只读）根据 PCIe 设备序列号功能，每个 CXL 设备都有一个 64 位序列号。对于 CXL 设备是强制性的，请参阅 CXL 2.0 8.1.12.2 内存设备 PCIe 功能和扩展功能。

/sys/bus/cxl/devices/memX/trigger_poison_list

在文件 sysfs-bus-cxl 中定义

（只写）当向此属性写入布尔值“true”时，memdev 驱动程序会从设备检索毒化列表。该列表包含被毒化的地址，或者如果被访问将导致毒化的地址，以及毒化的来源。此属性仅对支持该功能的设备可见。当启用 cxl_poison 事件跟踪时，检索到的错误将作为内核事件记录。

/sys/bus/cxl/devices/portX/decoders_committed

在文件 sysfs-bus-cxl 中定义

（只读）当内存设备的任何解码器处于“committed”（已提交）状态时，该内存设备被认为是活动的（请参阅 CXL 3.0 8.2.4.19.7 CXL HDM 解码器 n 控制寄存器）。当设备正在主动解码主机物理地址范围时，热插拔和“sanitize”（清理）等破坏性操作将被阻止。请注意，此数字可能会升高，即使没有任何 regionX 对象处于活动状态或甚至被枚举，这可能是由于平台固件或之前的内核（kexec）建立的解码器造成的。

/sys/bus/cxl/devices/portX/dportY

在文件 sysfs-bus-cxl 中定义

（只读）CXL 端口对象从平台固件设备（ACPI0017 和 ACPI0016）或带有 CXL 组件寄存器的 PCIe 交换机上游端口枚举。 “dportY”符号链接标识一个或多个下游端口，上游端口在其 CXL 内存资源解码中可能针对这些端口。“Y”整数反映了硬件解码器目标列表中使用的硬件端口唯一 ID。

/sys/bus/cxl/devices/portX/uport

在文件 sysfs-bus-cxl 中定义

（只读）CXL 端口对象从平台固件设备（ACPI0017 和 ACPI0016）或带有 CXL 组件寄存器的 PCIe 交换机上游端口枚举。 “uport”符号链接将 CXL portX 对象连接到发布 CXL 端口功能的设备。

/sys/bus/cxl/devices/regionZ/accessY/read_bandwidth

在文件 sysfs-bus-cxl 中定义

（只读）区域的聚合读取或写入带宽。该数字是所有为区域贡献的 CXL 内存设备的累积读取或写入带宽，单位为 MB/s。它与 /sys/devices/system/node/nodeX/accessY/initiators/read_bandwidth 或 /sys/devices/system/node/nodeX/accessY/initiators/write_bandwidth 中出现的数据相同。请参阅stable/sysfs-devices-node。access0 提供到最近启动器的数据，access1 提供到最近 CPU 的数据。

/sys/bus/cxl/devices/regionZ/accessY/read_latency

在文件 sysfs-bus-cxl 中定义

（只读）区域的读取或写入延迟。该数字是所有为区域贡献的 CXL 内存设备的最坏读取或写入延迟，单位为纳秒。它与 /sys/devices/system/node/nodeX/accessY/initiators/read_latency 或 /sys/devices/system/node/nodeX/accessY/initiators/write_latency 中出现的数据相同。请参阅stable/sysfs-devices-node。access0 提供到最近启动器的数据，access1 提供到最近 CPU 的数据。

/sys/bus/cxl/devices/regionZ/commit

在文件 sysfs-bus-cxl 中定义

（读写）向此属性写入布尔值“true”字符串值，以触发区域从软件编程状态转换为硬件中主动解码的状态。除了验证区域是否处于正确的配置状态外，提交操作还验证解码器是否按照规范要求的顺序提交（上次提交的解码器 ID + 1），并检查硬件是否接受提交请求。读取此值表示该区域是否已提交。

/sys/bus/cxl/devices/regionZ/interleave_granularity

在文件 sysfs-bus-cxl 中定义

（读写）设置交错集中每个设备将声明的连续字节数。可能的交错粒度值由 CXL 规范和参与的设备确定。

/sys/bus/cxl/devices/regionZ/interleave_ways

在文件 sysfs-bus-cxl 中定义

（读写）通过写入此值来配置参与区域的设备数量。每个设备将为区域提供 1/interleave_ways 的存储空间。

/sys/bus/cxl/devices/regionZ/mode

在文件 sysfs-bus-cxl 中定义

（只读）区域的模式在区域创建时建立，并决定构成该区域的端点解码器的模式。有关可能模式的更多详细信息，请参阅 /sys/bus/cxl/devices/decoderX.Y/mode

/sys/bus/cxl/devices/regionZ/resource

在文件 sysfs-bus-cxl 中定义

（只读）区域是 CXL 根解码器地址空间的连续分区。区域容量是通过写入 size 属性来分配的，驱动程序确定的最终物理地址空间将在此处反映。因此，在向 size 属性写入值之前读取此属性是没有意义的。

/sys/bus/cxl/devices/regionZ/size

在文件 sysfs-bus-cxl 中定义

（读写）区域要消耗的系统物理地址空间。写入时，会触发驱动程序从父根解码器的地址空间中分配空间。读取时，将报告地址空间的大小，并且应与区域的 resource 属性的范围匹配。大小应在交错配置参数之后设置。一旦设置，就无法更改，只能通过写入 0 来释放。内核不保证数据在地址空间释放事件中得到维护，并且不保证释放后再分配会导致分配相同的地址。

/sys/bus/cxl/devices/regionZ/target[0..N]

在文件 sysfs-bus-cxl 中定义

（读写）将端点解码器对象名称写入“targetX”，其中 X 是端点设备在区域交错中的预期位置，N 是区域的“interleave_ways”设置。如果写入导致无法映射的解码情况，例如端点相对于根解码器交错在该位置不可访问，则返回 ENXIO。如果区域中的位置已被占用，或者区域不处于接受交错配置更改的状态，则返回 EBUSY。如果对象名称不是端点解码器，则返回 EINVAL。成功写入所有位置后，将在激活区域之前执行最终的解码冲突验证。

/sys/bus/cxl/devices/regionZ/uuid

在文件 sysfs-bus-cxl 中定义

（读写）为区域写入唯一标识符。必须为持久区域设置此字段，并且它不得与另一个区域的 UUID 冲突。对于易失性 RAM 区域，此属性是一个只读的空字符串。

/sys/bus/cxl/devices/{port,endpoint}X/parent_dport

在文件 sysfs-bus-cxl 中定义

（只读）为 CXL/PCIe 交换机中的每个上游端口实例化 CXL 端口对象，并为每个端点实例化，以将相应的内存设备映射到 CXL 端口层次结构中。当枚举后代 CXL 端口（交换机或端点）时，了解父 CXL 端口中的哪个“dport”对象路由到此后代非常有用。“parent_dport”符号链接指向代表 CXL 交换机的下游端口的设备，该端口路由到 {port,endpoint}X。

/sys/bus/cxl/flush

在文件 sysfs-bus-cxl 中定义

（只写）如果用户空间手动取消绑定端口，则内核会调度所有后代 memdev 进行取消绑定。向此属性写入“1”会刷新该工作。

/sys/bus/dax/devices/daxX.Y/align

定义在文件 sysfs-bus-dax 中

（读写）提供了一种为 dax 设备指定对齐方式的方法。允许的值受支持 dax 设备的物理地址范围以及体系结构要求约束。

/sys/bus/dax/devices/daxX.Y/mapping

定义在文件 sysfs-bus-dax 中

（只写）提供了一种在 dax 设备下分配映射范围的方法。格式为 <start>-<end>。

/sys/bus/dax/devices/daxX.Y/mapping[0..N]/start

/sys/bus/dax/devices/daxX.Y/mapping[0..N]/end

/sys/bus/dax/devices/daxX.Y/mapping[0..N]/page_offset

定义在文件 sysfs-bus-dax 中

（只读）dax 设备可能具有多个构成的不连续地址范围。这些由不同的“mappingX”子目录表示。“start”属性指示给定范围的起始物理地址。“end”属性指示给定范围的结束物理地址。“page_offset”属性指示 dax 设备中当前范围的偏移量。

/sys/bus/dax/devices/daxX.Y/memmap_on_memory

定义在文件 sysfs-bus-dax 中

（读写）控制 memmap_on_memory 设置，如果 dax 设备要作为系统内存热插拔。这决定了热插拔内存的“altmap”将放置在正在热插拔的设备上 (memmap_on_memory=1)，还是放置在常规内存上 (memmap_on_memory=0)。必须在设备移交给“kmem”驱动程序（即热插拔到 system-ram 中）之前设置此属性。此外，这取决于 CONFIG_MHP_MEMMAP_ON_MEMORY 和为 memory_hotplug 全局启用的 memmap_on_memory 参数。这通常在内核命令行上设置 - memory_hotplug.memmap_on_memory 设置为“true”或“force”。

/sys/bus/dax/devices/daxX.Y/numa_node

定义在文件 sysfs-bus-dax 中

（只读）如果启用了 NUMA 并且平台已为此 dax 设备绑定了支持设备，则发出此设备的 CPU 节点关联。

/sys/bus/dax/devices/daxX.Y/resource

定义在文件 sysfs-bus-dax 中

（只读）resource 属性指示 dax 设备的起始物理地址。对于具有多个构成范围的设备，它指示第一个范围的起始地址。

/sys/bus/dax/devices/daxX.Y/size

定义在文件 sysfs-bus-dax 中

（读写）size 属性指示 dax 设备的总大小。对于创建细分的 dax 设备或调整现有设备的大小，可以将新大小写入此属性，作为重新配置过程的一部分。

/sys/bus/dax/devices/daxX.Y/target_node

定义在文件 sysfs-bus-dax 中

（只读）target-node 属性是 Linux numa 节点，设备 dax 实例在联机时可能会创建该节点。在联机之前，设备的“numa_node”属性反映最近的联机 cpu 节点，这是设备“numa_node”的典型期望。一旦它联机，它就成为自己独特的 numa 节点。

/sys/bus/dfl/devices/dfl_dev.X/feature_id

在文件 sysfs-bus-dfl 中定义

只读。它返回其 DFL FIU 类型本地的功能标识符。

格式：0x%x

/sys/bus/dfl/devices/dfl_dev.X/fec_mode

在文件 sysfs-bus-dfl-devices-n3000-nios 中定义

只读。返回 Nios 固件配置的以太网重定时器的 25G 链路的 FEC 模式。“rs”表示里德-所罗门 FEC，“kr”表示火码 FEC，“no”表示无 FEC。如果不支持 FEC 模式设置，则为“not supported”，当 Nios 固件版本主版本 < 3 时会发生这种情况，或者没有链接配置为 25G。格式：字符串

/sys/bus/dfl/devices/dfl_dev.X/infX_cal_fail

在文件 sysfs-bus-dfl-devices-emif 中定义

只读。它指示此内存接口上的校准是否失败。“1”表示校准失败，“0”表示正常。格式：%u

/sys/bus/dfl/devices/dfl_dev.X/infX_clear

在文件 sysfs-bus-dfl-devices-emif 中定义

只写。向此文件写入“1”将清除此内存接口中的所有内存数据。写入其他值无效。格式：%u

/sys/bus/dfl/devices/dfl_dev.X/infX_init_done

在文件 sysfs-bus-dfl-devices-emif 中定义

只读。它指示此内存接口上的初始化是否完成。“1”表示初始化完成，“0”表示尚未完成。格式：%u

/sys/bus/dfl/devices/dfl_dev.X/nios_fw_version

在文件 sysfs-bus-dfl-devices-n3000-nios 中定义

只读。返回 FPGA 中 Nios 固件的版本。其格式为“major.minor.patch”。格式：%x.%x.%x

/sys/bus/dfl/devices/dfl_dev.X/retimer_A_mode

在文件 sysfs-bus-dfl-devices-n3000-nios 中定义

只读。返回 Nios 固件配置的重定时器 A 的工作模式的枚举值。该值是从 Nios 固件填充的共享寄存器中读取的。现在的值可以是

  • “0”：重置

  • “1”：4x10G

  • “2”：4x25G

  • “3”：2x25G

  • “4”：2x25G+2x10G

  • “5”：1x25G

如果将来更新 Nios 固件以支持更多重定时器模式，则预计会有更多的枚举值。格式：0x%x

/sys/bus/dfl/devices/dfl_dev.X/retimer_B_mode

在文件 sysfs-bus-dfl-devices-n3000-nios 中定义

只读。返回 Nios 固件配置的重定时器 B 的工作模式的枚举值。该值格式与 retimer_A_mode 相同。

/sys/bus/dfl/devices/dfl_dev.X/type

在文件 sysfs-bus-dfl 中定义

只读。它返回设备的 DFL FIU 类型。现在 DFL 支持 2 种 FIU 类型，0 表示 FME，1 表示 PORT。

格式：0x%x

/sys/bus/drivers/corsair/<dev>/current_profile

在文件 sysfs-driver-hid-corsair 中定义

获取/设置当前选定的配置文件。值从 1 到 3。

/sys/bus/drivers/corsair/<dev>/macro_mode

在文件 sysfs-driver-hid-corsair 中定义

获取/设置当前的播放模式。“SW”表示软件模式，在此模式下，G键触发其常规的按键代码。“HW”表示硬件播放模式，在此模式下，G键从板载内存中播放其宏。

/sys/bus/event_source/devices/<dev>/caps

定义在文件 sysfs-bus-event_source-devices-caps 中

属性组，用于描述特定 PMU 公开的功能。此组的每个属性都可以公开特定于 PMU 的信息，例如 pmu_name，以便用户空间可以理解平台特定的 PMU 支持的某些功能。

在支持的平台（如 Intel）中，可用的一个示例功能是 pmu_name，它公开了 PMU 驱动程序已知的底层 CPU 名称。

在 powerpc 中的示例输出：grep . /sys/bus/event_source/devices/cpu/caps/* /sys/bus/event_source/devices/cpu/caps/pmu_name:POWER9

在支持的平台中，“branch_counter_nr”公开了可以在 PERF_SAMPLE_BRANCH_COUNTERS 的 u64 计数器中显示的最大计数器数量，而“branch_counter_width”公开了每个计数器的宽度。 perf 工具可以使用它们来解析每个分支中记录的计数器。

/sys/bus/event_source/devices/<dev>/format

定义在文件 sysfs-bus-event_source-devices-format 中

属性组，用于描述进入特定 PMU 的 perf_event_attr::config[012] 的魔术位。此组的每个属性都定义了我们要导出的“硬件”位掩码，以便用户空间可以处理合理的名称/值对。

用户空间必须为属性定义重叠的位范围的可能性做好准备。例如

attr1 = 'config:0-23'
attr2 = 'config:0-7'
attr3 = 'config:12-35'

示例：‘config1:1,6-10,44’ 定义了 perf_event_attr::config1 的位 1、6-10、44 中包含的属性的内容。

/sys/bus/event_source/devices/<pmu>/events/<event>

定义在文件 sysfs-bus-event_source-devices-events 中

特定于正在运行的系统的每个 PMU 的性能监控事件

“events”目录中的每个文件（除了其中一些带有“.”的文件，“.unit”和“.scale”之外）都描述了 <pmu> 支持的单个性能监控事件。文件名是事件的名称。

由于性能监控事件名称在 perf 工具中不区分大小写，因此 perf 工具仅在 sysfs 中查找小写或大写事件名称，以避免扫描目录。因此，此处事件的名称必须为小写或大写。

文件内容

<term>[=<value>][,<term>[=<value>]]...

其中 <term> 是 /sys/bus/event_source/devices/<pmu>/format/ 下列出的术语之一，<value> 是一个带有 “0x” 前缀的 16 进制格式的数字（仅限小写）。如果单独指定了 <term>（没有赋值），则意味着将 0x1 分配给该 <term>。

示例（这些行中的每一行都在单独的文件中）

event=0x2abc event=0x423,inv,cmask=0x3 domain=0x1,offset=0x8,starting_index=0xffff domain=0x1,offset=0x8,core=?

每个赋值都表示要分配给 perf_event 结构中特定位集的值（由对应于 <term> 的 format 文件定义），该结构被传递给 perf_open 系统调用。

在最后一个示例中，选择特定事件的用户需要提供一个替换“?”的值。这被称为“事件参数化”。事件参数的格式为“param=?”。

/sys/bus/event_source/devices/<pmu>/events/<event>.scale

定义在文件 sysfs-bus-event_source-devices-events 中

Perf 事件缩放因子

一个以科学计数法表示的浮点值字符串，将内核接收到的事件计数乘以该值，以匹配 <event>.unit 文件中指定的单位。

示例

2.3283064365386962890625e-10

这样做是为了避免在内核中执行浮点运算。

/sys/bus/event_source/devices/<pmu>/events/<event>.unit

定义在文件 sysfs-bus-event_source-devices-events 中

Perf 事件单位

一个字符串，指定 <event> (乘以 <event>.scale 后) 所表示的英文复数数值单位。

示例

焦耳

/sys/bus/event_source/devices/dfl_fmeX/cpumask

定义在文件 sysfs-bus-event_source-devices-dfl_fme 中

只读。此文件始终返回 CPU，该 CPU 被绑定以访问所有 fme pmu 性能监控事件。

/sys/bus/event_source/devices/dfl_fmeX/events

定义在文件 sysfs-bus-event_source-devices-dfl_fme 中

只读。属性组，用于描述特定于 fme 的性能监控事件。此组中的每个属性都描述了此 fme pmu 支持的单个性能监控事件。文件名是事件的名称。（请参阅 ABI/testing/sysfs-bus-event_source-devices-events）。

下面列出了所有支持的性能监控事件。

基本事件 (evtype=0x00)

clock = "event=0x00,evtype=0x00,portid=0xff"

缓存事件 (evtype=0x01)

cache_read_hit      = "event=0x00,evtype=0x01,portid=0xff"
cache_read_miss     = "event=0x01,evtype=0x01,portid=0xff"
cache_write_hit     = "event=0x02,evtype=0x01,portid=0xff"
cache_write_miss    = "event=0x03,evtype=0x01,portid=0xff"
cache_hold_request  = "event=0x05,evtype=0x01,portid=0xff"
cache_data_write_port_contention =
                      "event=0x06,evtype=0x01,portid=0xff"
cache_tag_write_port_contention =
                      "event=0x07,evtype=0x01,portid=0xff"
cache_tx_req_stall  = "event=0x08,evtype=0x01,portid=0xff"
cache_rx_req_stall  = "event=0x09,evtype=0x01,portid=0xff"
cache_eviction      = "event=0x0a,evtype=0x01,portid=0xff"

Fabric 事件 (evtype=0x02)

fab_pcie0_read       = "event=0x00,evtype=0x02,portid=0xff"
fab_pcie0_write      = "event=0x01,evtype=0x02,portid=0xff"
fab_pcie1_read       = "event=0x02,evtype=0x02,portid=0xff"
fab_pcie1_write      = "event=0x03,evtype=0x02,portid=0xff"
fab_upi_read         = "event=0x04,evtype=0x02,portid=0xff"
fab_upi_write        = "event=0x05,evtype=0x02,portid=0xff"
fab_mmio_read        = "event=0x06,evtype=0x02,portid=0xff"
fab_mmio_write       = "event=0x07,evtype=0x02,portid=0xff"
fab_port_pcie0_read  = "event=0x00,evtype=0x02,portid=?"
fab_port_pcie0_write = "event=0x01,evtype=0x02,portid=?"
fab_port_pcie1_read  = "event=0x02,evtype=0x02,portid=?"
fab_port_pcie1_write = "event=0x03,evtype=0x02,portid=?"
fab_port_upi_read    = "event=0x04,evtype=0x02,portid=?"
fab_port_upi_write   = "event=0x05,evtype=0x02,portid=?"
fab_port_mmio_read   = "event=0x06,evtype=0x02,portid=?"
fab_port_mmio_write  = "event=0x07,evtype=0x02,portid=?"

VTD 事件 (evtype=0x03)

vtd_port_read_transaction  = "event=0x00,evtype=0x03,portid=?"
vtd_port_write_transaction = "event=0x01,evtype=0x03,portid=?"
vtd_port_devtlb_read_hit   = "event=0x02,evtype=0x03,portid=?"
vtd_port_devtlb_write_hit  = "event=0x03,evtype=0x03,portid=?"
vtd_port_devtlb_4k_fill    = "event=0x04,evtype=0x03,portid=?"
vtd_port_devtlb_2m_fill    = "event=0x05,evtype=0x03,portid=?"
vtd_port_devtlb_1g_fill    = "event=0x06,evtype=0x03,portid=?"

VTD SIP 事件 (evtype=0x04)

vtd_sip_iotlb_4k_hit  = "event=0x00,evtype=0x04,portid=0xff"
vtd_sip_iotlb_2m_hit  = "event=0x01,evtype=0x04,portid=0xff"
vtd_sip_iotlb_1g_hit  = "event=0x02,evtype=0x04,portid=0xff"
vtd_sip_slpwc_l3_hit  = "event=0x03,evtype=0x04,portid=0xff"
vtd_sip_slpwc_l4_hit  = "event=0x04,evtype=0x04,portid=0xff"
vtd_sip_rcc_hit       = "event=0x05,evtype=0x04,portid=0xff"
vtd_sip_iotlb_4k_miss = "event=0x06,evtype=0x04,portid=0xff"
vtd_sip_iotlb_2m_miss = "event=0x07,evtype=0x04,portid=0xff"
vtd_sip_iotlb_1g_miss = "event=0x08,evtype=0x04,portid=0xff"
vtd_sip_slpwc_l3_miss = "event=0x09,evtype=0x04,portid=0xff"
vtd_sip_slpwc_l4_miss = "event=0x0a,evtype=0x04,portid=0xff"
vtd_sip_rcc_miss      = "event=0x0b,evtype=0x04,portid=0xff"

/sys/bus/event_source/devices/dfl_fmeX/format

定义在文件 sysfs-bus-event_source-devices-dfl_fme 中

只读。属性组，用于描述进入特定 PMU 的 perf_event_attr.config 的魔术位。（请参阅 ABI/testing/sysfs-bus-event_source-devices-format）。

此组下的每个属性都定义了 perf_event_attr.config 的一个位范围。下面列出了所有支持的属性

event  = "config:0-11"  - event ID
evtype = "config:12-15" - event type
portid = "config:16-23" - event source

例如

fab_mmio_read = "event=0x06,evtype=0x02,portid=0xff"

它显示此 fab_mmio_read 是 fabric 类型 (0x02) 事件，具有 0x06 的本地事件 ID，用于整体监控 (portid=0xff)。

/sys/bus/event_source/devices/dmar*/cpumask

定义在文件 sysfs-bus-event_source-devices-iommu 中

只读。此文件始终返回 CPU，该 CPU 被绑定以访问所有 IOMMU pmu 性能监控事件。

/sys/bus/event_source/devices/dmar*/format

定义在文件 sysfs-bus-event_source-devices-iommu 中

只读。属性组，用于描述进入 IOMMU pmu 的 perf_event_attr.config、perf_event_attr.config1 或 perf_event_attr.config2 的魔术位。（另请参阅 ABI/testing/sysfs-bus-event_source-devices-format）。

此组中的每个属性都在 perf_event_attr.config、perf_event_attr.config1 或 perf_event_attr.config2 中定义一个位范围。下面列出了所有支持的属性（有关可能的属性值，请参阅 VT-d 规范 4.0）

event               = "config:0-27"   - event ID
event_group         = "config:28-31"  - event group ID

filter_requester_en = "config1:0"     - Enable Requester ID filter
filter_domain_en    = "config1:1"     - Enable Domain ID filter
filter_pasid_en     = "config1:2"     - Enable PASID filter
filter_ats_en       = "config1:3"     - Enable Address Type filter
filter_page_table_en= "config1:4"     - Enable Page Table Level filter
filter_requester_id = "config1:16-31" - Requester ID filter
filter_domain       = "config1:32-47" - Domain ID filter
filter_pasid        = "config2:0-21"  - PASID filter
filter_ats          = "config2:24-28" - Address Type filter
filter_page_table   = "config2:32-36" - Page Table Level filter

/sys/bus/event_source/devices/dsa*/cpumask

定义在文件 sysfs-bus-event_source-devices-dsa 中

只读。此文件始终返回 CPU，该 CPU 被绑定以访问所有 dsa pmu 性能监控事件。

/sys/bus/event_source/devices/dsa*/format

定义在文件 sysfs-bus-event_source-devices-dsa 中

只读。属性组，用于描述进入 IDXD DSA pmu 的 perf_event_attr.config 或 perf_event_attr.config1 的魔术位。（另请参阅 ABI/testing/sysfs-bus-event_source-devices-format）。

此组中的每个属性都在 perf_event_attr.config 或 perf_event_attr.config1 中定义一个位范围。下面列出了所有支持的属性（有关可能的属性值，请参阅 IDXD DSA 规范）

event_category = "config:0-3"    - event category
event          = "config:4-31"   - event ID

filter_wq      = "config1:0-31"  - workqueue filter
filter_tc      = "config1:32-39" - traffic class filter
filter_pgsz    = "config1:40-43" - page size filter
filter_sz      = "config1:44-51" - transfer size filter
filter_eng     = "config1:52-59" - engine filter

/sys/bus/event_source/devices/hisi_ptt<sicl_id>_<core_id>/tune

定义在文件 sysfs-bus-event_source-devices-hisi_ptt 中

此目录包含用于调整 PCIe 链路参数（事件）的文件。每个文件都以 PCIe 链路的事件命名。

有关更多信息，请参阅 海思 PCIe 调优和跟踪设备。

/sys/bus/event_source/devices/hisi_ptt<sicl_id>_<core_id>/tune/qos_tx_cpl

定义在文件 sysfs-bus-event_source-devices-hisi_ptt 中

(读/写) 控制 Tx 完成 TLP 的权重，这会影响 PCIe 链路上的出站完成 TLP 的比例。可用的调优数据为 [0, 1, 2]。写入负值将返回错误，超出范围的值将转换为 2。该值表示事件的可能级别。

/sys/bus/event_source/devices/hisi_ptt<sicl_id>_<core_id>/tune/qos_tx_np

定义在文件 sysfs-bus-event_source-devices-hisi_ptt 中

(读/写) 控制 Tx 非 posted TLP 的权重，这会影响 PCIe 链路上的出站非 posted TLP 的比例。可用的调优数据为 [0, 1, 2]。写入负值将返回错误，超出范围的值将转换为 2。该值表示事件的可能级别。

/sys/bus/event_source/devices/hisi_ptt<sicl_id>_<core_id>/tune/qos_tx_p

定义在文件 sysfs-bus-event_source-devices-hisi_ptt 中

(读/写) 控制 Tx posted TLP 的权重，这会影响 PCIe 链路上的出站 posted TLP 的比例。可用的调优数据为 [0, 1, 2]。写入负值将返回错误，超出范围的值将转换为 2。该值表示事件的可能级别。

/sys/bus/event_source/devices/hisi_ptt<sicl_id>_<core_id>/tune/rx_alloc_buf_level

定义在文件 sysfs-bus-event_source-devices-hisi_ptt 中

(读/写) 控制入站数据包的分配缓冲区水位。数据包将首先存储在缓冲区中，然后在水位达到或超时时传输。可用的调优数据为 [0, 1, 2]。写入负值将返回错误，超出范围的值将转换为 2。该值表示事件的可能级别。

/sys/bus/event_source/devices/hisi_ptt<sicl_id>_<core_id>/tune/tx_alloc_buf_level

定义在文件 sysfs-bus-event_source-devices-hisi_ptt 中

(读/写) 控制出站数据包的分配缓冲区水位。数据包将首先存储在缓冲区中，然后在水位达到或超时时传输。可用的调优数据为 [0, 1, 2]。写入负值将返回错误，超出范围的值将转换为 2。该值表示事件的可能级别。

/sys/bus/event_source/devices/hv_24x7/event_descs/<event-name>

定义在文件 sysfs-bus-event_source-devices-hv_24x7 中

提供固件提供的特定事件的描述。如果固件没有提供描述，则不会创建文件。

请注意，event-name 缺少 events/ 目录中事件附加的域后缀。

/sys/bus/event_source/devices/hv_24x7/event_long_descs/<event-name>

定义在文件 sysfs-bus-event_source-devices-hv_24x7 中

提供固件提供的特定事件的“长”描述。如果固件没有提供描述，则不会创建文件。

请注意，event-name 缺少 events/ 目录中事件附加的域后缀。

/sys/bus/event_source/devices/hv_24x7/format

定义在文件 sysfs-bus-event_source-devices-hv_24x7 中

只读。属性组，用于描述进入特定 PMU 的 perf_event_attr.config 的魔术位。（请参阅 ABI/testing/sysfs-bus-event_source-devices-format）。

此组下的每个属性都定义了 perf_event_attr.config 的一个位范围。下面列出了所有支持的属性

chip = "config:16-31"
core  = "config:16-31"
domain = "config:0-3"
lpar = "config:0-15"
offset = "config:32-63"
vcpu = "config:16-31"

例如

PM_PB_CYC =  "domain=1,offset=0x80,chip=?,lpar=0x0"

在此事件中，芯片后的 “?” 指定此值将在运行此事件时由用户提供。

/sys/bus/event_source/devices/hv_24x7/interface/catalog

定义在文件 sysfs-bus-event_source-devices-hv_24x7 中

提供对 POWER7 和 8 系统上虚拟机监控程序提供的二进制 “24x7 目录” 的访问。此目录列出了 powerpc “hv_24x7” pmu 可用的事件。其格式在此处记录：https://raw.githubusercontent.com/jmesmon/catalog-24x7/master/hv-24x7-catalog.h

/sys/bus/event_source/devices/hv_24x7/interface/catalog_length

定义在文件 sysfs-bus-event_source-devices-hv_24x7 中

一个等于目录长度（以字节为单位）的数字。也可以从提供的二进制 “catalog” sysfs 条目中提取此值。

/sys/bus/event_source/devices/hv_24x7/interface/catalog_version

定义在文件 sysfs-bus-event_source-devices-hv_24x7 中

公开 24x7 目录的 “版本” 字段。也可以从提供的二进制 “catalog” sysfs 条目中提取此值。

/sys/bus/event_source/devices/hv_gpci/format

定义在文件 sysfs-bus-event_source-devices-hv_gpci 中

只读。属性组，用于描述进入特定 PMU 的 perf_event_attr.config 的魔术位。（请参阅 ABI/testing/sysfs-bus-event_source-devices-format）。

此组下的每个属性都定义了 perf_event_attr.config 的一个位范围。下面列出了所有支持的属性

counter_info_version  = "config:16-23"
length  = "config:24-31"
partition_id  = "config:32-63"
request = "config:0-31"
sibling_part_id = "config:32-63"
hw_chip_id = "config:32-63"
offset = "config:32-63"
phys_processor_idx = "config:32-63"
secondary_index = "config:0-15"
starting_index = "config:32-63"

例如

processor_core_utilization_instructions_completed = "request=0x94,
                      phys_processor_idx=?,counter_info_version=0x8,
                      length=8,offset=0x18"

在此事件中，phys_processor_idx 后的“？”表示该值将在运行此事件时由用户提供。

/sys/bus/event_source/devices/hv_gpci/interface/collect_privileged

定义在文件 sysfs-bus-event_source-devices-hv_gpci 中

如果虚拟机管理程序配置为禁止访问其他访客累积的事件计数器以及物理域事件计数器，则为“0”。

如果允许该访问，则为“1”。

/sys/bus/event_source/devices/hv_gpci/interface/expanded

定义在文件 sysfs-bus-event_source-devices-hv_gpci 中

0 或 1。表示我们是否有权访问“EXPANDED”事件（在 arch/powerpc/perf/hv-gpci.h 中列出）。

/sys/bus/event_source/devices/hv_gpci/interface/ga

定义在文件 sysfs-bus-event_source-devices-hv_gpci 中

0 或 1。表示我们是否有权访问“GA”事件（在 arch/powerpc/perf/hv-gpci.h 中列出）。

/sys/bus/event_source/devices/hv_gpci/interface/kernel_version

定义在文件 sysfs-bus-event_source-devices-hv_gpci 中

一个数字，表示内核所知的 gpci 接口的最新版本。

/sys/bus/event_source/devices/hv_gpci/interface/lab

定义在文件 sysfs-bus-event_source-devices-hv_gpci 中

0 或 1。表示我们是否有权访问“LAB”事件（在 arch/powerpc/perf/hv-gpci.h 中列出）。

/sys/bus/event_source/devices/hv_gpci/interface/version

定义在文件 sysfs-bus-event_source-devices-hv_gpci 中

一个数字，表示虚拟机管理程序报告支持的 gpci 接口版本。

/sys/bus/event_source/devices/nmemX/cpumask

在文件 sysfs-bus-nvdimm 中定义

（只读）此 sysfs 文件公开了用于检索 nvdimm pmu 事件计数器数据的 cpumask。

/sys/bus/event_source/devices/nmemX/events

在文件 sysfs-bus-nvdimm 中定义

（只读）用于描述 nvdimm 内存设备的性能监控事件的属性组。此组中的每个属性都描述了此 nvdimm pmu 支持的单个性能监控事件。该文件的名称是事件的名称。（请参阅 ABI/testing/sysfs-bus-event_source-devices-events）。给定 nvdimm 提供程序类型支持的事件列表可以在 Documentation/driver-api/nvdimm/$provider 中找到。

/sys/bus/event_source/devices/nmemX/format

在文件 sysfs-bus-nvdimm 中定义

（只读）用于描述特定 pmu 的 perf_event_attr.config 中使用的魔术位的属性组。（请参阅 ABI/testing/sysfs-bus-event_source-devices-format）。

此组下的每个属性都定义了 perf_event_attr.config 的一个位范围。下面列出了支持的属性

event  = "config:0-4"  - event ID

例如

ctl_res_cnt = "event=0x1"

/sys/bus/event_source/devices/uncore_*/alias

在文件 sysfs-bus-event_source-devices-uncore 中定义

只读。用于描述某些平台上是否存在别名的 uncore PMU 的别名属性。'perf(1)' 工具应将两个名称视为相同。它们都可用于访问 uncore PMU。

示例

$ cat /sys/devices/uncore_cha_2/alias uncore_type_0_2

/sys/bus/event_source/devices/vpa_pmu/events

在文件 sysfs-bus-event_source-devices-vpa-pmu 中定义

只读。用于描述虚拟处理器区域事件的性能监控事件的属性组。此组中的每个属性都描述了 vpa_pmu 支持的单个性能监控事件。该文件的名称是事件的名称（请参阅 ABI/testing/sysfs-bus-event_source-devices-events）。

/sys/bus/event_source/devices/vpa_pmu/format

在文件 sysfs-bus-event_source-devices-vpa-pmu 中定义

只读。属性组，用于描述进入特定 PMU 的 perf_event_attr.config 的魔术位。（请参阅 ABI/testing/sysfs-bus-event_source-devices-format）。

此组下的每个属性都定义了 perf_event_attr.config 的一个位范围。下面列出了支持的属性

event = "config:0-31" - event ID

例如

l1_to_l2_lat = "event=0x1"

/sys/bus/fcoe/

在文件 sysfs-bus-fcoe 中定义

FCoE 总线。此目录中的属性是控制接口。

属性

ctlr_create

“FCoE 控制器”实例创建接口。将 <ifname> 写入此文件将分配并使用 fcoe_ctlr_device (ctlr_X) 填充 sysfs。然后，用户可以配置任何每端口设置，并最终写入 fcoe_ctlr_device 的“start”属性，以开始内核的发现和登录过程。

ctlr_destroy

“FCoE 控制器”实例删除接口。将 fcoe_ctlr_device 的 sysfs 名称写入此文件将使 fcoe_ctlr_device 从结构或以其他方式连接的 FCoE 设备注销。它还将释放为此 fcoe_ctlr_device 分配的所有内核内存以及与之关联的任何结构，包括 scsi_host。

/sys/bus/fcoe/devices/ctlr_X

在文件 sysfs-bus-fcoe 中定义

fcoe 总线上的“FCoE 控制器”实例。FCoE 控制器现在有一个三阶段的创建过程。1) 将接口名称写入 ctlr_create 2) 配置 FCoE 控制器 (ctlr_X) 3) 启用 FCoE 控制器以开始发现和登录。通过将其名称（即 ctlr_X）写入 ctlr_delete 文件来销毁 FCoE 控制器。

属性

fcf_dev_loss_tmo

设备丢失超时时间段（请参见下文）。更改此值将更改此控制器发现的所有 FCF 的 dev_loss_tmo。

mode

显示或更改 FCoE 控制器的模式。可能的模式是“Fabric”和“VN2VN”。如果 FCoE 控制器以“Fabric”模式启动，则会启动 FIP FCF 发现，并最终尝试结构登录。如果 FCoE 控制器以“VN2VN”模式启动，则会执行 FIP VN2VN 发现和登录。FCoE 控制器一次仅支持一种模式。

enabled

FCoE 控制器是否启用或禁用。如果禁用，则为 0，如果启用，则为 1。将 0 或 1 写入此文件将启用或禁用 FCoE 控制器。

lesb/link_fail

链路错误状态块 (LESB) 链路故障计数。

lesb/vlink_fail

链路错误状态块 (LESB) 虚拟链路故障计数。

lesb/miss_fka

链路错误状态块 (LESB) 错过的 FCoE 初始化协议 (FIP) 保持活动 (FKA)。

lesb/symb_err

链路错误状态块 (LESB) 符号错误计数。

lesb/err_block

链路错误状态块 (LESB) 块错误计数。

lesb/fcs_error

链路错误状态块 (LESB) 光纤通道服务错误计数。

注意：ctlr_X（从 0 开始的全局增量）

/sys/bus/fcoe/devices/fcf_X

在文件 sysfs-bus-fcoe 中定义

fcoe 总线上的“FCoE FCF”实例。FCF 是一个光纤通道转发器，它是一个 FCoE 交换机，可以接受 FCoE（以太网）数据包，解压它们，并将嵌入的光纤通道帧转发到 FC 结构中。它还可以获取出站 FC 帧并将其打包在以太网数据包中，以发送到以太网段上的目标。

属性

fabric_name

标识 FCF 服务的结构。

switch_name

标识 FCF。

priority

同一结构上其他 FCF 中交换机的优先级。

selected

1 表示该交换机已被选中使用；0 表示该交换机将不被使用。

fc_map

光纤通道 MAP

vfid

虚拟结构 ID

mac

FCF 的 MAC 地址

fka_period

FIP 保持活动时间段

fabric_state：内部内核状态

  • “未知” - 初始化值

  • “已断开连接” - 没有到 FCF/结构的链路

  • “已连接” - 主机已连接到 FCF

  • “已删除” - 正在从系统中删除 FCF

dev_loss_tmo：此 FCF 的设备丢失超时时间段。

注意：类似于 FC 传输的设备丢失基础设施

存在于 fcoe_sysfs 中。最好有它，以便链路不稳定的适配器不会不断推进用于识别已发现 FCF 的计数。FCF 将处于“已断开连接”状态，直到计时器过期且 FCF 变为“已删除”，或者重新发现 FCF 并变为“已连接”。

用户：此接口的第一个用户将是 fcoeadm 应用程序，该应用程序通常打包在 fcoe-utils 包中。

/sys/bus/fsi/devices/XX.XX.00:06/sbefifoX/timeout

在文件 sysfs-bus-fsi-devices-sbefifo 中定义

指示此 SBE 设备是否已超时；即 SBE 未在驱动程序分配的时间内响应。值为 1 表示已发生超时，并且自超时以来没有完成任何传输。值为 0 表示未发生超时，或者如果发生超时，则最近的传输已成功完成。

/sys/bus/fsl-mc/drivers/.../bind

在文件 sysfs-bus-fsl-mc 中定义

将设备位置写入此文件将导致驱动程序尝试绑定到在此位置找到的设备。位置的格式为 Object.Id，与 /sys/bus/fsl-mc/devices/ 中找到的格式相同。

例如

# echo dpni.2 > /sys/bus/fsl-mc/drivers/fsl_dpaa2_eth/bind

/sys/bus/fsl-mc/drivers/.../unbind

在文件 sysfs-bus-fsl-mc 中定义

将设备位置写入此文件将导致驱动程序尝试从此位置找到的设备解除绑定。位置的格式为 Object.Id，与 /sys/bus/fsl-mc/devices/ 中找到的格式相同。

例如

# echo dpni.2 > /sys/bus/fsl-mc/drivers/fsl_dpaa2_eth/unbind

/sys/bus/hid/devices/<bus>:<vid>:<pid>.<n>/speed

在文件 sysfs-driver-wacom 中定义

/sys/bus/hid/devices/<bus>:<vid>:<pid>.<n>/speed 文件控制 Wacom 蓝牙平板电脑的报告速度。从该文件读取会返回 1，如果平板电脑以高速模式报告，否则返回 0。将这些值之一写入此文件会切换报告速度。

/sys/bus/hid/devices/<bus>:<vid>:<pid>.<n>/wacom_led/button<n>_rawimg

在文件 sysfs-driver-wacom 中定义

当将 Wacom Intuos 4 交错格式的 1024 字节原始图像写入该文件时，该图像将显示在设备的按钮 N 上。该图像是 64x32 像素的 4 位灰度图像。1024 字节的二进制文件被分成 16x 64 字节的块。每个 64 字节的块对显示器上两个连续行的图像数据进行编码。每个字节的低半字节包含第一行，而高半字节包含第二行。当 Wacom Intuos 4 通过蓝牙连接时，该图像必须包含 256 字节（64x32 像素 1 位颜色）。格式也是混乱的，就像在 USB 模式中一样，可以通过转换来概括

76543210 into GECA6420.
HGFEDCBA      HFDB7531

/sys/bus/hid/devices/<bus>:<vid>:<pid>.<n>/wacom_led/buttons_luminance

在文件 sysfs-driver-wacom 中定义

写入此文件会设置所有八个按钮 OLED 显示屏的整体亮度级别 (0..15)。

/sys/bus/hid/devices/<bus>:<vid>:<pid>.<n>/wacom_led/led

在文件 sysfs-driver-wacom 中定义

用于控制状态 LED 和 OLED 的属性组。此属性组仅适用于 Intuos 4 M、L 和 XL（带有 LED 和 OLED）、Intuos 4 WL、Intuos 5（仅 LED）、Intuos Pro（仅 LED）以及 Cintiq 21UX2 和 Cintiq 24HD（仅 LED）。因此，它的存在隐含地表示平板电脑设备上存在所述 LED 和 OLED。

/sys/bus/hid/devices/<bus>:<vid>:<pid>.<n>/wacom_led/status0_luminance

在文件 sysfs-driver-wacom 中定义

<现在由驱动程序导出的 LED 类 API 废弃> 当触控笔未接触平板电脑表面并且触控笔上未按下任何按钮时，写入此文件会设置状态 LED 亮度 (1..127)。此亮度级别通常低于按下按钮时的亮度级别。

/sys/bus/hid/devices/<bus>:<vid>:<pid>.<n>/wacom_led/status1_luminance

在文件 sysfs-driver-wacom 中定义

<现在由驱动程序导出的 LED 类 API 废弃> 当触控笔接触平板电脑表面或在触控笔上按下任何按钮时，写入此文件会设置状态 LED 亮度 (1..127)。

/sys/bus/hid/devices/<bus>:<vid>:<pid>.<n>/wacom_led/status_led0_select

在文件 sysfs-driver-wacom 中定义

<现在由驱动程序导出的 LED 类 API 废弃> 写入此文件会设置四个（对于 Intuos 4 和 Intuos 5）或右四个（对于 Cintiq 21UX2 和 Cintiq 24HD）状态 LED 中的哪一个处于活动状态 (0..3)。同一侧的其他三个 LED 始终处于非活动状态。

/sys/bus/hid/devices/<bus>:<vid>:<pid>.<n>/wacom_led/status_led1_select

在文件 sysfs-driver-wacom 中定义

<现在由驱动程序导出的 LED 类 API 废弃> 写入此文件会设置左侧四个（对于 Cintiq 21UX2 和 Cintiq 24HD）状态 LED 中的哪一个处于活动状态 (0..3)。左侧的其他三个 LED 始终处于非活动状态。

/sys/bus/hid/devices/<bus>:<vid>:<pid>.<n>/wacom_remote/<serial_number>/remote_mode

在文件 sysfs-driver-wacom 中定义

<现已被驱动程序导出的 LED 类 API 所取代> 读取此文件会报告设备上 LED 灯指示的遥控器模式状态。如果未收到配对设备的报告，则读取此文件将报告“ -1”。 该模式是只读的，无法通过驱动程序设置。

/sys/bus/hid/devices/<总线>:<vid>:<pid>.<n>/wacom_remote/unpair_remote

在文件 sysfs-driver-wacom 中定义

向此文件写入字符序列“*”后跟换行符将删除设备上的所有当前配对。其他字符序列保留。此文件是只写的。

/sys/bus/hid/drivers/hid-corsair-void/<设备>/fw_version_headset

在文件 sysfs-driver-hid-corsair-void 中定义

  1. 耳机的固件版本

    • 如果没有报告版本，则返回 -ENODATA

/sys/bus/hid/drivers/hid-corsair-void/<设备>/fw_version_receiver

在文件 sysfs-driver-hid-corsair-void 中定义

  1. 接收器的固件版本

/sys/bus/hid/drivers/hid-corsair-void/<设备>/microphone_up

在文件 sysfs-driver-hid-corsair-void 中定义

  1. 获取麦克风的物理位置

    • 1 -> 麦克风向上

    • 0 -> 麦克风向下

/sys/bus/hid/drivers/hid-corsair-void/<设备>/send_alert

在文件 sysfs-driver-hid-corsair-void 中定义

  1. 播放耳机内置的通知 (0 / 1)

/sys/bus/hid/drivers/hid-corsair-void/<设备>/set_sidetone

在文件 sysfs-driver-hid-corsair-void 中定义

  1. 设置侧音音量 (0 - sidetone_max)

/sys/bus/hid/drivers/hid-corsair-void/<设备>/sidetone_max

在文件 sysfs-driver-hid-corsair-void 中定义

  1. 报告最大侧音音量

/sys/bus/hid/drivers/logitech-hidpp-device/<设备>/builtin_power_supply

在文件 sysfs-driver-hid-logitech-hidpp 中定义

此文件的存在表明 HID++ 驱动程序能够处理内核中的电池属性。这样，upower 可以添加一个 udev 规则来决定是否应使用内部统一支持或通用内核支持。

/sys/bus/hid/drivers/logitech-hidpp-device/<设备>/range

在文件 sysfs-driver-hid-logitech-hidpp 中定义

(读写) 此属性控制 Logitech G920 方向盘允许的“转动”量。从文件中读取会显示方向盘的当前范围。写入最小值和最大值边界内的值会设置方向盘的范围。

/sys/bus/hid/drivers/logitech/<设备>/alternate_modes

在文件 sysfs-driver-hid-logitech-lg4ff 中定义

显示方向盘支持的一组备用模式。每个模式列出如下

标签：模式名称

当前活动模式用星号标记。列表还包含一个抽象项“native”，它始终表示方向盘的本机模式。回显模式标签会将方向盘切换到相应的模式。根据方向盘的确切型号，并非所有列出的模式都始终可以选择。如果无法将方向盘切换到所需的模式，则会返回 -EINVAL，并在内核日志中附带解释性消息。此条目不会为只有一个模式的设备创建。

当前支持的模式切换

Driving Force Pro

DF-EX --> DFP

G25

DF-EX --> DFP --> G25

G27

DF-EX <*> DFP <-> G25 <-> G27
DF-EX <*--------> G25 <-> G27
DF-EX <*----------------> G27

G29

DF-EX <*> DFP <-> G25 <-> G27 <-> G29
DF-EX <*--------> G25 <-> G27 <-> G29
DF-EX <*----------------> G27 <-> G29
DF-EX <*------------------------> G29

DFGT

DF-EX <*> DFP <-> DFGT
DF-EX <*--------> DFGT

  • 必须加载 hid_logitech 模块并设置 lg4ff_no_autoswitch=1 参数，DF-EX 模式的切换才能工作。

/sys/bus/hid/drivers/logitech/<设备>/combine_pedals

在文件 sysfs-driver-hid-logitech-lg4ff 中定义

控制是否在控制器的 Y 轴上报告油门和刹车的组合值。对于无法使用单独的油门/刹车轴的旧游戏很有用。默认情况下关闭（“0”），通过设置“1”启用。

/sys/bus/hid/drivers/logitech/<设备>/range

在文件 sysfs-driver-hid-logitech-lg4ff 中定义

显示方向盘的最小、最大和当前范围。写入最小值和最大值边界内的值会设置方向盘的范围。

/sys/bus/hid/drivers/logitech/<设备>/real_id

在文件 sysfs-driver-hid-logitech-lg4ff 中定义

显示方向盘的真实型号，而不管方向盘可能切换到的任何备用模式。这是一个只读值。此条目不会为只有一个模式的设备创建。

/sys/bus/hid/drivers/ntrig/<设备>/activate_slack

在文件 sysfs-driver-hid-ntrig 中定义

(读写) 在确认活动开始（激活触摸）之前忽略的接触帧数。

/sys/bus/hid/drivers/ntrig/<设备>/activation_width

/sys/bus/hid/drivers/ntrig/<设备>/activation_height

在文件 sysfs-driver-hid-ntrig 中定义

覆盖激活延迟的阈值。

activation_width

(读写) 立即开始处理触摸事件的宽度阈值。

activation_height

(读写) 立即开始处理触摸事件的高度阈值。

/sys/bus/hid/drivers/ntrig/<设备>/decativate_slack

在文件 sysfs-driver-hid-ntrig 中定义

(读写) 在确认活动结束（停用触摸）之前忽略的空（无接触）帧数。

当最后一个手指从设备上移除时，它会发送多个空帧。通过延迟停用几帧，可以容忍错误的断开连接，在这种情况下，传感器可能会错误地检测不到仍然存在的手指。

/sys/bus/hid/drivers/ntrig/<设备>/min_width

/sys/bus/hid/drivers/ntrig/<设备>/min_height

在文件 sysfs-driver-hid-ntrig 中定义

接受的最小尺寸接触。

min_width

(读写) 决定激活和活动的最小触摸接触宽度。

min_height

(读写) 决定激活和活动的最小触摸接触高度。

/sys/bus/hid/drivers/ntrig/<设备>/sensor_logical_width

/sys/bus/hid/drivers/ntrig/<设备>/sensor_logical_height

在文件 sysfs-driver-hid-ntrig 中定义

(只读) 活动期间报告的位置范围。

/sys/bus/hid/drivers/ntrig/<设备>/sensor_physical_width

/sys/bus/hid/drivers/ntrig/<设备>/sensor_physical_height

在文件 sysfs-driver-hid-ntrig 中定义

(只读) 这些是内部范围，不用于正常事件，但对调整很有用。

/sys/bus/hid/drivers/prodikeys/.../channel

在文件 sysfs-driver-hid-prodikeys 中定义

允许（通过软件）控制 PC-midi 键盘将输出 midi 数据的 midi 通道。范围：0..15 类型：读/写

/sys/bus/hid/drivers/prodikeys/.../octave

在文件 sysfs-driver-hid-prodikeys 中定义

控制 PC-midi 驱动程序中的八度音阶移位修饰符。八度音阶可以通过软件向上/向下移动 2 个八度音阶。0 表示没有八度音阶移位。范围：-2..2（负 2 到正 2）类型：读/写

/sys/bus/hid/drivers/prodikeys/.../sustain

在文件 sysfs-driver-hid-prodikeys 中定义

允许（通过软件）控制 PC-midi 驱动程序保持的音符的延音持续时间。0 表示禁用延音模式。范围：0..5000（毫秒）类型：读/写

/sys/bus/hid/drivers/wiimote/<设备>/bboard_calib

在文件 sysfs-driver-hid-wiimote 中定义

仅当设备被检测为平衡板时才提供此属性。它为所有 4 个传感器提供一行 3 个校准值。这些值用冒号分隔，每个值长 2 个字节（编码为 4 位十六进制值）。首先，写入所有 4 个传感器的 0kg 值，然后写入所有 4 个传感器的 17kg 值，最后写入所有 4 个传感器的 34kg 值。

校准数据已由内核应用于所有输入值，但用户空间可以使用它来执行其他转换。

/sys/bus/hid/drivers/wiimote/<设备>/devtype

在文件 sysfs-driver-hid-wiimote 中定义

当 wiimote 驱动程序初始化设备时，我们会执行设备检测并在完成后发出“change” uevent。此文件显示检测到的设备类型。“pending”表示检测仍在进行中，“unknown”表示无法检测或加载设备。“generic”表示无法检测到设备，但支持基本的 Wii Remote 功能，并且可以使用。每个设备类型的其他字符串可用，如果添加新的特定于设备的检测，则可以添加。当前支持的有

gen10

第一代 Wii Remote

gen20

第二代 Wii Remote Plus（内置 MP）

balanceboard

Wii 平衡板

/sys/bus/hid/drivers/wiimote/<设备>/extension

在文件 sysfs-driver-hid-wiimote 中定义

此文件包含当前连接和初始化的扩展。它可以是以下之一：none、motionp、nunchuck、classic、motionp+nunchuck、motionp+classic motionp 是官方的 Nintendo Motion+ 扩展，nunchuck 是官方的 Nintendo Nunchuck 扩展，classic 是 Nintendo Classic Controller 扩展。motionp 扩展可以与其他两个扩展组合使用。

从内核版本 3.11 开始，支持 Motion Plus 热插拔，如果检测到，它不再作为静态扩展报告。然后，您将收到 motion-plus 设备的 uevent 通知。

/sys/bus/hid/drivers/wiimote/<设备>/led1

/sys/bus/hid/drivers/wiimote/<设备>/led2

/sys/bus/hid/drivers/wiimote/<设备>/led3

/sys/bus/hid/drivers/wiimote/<设备>/led4

在文件 sysfs-driver-hid-wiimote 中定义

使设置/获取当前 led 状态成为可能。从中读取如果 led 关闭则返回 0，如果 led 打开则返回 1。向其写入 0 会禁用 led，写入 1 会启用 led。

/sys/bus/hid/drivers/wiimote/<设备>/pro_calib

在文件 sysfs-driver-hid-wiimote 中定义

仅当设备被检测为 Pro 控制器时才提供此属性。它为所有 4 个模拟摇杆提供一行 4 个校准值。格式为：“x1:y1 x2:y2”。数据以 +/- 开头。每个值都是一个带符号的 16 位数字。数据编码为十进制数，并指定 Pro 控制器的模拟摇杆的偏移量。

校准数据已由内核应用于所有输入值，但用户空间可以使用它来执行其他转换。

校准数据由内核在设备设置期间检测到。您可以将“scann”写入此文件以重新触发校准。您也可以直接以“x1:y1 x2:y2”的形式写入数据以手动设置校准值。

/sys/bus/hsi

在文件 sysfs-bus-hsi 中定义

高速同步串行接口 (HSI) 是一种串行接口，主要用于在蜂窝手机中将应用程序引擎 (APE) 与蜂窝调制解调器引擎 (CMT) 连接。总线将填充代表系统中可用协议的设备（hsi_clients）。总线驱动程序实现这些协议。

/sys/bus/hsi/devices/.../modalias

在文件 sysfs-bus-hsi 中定义

存储 uevent 发出的相同 MODALIAS 值 格式：hsi:<hsi_client 设备名称>

/sys/bus/i2c/.../idle_state

在文件 sysfs-bus-i2c-devices-pca954x 中定义

仅对于可写入以控制空闲时多路复用器行为的多路复用器设备存在的值。可能的值

-2

空闲时断开连接，即取消选择上次使用的通道，当存在一个地址与同一父总线上另一个多路复用器上的另一个设备冲突的设备时，这很有用。

-1

保持多路复用器原样，这是 I2C 操作方面最理想的设置，并且是默认模式。

0..<nchans>

将多路复用器设置为预定的通道，如果有一个几乎始终使用的通道，并且您希望减少在其他通道上的罕见事务之后正常操作的延迟，则此方法很有用

/sys/bus/i2c/devices/.../bd9571mwv-regulator.*.auto/backup_mode

在文件 sysfs-driver-bd9571mwv-regulator 中定义

读取/写入 DDR 备份模式的当前状态，该模式控制在系统挂起期间是否保持 DDR 电源轨供电。（“on”/“1”=启用，“off”/“0”=禁用）。可以使用两种类型的电源开关（或控制信号）

  1. 使用瞬时电源开关（或脉冲信号），DDR 备份模式默认情况下在可用时启用，因为 PMIC 将仅在系统挂起期间配置。

  2. 使用拨动电源开关（或电平信号），必须严格按照以下步骤操作

    1. 为备份模式配置 PMIC，以将附件电源开关的角色从电源开关更改为唤醒开关，

    2. 关闭附件电源开关，为系统挂起做准备，这是一个不受软件控制的手动步骤，

    3. 挂起系统，

    4. 打开附件电源开关，以恢复系统。

    必须由用户显式启用 DDR 备份模式，才能调用步骤 1。

另请参阅 Documentation/devicetree/bindings/mfd/rohm,bd9571mwv.yaml。

用户：配备 BD9571MWV PMIC 的嵌入式板的用户空间应用程序。

/sys/bus/i2c/devices/.../calibration

在文件 sysfs-bus-i2c-devices-hm6352 中定义

设置校准开启或关闭 (1 = 开, 0 = 关)。请参阅芯片数据表。

/sys/bus/i2c/devices/.../device

在文件 sysfs-bus-i2c-devices-fsa9480 中定义

显示附加的设备

NONE

无设备

USB

已连接 USB 设备

UART

已连接 UART

CHARGER

已连接充电器

JIG

已连接 JIG

/sys/bus/i2c/devices/.../heading0_input

在文件 sysfs-bus-i2c-devices-hm6352 中定义

以浮点值（以度为单位）报告来自罗盘的当前航向。

/sys/bus/i2c/devices/.../output_hvled[n]

定义于文件 sysfs-bus-i2c-devices-lm3533

设置高压电流吸收器 HVLED[n] (n = 1, 2) (0, 1) 的控制背光设备。

/sys/bus/i2c/devices/.../output_lvled[n]

定义于文件 sysfs-bus-i2c-devices-lm3533

设置低压电流吸收器 LVLED[n] (n = 1..5) (0..3) 的控制 LED 设备。

/sys/bus/i2c/devices/.../power_state

在文件 sysfs-bus-i2c-devices-hm6352 中定义

设置设备的电源状态。0 将设备设置为睡眠模式，1 将其唤醒。

/sys/bus/i2c/devices/.../switch

在文件 sysfs-bus-i2c-devices-fsa9480 中定义

显示或设置手动开关的状态

VAUDIO

切换到 VAUDIO 路径

UART

切换到 UART 路径

AUDIO

切换到 AUDIO 路径

DHOST

切换到 DHOST 路径

AUTO

由设备自动切换

/sys/bus/i2c/devices/.../trickle_charge_bypass

定义于文件 sysfs-bus-i2c-devices-bq32k

启用/禁用涓流充电旁路的属性。 trickle_charge_bypass 属性允许用户空间启用/禁用涓流充电 FET 旁路。

/sys/bus/i2c/devices/<mcu_device>/board_revision

定义于文件 sysfs-bus-i2c-devices-turris-omnia-mcu

（只读）包含电路板修订号。

仅当电路板信息烧录到 MCU 中时才可用（较旧的修订版本将电路板信息烧录到 ATSHA204-A 芯片中）。

格式： %u。

/sys/bus/i2c/devices/<mcu_device>/first_mac_address

定义于文件 sysfs-bus-i2c-devices-turris-omnia-mcu

（只读）包含设备的第一个 MAC 地址。每个 Turris Omnia 都分配了 3 个 MAC 地址。另外两个地址通过递增第一个地址计算得出。

仅当电路板信息烧录到 MCU 中时才可用（较旧的修订版本将电路板信息烧录到 ATSHA204-A 芯片中）。

格式： %pM。

/sys/bus/i2c/devices/<mcu_device>/front_button_mode

定义于文件 sysfs-bus-i2c-devices-turris-omnia-mcu

（读写）Turris Omnia 路由器上的前面板按钮可以配置为更改前面板上所有 LED 的亮度，或者将按下事件作为中断发送到 CPU。

此文件在这两种模式之间切换

  • mcu 使按钮按下事件由 MCU 处理以更改 LED 面板亮度。

  • cpu 使按钮按下事件由 CPU 处理。

格式： %s。

/sys/bus/i2c/devices/<mcu_device>/front_button_poweron

定义于文件 sysfs-bus-i2c-devices-turris-omnia-mcu

（读写）较新版本的 Turris Omnia 路由器的微控制器固件支持将路由器断电到真正的低功耗模式。可以通过按下前面板按钮来开启路由器电源。

此文件配置是否启用前面板按钮开机。

仅当固件支持断电功能时，此文件才存在。

格式： %i。

/sys/bus/i2c/devices/<mcu_device>/fw_features

定义于文件 sysfs-bus-i2c-devices-turris-omnia-mcu

（只读）较新版本的微控制器固件报告它们支持的功能。这些可以从此文件中读取。如果 MCU 固件太旧，则此文件读取 0x0。

格式： 0x%x。

/sys/bus/i2c/devices/<mcu_device>/fw_version_hash_application

定义于文件 sysfs-bus-i2c-devices-turris-omnia-mcu

（只读）包含微控制器固件应用程序部分的版本哈希值（提交哈希值）。

格式： %s。

/sys/bus/i2c/devices/<mcu_device>/fw_version_hash_bootloader

定义于文件 sysfs-bus-i2c-devices-turris-omnia-mcu

（只读）包含微控制器固件引导加载程序部分的版本哈希值（提交哈希值）。

格式： %s。

/sys/bus/i2c/devices/<mcu_device>/mcu_type

定义于文件 sysfs-bus-i2c-devices-turris-omnia-mcu

（只读）包含微控制器类型 (STM32, GD32, MKL)。

格式： %s。

/sys/bus/i2c/devices/<mcu_device>/reset_selector

定义于文件 sysfs-bus-i2c-devices-turris-omnia-mcu

（只读）包含选定的出厂重置级别，该级别由用户在电路板重置期间按住后重置按钮的时间长短决定。

格式： %i。

/sys/bus/i2c/devices/<mcu_device>/serial_number

定义于文件 sysfs-bus-i2c-devices-turris-omnia-mcu

（只读）包含 64 位电路板序列号，采用十六进制格式。

仅当电路板信息烧录到 MCU 中时才可用（较旧的修订版本将电路板信息烧录到 ATSHA204-A 芯片中）。

格式： %016X。

/sys/bus/i2c/devices/xxx/fw_version

定义于文件 sysfs-driver-input-exc3000

报告触摸屏提供的固件版本，例如 EXC80H60 上的“00_T6”

访问：读取

有效值：表示为字符串

/sys/bus/i2c/devices/xxx/model

定义于文件 sysfs-driver-input-exc3000

报告触摸屏提供的型号标识，例如 EXC80H60 上的“Orion_1320”

访问：读取

有效值：表示为字符串

/sys/bus/i2c/devices/xxx/type

定义于文件 sysfs-driver-input-exc3000

报告触摸屏提供的类型标识，例如“PCAP82H80 Series”

访问：读取

有效值：表示为字符串

/sys/bus/i2c/drivers/ucsi_ccg/.../do_flash

定义于文件 sysfs-driver-ucsi-ccg

通过将 [Yy1] 写入文件，告诉 Cypress CCGx Type-C 控制器的驱动程序尝试固件升级。

/sys/bus/i3c/devices/<bus-id>-<device-pid>

定义于文件 sysfs-bus-i3c

这些目录只是指向 /sys/bus/i3c/devices/i3c-<bus-id>/<bus-id>-<device-pid> 的符号链接。

/sys/bus/i3c/devices/i3c-<bus-id>

定义于文件 sysfs-bus-i3c

I3C 总线。此目录将包含总线上存在的每个 I3C 设备的子目录。

/sys/bus/i3c/devices/i3c-<bus-id>/<bus-id>-<device-pid>

定义于文件 sysfs-bus-i3c

I3C 设备存在于由 <bus-id> 标识的 I3C 总线上。请注意，包括驱动总线的主设备在内的所有设备都已表示。

/sys/bus/i3c/devices/i3c-<bus-id>/<bus-id>-<device-pid>/bcr

定义于文件 sysfs-bus-i3c

BCR 代表总线特性寄存器，表示设备在速度、最大读取/写入长度等方面的功能。有关更多详细信息，请参阅 I3C 规范。

/sys/bus/i3c/devices/i3c-<bus-id>/<bus-id>-<device-pid>/dcr

定义于文件 sysfs-bus-i3c

DCR 代表设备特性寄存器，表示设备在暴露功能方面的能力。有关更多详细信息，请参阅 I3C 规范。

/sys/bus/i3c/devices/i3c-<bus-id>/<bus-id>-<device-pid>/dynamic_address

定义于文件 sysfs-bus-i3c

分配给设备 <bus-id>-<device-pid> 的动态地址。如果总线重新初始化，则此地址可能会更改。

/sys/bus/i3c/devices/i3c-<bus-id>/<bus-id>-<device-pid>/hdrcap

定义于文件 sysfs-bus-i3c

公开设备的高数据速率 (HDR) 功能。返回支持的 HDR 模式列表，每个元素用空格分隔。模式可以是“hdr-ddr”、“hdr-tsp”和“hdr-tsl”。

有关这些 HDR 模式的更多详细信息，请参阅 I3C 规范。

/sys/bus/i3c/devices/i3c-<bus-id>/<bus-id>-<device-pid>/pid

定义于文件 sysfs-bus-i3c

PID 代表预配置 ID，用于唯一标识总线上的设备。此 PID 包含有关供应商、零件和实例 ID 的信息，以便可以将多个相同类型的设备连接到同一总线上。有关更多详细信息，请参阅 I3C 规范。

/sys/bus/i3c/devices/i3c-<bus-id>/bcr

定义于文件 sysfs-bus-i3c

BCR 代表总线特性寄存器，表示设备在速度、最大读取/写入长度等方面的能力。有关更多详细信息，请参阅 I3C 规范。此条目描述了驱动总线的主控制器的 BCR。

/sys/bus/i3c/devices/i3c-<bus-id>/current_master

定义于文件 sysfs-bus-i3c

在读取此文件时公开拥有总线的主设备 (<bus-id>-<master-pid>)。请注意，总线所有权会随着时间的推移而改变，因此不能保证 read() 调用返回时返回的值仍然有效。

/sys/bus/i3c/devices/i3c-<bus-id>/dcr

定义于文件 sysfs-bus-i3c

DCR 代表设备特性寄存器，表示设备在暴露功能方面的能力。有关更多详细信息，请参阅 I3C 规范。此条目描述了驱动总线的主控制器的 DCR。

/sys/bus/i3c/devices/i3c-<bus-id>/dynamic_address

定义于文件 sysfs-bus-i3c

分配给主控制器的动态地址。如果总线重新初始化，则此地址可能会更改。

/sys/bus/i3c/devices/i3c-<bus-id>/hdrcap

定义于文件 sysfs-bus-i3c

公开设备的高数据速率 (HDR) 功能。返回支持的 HDR 模式列表，每个元素用空格分隔。模式可以是“hdr-ddr”、“hdr-tsp”和“hdr-tsl”。有关这些 HDR 模式的更多详细信息，请参阅 I3C 规范。

此条目描述了驱动总线的主控制器的 HDRCAP。

/sys/bus/i3c/devices/i3c-<bus-id>/hotjoin

定义于文件 sysfs-bus-i3c

I3C 的热加入机制允许 I3C 设备通知活动控制器，I3C 总线上存在新加入的目标，并且已准备好接收动态地址，以便在总线上完全正常工作。当目标安装在同一 I3C 总线上并且在需要或直到目标物理插入 I3C 总线之前保持断电时，将使用热加入

此条目允许启用或禁用驱动总线的当前控制器的热加入。

/sys/bus/i3c/devices/i3c-<bus-id>/i2c_scl_frequency

定义于文件 sysfs-bus-i3c

在 I2C 模式下运行时 SCL 信号的频率（以 Hz 表示）。

/sys/bus/i3c/devices/i3c-<bus-id>/i3c_scl_frequency

定义于文件 sysfs-bus-i3c

在 I3C SDR 模式下运行时 SCL 信号的频率（以 Hz 表示）。

/sys/bus/i3c/devices/i3c-<bus-id>/mode

定义于文件 sysfs-bus-i3c

I3C 总线模式。可以是“pure”、“mixed-fast”或“mixed-slow”。有关每种模式含义的详细说明，请参阅 I3C 规范。

/sys/bus/i3c/devices/i3c-<bus-id>/pid

定义于文件 sysfs-bus-i3c

PID 代表预配置 ID，用于唯一标识总线上的设备。此 PID 包含有关供应商、零件和实例 ID 的信息，以便可以将多个相同类型的设备连接到同一总线上。有关更多详细信息，请参阅 I3C 规范。此条目描述了驱动总线的主控制器的 PID。

/sys/bus/iio/devices/device[n]/in_illuminance0_calibrate

定义于文件 sysfs-bus-iio-light-tsl2772

导致 als 增益微调值的内部校准，该值稍后用于计算勒克斯的照度。

/sys/bus/iio/devices/device[n]/in_illuminance_calibrate

定义于文件 sysfs-bus-iio-light-tsl2583

此属性导致 als 增益微调值的内部校准，该值稍后用于计算勒克斯的照度。

/sys/bus/iio/devices/device[n]/in_illuminance_input_target

定义于文件 sysfs-bus-iio-light-tsl2583

此属性是已知的外部照度（以勒克斯为单位）。它用于校准设备精度的过程中。

/sys/bus/iio/devices/device[n]/in_illuminance_lux_table

定义于文件 sysfs-bus-iio-light-tsl2583

此属性获取/设置用于计算勒克斯照度的系数表。

/sys/bus/iio/devices/device[n]/in_proximity0_calibrate

定义于文件 sysfs-bus-iio-light-tsl2772

导致对 proximity_thresh_rising_value 进行重新计算和调整。

/sys/bus/iio/devices/iio:device*/buffer/hwfifo_timeout

在文件 sysfs-bus-iio 中定义

一个读/写属性，提供延迟报告样本直到达到超时时间的功能。这允许主机处理器休眠，而传感器将其内部 fifo 中的存储样本。可以通过设置 hwfifo_timeout 来指定最大超时时间（以秒为单位）。当前延迟可以通过读取 hwfifo_timeout 来读取。值 0 表示没有超时。

/sys/bus/iio/devices/iio:deviceX

在文件 sysfs-bus-iio 中定义

通过一个通信端口访问的硬件芯片或设备。对应于传感器通道的分组。 X 是设备的 IIO 索引。

/sys/bus/iio/devices/iio:deviceX/ac_excitation_en

定义于文件 sysfs-bus-iio-adc-ad7192

此属性（如果可用）用于启用某些转换器上的交流激励模式。在交流激励模式下，激励电压的极性在交替的周期中反转，以消除直流误差。

/sys/bus/iio/devices/iio:deviceX/auto_zeroing_mux_enable

定义于文件 sysfs-bus-iio-adc-mcp3564

此属性用于启用模拟输入多路复用器的自动调零算法（输入多路复用器和 ADC 包括一个抵消 ADC 偏移的算法）。当启用偏移抵消算法时，ADC 会进行两次转换，一次使用差分输入 VIN+/VIN-，另一次使用 VIN+/VIN- 反转。在这种情况下，与禁用该算法的默认情况相比，转换时间将乘以二。此技术允许消除 ADC 偏移误差并实现超低偏移，而无需任何数字校准。产生的偏移是两次转换之间差异的残余，其数量级与噪声基底相当。此偏移在每次转换时都被有效消除，因此残余偏移误差的温度漂移非常低。写入“1”以启用它，写入“0”以禁用它。

/sys/bus/iio/devices/iio:deviceX/auto_zeroing_ref_enable

定义于文件 sysfs-bus-iio-adc-mcp3564

此属性用于启用内部电压参考缓冲器的斩波算法。当选择外部电压参考时，此设置无效。内部电压参考缓冲器会将一定量的 1/f 噪声注入到系统中，该噪声可以通过传入的输入信号进行调制，并且可能会限制较高过采样率值（超过 256）下的信噪比性能。为了克服此限制，缓冲器包括一个自动调零算法，该算法可以大大减少（消除）1/f 噪声并消除参考缓冲器的偏移值。因此，即使在最大过采样率值下，系统的信噪比也不会受到参考缓冲器的 1/f 噪声分量的影响。写入“1”以启用它，写入“0”以禁用它。

/sys/bus/iio/devices/iio:deviceX/battery_low

定义于文件 sysfs-bus-iio-meas-spec

读取返回“1”或“0”。“1”表示提供给传感器的电池电量低于 2.25V。此 ABI 适用于 tsys02d、htu21、ms8607

/sys/bus/iio/devices/iio:deviceX/boost_current_gain

定义于文件 sysfs-bus-iio-adc-mcp3564

此属性用于设置 Delta-Sigma 调制器的偏置电流电路的增益。不同的 BOOST 设置应用于整个调制器电路，包括电压参考缓冲器。

/sys/bus/iio/devices/iio:deviceX/boost_current_gain_available

定义于文件 sysfs-bus-iio-adc-mcp3564

读取返回 Delta-Sigma 调制器偏置电流电路的可能增益值列表。

/sys/bus/iio/devices/iio:deviceX/bridge_switch_en

定义于文件 sysfs-bus-iio-adc-ad7192

此属性（如果可用）用于关闭或打开某些转换器上的桥式电源关闭开关。在桥式应用中，如应变计和称重传感器，桥本身消耗系统中大部分电流。为了最大限度地减少系统的电流消耗，可以断开桥接（当未使用 bridge_switch_en 属性时）。

/sys/bus/iio/devices/iio:deviceX/buffer

在文件 sysfs-bus-iio 中定义

与设备缓冲区相关的属性目录。

/sys/bus/iio/devices/iio:deviceX/buffer/hwfifo_enabled

在文件 sysfs-bus-iio 中定义

一个只读布尔值，指示当前是否启用或禁用硬件 FIFO。如果设备没有硬件 FIFO，则此条目不存在。如果设置了当前的硬件 FIFO 水位，并且其他当前的设备设置允许（例如，如果设置了以不同于硬件 FIFO 的方式采样数据的触发器，则硬件 FIFO 将不会启用），则在启用缓冲区时会启用硬件 FIFO。

如果启用了硬件 FIFO，并且硬件 FIFO 的级别达到了硬件 FIFO 水位，则设备会将其硬件 FIFO 刷新到设备缓冲区。当设备缓冲区中不存在样本时，在设备上执行非阻塞读取也将强制刷新。

当启用硬件 FIFO 时，无需使用触发器来使用缓冲模式，因为水位设置保证硬件 FIFO 被刷新到设备缓冲区。

/sys/bus/iio/devices/iio:deviceX/buffer/hwfifo_watermark

在文件 sysfs-bus-iio 中定义

只读条目，包含一个整数，指定硬件 FIFO 的当前水位。如果设备没有硬件 FIFO，则此条目不存在。硬件 FIFO 的水位由驱动程序根据用户在 buffer/watermark 中设置的值设置，但会考虑到硬件限制（例如，大多数硬件缓冲区限制为 32-64 个样本，某些硬件缓冲区水位是固定的或具有最低级别）。值 0 表示未设置硬件水位。

/sys/bus/iio/devices/iio:deviceX/buffer/hwfifo_watermark_available

在文件 sysfs-bus-iio 中定义

指定硬件 FIFO 可用水位的一系列正整数。此条目是可选的，如果不存在，则表示支持 hwfifo_watermark_min 和 hwfifo_watermark_max 之间的所有值。

如果用户将 buffer/watermark 设置为大于 hwfifo_watermak_min 但不等于此列表中任何值的的值，则驱动程序将为硬件 FIFO 水位选择合适的值。

/sys/bus/iio/devices/iio:deviceX/buffer/hwfifo_watermark_max

在文件 sysfs-bus-iio 中定义

一个正整数，指定此设备的硬件 FIFO 的最大水位。如果设备没有硬件 FIFO，则此条目不存在。

如果用户将 buffer/watermark 设置为大于此值的值，则硬件水位将上限为此值。

/sys/bus/iio/devices/iio:deviceX/buffer/hwfifo_watermark_min

在文件 sysfs-bus-iio 中定义

一个正整数，指定此设备的硬件 FIFO 的最小水位。如果设备没有硬件 FIFO，则此条目不存在。

如果用户将 buffer/watermark 设置为小于此值的值，则硬件水位将保持未设置。

/sys/bus/iio/devices/iio:deviceX/buffer/length_align_bytes

定义于文件 sysfs-bus-iio-dma-buffer

DMA 缓冲区往往对缓冲区具有对齐要求。如果未满足此对齐要求，则可能会从缓冲区中删除样本。

此属性以字节为单位报告对齐要求。这意味着缓冲区的大小（以字节为单位）需要是此文件报告的数字的整数倍。

以样本集数量为单位的对齐要求将取决于启用的通道和每个通道的字节数。这意味着以样本集数量为单位的对齐要求可能会根据启用哪些通道以及启用多少个通道而改变。而此属性以字节为单位报告的对齐要求将保持静态，并且不依赖于启用了哪些通道。

/sys/bus/iio/devices/iio:deviceX/bufferY

在文件 sysfs-bus-iio 中定义

包含接口的目录，这些接口用于捕获缓冲区中单个触发样本集的元素。

自内核 5.11 起，scan_elements 属性已合并到 bufferY 目录中，以便为每个缓冲区进行配置。

/sys/bus/iio/devices/iio:deviceX/bufferY/data_available

在文件 sysfs-bus-iio 中定义

一个只读值，指示缓冲区中可用的数据字节数。在输出缓冲区的情况下，这表示可用于写入数据的空闲空间量。在输入缓冲区的情况下，这表示可用于读取的数据量。

/sys/bus/iio/devices/iio:deviceX/bufferY/enable

在文件 sysfs-bus-iio 中定义

实际启动缓冲区捕获。如果第一个设备且合适，将启动触发。

请注意，如果其他属性（例如：事件、比例、采样率）影响当前活动的缓冲区捕获会话，则可能无法配置这些属性。

/sys/bus/iio/devices/iio:deviceX/bufferY/length

在文件 sysfs-bus-iio 中定义

缓冲区包含的扫描次数。

/sys/bus/iio/devices/iio:deviceX/bufferY/watermark

在文件 sysfs-bus-iio 中定义

一个正整数，指定要等待的最大扫描元素数。

轮询将阻塞，直到达到水位。

阻塞读取将等待，直到请求的读取量或低水位之间的最小值可用。

非阻塞读取将从缓冲区检索可用的样本，即使样本数少于水位。这允许应用程序使用超时阻止轮询，并在超时过期后读取可用的样本，从而具有最大延迟保证。

/sys/bus/iio/devices/iio:deviceX/calibrate

定义于文件 sysfs-bus-iio-cros-ec

写入“1”将执行 FOC（快速在线校准）。可以从 *_calibbias 条目读取相应的校准偏移。

/sys/bus/iio/devices/iio:deviceX/calibration_auto_enable

在文件 sysfs-bus-iio 中定义

某些传感器能够在运行时应用自动校准。例如，可能需要补偿测量腔室中的污染物堆积或光学元件的劣化，否则会导致传感器漂移。

向此属性写入 1 或 0 将分别激活或停用此自动校准功能。

读取时，将返回当前状态。

/sys/bus/iio/devices/iio:deviceX/calibration_data

定义于文件 sysfs-bus-iio-bno055

报告 IMU 传感器的二进制校准数据 blob。

/sys/bus/iio/devices/iio:deviceX/calibration_forced_value

在文件 sysfs-bus-iio 中定义

某些传感器能够使用已知的测量值（可能从外部参考设备获得）应用手动校准。

向此函数写入值将强制进行此类校准更改。对于 scd30，该值应在 [400 1 2000] 范围内。

请注意，对于 scd30，只有在写入后才能获得有效值。在此之前，应忽略对此值的任何回读。至于 scd4x，如果手动校准失败，将立即返回错误。

/sys/bus/iio/devices/iio:deviceX/calibration_forced_value_available

在文件 sysfs-bus-iio 中定义

强制校准值的可用范围，表示为

  • 一个范围，指定为“[最小值 步长 最大值]”

/sys/bus/iio/devices/iio:deviceX/cleaning_period

定义于文件 sysfs-bus-iio-sps30

传感器能够定期触发自清洁。可以通过在此处写入新值来更改周期。读取时，将返回当前值。单位为秒。

写入 0 将完全禁用定期自清洁。

/sys/bus/iio/devices/iio:deviceX/cleaning_period_available

定义于文件 sysfs-bus-iio-sps30

以秒为单位的可用值范围，表示为最小值、步长和最大值，所有值都包含在方括号中。

/sys/bus/iio/devices/iio:deviceX/current_timestamp_clock

在文件 sysfs-bus-iio 中定义

字符串，标识用于为设备 X 的缓冲样本和事件添加时间戳的当前 posix 时钟。

/sys/bus/iio/devices/iio:deviceX/error_status

定义于文件 sysfs-bus-iio-chemical-sunrise-co2

读取返回当前的芯片错误状态。

/sys/bus/iio/devices/iio:deviceX/error_status_available

定义于文件 sysfs-bus-iio-chemical-sunrise-co2

读取操作返回可能的芯片错误状态列表。可用选项包括：- ‘error_fatal’：模拟前端初始化错误 - ‘error_i2c’：读/写不存在的寄存器 - ‘error_algorithm’：参数损坏 - ‘error_calibration’：校准失败 - ‘error_self_diagnostic’：内部接口故障 - ‘error_out_of_range’：测量浓度超出范围 - ‘error_memory’：内存操作期间出错 - ‘error_no_measurement’：首次测量时清除 - ‘error_low_voltage’：传感器稳压电压过低 - ‘error_measurement_timeout’：无法完成测量

/sys/bus/iio/devices/iio:deviceX/events

在文件 sysfs-bus-iio 中定义

配置哪些硬件生成的事件传递到用户空间。

/sys/bus/iio/devices/iio:deviceX/events/in_altvoltage0_mag_rising_reset_max

定义在文件sysfs-bus-iio-resolver-ad2s1210中

读取操作返回以毫伏为单位的当前信号复位最大阈值退化值。写入操作设置该值。

/sys/bus/iio/devices/iio:deviceX/events/in_altvoltage0_mag_rising_reset_max_available

定义在文件sysfs-bus-iio-resolver-ad2s1210中

读取操作返回in_altvoltage0_mag_rising_reset_max允许的电压范围。

/sys/bus/iio/devices/iio:deviceX/events/in_altvoltage0_mag_rising_reset_min

定义在文件sysfs-bus-iio-resolver-ad2s1210中

读取操作返回以毫伏为单位的当前信号复位最小阈值退化值。写入操作设置该值。

/sys/bus/iio/devices/iio:deviceX/events/in_altvoltage0_mag_rising_reset_min_available

定义在文件sysfs-bus-iio-resolver-ad2s1210中

读取操作返回in_altvoltage0_mag_rising_reset_min允许的电压范围。

/sys/bus/iio/devices/iio:deviceX/events/in_altvoltageY_mag_either_label

/sys/bus/iio/devices/iio:deviceX/events/in_altvoltageY_mag_rising_label

/sys/bus/iio/devices/iio:deviceX/events/in_altvoltageY_thresh_falling_label

/sys/bus/iio/devices/iio:deviceX/events/in_altvoltageY_thresh_rising_label

/sys/bus/iio/devices/iio:deviceX/events/in_anglvelY_mag_rising_label

/sys/bus/iio/devices/iio:deviceX/events/in_anglY_thresh_rising_label

/sys/bus/iio/devices/iio:deviceX/events/in_phaseY_mag_rising_label

在文件 sysfs-bus-iio 中定义

设备通道事件的可选符号标签。如果为此事件定义了标签，则将其添加到事件特定的属性中。这对于用户空间更好地识别单个事件非常有用。

/sys/bus/iio/devices/iio:deviceX/events/in_illuminance_period_available

在文件 sysfs-bus-iio 中定义

光强度必须高于阈值水平才能断言中断的有效周期列表（以秒为单位）。

/sys/bus/iio/devices/iio:deviceX/events/in_voltageY_thresh_falling_value

定义在文件sysfs-bus-iio-adc-hi8435中

通道 Y 低电压阈值。如果传感器输入电压低于此值，则会触发阈值下降事件。根据 in_voltageY_sensing_mode，“GND-Open”和“Supply-Open”模式分别设置低电压阈值。通道 0..31 具有相同的低阈值，但可能具有不同的 sensing_mode。

低电压阈值范围在 2..21V 之间。低阈值和高阈值之间的迟滞不能低于 2，且不能为奇数。

如果下降阈值导致迟滞为奇数值，则上升阈值会自动减 1。

/sys/bus/iio/devices/iio:deviceX/events/in_voltageY_thresh_rising_value

定义在文件sysfs-bus-iio-adc-hi8435中

通道 Y 高电压阈值。如果传感器输入电压高于此值，则会触发阈值上升事件。根据 in_voltageY_sensing_mode，“GND-Open”和“Supply-Open”模式分别设置高电压阈值。

通道 0..31 具有相同的高阈值，但可能具有不同的 sensing_mode。

高电压阈值范围在 3..22V 之间。低阈值和高阈值之间的迟滞不能低于 2，且不能为奇数。

如果上升阈值导致迟滞为奇数值，则下降阈值会自动加 1。

/sys/bus/iio/devices/iio:deviceX/fault_oc

定义在文件sysfs-bus-iio-thermocouple中

开路故障。检测开路故障，例如热电偶导线断裂引起的故障。读取操作在出现故障时返回“1”，否则返回“0”。

/sys/bus/iio/devices/iio:deviceX/fault_ovuv

定义在文件sysfs-bus-iio-thermocouple中

过压或欠压输入故障。内部电路受到施加到热电偶电缆的过高电压的保护。该设备还可以检测是否发生这种情况。

如果输入电压为负或大于 VDD，则读取操作返回“1”，否则返回“0”。

/sys/bus/iio/devices/iio:deviceX/filter_mode

定义在文件sysfs-bus-iio-filter-admv8818中

此属性配置滤波器模式。读取操作返回实际模式。

/sys/bus/iio/devices/iio:deviceX/filter_mode_available

定义在文件sysfs-bus-iio-filter-admv8818中

读取此属性会返回可以写入 filter_mode 属性的有效值。

  • auto -> 调整带通滤波器以跟踪输入时钟频率的变化。

  • manual -> 禁用/取消注册时钟频率通知器/输入时钟跟踪。

  • bypass -> 旁路低通滤波器、高通滤波器并禁用/取消注册

    时钟频率通知器

/sys/bus/iio/devices/iio:deviceX/filter_type_available

/sys/bus/iio/devices/iio:deviceX/in_voltage-voltage_filter_mode_available

在文件 sysfs-bus-iio 中定义

读取操作返回包含可能滤波器模式的列表。该属性的选项为

  • “sinc3” - 数字 sinc3 滤波器。中等第一次转换时间。良好的噪声性能。

  • “sinc4” - Sinc 4。卓越的噪声性能。较长的第一次转换时间。

  • “sinc5” - 数字 sinc5 滤波器。卓越的噪声性能

  • “sinc4+sinc1” - Sinc4 + 平均值除以 8。较短的第一次转换时间。

  • “sinc3+rej60” - Sinc3 + 60Hz 抑制。

  • “sinc3+sinc1” - Sinc3 + 平均值除以 8。较短的第一次转换时间。

  • “sinc3+pf1” - Sinc3 + 设备特定的后置滤波器 1。

  • “sinc3+pf2” - Sinc3 + 设备特定的后置滤波器 2。

  • “sinc3+pf3” - Sinc3 + 设备特定的后置滤波器 3。

  • “sinc3+pf4” - Sinc3 + 设备特定的后置滤波器 4。

/sys/bus/iio/devices/iio:deviceX/fusion_enable

定义于文件 sysfs-bus-iio-bno055

可以是 1 或 0。启用/禁用“传感器融合”（又名 NDOF）硬件功能。

/sys/bus/iio/devices/iio:deviceX/heater_enable

在文件 sysfs-bus-iio 中定义

“1”（启用）或“0”（禁用）指定加热器功能的启用。相同的读取值适用。

此 ABI 特别适用于湿度传感器，用于加热设备并去除某些湿度环境中的任何冷凝水。

/sys/bus/iio/devices/iio:deviceX/id

定义于文件 sysfs-bus-iio-cros-ec

此属性由 CrOS EC 传感器驱动程序公开，表示 EC 公开的传感器 ID。Android 传感器服务硬件抽象层 (sensor HAL) 通过 ChromeOS 上的 Android 容器使用此 ID。

/sys/bus/iio/devices/iio:deviceX/in_X_mean_raw

在文件 sysfs-bus-iio 中定义

来自通道 X 的平均原始测量值。用于平均的值的数量取决于具体设备。正常原始值的转换规则也适用于平均原始值。

/sys/bus/iio/devices/iio:deviceX/in_accel_calibbias_available

/sys/bus/iio/devices/iio:deviceX/in_anglvel_calibbias_available

/sys/bus/iio/devices/iio:deviceX/in_temp_calibbias_available

/sys/bus/iio/devices/iio:deviceX/in_proximity_calibbias_available

/sys/bus/iio/devices/iio:deviceX/in_voltageY_calibbias_available

/sys/bus/iio/devices/iio:deviceX/out_voltageY_calibbias_available

在文件 sysfs-bus-iio 中定义

校准偏置的可用值。可以表示为以下两种形式之一：

  • 一小组离散值，如“0 2 4 6 8”

  • 一个范围，指定为“[最小值 步长 最大值]”

/sys/bus/iio/devices/iio:deviceX/in_accel_calibration_auto_status

定义于文件 sysfs-bus-iio-bno055

报告加速度计传感器的自动校准状态。可以是 0（甚至未启用校准）或 1 到 5，数字越大，校准状态越好。

/sys/bus/iio/devices/iio:deviceX/in_accel_linear_x_raw

/sys/bus/iio/devices/iio:deviceX/in_accel_linear_y_raw

/sys/bus/iio/devices/iio:deviceX/in_accel_linear_z_raw

在文件 sysfs-bus-iio 中定义

与 in_accel_X_raw 属性相同，但减去了重力引起的加速度。

/sys/bus/iio/devices/iio:deviceX/in_accel_offset

/sys/bus/iio/devices/iio:deviceX/in_accel_x_offset

/sys/bus/iio/devices/iio:deviceX/in_accel_y_offset

/sys/bus/iio/devices/iio:deviceX/in_accel_z_offset

/sys/bus/iio/devices/iio:deviceX/in_voltageY_offset

/sys/bus/iio/devices/iio:deviceX/in_voltage_offset

/sys/bus/iio/devices/iio:deviceX/in_voltageY_i_offset

/sys/bus/iio/devices/iio:deviceX/in_voltageY_q_offset

/sys/bus/iio/devices/iio:deviceX/in_voltage_q_offset

/sys/bus/iio/devices/iio:deviceX/in_voltage_i_offset

/sys/bus/iio/devices/iio:deviceX/in_currentY_offset

/sys/bus/iio/devices/iio:deviceX/in_current_offset

/sys/bus/iio/devices/iio:deviceX/in_currentY_i_offset

/sys/bus/iio/devices/iio:deviceX/in_currentY_q_offset

/sys/bus/iio/devices/iio:deviceX/in_current_q_offset

/sys/bus/iio/devices/iio:deviceX/in_current_i_offset

/sys/bus/iio/devices/iio:deviceX/in_tempY_offset

/sys/bus/iio/devices/iio:deviceX/in_temp_offset

/sys/bus/iio/devices/iio:deviceX/in_pressureY_offset

/sys/bus/iio/devices/iio:deviceX/in_pressure_offset

/sys/bus/iio/devices/iio:deviceX/in_humidityrelative_offset

/sys/bus/iio/devices/iio:deviceX/in_magn_offset

/sys/bus/iio/devices/iio:deviceX/in_rot_offset

/sys/bus/iio/devices/iio:deviceX/in_angl_offset

/sys/bus/iio/devices/iio:deviceX/in_capacitanceX_offset

在文件 sysfs-bus-iio 中定义

如果设备已知，则在通过 <type>[Y]_scale 进行缩放之前添加到 <type>[Y]_raw 的偏移量，以便获得 <type>[Y]_raw 文档中指定的 <type> 单位的值。如果偏移量始终为 0 或未知，则不存在。如果不存在 Y 或轴 <x|y|z>，则偏移量适用于 <type> 的所有输入通道。如果可以在设备上应用可变偏移量，则可能可写。请注意，这与 calibbias 不同，后者适用于对部件的不同实例之间的差异进行补偿的设备（或驱动程序），通常通过使用某些硬件支持的校准过程进行调整。Calibbias 在内部应用，偏移量在用户空间中应用于 _raw 输出。

/sys/bus/iio/devices/iio:deviceX/in_accel_power_mode

定义在文件sysfs-bus-iio-inv_icm42600中

加速度计电源模式。如果 ODR 支持，则设置此属性将设置要使用的请求电源模式。如果 ODR 仅支持 1 种模式，则将强制使用电源模式。如果传感器已打开，则读取此属性将返回当前加速度计电源模式；如果传感器已关闭，则返回请求的值。对于仅支持 1 种模式的 ODR，实际值和请求值之间的值可能不同。

/sys/bus/iio/devices/iio:deviceX/in_accel_power_mode_available

定义在文件sysfs-bus-iio-inv_icm42600中

可以在 in_accel_power_mode 属性中设置的可用加速度计电源模式的列表。

/sys/bus/iio/devices/iio:deviceX/in_accel_raw_range

定义于文件 sysfs-bus-iio-bno055

加速度读数的原始（未缩放）范围。应用缩放后的单位为 m/s^2。请注意，这不会影响缩放（当更改最大和最小可读值也会影响读取缩放因子时，应使用该缩放）。

/sys/bus/iio/devices/iio:deviceX/in_accel_raw_range_available

定义于文件 sysfs-bus-iio-bno055

in_accel_raw_range 属性允许的值列表

/sys/bus/iio/devices/iio:deviceX/in_accel_scale_available

/sys/.../iio:deviceX/in_anglvel_scale_available

/sys/.../iio:deviceX/in_magn_scale_available

/sys/.../iio:deviceX/in_illuminance_scale_available

/sys/.../iio:deviceX/in_intensity_scale_available

/sys/.../iio:deviceX/in_proximity_scale_available

/sys/.../iio:deviceX/in_voltageX_scale_available

/sys/.../iio:deviceX/in_voltage-voltage_scale_available

/sys/.../iio:deviceX/out_voltageX_scale_available

/sys/.../iio:deviceX/out_altvoltageX_scale_available

/sys/.../iio:deviceX/in_capacitance_scale_available

/sys/.../iio:deviceX/in_pressure_scale_available

/sys/.../iio:deviceX/in_pressureY_scale_available

在文件 sysfs-bus-iio 中定义

如果有一组离散的缩放值可用，则会在该属性中列出。与照度不同，将强度乘以 intensity_scale 不会产生具有任何标准化单位的值。

/sys/bus/iio/devices/iio:deviceX/in_accel_x_calibbias

/sys/bus/iio/devices/iio:deviceX/in_accel_y_calibbias

/sys/bus/iio/devices/iio:deviceX/in_accel_z_calibbias

/sys/bus/iio/devices/iio:deviceX/in_altvoltageY_i_calibbias

/sys/bus/iio/devices/iio:deviceX/in_altvoltageY_q_calibbias

/sys/bus/iio/devices/iio:deviceX/in_anglvel_x_calibbias

/sys/bus/iio/devices/iio:deviceX/in_anglvel_y_calibbias

/sys/bus/iio/devices/iio:deviceX/in_anglvel_z_calibbias

/sys/bus/iio/devices/iio:deviceX/in_capacitance_calibbias

/sys/bus/iio/devices/iio:deviceX/in_illuminance_calibbias

/sys/bus/iio/devices/iio:deviceX/in_illuminance0_calibbias

/sys/bus/iio/devices/iio:deviceX/in_intensityY_calibbias

/sys/bus/iio/devices/iio:deviceX/in_magn_x_calibbias

/sys/bus/iio/devices/iio:deviceX/in_magn_y_calibbias

/sys/bus/iio/devices/iio:deviceX/in_magn_z_calibbias

/sys/bus/iio/devices/iio:deviceX/in_pressure_calibbias

/sys/bus/iio/devices/iio:deviceX/in_pressureY_calibbias

/sys/bus/iio/devices/iio:deviceX/in_proximity_calibbias

/sys/bus/iio/devices/iio:deviceX/in_proximity0_calibbias

/sys/bus/iio/devices/iio:deviceX/in_resistance_calibbias

/sys/bus/iio/devices/iio:deviceX/in_temp_calibbias

/sys/bus/iio/devices/iio:deviceX/in_voltageY_calibbias

/sys/bus/iio/devices/iio:deviceX/out_currentY_calibbias

/sys/bus/iio/devices/iio:deviceX/out_voltageY_calibbias

在文件 sysfs-bus-iio 中定义

硬件应用的校准偏移（假定用于修正生产误差）。icm42600：对于此设备，值是以 SI 单位表示的实际物理偏移（加速度计为 m/s^2，陀螺仪为 rad/s）。

/sys/bus/iio/devices/iio:deviceX/in_accel_x_calibscale

/sys/bus/iio/devices/iio:deviceX/in_accel_y_calibscale

/sys/bus/iio/devices/iio:deviceX/in_accel_z_calibscale

/sys/bus/iio/devices/iio:deviceX/in_altvoltage_calibscale

/sys/bus/iio/devices/iio:deviceX/in_anglvel_x_calibscale

/sys/bus/iio/devices/iio:deviceX/in_anglvel_y_calibscale

/sys/bus/iio/devices/iio:deviceX/in_anglvel_z_calibscale

/sys/bus/iio/devices/iio:deviceX/in_capacitance_calibscale

/sys/bus/iio/devices/iio:deviceX/in_illuminance_calibscale

/sys/bus/iio/devices/iio:deviceX/in_illuminance0_calibscale

/sys/bus/iio/devices/iio:deviceX/in_intensity_both_calibscale

/sys/bus/iio/devices/iio:deviceX/in_intensity_calibscale

/sys/bus/iio/devices/iio:deviceX/in_intensity_ir_calibscale

/sys/bus/iio/devices/iio:deviceX/in_magn_x_calibscale

/sys/bus/iio/devices/iio:deviceX/in_magn_y_calibscale

/sys/bus/iio/devices/iio:deviceX/in_magn_z_calibscale

/sys/bus/iio/devices/iio:deviceX/in_pressure_calibscale

/sys/bus/iio/devices/iio:deviceX/in_pressureY_calibscale

/sys/bus/iio/devices/iio:deviceX/in_proximity0_calibscale

/sys/bus/iio/devices/iio:deviceX/in_voltage_calibscale

/sys/bus/iio/devices/iio:deviceX/in_voltage_i_calibscale

/sys/bus/iio/devices/iio:deviceX/in_voltage_q_calibscale

/sys/bus/iio/devices/iio:deviceX/in_voltageY_calibscale

/sys/bus/iio/devices/iio:deviceX/in_voltageY_i_calibscale

/sys/bus/iio/devices/iio:deviceX/in_voltageY_q_calibscale

/sys/bus/iio/devices/iio:deviceX/in_voltageY_supply_calibscale

/sys/bus/iio/devices/iio:deviceX/out_currentY_calibscale

/sys/bus/iio/devices/iio:deviceX/out_voltageY_calibscale

在文件 sysfs-bus-iio 中定义

硬件应用的校准比例因子（假定用于修正生产误差）。如果所有通道共享，则使用 <type>_calibscale。

/sys/bus/iio/devices/iio:deviceX/in_accel_x_peak_raw

/sys/bus/iio/devices/iio:deviceX/in_accel_y_peak_raw

/sys/bus/iio/devices/iio:deviceX/in_accel_z_peak_raw

/sys/bus/iio/devices/iio:deviceX/in_humidityrelative_peak_raw

/sys/bus/iio/devices/iio:deviceX/in_temp_peak_raw

在文件 sysfs-bus-iio 中定义

自上次复位条件以来的最高值。这些属性允许访问此值，否则与 <type>Y[_name]_raw 属性直接等效。

/sys/bus/iio/devices/iio:deviceX/in_accel_x_raw

/sys/bus/iio/devices/iio:deviceX/in_accel_y_raw

/sys/bus/iio/devices/iio:deviceX/in_accel_z_raw

在文件 sysfs-bus-iio 中定义

沿 x、y 或 z 方向的加速度（可以任意分配，但应与设备上的其他此类分配匹配）。具有与 voltageY 相同的等效参数。应用比例和偏移后的单位是 m/s^2。

/sys/bus/iio/devices/iio:deviceX/in_accel_xyz_squared_peak_raw

在文件 sysfs-bus-iio 中定义

基于指定方向上基础值的平方和大小计算的峰值。

/sys/bus/iio/devices/iio:deviceX/in_activity_calibgender_available

/sys/bus/iio/devices/iio:deviceX/in_energy_calibgender_available

/sys/bus/iio/devices/iio:deviceX/in_distance_calibgender_available

/sys/bus/iio/devices/iio:deviceX/in_velocity_calibgender_available

在文件 sysfs-bus-iio 中定义

列出所有可用的性别值（例如：男性、女性）。

/sys/bus/iio/devices/iio:deviceX/in_activity_calibgender

/sys/bus/iio/devices/iio:deviceX/in_energy_calibgender

/sys/bus/iio/devices/iio:deviceX/in_distance_calibgender

/sys/bus/iio/devices/iio:deviceX/in_velocity_calibgender

在文件 sysfs-bus-iio 中定义

用户性别（例如：男性、女性），一些计步器使用该值来计算步幅、距离、速度和活动类型。

/sys/bus/iio/devices/iio:deviceX/in_activity_calibheight

/sys/bus/iio/devices/iio:deviceX/in_energy_calibheight

/sys/bus/iio/devices/iio:deviceX/in_distance_calibheight

/sys/bus/iio/devices/iio:deviceX/in_velocity_calibheight

在文件 sysfs-bus-iio 中定义

用户身高（以米为单位），一些计步器使用该值来计算步幅、距离、速度和活动类型。

/sys/bus/iio/devices/iio:deviceX/in_allow_async_readout

在文件 sysfs-bus-iio-ina2xx-adc 中定义

默认情况下（值为“0”），捕获线程会检查转换就绪标志是否已设置，然后再将新值提交到样本缓冲区。这会将芯片内转换率与驱动程序内的读取速率同步，但会增加额外的寄存器读取开销。

写入“1”将删除对转换就绪标志的轮询，以节省额外的 i2c 事务，这将提高可用于读取数据的带宽。但是，根据捕获和转换速率之间的节拍，可能会偶尔跳过或重复样本。

/sys/bus/iio/devices/iio:deviceX/in_altvoltage0-1_i_calibphase

在文件 sysfs-bus-iio-frequency-admv1013 中定义

读取/写入本地振荡器路径正交 I 相移的未缩放值。

/sys/bus/iio/devices/iio:deviceX/in_altvoltage0-1_q_calibphase

在文件 sysfs-bus-iio-frequency-admv1013 中定义

读取/写入本地振荡器路径正交 Q 相移的未缩放值。

/sys/bus/iio/devices/iio:deviceX/in_altvoltage0_i_calibbias

在文件 sysfs-bus-iio-frequency-admv1013 中定义

读取/写入本地振荡器馈通偏移校准 I 正侧的值。

/sys/bus/iio/devices/iio:deviceX/in_altvoltage0_i_calibscale_coarse

在文件 sysfs-bus-iio-frequency-admv1014 中定义

读取/写入粗略步进的数字衰减器增益 (IF_I) 的值。

/sys/bus/iio/devices/iio:deviceX/in_altvoltage0_i_calibscale_fine

在文件 sysfs-bus-iio-frequency-admv1014 中定义

读取/写入精细步进的数字衰减器增益 (IF_I) 的值。

/sys/bus/iio/devices/iio:deviceX/in_altvoltage0_q_calibbias

在文件 sysfs-bus-iio-frequency-admv1013 中定义

读取/写入本地振荡器馈通偏移校准 Q 正侧的值。

/sys/bus/iio/devices/iio:deviceX/in_altvoltage0_q_calibscale_coarse

在文件 sysfs-bus-iio-frequency-admv1014 中定义

读取/写入粗略步进的数字衰减器增益 (IF_Q) 的值。

/sys/bus/iio/devices/iio:deviceX/in_altvoltage0_q_calibscale_fine

在文件 sysfs-bus-iio-frequency-admv1014 中定义

读取/写入精细步进的数字衰减器增益 (IF_Q) 的值。

/sys/bus/iio/devices/iio:deviceX/in_altvoltage1_i_calibbias

在文件 sysfs-bus-iio-frequency-admv1013 中定义

读取/写入本地振荡器馈通偏移校准 I 负侧的原始值。

/sys/bus/iio/devices/iio:deviceX/in_altvoltage1_q_calibbias

在文件 sysfs-bus-iio-frequency-admv1013 中定义

读取/写入本地振荡器馈通偏移校准 Q 负侧的原始值。

/sys/bus/iio/devices/iio:deviceX/in_altvoltageY_compare_interval

在文件 sysfs-bus-iio-adc-envelope-detector 中定义

在输入峰值电平的二分查找的每个步骤中，等待比较器的时间（以毫秒为单位）。需要与输入信号的频率相关。

/sys/bus/iio/devices/iio:deviceX/in_altvoltageY_invert

在文件 sysfs-bus-iio-adc-envelope-detector 中定义

DAC 用于通过二进制搜索（使用连接到中断引脚的比较器的输出）来查找交流电压输入信号的峰值电平。如下所示

                      _
                     | \
input +------>-------|+ \
                     |   \
       .-------.     |    }---.
       |       |     |   /    |
       |    dac|-->--|- /     |
       |       |     |_/      |
       |       |              |
       |       |              |
       |    irq|------<-------'
       |       |
       '-------'

当输入信号以 DAC 的最大值而不是零为中心时，应设置布尔反转属性 (0/1)。在这种情况下，包络检测器将从下方搜索，并且也会反转结果。

中断的边沿/电平也会切换到其相反的值。

/sys/bus/iio/devices/iio:deviceX/in_anglY_label

在文件 sysfs-bus-iio 中定义

通道 Y 的可选符号标签。对于 Intel hid 铰链传感器，标签值为：铰链、键盘、屏幕。这意味着三个通道分别对应于铰链角度、键盘角度和屏幕角度。

/sys/bus/iio/devices/iio:deviceX/in_angl_raw

/sys/bus/iio/devices/iio:deviceX/in_anglY_raw

在文件 sysfs-bus-iio 中定义

旋转角度。应用比例和偏移后的单位是弧度。

/sys/bus/iio/devices/iio:deviceX/in_anglvel_raw_range

定义于文件 sysfs-bus-iio-bno055

角速度读数的范围（以弧度每秒为单位）。请注意，这不会影响比例（当更改最大和最小可读值也会影响读取比例因子时应使用此比例）。

/sys/bus/iio/devices/iio:deviceX/in_anglvel_raw_range_available

定义于文件 sysfs-bus-iio-bno055

in_anglvel_raw_range 属性允许的值列表

/sys/bus/iio/devices/iio:deviceX/in_anglvel_x_raw

/sys/bus/iio/devices/iio:deviceX/in_anglvel_y_raw

/sys/bus/iio/devices/iio:deviceX/in_anglvel_z_raw

在文件 sysfs-bus-iio 中定义

绕 x、y 或 z 轴的角速度（可以任意分配）。具有与 voltageY 相同的等效参数。应用比例和偏移后的单位是弧度每秒。

/sys/bus/iio/devices/iio:deviceX/in_capacitanceY_raw

在文件 sysfs-bus-iio 中定义

来自通道 Y 的原始电容测量值。应用比例和偏移后的单位是纳法拉。

/sys/bus/iio/devices/iio:deviceX/in_chromaticity_x_raw

/sys/bus/iio/devices/iio:deviceX/in_chromaticity_y_raw

在文件 sysfs-bus-iio 中定义

CIE 1931 色度图上的 x 和 y 光颜色坐标。

/sys/bus/iio/devices/iio:deviceX/in_colortemp_raw

在文件 sysfs-bus-iio 中定义

表示光色温，以开尔文为单位测量光色温。

/sys/bus/iio/devices/iio:deviceX/in_concentration_VOC_short_raw

在文件 sysfs-bus-iio-chemical-vz89x 中定义

从传感器获取原始校准 VOC 值。此值在校准之外几乎没有应用。

/sys/bus/iio/devices/iio:deviceX/in_concentration_co2_calibration_background

定义于文件 sysfs-bus-iio-chemical-sunrise-co2

写入“1”会触发“背景”校准周期。

/sys/bus/iio/devices/iio:deviceX/in_concentration_co2_calibration_factory

定义于文件 sysfs-bus-iio-chemical-sunrise-co2

写入“1”会触发“工厂”校准周期。

/sys/bus/iio/devices/iio:deviceX/in_concentration_raw

/sys/bus/iio/devices/iio:deviceX/in_concentrationX_raw

/sys/bus/iio/devices/iio:deviceX/in_concentration_co2_raw

/sys/bus/iio/devices/iio:deviceX/in_concentrationX_co2_raw

/sys/bus/iio/devices/iio:deviceX/in_concentration_ethanol_raw

/sys/bus/iio/devices/iio:deviceX/in_concentrationX_ethanol_raw

/sys/bus/iio/devices/iio:deviceX/in_concentration_h2_raw

/sys/bus/iio/devices/iio:deviceX/in_concentrationX_h2_raw

/sys/bus/iio/devices/iio:deviceX/in_concentration_o2_raw

/sys/bus/iio/devices/iio:deviceX/in_concentrationX_o2_raw

/sys/bus/iio/devices/iio:deviceX/in_concentration_voc_raw

/sys/bus/iio/devices/iio:deviceX/in_concentrationX_voc_raw

在文件 sysfs-bus-iio 中定义

物质的原始（未缩放，无偏移等）读数。应用比例和偏移后的单位是百分比。

/sys/bus/iio/devices/iio:deviceX/in_conversion_mode

在文件 sysfs-bus-iio-vf610 中定义

指定使用的硬件转换模式。三个可用模式为“正常”、“高速”和“低功耗”，其中最后一个是默认模式。

/sys/bus/iio/devices/iio:deviceX/in_count0_enable_mode

在文件 sysfs-bus-iio-timer-stm32 中定义

配置设备计数器启用模式，在所有情况下，计数方向由 in_count0_count_direction 属性设置，计数器由内部时钟计时。

always

计数器始终处于开启状态。

gated

当连接的触发信号电平为高时，启用计数，否则禁用计数。

triggered

在连接的触发器的上升沿启用计数，并在所选模式的持续时间内保持启用状态。

/sys/bus/iio/devices/iio:deviceX/in_count0_preset

在文件 sysfs-bus-iio-timer-stm32 中定义

读取返回当前预设值。写入设置预设值。向上计数时，计数器从 0 开始，并在达到预设值时触发事件。向下计数时，计数器从预设值开始，并在达到 0 时触发事件。

/sys/bus/iio/devices/iio:deviceX/in_count0_trigger_mode

在文件 sysfs-bus-iio-timer-stm32 中定义

配置设备计数器触发模式，计数方向由 in_count0_count_direction 属性设置，计数器由连接的触发上升沿计时。

/sys/bus/iio/devices/iio:deviceX/in_countY_count_direction

在文件 sysfs-bus-iio 中定义

此接口已弃用；请使用计数器子系统。

通道 Y 的原始计数器设备计数方向。

/sys/bus/iio/devices/iio:deviceX/in_countY_raw

在文件 sysfs-bus-iio 中定义

此接口已弃用；请使用计数器子系统。

来自通道 Y 的原始计数器设备计数。对于正交计数器，乘以可用的 [Y]_scale 会得到通道 Y 单个正交信号相位的计数。

/sys/bus/iio/devices/iio:deviceX/in_count_count_direction_available

在文件 sysfs-bus-iio 中定义

此接口已弃用；请使用计数器子系统。

可能的计数方向列表，包括：

  • “up” : 计数器设备正在增加。

  • “down”: 计数器设备正在减少。

/sys/bus/iio/devices/iio:deviceX/in_count_enable_mode_available

在文件 sysfs-bus-iio-timer-stm32 中定义

读取返回可能的使能模式列表。

/sys/bus/iio/devices/iio:deviceX/in_count_trigger_mode_available

在文件 sysfs-bus-iio-timer-stm32 中定义

读取返回可能的触发模式列表。

/sys/bus/iio/devices/iio:deviceX/in_current5_raw

定义于文件 sysfs-bus-iio-adc-mt6360

指示的 MT6360 IBUS ADC，使用比例和偏移量计算返回电压，单位为 uA

/sys/bus/iio/devices/iio:deviceX/in_current6_raw

定义于文件 sysfs-bus-iio-adc-mt6360

指示的 MT6360 IBAT ADC，使用比例和偏移量计算返回电压，单位为 uA

/sys/bus/iio/devices/iio:deviceX/in_current7_raw

定义于文件 sysfs-bus-iio-adc-mt6360

指示的 MT6360 CHG_VDDP ADC，使用比例和偏移量计算返回电压，单位为 uV

/sys/bus/iio/devices/iio:deviceX/in_currentX_raw

/sys/bus/iio/devices/iio:deviceX/in_currentX_i_raw

/sys/bus/iio/devices/iio:deviceX/in_currentX_q_raw

在文件 sysfs-bus-iio 中定义

来自通道 X 的原始电流测量值。应用比例和偏移量后，单位为毫安。如果不存在偏移量或比例，则输出应被视为以毫安为单位处理过的值。

带有“i”和“q”修饰符的通道总是成对出现，并且两个通道都指向同一个信号。“i”通道包含信号的同相分量，而“q”通道包含正交分量。

/sys/bus/iio/devices/iio:deviceX/in_currentY_raw

/sys/bus/iio/devices/iio:deviceX/in_currentY_supply_raw

在文件 sysfs-bus-iio 中定义

来自通道 Y 的原始（未缩放，无偏置移除等）电流测量值。在通道不对应于外部可用输入的情况下，可以使用指定的版本之一。必须始终指定该数字，并且必须是唯一的，以便与事件代码关联。应用比例和偏移量后的单位为毫安。

/sys/bus/iio/devices/iio:deviceX/in_deltaangl_x_raw

/sys/bus/iio/devices/iio:deviceX/in_deltaangl_y_raw

/sys/bus/iio/devices/iio:deviceX/in_deltaangl_z_raw

在文件 sysfs-bus-iio 中定义

x、y 或 z 轴上两个连续样本之间的角位移（可以任意分配，但应与设备上的其他此类分配匹配）。为了计算所需时间段内的总角位移，应用程序应将该时间段内采集的角位移样本相加。应用比例和偏移量后的单位为弧度。

/sys/bus/iio/devices/iio:deviceX/in_deltavelocity_x_raw

/sys/bus/iio/devices/iio:deviceX/in_deltavelocity_y_raw

/sys/bus/iio/devices/iio:deviceX/in_deltavelocity_z_raw

在文件 sysfs-bus-iio 中定义

x、y 或 z 轴上两个连续样本之间的线速度变化（可以任意分配，但应与设备上的其他此类分配匹配）。为了计算所需时间段内的总线速度变化，应用程序应将该时间段内采集的速度变化样本相加。应用比例和偏移量后的单位为米每秒。

/sys/bus/iio/devices/iio:deviceX/in_electricalconductivity_raw

在文件 sysfs-bus-iio 中定义

原始（未缩放，无偏移等）电导率读数。应用比例和偏移量后的单位为西门子每米。

/sys/bus/iio/devices/iio:deviceX/in_energy_calibweight

在文件 sysfs-bus-iio 中定义

用户的体重（单位为千克）。一些计步器需要它来计算用户燃烧的卡路里。

/sys/bus/iio/devices/iio:deviceX/in_filter_notch_center_frequency

在文件 sysfs-bus-iio 中定义

陷波滤波器的中心频率，单位为 Hz。用于例如抑制线路噪声。

/sys/bus/iio/devices/iio:deviceX/in_gravity_x_raw

/sys/bus/iio/devices/iio:deviceX/in_gravity_y_raw

/sys/bus/iio/devices/iio:deviceX/in_gravity_z_raw

在文件 sysfs-bus-iio 中定义

x、y 或 z 方向上的重力（可以任意分配，但应与设备上的其他此类分配匹配）。应用比例和偏移量后的单位为 m/s^2。

/sys/bus/iio/devices/iio:deviceX/in_gyro_calibration_auto_status

定义于文件 sysfs-bus-iio-bno055

报告陀螺仪传感器的自动校准状态。可以是 0（校准甚至未启用）或 1 到 5，其中数字越大，校准状态越好。

/sys/bus/iio/devices/iio:deviceX/in_gyro_matrix

/sys/bus/iio/devices/iio:deviceX/in_accel_matrix

/sys/bus/iio/devices/iio:deviceX/in_magn_matrix

定义于文件 sysfs-bus-iio-mpu6050

这是运动传感器的安装矩阵。安装矩阵是一个 3x3 的单位矩阵。典型的安装矩阵如下所示：[0, 1, 0; 1, 0, 0; 0, 0, -1]。使用此信息，可以很容易地判断传感器之间的相对位置以及它们相对于容纳这些传感器的电路板的位置。单位矩阵 [1, 0, 0; 0, 1, 0; 0, 0, 1] 表示传感器芯片和设备彼此完全对齐。所有轴都完全相同。

/sys/bus/iio/devices/iio:deviceX/in_humidityrelative_input

在文件 sysfs-bus-iio 中定义

以千分之一百分比为单位的缩放湿度测量值。

/sys/bus/iio/devices/iio:deviceX/in_humidityrelative_raw

在文件 sysfs-bus-iio 中定义

空气的原始湿度测量值。应用比例和偏移量后的单位为千分之一百分比。

/sys/bus/iio/devices/iio:deviceX/in_humidityrelative_trough_raw

/sys/bus/iio/devices/iio:deviceX/in_temp_trough_raw

在文件 sysfs-bus-iio 中定义

自某个复位条件以来的最低值。这些属性允许访问此值，否则它们与 <type>Y[_name]_raw 属性直接等效。

/sys/bus/iio/devices/iio:deviceX/in_illuminance0_zone

在文件 sysfs-bus-iio-light-lm3533-als 中定义

获取由 in_illuminance0_threshY_{falling,rising} 阈值定义的当前光照区域 (0..4)。

/sys/bus/iio/devices/iio:deviceX/in_illuminanceY_calibscale_available

/sys/bus/iio/devices/iio:deviceX/in_intensityY_calibscale_available

/sys/bus/iio/devices/iio:deviceX/in_proximityY_calibscale_available

/sys/bus/iio/devices/iio:deviceX/in_voltageY_calibscale_available

在文件 sysfs-bus-iio 中定义

calibscale 的可用值。可能表示为以下两种形式之一：

  • 像“1 8 16”这样的小的离散值集合

  • 一个范围，指定为“[最小值 步长 最大值]”

如果在所有通道之间共享，则使用 <type>_calibscale_available。

/sys/bus/iio/devices/iio:deviceX/in_illuminance_hysteresis_relative

/sys/bus/iio/devices/iio:deviceX/in_intensity_hysteresis_relative

在文件 sysfs-bus-iio 中定义

指定光传感器相对于通道绝对值的百分比，在该百分比下数据字段应更改，然后才会生成事件。单位是先前读数的百分比。

/sys/bus/iio/devices/iio:deviceX/in_incli_x_raw

/sys/bus/iio/devices/iio:deviceX/in_incli_y_raw

/sys/bus/iio/devices/iio:deviceX/in_incli_z_raw

在文件 sysfs-bus-iio 中定义

关于 x、y 或 z 轴的原始倾斜读数（可以任意分配）。通过应用偏移量和比例将数据转换为度。

/sys/bus/iio/devices/iio:deviceX/in_indexY_raw

在文件 sysfs-bus-iio 中定义

此接口已弃用；请使用计数器子系统。

来自通道 Y 的原始计数器设备索引值。此属性提供了一个绝对位置参考（例如，每转一次脉冲），可用于根据需要对位置系统进行归位。

/sys/bus/iio/devices/iio:deviceX/in_intensityY_offset

定义于文件 sysfs-bus-iio-health-afe440x

获取并设置这些阶段的偏移量消除 DAC 设置。这些值以 5 位符号幅度表示。

/sys/bus/iio/devices/iio:deviceX/in_intensityY_raw

定义于文件 sysfs-bus-iio-health-afe440x

获取这些阶段的 ADC 测量值。Y 是与数据表阶段名称对应的特定阶段编号，如下所示：

1

LED2

2

ALED2/LED3

3

LED1

4

ALED1/LED4

请注意，通道 5 和 6 分别代表 LED2-ALED2 和 LED1-ALED1，它们只是辅助通道，其中包含第 1 - 2 阶段和第 3 - 4 阶段的值的计算差值。这些值以 24 位二进制补码表示。阶段的 LED 电流通过 out_currentY_raw 控制。

/sys/bus/iio/devices/iio:deviceX/in_intensityY_resistance

/sys/bus/iio/devices/iio:deviceX/in_intensityY_capacitance

定义于文件 sysfs-bus-iio-health-afe440x

获取并设置相关阶段期间跨阻放大器的电阻和电容设置。

/sys/bus/iio/devices/iio:deviceX/in_intensity_hardwaregain_available

在文件 sysfs-bus-iio 中定义

列出所有可用的硬件应用增益因子。在所有通道之间共享。

/sys/bus/iio/devices/iio:deviceX/in_intensity_ir_large_raw

定义于文件 sysfs-bus-iio-light-si1133

无单位的红外强度。强度是从 4 个暗光电二极管测量的。“large”表示捕获红外的表面积。

/sys/bus/iio/devices/iio:deviceX/in_intensity_ir_small_raw

定义于文件 sysfs-bus-iio-light-si1133

无单位的红外强度。强度是从 1 个暗光电二极管测量的。“small”表示捕获红外的表面积。

/sys/bus/iio/devices/iio:deviceX/in_intensity_large_raw

定义于文件 sysfs-bus-iio-light-si1133

具有更多二极管的无单位光强度。

/sys/bus/iio/devices/iio:deviceX/in_intensity_x_raw

/sys/bus/iio/devices/iio:deviceX/in_intensity_y_raw

/sys/bus/iio/devices/iio:deviceX/in_intensity_z_raw

在文件 sysfs-bus-iio 中定义

根据 CIE 1931/DIN 5033 颜色空间的未缩放光强度。应用比例后的单位为每平方米纳纳瓦。

/sys/bus/iio/devices/iio:deviceX/in_magn_calibration_auto_status

定义于文件 sysfs-bus-iio-bno055

报告磁力计传感器的自动校准状态。可以是 0（校准甚至未启用）或 1 到 5，其中数字越大，校准状态越好。

/sys/bus/iio/devices/iio:deviceX/in_magn_calibration_fast_enable

定义于文件 sysfs-bus-iio-bno055

可以是 1 或 0。启用/禁用“快速磁力计校准”硬件功能。

/sys/bus/iio/devices/iio:deviceX/in_magn_x_oversampling_ratio

/sys/bus/iio/devices/iio:deviceX/in_magn_y_oversampling_ratio

/sys/bus/iio/devices/iio:deviceX/in_magn_z_oversampling_ratio

在文件 sysfs-bus-iio 中定义

硬件应用测量的次数，用于获取一个数据点。硬件将进行 <type>[_name]_oversampling_ratio 次测量，并返回平均值作为输出数据。从 <type>[_name]_oversampling_ratio 次测量得到的每个值都被视为 <type>[_name]_sampling_frequency 的一个样本。

/sys/bus/iio/devices/iio:deviceX/in_magn_x_raw

/sys/bus/iio/devices/iio:deviceX/in_magn_y_raw

/sys/bus/iio/devices/iio:deviceX/in_magn_z_raw

在文件 sysfs-bus-iio 中定义

沿 x、y 或 z 轴的磁场（可以任意分配）。通过应用偏移量，然后按比例将数据转换为高斯。

/sys/bus/iio/devices/iio:deviceX/in_massconcentration_pm1_input

/sys/bus/iio/devices/iio:deviceX/in_massconcentrationY_pm1_input

/sys/bus/iio/devices/iio:deviceX/in_massconcentration_pm2p5_input

/sys/bus/iio/devices/iio:deviceX/in_massconcentrationY_pm2p5_input

/sys/bus/iio/devices/iio:deviceX/in_massconcentration_pm4_input

/sys/bus/iio/devices/iio:deviceX/in_massconcentrationY_pm4_input

/sys/bus/iio/devices/iio:deviceX/in_massconcentration_pm10_input

/sys/bus/iio/devices/iio:deviceX/in_massconcentrationY_pm10_input

在文件 sysfs-bus-iio 中定义

颗粒物的质量浓度读数，单位为 ug / m3。pmX 由空气动力学直径小于或等于 X 微米的颗粒组成。

/sys/bus/iio/devices/iio:deviceX/in_ph_raw

在文件 sysfs-bus-iio 中定义

作为一升水中氢离子负底数 10 对数的物质的原始（未缩放，无偏移等）pH 值读数。

/sys/bus/iio/devices/iio:deviceX/in_phaseY_raw

在文件 sysfs-bus-iio 中定义

来自通道 Y 的原始（未缩放）相位差读数。应用比例和偏移量后的单位为弧度。

/sys/bus/iio/devices/iio:deviceX/in_positionrelative_x_raw

/sys/bus/iio/devices/iio:deviceX/in_positionrelative_y_raw

在文件 sysfs-bus-iio 中定义

在触摸板上 x 或 y 方向的相对位置（可以任意分配，但应与设备上的其他此类分配匹配）。应用比例和偏移量后的单位为触摸板在两个方向上的尺寸的千分之一百分比。应由消费者校准。

/sys/bus/iio/devices/iio:deviceX/in_powerY_raw

在文件 sysfs-bus-iio 中定义

来自通道 Y 的原始（未缩放，无偏置移除等）功率测量值。必须始终指定该数字，并且必须是唯一的，以便与事件代码关联。应用比例和偏移量后的单位为毫瓦。

/sys/bus/iio/devices/iio:deviceX/in_pressureY_input

/sys/bus/iio/devices/iio:deviceX/in_pressure_input

在文件 sysfs-bus-iio 中定义

通道 Y 的比例压力测量值，单位为千帕。

/sys/bus/iio/devices/iio:deviceX/in_pressureY_raw

/sys/bus/iio/devices/iio:deviceX/in_pressure_raw

在文件 sysfs-bus-iio 中定义

通道 Y 的原始压力测量值。应用比例和偏移量后的单位为千帕。

/sys/bus/iio/devices/iio:deviceX/in_proximity0_agc_gain

/sys/bus/iio/devices/iio:deviceX/in_proximity0_agc_gain_bias

在文件 sysfs-bus-iio-isl29501 中定义

此传感器具有自动增益控制 (agc) 环路，可通过控制可编程增益放大器将模拟信号电平设置为最佳水平。最佳增益的标准由传感器确定。

读取时，返回 [0; 65536] 范围内的实际增益值（整数）。

测量串扰时读取的 agc 增益应写入 in_proximity0_agc_gain_bias。

/sys/bus/iio/devices/iio:deviceX/in_proximity0_calib_phase_temp_a

/sys/bus/iio/devices/iio:deviceX/in_proximity0_calib_phase_temp_b

/sys/bus/iio/devices/iio:deviceX/in_proximity0_calib_phase_light_a

/sys/bus/iio/devices/iio:deviceX/in_proximity0_calib_phase_light_b

在文件 sysfs-bus-iio-isl29501 中定义

传感器能够校正因温度和环境光条件变化引起的距离测量误差。可以对其进行编程，以校正二阶误差多项式。

当温度和环境光独立调制时，必须收集相位数据。

然后，必须从数据中生成二阶多项式的最小二乘曲线拟合。所得曲线的形式为 ax^2 + bx + c。

从这两条曲线中，温度的 a 和 b 系数应存储在 in_proximity0_calib_phase_temp_a 和 in_proximity0_calib_phase_temp_b 中，而环境光的 a 和 b 系数应存储在 in_proximity0_calib_phase_light_a 和 in_proximity0_calib_phase_light_b 中。

这些值必须是 [0; 8355840] 范围内的整数。

最后，常数 c 由传感器内部设置。

从传感器读取时，会显示存储在其中的值。

/sys/bus/iio/devices/iio:deviceX/in_proximity3_comb_raw

在文件 sysfs-bus-iio-sx9310 中定义

指示某些物体靠近组合传感器的接近度测量值。组合传感器呈现的接近度测量值是通过硬件组合从一组给定的物理传感器获取的测量值构建的。

/sys/bus/iio/devices/iio:deviceX/in_proximity<id>_setup

在文件 sysfs-bus-iio-sx9324 中定义

SX9324 有 3 个输入：CS0、CS1 和 CS2。硬件布局定义输入是否

  • 未连接 (HZ)，

  • 接地 (GD)，

  • 连接到天线，其中天线可以充当基座（DS - 数据屏蔽）或测量输入 (MI)。

传感器在 4 个相位（PH0、PH1、PH2、PH3）上轮流测量，在每个相位中，输入都会被配置然后进行测量。

默认情况下，在第一相位 [PH0] 期间，测量 CS0，而 CS1 和 CS2 用作屏蔽。cat in_proximity0_setup 返回 “MI,DS,DS”。在 [PH1] 中，测量 CS1，CS0 和 CS2 用作屏蔽：cat in_proximity1_setup 返回 “DS,MI,DS”。在 [PH2] 中，测量 CS2，CS0 和 CS1 用作屏蔽：cat in_proximity1_setup 返回 “DS,DS,MI”。在 [PH3] 中，测量 CS1 和 CS2（组合模式）：cat in_proximity1_setup 返回 “DS,MI,MI”。

请注意，这些是芯片的默认设置。硬件布局很可能会决定不同的输出。该条目为只读。

/sys/bus/iio/devices/iio:deviceX/in_proximity_input

在文件 sysfs-bus-iio-proximity-as3935 中定义

获取风暴的当前距离（以米为单位，步长为 1 公里）1000-40000 = 以米为单位的距离

当噪声水平超过跳变水平且不报告有效数据时，/sys/bus/iio/devices/iio:deviceX/noise_level_tripped 的值为 1

/sys/bus/iio/devices/iio:deviceX/in_proximity_nearlevel

在文件 sysfs-bus-iio-proximity 中定义

接近度传感器的近距离水平。这是一个整数值，用于告知用户空间何时应将物体视为靠近设备。如果从传感器读取的值大于或等于此文件中的值，则通常应将物体视为靠近。

/sys/bus/iio/devices/iio:deviceX/in_resistance_raw

/sys/bus/iio/devices/iio:deviceX/in_resistanceX_raw

/sys/bus/iio/devices/iio:deviceX/out_resistance_raw

/sys/bus/iio/devices/iio:deviceX/out_resistanceX_raw

在文件 sysfs-bus-iio 中定义

原始（未缩放，无偏移等）电阻读数。应用比例和偏移量后的单位为欧姆。

/sys/bus/iio/devices/iio:deviceX/in_rot_from_north_magnetic_tilt_comp_raw

/sys/bus/iio/devices/iio:deviceX/in_rot_from_north_true_tilt_comp_raw

/sys/bus/iio/devices/iio:deviceX/in_rot_from_north_magnetic_raw

/sys/bus/iio/devices/iio:deviceX/in_rot_from_north_true_raw

在文件 sysfs-bus-iio 中定义

从真北/磁北测量的原始旋转值，带有或不带有倾斜传感器的补偿。

/sys/bus/iio/devices/iio:deviceX/in_rot_quaternion_raw

在文件 sysfs-bus-iio 中定义

使用 x y z w 格式的四元数分量的原始值。其中 x、y 和 z 分量表示发生旋转的轴，而 w 分量表示旋转量。

/sys/bus/iio/devices/iio:deviceX/in_rot_yaw_raw

/sys/bus/iio/devices/iio:deviceX/in_rot_pitch_raw

/sys/bus/iio/devices/iio:deviceX/in_rot_roll_raw

在文件 sysfs-bus-iio 中定义

原始（未缩放）欧拉角读数。应用比例后的单位为度。

/sys/bus/iio/devices/iio:deviceX/in_shunt_resistorY

在文件 sysfs-bus-iio-adc-pac1934 中定义

分流电阻的值可能仅在运行时知道，并且由客户端应用程序设置。此属性允许以微欧姆为单位设置其值。X 是设备的 IIO 索引。Y 是通道号。该值用于计算电流、功率和累积能量。

/sys/bus/iio/devices/iio:deviceX/in_temp8_raw

定义于文件 sysfs-bus-iio-adc-mt6360

指示 MT6360 IC 结温，使用比例和偏移量计算后返回以度为单位的温度

/sys/bus/iio/devices/iio:deviceX/in_tempY_input

/sys/bus/iio/devices/iio:deviceX/in_temp_input

在文件 sysfs-bus-iio 中定义

以毫摄氏度为单位的缩放温度测量值。

/sys/bus/iio/devices/iio:deviceX/in_temp_calibemissivity

/sys/bus/iio/devices/iio:deviceX/in_tempX_calibemissivity

/sys/bus/iio/devices/iio:deviceX/in_temp_object_calibemissivity

/sys/bus/iio/devices/iio:deviceX/in_tempX_object_calibemissivity

在文件 sysfs-bus-iio 中定义

非接触式温度传感器视场中表面的发射率。发射率介于 0 到 1 之间，其中 1 是黑体的发射率。

/sys/bus/iio/devices/iio:deviceX/in_temp_object_calibambient

/sys/bus/iio/devices/iio:deviceX/in_tempX_object_calibambient

在文件 sysfs-bus-iio 中定义

用于对象温度计算的校准环境温度，单位为毫摄氏度。

/sys/bus/iio/devices/iio:deviceX/in_temp_raw

/sys/bus/iio/devices/iio:deviceX/in_tempX_raw

/sys/bus/iio/devices/iio:deviceX/in_temp_x_raw

/sys/bus/iio/devices/iio:deviceX/in_temp_y_raw

/sys/bus/iio/devices/iio:deviceX/in_temp_ambient_raw

/sys/bus/iio/devices/iio:deviceX/in_temp_object_raw

在文件 sysfs-bus-iio 中定义

原始（未缩放，无偏差消除等）温度测量值。如果指定了轴，则通常表示温度传感器与复合设备（例如，陀螺仪轴）的某个部分相关联。环境和对象修饰符区分了非接触式测量的环境（参考）温度和远处温度。应用比例和偏移量后的单位为毫摄氏度。

/sys/bus/iio/devices/iio:deviceX/in_temp_thermocouple_type

在文件 sysfs-bus-iio 中定义

以下热电偶类型之一：B、E、J、K、N、R、S、T。

/sys/bus/iio/devices/iio:deviceX/in_voltage0_raw

定义于文件 sysfs-bus-iio-adc-mt6360

指示连接到连接器 ID 引脚的 MT6360 USBID ADC。使用比例和偏移量计算后返回以微伏为单位的电压

/sys/bus/iio/devices/iio:deviceX/in_voltage10_raw

定义于文件 sysfs-bus-iio-adc-mt6360

指示 MT6360 TS ADC。使用比例和偏移量计算后返回以微伏为单位的电压

/sys/bus/iio/devices/iio:deviceX/in_voltage1_raw

定义于文件 sysfs-bus-iio-adc-mt6360

指示 MT6360 VBUS ADC，精度较低（+-75mA），测量范围较高（1~22mV）。使用比例和偏移量计算后返回以微伏为单位的电压

/sys/bus/iio/devices/iio:deviceX/in_voltage2-voltage2_shorted_raw

定义于文件 sysfs-bus-iio-adc-ad7192

测量来自连接到 AIN(+) 和 AIN(-) 短路的 AIN2 引脚的电压。

/sys/bus/iio/devices/iio:deviceX/in_voltage2_raw

定义于文件 sysfs-bus-iio-adc-mt6360

指示 MT6360 VBUS ADC，精度较高（+-30mA），测量范围较低（1~9.76V）。使用比例和偏移量计算后返回以微伏为单位的电压

/sys/bus/iio/devices/iio:deviceX/in_voltage3_raw

定义于文件 sysfs-bus-iio-adc-mt6360

指示 MT6360 VSYS ADC。使用比例和偏移量计算后返回以微伏为单位的电压

/sys/bus/iio/devices/iio:deviceX/in_voltage4_raw

定义于文件 sysfs-bus-iio-adc-mt6360

指示 MT6360 VBAT ADC。使用比例和偏移量计算后返回以微伏为单位的电压

/sys/bus/iio/devices/iio:deviceX/in_voltage9_raw

定义于文件 sysfs-bus-iio-adc-mt6360

指示 MT6360 VREF_TS ADC。使用比例和偏移量计算后返回以微伏为单位的电压

/sys/bus/iio/devices/iio:deviceX/in_voltageX_sampling_frequency

/sys/bus/iio/devices/iio:deviceX/in_powerY_sampling_frequency

/sys/bus/iio/devices/iio:deviceX/in_currentZ_sampling_frequency

在文件 sysfs-bus-iio 中定义

某些设备对各个通道的采样频率具有单独的控制。如果扫描中启用了多个通道，则可以从每个通道的采样频率计算扫描的 sampling_frequency。

/sys/bus/iio/devices/iio:deviceX/in_voltageY-voltageZ_balance_switch_en

在文件 sysfs-bus-iio-adc-ad7280a 中定义

用于启用一个输出，以便通过 in_voltage_Y-voltageZ_balance_switch_timer 定时控制平衡单元。

/sys/bus/iio/devices/iio:deviceX/in_voltageY-voltageZ_balance_switch_timer

在文件 sysfs-bus-iio-adc-ad7280a 中定义

平衡开关将打开的时间（以秒为单位）。71.5 秒的倍数。

/sys/bus/iio/devices/iio:deviceX/in_voltageY-voltageZ_raw

在文件 sysfs-bus-iio 中定义

与通道 Y - 通道 Z 等效的原始（未缩放）差分电压测量值，其中这些通道号适用于非差分读数单独可用时物理上等效的输入。在仅限差分的部分中，只需要一致的标签。应用比例和偏移量后的单位为毫伏。

/sys/bus/iio/devices/iio:deviceX/in_voltageY_dither_enable

在文件 sysfs-bus-iio-dac-ad5766 中定义

抖动启用。写入 1 以启用抖动，写入 0 以禁用抖动。

/sys/bus/iio/devices/iio:deviceX/in_voltageY_dither_invert

在文件 sysfs-bus-iio-dac-ad5766 中定义

反转应用于所选 DAC 通道的抖动。默认情况下，抖动不反转。写入 “1” 以反转抖动。

/sys/bus/iio/devices/iio:deviceX/in_voltageY_dither_scale

在文件 sysfs-bus-iio-dac-ad5766 中定义

在将抖动应用于所选通道之前对其进行缩放。

/sys/bus/iio/devices/iio:deviceX/in_voltageY_dither_scale_available

在文件 sysfs-bus-iio-dac-ad5766 中定义

返回当前通道可用的可能缩放比例。

/sys/bus/iio/devices/iio:deviceX/in_voltageY_dither_source

在文件 sysfs-bus-iio-dac-ad5766 中定义

选择应用于所选通道的抖动源。写入 “0” 以选择 N0 源，写入 “1” 以选择 N1 源。

/sys/bus/iio/devices/iio:deviceX/in_voltageY_label

/sys/bus/iio/devices/iio:deviceX/out_voltageY_label

在文件 sysfs-bus-iio 中定义

设备通道的可选符号标签。如果为此通道定义了标签，请将其添加到特定于通道的属性中。这对于用户空间来说很有用，可以更好地识别单个通道。

/sys/bus/iio/devices/iio:deviceX/in_voltageY_raw

/sys/bus/iio/devices/iio:deviceX/in_voltageY_supply_raw

/sys/bus/iio/devices/iio:deviceX/in_voltageY_i_raw

/sys/bus/iio/devices/iio:deviceX/in_voltageY_q_raw

在文件 sysfs-bus-iio 中定义

通道 Y 的原始（未缩放、无偏差去除等）电压测量值。在通道不对应于外部可用输入的情况下，可以使用指定的版本之一。 必须始终指定数字并保持唯一，以便与事件代码关联。 应用缩放和偏移后的单位为毫伏。

带有“i”和“q”修饰符的通道总是成对出现，并且两个通道都指向同一个信号。“i”通道包含信号的同相分量，而“q”通道包含正交分量。

/sys/bus/iio/devices/iio:deviceX/in_voltageY_scale

/sys/bus/iio/devices/iio:deviceX/in_voltageY_i_scale

/sys/bus/iio/devices/iio:deviceX/in_voltageY_q_scale

/sys/bus/iio/devices/iio:deviceX/in_voltageY_supply_scale

/sys/bus/iio/devices/iio:deviceX/in_voltage_scale

/sys/bus/iio/devices/iio:deviceX/in_voltage_i_scale

/sys/bus/iio/devices/iio:deviceX/in_voltage_q_scale

/sys/bus/iio/devices/iio:deviceX/in_voltage-voltage_scale

/sys/bus/iio/devices/iio:deviceX/out_voltageY_scale

/sys/bus/iio/devices/iio:deviceX/out_altvoltageY_scale

/sys/bus/iio/devices/iio:deviceX/in_currentY_scale

/sys/bus/iio/devices/iio:deviceX/in_currentY_supply_scale

/sys/bus/iio/devices/iio:deviceX/in_current_scale

/sys/bus/iio/devices/iio:deviceX/in_currentY_i_scale

/sys/bus/iio/devices/iio:deviceX/in_currentY_q_scale

/sys/bus/iio/devices/iio:deviceX/in_current_i_scale

/sys/bus/iio/devices/iio:deviceX/in_current_q_scale

/sys/bus/iio/devices/iio:deviceX/in_accel_scale

/sys/bus/iio/devices/iio:deviceX/in_accel_peak_scale

/sys/bus/iio/devices/iio:deviceX/in_anglvel_scale

/sys/bus/iio/devices/iio:deviceX/in_energy_scale

/sys/bus/iio/devices/iio:deviceX/in_distance_scale

/sys/bus/iio/devices/iio:deviceX/in_magn_scale

/sys/bus/iio/devices/iio:deviceX/in_magn_x_scale

/sys/bus/iio/devices/iio:deviceX/in_magn_y_scale

/sys/bus/iio/devices/iio:deviceX/in_magn_z_scale

/sys/bus/iio/devices/iio:deviceX/in_rot_from_north_magnetic_scale

/sys/bus/iio/devices/iio:deviceX/in_rot_from_north_true_scale

/sys/bus/iio/devices/iio:deviceX/in_rot_from_north_magnetic_tilt_comp_scale

/sys/bus/iio/devices/iio:deviceX/in_rot_from_north_true_tilt_comp_scale

/sys/bus/iio/devices/iio:deviceX/in_pressureY_scale

/sys/bus/iio/devices/iio:deviceX/in_pressure_scale

/sys/bus/iio/devices/iio:deviceX/in_humidityrelative_scale

/sys/bus/iio/devices/iio:deviceX/in_velocity_sqrt(x^2+y^2+z^2)_scale

/sys/bus/iio/devices/iio:deviceX/in_illuminance_scale

/sys/bus/iio/devices/iio:deviceX/in_countY_scale

/sys/bus/iio/devices/iio:deviceX/in_deltaangl_scale

/sys/bus/iio/devices/iio:deviceX/in_deltavelocity_scale

/sys/bus/iio/devices/iio:deviceX/in_angl_scale

/sys/bus/iio/devices/iio:deviceX/in_intensity_x_scale

/sys/bus/iio/devices/iio:deviceX/in_intensity_y_scale

/sys/bus/iio/devices/iio:deviceX/in_intensity_z_scale

/sys/bus/iio/devices/iio:deviceX/in_concentration_co2_scale

在文件 sysfs-bus-iio 中定义

如果已知设备的比例因子，则将其应用于 <type>Y[_name]_raw 并加上 <type>[Y][_name]_offset，以获得 <type>[Y][_name]_raw 文档中指定的 <type> 单位的测量值。 如果在所有输入通道之间共享，则不存在 Y 和 <x|y|z>，该值称为 <type>[Y][_name]_scale。 peak 修饰符表示此值应用于 <type>Y[_name]_peak_raw 值。

/sys/bus/iio/devices/iio:deviceX/in_voltageY_sensing_mode

定义在文件sysfs-bus-iio-adc-hi8435中

为阈值检测器输入设置传感器类型。可以是“GND-Open”或“Supply-Open”模式。 Y 是一个阈值检测器输入通道。 通道 0..7、8..15、16..23 和 24..31 具有通用的传感器类型。

/sys/bus/iio/devices/iio:deviceX/in_voltage_filterY_notch_center

在文件 sysfs-bus-iio-adc-max11410 中定义

陷波滤波器的中心频率，单位为 Hz。

/sys/bus/iio/devices/iio:deviceX/in_voltage_filterY_notch_en

在文件 sysfs-bus-iio-adc-max11410 中定义

启用或禁用陷波滤波器。

/sys/bus/iio/devices/iio:deviceX/in_voltage_spi_clk_freq

在文件 sysfs-bus-iio-dfsdm-adc-stm32 中定义

仅用于音频目的。

音频驱动程序使用此属性来设置/获取 SPI 输入频率。

如果 DFSDM 是 SPI 总线上的从设备，则这是强制性的，以在运行时提供有关 SPI 时钟频率的信息。请注意，SPI 频率应为采样频率的倍数，以确保精度。

如果 DFSDM 输入是 SPI 主设备

读取 SPI 时钟输出频率，写入时出错

如果 DFSDM 输入是 SPI 从设备

读取返回先前设置的值。 在开始转换之前写入值。

/sys/bus/iio/devices/iio:deviceX/in_voltagex_sys_calibration

定义于文件 sysfs-bus-iio-adc-ad7192

启动系统校准过程。 这次在单个通道上完成。 写入“1”以开始校准。

/sys/bus/iio/devices/iio:deviceX/in_voltagex_sys_calibration_mode

定义于文件 sysfs-bus-iio-adc-ad7192

设置系统校准过程中使用的校准模式。 读取将返回当前的校准模式。 写入将设置系统校准模式。

/sys/bus/iio/devices/iio:deviceX/in_voltagex_sys_calibration_mode_available

定义于文件 sysfs-bus-iio-adc-ad7192

读取将返回一个包含可用校准模式的列表。 有两个可用选项：“zero_scale”（校准到零刻度）和“full_scale”（校准到满刻度）

/sys/bus/iio/devices/iio:deviceX/label

在文件 sysfs-bus-iio 中定义

设备的 可选符号标签。 这对于用户空间能够更好地识别单个设备很有用。

标签的内容是自由格式的，但有一些标准化的用法

对于给出与某个 WLAN 或 WWAN 天线的人的接近程度的接近传感器，使用以下标准化标签

  • “proximity-wifi”

  • “proximity-lte”

  • “proximity-wifi-lte”

  • “proximity-wifi-left”

  • “proximity-wifi-right”

这些用于向用户空间指示，可以使用这些接近传感器来调整发射功率，以确保符合特定吸收率 (SAR) 限制。“-left”和“-right”标签用于具有多个天线的设备。

在某些笔记本电脑/平板电脑中，标准化的接近传感器标签改为指示与设备特定部分的接近程度

  • “proximity-palmrest”表示与键盘掌托的接近程度

  • “proximity-palmrest-left”表示与掌托左侧的接近程度

  • “proximity-palmrest-right”表示与掌托右侧的接近程度

  • “proximity-lap”表示设备正在某人的膝盖上使用

请注意，“proximity-lap”很特殊，它的值可能由固件根据其他传感器读数计算得出，而不是原始传感器读数。

对于在带有 360°（瑜伽式）铰链的二合一设备中使用的加速度计，这些设备在其底座和显示屏中都有一个加速度计，请使用以下标准化标签

  • “accel-base”

  • “accel-display”

对于加速度计安装在旋转摄像头子组件（用于 AR 应用程序）中的设备，请使用以下标准化标签

  • “accel-camera”

/sys/bus/iio/devices/iio:deviceX/location

定义于文件 sysfs-bus-iio-cros-ec

此属性返回一个字符串，其中包含运动传感器的物理位置。 例如，在笔记本电脑中，运动传感器可以位于底座或盖子上。 当前有效值为“base”和“lid”。

/sys/bus/iio/devices/iio:deviceX/meas_conf

/sys/bus/iio/devices/iio:deviceX/meas_conf_available

在文件 sysfs-bus-iio-magnetometer-hmc5843 中定义

偏置电流的当前配置和可用配置。

正常

正常测量配置（默认）

positivebias

正偏置配置

negativebias

负偏置配置

disabled

仅在 HMC5983 上可用。 禁用磁传感器并启用温度传感器。
注意

此配置的效果可能因设备而异。 有关确切的文档，请查看设备的数据手册。

/sys/bus/iio/devices/iio:deviceX/mount_matrix

/sys/bus/iio/devices/iio:deviceX/in_mount_matrix

/sys/bus/iio/devices/iio:deviceX/out_mount_matrix

/sys/bus/iio/devices/iio:deviceX/in_anglvel_mount_matrix

/sys/bus/iio/devices/iio:deviceX/in_accel_mount_matrix

在文件 sysfs-bus-iio 中定义

IIO 传感器的安装矩阵。 这是一个旋转矩阵，它向用户空间告知传感器芯片相对于其安装到的主硬件的放置位置。

主硬件的放置位置是根据传感器测量的物理量相关的局部参考系定义的。

由于旋转矩阵是以板特定的方式（平台数据和/或设备树）定义的，因此主硬件参考系的定义留给实现者选择（有关磁力计示例，请参见下文）。

应用程序应将此旋转矩阵应用于样本，以便当主硬件参考系与局部参考系对齐时，传感器芯片参考系也与之完全对齐。

矩阵是 3x3 单位矩阵，通常类似于 [0, 1, 0; 1, 0, 0; 0, 0, -1]。 单位矩阵 [1, 0, 0; 0, 1, 0; 0, 0, 1] 表示传感器芯片和主硬件彼此完全对齐。

例如，磁力计传感器的安装矩阵向用户空间告知传感器芯片相对于主硬件的 方向。

更具体地说，主硬件的方向是相对于 本地地球地磁参考系 定义的，其中

  • Y 在地面平面内，且向磁北为正；

  • X 在地面平面内，垂直于北轴，且向东为正；

  • Z 垂直于地面平面，且向上为正。

实现者可能会认为，对于手持设备，“自然”方向将是“前置摄像头在顶部”。 然后，可以将主硬件参考系描述为

  • Y 在屏幕平面内，且向屏幕顶部为正；

  • X 在屏幕平面内，垂直于 Y 轴，且向屏幕右侧为正；

  • Z 垂直于屏幕平面，且从屏幕向外为正。

四旋翼无人机的另一个例子可能是

  • Y 在螺旋桨平面内，且朝向前置摄像头为正；

  • X 在螺旋桨平面内，垂直于 Y 轴，且向无人机的右舷侧为正；

  • Z 垂直于螺旋桨平面，且向上为正。

/sys/bus/iio/devices/iio:deviceX/name

在文件 sysfs-bus-iio 中定义

设备 X 的物理芯片/设备的描述。 通常是部件号。

/sys/bus/iio/devices/iio:deviceX/out_altvoltageY_frequency

在文件 sysfs-bus-iio 中定义

通道 Y 的输出频率，单位为 Hz。 如果输出对应于单个通道，则必须始终指定数字并保持唯一。 某些驱动程序有其他约束：ADF4371 有一个集成的 VCO，其基本输出频率范围为 4000000000 Hz 至 8000000000 Hz。

out_altvoltage0_frequency

分频为 1、2、4、8、16、32 或电路生成从 62500000 Hz 到 8000000000 Hz 的频率。

out_altvoltage1_frequency

此通道复制通道 0 的频率

out_altvoltage2_frequency

倍频器生成从 8000000000 Hz 到 16000000000 Hz 的频率。

out_altvoltage3_frequency

四倍频器生成从 16000000000 Hz 到 32000000000 Hz 的频率。

注意：写入其中一个通道将影响所有其他通道的频率，因为它涉及更改 VCO 的基本输出频率。

/sys/bus/iio/devices/iio:deviceX/out_altvoltageY_frequency_increment

在文件 sysfs-bus-iio-impedance-analyzer-ad5933 中定义

扫描中连续频率点之间的频率增量，单位为 Hz（步长）。

/sys/bus/iio/devices/iio:deviceX/out_altvoltageY_frequency_points

在文件 sysfs-bus-iio-impedance-analyzer-ad5933 中定义

频率扫描中的频率点数（步数）。 此值与 out_altvoltageY_frequency_start 和 out_altvoltageY_frequency_increment 结合使用，确定扫描操作的频率扫描范围。

/sys/bus/iio/devices/iio:deviceX/out_altvoltageY_frequency_resolution

在文件 sysfs-bus-iio-frequency-adf4350 中定义

存储通道 Y 的频率分辨率/通道间距，单位为 Hz。 给出的值直接影响分数 N PLL 使用的 MODULUS。 假设用于计算各种分频器的算法能够为通道间距的倍数生成适当的值。

/sys/bus/iio/devices/iio:deviceX/out_altvoltageY_frequency_start

在文件 sysfs-bus-iio-impedance-analyzer-ad5933 中定义

频率扫描起始频率，单位为 Hz。

/sys/bus/iio/devices/iio:deviceX/out_altvoltageY_name

在文件 sysfs-bus-iio-frequency-adf4371 中定义

读取将返回通道 Y 的数据手册名称

out_altvoltage0_name: RF8x
out_altvoltage1_name: RFAUX8x
out_altvoltage2_name: RF16x
out_altvoltage3_name: RF32x

/sys/bus/iio/devices/iio:deviceX/out_altvoltageY_phase

在文件 sysfs-bus-iio 中定义

设备 X 的一个频率/时钟输出 Y (out_altvoltageY) 相对于另一个频率/时钟输出 (out_altvoltageZ) 的相位，单位为弧度。 如果输出对应于单个通道，则必须始终指定数字并保持唯一。

/sys/bus/iio/devices/iio:deviceX/out_altvoltageY_refin_frequency

在文件 sysfs-bus-iio-frequency-adf4350 中定义

设置通道 Y 的 REFin 频率，单位为 Hz。在某些时钟链应用中，PLL 使用的参考频率可能会在运行时发生变化。此属性允许用户相应地调整参考频率。写入的值在 out_altvoltageY_frequency 更新之前不会生效。请考虑在 REFin 更改期间使用 out_altvoltageY_powerdown 来关闭 PLL 及其 RFOut 缓冲器的电源。

/sys/bus/iio/devices/iio:deviceX/out_altvoltageY_settling_cycles

在文件 sysfs-bus-iio-impedance-analyzer-ad5933 中定义

输出激励周期数（建立时间周期），允许其在每次频率增量之后，在 ADC 被触发以执行响应信号的转换序列之前，通过未知阻抗。

/sys/bus/iio/devices/iio:deviceX/out_conversion_mode

在文件 sysfs-bus-iio-vf610 中定义

指定 DAC 内使用的硬件转换模式。两种可用模式为“高功率”和“低功率”，其中“低功率”模式为默认模式。

/sys/bus/iio/devices/iio:deviceX/out_currentY_currentZ_raw

在文件 sysfs-bus-iio-light-lm3533-als 中定义

设置区域 Z (0..255) 中通道 out_currentY 的输出电流，其中 Y 为 0..2，Z 为 0..4。

这些值对应于 ALS-mapper Y + 1 的 ALS-mapper 目标寄存器。

请注意，out_currentY_raw 提供当前区域的电流。

/sys/bus/iio/devices/iio:deviceX/out_currentY_raw

在文件 sysfs-bus-iio 中定义

设置/获取通道 Y 的输出电流。应用比例和偏移量后的单位为毫安。对于某些设备，电流通道用于指定提供给用于测量不同类型的元素的电流。例如，LED 电流。

/sys/bus/iio/devices/iio:deviceX/out_currentY_rawN

在文件 sysfs-bus-iio-dac 中定义

此属性的含义与 out_currentY_raw 相同。它特定于启用切换的通道，并引用 INPUT_N (_rawN) 中的 DAC 输出代码，其中 N 是符号的整数值。与 out_currentY_raw 中相同的比例和偏移量适用。

/sys/bus/iio/devices/iio:deviceX/out_currentY_symbol

在文件 sysfs-bus-iio-dac 中定义

执行到预定义输出符号的 SW 开关。此属性特定于启用切换的通道，并允许在多个预定义符号之间切换。每个符号对应于不同的输出，表示为 out_currentY_rawN，其中 N 是符号的整数值。写入整数值 N 将选择 out_currentY_rawN。

/sys/bus/iio/devices/iio:deviceX/out_currentY_toggle_en

在文件 sysfs-bus-iio-dac 中定义

切换使能。写入 1 以启用切换，或写入 0 以禁用它。当想要更改 DAC 输出代码时，此操作很有用。对于自主切换，应该执行以下操作

  • 禁用切换操作；

  • 更改 out_currentY_rawN，其中 N 是符号的整数值；

  • 启用切换操作。

/sys/bus/iio/devices/iio:deviceX/out_current_heater_raw

/sys/bus/iio/devices/iio:deviceX/out_current_heater_raw_available

在文件 sysfs-bus-iio-humidity 中定义

控制湿度传感器内的加热器设备，以去除多余的冷凝水。

在某些设备中，这只是一个开关，在这种情况下，0 = 关闭，1 = 打开。

/sys/bus/iio/devices/iio:deviceX/out_humidityrelative_raw

在文件 sysfs-bus-iio-chemical-sgp40 中定义

设置相对湿度。此值将发送到传感器以进行湿度补偿。默认值：50000（50% 相对湿度）

/sys/bus/iio/devices/iio:deviceX/out_resistance_raw_available

在文件 sysfs-bus-iio-potentiometer-mcp4531 中定义

可用值的范围表示为最小值、步长和最大值，所有值都括在方括号中。示例：[0 1 256]

/sys/bus/iio/devices/iio:deviceX/out_temp_raw

在文件 sysfs-bus-iio-chemical-sgp40 中定义

设置温度。此值将发送到传感器以进行温度补偿。默认值：25000（25 °C）

/sys/bus/iio/devices/iio:deviceX/out_voltageY&Z_raw

/sys/bus/iio/devices/iio:deviceX/out_altvoltageY&Z_raw

在文件 sysfs-bus-iio 中定义

通道 Y、通道 Z 等的聚合的原始（未缩放，无偏置等）输出电压。在单个输出同时设置多个通道的值的情况下，此接口可用。

/sys/bus/iio/devices/iio:deviceX/out_voltageY_dither_en

在文件 sysfs-bus-iio-dac-ltc2688 中定义

抖动使能。写入 1 以启用抖动，或写入 0 以禁用它。这对于更改抖动参数很有用。应该执行以下操作

  • 禁用抖动操作；

  • 更改抖动参数（例如：频率、相位...）；

  • 启用抖动操作

/sys/bus/iio/devices/iio:deviceX/out_voltageY_dither_frequency

在文件 sysfs-bus-iio-dac-ltc2688 中定义

设置抖动信号频率。单位为 Hz。

/sys/bus/iio/devices/iio:deviceX/out_voltageY_dither_frequency_available

在文件 sysfs-bus-iio-dac-ltc2688 中定义

返回抖动频率的可用值。

/sys/bus/iio/devices/iio:deviceX/out_voltageY_dither_offset

在文件 sysfs-bus-iio-dac-ltc2688 中定义

应用于 out_voltageY_dither_raw 的偏移量。只读属性始终设置为 0。

/sys/bus/iio/devices/iio:deviceX/out_voltageY_dither_phase

在文件 sysfs-bus-iio-dac-ltc2688 中定义

设置抖动信号相位。单位为弧度。

/sys/bus/iio/devices/iio:deviceX/out_voltageY_dither_phase_available

在文件 sysfs-bus-iio-dac-ltc2688 中定义

返回抖动相位的可用值。

/sys/bus/iio/devices/iio:deviceX/out_voltageY_dither_raw

在文件 sysfs-bus-iio-dac-ltc2688 中定义

此原始、未缩放的值是指抖动信号幅度。与 out_voltageY_raw 中相同的比例适用。但是，偏移量可能不同，因为此属性的偏移量始终为 0。

/sys/bus/iio/devices/iio:deviceX/out_voltageY_dither_raw_available

在文件 sysfs-bus-iio-dac-ltc2688 中定义

抖动原始幅度值的可用范围。

/sys/bus/iio/devices/iio:deviceX/out_voltageY_hardwaregain

/sys/bus/iio/devices/iio:deviceX/in_intensity_hardwaregain

/sys/bus/iio/devices/iio:deviceX/in_intensity_red_hardwaregain

/sys/bus/iio/devices/iio:deviceX/in_intensity_green_hardwaregain

/sys/bus/iio/devices/iio:deviceX/in_intensity_blue_hardwaregain

/sys/bus/iio/devices/iio:deviceX/in_intensity_clear_hardwaregain

在文件 sysfs-bus-iio 中定义

硬件应用的增益系数。如果跨所有通道共享，则使用 <type>_hardwaregain。

/sys/bus/iio/devices/iio:deviceX/out_voltageY_operating_mode

在文件 sysfs-bus-iio-ad9739a 中定义

DAC 工作模式。可以选择以下模式之一

  • normal：这是 DAC 正常模式。

  • mixed-mode：在此模式下，输出在

    DAC 采样率。这具有降低基波信号功率，同时增加以 DAC 采样率居中的图像功率的效果，从而提高这些图像的输出功率。

/sys/bus/iio/devices/iio:deviceX/out_voltageY_operating_mode_available

在文件 sysfs-bus-iio-ad9739a 中定义

可用的工作模式。

/sys/bus/iio/devices/iio:deviceX/out_voltageY_powerdown_mode

/sys/bus/iio/devices/iio:deviceX/out_voltage_powerdown_mode

/sys/bus/iio/devices/iio:deviceX/out_altvoltageY_powerdown_mode

/sys/bus/iio/devices/iio:deviceX/out_altvoltage_powerdown_mode

在文件 sysfs-bus-iio 中定义

指定输出掉电模式。DAC 输出级与放大器断开连接，1kohm_to_gnd：通过 1kOhm 电阻接地，2.5kohm_to_gnd：通过 2.5kOhm 电阻接地，6kohm_to_gnd：通过 6kOhm 电阻接地，20kohm_to_gnd：通过 20kOhm 电阻接地，42kohm_to_gnd：通过 42kOhm 电阻接地，90kohm_to_gnd：通过 90kOhm 电阻接地，100kohm_to_gnd：通过 100kOhm 电阻接地，125kohm_to_gnd：通过 125kOhm 电阻接地，500kohm_to_gnd：通过 500kOhm 电阻接地，640kohm_to_gnd：通过 640kOhm 电阻接地，three_state：保持浮动。有关可用输出掉电选项的列表，请读取 outX_powerdown_mode_available。如果 Y 不存在，则该模式将在所有输出之间共享。

/sys/bus/iio/devices/iio:deviceX/out_voltageY_powerdown

/sys/bus/iio/devices/iio:deviceX/out_voltage_powerdown

/sys/bus/iio/devices/iio:deviceX/out_altvoltageY_powerdown

/sys/bus/iio/devices/iio:deviceX/out_altvoltage_powerdown

在文件 sysfs-bus-iio 中定义

写入 1 会导致输出 Y 进入相应的 outY_powerdown_mode 指定的掉电模式。DAC 输出级与放大器断开连接。清除操作将返回正常运行。如果所有输出都一起控制，则可以抑制 Y。

/sys/bus/iio/devices/iio:deviceX/out_voltageY_rawN

在文件 sysfs-bus-iio-dac 中定义

此属性的含义与 out_currentY_raw 相同。它特定于启用切换的通道，并引用 INPUT_N (_rawN) 中的 DAC 输出代码，其中 N 是符号的整数值。与 out_currentY_raw 中相同的比例和偏移量适用。

/sys/bus/iio/devices/iio:deviceX/out_voltageY_raw_available

在文件 sysfs-bus-iio-dac-dpot-dac 中定义

可用值的范围表示为最小值、步长和最大值，所有值都括在方括号中。示例：[0 1 256]

/sys/bus/iio/devices/iio:deviceX/out_voltageY_raw

/sys/bus/iio/devices/iio:deviceX/out_altvoltageY_raw

在文件 sysfs-bus-iio 中定义

通道 Y 的原始（未缩放，无偏置等）输出电压。如果输出对应于单个通道，则必须始终指定该数字并且该数字必须是唯一的。虽然像 DAC 这样的设备通常使用 out_voltage，但连续频率生成设备（如 DDS 或 PLL）应使用 out_altvoltage。

/sys/bus/iio/devices/iio:deviceX/out_voltageY_symbol

在文件 sysfs-bus-iio-dac 中定义

执行到预定义输出符号的 SW 开关。此属性特定于启用切换的通道，并允许在多个预定义符号之间切换。每个符号对应于不同的输出，表示为 out_voltageY_rawN，其中 N 是符号的整数值。写入整数值 N 将选择 out_voltageY_rawN。

/sys/bus/iio/devices/iio:deviceX/out_voltageY_toggle_en

在文件 sysfs-bus-iio-dac 中定义

切换使能。写入 1 以启用切换，或写入 0 以禁用它。当想要更改 DAC 输出代码时，此操作很有用。对于自主切换，应该执行以下操作

  • 禁用切换操作；

  • 更改 out_voltageY_rawN，其中 N 是符号的整数值；

  • 启用切换操作。

/sys/bus/iio/devices/iio:deviceX/oversampling_ratio

在文件 sysfs-bus-iio 中定义

硬件相关的 ADC 过采样。如果可用，则控制数字滤波器的采样率。

/sys/bus/iio/devices/iio:deviceX/oversampling_ratio_available

在文件 sysfs-bus-iio 中定义

过采样滤波器支持的硬件相关值。

/sys/bus/iio/devices/iio:deviceX/pll2_feedback_clk_present

/sys/bus/iio/devices/iio:deviceX/pll2_reference_clk_present

/sys/bus/iio/devices/iio:deviceX/pll1_reference_clk_a_present

/sys/bus/iio/devices/iio:deviceX/pll1_reference_clk_b_present

/sys/bus/iio/devices/iio:deviceX/pll1_reference_clk_test_present

/sys/bus/iio/devices/iio:deviceX/vcxo_clk_present

在文件 sysfs-bus-iio-frequency-ad9523 中定义

读取操作会返回“1”或“0”。

“1”表示存在所讨论的时钟。

“0”表示时钟丢失。

/sys/bus/iio/devices/iio:deviceX/pllY_locked

在文件 sysfs-bus-iio-frequency-ad9523 中定义

读取操作会返回“1”或“0”。“1”表示 pllY 已锁定。

/sys/bus/iio/devices/iio:deviceX/proximity_on_chip_ambient_infrared_suppression

在文件 sysfs-bus-iio-light-isl29018 中定义

来自 ISL29018 数据手册（FN6619.4，2012 年 10 月 8 日）关于红外抑制

方案 0，进行完整的 n（4、8、12、16）位（无符号）接近度检测。方案 0 接近度计数的范围为 0 到 2^n。此位的逻辑 1，方案 1，进行 n-1（3、7、11、15）位（2 的补码）proximity_less_ambient 检测。方案 1 接近度计数的范围为 -2^(n-1) 到 2^(n-1)。符号位对于小于 16 的分辨率进行扩展。虽然方案 0 具有更宽的动态范围，但方案 1 接近度检测受环境红外噪声变化的影响较小。

0

感应来自 LED 和环境的红外线

1

感应来自 LED 的红外线，并具有环境红外线抑制功能

/sys/bus/iio/devices/iio:deviceX/sampling_frequency_available

/sys/bus/iio/devices/iio:deviceX/in_intensity_sampling_frequency_available

/sys/bus/iio/devices/iio:deviceX/in_proximity_sampling_frequency_available

/sys/.../iio:deviceX/buffer/sampling_frequency_available

/sys/bus/iio/devices/triggerX/sampling_frequency_available

在文件 sysfs-bus-iio 中定义

当内部采样时钟只能采用一组特定的频率时，我们可以使用以下方式指定可用值：

  • 一小组离散值，如“0 2 4 6 8”

  • 使用包含最小、步长和最大频率的范围，例如“[最小值 步长 最大值]”

/sys/bus/iio/devices/iio:deviceX/sampling_frequency

/sys/bus/iio/devices/iio:deviceX/in_intensity_sampling_frequency

/sys/bus/iio/devices/iio:deviceX/buffer/sampling_frequency

/sys/bus/iio/devices/triggerX/sampling_frequency

在文件 sysfs-bus-iio 中定义

某些设备具有内部时钟。此参数设置最终的采样频率。在许多设备中，此参数会影响输入滤波器等，而不仅仅是控制何时对输入进行采样。由于这会影响数据就绪触发器、硬件缓冲区和 sysfs 直接访问接口，因此可以在任何相关目录中找到它。如果它影响上述所有内容，则可以在基本设备目录中找到它。

stm32-timer-trigger 还有一个额外的特性，即采样频率为 0 时定义为停止采样。

/sys/bus/iio/devices/iio:deviceX/sensor_max_range

定义在文件 sysfs-bus-iio-distance-srf08 中

显示或设置传感器与第一个回声物体之间的最大距离（以米为单位）。默认值为 6.020。此设置限制驱动程序等待回声的时间。

可用值的范围表示为最小值、步长和最大值，所有这些都包含在方括号内。

示例

[0.043 0.043 11.008]

/sys/bus/iio/devices/iio:deviceX/sensor_sensitivity

在文件 sysfs-bus-iio-proximity 中定义

接近传感器有时在信号上具有可控的放大器，从中获取飞行时间测量值。要采用的适当值取决于传感器及其运行环境：* as3935（0-31 范围）18 = 室内（默认）14 = 室外

/sys/bus/iio/devices/iio:deviceX/serialnumber

在文件 sysfs-bus-iio 中定义

示例格式为 16 字节，每字节 2 位，表示传感器唯一 ID 号的十六进制字符串。

/sys/bus/iio/devices/iio:deviceX/start_cleaning

定义于文件 sysfs-bus-iio-sps30

写入 1 会启动传感器自清洁。内部风扇加速到最大速度，并保持旋转约 10 秒，以吹走积聚的灰尘。

/sys/bus/iio/devices/iio:deviceX/store_eeprom

在文件 sysfs-bus-iio 中定义

写入“1”将当前设备配置存储到片上 EEPROM 中。加电或芯片复位后，设备将自动加载保存的配置。

/sys/bus/iio/devices/iio:deviceX/sync_dividers

在文件 sysfs-bus-iio-frequency-ad9523 中定义

写入“1”会触发时钟分配同步功能。所有分频器都会复位，并且通道会以其预定义的相位偏移（out_altvoltageY_phase）开始。写入此文件具有驱动外部 /SYNC 引脚为低电平的效果。

/sys/bus/iio/devices/iio:deviceX/sys_calibration_auto_status

定义于文件 sysfs-bus-iio-bno055

报告 IMU 整体自动校准的状态。可以为 0（校准甚至未启用）或 1 到 5，数字越大，校准状态越好。

/sys/bus/iio/devices/iio:deviceX/trigger/current_trigger

在文件 sysfs-bus-iio 中定义

正在使用的触发源的名称，与 /sys/class/iio/triggerY/name 中给定的字符串相同。

/sys/bus/iio/devices/iio_sysfs_trigger/add_trigger

定义在文件 sysfs-bus-iio-trigger-sysfs 中

此属性由 iio-trig-sysfs 独立驱动程序提供，用于激活新触发器的创建。为了实现此目的，应将一个正整数写入关联的文件中，该整数将用作触发器的 ID。如果系统中已存在具有指定 ID 的触发器，则将返回无效参数消息。

/sys/bus/iio/devices/iio_sysfs_trigger/remove_trigger

定义在文件 sysfs-bus-iio-trigger-sysfs 中

此属性用于从可用触发器列表中注销和删除先前创建的触发器。为了实现此目的，应将一个正整数写入关联的文件中，表示需要删除的触发器的 ID。如果找不到触发器，则会向用户返回无效参数消息。

/sys/bus/iio/devices/triggerX

在文件 sysfs-bus-iio 中定义

用于将数据捕获到内核缓冲区中的事件驱动驱动程序。可以由也具有基于硬件生成事件（例如，数据就绪）的 IIO 设备的设备驱动程序提供，也可以由用于其他硬件（例如，周期性定时器、GPIO 或高分辨率定时器）的单独驱动程序提供。

包含触发器类型特定的元素。这些元素不容易通用化，因此未在此文件中记录。X 是触发器的 IIO 索引。

/sys/bus/iio/devices/triggerX/master_mode

在文件 sysfs-bus-iio-timer-stm32 中定义

读取返回当前主模式。写入设置主模式

/sys/bus/iio/devices/triggerX/master_mode_available

在文件 sysfs-bus-iio-timer-stm32 中定义

读取返回可能的可用主模式列表，这些模式包括：

  • “reset”

    来自 TIMx_EGR 寄存器的 UG 位用作触发输出 (TRGO)。

  • “enable”

    计数器使能信号 CNT_EN 用作触发输出。

  • “update”

    更新事件被选为触发输出。例如，主定时器可以用作从定时器的预分频器。

  • “compare_pulse”

    当要设置 CC1IF 标志时，触发输出发送一个正脉冲。

  • “OC1REF”

    OC1REF 信号用作触发输出。

  • “OC2REF”

    OC2REF 信号用作触发输出。

  • “OC3REF”

    OC3REF 信号用作触发输出。

  • “OC4REF”

    OC4REF 信号用作触发输出。

其他模式（仅限 TRGO2）

  • “OC5REF”

    OC5REF 信号用作触发输出。

  • “OC6REF”

    OC6REF 信号用作触发输出。

  • “compare_pulse_OC4REF”

    OC4REF 上升沿或下降沿生成脉冲。

  • “compare_pulse_OC6REF”

    OC6REF 上升沿或下降沿生成脉冲。

  • “compare_pulse_OC4REF_r_or_OC6REF_r”

    OC4REF 或 OC6REF 上升沿生成脉冲。

  • “compare_pulse_OC4REF_r_or_OC6REF_f”

    OC4REF 上升沿或 OC6REF 下降沿生成脉冲。

  • “compare_pulse_OC5REF_r_or_OC6REF_r”

    OC5REF 或 OC6REF 上升沿生成脉冲。

  • “compare_pulse_OC5REF_r_or_OC6REF_f”

    OC5REF 上升沿或 OC6REF 下降沿生成脉冲。

+-----------+   +-------------+            +---------+
| Prescaler +-> | Counter     |        +-> | Master  | TRGO(2)
+-----------+   +--+--------+-+        |-> | Control +-->
                   |        |          ||  +---------+
                +--v--------+-+ OCxREF ||  +---------+
                | Chx compare +----------> | Output  | ChX
                +-----------+-+         |  | Control +-->
                      .     |           |  +---------+
                      .     |           |    .
                +-----------v-+ OC6REF  |    .
                | Ch6 compare +---------+>
                +-------------+

例如：“compare_pulse_OC4REF_r_or_OC6REF_r”

                X
              X   X
            X .   . X
          X   .   .   X
        X     .   .     X
count X .     .   .     . X
        .     .   .     .
        .     .   .     .
        +---------------+
OC4REF  |     .   .     |
      +-+     .   .     +-+
        .     +---+     .
OC6REF  .     |   |     .
      +-------+   +-------+
        +-+   +-+
TRGO2   | |   | |
      +-+ +---+ +---------+

/sys/bus/iio/devices/triggerX/name

定义在文件 sysfs-bus-iio-trigger-sysfs 中

name 属性保存当前触发器的描述字符串。为了将触发器与 IIO 设备关联，应将此名称字符串写入 /sys/bus/iio/devices/iio:deviceY/trigger/current_trigger。

/sys/bus/iio/devices/triggerX/name = "adxl372-devX-peak"

定义在文件 sysfs-bus-iio-accel-adxl372 中

adxl372 加速度计内核模块提供了一个额外的触发器，该触发器将设备设置为一种模式，其中它仅记录在事件 sysfs 中设置的时间段内感应到的峰值加速度。

/sys/bus/iio/devices/triggerX/name = "bmc150_accel-any-motion-devX"

定义在文件 sysfs-bus-iio-accel-bmc150 中

BMC150 加速度计内核模块提供了一个额外的触发器，该触发器将驱动程序设置为一种模式，其中仅当有任何运动时，数据才会被推送到缓冲区。

/sys/bus/iio/devices/triggerX/name = "bmg160-any-motion-devX"

定义在文件 sysfs-bus-iio-gyro-bmg160 中

BMG160 陀螺仪内核模块提供了一个额外的触发器，该触发器将驱动程序设置为一种模式，其中仅当有任何运动时，数据才会被推送到缓冲区。

/sys/bus/iio/devices/triggerX/trigger_now

定义在文件 sysfs-bus-iio-trigger-sysfs 中

此文件由 iio-trig-sysfs 独立触发器驱动程序提供。使用任何值写入此文件会触发与此触发器关联的事件驱动驱动程序，以将数据捕获到内核缓冲区中。这种方法在自动化测试或在其他触发方法不适用的情况下可能很有价值。例如，没有 RTC 或备用 GPIO。X 是触发器的 IIO 索引。

/sys/bus/iio/devices/triggerX/trigger_polarity

定义在文件 sysfs-bus-iio-adc-stm32 中

可以将 STM32 ADC 配置为使用外部触发源（例如定时器、pwm 或 exti gpio）。然后，可以将其调整为在外部触发器上开始转换，通过以下任一方式：

  • “rising-edge”

  • “falling-edge”

  • “both-edges”。

读取返回当前触发极性。

在启用转换之前写入值会设置触发极性。

/sys/bus/iio/devices/triggerX/trigger_polarity_available

定义在文件 sysfs-bus-iio-adc-stm32 中

列出所有可用的 trigger_polarity 设置。

/sys/bus/intel_th/devices/<intel_th_id>-<device><id>/active

定义在文件 sysfs-bus-intel_th-output-devices 中

（读写）写入 1 或 0 可以启用或禁用此输出设备的跟踪输出。读取返回当前状态。要求加载相应的输出端口驱动程序。

/sys/bus/intel_th/devices/<intel_th_id>-gth/masters/*

定义在文件 sysfs-bus-intel_th-devices-gth 中

（读写）为 STP 主设备配置输出端口。写入 -1 会禁用主设备；任何

/sys/bus/intel_th/devices/<intel_th_id>-gth/outputs/[0-7]_drop

定义在文件 sysfs-bus-intel_th-devices-gth 中

（读写）数据保留策略设置：当输出端口处于复位状态时，保留 (0) 或丢弃 (1) 输入数据。

/sys/bus/intel_th/devices/<intel_th_id>-gth/outputs/[0-7]_flush

定义在文件 sysfs-bus-intel_th-devices-gth 中

（读写）强制从输出端口的字节打包缓冲区中刷新数据。

/sys/bus/intel_th/devices/<intel_th_id>-gth/outputs/[0-7]_null

定义在文件 sysfs-bus-intel_th-devices-gth 中

（读写）STP NULL 数据包生成：已启用 (1) 或已禁用 (0)。

/sys/bus/intel_th/devices/<intel_th_id>-gth/outputs/[0-7]_port

定义在文件 sysfs-bus-intel_th-devices-gth 中

（只读）输出端口类型

0

不存在，

1

MSU（存储器存储单元）

2

CTP（通用跟踪端口）

4

PTI (MIPI PTI)。

/sys/bus/intel_th/devices/<intel_th_id>-gth/outputs/[0-7]_reset

定义在文件 sysfs-bus-intel_th-devices-gth 中

（只读）输出端口处于复位状态 (1)。

/sys/bus/intel_th/devices/<intel_th_id>-gth/outputs/[0-7]_smcfreq

定义在文件 sysfs-bus-intel_th-devices-gth 中

（读写）端口的 STP 同步数据包频率。指定维护数据包之间的时钟数。

/sys/bus/intel_th/devices/<intel_th_id>-msc<msc-id>/mode

定义在文件 sysfs-bus-intel_th-devices-msc 中

（读写）配置 MSC 操作模式

  • “single”，用于连续缓冲区模式（高阶分配）；

  • “multi”，用于多块模式；

  • “ExI”，用于 DCI 处理程序模式；

  • “debug”，用于调试模式；

  • 任何当前加载的缓冲区接收器。

如果操作模式发生更改，则会取消分配现有缓冲区（前提是没有活动的

/sys/bus/intel_th/devices/<intel_th_id>-msc<msc-id>/nr_pages

定义在文件 sysfs-bus-intel_th-devices-msc 中

（读写）为“single”或“multi”模式配置 MSC 缓冲区大小。

在单模式下，这是单个页数，必须是 2 的幂。在多块模式下，这是要分配的每个窗口的页数的逗号分隔列表。窗口数量不受限制。

写入此文件会取消分配现有缓冲区（前提是没有活动的用户并且未启用跟踪），然后分配一个新的缓冲区。

/sys/bus/intel_th/devices/<intel_th_id>-msc<msc-id>/port

定义在文件 sysfs-bus-intel_th-output-devices 中

（只读）端口号，对应于交换机 (GTH) 上的此输出设备，如果未加载相应的输出端口驱动程序，则为“未分配”。

/sys/bus/intel_th/devices/<intel_th_id>-msc<msc-id>/stop_on_full

定义在文件 sysfs-bus-intel_th-devices-msc 中

（读写）配置当最后一个可用窗口满时（1/y/Y）跟踪是否停止，或者是否环绕并继续直到下一个窗口再次可用（0/n/N）。

/sys/bus/intel_th/devices/<intel_th_id>-msc<msc-id>/win_switch

定义在文件 sysfs-bus-intel_th-devices-msc 中

（读写）在多窗口模式下触发 MSC 缓冲区的窗口切换。在“multi”模式下，接受写入“1”，从而触发缓冲区的窗口切换。在任何其他操作模式下或尝试写入“1”以外的其他内容时返回错误。

/sys/bus/intel_th/devices/<intel_th_id>-msc<msc-id>/wrap

定义在文件 sysfs-bus-intel_th-devices-msc 中

（读写）配置 MSC 缓冲区环绕。1 == 启用环绕。

/sys/bus/intel_th/devices/<intel_th_id>-pti/clock_divider

定义在文件 sysfs-bus-intel_th-devices-pti 中

（读写）配置 PTI 端口时钟分频器

  • 0：Intel TH 时钟速率，

  • 1：1/2 Intel TH 时钟速率，

  • 2：1/4 Intel TH 时钟速率，

  • 3：1/8 Intel TH 时钟速率。

/sys/bus/intel_th/devices/<intel_th_id>-pti/freerunning_clock

定义在文件 sysfs-bus-intel_th-devices-pti 中

（读写）0：PTI 跟踪时钟充当选通脉冲，仅当有跟踪数据要发送时才会切换。1：PTI 跟踪时钟是自由运行的时钟。

/sys/bus/intel_th/devices/<intel_th_id>-pti/mode

定义在文件 sysfs-bus-intel_th-devices-pti 中

(读写) 配置 PTI 输出宽度。当前支持的值为 4、8、12、16。

/sys/bus/mcb/devices/mcb:X

定义在文件 sysfs-bus-mcb

托管 MEN chameleon 总线的硬件芯片或设备

/sys/bus/mcb/devices/mcb:X/minor

定义在文件 sysfs-bus-mcb

FPGA 的次设备号

/sys/bus/mcb/devices/mcb:X/model

定义在文件 sysfs-bus-mcb

FPGA 的型号

/sys/bus/mcb/devices/mcb:X/name

定义在文件 sysfs-bus-mcb

FPGA 的名称

/sys/bus/mcb/devices/mcb:X/revision

定义在文件 sysfs-bus-mcb

FPGA 的修订号

/sys/bus/mdio_bus/devices/.../statistics/errors_<addr>

/sys/class/mdio_bus/.../statistics/errors_<addr>

定义在文件 sysfs-bus-mdio

此 MDIO 总线地址的传输错误总数。

/sys/bus/mdio_bus/devices/.../statistics/errors

/sys/class/mdio_bus/.../statistics/errors

定义在文件 sysfs-bus-mdio

此 MDIO 总线的传输错误总数。

/sys/bus/mdio_bus/devices/.../statistics/reads_<addr>

/sys/class/mdio_bus/.../statistics/reads_<addr>

定义在文件 sysfs-bus-mdio

此 MDIO 总线地址的读取事务总数。

/sys/bus/mdio_bus/devices/.../statistics/reads

/sys/class/mdio_bus/.../statistics/reads

定义在文件 sysfs-bus-mdio

此 MDIO 总线的读取事务总数。

/sys/bus/mdio_bus/devices/.../statistics/transfers_<addr>

/sys/class/mdio_bus/.../statistics/transfers_<addr>

定义在文件 sysfs-bus-mdio

此 MDIO 总线地址的传输总数。

/sys/bus/mdio_bus/devices/.../statistics/transfers

/sys/class/mdio_bus/.../transfers

定义在文件 sysfs-bus-mdio

此 MDIO 总线的传输总数。

/sys/bus/mdio_bus/devices/.../statistics/writes_<addr>

/sys/class/mdio_bus/.../statistics/writes_<addr>

定义在文件 sysfs-bus-mdio

此 MDIO 总线地址的写入事务总数。

/sys/bus/mdio_bus/devices/.../statistics/writes

/sys/class/mdio_bus/.../statistics/writes

定义在文件 sysfs-bus-mdio

此 MDIO 总线的写入事务总数。

/sys/bus/mdio_bus/devices/.../statistics/

/sys/class/mdio_bus/.../statistics/

定义在文件 sysfs-bus-mdio

此文件夹包含关于全局和每个 MDIO 总线地址统计信息的统计数据。

/sys/bus/media/devices/.../model

定义在文件 sysfs-bus-media

包含 UTF-8 编码的设备型号名称。设备版本不会附加到型号名称。

/sys/bus/mei/devices/.../fixed

定义在文件 sysfs-bus-mei

存储 mei 客户端的固定地址（如果有）。格式：%d

/sys/bus/mei/devices/.../max_conn

定义在文件 sysfs-bus-mei

存储 mei 客户端的最大连接数。格式：%d

/sys/bus/mei/devices/.../max_len

定义在文件 sysfs-bus-mei

存储 mei 客户端的最大消息长度。格式：%d

/sys/bus/mei/devices/.../modalias

定义在文件 sysfs-bus-mei

存储 uevent 发出的相同 MODALIAS 值。格式：mei:<mei 设备名称>:<设备 uuid>:<协议版本>

/sys/bus/mei/devices/.../name

定义在文件 sysfs-bus-mei

存储 mei 客户端设备名称。格式：字符串

/sys/bus/mei/devices/.../uuid

定义在文件 sysfs-bus-mei

存储 mei 客户端设备 uuid。格式：xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

/sys/bus/mei/devices/.../version

定义在文件 sysfs-bus-mei

存储 mei 客户端协议版本。格式：%d

/sys/bus/mei/devices/.../vtag

定义在文件 sysfs-bus-mei

存储 mei 客户端 vtag 支持状态。格式：%d

/sys/bus/mmc/devices/.../rev

定义在文件 sysfs-bus-mmc

扩展 CSD 修订号

/sys/bus/most/devices/<dev>/<channel>/

定义在文件 sysfs-bus-most

为设备的每个通道创建一个目录，其名称由 HDM 指定。这使应用程序能够收集有关通道功能的信息并对其进行配置。

/sys/bus/most/devices/<dev>/<channel>/available_datatypes

定义在文件 sysfs-bus-most

指示通道可以传输的数据类型。

/sys/bus/most/devices/<dev>/<channel>/available_directions

定义在文件 sysfs-bus-most

指示通道能够支持的方向。

/sys/bus/most/devices/<dev>/<channel>/channel_starving

定义在文件 sysfs-bus-most

指示通道是否耗尽缓冲区。

/sys/bus/most/devices/<dev>/<channel>/number_of_packet_buffers

定义在文件 sysfs-bus-most

指示通道可以处理的数据包缓冲区数量。

/sys/bus/most/devices/<dev>/<channel>/number_of_stream_buffers

定义在文件 sysfs-bus-most

指示通道可以处理的流式缓冲区数量。

/sys/bus/most/devices/<dev>/<channel>/set_buffer_size

定义在文件 sysfs-bus-most

用于回读通道的配置缓冲区大小。

/sys/bus/most/devices/<dev>/<channel>/set_datatype

定义在文件 sysfs-bus-most

用于回读通道的配置数据类型。将接受以下字符串

'control',
'async',
'sync',
'isoc_avp'

/sys/bus/most/devices/<dev>/<channel>/set_direction

定义在文件 sysfs-bus-most

用于回读通道的配置方向。将接受以下字符串

'tx',
'rx'

/sys/bus/most/devices/<dev>/<channel>/set_number_of_buffers

定义在文件 sysfs-bus-most

用于回读通道的配置缓冲区数量。

/sys/bus/most/devices/<dev>/<channel>/set_packets_per_xact

定义在文件 sysfs-bus-most

用于回读通道的每个事务的配置数据包数量。仅在通过 USB 连接时适用。

/sys/bus/most/devices/<dev>/<channel>/set_subbuffer_size

定义在文件 sysfs-bus-most

用于回读通道的配置子缓冲区大小。

/sys/bus/most/devices/<dev>/<channel>/size_of_packet_buffer

定义在文件 sysfs-bus-most

指示通道可以处理的数据包缓冲区的大小。

/sys/bus/most/devices/<dev>/<channel>/size_of_stream_buffer

定义在文件 sysfs-bus-most

指示通道可以处理的流式缓冲区的大小。

/sys/bus/most/devices/<dev>/dci

定义在文件 sysfs-bus-most

如果网络接口控制器是通过 USB 连接的，则会创建一个 dci 目录，允许应用程序读取和写入控制器的 DCI 寄存器。

/sys/bus/most/devices/<dev>/dci/arb_address

定义在文件 sysfs-bus-most

用于设置应用程序要读取或写入的任意 DCI 寄存器地址。

/sys/bus/most/devices/<dev>/dci/arb_value

定义在文件 sysfs-bus-most

用于读取和写入地址存储在 arb_address 中的 DCI 寄存器。

/sys/bus/most/devices/<dev>/dci/mep_eui48_hi

定义在文件 sysfs-bus-most

用于检查和配置 MAC 地址。

/sys/bus/most/devices/<dev>/dci/mep_eui48_lo

定义在文件 sysfs-bus-most

用于检查和配置 MAC 地址。

/sys/bus/most/devices/<dev>/dci/mep_eui48_mi

定义在文件 sysfs-bus-most

用于检查和配置 MAC 地址。

/sys/bus/most/devices/<dev>/dci/mep_filter

定义在文件 sysfs-bus-most

用于检查和配置 MEP 筛选器地址。

/sys/bus/most/devices/<dev>/dci/mep_hash0

定义在文件 sysfs-bus-most

用于检查和配置 MEP 哈希表。

/sys/bus/most/devices/<dev>/dci/mep_hash1

定义在文件 sysfs-bus-most

用于检查和配置 MEP 哈希表。

/sys/bus/most/devices/<dev>/dci/mep_hash2

定义在文件 sysfs-bus-most

用于检查和配置 MEP 哈希表。

/sys/bus/most/devices/<dev>/dci/mep_hash3

定义在文件 sysfs-bus-most

用于检查和配置 MEP 哈希表。

/sys/bus/most/devices/<dev>/dci/ni_state

定义在文件 sysfs-bus-most

指示当前网络接口状态。

/sys/bus/most/devices/<dev>/dci/node_address

定义在文件 sysfs-bus-most

指示当前节点地址。

/sys/bus/most/devices/<dev>/dci/node_position

定义在文件 sysfs-bus-most

指示当前节点位置。

/sys/bus/most/devices/<dev>/dci/packet_bandwidth

定义在文件 sysfs-bus-most

指示配置的数据包带宽。

/sys/bus/most/devices/<dev>/dci/sync_ep

定义在文件 sysfs-bus-most

为特定端点触发控制器的同步过程。

/sys/bus/most/devices/<dev>/description

定义在文件 sysfs-bus-most

提供有关设备物理位置的信息。例如，通过 USB 连接的硬件可能会返回 <1-1.1:1.0>

/sys/bus/most/devices/<dev>/interface

定义在文件 sysfs-bus-most

指示设备使用的外围接口类型。

/sys/bus/most/drivers/most_core/components

定义在文件 sysfs-bus-most

用于检索已注册组件的列表。

定义在文件 sysfs-bus-most

用于检索已建立的链接列表。

/sys/bus/moxtet/devices/moxtet-<name>.<addr>/module_description

定义在文件 sysfs-bus-moxtet-devices

(读) Moxtet 模块描述。格式：字符串

/sys/bus/moxtet/devices/moxtet-<name>.<addr>/module_id

定义在文件 sysfs-bus-moxtet-devices

(读) Moxtet 模块 ID。格式：%x

/sys/bus/moxtet/devices/moxtet-<name>.<addr>/module_name

定义在文件 sysfs-bus-moxtet-devices

(读) Moxtet 模块名称。格式：字符串

/sys/bus/nd/devices/ndbusX/nfit/dsm_mask

定义在文件 sysfs-bus-nfit

(只读) 该位掩码指示支持的总线特定控制功能。请参阅 ACPI 规范中名为“NVDIMM 根设备 _DSMs”的部分。

/sys/bus/nd/devices/ndbusX/nfit/firmware_activate_noidle

定义在文件 sysfs-bus-nfit

(读写) Intel 平台的固件激活支持实现公开了一个选项，允许平台强制系统中的空闲设备在激活事件期间进入空闲状态，或者信任操作系统会这样做。安全的默认设置是让平台强制空闲设备，因为内核已经处于挂起状态，并且如果驱动程序在挂起回调后未正确停止总线主控，则平台将处理它。但是，如果例如平台固件确定激活时间超过了最大 PCI-E 完成超时时间，则激活可能会中止。由于平台不知道操作系统是否在挂起上下文中运行激活，因此它会中止，但是如果系统所有者信任驱动程序挂起回调足以满足要求，则可以启用“firmware_activation_noidle”以绕过激活中止。

/sys/bus/nd/devices/ndbusX/nfit/hw_error_scrub

定义在文件 sysfs-bus-nfit

(读写) 提供了一种方法来切换行为，即仅将 MCE 发生的地址（缓存行）添加到毒药列表，还是进行完全擦除。前者（选择性插入地址）是无条件完成的。

此属性可以写入以下值

“0”：切换到默认模式，其中异常只会将内存错误的地址插入毒药列表和坏块列表。“1”：如果收到内存错误的异常，则启用完全擦除。

/sys/bus/nd/devices/ndbusX/nfit/revision

定义在文件 sysfs-bus-nfit

(只读) ACPI NFIT 表修订号。

/sys/bus/nd/devices/ndbusX/nfit/scrub

定义在文件 sysfs-bus-nfit

(读写) 这显示自驱动程序加载时间以来已完成的完整地址范围擦除 (ARS) 的数量。用户空间可以使用 select/poll 等待此操作。末尾的“+”表示 ARS 正在进行中

写入值 1 会触发 ARS 扫描。

/sys/bus/nd/devices/nmemX/cxl/id

在文件 sysfs-bus-nvdimm 中定义

(只读) 显示设备的 id（序列号）。这是 CXL 特定的。

/sys/bus/nd/devices/nmemX/cxl/provider

在文件 sysfs-bus-nvdimm 中定义

(只读) 显示将 CXL 内存设备连接到此 NVDIMM 设备的 CXL 桥接设备。即，返回的设备的父级是 /sys/bus/cxl/devices/memX 实例。

/sys/bus/nd/devices/nmemX/nfit/device

定义在文件 sysfs-bus-nfit

(只读) NVDIMM 的设备 ID，由模块供应商分配。

/sys/bus/nd/devices/nmemX/nfit/dsm_mask

定义在文件 sysfs-bus-nfit

(只读) 该位掩码指示相对于设备支持的 NVDIMM 命令系列的支持的设备特定控制功能

/sys/bus/nd/devices/nmemX/nfit/family

定义在文件 sysfs-bus-nfit

(只读) 显示 NVDIMM 系列命令集。值 0、1、2 和 3 分别对应于 NVDIMM_FAMILY_INTEL、NVDIMM_FAMILY_HPE1、NVDIMM_FAMILY_HPE2 和 NVDIMM_FAMILY_MSFT。

有关这些命令系列的规范，请参阅此处：http://pmem.io/documents/NVDIMM_DSM_Interface-V1.6.pdf https://github.com/HewlettPackard/hpe-nvm/blob/master/Documentation/ https://msdn.microsoft.com/library/windows/hardware/mt604741”

/sys/bus/nd/devices/nmemX/nfit/flags

定义在文件 sysfs-bus-nfit

(只读) NFIT 内存设备子结构中的标志指示 NVDIMM 上相对于其能量源或上次“刷新到持久性”的数据状态。

该属性是 ACPI 规范 6.2 的 5.2.25.3 节“NVDIMM 区域映射”结构中“NVDIMM 状态标志”字段的转换。

运行状况状态为“save_fail”、“restore_fail”、“flush_fail”、“not_armed”、“smart_event”、“map_fail”和“smart_notify”。

/sys/bus/nd/devices/nmemX/nfit/format

/sys/bus/nd/devices/nmemX/nfit/format1

/sys/bus/nd/devices/nmemX/nfit/formats

定义在文件 sysfs-bus-nfit

(只读) 接口代码指示对直接映射到系统物理地址空间的持久内存和/或对 NVDIMM 介质的块孔径访问机制的支持。“formats”属性显示支持的接口数量。

此布局与现有的 libndctl 二进制文件兼容，因为它们只期望每个 dimm 有一个代码，因为它们会忽略 nmemX/nfit/formats 和 nmemX/nfit/formatN。

/sys/bus/nd/devices/nmemX/nfit/handle

定义在文件 sysfs-bus-nfit

(只读) NVDIMM 设备在其父总线上的地址（由 _ADR 对象给出），该 NVDIMM 设备包含 NVDIMM 区域。

/sys/bus/nd/devices/nmemX/nfit/id

定义在文件 sysfs-bus-nfit

(只读) ACPI 规范 6.2 节 5.2.25.9，定义了 NVDIMM 的标识符，它反映了 id 属性。

/sys/bus/nd/devices/nmemX/nfit/phys_id

定义在文件 sysfs-bus-nfit

(只读) 用于描述包含 NVDIMM 区域的 NVDIMM 的 SMBIOS（系统管理 BIOS）内存设备结构的句柄（即，实例编号）。

/sys/bus/nd/devices/nmemX/nfit/rev_id

定义在文件 sysfs-bus-nfit

(只读) NVDIMM 的修订版本，由模块供应商分配。

/sys/bus/nd/devices/nmemX/nfit/serial

定义在文件 sysfs-bus-nfit

(只读) NVDIMM（非易失性双列直插内存模块）的序列号，由模块供应商分配。

/sys/bus/nd/devices/nmemX/nfit/subsystem_device

定义在文件 sysfs-bus-nfit

(只读) NVDIMM 非易失性内存子系统控制器的子系统设备 ID，由非易失性内存子系统控制器供应商分配。

/sys/bus/nd/devices/nmemX/nfit/subsystem_rev_id

定义在文件 sysfs-bus-nfit

(只读) NVDIMM 非易失性内存子系统控制器的子系统修订 ID，由非易失性内存子系统控制器供应商分配。

/sys/bus/nd/devices/nmemX/nfit/subsystem_vendor

定义在文件 sysfs-bus-nfit

(只读) NVDIMM 非易失性内存子系统控制器的子系统供应商 ID。

/sys/bus/nd/devices/nmemX/nfit/vendor

定义在文件 sysfs-bus-nfit

(只读) NVDIMM 的供应商 ID。

/sys/bus/nd/devices/nmemX/papr/flags

在文件 sysfs-bus-papr-pmem 中定义

(只读) 报告 papr-pmem NVDIMM 设备的各种状态的标志。每个标志都映射到响应 H_SCM_HEALTH hcall 返回的 dimm-health-bitmap 中设置的一个或多个位。此 hcall 返回的位标志的详细信息可在 ‘Hypercall 操作码 (hcalls)’ 中找到。以下是此 sysfs 文件中报告的标志

  • “not_armed”

    表示 NVDIMM 内容在断电后不会保留。

  • “flush_fail”

    表示在上次关机事件期间无法刷新 NVDIMM 内容。

  • “restore_fail”

    表示在 NVDIMM 初始化期间无法恢复 NVDIMM 内容。

  • “encrypted”

    NVDIMM 内容已加密。

  • “smart_notify”

    NVDIMM 存在运行状况事件。

  • “scrubbed”

    表示已清理 NVDIMM 的内容。

  • “locked”

    表示在下次断电之前无法修改 NVDIMM 内容。

/sys/bus/nd/devices/nmemX/papr/health_bitmap_inject

在文件 sysfs-bus-papr-pmem 中定义

(只读) 报告应用于通过 H_SCM_HEALTH 从 PowerVM 接收的位图的运行状况位图注入位图。这用于强制设置从 Hcall 返回的特定位。然后，这些位用于模拟 nvdimm 的各种运行状况或关闭状态，并通过用户空间工具（如 ndctl）通过发出 PAPR DSM 来设置。

/sys/bus/nd/devices/nmemX/papr/perf_stats

在文件 sysfs-bus-papr-pmem 中定义

(只读) 报告与 papr-scm NVDIMM 设备相关的各种性能统计信息。此属性仅适用于支持报告 NVDIMM 性能统计信息的 NVDIMM 设备。每个统计信息都在新行上报告，每行由统计标识符及其值组成。以下是目前已知的报告的 dimm 性能统计信息

  • “CtlResCt”：控制器重置计数

  • “CtlResTm”：控制器重置经过时间

  • “PonSecs”：上电秒数

  • “MemLife”：剩余寿命

  • “CritRscU”：关键资源利用率

  • “HostLCnt”：主机加载计数

  • “HostSCnt”：主机存储计数

  • “HostSDur”：主机存储持续时间

  • “HostLDur”：主机加载持续时间

  • “MedRCnt”：媒体读取计数

  • “MedWCnt”：媒体写入计数

  • “MedRDur”：媒体读取持续时间

  • “MedWDur”：媒体写入持续时间

  • “CchRHCnt”：缓存读取命中计数

  • “CchWHCnt”：缓存写入命中计数

  • “FastWCnt”：快速写入计数

/sys/bus/nd/devices/regionX/nfit/range_index

定义在文件 sysfs-bus-nfit

(只读) BIOS 提供的唯一编号，用于标识地址范围。NVDIMM 区域映射结构使用它来唯一引用此结构。值 0 保留，不作为索引使用。

/sys/bus/nvmem/devices/.../cells/<cell-name>

在文件 sysfs-nvmem-cells 中定义

“cells” 文件夹包含 NVMEM 设备公开的每个单元格一个文件。该文件的名称是：“<name>@<byte>,<bit>”，其中 <name> 是单元格名称，<where> 是它在 NVMEM 设备中的位置，以十六进制字节和位（不带 ‘0x’ 前缀，以模拟设备树节点名称）。该文件的长度是单元格的大小（如果已知）。文件的内容是单元格的二进制内容（有时可能是 ASCII，可能没有尾随字符）。注意：仅当启用 CONFIG_NVMEM_SYSFS 时，此文件才存在。

示例

hexdump -C /sys/bus/nvmem/devices/1-00563/cells/product-name@d,0
00000000  54 4e 34 38 4d 2d 50 2d  44 4e         |TN48M-P-DN|
0000000a

/sys/bus/pci/devices/.../acpi_index

在文件 sysfs-bus-pci 中定义

读取此属性将提供固件给定的 PCI 设备的实例（ACPI _DSM 实例号）。仅当固件已为 PCI 设备提供实例号时，才会创建该属性。如果系统固件还提供了 SMBIOS 类型 41 设备类型实例，则将优先考虑 ACPI _DSM 实例号。

用户

用户空间应用程序有兴趣了解 PCI 设备的固件分配的实例号，这有助于理解固件预期的 PCI 设备顺序。

/sys/bus/pci/devices/.../d3cold_allowed

在文件 sysfs-bus-pci 中定义

d3cold_allowed 是一个位，用于控制是否可以将相应的 PCI 设备置于 D3Cold 状态。如果清除此位，则该设备将永远不会被置于 D3Cold 状态。如果设置此位，则如果也满足其他要求，则该设备可能会被置于 D3Cold 状态。读取此属性将显示 d3cold_allowed 位的当前值。写入此属性将设置 d3cold_allowed 位的值。

在文件 sysfs-bus-pci 中定义

当硬件支持 SR-IOV 功能并且物理功能驱动程序已启用它时，会出现此符号链接，并且此设备与其他设备具有供应商特定的依赖关系。符号链接指向此设备所依赖的物理功能的 PCI 设备 sysfs 条目。

/sys/bus/pci/devices/.../driver_override

在文件 sysfs-bus-pci 中定义

此文件允许指定设备的驱动程序，该驱动程序将覆盖标准的静态和动态 ID 匹配。指定后，只有名称与写入 driver_override 的值匹配的驱动程序才有机会绑定到该设备。通过将字符串写入 driver_override 文件（echo pci-stub > driver_override）来指定覆盖，并且可以使用空字符串清除覆盖（echo > driver_override）。这将使设备恢复为标准的匹配规则绑定。写入 driver_override 不会自动将设备从其当前驱动程序中解除绑定，也不会尝试自动加载指定的驱动程序。如果当前内核中未加载名称匹配的驱动程序，则该设备将不会绑定到任何驱动程序。这也允许设备使用诸如“none”之类的 driver_override 名称选择不绑定驱动程序。覆盖中只能指定一个驱动程序，不支持解析分隔符。

/sys/bus/pci/devices/.../index

在文件 sysfs-bus-pci 中定义

读取此属性将提供固件给定的 PCI 设备的实例号。根据平台的不同，这可以是例如 SMBIOS 类型 41 设备类型实例或 s390 上的用户定义 ID (UID)。仅当固件已为 PCI 设备提供实例号并且该编号保证在系统中唯一标识该设备时，才会创建该属性。

用户

用户空间应用程序有兴趣了解 PCI 设备的固件分配的设备类型实例，这有助于理解固件预期的 PCI 设备顺序。

/sys/bus/pci/devices/.../irq

在文件 sysfs-bus-pci 中定义

如果驱动程序已启用 MSI（而不是 MSI-X），则“irq”包含第一个 MSI 向量的 IRQ。否则，“irq”包含旧版 INTx 中断的 IRQ。

将“irq”设置为 0 表示该设备无法生成旧版 INTx 中断。

/sys/bus/pci/devices/.../label

在文件 sysfs-bus-pci 中定义

读取此属性将提供固件给定的 PCI 设备名称（SMBIOS 类型 41 字符串或 ACPI _DSM 字符串）。仅当固件已为 PCI 设备提供名称时，才会创建该属性。如果系统固件还提供了 SMBIOS 类型 41 字符串，则将优先考虑 ACPI _DSM 字符串名称。

用户

用户空间应用程序有兴趣了解 PCI 设备的固件分配的名称。

/sys/bus/pci/devices/.../leds/*:enclosure:*/brightness

/sys/class/leds/*:enclosure:*/brightness

在文件 sysfs-bus-pci 中定义

通过 NPEM 接口（原生 PCIe 机箱管理，PCIe r6.1 sec 6.28）控制的 PCIe 存储机箱上的 LED 指示灯可以作为 led 类设备访问，位于 /sys/class/leds 和支持 NPEM 的 PCI 设备下。

虽然这些 led 类设备可以手动操作，但在实践中，它们通常由 ledmon(8) 等应用程序自动操作。

led 类设备的名称如下：<bdf>:enclosure:<indication>，其中

  • <bdf> 是域、总线、设备和功能号（例如 10000:02:05.0）

  • <indication> 是 LED 指示灯的简短描述

每个 PCIe r6.1 表 6-27 的有效指示为

  • ok（驱动器正常工作）

  • locate（驱动器正在由管理员识别）

  • fail（驱动器未正常工作）

  • rebuild（驱动器是正在重建的阵列的一部分）

  • pfa（预计驱动器很快将发生故障）

  • hotspare（驱动器被标记为用作替换）

  • ica（驱动器是已降级的阵列的一部分）

  • ifa（驱动器是已发生故障的阵列的一部分）

  • idt（驱动器与连接器的类型不匹配）

  • disabled（驱动器已禁用，可以安全移除）

  • specific0 到 specific7（机箱特定的指示灯）

广义而言，指示灯分为以下类别之一

  • 表示驱动器状态（ok、locate、fail、idt、disabled）

  • 表示软件 RAID 阵列中的驱动器角色或状态（rebuild、pfa、hotspare、ica、ifa）

  • 表示任何其他角色或状态（specific0 到 specific7）

每个 PCIe r6.1 sec 7.9.19.2 的强制指示包括：ok、locate、fail、rebuild。所有其他指示都是可选的。仅当设备支持相应的指示时，led 类设备才可见。

要操作指示灯，请将 0 (LED_OFF) 或 1 (LED_ON) 写入 “brightness” 文件。请注意，操作指示灯可能会在供应商自行决定时隐式操作其他指示灯。例如，当用户点亮“ok”指示灯时，供应商可以选择自动关闭“fail”指示灯。可以通过读取其“brightness”文件来检索指示灯的当前状态。

PCIe基础规范允许供应商在指示灯颜色或闪烁模式上有所选择，但它们通常遵循IBPI标准。例如，“定位”指示通常表现为一个或两个LED灯以4Hz频率闪烁：https://en.wikipedia.org/wiki/International_Blinking_Pattern_Interpretation

PCI固件规范r3.3第4.7节定义了一个DSM接口，以方便操作系统和平台固件共享访问设备的NPEM寄存器。内核将在可用时使用此DSM接口，而不是直接访问NPEM寄存器。DSM接口不支持特定于机箱的指示“specific0”到“specific7”，因此如果使用DSM接口，则相应的led类设备将不可用。

在文件 sysfs-bus-pci 中定义

如果端点支持ASPM，则可以使用这些文件来禁用或启用各个电源管理状态。写入y/1/on以启用，写入n/0/off以禁用。

/sys/bus/pci/devices/.../modalias

在文件 sysfs-bus-pci 中定义

此属性指示设备对象的PCI ID。

其格式为：pci:vXXXXXXXXdXXXXXXXXsvXXXXXXXXsdXXXXXXXXbcXXscXXiXX，其中

  • vXXXXXXXX包含供应商ID；

  • dXXXXXXXX包含设备ID；

  • svXXXXXXXX包含子供应商ID；

  • sdXXXXXXXX包含子系统设备ID；

  • bcXX包含设备类；

  • scXX包含设备子类；

  • iXX包含设备类编程接口。

/sys/bus/pci/devices/.../msi_bus

在文件 sysfs-bus-pci 中定义

向此属性写入零值会禁止设备未来驱动程序使用MSI和MSI-X。如果该设备是桥接器，则将禁止桥接器下所有子设备的未来驱动程序使用MSI和MSI-X。必须重新加载驱动程序才能使新设置生效。

/sys/bus/pci/devices/.../msi_irqs/

在文件 sysfs-bus-pci 中定义

/sys/devices/.../msi_irqs目录包含一组可变的文件，每个文件都以分配给该设备的相应msi irq向量命名。

/sys/bus/pci/devices/.../msi_irqs/<N>

在文件 sysfs-bus-pci 中定义

此属性指示文件中命名的irq向量所处的模式（msi vs. msix）

/sys/bus/pci/devices/.../numa_node

在文件 sysfs-bus-pci 中定义

此文件包含PCI设备所连接的NUMA节点，如果节点未知，则为-1。初始值来自ACPI _PXM方法或类似的固件源。如果该值缺失或不正确，则可以写入此文件以覆盖该节点。在这种情况下，请向系统供应商报告固件错误。写入此文件会使用TAINT_FIRMWARE_WORKAROUND污染内核，从而降低系统的可支持性。

/sys/bus/pci/devices/.../p2pmem/allocate

在文件 sysfs-bus-pci 中定义

此文件允许将p2pmem映射到用户空间。对于此文件的每个mmap()调用，内核将分配一块对等内存，用于对等事务。此内存可用于O_DIRECT调用NVMe支持的文件，以进行对等复制。

/sys/bus/pci/devices/.../p2pmem/available

在文件 sysfs-bus-pci 中定义

如果设备已注册任何对等内存，则此文件包含尚未分配的内存量（以十进制表示）。

/sys/bus/pci/devices/.../p2pmem/published

在文件 sysfs-bus-pci 中定义

如果设备已注册任何对等内存，则如果该内存已发布以供拥有该设备的驱动程序外部使用，则此文件包含“1”。

/sys/bus/pci/devices/.../p2pmem/size

在文件 sysfs-bus-pci 中定义

如果设备已注册任何对等内存，则此文件包含设备提供的总内存量（以十进制表示）。

/sys/bus/pci/devices/.../pci_bus/.../rescan

在文件 sysfs-bus-pci 中定义

向此属性写入非零值将强制重新扫描总线和所有子总线，并重新发现先前从此设备树部分删除的设备。

/sys/bus/pci/devices/.../physfn

在文件 sysfs-bus-pci 中定义

当设备是虚拟功能时，会出现此符号链接。该符号链接指向此设备关联的物理功能的PCI设备sysfs条目。

/sys/bus/pci/devices/.../power_state

在文件 sysfs-bus-pci 中定义

此文件包含设备的当前PCI电源状态。该值来自PCI内核设备状态，可以是以下之一：“unknown”、“error”、“D0”、“D1”、“D2”、“D3hot”、“D3cold”。该文件是只读的。

/sys/bus/pci/devices/.../remove

在文件 sysfs-bus-pci 中定义

向此属性写入非零值将热移除PCI设备及其任何子设备。

/sys/bus/pci/devices/.../rescan

在文件 sysfs-bus-pci 中定义

向此属性写入非零值将强制重新扫描设备的父总线和所有子总线，并重新发现先前从此设备树部分删除的设备。

/sys/bus/pci/devices/.../reset

在文件 sysfs-bus-pci 中定义

某些设备允许单独重置某个功能，而不会影响同一设备中的其他功能。对于具有此支持的设备，sysfs中将存在一个名为reset的文件。向此文件写入1将执行重置。

/sys/bus/pci/devices/.../reset_method

在文件 sysfs-bus-pci 中定义

某些设备允许单独重置某个功能，而不会影响同一插槽中的其他功能。

对于具有此支持的设备，sysfs中会存在一个名为reset_method的文件。读取此文件会给出支持和启用的重置方法及其顺序的名称。写入以空格分隔的重置方法名称列表会设置重置设备时要使用的重置方法和顺序。写入空字符串会禁用重置设备的能力。写入“default”会按默认顺序启用所有支持的重置方法。

/sys/bus/pci/devices/.../reset_subordinate

在文件 sysfs-bus-pci 中定义

这仅对桥接设备可见。如果要重置通过特定桥接设备的从属总线连接的所有设备，则向此写入1会尝试执行此操作。这将影响通过此桥接器连接到系统的所有设备，类似于向其各自的“reset”文件写入1，因此请谨慎使用。

/sys/bus/pci/devices/.../resourceN_resize

在文件 sysfs-bus-pci 中定义

这些文件为PCIe可调整大小的BAR提供接口。为设备PCIe可调整大小的BAR扩展功能支持的每个BAR资源(N)创建一个文件。读取每个文件会显示可用资源大小的位图

# cat resource1_resize 00000000000001c0

该位图表示BAR支持的资源大小，其中bit0 = 1MB，bit1 = 2MB，bit2 = 4MB等。在上面的示例中，该设备支持64MB、128MB和256MB的BAR大小。

写入文件时，用户提供所需资源大小的位位置，例如

# echo 7 > resource1_resize

这表示将大小值设置为与位7对应的128MB。结果大小为2 ^（位# + 20）。此定义与此功能的PCIe规范匹配。

为了利用资源大小调整，必须从设备中取消绑定所有PCI驱动程序，并且可能需要软删除同一父桥下的对等设备。对于VGA设备，写入调整大小的值将从设备中删除低级控制台驱动程序。在调整大小之前，必须终止pci-sysfs resourceN属性的原始用户。无法保证调整大小操作的成功。

/sys/bus/pci/devices/.../revision

在文件 sysfs-bus-pci 中定义

此文件包含PCI设备的修订字段。该值来自设备配置空间。该文件是只读的。

/sys/bus/pci/devices/.../sriov_drivers_autoprobe

在文件 sysfs-bus-pci 中定义

此文件与支持SR-IOV的设备的PF相关联。它确定新启用的VF是否立即绑定到驱动程序。它最初包含1，这意味着内核会在启用VF后立即将VF自动绑定到兼容的驱动程序。如果应用程序在启用VF之前向文件写入0，则内核不会将VF绑定到驱动程序。

典型的用例是向此文件写入0，然后启用VF，然后将新创建的VF分配给虚拟机。请注意，更改此文件不会影响已启用的VF。在这种情况下，用户必须先禁用VF，向sriov_drivers_autoprobe写入0，然后再重新启用VF。

这类似于/sys/bus/pci/drivers_autoprobe，但仅影响与特定PF关联的VF。

/sys/bus/pci/devices/.../sriov_numvfs

在文件 sysfs-bus-pci 中定义

当物理PCIe设备支持SR-IOV时，会出现此文件。用户空间应用程序可以读取和写入此文件，以确定和控制物理功能 (PF) 上虚拟功能 (VF) 的启用或禁用。读取此文件将返回在此PF上启用的VF数量。写入此文件的数字将启用指定数量的VF。用户空间应用程序通常会读取该文件并检查该值是否为零，然后写入应在PF上启用的VF数量；写入的值应小于或等于sriov_totalvfs文件中的值。想要禁用VF的用户空间应用程序会向此文件写入零。核心会确保写入此文件的值有效，并在值无效时返回错误。例如，当sriov_numvfs不是0且不是2时，向此文件写入2将返回错误。当sriov_totalvfs的值为8时写入10将返回错误。

/sys/bus/pci/devices/.../sriov_totalvfs

在文件 sysfs-bus-pci 中定义

当物理PCIe设备支持SR-IOV时，会出现此文件。用户空间应用程序可以读取此文件，以确定PCIe物理功能 (PF) 可以支持的最大虚拟功能 (VF) 数量。通常，这是在PF的SR-IOV扩展功能的TotalVFs元素中报告的值。驱动程序可以在探测时通过pci_sriov_set_totalvfs()函数减少从此文件中读取的值。

/sys/bus/pci/devices/.../sriov_vf_msix_count

在文件 sysfs-bus-pci 中定义

此文件与SR-IOV虚拟功能 (VF) 相关联。它允许配置VF的MSI-X向量数量。这允许具有MSI-X向量全局池的设备根据VF使用情况在VF之间最佳地分配它们。

接受的值为
  • > 0 - 此数字将作为表大小在

    VF的MSI-X功能中报告

  • < 0 - 无效

  • = 0 - 将重置为设备默认值

如果PF绑定到实现->sriov_set_msix_vec_count()的驱动程序，则该文件是可写的。

/sys/bus/pci/devices/.../sriov_vf_total_msix

在文件 sysfs-bus-pci 中定义

此文件与SR-IOV物理功能 (PF) 相关联。它包含可分配给与PF关联的所有虚拟功能 (VF) 的MSI-X向量总数。如果设备不支持此功能，则该值将为零。对于支持的设备，该值将是恒定的，并且在分配MSI-X向量后不会更改。

/sys/bus/pci/devices/.../virtfn<N>

在文件 sysfs-bus-pci 中定义

当硬件支持SR-IOV功能并且物理功能驱动程序已启用它时，会出现此符号链接。该符号链接指向索引为N (0...MaxVFs-1) 的虚拟功能的PCI设备sysfs条目。

/sys/bus/pci/devices/.../vpd

在文件 sysfs-bus-pci 中定义

设备目录中名为vpd的文件将是一个包含设备重要产品数据的二进制文件。它应遵循PCI规范2.1或2.2中定义的VPD格式，但用户应考虑某些设备可能具有格式不正确的数据。如果底层VPD具有可写部分，则此文件的相应部分将是可写的。

/sys/bus/pci/devices/<BDF>/anti_rollback_status

在文件sysfs-driver-ccp中定义

/sys/bus/pci/devices/<BDF>/anti_rollback_status文件报告PSP是否正在强制执行回滚保护。可能的值：0：不强制执行 1：强制执行

/sys/bus/pci/devices/<BDF>/bootloader_version

在文件sysfs-driver-ccp中定义

/sys/bus/pci/devices/<BDF>/bootloader_version文件报告AMD AGESA引导加载程序的固件版本。

/sys/bus/pci/devices/<BDF>/debug_lock_on

在文件sysfs-driver-ccp中定义

/sys/bus/pci/devices/<BDF>/debug_lock_on 报告 AMD CPU 或 APU 是否已解锁以进行调试。可能的值：0：未锁定 1：已锁定

/sys/bus/pci/devices/<BDF>/fused_part

在文件sysfs-driver-ccp中定义

/sys/bus/pci/devices/<BDF>/fused_part 文件报告 CPU 或 APU 是否已熔断以防止篡改。0：未熔断 1：已熔断

/sys/bus/pci/devices/<BDF>/hsp_tpm_available

在文件sysfs-driver-ccp中定义

/sys/bus/pci/devices/<BDF>/hsp_tpm_available 文件报告 HSP TPM 是否已激活。可能的值：0：未激活或不存在 1：已激活

/sys/bus/pci/devices/<BDF>/qat/auto_reset

定义在文件 sysfs-driver-qat

（读写）报告 QAT 设备自动重置功能的当前状态

写入该属性以启用或禁用设备自动重置。

设备自动重置默认禁用。

值如下：

  • 1/Yy/on：启用自动重置。如果设备遇到无法恢复的错误，它将自动重置。

  • 0/Nn/off：禁用自动重置。如果设备遇到无法恢复的错误，它将不会被重置。

此属性仅适用于 qat_4xxx 设备。

/sys/bus/pci/devices/<BDF>/qat/cfg_services

定义在文件 sysfs-driver-qat

（读写）报告 QAT 设备的当前配置。写入该文件以更改配置的服务。

值如下：

  • sym;asym：设备配置为运行加密服务

  • asym;sym：与 sym;asym 相同

  • dc：设备配置为运行压缩服务

  • dcc：与 dc 相同，但启用了 dc 链接功能，即哈希然后压缩。如果不需要此功能，请选择 dc

  • sym：设备配置为运行对称加密服务

  • asym：设备配置为运行非对称加密服务

  • asym;dc：设备配置为运行非对称加密服务和压缩服务

  • dc;asym：与 asym;dc 相同

  • sym;dc：设备配置为运行对称加密服务和压缩服务

  • dc;sym：与 sym;dc 相同

只有当设备处于 down 状态时才能设置配置（请参阅 /sys/bus/pci/devices/<BDF>/qat/state）

以下示例演示如何更改配置为运行加密服务的设备以运行数据压缩

# cat /sys/bus/pci/devices/<BDF>/qat/state
up
# cat /sys/bus/pci/devices/<BDF>/qat/cfg_services
sym;asym
# echo down > /sys/bus/pci/devices/<BDF>/qat/state
# echo dc > /sys/bus/pci/devices/<BDF>/qat/cfg_services
# echo up > /sys/bus/pci/devices/<BDF>/qat/state
# cat /sys/bus/pci/devices/<BDF>/qat/cfg_services
dc

此属性仅适用于 qat_4xxx 设备。

/sys/bus/pci/devices/<BDF>/qat/num_rps

定义在文件 sysfs-driver-qat

（只读）返回单个设备拥有的环对数量。

使用示例

# cat /sys/bus/pci/devices/<BDF>/qat/num_rps
64

此属性仅适用于 qat_4xxx 设备。

/sys/bus/pci/devices/<BDF>/qat/pm_idle_enabled

定义在文件 sysfs-driver-qat

（读写）此配置选项提供了一种强制设备保持在最大功率状态的方法。如果启用了空闲支持，设备在空闲时将转换为 MIN 功率状态，否则将保持在最大功率状态。写入该文件以启用或禁用空闲支持。

值如下：

  • 0：禁用空闲支持

  • 1：启用空闲支持

默认值为 1。

只有当设备处于 down 状态时才能设置 pm_idle_enabled 值（请参阅 /sys/bus/pci/devices/<BDF>/qat/state）

以下示例演示如何更改设备的 pm_idle_enabled

# cat /sys/bus/pci/devices/<BDF>/qat/state
up
# cat /sys/bus/pci/devices/<BDF>/qat/pm_idle_enabled
1
# echo down > /sys/bus/pci/devices/<BDF>/qat/state
# echo 0 > /sys/bus/pci/devices/<BDF>/qat/pm_idle_enabled
# echo up > /sys/bus/pci/devices/<BDF>/qat/state
# cat /sys/bus/pci/devices/<BDF>/qat/pm_idle_enabled
0

此属性仅适用于 qat_4xxx 设备。

/sys/bus/pci/devices/<BDF>/qat/rp2srv

定义在文件 sysfs-driver-qat

（读写）此属性为用户提供了一种查询特定环对当前配置的服务类型的方法。

写入时，该值将被缓存并用于执行读取操作。允许的值范围为 0 到 N-1，其中 N 是设备支持的最大环对数。可以使用属性 qat/num_rps 查询此值。

读取操作将返回与查询的环对关联的服务。

值如下：

  • dc：环对配置为运行压缩服务

  • sym：环对配置为运行对称加密服务

  • asym：环对配置为运行非对称加密服务

使用示例

# echo 1 > /sys/bus/pci/devices/<BDF>/qat/rp2srv
# cat /sys/bus/pci/devices/<BDF>/qat/rp2srv
sym

此属性仅适用于 qat_4xxx 设备。

/sys/bus/pci/devices/<BDF>/qat/state

定义在文件 sysfs-driver-qat

（读写）报告 QAT 设备的当前状态。写入该文件以启动或停止设备。

值如下：

  • up：设备已启动并正在运行

  • down：设备已关闭

只有当设备处于启动状态时才能将其转换为关闭状态，反之亦然。

此属性仅适用于 qat_4xxx 设备。

/sys/bus/pci/devices/<BDF>/qat_ras/errors_correctable

定义在文件 sysfs-driver-qat_ras

（只读）报告设备检测到的可纠正错误的数量。

此属性仅适用于 qat_4xxx 设备。

/sys/bus/pci/devices/<BDF>/qat_ras/errors_fatal

定义在文件 sysfs-driver-qat_ras

（只读）报告设备检测到的致命错误的数量。

此属性仅适用于 qat_4xxx 设备。

/sys/bus/pci/devices/<BDF>/qat_ras/errors_nonfatal

定义在文件 sysfs-driver-qat_ras

（只读）报告设备检测到的非致命错误的数量。

此属性仅适用于 qat_4xxx 设备。

/sys/bus/pci/devices/<BDF>/qat_ras/reset_error_counters

定义在文件 sysfs-driver-qat_ras

（只写）写入此文件以重置设备的所有错误计数器。

以下示例报告如何重置计数器

# echo 1 > /sys/bus/pci/devices/<BDF>/qat_ras/reset_error_counters
# cat /sys/bus/pci/devices/<BDF>/qat_ras/errors_correctable
0
# cat /sys/bus/pci/devices/<BDF>/qat_ras/errors_nonfatal
0
# cat /sys/bus/pci/devices/<BDF>/qat_ras/errors_fatal
0

此属性仅适用于 qat_4xxx 设备。

/sys/bus/pci/devices/<BDF>/qat_rl/cap_rem

定义在文件 sysfs-driver-qat_rl

（读写）此文件将返回特定服务/SLA 的剩余容量。这是可以为新 SLA 设置或增加当前 SLA 的剩余值。

使用示例

# echo "asym" > /sys/bus/pci/devices/<BDF>/qat_rl/cap_rem
# cat /sys/bus/pci/devices/<BDF>/qat_rl/cap_rem
250
# echo 250 > /sys/bus/pci/devices/<BDF>/qat_rl/cir
# echo "add" > /sys/bus/pci/devices/<BDF>/qat_rl/sla_op
# cat /sys/bus/pci/devices/<BDF>/qat_rl/cap_rem
0

此属性仅适用于 qat_4xxx 设备。

/sys/bus/pci/devices/<BDF>/qat_rl/cir

定义在文件 sysfs-driver-qat_rl

（读写）承诺信息速率 (CIR)。保证特定 SLA 达到的速率。该值以千分比表示，即 1000 表示所选服务的最大设备吞吐量。

在向 sla_op 发送“get”之后，此值将被填充为该查询的 SLA 的 CIR。在发送“add/update” sla_op 之前写入此文件，以将 SLA 设置为指定的值。

sla_op 中的适用性

  • WRITE：添加和更新操作

  • READ：获取操作

使用示例

## Write
# echo 500 > /sys/bus/pci/devices/<BDF>/qat_rl/cir
# echo "add" /sys/bus/pci/devices/<BDF>/qat_rl/sla_op

## Read
# echo 4 > /sys/bus/pci/devices/<BDF>/qat_rl/id
# echo "get" > /sys/bus/pci/devices/<BDF>/qat_rl/sla_op
# cat /sys/bus/pci/devices/<BDF>/qat_rl/cir
500

此属性仅适用于 qat_4xxx 设备。

/sys/bus/pci/devices/<BDF>/qat_rl/id

定义在文件 sysfs-driver-qat_rl

（读写）如果写入，该值用于检索特定的 SLA 并对其进行操作。这仅对以下操作有效：更新、删除和获取。只有在创建 SLA 后，才能保证读取此属性的数据正确。

sla_op 中的适用性

  • WRITE：删除和更新操作

  • READ：添加和获取操作

使用示例

## Read
## Set attributes e.g. cir, pir, srv, etc
# echo "add" > /sys/bus/pci/devices/<BDF>/qat_rl/sla_op
# cat /sys/bus/pci/devices/<BDF>/qat_rl/id
4

## Write
# echo 7 > /sys/bus/pci/devices/<BDF>/qat_rl/id
# echo "get" > /sys/bus/pci/devices/<BDF>/qat_rl/sla_op
# cat /sys/bus/pci/devices/<BDF>/qat_rl/rp
0x5  ## ring pair ID 0 and ring pair ID 2

此属性仅适用于 qat_4xxx 设备。

/sys/bus/pci/devices/<BDF>/qat_rl/pir

定义在文件 sysfs-driver-qat_rl

（读写）峰值信息速率 (PIR)。特定 SLA 可以达到的最大速率。当设备未被其他用户（分配给不同 SLA）的请求完全利用时，SLA 可以达到 CIR 和 PIR 之间的值。

在向 sla_op 发送“get”之后，此值将被填充为该查询的 SLA 的 PIR。在发送“add/update” sla_op 之前写入此文件，以将 SLA 设置为指定的值。

sla_op 中的适用性

  • WRITE：添加和更新操作

  • READ：获取操作

使用示例

## Write
# echo 750 > /sys/bus/pci/devices/<BDF>/qat_rl/pir
# echo "add" > /sys/bus/pci/devices/<BDF>/qat_rl/sla_op

## Read
# echo 4 > /sys/bus/pci/devices/<BDF>/qat_rl/id
# echo "get" > /sys/bus/pci/devices/<BDF>/qat_rl/sla_op
# cat /sys/bus/pci/devices/<BDF>/qat_rl/pir
750

此属性仅适用于 qat_4xxx 设备。

/sys/bus/pci/devices/<BDF>/qat_rl/rp

定义在文件 sysfs-driver-qat_rl

（读写）读取时，报告查询的 SLA 当前分配的环对。写入时，配置与新 SLA 关联的环对。

该值是一个 64 位位掩码，以十六进制写入/显示。此掩码的每一位代表一个环对，例如，位 1 == 环对 ID 0；位 3 == 环对 ID 2。

选定的环对必须分配给单个服务，即 srv 属性提供的服务。可以通过查询属性 qat/rp2srv 来检查分配给特定环对的服务。

每个 SLA 的最大环对数为 4。

sla_op 中的适用性

  • WRITE：添加操作

  • READ：获取操作

使用示例

## Read
# echo 4 > /sys/bus/pci/devices/<BDF>/qat_rl/id
# cat /sys/bus/pci/devices/<BDF>/qat_rl/rp
0x5

## Write
# echo 0x5 > /sys/bus/pci/devices/<BDF>/qat_rl/rp

此属性仅适用于 qat_4xxx 设备。

/sys/bus/pci/devices/<BDF>/qat_rl/sla_op

定义在文件 sysfs-driver-qat_rl

（只写）此属性用于对 SLA 执行操作。支持的操作有：add、update、rm、rm_all 和 get。

必须先通过此组中的关联属性填充输入值，然后才能写入此文件。如果操作成功完成，关联的属性将被更新。关联的属性为：cir、pir、srv、rp 和 id。

支持的操作

  • add：使用用户提供的输入创建新的 SLA。

    • 输入：cir、pir、srv 和 rp

    • 输出：id

  • get：返回 id 属性中指定的 SLA 的配置

    • 输入：id

    • 输出：cir、pir、srv 和 rp

  • update：使用以下属性中设置的新值更新 SLA

    • 输入：id、cir 和 pir

  • rm：删除 id 属性中指定的 SLA。

    • 输入：id

  • rm_all：删除所有配置的 SLA。

    • 输入：无

此属性仅适用于 qat_4xxx 设备。

/sys/bus/pci/devices/<BDF>/qat_rl/srv

定义在文件 sysfs-driver-qat_rl

（读写）服务 (SRV)。表示与 SLA 关联的服务（sym、asym、dc）。可以写入或查询以设置/显示 SLA 的 SRV 类型。SRV 属性用于在添加 SLA 之前指定 SRV 类型。配置 SLA 后，报告与该 SLA 关联的服务。

sla_op 中的适用性

  • WRITE：添加和更新操作

  • READ：获取操作

使用示例

## Write
# echo "dc" > /sys/bus/pci/devices/<BDF>/qat_rl/srv
# echo "add" > /sys/bus/pci/devices/<BDF>/qat_rl/sla_op
# cat /sys/bus/pci/devices/<BDF>/qat_rl/id
4

## Read
# echo 4 > /sys/bus/pci/devices/<BDF>/qat_rl/id
# echo "get" > /sys/bus/pci/devices/<BDF>/qat_rl/sla_op
# cat /sys/bus/pci/devices/<BDF>/qat_rl/srv
dc

此属性仅适用于 qat_4xxx 设备。

/sys/bus/pci/devices/<BDF>/rom_armor_enforced

在文件sysfs-driver-ccp中定义

/sys/bus/pci/devices/<BDF>/rom_armor_enforced 文件报告是否强制执行 RomArmor SPI 保护。可能的值：0：未强制执行 1：已强制执行

/sys/bus/pci/devices/<BDF>/rpmc_production_enabled

在文件sysfs-driver-ccp中定义

/sys/bus/pci/devices/<BDF>/rpmc_production_enabled 文件报告是否已启用重放保护单调计数器支持。可能的值：0：未启用 1：已启用

/sys/bus/pci/devices/<BDF>/rpmc_spirom_available

在文件sysfs-driver-ccp中定义

/sys/bus/pci/devices/<BDF>/rpmc_spirom_available 文件报告系统上是否安装了支持重放保护单调计数器的 SPI。可能的值：0：不存在 1：存在

/sys/bus/pci/devices/<BDF>/tee_version

在文件sysfs-driver-ccp中定义

/sys/bus/pci/devices/<BDF>/tee_version 文件报告 AMD 可信执行环境 (TEE) 的固件版本。

/sys/bus/pci/devices/<BDF>/tsme_status

在文件sysfs-driver-ccp中定义

/sys/bus/pci/devices/<BDF>/tsme_status 文件报告 AMD 系统上透明安全内存加密的状态。可能的值：0：未激活 1：已激活

/sys/bus/pci/devices/<dev>/aer_dev_correctable

定义在文件 sysfs-bus-pci-devices-aer_stats

使用 ERR_COR 查看和报告的此 PCI 设备检测到的可纠正错误的列表。请注意，由于可以使用单个 ERR_COR 消息报告多个错误，因此文件末尾的 TOTAL_ERR_COR 可能与文件中所有错误的实际总数不匹配。示例输出

localhost /sys/devices/pci0000:00/0000:00:1c.0 # cat aer_dev_correctable
Receiver Error 2
Bad TLP 0
Bad DLLP 0
RELAY_NUM Rollover 0
Replay Timer Timeout 0
Advisory Non-Fatal 0
Corrected Internal Error 0
Header Log Overflow 0
TOTAL_ERR_COR 2

/sys/bus/pci/devices/<dev>/aer_dev_fatal

定义在文件 sysfs-bus-pci-devices-aer_stats

使用 ERR_FATAL 查看和报告的此 PCI 设备检测到的不可纠正致命错误的列表。请注意，由于可以使用单个 ERR_FATAL 消息报告多个错误，因此文件末尾的 TOTAL_ERR_FATAL 可能与文件中所有错误的实际总数不匹配。示例输出

localhost /sys/devices/pci0000:00/0000:00:1c.0 # cat aer_dev_fatal
Undefined 0
Data Link Protocol 0
Surprise Down Error 0
Poisoned TLP 0
Flow Control Protocol 0
Completion Timeout 0
Completer Abort 0
Unexpected Completion 0
Receiver Overflow 0
Malformed TLP 0
ECRC 0
Unsupported Request 0
ACS Violation 0
Uncorrectable Internal Error 0
MC Blocked TLP 0
AtomicOp Egress Blocked 0
TLP Prefix Blocked Error 0
TOTAL_ERR_FATAL 0

/sys/bus/pci/devices/<dev>/aer_dev_nonfatal

定义在文件 sysfs-bus-pci-devices-aer_stats

使用 ERR_NONFATAL 查看和报告的此 PCI 设备检测到的不可纠正非致命错误的列表。请注意，由于可以使用单个 ERR_FATAL 消息报告多个错误，因此文件末尾的 TOTAL_ERR_NONFATAL 可能与文件中所有错误的实际总数不匹配。示例输出

localhost /sys/devices/pci0000:00/0000:00:1c.0 # cat aer_dev_nonfatal
Undefined 0
Data Link Protocol 0
Surprise Down Error 0
Poisoned TLP 0
Flow Control Protocol 0
Completion Timeout 0
Completer Abort 0
Unexpected Completion 0
Receiver Overflow 0
Malformed TLP 0
ECRC 0
Unsupported Request 0
ACS Violation 0
Uncorrectable Internal Error 0
MC Blocked TLP 0
AtomicOp Egress Blocked 0
TLP Prefix Blocked Error 0
TOTAL_ERR_NONFATAL 0

PCIe 根端口 AER 统计信息

这些属性仅在支持 AER 的根端口（或根复合事件收集器）下显示。它们指示报告给根端口的错误消息数量。请注意，根端口也会（在内部）传输由内部根端口 PCI 设备看到的 ERR_* 消息，因此这些计数器包括它们，并因此是源自该根端口的 PCI 层次结构上所有错误消息的累积。

/sys/bus/pci/devices/<dev>/aer_rootport_total_err_cor

定义在文件 sysfs-bus-pci-devices-aer_stats

报告给根端口的 ERR_COR 消息总数。

/sys/bus/pci/devices/<dev>/aer_rootport_total_err_fatal

定义在文件 sysfs-bus-pci-devices-aer_stats

报告给根端口的 ERR_FATAL 消息总数。

/sys/bus/pci/devices/<dev>/aer_rootport_total_err_nonfatal

定义在文件 sysfs-bus-pci-devices-aer_stats

报告给根端口的 ERR_NONFATAL 消息总数。

/sys/bus/pci/devices/<dev>/ccissX/cXdY/block:cciss!cXdY

定义在文件 sysfs-bus-pci-devices-cciss 中

指向 /sys/block/cciss!cXdY 的符号链接

/sys/bus/pci/devices/<dev>/ccissX/cXdY/lunid

定义在文件 sysfs-bus-pci-devices-cciss 中

显示用于寻址控制器 X 的逻辑驱动器 Y 的 8 字节 LUN ID。

/sys/bus/pci/devices/<dev>/ccissX/cXdY/model

定义在文件 sysfs-bus-pci-devices-cciss 中

显示控制器 X 的逻辑驱动器 Y 的 SCSI INQUIRY 页面 0 模型。

/sys/bus/pci/devices/<dev>/ccissX/cXdY/raid_level

定义在文件 sysfs-bus-pci-devices-cciss 中

显示控制器 X 的逻辑驱动器 Y 的 RAID 级别。

/sys/bus/pci/devices/<dev>/ccissX/cXdY/rev

定义在文件 sysfs-bus-pci-devices-cciss 中

显示控制器 X 的逻辑驱动器 Y 的 SCSI INQUIRY 页面 0 修订版。

/sys/bus/pci/devices/<dev>/ccissX/cXdY/unique_id

定义在文件 sysfs-bus-pci-devices-cciss 中

显示控制器 X 的逻辑驱动器 Y 的 SCSI INQUIRY 页面 83 序列号。

/sys/bus/pci/devices/<dev>/ccissX/cXdY/usage_count

定义在文件 sysfs-bus-pci-devices-cciss 中

显示控制器 X 的逻辑驱动器 Y 的使用计数（打开次数）。

/sys/bus/pci/devices/<dev>/ccissX/cXdY/vendor

定义在文件 sysfs-bus-pci-devices-cciss 中

显示控制器 X 的逻辑驱动器 Y 的 SCSI INQUIRY 页面 0 供应商。

/sys/bus/pci/devices/<dev>/ccissX/rescan

定义在文件 sysfs-bus-pci-devices-cciss 中

启动控制器的重新扫描，以发现逻辑驱动器拓扑结构的变化。

/sys/bus/pci/devices/<dev>/ccissX/resettable

定义在文件 sysfs-bus-pci-devices-cciss 中

值 1 表示控制器可以响应 reset_devices 内核参数。值 0 表示无法响应 reset_devices。这是为了允许，例如，kexec 工具在用户将不可重置的设备指定为转储设备时发出警告，因为 kdump 需要重置设备才能可靠地工作。

/sys/bus/pci/devices/<dev>/ccissX/transport_mode

定义在文件 sysfs-bus-pci-devices-cciss 中

值 “simple” 表示控制器已置于“简单模式”。值 “performant” 表示控制器已置于“高性能模式”。

/sys/bus/pci/drivers/.../bind

/sys/devices/pciX/.../bind

在文件 sysfs-bus-pci 中定义

将设备位置写入此文件将导致驱动程序尝试绑定到在此位置找到的设备。这对于覆盖默认绑定很有用。位置的格式为：DDDD:BB:DD.F。即域:总线:设备.功能，与 /sys/bus/pci/devices/ 中找到的相同。例如

# echo 0000:00:19.0 > /sys/bus/pci/drivers/foo/bind

（注意：2.6.28 之前的内核可能需要 echo -n）。

/sys/bus/pci/drivers/.../new_id

/sys/devices/pciX/.../new_id

在文件 sysfs-bus-pci 中定义

将设备 ID 写入此文件将尝试动态地将新的设备 ID 添加到 PCI 设备驱动程序。这可能允许驱动程序支持比编译时驱动程序的静态设备 ID 支持表中包含的更多硬件。设备 ID 的格式为：VVVV DDDD SVVV SDDD CCCC MMMM PPPP。即供应商 ID、设备 ID、子系统供应商 ID、子系统设备 ID、类、类掩码和私有驱动程序数据。供应商 ID 和设备 ID 字段是必需的，其余字段是可选的。成功添加 ID 后，驱动程序将探测设备并尝试绑定到它。例如

# echo "8086 10f5" > /sys/bus/pci/drivers/foo/new_id

/sys/bus/pci/drivers/.../remove_id

/sys/devices/pciX/.../remove_id

在文件 sysfs-bus-pci 中定义

将设备 ID 写入此文件将删除通过 new_id sysfs 条目动态添加的 ID。设备 ID 的格式为：VVVV DDDD SVVV SDDD CCCC MMMM。即供应商 ID、设备 ID、子系统供应商 ID、子系统设备 ID、类和类掩码。供应商 ID 和设备 ID 字段是必需的，其余字段是可选的。成功删除 ID 后，驱动程序将不再支持该设备。这对于确保自动探测不会将驱动程序与设备匹配很有用。例如

# echo "8086 10f5" > /sys/bus/pci/drivers/foo/remove_id

/sys/bus/pci/drivers/.../unbind

/sys/devices/pciX/.../unbind

在文件 sysfs-bus-pci 中定义

将设备位置写入此文件将导致驱动程序尝试从在此位置找到的设备解除绑定。这在覆盖默认绑定时可能很有用。位置的格式为：DDDD:BB:DD.F。即域:总线:设备.功能，与 /sys/bus/pci/devices/ 中找到的相同。例如

# echo 0000:00:19.0 > /sys/bus/pci/drivers/foo/unbind

（注意：2.6.28 之前的内核可能需要 echo -n）。

/sys/bus/pci/drivers/altera-cvp/chkcfg

定义在文件 sysfs-driver-altera-cvp 中

包含 1 或 0，并控制 altera-cvp 驱动程序中的配置错误检查是否开启。

/sys/bus/pci/drivers/ehci_hcd/.../companion

定义在文件 sysfs-bus-pci-drivers-ehci_hcd 中

基于 PCI 的 EHCI USB 控制器（即高速 USB-2.0 控制器）通常与一组“伴随”的全/低速 USB-1.1 控制器一起实现。当插入高速设备时，连接会路由到 EHCI 控制器；当插入全速或低速设备时，连接会路由到伴随控制器。

有时您想强制高速设备以全速连接，这可以通过强制将连接路由到伴随控制器来实现。这就是此文件的作用。将端口号写入文件会导致该端口上的连接路由到伴随控制器，而写入端口号的负数则使端口恢复正常运行。

例如：要强制连接到总线 2 上端口 4 的高速设备以全速运行

echo 4 >/sys/bus/usb/devices/usb2/../companion

要使端口恢复高速运行

echo -4 >/sys/bus/usb/devices/usb2/../companion

读取该文件会给出当前强制到伴随控制器的端口列表。

注意：某些 EHCI 控制器没有伴随控制器；它们可能包含一个内部“事务转换器”，或者它们可能直接连接到“速率匹配集线器”。此机制不适用于此类控制器。此外，它不能用于强制高速集线器上的端口以全速连接。

注意：当首次添加此文件时，它出现在不同的 sysfs 目录中。上面给出的位置对于 2.6.35（可能还有几个更早的内核版本）是正确的。

/sys/bus/pci/drivers/i915/.../hwmon/hwmon<i>/curr1_crit

定义在文件 sysfs-driver-intel-i915-hwmon 中

读写。以毫安为单位的卡片反应临界（I1）功率限制。

服务器产品会暴露以毫安为单位的卡片反应临界（I1）功率限制。如果窗口的平均功率超过此限制，电源控制器将节流运行频率。

仅支持特定的 Intel i915 图形平台。

/sys/bus/pci/drivers/i915/.../hwmon/hwmon<i>/energy1_input

定义在文件 sysfs-driver-intel-i915-hwmon 中

只读。以微焦耳为单位的设备或 gt 的能量输入。

对于 i915 设备级别的 hwmon 设备（名称为“i915”），这反映了整个设备的能量输入。对于 gt 级别的 hwmon 设备（名称为“i915_gtN”），这反映了 gt 的能量输入。

仅支持特定的 Intel i915 图形平台。

/sys/bus/pci/drivers/i915/.../hwmon/hwmon<i>/fan1_input

定义在文件 sysfs-driver-intel-i915-hwmon 中

只读。以 RPM 为单位的设备风扇速度。

仅支持特定的 Intel i915 图形平台。

/sys/bus/pci/drivers/i915/.../hwmon/hwmon<i>/in0_input

定义在文件 sysfs-driver-intel-i915-hwmon 中

只读。以毫伏为单位的当前电压。

仅支持特定的 Intel i915 图形平台。

/sys/bus/pci/drivers/i915/.../hwmon/hwmon<i>/power1_crit

定义在文件 sysfs-driver-intel-i915-hwmon 中

读写。以微瓦为单位的卡片反应临界（I1）功率限制。

客户端产品会暴露以微瓦为单位的卡片反应临界（I1）功率限制。如果窗口的平均功率超过此限制，电源控制器将节流运行频率。

仅支持特定的 Intel i915 图形平台。

/sys/bus/pci/drivers/i915/.../hwmon/hwmon<i>/power1_max

定义在文件 sysfs-driver-intel-i915-hwmon 中

读写。以微瓦为单位的卡片反应持续（PL1/Tau）功率限制。

如果窗口（通常为秒）的平均功率超过此限制，电源控制器将节流运行频率。读取值为 0 表示 PL1 功率限制已禁用，写入 0 会禁用该限制。写入 > 0 的值将启用功率限制。

仅支持特定的 Intel i915 图形平台。

/sys/bus/pci/drivers/i915/.../hwmon/hwmon<i>/power1_max_interval

定义在文件 sysfs-driver-intel-i915-hwmon 中

读写。持续功率限制间隔（PL1/Tau 中的 Tau），以毫秒为单位，在持续功率上取平均值。

仅支持特定的 Intel i915 图形平台。

/sys/bus/pci/drivers/i915/.../hwmon/hwmon<i>/power1_rated_max

定义在文件 sysfs-driver-intel-i915-hwmon 中

只读。卡片默认功率限制（默认 TDP 设置）。

仅支持特定的 Intel i915 图形平台。

/sys/bus/pci/drivers/i915/.../hwmon/hwmon<i>/temp1_input

定义在文件 sysfs-driver-intel-i915-hwmon 中

只读。以毫摄氏度为单位的 GPU 封装温度。

仅支持特定的 Intel i915 图形平台。

/sys/bus/pci/drivers/janz-cmodio/.../modulbus_number

定义在文件 sysfs-bus-pci-drivers-janz-cmodio 中

表示 janz 载板 CMOD-IO 或 CAN-PCI2 的十六进制开关 S2 的值

只读：配置开关的值 (0..15)

/sys/bus/pci/drivers/pciback/allow_interrupt_control

定义在文件 sysfs-driver-pciback 中

可以由连接的客户机设置中断控制标志（INTx、MSI、MSI-X）的设备列表。它旨在仅在客户机是托管设备模型 (qemu) 的存根域，并且实际设备分配给 HVM 时设置。对于分配给 PV 客户机的设备，设置它是不安全的（类似于 permissive 属性）。当连接的 pcifront 终止时，该设备将自动从此列表中删除。

/sys/bus/pci/drivers/pciback/quirks

定义在文件 sysfs-driver-pciback 中

如果设置了 permissive 属性，则以 DDDD:BB:DD.F-REG:SIZE:MASK 格式写入字符串将允许客户机从 PCI 设备读取和写入。即域:总线:设备.功能-寄存器:大小:掩码（域是可选的）。例如

#echo 00:19.0-E0:2:FF > /sys/bus/pci/drivers/pciback/quirks

将允许客户机读取和写入配置寄存器 0x0E。

/sys/bus/pci/drivers/xe/.../hwmon/hwmon<i>/curr2_crit

定义在文件 sysfs-driver-intel-xe-hwmon 中

读写。以毫安为单位的封装反应临界（I1）功率限制。

服务器产品会暴露以毫安为单位的封装反应临界（I1）功率限制。如果窗口的平均功率超过此限制，电源控制器将节流运行频率。

/sys/bus/pci/drivers/xe/.../hwmon/hwmon<i>/energy1_input

定义在文件 sysfs-driver-intel-xe-hwmon 中

只读。以微焦耳为单位的设备卡能量输入。

仅支持特定的 Intel Xe 图形平台。

/sys/bus/pci/drivers/xe/.../hwmon/hwmon<i>/energy2_input

定义在文件 sysfs-driver-intel-xe-hwmon 中

只读。以微焦耳为单位的设备封装能量输入。

仅支持特定的 Intel Xe 图形平台。

/sys/bus/pci/drivers/xe/.../hwmon/hwmon<i>/in1_input

定义在文件 sysfs-driver-intel-xe-hwmon 中

只读。以毫伏为单位的封装当前电压。

仅支持特定的 Intel Xe 图形平台。

/sys/bus/pci/drivers/xe/.../hwmon/hwmon<i>/power1_max

定义在文件 sysfs-driver-intel-xe-hwmon 中

读写。以微瓦为单位的卡片反应持续（PL1）功率限制。

如果窗口（通常为秒）的平均功率超过此限制，电源控制器将节流运行频率。读取值为 0 表示 PL1 功率限制已禁用，写入 0 会禁用该限制。写入 > 0 且 <= TDP 的值将启用功率限制。

仅支持特定的 Intel Xe 图形平台。

/sys/bus/pci/drivers/xe/.../hwmon/hwmon<i>/power1_max_interval

定义在文件 sysfs-driver-intel-xe-hwmon 中

读写。卡片持续功率限制间隔（PL1/Tau 中的 Tau），以毫秒为单位，在持续功率上取平均值。

仅支持特定的 Intel Xe 图形平台。

/sys/bus/pci/drivers/xe/.../hwmon/hwmon<i>/power1_rated_max

定义在文件 sysfs-driver-intel-xe-hwmon 中

只读。卡片默认功率限制（默认 TDP 设置）。

仅支持特定的 Intel Xe 图形平台。

/sys/bus/pci/drivers/xe/.../hwmon/hwmon<i>/power2_crit

定义在文件 sysfs-driver-intel-xe-hwmon 中

读写。封装反应临界 (I1) 功耗限制，单位为微瓦。

客户端产品会暴露封装反应临界 (I1) 功耗限制，单位为微瓦。如果窗口内的平均功耗超过此限制，电源控制器将节流运行频率。

仅支持特定的 Intel Xe 图形平台。

/sys/bus/pci/drivers/xe/.../hwmon/hwmon<i>/power2_max

定义在文件 sysfs-driver-intel-xe-hwmon 中

读写。封装持续 (PL1) 功耗限制，单位为微瓦。

如果窗口（通常为秒）的平均功率超过此限制，电源控制器将节流运行频率。读取值为 0 表示 PL1 功率限制已禁用，写入 0 会禁用该限制。写入 > 0 且 <= TDP 的值将启用功率限制。

仅支持特定的 Intel Xe 图形平台。

/sys/bus/pci/drivers/xe/.../hwmon/hwmon<i>/power2_max_interval

定义在文件 sysfs-driver-intel-xe-hwmon 中

读写。封装持续功耗限制间隔（PL1/Tau 中的 Tau），单位为毫秒，表示计算持续功耗的平均时间窗口。

仅支持特定的 Intel Xe 图形平台。

/sys/bus/pci/drivers/xe/.../hwmon/hwmon<i>/power2_rated_max

定义在文件 sysfs-driver-intel-xe-hwmon 中

只读。封装默认功耗限制（默认 TDP 设置）。

仅支持特定的 Intel Xe 图形平台。

/sys/bus/pci/drivers/xhci_hcd/.../dbc

定义在文件 sysfs-bus-pci-drivers-xhci_hcd 中

xHCI 兼容的 USB 主机控制器（即超高速 USB3 控制器）通常使用调试功能 (DbC) 实现。它可以呈现一个完全符合 USB 框架的调试设备，并为调试目的提供等效于高性能全双工串行链路的功能。

DbC 调试设备与 xHCI 主机共享一个根端口。启用 DbC 时，根端口将分配给调试功能。否则，它将分配给 xHCI。

向此属性写入“enable”将启用 DbC 功能，共享根端口将分配给 DbC 设备。向此属性写入“disable”将禁用 DbC 功能，共享根端口将回滚到 xHCI。

读取此属性可获得 DbC 的状态。它可能是以下状态之一：disabled（禁用）、enabled（启用）、initialized（已初始化）、connected（已连接）、configured（已配置）和 stalled（停滞）。

/sys/bus/pci/drivers/xhci_hcd/.../dbc_bInterfaceProtocol

定义在文件 sysfs-bus-pci-drivers-xhci_hcd 中

此属性允许我们更改 xhci 调试设备在 USB 接口描述符中呈现的 bInterfaceProtocol 字段。只有当调试功能 (DbC) 处于禁用状态时才能更改此值，以防止在连接到 USB 主机时更改 USB 描述符。默认值为 1（GNU 远程调试命令）。另一个允许的值是 0，用于供应商定义的调试目标。

/sys/bus/pci/drivers/xhci_hcd/.../dbc_bcdDevice

定义在文件 sysfs-bus-pci-drivers-xhci_hcd 中

此 dbc_bcdDevice 属性允许我们更改此 xhci 调试设备在 USB 设备描述符中呈现的 bcdDevice 字段。只有当调试功能 (DbC) 处于禁用状态时才能更改此值，以防止在连接到 USB 主机时更改 USB 设备描述符。默认值为 0x0010。（设备版本 0.10）它可以是任何 16 位整数。

/sys/bus/pci/drivers/xhci_hcd/.../dbc_idProduct

定义在文件 sysfs-bus-pci-drivers-xhci_hcd 中

此 dbc_idProduct 属性允许我们更改此 xhci 调试设备在 USB 设备描述符中呈现的 idProduct 字段。只有当调试功能 (DbC) 处于禁用状态时才能更改此值，以防止在连接到 USB 主机时更改 USB 设备描述符。默认值为 0x0010。它可以是任何 16 位整数。

/sys/bus/pci/drivers/xhci_hcd/.../dbc_idVendor

定义在文件 sysfs-bus-pci-drivers-xhci_hcd 中

此 dbc_idVendor 属性允许我们更改此 xhci 调试设备在 USB 设备描述符中呈现的 idVendor 字段。只有当调试功能 (DbC) 处于禁用状态时才能更改此值，以防止在连接到 USB 主机时更改 USB 设备描述符。默认值为 0x1d6b (Linux Foundation)。它可以是任何 16 位整数。

/sys/bus/pci/drivers/xhci_hcd/.../dbc_poll_interval_ms

定义在文件 sysfs-bus-pci-drivers-xhci_hcd 中

此属性调整用于检查 DbC 事件的轮询间隔。单位为毫秒。接受的值范围为 0 到 5000。默认值为 64 毫秒。此轮询间隔在启用 DbC 但没有活动数据传输时使用。

/sys/bus/pci/rescan

在文件 sysfs-bus-pci 中定义

向此属性写入非零值将强制重新扫描系统中的所有 PCI 总线，并重新发现先前删除的设备。

/sys/bus/pci/slots/.../module

在文件 sysfs-bus-pci 中定义

此符号链接指向管理热插拔插槽的 PCI 热插拔控制器驱动程序模块。

/sys/bus/peci/devices/<controller_id>-<device_addr>/remove

定义在文件 sysfs-bus-peci 中

向此属性写入非零值将删除 PECI 设备及其任何子设备。

/sys/bus/peci/rescan

定义在文件 sysfs-bus-peci 中

向此属性写入非零值将启动系统所有 PECI 控制器上的 PECI 设备扫描。

/sys/bus/platform/devices/*/frequency

定义在文件 sysfs-platform-brcmstb-memc 中

DDR PHY 频率，单位为赫兹。

/sys/bus/platform/devices/*/srpd

定义在文件 sysfs-platform-brcmstb-memc 中

自刷新掉电 (SRPD) 非活动超时时间，以内部 DDR 控制器时钟周期计数。可能的值范围为 0（禁用非活动超时）到 65535 (0xffff)。

/sys/bus/platform/devices/*twl4030-usb/vbus

定义在文件 sysfs-platform-twl4030-usb 中

只读状态报告，指示 USB 总线是否正在提供 VBUS（约 5V）电压。

可能的值：“on”、“off”。

更改通过 select/poll 通知。

/sys/bus/platform/devices/.../driver_override

定义在文件 sysfs-bus-platform 中

此文件允许指定设备的驱动程序，该驱动程序将覆盖标准的 OF、ACPI、ID 表和名称匹配。指定后，只有名称与写入 driver_override 的值匹配的驱动程序才有机会绑定到该设备。通过将字符串写入 driver_override 文件来指定覆盖 (echo vfio-platform > driver_override)，并可以使用空字符串清除覆盖 (echo > driver_override)。这将使设备返回到标准的匹配规则绑定。写入 driver_override 不会自动将设备从其当前驱动程序解绑，也不会尝试自动加载指定的驱动程序。如果内核中当前未加载名称匹配的驱动程序，则该设备不会绑定到任何驱动程序。这也允许设备使用“none”之类的 driver_override 名称选择退出驱动程序绑定。在覆盖中只能指定一个驱动程序，不支持解析分隔符。

/sys/bus/platform/devices/.../modalias

定义在文件 sysfs-bus-platform 中

与设备创建时 uevent 中的 MODALIAS 相同。

通过设备树公开的平台设备使用

  • of:N`of 节点名称`T`类型`

其他平台设备则使用

  • platform:驱动程序名称

/sys/bus/platform/devices/.../msi_irqs/

定义在文件 sysfs-bus-platform 中

/sys/devices/.../msi_irqs目录包含一组可变的文件，每个文件都以分配给该设备的相应msi irq向量命名。

/sys/bus/platform/devices/.../msi_irqs/<N>

定义在文件 sysfs-bus-platform 中

如果 <N> 是有效的 msi irq，此属性将显示“msi”。

/sys/bus/platform/devices/.../numa_node

定义在文件 sysfs-bus-platform 中

此文件包含平台设备所连接的 NUMA 节点。如果节点未知，则不会显示此文件。该值来自 ACPI _PXM 方法或类似的固件源。此文件的初始用户将是 arm smmu 等由 arm64 acpi_iort 填充的设备。

/sys/bus/platform/devices/../cfam_reset

定义在文件 sysfs-bus-fsi 中

提供一种重置连接到 FSI 设备的 cfam 的方法。

/sys/bus/platform/devices/../fsi-master/fsi0/break

定义在文件 sysfs-bus-fsi 中

在主设备的通信链路上向任何连接的从设备发送 FSI BREAK 命令。BREAK 命令会重置连接设备的逻辑，并使其准备好接收来自主设备的进一步命令。

/sys/bus/platform/devices/../fsi-master/fsi0/rescan

定义在文件 sysfs-bus-fsi 中

启动 FSI 主设备扫描其链路上所有连接的从设备。

/sys/bus/platform/devices/../fsi-master/fsi0/slave@00:00/raw

定义在文件 sysfs-bus-fsi 中

提供一种从指定的 FSI 总线地址读取/写入 32 位值的方法。

/sys/bus/platform/devices/../fsi-master/fsi0/slave@00:00/term

定义在文件 sysfs-bus-fsi 中

从主设备向其连接的从设备发送 FSI 终止命令。终止命令会重置从设备的状态机，该状态机控制对内部连接引擎的访问。此外，从设备还会冻结其内部错误寄存器以进行调试。如果“主设备超时”计时器过期，也需要此命令来中止任何正在进行的操作。

/sys/bus/platform/devices/<dev>/always_powered_in_suspend

定义在文件 sysfs-bus-platform-onboard-usb-dev 中

（读写）控制 USB 集线器在系统挂起期间是否始终保持通电状态。此属性不适用于非集线器设备。

/sys/bus/platform/devices/ACPI000E:00/ac_alarm

定义在文件 sysfs-devices-platform-ACPI-TAD 中

（读写）AC 报警计时器值。

读取操作返回当前的 AC 报警计时器值（以秒为单位），或者如果 AC 报警未设置为唤醒系统，则返回“disabled”。

写入新的 AC 报警计时器值（以秒为单位）或“disabled”以分别设置 AC 报警计时器或禁用它。

如果通过此属性设置了 AC 报警计时器并且它过期，它将立即从 S3 睡眠状态（如果支持，也从 S4/S5 睡眠状态）唤醒系统，直到其状态通过 ac_status 属性显式清除。

/sys/bus/platform/devices/ACPI000E:00/ac_policy

定义在文件 sysfs-devices-platform-ACPI-TAD 中

（读写）AC 报警过期计时器唤醒策略（详细信息请参阅 ACPI 6.2，第 9.18 节）。

读取操作返回 AC 报警计时器的当前过期计时器唤醒延迟，或者如果策略是在系统使用直流电源时丢弃 AC 计时器唤醒，则返回“never”。

写入新的 AC 报警计时器的过期计时器唤醒延迟（以秒为单位）或“never”，以分别设置 AC 报警计时器的过期计时器唤醒延迟，或者将其过期唤醒策略设置为在系统使用直流电源时丢弃唤醒。

/sys/bus/platform/devices/ACPI000E:00/ac_status

定义在文件 sysfs-devices-platform-ACPI-TAD 中

（读写）AC 报警状态。

读取操作返回表示 AC 报警计时器状态的十六进制位掩码，其中各位的含义如下（请参阅 ACPI 6.2，第 9.18.5 节）

位 (0)

如果设置，则表示计时器已过期。

位 (1)

如果设置，则表示计时器已从睡眠状态（如果支持，则为 S3 或 S4/S5）唤醒系统。

其他位保留。

读取操作也会导致 AC 报警计时器状态被重置。

重置 AC 报警计时器状态的另一种方法是向此文件写入（数字）0。

如果状态返回值指示计时器已过期，它将立即从 S3 睡眠状态（如果支持，也从 S4/S5 睡眠状态）唤醒系统，直到通过此属性显式清除其状态。

/sys/bus/platform/devices/ACPI000E:00/caps

定义在文件 sysfs-devices-platform-ACPI-TAD 中

（只读）平台固件报告的 TAD 属性的十六进制位掩码（请参阅 ACPI 6.2，第 9.18.2 节）

位 (0)

如果设置，则表示已实现 AC 唤醒

位 (1)

如果设置，则表示已实现 DC 唤醒

位 (2)

如果设置，则表示已实现获取/设置实时功能

位 (3)

如果设置，则表示实时精度以毫秒为单位

位 (4)

如果设置，则表示报告了从 S4/S5 唤醒的正确状态

位 (5)

如果设置，则表示 AC 计时器从 S4 唤醒

位 (6)

如果设置，则表示 AC 计时器从 S5 唤醒

位 (7)

如果设置，则表示 DC 计时器从 S4 唤醒

位 (8)

如果设置，则表示 DC 计时器从 S5 唤醒

其他位保留。

/sys/bus/platform/devices/ACPI000E:00/dc_alarm

定义在文件 sysfs-devices-platform-ACPI-TAD 中

(读写，可选) 直流电报警计时器值。

仅当 TAD 支持单独的直流电计时器时，此属性才存在。

它类似于 ac_alarm 属性。

/sys/bus/platform/devices/ACPI000E:00/dc_policy

定义在文件 sysfs-devices-platform-ACPI-TAD 中

(读写，可选) 直流电报警过期计时器唤醒策略。

仅当 TAD 支持单独的直流电计时器时，此属性才存在。

它类似于 ac_policy 属性。

/sys/bus/platform/devices/ACPI000E:00/dc_status

定义在文件 sysfs-devices-platform-ACPI-TAD 中

(读写，可选) 直流电报警状态。

仅当 TAD 支持单独的直流电计时器时，此属性才存在。

它类似于 ac_status 属性。

/sys/bus/platform/devices/GGL0001:*/BINF.2

定义于文件 sysfs-driver-chromeos-acpi

返回当前启动的活动 EC 固件 (布尔值)。

0

只读（恢复）固件。

1

可重写固件。

/sys/bus/platform/devices/GGL0001:*/BINF.3

定义于文件 sysfs-driver-chromeos-acpi

返回当前启动的主固件类型 (整数)。

0

恢复。

1

正常。

2

开发者。

3

网络启动 (仅限工厂安装)。

/sys/bus/platform/devices/GGL0001:*/CHSW

定义于文件 sysfs-driver-chromeos-acpi

返回固件启动时 Chrome OS 特定硬件开关的开关位置 (整数)。

0

无更改。

2

按下恢复按钮。

4

按下恢复按钮（EC 固件）。

32

启用开发者开关。

512

禁用固件写保护。

/sys/bus/platform/devices/GGL0001:*/FMAP

定义于文件 sysfs-driver-chromeos-acpi

返回主处理器固件闪存映射的起始物理内存地址。

/sys/bus/platform/devices/GGL0001:*/FRID

定义于文件 sysfs-driver-chromeos-acpi

返回主处理器固件只读部分的固件版本。

/sys/bus/platform/devices/GGL0001:*/FWID

定义于文件 sysfs-driver-chromeos-acpi

返回主处理器固件可重写部分的固件版本。

/sys/bus/platform/devices/GGL0001:*/GPIO.X/GPIO.0

定义于文件 sysfs-driver-chromeos-acpi

返回 Chrome OS 特定 GPIO 分配的 GPIO 信号类型 (整数)。

1

恢复按钮。

2

开发者模式开关。

3

固件写保护开关。

256 到 511

调试头 GPIO 0 到 GPIO 255。

/sys/bus/platform/devices/GGL0001:*/GPIO.X/GPIO.1

定义于文件 sysfs-driver-chromeos-acpi

返回 GPIO 信号的信号属性 (整数位域)。

0

信号为低电平有效。

1

信号为高电平有效。

/sys/bus/platform/devices/GGL0001:*/GPIO.X/GPIO.2

定义于文件 sysfs-driver-chromeos-acpi

返回指定 GPIO 控制器上的 GPIO 编号。

/sys/bus/platform/devices/GGL0001:*/GPIO.X/GPIO.3

定义于文件 sysfs-driver-chromeos-acpi

返回 GPIO 控制器的名称。

/sys/bus/platform/devices/GGL0001:*/HWID

定义于文件 sysfs-driver-chromeos-acpi

返回 Chromebook 的硬件 ID。

/sys/bus/platform/devices/GGL0001:*/MECK

定义于文件 sysfs-driver-chromeos-acpi

返回启动期间从管理引擎扩展寄存器中读取的 SHA-1 或 SHA-256 哈希值。该哈希值通过 ACPI 导出，以便操作系统可以验证管理引擎固件是否已更改。如果不存在管理引擎，或者如果固件无法读取扩展寄存器，则此缓冲区大小可能为零。

/sys/bus/platform/devices/GGL0001:*/VBNV.0

定义于文件 sysfs-driver-chromeos-acpi

返回已验证启动非易失性存储块在 CMOS bank 0 中的偏移量，从第一个可写 CMOS 字节开始计数（即“偏移量 = 0”是时钟数据 14 个字节之后的字节）。

/sys/bus/platform/devices/GGL0001:*/VBNV.1

定义于文件 sysfs-driver-chromeos-acpi

返回已验证启动非易失性存储块的大小（以字节为单位）。

/sys/bus/platform/devices/GGL0001:*/VDAT

定义于文件 sysfs-driver-chromeos-acpi

返回固件验证步骤和内核验证步骤之间共享的已验证启动数据块（十六进制转储）。

/sys/bus/platform/devices/GOOG000C\:00/boot_on_ac

定义于文件 sysfs-platform-wilco-ec

“AC 启动”是一项策略，当连接交流电源时，设备从 S5 启动。这对于想要以无头模式或使用坞站运行其设备的用户很有用。

输入应可由 kstrtou8() 解析为 0 或 1。

/sys/bus/platform/devices/GOOG000C\:00/build_date

定义于文件 sysfs-platform-wilco-ec

显示 Wilco 嵌入式控制器固件构建日期。输出将为 MM/DD/YY 字符串。

/sys/bus/platform/devices/GOOG000C\:00/build_revision

定义于文件 sysfs-platform-wilco-ec

显示 Wilco 嵌入式控制器构建修订版本。输出将为类似于以下示例的版本字符串：d2592cae0

/sys/bus/platform/devices/GOOG000C\:00/model_number

定义于文件 sysfs-platform-wilco-ec

显示 Wilco 嵌入式控制器型号。输出将为类似于以下示例的版本字符串：08B6

/sys/bus/platform/devices/GOOG000C\:00/usb_charge

定义于文件 sysfs-platform-wilco-ec

控制 USB PowerShare 策略。USB PowerShare 是一项策略，会影响在低功耗状态下通过特殊的 USB PowerShare 端口（标有小闪电或电池图标）进行充电

  • 在 S0 中，端口将始终供电。

  • 在 S0ix 中，如果启用 usb_charge，则在连接交流电源或电池电量 > 50% 时，将为端口供电。否则不供电。

  • 在 S5 中，如果启用 usb_charge，则在连接交流电源时，将为端口供电。否则不供电。

输入应为“0”或“1”。

/sys/bus/platform/devices/GOOG000C\:00/version

定义于文件 sysfs-platform-wilco-ec

显示 Wilco 嵌入式控制器固件版本。字符串的格式为 x.y.z。其中 x 为主版本，y 为次版本，z 为构建编号。例如：95.00.06

/sys/bus/platform/devices/INT3407:00/dptf_power/adapter_rating_mw

定义于文件 sysfs-platform-dptf

(只读) 适配器额定功率，单位为毫瓦（最大适配器功率）。如果未插入交流适配器，则必须为 0。

/sys/bus/platform/devices/INT3407:00/dptf_power/battery_steady_power

定义于文件 sysfs-platform-dptf

(只读) 电池的最大持续功率，单位为毫瓦。

/sys/bus/platform/devices/INT3407:00/dptf_power/charger_type

定义于文件 sysfs-platform-dptf

(只读) 充电器类型 - 传统、混合或 NVDC。

/sys/bus/platform/devices/INT3407:00/dptf_power/max_platform_power_mw

定义于文件 sysfs-platform-dptf

(只读) 电池可以支持的最大平台功率，单位为毫瓦。

/sys/bus/platform/devices/INT3407:00/dptf_power/platform_power_source

定义于文件 sysfs-platform-dptf

(只读) 显示平台电源

位[3:0]

当前电源 - 0x00 = 直流电 - 0x01 = 交流电 - 0x02 = USB - 0x03 = 无线充电器

位[7:4]

电源序列号

/sys/bus/platform/devices/INT3407:00/dptf_power/prochot_confirm

定义于文件 sysfs-platform-dptf

(只写) 向嵌入式控制器确认 prochot 通知。

/sys/bus/platform/devices/INT3407:00/dptf_power/rest_of_platform_power_mw

定义于文件 sysfs-platform-dptf

(只读) 显示最坏情况下的其余（片上系统之外）平台功率。

/sys/bus/platform/devices/INT3532:00/dptf_battery/current_discharge_capbility_ma

定义于文件 sysfs-platform-dptf

(只读) 从电池燃料计获得的电池放电电流能力，单位为毫安。

/sys/bus/platform/devices/INT3532:00/dptf_battery/high_freq_impedance_mohm

定义于文件 sysfs-platform-dptf

(只读) 可从电池燃料计获得的高频阻抗值，单位为毫欧姆。

/sys/bus/platform/devices/INT3532:00/dptf_battery/max_platform_power_mw

定义于文件 sysfs-platform-dptf

(只读) 电池可以支持的最大平台功率，单位为毫瓦。

/sys/bus/platform/devices/INT3532:00/dptf_battery/max_steady_state_power_mw

定义于文件 sysfs-platform-dptf

(只读) 电池的最大持续功率，单位为毫瓦。

/sys/bus/platform/devices/INT3532:00/dptf_battery/no_load_voltage_mv

定义于文件 sysfs-platform-dptf

(只读) 可从电池燃料计获得的空载电压，单位为毫伏。

/sys/bus/platform/devices/INTC1045:00/pch_fivr_switch_frequency/fivr_switching_fault_status

定义于文件 sysfs-platform-dptf

(只读) 读取 FIVR 开关频率控制故障状态。

/sys/bus/platform/devices/INTC1045:00/pch_fivr_switch_frequency/fivr_switching_freq_mhz

定义于文件 sysfs-platform-dptf

(只读) 获取 FIVR 开关控制频率，单位为 MHz。

/sys/bus/platform/devices/INTC1045:00/pch_fivr_switch_frequency/freq_mhz_high_clock

定义于文件 sysfs-platform-dptf

(读写) PCH FIVR (全集成电压调节器) 开关频率，单位为 MHz，当 FIVR 时钟为 38.4MHz 时。

/sys/bus/platform/devices/INTC1045:00/pch_fivr_switch_frequency/freq_mhz_low_clock

定义于文件 sysfs-platform-dptf

(读写) PCH FIVR (全集成电压调节器) 开关频率，单位为 MHz，当 FIVR 时钟为 19.2MHz 或 24MHz 时。

/sys/bus/platform/devices/INTC1045:00/pch_fivr_switch_frequency/ssc_clock_info

定义于文件 sysfs-platform-dptf

(只读) 提供用于 EMI（电磁干扰）控制的 SSC（扩频时钟）信息。这是一个位掩码。

位

描述

[7:0]

设置时钟频谱扩展百分比：0x00=0.2%，0x3F=10% 1 LSB = 扩展增加 0.1%（对于设置 0x01 到 0x1C）1 LSB = 扩展增加 0.2%（对于设置 0x1E 到 0x3F）

[8]

设置为 1 时，启用扩频时钟

[9]

0：三角形模式。FFC 频率以线性方式围绕 Fcenter 移动 1：随机游走模式。FFC 频率在 SSC（扩频时钟）范围内随机变化

[10]

0：无白噪声。1：将白噪声添加到扩展波形

[11]

当为 1 时，将忽略未来的写入。

/sys/bus/platform/devices/INTC1092:00/intc_data

定义于文件 sysfs-driver-intc_sar

此 sysfs 条目用于检索支持动态 SAR 的 BIOS 发出/维护的动态 SAR 信息。

检索到的信息按以下顺序排列：- device_mode - bandtable_index - antennatable_index - sartable_index

上述信息作为以单个空格分隔的整数值发送。然后，可以将此信息推送到 WWAN 调制解调器，该调制解调器使用此信息通过频段/天线/SAR 表索引信息来控制发射信号电平。这些参数是通过汇总设备模式（如笔记本电脑/平板电脑/翻盖式等）和给定主机上嵌入式控制器可用的接近传感器数据来派生/决定的。在动态 SAR 驱动程序上配置的监管模式也会影响这些值。

用户空间应用程序可以使用通过打开此 sysfs 条目获得的 file-descriptor (fd) 上的 POLLPRI 事件轮询此文件的更改。然后，应用程序可以从 sysfs 节点读取此信息并使用给定信息。

/sys/bus/platform/devices/INTC1092:00/intc_reg

定义于文件 sysfs-driver-intc_sar

特定吸收率 (SAR) 监管模式通常基于当前连接的 LTE 网络的 mcc（移动国家代码）和 mnc（移动网络代码）等信息派生。需要用户空间应用程序使用此 sysfs 节点在动态 SAR 驱动程序上设置当前 SAR 监管模式。此类应用程序还可以使用此 sysfs 节点从动态 SAR 驱动程序中读取回当前配置的监管模式值。

可接受的监管模式为

0

FCC

1

CE

2

ISED

  • 监管模式值具有上述值之一。

  • 驱动程序中使用的默认监管模式为 0。

/sys/bus/platform/devices/MLNXBF04:00/bootfifo

定义于文件 sysfs-platform-mellanox-bootctl

用于访问 BlueField 启动 fifo 的文件。

/sys/bus/platform/devices/MLNXBF04:00/lifecycle_state

定义于文件 sysfs-platform-mellanox-bootctl

SoC 的生命周期状态，可以是以下值之一。

生产

生产状态，可以更新为安全状态

GA 安全

安全芯片，无法更改状态

GA 不安全

不安全芯片，无法更改状态

RMA

退货授权

/sys/bus/platform/devices/MLNXBF04:00/mfg_lock

定义于文件 sysfs-platform-mellanox-bootctl

“mfg_lock” sysfs 属性为只写。成功写入此属性会将板级属性锁定到 EEPROM 中，使其变为只读。

/sys/bus/platform/devices/MLNXBF04:00/modl

定义于文件 sysfs-platform-mellanox-bootctl

“modl” sysfs 属性保存板的型号。此值在板级标签上提供。

/sys/bus/platform/devices/MLNXBF04:00/oob_mac

定义于文件 sysfs-platform-mellanox-bootctl

“oob_mac” sysfs 属性保存带外 1Gbps 以太网端口的 MAC 地址。此 MAC 地址在板级标签上提供。

/sys/bus/platform/devices/MLNXBF04:00/opn

定义于文件 sysfs-platform-mellanox-bootctl

“opn” sysfs 属性保存板的部件号。此值在板级标签上提供。

/sys/bus/platform/devices/MLNXBF04:00/post_reset_wdog

定义于文件 sysfs-platform-mellanox-bootctl

下次启动的看门狗设置（以秒为单位）。它用于重新启动芯片并在新启动分区失败时将其恢复到旧状态。

/sys/bus/platform/devices/MLNXBF04:00/reset_action

定义于文件 sysfs-platform-mellanox-bootctl

下次复位的引导流来源。它可以是以下值之一

external

从外部源引导（USB 或 PCIe）

emmc

从片上 eMMC 引导

emmc_legacy

在旧版（慢速）模式下从片上 eMMC 引导

/sys/bus/platform/devices/MLNXBF04:00/rev

定义于文件 sysfs-platform-mellanox-bootctl

“rev” sysfs 属性保存着电路板的修订版本。此值在电路板级别的标签上提供。

/sys/bus/platform/devices/MLNXBF04:00/rsh_log

定义于文件 sysfs-platform-mellanox-bootctl

该文件用于写入 BlueField 引导日志，格式为“[INFO|WARN|ERR|ASSERT ]<msg>”。如果未指定，则默认使用日志级别“INFO”。

/sys/bus/platform/devices/MLNXBF04:00/second_reset_action

定义于文件 sysfs-platform-mellanox-bootctl

更新下次复位后引导流的来源。它可以是以下值之一，并且将在下次复位后应用。

external

从外部源引导（USB 或 PCIe）

emmc

从片上 eMMC 引导

emmc_legacy

在旧版（慢速）模式下从片上 eMMC 引导

swap_emmc

交换主/次引导分区

无

cancel the action

/sys/bus/platform/devices/MLNXBF04:00/secure_boot_fuse_state

定义于文件 sysfs-platform-mellanox-bootctl

eFuse 版本的状态，具有以下值。

InUse

已熔断，有效且当前正在使用

Used

已熔断且有效

Free

未熔断且可以自由使用

Skipped

未熔断但不可自由使用（已跳过）

Wasted

已熔断且无效

Invalid

未熔断但标记为有效（错误状态）。

/sys/bus/platform/devices/MLNXBF04:00/sku

定义于文件 sysfs-platform-mellanox-bootctl

“sku” sysfs 属性保存着电路板的 SKU 编号。此值在电路板级别的标签上提供。

/sys/bus/platform/devices/MLNXBF04:00/sn

定义于文件 sysfs-platform-mellanox-bootctl

“sn” sysfs 属性保存着电路板的序列号。此值在电路板级别的标签上提供。

/sys/bus/platform/devices/MLNXBF04:00/uuid

定义于文件 sysfs-platform-mellanox-bootctl

“uuid” sysfs 属性保存着电路板的 UUID。此值由制造团队提供。

/sys/bus/platform/devices/VPC2004:*/camera_power

在文件 sysfs-platform-ideapad-laptop 中定义

控制摄像头模块的电源。1 表示开启，0 表示关闭。

/sys/bus/platform/devices/VPC2004:*/conservation_mode

在文件 sysfs-platform-ideapad-laptop 中定义

控制是否启用保护模式。此功能将最大电池充电百分比限制在 50-60% 左右，以延长电池的寿命。

/sys/bus/platform/devices/VPC2004:*/fan_mode

在文件 sysfs-platform-ideapad-laptop 中定义

更改风扇模式。有四种可用模式

  • 0 -> 超静音模式

  • 1 -> 标准模式

  • 2 -> 除尘

  • 4 -> 高效散热模式

/sys/bus/platform/devices/VPC2004:*/fn_lock

在文件 sysfs-platform-ideapad-laptop 中定义

控制 fn-lock 模式。

  • 1 -> 已开启

  • 0 -> 已关闭

例如

# echo "0" >  \
/sys/bus/pci/devices/0000:00:1f.0/PNP0C09:00/VPC2004:00/fn_lock

/sys/bus/platform/devices/VPC2004:*/touchpad

在文件 sysfs-platform-ideapad-laptop 中定义

控制触摸板模式。

  • 1 -> 已开启

  • 0 -> 已关闭

/sys/bus/platform/devices/VPC2004:*/usb_charging

在文件 sysfs-platform-ideapad-laptop 中定义

控制是否启用“始终开启 USB 充电”功能。此功能即使在计算机未开机的情况下也能为 USB 设备充电。

/sys/bus/platform/devices/[..]/fsi-master-gpio/external_mode

在文件 sysfs-driver-fsi-master-gpio 中定义

控制基于 GPIO 的 FSI 主机的访问仲裁。值为 0（默认值）设置正常模式，其中驱动程序执行 FSI 总线事务；1 设置外部模式，其中 FSI 总线由外部驱动（例如，通过调试设备）。

/sys/bus/platform/devices/ci_hdrc.0/inputs/a_bus_drop

在文件 sysfs-platform-chipidea-usb-otg 中定义

可以设置和读取。当 A 设备上运行的应用程序想要关闭总线电源时，a_bus_drop（A 设备总线掉线）输入为 1，否则为 0。当 a_bus_drop 为 1 时，a_bus_req 应为 0。

有效值为“1”和“0”。

读取：如果总线已关闭（vbus 已关闭），则返回 1，

由 A 设备关闭，否则返回 0。

/sys/bus/platform/devices/ci_hdrc.0/inputs/a_bus_req

在文件 sysfs-platform-chipidea-usb-otg 中定义

可以设置和读取。如果 A 设备上运行的应用程序想要使用总线，则将 a_bus_req（A 设备总线请求）输入设置为 1，当应用程序不再想使用总线（或想作为外围设备工作）时，将其设置为 0。内核也可以响应来自 B 设备的远程唤醒信号将 a_bus_req 设置为 1，A 设备应决定恢复总线。

有效值为“1”和“0”。

读取：如果 A 设备上运行的应用程序正在将总线用作主机角色，则返回 1，否则返回 0。

/sys/bus/platform/devices/ci_hdrc.0/inputs/a_clr_err

在文件 sysfs-platform-chipidea-usb-otg 中定义

只能设置。a_clr_err（A 设备 Vbus 错误清除）输入用于清除 vbus 错误，然后 A 设备将关闭总线电源。

有效值为“1”

/sys/bus/platform/devices/ci_hdrc.0/inputs/b_bus_req

在文件 sysfs-platform-chipidea-usb-otg 中定义

可以设置和读取。当 B 设备上运行的应用程序想要将总线用作主机时，b_bus_req（B 设备总线请求）输入为 1，当应用程序不再想作为主机工作并决定切换回外围设备时，其为 0。

有效值为“1”和“0”。

读取：如果 B 设备上运行的应用程序正在将总线用作主机角色，则返回 1，否则返回 0。

/sys/bus/platform/devices/ci_hdrc.0/role

在文件 sysfs-platform-chipidea-usb2 中定义

读取时，它返回字符串“gadget”或“host”，指示当前的控制器角色。

当写入“gadget”或“host”时，它将进行角色切换。只有双角色配置的控制器才支持写入。

/sys/bus/platform/devices/dfl-fme.0/bitstream_id

在文件 sysfs-platform-dfl-fme 中定义

只读。它返回位流（静态 FPGA 区域）标识符编号，其中包括此静态 FPGA 区域的详细版本和其他信息。

/sys/bus/platform/devices/dfl-fme.0/bitstream_metadata

在文件 sysfs-platform-dfl-fme 中定义

只读。它返回位流（静态 FPGA 区域）元数据，其中包括此静态 FPGA 区域的合成日期、种子和其他信息。

/sys/bus/platform/devices/dfl-fme.0/cache_size

在文件 sysfs-platform-dfl-fme 中定义

只读。它返回此 FPGA 设备的缓存大小。

/sys/bus/platform/devices/dfl-fme.0/errors/catfatal_errors

在文件 sysfs-platform-dfl-fme 中定义

只读。它返回检测到的灾难性和致命错误。

/sys/bus/platform/devices/dfl-fme.0/errors/first_error

在文件 sysfs-platform-dfl-fme 中定义

只读。读取此文件以获取硬件检测到的第一个错误。

/sys/bus/platform/devices/dfl-fme.0/errors/fme_errors

在文件 sysfs-platform-dfl-fme 中定义

读写。读取此文件以获取 FME 上检测到的错误。写入此文件以清除 fme_errors 中记录的错误。如果输入解析失败或输入错误代码不匹配，则写入失败，返回 -EINVAL。

/sys/bus/platform/devices/dfl-fme.0/errors/inject_errors

在文件 sysfs-platform-dfl-fme 中定义

读写。读取此文件以检查注入的错误。写入此文件以注入错误以进行测试。如果输入解析失败或输入注入错误代码不受支持，则写入失败，返回 -EINVAL。

/sys/bus/platform/devices/dfl-fme.0/errors/next_error

在文件 sysfs-platform-dfl-fme 中定义

只读。读取此文件以获取硬件检测到的第二个错误。

/sys/bus/platform/devices/dfl-fme.0/errors/nonfatal_errors

在文件 sysfs-platform-dfl-fme 中定义

只读。它返回检测到的非致命错误。

/sys/bus/platform/devices/dfl-fme.0/errors/pcie0_errors

在文件 sysfs-platform-dfl-fme 中定义

读写。读取此文件以获取在 pcie0 链路上检测到的错误。写入此文件以清除 pcie0_errors 中记录的错误。如果输入解析失败或输入错误代码不匹配，则写入失败，返回 -EINVAL。

/sys/bus/platform/devices/dfl-fme.0/errors/pcie1_errors

在文件 sysfs-platform-dfl-fme 中定义

读写。读取此文件以获取在 pcie1 链路上检测到的错误。写入此文件以清除 pcie1_errors 中记录的错误。如果输入解析失败或输入错误代码不匹配，则写入失败，返回 -EINVAL。

/sys/bus/platform/devices/dfl-fme.0/fabric_version

在文件 sysfs-platform-dfl-fme 中定义

只读。它返回此 FPGA 设备的 fabric 版本。用户空间应用程序需要此信息来为不同的 fabric 设计选择最佳数据通道。

/sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/name

在文件 sysfs-platform-dfl-fme 中定义

只读。读取此文件以获取 hwmon 设备的名称，它支持的值为

‘dfl_fme_thermal’

热 hwmon 设备名称

‘dfl_fme_power’

电源 hwmon 设备名称

/sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/power1_crit

在文件 sysfs-platform-dfl-fme 中定义

读写。读取此文件以获取当前硬件功率阈值 2，单位为 uW。如果功耗上升到或超过此阈值，硬件将开始 90% 的节流。写入此文件以设置当前硬件功率阈值 2，单位为 uW。由于硬件仅接受瓦特为单位的值，因此输入值将按瓦特向下舍入（小于 1 瓦特的部分将被丢弃），并限制在 0 到 127 瓦特的范围内。如果输入解析失败，则写入失败，返回 -EINVAL。

/sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/power1_crit_alarm

在文件 sysfs-platform-dfl-fme 中定义

只读。如果当前功耗等于或高于硬件阈值 2（参见 “power1_crit”），则返回 1，否则返回 0。

/sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/power1_fpga_limit

在文件 sysfs-platform-dfl-fme 中定义

只读。它返回 FPGA 的功率限制，单位为 uW。

/sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/power1_input

在文件 sysfs-platform-dfl-fme 中定义

只读。它返回当前 FPGA 功耗，单位为 uW。

/sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/power1_ltr

在文件 sysfs-platform-dfl-fme 中定义

只读。读取此文件以获取当前延迟容差报告 (ltr) 值。如果所有加速功能单元 (AFU) 都可以容忍 >= 40us 的内存访问延迟，则返回 1，如果任何 AFU 对延迟敏感 (< 40us)，则返回 0。

/sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/power1_max

在文件 sysfs-platform-dfl-fme 中定义

读写。读取此文件以获取当前硬件功率阈值 1，单位为 uW。如果功耗上升到或超过此阈值，硬件将开始 50% 的节流。写入此文件以设置当前硬件功率阈值 1，单位为 uW。由于硬件仅接受瓦特为单位的值，因此输入值将按瓦特向下舍入（小于 1 瓦特的部分将被丢弃），并限制在 0 到 127 瓦特的范围内。如果输入解析失败，则写入失败，返回 -EINVAL。

/sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/power1_max_alarm

在文件 sysfs-platform-dfl-fme 中定义

只读。如果当前功耗等于或高于硬件阈值 1（参见 “power1_max”），则返回 1，否则返回 0。

/sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/power1_xeon_limit

在文件 sysfs-platform-dfl-fme 中定义

只读。它返回 XEON 的功率限制，单位为 uW。

/sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/temp1_crit

在文件 sysfs-platform-dfl-fme 中定义

只读。它返回硬件阈值 2 的温度，单位为毫摄氏度。如果温度上升到或超过此阈值，硬件将开始 100% 的节流。

/sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/temp1_crit_alarm

在文件 sysfs-platform-dfl-fme 中定义

只读。如果当前温度等于或高于硬件阈值 2（参见 “temp1_crit”），则返回 1，否则返回 0。

/sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/temp1_emergency

在文件 sysfs-platform-dfl-fme 中定义

只读。它返回硬件跳闸阈值温度，单位为毫摄氏度。如果温度上升到或超过此阈值，则会触发致命事件，向板管理控制器 (BMC) 发送信号以关闭 FPGA。

/sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/temp1_input

在文件 sysfs-platform-dfl-fme 中定义

只读。它返回 FPGA 设备温度，单位为毫摄氏度。

/sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/temp1_max

在文件 sysfs-platform-dfl-fme 中定义

只读。它返回硬件阈值 1 的温度，单位为毫摄氏度。如果温度上升到或超过此阈值，硬件将开始 50% 或 90% 的节流（参见 “temp1_max_policy”）。

/sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/temp1_max_alarm

在文件 sysfs-platform-dfl-fme 中定义

只读。如果当前温度等于或高于硬件阈值 1（参见 “temp1_max”），则返回 1，否则返回 0。

/sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/temp1_max_policy

在文件 sysfs-platform-dfl-fme 中定义

只读。读取此文件以获取硬件阈值 1 的策略（参见“temp1_max”）。它仅支持两个值（策略）。

0

AP2 状态（90% 节流）

1

AP1 状态（50% 节流）

/sys/bus/platform/devices/dfl-fme.0/ports_num

在文件 sysfs-platform-dfl-fme 中定义

只读。一个 DFL FPGA 设备可能具有多个端口/加速功能单元 (AFU)。读取时，它返回 FPGA 设备上的端口数。

/sys/bus/platform/devices/dfl-fme.0/socket_id

在文件 sysfs-platform-dfl-fme 中定义

只读。它返回 socket_id 以指示此 FPGA 属于哪个插槽，仅对集成解决方案有效。用户只需要此信息，以防标准的 NUMA 节点无法提供正确的信息。

/sys/bus/platform/devices/dfl-port.0/afu_id

在文件 sysfs-platform-dfl-port 中定义

只读。用户可以将不同的 PR 位流编程到 FPGA 加速功能单元 (AFU) 中，以实现不同的功能。它返回 UUID，该 UUID 可用于识别在此 AFU 中编程的 PR 位流。

/sys/bus/platform/devices/dfl-port.0/ap1_event

在文件 sysfs-platform-dfl-port 中定义

读写。读取此文件以获取 AP1（AFU 功率状态 1）事件。它用于指示瞬态 AP1 状态。向此文件写入 1 以清除 AP1 事件。

/sys/bus/platform/devices/dfl-port.0/ap2_event

在文件 sysfs-platform-dfl-port 中定义

读写。读取此文件以获取 AP2（AFU 功率状态 2）事件。它用于指示瞬态 AP2 状态。向此文件写入 1 以清除 AP2 事件。

/sys/bus/platform/devices/dfl-port.0/errors/errors

在文件 sysfs-platform-dfl-port 中定义

读写。读取此文件以获取在端口和加速功能单元 (AFU) 上检测到的错误。向此文件写入错误代码以清除错误。如果输入解析失败或输入错误代码不匹配，则写入失败并返回 -EINVAL。如果硬件处于低功耗状态 (-EBUSY) 或不响应 (-ETIMEDOUT)，则错误无法清除，写入将失败并返回 -EBUSY 或 -ETIMEDOUT。

/sys/bus/platform/devices/dfl-port.0/errors/first_error

在文件 sysfs-platform-dfl-port 中定义

只读。读取此文件以获取硬件检测到的第一个错误。

/sys/bus/platform/devices/dfl-port.0/errors/first_malformed_req

在文件 sysfs-platform-dfl-port 中定义

只读。读取此文件以获取硬件捕获的第一个格式错误的请求。

/sys/bus/platform/devices/dfl-port.0/id

在文件 sysfs-platform-dfl-port 中定义

只读。它返回此端口的 ID。一个 DFL FPGA 设备可能具有多个端口。用户空间可以使用此 ID 来区分同一 FPGA 设备下的不同端口。

/sys/bus/platform/devices/dfl-port.0/ltr

在文件 sysfs-platform-dfl-port 中定义

读写。读取或设置 AFU 延迟容忍度报告值。如果 AFU 可以容忍 >= 40us 的延迟，则将 ltr 设置为 1，如果它对延迟敏感，则将其设置为 0。

/sys/bus/platform/devices/dfl-port.0/power_state

在文件 sysfs-platform-dfl-port 中定义

只读。它报告 APx（AFU 功率）状态，不同的 APx 表示不同的节流级别。读取此文件时，它返回 “0” - 正常 / “1” - AP1 / “2” - AP2 / “6” - AP6。

/sys/bus/platform/devices/dfl-port.0/userclk_freqcmd

在文件 sysfs-platform-dfl-port 中定义

只写。用户向此接口写入命令，以将用户时钟设置为 AFU。

/sys/bus/platform/devices/dfl-port.0/userclk_freqcntrcmd

在文件 sysfs-platform-dfl-port 中定义

只写。用户向此接口写入命令，以设置用户时钟计数器。

/sys/bus/platform/devices/dfl-port.0/userclk_freqcntrsts

在文件 sysfs-platform-dfl-port 中定义

只读。读取此文件以获取向 userclck_freqcntrcmd 发出的命令的状态。

/sys/bus/platform/devices/dfl-port.0/userclk_freqsts

在文件 sysfs-platform-dfl-port 中定义

只读。读取此文件以获取向 userclck_freqcmd 发出的命令的状态。

/sys/bus/platform/devices/occ-hwmon.X/ffdc

在文件 sysfs-bus-platform-devices-occ-hwmon 中定义

包含来自 SBEFIFO 硬件的首次故障数据捕获 (FFDC)，如果先前传输中有任何数据。否则，该文件为空。当用户完全读取数据后，数据将被清除。顾名思义，仅保存第一个错误的數據，直到读取时将其清除。在基板管理控制器 (BMC) 上运行的 OCC hwmon 驱动程序通过自启动引擎 (SBE) FIFO 与 POWER9 及更高版本的处理器通信。在许多错误情况下，SBEFIFO 将返回指示错误类型和系统状态等的错误数据。

/sys/bus/platform/devices/smpro-errmon.*/[error|warn]_[smpro|pmpro]

在文件 sysfs-bus-platform-devices-ampere-smpro 中定义

（只读）包含以十六进制格式打印的内部固件错误/警告。

每个 sysfs 条目的详细信息如下

错误

Sysfs 条目

描述

SMpro 错误

/sys/bus/platform/devices/smpro-errmon.*/error_smpro

系统有 SMpro 错误

SMpro 警告

/sys/bus/platform/devices/smpro-errmon.*/warn_smpro

系统有 SMpro 警告

PMpro 错误

/sys/bus/platform/devices/smpro-errmon.*/error_pmpro

系统有 PMpro 错误

PMpro 警告

/sys/bus/platform/devices/smpro-errmon.*/warn_pmpro

系统有 PMpro 警告

有关详细信息，请参阅 5.10 RAS 内部错误寄存器定义，《Altra Family Soc BMC 接口规范》。

/sys/bus/platform/devices/smpro-errmon.*/error_[core|mem|pcie|other]_[ce|ue]

在文件 sysfs-bus-platform-devices-ampere-smpro 中定义

（只读）包含根据下表以十六进制格式打印的 48 字节 Ampere（供应商特定）错误记录

偏移量

字段

大小（字节）

描述

00

错误类型

1

有关详细信息，请参阅 下表

01

子类型

1

有关详细信息，请参阅 下表

02

实例

2

有关详细信息，请参阅 下表

04

错误状态

4

有关详细信息，请参阅 ARM RAS 规范

08

错误地址

8

有关详细信息，请参阅 ARM RAS 规范

16

错误杂项 0

8

有关详细信息，请参阅 ARM RAS 规范

24

错误杂项 1

8

有关详细信息，请参阅 ARM RAS 规范

32

错误杂项 2

8

有关详细信息，请参阅 ARM RAS 规范

40

错误杂项 3

8

有关详细信息，请参阅 ARM RAS 规范

下表定义了错误类型、它们的子类型、子组件和实例的值

错误组

错误类型

子类型

子组件

实例

CPM（核心）

0

0

窥探逻辑

CPM #

CPM（核心）

0

2

Armv8 核心 1

CPM #

MCU（内存）

1

1

ERR1

MCU # | SLOT << 11

MCU（内存）

1

2

ERR2

MCU # | SLOT << 11

MCU（内存）

1

3

ERR3

MCU #

MCU（内存）

1

4

ERR4

MCU #

MCU（内存）

1

5

ERR5

MCU #

MCU（内存）

1

6

ERR6

MCU #

MCU（内存）

1

7

链接错误

MCU #

网格（其他）

2

0

交叉点

X | (Y << 5) | NS <<11

网格（其他）

2

1

主节点 (IO)

X | (Y << 5) | NS <<11

网格（其他）

2

2

主节点 (内存)

X | (Y << 5) | NS <<11 | device<<12

网格（其他）

2

4

CCIX 节点

X | (Y << 5) | NS <<11

2P 链路（其他）

3

0

不适用

Altra 2P 链路 #

GIC（其他）

5

0

ERR0

0

GIC（其他）

5

1

ERR1

0

GIC（其他）

5

2

ERR2

0

GIC（其他）

5

3

ERR3

0

GIC（其他）

5

4

ERR4

0

GIC（其他）

5

5

ERR5

0

GIC（其他）

5

6

ERR6

0

GIC（其他）

5

7

ERR7

0

GIC（其他）

5

8

ERR8

0

GIC（其他）

5

9

ERR9

0

GIC（其他）

5

10

ERR10

0

GIC（其他）

5

11

ERR11

0

GIC（其他）

5

12

ERR12

0

GIC（其他）

5

13-21

ERR13

RC # + 1

SMMU（其他）

6

TCU

100

RC #

SMMU（其他）

6

TBU0

0

RC #

SMMU（其他）

6

TBU1

1

RC #

SMMU（其他）

6

TBU2

2

RC #

SMMU（其他）

6

TBU3

3

RC #

SMMU（其他）

6

TBU4

4

RC #

SMMU（其他）

6

TBU5

5

RC #

SMMU（其他）

6

TBU6

6

RC #

SMMU（其他）

6

TBU7

7

RC #

SMMU（其他）

6

TBU8

8

RC #

SMMU（其他）

6

TBU9

9

RC #

PCIe AER (pcie)

7

根

0

RC #

PCIe AER (pcie)

7

设备

1

RC #

PCIe RC (pcie)

8

RCA HB

0

RC #

PCIe RC (pcie)

8

RCB HB

1

RC #

PCIe RC (pcie)

8

RASDP

8

RC #

OCM（其他）

9

ERR0

0

0

OCM（其他）

9

ERR1

1

0

OCM（其他）

9

ERR2

2

0

SMpro（其他）

10

ERR0

0

0

SMpro（其他）

10

ERR1

1

0

SMpro（其他）

10

MPA_ERR

2

0

PMpro（其他）

11

ERR0

0

0

PMpro（其他）

11

ERR1

1

0

PMpro（其他）

11

MPA_ERR

2

0

示例

# cat error_other_ue
880807001e004010401040101500000001004010401040100c0000000000000000000000000000000000000000000000

每个 sysfs 条目的详细信息如下

错误

Sysfs 条目

描述（触发时）

核心的 CE

/sys/bus/platform/devices/smpro-errmon.*/error_core_ce

核心有 CE 错误

核心的 UE

/sys/bus/platform/devices/smpro-errmon.*/error_core_ue

核心有 UE 错误

内存的 CE

/sys/bus/platform/devices/smpro-errmon.*/error_mem_ce

内存有 CE 错误

内存的 UE

/sys/bus/platform/devices/smpro-errmon.*/error_mem_ue

内存有 UE 错误

PCIe 的 CE

/sys/bus/platform/devices/smpro-errmon.*/error_pcie_ce

任何 PCIe 控制器都有 CE 错误

PCIe 的 UE

/sys/bus/platform/devices/smpro-errmon.*/error_pcie_ue

任何 PCIe 控制器都有 UE 错误

其他的 CE

/sys/bus/platform/devices/smpro-errmon.*/error_other_ce

任何其他 CE 错误

其他的 UE

/sys/bus/platform/devices/smpro-errmon.*/error_other_ue

任何其他 UE 错误

UE：不可纠正的错误 CE：可纠正的错误

有关详细信息，请参阅 3.3 Ampere（供应商特定）错误记录格式，《Altra Family RAS 补充》。

/sys/bus/platform/devices/smpro-errmon.*/event_[vrd_warn_fault|vrd_hot|dimm_hot|dimm_2x_refresh]

在文件 sysfs-bus-platform-devices-ampere-smpro 中定义

（只读）如果发生 VRD/DIMM 警告/热事件，则包含以下十六进制格式的详细信息

AAAA

其中

  • AAAA：事件详细信息数据

每个 sysfs 条目的详细信息如下

事件

Sysfs 条目

描述

VRD 热

/sys/bus/platform/devices/smpro-errmon.*/event_vrd_hot

VRD 热

VR 警告/故障

/sys/bus/platform/devices/smpro-errmon.*/event_vrd_warn_fault

VR 警告或故障

DIMM 热

/sys/bus/platform/devices/smpro-errmon.*/event_dimm_hot

DIMM 热

DIMM 2X 刷新率

/sys/bus/platform/devices/smpro-errmon.*/event_dimm_2x_refresh

高温下的 DIMM 2x 刷新率事件

有关更多详细信息，请参阅 5.7 GPI 状态寄存器和 5.9 内存错误寄存器定义，《Altra Family Soc BMC 接口规范》。

/sys/bus/platform/devices/smpro-errmon.*/event_dimm[0-15]_syndrome

在文件 sysfs-bus-platform-devices-ampere-smpro 中定义

（只读）如果插槽 0-15 未能初始化，则 sysfs 返回插槽 0-15 的 2 字节 DIMM 故障综合征数据。

有关更多详细信息，请参阅 5.11 启动阶段寄存器定义，《Altra Family Soc BMC 接口规范》。

/sys/bus/platform/devices/smpro-errmon.*/overflow_[core|mem|pcie|other]_[ce|ue]

在文件 sysfs-bus-platform-devices-ampere-smpro 中定义

（只读）返回报告的每种类型硬件错误的溢出状态

  • 0：无溢出

  • 1：存在溢出，并且最旧的硬件错误被丢弃

每个 sysfs 条目的详细信息如下

溢出

Sysfs 条目

描述

核心的 CE

/sys/bus/platform/devices/smpro-errmon.*/overflow_core_ce

核心 CE 错误溢出

核心的 UE

/sys/bus/platform/devices/smpro-errmon.*/overflow_core_ue

核心 UE 错误溢出

内存的 CE

/sys/bus/platform/devices/smpro-errmon.*/overflow_mem_ce

内存 CE 错误溢出

内存的 UE

/sys/bus/platform/devices/smpro-errmon.*/overflow_mem_ue

内存 UE 错误溢出

PCIe 的 CE

/sys/bus/platform/devices/smpro-errmon.*/overflow_pcie_ce

任何 PCIe 控制器 CE 错误溢出

PCIe 的 UE

/sys/bus/platform/devices/smpro-errmon.*/overflow_pcie_ue

任何 PCIe 控制器 UE 错误溢出

其他的 CE

/sys/bus/platform/devices/smpro-errmon.*/overflow_other_ce

任何其他 CE 错误溢出

其他的 UE

/sys/bus/platform/devices/smpro-errmon.*/overflow_other_ue

其他 UE 错误溢出

其中

  • UE：不可纠正的错误

  • CE：可纠正的错误

/sys/bus/platform/devices/smpro-misc*/soc_power_limit

在文件 sysfs-bus-platform-devices-ampere-smpro 中定义

（读写）包含以瓦特为单位的所需 SoC 功率限制。写入此 sysfs 会设置所需的 SoC 功率限制 (W)。从此寄存器读取会返回当前的 SoC 功率限制 (W)。该值范围为

  • 最小值：120 W

  • 最大值：插槽 TDP 功率

/sys/bus/platform/devices/smpro-misc.*/boot_progress

在文件 sysfs-bus-platform-devices-ampere-smpro 中定义

（只读）包含以下格式的十六进制启动阶段信息

AABBCCCCCCCC

其中

  • AA：启动阶段

    • 00：SMpro 固件启动

    • 01：PMpro 固件启动

    • 02：ATF BL1 固件启动

    • 03：DDR 初始化

    • 04：DDR 训练报告状态

    • 05：ATF BL2 固件启动

    • 06：ATF BL31 固件启动

    • 07：ATF BL32 固件启动

    • 08：UEFI 固件启动

    • 09：操作系统启动

  • BB：启动状态

    • 00：未启动

    • 01：已启动

    • 02：已完成，无错误

    • 03：失败。

  • CCCCCCCC：为每个启动阶段定义的启动状态信息

有关详细信息，请参阅 5.11 启动阶段寄存器定义 和 6. 处理器启动进度代码，《Altra Family Soc BMC 接口规范》。

/sys/bus/platform/devices/tahvo-usb/otg_mode

在文件 sysfs-platform-tahvo-usb 中定义

设置或读取当前 OTG 模式。有效值为“host”和“peripheral”。

读取：返回当前模式。

/sys/bus/platform/devices/tahvo-usb/vbus

在文件 sysfs-platform-tahvo-usb 中定义

读取当前的 VBUS 状态。

读取：返回“on”或“off”。

/sys/bus/platform/drivers/amd_pmc/*/smu_fw_version

在文件 sysfs-amd-pmc 中定义

读取此文件会报告加载到 AMD CPU 和 APU 中包含的系统管理单元 (SMU) 的固件版本。

/sys/bus/platform/drivers/amd_pmc/*/smu_program

在文件 sysfs-amd-pmc 中定义

读取此文件会报告与 SMU 固件版本对应的程序。该程序字段用于消除可能共享同一固件二进制文件的两个 APU/CPU 模型的歧义。

/sys/bus/platform/drivers/amd_x3d_vcache/AMDI0101:00/amd_x3d_mode

定义于文件 sysfs-bus-platform-drivers-amd_x3d_vcache

(读写) AMD 3D V-Cache 优化器允许用户动态切换 CPU 核心排名。

此文件在以下两种模式之间切换： - “频率”：较快 CCD 中的核心优先于较慢 CCD 中的核心。 - “缓存”：较大 L3 CCD 中的核心优先于较小 L3 CCD 中的核心。

/sys/bus/platform/drivers/aspeed-uart-routing/\*/io\*

定义于文件 sysfs-driver-aspeed-uart-routing

选择 IOx 串行端口的 RX 源。当前选择将用括号“[]”标记。

用户：OpenBMC。建议的更改应发送至 openbmc@lists.ozlabs.org

/sys/bus/platform/drivers/aspeed-uart-routing/\*/uart\*

定义于文件 sysfs-driver-aspeed-uart-routing

选择 UARTx 设备的 RX 源。

读取时，每个文件都会显示可用选项列表，当前选中的选项用括号“[]”标记。可用选项列表取决于所选文件。

例如：cat /sys/bus/platform/drivers/aspeed-uart-routing/*.uart_routing/uart1 [io1] io2 io3 io4 uart2 uart3 uart4 io6

在这种情况下，UART1 从 IO1（物理串行端口 1）获取输入。

用户：OpenBMC。建议的更改应发送至 openbmc@lists.ozlabs.org

/sys/bus/platform/drivers/intel-m10bmc-sec-update/.../security/bmc_canceled_csks

定义于文件 sysfs-driver-intel-m10-bmc-sec-update

只读。返回 BMC 已取消的代码签名密钥的索引列表。使用标准位图列表格式（例如“1,2-6,9”）。

/sys/bus/platform/drivers/intel-m10bmc-sec-update/.../security/bmc_root_entry_hash

定义于文件 sysfs-driver-intel-m10-bmc-sec-update

只读。如果已编程，则返回 BMC 映像的根条目哈希值，否则返回字符串：“hash not programmed”。此文件仅在底层设备支持时可见。格式：字符串。

/sys/bus/platform/drivers/intel-m10bmc-sec-update/.../security/flash_count

定义于文件 sysfs-driver-intel-m10-bmc-sec-update

只读。返回安全更新暂存区被刷写的次数。格式：“%u”。

/sys/bus/platform/drivers/intel-m10bmc-sec-update/.../security/pr_canceled_csks

定义于文件 sysfs-driver-intel-m10-bmc-sec-update

只读。返回部分重配置区域已取消的代码签名密钥的索引列表。使用标准位图列表格式（例如“1,2-6,9”）。

/sys/bus/platform/drivers/intel-m10bmc-sec-update/.../security/pr_root_entry_hash

定义于文件 sysfs-driver-intel-m10-bmc-sec-update

只读。如果已编程，则返回部分重配置区域的根条目哈希值，否则返回字符串：“hash not programmed”。此文件仅在底层设备支持时可见。格式：字符串。

/sys/bus/platform/drivers/intel-m10bmc-sec-update/.../security/sr_canceled_csks

定义于文件 sysfs-driver-intel-m10-bmc-sec-update

只读。返回静态区域已取消的代码签名密钥的索引列表。使用标准位图列表格式（例如“1,2-6,9”）。

/sys/bus/platform/drivers/intel-m10bmc-sec-update/.../security/sr_root_entry_hash

定义于文件 sysfs-driver-intel-m10-bmc-sec-update

只读。如果已编程，则返回静态区域的根条目哈希值，否则返回字符串：“hash not programmed”。此文件仅在底层设备支持时可见。格式：字符串。

/sys/bus/platform/drivers/panfrost/.../profiling

定义于文件 sysfs-driver-panfrost-profiling

获取/设置 drm fdinfo 的引擎和周期分析状态。有效值为： 0：禁用 fdinfo 作业分析源。 1：启用 fdinfo 作业分析源，这将同时启用 GPU 的时间戳和周期计数器寄存器。

/sys/bus/platform/drivers/panthor/.../profiling

定义于文件 sysfs-driver-panthor-profiling

用于启用 drm fdinfo 作业分析测量的位掩码。有效值为： 0：禁用 fdinfo 作业分析源。 1：启用正在运行的作业的 GPU 周期测量。 2：启用正在运行的作业的 GPU 时间戳采样。

/sys/bus/platform/drivers/qcom_eud/.../enable

定义于文件 sysfs-driver-eud

嵌入式 USB 调试器 (EUD) 的启用/禁用 sysfs 接口。这根据 1 或 0 值启用和禁用 EUD。通过启用 EUD，用户可以激活 EUD 的迷你 USB 集线器以进行调试和跟踪。

/sys/bus/platform/drivers/ufshcd/*/attributes/active_icc_level

/sys/bus/platform/devices/*.ufs/attributes/active_icc_level

定义在文件 sysfs-driver-ufs 中

此文件提供活动的 icc 级别 UFS 设备属性。有关该属性的完整信息，请参阅 UFS 规范 2.1。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/attributes/bkops_status

/sys/bus/platform/devices/*.ufs/attributes/bkops_status

定义在文件 sysfs-driver-ufs 中

此文件提供后台操作状态 UFS 设备属性。有关该属性的完整信息，请参阅 UFS 规范 2.1。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/attributes/boot_lun_enabled

/sys/bus/platform/devices/*.ufs/attributes/boot_lun_enabled

定义在文件 sysfs-driver-ufs 中

此文件提供引导 lun 已启用 UFS 设备属性。有关该属性的完整信息，请参阅 UFS 规范 2.1。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/attributes/configuration_descriptor_lock

/sys/bus/platform/devices/*.ufs/attributes/configuration_descriptor_lock

定义在文件 sysfs-driver-ufs 中

此文件显示配置描述符是否被锁定。有关该属性的完整信息，请参阅 UFS 规范 2.1。该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/attributes/current_power_mode

/sys/bus/platform/devices/*.ufs/attributes/current_power_mode

定义在文件 sysfs-driver-ufs 中

此文件提供当前功耗模式 UFS 设备属性。有关该属性的完整信息，请参阅 UFS 规范 2.1。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/attributes/exception_event_control

/sys/bus/platform/devices/*.ufs/attributes/exception_event_control

定义在文件 sysfs-driver-ufs 中

此文件提供异常事件控制 UFS 设备属性。有关该属性的完整信息，请参阅 UFS 规范 2.1。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/attributes/exception_event_status

/sys/bus/platform/devices/*.ufs/attributes/exception_event_status

定义在文件 sysfs-driver-ufs 中

此文件提供异常事件状态 UFS 设备属性。有关该属性的完整信息，请参阅 UFS 规范 2.1。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/attributes/ffu_status

/sys/bus/platform/devices/*.ufs/attributes/ffu_status

定义在文件 sysfs-driver-ufs 中

此文件提供 ffu 状态 UFS 设备属性。有关该属性的完整信息，请参阅 UFS 规范 2.1。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/attributes/max_data_in_size

/sys/bus/platform/devices/*.ufs/attributes/max_data_in_size

定义在文件 sysfs-driver-ufs 中

此文件显示 DATA IN UPIU 中的最大数据大小。有关该属性的完整信息，请参阅 UFS 规范 2.1。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/attributes/max_data_out_size

/sys/bus/platform/devices/*.ufs/attributes/max_data_out_size

定义在文件 sysfs-driver-ufs 中

此文件显示可以通过 READY TO TRANSFER UPIU 请求的最大字节数。有关该属性的完整信息，请参阅 UFS 规范 2.1。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/attributes/max_number_of_rtt

/sys/bus/platform/devices/*.ufs/attributes/max_number_of_rtt

定义在文件 sysfs-driver-ufs 中

此文件提供设备中允许的最大当前未完成 RTT 数量。bMaxNumOfRTT 是一个读写持久属性，在设备制造后等于 2。它不应设置为大于 bDeviceRTTCap 值的值，并且只能在硬件队列为空时设置。

该文件为读写。

/sys/bus/platform/drivers/ufshcd/*/attributes/ooo_data_enabled

/sys/bus/platform/devices/*.ufs/attributes/ooo_data_enabled

定义在文件 sysfs-driver-ufs 中

此文件提供无序数据传输已启用 UFS 设备属性。有关该属性的完整信息，请参阅 UFS 规范 2.1。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/attributes/psa_data_size

/sys/bus/platform/devices/*.ufs/attributes/psa_data_size

定义在文件 sysfs-driver-ufs 中

此文件显示主机计划在预焊接状态下加载到所有逻辑单元的数据量。有关该属性的完整信息，请参阅 UFS 规范 2.1。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/attributes/psa_state

/sys/bus/platform/devices/*.ufs/attributes/psa_state

定义在文件 sysfs-driver-ufs 中

此文件显示 PSA 功能状态。有关该属性的完整信息，请参阅 UFS 规范 2.1。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/attributes/purge_status

/sys/bus/platform/devices/*.ufs/attributes/purge_status

定义在文件 sysfs-driver-ufs 中

此文件提供清除操作状态 UFS 设备属性。有关该属性的完整信息，请参阅 UFS 规范 2.1。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/attributes/reference_clock_frequency

/sys/bus/platform/devices/*.ufs/attributes/reference_clock_frequency

定义在文件 sysfs-driver-ufs 中

此文件提供参考时钟频率 UFS 设备属性。有关该属性的完整信息，请参阅 UFS 规范 2.1。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/attributes/wb_avail_buf

/sys/bus/platform/devices/*.ufs/attributes/wb_avail_buf

定义在文件 sysfs-driver-ufs 中

此条目显示可用的未使用 WriteBooster 缓冲区量。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/attributes/wb_cur_buf

/sys/bus/platform/devices/*.ufs/attributes/wb_cur_buf

定义在文件 sysfs-driver-ufs 中

此条目显示未使用的当前缓冲区量。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/attributes/wb_flush_status

/sys/bus/platform/devices/*.ufs/attributes/wb_flush_status

定义在文件 sysfs-driver-ufs 中

此条目显示刷新操作状态。

00h

空闲

01h

刷新操作正在进行中

02h

刷新操作过早停止。

03h

刷新操作成功完成

04h

刷新操作一般失败

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/attributes/wb_life_time_est

/sys/bus/platform/devices/*.ufs/attributes/wb_life_time_est

定义在文件 sysfs-driver-ufs 中

此条目显示基于执行的编程/擦除循环次数的 WriteBooster 缓冲区寿命指示

01h

0% - 10% 使用的 WriteBooster 缓冲区寿命

...

0Ah

90% - 100% 使用的 WriteBooster 缓冲区寿命

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/capabilities/clock_scaling

/sys/bus/platform/devices/*.ufs/capabilities/clock_scaling

定义在文件 sysfs-driver-ufs 中

指示时钟缩放的状态。

0

不支持时钟缩放。

1

支持时钟缩放。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/capabilities/write_booster

/sys/bus/platform/devices/*.ufs/capabilities/write_booster

定义在文件 sysfs-driver-ufs 中

指示写入加速器的状态。

0

无法启用写入加速器。

1

可以启用写入加速器。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/capabilities/

/sys/bus/platform/devices/*.ufs/capabilities/

定义在文件 sysfs-driver-ufs 中

该组表示主机设备对的有效功能。即驱动程序中为特定主机控制器启用的功能，该功能受主机控制器支持，并且在设备端受支持和/或具有兼容的配置。

/sys/bus/platform/drivers/ufshcd/*/device_descriptor/bkops_termination_latency

/sys/bus/platform/devices/*.ufs/device_descriptor/bkops_termination_latency

定义在文件 sysfs-driver-ufs 中

此文件显示后台操作终止延迟。这是 UFS 设备描述符参数之一。有关该描述符的完整信息，请参阅 UFS 规范 2.1。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/device_descriptor/boot_enable

/sys/bus/platform/devices/*.ufs/device_descriptor/boot_enable

定义在文件 sysfs-driver-ufs 中

此文件显示指示设备是否启用以进行引导的值。这是 UFS 设备描述符参数之一。有关该描述符的完整信息，请参阅 UFS 规范 2.1。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/device_descriptor/descriptor_access_enable

/sys/bus/platform/devices/*.ufs/device_descriptor/descriptor_access_enable

定义在文件 sysfs-driver-ufs 中

此文件显示一个值，指示在启动序列的部分初始化阶段后是否可以读取设备描述符。这是 UFS 设备描述符的参数之一。有关描述符的完整信息，请参阅 UFS 规范 2.1。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/device_descriptor/device_class

/sys/bus/platform/devices/*.ufs/device_descriptor/device_class

定义在文件 sysfs-driver-ufs 中

此文件显示设备类别。这是 UFS 设备描述符的参数之一。有关描述符的完整信息，请参阅 UFS 规范 2.1。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/device_descriptor/device_sub_class

/sys/bus/platform/devices/*.ufs/device_descriptor/device_sub_class

定义在文件 sysfs-driver-ufs 中

此文件显示 UFS 存储子类。这是 UFS 设备描述符的参数之一。有关描述符的完整信息，请参阅 UFS 规范 2.1。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/device_descriptor/device_type

/sys/bus/platform/devices/*.ufs/device_descriptor/device_type

定义在文件 sysfs-driver-ufs 中

此文件显示设备类型。这是 UFS 设备描述符的参数之一。有关描述符的完整信息，请参阅 UFS 规范 2.1。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/device_descriptor/device_version

/sys/bus/platform/devices/*.ufs/device_descriptor/device_version

定义在文件 sysfs-driver-ufs 中

此文件显示设备版本。这是 UFS 设备描述符的参数之一。有关描述符的完整信息，请参阅 UFS 规范 2.1。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/device_descriptor/ffu_timeout

/sys/bus/platform/devices/*.ufs/device_descriptor/ffu_timeout

定义在文件 sysfs-driver-ufs 中

此文件显示 FFU 超时。这是 UFS 设备描述符的参数之一。有关描述符的完整信息，请参阅 UFS 规范 2.1。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/device_descriptor/high_priority_lun

/sys/bus/platform/devices/*.ufs/device_descriptor/high_priority_lun

定义在文件 sysfs-driver-ufs 中

此文件显示高优先级 LUN。这是 UFS 设备描述符的参数之一。有关描述符的完整信息，请参阅 UFS 规范 2.1。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/device_descriptor/initial_active_icc_level

/sys/bus/platform/devices/*.ufs/device_descriptor/initial_active_icc_level

定义在文件 sysfs-driver-ufs 中

此文件显示初始活动 ICC 级别。这是 UFS 设备描述符的参数之一。有关描述符的完整信息，请参阅 UFS 规范 2.1。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/device_descriptor/initial_power_mode

/sys/bus/platform/devices/*.ufs/device_descriptor/initial_power_mode

定义在文件 sysfs-driver-ufs 中

此文件显示定义设备初始化或硬件重置后电源模式的值。这是 UFS 设备描述符的参数之一。有关描述符的完整信息，请参阅 UFS 规范 2.1。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/device_descriptor/manufacturer_id

/sys/bus/platform/devices/*.ufs/device_descriptor/manufacturer_id

定义在文件 sysfs-driver-ufs 中

此文件显示制造商 ID。这是 UFS 设备描述符的参数之一。有关描述符的完整信息，请参阅 UFS 规范 2.1。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/device_descriptor/manufacturing_date

/sys/bus/platform/devices/*.ufs/device_descriptor/manufacturing_date

定义在文件 sysfs-driver-ufs 中

此文件以 BCD 格式显示制造日期。这是 UFS 设备描述符的参数之一。有关描述符的完整信息，请参阅 UFS 规范 2.1。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/device_descriptor/number_of_luns

/sys/bus/platform/devices/*.ufs/device_descriptor/number_of_luns

定义在文件 sysfs-driver-ufs 中

此文件显示逻辑单元的数量。这是 UFS 设备描述符的参数之一。有关描述符的完整信息，请参阅 UFS 规范 2.1。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/device_descriptor/number_of_secure_wpa

/sys/bus/platform/devices/*.ufs/device_descriptor/number_of_secure_wpa

定义在文件 sysfs-driver-ufs 中

此文件显示设备支持的安全写保护区域的数量。这是 UFS 设备描述符的参数之一。有关描述符的完整信息，请参阅 UFS 规范 2.1。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/device_descriptor/number_of_wluns

/sys/bus/platform/devices/*.ufs/device_descriptor/number_of_wluns

定义在文件 sysfs-driver-ufs 中

此文件显示众所周知的逻辑单元的数量。这是 UFS 设备描述符的参数之一。有关描述符的完整信息，请参阅 UFS 规范 2.1。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/device_descriptor/protocol

/sys/bus/platform/devices/*.ufs/device_descriptor/protocol

定义在文件 sysfs-driver-ufs 中

此文件显示 UFS 设备支持的协议。这是 UFS 设备描述符的参数之一。有关描述符的完整信息，请参阅 UFS 规范 2.1。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/device_descriptor/psa_max_data_size

/sys/bus/platform/devices/*.ufs/device_descriptor/psa_max_data_size

定义在文件 sysfs-driver-ufs 中

此文件显示在 PSA 流程的预焊接阶段可以写入的最大数据量。这是 UFS 设备描述符的参数之一。有关描述符的完整信息，请参阅 UFS 规范 2.1。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/device_descriptor/psa_state_timeout

/sys/bus/platform/devices/*.ufs/device_descriptor/psa_state_timeout

定义在文件 sysfs-driver-ufs 中

此文件显示 PSA 状态更改的命令最大超时时间。这是 UFS 设备描述符的参数之一。有关描述符的完整信息，请参阅 UFS 规范 2.1。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/device_descriptor/queue_depth

/sys/bus/platform/devices/*.ufs/device_descriptor/queue_depth

定义在文件 sysfs-driver-ufs 中

此文件显示设备队列深度。这是 UFS 设备描述符的参数之一。有关描述符的完整信息，请参阅 UFS 规范 2.1。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/device_descriptor/rtc_update

/sys/bus/platform/devices/*.ufs/device_descriptor/rtc_update

定义在文件 sysfs-driver-ufs 中

此文件显示实时时钟更新的频率和方法。这是 UFS 设备描述符的参数之一。有关描述符的完整信息，请参阅 UFS 规范 2.1。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/device_descriptor/rtt_capability

/sys/bus/platform/devices/*.ufs/device_descriptor/rtt_capability

定义在文件 sysfs-driver-ufs 中

此文件显示设备支持的最大未完成 RTT 数量。这是 UFS 设备描述符的参数之一。有关描述符的完整信息，请参阅 UFS 规范 2.1。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/device_descriptor/secure_removal_type

/sys/bus/platform/devices/*.ufs/device_descriptor/secure_removal_type

定义在文件 sysfs-driver-ufs 中

此文件显示安全移除类型。这是 UFS 设备描述符的参数之一。有关描述符的完整信息，请参阅 UFS 规范 2.1。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/device_descriptor/specification_version

/sys/bus/platform/devices/*.ufs/device_descriptor/specification_version

定义在文件 sysfs-driver-ufs 中

此文件显示规范版本。这是 UFS 设备描述符的参数之一。有关描述符的完整信息，请参阅 UFS 规范 2.1。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/device_descriptor/support_security_lun

/sys/bus/platform/devices/*.ufs/device_descriptor/support_security_lun

定义在文件 sysfs-driver-ufs 中

此文件显示是否支持安全 LUN。这是 UFS 设备描述符的参数之一。有关描述符的完整信息，请参阅 UFS 规范 2.1。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/device_descriptor/ufs_features

/sys/bus/platform/devices/*.ufs/device_descriptor/ufs_features

定义在文件 sysfs-driver-ufs 中

此文件显示设备支持的功能。这是 UFS 设备描述符的参数之一。有关描述符的完整信息，请参阅 UFS 规范 2.1。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/device_descriptor/wb_presv_us_en

/sys/bus/platform/devices/*.ufs/device_descriptor/wb_presv_us_en

定义在文件 sysfs-driver-ufs 中

此条目显示是否配置了保留用户空间

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/device_descriptor/wb_shared_alloc_units

/sys/bus/platform/devices/*.ufs/device_descriptor/wb_shared_alloc_units

定义在文件 sysfs-driver-ufs 中

此条目显示 WB 缓冲区的共享分配单元

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/device_descriptor/wb_type

/sys/bus/platform/devices/*.ufs/device_descriptor/wb_type

定义在文件 sysfs-driver-ufs 中

此条目显示配置的 WB 类型。0x1 表示共享缓冲区模式。0x0 表示专用缓冲区模式。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/enable_wb_buf_flush

/sys/bus/platform/devices/*.ufs/enable_wb_buf_flush

定义在文件 sysfs-driver-ufs 中

此条目显示 WriteBooster 缓冲区刷新的状态，可用于启用或禁用刷新。如果启用了刷新，则当命令队列为空时，设备将执行刷新操作。

/sys/bus/platform/drivers/ufshcd/*/flags/bkops_enable

/sys/bus/platform/devices/*.ufs/flags/bkops_enable

定义在文件 sysfs-driver-ufs 中

此文件显示是否启用了设备后台操作。有关该标志的完整信息，请参阅 UFS 规范 2.1。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/flags/busy_rtc

/sys/bus/platform/devices/*.ufs/flags/busy_rtc

定义在文件 sysfs-driver-ufs 中

此文件显示设备是否正在执行与实时时钟相关的内部操作。有关该标志的完整信息，请参阅 UFS 规范 2.1。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/flags/device_init

/sys/bus/platform/devices/*.ufs/flags/device_init

定义在文件 sysfs-driver-ufs 中

此文件显示设备初始化状态。有关该标志的完整信息，请参阅 UFS 规范 2.1。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/flags/disable_fw_update

/sys/bus/platform/devices/*.ufs/flags/disable_fw_update

定义在文件 sysfs-driver-ufs 中

此文件显示是否永久禁用了设备固件更新。有关该标志的完整信息，请参阅 UFS 规范 2.1。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/flags/life_span_mode_enable

/sys/bus/platform/devices/*.ufs/flags/life_span_mode_enable

定义在文件 sysfs-driver-ufs 中

此文件显示是否启用了设备寿命模式。有关该标志的完整信息，请参阅 UFS 规范 2.1。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/flags/permanent_wpe

/sys/bus/platform/devices/*.ufs/flags/permanent_wpe

定义在文件 sysfs-driver-ufs 中

此文件显示是否启用了永久写保护。有关该标志的完整信息，请参阅 UFS 规范 2.1。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/flags/phy_resource_removal

/sys/bus/platform/devices/*.ufs/flags/phy_resource_removal

定义在文件 sysfs-driver-ufs 中

此文件显示是否启用了物理资源移除。有关该标志的完整信息，请参阅 UFS 规范 2.1。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/flags/power_on_wpe

/sys/bus/platform/devices/*.ufs/flags/power_on_wpe

定义在文件 sysfs-driver-ufs 中

此文件显示是否对所有配置为上电写保护的逻辑单元启用了写保护。有关该标志的完整信息，请参阅 UFS 规范 2.1。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/flags/wb_enable

/sys/bus/platform/devices/*.ufs/flags/wb_enable

定义在文件 sysfs-driver-ufs 中

此条目显示 WriteBooster 的状态。

0

未启用 WriteBooster。

1

已启用 WriteBooster

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/flags/wb_flush_during_h8

/sys/bus/platform/devices/*.ufs/flags/wb_flush_during_h8

定义在文件 sysfs-driver-ufs 中

在休眠状态期间刷新 WriteBooster 缓冲区。

0

不允许设备在链路休眠状态期间刷新 WriteBooster 缓冲区。

1

允许设备在链路休眠状态期间刷新 WriteBooster 缓冲区。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/flags/wb_flush_en

/sys/bus/platform/devices/*.ufs/flags/wb_flush_en

定义在文件 sysfs-driver-ufs 中

此条目显示是否启用了刷新。

0

不执行刷新操作。

1

执行刷新操作。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/*_memory_capacity_adjustment_factor

/sys/bus/platform/devices/*.ufs/geometry_descriptor/*_memory_capacity_adjustment_factor

定义在文件 sysfs-driver-ufs 中

此文件显示不同内存类型（系统代码、非持久性、增强类型 1-4）的内存容量调整因子。这是 UFS 几何描述符的参数之一。有关描述符的完整信息，请参阅 UFS 规范 2.1。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/*_memory_max_alloc_units

/sys/bus/platform/devices/*.ufs/geometry_descriptor/*_memory_max_alloc_units

定义在文件 sysfs-driver-ufs 中

此文件显示不同内存类型（系统代码、非持久性、增强类型 1-4）的最大分配单元数。这是 UFS 几何描述符的参数之一。有关描述符的完整信息，请参阅 UFS 规范 2.1。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/allocation_unit_size

/sys/bus/platform/devices/*.ufs/geometry_descriptor/allocation_unit_size

定义在文件 sysfs-driver-ufs 中

此文件显示分配单元大小。这是 UFS 几何描述符的参数之一。有关描述符的完整信息，请参阅 UFS 规范 2.1。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/data_ordering

/sys/bus/platform/devices/*.ufs/geometry_descriptor/data_ordering

定义在文件 sysfs-driver-ufs 中

此文件显示对无序数据传输的支持。这是 UFS 几何描述符的参数之一。有关描述符的完整信息，请参阅 UFS 规范 2.1。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/dyn_capacity_resource_policy

/sys/bus/platform/devices/*.ufs/geometry_descriptor/dyn_capacity_resource_policy

定义在文件 sysfs-driver-ufs 中

此文件显示动态容量资源策略。这是 UFS 几何描述符的参数之一。有关描述符的完整信息，请参阅 UFS 规范 2.1。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/max_in_buffer_size

/sys/bus/platform/devices/*.ufs/geometry_descriptor/max_in_buffer_size

定义在文件 sysfs-driver-ufs 中

此文件显示最大数据输入缓冲区大小。这是 UFS 几何描述符参数之一。有关描述符的完整信息，请参阅 UFS 规范 2.1。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/max_number_of_contexts

/sys/bus/platform/devices/*.ufs/geometry_descriptor/max_number_of_contexts

定义在文件 sysfs-driver-ufs 中

此文件显示设备支持的最大可用上下文数量。这是 UFS 几何描述符参数之一。有关描述符的完整信息，请参阅 UFS 规范 2.1。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/max_number_of_luns

/sys/bus/platform/devices/*.ufs/geometry_descriptor/max_number_of_luns

定义在文件 sysfs-driver-ufs 中

此文件显示 UFS 设备支持的最大逻辑单元数。这是 UFS 几何描述符参数之一。有关描述符的完整信息，请参阅 UFS 规范 2.1。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/max_out_buffer_size

/sys/bus/platform/devices/*.ufs/geometry_descriptor/max_out_buffer_size

定义在文件 sysfs-driver-ufs 中

此文件显示最大数据输出缓冲区大小。这是 UFS 几何描述符参数之一。有关描述符的完整信息，请参阅 UFS 规范 2.1。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/memory_types

/sys/bus/platform/devices/*.ufs/geometry_descriptor/memory_types

定义在文件 sysfs-driver-ufs 中

此文件显示支持的内存类型。这是 UFS 几何描述符参数之一。有关描述符的完整信息，请参阅 UFS 规范 2.1。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/min_addressable_block_size

/sys/bus/platform/devices/*.ufs/geometry_descriptor/min_addressable_block_size

定义在文件 sysfs-driver-ufs 中

此文件显示最小可寻址块大小。这是 UFS 几何描述符参数之一。有关描述符的完整信息，请参阅 UFS 规范 2.1。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/optimal_read_block_size

/sys/bus/platform/devices/*.ufs/geometry_descriptor/optimal_read_block_size

定义在文件 sysfs-driver-ufs 中

此文件显示最佳读取块大小。这是 UFS 几何描述符参数之一。有关描述符的完整信息，请参阅 UFS 规范 2.1。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/optimal_write_block_size

/sys/bus/platform/devices/*.ufs/geometry_descriptor/optimal_write_block_size

定义在文件 sysfs-driver-ufs 中

此文件显示最佳写入块大小。这是 UFS 几何描述符参数之一。有关描述符的完整信息，请参阅 UFS 规范 2.1。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/raw_device_capacity

/sys/bus/platform/devices/*.ufs/geometry_descriptor/raw_device_capacity

定义在文件 sysfs-driver-ufs 中

此文件显示用户可用于配置设备逻辑单元的总内存容量。这是 UFS 几何描述符参数之一。有关描述符的完整信息，请参阅 UFS 规范 2.1。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/rpmb_rw_size

/sys/bus/platform/devices/*.ufs/geometry_descriptor/rpmb_rw_size

定义在文件 sysfs-driver-ufs 中

此文件显示安全协议输入/输出中允许的最大 RPMB 帧数。这是 UFS 几何描述符参数之一。有关描述符的完整信息，请参阅 UFS 规范 2.1。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/secure_removal_types

/sys/bus/platform/devices/*.ufs/geometry_descriptor/secure_removal_types

定义在文件 sysfs-driver-ufs 中

此文件显示支持的安全移除类型。这是 UFS 几何描述符参数之一。有关描述符的完整信息，请参阅 UFS 规范 2.1。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/segment_size

/sys/bus/platform/devices/*.ufs/geometry_descriptor/segment_size

定义在文件 sysfs-driver-ufs 中

此文件显示段大小。这是 UFS 几何描述符参数之一。有关描述符的完整信息，请参阅 UFS 规范 2.1。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/sys_data_tag_resource_size

/sys/bus/platform/devices/*.ufs/geometry_descriptor/sys_data_tag_resource_size

定义在文件 sysfs-driver-ufs 中

此文件显示设备分配的最大存储区域大小，用于通过标记机制处理系统数据。这是 UFS 几何描述符参数之一。有关描述符的完整信息，请参阅 UFS 规范 2.1。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/sys_data_tag_unit_size

/sys/bus/platform/devices/*.ufs/geometry_descriptor/sys_data_tag_unit_size

定义在文件 sysfs-driver-ufs 中

此文件显示系统数据标记单元大小。这是 UFS 几何描述符参数之一。有关描述符的完整信息，请参阅 UFS 规范 2.1。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/wb_buff_cap_adj

/sys/bus/platform/devices/*.ufs/geometry_descriptor/wb_buff_cap_adj

定义在文件 sysfs-driver-ufs 中

此条目显示在共享缓冲区模式下，用户空间总共减少的量。当 SLC 模式用作 WriteBooster 缓冲区时，对于 TLC NAND，此参数的值为 3。对于 MLC NAND，此值为 2。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/wb_max_alloc_units

/sys/bus/platform/devices/*.ufs/geometry_descriptor/wb_max_alloc_units

定义在文件 sysfs-driver-ufs 中

此条目显示整个设备支持的最大 WriteBooster 缓冲区总大小。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/wb_max_wb_luns

/sys/bus/platform/devices/*.ufs/geometry_descriptor/wb_max_wb_luns

定义在文件 sysfs-driver-ufs 中

此条目显示可支持 WriteBooster 的最大逻辑单元数。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/wb_sup_red_type

/sys/bus/platform/devices/*.ufs/geometry_descriptor/wb_sup_red_type

定义在文件 sysfs-driver-ufs 中

用户空间减少模式和保留用户空间模式的支持性。00h：WriteBooster 缓冲区只能配置为用户空间减少类型。01h：WriteBooster 缓冲区只能配置为保留用户空间类型。02h：设备可以配置为用户空间减少类型或保留用户空间类型。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/wb_sup_wb_type

/sys/bus/platform/devices/*.ufs/geometry_descriptor/wb_sup_wb_type

定义在文件 sysfs-driver-ufs 中

WriteBooster 缓冲区类型的支持性。

00h

基于逻辑单元的 WriteBooster 缓冲区配置

01h

单共享 WriteBooster 缓冲区配置

02h

同时支持基于逻辑单元的 WriteBooster 缓冲区和单共享 WriteBooster 缓冲区配置

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/health_descriptor/eol_info

/sys/bus/platform/devices/*.ufs/health_descriptor/eol_info

定义在文件 sysfs-driver-ufs 中

此文件显示生命周期结束前的信息。这是 UFS 健康描述符参数之一。有关描述符的完整信息，请参阅 UFS 规范 2.1。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/health_descriptor/life_time_estimation_a

/sys/bus/platform/devices/*.ufs/health_descriptor/life_time_estimation_a

定义在文件 sysfs-driver-ufs 中

此文件显示设备生命周期的指示（方法 a）。这是 UFS 健康描述符参数之一。有关描述符的完整信息，请参阅 UFS 规范 2.1。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/health_descriptor/life_time_estimation_b

/sys/bus/platform/devices/*.ufs/health_descriptor/life_time_estimation_b

定义在文件 sysfs-driver-ufs 中

此文件显示设备生命周期的指示（方法 b）。这是 UFS 健康描述符参数之一。有关描述符的完整信息，请参阅 UFS 规范 2.1。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/interconnect_descriptor/mphy_version

/sys/bus/platform/devices/*.ufs/interconnect_descriptor/mphy_version

定义在文件 sysfs-driver-ufs 中

此文件以 BCD 格式显示 MIPI M-PHY 版本号。这是 UFS 互连描述符参数之一。有关描述符的完整信息，请参阅 UFS 规范 2.1。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/interconnect_descriptor/unipro_version

/sys/bus/platform/devices/*.ufs/interconnect_descriptor/unipro_version

定义在文件 sysfs-driver-ufs 中

此文件以 BCD 格式显示 MIPI UniPro 版本号。这是 UFS 互连描述符参数之一。有关描述符的完整信息，请参阅 UFS 规范 2.1。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/monitor/monitor_chunk_size

/sys/bus/platform/devices/*.ufs/monitor/monitor_chunk_size

定义在文件 sysfs-driver-ufs 中

此文件告知监视器专注于传输特定块大小（以字节为单位）数据的请求。0 表示任何块大小。只有在禁用监视器时才能更改它。

/sys/bus/platform/drivers/ufshcd/*/monitor/monitor_enable

/sys/bus/platform/devices/*.ufs/monitor/monitor_enable

定义在文件 sysfs-driver-ufs 中

此文件显示性能监视器启用状态，可用于启动/停止监视器。当监视器停止时，收集的性能数据也会被清除。

/sys/bus/platform/drivers/ufshcd/*/monitor/read_nr_requests

/sys/bus/platform/devices/*.ufs/monitor/read_nr_requests

定义在文件 sysfs-driver-ufs 中

此文件显示在监视器启动后已发送多少个读取请求。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/monitor/read_req_latency_avg

/sys/bus/platform/devices/*.ufs/monitor/read_req_latency_avg

定义在文件 sysfs-driver-ufs 中

此文件显示在监视器启动后，读取请求的平均延迟（以微秒为单位）。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/monitor/read_req_latency_max

/sys/bus/platform/devices/*.ufs/monitor/read_req_latency_max

定义在文件 sysfs-driver-ufs 中

此文件显示在监视器启动后，读取请求的最大延迟（以微秒为单位）。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/monitor/read_req_latency_min

/sys/bus/platform/devices/*.ufs/monitor/read_req_latency_min

定义在文件 sysfs-driver-ufs 中

此文件显示在监视器启动后，读取请求的最小延迟（以微秒为单位）。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/monitor/read_req_latency_sum

/sys/bus/platform/devices/*.ufs/monitor/read_req_latency_sum

定义在文件 sysfs-driver-ufs 中

此文件显示在监视器启动后发送的读取请求的总延迟（以微秒为单位）。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/monitor/read_total_busy

/sys/bus/platform/devices/*.ufs/monitor/read_total_busy

定义在文件 sysfs-driver-ufs 中

此文件显示在监视器启动后，从设备向主机发送数据所花费的时间（以微秒为单位）。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/monitor/read_total_sectors

/sys/bus/platform/devices/*.ufs/monitor/read_total_sectors

定义在文件 sysfs-driver-ufs 中

此文件显示在监视器启动后，从设备向主机发送的扇区数（以 512 字节为单位）。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/monitor/write_nr_requests

/sys/bus/platform/devices/*.ufs/monitor/write_nr_requests

定义在文件 sysfs-driver-ufs 中

此文件显示在监视器启动后已发送多少个写入请求。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/monitor/write_req_latency_avg

/sys/bus/platform/devices/*.ufs/monitor/write_req_latency_avg

定义在文件 sysfs-driver-ufs 中

此文件显示在监视器启动后，写入请求的平均延迟（以微秒为单位）。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/monitor/write_req_latency_max

/sys/bus/platform/devices/*.ufs/monitor/write_req_latency_max

定义在文件 sysfs-driver-ufs 中

此文件显示在监视器启动后，写入请求的最大延迟（以微秒为单位）。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/monitor/write_req_latency_min

/sys/bus/platform/devices/*.ufs/monitor/write_req_latency_min

定义在文件 sysfs-driver-ufs 中

此文件显示在监视器启动后，写入请求的最小延迟（以微秒为单位）。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/monitor/write_req_latency_sum

/sys/bus/platform/devices/*.ufs/monitor/write_req_latency_sum

定义在文件 sysfs-driver-ufs 中

此文件显示在监视器启动后，写入请求的总延迟（以微秒为单位）。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/monitor/write_total_busy

/sys/bus/platform/devices/*.ufs/monitor/write_total_busy

定义在文件 sysfs-driver-ufs 中

此文件显示在监视器启动后，从主机向设备发送数据所花费的时间（以微秒为单位）。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/monitor/write_total_sectors

/sys/bus/platform/devices/*.ufs/monitor/write_total_sectors

定义在文件 sysfs-driver-ufs 中

此文件显示在监视器启动后，从主机向设备发送的扇区数（以 512 字节为单位）。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/power_descriptor/active_icc_levels_vcc*

/sys/bus/platform/devices/*.ufs/power_descriptor/active_icc_levels_vcc*

定义在文件 sysfs-driver-ufs 中

此文件显示从 0 到 15 的活动 ICC 级别的最大 VCC、VCCQ 和 VCCQ2 值。这是 UFS 电源描述符参数之一。有关描述符的完整信息，请参阅 UFS 规范 2.1。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/power_info/dev_pm

/sys/bus/platform/devices/*.ufs/power_info/dev_pm

定义在文件 sysfs-driver-ufs 中

此文件显示 UFS 设备电源模式。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/power_info/gear

/sys/bus/platform/devices/*.ufs/power_info/gear

定义在文件 sysfs-driver-ufs 中

此文件显示 UFS 链路的档位。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/power_info/lane

/sys/bus/platform/devices/*.ufs/power_info/lane

定义在文件 sysfs-driver-ufs 中

此文件显示 UFS 链路上启用的通道数，即，输出 2 表示 UFS 链路以 2 个通道运行。

该文件为只读。

定义在文件 sysfs-driver-ufs 中

此文件显示 UFS 链路的状态。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/power_info/mode

/sys/bus/platform/devices/*.ufs/power_info/mode

定义在文件 sysfs-driver-ufs 中

此文件显示UFS的PA电源模式。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/power_info/rate

/sys/bus/platform/devices/*.ufs/power_info/rate

定义在文件 sysfs-driver-ufs 中

此文件显示UFS链路的速度速率。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/rpm_lvl

/sys/bus/platform/devices/*.ufs/rpm_lvl

定义在文件 sysfs-driver-ufs 中

此条目可用于设置或显示UFS设备的运行时电源管理级别。当前的驱动程序实现支持7个级别，具有以下目标状态

0

UFS设备将保持活动状态，UIC链路将保持活动状态

1

UFS设备将保持活动状态，UIC链路将休眠

2

UFS设备将进入睡眠状态，UIC链路将保持活动状态

3

UFS设备将进入睡眠状态，UIC链路将休眠

4

UFS设备将断电，UIC链路将休眠

5

UFS设备将断电，UIC链路将断电

6

UFS设备将进入深度睡眠状态，UIC链路将断电。注意，深度睡眠可能不支持，在这种情况下，此值将不被接受

/sys/bus/platform/drivers/ufshcd/*/rpm_target_dev_state

/sys/bus/platform/devices/*.ufs/rpm_target_dev_state

定义在文件 sysfs-driver-ufs 中

此条目显示为选定的运行时电源管理级别，UFS设备的目标电源模式。

该文件为只读。

定义在文件 sysfs-driver-ufs 中

此条目显示为选定的运行时电源管理级别，UFS UIC链路的目标状态。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/rtc_update_ms

/sys/bus/platform/devices/*.ufs/rtc_update_ms

定义在文件 sysfs-driver-ufs 中

rtc_update_ms 表示主机应多久同步或更新UFS RTC。如果设置为0，这将禁用UFS RTC定期更新。

/sys/bus/platform/drivers/ufshcd/*/spm_lvl

/sys/bus/platform/devices/*.ufs/spm_lvl

定义在文件 sysfs-driver-ufs 中

此条目可用于设置或显示UFS设备系统电源管理级别。当前的驱动程序实现支持7个级别，具有以下目标状态

0

UFS设备将保持活动状态，UIC链路将保持活动状态

1

UFS设备将保持活动状态，UIC链路将休眠

2

UFS设备将进入睡眠状态，UIC链路将保持活动状态

3

UFS设备将进入睡眠状态，UIC链路将休眠

4

UFS设备将断电，UIC链路将休眠

5

UFS设备将断电，UIC链路将断电

6

UFS设备将进入深度睡眠状态，UIC链路将断电。注意，深度睡眠可能不支持，在这种情况下，此值将不被接受

/sys/bus/platform/drivers/ufshcd/*/spm_target_dev_state

/sys/bus/platform/devices/*.ufs/spm_target_dev_state

定义在文件 sysfs-driver-ufs 中

此条目显示为选定的系统电源管理级别，UFS设备的目标电源模式。

该文件为只读。

定义在文件 sysfs-driver-ufs 中

此条目显示为选定的系统电源管理级别，UFS UIC链路的目标状态。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/string_descriptors/manufacturer_name

/sys/bus/platform/devices/*.ufs/string_descriptors/manufacturer_name

定义在文件 sysfs-driver-ufs 中

此文件包含设备制造商名称字符串。有关描述符的完整信息，请参阅UFS规范2.1。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/string_descriptors/oem_id

/sys/bus/platform/devices/*.ufs/string_descriptors/oem_id

定义在文件 sysfs-driver-ufs 中

此文件包含OEM ID字符串。有关描述符的完整信息，请参阅UFS规范2.1。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/string_descriptors/product_name

/sys/bus/platform/devices/*.ufs/string_descriptors/product_name

定义在文件 sysfs-driver-ufs 中

此文件包含产品名称字符串。有关描述符的完整信息，请参阅UFS规范2.1。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/string_descriptors/product_revision

/sys/bus/platform/devices/*.ufs/string_descriptors/product_revision

定义在文件 sysfs-driver-ufs 中

此文件包含产品修订字符串。有关描述符的完整信息，请参阅UFS规范2.1。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/string_descriptors/serial_number

/sys/bus/platform/devices/*.ufs/string_descriptors/serial_number

定义在文件 sysfs-driver-ufs 中

此文件包含设备序列号字符串。有关描述符的完整信息，请参阅UFS规范2.1。

该文件为只读。

/sys/bus/platform/drivers/ufshcd/*/wb_flush_threshold

/sys/bus/platform/devices/*.ufs/wb_flush_threshold

定义在文件 sysfs-driver-ufs 中

wb_flush_threshold 表示刷新WriteBooster缓冲区的阈值，其值以10%粒度单位表示，例如“1”表示10%，“2”表示20%，依此类推。如果 avail_wb_buff < wb_flush_threshold，则表示需要刷新WriteBooster缓冲区，否则没有必要。

/sys/bus/platform/drivers/ufshcd/*/wb_on

/sys/bus/platform/devices/*.ufs/wb_on

定义在文件 sysfs-driver-ufs 中

此节点用于设置或显示是否启用UFS WriteBooster。向此文件回显0以禁用UFS WriteBooster，或回显1以启用它。WriteBooster在开机/复位后启用，但是，它会在CLK缩减/放大时禁用/启用（如果平台支持UFSHCD_CAP_CLK_SCALING）。对于不支持UFSHCD_CAP_CLK_SCALING的平台，我们可以通过此sysfs节点禁用/启用WriteBooster。

/sys/bus/platform/drivers/zynqmp_fpga_manager/firmware:zynqmp-firmware:pcap/status

在文件 sysfs-driver-zynqmp-fpga 中定义

（只读）读取fpga状态。读取返回一个十六进制值，该值表示FPGA设备的当前状态。状态值中的每个位位置都在下面描述（请参阅ug570第9章）。https://docs.xilinx.com/v/u/en-US/ug570-ultrascale-configuration

位 (0)

0：无CRC错误 1：CRC错误

位 (1)

0：解密器安全性未设置 1：解密器安全性已设置

位 (2)

0：MMCM/PLL未锁定 1：MMCM/PLL已锁定

位 (3)

0：DCI不匹配 1：DCI匹配

位 (4)

0：启动序列尚未完成 1：启动序列已完成

位 (5)

0：所有I/O都处于高阻抗状态 1：所有I/O的行为与配置相同

位 (6)

0：触发器和块RAM写入禁用 1：触发器和块RAM写入启用

位 (7)

0：GHIGH_B_STATUS断言 1：GHIGH_B_STATUS解除断言

BIT(8)到BIT(10)

模式引脚的状态

BIT(11)

0：初始化尚未完成 1：初始化完成

BIT(12)

INIT_B_PIN引脚上的值

BIT(13)

0：信号未释放 1：信号已释放

BIT(14)

DONE_PIN引脚上的值。

BIT(15)

0：无IDCODE_ERROR 1：IDCODE_ERROR

BIT(16)

0：无SECURITY_ERROR 1：SECURITY_ERROR

BIT(17)

如果设置，则系统监视器过温

BIT(18)到BIT(20)

启动状态机 (0 到 7) 阶段 0 = 000 阶段 1 = 001 阶段 2 = 011 阶段 3 = 010 阶段 4 = 110 阶段 5 = 111 阶段 6 = 101 阶段 7 = 100

BIT(25)到BIT(26)

指示检测到的总线宽度 00 = x1 01 = x8 10 = x16 11 = x32

其他位保留。

/sys/bus/rapidio/devices/<nn>:<d>:<iiii>

在文件 sysfs-bus-rapidio 中定义

对于每个RapidIO设备，RapidIO子系统都会在单独的子目录中创建文件，其设备名称格式为“nn:d:iiii”，其中

nn

设备所在的RapidIO网络的两位十六进制ID

d

设备类型：“e” - 用于端点或“s” - 用于交换机

iiii

用于端点的四位设备destID或用于交换机的交换机ID

例如，下面是一个设备目录列表，该列表表示具有一个交换机、一个主机和两个代理端点的典型RapidIO网络，如枚举主机（destID = 1）所见

/sys/bus/rapidio/devices/00:e:0000
/sys/bus/rapidio/devices/00:e:0002
/sys/bus/rapidio/devices/00:s:0001
注意

枚举或发现端点不会为其自身创建sysfs条目，这就是为什么列表中未显示destID=1的端点。

所有RapidIO设备的通用属性

/sys/bus/rapidio/devices/<nn>:<d>:<iiii>/asm_did

在文件 sysfs-bus-rapidio 中定义

（只读）返回包含设备的组件的标识符

/sys/bus/rapidio/devices/<nn>:<d>:<iiii>/asm_rev

在文件 sysfs-bus-rapidio 中定义

（只读）返回包含设备的组件的修订级别

/sys/bus/rapidio/devices/<nn>:<d>:<iiii>/asm_vid

在文件 sysfs-bus-rapidio 中定义

（只读）返回包含设备的组件的供应商标识符

/sys/bus/rapidio/devices/<nn>:<d>:<iiii>/config

在文件 sysfs-bus-rapidio 中定义

（读写）使用RapidIO维护事务读取和写入设备配置寄存器的二进制属性。此属性的行为类似于PCI设备的“config”属性，并提供使用标准文件读取和写入操作访问RapidIO设备寄存器的权限。

RapidIO交换机设备属性

RapidIO交换机在sysfs中具有其他属性。RapidIO子系统支持交换机的通用和设备特定的sysfs属性。由于交换机已集成到RapidIO子系统中，因此它提供了一种通过指定回调函数来创建设备特定的sysfs属性的方法，该回调函数可以由交换机初始化例程在枚举或发现过程中设置。

/sys/bus/rapidio/devices/<nn>:<d>:<iiii>/destid

在文件 sysfs-bus-rapidio 中定义

（只读）返回由枚举例程分配的设备目标ID

/sys/bus/rapidio/devices/<nn>:<d>:<iiii>/device_rev

在文件 sysfs-bus-rapidio 中定义

（只读）返回设备修订级别

/sys/bus/rapidio/devices/<nn>:<d>:<iiii>/did

在文件 sysfs-bus-rapidio 中定义

（只读）返回设备标识符

/sys/bus/rapidio/devices/<nn>:<d>:<iiii>/lprev

在文件 sysfs-bus-rapidio 中定义

（只读）返回路径上拥有此属性的设备的上一设备（交换机）的名称

/sys/bus/rapidio/devices/<nn>:<d>:<iiii>/modalias

在文件 sysfs-bus-rapidio 中定义

（只读）返回设备modalias

/sys/bus/rapidio/devices/<nn>:<d>:<iiii>/vid

在文件 sysfs-bus-rapidio 中定义

（只读）返回设备供应商标识符

/sys/bus/rapidio/devices/<nn>:<s>:<iiii>/destid

在文件 sysfs-bus-rapidio 中定义

（只读）关联设备的设备目标ID，该设备定义到交换机的路由

/sys/bus/rapidio/devices/<nn>:<s>:<iiii>/errlog

在文件 sysfs-bus-rapidio 中定义

（只读）读取设备错误日志的内容，直到它为空。

RapidIO总线属性

/sys/bus/rapidio/devices/<nn>:<s>:<iiii>/hopcount

在文件 sysfs-bus-rapidio 中定义

（只读）到交换机路径上的跳数

/sys/bus/rapidio/devices/<nn>:<s>:<iiii>/lnext

在文件 sysfs-bus-rapidio 中定义

（只读）返回链接到交换机的设备的名称，除了链接到入口端口的设备（报告为“lprev”）。这是一个名称数组，行数等于交换机中的端口数。如果交换机端口没有附加设备，则返回“null”而不是设备名称。

设备特定的交换机属性

IDT_GEN2-

/sys/bus/rapidio/devices/<nn>:<s>:<iiii>/routes

在文件 sysfs-bus-rapidio 中定义

（只读）以“destID port”格式报告交换机路由信息。此属性仅报告有效的路由表条目，每个条目一行。

/sys/bus/rapidio/scan

在文件 sysfs-bus-rapidio 中定义

（只写）允许从用户空间触发枚举发现过程。要在特定的mport设备上启动枚举或发现过程，用户需要将mport_ID（不是RapidIO目标ID）写入此文件。mport_ID是分配给mport设备的顺序号（0 ... RIO_MAX_MPORTS）。例如，对于具有单个RapidIO控制器的计算机，该控制器的mport_ID始终为0。要在所有可用的mport上启动RapidIO枚举/发现，用户必须将“-1”（或RIO_MPORT_ANY）写入此属性文件。

/sys/bus/rbd/add

在文件 sysfs-bus-rbd 中定义

（只写）添加rbd块设备。

用法：<mon ip addr> <options> <pool name> <rbd image name> [<snap name>]

示例

$ echo "192.168.0.1 name=admin rbd foo" > /sys/bus/rbd/add

快照名称可以是“-”或省略以映射图像读/写。将为任何注册的块设备分配一个<dev-id>。如果使用快照，它将以只读方式映射。

/sys/bus/rbd/add_single_major

在文件 sysfs-bus-rbd 中定义

（只写）仅当 rbd 模块以设置为 true 的 single_major 参数插入时可用。

用法与 /sys/bus/rbd/add 相同。如果存在，则应使用此属性而不是后者：如果 /sys/bus/rbd/add_single_major 可用，则出于向后兼容的原因，任何尝试使用 /sys/bus/rbd/add 的尝试都将失败。

/sys/bus/rbd/devices/<dev-id>/image_id

/sys/bus/rbd/devices/<dev-id>/features

在文件 sysfs-bus-rbd 中定义

image_id

（只读）rbd 图像的唯一 id。（对于 rbd 图像格式 1，此项为空。）

features

（只读）此图像的功能位的十六进制编码。

/sys/bus/rbd/devices/<dev-id>/minor

在文件 sysfs-bus-rbd 中定义

（只读）块设备次要编号。

/sys/bus/rbd/devices/<dev-id>/parent

在文件 sysfs-bus-rbd 中定义

（只读）用于标识分层 rbd 图像中父图像链的信息。条目用空行分隔。

/sys/bus/rbd/devices/<dev-id>/pool_id

在文件 sysfs-bus-rbd 中定义

(RO) rbd 镜像池的唯一标识符。这是池的永久属性。池的 ID 永远不会改变。

/sys/bus/rbd/devices/<dev-id>/size

/sys/bus/rbd/devices/<dev-id>/major

/sys/bus/rbd/devices/<dev-id>/client_id

/sys/bus/rbd/devices/<dev-id>/pool

/sys/bus/rbd/devices/<dev-id>/name

/sys/bus/rbd/devices/<dev-id>/refresh

/sys/bus/rbd/devices/<dev-id>/current_snap

在文件 sysfs-bus-rbd 中定义

size

(RO) 映射的块设备的大小（以字节为单位）。

major

(RO) 块设备的主设备号。

client_id

(RO) 为此特定会话分配的 Ceph 唯一客户端 ID。

pool

(RO) 此 rbd 镜像所在的存储池的名称。rbd 镜像名称在其池内是唯一的。

name

(RO) rbd 镜像的名称。

refresh

(WO) 写入此文件将重新读取镜像头数据并相应地设置所有相关的数据结构。

current_snap

(RO) 设备映射的当前快照。

/sys/bus/rbd/devices/<dev-id>/snap_id

/sys/bus/rbd/devices/<dev-id>/config_info

/sys/bus/rbd/devices/<dev-id>/cluster_fsid

/sys/bus/rbd/devices/<dev-id>/client_addr

在文件 sysfs-bus-rbd 中定义

snap_id

(RO) 当前快照的 ID。

config_info

(RO) 写入 /sys/bus/rbd/add{,_single_major} 的字符串。

cluster_fsid

(RO) Ceph 集群 UUID。

client_addr

(RO) Ceph 唯一的客户端实体地址 (entity_addr_t)（地址 + 随机数）。格式为 <address>:<port>/<nonce>： ‘1.2.3.4:1234/5678’ 或 ‘[1:2:3:4:5:6:7:8]:1234/5678’。

/sys/bus/rbd/remove

在文件 sysfs-bus-rbd 中定义

(WO) 移除 rbd 块设备。

用法： <dev-id> [force]

示例

$ echo 2 > /sys/bus/rbd/remove

可选的“force”参数，如果传递此参数，将等待正在运行的请求，然后取消映射镜像。在启动移除后发送到驱动程序的请求将失败。（2016 年 8 月，自 4.9 版本起。）

/sys/bus/rbd/remove_single_major

在文件 sysfs-bus-rbd 中定义

（只写）仅当 rbd 模块以设置为 true 的 single_major 参数插入时可用。

用法与 /sys/bus/rbd/remove 相同。如果存在，则应使用此文件代替后者：如果 /sys/bus/rbd/remove_single_major 可用，则出于向后兼容性的原因，任何使用 /sys/bus/rbd/remove 的尝试都将失败。

/sys/bus/rbd/supported_features

在文件 sysfs-bus-rbd 中定义

(RO) 显示 rbd 模块支持的功能，以便用户空间可以生成有意义的错误消息，并说明需要禁用的不支持的功能。

/sys/bus/rpmsg/devices/.../announce

在文件 sysfs-bus-rpmsg 中定义

每个 rpmsg 设备都是与远程处理器通信的通道。通道由文本名称标识（请参见上面的 /sys/bus/rpmsg/devices/.../name），并具有本地（“源”）rpmsg 地址和远程（“目标”）rpmsg 地址。

当实体（无论是本地还是远程）开始侦听通道上的消息时（因此称为 rpmsg 服务器），首先会创建通道。

发生这种情况时，会向另一个处理器发送“名称服务”公告，以便让其知道通道的创建（这样，远程客户端就知道它们可以开始发送消息）。

此 sysfs 条目告诉我们通道是否是已公告的本地服务器通道（值为 true 或 false）。

/sys/bus/rpmsg/devices/.../driver_override

在文件 sysfs-bus-rpmsg 中定义

每个 rpmsg 设备都是与远程处理器通信的通道。通道由文本名称标识（请参见上面的 /sys/bus/rpmsg/devices/.../name），并具有本地（“源”）rpmsg 地址和远程（“目标”）rpmsg 地址。

与远程处理器通信的侦听实体（或客户端）称为 rpmsg 驱动程序。rpmsg 设备和 rpmsg 驱动程序根据 rpmsg 设备名称和 rpmsg 驱动程序 ID 表进行匹配。

此 sysfs 条目允许为 rpmsg 设备指定 rpmsg 驱动程序，这将覆盖标准的 OF、ID 表和名称匹配。

/sys/bus/rpmsg/devices/.../dst

在文件 sysfs-bus-rpmsg 中定义

每个 rpmsg 设备都是与远程处理器通信的通道。通道具有本地（“源”）rpmsg 地址和远程（“目标”）rpmsg 地址。当实体开始侦听通道的一端时，它会为其分配一个唯一的 rpmsg 地址（一个 32 位整数）。这样，当入站消息到达此地址时，rpmsg 核心会将它们分派到侦听实体。

此 sysfs 条目包含此通道的 dst（远程）rpmsg 地址。如果它包含 0xffffffff，则表示未分配地址（如果附加到此通道的内核驱动程序正在向远程处理器公开服务，则可能发生这种情况。这使其成为本地 rpmsg 服务器，并且正在侦听可能从任何远程 rpmsg 客户端发送的入站消息；它不绑定到单个远程实体）。

/sys/bus/rpmsg/devices/.../name

在文件 sysfs-bus-rpmsg 中定义

每个 rpmsg 设备都是与远程处理器通信的通道。通道由一个（文本）名称标识，该名称的最大长度为 32 字节（在 rpmsg.h 中定义为 RPMSG_NAME_SIZE）。

此 sysfs 条目包含此通道的名称。

/sys/bus/rpmsg/devices/.../src

在文件 sysfs-bus-rpmsg 中定义

每个 rpmsg 设备都是与远程处理器通信的通道。通道具有本地（“源”）rpmsg 地址和远程（“目标”）rpmsg 地址。当实体开始侦听通道的一端时，它会为其分配一个唯一的 rpmsg 地址（一个 32 位整数）。这样，当入站消息到达此地址时，rpmsg 核心会将它们分派到侦听实体（内核驱动程序）。

此 sysfs 条目包含此通道的 src（本地）rpmsg 地址。如果它包含 0xffffffff，则表示未分配地址（如果此通道不存在驱动程序，则可能发生这种情况）。

/sys/bus/scsi/drivers/st/debug_flag

在文件 sysfs-driver-st 中定义

此文件允许您通过将“0”写入文件来关闭 st 驱动程序的调试输出，或者通过将“1”写入文件来打开调试输出。请注意，调试输出要求该模块在编译时将 #define DEBUG 设置为非零值（这是默认值）。如果将 DEBUG 设置为 0，则此文件不会出现在 sysfs 中，因为它的存在取决于是否将调试输出支持编译到模块中。

/sys/bus/siox/devices/siox-X-Y/connected

在文件 sysfs-bus-siox 中定义

只读值。“0”表示 siox 总线 X 上的第 Y 个设备未“连接”，即无法确保与其通信。“1”表示连接正常。

/sys/bus/siox/devices/siox-X-Y/inbytes

在文件 sysfs-bus-siox 中定义

只读值，报告提供给 siox-X/device_add 的 inbytes 值

/sys/bus/siox/devices/siox-X-Y/outbytes

在文件 sysfs-bus-siox 中定义

只读值，报告提供给 siox-X/device_add 的 outbytes 值。

/sys/bus/siox/devices/siox-X-Y/status_errors

在文件 sysfs-bus-siox 中定义

计算读取状态字节未产生预期值的次数。

/sys/bus/siox/devices/siox-X-Y/type

在文件 sysfs-bus-siox 中定义

只读值，报告提供给 siox-X/device_add 的类型值。

/sys/bus/siox/devices/siox-X-Y/watchdog

在文件 sysfs-bus-siox 中定义

只读值，报告 siox 设备的看门狗是否处于活动状态。“0”表示看门狗未处于活动状态，并且设备应该可以运行。“1”表示看门狗使设备保持重置状态。

/sys/bus/siox/devices/siox-X-Y/watchdog_errors

在文件 sysfs-bus-siox 中定义

只读值，报告看门狗处于活动状态的次数。

/sys/bus/siox/devices/siox-X/active

在文件 sysfs-bus-siox 中定义

在读取时，表示总线的当前状态。如果它包含“0”，则总线已停止，并且由于看门狗触发，连接的设备应该不会执行任何操作。当文件包含“1”时，总线正在运行，并且会定期执行推拉循环以写入和读取连接设备的数据。

写入“0”或“1”时，总线将移动到所描述的状态。

/sys/bus/siox/devices/siox-X/device_add

在文件 sysfs-bus-siox 中定义

只写文件。写入

<type> <inbytes> <outbytes> <statustype>

以动态添加新设备。<type> 是用于匹配驱动程序的名称（类似于平台总线）。<inbytes> 和 <outbytes> 分别定义输入和输出移位寄存器的长度（以字节为单位）。

<statustype> 定义用于检查以识别连接问题的 4 位设备类型。

新设备将添加到现有链的末尾。

/sys/bus/siox/devices/siox-X/device_remove

在文件 sysfs-bus-siox 中定义

只写文件。单次写入会删除 siox 链中的最后一个设备。

/sys/bus/siox/devices/siox-X/poll_interval_ns

在文件 sysfs-bus-siox 中定义

定义两个轮询周期之间的时间间隔（以纳秒为单位）。请注意，写入时会将其舍入为 jiffies。读取时会返回当前值。

/sys/bus/soc

在文件 sysfs-devices-soc 中定义

/sys/bus/soc/ 目录包含大多数总线下的预期子文件夹。/sys/bus/soc/devices 特别值得关注，因为它包含系统中找到的每个 SoC 设备的符号链接。每个符号链接都指向前面提到的 /sys/devices/socX 设备。

/sys/bus/soundwire/devices/sdw-master-<N>/revision

在文件 sysfs-bus-soundwire-master 中定义

SoundWire Master-N DisCo 属性。这些属性由 MIPI SoundWire DisCo 规范定义。它们定义了 Master 的各种属性，并由总线用于配置 Master。clk_stop_modes 是一个用于简化的位掩码，它组合了 clock-stop-mode0 和 clock-stop-mode1 属性。

/sys/bus/soundwire/devices/sdw:.../dev-properties/mipi_revision

在文件 sysfs-bus-soundwire-slave 中定义

SoundWire Slave DisCo 属性。这些属性由 MIPI SoundWire DisCo 规范定义。它们定义了 SoundWire Slave 的各种属性，并由总线用于配置 Slave

/sys/bus/soundwire/devices/sdw:.../dp0/max_word

在文件 sysfs-bus-soundwire-slave 中定义

SoundWire Slave 数据端口 0 DisCo 属性。这些属性由 MIPI SoundWire DisCo 规范定义。它们定义了数据端口 0 的各种属性，并由总线用于配置数据端口 0。

/sys/bus/soundwire/devices/sdw:.../dp<N>_src/max_word

在文件 sysfs-bus-soundwire-slave 中定义

SoundWire Slave 数据源/接收器端口-N DisCo 属性。这些属性由 MIPI SoundWire DisCo 规范定义。它们定义了源/接收器数据端口 N 的各种属性，并由总线用于配置数据端口 N。

/sys/bus/soundwire/devices/sdw:.../status

在文件 sysfs-bus-soundwire-slave 中定义

SoundWire Slave 状态

这些属性报告 Slave 的状态，例如，它是否已分离，如果未分离，则显示 device_number。此状态信息有助于检测平台固件公开但物理上不在总线上的设备，反之亦然，检测平台固件中未公开但已枚举的设备。

/sys/bus/spi/<dev>/reset

在文件 sysfs-driver-ge-achc 中定义

此文件表示微控制器的复位线。1 表示复位线已置位，0 表示未置位。该文件可读写。

/sys/bus/spi/<dev>/update_firmware

在文件 sysfs-driver-ge-achc 中定义

将 1 写入此文件，以通过 EzPort 接口更新 ACHC 微控制器固件。为此，内核将通过固件 API（通常来自 /lib/firmware）加载“achc.bin”。写入操作将阻塞，直到固件已成功刷新或发生错误为止。

/sys/bus/spi/devices/.../spi-nor/jedec_id

在文件 sysfs-bus-spi-devices-spi-nor 中定义

(RO) SPI NOR 闪存的 JEDEC ID，由闪存设备报告。

如果闪存不支持“读取 JEDEC ID”命令 (9Fh)，则该属性不存在。非 JEDEC 兼容闪存就是这种情况。

/sys/bus/spi/devices/.../spi-nor/manufacturer

在文件 sysfs-bus-spi-devices-spi-nor 中定义

(只读) SPI NOR flash 的制造商。

如果内核不知道该闪存设备，且仅通过其 SFDP 表进行探测，则该属性不存在。

/sys/bus/spi/devices/.../spi-nor/partname

在文件 sysfs-bus-spi-devices-spi-nor 中定义

(只读) SPI NOR flash 的部件名称。

该属性是可选的。用户空间不应依赖它是否存在或甚至是否正确。相反，用户空间应读取 jedec_id 属性。

/sys/bus/spi/devices/.../spi-nor/sfdp

在文件 sysfs-bus-spi-devices-spi-nor 中定义

(只读) 仅当 SPI NOR flash 设备支持“读取 SFDP”命令 (5Ah) 时，才存在此属性。

如果存在，它包含闪存的完整 SFDP（串行闪存可发现参数）二进制数据。

/sys/bus/surface_aggregator/devices/01:0e:01:00:01/state

定义在文件 sysfs-bus-surface_aggregator-tabletsw

此属性返回一个字符串，其中包含嵌入式控制器指示的当前类型保护盖或设备姿态。当前返回的姿态状态为：

  • “disconnected”：类型保护盖已断开连接。

  • “closed”：类型保护盖已折叠关闭，并位于显示屏的顶部。

  • “laptop”：类型保护盖已打开并处于笔记本电脑模式，即已准备好正常使用。

  • “folded-canvas”：类型保护盖已部分向后折叠，但未与设备的背面齐平。通常，这意味着使用了支架，并且在保护盖的顶部伸出。

  • “folded-back”：类型保护盖已完全向后折叠，并与设备的背面齐平。

  • “<unknown>”：驱动程序不知道当前状态，例如，由于更新的尚未支持的硬件。

新的状态可能会随着新的硬件而引入。因此，用户不得依赖于此状态列表是详尽的，并且应优雅地处理未知状态。

/sys/bus/surface_aggregator/devices/01:26:01:00:01/state

定义在文件 sysfs-bus-surface_aggregator-tabletsw

此属性返回一个字符串，其中包含嵌入式控制器指示的当前设备姿态。当前返回的姿态状态为：

  • “closed”：设备的盖子已关闭。

  • “laptop”：设备的盖子已打开，设备作为普通笔记本电脑运行。

  • “slate”：屏幕遮盖了键盘，或者已被翻转回去，并且设备主要基于触摸输入运行。

  • “tablet”：设备作为平板电脑运行，并且完全依赖触摸输入（或外部外围设备）。

  • “<unknown>”：驱动程序不知道当前状态，例如，由于更新的尚未支持的硬件。

新的状态可能会随着新的硬件而引入。因此，用户不得依赖于此状态列表是详尽的，并且应优雅地处理未知状态。

/sys/bus/tee/devices/optee-ta-<uuid>/

定义在文件 sysfs-bus-optee-devices

OP-TEE 总线提供对此目录下注册驱动程序的引用。<uuid> 与安全操作系统中的可信应用程序 (TA) 驱动程序和相应的 TA 相匹配。驱动程序可以自由地在 optee-ta-<uuid> 目录下创建所需的 API。

/sys/bus/tee/devices/optee-ta-<uuid>/need_supplicant

定义在文件 sysfs-bus-optee-devices

允许区分基于 OP-TEE 的 TA/设备是否需要用户空间 tee-supplicant 才能正常运行。对于依赖于 tee-supplicant 运行的设备，将存在此属性。

/sys/bus/thunderbolt/devices/.../authorized

定义在文件 sysfs-bus-thunderbolt

此属性用于在 Thunderbolt 设备连接后对其进行授权。如果设备未授权，则系统将无法使用任何 PCIe 设备。

当设备尚未授权时，此属性的内容为 0。

支持的可能值为：

0

设备将被取消授权（仅在域下的 deauthorization 属性包含 1 时才支持）

1

设备将被授权并连接

当 key 属性包含 32 字节的十六进制字符串时，可能的值为：

0

设备将被取消授权（仅在域下的 deauthorization 属性包含 1 时才支持）

1

32 字节的十六进制字符串将添加到设备 NVM 中，并且该设备将被授权。

2

根据 32 字节的十六进制字符串发送质询。如果来自设备的质询响应有效，则该设备将被授权。如果失败，如果设备根本不包含密钥，则 errno 将为 ENOKEY，如果质询响应不匹配，则 errno 将为 EKEYREJECTED。

/sys/bus/thunderbolt/devices/.../boot

定义在文件 sysfs-bus-thunderbolt

如果 Thunderbolt 设备在启动时已获得授权，则此属性包含 1，否则包含 0。

/sys/bus/thunderbolt/devices/.../device

定义在文件 sysfs-bus-thunderbolt

此属性包含从设备 DROM 中提取的此设备的 ID。

/sys/bus/thunderbolt/devices/.../device_name

定义在文件 sysfs-bus-thunderbolt

此属性包含从设备 DROM 中提取的此设备的名称。

/sys/bus/thunderbolt/devices/.../domainX/boot_acl

定义在文件 sysfs-bus-thunderbolt

包含一个逗号分隔的设备 unique_id 列表，这些设备在系统启动期间（例如，启动设备）被允许自动连接。该列表始终包含最大支持的 unique_id 数量，其中未使用的条目为空。这允许用户空间软件确定控制器支持多少个条目。如果有多个控制器，则每个控制器都有自己的 ACL 列表，并且控制器之间的列表大小可能不同。

系统 BIOS 可能具有一个选项“Preboot ACL”或类似选项，需要在考虑此列表之前选择该选项。

软件始终在每次写入时更新完整列表。

如果在启动期间自动授权设备，则其 boot 属性设置为 1。

/sys/bus/thunderbolt/devices/.../domainX/deauthorization

定义在文件 sysfs-bus-thunderbolt

此属性指示系统是否支持设备的取消授权。值为 1 表示用户可以通过将 0 写入每个设备下的 authorized 属性来取消 PCIe 通道的授权。

/sys/bus/thunderbolt/devices/.../domainX/iommu_dma_protection

定义在文件 sysfs-bus-thunderbolt

此属性指示系统是否使用 IOMMU 进行 DMA 保护。值为 1 表示使用 IOMMU，值为 0 表示不使用（DMA 保护仅基于 Thunderbolt 安全级别）。

/sys/bus/thunderbolt/devices/.../domainX/security

定义在文件 sysfs-bus-thunderbolt

此属性保存系统 BIOS 设置的当前 Thunderbolt 安全级别。可能的值为：

无

自动授权所有设备

user

仅根据向 authorized 属性写入适当的值来授权设备

secure

至少需要支持安全连接的设备。用户需要授权每个设备。

dponly

自动隧道传输显示端口（和 USB）。不创建 PCIe 通道。

usbonly

自动隧道传输连接的 Thunderbolt 坞站的 USB 控制器（和显示端口）。删除坞站下游的所有 PCIe 链接。

nopcie

USB4 系统，其中 PCIe 通道已从 BIOS 中禁用。

/sys/bus/thunderbolt/devices/.../generation

定义在文件 sysfs-bus-thunderbolt

此属性包含与设备关联的 Thunderbolt 控制器的代数。对于 USB4，它将包含 4。

/sys/bus/thunderbolt/devices/.../key

定义在文件 sysfs-bus-thunderbolt

当设备支持 Thunderbolt 安全连接时，它将具有此属性。写入 32 字节的十六进制字符串会将授权更改为使用安全连接方法。写入空字符串将清除密钥，并且可以再次使用常规连接方法。

/sys/bus/thunderbolt/devices/.../maxhopid

定义在文件 sysfs-bus-thunderbolt

仅针对 XDomain 设置。其他主机作为其输入 HopID 支持的最大 HopID。

/sys/bus/thunderbolt/devices/.../nvm_authenticate

定义在文件 sysfs-bus-thunderbolt

当新的 NVM 映像被写入到非活动的 NVM 区域（通过 non_activeX NVMem 设备）时，通过写入此文件来启动身份验证过程。如果一切顺利，则使用新的 NVM 固件重新启动设备。如果映像验证失败，则返回一个错误代码。

此文件将接受写入值 “1”、“2” 或 “3”。

  • 写入 “1” 会将映像刷新到存储区域，并在一个操作中验证映像。

  • 写入 “2” 会对映像运行一些基本验证，并将其刷新到存储区域。

  • 写入 “3” 会验证当前写入存储区域的映像。仅 USB4 设备和重定时器支持此操作。

当读取时，如果在此过程中发生错误，则会保存上次身份验证操作的状态。这是在设备断电之前，基于 DMA 配置的邮箱中的直接状态值。在此处写入 0 会清除状态。

/sys/bus/thunderbolt/devices/.../nvm_authenticate_on_disconnect

定义在文件 sysfs-bus-thunderbolt

对于支持的设备，当设备与主机系统断开连接时，自动验证新的 Thunderbolt 映像。

此文件将接受写入值 “1” 或 “2”

  • 写入 “1” 会将映像刷新到存储区域，并准备设备在断开连接时进行身份验证。

  • 写入 “2” 会对映像运行一些基本验证，并将其刷新到存储区域。

/sys/bus/thunderbolt/devices/.../nvm_version

定义在文件 sysfs-bus-thunderbolt

如果设备具有可升级的固件，则此处的版本号可用。格式：%x.%x，主版本号.次版本号。如果设备处于安全模式，则读取该文件将返回 -ENODATA，因为 NVM 版本不可用。

/sys/bus/thunderbolt/devices/.../rx_lanes

定义在文件 sysfs-bus-thunderbolt

此属性报告设备通过其上游端口同时使用的 RX 通道数。

/sys/bus/thunderbolt/devices/.../rx_speed

定义在文件 sysfs-bus-thunderbolt

此属性报告每个通道的设备 RX 速度。所有 RX 通道均以相同的速度运行。

/sys/bus/thunderbolt/devices/.../tx_lanes

定义在文件 sysfs-bus-thunderbolt

此属性报告设备通过其上游端口同时使用的 TX 通道数。

/sys/bus/thunderbolt/devices/.../tx_speed

定义在文件 sysfs-bus-thunderbolt

此属性报告每个通道的 TX 速度。所有 TX 通道均以相同的速度运行。

/sys/bus/thunderbolt/devices/.../unique_id

定义在文件 sysfs-bus-thunderbolt

此属性包含此设备的 unique_id 字符串。这可以从硬件寄存器（较新硬件上的 UUID）读取，也可以基于设备 DROM 中的 UID 读取。可用于唯一标识特定设备。

/sys/bus/thunderbolt/devices/.../vendor

定义在文件 sysfs-bus-thunderbolt

此属性包含从设备 DROM 中提取的此设备的供应商 ID。

/sys/bus/thunderbolt/devices/.../vendor_name

定义在文件 sysfs-bus-thunderbolt

此属性包含从设备 DROM 中提取的此设备的供应商名称。

/sys/bus/thunderbolt/devices/<device>:<port>.<index>/device

定义在文件 sysfs-bus-thunderbolt

从硬件读取的重定时器设备标识符。

/sys/bus/thunderbolt/devices/<device>:<port>.<index>/nvm_authenticate

定义在文件 sysfs-bus-thunderbolt

当新的 NVM 映像被写入到非活动的 NVM 区域（通过 non_activeX NVMem 设备）时，通过向此文件写入 1 来启动身份验证过程。如果一切顺利，则使用新的 NVM 固件重新启动设备。如果映像验证失败，则返回一个错误代码。

当读取时，如果在此过程中发生错误，则会保存上次身份验证操作的状态。格式：%x。

/sys/bus/thunderbolt/devices/<device>:<port>.<index>/nvm_version

定义在文件 sysfs-bus-thunderbolt

保存重定时器 NVM 版本号。格式：%x.%x，主版本号.次版本号。

/sys/bus/thunderbolt/devices/<device>:<port>.<index>/vendor

定义在文件 sysfs-bus-thunderbolt

从硬件读取的重定时器供应商标识符。

/sys/bus/thunderbolt/devices/<xdomain>.<service>/key

定义在文件 sysfs-bus-thunderbolt

这包含 XDomain 服务公开的属性目录的名称。此条目描述所讨论的协议。以下目录已由 Apple XDomain 规范保留：

network

通过 Thunderbolt 的 IP/以太网

targetdm

通过 Thunderbolt 的目标磁盘模式协议

extdisp

通过 Thunderbolt 的外部显示模式协议

/sys/bus/thunderbolt/devices/<xdomain>.<service>/modalias

定义在文件 sysfs-bus-thunderbolt

存储由 XDomain 服务的 uevent 发出的相同 MODALIAS 值。格式：tbtsvc:kSpNvNrN

/sys/bus/thunderbolt/devices/<xdomain>.<service>/prtcid

定义在文件 sysfs-bus-thunderbolt

这包含 XDomain 服务支持的 XDomain 协议标识符。

/sys/bus/thunderbolt/devices/<xdomain>.<service>/prtcrevs

定义在文件 sysfs-bus-thunderbolt

此文件包含 XDomain 服务支持的 XDomain 软件版本。

/sys/bus/thunderbolt/devices/<xdomain>.<service>/prtcstns

定义在文件 sysfs-bus-thunderbolt

此文件包含 XDomain 服务特定的设置，以位掩码形式表示。格式：%x

/sys/bus/thunderbolt/devices/<xdomain>.<service>/prtcvers

定义在文件 sysfs-bus-thunderbolt

此文件包含 XDomain 服务支持的 XDomain 协议版本。

/sys/bus/thunderbolt/devices/usb4_portX/connector

定义在文件 sysfs-bus-thunderbolt

指向 USB Type-C 连接器的符号链接。仅当启用 USB Type-C 连接器类时，并且仅当系统固件能够描述端口及其连接器之间的连接时，才会创建此链接。

定义在文件 sysfs-bus-thunderbolt

返回当前链路模式。可能的值为 “usb4”、“tbt” 和 “none”。

/sys/bus/thunderbolt/devices/usb4_portX/offline

定义在文件 sysfs-bus-thunderbolt

向此属性写入 1 会将 USB4 端口置于离线模式。仅当端口没有连接任何设备时（link 属性返回 “none”）才允许此操作。一旦端口处于离线模式，它将不会接收任何热插拔事件。这用于更新板载重定时器的 NVM 固件。写入 0 会将端口恢复到在线模式。

仅当平台支持在未连接电缆时为重定时器供电时，此属性才可见。

/sys/bus/thunderbolt/devices/usb4_portX/rescan

定义在文件 sysfs-bus-thunderbolt

当 USB4 端口处于离线模式时，向此属性写入 1 会强制重新扫描侧带以查找板载重定时器。每个重定时器都会出现在 USB4 端口下，就像 USB4 链路已启动一样。这些重定时器的行为与连接电缆时相同，因此可以像往常一样升级其 NVM 固件。

/sys/bus/typec/devices/.../active

在文件 sysfs-bus-typec 中定义。

显示模式是否处于活动状态。该属性可用于进入/退出模式。进入/退出模式作为同步操作支持，因此写入（2）该属性直到进入/退出模式操作完成才会返回。当模式进入/退出时，会通知该属性，因此对该属性进行 poll(2) 会唤醒。进入/退出模式也会生成 uevent KOBJ_CHANGE。

有效值为布尔值。

/sys/bus/typec/devices/.../description

在文件 sysfs-bus-typec 中定义。

显示模式的描述。与广告牌设备一样，驱动程序可以选择是否提供描述。

/sys/bus/typec/devices/.../displayport/configuration

在文件 sysfs-driver-typec-displayport 中定义。

显示连接器当前的 DisplayPort 配置。有效值为 USB、source 和 sink。source 表示 DisplayPort 源，sink 表示 DisplayPort 接收器。

所有支持的配置都以空格分隔的列表列出，活动配置用方括号括起来。

源示例

USB [source] sink

可以通过写入文件来更改配置。

注意：USB 配置不等于退出模式。它是 VESA DisplayPort Alt Mode on USB Type-C 标准中定义的单独配置。从功能上讲，它等同于模式已退出的情况（要退出模式，请参见 testing/sysfs-bus-typec，并使用文件 /sys/bus/typec/devices/.../active）。

/sys/bus/typec/devices/.../displayport/hpd

在文件 sysfs-driver-typec-displayport 中定义。

VESA DisplayPort Alt Mode on USB Type-C 标准定义了在 DisplayPort Alt Mode 中运行时，如何在 USB-C 连接器上支持热插拔检测 (HPD)。这是一个只读节点，反映了 HPD 的当前状态。

有效值
  • 1：当 HPD 的逻辑状态为高电平 (HPD_High) 时，如定义。

    由 VESA DisplayPort Alt Mode on USB Type-C 标准定义。

  • 0：当 HPD 的逻辑状态为低电平 (HPD_Low) 时，如定义。

    由 VESA DisplayPort Alt Mode on USB Type-C 标准定义。

/sys/bus/typec/devices/.../displayport/pin_assignment

在文件 sysfs-driver-typec-displayport 中定义。

VESA DisplayPort Alt Mode on USB Type-C 标准为 USB Type-C 连接器定义了六种不同的引脚分配，分别标记为 A、B、C、D、E 和 F。支持的引脚分配以空格分隔的列表列出，活动引脚分配用方括号括起来。

示例

C [D]

可以通过写入文件来更改引脚分配。可以在设置配置之前设置引脚分配，但在实际配置连接器之前，该分配不会处于活动状态。

注意：从 VESA DisplayPort Alt Mode on USB Type-C 标准 1.0b 版本开始，引脚分配 A、B 和 F 已弃用。现在只有引脚分配 D 可以同时承载一个 USB SuperSpeed 协议通道。从用户角度来看，引脚分配 C 和 E 是相同的，其中连接器上的所有通道都用于承载 DisplayPort 协议（允许更高的分辨率）。

/sys/bus/typec/devices/.../mode

在文件 sysfs-bus-typec 中定义。

Discover Modes USB Power Delivery 命令返回的模式的索引号。根据备用模式，模式索引可能很重要。

对于某些备用模式 (SVID)，模式索引被分配给该备用模式规范中的特定功能。

对于其他备用模式，模式索引值未分配，因此不能用于标识。当未分配模式索引时，必须使用模式 VDO 或描述来标识备用模式。

/sys/bus/typec/devices/.../svid

在文件 sysfs-bus-typec 中定义。

USB-IF 为此备用模式分配的标准或供应商 ID (SVID)。

/sys/bus/typec/devices/.../vdo

在文件 sysfs-bus-typec 中定义。

显示此模式的 Discover Modes 命令返回的十六进制 VDO。

/sys/bus/usb-serial/drivers/.../new_id

在文件 sysfs-bus-usb 中定义。

对于串行 USB 驱动程序，此属性出现在 sysfs 中额外的总线文件夹 “usb-serial” 下；除了此差异之外，“/sys/bus/usb/drivers/.../new_id” 条目的所有描述均适用。

/sys/bus/usb/.../decimals

在文件 sysfs-bus-usb-devices-usbsevseg 中定义。

控制设备上的小数位数。要设置第 n 位小数，请将此字段的值设置为 10 ** n。假设此字段的值为 k 并且已设置 1 个或多个小数位，要设置第 m 位小数（其中 m 尚未设置），请将此字段的值更改为 k + 10 ** m。

/sys/bus/usb/.../mode_msb

/sys/bus/usb/.../mode_lsb

在文件 sysfs-bus-usb-devices-usbsevseg 中定义。

控制设备的显示模式。对于 6 个字符的显示屏，值如下：

MSB 0x06; LSB 0x3F，并且

对于 8 个字符的显示屏，值如下：

MSB 0x08; LSB 0xFF。

/sys/bus/usb/.../powered

在文件 sysfs-bus-usb-devices-usbsevseg 中定义。

控制是否为设备的显示屏供电。值为 0 表示关闭，非零值表示开启。

/sys/bus/usb/.../text

在文件 sysfs-bus-usb-devices-usbsevseg 中定义。

设备要显示的文本（或数据）。

/sys/bus/usb/.../textmode

在文件 sysfs-bus-usb-devices-usbsevseg 中定义。

控制设备解释其文本缓冲区的方式。raw：每个字符手动控制其段；hex：每个字符介于 0-15 之间；ascii：每个字符介于 ‘0’-‘9’ 和 ‘A’-‘F’ 之间。

/sys/bus/usb/device/.../authorized

在文件 sysfs-bus-usb 中定义。

授权设备可供设备驱动程序使用，未授权设备则不可用。默认情况下，有线 USB 设备已授权。

/sys/bus/usb/devices/.../<hub_interface>/port<X>

在文件 sysfs-bus-usb 中定义。

/sys/bus/usb/devices/.../<hub_interface>/port<X> 是 USB 端口设备的 sysfs 目录。

/sys/bus/usb/devices/.../<hub_interface>/port<X>/connect_type

在文件 sysfs-bus-usb 中定义。

某些平台通过 ACPI 提供 USB 端口连接类型。此属性用于向用户空间公开这些信息。如果信息可用，则该文件将读取 “hotplug”、“hardwired” 和 “not used”，否则读取 “unknown”。

/sys/bus/usb/devices/.../<hub_interface>/port<X>/connector

在文件 sysfs-bus-usb 中定义。

指向可用时 USB Type-C 连接器的链接。仅当启用 USB Type-C 连接器类时，并且仅当系统固件能够描述端口及其连接器之间的连接时，才会创建此链接。

/sys/bus/usb/devices/.../<hub_interface>/port<X>/disable

在文件 sysfs-bus-usb 中定义。

此文件控制 USB 端口的状态，包括 Vbus 电源输出（但仅限于支持电源切换的集线器 - 大多数集线器不支持）。如果端口被禁用，则该端口不可用：连接到该端口的设备将不会被检测到、初始化或枚举。

/sys/bus/usb/devices/.../<hub_interface>/port<X>/early_stop

在文件 sysfs-bus-usb 中定义。

某些 USB 主机具有一些看门狗机制，如果端口初始化时间过长，设备可能会进入 ramdump。此属性允许每个端口只有两次尝试，以便端口初始化会快速失败。此外，如果标记为 early_stop 的端口初始化失败，它将忽略所有未来的连接，直到此属性被清除。

/sys/bus/usb/devices/.../<hub_interface>/port<X>/location

在文件 sysfs-bus-usb 中定义。

某些平台通过固件提供 USB 端口物理位置。内核使用它来将逻辑端口配对到相同的物理连接器。该属性以十六进制整数形式公开原始位置值。

/sys/bus/usb/devices/.../<hub_interface>/port<X>/over_current_count

在文件 sysfs-bus-usb 中定义。

大多数集线器能够检测其端口上的过流情况，并将其报告给内核。此属性用于向用户空间公开特定端口上发生的过流情况次数。该文件将包含一个无符号 32 位值，该值在达到最大值后会回绕到 0。此文件支持 poll()，用于监视用户空间中此值的更改。

每当此值更改时，相应的集线器设备将发送具有以下属性的 udev 事件

OVER_CURRENT_PORT=/sys/bus/usb/devices/.../<hub_interface>/port<X>
OVER_CURRENT_COUNT=[current value of this sysfs attribute]

/sys/bus/usb/devices/.../<hub_interface>/port<X>/quirks

在文件 sysfs-bus-usb 中定义。

在某些情况下，我们关心在特定端口上连接的设备的激活时间（例如，非标准 USB 端口，如 pogo 引脚），其中要连接的设备是预先知道的，并且根据规范运行良好。此属性是一个位字段，用于控制特定端口的行为。

  • 此字段的第 0 位选择“旧”枚举方案，因为它速度明显更快（它只导致一次 USB 复位，而不是 2 次）。

    也可以使用 /sys/module/usbcore/parameters/old_scheme_first 全局选择旧的枚举方案，但这通常不是期望的做法，因为引入新方案是为了提高与更多设备的兼容性。

  • 位 1 将 TRSTRCY 减少到 USB 2.0 规范要求的 10 毫秒，而不是通常使用的 50 毫秒，后者是为了帮助一些高速设备更好地进行枚举。

/sys/bus/usb/devices/.../<hub_interface>/port<X>/state

在文件 sysfs-bus-usb 中定义。

指示连接到端口的 USB 设备当前状态。有效状态包括：“not-attached”（未连接）、“attached”（已连接）、“powered”（已供电）、“reconnecting”（正在重新连接）、“unauthenticated”（未认证）、“default”（默认）、“addressed”（已寻址）、“configured”（已配置）和“suspended”（已挂起）。此文件支持 poll()，以监控用户空间中的状态变化。

/sys/bus/usb/devices/.../<hub_interface>/port<X>/usb3_lpm_permit

在文件 sysfs-bus-usb 中定义。

一些 USB3.0 设备对 USB3 LPM 不太友好。 usb3_lpm_permit 属性允许启用/禁用端口的 USB3 LPM。它在 USB 设备枚举之前和之后都有效。支持的值为：如果 u1 和 u2 都不允许，则为“0”；如果仅允许 u1，则为“u1”；如果仅允许 u2，则为“u2”；如果 u1 和 u2 都允许，则为“u1_u2”。

/sys/bus/usb/devices/.../enable_compliance

定义在文件 sysfs-bus-usb-lvstest

写入此节点可将端口设置为合规模式，以便使用链路层验证设备进行测试。TD.7.34 需要此操作。

/sys/bus/usb/devices/.../get_dev_desc

定义在文件 sysfs-bus-usb-lvstest

写入此节点以发出“获取设备描述符”命令，用于链路层验证设备。TD.7.06 需要此操作。

/sys/bus/usb/devices/.../hot_reset

定义在文件 sysfs-bus-usb-lvstest

写入此节点以发出“重置”命令，用于链路层验证设备。TD.7.29、TD.7.31、TD.7.34 和 TD.7.35 需要此操作。

/sys/bus/usb/devices/.../ltm_capable

在文件 sysfs-bus-usb 中定义。

USB 3.0 设备可以选择性地支持延迟容忍消息 (LTM)。它们通过在 SuperSpeed BOS 描述符的 bmAttributes 字段中设置一位来指示它们的支持。如果为设备设置了该位，ltm_capable 将读取“yes”。如果设备不支持 LTM，该文件将读取“no”。该文件将存在于所有速度的 USB 设备中，并且对于 USB 1.1 和 USB 2.0 设备始终读取“no”。

/sys/bus/usb/devices/.../power/usb2_hardware_lpm

在文件 sysfs-bus-usb 中定义。

如果设置了 CONFIG_PM，并且将支持 LPM 的 USB 2.0 设备插入支持链路 PM 的 xHCI 主机，它将执行 LPM 测试；如果测试通过并且主机支持 USB2 硬件 LPM (xHCI 1.0 功能)，则将为设备启用 USB2 硬件 LPM，并且 USB 设备目录将包含一个名为 power/usb2_hardware_lpm 的文件。该文件保存一个字符串值（enable 或 disable），指示是否为设备启用了 USB2 硬件 LPM。开发人员可以向该文件写入 y/Y/1 或 n/N/0 以启用/禁用该功能。

/sys/bus/usb/devices/.../power/usb2_lpm_besl

在文件 sysfs-bus-usb 中定义。

支持硬件链路电源管理 (LPM) L1 休眠状态的 USB 2.0 设备现在使用尽力服务延迟值 (BESL) 来指示在启动恢复事件后尽力恢复对设备的服务。如果设备没有首选的 besl 值，则主机可以选择一个值。此 usb2_lpm_besl 属性允许调整主机选择的 besl 值，以便调整省电和服务延迟。

支持的值为 0 - 15。有关 besl 值如何映射到微秒的更多信息，请参阅 USB 2.0 ECN 链路电源管理勘误表，第 4.10 节）

/sys/bus/usb/devices/.../power/usb2_lpm_l1_timeout

在文件 sysfs-bus-usb 中定义。

USB 2.0 设备可能支持硬件链路电源管理 (LPM) L1 休眠状态。 usb2_lpm_l1_timeout 属性允许调整 L1 不活动计时器（LPM 计时器）的超时时间，例如，主机请求设备进入 L1 休眠状态之前所需的非活动时间。可用于电源管理调整。支持的值为 0 - 65535 微秒。

/sys/bus/usb/devices/.../power/usb3_hardware_lpm_u1

在文件 sysfs-bus-usb 中定义。

如果设置了 CONFIG_PM，并且将支持 LPM 的 USB 3.0 设备插入支持链路 PM 的 xHCI 主机，它将检查 BOS 描述符中是否设置了 U1 和 U2 的退出延迟；如果检查通过并且主机支持 USB3 硬件 LPM，则将为设备启用 USB3 硬件 LPM，并且 USB 设备目录将包含两个名为 power/usb3_hardware_lpm_u1 和 power/usb3_hardware_lpm_u2 的文件。这些文件保存一个字符串值（enable 或 disable），指示是否为设备启用了 USB3 硬件 LPM U1 或 U2。

/sys/bus/usb/devices/.../rx_lanes

在文件 sysfs-bus-usb 中定义。

设备正在使用的 rx 通道数。USB 3.2 添加了双通道支持，通过 Type-C 提供 2 个 rx 和 2 个 tx 通道。芯片间 SSIC 设备支持每个方向最多 4 个通道的不对称通道。USB 3.2 之前的设备是单通道（rx_lanes = 1）。

/sys/bus/usb/devices/.../tx_lanes

在文件 sysfs-bus-usb 中定义。

设备正在使用的 tx 通道数。USB 3.2 添加了双通道支持，通过 Type-C 提供 2 个 rx 和 2 个 tx 通道。芯片间 SSIC 设备支持每个方向最多 4 个通道的不对称通道。USB 3.2 之前的设备是单通道（tx_lanes = 1）。

/sys/bus/usb/devices/.../typec

在文件 sysfs-bus-usb 中定义。

指向 USB Type-C 伙伴设备的符号链接。USB Type-C 伙伴表示通过配置通道（USB Type-C 连接器和电缆上的 CC 信号）与本地端口通信的组件。

/sys/bus/usb/devices/.../u1_timeout

定义在文件 sysfs-bus-usb-lvstest

为连接链路层验证设备的下游端口设置“U1 超时”。超时值必须介于 0 和 127 之间。TD.7.18、TD.7.19、TD.7.20 和 TD.7.21 需要此操作。

/sys/bus/usb/devices/.../u2_timeout

定义在文件 sysfs-bus-usb-lvstest

为连接链路层验证设备的下游端口设置“U2 超时”。超时值必须介于 0 和 127 之间。TD.7.18、TD.7.19、TD.7.20 和 TD.7.21 需要此操作。

/sys/bus/usb/devices/.../u3_entry

定义在文件 sysfs-bus-usb-lvstest

写入此节点以发出“U3 进入”命令，用于链路层验证设备。TD.7.35 和 TD.7.36 需要此操作。

/sys/bus/usb/devices/.../u3_exit

定义在文件 sysfs-bus-usb-lvstest

写入此节点以发出“U3 退出”命令，用于链路层验证设备。TD.7.36 需要此操作。

/sys/bus/usb/devices/.../warm_reset

定义在文件 sysfs-bus-usb-lvstest

写入此节点以发出“暖重置”命令，用于链路层验证设备。如果需要显式启用合规模式，则可能需要此操作来正确重置 xHCI 1.1 主机端口。

/sys/bus/usb/devices/<INTERFACE>/authorized

在文件 sysfs-bus-usb 中定义。

这允许授权 (1) 或取消授权 (0) 单个接口，而不是像设备授权那样授权整个设备。如果取消授权的接口将被授权，则必须通过将 INTERFACE 写入 /sys/bus/usb/drivers_probe 来手动触发驱动程序探测。这允许避免需要多个接口的驱动程序的副作用。

未授权的接口无法探测或声明。

/sys/bus/usb/devices/<INTERFACE>/wireless_status

在文件 sysfs-bus-usb 中定义。

一些 USB 设备使用 USB 接收器适配器通过专有协议与其设备进行无线通信。此属性允许用户空间知道设备是否已连接到其接收器适配器，例如，在选择是否显示设备的电池、在输出列表中显示耳机或在仅无线键盘关闭时显示屏幕键盘时，考虑该设备不存在。此属性不应取代 WWAN、WLAN/Wi-Fi、蓝牙等中可用的特定于协议的状态。如果设备未使用带有无线设备的接收器适配器，则此属性将不存在。

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/country

/sys/class/bluetooth/hci<addr>/<hid-bus>:<vendor-id>:<product-id>.<num>/country

/sys/class/hidraw/hidraw<num>/device/country

定义在文件 sysfs-driver-hid

读取时，此文件以 ASCII 格式返回设备的 HID 国家/地区代码的十六进制整数值（例如，美国为 21）。此文件不可写入。

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/dragging

定义在文件 sysfs-driver-hid-lenovo

如果启用此设置，则可以通过按住轨迹点来执行拖动操作。这需要启用 press_to_select。

值为 0 或 1。

适用于带有轨迹点的 Thinkpad USB 键盘。

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/fb_update_rate

定义在文件 sysfs-driver-hid-picolcd

可以调整 defio 刷新率。

读取：返回可用刷新率的列表（以 Hz 表示），活动刷新率括在方括号（‘[’ 和 ‘]’）中

写入：接受在允许速率内的以整数 Hz 表示的新刷新率。

注意：由于设备每秒只能进行两次完整刷新，因此仅在更改一个或两个图块时调整此值才有意义，并且不应期望应用程序以高于默认速率显式刷新其微小的更改。

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/fn_lock

定义在文件 sysfs-driver-hid-lenovo

此设置控制键盘上是否启用了 Fn 锁定（即 F1 是否为静音或 F1）

值为 0 或 1

适用于带有轨迹点的 ThinkPad 紧凑型（USB|蓝牙）键盘。

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/kone/roccatkone<minor>/actual_dpi

定义在文件 sysfs-driver-hid-roccat-kone

可以通过按下一个按钮来切换鼠标的 dpi 设置。

读取时，此文件返回鼠标报告的实际 dpi 设置的原始数字。必须进一步处理此数字才能接收实际的 dpi 值

值

DPI

1

800

2

1200

3

1600

4

2000

5

2400

6

3200

此文件是只读的。

用户：http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/kone/roccatkone<minor>/actual_profile

定义在文件 sysfs-driver-hid-roccat-kone

读取时，此文件返回实际配置文件的编号。

此文件是只读的。

用户：http://roccat.sourceforge.net

/sys/bus/usb/devices/<总线号>-<设备号>:<配置号>.<接口号>/<hid总线>:<厂商ID>:<产品ID>.<编号>/kone/roccatkone<次要编号>/firmware_version

定义在文件 sysfs-driver-hid-roccat-kone

读取此文件时，将返回鼠标报告的固件原始整数版本号。使用整数值可以方便在其他程序中进一步使用。要获取实际的版本号，需要将小数点向左移动两位。例如，返回的值为 138 表示 1.38。

此文件是只读的。

用户：http://roccat.sourceforge.net

/sys/bus/usb/devices/<总线号>-<设备号>:<配置号>.<接口号>/<hid总线>:<厂商ID>:<产品ID>.<编号>/kone/roccatkone<次要编号>/profile[1-5]

定义在文件 sysfs-driver-hid-roccat-kone

鼠标可以存储 5 个配置文件，可以通过按按钮进行切换。配置文件保存着诸如按钮映射、灵敏度、5 个 LED 的颜色和灯光效果等信息。

读取这些文件时，将返回相应的配置文件。返回的数据大小为 975 字节。

写入此文件时，可以将相应的配置文件数据写回鼠标。数据长度必须为 975 字节。

鼠标将拒绝无效数据，而配置文件中存储的配置文件编号不需要与存储的编号匹配。

用户：http://roccat.sourceforge.net

/sys/bus/usb/devices/<总线号>-<设备号>:<配置号>.<接口号>/<hid总线>:<厂商ID>:<产品ID>.<编号>/kone/roccatkone<次要编号>/settings

定义在文件 sysfs-driver-hid-roccat-kone

读取此文件时，将返回存储在鼠标中的设置。数据大小为 36 字节，其中包含诸如 startup_profile、tcu 状态和 calibration_data 等信息。

写入此文件时，可以将设置写回鼠标。数据长度必须为 36 字节。鼠标将拒绝无效数据。

用户：http://roccat.sourceforge.net

/sys/bus/usb/devices/<总线号>-<设备号>:<配置号>.<接口号>/<hid总线>:<厂商ID>:<产品ID>.<编号>/kone/roccatkone<次要编号>/startup_profile

定义在文件 sysfs-driver-hid-roccat-kone

此属性的整数值范围为 1 到 5。

读取此属性时，将返回鼠标通电时激活的配置文件的编号。

写入此文件时，将设置启动配置文件的编号，并且鼠标会立即激活此配置文件。

用户：http://roccat.sourceforge.net

/sys/bus/usb/devices/<总线号>-<设备号>:<配置号>.<接口号>/<hid总线>:<厂商ID>:<产品ID>.<编号>/kone/roccatkone<次要编号>/tcu

定义在文件 sysfs-driver-hid-roccat-kone

鼠标具有“跟踪控制单元”，允许用户校准激光功率以适应鼠标垫表面。读取此文件时，将返回 TCU 的当前状态，其中 0 表示关闭，1 表示开启。

在此文件中写入 0 将关闭 TCU。

在此文件中写入 1 将启动校准，这大约需要 6 秒才能完成并激活 TCU。

用户：http://roccat.sourceforge.net

/sys/bus/usb/devices/<总线号>-<设备号>:<配置号>.<接口号>/<hid总线>:<厂商ID>:<产品ID>.<编号>/kone/roccatkone<次要编号>/weight

定义在文件 sysfs-driver-hid-roccat-kone

鼠标可以配备 5 到 20 克范围内的四种配重之一，鼠标可以识别这些配重，并且可以读取其值。读取此文件时，将返回鼠标返回的原始值，以便在其他软件中进行进一步处理。

这些值与配重的映射关系如下

值

配重

0

无

1

5g

2

10g

3

15g

4

20g

此文件是只读的。

用户：http://roccat.sourceforge.net

/sys/bus/usb/devices/<总线号>-<设备号>:<配置号>.<接口号>/<hid总线>:<厂商ID>:<产品ID>.<编号>/operation_mode

定义在文件 sysfs-driver-hid-picolcd

允许在 LCD（固件）和引导加载程序（刷机程序）操作模式之间切换 PicoLCD 设备。

读取：返回可用模式列表，活动模式用括号（'[' 和 ']'）括起来。

写入：导致操作模式切换。允许的值是读取时列出的非活动模式名称。

注意：切换模式时，当前的 PicoLCD HID 设备将断开连接，并在上述延迟后重新连接（有关其值，请参阅属性 operation_mode_delay）。

/sys/bus/usb/devices/<总线号>-<设备号>:<配置号>.<接口号>/<hid总线>:<厂商ID>:<产品ID>.<编号>/operation_mode_delay

定义在文件 sysfs-driver-hid-picolcd

当 operation_mode 更改时，PicoLCD 在新模式下重新启动之前等待的延迟。

读取/写入：以毫秒为单位表示，允许的范围是 0..30000 毫秒。

/sys/bus/usb/devices/<总线号>-<设备号>:<配置号>.<接口号>/<hid总线>:<厂商ID>:<产品ID>.<编号>/press_speed

定义在文件 sysfs-driver-hid-lenovo

此设置控制在启用 press_to_select 时，需要多快按下轨迹点才能生成鼠标单击。

值是十进制整数，从 1（最慢）到 255（最快）。

适用于带有轨迹点的 Thinkpad USB 键盘。

/sys/bus/usb/devices/<总线号>-<设备号>:<配置号>.<接口号>/<hid总线>:<厂商ID>:<产品ID>.<编号>/press_to_select

定义在文件 sysfs-driver-hid-lenovo

这控制是否在快速按下轨迹点时生成鼠标单击。此按下的速度由 press_speed 控制。

值为 0 或 1。

适用于带有轨迹点的 Thinkpad USB 键盘。

/sys/bus/usb/devices/<总线号>-<设备号>:<配置号>.<接口号>/<hid总线>:<厂商ID>:<产品ID>.<编号>/quirks

在文件 sysfs-driver-hid-multitouch 中定义

此属性的整数值对应于实际用于处理设备协议的怪癖。读取此属性时，将返回当前设置（请参阅 hid-multitouch.c 中的 MT_QUIRKS_*）。写入此属性会动态更改怪癖，然后更改处理设备的协议。

/sys/bus/usb/devices/<总线号>-<设备号>:<配置号>.<接口号>/<hid总线>:<厂商ID>:<产品ID>.<编号>/release_to_select

定义在文件 sysfs-driver-hid-lenovo

有关此设置的详细信息，请参阅 http://www.pc.ibm.com/ww/healthycomputing/trkpntb.html。值为 0 或 1。适用于带有轨迹点的 Thinkpad USB 键盘。

/sys/bus/usb/devices/<总线号>-<设备号>:<配置号>.<接口号>/<hid总线>:<厂商ID>:<产品ID>.<编号>/report_descriptor

/sys/class/bluetooth/hci<地址>/<hid总线>:<厂商ID>:<产品ID>.<编号>/report_descriptor

/sys/class/hidraw/hidraw<编号>/device/report_descriptor

定义在文件 sysfs-driver-hid

读取此文件时，将返回设备的原始二进制 HID 报告描述符。此文件不可写入。

用户：HIDAPI 库 (http://www.signal11.us/oss/hidapi)

/sys/bus/usb/devices/<总线号>-<设备号>:<配置号>.<接口号>/<hid总线>:<厂商ID>:<产品ID>.<编号>/select_right

定义在文件 sysfs-driver-hid-lenovo

此设置控制通过按下轨迹点（如果启用了 press_to_select）生成的鼠标单击事件是生成鼠标左键单击还是鼠标右键单击。

值为 0 或 1。

适用于带有轨迹点的 Thinkpad USB 键盘。

/sys/bus/usb/devices/<总线号>-<设备号>:<配置号>.<接口号>/<hid总线>:<厂商ID>:<产品ID>.<编号>/sensitivity

定义在文件 sysfs-driver-hid-lenovo

此文件包含轨迹点灵敏度。值是十进制整数，从 1（最低灵敏度）到 255（最高灵敏度）。适用于带有轨迹点的 Thinkpad USB 键盘。

/sys/bus/usb/devices/usbX/avoid_reset_quirk

在文件 sysfs-bus-usb 中定义。

大多数设备的此值都设置为零。

如果值为 1，则启用 USB 怪癖，以防止此设备使用重置。

（读取/写入）

/sys/bus/usb/devices/usbX/bAlternateSetting

在文件 sysfs-bus-usb 中定义。

当前的接口备用设置号，以十进制表示。

请参阅 USB 规范了解其含义。

/sys/bus/usb/devices/usbX/bConfigurationValue

在文件 sysfs-bus-usb 中定义。

虽然 USB 设备通常只有一个配置设置，但某些设备支持多个配置。

此值以十进制表示当前配置。

更改其值会将设备的配置更改为另一个设置。

设备支持的配置数量位于

请参阅 USB 规范了解其含义。

/sys/bus/usb/devices/usbX/bDeviceClass

在文件 sysfs-bus-usb 中定义。

设备的类代码，以十六进制表示。

请参阅 USB 规范了解其含义。

/sys/bus/usb/devices/usbX/bDeviceProtocol

在文件 sysfs-bus-usb 中定义。

设备的协议代码，以十六进制表示。

请参阅 USB 规范了解其含义。

/sys/bus/usb/devices/usbX/bDeviceSubClass

在文件 sysfs-bus-usb 中定义。

设备的子类代码，以十六进制表示。

请参阅 USB 规范了解其含义。

/sys/bus/usb/devices/usbX/bInterfaceClass

在文件 sysfs-bus-usb 中定义。

接口的类代码，以十六进制表示。

请参阅 USB 规范了解其含义。

/sys/bus/usb/devices/usbX/bInterfaceNumber

在文件 sysfs-bus-usb 中定义。

接口号，以十六进制表示。

请参阅 USB 规范了解其含义。

/sys/bus/usb/devices/usbX/bInterfaceProtocol

在文件 sysfs-bus-usb 中定义。

接口的协议代码，以十六进制表示。

请参阅 USB 规范了解其含义。

/sys/bus/usb/devices/usbX/bInterfaceSubClass

在文件 sysfs-bus-usb 中定义。

接口的子类代码，以十六进制表示。

请参阅 USB 规范了解其含义。

/sys/bus/usb/devices/usbX/bMaxPacketSize0

在文件 sysfs-bus-usb 中定义。

最大端点 0 数据包大小，以十进制表示。

请参阅 USB 规范了解其含义。

/sys/bus/usb/devices/usbX/bMaxPower

在文件 sysfs-bus-usb 中定义。

设备活动配置的最大功耗，以毫安为单位。

/sys/bus/usb/devices/usbX/bNumConfigurations

在文件 sysfs-bus-usb 中定义。

设备可能配置的数量，以十进制表示。当前配置通过以下路径控制

请参阅 USB 规范了解其含义。

/sys/bus/usb/devices/usbX/bNumEndpoints

在文件 sysfs-bus-usb 中定义。

此接口上使用的端点数量，以十六进制表示。

请参阅 USB 规范了解其含义。

/sys/bus/usb/devices/usbX/bNumInterfaces

在文件 sysfs-bus-usb 中定义。

此设备上的接口数量，以十进制表示。

/sys/bus/usb/devices/usbX/bcdDevice

在文件 sysfs-bus-usb 中定义。

设备的发布号，以十六进制表示。

请参阅 USB 规范了解其含义。

/sys/bus/usb/devices/usbX/bmAttributes

在文件 sysfs-bus-usb 中定义。

当前配置的属性，以十六进制表示。

请参阅 USB 规范了解其含义。

/sys/bus/usb/devices/usbX/bos_descriptors

在文件 sysfs-bus-usb 中定义。

包含设备的缓存二进制设备对象存储 (BOS) 的二进制文件。这包括 BOS 描述符以及一组设备功能描述符。从此文件中读取的所有描述符都采用总线字节序格式。请注意，如果设备的 bcdUSB 小于 0x0201，则内核不会从设备请求 BOS。

/sys/bus/usb/devices/usbX/busnum

在文件 sysfs-bus-usb 中定义。

总线的编号。

/sys/bus/usb/devices/usbX/configuration

在文件 sysfs-bus-usb 中定义。

与当前配置关联的字符串描述符的内容。它可能包括设备的固件版本和/或序列号。

/sys/bus/usb/devices/usbX/descriptors

在文件 sysfs-bus-usb 中定义。

包含接口描述符，以二进制形式表示。

/sys/bus/usb/devices/usbX/devnum

在文件 sysfs-bus-usb 中定义。

USB 接口设备编号，以十进制表示。

/sys/bus/usb/devices/usbX/devpath

在文件 sysfs-bus-usb 中定义。

包含 USB 接口设备路径的字符串。

/sys/bus/usb/devices/usbX/devspec

在文件 sysfs-bus-usb 中定义。

显示接口的设备树开放固件节点。

/sys/bus/usb/devices/usbX/ep_<N>/bEndpointAddress

在文件 sysfs-bus-usb 中定义。

此描述符描述的端点的地址，以十六进制表示。此位图字段上的端点方向也显示在

请参阅 USB 规范了解其含义。

/sys/bus/usb/devices/usbX/ep_<N>/bInterval

在文件 sysfs-bus-usb 中定义。

端点的间隔，如其描述符中所述，以十六进制表示。实际间隔取决于 USB 的版本。在时间单位中也显示在 /sys/bus/usb/devices/usbX/ep_<N>/interval 中。

/sys/bus/usb/devices/usbX/ep_<N>/bLength

在文件 sysfs-bus-usb 中定义。

端点描述符的字节数，以十六进制表示。

/sys/bus/usb/devices/usbX/ep_<N>/bmAttributes

在文件 sysfs-bus-usb 中定义。

适用于端点的属性，如其描述符中所述，以十六进制表示。此位图字段上的端点类型也显示在

请参阅 USB 规范了解其含义。

/sys/bus/usb/devices/usbX/ep_<N>/direction

在文件 sysfs-bus-usb 中定义。

端点的方向。可以是

  • 两者（在控制端点上）

  • 输入

  • 输出

/sys/bus/usb/devices/usbX/ep_<N>/interval

在文件 sysfs-bus-usb 中定义。

用于轮询端点以进行数据传输的间隔，以毫秒或微秒为单位。

/sys/bus/usb/devices/usbX/ep_<N>/type

在文件 sysfs-bus-usb 中定义。

描述符类型。可以是

  • 控制

  • 同步

  • 批量

  • 中断

  • 未知

/sys/bus/usb/devices/usbX/ep_<N>/wMaxPacketSize

在文件 sysfs-bus-usb 中定义。

此端点能够发送或接收的最大数据包大小，以十六进制表示。

/sys/bus/usb/devices/usbX/idProduct

在文件 sysfs-bus-usb 中定义。

产品 ID，以十六进制表示。

/sys/bus/usb/devices/usbX/idVendor

在文件 sysfs-bus-usb 中定义。

厂商 ID，以十六进制表示。

/sys/bus/usb/devices/usbX/interface_authorized_default

在文件 sysfs-bus-usb 中定义。

这用作确定默认情况下是否授权接口的值。该值可以是 1 或 0。默认为 1。

/sys/bus/usb/devices/usbX/manufacturer

在文件 sysfs-bus-usb 中定义。

包含设备制造商名称的厂商特定字符串。

/sys/bus/usb/devices/usbX/maxchild

在文件 sysfs-bus-usb 中定义。

USB 集线器的端口数量。

/sys/bus/usb/devices/usbX/persist

在文件 sysfs-bus-usb 中定义。

即使设备断开连接也保持设备存在。

/sys/bus/usb/devices/usbX/power/active_duration

在文件 sysfs-bus-usb 中定义。

设备未被挂起的总时间。

/sys/bus/usb/devices/usbX/power/autosuspend

在文件 sysfs-bus-usb 中定义。

设备自动挂起的时间，单位为毫秒。如果值为负，则禁止自动挂起。

（读取/写入）

/sys/bus/usb/devices/usbX/power/connected_duration

在文件 sysfs-bus-usb 中定义。

设备已连接的总时间（以毫秒为单位）。

/sys/bus/usb/devices/usbX/power/level

在文件 sysfs-bus-usb 中定义。

/sys/bus/usb/devices/usbX/power/level 的描述缺失。

/sys/bus/usb/devices/usbX/product

在文件 sysfs-bus-usb 中定义。

包含设备产品名称的厂商特定字符串。

/sys/bus/usb/devices/usbX/speed

在文件 sysfs-bus-usb 中定义。

根据 USB 版本显示设备的最大速度，单位为 Mbps。可以是：

未知

速度未知

1.5

低速

15

全速

480

高速

5000

超高速

10000

超高速+

20000

超高速+ Gen 2x2

/sys/bus/usb/devices/usbX/supports_autosuspend

在文件 sysfs-bus-usb 中定义。

如果设备不支持自动挂起，则返回 1。否则，返回 0。

/sys/bus/usb/devices/usbX/urbnum

在文件 sysfs-bus-usb 中定义。

为整个设备提交的 URB 数量。

/sys/bus/usb/devices/usbX/version

在文件 sysfs-bus-usb 中定义。

包含 USB 设备版本的字符串，如 BCD 描述符中编码的那样。

/sys/bus/usb/drivers/.../new_id

在文件 sysfs-bus-usb 中定义。

将设备 ID 写入此文件将尝试动态地向 USB 设备驱动程序添加新的设备 ID。这可能允许驱动程序支持比编译时驱动程序的静态设备 ID 支持表中包含的更多的硬件。设备 ID 的格式为：idVendor idProduct bInterfaceClass RefIdVendor RefIdProduct。vendor ID 和 device ID 字段是必需的，其余是可选的。Ref* 元组可用于告诉驱动程序，对于新设备使用与参考设备相同的 driver_data。成功添加 ID 后，驱动程序将探测设备并尝试绑定到它。例如

# echo "8086 10f5" > /sys/bus/usb/drivers/foo/new_id

此处添加新设备 (0458:7045)，使用来自已支持设备 (0458:704c) 的 driver_data。

# echo "0458 7045 0 0458 704c" > /sys/bus/usb/drivers/foo/new_id

从此文件读取将以相同的格式列出所有动态添加的设备 ID，每行一个条目。例如

# cat /sys/bus/usb/drivers/foo/new_id
8086 10f5
dead beef 06
f00d cafe

由于 sysfs 限制，列表将在 PAGE_SIZE 字节处被截断。

/sys/bus/usb/drivers/.../remove_id

在文件 sysfs-bus-usb 中定义。

将设备 ID 写入此文件将删除通过 new_id sysfs 条目动态添加的 ID。设备 ID 的格式为：idVendor idProduct。成功删除 ID 后，驱动程序将不再支持该设备。这对于确保自动探测不会将驱动程序与设备匹配很有用。例如：# echo “046d c315” > /sys/bus/usb/drivers/foo/remove_id

从此文件读取将列出动态添加的设备 ID，与从条目“/sys/bus/usb/drivers/.../new_id”读取完全相同。

/sys/bus/vdpa/devices/.../driver_override

在文件 sysfs-bus-vdpa 中定义。

此文件允许指定设备的驱动程序。指定后，只有名称与写入 driver_override 的值匹配的驱动程序才有机会绑定到该设备。覆盖是通过将字符串写入 driver_override 文件（echo vhost-vdpa > driver_override）指定的，并且可以使用空字符串清除（echo > driver_override）。这会将设备返回到标准匹配规则绑定。写入 driver_override 不会自动将设备从其当前驱动程序取消绑定，也不会尝试自动加载指定的驱动程序。如果内核中当前没有加载名称匹配的驱动程序，则该设备将不绑定到任何驱动程序。这还允许设备使用诸如“none”之类的 driver_override 名称来选择退出驱动程序绑定。覆盖中只能指定单个驱动程序，不支持解析分隔符。

/sys/bus/vdpa/driver_probe

在文件 sysfs-bus-vdpa 中定义。

将设备名称写入此文件将导致内核将设备绑定到兼容的驱动程序。

当 /sys/bus/vdpa/drivers_autoprobe 被禁用时，这会很有用。

/sys/bus/vdpa/drivers/.../bind

在文件 sysfs-bus-vdpa 中定义。

将设备名称写入此文件将导致驱动程序尝试绑定到该设备。这对于覆盖默认绑定很有用。

/sys/bus/vdpa/drivers/.../unbind

在文件 sysfs-bus-vdpa 中定义。

将设备名称写入此文件将导致驱动程序尝试从设备取消绑定。这在覆盖默认绑定时可能很有用。

/sys/bus/vdpa/drivers_autoprobe

在文件 sysfs-bus-vdpa 中定义。

此文件确定新设备在创建后是否立即绑定到驱动程序。它最初包含 1，这意味着内核在创建设备后立即将设备自动绑定到兼容的驱动程序。

将“0”写入此文件将禁用此功能，任何其他字符串都将启用它。

/sys/bus/vmbus/devices/.../driver_override

在文件 sysfs-bus-vmbus 中定义。

此文件允许指定设备的驱动程序，该驱动程序将覆盖标准的静态和动态 ID 匹配。指定后，只有名称与写入 driver_override 的值匹配的驱动程序才有机会绑定到该设备。覆盖是通过将字符串写入 driver_override 文件（echo uio_hv_generic > driver_override）指定的，并且可以使用空字符串清除（echo > driver_override）。这会将设备返回到标准匹配规则绑定。写入 driver_override 不会自动将设备从其当前驱动程序取消绑定，也不会尝试自动加载指定的驱动程序。如果内核中当前没有加载名称匹配的驱动程序，则该设备将不绑定到任何驱动程序。这还允许设备使用诸如“none”之类的 driver_override 名称来选择退出驱动程序绑定。覆盖中只能指定单个驱动程序，不支持解析分隔符。

/sys/bus/w1/devices/.../alarms

在文件 sysfs-driver-w1_therm 中定义。

（读写）读取或写入 TH 和 TL（高温和低温）警报。值应以空格分隔，并且在设备范围内（典型值 -55 degC 到 125 degC），如果不在范围内，则值将被修剪到设备最小/最大功能。这些值是整数，因为它们存储在设备中的 8 位寄存器中。最低值将自动设置为 TL。设置后，可以在主级别搜索警报，有关详细信息，请参阅 1-wire (w1) 子系统简介

用户：任何想要与 w1_term 设备通信的用户空间应用程序

/sys/bus/w1/devices/.../conv_time

在文件 sysfs-driver-w1_therm 中定义。

（读写）获取、设置或测量温度转换时间。设置将保持活动状态，直到分辨率更改。然后，它将重置为新分辨率的默认（数据表）转换时间。

读取:

实际转换时间（以毫秒为单位）。

写入:
  • ‘0’

    从数据表设置默认转换时间。

  • ‘1’

    测量并设置转换时间。进行一次温度转换，测量实际值。对于温度范围，将其增加 20%。可以通过读取相同的属性来获得新的转换时间。

  • 其他正值

    以毫秒为单位设置转换时间。

用户：使用 w1_term 设备的应用程序

/sys/bus/w1/devices/.../eeprom_cmd

在文件 sysfs-driver-w1_therm 中定义。

（只写）写入该文件将触发设备数据保存到其嵌入式 EEPROM，或恢复嵌入设备 EEPROM 中的数据。请注意，设备支持有限的 EEPROM 写入周期（典型值为 50k）

  • ‘save’：将设备 RAM 保存到 EEPROM

  • ‘restore’：将 EEPROM 数据恢复到设备 RAM 中

用户：任何想要与 w1_term 设备通信的用户空间应用程序

/sys/bus/w1/devices/.../ext_power

在文件 sysfs-driver-w1_therm 中定义。

（只读）通过询问设备返回电源状态

  • ‘0’：设备寄生供电

  • ‘1’：设备外部供电

  • ‘-xx’：xx 是读取电源状态时的内核错误

用户：任何想要与 w1_term 设备通信的用户空间应用程序

/sys/bus/w1/devices/.../features

在文件 sysfs-driver-w1_therm 中定义。

（读写）控制可选的驱动程序设置。读取/写入（按位或）的位掩码

1

启用对转换成功情况的检查。如果转换后暂存存储器的第 6 个字节为 0xC，并且温度读取值为 85.00（上电值）或 127.94（功率不足）- 返回转换错误。

2

启用轮询以完成转换。在转换开始后生成读取周期并等待 1。在寄生电源模式下，此功能不可用。
读取:

当前选定的功能。

写入:

选择功能。

用户：使用 w1_term 设备的应用程序

/sys/bus/w1/devices/.../resolution

在文件 sysfs-driver-w1_therm 中定义。

（读写）获取或设置设备分辨率（在受支持的设备上，否则，此条目不存在）。请注意，分辨率仅在设备 RAM 中更改，因此断电后将被清除。触发“save”到 EEPROM 命令以在开机后保留值。读取或写入的是

  • ‘9..14’：以位为单位的设备分辨率或以位为单位设置的分辨率

  • ‘-xx’：xx 是读取分辨率时的内核错误

  • 其他任何内容：不执行任何操作

某些 DS18B20 克隆固定为 12 位分辨率，因此从芯片读取并验证实际分辨率。如果结果不同，则会报告错误。

用户：任何想要与 w1_term 设备通信的用户空间应用程序

/sys/bus/w1/devices/.../temperature

在文件 sysfs-driver-w1_therm 中定义。

（只读）以 1/1000 degC 为单位返回温度。

  • 如果已触发批量读取，它将直接返回批量读取发生时计算出的温度（如果可用）。如果尚不可用，则不返回任何内容（发送调试内核消息），您应该稍后重试。

  • 如果未触发批量读取，它将触发转换并发送结果。请注意，转换持续时间取决于分辨率（如果设备支持此功能）。在 9 位分辨率下需要 94 毫秒，在 12 位分辨率下需要 750 毫秒。

用户：任何想要与 w1_term 设备通信的用户空间应用程序

/sys/bus/w1/devices/.../w1_slave

在文件 sysfs-driver-w1_therm 中定义。

（读写）以 1/1000 degC 为单位返回温度。读取：返回在总线上发送的十六进制输出数据的 2 行，返回 CRC 校验和以 1/1000 degC 为单位的温度 写入

  • ‘0’：将 2 或 3 个字节保存到设备 EEPROM（即 TH、TL 和配置寄存器）

  • ‘9..14’：在 RAM 中设置设备分辨率（如果受支持）

  • 其他任何内容：不执行任何操作

有关详细信息，请参阅 内核驱动程序 w1_therm。

用户：任何想要与 w1_term 设备通信的用户空间应用程序

/sys/bus/w1/devices/19-<id>/speed

在文件 sysfs-driver-w1_ds28e17 中定义。

写入时，此文件会在连接的 DS28E17 芯片上设置 I2C 速度。读取时，它会从 DS28E17 芯片读取当前设置。

有效值：100、400、900 [kBaud]。

默认值为 100，可以通过 w1_ds28e17.speed= 模块参数进行设置。

用户：w1_ds28e17 驱动程序

/sys/bus/w1/devices/19-<id>/stretch

在文件 sysfs-driver-w1_ds28e17 中定义。

写入此文件时，会设置用于计算连接的 DS28E17 芯片上 I2C 操作的忙超时时间的乘数。读取时，会返回当前设置。有效值：1 到 9。

默认值为 1，可以通过 w1_ds28e17.stretch= 模块参数进行设置。

用户：w1_ds28e17 驱动程序

/sys/bus/w1/devices/w1_bus_masterXX/therm_bulk_read

在文件 sysfs-driver-w1_therm 中定义。

(读写) 触发批量读取转换。读取状态

读取:
  • ‘-1’

    至少 1 个传感器正在进行转换

  • ‘1’

    转换已完成，但至少一个传感器值尚未被读取

  • ‘0’

    无批量操作。读取温度将触发每个设备上的转换

写入:

‘trigger’：触发总线上所有支持设备上的批量读取

请注意，如果发送了批量读取但没有立即读取一个传感器，则下次访问此设备的温度时将返回在发出批量读取命令时测量的温度（而不是当前温度）。

用户：任何想要与 w1_term 设备通信的用户空间应用程序

/sys/bus/wmi/devices/.../driver_override

在文件 sysfs-bus-wmi 中定义

此文件允许指定设备的驱动程序，这将覆盖标准的 ID 表匹配。指定后，只有名称与写入 driver_override 的值匹配的驱动程序才有机会绑定到该设备。通过将字符串写入 driver_override 文件来指定覆盖（例如，echo wmi-event-dummy > driver_override）。可以使用空字符串清除覆盖（例如，echo > driver_override），这将使设备返回到标准的匹配规则绑定。写入 driver_override 不会自动取消设备与其当前驱动程序的绑定，也不会尝试自动加载指定的驱动程序。如果内核中当前没有加载名称匹配的驱动程序，则该设备将不绑定到任何驱动程序。这也允许设备使用诸如“none”之类的 driver_override 名称选择退出驱动程序绑定。覆盖中只能指定单个驱动程序，不支持解析分隔符。

/sys/bus/wmi/devices/.../expensive

在文件 sysfs-bus-wmi 中定义

此文件包含一个布尔标志，指示与给定的 WMI 设备交互是否会消耗大量的 CPU 资源。WMI 驱动程序核心将负责启用/禁用此类 WMI 设备。

/sys/bus/wmi/devices/.../guid

在文件 sysfs-bus-wmi 中定义

此文件包含用于将 WMI 设备与兼容的 WMI 驱动程序匹配的 GUID。此 GUID 在给定的机器内不一定是唯一的，它仅用于标识给定 WMI 设备公开的接口。

/sys/bus/wmi/devices/.../instance_count

在文件 sysfs-bus-wmi 中定义

此文件包含给定 WMI 设备上存在的 WMI 对象实例的数量。它包含一个非负数。

/sys/bus/wmi/devices/.../modalias

在文件 sysfs-bus-wmi 中定义

此文件包含 uevent 为给定的 WMI 设备发出的 MODALIAS 值。

格式：wmi:XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX。

/sys/bus/wmi/devices/.../notify_id

在文件 sysfs-bus-wmi 中定义

此文件包含内部用于将 ACPI 事件映射到 WMI 事件设备的 WMI 通知 ID。它包含两个 ASCII 字母。

/sys/bus/wmi/devices/.../object_id

在文件 sysfs-bus-wmi 中定义

此文件包含内部用于构造非事件 WMI 设备使用的 ACPI 方法名称的 WMI 对象 ID。它包含两个 ASCII 字母。

/sys/bus/wmi/devices/.../setable

在文件 sysfs-bus-wmi 中定义

此文件包含一个布尔标志，指示与给定的 WMI 设备关联的数据块是否可写。如果给定的 WMI 设备未与数据块关联，则此文件将不存在。

/sys/bus/wmi/devices/44FADEB1-B204-40F2-8581-394BBDC1B651/firmware_update_request

在文件 sysfs-platform-intel-wmi-sbl-fw-update 中定义

允许用户空间实体触发 Slim Bootloader (SBL) 的更新。此属性通常的值为 0，用户空间可以通过写入值 1 来通知 SBL 在下次重新启动时更新固件。 有两种可用状态

  • 0 -> 重新启动时跳过固件更新

  • 1 -> 在下次重新启动时尝试固件更新

/sys/bus/wmi/devices/6932965F-1671-4CEB-B988-D3AB0A901919/dell_privacy_current_state

在文件 sysfs-platform-dell-privacy-wmi 中定义

允许用户空间检查当前戴尔隐私设备状态。描述了 BIOS 公开的设备状态类，各种对了解隐私功能感兴趣的应用程序可以使用该状态类

属性
麦克风

标识本地麦克风可以通过硬件静音，没有应用程序可以捕获系统麦克风的声音

摄像头快门

标识由硬件控制的摄像头快门，这是一种构建在摄像头模块上的微机械快门组件，用于阻止从笔记本电脑外部捕获图像

值
已静音

标识隐私设备已关闭，无法向操作系统应用程序发送流

未静音

标识隐私设备已打开，音频或摄像头驱动程序可以从麦克风和摄像头模块获取流到操作系统应用程序

例如，要检查所有支持的当前隐私设备状态

# cat /sys/bus/wmi/drivers/dell-privacy/6932965F-1671-4CEB-B988-D3AB0A901919/dell_privacy_current_state
[Microphone] [unmuted]
[Camera Shutter] [unmuted]

/sys/bus/wmi/devices/6932965F-1671-4CEB-B988-D3AB0A901919/dell_privacy_supported_type

在文件 sysfs-platform-dell-privacy-wmi 中定义

显示支持哪些戴尔硬件级别的隐私设备。“戴尔隐私”是一组硬件、固件和软件功能，旨在加强戴尔对 MIC、摄像头和电子隐私屏幕的平台隐私的承诺。支持的硬件隐私设备是

属性
麦克风静音

标识本地麦克风可以通过硬件静音，没有应用程序可以捕获系统麦克风的声音

摄像头快门

标识由硬件控制的摄像头快门，这是一种构建在摄像头模块上的微机械快门组件，用于阻止从笔记本电脑外部捕获图像

值

支持

此系统支持该隐私设备

不支持

此系统不支持该隐私设备

例如，要检查支持哪些隐私设备

# cat /sys/bus/wmi/drivers/dell-privacy/6932965F-1671-4CEB-B988-D3AB0A901919/dell_privacy_supported_type
[Microphone Mute] [supported]
[Camera Shutter] [supported]
[ePrivacy Screen] [unsupported]

/sys/class 下的符号

/sys/class/

在文件 sysfs-class 中定义

/sys/class 目录将由一组子目录组成，这些子目录描述内核中各个类别的设备。各个目录将由子目录或指向其他目录的符号链接组成。

所有使用此目录树的程序都必须能够处理子目录或符号链接，以便正常工作。

用户

udev <linux-hotplug-devel@lists.sourceforge.net>

/sys/class/accel/accel<n>/device/armcp_kernel_ver

在文件 sysfs-driver-habanalabs 中定义

设备 CPU 上运行的 Linux 内核版本。将在 Linux 内核版本 5.10 中弃用，并替换为 cpucp_kernel_ver

/sys/class/accel/accel<n>/device/armcp_ver

在文件 sysfs-driver-habanalabs 中定义

设备 CPU 上运行的应用程序的版本。将在 Linux 内核版本 5.10 中弃用，并替换为 cpucp_ver

/sys/class/accel/accel<n>/device/clk_cur_freq_mhz

在文件 sysfs-driver-habanalabs 中定义

显示设备时钟的当前频率，以 MHz 为单位。此属性仅对 Gaudi ASIC 系列有效

/sys/class/accel/accel<n>/device/clk_max_freq_mhz

在文件 sysfs-driver-habanalabs 中定义

允许用户设置最大时钟频率，以 MHz 为单位。设备时钟可能会设置为低于最大值的值。用户应读取 clk_cur_freq_mhz 以查看设备时钟的实际频率值。此属性仅对 Gaudi ASIC 系列有效

/sys/class/accel/accel<n>/device/cpld_ver

在文件 sysfs-driver-habanalabs 中定义

设备 CPLD F/W 的版本

/sys/class/accel/accel<n>/device/cpucp_kernel_ver

在文件 sysfs-driver-habanalabs 中定义

设备 CPU 上运行的 Linux 内核版本

/sys/class/accel/accel<n>/device/cpucp_ver

在文件 sysfs-driver-habanalabs 中定义

设备 CPU 上运行的应用程序的版本

/sys/class/accel/accel<n>/device/device_type

在文件 sysfs-driver-habanalabs 中定义

根据设备的类型显示设备的代号。支持的值为：“GOYA”

/sys/class/accel/accel<n>/device/eeprom

在文件 sysfs-driver-habanalabs 中定义

一个二进制文件属性，包含板载 EEPROM 的内容

/sys/class/accel/accel<n>/device/fuse_ver

在文件 sysfs-driver-habanalabs 中定义

从 eFuse 显示设备的版本

/sys/class/accel/accel<n>/device/fw_os_ver

在文件 sysfs-driver-habanalabs 中定义

设备 CPU 上运行的固件操作系统版本

/sys/class/accel/accel<n>/device/hard_reset

在文件 sysfs-driver-habanalabs 中定义

用于触发设备硬重置操作的接口。硬重置将重置设备的所有内部组件，除了 PCI 接口和内部 PLL

/sys/class/accel/accel<n>/device/hard_reset_cnt

在文件 sysfs-driver-habanalabs 中定义

显示自驱动程序加载以来设备经历了多少次硬重置操作

/sys/class/accel/accel<n>/device/high_pll

在文件 sysfs-driver-habanalabs 中定义

允许用户在电源管理配置文件设置为“自动”时，为 MME、TPC 和 IC 设置最大时钟频率。此属性仅对 Goya ASIC 系列有效

/sys/class/accel/accel<n>/device/ic_clk

在文件 sysfs-driver-habanalabs 中定义

允许用户设置互连结构的最高时钟频率，以 Hz 为单位。仅当电源管理配置文件设置为“手动”模式时，对此参数的写入才会影响设备。设备 IC 时钟可能会设置为低于最大值的值。用户应读取 ic_clk_curr 以查看 IC 的实际频率值。此属性仅对 Goya ASIC 系列有效

/sys/class/accel/accel<n>/device/ic_clk_curr

在文件 sysfs-driver-habanalabs 中定义

显示互连结构的当前时钟频率，以 Hz 为单位。此属性仅对 Goya ASIC 系列有效

/sys/class/accel/accel<n>/device/infineon_ver

在文件 sysfs-driver-habanalabs 中定义

设备电源 F/W 代码的版本。仅与 GOYA 和 GAUDI 相关

/sys/class/accel/accel<n>/device/max_power

在文件 sysfs-driver-habanalabs 中定义

允许用户设置设备的最大功耗，以毫瓦为单位。

/sys/class/accel/accel<n>/device/mme_clk

在文件 sysfs-driver-habanalabs 中定义

允许用户设置 MME 计算引擎的最大时钟频率，以 Hz 为单位。仅当电源管理配置文件设置为“手动”模式时，对此参数的写入才会影响设备。设备 MME 时钟可能会设置为低于最大值的值。用户应读取 mme_clk_curr 以查看 MME 的实际频率值。此属性仅对 Goya ASIC 系列有效

/sys/class/accel/accel<n>/device/mme_clk_curr

在文件 sysfs-driver-habanalabs 中定义

显示 MME 计算引擎的当前时钟频率，以 Hz 为单位。此属性仅对 Goya ASIC 系列有效

/sys/class/accel/accel<n>/device/module_id

在文件 sysfs-driver-habanalabs 中定义

显示设备的模块 ID

/sys/class/accel/accel<n>/device/parent_device

在文件 sysfs-driver-habanalabs 中定义

显示 accel 设备的父设备的名称

/sys/class/accel/accel<n>/device/pci_addr

在文件 sysfs-driver-habanalabs 中定义

显示设备的 PCI 地址。这是必需的，以便用户能够根据其 PCI 地址打开设备

/sys/class/accel/accel<n>/device/pm_mng_profile

在文件 sysfs-driver-habanalabs 中定义

电源管理配置文件。值为“auto”、“manual”。在“auto”模式下，当用户空间进程打开设备文件时，驱动程序会将最大时钟频率设置为高值（除非它已经被另一个进程打开）。当没有用户进程在设备文件上打开时，驱动程序会将最大时钟频率设置为低值。在“manual”模式下，用户通过写入 ic_clk、mme_clk 和 tpc_clk 来设置最大时钟频率。此属性仅对 Goya ASIC 系列有效

/sys/class/accel/accel<n>/device/preboot_btl_ver

在文件 sysfs-driver-habanalabs 中定义

设备的预引导 F/W 代码版本

/sys/class/accel/accel<n>/device/security_enabled

在文件 sysfs-driver-habanalabs 中定义

显示设备的安全状态

/sys/class/accel/accel<n>/device/soft_reset

在文件 sysfs-driver-habanalabs 中定义

用于触发设备软重置操作的接口。软重置只会重置设备的计算和 DMA 引擎

/sys/class/accel/accel<n>/device/soft_reset_cnt

在文件 sysfs-driver-habanalabs 中定义

显示自驱动程序加载以来设备经历了多少次软重置操作

/sys/class/accel/accel<n>/device/status

在文件 sysfs-driver-habanalabs 中定义

卡的状态

  • “operational” - 设备可用于工作。

  • “in reset” - 设备正在经历重置，很快就可以使用。

  • “disabled” - 设备不可用。

  • “needs reset” - 在启动硬重置之前，设备不可用。

  • “in device creation” - 设备尚不可用，因为它仍在初始化。

  • “in reset after device release” - 设备正在经历设备释放后执行的计算重置（仅与 Gaudi2 相关）。

/sys/class/accel/accel<n>/device/thermal_ver

在文件 sysfs-driver-habanalabs 中定义

设备的热守护进程版本

/sys/class/accel/accel<n>/device/tpc_clk

在文件 sysfs-driver-habanalabs 中定义

允许用户设置 TPC 计算引擎的最大时钟频率，以 Hz 为单位。仅当电源管理配置文件设置为“手动”模式时，对此参数的写入才会影响设备。设备 TPC 时钟可能会设置为低于最大值的值。用户应读取 tpc_clk_curr 以查看 TPC 的实际频率值。此属性仅对 Goya ASIC 系列有效

/sys/class/accel/accel<n>/device/tpc_clk_curr

在文件 sysfs-driver-habanalabs 中定义

显示 TPC 计算引擎的当前时钟频率，单位为 Hz。此属性仅对 Goya ASIC 系列有效。

/sys/class/accel/accel<n>/device/uboot_ver

在文件 sysfs-driver-habanalabs 中定义

设备 CPU 上运行的 u-boot 版本。

/sys/class/accel/accel<n>/device/vrm_ver

在文件 sysfs-driver-habanalabs 中定义

设备电压调节器监控 F/W 代码的版本。不适用于 GOYA 和 GAUDI。

/sys/class/ata_*

定义在文件 sysfs-ata 中。

在 sysfs 中为存储系统的 ATA 拓扑结构提供一个位置。这允许检索有关 ATA 对象的各种信息。

/sys/class/ata_port 下的文件

对于每个端口，会创建一个 ataX 目录，其中 X 是端口的 ata_port_id。设备父级是 ata 主机设备。

/sys/class/ata_device/devX[.Y].Z/spdn_cnt

/sys/class/ata_device/devX[.Y].Z/gscr

/sys/class/ata_device/devX[.Y].Z/ering

/sys/class/ata_device/devX[.Y].Z/id

/sys/class/ata_device/devX[.Y].Z/pio_mode

/sys/class/ata_device/devX[.Y].Z/xfer_mode

/sys/class/ata_device/devX[.Y].Z/dma_mode

/sys/class/ata_device/devX[.Y].Z/class

定义在文件 sysfs-ata 中。

spdn_cnt: (只读) libata 因错误而决定降低链路速度的次数。

速度的次数。

gscr: (只读) PM GSCR 转储的缓存结果。

有效寄存器为

0: SATA_PMP_GSCR_PROD_ID, 1: SATA_PMP_GSCR_REV, 2: SATA_PMP_GSCR_PORT_INFO, 32: SATA_PMP_GSCR_ERROR, 33: SATA_PMP_GSCR_ERROR_EN, 64: SATA_PMP_GSCR_FEAT, 96: SATA_PMP_GSCR_FEAT_EN, 130: SATA_PMP_GSCR_SII_GPIO

仅当设备是 PM 时有效。

ering: (只读) 设备错误环的格式化输出。

设备。

id: (只读) IDENTIFY 命令的缓存结果，如

ATA8 7.16 和 7.17 中所述。仅当设备不是 PM 时有效。

pio_mode: (只读) 设备使用的 PIO 传输模式。

主要由 PATA 设备使用。

xfer_mode: (只读) 当前传输模式。主要由

PATA 设备使用。

dma_mode: (只读) 设备使用的 DMA 传输模式。

主要由 PATA 设备使用。

class: (只读) 设备类别。可以是 “ata” 表示磁盘，

“atapi” 表示数据包设备，“pmp” 表示 PM，如果链路后面没有找到设备则为 “none”。

/sys/class/ata_device/devX[.Y].Z/trim

定义在文件 sysfs-ata 中。

(只读) 显示设备当前使用的 DSM TRIM 模式。有效值为

unsupported: 驱动器不支持 DSM TRIM

unqueued: 驱动器仅支持非队列 DSM TRIM

queued: 驱动器支持队列 DSM TRIM

forced_unqueued: 已知驱动器的队列 DSM 支持

存在错误，并且仅发送非队列 TRIM 命令

定义在文件 sysfs-ata 中。

hw_sata_spd_limit: (只读) 连接的 SATA 设备支持的最大速度。

连接的 SATA 设备。

sata_spd_limit: (只读) libata 施加的最大速度。

sata_spd: (只读) 链路的当前速度

例如 1.5、3 Gbps 等。

/sys/class/ata_device 下的文件

在每个链路后面，最多创建两个 ata 设备。目录的名称为 devX[.Y].Z，其中：- X 是设备连接的端口的 ata_port_id，- Y 是 PM 的端口（如果有），- Z 是设备 id：对于 PATA，通常有 2 个设备 [0,1]，对于 SATA 只有一个。

定义在文件 sysfs-ata 中。

nr_pmp_links: (只读) 如果连接了 SATA 端口多路复用器 (PM)

，则其后面的链路数。

idle_irq: (只读) 端口在空闲时接收到的 IRQ 数量 [仅限某些 ata HBA]。

idle [仅限某些 ata HBA]。

/sys/class/ata_port/ataX/port_no

定义在文件 sysfs-ata 中。

(只读) 主机本地端口号。在注册主机控制器时，端口号根据控制器上可用的端口数进行跟踪。此属性是 udev 在 /dev/disk/by-path 中组成持久性链接所必需的。

/sys/class/ata_link 下的文件

在每个端口后面，都有一个 ata_link。如果拓扑结构中存在 SATA PM，则创建 15 个 ata_link 对象。

如果链路位于端口后面，则目录名称为 linkX，其中 X 是端口的 ata_port_id。如果链路位于 PM 后面，则其名称为 linkX.Y，其中 X 是父端口的 ata_port_id，Y 是 PM 端口。

/sys/class/backlight/<背光>/<环境光区域>_dim

定义在文件 sysfs-class-backlight 中。

控制此 <背光> 上 <环境光区域> 的暗淡亮度。值介于 0 和 127 之间，通常设置为 0。当背光禁用时完全关闭。此文件还将显示为此 <环境光区域> 存储的暗淡亮度级别。

<环境光区域> 是设备驱动程序特定的。

对于 ADP5520 和 ADP5501，<环境光区域> 可以是

环境

sysfs 条目

光照区域

日光

/sys/class/backlight/<背光>/daylight_dim

办公室

/sys/class/backlight/<背光>/office_dim

黑暗

/sys/class/backlight/<背光>/dark_dim

对于 ADP8860，<环境光区域> 可以是

环境

sysfs 条目

光照区域

l1_日光

/sys/class/backlight/<背光>/l1_daylight_dim

l2_办公室

/sys/class/backlight/<背光>/l2_office_dim

l3_黑暗

/sys/class/backlight/<背光>/l3_dark_dim

对于 ADP8870，<环境光区域> 可以是

环境

sysfs 条目

光照区域

l1_日光

/sys/class/backlight/<背光>/l1_daylight_dim

l2_明亮

/sys/class/backlight/<背光>/l2_bright_dim

l3_办公室

/sys/class/backlight/<背光>/l3_office_dim

l4_室内

/sys/class/backlight/<背光>/l4_indoor_dim

l5_黑暗

/sys/class/backlight/<背光>/l5_dark_dim

另请参见：/sys/class/backlight/<背光>/ambient_light_zone。

/sys/class/backlight/<背光>/<环境光区域>_max

定义在文件 sysfs-class-backlight 中。

控制此 <背光> 上 <环境光区域> 的最大亮度。值介于 0 和 127 之间。此文件还将显示为此 <环境光区域> 存储的亮度级别。

<环境光区域> 是设备驱动程序特定的。

对于 ADP5520 和 ADP5501，<环境光区域> 可以是

环境

sysfs 条目

光照区域

日光

/sys/class/backlight/<背光>/daylight_max

办公室

/sys/class/backlight/<背光>/office_max

黑暗

/sys/class/backlight/<背光>/dark_max

对于 ADP8860，<环境光区域> 可以是

环境

sysfs 条目

光照区域

l1_日光

/sys/class/backlight/<背光>/l1_daylight_max

l2_办公室

/sys/class/backlight/<背光>/l2_office_max

l3_黑暗

/sys/class/backlight/<背光>/l3_dark_max

对于 ADP8870，<环境光区域> 可以是

环境

sysfs 条目

光照区域

l1_日光

/sys/class/backlight/<背光>/l1_daylight_max

l2_明亮

/sys/class/backlight/<背光>/l2_bright_max

l3_办公室

/sys/class/backlight/<背光>/l3_office_max

l4_室内

/sys/class/backlight/<背光>/l4_indoor_max

l5_黑暗

/sys/class/backlight/<背光>/l5_dark_max

另请参见：/sys/class/backlight/<背光>/ambient_light_zone。

/sys/class/backlight/<背光>/als_channel

定义在文件 sysfs-class-backlight-driver-lm3533 中。

获取在 ALS 电流控制模式下用作输入的 ALS 输出通道（0、1），其中

0

out_current0 (背光 0)

1

out_current1 (背光 1)

/sys/class/backlight/<背光>/als_en

定义在文件 sysfs-class-backlight-driver-lm3533 中。

启用 ALS 电流控制模式 (0, 1)。

/sys/class/backlight/<背光>/ambient_light_level

定义在文件 sysfs-class-backlight 中。

(只读) 获取光传感器的转换值。

当启用光传感器时，该值每 80 毫秒自动更新一次。

值范围是设备驱动程序特定的

对于 ADP8870

它返回 0（黑暗）到 8000（最大环境亮度）之间的整数。

对于 ADP8860

它返回一个 13 位整数。

/sys/class/backlight/<背光>/ambient_light_zone

定义在文件 sysfs-class-backlight 中。

(读写) 读取或写入背光工作的特定亮度级别。

值含义是设备驱动程序特定的

对于 ADP8860

0

关闭：背光设置为 0 mA

1

级别 1：日光

2

级别 2：明亮

3

级别 3：黑暗

对于 ADP8870

0

关闭：背光设置为 0 mA

1

级别 1：日光

2

级别 2：明亮

3

级别 3：办公室

4

级别 4：室内

5

级别 5：黑暗

写入 0 将返回到正常/自动环境光级别操作。

可以通过将存储在 /sys/class/backlight/<背光>/max_brightness 中的值写入 /sys/class/backlight/<背光>/brightness 来启用它。

/sys/class/backlight/<背光>/bled_mode

定义在文件 sysfs-class-backlight-lm3639 中。

(只写) 写入背光映射模式。背光电流可以映射为指数模式（值“0”）或线性映射模式（默认）。

/sys/class/backlight/<背光>/id

定义在文件 sysfs-class-backlight-driver-lm3533 中。

获取此背光的 id (0, 1)。

/sys/class/backlight/<背光>/linear

定义在文件 sysfs-class-backlight-driver-lm3533 中。

设置亮度映射模式 (0, 1)，其中

0

指数模式

1

线性模式

/sys/class/backlight/<背光>/pwm

定义在文件 sysfs-class-backlight-driver-lm3533 中。

设置 PWM 输入控制掩码（5 位），其中

位 5

在区域 4 中启用 PWM 输入

位 4

在区域 3 中启用 PWM 输入

位 3

在区域 2 中启用 PWM 输入

位 2

在区域 1 中启用 PWM 输入

位 1

在区域 0 中启用 PWM 输入

位 0

启用 PWM 输入

/sys/class/backlight/<背光>/scale

定义在文件 sysfs-class-backlight 中。

亮度曲线的比例描述。

人眼对亮度的感知近似为对数的，因此亮度的线性变化被认为是线性非线性的。为了实现对亮度变化的线性感知，滑块等控件需要为具有线性亮度曲线的背光应用对数映射。

该属性的可能值为

未知

亮度曲线的比例未知。

线性

亮度随每个步骤线性变化。亮度控制应应用对数映射以实现线性感知。

非线性

亮度随每个步骤非线性变化。亮度控制应使用线性映射以实现线性感知。

/sys/class/bdi/<bdi>/

定义在文件 sysfs-class-bdi 中。

在 sysfs 中为 backing_dev_info 对象提供一个位置。这允许设置和检索各种 BDI 特定变量。

<bdi> 标识符可以是以下任何一个

主设备号:次设备号

块设备的设备号，或在提供自己的 BDI 的非块文件系统（如 NFS 和 FUSE）上 st_dev 的值。

主设备号:次设备号-fuseblk

fuseblk 文件系统上 st_dev 的值。

默认

用于不提供自己的 BDI 的非块设备支持的文件系统的默认支持设备。

/sys/class/bdi/<bdi>/max_bytes

定义在文件 sysfs-class-bdi 中。

允许限制特定设备使用的回写缓存不超过给定的 ‘max_bytes’。这在我们需要避免一个设备占用所有或大部分回写缓存的情况下非常有用。例如，在容易卡住的 NFS 挂载、不能信任其公平运行的 FUSE 挂载或 nbd 设备的情况下。

(读写)

/sys/class/bdi/<bdi>/max_ratio

定义在文件 sysfs-class-bdi 中。

允许限制特定设备使用的回写缓存不超过给定的百分比。这在我们需要避免一个设备占用所有或大部分回写缓存的情况下非常有用。例如，在容易卡住的 NFS 挂载或不能信任其公平运行的 FUSE 挂载的情况下。

(读写)

/sys/class/bdi/<bdi>/max_ratio_fine

定义在文件 sysfs-class-bdi 中。

允许限制特定设备使用的回写缓存不超过给定的值。该值以百万分之一给出。这在我们需要避免一个设备占用所有或大部分回写缓存的情况下非常有用。例如，在容易卡住的 NFS 挂载或不能信任其公平运行的 FUSE 挂载的情况下。

(读写)

/sys/class/bdi/<bdi>/min_bytes

定义在文件 sysfs-class-bdi 中。

在正常情况下，每个设备都会获得一部分总回写缓存，这部分缓存与其当前与其他设备相关的平均写出速度相关。

‘min_bytes’ 参数允许以字节为单位为特定设备分配最小百分比的回写缓存。例如，这对于提供最小 QoS 非常有用。

(读写)

/sys/class/bdi/<bdi>/min_ratio

定义在文件 sysfs-class-bdi 中。

在正常情况下，每个设备都会获得一部分总回写缓存，这部分缓存与其当前与其他设备相关的平均写出速度相关。

‘min_ratio’ 参数允许为特定设备分配最小百分比的回写缓存。例如，这对于提供最小 QoS 非常有用。

(读写)

/sys/class/bdi/<bdi>/min_ratio_fine

定义在文件 sysfs-class-bdi 中。

在正常情况下，每个设备都会获得一部分总回写缓存，这部分缓存与其当前与其他设备相关的平均写出速度相关。

‘min_ratio_fine’ 参数允许为特定设备分配最小回写缓存保留值。该值以百万分之一表示。例如，这对于提供最小 QoS 非常有用。

(读写)

/sys/class/bdi/<bdi>/read_ahead_kb

定义在文件 sysfs-class-bdi 中。

预读窗口大小（以千字节为单位）

(读写)

/sys/class/bdi/<bdi>/stable_pages_required

定义在文件 sysfs-class-bdi 中。

如果设置，则后备设备要求在写出完成之前不得更改构成写入请求的所有页面。

(只读)

/sys/class/bdi/<bdi>/strict_limit

定义在文件 sysfs-class-bdi 中。

即使在达到全局后台脏数据限制之前，也强制对每个 BDI（块设备 I/O）检查给定设备在回写缓存中所占的份额。这在全局限制远高于给定相对较慢（或不可信）设备可承受的情况下非常有用。如果 max_ratio 等于 100%，则启用 strictlimit 不会有明显效果。

(读写)

/sys/class/bsr/bsr*/bsr_length

定义在文件 sysfs-class-bsr 中

（只读）可以映射的内存区域的长度，以字节为单位。

/sys/class/bsr/bsr*/bsr_size

定义在文件 sysfs-class-bsr 中

（只读）屏障同步寄存器 (BSR) 的大小，以字节为单位。

/sys/class/bsr/bsr*/bsr_stride

定义在文件 sysfs-class-bsr 中

（只读）在映射中分配的 BSR 字节重复的步幅或间隔。

/sys/class/c2port/

定义在文件 sysfs-c2port 中

/sys/class/c2port/ 目录将包含文件和目录，这些文件和目录将为 C2 端口接口提供统一的接口。

/sys/class/c2port/c2portX

定义在文件 sysfs-c2port 中

/sys/class/c2port/c2portX/ 目录与系统中第 X 个 C2 端口相关。每个目录都将包含用于管理和控制其 C2 端口的文件。

/sys/class/c2port/c2portX/access

定义在文件 sysfs-c2port 中

/sys/class/c2port/c2portX/access 文件允许系统访问 C2 端口。在此条目设置为 0 之前，无法发送任何命令。

/sys/class/c2port/c2portX/dev_id

定义在文件 sysfs-c2port 中

/sys/class/c2port/c2portX/dev_id 文件显示已连接微控制器的设备 ID。

/sys/class/c2port/c2portX/flash_access

定义在文件 sysfs-c2port 中

/sys/class/c2port/c2portX/flash_access 文件允许访问已连接微控制器的板载闪存。在此条目设置为 0 之前，无法发送任何命令。

/sys/class/c2port/c2portX/flash_block_size

定义在文件 sysfs-c2port 中

/sys/class/c2port/c2portX/flash_block_size 文件显示已连接微控制器的板载闪存块大小。

/sys/class/c2port/c2portX/flash_blocks_num

定义在文件 sysfs-c2port 中

/sys/class/c2port/c2portX/flash_blocks_num 文件显示已连接微控制器的板载闪存块数量。

/sys/class/c2port/c2portX/flash_data

定义在文件 sysfs-c2port 中

/sys/class/c2port/c2portX/flash_data 文件导出已连接微控制器的板载闪存的内容。

/sys/class/c2port/c2portX/flash_erase

定义在文件 sysfs-c2port 中

/sys/class/c2port/c2portX/flash_erase 文件对已连接微控制器的板载闪存执行“擦除”命令。

/sys/class/c2port/c2portX/reset

定义在文件 sysfs-c2port 中

/sys/class/c2port/c2portX/reset 文件对已连接的微控制器执行“复位”命令。

/sys/class/c2port/c2portX/rev_id

定义在文件 sysfs-c2port 中

/sys/class/c2port/c2portX/rev_id 文件显示已连接微控制器的修订 ID。

/sys/class/chromeos/<ec-device-name>/flashinfo

定义在文件 sysfs-class-chromeos 中

显示 EC 闪存信息。

/sys/class/chromeos/<ec-device-name>/kb_wake_angle

定义在文件 sysfs-class-chromeos 中

控制键盘唤醒的盖子角度。取值范围为 0 到 360。此文件还将通过查询硬件来显示键盘唤醒的盖子角度。

/sys/class/chromeos/<ec-device-name>/lightbar/brightness

定义在文件 sysfs-class-chromeos-driver-cros-ec-lightbar 中

写入此文件可调整灯条的整体亮度，与任何颜色强度分开。有效范围为 0（关闭）到 255（最大亮度）。

/sys/class/chromeos/<ec-device-name>/lightbar/interval_msec

定义在文件 sysfs-class-chromeos-driver-cros-ec-lightbar 中

灯条由嵌入式控制器 (EC) 控制，该控制器还管理键盘、电池充电、风扇和其他系统硬件。为了防止非特权用户干扰其他 EC 功能，对灯条控制文件的读取或写入速率进行了限制。

读取此文件将返回通过此接口访问任何灯条功能之间必须经过的毫秒数。如果速度过快，则会一直阻塞，直到经过必要的间隔。该间隔均匀地应用于任何用户进行的任何类型的访问。

/sys/class/chromeos/<ec-device-name>/lightbar/led_rgb

定义在文件 sysfs-class-chromeos-driver-cros-ec-lightbar 中

这允许您控制每个 LED 段。如果灯条已经在运行自动序列之一，您可能看不到任何变化，因为您的颜色设置几乎会立即被替换。要获得有用的结果，您应该先停止灯条序列。

写入此文件的值是四组整数，指示 LED、红色、绿色、蓝色。LED 编号为 0 到 3 以选择单个段，或为 4 以一次将所有四个段设置为相同的值。红色、绿色和蓝色数字应在 0（关闭）到 255（最大）范围内。您可以通过写入多组四个整数来一次更新多个段。

/sys/class/chromeos/<ec-device-name>/lightbar/program

定义在文件 sysfs-class-chromeos-driver-cros-ec-lightbar 中

这允许您上传和运行自定义灯条序列。

/sys/class/chromeos/<ec-device-name>/lightbar/sequence

定义在文件 sysfs-class-chromeos-driver-cros-ec-lightbar 中

Pixel 灯条有许多内置序列，它会在各种条件下显示这些序列，例如在开机、关机或运行时。读取此文件会显示灯条当前正在显示的序列。写入此文件允许您更改序列。

/sys/class/chromeos/<ec-device-name>/lightbar/userspace_control

定义在文件 sysfs-class-chromeos-driver-cros-ec-lightbar 中

这允许您控制灯条。这可以防止内核执行其正常序列。

/sys/class/chromeos/<ec-device-name>/lightbar/version

定义在文件 sysfs-class-chromeos-driver-cros-ec-lightbar 中

显示有关灯条版本的信息。

/sys/class/chromeos/<ec-device-name>/reboot

定义在文件 sysfs-class-chromeos 中

告诉 EC 以各种方式重启。选项为

  • “cancel”：取消挂起的重启。

  • “ro”：跳转到 RO，无需重启。

  • “rw”：跳转到 RW，无需重启。

  • “cold”：冷重启。

  • “disable-jump”：禁用跳转，直到下次重启。

  • “hibernate”：使 EC 休眠。

  • “at-shutdown”：在 AP 关闭后重启。

/sys/class/chromeos/<ec-device-name>/vbc/vboot_context

定义在文件 sysfs-class-chromeos-driver-cros-ec-vbc 中

读取/写入某些 EC 实现上的小型 nvram 空间中包含的已验证启动上下文数据。

/sys/class/chromeos/<ec-device-name>/version

定义在文件 sysfs-class-chromeos 中

显示有关 EC 软件和硬件的信息。

/sys/class/cxl/<afu>/afu_err_buf

定义在文件 sysfs-class-cxl 中

只读 AFU 错误缓冲区内容。此文件的内容是特定于应用程序的，并且取决于正在使用的 AFU。与 AFU 交互的应用程序可以使用此属性来了解当前的错误情况，并采取适当的操作，例如记录事件等。

/sys/class/cxl/<afu>/api_version

定义在文件 sysfs-class-cxl 中

只读内核/用户 API 当前版本的十进制值。

用户：https://github.com/ibm-capi/libcxl

/sys/class/cxl/<afu>/api_version_compatible

定义在文件 sysfs-class-cxl 中

只读此内核支持的最低用户空间 API 版本的十进制值。

用户：https://github.com/ibm-capi/libcxl AFU 配置记录（例如 /sys/class/cxl/afu0.0/cr0）：AFU 可以选择导出一条或多条类似 PCIe 的配置记录，称为 AFU 配置记录，这些记录将在此处显示（如果存在）。

/sys/class/cxl/<afu>/cr<config num>/class

定义在文件 sysfs-class-cxl 中

只读在此 AFU 配置记录中找到的类代码的十六进制值。

用户：https://github.com/ibm-capi/libcxl

/sys/class/cxl/<afu>/cr<config num>/config

定义在文件 sysfs-class-cxl 中

只读此二进制文件提供对 AFU 配置记录的原始访问。格式应与 PCIe 规范定义的标准或扩展配置空间匹配。

用户：https://github.com/ibm-capi/libcxl 主上下文（例如 /sys/class/cxl/afu0.0m）

/sys/class/cxl/<afu>/cr<config num>/device

定义在文件 sysfs-class-cxl 中

只读在此 AFU 配置记录中找到的设备 ID 的十六进制值。

用户：https://github.com/ibm-capi/libcxl

/sys/class/cxl/<afu>/cr<config num>/vendor

定义在文件 sysfs-class-cxl 中

只读在此 AFU 配置记录中找到的供应商 ID 的十六进制值。

用户：https://github.com/ibm-capi/libcxl

/sys/class/cxl/<afu>/irqs_max

定义在文件 sysfs-class-cxl 中

读/写 用户空间可以请求的最大中断数的十进制值。探测时的默认值是硬件可以支持的最大值（例如 2037）。写入值会将用户空间应用程序限制为那么多用户空间中断。必须 >= irqs_min。

用户：https://github.com/ibm-capi/libcxl

/sys/class/cxl/<afu>/irqs_min

定义在文件 sysfs-class-cxl 中

只读用户空间在 CXL_START_WORK ioctl 上必须请求的最小中断数的十进制值。用户空间可以省略 START_WORK IOCTL 中的 num_interrupts 字段以自动获取此最小值。

用户：https://github.com/ibm-capi/libcxl

/sys/class/cxl/<afu>/mmio_size

定义在文件 sysfs-class-cxl 中

只读用户空间可以 mmap 的 MMIO 空间大小的十进制值。

用户：https://github.com/ibm-capi/libcxl

/sys/class/cxl/<afu>/mode

定义在文件 sysfs-class-cxl 中

读/写 AFU 当前使用的模式。将是 modes_supported 中给出的模式之一。写入将更改模式，前提是没有附加用户上下文。

用户：https://github.com/ibm-capi/libcxl

/sys/class/cxl/<afu>/modes_supported

定义在文件 sysfs-class-cxl 中

只读此 AFU 支持的模式列表。每行一个。有效条目为：“dedicated_process”和“afu_directed”

用户：https://github.com/ibm-capi/libcxl

/sys/class/cxl/<afu>/prefault_mode

定义在文件 sysfs-class-cxl 中

读/写设置在执行 START_WORK ioctl 时将段预先加载到段表中的模式。仅在哈希页表 mmu 下运行时适用。可能的值

无

不预加载（默认）

work_element_descriptor

将工作元素描述符视为有效地址，并预加载它指向的内容。

all

所有段处理调用 START_WORK 映射。

用户：https://github.com/ibm-capi/libcxl

/sys/class/cxl/<afu>/reset

定义在文件 sysfs-class-cxl 中

只写在此处写入 1 将重置 AFU，前提是 AFU 上没有活动的上下文。

用户：https://github.com/ibm-capi/libcxl

/sys/class/cxl/<afu>m/mmio_size

定义在文件 sysfs-class-cxl 中

只读的十进制数值，表示用户空间可以通过 mmap 映射的 MMIO 空间大小。这包括所有从属上下文空间。

用户：https://github.com/ibm-capi/libcxl

/sys/class/cxl/<afu>m/pp_mmio_len

定义在文件 sysfs-class-cxl 中

只读的十进制数值，表示每个进程的 MMIO 空间长度。

用户：https://github.com/ibm-capi/libcxl

/sys/class/cxl/<afu>m/pp_mmio_off

定义在文件 sysfs-class-cxl 中

只读的（在 guest 中不可用）十进制数值，表示每个进程的 MMIO 空间偏移量。

用户：https://github.com/ibm-capi/libcxl 卡信息（例如，/sys/class/cxl/card0）

/sys/class/cxl/<card>/base_image

定义在文件 sysfs-class-cxl 中

只读的（在 guest 中不可用）标识支持可加载 PSL 的设备的基镜像的修订级别。对于 FPGA，此字段标识在初始程序加载期间加载的适配器上闪存中包含的镜像。

用户：https://github.com/ibm-capi/libcxl

/sys/class/cxl/<card>/caia_version

定义在文件 sysfs-class-cxl 中

只读的，标识卡实现的 CAIA 版本。

用户：https://github.com/ibm-capi/libcxl

/sys/class/cxl/<card>/image_loaded

定义在文件 sysfs-class-cxl 中

只读的（在 guest 中不可用），将根据加载到卡上的镜像返回 “user” 或 “factory”。

用户：https://github.com/ibm-capi/libcxl

/sys/class/cxl/<card>/load_image_on_perst

定义在文件 sysfs-class-cxl 中

读/写（在 guest 中不可用）。有效条目为 “none”、“user” 和 “factory”。“none” 表示 PERST 不会导致镜像加载到卡上。需要电源重启才能加载镜像。“none” 对于调试很有用，因为跟踪数组会被保留。

“user” 和 “factory” 表示 PERST 将导致加载用户或工厂镜像。默认是在 PERST 上重新加载卡已加载的任何镜像。

用户：https://github.com/ibm-capi/libcxl

/sys/class/cxl/<card>/perst_reloads_same_image

定义在文件 sysfs-class-cxl 中

读/写（在 guest 中不可用）。信任通过 PERST 重新加载镜像时，镜像不会发生更改。

0

不信任，镜像可能不同（默认）。

1

信任镜像不会更改。

用户：https://github.com/ibm-capi/libcxl

/sys/class/cxl/<card>/psl_revision

定义在文件 sysfs-class-cxl 中

只读的，标识 PSL 的修订级别。

用户：https://github.com/ibm-capi/libcxl

/sys/class/cxl/<card>/psl_timebase_synced

定义在文件 sysfs-class-cxl 中

只读的，如果 psl 时间基准寄存器与核心时间基准寄存器同步，则返回 1，否则返回 0。

用户：https://github.com/ibm-capi/libcxl

/sys/class/cxl/<card>/reset

定义在文件 sysfs-class-cxl 中

只写。写入 1 将向卡发出 PERST，前提是卡的任何一个 AFU 上都没有活动的上下文。这可能会导致卡重新加载 FPGA，具体取决于 load_image_on_perst。写入 -1 将强制执行 PERST，而不管卡 AFU 上是否有任何活动的上下文。

用户：https://github.com/ibm-capi/libcxl

/sys/class/cxl/<card>/tunneled_ops_supported

定义在文件 sysfs-class-cxl 中

只读的。如果 capi 模式支持隧道操作，则返回 1，否则返回 0。

用户：https://github.com/ibm-capi/libcxl

/sys/class/devfreq-event/event<x>/

在文件 sysfs-class-devfreq-event 中定义。

在 sysfs 中为 devfreq-event 对象提供一个位置。这允许访问各种 devfreq-event 特定变量。devfreq-event 对象的名称表示为 “event<x>”，其中包括每个 devfreq-event 对象的唯一编号 “x”。

/sys/class/devfreq-event/event<x>/enable_count

在文件 sysfs-class-devfreq-event 中定义。

/sys/class/devfreq-event/event<x>/enable_count 属性包含启用 devfreq-event 对象的引用计数。如果设备已启用，则属性的值大于零。

/sys/class/devfreq-event/event<x>/name

在文件 sysfs-class-devfreq-event 中定义。

/sys/class/devfreq-event/event<x>/name 属性包含 devfreq-event 对象的名称。此属性是只读的。

/sys/class/devfreq/.../

在文件 sysfs-class-devfreq 中定义。

在 sysfs 中为 devfreq 对象提供一个位置。这允许访问各种 devfreq 特定变量。devfreq 对象的名称表示为 ...，与使用 devfreq 的设备的名称相同。

/sys/class/devfreq/.../available_frequencies

在文件 sysfs-class-devfreq 中定义。

/sys/class/devfreq/.../available_frequencies 显示相应 devfreq 对象的可用频率。这是可用频率的快照，不受最小/最大频率限制。

/sys/class/devfreq/.../available_governors

在文件 sysfs-class-devfreq 中定义。

/sys/class/devfreq/.../available_governors 显示系统中当前可用的调速器。

/sys/class/devfreq/.../cur_freq

在文件 sysfs-class-devfreq 中定义。

/sys/class/devfreq/.../cur_freq 显示相应 devfreq 对象的当前频率。当 devfreq 驱动程序未实现 get_cur_freq() 时，与 target_freq 相同。

/sys/class/devfreq/.../governor

在文件 sysfs-class-devfreq 中定义。

/sys/class/devfreq/.../governor 显示或设置相应 devfreq 对象使用的调速器的名称。

/sys/class/devfreq/.../max_freq

在文件 sysfs-class-devfreq 中定义。

/sys/class/devfreq/.../max_freq 显示和存储用户请求的最大频率。如果用户不在意，则为 0。max_freq 会覆盖调速器和 min_freq 请求的频率。max_freq 覆盖 min_freq 是因为 max_freq 可用于限制设备以避免过热。

/sys/class/devfreq/.../min_freq

在文件 sysfs-class-devfreq 中定义。

/sys/class/devfreq/.../min_freq 显示和存储用户请求的最小频率。如果用户不在意，则为 0。min_freq 会覆盖调速器请求的频率。

/sys/class/devfreq/.../name

在文件 sysfs-class-devfreq 中定义。

/sys/class/devfreq/.../name 显示相应 devfreq 对象的设备名称。

/sys/class/devfreq/.../polling_interval

在文件 sysfs-class-devfreq 中定义。

/sys/class/devfreq/.../polling_interval 显示和设置相应 devfreq 对象请求的轮询间隔。这些值以毫秒为单位表示。如果该值小于 1 jiffy，则将其视为 0，这意味着不轮询。如果调速器不轮询，则此值没有意义。

支持该节点的调速器列表：- simple_ondmenad - tegra_actmon

/sys/class/devfreq/.../target_freq

在文件 sysfs-class-devfreq 中定义。

/sys/class/devfreq/.../target_freq 显示相应 devfreq 对象的下一个调速器预测目标频率。

/sys/class/devfreq/.../timer

在文件 sysfs-class-devfreq 中定义。

此 ABI 显示和存储用户的工作计时器类型。此工作计时器由 devfreq 工作队列使用，以便监视设备状态，例如利用率。用户可以根据自己的需求在运行时更改工作计时器，如下所示

echo deferrable > /sys/class/devfreq/.../timer
echo delayed > /sys/class/devfreq/.../timer

支持该节点的调速器列表：- simple_ondemand

/sys/class/devfreq/.../trans_stat

在文件 sysfs-class-devfreq 中定义。

此 ABI 显示或清除特定设备上 devfreq 行为的统计信息。它显示每个状态花费的时间以及状态之间的转换次数。为了激活此 ABI，devfreq 目标设备驱动程序应提供具有其配置文件的可用频率列表。如果需要重置特定设备上 devfreq 行为的统计信息，请输入 0（零）到 “trans_stat”，如下所示

echo 0 > /sys/class/devfreq/.../trans_stat

如果转换表大于 PAGE_SIZE，则读取此表将返回 -EFBIG 错误。

/sys/class/devfreq/.../userspace/set_freq

在文件 sysfs-class-devfreq 中定义。

如果 userspace 调速器生效，则 /sys/class/devfreq/.../userspace/set_freq 显示和设置 devfreq 对象请求的频率。

支持该节点的调速器列表：- userspace

在文件 sysfs-class-devlink 中定义。

在 sysfs 中为内核中任何给定时间的设备链接对象提供一个位置。设备链接目录的名称（在上面表示为 ...）采用 <supplier>--<consumer> 的形式，其中 <supplier> 是供应商总线：设备名称，<consumer> 是消费者总线：设备名称。

在文件 sysfs-class-devlink 中定义。

此文件指示当消费者和供应商设备本身仍然存在时，驱动程序核心是否会自动删除设备链接。

这将是以下字符串之一

  • “consumer unbind”

  • “supplier unbind”

  • “never”

“consumer unbind” 表示当消费者的驱动程序从消费者设备解除绑定时，将删除设备链接。

“supplier unbind” 表示当供应商的驱动程序从供应商设备解除绑定时，将删除设备链接。

“never” 表示只要供应商和消费者设备本身仍然存在，就不会自动删除设备链接。

在文件 sysfs-class-devlink 中定义。

此文件是指向消费者设备的 sysfs 目录的符号链接。

在文件 sysfs-class-devlink 中定义。

此文件指示设备链接是否对消费者和供应商设备的运行时电源管理行为有任何影响。例如：确保供应商在消费者处于活动状态时不会进入运行时挂起。

这将是以下字符串之一

‘0’

不影响运行时电源管理

‘1’

影响运行时电源管理

在文件 sysfs-class-devlink 中定义。

此文件指示设备链接的状态。设备链接的状态受供应商和消费者设备是否已绑定到其相应驱动程序的影响。设备链接的状态还会影响供应商和消费者设备与其驱动程序的绑定和解除绑定，并且还会影响供应商设备的软件状态是否在启动后与供应商设备的硬件状态同步。另请参阅：sysfs-devices-state_synced。

这将是以下字符串之一

  • “not tracked”

  • “dormant”

  • “available”

  • “consumer probing”

  • “active”

  • “supplier unbinding”

  • “unknown”

“not tracked” 表示此设备链接不跟踪状态，并且对绑定、解除绑定和同步硬件和软件设备状态没有影响。

“dormant” 表示供应商和消费者设备尚未绑定到其驱动程序。

“available” 表示供应商已绑定到其驱动程序，并且可向消费者设备提供资源。

“consumer probing” 表示消费者设备当前正在尝试绑定到其驱动程序。

“active” 表示供应商和消费者设备都已成功绑定到其驱动程序。

“supplier unbinding” 表示供应商设备当前正在与其驱动程序解除绑定。

“unknown” 表示设备链接的状态不是上述任何一种。如果出现此值，则表示内核中存在错误。

在文件 sysfs-class-devlink 中定义。

此文件是指向供应商设备的 sysfs 目录的符号链接。

在文件 sysfs-class-devlink 中定义。

此文件指示设备链接是否仅限于影响供应商设备的硬件和软件状态的同步。

这将是以下字符串之一

‘0’

‘1’

影响运行时电源管理

“0” 表示设备链接会影响其他设备行为，如绑定/解除绑定、挂起/恢复、运行时电源管理等。

“1” 表示设备链接仅会影响启动后供应商设备的硬件和软件状态的同步，并且不会影响设备的其他行为。

/sys/class/extcon/.../

在文件 sysfs-class-extcon 中定义。

在 sysfs 中为 extcon 对象提供一个位置。这允许访问 extcon 特定的变量。extcon 对象的名称表示为...，该名称是在使用 extcon_dev_register 注册时给定的。

一个 extcon 设备表示一个单独的外部连接器端口。一个外部连接器可以同时连接多根电缆。许多扩展坞、底座和配件电缆都具有这种能力。例如，Nuri 板（/arch/arm/mach-exynos）的 30 针端口可以同时连接 HDMI 和充电器，或者同时连接模拟音频、视频和 USB 电缆。

如果存在相互排斥的电缆，则可以使用 extcon_dev 的 mutually_exclusive 数组来表示这种二元关系。

/sys/class/extcon/.../cable.X/name

在文件 sysfs-class-extcon 中定义。

/sys/class/extcon/.../cable.X/name 显示 extcon 设备的电缆 “X”（0 到 31 之间的整数）的名称。

/sys/class/extcon/.../cable.X/state

在文件 sysfs-class-extcon 中定义。

/sys/class/extcon/.../cable.X/state 显示并存储 extcon 设备的电缆 “X”（0 到 31 之间的整数）的状态。状态值可以是 0（已断开）或 1（已连接）。

/sys/class/extcon/.../mutually_exclusive/..

在文件 sysfs-class-extcon 中定义。

显示相互排斥的关系。例如，如果 extcon 设备的 mutually_exclusive 数组为 {0x3, 0x5, 0xC, 0x0}，则输出为

# ls mutually_exclusive/
0x3
0x5
0xc
#

请注意，mutually_exclusive 是 extcon 设备的一个子目录，并且 mutually_exclusive 目录下的文件名显示的是相互排斥的集合，而不是文件的内容。

/sys/class/extcon/.../name

在文件 sysfs-class-extcon 中定义。

/sys/class/extcon/.../name 显示 extcon 对象的名称。如果 extcon 对象定义了可选的回调函数 “show_name”，则该回调函数将通过此 sysfs 节点提供名称。

/sys/class/extcon/.../state

在文件 sysfs-class-extcon 中定义。

/sys/class/extcon/.../state 显示并存储相应 extcon 对象的电缆连接/断开信息。如果 extcon 对象定义了可选的回调函数 “show_state”，则显示函数将被可选的回调函数覆盖。

如果使用默认的显示函数回调，则格式如下所示

# cat state
USB_OTG=1
HDMI=0
TA=1
EAR_JACK=0
#

在此示例中，extcon 设备已连接 USB_OTG 和 TA 电缆，并断开了 HDMI 和 EAR_JACK 电缆。

为了更新 extcon 设备的状态，请输入一个以 0x 开头的十六进制状态值

# echo 0xHEX > state

这将更新 extcon 设备的整体状态。如果存在相互排斥的条件，则所有方法的输入都必须满足这些条件。

如果需要原子地设置值，建议使用此“全局”状态接口。与每根电缆关联的后续状态接口无法同时更新 extcon 设备的多个电缆状态。

/sys/class/fc/fc_udev_device/appid_store

在文件 sysfs-class-fc 中定义

此接口允许管理员在与 cgroup id 关联的 blkcg 中设置 FC 应用程序标识符。该标识符通常是一个 UUID，它与应用程序或逻辑实体（如虚拟机或容器组）相关联。应用程序或逻辑实体通过 cgroup id 使用块设备。FC 适配器驱动程序可以查询该标识符，并根据该标识符标记 FC 流量。FC 主机和 FC 光纤实体可以使用应用程序 id 和 FC 流量标记来识别流量来源。

此接口期望一个字符串 “<cgroupid>:<appid>”，其中： <cgroupid> 是 cgroup 的 inode（十六进制表示），<appid> 是用户提供的字符串，最大长度为 128 个字符。

如果对已设置 appid 的 cgroup id 执行 appid_store 操作，则新值将覆盖先前的值。

如果管理员想要从 cgroup 中删除 FC 应用程序标识符，则应该使用以下字符串执行 appid_store 操作：“<cgroupid>:”

/sys/class/fc_host/hostX/statistics/fpin_cn_yyy

在文件 sysfs-class-fc_host 中定义

这些文件包含 F_Port 记录的拥塞通知事件的数量，这些事件是使用光纤性能影响通知 (FPIN) 事件报告的。

/sys/class/fc_host/hostX/statistics/fpin_dn_yyy

在文件 sysfs-class-fc_host 中定义

这些文件包含 F_Port/Nx_Port 记录的与交付相关的错误数量，这些错误是使用光纤性能影响通知 (FPIN) 事件报告的。

/sys/class/fc_host/hostX/statistics/fpin_li_yyy

在文件 sysfs-class-fc_host 中定义

这些文件包含 F_Port/Nx_Port 记录的链路完整性错误事件的数量，这些错误是使用光纤性能影响通知 (FPIN) 事件报告的。

/sys/class/fc_remote_ports/rport-X:Y-Z/statistics/fpin_cn_yyy

在文件 sysfs-class-fc_remote_ports 中定义

这些文件包含 F_Port/Nx_Port 记录的拥塞通知事件的数量，这些事件是使用光纤性能影响通知 (FPIN) 事件报告的。

/sys/class/fc_remote_ports/rport-X:Y-Z/statistics/fpin_dn_yyy

在文件 sysfs-class-fc_remote_ports 中定义

这些文件包含 F_Port/Nx_Port 记录的与交付相关的错误数量，这些错误是使用光纤性能影响通知 (FPIN) 事件报告的。

/sys/class/fc_remote_ports/rport-X:Y-Z/statistics/fpin_li_yyy

在文件 sysfs-class-fc_remote_ports 中定义

这些文件包含 F_Port/Nx_Port 记录的链路完整性错误事件的数量，这些错误是使用光纤性能影响通知 (FPIN) 事件报告的。

/sys/class/firmware-attributes/*/attributes/*/

在文件 sysfs-class-firmware-attributes 中定义

一个 sysfs 接口，供系统管理软件在受支持的系统上启用配置功能。此目录公开用于与配置选项交互的接口。

除非属性描述中另有说明，否则所有属性都是可选的，并且将接受 UTF-8 输入。

type

一个可以读取以获取属性类型的文件。此属性是必需的。

以下是已知的类型

  • 枚举：一组预定义的有效值

  • 整数：一系列数值

  • 字符串

HP 特定类型

  • 有序列表 - 一组有序的有效值列表

所有属性类型都支持以下值

current_value

一个可以读取以获取 <attr> 的当前值的文件。

也可以写入此文件以更新 <attr> 的值

此属性是必需的。

default_value

一个可以读取以获取 <attr> 的默认值的文件

display_name

一个可以读取以获取 <attr> 的用户友好描述的文件

display_name_language_code

一个可以读取以获取与 <attr> 的 “display_name” 对应的 IETF 语言标记的文件

“枚举”类型特定的属性

possible_values

一个可以读取以获取 <attr> 的可能值的文件。值使用分号 (;) 分隔。

“整数”类型特定的属性

min_value

一个可以读取以获取 <attr> 的下限值的文件

max_value

一个可以读取以获取 <attr> 的上限值的文件

scalar_increment

一个可以读取以获取当前值增量的标量值的文件，此属性接受该值。

“字符串”类型特定的属性

max_length

一个可以读取以获取 <attr> 的最大长度值的文件

min_length

一个可以读取以获取 <attr> 的最小长度值的文件

Dell 特定类扩展

在 Dell 系统上，可以使用以下附加属性

dell_modifier

一个可以读取以获取属性级依赖规则的文件。它表示如果/如果不是配置了属性 Y，则属性 X 将变为只读或被抑制。

修饰符规则可以采用以下格式

[ReadOnlyIf:<attribute>=<value>]
[ReadOnlyIfNot:<attribute>=<value>]
[SuppressIf:<attribute>=<value>]
[SuppressIfNot:<attribute>=<value>]

例如

AutoOnFri/dell_modifier has value,
        [SuppressIfNot:AutoOn=SelectDays]

这意味着如果 AutoOn 属性不是 “SelectDays”，则 AutoOnFri 将在 BIOS 设置中被抑制，并且只有满足此规则，其值才会通过 sysfs 生效。

枚举属性还支持以下内容

dell_value_modifier

一个可以读取以获取值级依赖项的文件。此文件类似于 dell_modifier，但在此处，将根据依赖属性的值强制更改属性的当前值。

dell_value_modifier 规则可以采用以下格式

<value>[ForceIf:<attribute>=<value>]
<value>[ForceIfNot:<attribute>=<value>]

例如

LegacyOrom/dell_value_modifier has value:
        Disabled[ForceIf:SecureBoot=Enabled]

这意味着如果启用了 SecureBoot，则 LegacyOrom 的当前值将在 BIOS 设置中强制设置为 “Disabled”，并且只有满足此规则，其值才会通过 sysfs 生效。

HP 特定类扩展

在 HP 系统上，可以使用以下附加属性

“有序列表”类型特定的属性

elements

一个可以读取以获取 <attr> 的可能值列表的文件。值使用分号 (;) 分隔，并根据其优先级列出。首先列出的元素具有最高优先级。以与 current_value 不同的顺序写入列表会更改特定属性的优先级顺序。

/sys/class/firmware-attributes/*/attributes/Sure_Start/audit_log_entries

在文件 sysfs-class-firmware-attributes 中定义

‘audit_log_entries’ 是一个只读文件，用于返回日志中的事件。

审计日志条目格式

字节 0-15：请求的审计日志条目（每个审计日志为 16 个字节） 字节 16-127：未使用

/sys/class/firmware-attributes/*/attributes/Sure_Start/audit_log_entry_count

在文件 sysfs-class-firmware-attributes 中定义

‘audit_log_entry_count’ 是一个只读文件，用于返回可读取的现有审计日志事件的数量。值使用逗号分隔。（,）

[条目数]，[日志条目大小]，[支持的最大条目数]

日志条目大小标识当前 BIOS 版本的审计日志大小。当前大小为 16 个字节，但在未来的 BIOS 版本中，它可以长达 128 个字节。

/sys/class/firmware-attributes/*/attributes/debug_cmd

在文件 sysfs-class-firmware-attributes 中定义

此只写属性可用于将调试命令发送到 BIOS。仅应在 BIOS 供应商建议时使用。供应商可以使用它来启用额外的调试属性或用于测试目的的 BIOS 功能。

请注意，对此属性的任何更改都需要重新启动才能生效。

HP 特定类扩展 - 安全平台管理器 (SPM)

/sys/class/firmware-attributes/*/attributes/pending_reboot

在文件 sysfs-class-firmware-attributes 中定义

如果需要重新启动以应用挂起的 BIOS 属性更改，则只读属性将读取 1。此外，当它更改为 1 时，将生成 uevent_KOBJ_CHANGE。

0

所有 BIOS 属性设置均为当前值

1

需要重新启动才能应用挂起的 BIOS 属性更改

请注意，用户空间应用程序需要遵循以下步骤才能实现高效的 BIOS 管理：

  1. 检查是否已设置管理员密码。如果已设置，则按照上面身份验证部分简述的会话方法进行密码管理。

  2. 在设置任何属性之前，请检查它是否具有任何修饰符或 value_modifiers。如果有，请合并它们，然后修改属性。

当此值更改时，驱动程序可能会发出 CHANGE uevent，用户空间可以再次检查它。

/sys/class/firmware-attributes/*/attributes/reset_bios

在文件 sysfs-class-firmware-attributes 中定义

此属性可用于重置 BIOS 配置。具体来说，它指示主机上请求重置的 BIOS 配置类型。

读取它会返回一个编码为列表的支持选项，例如：

  • ‘builtinsafe’ (内置安全配置配置文件)

  • ‘lastknowngood’ (上次已知的良好保存配置配置文件)

  • ‘factory’ (默认出厂设置配置配置文件)

  • ‘custom’ (自定义保存的配置配置文件)

当前选择的选项将显示在方括号中，如下所示

# echo "factory" > /sys/class/firmware-attributes/*/device/attributes/reset_bios
# cat /sys/class/firmware-attributes/*/device/attributes/reset_bios
builtinsafe lastknowngood [factory] custom

请注意，对此属性的任何更改都需要重新启动才能生效。

/sys/class/firmware-attributes/*/attributes/save_settings

在文件 sysfs-class-firmware-attributes 中定义

在联想平台上，属性的保存次数存在限制。这是一个架构限制，它将可修改的属性数量限制为 48 个。一个解决方案是，不要在每次修改后保存属性，而是允许用户批量设置属性，然后触发最终保存。这样就可以允许无限数量的属性。

读取该属性以检查启用了哪种保存模式（单个或批量）。例如：# cat /sys/class/firmware-attributes/thinklmi/attributes/save_settings single

使用“bulk”写入该属性以启用批量保存模式。使用“single”写入该属性以在每次设置属性后启用保存。默认设置为单个模式。例如：# echo bulk > /sys/class/firmware-attributes/thinklmi/attributes/save_settings

在批量模式下，写入“save”以触发保存所有当前修改的属性。请注意，一旦在批量模式下触发保存，则无法再设置属性，并且将返回权限错误。这是为了防止用户达到 48+ 保存限制（需要进入 BIOS 清除错误情况）。例如：# echo save > /sys/class/firmware-attributes/thinklmi/attributes/save_settings

/sys/class/firmware-attributes/*/authentication/

在文件 sysfs-class-firmware-attributes 中定义

设备支持各种身份验证机制，这些机制可以作为单独的配置对象公开。

例如，可以使用这些属性设置、重置或清除“BIOS 管理员”密码和“系统”密码。

  • “管理员”密码用于防止修改 BIOS 设置。

  • 启动计算机需要“系统”密码。

这两种身份验证方法中的任何一种更改也会生成 uevent KOBJ_CHANGE。

is_enabled

一个可以读取的文件，用于获取 0/1 标志，以查看是否启用了 <attr> 身份验证。此属性是必需的。

role

所使用的身份验证类型。此属性是必需的。

已知类型
bios-admin

表示 BIOS 管理员密码

power-on

表示使用系统所需的密码

system-mgmt

表示系统管理密码。有关详细信息，请参阅联想扩展部分

HDD

表示 HDD 密码。有关详细信息，请参阅联想扩展部分

NVMe

表示 NVMe 密码。有关详细信息，请参阅联想扩展部分

mechanism

身份验证的方式。此属性是必需的。支持的类型为“password”或“certificate”。

max_password_length

一个可以读取的文件，用于获取密码的最大长度

min_password_length

一个可以读取的文件，用于获取密码的最小长度

current_password

一个只写值，用于特权访问，例如在设置系统或管理员密码时设置属性或重置为新密码

当 mechanism == “password” 时，此属性是必需的。

new_password

一个只写值，与 current_password 一起使用时将重置系统或管理员密码。

请注意，密码管理是会话特定的。如果设置了管理员密码，则必须将相同的密码写入 current_password 文件（密码验证所需），并且必须在会话结束后清除。例如

echo "password" > current_password
echo "disabled" > TouchScreen/current_value
echo "" > current_password

当设置或取消设置密码时，驱动程序可能会发出 CHANGE uevent，用户空间可以再次检查它。

在戴尔、联想和惠普系统中，如果设置了管理员密码，则所有 BIOS 属性都需要密码验证。在联想系统中，如果您更改管理员密码，则新密码在下次启动之前不会生效。

联想特定的类扩展

在联想系统中，可以使用以下其他设置

角色：system-mgmt 这提供了与 bios-admin 密码相同的权限来控制

安全相关功能。分配的权限可以通过 BIOS 菜单 SMP 访问控制策略设置

角色：HDD 和 NVMe 此密码用于解锁启动时对驱动器的访问。请注意，请参阅

下面的“level”和“index”扩展。

lenovo_encoding

所使用的编码方法。可以是“ascii”或“scancode”。默认为“ascii”

lenovo_kbdlang

所使用的键盘语言方法。这通常是一个两位代码（例如“us”、“fr”、“gr”），并且可能因平台而异。默认设置为“us”

level

可用于 HDD 和 NVMe 身份验证以设置“用户”或“主”特权级别。如果仅配置了用户密码，则应使用此密码在启动时解锁驱动器。如果同时设置了主密码和用户密码，则可以使用其中任何一个。如果设置了主密码，则需要用户密码。此属性默认为“用户”级别

index

与 HDD 和 NVME 身份验证一起使用，以设置正在引用的驱动器索引（例如 hdd1、hdd2 等）。此属性默认为设备 1。

certificate, signature, save_signature

这些属性用于基于证书的身份验证。它与签名服务器结合使用，作为基于密码的身份验证的替代方案。用户使用从签名服务器获得的 BASE64 编码字符串写入属性。可以显示这些属性以检查存储的值。

一些使用示例

安装证书以启用功能

echo "supervisor password" > authentication/Admin/current_password
echo "signed certificate" > authentication/Admin/certificate

更新已安装的证书

echo "signature" > authentication/Admin/signature
echo "signed certificate" > authentication/Admin/certificate

删除已安装的证书

echo "signature" > authentication/Admin/signature
echo "" > authentication/Admin/certificate

更改 BIOS 设置

echo "signature" > authentication/Admin/signature
echo "save signature" > authentication/Admin/save_signature
echo Enable > attribute/PasswordBeep/current_value

如果未设置主管密码，则无法启用证书身份验证。清除证书会导致不配置任何 bios-admin 身份验证方法，允许任何人进行更改。在完成这些操作中的任何一项后，系统必须重新启动才能使更改生效。从 2025 年的系统开始支持管理员和系统证书。

certificate_thumbprint

只读属性，用于显示 BIOS 中安装的证书的 MD5、SHA1 和 SHA256 指纹。

certificate_to_password

只写属性，用于从基于证书的身份验证切换回基于密码的身份验证。用法

echo "signature" > authentication/Admin/signature
echo "password" > authentication/Admin/certificate_to_password

HP 特定类扩展

在惠普系统中，可以使用以下其他设置

角色：enhanced-bios-auth

此角色特定于安全平台管理 (SPM) 属性。它需要配置认可 (kek) 和签名证书 (sk)。

/sys/class/firmware-attributes/*/authentication/SPM/kek

在文件 sysfs-class-firmware-attributes 中定义

“kek”密钥加密密钥是一个只写文件，可用于配置 BIOS 在设置签名密钥时用来验证签名的 RSA 公钥。写入时，字节应与 KEK 证书（包含 OU 的 x509 .DER 格式）相对应。证书的大小必须小于或等于 4095 字节。

/sys/class/firmware-attributes/*/authentication/SPM/sk

在文件 sysfs-class-firmware-attributes 中定义

“sk”签名密钥是一个只写文件，可用于配置 BIOS 在配置 BIOS 设置和安全功能时用来验证签名的 RSA 公钥。写入时，字节应与公钥的模数相对应。指数假定为 0x10001。

/sys/class/firmware-attributes/*/authentication/SPM/status

在文件 sysfs-class-firmware-attributes 中定义

“status”是一个只读文件，以 JSON 格式返回报告状态信息的 ASCII 文本。

“State”: “未配置 | 已配置 | 正在配置”, “Version”: “Major.Minor”, “Nonce”: <以 10 为基数显示的 16 位无符号数字>, “FeaturesInUse”: <以 10 为基数显示的 16 位无符号数字>, “EndorsementKeyMod”: “<以 base64 编码的 256 字节>”, “SigningKeyMod”: “<以 base64 编码的 256 字节>”

/sys/class/firmware/.../cancel

在文件 sysfs-class-firmware 中定义

只写。对于固件上传，向此文件写入“1”以请求取消将固件数据传输到较低级别的设备。如果无法取消更新（例如，FLASH 写入正在进行中），则此请求将被拒绝 (EBUSY)，或者如果没有正在进行的固件更新，则会被拒绝 (ENODEV)。

/sys/class/firmware/.../data

在文件 sysfs-class-firmware 中定义

data sysfs 文件用于固件回退和固件上传。在您向 loading sysfs 文件回显 1 后，将固件映像 cat 到此 sysfs 文件。当固件映像写入完成时，向 loading sysfs 文件回显 0。此序列将发出固件写入完成的信号，并向较低级别的驱动程序发出固件数据可用的信号。

/sys/class/firmware/.../error

在文件 sysfs-class-firmware 中定义

只读。返回一个描述失败的固件上传的字符串。此字符串的格式为 <STATUS>:<ERROR>，其中 <STATUS> 将是 status sysfs 文件描述的状态字符串之一，而 <ERROR> 将是以下之一：“hw-error”、“timeout”、“user-abort”、“device-busy”、“invalid-file-size”、“read-write-error”、“flash-wearout”。仅当当前固件上传状态为“idle”时，error sysfs 文件才有意义。如果在固件传输正在进行时读取此文件，则读取将失败并显示 EBUSY。

/sys/class/firmware/.../loading

在文件 sysfs-class-firmware 中定义

loading sysfs 文件用于固件回退和固件上传。将 1 回显到 loading 文件上，以指示您正在将固件文件写入 data sysfs 节点。将 -1 回显到此文件上以中止数据写入，或将 0 回显到此文件上以指示写入已完成。对于固件上传，零值还会触发将固件数据传输到较低级别的设备驱动程序。

/sys/class/firmware/.../remaining_size

在文件 sysfs-class-firmware 中定义

只读。对于固件上传，此文件包含剩余的要传输到较低级别设备驱动程序的固件数据大小。该大小值初始化为先前写入数据 sysfs 文件的固件映像的完整大小。此值在固件上传的“传输中”阶段定期更新。格式：“%u”。

/sys/class/firmware/.../status

在文件 sysfs-class-firmware 中定义

只读。返回一个描述固件上传当前状态的字符串。该字符串将是以下之一：idle（空闲）、“receiving”（接收中）、“preparing”（准备中）、“transferring”（传输中）、“programming”（编程中）。

/sys/class/firmware/.../timeout

在文件 sysfs-class-firmware 中定义

此文件支持固件回退的超时机制。此文件对固件上传没有影响。有关超时的更多信息，请参阅固件回退的文档。

/sys/class/fpga_bridge/<bridge>/name

定义在文件 sysfs-class-fpga-bridge

底层 FPGA 桥接驱动程序的名称。

/sys/class/fpga_bridge/<bridge>/state

定义在文件 sysfs-class-fpga-bridge

显示桥接状态为“enabled”（已启用）或“disabled”（已禁用）

/sys/class/fpga_manager/<fpga>/name

定义在文件 sysfs-class-fpga-manager

底层 fpga 管理器驱动程序的名称。

/sys/class/fpga_manager/<fpga>/state

定义在文件 sysfs-class-fpga-manager

以字符串形式读取 fpga 管理器的状态。目的是提供足够的详细信息，以便如果在 FPGA 编程期间发生错误（驱动程序无法修复的错误），则用户空间可以知道，例如，如果固件请求失败，则可能是因为无法找到固件文件。

这是 FPGA 状态和 fpga 管理器驱动程序状态的超集。fpga 管理器驱动程序正在逐步完成这些步骤，以使 FPGA 进入已知的工作状态。这是一个序列，尽管某些步骤可能会被跳过。有效的 FPGA 状态因制造商而异；这是一个超集。

  • unknown = 无法确定状态

  • power off = FPGA 电源已关闭

  • power up = FPGA 报告电源已开启

  • reset = FPGA 保持在复位状态

  • firmware request = 固件类请求正在进行中

  • firmware request error = 固件请求失败

  • write init = 准备 FPGA 进行编程

  • write init error = 准备 FPGA 进行编程时出错

  • write = FPGA 已准备好接收映像数据

  • write error = 编程时出错

  • write complete = 正在执行编程后步骤

  • write complete error = 执行编程后步骤时出错

  • operating = FPGA 已编程并正在运行

/sys/class/fpga_manager/<fpga>/status

定义在文件 sysfs-class-fpga-manager

以字符串形式读取 fpga 管理器的状态。如果 FPGA 编程操作失败，可能是由于 crc 错误或不兼容的比特流映像导致的。此接口的目的是为用户空间提供有关 FPGA 编程错误的更详细信息。这是受支持的状态的字符串列表。

  • reconfig operation error - 检测到无效操作

    重新配置硬件。例如，在未清除错误的情况下开始重新配置

  • reconfig CRC error - 检测到 CRC 错误

    重新配置硬件。

  • reconfig incompatible image - 重新配置映像与

    硬件不兼容

  • reconfig IP protocol error - 检测到协议错误

    重新配置硬件

  • reconfig fifo overflow error - 检测到 FIFO 溢出

    重新配置硬件

/sys/class/fpga_region/<region>/compat_id

定义在文件 sysfs-class-fpga-region

用于兼容性检查的 FPGA 区域 ID，例如，FPGA 重新配置硬件和映像的兼容性。此值由创建 FPGA 区域的层定义或计算。如果未使用 compat_id，则此接口返回 compat_id 值或仅返回错误代码 -ENOENT。

/sys/class/genwqe/genwqe<n>_card/appid

定义在文件 sysfs-driver-genwqe

标识当前活动的卡应用程序，例如用于压缩/解压缩的 'GZIP'。

/sys/class/genwqe/genwqe<n>_card/base_clock

定义在文件 sysfs-driver-genwqe

卡的基准时钟频率。

/sys/class/genwqe/genwqe<n>_card/curr_bitstream

定义在文件 sysfs-driver-genwqe

当前活动的比特流。1 是默认值，0 是备份。

/sys/class/genwqe/genwqe<n>_card/device/sriov_numvfs

定义在文件 sysfs-driver-genwqe

启用 VF (1..15)

sudo sh -c 'echo 15 > \
  /sys/bus/pci/devices/0000\:1b\:00.0/sriov_numvfs'

禁用 VF

Write a 0 into the same sysfs entry.

/sys/class/genwqe/genwqe<n>_card/freerunning_timer

定义在文件 sysfs-driver-genwqe

读取卡自由运行定时器的接口。用于性能和利用率测量。

/sys/class/genwqe/genwqe<n>_card/next_bitstream

定义在文件 sysfs-driver-genwqe

用于设置要使用的下一个比特流的接口。

/sys/class/genwqe/genwqe<n>_card/queue_working_time

定义在文件 sysfs-driver-genwqe

读取队列工作时间的接口。用于性能和利用率测量。

/sys/class/genwqe/genwqe<n>_card/reload_bitstream

定义在文件 sysfs-driver-genwqe

用于触发 PCIe 卡重置以重新加载比特流的接口。

sudo sh -c 'echo 1 > \
  /sys/class/genwqe/genwqe0_card/reload_bitstream'

如果成功，卡将使用在“next_bitstream”上设置的比特流返回。

/sys/class/genwqe/genwqe<n>_card/state

定义在文件 sysfs-driver-genwqe

卡的状态：“unused”（未使用）、“used”（已使用）、“error”（错误）。

/sys/class/genwqe/genwqe<n>_card/tempsens

定义在文件 sysfs-driver-genwqe

读取卡的温度感应寄存器的接口。

/sys/class/genwqe/genwqe<n>_card/type

定义在文件 sysfs-driver-genwqe

卡的类型，例如 'GenWQE5-A7'。

/sys/class/genwqe/genwqe<n>_card/version

定义在文件 sysfs-driver-genwqe

唯一的比特流标识，例如 '0000000330336283.00000000475a4950'。

/sys/class/gnss/gnss<N>/type

定义在文件 sysfs-class-gnss

GNSS 接收器类型。当前标识的类型反映了接收器支持的协议

“NMEA”

NMEA 0183

“SiRF”

SiRF 二进制

“UBX”

UBX

请注意，非“NMEA”类型的接收器通常也支持带有供应商扩展的 NMEA 0183 子集（例如，允许切换到供应商协议）。

/sys/class/hwmon/hwmonX/cpuY_vid

定义在文件 sysfs-class-hwmon

CPU 核心参考电压。

单位：毫伏

只读

并非总是正确。

/sys/class/hwmon/hwmonX/currY_average

定义在文件 sysfs-class-hwmon

平均电流使用量

单位：毫安

只读

/sys/class/hwmon/hwmonX/currY_crit

定义在文件 sysfs-class-hwmon

电流临界高值。

单位：毫安

读写

/sys/class/hwmon/hwmonX/currY_enable

定义在文件 sysfs-class-hwmon

启用或禁用传感器。

禁用后，传感器读取将返回 -ENODATA。

  • 1：启用

  • 0：禁用

读写

/sys/class/hwmon/hwmonX/currY_highest

定义在文件 sysfs-class-hwmon

历史最大电流 单位：毫安 只读

/sys/class/hwmon/hwmonX/currY_input

定义在文件 sysfs-class-hwmon

电流输入值

单位：毫安

只读

/sys/class/hwmon/hwmonX/currY_lcrit

定义在文件 sysfs-class-hwmon

电流临界低值

单位：毫安

读写

/sys/class/hwmon/hwmonX/currY_lowest

定义在文件 sysfs-class-hwmon

历史最小电流

单位：毫安

只读

/sys/class/hwmon/hwmonX/currY_max

定义在文件 sysfs-class-hwmon

电流最大值

单位：毫安

读写

/sys/class/hwmon/hwmonX/currY_min

定义在文件 sysfs-class-hwmon

电流最小值。

单位：毫安

读写

/sys/class/hwmon/hwmonX/currY_rated_max

定义在文件 sysfs-class-hwmon

最大额定电流。

单位：毫安

只读

/sys/class/hwmon/hwmonX/currY_rated_min

定义在文件 sysfs-class-hwmon

最小额定电流。

单位：毫安

只读

/sys/class/hwmon/hwmonX/currY_reset_history

定义在文件 sysfs-class-hwmon

重置 currX_lowest 和 currX_highest

只写

/sys/class/hwmon/hwmonX/curr_reset_history

定义在文件 sysfs-class-hwmon

重置所有传感器的 currX_lowest 和 currX_highest

只写

/sys/class/hwmon/hwmonX/device/pec

定义在文件 sysfs-class-hwmon

I2C 设备上的 PEC 支持

  • 0，关闭，n：禁用

  • 1，开启，y：启用

读写

/sys/class/hwmon/hwmonX/energyY_enable

定义在文件 sysfs-class-hwmon

启用或禁用传感器。

禁用后，传感器读取将返回 -ENODATA。

  • 1：启用

  • 0：禁用

读写

/sys/class/hwmon/hwmonX/energyY_input

定义在文件 sysfs-class-hwmon

累积能量使用量

单位：微焦耳

只读

/sys/class/hwmon/hwmonX/fanY_div

定义在文件 sysfs-class-hwmon

风扇分频器。

2 的幂的整数值（1、2、4、8、16、32、64、128）。

读写

某些芯片仅支持值 1、2、4 和 8。请注意，这实际上是一个内部时钟分频器，它会影响可测量的速度范围，而不是读取值。

/sys/class/hwmon/hwmonX/fanY_enable

定义在文件 sysfs-class-hwmon

启用或禁用传感器。

禁用后，传感器读取将返回 -ENODATA。

  • 1：启用

  • 0：禁用

读写

/sys/class/hwmon/hwmonX/fanY_fault

定义在文件 sysfs-class-hwmon

报告风扇是否报告故障。

  • 1：故障

  • 0：正常

只读

/sys/class/hwmon/hwmonX/fanY_input

定义在文件 sysfs-class-hwmon

风扇输入值。

单位：转/分钟 (RPM)

只读

/sys/class/hwmon/hwmonX/fanY_label

定义在文件 sysfs-class-hwmon

建议的风扇通道标签。

文本字符串

仅当驱动程序有关于此风扇通道用途的提示，而用户空间没有时才应创建。在所有其他情况下，标签由用户空间提供。

只读

/sys/class/hwmon/hwmonX/fanY_max

定义在文件 sysfs-class-hwmon

风扇最大值

单位：转/分钟 (RPM)

硬件很少支持。读写

/sys/class/hwmon/hwmonX/fanY_min

定义在文件 sysfs-class-hwmon

风扇最小值

单位：转/分钟 (RPM)

读写

/sys/class/hwmon/hwmonX/fanY_pulses

定义在文件 sysfs-class-hwmon

每个风扇转数的转速计脉冲数。

整数值，通常在 1 到 4 之间。

读写

此值是连接到设备输入的风扇的特性，因此必须根据风扇型号进行设置。

仅当芯片具有配置脉冲数的寄存器时才应创建。在没有此类寄存器（以及属性）的情况下，所有设备假定的值是每个风扇转数 2 个脉冲。

/sys/class/hwmon/hwmonX/fanY_target

定义在文件 sysfs-class-hwmon

所需风扇速度

单位：转/分钟 (RPM)

读写

仅当芯片支持基于测量的风扇速度的闭环风扇速度控制时才有意义。

/sys/class/hwmon/hwmonX/humidityY_alarm

定义在文件 sysfs-class-hwmon

湿度限制检测

  • 0：正常

  • 1：已达到湿度限制

只读

/sys/class/hwmon/hwmonX/humidityY_enable

定义在文件 sysfs-class-hwmon

启用或禁用传感器

禁用后，传感器读取将返回 -ENODATA。

  • 1：启用

  • 0：禁用

读写

/sys/class/hwmon/hwmonX/humidityY_fault

定义在文件 sysfs-class-hwmon

报告湿度传感器故障。

  • 1：故障

  • 0：正常

只读

/sys/class/hwmon/hwmonX/humidityY_input

定义在文件 sysfs-class-hwmon

湿度

单位：千分比（每百分之一，pcm）

只读

/sys/class/hwmon/hwmonX/humidityY_label

定义在文件 sysfs-class-hwmon

建议的湿度通道标签。

文本字符串

仅当驱动程序有关于此湿度通道用途的提示，而用户空间没有时才应创建。在所有其他情况下，标签由用户空间提供。

只读

/sys/class/hwmon/hwmonX/humidityY_max

定义在文件 sysfs-class-hwmon

湿度最大值。

单位：千分比（每百分之一，pcm）

读写

/sys/class/hwmon/hwmonX/humidityY_max_alarm

定义在文件 sysfs-class-hwmon

最大湿度检测

  • 0：正常

  • 1：检测到最大湿度

只读

/sys/class/hwmon/hwmonX/humidityY_max_hyst

定义在文件 sysfs-class-hwmon

最大限制的湿度滞后值。

单位：千分比（每百分之一，pcm）

必须报告为绝对湿度，而不是最大值的增量。

读写

/sys/class/hwmon/hwmonX/humidityY_min

定义在文件 sysfs-class-hwmon

湿度最小值。

单位：千分比（每百分之一，pcm）

读写

/sys/class/hwmon/hwmonX/humidityY_min_alarm

定义在文件 sysfs-class-hwmon

最小湿度检测

  • 0：正常

  • 1：检测到最小湿度

只读

/sys/class/hwmon/hwmonX/humidityY_min_hyst

定义在文件 sysfs-class-hwmon

最小限制的湿度滞后值。

单位：千分比（每百分之一，pcm）

必须报告为绝对湿度，而不是最小值的增量。

读写

/sys/class/hwmon/hwmonX/humidityY_rated_max

定义在文件 sysfs-class-hwmon

最大额定湿度。

单位：千分比（每百分之一，pcm）

只读

/sys/class/hwmon/hwmonX/humidityY_rated_min

定义在文件 sysfs-class-hwmon

最小额定湿度。

单位：千分比（每百分之一，pcm）

只读

/sys/class/hwmon/hwmonX/inY_average

定义在文件 sysfs-class-hwmon

平均电压

单位：毫伏

只读

/sys/class/hwmon/hwmonX/inY_crit

定义在文件 sysfs-class-hwmon

电压临界最大值。

单位：毫伏

读写

如果电压达到或超过此限制，系统可能会采取强制措施，例如断电或重置。至少，它应报告故障。

/sys/class/hwmon/hwmonX/inY_enable

定义在文件 sysfs-class-hwmon

启用或禁用传感器。

禁用后，传感器读取将返回 -ENODATA。

  • 1：启用

  • 0：禁用

读写

/sys/class/hwmon/hwmonX/inY_fault

定义在文件 sysfs-class-hwmon

报告电压硬故障（例如：短路组件）

  • 1：故障

  • 0：正常

只读

/sys/class/hwmon/hwmonX/inY_highest

定义在文件 sysfs-class-hwmon

历史最大电压

单位：毫伏

只读

/sys/class/hwmon/hwmonX/inY_input

定义在文件 sysfs-class-hwmon

电压输入值。

单位：毫伏

只读

在芯片引脚上测得的电压。

实际电压取决于主板上的比例电阻，如芯片数据手册中建议的那样。

这因芯片和主板而异。由于这种差异，值通常不由芯片驱动程序缩放，而必须由应用程序完成。但是，由于芯片中内置的内部电阻，某些驱动程序（特别是 lm87 和 via686a）会进行缩放。这些驱动程序将输出实际电压。经验法则：驱动程序应报告芯片“引脚”处的电压值。

/sys/class/hwmon/hwmonX/inY_label

定义在文件 sysfs-class-hwmon

建议的电压通道标签。

文本字符串

仅当驱动程序有关于此电压通道用途的提示，而用户空间没有时才应创建。在所有其他情况下，标签由用户空间提供。

只读

/sys/class/hwmon/hwmonX/inY_lcrit

定义在文件 sysfs-class-hwmon

电压临界最小值。

单位：毫伏

读写

如果电压降至或低于此限制，系统可能会采取诸如断电或重置等极端措施。至少，它应该报告故障。

/sys/class/hwmon/hwmonX/inY_lowest

定义在文件 sysfs-class-hwmon

历史最低电压

单位：毫伏

只读

/sys/class/hwmon/hwmonX/inY_max

定义在文件 sysfs-class-hwmon

电压最大值。

单位：毫伏

读写

/sys/class/hwmon/hwmonX/inY_min

定义在文件 sysfs-class-hwmon

电压最小值。

单位：毫伏

读写

/sys/class/hwmon/hwmonX/inY_rated_max

定义在文件 sysfs-class-hwmon

额定最大电压。

单位：毫伏

只读

/sys/class/hwmon/hwmonX/inY_rated_min

定义在文件 sysfs-class-hwmon

额定最小电压。

单位：毫伏

只读

/sys/class/hwmon/hwmonX/inY_reset_history

定义在文件 sysfs-class-hwmon

重置 inX_lowest 和 inX_highest

只写

/sys/class/hwmon/hwmonX/in_reset_history

定义在文件 sysfs-class-hwmon

重置所有传感器的 inX_lowest 和 inX_highest

只写

/sys/class/hwmon/hwmonX/intrusionY_alarm

定义在文件 sysfs-class-hwmon

机箱入侵检测

  • 0：正常

  • 1：检测到入侵

读写

与读取时会自动清除的常规警报标志相反，此标志会一直保持，直到用户清除为止。这是通过向文件写入 0 来完成的。不支持写入其他值。

/sys/class/hwmon/hwmonX/intrusionY_beep

定义在文件 sysfs-class-hwmon

机箱入侵蜂鸣

  • 0：禁用

  • 1：启用

读写

/sys/class/hwmon/hwmonX/label

定义在文件 sysfs-class-hwmon

一个描述性标签，允许在系统中唯一标识一个设备。标签的内容是自由形式的。

只读

/sys/class/hwmon/hwmonX/name

定义在文件 sysfs-class-hwmon

芯片名称。这应该是一个简短的小写字符串，不包含空格、破折号或通配符“*”。此属性表示芯片名称。它是唯一强制性属性。I2C 设备会自动创建此属性。

只读

/sys/class/hwmon/hwmonX/powerY_accuracy

定义在文件 sysfs-class-hwmon

功率表的精度。

单位：百分比

只读

/sys/class/hwmon/hwmonX/powerY_average

定义在文件 sysfs-class-hwmon

平均功耗

单位：微瓦

只读

/sys/class/hwmon/hwmonX/powerY_average_highest

定义在文件 sysfs-class-hwmon

历史平均最大功耗

单位：微瓦

只读

/sys/class/hwmon/hwmonX/powerY_average_interval

定义在文件 sysfs-class-hwmon

功耗平均间隔。如果硬件更改了平均间隔，则会向此文件发送轮询通知。

单位：毫秒

读写

/sys/class/hwmon/hwmonX/powerY_average_interval_max

定义在文件 sysfs-class-hwmon

最大功耗平均间隔

单位：毫秒

只读

/sys/class/hwmon/hwmonX/powerY_average_interval_min

定义在文件 sysfs-class-hwmon

最小功耗平均间隔

单位：毫秒

只读

/sys/class/hwmon/hwmonX/powerY_average_lowest

定义在文件 sysfs-class-hwmon

历史平均最小功耗

单位：微瓦

只读

/sys/class/hwmon/hwmonX/powerY_average_max

定义在文件 sysfs-class-hwmon

当功耗高于此值时，会向powerY_average发送轮询通知。

单位：微瓦

读写

/sys/class/hwmon/hwmonX/powerY_average_min

定义在文件 sysfs-class-hwmon

当功耗低于此值时，会向powerY_average发送轮询通知。

单位：微瓦

读写

/sys/class/hwmon/hwmonX/powerY_cap

定义在文件 sysfs-class-hwmon

如果功耗高于此限制，系统应采取措施降低功耗。如果硬件更改了上限，则会向此文件发送轮询通知。*_cap文件仅在已知上限由硬件强制执行时才会出现。

单位：微瓦

读写

/sys/class/hwmon/hwmonX/powerY_cap_hyst

定义在文件 sysfs-class-hwmon

围绕上限和通知建立的迟滞裕量。

单位：微瓦

读写

/sys/class/hwmon/hwmonX/powerY_cap_max

定义在文件 sysfs-class-hwmon

可以设置的最大上限。

单位：微瓦

只读

/sys/class/hwmon/hwmonX/powerY_cap_min

定义在文件 sysfs-class-hwmon

可以设置的最小上限。

单位：微瓦

只读

/sys/class/hwmon/hwmonX/powerY_crit

定义在文件 sysfs-class-hwmon

临界最大功率。

如果功率上升到或高于此限制，则预期系统会采取极端措施来降低功耗，例如系统关闭或某些设备的强制断电。

单位：微瓦

读写

/sys/class/hwmon/hwmonX/powerY_enable

定义在文件 sysfs-class-hwmon

启用或禁用传感器。

禁用后，传感器读取将返回 -ENODATA。

  • 1：启用

  • 0：禁用

读写

/sys/class/hwmon/hwmonX/powerY_input

定义在文件 sysfs-class-hwmon

瞬时功耗

单位：微瓦

只读

/sys/class/hwmon/hwmonX/powerY_input_highest

定义在文件 sysfs-class-hwmon

历史最大功耗

单位：微瓦

只读

/sys/class/hwmon/hwmonX/powerY_input_lowest

定义在文件 sysfs-class-hwmon

历史最小功耗

单位：微瓦

只读

/sys/class/hwmon/hwmonX/powerY_max

定义在文件 sysfs-class-hwmon

最大功率。

单位：微瓦

读写

/sys/class/hwmon/hwmonX/powerY_rated_max

定义在文件 sysfs-class-hwmon

额定最大功率。

单位：微瓦

只读

/sys/class/hwmon/hwmonX/powerY_rated_min

定义在文件 sysfs-class-hwmon

额定最小功率。

单位：微瓦

只读

/sys/class/hwmon/hwmonX/powerY_reset_history

定义在文件 sysfs-class-hwmon

重置 input_highest、input_lowest、average_highest 和 average_lowest。

只写

/sys/class/hwmon/hwmonX/pwmY

定义在文件 sysfs-class-hwmon

脉冲宽度调制风扇控制。

0 到 255 范围内的整数值

读写

255 是最大值或 100%。

/sys/class/hwmon/hwmonX/pwmY_auto_channels_temp

定义在文件 sysfs-class-hwmon

选择在自动模式下影响此 PWM 输出的温度通道。

位字段，1 是 temp1，2 是 temp2，4 是 temp3 等...哪些值是可能的取决于所使用的芯片。

读写

/sys/class/hwmon/hwmonX/pwmY_auto_pointZ_pwm

/sys/class/hwmon/hwmonX/pwmY_auto_pointZ_temp

/sys/class/hwmon/hwmonX/pwmY_auto_pointZ_temp_hyst

定义在文件 sysfs-class-hwmon

定义 PWM 与温度曲线。

跳变点的数量取决于芯片。将其用于将跳变点与 PWM 输出通道相关联的芯片。

读写

/sys/class/hwmon/hwmonX/pwmY_enable

定义在文件 sysfs-class-hwmon

风扇速度控制方法

  • 0：无风扇速度控制（即风扇全速运转）

  • 1：启用手动风扇速度控制（使用pwmY）

  • 2+：启用自动风扇速度控制

有关自动模式详细信息，请查看各个芯片的文档文件。

读写

/sys/class/hwmon/hwmonX/pwmY_freq

定义在文件 sysfs-class-hwmon

基本 PWM 频率，单位为 Hz。

仅当 pwmN_mode 为 PWM 时才可能可用，但即使这样也并非总是存在。

读写

/sys/class/hwmon/hwmonX/pwmY_mode

定义在文件 sysfs-class-hwmon

  • 0：直流模式（直流电）

  • 1：PWM 模式（脉冲宽度调制）

读写

/sys/class/hwmon/hwmonX/tempY_auto_pointZ_pwm

/sys/class/hwmon/hwmonX/tempY_auto_pointZ_temp

/sys/class/hwmon/hwmonX/tempY_auto_pointZ_temp_hyst

定义在文件 sysfs-class-hwmon

定义 PWM 与温度曲线。

跳变点的数量取决于芯片。将其用于将跳变点与温度通道相关联的芯片。

读写

/sys/class/hwmon/hwmonX/tempY_crit

定义在文件 sysfs-class-hwmon

临界最大温度值，通常大于相应的 temp_max 值。

单位：毫摄氏度

读写

/sys/class/hwmon/hwmonX/tempY_crit_alarm

定义在文件 sysfs-class-hwmon

临界高温警报标志。

  • 0：正常

  • 1：温度已达到 tempY_crit

只读

/sys/class/hwmon/hwmonX/tempY_crit_hyst

定义在文件 sysfs-class-hwmon

临界限制的温度迟滞值。

单位：毫摄氏度

必须报告为绝对温度，而不是与临界值的差值。

读写

/sys/class/hwmon/hwmonX/tempY_emergency

定义在文件 sysfs-class-hwmon

紧急最大温度值，用于支持两个以上上限温度的芯片。必须等于或大于相应的 temp_crit 值。

单位：毫摄氏度

读写

/sys/class/hwmon/hwmonX/tempY_emergency_alarm

定义在文件 sysfs-class-hwmon

紧急高温警报标志。

  • 0：正常

  • 1：温度已达到 tempY_emergency

只读

/sys/class/hwmon/hwmonX/tempY_emergency_hyst

定义在文件 sysfs-class-hwmon

紧急限制的温度迟滞值。

单位：毫摄氏度

必须报告为绝对温度，而不是与紧急值的差值。

读写

/sys/class/hwmon/hwmonX/tempY_enable

定义在文件 sysfs-class-hwmon

启用或禁用传感器。

禁用后，传感器读取将返回 -ENODATA。

  • 1：启用

  • 0：禁用

读写

/sys/class/hwmon/hwmonX/tempY_highest

定义在文件 sysfs-class-hwmon

历史最高温度

单位：毫摄氏度

只读

/sys/class/hwmon/hwmonX/tempY_input

定义在文件 sysfs-class-hwmon

温度输入值。

单位：毫摄氏度

只读

/sys/class/hwmon/hwmonX/tempY_label

定义在文件 sysfs-class-hwmon

建议的温度通道标签。

文本字符串

仅当驱动程序有关于此温度通道用途的提示，而用户空间没有时才应创建。在所有其他情况下，标签由用户空间提供。

只读

/sys/class/hwmon/hwmonX/tempY_lcrit

定义在文件 sysfs-class-hwmon

临界最小温度值，通常低于相应的 temp_min 值。

单位：毫摄氏度

读写

/sys/class/hwmon/hwmonX/tempY_lcrit_hyst

定义在文件 sysfs-class-hwmon

临界最小限制的温度迟滞值。

单位：毫摄氏度

必须报告为绝对温度，而不是与临界最小值的差值。

读写

/sys/class/hwmon/hwmonX/tempY_lowest

定义在文件 sysfs-class-hwmon

历史最低温度

单位：毫摄氏度

只读

/sys/class/hwmon/hwmonX/tempY_max

定义在文件 sysfs-class-hwmon

最大温度值。

单位：毫摄氏度（或毫伏，请参见下文）

读写

/sys/class/hwmon/hwmonX/tempY_max_alarm

定义在文件 sysfs-class-hwmon

最高温度警报标志。

  • 0：正常

  • 1：温度已达到 tempY_max

只读

/sys/class/hwmon/hwmonX/tempY_max_hyst

定义在文件 sysfs-class-hwmon

最大限制的温度迟滞值。

单位：毫摄氏度

必须报告为绝对温度，而不是与最大值的差值。

读写

/sys/class/hwmon/hwmonX/tempY_min

定义在文件 sysfs-class-hwmon

最小温度值。

单位：毫摄氏度

读写

/sys/class/hwmon/hwmonX/tempY_min_alarm

定义在文件 sysfs-class-hwmon

最低温度警报标志。

  • 0：正常

  • 1：温度已达到 tempY_min

只读

/sys/class/hwmon/hwmonX/tempY_min_hyst

定义在文件 sysfs-class-hwmon

最小限制的温度迟滞值。单位：毫摄氏度

必须报告为绝对温度，而不是与最小值的差值。

读写

/sys/class/hwmon/hwmonX/tempY_offset

定义在文件 sysfs-class-hwmon

芯片添加到温度读数的温度偏移量。

单位：毫摄氏度

读/写值。

/sys/class/hwmon/hwmonX/tempY_rated_max

定义在文件 sysfs-class-hwmon

额定最大温度。

单位：毫摄氏度

只读

/sys/class/hwmon/hwmonX/tempY_rated_min

定义在文件 sysfs-class-hwmon

额定最小温度。

单位：毫摄氏度

只读

/sys/class/hwmon/hwmonX/tempY_reset_history

定义在文件 sysfs-class-hwmon

重置 temp_lowest 和 temp_highest

只写

/sys/class/hwmon/hwmonX/tempY_type

定义在文件 sysfs-class-hwmon

传感器类型选择。

整数 1 到 6

读写

  • 1：CPU 嵌入式二极管

  • 2：3904 晶体管

  • 3：热二极管

  • 4：热敏电阻

  • 5：AMD AMDSI

  • 6：Intel PECI

并非所有芯片都支持所有类型

/sys/class/hwmon/hwmonX/temp_reset_history

定义在文件 sysfs-class-hwmon

重置所有传感器的 temp_lowest 和 temp_highest

只写

/sys/class/hwmon/hwmonX/update_interval

定义在文件 sysfs-class-hwmon

芯片更新读数的间隔。单位：毫秒

读写

某些设备具有可变的更新速率或间隔。此属性可用于将其更改为所需的值。

/sys/class/hwmon/hwmonX/vrm

定义在文件 sysfs-class-hwmon

电压调节器模块版本号。

读写（但更改它应该不再必要）

最初 VRM 标准版本乘以 10，但现在是任意数字，因为并非所有标准都有版本号。

影响驱动程序从 vid 引脚计算 CPU 内核参考电压的方式。

/sys/class/input/input(x)/device/function_row_physmap

在文件sysfs-driver-input-cros-ec-keyb中定义

顶行按键的扫描码的空格分隔列表，按按键的物理位置从左到右排序。

/sys/class/input/input(x)/device/shutdown

在文件sysfs-driver-input-axp-pek中定义

关机时间，单位为微秒。如果按下按钮的时间超过 <shutdown_time>，则电路板断电

/sys/class/input/input(x)/device/startup

在文件sysfs-driver-input-axp-pek中定义

启动时间，单位为微秒。如果按下按钮的时间超过 <startup_time>，则电路板通电

/sys/class/intel_pmt/

在文件sysfs-class-intel_pmt中定义

intel_pmt/ 类目录包含使用英特尔平台监控技术 (PMT) 公开硬件遥测的设备的信息。

/sys/class/intel_pmt/crashlog<x>

在文件sysfs-class-intel_pmt中定义

crashlog<x> 目录包含用于配置 PMT 崩溃日志设备实例的文件，该设备可以执行崩溃数据记录。每个 crashlog<x> 设备都有一个关联的崩溃日志文件。可以打开并映射或读取此文件以访问生成的崩溃日志缓冲区。缓冲区的寄存器布局可以从父设备的指定 GUID 的 XML 文件中确定。

/sys/class/intel_pmt/crashlog<x>/crashlog

在文件sysfs-class-intel_pmt中定义

（只读）此崩溃日志设备的崩溃日志缓冲区。可以映射或读取此文件以获取数据。

/sys/class/intel_pmt/crashlog<x>/enable

在文件sysfs-class-intel_pmt中定义

（读写）控制是否为崩溃日志设备启用崩溃日志功能的布尔值。

/sys/class/intel_pmt/crashlog<x>/guid

在文件sysfs-class-intel_pmt中定义

（只读）此崩溃日志设备的 GUID。GUID 标识应使用的父设备的 XML 文件版本，以确定寄存器布局。

/sys/class/intel_pmt/crashlog<x>/offset

在文件sysfs-class-intel_pmt中定义

（只读）缓冲区中与崩溃日志设备的映射对应的字节偏移量。

/sys/class/intel_pmt/crashlog<x>/size

在文件sysfs-class-intel_pmt中定义

（只读）结果缓冲区的长度（以字节为单位），它对应于崩溃日志缓冲区的大小。

/sys/class/intel_pmt/crashlog<x>/trigger

在文件sysfs-class-intel_pmt中定义

（读写）控制崩溃日志设备节点触发的布尔值。读取时，它提供有关崩溃日志是否已被触发的数据。写入时，可以使用它来清除当前触发器（写入 false），或者在当前未设置触发器时触发新事件。

/sys/class/intel_pmt/telem<x>

在文件sysfs-class-intel_pmt中定义

telem<x> 目录包含描述公开硬件遥测的 PMT 遥测设备实例的文件。每个 telem<x> 目录都有一个关联的 telem 文件。可以打开并映射或读取此文件以访问设备的遥测空间。遥测空间的寄存器布局由与设备的 PCI 设备 ID 和 GUID 匹配的 XML 文件确定。

/sys/class/intel_pmt/telem<x>/guid

在文件sysfs-class-intel_pmt中定义

（只读）此遥测设备的 GUID。GUID 标识用于获取寄存器布局的父设备的 XML 文件版本。

/sys/class/intel_pmt/telem<x>/offset

在文件sysfs-class-intel_pmt中定义

（只读）遥测区域中与 telem 文件的映射对应的字节偏移量。

/sys/class/intel_pmt/telem<x>/size

在文件sysfs-class-intel_pmt中定义

（只读）遥测区域的大小（以字节为单位），它对应于 telem 文件的映射大小。

/sys/class/intel_pmt/telem<x>/telem

在文件sysfs-class-intel_pmt中定义

（只读）此遥测设备的遥测数据。可以映射或读取此文件以获取数据。

/sys/class/iommu/<iommu>/amd-iommu/cap

在文件 sysfs-class-iommu-amd-iommu 中定义

AMD IOMMU 规范中记录的 IOMMU 功能头。格式：%x

/sys/class/iommu/<iommu>/amd-iommu/features

在文件 sysfs-class-iommu-amd-iommu 中定义

IOMMU 的扩展功能。格式：%llx

/sys/class/iommu/<iommu>/devices/

在文件 sysfs-class-iommu 中定义

IOMMU 驱动程序能够在此处链接由给定 IOMMU 管理的设备，以允许将 IOMMU 与设备关联。

/sys/class/iommu/<iommu>/intel-iommu/address

在文件 sysfs-class-iommu-intel-iommu 中定义

此 IOMMU 的 VT-d DRHD 的物理地址。格式：%llx。这允许将 sysfs intel-iommu 与 DMAR DRHD 表条目关联。

/sys/class/iommu/<iommu>/intel-iommu/cap

在文件 sysfs-class-iommu-intel-iommu 中定义

此 DRHD 单元的缓存硬件功能寄存器值。格式：%llx。

/sys/class/iommu/<iommu>/intel-iommu/ecap

在文件 sysfs-class-iommu-intel-iommu 中定义

此 DRHD 单元的缓存硬件扩展功能寄存器值。格式：%llx。

/sys/class/iommu/<iommu>/intel-iommu/version

在文件 sysfs-class-iommu-intel-iommu 中定义

从 VT-d VER_REG 报告的架构版本。格式：%d:%d，主版本：次版本

/sys/class/lcd/<lcd>/contrast

在文件 sysfs-class-lcd 中定义

此 LCD 设备的当前对比度。值介于 0 和 /sys/class/lcd/<lcd>/max_contrast 之间。

/sys/class/lcd/<lcd>/lcd_power

在文件 sysfs-class-lcd 中定义

控制 LCD 电源，值来自 fb.h 的 FB_BLANK_*

  • FB_BLANK_UNBLANK (0)：电源开启。

  • FB_BLANK_POWERDOWN (4)：电源关闭

/sys/class/lcd/<lcd>/max_contrast

在文件 sysfs-class-lcd 中定义

此 LCD 设备的最大对比度。

/sys/class/leds/<led>/als_channel

在文件 sysfs-class-led-driver-lm3533 中定义

设置要在 ALS 电流控制模式 (1, 2) 中用作输入的 ALS 输出通道，其中

1

out_current1

2

out_current2

/sys/class/leds/<led>/als_en

在文件 sysfs-class-led-driver-lm3533 中定义

启用 ALS 电流控制模式 (0, 1)。

/sys/class/leds/<led>/brightness

在文件 sysfs-class-led 中定义

设置 LED 的亮度。

大多数 LED 没有硬件亮度支持，因此对于非零亮度设置，只会打开。

注意

对于多色 LED，写入此文件会将组中的所有 LED 更新为每个颜色 LED 强度设置的计算百分比。

通过以下公式为每个分组的 LED 计算百分比

led_brightness = brightness * multi_intensity/max_brightness

有关更多详细信息，请参阅 Linux 下的多色 LED 处理。

该值介于 0 和 /sys/class/leds/<led>/max_brightness 之间。

将 0 写入此文件会清除活动触发器。

当触发器处于活动状态时，将非零值写入此文件会更改触发器将使用的最大亮度。

/sys/class/leds/<led>/brightness_hw_changed

在文件 sysfs-class-led 中定义

此 LED 的上次硬件设置的亮度级别。某些 LED 可能会由硬件/固件自主更改。只有发生这种情况且驱动程序可以检测到的 LED 才会有此文件。

此文件支持 poll() 以检测硬件何时更改亮度。

读取此文件将返回硬件设置的上次亮度级别，这可能与当前亮度不同。当没有发生硬件亮度更改事件时，读取此文件将返回 ENODATA 错误。

/sys/class/leds/<led>/delay_off

在文件 sysfs-class-led-trigger-oneshot 中定义

指定 LED 在被激活后必须保持在 LED_OFF 亮度多少毫秒。默认为 100 毫秒。

/sys/class/leds/<led>/delay_on

在文件 sysfs-class-led-trigger-oneshot 中定义

指定 LED 在被激活后必须保持在 LED_FULL 亮度多少毫秒。默认为 100 毫秒。

/sys/class/leds/<led>/device/brightness

在文件 sysfs-class-led-driver-turris-omnia 中定义

（读写）在 Turris Omnia 路由器的前面板上，还有一个按钮可用于一次控制所有 LED 的强度，以便在它们太亮时，用户可以调暗它们。

微控制器在此全局亮度的 8 个级别之间循环（从 100% 到 0%），但此设置可以具有 0 到 100 之间的任何整数值。因此，能够从软件更改此设置很方便。

格式：%i

/sys/class/leds/<led>/device/gamma_correction

在文件 sysfs-class-led-driver-turris-omnia 中定义

（读写）Turris Omnia 路由器的较新版本微控制器固件支持 RGB LED 的伽玛校正。可以通过写入此文件来启用/禁用此功能。

如果由于 MCU 固件太旧而不支持该功能，则该文件始终读取为 0，并且写入该文件会导致 EOPNOTSUPP 错误。

格式：%i

/sys/class/leds/<led>/device_name

在文件 sysfs-class-led-trigger-netdev 中定义

指定要监视的网络设备名称。

/sys/class/leds/<led>/dim

在文件 sysfs-class-led-driver-aw200xx 中定义

64 级 DIM 电流。如果写入负值或“auto”，则 DIM 将根据亮度计算。

/sys/class/leds/<led>/falltime

/sys/class/leds/<led>/risetime

在文件 sysfs-class-led-driver-lm3533 中定义

设置模式生成器的下降和上升时间 (0..7)，其中

0

2048 微秒

1

262 毫秒

2

524 毫秒

3

1.049 秒

4

2.097 秒

5

4.194 秒

6

8.389 秒

7

16.78 秒

/sys/class/leds/<led>/flash_brightness

在文件 sysfs-class-led-flash 中定义

读/写 以微安为单位设置闪光灯模式下此 LED 的亮度。仅为支持设置闪光灯亮度的闪光灯 LED 设备创建此文件。

该值介于 0 和 /sys/class/leds/<led>/max_flash_brightness 之间。

/sys/class/leds/<led>/flash_fault

在文件 sysfs-class-led-flash 中定义

只读 可能发生的闪光灯故障的空格分隔列表。闪光灯故障会在闪光灯闪烁后重新读取。可能的闪光灯故障

  • led-over-voltage

    闪光灯 LED 的闪光灯控制器电压已超过闪光灯控制器特定的限制

  • flash-timeout-exceeded

    当用户设置的超时时间到期时，闪光灯闪烁仍处于开启状态；并非所有闪光灯控制器都可能在所有此类条件下设置此项

  • controller-over-temperature

    闪光灯控制器已过热

  • controller-short-circuit

    闪光灯控制器的短路保护已触发

  • led-power-supply-over-current

    LED 电源中的电流已超过闪光灯控制器特定的限制

  • indicator-led-fault

    闪光灯控制器在指示灯 LED 上检测到短路或开路情况

  • led-under-voltage

    闪光灯 LED 的闪光灯控制器电压已低于闪光灯特定的最低限制

  • controller-under-voltage

    闪光灯控制器的输入电压低于无法以全电流闪烁闪光灯的限制；该条件会持续存在，直到不再设置此标志

  • led-over-temperature

    LED 的温度已超过其允许的上限

/sys/class/leds/<led>/flash_strobe

在文件 sysfs-class-led-flash 中定义

读/写 闪光灯闪烁状态。写入 1 时，会触发闪光灯闪烁，写入 0 时，会关闭闪光灯。

读取时，1 表示闪光灯当前正在闪烁，0 表示闪光灯已关闭。

/sys/class/leds/<led>/flash_timeout

在文件 sysfs-class-led-flash 中定义

读/写 闪光灯的硬件超时，以微秒为单位。从闪光灯开始闪烁开始经过此时间段后，闪光灯闪烁停止。仅为支持设置闪光灯超时的闪光灯 LED 设备创建此文件。

/sys/class/leds/<led>/full_duplex

在文件 sysfs-class-led-trigger-netdev 中定义

发出指定网络设备的链路全双工状态信号。

如果设置为 0（默认），则 LED 的正常状态为关闭。

如果设置为 1，则 LED 的正常状态会反映指定网络设备的链路全双工状态。设置此值还会立即更改 LED 状态。

/sys/class/leds/<led>/gt683r/mode

在文件 sysfs-class-leds-gt683r 中定义

设置 LED 的模式。您应该注意到，更改一个 LED 的模式也会更新其两个同级设备的模式。可能的值为

0

正常

1

audio

2

breathing

Normal：启用时，LED 完全亮起 Audio：LED 亮度取决于声音水平 Breathing：LED 亮度以人类呼吸频率变化

/sys/class/leds/<led>/half_duplex

在文件 sysfs-class-led-trigger-netdev 中定义

发出指定网络设备的链路半双工状态信号。

如果设置为 0（默认），则 LED 的正常状态为关闭。

如果设置为 1，则 LED 的正常状态会反映指定网络设备的链路半双工状态。设置此值还会立即更改 LED 状态。

/sys/class/leds/<led>/hr_pattern

在文件 sysfs-class-led-trigger-pattern 中定义

指定 LED 的软件模式，该模式支持使用一个软件定时器在指定时间内改变亮度。它可以实现亮度的逐渐变暗和阶跃变化。

与 /sys/class/leds/<led>/pattern 不同，此属性在高分辨率定时器 (hrtimer) 上运行模式。

/sys/class/leds/<led>/hw_pattern

在文件 sysfs-class-led-trigger-pattern 中定义

为 LED 指定硬件模式，用于支持根据某些预编程硬件模式自主控制亮度随时间变化的 LED 硬件。它会停用任何活动的软件模式。

由于不同的 LED 硬件可能具有不同的硬件模式语义，因此每个驱动程序都应在其 Documentation/leds/ 的文档文件中提供其硬件模式的描述。

/sys/class/leds/<led>/id

在文件 sysfs-class-led-driver-lm3533 中定义

获取此 LED 的 ID (0..3)。

/sys/class/leds/<led>/interval

在文件 sysfs-class-led-trigger-netdev 中定义

指定 LED 闪烁的持续时间，以毫秒为单位。默认为 50 毫秒。

当 offloaded 为 true 时，interval 值必须设置为默认值，并且无法更改。在此特定模式下尝试设置任何值都将返回 EINVAL 错误。

/sys/class/leds/<led>/invert

在文件 sysfs-class-led-trigger-oneshot 中定义

反转闪烁逻辑。如果设置为 0（默认），则闪烁亮起 delay_on 毫秒，然后闪烁熄灭 delay_off 毫秒，LED 通常保持熄灭状态。如果设置为 1，则闪烁熄灭 delay_off 毫秒，然后闪烁亮起 delay_on 毫秒，LED 通常保持点亮状态。设置此值也会立即更改 LED 状态。

/sys/class/leds/<led>/inverted

在文件 sysfs-class-led 中定义

反转 LED 的开/关状态。此参数特定于 gpio 和背光触发器。对于背光触发器，当驱动旨在指示处于待机状态的设备的 LED 时，此参数非常有用。

/sys/class/leds/<led>/linear

在文件 sysfs-class-led-driver-lm3533 中定义

设置亮度映射模式 (0, 1)，其中

0

指数模式

1

线性模式

在文件 sysfs-class-led-trigger-netdev 中定义

指示指定网络设备的连接状态。

如果设置为 0（默认），则 LED 的正常状态为关闭。

如果设置为 1，则 LED 的正常状态反映指定网络设备的连接状态。设置此值也会立即更改 LED 状态。

在文件 sysfs-class-led-trigger-netdev 中定义

指示指定网络设备的 10Mbps 连接速度状态。

如果设置为 0（默认），则 LED 的正常状态为关闭。

如果设置为 1，则 LED 的正常状态反映指定网络设备的 10Mbps 连接速度状态。设置此值也会立即更改 LED 状态。

仅当指定网络设备支持 10Mbps 连接速度时才存在。

在文件 sysfs-class-led-trigger-netdev 中定义

指示指定网络设备的 100Mbps 连接速度状态。

如果设置为 0（默认），则 LED 的正常状态为关闭。

如果设置为 1，则 LED 的正常状态反映指定网络设备的 100Mbps 连接速度状态。设置此值也会立即更改 LED 状态。

仅当指定网络设备支持 100Mbps 连接速度时才存在。

在文件 sysfs-class-led-trigger-netdev 中定义

指示指定网络设备的 1000Mbps 连接速度状态。

如果设置为 0（默认），则 LED 的正常状态为关闭。

如果设置为 1，则 LED 的正常状态反映指定网络设备的 1000Mbps 连接速度状态。设置此值也会立即更改 LED 状态。

仅当指定网络设备支持 1000Mbps 连接速度时才存在。

在文件 sysfs-class-led-trigger-netdev 中定义

指示指定网络设备的 10000Mbps 连接速度状态。

如果设置为 0（默认），则 LED 的正常状态为关闭。

如果设置为 1，则 LED 的正常状态反映指定网络设备的 10000Mbps 连接速度状态。设置此值也会立即更改 LED 状态。

仅当指定网络设备支持 10000Mbps 连接速度时才存在。

在文件 sysfs-class-led-trigger-netdev 中定义

指示指定网络设备的 2500Mbps 连接速度状态。

如果设置为 0（默认），则 LED 的正常状态为关闭。

如果设置为 1，则 LED 的正常状态反映指定网络设备的 2500Mbps 连接速度状态。设置此值也会立即更改 LED 状态。

仅当指定网络设备支持 2500Mbps 连接速度时才存在。

在文件 sysfs-class-led-trigger-netdev 中定义

指示指定网络设备的 5000Mbps 连接速度状态。

如果设置为 0（默认），则 LED 的正常状态为关闭。

如果设置为 1，则 LED 的正常状态反映指定网络设备的 5000Mbps 连接速度状态。设置此值也会立即更改 LED 状态。

仅当指定网络设备支持 5000Mbps 连接速度时才存在。

/sys/class/leds/<led>/max_brightness

在文件 sysfs-class-led 中定义

此 LED 的最大亮度级别，默认为 255 (LED_FULL)。

如果 LED 不支持不同的亮度级别，则此值应为 1。

/sys/class/leds/<led>/max_flash_brightness

在文件 sysfs-class-led-flash 中定义

只读，此 LED 在闪光频闪模式下的最大亮度级别，以微安为单位。

/sys/class/leds/<led>/max_flash_timeout

在文件 sysfs-class-led-flash 中定义

只读，此 LED 的最大闪光超时时间，以微秒为单位。

/sys/class/leds/<led>/multi_index

在文件 sysfs-class-led-multicolor 中定义

读取时，multi_index 数组将输出 LED 颜色作为字符串数组，这些字符串在 multi_intensity 文件中被索引。

有关更多详细信息，请参阅 Linux 下的多色 LED 处理。

/sys/class/leds/<led>/multi_intensity

在文件 sysfs-class-led-multicolor 中定义

读/写，此文件包含整数数组。组件的顺序由 multi_index 数组描述。最大强度不应超过 /sys/class/leds/<led>/max_brightness。

有关更多详细信息，请参阅 Linux 下的多色 LED 处理。

/sys/class/leds/<led>/offloaded

在文件 sysfs-class-led-trigger-netdev 中定义

通信 LED 触发模式是否已卸载到硬件，或者是否使用软件回退。

如果为 0，则 LED 使用软件回退进行闪烁。

如果为 1，则以请求模式闪烁的 LED 将卸载到硬件。

/sys/class/leds/<led>/pattern

在文件 sysfs-class-led-trigger-pattern 中定义

指定 LED 的软件模式，该模式支持使用一个软件定时器在指定时间内改变亮度。它可以实现亮度的逐渐变暗和阶跃变化。

模式由一系列亮度值和持续时间（毫秒）的元组给出。

确切格式在：Documentation/devicetree/bindings/leds/leds-trigger-pattern.txt 中描述

/sys/class/leds/<led>/ports/<port>

在文件 sysfs-class-led-trigger-usbport 中定义

每个目录条目都代表一个可为 USB 端口触发器选择的 USB 端口。选择端口会使触发器观察它们是否有任何连接的设备，并且如果有任何设备，则会点亮 LED。

回显值“1”选择 USB 端口。回显“0”取消选择它。也可以读取当前状态。

/sys/class/leds/<led>/pwm

在文件 sysfs-class-led-driver-lm3533 中定义

设置 PWM 输入控制掩码（5 位），其中

位 5

在区域 4 中启用 PWM 输入

位 4

在区域 3 中启用 PWM 输入

位 3

在区域 2 中启用 PWM 输入

位 2

在区域 1 中启用 PWM 输入

位 1

在区域 0 中启用 PWM 输入

位 0

启用 PWM 输入

/sys/class/leds/<led>/repeat

在文件 sysfs-class-led-trigger-pattern 中定义

指定模式重复次数。-1 表示无限重复，其他负数和数字 0 无效。

此文件将始终返回最初写入的重复次数。

应该注意的是，某些 LED（如 EL15203000）可能仅支持无限期模式，因此它们始终存储 -1。

/sys/class/leds/<led>/rx

在文件 sysfs-class-led-trigger-netdev 中定义

指示指定网络设备上数据的接收。

如果设置为 0（默认），则 LED 在接收时不会闪烁。

如果设置为 1，则 LED 将闪烁在 interval 中指定的毫秒数以指示接收。

当 offloaded 为 true 时，闪烁间隔由硬件控制，并且不会反映在 interval 中设置的值。

/sys/class/leds/<led>/shot

在文件 sysfs-class-led-trigger-oneshot 中定义

写入任何非空字符串以指示事件，如果尚未运行，这将启动一个闪烁序列。

/sys/class/leds/<led>/trigger

在文件 sysfs-class-led 中定义

为此 LED 设置触发器。触发器是基于内核的 LED 事件源。

您可以采用与选择 IO 调度程序类似的方式更改触发器。选择给定的触发器后，特定于触发器的参数可能会出现在 /sys/class/leds/<led> 中。有关其文档，请参见 sysfs-class-led-trigger-*。

/sys/class/leds/<led>/tx

在文件 sysfs-class-led-trigger-netdev 中定义

指示指定网络设备上数据的传输。

如果设置为 0（默认），则 LED 在传输时不会闪烁。

如果设置为 1，则 LED 将闪烁在 interval 中指定的毫秒数以指示传输。

当 offloaded 为 true 时，闪烁间隔由硬件控制，并且不会反映在 interval 中设置的值。

/sys/class/leds/<tty_led>/cts

在文件 sysfs-class-led-trigger-tty 中定义

CTS = Clear To Send，DCE 已准备好接收来自 DTE 的数据。如果检测到线路状态，则 LED 会打开。如果设置为 0（默认），则 LED 不会评估 CTS。如果设置为 1，则 LED 会评估 CTS。

/sys/class/leds/<tty_led>/dcd

在文件 sysfs-class-led-trigger-tty 中定义

DCD = Data Carrier Detect，DTE 正在接收来自 DCE 的载波。如果检测到线路状态，则 LED 会打开。如果设置为 0（默认），则 LED 不会评估 CAR (DCD)。如果设置为 1，则 LED 会评估 CAR (DCD)。

/sys/class/leds/<tty_led>/dsr

在文件 sysfs-class-led-trigger-tty 中定义

DSR = Data Set Ready，DCE 已准备好接收和发送数据。如果检测到线路状态，则 LED 会打开。如果设置为 0（默认），则 LED 不会评估 DSR。如果设置为 1，则 LED 会评估 DSR。

/sys/class/leds/<tty_led>/rng

在文件 sysfs-class-led-trigger-tty 中定义

RNG = Ring Indicator，DCE 检测到电话线上的传入振铃信号。如果检测到线路状态，则 LED 会打开。如果设置为 0（默认），则 LED 不会评估 RNG。如果设置为 1，则 LED 会评估 RNG。

/sys/class/leds/<tty_led>/rx

在文件 sysfs-class-led-trigger-tty 中定义

指示在指定的 tty 设备上接收 (rx) 数据。如果设置为 0，则 LED 在接收时不会闪烁。如果设置为 1（默认），则 LED 在接收时会闪烁。

/sys/class/leds/<tty_led>/ttyname

在文件 sysfs-class-led-trigger-tty 中定义

指定触发 tty 的 tty 设备名称

/sys/class/leds/<tty_led>/tx

在文件 sysfs-class-led-trigger-tty 中定义

指示在指定的 tty 设备上发送 (tx) 数据。如果设置为 0，则 LED 在发送时不会闪烁。如果设置为 1（默认），则 LED 在发送时会闪烁。

/sys/class/leds/SRWS1::<serial>::RPM1

/sys/class/leds/SRWS1::<serial>::RPM2

/sys/class/leds/SRWS1::<serial>::RPM3

/sys/class/leds/SRWS1::<serial>::RPM4

/sys/class/leds/SRWS1::<serial>::RPM5

/sys/class/leds/SRWS1::<serial>::RPM6

/sys/class/leds/SRWS1::<serial>::RPM7

/sys/class/leds/SRWS1::<serial>::RPM8

/sys/class/leds/SRWS1::<serial>::RPM9

/sys/class/leds/SRWS1::<serial>::RPM10

/sys/class/leds/SRWS1::<serial>::RPM11

/sys/class/leds/SRWS1::<serial>::RPM12

/sys/class/leds/SRWS1::<serial>::RPM13

/sys/class/leds/SRWS1::<serial>::RPM14

/sys/class/leds/SRWS1::<serial>::RPM15

/sys/class/leds/SRWS1::<serial>::RPMALL

在文件 sysfs-driver-hid-srws1 中定义

提供用于打开/关闭控制器前面的 RPM 表上的 LED 的控件

/sys/class/leds/dell::kbd_backlight/als_enabled

在文件 sysfs-platform-dell-laptop 中定义

此文件允许控制某些具有环境光传感器的系统上的自动键盘照明模式。向此文件写入 1 以启用自动模式，写入 0 以禁用它。

/sys/class/leds/dell::kbd_backlight/als_setting

在文件 sysfs-platform-dell-laptop 中定义

此文件允许指定环境光传感器报告的开启/关闭阈值。

/sys/class/leds/dell::kbd_backlight/start_triggers

在文件 sysfs-platform-dell-laptop 中定义

此文件允许控制因不活动而禁用的键盘背光照明的输入触发器。读取该文件以查看可用的触发器。启用的触发器以“+”开头，禁用的触发器以“-”开头。

要启用触发器，请将以“+”开头的触发器名称写入此文件。要禁用触发器，请写入以“-”开头的触发器名称。

例如，要启用键盘作为触发器，请运行

echo +keyboard > /sys/class/leds/dell::kbd_backlight/start_triggers

要禁用它，请运行

echo -keyboard > /sys/class/leds/dell::kbd_backlight/start_triggers

请注意，并非所有可用的触发器都可以配置。

/sys/class/leds/dell::kbd_backlight/stop_timeout

在文件 sysfs-platform-dell-laptop 中定义

此文件允许指定因不活动而禁用键盘照明的间隔。超时时间以秒、分钟、小时和天为单位表示，符号分别为“s”、“m”、“h”和“d”。

要配置超时，请将值以及上述任何单位写入此文件。如果未指定单位，则假定该值以秒为单位表示。

例如，要将超时设置为 10 分钟，请运行

echo 10m > /sys/class/leds/dell::kbd_backlight/stop_timeout

请注意，读取此文件时，返回的值可能以与设置超时时使用的单位不同的单位表示。

另请注意，仅支持某些超时，并且在将无效的超时写入此文件时，某些系统可能会回退到特定的超时。

/sys/class/mdio_bus/<总线>/<设备>/attached_dev

定义在文件 sysfs-class-net-phydev

指向此 PHY 设备所连接的网络设备的符号链接。

/sys/class/mdio_bus/<总线>/<设备>/phy_dev_flags

定义在文件 sysfs-class-net-phydev

32 位十六进制数，表示从 PHY 的使用者（以太网 MAC、交换机等）传递到 PHY 驱动程序的配置位掩码。这些标志仅供内核内部使用，并且它们的放置位置在不同的内核版本中并不稳定。此属性旨在方便调试 PHY 驱动程序。

/sys/class/mdio_bus/<总线>/<设备>/phy_has_fixups

定义在文件 sysfs-class-net-phydev

此属性包含一个布尔值，表示给定的 PHY 设备是否已对其运行任何“修复”解决方法，编码为布尔值。提供此信息是为了帮助排除 PHY 配置故障。

/sys/class/mdio_bus/<总线>/<设备>/phy_id

定义在文件 sysfs-class-net-phydev

此属性包含总线枚举期间设备报告的 32 位 PHY 标识符，以十六进制编码。此 ID 用于将设备与相应的驱动程序匹配。

/sys/class/mdio_bus/<总线>/<设备>/phy_interface

定义在文件 sysfs-class-net-phydev

此属性包含以太网驱动程序在总线枚举期间配置的 PHY 接口，以字符串编码。此接口模式用于配置以太网 MAC，使其数据线与 PHY 硬件匹配。

可能的值为

<空>（不可用）、mii、gmii、sgmii、tbi、rev-mii、rmii、rgmii、rgmii-id、rgmii-rxid、rgmii-txid、rtbi、smii xgmii、moca、qsgmii、trgmii、1000base-x、2500base-x、rxaui、xaui、10gbase-kr、unknown

/sys/class/mdio_bus/<总线>/<设备>/phy_standalone

定义在文件 sysfs-class-net-phydev

布尔值，指示 PHY 设备是否在独立模式下使用，没有关联的 net_device，由 PHYLINK 使用。仅当出现这种情况时才会创建该属性。

/sys/class/mei/

定义在文件 sysfs-class-mei

mei/ 类子目录属于 mei 设备类

/sys/class/mei/mei<N>/

定义在文件 sysfs-class-mei

为每个探测到的 mei 设备创建 /sys/class/mei/meiN 目录

/sys/class/mei/mei<N>/dev_state

定义在文件 sysfs-class-mei

显示 ME 设备状态。

设备状态可以具有以下值：INITIALIZING INIT_CLIENTS ENABLED RESETTING DISABLED POWER_DOWN POWER_UP

/sys/class/mei/mei<N>/fw_status

定义在文件 sysfs-class-mei

显示固件状态寄存器内容

ME 固件将其状态信息写入固件状态寄存器，以供 BIOS 和操作系统监控固件运行状况。

该寄存器包含运行状态、电源管理状态、错误代码等。寄存器的解码方式取决于 PCH 或 SoC 代数。此外，寄存器的数量在 1 到 6 之间变化，具体取决于代数。

/sys/class/mei/mei<N>/fw_ver

定义在文件 sysfs-class-mei

显示 ME 固件版本。

平台 ME 固件的版本格式为：<平台>:<主要>.<次要>.<里程碑>.<构建编号>。对于不同的固件组件，最多可以有三个这样的块。

/sys/class/mei/mei<N>/hbm_ver

定义在文件 sysfs-class-mei

显示协商的 HBM 协议版本。

驱动程序和设备之间协商的 HBM 协议版本。

/sys/class/mei/mei<N>/hbm_ver_drv

定义在文件 sysfs-class-mei

显示驱动程序 HBM 协议版本。

驱动程序支持的 HBM 协议版本。

/sys/class/mei/mei<N>/kind

定义在文件 sysfs-class-mei

显示设备类型

通用设备标记为“mei”，而特殊用途设备有自己的名称。可用选项：- mei：通用 mei 设备。 - itouch：itouch (ipts) mei 设备。

/sys/class/mei/mei<N>/trc

定义在文件 sysfs-class-mei

显示 trc 状态寄存器内容

ME 固件将故障检测硬件 (TRC) 状态信息写入 trc 状态寄存器，以供 BIOS 和操作系统监控固件运行状况。

/sys/class/mei/mei<N>/tx_queue_limit

定义在文件 sysfs-class-mei

配置 tx 队列限制

设置每个已打开会话的最大挂起写入次数。

/sys/class/mic/

定义在文件 sysfs-class-mic

mic 类目录属于 Intel MIC 设备，并提供每个 MIC 设备的信息。Intel MIC 设备是基于 Intel Many Integrated Core (MIC) 架构的 PCIe 外形附加协处理器卡，该架构运行 Linux 操作系统。

/sys/class/mic/mic<X>

定义在文件 sysfs-class-mic

目录 /sys/class/mic/mic0、/sys/class/mic/mic1 等代表 MIC 设备 (0,1,.. 等)。每个目录都有特定于该 MIC 设备的信息。

/sys/class/mic/mic<X>/bootmode

定义在文件 sysfs-class-mic

读取时，此 sysfs 条目提供卡的当前引导模式。可以使用以下有效字符串写入此 sysfs 条目：a) linux - 引导 Linux 映像。b) flash - 引导用于闪存更新的映像。

/sys/class/mic/mic<X>/cmdline

定义在文件 sysfs-class-mic

Intel MIC 设备在其运行期间运行 Linux 操作系统。在引导此卡操作系统之前，可以传递内核命令行选项来配置其中的各种功能，类似于自引导机器。读取时，此条目提供有关当前设置为引导卡操作系统的内核命令行选项的信息。可以写入此条目以更改现有的内核命令行选项。通常，用户会希望读取当前的命令行选项，附加新的选项或修改现有的选项，然后将整个内核命令行写回此条目。

/sys/class/mic/mic<X>/family

定义在文件 sysfs-class-mic

提供有关 Intel MIC 设备的协处理器系列的信息。例如 - “x100”

/sys/class/mic/mic<X>/firmware

定义在文件 sysfs-class-mic

读取时，此 sysfs 条目提供 /lib/firmware/ 下的路径名，其中可以找到要在卡上引导的固件映像。可以写入该条目以更改 /lib/firmware/ 下的固件映像位置。

/sys/class/mic/mic<X>/heartbeat_enable

定义在文件 sysfs-class-mic

MIC 驱动程序通过心跳机制检测并通知用户空间有关卡崩溃的信息（请参阅上面 shutdown_status 的描述）。用户空间可以通过将 heartbeat_enable 设置为 0 来关闭此通知，并通过将此条目设置为 1 来启用它。如果禁用此通知，则用户空间有责任通过其他方式（例如网络 ping）来检测卡崩溃。默认情况下启用此设置。

/sys/class/mic/mic<X>/log_buf_addr

定义在文件 sysfs-class-mic

Intel MIC 设备在其运行期间运行 Linux 操作系统。出于调试目的和早期内核引导消息，用户可以通过 debugfs 访问卡操作系统日志缓冲区。读取时，此条目提供可读取卡操作系统日志缓冲区的缓冲区的内核虚拟地址。此条目由主机配置守护程序写入以设置日志缓冲区地址。要写入的正确日志缓冲区地址可以在卡操作系统的 System.map 文件中找到。

/sys/class/mic/mic<X>/log_buf_len

定义在文件 sysfs-class-mic

Intel MIC 设备在其运行期间运行 Linux 操作系统。出于调试目的和早期内核引导消息，用户可以通过 debugfs 访问卡操作系统日志缓冲区。读取时，此条目提供可以读取卡操作系统日志缓冲区长度的内核虚拟地址。此条目由主机配置守护程序写入以设置日志缓冲区长度地址。要写入的正确日志缓冲区长度地址可以在卡操作系统的 System.map 文件中找到。

/sys/class/mic/mic<X>/ramdisk

定义在文件 sysfs-class-mic

读取时，此 sysfs 条目提供 /lib/firmware/ 下的路径名，其中可以找到在卡操作系统引导期间使用的 ramdisk 映像。可以写入该条目以更改 /lib/firmware/ 下的 ramdisk 映像位置。

/sys/class/mic/mic<X>/shutdown_status

定义在文件 sysfs-class-mic

Intel MIC 设备在其运行期间运行 Linux 操作系统。此操作系统可能会因各种原因而关闭。读取时，此条目提供有关卡操作系统关闭原因的状态。可能的值为

“nop”

当卡操作系统“在线”时，关闭状态不适用

“crashed”

由于硬件或软件崩溃而关闭。

“halted”

由于停止命令而关闭。

“poweroff”

由于关机命令而关闭。

“restart”

由于重启命令而关闭。

/sys/class/mic/mic<X>/state

定义在文件 sysfs-class-mic

读取时，此条目提供 Intel MIC 设备在卡操作系统上下文中的当前状态。将读取的可能值为

“ready”

MIC 设备已准备好引导卡操作系统。在 OSPM 恢复后读取此条目时，如果卡先前在 OSPM 挂起期间关闭，则必须将“boot”写入此条目。

“booting”

MIC 设备已启动引导卡操作系统。

“online”

MIC 设备已完成启动并在线。

“shutting_down”

卡操作系统正在关闭。

“resetting”

已启动 MIC 设备的重置。

“reset_failed”

MIC 设备重置失败。

写入此 sysfs 条目时，会根据卡操作系统的当前状态触发不同的状态更改操作。可接受的值为

“boot”

启动由固件、ramdisk、cmdline 和 bootmode sysfs 条目的组合指定的卡操作系统映像。

“reset”

启动设备重置。

“shutdown”

启动卡操作系统关闭。

/sys/class/mic/mic<X>/stepping

定义在文件 sysfs-class-mic

提供有关 Intel MIC 设备硅步进的信息。例如 - “A0” 或 “B0”

/sys/class/misc/drivers/dw-xdata-pcie.<device>/write

在文件 sysfs-driver-xdata 中定义

允许用户启用 PCIe 流量生成器，该生成器将创建写入 TLP 帧 - 从根复合体到端点方向，或禁用所有方向的 PCIe 流量生成器。

写入 y/1/on 以启用，n/0/off 以禁用

用法示例：

echo 1 > /sys/class/misc/dw-xdata-pcie.<device>/write

或

echo 0 > /sys/class/misc/dw-xdata-pcie.<device>/write

用户可以读取此生成器生成的当前 PCIe 链路吞吐量（单位为 MB/s）。

用法示例：

cat /sys/class/misc/dw-xdata-pcie.<device>/write 204

该文件是可读写的。

/sys/class/misc/dw-xdata-pcie.<device>/read

在文件 sysfs-driver-xdata 中定义

允许用户启用 PCIe 流量生成器，该生成器将创建读取 TLP 帧 - 从端点到根复合体的方向，或禁用所有方向的 PCIe 流量生成器。

写入 y/1/on 以启用，n/0/off 以禁用

用法示例：

echo 1 > /sys/class/misc/dw-xdata-pcie.<device>/read

或

echo 0 > /sys/class/misc/dw-xdata-pcie.<device>/read

用户可以读取此生成器生成的当前 PCIe 链路吞吐量（单位为 MB/s）。

用法示例：

cat /sys/class/misc/dw-xdata-pcie.<device>/read 199

该文件是可读写的。

/sys/class/mtd/

在文件 sysfs-class-mtd 中定义

mtd/ 类子目录属于 MTD 子系统（MTD 核心）。

/sys/class/mtd/mtdX/

在文件 sysfs-class-mtd 中定义

/sys/class/mtd/mtd{0,1,2,3,...} 目录对应于每个 /dev/mtdX 字符设备。这些目录可能表示物理/模拟闪存设备、闪存设备上的分区或串联的闪存设备。

/sys/class/mtd/mtdX/bad_blocks

在文件 sysfs-class-mtd 中定义

此分区中标记为坏块的块数（如果有）。

/sys/class/mtd/mtdX/bbt_blocks

在文件 sysfs-class-mtd 中定义

此分区中标记为保留的块数（如果有）。这些块通常用于存储闪存中的坏块表 (BBT)。

/sys/class/mtd/mtdX/bitflip_threshold

在文件 sysfs-class-mtd 中定义

这允许用户检查和调整 mtd 从 mtd_read() 和 mtd_read_oob() 返回 -EUCLEAN 的标准。如果构成 ecc 步骤的任何单个区域上校正的最大比特错误数（由驱动程序报告）等于或超过此值，则返回 -EUCLEAN。否则，如果没有错误，则返回 0。更高的层（例如，UBI）使用此返回代码来指示擦除块可能正在退化，应将其仔细检查是否适合标记为坏块。

初始值可以由闪存设备驱动程序指定。如果未指定，则默认值为 ecc_strength。

此功能的引入使 -EUCLEAN 返回代码的含义发生细微变化。以前，它被解释为简单地表示“一个或多个比特错误已得到纠正”。它的新解释可以表达为“在构成 ecc 步骤的一个或多个区域上纠正了危险的高比特错误数”。“危险的高”的确切定义可以通过用户使用 bitflip_threshold 进行调整。但是，除非用户知道自己在做什么并且非常了解其设备的属性，否则不建议用户这样做。一般来说，bitflip_threshold 应足够低以检测到真正的擦除块退化，但应足够高以避免在出现粘性比特翻转的设备上持续返回 -EUCLEAN 值带来的后果。请注意，如果 bitflip_threshold 超过 ecc_strength，则读取操作永远不会返回 -EUCLEAN。相反，如果 bitflip_threshold 为零，则在没有硬错误的情况下，始终返回 -EUCLEAN。

这通常仅适用于具有 ECC 功能的 NAND 闪存设备。在缺乏 ECC 功能的设备上将被忽略；即，ecc_strength 为零的设备。

/sys/class/mtd/mtdX/corrected_bits

在文件 sysfs-class-mtd 中定义

通过设备 ECC 校正的比特数。

它将始终是一个非负整数。对于没有任何 ECC 功能的设备，它为 0。

/sys/class/mtd/mtdX/dev

在文件 sysfs-class-mtd 中定义

与此 MTD 设备对应的字符设备的主设备号和次设备号（格式为 <主设备号>:<次设备号>）。这是读写设备，因此 <次设备号> 将为偶数。

/sys/class/mtd/mtdX/ecc_failures

在文件 sysfs-class-mtd 中定义

此设备的 ECC 报告的故障数。通常，这些故障与失败的读取操作相关。

它将始终是一个非负整数。对于没有任何 ECC 功能的设备，它为 0。

/sys/class/mtd/mtdX/ecc_step_size

在文件 sysfs-class-mtd 中定义

ECC 覆盖的单个区域的大小，称为 ECC 步长。设备在每个写入大小区域内可能有几个大小相等的 ECC 步长。

它将始终是一个非负整数。对于没有任何 ECC 功能的设备，它为 0。

/sys/class/mtd/mtdX/ecc_strength

在文件 sysfs-class-mtd 中定义

设备能够校正的每个 ECC 步长覆盖区域内的最大比特错误数（请参阅 ecc_step_size）。这将始终是一个非负整数。

对于没有任何 ECC 功能的设备，它为 0。

/sys/class/mtd/mtdX/erasesize

在文件 sysfs-class-mtd 中定义

设备的“主要”擦除大小。如果 numeraseregions 为零，则这是整个设备的擦除块大小。否则，可以使用 MEMGETREGIONCOUNT/MEMGETREGIONINFO ioctl 来确定实际的擦除块布局。

/sys/class/mtd/mtdX/flags

在文件 sysfs-class-mtd 中定义

表示设备标志的十六进制值，使用 OR 运算符组合在一起

0x0400：MTD_WRITEABLE - 设备可写 0x0800：MTD_BIT_WRITEABLE - 可以翻转单个比特 0x1000：MTD_NO_ERASE - 无需擦除 0x2000：MTD_POWERUP_LOCK - 重置后始终锁定

/sys/class/mtd/mtdX/name

在文件 sysfs-class-mtd 中定义

设备或分区的人类可读 ASCII 名称。这将与 /proc/mtd 中的名称匹配。

/sys/class/mtd/mtdX/numeraseregions

在文件 sysfs-class-mtd 中定义

对于具有可变擦除块大小的设备，这提供了擦除区域的总数。否则，它将读回为零。

/sys/class/mtd/mtdX/offset

在文件 sysfs-class-mtd 中定义

对于分区，该分区与父分区（另一个分区或闪存设备）起始处的字节偏移量。闪存设备上不存在此属性，因此可用于将其与分区区分开来。

/sys/class/mtd/mtdX/oobavail

在文件 sysfs-class-mtd 中定义

客户端可用于将数据放入带外区域的字节数。

/sys/class/mtd/mtdX/oobsize

在文件 sysfs-class-mtd 中定义

每页的 OOB 字节数。

/sys/class/mtd/mtdX/size

在文件 sysfs-class-mtd 中定义

设备/分区的总大小（以字节为单位）。

/sys/class/mtd/mtdX/type

在文件 sysfs-class-mtd 中定义

以下 ASCII 字符串之一，表示设备类型

absent、ram、rom、nor、nand、mlc-nand、dataflash、ubi、unknown

/sys/class/mtd/mtdX/writesize

在文件 sysfs-class-mtd 中定义

最小可写闪存单元大小。这将始终是一个正整数。

在 NOR 闪存的情况下，它是 1（即使可以清除单个比特）。

在 NAND 闪存的情况下，它是一个 NAND 页（或半页或四分之一页）。

在 ECC NOR 的情况下，它是 ECC 块大小。

/sys/class/mtd/mtdXro/

在文件 sysfs-class-mtd 中定义

这些目录为 /sys/class/mtd/mtdX/ 提供相应的只读设备节点。

/sys/class/mtd/mtdXro/dev

在文件 sysfs-class-mtd 中定义

与 MTD 设备的只读变体对应的字符设备的主设备号和次设备号（格式为 <主设备号>:<次设备号>）。在这种情况下，<次设备号> 将为奇数。

/sys/class/mux/

在文件 sysfs-class-mux 中定义

mux/ 类子目录属于通用 MUX 框架，并提供用于使用 MUX 控制器的 sysfs 接口。

/sys/class/mux/muxchip<N>/

在文件 sysfs-class-mux 中定义

为每个探测到的 MUX 芯片创建一个 /sys/class/mux/muxchipN 目录，其中 N 是一个简单的枚举。

/sys/class/net/<bridge iface>/bridge/group_fwd_mask

在文件 sysfs-class-net 中定义

位掩码，允许在网桥设备上转发地址为 01-80-C2-00-00-0X 的链路本地帧。只允许设置与 net/bridge/br_private.h 中 BR_GROUPFWD_RESTRICTED 不匹配的位的值。默认值 0 不转发任何链路本地帧。

受限位

0

01-80-C2-00-00-00 用于 STP 的网桥组地址

1

01-80-C2-00-00-01 (MAC 控制) 用于 MAC PAUSE 的 802.3

2

01-80-C2-00-00-02 (链路聚合) 802.3ad

可以使用任何未设置这些位的值。转发控制帧（例如 802.1X-PAE 或 LLDP）时要特别小心。

/sys/class/net/<iface>/addr_assign_type

在文件 sysfs-class-net 中定义

指示地址分配类型。可能的值为

0

永久地址

1

随机生成

2

从另一台设备盗取

3

使用 dev_set_mac_address 设置

/sys/class/net/<iface>/addr_len

在文件 sysfs-class-net 中定义

指示硬件地址大小（以字节为单位）。值根据接口使用的底层协议（以太网、FDDI、ATM、IEEE 802.15.4...）而变化。有关实际值，请参阅 include/uapi/linux/if_*.h。

/sys/class/net/<iface>/address

在文件 sysfs-class-net 中定义

当前分配给此接口的硬件地址。格式为字符串，例如：以太网 MAC 地址为 00:11:22:33:44:55。

/sys/class/net/<iface>/broadcast

在文件 sysfs-class-net 中定义

此接口的硬件广播地址。格式为字符串，例如：以太网广播 MAC 地址为 ff:ff:ff:ff:ff:ff。

/sys/class/net/<iface>/carrier

在文件 sysfs-class-net 中定义

指示接口的当前物理链路状态。可能的值为

0

物理链路已断开

1

物理链路已连接

注意：某些特殊设备（例如，bonding 和 team 驱动程序）将允许写入此属性以强制链路状态以正常运行并指定另一个回退接口。

/sys/class/net/<iface>/carrier_changes

在文件 sysfs-class-net 中定义

32 位无符号整数，计算链路从 UP 更改为 DOWN 以及从 DOWN 更改为 UP 的次数

/sys/class/net/<iface>/carrier_down_count

在文件 sysfs-class-net 中定义

32 位无符号整数，计算链路处于断开状态的次数

/sys/class/net/<iface>/carrier_up_count

在文件 sysfs-class-net 中定义

32 位无符号整数，计算链路处于连接状态的次数

/sys/class/net/<iface>/cdc_ncm/bmNtbFormatsSupported

在文件 sysfs-class-net-cdc_ncm 中定义

  • 位 0：支持 16 位 NTB（设置为 1）

  • 位 1：支持 32 位 NTB

  • 位 2 – 15：保留（重置为零；主机必须忽略）

/sys/class/net/<iface>/cdc_ncm/dwNtbInMaxSize

在文件 sysfs-class-net-cdc_ncm 中定义

IN NTB 最大大小（以字节为单位）

/sys/class/net/<iface>/cdc_ncm/dwNtbOutMaxSize

在文件 sysfs-class-net-cdc_ncm 中定义

OUT NTB 最大大小

/sys/class/net/<iface>/cdc_ncm/min_tx_pkt

在文件 sysfs-class-net-cdc_ncm 中定义

驱动程序会将长于此值的 NCM 传输块 (NTB) 填充到 tx_max，从而允许设备接收 tx_max 大小的帧，而无需终止短数据包。短于此限制的 NTB 将按原样传输，而无需任何填充，并以短 USB 数据包终止。

填充到 tx_max 允许驱动程序背靠背传输 NTB，而无需任何交错的短 USB 数据包。这减少了设备中短数据包中断的数量，并代表了 USB 总线带宽和设备 DMA 优化之间的权衡。

设置为 0 以填充所有帧。设置为大于 tx_max 的值以禁用所有填充。

/sys/class/net/<iface>/cdc_ncm/ndp_to_end

在文件 sysfs-class-net-cdc_ncm 中定义

布尔属性，显示“NDP to end”怪癖的状态。默认为“N”，但已知需要启用它的设备除外。

“NDP to end”怪癖使驱动程序将 NDP（数据包索引表）放置在有效负载之后。NCM 规范并未强制要求此操作，但已知某些设备的限制更多。对于已知不能使用默认驱动程序设置的设备，请将“Y”写入此属性以进行临时测试。

如果发现需要此怪癖，则应将设备条目添加到驱动程序中。

/sys/class/net/<iface>/cdc_ncm/rx_max

在文件 sysfs-class-net-cdc_ncm 中定义

RX 的最大 NTB 大小。不能超过设备支持的最大值。必须允许至少一个最大大小的数据报加上标头。

实际限制取决于设备。请参阅 dwNtbInMaxSize。

注意：某些设备会静默忽略对此值的更改，导致 NTB 过大并产生相应的帧错误。

/sys/class/net/<iface>/cdc_ncm/tx_max

在文件 sysfs-class-net-cdc_ncm 中定义

TX 的最大 NTB 大小。不能超过设备支持的最大值。必须允许至少一个最大尺寸的数据报加上报头。

实际限制取决于设备。请参阅 dwNtbOutMaxSize。

/sys/class/net/<iface>/cdc_ncm/tx_timer_usecs

在文件 sysfs-class-net-cdc_ncm 中定义

数据报聚合超时时间，单位为 µs。驱动程序将等待最多此超时时间的三倍，以便聚合更多数据报，然后再传输 NTB 帧。

有效范围：5 到 4000000

设置为 0 以禁用聚合。

以下只读属性均表示“USB 通信类网络控制模型设备子类规范”（CDC NCM），修订版 1.0（勘误表 1），2010 年 11 月 24 日，USB Implementers Forum, Inc. 中第 6.2.1 节“GetNtbParameters”中定义的结构的字段。描述引自 CDC NCM 的表 6-3：“NTB 参数结构”。

/sys/class/net/<iface>/cdc_ncm/wNdpInAlignment

在文件 sysfs-class-net-cdc_ncm 中定义

IN 管道上 NTB 的 NDP 对齐模数。应为 2 的幂，且至少为 4。

/sys/class/net/<iface>/cdc_ncm/wNdpInDivisor

在文件 sysfs-class-net-cdc_ncm 中定义

用于 IN NTB 数据报有效负载对齐的除数。

/sys/class/net/<iface>/cdc_ncm/wNdpInPayloadRemainder

在文件 sysfs-class-net-cdc_ncm 中定义

用于在 NTB 内对齐输入数据报有效负载的余数：(有效负载偏移量) mod (wNdpInDivisor) = wNdpInPayloadRemainder

/sys/class/net/<iface>/cdc_ncm/wNdpOutAlignment

在文件 sysfs-class-net-cdc_ncm 中定义

用于 OUT 管道上 NTB 的 NDP 对齐模数。应为 2 的幂，且至少为 4。

/sys/class/net/<iface>/cdc_ncm/wNdpOutDivisor

在文件 sysfs-class-net-cdc_ncm 中定义

OUT NTB 数据报对齐模数

/sys/class/net/<iface>/cdc_ncm/wNdpOutPayloadRemainder

在文件 sysfs-class-net-cdc_ncm 中定义

用于对齐 NTB 内输出数据报有效负载偏移量的余数：填充，应由功能传输为零，并由主机忽略。(有效负载偏移量) mod (wNdpOutDivisor) = wNdpOutPayloadRemainder

/sys/class/net/<iface>/cdc_ncm/wNtbOutMaxDatagrams

在文件 sysfs-class-net-cdc_ncm 中定义

主机可以打包到单个 OUT NTB 中的最大数据报数量。零表示设备不施加限制。

/sys/class/net/<iface>/dev_id

在文件 sysfs-class-net 中定义

指示设备唯一标识符。格式为十六进制值。这用于消除可能堆叠（例如：VLAN 接口）但仍与其父设备具有相同 MAC 地址的接口的歧义。

/sys/class/net/<iface>/dev_port

在文件 sysfs-class-net 中定义

指示此网络设备的端口号，格式为十进制值。某些 NIC 在同一 PCI 总线、设备和功能上具有多个独立的端口。此属性允许用户空间区分各个接口。

注意：一些设备驱动程序早在 3.15 之前就开始使用“dev_id”来实现此目的，并且此后一直没有采用新的属性。要查询端口号，某些工具仅查看“dev_port”，而另一些工具仅查阅“dev_id”。如果如上一段所述，网络设备具有多个客户端适配器端口，并且未将其端口号设置为此属性，则这是一个内核错误。

/sys/class/net/<iface>/dormant

在文件 sysfs-class-net 中定义

指示接口是否处于休眠状态。可能的值为：0：接口未休眠 1：接口休眠

此属性可由请求者软件使用，以指示设备不可用，除非执行一些基于请求者的身份验证（例如：802.1x）。“link_mode”属性也将反映休眠状态。

/sys/class/net/<iface>/dsa/tagging

在文件 sysfs-class-net-dsa 中定义

在读取时，此文件返回一个字符串，指示附加到此主接口的 DSA 网络设备使用的标记协议类型。在写入时，如果驱动程序支持此操作，则此文件会更改附加的 DSA 交换机的标记协议。更改标记协议必须在 DSA 接口和主接口都处于管理关闭状态下完成。请参阅每个已注册的 struct dsa_device_ops 的“name”字段，以获取有效值的列表。

/sys/class/net/<iface>/duplex

在文件 sysfs-class-net 中定义

指示接口的最新或当前双工值。可能的值为

half

半双工

full

全双工

注意：此属性仅对实现 ethtool get_link_ksettings 方法的接口（主要是以太网）有效。

/sys/class/net/<iface>/flags

在文件 sysfs-class-net 中定义

以十六进制位掩码指示接口标志。有关所有可能的值和标志语义的列表，请参阅 include/uapi/linux/if.h。

/sys/class/net/<iface>/fwinfo

在文件 sysfs-class-net-janz-ican3 中定义

ican3 模块的固件标记。只读：ican3 模块的 32 字节字符串标识符（已知值：“JANZ-ICAN3 ICANOS 1.xx”、“JANZ-ICAN3 CAL/CANopen 1.xx”）

/sys/class/net/<iface>/grcan/enable0

在文件 sysfs-class-net-grcan 中定义

物理接口 0 的硬件配置。此文件读取和写入配置寄存器的“Enable 0”位。可能的值：0 或 1。有关详细信息，请参阅 GRLIB IP 核库文档的 GRCAN 章节。默认值为 0，或者由模块参数 grcan.enable0 设置，并且可以在 /sys/module/grcan/parameters/enable0 中读取。

/sys/class/net/<iface>/grcan/enable1

在文件 sysfs-class-net-grcan 中定义

物理接口 1 的硬件配置。此文件读取和写入配置寄存器的“Enable 1”位。可能的值：0 或 1。有关详细信息，请参阅 GRLIB IP 核库文档的 GRCAN 章节。默认值为 0，或者由模块参数 grcan.enable1 设置，并且可以在 /sys/module/grcan/parameters/enable1 中读取。

/sys/class/net/<iface>/grcan/select

在文件 sysfs-class-net-grcan 中定义

要使用的物理接口的配置。可能的值：0 或 1。有关详细信息，请参阅 GRLIB IP 核库文档的 GRCAN 章节。默认值为 0，或者由模块参数 grcan.select 设置，并且可以在 /sys/module/grcan/parameters/select 中读取。

/sys/class/net/<iface>/ifalias

在文件 sysfs-class-net 中定义

指示/存储接口别名作为字符串。这可用于系统管理目的。

/sys/class/net/<iface>/ifindex

在文件 sysfs-class-net 中定义

以十进制数字指示系统范围的接口唯一索引标识符。此属性用于将接口标识符映射到接口名称。它在整个网络堆栈中用于指定接口特定的请求/事件。

在文件 sysfs-class-net 中定义

指示接口链接到的系统范围的接口唯一索引标识符。格式为十进制。此属性用于解析接口链接、连接和堆叠。物理接口具有相同的“ifindex”和“iflink”值。

在文件 sysfs-class-net 中定义

以十进制数字指示接口链接模式。此属性应与“dormant”属性结合使用，以确定接口的可用性。可能的值

0

默认链接模式

1

休眠链接模式

/sys/class/net/<iface>/mtu

在文件 sysfs-class-net 中定义

以字节为单位，以十进制格式指示接口当前配置的 MTU 值。特定值取决于所使用的底层接口协议。除非更改，否则以太网设备将显示“mtu”属性值为 1500。

/sys/class/net/<iface>/name_assign_type

在文件 sysfs-class-net 中定义

指示名称分配类型。可能的值为

1

由内核枚举，可能以不可预测的方式

2

由内核可预测地命名

3

由用户空间命名

4

已重命名

/sys/class/net/<iface>/netdev_group

在文件 sysfs-class-net 中定义

以十进制整数指示接口网络设备组。默认值为 0，对应于初始网络设备组。可以更改该组以影响路由决策（请参阅：net/ipv4/fib_rules 和 net/ipv6/fib6_rules.c）。

/sys/class/net/<iface>/operstate

在文件 sysfs-class-net 中定义

以字符串形式指示接口 RFC2863 操作状态。

可能的值为

“unknown”、“notpresent”、“down”、“lowerlayerdown”、“testing”、“dormant”、“up”。

/sys/class/net/<iface>/peak_usb/can_channel_id

在文件 sysfs-class-net-peak_usb 中定义

PEAK PCAN-USB 设备支持用户可配置的 CAN 通道标识符。与 USB 序列号相反，这些标识符是可写的，并且可以为每个 CAN 接口设置。这意味着如果 USB 设备导出多个 CAN 接口，则可以为每个接口分配一个唯一的通道 ID。此属性提供对通道标识符当前配置值的只读访问。根据设备类型，标识符的长度为 8 位或 32 位。从此属性读取的值始终是一个大端格式的 8 位 32 位十六进制值。如果设备仅支持 8 位标识符，则该值的上 24 位设置为零。

/sys/class/net/<iface>/phydev

在文件 sysfs-class-net 中定义

指向此网络设备所连接的 PHY 设备的符号链接。

/sys/class/net/<iface>/phys_port_id

在文件 sysfs-class-net 中定义

以字符串形式指示 NIC 内的接口唯一物理端口标识符。

/sys/class/net/<iface>/phys_port_name

在文件 sysfs-class-net 中定义

以字符串形式指示 NIC 内的接口物理端口名称。

/sys/class/net/<iface>/phys_switch_id

在文件 sysfs-class-net 中定义

以字符串形式指示此端口所属的交换机的唯一物理交换机标识符。

/sys/class/net/<iface>/qmi/add_mux

在文件 sysfs-class-net-qmi 中定义

无符号整数。

写入 1 到 254 之间的数字，以添加最近的基于高通的调制解调器支持的基于 qmap mux 的网络设备。

网络设备将被称为 qmimux。

用户空间负责通过使用适当的 QMI 协议请求来管理调制解调器端的 qmux 网络设备激活和数据流设置。

/sys/class/net/<iface>/qmi/del_mux

在文件 sysfs-class-net-qmi 中定义

无符号整数。

写入 1 到 254 之间的数字，以删除先前创建的基于 qmap mux 的网络设备。

/sys/class/net/<iface>/qmi/pass_through

在文件 sysfs-class-net-qmi 中定义

布尔值。默认值：“N”

将其设置为“Y”以启用“直通”模式，允许将 MAP 格式的数据包传递到堆栈。

通常，然后使用 rmnet 驱动程序 (CONFIG_RMNET) 来处理和解复用这些数据包。

仅当设备处于“raw-ip”模式时，才能启用“直通”模式。

/sys/class/net/<iface>/qmi/raw_ip

在文件 sysfs-class-net-qmi 中定义

布尔值。默认值：“N”

将其设置为“Y”以将网络设备链路帧从“802.3”更改为“raw-ip”。

netdev 将会改变以反映链路帧模式。在 ‘802.3’ 模式下，netdev 是一个普通的以太网设备，驱动程序期望通过 USB 链路交换带有以太网头的帧。在 ‘raw-ip’ 模式下，netdev 是一个无头的点对点设备，驱动程序期望通过 USB 链路交换没有任何 L2 头的 IPv4 或 IPv6 数据包。

用户空间通过 QMI 协议的委托完全控制固件配置。用户空间负责协调驱动程序和固件的链路帧模式，如果固件配置为 ‘raw-ip’ 模式，则将此设置更改为 ‘Y’。

/sys/class/net/<iface>/queues/rx-<queue>/rps_cpus

定义在文件 sysfs-class-net-queues

当前启用参与此网络设备队列的接收数据包转向（Receive Packet Steering）数据包处理流程的 CPU 掩码。可能的值取决于系统中可用的 CPU 数量。

/sys/class/net/<iface>/queues/rx-<queue>/rps_flow_cnt

定义在文件 sysfs-class-net-queues

此特定网络设备接收队列当前正在处理的接收数据包转向（Receive Packet Steering）流的数量。

/sys/class/net/<iface>/queues/tx-<queue>/byte_queue_limits/hold_time

定义在文件 sysfs-class-net-queues

指示测量此特定网络设备发送队列的松弛时间的保持时间，以毫秒为单位。默认值为 1000。

/sys/class/net/<iface>/queues/tx-<queue>/byte_queue_limits/inflight

定义在文件 sysfs-class-net-queues

指示此网络设备发送队列中正在传输的字节（对象）的数量。

/sys/class/net/<iface>/queues/tx-<queue>/byte_queue_limits/limit

定义在文件 sysfs-class-net-queues

指示允许在此网络设备发送队列中排队的当前字节限制。此值被限制在 limit_max 和 limit_min 定义的范围内。

/sys/class/net/<iface>/queues/tx-<queue>/byte_queue_limits/limit_max

定义在文件 sysfs-class-net-queues

指示允许在此网络设备发送队列中排队的绝对最大字节限制。有关默认值，请参阅 include/linux/dynamic_queue_limits.h。

/sys/class/net/<iface>/queues/tx-<queue>/byte_queue_limits/limit_min

定义在文件 sysfs-class-net-queues

指示允许在此网络设备发送队列中排队的绝对最小字节限制。默认值为 0。

/sys/class/net/<iface>/queues/tx-<queue>/byte_queue_limits/stall_cnt

定义在文件 sysfs-class-net-queues

检测到的 Tx 完成停顿的次数。

/sys/class/net/<iface>/queues/tx-<queue>/byte_queue_limits/stall_max

定义在文件 sysfs-class-net-queues

检测到的最长 Tx 完成停顿时间。写入 0 以清除。

/sys/class/net/<iface>/queues/tx-<queue>/byte_queue_limits/stall_thrs

定义在文件 sysfs-class-net-queues

Tx 完成停顿检测阈值，以毫秒为单位。内核将保证检测到所有长于此阈值的停顿，但也可能检测到长于阈值一半的停顿。

/sys/class/net/<iface>/queues/tx-<queue>/tx_maxrate

定义在文件 sysfs-class-net-queues

为队列设置的 Mbps 最大速率，值为零表示禁用，默认禁用。

/sys/class/net/<iface>/queues/tx-<queue>/tx_timeout

定义在文件 sysfs-class-net-queues

指示此网络接口发送队列看到的发送超时事件的数量。

/sys/class/net/<iface>/queues/tx-<queue>/xps_cpus

定义在文件 sysfs-class-net-queues

当前启用参与此网络设备发送队列的发送数据包转向（Transmit Packet Steering）数据包处理流程的 CPU 掩码。可能的值取决于系统中可用的 CPU 数量。

/sys/class/net/<iface>/queues/tx-<queue>/xps_rxqs

定义在文件 sysfs-class-net-queues

当前启用参与此网络设备发送队列的发送数据包转向（Transmit Packet Steering）数据包处理流程的接收队列掩码。可能的值取决于网络设备中可用的接收队列数量。默认禁用。

/sys/class/net/<iface>/speed

在文件 sysfs-class-net 中定义

指示接口最近或当前的速度值。该值是一个表示链路速度的整数，单位为 Mbit/秒。

注意：此属性仅对实现 ethtool get_link_ksettings 方法的接口（主要是以太网）有效。

/sys/class/net/<iface>/statistics/collisions

定义在文件 sysfs-class-net-statistics

指示此网络设备看到的冲突次数。此值可能与所有 MAC 层无关。

/sys/class/net/<iface>/statistics/multicast

定义在文件 sysfs-class-net-statistics

指示此网络设备接收到的组播数据包的数量。

/sys/class/net/<iface>/statistics/rx_bytes

定义在文件 sysfs-class-net-statistics

指示此网络设备接收到的字节数。有关何时增加此值的确切含义，请参阅网络驱动程序。

/sys/class/net/<iface>/statistics/rx_compressed

定义在文件 sysfs-class-net-statistics

指示此网络设备接收到的压缩数据包的数量。此值可能仅与支持数据包压缩的接口（例如：PPP）相关。

/sys/class/net/<iface>/statistics/rx_crc_errors

定义在文件 sysfs-class-net-statistics

指示此网络设备接收到的带有 CRC（FCS）错误的数据包的数量。请注意，具体含义可能取决于接口使用的 MAC 层。

/sys/class/net/<iface>/statistics/rx_dropped

定义在文件 sysfs-class-net-statistics

指示网络设备接收但丢弃的数据包数量，这些数据包未转发到上层进行数据包处理。有关此值的确切含义，请参阅网络驱动程序。

/sys/class/net/<iface>/statistics/rx_errors

定义在文件 sysfs-class-net-statistics

指示此网络设备上的接收错误数。有关此值的确切含义，请参阅网络驱动程序。

/sys/class/net/<iface>/statistics/rx_fifo_errors

定义在文件 sysfs-class-net-statistics

指示此网络设备看到的接收 FIFO 错误的数量。有关此值的确切含义，请参阅网络驱动程序。

/sys/class/net/<iface>/statistics/rx_frame_errors

定义在文件 sysfs-class-net-statistics

指示接收到的带有错误的帧的数量，例如对齐错误。请注意，具体含义取决于所使用的 MAC 层协议。有关此值的确切含义，请参阅网络驱动程序。

/sys/class/net/<iface>/statistics/rx_length_errors

定义在文件 sysfs-class-net-statistics

指示接收到的带有长度错误（过大或过小）的错误数据包的数量。有关此值的确切含义，请参阅网络驱动程序。

/sys/class/net/<iface>/statistics/rx_missed_errors

定义在文件 sysfs-class-net-statistics

指示由于接收端容量不足而错过的接收数据包的数量。有关此值的确切含义，请参阅网络驱动程序。

/sys/class/net/<iface>/statistics/rx_nohandler

定义在文件 sysfs-class-net-statistics

指示网络核心在非活动设备上丢弃的接收数据包的数量。

/sys/class/net/<iface>/statistics/rx_over_errors

定义在文件 sysfs-class-net-statistics

指示接收到的数据包与网络设备配置为接受的大小相比过大（例如：大于 MTU）的数量。有关此值的确切含义，请参阅网络驱动程序。

/sys/class/net/<iface>/statistics/rx_packets

定义在文件 sysfs-class-net-statistics

指示此网络设备接收到的良好数据包总数。

/sys/class/net/<iface>/statistics/tx_aborted_errors

定义在文件 sysfs-class-net-statistics

指示在网络设备传输期间中止的数据包数量（例如：由于介质冲突）。有关此值的确切含义，请参阅网络驱动程序。

/sys/class/net/<iface>/statistics/tx_bytes

定义在文件 sysfs-class-net-statistics

指示网络设备传输的字节数。有关此值的确切含义，请参阅网络驱动程序，特别是这是否包括所有成功传输的数据包或所有已排队等待传输的数据包。

/sys/class/net/<iface>/statistics/tx_carrier_errors

定义在文件 sysfs-class-net-statistics

指示由于载波错误（例如：物理链路断开）而无法传输的数据包数量。有关此值的确切含义，请参阅网络驱动程序。

/sys/class/net/<iface>/statistics/tx_compressed

定义在文件 sysfs-class-net-statistics

指示传输的压缩数据包的数量。请注意，这可能仅与支持压缩的设备（例如：PPP）相关。

/sys/class/net/<iface>/statistics/tx_dropped

定义在文件 sysfs-class-net-statistics

指示传输期间丢弃的数据包的数量。有关数据包被丢弃的确切原因，请参阅驱动程序。

/sys/class/net/<iface>/statistics/tx_errors

定义在文件 sysfs-class-net-statistics

指示网络设备在传输过程中出错的数据包数量。有关数据包被丢弃的确切原因，请参阅驱动程序。

/sys/class/net/<iface>/statistics/tx_fifo_errors

定义在文件 sysfs-class-net-statistics

指示导致传输 FIFO 错误的数据包数量。有关数据包被丢弃的确切原因，请参阅驱动程序。

/sys/class/net/<iface>/statistics/tx_heartbeat_errors

定义在文件 sysfs-class-net-statistics

指示报告为心跳错误的已传输数据包数量。有关数据包被丢弃的确切原因，请参阅驱动程序。

/sys/class/net/<iface>/statistics/tx_packets

定义在文件 sysfs-class-net-statistics

指示网络设备传输的数据包数量。请参阅驱动程序，了解这是否报告了所有尝试或成功传输的数量。

/sys/class/net/<iface>/statistics/tx_window_errors

定义在文件 sysfs-class-net-statistics

指示由于窗口冲突而未成功传输的数据包数量。具体含义取决于所使用的 MAC 层。在以太网上，通常用于报告延迟冲突错误。

/sys/class/net/<iface>/termination

在文件 sysfs-class-net-janz-ican3 中定义

表示 CAN 总线终端的值

默认值：1（终端激活） 读取：获取实际终端状态 写入：设置实际终端状态（0=无终端，1=终端激活）

/sys/class/net/<iface>/testing

在文件 sysfs-class-net 中定义

指示接口是否正在测试中。可能的值为

0

接口未被测试

1

接口正在被测试

当接口正在测试时，不能期望它像正常情况一样传递数据包。

/sys/class/net/<iface>/threaded

在文件 sysfs-class-net 中定义

用于控制每个设备的线程模式的布尔值。用户可以设置此值来启用/禁用属于此设备的所有 napi 的线程模式，而无需执行设备启动/关闭。

可能的值： == ================================== 0 此设备禁用线程模式 1 此设备启用线程模式 == ==================================

/sys/class/net/<iface>/tx_queue_len

在文件 sysfs-class-net 中定义

以整数值形式指示接口发送队列的长度（以数据包数量为单位）。值取决于接口的类型，以太网网络适配器的默认值为 1000，除非另有配置

/sys/class/net/<iface>/type

在文件 sysfs-class-net 中定义

以十进制值形式指示接口协议类型。有关所有可能的值，请参阅 include/uapi/linux/if_arp.h。

/sys/class/net/<qmimux iface>/qmap/mux_id

在文件 sysfs-class-net-qmi 中定义

无符号整数

指示在创建期间与 qmimux 网络接口关联的复用器 ID。

/sys/class/ocxl/<afu name>/afu_version

定义在文件 sysfs-class-ocxl

只读 AFU 版本，格式为 <major>:<minor> 反映了在 AFU 配置空间中读取的内容

/sys/class/ocxl/<afu name>/contexts

定义在文件 sysfs-class-ocxl

只读 AFU 的上下文数量，格式为 <n>/<max>，其中

n

当前活动上下文的数量，用于调试

max

AFU 支持的最大上下文数量

/sys/class/ocxl/<afu name>/global_mmio_area

定义在文件 sysfs-class-ocxl

读/写 提供对 AFU 全局 mmio 区域的访问

/sys/class/ocxl/<afu name>/global_mmio_size

定义在文件 sysfs-class-ocxl

只读 全局 mmio 区域的大小，如 AFU 的配置空间中所定义

/sys/class/ocxl/<afu name>/pp_mmio_size

定义在文件 sysfs-class-ocxl

只读 每个进程 mmio 区域的大小，如 AFU 的配置空间中所定义

/sys/class/ocxl/<afu name>/reload_on_reset

定义在文件 sysfs-class-ocxl

读/写控制：控制链路重置时是否重新加载 FPGA。通过 FPGA 上特定于供应商的逻辑块启用。

0

不从闪存重新加载 FPGA 映像

1

从闪存重新加载 FPGA 映像

不可用

设备不支持此功能

/sys/class/pktcdvd/add

/sys/class/pktcdvd/remove

/sys/class/pktcdvd/device_map

定义在文件 sysfs-class-pktcdvd 中

add

（只写）写入一个块设备 ID (major:minor) 以创建一个新的 pktcdvd 设备并将其映射到该块设备。

remove

（只写）写入 pktcdvd 设备 ID (major:minor) 以移除该 pktcdvd 设备。

device_map

（只读）以以下格式显示设备映射：pktcdvd[0-7] <pktdevid> <blkdevid>

/sys/class/pktcdvd/pktcdvd[0-7]/dev

/sys/class/pktcdvd/pktcdvd[0-7]/uevent

定义在文件 sysfs-class-pktcdvd 中

dev: (只读) 设备 ID

uevent: (只写) 发送一个 uevent

/sys/class/pktcdvd/pktcdvd[0-7]/stat/packets_started

/sys/class/pktcdvd/pktcdvd[0-7]/stat/packets_finished

/sys/class/pktcdvd/pktcdvd[0-7]/stat/kb_written

/sys/class/pktcdvd/pktcdvd[0-7]/stat/kb_read

/sys/class/pktcdvd/pktcdvd[0-7]/stat/kb_read_gather

/sys/class/pktcdvd/pktcdvd[0-7]/stat/reset

定义在文件 sysfs-class-pktcdvd 中

packets_started: (只读) 已启动的数据包数量。

packets_finished: (只读) 已完成的数据包数量。

kb_written: (只读) 已写入的千字节数。

kb_read: (只读) 已读取的千字节数。

kb_read_gather: (只读) 读取的用于填充写入数据包的千字节数。

reset: (只写) 写入任意值以重置

pktcdvd 设备统计值，例如读取/写入的字节数。

/sys/class/pktcdvd/pktcdvd[0-7]/write_queue/size

/sys/class/pktcdvd/pktcdvd[0-7]/write_queue/congestion_off

/sys/class/pktcdvd/pktcdvd[0-7]/write_queue/congestion_on

定义在文件 sysfs-class-pktcdvd 中

size

（只读）包含 bio 写入队列的大小。

congestion_off

（读写）如果 bio 写入队列大小低于此标记，则接受来自块层的新 bio 请求。

congestion_on

（读写）如果 bio 写入队列大小高于此标记，则不再接受来自块层的 bio 写入请求，并等待直到 pktcdvd 设备处理了足够的 bio，使 bio 写入队列大小低于 congestion off 标记。小于等于 0 的值禁用拥塞控制。

示例

要直接使用 pktcdvd sysfs 接口，你可以执行以下操作

# create a new pktcdvd device mapped to /dev/hdc
echo "22:0" >/sys/class/pktcdvd/add
cat /sys/class/pktcdvd/device_map
# assuming device pktcdvd0 was created, look at stat's
cat /sys/class/pktcdvd/pktcdvd0/stat/kb_written
# print the device id of the mapped block device
fgrep pktcdvd0 /sys/class/pktcdvd/device_map
# remove device, using pktcdvd0 device id   253:0
echo "253:0" >/sys/class/pktcdvd/remove

/sys/class/power/ds2760-battery.*/charge_full

定义在文件 sysfs-class-power 中

此文件可写，可用于设置假定的电池“满电量”。随着电池老化，此值必须随着时间的推移进行修改。

/sys/class/power/ds2760-battery.*/charge_now

定义在文件 sysfs-class-power 中

此文件可写，可用于设置电池监控芯片内的当前库仑计数器值。这是老化电池不可避免的校正所需要的。用户空间守护程序可以监视电池充电逻辑，一旦计数器超出相当大的范围，则采取适当的措施。

/sys/class/power_supply/<battery_name>/eppid

定义在文件 sysfs-platform-dell-wmi-ddv 中

报告 ACPI 电池的戴尔 ePPID（电子部件识别）。

有关详细信息，请参阅 戴尔 DDV WMI 接口驱动程序 (dell-wmi-ddv)。

/sys/class/power_supply/<supply_name>/alarm

定义在文件 sysfs-class-power-surface 中

电池跳变点。当剩余电池容量在任一方向上越过此值时，系统将收到通知，并在必要时唤醒。

设置为零以清除/禁用。

访问权限：读取，写入

有效值：以微瓦时或微安时为单位，具体取决于电池的功率单位

/sys/class/power_supply/<supply_name>/capacity

定义在文件 sysfs-class-power 中

电池容量的精细表示。

访问：读取

有效值：0 - 100（百分比）

/sys/class/power_supply/<supply_name>/capacity_alert_max

定义在文件 sysfs-class-power 中

最大电池容量跳闸值，当达到该值时，电源将通知用户空间事件。这通常用于电池放电的情况，在这种情况下，用户空间需要知道电池已下降到较高的水平，以便它可以采取适当的操作（例如，警告用户电池电量不足）。

访问权限：读取，写入

有效值：0 - 100（百分比）

/sys/class/power_supply/<supply_name>/capacity_alert_min

定义在文件 sysfs-class-power 中

最小电池容量跳闸值，当达到该值时，电源将通知用户空间事件。这通常用于电池放电的情况，在这种情况下，用户空间需要知道电池已下降到较低的水平，以便它可以采取适当的操作（例如，警告用户电池电量严重不足）。

访问权限：读取，写入

有效值：0 - 100（百分比）

/sys/class/power_supply/<supply_name>/capacity_error_margin

定义在文件 sysfs-class-power 中

未经重新校准，电池容量测量将变得不可靠。此值提供燃油表预期存在的最大误差范围，以百分比表示。重新校准后，将返回接近 0% 的值。随着时间的推移，误差范围将增大。100% 表示与容量相关的值基本上完全没用。

访问：读取

有效值：0 - 100（百分比）

/sys/class/power_supply/<supply_name>/capacity_level

定义在文件 sysfs-class-power 中

电池容量的粗略表示。

访问：读取

有效值

“未知”、“严重”、“低”、“正常”、“高”、“满”

/sys/class/power_supply/<supply_name>/charge_behaviour

定义在文件 sysfs-class-power 中

表示充电行为。

访问权限：读取，写入

有效值

auto

正常充电，遵循阈值

inhibit-charge

连接交流电源时不充电

force-discharge

连接交流电源时强制放电

/sys/class/power_supply/<supply_name>/charge_control_end_threshold

定义在文件 sysfs-class-power 中

表示电池电量百分比，高于此百分比时，充电将停止。并非所有硬件都能够将其设置为任意百分比。驱动程序会将写入的值四舍五入到最接近的受支持值。回读该值将显示驱动程序设置的实际阈值。

访问权限：读取，写入

有效值：0 - 100（百分比）

/sys/class/power_supply/<supply_name>/charge_control_limit

定义在文件 sysfs-class-power 中

最大允许充电电流。用于热冷却或改善电池健康的充电速率限制。

访问权限：读取，写入

有效值：以微安表示

/sys/class/power_supply/<supply_name>/charge_control_limit_max

定义在文件 sysfs-class-power 中

charge_control_limit 属性的最大合法值。

访问：读取

有效值：以微安表示

/sys/class/power_supply/<supply_name>/charge_control_start_threshold

定义在文件 sysfs-class-power 中

表示电池电量百分比，低于此百分比时，充电将开始。

访问权限：读取，写入 有效值：0 - 100（百分比）

/sys/class/power_supply/<supply_name>/charge_term_current

定义在文件 sysfs-class-power 中

报告用于确定电池何时被认为已充满且应结束充电的充电电流值。

访问：读取

有效值：以微安表示

/sys/class/power_supply/<supply_name>/charge_type

定义在文件 sysfs-class-power 中

选择用于电池的充电算法。

Standard

以中等速率为电池充满电。

Fast

使用快速充电技术快速为电池充电。这通常比标准充电对电池的损害更大，并可能缩短其寿命。

Trickle

主要在插入外部电源时操作系统的用户可以使用此模式延长电池寿命。供应商工具可能会将此称为“主要使用交流电源”。

Adaptive

根据典型的使用模式自动优化电池充电速率。

Custom

使用 charge_control_* 属性来确定何时开始和停止充电。高级用户可以使用此功能来大幅延长电池寿命。

Long Life

充电器降低其充电速率，以延长电池健康状况。

Bypass

充电器绕过集成转换器周围的充电路径，从而允许“智能”墙壁适配器在外部执行电源转换。

访问权限：读取，写入

有效值

“未知”、“N/A”、“涓流”、“快速”、“标准”、“自适应”、“自定义”、“长寿命”、“旁路”

/sys/class/power_supply/<supply_name>/current_avg

定义在文件 sysfs-class-power 中

电池

报告在固定时间段内电池的平均 IBAT 电流读数。通常，设备将提供一个固定间隔，在其中它们对读数进行平均，以平滑报告的值。

USB

报告在固定时间段内的平均 IBUS 电流读数。通常，设备将提供一个固定间隔，在其中它们对读数进行平均，以平滑报告的值。

访问：读取

有效值：以微安表示。负值用于放电电池，正值用于充电电池和 USB IBUS 电流。

/sys/class/power_supply/<supply_name>/current_max

定义在文件 sysfs-class-power 中

电池

报告允许进入电池的最大 IBAT 电流。

USB

报告电源可以支持的最大 IBUS 电流。

访问权限：读取 有效值：以微安表示

/sys/class/power_supply/<supply_name>/current_now

定义在文件 sysfs-class-power 中

电池

报告电池的即时、单次 IBAT 电流读数。此值不会被平均/平滑。

访问：读取

USB

报告现在提供的 IBUS 电流。除非将电源的“在线”状态设置为可编程，否则此值通常是只读报告，在这种情况下，可以在报告的最小值/最大值范围内设置此值。

访问权限：读取，写入

有效值：以微安表示。负值用于放电电池，正值用于充电电池和 USB IBUS 电流。

/sys/class/power_supply/<supply_name>/cycle_count

定义在文件 sysfs-class-power 中

报告电池经历的完整充电+放电循环次数。

访问：读取

有效值

整数 > 0：表示完整循环 整数 = 0：cycle_count 信息不可用

USB 属性

/sys/class/power_supply/<supply_name>/health

定义在文件 sysfs-class-power 中

报告电池或充电器功能的电池侧的健康状况。

访问：读取

有效值

“未知”、“良好”、“过热”、“死机”、“过压”、“未指定的故障”、“寒冷”、“看门狗定时器过期”、“安全定时器过期”、“过电流”、“需要校准”、“温暖”、“凉爽”、“热”、“无电池”

/sys/class/power_supply/<supply_name>/input_current_limit

定义在文件 sysfs-class-power 中

详细说明电源中当前设置的传入 IBUS 电流限制。通常，这是根据建立的连接类型配置的（例如，配置的 SDP 应输出最大 500mA，因此输入电流限制设置为相同的值）。最好使用 input_power_limit，对于可以使用功率限制解决的问题，请使用 input_current_limit。

访问权限：读取，写入

有效值：以微安表示

/sys/class/power_supply/<supply_name>/input_power_limit

定义在文件 sysfs-class-power 中

此条目配置电源中当前设置的传入功率限制。通常，这是根据系统级知识或用户输入配置的。最好使用此功能来限制传入功率，并且仅对可以使用功率限制解决的问题使用电流/电压限制。

访问权限：读取，写入

有效值：以微瓦表示

/sys/class/power_supply/<supply_name>/input_voltage_limit

定义在文件 sysfs-class-power 中

此条目配置电源中当前设置的输入 VBUS 电压限制。通常，这是根据系统级知识或用户输入配置的（例如，这是 Pixel C 的散热管理策略的一部分，目的是在屏幕开启时有效地将输入功率限制为 5V，以满足 Google 的皮肤温度目标）。请注意，此功能不应用于安全关键事项。最好使用 input_power_limit，对于可以使用功率限制解决的问题，请使用 input_voltage_limit。

访问权限：读取，写入

有效值：以微伏表示

/sys/class/power_supply/<电源名称>/manufacture_day

定义在文件 sysfs-class-power 中

报告设备制造的月份中的日期。

访问：读取 有效值：1-31

/sys/class/power_supply/<电源名称>/manufacture_month

定义在文件 sysfs-class-power 中

报告设备制造的月份。

访问：读取

有效值：1-12

/sys/class/power_supply/<电源名称>/manufacture_year

定义在文件 sysfs-class-power 中

报告设备制造的年份（遵循公历）。

访问：读取

有效值：以整数报告

/sys/class/power_supply/<电源名称>/manufacturer

定义在文件 sysfs-class-power 中

报告设备制造商的名称。

访问：读取 有效值：以字符串表示

/sys/class/power_supply/<电源名称>/model_name

定义在文件 sysfs-class-power 中

报告设备型号的名称。

访问：读取 有效值：以字符串表示

/sys/class/power_supply/<电源名称>/online

定义在文件 sysfs-class-power 中

指示电源的 VBUS 是否存在。当电源处于在线状态，并且电源允许时，可以在在线状态之间切换（例如，对于 PD_PPS USB 电源，从固定状态 -> 可编程状态，以便可以控制电压和电流）。

访问权限：读取，写入

有效值

0:

离线

1:

在线固定 - 固定电压电源

2:

在线可编程 - 可编程电压电源

/sys/class/power_supply/<电源名称>/precharge_current

定义在文件 sysfs-class-power 中

报告在电池充电周期的预充电阶段施加的充电电流。

访问：读取

有效值：以微安表示

/sys/class/power_supply/<电源名称>/present

定义在文件 sysfs-class-power 中

报告系统中是否存在电池。如果该属性不存在，则认为电池存在。

访问：读取

有效值

0:

不存在

1:

存在

/sys/class/power_supply/<电源名称>/serial_number

定义在文件 sysfs-class-power 中

报告设备的序列号。

访问：读取 有效值：以字符串表示

/sys/class/power_supply/<电源名称>/status

定义在文件 sysfs-class-power 中

表示电池的充电状态。通常，这是只读报告，尽管对于某些电源，这可以用于启用/禁用电池充电。

访问权限：读取，写入

有效值

“未知”、“充电中”、“放电中”、“未充电”、“已充满”

/sys/class/power_supply/<电源名称>/technology

定义在文件 sysfs-class-power 中

描述电源支持的电池技术。

访问：读取

有效值

“未知”、“镍氢”、“锂离子”、“锂聚合物”、“磷酸铁锂”、“镍镉”、“锰酸锂”

/sys/class/power_supply/<电源名称>/temp

定义在文件 sysfs-class-power 中

电池

报告当前的 TBAT 电池温度读数。

USB

报告当前的电源温度读数。这通常是设备本身的内部温度（例如，IC 的 TJUNC 温度）

访问：读取

有效值：以摄氏度的 1/10 表示

/sys/class/power_supply/<电源名称>/temp_alert_max

定义在文件 sysfs-class-power 中

电池

最大 TBAT 温度跳闸值，当达到此值时，电源将通知用户空间该事件。

USB

最大电源温度跳闸值，当达到此值时，电源将通知用户空间该事件。

这通常用于充电场景，其中用户空间需要知道温度是否超过了上限阈值，以便它可以采取适当的措施（例如，警告用户温度过高，并且已停止充电）。

访问：读取

有效值：以摄氏度的 1/10 表示

/sys/class/power_supply/<电源名称>/temp_alert_min

定义在文件 sysfs-class-power 中

电池

最小 TBAT 温度跳闸值，当达到此值时，电源将通知用户空间该事件。

USB

最小电源温度跳闸值，当达到此值时，电源将通知用户空间该事件。

这通常用于充电场景，其中用户空间需要知道温度是否低于下限阈值，以便它可以采取适当的措施（例如，警告用户温度水平过高，并且已相应地降低充电电流以纠正这种情况）。

访问：读取

有效值：以摄氏度的 1/10 表示

/sys/class/power_supply/<电源名称>/temp_max

定义在文件 sysfs-class-power 中

电池

报告允许充电的最大 TBAT 电池温度。

USB

报告允许运行的最大电源温度。

访问：读取

有效值：以摄氏度的 1/10 表示

/sys/class/power_supply/<电源名称>/temp_min

定义在文件 sysfs-class-power 中

电池

报告允许充电的最小 TBAT 电池温度。

USB

报告允许运行的最小电源温度。

访问：读取

有效值：以摄氏度的 1/10 表示

/sys/class/power_supply/<电源名称>/type

定义在文件 sysfs-class-power 中

描述电源的主要类型。

访问：读取 有效值：“电池”、“UPS”、“电源”、“USB”、“无线”

电池和 USB 属性

/sys/class/power_supply/<电源名称>/usb_type

定义在文件 sysfs-class-power 中

报告当前电源处于活动状态的 USB 连接类型，例如，它可以显示是否连接了支持 USB-PD 的电源。

访问：对于消耗 USB 电源的电源（例如电池充电器芯片），这表示连接的 USB 电源类型，并且是只读的。

对于充当 USB 电源的电源（例如 UCS1002 USB 端口电源控制器），这是可写的。

有效值

“未知”、“SDP”、“DCP”、“CDP”、“ACA”、“C”、“PD”、“PD_DRP”、“PD_PPS”、“BrickID”

设备特定属性

/sys/class/power_supply/<电源名称>/voltage_avg

定义在文件 sysfs-class-power 中

报告电池在固定时间段内的平均 VBAT 电压读数。通常，设备会提供一个固定间隔，在其中对读数进行平均，以平滑报告的值。

访问：读取

有效值：以微伏表示

/sys/class/power_supply/<电源名称>/voltage_max

定义在文件 sysfs-class-power 中

电池

报告电池充电期间允许的最大安全 VBAT 电压。

USB

报告电源可以支持的最大 VBUS 电压。

访问：读取

有效值：以微伏表示

/sys/class/power_supply/<电源名称>/voltage_min

定义在文件 sysfs-class-power 中

电池

报告电池放电期间允许的最小安全 VBAT 电压。

USB

报告电源可以支持的最小 VBUS 电压。

访问：读取

有效值：以微伏表示

/sys/class/power_supply/<电源名称>/voltage_now

定义在文件 sysfs-class-power 中

电池

报告电池的即时、单一的 VBAT 电压读数。此值未进行平均/平滑处理。

访问：读取

USB

报告当前提供的 VBUS 电压。此值通常是只读报告，除非电源的“在线”状态设置为可编程，在这种情况下，可以在报告的最小/最大范围内设置此值。

访问权限：读取，写入

有效值：以微伏表示

电池属性

/sys/class/power_supply/bq24257-charger/high_impedance_enable

定义在文件 sysfs-class-power 中

此条目允许启用 bq24257 型充电器设备的高阻抗模式。如果启用，它会将充电器 IC 置于低功耗待机模式，并禁用开关模式控制器。禁用时，充电器正常工作。有关详细信息，请参阅设备数据手册。

有效值

  • 1：已启用

  • 0：已禁用

/sys/class/power_supply/bq24257-charger/in_dpm_voltage

定义在文件 sysfs-class-power 中

此条目配置 bq24257 型充电器设备的输入动态功率路径管理电压。一旦电源降至配置的电压，输入电流限制将降低，以防止电源进一步下降。当 IC 进入此模式时，充电电流低于设定值。有关详细信息，请参阅设备数据手册。

有效值

  • 4200000、4280000、4360000、4440000、4520000、4600000、4680000、4760000（均为 uV）

/sys/class/power_supply/bq24257-charger/ovp_voltage

定义在文件 sysfs-class-power 中

此条目配置 bq24257 型充电器设备的过压保护功能。此功能可保护设备和其他组件免受输入电源过压造成的损坏。有关详细信息，请参阅设备数据手册。

有效值

  • 6000000、6500000、7000000、8000000、9000000、9500000、10000000、10500000（均为 uV）

/sys/class/power_supply/bq24257-charger/sysoff_enable

定义在文件 sysfs-class-power 中

此条目允许启用 bq24257 型充电器设备的 sysoff 模式。如果启用并且移除了输入，则会关闭内部电池 FET，以减少从 BAT 引脚泄漏的电流，使其小于 1uA。请注意，在某些设备/系统上，这会将电池与系统断开连接。有关详细信息，请参阅设备数据手册。

有效值

  • 1：已启用

  • 0：已禁用

/sys/class/power_supply/ltc4162-l/arm_ship_mode

在文件 sysfs-class-power-ltc4162l 上定义

充电器在不活动时通常会耗尽电池电量，通常会消耗约 54 微安。向此属性写入“1”以启用特殊的“运输”模式，该模式通过将泄漏电流减少到约 2.8 微安来延长保质期。芯片将保持在此模式下（并且不再响应 I2C 命令），直到连接某些外部电源将输入电压提高到 1V 以上。然后它会自动恢复为“0”。向该属性写入“0”会取消“运输”模式请求。当输入电压降至 1V 以下时，“运输”模式会在启用后激活。

访问权限：读取，写入

有效值：0（禁用）或 1（启用）

/sys/class/power_supply/ltc4162-l/charge_status

在文件 sysfs-class-power-ltc4162l 上定义

芯片报告的详细充电状态信息。

访问：读取

有效值

ilim_reg_active thermal_reg_active vin_uvcl_active iin_limit_active constant_current constant_voltage charger_off

/sys/class/power_supply/ltc4162-l/force_telemetry

在文件 sysfs-class-power-ltc4162l 上定义

为了节省电池电流，如果电池是唯一的电源，则会禁用测量系统。这会影响所有电压、电流和温度测量。向此写入“1”以保持每隔几秒钟执行一次遥测，即使在电池供电时（如 online 属性报告的那样，当外部电源可用时为“1”，当系统由电池供电时为“0”）。

访问权限：读取，写入

有效值：0（禁用）或 1（启用）

/sys/class/power_supply/ltc4162-l/ibat

在文件 sysfs-class-power-ltc4162l 上定义

充电器测量的电池输入电流。负值表示电池正在放电。

访问：读取

有效值：以微安为单位的有符号值

/sys/class/power_supply/ltc4162-l/vbat

在文件 sysfs-class-power-ltc4162l 上定义

充电器测量的电池电压。

访问：读取

有效值：以微伏为单位

/sys/class/power_supply/ltc4162-l/vbat_avg

在文件 sysfs-class-power-ltc4162l 上定义

充电器测量的随时间平均的电池电压。

访问：读取

有效值：以微伏为单位

/sys/class/power_supply/max14577-charger/device/fast_charge_timer

定义在文件 sysfs-class-power 中

此条目显示并设置 max14577 充电器在快速充电模式下运行的最长时间。当计时器到期时，设备将终止快速充电模式（充电电流将降至 0 A）并触发中断。

有效值

  • 5、6 或 7（小时），

  • 0：已禁用。

/sys/class/power_supply/max77693-charger/device/fast_charge_timer

定义在文件 sysfs-class-power 中

此条目显示并设置 max77693 充电器在快速充电模式下运行的最长时间。当计时器到期时，设备将终止快速充电模式（充电电流将降至 0 A）并触发中断。

有效值

  • 4 - 16（小时），步长为 2（向下舍入）

  • 0：已禁用。

/sys/class/power_supply/max77693-charger/device/top_off_threshold_current

定义在文件 sysfs-class-power 中

此条目显示并设置进入涓流充电模式的充电电流阈值。当快充模式下的充电电流降至此值以下时，充电器将触发中断并开始涓流充电模式。

有效值

  • 100000 - 200000（微安），步长为 25000（向下取整）

  • 200000 - 350000（微安），步长为 50000（向下取整）

  • 0：已禁用。

/sys/class/power_supply/max77693-charger/device/top_off_timer

定义在文件 sysfs-class-power 中

此条目显示并设置 max77693 充电器在涓流充电模式下运行的最长时间。当计时器超时时，设备将终止涓流充电模式（充电电流将降至 0 A），并触发中断。

有效值

  • 0 - 70（分钟），步长为 10（向下取整）

/sys/class/power_supply/mp2629_battery/batt_impedance_compen

定义在文件 sysfs-class-power-mp2629

表示用于加速充电的电池阻抗补偿。

访问权限：读取，写入

有效值：以毫欧表示。有效范围为 [0, 140]。

/sys/class/power_supply/rt9467-*/sysoff_enable

定义在文件 sysfs-class-power-rt9467

此条目允许启用 rt9467 充电器设备的 sysoff 模式。如果启用并在输入移除后，内部电池 FET 将关闭，以减少 BAT 引脚的泄漏。有关详细信息，请参阅设备数据手册。它通常在产品进入运输阶段时使用。进入运输模式后，只有按下“VBUS”或“电源键”才能使其退出此模式。“禁用”也可以帮助退出，但更像是中止设备真正进入运输模式之前的操作。

访问：读取、写入 有效值：- 1：启用 - 0：禁用

/sys/class/power_supply/rt9471-*/port_detect_enable

定义在文件 sysfs-class-power-rt9471

此条目允许启用 rt9471 充电器设备的 USB BC12 端口检测功能。如果启用并插入 VBUS，设备将开始进行 BC12 端口检测，并在端口检测完成后报告 USB 端口类型。有关详细信息，请参阅数据手册。通常在集成 TypeC/USBPD 端口时进行控制。

访问：读取、写入 有效值：- 1：启用 - 0：禁用

/sys/class/power_supply/rt9471-*/sysoff_enable

定义在文件 sysfs-class-power-rt9471

此条目允许启用 rt9471 充电器设备的 sysoff 模式。如果启用并在输入移除后，内部电池 FET 将关闭，以减少 BAT 引脚的泄漏。有关详细信息，请参阅设备数据手册。它通常在产品进入运输阶段时使用。进入运输模式后，只有按下“VBUS”或“电源键”才能使其退出此模式。“禁用”也可以帮助退出，但更像是中止设备真正进入运输模式之前的操作。

访问：读取、写入 有效值：- 1：启用 - 0：禁用

/sys/class/power_supply/twl4030_ac/mode

定义在文件 sysfs-class-power-twl4030

更改“ac”端口的模式。写入此项可以禁用充电。

可能的值为

“auto”

根据检测到的电源和电池状态适当取用电量。

“off”

不取用任何电量。

/sys/class/power_supply/twl4030_usb/mode

定义在文件 sysfs-class-power-twl4030

更改 USB 端口的模式。写入此项可以禁用充电。

可能的值为

“auto”

根据检测到的电源和电池状态适当取用电量。

“off”

不取用任何电量。

“continuous”

激活 TWL 数据手册中描述为“线性”的模式。这会使用任何可用的电流，并且在电压下降时不会关闭。

这对于不稳定的电源（例如自行车发电机）非常有用，但应注意不要过度充电电池。

/sys/class/power_supply/wilco-charger/charge_control_end_threshold

定义在文件 sysfs-class-power-wilco

当 charge_type=”Custom” 时使用，如上所述。以百分比衡量。有效范围为 [55, 100]。

/sys/class/power_supply/wilco-charger/charge_control_start_threshold

定义在文件 sysfs-class-power-wilco

当 charge_type=”Custom” 时使用，如上所述。以百分比衡量。有效范围为 [50, 95]。

/sys/class/power_supply/wilco-charger/charge_type

定义在文件 sysfs-class-power-wilco

使用哪种充电算法

Standard

以标准速率充满电池。

Adaptive

电池设置根据典型的电池使用模式自适应优化。

Fast

电池在较短的时间内充电。

Trickle

延长电池寿命，适用于主要在连接交流电源时使用 Chromebook 的用户。

Custom

指定低阈值百分比和高阈值百分比。当电量降至 charge_control_start_threshold 以下时开始充电，当电量高于 charge_control_end_threshold 时停止充电。

Long Life

为延长电池寿命而定制的充电速率。在 Wilco 设备上，此模式在出厂时通过 EC 的私有 PID 进行预配置。启用长寿命模式后，Wilco EC 将拒绝切换到其他模式。

/sys/class/powercap/

定义在文件 sysfs-class-powercap

powercap/ 类子目录属于电源上限子系统。有关详细信息，请参阅 电源上限框架。

/sys/class/powercap/.../<power zone>/constraint_X_max_time_window_us

定义在文件 sysfs-class-powercap

此约束允许的最大时间窗口，以微秒为单位。此处“X”的值可以从 0 到最大整数。

/sys/class/powercap/.../<power zone>/constraint_X_min_time_window_us

定义在文件 sysfs-class-powercap

此约束允许的最小时间窗口，以微秒为单位。此处“X”的值可以从 0 到最大整数。

/sys/class/powercap/.../<power zone>/constraint_X_name

定义在文件 sysfs-class-powercap

每个电源区域可以定义一个或多个约束。每个约束可以有一个可选名称。此处“X”的值可以从 0 到最大整数。

/sys/class/powercap/.../<power zone>/constraint_X_power_limit_uw

定义在文件 sysfs-class-powercap

功率限制，以微瓦为单位，应适用于“constraint_X_time_window_us”指定的时间窗口。此处“X”的值可以从 0 到最大整数。

/sys/class/powercap/.../<power zone>/constraint_X_time_window_us

定义在文件 sysfs-class-powercap

时间窗口，以微秒为单位。这与 constraint_X_power_limit_uw 一起使用来定义电源约束。此处“X”的值可以从 0 到最大整数。

/sys/class/powercap/.../<power zone>/enabled

定义在文件 sysfs-class-powercap

允许在电源区域级别启用/禁用电源上限。这适用于当前电源区域及其子项。

/sys/class/powercap/.../<power zone>/energy_uj

定义在文件 sysfs-class-powercap

当前能量计数器，以微焦耳为单位。写入“0”以重置。如果计数器无法重置，则此属性为只读。

/sys/class/powercap/.../<power zone>/max_energy_range_uj

定义在文件 sysfs-class-powercap

上述能量计数器的范围，以微焦耳为单位。

/sys/class/powercap/.../<power zone>/max_power_range_uw

定义在文件 sysfs-class-powercap

上述功率值的范围，以微瓦为单位。

/sys/class/powercap/.../<power zone>/name

定义在文件 sysfs-class-powercap

指定此电源区域的名称。

/sys/class/powercap/.../<power zone>/power_uw

定义在文件 sysfs-class-powercap

当前功率，以微瓦为单位。

/sys/class/powercap/<control type>

定义在文件 sysfs-class-powercap

一个 <control type> 是 /sys/class/powercap 下的唯一名称。此处 <control type> 决定如何控制电源。一个 <control type> 可以包含多个电源区域。

/sys/class/powercap/<control type>/.../constraint_X_max_power_uw

定义在文件 sysfs-class-powercap

此约束允许的最大功率，以微瓦为单位。此处“X”的值可以从 0 到最大整数。

/sys/class/powercap/<control type>/.../constraint_X_min_power_uw

定义在文件 sysfs-class-powercap

此约束允许的最小功率，以微瓦为单位。此处“X”的值可以从 0 到最大整数。

/sys/class/powercap/<control type>/<power zone>

定义在文件 sysfs-class-powercap

电源区域是单个或一组设备，可以独立监控和控制。电源区域 sysfs 条目使用 <control type> 的名称进行限定。例如，intel-rapl:0:1:1。

/sys/class/powercap/<control type>/<power zone>/<child power zone>

定义在文件 sysfs-class-powercap

电源区域可以组织成一个层次结构，其中子电源区域为父区域下的设备子集提供监控和控制。例如，如果整个 CPU 封装有一个父电源区域，则其中的每个 CPU 内核都可以是一个子电源区域。

/sys/class/powercap/<control type>/enabled

定义在文件 sysfs-class-powercap

允许为“控制类型”启用/禁用电源上限。此状态会影响使用此“控制类型”的每个电源区域。

/sys/class/pps/

定义在文件 sysfs-pps

/sys/class/pps/ 目录将包含文件和目录，这些文件和目录将为 PPS 源提供统一的接口。

/sys/class/pps/ppsX/

定义在文件 sysfs-pps

/sys/class/pps/ppsX/ 目录与系统中第 X 个 PPS 源相关。每个目录都将包含用于管理和控制其 PPS 源的文件。

/sys/class/pps/ppsX/assert

定义在文件 sysfs-pps

/sys/class/pps/ppsX/assert 文件以以下形式报告第 X 个源的断言事件和断言序列号：

<秒>.<纳秒>#<序列>

如果源没有断言事件，则此文件的内容为空。

/sys/class/pps/ppsX/clear

定义在文件 sysfs-pps

/sys/class/pps/ppsX/clear 文件以以下形式报告第 X 个源的清除事件和清除序列号：

<秒>.<纳秒>#<序列>

如果源没有清除事件，则此文件的内容为空。

/sys/class/pps/ppsX/echo

定义在文件 sysfs-pps

/sys/class/pps/ppsX/echo 文件报告第 X 个是否支持“回显”功能。

/sys/class/pps/ppsX/mode

定义在文件 sysfs-pps

/sys/class/pps/ppsX/mode 文件以十六进制编码报告第 X 个源的运行模式。

有关更多信息，请参阅 linux/include/linux/pps.h。

/sys/class/pps/ppsX/name

定义在文件 sysfs-pps

/sys/class/pps/ppsX/name 文件报告第 X 个源的名称。

/sys/class/pps/ppsX/path

定义在文件 sysfs-pps

/sys/class/pps/ppsX/path 文件报告与第 X 个源连接的设备的路径名。

如果源未连接任何设备，则此文件的内容为空。

/sys/class/ptp/

定义在文件 sysfs-ptp

此目录包含文件和目录，这些文件和目录为 PTP 硬件时钟的辅助功能提供标准化的接口。

/sys/class/ptp/ptp<N>/

定义在文件 sysfs-ptp

此目录包含注册到 PTP 类驱动程序子系统的第 N 个 PTP 硬件时钟的属性。

/sys/class/ptp/ptp<N>/clock_name

定义在文件 sysfs-ptp

此文件包含 PTP 硬件时钟的名称，为人类可读的字符串。此属性的目的是为用户提供“友好名称”，并帮助区分基于 PHY 的设备和基于 MAC 的设备。该字符串不一定必须是任何类型的唯一 ID。

/sys/class/ptp/ptp<N>/extts_enable

定义在文件 sysfs-ptp

此只写文件启用或禁用外部时间戳。要启用外部时间戳，请将通道索引后跟一个“1”写入文件。要禁用外部时间戳，请将通道索引后跟一个“0”写入文件。

/sys/class/ptp/ptp<N>/fifo

定义在文件 sysfs-ptp

此文件以三个整数的形式提供外部事件的时间戳：通道索引、秒数和纳秒数。

/sys/class/ptp/ptp<N>/max_adjustment

定义在文件 sysfs-ptp

此文件包含 PTP 硬件时钟的最大频率调整值（一个正整数），单位为十亿分之几 (ppb)。

/sys/class/ptp/ptp<N>/max_vclocks

定义在文件 sysfs-ptp

此文件包含 ptp 虚拟时钟的最大数量。写入整数以重新配置它。

/sys/class/ptp/ptp<N>/n_alarms

定义在文件 sysfs-ptp

此文件包含 PTP 硬件时钟提供的周期性或单次警报的数量。

/sys/class/ptp/ptp<N>/n_external_timestamps

定义在文件 sysfs-ptp

此文件包含 PTP 硬件时钟提供的外部时间戳通道的数量。

/sys/class/ptp/ptp<N>/n_periodic_outputs

定义在文件 sysfs-ptp

此文件包含 PTP 硬件时钟提供的可编程周期性输出通道的数量。

/sys/class/ptp/ptp<N>/n_pins

定义在文件 sysfs-ptp

此文件包含 PTP 硬件时钟提供的可编程引脚的数量。

/sys/class/ptp/ptp<N>/n_vclocks

定义在文件 sysfs-ptp

此文件包含正在使用的虚拟 PTP 时钟的数量。默认情况下，该值为 0，表示仅使用物理时钟。设置该值会创建相应数量的虚拟时钟，并使物理时钟变为自由运行。将值设置回 0 会删除虚拟时钟，并将物理时钟切换回正常的、可调整的操作。

/sys/class/ptp/ptp<N>/period

定义在文件 sysfs-ptp

此只写文件启用或禁用周期性输出。要启用周期性输出，请向文件中写入五个整数：通道索引、开始时间秒数、开始时间纳秒数、周期秒数和周期纳秒数。要禁用周期性输出，请将所有秒数和纳秒数值设置为零。

/sys/class/ptp/ptp<N>/pins

定义在文件 sysfs-ptp

此目录包含 PTP 硬件时钟提供的每个可编程引脚的一个文件。文件名是硬件相关的引脚名称。从此文件中读取会产生两个数字，即分配的函数（请参阅 linux/ptp_clock.h 中的 PTP_PF_ 枚举值）和通道号。可以通过向文件中写入两个数字来更改函数和通道分配。

/sys/class/ptp/ptp<N>/pps_available

定义在文件 sysfs-ptp

此文件指示 PTP 硬件时钟是否支持向主机 CPU 发送每秒脉冲 (PPS)。读取 “1” 表示支持 PPS，而 “0” 表示不支持。

/sys/class/ptp/ptp<N>/pps_enable

定义在文件 sysfs-ptp

此只写文件启用或禁用向 Linux PPS 子系统传递 PPS 事件。要启用 PPS 事件，请向文件中写入 “1”。要禁用事件，请向文件中写入 “0”。

/sys/class/pwm/

定义于文件 sysfs-class-pwm

pwm/ 类子目录属于通用 PWM 框架，并提供一个用于使用 PWM 通道的 sysfs 接口。

/sys/class/pwm/pwmchip<N>/

定义于文件 sysfs-class-pwm

为每个探测到的 PWM 控制器/芯片创建一个 /sys/class/pwm/pwmchipN 目录，其中 N 是 PWM 芯片的基数。

/sys/class/pwm/pwmchip<N>/export

定义于文件 sysfs-class-pwm

从 PWM 芯片导出 PWM 通道以进行 sysfs 控制。值介于 0 和 /sys/class/pwm/pwmchipN/npwm - 1 之间。

/sys/class/pwm/pwmchip<N>/npwm

定义于文件 sysfs-class-pwm

PWM 芯片支持的 PWM 通道数量。

/sys/class/pwm/pwmchip<N>/pwmX

定义于文件 sysfs-class-pwm

为每个导出的 PWM 通道创建一个 /sys/class/pwm/pwmchipN/pwmX 目录，其中 X 是导出的 PWM 通道号。

/sys/class/pwm/pwmchip<N>/pwmX/capture

定义于文件 sysfs-class-pwm

捕获有关 PWM 信号的信息。输出格式是一对无符号整数（周期和占空比），用单个空格分隔。

/sys/class/pwm/pwmchip<N>/pwmX/duty_cycle

定义于文件 sysfs-class-pwm

设置 PWM 信号的占空比，单位为纳秒。

/sys/class/pwm/pwmchip<N>/pwmX/enable

定义于文件 sysfs-class-pwm

启用/禁用 PWM 信号。0 为禁用，1 为启用。

/sys/class/pwm/pwmchip<N>/pwmX/period

定义于文件 sysfs-class-pwm

设置 PWM 信号的周期，单位为纳秒。

/sys/class/pwm/pwmchip<N>/pwmX/polarity

定义于文件 sysfs-class-pwm

将 PWM 信号的输出极性设置为“正常”或“反转”。

/sys/class/pwm/pwmchip<N>/unexport

定义于文件 sysfs-class-pwm

取消导出 PWM 通道。

/sys/class/rapidio_port

定义于文件 sysfs-class-rapidio

片上 RapidIO 控制器和 PCIe 到 RapidIO 的桥接器（称为“主端口”或“mport”）在 sysfs 中表示为特殊的设备类：“rapidio_port”。/sys/class/rapidio_port 子目录包含名为 “rapidioN” 的单独子目录，其中 N = 在 RapidIO 子系统中注册的 mport ID。

注意：mport ID 不是分配给给定本地 mport 设备的 RapidIO 目标 ID。

/sys/class/rapidio_port/rapidio<N>/port_destid

定义于文件 sysfs-class-rapidio

(只读) 报告分配给给定 RapidIO mport 设备的 RapidIO 目标 ID。如果返回值 0xFFFFFFFF，则表示尚未为 mport 分配有效的目标 ID（尚未）。通常，在执行枚举/发现之前，只有结构枚举 mport 才使用 “hdid=...” rapidio 模块参数为其分配有效的目标 ID。

在为给定的 mport 设备执行枚举或发现之后，相应的子目录还将包含连接到 mport 的每个子 RapidIO 设备的子目录。

下面的示例显示了 mport 设备子目录，其中附加了几个子 RapidIO 设备。

[rio@rapidio ~]$ ls /sys/class/rapidio_port/rapidio0/ -l
total 0
drwxr-xr-x 3 root root    0 Feb 11 15:10 00:e:0001
drwxr-xr-x 3 root root    0 Feb 11 15:10 00:e:0004
drwxr-xr-x 3 root root    0 Feb 11 15:10 00:e:0007
drwxr-xr-x 3 root root    0 Feb 11 15:10 00:s:0002
drwxr-xr-x 3 root root    0 Feb 11 15:10 00:s:0003
drwxr-xr-x 3 root root    0 Feb 11 15:10 00:s:0005
lrwxrwxrwx 1 root root    0 Feb 11 15:11 device -> ../../../0000:01:00.0
-r--r--r-- 1 root root 4096 Feb 11 15:11 port_destid
drwxr-xr-x 2 root root    0 Feb 11 15:11 power
lrwxrwxrwx 1 root root    0 Feb 11 15:04 subsystem -> ../../../../../../class/rapidio_port
-r--r--r-- 1 root root 4096 Feb 11 15:11 sys_size
-rw-r--r-- 1 root root 4096 Feb 11 15:04 uevent

/sys/class/rapidio_port/rapidio<N>/sys_size

定义于文件 sysfs-class-rapidio

(只读) 报告 RapidIO 公共传输系统大小。

0 = 小型（8 位目标 ID，最多 256 个设备），

1 = 大型（16 位目标 ID，最多 65536 个设备）。

/sys/class/rc/

定义于文件 sysfs-class-rc

rc/ 类子目录属于远程控制器核心，并提供用于配置红外远程控制器接收器的 sysfs 接口。

/sys/class/rc/rc<N>/

定义于文件 sysfs-class-rc

为每个远程控制接收器设备创建一个 /sys/class/rc/rcN 目录，其中 N 是接收器的编号。

/sys/class/rc/rc<N>/filter

定义于文件 sysfs-class-rc

设置扫描码过滤器的预期值。

与 /sys/class/rc/rcN/filter_mask 结合使用，以设置在过滤器掩码中设置的位的预期值。如果硬件支持，则将忽略与过滤器不匹配的扫描码。否则，写入将失败并显示错误。

如果当前协议更改，则此值可能会重置为 0。

/sys/class/rc/rc<N>/filter_mask

定义于文件 sysfs-class-rc

设置要比较的扫描码过滤器位掩码。与 /sys/class/rc/rcN/filter 结合使用，以设置应与预期值进行比较的扫描码的位。值为 0 会禁用过滤器，以允许处理所有有效的扫描码。

如果硬件支持，则将忽略与过滤器不匹配的扫描码。否则，写入将失败并显示错误。

如果当前协议更改，则此值可能会重置为 0。

/sys/class/rc/rc<N>/protocols

定义于文件 sysfs-class-rc

读取此文件会返回可用协议的列表，例如

"rc5 [rc6] nec jvc [sony]"

已启用的协议显示在 [] 括号中。

写入 “+proto” 会将协议添加到已启用协议的列表中。

写入 “-proto” 会从已启用协议的列表中删除协议。

写入 “proto” 将仅启用 “proto”。

写入 “none” 将禁用所有协议。

如果使用了无效的协议组合或未知的协议名称，则写入将失败并显示 EINVAL。

/sys/class/rc/rc<N>/wakeup_data

定义于文件 sysfs-class-rc-nuvoton

读取此文件会返回存储的 CIR 唤醒序列。它以脉冲开始，然后是空格，脉冲等。所有值都以微秒为单位。通过写入此文件，可以使用相同的格式将唤醒序列存储在 Nuvoton 芯片中。

注意：某些系统会在每次启动时将存储的唤醒序列重置为出厂默认值。在这样的系统上，请将唤醒序列存储在一个文件中，并在启动时使用例如 udev 规则进行设置。

/sys/class/rc/rc<N>/wakeup_filter

定义于文件 sysfs-class-rc

设置扫描码唤醒过滤器的预期值。

与 /sys/class/rc/rcN/wakeup_filter_mask 结合使用，以设置唤醒过滤器掩码中设置的位的预期值，以触发系统唤醒事件。

如果硬件支持且 wakeup_filter_mask 不为 0，则与过滤器匹配的扫描码将使系统从例如挂起到 RAM 或断电状态唤醒。

否则，写入将失败并显示错误。

如果唤醒协议更改，则此值可能会重置为 0。

/sys/class/rc/rc<N>/wakeup_filter_mask

定义于文件 sysfs-class-rc

设置要比较的扫描码唤醒过滤器位掩码。

与 /sys/class/rc/rcN/wakeup_filter 结合使用，以设置应与预期值进行比较的扫描码的位，以触发系统唤醒事件。

如果硬件支持且 wakeup_filter_mask 不为 0，则与过滤器匹配的扫描码将使系统从例如挂起到 RAM 或断电状态唤醒。

否则，写入将失败并显示错误。

如果唤醒协议更改，则此值可能会重置为 0。

/sys/class/rc/rc<N>/wakeup_protocols

定义于文件 sysfs-class-rc

读取此文件会返回用于唤醒过滤器的可用协议的列表，例如

"rc-5 nec nec-x rc-6-0 rc-6-6a-24 [rc-6-6a-32] rc-6-mce"

请注意，列出了协议变体，因此 “nec”、“sony”、“rc-5”、“rc-6” 列出了它们不同的位长度编码（如果可用）。

已启用的唤醒协议显示在 [] 括号中。

一次只能选择一个协议。

写入 “proto” 将使用 “proto” 进行唤醒事件。

写入 “none” 将禁用唤醒。

如果使用了无效的协议组合或未知的协议名称，或者硬件不支持唤醒，则写入将失败并显示 EINVAL。

/sys/class/regulator/.../bypass

定义于文件 sysfs-class-regulator

某些稳压器目录将包含一个名为 bypass 的字段。这表示设备是否处于旁路模式。

这将是以下字符串之一

  • “已启用”

  • “已禁用”

  • “unknown”

“已启用”表示稳压器处于旁路模式。

“已禁用”表示稳压器正在调节。

“未知”表示软件无法确定状态，或者报告的状态无效。

/sys/class/regulator/.../fail

定义于文件 sysfs-class-regulator

某些稳压器目录将包含一个名为 fail 的字段。这表示设备是否报告输出故障 (1) 或不报告 (0)。

/sys/class/regulator/.../max_microamps

定义于文件 sysfs-class-regulator

某些稳压器目录将包含一个名为 max_microamps 的字段。对于支持电流约束的稳压器，该字段保存此域的最大安全工作稳压器输出电流限制设置，以微安为单位。

注意：如果功率域没有平台代码定义的最大微安约束，则这将返回字符串“constraint not defined”。

/sys/class/regulator/.../max_microvolts

定义于文件 sysfs-class-regulator

某些稳压器目录将包含一个名为 max_microvolts 的字段。对于支持电压约束的稳压器，该字段保存此域的最大安全工作稳压器输出电压设置，以微伏为单位。

注意：如果功率域没有平台代码定义的最大微伏约束，则这将返回字符串“constraint not defined”。

/sys/class/regulator/.../microamps

定义于文件 sysfs-class-regulator

某些稳压器目录将包含一个名为 microamps 的字段。对于可以报告电流限制控制输入的稳压器，该字段保存稳压器输出电流限制设置，以微安 (即 E-6 安培) 为单位。

注意：不应使用此值来确定稳压器输出电流水平，因为无论稳压器是否启用，此值都相同。

/sys/class/regulator/.../microvolts

定义于文件 sysfs-class-regulator

某些稳压器目录会包含一个名为 microvolts 的字段。该字段保存稳压器输出电压的设置值，单位为微伏（即 10^-6 伏），适用于可以报告电压控制输入的稳压器。

注意：此值不应用于确定稳压器的输出电压水平，因为无论稳压器启用还是禁用，此值都相同。

/sys/class/regulator/.../min_microamps

定义于文件 sysfs-class-regulator

某些稳压器目录会包含一个名为 min_microamps 的字段。该字段保存该域的最小安全工作稳压器输出电流限制设置值，单位为微安，适用于支持电流约束的稳压器。

注意：如果该电源域没有平台代码定义的最小微安约束，则会返回字符串“constraint not defined”。

/sys/class/regulator/.../min_microvolts

定义于文件 sysfs-class-regulator

某些稳压器目录会包含一个名为 min_microvolts 的字段。该字段保存该域的最小安全工作稳压器输出电压设置值，单位为微伏，适用于支持电压约束的稳压器。

注意：如果该电源域没有平台代码定义的最小微伏约束，则会返回字符串“constraint not defined”。

/sys/class/regulator/.../name

定义于文件 sysfs-class-regulator

每个稳压器目录都会包含一个名为 name 的字段。该字段保存一个字符串，用于标识稳压器以进行显示。

注意：如果平台或稳压器驱动程序未提供合适的名称，则此字段将为空。

/sys/class/regulator/.../num_users

定义于文件 sysfs-class-regulator

每个稳压器目录都会包含一个名为 num_users 的字段。该字段保存已对该稳压器调用 regulator_enable() 的消费者设备的数量。

/sys/class/regulator/.../opmode

定义于文件 sysfs-class-regulator

某些稳压器目录会包含一个名为 opmode 的字段。该字段保存稳压器的当前工作模式，适用于可以报告该控制输入值的稳压器。

opmode 值可以是以下字符串之一

  • ‘fast’ (快速)

  • ‘normal’ (正常)

  • ‘idle’ (空闲)

  • ‘standby’ (待机)

  • “unknown”

这些模式在 include/linux/regulator/consumer.h 中进行了描述。

注意：此值不应用于确定稳压器的输出工作模式，因为无论稳压器启用还是禁用，此值都相同。可能存在一个“status”属性来确定实际模式。

/sys/class/regulator/.../over_current

定义于文件 sysfs-class-regulator

某些稳压器目录会包含一个名为 over_current 的字段。该字段指示设备是否报告过流故障（1）或未报告（0）。

/sys/class/regulator/.../over_current_warn

定义于文件 sysfs-class-regulator

某些稳压器目录会包含一个名为 over_current_warn 的字段。该字段指示设备是否报告过流警告（1）或未报告（0）。

/sys/class/regulator/.../over_temp

定义于文件 sysfs-class-regulator

某些稳压器目录会包含一个名为 over_temp 的字段。该字段指示设备是否报告过温故障（1）或未报告（0）。

/sys/class/regulator/.../over_temp_warn

定义于文件 sysfs-class-regulator

某些稳压器目录会包含一个名为 over_temp_warn 的字段。该字段指示设备是否报告过温警告（1）或未报告（0）。

/sys/class/regulator/.../over_voltage_warn

定义于文件 sysfs-class-regulator

某些稳压器目录会包含一个名为 over_voltage_warn 的字段。该字段指示设备是否报告过压警告（1）或未报告（0）。

/sys/class/regulator/.../parent

定义于文件 sysfs-class-regulator

某些稳压器目录会包含一个名为 parent 的链接。如果存在父级或供电稳压器，则该链接指向它。

/sys/class/regulator/.../regulation_out

定义于文件 sysfs-class-regulator

某些稳压器目录会包含一个名为 regulation_out 的字段。该字段指示设备是否报告失调故障（1）或未报告（0）。

/sys/class/regulator/.../requested_microamps

定义于文件 sysfs-class-regulator

某些稳压器目录会包含一个名为 requested_microamps 的字段。该字段保存来自所有消费者设备的该稳压器的总请求负载电流，单位为微安。

/sys/class/regulator/.../state

定义于文件 sysfs-class-regulator

某些稳压器目录会包含一个名为 state 的字段。该字段报告稳压器的启用控制，适用于可以报告该输入值的稳压器。

这将是以下字符串之一

‘enabled’ (已启用) ‘disabled’ (已禁用) ‘unknown’ (未知)

“enabled”表示稳压器输出已开启，并正在为系统供电（假设没有错误阻止它）。

“disabled”表示稳压器输出已关闭，并且没有为系统供电（除非某些非 Linux 控制已启用它）。

“未知”表示软件无法确定状态，或者报告的状态无效。

注意：此字段可以与 microvolts 或 microamps 结合使用，以确定配置的稳压器输出水平。

/sys/class/regulator/.../status

定义于文件 sysfs-class-regulator

某些稳压器目录会包含一个名为“status”的字段。该字段报告稳压器的当前状态，适用于可以报告该输出值的稳压器。

这将是以下字符串之一

  • off (关闭)

  • on (开启)

  • error (错误)

  • fast (快速)

  • 正常

  • 空闲

  • standby (待机)

“off”表示稳压器未向系统供电。

“on”表示稳压器正在向系统供电，并且稳压器无法报告详细的操作模式。

“error”表示失调状态，例如由于热关断而禁用，或由于输入电源问题导致电压不稳定。

“fast”、“normal”、“idle”和“standby”都是详细的稳压器操作模式（在其他地方进行了描述）。它们都暗示“on”，但提供了更多详细信息。

请注意，稳压器状态是许多输入的函数，不仅限于来自 Linux 的控制输入。例如，实际呈现的负载可能会触发“error”状态；或者稳压器可能被另一个用户启用，即使 Linux 没有启用它。

/sys/class/regulator/.../suspend_disk_microvolts

定义于文件 sysfs-class-regulator

某些稳压器目录会包含一个名为 suspend_disk_microvolts 的字段。该字段保存系统挂起到磁盘时该域的稳压器输出电压设置值，单位为微伏，适用于实现挂起电压配置约束的稳压器。

/sys/class/regulator/.../suspend_disk_mode

定义于文件 sysfs-class-regulator

某些稳压器目录会包含一个名为 suspend_disk_mode 的字段。该字段保存系统挂起到磁盘时该域的稳压器操作模式设置，适用于实现挂起模式配置约束的稳压器。

/sys/class/regulator/.../suspend_disk_state

定义于文件 sysfs-class-regulator

某些稳压器目录会包含一个名为 suspend_disk_state 的字段。该字段保存挂起到磁盘时稳压器的操作状态，适用于实现挂起配置约束的稳压器。

这与“state”属性报告的字符串相同。

/sys/class/regulator/.../suspend_mem_microvolts

定义于文件 sysfs-class-regulator

某些稳压器目录会包含一个名为 suspend_mem_microvolts 的字段。该字段保存系统挂起到内存时该域的稳压器输出电压设置值，单位为微伏，适用于实现挂起电压配置约束的稳压器。

/sys/class/regulator/.../suspend_mem_mode

定义于文件 sysfs-class-regulator

某些稳压器目录会包含一个名为 suspend_mem_mode 的字段。该字段保存系统挂起到内存时该域的稳压器操作模式设置，适用于实现挂起模式配置约束的稳压器。

/sys/class/regulator/.../suspend_mem_state

定义于文件 sysfs-class-regulator

某些稳压器目录会包含一个名为 suspend_mem_state 的字段。该字段保存挂起到内存时稳压器的操作状态，适用于实现挂起配置约束的稳压器。

这与“state”属性报告的字符串相同。

/sys/class/regulator/.../suspend_standby_microvolts

定义于文件 sysfs-class-regulator

某些稳压器目录会包含一个名为 suspend_standby_microvolts 的字段。该字段保存系统挂起到待机状态时该域的稳压器输出电压设置值，单位为微伏，适用于实现挂起电压配置约束的稳压器。

/sys/class/regulator/.../suspend_standby_mode

定义于文件 sysfs-class-regulator

某些稳压器目录会包含一个名为 suspend_standby_mode 的字段。该字段保存系统挂起到待机状态时该域的稳压器操作模式设置，适用于实现挂起模式配置约束的稳压器。

/sys/class/regulator/.../suspend_standby_state

定义于文件 sysfs-class-regulator

某些稳压器目录会包含一个名为 suspend_standby_state 的字段。该字段保存挂起到待机状态时稳压器的操作状态，适用于实现挂起配置约束的稳压器。

这与“state”属性报告的字符串相同。

/sys/class/regulator/.../type

定义于文件 sysfs-class-regulator

每个稳压器目录都会包含一个名为 type 的字段。该字段保存稳压器的类型。

这将是以下字符串之一

  • ‘voltage’ (电压)

  • ‘current’ (电流)

  • “unknown”

“voltage”表示稳压器输出电压可以通过软件控制。

“current”表示稳压器输出电流限制可以通过软件控制。

“unknown”表示软件无法控制电压或电流限制。

/sys/class/regulator/.../under_voltage

定义于文件 sysfs-class-regulator

某些稳压器目录会包含一个名为 under_voltage 的字段。该字段指示设备是否报告欠压故障（1）或未报告（0）。

/sys/class/regulator/.../under_voltage_warn

定义于文件 sysfs-class-regulator

某些稳压器目录会包含一个名为 under_voltage_warn 的字段。该字段指示设备是否报告欠压警告（1）或未报告（0）。

/sys/class/remoteproc/.../coredump

在文件 sysfs-class-remoteproc 中定义

远程处理器核心转储配置

报告远程处理器的核心转储配置，该配置将是以下之一

“disabled” (已禁用) “enabled” (已启用) “inline” (内联)

“disabled”表示不会收集任何转储。

“enabled”表示当收集远程处理器的核心转储时，它将被复制到一个单独的缓冲区，并且该缓冲区将暴露给用户空间。

“inline”表示当收集远程处理器的核心转储时，用户空间将直接从远程处理器的设备内存中读取。不会使用额外的缓冲区来复制转储。此外，在用户空间读取所有数据之前，恢复过程将不会继续。

/sys/class/remoteproc/.../firmware

在文件 sysfs-class-remoteproc 中定义

远程处理器固件

报告当前加载到远程处理器的固件的名称。

要更改正在运行的固件，请确保远程处理器已停止（使用 /sys/class/remoteproc/.../state）并写入新的文件名。

/sys/class/remoteproc/.../name

在文件 sysfs-class-remoteproc 中定义

远程处理器名称

报告远程处理器的名称。用户空间可以使用它来准确识别远程处理器，并简化修改“firmware”或“state”文件的使用。

/sys/class/remoteproc/.../recovery

在文件 sysfs-class-remoteproc 中定义

远程处理器恢复机制

报告远程处理器的恢复机制，该机制将是以下之一

“enabled” (已启用) “disabled” (已禁用)

“enabled”表示，每当远程处理器崩溃时，都会自动恢复。此外，如果远程处理器在禁用恢复时崩溃，一旦启用恢复，它也会自动恢复。

“disabled”表示，如果远程处理器崩溃，它将保持崩溃状态。这对于调试目的很有用；如果没有它，调试崩溃会困难得多。

/sys/class/remoteproc/.../state

在文件 sysfs-class-remoteproc 中定义

远程处理器状态

报告远程处理器的状态，该状态将是以下之一

  • “offline” (离线)

  • “suspended” (已挂起)

  • “running” (运行中)

  • “crashed”

  • “invalid” (无效)

“offline”表示远程处理器已断电。

“suspended”表示远程处理器已挂起，必须唤醒才能接收消息。

“running”是可用远程处理器的正常状态

“crashed”表示在远程处理器上检测到问题/崩溃。

如果远程处理器处于未知状态，则返回“invalid”。

写入此文件可控制远程处理器的状态。可以写入以下状态

  • “start” (启动)

  • “stop” (停止)

写入“start”将尝试启动处理器，运行由 /sys/class/remoteproc/.../firmware 指示或写入的固件。远程处理器应转换为“running”状态。

写入“stop”将尝试停止远程处理器并将其返回到“offline”状态。

/sys/class/rnbd-client

在文件 sysfs-class-rnbd-client 中定义

提供有关 RNBD 客户端的信息。所有非只读的 sysfs 文件都会在读取时提供用法信息

示例

# cat /sys/class/rnbd-client/ctl/map_device

> Usage: echo "sessname=<name of the rtrs session> path=<[srcaddr,]dstaddr>
> [path=<[srcaddr,]dstaddr>] device_path=<full path on remote side>
> [access_mode=<ro|rw|migration>] > map_device
>
> addr ::= [ ip:<ipv4> | ip:<ipv6> | gid:<gid> ]

/sys/class/rnbd-client/ctl/devices/

在文件 sysfs-class-rnbd-client 中定义

对于客户端上映射的每个设备，都会创建一个新的符号链接，其路径为 /sys/class/rnbd-client/ctl/devices/<device_id>@<session_name>，它指向 rnbd 创建的块设备 (/sys/block/rnbd<N>/)。每个设备的 <device_id> 的创建方式如下：

  • 如果在映射期间提供的 ‘device_path’ 包含斜杠（“/”），则斜杠将被替换为感叹号（“!”），并用作 <device_id>。否则，<device_id> 将与提供的 “device_path” 相同。

/sys/class/rnbd-client/ctl/map_device

在文件 sysfs-class-rnbd-client 中定义

期望的格式如下：

sessname=<name of the rtrs session>
path=<[srcaddr,]dstaddr> [path=<[srcaddr,]dstaddr> ...]
device_path=<full path on remote side>
[access_mode=<ro|rw|migration>]

其中：

sessname

接受一个不大于 256 个字符的字符串，该字符串标识客户端和服务器上的给定会话。例如，“clt_hostname-srv_hostname”可能是一个自然的选择。

path

通过指定目标地址以及在需要时指定源地址来描述客户端和服务器之间的连接。地址的格式如下：

ip:<IPv6>
ip:<IPv4>
gid:<GID>

例如：

path=ip:10.0.0.66

单个 addr 被视为目标地址。连接将从任何客户端 IP 地址建立到此服务器。

path=ip:10.0.0.66,ip:10.0.1.66

第一个 addr 是源地址，第二个是目标地址。

如果指定了多个 “path=” 选项，则将建立多个连接，并且将根据所选的多路径策略发送数据（请参阅 RTRS mp_policy sysfs 条目描述）。

device_path

服务器端块设备的路径。路径是相对于 rnbd_server 的 ‘dev_search_path’ 模块参数中配置的服务器端目录指定的。rnbd_server 将从客户端接收到的 <device_path> 与 <dev_search_path> 前缀连接，并尝试打开 <dev_search_path>/<device_path> 块设备。成功后，将创建 /dev/rnbd<N> 设备文件、/sys/block/rnbd<N>/ 目录以及 /sys/class/rnbd-client/ctl/devices 中的条目。

如果 ‘dev_search_path’ 包含 ‘%SESSNAME%’，则每个会话可以具有不同的设备命名空间。例如，服务器配置了以下参数 “dev_search_path=/run/rnbd-devs/%SESSNAME%”，客户端具有字符串 “sessname=blya device_path=sda”，则服务器将尝试打开：/run/rnbd-devs/blya/sda。

access_mode

access_mode 参数指定是否将设备映射为“ro”只读或“rw”读写。服务器只允许设备以 rw 模式导出一次。如果需要第二次以读写模式映射，则必须指定 “migration” 访问模式。

默认情况下使用 “rw”。

nr_poll_queues

指定轮询模式队列的数量。如果 IO 具有 HIPRI 标志，则块层将通过轮询模式队列发送 IO。对于快速网络和设备，轮询比基于中断的 IO 处理更快，因为它节省了上下文切换、切换到另一个进程、处理中断以及切换回发出进程的时间。

如果要将其设置为 CPU 的数量，则设置为 -1。默认情况下，rnbd 客户端仅创建 irq 模式队列。

注意：必须为使用轮询模式队列的设备创建唯一的会话。

退出代码

如果设备已被映射，则将失败并返回 EEXIST。如果输入格式无效，则将返回 EINVAL。如果服务器上找不到设备路径，则将失败并返回 ENOENT。

映射后查找设备文件

映射后，可以通过以下方式找到设备文件：o 符号链接 /sys/class/rnbd-client/ctl/devices/<device_id>@<session_name> 指向 /sys/block/<dev-name>。符号链接目标的最后一部分与设备名称相同。通过提取路径的最后一部分，可以构建设备路径 /dev/<dev-name>。

  • /dev/block/$(cat /sys/class/rnbd-client/ctl/devices/<device_id>@<session_name>/dev)

如何在下一节中描述如何查找设备的 <device_id>。

/sys/class/rnbd-server

在文件 sysfs-class-rnbd-server 中定义

提供有关 RNBD 服务器的信息。

/sys/class/rnbd-server/ctl/

在文件 sysfs-class-rnbd-server 中定义

当客户端映射设备时，会在 /sys/class/rnbd-server/ctl/devices/ 下创建一个以块设备名称命名的目录条目。

/sys/class/rnbd-server/ctl/devices/<device_name>/block_dev

在文件 sysfs-class-rnbd-server 中定义

是指向导出设备的 sysfs 条目的符号链接。

示例：block_dev -> ../../../../class/block/ram0

/sys/class/rnbd-server/ctl/devices/<device_name>/sessions/

在文件 sysfs-class-rnbd-server 中定义

对于特定设备导出的每个客户端，将创建以下目录：

/sys/class/rnbd-server/ctl/devices/<device_name>/sessions/<session-name>/

当客户端取消映射设备时，该目录将被删除。

/sys/class/rnbd-server/ctl/devices/<device_name>/sessions/<session-name>/access_mode

在文件 sysfs-class-rnbd-server 中定义

包含设备访问模式：ro、rw 或迁移。

/sys/class/rnbd-server/ctl/devices/<device_name>/sessions/<session-name>/force_close

在文件 sysfs-class-rnbd-server 中定义

向文件写入 “1” 以关闭服务器端的设备。请注意，客户端设备不会被关闭，对该设备的读取或写入操作将返回 -ENOTCONN。

/sys/class/rnbd-server/ctl/devices/<device_name>/sessions/<session-name>/mapping_path

在文件 sysfs-class-rnbd-server 中定义

包含用户在映射期间提供的相对设备路径。

/sys/class/rnbd-server/ctl/devices/<device_name>/sessions/<session-name>/read_only

在文件 sysfs-class-rnbd-server 中定义

如果设备以只读方式映射，则包含 ‘1’，否则为 ‘0’。

/sys/class/rtc/

在文件 sysfs-class-rtc 中定义

rtc/ 类子目录属于 RTC 子系统。

/sys/class/rtc/rtc0/device/rtc_calibration

在文件 sysfs-class-rtc-rtc0-device-rtc_calibration 中定义

用于校准 ST-Ericsson AB8500 实时时钟的属性。rtc_calibration 属性允许用户空间校准 AB8500 的 32KHz 实时时钟。每 60 秒，AB8500 将通过向 RTC 的值添加此属性的值来纠正 RTC 的值。

该属性的范围为 -127 到 +127，单位为 30.5 微秒（32KHz 时钟的百万分之半）

用户：/vendor/st-ericsson/base_utilities/core/rtc_calibration 守护程序使用此接口。

/sys/class/rtc/rtcX/

在文件 sysfs-class-rtc 中定义

/sys/class/rtc/rtc{0,1,2,3,...} 目录对应于每个 RTC 设备。

/sys/class/rtc/rtcX/date

在文件 sysfs-class-rtc 中定义

(只读) RTC 提供的日期，格式为 YYYY-MM-DD

/sys/class/rtc/rtcX/hctosys

在文件 sysfs-class-rtc 中定义

(只读) 如果 RTC 在启动时通过 CONFIG_RTC_HCTOSYS 内核选项提供了系统时间，则为 1，否则为 0

/sys/class/rtc/rtcX/max_user_freq

在文件 sysfs-class-rtc 中定义

(读写) 未授权用户可以从此 RTC 请求的最大中断速率。

/sys/class/rtc/rtcX/name

在文件 sysfs-class-rtc 中定义

(只读) 与此 sysfs 目录对应的 RTC 的名称

/sys/class/rtc/rtcX/offset

在文件 sysfs-class-rtc 中定义

(读写) 固件中调整 rtc 时钟的量。仅当驱动程序支持时钟偏移调整时才可见。单位为十亿分之一，即每十亿个时钟滴答声添加到或从 rtc 的基准时钟中移除的时钟滴答声数量。正值使一天过得更慢、更长，负值使一天过得更快。

/sys/class/rtc/rtcX/range

在文件 sysfs-class-rtc 中定义

RTC 的有效时间范围，以自纪元以来的秒数表示，格式为 [min, max]

/sys/class/rtc/rtcX/since_epoch

在文件 sysfs-class-rtc 中定义

(只读) RTC 提供的时间，以自纪元以来的秒数表示

/sys/class/rtc/rtcX/time

在文件 sysfs-class-rtc 中定义

(只读) RTC 提供的时间，采用 24 小时制 (hh:mm:ss)

/sys/class/rtc/rtcX/wakealarm

在文件 sysfs-class-rtc 中定义

(读写) 时钟将生成系统唤醒事件的时间。这是一个一次性的唤醒事件，因此如果需要每天唤醒，则必须在唤醒后重置。格式默认是自纪元以来的秒数，或者，如果前面有 +，则表示未来的秒数；或者，如果前面有 +=，则表示当前警报之前的秒数。

/sys/class/rtrs-client

在文件 sysfs-class-rtrs-client 中定义

当 RTRS API 的用户创建一个新会话时，会在 /sys/class/rtrs-client/<session-name>/ 下创建一个以该会话名称命名的目录条目。

/sys/class/rtrs-client/<session-name>/add_path

在文件 sysfs-class-rtrs-client 中定义

读写，向现有会话添加新路径（连接）。期望的格式如下：

<[source addr,]destination addr>
*addr ::= [ ip:<ipv4|ipv6> | gid:<gid> ]

/sys/class/rtrs-client/<session-name>/max_reconnect_attempts

在文件 sysfs-class-rtrs-client 中定义

客户端在连接意外断开后放弃之前应尝试的最大重新连接次数。

/sys/class/rtrs-client/<session-name>/mp_policy

在文件 sysfs-class-rtrs-client 中定义

多路径策略指定每个 IO 应选择哪个路径

轮循 (0)

以每个 CPU 轮循的方式选择路径。

最小飞行中 (1)

选择飞行中最少的路径。

最小延迟 (2)

选择延迟最小的路径。

/sys/class/rtrs-client/<session-name>/paths/

在文件 sysfs-class-rtrs-client 中定义

属于给定会话的每个路径都通过其源地址和目标地址在此处列出。当通过写入 “add_path” 条目向会话添加新路径时，将创建一个 <src@dst> 目录。

/sys/class/rtrs-client/<session-name>/paths/<src@dst>/cur_latency

在文件 sysfs-class-rtrs-client 中定义

只读，包含由心跳消息计算的延迟时间。每当客户端发送心跳消息时，它会检查发送心跳消息和接收 ACK 之间的时间间隔。此值可以定期更改。

/sys/class/rtrs-client/<session-name>/paths/<src@dst>/disconnect

在文件 sysfs-class-rtrs-client 中定义

向文件写入 “1” 以断开路径的连接。操作会阻塞，直到 RTRS 路径断开连接。

/sys/class/rtrs-client/<session-name>/paths/<src@dst>/dst_addr

在文件 sysfs-class-rtrs-client 中定义

只读，包含路径的目标地址

/sys/class/rtrs-client/<session-name>/paths/<src@dst>/hca_name

在文件 sysfs-class-rtrs-client 中定义

只读，包含连接建立在其上的 HCA 的名称。

/sys/class/rtrs-client/<session-name>/paths/<src@dst>/hca_port

在文件 sysfs-class-rtrs-client 中定义

只读，包含流量正在通过的活动端口的端口号。

/sys/class/rtrs-client/<session-name>/paths/<src@dst>/reconnect

在文件 sysfs-class-rtrs-client 中定义

向文件写入 “1” 以重新连接路径。操作是阻塞的，如果重新连接成功则返回 0。

/sys/class/rtrs-client/<session-name>/paths/<src@dst>/remove_path

在文件 sysfs-class-rtrs-client 中定义

向文件写入 “1” 以断开连接并从会话中删除路径。操作会阻塞，直到路径断开连接并从会话中删除。

/sys/class/rtrs-client/<session-name>/paths/<src@dst>/src_addr

在文件 sysfs-class-rtrs-client 中定义

只读，包含路径的源地址

/sys/class/rtrs-client/<session-name>/paths/<src@dst>/state

在文件 sysfs-class-rtrs-client 中定义

只读，如果会话已连接到对等方并且功能完全正常，则包含 “connected”。否则，该文件包含 “disconnected”

/sys/class/rtrs-client/<会话名称>/paths/<源地址@目标地址>/stats/cpu_migration

在文件 sysfs-class-rtrs-client 中定义

RTRS 期望每个 HCA IRQ 都被绑定到单独的 CPU 上。如果不是这种情况，I/O 响应的处理可能会在与最初提交该响应不同的 CPU 上进行。此文件显示了有多少中断是在非预期的 CPU 上生成的。

“from:”

是预期生成 IRQ 的 CPU，但实际上并没有生成。

“to:”

是实际生成 IRQ 的 CPU，但不是预期的 CPU。

/sys/class/rtrs-client/<会话名称>/paths/<源地址@目标地址>/stats/rdma

在文件 sysfs-class-rtrs-client 中定义

包含有关 rdma 操作和 inflight 操作的统计信息。输出由 6 个值组成

<read-count> <read-total-size> <write-count> \
<write-total-size> <inflights> <failovered>

/sys/class/rtrs-client/<会话名称>/paths/<源地址@目标地址>/stats/reconnects

在文件 sysfs-class-rtrs-client 中定义

包含 2 个无符号整数值，第一个记录路径生命周期内成功重新连接的次数，第二个记录路径生命周期内失败重新连接的次数。

/sys/class/rtrs-client/<会话名称>/paths/<源地址@目标地址>/stats/reset_all

在文件 sysfs-class-rtrs-client 中定义

读写属性（RW），读取将返回使用帮助，写入 0 将清除所有统计信息。

/sys/class/rtrs-server

定义在文件 sysfs-class-rtrs-server 中

当 RTRS API 的用户在客户端创建一个新会话时，这里会创建一个以该会话名称命名的目录条目。

/sys/class/rtrs-server/<会话名称>/paths/

定义在文件 sysfs-class-rtrs-server 中

当通过写入客户端的“add_path”条目创建新路径时，服务器上会创建一个名为 <源地址>@<目标地址> 的目录条目。

/sys/class/rtrs-server/<会话名称>/paths/<源地址@目标地址>/disconnect

定义在文件 sysfs-class-rtrs-server 中

当向该文件写入“1”时，RTRS 会话将被断开连接。操作是非阻塞的，并立即将控制权返回给调用者。

/sys/class/rtrs-server/<会话名称>/paths/<源地址@目标地址>/dst_addr

定义在文件 sysfs-class-rtrs-server 中

只读，包含路径的目标地址

/sys/class/rtrs-server/<会话名称>/paths/<源地址@目标地址>/hca_name

定义在文件 sysfs-class-rtrs-server 中

只读，包含连接建立在其上的 HCA 的名称。

/sys/class/rtrs-server/<会话名称>/paths/<源地址@目标地址>/hca_port

定义在文件 sysfs-class-rtrs-server 中

只读，包含流量正在通过的活动端口的端口号。

/sys/class/rtrs-server/<会话名称>/paths/<源地址@目标地址>/src_addr

定义在文件 sysfs-class-rtrs-server 中

只读，包含路径的源地址

/sys/class/rtrs-server/<会话名称>/paths/<源地址@目标地址>/stats/rdma

定义在文件 sysfs-class-rtrs-server 中

包含有关 rdma 操作和 inflight 操作的统计信息。输出由 5 个值组成：<读取次数> <读取总大小> <写入次数> <写入总大小> <进行中操作数>

/sys/class/scsi_device/*/device/dyn_cap_needed

定义在文件 sysfs-driver-ufs 中

此文件显示需要从特定逻辑单元的物理内存资源池中删除的物理内存量。有关该属性的完整信息，请参阅 UFS 规范 2.1。

该文件为只读。

/sys/class/scsi_device/*/device/unit_descriptor/boot_lun_id

定义在文件 sysfs-driver-ufs 中

此文件显示引导 LUN 信息。这是 UFS 单元描述符参数之一。有关描述符的完整信息，请参阅 UFS 规范 2.1。

该文件为只读。

/sys/class/scsi_device/*/device/unit_descriptor/context_capabilities

定义在文件 sysfs-driver-ufs 中

此文件显示上下文功能。这是 UFS 单元描述符参数之一。有关描述符的完整信息，请参阅 UFS 规范 2.1。

该文件为只读。

/sys/class/scsi_device/*/device/unit_descriptor/data_reliability

定义在文件 sysfs-driver-ufs 中

此文件定义在写入操作期间发生电源故障时设备的行为。这是 UFS 单元描述符参数之一。有关描述符的完整信息，请参阅 UFS 规范 2.1。

该文件为只读。

/sys/class/scsi_device/*/device/unit_descriptor/erase_block_size

定义在文件 sysfs-driver-ufs 中

此文件显示擦除块大小。这是 UFS 单元描述符参数之一。有关描述符的完整信息，请参阅 UFS 规范 2.1。

该文件为只读。

/sys/class/scsi_device/*/device/unit_descriptor/large_unit_granularity

定义在文件 sysfs-driver-ufs 中

此文件显示 LUN 的粒度。这是 UFS 单元描述符参数之一。有关描述符的完整信息，请参阅 UFS 规范 2.1。

该文件为只读。

/sys/class/scsi_device/*/device/unit_descriptor/logical_block_count

定义在文件 sysfs-driver-ufs 中

此文件显示可寻址逻辑块的总数。这是 UFS 单元描述符参数之一。有关描述符的完整信息，请参阅 UFS 规范 2.1。

该文件为只读。

/sys/class/scsi_device/*/device/unit_descriptor/logical_block_size

定义在文件 sysfs-driver-ufs 中

此文件显示可寻址逻辑块的大小（计算为以 2 为底的指数）。这是 UFS 单元描述符参数之一。有关描述符的完整信息，请参阅 UFS 规范 2.1。

该文件为只读。

/sys/class/scsi_device/*/device/unit_descriptor/lun_memory_type

定义在文件 sysfs-driver-ufs 中

此文件显示 LUN 内存类型。这是 UFS 单元描述符参数之一。有关描述符的完整信息，请参阅 UFS 规范 2.1。

该文件为只读。

/sys/class/scsi_device/*/device/unit_descriptor/lun_queue_depth

定义在文件 sysfs-driver-ufs 中

此文件显示 LUN 队列深度。这是 UFS 单元描述符参数之一。有关描述符的完整信息，请参阅 UFS 规范 2.1。

该文件为只读。

/sys/class/scsi_device/*/device/unit_descriptor/lun_write_protect

定义在文件 sysfs-driver-ufs 中

此文件显示 LUN 写保护状态。这是 UFS 单元描述符参数之一。有关描述符的完整信息，请参阅 UFS 规范 2.1。

该文件为只读。

/sys/class/scsi_device/*/device/unit_descriptor/physical_memory_resourse_count

定义在文件 sysfs-driver-ufs 中

此文件显示物理内存资源总数。这是 UFS 单元描述符参数之一。有关描述符的完整信息，请参阅 UFS 规范 2.1。

该文件为只读。

/sys/class/scsi_device/*/device/unit_descriptor/provisioning_type

定义在文件 sysfs-driver-ufs 中

此文件显示精简配置类型。这是 UFS 单元描述符参数之一。有关描述符的完整信息，请参阅 UFS 规范 2.1。

该文件为只读。

/sys/class/scsi_device/*/device/unit_descriptor/psa_sensitive

定义在文件 sysfs-driver-ufs 中

此文件显示 PSA 敏感度。这是 UFS 单元描述符参数之一。有关描述符的完整信息，请参阅 UFS 规范 2.1。

该文件为只读。

/sys/class/scsi_device/*/device/unit_descriptor/wb_buf_alloc_units

定义在文件 sysfs-driver-ufs 中

此条目显示 WriteBooster 缓冲区的配置大小。0400h 对应于 4GB。

该文件为只读。

/sys/class/scsi_host/hostX/acciopath_status

定义在文件 sysfs-class-scsi_host 中

此文件包含使用 hpsa 驱动程序的 HP Smart Array RAID 控制器的“SSD 智能路径”功能的当前状态。启用 SSD 智能路径后，驱动程序可以直接将 I/O 请求发送到作为逻辑驱动器一部分的物理设备，从而在可能的情况下绕过控制器固件 RAID 堆栈以获得性能优势。值为“1”表示该功能已启用，并且控制器可以使用到物理设备的直接 I/O 路径。值为零表示该功能已禁用，并且控制器可能不使用到物理设备的直接 I/O 路径。此设置是控制器范围的，会影响控制器上所有配置的逻辑驱动器。此文件是可读写的。

/sys/class/scsi_host/hostX/ahci_host_version

定义在文件 sysfs-class-scsi_host 中

（只读）显示主机实现的 AHCI 规范的版本。

/sys/class/scsi_host/hostX/ahci_port_cmd

/sys/class/scsi_host/hostX/ahci_host_caps

/sys/class/scsi_host/hostX/ahci_host_cap2

定义在文件 sysfs-class-scsi_host 中

[待记录文档]

/sys/class/scsi_host/hostX/em_buffer

定义在文件 sysfs-class-scsi_host 中

（读写）如果主机支持 EM，则允许直接访问 AHCI EM（机箱管理）缓冲区。

例如，AHCI 驱动程序支持 SGPIO EM 消息，但 SATA/AHCI 规范未定义 EM 缓冲区的 SGPIO 消息格式。不同的硬件 (HW) 供应商可能有不同的定义。通过 em_buffer 属性，可以通过允许硬件供应商为其 SGPIO 发起者提供用户空间驱动程序和工具来解决此问题。

/sys/class/scsi_host/hostX/em_message_supported

定义在文件 sysfs-class-scsi_host 中

（只读）显示支持的机箱管理消息类型。

/sys/class/scsi_host/hostX/em_message

/sys/class/scsi_host/hostX/em_message_type

定义在文件 sysfs-class-scsi_host 中

em_message:（读写）机箱管理支持。对于 LED 协议，写入和读取对应于 AHCI 规范中定义的 LED 消息格式。

如果用户希望通过 em_message 文件控制活动 LED，则必须关闭 sw_activity（在/sys/block/*/device/下）。

em_message_type:（只读）显示驱动程序当前正在使用的机箱管理协议（例如，LED、SAF-TE、SES-2、SGPIO 等）。

/sys/class/scsi_host/hostX/isci_id

定义在文件 sysfs-class-scsi_host 中

此文件包含 Intel SCU 控制器的枚举主机 ID。 Intel(R) C600 系列芯片组 SATA/SAS 存储控制单元在一个 PCI 设备中嵌入了最多两个 4 端口控制器。控制器按顺序枚举，这通常意味着编号最小的 scsi_host 对应于第一个控制器，但不能保证此关联。“isci_id”属性明确标识控制器索引：“0”表示第一个控制器，“1”表示第二个控制器。

定义在文件 sysfs-class-scsi_host 中

（读写）此参数允许用户读取和设置链路（接口）电源管理。

有四种可能的选项

min_power：告知控制器尽可能使链路使用最少的功率。当从较低功耗状态出来时，由于延迟增加，这可能会牺牲一些性能。

max_performance：通常，这意味着没有电源管理。告知控制器将性能置于电源管理之上。

medium_power：告知控制器尽可能进入较低功耗状态，但不要进入最低功耗状态，从而提高延迟并优于 min_power 设置。

med_power_with_dipm：与现有的 medium_power 设置相同，只是它在顶部启用了 dipm（设备启动的电源管理），这使其与 Windows IRST（英特尔快速存储技术）驱动程序设置相匹配。此设置也接近 min_power，但

  1. 它不使用主机启动的休眠模式，但它确实允许设备启动的休眠

  2. 它不启用低功耗设备睡眠模式 (DevSlp)。

/sys/class/scsi_tape/*/stats/in_flight

定义在文件 sysfs-class-scsi_tape 中

显示当前在 st 模块和 SCSI 中间层之间正在进行的 I/O 数量。

/sys/class/scsi_tape/*/stats/io_ns

定义在文件 sysfs-class-scsi_tape 中

显示等待往返磁带驱动器的所有 I/O 完成所花费的总时间。这包括所有读取、写入和发送到磁带驱动器的其他 SCSI 命令。其他 SCSI 命令的一个示例是磁带移动，例如在关闭倒带磁带设备时倒带。此项以纳秒为单位进行测量。

要确定等待其他 I/O 完成所花费的时间量，请从此值中减去 read_ns 和 write_ns。

/sys/class/scsi_tape/*/stats/other_cnt

定义在文件 sysfs-class-scsi_tape 中

发送到磁带驱动器的 I/O 请求的数量，而不是 SCSI 读取/写入请求。

/sys/class/scsi_tape/*/stats/read_byte_cnt

定义在文件 sysfs-class-scsi_tape 中

显示从磁带驱动器请求的字节总数。此值以字节为单位表示，因为磁带驱动器支持可变长度的块大小。

/sys/class/scsi_tape/*/stats/read_cnt

定义在文件 sysfs-class-scsi_tape 中

显示发送到磁带驱动器的读取请求的总数。

/sys/class/scsi_tape/*/stats/read_ns

定义在文件 sysfs-class-scsi_tape 中

显示等待读取 I/O 请求完成的总时间（以纳秒为单位）。

/sys/class/scsi_tape/*/stats/resid_cnt

定义在文件 sysfs-class-scsi_tape 中

显示当 SCSI 中间层指示存在错误时，发现残余值 >0 的次数。对于读取操作，这可能是因为有人发出的读取操作大于块大小。

/sys/class/scsi_tape/*/stats/write_byte_cnt

定义在文件 sysfs-class-scsi_tape 中

显示写入磁带驱动器的总字节数。此值以字节为单位表示，因为磁带驱动器支持可变长度的块大小。

/sys/class/scsi_tape/*/stats/write_cnt

定义在文件 sysfs-class-scsi_tape 中

显示向磁带驱动器发出的写入请求的总数。

/sys/class/scsi_tape/*/stats/write_ms

定义在文件 sysfs-class-scsi_tape 中

显示等待写入 I/O 请求完成的总时间（以纳秒为单位）。

/sys/class/spi_master/spi<bus>/spi<bus>.<dev>/fram

定义于文件 sysfs-class-spi-eeprom

包含 FRAM 二进制数据。与 EEPROM 相同，只是另一个文件名，用于指示它采用铁电工艺。它以总线速度执行写入操作 - 没有写入延迟。

/sys/class/spi_master/spi<bus>/spi<bus>.<dev>/sernum

定义于文件 sysfs-class-spi-eeprom

如果存在，则包含 Cypress FRAM (FM25VN) 的序列号。它将显示为从设备读取的 8 字节十六进制字符串。

这是一个只读属性。

/sys/class/stm/<stm>/channels

定义于文件 sysfs-class-stm

显示此 STM 设备上每个主设备的通道数。

/sys/class/stm/<stm>/hw_override

定义于文件 sysfs-class-stm

如果此 stm 设备生成的 STP 流中的主设备号与软件分配的主设备号匹配，则读取为 0；如果 stm 硬件覆盖软件分配的主设备号，则读取为 1。

/sys/class/stm/<stm>/masters

定义于文件 sysfs-class-stm

显示此 STM 设备上软件可用的第一个和最后一个主设备号。

定义于文件 sysfs-class-stm_source

stm_source 设备到 stm 设备的链接，其跟踪数据定向到该设备。读取操作将返回现有连接，如果此 stm_source 尚未连接到任何 stm 设备，则返回“<none>”。在此处写入现有（已注册）的 stm 设备名称以连接该设备。如果设备已连接到此 stm_source，则将首先断开连接。

/sys/class/switchtec

定义于文件 sysfs-class-switchtec

switchtec 类子系统文件夹。每个已注册的 switchtec 驱动程序都由一个 switchtecX 子文件夹表示（X 为大于或等于 0 的整数）。

/sys/class/switchtec/switchtec[0-9]+/component_id

定义于文件 sysfs-class-switchtec

硬件中存储的组件标识符（例如 PM8543）（只读）值：任意字符串。

/sys/class/switchtec/switchtec[0-9]+/component_revision

定义于文件 sysfs-class-switchtec

硬件中存储的组件修订版（只读）值：整数。

/sys/class/switchtec/switchtec[0-9]+/component_vendor

定义于文件 sysfs-class-switchtec

硬件中存储的组件供应商（例如 MICROSEM）（只读）值：任意字符串。

/sys/class/switchtec/switchtec[0-9]+/device_version

定义于文件 sysfs-class-switchtec

硬件中存储的设备版本（只读）值：整数。

/sys/class/switchtec/switchtec[0-9]+/fw_version

定义于文件 sysfs-class-switchtec

当前运行的固件版本（只读）值：整数（十六进制）。

/sys/class/switchtec/switchtec[0-9]+/partition

定义于文件 sysfs-class-switchtec

此设备在交换机中的分区号（只读）值：整数。

/sys/class/switchtec/switchtec[0-9]+/partition_count

定义于文件 sysfs-class-switchtec

交换机中的总分区数（只读）值：整数。

/sys/class/switchtec/switchtec[0-9]+/product_id

定义于文件 sysfs-class-switchtec

硬件中存储的产品标识符（例如 PSX 48XG3）（只读）值：任意字符串。

/sys/class/switchtec/switchtec[0-9]+/product_revision

定义于文件 sysfs-class-switchtec

硬件中存储的产品修订版（例如 RevB）（只读）值：任意字符串。

/sys/class/switchtec/switchtec[0-9]+/product_vendor

定义于文件 sysfs-class-switchtec

硬件中存储的产品供应商（例如 MICROSEM）（只读）值：任意字符串。

/sys/class/tee/tee{,priv}X/rpmb_routing_model

定义于文件 sysfs-class-tee

RPMB 帧可以通过用户空间守护进程 tee-supplicant 或内核中的 RPMB 子系统路由到 RPMB 设备。值“user”表示驱动程序将通过用户空间路由 RPMB 帧。相反，“kernel”表示帧通过 RPMB 子系统路由，无需 tee-supplicant 的帮助。如果变量不存在，则应假定 RPMB 帧通过用户空间路由。此变量的主要目的是让 systemd 知道是否需要在 initramfs 的早期启动中启动 tee-supplicant。

/sys/class/thermal/cooling_deviceX/cur_state

定义于文件 sysfs-class-thermal

此冷却设备的当前冷却状态。该值可以是 0 到 max_state 之间的任何整数。

  • cur_state == 0 表示不冷却

  • cur_state == max_state 表示最大冷却。

读写，必需

/sys/class/thermal/cooling_deviceX/max_state

定义于文件 sysfs-class-thermal

此冷却设备的最大允许冷却状态。

只读，必需

/sys/class/thermal/cooling_deviceX/stats/reset

定义于文件 sysfs-class-thermal

写入任何值都会重置冷却设备的统计信息。

只写，必需

/sys/class/thermal/cooling_deviceX/stats/time_in_state_ms

定义于文件 sysfs-class-thermal

冷却设备在各种冷却状态下花费的时间量。输出的每一行都将包含 “<state> <time>” 对，表示此冷却设备在 <state> 状态下花费了 <time> 毫秒的时间。

输出将为每个支持的状态包含一行。

只读，必需

/sys/class/thermal/cooling_deviceX/stats/total_trans

定义于文件 sysfs-class-thermal

一个正值，显示冷却设备状态更改的总次数。

只读，必需

/sys/class/thermal/cooling_deviceX/stats/trans_table

定义于文件 sysfs-class-thermal

这提供了有关所有冷却状态转换的精细信息。此处的 cat 输出是一个二维矩阵，其中条目 <i,j>（第 i 行，第 j 列）表示从 State_i 到 State_j 的转换次数。如果转换表大于 PAGE_SIZE，则读取此文件将返回 -EFBIG 错误。

只读，必需

/sys/class/thermal/cooling_deviceX/type

定义于文件 sysfs-class-thermal

表示设备类型的字符串，例如

  • 对于通用 ACPI：应为“Fan”、“Processor”或“LCD”

  • 对于 intel_menlow 平台上的内存控制器设备：应为“Memory controller”。

只读，必需

/sys/class/thermal/thermal_zoneX/available_policies

定义于文件 sysfs-class-thermal

可用于特定区域的可用散热调控器。

只读，必需

/sys/class/thermal/thermal_zoneX/cdevY

定义于文件 sysfs-class-thermal

指向散热冷却设备节点的 Sysfs 链接，其中表示用于散热设备节流控制的 sys I/F。

只读，可选

/sys/class/thermal/thermal_zoneX/cdevY_trip_point

定义于文件 sysfs-class-thermal

此散热区域中与 cdev[0-*] 关联的跳变点；-1 表示冷却设备未与任何跳变点关联。

只读，可选

/sys/class/thermal/thermal_zoneX/cdevY_weight

定义于文件 sysfs-class-thermal

cdev[0-*] 在此散热区域中的影响。此值相对于散热区域中的其余冷却设备。例如，如果冷却设备的权重是其他设备的两倍，则其在冷却散热区域中的效果是其他设备的两倍。

读写，可选

/sys/class/thermal/thermal_zoneX/emul_temp

定义于文件 sysfs-class-thermal

用于设置散热区域（传感器）中模拟温度方法的接口。设置此温度后，如果已注册，则散热区域可能会将此温度传递给平台模拟函数或在本地缓存该温度。这在调试不同的温度阈值及其相关的冷却操作时很有用。这是一个只写节点，在此节点上写入 0 应禁用模拟。

单位：毫摄氏度

只写，可选

警告

在生产系统上启用此选项时要小心，因为用户空间可以通过简单地向此 sysfs 节点填充低温值来轻松禁用散热策略。

/sys/class/thermal/thermal_zoneX/integral_cutoff

定义于文件 sysfs-class-thermal

高于期望温度跳变点的温度偏移量，超过该偏移量时，功率分配器调控器的 PID 控制器的积分项开始累积误差。例如，如果 integral_cutoff 为 0，则积分项仅在温度高于期望温度跳变点时才累积误差。有关详细信息，请参阅功率分配器调优

单位：毫摄氏度

读写，可选

/sys/class/thermal/thermal_zoneX/k_d

定义于文件 sysfs-class-thermal

功率分配器调控器的 PID 控制器的微分项。有关详细信息，请参阅功率分配器调优

读写，可选

/sys/class/thermal/thermal_zoneX/k_i

定义于文件 sysfs-class-thermal

功率分配器调控器的 PID 控制器的积分项。此项允许 PID 控制器补偿长期漂移。有关详细信息，请参阅功率分配器调优

读写，可选

/sys/class/thermal/thermal_zoneX/k_po

定义于文件 sysfs-class-thermal

温度过冲期间功率分配器调控器的 PID 控制器的比例项。温度过冲是指当前温度高于“期望温度”跳变点。有关详细信息，请参阅功率分配器调优

读写，可选

/sys/class/thermal/thermal_zoneX/k_pu

定义于文件 sysfs-class-thermal

温度欠冲期间功率分配器调控器的 PID 控制器的比例项。温度欠冲是指当前温度低于“期望温度”跳变点。有关详细信息，请参阅功率分配器调优

读写，可选

/sys/class/thermal/thermal_zoneX/mode

定义于文件 sysfs-class-thermal

[enabled, disabled] 中的预定义值之一。此文件提供有关当前管理散热区域的算法的信息。它可以是默认的基于内核的算法或用户空间应用程序。

enabled

启用内核散热管理。

disabled

阻止内核散热区域驱动程序在跳变点上执行操作，以便用户应用程序可以完全负责散热管理。

读写，可选

/sys/class/thermal/thermal_zoneX/offset

定义于文件 sysfs-class-thermal

线性外推模型中使用的偏移常量，用于根据传感器的原始读数确定热点温度。由设备驱动程序确定这些值的用法。

读写，可选

/sys/class/thermal/thermal_zoneX/policy

定义于文件 sysfs-class-thermal

用于特定区域的各种散热调控器之一。

读写，必需

/sys/class/thermal/thermal_zoneX/slope

定义于文件 sysfs-class-thermal

线性外推模型中使用的斜率常量，用于根据传感器的原始读数确定热点温度。由设备驱动程序确定这些值的用法。

读写，可选

/sys/class/thermal/thermal_zoneX/sustainable_power

定义于文件 sysfs-class-thermal

散热区域可以耗散的持续功率的估计值。由功率分配器调控器使用。有关详细信息，请参阅功率分配器调优

单位：毫瓦

读写，可选

/sys/class/thermal/thermal_zoneX/temp

定义于文件 sysfs-class-thermal

散热区域（传感器）报告的当前温度。

单位：毫摄氏度

只读，必需

/sys/class/thermal/thermal_zoneX/trip_point_Y_hyst

定义于文件 sysfs-class-thermal

跳变点的滞后值，表示为整数。

单位：摄氏度

读写，可选

/sys/class/thermal/thermal_zoneX/trip_point_Y_temp

定义于文件 sysfs-class-thermal

高于该温度时，将触发跳变点。

单位：毫摄氏度

只读，可选

/sys/class/thermal/thermal_zoneX/trip_point_Y_type

定义于文件 sysfs-class-thermal

指示跳变点类型的字符串。

例如，它可以是 ACPI 散热区域的 critical、hot、passive、active[0-*] 之一。

只读，可选

/sys/class/thermal/thermal_zoneX/type

定义于文件 sysfs-class-thermal

表示热区类型的字符串。这是由热区驱动程序在注册时提供的。例如：“acpitz”表示它是一个 ACPI 热设备。为了与 hwmon sys 属性保持一致，这应该是一个简短的、小写的字符串，不包含空格或破折号。

只读，必需

/sys/class/timecard/

定义在文件 sysfs-timecard 中

此目录包含文件和目录，提供 OpenCompute 时间卡辅助功能的标准化接口。

/sys/class/timecard/ocpN/

定义在文件 sysfs-timecard 中

此目录包含第 N 个注册时间卡的属性。

/sys/class/timecard/ocpN/available_clock_sources

定义在文件 sysfs-timecard 中

(只读) PHC 用于时钟调整的可用时间源列表。

NONE

无调整

PPS

调整来自 PPS1 选择器 (默认)

TOD

来自 GNSS/TOD 模块的调整

IRIG

来自外部 IRIG-B 信号的调整

DCF

来自外部 DCF 信号的调整

/sys/class/timecard/ocpN/available_sma_inputs

定义在文件 sysfs-timecard 中

(只读) SMA 输入信号的可用目标（接收器）集。

10Mhz

信号用作 10Mhz 参考时钟

PPS1

信号发送到 PPS1 选择器

PPS2

信号发送到 PPS2 选择器

TS1

信号发送到时间戳器 1

TS2

信号发送到时间戳器 2

TS3

信号发送到时间戳器 3

TS4

信号发送到时间戳器 4

IRIG

信号发送到 IRIG-B 模块

DCF

信号发送到 DCF 模块

FREQ1

信号发送到频率计数器 1

FREQ2

信号发送到频率计数器 2

FREQ3

信号发送到频率计数器 3

FREQ4

信号发送到频率计数器 4

无

信号输入被禁用

/sys/class/timecard/ocpN/available_sma_outputs

定义在文件 sysfs-timecard 中

(只读) SMA 输出信号的可用源集。

10Mhz

输出来自 10Mhz 参考时钟

PHC

输出 PPS 来自 PHC 时钟

MAC

输出 PPS 来自小型原子钟

GNSS1

输出 PPS 来自第一个 GNSS 模块

GNSS2

输出 PPS 来自第二个 GNSS 模块

IRIG

输出来自 PHC，为 IRIG-B 格式

DCF

输出来自 PHC，为 DCF 格式

GEN1

输出来自频率发生器 1

GEN2

输出来自频率发生器 2

GEN3

输出来自频率发生器 3

GEN4

输出来自频率发生器 4

GND

输出为 GND

VCC

输出为 VCC

/sys/class/timecard/ocpN/clock_source

定义在文件 sysfs-timecard 中

(读写) 包含 PHC 当前使用的同步源。可以通过写入 available_clock_sources 属性集中列出的值之一来更改。

/sys/class/timecard/ocpN/clock_status_drift

定义在文件 sysfs-timecard 中

(只读) 包含固件用于原子钟内部调整的当前漂移值。

/sys/class/timecard/ocpN/clock_status_offset

定义在文件 sysfs-timecard 中

(只读) 包含固件用于原子钟内部调整的当前偏移值。

/sys/class/timecard/ocpN/freqX

定义在文件 sysfs-timecard 中

(只读) 可选目录，包含频率计数器 <X> 的 sysfs 节点。

/sys/class/timecard/ocpN/freqX/frequency

定义在文件 sysfs-timecard 中

(只读) 包含在指定的测量周期内测量的频率。

/sys/class/timecard/ocpN/freqX/seconds

定义在文件 sysfs-timecard 中

(读写) 指定频率应测量的秒数，范围为 0-255。写入 0 以禁用。

/sys/class/timecard/ocpN/genX

定义在文件 sysfs-timecard 中

(只读) 可选目录，包含频率发生器 <X> 的 sysfs 节点。

/sys/class/timecard/ocpN/genX/duty

定义在文件 sysfs-timecard 中

(只读) 指定信号占空比，为 1-99 的百分比。

/sys/class/timecard/ocpN/genX/period

定义在文件 sysfs-timecard 中

(只读) 指定信号周期，单位为纳秒。

/sys/class/timecard/ocpN/genX/phase

定义在文件 sysfs-timecard 中

(只读) 指定信号相位偏移，单位为纳秒。

/sys/class/timecard/ocpN/genX/polarity

定义在文件 sysfs-timecard 中

(只读) 指定信号极性，为 1 或 0。

/sys/class/timecard/ocpN/genX/running

定义在文件 sysfs-timecard 中

(只读) 显示信号发生器是否正在运行，为 0 或 1。

/sys/class/timecard/ocpN/genX/signal

定义在文件 sysfs-timecard 中

(读写) 用于启动信号发生器，并汇总当前状态。

可以通过写入信号周期，然后是可选的信号值来启动信号发生器。如果未提供可选值，则默认使用当前设置，可以从其他 sysfs 节点获取。

周期 [占空比 [相位 [极性]]]

echo 500000000 > signal # 1/2 秒周期 echo 1000000 40 100 > signal echo 0 > signal # 关闭发生器

周期和相位以纳秒为单位指定。占空比是 1-99 的百分比。极性为 1 或 0。

读取此节点将返回

周期 占空比 相位 极性 开始时间

/sys/class/timecard/ocpN/genX/start

定义在文件 sysfs-timecard 中

(只读) 显示信号发生器开始运行的时间，格式为 <秒>.<纳秒>。

/sys/class/timecard/ocpN/gnss_sync

定义在文件 sysfs-timecard 中

(只读) 指示是否收到有效的 GNSS 信号，或者信号何时丢失。

/sys/class/timecard/ocpN/i2c

定义在文件 sysfs-timecard 中

此可选属性链接到关联的 i2c 设备。

/sys/class/timecard/ocpN/irig_b_mode

定义在文件 sysfs-timecard 中

(读写) 一个从 0 到 7 的整数，指示 IRIG-B 输出信号的时间码格式：B00<n>

/sys/class/timecard/ocpN/pps

定义在文件 sysfs-timecard 中

此可选属性链接到关联的 PPS 设备。

/sys/class/timecard/ocpN/ptp

定义在文件 sysfs-timecard 中

此属性链接到关联的 PTP 设备。

/sys/class/timecard/ocpN/serialnum

定义在文件 sysfs-timecard 中

(只读) 提供时间卡的序列号。

/sys/class/timecard/ocpN/sma1

/sys/class/timecard/ocpN/sma2

/sys/class/timecard/ocpN/sma3

/sys/class/timecard/ocpN/sma4

定义在文件 sysfs-timecard 中

(读写) 这些属性指定关联 SMA 连接器上信号的方向，以及信号接收器或源。

该属性的显示格式是以空格分隔的信号列表，前缀为输入/输出方向。

可以通过在信号列表前面加上“in:”或“out:”来更改信号方向（如果支持）。如果不存在任何前缀，则方向保持不变。

可以通过写入 available_sma_outputs 属性集中列出的值之一来更改输出信号。

可以通过写入 available_sma_inputs 属性集中以空格分隔的多个值来更改输入目标。如果连接器之间存在重复的输入目标，则编号最小的 SMA 连接器具有优先级。

请注意，并非所有输入组合都是有意义的。

10Mhz 参考时钟输入当前仅在 SMA1 上有效，并且不能与其他目标接收器组合使用。

/sys/class/timecard/ocpN/tod_correction

定义在文件 sysfs-timecard 中

(读写) 传入的 GNSS 信号为 UTC 时间，并且 NMEA 格式消息不提供 TAI 偏移。这会设置传入时间的校正值。

如果启用 UBX_LS，则应为 0，并且偏移量取自 UBX-NAV-TIMELS 消息。

/sys/class/timecard/ocpN/ts_window_adjust

定义在文件 sysfs-timecard 中

(读写) 当使用 PTP SYS_OFFSET_EXTENDED ioctl 检索 PHC 时，会在检索 PHC 时间之前和之后生成一个系统时间戳。两个系统时间戳之间的中点通常被认为是与 PHC 时间关联的 SYS 时间。此估计可能不正确，因为它取决于 PCI 延迟以及何时锁定 PHC 时间

该属性值将结束时间戳减少给定的纳秒数，因此计算的中点与检索到的 PHC 时间匹配。

初始值是基于测量的 PCI 延迟和 FPGA 锁定 PHC 时间的估计点设置的。可以通过写入无符号整数来更改此值。

/sys/class/timecard/ocpN/tty

定义在文件 sysfs-timecard 中

(只读) 包含 TTY 属性的 sysfs 节点的目录

/sys/class/timecard/ocpN/tty/ttyGNSS

/sys/class/timecard/ocpN/tty/ttyGNSS2

定义在文件 sysfs-timecard 中

(只读) 这些可选属性包含与 GNSS 设备关联的 TTY 串行端口的名称。

/sys/class/timecard/ocpN/tty/ttyMAC

定义在文件 sysfs-timecard 中

(只读) 此可选属性包含与小型原子钟关联的 TTY 串行端口的名称。

/sys/class/timecard/ocpN/tty/ttyNMEA

定义在文件 sysfs-timecard 中

(只读) 此可选属性包含以 NMEA ZDA 格式输出 PHC 时间的 TTY 串行端口的名称。

/sys/class/timecard/ocpN/utc_tai_offset

定义在文件 sysfs-timecard 中

(读写) DCF 和 IRIG 输出信号为 UTC，而 TimeCard 在 TAI 上运行。此属性允许设置以秒为单位的偏移量，该偏移量会添加到这些格式的 TAI 时基中。

可以通过写入无符号整数来更改偏移量。

/sys/class/tpm/tpmX/ppi/

定义在文件 sysfs-driver-ppi 中

此文件夹包含与 PPI（物理存在接口）相关的属性。仅当 BIOS 支持 TPM 时，此文件夹才有意义。文件夹路径可以通过命令 ‘find /sys/ -name ‘pcrs’’ 获取。有关 PPI 的详细信息，请参阅以下 PPI 规范：

http://www.trustedcomputinggroup.org/

在 Linux 4.2 中，ppi 被移动到字符设备目录。从 tpmX/device/ppi 到 tpmX/ppi 的符号链接提供向后兼容性。

/sys/class/tpm/tpmX/ppi/request

定义在文件 sysfs-driver-ppi 中

此属性显示在预操作系统环境中执行的操作请求。它是从操作系统到预操作系统环境的唯一输入。请求应该是一个 1 到 160 的整数值范围，0 表示没有请求。此文件可以读取和写入。

/sys/class/tpm/tpmX/ppi/response

定义在文件 sysfs-driver-ppi 中

此属性显示对最近执行的操作请求的响应。格式为 “<请求> <响应编号> : <响应描述>”。此文件为只读。

/sys/class/tpm/tpmX/ppi/tcg_operations

定义在文件 sysfs-driver-ppi 中

此属性显示是否允许由 BIOS 为 TCG 定义的请求（即从 1 到 22 的请求）请求在预操作系统环境中执行的操作。格式为 “<请求> <状态编号>: <状态描述>”。此属性仅受 PPI 1.2+ 版本支持。此文件为只读。

/sys/class/tpm/tpmX/ppi/transition_action

定义在文件 sysfs-driver-ppi 中

此属性显示应该采取的特定于平台的动作，以便转换为 BIOS 以执行请求的操作。格式为 “<动作编号>: <动作描述>”。此文件为只读。

/sys/class/tpm/tpmX/ppi/version

定义在文件 sysfs-driver-ppi 中

此属性显示平台支持的 PPI 版本。此文件为只读。

/sys/class/tpm/tpmX/ppi/vs_operations

定义在文件 sysfs-driver-ppi 中

此属性显示是否允许由 BIOS 为特定于供应商的请求（即从 128 到 255 的请求）请求在预操作系统环境中执行的操作。格式与 tcg_operations 相同。此属性也仅受 PPI 1.2+ 版本支持。此文件为只读。

/sys/class/tty/console/active

定义在文件 sysfs-tty 中

显示当前配置的控制台设备列表，如 ‘tty1 ttyS0’。文件中的最后一个条目是连接到 /dev/console 的活动设备。该文件支持 poll() 来检测虚拟控制台切换。

/sys/class/tty/tty<x>/active

定义在文件 sysfs-tty 中

显示当前活动的虚拟控制台设备，如 ‘tty1’。该文件支持 poll() 来检测虚拟控制台切换。

/sys/class/tty/ttyS<x>/close_delay

定义在文件 sysfs-tty 中

显示此端口的关闭延迟时间，单位为厘秒。

这些 sysfs 值通过 sysfs 而不是通过 ioctl 公开 TIOCGSERIAL 接口。

/sys/class/tty/ttyS<x>/closing_wait

定义在文件 sysfs-tty 中

显示此端口的关闭等待时间，单位为厘秒。

永远等待表示为 0。如果禁用关闭等待，则该值为 65535。

这些 sysfs 值通过 sysfs 而不是通过 ioctl 公开 TIOCGSERIAL 接口。

/sys/class/tty/ttyS<x>/console

定义在文件 sysfs-tty 中

允许用户分离或重新连接给定设备作为内核控制台。它显示并接受一个布尔变量。

/sys/class/tty/ttyS<x>/custom_divisor

定义在文件 sysfs-tty 中

显示此端口上设置的自定义除数（如果有）。

这些 sysfs 值通过 sysfs 而不是通过 ioctl 公开 TIOCGSERIAL 接口。

/sys/class/tty/ttyS<x>/flags

定义在文件 sysfs-tty 中

显示此端口的 tty 端口状态标志。

这些 sysfs 值通过 sysfs 而不是通过 ioctl 公开 TIOCGSERIAL 接口。

/sys/class/tty/ttyS<x>/io_type

定义在文件 sysfs-tty 中

显示将与 iomem 基地址一起使用的 I/O 类型。

这些 sysfs 值通过 sysfs 而不是通过 ioctl 公开 TIOCGSERIAL 接口。

/sys/class/tty/ttyS<x>/iomem_base

定义在文件 sysfs-tty 中

此端口的 I/O 内存基址。

这些 sysfs 值通过 sysfs 而不是通过 ioctl 公开 TIOCGSERIAL 接口。

/sys/class/tty/ttyS<x>/iomem_reg_shift

定义在文件 sysfs-tty 中

显示用于访问此 iomem 地址的寄存器偏移量（表示间隔）。

这些 sysfs 值通过 sysfs 而不是通过 ioctl 公开 TIOCGSERIAL 接口。

/sys/class/tty/ttyS<x>/irq

定义在文件 sysfs-tty 中

显示此端口的当前主要中断。

这些 sysfs 值通过 sysfs 而不是通过 ioctl 公开 TIOCGSERIAL 接口。

/sys/class/tty/ttyS<x>/line

定义在文件 sysfs-tty 中

显示此端口的当前 tty 行号。

这些 sysfs 值通过 sysfs 而不是通过 ioctl 公开 TIOCGSERIAL 接口。

/sys/class/tty/ttyS<x>/port

定义在文件 sysfs-tty 中

显示此端口的当前 tty 端口 I/O 地址。

这些 sysfs 值通过 sysfs 而不是通过 ioctl 公开 TIOCGSERIAL 接口。

/sys/class/tty/ttyS<x>/rx_trig_bytes

定义在文件 sysfs-tty 中

显示当前 RX 中断触发字节数，或者设置用户指定的值以更改 FIFO 缓冲区的值。用户可以显示或设置此值，而无需打开串行设备文件。

对于 UART 串行，RX 触发器可以设置为四种类型的值之一。当用户输入对此 I/F 无意义的值时，RX 触发器将更改为设备规范的最近较低的值。例如，当用户在具有 1/4/8/14 字节触发器的 16550A 上设置 7 个字节时，RX 触发器会自动更改为 4 个字节。

/sys/class/tty/ttyS<x>/type

定义在文件 sysfs-tty 中

显示此端口的当前 tty 类型。

这些 sysfs 值通过 sysfs 而不是通过 ioctl 公开 TIOCGSERIAL 接口。

/sys/class/tty/ttyS<x>/uartclk

定义在文件 sysfs-tty 中

显示与串行核心中 UART 端口关联的当前 uartclk 值，该端口绑定到 TTY，如 ttyS0。uartclk = 16 * baud_base

这些 sysfs 值通过 sysfs 而不是通过 ioctl 公开 TIOCGSERIAL 接口。

/sys/class/tty/ttyS<x>/xmit_fifo_size

定义在文件 sysfs-tty 中

显示此端口的传输 FIFO 大小。

这些 sysfs 值通过 sysfs 而不是通过 ioctl 公开 TIOCGSERIAL 接口。

/sys/class/typec/<port>-<plug>/number_of_alternate_modes

在文件 sysfs-class-typec 中定义

显示在电源传输发现期间，与特定电缆关联的插头所声明的替代模式的数量。在 Type C 端口驱动程序设置大于或等于 0 的值之前，此文件将保持隐藏状态。

USB Type-C 伙伴/电缆电源传输身份对象

注意：以下属性将适用于伙伴（例如 /sys/class/typec/port0-partner/）和电缆（例如 /sys/class/typec/port0-cable/）设备。因此，下面的示例文件路径以“/sys/class/typec/<port>-{partner|cable}/”为前缀，以反映这一点。

/sys/class/typec/<port>-cable/plug_type

在文件 sysfs-class-typec 中定义

显示电缆上插头的类型

  • type-a - 标准 A

  • type-b - 标准 B

  • type-c

  • captive

/sys/class/typec/<port>-cable/type

在文件 sysfs-class-typec 中定义

USB 电源传输规范为电缆定义了一组产品类型。如果已知，此文件将显示电缆的产品类型。如果设备驱动程序看不到电缆的产品类型，则此文件将不存在。

当检测到电缆产品类型时，也会引发带有 PRODUCT_TYPE 的 uvevent，显示电缆的产品类型。

有效值

undefined

active

Active Cable

passive

Passive Cable

/sys/class/typec/<port>-partner/accessory_mode

在文件 sysfs-class-typec 中定义

当伙伴是附件时，显示附件模式名称。附件模式在 USB Type-C 规范中定义。

/sys/class/typec/<port>-partner/identity/

在文件 sysfs-class-typec 中定义

只有当端口设备驱动程序能够显示发现身份 USB 电源传输命令的结果时，此目录才会出现。即使支持 USB 电源传输，也并非总是可行，例如，当端口的 USB 电源传输通信主要在固件中处理时。如果该目录存在，它将为发现身份命令结果中的每个 VDO 都有一个属性文件。

/sys/class/typec/<port>-partner/number_of_alternate_modes

在文件 sysfs-class-typec 中定义

显示在电源传输发现期间，伙伴所声明的替代模式的数量。在 Type C 端口驱动程序设置大于或等于 0 的值之前，此文件将保持隐藏状态。

/sys/class/typec/<port>-partner/supports_usb_power_delivery

在文件 sysfs-class-typec 中定义

显示伙伴是否支持 USB 电源传输通信：有效值：yes，no

/sys/class/typec/<port>-partner/type

在文件 sysfs-class-typec 中定义

USB 电源传输规范为伙伴设备定义了一组产品类型。如果已知，此文件将显示伙伴的产品类型。具有双重角色能力的伙伴将定义 UFP 和 DFP 产品类型，但只有与当前角色匹配的类型会在当时处于活动状态。如果设备驱动程序看不到伙伴的产品类型，则此文件将不存在。

当检测到伙伴产品类型，或者通过角色交换更改时，也会引发包含 PRODUCT_TYPE=<产品类型>（例如 PRODUCT_TYPE=hub）的 uvevent。

有效值

UFP / 设备角色 ====================== ========================== undefined - hub PDUSB 集线器外围设备 PDUSB 外围设备 psd 移动电源 ama 替代模式适配器 ====================== ==========================

DFP / 主机角色 ====================== ========================== undefined - hub PDUSB 集线器主机 PDUSB 主机 power_brick 电源适配器 amc 替代模式控制器 ====================== ==========================

/sys/class/typec/<port>-partner/usb_mode

在文件 sysfs-class-typec 中定义

伙伴设备支持的 USB 模式。活动模式显示在括号中。当端口驱动程序能够向伙伴发送数据重置消息时，可以通过写入此文件来更改活动的 USB 模式。这需要伙伴和端口之间的 USB 电源传输协议。

有效值：- usb2 (USB 2.0) - usb3 (USB 3.2) - usb4 (USB4)

USB Type-C 电缆设备（例如，/sys/class/typec/port0-cable/）

注意：电子标记的电缆也会为每个电缆插头提供一个设备（例如，/sys/class/typec/port0-plug0）。如果电缆处于活动状态并且还具有 SOP 双素数控制器（USB 电源传输规范第 2.4 章），则它还将为另一个插头提供第二个设备。两个插头都可能具有 USB Type-C 和 USB 电源传输规范中描述的替代模式。

/sys/class/typec/<port>-{partner|cable}/identity/

在文件 sysfs-class-typec 中定义

只有当端口设备驱动程序能够显示发现身份 USB 电源传输命令的结果时，此目录才会出现。即使支持 USB 电源传输，也并非总是可行，例如，当端口的 USB 电源传输通信主要在固件中处理时。如果该目录存在，它将为发现身份命令结果中的每个 VDO 都有一个属性文件。

/sys/class/typec/<port>-{partner|cable}/identity/cert_stat

在文件 sysfs-class-typec 中定义

发现身份命令结果的 Cert Stat VDO 部分。直到发现身份命令结果可用，该值将显示 0。该值可以轮询。

/sys/class/typec/<port>-{partner|cable}/identity/id_header

在文件 sysfs-class-typec 中定义

发现身份命令结果的 ID 标头 VDO 部分。直到发现身份命令结果可用，该值将显示 0。该值可以轮询。

/sys/class/typec/<port>-{partner|cable}/identity/product

在文件 sysfs-class-typec 中定义

发现身份命令结果的产品 VDO 部分。直到发现身份命令结果可用，该值将显示 0。该值可以轮询。

/sys/class/typec/<port>-{partner|cable}/identity/product_type_vdo1

在文件 sysfs-class-typec 中定义

发现身份命令结果的第一个产品类型 VDO。直到发现身份命令结果可用并返回有效的产品类型 VDO，该值将显示 0。

/sys/class/typec/<port>-{partner|cable}/identity/product_type_vdo2

在文件 sysfs-class-typec 中定义

发现身份命令结果的第二个产品类型 VDO。直到发现身份命令结果可用并返回有效的产品类型 VDO，该值将显示 0。

/sys/class/typec/<port>-{partner|cable}/identity/product_type_vdo3

在文件 sysfs-class-typec 中定义

发现身份命令结果的第三个产品类型 VDO。直到发现身份命令结果可用并返回有效的产品类型 VDO，该值将显示 0。

USB Type-C 端口替代模式设备。

/sys/class/typec/<port>-{partner|cable}/usb_power_delivery_revision

在文件 sysfs-class-typec 中定义

端口伙伴或电缆支持的 USB 电源传输规范的版本号，或者当不支持 USB 电源传输时为 0.0。

示例值：- “2.0”：USB 电源传输版本 2.0 - “3.0”：USB 电源传输版本 3.0 - “3.1”：USB 电源传输版本 3.1

/sys/class/typec/<port>/<alt mode>/supported_roles

在文件 sysfs-class-typec 中定义

支持角色的空格分隔列表。

有效值：source，sink

/sys/class/typec/<port>/data_role

在文件 sysfs-class-typec 中定义

支持的 USB 数据角色。此属性可用于请求端口上的数据角色交换。交换作为同步操作支持，因此 write(2) 对属性的调用将不会返回，直到操作完成。该属性会收到角色更改的通知，以便属性上的 poll(2) 唤醒。角色更改也会在端口上生成 uevent KOBJ_CHANGE。当前角色显示在括号中，例如当 DRP 端口处于主机模式时，“[host] device”。

有效值：host，device

/sys/class/typec/<port>/orientation

在文件 sysfs-class-typec 中定义

指示 Type-C 连接器的活动方向。有效值：- “normal”：CC1 方向 - “reverse”：CC2 方向 - “unknown”：无法确定方向。

/sys/class/typec/<port>/port_type

在文件 sysfs-class-typec 中定义

指示端口的类型。此属性可用于请求端口类型的更改。端口类型更改作为同步操作支持，因此 write(2) 对属性的调用将不会返回，直到操作完成。

有效值

source

（该端口将仅作为源 DFP 端口运行）

sink

（该端口将仅作为接收 UFP 端口运行）

dual

（该端口将作为双重角色数据和双重角色电源端口运行）

/sys/class/typec/<port>/power_operation_mode

在文件 sysfs-class-typec 中定义

显示端口当前所处的电源操作模式。电源操作模式是指 VBUS 的当前电平。如果使用 USB 电源传输通信协商电平，则电源操作模式应显示“usb_power_delivery”。

有效值

  • 默认

  • 1.5A

  • 3.0A

  • usb_power_delivery

/sys/class/typec/<port>/power_role

在文件 sysfs-class-typec 中定义

支持的电源角色。此属性可用于请求端口上的电源角色交换。交换作为同步操作支持，因此 write(2) 对属性的调用将不会返回，直到操作完成。该属性会收到角色更改的通知，以便属性上的 poll(2) 唤醒。角色更改也会生成 uevent KOBJ_CHANGE。当前角色显示在括号中，例如当处于源模式时，“[source] sink”。

有效值：source，sink

/sys/class/typec/<port>/preferred_role

在文件 sysfs-class-typec 中定义

用户空间可以通知驱动程序首选角色。它应该被视为在端口驱动程序中启用 USB Type-C 规范中定义的 Try.SRC 或 Try.SNK。默认情况下，首选角色应来自平台。

有效值：source，sink，none（删除首选项）

/sys/class/typec/<port>/select_usb_power_delivery

在文件 sysfs-class-typec 中定义

列出端口可以向伙伴声明的 USB 电源传输能力。当前使用的能力在括号中。通过写入文件进行选择。

/sys/class/typec/<port>/supported_accessory_modes

在文件 sysfs-class-typec 中定义

端口支持的、在 USB Type-C 规范中定义的附件模式的空格分隔列表。

/sys/class/typec/<port>/usb_capability

在文件 sysfs-class-typec 中定义

列出支持的 USB 模式。下次使用 Enter_USB 消息时的默认 USB 模式在括号中。当驱动程序支持时，可以通过写入文件来更改默认模式。

有效值：- usb2 (USB 2.0) - usb3 (USB 3.2) - usb4 (USB4)

USB Type-C 伙伴设备（例如 /sys/class/typec/port0-partner/）

/sys/class/typec/<port>/usb_power_delivery_revision

在文件 sysfs-class-typec 中定义

支持的 USB 功率传输规范的修订号，如果不支持 USB 功率传输，则为 0.0。

示例值：- “2.0”：USB 电源传输版本 2.0 - “3.0”：USB 电源传输版本 3.0 - “3.1”：USB 电源传输版本 3.1

/sys/class/typec/<port>/usb_typec_revision

在文件 sysfs-class-typec 中定义

支持的 USB Type-C 规范的修订号。

/sys/class/typec/<port>/vconn_source

在文件 sysfs-class-typec 中定义

显示端口是否为 VCONN 源。当端口和伙伴设备都支持 USB 功率传输时，此属性可用于请求 VCONN 交换以更改连接期间的 VCONN 源。交换作为同步操作支持，因此 write(2) 到该属性将不会返回，直到操作完成。该属性会收到有关 VCONN 源更改的通知，以便 poll(2) 在该属性上被唤醒。VCONN 源的更改也会生成 uevent KOBJ_CHANGE。

有效值

  • 当端口不是 VCONN 源时显示 “no”

  • 当端口是 VCONN 源时显示 “yes”

/sys/class/uacce/<dev_name>/algorithms

在文件 sysfs-driver-uacce 中定义

此加速器支持的算法，用换行符分隔。可以是任何字符串，由用户空间解析。

/sys/class/uacce/<dev_name>/api

在文件 sysfs-driver-uacce 中定义

设备的 API。可以是任何字符串，由用户空间解析。应用程序使用 API 来匹配正确的驱动程序。

/sys/class/uacce/<dev_name>/available_instances

在文件 sysfs-driver-uacce 中定义

设备剩余的可用实例。如果未提供 uacce_ops get_available_instances，则返回 -ENODEV

/sys/class/uacce/<dev_name>/flags

在文件 sysfs-driver-uacce 中定义

设备的属性，请参阅 uacce.h 中定义的 UACCE_DEV_xxx 标志

/sys/class/uacce/<dev_name>/isolate

在文件 sysfs-driver-uacce 中定义

(R) 一个 sysfs 节点，用于读取设备的隔离状态。值 1 表示设备不可用。值 0 表示设备可用。

/sys/class/uacce/<dev_name>/isolate_strategy

在文件 sysfs-driver-uacce 中定义

(RW) 一个 sysfs 节点，用于配置硬件隔离策略的错误阈值。此大小是一个配置的整数值，表示一小时内发生的硬件错误的阈值数量。默认值为 0。0 表示从不隔离设备。最大值为 65535。您可以根据您的硬件写入阈值数量。

/sys/class/uacce/<dev_name>/region_dus_size

在文件 sysfs-driver-uacce 中定义

dus 区域队列文件的大小（字节）

/sys/class/uacce/<dev_name>/region_mmio_size

在文件 sysfs-driver-uacce 中定义

mmio 区域队列文件的大小（字节）

/sys/class/udc/udc.name/device/gadget/video4linux/video.name/function_name

定义在文件 configfs-usb-gadget-uvc

UVC configfs 功能实例名称

/sys/class/usb_power_delivery

在文件 sysfs-class-usb_power_delivery 中定义

USB 功率传输设备的目录。

/sys/class/usb_power_delivery/.../<capability>/1:fixed_supply/dual_role_data

在文件 sysfs-class-usb_power_delivery 中定义

此文件显示 vSafe5V 固定电源对象中双重角色数据位的值。双重角色数据表示可以同时充当 USB 主机和 USB 设备的能力。

/sys/class/usb_power_delivery/.../<capability>/1:fixed_supply/dual_role_power

在文件 sysfs-class-usb_power_delivery 中定义

此文件包含一个布尔值，指示该设备是否支持源和接收电源角色。

/sys/class/usb_power_delivery/.../<capability>/1:fixed_supply/unchunked_extended_messages_supported

在文件 sysfs-class-usb_power_delivery 中定义

此文件显示 vSafe5V 固定电源对象中支持非分块扩展消息位的值。

/sys/class/usb_power_delivery/.../<capability>/1:fixed_supply/unconstrained_power

在文件 sysfs-class-usb_power_delivery 中定义

此文件显示 vSafe5V 固定电源对象中无约束电源位的值。当外部电源（足够强大到可以自行供电整个系统）可用于设备时，将设置该位。

/sys/class/usb_power_delivery/.../<capability>/1:fixed_supply/usb_communication_capable

在文件 sysfs-class-usb_power_delivery 中定义

此文件显示 vSafe5V 固定电源对象中 USB 通信能力位的值。

/sys/class/usb_power_delivery/.../<capability>/<position>:battery

在文件 sysfs-class-usb_power_delivery 中定义

电池 PDO。

/sys/class/usb_power_delivery/.../<capability>/<position>:battery/maximum_voltage

在文件 sysfs-class-usb_power_delivery 中定义

最大电压，单位为毫伏。

/sys/class/usb_power_delivery/.../<capability>/<position>:battery/minimum_voltage

在文件 sysfs-class-usb_power_delivery 中定义

最小电压，单位为毫伏。

/sys/class/usb_power_delivery/.../<capability>/<position>:fixed_supply

在文件 sysfs-class-usb_power_delivery 中定义

包含为固定电源定义的属性（位字段）的设备。

设备“1:fixed_supply”是特殊的。USB 功率传输规范规定，第一个 PDO（在对象位置 1），也是唯一强制性的 PDO，始终是 vSafe5V 固定电源对象。vSafe5V 对象为其定义了其他固定电源对象没有的其他字段，这些字段与 USB 功能而不是电源功能相关。

/sys/class/usb_power_delivery/.../<capability>/<position>:fixed_supply/voltage

在文件 sysfs-class-usb_power_delivery 中定义

电源支持的电压，单位为毫伏。

/sys/class/usb_power_delivery/.../<capability>/<position>:programmable_supply

在文件 sysfs-class-usb_power_delivery 中定义

可编程电源 (PPS) 增强型 PDO (APDO)。

/sys/class/usb_power_delivery/.../<capability>/<position>:programmable_supply/maximum_current

在文件 sysfs-class-usb_power_delivery 中定义

最大电流，单位为毫安。

/sys/class/usb_power_delivery/.../<capability>/<position>:programmable_supply/maximum_voltage

在文件 sysfs-class-usb_power_delivery 中定义

最大电压，单位为毫伏。

/sys/class/usb_power_delivery/.../<capability>/<position>:programmable_supply/minimum_voltage

在文件 sysfs-class-usb_power_delivery 中定义

最小电压，单位为毫伏。

/sys/class/usb_power_delivery/.../<capability>/<position>:variable_supply

在文件 sysfs-class-usb_power_delivery 中定义

可变电源 PDO。

/sys/class/usb_power_delivery/.../<capability>/<position>:variable_supply/maximum_voltage

在文件 sysfs-class-usb_power_delivery 中定义

最大电压，单位为毫伏。

/sys/class/usb_power_delivery/.../<capability>/<position>:variable_supply/minimum_voltage

在文件 sysfs-class-usb_power_delivery 中定义

最小电压，单位为毫伏。

/sys/class/usb_power_delivery/.../revision

在文件 sysfs-class-usb_power_delivery 中定义

显示通信中使用的 USB 功率传输规范修订版的文件。

/sys/class/usb_power_delivery/.../sink-capabilities

在文件 sysfs-class-usb_power_delivery 中定义

接收能力消息“Sink_Capabilities”包含一组功率数据对象 (PDO)，与源能力一样，但这些对象不是描述电源能力，而是描述电源要求。

接收能力消息中对象的顺序与源能力消息中的顺序相同。

固定电源

/sys/class/usb_power_delivery/.../sink-capabilities/1:fixed_supply/higher_capability

在文件 sysfs-class-usb_power_delivery 中定义

此文件显示 vsafe5V 固定电源对象中更高能力位的值。如果设置了该位，则接收器需要大于 vsafe5V（例如 12 V）才能提供完整的功能。有效值：0、1

/sys/class/usb_power_delivery/.../sink-capabilities/<position>:battery/operational_power

在文件 sysfs-class-usb_power_delivery 中定义

接收器在给定电压范围内所需的运行功率。

标准功率范围 (SPR) 可编程电源

/sys/class/usb_power_delivery/.../sink-capabilities/<position>:fixed_supply/fast_role_swap_current

在文件 sysfs-class-usb_power_delivery 中定义

此文件包含“快速角色交换 USB Type-C 电流”字段的值，该字段指示快速角色交换后接收器所需的电流级别。0 - 不支持快速交换” 1 - 默认 USB 电源” 2 - 1.5A@5V” 3 - 3.0A@5V”

可变电源

/sys/class/usb_power_delivery/.../sink-capabilities/<position>:fixed_supply/operational_current

在文件 sysfs-class-usb_power_delivery 中定义

接收器的运行电流，单位为毫安。

/sys/class/usb_power_delivery/.../sink-capabilities/<position>:variable_supply/operational_current

在文件 sysfs-class-usb_power_delivery 中定义

接收器在给定电压范围内所需的运行电流，单位为毫安。

电池电源

/sys/class/usb_power_delivery/.../source-capabilities

在文件 sysfs-class-usb_power_delivery 中定义

源能力消息“Source_Capabilities”包含一组功率数据对象 (PDO)，每个对象代表一种电源类型。PDO 对象的顺序在 USB 功率传输规范中定义。每个 PDO（电源）都有其自己的设备，PDO 设备名称将以对象位置号作为第一个字符，后跟电源类型名称（“:”作为分隔符）。

/sys/class/usb_power_delivery/.../source_capabilities/<position>:<type>

/sys/class/usb_power_delivery/.../source-capabilities/1:fixed_supply/usb_suspend_supported

在文件 sysfs-class-usb_power_delivery 中定义

此文件显示 vSafe5V 固定电源对象中支持 USB 挂起位的值。如果设置了该位，则设备将遵循 USB 2.0 和 USB 3.2 的挂起和恢复规则。

/sys/class/usb_power_delivery/.../source-capabilities/<position>:battery/maximum_power

在文件 sysfs-class-usb_power_delivery 中定义

最大允许功率，单位为毫瓦。

/sys/class/usb_power_delivery/.../source-capabilities/<position>:fixed_supply/maximum_current

在文件 sysfs-class-usb_power_delivery 中定义

固定源电源的最大电流，单位为毫安。

/sys/class/usb_power_delivery/.../source-capabilities/<position>:fixed_supply/peak_current

在文件 sysfs-class-usb_power_delivery 中定义

此文件显示固定电源峰值电流能力字段的值。

/sys/class/usb_power_delivery/.../source-capabilities/<position>:programmable_supply/pps_power_limited

在文件 sysfs-class-usb_power_delivery 中定义

PPS 功率限制位指示源电源是否会在请求时超出额定输出功率。

/sys/class/usb_power_delivery/.../source-capabilities/<position>:variable_supply/maximum_current

在文件 sysfs-class-usb_power_delivery 中定义

源在给定电压范围内可以提供的最大电流，单位为毫安。

/sys/class/usb_power_delivery/.../version

在文件 sysfs-class-usb_power_delivery 中定义

这是一个可选的属性文件，显示 USB 功率传输规范特定修订版的版本。在大多数情况下，规范版本未知，该文件不可用。

/sys/class/usb_role/

在文件 sysfs-class-usb_role 中定义

sysfs 中 USB 角色开关的位置。USB 角色开关是一种可以为 USB 端口选择数据角色（主机或设备）的设备。

/sys/class/usb_role/<switch>/connector

在文件 sysfs-class-usb_role 中定义

指向 USB Type-C 连接器的可选符号链接。

/sys/class/usb_role/<switch>/role

在文件 sysfs-class-usb_role 中定义

开关的当前角色。此属性可用于请求与非 USB Type-C 端口进行角色交换。对于 USB Type-C 端口，必须使用为 USB Type-C 连接器类定义的 ABI。

有效值：- none - host - device

/sys/class/vduse/

在文件 sysfs-class-vduse 中定义

vduse/ 类子目录属于 VDUSE 框架，并为配置 VDUSE 设备提供 sysfs 接口。

/sys/class/vduse/<device-name>/

在文件 sysfs-class-vduse 中定义

当通过控制设备创建 VDUSE 设备时，会创建此目录条目。

/sys/class/vduse/<device-name>/msg_timeout

在文件 sysfs-class-vduse 中定义

(RW) 等待用户空间控制消息响应的超时时间（以秒为单位）。默认值为 30 秒。向该文件写入 '0' 表示禁用超时。

/sys/class/vduse/control/

在文件 sysfs-class-vduse 中定义

为 VDUSE 框架的控制设备创建此目录条目。

/sys/class/wakeup/

在文件 sysfs-class-wakeup 中定义

/sys/class/wakeup/ 目录包含指向内核中当前所有唤醒源的指针。

/sys/class/wakeup/.../active_count

在文件 sysfs-class-wakeup 中定义

此文件包含唤醒源被激活的次数。

/sys/class/wakeup/.../active_time_ms

在文件 sysfs-class-wakeup 中定义

此文件包含唤醒源持续处于活动状态的时间量，以毫秒为单位。如果唤醒源未激活，则此文件包含“0”。

/sys/class/wakeup/.../event_count

在文件 sysfs-class-wakeup 中定义

此文件包含与唤醒源关联的已发出信号的唤醒事件的数量。

/sys/class/wakeup/.../expire_count

在文件 sysfs-class-wakeup 中定义

此文件包含唤醒源的超时已过期的次数。

/sys/class/wakeup/.../last_change_ms

在文件 sysfs-class-wakeup 中定义

此文件包含上次触摸唤醒源时的单调时钟时间，以毫秒为单位。

/sys/class/wakeup/.../max_time_ms

在文件 sysfs-class-wakeup 中定义

此文件包含此唤醒源持续处于活动状态的最大时间量，以毫秒为单位。

/sys/class/wakeup/.../name

在文件 sysfs-class-wakeup 中定义

此文件包含唤醒源的名称。

/sys/class/wakeup/.../prevent_suspend_time_ms

在文件 sysfs-class-wakeup 中定义

该文件包含此唤醒源阻止自动休眠的总时间量，以毫秒为单位。

/sys/class/wakeup/.../total_time_ms

在文件 sysfs-class-wakeup 中定义

此文件包含此唤醒源处于活动状态的总时间量，以毫秒为单位。

/sys/class/wakeup/.../wakeup_count

在文件 sysfs-class-wakeup 中定义

此文件包含唤醒源可能中止挂起的次数。

/sys/class/watchdog/watchdog1/access_cs0

在文件 sysfs-class-watchdog 中定义

这是一个读/写文件。仅当系统由于 AST2400/AST2500 的看门狗定时器超时而从备用闪存芯片启动时，并且该看门狗的设备树选项中启用了“aspeed,alt-boot”备用启动功能或使用适当的硬件绑定（仅适用于 WDT2）时，此属性才存在。

在备用闪存上，“access_cs0”sysfs 节点提供

ast2400

一种在从 CS1 的备用芯片启动后访问 CS0 的主 SPI 闪存芯片的方法。

ast2500

一种将正常的地址映射从 (CS0->CS1, CS1->CS0) 恢复到 (CS0->CS0, CS1->CS1) 的方法。

清除引导代码选择和超时计数器也会将芯片选择线映射重置为初始状态。当 SoC 处于正常映射状态（即从 CS0 启动）时，清除这些位对于两个版本的 SoC 都没有任何作用。对于备用启动模式（由于 wdt2 超时而从 CS1 启动），其行为如上所述有所不同。

此选项只能与 wdt2 (watchdog1) 一起使用。

读取时，会显示引导代码选择的当前状态。写入任何非零值时，它会清除引导代码选择和超时计数器，从而导致 AST2400/AST2500 的芯片选择重置。

/sys/class/watchdog/watchdogn/bootstatus

在文件 sysfs-class-watchdog 中定义

这是一个只读文件。它包含启动时看门狗设备的状态。它等效于 ioctl 接口的 WDIOC_GETBOOTSTATUS。

/sys/class/watchdog/watchdogn/fw_version

在文件 sysfs-class-watchdog 中定义

这是一个只读文件。它包含看门狗设备的固件版本。

/sys/class/watchdog/watchdogn/identity

在文件 sysfs-class-watchdog 中定义

这是一个只读文件。它包含看门狗设备的标识字符串。

/sys/class/watchdog/watchdogn/nowayout

在文件 sysfs-class-watchdog 中定义

这是一个读/写文件。读取时，如果设备设置了 nowayout 功能，则返回“1”，否则返回“0”。向文件写入“1”将启用 nowayout 功能。设置后，nowayout 功能无法禁用，因此写入“0”要么不起作用（如果该功能已禁用），要么会导致权限错误。

/sys/class/watchdog/watchdogn/options

在文件 sysfs-class-watchdog 中定义

这是一个只读文件。它包含看门狗设备的选项。

/sys/class/watchdog/watchdogn/pretimeout

在文件 sysfs-class-watchdog 中定义

这是一个只读文件。它指定在超时之前传递预超时中断的时间（以秒为单位）。预超时是一项可选功能。

/sys/class/watchdog/watchdogn/pretimeout_available_governors

在文件 sysfs-class-watchdog 中定义

这是一个只读文件。它显示此看门狗可用的预超时调速器。

/sys/class/watchdog/watchdogn/pretimeout_governor

在文件 sysfs-class-watchdog 中定义

这是一个读/写文件。读取时，将返回当前分配的预超时调速器。写入时，将设置预超时调速器。

/sys/class/watchdog/watchdogn/state

在文件 sysfs-class-watchdog 中定义

这是一个只读文件。它提供看门狗设备的活动/非活动状态。

/sys/class/watchdog/watchdogn/status

在文件 sysfs-class-watchdog 中定义

这是一个只读文件。它包含看门狗设备的内部状态位。它等效于 ioctl 接口的 WDIOC_GETSTATUS。

/sys/class/watchdog/watchdogn/timeleft

在文件 sysfs-class-watchdog 中定义

这是一个只读文件。它包含剩余的重置生成时间值。它等效于 ioctl 接口的 WDIOC_GETTIMELEFT。

/sys/class/watchdog/watchdogn/timeout

在文件 sysfs-class-watchdog 中定义

这是一个只读文件。读取它可以了解已编程的当前超时值。

/sys/class/zram-control/

在文件 sysfs-class-zram 中定义

zram-control/ 类子目录属于 zram 设备类

/sys/class/zram-control/hot_add

在文件 sysfs-class-zram 中定义

RO 属性。读取操作将导致 zram 添加一个新设备并将其设备 ID 返回给用户（因此可以使用 /dev/zram<id>），或返回错误代码。

/sys/class/zram-control/hot_remove

在文件 sysfs-class-zram 中定义

WO 属性。删除特定的 /dev/zramX 设备，其中 X 是用户提供的 device_id。

/sys/dev 下的符号

/sys/dev

在文件 sysfs-dev 中定义

/sys/dev 树提供了一种使用 stat(2) 返回的信息查找设备的 sysfs 路径的方法。/sys/dev 下面有两个目录，“block”和“char”，其中包含名为“<major>:<minor>”的符号链接。这些链接指向给定设备的相应 sysfs 路径。

示例

$ readlink /sys/dev/block/8:32
../../block/sdc

/sys/dev/char 和 /sys/dev/block 中的条目将在设备进入和离开系统时动态创建和销毁。

用户：mdadm <linux-raid@vger.kernel.org>

/sys/devices 下的符号

/sys/devices

在文件 sysfs-devices 中定义

/sys/devices 树包含内核设备树的内部状态快照。设备将在机器运行时动态添加和删除，并且在不同的内核版本之间，此树中设备的布局将会更改。

请不要依赖此树的格式，因为这。如果程序希望在此树中查找不同的内容，请使用 /sys/class 结构并依赖其中的符号链接来指向 /sys/devices 树中各个设备的正确位置。或者，依赖 uevent 消息来通知程序设备从此树中添加和删除，以查找这些设备的位置。

请注意，有时并非目录链中的所有设备都会发出 uevent 消息，因此用户空间程序必须能够处理此类情况。

用户

udev <linux-hotplug-devel@lists.sourceforge.net>

/sys/devices/*/<our-device>/fuse

在文件 sysfs-driver-tegra-fuse 中定义

从 NVIDIA 读取 Tegra20、Tegra30、Tegra114 和 Tegra124 SoC 上的电子熔丝的只读权限。电子熔丝包含在工厂编程的一次性写入数据。数据以 LSB 优先格式布局在 32 位字中。每个位表示从熔丝寄存器解码的单个值。位顺序/分配与硬件寄存器完全匹配，包括任何未使用的位。

用户：任何想要读取 Tegra SoC 上电子熔丝的用户空间应用程序

/sys/devices/*/<our-device>/nvmem

在文件 sysfs-driver-jz4780-efuse 中定义

读取 Ingenic JZ4780 SoC 上电子熔丝的只读权限。该 SoC 具有一个一次性可编程的 8K 电子熔丝，分为多个段。该驱动程序支持只读。这些段是

0x000

64 位

随机数

0x008

128 位

Ingenic 芯片 ID

0x018

128 位

客户 ID

0x028

3520 位

保留

0x1E0

8 位

保护段

0x1E1

2296 位

HDMI 密钥

0x300

2048 位

安全启动密钥

用户：任何想要读取芯片和客户 ID 的用户空间应用程序

/sys/devices/*/xenbus/event_channels

在文件 sysfs-devices-xenbus 中定义

与基于内核的半虚拟化设备前端或后端关联的 Xen 事件通道数。

/sys/devices/*/xenbus/events

在文件 sysfs-devices-xenbus 中定义

为 Xen pv 设备前端或后端接收到的 Xen 事件总数。

/sys/devices/*/xenbus/jiffies_eoi_delayed

在文件 sysfs-devices-xenbus 中定义

为了避免由于事件风暴而导致的停顿，Xen pv 设备的 EOI 中断延迟的 jiffies 总时间。此值上升是 pv 设备的另一个端点出现问题的第一个迹象。

/sys/devices/*/xenbus/spurious_events

在文件 sysfs-devices-xenbus 中定义

为 Xen pv 设备接收到的不需要任何操作的事件数。连续发生过多虚假事件将触发延迟的 EOI 处理。

/sys/devices/*/xenbus/spurious_threshold

在文件 sysfs-devices-xenbus 中定义

控制在为 Xen pv 设备触发延迟的 EOI 处理之前容忍的后续虚假事件数。默认值为 1。如果 pv 设备的另一端定期发出虚假事件，并且已知并非故意恶意，则可以修改此值。在这种情况下提高该值可以提高 pv 设备的性能。

/sys/devices/.../consumer:<consumer>

在文件 sysfs-devices-consumer 中定义

/sys/devices/.../consumer:<consumer> 是指向设备链接的符号链接，其中此设备是供应商。<consumer> 表示该设备链接中消费者的名称，形式为 bus:设备名称。对于给定设备，可以有零个或多个此类符号链接。

/sys/devices/.../coredump

在文件 sysfs-devices-coredump 中定义

仅当设备绑定到提供 .coredump() 回调的驱动程序时，才存在 /sys/devices/.../coredump 属性。该属性为只写属性。写入此文件的任何内容都将触发 .coredump() 回调。

当启用 CONFIG_DEV_COREDUMP 时可用。

/sys/devices/.../firmware_node/

定义于文件 sysfs-devices-firmware_node

/sys/devices/.../firmware_node 目录包含一些属性，允许用户空间检查和修改给定设备的某些固件相关属性。

/sys/devices/.../firmware_node/description

定义于文件 sysfs-devices-firmware_node

/sys/devices/.../firmware/description 属性包含一个字符串，该字符串描述了 ACPI 命名空间中 _STR 方法提供的设备。此属性为只读。如果设备在 ACPI 命名空间中没有关联的 _STR 方法，则此属性不存在。

/sys/devices/.../intel_spi_bios_locked

定义于文件 sysfs-driver-spi-intel

此属性允许用户空间检查 Intel SPI flash 控制器的 BIOS 区域是否被锁定以进行写入。

/sys/devices/.../intel_spi_locked

定义于文件 sysfs-driver-spi-intel

此属性允许用户空间检查 Intel SPI flash 控制器是否锁定了支持的操作码。

/sys/devices/.../intel_spi_protected

定义于文件 sysfs-driver-spi-intel

此属性允许用户空间检查 Intel SPI flash 控制器是否受到主机的写入保护。

/sys/devices/.../iommu

在文件 sysfs-class-iommu 中定义

IOMMU 驱动程序能够在此处链接给定设备的 IOMMU，以便将设备与 IOMMU 关联起来。

/sys/devices/.../lpss_ltr/

定义于文件 sysfs-devices-lpss_ltr

/sys/devices/.../lpss_ltr/ 目录仅存在于包含在 Intel Lynxpoint 低功耗子系统 (LPSS) 中的设备。如果存在，它包含的属性包含设备的 LTR 模式和 LTR 寄存器的值。

/sys/devices/.../lpss_ltr/auto_ltr

定义于文件 sysfs-devices-lpss_ltr

/sys/devices/.../lpss_ltr/auto_ltr 属性包含设备的 AUTO_LTR 寄存器（原始）的当前值，表示为 8 位十六进制数。

此属性为只读。如果设备的运行时 PM 状态不是“活动”，则尝试从此属性读取会导致返回 -EAGAIN。

/sys/devices/.../lpss_ltr/ltr_mode

定义于文件 sysfs-devices-lpss_ltr

/sys/devices/.../lpss_ltr/ltr_mode 属性包含一个整数（0 或 1），指示设备的 LTR 功能是否在软件模式下工作 (1)。

此属性为只读。如果设备的运行时 PM 状态不是“活动”，则尝试从此属性读取会导致返回 -EAGAIN。

/sys/devices/.../lpss_ltr/sw_ltr

定义于文件 sysfs-devices-lpss_ltr

/sys/devices/.../lpss_ltr/auto_ltr 属性包含设备的 SW_LTR 寄存器（原始）的当前值，表示为 8 位十六进制数。

此属性为只读。如果设备的运行时 PM 状态不是“活动”，则尝试从此属性读取会导致返回 -EAGAIN。

/sys/devices/.../mmc_host/mmcX/mmcX:XXXX/enhanced_area_offset

定义于文件 sysfs-devices-mmc

增强区域是 eMMC4.4 标准中定义的新功能。eMMC4.4 或更高版本的卡可以支持此功能。这种区域可以帮助提高卡性能。如果启用了该功能，则此属性将指示增强数据区域的起始地址。否则，此属性将为 -EINVAL。单位：字节。格式：十进制。

/sys/devices/.../mmc_host/mmcX/mmcX:XXXX/enhanced_area_size

定义于文件 sysfs-devices-mmc

增强区域是 eMMC4.4 标准中定义的新功能。eMMC4.4 或更高版本的卡可以支持此功能。这种区域可以帮助提高卡性能。如果启用了该功能，则此属性将指示增强数据区域的大小。否则，此属性将为 -EINVAL。单位：千字节。格式：十进制。

/sys/devices/.../online

定义于文件 sysfs-devices-online

/sys/devices/.../online 属性仅存在于总线类型提供 .online() 和 .offline() 回调的设备。从中读取的数字（0 或 1）反映了设备的“offline”字段的值。如果该数字为 1，并且将“0”（或“n”或“N”）写入此文件，则将为该设备执行设备总线类型的 .offline() 回调，并且（如果成功）其“offline”字段将相应更新。反之，如果该数字为 0，并且将“1”（或“y”或“Y”）写入此文件，则将为该设备执行设备总线类型的 .online() 回调，并且（如果成功）其“offline”字段将相应更新。

成功执行总线类型的 .offline() 回调后，该设备将无法用于任何目的，直到将其删除（即为它调用 device_del()），或者成功执行其总线类型的 .online() 回调。

/sys/devices/.../physical_location

定义于文件 sysfs-devices-physical_location

此目录包含有关设备连接点相对于系统外壳的物理位置的信息。

/sys/devices/.../physical_location/dock

定义于文件 sysfs-devices-physical_location

如果设备连接点位于扩展坞或端口复制器中，则为“是”。否则为“否”。

/sys/devices/.../physical_location/horizontal_position

定义于文件 sysfs-devices-physical_location

描述设备连接点在面板表面上的水平位置。

/sys/devices/.../physical_location/lid

定义于文件 sysfs-devices-physical_location

如果设备连接点位于笔记本电脑系统的盖子上，则为“是”。否则为“否”。

/sys/devices/.../physical_location/panel

定义于文件 sysfs-devices-physical_location

描述设备连接点位于系统外壳的哪个面板表面上。

/sys/devices/.../physical_location/vertical_position

定义于文件 sysfs-devices-physical_location

描述设备连接点在面板表面上的垂直位置。

/sys/devices/.../power/

定义于文件 sysfs-devices-power

/sys/devices/.../power 目录包含一些属性，允许用户空间检查和修改给定设备的某些电源管理相关属性。

/sys/devices/.../power/async

定义于文件 sysfs-devices-power

/sys/devices/.../async 属性允许用户空间启用或禁用设备的挂起和恢复回调，以便在系统范围内的电源转换期间（例如，挂起到 RAM、休眠）异步执行（即，在单独的线程中，与主挂起/恢复线程并行执行）。

所有设备的 power/async 文件都有以下两个值之一

  • “enabledn” 允许异步挂起/恢复；

  • “disabledn” 禁止异步挂起/恢复；

可以通过向其写入“enabled”或“disabled”来更改此属性的值。

通常，除非确定设备的所有 PM 依赖项都为 PM 核心所知，否则允许异步挂起/恢复是不安全的。但是，对于某些设备，此属性由总线类型代码或设备驱动程序设置为“enabled”，在这种情况下，保留默认值应该是安全的。

/sys/devices/.../power/autosuspend_delay_ms

定义于文件 sysfs-devices-power

/sys/devices/.../power/autosuspend_delay_ms 属性包含自动挂起延迟值（以毫秒为单位）。某些驱动程序不希望其设备在运行时进入空闲状态后立即挂起；它们希望设备首先保持非活动状态一段最短时间。该时间段称为自动挂起延迟。负值将阻止设备在运行时挂起（类似于将“on”写入 power/control 属性）。大于等于 1000 的值会导致自动挂起计时器到期时间向上舍入到最接近的秒。

并非所有驱动程序都支持此属性。如果不支持，则尝试读取或写入它将产生 I/O 错误。

/sys/devices/.../power/control

定义于文件 sysfs-devices-power

/sys/devices/.../power/control 属性允许用户空间控制设备的运行时电源管理。

所有设备的 power/control 文件都有以下两个值之一

  • “auton” 允许在运行时对设备进行电源管理；

  • “onn” 防止对设备进行电源管理；

所有设备的默认值为“auto”，这意味着它们可能会受到自动电源管理，具体取决于它们的驱动程序。将此属性更改为“on”会阻止驱动程序在运行时对设备进行电源管理。在设备挂起时执行此操作会导致它被唤醒。

/sys/devices/.../power/pm_qos_latency_tolerance_us

定义于文件 sysfs-devices-power

/sys/devices/.../power/pm_qos_latency_tolerance_us 属性包含给定设备的 PM QoS 活动状态延迟容限限制（以微秒为单位）。这是设备在不对用户空间功能产生任何可见的不利影响的情况下可以承受的最大内存访问延迟。如果该值是字符串“any”，则延迟对用户空间根本不重要，但不应允许硬件自动为设备设置延迟容限。

从此文件中读取“auto”意味着设备的最大内存访问延迟可以由硬件根据需要自动确定。如果内核端没有其他延迟容限要求，则向其写入“auto”允许硬件切换到此模式。

仅当硬件支持它控制的功能时，此属性才存在。

此属性对设备的运行时挂起和恢复以及系统范围的挂起/恢复和休眠没有影响。

/sys/devices/.../power/pm_qos_no_power_off

定义于文件 sysfs-devices-power

/sys/devices/.../power/pm_qos_no_power_off 属性用于操作 PM QoS“no power off”标志。如果设置，此标志会向内核指示不应完全移除设备的电源。

并非所有驱动程序都支持此属性。如果不支持，则此属性不存在。

此属性对系统范围的挂起/恢复和休眠没有影响。

/sys/devices/.../power/pm_qos_resume_latency_us

定义于文件 sysfs-devices-power

/sys/devices/.../power/pm_qos_resume_latency_us 属性包含给定设备的 PM QoS 恢复延迟限制，这是设备在运行时挂起后，从恢复请求到设备准备好处理 I/O 的那一刻的最大允许时间（以微秒为单位）。但是，如果它等于 0，则表示 PM QoS 恢复延迟可以是任意的，而特殊值“n/a”表示用户空间根本不接受给定设备的任何恢复延迟。

并非所有驱动程序都支持此属性。如果不支持，则此属性不存在。

此属性对系统范围的挂起/恢复和休眠没有影响。

/sys/devices/.../power/runtime_active_kids

定义于文件 sysfs-devices-power

报告设备的运行时 PM 子使用计数，如果子项将被忽略，则报告 0。

/sys/devices/.../power/runtime_active_time

定义于文件 sysfs-devices-power

报告设备处于活动状态的总时间。用于运行时 PM 统计信息。

/sys/devices/.../power/runtime_enabled

定义于文件 sysfs-devices-power

是否为此设备启用了运行时 PM？状态为“enabled”、“disabled”、“forbidden”或后两者的组合。

/sys/devices/.../power/runtime_status

定义于文件 sysfs-devices-power

/sys/devices/.../power/runtime_status 属性包含设备当前的运行时 PM 状态，可能是“suspended”、“suspending”、“resuming”、“active”、“error”（致命错误）或“unsupported”（运行时 PM 已禁用）。

/sys/devices/.../power/runtime_suspended_time

定义于文件 sysfs-devices-power

报告设备挂起的总时间。用于运行时 PM 统计信息。

/sys/devices/.../power/runtime_usage

定义于文件 sysfs-devices-power

报告设备的运行时 PM 使用计数。

/sys/devices/.../power/wakeup

定义于文件 sysfs-devices-power

/sys/devices/.../power/wakeup 属性允许用户空间检查设备是否启用以从睡眠状态（例如，内存睡眠状态（挂起到 RAM）和休眠（挂起到磁盘））唤醒系统，并根据需要启用或禁用它。

某些设备支持“唤醒”事件，这些事件是用于将系统从睡眠状态激活的硬件信号。此类设备的 sysfs power/wakeup 文件具有以下两个值之一：

  • “enabledn”：发出事件；

  • “disabledn”：不发出事件；

在这种情况下，用户空间可以通过向该文件写入“enabled”或“disabled”来更改此文件内容所表示的设置。

对于不具备生成系统唤醒事件能力的设备，此文件不存在。在这种情况下，无法启用该设备从睡眠状态唤醒系统。

/sys/devices/.../power/wakeup_abort_count

定义于文件 sysfs-devices-power

/sys/devices/.../wakeup_abort_count 属性包含与该设备关联的唤醒事件处理可能中止正在进行的系统进入睡眠状态的次数。此属性是只读的。如果设备不具备从睡眠状态唤醒系统的能力，则此属性不存在。如果设备未被启用以从睡眠状态唤醒系统，则此属性为空。

/sys/devices/.../power/wakeup_active

定义于文件 sysfs-devices-power

/sys/devices/.../wakeup_active 属性包含 1 或 0，具体取决于是否正在处理与该设备关联的唤醒事件 (1)。此属性是只读的。如果设备不具备从睡眠状态唤醒系统的能力，则此属性不存在。如果设备未被启用以从睡眠状态唤醒系统，则此属性为空。

/sys/devices/.../power/wakeup_active_count

定义于文件 sysfs-devices-power

/sys/devices/.../wakeup_active_count 属性包含与该设备关联的唤醒事件处理完成（在内核级别）的次数。此属性是只读的。如果设备不具备从睡眠状态唤醒系统的能力，则此属性不存在。如果设备未被启用以从睡眠状态唤醒系统，则此属性为空。

/sys/devices/.../power/wakeup_count

定义于文件 sysfs-devices-power

/sys/devices/.../wakeup_count 属性包含与该设备关联的已发出信号的唤醒事件的数量。此属性是只读的。如果设备不具备从睡眠状态唤醒系统的能力，则此属性不存在。如果设备未被启用以从睡眠状态唤醒系统，则此属性为空。

/sys/devices/.../power/wakeup_expire_count

定义于文件 sysfs-devices-power

/sys/devices/.../wakeup_expire_count 属性包含与该设备关联的唤醒事件因超时而报告的次数。此属性是只读的。如果设备不具备从睡眠状态唤醒系统的能力，则此属性不存在。如果设备未被启用以从睡眠状态唤醒系统，则此属性为空。

/sys/devices/.../power/wakeup_last_time_ms

定义于文件 sysfs-devices-power

/sys/devices/.../wakeup_last_time_ms 属性包含与该设备关联的最后一次唤醒事件发出信号时单调时钟的值，单位为毫秒。此属性是只读的。如果设备未被启用以从睡眠状态唤醒系统，则此属性不存在。如果设备未被启用以从睡眠状态唤醒系统，则此属性为空。

/sys/devices/.../power/wakeup_max_time_ms

定义于文件 sysfs-devices-power

/sys/devices/.../wakeup_max_time_ms 属性包含与该设备关联的单个唤醒事件的最大处理时间，单位为毫秒。此属性是只读的。如果设备不具备从睡眠状态唤醒系统的能力，则此属性不存在。如果设备未被启用以从睡眠状态唤醒系统，则此属性为空。

/sys/devices/.../power/wakeup_prevent_sleep_time_ms

定义于文件 sysfs-devices-power

/sys/devices/.../wakeup_prevent_sleep_time_ms 属性包含设备阻止机会性转换到睡眠状态发生的时间总和。此属性是只读的。如果设备不具备从睡眠状态唤醒系统的能力，则此属性不存在。如果设备未被启用以从睡眠状态唤醒系统，则此属性为空。

/sys/devices/.../power/wakeup_total_time_ms

定义于文件 sysfs-devices-power

/sys/devices/.../wakeup_total_time_ms 属性包含与该设备关联的唤醒事件处理的总时间，单位为毫秒。此属性是只读的。如果设备不具备从睡眠状态唤醒系统的能力，则此属性不存在。如果设备未被启用以从睡眠状态唤醒系统，则此属性为空。

/sys/devices/.../power_resources_D0/

在文件 sysfs-devices-power_resources_D0 中定义

/sys/devices/.../power_resources_D0/ 目录仅存在于表示使用 ACPI 电源资源进行电源管理的 ACPI 设备节点的设备对象中。

如果存在，它包含指向设备目录的符号链接，这些设备目录表示需要打开的 ACPI 电源资源，以使给定设备节点处于 ACPI 电源状态 D0。链接的名称与它们指向的目录的名称相同。

/sys/devices/.../power_resources_D1/

在文件 sysfs-devices-power_resources_D1 中定义

/sys/devices/.../power_resources_D1/ 目录仅存在于表示使用 ACPI 电源资源进行电源管理并支持 ACPI 电源状态 D1 的 ACPI 设备节点的设备对象中。

如果存在，它包含指向设备目录的符号链接，这些设备目录表示需要打开的 ACPI 电源资源，以使给定设备节点处于 ACPI 电源状态 D1。链接的名称与它们指向的目录的名称相同。

/sys/devices/.../power_resources_D2/

在文件 sysfs-devices-power_resources_D2 中定义

/sys/devices/.../power_resources_D2/ 目录仅存在于表示使用 ACPI 电源资源进行电源管理并支持 ACPI 电源状态 D2 的 ACPI 设备节点的设备对象中。

如果存在，它包含指向设备目录的符号链接，这些设备目录表示需要打开的 ACPI 电源资源，以使给定设备节点处于 ACPI 电源状态 D2。链接的名称与它们指向的目录的名称相同。

/sys/devices/.../power_resources_D3hot/

在文件 sysfs-devices-power_resources_D3hot 中定义

/sys/devices/.../power_resources_D3hot/ 目录仅存在于表示使用 ACPI 电源资源进行电源管理并支持 ACPI 电源状态 D3hot 的 ACPI 设备节点的设备对象中。

如果存在，它包含指向设备目录的符号链接，这些设备目录表示需要打开的 ACPI 电源资源，以使给定设备节点处于 ACPI 电源状态 D3hot。链接的名称与它们指向的目录的名称相同。

/sys/devices/.../power_resources_wakeup/

在文件 sysfs-devices-power_resources_wakeup 中定义

/sys/devices/.../power_resources_wakeup/ 目录仅存在于表示需要 ACPI 电源资源进行唤醒信号的 ACPI 设备节点的设备对象中。

如果存在，它包含指向设备目录的符号链接，这些设备目录表示需要打开的 ACPI 电源资源，以使给定设备节点能够发出唤醒信号。链接的名称与它们指向的目录的名称相同。

/sys/devices/.../power_state

在文件 sysfs-devices-power_state 中定义

/sys/devices/.../power_state 属性仅存在于表示提供电源管理方法的 ACPI 设备节点的设备对象中。

如果存在，它包含一个字符串，表示给定设备节点当前的 ACPI 电源状态。它的可能值“D0”、“D1”、“D2”、“D3hot”和“D3cold”反映了 ACPI 规范（ACPI 4 及更高版本）定义的电源状态名称。

如果设备节点使用共享的 ACPI 电源资源，则此状态确定了不应关闭的电源资源列表。但是，由于某些其他设备当前正在使用它们，因此设备节点在较高功率（较低编号）状态下所需的一些电源资源也可能处于开启状态。

此属性是只读的。

/sys/devices/.../real_power_state

在文件 sysfs-devices-real_power_state 中定义

/sys/devices/.../real_power_state 属性仅存在于表示提供电源管理方法并使用 ACPI 电源资源进行电源管理的 ACPI 设备节点的设备对象中。

如果存在，它包含一个字符串，表示由 _PSC 控制方法返回或从电源资源的配置推断出的给定设备节点的真实 ACPI 电源状态。它的可能值“D0”、“D1”、“D2”、“D3hot”和“D3cold”反映了 ACPI 规范（ACPI 4 及更高版本）定义的电源状态名称。

在某些情况下，此属性的值可能与同一设备对象的 /sys/devices/.../power_state 属性的值不同。如果发生这种情况，则设备节点使用的一些共享电源资源仅是因为某些其他设备当前正在使用它们而处于开启状态。

此属性是只读的。

/sys/devices/.../removable

在文件 sysfs-devices-removable 中定义

关于用户是否可以从平台移除给定设备的信息。这由其子系统以总线/平台特定的方式确定。此属性仅存在于可以支持确定此类信息的设备中

“removable”

设备可以由用户从平台移除

“fixed”

设备固定在平台上/无法由用户移除。

“unknown”

信息不可用/无法推断。

目前，这仅受 USB 支持（它从集线器描述符位和平台特定数据（如 ACPI）的组合中推断信息）和 PCI 支持（它从 ACPI/设备树获取此信息）。

/sys/devices/.../resource_in_use

在文件 sysfs-devices-resource_in_use 中定义

/sys/devices/.../resource_in_use 属性仅存在于表示 ACPI 电源资源的设备对象中。

如果存在，它包含一个数字（0 或 1），表示给定电源资源的当前状态（0 表示该资源未在使用，因此已关闭）。

此属性是只读的。

/sys/devices/.../software_node/

在文件 sysfs-devices-software_node 中定义

此目录包含有关在内核（即软件）中分配的设备的详细信息，而不是 firmware_node 目录，后者包含在固件中为设备分配的详细信息。目录中的主要属性将显示设备具有的属性以及它与其他某些设备的关系。

/sys/devices/.../state_synced

在文件 sysfs-devices-state_synced 中定义

/sys/devices/.../state_synced 属性仅存在于其总线类型或驱动程序提供 .sync_state() 回调的设备中。从中读取的数字（0 或 1）反映了设备的“state_synced”字段的值。值 0 表示尚未调用 .sync_state() 回调。值 1 表示已调用 .sync_state() 回调。

通常，如果一个设备支持 sync_state() 功能，并且在内核启动时启用了其提供的某些资源（例如：通过硬件重置、引导加载程序或任何在内核启动前运行的东西启用），那么它将保持这些资源启用，并保持与内核启动时状态兼容的状态。只有在 sync_state() 回调被调用后，设备才会停止这样做——这只会在其所有消费者设备都已注册并成功探测后才会发生。在内核启动时保持禁用的资源不会受到 sync_state() 回调的影响或任何方式的限制。

如果设备的 sync_state() 函数尚未被调用，向此文件写入“1”将强制调用该函数。sync_state() 的调用与消费者设备的状态无关。

/sys/devices/.../sun

定义在文件 sysfs-devices-sun

该文件包含一个由 ACPI 命名空间中的 _SUN 方法提供的插槽唯一 ID。该值在高级配置和电源接口规范中如下编写：

“_SUN 值在同一类型的插槽中必须是唯一的。还建议尽可能使此数字与物理插槽上打印的插槽号匹配。”

因此，读取 sysfs 文件，我们可以识别系统中插槽的物理位置。

/sys/devices/.../supplier:<供应商>

定义在文件 sysfs-devices-supplier

/sys/devices/.../supplier:<供应商> 是指向该设备作为消费者的设备链接的符号链接。<供应商> 表示该设备链接中供应商的名称，格式为 总线:设备名称。一个给定的设备可以有零个或多个这样的符号链接。

/sys/devices/.../waiting_for_supplier

定义在文件 sysfs-devices-waiting_for_supplier

只有在启用了 fw_devlink 内核命令行选项并且设置为比“permissive”更严格的值时，才存在 /sys/devices/.../waiting_for_supplier 属性。一旦设备成功探测，它就会被删除（因为该信息不再相关）。从中读取的数字（0 或 1）反映了设备是否在可以探测之前，正在等待一个或多个供应商被添加，然后使用设备链接链接到该设备。

值 0 表示设备在可以探测之前，不需要等待任何供应商被添加。值 1 表示设备在可以探测之前，正在等待一个或多个供应商被添加。

/sys/devices/../../gisb_arb_timeout

定义在文件 sysfs-platform-brcmstb-gisb-arb

返回博通机顶盒内部 GISB 总线仲裁器当前配置的原始超时值。最小值是 1，最大值是 0xffffffff。

/sys/devices/LNXSYSTM:00/LNXSYBUS:00/TOS620A:00/protection_level

定义在文件 sysfs-driver-toshiba_haps

此文件控制内置加速度计的保护级别，有效值是

  • 0 -> 禁用

  • 1 -> 低

  • 2 -> 中

  • 3 -> 高

默认保护值设置为 2（中）。

用户：KToshiba

/sys/devices/LNXSYSTM:00/LNXSYBUS:00/TOS620A:00/reset_protection

定义在文件 sysfs-driver-toshiba_haps

此文件关闭内置加速度计几秒钟，然后恢复正常操作。只接受 1 作为参数。

/sys/devices/LNXSYSTM:00/LNXSYBUS:00/TOS{1900,620{0,7,8}}:00/available_kbd_modes

定义在文件 sysfs-driver-toshiba_acpi

此文件显示系统支持的键盘背光模式，可以是

  • 0x1 -> FN-Z

  • 0x2 -> AUTO（也称为 TIMER）

  • 0x8 -> ON

  • 0x10 -> OFF

请注意，并非所有键盘类型都支持列出的模式。请参阅名为“available_kbd_modes”的条目

用户：KToshiba

/sys/devices/LNXSYSTM:00/LNXSYBUS:00/TOS{1900,620{0,7,8}}:00/cooling_method

定义在文件 sysfs-driver-toshiba_acpi

此文件控制冷却方法功能。读取此文件会打印两个值，第一个是实际的冷却方法，第二个是支持的最大冷却方法。当最大冷却方法为 ONE 时，有效值为

  • 0 -> 最大性能

  • 1 -> 电池优化

当最大冷却方法为 TWO 时，有效值为

  • 0 -> 最大性能

  • 1 -> 性能

  • 2 -> 电池优化

用户：KToshiba

/sys/devices/LNXSYSTM:00/LNXSYBUS:00/TOS{1900,620{0,7,8}}:00/fan

定义在文件 sysfs-driver-toshiba_acpi

此文件控制内部风扇的状态，有效值是

  • 0 -> OFF

  • 1 -> ON

/sys/devices/LNXSYSTM:00/LNXSYBUS:00/TOS{1900,620{0,7,8}}:00/kbd_backlight_mode

定义在文件 sysfs-driver-toshiba_acpi

此文件控制键盘背光操作模式，有效值是

  • 0x1 -> FN-Z

  • 0x2 -> AUTO（也称为 TIMER）

  • 0x8 -> ON

  • 0x10 -> OFF

请注意，从内核 3.16 开始，此文件接受所有列出的参数，内核 3.15 仅接受前两个（FN-Z 和 AUTO）。另请注意，在 1 型设备上切换此值，需要重新启动才能使更改生效。

用户：KToshiba

/sys/devices/LNXSYSTM:00/LNXSYBUS:00/TOS{1900,620{0,7,8}}:00/kbd_backlight_timeout

定义在文件 sysfs-driver-toshiba_acpi

当操作模式设置为 AUTO（或 TIMER）时，此文件控制键盘背光的超时时间，有效值范围为 0-60。请注意，内核 3.15 仅支持第一种键盘类型，内核 3.16 添加了对第二种类型的支持，第二种类型接受的范围是 1-60。请参阅名为“kbd_type”的条目

用户：KToshiba

/sys/devices/LNXSYSTM:00/LNXSYBUS:00/TOS{1900,620{0,7,8}}:00/kbd_function_keys

定义在文件 sysfs-driver-toshiba_acpi

此文件控制特殊功能（热键）的操作模式，有效值是

  • 0 -> 正常操作

  • 1 -> 特殊功能

在“正常操作”模式下，F{1-12} 键像往常一样，热键通过 FN-F{1-12} 访问。在“特殊功能”模式下，F{1-12} 键触发热键，F{1-12} 键通过 FN-F{1-12} 访问。请注意，切换此值需要重新启动才能使更改生效。

用户：KToshiba

/sys/devices/LNXSYSTM:00/LNXSYBUS:00/TOS{1900,620{0,7,8}}:00/kbd_type

定义在文件 sysfs-driver-toshiba_acpi

此文件显示当前的键盘背光类型，可以是

  • 1 -> 1 型，支持模式 FN-Z 和 AUTO

  • 2 -> 2 型，支持模式 TIMER、ON 和 OFF

用户：KToshiba

/sys/devices/LNXSYSTM:00/LNXSYBUS:00/TOS{1900,620{0,7,8}}:00/panel_power_on

定义在文件 sysfs-driver-toshiba_acpi

此文件控制笔记本电脑是否应在 LID 打开时开机，有效值是

  • 0 -> 禁用

  • 1 -> 启用

请注意，切换此值需要重新启动才能使更改生效。

用户：KToshiba

/sys/devices/LNXSYSTM:00/LNXSYBUS:00/TOS{1900,620{0,7,8}}:00/position

定义在文件 sysfs-driver-toshiba_acpi

此文件显示内置加速度计的绝对位置。

/sys/devices/LNXSYSTM:00/LNXSYBUS:00/TOS{1900,620{0,7,8}}:00/sleep_functions_on_battery

定义在文件 sysfs-driver-toshiba_acpi

此文件控制电池下的 USB 睡眠功能，并设置禁用它们的电量水平，可接受的值是

  • 0 -> 禁用

  • 1-100 -> 禁用睡眠功能的电池电量水平

目前它会打印两个值，第一个值表示该功能是启用还是禁用，而第二个值显示当前设置的电池电量水平。请注意，当该值设置为禁用时，睡眠功能只有在连接电源时才能工作。

用户：KToshiba

/sys/devices/LNXSYSTM:00/LNXSYBUS:00/TOS{1900,620{0,7,8}}:00/touchpad

定义在文件 sysfs-driver-toshiba_acpi

此文件控制触摸板和指点杆（如果有）的状态，有效值是

  • 0 -> OFF

  • 1 -> ON

用户：KToshiba

/sys/devices/LNXSYSTM:00/LNXSYBUS:00/TOS{1900,620{0,7,8}}:00/usb_rapid_charge

定义在文件 sysfs-driver-toshiba_acpi

此文件控制 USB 快速充电状态，可以是

  • 0 -> 禁用

  • 1 -> 启用

请注意，切换此值需要重新启动才能使更改生效。

用户：KToshiba

/sys/devices/LNXSYSTM:00/LNXSYBUS:00/TOS{1900,620{0,7,8}}:00/usb_sleep_charge

定义在文件 sysfs-driver-toshiba_acpi

此文件控制 USB 睡眠和充电模式，可以是

  • 0 -> 禁用 (0x00)

  • 1 -> 备用 (0x09)

  • 2 -> 自动 (0x21)

  • 3 -> 典型 (0x11)

请注意，从内核 4.1 开始，此文件接受所有列出的值，内核 4.0 仅支持前三个。请注意，此功能仅在连接电源时才工作，如果想在电池下使用它，请参阅名为“sleep_functions_on_battery”的条目

用户：KToshiba

/sys/devices/LNXSYSTM:00/LNXSYBUS:00/TOS{1900,620{0,7,8}}:00/usb_sleep_music

定义在文件 sysfs-driver-toshiba_acpi

此文件控制睡眠和音乐状态，其值可以是

  • 0 -> 禁用

  • 1 -> 启用

请注意，此功能仅在连接电源时才工作，如果想在电池下使用它，请参阅名为“sleep_functions_on_battery”的条目

用户：KToshiba

/sys/devices/LNXSYSTM:00/LNXSYBUS:00/TOS{1900,620{0,7,8}}:00/usb_three

定义在文件 sysfs-driver-toshiba_acpi

此文件控制 USB 3 功能，有效值是

  • 0 -> 禁用（作为普通的 USB 2）

  • 1 -> 启用（完整的 USB 3 功能）

请注意，切换此值需要重新启动才能使更改生效。

用户：KToshiba

/sys/devices/LNXSYSTM:00/LNXSYBUS:00/TOS{1900,620{0,7,8}}:00/version

定义在文件 sysfs-driver-toshiba_acpi

此文件显示当前驱动程序的版本

用户：KToshiba

/sys/devices/cpu/events/

定义在文件 sysfs-bus-event_source-devices-events 中

通用性能监视事件

许多/大多数 CPU 可能支持的性能监视事件的集合。可以使用“perf(1)”工具监视这些事件。

每个文件的内容如下所示

event=0xNNNN

其中“N”是十六进制数字，数字“0xNNNN”显示由文件的“basename”标识的 perf 事件的“原始代码”。

/sys/devices/hisi_ptt<sicl_id>_<core_id>/requester_filters

定义在文件 sysfs-bus-event_source-devices-hisi_ptt 中

此目录包含提供用于 PTT 跟踪的 PCIe 请求者过滤器信息的文件。每个文件都以支持的端点设备名称 <域>:<总线>:<设备>.<功能> 命名。

有关更多信息，请参阅 海思 PCIe 调优和跟踪设备 中“filter”的描述。

/sys/devices/hisi_ptt<sicl_id>_<core_id>/requester_filters/<bdf>

定义在文件 sysfs-bus-event_source-devices-hisi_ptt 中

（读取）指示此请求者过滤器的过滤器值，该值可用于控制 PTT 跟踪要跟踪的 TLP 标头。

/sys/devices/hisi_ptt<sicl_id>_<core_id>/requester_filters/multiselect

定义在文件 sysfs-bus-event_source-devices-hisi_ptt 中

（读取）指示这种过滤器是否可以与其他过滤器同时选择，或者必须单独使用。1 表示前者，0 表示后者。

/sys/devices/hisi_ptt<sicl_id>_<core_id>/root_port_filters

定义在文件 sysfs-bus-event_source-devices-hisi_ptt 中

此目录包含提供用于 PTT 跟踪的 PCIe 根端口过滤器信息的文件。每个文件都以支持的根端口设备名称 <域>:<总线>:<设备>.<功能> 命名。

有关更多信息，请参阅 海思 PCIe 调优和跟踪设备 中“filter”的描述。

/sys/devices/hisi_ptt<sicl_id>_<core_id>/root_port_filters/<bdf>

定义在文件 sysfs-bus-event_source-devices-hisi_ptt 中

（读取）指示此根端口过滤器的过滤器值，该值可用于控制 PTT 跟踪要跟踪的 TLP 标头。

/sys/devices/hisi_ptt<sicl_id>_<core_id>/root_port_filters/multiselect

定义在文件 sysfs-bus-event_source-devices-hisi_ptt 中

（读取）指示这种过滤器是否可以与其他过滤器同时选择，或者必须单独使用。1 表示前者，0 表示后者。

/sys/devices/hv_24x7/cpumask

定义在文件 sysfs-bus-event_source-devices-hv_24x7 中

只读 此 sysfs 文件公开 cpumask，该 cpumask 被指定用于调用 HCALL 来检索 hv-24x7 pmu 事件计数器数据。

/sys/devices/hv_24x7/interface/chipspersocket

定义在文件 sysfs-bus-event_source-devices-hv_24x7 中

只读 此 sysfs 接口公开系统中每个插槽的芯片数量。

/sys/devices/hv_24x7/interface/coresperchip

定义在文件 sysfs-bus-event_source-devices-hv_24x7 中

只读 此 sysfs 接口公开系统中每个芯片的内核数量。

/sys/devices/hv_24x7/interface/sockets

定义在文件 sysfs-bus-event_source-devices-hv_24x7 中

只读 此 sysfs 接口公开系统中存在的插槽数量。

/sys/devices/hv_gpci/cpumask

定义在文件 sysfs-bus-event_source-devices-hv_gpci 中

只读 此 sysfs 文件公开 cpumask，该 cpumask 被指定用于调用 HCALL 来检索 hv-gpci pmu 事件计数器数据。

/sys/devices/hv_gpci/interface/affinity_domain_via_domain

定义在文件 sysfs-bus-event_source-devices-hv_gpci 中

管理员只读 此 sysfs 文件通过调用 HCALL H_GET_PERF_COUNTER_INFO 公开系统拓扑信息。HCALL 是使用计数器请求值 AFFINITY_DOMAIN_INFORMATION_BY_DOMAIN(0xB0) 进行的。

  • 此 sysfs 文件仅为 power10 及更高版本的平台创建。

  • 用户需要 root 权限才能从此 sysfs 文件读取数据。

  • 只有当 HCALL 返回“H_SUCCESS”、“H_AUTHORITY”或“H_PARAMETER”作为返回类型时，才会创建此 sysfs 文件。

    可以通过设置“启用性能信息收集”选项，在运行时解决返回错误类型“H_AUTHORITY”的 HCALL。

  • 读取此 sysfs 文件的最终用户必须按照底层平台/固件解码内容。

读取此 sysfs 文件时可能出现的错误代码

  • “-EPERM”分区不允许检索性能信息，

    需要设置“启用性能信息收集”选项。

  • “-EIO”由于缓冲区长度无效/地址无效，无法检索系统信息

    或者由于某些硬件错误。有关更多信息，请参阅 getPerfCountInfo 文档。

  • “-EFBIG”：系统信息超出 PAGE_SIZE。

/sys/devices/hv_gpci/interface/affinity_domain_via_partition

定义在文件 sysfs-bus-event_source-devices-hv_gpci 中

管理员只读。此 sysfs 文件通过调用 HCALL H_GET_PERF_COUNTER_INFO 来公开系统拓扑信息。HCALL 调用时使用的计数器请求值为 AFFINITY_DOMAIN_INFORMATION_BY_PARTITION(0xB1)。

  • 此 sysfs 文件仅为 power10 及更高版本的平台创建。

  • 用户需要 root 权限才能从此 sysfs 文件读取数据。

  • 只有当 HCALL 返回“H_SUCCESS”、“H_AUTHORITY”或“H_PARAMETER”作为返回类型时，才会创建此 sysfs 文件。

    可以通过设置“启用性能信息收集”选项，在运行时解决返回错误类型“H_AUTHORITY”的 HCALL。

  • 读取此 sysfs 文件的最终用户必须按照底层平台/固件解码内容。

读取此 sysfs 文件时可能出现的错误代码

  • “-EPERM”分区不允许检索性能信息，

    需要设置“启用性能信息收集”选项。

  • “-EIO”由于缓冲区长度无效/地址无效，无法检索系统信息

    或者由于某些硬件错误。有关更多信息，请参阅 getPerfCountInfo 文档。

  • “-EFBIG”：系统信息超出 PAGE_SIZE。

/sys/devices/hv_gpci/interface/affinity_domain_via_virtual_processor

定义在文件 sysfs-bus-event_source-devices-hv_gpci 中

管理员只读。此 sysfs 文件通过调用 HCALL H_GET_PERF_COUNTER_INFO 来公开系统拓扑信息。HCALL 调用时使用的计数器请求值为 AFFINITY_DOMAIN_INFORMATION_BY_VIRTUAL_PROCESSOR(0xA0)。

  • 此 sysfs 文件仅为 power10 及更高版本的平台创建。

  • 用户需要 root 权限才能从此 sysfs 文件读取数据。

  • 只有当 HCALL 返回“H_SUCCESS”、“H_AUTHORITY”或“H_PARAMETER”作为返回类型时，才会创建此 sysfs 文件。

    可以通过设置“启用性能信息收集”选项，在运行时解决返回错误类型“H_AUTHORITY”的 HCALL。

  • 读取此 sysfs 文件的最终用户必须按照底层平台/固件解码内容。

读取此 sysfs 文件时可能出现的错误代码

  • “-EPERM”分区不允许检索性能信息，

    需要设置“启用性能信息收集”选项。

  • “-EIO”由于缓冲区长度无效/地址无效，无法检索系统信息

    或者由于某些硬件错误。有关更多信息，请参阅 getPerfCountInfo 文档。

  • “-EFBIG”：系统信息超出 PAGE_SIZE。

/sys/devices/hv_gpci/interface/processor_bus_topology

定义在文件 sysfs-bus-event_source-devices-hv_gpci 中

管理员只读。此 sysfs 文件通过调用 HCALL H_GET_PERF_COUNTER_INFO 来公开系统拓扑信息。HCALL 调用时使用的计数器请求值为 PROCESSOR_BUS_TOPOLOGY(0xD0)。

  • 此 sysfs 文件仅为 power10 及更高版本的平台创建。

  • 用户需要 root 权限才能从此 sysfs 文件读取数据。

  • 只有当 HCALL 返回“H_SUCCESS”、“H_AUTHORITY”或“H_PARAMETER”作为返回类型时，才会创建此 sysfs 文件。

    可以通过设置“启用性能信息收集”选项，在运行时解决返回错误类型“H_AUTHORITY”的 HCALL。

  • 读取此 sysfs 文件的最终用户必须按照底层平台/固件解码内容。

读取此 sysfs 文件时可能出现的错误代码

  • “-EPERM”分区不允许检索性能信息，

    需要设置“启用性能信息收集”选项。

  • “-EIO”由于缓冲区长度无效/地址无效，无法检索系统信息

    或者由于某些硬件错误。有关更多信息，请参阅 getPerfCountInfo 文档。

  • “-EFBIG”：系统信息超出 PAGE_SIZE。

/sys/devices/hv_gpci/interface/processor_config

定义在文件 sysfs-bus-event_source-devices-hv_gpci 中

管理员只读。此 sysfs 文件通过调用 HCALL H_GET_PERF_COUNTER_INFO 来公开系统拓扑信息。HCALL 调用时使用的计数器请求值为 PROCESSOR_CONFIG(0x90)。

  • 此 sysfs 文件仅为 power10 及更高版本的平台创建。

  • 用户需要 root 权限才能从此 sysfs 文件读取数据。

  • 只有当 HCALL 返回“H_SUCCESS”、“H_AUTHORITY”或“H_PARAMETER”作为返回类型时，才会创建此 sysfs 文件。

    可以通过设置“启用性能信息收集”选项，在运行时解决返回错误类型“H_AUTHORITY”的 HCALL。

  • 读取此 sysfs 文件的最终用户必须按照底层平台/固件解码内容。

读取此 sysfs 文件时可能出现的错误代码

  • “-EPERM”分区不允许检索性能信息，

    需要设置“启用性能信息收集”选项。

  • “-EIO”由于缓冲区长度无效/地址无效，无法检索系统信息

    或者由于某些硬件错误。有关更多信息，请参阅 getPerfCountInfo 文档。

  • “-EFBIG”：系统信息超出 PAGE_SIZE。

/sys/devices/pci0000:00/*/QEMU0001:00/capability for MMIO

在文件 sysfs-bus-pci-devices-pvpanic 中定义。

只读属性。QEMU 支持的 pvpanic 设备的功能。

格式：%x。

详细的位定义请参阅 pvpanic 设备规范中的“<位定义>”部分：https://git.qemu.org/?p=qemu.git;a=blob_plain;f=docs/specs/pvpanic.txt

/sys/devices/pci0000:00/*/QEMU0001:00/events

在文件 sysfs-bus-pci-devices-pvpanic 中定义。

读写属性。设置/获取正在使用的功能。此属性用于启用/禁用 pvpanic 设备的功能。请注意，此值应为 capability 的子集。

格式：%x。

另请参阅 pvpanic 设备规范。

/sys/devices/pci0000:00/<dev>/avs/fw_version

在文件 sysfs-bus-pci-devices-avs 中定义。

ASoC avs 驱动程序正在与之通信的 AudioDSP 固件版本。

格式：%d.%d.%d.%d，类型：主版本:次版本:构建版本。

/sys/devices/pci0000:00/<dev>/fw_info

在文件 sysfs-bus-pci-devices-catpt 中定义。

详细的 AudioDSP 固件构建信息，包括构建哈希和日志提供程序哈希。此信息在与固件的初始握手期间获得。格式：%s。

/sys/devices/pci0000:00/<dev>/fw_version

在文件 sysfs-bus-pci-devices-catpt 中定义。

ASoC catpt 驱动程序正在与之通信的 AudioDSP 固件版本。

格式：%d.%d.%d.%d，类型：主版本:次版本:构建版本。

/sys/devices/platform/*/cnqf_enable

在文件 sysfs-amd-pmf 中定义。

读取此文件可以得知 AMD 平台管理 (PMF) Cool n Quiet 框架 (CnQF) 功能是否已启用。

默认情况下，此功能未启用，仅当 OEM BIOS 将“标志”传递给 PMF ACPI 函数（索引 11 或 12）时，或者用户写入“on”时才会启用。

要关闭 CnQF，用户可以向 sysfs 节点写入“off”。注意：支持自动模式的系统将没有此 sysfs 文件可用。

/sys/devices/platform/.../power_on_reason

在文件 sysfs-platform-power-on-reason 中定义。

显示系统开机原因。可以读取以下字符串/原因（列表可以扩展）： “regular power-up”、“RTC wakeup”、“watchdog timeout”、“software reset”、“reset button action”、“CPU clock failure”、“crystal oscillator failure”、“brown-out reset”、“unknown reason”。

该文件为只读。

/sys/devices/platform/.../ufshci_capabilities/man_id

定义在文件 sysfs-driver-ufs 中

主机功能寄存器组：制造商 ID 寄存器。符号 - HCMID。此文件显示 UFSHCD 制造商 ID。制造商 ID 由 JEDEC 在 JEDEC-JEP106 中定义。该文件是只读的。

/sys/devices/platform/.../ufshci_capabilities/product_id

定义在文件 sysfs-driver-ufs 中

主机功能寄存器组：产品 ID 寄存器。符号 - HCPID。此文件显示 UFSHCD 产品 ID。此寄存器的内容是供应商特定的。该文件是只读的。

/sys/devices/platform/.../ufshci_capabilities/version

定义在文件 sysfs-driver-ufs 中

主机功能寄存器组：UFS 版本寄存器。符号 - VER。此文件显示 UFSHCD 版本。例如：版本 3.12 将表示为 0000_0312h。该文件是只读的。

/sys/devices/platform/8086<x>:00/firmware_version

在文件 sysfs-platform-sst-atom 中定义。

所有 atom 平台（BYT/CHT/Merrifield/BSW）上 SST 驱动程序的 LPE 固件版本。如果从未加载过固件，它将显示

"FW not yet loaded"

如果已加载固件，它将显示

"v01.aa.bb.cc"

aa: 主版本反映 SoC 版本

0d

BYT 固件

0b

BSW 固件

07:

Merrifield 固件

bb: 次版本

cc: 构建版本

/sys/devices/platform/<i2c-demux-name>/available_masters

在文件 sysfs-platform-i2c-demux-pinctrl 中定义。

读取该文件将为您提供可为解复用总线选择的主设备列表。格式为“<index>:<name>”。来自瑞萨 Lager 板的示例

0:/i2c@e6500000 1:/i2c@e6508000

/sys/devices/platform/<i2c-demux-name>/current_master

在文件 sysfs-platform-i2c-demux-pinctrl 中定义。

此文件选择/显示解复用总线的活动 I2C 主设备。它使用文件“available_masters”中的 <index> 值。

/sys/devices/platform/<phy-name>/role

在文件 sysfs-platform-phy-rcar-gen3-usb2 中定义。

此文件可以读写。该文件可以显示/更改 USB 角色交换的 phy 模式。

写入以下字符串以更改模式

  • “host” - 将模式从外围设备切换到主机。

  • “peripheral” - 将模式从主机切换到外围设备。

读取该文件，然后它显示以下字符串

  • “host” - 现在是主机模式。

  • “peripheral” - 现在是外围设备模式。

/sys/devices/platform/<platform>/available_mini_led_mode

在文件 sysfs-platform-asus-wmi 中定义。

列出可用的 mini-led 模式。

/sys/devices/platform/<platform>/boot_sound

在文件 sysfs-platform-asus-wmi 中定义。

设置是否在启动时播放 BIOS POST 声音。

  • 0 - 假，

  • 1 - 真

/sys/devices/platform/<platform>/camera

在文件 sysfs-platform-asus-wmi 中定义。

控制摄像头。1 表示开启，0 表示关闭。

/sys/devices/platform/<platform>/cardr

在文件 sysfs-platform-asus-wmi 中定义。

控制读卡器。1 表示开启，0 表示关闭。

/sys/devices/platform/<platform>/charge_mode

在文件 sysfs-platform-asus-wmi 中定义。

获取当前正在使用的充电模式

  • 1 - 连接的桶形充电器，

  • 2 - USB-C 充电

  • 3 - 两者都已连接，桶形充电器用于充电

/sys/devices/platform/<platform>/cpufv

在文件 sysfs-platform-asus-wmi 中定义。

更改 CPU 时钟配置（只写）。有三种可用的时钟配置

  • 0 -> 超高性能模式

  • 1 -> 高性能模式

  • 2 -> 节能模式

/sys/devices/platform/<platform>/dgpu_disable

在文件 sysfs-platform-asus-wmi 中定义。

禁用独立 GPU

  • 0 - 启用 dGPU，

  • 1 - 禁用 dGPU

/sys/devices/platform/<platform>/egpu_connected

在文件 sysfs-platform-asus-wmi 中定义。

显示 egpu (XG Mobile) 是否已正确连接

  • 0 - 假，

  • 1 - 真

/sys/devices/platform/<platform>/egpu_enable

在文件 sysfs-platform-asus-wmi 中定义。

启用与 ROG X-Flow 笔记本电脑配对的外部 GPU。切换此设置也会触发 ACPI 以禁用 dGPU

  • 0 - 禁用，

  • 1 - 启用

/sys/devices/platform/<platform>/etr3

在文件 sysfs-platform-intel-pmc 中定义。

该文件公开“扩展测试模式寄存器 3”全局复位位。这些位在英特尔平台制造过程中使用，以指示平台的后续复位为“全局复位”。为了使制造配置生效，需要这种类型的复位。

显示 PMC 的全局复位设置位。

  • 位 31 - 全局复位被锁定

  • 位 20 - 已设置全局复位

如果寄存器未被锁定，将位 20 值写入 etr3 将在后续平台复位时引发平台“全局复位”。“全局复位位”应在生产系统上锁定，并且该文件处于只读模式。

/sys/devices/platform/<platform>/fan_boost_mode

在文件 sysfs-platform-asus-wmi 中定义。

风扇增强模式

  • 0 - 正常，

  • 1 - 超频，

  • 2 - 静音

/sys/devices/platform/<platform>/force_power

在文件 sysfs-platform-intel-wmi-thunderbolt 中定义。

修改平台强制电源状态，影响 Thunderbolt 控制器在未连接设备时打开或关闭（只写）。有两个可用的状态

  • 0 -> 强制电源禁用

  • 1 -> 强制电源启用

/sys/devices/platform/<platform>/gpu_mux_mode

在文件 sysfs-platform-asus-wmi 中定义。

切换 GPU 硬件 MUX 模式。具有此功能的笔记本电脑可以切换为仅使用 dGPU（独立模式）或标准 Optimus/混合模式启动。切换时需要重新启动

  • 0 - 独立 GPU，

  • 1 - Optimus/混合，

/sys/devices/platform/<platform>/lid_resume

在文件 sysfs-platform-asus-wmi 中定义。

在打开盖子时恢复。1 表示开启，0 表示关闭。

/sys/devices/platform/<platform>/mcu_powersave

在文件 sysfs-platform-asus-wmi 中定义。

设置 MCU 是否可以在系统睡眠时进入低功耗模式

  • 0 - 假，

  • 1 - 真

/sys/devices/platform/<platform>/mini_led_mode

在文件 sysfs-platform-asus-wmi 中定义。

更改 mini-LED 模式

  • 0 - 单区，

  • 1 - 多区

  • 2 - 多区强（适用于较新一代 mini-led）

/sys/devices/platform/<platform>/nv_dynamic_boost

在文件 sysfs-platform-asus-wmi 中定义。

设置 Nvidia dGPU 的动态加速限制

  • 最小 = 5，最大 = 25

/sys/devices/platform/<platform>/nv_temp_target

在文件 sysfs-platform-asus-wmi 中定义。

设置 Nvidia dGPU 的目标温度限制

  • 最小 = 75，最大 = 87

/sys/devices/platform/<platform>/panel_od

在文件 sysfs-platform-asus-wmi 中定义。

启用 LCD 响应时间加速以减少或消除重影

  • 0 - 禁用，

  • 1 - 启用

/sys/devices/platform/<platform>/ppt_apu_sppt

在文件 sysfs-platform-asus-wmi 中定义。

设置 APU SPPT 限制。仅在完整的 AMD 系统上显示

  • 最小 = 5，最大 = 130

/sys/devices/platform/<platform>/ppt_fppt

在文件 sysfs-platform-asus-wmi 中定义。

设置 CPU 的快速封装功率跟踪限制。仅限 AMD+Nvidia

  • 最小 = 5，最大 = 250

/sys/devices/platform/<platform>/ppt_pl1_spl

在文件 sysfs-platform-asus-wmi 中定义。

设置 CPU 的封装功率目标总计：Intel 上的 PL1，AMD 上的 SPL。在基于 Intel+Nvidia 或 AMD+Nvidia 的系统上显示

  • 最小 = 5，最大 = 250

/sys/devices/platform/<platform>/ppt_pl2_sppt

在文件 sysfs-platform-asus-wmi 中定义。

设置 CPU 的慢速封装功率跟踪限制：Intel 上的 PL2，AMD 上的 SPPT。在基于 Intel+Nvidia 或 AMD+Nvidia 的系统上显示

  • 最小 = 5，最大 = 250

/sys/devices/platform/<platform>/ppt_platform_sppt

在文件 sysfs-platform-asus-wmi 中定义。

设置平台 SPPT 限制。仅在完整的 AMD 系统上显示

  • 最小 = 5，最大 = 130

/sys/devices/platform/<platform>/throttle_thermal_policy

在文件 sysfs-platform-asus-wmi 中定义。

节流热策略模式

  • 0 - 默认，

  • 1 - 超频，

  • 2 - 静音

/sys/devices/platform/<platform>/tokens/*

在文件 sysfs-platform-dell-smbios 中定义。

对机器上可用的戴尔平台令牌的只读描述。

每个令牌属性都可作为一对 sysfs 属性提供，该属性可由具有 CAP_SYS_ADMIN 的进程读取。

例如，令牌 ID“5”将作为以下属性提供

  • 0005_location

  • 0005_value

令牌将因机器而异，并且只会显示该机器上可用的令牌。

/sys/devices/platform/<platform>/touchpad

在文件 sysfs-platform-asus-wmi 中定义。

控制卡触摸板。1 表示开启，0 表示关闭。

/sys/devices/platform/<renesas_usb3's name>/role

在文件 sysfs-platform-renesas_usb3 中定义。

此文件可以读写。该文件可以显示/更改 USB 的 drd 模式。

写入以下字符串以更改模式

  • “host” - 将模式从外围设备切换到主机。

  • “peripheral” - 将模式从主机切换到外围设备。

读取该文件，然后它显示以下字符串

  • “host” - 现在是主机模式。

  • “peripheral” - 现在是外围设备模式。

/sys/devices/platform/HISI04Bx:00/available_inc_dec_lane_types

/sys/devices/platform/HISI04Bx:00/dec_lane_of_type

/sys/devices/platform/HISI04Bx:00/inc_lane_of_type

在文件 sysfs-devices-platform-kunpeng_hccs 中定义。

位于 /sys/devices/platform/HISI04Bx/ 下的这些接口用于支持某些 HCCS 类型的低功耗特性，通过改变使用的通道数来实现。更改通道数的接口是 'dec_lane_of_type' 和 'inc_lane_of_type'，它们需要 root 权限。如果平台上没有 HCCS 类型支持此特性，则这些接口不会暴露。请注意，只有当所有指定的 HCCS 端口都不忙时，才允许减少通道数。

低功耗接口如下：

available_inc_dec_lane_types

（只读）

可用于增加和减少通道数的可用 HCCS 类型（字符串），例如 HCCS-v2。

dec_lane_of_type

（只写）

输入支持减少通道数的 HCCS 类型，以将平台上所有指定 HCCS 类型端口的已用通道数减少到最小值。成功执行后，您可以查询 'cur_lane_num' 以获取最小通道数。

inc_lane_of_type

（只写）

输入支持增加通道数的 HCCS 类型，以将平台上所有指定 HCCS 类型端口的已用通道数增加到全通道状态。

/sys/devices/platform/HISI04Bx:00/chipX/all_linked

/sys/devices/platform/HISI04Bx:00/chipX/linked_full_lane

/sys/devices/platform/HISI04Bx:00/chipX/crc_err_cnt

在文件 sysfs-devices-platform-kunpeng_hccs 中定义。

/sys/devices/platform/HISI04Bx:00/chipX/ 目录包含只读属性，这些属性暴露了指定芯片下所有 HCCS 端口的一些汇总信息。'chipX' 中的 X 表示平台上第 X 个芯片。

此目录中包含以下属性：

all_linked

（只读）

如果此芯片上的所有已启用端口都已连接（布尔值）。

linked_full_lane

（只读）

如果此芯片上的所有已连接端口都处于全通道状态（布尔值）。

crc_err_cnt

（只读）

此芯片上所有端口的总 CRC 错误计数。

/sys/devices/platform/HISI04Bx:00/chipX/dieY/all_linked

/sys/devices/platform/HISI04Bx:00/chipX/dieY/linked_full_lane

/sys/devices/platform/HISI04Bx:00/chipX/dieY/crc_err_cnt

在文件 sysfs-devices-platform-kunpeng_hccs 中定义。

/sys/devices/platform/HISI04Bx:00/chipX/dieY/ 目录包含只读属性，这些属性暴露了指定晶粒下所有 HCCS 端口的一些汇总信息。'dieY' 中的 Y 表示芯片 ID 为 X 的晶粒的硬件 ID。

此目录中包含以下属性：

all_linked

（只读）

如果此晶粒上的所有已启用端口都已连接（布尔值）。

linked_full_lane

（只读）

如果此晶粒上的所有已连接端口都处于全通道状态（布尔值）。

crc_err_cnt

（只读）

此晶粒上所有端口的总 CRC 错误计数。

/sys/devices/platform/HISI04Bx:00/chipX/dieY/hccsN/type

/sys/devices/platform/HISI04Bx:00/chipX/dieY/hccsN/lane_mode

/sys/devices/platform/HISI04Bx:00/chipX/dieY/hccsN/enable

/sys/devices/platform/HISI04Bx:00/chipX/dieY/hccsN/cur_lane_num

/sys/devices/platform/HISI04Bx:00/chipX/dieY/hccsN/link_fsm

/sys/devices/platform/HISI04Bx:00/chipX/dieY/hccsN/lane_mask

/sys/devices/platform/HISI04Bx:00/chipX/dieY/hccsN/crc_err_cnt

在文件 sysfs-devices-platform-kunpeng_hccs 中定义。

/sys/devices/platform/HISI04Bx/chipX/dieX/hccsN/ 目录包含只读属性，这些属性暴露了有关 HCCS 端口的信息。'hccsN' 中的 N 值表示此端口 ID。'chipX' 中的 X 表示 HCCS 端口所属的芯片的 ID。 例如，如果平台上的芯片数为 n，则 X 的范围为 0 到 'n - 1'。'dieY' 中的 Y 表示 hccs 端口所属的晶粒的硬件 ID。 注意：type、lane_mode 和 enable 是运行平台上的固定属性。

HCCS 端口具有以下属性：

type

（只读）

端口类型（字符串），例如 HCCS-v1 -> H32

lane_mode

（只读）

此端口的通道模式（字符串），例如 x8

enable

（只读）

指示是否启用此端口（布尔值）。

cur_lane_num

（只读）

此端口的当前通道数。

link_fsm

（只读）

此端口的链路有限状态机。

lane_mask

（只读）

此端口的当前通道掩码，每一位表示一个通道。

crc_err_cnt

（只读）

此端口上的 CRC 错误计数。

/sys/devices/platform/HISI04Bx:00/used_types

在文件 sysfs-devices-platform-kunpeng_hccs 中定义。

此接口用于显示平台上使用的所有 HCCS 类型，例如 HCCS-v1、HCCS-v2 等。

/sys/devices/platform/_UDC_/gadget/gadget-lunX/nofua

定义在文件 sysfs-devices-platform-_UDC_-gadget 中

当 USB 大容量存储模式下的设备收到 SCSI WRITE(10,12) 命令时，显示或设置对 FUA (强制单元访问) 位的反应。

可能的值为

  • 1 -> 忽略 FUA 标志

  • 0 -> 服从 FUA 标志

/sys/devices/platform/_UDC_/gadget/suspended

定义在文件 sysfs-devices-platform-_UDC_-gadget 中

显示 USB 复合设备的挂起状态。

  • 1 -> 已挂起

  • 0 -> 已恢复

（_UDC_ 是 USB 设备控制器驱动程序的名称）

/sys/devices/platform/amba_pl/<dev>/dis_block_break

定义在文件 sysfs-driver-xilinx-tmr-manager 中

向其写入任何值，此控制文件将启用中断信号。此文件是只写的。示例：# echo <any value> > /sys/devices/platform/amba_pl/44a10000.tmr_manager/dis_block_break

/sys/devices/platform/amba_pl/<dev>/errcnt

定义在文件 sysfs-driver-xilinx-tmr-manager 中

此控制文件提供故障检测计数。此文件无法写入。示例：# cat /sys/devices/platform/amba_pl/44a10000.tmr_manager/errcnt 1

/sys/devices/platform/asus_laptop/bluetooth

定义在文件 sysfs-platform-asus-laptop 中

控制蓝牙设备。1 表示开启，0 表示关闭。这可能会控制 LED、设备或两者都控制。

用户：Lapsus

/sys/devices/platform/asus_laptop/display

定义在文件 sysfs-platform-asus-laptop 中

此文件允许显示切换。该值由 4 位组成，定义如下

4321
|||`- LCD
||`-- CRT
|`--- TV
`---- DVI
例如

  • 0 (0000b) 表示没有显示

  • 3 (0011b) CRT+LCD。

/sys/devices/platform/asus_laptop/gps

定义在文件 sysfs-platform-asus-laptop 中

控制 GPS 设备。1 表示开启，0 表示关闭。

用户：Lapsus

/sys/devices/platform/asus_laptop/ledd

定义在文件 sysfs-platform-asus-laptop 中

某些型号（如 W1N）具有 LED 显示屏，可用于显示多个信息项。要控制 LED 显示屏，请使用以下格式

echo 0x0T000DDD > /sys/devices/platform/asus_laptop/

其中 T 控制 3 个字母的显示，DDD 控制 3 个数字的显示。DDD 表格可以在 Asus 笔记本电脑附加功能 中找到

/sys/devices/platform/asus_laptop/wimax

定义在文件 sysfs-platform-asus-laptop 中

控制 WiMAX 设备。1 表示开启，0 表示关闭。

/sys/devices/platform/asus_laptop/wlan

定义在文件 sysfs-platform-asus-laptop 中

控制 WLAN 设备。1 表示开启，0 表示关闭。这可能会控制 LED、设备或两者都控制。

用户：Lapsus

/sys/devices/platform/asus_laptop/wwan

定义在文件 sysfs-platform-asus-laptop 中

控制 WWAN (3G) 设备。1 表示开启，0 表示关闭。

/sys/devices/platform/at91_can/net/<iface>/mb0_id

定义在文件 sysfs-platform-at91 中

表示邮箱 0 的 can_id 的值。

默认值：0x7ff（标准帧）

由于芯片错误（“AT91SAM9263 Preliminary 6249H-ATARM-27-Jul-09”中的勘误表 50.2.6.3 & 50.3.5.3），邮箱 0 的内容在某些情况下可能会发送（即使禁用或处于 rx 模式）。

勘误表中的解决方法建议不要使用该邮箱，并使用未使用的标识符加载它。

为了使用扩展 can_id，请将 CAN_EFF_FLAG (0x80000000U) 添加到 can_id。示例

  • 标准 ID 0x7ff

    echo 0x7ff      > /sys/class/net/can0/mb0_id

  • 扩展 ID 0x1fffffff

    echo 0x9fffffff > /sys/class/net/can0/mb0_id

/sys/devices/platform/dmi-ipmi-ssif.*/hosed

/sys/devices/platform/dmi-ipmi-ssif.*/alerts

/sys/devices/platform/dmi-ipmi-ssif.*/sent_messages

/sys/devices/platform/dmi-ipmi-ssif.*/sent_messages_parts

/sys/devices/platform/dmi-ipmi-ssif.*/received_messages

/sys/devices/platform/dmi-ipmi-ssif.*/received_message_parts

/sys/devices/platform/dmi-ipmi-ssif.*/events

/sys/devices/platform/dmi-ipmi-ssif.*/watchdog_pretimeouts

/sys/devices/platform/dmi-ipmi-ssif.*/flag_fetches

/sys/devices/platform/dmi-ipmi-ssif.*/send_retries

/sys/devices/platform/dmi-ipmi-ssif.*/receive_retries

/sys/devices/platform/dmi-ipmi-ssif.*/send_errors

/sys/devices/platform/dmi-ipmi-ssif.*/receive_errors

定义在文件 sysfs-devices-platform-ipmi 中

hosed

（只读）硬件没有遵循状态机的次数。

alerts

（只读）收到的警报次数。

sent_messages

（只读）发送的消息总数。

sent_message_parts

（只读）发送的消息部分数。如果消息很长，则可能会分成多个部分。

received_messages

（只读）收到的消息响应数。

received_message_parts

（只读）收到的消息片段数。

events

（只读）收到的事件数。

watchdog_pretimeouts

（只读）看门狗预超时的次数。

flag_fetches

（只读）请求标志获取的次数。

send_retries

（只读）消息重试的次数。

receive_retries

（只读）消息接收重试的次数。

send_errors

（只读）消息发送失败的次数。

receive_errors

（只读）接收消息时发生的错误数。

/sys/devices/platform/dmi-ipmi-ssif.*/type

定义在文件 sysfs-devices-platform-ipmi 中

（只读）显示 IMPI 设备接口类型，此处为“ssif”。

/sys/devices/platform/docg3/f[0-3]_dps[01]_is_keylocked

定义在文件 sysfs-devices-platform-docg3 中

显示楼层（0 到 4）、保护区域（0 或 1）是否已密钥锁定。每个 docg3 芯片（或楼层）都有 2 个保护区域，可以覆盖它的任何部分（块对齐），称为 DPS。该保护嵌入了它是否阻止读取、写入或两者都阻止的信息。结果是：

  • 0 -> DPS 未密钥锁定

  • 1 -> DPS 已密钥锁定

用户：目前尚未确定。

/sys/devices/platform/docg3/f[0-3]_dps[01]_protection_key

定义在文件 sysfs-devices-platform-docg3 中

输入楼层（0 到 4）、保护区域（0 或 1）的保护密钥。每个 docg3 芯片（或楼层）都有 2 个保护区域，可以覆盖它的任何部分（块对齐），称为 DPS。该保护嵌入了它是否阻止读取、写入或两者都阻止的信息。保护密钥是 8 个字节的字符串（值 0-255）。输入正确的值会切换锁定，可以通过 f[0-3]_dps[01]_is_keylocked 观察到。可能的值是

  • 8 个字节

典型值是

  • “00000000”

  • “12345678”

用户：目前尚未确定。

/sys/devices/platform/dock.<N>/docked

定义在文件 sysfs-devices-platform-dock 中

（只读）值 1 或 0 表示软件是否认为笔记本电脑已停靠在坞站中。

/sys/devices/platform/dock.<N>/flags

定义在文件 sysfs-devices-platform-dock 中

（只读）显示坞站标志，有助于检查用户是否已发出取消停靠请求（来自 immediate_undock 选项）。

/sys/devices/platform/dock.<N>/type

定义在文件 sysfs-devices-platform-dock 中

（只读）显示坞站类型 - dock_station、ata_bay 或 battery_bay。

/sys/devices/platform/dock.<N>/uid

定义在文件 sysfs-devices-platform-dock 中

（只读）显示笔记本电脑停靠的坞站。

/sys/devices/platform/dock.<N>/undock

定义在文件 sysfs-devices-platform-dock 中

(WO) 写入此文件会导致软件向固件发起解除停靠请求。

/sys/devices/platform/eeepc/available_cpufv

定义在文件 sysfs-platform-eeepc-laptop 中

列出可用的 cpufv 模式。

/sys/devices/platform/eeepc/camera

定义在文件 sysfs-platform-eeepc-laptop 中

控制摄像头。1 表示开启，0 表示关闭。

/sys/devices/platform/eeepc/cardr

定义在文件 sysfs-platform-eeepc-laptop 中

控制读卡器。1 表示开启，0 表示关闭。

/sys/devices/platform/eeepc/cpufv

定义在文件 sysfs-platform-eeepc-laptop 中

更改 CPU 时钟配置。在 Eee PC 1000H 上有三种可用的时钟配置

  • 0 -> 超高性能模式

  • 1 -> 高性能模式

  • 2 -> 节能模式

在 Eee PC 701 上只有 2 种可用的时钟配置。可用配置在 available_cpufv 文件中列出。读取此文件将显示原始十六进制值，其定义如下

| 8 bit | 8 bit |
    |       `---- Current mode
    `------------ Availables modes

例如，0x301 表示：选择了模式 1，有 3 种可用模式。

/sys/devices/platform/eeepc/disp

定义在文件 sysfs-platform-eeepc-laptop 中

此文件允许显示切换。

  • 1 = LCD

  • 2 = CRT

  • 3 = LCD+CRT

如果运行 X11，则应使用 xrandr 代替。

/sys/devices/platform/hidma-*/chid

定义在文件 sysfs-platform-hidma 中

包含 HIDMA 实例中通道的 ID。它用于将给定的 HIDMA 通道与管理接口中的优先级和权重调用相关联。

/sys/devices/platform/hidma-mgmt*/chanops/chan*/priority

定义在文件 sysfs-platform-hidma-mgmt 中

包含 0 或 1，指示 DMA 通道是低优先级 (0) 还是高优先级 (1) 通道。

/sys/devices/platform/hidma-mgmt*/chanops/chan*/weight

定义在文件 sysfs-platform-hidma-mgmt 中

包含 0..15，指示在轮询调度期间，通道在相同优先级通道中的权重。

/sys/devices/platform/hidma-mgmt*/chreset_timeout_cycles

定义在文件 sysfs-platform-hidma-mgmt 中

包含发出重置命令后等待的平台特定周期值。如果选择的值太短，则硬件将发出重置失败中断。该值是平台特定的，未经咨询不应更改。

/sys/devices/platform/hidma-mgmt*/dma_channels

定义在文件 sysfs-platform-hidma-mgmt 中

包含一个 HIDMA 硬件实例支持的 DMA 通道数。该值可能因芯片而异。

/sys/devices/platform/hidma-mgmt*/hw_version_major

定义在文件 sysfs-platform-hidma-mgmt 中

硬件的主要版本号。

/sys/devices/platform/hidma-mgmt*/hw_version_minor

定义在文件 sysfs-platform-hidma-mgmt 中

硬件的次要版本号。

/sys/devices/platform/hidma-mgmt*/max_rd_xactions

定义在文件 sysfs-platform-hidma-mgmt 中

包含 0 到 31 之间的值。可以背靠背发出的最大读取事务数。选择较高的数字可以提供更好的性能，但也可能导致共享同一总线的其他外围设备的性能降低。

/sys/devices/platform/hidma-mgmt*/max_read_request

定义在文件 sysfs-platform-hidma-mgmt 中

每个读取请求的大小。该值必须是 2 的幂，并且可以在 128 到 1024 之间。

/sys/devices/platform/hidma-mgmt*/max_wr_xactions

定义在文件 sysfs-platform-hidma-mgmt 中

包含 0 到 31 之间的值。可以背靠背发出的最大写入事务数。选择较高的数字可以提供更好的性能，但也可能导致共享同一总线的其他外围设备的性能降低。

/sys/devices/platform/hidma-mgmt*/max_write_request

定义在文件 sysfs-platform-hidma-mgmt 中

每个写入请求的大小。该值必须是 2 的幂，并且可以在 128 到 1024 之间。

/sys/devices/platform/i8042/.../draghys

定义在文件 sysfs-devices-platform-trackpoint 中

(RW) 拖动滞后控制使用 z 轴按压进行拖动的难度。

/sys/devices/platform/i8042/.../drift_time

定义在文件 sysfs-devices-platform-trackpoint 中

(RW) 此参数控制测试“松开”条件（即未施加力时）的时间段，之后进行漂移（噪声）校准。

IBM Trackpoint 具有通过定期重新校准自身来补偿漂移的功能。默认情况下，如果 0.5 秒内位置没有变化，则将其用作新的零点。此持续时间太短。通常，当实际上正在使用 Trackpoint 时会发生校准。

/sys/devices/platform/i8042/.../ext_dev

定义在文件 sysfs-devices-platform-trackpoint 中

(RW) 禁用 (0) 或启用 (1) 外部指点设备。

/sys/devices/platform/i8042/.../intertia

定义在文件 sysfs-devices-platform-trackpoint 中

(RW) 负惯性因子。较高的值会导致释放 Trackpoint 时光标向后跳动。

/sys/devices/platform/i8042/.../jenks

定义在文件 sysfs-devices-platform-trackpoint 中

(RW) 生成无需释放的双击所需的最小曲率（以度为单位）。

/sys/devices/platform/i8042/.../mindrag

定义在文件 sysfs-devices-platform-trackpoint 中

(RW) 触发拖动所需的最小力。

/sys/devices/platform/i8042/.../press_to_select

定义在文件 sysfs-devices-platform-trackpoint 中

(RW) 将值 1 写入此文件将启用“按压以选择”功能，例如点击控制杆来模拟鼠标左键单击，写入 0 将禁用它。

/sys/devices/platform/i8042/.../reach

定义在文件 sysfs-devices-platform-trackpoint 中

(RW) z 轴按压的备份范围。

/sys/devices/platform/i8042/.../sensitivity

定义在文件 sysfs-devices-platform-trackpoint 中

(RW) Trackpoint 灵敏度。

/sys/devices/platform/i8042/.../skipback

定义在文件 sysfs-devices-platform-trackpoint 中

(RW) 设置 skipback 位后，将抑制从拖动释放期间的备份光标移动。此位的默认值为 0。

/sys/devices/platform/i8042/.../speed

定义在文件 sysfs-devices-platform-trackpoint 中

(RW) Trackpoint 光标的速度。

/sys/devices/platform/i8042/.../thresh

定义在文件 sysfs-devices-platform-trackpoint 中

(RW) 相对于运行平均值，触发按压或释放所需的 z 轴力的最小值。

/sys/devices/platform/i8042/.../upthresh

定义在文件 sysfs-devices-platform-trackpoint 中

(RW) 从运行平均值偏移，需要在释放时在 z 轴上生成选择（单击）。

/sys/devices/platform/i8042/.../ztime

定义在文件 sysfs-devices-platform-trackpoint 中

(RW) 此属性确定为了被识别，按压必须有多么急促。

/sys/devices/platform/ipmi_bmc.*/additional_device_support

定义在文件 sysfs-devices-platform-ipmi 中

(RO) 列出控制器支持的除了强制性 IPM 和应用程序命令之外的 IPMI “逻辑设备” 命令和功能。

/sys/devices/platform/ipmi_bmc.*/aux_firmware_revision

定义在文件 sysfs-devices-platform-ipmi 中

(RO) 保存有关固件修订的其他信息，例如引导块或内部数据结构版本号。数字的含义特定于制造商 ID 标识的供应商。

/sys/devices/platform/ipmi_bmc.*/device_id

定义在文件 sysfs-devices-platform-ipmi 中

(RO) 设备 ID 由制造商 ID 字段标识的制造商指定。此字段允许控制器特定的软件识别控制器提供的唯一应用程序命令、OEM 字段和功能

/sys/devices/platform/ipmi_bmc.*/firmware_revision

定义在文件 sysfs-devices-platform-ipmi 中

(RO) 固件的主版本和次版本。

/sys/devices/platform/ipmi_bmc.*/guid

定义在文件 sysfs-devices-platform-ipmi 中

(RO) 管理控制器的 GUID（全局唯一 ID），也称为 UUID（通用唯一标识符），如 IPMI 规范 v2.0 的第 20.8 节“获取设备 GUID 命令”中所述。

/sys/devices/platform/ipmi_bmc.*/ipmi_version

定义在文件 sysfs-devices-platform-ipmi 中

(RO) 显示 IPMI 命令规范版本。

/sys/devices/platform/ipmi_bmc.*/manufacturer_id

定义在文件 sysfs-devices-platform-ipmi 中

(RO) 标识负责控制器中使用的供应商（OEM）特定命令、代码和接口的功能规范的制造商。

/sys/devices/platform/ipmi_bmc.*/product_id

定义在文件 sysfs-devices-platform-ipmi 中

(RO) 显示一个数字，用于标识特定的系统、模块、附加卡或板集。该数字根据制造商 ID 给出的制造商指定。

有关以上属性的详细定义，请参阅 IPMI 规范 v2.0 的第 20.1 节“获取设备 ID 命令”。

/sys/devices/platform/ipmi_bmc.*/provides_device_sdrs

定义在文件 sysfs-devices-platform-ipmi 中

(RO) 指示设备是否提供设备传感器数据记录 (1) 或不提供 (0)。

/sys/devices/platform/ipmi_bmc.*/revision

定义在文件 sysfs-devices-platform-ipmi 中

(RO) 设备修订版。用于识别是否对管理控制器的实现进行了重大硬件更改。

/sys/devices/platform/ipmi_si.*/idles

/sys/devices/platform/ipmi_si.*/watchdog_pretimeouts

/sys/devices/platform/ipmi_si.*/complete_transactions

/sys/devices/platform/ipmi_si.*/events

/sys/devices/platform/ipmi_si.*/interrupts

/sys/devices/platform/ipmi_si.*/hosed_count

/sys/devices/platform/ipmi_si.*/long_timeouts

/sys/devices/platform/ipmi_si.*/flag_fetches

/sys/devices/platform/ipmi_si.*/attentions

/sys/devices/platform/ipmi_si.*/incoming_messages

/sys/devices/platform/ipmi_si.*/short_timeouts

定义在文件 sysfs-devices-platform-ipmi 中

idles

(RO) 轮询时接口空闲的次数。

watchdog_pretimeouts

（只读）看门狗预超时的次数。

complete_transactions

(RO) 已完成的消息数。

events

(RO) 从硬件接收的 IPMI 事件数。

interrupts

(RO) 驱动程序处理的中断数。

hosed_count

（只读）硬件没有遵循状态机的次数。

long_timeouts

(RO) 驱动程序在没有任何进展时请求计时器的次数。

flag_fetches

(RO) 驱动程序从硬件请求标志的次数。

attentions

(RO) 驱动程序从硬件获得 ATTN 的次数。

incoming_messages

(RO) 接收的异步消息数。

short_timeouts

(RO) 驱动程序在操作正在进行时请求计时器的次数。

/sys/devices/platform/ipmi_si.*/interrupts_enabled

定义在文件 sysfs-devices-platform-ipmi 中

(RO) 指示是否启用了中断。当驱动程序由于内存不足而无法处理消息时，它会禁用中断。一旦这种情况清除，它将重新启用中断。

/sys/devices/platform/ipmi_si.*/params

定义在文件 sysfs-devices-platform-ipmi 中

[待记录文档]

/sys/devices/platform/ipmi_si.*/type

定义在文件 sysfs-devices-platform-ipmi 中

(RO) IPMI 的设备接口“kcs”、“smic”、“bt”或“invalid”

/sys/devices/platform/kim/baud_rate

定义在文件 sysfs-platform-kim 中

主机可以支持的最大可靠波特率。不同的平台往往具有不同的高速 UART 配置，因此波特率需要在本地设置，并通过 HCI-VS 命令发送到 WL128x。当请求 ldisc 安装时，用户空间守护程序读取并使用该条目。

/sys/devices/platform/kim/dev_name

定义在文件 sysfs-platform-kim 中

连接 WL128x 芯片的 UART 设备的名称。例如：“/dev/ttyS0”。

设备名称从 ATAGS 引导加载程序固件向下流到特定于体系结构的板初始化文件。公开的名称从用户空间守护程序读取，并在请求安装时打开该设备。

/sys/devices/platform/kim/flow_cntrl

定义在文件 sysfs-platform-kim 中

WL128x 使用流量控制机制，此条目最常见的值应为 1，主机的 UART 需要具有流量控制功能，否则可以利用此条目进行例外处理。

/sys/devices/platform/kim/install

定义在文件 sysfs-platform-kim 中

当蓝牙、FM 或 GPS 协议之一想要使用共享 UART 传输时，它会注册到共享传输驱动程序，该驱动程序将通过此 sysfs 条目向用户空间发出信号以打开、配置波特率并安装线路规程。用户空间守护程序将轮询此条目，管理 UART，并通过 sysfs_notify 通知更改。当需要打开/安装 ldisc 时，该值为“1”，当不再需要 UART 并需要关闭时，该值为“0”。

/sys/devices/platform/lg-laptop/battery_care_limit

定义在文件 sysfs-platform-lg-laptop 中

已弃用，请使用 /sys/class/power_supply/CMB0/charge_control_end_threshold。最大电池充电水平。可接受的值为 80 或 100。

/sys/devices/platform/lg-laptop/fan_mode

定义在文件 sysfs-platform-lg-laptop 中

控制风扇模式。1 表示性能模式，0 表示静音模式。

/sys/devices/platform/lg-laptop/fn_lock

定义在文件 sysfs-platform-lg-laptop 中

控制 FN 锁定模式。1 表示开启，0 表示关闭。

/sys/devices/platform/lg-laptop/reader_mode

定义在文件 sysfs-platform-lg-laptop 中

控制阅读器模式。1 表示开启，0 表示关闭。

/sys/devices/platform/lg-laptop/usb_charge

定义在文件 sysfs-platform-lg-laptop 中

控制设备关闭时 USB 端口充电。1 表示开启，0 表示关闭。

/sys/devices/platform/msi-laptop-pf/auto_brightness

定义在文件 sysfs-platform-msi-laptop 中

启用自动亮度控制：包含 0 或 1。如果设置为 1，则当插入/拔下电源线时，硬件会自动调整屏幕亮度。

/sys/devices/platform/msi-laptop-pf/auto_fan

定义在文件 sysfs-platform-msi-laptop 中

包含 0 或 1，指示风扇速度是自动控制 (1) 还是以最大速度运行 (0)。可以在软件中切换。

/sys/devices/platform/msi-laptop-pf/bluetooth

定义在文件 sysfs-platform-msi-laptop 中

蓝牙子系统已启用：包含 0 或 1。请注意，如果没有可用的蓝牙硬件，则此文件始终为 0。

/sys/devices/platform/msi-laptop-pf/eco_mode

定义在文件 sysfs-platform-msi-laptop 中

包含 0 或 1，指示是否启用了 ECO 模式。在 ECO 模式下，电源 LED 为绿色，用户空间应执行一些省电操作。ECO 模式仅在电池供电时可用。ECO 模式只能通过按 Fn+F10 切换。

/sys/devices/platform/msi-laptop-pf/lcd_level

定义在文件 sysfs-platform-msi-laptop 中

屏幕亮度：包含 0..8 范围内的单个整数。

/sys/devices/platform/msi-laptop-pf/touchpad

定义在文件 sysfs-platform-msi-laptop 中

包含 0 或 1，指示触摸板是否已启用。触摸板状态只能通过按 Fn+F3 切换。

/sys/devices/platform/msi-laptop-pf/turbo_cooldown

定义在文件 sysfs-platform-msi-laptop 中

包含 0..3 范围内的值

  • 0 -> Turbo 模式已关闭

  • 1 -> Turbo 模式已开启，但尚未关闭

  • 2 -> Turbo 模式已关闭，但尚未开启

  • 3 -> Turbo 模式已开启

/sys/devices/platform/msi-laptop-pf/turbo_mode

定义在文件 sysfs-platform-msi-laptop 中

包含 0 或 1，指示是否启用了 Turbo 模式。在 Turbo 模式下，电源 LED 为橙色，并且处理器已超频。Turbo 模式仅在充电时可用。只能通过按 Fn+F10 切换 Turbo 模式状态，并且在后续切换之间有几秒钟的冷却时间。如果用户按 Fn+F10 的频率过高，则 Turbo 模式状态不会更改。

/sys/devices/platform/msi-laptop-pf/wlan

定义在文件 sysfs-platform-msi-laptop 中

WLAN 子系统已启用：包含 0 或 1。

/sys/devices/platform/samsung/battery_life_extender

在文件 sysfs-driver-samsung-laptop 中定义

可以修改最大电池充电水平，可以通过降低最大电池充电水平来延长电池循环寿命。

  • 0 表示正常电池模式（100% 充电）

  • 1 表示电池寿命延长模式（80% 充电）

/sys/devices/platform/samsung/lid_handling

在文件 sysfs-driver-samsung-laptop 中定义

某些三星笔记本电脑会更快地处理盖子的关闭，并且只有在启用此模式时才会处理盖子的打开。1 表示已启用，0 表示已禁用。

/sys/devices/platform/samsung/performance_level

在文件 sysfs-driver-samsung-laptop 中定义

某些三星笔记本电脑具有不同的“性能级别”，可以通过功能键和此 sysfs 文件进行修改。这些值并不总是很有意义，但一些用户喜欢修改它们以不惜一切代价保持风扇安静。从此文件中读取将显示当前的性能级别。写入文件可以更改此值。

有效选项

  • “silent”（静音）

  • “normal”（正常）

  • “overclock”（超频）

请注意，并非所有笔记本电脑都支持所有这些选项。特别是，并非所有笔记本电脑都支持“超频”选项，而且仍然未知此值是否会改变任何内容，除了让用户感觉更好一点。

/sys/devices/platform/samsung/usb_charge

在文件 sysfs-driver-samsung-laptop 中定义

即使在笔记本电脑关闭时也可以使用 USB 端口为设备充电。1 表示已启用，0 表示已禁用。

/sys/devices/platform/sh_mobile_lcdc_fb.[0-3]/graphics/fb[0-9]/ovl_alpha

在文件 sysfs-devices-platform-sh_mobile_lcdc_fb 中定义

此文件仅在对应于叠加平面的 fb[0-9] 设备上可用。

存储叠加的 Alpha 混合值。值的范围从 0（透明）到 255（不透明）。如果模式未设置为 Alpha 混合，则忽略该值。

/sys/devices/platform/sh_mobile_lcdc_fb.[0-3]/graphics/fb[0-9]/ovl_mode

在文件 sysfs-devices-platform-sh_mobile_lcdc_fb 中定义

此文件仅在对应于叠加平面的 fb[0-9] 设备上可用。

选择叠加的合成模式。可能的值为

  • 0 - Alpha 混合

  • 1 - ROP3

/sys/devices/platform/sh_mobile_lcdc_fb.[0-3]/graphics/fb[0-9]/ovl_position

在文件 sysfs-devices-platform-sh_mobile_lcdc_fb 中定义

此文件仅在对应于叠加平面的 fb[0-9] 设备上可用。

以像素为单位存储显示器上的 x,y 叠加位置。位置格式为 [0-9]+,[0-9]+。

/sys/devices/platform/sh_mobile_lcdc_fb.[0-3]/graphics/fb[0-9]/ovl_rop3

在文件 sysfs-devices-platform-sh_mobile_lcdc_fb 中定义

此文件仅在对应于叠加平面的 fb[0-9] 设备上可用。

存储叠加的光栅操作 (ROP3)。值的范围从 0 到 255。如果模式未设置为 ROP3，则忽略该值。

/sys/devices/platform/silicom-platform/efuse_status

在文件 sysfs-platform-silicom 中定义

此文件为只读文件。它返回当前的 OTP 状态

0 - 未编程。1 - 已编程。

/sys/devices/platform/silicom-platform/power_cycle

在文件 sysfs-platform-silicom 中定义

此文件允许用户对平台进行电源循环。默认值为 0；设置为 1 时，它会关闭平台电源，等待 5 秒钟，然后打开设备电源。电源循环后，它会返回默认值。

0 - 默认值。

/sys/devices/platform/silicom-platform/uc_version

在文件 sysfs-platform-silicom 中定义

此文件允许读取当前平台的微控制器固件版本。

/sys/devices/platform/soc@X/XXXXXXX.ipa/

定义在文件 sysfs-devices-platform-soc-ipa 中

/sys/devices/platform/soc@X/XXXXXXX.ipa/ 目录包含只读属性，这些属性公开有关 IPA 设备的信息。X 值可能会有所不同，但通常为“soc@0/1e40000.ipa”。

/sys/devices/platform/stratix10-rsu.0/current_image

在文件 sysfs-devices-platform-stratix10-rsu 中定义

(RO) 当前运行的映像在闪存中的地址。

/sys/devices/platform/stratix10-rsu.0/dcmf0

在文件 sysfs-devices-platform-stratix10-rsu 中定义

(RO) 决策固件副本 0 版本信息。

/sys/devices/platform/stratix10-rsu.0/dcmf1

在文件 sysfs-devices-platform-stratix10-rsu 中定义

(RO) 决策固件副本 1 版本信息。

/sys/devices/platform/stratix10-rsu.0/dcmf2

在文件 sysfs-devices-platform-stratix10-rsu 中定义

(RO) 决策固件副本 2 版本信息。

/sys/devices/platform/stratix10-rsu.0/dcmf3

在文件 sysfs-devices-platform-stratix10-rsu 中定义

(RO) 决策固件副本 3 版本信息。

/sys/devices/platform/stratix10-rsu.0/error_details

在文件 sysfs-devices-platform-stratix10-rsu 中定义

(RO) 错误代码。

/sys/devices/platform/stratix10-rsu.0/error_location

在文件 sysfs-devices-platform-stratix10-rsu 中定义

(RO) 失败的映像内的错误偏移量。

/sys/devices/platform/stratix10-rsu.0/fail_image

在文件 sysfs-devices-platform-stratix10-rsu 中定义

(RO) 失败的映像在闪存中的地址。

/sys/devices/platform/stratix10-rsu.0/max_retry

在文件 sysfs-devices-platform-stratix10-rsu 中定义

(RO) 最大重试参数存储在固件决策 IO 部分中，作为位于偏移量 0x18c 的字节。

/sys/devices/platform/stratix10-rsu.0/notify

在文件 sysfs-devices-platform-stratix10-rsu 中定义

(WO) 客户端通知固件不同的操作。

b[15:0]

通知固件当前软件执行阶段。

0

第一阶段引导加载程序未运行或未达到启动第二阶段引导加载程序的点。

1

在第二引导加载程序中失败或未达到启动操作系统的点。

2

第一阶段和第二阶段引导加载程序都已运行，并尝试启动操作系统。
b[16]

1

固件重置当前映像重试计数器。

0

无操作。
b[17]

1

固件清除 RSU 日志

0

无操作。
b[18]

这是负逻辑

1

无操作

0

固件记录 b[15:0] 中定义的通知代码。

/sys/devices/platform/stratix10-rsu.0/reboot_image

在文件 sysfs-devices-platform-stratix10-rsu 中定义

(WO) 下次重新启动命令时要加载的映像在闪存中的地址。

/sys/devices/platform/stratix10-rsu.0/retry_counter

在文件 sysfs-devices-platform-stratix10-rsu 中定义

(RO) 当前映像的重试计数器，用户使用该计数器来了解映像在放弃并启动 RSU 故障转移流程之前允许重新加载自身的次数。

/sys/devices/platform/stratix10-rsu.0/state

在文件 sysfs-devices-platform-stratix10-rsu 中定义

(RO) RSU 系统的状态。状态字段有两个部分：高 16 位中的主要错误代码和低 16 位中的次要错误代码。

b[15:0]

当前仅在主要错误为 0xF006（CPU 看门狗超时）时使用，在这种情况下，次要错误代码是 CPU 在看门狗超时发生之前通过 RSU 通知命令报告给固件的值。

b[31:16]

0xF001 比特流错误 0xF002 硬件访问失败 0xF003 比特流损坏 0xF004 内部错误 0xF005 设备错误 0xF006 CPU 看门狗超时 0xF007 内部未知错误

/sys/devices/platform/stratix10-rsu.0/version

在文件 sysfs-devices-platform-stratix10-rsu 中定义

(RO) RSU 固件的版本号。19.3 或更高版本包含有关报告错误的固件的信息。

19.3 之前的版本
b[31:0]

0x0 版本号

19.3 或更高版本
b[15:0]

0x1 版本号

b[31:16]

0x0 无错误 0x0DCF 决策 CMF 错误 0x0ACF 应用程序 CMF 错误

/sys/devices/platform/ts5500/adc

在文件 sysfs-platform-ts5500 中定义

指示是否存在 A/D 转换器。如果存在，它将显示“1”，否则显示“0”。

/sys/devices/platform/ts5500/ereset

在文件 sysfs-platform-ts5500 中定义

指示是否存在外部复位。如果存在，它将显示“1”，否则显示“0”。

/sys/devices/platform/ts5500/id

在文件 sysfs-platform-ts5500 中定义

TS 板的产品 ID。TS-5500 ID 为 0x60。

/sys/devices/platform/ts5500/jumpers

在文件 sysfs-platform-ts5500 中定义

显示跳线状态的位字段。如果存在跳线，则设置相应的位。例如，0x0e 表示设置了跳线 2、3 和 4。

/sys/devices/platform/ts5500/name

在文件 sysfs-platform-ts5500 中定义

TS 板的型号名称，例如“TS-5500”。

/sys/devices/platform/ts5500/rs485

在文件 sysfs-platform-ts5500 中定义

指示是否存在 RS485 选项。如果存在，它将显示“1”，否则显示“0”。

/sys/devices/platform/ts5500/sram

在文件 sysfs-platform-ts5500 中定义

指示是否存在 SRAM 选项。如果存在，它将显示“1”，否则显示“0”。

/sys/devices/platform/usbip-vudc.%d/dev_desc

在文件 sysfs-platform-usbip-vudc 中定义

此文件允许读取当前绑定到此控制器的 Gadget 驱动程序的设备描述符。只有在绑定了 Gadget 驱动程序的情况下才能读取此文件，否则将返回错误。

/sys/devices/platform/usbip-vudc.%d/usbip_sockfd

在文件 sysfs-platform-usbip-vudc 中定义

此文件允许将 USB 设备导出到连接对等方。这是通过将与连接到希望使用此设备的远程对等方的连接关联的套接字 fd（例如，字符串“8”）写入此文件来完成的。可以通过写入 -1 而不是套接字 fd 来关闭连接。

/sys/devices/platform/usbip-vudc.%d/usbip_status

在文件 sysfs-platform-usbip-vudc 中定义

设备的当前状态。允许的值

1

设备可用，可以导出

2

设备当前已导出

3

与对等方通信期间发生致命错误

/sys/devices/socX

在文件 sysfs-devices-soc 中定义

/sys/devices/ 目录包含运行平台上每个片上系统 (SoC) 设备的子目录。可以通过读取 sysfs 文件来获取有关每个 SoC 的信息。只有当平台实现此功能时，此功能才可用。

为每个 SoC 创建的目录还将包含有关通常包含在 /sys/devices/platform 中的设备的信息。已达成一致，如果存在 SoC 设备，则其支持的设备更适合显示为该 SoC 的子设备。

/sys/devices/socX/family

在文件 sysfs-devices-soc 中定义

所有 SoC 通用的只读属性。包含 SoC 系列名称（例如，DB8500）。

在许多具有符合 SMCCC v1.2+ 的固件的 ARM 芯片上，这将包含 JEDEC JEP106 制造商的标识代码。格式为“jep106:XXYY”，其中 XX 是标识代码，YY 是延续代码。

此制造商的识别码由一个或多个八 (8) 位字段定义，每个字段由七 (7) 个数据位加上一个 (1) 奇偶校验位组成。它是一个单字段，将可能的供应商数量限制为 126 个。为了扩展识别码的最大数量，定义了一种延续方案。

指定的机制是，身份代码 0x7F 代表“延续代码”，并表示存在额外的身份代码字段，并且这种机制可以扩展到多个延续代码，后跟制造商的身份代码。

例如，ARM 的身份代码为 0x7F 0x7F 0x7F 0x7F 0x3B，它是第五个“页面”上的代码 0x3B。简而言之，即 JEP106 身份代码为 0x3B，延续代码为 0x4，表示身份代码之前的四个延续代码。

/sys/devices/socX/machine

在文件 sysfs-devices-soc 中定义

所有 SoC 共有的只读属性。包含 SoC 的机器名称（例如 Ux500）。

/sys/devices/socX/process

在文件 sysfs-devices-soc 中定义

ST-Ericsson 芯片支持的只读属性。包含制造硅芯片所采用的工艺。

/sys/devices/socX/revision

在文件 sysfs-devices-soc 中定义

大多数 SoC 支持的只读属性。包含 SoC 的制造版本号。

/sys/devices/socX/serial_number

在文件 sysfs-devices-soc 中定义

大多数 SoC 支持的只读属性。包含 SoC 的序列号（如果可用）。

/sys/devices/socX/soc_id

在文件 sysfs-devices-soc 中定义

大多数 SoC 支持的只读属性。在 ST-Ericsson 芯片的情况下，它包含 SoC 序列号。

在许多基于 ARM 且符合 SMCCC v1.2+ 固件的芯片上，这将包含附加到系列属性的 SOC ID，以确保在不同供应商的此命名空间中没有冲突。格式为“jep106:XXYY:ZZZZ”，其中 XX 是身份代码，YY 是延续代码，ZZZZ 是 SOC ID。

/sys/devices/system/cpu/

在文件 sysfs-devices-system-cpu 中定义

全局和单个 CPU 属性的集合

单个 CPU 属性包含在以内核逻辑 CPU 编号命名的子目录中，例如：

/sys/devices/system/cpu/cpuX/

/sys/devices/system/cpu/aarch32_el0

在文件 sysfs-devices-system-cpu 中定义

标识系统中可以执行 AArch32（32 位 ARM）应用程序的 CPU 子集。如果存在，则使用与 /sys/devices/system/cpu/{offline,online,possible,present} 相同的格式。如果不存在，则所有或没有 CPU 可以执行 AArch32 应用程序，并且 execve() 将相应地运行。

/sys/devices/system/cpu/cpu*/cache/index*/<set_of_attributes_mentioned_below>

在文件 sysfs-devices-system-cpu 中定义

CPU 缓存属性的参数

allocation_policy
  • WriteAllocate

    由于写入而发生缓存未命中时，将内存位置分配给缓存行

  • ReadAllocate

    由于读取而发生缓存未命中时，将内存位置分配给缓存行

  • ReadWriteAllocate

    同时进行 writeallocate 和 readallocate

coherency_line_size

从内存传输到缓存的最小数据量（以字节为单位）

level

多级缓存配置中的缓存层次结构

number_of_sets

缓存中的总集合数，一个集合是具有相同缓存索引的缓存行的集合

physical_line_partition

每个缓存标签的物理缓存行数

shared_cpu_list

共享缓存的逻辑 CPU 列表

shared_cpu_map

包含共享缓存的 CPU 列表的逻辑 CPU 掩码

size

以 KB 为单位的总缓存大小

type

  • Instruction：仅保存指令的缓存

  • Data：仅缓存数据的缓存

  • Unified：同时保存数据和指令的缓存

ways_of_associativity

将特定内存块放置在缓存中的自由度

write_policy
  • WriteThrough

    数据写入到缓存行以及较低级别内存中的块

  • WriteBack

    数据仅写入到缓存行，并且只有在修改后的缓存行被替换时才写入到主内存

/sys/devices/system/cpu/cpu*/cache/index*/id

在文件 sysfs-devices-system-cpu 中定义

缓存 ID

ID 为特定类型的缓存的特定实例提供唯一编号。例如，服务器上的每个插槽上可能都有一个 3 级统一缓存，我们可以为其分配 ID 0、1、2 等。

请注意，ID 值可以不连续。例如，1 级缓存通常每个核心存在一个，但是插槽上的核心数量可能不是 2 的幂，因此这些缓存的编号可能是 0、1、2、3、4、5、8、9、10 等。

/sys/devices/system/cpu/cpu*/cache/index3/cache_disable_{0,1}

在文件 sysfs-devices-system-cpu 中定义

禁用 L3 缓存索引

这些文件存在于每个 CPU 的 cache/index3 目录中。每个 cache_disable_{0,1} 文件对应于一个禁用槽，该槽可用于禁用缓存索引。从此功能处理器上的这些文件中读取将返回该节点当前禁用的索引。每个节点或 MCM 机器上的每个内部节点都有一个 L3 结构。将有效索引写入这些文件之一将导致指定的缓存索引被禁用。

所有具有 L3 缓存的 AMD 处理器都提供此功能。有关详细信息，请参阅 https://www.amd.com/en/support/tech-docs?keyword=bios+kernel 上的 BKDGs。

/sys/devices/system/cpu/cpuX/cpu_capacity

在文件 sysfs-devices-system-cpu 中定义

有关 CPU 异构性的信息。

cpu_capacity：cpuX 的容量。

/sys/devices/system/cpu/cpuX/cpufreq/*

在文件 sysfs-devices-system-cpu 中定义

发现和更改 CPU 的时钟速度

时钟缩放允许您动态更改 CPU 的时钟速度。这是一种很好的节省电池电量的方法，因为时钟速度越低，CPU 消耗的电量就越少。

此目录中有许多旋钮可以调整。

有关更多信息，请参阅 Documentation/cpu-freq/ 中的文件。

/sys/devices/system/cpu/cpuX/cpufreq/freqdomain_cpus

在文件 sysfs-devices-system-cpu 中定义

发现同一 CPU 频率协调域中的 CPU

freqdomain_cpus 是共享同一时钟/频率域（可能在硬件级别）的 CPU（在线 + 离线）列表。该信息可能对 cpufreq 核心隐藏，并且 related_cpus 的值可能与 freqdomain_cpus 不同。对于使用 acpi-cpufreq 的平台，此属性对于用户空间 DVFS 控制器获得更好的功耗/性能结果很有用。

仅当使用 acpi-cpufreq 或 cppc-cpufreq 驱动程序时，此文件才存在。

/sys/devices/system/cpu/cpuX/cpufreq/throttle_stats

在文件 sysfs-devices-system-cpu 中定义

POWERNV CPUFreq 驱动程序的频率限制统计目录和属性

“cpuX/cpufreq/throttle_stats”目录包含芯片的 CPU 频率限制统计属性。CPU 的限制统计信息在属于芯片的所有 CPU 中是通用的。以下是在“throttle_stats”目录中导出的限制属性

  • turbo_stat：此文件给出最大频率在频率的 turbo（在标称频率及以上）范围内被限制为较低频率的总次数。

  • sub_turbo_stat：此文件给出最大频率在频率的 sub-turbo（低于标称频率）范围内被限制为较低频率的总次数。

  • unthrottle：此文件给出最大频率在被限制后取消限制的总次数。

  • powercap：此文件给出由于“功率上限”而限制最大频率的总次数。

  • overtemp：此文件给出由于“CPU 过热”而限制最大频率的总次数。

  • supply_fault：此文件给出由于“电源故障”而限制最大频率的总次数。

  • overcurrent：此文件给出由于“过流”而限制最大频率的总次数。

  • occ_reset：此文件给出由于“OCC 重置”而限制最大频率的总次数。

表示不同限制原因（如 powercap、overtemp、supply_fault、overcurrent 和 occ_reset）的 sysfs 属性映射到 OCC 固件为限制频率提供的原因。

/sys/devices/system/cpu/cpuX/cpuidle/state<N>/default_status

在文件 sysfs-devices-system-cpu 中定义

（只读）此状态的默认状态，“enabled”或“disabled”。

/sys/devices/system/cpu/cpuX/cpuidle/state<N>/desc

在文件 sysfs-devices-system-cpu 中定义

（只读）有关空闲状态的小描述（字符串）。

/sys/devices/system/cpu/cpuX/cpuidle/state<N>/disable

在文件 sysfs-devices-system-cpu 中定义

（读写）禁用此空闲状态的选项（布尔值）。禁用变量的行为和效果取决于特定调速器的实现。例如，在 ladder 调速器中，它不是连贯的，即，如果禁用轻状态，则所有更深的状态也会被禁用，但禁用变量不反映这一点。同样，如果启用深状态但仍然禁用较轻的状态，则这不起作用。

/sys/devices/system/cpu/cpuX/cpuidle/state<N>/name

在文件 sysfs-devices-system-cpu 中定义

目录 /sys/devices/system/cpu/cpuX/cpuidle 包含每个在线 CPU X 的每个逻辑 CPU 特定的 cpuidle 信息。可供使用的处理器空闲状态具有以下属性

name

（只读）

空闲状态的名称（字符串）。

latency

（只读）

退出此空闲状态的延迟（以微秒为单位）。

power

（只读）

处于此空闲状态时消耗的功率（以毫瓦为单位）。

time

（只读）

在此空闲状态下花费的总时间（以微秒为单位）。

usage

（只读）

进入此状态的次数（计数）。

above

（只读）

进入此状态的次数，但观察到的 CPU 空闲持续时间对于它来说太短了（计数）。

below

（只读）

进入此状态的次数，但观察到的 CPU 空闲持续时间对于它来说太长了（计数）。

/sys/devices/system/cpu/cpuX/cpuidle/state<N>/residency

在文件 sysfs-devices-system-cpu 中定义

（只读）显示目标驻留时间，即此 CPU 应在此空闲状态下花费的最短时间（以微秒为单位），以使转换值得付出努力。

/sys/devices/system/cpu/cpuX/cpuidle/state<N>/s2idle/

在文件 sysfs-devices-system-cpu 中定义

与暂停到空闲相关的空闲状态使用情况统计信息。

此属性组仅存在于可以使用具有暂停时间保持的暂停到空闲状态的状态。

/sys/devices/system/cpu/cpuX/cpuidle/state<N>/s2idle/time

在文件 sysfs-devices-system-cpu 中定义

CPU 在请求此状态后，在暂停到空闲状态（暂停调度程序计时）下花费的总时间。

/sys/devices/system/cpu/cpuX/cpuidle/state<N>/s2idle/usage

在文件 sysfs-devices-system-cpu 中定义

CPU 在进入暂停到空闲状态时请求此状态的总次数。

/sys/devices/system/cpu/cpuX/crash_notes

在文件 sysfs-devices-system-cpu 中定义

每个 CPU 注释的地址和大小。

crash_notes：保存 cpuX 注释的内存的物理地址。

crash_notes_size：cpuX 注释的大小。

/sys/devices/system/cpu/cpuX/idle_purr

在文件 sysfs-devices-system-cpu 中定义

cpuX 空闲时的 PURR 节拍。

此 sysfs 接口公开 cpuX 空闲时的 PURR 节拍数。

/sys/devices/system/cpu/cpuX/idle_spurr

在文件 sysfs-devices-system-cpu 中定义

cpuX 空闲时的 SPURR 节拍。

此 sysfs 接口公开 cpuX 空闲时的 SPURR 节拍数。

/sys/devices/system/cpu/cpuX/mte_tcf_preferred

在文件 sysfs-devices-system-cpu 中定义

首选的 MTE 标签检查模式

当用户程序指定多个 MTE 标签检查模式时，此 sysfs 节点用于指定在 CPU 上调度任务时应首选的模式。可能的值

“sync”

首选同步模式

“asymm”

首选非对称模式

“async”

首选异步模式

另请参阅：AArch64 Linux 中的内存标记扩展 (MTE)

/sys/devices/system/cpu/cpuX/node

在文件 sysfs-devices-system-cpu 中定义

发现 CPU 所属的 NUMA 节点

当启用 CONFIG_NUMA 时，指向相应 NUMA 节点目录的符号链接。

例如，在 NUMA 节点 2 中为 cpu42 创建以下符号链接

/sys/devices/system/cpu/cpu42/node2 -> ../../node/node2

/sys/devices/system/cpu/cpuX/power/energy_perf_bias

在文件 sysfs-devices-system-cpu 中定义

Intel 能量和性能偏好提示 (EPB)

给定 CPU 的 EPB，取值范围为 0 - 15 的滑动刻度，其中值 0 表示最高性能的提示偏好，而值 15 表示最大节能。

为了更改 CPU 的 EPB 值，请将上述 0 - 15 滑动刻度中的数字，或者以下字符串之一：“performance”、“balance-performance”、“normal”、“balance-power”、“power”（表示与其含义相对应的值）写入此属性。

此属性适用于所有支持 Intel EPB 功能的在线 CPU。

/sys/devices/system/cpu/cpuX/purr

在文件 sysfs-devices-system-cpu 中定义

自系统启动以来，此 CPU 的 PURR 时钟周期数。

处理器利用率资源寄存器 (PURR) 是一个 64 位计数器，它提供 CPU 线程使用的资源估计值。此寄存器的内容单调递增。此 sysfs 接口公开 cpuX 的 PURR 时钟周期数。

/sys/devices/system/cpu/cpuX/regs/

在文件 sysfs-devices-system-cpu 中定义

AArch64 CPU 寄存器

“identification”目录公开用于标识 CPU 和 SMCU 的型号和修订版本的 CPU ID 寄存器。

/sys/devices/system/cpu/cpuX/spurr

在文件 sysfs-devices-system-cpu 中定义

自系统启动以来，此 CPU 的 SPURR 时钟周期数。

缩放处理器利用率资源寄存器 (SPURR) 是一个 64 位计数器，它提供 CPU 线程使用的资源频率不变估计值。此寄存器的内容单调递增。此 sysfs 接口公开 cpuX 的 SPURR 时钟周期数。

/sys/devices/system/cpu/cpuX/topology/core_siblings

在文件 sysfs-devices-system-cpu 中定义

描述逻辑 CPU 与同一物理封装中的其他内核和线程关系的 CPU 拓扑文件。

系统中每个逻辑 CPU 创建一个 cpuX 目录，例如 /sys/devices/system/cpu/cpu42/。

简而言之，以上文件是

core_siblings：cpuX 在同一 physical_package_id 内的硬件线程的内部内核映射。

core_siblings_list：与 cpuX 位于同一 physical_package_id 中的逻辑 CPU 编号的可读列表。

physical_package_id：cpuX 的物理封装 ID。通常对应于物理插槽编号，但实际值取决于架构和平台。

thread_siblings：cpuX 与 cpuX 位于同一内核内的硬件线程的内部内核映射

thread_siblings_list：与 cpuX 位于同一内核内的 cpuX 硬件线程的可读列表

ppin：cpu# 所属插槽的可读保护处理器标识号。每个 physical_package_id 应该有一个。该文件只有管理员可以读取。

有关详细信息，请参阅 如何通过 sysfs 导出 CPU 拓扑信息。

/sys/devices/system/cpu/cpufreq/boost

在文件 sysfs-devices-system-cpu 中定义

处理器频率提升控制

此开关控制整个系统的提升设置。提升允许 CPU 和固件以超出其标称限制的频率运行。

更多详细信息可以在 CPU 性能缩放 中找到

/sys/devices/system/cpu/cpufreq/policyX/throttle_stats

在文件 sysfs-devices-system-cpu 中定义

POWERNV CPUFreq 驱动程序的频率限制统计目录和属性

“policyX/throttle_stats”目录和所有属性与/sys/devices/system/cpu/cpuX/cpufreq/throttle_stats目录和属性相同，它们提供芯片的频率节流信息。

/sys/devices/system/cpu/cpuidle/available_governors

在文件 sysfs-devices-system-cpu 中定义

发现 cpuidle 策略和机制

如今，各种 CPU 支持多个空闲级别，这些空闲级别通过不同的退出延迟和空闲期间的功耗来区分。

空闲策略（调速器）与空闲机制（驱动程序）不同。

available_governors：（只读）显示可用调速器的空格分隔列表。

current_driver：（只读）显示当前空闲机制。

current_governor：（读写）显示当前空闲策略。用户可以在运行时通过写入此文件来切换调速器。

current_governor_ro：（只读）显示当前空闲策略。

有关详细信息，请参阅CPU 空闲时间管理 和 CPU 空闲时间管理。

/sys/devices/system/cpu/crash_hotplug

在文件 sysfs-devices-system-cpu 中定义

（只读）指示内核是否在内存热插拔和/或在线/离线事件中更新相关的 kexec 段，从而避免重新加载 kdump 内核。

/sys/devices/system/cpu/enabled

在文件 sysfs-devices-system-cpu 中定义

（只读）可以联机的 CPU 列表。

/sys/devices/system/cpu/intel_pstate/max_perf_pct

在文件 sysfs-devices-system-cpu 中定义

Intel P-state 驱动程序的参数

用于在 Intel Sandybridge+ 处理器中选择当前 P-state 的逻辑。这三个旋钮控制驱动程序将请求的 P-state 的限制。

max_perf_pct：限制驱动程序将请求的最大 P 状态，表示为可用性能的百分比。

min_perf_pct：限制驱动程序将请求的最小 P 状态，表示为可用性能的百分比。

no_turbo：限制驱动程序选择低于睿频频率范围的 P 状态。

更多详细信息可以在 intel_pstate CPU 性能缩放驱动程序 中找到

/sys/devices/system/cpu/isolated

在文件 sysfs-devices-system-cpu 中定义

（只读）已隔离且不参与负载平衡的 CPU 列表。这些 CPU 由启动参数“isolcpus=”设置。

/sys/devices/system/cpu/kernel_max

在文件 sysfs-devices-system-cpu 中定义

描述与热插拔相关的内核限制的 CPU 拓扑文件。简而言之

kernel_max：内核配置允许的最大 CPU 索引。

offline：由于已热插拔关闭或超过内核配置允许的 CPU 限制（上面的 kernel_max），因此未联机的 CPU。

online：已联机并正在调度的 CPU。

possible：已分配资源且如果存在可以联机的 CPU。

present：已被识别为存在于系统中的 CPU。

有关详细信息，请参阅 如何通过 sysfs 导出 CPU 拓扑信息。

/sys/devices/system/cpu/nohz_full

在文件 sysfs-devices-system-cpu 中定义

（只读）处于 nohz_full 模式的 CPU 列表。这些 CPU 由启动参数“nohz_full=”设置。

/sys/devices/system/cpu/probe

在文件 sysfs-devices-system-cpu 中定义

动态添加和删除 CPU。这不是热插拔删除，而是指从系统中完全删除/添加 CPU。

probe：写入此文件的操作将动态地向系统添加 CPU。写入该文件以添加 CPU 的信息特定于架构。

release：写入此文件的操作将从系统中动态删除 CPU。写入该文件以删除 CPU 的信息特定于架构。

/sys/devices/system/cpu/sev

在文件 sysfs-devices-system-cpu 中定义

安全加密虚拟化 (SEV) 信息

此目录仅在作为 SEV-SNP 访客运行时存在。

vmpl：报告运行 SEV-SNP 访客的虚拟机特权级别 (VMPL)。

SEV-SNP 访客正在运行。

/sys/devices/system/cpu/smt

在文件 sysfs-devices-system-cpu 中定义

控制对称多线程 (SMT)

active：指示 SMT 是否处于活动状态（已启用且同级在线）

control：用于控制 SMT 的读/写接口。可能的值

值

“on”

已启用 SMT

“off”

已禁用 SMT

“<N>”

启用 SMT，每个内核有 N 个线程。

“forceoff”

强制禁用 SMT。无法更改。

“notsupported”

CPU 不支持 SMT

“notimplemented”

该架构未实现 SMT 运行时切换

如果控制状态为“forceoff”或“notsupported”，则会拒绝写入。请注意，在 PowerPC 上启用 SMT 会跳过离线内核。

/sys/devices/system/cpu/svm

在文件 sysfs-devices-system-cpu 中定义

安全虚拟机

如果为 1，则表示系统正在使用 POWER9 及更新处理器中的受保护执行工具。即，它是一个安全虚拟机。

/sys/devices/system/cpu/umwait_control

在文件 sysfs-devices-system-cpu 中定义

Umwait 控制

enable_c02：用于控制 umwait C0.2 状态的读/写接口
读取返回 C0.2 状态

0：已禁用 C0.2 1：已启用 C0.2

写入“y”或“1”或“on”以启用 C0.2 状态。写入“n”或“0”或“off”以禁用 C0.2 状态。

该接口不区分大小写。

max_time：用于控制 umwait 最大时间的读/写接口

以 CPU 可以驻留在 C0.1 或 C0.2 状态的 TSC 量子表示。该时间是一个无符号 32 位数字。请注意，零值表示没有限制。低位两个位必须为零。

/sys/devices/system/cpu/vulnerabilities

在文件 sysfs-devices-system-cpu 中定义

有关 CPU 漏洞的信息

这些文件以 CPU 漏洞的代号命名。这些文件的输出反映系统中 CPU 的状态。可能的输出值

“不受影响”

CPU 不受该漏洞的影响

“易受攻击”

CPU 受影响，且没有任何缓解措施生效

“缓解措施：$M”

CPU 受影响，且缓解措施 $M 生效

另请参阅：硬件漏洞

/sys/devices/system/edac/mc/mc*/(dimm|rank)*/dimm_ce_count

在文件 sysfs-devices-edac 上定义

此属性文件显示此 DIMM 上发生的总可纠正错误计数。此计数非常重要，需要检查。CE 提供 DIMM 开始出现故障的早期迹象。应监视此计数字段的非零值，并将此类信息报告给系统管理员。

/sys/devices/system/edac/mc/mc*/(dimm|rank)*/dimm_dev_type

在文件 sysfs-devices-edac 上定义

此属性文件将显示此 DIMM 上正在使用的 DRAM 设备类型（x1、x2、x4、x8 等）。

/sys/devices/system/edac/mc/mc*/(dimm|rank)*/dimm_edac_mode

在文件 sysfs-devices-edac 上定义

此属性文件将显示正在使用的错误检测和纠正类型。例如：S4ECD4ED 表示使用 x4 DRAM 的 Chipkill。

/sys/devices/system/edac/mc/mc*/(dimm|rank)*/dimm_label

在文件 sysfs-devices-edac 上定义

此控制文件允许为此 DIMM 分配标签。将此标签添加到模块后，当发生错误时，输出可以在系统日志中提供 DIMM 标签。这对于隔离 UE 事件的原因至关重要。DIMM 标签必须在启动后分配，并使用正确识别物理插槽及其丝印标签的信息。此信息目前非常依赖于主板，并且必须在此刻在用户空间中确定此信息。

/sys/devices/system/edac/mc/mc*/(dimm|rank)*/dimm_location

在文件 sysfs-devices-edac 上定义

此属性文件将显示 dimm 或 rank 的位置（csrow/通道，分支/通道/插槽或通道/插槽）。

/sys/devices/system/edac/mc/mc*/(dimm|rank)*/dimm_mem_type

在文件 sysfs-devices-edac 上定义

此属性文件将显示此 csrow 上当前的内存类型。通常为缓冲或非缓冲内存（例如，Unbuffered-DDR3）。

/sys/devices/system/edac/mc/mc*/(dimm|rank)*/dimm_ue_count

在文件 sysfs-devices-edac 上定义

此属性文件显示在此 DIMM 上发生的不可纠正错误的总数。如果设置了 panic_on_ue，则此计数器将没有机会递增，因为 EDAC 将使系统崩溃。

/sys/devices/system/edac/mc/mc*/(dimm|rank)*/size

在文件 sysfs-devices-edac 上定义

此属性文件将显示 dimm 或 rank 的大小。对于 dimm*/size，这是 DIMM 内存条的大小，以 MB 为单位。对于 rank*/size，这是 DIMM 内存条的一个 rank 的大小，以 MB 为单位。在单 rank 内存（1R）上，这也是 dimm 的总大小。在双 rank（2R）内存上，这是 DIMM 总内存大小的一半。

/sys/devices/system/edac/mc/mc*/ce_count

在文件 sysfs-devices-edac 上定义

此属性文件显示在此内存控制器上发生的纠正错误的总数。此计数非常重要，需要检查。CE 提供 DIMM 开始出现故障的早期迹象。应监视此计数字段，以查找非零值，并将此类信息报告给系统管理员。

/sys/devices/system/edac/mc/mc*/ce_noinfo_count

在文件 sysfs-devices-edac 上定义

此属性文件显示在此内存控制器上发生的 CE 数量，但没有关于哪个 DIMM 插槽出现错误的信息。内存已损坏，但仍在运行，但没有信息指示哪个插槽中的内存出现故障。还应监视此计数字段，以查找非零值。

/sys/devices/system/edac/mc/mc*/max_location

在文件 sysfs-devices-edac 上定义

此属性文件显示有关此内存控制器中最后一个可用内存插槽的信息。用户空间工具使用它来显示内存填充布局。

/sys/devices/system/edac/mc/mc*/mc_name

在文件 sysfs-devices-edac 上定义

此属性文件显示正在使用的内存控制器的类型。

/sys/devices/system/edac/mc/mc*/reset_counters

在文件 sysfs-devices-edac 上定义

此只写控制文件将清除给定内存控制器上 UE 和 CE 错误的所有统计计数器。清除计数器还将重置指示自上次重置计数器以来经过的时间的计时器。这对于计算错误/时间非常有用。由于计数器总是在驱动程序初始化时重置，因此没有模块/内核参数可用。

/sys/devices/system/edac/mc/mc*/sdram_scrub_rate

在文件 sysfs-devices-edac 上定义

读/写属性文件，用于控制内存擦洗。内存控制器使用的擦洗速率通过将最小带宽（以字节/秒为单位）写入属性文件来设置。该速率将转换为至少给出指定速率的内部值。读取文件将返回实际使用的擦洗速率。如果配置失败或未实现内存擦洗，则属性文件的值为 -1。

/sys/devices/system/edac/mc/mc*/seconds_since_reset

在文件 sysfs-devices-edac 上定义

此属性文件显示自上次计数器重置以来经过的秒数。这可以与错误计数器一起使用来衡量错误率。

/sys/devices/system/edac/mc/mc*/size_mb

在文件 sysfs-devices-edac 上定义

此属性文件以兆字节为单位显示此内存控制器管理的内存量。

/sys/devices/system/edac/mc/mc*/ue_count

在文件 sysfs-devices-edac 上定义

此属性文件显示在此内存控制器上发生的不可纠正错误的总数。如果设置了 panic_on_ue，则此计数器将没有机会递增，因为 EDAC 将使系统崩溃。

/sys/devices/system/edac/mc/mc*/ue_noinfo_count

在文件 sysfs-devices-edac 上定义

此属性文件显示在此内存控制器上发生的 UE 数量，但没有关于哪个 DIMM 插槽出现错误的信息。

/sys/devices/system/ibm_rtl/state

定义在文件 sysfs-devices-system-ibm-rtl 中

状态文件提供了一种进入和退出高级实时模式 (PRTM) 的方法，以及查询当前状态的能力。

  • 0 => PRTM 关闭

  • 1 => PRTM 已启用

用户：ibm-prtm 用户空间守护程序使用此接口。

/sys/devices/system/ibm_rtl/version

定义在文件 sysfs-devices-system-ibm-rtl 中

版本文件提供了一种查询位于扩展 BIOS 数据区 (EBDA) 中的 RTL 表版本的方法。

用户：ibm-prtm 用户空间守护程序使用此接口。

/sys/devices/system/machinecheck/machinecheckX/

定义在文件 sysfs-mce 中

(X = CPU 编号)

机器检查报告 CPU 检测到的内部硬件错误状况。未纠正的错误通常会导致机器检查（通常带有 panic），纠正的错误会导致机器检查日志条目。

有关 x86 机器检查架构的更多详细信息，请参阅 Intel 和 AMD 开发者网站上的架构手册。

有关架构的更多详细信息，请参阅 http://one.firstfloor.org/~andi/mce.pdf

每个 CPU 都有自己的目录。

/sys/devices/system/machinecheck/machinecheckX/bank<Y>

定义在文件 sysfs-mce 中

(Y 库编号)

64 位十六进制位掩码，用于启用/禁用库 Y 的特定子事件。

当位掩码中的某个位为零时，将不会报告相应的子事件。

默认情况下，所有事件都已启用。

请注意，BIOS 维护另一个掩码来禁用每个库的特定事件。这里看不到这个掩码

/sys/devices/system/machinecheck/machinecheckX/check_interval

定义在文件 sysfs-mce 中

这些条目显示在每个 CPU 中，但它们实际上在所有 CPU 之间共享。

以秒为单位轮询纠正的机器检查错误的频率（请注意，输出为十六进制）。默认值为 5 分钟。当轮询器找到 MCE 时，它会在轮询间隔上触发指数加速（更频繁地轮询）。当轮询器停止查找 MCE 时，它会在轮询间隔上触发指数退避（减少轮询频率）。check_interval 变量既是初始轮询间隔，也是最大轮询间隔。0 表示不轮询纠正的机器检查错误（但某些纠正的错误可能仍以其他方式报告）

/sys/devices/system/machinecheck/machinecheckX/cmci_disabled

定义在文件 sysfs-mce 中

禁用 CMCI 功能。

/sys/devices/system/machinecheck/machinecheckX/dont_log_ce

定义在文件 sysfs-mce 中

禁用纠正错误的日志记录。所有报告的纠正错误都将以静默方式清除。

如果您永远不关心纠正的错误，则此选项将很有用。

/sys/devices/system/machinecheck/machinecheckX/ignore_ce

定义在文件 sysfs-mce 中

禁用轮询和 CMCI 以纠正错误。所有纠正的事件都不会清除，而是保留在库 MSR 中。

/sys/devices/system/machinecheck/machinecheckX/monarch_timeout

定义在文件 sysfs-mce 中

在异常情况下，等待其他 CPU 进行机器检查的时间。0 表示禁用等待其他 CPU。

单位：us

/sys/devices/system/machinecheck/machinecheckX/trigger

定义在文件 sysfs-mce 中

这些条目显示在每个 CPU 中，但它们实际上在所有 CPU 之间共享。

检测到机器检查事件时要运行的程序。这是定期从 cron 运行 mcelog 的替代方法，并且可以更快地检测事件。

/sys/devices/system/memory

定义在文件 sysfs-devices-memory 中

/sys/devices/system/memory 包含内核内存块的内部状态快照。可以动态添加或删除文件以表示热添加/删除操作。

用户：热插拔内存添加/删除工具 http://www.ibm.com/developerworks/wikis/display/LinuxP/powerpc-utils

/sys/devices/system/memory/crash_hotplug

定义在文件 sysfs-devices-memory 中

（只读）指示内核是否在内存热插拔和/或在线/离线事件中更新相关的 kexec 段，从而避免重新加载 kdump 内核。

/sys/devices/system/memory/hard_offline_page

定义在文件 sysfs-memory-page-offline 中

使包含写入此文件的物理地址的内存页硬脱机。输入是一个十六进制数字，指定该页的物理地址。然后，内核将尝试使该页硬脱机，方法是尝试删除该页或杀死任何所有者，或在需要时触发 IO 错误。请注意，这可能会杀死拥有该页面的任何进程。内核将避免访问此页面，假设它已被硬件损坏。

脱机操作以内核特定的粒度完成。通常是内核的基本页面大小，但这可能会改变。

返回值是数字的大小，或脱机失败时的错误。不允许读取文件。

/sys/devices/system/memory/memoryX/phys_device

定义在文件 sysfs-devices-memory 中

文件 /sys/devices/system/memory/memoryX/phys_device 是只读的；它是一个仅在 s390x 上使用以公开覆盖存储增量的旧接口。

用户：旧的 s390-tools lsmem/chmem

/sys/devices/system/memory/memoryX/phys_index

定义在文件 sysfs-devices-memory 中

文件 /sys/devices/system/memory/memoryX/phys_index 是只读的，并且包含十六进制的节 ID，该 ID 等效于内存节目录名称中包含的十进制 X。

/sys/devices/system/memory/memoryX/removable

定义在文件 sysfs-devices-memory 中

文件 /sys/devices/system/memory/memoryX/removable 是一个旧接口，用于指示内存块是否有可能脱机。如果内核支持内存脱机，则较新版本的内核会返回“1”。

用户：热插拔内存删除工具 http://www.ibm.com/developerworks/wikis/display/LinuxP/powerpc-utils lsmem/chmem（util-linux 的一部分）

/sys/devices/system/memory/memoryX/state

定义在文件 sysfs-devices-memory 中

文件 /sys/devices/system/memory/memoryX/state 是读写的。读取时，它返回内存块的联机/脱机状态。写入时，root 可以使用以下命令切换内存块的联机/脱机状态

# echo online > /sys/devices/system/memory/memoryX/state
# echo offline > /sys/devices/system/memory/memoryX/state

在较新版本的内核中，可以在联机时指定高级状态以选择目标区域：“online_movable”选择可移动区域。“online_kernel”选择适用的内核区域（DMA、DMA32 或 Normal）。但是，在成功设置其中一个高级状态后，读取该文件将返回“online”；可以通过“valid_zones”获取区域信息。

虽然联机不太可能失败，但无法保证脱机一定会成功。如果“valid_zones”指示“Movable”，则脱机更有可能成功。

用户：热插拔内存删除工具 http://www.ibm.com/developerworks/wikis/display/LinuxP/powerpc-utils

/sys/devices/system/memory/memoryX/valid_zones

定义在文件 sysfs-devices-memory 中

文件 /sys/devices/system/memory/memoryX/valid_zones 是只读的。

对于在线内存块，它返回内存块提供的内存由哪个区域管理。如果适用多个区域（不适用于热插拔内存），则返回“None”，并且无法离线该内存块。

对于离线内存块，它返回当联机时，内存块提供的内存可以通过哪个区域管理。当将离线内存块的状态设置为“在线”时，将使用第一个返回的区域（“默认”）。对于单个内存块，只能应用内核区域（DMA、DMA32、Normal）中的一个。

/sys/devices/system/memory/soft_offline_page

定义在文件 sysfs-memory-page-offline 中

软下线包含写入此文件的物理地址的内存页。输入是一个十六进制数字，指定页面的物理地址。然后内核将尝试软下线它，方法是将内容移动到其他位置，或者如果可能则将其丢弃。然后，内核将被放置在坏页列表中，并且永远不会被重用。

脱机操作以内核特定的粒度完成。通常是内核的基本页面大小，但这可能会改变。

页面必须仍然可访问，而不是被污染的。内核永远不会为此杀死任何东西，而是会使离线失败。返回值是数字的大小，或者当离线失败时会返回错误。不允许读取该文件。

/sys/devices/system/memoryX/nodeY

定义在文件 sysfs-devices-memory 中

当启用 CONFIG_NUMA 时，指向相应 NUMA 节点目录的符号链接。

例如，为节点 0 上的内存段 9 创建以下符号链接

/sys/devices/system/memory/memory9/node0 -> ../../node/node0

/sys/devices/system/node/nodeX/memoryY

定义在文件 sysfs-devices-memory 中

当启用 CONFIG_NUMA 时，/sys/devices/system/node/nodeX/memoryY 是一个符号链接，指向相应的 /sys/devices/system/memory/memoryY 内存段目录。例如，为节点 0 上的内存段 9 创建以下符号链接。

/sys/devices/system/node/node0/memory9 -> ../../memory/memory9

/sys/devices/system/xen_cpu/

定义在文件 sysfs-devices-system-xen_cpu 中

全局/单个 Xen 物理 CPU 属性的集合

单个物理 CPU 属性包含在以 Xen 逻辑 CPU 编号命名的子目录中，例如：/sys/devices/system/xen_cpu/xen_cpu#/

/sys/devices/system/xen_cpu/xen_cpu#/online

定义在文件 sysfs-devices-system-xen_cpu 中

用于联机/脱机 Xen 物理 CPU 的接口

在 Xen 平台下运行时，它提供了用于联机/脱机物理 CPU 的用户界面，但由于一些逻辑限制和假设，cpu0 除外。

/sys/devices/uncore_iio_x/dieX

定义在文件 sysfs-devices-mapping 中

每个 IIO 堆栈（PCIe 根端口）都有自己的 IIO PMON 块，因此每个 dieX 文件（其中 X 是 die 编号）都保存 PCIe 根端口的 “Segment:Root Bus”，该端口可以由该 IIO PMON 块监控。例如，在具有每个 die 最多 6 个 IIO 堆栈的 4-die Xeon 平台上，因此每个 die 有 6 个 IIO PMON 块，IIO PMON 块 0 的映射如下所示

$ ls /sys/devices/uncore_iio_0/die*
-r--r--r-- /sys/devices/uncore_iio_0/die0
-r--r--r-- /sys/devices/uncore_iio_0/die1
-r--r--r-- /sys/devices/uncore_iio_0/die2
-r--r--r-- /sys/devices/uncore_iio_0/die3

$ tail /sys/devices/uncore_iio_0/die*
==> /sys/devices/uncore_iio_0/die0 <==
0000:00
==> /sys/devices/uncore_iio_0/die1 <==
0000:40
==> /sys/devices/uncore_iio_0/die2 <==
0000:80
==> /sys/devices/uncore_iio_0/die3 <==
0000:c0

这意味着

IIO PMU 0 on die 0 belongs to PCI RP on bus 0x00, domain 0x0000
IIO PMU 0 on die 1 belongs to PCI RP on bus 0x40, domain 0x0000
IIO PMU 0 on die 2 belongs to PCI RP on bus 0x80, domain 0x0000
IIO PMU 0 on die 3 belongs to PCI RP on bus 0xc0, domain 0x0000

/sys/devices/uncore_upi_x/dieX

定义在文件 sysfs-devices-mapping 中

每个 /sys/devices/uncore_upi_X/dieY 文件都保存 “upi_Z,die_W” 值，这意味着 die Y 上的 UPI 链路编号 X 连接到 die W 上的 UPI 链路 Z，并且套接字之间的此链路可以由 UPI PMON 块监控。例如，4-die Sapphire Rapids 平台具有以下 UPI 0 拓扑

# tail /sys/devices/uncore_upi_0/die*
==> /sys/devices/uncore_upi_0/die0 <==
upi_1,die_1
==> /sys/devices/uncore_upi_0/die1 <==
upi_0,die_3
==> /sys/devices/uncore_upi_0/die2 <==
upi_1,die_3
==> /sys/devices/uncore_upi_0/die3 <==
upi_0,die_1

这意味着

UPI link 0 on die 0 is connected to UPI link 1 on die 1
UPI link 0 on die 1 is connected to UPI link 0 on die 3
UPI link 0 on die 2 is connected to UPI link 1 on die 3
UPI link 0 on die 3 is connected to UPI link 0 on die 1

/sys/devices/virtual/memory_tiering/

定义在文件 sysfs-kernel-mm-memory-tiers 中

分配的所有内存层的集合。

单个内存层详细信息包含在以内存层的抽象距离命名的子目录中。

/sys/devices/virtual/memory_tiering/memory_tierN/

/sys/devices/virtual/memory_tiering/memory_tierN/

定义在文件 sysfs-kernel-mm-memory-tiers 中

包含特定内存层详细信息的目录

这是包含有关特定内存层的信息的目录，memtierN，其中 N 是根据抽象距离得出的。

N 的值越小，表示层次结构中更高（更快）的内存层。

nodelist：属于此内存层的 NUMA 节点。

/sys/devices/virtual/misc/intel_ifs_<N>/current_batch

定义在文件 sysfs-platform-intel-ifs 中

写入小于或等于 0xff 的数字以加载 IFS 测试映像。写入的数字被视为以下文件名中的 2 位后缀：/lib/firmware/intel/ifs_<N>/ff-mm-ss-02x.scan 读取文件将提供当前加载的 IFS 测试映像的后缀。此文件仅适用于测试映像适用的设备实例。设备：intel_ifs_0

/sys/devices/virtual/misc/intel_ifs_<N>/details

定义在文件 sysfs-platform-intel-ifs 中

有关上次测试的其他信息。details 文件报告此测试的 STATUS MSR 的十六进制值。请注意，error_code 字段可能包含驱动程序定义的软件代码，该代码未在 Intel SDM 中定义。设备：全部

/sys/devices/virtual/misc/intel_ifs_<N>/image_version

定义在文件 sysfs-platform-intel-ifs 中

已加载的 IFS 测试映像的版本（十六进制）。如果没有加载测试映像，则报告 “none”。仅适用于测试映像适用的设备实例。设备：intel_ifs_0

/sys/devices/virtual/misc/intel_ifs_<N>/run_test

定义在文件 sysfs-platform-intel-ifs 中

写入 <cpu#> 以触发一个在线核心的 IFS 测试。请注意，测试是按核心进行的。cpu# 可以是核心上的任何线程。在一个线程上运行将完成包含该线程的核心的测试。例如：要测试包含 cpu5 的核心：echo 5 > /sys/devices/virtual/misc/intel_ifs_<N>/run_test 设备：全部

/sys/devices/virtual/misc/intel_ifs_<N>/status

定义在文件 sysfs-platform-intel-ifs 中

上次测试的状态。它可以是 “pass”、“fail” 或 “untested” 之一。设备：全部

/sys/firmware 下的符号

/sys/firmware/acpi/bgrt/

定义在文件 sysfs-firmware-acpi 中

BGRT 是 ACPI 5.0 的一项功能，允许操作系统获取固件启动画面及其一些相关元数据的副本。这旨在供启动画面应用程序使用，以便与固件启动画面进行交互，以避免出现不和谐的过渡。

image：图像位图。目前是 32 位 BMP。status：如果图像有效，则为 1；如果固件使其无效，则为 0。type：0 表示图像为 BMP 格式。

version

BGRT 的版本。目前为 1。

xoffset

屏幕左侧与图像左边缘之间的像素数。

yoffset

屏幕顶部与图像顶部边缘之间的像素数。

/sys/firmware/acpi/fpdt/

定义在文件 sysfs-firmware-acpi 中

ACPI 固件性能数据表 (FPDT) 提供系统启动、S3 挂起和 S3 恢复的固件性能数据信息。此 sysfs 条目包含从 FPDT 检索的性能数据。

boot
firmware_start_ns：在固件映像执行开始时记录的计时器值。以纳秒为单位。

固件映像执行的开始。以纳秒为单位。

bootloader_load_ns：在将操作系统启动加载程序加载到内存之前记录的计时器值。以纳秒为单位。

加载操作系统启动加载程序到内存之前记录的计时器值。以纳秒为单位。

bootloader_launch_ns：在启动当前加载的操作系统启动加载程序映像之前记录的计时器值。以纳秒为单位。

启动当前加载的操作系统启动加载程序映像之前记录的计时器值。以纳秒为单位。

exitbootservice_start_ns：当操作系统加载程序为 UEFI 兼容固件调用 ExitBootServices 函数时记录的计时器值。以纳秒为单位。

操作系统加载程序为 UEFI 兼容固件调用 ExitBootServices 函数时记录的计时器值。以纳秒为单位。

exitbootservice_end_ns：在操作系统加载程序从 UEFI 兼容固件的 ExitBootServices 函数获得控制权之前记录的计时器值。以纳秒为单位。

在操作系统加载程序从 UEFI 兼容固件的 ExitBootServices 函数获得控制权之前记录的计时器值。以纳秒为单位。

suspend
suspend_start_ns：先前操作系统写入 SLP_TYP 时在进入 S3 时记录的计时器值。以纳秒为单位。

先前操作系统写入 SLP_TYP 时在进入 S3 时记录的计时器值。以纳秒为单位。

suspend_end_ns：先前固件写入用于触发硬件进入 S3 的 SLP_TYP 时记录的计时器值。以纳秒为单位。

先前固件写入用于触发硬件进入 S3 的 SLP_TYP 时记录的计时器值。以纳秒为单位。

resume
resume_count：自上次完整启动序列以来 S3 恢复周期的计数。

自上次完整启动序列以来 S3 恢复周期的计数。

resume_avg_ns：自上次完整启动序列以来记录的所有恢复周期的平均计时器值，包括最近的恢复。以纳秒为单位。

自上次完整启动序列以来记录的所有恢复周期的平均计时器值，包括最近的恢复。以纳秒为单位。

resume_prev_ns：在上一个平台运行时固件 S3 恢复结束时记录的计时器，就在切换到操作系统唤醒向量之前。以纳秒为单位。

在上一个平台运行时固件 S3 恢复结束时记录的计时器，就在切换到操作系统唤醒向量之前。以纳秒为单位。

/sys/firmware/acpi/hotplug/

定义在文件 sysfs-firmware-acpi 中

ACPI 支持的不同类别的设备（例如容器、内存模块、处理器、PCI 根桥等）都有单独的热插拔配置文件。给定类别的设备的热插拔配置文件是定义 ACPI 核心热插拔代码处理该类设备的方式的一组设置。这些配置文件在 sysfs 中表示为 /sys/firmware/acpi/hotplug/ 的子目录。

以下设置可供用户空间使用，用于每个热插拔配置文件

enabled

如果设置，ACPI 核心将处理与给定类别的设备关联的热插拔事件的通知，并允许在 _EJ0 控制方法的帮助下弹出这些设备。取消设置它将有效地禁用相应类别的设备的热插拔。

上述属性的值是一个整数：1（设置）或 0（取消设置）。尝试向其写入任何其他值将导致返回 -EINVAL。

/sys/firmware/acpi/interrupts/

定义在文件 sysfs-firmware-acpi 中

所有 ACPI 中断都通过单个 IRQ（系统控制中断 (SCI)）来处理，该中断在 /proc/interrupts 中显示为 “acpi”。

但是，ACPI 的主要功能之一是使平台无需特殊驱动程序支持即可理解随机硬件。因此，尽管 SCI 处理一些众所周知的（固定功能）中断源（例如电源按钮），但它也可以处理可变数量的 “通用事件 (GPE)”。

GPE 会向量到 AML 中的指定处理程序，该处理程序可以从操作系统上下文中执行 BIOS 编写者想要的任何操作。例如，GPE 0x12 会向量到名为 _L12 或 _E12 的电平或边缘处理程序。处理程序可以执行其操作并返回。或者，处理程序可以向在 ACPI 设备（例如电池或处理器）上注册的 Linux 设备驱动程序发送通知事件。

要找出所有 SCI 的来源，/sys/firmware/acpi/interrupts 包含一个列出每个可能来源以及它触发次数的文件

$ cd /sys/firmware/acpi/interrupts
$ grep . *
error:             0
ff_gbl_lock:       0   enable
ff_pmtimer:        0  invalid
ff_pwr_btn:        0   enable
ff_rt_clk:         2  disable
ff_slp_btn:        0  invalid
gpe00:             0  invalid
gpe01:             0   enable
gpe02:           108   enable
gpe03:             0  invalid
gpe04:             0  invalid
gpe05:             0  invalid
gpe06:             0   enable
gpe07:             0   enable
gpe08:             0  invalid
gpe09:             0  invalid
gpe0A:             0  invalid
gpe0B:             0  invalid
gpe0C:             0  invalid
gpe0D:             0  invalid
gpe0E:             0  invalid
gpe0F:             0  invalid
gpe10:             0  invalid
gpe11:             0  invalid
gpe12:             0  invalid
gpe13:             0  invalid
gpe14:             0  invalid
gpe15:             0  invalid
gpe16:             0  invalid
gpe17:          1084   enable
gpe18:             0   enable
gpe19:             0  invalid
gpe1A:             0  invalid
gpe1B:             0  invalid
gpe1C:             0  invalid
gpe1D:             0  invalid
gpe1E:             0  invalid
gpe1F:             0  invalid
gpe_all:        1192
sci:            1194
sci_not:           0

sci

ACPI SCI 被调用并声明中断的次数。

sci_not

ACPI SCI 被调用但未声明中断的次数。

gpe_all

由 GPE 引起的 SCI 计数。

gpeXX

单个 GPE 源的计数

ff_gbl_lock

全局锁

ff_pmtimer

PM 定时器

ff_pwr_btn

电源按钮

ff_rt_clk

实时时钟

ff_slp_btn

睡眠按钮

error (错误)

以上无法解释的中断。

invalid

它要么是没有事件处理程序的 GPE，要么是没有事件处理程序的固定事件。

disable

GPE/固定事件有效但已禁用。

enable

GPE/固定事件有效且已启用。

Root 有权清除任何这些计数器。例如。

# echo 0 > gpe11

可以通过清除总计 “sci” 来清除所有计数器

# echo 0 > sci

这些计数器都不会影响系统的功能，它们只是统计信息。

除此之外，用户还可以将特定字符串写入这些文件，以在用户空间中启用/禁用/清除 ACPI 中断，这可用于调试某些 ACPI 中断风暴问题。

请注意，仅允许写入有效的 GPE/固定事件，即用户只能更改安装了事件处理程序的运行时 GPE 和固定事件的状态。

让我们以电源按钮固定事件为例，请关闭 acpid 和其他用户空间应用程序，以便在按下电源按钮时机器不会关机

# cat ff_pwr_btn
0     enabled
# press the power button for 3 times;
# cat ff_pwr_btn
3     enabled
# echo disable > ff_pwr_btn
# cat ff_pwr_btn
3     disabled
# press the power button for 3 times;
# cat ff_pwr_btn
3     disabled
# echo enable > ff_pwr_btn
# cat ff_pwr_btn
4     enabled
/*
 * this is because the status bit is set even if the enable
 * bit is cleared, and it triggers an ACPI fixed event when
 * the enable bit is set again
 */
# press the power button for 3 times;
# cat ff_pwr_btn
7     enabled
# echo disable > ff_pwr_btn
# press the power button for 3 times;
# echo clear > ff_pwr_btn     /* clear the status bit */
# echo disable > ff_pwr_btn
# cat ff_pwr_btn
7     enabled

/sys/firmware/acpi/platform_profile

定义在文件 sysfs-platform_profile 中

读取此文件可获取此设备当前选择的配置文件。使用 platform_profile_choices 中的字符串写入此文件会将配置文件更改为新值。

可以通过轮询 POLLPRI 来监视此文件的更改，无论这些更改是来自用户空间的写入，还是来自其他来源（例如，由嵌入式控制器直接处理的热键触发的配置文件更改，或者完全在内核中处理的更改），都会发出 POLLPRI 信号。

/sys/firmware/acpi/platform_profile_choices

定义在文件 sysfs-platform_profile 中

此文件包含此设备支持的以空格分隔的配置文件列表。

驱动程序必须使用以下标准配置文件名称

low-power

低功耗

cool

更凉爽的操作

quiet

更安静的操作

balanced

在低功耗和性能之间取得平衡

balanced-performance

在性能和低功耗之间取得平衡，略微偏向性能

performance

高性能操作

用户空间可能会期望驱动程序提供多个这些标准配置文件名称。

/sys/firmware/devicetree/*

在文件 sysfs-firmware-ofw 中定义

当使用 OpenFirmware 或扁平设备树来枚举硬件时，设备树结构将在此目录中公开。

可能存在多个设备树目录。某些设备驱动程序使用单独的、与系统树没有关联的独立设备树，这些设备树将出现在 /sys/firmware/devicetree 下的不同子目录中。

用户空间不得直接使用 /sys/firmware/devicetree/base 路径，而应遵循 /proc/device-tree 符号链接。将来绝对路径可能会更改，但符号链接是稳定的 ABI。

/proc/device-tree 符号链接取代了 devicetree /proc 文件系统的支持，并且具有大致相同的语义，应该与现有的用户空间兼容。

/sys/firmware/devicetree/ 的内容是目录的层次结构，每个设备树节点一个目录。目录名称是解析的路径组件名称（节点名称加上地址）。属性表示为目录中的文件。每个文件的内容是设备树中的确切二进制数据。

/sys/firmware/dmi/entries/

在文件 sysfs-firmware-dmi-entries 中定义

许多机器的固件（x86 和 arm64）将 DMI / SMBIOS 表导出到操作系统。获取此信息对用户层通常很有价值，尤其是在使用 OEM 扩展的情况下。

内核本身不依赖于这些表中大部分信息的正确性。它也不能保证导出到用户层的数据没有错误。

DMI 的结构是一个大型的条目表，其中每个条目都有一个通用的头，指示条目的类型和长度，以及一个固件提供的“句柄”，该句柄在所有条目中应该是唯一的。

某些条目是规范要求的，但许多其他条目是可选的。但总的来说，除非用户确定他们的固件在做什么，否则永远不应期望在其系统上找到特定的条目类型。机器之间的体验会有所不同。

允许同一类型的多个条目。为了处理这些重复的条目类型，操作系统为每个条目分配一个“实例”，该实例来自条目类型的序号位置。也就是说，如果 DMI 表中有“N”个具有相同类型“T”的多个条目（相邻或分散，这无关紧要），它们将在 sysfs 中表示为条目 “T-0” 到 “T-(N-1)”

条目目录示例

/sys/firmware/dmi/entries/17-0
/sys/firmware/dmi/entries/17-1
/sys/firmware/dmi/entries/17-2
/sys/firmware/dmi/entries/17-3
...

实例编号代替固件分配的条目句柄，因为内核本身不保证导出的句柄是唯一的，并且可能有一些固件映像在这方面存在错误。

sysfs 中的每个 DMI 条目都将公共头值导出为属性

handle

固件为此条目分配的 16 位“句柄”。其他条目可能会引用此句柄。

length

条目的长度，如条目本身所示。请注意，这_不是_与条目关联的总字节数。此值表示条目的“格式化”部分的长度。此“格式化”区域有时后面跟着由空终止字符串组成的“未格式化”区域，以两个连续的空字符表示终止。

raw

条目的原始字节。这包括条目的“格式化”部分、条目的“未格式化”字符串部分以及两个终止空字符。

type

条目的类型。此值与目录名称中找到的值相同。它指示应该如何解释条目的其余部分。

instance

给定类型的条目的实例序号。此值与父目录名称中找到的值相同。

position

条目在整个 DMI 条目表中的序号位置（从零开始）。

条目专业化

某些条目类型可能在 sysfs 中提供其他信息。并非所有类型都是专门化的。

类型 15 - 系统事件日志

此条目允许固件导出系统发生的事件日志。此信息通常由 nvram 支持，但此表抽象了实现细节。此条目的数据在目录中导出

/sys/firmware/dmi/entries/15-0/system_event_log

并具有以下属性（在 SMBIOS / DMI 规范中的“系统事件日志（类型 15）”下记录）

  • area_length

  • header_start_offset

  • data_start_offset

  • access_method

  • status

  • change_token

  • access_method_address

  • header_format

  • per_log_type_descriptor_length

  • type_descriptors_supported_count

此外，内核还会导出二进制属性

raw_event_log

DMI 条目描述的事件日志的原始二进制位。

/sys/firmware/dmi/tables/

在文件 sysfs-firmware-dmi-tables 中定义

固件提供 DMI 结构作为由 SMBIOS 表入口点引用的打包数据列表。SMBIOS 入口点包含一般信息，例如 SMBIOS 版本、DMI 表大小等。SMBIOS 入口点的结构、内容和大小取决于 SMBIOS 版本。可以在 SMBIOS 规范中读取 SMBIOS 入口点和 DMI 结构的格式。

dmi/tables 通过 sysfs 提供原始的 SMBIOS 入口点和 DMI 表，作为从 /dev/mem 读取它们的实用程序的替代方案。原始 SMBIOS 入口点和 DMI 表以二进制属性的形式呈现，并且可以通过以下方式访问

/sys/firmware/dmi/tables/smbios_entry_point /sys/firmware/dmi/tables/DMI

可以使用这两个表获取完整的 DMI 信息。

/sys/firmware/efi/config_table

在文件 sysfs-firmware-efi 中定义

它显示了 EFI 系统表中配置表条目的物理地址。

用户：Kexec

/sys/firmware/efi/esrt/

在文件 sysfs-firmware-efi-esrt 中定义

提供用户层访问权限以读取 EFI 系统资源表 (ESRT)，该表是可以使用 UEFI Standard 7.5 节中描述的 UEFI UpdateCapsule 机制更新的固件目录。

用户：fwupdate - https://github.com/rhinstaller/fwupdate

/sys/firmware/efi/esrt/entries/entry<N>/

在文件 sysfs-firmware-efi-esrt 中定义

每个 ESRT 条目都由一个 GUID 标识，每个条目在 entries/ 下都有一个子目录。示例：/sys/firmware/efi/esrt/entries/entry0/

/sys/firmware/efi/esrt/entries/entry<N>/capsule_flags

在文件 sysfs-firmware-efi-esrt 中定义

必须传递给 UpdateCapsule() 的标志

/sys/firmware/efi/esrt/entries/entry<N>/fw_class

在文件 sysfs-firmware-efi-esrt 中定义

这是条目的 guid，并且将与目录名称匹配。

/sys/firmware/efi/esrt/entries/entry<N>/fw_type

在文件 sysfs-firmware-efi-esrt 中定义

这是什么类型的固件条目

0

未知

1

系统固件

2

设备固件

3

UEFI 驱动程序

/sys/firmware/efi/esrt/entries/entry<N>/fw_version

在文件 sysfs-firmware-efi-esrt 中定义

当前安装的固件版本。这是一个 32 位无符号整数。

/sys/firmware/efi/esrt/entries/entry<N>/last_attempt_status

在文件 sysfs-firmware-efi-esrt 中定义

固件资源条目的最后一次固件更新尝试的结果。

0

成功

1

资源不足

2

版本不正确

3

格式无效

4

身份验证错误

5

交流电源事件

6

电池电源事件

/sys/firmware/efi/esrt/entries/entry<N>/last_attempt_version

在文件 sysfs-firmware-efi-esrt 中定义

尝试更新的最后一个固件版本。

/sys/firmware/efi/esrt/entries/entry<N>/lowest_supported_fw_version

在文件 sysfs-firmware-efi-esrt 中定义

可以安装的固件的最低版本。

/sys/firmware/efi/esrt/fw_resource_count

在文件 sysfs-firmware-efi-esrt 中定义

ESRT 中的条目数

/sys/firmware/efi/esrt/fw_resource_count_max

在文件 sysfs-firmware-efi-esrt 中定义

当前表分配中可以注册的最大条目数。这实际上仅对系统固件本身有用。

/sys/firmware/efi/esrt/fw_resource_version

在文件 sysfs-firmware-efi-esrt 中定义

固件提供的 ESRT 结构的版本。

/sys/firmware/efi/fw_vendor

在文件 sysfs-firmware-efi 中定义

它显示了 EFI 系统表中固件供应商字段的物理地址。

用户：Kexec

/sys/firmware/efi/runtime

在文件 sysfs-firmware-efi 中定义

它显示了 EFI 系统表中运行时服务表条目的物理地址。

用户：Kexec

/sys/firmware/efi/runtime-map/

在文件 sysfs-firmware-efi-runtime-map 中定义

将 efi 运行时服务切换到虚拟模式需要将所有设置了运行时属性位的 efi 内存范围映射到虚拟地址。

efi 运行时服务只能在不重新启动的情况下切换到虚拟模式一次。kexec 内核必须保持与第一个内核相同的物理到虚拟地址映射。映射导出到 sysfs，以便用户空间工具可以重新组装它们并将它们传递到 kexec 内核中。

/sys/firmware/efi/runtime-map/ 是内核导出该信息的目录。

子目录以内存范围的编号命名

/sys/firmware/efi/runtime-map/0
/sys/firmware/efi/runtime-map/1
/sys/firmware/efi/runtime-map/2
/sys/firmware/efi/runtime-map/3
...

每个子目录包含五个文件

attribute

内存范围的属性。

num_pages

内存范围的大小，以页为单位。

phys_addr

内存范围的物理地址。

type

内存范围的类型。

virt_addr

内存范围的虚拟地址。

以上值均为十六进制数字，带有 '0x' 前缀。

用户：Kexec

/sys/firmware/efi/systab

在文件 sysfs-firmware-efi 中定义

显示通过 EFI 系统表找到的所有 EFI 配置表的物理地址。表格的打印顺序形成 ABI，较新的版本总是先打印，例如 ACPI20 排在 ACPI 之前。

用户：dmidecode

/sys/firmware/efi/tables/rci2

在文件 sysfs-firmware-efi 中定义

以二进制格式显示 Dell EMC PowerEdge 系统上运行时配置接口表版本 2 的内容

用户：Dell EMC OpenManage Server Administrator 工具使用它来填充 BIOS 设置页面。

/sys/firmware/fdt

在文件 sysfs-firmware-ofw 中定义

导出引导加载程序传递给内核的 FDT blob。这允许用户空间应用程序（如 kexec）访问原始二进制文件。此 blob 在调试时也很有用，因为它包含引导加载程序对 blob 所做的任何更改。

此节点不位于 /sys/firmware/device-tree 下是有意为之的：FDT 也用于 arm64 UEFI/ACPI 系统，仅用于传递 UEFI 和 ACPI 入口点，但 FDT 永远不会被解压并用于配置系统。

对整个 FDT blob 计算 CRC32 校验和，并在 late_initcall 时间进行验证。仅当校验和有效时，即 FDT blob 在此期间未被修改时，才会实例化 sysfs 条目。否则，会打印警告。

用户：kexec，调试

/sys/firmware/gsmi

定义在文件 sysfs-firmware-gsmi 中

Google 内部使用的一些服务器具有通过显式 SMI 触发器提供回调功能的固件。其中一些回调类似于 EFI 运行时服务页面提供的回调，但由于历史原因，使用了这个不同的入口点。

gsmi 驱动程序实现了内核对这些固件回调的抽象。目前，此功能仅限于处理系统事件日志和访问存储在 nvram 中的 EFI 样式变量。

布局

/sys/firmware/gsmi/vars

此目录具有与 /sys/firmware/efi/vars 相同的布局（和底层实现）。有关如何与此结构交互的更多信息，请参阅 Documentation/ABI/*/sysfs-firmware-efi-vars。

/sys/firmware/gsmi/append_to_eventlog - 只写

此文件接收一个二进制 blob，并将其传递给固件，以便添加时间戳并将其附加到系统事件日志中。二进制格式由固件解释，并且可能因平台而异。内核强制要求的唯一要求是 blob 以一个 32 位主机字节序类型作为前缀，该类型用作固件调用的一部分。

/sys/firmware/gsmi/clear_config - 只写

向此文件写入任何值都会导致整个固件配置重置为“出厂默认值”。调用者应假设需要重新启动才能清除配置。

/sys/firmware/gsmi/clear_eventlog - 只写

此文件用于清除系统事件日志的一部分或全部。写入的值应为 1 到 100（包括 1 和 100）（以 ASCII 码表示），表示要清除的日志的比例。并非所有平台都支持部分清除，如果固件不喜欢您提交的比例，则对此文件的写入将出错。

调用者应假设需要重新启动才能完成此操作。

/sys/firmware/ibft/acpi_header

定义在文件 sysfs-ibft 中

/sys/firmware/ibft/acpi_header 目录将包含一些文件，这些文件公开 iBFT 结构的 acpi 表头的 SIGNATURE、OEM_ID 和 OEM_TABLE_ID 字段。这将有助于识别表的创建者，这对于确定某些适配器在硬件与软件 iscsi 发起程序模式下使用时相关的怪癖很有用。

/sys/firmware/ibft/ethernetX

定义在文件 sysfs-ibft 中

/sys/firmware/ibft/ethernetX 目录将包含一些文件，这些文件公开 iSCSI 启动固件表 NIC 数据。通常，这包含 NIC 的 IP 地址、MAC 和网关。

/sys/firmware/ibft/initiator

定义在文件 sysfs-ibft 中

/sys/firmware/ibft/initiator 目录将包含一些文件，这些文件公开 iSCSI 启动固件表发起程序数据。通常，这包含发起程序名称。

/sys/firmware/ibft/targetX

定义在文件 sysfs-ibft 中

/sys/firmware/ibft/targetX 目录将包含一些文件，这些文件公开 iSCSI 启动固件表目标数据。通常，这包含目标的 IP 地址、引导 LUN、目标名称以及它与哪个 NIC 相关联。它还可以包含 CHAP 名称（和密码）、反向 CHAP 名称（和密码）。

/sys/firmware/initrd

定义在文件 sysfs-firmware-initrd 中

当内核使用 initrd 启动并且在内核命令行上设置了“retain_initrd”选项时，/sys/firmware/initrd 包含内核启动时使用的 initrd 的内容。

/sys/firmware/lefi/boardinfo

定义在文件 sysfs-firmware-lefi-boardinfo 中

在龙芯平台上轻松获取主板和 BIOS 信息，这有助于在出现与硬件或固件相关的问题时指出当前使用的主板类型和 BIOS 版本。

相关结构已经在关于固件和内核的接口规范中定义，这是龙芯64的通用要求和特定要求，因此仅在 arch/mips/loongson64 中添加一个新的 boardinfo.c 文件。

例如

[loongson@linux ~]$ cat /sys/firmware/lefi/boardinfo Board Info Manufacturer : LEMOTE Board Name : LEMOTE-LS3A4000-7A1000-1w-V01-pc Family : LOONGSON3

BIOS Info Vendor : Kunlun Version : Kunlun-A1901-V4.1.3-20200414093938 ROM Size : 4 KB Release Date : 2020-04-14

顺便说一句，如果固件中存在 SMBIOS，可以使用 dmidecode 命令获取类似的信息，但事实是某些机器上没有 SMBIOS，当执行 dmidecode 时，我们看不到任何内容，就像这样

[root@linux loongson]# dmidecode # dmidecode 2.12 # No SMBIOS nor DMI entry point found, sorry.

/sys/firmware/log

定义在文件 sysfs-firmware-log 中

/sys/firmware/log 是一个二进制文件，表示固件日志的只读副本（如果可用）。

/sys/firmware/memmap/

定义在文件 sysfs-firmware-memmap 中

在所有平台上，固件都提供一个内存映射，内核会读取该映射。该内存映射中的资源会在内核资源树中注册，并通过 /proc/iomem 向用户空间公开（与其他资源一起）。

但是，在大多数架构上，固件提供的内存映射随后会被内核本身修改，要么是因为内核将该内存映射与其他信息合并，要么只是因为用户通过命令行覆盖了该内存映射。

kexec 需要原始固件提供的内存映射来设置应该使用 kexec 启动的内核的参数段。此外，原始内存映射对于调试很有用。因此，/sys/firmware/memmap 是一个向用户空间提供原始内存映射的接口。

结构如下：在 /sys/firmware/memmap 下，有以条目编号为名称的子目录

/sys/firmware/memmap/0
/sys/firmware/memmap/1
/sys/firmware/memmap/2
/sys/firmware/memmap/3
...

最大值取决于固件提供的内存映射条目的数量。顺序只是固件提供的顺序。

每个目录包含三个文件

start

起始地址（作为带有 '0x' 前缀的十六进制数字）。

end

结束地址，包括在内（无论固件提供的是包含范围还是排除范围）。

type

条目的类型，以字符串形式表示。有关有效类型的列表，请参见下文。

例如

/sys/firmware/memmap/0/start
/sys/firmware/memmap/0/end
/sys/firmware/memmap/0/type
/sys/firmware/memmap/1/start
...

目前存在以下类型

  • 系统 RAM

  • ACPI 表

  • ACPI 非易失性存储

  • 不可用内存

  • 持久内存（传统）

  • 持久内存

  • 软保留

  • 保留

以下 shell 代码片段可用于以人类可读的格式显示该内存映射

#!/bin/bash
cd /sys/firmware/memmap
for dir in * ; do
    start=$(cat $dir/start)
    end=$(cat $dir/end)
    type=$(cat $dir/type)
    printf "%016x-%016x (%s)\n" $start $[ $end +1] "$type"
done

/sys/firmware/opal/powercap

定义在文件 sysfs-firmware-opal-powercap 中

Powernv (P8, P9) 服务器的功耗限制目录

此目录中的每个文件夹都包含一个可限制功耗的组件。

/sys/firmware/opal/powercap/system-powercap

定义在文件 sysfs-firmware-opal-powercap 中

适用于 Powernv (P8, P9) 服务器的系统功耗限制目录和属性

此目录提供功耗限制信息。它包含以下 sysfs 属性

  • powercap-min：此文件提供以瓦特为单位的最小可能的功耗限制

  • powercap-max：此文件提供以瓦特为单位的最大可能的功耗限制

  • powercap-current：此文件提供系统上设置的当前功耗限制。写入此文件会创建设置新功耗限制的请求。请求的功耗限制必须介于 powercap-min 和 powercap-max 之间。

/sys/firmware/opal/psr

定义在文件 sysfs-firmware-opal-psr 中

Powernv P9 服务器的功率转移比率目录

功率转移比率允许为固件提供提示，以在系统中不同的实体之间转移/限制功率。此目录中的每个属性都指示一个可设置的 PSR。

/sys/firmware/opal/psr/cpu_to_gpu_X

定义在文件 sysfs-firmware-opal-psr 中

适用于 Powernv P9 服务器的 PSR sysfs 属性

具有芯片 ID X 的给定芯片的 CPU 和 GPU 之间的功率转移比率。此文件给出了 OCC 用于功耗限制的比率 (0-100)。

/sys/firmware/opal/sensor_groups

定义在文件 sysfs-firmware-opal-sensor-groups 中

POWER9 powernv 服务器的传感器组目录

此目录中的每个文件夹都包含一个传感器组，这些传感器组根据传感器的类型（如功率、温度、频率、电流等）进行分类。它们还可以指示属于不同所有者（如 CSM、Profiler、作业调度程序）的传感器组

/sys/firmware/opal/sensor_groups/<sensor_group_name>/clear

定义在文件 sysfs-firmware-opal-sensor-groups 中

Sysfs 文件，用于清除属于该组的所有传感器的最小值-最大值。

向此文件写入 1 将清除组中所有传感器的最小值和最大值。在 POWER9 中，传感器的最小值-最大值是 OCC 缓存的传感器的历史最小值和最大值。

/sys/firmware/papr/energy_scale_info

定义在文件 sysfs-firmware-papr-energy-scale-info 中

该目录托管了一组平台属性，例如在作为 PAPR 客户机运行的 Linux 系统上的能耗/频率。

目录中的每个文件都包含一个与性能/节能模式和处理器频率相关的平台属性层次结构。

/sys/firmware/papr/energy_scale_info/<id>

定义在文件 sysfs-firmware-papr-energy-scale-info 中

POWERVM 服务器的能耗、频率属性目录

/sys/firmware/papr/energy_scale_info/<id>/desc

定义在文件 sysfs-firmware-papr-energy-scale-info 中

<id> 的能耗属性的字符串描述

/sys/firmware/papr/energy_scale_info/<id>/value

定义在文件 sysfs-firmware-papr-energy-scale-info 中

<id> 的能耗属性的数值

/sys/firmware/papr/energy_scale_info/<id>/value_desc

定义在文件 sysfs-firmware-papr-energy-scale-info 中

<id> 的能耗属性的字符串值

/sys/firmware/qemu_fw_cfg/

在文件 sysfs-firmware-qemu_fw_cfg 中定义

QEMU 支持的几种不同的架构（x86、arm、sun4*、ppc/mac）都配备了固件配置 (fw_cfg) 设备，该设备最初旨在作为主机向客户机固件提供配置数据的方式。从 QEMU v2.4 开始，用户可以在命令行上指定任意的 fw_cfg 文件条目，这使得 fw_cfg 还可以作为一种带外、异步机制，向客户机用户空间提供配置数据。

有关 fw_cfg 设备的权威客户机端硬件接口文档，可以在 QEMU 源代码树中的 “docs/specs/fw_cfg.rst” 中找到，或在网上找到：https://qemu-project.gitlab.io/qemu/specs/fw_cfg.html

SysFS fw_cfg 接口

本文档中描述的 fw_cfg sysfs 接口仅用于显示可发现的 blob（即在文件目录中注册的 blob），因为无法以编程方式确定 “旧式” blob（选择器键在 0x0002 和 0x0018 之间）的存在或大小。

所有 fw_cfg 信息都显示在

显示的唯一旧式 blob 是 fw_cfg 设备版本

/sys/firmware/qemu_fw_cfg/rev

按选择器键查找可发现的 fw_cfg blob

在 fw_cfg 文件目录中列出的所有可发现的 blob 都显示为以其唯一选择器键值命名的条目，例如

/sys/firmware/qemu_fw_cfg/by_key/32 /sys/firmware/qemu_fw_cfg/by_key/33 /sys/firmware/qemu_fw_cfg/by_key/34 ...

每个这样的 fw_cfg sysfs 条目都导出以下属性值

name

用作 fw_cfg 目录中 blob 的“文件名”的 56 字节以 null 结尾的 ASCII 字符串。

size

blob 的长度，如 fw_cfg 目录中给出。

键

blob 的选择器键的值，如 fw_cfg 目录中给出。此值与父目录名称中使用的值相同。

raw

blob 的原始字节，通过控制寄存器选择条目，并从数据寄存器读取等于 blob 大小的字节数来获得。

按文件名列出 fw_cfg blob

虽然 fw_cfg 设备没有对文件目录中注册的 blob 施加任何特定的命名约定，但 QEMU 开发人员传统上使用路径名语义为每个 blob 提供一个描述性名称。例如

"bootorder"
"genroms/kvmvapic.bin"
"etc/e820"
"etc/boot-fail-wait"
"etc/system-states"
"etc/table-loader"
"etc/acpi/rsdp"
"etc/acpi/tables"
"etc/smbios/smbios-tables"
"etc/smbios/smbios-anchor"
...

除了上面描述的按唯一选择器键列出之外，fw_cfg sysfs 驱动程序还尝试构建一个与 fw_cfg blob 名称的路径名组件匹配的目录树，最后链接到每个“基本名称”的 by_key 条目，如下所示（假设当前目录为 /sys/firmware）

qemu_fw_cfg/by_name/bootorder -> ../by_key/38
qemu_fw_cfg/by_name/etc/e820 -> ../../by_key/35
qemu_fw_cfg/by_name/etc/acpi/rsdp -> ../../../by_key/41
...

目录树和符号链接的构建是“尽力而为”的，因为不能保证 fw_cfg blob 名称的组件始终“表现良好”。即，存在符号链接（基本名称）与另一个 fw_cfg blob 的目录名组件冲突的可能性，在这种情况下，将跳过创建有问题的 /sys/firmware/qemu_fw_cfg/by_name 条目。

条目的权威列表将继续在 /sys/firmware/qemu_fw_cfg/by_key 目录下找到。

/sys/firmware/secvar

在文件 sysfs-secvar 中定义

如果 POWER 固件支持 OS 安全启动，即安全变量，则会创建此目录。它公开了用于读取/写入安全变量的接口

/sys/firmware/secvar/config

在文件 sysfs-secvar 中定义

此可选目录包含安全变量实现定义的只读配置属性。所有数据均为 ASCII 格式。仅当支持实现提供了用于填充它的变量时才会创建该目录，目前只有 pseries 平台上的 PLPKS 提供。

/sys/firmware/secvar/config/max_object_size

在文件 sysfs-secvar 中定义

密钥存储中允许的最大对象大小，以字节为单位，以 ASCII 十进制格式表示。

这不一定与可以写入更新文件的最大大小相同，因为写入可能包含比对象数据更多的数据，您应该为此目的使用更新文件的大小。

目前仅由 pseries 平台上的 PLPKS 提供。

/sys/firmware/secvar/config/signed_update_algorithms

在文件 sysfs-secvar 中定义

一个标志的位掩码，指示虚拟机管理程序支持哪些算法用于对象的签名更新，表示为 16 字节的十六进制 ASCII 字符串。有关这些标志的含义，请参阅虚拟机管理程序文档。

目前仅由 pseries 平台上的 PLPKS 提供。

/sys/firmware/secvar/config/supported_policies

在文件 sysfs-secvar 中定义

虚拟机管理程序支持的策略标志的位掩码，表示为 8 字节的十六进制 ASCII 字符串。有关这些标志是什么，请参阅虚拟机管理程序文档。

目前仅由 pseries 平台上的 PLPKS 提供。

/sys/firmware/secvar/config/total_size

在文件 sysfs-secvar 中定义

PLPKS 的总大小，以字节为单位，以 ASCII 十进制格式表示。

目前仅由 pseries 平台上的 PLPKS 提供。

/sys/firmware/secvar/config/used_space

在文件 sysfs-secvar 中定义

密钥存储当前消耗的空间，以字节为单位，以 ASCII 十进制格式表示。

目前仅由 pseries 平台上的 PLPKS 提供。

/sys/firmware/secvar/config/version

在文件 sysfs-secvar 中定义

虚拟机管理程序以 ASCII 十进制格式报告的配置版本。

目前仅由 pseries 平台上的 PLPKS 提供。

/sys/firmware/secvar/format

在文件 sysfs-secvar 中定义

一个字符串，指示固件正在使用哪个后端。这决定了变量的格式以及接受的变量更新格式。

在 powernv/OPAL 上，此值由 OPAL 固件提供，预计为 “ibm,edk2-compat-v1”。

在 pseries/PLPKS 上，这是由内核根据密钥存储中 SB_VERSION 变量的版本号生成的，形式为 “ibm,plpks-sb-v<version>”，如果不存在 SB_VERSION 变量，则为 “ibm,plpks-sb-unknown”。

/sys/firmware/secvar/vars

在文件 sysfs-secvar 中定义

此目录列出了固件支持的所有安全变量。

/sys/firmware/secvar/vars/<variable name>

在文件 sysfs-secvar 中定义

每个安全变量都表示为一个名为 <variable_name> 的目录。变量名称是唯一的，并且以 ASCII 表示。可以通过读取其各自的属性文件来确定数据和大小。

/sys/firmware/secvar/vars/<variable_name>/data

在文件 sysfs-secvar 中定义

一个只读文件，包含变量的值。文件的大小表示变量数据的最大大小。

/sys/firmware/secvar/vars/<variable_name>/size

在文件 sysfs-secvar 中定义

变量内容大小的整数表示。换句话说，它表示数据的大小。

/sys/firmware/secvar/vars/<variable_name>/update

在文件 sysfs-secvar 中定义

一个只写文件，用于提交变量的新值。文件的大小表示可以写入的变量数据的最大大小。

/sys/firmware/sgi_uv/

在文件 sysfs-firmware-sgi_uv 中定义

/sys/firmware/sgi_uv 目录包含有关 UV 平台的信息。

在该目录下是一些只读属性

archtype
hub_type
hubless
partition_id
coherence_id
uv_type

archtype 条目包含用于选择依赖于架构的地址和功能的 UV 架构类型。可以通过 ACPI MADT 表中的 OEM_ID 或从 UV BIOS 传递的 UVsystab 条目来设置它。

hub_type 条目用于选择 hub 的类型，这与 uv_type 相似，但以二进制格式编码。包含文件 uv_hub.h 以获取定义。

hubless 条目基本上仅在没有 hub 的情况下存在并设置。在这种情况下，hub_type 条目不存在。

partition_id 条目包含分区 id。UV 系统可以划分为多个物理机器，每个分区运行操作系统的唯一副本。每个分区都有一个唯一的分区 id。

coherence_id 条目包含一致性 id。分区的 UV 系统可以有一个或多个一致性域。一致性 id 指示此分区所在的哪个一致性域。

uv_type 条目包含 hub 修订号。此值可用于标识 UV 系统版本

"0.*" = Hubless UV ('*' is subtype)
"3.0" = UV2
"5.0" = UV3
"7.0" = UV4
"7.1" = UV4a
"9.0" = UV5

/sys/firmware/sgi_uv 目录还包含两个目录

hubs/
pcibuses/

hubs 目录包含许多 hub 对象，每个对象都代表 BIOS 可见的 UV Hub。每个 hub 对象的名称都附加了一个唯一的序号值（例如 /sys/firmware/sgi_uv/hubs/hub_5）

每个 hub 对象目录都包含许多只读属性

cnode
location
name
nasid
shared
this_partition

cnode 条目包含相应 hub 的 cnode 号。如果 cnode 值不适用，则返回的值将为 -1。

location 条目包含相应 hub 的位置字符串。此值用于在系统中物理标识 hub。

name 条目包含相应 hub 的名称。此名称可以是两个变体

"UVHub x.x" = A 'node' ASIC, connecting a CPU to the interconnect
fabric. The 'x.x' value represents the ASIC revision.
(ex. 'UVHub 5.0')

"NLxRouter" = A 'router ASIC, only connecting other ASICs to
the interconnect fabric. The 'x' value representing
the fabric technology version. (ex. 'NL8Router')

nasid 条目包含相应 hub 的 nasid 号。如果 nasid 值不适用，则返回的值将为 -1。

shared 条目包含一个布尔值，描述相应的 hub 是否在系统分区之间共享。

this_partition 条目包含一个布尔值，描述相应的 hub 是否为当前分区本地。

每个 hub 对象目录还包含许多端口对象，每个对象都代表相应 hub 上的光纤端口。端口对象的名称都附加了一个唯一的序号值（例如 /sys/firmware/sgi_uv/hubs/hub_5/port_3）

每个端口对象目录都包含许多只读属性

conn_hub
conn_port

conn_hub 条目包含一个值，表示插入端口的光纤电缆另一端的 hub 的唯一序号值。如果端口已断开连接，则返回的值将为 -1。

conn_port 条目包含一个值，表示插入端口的光纤电缆另一端的端口的唯一序号值。如果端口已断开连接，则返回的值将为 -1。

例如
从

/sys/firmware/sgi_uv/hubs/hub_5/port_3/conn_hub

读取的值为“3”，从

/sys/firmware/sgi_uv/hubs/hub_5/port_3/conn_port

读取的值为“6”，表示此端口连接到

/sys/firmware/sgi_uv/hubs/hub_3/port_6

pcibuses 目录包含许多 PCI 总线对象。每个 PCI 总线对象的名称都附加了其 PCI 总线地址。（例如 pcibus_0003:80）

每个 pcibus 对象都有许多可能的只读属性

type
location
slot
ppb_addr
iio_stack

type 条目包含一个值，描述相应 PCI 总线地址的 IO 类型。所有 UV 版本中已知的可能值为

BASE IO
PCIe IO
PCIe SLOT
NODE IO
Riser
PPB

location 条目包含物理连接到相应 PCI 总线的 CPU 的 UV Hub 的位置字符串。

slot 条目包含相应 PCI 总线的物理插槽号。此值用于在系统中物理定位 PCI 卡。

ppb_addr 条目包含桥接 PCI 总线的 PCI 地址字符串。此条目仅在 PCI 总线对象类型为 ‘PPB’ 时存在。

iio_stack 条目包含一个值，描述对应的 PCI 总线对象连接到的 IIO 堆栈编号。

/sys/firmware/turris-mox-rwtm/board_version

定义于文件 sysfs-firmware-turris-mox-rwtm

（读取）烧录到此 Turris Mox 板的 eFuses 中的主板版本。格式：%i

/sys/firmware/turris-mox-rwtm/mac_address*

定义于文件 sysfs-firmware-turris-mox-rwtm

（读取）烧录到此 Turris Mox 板的 eFuses 中的 MAC 地址。格式：%pM

/sys/firmware/turris-mox-rwtm/pubkey

定义于文件 sysfs-firmware-turris-mox-rwtm

（读取）ECDSA 公钥（以 pubkey 十六进制压缩形式），计算为此 Turris Mox 板的 eFuses 中烧录的 ECDSA 私钥的配对密钥。格式：字符串

/sys/firmware/turris-mox-rwtm/ram_size

定义于文件 sysfs-firmware-turris-mox-rwtm

（读取）此 Turris Mox 板的 RAM 大小，单位为 MiB，在制造过程中检测到并烧录到 eFuses 中。可以是 512 或 1024。格式：%i

/sys/firmware/turris-mox-rwtm/serial_number

定义于文件 sysfs-firmware-turris-mox-rwtm

（读取）烧录到此 Turris Mox 设备的 eFuses 中的序列号。格式：%016X

/sys/fs 下的符号

/sys/fs/erofs/<disk>/drop_caches

定义于文件 sysfs-fs-erofs

写入此文件将删除与压缩相关的缓存，当前用于删除内存中的 pcluster 和缓存的压缩 folios。

  • 1：使缓存的压缩 folios 无效

  • 2：删除内存中的 pcluster

  • 3：删除内存中的 pcluster 和缓存的压缩 folios

/sys/fs/erofs/<disk>/sync_decompress

定义于文件 sysfs-fs-erofs

控制同步解压缩的策略

  • 0（默认，自动）：启用 readpage，并且仅在原子上下文中启用 readahead。

  • 1（强制开启）：启用 readpage 和 readahead。

  • 2（强制关闭）：禁用所有情况。

/sys/fs/erofs/features/

定义于文件 sysfs-fs-erofs

显示所有已启用的内核特性。支持的特性：zero_padding、compr_cfgs、big_pcluster、chunked_file、device_table、compr_head2、sb_chksum、ztailpacking、dedupe、fragments。

/sys/fs/ext4/<disk>/delayed_allocation_blocks

定义于文件 sysfs-fs-ext4

此文件是只读的，显示在页面缓存中脏的但尚未在文件系统中分配位置的块数。

/sys/fs/ext4/<disk>/extent_max_zeroout_kb

定义于文件 sysfs-fs-ext4

当操作 inode 的 extent 树时，将优先归零而非创建新的未初始化 extent 的最大千字节数。请注意，使用较大的值会增加完成随机写入操作所需时间的可变性（因为 4k 随机写入可能由于归零操作而变成更大的写入）。

/sys/fs/ext4/<disk>/inode_goal

定义于文件 sysfs-fs-ext4

调整参数，如果非零，则控制 inode 分配器使用的目标 inode，而不是所有其他分配启发法。这仅用于调试，在生产系统上应为 0。

/sys/fs/ext4/<disk>/inode_readahead_blks

定义于文件 sysfs-fs-ext4

调整参数，控制 ext4 的 inode 表预读算法将预先读取到缓冲区缓存中的最大 inode 表块数

/sys/fs/ext4/<disk>/journal_task

定义于文件 sysfs-fs-ext4

此文件是只读的，显示当前 pid 命名空间中日志线程的 pid，如果任务不可达则为 0。

/sys/fs/ext4/<disk>/lifetime_write_kbytes

定义于文件 sysfs-fs-ext4

此文件是只读的，显示自创建以来写入此文件系统的千字节数据量。

/sys/fs/ext4/<disk>/max_writeback_mb_bump

定义于文件 sysfs-fs-ext4

写回代码在移动到另一个 inode 之前尝试写出的最大兆字节数。

/sys/fs/ext4/<disk>/mb_group_prealloc

定义于文件 sysfs-fs-ext4

如果 ext4 超级块中未设置条带大小，则多块分配器将分配请求向上舍入为此调整参数的倍数

/sys/fs/ext4/<disk>/mb_max_to_scan

定义于文件 sysfs-fs-ext4

多块分配器将搜索以找到最佳 extent 的最大 extent 数

/sys/fs/ext4/<disk>/mb_min_to_scan

定义于文件 sysfs-fs-ext4

多块分配器将搜索以找到最佳 extent 的最小 extent 数

/sys/fs/ext4/<disk>/mb_order2_req

定义于文件 sysfs-fs-ext4

调整参数，控制使用 buddy 缓存的请求的最小大小（以 2 的幂表示）

/sys/fs/ext4/<disk>/mb_stats

定义于文件 sysfs-fs-ext4

控制多块分配器是否应收集统计信息，这些统计信息在卸载期间显示。1 表示收集统计信息，0 表示不收集统计信息

/sys/fs/ext4/<disk>/mb_stream_req

定义于文件 sysfs-fs-ext4

块数少于此可调参数的文件将从块组特定的预分配池中分配其块，以便将小文件紧密地打包在一起。每个大文件将从其自己独特的预分配池中分配其块。

/sys/fs/ext4/<disk>/session_write_kbytes

定义于文件 sysfs-fs-ext4

此文件是只读的，显示自挂载以来写入此文件系统的千字节数据量。

/sys/fs/f2fs/<disk>/atgc_age_threshold

定义于文件 sysfs-fs-f2fs

当 ATGC 开启时，它控制年龄阈值以绕过 GC 年轻候选对象，其年龄不超过阈值，默认情况下初始化为 604800 秒（等于 7 天）。

/sys/fs/f2fs/<disk>/atgc_age_weight

定义于文件 sysfs-fs-f2fs

当 ATGC 开启时，它控制年龄权重以平衡老化和有效块之间的权重比例，该值应在 [0, 100] 范围内，默认情况下初始化为 60(%)。

/sys/fs/f2fs/<disk>/atgc_candidate_count

定义于文件 sysfs-fs-f2fs

当 ATGC 开启时，它控制候选计数，以限制所有候选对象中潜在受害者的总数，默认情况下初始化为 10（节）。

/sys/fs/f2fs/<disk>/atgc_candidate_ratio

定义于文件 sysfs-fs-f2fs

当 ATGC 开启时，它控制候选比率，以限制所有候选对象中潜在受害者的总数，该值应在 [0, 100] 范围内，默认情况下初始化为 20(%)。

/sys/fs/f2fs/<disk>/atgc_enabled

定义于文件 sysfs-fs-f2fs

它表示 ATGC 是否开启。该值为 1，表示

ATGC 开启，0 表示 ATGC 关闭。

/sys/fs/f2fs/<disk>/avg_vblocks

定义于文件 sysfs-fs-f2fs

有效块的平均数。当 CONFIG_F2FS_STAT_FS=y 时可用。

/sys/fs/f2fs/<disk>/blkzone_alloc_policy

定义于文件 sysfs-fs-f2fs

我们当前使用的区域 UFS 由两部分组成：传统区域和顺序区域。它可用于控制优先写入哪个部分，默认值为 0。

值

描述

blkzone_alloc_policy = 0

优先写入顺序区域

blkzone_alloc_policy = 1

仅允许写入顺序区域

blkzone_alloc_policy = 2

优先写入传统区域

/sys/fs/f2fs/<disk>/ckpt_thread_ioprio

定义于文件 sysfs-fs-f2fs

提供了一种更改检查点合并守护进程的 io 优先级的方法。其默认值为 “be,3”，表示 “BE” I/O 类和 I/O 优先级 “3”。我们可以在 “rt” 和 “be” 之间选择类，并在其有效范围内设置 I/O 优先级。“,” 分隔符在 I/O 类和优先级编号之间是必需的。

/sys/fs/f2fs/<disk>/committed_atomic_block

定义于文件 sysfs-fs-f2fs

显示启动后累积的原子写入块总计数。如果您在此处写入 “0”，则可以初始化为 “0”。

/sys/fs/f2fs/<disk>/compr_new_inode

定义于文件 sysfs-fs-f2fs

显示自挂载以来新启用压缩的 inode 计数。请注意，当文件的压缩被禁用时，此计数不会减少。如果您在此处写入 “0”，则可以将 compr_new_inode 初始化为 “0”。

/sys/fs/f2fs/<disk>/compr_saved_block

定义于文件 sysfs-fs-f2fs

显示自挂载以来通过压缩保存的块计数。请注意，当删除压缩块时，此计数不会减少。如果您在此处写入 “0”，则可以将 compr_written_block 和 compr_saved_block 初始化为 “0”。

/sys/fs/f2fs/<disk>/compr_written_block

定义于文件 sysfs-fs-f2fs

显示自挂载以来压缩后写入的块计数。请注意，当删除压缩块时，此计数不会减少。如果您在此处写入 “0”，则可以将 compr_written_block 和 compr_saved_block 初始化为 “0”。

/sys/fs/f2fs/<disk>/compress_percent

定义于文件 sysfs-fs-f2fs

当压缩缓存开启时，它控制缓存页面百分比（压缩页面/空闲内存）以限制缓存压缩页面。如果缓存页面百分比超过阈值，则拒绝缓存压缩页面。该值应在 (0, 100] 范围内，默认情况下初始化为 20(%)。

/sys/fs/f2fs/<disk>/compress_watermark

定义于文件 sysfs-fs-f2fs

当压缩缓存开启时，它控制空闲内存水印，以限制缓存压缩页面。如果空闲内存低于水印，则拒绝缓存压缩页面。该值应在 (0, 100] 范围内，默认情况下初始化为 20(%)。

/sys/fs/f2fs/<disk>/cp_background_calls

定义于文件 sysfs-fs-f2fs

在后台执行以释放段的检查点操作次数。当 CONFIG_F2FS_STAT_FS=y 时可用。

/sys/fs/f2fs/<disk>/cp_foreground_calls

定义于文件 sysfs-fs-f2fs

按需执行的检查点操作次数。当 CONFIG_F2FS_STAT_FS=y 时可用。

/sys/fs/f2fs/<disk>/cp_interval

定义于文件 sysfs-fs-f2fs

控制检查点计时，默认设置为 60 秒。

/sys/fs/f2fs/<disk>/current_atomic_write

定义于文件 sysfs-fs-f2fs

显示尚未提交的当前原子写入块总计数。这是一个只读条目。

/sys/fs/f2fs/<disk>/current_reserved_blocks

定义于文件 sysfs-fs-f2fs

显示系统中当前保留的块，它可能暂时小于 target_reserved_blocks，但是当用户稍后释放更多空闲块时，将逐渐增加到 target_reserved_blocks。

/sys/fs/f2fs/<disk>/data_io_flag

定义于文件 sysfs-fs-f2fs

提供了一种将 REQ_META|FUA 附加到给定基于温度的位的数据写入的方法。现在，这些位表示

REQ_META

REQ_FUA

5

4

3

2

1

0

冷

温

热

冷

温

热

/sys/fs/f2fs/<disk>/dir_level

定义于文件 sysfs-fs-f2fs

控制大型目录的目录级别。如果目录包含大量文件，则可以通过增加此 dir_level 值来减少文件查找延迟。否则，它需要减小此值以减少空间开销。默认值为 0。

/sys/fs/f2fs/<disk>/dirty_nats_ratio

定义于文件 sysfs-fs-f2fs

控制脏 nat 条目比率阈值，如果当前比率超过配置的阈值，则将触发检查点以刷新脏 nat 条目。

/sys/fs/f2fs/<disk>/dirty_segments

定义于文件 sysfs-fs-f2fs

显示脏段的数量。

/sys/fs/f2fs/<disk>/discard_granularity

定义于文件 sysfs-fs-f2fs

控制内部丢弃线程的丢弃粒度。内部线程不会发出小于粒度的丢弃。单位大小为一个块（4KB），现在仅支持在 [1, 512] 范围内配置。默认值为 16。对于小型设备，默认值为 1。

/sys/fs/f2fs/<disk>/discard_idle_interval

定义于文件 sysfs-fs-f2fs

给定此时间间隔，控制丢弃线程的空闲计时。默认为 5 秒。

/sys/fs/f2fs/<disk>/discard_io_aware

定义于文件 sysfs-fs-f2fs

它控制启用/禁用后台丢弃的 IO 感知特性。默认情况下，该值为 1，表示 IO 感知已开启。

/sys/fs/f2fs/<disk>/discard_io_aware_gran

定义于文件 sysfs-fs-f2fs

控制内部丢弃线程在非空闲时的后台丢弃粒度。内部线程不会发出小于粒度的丢弃。单位大小为一个块（4KB），现在仅支持在 [0, 512] 范围内配置。默认值：512

/sys/fs/f2fs/<disk>/discard_urgent_util

定义于文件 sysfs-fs-f2fs

当空间利用率超过此值时，积极执行后台 DISCARD。当丢弃数不为 0 并且将丢弃粒度设置为 1 时，在给定的 min_discard_issue_time 期间强制执行 DISCARD。默认值：80

/sys/fs/f2fs/<disk>/encoding

定义于文件 sysfs-fs-f2fs

显示文件系统编码集的名称和版本。如果未设置编码，则显示（无）

/sys/fs/f2fs/<disk>/extension_list

定义于文件 sysfs-fs-f2fs

用于控制配置扩展列表： - 查询：cat /sys/fs/f2fs/<disk>/extension_list - 添加：echo ‘[h/c]extension’ > /sys/fs/f2fs/<disk>/extension_list - 删除：echo ‘[h/c]!extension’ > /sys/fs/f2fs/<disk>/extension_list - [h] 表示添加/删除热文件扩展名 - [c] 表示添加/删除冷文件扩展名

/sys/fs/f2fs/<disk>/fault_rate

定义于文件 sysfs-fs-f2fs

在所有支持的类型中启用故障注入，并指定注入率。

/sys/fs/f2fs/<disk>/fault_type

定义于文件 sysfs-fs-f2fs

支持配置故障注入类型，应通过 fault_injection 选项启用。故障类型值如下所示，支持单类型或组合类型。

类型名称

类型值

FAULT_KMALLOC

0x000000001

FAULT_KVMALLOC

0x000000002

FAULT_PAGE_ALLOC

0x000000004

FAULT_PAGE_GET

0x000000008

FAULT_ALLOC_BIO

0x000000010 （已过时）

FAULT_ALLOC_NID

0x000000020

FAULT_ORPHAN

0x000000040

FAULT_BLOCK

0x000000080

FAULT_DIR_DEPTH

0x000000100

FAULT_EVICT_INODE

0x000000200

FAULT_TRUNCATE

0x000000400

FAULT_READ_IO

0x000000800

FAULT_CHECKPOINT

0x000001000

FAULT_DISCARD

0x000002000

FAULT_WRITE_IO

0x000004000

FAULT_SLAB_ALLOC

0x000008000

FAULT_DQUOT_INIT

0x000010000

FAULT_LOCK_OP

0x000020000

FAULT_BLKADDR_VALIDITY

0x000040000

FAULT_BLKADDR_CONSISTENCE

0x000080000

FAULT_NO_SEGMENT

0x000100000

/sys/fs/f2fs/<disk>/feature_list/

定义于文件 sysfs-fs-f2fs

展开 /sys/fs/f2fs/<disk>/features 以符合 sysfs 规则。支持的磁盘特性：encryption、block_zoned (又名 blkzoned)、extra_attr、project_quota (又名 projquota)、inode_checksum、flexible_inline_xattr、quota_ino、inode_crtime、lost_found、verity、sb_checksum、casefold、readonly、compression。请注意，pin_file 已移至 /sys/fs/f2fs/features/。

/sys/fs/f2fs/<disk>/features

定义于文件 sysfs-fs-f2fs

<已弃用：应使用 /sys/fs/f2fs/<disk>/feature_list/> 显示当前设备中所有已启用的特性。支持的特性：encryption、blkzoned、extra_attr、projquota、inode_checksum、flexible_inline_xattr、quota_ino、inode_crtime、lost_found、verity、sb_checksum、casefold、readonly、compression、pin_file。

/sys/fs/f2fs/<disk>/free_segments

定义于文件 sysfs-fs-f2fs

磁盘中空闲段的数量。

/sys/fs/f2fs/<disk>/gc_background_calls

定义于文件 sysfs-fs-f2fs

在后台触发的垃圾回收操作次数。当 CONFIG_F2FS_STAT_FS=y 时可用。

/sys/fs/f2fs/<disk>/gc_boost_zoned_gc_percent

定义于文件 sysfs-fs-f2fs

如果空闲段占总段数的百分比低于此数值，则 F2FS 会通过后台 GC 线程来增强分区设备的垃圾回收。默认数值为 “25”。

/sys/fs/f2fs/<disk>/gc_foreground_calls

定义于文件 sysfs-fs-f2fs

按需执行的垃圾回收操作次数。当 CONFIG_F2FS_STAT_FS=y 时可用。

/sys/fs/f2fs/<disk>/gc_idle

定义于文件 sysfs-fs-f2fs

控制垃圾回收的牺牲选择策略。设置 gc_idle = 0（默认值）将禁用此选项。设置

gc_idle = 1

将选择成本效益方法，设置

gc_idle = 2

将选择贪婪方法，设置

gc_idle = 3

将选择基于年龄阈值的方法。

/sys/fs/f2fs/<disk>/gc_idle_interval

定义于文件 sysfs-fs-f2fs

控制 gc 路径的空闲时间。默认设置为 5 秒。

/sys/fs/f2fs/<disk>/gc_max_sleep_time

定义于文件 sysfs-fs-f2fs

控制 gc_thread 的最大睡眠时间。时间单位为毫秒。

/sys/fs/f2fs/<disk>/gc_min_sleep_time

定义于文件 sysfs-fs-f2fs

控制 gc_thread 的最小睡眠时间。时间单位为毫秒。

/sys/fs/f2fs/<disk>/gc_mode

定义于文件 sysfs-fs-f2fs

以字符串形式显示当前的 gc_mode。这是一个只读条目。

/sys/fs/f2fs/<disk>/gc_no_gc_sleep_time

定义于文件 sysfs-fs-f2fs

控制 gc_thread 的默认睡眠时间。时间单位为毫秒。

/sys/fs/f2fs/<disk>/gc_no_zoned_gc_percent

定义于文件 sysfs-fs-f2fs

如果空闲段占总段数的百分比高于此数值，则 F2FS 不会通过后台 GC 线程来对分区设备进行垃圾回收。默认数值为 “60”。

/sys/fs/f2fs/<disk>/gc_pin_file_thresh

定义于文件 sysfs-fs-f2fs

这表示为固定文件可以失败的 GC 次数。如果超过此值，则 F2FS 不保证其固定状态。默认设置为 2048 次尝试，最大值为 65535。

/sys/fs/f2fs/<disk>/gc_reclaimed_segments

定义于文件 sysfs-fs-f2fs

显示在特定的 GC 模式期间，GC 回收了多少段（0：GC 正常，1：GC 空闲 CB，2：GC 空闲贪婪，3：GC 空闲 AT，4：GC 紧急高，5：GC 紧急低，6：GC 紧急中）。您可以将此值重新初始化为“0”。

/sys/fs/f2fs/<disk>/gc_remaining_trials

定义于文件 sysfs-fs-f2fs

您可以使用此值设置 GC 紧急和空闲模式的尝试次数限制。如果 GC 线程达到限制，模式将返回到 GC 正常模式。默认情况下，该值为零，这意味着像以前一样没有限制。

/sys/fs/f2fs/<disk>/gc_segment_mode

定义于文件 sysfs-fs-f2fs

您可以控制 “gc_reclaimed_segments” 节点显示哪个 gc 模式。请参阅 “gc_reclaimed_segments” 中对模式的描述。

/sys/fs/f2fs/<disk>/gc_urgent

定义于文件 sysfs-fs-f2fs

设置后，积极执行后台 GC。默认设置为 0。gc 紧急高 (1)：在给定的 gc_urgent_sleep_time 时间段内强制执行 GC，并忽略 I/O 空闲检查。使用贪婪 GC 方法并启用 SSR 模式。gc 紧急低 (2)：降低 I/O 空闲检查的标准，以便处理未完成的 discard 命令并稍微积极地执行 GC。始终使用成本效益 GC 方法，如果同时启用 ATGC，则将覆盖基于年龄阈值的 GC 方法。gc 紧急中 (3)：在给定的 gc_urgent_sleep_time 时间段内强制执行 GC，并执行中等水平的 I/O 空闲检查。始终使用成本效益 GC 方法，如果同时启用 ATGC，则将覆盖基于年龄阈值的 GC 方法。

/sys/fs/f2fs/<disk>/gc_urgent_sleep_time

定义于文件 sysfs-fs-f2fs

控制 GC 紧急模式的睡眠时间。默认设置为 500 毫秒。

/sys/fs/f2fs/<disk>/gc_valid_thresh_ratio

定义于文件 sysfs-fs-f2fs

它控制有效块比率阈值，以避免对分区设备触发过多的 GC。其初始值为 95(%)。对于有效块超过该比率的段，F2FS 将阻止后台 GC 线程启动 GC。

/sys/fs/f2fs/<disk>/hot_data_age_threshold

定义于文件 sysfs-fs-f2fs

当启用数据分离时，它控制将数据块指示为热数据的年龄阈值。默认情况下，其初始化为 262144 个块（等于 1GB）。

/sys/fs/f2fs/<disk>/idle_interval

定义于文件 sysfs-fs-f2fs

控制系统的空闲时间，如果在给定间隔内没有 FS 操作。默认设置为 5 秒。

/sys/fs/f2fs/<disk>/inject_rate

定义于文件 sysfs-fs-f2fs

控制任意故障的注入率。

/sys/fs/f2fs/<disk>/inject_type

定义于文件 sysfs-fs-f2fs

控制任意故障的注入类型。

/sys/fs/f2fs/<disk>/iostat_enable

定义于文件 sysfs-fs-f2fs

控制启用/禁用 IO 统计信息。

/sys/fs/f2fs/<disk>/iostat_period_ms

定义于文件 sysfs-fs-f2fs

提供一种更改 iostat_period 时间的方法。默认为 3 秒。新的 iostat 跟踪给出了给定时间段的统计信息间隔。

/sys/fs/f2fs/<disk>/ipu_policy

定义于文件 sysfs-fs-f2fs

控制原地更新策略。f2fs 中的更新。用户可以设置

值

策略

描述

0x00

禁用

禁用 IPU（= LFS 模式下的默认选项）

0x01

强制

始终

0x02

SSR

如果 SSR 模式已激活

0x04

UTIL

如果 FS 利用率超过阈值

0x08

SSR_UTIL

如果 SSR 模式已激活且 FS 利用率超过阈值

0x10

FSYNC

仅在 fsync 路径中为高性能闪存存储激活。仅当脏页数超过 min_fsync_blocks 时才会触发 IPU。（=默认选项）

0x20

异步

执行由异步写入请求给定的 IPU

0x40

NOCACHE

禁用 IPU bio 缓存

0x80

HONOR_OPU_WRITE

如果 inode 具有 FI_OPU_WRITE 标志，则优先使用 OPU 写入而不是 IPU 写入

有关详细信息，请参阅 segment.h。

/sys/fs/f2fs/<disk>/last_age_weight

定义于文件 sysfs-fs-f2fs

当启用数据分离时，它控制最后一个数据块年龄的权重。

/sys/fs/f2fs/<disk>/lifetime_write_kbytes

定义于文件 sysfs-fs-f2fs

显示已向磁盘发出的总写入千字节数。

/sys/fs/f2fs/<disk>/main_blkaddr

定义于文件 sysfs-fs-f2fs

显示 MAIN 区域的第一个块地址。

/sys/fs/f2fs/<disk>/max_discard_issue_time

定义于文件 sysfs-fs-f2fs

控制当没有要发出的 discard 操作时，discard 线程将等待的间隔。

/sys/fs/f2fs/<disk>/max_discard_request

定义于文件 sysfs-fs-f2fs

控制线程一次将发出多少 discard。较高的数值将允许 discard 线程更快地完成其工作，但代价是传入 I/O 的延迟更高。

/sys/fs/f2fs/<disk>/max_fragment_chunk

定义于文件 sysfs-fs-f2fs

使用 “mode=fragment:block” 挂载选项，我们可以分散块分配。f2fs 将在一个块中分配 1..<max_fragment_chunk> 个块，并通过轮流创建 1..<max_fragment_hole> 长度的孔。该值可以设置为 1..512 之间，默认值为 4。

/sys/fs/f2fs/<disk>/max_fragment_hole

定义于文件 sysfs-fs-f2fs

使用 “mode=fragment:block” 挂载选项，我们可以分散块分配。f2fs 将在一个块中分配 1..<max_fragment_chunk> 个块，并通过轮流创建 1..<max_fragment_hole> 长度的孔。该值可以设置为 1..512 之间，默认值为 4。

/sys/fs/f2fs/<disk>/max_io_bytes

定义于文件 sysfs-fs-f2fs

这提供了一种控制来限制 f2fs 中的 bio 大小。默认值为零，它将遵循底层块层限制，但是，如果它具有某个字节值，则 f2fs 不会提交大于该大小的 bio。

/sys/fs/f2fs/<disk>/max_ordered_discard

定义于文件 sysfs-fs-f2fs

控制最大有序 discard，单位大小为一个块 (4KB)。默认设置为 16。

/sys/fs/f2fs/<disk>/max_read_extent_count

定义于文件 sysfs-fs-f2fs

它控制每个 inode 的最大读取范围计数，阈值默认值为 10240。

/sys/fs/f2fs/<disk>/max_roll_forward_node_blocks

定义于文件 sysfs-fs-f2fs

控制用于前滚恢复的最大节点块写入次数。这可以限制前滚恢复时间。

/sys/fs/f2fs/<disk>/max_small_discards

定义于文件 sysfs-fs-f2fs

控制由小于 2MB 的小块组成的 discard 命令的发出率。要 discard 的候选项在检查点期间缓存，并在检查点后由 issue_discard 线程发出。默认情况下启用。

定义于文件 sysfs-fs-f2fs

控制在执行 SSR 和清理操作时查找牺牲段的尝试次数。默认值为 4096，涵盖 8GB 块地址范围。

/sys/fs/f2fs/<disk>/mid_discard_issue_time

定义于文件 sysfs-fs-f2fs

控制当有要发出的 discard 且发生 I/O 感知中断时，discard 线程在发出 discard 请求之间等待的间隔。

/sys/fs/f2fs/<disk>/migration_granularity

定义于文件 sysfs-fs-f2fs

控制大型段上垃圾回收的迁移粒度，它可以让 GC 在一个 GC 周期中移动一个段的部分段，从而将繁重的 GC 开销分散到多个轻量级的 GC 开销中。

/sys/fs/f2fs/<disk>/migration_window_granularity

定义于文件 sysfs-fs-f2fs

控制大型段上垃圾回收的迁移窗口粒度。它可以控制 GC 迁移的扫描窗口粒度，以段为单位，而 migration_granularity 控制一次可以迁移的段数。

/sys/fs/f2fs/<disk>/min_discard_issue_time

定义于文件 sysfs-fs-f2fs

控制当有要发出的 discard 且未发生 I/O 感知中断时，discard 线程在发出 discard 请求之间等待的间隔。

/sys/fs/f2fs/<disk>/min_fsync_blocks

定义于文件 sysfs-fs-f2fs

控制原地更新策略的脏页计数条件。

/sys/fs/f2fs/<disk>/min_hot_blocks

定义于文件 sysfs-fs-f2fs

控制重新定义热数据的脏页计数条件。

/sys/fs/f2fs/<disk>/min_ipu_util

定义于文件 sysfs-fs-f2fs

控制就地更新策略的 FS 利用率条件。它被 F2FS_IPU_UTIL 和 F2FS_IPU_SSR_UTIL 策略使用。

/sys/fs/f2fs/<disk>/min_seq_blocks

定义于文件 sysfs-fs-f2fs

控制 writepages 中批量顺序写入的脏页计数条件。

/sys/fs/f2fs/<disk>/min_ssr_sections

定义于文件 sysfs-fs-f2fs

控制触发 SSR 分配的空闲扇区阈值。如果此值较大，则会提前启用 SSR 模式。

/sys/fs/f2fs/<disk>/mounted_time_sec

定义于文件 sysfs-fs-f2fs

显示此分区的挂载时间（秒）。

/sys/fs/f2fs/<disk>/moved_blocks_background

定义于文件 sysfs-fs-f2fs

后台垃圾回收移动的块数。当 CONFIG_F2FS_STAT_FS=y 时可用。

/sys/fs/f2fs/<disk>/moved_blocks_foreground

定义于文件 sysfs-fs-f2fs

前台垃圾回收移动的块数。当 CONFIG_F2FS_STAT_FS=y 时可用。

/sys/fs/f2fs/<disk>/node_io_flag

定义于文件 sysfs-fs-f2fs

提供一种基于温度的位将 REQ_META|FUA 附加到节点写入的方法。现在这些位表示

REQ_META

REQ_FUA

5

4

3

2

1

0

冷

温

热

冷

温

热

/sys/fs/f2fs/<disk>/ovp_segments

定义于文件 sysfs-fs-f2fs

显示过度配置段的数量。

/sys/fs/f2fs/<disk>/peak_atomic_write

定义于文件 sysfs-fs-f2fs

显示启动后当前原子写入块总数的峰值。如果在此处写入“0”，则可以初始化为“0”。

/sys/fs/f2fs/<disk>/pending_discard

定义于文件 sysfs-fs-f2fs

显示队列中待处理的丢弃命令数。

/sys/fs/f2fs/<disk>/ra_nid_pages

定义于文件 sysfs-fs-f2fs

控制要预读的 nid 页数。在构建空闲 nid 时，F2FS 会提前读取 NAT 块以加速。默认值为 0。

/sys/fs/f2fs/<disk>/ram_thresh

定义于文件 sysfs-fs-f2fs

控制空闲 nid 和缓存的 nat 条目使用的内存占用量。默认情况下，设置为 1，表示 10 MB / 1 GB RAM。

/sys/fs/f2fs/<disk>/readdir_ra

定义于文件 sysfs-fs-f2fs

控制 readdir 中的预读 inode 块。默认启用。

/sys/fs/f2fs/<disk>/reclaim_segments

定义于文件 sysfs-fs-f2fs

此参数控制要回收的预空闲段的数量。如果预空闲段的数量大于总卷大小的百分比比例中的段数，则 f2fs 尝试执行检查点以将预空闲段回收为空闲段。默认情况下，占段总数的 5%。

/sys/fs/f2fs/<disk>/reserved_blocks

定义于文件 sysfs-fs-f2fs

控制系统中目标保留块，该阈值是软阈值，可能会超出当前可用用户空间。

/sys/fs/f2fs/<disk>/reserved_segments

定义于文件 sysfs-fs-f2fs

为了微调 GC 行为，我们可以控制保留段的数量。

/sys/fs/f2fs/<disk>/revoked_atomic_block

定义于文件 sysfs-fs-f2fs

显示启动后累积的总撤销原子写入块数。如果在此处写入“0”，则可以初始化为“0”。

/sys/fs/f2fs/<disk>/seq_file_ra_mul

定义于文件 sysfs-fs-f2fs

您可以控制 POSIX_FADV_SEQUENTIAL advise 选项中 bdi 设备预读窗口大小的乘数值，范围为 2（默认值）到 256。

/sys/fs/f2fs/<disk>/stat/cp_status

定义于文件 sysfs-fs-f2fs

实时显示 f2fs 检查点的状态。

cp 标志

值

CP_UMOUNT_FLAG

0x00000001

CP_ORPHAN_PRESENT_FLAG

0x00000002

CP_COMPACT_SUM_FLAG

0x00000004

CP_ERROR_FLAG

0x00000008

CP_FSCK_FLAG

0x00000010

CP_FASTBOOT_FLAG

0x00000020

CP_CRC_RECOVERY_FLAG

0x00000040

CP_NAT_BITS_FLAG

0x00000080

CP_TRIMMED_FLAG

0x00000100

CP_NOCRC_RECOVERY_FLAG

0x00000200

CP_LARGE_NAT_BITMAP_FLAG

0x00000400

CP_QUOTA_NEED_FSCK_FLAG

0x00000800

CP_DISABLED_FLAG

0x00001000

CP_DISABLED_QUICK_FLAG

0x00002000

CP_RESIZEFS_FLAG

0x00004000

/sys/fs/f2fs/<disk>/stat/issued_discard

定义于文件 sysfs-fs-f2fs

显示发出的丢弃命令数。

/sys/fs/f2fs/<disk>/stat/queued_discard

定义于文件 sysfs-fs-f2fs

显示排队的丢弃命令数。

/sys/fs/f2fs/<disk>/stat/sb_status

定义于文件 sysfs-fs-f2fs

实时显示 f2fs 超级块的状态。

值

sb 状态宏

描述

0x1

SBI_IS_DIRTY

检查点的脏标志

0x2

SBI_IS_CLOSE

指定卸载

0x4

SBI_NEED_FSCK

需要 fsck.f2fs 来修复

0x8

SBI_POR_DOING

正在执行恢复

0x10

SBI_NEED_SB_WRITE

需要恢复超级块

0x20

SBI_NEED_CP

需要检查点

0x40

SBI_IS_SHUTDOWN

由 ioctl 关闭

0x80

SBI_IS_RECOVERED

已恢复孤立/数据

0x100

SBI_CP_DISABLED

上次挂载时已禁用 CP

0x200

SBI_CP_DISABLED_QUICK

CP 已快速禁用

0x400

SBI_QUOTA_NEED_FLUSH

需要在 CP 中刷新配额信息

0x800

SBI_QUOTA_SKIP_FLUSH

跳过当前 CP 中的配额刷新

0x1000

SBI_QUOTA_NEED_REPAIR

配额文件可能已损坏

0x2000

SBI_IS_RESIZEFS

resizefs 正在进行中

0x4000

SBI_IS_FREEZING

freefs 正在进行中

/sys/fs/f2fs/<disk>/stat/undiscard_blks

定义于文件 sysfs-fs-f2fs

显示未丢弃的块总数。

/sys/fs/f2fs/<disk>/umount_discard_timeout

定义于文件 sysfs-fs-f2fs

设置在卸载期间发出丢弃命令的超时时间。默认值：5 秒

/sys/fs/f2fs/<disk>/unusable

定义于文件 sysfs-fs-f2fs

如果 checkpoint=disable，则显示不可用的块数。如果 checkpoint=enable，则显示如果设置 checkpoint=disable 将会不可用的块数。

/sys/fs/f2fs/<disk>/unusable_blocks_per_sec

定义于文件 sysfs-fs-f2fs

显示由底层分区设备报告的区域容量定义的扇区中不可用块的数量。

/sys/fs/f2fs/<disk>/warm_data_age_threshold

定义于文件 sysfs-fs-f2fs

当启用数据分离时，它控制指示数据块为热数据的年龄阈值。默认情况下，它初始化为 2621440 个块（等于 10GB）。

/sys/fs/f2fs/features/

定义于文件 sysfs-fs-f2fs

显示所有已启用的内核功能。支持的功能：encryption、block_zoned、extra_attr、project_quota、inode_checksum、flexible_inline_xattr、quota_ino、inode_crtime、lost_found、verity、sb_checksum、casefold、readonly、compression、test_dummy_encryption_v2、atomic_write、pin_file、encrypted_casefold。

/sys/fs/nilfs2/<device>/README

在文件 sysfs-fs-nilfs2 中定义

描述 /sys/fs/nilfs2/<device> 组的属性。

/sys/fs/nilfs2/<device>/blocksize

在文件 sysfs-fs-nilfs2 中定义

以字节为单位显示卷的块大小。

/sys/fs/nilfs2/<device>/checkpoints/README

在文件 sysfs-fs-nilfs2 中定义

描述 /sys/fs/nilfs2/<device>/checkpoints 组的属性。

/sys/fs/nilfs2/<device>/checkpoints/checkpoints_number

在文件 sysfs-fs-nilfs2 中定义

显示卷上的检查点数。

/sys/fs/nilfs2/<device>/checkpoints/last_seg_checkpoint

在文件 sysfs-fs-nilfs2 中定义

显示最新段的检查点号。

/sys/fs/nilfs2/<device>/checkpoints/next_checkpoint

在文件 sysfs-fs-nilfs2 中定义

显示下一个检查点号。

/sys/fs/nilfs2/<device>/checkpoints/snapshots_number

在文件 sysfs-fs-nilfs2 中定义

显示卷上的快照数。

/sys/fs/nilfs2/<device>/device_size

在文件 sysfs-fs-nilfs2 中定义

以字节为单位显示卷大小。

/sys/fs/nilfs2/<device>/free_blocks

在文件 sysfs-fs-nilfs2 中定义

显示卷上空闲块的计数。

/sys/fs/nilfs2/<device>/mounted_snapshots/<id>/README

在文件 sysfs-fs-nilfs2 中定义

描述 /sys/fs/nilfs2/<device>/mounted_snapshots/<id> 组的属性。

/sys/fs/nilfs2/<device>/mounted_snapshots/<id>/blocks_count

在文件 sysfs-fs-nilfs2 中定义

显示快照的块数。

/sys/fs/nilfs2/<device>/mounted_snapshots/<id>/inodes_count

在文件 sysfs-fs-nilfs2 中定义

显示快照的 inode 数。

/sys/fs/nilfs2/<device>/mounted_snapshots/README

在文件 sysfs-fs-nilfs2 中定义

描述 /sys/fs/nilfs2/<device>/mounted_snapshots 组的内容。

/sys/fs/nilfs2/<device>/revision

在文件 sysfs-fs-nilfs2 中定义

显示卷上的 NILFS 文件系统修订版。此值通知有关挂载卷上的元数据结构的修订。

/sys/fs/nilfs2/<device>/segctor/README

在文件 sysfs-fs-nilfs2 中定义

描述 /sys/fs/nilfs2/<device>/segctor 组的属性。

/sys/fs/nilfs2/<device>/segctor/current_last_full_seg

在文件 sysfs-fs-nilfs2 中定义

显示最新完整段的索引号。

/sys/fs/nilfs2/<device>/segctor/current_seg_sequence

在文件 sysfs-fs-nilfs2 中定义

显示段序列计数器。

/sys/fs/nilfs2/<device>/segctor/dirty_data_blocks_count

在文件 sysfs-fs-nilfs2 中定义

显示脏数据块的数量。

/sys/fs/nilfs2/<device>/segctor/last_nongc_write_time

在文件 sysfs-fs-nilfs2 中定义

以人类可读的格式显示上次非清理操作的段写入时间。

/sys/fs/nilfs2/<device>/segctor/last_nongc_write_time_secs

在文件 sysfs-fs-nilfs2 中定义

以秒为单位显示上次非清理操作的段写入时间。

/sys/fs/nilfs2/<device>/segctor/last_pseg_block

在文件 sysfs-fs-nilfs2 中定义

显示最新段的起始块号。

/sys/fs/nilfs2/<device>/segctor/last_seg_checkpoint

在文件 sysfs-fs-nilfs2 中定义

显示最新段的检查点号。

/sys/fs/nilfs2/<device>/segctor/last_seg_sequence

在文件 sysfs-fs-nilfs2 中定义

显示最新段的序列值。

/sys/fs/nilfs2/<device>/segctor/last_seg_write_time

在文件 sysfs-fs-nilfs2 中定义

以人类可读的格式显示上次段的写入时间。

/sys/fs/nilfs2/<device>/segctor/last_seg_write_time_secs

在文件 sysfs-fs-nilfs2 中定义

以秒为单位显示上次段的写入时间。

/sys/fs/nilfs2/<device>/segctor/next_checkpoint

在文件 sysfs-fs-nilfs2 中定义

显示下一个检查点号。

/sys/fs/nilfs2/<device>/segctor/next_full_seg

在文件 sysfs-fs-nilfs2 中定义

显示下一个要使用的完整段索引号。

/sys/fs/nilfs2/<device>/segctor/next_pseg_offset

在文件 sysfs-fs-nilfs2 中定义

显示当前完整段中下一个部分段的偏移量。

/sys/fs/nilfs2/<device>/segments/README

在文件 sysfs-fs-nilfs2 中定义

描述 /sys/fs/nilfs2/<device>/segments 组的属性。

/sys/fs/nilfs2/<device>/segments/blocks_per_segment

在文件 sysfs-fs-nilfs2 中定义

显示段中的块数。

/sys/fs/nilfs2/<device>/segments/clean_segments

在文件 sysfs-fs-nilfs2 中定义

显示干净段的计数。

/sys/fs/nilfs2/<device>/segments/dirty_segments

在文件 sysfs-fs-nilfs2 中定义

显示脏段的计数。

/sys/fs/nilfs2/<device>/segments/segments_number

在文件 sysfs-fs-nilfs2 中定义

显示卷上的段数。

/sys/fs/nilfs2/<device>/superblock/README

在文件 sysfs-fs-nilfs2 中定义

描述 /sys/fs/nilfs2/<device>/superblock 组的属性。

/sys/fs/nilfs2/<device>/superblock/sb_update_frequency

在文件 sysfs-fs-nilfs2 中定义

显示/设置定期更新超级块的间隔（以秒为单位）。

/sys/fs/nilfs2/<device>/superblock/sb_write_count

在文件 sysfs-fs-nilfs2 中定义

显示超级块的当前写入计数。

/sys/fs/nilfs2/<device>/superblock/sb_write_time

在文件 sysfs-fs-nilfs2 中定义

以人类可读的格式显示上次超级块的写入时间。

/sys/fs/nilfs2/<device>/superblock/sb_write_time_secs

在文件 sysfs-fs-nilfs2 中定义

以秒为单位显示上次超级块的写入时间。

/sys/fs/nilfs2/<device>/uuid

在文件 sysfs-fs-nilfs2 中定义

显示卷的 UUID（通用唯一标识符）。

/sys/fs/nilfs2/<device>/volume_name

在文件 sysfs-fs-nilfs2 中定义

显示卷的标签。

/sys/fs/nilfs2/features/README

在文件 sysfs-fs-nilfs2 中定义

描述 /sys/fs/nilfs2/features 组的属性。

/sys/fs/nilfs2/features/revision

在文件 sysfs-fs-nilfs2 中定义

显示 NILFS 文件系统驱动程序的当前修订版。此值通知有关驱动程序准备支持的文件系统修订版。

/sys/fs/ocfs2/

在文件 sysfs-ocfs2 中定义

/sys/fs/ocfs2 目录包含 ocfs2-tools 用于与文件系统交互的旋钮。

/sys/fs/ocfs2/active_cluster_plugin

在文件 sysfs-ocfs2 中定义

/sys/fs/ocfs2/active_cluster_plugin 显示文件系统当前正在使用的集群插件。活动的插件也会出现在 loaded_cluster_plugins 文件中。一次只能使用一个插件。

读取此文件将返回单行显示活动插件的名称。

此文件是只读的。哪个插件处于活动状态取决于正在使用的集群堆栈。当所有文件系统被卸载并且集群堆栈更改时，内容可能会发生变化。

/sys/fs/ocfs2/cluster_stack

在文件 sysfs-ocfs2 中定义

/sys/fs/ocfs2/cluster_stack 文件包含当前 ocfs2 集群堆栈的名称。此值由用户空间工具在使集群堆栈联机时设置。

集群堆栈名称的长度为 4 个字符。

当使用 “o2cb” 集群堆栈时， “o2cb” 集群插件处于活动状态。所有其他集群堆栈都使用 “user” 集群插件。

读取此文件将返回单行显示当前集群堆栈的名称。

向此文件写入新的堆栈名称会更改当前集群堆栈，除非有已挂载的 ocfs2 文件系统。如果有已挂载的文件系统，尝试更改堆栈将返回错误。

用户

ocfs2-tools <ocfs2-tools-devel@lists.linux.dev>

/sys/fs/ocfs2/loaded_cluster_plugins

在文件 sysfs-ocfs2 中定义

/sys/fs/ocfs2/loaded_cluster_plugins 文件描述了支持 ocfs2 集群操作的可用插件。在集群中使用 ocfs2 需要集群插件。目前有两个可用的插件

  • “o2cb” - 自 ocfs2 诞生以来一直使用的经典 o2cb 集群堆栈。

    自诞生以来一直使用。

  • “user” - 支持用户空间集群软件的插件，

    与 fs/dlm 结合使用。

从此文件中读取将返回所有已加载插件的名称，每行一个。

此文件是只读的。其内容可能会随着插件的加载或删除而更改。

/sys/fs/ocfs2/max_locking_protocol

在文件 sysfs-ocfs2 中定义

/sys/fs/ocfs2/max_locking_protocol 文件显示文件系统支持的 ocfs2 锁定版本。此版本涵盖 ocfs2 如何在集群节点之间使用分布式锁定。

协议版本具有主版本号和次版本号。如果两个集群节点具有相同的主版本号和重叠的次版本号，则它们可以互操作 - 因此，只要两者都使用 1.8 协议，版本为 1.10 的节点就可以与使用版本 1.8 的节点互操作。

从此文件中读取将返回单行，其中主版本号和次版本号用句点连接，例如“1.10”。

此文件是只读的。该值已编译到驱动程序中。

/sys/fs/pstore/..

/dev/pstore/..

在文件 pstore 上定义

平台相关的持久存储的通用接口。

提供在系统重启期间保留某些数据的机制的平台可以向该驱动程序注册，以提供一个通用接口来显示在崩溃时刻捕获的记录。在发生 panic 的情况下，会捕获控制台日志的最后一部分，但也可以保存其他有趣的数据

# mount -t pstore -o kmsg_bytes=8000 - /sys/fs/pstore

$ ls -l /sys/fs/pstore/
total 0
-r--r--r-- 1 root root 7896 Nov 30 15:38 dmesg-erst-1

此接口的不同用户将导致不同的文件名。目前定义了两个

  • “dmesg” - 保存的控制台日志

  • “mce” - 来自致命硬件错误的架构相关数据

读取文件中的信息后，删除该文件将向底层持久存储设备发出信号，表明它可以回收空间以供以后重复使用

$ rm /sys/fs/pstore/dmesg-erst-1

期望的是，/sys/fs/pstore/ 中的所有文件都将保存到其他位置，并在启动后不久从持久存储中擦除，以释放空间，为下一次灾难做好准备。

“kmsg_bytes” 挂载选项会更改每次 oops/panic 时保存的目标数据量。Pstore 根据底层持久存储的记录大小保存（可能多个）文件，直到至少达到此数量。默认值为 10 KB。

Pstore 一次仅支持一个后端。如果存在多个后端，可以通过在启动时将 pstore.backend= 参数传递给内核来设置首选后端。

/sys/fs/ubifsX_Y/error_crc

在文件 sysfs-fs-ubifs 上定义

公开 crc 错误：每个节点都嵌入了一个 crc 校验和。

此计数器跟踪具有错误 crc 校验和的节点的访问次数。

该计数器在重新挂载时重置为 0。

/sys/fs/ubifsX_Y/error_magic

在文件 sysfs-fs-ubifs 上定义

公开 magic 错误：每个节点都以一个 magic 数字开头。

此计数器跟踪具有损坏的 magic 数字的节点的访问次数。

该计数器在重新挂载时重置为 0。

/sys/fs/ubifsX_Y/error_node

在文件 sysfs-fs-ubifs 上定义

公开节点错误。每个节点都嵌入了其类型。

此计数器跟踪具有损坏的节点类型的节点的访问次数。

该计数器在重新挂载时重置为 0。

/sys/fs/virtiofs/<n>/device

在文件 sysfs-fs-virtiofs 上定义

指向导出此文件系统的 virtio 设备的符号链接。

/sys/fs/virtiofs/<n>/tag

在文件 sysfs-fs-virtiofs 上定义

[RO] 可用于挂载此文件系统的挂载 “标签”。

/sys/fs/xfs/<disk>/log/log_head_lsn

在文件 sysfs-fs-xfs 上定义

日志当前头部的日志序列号 (LSN)。LSN 以 “循环：基本块” 格式导出。

用户：xfstests

/sys/fs/xfs/<disk>/log/log_tail_lsn

在文件 sysfs-fs-xfs 上定义

日志当前尾部的日志序列号 (LSN)。LSN 以 “循环：基本块” 格式导出。

/sys/fs/xfs/<disk>/log/reserve_grant_head_bytes

在文件 sysfs-fs-xfs 上定义

日志保留授权头部的当前状态。它表示当前所有未完成事务的以字节为单位的总日志保留量。

用户：xfstests

/sys/fs/xfs/<disk>/log/write_grant_head_bytes

在文件 sysfs-fs-xfs 上定义

日志写入授权头部的当前状态。它表示当前所有未完成事务的总日志保留量，包括由于滚动事务导致的重新授权，以字节为单位。

用户：xfstests

/sys/hypervisor 下的符号

/sys/hypervisor/guest_type

在文件 sysfs-hypervisor-xen 上定义

如果在 Xen 下运行：客户机类型：“Xen”：arm 上的标准客户机类型 “HVM”：完全虚拟化客户机 (x86) “PV”：半虚拟化客户机 (x86) “PVH”：没有传统仿真的完全虚拟化客户机 (x86)

/sys/hypervisor/pmu/pmu_features

在文件 sysfs-hypervisor-xen 上定义

如果在 Xen 下运行：描述 Xen PMU 功能（作为整数）。设置位表示已启用相应的功能。有关可用功能，请参见 include/xen/interface/xenpmu.h

/sys/hypervisor/pmu/pmu_mode

在文件 sysfs-hypervisor-xen 上定义

如果在 Xen 下运行：描述 Xen 的性能监视单元 (PMU) 使用的模式。可接受的值为

“off”

PMU 已禁用

“self”

客户机可以分析自身

“hv”

客户机可以分析自身，并且如果是特权客户机（例如 dom0），则可以分析 hypervisor

“all”

客户机可以分析自身、hypervisor 和所有其他客户机。仅适用于特权客户机。

/sys/hypervisor/properties/buildid

在文件 sysfs-hypervisor-xen 上定义

如果在 Xen 下运行：hypervisor 的构建 ID，hypervisor 实时修补所必需。如果 hypervisor 中存在特殊的安全设置，则可能返回 “<denied>”。

/sys/kernel 下的符号

/sys/kernel/address_bit

在文件 sysfs-kernel-address_bits 上定义

正在运行的内核的地址大小（以位为单位）。

访问：读取

用户：util-linux

/sys/kernel/boot_params

在文件 sysfs-kernel-boot_params 上定义

/sys/kernel/boot_params 目录包含两个文件： “data” 和 “version” 以及一个子目录 “setup_data”。它用于将 x86 平台的内核引导参数导出到用户空间，以用于 kexec 和调试目的。

如果 boot_params 中没有 setup_data，则不会创建子目录。

“data” 文件是 struct boot_params 的二进制表示形式。

“version” 文件是引导协议版本的字符串表示形式。

“setup_data” 子目录包含 boot_params 中的 setup_data 数据结构。setup_data 在内核中维护为链接列表。在 “setup_data” 子目录中，每个链接列表节点都有一个子目录，并以列表节点的编号命名。列表节点子目录包含两个文件 “type” 和 “data”。 “type” 文件是 setup_data 类型的字符串表示形式。 “data” 文件是 setup_data 有效负载的二进制表示形式。

整个 boot_params 目录结构如下所示

/sys/kernel/boot_params
|__ data
|__ setup_data
|   |__ 0
|   |   |__ data
|   |   |__ type
|   |__ 1
|       |__ data
|       |__ type
|__ version

用户：Kexec

/sys/kernel/btf

在文件 sysfs-kernel-btf 上定义

包含内核和内核模块的 BTF 类型信息和相关数据。

/sys/kernel/btf/<module-name>

在文件 sysfs-kernel-btf 上定义

只读二进制属性，用于公开内核模块的 BTF 类型信息，作为内核 BTF (/sys/kernel/btf/vmlinux) 的附加内容。

/sys/kernel/btf/vmlinux

在文件 sysfs-kernel-btf 上定义

只读二进制属性，用于公开内核自身的 BTF 类型信息，其中包含所有内部内核类型的描述。有关格式本身的详细说明，请参见 BPF 类型格式 (BTF)。

/sys/kernel/config/most_<component>

在文件 configfs-most 上定义

接口用于配置设备通道并将设备通道连接到组件驱动程序。

仅当挂载 configfs 时，属性才可见。要在 /sys/kernel/config 目录中挂载 configfs，请使用：# mount -t configfs none /sys/kernel/config/

在文件 configfs-most 上定义

属性

buffer_size

配置此通道的缓冲区大小

subbuffer_size

配置此通道的子缓冲区大小（同步和等时数据需要）

num_buffers

配置用于此通道的缓冲区数量

datatype

配置将通过此通道传输的数据类型

direction

配置此链路是输入还是输出

dbr_size

配置 DBR 数据缓冲区大小（仅用于 MediaLB 通信）

packets_per_xact

配置在通过 USB 传输之前将从网络收集的数据包数量（仅用于 USB 通信）

device

要将链路附加到的设备的名称

channel

要将链路附加到的通道的名称

comp_params

传递某些组件所需的参数

create_link

将 “1” 写入此属性以触发链路的创建。在推测性配置的情况下，创建将推迟到物理设备附加到总线时。

destroy_link

将 “1” 写入此属性以销毁活动链路

在文件 configfs-most 上定义

属性

buffer_size

配置此通道的缓冲区大小

subbuffer_size

配置此通道的子缓冲区大小（同步和等时数据需要）

num_buffers

配置用于此通道的缓冲区数量

datatype

配置将通过此通道传输的数据类型

direction

配置此链路是输入还是输出

dbr_size

配置 DBR 数据缓冲区大小（仅用于 MediaLB 通信）

packets_per_xact

配置在通过 USB 传输之前将从网络收集的数据包数量（仅用于 USB 通信）

device

要将链路附加到的设备的名称

channel

要将链路附加到的通道的名称

comp_params

传递某些组件所需的参数

create_link

将 “1” 写入此属性以触发链路的创建。在推测性配置的情况下，创建将推迟到物理设备附加到总线时。

destroy_link

将 “1” 写入此属性以销毁活动链路

/sys/kernel/config/most_sound/<card>

在文件 configfs-most 上定义

属性

create_card

将 “1” 写入此属性以触发向 ALSA 子系统注册声卡。

在文件 configfs-most 上定义

属性

buffer_size

配置此通道的缓冲区大小

subbuffer_size

配置此通道的子缓冲区大小（同步和等时数据需要）

num_buffers

配置用于此通道的缓冲区数量

datatype

配置将通过此通道传输的数据类型

direction

配置此链路是输入还是输出

dbr_size

配置 DBR 数据缓冲区大小（仅用于 MediaLB 通信）

packets_per_xact

配置在通过 USB 传输之前将从网络收集的数据包数量（仅用于 USB 通信）

device

要将链路附加到的设备的名称

channel

要将链路附加到的通道的名称

comp_params

传递某些组件所需的参数

create_link

将 “1” 写入此属性以触发链路的创建。在推测性配置的情况下，创建将推迟到物理设备附加到总线时。

destroy_link

将 “1” 写入此属性以销毁活动链路

在文件 configfs-most 上定义

属性

buffer_size

配置此通道的缓冲区大小

subbuffer_size

配置此通道的子缓冲区大小（同步和等时数据需要）

num_buffers

配置用于此通道的缓冲区数量

datatype

配置将通过此通道传输的数据类型

direction

配置此链路是输入还是输出

dbr_size

配置 DBR 数据缓冲区大小（仅用于 MediaLB 通信）

packets_per_xact

配置在通过 USB 传输之前将从网络收集的数据包数量（仅用于 USB 通信）

device

要将链路附加到的设备的名称

channel

要将链路附加到的通道的名称

comp_params

传递某些组件所需的参数

create_link

将 “1” 写入此属性以触发链路的创建。在推测性配置的情况下，创建将推迟到物理设备附加到总线时。

destroy_link

将 “1” 写入此属性以销毁活动链路

/sys/kernel/config/tsm/report/$name/auxblob

定义在文件 configfs-tsm 中

(只读) TSM 可能发出的可选补充数据，此属性的可见性取决于 TSM，如果没有辅助数据，则可能为空。

当 @provider 为 “sev_guest” 时，此文件包含 SEV-ES Guest-Hypervisor Communication Block Standardization v2.03 第 4.1.8.1 节 MSG_REPORT_REQ 中的 “cert_table”。https://www.amd.com/content/dam/amd/en/documents/epyc-technical-docs/specifications/56421.pdf

/sys/kernel/config/tsm/report/$name/generation

定义在文件 configfs-tsm 中

(只读) 此属性中的值在每次写入 @inblob 或任何选项时都会递增。用户空间可以通过在写入任何属性之前检查 generation，并确保在读取 @outblob 后写入次数与预期匹配来检测冲突，或者可以通过为每个请求上下文创建一个报告实例来防止冲突。

/sys/kernel/config/tsm/report/$name/inblob

定义在文件 configfs-tsm 中

(只写) 最多 64 字节的用户指定二进制数据。为了防止重放攻击，这应该包含一个 nonce，但内核不对内容施加任何限制。

/sys/kernel/config/tsm/report/$name/manifestblob

定义在文件 configfs-tsm 中

(只读) TSM 可能发出的可选补充数据，此属性的可见性取决于 TSM，如果没有 manifest 数据，则可能为空。

有关 manifest blob 的格式信息，请参阅 “service_provider”。

/sys/kernel/config/tsm/report/$name/outblob

定义在文件 configfs-tsm 中

(只读) 从 @inblob 和其他选项生成的二进制证明报告。报告的格式是特定于实现的，其中实现通过 @provider 属性传达。

/sys/kernel/config/tsm/report/$name/privlevel

定义在文件 configfs-tsm 中

(只写) 如果 TSM 实现提供程序支持为在不同特权级别运行的 TVM 生成证明报告的概念（如 SEV-SNP “VMPL”），则此属性可见，通过此属性指定特权级别。最小可接受值通过 @privlevel_floor 传达，最大可接受值为 TSM_PRIVLEVEL_MAX (3)。

/sys/kernel/config/tsm/report/$name/privlevel_floor

定义在文件 configfs-tsm 中

(只读) 表示可以写入 @privlevel 的最小允许值。

/sys/kernel/config/tsm/report/$name/provider

定义在文件 configfs-tsm 中

(只读) @outblob 的格式规范的名称，例如短期内的 “sev_guest” [1] 或 “tdx_guest” [2]，或者将来的通用标准格式。

[1]: SEV Secure Nested Paging Firmware ABI Specification Revision 1.55 表 22 https://www.amd.com/content/dam/amd/en/documents/epyc-technical-docs/specifications/56860.pdf

[2]: Intel® Trust Domain Extensions Data Center Attestation Primitives : Quote Generation Library and Quote Verification Library Revision 0.8 附录 4,5 https://download.01.org/intel-sgx/latest/dcap-latest/linux/docs/Intel_TDX_DCAP_Quoting_Library_API.pdf

/sys/kernel/config/tsm/report/$name/service_guid

定义在文件 configfs-tsm 中

(只写) 如果 TSM 实现提供程序支持从 TVM 的服务提供程序（例如，在 SVSM 下运行的 SEV-SNP）生成证明报告的概念，则此属性可见。指定一个空的/空 GUID (00000000-0000-0000-0000-000000) 请求将服务提供程序中的所有活动服务都包含在证明报告中。指定 GUID 请求仅指定服务的证明报告，使用 service_manifest_version 属性指定的 manifest 格式。

有关服务 GUID 格式的信息，请参阅“service_provider”。

/sys/kernel/config/tsm/report/$name/service_manifest_version

定义在文件 configfs-tsm 中

(只写) 如果 TSM 实现提供程序支持从 TVM 的服务提供程序（例如，在 SVSM 下运行的 SEV-SNP）生成证明报告的概念，则此属性可见。指示请求用于证明报告的服务 manifest 版本（默认值为 0）。如果用户未设置此字段，则返回服务的默认 manifest 版本（服务的初始/第一个 manifest 版本）。

有关服务 manifest 版本格式的信息，请参阅“service_provider”。

/sys/kernel/config/tsm/report/$name/service_provider

定义在文件 configfs-tsm 中

(只写) 如果 TSM 实现提供程序支持从 TVM 的服务提供程序（例如，在 SVSM 下运行的 SEV-SNP）生成证明报告的概念，则此属性可见。通过此属性指定服务提供程序将按照服务提供程序的指定创建证明报告。目前唯一支持的服务提供程序是“svsm”。

对于 “svsm” 服务提供程序，请参阅 SEV-SNP Guests v1.00 的安全 VM 服务模块第 7 节。对于该文档，请搜索 “site:amd.com “Secure VM Service Module for SEV-SNP Guests”, docID: 58019”

/sys/kernel/cpu_byteorder

定义在文件 sysfs-kernel-cpu_byteorder 中

正在运行的内核的字节序。

访问：读取

有效值

“little”，“big”

用户：util-linux

/sys/kernel/debug/<cros-ec-device>/console_log

定义在文件 debugfs-cros-ec 中

如果 EC 支持 CONSOLE_READ 命令类型，则可以使用此文件来获取 EC 日志。内核轮询日志并保留自己的缓冲区，但用户空间应获取此日志并将其写入某些日志。

/sys/kernel/debug/<cros-ec-device>/last_resume_result

定义在文件 debugfs-cros-ec 中

某些 EC 具有一个功能，它们会跟踪到（Intel）处理器的 SLP_S0 线的转换，以便检测系统未能进入 S0ix 的情况。当系统恢复时，具有此功能的 EC 将返回发生的 SLP_S0 转换的摘要。last_resume_result 文件返回 AP 的恢复消息到 EC 的最新响应。

低 31 位包含自收到挂起消息以来发生的 SLP_S0 转换次数的计数。如果 EC 在监视 SLP_S0 转换时由于超时而尝试唤醒系统，则设置位 31。调用者可以使用它来检测由于 S0ix 超时而从 EC 唤醒。如果没有尝试挂起转换，或者 EC 不支持此功能，则结果将为零。

输出格式为：“0x%08xn”。

/sys/kernel/debug/<cros-ec-device>/panicinfo

定义在文件 debugfs-cros-ec 中

此文件转储上次重启的 EC 崩溃信息。仅当 EC 支持 PANIC_INFO 命令类型时，此文件才存在。

/sys/kernel/debug/<cros-ec-device>/pdinfo

定义在文件 debugfs-cros-ec 中

此文件提供所有可用的 USB PD/type-C 端口的端口角色、多路复用器和电源调试信息。如果没有可用的端口，此文件将只是一个空文件。

/sys/kernel/debug/<cros-ec-device>/suspend_timeout_ms

定义在文件 debugfs-cros-ec 中

某些 EC 具有一个功能，它们会跟踪硬件控制的睡眠线（例如 Intel 的 SLP_S0 线）的转换，以便检测系统未能进入深度睡眠状态的情况。suspend_timeout_ms 文件控制 EC 在声明睡眠超时事件并尝试唤醒系统之前等待的时间（以毫秒为单位）。

提供 0 以使用编码到 EC 固件中的默认值。提供 65535 (EC_HOST_SLEEP_TIMEOUT_INFINITE) 以禁用 EC 睡眠故障检测机制。介于 0 和 65535 之间的值表示 EC 在睡眠转换后应等待的时间（以毫秒为单位），然后再声明超时。这包括在收到睡眠命令之后但在硬件线路更改之前的持续时间，以及硬件线路更改和内核发送 EC 恢复命令之间的持续时间。

输出格式为：“%un”。

/sys/kernel/debug/<cros-ec-device>/uptime

定义在文件 debugfs-cros-ec 中

一个 u32，提供自 EC 启动以来的时间（以毫秒为单位）。这用于将 AP 主机时间与 EC 日志同步。如果 EC 不支持该命令或存在通信问题，则返回错误。

/sys/kernel/debug/accel/<parent_device>/addr

定义在文件 debugfs-driver-habanalabs 中

设置用于通过 PCI bar 读取或写入的设备地址，或者要直接从主机读取或写入的主机映射内存的设备 VA。仅当 IOMMU 被禁用时才允许后一个选项。可接受的值是以 “0x” 开头的字符串。

/sys/kernel/debug/accel/<parent_device>/clk_gate

定义在文件 debugfs-driver-habanalabs 中

此设置现已弃用，因为时钟门控完全由固件处理

/sys/kernel/debug/accel/<parent_device>/command_buffers

定义在文件 debugfs-driver-habanalabs 中

显示有关当前分配的命令缓冲区的信息列表

/sys/kernel/debug/accel/<parent_device>/command_submission

定义在文件 debugfs-driver-habanalabs 中

显示有关当前活动命令提交的信息列表

/sys/kernel/debug/accel/<parent_device>/command_submission_jobs

定义在文件 debugfs-driver-habanalabs 中

显示有关每个活动命令提交的每个作业 (CB) 的详细信息列表

/sys/kernel/debug/accel/<parent_device>/data32

定义在文件 debugfs-driver-habanalabs 中

允许 root 用户直接通过设备的 PCI bar 读取或写入。写入此文件会生成写入事务，而读取此文件会生成读取事务。需要此自定义接口（而不是使用通用的 Linux 用户空间 PCI 映射），因为 DDR bar 与 DDR 内存相比非常小，并且只有驱动程序才能在事务之前和之后移动 bar。

如果 IOMMU 被禁用，它还允许 root 用户从主机读取或写入主机映射内存的设备 VA

/sys/kernel/debug/accel/<parent_device>/data64

定义在文件 debugfs-driver-habanalabs 中

允许 root 用户直接通过设备的 PCI bar 读取或写入 64 位数据。写入此文件会生成写入事务，而读取此文件会生成读取事务。需要此自定义接口（而不是使用通用的 Linux 用户空间 PCI 映射），因为 DDR bar 与 DDR 内存相比非常小，并且只有驱动程序才能在事务之前和之后移动 bar。

如果 IOMMU 被禁用，它还允许 root 用户从主机读取或写入主机映射内存的设备 VA

/sys/kernel/debug/accel/<parent_device>/data_dma

定义在文件 debugfs-driver-habanalabs 中

允许 root 用户通过 DMA 引擎从设备的内部内存（DRAM/SRAM）读取。此属性是一个二进制 blob，其中包含 DMA 传输的结果。需要此自定义接口（而不是使用通用的 Linux 用户空间 PCI 映射），因为内部内存量非常大（>32GB），并且通过 PCI bar 读取它将花费很长时间。此接口不支持在同一设备中并发。在 GAUDI 和 GOYA 中，如果在设备执行用户工作负载时完成此操作，则此操作可能会导致未定义的行为。目前仅在 GAUDI 上支持。

/sys/kernel/debug/accel/<parent_device>/device

定义在文件 debugfs-driver-habanalabs 中

使 root 用户能够将设备设置为特定状态。有效值为“disable”、“enable”、“suspend”、“resume”。用户可以读取此属性以查看有效值

/sys/kernel/debug/accel/<parent_device>/device_release_watchdog_timeout

定义在文件 debugfs-driver-habanalabs 中

在某些错误情况下设备释放的看门狗超时值（以秒为单位），此后将重置设备。

/sys/kernel/debug/accel/<parent_device>/dma_size

定义在文件 debugfs-driver-habanalabs 中

指定使用 DMA 从设备的内部内存读取时 DMA 事务的大小。该值不能大于 128MB。写入此值将启动 DMA 传输。写入完成后，用户可以读取 “data_dma” blob

/sys/kernel/debug/accel/<parent_device>/dump_razwi_events

定义在文件 debugfs-driver-habanalabs 中

如果存在，则将所有 razwi 事件转储到 dmesg。读取现有事件的状态寄存器后，例程将清除状态寄存器。用法：cat dump_razwi_events

/sys/kernel/debug/accel/<parent_device>/dump_security_violations

定义在文件 debugfs-driver-habanalabs 中

将所有安全违规转储到 dmesg。这也会确认所有安全违规，这意味着用户下次调用此 API 时不会转储这些违规

/sys/kernel/debug/accel/<parent_device>/engines

定义在文件 debugfs-driver-habanalabs 中

显示设备引擎及其派生的空闲状态的状态寄存器值

/sys/kernel/debug/accel/<parent_device>/i2c_addr

定义在文件 debugfs-driver-habanalabs 中

为设备的 CPU 生成的 I2C 事务设置 I2C 设备地址，当设备加载安全固件时不可用

/sys/kernel/debug/accel/<parent_device>/i2c_bus

定义在文件 debugfs-driver-habanalabs 中

为设备的 CPU 生成的 I2C 事务设置 I2C 总线地址，当设备加载安全固件时不可用

/sys/kernel/debug/accel/<parent_device>/i2c_data

定义在文件 debugfs-driver-habanalabs 中

触发设备 CPU 生成的 I2C 事务。写入此文件会生成写入事务，而读取此文件会生成读取事务。当设备加载安全固件时不可用。

/sys/kernel/debug/accel/<parent_device>/i2c_len

定义在文件 debugfs-driver-habanalabs 中

设置设备 CPU 生成的 I2C 事务的 I2C 长度（以字节为单位）。当设备加载安全固件时不可用。

/sys/kernel/debug/accel/<parent_device>/i2c_reg

定义在文件 debugfs-driver-habanalabs 中

设置设备 CPU 生成的 I2C 事务的 I2C 寄存器 ID。当设备加载安全固件时不可用。

/sys/kernel/debug/accel/<parent_device>/led0

定义在文件 debugfs-driver-habanalabs 中

设置设备上第一个 S/W LED 的状态。当设备加载安全固件时不可用。

/sys/kernel/debug/accel/<parent_device>/led1

定义在文件 debugfs-driver-habanalabs 中

设置设备上第二个 S/W LED 的状态。当设备加载安全固件时不可用。

/sys/kernel/debug/accel/<parent_device>/led2

定义在文件 debugfs-driver-habanalabs 中

设置设备上第三个 S/W LED 的状态。当设备加载安全固件时不可用。

/sys/kernel/debug/accel/<parent_device>/memory_scrub

定义在文件 debugfs-driver-habanalabs 中

允许 root 用户擦除 DRAM 内存。可以使用 debugfs 文件 memory_scrub_val 设置擦除值。

/sys/kernel/debug/accel/<parent_device>/memory_scrub_val

定义在文件 debugfs-driver-habanalabs 中

当用户使用 ‘memory_scrub’ debugfs 文件擦除 DRAM 时，DRAM 将被设置为此值，并且在使用模块参数 ‘memory_scrub’ 时的擦除值。

/sys/kernel/debug/accel/<parent_device>/mmu

定义在文件 debugfs-driver-habanalabs 中

显示给定 ASID 和虚拟地址的跳转值和物理地址。用户应将 ASID 和 VA 写入文件，然后读取文件以获取结果。例如，要显示 ASID 为 1 的 VA 0x1000 的信息，您需要执行以下操作：echo “1 0x1000” > /sys/kernel/debug/accel/<parent_device>/mmu

/sys/kernel/debug/accel/<parent_device>/mmu_error

定义在文件 debugfs-driver-habanalabs 中

检查并显示 mmu_cap_mask 中指定的所有 MMU 的页面错误或访问冲突 MMU 错误。例如，要显示 MMU 硬件功能位 9 的错误信息，您需要执行以下操作：echo “0x200” > /sys/kernel/debug/accel/<parent_device>/mmu_error cat /sys/kernel/debug/accel/<parent_device>/mmu_error

/sys/kernel/debug/accel/<parent_device>/monitor_dump

定义在文件 debugfs-driver-habanalabs 中

允许 root 用户从设备的受保护配置空间转储监视器状态。此属性是一个二进制 blob，其中包含监视器寄存器转储的结果。需要此自定义接口（而不是使用通用的 Linux 用户空间 PCI 映射），因为此空间受保护，无法使用 PCI 读取访问。此接口不支持同一设备中的并发。仅在 GAUDI 上受支持。

/sys/kernel/debug/accel/<parent_device>/monitor_dump_trig

定义在文件 debugfs-driver-habanalabs 中

触发监视器数据转储。触发操作的值必须为 1。触发监视器转储操作会启动所有监视器的当前寄存器值的转储。写入完成后，用户可以读取 “monitor_dump” blob。

/sys/kernel/debug/accel/<parent_device>/server_type

定义在文件 debugfs-driver-habanalabs 中

公开设备的服务器类型，映射到枚举 hl_server_type。

/sys/kernel/debug/accel/<parent_device>/set_power_state

定义在文件 debugfs-driver-habanalabs 中

设置 PCI 电源状态。有效值为 D0 的 “1” 和 D3Hot 的 “2”。

/sys/kernel/debug/accel/<parent_device>/skip_reset_on_timeout

定义在文件 debugfs-driver-habanalabs 中

设置设备超时时跳过重置选项。值为 “0” 表示如果某些 CS 超时，设备将被重置，否则将不会被重置。

/sys/kernel/debug/accel/<parent_device>/state_dump

定义在文件 debugfs-driver-habanalabs 中

获取 CS 超时或失败时发生的状态转储。状态转储用于调试，并且每次在 CS 执行出现问题时（在重置之前）创建。从节点读取将返回最新的可用状态转储。写入整数 X 将丢弃 X 个状态转储，以便下次读取将返回第 X+1 个最新的状态转储。

/sys/kernel/debug/accel/<parent_device>/stop_on_err

定义在文件 debugfs-driver-habanalabs 中

设置设备引擎的 stop-on_error 选项。值为 “0” 表示禁用，否则启用。仅对 GOYA 和 GAUDI 有效。

/sys/kernel/debug/accel/<parent_device>/timeout_locked

定义在文件 debugfs-driver-habanalabs 中

设置命令提交超时值（以秒为单位）。

/sys/kernel/debug/accel/<parent_device>/userptr

定义在文件 debugfs-driver-habanalabs 中

显示当前固定并映射到 DMA 地址的用户指针（用户虚拟地址）的信息列表

/sys/kernel/debug/accel/<parent_device>/userptr_lookup

定义在文件 debugfs-driver-habanalabs 中

允许搜索固定并映射到 DMA 地址的特定用户指针（用户虚拟地址），并查看它们到特定 DMA 地址的解析。

/sys/kernel/debug/accel/<parent_device>/vm

定义在文件 debugfs-driver-habanalabs 中

显示每个 ASID 的所有活动虚拟地址映射以及所有 HW 块的用户映射的信息列表

/sys/kernel/debug/cec/*/error-inj

在文件 debugfs-cec-error-inj 中定义

CEC 框架允许通过 debugfs 使用 CEC 错误注入命令。支持此功能的驱动程序将创建一个 error-inj 文件，可以通过该文件给出错误注入命令。

基本语法如下：

忽略前导空格/制表符。如果下一个字符是 ‘#’ 或已到达行尾，则将忽略整行。否则，需要一个命令。

由驱动程序决定要实现哪些命令。唯一的例外是必须实现没有任何参数的命令 ‘clear’，并且它将删除所有当前的错误注入命令。

这确保您始终可以执行 ‘echo clear >error-inj’ 来清除任何错误注入，而无需了解驱动程序特定命令的详细信息。

请注意，‘error-inj’ 的输出应作为 ‘error-inj’ 的有效输入。因此，这必须有效：

$ cat error-inj >einj.txt
$ cat einj.txt >error-inj

除了上述基本规则外，此 ABI 不被认为是稳定的，并且将来可能会更改。

实现此功能的驱动程序必须将命令记录为 CEC 文档的一部分，并且在进行更改时必须保持该文档的更新。

存在以下 CEC 错误注入实现：

/sys/kernel/debug/cxl/$dport_dev/einj_inject

在文件 debugfs-cxl 中定义

(WO) 向此文件写入整数会将相应的 CXL 协议错误注入到 $dport_dev 中（$dport_dev 将是来自 /sys/bus/pci/devices 的设备名称）。可以通过读取 einj_types 找到要注入的整数到类型的映射。如果 dport 以 RCH 模式枚举，则注入 CXL 1.1 错误，否则注入 CXL 2.0 错误。

/sys/kernel/debug/cxl/einj_types

在文件 debugfs-cxl 中定义

(RO) 以以下格式打印平台提供的 CXL 协议错误类型：

0x<错误编号> <错误类型>

可能的错误类型（截至 ACPI v6.5）为：

0x1000 CXL.cache 协议可纠正 0x2000 CXL.cache 协议不可纠正（非致命）0x4000 CXL.cache 协议不可纠正（致命）0x8000 CXL.mem 协议可纠正 0x10000 CXL.mem 协议不可纠正（非致命）0x20000 CXL.mem 协议不可纠正（致命）

<错误编号> 可以写入 einj_inject 以将 <错误类型> 注入到选定的 dport。

/sys/kernel/debug/cxl/memX/inject_poison

在文件 debugfs-cxl 中定义

(WO) 当向此属性写入设备物理地址 (DPA) 时，memdev 驱动程序会向设备发送针对指定地址的注入毒命令。DPA 必须是 64 字节对齐的，并且注入的毒的长度为 64 字节。如果成功，当通过 CXL.mem 总线访问该地址时，设备将返回毒。注入毒会将该地址添加到设备的毒列表，并且错误源设置为 Injected。此外，设备还会向其内部信息事件日志添加毒创建事件，更新事件状态寄存器，并在配置时中断主机。将毒注入已存在毒的地址不是错误，并且不会返回任何错误。如果设备返回 ‘Inject Poison Limit Reached’，则会向用户返回 -EBUSY 错误。inject_poison 属性仅对支持该功能的设备可见。

/sys/kernel/debug/dcc/.../[list-number]/config

在文件 debugfs-driver-dcc 中定义

此文件存储在发生硬件崩溃或手动软件触发时可以读取的寄存器的地址。输入地址类型可以是以下 dcc 指令之一：read、write、read-write 和 loop 类型。列表需要按顺序配置，而不是以重叠方式配置；例如，用户只有在配置并启用列表 y 后才能跳转到列表 x。每种类型的输入格式如下：

  1. 读取指令

    echo R <addr> <n> <bus> >/sys/kernel/debug/dcc/../[list-number]/config

    其中

    <addr>

    要读取的地址。

    <n>

    从地址 <1> 开始的地址字数。每个字是 32 位（4 字节）。如果省略，则默认为 1。

    <bus type>

    总线类型，可以是 ‘apb’ 或 ‘ahb’。如果省略，则默认为 ‘ahb’。

  2. 写入指令

    echo W <addr> <n> <bus type> > /sys/kernel/debug/dcc/../[list-number]/config

    其中

    <addr>

    要写入的地址。

    <n>

    要写入 <addr> 的值。

    <bus type>

    总线类型，可以是 ‘apb’ 或 ‘ahb’。

  3. 读写指令

    echo RW <addr> <n> <mask> > /sys/kernel/debug/dcc/../[list-number]/config

    其中

    <addr>

    要读取和写入的地址。

    <n>

    要写入 <addr> 的值。

    <mask>

    值掩码。

  4. 循环指令

    echo L <loop count> <address count> <address>... > /sys/kernel/debug/dcc/../[list-number]/config

    其中

    <loop count>

    迭代次数

    <address count>

    要写入的总地址数

    <address>

    以空格分隔的地址列表。

/sys/kernel/debug/dcc/.../[list-number]/enable

在文件 debugfs-driver-dcc 中定义

此 debugfs 接口用于启用 dcc 硬件。名为 “enable” 的文件位于列表编号的目录中，用户可以通过向文件写入布尔值（1 或 0）来启用/禁用特定列表。

在启用 dcc 时，用户为相应列表指定的所有地址都将写入 dcc sram，dcc 硬件在手动或崩溃触发时读取该 sram。列表必须按顺序配置和启用，例如，只有在列表 1 启用后才能启用列表 2。

/sys/kernel/debug/dcc/.../config_reset

在文件 debugfs-driver-dcc 中定义

此文件用于将 dcc 驱动程序的配置重置为默认配置。当向该文件写入 ‘1’ 时，驱动程序中存储的所有先前地址都将被删除，并且用户需要再次重新配置地址。

/sys/kernel/debug/dcc/.../ready

在文件 debugfs-driver-dcc 中定义

此文件用于检查dcc硬件是否已准备好接收用户配置。此处的 “Y” 表示 dcc 已准备就绪。

/sys/kernel/debug/dcc/.../trigger

在文件 debugfs-driver-dcc 中定义

这是用于手动软件触发的 debugfs 接口。可以通过向该文件写入“1”来调用触发器。

/sys/kernel/debug/dell-wmi-ddv-<wmi_device_name>/fan_sensor_information

定义在文件 debugfs-dell-wmi-ddv

此文件包含风扇传感器信息缓冲区的内容，其中包含风扇传感器条目和一个终止字符 (0xFF)。

每个风扇传感器条目包含

  • 风扇类型（单字节）

  • 风扇转速，单位为 RPM（双字节，小端序）

有关详细信息，请参阅 戴尔 DDV WMI 接口驱动程序 (dell-wmi-ddv)。

/sys/kernel/debug/dell-wmi-ddv-<wmi_device_name>/thermal_sensor_information

定义在文件 debugfs-dell-wmi-ddv

此文件包含热传感器信息缓冲区的内容，其中包含热传感器条目和一个终止字符 (0xFF)。

每个热传感器条目包含

  • 热类型（单字节）

  • 当前温度（单字节）

  • 最低温度（单字节）

  • 最高温度（单字节）

  • 未知字段（单字节）

有关详细信息，请参阅 戴尔 DDV WMI 接口驱动程序 (dell-wmi-ddv)。

/sys/kernel/debug/ec/*/{gpe,use_global_lock,io}

定义在文件 debugfs-ec

一般信息，例如分配给 EC 的 GPE 以及是否应使用全局锁。知道 EC GPE 后，可以在此处监视与 EC 相关的 HW 事件数量（XY -> 来自 /sys/kernel/debug/ec/*/gpe 的 GPE 编号）：/sys/firmware/acpi/interrupts/gpeXY

io 文件是二进制文件，应使用此处的用户空间工具：ftp://ftp.suse.com/pub/people/trenn/sources/ec/ 来读取 256 个嵌入式控制器寄存器或写入它们。

警告

如果您不知道自己在做什么，请不要写入嵌入式控制器！之后重新启动也是一个好主意。这可能会影响您的机器的冷却方式，并且在您进行错误的写入后，风扇可能不会再次打开。

/sys/kernel/debug/genwqe/genwqe<n>_card/curr_dbg_uid0

定义在文件 debugfs-driver-genwqe

UID0（单元 ID 0）的内部芯片状态。仅适用于 PF。

/sys/kernel/debug/genwqe/genwqe<n>_card/curr_dbg_uid1

定义在文件 debugfs-driver-genwqe

UID1 的内部芯片状态。仅适用于 PF。

/sys/kernel/debug/genwqe/genwqe<n>_card/curr_dbg_uid2

定义在文件 debugfs-driver-genwqe

UID2 的内部芯片状态。仅适用于 PF。

/sys/kernel/debug/genwqe/genwqe<n>_card/curr_regs

定义在文件 debugfs-driver-genwqe

当前错误寄存器的转储。仅适用于 PF。

/sys/kernel/debug/genwqe/genwqe<n>_card/ddcb_info

定义在文件 debugfs-driver-genwqe

用于调试排队问题的 DDCB 队列转储。

/sys/kernel/debug/genwqe/genwqe<n>_card/err_inject

定义在文件 debugfs-driver-genwqe

注入错误案例以确保驱动程序的错误处理代码正常工作的可能性。

/sys/kernel/debug/genwqe/genwqe<n>_card/info

定义在文件 debugfs-driver-genwqe

比特流版本和软件版本的综合摘要。使用的比特流和比特流时钟信息。

/sys/kernel/debug/genwqe/genwqe<n>_card/jobtimer

定义在文件 debugfs-driver-genwqe

PF 和 VF 的转储作业超时寄存器值。仅适用于 PF。

/sys/kernel/debug/genwqe/genwqe<n>_card/prev_dbg_uid0

定义在文件 debugfs-driver-genwqe

卡复位前 UID0 的内部芯片状态。仅适用于 PF。

/sys/kernel/debug/genwqe/genwqe<n>_card/prev_dbg_uid1

定义在文件 debugfs-driver-genwqe

卡复位前 UID1 的内部芯片状态。仅适用于 PF。

/sys/kernel/debug/genwqe/genwqe<n>_card/prev_dbg_uid2

定义在文件 debugfs-driver-genwqe

卡复位前 UID2 的内部芯片状态。仅适用于 PF。

/sys/kernel/debug/genwqe/genwqe<n>_card/prev_regs

定义在文件 debugfs-driver-genwqe

卡上次复位之前发生的错误寄存器的转储。仅适用于 PF。

/sys/kernel/debug/genwqe/genwqe<n>_card/queue_working_time

定义在文件 debugfs-driver-genwqe

PF 和 VF 的转储队列工作时间寄存器值。仅适用于 PF。

/sys/kernel/debug/genwqe/genwqe<n>_card/vf<0..14>_jobtimeout_msec

定义在文件 debugfs-driver-genwqe

默认 VF 超时时间为 250 毫秒。测试可能需要 1000 毫秒。使用 0 将使用卡的默认值（无论该值是什么）。

超时时间取决于系统中可用卡的最大数量和允许的最大队列大小。

驱动程序确保在启用 VF 之前完成设置。无法在飞行中更改超时。仅适用于 PF。

/sys/kernel/debug/hisi_hpre/<bdf>/alg_qos

定义在文件 debugfs-hisi-hpre

<bdf> 与 PF 和 VF 的功能相关。HPRE 驱动程序支持配置每个功能的 QoS，驱动程序支持将 <bdf> 值写入主机中的 alg_qos。例如 “echo <bdf> value > alg_qos”。qos 值介于 1~1000 之间，表示总 QoS 的 1/1000~1000/1000。驱动程序读取 alg_qos 以获取主机和 VM 中的相关 QoS，例如 “cat alg_qos”。

/sys/kernel/debug/hisi_hpre/<bdf>/cap_regs

定义在文件 debugfs-hisi-hpre

转储 qm 和 hpre 功能位寄存器的值，并支持设备规格的查询，以方便进行故障定位。PF 和 VF 均可用，并且对 HPRE 没有其他影响。

/sys/kernel/debug/hisi_hpre/<bdf>/cluster[0-3]/cluster_ctrl

定义在文件 debugfs-hisi-hpre

将集群中的 HPRE 核心选择写入此文件，然后我们可以读取该核心的调试信息。仅适用于 PF。

/sys/kernel/debug/hisi_hpre/<bdf>/cluster[0-3]/regs

定义在文件 debugfs-hisi-hpre

从 HPRE 集群转储调试寄存器。仅适用于 PF。

/sys/kernel/debug/hisi_hpre/<bdf>/current_qm

定义在文件 debugfs-hisi-hpre

一个 HPRE 控制器有一个 PF 和多个 VF，每个功能都有一个 QM。选择以下 qm 引用的 QM。仅适用于 PF。

/sys/kernel/debug/hisi_hpre/<bdf>/hpre_dfx/diff_regs

定义在文件 debugfs-hisi-hpre

HPRE 调试寄存器（regs）读取硬件寄存器值。此节点用于显示寄存器值的更改。此节点可以帮助用户检查寄存器值的更改。

/sys/kernel/debug/hisi_hpre/<bdf>/hpre_dfx/invalid_req_cnt

定义在文件 debugfs-hisi-hpre

转储收到的无效请求的总数。PF 和 VF 均可用，并且对 HPRE 没有其他影响。

/sys/kernel/debug/hisi_hpre/<bdf>/hpre_dfx/over_thrhld_cnt

定义在文件 debugfs-hisi-hpre

转储超时请求的总数。PF 和 VF 均可用，并且对 HPRE 没有其他影响。

/sys/kernel/debug/hisi_hpre/<bdf>/hpre_dfx/overtime_thrhld

定义在文件 debugfs-hisi-hpre

设置用于计数处理时间超过阈值的请求的阈值时间。0：禁用（默认），1：1 微秒。PF 和 VF 均可用，并且对 HPRE 没有其他影响。

/sys/kernel/debug/hisi_hpre/<bdf>/hpre_dfx/recv_cnt

定义在文件 debugfs-hisi-hpre

转储收到的请求总数。PF 和 VF 均可用，并且对 HPRE 没有其他影响。

/sys/kernel/debug/hisi_hpre/<bdf>/hpre_dfx/send_busy_cnt

定义在文件 debugfs-hisi-hpre

转储返回繁忙状态的发送请求总数。PF 和 VF 均可用，并且对 HPRE 没有其他影响。

/sys/kernel/debug/hisi_hpre/<bdf>/hpre_dfx/send_cnt

定义在文件 debugfs-hisi-hpre

转储发送的请求总数。PF 和 VF 均可用，并且对 HPRE 没有其他影响。

/sys/kernel/debug/hisi_hpre/<bdf>/hpre_dfx/send_fail_cnt

定义在文件 debugfs-hisi-hpre

转储完成但出现错误的请求总数。PF 和 VF 均可用，并且对 HPRE 没有其他影响。

/sys/kernel/debug/hisi_hpre/<bdf>/qm/abnormal_irq

定义在文件 debugfs-hisi-hpre

转储 QM 异常事件的中断次数。PF 和 VF 均可用，并且对 HPRE 没有其他影响。

/sys/kernel/debug/hisi_hpre/<bdf>/qm/aeq_irq

定义在文件 debugfs-hisi-hpre

转储 QM 异步事件队列中断的次数。PF 和 VF 均可用，并且对 HPRE 没有其他影响。

/sys/kernel/debug/hisi_hpre/<bdf>/qm/clear_enable

定义在文件 debugfs-hisi-hpre

QM 调试寄存器 (regs) 读取清除控制。1 表示启用寄存器读取清除，否则为 0。写入此文件没有功能效果，仅启用或禁用读取这些寄存器后清除计数器。仅适用于 PF。

/sys/kernel/debug/hisi_hpre/<bdf>/qm/create_qp_err

定义在文件 debugfs-hisi-hpre

转储队列分配错误的数量。PF 和 VF 均可用，并且对 HPRE 没有其他影响。

/sys/kernel/debug/hisi_hpre/<bdf>/qm/current_q

定义在文件 debugfs-hisi-hpre

一个 QM 可能包含多个队列。选择特定的队列以在上述 regs 中显示其调试寄存器。仅适用于 PF。

/sys/kernel/debug/hisi_hpre/<bdf>/qm/dev_state

定义在文件 debugfs-hisi-hpre

转储 QM 的停止队列状态。默认值为 0，如果设置了 dev_timeout，则当停止队列失败时，dev_state 将返回非零值。PF 和 VF 均可用，并且对 HPRE 没有其他影响。

/sys/kernel/debug/hisi_hpre/<bdf>/qm/dev_timeout

定义在文件 debugfs-hisi-hpre

设置停止队列失败时的等待时间。PF 和 VF 均可用，并且对 HPRE 没有其他影响。0：不等待（默认），其他值：等待 dev_timeout * 20 微秒。

/sys/kernel/debug/hisi_hpre/<bdf>/qm/diff_regs

定义在文件 debugfs-hisi-hpre

QM 调试寄存器（regs）读取硬件寄存器值。此节点用于显示 qm 寄存器值的更改。此节点可以帮助用户检查寄存器值的更改。

/sys/kernel/debug/hisi_hpre/<bdf>/qm/err_irq

定义在文件 debugfs-hisi-hpre

转储 QM 任务完成的无效中断次数。PF 和 VF 均可用，并且对 HPRE 没有其他影响。

/sys/kernel/debug/hisi_hpre/<bdf>/qm/mb_err

定义在文件 debugfs-hisi-hpre

转储失败的 QM 邮箱命令数。PF 和 VF 均可用，并且对 HPRE 没有其他影响。

/sys/kernel/debug/hisi_hpre/<bdf>/qm/qm_state

定义在文件 debugfs-hisi-hpre

转储设备的状态。0：繁忙，1：空闲。仅适用于 PF，并且对 HPRE 没有其他影响。

/sys/kernel/debug/hisi_hpre/<bdf>/qm/regs

定义在文件 debugfs-hisi-hpre

从 QM 转储调试寄存器。PF 和主机中的 VF 可用。访客中的 VF 当前只有一个调试寄存器。

/sys/kernel/debug/hisi_hpre/<bdf>/qm/status

定义在文件 debugfs-hisi-hpre

转储 QM 的状态。两种状态：工作、停止。PF 和 VF 均可用，并且对 HPRE 没有其他影响。

/sys/kernel/debug/hisi_hpre/<bdf>/rdclr_en

定义在文件 debugfs-hisi-hpre

HPRE 核心调试寄存器读取清除控制。1 表示启用寄存器读取清除，否则为 0。写入此文件没有功能效果，仅启用或禁用读取这些寄存器后清除计数器。仅适用于 PF。

/sys/kernel/debug/hisi_hpre/<bdf>/regs

定义在文件 debugfs-hisi-hpre

从 HPRE 转储调试寄存器。仅适用于 PF。

/sys/kernel/debug/hisi_sec2/<bdf>/alg_qos

定义在文件 debugfs-hisi-sec

<bdf> 与 PF 和 VF 的功能相关。SEC 驱动程序支持配置每个功能的 QoS，驱动程序支持将 <bdf> 值写入主机中的 alg_qos。例如 “echo <bdf> value > alg_qos”。qos 值介于 1~1000 之间，表示总 QoS 的 1/1000~1000/1000。驱动程序读取 alg_qos 以获取主机和 VM 中的相关 QoS，例如 “cat alg_qos”。

/sys/kernel/debug/hisi_sec2/<bdf>/cap_regs

定义在文件 debugfs-hisi-sec

转储 qm 和 sec 功能位寄存器的值，并支持设备规格的查询，以方便进行故障定位。PF 和 VF 均可用，并且对 SEC 没有其他影响。

/sys/kernel/debug/hisi_sec2/<bdf>/clear_enable

定义在文件 debugfs-hisi-sec

启用/禁用读取 SEC 调试寄存器后清除操作。0：禁用，1：启用。仅适用于 PF，并且对 SEC 没有其他影响。

/sys/kernel/debug/hisi_sec2/<bdf>/current_qm

定义在文件 debugfs-hisi-sec

一个 SEC 控制器有一个 PF 和多个 VF，每个功能都有一个 QM。此文件可用于选择以下 qm 引用的 QM。仅适用于 PF。

/sys/kernel/debug/hisi_sec2/<bdf>/qm/abnormal_irq

定义在文件 debugfs-hisi-sec

转储 QM 异常事件的中断次数。PF 和 VF 均可用，并且对 SEC 没有其他影响。

/sys/kernel/debug/hisi_sec2/<bdf>/qm/aeq_irq

定义在文件 debugfs-hisi-sec

转储 QM 异步事件队列中断的次数。PF 和 VF 均可用，并且对 SEC 没有其他影响。

/sys/kernel/debug/hisi_sec2/<bdf>/qm/clear_enable

定义在文件 debugfs-hisi-sec

启用/禁用读取 SEC 的 QM 调试寄存器后的清除动作。0：禁用，1：启用。仅适用于 PF，对 SEC 没有其他影响。

/sys/kernel/debug/hisi_sec2/<bdf>/qm/create_qp_err

定义在文件 debugfs-hisi-sec

转储队列分配错误的数量。PF 和 VF 都可用，对 SEC 没有其他影响。

/sys/kernel/debug/hisi_sec2/<bdf>/qm/current_q

定义在文件 debugfs-hisi-sec

一个 SEC 的 QM 可能包含多个队列。选择特定队列以在上面的“regs”中显示其调试寄存器。仅适用于 PF。

/sys/kernel/debug/hisi_sec2/<bdf>/qm/dev_state

定义在文件 debugfs-hisi-sec

转储 QM 的停止队列状态。默认值为 0，如果设置了 dev_timeout，当停止队列失败时，dev_state 将返回非零值。PF 和 VF 都可用，对 SEC 没有其他影响。

/sys/kernel/debug/hisi_sec2/<bdf>/qm/dev_timeout

定义在文件 debugfs-hisi-sec

设置停止队列失败时的等待时间。PF 和 VF 都可用，对 SEC 没有其他影响。0：不等待（默认），其他值：等待 dev_timeout * 20 微秒。

/sys/kernel/debug/hisi_sec2/<bdf>/qm/diff_regs

定义在文件 debugfs-hisi-sec

QM 调试寄存器（regs）读取硬件寄存器值。此节点用于显示 qm 寄存器值的更改。此节点可以帮助用户检查寄存器值的更改。

/sys/kernel/debug/hisi_sec2/<bdf>/qm/err_irq

定义在文件 debugfs-hisi-sec

转储 QM 任务完成的无效中断数量。PF 和 VF 都可用，对 SEC 没有其他影响。

/sys/kernel/debug/hisi_sec2/<bdf>/qm/mb_err

定义在文件 debugfs-hisi-sec

转储失败的 QM 邮箱命令的数量。PF 和 VF 都可用，对 SEC 没有其他影响。

/sys/kernel/debug/hisi_sec2/<bdf>/qm/qm_regs

定义在文件 debugfs-hisi-sec

转储与 QM 相关的调试寄存器。主机中的 PF 和 VF 都可用。访客中的 VF 当前只有一个调试寄存器。

/sys/kernel/debug/hisi_sec2/<bdf>/qm/qm_state

定义在文件 debugfs-hisi-sec

转储设备的状态。0：忙，1：空闲。仅适用于 PF，对 SEC 没有其他影响。

/sys/kernel/debug/hisi_sec2/<bdf>/qm/status

定义在文件 debugfs-hisi-sec

转储 QM 的状态。两种状态：工作，停止。PF 和 VF 都可用，对 SEC 没有其他影响。

/sys/kernel/debug/hisi_sec2/<bdf>/sec_dfx/diff_regs

定义在文件 debugfs-hisi-sec

SEC 调试寄存器 (regs) 读取硬件寄存器值。此节点用于显示寄存器值的变化。此节点可以帮助用户检查寄存器值的变化。

/sys/kernel/debug/hisi_sec2/<bdf>/sec_dfx/done_flag_cnt

定义在文件 debugfs-hisi-sec

转储已完成但标记为错误待接收的请求总数。PF 和 VF 都可用，对 SEC 没有其他影响。

/sys/kernel/debug/hisi_sec2/<bdf>/sec_dfx/err_bd_cnt

定义在文件 debugfs-hisi-sec

转储待接收的 BD 类型错误请求的总数。PF 和 VF 都可用，对 SEC 没有其他影响。

/sys/kernel/debug/hisi_sec2/<bdf>/sec_dfx/invalid_req_cnt

定义在文件 debugfs-hisi-sec

转储接收到的无效请求的总数。PF 和 VF 都可用，对 SEC 没有其他影响。

/sys/kernel/debug/hisi_sec2/<bdf>/sec_dfx/recv_cnt

定义在文件 debugfs-hisi-sec

转储接收到的请求总数。PF 和 VF 都可用，对 SEC 没有其他影响。

/sys/kernel/debug/hisi_sec2/<bdf>/sec_dfx/send_busy_cnt

定义在文件 debugfs-hisi-sec

转储以返回忙状态发送的请求总数。PF 和 VF 都可用，对 SEC 没有其他影响。

/sys/kernel/debug/hisi_sec2/<bdf>/sec_dfx/send_cnt

定义在文件 debugfs-hisi-sec

转储发送的请求总数。PF 和 VF 都可用，对 SEC 没有其他影响。

/sys/kernel/debug/hisi_zip/<bdf>/alg_qos

在文件 debugfs-hisi-zip 中定义

<bdf> 与 PF 和 VF 的功能相关。ZIP 驱动程序支持配置每个功能的 QoS，驱动程序支持将 <bdf> 值写入主机中的 alg_qos。例如，“echo <bdf> 值 > alg_qos”。qos 值是 1~1000，表示总 QoS 的 1/1000~1000/1000。驱动程序读取 alg_qos 以获取主机和 VM 中的相关 QoS，例如 “cat alg_qos”。

/sys/kernel/debug/hisi_zip/<bdf>/cap_regs

在文件 debugfs-hisi-zip 中定义

转储 qm 和 zip 功能位寄存器的值，并支持查询设备规格，以方便故障定位。PF 和 VF 都可用，对 ZIP 没有其他影响。

/sys/kernel/debug/hisi_zip/<bdf>/clear_enable

在文件 debugfs-hisi-zip 中定义

压缩/解压缩核心调试寄存器读取清除控制。1 表示启用寄存器读取清除，否则为 0。写入此文件没有功能影响，仅启用或禁用读取这些寄存器后清除计数器。仅适用于 PF。

/sys/kernel/debug/hisi_zip/<bdf>/comp_core[01]/regs

在文件 debugfs-hisi-zip 中定义

转储与压缩核心相关的调试寄存器。仅适用于 PF。

/sys/kernel/debug/hisi_zip/<bdf>/current_qm

在文件 debugfs-hisi-zip 中定义

一个 ZIP 控制器具有一个 PF 和多个 VF，每个功能都有一个 QM。选择以下 qm 引用的 QM。仅适用于 PF。

/sys/kernel/debug/hisi_zip/<bdf>/decomp_core[0-5]/regs

在文件 debugfs-hisi-zip 中定义

转储与解压缩核心相关的调试寄存器。仅适用于 PF。

/sys/kernel/debug/hisi_zip/<bdf>/qm/abnormal_irq

在文件 debugfs-hisi-zip 中定义

转储 QM 异常事件的中断数量。PF 和 VF 都可用，对 ZIP 没有其他影响。

/sys/kernel/debug/hisi_zip/<bdf>/qm/aeq_irq

在文件 debugfs-hisi-zip 中定义

转储 QM 异步事件队列中断的数量。PF 和 VF 都可用，对 ZIP 没有其他影响。

/sys/kernel/debug/hisi_zip/<bdf>/qm/clear_enable

在文件 debugfs-hisi-zip 中定义

QM 调试寄存器 (regs) 读取清除控制。1 表示启用寄存器读取清除，否则为 0。写入此文件没有功能效果，仅启用或禁用读取这些寄存器后清除计数器。仅适用于 PF。

/sys/kernel/debug/hisi_zip/<bdf>/qm/create_qp_err

在文件 debugfs-hisi-zip 中定义

转储队列分配错误的数量。PF 和 VF 都可用，对 ZIP 没有其他影响。

/sys/kernel/debug/hisi_zip/<bdf>/qm/current_q

在文件 debugfs-hisi-zip 中定义

一个 QM 可能包含多个队列。选择特定的队列以在上述 regs 中显示其调试寄存器。仅适用于 PF。

/sys/kernel/debug/hisi_zip/<bdf>/qm/dev_state

在文件 debugfs-hisi-zip 中定义

转储 QM 的停止队列状态。默认值为 0，如果设置了 dev_timeout，当停止队列失败时，dev_state 将返回非零值。PF 和 VF 都可用，对 ZIP 没有其他影响。

/sys/kernel/debug/hisi_zip/<bdf>/qm/dev_timeout

在文件 debugfs-hisi-zip 中定义

设置停止队列失败时的等待时间。PF 和 VF 都可用，对 ZIP 没有其他影响。0：不等待（默认），其他值：等待 dev_timeout * 20 微秒。

/sys/kernel/debug/hisi_zip/<bdf>/qm/diff_regs

在文件 debugfs-hisi-zip 中定义

QM 调试寄存器 (regs) 读取硬件寄存器值。此节点用于显示 qm 寄存器值的变化。此节点可以帮助用户检查寄存器值的变化。

/sys/kernel/debug/hisi_zip/<bdf>/qm/err_irq

在文件 debugfs-hisi-zip 中定义

转储 QM 任务完成的无效中断数量。PF 和 VF 都可用，对 ZIP 没有其他影响。

/sys/kernel/debug/hisi_zip/<bdf>/qm/mb_err

在文件 debugfs-hisi-zip 中定义

转储失败的 QM 邮箱命令的数量。PF 和 VF 都可用，对 ZIP 没有其他影响。

/sys/kernel/debug/hisi_zip/<bdf>/qm/qm_state

在文件 debugfs-hisi-zip 中定义

转储设备的状态。0：忙，1：空闲。仅适用于 PF，对 ZIP 没有其他影响。

/sys/kernel/debug/hisi_zip/<bdf>/qm/regs

在文件 debugfs-hisi-zip 中定义

转储与 QM 相关的调试寄存器。主机中的 PF 和 VF 都可用。访客中的 VF 当前只有一个调试寄存器。

/sys/kernel/debug/hisi_zip/<bdf>/qm/status

在文件 debugfs-hisi-zip 中定义

转储 QM 的状态。两种状态：工作，停止。PF 和 VF 都可用，对 ZIP 没有其他影响。

/sys/kernel/debug/hisi_zip/<bdf>/zip_dfx/diff_regs

在文件 debugfs-hisi-zip 中定义

ZIP 调试寄存器 (regs) 读取硬件寄存器值。此节点用于显示寄存器值的变化。此节点可以帮助用户检查寄存器值的变化。

/sys/kernel/debug/hisi_zip/<bdf>/zip_dfx/err_bd_cnt

在文件 debugfs-hisi-zip 中定义

转储待接收的 BD 类型错误请求的总数。PF 和 VF 都可用，对 ZIP 没有其他影响。

/sys/kernel/debug/hisi_zip/<bdf>/zip_dfx/recv_cnt

在文件 debugfs-hisi-zip 中定义

转储接收到的请求总数。PF 和 VF 都可用，对 ZIP 没有其他影响。

/sys/kernel/debug/hisi_zip/<bdf>/zip_dfx/send_busy_cnt

在文件 debugfs-hisi-zip 中定义

转储接收到的返回忙状态的请求总数。PF 和 VF 都可用，对 ZIP 没有其他影响。

/sys/kernel/debug/hisi_zip/<bdf>/zip_dfx/send_cnt

在文件 debugfs-hisi-zip 中定义

转储发送的请求总数。PF 和 VF 都可用，对 ZIP 没有其他影响。

/sys/kernel/debug/hyperv/<UUID>/delay/fuzz_test_buffer_interrupt_delay

在文件 debugfs-hyperv 中定义

模糊测试缓冲区中断延迟值介于 0 - 1000

微秒（包括）。

用户：调试工具

/sys/kernel/debug/hyperv/<UUID>/delay/fuzz_test_message_delay

在文件 debugfs-hyperv 中定义

模糊测试消息延迟值介于 0 - 1000 微秒

（包括）。

用户：调试工具

/sys/kernel/debug/hyperv/<UUID>/fuzz_test_state

在文件 debugfs-hyperv 中定义

vmbus 设备的模糊测试状态，无论是开启状态还是关闭状态

用户：调试工具

/sys/kernel/debug/ideapad/cfg

在文件 debugfs-ideapad 中定义

cfg 显示 VPC2004 设备中 _CFG 方法的返回值。它告诉机器的功能和机器内的图形组件。

/sys/kernel/debug/ideapad/status

在文件 debugfs-ideapad 中定义

status 显示我们可以读取的信息，并说明其含义和值。

/sys/kernel/debug/iio/iio:deviceX/backendY/direct_reg_access

在文件 debugfs-iio-backend 中定义

直接访问后端 Y 的寄存器。典型用法是

读取地址 0x50 echo 0x50 > direct_reg_access cat direct_reg_access

写入地址 0x50 echo 0x50 0x3 > direct_reg_access //回读地址 0x50 cat direct_reg_access

/sys/kernel/debug/iio/iio:deviceX/backendY/name

在文件 debugfs-iio-backend 中定义

连接到设备 X 的后端 Y 的名称。

/sys/kernel/debug/iio/iio:deviceX/calibration_table_dump

在文件 debugfs-iio-ad9467 中定义

这会转储在数字接口调整过程中填充的校准表。

/sys/kernel/debug/iio/iio:deviceX/in_voltageY_test_mode

在文件 debugfs-iio-ad9467 中定义

写入此文件将在通道 Y 上启动可用的测试音调之一。读取它会显示正在运行的测试。在有 IIO 后端可用并支持测试音调的情况下，会提供有关数据正确性的其他信息。

/sys/kernel/debug/iio/iio:deviceX/in_voltage_test_mode_available

在文件 debugfs-iio-ad9467 中定义

列出所有可用的测试音调：- off - midscale_short - pos_fullscale - neg_fullscale - checkerboard - prbs23 - prbs9 - one_zero_toggle - user - bit_toggle - sync - one_bit_high - mixed_bit_frequency - ramp

请注意，根据使用的实际设备，上述某些内容可能不可用（并且在读取文件时不会列出）。

/sys/kernel/debug/iommu/intel/<bdf>/domain_translation_struct

在文件 debugfs-intel-iommu 中定义

此文件以传统模式或可扩展模式转储 Intel IOMMU 的指定页表。

对于仅支持传统模式的设备，通过 debugfs 设备目录中的 debugfs 文件转储其页表。例如 /sys/kernel/debug/iommu/intel/0000:00:02.0/domain_translation_struct。

对于支持可扩展模式的设备，通过 debugfs pasid 目录中的 debugfs 文件转储指定 pasid 的页表。例如 /sys/kernel/debug/iommu/intel/0000:00:02.0/1/domain_translation_struct。

Kabylake 中的示例

1) Dump the page table of device "0000:00:02.0" that only supports legacy mode.

$ sudo cat /sys/kernel/debug/iommu/intel/0000:00:02.0/domain_translation_struct

Device 0000:00:02.0 @0x1017f8000
IOVA_PFN                PML5E                   PML4E
0x000000008d800 |       0x0000000000000000      0x00000001017f9003
0x000000008d801 |       0x0000000000000000      0x00000001017f9003
0x000000008d802 |       0x0000000000000000      0x00000001017f9003

PDPE                    PDE                     PTE
0x00000001017fa003      0x00000001017fb003      0x000000008d800003
0x00000001017fa003      0x00000001017fb003      0x000000008d801003
0x00000001017fa003      0x00000001017fb003      0x000000008d802003

[...]

2) Dump the page table of device "0000:00:0a.0" with PASID "1" that
supports scalable mode.

$ sudo cat /sys/kernel/debug/iommu/intel/0000:00:0a.0/1/domain_translation_struct

Device 0000:00:0a.0 with pasid 1 @0x10c112000
IOVA_PFN                PML5E                   PML4E
0x0000000000000 |       0x0000000000000000      0x000000010df93003
0x0000000000001 |       0x0000000000000000      0x000000010df93003
0x0000000000002 |       0x0000000000000000      0x000000010df93003

PDPE                    PDE                     PTE
0x0000000106ae6003      0x0000000104b38003      0x0000000147c00803
0x0000000106ae6003      0x0000000104b38003      0x0000000147c01803
0x0000000106ae6003      0x0000000104b38003      0x0000000147c02803

[...]

/sys/kernel/debug/iommu/intel/dmar_perf_latency

在文件 debugfs-intel-iommu 中定义

此文件用于控制和显示每个 DMAR 的各种类型的执行时间范围计数。

首先，将一个值写入 /sys/kernel/debug/iommu/intel/dmar_perf_latency 以启用采样。

可能的值如下所示

  • 0 - 禁用所有延迟数据采样

  • 1 - 启用 IOTLB 失效延迟数据采样

  • 2 - 启用 devTLB 失效延迟数据采样

  • 3 - 启用 intr 条目缓存失效延迟数据采样

接下来，读取 /sys/kernel/debug/iommu/intel/dmar_perf_latency 会给出所有已启用监视器的采样结果快照。

Kabylake 中的示例

1) Disable sampling all latency data:

$ sudo echo 0 > /sys/kernel/debug/iommu/intel/dmar_perf_latency

2) Enable sampling IOTLB invalidation latency data

$ sudo echo 1 > /sys/kernel/debug/iommu/intel/dmar_perf_latency

$ sudo cat /sys/kernel/debug/iommu/intel/dmar_perf_latency

IOMMU: dmar0 Register Base Address: 26be37000
                <0.1us   0.1us-1us    1us-10us  10us-100us   100us-1ms
inv_iotlb           0           0           0           0           0

                1ms-10ms      >=10ms     min(us)     max(us) average(us)
inv_iotlb           0           0           0           0           0

[...]

IOMMU: dmar2 Register Base Address: fed91000
                <0.1us   0.1us-1us    1us-10us  10us-100us   100us-1ms
inv_iotlb           0           0          18           0           0

                1ms-10ms      >=10ms     min(us)     max(us) average(us)
inv_iotlb           0           0           2           2           2

3) Enable sampling devTLB invalidation latency data

$ sudo echo 2 > /sys/kernel/debug/iommu/intel/dmar_perf_latency

$ sudo cat /sys/kernel/debug/iommu/intel/dmar_perf_latency

IOMMU: dmar0 Register Base Address: 26be37000
                <0.1us   0.1us-1us    1us-10us  10us-100us   100us-1ms
inv_devtlb           0           0           0           0           0

                >=10ms     min(us)     max(us) average(us)
inv_devtlb           0           0           0           0

[...]

/sys/kernel/debug/iommu/intel/dmar_translation_struct

在文件 debugfs-intel-iommu 中定义

此文件转储 Intel IOMMU DMA 重映射表，例如根表、上下文表、PASID 目录和 debugfs 中的 PASID 表条目。对于传统模式，它不支持 PASID，因此 PASID 字段默认为“-1”，其他与 PASID 相关的字段无效。

Kabylake 中的示例

$ sudo cat /sys/kernel/debug/iommu/intel/dmar_translation_struct

IOMMU dmar1: Root Table Address: 0x103027000
B.D.F   Root_entry
00:02.0 0x0000000000000000:0x000000010303e001

Context_entry
0x0000000000000102:0x000000010303f005

PASID   PASID_table_entry
-1      0x0000000000000000:0x0000000000000000:0x0000000000000000

IOMMU dmar0: Root Table Address: 0x103028000
B.D.F   Root_entry
00:0a.0 0x0000000000000000:0x00000001038a7001

Context_entry
0x0000000000000000:0x0000000103220e7d

PASID   PASID_table_entry
0       0x0000000000000000:0x0000000000800002:0x00000001038a5089

[...]

/sys/kernel/debug/iommu/intel/invalidation_queue

在文件 debugfs-intel-iommu 中定义

此文件导出每个 IOMMU 设备的失效队列内部信息。

Kabylake 中的示例

$ sudo cat /sys/kernel/debug/iommu/intel/invalidation_queue

Invalidation queue on IOMMU: dmar0
Base: 0x10022e000      Head: 20        Tail: 20
Index          qw0                    qw1                     qw2
    0   0000000000000014        0000000000000000        0000000000000000
    1   0000000200000025        0000000100059c04        0000000000000000
    2   0000000000000014        0000000000000000        0000000000000000

               qw3                  status
        0000000000000000        0000000000000000
        0000000000000000        0000000000000000
        0000000000000000        0000000000000000

[...]

Invalidation queue on IOMMU: dmar1
Base: 0x10026e000      Head: 32        Tail: 32
Index           qw0                     qw1                   status
    0   0000000000000004        0000000000000000         0000000000000000
    1   0000000200000025        0000000100059804         0000000000000000
    2   0000000000000011        0000000000000000         0000000000000000

[...]

/sys/kernel/debug/iommu/intel/iommu_regset

在文件 debugfs-intel-iommu 中定义

此文件转储每个 IOMMU 设备的所有寄存器内容。

Kabylake 中的示例

$ sudo cat /sys/kernel/debug/iommu/intel/iommu_regset

IOMMU: dmar0 Register Base Address: 26be37000

Name                    Offset          Contents
VER                     0x00            0x0000000000000010
GCMD                    0x18            0x0000000000000000
GSTS                    0x1c            0x00000000c7000000
FSTS                    0x34            0x0000000000000000
FECTL                   0x38            0x0000000000000000

[...]

IOMMU: dmar1 Register Base Address: fed90000

Name                    Offset          Contents
VER                     0x00            0x0000000000000010
GCMD                    0x18            0x0000000000000000
GSTS                    0x1c            0x00000000c7000000
FSTS                    0x34            0x0000000000000000
FECTL                   0x38            0x0000000000000000

[...]

IOMMU: dmar2 Register Base Address: fed91000

Name                    Offset          Contents
VER                     0x00            0x0000000000000010
GCMD                    0x18            0x0000000000000000
GSTS                    0x1c            0x00000000c7000000
FSTS                    0x34            0x0000000000000000
FECTL                   0x38            0x0000000000000000

[...]

/sys/kernel/debug/iommu/intel/ir_translation_struct

在文件 debugfs-intel-iommu 中定义

此文件转储中断重映射和中断发布的表条目。

Kabylake 中的示例

$ sudo cat /sys/kernel/debug/iommu/intel/ir_translation_struct

Remapped Interrupt supported on IOMMU: dmar0
IR table address:100900000

Entry SrcID   DstID    Vct IRTE_high           IRTE_low
0     00:0a.0 00000080 24  0000000000040050    000000800024000d
1     00:0a.0 00000001 ef  0000000000040050    0000000100ef000d

Remapped Interrupt supported on IOMMU: dmar1
IR table address:100300000
Entry SrcID   DstID    Vct IRTE_high           IRTE_low
0     00:02.0 00000002 26  0000000000040010    000000020026000d

[...]

****

Posted Interrupt supported on IOMMU: dmar0
IR table address:100900000
Entry SrcID   PDA_high PDA_low  Vct IRTE_high          IRTE_low

/sys/kernel/debug/memX/clear_poison

在文件 debugfs-cxl 中定义

(WO) 当向此属性写入设备物理地址 (DPA) 时，memdev 驱动程序会向指定地址的设备发送清除毒化命令。清除毒化会从设备的毒化列表中删除该地址，并从该地址开始写入 0（零），共 64 字节。清除未设置毒化的地址不会报错。如果设备无法清除该地址的毒化，则返回 -ENXIO。clear_poison 属性仅对支持此功能的设备可见。

/sys/kernel/debug/moxtet/input

定义于文件 debugfs-moxtet

(读取) 以十六进制读取移位寄存器的输入。返回 N+1 个字节，其中 N 是连接的 Moxtet 模块的数量。第一个字节来自 CPU 板本身。

示例

101214

10

带有 SD 卡的 CPU 板

12

2 = PCIe 模块，1 = IRQ 未激活

14

4 = Peridot 模块，1 = IRQ 未激活

/sys/kernel/debug/moxtet/output

定义于文件 debugfs-moxtet

(读写) 以十六进制读取上次写入移位寄存器的值，或以十六进制向移位寄存器写入值。

示例

0102

01

01 是上次写入或将要写入第一个模块的移位寄存器的值

02

第二个模块相同

/sys/kernel/debug/msi-wmi-platform-<wmi_device_name>/*

定义于文件 debugfs-msi-wmi-platform

此文件允许执行具有相同名称的关联 WMI 方法。

要开始执行，请在文件偏移量 0 处写入包含方法参数的缓冲区。不支持部分写入或在不同的偏移量处写入。

然后可以从文件中读取 WMI 方法返回的缓冲区。

有关详细信息，请参阅MSI WMI 平台功能驱动程序 (msi-wmi-platform)。

/sys/kernel/debug/nx-crypto/*

定义于文件 debugfs-pfo-nx-crypto

这些 debugfs 接口由 nx-crypto 驱动程序构建，该驱动程序内置于 arch/powerpc/crypto/nx 中。

错误检测

errors

一个 u32 值，提供自驱动程序加载以来发生的错误总数。此处仅计算从 hcall H_COP_OP 返回的错误。

last_error

来自 H_COP_OP hcall 的最近的非零返回值。此处不记录 -EBUSY（hcall 将重试，直到 -EBUSY 消失）。

last_error_pid

从 hcall 接收到最近错误的进程的进程 ID。

设备使用

aes_bytes

使用驱动程序支持的任何模式通过 AES 加密的总字节数。

aes_ops

提交给硬件的 AES 操作总数。

sha256_bytes

使用 SHA-256 通过硬件哈希的总字节数。

sha256_ops

提交给硬件的 SHA-256 操作总数。

sha512_bytes

使用 SHA-512 通过硬件哈希的总字节数。

sha512_ops

提交给硬件的 SHA-512 操作总数。

/sys/kernel/debug/olpc-ec/cmd

定义于文件 debugfs-olpc

用于执行 OLPC 嵌入式控制器命令和读取其响应的通用接口。

要执行命令，请写入以下格式的数据：CC:N A A A A。CC 是（十六进制）命令，N 是预期的回复字节数，A A A A 是可选的（十六进制）参数。

要读取响应（如果有），请在执行命令后从通用节点读取。将返回十六进制的回复字节，*无论*它们是否来自上一个命令。

/sys/kernel/debug/pktcdvd/pktcdvd[0-7]

定义于文件 debugfs-pktcdvd

pktcdvd 模块（数据包写入驱动程序）在 debugfs 中创建这些文件

/sys/kernel/debug/pktcdvd/pktcdvd[0-7]/

info

0444

大量的驱动程序统计信息和信息。

示例

cat /sys/kernel/debug/pktcdvd/pktcdvd0/info

/sys/kernel/debug/powerpc/memtrace

定义于文件 ppc-memtrace

此文件夹包含用于硬件跟踪宏的相关 debugfs 文件。必须设置 CONFIG_PPC64_HARDWARE_TRACING。

/sys/kernel/debug/powerpc/memtrace/<node-id>

定义于文件 ppc-memtrace

此目录包含有关从特定 NUMA 节点删除的内存的信息。

/sys/kernel/debug/powerpc/memtrace/<node-id>/size

定义于文件 ppc-memtrace

包含从节点删除的内存大小。

/sys/kernel/debug/powerpc/memtrace/<node-id>/start

定义于文件 ppc-memtrace

包含已删除内存的起始地址。

/sys/kernel/debug/powerpc/memtrace/<node-id>/trace

定义于文件 ppc-memtrace

这是硬件跟踪宏将输出其生成的跟踪的位置。

/sys/kernel/debug/powerpc/memtrace/enable

定义于文件 ppc-memtrace

向此文件写入一个整数，其中包含要从每个 NUMA 节点删除的内存大小（以字节为单位）- 它必须与 memblock 大小对齐。此数量的 RAM 将从内核映射中的每个 NUMA 节点删除，并将创建以下 debugfs 文件。成功从每个节点删除内存后，将创建以下文件。要将内存重新添加到内核，请将 0 回显到此文件中（它将自动联机）。

/sys/kernel/debug/qat_<device>_<BDF>/cnv_errors

定义于文件 debugfs-driver-qat

(RO) 读取返回，对于每个加速引擎 (AE)，设备在执行验证压缩时检测到的错误数量和上次错误的类型。报告的计数器

<N>: Number of Compress and Verify (CnV) errors and type
     of the last CnV error detected by Acceleration
     Engine N.

/sys/kernel/debug/qat_<device>_<BDF>/fw_counters

定义于文件 debugfs-driver-qat

(RO) 读取返回发送到 FW 的请求数和从 FW 接收的每个加速引擎的响应数。报告的固件计数器

<N>: Number of requests sent from Acceleration Engine N to FW and responses
     Acceleration Engine N received from FW

/sys/kernel/debug/qat_<device>_<BDF>/heartbeat/config

定义于文件 debugfs-driver-qat

(读写) 读取返回心跳更新周期的值。写入文件会更改此周期值。

此周期应反映设备运行状况状态的计划轮询间隔。高频率心跳监控会浪费 CPU 周期，但可最大限度地减少客户的系统停机时间。此外，如果存在需要一些时间才能完成的大型服务请求，高频率心跳监控可能会导致错误地报告无响应，在这种情况下，需要增加周期。

此参数仅对 c3xxx、c62x、dh895xcc 设备有效。4xxx 在内部将此值固定为 200 毫秒。

默认值设置为 500。允许的最小值是 200。所有值都以毫秒表示。

/sys/kernel/debug/qat_<device>_<BDF>/heartbeat/inject_error

定义于文件 debugfs-driver-qat

(WO) 写入以注入模拟心跳失败的错误。这用于测试目的。

写入此文件后，驱动程序会停止在随机引擎上的仲裁，并禁用心跳计数器的获取。如果设备上正在运行工作负载，则提交给加速器的作业可能不会获得响应，并且读取 heartbeat/status 属性可能会报告 -1，即设备无响应。该错误是不可恢复的，因此必须重新启动设备以恢复其功能。

仅当使用 CONFIG_CRYPTO_DEV_QAT_ERROR_INJECTION=y 构建内核时，此属性才可用。

写入 1 将启用错误注入。

以下示例演示如何启用错误注入

# cd /sys/kernel/debug/qat_<device>_<BDF>
# echo 1 > heartbeat/inject_error

/sys/kernel/debug/qat_<device>_<BDF>/heartbeat/queries_failed

定义于文件 debugfs-driver-qat

(RO) 读取返回设备变得无响应的次数。

属性返回当状态查询结果为负数时递增的计数器的值。

/sys/kernel/debug/qat_<device>_<BDF>/heartbeat/queries_sent

定义于文件 debugfs-driver-qat

(RO) 读取返回控制进程检查设备是否响应的次数。

属性返回每次状态查询时递增的计数器的值。

/sys/kernel/debug/qat_<device>_<BDF>/heartbeat/status

定义于文件 debugfs-driver-qat

(RO) 读取返回设备运行状况状态。

当设备运行状况良好时返回 0，当设备无响应或查询发送失败时返回 -1。

驱动程序不监控心跳。由用户定期轮询状态。

/sys/kernel/debug/qat_<device>_<BDF>/pm_status

定义于文件 debugfs-driver-qat

(RO) 读取返回特定于 QAT 设备的电源管理信息。

此属性仅适用于 qat_4xxx 设备。

/sys/kernel/debug/qat_<device>_<BDF>/telemetry/control

定义于文件 debugfs-driver-qat_telemetry

(读写) 启用/禁用遥测指标的报告。

允许写入的值

  • 0：禁用遥测

  • 1：启用遥测

  • 2、3、4：启用遥测，并计算 2、3 或 4 个样本中每个计数器的最小值、最大值和平均值

返回值

  • 1-4：遥测已启用并正在运行

  • 0：遥测已禁用

示例。

向此文件写入“3”将启动遥测指标的收集。每秒收集一次样本并存储在大小为 3 的循环缓冲区中。然后使用这些值来计算每个计数器的最小值、最大值和平均值。启用后，可以通过 device_data 文件检索计数器

echo 3 > /sys/kernel/debug/qat_4xxx_0000:6b:00.0/telemetry/control

向此文件写入“0”将停止收集遥测指标

echo 0 > /sys/kernel/debug/qat_4xxx_0000:6b:00.0/telemetry/control

此属性仅适用于 qat_4xxx 设备。

/sys/kernel/debug/qat_<device>_<BDF>/telemetry/device_data

定义于文件 debugfs-driver-qat_telemetry

(RO) 报告设备遥测计数器。读取报告有关 QAT 设备的性能和利用率的指标

字段

描述

sample_cnt

从设备获取遥测数据的次数。每 1000 毫秒执行一次读取。

pci_trans_cnt

PCIe 部分事务数

max_rd_lat

记录的最大读取延迟 [ns]（可以是任何读取操作）

rd_lat_acc_avg

平均读取延迟 [ns]

max_gp_lat

最大获取到放入延迟 [ns]（仅采用 AE0 的样本）

gp_lat_acc_avg

平均获取到放入延迟 [ns]

bw_in

PCIe，写入带宽 [Mbps]

bw_out

PCIe，读取带宽 [Mbps]

at_page_req_lat_avg

地址转换器 (AT)，平均页面请求延迟 [ns]

at_trans_lat_avg

AT，平均页面转换延迟 [ns]

at_max_tlb_used

AT，使用的最大 uTLB

util_cpr<N>

压缩切片 N 的利用率 [%]

exec_cpr<N>

压缩切片 N 的执行计数

util_xlt<N>

转换器切片 N 的利用率 [%]

exec_xlt<N>

转换器切片 N 的执行计数

util_dcpr<N>

解压缩切片 N 的利用率 [%]

exec_dcpr<N>

解压缩切片 N 的执行计数

util_pke<N>

PKE N 的利用率 [%]

exec_pke<N>

PKE N 的执行计数

util_ucs<N>

UCS 切片 N 的利用率 [%]

exec_ucs<N>

UCS 切片 N 的执行计数

util_wat<N>

无线身份验证切片 N 的利用率 [%]

exec_wat<N>

无线身份验证切片 N 的执行计数

util_wcp<N>

无线密码切片 N 的利用率 [%]

exec_wcp<N>

无线密码切片 N 的执行计数

util_cph<N>

密码切片 N 的利用率 [%]

exec_cph<N>

密码切片 N 的执行计数

util_ath<N>

身份验证切片 N 的利用率 [%]

exec_ath<N>

身份验证切片 N 的执行计数

可以使用以下命令读取遥测报告文件

cat /sys/kernel/debug/qat_4xxx_0000:6b:00.0/telemetry/device_data

如果 control 设置为 1，则仅显示计数器的当前值。

<counter_name> <current>

如果 control 设置为 2、3 或 4，则计数器将以以下格式显示。

<counter_name> <current> <min> <max> <avg>

如果设备缺少特定的加速器，则不会报告相应的属性。

此属性仅适用于 qat_4xxx 设备。

/sys/kernel/debug/qat_<device>_<BDF>/telemetry/rp_<A/B/C/D>_data

定义于文件 debugfs-driver-qat_telemetry

（读写）选择最多 4 个环对 (RP) 进行监控，每个文件一个，并报告与每个环对相关的遥测计数器。

允许写入的值

  • 0 到 <num_rps - 1>：要监控的环对。 num_rps 的值可以通过 /sys/bus/pci/devices/<BDF>/qat/num_rps 获取。请参阅 testing/sysfs-driver-qat。

读取报告所选 RP 的性能和利用率指标。

字段

描述

sample_cnt

从设备获取遥测数据的次数。读取操作每 1000 毫秒执行一次。

rp_num

与插槽 <A/B/C/D> 关联的 RP 编号

service_type

与 RP 关联的服务

pci_trans_cnt

PCIe 部分事务数

gp_lat_acc_avg

平均获取到放入延迟 [ns]

bw_in

PCIe，写入带宽 [Mbps]

bw_out

PCIe，读取带宽 [Mbps]

at_glob_devtlb_hit

消息描述符 DevTLB 命中率

at_glob_devtlb_miss

消息描述符 DevTLB 未命中率

tl_at_payld_devtlb_hit

有效负载 DevTLB 命中率

tl_at_payld_devtlb_miss

有效负载 DevTLB 未命中率

示例。

将值“32”写入文件 rp_C_data 将启动环对 32 的遥测指标收集。

echo 32 > /sys/kernel/debug/qat_4xxx_0000:6b:00.0/telemetry/rp_C_data

选择环对后，可以通过访问该文件读取统计信息。

cat /sys/kernel/debug/qat_4xxx_0000:6b:00.0/telemetry/rp_C_data

如果 control 设置为 1，则仅显示计数器的当前值。

<counter_name> <current>

如果 control 设置为 2、3 或 4，则计数器将以以下格式显示。

<counter_name> <current> <min> <max> <avg>

在 QAT GEN4 设备上，一个 PF 上有 64 个 RP，因此允许的值为 0..63。此数字是设备的绝对值。如果使用虚拟功能 (VF)，则环对编号可以从 VF 的总线、设备、功能中派生。

PCI BDF/VF

RP0

RP1

RP2

RP3

0000:6b:0.1

RP 0

RP 1

RP 2

RP 3

0000:6b:0.2

RP 4

RP 5

RP 6

RP 7

0000:6b:0.3

RP 8

RP 9

RP 10

RP 11

0000:6b:0.4

RP 12

RP 13

RP 14

RP 15

0000:6b:0.5

RP 16

RP 17

RP 18

RP 19

0000:6b:0.6

RP 20

RP 21

RP 22

RP 23

0000:6b:0.7

RP 24

RP 25

RP 26

RP 27

0000:6b:1.0

RP 28

RP 29

RP 30

RP 31

0000:6b:1.1

RP 32

RP 33

RP 34

RP 35

0000:6b:1.2

RP 36

RP 37

RP 38

RP 39

0000:6b:1.3

RP 40

RP 41

RP 42

RP 43

0000:6b:1.4

RP 44

RP 45

RP 46

RP 47

0000:6b:1.5

RP 48

RP 49

RP 50

RP 51

0000:6b:1.6

RP 52

RP 53

RP 54

RP 55

0000:6b:1.7

RP 56

RP 57

RP 58

RP 59

0000:6b:2.0

RP 60

RP 61

RP 62

RP 63

该映射仅对主机上 VF 的 BDF 有效。

环对上提供的服务因配置而异。可以使用 cfg_services 查询和设置给定设备的配置。有关详细信息，请参阅 testing/sysfs-driver-qat。

下表报告了在配置为 sym;asym 或 asym;sym 的情况下，环对如何映射到 PF 0000:6b:0.0 上的 VF。

PCI BDF/VF

RP0/服务

RP1/服务

RP2/服务

RP3/服务

0000:6b:0.1

RP 0 asym

RP 1 sym

RP 2 asym

RP 3 sym

0000:6b:0.2

RP 4 asym

RP 5 sym

RP 6 asym

RP 7 sym

0000:6b:0.3

RP 8 asym

RP 9 sym

RP10 asym

RP11 sym

...

...

...

...

...

所有 VF 都遵循相同的模式。

下表报告了在配置为 dc 的情况下，环对如何映射到 PF 0000:6b:0.0 上的 VF。

PCI BDF/VF

RP0/服务

RP1/服务

RP2/服务

RP3/服务

0000:6b:0.1

RP 0 dc

RP 1 dc

RP 2 dc

RP 3 dc

0000:6b:0.2

RP 4 dc

RP 5 dc

RP 6 dc

RP 7 dc

0000:6b:0.3

RP 8 dc

RP 9 dc

RP10 dc

RP11 dc

...

...

...

...

...

可以使用来自 sysfs 的 rp2srv 来检索 RP 到服务的映射。有关详细信息，请参阅 testing/sysfs-driver-qat。

此属性仅适用于 qat_4xxx 设备。

/sys/kernel/debug/scmi/<n>/atomic_threshold_us

定义在文件 debugfs-scmi 中

一个可选的时间值，以微秒为单位表示，在此 SCMI 实例 <n> 上，任何 SCMI 命令的执行延迟高于该阈值，即使请求了原子操作模式，也不应考虑该命令。

用户：调试，任何用户空间测试套件

/sys/kernel/debug/scmi/<n>/instance_name

定义在文件 debugfs-scmi 中

底层 SCMI 实例 <n> 的名称，由所有根位于 /sys/kernel/debug/scmi/<n> 的 debugfs 访问器描述，以顶级 DT SCMI 节点的完整名称表示，此 SCMI 实例位于该节点下。

用户：调试，任何用户空间测试套件

/sys/kernel/debug/scmi/<n>/raw/channels/<m>/message

定义在文件 debugfs-scmi-raw 中

SCMI 原始同步消息注入/窥探工具；以小端二进制格式写入完整的 SCMI 同步命令消息（包括标头），以通过 <m> 传输通道将其发送到实例 <n> 的配置后端 SCMI 服务器。如果在配置的超时时间内在通道 <m> 上收到任何后续响应，则可以从同一条目中读取该响应。每次写入条目都会构建并发送一个命令请求，而回复则一次读取一个消息（在每个消息边界接收 EOF）。通道标识符 <m> 与 SCMI 协议号匹配，该协议号已在此传输通道的 DT 描述中关联，基本协议号 0x10 是此实例的默认通道。请注意，只有当传输配置为具有多个默认通道时，才存在这些根位于 <..>/channels 的每个通道条目。

用户：调试，任何用户空间测试套件

/sys/kernel/debug/scmi/<n>/raw/channels/<m>/message_async

定义在文件 debugfs-scmi-raw 中

SCMI 原始异步消息注入/窥探工具；以小端二进制格式写入完整的 SCMI 异步命令消息（包括标头），以通过 <m> 传输通道将其发送到实例 <n> 的配置后端 SCMI 服务器。如果在配置的超时时间内在通道 <m> 上收到任何后续响应，则可以从同一条目中读取该响应。如果在配置的超时时间内收到任何额外的延迟响应，也可以从同一条目中读取该响应。每次写入条目都会构建并发送一个命令请求，而回复则一次读取一个消息（在每个消息边界接收 EOF）。通道标识符 <m> 与 SCMI 协议号匹配，该协议号已在此传输通道的 DT 描述中关联，基本协议号 0x10 是此实例的默认通道。请注意，只有当传输配置为具有多个默认通道时，才存在这些根位于 <..>/channels 的每个通道条目。

用户：调试，任何用户空间测试套件

/sys/kernel/debug/scmi/<n>/raw/errors

定义在文件 debugfs-scmi-raw 中

SCMI 原始消息错误工具；可以从该条目读取实例 <n> 的任何超时或通常意外接收的 SCMI 消息。每次读取会返回一个消息（在每个消息边界接收 EOF）。

用户：调试，任何用户空间测试套件

/sys/kernel/debug/scmi/<n>/raw/message

定义在文件 debugfs-scmi-raw 中

SCMI 原始同步消息注入/窥探工具；以小端二进制格式写入完整的 SCMI 同步命令消息（包括标头），以将其发送到实例 <n> 的配置后端 SCMI 服务器。如果在配置的超时时间内收到任何后续响应，则可以从同一条目中读取该响应。每次写入条目都会构建并发送一个命令请求，而回复则一次读取一个消息（在每个消息边界接收 EOF）。

用户：调试，任何用户空间测试套件

/sys/kernel/debug/scmi/<n>/raw/message_async

定义在文件 debugfs-scmi-raw 中

SCMI 原始异步消息注入/窥探工具；以小端二进制格式写入完整的 SCMI 异步命令消息（包括标头），以将其发送到实例 <n> 的配置后端 SCMI 服务器。如果在配置的超时时间内收到任何后续响应，则可以从同一条目中读取该响应。如果在配置的超时时间内收到任何额外的延迟响应，也可以从同一条目中读取该响应。每次写入条目都会构建并发送一个命令请求，而回复则一次读取一个消息（在每个消息边界接收 EOF）。

用户：调试，任何用户空间测试套件

/sys/kernel/debug/scmi/<n>/raw/notification

定义在文件 debugfs-scmi-raw 中

SCMI 原始通知窥探工具；可以从该条目读取后端 SCMI 服务器发出的任何通知（例如实例 <n>）。每次读取会返回一个消息（在每个消息边界接收 EOF）。

用户：调试，任何用户空间测试套件

/sys/kernel/debug/scmi/<n>/raw/reset

定义在文件 debugfs-scmi-raw 中

SCMI 原始堆栈重置工具；写入此条目的值会导致立即刷新仍待读取的实例 <n> 的任何类型已接收消息的内部队列。可用于在两次不同的测试运行之间重置和清除 SCMI 原始堆栈。

用户：调试，任何用户空间测试套件

/sys/kernel/debug/scmi/<n>/transport/is_atomic

定义在文件 debugfs-scmi 中

一个布尔值，指示底层 SCMI 实例 <n> 上配置的传输是否支持原子操作模式。

用户：调试，任何用户空间测试套件

/sys/kernel/debug/scmi/<n>/transport/max_msg_size

定义在文件 debugfs-scmi 中

实例 <n> 的当前配置 SCMI 传输允许的 SCMI 消息的最大消息大小。

用户：调试，任何用户空间测试套件

/sys/kernel/debug/scmi/<n>/transport/max_rx_timeout_ms

定义在文件 debugfs-scmi 中

实例 <n> 的当前配置 SCMI 传输允许 SCMI 同步回复的超时时间（以毫秒为单位）。

用户：调试，任何用户空间测试套件

/sys/kernel/debug/scmi/<n>/transport/rx_max_msg

定义在文件 debugfs-scmi 中

实例 <n> 的当前配置 SCMI 传输在 RX 通道上允许的最大并发飞行 SCMI 消息数。

用户：调试，任何用户空间测试套件

/sys/kernel/debug/scmi/<n>/transport/tx_max_msg

定义在文件 debugfs-scmi 中

实例 <n> 的当前配置 SCMI 传输在 TX 通道上允许的最大并发飞行 SCMI 消息数。

用户：调试，任何用户空间测试套件

/sys/kernel/debug/scmi/<n>/transport/type

定义在文件 debugfs-scmi 中

一个字符串，表示为此 SCMI 实例 <n> 配置的传输类型。

用户：调试，任何用户空间测试套件

/sys/kernel/debug/tpmi-<n>/pfs_dump

定义在文件 debugfs-tpmi 中

PFS（PM 功能结构）表，显示每个电源管理功能的详细信息。其中包括：tpmi_id、条目数、条目大小、偏移量、vsec 偏移量、锁定状态和禁用状态。

用户：调试，任何用户空间测试套件

/sys/kernel/debug/tpmi-<n>/plr/domain<n>/status

定义在文件 debugfs-tpmi 中

显示当前有效的芯片级性能限制原因以及芯片下的各个 CPU。此文件的内容是粘性的，可以通过向此文件写入“0n”来清除所有状态。

/sys/kernel/debug/tpmi-<n>/tpmi-id-<n>/mem_dump

定义在文件 debugfs-tpmi 中

显示 TPMI ID 的 MMIO 区域的内存转储。

用户：调试，任何用户空间测试套件

/sys/kernel/debug/tpmi-<n>/tpmi-id-<n>/mem_write

定义在文件 debugfs-tpmi 中

允许在任何偏移量处写入。它不会检查读/写访问，因为硬件不允许在只读内存中写入。此写入的偏移量是 4 的倍数。格式为 instance,offset,contents。示例：echo 0,0x20,0xff > mem_write echo 1,64,64 > mem_write

用户：调试，任何用户空间测试套件

/sys/kernel/debug/turris-mox-rwtm/do_sign

定义在文件 debugfs-turris-mox-rwtm 中

（写入）

使用存储在设备 OTP 中的 ECDSA 私钥签名的消息。该消息必须正好为 64 个字节（因为这是用于 SHA-512 哈希的）。

（读取）

生成的签名，136 字节。其中包含 ECDSA 签名的 R 和 S 值，均以大端格式表示。

/sys/kernel/debug/vfio

定义在文件 debugfs-vfio

这个 debugfs 文件目录用于调试 vfio 设备，它是所有 vfio 设备的通用目录。Vfio 核心将在此目录下创建一个设备子目录。

/sys/kernel/debug/vfio/<设备>/migration

定义在文件 debugfs-vfio

这个 debugfs 文件目录用于调试支持实时迁移的 vfio 设备。每个支持实时迁移的 vfio 设备的 debugfs 可以在此目录下创建。

/sys/kernel/debug/vfio/<设备>/migration/hisi_acc/cmd_state

定义在文件 debugfs-hisi-migration

用于获取设备命令发送和接收通道的状态。根据结果返回失败或成功日志。

/sys/kernel/debug/vfio/<设备>/migration/hisi_acc/dev_data

定义在文件 debugfs-hisi-migration

读取设备实时迁移所需的配置数据和一些状态数据。这些数据包括设备状态数据、队列配置数据、一些任务配置数据和设备属性数据。数据的输出格式由实时迁移驱动程序定义。

/sys/kernel/debug/vfio/<设备>/migration/hisi_acc/migf_data

定义在文件 debugfs-hisi-migration

读取上次完成的实时迁移的数据。此数据包含与“dev_data”中相同的设备状态数据。migf_data 是迁移的 dev_data。

/sys/kernel/debug/vfio/<设备>/migration/state

定义在文件 debugfs-vfio

读取 vfio 设备的实时迁移状态。状态文件的内容反映了 vfio_device_mig_state 枚举中定义的迁移状态。

/sys/kernel/debug/wilco_ec/h1_gpio

定义在文件 debugfs-wilco-ec

作为 Chrome OS 的 FAFT（全自动固件测试）测试的一部分，我们需要确保 H1 芯片正确设置了一些 GPIO 线。h1_gpio 属性公开了这些线路的状态： - BIT(0) 中的 ENTRY_TO_FACT_MODE - BIT(1) 中的 SPI_CHROME_SEL

输出格式为 “0x%02xn”。

/sys/kernel/debug/wilco_ec/raw

定义在文件 debugfs-wilco-ec

向 EC 写入和读取原始邮箱命令。

您可以将十六进制句子写入 raw，然后该系列字节将被发送到 EC。然后，您可以通过从 raw 读取来读取响应的字节。

对于写入，字节 0-1 表示消息类型，即枚举 wilco_ec_msg_type 之一。字节 2+ 由请求中传递的数据组成，从 MBOX[0] 开始。写入至少需要三个字节，两个字节用于类型，至少一个字节用于数据。

示例

// Request EC info type 3 (EC firmware build date)
// Corresponds with sending type 0x00f0 with
// MBOX = [38, 00, 03, 00]
$ echo 00 f0 38 00 03 00 > /sys/kernel/debug/wilco_ec/raw
// View the result. The decoded ASCII result "12/21/18" is
// included after the raw hex.
// Corresponds with MBOX = [00, 00, 31, 32, 2f, 32, 31, 38, ...]
$ cat /sys/kernel/debug/wilco_ec/raw
00 00 31 32 2f 32 31 2f 31 38 00 38 00 01 00 2f 00  ..12/21/18.8...

请注意，将打印接收到的 MBOX[] 的前 16 个字节，即使某些数据是垃圾数据，并跳过字节 17 到 32。您有责任知道实际响应的前几个字节是多少。

/sys/kernel/dmabuf/buffers

定义在文件 sysfs-kernel-dmabuf-buffers

/sys/kernel/dmabuf/buffers 目录包含每个 DMA-BUF 的内部状态快照。/sys/kernel/dmabuf/buffers/<inode_number> 将包含具有唯一 inode 号 <inode_number> 的 DMA-BUF 的统计信息

用户：内核内存调整/调试工具

/sys/kernel/dmabuf/buffers/<inode_number>/exporter_name

定义在文件 sysfs-kernel-dmabuf-buffers

此文件是只读的，包含 DMA-BUF 的导出器名称。

/sys/kernel/dmabuf/buffers/<inode_number>/size

定义在文件 sysfs-kernel-dmabuf-buffers

此文件是只读的，指定 DMA-BUF 的大小（以字节为单位）。

/sys/kernel/fadump/*

定义在文件 sysfs-kernel-fadump

/sys/kernel/fadump/* 是 FADump sysfs 文件集合，提供有关固件辅助转储 (FADump) 的配置状态的信息。

/sys/kernel/fadump/bootargs_append

定义在文件 sysfs-kernel-fadump

读/写。这是一个特殊的 sysfs 文件，可用于设置要传递给捕获内核的其他参数。

/sys/kernel/fadump/enabled

定义在文件 sysfs-kernel-fadump

只读。主要用于识别内核中是否启用了 FADump。用户：Kdump 服务

/sys/kernel/fadump/hotplug_ready

定义在文件 sysfs-kernel-fadump

只读。Kdump udev 规则在内存添加/删除事件时重新注册 fadump，主要是为了更新 elfcorehdr。此 sysfs 指示在内存添加/删除事件时不需要 fadump 重新注册的 kdump udev 规则，因为 elfcorehdr 现在已在第二个/fadump 内核中准备好。用户：kexec-tools

/sys/kernel/fadump/mem_reserved

定义在文件 sysfs-kernel-fadump

只读。提供有关 FADump 保留的用于保存崩溃转储的内存量（以字节为单位）的信息。

/sys/kernel/fadump/registered

定义在文件 sysfs-kernel-fadump

读/写。帮助从用户空间控制转储收集功能。将此文件设置为 1 将启用系统收集转储，设置为 0 将禁用它。用户：Kdump 服务

/sys/kernel/fadump/release_mem

定义在文件 sysfs-kernel-fadump

只写。这是一个特殊的 sysfs 文件，仅当系统启动以使用 FADump 捕获 vmcore 时才可用。它用于释放 FADump 保留的用于保存崩溃转储的内存。

/sys/kernel/fscaps

定义在文件 sysfs-kernel-fscaps

显示执行二进制文件时是否遵循文件系统功能

/sys/kernel/iommu_groups/

定义在文件 sysfs-kernel-iommu_groups

/sys/kernel/iommu_groups/ 包含多个子目录，每个子目录代表一个 IOMMU 组。子目录的名称与该组的 iommu_group_id() 匹配，这是一个整数值。每个子目录中都有一个名为“devices”的目录，其中包含指向此组中包含的 sysfs 设备的链接。如果 IOMMU 驱动程序选择为该组注册更常用的名称，则该组目录还可选地包含一个“name”文件。

/sys/kernel/iommu_groups/<grp_id>/type

定义在文件 sysfs-kernel-iommu_groups

/sys/kernel/iommu_groups/<grp_id>/type 显示 iommu 用于此组的默认域的类型。有关可能的读取值，请参阅 include/linux/iommu.h。特权用户可以通过写入此文件来请求内核更改组类型。有效的写入值：

DMA

此组中设备的全部 DMA 事务都由 iommu 转换。

DMA-FQ

与上述相同，但使用批量失效来延迟删除使用后的转换。这可能会降低开销，但代价是降低内存保护。

identity

此组中设备的全部 DMA 事务都不由 iommu 转换。最大性能，但零保护。

auto

更改为设备启动时使用的类型。

仅当满足以下条件时，才能修改组的默认域类型：

  • 该组中的设备未绑定到任何设备驱动程序。因此，用户必须在更改默认域类型之前取消绑定相应的驱动程序。

取消绑定设备驱动程序将取消驱动程序对设备的控制，并且如果在托管根文件系统的设备上执行此操作，可能会导致灾难性后果（用户可能需要重新启动计算机才能使其恢复正常状态）。因此，希望用户了解他们正在做什么。

/sys/kernel/iommu_groups/reserved_regions

定义在文件 sysfs-kernel-iommu_groups

/sys/kernel/iommu_groups/reserved_regions 列出保留的 IOVA 区域。并非列出所有保留的区域。这通常用于输出直接映射的、MSI 的、不可映射的区域。每个区域都用单行描述：第一个字段是基本 IOVA，第二个是结束 IOVA，第三个字段描述区域的类型。

自内核 5.3 起，如果 RMRR 仅由图形或 USB 设备使用，则现在将其公开为“direct-relaxable”而不是“direct”。例如，在设备分配用例中，这些 RMRR 被认为是可放松且安全的。

/sys/kernel/irq

定义在文件 sysfs-kernel-irq

包含有关系统 IRQ 的信息的目录。具体来说，来自关联的 struct irq_desc 的数据。此处的信息与 /proc/interrupts 中的信息类似，但格式更易于机器读取。此目录包含每个 Linux IRQ 号的一个子目录。

/sys/kernel/irq/<irq>/actions

定义在文件 sysfs-kernel-irq

IRQ 操作链。与此中断关联的零个或多个设备名称的逗号分隔列表。

/sys/kernel/irq/<irq>/chip_name

定义在文件 sysfs-kernel-irq

关联的设备驱动程序提供的、人类可读的芯片名称。

/sys/kernel/irq/<irq>/hwirq

定义在文件 sysfs-kernel-irq

当使用中断转换域时，此文件包含用于此 Linux IRQ 的底层硬件 IRQ 号。

/sys/kernel/irq/<irq>/name

定义在文件 sysfs-kernel-irq

irq 芯片驱动程序定义的人类可读的流处理程序名称。

/sys/kernel/irq/<irq>/per_cpu_count

定义在文件 sysfs-kernel-irq

自启动以来中断触发的次数。这是一个计数器的逗号分隔列表；每个 CPU 都有一个计数器，按 CPU id 顺序排列。注意：此文件始终显示所有 CPU id 的计数器。这与 /proc/interrupts 的行为不同，后者仅显示在线 CPU 的计数器。

/sys/kernel/irq/<irq>/type

定义在文件 sysfs-kernel-irq

中断的类型。字符串“level”或“edge”。

/sys/kernel/irq/<irq>/wakeup

定义在文件 sysfs-kernel-irq

中断的唤醒状态。字符串“enabled”或“disabled”。

/sys/kernel/livepatch

定义在文件 sysfs-kernel-livepatch

内核实时修补的接口

/sys/kernel/livepatch 目录包含每个已加载的实时修补模块的子目录。

/sys/kernel/livepatch/<patch>

定义在文件 sysfs-kernel-livepatch

修补程序目录包含其中已修补函数的每个内核对象（vmlinux 或模块）的子目录。

/sys/kernel/livepatch/<patch>/<object>

定义在文件 sysfs-kernel-livepatch

对象目录包含对象中修补的每个函数的子目录。

/sys/kernel/livepatch/<patch>/<object>/<function,sympos>

定义在文件 sysfs-kernel-livepatch

函数目录包含有关已修补函数的属性和状态的属性。

目录名称包含已修补的函数名称和一个 sympos 数字，该数字对应于已修补对象中 kallsyms 中符号名称的第 n 次出现。

目前没有此类属性。

/sys/kernel/livepatch/<补丁>/<对象>/patched

定义在文件 sysfs-kernel-livepatch

一个属性，指示该对象当前是否已打补丁。

/sys/kernel/livepatch/<补丁>/enabled

定义在文件 sysfs-kernel-livepatch

一个可写属性，指示当前是否应用了已打补丁的代码。写入 0 将禁用补丁，而写入 1 将重新启用补丁。

/sys/kernel/livepatch/<补丁>/force

定义在文件 sysfs-kernel-livepatch

一个可写属性，允许管理员影响现有转换的过程。写入 1 将清除所有任务的 TIF_PATCH_PENDING 标志，从而强制任务进入已打补丁或未打补丁状态。未经补丁分发者许可，管理员不应使用此功能。使用此功能时，将永久禁用补丁模块的删除 (rmmod)。有关详细信息，请参阅Livepatch。

/sys/kernel/livepatch/<补丁>/replace

定义在文件 sysfs-kernel-livepatch

一个属性，指示该补丁是否支持原子替换。

/sys/kernel/livepatch/<补丁>/transition

定义在文件 sysfs-kernel-livepatch

一个属性，指示该补丁当前是否正在转换中。

/sys/kernel/mm

在文件 sysfs-kernel-mm 中定义

/sys/kernel/mm/ 应该包含 /sys/kernel/ 中的所有 VM 相关信息。

/sys/kernel/mm/cma/

在文件 sysfs-kernel-mm-cma 中定义

/sys/kernel/mm/cma/ 包含每个 CMA 堆名称（有时也称为 CMA 区域）的子目录。

每个 CMA 堆子目录（即每个 /sys/kernel/mm/cma/<cma-堆名称> 目录）包含以下项

alloc_pages_success alloc_pages_fail

/sys/kernel/mm/cma/<cma-堆名称>/alloc_pages_fail

在文件 sysfs-kernel-mm-cma 中定义

CMA API 分配页面失败的次数

/sys/kernel/mm/cma/<cma-堆名称>/alloc_pages_success

在文件 sysfs-kernel-mm-cma 中定义

CMA API 成功分配的页面数

/sys/kernel/mm/cma/<cma-堆名称>/release_pages_success

在文件 sysfs-kernel-mm-cma 中定义

CMA API 成功释放的页面数

/sys/kernel/mm/damon/

在文件 sysfs-kernel-mm-damon 中定义

数据访问监视 (DAMON) 的接口。包含用于控制 DAMON 的文件。有关 DAMON 本身的更多详细信息，请参阅 DAMON：数据访问监视器。

/sys/kernel/mm/damon/admin/

在文件 sysfs-kernel-mm-damon 中定义

DAMON 特权用户的接口。包含用于控制 DAMON 的文件，这些文件旨在由特权用户使用。

/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/avail_operations

在文件 sysfs-kernel-mm-damon 中定义

读取此文件将返回当前运行的内核上可用的监视操作集。

/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/monitoring_attrs/intervals/aggr_us

在文件 sysfs-kernel-mm-damon 中定义

向此文件写入值会将 DAMON 上下文的聚合间隔设置为该值（以微秒为单位）。读取此文件将返回该值。

/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/monitoring_attrs/intervals/sample_us

在文件 sysfs-kernel-mm-damon 中定义

向此文件写入值会将 DAMON 上下文的采样间隔设置为该值（以微秒为单位）。读取此文件将返回该值。

/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/monitoring_attrs/intervals/update_us

在文件 sysfs-kernel-mm-damon 中定义

向此文件写入值会将 DAMON 上下文的更新间隔设置为该值（以微秒为单位）。读取此文件将返回该值。

/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/monitoring_attrs/nr_regions/max

在文件 sysfs-kernel-mm-damon 中定义

向此文件写入值会将 DAMON 上下文的最大监视区域数设置为该值。读取此文件将返回该值。

/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/monitoring_attrs/nr_regions/min

在文件 sysfs-kernel-mm-damon 中定义

向此文件写入值会将 DAMON 上下文的最小监视区域数设置为该值。读取此文件将返回该值。

/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/operations

在文件 sysfs-kernel-mm-damon 中定义

向此文件写入用于监视操作集的关键字（用于虚拟地址空间监视的“vaddr”、用于固定虚拟地址范围监视的“fvaddr”以及用于物理地址空间监视的“paddr”）使上下文使用该操作集。读取该文件将返回上下文设置为使用的操作集的关键字。

请注意，只有“avail_operations”文件中列出的操作集才是有效输入。

/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/access_pattern/age/max

在文件 sysfs-kernel-mm-damon 中定义

写入和读取此文件将设置和获取方案的目标区域的最大“age”。

/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/access_pattern/age/min

在文件 sysfs-kernel-mm-damon 中定义

写入和读取此文件将设置和获取方案的目标区域的最小“age”。

/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/access_pattern/nr_accesses/max

在文件 sysfs-kernel-mm-damon 中定义

写入和读取此文件将设置和获取方案的目标区域的最大“nr_accesses”。

/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/access_pattern/nr_accesses/min

在文件 sysfs-kernel-mm-damon 中定义

写入和读取此文件将设置和获取方案的目标区域的最小“nr_accesses”。

/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/access_pattern/sz/max

在文件 sysfs-kernel-mm-damon 中定义

写入和读取此文件将设置和获取方案的目标区域的最大大小（以字节为单位）。

/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/access_pattern/sz/min

在文件 sysfs-kernel-mm-damon 中定义

写入和读取此文件将设置和获取方案的目标区域的最小大小（以字节为单位）。

/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/action

在文件 sysfs-kernel-mm-damon 中定义

写入和读取此文件将设置和获取方案的操作。

/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/apply_interval_us

在文件 sysfs-kernel-mm-damon 中定义

向此文件写入值将设置方案的操作应用间隔（以微秒为单位）。读取此文件将返回该值。

/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/filters/<F>/addr_end

在文件 sysfs-kernel-mm-damon 中定义

如果将“addr”写入“type”文件，则写入或读取此文件将设置或获取过滤器的地址范围的结束地址。

/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/filters/<F>/addr_start

在文件 sysfs-kernel-mm-damon 中定义

如果将“addr”写入“type”文件，则写入或读取此文件将设置或获取过滤器的地址范围的起始地址。

/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/filters/<F>/matching

在文件 sysfs-kernel-mm-damon 中定义

向此文件写入“Y”或“N”将设置是否过滤掉分别与“type”和“memcg_path”匹配或不匹配的页面。过滤掉意味着该方案的操作将不会应用于该页面。

/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/filters/<F>/memcg_path

在文件 sysfs-kernel-mm-damon 中定义

如果将“memcg”写入“type”文件，则写入和读取此文件将设置和获取感兴趣的内存 cgroup 的路径。

/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/filters/<F>/target_idx

在文件 sysfs-kernel-mm-damon 中定义

如果将“target”写入“type”文件，则写入或读取此文件将设置或获取感兴趣的 DAMON 监视目标的索引。

/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/filters/<F>/type

在文件 sysfs-kernel-mm-damon 中定义

写入和读取此文件将设置和获取感兴趣的内存类型。可以写入和读取“anon”（用于匿名页面）、“memcg”（用于特定内存 cgroup）、“young”（用于年轻页面）、“addr”（用于地址范围（一个开放式区间））或“target”（用于 DAMON 监视目标）。

/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/filters/nr_filters

在文件 sysfs-kernel-mm-damon 中定义

向此文件写入数字“N”将在 filters/ 目录下创建名为“0”到“N-1”的用于设置方案过滤器的目录数。

/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/quotas/bytes

在文件 sysfs-kernel-mm-damon 中定义

写入和读取此文件将设置和获取方案的字节大小配额。

/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/quotas/effective_bytes

在文件 sysfs-kernel-mm-damon 中定义

读取此文件将获取方案的有效大小配额（以字节为单位），该配额会根据时间和目标进行调整。

/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/quotas/goals/<G>/current_value

在文件 sysfs-kernel-mm-damon 中定义

写入和读取此文件将设置和获取目标指标的当前值。

/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/quotas/goals/<G>/target_metric

在文件 sysfs-kernel-mm-damon 中定义

写入和读取此文件将设置和获取配额自动调整目标指标。

/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/quotas/goals/<G>/target_value

在文件 sysfs-kernel-mm-damon 中定义

写入和读取此文件将设置和获取目标指标的目标值。

/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/quotas/goals/nr_goals

在文件 sysfs-kernel-mm-damon 中定义

向此文件写入数字“N”将在 goals/ 目录下创建名为“0”到“N-1”的用于设置方案的自动调整积极性的目录数。

/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/quotas/ms

在文件 sysfs-kernel-mm-damon 中定义

写入和读取此文件将设置和获取方案的时间配额（以毫秒为单位）。

/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/quotas/reset_interval_ms

在文件 sysfs-kernel-mm-damon 中定义

写入和读取此文件将设置和获取方案的配额充值重置间隔（以毫秒为单位）。

/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/quotas/weights/age_permil

在文件 sysfs-kernel-mm-damon 中定义

写入和读取此文件将设置和获取未达到配额限制的区域的优先级权重，以“age”为单位（以千分比表示）。

/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/quotas/weights/nr_accesses_permil

在文件 sysfs-kernel-mm-damon 中定义

写入和读取此文件将设置和获取未达到配额限制的区域的优先级权重，以“nr_accesses”为单位（以千分比表示）。

/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/quotas/weights/sz_permil

在文件 sysfs-kernel-mm-damon 中定义

写入和读取此文件将设置和获取未达到配额限制的区域的优先级权重，以“size”为单位（以千分比表示）。

/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/stats/nr_applied

在文件 sysfs-kernel-mm-damon 中定义

读取此文件将返回已成功应用方案操作的区域数。

/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/stats/nr_tried

在文件 sysfs-kernel-mm-damon 中定义

读取此文件将返回方案操作尝试应用的区域数。

/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/stats/qt_exceeds

在文件 sysfs-kernel-mm-damon 中定义

读取此文件将返回方案配额的超出事件数。

/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/stats/sz_applied

在文件 sysfs-kernel-mm-damon 中定义

读取此文件将返回已成功应用方案操作的区域的总大小（以字节为单位）。

/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/stats/sz_tried

在文件 sysfs-kernel-mm-damon 中定义

读取此文件将返回方案操作尝试应用的区域的总大小（以字节为单位）。

/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/target_nid

在文件 sysfs-kernel-mm-damon 中定义

操作的目标 NUMA 节点 ID。仅由相关操作支持。

/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/tried_regions/<R>/age

在文件 sysfs-kernel-mm-damon 中定义

读取此文件将返回相应的基于 DAMON 的操作方案尝试应用的内存区域的“age”。

/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/tried_regions/<R>/end

在文件 sysfs-kernel-mm-damon 中定义

读取此文件将返回相应的基于 DAMON 的操作方案尝试应用的内存区域的结束地址。

/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/tried_regions/<R>/nr_accesses

在文件 sysfs-kernel-mm-damon 中定义

读取此文件将返回相应的基于 DAMON 的操作方案尝试应用的内存区域的“nr_accesses”。

/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/tried_regions/<R>/start

在文件 sysfs-kernel-mm-damon 中定义

读取此文件将返回相应的基于 DAMON 的操作方案尝试应用的内存区域的起始地址。

/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/tried_regions/total_bytes

在文件 sysfs-kernel-mm-damon 中定义

读取此文件将返回相应的基于 DAMON 的操作方案尝试应用的内存总大小。

/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/watermarks/high

在文件 sysfs-kernel-mm-damon 中定义

写入和读取此文件会设置和获取方案的千分比高水位线。

/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/watermarks/interval_us

在文件 sysfs-kernel-mm-damon 中定义

写入和读取此文件会设置和获取方案的水位线的度量检查间隔，单位为微秒。

/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/watermarks/low

在文件 sysfs-kernel-mm-damon 中定义

写入和读取此文件会设置和获取方案的千分比低水位线。

/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/watermarks/metric

在文件 sysfs-kernel-mm-damon 中定义

写入和读取此文件会设置和获取方案的水位线的度量。此文件的可写/可读关键字为：'none' 用于禁用水位线功能，或 'free_mem_rate' 用于系统全局空闲内存速率（千分比）。

/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/watermarks/mid

在文件 sysfs-kernel-mm-damon 中定义

写入和读取此文件会设置和获取方案的千分比中水位线。

/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/nr_schemes

在文件 sysfs-kernel-mm-damon 中定义

向此文件写入数字 'N' 会在 schemes/ 目录下创建名为 '0' 到 'N-1' 的多个目录，用于控制上下文的每个基于 DAMON 的操作方案。

/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/targets/<T>/pid_target

在文件 sysfs-kernel-mm-damon 中定义

写入和读取此文件会分别设置和获取目标进程的 pid（如果上下文用于虚拟地址空间监视）。

/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/targets/<T>/regions/<R>/end

在文件 sysfs-kernel-mm-damon 中定义

写入和读取此文件会设置和获取监视区域的结束地址。

/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/targets/<T>/regions/<R>/start

在文件 sysfs-kernel-mm-damon 中定义

写入和读取此文件会设置和获取监视区域的起始地址。

/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/targets/<T>/regions/nr_regions

在文件 sysfs-kernel-mm-damon 中定义

向此文件写入数字 'N' 会在 regions/ 目录下创建名为 '0' 到 'N-1' 的多个目录，用于设置上下文的每个 DAMON 目标内存区域。在虚拟地址空间监视的情况下，DAMON 会基于目标进程的映射自动设置目标内存区域。

/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/targets/nr_targets

在文件 sysfs-kernel-mm-damon 中定义

向此文件写入数字 'N' 会在 contexts/ 目录下创建名为 '0' 到 'N-1' 的多个目录，用于控制上下文的每个 DAMON 目标。

/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/nr_contexts

在文件 sysfs-kernel-mm-damon 中定义

向此文件写入数字 'N' 会在 contexts/ 目录下创建名为 '0' 到 'N-1' 的多个目录，用于控制每个 DAMON 上下文。

/sys/kernel/mm/damon/admin/kdamonds/<K>/pid

在文件 sysfs-kernel-mm-damon 中定义

如果 kdamond 正在运行，读取此文件会返回其 pid。

/sys/kernel/mm/damon/admin/kdamonds/<K>/state

在文件 sysfs-kernel-mm-damon 中定义

向此文件写入 'on' 或 'off' 会分别启动或停止 kdamond。读取该文件会根据当前状态返回关键字。向此文件写入 'commit' 会使 kdamond 再次读取 sysfs 文件中的用户输入（除了 'state'）。向此文件写入 'commit_schemes_quota_goals' 会使 kdamond 再次读取配额目标文件。向此文件写入 'update_schemes_stats' 会更新 kdamond 的方案统计文件内容。向此文件写入 'update_schemes_tried_regions' 会更新此 kdamond 的每个方案目录的 'tried_regions' 目录内容。向此文件写入 'update_schemes_tried_bytes' 仅更新此 kdamond 的 '.../tried_regions/total_bytes' 文件。向此文件写入 'clear_schemes_tried_regions' 会删除 'tried_regions' 目录的内容。向此文件写入 'update_schemes_effective_quotas' 会更新此 kdamond 的 '.../quotas/effective_bytes' 文件。

/sys/kernel/mm/damon/admin/kdamonds/nr_kdamonds

在文件 sysfs-kernel-mm-damon 中定义

向此文件写入数字 'N' 会在 kdamonds/ 目录下创建名为 '0' 到 'N-1' 的多个目录，用于控制每个 DAMON 工作线程 (kdamond)。

/sys/kernel/mm/hugepages/

定义于文件 sysfs-kernel-mm-hugepages

/sys/kernel/mm/hugepages/ 包含多个形如 hugepages-<size>kB 的子目录，其中 <size> 是内核/CPU 组合支持的巨页页面大小。

在这些目录下有许多文件

  • nr_hugepages

  • nr_overcommit_hugepages

  • free_hugepages

  • surplus_hugepages

  • resv_hugepages

详见 HugeTLB 页。

/sys/kernel/mm/ksm

定义于文件 sysfs-kernel-mm-ksm

内核同页合并 (KSM) 的接口

/sys/kernel/mm/ksm/full_scans

/sys/kernel/mm/ksm/pages_shared

/sys/kernel/mm/ksm/pages_sharing

/sys/kernel/mm/ksm/pages_to_scan

/sys/kernel/mm/ksm/pages_unshared

/sys/kernel/mm/ksm/pages_volatile

/sys/kernel/mm/ksm/run

/sys/kernel/mm/ksm/sleep_millisecs

定义于文件 sysfs-kernel-mm-ksm

内核同页合并守护进程 sysfs 接口

full_scans：已扫描所有可合并区域的次数。

pages_shared：正在使用的共享页面的数量。

pages_sharing：有多少个站点正在共享它们，即节省了多少。

pages_to_scan：在 ksmd 进入休眠状态之前要扫描的当前页面的数量。

pages_unshared：唯一但重复检查合并的页面的数量。

pages_volatile：有多少页面变化太快而无法放置到树中。

run：写入 0 以禁用 ksm，在 ksm 被禁用时读取 0。

  • 写入 1 以运行 ksm，在 ksm 运行时读取 1。

  • 写入 2 以禁用 ksm 并取消合并其所有页面。

sleep_millisecs：ksm 在扫描之间应休眠多少毫秒。

有关更多信息，请参阅 内核同页合并。

/sys/kernel/mm/ksm/general_profit

定义于文件 sysfs-kernel-mm-ksm

衡量 KSM 的效率。general_profit：KSM 的效率如何。计算公式在 内核同页合并 中。

/sys/kernel/mm/ksm/merge_across_nodes

定义于文件 sysfs-kernel-mm-ksm

控制跨不同 NUMA 节点合并页面。

当设置为 0 时，仅合并来自同一节点的页面，否则可以合并来自所有节点的页面（默认）。

/sys/kernel/mm/mempolicy/

定义于文件 sysfs-kernel-mm-mempolicy

内存策略接口

/sys/kernel/mm/mempolicy/weighted_interleave/

定义于文件 sysfs-kernel-mm-mempolicy-weighted-interleave

加权交错策略的配置接口

/sys/kernel/mm/mempolicy/weighted_interleave/nodeN

定义于文件 sysfs-kernel-mm-mempolicy-weighted-interleave

nodeN 的权重配置接口

内存节点 (N) 的交错权重。具有将其 mempolicy 设置为 MPOL_WEIGHTED_INTERLEAVE 的任务会使用这些权重。

这些权重仅影响新的分配，并且在运行时进行更改不会导致已分配页面的迁移。

节点的最小权重始终为 1。

最小权重：1 最大权重：255

写入空字符串或 0 会将权重重置为系统默认值。系统默认值可以在启动时或在热插拔事件期间由内核或驱动程序设置。

/sys/kernel/mm/numa/

定义于文件 sysfs-kernel-mm-numa

NUMA 接口

/sys/kernel/mm/numa/demotion_enabled

定义于文件 sysfs-kernel-mm-numa

启用/禁用在回收期间降级页面

回收期间的页面迁移适用于具有分层内存配置的系统。这些系统具有多种类型的内存，其性能特征各异，而不是在不同距离处发现相同类型内存的普通 NUMA 系统。允许在回收期间进行页面迁移使这些系统能够在快速层面临压力时将页面从快速层迁移到慢速层。此迁移在交换之前执行。它可能会将数据移动到不属于分配进程的 cpuset 的 NUMA 节点，这可能会被解释为违反了 cpusets 的保证。不应在需要严格 cpuset 位置保证的系统上启用此功能。

/sys/kernel/mm/swap/

定义于文件 sysfs-kernel-mm-swap

交换接口

/sys/kernel/mm/swap/vma_ra_enabled

定义于文件 sysfs-kernel-mm-swap

启用/禁用基于 VMA 的交换预读。

如果设置为 true，基于 VMA 的交换预读算法将用于在 VMA 中映射的可交换匿名页面，全局交换预读算法仍将用于 tmpfs 等其他用户。如果设置为 false，全局交换预读算法将用于所有可交换页面。

/sys/kernel/mm/transparent_hugepage/

定义于文件 sysfs-kernel-mm-transparent-hugepage

/sys/kernel/mm/transparent_hugepage/ 包含多个文件和子目录，

  • defrag

  • enabled

  • hpage_pmd_size

  • khugepaged

  • shmem_enabled

  • use_zero_page

  • 形如 hugepages-<size>kB 的子目录，其中 <size> 是内核/CPU 组合支持的巨页页面大小。

有关详细信息，请参阅 透明巨页支持。

/sys/kernel/oops_count

定义于文件 sysfs-kernel-oops_count

显示自上次启动以来系统发生 Oops 的次数。

/sys/kernel/profiling

定义于文件 sysfs-profiling

/sys/kernel/profiling 是启动时 profile= 选项的运行时等效项。

您可以运行以下命令获得相同的效果

echo 2 > /sys/kernel/profiling

就像在启动命令行中发出 profile=2 一样。

/sys/kernel/reboot

定义于文件 sysfs-kernel-reboot

设置内核重启行为的接口，类似于通过 reboot= cmdline 选项可以完成的操作。（请参阅 内核的命令行参数）

/sys/kernel/reboot/cpu

定义于文件 sysfs-kernel-reboot

用于重启的 CPU 编号。

/sys/kernel/reboot/force

定义于文件 sysfs-kernel-reboot

不要等待重启时的任何其他 CPU，并避免任何可能挂起的情况。

/sys/kernel/reboot/mode

定义于文件 sysfs-kernel-reboot

重启模式。有效值为：cold warm hard soft gpio

/sys/kernel/reboot/type

定义于文件 sysfs-kernel-reboot

重启类型。有效值为：bios acpi kbd triple efi pci

/sys/kernel/security/*/evm/evm_xattrs

定义于文件 evm

显示用于计算或验证 EVM 签名的扩展属性集，并允许在运行时添加其他属性。在添加其他属性之后生成的任何签名（以及在具有这些其他属性的文件上生成的签名），只有在系统启动时配置了相同的其他属性才有效。写入单个句点 (.) 将锁定 xattr 列表，使其无法进一步修改。

/sys/kernel/security/*/ima/policy

定义于文件 ima_policy

可信计算组织 (TCG) 运行时完整性度量架构 (IMA) 维护一个可执行文件和其他加载到系统运行时的敏感系统文件的哈希值列表。在运行时，可以基于 LSM 的特定数据约束策略。通过打开文件，一次写入一条规则，然后关闭文件，将策略加载到 securityfs 文件 ima/policy 中。新的策略在文件 ima/policy 关闭后生效。

如果配置了 IMA 评估，它将使用这些文件度量进行本地度量评估。

rule format: action [condition ...]

action: measure | dont_measure | appraise | dont_appraise |
        audit | hash | dont_hash
condition:= base | lsm  [option]
      base:   [[func=] [mask=] [fsmagic=] [fsuuid=] [fsname=]
              [uid=] [euid=] [gid=] [egid=]
              [fowner=] [fgroup=]]
      lsm:    [[subj_user=] [subj_role=] [subj_type=]
               [obj_user=] [obj_role=] [obj_type=]]
      option: [digest_type=] [template=] [permit_directio]
              [appraise_type=] [appraise_flag=]
              [appraise_algos=] [keyrings=]
base:
      func:= [BPRM_CHECK][MMAP_CHECK][CREDS_CHECK][FILE_CHECK][MODULE_CHECK]
              [FIRMWARE_CHECK]
              [KEXEC_KERNEL_CHECK] [KEXEC_INITRAMFS_CHECK]
              [KEXEC_CMDLINE] [KEY_CHECK] [CRITICAL_DATA]
              [SETXATTR_CHECK][MMAP_CHECK_REQPROT]
      mask:= [[^]MAY_READ] [[^]MAY_WRITE] [[^]MAY_APPEND]
             [[^]MAY_EXEC]
      fsmagic:= hex value
      fsuuid:= file system UUID (e.g 8bcbe394-4f13-4144-be8e-5aa9ea2ce2f6)
      uid:= decimal value
      euid:= decimal value
      gid:= decimal value
      egid:= decimal value
      fowner:= decimal value
      fgroup:= decimal value
lsm:  are LSM specific
option:
      appraise_type:= [imasig] | [imasig|modsig] | [sigv3]
          where 'imasig' is the original or the signature
              format v2.
          where 'modsig' is an appended signature,
          where 'sigv3' is the signature format v3. (Currently
              limited to fsverity digest based signatures
              stored in security.ima xattr. Requires
              specifying "digest_type=verity" first.)

      appraise_flag:= [check_blacklist] (deprecated)
      Setting the check_blacklist flag is no longer necessary.
      All appraisal functions set it by default.
      digest_type:= verity
          Require fs-verity's file digest instead of the
          regular IMA file hash.
      keyrings:= list of keyrings
      (eg, .builtin_trusted_keys|.ima). Only valid
      when action is "measure" and func is KEY_CHECK.
      template:= name of a defined IMA template type
      (eg, ima-ng). Only valid when action is "measure".
      pcr:= decimal value
      label:= [selinux]|[kernel_info]|[data_label]
      data_label:= a unique string used for grouping and limiting critical data.
      For example, "selinux" to measure critical data for SELinux.
      appraise_algos:= comma-separated list of hash algorithms
      For example, "sha256,sha512" to only accept to appraise
      files where the security.ima xattr was hashed with one
      of these two algorithms.

default policy:
      # PROC_SUPER_MAGIC
      dont_measure fsmagic=0x9fa0
      dont_appraise fsmagic=0x9fa0
      # SYSFS_MAGIC
      dont_measure fsmagic=0x62656572
      dont_appraise fsmagic=0x62656572
      # DEBUGFS_MAGIC
      dont_measure fsmagic=0x64626720
      dont_appraise fsmagic=0x64626720
      # TMPFS_MAGIC
      dont_measure fsmagic=0x01021994
      dont_appraise fsmagic=0x01021994
      # RAMFS_MAGIC
      dont_appraise fsmagic=0x858458f6
      # DEVPTS_SUPER_MAGIC
      dont_measure fsmagic=0x1cd1
      dont_appraise fsmagic=0x1cd1
      # BINFMTFS_MAGIC
      dont_measure fsmagic=0x42494e4d
      dont_appraise fsmagic=0x42494e4d
      # SECURITYFS_MAGIC
      dont_measure fsmagic=0x73636673
      dont_appraise fsmagic=0x73636673
      # SELINUX_MAGIC
      dont_measure fsmagic=0xf97cff8c
      dont_appraise fsmagic=0xf97cff8c
      # CGROUP_SUPER_MAGIC
      dont_measure fsmagic=0x27e0eb
      dont_appraise fsmagic=0x27e0eb
      # NSFS_MAGIC
      dont_measure fsmagic=0x6e736673
      dont_appraise fsmagic=0x6e736673

      measure func=BPRM_CHECK
      measure func=FILE_MMAP mask=MAY_EXEC
      measure func=FILE_CHECK mask=MAY_READ uid=0
      measure func=MODULE_CHECK
      measure func=FIRMWARE_CHECK
      appraise fowner=0

默认策略测量 bprm_check 中的所有可执行文件，file_mmap 中所有映射为可执行文件的文件，以及 do_filp_open 中 root 用户打开进行读取的所有文件。默认评估策略评估所有由 root 用户拥有的文件。

LSM 特定定义的示例

SELinux

dont_measure obj_type=var_log_t
dont_appraise obj_type=var_log_t
dont_measure obj_type=auditd_log_t
dont_appraise obj_type=auditd_log_t
measure subj_user=system_u func=FILE_CHECK mask=MAY_READ
measure subj_role=system_r func=FILE_CHECK mask=MAY_READ

Smack

measure subj_user=_ func=FILE_CHECK mask=MAY_READ

使用备用 PCR 的度量规则示例

measure func=KEXEC_KERNEL_CHECK pcr=4
measure func=KEXEC_INITRAMFS_CHECK pcr=5

允许附加 modsig 签名的评估规则示例

appraise func=KEXEC_KERNEL_CHECK appraise_type=imasig|modsig

使用 KEY_CHECK 度量所有密钥的度量规则示例

measure func=KEY_CHECK

使用 KEY_CHECK 仅度量添加到 .builtin_trusted_keys 或 .ima 密钥环的密钥的度量规则示例

measure func=KEY_CHECK keyrings=.builtin_trusted_keys|.ima

特殊 SETXATTR_CHECK 评估规则的示例，它限制写入文件的 security.ima xattr 时允许的哈希算法

appraise func=SETXATTR_CHECK appraise_algos=sha256,sha384,sha512

一个“measure”规则的示例，该规则需要 fs-verity 的摘要，并在度量列表中指示摘要类型。

measure func=FILE_CHECK digest_type=verity

template=ima-ngv2

存储在 security.ima xattr 中的需要 fs-verity 签名（格式版本 3）的“measure”和“appraise”规则示例。

“measure”规则指定“ima-sigv3”模板选项，其中包括度量列表中摘要类型和文件签名的指示。

measure func=BPRM_CHECK digest_type=verity

template=ima-sigv3

“appraise”规则指定所需的类型和签名格式版本 (sigv3)。

appraise func=BPRM_CHECK digest_type=verity

appraise_type=sigv3

例如，所有这些策略规则都可以基于文件系统的 UUID (fsuuid) 或基于 LSM 标签进行约束。

/sys/kernel/security/evm

/sys/kernel/security/*/evm

定义于文件 evm

EVM 保护文件的安全扩展属性 (xattr) 免受完整性攻击。初始方法在扩展属性中维护一个 HMAC-sha1 值，并将该值存储为扩展属性“security.evm”。

EVM 支持两种类型的 security.evm。第一种是使用存储在内核密钥保留系统中的受信任/加密密钥在本地生成的 HMAC-sha1。第二种是使用非对称密钥在本地或远程生成的数字签名。这些密钥使用 keyctl 加载到 root 的密钥环中，然后通过向 <securityfs>/evm 回显一个值来启用 EVM，该值由以下位组成

位

效果

0

启用 HMAC 验证和创建

1

启用数字签名验证

2

允许在运行时修改受 EVM 保护的元数据。如果启用了 HMAC 验证和创建，则不支持（已弃用）。

31

禁用进一步运行时修改 EVM 策略

例如

echo 1 ><securityfs>/evm

将启用 HMAC 验证和创建

echo 0x80000003 ><securityfs>/evm

将启用 HMAC 和数字签名验证以及 HMAC 创建，并禁用所有进一步的策略修改。

echo 0x80000006 ><securityfs>/evm

将启用数字签名验证，允许修改受 EVM 保护的元数据，并禁用所有进一步的策略修改。此选项现在已被弃用，取而代之的是

echo 0x80000002 ><securityfs>/evm

因为阻止使用 EVM 可移植签名的突出问题已得到解决。

回显值是累加的，新值会添加到现有的初始化标志中。

例如，在

echo 2 ><securityfs>/evm

之后，可以执行另一个回显

echo 1 ><securityfs>/evm

结果值将为 3。

请注意，一旦加载了 HMAC 密钥，将无法再启用元数据修改。发出已加载 HMAC 密钥的信号将清除相应的标志。例如，如果当前值为 6（设置了 2 和 4）

echo 1 ><securityfs>/evm

将新值设置为 3（清除 4）。

加载 HMAC 密钥是禁用元数据修改的唯一方法。

在发出密钥加载信号之前，EVM 无法创建或验证“security.evm”xattr，但会返回 INTEGRITY_UNKNOWN。加载密钥并发出 EVM 信号应尽早完成。通常，这是在 initramfs 中完成的，initramfs 已作为受信任引导的一部分进行度量。有关创建和加载现有受信任/加密密钥的更多信息，请参阅： 受信任和加密的密钥。dracut（通过 97masterkey 和 98integrity）和 systemd（通过 core/ima-setup）都支持在启动时加载密钥。

/sys/kernel/slab

定义于文件 sysfs-kernel-slab

/sys/kernel/slab 目录包含每个缓存的 SLUB 分配器内部状态的快照。可以修改某些文件以更改缓存的行为（以及它所别名的任何缓存）。

用户：内核内存调整工具

/sys/kernel/slab/<cache>/aliases

定义于文件 sysfs-kernel-slab

aliases 文件是只读的，并指定有多少缓存已合并到此缓存中。

/sys/kernel/slab/<cache>/align

定义于文件 sysfs-kernel-slab

align 文件是只读的，并指定缓存的对象对齐（以字节为单位）。

/sys/kernel/slab/<cache>/alloc_calls

定义于文件 sysfs-kernel-slab

alloc_calls 文件是只读的，并列出为此缓存执行分配的内核代码位置。仅当为该缓存启用了调试时，alloc_calls 文件才包含信息（请参阅 SLUB 简短用户指南）。

/sys/kernel/slab/<cache>/alloc_fastpath

定义于文件 sysfs-kernel-slab

alloc_fastpath 文件显示使用快速路径已分配了多少个对象。可以写入该文件以清除当前计数。当启用 CONFIG_SLUB_STATS 时可用。

/sys/kernel/slab/<cache>/alloc_from_partial

定义于文件 sysfs-kernel-slab

alloc_from_partial 文件显示 cpu slab 已满的次数，并且通过使用部分使用 slab 列表中的 slab 重新填充的次数。可以写入该文件以清除当前计数。当启用 CONFIG_SLUB_STATS 时可用。

/sys/kernel/slab/<cache>/alloc_refill

定义于文件 sysfs-kernel-slab

alloc_refill 文件显示每次 per-cpu 空闲列表为空，但由于远程 cpu 释放而有可用对象的次数。可以写入该文件以清除当前计数。当启用 CONFIG_SLUB_STATS 时可用。

/sys/kernel/slab/<cache>/alloc_slab

定义于文件 sysfs-kernel-slab

alloc_slab 文件显示从页面分配器分配新 slab 的次数。可以写入该文件以清除当前计数。当启用 CONFIG_SLUB_STATS 时可用。

/sys/kernel/slab/<cache>/alloc_slowpath

定义于文件 sysfs-kernel-slab

alloc_slowpath 文件显示由于重新填充或从部分或新 slab 分配而使用慢速路径分配的对象数量。可以写入该文件以清除当前计数。当启用 CONFIG_SLUB_STATS 时可用。

/sys/kernel/slab/<cache>/cache_dma

定义于文件 sysfs-kernel-slab

cache_dma 文件是只读的，并指定对象是否来自 ZONE_DMA。当启用 CONFIG_ZONE_DMA 时可用。

/sys/kernel/slab/<cache>/cpu_partial

定义于文件 sysfs-kernel-slab

此只读文件显示要保留的每个 cpu 部分页面的数量。

/sys/kernel/slab/<cache>/cpu_slabs

定义于文件 sysfs-kernel-slab

cpu_slabs 文件是只读的，并显示有多少个 cpu slab 处于活动状态及其 NUMA 局部性。

/sys/kernel/slab/<cache>/cpuslab_flush

定义于文件 sysfs-kernel-slab

cpuslab_flush 文件显示由于销毁或缩小缓存、cpu 脱机或强制从某个节点分配而刷新缓存的 cpu slab 的次数。可以写入该文件以清除当前计数。当启用 CONFIG_SLUB_STATS 时可用。

/sys/kernel/slab/<cache>/ctor

定义于文件 sysfs-kernel-slab

ctor 文件是只读的，并指定缓存的对象构造函数，该函数在分配新 slab 时为每个对象调用。

/sys/kernel/slab/<cache>/deactivate_empty

定义于文件 sysfs-kernel-slab

deactivate_empty 文件显示空 cpu slab 被停用的次数。可以写入该文件以清除当前计数。当启用 CONFIG_SLUB_STATS 时可用。

/sys/kernel/slab/<cache>/deactivate_full

定义于文件 sysfs-kernel-slab

deactivate_full 文件显示完整的 cpu slab 被停用的次数。可以写入该文件以清除当前计数。当启用 CONFIG_SLUB_STATS 时可用。

/sys/kernel/slab/<cache>/deactivate_remote_frees

定义于文件 sysfs-kernel-slab

deactivate_remote_frees 文件显示 cpu slab 被停用并且包含远程释放的空闲对象的次数。可以写入该文件以清除当前计数。当启用 CONFIG_SLUB_STATS 时可用。

/sys/kernel/slab/<cache>/deactivate_to_head

定义于文件 sysfs-kernel-slab

deactivate_to_head 文件显示部分 cpu slab 被停用并添加到其节点的部分列表头部的次数。可以写入该文件以清除当前计数。当启用 CONFIG_SLUB_STATS 时可用。

/sys/kernel/slab/<cache>/deactivate_to_tail

定义于文件 sysfs-kernel-slab

deactivate_to_tail 文件显示部分 cpu slab 被停用并添加到其节点的部分列表尾部的次数。可以写入该文件以清除当前计数。当启用 CONFIG_SLUB_STATS 时可用。

/sys/kernel/slab/<cache>/destroy_by_rcu

定义于文件 sysfs-kernel-slab

destroy_by_rcu 文件是只读的，并指定是否由 rcu 释放 slab（而不是对象）。

/sys/kernel/slab/<cache>/free_add_partial

定义于文件 sysfs-kernel-slab

free_add_partial 文件显示在完整 slab 中释放对象从而必须添加到其节点的部分列表中的次数。可以写入该文件以清除当前计数。当启用 CONFIG_SLUB_STATS 时可用。

/sys/kernel/slab/<cache>/free_calls

定义于文件 sysfs-kernel-slab

free_calls 文件是只读的，如果启用了 slab 调试（请参阅 SLUB 简短用户指南），则会列出对象释放的位置。

/sys/kernel/slab/<cache>/free_fastpath

定义于文件 sysfs-kernel-slab

free_fastpath 文件显示了有多少对象使用了快速路径被释放，因为它是一个来自 CPU slab 的对象。可以写入该文件以清除当前计数。当启用 CONFIG_SLUB_STATS 时可用。

/sys/kernel/slab/<cache>/free_frozen

定义于文件 sysfs-kernel-slab

free_frozen 文件显示了有多少对象被释放到了冻结的 slab（即远程 CPU slab）。可以写入该文件以清除当前计数。当启用 CONFIG_SLUB_STATS 时可用。

/sys/kernel/slab/<cache>/free_remove_partial

定义于文件 sysfs-kernel-slab

free_remove_partial 文件显示了有多少次对象被释放到一个现在为空的 slab，因此它必须从其节点的 partial 列表中删除。可以写入该文件以清除当前计数。当启用 CONFIG_SLUB_STATS 时可用。

/sys/kernel/slab/<cache>/free_slab

定义于文件 sysfs-kernel-slab

free_slab 文件显示了有多少次空的 slab 被释放回页面分配器。可以写入该文件以清除当前计数。当启用 CONFIG_SLUB_STATS 时可用。

/sys/kernel/slab/<cache>/free_slowpath

定义于文件 sysfs-kernel-slab

free_slowpath 文件显示了有多少对象使用了慢速路径被释放（即释放到已满或部分 slab）。可以写入该文件以清除当前计数。当启用 CONFIG_SLUB_STATS 时可用。

/sys/kernel/slab/<cache>/hwcache_align

定义于文件 sysfs-kernel-slab

hwcache_align 文件是只读的，并指定对象是否在缓存行上对齐。

/sys/kernel/slab/<cache>/min_partial

定义于文件 sysfs-kernel-slab

min_partial 文件指定了在一个节点的 partial 列表上应保留多少个空 slab，以避免分配新 slab 的开销。这些 slab 可以通过使用 shrink 文件来回收。

/sys/kernel/slab/<cache>/object_size

定义于文件 sysfs-kernel-slab

object_size 文件是只读的，并指定缓存的对象大小。

/sys/kernel/slab/<cache>/objects

定义于文件 sysfs-kernel-slab

objects 文件是只读的，并显示有多少对象处于活动状态以及它们来自哪些节点。

/sys/kernel/slab/<cache>/objects_partial

定义于文件 sysfs-kernel-slab

objects_partial 文件是只读的，并显示有多少对象在 partial slab 上以及它们来自哪些节点。

/sys/kernel/slab/<cache>/objs_per_slab

定义于文件 sysfs-kernel-slab

objs_per_slab 文件是只读的，并指定了可以从 /sys/kernel/slab/<cache>/order 中指定的阶数的单个 slab 中分配多少个对象。

/sys/kernel/slab/<cache>/order

定义于文件 sysfs-kernel-slab

order 文件指定了分配新 slab 的页面阶数。它是可写的，可以更改以增加每个 slab 的对象数量。如果由于碎片而无法分配 slab，SLUB 将根据其特性使用可能的最小阶数重试。

当指定 debug_guardpage_minorder=N (N > 0) 参数时（请参阅 内核的命令行参数），将使用可能的最小阶数，并且此 sysfs 条目不能用于在运行时更改阶数。

/sys/kernel/slab/<cache>/order_fallback

定义于文件 sysfs-kernel-slab

order_fallback 文件显示了有多少次在缓存的阶数无法分配新 slab，而是回退到其可能的最小阶数。可以写入该文件以清除当前计数。

当启用 CONFIG_SLUB_STATS 时可用。

/sys/kernel/slab/<cache>/partial

定义于文件 sysfs-kernel-slab

partial 文件是只读的，并显示有多少个 partial slab，以及每个节点的列表有多长。

/sys/kernel/slab/<cache>/poison

定义于文件 sysfs-kernel-slab

poison 文件指定了当分配新的 slab 时，是否应该对对象进行中毒处理。

/sys/kernel/slab/<cache>/reclaim_account

定义于文件 sysfs-kernel-slab

reclaim_account 文件指定了缓存的对象是否可回收（并按其可移动性分组）。

/sys/kernel/slab/<cache>/red_zone

定义于文件 sysfs-kernel-slab

red_zone 文件指定了缓存的对象是否启用了红区。

/sys/kernel/slab/<cache>/remote_node_defrag_ratio

定义于文件 sysfs-kernel-slab

remote_node_defrag_ratio 文件指定了 SLUB 将尝试使用来自远程节点的 partial slab 重新填充 CPU slab 的百分比，而不是在本地节点上分配新的 slab。这减少了整个系统中浪费的内存量，但可能代价高昂。

当启用 CONFIG_NUMA 时可用。

/sys/kernel/slab/<cache>/sanity_checks

定义于文件 sysfs-kernel-slab

sanity_checks 文件指定了是否应该在释放时执行昂贵的检查，并且至少启用双重释放检查。启用 sanity_checks 的缓存不能与未启用的缓存合并。

/sys/kernel/slab/<cache>/shrink

定义于文件 sysfs-kernel-slab

shrink 文件用于从缓存中回收未使用的 slab 缓存内存。空的 per-cpu 或 partial slab 被释放，并且 partial 列表被排序，以便首先使用可用对象最少的 slab。它只接受写入值 “1” 以收缩缓存。其他输入值被认为是无效的。收缩 slab 缓存可能代价高昂，并且可能对其他正在运行的应用程序产生不利影响。因此应谨慎使用。

/sys/kernel/slab/<cache>/slab_size

定义于文件 sysfs-kernel-slab

slab_size 文件是只读的，并以字节为单位指定了带有元数据（调试信息和对齐）的对象大小。

/sys/kernel/slab/<cache>/slabs

定义于文件 sysfs-kernel-slab

slabs 文件是只读的，并显示有多少个 slab（包括 CPU 和 partial）以及它们来自哪些节点。

/sys/kernel/slab/<cache>/slabs_cpu_partial

定义于文件 sysfs-kernel-slab

此只读文件显示了部分分配的冻结 slab 的数量。

/sys/kernel/slab/<cache>/store_user

定义于文件 sysfs-kernel-slab

store_user 文件指定是否应为缓存跟踪分配或释放的位置。

/sys/kernel/slab/<cache>/total_objects

定义于文件 sysfs-kernel-slab

total_objects 文件是只读的，并显示缓存拥有的对象总数以及它们来自哪些节点。

/sys/kernel/slab/<cache>/trace

定义于文件 sysfs-kernel-slab

trace 文件指定了是否应跟踪对象分配和释放。

/sys/kernel/slab/<cache>/usersize

定义于文件 sysfs-kernel-slab

usersize 文件是只读的，并包含用户复制区域大小。

/sys/kernel/slab/<cache>/validate

定义于文件 sysfs-kernel-slab

写入 validate 文件会导致 SLUB 遍历其缓存的所有对象并检查元数据的有效性。

/sys/kernel/vmcoreinfo

定义在 sysfs-kernel-vmcoreinfo 文件中

显示 vmcoreinfo ELF 注释的物理地址和大小。第一个值包含注释的十六进制物理地址，第二个值包含注释的十六进制大小。此 ELF 注释信息由第二个内核解析，并作为 /proc/vmcore 文件中 ELF 注释的一部分导出到用户空间。此注释包含各种信息，如结构大小、符号值、页面大小等。

/sys/kernel/warn_count

定义在 sysfs-kernel-warn_count 文件中

显示自上次启动以来系统警告的次数。

/sys/module 下的符号

/sys/module/*/initstate

定义在 sysfs-module 文件中

显示模块的初始化状态（live、coming、going）。

/sys/module/*/taint

定义在 sysfs-module 文件中

模块污染标志

P

专有模块

O

树外模块

F

强制加载的模块

C

staging 驱动程序模块

E

未签名模块

/sys/module/*/{coresize,initsize}

定义在 sysfs-module 文件中

模块大小（以字节为单位）。

/sys/module/ehci_hcd/drivers/.../uframe_periodic_max

定义在 sysfs-module 文件中

每个微帧允许的周期性传输的最大时间 (μs)

注意

USB 2.0 将每个微帧的周期性传输的最大允许时间设置为 80%，即 125 微秒（完整微帧）中的 100 微秒。

但是，在某些情况下，80% 的最大同步带宽限制过于严格。例如，两个视频流可能需要每个微帧 110 微秒的同步带宽才能协同工作。

通过此设置，可以提高限制，以便主机控制器允许分配每个微帧超过 100 微秒的周期性带宽。

注意，非标准模式通常没有经过硬件设计人员的彻底测试，并且当此设置与默认值 100 不同时，硬件可能会发生故障。

/sys/module/grant_table/parameters/free_per_iteration

定义在 sysfs-module 文件中

读取和写入每次迭代尝试释放的 grant 条目数。

注意：未来版本的 Xen 和 Linux 可能会提供更好的接口来控制延迟 grant 回收率，或者可能根本不需要它。

用户：Qubes OS (https://www.qubes-os.org)

/sys/module/pch_phub/drivers/.../pch_firmware

定义在 sysfs-module 文件中

写入/读取 Option ROM 数据。

/sys/module/pch_phub/drivers/.../pch_mac

定义在 sysfs-module 文件中

写入/读取 GbE MAC 地址。

/sys/module/xen_blkback/parameters/buffer_squeeze_duration_ms

定义在 sysfs-driver-xen-blkback 文件中

当内存压力报告给 blkback 时，此选项控制 blkback 将不会缓存任何未由 grant 映射支持的页面的持续时间（以毫秒为单位）。默认值为 10 毫秒。

/sys/module/xen_blkback/parameters/feature_persistent

定义在 sysfs-driver-xen-blkback 文件中

是否启用持久 grant 功能。请注意，此选项仅对新连接的后端生效。默认值为 Y（启用）。

/sys/module/xen_blkback/parameters/max_buffer_pages

定义在 sysfs-driver-xen-blkback 文件中

每个块后端缓冲区中要保留的最大空闲页面数。

/sys/module/xen_blkback/parameters/max_persistent_grants

定义在 sysfs-driver-xen-blkback 文件中

在 blkback 中持久映射的最大 grant 数。如果前端尝试使用超过 max_persistent_grants 的数量，LRU 将启动并每 100 毫秒删除 5% 的 max_persistent_grants。

/sys/module/xen_blkback/parameters/persistent_grant_unused_seconds

定义在 sysfs-driver-xen-blkback 文件中

允许持久 grant 在未使用的情况下保持分配的时间。时间以秒为单位，0 表示无限长。默认值为 60 秒。

/sys/module/xen_blkfront/parameters/feature_persistent

定义在 sysfs-driver-xen-blkfront 文件中

是否启用持久 grant 功能。请注意，此选项仅对新连接的前端生效。默认值为 Y（启用）。

/sys/module/xen_blkfront/parameters/max_indirect_segments

定义在 sysfs-driver-xen-blkfront 文件中

前端与后端协商间接描述符的最大段数。默认值为 32 - 值越高，潜在吞吐量越大，但内存使用量也越大。后端选择前端值和其默认后端值的最小值。

/sys/power 下的符号

/sys/power/

在文件 sysfs-power 中定义

/sys/power 目录包含一些文件，这些文件为电源管理子系统提供统一的接口。

/sys/power/autosleep

在文件 sysfs-power 中定义

可以向 /sys/power/autosleep 文件写入从 /sys/power/state 读取返回的字符串之一。如果发生这种情况，则会将一个工作项排队，尝试触发系统转换为该字符串所代表的睡眠状态。只有在此时系统中没有活动的唤醒源时，此尝试才会成功。每次执行后，无论系统是否成功进入睡眠状态，该工作项都会重新排队，直到用户空间向 /sys/power/autosleep 写入“off”。

从该文件读取会导致返回上次成功写入的字符串。

/sys/power/disk

在文件 sysfs-power 中定义

/sys/power/disk 文件控制挂起至磁盘机制的运行模式。从该文件读取会返回系统下次挂起时将进入的睡眠模式的名称。支持四种方法：

“firmware” - 表示内存映像将由某些固件保存到磁盘，在这种情况下，我们也假设固件将处理系统挂起。

“platform” - 内存映像将由内核保存，系统将由平台驱动程序（例如 ACPI 或其他 PM 寄存器）置于睡眠状态。

“shutdown” - 内存映像将由内核保存，系统将断电。

“reboot” - 内存映像将由内核保存，系统将重新启动。

此外，/sys/power/disk 可用于打开挂起至磁盘机制的两种测试模式之一：“testproc”或“test”。如果挂起至磁盘机制处于 “testproc” 模式，则向 /sys/power/state 写入“disk”将导致内核禁用非引导 CPU 并冻结任务，等待 5 秒钟，解冻任务并启用非引导 CPU。如果它处于 “test” 模式，则向 /sys/power/state 写入“disk”将导致内核禁用非引导 CPU 并冻结任务，缩小内存，挂起设备，等待 5 秒钟，恢复设备，解冻任务并启用非引导 CPU。然后，我们可以查看日志消息并找出，例如，哪些代码运行缓慢以及哪些设备驱动程序行为不正常。

可以通过将以下认可的字符串之一写入此文件来选择挂起至磁盘的方法

  • “firmware”

  • “platform”

  • “shutdown”

  • “reboot”

  • “testproc”

  • “test”

只有在系统支持的情况下，它才会更改为“firmware”或“platform”。

/sys/power/image_size

在文件 sysfs-power 中定义

/sys/power/image_size 文件控制挂起至磁盘机制创建的映像大小。可以向其写入一个表示非负整数的字符串，该整数将用作映像大小（以字节为单位）的上限。内核的挂起至磁盘代码将尽最大努力确保映像大小不超过此数字。但是，如果事实证明不可能，内核将尝试使用尽可能小的映像来挂起。特别是，如果向此文件写入 “0”，则挂起映像将尽可能小。

从该文件读取将显示当前的映像大小限制，默认情况下设置为可用 RAM 的 2/5 左右。

/sys/power/mem_sleep

在文件 sysfs-power 中定义

/sys/power/mem_sleep 文件控制系统挂起的运行模式。从它读取将返回可用模式，如 “s2idle”（始终存在）、“shallow” 和 “deep”（如果支持则存在）。在后续尝试挂起系统时（通过向上面描述的 /sys/power/state 文件写入“mem”）将使用的模式用方括号括起来。

将以上字符串之一写入此文件会导致在后续尝试挂起系统时使用它所代表的模式。

有关详细信息，请参见 系统睡眠状态。

/sys/power/pm_async

在文件 sysfs-power 中定义

/sys/power/pm_async 文件控制允许用户空间启用或禁用设备的异步挂起和恢复的开关。如果启用，此功能将导致某些设备驱动程序的挂起和恢复回调与其他回调以及主挂起线程并行执行。如果此文件包含“1”，则启用此功能，这是默认值。可以通过向此文件写入“0”来禁用它，在这种情况下，所有设备将同步挂起和恢复。

/sys/power/pm_debug_messages

在文件 sysfs-power 中定义

/sys/power/pm_debug_messages 文件控制是否将系统挂起/休眠基础结构的调试消息打印到内核日志。

向此文件写入 “1” 会启用调试消息，而写入 “0”（默认值）会禁用它们。从此文件读取会返回当前值。

/sys/power/pm_print_times

在文件 sysfs-power 中定义

/sys/power/pm_print_times 文件允许用户空间控制是否打印设备挂起和恢复所花费的时间。这些打印对于查找挂起或恢复时间过长的设备很有用。

写入“1”会启用此打印，而写入“0”会禁用此打印。默认值为 “0”。从此文件读取将显示当前值。

/sys/power/pm_trace

在文件 sysfs-power 中定义

/sys/power/pm_trace 文件控制在重启时保存 RTC 中最后一个 PM 事件点的代码，以便您可以调试在挂起期间（或更常见的是，在恢复期间）挂起的机器。也就是说，仅当此文件包含 “1” 时，RTC 才用于保存最后一个 PM 事件点。它最初包含“0”，可以通过向其中写入表示非零整数的字符串将其更改为“1”。

要使用此调试功能，您应该尝试挂起机器，然后重新启动它并运行

dmesg -s 1000000 | grep 'hash matches'

如果您没有得到任何匹配项（或者它们似乎是误报），则最后一个 PM 事件点可能指的是由可加载内核模块创建的设备。在这种情况下，在系统启动并加载内核模块后，请 cat /sys/power/pm_trace_dev_match（参见下文）。

警告：使用它会导致您的机器的实时 (CMOS) 时钟在恢复后设置为随机的无效时间。

内容：/sys/power/pm_trace_dev_match /sys/power/pm_trace_dev_match 文件包含与使用 pm_trace 时在重启时保存在 RTC 中的最后一个 PM 事件点关联的设备的名称。更准确地说，它包含启动时与 RTC 中的设备哈希匹配的当前设备列表（包括自启动以来由可加载内核模块注册的设备），每个设备后都有一个换行符。

此文件相对于打印到内核日志的哈希匹配项的优势（参见 /sys/power/pm_trace），在于它包括启动后由可加载内核模块创建的设备。

由于必须适合 RTC 的小哈希大小，因此可能存在多个设备与该哈希匹配，在这种情况下，需要进一步调查以确定哪个设备导致了问题。请注意，真正的 RTC 时钟值（例如，当未使用 pm_trace 时）仍然可以匹配设备并在此处输出其名称。

/sys/power/pm_wakeup_irq

在文件 sysfs-power 中定义

/sys/power/pm_wakeup_irq 文件向用户空间报告内核在最近一次系统挂起/恢复周期中看到的第一个唤醒中断（即，来自为系统唤醒而激活的 IRQ 行的第一个中断）的 IRQ 编号。

此输出对于误报唤醒中断的系统唤醒诊断很有用。

/sys/power/reserved_size

在文件 sysfs-power 中定义

/sys/power/reserved_size 文件允许用户空间控制在休眠的 “设备冻结” 阶段由设备驱动程序进行的分配保留的内存量。可以向其写入一个表示非负整数的字符串，该整数将用作保留给设备驱动程序的 “冻结” 回调所做的分配的内存量（以字节为单位）。

从此文件读取将显示当前值，默认情况下设置为 1 MB。

/sys/power/resume_offset

在文件 sysfs-power 中定义

此文件用于告知内核在休眠系统时要使用的磁盘偏移量，例如使用交换文件。

从此文件读取将显示内核在下次尝试休眠时将使用的当前偏移量。

使用此 sysfs 文件将覆盖使用磁盘偏移量的内核命令行设置的任何值。

/sys/power/state

在文件 sysfs-power 中定义

/sys/power/state 文件控制系统睡眠状态。从此文件读取会返回可用的睡眠状态标签，这些标签可能是 “mem”（挂起）、“standby”（启动挂起）、“freeze”（挂起至空闲）和 “disk”（休眠）。

向此文件写入以上字符串之一会导致系统转换到相应的状态（如果可用）。

有关详细信息，请参见 系统睡眠状态。

/sys/power/suspend_stats

在文件 sysfs-power 中定义

/sys/power/suspend_stats 目录包含与挂起相关的统计信息。

/sys/power/suspend_stats/fail

在文件 sysfs-power 中定义

/sys/power/suspend_stats/fail 文件包含进入系统睡眠状态失败的次数。

/sys/power/suspend_stats/failed_freeze

在文件 sysfs-power 中定义

/sys/power/suspend_stats/failed_freeze 文件包含冻结进程失败的次数。

/sys/power/suspend_stats/failed_prepare

在文件 sysfs-power 中定义

/sys/power/suspend_stats/failed_prepare 文件包含为系统 PM 转换准备所有非 sysdev 设备失败的次数。

/sys/power/suspend_stats/failed_resume

在文件 sysfs-power 中定义

/sys/power/suspend_stats/failed_resume 文件包含非 sysdev 设备执行“恢复”回调失败的次数。

/sys/power/suspend_stats/failed_resume_early

在文件 sysfs-power 中定义

/sys/power/suspend_stats/failed_resume_early 文件包含设备执行“提前恢复”回调失败的次数。

/sys/power/suspend_stats/failed_resume_noirq

在文件 sysfs-power 中定义

/sys/power/suspend_stats/failed_resume_noirq 文件包含设备执行“无中断恢复”回调失败的次数。

/sys/power/suspend_stats/failed_suspend

在文件 sysfs-power 中定义

/sys/power/suspend_stats/failed_suspend 文件包含所有非 sysdev 设备执行“挂起”回调失败的次数。

/sys/power/suspend_stats/failed_suspend_late

在文件 sysfs-power 中定义

/sys/power/suspend_stats/failed_suspend_late 文件包含所有设备执行“延迟挂起”回调失败的次数。

/sys/power/suspend_stats/failed_suspend_noirq

在文件 sysfs-power 中定义

/sys/power/suspend_stats/failed_suspend_noirq 文件包含所有设备执行“无中断挂起”回调失败的次数。

/sys/power/suspend_stats/last_failed_dev

在文件 sysfs-power 中定义

/sys/power/suspend_stats/last_failed_dev 文件包含上次挂起/恢复回调失败的设备。

/sys/power/suspend_stats/last_failed_errno

在文件 sysfs-power 中定义

/sys/power/suspend_stats/last_failed_errno 文件包含上次尝试进入系统睡眠状态失败的错误码。

/sys/power/suspend_stats/last_failed_step

在文件 sysfs-power 中定义

/sys/power/suspend_stats/last_failed_step 文件包含挂起/恢复路径中上次失败的步骤。

/sys/power/suspend_stats/last_hw_sleep

在文件 sysfs-power 中定义

/sys/power/suspend_stats/last_hw_sleep 文件包含最近一次系统挂起-恢复周期中，硬件睡眠状态所花费的时间。该数字以微秒为单位。

/sys/power/suspend_stats/max_hw_sleep

在文件 sysfs-power 中定义

/sys/power/suspend_stats/max_hw_sleep 文件包含硬件可以报告的在硬件睡眠状态所花费的最大时间量。当睡眠周期长于此时间时，“total_hw_sleep”和“last_hw_sleep”的值可能不准确。该数字以微秒为单位。

/sys/power/suspend_stats/success

在文件 sysfs-power 中定义

/sys/power/suspend_stats/success 文件包含成功进入系统睡眠状态的次数。

/sys/power/suspend_stats/total_hw_sleep

在文件 sysfs-power 中定义

/sys/power/suspend_stats/total_hw_sleep 文件包含自内核启动以来，在硬件睡眠状态所花费的累计时间。该数字以微秒为单位。

/sys/power/sync_on_suspend

在文件 sysfs-power 中定义

此文件控制内核是否在系统挂起期间（在冻结用户空间之后和挂起设备之前）同步()文件系统。

向此文件写入“1”会启用 sync()，写入“0”会禁用它。读取文件将返回当前值。如果构建时未设置“SUSPEND_SKIP_SYNC”配置标志，则默认为“1”，否则为“0”。

/sys/power/wake_lock

在文件 sysfs-power 中定义

/sys/power/wake_lock 文件允许用户空间创建唤醒源对象并根据需要激活它们（如果这些唤醒源之一处于活动状态，则读取 /sys/power/wakeup_count 文件会阻塞或返回 false）。当一个不包含空格的字符串写入 /sys/power/wake_lock 时，它将被视为表示唤醒源名称。如果存在具有该名称的唤醒源对象，它将被激活（除非已处于活动状态）。否则，将注册一个新的唤醒源对象，分配给定的名称并激活。如果写入 /sys/power/wake_lock 的字符串包含空格，则该字符串中空格之前的部分将被视为唤醒源名称并按上述方式处理。该字符串的另一部分将被视为超时（以纳秒为单位），以便唤醒源在过期后自动停用。无论所讨论的唤醒源对象的当前状态如何，都会设置超时（如果存在）。

读取此文件会返回一个字符串，该字符串由当前处于活动状态的，借助此文件创建的唤醒源的名称组成，并用空格分隔。

/sys/power/wake_unlock

在文件 sysfs-power 中定义

/sys/power/wake_unlock 文件允许用户空间停用借助 /sys/power/wake_lock 创建的唤醒源。当一个字符串写入 /sys/power/wake_unlock 时，它将被视为表示要停用的唤醒源的名称。

如果存在该名称的唤醒源对象并且当前处于活动状态，则会将其停用。

读取此文件会返回一个字符串，该字符串由当前处于非活动状态的，借助 /sys/power/wake_lock 创建的唤醒源的名称组成，并用空格分隔。

/sys/power/wakeup_count

在文件 sysfs-power 中定义

/sys/power/wakeup_count 文件允许用户空间在考虑唤醒事件并发到达的情况下将系统置于睡眠状态。读取它将返回当前注册的唤醒事件的数量，并且如果在读取文件时正在处理某些唤醒事件，则会阻塞。只有当当前唤醒事件数等于写入的值时，写入才会成功，并且如果成功，则如果在写入返回后报告了任何唤醒事件，则会使内核中止随后的睡眠状态转换。

当 USB 主机控制器死亡时引发 uevent

当 USB 主机控制器死亡时引发 uevent

在文件 usb-uevent 中定义

当 USB 主机控制器进入不再可用的状态时，将引发 uevent。该 uevent 将包含 ACTION=offline 和 ERROR=DEAD。

以下是使用 udevadm monitor -p 截取的示例

KERNEL[130.428945] offline  /devices/pci0000:00/0000:00:10.0/usb2 (usb)
ACTION=offline
BUSNUM=002
DEVNAME=/dev/bus/usb/002/001
DEVNUM=001
DEVPATH=/devices/pci0000:00/0000:00:10.0/usb2
DEVTYPE=usb_device
DRIVER=usb
ERROR=DEAD
MAJOR=189
MINOR=128
PRODUCT=1d6b/2/414
SEQNUM=2168
SUBSYSTEM=usb
TYPE=9/0/1

用户: chromium-os-dev@chromium.org

当插入或移除 USB 充电器时引发 uevent

当插入或移除 USB 充电器时引发 uevent

在文件 usb-charger-uevent 中定义

存在两种 USB 充电器状态

  • USB_CHARGER_ABSENT

  • USB_CHARGER_PRESENT

存在五种 USB 充电器类型

USB_CHARGER_UNKNOWN_TYPE

充电器类型未知

USB_CHARGER_SDP_TYPE

标准下行端口

USB_CHARGER_CDP_TYPE

充电下行端口

USB_CHARGER_DCP_TYPE

专用充电端口

USB_CHARGER_ACA_TYPE

附件充电适配器

https://www.usb.org/document-library/battery-charging-v12-spec-and-adopters-agreement

以下是当 USB 充电器在线时，使用 udevadm monitor -p 截取的两个示例

UDEV  change   /devices/soc0/usbphynop1 (platform)
ACTION=change
DEVPATH=/devices/soc0/usbphynop1
DRIVER=usb_phy_generic
MODALIAS=of:Nusbphynop1T(null)Cusb-nop-xceiv
OF_COMPATIBLE_0=usb-nop-xceiv
OF_COMPATIBLE_N=1
OF_FULLNAME=/usbphynop1
OF_NAME=usbphynop1
SEQNUM=2493
SUBSYSTEM=platform
USB_CHARGER_STATE=USB_CHARGER_PRESENT
USB_CHARGER_TYPE=USB_CHARGER_SDP_TYPE
USEC_INITIALIZED=227422826

USB 充电器处于离线状态

KERNEL change   /devices/soc0/usbphynop1 (platform)
ACTION=change
DEVPATH=/devices/soc0/usbphynop1
DRIVER=usb_phy_generic
MODALIAS=of:Nusbphynop1T(null)Cusb-nop-xceiv
OF_COMPATIBLE_0=usb-nop-xceiv
OF_COMPATIBLE_N=1
OF_FULLNAME=/usbphynop1
OF_NAME=usbphynop1
SEQNUM=2494
SUBSYSTEM=platform
USB_CHARGER_STATE=USB_CHARGER_ABSENT
USB_CHARGER_TYPE=USB_CHARGER_UNKNOWN_TYPE

nvdimm

nvdimm

在文件 sysfs-bus-nvdimm 中定义

libnvdimm 子系统为平台 nvdimm 资源实现了一个通用的 sysfs 接口。请参阅 Documentation/driver-api/nvdimm/。

security/secrets 下的符号

security/secrets/coco

在文件 securityfs-secrets-coco 中定义

通过 securityfs 向用户空间公开机密计算 (coco) EFI 机密。

EFI 可以声明由机密计算平台（例如 AMD SEV 和 SEV-ES）用于在虚拟机启动期间由访客所有者进行机密注入的内存区域。这些机密由访客所有者加密，并在可信的飞地内解密，因此不受信任的主机无法读取。

efi_secret 模块向用户空间公开这些机密。每个机密都以 <securityfs>/secrets/coco 下的文件形式出现，其中文件名是机密表中条目的 GUID。如果填充了 EFI 机密区域，则 EFI 驱动程序会自动加载此模块。

这些文件支持两种操作：读取和取消链接。读取文件会返回机密条目的内容。取消链接文件会用零覆盖机密数据，并从文件系统中删除该条目。取消链接后，机密无法读取。

例如，列出可用的机密

# modprobe efi_secret
# ls -l /sys/kernel/security/secrets/coco
-r--r----- 1 root root 0 Jun 28 11:54 736870e5-84f0-4973-92ec-06879ce3da0b
-r--r----- 1 root root 0 Jun 28 11:54 83c83f7f-1356-4975-8b7e-d3a0b54312c6
-r--r----- 1 root root 0 Jun 28 11:54 9553f55d-3da2-43ee-ab5d-ff17f78864d2
-r--r----- 1 root root 0 Jun 28 11:54 e6f5a162-d67f-4750-a67c-5d065f2a9910

通过读取文件读取机密数据

# cat /sys/kernel/security/secrets/coco/e6f5a162-d67f-4750-a67c-5d065f2a9910
the-content-of-the-secret-data

通过取消链接文件擦除机密

# rm /sys/kernel/security/secrets/coco/e6f5a162-d67f-4750-a67c-5d065f2a9910
# ls -l /sys/kernel/security/secrets/coco
-r--r----- 1 root root 0 Jun 28 11:54 736870e5-84f0-4973-92ec-06879ce3da0b
-r--r----- 1 root root 0 Jun 28 11:54 83c83f7f-1356-4975-8b7e-d3a0b54312c6
-r--r----- 1 root root 0 Jun 28 11:54 9553f55d-3da2-43ee-ab5d-ff17f78864d2

注意：访客所有者注入的机密表的二进制格式在 drivers/virt/coco/efi_secret/efi_secret.c 中的“EFI 机密区域的结构”下进行了描述。

文件 testing/configfs-acpi

具有以下 ABI

文件 testing/configfs-iio

具有以下 ABI

文件 testing/configfs-most

具有以下 ABI

文件 testing/configfs-rdma_cm

具有以下 ABI

文件 testing/configfs-spear-pcie-gadget

具有以下 ABI

文件 testing/configfs-stp-policy

具有以下 ABI

文件 testing/configfs-stp-policy-p_sys-t

具有以下 ABI

文件 testing/configfs-tsm

具有以下 ABI

文件 testing/configfs-usb-gadget

具有以下 ABI

文件 testing/configfs-usb-gadget-acm

具有以下 ABI

文件 testing/configfs-usb-gadget-ecm

具有以下 ABI

文件 testing/configfs-usb-gadget-eem

具有以下 ABI

文件 testing/configfs-usb-gadget-ffs

具有以下 ABI

文件 testing/configfs-usb-gadget-hid

具有以下 ABI

文件 testing/configfs-usb-gadget-loopback

具有以下 ABI

文件 testing/configfs-usb-gadget-mass-storage

具有以下 ABI

文件 testing/configfs-usb-gadget-midi

具有以下 ABI

文件 testing/configfs-usb-gadget-midi2

具有以下 ABI

文件 testing/configfs-usb-gadget-ncm

具有以下 ABI

文件 testing/configfs-usb-gadget-obex

具有以下 ABI

文件 testing/configfs-usb-gadget-phonet

具有以下 ABI

文件 testing/configfs-usb-gadget-printer

具有以下 ABI

文件 testing/configfs-usb-gadget-rndis

具有以下 ABI

文件 testing/configfs-usb-gadget-serial

具有以下 ABI

文件 testing/configfs-usb-gadget-sourcesink

具有以下 ABI

文件 testing/configfs-usb-gadget-subset

具有以下 ABI

文件 testing/configfs-usb-gadget-tcm

具有以下 ABI

文件 testing/configfs-usb-gadget-uac1

具有以下 ABI

文件 testing/configfs-usb-gadget-uac1_legacy

具有以下 ABI

文件 testing/configfs-usb-gadget-uac2

具有以下 ABI

文件 testing/configfs-usb-gadget-uvc

具有以下 ABI

文件 testing/debugfs-cec-error-inj

具有以下 ABI

文件 testing/debugfs-cros-ec

具有以下 ABI

文件 testing/debugfs-cxl

具有以下 ABI

文件 testing/debugfs-dell-wmi-ddv

具有以下 ABI

文件 testing/debugfs-driver-dcc

具有以下 ABI

文件 testing/debugfs-driver-genwqe

具有以下 ABI

文件 testing/debugfs-driver-habanalabs

具有以下 ABI

文件 testing/debugfs-driver-qat

具有以下 ABI

文件 testing/debugfs-driver-qat_telemetry

具有以下 ABI

文件 testing/debugfs-ec

具有以下 ABI

文件 testing/debugfs-hisi-hpre

具有以下 ABI

文件 testing/debugfs-hisi-migration

具有以下 ABI

文件 testing/debugfs-hisi-sec

具有以下 ABI

文件 testing/debugfs-hisi-zip

具有以下 ABI

文件 testing/debugfs-hyperv

具有以下 ABI

文件 testing/debugfs-ideapad

具有以下 ABI

文件 testing/debugfs-iio-ad9467

具有以下 ABI

文件 testing/debugfs-iio-backend

具有以下 ABI

文件 testing/debugfs-intel-iommu

具有以下 ABI

文件 testing/debugfs-moxtet

具有以下 ABI

文件 testing/debugfs-msi-wmi-platform

具有以下 ABI

文件 testing/debugfs-olpc

具有以下 ABI

文件 testing/debugfs-pfo-nx-crypto

具有以下 ABI

文件 testing/debugfs-pktcdvd

具有以下 ABI

文件 testing/debugfs-scmi

具有以下 ABI

文件 testing/debugfs-scmi-raw

具有以下 ABI

文件 testing/debugfs-tpmi

具有以下 ABI

文件 testing/debugfs-turris-mox-rwtm

具有以下 ABI

文件 testing/debugfs-vfio

具有以下 ABI

文件 testing/debugfs-wilco-ec

具有以下 ABI

文件 testing/dell-smbios-wmi

具有以下 ABI

文件 testing/dev-kmsg

具有以下 ABI

文件 testing/evm

具有以下 ABI

文件 testing/gpio-cdev

具有以下 ABI

文件 testing/ima_policy

具有以下 ABI

文件 testing/ppc-memtrace

具有以下 ABI

文件 testing/procfs-attr-current

具有以下 ABI

文件 testing/procfs-attr-exec

具有以下 ABI

文件 testing/procfs-attr-prev

具有以下 ABI

文件 testing/procfs-diskstats

具有以下 ABI

文件 testing/procfs-smaps_rollup

具有以下 ABI

文件 testing/pstore

具有以下 ABI

文件 testing/rtc-cdev

具有以下 ABI

文件 testing/securityfs-secrets-coco

具有以下 ABI

文件 testing/sysfs-amd-pmc

具有以下 ABI

文件 testing/sysfs-amd-pmf

具有以下 ABI

文件 testing/sysfs-ata

具有以下 ABI

文件 testing/sysfs-block-aoe

具有以下 ABI

文件 testing/sysfs-block-bcache

具有以下 ABI

文件 testing/sysfs-block-device

具有以下 ABI

文件 testing/sysfs-block-dm

具有以下 ABI

文件 testing/sysfs-block-loop

具有以下 ABI

文件 testing/sysfs-block-rnbd

具有以下 ABI

文件 testing/sysfs-block-rssd

具有以下 ABI

文件 testing/sysfs-block-zram

具有以下 ABI

文件 testing/sysfs-bus-acpi

具有以下 ABI

文件 testing/sysfs-bus-amba

具有以下 ABI

文件 testing/sysfs-bus-auxiliary

具有以下 ABI

文件 testing/sysfs-bus-bcma

具有以下 ABI

文件 testing/sysfs-bus-cdx

具有以下 ABI

文件 testing/sysfs-bus-coreboot

具有以下 ABI

文件 testing/sysfs-bus-coresight-devices-cti

具有以下 ABI

文件 testing/sysfs-bus-coresight-devices-etb10

具有以下 ABI

文件 testing/sysfs-bus-coresight-devices-etm3x

具有以下 ABI

文件 testing/sysfs-bus-coresight-devices-etm4x

具有以下 ABI

文件 testing/sysfs-bus-coresight-devices-funnel

具有以下 ABI

文件 testing/sysfs-bus-coresight-devices-stm

具有以下 ABI

文件 testing/sysfs-bus-coresight-devices-tmc

具有以下 ABI

文件 testing/sysfs-bus-coresight-devices-tpdm

具有以下 ABI

文件 testing/sysfs-bus-coresight-devices-trbe

具有以下 ABI

文件 testing/sysfs-bus-coresight-devices-ultra_smb

具有以下 ABI

文件 testing/sysfs-bus-counter

具有以下 ABI

文件 testing/sysfs-bus-css

具有以下 ABI

文件 testing/sysfs-bus-cxl

具有以下 ABI

文件 testing/sysfs-bus-dax

具有以下 ABI

文件 testing/sysfs-bus-dfl

具有以下 ABI

文件 testing/sysfs-bus-dfl-devices-emif

具有以下 ABI

文件 testing/sysfs-bus-dfl-devices-n3000-nios

具有以下 ABI

文件 testing/sysfs-bus-event_source-devices-caps

具有以下 ABI

文件 testing/sysfs-bus-event_source-devices-dfl_fme

具有以下 ABI

文件 testing/sysfs-bus-event_source-devices-dsa

具有以下 ABI

文件 testing/sysfs-bus-event_source-devices-events

具有以下 ABI

文件 testing/sysfs-bus-event_source-devices-format

具有以下 ABI

文件 testing/sysfs-bus-event_source-devices-hisi_ptt

具有以下 ABI

文件 testing/sysfs-bus-event_source-devices-hv_24x7

具有以下 ABI

文件 testing/sysfs-bus-event_source-devices-hv_gpci

具有以下 ABI

文件 testing/sysfs-bus-event_source-devices-iommu

具有以下 ABI

文件 testing/sysfs-bus-event_source-devices-uncore

具有以下 ABI

文件 testing/sysfs-bus-event_source-devices-vpa-pmu

具有以下 ABI

文件 testing/sysfs-bus-fcoe

具有以下 ABI

文件 testing/sysfs-bus-fsi

具有以下 ABI

文件 testing/sysfs-bus-fsi-devices-sbefifo

具有以下 ABI

文件 testing/sysfs-bus-fsl-mc

具有以下 ABI

文件 testing/sysfs-bus-hsi

具有以下 ABI

文件 testing/sysfs-bus-i2c-devices-bq32k

具有以下 ABI

文件 testing/sysfs-bus-i2c-devices-fsa9480

具有以下 ABI

文件 testing/sysfs-bus-i2c-devices-hm6352

具有以下 ABI

文件 testing/sysfs-bus-i2c-devices-lm3533

具有以下 ABI

文件 testing/sysfs-bus-i2c-devices-pca954x

具有以下 ABI

文件 testing/sysfs-bus-i2c-devices-turris-omnia-mcu

具有以下 ABI

文件 testing/sysfs-bus-i3c

具有以下 ABI

文件 testing/sysfs-bus-iio

具有以下 ABI

文件 testing/sysfs-bus-iio-accel-adxl372

具有以下 ABI

文件 testing/sysfs-bus-iio-accel-bmc150

具有以下 ABI

文件 testing/sysfs-bus-iio-ad9739a

具有以下 ABI

文件 testing/sysfs-bus-iio-adc-ad7192

具有以下 ABI

文件 testing/sysfs-bus-iio-adc-ad7280a

具有以下 ABI

文件 testing/sysfs-bus-iio-adc-envelope-detector

具有以下 ABI

文件 testing/sysfs-bus-iio-adc-hi8435

具有以下 ABI

文件 testing/sysfs-bus-iio-adc-max11410

具有以下 ABI

文件 testing/sysfs-bus-iio-adc-mcp3564

具有以下 ABI

文件 testing/sysfs-bus-iio-adc-mt6360

具有以下 ABI

文件 testing/sysfs-bus-iio-adc-pac1934

具有以下 ABI

文件 testing/sysfs-bus-iio-adc-stm32

具有以下 ABI

文件 testing/sysfs-bus-iio-bno055

具有以下 ABI

文件 testing/sysfs-bus-iio-cdc-ad7746

具有以下 ABI

文件 testing/sysfs-bus-iio-chemical-sgp40

具有以下 ABI

文件 testing/sysfs-bus-iio-chemical-sunrise-co2

具有以下 ABI

文件 testing/sysfs-bus-iio-chemical-vz89x

具有以下 ABI

文件 testing/sysfs-bus-iio-cros-ec

具有以下 ABI

文件 testing/sysfs-bus-iio-dac

具有以下 ABI

文件 testing/sysfs-bus-iio-dac-ad5766

具有以下 ABI

文件 testing/sysfs-bus-iio-dac-dpot-dac

具有以下 ABI

文件 testing/sysfs-bus-iio-dac-ltc2688

具有以下 ABI

文件 testing/sysfs-bus-iio-dfsdm-adc-stm32

具有以下 ABI

文件 testing/sysfs-bus-iio-distance-srf08

具有以下 ABI

文件 testing/sysfs-bus-iio-dma-buffer

具有以下 ABI

文件 testing/sysfs-bus-iio-filter-admv8818

具有以下 ABI

文件 testing/sysfs-bus-iio-frequency-ad9523

具有以下 ABI

文件 testing/sysfs-bus-iio-frequency-adf4350

具有以下 ABI

文件 testing/sysfs-bus-iio-frequency-adf4371

具有以下 ABI

文件 testing/sysfs-bus-iio-frequency-admv1013

具有以下 ABI

文件 testing/sysfs-bus-iio-frequency-admv1014

具有以下 ABI

文件 testing/sysfs-bus-iio-gyro-bmg160

具有以下 ABI

文件 testing/sysfs-bus-iio-health-afe440x

具有以下 ABI

文件 testing/sysfs-bus-iio-humidity

具有以下 ABI

文件 testing/sysfs-bus-iio-impedance-analyzer-ad5933

具有以下 ABI

文件 testing/sysfs-bus-iio-ina2xx-adc

具有以下 ABI

文件 testing/sysfs-bus-iio-inv_icm42600

具有以下 ABI

文件 testing/sysfs-bus-iio-isl29501

具有以下 ABI

文件 testing/sysfs-bus-iio-light-isl29018

具有以下 ABI

文件 testing/sysfs-bus-iio-light-lm3533-als

具有以下 ABI

文件 testing/sysfs-bus-iio-light-si1133

具有以下 ABI

文件 testing/sysfs-bus-iio-light-tsl2583

具有以下 ABI

文件 testing/sysfs-bus-iio-light-tsl2772

具有以下 ABI

文件 testing/sysfs-bus-iio-magnetometer-hmc5843

具有以下 ABI

文件 testing/sysfs-bus-iio-meas-spec

具有以下 ABI

文件 testing/sysfs-bus-iio-mpu6050

具有以下 ABI

文件 testing/sysfs-bus-iio-potentiometer-mcp4531

具有以下 ABI

文件 testing/sysfs-bus-iio-proximity

具有以下 ABI

文件 testing/sysfs-bus-iio-proximity-as3935

具有以下 ABI

文件 testing/sysfs-bus-iio-resolver-ad2s1210

具有以下 ABI

文件 testing/sysfs-bus-iio-sps30

具有以下 ABI

文件 testing/sysfs-bus-iio-sx9310

具有以下 ABI

文件 testing/sysfs-bus-iio-sx9324

具有以下 ABI

文件 testing/sysfs-bus-iio-thermocouple

具有以下 ABI

文件 testing/sysfs-bus-iio-timer-stm32

具有以下 ABI

文件 testing/sysfs-bus-iio-trigger-sysfs

具有以下 ABI

文件 testing/sysfs-bus-iio-vf610

具有以下 ABI

文件 testing/sysfs-bus-intel_th-devices-gth

具有以下 ABI

文件 testing/sysfs-bus-intel_th-devices-msc

具有以下 ABI

文件 testing/sysfs-bus-intel_th-devices-pti

具有以下 ABI

文件 testing/sysfs-bus-intel_th-output-devices

具有以下 ABI

文件 testing/sysfs-bus-mcb

具有以下 ABI

文件 testing/sysfs-bus-mdio

具有以下 ABI

文件 testing/sysfs-bus-media

具有以下 ABI

文件 testing/sysfs-bus-mei

具有以下 ABI

文件 testing/sysfs-bus-mmc

具有以下 ABI

文件 testing/sysfs-bus-most

具有以下 ABI

文件 testing/sysfs-bus-moxtet-devices

具有以下 ABI

文件 testing/sysfs-bus-nfit

对于 nfit/* 下的所有 nmem 设备属性，请参阅 ACPI 规范中的“NVDIMM 固件接口表 (NFIT)”部分（http://www.uefi.org/specifications）以获取更多详细信息。

具有以下 ABI

文件 testing/sysfs-bus-nvdimm

具有以下 ABI

文件 testing/sysfs-bus-optee-devices

具有以下 ABI

文件 testing/sysfs-bus-papr-pmem

具有以下 ABI

文件 testing/sysfs-bus-pci

具有以下 ABI

文件 testing/sysfs-bus-pci-devices-aer_stats

PCIe 设备 AER 统计信息

这些属性显示在所有具有 AER 功能的设备下。这些统计计数器表示“设备看到/报告的”错误。请注意，这可能意味着如果某个端点导致问题，则其链路伙伴（例如根端口）上的 AER 计数器可能会递增，因为错误可能由链路伙伴“看到”/报告，而不是有问题的端点本身（它可能将所有计数器报告为 0，因为它从未发现任何问题）。

具有以下 ABI

文件 testing/sysfs-bus-pci-devices-avs

具有以下 ABI

文件 testing/sysfs-bus-pci-devices-catpt

具有以下 ABI

文件 testing/sysfs-bus-pci-devices-cciss

具有以下 ABI

文件 testing/sysfs-bus-pci-devices-pvpanic

具有以下 ABI

文件 testing/sysfs-bus-pci-drivers-ehci_hcd

具有以下 ABI

文件 testing/sysfs-bus-pci-drivers-janz-cmodio

具有以下 ABI

文件 testing/sysfs-bus-pci-drivers-xhci_hcd

具有以下 ABI

文件 testing/sysfs-bus-peci

具有以下 ABI

文件 testing/sysfs-bus-platform

具有以下 ABI

文件 testing/sysfs-bus-platform-devices-ampere-smpro

具有以下 ABI

文件 testing/sysfs-bus-platform-devices-occ-hwmon

具有以下 ABI

文件 testing/sysfs-bus-platform-drivers-amd_x3d_vcache

具有以下 ABI

文件 testing/sysfs-bus-platform-onboard-usb-dev

具有以下 ABI

文件 testing/sysfs-bus-rapidio

具有以下 ABI

文件 testing/sysfs-bus-rbd

具有以下 ABI

文件 testing/sysfs-bus-rpmsg

具有以下 ABI

文件 testing/sysfs-bus-siox

具有以下 ABI

文件 testing/sysfs-bus-soundwire-master

具有以下 ABI

文件 testing/sysfs-bus-soundwire-slave

具有以下 ABI

文件 testing/sysfs-bus-spi-devices-spi-nor

具有以下 ABI

文件 testing/sysfs-bus-surface_aggregator-tabletsw

具有以下 ABI

文件 testing/sysfs-bus-thunderbolt

具有以下 ABI

文件 testing/sysfs-bus-typec

具有以下 ABI

文件 testing/sysfs-bus-usb

具有以下 ABI

文件 testing/sysfs-bus-usb-devices-usbsevseg

具有以下 ABI

文件 testing/sysfs-bus-usb-lvstest

链路层验证设备是用于测试超高速链路层测试的标准设备。这些节点仅在 lvs 驱动程序与根集线器设备绑定时才在 sysfs 中可用。

具有以下 ABI

文件 testing/sysfs-bus-vdpa

具有以下 ABI

文件 testing/sysfs-bus-vfio-mdev

具有以下 ABI

文件 testing/sysfs-bus-vmbus

具有以下 ABI

文件 testing/sysfs-bus-wmi

具有以下 ABI

文件 testing/sysfs-c2port

具有以下 ABI

文件 testing/sysfs-cfq-target-latency

具有以下 ABI

文件 testing/sysfs-class

具有以下 ABI

文件 testing/sysfs-class-backlight

具有以下 ABI

文件 testing/sysfs-class-backlight-driver-lm3533

具有以下 ABI

文件 testing/sysfs-class-backlight-lm3639

用于德州仪器 lm3639 背光 + 闪光灯 LED 驱动芯片的 sysfs 接口

具有以下 ABI

文件 testing/sysfs-class-bdi

具有以下 ABI

文件 testing/sysfs-class-bsr

具有以下 ABI

文件 testing/sysfs-class-chromeos

具有以下 ABI

文件 testing/sysfs-class-chromeos-driver-cros-ec-lightbar

具有以下 ABI

文件 testing/sysfs-class-chromeos-driver-cros-ec-vbc

具有以下 ABI

文件 testing/sysfs-class-cxl

请注意，设备之间共享的属性存储在符号链接 device/ 所指向的目录中。例如，属性 /sys/class/cxl/afu0.0s/irqs_max 的真实路径是 /sys/class/cxl/afu0.0s/device/irqs_max，即 /sys/class/cxl/afu0.0/irqs_max。

从属上下文（例如，/sys/class/cxl/afu0.0s）

具有以下 ABI

文件 testing/sysfs-class-devfreq

具有以下 ABI

文件 testing/sysfs-class-devfreq-event

具有以下 ABI

文件 testing/sysfs-class-extcon

具有以下 ABI

文件 testing/sysfs-class-fc

具有以下 ABI

文件 testing/sysfs-class-fc_host

具有以下 ABI

文件 testing/sysfs-class-fc_remote_ports

具有以下 ABI

文件 testing/sysfs-class-firmware

具有以下 ABI

文件 testing/sysfs-class-firmware-attributes

具有以下 ABI

文件 testing/sysfs-class-fpga-bridge

具有以下 ABI

文件 testing/sysfs-class-fpga-manager

具有以下 ABI

文件 testing/sysfs-class-fpga-region

具有以下 ABI

文件 testing/sysfs-class-gnss

具有以下 ABI

文件 testing/sysfs-class-hwmon

具有以下 ABI

文件 testing/sysfs-class-intel_pmt

具有以下 ABI

文件 testing/sysfs-class-iommu

具有以下 ABI

文件 testing/sysfs-class-iommu-amd-iommu

具有以下 ABI

文件 testing/sysfs-class-iommu-intel-iommu

具有以下 ABI

文件 testing/sysfs-class-lcd

具有以下 ABI

文件 testing/sysfs-class-led

具有以下 ABI

文件 testing/sysfs-class-led-driver-aw200xx

具有以下 ABI

文件 testing/sysfs-class-led-driver-lm3533

具有以下 ABI

文件 testing/sysfs-class-led-driver-turris-omnia

具有以下 ABI

文件 testing/sysfs-class-led-flash

具有以下 ABI

文件 testing/sysfs-class-led-multicolor

具有以下 ABI

文件 testing/sysfs-class-led-trigger-netdev

具有以下 ABI

文件 testing/sysfs-class-led-trigger-oneshot

具有以下 ABI

文件 testing/sysfs-class-led-trigger-pattern

具有以下 ABI

文件 testing/sysfs-class-led-trigger-tty

具有以下 ABI

文件 testing/sysfs-class-led-trigger-usbport

具有以下 ABI

文件 testing/sysfs-class-leds-gt683r

具有以下 ABI

文件 testing/sysfs-class-mei

具有以下 ABI

文件 testing/sysfs-class-mic

具有以下 ABI

文件 testing/sysfs-class-mtd

具有以下 ABI

文件 testing/sysfs-class-mux

具有以下 ABI

文件 testing/sysfs-class-net

具有以下 ABI

文件 testing/sysfs-class-net-cdc_ncm

具有以下 ABI

文件 testing/sysfs-class-net-dsa

具有以下 ABI

文件 testing/sysfs-class-net-grcan

具有以下 ABI

文件 testing/sysfs-class-net-janz-ican3

具有以下 ABI

文件 testing/sysfs-class-net-peak_usb

具有以下 ABI

文件 testing/sysfs-class-net-phydev

具有以下 ABI

文件 testing/sysfs-class-net-qmi

具有以下 ABI

文件 testing/sysfs-class-net-queues

具有以下 ABI

文件 testing/sysfs-class-net-statistics

具有以下 ABI

文件 testing/sysfs-class-ocxl

具有以下 ABI

文件 testing/sysfs-class-pktcdvd

sysfs 接口

pktcdvd 模块（数据包写入驱动程序）在 sysfs 中创建以下文件：（<devid> 的格式为 major:minor）

具有以下 ABI

文件 testing/sysfs-class-power

通用属性

具有以下 ABI

文件 testing/sysfs-class-power-ltc4162l

具有以下 ABI

文件 testing/sysfs-class-power-mp2629

具有以下 ABI

文件 testing/sysfs-class-power-rt9467

具有以下 ABI

文件 testing/sysfs-class-power-rt9471

具有以下 ABI

文件 testing/sysfs-class-power-surface

具有以下 ABI

文件 testing/sysfs-class-power-twl4030

具有以下 ABI

文件 testing/sysfs-class-power-wilco

具有以下 ABI

文件 testing/sysfs-class-powercap

具有以下 ABI

文件 testing/sysfs-class-pwm

具有以下 ABI

文件 testing/sysfs-class-rapidio

具有以下 ABI

文件 testing/sysfs-class-rc

具有以下 ABI

文件 testing/sysfs-class-rc-nuvoton

具有以下 ABI

文件 testing/sysfs-class-regulator

具有以下 ABI

文件 testing/sysfs-class-remoteproc

具有以下 ABI

文件 testing/sysfs-class-rnbd-client

具有以下 ABI

文件 testing/sysfs-class-rnbd-server

具有以下 ABI

文件 testing/sysfs-class-rtc

具有以下 ABI

文件 testing/sysfs-class-rtc-rtc0-device-rtc_calibration

具有以下 ABI

文件 testing/sysfs-class-rtrs-client

具有以下 ABI

文件 testing/sysfs-class-rtrs-server

具有以下 ABI

文件 testing/sysfs-class-scsi_host

具有以下 ABI

文件 testing/sysfs-class-scsi_tape

具有以下 ABI

文件 testing/sysfs-class-spi-eeprom

具有以下 ABI

文件 testing/sysfs-class-stm

具有以下 ABI

文件 testing/sysfs-class-stm_source

具有以下 ABI

文件 testing/sysfs-class-switchtec

switchtec - Microsemi Switchtec PCI 开关管理端点

有关此子系统的详细信息，请参阅Linux Switchtec 支持。

具有以下 ABI

文件 testing/sysfs-class-tee

具有以下 ABI

文件 testing/sysfs-class-thermal

具有以下 ABI

文件 testing/sysfs-class-typec

USB Type-C 端口设备（例如，/sys/class/typec/port0/）

具有以下 ABI

文件 testing/sysfs-class-usb_power_delivery

具有以下 ABI

文件 testing/sysfs-class-usb_role

具有以下 ABI

文件 testing/sysfs-class-vduse

具有以下 ABI

文件 testing/sysfs-class-wakeup

具有以下 ABI

文件 testing/sysfs-class-watchdog

具有以下 ABI

文件 testing/sysfs-class-zram

具有以下 ABI

文件 testing/sysfs-dev

具有以下 ABI

文件 testing/sysfs-devices

具有以下 ABI

文件 testing/sysfs-devices-consumer

具有以下 ABI

文件 testing/sysfs-devices-coredump

具有以下 ABI

文件 testing/sysfs-devices-edac

具有以下 ABI

文件 testing/sysfs-devices-firmware_node

具有以下 ABI

文件 testing/sysfs-devices-lpss_ltr

具有以下 ABI

文件 testing/sysfs-devices-mapping

具有以下 ABI

文件 testing/sysfs-devices-memory

具有以下 ABI

文件 testing/sysfs-devices-mmc

具有以下 ABI

文件 testing/sysfs-devices-online

具有以下 ABI

文件 testing/sysfs-devices-physical_location

具有以下 ABI

文件 testing/sysfs-devices-platform-ACPI-TAD

ACPI 时间和闹钟 (TAD) 设备属性。

具有以下 ABI

文件 testing/sysfs-devices-platform-_UDC_-gadget

具有以下 ABI

文件 testing/sysfs-devices-platform-docg3

具有以下 ABI

文件 testing/sysfs-devices-platform-dock

具有以下 ABI

文件 testing/sysfs-devices-platform-ipmi

具有以下 ABI

文件 testing/sysfs-devices-platform-kunpeng_hccs

具有以下 ABI

文件 testing/sysfs-devices-platform-sh_mobile_lcdc_fb

具有以下 ABI

文件 testing/sysfs-devices-platform-soc-ipa

具有以下 ABI

文件 testing/sysfs-devices-platform-stratix10-rsu

Intel Stratix10 远程系统更新 (RSU) 设备属性

具有以下 ABI

文件 testing/sysfs-devices-platform-trackpoint

具有以下 ABI

文件 testing/sysfs-devices-power

具有以下 ABI

文件 testing/sysfs-devices-power_resources_D0

具有以下 ABI

文件 testing/sysfs-devices-power_resources_D1

具有以下 ABI

文件 testing/sysfs-devices-power_resources_D2

具有以下 ABI

文件 testing/sysfs-devices-power_resources_D3hot

具有以下 ABI

文件 testing/sysfs-devices-power_resources_wakeup

具有以下 ABI

文件 testing/sysfs-devices-power_state

具有以下 ABI

文件 testing/sysfs-devices-real_power_state

具有以下 ABI

文件 testing/sysfs-devices-removable

具有以下 ABI

文件 testing/sysfs-devices-resource_in_use

具有以下 ABI

文件 testing/sysfs-devices-soc

具有以下 ABI

文件 testing/sysfs-devices-software_node

具有以下 ABI

文件 testing/sysfs-devices-state_synced

具有以下 ABI

文件 testing/sysfs-devices-sun

具有以下 ABI

文件 testing/sysfs-devices-supplier

具有以下 ABI

文件 testing/sysfs-devices-system-cpu

具有以下 ABI

文件 testing/sysfs-devices-system-ibm-rtl

具有以下 ABI

文件 testing/sysfs-devices-system-xen_cpu

具有以下 ABI

文件 testing/sysfs-devices-vfio-dev

具有以下 ABI

文件 testing/sysfs-devices-waiting_for_supplier

具有以下 ABI

文件 testing/sysfs-devices-xenbus

具有以下 ABI

文件 testing/sysfs-driver-altera-cvp

具有以下 ABI

文件 testing/sysfs-driver-aspeed-uart-routing

具有以下 ABI

文件 testing/sysfs-driver-bd9571mwv-regulator

具有以下 ABI

文件 testing/sysfs-driver-ccp

具有以下 ABI

文件 testing/sysfs-driver-chromeos-acpi

具有以下 ABI

文件 testing/sysfs-driver-eud

具有以下 ABI

文件 testing/sysfs-driver-fsi-master-gpio

具有以下 ABI

文件 testing/sysfs-driver-ge-achc

具有以下 ABI

文件 testing/sysfs-driver-genwqe

具有以下 ABI

文件 testing/sysfs-driver-habanalabs

具有以下 ABI

文件 testing/sysfs-driver-hid

具有以下 ABI

文件 testing/sysfs-driver-hid-corsair

具有以下 ABI

文件 testing/sysfs-driver-hid-corsair-void

具有以下 ABI

文件 testing/sysfs-driver-hid-lenovo

具有以下 ABI

文件 testing/sysfs-driver-hid-logitech-hidpp

具有以下 ABI

文件 testing/sysfs-driver-hid-logitech-lg4ff

具有以下 ABI

文件 testing/sysfs-driver-hid-multitouch

具有以下 ABI

文件 testing/sysfs-driver-hid-ntrig

具有以下 ABI

文件 testing/sysfs-driver-hid-picolcd

具有以下 ABI

文件 testing/sysfs-driver-hid-prodikeys

具有以下 ABI

文件 testing/sysfs-driver-hid-roccat-kone

具有以下 ABI

文件 testing/sysfs-driver-hid-srws1

具有以下 ABI

文件 testing/sysfs-driver-hid-wiimote

具有以下 ABI

文件 testing/sysfs-driver-input-axp-pek

具有以下 ABI

文件 testing/sysfs-driver-input-cros-ec-keyb

具有以下 ABI

文件 testing/sysfs-driver-input-exc3000

具有以下 ABI

文件 testing/sysfs-driver-intc_sar

具有以下 ABI

文件 testing/sysfs-driver-intel-i915-hwmon

具有以下 ABI

文件 testing/sysfs-driver-intel-m10-bmc

具有以下 ABI

文件 testing/sysfs-driver-intel-m10-bmc-sec-update

具有以下 ABI

文件 testing/sysfs-driver-intel-rapid-start

具有以下 ABI

文件 testing/sysfs-driver-intel-xe-hwmon

具有以下 ABI

文件 testing/sysfs-driver-intel_sdsi

具有以下 ABI

文件 testing/sysfs-driver-jz4780-efuse

具有以下 ABI

文件 testing/sysfs-driver-panfrost-profiling

具有以下 ABI

文件 testing/sysfs-driver-panthor-profiling

具有以下 ABI

文件 testing/sysfs-driver-pciback

具有以下 ABI

文件 testing/sysfs-driver-ppi

具有以下 ABI

文件 testing/sysfs-driver-qat

具有以下 ABI

文件 testing/sysfs-driver-qat_ras

具有以下 ABI

文件 testing/sysfs-driver-qat_rl

具有以下 ABI

文件 testing/sysfs-driver-samsung-laptop

具有以下 ABI

文件 testing/sysfs-driver-spi-intel

具有以下 ABI

文件 testing/sysfs-driver-st

具有以下 ABI

文件 testing/sysfs-driver-tegra-fuse

具有以下 ABI

文件 testing/sysfs-driver-toshiba_acpi

具有以下 ABI

文件 testing/sysfs-driver-toshiba_haps

具有以下 ABI

文件 testing/sysfs-driver-typec-displayport

具有以下 ABI

文件 testing/sysfs-driver-uacce

具有以下 ABI

文件 testing/sysfs-driver-ucsi-ccg

具有以下 ABI

文件 testing/sysfs-driver-ufs

具有以下 ABI

文件 testing/sysfs-driver-w1_ds28e17

具有以下 ABI

文件 testing/sysfs-driver-w1_therm

具有以下 ABI

文件 testing/sysfs-driver-wacom

具有以下 ABI

文件 testing/sysfs-driver-xdata

具有以下 ABI

文件 testing/sysfs-driver-xen-blkback

具有以下 ABI

文件 testing/sysfs-driver-xen-blkfront

具有以下 ABI

文件 testing/sysfs-driver-xilinx-tmr-manager

具有以下 ABI

文件 testing/sysfs-driver-zynqmp-fpga

具有以下 ABI

文件 testing/sysfs-firmware-acpi

具有以下 ABI

文件 testing/sysfs-firmware-dmi-entries

具有以下 ABI

文件 testing/sysfs-firmware-dmi-tables

具有以下 ABI

文件 testing/sysfs-firmware-efi

具有以下 ABI

文件 testing/sysfs-firmware-efi-esrt

具有以下 ABI

文件 testing/sysfs-firmware-efi-runtime-map

具有以下 ABI

文件 testing/sysfs-firmware-gsmi

具有以下 ABI

文件 testing/sysfs-firmware-initrd

具有以下 ABI

文件 testing/sysfs-firmware-lefi-boardinfo

具有以下 ABI

文件 testing/sysfs-firmware-log

具有以下 ABI

文件 testing/sysfs-firmware-memmap

具有以下 ABI

文件 testing/sysfs-firmware-ofw

具有以下 ABI

文件 testing/sysfs-firmware-opal-powercap

具有以下 ABI

文件 testing/sysfs-firmware-opal-psr

具有以下 ABI

文件 testing/sysfs-firmware-opal-sensor-groups

具有以下 ABI

文件 testing/sysfs-firmware-papr-energy-scale-info

具有以下 ABI

文件 testing/sysfs-firmware-qemu_fw_cfg

具有以下 ABI

文件 testing/sysfs-firmware-sgi_uv

具有以下 ABI

文件 testing/sysfs-firmware-turris-mox-rwtm

具有以下 ABI

文件 testing/sysfs-fs-erofs

具有以下 ABI

文件 testing/sysfs-fs-ext4

具有以下 ABI

文件 testing/sysfs-fs-f2fs

具有以下 ABI

文件 testing/sysfs-fs-nilfs2

具有以下 ABI

文件 testing/sysfs-fs-ubifs

具有以下 ABI

文件 testing/sysfs-fs-virtiofs

具有以下 ABI

文件 testing/sysfs-fs-xfs

具有以下 ABI

文件 testing/sysfs-hypervisor-xen

具有以下 ABI

文件 testing/sysfs-ibft

具有以下 ABI

文件 testing/sysfs-kernel-address_bits

具有以下 ABI

文件 testing/sysfs-kernel-boot_params

具有以下 ABI

文件 testing/sysfs-kernel-btf

具有以下 ABI

文件 testing/sysfs-kernel-cpu_byteorder

具有以下 ABI

文件 testing/sysfs-kernel-dmabuf-buffers

具有以下 ABI

文件 testing/sysfs-kernel-fadump

具有以下 ABI

文件 testing/sysfs-kernel-fscaps

具有以下 ABI

文件 testing/sysfs-kernel-iommu_groups

具有以下 ABI

文件 testing/sysfs-kernel-irq

具有以下 ABI

文件 testing/sysfs-kernel-livepatch

具有以下 ABI

文件 testing/sysfs-kernel-mm

具有以下 ABI

文件 testing/sysfs-kernel-mm-cma

具有以下 ABI

文件 testing/sysfs-kernel-mm-damon

具有以下 ABI

文件 testing/sysfs-kernel-mm-hugepages

具有以下 ABI

文件 testing/sysfs-kernel-mm-ksm

具有以下 ABI

文件 testing/sysfs-kernel-mm-memory-tiers

具有以下 ABI

文件 testing/sysfs-kernel-mm-mempolicy

具有以下 ABI

文件 testing/sysfs-kernel-mm-mempolicy-weighted-interleave

具有以下 ABI

文件 testing/sysfs-kernel-mm-numa

具有以下 ABI

文件 testing/sysfs-kernel-mm-swap

具有以下 ABI

文件 testing/sysfs-kernel-mm-transparent-hugepage

具有以下 ABI

文件 testing/sysfs-kernel-oops_count

具有以下 ABI

文件 testing/sysfs-kernel-reboot

具有以下 ABI

文件 testing/sysfs-kernel-slab

具有以下 ABI

文件 testing/sysfs-kernel-vmcoreinfo

具有以下 ABI

文件 testing/sysfs-kernel-warn_count

具有以下 ABI

文件 testing/sysfs-mce

具有以下 ABI

文件 testing/sysfs-memory-page-offline

具有以下 ABI

文件 testing/sysfs-module

具有以下 ABI

文件 testing/sysfs-nvmem-cells

具有以下 ABI

文件 testing/sysfs-ocfs2

具有以下 ABI

文件 testing/sysfs-platform-asus-laptop

具有以下 ABI

文件 testing/sysfs-platform-asus-wmi

具有以下 ABI

文件 testing/sysfs-platform-at91

具有以下 ABI

文件 testing/sysfs-platform-brcmstb-gisb-arb

具有以下 ABI

文件 testing/sysfs-platform-brcmstb-memc

具有以下 ABI

文件 testing/sysfs-platform-chipidea-usb-otg

具有以下 ABI

文件 testing/sysfs-platform-chipidea-usb2

具有以下 ABI

文件 testing/sysfs-platform-dell-laptop

具有以下 ABI

文件 testing/sysfs-platform-dell-privacy-wmi

具有以下 ABI

文件 testing/sysfs-platform-dell-smbios

具有以下 ABI

文件 testing/sysfs-platform-dell-wmi-ddv

具有以下 ABI

文件 testing/sysfs-platform-dfl-fme

具有以下 ABI

文件 testing/sysfs-platform-dfl-port

具有以下 ABI

文件 testing/sysfs-platform-dptf

具有以下 ABI

文件 testing/sysfs-platform-eeepc-laptop

具有以下 ABI

文件 testing/sysfs-platform-hidma

具有以下 ABI

文件 testing/sysfs-platform-hidma-mgmt

具有以下 ABI

文件 testing/sysfs-platform-i2c-demux-pinctrl

具有以下 ABI

文件 testing/sysfs-platform-ideapad-laptop

具有以下 ABI

文件 testing/sysfs-platform-intel-ifs

设备实例到测试映射 intel_ifs_0 -> 扫描测试 intel_ifs_1 -> 数组 BIST 测试

具有以下 ABI

文件 testing/sysfs-platform-intel-pmc

具有以下 ABI

文件 testing/sysfs-platform-intel-wmi-sbl-fw-update

具有以下 ABI

文件 testing/sysfs-platform-intel-wmi-thunderbolt

具有以下 ABI

文件 testing/sysfs-platform-kim

具有以下 ABI

文件 testing/sysfs-platform-lg-laptop

具有以下 ABI

文件 testing/sysfs-platform-mellanox-bootctl

具有以下 ABI

文件 testing/sysfs-platform-msi-laptop

具有以下 ABI

文件 testing/sysfs-platform-phy-rcar-gen3-usb2

具有以下 ABI

文件 testing/sysfs-platform-power-on-reason

具有以下 ABI

文件 testing/sysfs-platform-renesas_usb3

具有以下 ABI

文件 testing/sysfs-platform-silicom

具有以下 ABI

文件 testing/sysfs-platform-sst-atom

具有以下 ABI

文件 testing/sysfs-platform-tahvo-usb

具有以下 ABI

文件 testing/sysfs-platform-ts5500

具有以下 ABI

文件 testing/sysfs-platform-twl4030-usb

具有以下 ABI

文件 testing/sysfs-platform-usbip-vudc

具有以下 ABI

文件 testing/sysfs-platform-wilco-ec

具有以下 ABI

文件 testing/sysfs-platform_profile

具有以下 ABI

文件 testing/sysfs-power

具有以下 ABI

文件 testing/sysfs-pps

具有以下 ABI

文件 testing/sysfs-profiling

具有以下 ABI

文件 testing/sysfs-ptp

具有以下 ABI

文件 testing/sysfs-secvar

具有以下 ABI

文件 testing/sysfs-timecard

具有以下 ABI

文件 testing/sysfs-tty

具有以下 ABI

文件 testing/sysfs-uevent

具有以下 ABI

文件 testing/usb-charger-uevent

具有以下 ABI

文件 testing/usb-uevent

具有以下 ABI