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 文件包含 AP 端点的 ID,在此端点上接收 IPA“监控”数据。监控端点提供进入 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 挂载时可见。要将 configfs 挂载到 /config 目录,请使用:

# 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 的偏移量,bar0_data 将在此处写入或读取。

bar0_data

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

/config/rdma_cm 下的符号

/config/rdma_cm

定义于文件 configfs-rdma_cm

此接口用于配置与 RDMA-CM 属性相关的 RDMA 线缆 HCA。

属性仅在 configfs 挂载时可见。要将 configfs 挂载到 /config 目录,请使用:# 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”。此参数具有读写访问权限。

/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 源标识符字符串,读写。默认值在 mkdir <node> 时随机生成。来自使用此 <node> 的跟踪源的数据将在 MIPI SyS-T 数据包流中标记此 UUID,以便解码器能够区分同一主/通道范围内的不同源,并识别每个源可能需要的更高级别解码器。

/config/usb-gadget 下的符号

/config/usb-gadget

定义于文件 configfs-usb-gadget

此组包含与创建的 USB gadget 对应的子组。

/config/usb-gadget/gadget

定义于文件 configfs-usb-gadget

gadget 的属性

UDC

将 gadget 绑定到 UDC/解绑 gadget;写入在 /sys/class/udc/* 中找到的 UDC 名称以绑定 gadget,写入空字符串“”以解绑。

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 gadget 的配置

/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 gadget 可用的功能。

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

定义于文件 configfs-usb-gadget

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

属性

compatible_id

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

sub_compatible_id

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

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

定义于文件 configfs-usb-gadget

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

属性

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(模 63),2(无)

isoc_interval

1..16

isoc_maxpacket

0 - 1023(全速),0 - 1024(高速/超高速)

isoc_mult

0..2(仅高速/超高速)

isoc_maxburst

0..15(仅超高速)

buflen

缓冲区长度

bulk_qlen

批量队列深度

iso_qlen

同步队列深度

/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

如果函数准备好使用(例如,如果用户空间已将描述符和字符串写入 ep0,从而可以启用 gadget),则为 1,否则为 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 仿真以及无法以读写模式打开“文件名”,则隐含此项。

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 buffer length

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

Default MIDI protocol

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_version

支持的 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 - 此以太网通过 USB 链接的主机端 MAC 地址

以太网通过 USB 链接

dev_addr - 此以太网通过 USB 链接的设备端 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(仅超高速)

streaming_maxpacket

1..1023 (全速), 1..3072 (高速/超高速)

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

用于从原色计算亮度(luma)和色度(chroma)值的矩阵

bTransferCharacteristics

源图像的光电传输特性,也称为伽马函数

bColorPrimaries

原色和参考白点

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

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

附加颜色匹配描述符

所有属性读/写

bMatrixCoefficients

用于从原色计算亮度(luma)和色度(chroma)值的矩阵

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 String”扩展处理属性。

use

启用/禁用“OS描述符”支持的标志

b_vendor_code

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

qw_sign

要报告为“OS String”本身的标识符

/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 发布时可用的最后一条记录之后。

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

由于非标准行为,错误值也是非标准的。对于非零偏移量,返回 -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

块设备号

c127:3

字符设备号

n8

网络设备接口索引

+sound:card0

子系统:设备名称

标志字段默认带有“-”。“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小时的闹钟并启用中断请求。

  • 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功能可能无法提供。同样,某些较新的功能(包括ACPI启用的功能)由RTC类框架公开,但不能由较旧的驱动程序支持。

/dev/wmi下的符号

/dev/wmi/dell-smbios

在文件 dell-smbios-wmi 上定义

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

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

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

    要确定缓冲区大小,请从WMI字符设备 /dev/wmi/dell-smbios 读取一个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 上定义

由系统中活动的Linux安全模块 (LSM) 在随后的exec()调用后用于进程的安全信息。从该接口读取并获取所标识任务安全状态所需的权限细节取决于LSM。进程无法写入此接口,除非它指向自身。写入此接口并更改所标识任务安全状态所需的其他权限细节取决于LSM。此接口使用的数据格式取决于LSM。SELinux和AppArmor提供此接口。

用户

SELinux 用户空间 AppArmor 用户空间

/proc/*/attr/prev

在文件 procfs-attr-prev 上定义

由系统中活动的Linux安全模块 (LSM) 在最近一次exec()调用之前用于进程的安全信息。从该接口读取所需的权限细节取决于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操作的加权时间(毫秒)

内核4.18+增加了四个用于丢弃跟踪的字段,总数达到18个

15

成功完成的丢弃次数

16

合并的丢弃次数

17

丢弃的扇区数

18

丢弃时间

内核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/.../<device>/<UUID>/

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

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

/sys/.../<device>/<UUID>/mdev_type

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

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

/sys/.../<device>/<UUID>/remove

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

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

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

/sys/.../<device>/mdev_supported_types/

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

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

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

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

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

/sys/.../<device>/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 频率(赫兹)。值为零表示禁用此滤波器。

/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 频率(赫兹)。值为零表示禁用此滤波器。

/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启用的事件进行比较的阈值。

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

名称中的 raw 或 input 元素表示该值是原始设备单位还是处理后的单位(如 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_accelY_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 相同的比例表示。

/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

/sys/.../iio:deviceX/in_intensity_red_raw

/sys/.../iio:deviceX/in_intensity_green_raw

/sys/.../iio:deviceX/in_intensity_blue_raw

/sys/.../iio:deviceX/in_intensity_clear_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 上定义

接近度测量值,通过观察发射的红外线或超声波的反射率,指示某个物体接近传感器。

这些传感器通常无单位,因此无法转换为 SI 单位。较高的接近度测量值表示物体更近,反之亦然。应用刻度和偏移后的单位是米。

/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 上定义

如果类型参数可以取一小组值中的一个,则此属性会列出它们。

/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 频率,单位为赫兹。

/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 频率,单位为赫兹。

/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 帧缓冲,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 动作的名称(addchangeremove)。与之前的功能相比,此处没有变化。扩展格式的其余部分是可选的。

在任何 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 中定义

(读写) 对于支持命令持续时间限制功能的设备,写入此文件以开启或关闭该功能。默认情况下,此功能是关闭的。向此文件写入“1”可在内核中启用读写命令的命令持续时间限制,并在设备上开启该功能。写入“0”则禁用该功能。

/sys/block/*/device/cdl_supported

在文件 sysfs-block-device 中定义

(只读) 指示设备是否支持某些 ATA 和 SCSI 设备中发现的命令持续时间限制功能。

/sys/block/*/device/ncq_prio_enable

在文件 sysfs-block-device 中定义

(读写) 写入此文件以开启或关闭 SATA NCQ(原生命令队列)优先级支持。默认情况下,此功能是关闭的。如果设备不支持 SATA NCQ 优先级功能,则向此文件写入“1”会导致错误(参见 ncq_prio_supported)。

/sys/block/*/device/ncq_prio_supported

在文件 sysfs-block-device 中定义

(只读) 指示设备是否支持 SATA NCQ(原生命令队列)优先级功能。

/sys/block/*/device/sas_ncq_prio_enable

在文件 sysfs-block-device 中定义

(读写) 这相当于连接到 SAS 主机总线适配器 (HBA) 的 SATA 设备的 ncq_prio_enable 属性文件,该 HBA 实现了对 SATA NCQ 优先级功能的支持。如果 HBA 驱动程序未实现对 SATA NCQ 优先级功能的支持,则此文件不存在,无论设备是否支持此功能(参见 sas_ncq_prio_supported)。

/sys/block/*/device/sas_ncq_prio_supported

在文件 sysfs-block-device 中定义

(只读) 这相当于连接到 SAS 主机总线适配器 (HBA) 的 SATA 设备的 ncq_prio_supported 属性文件,该 HBA 实现了对 SATA NCQ 优先级功能的支持。如果 HBA 驱动程序未实现对 SATA NCQ 优先级功能的支持,则此文件不存在,无论设备是否支持此功能。

/sys/block/*/device/sw_activity

在文件 sysfs-block-device 中定义

(读写) 由支持软件控制活动 LED 的驱动程序使用。

它具有以下有效值

0

OFF - 活动时 LED 不激活

1

BLINK_ON - 检测到活动时,LED 每 10 毫秒闪烁一次。

2

BLINK_OFF - 空闲时 LED 亮起,检测到活动时每 10 毫秒熄灭一次。

请注意,如果用户希望通过 em_message 文件控制活动 LED,则必须将 sw_activity 设置为 OFF。

/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 中定义

/sys/block/<device>/iosched/target_latency 仅在用户将 cfq 设置为 /sys/block/<device>/scheduler 时存在。它包含 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 中定义

对于缓存,一个布尔值,允许在设备支持的情况下关闭或重新开启丢弃/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 中定义

设备映射器设备名称。只读字符串,包含映射的设备名称。

用户

util-linux,设备映射器 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 中定义

设备映射器设备挂起状态。设备挂起时包含值 1。否则包含 0。只读属性。

用户

util-linux,设备映射器 udev 规则

/sys/block/dm-<num>/dm/use_blk_mq

在文件 sysfs-block-dm 中定义

基于请求的设备映射器 blk-mq I/O 路径模式。如果设备正在使用 blk-mq,则包含值 1。否则包含 0。只读属性。

/sys/block/dm-<num>/dm/uuid

在文件 sysfs-block-dm 中定义

设备映射器设备 UUID。只读字符串,包含 DM-UUID,如果未设置 DM-UUID 则为空字符串。

用户

util-linux,设备映射器 udev 规则

/sys/block/etherd*/firmware-version

在文件 sysfs-block-aoe 中定义

(只读) 目标中的固件版本。

/sys/block/etherd*/mac

在文件 sysfs-block-aoe 中定义

(只读) 远程 AoE(以太网上的 Ata)设备的以太网地址。

/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 时,state 属性为“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(读写)或 migration(迁移)。

/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 中定义

要取消映射卷,必须向 /sys/block/rnbd<N>/rnbd/unmap_device 写入“normal”或“force”:

当使用“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>/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 控制方法的输出,该方法存在于表示具有标准枚举算法(如 PCI)的设备的 ACPI 设备对象中。

/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:唤醒以在电池达到临界电量时进入休眠状态

这些值通过按位或运算组合。例如,值为 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 不会自动将设备从其当前驱动程序解绑,也不会尝试自动加载指定的驱动程序。如果内核中当前没有加载名称匹配的驱动程序,则设备将不会绑定到任何驱动程序。这也允许设备使用“none”等 driver_override 名称来选择不进行驱动程序绑定。覆盖中只能指定一个驱动程序,不支持解析分隔符。

/sys/bus/auxiliary/devices/.../irqs/

在文件 sysfs-bus-auxiliary 中定义

/sys/devices/.../irqs 目录包含一组可变文件,每个文件都以 IRQ 号命名,类似于 msi_irqs 目录中 PCI PF 或 VF 的 IRQ 号。当 PCI SF 请求和释放 IRQ 时,这些 IRQ 文件会动态添加和删除。

/sys/bus/auxiliary/devices/intel_vsec.sdsi.X

在文件 sysfs-driver-intel-sdsi 中定义

此目录包含用于访问 CPU 上 Intel On Demand(以前称为 Software Defined Silicon 或 SDSi)功能的接口文件。X 代表插槽实例(但不是插槽 ID)。插槽 ID 通过读取寄存器文件并根据规范解码来确定。

有些文件通过邮箱与 On Demand 硬件通信。如果操作失败,可能会返回以下错误代码之一

错误代码

原因

EIO

通用邮箱故障。日志可能指示原因。

EBUSY

邮箱被其他代理占用。

EPERM

硬件中未启用 On Demand 功能。

EPROTO

驱动程序检测到邮箱协议失败。详见日志。

EOVERFLOW

对于 Provision 命令,数据大小超出可写入的范围。

ESPIPE

不允许查找。

ETIMEDOUT

未能在规定时间内完成邮箱事务。

/sys/bus/auxiliary/devices/intel_vsec.sdsi.X/guid

在文件 sysfs-driver-intel-sdsi 中定义

(只读) 寄存器文件的 GUID。GUID 标识此目录中寄存器文件的布局。有关特定 GUID 的寄存器布局信息可在 http://github.com/intel/intel-sdsi 获取

/sys/bus/auxiliary/devices/intel_vsec.sdsi.X/meter_certificate

在文件 sysfs-driver-intel-sdsi 中定义

(RO) 用于从 Intel On Demand 硬件读取当前 CPU 的计量证书。计量证书包含 On Demand 功能的利用率指标。邮箱命令。

/sys/bus/auxiliary/devices/intel_vsec.sdsi.X/provision_akc

在文件 sysfs-driver-intel-sdsi 中定义

(WO) 用于将身份验证密钥证书 (AKC) 写入 CPU 的 On Demand NVRAM。AKC 用于验证能力激活负载。邮箱命令。

/sys/bus/auxiliary/devices/intel_vsec.sdsi.X/provision_cap

在文件 sysfs-driver-intel-sdsi 中定义

(WO) 用于将能力激活负载 (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 中定义

(RO) 包含应用程序配置 CPU 和监控状态信息所需的信息。此文件的布局由该目录中的 GUID 确定。有关特定 GUID 布局的信息,请访问 http://github.com/intel/intel-sdsi

/sys/bus/auxiliary/devices/intel_vsec.sdsi.X/state_certificate

在文件 sysfs-driver-intel-sdsi 中定义

(RO) 用于从 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 创建的向下增长的内存区域,包含标记的数据结构,用于在启动过程和操作系统中与负载共享。每个 CBMEM 条目根据其 ID 在 /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

(写入) 将 CTI 输入触发器与 CTM 通道分离。

/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

(写入) 将 CTI 输出触发器与 CTM 通道分离。

/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

(读写) 提供对硬件事件启用寄存器的访问,与硬件事件 bank 选择寄存器结合使用。

/sys/bus/coresight/devices/<memory_map>.stm/hwevent_select

定义于文件 sysfs-bus-coresight-devices-stm

(读写) 提供对硬件事件块选择寄存器 (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 触发类型设置为假。1:将 CMB 触发类型设置为真。

/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的模式时间戳。

只接受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的模式类型。

只接受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触发时间戳。

只接受0或1中的一个值。0 : 将DSB触发类型设置为假。1 : 将DSB触发类型设置为真。

/sys/bus/coresight/devices/<tpdm-name>/dsb_trig_type

定义于文件 sysfs-bus-coresight-devices-tpdm

(读写) 设置/获取TPDM的DSB触发类型。

只接受0或1中的一个值。0 : 将DSB触发类型设置为假。1 : 将DSB触发类型设置为真。

/sys/bus/coresight/devices/<tpdm-name>/integration_test

定义于文件 sysfs-bus-coresight-devices-tpdm

(写入) 运行TPDM的集成测试。集成测试将为TPDM生成测试数据。这有助于确保跟踪路径已启用且链接配置正常。

只接受1或2中的一个值。1 : 生成64位数据。2 : 生成32位数据。

/sys/bus/coresight/devices/<tpdm-name>/mcmb_lanes_select

定义于文件 sysfs-bus-coresight-devices-tpdm

(读写) 设置/获取单个通道的使能状态。

/sys/bus/coresight/devices/<tpdm-name>/mcmb_trig_lane

定义于文件 sysfs-bus-coresight-devices-tpdm

(读写) 设置/获取哪个通道参与MCMB子单元TPDM的输出模式匹配交叉触发机制。

/sys/bus/coresight/devices/<tpdm-name>/reset_dataset

定义于文件 sysfs-bus-coresight-devices-tpdm

(写入) 重置TPDM的数据集。

只接受值1。1 : 重置TPDM的数据集。

/sys/bus/coresight/devices/dummy_source<N>/enable_source

在文件 sysfs-bus-coresight-devices-dummy-source 中定义

(读写) 使能/禁用虚拟源的跟踪。在使能源之前,应先激活接收器。Coresight组件将源连接到接收器的路径由Coresight框架自动配置和管理。

/sys/bus/coresight/devices/dummy_source<N>/traceid

在文件 sysfs-bus-coresight-devices-dummy-source 中定义

(只读) 显示将在此跟踪实体发出的跟踪流中出现的跟踪ID。

/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 中定义

(读写) 控制从bank 0到3的任意事件的跟踪。

/sys/bus/coresight/devices/etm<N>/event_instren

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(读写) 控制bank 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) 的内容。该值直接从硬件 (HW) 获取。

/sys/bus/coresight/devices/etm<N>/mgmt/trcconfig

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(读取) 打印跟踪配置寄存器 (0x010) 的内容,该内容由软件 (SW) 当前设置。

/sys/bus/coresight/devices/etm<N>/mgmt/trcdevarch

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(读取) 打印设备架构寄存器 (偏移 0xFBC) 的内容。该值直接从硬件 (HW) 读取。

/sys/bus/coresight/devices/etm<N>/mgmt/trcdevid

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(读取) 打印设备ID寄存器 (0xFC8) 的内容。该值直接从硬件 (HW) 获取。

/sys/bus/coresight/devices/etm<N>/mgmt/trcdevtype

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(读取) 打印设备类型寄存器 (0xFCC) 的内容。该值直接从硬件 (HW) 获取。

/sys/bus/coresight/devices/etm<N>/mgmt/trclsr

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(读取) 打印软件锁定状态寄存器 (0xFB4) 的内容。该值直接从硬件 (HW) 获取。

/sys/bus/coresight/devices/etm<N>/mgmt/trcoslsr

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(读取) 打印操作系统锁定状态寄存器 (0x304) 的内容。该值直接从硬件 (HW) 获取。

/sys/bus/coresight/devices/etm<N>/mgmt/trcpdcr

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(读取) 打印掉电控制寄存器 (0x310) 的内容。该值直接从硬件 (HW) 获取。

/sys/bus/coresight/devices/etm<N>/mgmt/trcpdsr

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(读取) 打印掉电状态寄存器 (0x314) 的内容。该值直接从硬件 (HW) 获取。

/sys/bus/coresight/devices/etm<N>/mgmt/trcpidr0

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(读取) 打印外设ID0寄存器 (0xFE0) 的内容。该值直接从硬件 (HW) 获取。

/sys/bus/coresight/devices/etm<N>/mgmt/trcpidr1

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(读取) 打印外设ID1寄存器 (0xFE4) 的内容。该值直接从硬件 (HW) 获取。

/sys/bus/coresight/devices/etm<N>/mgmt/trcpidr2

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(读取) 打印外设ID2寄存器 (0xFE8) 的内容。该值直接从硬件 (HW) 获取。

/sys/bus/coresight/devices/etm<N>/mgmt/trcpidr3

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(读取) 打印外设ID3寄存器 (0xFEC) 的内容。该值直接从硬件 (HW) 获取。

/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)。该值直接从硬件 (HW) 获取。

/sys/bus/coresight/devices/etm<N>/trcidr/trcidr1

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(读取) 返回跟踪单元的跟踪能力 (0x1E4)。该值直接从硬件 (HW) 获取。

/sys/bus/coresight/devices/etm<N>/trcidr/trcidr10

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(读取) 返回跟踪单元可使用的P1右手键数量 (0x188)。该值直接从硬件 (HW) 获取。

/sys/bus/coresight/devices/etm<N>/trcidr/trcidr11

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(读取) 返回跟踪单元可使用的特殊P1右手键数量 (0x18C)。该值直接从硬件 (HW) 获取。

/sys/bus/coresight/devices/etm<N>/trcidr/trcidr12

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(读取) 返回跟踪单元可使用的条件P1右手键数量 (0x190)。该值直接从硬件 (HW) 获取。

/sys/bus/coresight/devices/etm<N>/trcidr/trcidr13

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(读取) 返回跟踪单元可使用的特殊条件P1右手键数量 (0x194)。该值直接从硬件 (HW) 获取。

/sys/bus/coresight/devices/etm<N>/trcidr/trcidr2

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(读取) 返回跟踪单元中数据值、数据地址、VMID、上下文ID和指令地址的最大大小 (0x1E8)。该值直接从硬件 (HW) 获取。

/sys/bus/coresight/devices/etm<N>/trcidr/trcidr3

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(读取) 返回与跟踪单元可用各种资源关联的值。有关更多详细信息,请参阅跟踪宏单元架构规范 (0x1E8)。该值直接从硬件 (HW) 获取。

/sys/bus/coresight/devices/etm<N>/trcidr/trcidr4

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(读取) 返回跟踪单元支持的资源数量 (0x1F0)。该值直接从硬件 (HW) 获取。

/sys/bus/coresight/devices/etm<N>/trcidr/trcidr5

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(读取) 返回跟踪单元支持的资源数量 (0x1F4)。该值直接从硬件 (HW) 获取。

/sys/bus/coresight/devices/etm<N>/trcidr/trcidr8

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(读取) 返回指令跟踪流的最大推测深度。(0x180)。该值直接从硬件 (HW) 获取。

/sys/bus/coresight/devices/etm<N>/trcidr/trcidr9

在文件 sysfs-bus-coresight-devices-etm4x 中定义

(读取) 返回跟踪单元可使用的P0右手键数量 (0x184)。该值直接从硬件 (HW) 获取。

/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/compare_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/compare

在文件 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。计数结束一个时钟脉冲后,输出信号变为低电平,计数器重新加载到预设值减一。后续时钟脉冲将计数递减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 中定义

包含通过 uevents 报告的模块别名。其格式为 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”总线上设备 uevents 中 DEVTYPE 环境变量中传递的相同值。

/sys/bus/cxl/devices/*/modalias

在文件 sysfs-bus-cxl 中定义

(只读) CXL 设备对象导出 modalias 属性,该属性反映了在“cxl”总线上设备 uevents 中 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 范围(基地址加上字节长度)通过这两个属性传达。只要解码器处于禁用状态,就可以修改分配。写入“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) 内存范围交错的目标数量。设备将 HPA 的每第 N 个块(大小等于“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”或“none”之一。“none”表示解码器未主动解码,或未设置 DPA 分配策略。

当解码器处于“disabled”状态时,可以将“mode”写入“ram”或“pmem”以设置下一次分配的边界。

/sys/bus/cxl/devices/decoderX.Y/qos_class

在文件 sysfs-bus-cxl 中定义

(只读) 对于支持“QoS 遥测”的 CXL 主机平台,此仅限根解码器属性会传达一个平台特定的 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/label_storage_size

在文件 sysfs-bus-cxl 中定义

(只读) 标签存储区 (LSA) 的大小(以字节为单位)。

/sys/bus/cxl/devices/memX/numa_node

在文件 sysfs-bus-cxl 中定义

(只读) 如果启用了 NUMA 且平台已为此内存设备设置了主机 PCI 设备的亲和性,则发出此设备的 CPU 节点亲和性。

/sys/bus/cxl/devices/memX/payload_max

在文件 sysfs-bus-cxl 中定义

(只读) 邮箱命令有效负载寄存器的最大大小(以字节为单位)。如果设备报告的大小超过 1MB,Linux 会将其限制为 1MB。

/sys/bus/cxl/devices/memX/pmem/qos_class

在文件 sysfs-bus-cxl 中定义

(只读) 对于支持“QoS 遥测”的 CXL 主机平台,此属性传达一个逗号分隔的平台特定 cookie 列表,用于标识 CXL 内存设备持久分区的 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 内存设备易失性分区的 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”写入此属性,以通过更改设备所有用户数据区域的媒体加密密钥来安全擦除用户数据。此功能要求设备处于禁用状态,即不主动解码任何 HPA 范围。这允许避免显式的全局 CPU 缓存管理,而是依赖于在区域在软件编程和硬件提交状态之间转换时进行管理。如果此文件不存在,则表示硬件不支持此操作。

/sys/bus/cxl/devices/memX/security/state

在文件 sysfs-bus-cxl 中定义

(只读) 读取此文件将显示该设备的 CXL 安全状态。这些状态可以是:“disabled”、“sanitize”(当清理正在进行时);或仅适用于持久内存的状态:“locked”、“unlocked”或“frozen”。此 sysfs 条目可从用户空间进行 select/poll,以在清理操作完成时进行通知。

/sys/bus/cxl/devices/memX/serial

在文件 sysfs-bus-cxl 中定义

(只读) 根据 PCIe 设备序列号功能提供的 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/nvdimm-bridge0/ndbusX/nmemY/cxl/dirty_shutdown

在文件 sysfs-bus-cxl 中定义

(只读) 设备脏关机计数,表示设备可能发生数据丢失的次数。该计数在断电后仍然存在,并在溢出时回绕到 0。如果此文件不存在,则设备没有脏跟踪所需的相应支持。

/sys/bus/cxl/devices/portX/decoders_committed

在文件 sysfs-bus-cxl 中定义

(只读) 当其任何解码器处于“提交”状态时,内存设备被视为活动状态(参见 CXL 3.0 8.2.4.19.7 CXL HDM 解码器 n 控制寄存器)。当设备正在主动解码主机物理地址范围时,热插拔和“清理”等破坏性操作将被阻止。请注意,即使没有 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

/sys/bus/cxl/devices/regionZ/accessY/write_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

/sys/bus/cxl/devices/regionZ/accessY/write_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 端口对象为 CXL/PCIe 交换机中的每个上游端口以及每个端点实例化,以将相应的内存设备映射到 CXL 端口层次结构中。当枚举子 CXL 端口(交换机或端点)时,了解父 CXL 端口中的哪个“dport”对象路由到此子端口非常有用。“parent_dport”符号链接指向表示路由到 {port,endpoint}X 的 CXL 交换机下游端口的设备。

/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 设备下分配映射范围的方法。格式为 -

/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”驱动程序(即热插拔到系统 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 属性是设备 dax 实例在线时可能创建的 Linux numa-node。在线之前,设备的“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”表示 Reed Solomon FEC,“kr”表示 Fire Code 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/edac/devices/<dev-name>/ecs_fruX

在文件 sysfs-edac-ecs 中定义

sysfs EDAC 总线设备 /<dev-name>/ecs_fruX 子目录与内存介质 ECS(错误检查擦洗)控制功能相关,其中 <dev-name> 目录对应于向 EDAC 设备驱动程序注册以支持 ECS 功能的设备。/ecs_fruX 属于内存设备下的介质 FRU(现场可更换单元)。

sysfs ECS 属性节点仅在父驱动程序已实现相应的属性回调函数并在注册期间向 EDAC 设备驱动程序提供了必要操作时才存在。

/sys/bus/edac/devices/<dev-name>/ecs_fruX/log_entry_type

在文件 sysfs-edac-ecs 中定义

(读写) DDR5 ECS 日志报告的日志条目类型。

  • 0 - 按 DRAM。

  • 1 - 按内存介质 FRU。

  • 所有其他值保留。

/sys/bus/edac/devices/<dev-name>/ecs_fruX/mode

在文件 sysfs-edac-ecs 中定义

(读写) DDR5 ECS 计数错误的方式模式。错误计数基于 DDR5 ECS 控制功能选择的两种不同模式进行跟踪——码字模式和行计数模式。如果 ECS 处于码字模式下,则每次检测到具有校验位错误的码字时,错误计数都会增加。如果 ECS 处于行计数模式下,则每次检测到具有校验位错误的行时,错误计数器都会增加。

  • 0 - ECS 计数内存介质中具有 ECC 错误的行。

  • 1 - ECS 计数有错误的码字,具体来说,它计数

    内存介质中 ECC 检测到的错误数量。

  • 所有其他值保留。

/sys/bus/edac/devices/<dev-name>/ecs_fruX/reset

在文件 sysfs-edac-ecs 中定义

(只写) ECS 重置 ECC 计数器。

  • 1 - 将 ECC 计数器重置为默认值。

  • 所有其他值保留。

/sys/bus/edac/devices/<dev-name>/ecs_fruX/threshold

在文件 sysfs-edac-ecs 中定义

(读写) DDR5 ECS 每千兆位内存单元的阈值计数。ECS 错误计数受每 Gbit 的 ECS 阈值计数限制,该阈值会屏蔽小于阈值的错误计数。

支持的值为 256、1024 和 4096。

所有其他值保留。

/sys/bus/edac/devices/<dev-name>/mem_repairX

在文件 sysfs-edac-memory-repair 中定义

sysfs EDAC 总线设备 /<dev-name>/mem_repairX 子目录与内存介质修复功能控制相关,例如 PPR(封装后修复)、内存备用等,其中 <dev-name> 目录对应于向 EDAC 设备驱动程序注册以支持内存修复功能的设备。

封装后修复 (PPR) 是一种维护操作,请求内存设备对其介质执行修复操作。它是一种内存自愈功能,通过在 DRAM 设备中用备用行替换故障内存位置来修复故障内存位置。例如,具有支持 PPR 功能的 DRAM 组件的 CXL 内存设备可以实现 PPR 维护操作。DRAM 组件可能支持两种类型的 PPR 功能:硬 PPR(用于永久行修复)和软 PPR(用于临时行修复)。软 PPR 可能比硬 PPR 快得多,但修复会在断电后丢失。

修复功能的 sysfs 属性节点仅在父驱动程序已实现相应的属性回调函数并在注册期间向 EDAC 设备驱动程序提供了必要操作时才存在。

在某些系统配置状态下(例如,在地址解码器配置之前),内存设备(例如 CXL)可能在主主机地址物理地址映射中没有活动的映射。因此,要修复的内存必须通过使用设备物理地址 (DPA) 的设备特定物理寻址方案来标识。DPA 和其他要使用的控制属性将呈现在相关的错误记录中。

/sys/bus/edac/devices/<dev-name>/mem_repairX/bank_group

/sys/bus/edac/devices/<dev-name>/mem_repairX/bank

/sys/bus/edac/devices/<dev-name>/mem_repairX/rank

/sys/bus/edac/devices/<dev-name>/mem_repairX/row

/sys/bus/edac/devices/<dev-name>/mem_repairX/column

/sys/bus/edac/devices/<dev-name>/mem_repairX/channel

/sys/bus/edac/devices/<dev-name>/mem_repairX/sub_channel

在文件 sysfs-edac-memory-repair 中定义

(读写) 要修复内存的控制属性。要使用的属性的具体值取决于要修复的内存部分,并将在相关的错误记录中报告给主机,并在跟踪事件中提供给用户空间,例如 CXL 内存设备的 CXL DRAM 和 CXL 通用介质错误记录。

读取这些属性时,它会返回请求修复的内存的当前值。

bank_group - 要修复内存的 bank_group。

bank - 要修复内存的 bank 号。

rank - 要修复内存的 rank。rank 定义为通道上共同执行事务的一组内存设备。

row - 要修复内存的行号。

column - 要修复内存的列号。

channel - 要修复内存的通道。通道定义为可以独立访问以进行事务的接口。

sub_channel - 要修复内存的子通道。

设置这些属性的要求因修复功能而异。sysfs 中的属性仅在修复功能需要时才存在。

例如,CXL 规范 3.1 版,第 8.2.9.7.1.2 节表 8-103 软 PPR 和第 8.2.9.7.1.3 节表 8-104 硬 PPR 操作,不需要设置这些属性。CXL 规范 3.1 版,第 8.2.9.7.1.4 节表 8-105 内存备用,这些属性需要根据内存备用粒度进行设置。

/sys/bus/edac/devices/<dev-name>/mem_repairX/dpa

在文件 sysfs-edac-memory-repair 中定义

(读写) 要修复内存的设备物理地址 (DPA)。要使用的具体 DPA 将在相关的错误记录中提供。

在某些系统配置状态下(例如,在地址解码器配置之前),内存设备(例如 CXL)可能在主主机地址物理地址映射中没有活动的映射。因此,要修复的内存必须通过使用 DPA 的设备特定物理寻址方案来标识。要使用的设备物理地址 (DPA) 将呈现在相关的错误记录中。

/sys/bus/edac/devices/<dev-name>/mem_repairX/hpa

在文件 sysfs-edac-memory-repair 中定义

(读写) 要修复内存的主机物理地址 (HPA)。要使用的 HPA 将在相关的错误记录中提供。

/sys/bus/edac/devices/<dev-name>/mem_repairX/min_hpa

/sys/bus/edac/devices/<dev-name>/mem_repairX/max_hpa

/sys/bus/edac/devices/<dev-name>/mem_repairX/min_dpa

/sys/bus/edac/devices/<dev-name>/mem_repairX/max_dpa

在文件 sysfs-edac-memory-repair 中定义

(读写) 要修复的内存地址的受支持范围。内存设备可能会提供要使用的受支持属性范围,这取决于内存设备和要修复的内存部分。用户空间可以通过相关的错误记录和跟踪事件从内存设备接收用于修复操作的特定属性值,例如 CXL 内存设备中的 CXL DRAM 和 CXL 通用介质错误记录。

/sys/bus/edac/devices/<dev-name>/mem_repairX/nibble_mask

在文件 sysfs-edac-memory-repair 中定义

(读写) 要修复内存的读/写 Nibble 掩码。Nibble 掩码标识内存总线上导致错误事件的一个或多个错误 Nibble。如果内存总线上的 Nibble 0 产生了事件,则 Nibble 掩码位 0 应设置为 1,依此类推。例如,对于 CXL PPR 和备用,Nibble 掩码位设置为 1 表示请求在特定设备中执行修复操作。所有 Nibble 掩码位设置为 1 表示请求在所有设备中执行操作。例如,对于 CXL 内存修复,要使用的 Nibble 掩码的具体值将在相关的错误记录中提供。有关更多详细信息,请参见 CXL 规范 3.1 版,第 8.2.9.7.1.2 节表 8-103 软 PPR 和第 8.2.9.7.1.3 节表 8-104 硬 PPR,第 8.2.9.7.1.4 节表 8-105 内存备用中的 Nibble 掩码字段。

/sys/bus/edac/devices/<dev-name>/mem_repairX/persist_mode

在文件 sysfs-edac-memory-repair 中定义

(读写) 获取/设置为修复功能设置的当前持久修复模式。设备中支持的持久修复模式,基于内存修复功能,可以是临时性的(断电后丢失)或永久性的。有效值为

  • 0 - 软内存修复(临时修复)。

  • 1 - 硬内存修复(永久修复)。

  • 所有其他值保留。

/sys/bus/edac/devices/<dev-name>/mem_repairX/repair

在文件 sysfs-edac-memory-repair 中定义

(可写) 为指定的内存修复属性发出内存修复操作。如果根据内存设备和修复功能的要求资源不足,该操作可能会失败。

  • 1 - 发出修复操作。

  • 所有其他值保留。

/sys/bus/edac/devices/<dev-name>/mem_repairX/repair_safe_when_in_use

在文件 sysfs-edac-memory-repair 中定义

(只读) 如果在内存修复操作期间内存介质可访问且数据得以保留,则为 True。在修复操作期间,数据可能无法保留,内存请求也可能无法正确处理。在这种情况下,修复操作无法在运行时执行。内存必须脱机。

/sys/bus/edac/devices/<dev-name>/mem_repairX/repair_type

在文件 sysfs-edac-memory-repair 中定义

(只读) 内存修复类型。例如,封装后修复、内存备用等。有效值为

  • ppr - 封装后修复。

  • cacheline-sparing

  • row-sparing

  • bank-sparing

  • rank-sparing

  • 所有其他值保留。

/sys/bus/edac/devices/<dev-name>/scrubX

在文件 sysfs-edac-scrub 上定义

sysfs EDAC 总线设备 /<dev-name>/scrubX 子目录属于内存擦洗控制功能的一个实例,其中 <dev-name> 目录对应于向 EDAC 设备驱动程序注册用于擦洗控制功能的设备/内存区域。

仅当父驱动程序已实现相应的 attr 回调函数并在注册期间向 EDAC 设备驱动程序提供了必要操作时,sysfs 擦洗属性节点才存在。

/sys/bus/edac/devices/<dev-name>/scrubX/addr

在文件 sysfs-edac-scrub 上定义

(读写) 用于按需擦洗的内存区域的基地址。设置地址会启动擦洗。在此之前必须设置大小。

如果请求的按需擦洗正在进行中,回读地址值非零,否则为零。

/sys/bus/edac/devices/<dev-name>/scrubX/current_cycle_duration

在文件 sysfs-edac-scrub 上定义

(读写) 当前擦洗周期持续时间(以秒为单位),且必须在内存擦洗器支持的范围内。

擦洗在运行时会产生开销,可以通过延长擦洗时间来降低此开销。

/sys/bus/edac/devices/<dev-name>/scrubX/enable_background

在文件 sysfs-edac-scrub 上定义

(读写) 如果支持,启动/停止后台(巡逻)擦洗。

/sys/bus/edac/devices/<dev-name>/scrubX/max_cycle_duration

在文件 sysfs-edac-scrub 上定义

(只读) 内存擦洗器支持的最大擦洗周期持续时间(以秒为单位)。

基于设备的擦洗:返回内存设备支持的最大擦洗周期。

基于区域的擦洗:返回支持该区域的各个内存设备支持的最大擦洗周期的最小值。

如果内存设备未提供最大擦洗周期信息,则返回擦洗周期字段的最大支持值。

/sys/bus/edac/devices/<dev-name>/scrubX/min_cycle_duration

在文件 sysfs-edac-scrub 上定义

(只读) 内存擦洗器支持的最小擦洗周期持续时间(以秒为单位)。

基于设备的擦洗:返回内存设备支持的最小擦洗周期。

基于区域的擦洗:返回支持该区域的各个内存设备支持的最小擦洗周期的最大值。

/sys/bus/edac/devices/<dev-name>/scrubX/size

在文件 sysfs-edac-scrub 上定义

(读写) 要擦洗的内存区域的大小(按需擦洗)。

/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>

在文件 sysfs-bus-event_source-devices 上定义

性能监控单元 (<pmu>)

每个 <pmu> 目录,对于 PMU 设备而言,是一个名称,后跟可选的下划线,然后是十进制或十六进制数字。例如,cpu 和 intel_bts 是没有后缀的 PMU 名称,uncore_imc_0 是带有数字后缀 0 的 PMU 名称,ddr_pmu_87e1b0000000 是带有十六进制后缀的 PMU 名称。十六进制后缀必须超过两个字符长,以避免与 S390 cpum_cf 等 PMU 产生歧义。

工具可以将名称相同但后缀不同的 PMU 视为同一 PMU 的实例,例如为了打开一个事件。例如,PMU uncore_imc_free_running_0 和 uncore_imc_free_running_1 都有一个事件 data_read;在指定为 uncore_imc_free_running 的 PMU 上打开 data_read 事件应被视为在 PMU uncore_imc_free_running_0 和 PMU uncore_imc_free_running_1 上打开 data_read 事件。

/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=?

每个赋值都表示一个要分配给特定位集的值(由与 <term> 对应的格式文件定义),在传递给 perf_open 系统调用的 perf_event 结构中。

在最后一个示例中,用户选择特定事件时需要提供一个替换“?”的值。这被称为“事件参数化”。事件参数的格式为 ‘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 后)所代表的英文复数数值单位。

示例

Joules

/sys/bus/event_source/devices/dfl_fmeX/cpumask

在文件 sysfs-bus-event_source-devices-dfl_fme 上定义

只读。此文件始终返回 PMU 绑定到的 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"

结构事件 (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 是一个结构类型(0x02)事件,其本地事件 ID 为 0x06,用于整体监控(portid=0xff)。

/sys/bus/event_source/devices/dmar*/cpumask

在文件 sysfs-bus-event_source-devices-iommu 上定义

只读。此文件始终返回 IOMMU PMU 绑定到的 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 Spec 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 上定义

只读。此文件始终返回 IDXD DSA PMU 绑定到的 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 链路事件的名称命名。

更多信息请参见 HiSilicon PCIe Tune and Trace device

/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 非发布 TLP 的权重,这会影响 PCIe 链路上出站非发布 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 发布 TLP 的权重,这会影响 PCIe 链路上出站发布 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 上定义

提供固件提供的特定事件的描述。如果固件未提供描述,则不会创建文件。

请注意,事件名称缺少 events/ 目录中事件所附加的域后缀。

/sys/bus/event_source/devices/hv_24x7/event_long_descs/<event-name>

在文件 sysfs-bus-event_source-devices-hv-24x7 上定义

提供固件提供的特定事件的“长”描述。如果固件未提供描述,则不会创建文件。

请注意,事件名称缺少 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"

在此事件中,chip 后的 ‘?’ 表示此值将在运行此事件时由用户提供。

/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 目录的“version”字段。这也可以从提供的二进制“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 控制器以开始发现和登录。FCoE 控制器通过将其名称(即 ctlr_X)写入 ctlr_delete 文件来销毁。

属性

fcf_dev_loss_tmo

设备丢失超时周期(见下文)。更改此值将更改此控制器发现的所有 FCF 的 dev_loss_tmo。

mode

显示或更改 FCoE 控制器的模式。可能的模式有‘Fabric’和‘VN2VN’。如果 FCoE 控制器以‘Fabric’模式启动,则会启动 FIP FCF 发现,并最终尝试进行 Fabric 登录。如果 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: 内部内核状态

  • “Unknown” - 初始化值

  • “Disconnected” - 未连接到 FCF/光纤通道网络

  • “Connected” - 主机已连接到 FCF

  • “Deleted” - FCF 正在从系统中移除

dev_loss_tmo: 此 FCF 的设备丢失超时周期。

注:类似于 FC Transport 的设备丢失基础设施

存在于 fcoe_sysfs 中。拥有此功能很好,这样链路抖动的适配器就不会持续推进用于识别发现的 FCF 的计数。FCF 将处于“Disconnected”状态,直到计时器过期且 FCF 变为“Deleted”,或者 FCF 被重新发现并变为“Connected”。

用户

此接口的第一个用户将是 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 上定义

当将 1024 字节的 Wacom Intuos 4 交错格式原始图像写入文件时,该图像会显示在设备的按钮 N 上。该图像是 64x32 像素的 4 位灰度图像。1024 字节的二进制文件被分成 16 个 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/<bus>:<vid>:<pid>.<n>/wacom_remote/unpair_remote

在文件 sysfs-driver-wacom 上定义

将字符序列 ‘*’ 后跟一个换行符写入此文件将删除设备上所有当前的配对。其他字符序列已保留。此文件是只写文件。

/sys/bus/hid/drivers/hid-appletb-kbd/<dev>/mode

在文件 sysfs-driver-hid-appletb-kbd 上定义

触摸条上显示的一组按键。有效值为: == ================= 0 仅 Escape 键 1 功能键 2 媒体/亮度键 3 无 == =================

/sys/bus/hid/drivers/hid-corsair-void/<dev>/fw_version_headset

在文件 sysfs-driver-hid-corsair-void 中定义

  1. 耳机的固件版本
    • 如果未报告版本,则返回 -ENODATA

/sys/bus/hid/drivers/hid-corsair-void/<dev>/fw_version_receiver

在文件 sysfs-driver-hid-corsair-void 中定义

  1. 接收器的固件版本

/sys/bus/hid/drivers/hid-corsair-void/<dev>/microphone_up

在文件 sysfs-driver-hid-corsair-void 中定义

  1. 获取麦克风的物理位置
    • 1 -> 麦克风向上

    • 0 -> 麦克风向下

/sys/bus/hid/drivers/hid-corsair-void/<dev>/send_alert

在文件 sysfs-driver-hid-corsair-void 中定义

  1. 播放耳机内置通知 (0 / 1)

/sys/bus/hid/drivers/hid-corsair-void/<dev>/set_sidetone

在文件 sysfs-driver-hid-corsair-void 中定义

  1. 设置侧音音量 (0 - sidetone_max)

/sys/bus/hid/drivers/hid-corsair-void/<dev>/sidetone_max

在文件 sysfs-driver-hid-corsair-void 中定义

  1. 报告最大侧音音量

/sys/bus/hid/drivers/logitech-hidpp-device/<dev>/builtin_power_supply

在文件 sysfs-driver-hid-logitech-hidpp 中定义

此文件的存在表明 HID++ 驱动程序能够处理内核中的电池属性。这样,upower 就可以添加一个 udev 规则来决定是否应使用内部统一支持或通用内核支持。

/sys/bus/hid/drivers/logitech-hidpp-device/<dev>/range

在文件 sysfs-driver-hid-logitech-hidpp 中定义

(读写) 此属性控制 Logitech G920 方向盘允许的“转动”量。从文件中读取显示方向盘的当前范围。在最小和最大边界内写入值可设置方向盘的范围。

/sys/bus/hid/drivers/logitech/<dev>/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/<dev>/combine_pedals

在文件 sysfs-driver-hid-logitech-lg4ff 中定义

控制是否在控制器的 Y 轴上报告油门和刹车的组合值。对于不支持单独油门/刹车轴的旧游戏很有用。默认为关闭(‘0’),通过设置为‘1’启用。

/sys/bus/hid/drivers/logitech/<dev>/range

在文件 sysfs-driver-hid-logitech-lg4ff 中定义

显示方向盘的最小、最大和当前范围。在最小和最大边界内写入值可设置方向盘的范围。

/sys/bus/hid/drivers/logitech/<dev>/real_id

在文件 sysfs-driver-hid-logitech-lg4ff 中定义

显示方向盘的真实型号,无论其可能切换到任何备用模式。这是一个只读值。对于只有一个模式的设备,不创建此条目。

/sys/bus/hid/drivers/ntrig/<dev>/activate_slack

在文件 sysfs-driver-hid-ntrig 中定义

(读写) 在确认活动开始(激活触摸)之前忽略的接触帧数。

/sys/bus/hid/drivers/ntrig/<dev>/activation_width

/sys/bus/hid/drivers/ntrig/<dev>/activation_height

在文件 sysfs-driver-hid-ntrig 中定义

用于覆盖激活松弛的阈值。

activation_width

(读写) 宽度阈值,用于立即开始处理触摸事件。

activation_height

(读写) 高度阈值,用于立即开始处理触摸事件。

/sys/bus/hid/drivers/ntrig/<dev>/decativate_slack

在文件 sysfs-driver-hid-ntrig 中定义

(读写) 在确认活动结束(停用触摸)之前忽略的空(无接触)帧数。

当最后一个手指从设备上移开时,它会发送一些空帧。通过延迟停用几帧,可以容忍错误的断开连接,因为传感器可能会错误地未检测到仍然存在的手指。

/sys/bus/hid/drivers/ntrig/<dev>/min_width

/sys/bus/hid/drivers/ntrig/<dev>/min_height

在文件 sysfs-driver-hid-ntrig 中定义

接受的最小接触尺寸。

min_width

(读写) 最小触摸接触宽度,用于决定激活和活动。

min_height

(读写) 最小触摸接触高度,用于决定激活和活动。

/sys/bus/hid/drivers/ntrig/<dev>/sensor_logical_width

/sys/bus/hid/drivers/ntrig/<dev>/sensor_logical_height

在文件 sysfs-driver-hid-ntrig 中定义

(只读) 活动期间报告位置的范围。

/sys/bus/hid/drivers/ntrig/<dev>/sensor_physical_width

/sys/bus/hid/drivers/ntrig/<dev>/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/<dev>/bboard_calib

在文件 sysfs-driver-hid-wiimote 中定义

仅当设备被检测为平衡板时才提供此属性。它提供一行,包含所有 4 个传感器的 3 个校准值。值由冒号分隔,每个值长 2 字节(编码为 4 位十六进制值)。首先写入所有 4 个传感器的 0kg 值,然后是所有 4 个传感器的 17kg 值,最后是所有 4 个传感器的 34kg 值。

校准数据已由内核应用于所有输入值,但可由用户空间用于执行其他转换。

/sys/bus/hid/drivers/wiimote/<dev>/devtype

在文件 sysfs-driver-hid-wiimote 中定义

当设备由 wiimote 驱动程序初始化时,我们执行设备检测并在完成后发出“change”udev 事件。此文件显示检测到的设备类型。“pending”表示检测仍在进行中,“unknown”表示设备无法检测或加载。“generic”表示设备无法检测但支持基本的 Wii Remote 功能并可以使用。每种设备类型都有其他字符串可用,如果添加新的设备特定检测,则可能会添加。目前支持的有

gen10

第一代 Wii Remote

gen20

第二代 Wii Remote Plus(内置 MP)

balanceboard

Wii 平衡板

/sys/bus/hid/drivers/wiimote/<dev>/extension

在文件 sysfs-driver-hid-wiimote 中定义

此文件包含当前连接和初始化的扩展。它可以是以下之一:无、motionp、nunchuck、classic、motionp+nunchuck、motionp+classic。motionp 是任天堂官方的 Motion+ 扩展,nunchuck 是任天堂官方的双节棍扩展,classic 是任天堂的经典控制器扩展。MotionPlus 扩展可以与另外两个结合使用。

从内核版本 3.11 开始支持 Motion Plus 热插拔,如果检测到,它将不再报告为静态扩展。然后您将收到 Motion Plus 设备的 uevent 通知。

/sys/bus/hid/drivers/wiimote/<dev>/led1

/sys/bus/hid/drivers/wiimote/<dev>/led2

/sys/bus/hid/drivers/wiimote/<dev>/led3

/sys/bus/hid/drivers/wiimote/<dev>/led4

在文件 sysfs-driver-hid-wiimote 中定义

可以设置/获取当前 LED 状态。从它读取,如果 LED 关闭则返回 0,如果开启则返回 1。写入 0 禁用 LED,写入 1 启用 LED。

/sys/bus/hid/drivers/wiimote/<dev>/pro_calib

在文件 sysfs-driver-hid-wiimote 中定义

仅当设备被检测为专业控制器时才提供此属性。它提供一行,包含所有 4 个模拟摇杆的 4 个校准值。格式为:“x1:y1 x2:y2”。数据前缀为 +/-。每个值都是一个有符号的 16 位数字。数据编码为十进制数字,并指定专业控制器的模拟摇杆偏移量。

校准数据已由内核应用于所有输入值,但可由用户空间用于执行其他转换。

校准数据在设备设置期间由内核检测。您可以向此文件写入“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 总线上存在的一个 I3C 设备,由 <bus-id> 标识。请注意,所有设备都表示,包括驱动总线的总线主控。

/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)下限制 SNR 性能。为了克服此限制,缓冲器包含一个自动归零算法,该算法大大减少(抵消)1/f 噪声并抵消参考缓冲器的偏移值。因此,即使在最大过采样率值下,系统的 SNR 也不受参考缓冲器 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 传感器的二进制校准数据块。

/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 上定义

强制校准值的可用范围,表示为

  • 指定为“[min step max]”的范围

/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_modes。

低电压阈值范围在 2..21V 之间。低阈值和高阈值之间的滞回不能低于 2 且不能为奇数。

如果下降阈值导致滞回为奇数,则上升阈值会自动减一。

/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_modes。

高电压阈值范围在 3..22V 之间。低阈值和高阈值之间的滞回不能低于 2 且不能为奇数。

如果上升阈值导致滞回为奇数,则下降阈值会自动加一。

/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

过压或欠压输入故障。内部电路受到保护,防止热电偶电缆施加过高电压。设备还可以检测是否发生此类情况。

读取返回“1”表示输入电压为负或大于 VDD,否则返回“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

/sys/bus/iio/devices/iio:deviceX/in_voltageY-voltageZ_filter_type

在文件 sysfs-bus-iio 上定义

指定应用于通道的滤波器类型。可能的值由 filter_type_available 属性给出。

/sys/bus/iio/devices/iio:deviceX/filter_type_available

/sys/bus/iio/devices/iio:deviceX/in_voltage-voltage_filter_type_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。

  • “wideband” - 具有宽带低纹波通带和陡峭过渡带的滤波器。

/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。此 ID 由 Android 传感器服务硬件抽象层 (sensor HAL) 通过 ChromeOS 上的 Android 容器使用。

/sys/bus/iio/devices/iio:deviceX/in_Y_mean_raw

在文件 sysfs-bus-iio 上定义

通道 Y 的平均原始测量值。用于平均的值的数量是设备特定的。正常原始值的转换规则也适用于平均原始值。

/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 上定义

calibbias 的可用值。可以表示为以下任一:

  • 一小部分离散值,例如“0 2 4 6 8”

  • 指定为“[min step max]”的范围

/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_capacitanceY_offset

在文件 sysfs-bus-iio 上定义

如果设备已知,则是在按 <type>[Y]_scale 缩放之前添加到 <type>[Y]_raw 的偏移量,以获得 <type>[Y]_raw 文档中指定的 <type> 单位的值。如果偏移量始终为 0 或未知,则不显示。如果 Y 或轴 <x|y|z> 不存在,则偏移量适用于 <type> 的所有输入通道。如果设备上可以应用可变偏移量,则可能可写。请注意,这与 calibbias 不同,后者适用于通过某些硬件支持的校准程序进行调整的设备(或驱动程序),以补偿不同部件实例之间的差异。Calibbias 在内部应用,offset 在用户空间应用于 _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_voltageY_scale_available

/sys/.../iio:deviceX/in_voltage-voltage_scale_available

/sys/.../iio:deviceX/out_voltageY_scale_available

/sys/.../iio:deviceX/out_altvoltageY_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

/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_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_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 铰链传感器,标签值是:hinge(铰链)、keyboard(键盘)、screen(屏幕)。这意味着三个通道分别对应于铰链角度、键盘角度和屏幕角度。

/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_concentrationY_raw

/sys/bus/iio/devices/iio:deviceX/in_concentration_co2_raw

/sys/bus/iio/devices/iio:deviceX/in_concentrationY_co2_raw

/sys/bus/iio/devices/iio:deviceX/in_concentration_ethanol_raw

/sys/bus/iio/devices/iio:deviceX/in_concentrationY_ethanol_raw

/sys/bus/iio/devices/iio:deviceX/in_concentration_h2_raw

/sys/bus/iio/devices/iio:deviceX/in_concentrationY_h2_raw

/sys/bus/iio/devices/iio:deviceX/in_concentration_o2_raw

/sys/bus/iio/devices/iio:deviceX/in_concentrationY_o2_raw

/sys/bus/iio/devices/iio:deviceX/in_concentration_voc_raw

/sys/bus/iio/devices/iio:deviceX/in_concentrationY_voc_raw

在文件 sysfs-bus-iio 上定义

物质的原始(未缩放无偏移等)读数。应用缩放和偏移后的单位是百分比。

/sys/bus/iio/devices/iio:deviceX/in_conversion_mode

定义于文件 sysfs-bus-iio-vf610

指定使用的硬件转换模式。三种可用模式是“normal”(正常)、“high-speed”(高速)和“low-power”(低功耗),其中低功耗是默认模式。

/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 上定义

此接口已弃用;请使用 Counter 子系统。

通道 Y 的原始计数器设备计数器方向。

/sys/bus/iio/devices/iio:deviceX/in_countY_raw

在文件 sysfs-bus-iio 上定义

此接口已弃用;请使用 Counter 子系统。

通道 Y 的原始计数器设备计数。对于正交计数器,乘以可用 [Y]_scale 会得到通道 Y 的单个正交信号相位的计数。

/sys/bus/iio/devices/iio:deviceX/in_count_count_direction_available

在文件 sysfs-bus-iio 上定义

此接口已弃用;请使用 Counter 子系统。

可能的计数方向列表,包括

  • “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_currentY_raw

/sys/bus/iio/devices/iio:deviceX/in_currentY_supply_raw

/sys/bus/iio/devices/iio:deviceX/in_currentY_i_raw

/sys/bus/iio/devices/iio:deviceX/in_currentY_q_raw

在文件 sysfs-bus-iio 上定义

通道 Y 的原始电流测量值。应用缩放和偏移后的单位是毫安。如果没有偏移或缩放,输出应被视为以毫安为单位进行处理。在通道不对应外部可用输入的特殊情况下,可以使用其中一个命名版本。

带“i”和“q”修饰符的通道总是成对存在,并且两个通道都指代相同的信号。“i”通道包含信号的同相分量,而“q”通道包含正交分量。

/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 上定义

陷波滤波器的中心频率,单位为赫兹。例如用于线路噪声抑制。

/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 上定义

可用的校准比例值。可以表示为以下两种形式之一:

  • 一小部分离散值,如“1 8 16”

  • 指定为“[min step max]”的范围

如果所有通道共享,则使用 <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 上定义

此接口已弃用;请使用 Counter 子系统。

通道 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 上定义

颗粒物质量浓度读数,单位为微克/立方米。pmX 指空气动力学直径小于或等于X微米的颗粒。

/sys/bus/iio/devices/iio:deviceX/in_ph_raw

在文件 sysfs-bus-iio 上定义

物质的原始(未缩放,无偏移等)pH读数,表示为每升水中水合氢离子浓度的负10为底的对数。

/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 中用于温度,以及 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时,噪声水平超过跳闸水平,并且未报告有效数据。

/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_resistanceY_raw

/sys/bus/iio/devices/iio:deviceX/out_resistance_raw

/sys/bus/iio/devices/iio:deviceX/out_resistanceY_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_tempY_calibemissivity

/sys/bus/iio/devices/iio:deviceX/in_temp_object_calibemissivity

/sys/bus/iio/devices/iio:deviceX/in_tempY_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_tempY_object_calibambient

在文件 sysfs-bus-iio 上定义

用于物体温度计算的校准环境温度,单位为毫摄氏度。

/sys/bus/iio/devices/iio:deviceX/in_temp_raw

/sys/bus/iio/devices/iio:deviceX/in_tempY_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 上定义

原始(未缩放,无偏置消除等)温度测量值。如果指定了轴,则通常表示温度传感器与复合设备的一部分相关联(例如陀螺仪轴)。环境(ambient)和物体(object)修饰符区分非接触式测量中的环境温度(参考温度)和远距离物体温度。应用比例和偏移后的单位是毫摄氏度。

/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_voltage-voltage_filter_mode_available

定义于文件 sysfs-bus-iio-adc-ad4130

读取返回可能滤波器模式的列表。

此ABI仅为向后兼容性保留,返回的值与 testing/sysfs-bus-iio 中记录的 filter_type_available 属性相同。请为新驱动程序使用 filter_type_available 类似的ABI来提供过滤选项。

/sys/bus/iio/devices/iio:deviceX/in_voltage0_raw

定义于文件 sysfs-bus-iio-adc-mt6360

MT6360 USBID ADC的指示值,连接到连接器ID引脚。通过比例和偏移计算后返回微伏电压。

/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_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_filter_mode

定义于文件 sysfs-bus-iio-adc-ad4130

此ABI仅为向后兼容性保留,返回的值与 testing/sysfs-bus-iio 中记录的 in_voltageY-voltageZ_filter_type 属性相同。请为新驱动程序使用 in_voltageY-voltageZ_filter_type。

/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_sampling_frequency

/sys/bus/iio/devices/iio:deviceX/in_powerY_sampling_frequency

/sys/bus/iio/devices/iio:deviceX/in_currentY_sampling_frequency

在文件 sysfs-bus-iio 上定义

某些设备对单个通道的采样频率有单独的控制。如果在一次扫描中启用了多个通道,则扫描的采样频率可以根据每个通道的采样频率计算得出。

/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_intensity_red_scale

/sys/bus/iio/devices/iio:deviceX/in_intensity_green_scale

/sys/bus/iio/devices/iio:deviceX/in_intensity_blue_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 文档中指定单位的测量值。如果所有输入通道共享,则不显示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_voltageY_sys_calibration

定义于文件 sysfs-bus-iio-adc-ad-sigma-delta

此属性(如果可用)启动系统校准过程。一次只在一个通道上进行。写入“1”开始校准。

/sys/bus/iio/devices/iio:deviceX/in_voltageY_sys_calibration_mode

定义于文件 sysfs-bus-iio-adc-ad-sigma-delta

此属性(如果可用)设置系统校准过程中使用的校准模式。读取返回当前校准模式。写入设置系统校准模式。

/sys/bus/iio/devices/iio:deviceX/in_voltageY_sys_calibration_mode_available

定义于文件 sysfs-bus-iio-adc-ad-sigma-delta

此属性(如果可用)返回一个包含可能校准模式的列表。有两个可用选项:“zero_scale” - 校准到零刻度,“full_scale” - 校准到满刻度。

/sys/bus/iio/devices/iio:deviceX/in_voltage_filterY_notch_center

定义于文件 sysfs-bus-iio-adc-max11410

陷波滤波器的中心频率,单位为赫兹。

/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/label

在文件 sysfs-bus-iio 上定义

设备X的可选符号标签。这对于用户空间能够更好地识别单个设备非常有用。

标签内容是自由格式的,但有一些标准化用途:

对于给出(人)与特定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°(瑜伽式)铰链2合1设备中的加速度计,这些设备在底座和显示器中都包含加速度计,使用以下标准化标签:

  • “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的输出频率,单位为赫兹。如果输出对应单个通道,则该数字必须始终指定且唯一。某些驱动程序有额外限制: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

扫描中连续频率点之间的频率增量(步长),单位为赫兹。

/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 映射器 Y + 1 的 ALS 映射器目标寄存器。

请注意,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

/sys/bus/iio/devices/iio:deviceX/in_illuminance_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

/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 输出级与放大器断开连接。清除(写入0)恢复正常操作。如果所有输出一起控制,Y 可能会被抑制。

/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 电阻连接到地,7.7kohm_to_gnd:通过 7.7kOhm 电阻连接到地,20kohm_to_gnd:通过 20kOhm 电阻连接到地,32kohm_to_gnd:通过 32kOhm 电阻连接到地,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_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_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_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 补码)的减环境光接近检测。方案 1 的接近计数范围为 -2^(n-1) 到 2^(n-1)。对于小于 16 位的分辨率,符号位被扩展。方案 0 具有更宽的动态范围,而方案 1 的接近检测受环境红外噪声变化的影响较小。

0

感应来自 LED 和环境的红外线

1

感应来自 LED 并带环境红外抑制的红外线

/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/iio:deviceX/events/sampling_frequency

/sys/bus/iio/devices/triggerX/sampling_frequency

在文件 sysfs-bus-iio 上定义

一些设备有内部时钟。此参数设置产生的采样频率。在许多设备中,此参数影响输入滤波器等,而不仅仅是控制何时对输入进行采样。由于这会影响数据就绪触发器、硬件缓冲区和 sysfs 直接访问接口,因此它可能存在于任何相关目录中。如果它影响上述所有项,则可以在基础设备目录中找到它。

stm32-timer-trigger 还有一个额外的特性,即 sampling_frequency 为 0 时定义为停止采样。

/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”

  • 一个包含最小、步长和最大频率的范围,如“[min step max]”

/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 比较脉冲)

    OC4REF 上升沿或下降沿生成脉冲。

  • “compare_pulse_OC6REF”(OC6REF 比较脉冲)

    OC6REF 上升沿或下降沿生成脉冲。

  • “compare_pulse_OC4REF_r_or_OC6REF_r”(OC4REF 上升沿或 OC6REF 上升沿比较脉冲)

    OC4REF 或 OC6REF 的上升沿生成脉冲。

  • “compare_pulse_OC4REF_r_or_OC6REF_f”(OC4REF 上升沿或 OC6REF 下降沿比较脉冲)

    OC4REF 上升沿或 OC6REF 下降沿生成脉冲。

  • “compare_pulse_OC5REF_r_or_OC6REF_r”(OC5REF 上升沿或 OC6REF 上升沿比较脉冲)

    OC5REF 或 OC6REF 的上升沿生成脉冲。

  • “compare_pulse_OC5REF_r_or_OC6REF_f”(OC5REF 上升沿或 OC6REF 下降沿比较脉冲)

    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 加速度计内核模块提供了一个额外的触发器,它将设备设置为一种模式,在该模式下,它将在 events 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 或外部中断 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 空包生成:启用 (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 缓冲区大小。

在 single 模式下,这是单个页数,必须是 2 的幂。在 multiblock 模式下,这是一个逗号分隔的页数列表,用于分配每个窗口。窗口数量不受限制。

写入此文件将解除分配现有缓冲区(在没有活跃用户且未启用跟踪的情况下),然后分配一个新的缓冲区。

/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/

/sys/class/mdio_bus/.../statistics/

在文件 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/errors_<addr>

/sys/class/mdio_bus/.../statistics/errors_<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/reads_<addr>

/sys/class/mdio_bus/.../statistics/reads_<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/transfers_<addr>

/sys/class/mdio_bus/.../statistics/transfers_<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/writes_<addr>

/sys/class/mdio_bus/.../statistics/writes_<addr>

在文件 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 device name>:<device uuid>:<protocol version>

/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根设备_DSM”的部分。

/sys/bus/nd/devices/ndbusX/nfit/firmware_activate_noidle

定义于文件 sysfs-bus-nfit

(读写) 英特尔平台固件激活支持的实现提供了一个选项,允许平台在激活事件期间强制系统中的设备进入空闲状态,或信任操作系统会自行处理。安全的默认设置是让平台强制设备进入空闲状态,因为内核已经处于挂起状态,并且万一驱动程序在挂起回调后未能正确地使总线主控静止,平台将处理它。然而,如果平台固件确定激活时间超过了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区域的NVDIMM设备在其父总线上的设备地址(由_ADR对象给出)。

/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

(只读) SMBIOS(系统管理BIOS)内存设备结构(描述包含NVDIMM区域的NVDIMM)的句柄(即实例号)。

/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文件中报告的标志

  • “未就绪”

    指示NVDIMM内容在电源循环后将无法保留。

  • “刷新失败”

    指示NVDIMM内容在上次关机事件期间未能刷新。

  • “恢复失败”

    指示NVDIMM内容在NVDIMM初始化期间未能恢复。

  • “已加密”

    NVDIMM内容已加密。

  • “智能通知”

    NVDIMM存在健康事件。

  • “已擦除”

    指示NVDIMM内容已被擦除。

  • “已锁定”

    指示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/.../doe_features

定义于文件 sysfs-bus-pci

此目录包含支持的数据对象交换(DOE)功能的列表。这些功能即为文件名。每个文件的内容是原始供应商ID和数据对象功能值。

该值来自设备,指定了支持的供应商和数据对象类型。下半部分(冒号右侧)是十六进制的数据对象类型。上半部分(冒号左侧)是供应商ID。

由于所有DOE设备都必须支持DOE发现功能,如果支持DOE,您将至少看到doe_discovery文件,其内容如下

# cat doe_features/doe_discovery 0001:00

如果设备支持其他功能,您还将看到其他文件。例如,如果支持CMA/SPDM和安全CMA/SPDM,doe_features目录将如下所示

# ls doe_features 0001:01 0001:02 doe_discovery

/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节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第7.9.19.2节,强制性指示包括:ok、locate、fail、rebuild。所有其他指示均为可选。只有当设备支持相应指示时,LED类设备才可见。

要操作这些指示,请向“brightness”文件写入0(LED_OFF)或1(LED_ON)。请注意,操作一个指示可能会根据供应商的判断隐式操作其他指示。例如,当用户点亮“ok”指示时,供应商可能会选择自动关闭“fail”指示。可以通过读取其“brightness”文件来获取指示的当前状态。

PCIe基本规范允许供应商为指示选择不同的颜色或闪烁模式,但通常它们会遵循IBPI标准。例如,“locate”指示通常表现为一个或两个LED以4赫兹的频率闪烁: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

The /sys/devices/.../msi_irqs目录包含一组可变文件,每个文件都以分配给该设备的相应MSI中断向量命名。

/sys/bus/pci/devices/.../msi_irqs/<N>

定义于文件 sysfs-bus-pci

此属性指示文件命名的中断向量所处的模式(MSI vs. MSI-X)

/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()调用,内核将分配一块点对点内存,用于点对点事务。此内存可用于对NVMe支持的文件进行O_DIRECT调用以实现点对点复制。

/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 - 此数字将作为 Table Size 报告在

    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 的文件将是一个二进制文件,包含设备的生命周期产品数据(Vital Product Data)。它应遵循 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

(RW) 报告 QAT 设备自动重置功能的当前状态。

写入此属性可启用或禁用设备自动重置。

设备自动重置默认禁用。

值为

  • 1/Yy/on: 自动重置已启用。如果设备遇到不可恢复的错误,它将自动重置。

  • 0/Nn/off: 自动重置已禁用。如果设备遇到不可恢复的错误,它将不会被重置。

此属性仅适用于 qat_4xxx 设备。

/sys/bus/pci/devices/<BDF>/qat/cfg_services

定义在文件 sysfs-driver-qat

(RW) 报告 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

(RO) 返回单个设备拥有的环对数量。

用法示例

# cat /sys/bus/pci/devices/<BDF>/qat/num_rps
64

此属性仅适用于 qat_4xxx 设备。

/sys/bus/pci/devices/<BDF>/qat/pm_idle_enabled

定义在文件 sysfs-driver-qat

(RW) 此配置选项提供了一种方法,可强制设备保持在最大电源状态。如果启用了空闲支持,设备将在空闲时转换为 MIN 电源状态,否则将保持在最大电源状态。写入文件以启用或禁用空闲支持。

值为

  • 0:空闲支持已禁用

  • 1:空闲支持已启用

默认值为 1。

仅当设备处于 down 状态时(参见 /sys/bus/pci/devices/<BDF>/qat/state)才可设置 pm_idle_enabled 值。

以下示例展示了如何更改设备的 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

(RW) 此属性提供了一种方式,允许用户查询特定环对当前配置的服务类型。

写入时,该值将被缓存并用于执行读取操作。允许的值范围为 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

(RW) 报告 QAT 设备的当前状态。写入文件以启动或停止设备。

值为

  • up: 设备已启动并正在运行

  • down: 设备已停止

只有当设备处于 up 状态时才能将其转换为 down,反之亦然。

此属性仅适用于 qat_4xxx 设备。

/sys/bus/pci/devices/<BDF>/qat_ras/errors_correctable

定义在文件 sysfs-driver-qat_ras

(RO) 报告设备检测到的可纠正错误数量。

此属性仅适用于 qat_4xxx 和 qat_6xxx 设备。

/sys/bus/pci/devices/<BDF>/qat_ras/errors_fatal

定义在文件 sysfs-driver-qat_ras

(RO) 报告设备检测到的致命错误数量。

此属性仅适用于 qat_4xxx 和 qat_6xxx 设备。

/sys/bus/pci/devices/<BDF>/qat_ras/errors_nonfatal

定义在文件 sysfs-driver-qat_ras

(RO) 报告设备检测到的非致命错误数量。

此属性仅适用于 qat_4xxx 和 qat_6xxx 设备。

/sys/bus/pci/devices/<BDF>/qat_ras/reset_error_counters

定义在文件 sysfs-driver-qat_ras

(WO) 写入此文件将重置设备的所有错误计数器。

以下示例报告如何重置计数器

# 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 和 qat_6xxx 设备。

/sys/bus/pci/devices/<BDF>/qat_rl/cap_rem

定义在文件 sysfs-driver-qat_rl

(RW) 此文件将返回特定服务/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

(RW) 承诺信息速率 (CIR)。特定 SLA 保证达到的速率。该值以千分比表示,即 1000 表示所选服务的最大设备吞吐量。

在向 sla_op 发送“get”后,此文件将填充所查询 SLA 的 CIR。在发送“add/update”sla_op 之前写入此文件,以将 SLA 设置为指定值。

在 sla_op 中的适用性

  • 写入:添加和更新操作

  • 读取:获取操作

用法示例

## 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

(RW) 如果写入此值,则此值将用于检索特定 SLA 并对其进行操作。这仅对以下操作有效:update、rm 和 get。只有在创建 SLA 后才能保证读取此属性获得正确数据。

在 sla_op 中的适用性

  • 写入:rm 和 update 操作

  • 读取:add 和 get 操作

用法示例

## 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

(RW) 峰值信息速率 (PIR)。特定 SLA 可达到的最大速率。当设备未被其他用户(分配给不同 SLA)的请求完全占用时,SLA 可达到 CIR 和 PIR 之间的值。

在向 sla_op 发送“get”后,此文件将填充所查询 SLA 的 PIR。在发送“add/update”sla_op 之前写入此文件,以将 SLA 设置为指定值。

在 sla_op 中的适用性

  • 写入:添加和更新操作

  • 读取:获取操作

用法示例

## 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

(RW) 读取时,报告所查询 SLA 当前分配的环对。写入时,配置与新 SLA 相关联的环对。

该值是一个 64 位位掩码,以十六进制写入/显示。此掩码的每一位代表一个环对,即位 1 == 环对 ID 0;位 3 == 环对 ID 2。

选定的环对必须分配给单个服务,即由 srv 属性提供的服务。分配给某个环对的服务可以通过查询 qat/rp2srv 属性来检查。

每个 SLA 的最大环对数量为 4。

在 sla_op 中的适用性

  • 写入:添加操作

  • 读取:获取操作

用法示例

## 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

(WO) 此属性用于对 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

(RW) 服务 (SRV)。表示与 SLA 相关联的服务(sym、asym、dc)。可写入或查询以设置/显示 SLA 的 SRV 类型。SRV 属性用于在添加 SLA 之前指定 SRV 类型。配置 SLA 后,报告与该 SLA 相关联的服务。

在 sla_op 中的适用性

  • 写入:添加和更新操作

  • 读取:获取操作

用法示例

## 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 文件报告是否已启用回放保护单调计数器(Replay Protected Monotonic Counter)支持。可能的值:0:未启用 1:已启用

/sys/bus/pci/devices/<BDF>/rpmc_spirom_available

定义在文件 sysfs-driver-ccp

/sys/bus/pci/devices/<BDF>/rpmc_spirom_available 文件报告系统上是否安装了支持回放保护单调计数器(Replay Protected Monotonic Counter)的 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/correctable_ratelimit_burst

定义在文件 sysfs-bus-pci-devices-aer

可纠正错误日志的速率限制突发值。写入一个值将更改在达到速率限制之前每个间隔允许的错误数量(突发)。读取将获取当前的速率限制突发值。默认值为 DEFAULT_RATELIMIT_BURST (10)。

/sys/bus/pci/devices/<dev>/aer/correctable_ratelimit_interval_ms

定义在文件 sysfs-bus-pci-devices-aer

写入 0 可禁用 AER 可纠正错误日志速率限制。写入正值可设置以毫秒为单位的速率限制间隔。默认值为 DEFAULT_RATELIMIT_INTERVAL (5000 毫秒)。

/sys/bus/pci/devices/<dev>/aer/nonfatal_ratelimit_burst

定义在文件 sysfs-bus-pci-devices-aer

非致命不可纠正错误日志的速率限制突发值。写入一个值将更改在达到速率限制之前每个间隔允许的错误数量(突发)。读取将获取当前的速率限制突发值。默认值为 DEFAULT_RATELIMIT_BURST (10)。

/sys/bus/pci/devices/<dev>/aer/nonfatal_ratelimit_interval_ms

定义在文件 sysfs-bus-pci-devices-aer

写入 0 可禁用 AER 非致命不可纠正错误日志速率限制。写入正值可设置以毫秒为单位的速率限制间隔。默认值为 DEFAULT_RATELIMIT_INTERVAL (5000 毫秒)。

/sys/bus/pci/devices/<dev>/aer_dev_correctable

定义在文件 sysfs-bus-pci-devices-aer

此 PCI 设备使用 ERR_COR 看到并报告的可纠正错误列表。请注意,由于可能使用单个 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

此 PCI 设备使用 ERR_FATAL 看到并报告的不可纠正致命错误列表。请注意,由于可能使用单个 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

此 PCI 设备使用 ERR_NONFATAL 看到并报告的不可纠正非致命错误列表。请注意,由于可能使用单个 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

报告给根端口的 ERR_COR 消息总数。

/sys/bus/pci/devices/<dev>/aer_rootport_total_err_fatal

定义在文件 sysfs-bus-pci-devices-aer

报告给根端口的 ERR_FATAL 消息总数。

/sys/bus/pci/devices/<dev>/aer_rootport_total_err_nonfatal

定义在文件 sysfs-bus-pci-devices-aer

报告给根端口的 ERR_NONFATAL 消息总数。

PCIe AER 速率限制

这些属性显示在所有支持 AER 的设备下。它们表示每种错误类型的可配置日志速率限制。

有关速率限制的更多信息,请参阅 PCI Express 高级错误报告驱动程序指南 HOWTO

/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”值表示控制器已设置为“simple mode”。“performant”值表示控制器已设置为“performant mode”。

/sys/bus/pci/drivers/.../bind

/sys/devices/pciX/.../bind

定义于文件 sysfs-bus-pci

将设备位置写入此文件将导致驱动程序尝试绑定到此位置找到的设备。这对于覆盖默认绑定很有用。位置的格式为:DDDD:BB:DD.F。即 Domain:Bus:Device.Function,与 /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 写入此文件将尝试动态地向 PCI 设备驱动程序添加新的设备 ID。这可能允许驱动程序支持比编译时包含在驱动程序静态设备 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。即 Domain:Bus:Device.Function,与 /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

/sys/bus/usb/devices/usbN/../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) 功率限制,单位毫安,适用于服务器产品。如果某个时间窗口内的平均功率超过此限制,电源控制器将限制操作频率。

仅支持特定的英特尔 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 的能量输入。

仅支持特定的英特尔 i915 显卡平台。

/sys/bus/pci/drivers/i915/.../hwmon/hwmon<i>/fan1_input

定义在文件 sysfs-driver-intel-i915-hwmon

只读。设备风扇转速,单位 RPM。

仅支持特定的英特尔 i915 显卡平台。

/sys/bus/pci/drivers/i915/.../hwmon/hwmon<i>/in0_input

定义在文件 sysfs-driver-intel-i915-hwmon

只读。当前电压,单位毫伏。

仅支持特定的英特尔 i915 显卡平台。

/sys/bus/pci/drivers/i915/.../hwmon/hwmon<i>/power1_crit

定义在文件 sysfs-driver-intel-i915-hwmon

读写。卡片反应性临界 (I1) 功率限制,单位微瓦。

卡片反应性临界 (I1) 功率限制,单位微瓦,适用于客户端产品。如果某个时间窗口内的平均功率超过此限制,电源控制器将限制操作频率。

仅支持特定的英特尔 i915 显卡平台。

/sys/bus/pci/drivers/i915/.../hwmon/hwmon<i>/power1_max

定义在文件 sysfs-driver-intel-i915-hwmon

读写。卡片反应性持续 (PL1/Tau) 功率限制,单位微瓦。

如果某个时间窗口(通常为数秒)内的平均功率超过此限制,电源控制器将限制操作频率。读取值为 0 表示 PL1 功率限制已禁用,写入 0 将禁用该限制。写入大于 0 的值将启用功率限制。

仅支持特定的英特尔 i915 显卡平台。

/sys/bus/pci/drivers/i915/.../hwmon/hwmon<i>/power1_max_interval

定义在文件 sysfs-driver-intel-i915-hwmon

读写。持续功率限制间隔(PL1/Tau 中的 Tau),以毫秒为单位,表示持续功率的平均时间。

仅支持特定的英特尔 i915 显卡平台。

/sys/bus/pci/drivers/i915/.../hwmon/hwmon<i>/power1_rated_max

定义在文件 sysfs-driver-intel-i915-hwmon

只读。卡片默认功耗限制(默认 TDP 设置)。

仅支持特定的英特尔 i915 显卡平台。

/sys/bus/pci/drivers/i915/.../hwmon/hwmon<i>/temp1_input

定义在文件 sysfs-driver-intel-i915-hwmon

只读。GPU 封装温度,单位毫摄氏度。

仅支持特定的英特尔 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) 的 stubdomain 且实际设备分配给 HVM 时设置。为分配给 PV 客户机的设备设置此属性是不安全的(类似于 permissive 属性)。当连接的 pcifront 终止时,设备会自动从此列表中删除。

/sys/bus/pci/drivers/pciback/quirks

定义在文件 sysfs-driver-pciback

如果设置了 permissive 属性,则写入 DDDD:BB:DD.F-REG:SIZE:MASK 格式的字符串将允许客户机读写 PCI 设备。即 Domain:Bus: Device.Function-Register:Size:Mask (Domain 是可选的)。例如

#echo 00:19.0-E0:2:FF > /sys/bus/pci/drivers/pciback/quirks

将允许客户机读写配置寄存器 0x0E。

/sys/bus/pci/drivers/pcie_mp2_amd/*/hpd

定义在文件 sysfs-driver-amd-sfh

人体存在检测 (HPD) 启用/禁用。当 HPD 启用时,设备将能够检测到人体的存在,并发送一个中断,该中断可用于将系统从低功耗状态唤醒。当 HPD 禁用时,设备将无法检测到人体的存在。

访问:读/写 有效值:enabled/disabled

/sys/bus/pci/drivers/xe/.../hwmon/hwmon<i>/curr1_crit

定义在文件 sysfs-driver-intel-xe-hwmon

读写。卡片反应性临界 (I1) 功率限制,单位毫安。

卡片反应性临界 (I1) 功率限制,单位毫安,适用于服务器产品。如果某个时间窗口内的平均功率超过此限制,电源控制器将限制操作频率。

/sys/bus/pci/drivers/xe/.../hwmon/hwmon<i>/energy1_input

定义在文件 sysfs-driver-intel-xe-hwmon

只读。卡片设备的能量输入,单位微焦耳。

仅支持特定的英特尔 Xe 显卡平台。

/sys/bus/pci/drivers/xe/.../hwmon/hwmon<i>/energy2_input

定义在文件 sysfs-driver-intel-xe-hwmon

只读。设备封装的能量输入,单位微焦耳。

仅支持特定的英特尔 Xe 显卡平台。

/sys/bus/pci/drivers/xe/.../hwmon/hwmon<i>/fan1_input

定义在文件 sysfs-driver-intel-xe-hwmon

只读。风扇 1 转速,单位 RPM。

仅支持特定的英特尔 Xe 显卡平台。

/sys/bus/pci/drivers/xe/.../hwmon/hwmon<i>/fan2_input

定义在文件 sysfs-driver-intel-xe-hwmon

只读。风扇 2 转速,单位 RPM。

仅支持特定的英特尔 Xe 显卡平台。

/sys/bus/pci/drivers/xe/.../hwmon/hwmon<i>/fan3_input

定义在文件 sysfs-driver-intel-xe-hwmon

只读。风扇 3 转速,单位 RPM。

仅支持特定的英特尔 Xe 显卡平台。

/sys/bus/pci/drivers/xe/.../hwmon/hwmon<i>/in1_input

定义在文件 sysfs-driver-intel-xe-hwmon

只读。封装当前电压,单位毫伏。

仅支持特定的英特尔 Xe 显卡平台。

/sys/bus/pci/drivers/xe/.../hwmon/hwmon<i>/power1_crit

定义在文件 sysfs-driver-intel-xe-hwmon

读写。卡片反应性临界 (I1) 功率限制,单位微瓦。

卡片反应性临界 (I1) 功率限制,单位微瓦,适用于客户端产品。如果某个时间窗口内的平均功率超过此限制,电源控制器将限制操作频率。

仅支持特定的英特尔 Xe 显卡平台。

/sys/bus/pci/drivers/xe/.../hwmon/hwmon<i>/power1_max

定义在文件 sysfs-driver-intel-xe-hwmon

读写。卡片反应性持续 (PL1) 功率限制,单位微瓦。

如果某个时间窗口(通常为数秒)内的平均功率超过此限制,电源控制器将限制操作频率。读取值为 0 表示 PL1 功率限制已禁用,写入 0 将禁用该限制。写入大于 0 且小于或等于 TDP 的值将启用功率限制。

仅支持特定的英特尔 Xe 显卡平台。

/sys/bus/pci/drivers/xe/.../hwmon/hwmon<i>/power1_max_interval

定义在文件 sysfs-driver-intel-xe-hwmon

读写。卡片持续功率限制间隔(PL1/Tau 中的 Tau),以毫秒为单位,表示持续功率的平均时间。

仅支持特定的英特尔 Xe 显卡平台。

/sys/bus/pci/drivers/xe/.../hwmon/hwmon<i>/power1_rated_max

定义在文件 sysfs-driver-intel-xe-hwmon

只读。卡片默认功耗限制(默认 TDP 设置)。

仅支持特定的英特尔 Xe 显卡平台。

/sys/bus/pci/drivers/xe/.../hwmon/hwmon<i>/power2_max

定义在文件 sysfs-driver-intel-xe-hwmon

读写。封装反应性持续 (PL1) 功率限制,单位微瓦。

如果某个时间窗口(通常为数秒)内的平均功率超过此限制,电源控制器将限制操作频率。读取值为 0 表示 PL1 功率限制已禁用,写入 0 将禁用该限制。写入大于 0 且小于或等于 TDP 的值将启用功率限制。

仅支持特定的英特尔 Xe 显卡平台。

/sys/bus/pci/drivers/xe/.../hwmon/hwmon<i>/power2_max_interval

定义在文件 sysfs-driver-intel-xe-hwmon

读写。封装持续功率限制间隔(PL1/Tau 中的 Tau),以毫秒为单位,表示持续功率的平均时间。

仅支持特定的英特尔 Xe 显卡平台。

/sys/bus/pci/drivers/xe/.../hwmon/hwmon<i>/power2_rated_max

定义在文件 sysfs-driver-intel-xe-hwmon

只读。封装默认功耗限制(默认 TDP 设置)。

仅支持特定的英特尔 Xe 显卡平台。

/sys/bus/pci/drivers/xe/.../hwmon/hwmon<i>/temp2_input

定义在文件 sysfs-driver-intel-xe-hwmon

只读。封装温度,单位毫摄氏度。

仅支持特定的英特尔 Xe 显卡平台。

/sys/bus/pci/drivers/xe/.../hwmon/hwmon<i>/temp3_input

定义在文件 sysfs-driver-intel-xe-hwmon

只读。VRAM 温度,单位毫摄氏度。

仅支持特定的英特尔 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 node name`T`type`

其他平台设备则使用

  • platform:驱动程序名称

/sys/bus/platform/devices/.../msi_irqs/

定义在文件 sysfs-bus-platform

The /sys/devices/.../msi_irqs目录包含一组可变文件,每个文件都以分配给该设备的相应MSI中断向量命名。

/sys/bus/platform/devices/.../msi_irqs/<N>

定义在文件 sysfs-bus-platform

如果<N>是有效的msi中断,此属性将显示“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/<HID>/hwmon/hwmonX/<block>/<reg>

在文件 sysfs-platform-mellanox-pmc 中定义

寄存器值。这用于读取或重置每个块计算各种性能统计信息的寄存器。向sysfs写入0将清除计数器,写入任何其他值是不允许的。

/sys/bus/platform/devices/<HID>/hwmon/hwmonX/<block>/count_clock

在文件 sysfs-platform-mellanox-pmc 中定义

使用计数器来计数周期。这用于将块中的任何计数器重新用于/专用于计数周期。每个计数器由一个位表示(位0表示计数器0,位1表示计数器1,依此类推),设置相应的位将保留该特定计数器用于计数周期并覆盖event<N>设置。

/sys/bus/platform/devices/<HID>/hwmon/hwmonX/<block>/counter<N>

在文件 sysfs-platform-mellanox-pmc 中定义

正在监控的事件的计数器值。这用于读取使用event<N>编程的事件的计数器值。这也可通过向计数器sysfs写入0来清除或重置计数器值。

/sys/bus/platform/devices/<HID>/hwmon/hwmonX/<block>/enable

在文件 sysfs-platform-mellanox-pmc 中定义

启动或停止计数器。这用于启动计数器以监控已编程的事件,并在所需持续时间后停止计数器。写入值1将启动块中的所有计数器,写入0将同时停止所有计数器。

/sys/bus/platform/devices/<HID>/hwmon/hwmonX/<block>/event<N>

在文件 sysfs-platform-mellanox-pmc 中定义

相应计数器监控的事件。这用于编程或回读应由或当前正由counter<N>监控的事件。

/sys/bus/platform/devices/<HID>/hwmon/hwmonX/<block>/event_list

在文件 sysfs-platform-mellanox-pmc 中定义

特定块中计数器支持的事件列表。这用于提取与每个事件关联的事件编号或ID。

/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 中定义

(读写)交流警报计时器值。

如果未设置交流警报以唤醒系统,读取将返回当前的交流警报计时器值(以秒为单位)或“disabled”。

向其写入新的交流警报计时器值(以秒为单位)或“disabled”,分别用于设置交流警报计时器或禁用它。

如果通过此属性设置的交流警报计时器过期,它将立即从S3睡眠状态(如果支持,也包括S4/S5)唤醒系统,直到其状态通过ac_status属性被明确清除。

/sys/bus/platform/devices/ACPI000E:00/ac_policy

在文件 sysfs-devices-platform-ACPI-TAD 中定义

(读写)交流警报过期计时器唤醒策略(详见ACPI 6.2,第9.18节)。

如果策略是当系统处于直流电源时丢弃交流计时器唤醒,读取将返回交流警报计时器当前的过期计时器唤醒延迟,或“never”。

向其写入新的交流警报计时器过期唤醒延迟(以秒为单位)或“never”,分别用于设置交流警报计时器的过期唤醒延迟,或设置其过期唤醒策略为当系统处于直流电源时丢弃唤醒。

/sys/bus/platform/devices/ACPI000E:00/ac_status

在文件 sysfs-devices-platform-ACPI-TAD 中定义

(读写)交流警报状态。

读取返回一个十六进制位掩码,表示交流警报计时器状态,其位的含义如下(详见ACPI 6.2,第9.18.5节)

位(0)

如果设置,计时器已过期。

位(1)

如果设置,计时器已将系统从睡眠状态(S3或S4/S5,如果支持)唤醒。

其他位保留。

读取还会导致交流警报计时器状态被重置。

重置交流警报计时器状态的另一种方法是向此文件写入(数字)0。

如果状态返回值表明计时器已过期,它将立即从S3睡眠状态(如果支持,也包括S4/S5)唤醒系统,直到其状态通过此属性被明确清除。

/sys/bus/platform/devices/ACPI000E:00/caps

在文件 sysfs-devices-platform-ACPI-TAD 中定义

(只读)由平台固件报告的TAD属性的十六进制位掩码(详见ACPI 6.2,第9.18.2节)

位(0)

如果设置,交流唤醒已实现

位(1)

如果设置,直流唤醒已实现

位(2)

如果设置,实时功能获取/设置已实现

位(3)

如果设置,实时精度以毫秒为单位

位(4)

如果设置,S4/S5唤醒状态报告正确

位(5)

如果设置,交流计时器从S4唤醒

位(6)

如果设置,交流计时器从S5唤醒

位(7)

如果设置,直流计时器从S4唤醒

位(8)

如果设置,直流计时器从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

/sys/bus/platform/devices/GOOG0016:*/BINF.2

在文件 sysfs-driver-chromeos-acpi 中定义

返回当前启动的主控(EC)固件(布尔值)。

0

只读(恢复)固件。

1

可重写固件。

/sys/bus/platform/devices/GGL0001:*/BINF.3

/sys/bus/platform/devices/GOOG0016:*/BINF.3

在文件 sysfs-driver-chromeos-acpi 中定义

返回当前启动的主固件类型(整数)。

0

恢复。

1

正常。

2

开发者。

3

网络启动(仅限工厂安装)。

/sys/bus/platform/devices/GGL0001:*/CHSW

/sys/bus/platform/devices/GOOG0016:*/CHSW

在文件 sysfs-driver-chromeos-acpi 中定义

返回固件启动时Chrome OS专用硬件开关的位置(整数)。

0

无变化。

2

恢复按钮被按下。

4

恢复按钮被按下(EC固件)。

32

开发者开关已启用。

512

固件写保护已禁用。

/sys/bus/platform/devices/GGL0001:*/FMAP

/sys/bus/platform/devices/GOOG0016:*/FMAP

在文件 sysfs-driver-chromeos-acpi 中定义

返回主处理器固件闪存映射起始的物理内存地址。

/sys/bus/platform/devices/GGL0001:*/FRID

/sys/bus/platform/devices/GOOG0016:*/FRID

在文件 sysfs-driver-chromeos-acpi 中定义

返回主处理器固件只读部分的固件版本。

/sys/bus/platform/devices/GGL0001:*/FWID

/sys/bus/platform/devices/GOOG0016:*/FWID

在文件 sysfs-driver-chromeos-acpi 中定义

返回主处理器固件可重写部分的固件版本。

/sys/bus/platform/devices/GGL0001:*/GPIO.X/GPIO.0

/sys/bus/platform/devices/GOOG0016:*/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

/sys/bus/platform/devices/GOOG0016:*/GPIO.X/GPIO.1

在文件 sysfs-driver-chromeos-acpi 中定义

返回GPIO信号的信号属性(整数位域)。

0

信号低电平有效。

1

信号高电平有效。

/sys/bus/platform/devices/GGL0001:*/GPIO.X/GPIO.2

/sys/bus/platform/devices/GOOG0016:*/GPIO.X/GPIO.2

在文件 sysfs-driver-chromeos-acpi 中定义

返回指定GPIO控制器上的GPIO编号。

/sys/bus/platform/devices/GGL0001:*/GPIO.X/GPIO.3

/sys/bus/platform/devices/GOOG0016:*/GPIO.X/GPIO.3

在文件 sysfs-driver-chromeos-acpi 中定义

返回GPIO控制器的名称。

/sys/bus/platform/devices/GGL0001:*/HWID

/sys/bus/platform/devices/GOOG0016:*/HWID

在文件 sysfs-driver-chromeos-acpi 中定义

返回Chromebook的硬件ID。

/sys/bus/platform/devices/GGL0001:*/MECK

/sys/bus/platform/devices/GOOG0016:*/MECK

在文件 sysfs-driver-chromeos-acpi 中定义

返回启动期间从管理引擎扩展寄存器中读取的SHA-1或SHA-256哈希值。该哈希值通过ACPI导出,以便操作系统可以验证管理引擎固件是否未更改。如果管理引擎不存在,或者固件无法读取扩展寄存器,则此缓冲区大小可以为零。

/sys/bus/platform/devices/GGL0001:*/VBNV.0

/sys/bus/platform/devices/GOOG0016:*/VBNV.0

在文件 sysfs-driver-chromeos-acpi 中定义

返回CMOS Bank 0中已验证启动非易失性存储块的偏移量,从第一个可写入的CMOS字节开始计数(即,‘offset = 0’是14字节时钟数据后的字节)。

/sys/bus/platform/devices/GGL0001:*/VBNV.1

/sys/bus/platform/devices/GOOG0016:*/VBNV.1

在文件 sysfs-driver-chromeos-acpi 中定义

返回已验证启动非易失性存储块的大小(以字节为单位)。

/sys/bus/platform/devices/GGL0001:*/VDAT

/sys/bus/platform/devices/GOOG0016:*/VDAT

在文件 sysfs-driver-chromeos-acpi 中定义

返回固件验证步骤和内核验证步骤之间共享的已验证启动数据块(十六进制转储)。

/sys/bus/platform/devices/GOOG000C\:00/boot_on_ac

在文件 sysfs-platform-wilco-ec 中定义

交流电源启动是一项策略,当连接交流电源时,设备将从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 中定义

(只读)显示最坏情况下的平台功率的其余部分(SoC之外)。

/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 中定义

(读写)当FIVR时钟为38.4MHz时,PCH FIVR(全集成稳压器)的开关频率,以MHz为单位。

/sys/bus/platform/devices/INTC1045:00/pch_fivr_switch_frequency/freq_mhz_low_clock

在文件 sysfs-platform-dptf 中定义

(读写)当FIVR时钟为19.2MHz或24MHz时,PCH FIVR(全集成稳压器)的开关频率,以MHz为单位。

/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条目打开文件描述符(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 中定义

下次重置的引导流来源。可以是以下值之一

外部

从外部源(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/rtc_battery

在文件 sysfs-platform-mellanox-bootctl 中定义

“rtc_battery”sysfs属性是只读的。成功读取此属性将返回电路板RTC电池的状态。成功读取操作后,RTC电池状态寄存器也会被清除。

/sys/bus/platform/devices/MLNXBF04:00/second_reset_action

在文件 sysfs-platform-mellanox-bootctl 中定义

下次重置后更新引导流的来源。可以是以下值之一,并将在下次重置后应用。

外部

从外部源(USB或PCIe)启动

emmc

从片上eMMC启动

emmc_legacy

以传统(慢速)模式从片上eMMC启动

交换emmc

交换主/副启动分区

取消操作

/sys/bus/platform/devices/MLNXBF04:00/secure_boot_fuse_state

在文件 sysfs-platform-mellanox-bootctl 中定义

eFuse版本的状态,具有以下值。

正在使用

已烧录、有效且当前正在使用

已使用

已烧录且有效

空闲

未烧录且可自由使用

跳过

未烧录但不可用(已跳过)

已废弃

已烧录且无效

无效

未烧录但标记为有效(错误状态)。

/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锁定模式。

  • 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。a_bus_req也可以由内核响应B设备的远程唤醒信号而设置为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

只读。它返回Bitstream(静态FPGA区域)标识符编号,其中包括此静态FPGA区域的详细版本及其他信息。

/sys/bus/platform/devices/dfl-fme.0/bitstream_metadata

只读。它返回Bitstream(静态FPGA区域)元数据,其中包括此静态FPGA区域的综合日期、种子及其他信息。

只读。它返回Bitstream(静态FPGA区域)标识符编号,其中包括此静态FPGA区域的详细版本及其他信息。

/sys/bus/platform/devices/dfl-fme.0/cache_size

只读。它返回此FPGA设备的缓存大小。

只读。它返回Bitstream(静态FPGA区域)标识符编号,其中包括此静态FPGA区域的详细版本及其他信息。

/sys/bus/platform/devices/dfl-fme.0/errors/catfatal_errors

只读。它返回检测到的灾难性错误和致命错误。

只读。它返回Bitstream(静态FPGA区域)标识符编号,其中包括此静态FPGA区域的详细版本及其他信息。

/sys/bus/platform/devices/dfl-fme.0/errors/first_error

只读。读取此文件以获取硬件检测到的第一个错误。

只读。它返回Bitstream(静态FPGA区域)标识符编号,其中包括此静态FPGA区域的详细版本及其他信息。

/sys/bus/platform/devices/dfl-fme.0/errors/fme_errors

读写。读取此文件以获取FME上检测到的错误。写入此文件以清除fme_errors中记录的错误。如果输入解析失败或输入错误代码不匹配,写入将失败并返回-EINVAL。

只读。它返回Bitstream(静态FPGA区域)标识符编号,其中包括此静态FPGA区域的详细版本及其他信息。

/sys/bus/platform/devices/dfl-fme.0/errors/inject_errors

读写。读取此文件以检查注入的错误。写入此文件以注入错误进行测试。如果输入解析失败或输入的注入错误代码不受支持,写入将失败并返回-EINVAL。

只读。它返回Bitstream(静态FPGA区域)标识符编号,其中包括此静态FPGA区域的详细版本及其他信息。

/sys/bus/platform/devices/dfl-fme.0/errors/next_error

只读。读取此文件以获取硬件检测到的第二个错误。

只读。它返回Bitstream(静态FPGA区域)标识符编号,其中包括此静态FPGA区域的详细版本及其他信息。

/sys/bus/platform/devices/dfl-fme.0/errors/nonfatal_errors

只读。它返回检测到的非致命错误。

只读。它返回Bitstream(静态FPGA区域)标识符编号,其中包括此静态FPGA区域的详细版本及其他信息。

/sys/bus/platform/devices/dfl-fme.0/errors/pcie0_errors

读写。读取此文件以获取pcie0链路上检测到的错误。写入此文件以清除pcie0_errors中记录的错误。如果输入解析失败或输入错误代码不匹配,写入将失败并返回-EINVAL。

只读。它返回Bitstream(静态FPGA区域)标识符编号,其中包括此静态FPGA区域的详细版本及其他信息。

/sys/bus/platform/devices/dfl-fme.0/errors/pcie1_errors

读写。读取此文件以获取pcie1链路上检测到的错误。写入此文件以清除pcie1_errors中记录的错误。如果输入解析失败或输入错误代码不匹配,写入将失败并返回-EINVAL。

只读。它返回Bitstream(静态FPGA区域)标识符编号,其中包括此静态FPGA区域的详细版本及其他信息。

/sys/bus/platform/devices/dfl-fme.0/fabric_version

只读。它返回此FPGA设备的fabric版本。用户空间应用程序需要此信息来根据不同的fabric设计选择最佳数据通道。

只读。它返回Bitstream(静态FPGA区域)标识符编号,其中包括此静态FPGA区域的详细版本及其他信息。

/sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/name

只读。读取此文件以获取hwmon设备的名称,它支持的值为

只读。它返回Bitstream(静态FPGA区域)标识符编号,其中包括此静态FPGA区域的详细版本及其他信息。

‘dfl_fme_thermal’

热量hwmon设备名称

‘dfl_fme_power’

功率hwmon设备名称

/sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/power1_crit

读写。读取此文件以获取当前硬件功率阈值2(以微瓦为单位)。如果功耗达到或超过此阈值,硬件将开始90%限速。写入此文件以设置当前硬件功率阈值2(以微瓦为单位)。由于硬件只接受瓦特为单位的值,因此输入值将按瓦特向下取整(小于1瓦特的部分将被舍弃),并限制在0到127瓦特之间。如果输入解析失败,写入将失败并返回-EINVAL。

只读。它返回Bitstream(静态FPGA区域)标识符编号,其中包括此静态FPGA区域的详细版本及其他信息。

/sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/power1_crit_alarm

只读。如果功耗当前达到或超过硬件阈值2(参见‘power1_crit’),则返回1,否则返回0。

只读。它返回Bitstream(静态FPGA区域)标识符编号,其中包括此静态FPGA区域的详细版本及其他信息。

/sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/power1_fpga_limit

只读。它返回FPGA的功率限制,以微瓦为单位。

只读。它返回Bitstream(静态FPGA区域)标识符编号,其中包括此静态FPGA区域的详细版本及其他信息。

/sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/power1_input

只读。它返回当前FPGA功耗,以微瓦为单位。

只读。它返回Bitstream(静态FPGA区域)标识符编号,其中包括此静态FPGA区域的详细版本及其他信息。

/sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/power1_ltr

只读。读取此文件以获取当前延迟容忍报告(ltr)值。如果所有加速功能单元(AFU)都能容忍内存访问延迟>= 40微秒,则返回1;如果任何AFU对延迟敏感(< 40微秒),则返回0。

只读。它返回Bitstream(静态FPGA区域)标识符编号,其中包括此静态FPGA区域的详细版本及其他信息。

/sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/power1_max

读写。读取此文件以获取当前硬件功率阈值1(以微瓦为单位)。如果功耗达到或超过此阈值,硬件将开始50%限速。写入此文件以设置当前硬件功率阈值1(以微瓦为单位)。由于硬件只接受瓦特为单位的值,因此输入值将按瓦特向下取整(小于1瓦特的部分将被舍弃),并限制在0到127瓦特之间。如果输入解析失败,写入将失败并返回-EINVAL。

只读。它返回Bitstream(静态FPGA区域)标识符编号,其中包括此静态FPGA区域的详细版本及其他信息。

/sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/power1_max_alarm

只读。如果功耗当前达到或超过硬件阈值1(参见‘power1_max’),则返回1,否则返回0。

只读。它返回Bitstream(静态FPGA区域)标识符编号,其中包括此静态FPGA区域的详细版本及其他信息。

/sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/power1_xeon_limit

只读。它返回XEON的功率限制,以微瓦为单位。

只读。它返回Bitstream(静态FPGA区域)标识符编号,其中包括此静态FPGA区域的详细版本及其他信息。

/sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/temp1_crit

只读。它返回硬件阈值2温度,以毫摄氏度为单位。如果温度达到或超过此阈值,硬件将开始100%限速。

只读。它返回Bitstream(静态FPGA区域)标识符编号,其中包括此静态FPGA区域的详细版本及其他信息。

/sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/temp1_crit_alarm

只读。如果温度当前达到或超过硬件阈值2(参见‘temp1_crit’),则返回1,否则返回0。

只读。它返回Bitstream(静态FPGA区域)标识符编号,其中包括此静态FPGA区域的详细版本及其他信息。

/sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/temp1_emergency

只读。它返回硬件跳闸阈值温度,以毫摄氏度为单位。如果温度达到或超过此阈值,将触发致命事件到板管理控制器(BMC)以关闭FPGA。

只读。它返回Bitstream(静态FPGA区域)标识符编号,其中包括此静态FPGA区域的详细版本及其他信息。

/sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/temp1_input

只读。它返回FPGA设备温度,以毫摄氏度为单位。

只读。它返回Bitstream(静态FPGA区域)标识符编号,其中包括此静态FPGA区域的详细版本及其他信息。

/sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/temp1_max

/sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/temp1_max

只读。它返回Bitstream(静态FPGA区域)标识符编号,其中包括此静态FPGA区域的详细版本及其他信息。

只读。它以毫摄氏度为单位返回硬件阈值1温度。如果温度达到或超过此阈值,硬件将启动50%或90%的节流(请参阅“temp1_max_policy”)。

/sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/temp1_max_alarm

只读。它返回Bitstream(静态FPGA区域)标识符编号,其中包括此静态FPGA区域的详细版本及其他信息。

只读。如果温度当前达到或超过硬件阈值1(请参阅“temp1_max”),则返回1,否则返回0。

/sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/temp1_max_policy

只读。它返回Bitstream(静态FPGA区域)标识符编号,其中包括此静态FPGA区域的详细版本及其他信息。

只读。读取此文件以获取硬件阈值1的策略(请参阅“temp1_max”)。它仅支持两个值(策略)

0

AP2状态(90%节流)

1

AP1状态(50%节流)

/sys/bus/platform/devices/dfl-fme.0/ports_num

只读。它返回Bitstream(静态FPGA区域)标识符编号,其中包括此静态FPGA区域的详细版本及其他信息。

只读。一个DFL FPGA设备可能有一个以上的端口/加速器功能单元(AFU)。读取时,它返回FPGA设备上的端口数量。

/sys/bus/platform/devices/dfl-fme.0/socket_id

只读。它返回Bitstream(静态FPGA区域)标识符编号,其中包括此静态FPGA区域的详细版本及其他信息。

只读。它返回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-fme.0/errors/fme_errors

/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可以容忍延迟>=40微秒,则将ltr设置为1;如果AFU对延迟敏感,则将其设置为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硬件的首次故障数据捕获,如果存在来自先前传输的数据。否则,文件为空。数据在用户完全读取后被清除。顾名思义,只有首次错误的数据被保存,直到读取后被清除。运行在基板管理控制器(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警告

详情请参见《Altra Family Soc BMC接口规范》第5.10节RAS内部错误寄存器定义

/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 # | 插槽 << 11

MCU(内存)

1

2

ERR2

MCU # | 插槽 << 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 #

Mesh(其他)

2

0

交叉点

X | (Y << 5) | NS <<11

Mesh(其他)

2

1

主节点(IO)

X | (Y << 5) | NS <<11

Mesh(其他)

2

2

主节点(内存)

X | (Y << 5) | NS <<11 | 设备<<12

Mesh(其他)

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: 可纠正错误

详情请参见《Altra Family RAS补充》第3.3节Ampere(供应商特定)错误记录格式

/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 2倍刷新率

/sys/bus/platform/devices/smpro-errmon.*/event_dimm_2x_refresh

高温下的DIMM 2倍刷新率事件

更多详情请参见《Altra Family Soc BMC接口规范》第5.7节GPI状态寄存器和5.9节内存错误寄存器定义

/sys/bus/platform/devices/smpro-errmon.*/event_dimm[0-15]_syndrome

在文件sysfs-bus-platform-devices-ampere-smpro中定义

(只读)如果DIMM插槽0-15初始化失败,sysfs将返回2字节的DIMM故障征兆数据。

更多详情请参见《Altra Family Soc BMC接口规范》第5.11节引导阶段寄存器定义

/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瓦

  • 最大值:插槽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: 为每个引导阶段定义的引导状态信息

详情请参见《Altra Family Soc BMC接口规范》第5.11节引导阶段寄存器定义第6节处理器引导进度代码

/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核心排名。

此文件在以下两种模式之间切换:- “frequency”(频率)模式下,较快CCD中的核心优先于较慢CCD中的核心。- “cache”(缓存)模式下,较大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的mini-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/*/attributes/wb_resize_hint

/sys/bus/platform/devices/*.ufs/attributes/wb_resize_hint

在文件 sysfs-driver-ufs 中定义

wb_resize_hint指示设备推荐的WriteBooster缓冲区调整大小类型的提示信息。

保持

建议保持缓冲区大小

减少

建议减小缓冲区大小

增加

建议增大缓冲区大小

该文件是只读的。

/sys/bus/platform/drivers/ufshcd/*/attributes/wb_resize_status

/sys/bus/platform/devices/*.ufs/attributes/wb_resize_status

在文件 sysfs-driver-ufs 中定义

主机可以通过读取此属性来检查WriteBooster缓冲区的调整大小操作状态。

空闲

调整大小操作未发出

进行中

调整大小操作进行中

完成成功

调整大小操作成功完成

一般故障

调整大小操作一般故障

该文件是只读的。

/sys/bus/platform/drivers/ufshcd/*/capabilities/

/sys/bus/platform/devices/*.ufs/capabilities/

在文件 sysfs-driver-ufs 中定义

该组表示主机-设备对的有效功能。即,为特定主机控制器在驱动程序中启用、由主机控制器支持且在设备侧支持和/或具有兼容配置的功能。

/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/*/clkgate_delay_ms

/sys/bus/platform/devices/*.ufs/clkgate_delay_ms

在文件 sysfs-driver-ufs 中定义

此属性显示并设置UFS驱动程序开始执行时钟门控之前的空闲时间(毫秒)。这可以防止UFS频繁进行时钟门控/解除门控。

该属性是读/写的。

/sys/bus/platform/drivers/ufshcd/*/clkgate_enable

/sys/bus/platform/devices/*.ufs/clkgate_enable

在文件 sysfs-driver-ufs 中定义

此属性显示UFS时钟门控是否启用。可以通过向此属性写入1或0来启用/禁用时钟门控。

该属性是读/写的。

/sys/bus/platform/drivers/ufshcd/*/clkscale_enable

/sys/bus/platform/devices/*.ufs/clkscale_enable

在文件 sysfs-driver-ufs 中定义

此属性显示UFS时钟缩放是否启用。可以通过向此属性写入1或0来启用/禁用时钟缩放。

该属性是读/写的。

/sys/bus/platform/drivers/ufshcd/*/critical_health

/sys/bus/platform/devices/*.ufs/critical_health

在文件 sysfs-driver-ufs 中定义

报告UFS设备已报告关键健康事件的次数。通过读取以下任意一项可进一步了解具体问题:bPreEOLInfo、bDeviceLifeTimeEstA、bDeviceLifeTimeEstB、bWriteBoosterBufferLifeTimeEst和bRPMBLifeTimeEst。

该文件是只读的。

/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/*/device_lvl_exception_count

/sys/bus/platform/devices/*.ufs/device_lvl_exception_count

在文件 sysfs-driver-ufs 中定义

此属性适用于符合 JEDEC 规范 4.1 或更高版本的 UFS 设备。device_lvl_exception_count 是一个计数器,指示自上次重置此变量以来设备级别异常发生的次数。将此属性写入 0 值将重置 device_lvl_exception_count。如果 device_lvl_exception_count 读取到正值,用户应用程序应读取 device_lvl_exception_id 属性以了解有关异常的更多信息。

该属性是读/写的。

/sys/bus/platform/drivers/ufshcd/*/device_lvl_exception_id

/sys/bus/platform/devices/*.ufs/device_lvl_exception_id

在文件 sysfs-driver-ufs 中定义

读取 device_lvl_exception_id 返回 UFS 设备 JEDEC 规范 4.1 中的 qDeviceLevelExceptionID 属性。qDeviceLevelExceptionID 的定义是 UFS 设备供应商特定的实现。有关 qDeviceLevelExceptionID 属性值的含义的更多信息,请参阅设备制造商数据手册。

此属性只读。

/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 的最大 LUN 数量。

该文件是只读的。

/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

基于 LU 的 WriteBooster 缓冲区配置

01h

单一共享 WriteBooster 缓冲区配置

02h

同时支持基于 LU 的 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 中定义

此文件显示活动 ICC 级别 0 到 15 的最大 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 在上电/复位后启用,但在时钟降频/升频时(如果平台支持 UFSHCD_CAP_CLK_SCALING)将禁用/启用。对于不支持 UFSHCD_CAP_CLK_SCALING 的平台,我们可以通过此 sysfs 节点禁用/启用 WriteBooster。

/sys/bus/platform/drivers/ufshcd/*/wb_resize_enable

/sys/bus/platform/devices/*.ufs/wb_resize_enable

在文件 sysfs-driver-ufs 中定义

主机可以通过设置此属性来启用 WriteBooster 缓冲区大小调整。

空闲

没有大小调整操作

减少

减小 WriteBooster 缓冲区大小

增加

增大 WriteBooster 缓冲区大小

此文件只写。

/sys/bus/platform/drivers/zynqmp_fpga_manager/firmware:zynqmp-firmware:pcap/status

定义于文件 sysfs-driver-zynqmp-fpga

(RO) 读取 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:MMCMs/PLLs 未锁定 1:MMCMs/PLLs 已锁定

位(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 去置位

比特 (8) 到 比特 (10)

模式引脚的状态

比特 (11)

0:初始化未完成 1:初始化完成

比特 (12)

INIT_B_PIN 引脚上的值

比特 (13)

0:信号未释放 1:信号已释放

比特 (14)

DONE_PIN 引脚上的值。

比特 (15)

0:无 IDCODE_ERROR 1:有 IDCODE_ERROR

比特 (16)

0:无 SECURITY_ERROR 1:有 SECURITY_ERROR

比特 (17)

如果设置,系统监控器超温

比特 (18) 到 比特 (20)

启动状态机(0 到 7) 阶段 0 = 000 阶段 1 = 001 阶段 2 = 011 阶段 3 = 010 阶段 4 = 110 阶段 5 = 111 阶段 6 = 101 阶段 7 = 100

比特 (25) 到 比特 (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

终端设备的四位设备目标 ID (destID),或交换机的交换机 ID (switchID)

例如,以下是设备目录列表,它代表了一个典型的 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

(RO) 返回包含该设备的组件标识符

/sys/bus/rapidio/devices/<nn>:<d>:<iiii>/asm_rev

定义于文件 sysfs-bus-rapidio

(RO) 返回包含该设备的组件修订级别

/sys/bus/rapidio/devices/<nn>:<d>:<iiii>/asm_vid

定义于文件 sysfs-bus-rapidio

(RO) 返回包含该设备的组件供应商标识符

/sys/bus/rapidio/devices/<nn>:<d>:<iiii>/config

定义于文件 sysfs-bus-rapidio

(RW) 用于使用 RapidIO 维护事务读写设备配置寄存器的二进制属性。此属性的行为类似于 PCI 设备的“config”属性,并提供使用标准文件读写操作访问 RapidIO 设备寄存器的方法。

RapidIO 交换机设备属性

RapidIO 交换机在 sysfs 中具有额外的属性。RapidIO 子系统支持交换机的通用和设备特定 sysfs 属性。由于交换机集成到 RapidIO 子系统中,它提供了一种通过指定一个回调函数来创建设备特定 sysfs 属性的方法,该回调函数可在枚举或发现过程中由交换机初始化例程设置。

/sys/bus/rapidio/devices/<nn>:<d>:<iiii>/destid

定义于文件 sysfs-bus-rapidio

(RO) 返回由枚举例程分配的设备目标 ID

/sys/bus/rapidio/devices/<nn>:<d>:<iiii>/device_rev

定义于文件 sysfs-bus-rapidio

(RO) 返回设备修订级别

/sys/bus/rapidio/devices/<nn>:<d>:<iiii>/did

定义于文件 sysfs-bus-rapidio

(RO) 返回设备标识符

/sys/bus/rapidio/devices/<nn>:<d>:<iiii>/lprev

定义于文件 sysfs-bus-rapidio

(RO) 返回通往拥有此属性的设备路径上的前一个设备(交换机)的名称

/sys/bus/rapidio/devices/<nn>:<d>:<iiii>/modalias

定义于文件 sysfs-bus-rapidio

(RO) 返回设备模组别名

/sys/bus/rapidio/devices/<nn>:<d>:<iiii>/vid

定义于文件 sysfs-bus-rapidio

(RO) 返回设备供应商标识符

/sys/bus/rapidio/devices/<nn>:<s>:<iiii>/destid

定义于文件 sysfs-bus-rapidio

(RO) 定义到交换机路由的关联设备的设备目标 ID

/sys/bus/rapidio/devices/<nn>:<s>:<iiii>/errlog

定义于文件 sysfs-bus-rapidio

(RO) 读取设备错误日志的内容直到其为空。

RapidIO 总线属性

/sys/bus/rapidio/devices/<nn>:<s>:<iiii>/hopcount

定义于文件 sysfs-bus-rapidio

(RO) 通往交换机路径上的跳数

/sys/bus/rapidio/devices/<nn>:<s>:<iiii>/lnext

定义于文件 sysfs-bus-rapidio

(RO) 返回链接到交换机的设备名称,但连接到入口端口的设备(报告为“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模块以single_major参数设置为true插入时可用。

用法与 /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

(只读) 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

(只读) 映射块设备的大小(以字节为单位)。

major

(只读) 块设备主设备号。

client_id

(只读) 为此特定会话分配的ceph唯一客户端ID。

pool

(只读) 此rbd镜像所在的存储池名称。rbd镜像名称在其池中是唯一的。

name

(只读) rbd镜像的名称。

refresh

(只写) 写入此文件将重新读取镜像头数据并相应地设置所有相关数据结构。

current_snap

(只读) 设备当前映射的快照。

/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

(只读) 当前快照的ID。

config_info

(只读) 写入 /sys/bus/rbd/add{,_single_major} 的字符串。

cluster_fsid

(只读) ceph集群的UUID。

client_addr

(只读) ceph唯一客户端的entity_addr_t(地址 + nonce)。格式为 <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

(只写) 移除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模块以single_major参数设置为true插入时可用。

用法与 /sys/bus/rbd/remove 相同。如果存在,应使用此项而不是后者:如果 /sys/bus/rbd/remove_single_major 可用,任何使用 /sys/bus/rbd/remove 的尝试都将因向后兼容性原因而失败。

/sys/bus/rbd/supported_features

定义在文件 sysfs-bus-rbd

(只读) 显示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

/sys/bus/soundwire/devices/sdw-master-<N>/clk_stop_modes

/sys/bus/soundwire/devices/sdw-master-<N>/clk_freq

/sys/bus/soundwire/devices/sdw-master-<N>/clk_gears

/sys/bus/soundwire/devices/sdw-master-<N>/default_col

/sys/bus/soundwire/devices/sdw-master-<N>/default_frame_rate

/sys/bus/soundwire/devices/sdw-master-<N>/default_row

/sys/bus/soundwire/devices/sdw-master-<N>/dynamic_shape

/sys/bus/soundwire/devices/sdw-master-<N>/err_threshold

/sys/bus/soundwire/devices/sdw-master-<N>/max_clk_freq

定义在文件 sysfs-bus-soundwire-master

SoundWire Master-N DisCo属性。这些属性由MIPI SoundWire DisCo规范定义。它们定义了主机的各种属性,并由总线用于配置主机。clk_stop_modes 是一个位掩码,用于简化并结合了clock-stop-mode0和clock-stop-mode1属性。

/sys/bus/soundwire/devices/sdw:.../dev-properties/mipi_revision

/sys/bus/soundwire/devices/sdw:.../dev-properties/wake_capable

/sys/bus/soundwire/devices/sdw:.../dev-properties/test_mode_capable

/sys/bus/soundwire/devices/sdw:.../dev-properties/clk_stop_mode1

/sys/bus/soundwire/devices/sdw:.../dev-properties/simple_clk_stop_capable

/sys/bus/soundwire/devices/sdw:.../dev-properties/clk_stop_timeout

/sys/bus/soundwire/devices/sdw:.../dev-properties/ch_prep_timeout

/sys/bus/soundwire/devices/sdw:.../dev-properties/reset_behave

/sys/bus/soundwire/devices/sdw:.../dev-properties/high_PHY_capable

/sys/bus/soundwire/devices/sdw:.../dev-properties/paging_support

/sys/bus/soundwire/devices/sdw:.../dev-properties/bank_delay_support

/sys/bus/soundwire/devices/sdw:.../dev-properties/p15_behave

/sys/bus/soundwire/devices/sdw:.../dev-properties/master_count

/sys/bus/soundwire/devices/sdw:.../dev-properties/source_ports

/sys/bus/soundwire/devices/sdw:.../dev-properties/sink_ports

定义在文件 sysfs-bus-soundwire-slave

SoundWire从机DisCo属性。这些属性由MIPI SoundWire DisCo规范定义。它们定义了SoundWire从机的各种属性,并由总线用于配置从机。

/sys/bus/soundwire/devices/sdw:.../dp0/max_word

/sys/bus/soundwire/devices/sdw:.../dp0/min_word

/sys/bus/soundwire/devices/sdw:.../dp0/words

/sys/bus/soundwire/devices/sdw:.../dp0/BRA_flow_controlled

/sys/bus/soundwire/devices/sdw:.../dp0/simple_ch_prep_sm

/sys/bus/soundwire/devices/sdw:.../dp0/imp_def_interrupts

定义在文件 sysfs-bus-soundwire-slave

SoundWire从机数据端口0 DisCo属性。这些属性由MIPI SoundWire DisCo规范定义。它们定义了数据端口0的各种属性,并由总线用于配置数据端口0。

/sys/bus/soundwire/devices/sdw:.../dp<N>_src/max_word

/sys/bus/soundwire/devices/sdw:.../dp<N>_src/min_word

/sys/bus/soundwire/devices/sdw:.../dp<N>_src/words

/sys/bus/soundwire/devices/sdw:.../dp<N>_src/type

/sys/bus/soundwire/devices/sdw:.../dp<N>_src/max_grouping

/sys/bus/soundwire/devices/sdw:.../dp<N>_src/simple_ch_prep_sm

/sys/bus/soundwire/devices/sdw:.../dp<N>_src/ch_prep_timeout

/sys/bus/soundwire/devices/sdw:.../dp<N>_src/imp_def_interrupts

/sys/bus/soundwire/devices/sdw:.../dp<N>_src/min_ch

/sys/bus/soundwire/devices/sdw:.../dp<N>_src/max_ch

/sys/bus/soundwire/devices/sdw:.../dp<N>_src/channels

/sys/bus/soundwire/devices/sdw:.../dp<N>_src/ch_combinations

/sys/bus/soundwire/devices/sdw:.../dp<N>_src/max_async_buffer

/sys/bus/soundwire/devices/sdw:.../dp<N>_src/block_pack_mode

/sys/bus/soundwire/devices/sdw:.../dp<N>_src/port_encoding

/sys/bus/soundwire/devices/sdw:.../dp<N>_sink/max_word

/sys/bus/soundwire/devices/sdw:.../dp<N>_sink/min_word

/sys/bus/soundwire/devices/sdw:.../dp<N>_sink/words

/sys/bus/soundwire/devices/sdw:.../dp<N>_sink/type

/sys/bus/soundwire/devices/sdw:.../dp<N>_sink/max_grouping

/sys/bus/soundwire/devices/sdw:.../dp<N>_sink/simple_ch_prep_sm

/sys/bus/soundwire/devices/sdw:.../dp<N>_sink/ch_prep_timeout

/sys/bus/soundwire/devices/sdw:.../dp<N>_sink/imp_def_interrupts

/sys/bus/soundwire/devices/sdw:.../dp<N>_sink/min_ch

/sys/bus/soundwire/devices/sdw:.../dp<N>_sink/max_ch

/sys/bus/soundwire/devices/sdw:.../dp<N>_sink/channels

/sys/bus/soundwire/devices/sdw:.../dp<N>_sink/ch_combinations

/sys/bus/soundwire/devices/sdw:.../dp<N>_sink/max_async_buffer

/sys/bus/soundwire/devices/sdw:.../dp<N>_sink/block_pack_mode

/sys/bus/soundwire/devices/sdw:.../dp<N>_sink/port_encoding

定义在文件 sysfs-bus-soundwire-slave

SoundWire从机数据源/宿端口N DisCo属性。这些属性由MIPI SoundWire DisCo规范定义。它们定义了源/宿数据端口N的各种属性,并由总线用于配置数据端口N。

/sys/bus/soundwire/devices/sdw:.../status

/sys/bus/soundwire/devices/sdw:.../device_number

定义在文件 sysfs-bus-soundwire-slave

SoundWire从机状态

这些属性报告从机状态,例如它是否为UNATTACHED,如果不是,则显示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

(只读) 闪存设备报告的SPI NOR闪存的JEDEC ID。

如果闪存不支持“读取JEDEC ID”命令(9Fh),则此属性不存在。对于不符合JEDEC标准的闪存就是这种情况。

/sys/bus/spi/devices/.../spi-nor/manufacturer

定义在文件 sysfs-bus-spi-devices-spi-nor

(只读) SPI NOR闪存的制造商。

如果闪存设备不被内核识别,并且仅通过其SFDP表进行探测,则此属性不存在。

/sys/bus/spi/devices/.../spi-nor/partname

定义在文件 sysfs-bus-spi-devices-spi-nor

(只读) SPI NOR闪存的部件名称。

此属性是可选的。用户空间不应依赖其存在或正确性。相反,用户空间应读取jedec_id属性。

/sys/bus/spi/devices/.../spi-nor/sfdp

定义在文件 sysfs-bus-spi-devices-spi-nor

(只读) 仅当SPI NOR闪存设备支持“读取SFDP”命令(5Ah)时,此属性才存在。

如果存在,它包含闪存的完整SFDP(串行闪存可发现参数)二进制数据。

/sys/bus/surface_aggregator/devices/01:0e:01:00:01/state

定义在文件 sysfs-bus-surface_aggregator-tabletsw

此属性返回一个字符串,其中包含由嵌入式控制器指示的当前键盘盖或设备姿态。当前返回的姿态状态有:

  • “已断开连接”:键盘盖已断开连接。

  • “已关闭”:键盘盖已折叠关闭并覆盖在显示屏上。

  • “笔记本电脑”:键盘盖已打开并处于笔记本电脑模式,即准备好正常使用。

  • “画布折叠”:键盘盖已部分向后折叠,但未与设备背面齐平。通常,这意味着正在使用支架并延伸在盖子上方。

  • “向后折叠”:键盘盖已完全向后折叠并与设备背面齐平。

  • “<未知>”:当前状态对驱动未知,例如由于尚未支持的新硬件。

新状态可能会随新硬件引入。因此,用户不得依赖此状态列表的完整性,并应优雅地处理未知状态。

/sys/bus/surface_aggregator/devices/01:26:01:00:01/state

定义在文件 sysfs-bus-surface_aggregator-tabletsw

此属性返回一个字符串,其中包含由嵌入式控制器指示的当前设备姿态。当前返回的姿态状态有:

  • “已关闭”:设备的盖子已关闭。

  • “笔记本电脑”:设备盖子已打开,设备作为普通笔记本电脑运行。

  • “平板”:屏幕覆盖键盘或已翻转回背面,设备主要依靠触摸输入操作。

  • “平板电脑”:设备作为平板电脑运行,并完全依赖触摸输入(或外部外设)。

  • “<未知>”:当前状态对驱动未知,例如由于尚未支持的新硬件。

新状态可能会随新硬件引入。因此,用户不得依赖此状态列表的完整性,并应优雅地处理未知状态。

/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;如果挑战响应不匹配,则为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可能有一个“预启动ACL”或类似的选项,需要在考虑此列表之前选择。

软件在每次写入时总是更新完整列表。

如果设备在启动时自动授权,则其boot属性设置为1。

/sys/bus/thunderbolt/devices/.../domainX/deauthorization

定义在文件 sysfs-bus-thunderbolt

此属性指示系统是否支持设备解除授权。值为1表示用户可以通过向每个设备下的authorized属性写入0来解除授权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

自动隧道化DisplayPort(和USB)。不创建PCIe隧道。

usbonly

自动隧道化连接的Thunderbolt扩展坞的USB控制器(和DisplayPort)。扩展坞下游的所有PCIe链路都被移除。

nopcie

BIOS中禁用PCIe隧道的USB4系统。

/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

仅为X域设置。对方主机支持作为其输入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

此项包含X域服务公开的属性目录的名称。此条目描述了所涉协议。以下目录已由Apple X域规范保留:

network

通过Thunderbolt的IP/以太网

targetdm

通过Thunderbolt的目标磁盘模式协议

extdisp

通过Thunderbolt的外部显示模式协议

/sys/bus/thunderbolt/devices/<xdomain>.<service>/modalias

定义在文件 sysfs-bus-thunderbolt

存储由uevent为X域服务发出的相同MODALIAS值。格式:tbtsvc:kSpNvNrN

/sys/bus/thunderbolt/devices/<xdomain>.<service>/prtcid

定义在文件 sysfs-bus-thunderbolt

此项包含X域服务支持的X域协议标识符。

/sys/bus/thunderbolt/devices/<xdomain>.<service>/prtcrevs

定义在文件 sysfs-bus-thunderbolt

此项包含X域服务支持的X域软件版本。

/sys/bus/thunderbolt/devices/<xdomain>.<service>/prtcstns

定义在文件 sysfs-bus-thunderbolt

此项包含X域服务特定设置的位掩码。格式:%x

/sys/bus/thunderbolt/devices/<xdomain>.<service>/prtcvers

定义在文件 sysfs-bus-thunderbolt

此项包含X域服务支持的X域协议版本。

/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

显示模式是否激活。此属性可用于进入/退出模式。进入/退出模式支持同步操作,因此write(2)到属性的调用将阻塞直到进入/退出模式操作完成。当模式进入/退出时,此属性会收到通知,因此对属性进行poll(2)会唤醒。进入/退出模式还将生成uevent KOBJ_CHANGE。

有效值为布尔值。

/sys/bus/typec/devices/.../description

定义在文件 sysfs-bus-typec

显示模式描述。描述对于驱动程序是可选的,就像Billboard设备一样。

/sys/bus/typec/devices/.../displayport/configuration

定义在文件 sysfs-driver-typec-displayport

显示连接器当前的DisplayPort配置。有效值为USB、源(source)和宿(sink)。源表示DisplayPort源,宿表示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标准定义。

  • 当HPD的逻辑状态为低(HPD_Low)时为0,此定义由

    VESA DisplayPort USB Type-C替代模式标准。

/sys/bus/typec/devices/.../displayport/pin_assignment

定义在文件 sysfs-driver-typec-displayport

VESA DisplayPort USB Type-C替代模式标准定义了USB Type-C连接器的六种不同引脚分配,标记为A、B、C、D、E和F。支持的引脚分配以空格分隔的列表形式列出,其中活动的分配用方括号括起来。

示例

C [D]

引脚分配可以通过写入文件来更改。可以在配置设置之前设置引脚分配,但该分配在连接器实际配置之前不会生效。

注意。截至VESA DisplayPort USB Type-C替代模式标准1.0b版本,引脚分配A、B和F已弃用。现在只有引脚分配D可以同时承载一个USB超高速协议通道。从用户角度来看,引脚分配C和E是相同的,连接器上的所有通道都用于承载DisplayPort协议(允许更高的分辨率)。

/sys/bus/typec/devices/.../mode

定义在文件 sysfs-bus-typec

由Discover Modes USB Power Delivery命令返回的模式索引号。根据替代模式的不同,模式索引可能具有重要意义。

对于某些替代模式(SVIDs),模式索引在该替代模式的规范中被分配用于特定功能。

对于其他替代模式,模式索引值未分配,因此不能用于识别。当模式索引未分配时,必须通过模式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位值,该值达到最大值后会归零。此文件支持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复位而不是两次)。

    旧的枚举方案也可以通过/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设备枚举之前和之后都生效。支持的值为“0”(如果U1和U2均不允许),“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且将支持USB 2.0 LPM的设备插入支持链路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

/sys/bus/usb/devices/.../power/usb3_hardware_lpm_u2

在文件sysfs-bus-usb中定义

如果设置了CONFIG_PM且将支持USB 3.0 LPM的设备插入支持链路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中定义

设备正在使用的接收通道数量。USB 3.2增加了双通道支持,通过Type-C支持2个接收和2个发送通道。芯片间SSIC设备支持每个方向最多4个不对称通道。USB 3.2之前的设备是单通道(rx_lanes = 1)。

/sys/bus/usb/devices/.../tx_lanes

在文件sysfs-bus-usb中定义

设备正在使用的发送通道数量。USB 3.2增加了双通道支持,通过Type-C支持2个接收和2个发送通道。芯片间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刷新率。

读取:返回可用刷新率列表(以赫兹表示),活动刷新率用方括号('['和']')括起来。

写入:接受在允许范围内以整数赫兹表示的新刷新率。

注意:由于设备每秒几乎只能完成2次完整刷新,因此只有当一两个瓷砖发生变化时调整此值才有意义,并且不适合期望应用程序以高于默认速率显式刷新其微小变化。

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/fn_lock

在文件sysfs-driver-hid-lenovo中定义

此设置控制键盘上的Fn Lock是否启用(即F1是静音还是F1)。

值为0或1

适用于带指点杆的ThinkPad Compact (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/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/kone/roccatkone<minor>/firmware_version

在文件sysfs-driver-hid-roccat-kone中定义

读取时,此文件返回鼠标报告的固件的原始整数版本号。使用整数值便于在其他程序中进一步使用。要获取实际版本号,小数点必须向左移动2位。例如,返回值为138表示1.38。

此文件是只读的。

用户

http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/kone/roccatkone<minor>/profile[1-5]

在文件sysfs-driver-hid-roccat-kone中定义

鼠标可以存储5个配置文件,这些配置文件可以通过按下一个按钮进行切换。配置文件包含按钮映射、灵敏度、5个LED的颜色和灯光效果等信息。

读取时,这些文件返回相应的配置文件。返回数据的大小为975字节。

写入时,此文件允许将相应的配置文件数据写回鼠标。数据必须为975字节长。

鼠标将拒绝无效数据,而存储在配置文件中的配置文件编号不需要与存储编号匹配。

用户

http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/kone/roccatkone<minor>/settings

在文件sysfs-driver-hid-roccat-kone中定义

读取时,此文件返回存储在鼠标中的设置。数据大小为36字节,包含startup_profile、tcu状态和calibration_data等信息。

写入时,此文件允许将设置写回鼠标。数据必须为36字节长。鼠标将拒绝无效数据。

用户

http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/kone/roccatkone<minor>/startup_profile

在文件sysfs-driver-hid-roccat-kone中定义

此属性的整数值范围从1到5。

读取时,此属性返回鼠标上电时激活的配置文件编号。

写入时,此文件设置启动配置文件的编号,并且鼠标会立即激活此配置文件。

用户

http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/kone/roccatkone<minor>/tcu

在文件sysfs-driver-hid-roccat-kone中定义

鼠标有一个“跟踪控制单元”(TCU),允许用户校准激光功率以适应鼠标垫表面。读取时,此文件返回TCU的当前状态,其中0表示关闭,1表示开启。

写入此文件0将关闭TCU。

写入此文件1将开始校准,校准大约需要6秒才能完成并激活TCU。

用户

http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/kone/roccatkone<minor>/weight

在文件sysfs-driver-hid-roccat-kone中定义

鼠标可以配备四个提供的重量之一,范围从5到20克,鼠标可以识别并读取其值。读取时,此文件返回鼠标返回的原始值,这便于在其他软件中进行进一步处理。

这些值与重量的映射如下

重量

0

1

5克

2

10克

3

15克

4

20克

此文件是只读的。

用户

http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/operation_mode

在文件sysfs-driver-hid-picolcd中定义

可以切换PicoLCD设备在LCD(固件)和引导加载程序(刷写器)操作模式之间。

读取:返回可用模式列表,活动模式用方括号('['和']')括起来。

写入:导致操作模式切换。允许的值是读取时列出的非活动模式名称。

注意:切换模式时,当前的PicoLCD HID设备会断开连接,并在上述延迟后重新连接(其值请参阅属性operation_mode_delay)。

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/operation_mode_delay

在文件sysfs-driver-hid-picolcd中定义

当operation_mode更改时,PicoLCD在新模式下重启前等待的延迟。

读取/写入:以毫秒表示,允许范围为0..30000毫秒。

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/press_speed

在文件sysfs-driver-hid-lenovo中定义

此设置控制如果启用press_to_select,指点杆需要按压多快才能生成鼠标点击。

值是十进制整数,从1(最慢)到255(最快)。

适用于带指点杆的Thinkpad USB键盘。

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/press_to_select

在文件sysfs-driver-hid-lenovo中定义

这控制如果快速按压指点杆是否应生成鼠标点击事件。按压的速度由press_speed控制。

值为0或1。

适用于带指点杆的Thinkpad USB键盘。

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/quirks

在文件sysfs-driver-hid-multitouch中定义

此属性的整数值对应于为处理设备协议而实际存在的特殊处理。读取时,此属性返回当前设置(参见hid-multitouch.c中的MT_QUIRKS_*)。写入时,此属性会动态更改特殊处理,然后是处理设备的协议。

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/release_to_select

在文件sysfs-driver-hid-lenovo中定义

有关此设置的详细信息,请参阅http://www.pc.ibm.com/ww/healthycomputing/trkpntb.html 值是0或1。适用于带指点杆的Thinkpad USB键盘。

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/report_descriptor

/sys/class/bluetooth/hci<addr>/<hid-bus>:<vendor-id>:<product-id>.<num>/report_descriptor

/sys/class/hidraw/hidraw<num>/device/report_descriptor

在文件sysfs-driver-hid中定义

读取时,此文件返回设备的原始二进制HID报告描述符。此文件不可写入。

用户

HIDAPI库(http://www.signal11.us/oss/hidapi

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/select_right

在文件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>/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设备通常只有一个配置设置,但有些设备支持多种配置。

此值显示当前配置,十进制。

更改其值将把设备的配置更改为另一个设置。

设备支持的配置数量在

/sys/bus/usb/devices/usbX/bNumConfigurations

有关其含义,请参阅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中定义

设备可能配置的数量,十进制。当前配置通过以下方式控制:

/sys/bus/usb/devices/usbX/bConfigurationValue

有关其含义,请参阅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中定义

显示接口的设备树Open Firmware节点。

/sys/bus/usb/devices/usbX/ep_<N>/bEndpointAddress

在文件sysfs-bus-usb中定义

此描述符所描述的端点地址,十六进制。此位图字段上的端点方向也显示在

/sys/bus/usb/devices/usbX/ep_<N>/direction

有关其含义,请参阅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中定义

适用于端点的属性,如其描述符中描述的,十六进制。此位图字段上的端点类型也显示在

/sys/bus/usb/devices/usbX/ep_<N>/type

有关其含义,请参阅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/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 写入此文件将尝试动态地将新的设备 ID 添加到 USB 设备驱动程序。这可能允许驱动程序支持比编译时包含在驱动程序静态设备 ID 支持表中的硬件更多的硬件。设备 ID 的格式为:idVendor idProduct bInterfaceClass RefIdVendor RefIdProduct。供应商 ID 和设备 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 中定义

(RW) 读取或写入 TH 和 TL(高温和低温)警报。值应以空格分隔,并在设备范围内(通常为 -55°C 至 125°C),否则值将被截断到设备最小/最大能力。值是整数,因为它们存储在设备中的 8 位寄存器中。最低值会自动设置为 TL。设置后,可以在主设备级别搜索警报,详细信息请参阅 1-wire (w1) 子系统简介

用户

任何希望与 w1_term 设备通信的用户空间应用程序

/sys/bus/w1/devices/.../conv_time

在文件 sysfs-driver-w1_therm 中定义

(RW) 获取、设置或测量温度转换时间。该设置保持活动状态,直到分辨率更改。然后,它将重置为新分辨率的默认(数据表)转换时间。

读取:

实际转换时间,单位为毫秒。

写入:
  • ‘0’

    设置数据表中的默认转换时间。

  • ‘1’

    测量并设置转换时间。执行一次温度转换,测量实际值。将其增加 20% 以适应温度范围。可以通过读取此同一属性来获取新的转换时间。

  • 其他正值

    设置转换时间,单位为毫秒。

用户

使用 w1_term 设备的应用程序

/sys/bus/w1/devices/.../eeprom_cmd

在文件 sysfs-driver-w1_therm 中定义

(WO) 写入此文件将触发将设备数据保存到其嵌入式 EEPROM,或恢复嵌入在设备 EEPROM 中的数据。请注意,设备支持有限的 EEPROM 写入周期(通常为 50k)

  • ‘save’:将设备 RAM 保存到 EEPROM

  • ‘restore’:在设备 RAM 中恢复 EEPROM 数据

用户

任何希望与 w1_term 设备通信的用户空间应用程序

/sys/bus/w1/devices/.../ext_power

在文件 sysfs-driver-w1_therm 中定义

(RO) 通过询问设备返回电源状态

  • ‘0’:设备寄生供电

  • ‘1’:设备外部供电

  • ‘-xx’:xx 是读取电源状态时的内核错误

用户

任何希望与 w1_term 设备通信的用户空间应用程序

/sys/bus/w1/devices/.../features

在文件 sysfs-driver-w1_therm 中定义

(RW) 控制可选驱动程序设置。用于读/写的位掩码(按位或)

1

启用转换成功检查。如果转换后暂存器内存的第 6 字节为 0xC,并且温度读数为 85.00(上电值)或 127.94(电源不足),则返回转换错误。

2

启用轮询以完成转换。转换开始后生成读取周期并等待 1。在寄生供电模式下,此功能不可用。

读取:

当前选定的功能。

写入:

选择功能。

用户

使用 w1_term 设备的应用程序

/sys/bus/w1/devices/.../resolution

在文件 sysfs-driver-w1_therm 中定义

(RW) 获取或设置设备分辨率(在支持的设备上,如果不支持,则此条目不存在)。请注意,分辨率只会更改设备 RAM 中的数据,因此断电后会清除。触发“保存”到 EEPROM 命令以在上电后保留值。读取或写入是

  • ‘9..14’:设备分辨率(比特)或要设置的分辨率(比特)

  • ‘-xx’:xx 是读取分辨率时的内核错误

  • 其他:不执行任何操作

一些 DS18B20 克隆固定为 12 位分辨率,因此实际分辨率会从芯片中读回并验证。如果结果不同,则报告错误。

用户

任何希望与 w1_term 设备通信的用户空间应用程序

/sys/bus/w1/devices/.../temperature

在文件 sysfs-driver-w1_therm 中定义

(RO) 返回温度,单位为 1/1000 摄氏度。

  • 如果已触发批量读取,则它将直接返回批量读取发生时计算的温度(如果可用)。如果尚不可用,则不返回任何内容(发送调试内核消息),您应该稍后重试。

  • 如果未触发批量读取,它将触发转换并发送结果。请注意,转换持续时间取决于分辨率(如果设备支持此功能)。9 位分辨率需要 94 毫秒,12 位需要 750 毫秒。

用户

任何希望与 w1_term 设备通信的用户空间应用程序

/sys/bus/w1/devices/.../w1_slave

在文件 sysfs-driver-w1_therm 中定义

(RW) 返回温度,单位为 1/1000 摄氏度。read:返回两行,其中包含总线上的十六进制输出数据,返回 CRC 校验和温度(单位为 1/1000 摄氏度)write

  • ‘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 中定义

(RW) 触发批量读取转换。读取状态

读取:
  • ‘-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 固件版本

/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 接口和内部 PLLs

/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 中定义

设备电源固件代码的版本。仅适用于 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 中定义

设备的预启动固件代码版本

/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 中定义

设备电压调节器监控固件代码的版本。不适用于 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: (RO) libata 因错误而决定降低链路速度的次数。

gscr: (RO) 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: (RO) 设备错误环的格式化输出。

id: (RO) IDENTIFY 命令的缓存结果,如 ATA8 7.16 和 7.17 所述。仅当设备不是 PM 时有效。

pio_mode: (RO) 设备使用的 PIO 传输模式。主要由 PATA 设备使用。

xfer_mode: (RO) 当前传输模式。主要由 PATA 设备使用。

dma_mode: (RO) 设备使用的 DMA 传输模式。

class: (RO) 设备类别。可以是磁盘的“ata”,数据包设备的“atapi”,PM 的“pmp”,或者如果链路上未找到设备则为“none”。

/sys/class/ata_device/devX[.Y].Z/trim

(RO) 显示设备当前使用的 DSM TRIM 模式。有效值为

unsupported: 驱动器不支持 DSM TRIM

unqueued: 驱动器仅支持非队列 DSM TRIM

queued: 驱动器支持队列 DSM TRIM

(RO) 显示设备当前使用的 DSM TRIM 模式。有效值为

forced_unqueued: 驱动器的队列 DSM 支持已知存在错误,且仅发送非队列 TRIM 命令

/sys/class/ata_link/linkX[.Y]/hw_sata_spd_limit

/sys/class/ata_link/linkX[.Y]/sata_spd_limit

在文件 sysfs-ata 中定义

/sys/class/ata_link/linkX[.Y]/sata_spd

hw_sata_spd_limit: (RO) 连接的 SATA 设备支持的最大速度。

sata_spd_limit: (RO) libata 施加的最大速度。

sata_spd: (RO) 链路的当前速度

例如 1.5、3 Gbps 等。

文件位于 /sys/class/ata_device 下

在文件 sysfs-ata 中定义

nr_pmp_links: (RO) 如果连接了 SATA 端口倍增器 (PM),则其后的链路数量。

idle_irq: (RO) 端口空闲时接收到的 IRQ 数量 [仅限某些 ata HBA]。

/sys/class/ata_port/ataX/port_no

(RO) 主机本地端口号。在注册主机控制器时,端口号会根据控制器上可用端口的数量进行跟踪。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 端口。

在文件 sysfs-ata 中定义

nr_pmp_links: (只读) 如果连接了 SATA 端口倍增器 (PM),则为其后的链接数量。

connected, the number of links behind it.

idle_irq: (只读) 端口在空闲时接收到的 IRQ 数量 [仅限某些 ATA HBA]。

idle [some ata HBA only].

/sys/class/ata_port/ataX/port_no

在文件 sysfs-ata 中定义

(只读) 主机本地端口号。在注册主机控制器时,端口号根据控制器上可用端口的数量进行跟踪。udev 需要此属性来在 /dev/disk/by-path 中生成持久链接。

Files under /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/<backlight>/<ambient light zone>_dim

在文件 sysfs-class-backlight 中定义

控制此 <backlight> 上 <ambient light zone> 的调光亮度。值介于 0 和 127 之间,通常设置为 0。当背光禁用时完全关闭。此文件还将显示为此 <ambient light zone> 存储的调光亮度级别。

<环境光区> 是设备驱动程序特定的

对于 ADP5520 和 ADP5501,<环境光区> 可以是

环境

sysfs 条目

光区

白天

/sys/class/backlight/<backlight>/daylight_dim

办公室

/sys/class/backlight/<backlight>/office_dim

黑暗

/sys/class/backlight/<backlight>/dark_dim

对于 ADP8860,<环境光区> 可以是

环境

sysfs 条目

光区

l1_daylight

/sys/class/backlight/<backlight>/l1_daylight_dim

l2_office

/sys/class/backlight/<backlight>/l2_office_dim

l3_dark

/sys/class/backlight/<backlight>/l3_dark_dim

对于 ADP8870,<环境光区> 可以是

环境

sysfs 条目

光区

l1_daylight

/sys/class/backlight/<backlight>/l1_daylight_dim

l2_bright

/sys/class/backlight/<backlight>/l2_bright_dim

l3_office

/sys/class/backlight/<backlight>/l3_office_dim

l4_indoor

/sys/class/backlight/<backlight>/l4_indoor_dim

l5_dark

/sys/class/backlight/<backlight>/l5_dark_dim

另请参阅:/sys/class/backlight/<backlight>/ambient_light_zone。

/sys/class/backlight/<backlight>/<ambient light zone>_max

在文件 sysfs-class-backlight 中定义

控制此 <backlight> 上 <ambient light zone> 的最大亮度。值介于 0 和 127 之间。此文件还将显示为此 <ambient light zone> 存储的亮度级别。

<环境光区> 是设备驱动程序特定的

对于 ADP5520 和 ADP5501,<环境光区> 可以是

环境

sysfs 条目

光区

白天

/sys/class/backlight/<backlight>/daylight_max

办公室

/sys/class/backlight/<backlight>/office_max

黑暗

/sys/class/backlight/<backlight>/dark_max

对于 ADP8860,<环境光区> 可以是

环境

sysfs 条目

光区

l1_daylight

/sys/class/backlight/<backlight>/l1_daylight_max

l2_office

/sys/class/backlight/<backlight>/l2_office_max

l3_dark

/sys/class/backlight/<backlight>/l3_dark_max

对于 ADP8870,<环境光区> 可以是

环境

sysfs 条目

光区

l1_daylight

/sys/class/backlight/<backlight>/l1_daylight_max

l2_bright

/sys/class/backlight/<backlight>/l2_bright_max

l3_office

/sys/class/backlight/<backlight>/l3_office_max

l4_indoor

/sys/class/backlight/<backlight>/l4_indoor_max

l5_dark

/sys/class/backlight/<backlight>/l5_dark_max

另请参阅:/sys/class/backlight/<backlight>/ambient_light_zone。

/sys/class/backlight/<backlight>/als_channel

在文件 sysfs-class-backlight-driver-lm3533 中定义

获取在 ALS-current-control 模式(0, 1)中用作输入的 ALS 输出通道,其中

0

out_current0(背光 0)

1

out_current1(背光 1)

/sys/class/backlight/<backlight>/als_en

在文件 sysfs-class-backlight-driver-lm3533 中定义

启用 ALS-current-control 模式 (0, 1)。

/sys/class/backlight/<backlight>/ambient_light_level

在文件 sysfs-class-backlight 中定义

(RO) 获取光传感器的转换值。

当光传感器启用时,该值每 80 毫秒自动更新一次。

值的范围因设备驱动程序而异

对于 ADP8870

它返回一个介于 0(暗)和 8000(最大环境亮度)之间的整数。

对于 ADP8860

它返回一个 13 位整数。

/sys/class/backlight/<backlight>/ambient_light_zone

在文件 sysfs-class-backlight 中定义

(RW) 读取或写入背光操作的特定亮度级别。

值的含义因设备驱动程序而异

对于 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/<backlight>/max_brightness 中的值写入 /sys/class/backlight/<backlight>/brightness 来启用它。

/sys/class/backlight/<backlight>/bled_mode

在文件 sysfs-class-backlight-lm3639 中定义

(WO) 写入背光映射模式。背光电流可以映射为指数(值“0”)或线性映射模式(默认)。

/sys/class/backlight/<backlight>/id

在文件 sysfs-class-backlight-driver-lm3533 中定义

获取此背光的 ID (0, 1)。

/sys/class/backlight/<backlight>/linear

在文件 sysfs-class-backlight-driver-lm3533 中定义

设置亮度映射模式 (0, 1),其中

0

指数模式

1

线性模式

/sys/class/backlight/<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/<backlight>/scale

在文件 sysfs-class-backlight 中定义

亮度曲线的尺度描述。

人眼对亮度的感知近似于对数关系,因此亮度的线性变化被感知为非线性。为了实现亮度的线性感知,滑块等控件需要对具有线性亮度曲线的背光应用对数映射。

属性的可能值是

未知

亮度曲线的尺度未知。

线性

亮度随每一步线性变化。亮度控件应应用对数映射以实现线性感知。

非线性

亮度随每一步非线性变化。亮度控件应使用线性映射以实现线性感知。

/sys/class/bdi/<bdi>/

在文件 sysfs-class-bdi 中定义

在 sysfs 中为 backing_dev_info 对象提供一个位置。这允许设置和检索各种 BDI 特定变量。

<bdi> 标识符可以是以下任一值

MAJOR:MINOR

块设备的设备号,或提供自己 BDI 的非块文件系统(如 NFS 和 FUSE)上的 st_dev 值。

MAJOR:MINOR-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 的检查。这在全局限制远高于给定相对较慢(或不可信)设备所能承受的程度时很有用。如果 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/chromeos/cros_ec/ap_mode_entry

定义于文件 sysfs-class-chromeos

显示是否支持 AP 模式入口 EC 功能。它指示 EC 是否等待 AP 的指令以进入 Type-C Alt 模式或 USB4 模式。

/sys/class/chromeos/cros_ec/usbpdmuxinfo

定义于文件 sysfs-class-chromeos

显示每个 Type-C 端口的 PD 复用器状态,具有以下标志:“USB”:USB 连接 - “DP”:DP 连接 - “POLARITY”:CC 线极性反转 - “HPD_IRQ”:热插拔检测中断断言 - “HPD_LVL”:热插拔检测级别断言 - “SAFE”:DP 处于安全模式 - “TBT”:TBT 已启用 - “USB4”:USB4 已启用

/sys/class/devfreq-event/event<x>/

定义于文件 sysfs-class-devfreq-event

在 sysfs 中为 devfreq-event 对象提供一个位置。这允许访问各种 devfreq-event 特定变量。devfreq-event 对象的名称表示为“event<x>”,其中“x”是每个 devfreq-event 对象的唯一编号。

/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_ondemand - 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

如果用户空间调频器生效,/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

一个可读取以获取属性类型的文件。此属性是强制性的。

以下是已知类型

  • enumeration:一组预定义的有效值

  • integer:一个数值范围

  • string

HP 特定类型

  • ordered-list - 一组有序的有效值列表

所有属性类型都支持以下值

current_value(当前值)

一个可读取以获取 <attr> 当前值的文件。

此文件也可以写入以更新 <attr> 的值

此属性是强制性的。

default_value(默认值)

一个可读取以获取 <attr> 默认值的文件

display_name(显示名称)

一个可读取以获取 <attr> 的用户友好描述的文件

display_name_language_code(显示名称语言代码)

一个可读取以获取与 <attr> 的“display_name”对应的 IETF 语言标签的文件

“enumeration”类型特定属性

possible_values(可能值)

一个可读取以获取 <attr> 可能值的文件。值之间使用分号 (;) 分隔。

“integer”类型特定属性

min_value(最小值)

一个可读取以获取 <attr> 下限值的文件

max_value(最大值)

一个可读取以获取 <attr> 上限值的文件

scalar_increment(标量增量)

一个可读取以获取此属性接受的 current_value 增量所使用的标量值的文件。

“string”类型特定属性

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 系统上,以下附加属性可用

“ordered-list”类型特定属性

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. 在设置任何属性之前,检查它是否有任何修饰符或值修饰符。如果存在,请合并它们,然后修改属性。

当此值更改时,驱动程序可能会发出 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 管理员)

表示 BIOS 管理员密码

power-on(开机)

表示使用系统所需的密码

system-mgmt(系统管理)

表示系统管理密码。有关详细信息,请参阅联想扩展部分

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,用户空间可以再次检查。

在 Dell、联想和 HP 系统上,如果设置了管理员密码,则所有 BIOS 属性都需要密码验证。在联想系统上,如果您更改管理员密码,新密码直到下次启动时才会生效。

联想特定类扩展

在联想系统上,以下附加设置可用

role: system-mgmt 这赋予与 bios-admin 密码相同的权限来控制

安全相关功能。分配的权限可以通过 BIOS 菜单 SMP 访问控制策略进行设置

role: HDD & NVMe 此密码用于在启动时解锁对驱动器的访问。注意,请参阅

下面的“level”和“index”扩展。

lenovo_encoding(联想编码)

使用的编码方法。可以是“ascii”或“scancode”。默认设置为“ascii”

lenovo_kbdlang(联想键盘语言)

使用的键盘语言方法。这通常是两位字符代码(例如“us”、“fr”、“gr”),并且可能因平台而异。默认设置为“us”

level(级别)

适用于 HDD 和 NVMe 身份验证,用于设置“user”或“master”权限级别。如果只配置了用户密码,则应使用此密码在启动时解锁驱动器。如果同时设置了主密码和用户密码,则可以使用其中任何一个。如果设置了主密码,则需要用户密码。此属性默认为“user”级别

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 管理员身份验证方法,从而允许任何人进行更改。在执行任何这些操作后,系统必须重新启动才能使更改生效。管理员和系统证书从 2025 年的系统开始支持。

certificate_thumbprint

只读属性,用于显示 BIOS 中安装证书的 MD5、SHA1 和 SHA256 指纹。

certificate_to_password

只写属性,用于从基于证书的身份验证切换回基于密码的身份验证。用法:

echo "signature" > authentication/Admin/signature
echo "password" > authentication/Admin/certificate_to_password

HP 特定类扩展

在 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”: “主版本号.次版本号”, “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”。error sysfs 文件仅在当前固件上传状态为“idle”时才有效。如果在固件传输正在进行时读取此文件,则读取将因 EBUSY 而失败。

/sys/class/firmware/.../loading

定义于文件 sysfs-class-firmware

loading sysfs 文件用于固件回退和固件上传。向 loading 文件回显 1 以指示您正在向 data sysfs 节点写入固件文件。向此文件回显 -1 以中止数据写入,或回显 0 以指示写入完成。对于固件上传,零值也会触发将固件数据传输到下层设备驱动程序。

/sys/class/firmware/.../remaining_size

定义于文件 sysfs-class-firmware

只读。对于固件上传,此文件包含剩余待传输到下层设备驱动程序的固件数据大小。大小值初始化为先前写入 data sysfs 文件的固件映像的完整大小。此值在固件上传的“transferring”阶段定期更新。格式:“%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 编程错误信息。这是受支持状态的字符串列表。

  • 重新配置操作错误 - 检测到无效操作

    重新配置硬件。例如,在未清除错误的情况下开始重新配置

  • 重新配置 CRC 错误 - 检测到 CRC 错误

    重新配置硬件。

  • 重新配置不兼容映像 - 重新配置映像

    与硬件不兼容

  • 重新配置 IP 协议错误 - 检测到协议错误

    重新配置硬件

  • /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

卡的基准时钟频率。

识别当前活动的卡应用程序,例如用于压缩/解压缩的“GZIP”。

/sys/class/genwqe/genwqe<n>_card/curr_bitstream

当前活动的比特流。1 为默认,0 为备份。

识别当前活动的卡应用程序,例如用于压缩/解压缩的“GZIP”。

/sys/class/genwqe/genwqe<n>_card/device/sriov_numvfs

启用 VF(1..15)

识别当前活动的卡应用程序,例如用于压缩/解压缩的“GZIP”。

禁用 VF

sudo sh -c 'echo 15 > \
  /sys/bus/pci/devices/0000\:1b\:00.0/sriov_numvfs'

/sys/class/genwqe/genwqe<n>_card/freerunning_timer

Write a 0 into the same sysfs entry.

读取卡自由运行计时器的接口。用于性能和利用率测量。

识别当前活动的卡应用程序,例如用于压缩/解压缩的“GZIP”。

/sys/class/genwqe/genwqe<n>_card/next_bitstream

设置要使用的下一个比特流的接口。

识别当前活动的卡应用程序,例如用于压缩/解压缩的“GZIP”。

/sys/class/genwqe/genwqe<n>_card/queue_working_time

读取队列工作时间的接口。用于性能和利用率测量。

识别当前活动的卡应用程序,例如用于压缩/解压缩的“GZIP”。

/sys/class/genwqe/genwqe<n>_card/reload_bitstream

触发 PCIe 卡重置以重新加载比特流的接口。

识别当前活动的卡应用程序,例如用于压缩/解压缩的“GZIP”。

如果成功,卡将使用在“next_bitstream”上设置的比特流重新启动。

sudo sh -c 'echo 1 > \
  /sys/class/genwqe/genwqe0_card/reload_bitstream'

/sys/class/genwqe/genwqe<n>_card/state

卡的状态:“unused”、“used”、“error”。

识别当前活动的卡应用程序,例如用于压缩/解压缩的“GZIP”。

/sys/class/genwqe/genwqe<n>_card/tempsens

读取卡温度感应寄存器的接口。

识别当前活动的卡应用程序,例如用于压缩/解压缩的“GZIP”。

/sys/class/genwqe/genwqe<n>_card/type

卡的类型,例如“GenWQE5-A7”。

识别当前活动的卡应用程序,例如用于压缩/解压缩的“GZIP”。

/sys/class/genwqe/genwqe<n>_card/version

唯一的比特流标识,例如“0000000330336283.00000000475a4950”。

识别当前活动的卡应用程序,例如用于压缩/解压缩的“GZIP”。

/sys/class/gnss/gnss<N>/type

定义于文件 sysfs-class-gnss

GNSS 接收器类型。当前识别的类型反映了接收器支持的协议

“NMEA”

NMEA 0183

“SiRF”

SiRF Binary

“UBX”

UBX

请注意,非“NMEA”类型接收器通常也支持 NMEA 0183 的子集以及供应商扩展(例如,允许切换到供应商协议)。

/sys/class/hwmon/hwmonX/cpuY_vid

定义于文件 sysfs-class-hwmon

CPU 核心参考电压。

单位:毫伏

只读

并非总是正确。

/sys/class/hwmon/hwmonX/currY_average

平均电流使用

CPU 核心参考电压。

单位:毫安

/sys/class/hwmon/hwmonX/currY_crit

并非总是正确。

电流临界高值。

CPU 核心参考电压。

读写

/sys/class/hwmon/hwmonX/currY_crit

/sys/class/hwmon/hwmonX/currY_enable

启用或禁用传感器。

CPU 核心参考电压。

禁用时,传感器读取将返回 -ENODATA。

1:启用

  • 0:禁用

  • /sys/class/hwmon/hwmonX/currY_highest

/sys/class/hwmon/hwmonX/currY_enable

历史最大电流。单位:毫安。只读。

CPU 核心参考电压。

/sys/class/hwmon/hwmonX/currY_input

电流输入值

CPU 核心参考电压。

/sys/class/hwmon/hwmonX/currY_lcrit

/sys/class/hwmon/hwmonX/currY_crit

并非总是正确。

电流临界低值

CPU 核心参考电压。

/sys/class/hwmon/hwmonX/currY_lowest

/sys/class/hwmon/hwmonX/currY_crit

/sys/class/hwmon/hwmonX/currY_enable

历史最小电流

CPU 核心参考电压。

/sys/class/hwmon/hwmonX/currY_max

/sys/class/hwmon/hwmonX/currY_crit

并非总是正确。

电流最大值

CPU 核心参考电压。

/sys/class/hwmon/hwmonX/currY_min

/sys/class/hwmon/hwmonX/currY_crit

/sys/class/hwmon/hwmonX/currY_enable

电流最小值。

CPU 核心参考电压。

/sys/class/hwmon/hwmonX/currY_rated_max

/sys/class/hwmon/hwmonX/currY_crit

/sys/class/hwmon/hwmonX/currY_enable

最大额定电流。

CPU 核心参考电压。

/sys/class/hwmon/hwmonX/currY_rated_min

/sys/class/hwmon/hwmonX/currY_crit

并非总是正确。

最小额定电流。

CPU 核心参考电压。

/sys/class/hwmon/hwmonX/currY_reset_history

/sys/class/hwmon/hwmonX/currY_crit

并非总是正确。

重置 currX_lowest 和 currX_highest

CPU 核心参考电压。

只写

/sys/class/hwmon/hwmonX/curr_reset_history

重置所有传感器的 currX_lowest 和 currX_highest

CPU 核心参考电压。

/sys/class/hwmon/hwmonX/device/pec

/sys/class/hwmon/hwmonX/curr_reset_history

I2C 设备上的 PEC 支持

CPU 核心参考电压。

0、off、n:禁用

  • 1、on、y:启用

  • /sys/class/hwmon/hwmonX/energyY_enable

/sys/class/hwmon/hwmonX/currY_enable

/sys/class/hwmon/hwmonX/energyY_input

CPU 核心参考电压。

禁用时,传感器读取将返回 -ENODATA。

1:启用

  • 0:禁用

  • /sys/class/hwmon/hwmonX/currY_highest

/sys/class/hwmon/hwmonX/currY_enable

累计能量使用

CPU 核心参考电压。

单位:微焦耳

/sys/class/hwmon/hwmonX/fanY_boost

并非总是正确。

定义于文件 sysfs-platform-alienware-wmi

此文件公开了戴尔游戏笔记本电脑通过 AWCC WMI 接口进行风扇加速控制的功能。

有关详细信息,请参阅 Alienware WMI 驱动程序

0 到 255 范围内的整数值

/sys/class/hwmon/hwmonX/fanY_div

/sys/class/hwmon/hwmonX/currY_enable

风扇分频器。

CPU 核心参考电压。

2 的幂次方整数值(1、2、4、8、16、32、64、128)。

某些芯片仅支持 1、2、4 和 8。请注意,这实际上是一个内部时钟分频器,它影响可测量的速度范围,而不是读取值。

/sys/class/hwmon/hwmonX/currY_enable

/sys/class/hwmon/hwmonX/fanY_enable

/sys/class/hwmon/hwmonX/fanY_fault

CPU 核心参考电压。

禁用时,传感器读取将返回 -ENODATA。

1:启用

  • 0:禁用

  • /sys/class/hwmon/hwmonX/currY_highest

/sys/class/hwmon/hwmonX/currY_enable

报告风扇是否已报告故障。

CPU 核心参考电压。

1:故障

  • 0:正常

  • /sys/class/hwmon/hwmonX/fanY_input

并非总是正确。

风扇输入值。

CPU 核心参考电压。

单位:转/分钟 (RPM)

/sys/class/hwmon/hwmonX/fanY_label

并非总是正确。

建议的风扇通道标签。

CPU 核心参考电压。

文本字符串

仅当驱动程序对风扇通道的用途有提示而用户空间没有时,才应创建此标签。在所有其他情况下,标签由用户空间提供。

/sys/class/hwmon/hwmonX/fanY_max

并非总是正确。

风扇最大值

CPU 核心参考电压。

硬件很少支持。读写。

/sys/class/hwmon/hwmonX/fanY_label

/sys/class/hwmon/hwmonX/fanY_min

风扇最小值

CPU 核心参考电压。

/sys/class/hwmon/hwmonX/fanY_pulses

/sys/class/hwmon/hwmonX/fanY_label

/sys/class/hwmon/hwmonX/currY_enable

每风扇转数对应的转速计脉冲数。

CPU 核心参考电压。

整数值,通常介于 1 到 4 之间。

此值是连接到设备输入的风扇的特性,因此必须根据风扇型号进行设置。

/sys/class/hwmon/hwmonX/currY_enable

仅当芯片具有配置脉冲数的寄存器时,才应创建此项。如果没有此类寄存器(因此也没有此属性),则所有设备默认值为每风扇转数 2 个脉冲。

/sys/class/hwmon/hwmonX/fanY_target

期望的风扇速度

CPU 核心参考电压。

仅当芯片支持基于测得的风扇速度的闭环风扇速度控制时,才有意义。

/sys/class/hwmon/hwmonX/fanY_label

/sys/class/hwmon/hwmonX/currY_enable

/sys/class/hwmon/hwmonX/humidityY_alarm

湿度限制检测

CPU 核心参考电压。

0:正常

  • 1:已达到湿度限制

  • /sys/class/hwmon/hwmonX/humidityY_enable

并非总是正确。

启用或禁用传感器

CPU 核心参考电压。

/sys/class/hwmon/hwmonX/humidityY_fault

1:启用

  • 0:禁用

  • /sys/class/hwmon/hwmonX/currY_highest

/sys/class/hwmon/hwmonX/currY_enable

报告湿度传感器故障。

CPU 核心参考电压。

/sys/class/hwmon/hwmonX/humidityY_input

  • 0:正常

  • /sys/class/hwmon/hwmonX/fanY_input

并非总是正确。

湿度

CPU 核心参考电压。

单位:千分之(千分之,pcm)

/sys/class/hwmon/hwmonX/humidityY_label

并非总是正确。

建议的湿度通道标签。

CPU 核心参考电压。

仅当驱动程序对湿度通道的用途有提示而用户空间没有时,才应创建此标签。在所有其他情况下,标签由用户空间提供。

仅当驱动程序对风扇通道的用途有提示而用户空间没有时,才应创建此标签。在所有其他情况下,标签由用户空间提供。

/sys/class/hwmon/hwmonX/humidityY_max

并非总是正确。

湿度最大值。

CPU 核心参考电压。

/sys/class/hwmon/hwmonX/humidityY_max_alarm

/sys/class/hwmon/hwmonX/humidityY_label

/sys/class/hwmon/hwmonX/currY_enable

最大湿度检测

CPU 核心参考电压。

1:检测到最大湿度

  • 1:已达到湿度限制

  • /sys/class/hwmon/hwmonX/humidityY_max_hyst

并非总是正确。

最大限制的湿度滞后值。

CPU 核心参考电压。

必须报告为绝对湿度,而不是与最大值的差值。

/sys/class/hwmon/hwmonX/humidityY_label

/sys/class/hwmon/hwmonX/humidityY_min

/sys/class/hwmon/hwmonX/currY_enable

湿度最小值。

CPU 核心参考电压。

/sys/class/hwmon/hwmonX/humidityY_min_alarm

/sys/class/hwmon/hwmonX/humidityY_label

/sys/class/hwmon/hwmonX/currY_enable

最小湿度检测

CPU 核心参考电压。

1:检测到最小湿度

  • 1:已达到湿度限制

  • /sys/class/hwmon/hwmonX/humidityY_min_hyst

并非总是正确。

最小限制的湿度滞后值。

CPU 核心参考电压。

必须报告为绝对湿度,而不是与最小值的差值。

/sys/class/hwmon/hwmonX/humidityY_label

/sys/class/hwmon/hwmonX/humidityY_rated_max

/sys/class/hwmon/hwmonX/currY_enable

最大额定湿度。

CPU 核心参考电压。

/sys/class/hwmon/hwmonX/humidityY_rated_min

/sys/class/hwmon/hwmonX/humidityY_label

并非总是正确。

最小额定湿度。

CPU 核心参考电压。

/sys/class/hwmon/hwmonX/inY_average

/sys/class/hwmon/hwmonX/humidityY_label

并非总是正确。

平均电压

CPU 核心参考电压。

/sys/class/hwmon/hwmonX/inY_crit

只读

并非总是正确。

电压临界最大值。

CPU 核心参考电压。

如果电压达到或超过此限制,系统可能会采取断电或重置等激烈措施。至少,它应该报告故障。

只读

/sys/class/hwmon/hwmonX/currY_enable

/sys/class/hwmon/hwmonX/inY_enable

/sys/class/hwmon/hwmonX/inY_fault

CPU 核心参考电压。

禁用时,传感器读取将返回 -ENODATA。

1:启用

  • 0:禁用

  • /sys/class/hwmon/hwmonX/currY_highest

/sys/class/hwmon/hwmonX/currY_enable

报告电压硬故障(例如:元件短路)

CPU 核心参考电压。

/sys/class/hwmon/hwmonX/inY_highest

  • 0:正常

  • /sys/class/hwmon/hwmonX/fanY_input

并非总是正确。

历史最大电压

CPU 核心参考电压。

/sys/class/hwmon/hwmonX/inY_input

只读

并非总是正确。

电压输入值。

CPU 核心参考电压。

芯片引脚上测得的电压。

只读

并非总是正确。

实际电压取决于主板上的分压电阻,如芯片数据手册中所建议。

这因芯片和主板而异。由于这种差异,值通常不由芯片驱动程序进行缩放,而必须由应用程序完成。然而,一些驱动程序(特别是 lm87 和 via686a)会进行缩放,因为芯片内部内置了电阻。这些驱动程序将输出实际电压。经验法则:驱动程序应报告芯片“引脚”处的电压值。

/sys/class/hwmon/hwmonX/inY_label

建议的电压通道标签。

CPU 核心参考电压。

仅当驱动程序对电压通道的用途有提示而用户空间没有时,才应创建此标签。在所有其他情况下,标签由用户空间提供。

仅当驱动程序对风扇通道的用途有提示而用户空间没有时,才应创建此标签。在所有其他情况下,标签由用户空间提供。

/sys/class/hwmon/hwmonX/inY_lcrit

并非总是正确。

电压临界最小值。

CPU 核心参考电压。

如果电压降至或低于此限制,系统可能会采取断电或重置等激烈措施。至少,它应该报告故障。

只读

/sys/class/hwmon/hwmonX/currY_enable

/sys/class/hwmon/hwmonX/inY_lowest

历史最小电压

CPU 核心参考电压。

/sys/class/hwmon/hwmonX/inY_max

只读

并非总是正确。

电压最大值。

CPU 核心参考电压。

/sys/class/hwmon/hwmonX/inY_min

只读

/sys/class/hwmon/hwmonX/currY_enable

电压最小值。

CPU 核心参考电压。

/sys/class/hwmon/hwmonX/inY_rated_max

只读

/sys/class/hwmon/hwmonX/currY_enable

最大额定电压。

CPU 核心参考电压。

/sys/class/hwmon/hwmonX/inY_rated_min

只读

并非总是正确。

最小额定电压。

CPU 核心参考电压。

/sys/class/hwmon/hwmonX/inY_reset_history

只读

并非总是正确。

重置 inX_lowest 和 inX_highest

CPU 核心参考电压。

/sys/class/hwmon/hwmonX/in_reset_history

/sys/class/hwmon/hwmonX/curr_reset_history

重置所有传感器的 inX_lowest 和 inX_highest

CPU 核心参考电压。

/sys/class/hwmon/hwmonX/intrusionY_alarm

/sys/class/hwmon/hwmonX/curr_reset_history

机箱入侵检测

CPU 核心参考电压。

1:检测到入侵

  • 1:已达到湿度限制

  • 与读取时自动清除的常规警报标志不同,此标志会一直保留,直到用户清除。通过向文件写入 0 来完成此操作。不支持写入其他值。

/sys/class/hwmon/hwmonX/currY_enable

/sys/class/hwmon/hwmonX/intrusionY_beep

机箱入侵蜂鸣声

CPU 核心参考电压。

0:禁用

  • 1:启用

  • /sys/class/hwmon/hwmonX/label

/sys/class/hwmon/hwmonX/currY_enable

一个描述性标签,用于在系统中唯一标识设备。标签内容是自由形式的。

CPU 核心参考电压。

/sys/class/hwmon/hwmonX/name

并非总是正确。

芯片名称。这应该是一个简短的小写字符串,不包含空格、连字符或通配符“*”。此属性表示芯片名称。它是唯一强制属性。I2C 设备会自动创建此属性。

CPU 核心参考电压。

/sys/class/hwmon/hwmonX/powerY_accuracy

并非总是正确。

功率计的精度。

CPU 核心参考电压。

单位:百分比

/sys/class/hwmon/hwmonX/powerY_average

并非总是正确。

平均功率使用

CPU 核心参考电压。

单位:微瓦

/sys/class/hwmon/hwmonX/powerY_average_highest

并非总是正确。

历史平均最大功率使用

CPU 核心参考电压。

/sys/class/hwmon/hwmonX/powerY_average_interval

/sys/class/hwmon/hwmonX/powerY_average_highest

并非总是正确。

功率使用平均间隔。如果硬件更改平均间隔,则会向此文件发送轮询通知。

CPU 核心参考电压。

单位:毫秒

/sys/class/hwmon/hwmonX/powerY_average_interval_max

/sys/class/hwmon/hwmonX/currY_enable

最大功率使用平均间隔

CPU 核心参考电压。

/sys/class/hwmon/hwmonX/powerY_average_interval_min

/sys/class/hwmon/hwmonX/powerY_average_interval_max

并非总是正确。

最小功率使用平均间隔

CPU 核心参考电压。

/sys/class/hwmon/hwmonX/powerY_average_lowest

/sys/class/hwmon/hwmonX/powerY_average_interval_max

并非总是正确。

历史平均最小功率使用

CPU 核心参考电压。

/sys/class/hwmon/hwmonX/powerY_average_max

/sys/class/hwmon/hwmonX/powerY_average_highest

并非总是正确。

当功率使用量超过此值时,会向 powerY_average 发送轮询通知。

CPU 核心参考电压。

/sys/class/hwmon/hwmonX/powerY_average_min

/sys/class/hwmon/hwmonX/powerY_average_highest

/sys/class/hwmon/hwmonX/currY_enable

当功率使用量低于此值时,会向 powerY_average 发送轮询通知。

CPU 核心参考电压。

/sys/class/hwmon/hwmonX/powerY_cap

/sys/class/hwmon/hwmonX/powerY_average_highest

/sys/class/hwmon/hwmonX/currY_enable

如果功率使用量超过此限制,系统应采取措施降低功率使用量。如果硬件更改了上限,则会向此文件发送轮询通知。*_cap 文件仅在已知上限由硬件强制执行时才会出现。

CPU 核心参考电压。

/sys/class/hwmon/hwmonX/powerY_cap_hyst

/sys/class/hwmon/hwmonX/powerY_average_highest

/sys/class/hwmon/hwmonX/currY_enable

围绕限制和通知建立的滞后裕度。

CPU 核心参考电压。

/sys/class/hwmon/hwmonX/powerY_cap_max

/sys/class/hwmon/hwmonX/powerY_average_highest

/sys/class/hwmon/hwmonX/currY_enable

可以设置的最大上限。

CPU 核心参考电压。

/sys/class/hwmon/hwmonX/powerY_cap_min

/sys/class/hwmon/hwmonX/powerY_average_highest

并非总是正确。

可以设置的最小上限。

CPU 核心参考电压。

/sys/class/hwmon/hwmonX/powerY_crit

/sys/class/hwmon/hwmonX/powerY_average_highest

并非总是正确。

临界最大功率。

CPU 核心参考电压。

如果功率达到或超过此限制,系统预计将采取严厉措施降低功耗,例如系统关机或强制关闭某些设备。

/sys/class/hwmon/hwmonX/powerY_enable

/sys/class/hwmon/hwmonX/powerY_average_highest

/sys/class/hwmon/hwmonX/currY_enable

/sys/class/hwmon/hwmonX/powerY_input

CPU 核心参考电压。

禁用时,传感器读取将返回 -ENODATA。

1:启用

  • 0:禁用

  • /sys/class/hwmon/hwmonX/currY_highest

/sys/class/hwmon/hwmonX/currY_enable

瞬时功率使用

CPU 核心参考电压。

/sys/class/hwmon/hwmonX/powerY_input_highest

/sys/class/hwmon/hwmonX/powerY_average_highest

并非总是正确。

历史最大功率使用

CPU 核心参考电压。

/sys/class/hwmon/hwmonX/powerY_input_lowest

/sys/class/hwmon/hwmonX/powerY_average_highest

并非总是正确。

历史最小功率使用

CPU 核心参考电压。

/sys/class/hwmon/hwmonX/powerY_max

/sys/class/hwmon/hwmonX/powerY_average_highest

并非总是正确。

最大功率。

CPU 核心参考电压。

/sys/class/hwmon/hwmonX/powerY_rated_max

/sys/class/hwmon/hwmonX/powerY_average_highest

/sys/class/hwmon/hwmonX/currY_enable

最大额定功率。

CPU 核心参考电压。

/sys/class/hwmon/hwmonX/powerY_rated_min

/sys/class/hwmon/hwmonX/powerY_average_highest

并非总是正确。

最小额定功率。

CPU 核心参考电压。

/sys/class/hwmon/hwmonX/powerY_reset_history

/sys/class/hwmon/hwmonX/powerY_average_highest

并非总是正确。

重置 input_highest、input_lowest、average_highest 和 average_lowest。

CPU 核心参考电压。

/sys/class/hwmon/hwmonX/pwmY

/sys/class/hwmon/hwmonX/curr_reset_history

脉宽调制风扇控制。

CPU 核心参考电压。

255 为最大值或 100%。

/sys/class/hwmon/hwmonX/fanY_div

/sys/class/hwmon/hwmonX/currY_enable

/sys/class/hwmon/hwmonX/pwmY_auto_channels_temp

在自动模式下选择哪些温度通道影响此 PWM 输出。

CPU 核心参考电压。

位域,1 是 temp1,2 是 temp2,4 是 temp3 等... 可能的值取决于所使用的芯片。

/sys/class/hwmon/hwmonX/pwmY_auto_pointZ_pwm

/sys/class/hwmon/hwmonX/currY_enable

/sys/class/hwmon/hwmonX/pwmY_auto_pointZ_temp

/sys/class/hwmon/hwmonX/pwmY_auto_pointZ_temp_hyst

定义 PWM 与温度曲线。

CPU 核心参考电压。

跳闸点数量取决于芯片。将其用于将跳闸点与 PWM 输出通道关联的芯片。

/sys/class/hwmon/hwmonX/pwmY_enable

/sys/class/hwmon/hwmonX/currY_enable

风扇速度控制方法

CPU 核心参考电压。

0:无风扇速度控制(即风扇全速运行)

  • 1:启用手动风扇速度控制(使用 pwmY

  • 2+:启用自动风扇速度控制

  • 有关自动模式的详细信息,请查阅各个芯片的文档文件。

/sys/class/hwmon/hwmonX/pwmY_freq

/sys/class/hwmon/hwmonX/currY_enable

基本 PWM 频率,单位赫兹。

CPU 核心参考电压。

仅当 pwmN_mode 为 PWM 时可能可用,但即使在这种情况下也并非总是存在。

/sys/class/hwmon/hwmonX/pwmY_mode

/sys/class/hwmon/hwmonX/currY_enable

0:直流模式(direct current)

CPU 核心参考电压。

  • 1:PWM 模式(脉宽调制)

  • /sys/class/hwmon/hwmonX/tempY_auto_pointZ_pwm

/sys/class/hwmon/hwmonX/currY_enable

/sys/class/hwmon/hwmonX/tempY_auto_pointZ_temp

/sys/class/hwmon/hwmonX/tempY_auto_pointZ_temp_hyst

跳闸点数量取决于芯片。将其用于将跳闸点与温度通道关联的芯片。

CPU 核心参考电压。

跳闸点数量取决于芯片。将其用于将跳闸点与 PWM 输出通道关联的芯片。

/sys/class/hwmon/hwmonX/tempY_crit

/sys/class/hwmon/hwmonX/currY_enable

温度临界最大值,通常大于相应的 temp_max 值。

CPU 核心参考电压。

单位:毫摄氏度

/sys/class/hwmon/hwmonX/tempY_crit_alarm

/sys/class/hwmon/hwmonX/currY_enable

临界高温警报标志。

CPU 核心参考电压。

1:温度已达到 tempY_crit

  • 1:已达到湿度限制

  • /sys/class/hwmon/hwmonX/tempY_crit_hyst

并非总是正确。

临界限值的温度滞后值。

CPU 核心参考电压。

必须报告为绝对温度,而不是与临界值的差值。

/sys/class/hwmon/hwmonX/tempY_crit_alarm

/sys/class/hwmon/hwmonX/tempY_emergency

/sys/class/hwmon/hwmonX/currY_enable

温度紧急最大值,适用于支持两个以上上限温度的芯片。必须等于或大于相应的 temp_crit 值。

CPU 核心参考电压。

/sys/class/hwmon/hwmonX/tempY_emergency_alarm

/sys/class/hwmon/hwmonX/tempY_crit_alarm

/sys/class/hwmon/hwmonX/currY_enable

紧急高温警报标志。

CPU 核心参考电压。

1:温度已达到 tempY_emergency

  • 1:已达到湿度限制

  • /sys/class/hwmon/hwmonX/tempY_emergency_hyst

并非总是正确。

紧急限值的温度滞后值。

CPU 核心参考电压。

必须报告为绝对温度,而不是与紧急值的差值。

/sys/class/hwmon/hwmonX/tempY_crit_alarm

/sys/class/hwmon/hwmonX/tempY_enable

/sys/class/hwmon/hwmonX/currY_enable

/sys/class/hwmon/hwmonX/tempY_highest

CPU 核心参考电压。

禁用时,传感器读取将返回 -ENODATA。

1:启用

  • 0:禁用

  • /sys/class/hwmon/hwmonX/currY_highest

/sys/class/hwmon/hwmonX/currY_enable

历史最高温度

CPU 核心参考电压。

/sys/class/hwmon/hwmonX/tempY_input

/sys/class/hwmon/hwmonX/tempY_crit_alarm

并非总是正确。

温度输入值。

CPU 核心参考电压。

/sys/class/hwmon/hwmonX/tempY_label

/sys/class/hwmon/hwmonX/tempY_crit_alarm

并非总是正确。

建议的温度通道标签。

CPU 核心参考电压。

仅当驱动程序对温度通道的用途有提示而用户空间没有时,才应创建此标签。在所有其他情况下,标签由用户空间提供。

仅当驱动程序对风扇通道的用途有提示而用户空间没有时,才应创建此标签。在所有其他情况下,标签由用户空间提供。

/sys/class/hwmon/hwmonX/tempY_lcrit

并非总是正确。

温度临界最小值,通常低于相应的 temp_min 值。

CPU 核心参考电压。

/sys/class/hwmon/hwmonX/tempY_lcrit_hyst

/sys/class/hwmon/hwmonX/tempY_crit_alarm

/sys/class/hwmon/hwmonX/currY_enable

临界最小限值的温度滞后值。

CPU 核心参考电压。

必须报告为绝对温度,而不是与临界最小值的差值。

/sys/class/hwmon/hwmonX/tempY_crit_alarm

/sys/class/hwmon/hwmonX/tempY_lowest

/sys/class/hwmon/hwmonX/currY_enable

历史最低温度

CPU 核心参考电压。

/sys/class/hwmon/hwmonX/tempY_max

/sys/class/hwmon/hwmonX/tempY_crit_alarm

并非总是正确。

温度最大值。

CPU 核心参考电压。

单位:毫摄氏度(或毫伏,见下文)

/sys/class/hwmon/hwmonX/tempY_max_alarm

/sys/class/hwmon/hwmonX/currY_enable

最高温度警报标志。

CPU 核心参考电压。

1:温度已达到 tempY_max

  • 1:已达到湿度限制

  • /sys/class/hwmon/hwmonX/tempY_max_hyst

并非总是正确。

最大限制的温度滞后值。

CPU 核心参考电压。

必须报告为绝对温度,而不是与最大值的差值。

/sys/class/hwmon/hwmonX/tempY_crit_alarm

/sys/class/hwmon/hwmonX/tempY_min

/sys/class/hwmon/hwmonX/currY_enable

温度最小值。

CPU 核心参考电压。

/sys/class/hwmon/hwmonX/tempY_min_alarm

/sys/class/hwmon/hwmonX/tempY_crit_alarm

/sys/class/hwmon/hwmonX/currY_enable

最低温度警报标志。

CPU 核心参考电压。

1:温度已达到 tempY_min

  • 1:已达到湿度限制

  • /sys/class/hwmon/hwmonX/tempY_min_hyst

并非总是正确。

最小限制的温度滞后值。单位:毫摄氏度。

CPU 核心参考电压。

必须报告为绝对温度,而不是与最小值的差值。

/sys/class/hwmon/hwmonX/tempY_offset

/sys/class/hwmon/hwmonX/currY_enable

芯片添加到温度读数中的温度偏移量。

CPU 核心参考电压。

读/写值。

/sys/class/hwmon/hwmonX/tempY_crit_alarm

/sys/class/hwmon/hwmonX/tempY_rated_max

最大额定温度。

CPU 核心参考电压。

/sys/class/hwmon/hwmonX/tempY_rated_min

/sys/class/hwmon/hwmonX/tempY_crit_alarm

并非总是正确。

最小额定温度。

CPU 核心参考电压。

/sys/class/hwmon/hwmonX/tempY_reset_history

/sys/class/hwmon/hwmonX/tempY_crit_alarm

并非总是正确。

重置 temp_lowest 和 temp_highest

CPU 核心参考电压。

/sys/class/hwmon/hwmonX/tempY_type

/sys/class/hwmon/hwmonX/curr_reset_history

传感器类型选择。

CPU 核心参考电压。

整数 1 到 6

1:CPU 内嵌二极管

/sys/class/hwmon/hwmonX/currY_enable

  • 2:3904 晶体管

  • 3:热二极管

  • 4:热敏电阻

  • 5:AMD AMDSI

  • 6:Intel PECI

  • 并非所有芯片都支持所有类型

/sys/class/hwmon/hwmonX/temp_reset_history

重置所有传感器的 temp_lowest 和 temp_highest

CPU 核心参考电压。

/sys/class/hwmon/hwmonX/update_interval

/sys/class/hwmon/hwmonX/curr_reset_history

芯片更新读数的间隔。单位:毫秒。

CPU 核心参考电压。

某些设备具有可变的更新速率或间隔。此属性可用于将其更改为所需值。

/sys/class/hwmon/hwmonX/currY_enable

/sys/class/hwmon/hwmonX/vrm

电压调节模块版本号。

CPU 核心参考电压。

读写(但更改它应该不再必要)

最初是 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

启动时间,单位微秒。如果按钮按下时间超过 <startup_time>,主板将通电。

关机时间,单位微秒。如果按钮按下时间超过 <shutdown_time>,主板将断电。

/sys/class/intel_pmt/

定义于文件 sysfs-class-intel_pmt

intel_pmt/ 类目录包含使用英特尔平台监控技术 (PMT) 公开硬件遥测的设备信息。

/sys/class/intel_pmt/crashlog<x>

crashlog<x> 目录包含用于配置 PMT 崩溃日志设备实例的文件,该设备可以执行崩溃数据记录。每个 crashlog<x> 设备都有一个关联的崩溃日志文件。此文件可以打开并映射或读取以访问生成的崩溃日志缓冲区。缓冲区的寄存器布局可以从父设备的指定 GUID 的 XML 文件中确定。

intel_pmt/ 类目录包含使用英特尔平台监控技术 (PMT) 公开硬件遥测的设备信息。

/sys/class/intel_pmt/crashlog<x>/crashlog

(只读) 此崩溃日志设备的崩溃日志缓冲区。此文件可以映射或读取以获取数据。

intel_pmt/ 类目录包含使用英特尔平台监控技术 (PMT) 公开硬件遥测的设备信息。

/sys/class/intel_pmt/crashlog<x>/enable

(读写) 布尔值,控制崩溃日志功能是否为此崩溃日志设备启用。

intel_pmt/ 类目录包含使用英特尔平台监控技术 (PMT) 公开硬件遥测的设备信息。

/sys/class/intel_pmt/crashlog<x>/guid

(只读) 此崩溃日志设备的 GUID。GUID 标识应用于确定寄存器布局的父设备的 XML 文件版本。

intel_pmt/ 类目录包含使用英特尔平台监控技术 (PMT) 公开硬件遥测的设备信息。

/sys/class/intel_pmt/crashlog<x>/offset

(只读) 缓冲区在字节中的偏移量,对应于崩溃日志设备的映射。

intel_pmt/ 类目录包含使用英特尔平台监控技术 (PMT) 公开硬件遥测的设备信息。

/sys/class/intel_pmt/crashlog<x>/size

(只读) 结果缓冲区以字节为单位的长度,对应于崩溃日志缓冲区的大小。

intel_pmt/ 类目录包含使用英特尔平台监控技术 (PMT) 公开硬件遥测的设备信息。

/sys/class/intel_pmt/crashlog<x>/trigger

/sys/class/intel_pmt/crashlog<x>/trigger

intel_pmt/ 类目录包含使用英特尔平台监控技术 (PMT) 公开硬件遥测的设备信息。

(读写) 控制 crashlog 设备节点触发的布尔值。读取时,它提供关于 crashlog 是否已被触发的数据。写入时,可以写入 false 来清除当前触发,或者在未设置触发器时触发新事件。

/sys/class/intel_pmt/telem<x>

intel_pmt/ 类目录包含使用英特尔平台监控技术 (PMT) 公开硬件遥测的设备信息。

telem<x> 目录包含描述 PMT 遥测设备实例的文件,该设备公开硬件遥测数据。每个 telem<x> 目录都有一个关联的 telem 文件。可以打开、映射或读取此文件以访问设备的遥测空间。遥测空间的寄存器布局由与设备的 PCI 设备 ID 和 GUID 匹配的 XML 文件确定。

/sys/class/intel_pmt/telem<x>/guid

intel_pmt/ 类目录包含使用英特尔平台监控技术 (PMT) 公开硬件遥测的设备信息。

(只读) 此遥测设备的 GUID。GUID 标识父设备的 XML 文件版本,用于获取寄存器布局。

/sys/class/intel_pmt/telem<x>/offset

intel_pmt/ 类目录包含使用英特尔平台监控技术 (PMT) 公开硬件遥测的设备信息。

(只读) 遥测区域的偏移量(以字节为单位),对应于 telem 文件的映射。

/sys/class/intel_pmt/telem<x>/size

intel_pmt/ 类目录包含使用英特尔平台监控技术 (PMT) 公开硬件遥测的设备信息。

(只读) 遥测区域的大小(以字节为单位),对应于 telem 文件的映射大小。

/sys/class/intel_pmt/telem<x>/telem

intel_pmt/ 类目录包含使用英特尔平台监控技术 (PMT) 公开硬件遥测的设备信息。

(只读) 此遥测设备的遥测数据。可以映射或读取此文件以获取数据。

/sys/class/iommu/<iommu>/amd-iommu/cap

在文件 sysfs-class-iommu-amd-iommu 中定义

IOMMU 能力头,如 AMD 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-current-control 模式 (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

正常:启用时 LED 完全亮起。音频:LED 亮度取决于音量。呼吸: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-*

写入“none”会移除此 LED 的触发器。

写入“default”会将触发器设置为 LED 的默认触发器(通常在硬件的设备树中配置)。

/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/<bus>/<device>/attached_dev

在文件 sysfs-class-net-phydev 中定义

指向此 PHY 设备所连接的网络设备的符号链接。

/sys/class/mdio_bus/<bus>/<device>/phy_dev_flags

在文件 sysfs-class-net-phydev 中定义

32 位十六进制数,表示从 PHY 的消费者(以太网 MAC、交换机等)传递给 PHY 驱动程序的配置位的位掩码。这些标志仅供内核内部使用,其位置在不同内核版本之间不保证稳定。这旨在方便 PHY 驱动程序的调试。

/sys/class/mdio_bus/<bus>/<device>/phy_has_fixups

在文件 sysfs-class-net-phydev 中定义

此属性包含一个布尔值,表示给定 PHY 设备是否在其上运行过任何“修复”或变通方案,编码为布尔值。此信息旨在帮助解决 PHY 配置问题。

/sys/class/mdio_bus/<bus>/<device>/phy_id

在文件 sysfs-class-net-phydev 中定义

此属性包含设备在总线枚举期间报告的 32 位 PHY 标识符,以十六进制编码。此 ID 用于将设备与相应的驱动程序匹配。

/sys/class/mdio_bus/<bus>/<device>/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/<bus>/<device>/phy_standalone

在文件 sysfs-class-net-phydev 中定义

布尔值,指示 PHY 设备是否由 PHYLINK 以独立模式使用,且没有关联的 net_device。此属性仅在此情况下创建。

/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 固件的版本格式为:<platform>:<major>.<minor>.<milestone>.<build_no>。不同固件组件最多可以有三个这样的块。

/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 中定义

配置发送队列限制

设置每个已打开会话的最大待处理写入数量。

/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 操作系统。在启动此卡 OS 之前,可以传递内核命令行选项来配置其中的各种功能,类似于可自启动机器。读取时,此条目提供有关当前用于启动卡 OS 的内核命令行选项的信息。可以写入此条目以更改现有的内核命令行选项。通常,用户会希望读取当前命令行选项,追加新选项或修改现有选项,然后将整个内核命令行写回此条目。

/sys/class/mic/mic<X>/family

在文件 sysfs-class-mic 中定义

提供有关英特尔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 中定义

英特尔MIC设备在运行期间会运行Linux操作系统。为了调试目的和早期内核引导消息,用户可以通过debugfs访问卡操作系统的日志缓冲区。读取此条目时,它提供可读取卡操作系统日志缓冲区的内核虚拟地址。此条目由主机配置守护程序写入以设置日志缓冲区地址。要写入的正确日志缓冲区地址可在卡操作系统的System.map文件中找到。

/sys/class/mic/mic<X>/log_buf_len

在文件 sysfs-class-mic 中定义

英特尔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 中定义

英特尔MIC设备在运行期间会运行Linux操作系统。此操作系统可能因各种原因关机。读取此条目时,它提供卡操作系统关机的原因状态。可能的值为:

“nop”

当卡操作系统“在线”时,关机状态不适用

“crashed”

因硬件或软件崩溃而关机。

“halted”

因halt命令而关机。

“poweroff”

因poweroff命令而关机。

“restart”

因restart命令而关机。

/sys/class/mic/mic<X>/state

在文件 sysfs-class-mic 中定义

读取此条目时,它提供英特尔MIC设备在卡操作系统上下文中的当前状态。可能读取的值为:

“ready”

MIC设备已准备好启动卡操作系统。在OSPM恢复后读取此条目时,如果卡在OSPM挂起期间之前已关机,则必须向此条目写入“boot”。

“booting”

MIC设备已开始启动卡操作系统。

“online”

MIC设备已完成启动并在线

“shutting_down”

卡操作系统正在关机。

“resetting”

已为MIC设备启动复位。

“reset_failed”

MIC设备复位失败。

写入此sysfs条目时,它根据卡操作系统的当前状态触发不同的状态更改操作。可接受的值为:

“boot”

启动由firmware、ramdisk、cmdline和bootmode sysfs条目组合指定的卡操作系统镜像。

“reset”(复位)

启动设备复位。

“shutdown”

启动卡操作系统关机。

/sys/class/mic/mic<X>/stepping

在文件 sysfs-class-mic 中定义

提供有关英特尔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

用户可以以MB/s为单位读取通过此生成器生成的当前PCIe链路吞吐量。

用法示例:

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

用户可以以MB/s为单位读取通过此生成器生成的当前PCIe链路吞吐量。

用法示例:

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设备对应的字符设备的主次号(格式为<major>:<minor>)。这是读写设备,因此<minor>将是偶数。

/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中定义

一个十六进制值,表示设备标志,按位或运算:

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设备的只读变体对应的字符设备的主次号(格式为<major>:<minor>)。在这种情况下,<minor>将是奇数。

/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不匹配的位的T 值。默认值0不转发任何链路本地帧。

受限位

0

01-80-C2-00-00-00 用于STP的网桥组地址

1

01-80-C2-00-00-01 (MAC控制) 802.3 用于MAC PAUSE

2

01-80-C2-00-00-02 (链路聚合) 802.3ad

可以使用任何不设置这些位的T 值。转发控制帧时要特别小心,例如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以及反向变化的次数。

/sys/class/net/<iface>/carrier_down_count

在文件sysfs-class-net中定义

一个32位无符号整数,计算链路处于DOWN状态的次数。

/sys/class/net/<iface>/carrier_up_count

在文件sysfs-class-net中定义

一个32位无符号整数,计算链路处于UP状态的次数。

/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中定义

数据报聚合超时,单位为微秒。驱动程序将等待此超时时间的3倍,以聚合更多数据报,然后才传输NTB帧。

有效范围:5到4000000

设置为0可禁用聚合。

以下所有只读属性均表示USB Implementers Forum, Inc.于2010年11月24日发布的《Universal Serial Bus Communications Class Subclass Specifications for Network Control Model Devices (CDC NCM),修订版1.0 (勘误1)》第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中定义

指示此网络设备的端口号,格式为十进制值。一些网卡在相同的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模块的固件印记 只读:32字节字符串,标识ICAN3模块(已知值:“JANZ-ICAN3 ICANOS 1.xx”、“JANZ-ICAN3 CAL/CANopen 1.xx”)

/sys/class/net/<iface>/grcan/enable0

在文件sysfs-class-net-grcan中定义

物理接口0的硬件配置。此文件读写配置寄存器的“使能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的硬件配置。此文件读写配置寄存器的“使能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多路复用的网络设备,该设备受最近基于Qualcomm的调制解调器支持。

网络设备将被称为qmimux。

用户空间负责通过使用适当的QMI协议请求来管理qmux网络设备激活和调制解调器端的数据流设置。

/sys/class/net/<iface>/qmi/del_mux

在文件sysfs-class-net-qmi中定义

无符号整数。

写入1到254之间的数字,以删除先前创建的基于qmap多路复用的网络设备。

/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”。

网络设备将随之改变以反映链路帧模式。在“802.3”模式下,网络设备是普通的以太网设备,驱动程序期望通过USB链路交换带有以太网头的帧。在“raw-ip”模式下,网络设备是无头点对点设备,驱动程序期望通过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中定义

此特定网络设备接收队列当前正在处理的接收数据包转向流的数量。

/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中定义

指示接口最新或当前速度值。值为一个整数,表示链路速度,单位为Mbits/秒。

注意:此属性仅对实现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网络接口时与之关联的mux ID。

/sys/class/ocxl/<afu name>/afu_version

在文件 sysfs-class-ocxl 中定义

只读 AFU版本,格式为 <主版本>:<次版本> 反映了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/platform-profile/platform-profile-X/choices

在文件 sysfs-class-platform-profile 中定义

此文件包含此设备支持的以空格分隔的配置文件列表。

驱动程序必须使用以下标准配置文件名称

low-power

低功耗

cool

更凉爽的运行

quiet

更安静的运行

balanced

低功耗与性能之间的平衡

balanced-performance

性能和低功耗之间的平衡,略微偏向性能

performance

高性能运行

custom

驱动程序定义的自定义配置文件

并非总是正确。

/sys/class/platform-profile/platform-profile-X/name

在文件 sysfs-class-platform-profile 中定义

驱动程序给出的类设备名称。

并非总是正确。

/sys/class/platform-profile/platform-profile-X/profile

在文件 sysfs-class-platform-profile 中定义

读取此文件可获取此设备当前选定的配置文件。将platform_profile_choices中的字符串之一写入此文件会将配置文件更改为新值。

可以通过轮询POLLPRI来监控此文件的更改,无论这些更改是来自用户空间写入,还是来自其他来源(例如由嵌入式控制器直接处理或在内核内部完全处理的热键触发的配置文件更改),POLLPRI都将发出信号。

此文件也可能发出字符串“custom”以指示驱动程序正在使用驱动程序定义的自定义配置文件。

/sys/class/hwmon/hwmonX/currY_enable

/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(电子部件识别码)。

有关详细信息,请参阅 Dell DDV WMI 接口驱动程序 (dell-wmi-ddv)

/sys/class/power_supply/<supply_name>/alarm

在文件 sysfs-class-power-surface 中定义

电池跳闸点。当剩余电池容量向任一方向穿过此值时,系统将收到通知,并在必要时被唤醒。

设置为零以清除/禁用。

访问:读,写

有效值:以微瓦时(micro-Wh)或微安时(micro-Ah)表示,具体取决于电池的功率单位

/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

连接交流电时不要充电

inhibit-charge-awake

仅当设备唤醒时才抑制充电

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 中定义

最大允许充电电流。用于热冷却或改善电池健康状况的充电速率限制。

访问:读,写

有效值:以微安(microamps)表示

/sys/class/power_supply/<supply_name>/charge_control_limit_max

在文件 sysfs-class-power 中定义

charge_control_limit属性的最大合法值。

访问:只读

有效值:以微安(microamps)表示

/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 中定义

报告充电电流值,该值用于确定电池何时被视为已充满电且充电应结束。

访问:只读

有效值:以微安(microamps)表示

/sys/class/power_supply/<supply_name>/charge_type

在文件 sysfs-class-power 中定义

选择用于电池的充电算法。

Standard

以中等速率为电池完全充电。

Fast

使用快充技术快速充电。这通常比标准充电对电池的损耗更大,并可能缩短其使用寿命。

Trickle

主要在连接外部电源时操作系统的用户可以通过此模式延长电池寿命。供应商工具可能会将其称为“主要交流电使用”。

Adaptive

根据典型使用模式自动优化电池充电速率。

Custom

使用charge_control_*属性来确定何时开始和停止充电。高级用户可以使用此功能显著延长电池寿命。

Long Life

充电器会降低充电速率以延长电池健康。

Bypass

充电器绕过集成转换器周围的充电路径,允许“智能”墙壁适配器在外部执行电源转换。

访问:读,写

读取此文件将返回当前活动值,例如“Standard”。检查charge_types以获取电池支持的值。

有效值:

“未知”、“不适用”、“涓流”、“快速”、“标准”、“自适应”、“自定义”、“长寿命”、“旁路”

/sys/class/power_supply/<supply_name>/charge_types

在文件 sysfs-class-power 中定义

与charge_type相同,但读取时返回支持的充电类型列表,当前活动类型用方括号括起来,例如:“Fast [Standard] Long_Life”。

power_supply类设备可能同时支持charge_type和charge_types以实现向后兼容。在这种情况下,两者将始终具有相同的活动值,并且可以通过写入任一属性来更改活动值。

请注意,包含空格的充电类型(如“Long Life”)中的空格将被“_”替换,例如“Long_Life”。写入充电类型时,两种变体都接受。

/sys/class/power_supply/<supply_name>/current_avg

在文件 sysfs-class-power 中定义

电池

报告电池在固定周期内的平均IBAT电流读数。通常,设备会提供一个固定间隔来平均读数,以使报告值平滑。

USB

报告在固定周期内的平均IBUS电流读数。通常,设备会提供一个固定间隔来平均读数,以使报告值平滑。

访问:只读

有效值:以微安(microamps)表示。负值用于电池放电,正值用于电池充电和USB IBUS电流。

/sys/class/power_supply/<supply_name>/current_max

在文件 sysfs-class-power 中定义

电池

报告允许进入电池的最大IBAT电流。

USB

报告电源可支持的最大IBUS电流。

访问:读 有效值:以微安(microamps)表示

/sys/class/power_supply/<supply_name>/current_now

在文件 sysfs-class-power 中定义

电池

报告电池的瞬时、单次IBAT电流读数。此值未经过平均/平滑处理。

访问:只读

USB

报告当前提供的IBUS电流。此值通常为只读报告,除非电源的“在线”状态设置为可编程,在这种情况下,此值可以在报告的最小/最大范围内设置。

访问:读,写

有效值:以微安(microamps)表示。负值用于电池放电,正值用于电池充电和USB IBUS电流。

/sys/class/power_supply/<supply_name>/cycle_count

在文件 sysfs-class-power 中定义

报告电池已完成的完整充电+放电循环次数。

访问:只读

有效值:

整数 > 0:表示完整循环次数 整数 = 0:循环计数信息不可用

USB属性

/sys/class/power_supply/<supply_name>/extensions/<extension_name>

在文件 sysfs-class-power 中定义

报告注册到电源的扩展。每个条目都是指向注册该扩展的设备的链接。

访问:只读

/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。

访问:读,写

有效值:以微安(microamps)表示

/sys/class/power_supply/<supply_name>/input_power_limit

在文件 sysfs-class-power 中定义

此条目配置电源中当前设置的输入功率限制。通常,这是根据系统级知识或用户输入配置的。优先使用此功能限制输入功率,仅在可以通过功率限制解决问题时才使用电流/电压限制。

访问:读,写

有效值:以微瓦(microwatts)表示

/sys/class/power_supply/<supply_name>/input_voltage_limit

在文件 sysfs-class-power 中定义

此条目配置电源中当前设置的输入VBUS电压限制。通常,这是根据系统级知识或用户输入配置的(例如,这是Pixel C热管理策略的一部分,旨在在屏幕开启时有效将输入功率限制在5V,以满足谷歌的表面温度目标)。请注意,此功能不应用于安全关键事项。优先使用input_power_limit,对于可以使用功率限制解决的问题,请使用input_voltage_limit。

访问:读,写

有效值:以微伏(microvolts)表示

/sys/class/power_supply/<supply_name>/manufacture_day

在文件 sysfs-class-power 中定义

报告设备制造的月份日期。

访问:读 有效值:1-31

/sys/class/power_supply/<supply_name>/manufacture_month

在文件 sysfs-class-power 中定义

报告设备制造的月份。

访问:只读

有效值:1-12

/sys/class/power_supply/<supply_name>/manufacture_year

在文件 sysfs-class-power 中定义

报告设备制造的年份(遵循公历)。

访问:只读

有效值:以整数形式报告

/sys/class/power_supply/<supply_name>/manufacturer

在文件 sysfs-class-power 中定义

报告设备制造商的名称。

访问:读 有效值:以字符串形式表示

/sys/class/power_supply/<supply_name>/model_name

在文件 sysfs-class-power 中定义

报告设备型号的名称。

访问:读 有效值:以字符串形式表示

/sys/class/power_supply/<supply_name>/online,

在文件 sysfs-class-power 中定义

指示电源是否有VBUS存在。当电源在线且允许时,可以在在线状态之间切换(例如,对于PD_PPS USB电源,可以从固定模式切换到可编程模式,从而控制电压和电流)。

访问:读,写

有效值:

0:

离线

1:

在线固定 - 固定电压电源

2:

在线可编程 - 可编程电压电源

/sys/class/power_supply/<supply_name>/precharge_current

在文件 sysfs-class-power 中定义

报告电池充电周期预充电阶段施加的充电电流。

访问:只读

有效值:以微安(microamps)表示

/sys/class/power_supply/<supply_name>/present

在文件 sysfs-class-power 中定义

报告系统中是否存在电池。如果该属性不存在,则认为电池存在。

访问:只读

有效值:

0:

不存在

1:

存在

/sys/class/power_supply/<supply_name>/serial_number

在文件 sysfs-class-power 中定义

报告设备的序列号。

访问:读 有效值:以字符串形式表示

/sys/class/power_supply/<supply_name>/status

在文件 sysfs-class-power 中定义

表示电池的充电状态。通常这是只读报告,但对于某些电源,这可以用于启用/禁用电池充电。

访问:读,写

有效值:

“未知”、“充电中”、“放电中”、“未充电”、“已充满”

/sys/class/power_supply/<supply_name>/technology

在文件 sysfs-class-power 中定义

描述电源支持的电池技术。

访问:只读

有效值:

“未知”、“镍氢”、“锂离子”、“锂聚合物”、“磷酸铁锂”、“镍镉”、“锂锰”

/sys/class/power_supply/<supply_name>/temp

在文件 sysfs-class-power 中定义

电池

报告当前TBAT电池温度读数。

USB

报告当前电源温度读数。这通常是设备本身的内部温度(例如IC的TJUNC温度)

访问:只读

有效值:以1/10摄氏度表示

/sys/class/power_supply/<supply_name>/temp_alert_max

在文件 sysfs-class-power 中定义

电池

TBAT温度跳闸线最大值,当达到此值时电源将通知用户空间该事件。

USB

电源温度跳闸线最大值,当达到此值时电源将通知用户空间该事件。

这通常用于充电场景,用户空间需要知道温度是否已超过上限阈值,以便采取适当措施(例如:警告用户温度过高,且充电已停止)。

访问:只读

有效值:以1/10摄氏度表示

/sys/class/power_supply/<supply_name>/temp_alert_min

在文件 sysfs-class-power 中定义

电池

TBAT温度跳闸线最小值,当达到此值时电源将通知用户空间该事件。

USB

电源温度跳闸线最小值,当达到此值时电源将通知用户空间该事件。

这通常用于充电场景,用户空间需要知道温度是否已低于下限阈值,以便采取适当措施(例如:警告用户温度水平较高,并相应地降低了充电电流以纠正情况)。

访问:只读

有效值:以1/10摄氏度表示

/sys/class/power_supply/<supply_name>/temp_max

在文件 sysfs-class-power 中定义

电池

报告充电允许的最大TBAT电池温度。

USB

报告操作允许的最大电源温度。

访问:只读

有效值:以1/10摄氏度表示

/sys/class/power_supply/<supply_name>/temp_min

在文件 sysfs-class-power 中定义

电池

报告充电允许的最小TBAT电池温度。

USB

报告操作允许的最小电源温度。

访问:只读

有效值:以1/10摄氏度表示

/sys/class/power_supply/<supply_name>/type

在文件 sysfs-class-power 中定义

描述电源的主要类型。

访问:读 有效值:“电池”、“UPS”、“市电”、“USB”、“无线”

电池和USB属性

/sys/class/power_supply/<supply_name>/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/<supply_name>/voltage_avg,

在文件 sysfs-class-power 中定义

报告电池在固定周期内的平均VBAT电压读数。通常,设备会提供一个固定间隔来平均读数,以使报告值平滑。

访问:只读

有效值:以微伏(microvolts)表示

/sys/class/power_supply/<supply_name>/voltage_max,

在文件 sysfs-class-power 中定义

电池

报告充电期间电池允许的最大安全VBAT电压。

USB

报告电源可支持的最大VBUS电压。

访问:只读

有效值:以微伏(microvolts)表示

/sys/class/power_supply/<supply_name>/voltage_min,

在文件 sysfs-class-power 中定义

电池

报告放电期间电池允许的最小安全VBAT电压。

USB

报告电源可支持的最小VBUS电压。

访问:只读

有效值:以微伏(microvolts)表示

/sys/class/power_supply/<supply_name>/voltage_now,

在文件 sysfs-class-power 中定义

电池

报告电池的瞬时、单次VBAT电压读数。此值未经过平均/平滑处理。

访问:只读

USB

报告当前提供的VBUS电压。此值通常为只读报告,除非电源的“在线”状态设置为可编程,在这种情况下,此值可以在报告的最小/最大范围内设置。

访问:读,写

有效值:以微伏(microvolts)表示

电池属性

/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 (所有单位为微伏)

/sys/class/power_supply/bq24257-charger/ovp_voltage

在文件 sysfs-class-power 中定义

此条目配置bq24257型充电设备的过压保护功能。此功能可保护设备和其他组件免受输入电源过压造成的损坏。有关详细信息,请参阅设备数据表。

有效值:

  • 6000000, 6500000, 7000000, 8000000, 9000000, 9500000, 10000000, 10500000 (所有单位为微伏)

/sys/class/power_supply/bq24257-charger/sysoff_enable

在文件 sysfs-class-power 中定义

此条目允许启用bq24257型充电设备的sysoff模式。如果启用并在输入断开时,内部电池FET将关闭,以将BAT引脚的漏电流降至1uA以下。请注意,在某些设备/系统中,这会将电池与系统断开连接。有关详细信息,请参阅设备数据表。

有效值:

  • 1: 启用

  • 0: 禁用

/sys/class/power_supply/gaokun-ec-battery/battery_adaptive_charge

在文件 sysfs-class-power-gaokun 中定义

此条目允许启用电池自适应充电。

访问:读,写

有效值:0 (禁用) 或 1 (启用)

/sys/class/power_supply/gaokun-ec-battery/smart_charge_delay

在文件 sysfs-class-power-gaokun 中定义

此条目允许配置智能充电延迟。

智能充电行为:当电源适配器连接达延迟小时后,电池充电将遵循charge_control_start_threshold和charge_control_end_threshold的规则。有关充电控制的更多信息,请参阅sysfs-class-power。

访问:读,写

有效值:以小时为单位(非负)

/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 中定义

充电器测量的电池输入电流。负值表示电池正在放电。

访问:只读

有效值:以微安(microamps)表示的有符号值

/sys/class/power_supply/ltc4162-l/vbat

在文件 sysfs-class-power-ltc4162l 中定义

充电器测量的电池电压。

访问:只读

有效值:以微伏(microvolts)表示

/sys/class/power_supply/ltc4162-l/vbat_avg

在文件 sysfs-class-power-ltc4162l 中定义

充电器测量的电池电压(随时间平均)。

访问:只读

有效值:以微伏(microvolts)表示

/sys/class/power_supply/max14577-charger/device/fast_charge_timer

在文件 sysfs-class-power 中定义

此条目显示并设置max14577充电器在快充模式下工作的最长时间。当计时器到期时,设备将终止快充模式(充电电流将降至0 A)并触发中断。

有效值:

  • 5、6或7(小时),

  • 0: 禁用。

/sys/class/power_supply/max1720x/temp_ain1

在文件 sysfs-class-power-max1720x 中定义

报告AIN1热敏电阻的当前温度读数。

访问:只读

有效值:以1/10摄氏度表示

/sys/class/power_supply/max1720x/temp_ain2

在文件 sysfs-class-power-max1720x 中定义

报告AIN2热敏电阻的当前温度读数。

访问:只读

有效值:以1/10摄氏度表示

/sys/class/power_supply/max1720x/temp_int

在文件 sysfs-class-power-max1720x 中定义

报告内部芯片的当前温度读数。

访问:只读

有效值:以1/10摄氏度表示

/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/max8971-charger/fast_charge_timer

在文件 sysfs-class-power 中定义

此项显示并设置 max8971 充电器在快速充电模式下的最大运行时间。当计时器到期时,设备将终止快速充电模式(充电电流将降至 0 A)并触发中断。

有效值:

  • 4 - 10 (小时),步长 1

  • 0: 禁用。

/sys/class/power_supply/max8971-charger/top_off_threshold_current

在文件 sysfs-class-power 中定义

此条目显示并设置进入补电模式的充电电流阈值。当快充模式下的充电电流低于此值时,充电器将触发中断并开始补电模式。

有效值:

  • 50000 - 200000 (微安),步长 50000 (向下取整)

/sys/class/power_supply/max8971-charger/top_off_timer

在文件 sysfs-class-power 中定义

此项显示并设置 max8971 充电器在涓流充电模式下的最大运行时间。当计时器到期时,设备将终止涓流充电模式(充电电流将降至 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

这允许为“control type”启用/禁用功耗限制。此状态会影响使用此“control_type”的每个功耗区域。

/sys/class/pps-gen/

定义于文件 sysfs-pps-gen

/sys/class/pps-gen/ 目录包含文件和目录,提供 PPS 生成器的统一接口。

/sys/class/pps-gen/pps-genX/

定义于文件 sysfs-pps-gen

/sys/class/pps-gen/pps-genX/ 目录与系统中的第 X 个 PPS 生成器相关。每个目录都包含用于管理和控制其 PPS 生成器的文件。

/sys/class/pps-gen/pps-genX/enable

定义于文件 sysfs-pps-gen

此只写文件启用或禁用 PPS 信号的生成。

/sys/class/pps-gen/pps-genX/system

定义于文件 sysfs-pps-gen

如果生成器从系统时钟获取时间,则此只读文件返回“1”,否则(即从外围设备时钟获取)返回“0”。

/sys/class/pps-gen/pps-genX/time

定义于文件 sysfs-pps-gen

此只读文件包含存储在生成器时钟中的当前时间,以两个整数表示当前时间的秒和纳秒。

/sys/class/pps-gen/pps-genx/enable

定义于文件 sysfs-pps-gen-tio

启用或禁用 PPS TIO 生成器输出。

/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 个源的断言事件和断言序列号,格式如下:

<secs>.<nsec>#<sequence>

如果源没有断言事件,此文件内容为空。

/sys/class/pps/ppsX/clear

定义于文件 sysfs-pps

/sys/class/pps/ppsX/clear 文件报告第 X 个源的清除事件和清除序列号,格式如下:

<secs>.<nsec>#<sequence>

如果源没有清除事件,此文件内容为空。

/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 硬件时钟的最大频率调整值(一个正整数),以十亿分之一为单位。

/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

此只写文件启用或禁用 PPS 事件向 Linux 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 的字段。这指示设备是否处于旁路模式。

这将是以下字符串之一

  • ‘enabled’

  • ‘disabled’

  • “unknown”(未知)

“enabled”表示稳压器处于旁路模式。

“disabled”表示稳压器正在进行稳压。

“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 的字段。这保存了以微伏(即 E-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 控制已启用它)。

“unknown”表示软件无法确定状态,或者报告的状态无效。

注意:此字段可以与微伏或微安结合使用,以确定配置的稳压器输出电平。

/sys/class/regulator/.../status

定义于文件 sysfs-class-regulator

一些稳压器目录将包含一个名为“status”的字段。这报告了当前稳压器状态,适用于可以报告该输出值的稳压器。

这将是以下字符串之一

  • 错误

  • 快速

  • 正常

  • 空闲

  • 待机

“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-client 的信息。所有非只读的 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

单个地址被视为目标。将从任何客户端 IP 地址建立到此服务器的连接。

path=ip:10.0.0.66,ip:10.0.1.66

第一个地址是源地址,第二个是目标地址。

如果指定了多个“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 客户端只创建中断模式队列。

注意:必须为使用轮询模式队列的设备创建唯一的会话。

退出代码

如果设备已映射,则会因 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-server 的信息。

/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(读写)或 migration(迁移)。

/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 的值。

该属性的范围是 -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 中定义

(RO) RTC 提供的日期,格式为 YYYY-MM-DD

/sys/class/rtc/rtcX/hctosys

在文件 sysfs-class-rtc 中定义

(RO) 如果 RTC 在引导时通过 CONFIG_RTC_HCTOSYS 内核选项提供了系统时间,则为 1,否则为 0

/sys/class/rtc/rtcX/max_user_freq

在文件 sysfs-class-rtc 中定义

(RW) 未特权用户可以从此 RTC 请求的最大中断速率。

/sys/class/rtc/rtcX/name

在文件 sysfs-class-rtc 中定义

(RO) 与此 sysfs 目录对应的 RTC 名称

/sys/class/rtc/rtcX/offset

在文件 sysfs-class-rtc 中定义

(RW) RTC 时钟在固件中调整的量。仅当驱动程序支持时钟偏移调整时可见。单位是十亿分之一,即每十亿个时钟滴答中,添加到或从 RTC 基准时钟中移除的时钟滴答数。正值使一天过得更慢、更长,负值使一天过得更快。

/sys/class/rtc/rtcX/range

在文件 sysfs-class-rtc 中定义

RTC 的有效时间范围,以自纪元以来的秒数表示,格式为 [min, max]

/sys/class/rtc/rtcX/since_epoch

在文件 sysfs-class-rtc 中定义

(RO) RTC 提供的自纪元以来的秒数形式的时间

/sys/class/rtc/rtcX/time

在文件 sysfs-class-rtc 中定义

(RO) RTC 提供的 24 小时制时间 (hh:mm:ss)

/sys/class/rtc/rtcX/wakealarm

在文件 sysfs-class-rtc 中定义

(RW) 时钟将生成系统唤醒事件的时间。这是一个一次性唤醒事件,因此如果需要每日唤醒,则必须在唤醒后重置。默认格式为自纪元以来的秒数,如果前面有“+”,则为将来的秒数,或者如果前面有“+=”,则为当前警报之前的秒数。

/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 应选择哪条路径

round-robin (0)

以每 CPU 轮询方式选择路径。

min-inflight (1)

选择 inflight 最小的路径。

min-latency (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/<session-name>/paths/<src@dst>/stats/cpu_migration

在文件 sysfs-class-rtrs-client 中定义

RTRS 期望每个 HCA IRQ 都固定到单独的 CPU。如果不是这种情况,IO 响应的处理可能会在与最初提交时不同的 CPU 上进行。此文件显示在非预期 CPU 上生成了多少中断。

“from:”

是 IRQ 预期但未生成的 CPU。

“to:”

是 IRQ 生成但未预期的 CPU。

/sys/class/rtrs-client/<session-name>/paths/<src@dst>/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/<session-name>/paths/<src@dst>/stats/reconnects

在文件 sysfs-class-rtrs-client 中定义

包含 2 个无符号整数值,第一个记录路径生命周期中成功重新连接的次数,第二个记录路径生命周期中失败重新连接的次数。

/sys/class/rtrs-client/<session-name>/paths/<src@dst>/stats/reset_all

在文件 sysfs-class-rtrs-client 中定义

读写,读取将返回使用帮助,写入 0 将清除所有统计信息。

/sys/class/rtrs-server

在文件 sysfs-class-rtrs-server 中定义

当用户在客户端创建新的 RTRS API 会话时,会在此处创建一个以该会话名称命名的目录条目。

/sys/class/rtrs-server/<session-name>/paths/

在文件 sysfs-class-rtrs-server 中定义

当通过在客户端写入“add_path”条目创建新路径时,会在服务器上创建一个名为 <源地址>@<目标地址> 的目录条目。

/sys/class/rtrs-server/<session-name>/paths/<src@dst>/disconnect

在文件 sysfs-class-rtrs-server 中定义

当向文件写入“1”时,RTRS 会话将被断开连接。操作是非阻塞的,并立即将控制权返回给调用者。

/sys/class/rtrs-server/<session-name>/paths/<src@dst>/dst_addr

在文件 sysfs-class-rtrs-server 中定义

只读,包含路径的目标地址

/sys/class/rtrs-server/<session-name>/paths/<src@dst>/hca_name

在文件 sysfs-class-rtrs-server 中定义

只读,包含建立连接的 HCA 名称。

/sys/class/rtrs-server/<session-name>/paths/<src@dst>/hca_port

在文件 sysfs-class-rtrs-server 中定义

只读,包含流量通过的活动端口号。

/sys/class/rtrs-server/<session-name>/paths/<src@dst>/src_addr

在文件 sysfs-class-rtrs-server 中定义

只读,包含路径的源地址

/sys/class/rtrs-server/<session-name>/paths/<src@dst>/stats/rdma

在文件 sysfs-class-rtrs-server 中定义

包含有关 rdma 操作和 inflight 操作的统计信息。输出由 5 个值组成:<read-count> <read-total-size> <write-count> <write-total-size> <inflights>

/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 Smart Path”功能的当前状态。当 SSD Smart Path 启用时,它允许驱动程序直接将 I/O 请求发送到作为逻辑驱动器一部分的物理设备,跳过控制器的固件 RAID 堆栈,从而在可能的情况下获得性能优势。值为“1”表示该功能已启用,控制器可以使用到物理设备的直接 I/O 路径。值为零表示该功能已禁用,控制器不能使用到物理设备的直接 I/O 路径。此设置是控制器范围的,影响控制器上所有已配置的逻辑驱动器。此文件可读写。

/sys/class/scsi_host/hostX/ahci_host_version

在文件 sysfs-class-scsi_host 中定义

(RO) 显示主机实现的 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 中定义

(RW) 如果主机支持 EM,则允许直接访问 AHCI EM(外壳管理)缓冲区。

例如,AHCI 驱动程序支持 SGPIO EM 消息,但 SATA/AHCI 规范未定义 EM 缓冲区的 SGPIO 消息格式。不同的硬件 (HW) 供应商可能有不同的定义。通过 em_buffer 属性,可以通过允许硬件供应商为其 SGPIO 发起程序提供用户态驱动程序和工具来解决此问题。

/sys/class/scsi_host/hostX/em_message

/sys/class/scsi_host/hostX/em_message_type

在文件 sysfs-class-scsi_host 中定义

em_message: (RW) 外壳管理支持。对于 LED 协议,写入和读取对应于 AHCI 规范中定义的 LED 消息格式。

如果用户希望通过 em_message 文件控制活动 LED,则必须关闭 sw_activity(在 /sys/block/*/device/ 下)。

em_message_type: (RO) 显示驱动程序当前正在使用的外壳管理协议(例如,LED、SAF-TE、SES-2、SGPIO 等)。

/sys/class/scsi_host/hostX/em_message_supported

在文件 sysfs-class-scsi_host 中定义

(RO) 显示支持的外壳管理消息类型。

/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 中定义

(RW) 此参数允许用户读取和设置链路(接口)电源管理。

有四种可能的选项

min_power: 告诉控制器在可能的情况下尽量让链路使用最少的功耗。这可能会因为从较低功耗状态恢复时延迟增加而牺牲一些性能。

max_performance: 通常,这意味着没有电源管理。告诉控制器将性能置于电源管理之上。

medium_power: 告诉控制器在可能的情况下进入较低功耗状态,但不要进入最低功耗状态,从而比 min_power 设置改善延迟。

med_power_with_dipm: 与现有的 medium_power 设置相同,只是它在此基础上启用了 dipm(设备发起电源管理),使其与 Windows IRST (Intel Rapid Storage Technology) 驱动程序设置匹配。此设置也接近 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 中定义

向磁带驱动器发出的除 SCSI 读/写请求之外的 I/O 请求数量。

/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/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 应禁用仿真。

/sys/class/hwmon/hwmonX/tempY_crit_alarm

只写,可选

警告

在生产系统上启用此选项时请务必小心,因为用户空间可以通过简单地向此 sysfs 节点写入低温度值来轻松禁用热策略。

/sys/class/thermal/thermal_zoneX/integral_cutoff

在文件 sysfs-class-thermal 中定义

与所需温度跳变点的温度偏移量,超过此偏移量后,功率分配器控制器的 PID 控制器的积分项开始累积误差。例如,如果 integral_cutoff 为 0,则只有当温度高于所需温度跳变点时,积分项才会累积误差。更多信息请参见 功率分配器控制器可调参数

/sys/class/hwmon/hwmonX/tempY_crit_alarm

读写,可选

/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/hwmon/hwmonX/tempY_crit_alarm

只读,必填

/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/hwmon/hwmonX/tempY_crit_alarm

只读,可选

/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 节点获取。

period [duty [phase [polarity]]]

echo 500000000 > signal # 1/2 秒周期 echo 1000000 40 100 > signal echo 0 > signal # 关闭发生器

周期和相位以纳秒为单位指定。占空比为 1-99% 的百分比。极性为 1 或 0。

读取此节点将返回

period duty phase polarity start_time

/sys/class/timecard/ocpN/genX/start

在文件 sysfs-timecard 中定义

(只读) 显示信号发生器开始运行的时间,格式为 <sec>.<nsec>。

/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 时间关联的系统时间。此估计可能不准确,因为它取决于 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 中定义

(只读) 此可选属性包含输出 PHC 时间(NMEA ZDA 格式)的 TTY 串行端口的名称。

/sys/class/timecard/ocpN/utc_tai_offset

在文件 sysfs-timecard 中定义

(读写) DCF 和 IRIG 输出信号采用 UTC,而时间卡在 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 中定义

此属性显示对最近执行的操作请求的响应。格式为“<request> <response num> : <response description>”。此文件为只读。

/sys/class/tpm/tpmX/ppi/tcg_operations

在文件 sysfs-driver-ppi 中定义

此属性显示 BIOS 是否允许在预操作系统环境中请求执行由 TCG 定义的操作(即请求 1 到 22)。格式为“<request> <status num>: <status description>”。此属性仅受 PPI 1.2+ 版支持。此文件为只读。

/sys/class/tpm/tpmX/ppi/transition_action

在文件 sysfs-driver-ppi 中定义

此属性显示为了过渡到 BIOS 以执行请求的操作,应采取的平台特定动作。格式为“<action num>: <action description>”。此文件为只读。

/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 缓冲区。无论是否打开串行设备文件,用户都可以显示或设置此值。

RX 触发器可以设置为 UART 串行设备的四种值之一。当用户向此接口输入一个无意义的值时,RX 触发器将更改为设备规范中最接近的较小值。例如,当用户在 16550A 上设置 7 字节时(其触发器为 1/4/8/14 字节),RX 触发器会自动更改为 4 字节。

/sys/class/tty/ttyS<x>/type

在文件 sysfs-tty 中定义

显示此端口的当前 tty 类型。

这些 sysfs 值通过 sysfs 而非 ioctl 暴露 TIOCGSERIAL 接口。

/sys/class/tty/ttyS<x>/uartclk

在文件 sysfs-tty 中定义

显示 serial_core 中与 UART 端口关联的当前 uartclk 值,该端口绑定到 ttyS0 等 TTY。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

  • 固定式

/sys/class/typec/<port>-cable/type

在文件 sysfs-class-typec 中定义

USB 电力传输规范定义了一组线缆产品类型。如果已知,此文件将显示线缆的产品类型。如果线缆的产品类型对设备驱动程序不可见,则此文件将不存在。

当检测到线缆产品类型时,还会生成一个 uevent,其中 PRODUCT_TYPE 显示线缆的产品类型。

有效值:

未定义

active

有源线缆

无源

无源线缆

/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 产品类型,但当时只有一个与当前角色匹配的类型会处于活动状态。如果配对设备的产品类型对设备驱动程序不可见,则此文件将不存在。

当检测到配对设备产品类型或通过角色交换更改时,还会生成一个 uevent,其中包含 PRODUCT_TYPE=<product type>(例如 PRODUCT_TYPE=hub)。

有效值:

UFP / 设备角色 ====================== ========================== undefined - hub PDUSB Hub peripheral PDUSB Peripheral psd Power Bank ama Alternate Mode Adapter ====================== ==========================

DFP / 主机角色 ====================== ========================== undefined - hub PDUSB Hub host PDUSB Host power_brick Power Brick amc Alternate Mode Controller ====================== ==========================

/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 Double Prime 控制器(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 Header VDO 部分。在“发现身份”命令结果可用之前,该值将显示为 0。该值可以被轮询。

/sys/class/typec/<port>-{partner|cable}/identity/product

在文件 sysfs-class-typec 中定义

“发现身份”命令结果中的 Product VDO 部分。在“发现身份”命令结果可用之前,该值将显示为 0。该值可以被轮询。

/sys/class/typec/<port>-{partner|cable}/identity/product_type_vdo1

在文件 sysfs-class-typec 中定义

“发现身份”命令结果的第 1 个产品类型 VDO。在“发现身份”命令结果可用并返回有效的产品类型 VDO 之前,该值将显示为 0。

/sys/class/typec/<port>-{partner|cable}/identity/product_type_vdo2

在文件 sysfs-class-typec 中定义

“发现身份”命令结果的第 2 个产品类型 VDO。在“发现身份”命令结果可用并返回有效的产品类型 VDO 之前,该值将显示为 0。

/sys/class/typec/<port>-{partner|cable}/identity/product_type_vdo3

在文件 sysfs-class-typec 中定义

“发现身份”命令结果的第 3 个产品类型 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 Power Delivery Release 2.0 - “3.0”:USB Power Delivery Release 3.0 - “3.1”:USB Power Delivery Release 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) 将在操作完成之前不会返回。

有效值:

(端口将仅作为源 DFP 端口行为)

接收器

(端口将仅作为接收器 UFP 端口行为)

双向

(端口将作为双角色数据和双角色电源端口行为)

/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 Power Delivery Release 2.0 - “3.0”:USB Power Delivery Release 3.0 - “3.1”:USB Power Delivery Release 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。

有效值:

  • “no”表示端口不是 VCONN 源

  • “yes”表示端口是 VCONN 源

/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 中定义

(只读) 一个 sysfs 节点,用于读取设备的隔离状态。值 1 表示设备不可用。值 0 表示设备可用。

/sys/class/uacce/<dev_name>/isolate_strategy

在文件 sysfs-driver-uacce 中定义

(读写) 一个 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 供电(Power Delivery)设备的目录。

/sys/class/usb_power_delivery/.../<capability>/1:fixed_supply/dual_role_data

在文件 sysfs-class-usb_power_delivery 中定义

此文件显示 vSafe5V 固定电源对象中双角色数据(Dual-Role Data)位的取值。双角色数据意味着能够同时充当 USB 主机和 USB 设备。

/sys/class/usb_power_delivery/.../<capability>/1:fixed_supply/dual_role_power

在文件 sysfs-class-usb_power_delivery 中定义

此文件包含一个布尔值,指示设备是否同时支持源(source)和宿(sink)电源角色。

/sys/class/usb_power_delivery/.../<capability>/1:fixed_supply/unchunked_extended_messages_supported

在文件 sysfs-class-usb_power_delivery 中定义

此文件显示 vSafe5V 固定电源对象中未分块扩展消息支持(Unchunked Extended Messages Supported)位的取值。

/sys/class/usb_power_delivery/.../<capability>/1:fixed_supply/unconstrained_power

在文件 sysfs-class-usb_power_delivery 中定义

此文件显示 vSafe5V 固定电源对象中无限制电源(Unconstrained Power)位的取值。当设备可获得足以独立为整个系统供电的外部电源时,此位将被设置。

/sys/class/usb_power_delivery/.../<capability>/1:fixed_supply/usb_communication_capable

在文件 sysfs-class-usb_power_delivery 中定义

此文件显示 vSafe5V 固定电源对象中 USB 通信能力(USB Communication Capable)位的取值。

/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 capability)消息“Sink_Capabilities”包含一组电源数据对象(PDO),与源能力类似,但这些对象描述的是电源需求,而非电源能力。

宿能力消息中对象的顺序与源能力消息中的相同。

固定电源

/sys/class/usb_power_delivery/.../sink-capabilities/1:fixed_supply/higher_capability

在文件 sysfs-class-usb_power_delivery 中定义

此文件显示 vsafe5V 固定电源对象中更高能力(Higher capability)位的取值。如果该位被设置,则宿需要高于 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)消息“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 Suspend Supported)位的取值。如果该位被设置,则设备将遵循 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 中定义

此文件显示固定电源峰值电流能力(Fixed Power Source Peak Current Capability)字段的取值。

/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。

有效值: - 无 - 主机 - 设备

/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 中定义

(读写) 等待来自用户空间的控制消息响应的超时时间(秒)。默认值为 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 中定义

只读属性。读取操作将导致 zram 添加新设备,并将其设备 ID 返回给用户(以便可以使用 /dev/zram<id>),或者返回错误代码。

/sys/class/zram-control/hot_remove

在文件 sysfs-class-zram 中定义

只写属性。移除特定的 /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 上的 efuses。efuses 包含在工厂编程的一次性写入数据。数据以 32 位字的形式按 LSB 优先格式排列。每个位代表从熔丝寄存器解码的单个值。位顺序/分配与硬件寄存器完全匹配,包括任何未使用的位。

用户

任何希望读取 Tegra SoC 上 efuses 的用户空间应用程序

/sys/devices/*/<our-device>/nvmem

在文件 sysfs-driver-jz4780-efuse 中定义

只读访问君正 JZ4780 SoC 上的 efuse。该 SoC 有一个一次性可编程的 8K efuse,它被分成多个段。驱动程序只支持读取。这些段是

0x000

64 位

随机数

0x008

128 位

君正芯片 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:device name。给定设备可以有零个或多个此类符号链接。

/sys/devices/.../coredump

在文件 sysfs-devices-coredump 中定义

/sys/devices/.../coredump 属性仅在设备绑定到提供 .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 闪存控制器 BIOS 区域是否已锁定写入。

/sys/devices/.../intel_spi_locked

在文件 sysfs-driver-spi-intel 中定义

此属性允许用户空间检查 Intel SPI 闪存控制器是否锁定支持的操作码。

/sys/devices/.../intel_spi_protected

在文件 sysfs-driver-spi-intel 中定义

此属性允许用户空间检查 Intel SPI 闪存控制器是否受主机写保护。

/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 状态不是“active”,尝试从此属性读取将导致返回 -EAGAIN。

/sys/devices/.../lpss_ltr/ltr_mode

在文件 sysfs-devices-lpss_ltr 中定义

/sys/devices/.../lpss_ltr/ltr_mode 属性包含一个整数(0 或 1),指示设备的 LTR 功能是否在软件模式(1)下工作。

此属性是只读的。如果设备的运行时 PM 状态不是“active”,尝试从此属性读取将导致返回 -EAGAIN。

/sys/devices/.../lpss_ltr/sw_ltr

在文件 sysfs-devices-lpss_ltr 中定义

/sys/devices/.../lpss_ltr/auto_ltr 属性包含设备 SW_LTR 寄存器的当前原始值,表示为 8 位十六进制数字。

此属性是只读的。如果设备的运行时 PM 状态不是“active”,尝试从此属性读取将导致返回 -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 中定义

如果设备连接点位于扩展坞或端口复制器中,则为“Yes”。否则为“No”。

/sys/devices/.../physical_location/horizontal_position

在文件 sysfs-devices-physical-location 中定义

描述设备连接点在面板表面上的水平位置。

/sys/devices/.../physical_location/lid

在文件 sysfs-devices-physical-location 中定义

如果设备连接点位于笔记本电脑系统的盖子上,则为“Yes”。否则为“No”。

/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 属性包含自动暂停延迟值(毫秒)。某些驱动程序不希望其设备在运行时一变为空闲就暂停;他们希望设备首先保持非活动状态一定的最短时间。该期限称为自动暂停延迟。负值将阻止设备在运行时暂停(类似于向 power/control 属性写入“on”)。值 >= 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 中定义

关于用户是否可以从平台移除给定设备的信息。这由其子系统以总线/平台特定的方式决定。此属性仅对支持确定此类信息的设备存在

“可移除”

设备可以由用户从平台移除

“固定”

设备固定在平台上 / 不能由用户移除。

“未知”

信息不可用 / 无法推断。

目前,这仅由 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() 回调被调用时才停止这样做——这仅在所有其消费者设备都已注册并成功探测时发生。在内核启动时被禁用(left disabled)的资源不受 sync_state() 回调的任何影响或限制。

向此文件写入“1”将强制调用设备的 sync_state() 函数,如果它尚未被调用的话。sync_state() 调用独立于消费者设备的状态而发生。

/sys/devices/.../sun

在文件 sysfs-devices-sun 中定义

此文件包含由 ACPI 命名空间中的 _SUN 方法提供的槽位唯一 ID。该值在高级配置和电源接口规范中定义如下

“_SUN 值在同类型槽位中必须是唯一的。也建议此数字尽可能与物理槽位上打印的槽位号匹配。”

因此,读取 sysfs 文件,我们可以识别系统中槽位的物理位置。

/sys/devices/.../supplier:<supplier>

在文件 sysfs-devices-supplier 中定义

/sys/devices/.../supplier:<supplier> 是指向设备链接的符号链接,其中此设备是消费者。<supplier> 表示该设备链接中供应商的名称,形式为 bus:device name。给定设备可以有零个或多个此类符号链接。

/sys/devices/.../waiting_for_supplier

在文件 sysfs-devices-waiting_for_supplier 中定义

/sys/devices/.../waiting_for_supplier 属性仅在 fw_devlink 内核命令行选项启用且设置为比“permissive”更严格的值时才存在。一旦设备成功探测,它就会被移除(因为信息不再相关)。从其中读取的数字(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 -> 自动 (也称作 定时器)

  • 0x8 -> 开启

  • 0x10 -> 关闭

请注意,并非所有键盘类型都支持列出的模式。请参阅名为“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 -> 关闭

  • 1 -> 开启

/sys/devices/LNXSYSTM:00/LNXSYBUS:00/TOS{1900,620{0,7,8}}:00/kbd_backlight_mode

在文件 sysfs-driver-toshiba_acpi 中定义

此文件控制键盘背光操作模式,有效值为

  • 0x1 -> FN-Z

  • 0x2 -> 自动 (也称作 定时器)

  • 0x8 -> 开启

  • 0x10 -> 关闭

请注意,从内核 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 添加了对第二种类型的支持,并且类型 2 接受的范围是 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 和 自动

  • 2 -> 类型 2,支持模式 定时器、开启 和 关闭

用户

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 -> 关闭

  • 1 -> 开启

用户

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 中定义

此文件控制睡眠与音乐(Sleep & Music)状态,其值可以是

  • 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/

/sys/devices/cpu/events/branch-misses

/sys/devices/cpu/events/cache-references

/sys/devices/cpu/events/cache-misses

/sys/devices/cpu/events/stalled-cycles-frontend

/sys/devices/cpu/events/branch-instructions

/sys/devices/cpu/events/stalled-cycles-backend

/sys/devices/cpu/events/instructions

/sys/devices/cpu/events/cpu-cycles

在文件 sysfs-bus-event_source-devices-events 上定义

通用性能监控事件

许多/大多数 CPU 可能支持的性能监控事件集合。这些事件可以使用“perf(1)”工具进行监控。

每个文件的内容如下所示

event=0xNNNN

其中“N”是一个十六进制数字,数字“0xNNNN”显示由文件“basename”标识的性能事件的“原始代码”。

/sys/devices/hisi_ptt<sicl_id>_<core_id>/requester_filters

在文件 sysfs-bus-event_source-devices-hisi_ptt 上定义

此目录包含提供 PCIe 请求者过滤器信息的文件,这些信息用于 PTT 跟踪。每个文件都以支持的端点设备名称 <domain>:<bus>:<device>.<function> 命名。

有关更多信息,请参阅海思 PCIe 调优和跟踪设备中“过滤器”的描述。

/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 上定义

此目录包含提供 PCIe 根端口过滤器信息的文件,这些信息用于 PTT 跟踪。每个文件都以支持的根端口设备名称 <domain>:<bus>:<device>.<function> 命名。

有关更多信息,请参阅海思 PCIe 调优和跟踪设备中“过滤器”的描述。

/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 文件公开了指定用于进行 HCALL 以检索 hv-24x7 pmu 事件计数器数据的 cpumask。

/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 文件公开了指定用于进行 HCALL 以检索 hv-gpci pmu 事件计数器数据的 cpumask。

/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 文件读取数据。

  • 此 sysfs 文件仅在 HCALL 返回“H_SUCCESS”、“H_AUTHORITY”或“H_PARAMETER”作为返回类型时才会创建。

    返回错误类型“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 文件读取数据。

  • 此 sysfs 文件仅在 HCALL 返回“H_SUCCESS”、“H_AUTHORITY”或“H_PARAMETER”作为返回类型时才会创建。

    返回错误类型“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 文件读取数据。

  • 此 sysfs 文件仅在 HCALL 返回“H_SUCCESS”、“H_AUTHORITY”或“H_PARAMETER”作为返回类型时才会创建。

    返回错误类型“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 文件读取数据。

  • 此 sysfs 文件仅在 HCALL 返回“H_SUCCESS”、“H_AUTHORITY”或“H_PARAMETER”作为返回类型时才会创建。

    返回错误类型“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 文件读取数据。

  • 此 sysfs 文件仅在 HCALL 返回“H_SUCCESS”、“H_AUTHORITY”或“H_PARAMETER”作为返回类型时才会创建。

    返回错误类型“H_AUTHORITY”的 HCALL 可以在运行时通过设置“启用性能信息收集”选项来解决。

  • 读取此 sysfs 文件的最终用户必须根据底层平台/固件解码内容。

读取此 sysfs 文件时可能出现的错误代码

  • “-EPERM”分区不允许检索性能信息,

    需要设置“启用性能信息收集”选项。

  • “-EIO”因无效缓冲区长度/无效地址而无法检索系统信息

    或因某些硬件错误。有关更多信息,请参阅 getPerfCountInfo 文档。

  • “-EFBIG”:系统信息超过 PAGE_SIZE。

/sys/devices/pci0000:00/*/QEMU0001:00/capability (用于 MMIO)

/sys/bus/pci/drivers/pvpanic-pci/0000:00:0*.0/capability (用于 PCI)

在文件 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

/sys/bus/pci/drivers/pvpanic-pci/0000:00:0*.0/events (用于 PCI)

在文件 sysfs-bus-pci-devices-pvpanic 中定义

读写属性。设置/获取正在使用的功能。此属性用于启用/禁用 pvpanic 设备的功能。请注意,此值应是功能的子集。

格式: %x。

另请参阅 pvpanic 设备规范。

/sys/devices/pci0000:00/<dev>/avs/fw_version

在文件 sysfs-bus-pci-devices-avs 中定义

AudioDSP 固件 ASoC avs 驱动程序正在通信的版本。

格式: %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 中定义

AudioDSP 固件 ASoC catpt 驱动程序正在通信的版本。

格式: %d.%d.%d.%d, 类型:主版本号:次版本号:构建版本号。

/sys/devices/platform/*/cnqf_enable

在文件 sysfs-amd-pmf 中定义

读取此文件可以判断 AMD 平台管理 (PMF) Cool n Quiet 框架 (CnQF) 功能是否启用。

此功能默认不启用,只有当 OEM BIOS 将“flag”传递给 PMF ACPI 函数(索引 11 或 12)或用户写入“on”时才开启。

要关闭 CnQF,用户可以向 sysfs 节点写入“off”。注意:支持自动模式的系统将不提供此 sysfs 文件。

/sys/devices/platform/.../power_on_reason

在文件 sysfs-platform-power-on-reason 中定义

显示系统开机原因。可以读取以下字符串/原因(列表可以扩展):“正常开机”、“RTC 唤醒”、“看门狗超时”、“软件复位”、“复位按钮操作”、“CPU 时钟故障”、“晶体振荡器故障”、“掉电复位”、“未知原因”。

该文件是只读的。

/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 中定义

列出可用的迷你 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 - 启用独立 GPU,

  • 1 - 禁用独立 GPU

/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 禁用独立 GPU

  • 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 模式。具备此功能的笔记本电脑可以切换为仅使用独显 (独立模式) 启动,或以标准 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 独立 GPU 的动态加速限制
  • min=5, max=25

/sys/devices/platform/<platform>/nv_temp_target

在文件 sysfs-platform-asus-wmi 中定义

设置 Nvidia 独立 GPU 的目标温度限制
  • min=75, max=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 系统上显示
  • min=5, max=130

/sys/devices/platform/<platform>/ppt_fppt

在文件 sysfs-platform-asus-wmi 中定义

设置 CPU 快速封装功耗追踪限制。仅限 AMD+Nvidia 系统。
  • min=5, max=250

/sys/devices/platform/<platform>/ppt_pl1_spl

在文件 sysfs-platform-asus-wmi 中定义

设置 CPU 的封装功耗总目标:Intel 平台为 PL1,AMD 平台为 SPL。在 Intel+Nvidia 或 AMD+Nvidia 混合系统上显示。

  • min=5, max=250

/sys/devices/platform/<platform>/ppt_pl2_sppt

在文件 sysfs-platform-asus-wmi 中定义

设置 CPU 的慢速封装功耗追踪限制:Intel 平台为 PL2,AMD 平台为 SPPT。在 Intel+Nvidia 或 AMD+Nvidia 混合系统上显示。

  • min=5, max=250

/sys/devices/platform/<platform>/ppt_platform_sppt

在文件 sysfs-platform-asus-wmi 中定义

设置平台 SPPT 限制。仅在纯 AMD 系统上显示。
  • min=5, max=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/<platform>/tt_led

定义于文件 sysfs-platform-oxp

部分壹号本(OneXPlayer)设备(例如 X1 系列)在 Turbo 按钮中内置了一个小 LED 灯。当设备处于较高 TDP 模式(例如 25W)时,此 LED 会亮起。一旦 tt_toggle 被启用,此 LED 将保持在上次的状态。此属性允许用户空间手动控制 LED 状态(通过 1 或 0)。只有部分设备包含此 LED。

/sys/devices/platform/<platform>/tt_toggle

定义于文件 sysfs-platform-oxp

从设备接管 TDP 控制。壹号本设备有一个 Turbo 按钮,可用于在两种 TDP 模式(通常是 15W 和 25W)之间切换。通过将此属性设置为 1,此功能将被禁用,将 TDP 控制权交给(Windows)用户空间软件,并且 Turbo 按钮将转换为设备 AT 键盘上的快捷键。此外,对于大多数较新型号,使用此设置是 PWM 控制的先决条件(否则它将无效)。

/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

(RO)

可用的 HCCS 类型(字符串),用于增加和减少使用的通道数,例如 HCCS-v2。

dec_lane_of_type

(WO)

输入支持减少通道的 HCCS 类型,以将平台上所有指定 HCCS 类型端口的已用通道数减少到最小值。执行成功后,您可以查询“cur_lane_num”以获取最小通道数。

inc_lane_of_type

(WO)

输入支持增加通道的 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

(RO)

如果此芯片上所有启用的端口都已链接 (布尔值)。

linked_full_lane

(RO)

如果此芯片上所有已链接的端口都处于满通道状态 (布尔值)。

crc_err_cnt

(RO)

此芯片上所有端口的总 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/ 目录包含只读属性,公开指定芯片中指定 Die 下所有 HCCS 端口的一些汇总信息。‘dieY’ 中的 Y 表示芯片上硬件 ID 为 Y 的 Die,该芯片的芯片 ID 为 X。

此目录中包含以下属性

all_linked

(RO)

如果此 Die 上所有启用的端口都已链接 (布尔值)。

linked_full_lane

(RO)

如果此 Die 上所有已链接的端口都处于满通道状态 (布尔值)。

crc_err_cnt

(RO)

此 Die 上所有端口的总 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 端口所属 Die 的硬件 ID。注意:type、lane_mode 和 enable 是在运行平台上固定的属性。

HCCS 端口具有以下属性

type

(RO)

端口类型(字符串),例如 HCCS-v1 -> H32

lane_mode

(RO)

此端口的通道模式(字符串),例如 x8

enable

(RO)

指示此端口是否已启用(布尔值)。

cur_lane_num

(RO)

此端口的当前通道数。

link_fsm

(RO)

此端口的链路有限状态机。

lane_mask

(RO)

此端口的当前通道掩码,每个位表示一个通道。

crc_err_cnt

(RO)

此端口上的 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 <任意值> > /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 Laptop Extras 中找到

/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 的内容可能在某些条件下被发送(即使禁用或处于接收模式)。

勘误中的变通方法建议不要使用邮箱,并为其加载一个未使用的标识符。

为了使用扩展 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

(只读) 显示 IPMI 设备接口类型 - 此处为“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(ATA 托架)或 battery_bay(电池托架)。

/sys/devices/platform/dock.<N>/uid

定义于文件 sysfs-devices-platform-dock

(只读) 显示笔记本电脑所连接的扩展坞。

/sys/devices/platform/dock.<N>/undock

定义于文件 sysfs-devices-platform-dock

(只写) 写入此文件将导致软件向固件发起取消坞接请求。

/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

/sys/devices/platform/QCOM8061:*/chid

定义于文件 sysfs-platform-hidma

包含 HIDMA 实例中通道的 ID。它用于将给定的 HIDMA 通道与管理界面中的优先级和权重调用相关联。

/sys/devices/platform/hidma-mgmt*/chanops/chan*/priority

/sys/devices/platform/QCOM8060:*/chanops/chan*/priority

定义于文件 sysfs-platform-hidma-mgmt

包含 0 或 1,表示 DMA 通道是低优先级 (0) 还是高优先级 (1) 通道。

/sys/devices/platform/hidma-mgmt*/chanops/chan*/weight

包含 0..15,表示在循环调度期间,通道在相同优先级通道中的权重。

定义于文件 sysfs-platform-hidma-mgmt

/sys/devices/platform/hidma-mgmt*/chreset_timeout_cycles

/sys/devices/platform/QCOM8060:*/chreset_timeout_cycles

包含发出重置命令后等待的平台特定循环值。如果该值选择得太短,则硬件将发出重置失败中断。该值是平台特定的,未经咨询不应更改。

定义于文件 sysfs-platform-hidma-mgmt

/sys/devices/platform/hidma-mgmt*/dma_channels

/sys/devices/platform/QCOM8060:*/dma_channels

包含 HIDMA 硬件的一个实例支持的 DMA 通道数。该值可能因芯片而异。

定义于文件 sysfs-platform-hidma-mgmt

/sys/devices/platform/hidma-mgmt*/hw_version_major

/sys/devices/platform/QCOM8060:*/hw_version_major

硬件主版本号。

定义于文件 sysfs-platform-hidma-mgmt

/sys/devices/platform/hidma-mgmt*/hw_version_minor

/sys/devices/platform/QCOM8060:*/hw_version_minor

硬件次版本号。

定义于文件 sysfs-platform-hidma-mgmt

/sys/devices/platform/hidma-mgmt*/max_rd_xactions

/sys/devices/platform/QCOM8060:*/max_rd_xactions

包含一个 0 到 31 之间的值。可以连续发出的最大读取事务数。选择更高的数字可以提供更好的性能,但也可能导致共享同一总线的其他外围设备的性能下降。

定义于文件 sysfs-platform-hidma-mgmt

/sys/devices/platform/hidma-mgmt*/max_read_request

/sys/devices/platform/QCOM8060:*/max_read_request

每个读取请求的大小。该值必须是 2 的幂,并且可以在 128 到 1024 之间。

定义于文件 sysfs-platform-hidma-mgmt

/sys/devices/platform/hidma-mgmt*/max_wr_xactions

/sys/devices/platform/QCOM8060:*/max_wr_xactions

包含一个 0 到 31 之间的值。可以连续发出的最大写入事务数。选择更高的数字可以提供更好的性能,但也可能导致共享同一总线的其他外围设备的性能下降。

定义于文件 sysfs-platform-hidma-mgmt

/sys/devices/platform/hidma-mgmt*/max_write_request

/sys/devices/platform/QCOM8060:*/max_write_request

每个写入请求的大小。该值必须是 2 的幂,并且可以在 128 到 1024 之间。

定义于文件 sysfs-platform-hidma-mgmt

/sys/devices/platform/i8042/.../draghys

定义于文件 sysfs-devices-platform-trackpoint

(读写) 拖动滞后控制在按下 z 轴时拖动的难度。

/sys/devices/platform/i8042/.../drift_time

(读写) 此参数控制在发生漂移(噪声)校准之前,测试“脱手”条件(即未施加力时)的时间段。

(读写) 拖动滞后控制在按下 z 轴时拖动的难度。

IBM Trackpoint 具有通过定期重新校准来补偿漂移的功能。默认情况下,如果在 0.5 秒内位置没有变化,则将其用作新的零点。此持续时间过短。通常,校准发生在 Trackpoint 实际使用时。

/sys/devices/platform/i8042/.../ext_dev

(读写) 禁用 (0) 或启用 (1) 外部定点设备。

(读写) 拖动滞后控制在按下 z 轴时拖动的难度。

/sys/devices/platform/i8042/.../intertia

(读写) 负惯性系数。高值会导致光标在释放 Trackpoint 时向后跳动。

(读写) 拖动滞后控制在按下 z 轴时拖动的难度。

/sys/devices/platform/i8042/.../jenks

(读写) 生成无需释放的双击所需的最小曲率(以度为单位)。

(读写) 拖动滞后控制在按下 z 轴时拖动的难度。

/sys/devices/platform/i8042/.../mindrag

(读写) 触发拖动所需的最小力。

(读写) 拖动滞后控制在按下 z 轴时拖动的难度。

/sys/devices/platform/i8042/.../press_to_select

(读写) 向此文件写入 1 将启用“按下选择”功能,例如轻敲控制杆以模拟左键单击;写入 0 将禁用该功能。

(读写) 拖动滞后控制在按下 z 轴时拖动的难度。

/sys/devices/platform/i8042/.../reach

(读写) z 轴按压的备用范围。

(读写) 拖动滞后控制在按下 z 轴时拖动的难度。

/sys/devices/platform/i8042/.../sensitivity

(读写) Trackpoint 灵敏度。

(读写) 拖动滞后控制在按下 z 轴时拖动的难度。

/sys/devices/platform/i8042/.../skipback

(读写) 当设置 skipback 位时,拖动释放期间的光标回退移动将被抑制。此位的默认值为 0。

(读写) 拖动滞后控制在按下 z 轴时拖动的难度。

/sys/devices/platform/i8042/.../speed

(读写) Trackpoint 光标速度。

(读写) 拖动滞后控制在按下 z 轴时拖动的难度。

/sys/devices/platform/i8042/.../thresh

(读写) 相对于运行平均值,触发按压或释放所需的 z 轴力的最小值。

(读写) 拖动滞后控制在按下 z 轴时拖动的难度。

/sys/devices/platform/i8042/.../upthresh

(读写) 释放时在 z 轴上生成选择(点击)所需的与运行平均值的偏移量。

(读写) 拖动滞后控制在按下 z 轴时拖动的难度。

/sys/devices/platform/i8042/.../ztime

(读写) 此属性决定了按压需要多锐利才能被识别。

(读写) 拖动滞后控制在按下 z 轴时拖动的难度。

/sys/devices/platform/ipmi_bmc.*/additional_device_support

(只读) 列出控制器除了强制性 IPM 和应用程序命令之外还支持的 IPMI“逻辑设备”命令和功能。

定义于文件 sysfs-devices-platform-ipmi

/sys/devices/platform/ipmi_bmc.*/aux_firmware_revision

(只读) 包含有关固件版本的附加信息,例如引导块或内部数据结构版本号。这些数字的含义特定于由制造商 ID 标识的供应商。

定义于文件 sysfs-devices-platform-ipmi

/sys/devices/platform/ipmi_bmc.*/device_id

(只读) 设备 ID 由制造商 ID 字段标识的制造商指定。此字段允许控制器特定软件识别控制器提供的唯一应用程序命令、OEM 字段和功能。

定义于文件 sysfs-devices-platform-ipmi

/sys/devices/platform/ipmi_bmc.*/firmware_revision

(只读) 固件的主次修订版本。

定义于文件 sysfs-devices-platform-ipmi

/sys/devices/platform/ipmi_bmc.*/guid

(只读) 管理控制器的 GUID(全球唯一 ID),也称为 UUID(通用唯一标识符),如 IPMI 规范 v2.0 第 20.8 节“获取设备 GUID 命令”中所述。

定义于文件 sysfs-devices-platform-ipmi

/sys/devices/platform/ipmi_bmc.*/ipmi_version

(只读) 显示 IPMI 命令规范版本。

定义于文件 sysfs-devices-platform-ipmi

/sys/devices/platform/ipmi_bmc.*/manufacturer_id

(只读) 标识负责指定控制器中使用的供应商 (OEM) 特定命令、代码和接口功能的制造商。

定义于文件 sysfs-devices-platform-ipmi

/sys/devices/platform/ipmi_bmc.*/product_id

(只读) 显示一个数字,用于标识特定的系统、模块、附加卡或板组。该数字根据制造商 ID 指定的制造商给出。

定义于文件 sysfs-devices-platform-ipmi

有关上述属性的详细定义,请参阅 IPMI 规范 v2.0 的 20.1 节“获取设备 ID 命令”。

/sys/devices/platform/ipmi_bmc.*/provides_device_sdrs

(只读) 指示设备是否提供设备传感器数据记录(1 表示提供,0 表示不提供)。

定义于文件 sysfs-devices-platform-ipmi

/sys/devices/platform/ipmi_bmc.*/revision

(只读) 设备修订版。用于识别管理控制器的实现是否发生了重大硬件更改。

定义于文件 sysfs-devices-platform-ipmi

/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

idles

定义于文件 sysfs-devices-platform-ipmi

(只读) 接口在被轮询时处于空闲状态的次数。

complete_transactions

watchdog_pretimeouts

(只读) 看门狗预超时数量。

(只读) 完成的消息数量。

(只读) 从硬件接收到的 IPMI 事件数量。

events

interrupts

(只读) 驱动程序处理的中断数量。

hosed_count

long_timeouts

(只读) 硬件未遵循状态机的次数。

(只读) 驱动程序在没有进行任何操作时请求计时器的次数。

(只读) 驱动程序从硬件请求标志的次数。

flag_fetches

attentions

(只读) 驱动程序从硬件收到 ATTN 的次数。

incoming_messages

(只读) 接收到的异步消息数量。

short_timeouts

(只读) 驱动程序在操作进行中请求计时器的次数。

/sys/devices/platform/ipmi_si.*/interrupts_enabled

(只读) 指示中断是否已启用。当驱动程序因内存不足而无法处理消息时,它会禁用中断。一旦情况解除,它将重新启用中断。

定义于文件 sysfs-devices-platform-ipmi

/sys/devices/platform/ipmi_si.*/params

/sys/devices/platform/ipmi_si.*/type

定义于文件 sysfs-devices-platform-ipmi

[待文档化]

(只读) IPMI 的设备接口,为“kcs”、“smic”、“bt”或“invalid”。

定义于文件 sysfs-devices-platform-ipmi

/sys/devices/platform/kim/baud_rate

定义于文件 sysfs-platform-kim

主机支持的最大可靠波特率。不同平台通常具有不同的高速 UART 配置,因此波特率需要在本地设置,并通过 HCI-VS 命令发送到 WL128x。当请求 ldisc 安装时,该条目由用户空间守护程序读取和使用。

/sys/devices/platform/kim/dev_name

WL128x 芯片连接的 UART 设备名称。示例:“/dev/ttyS0”。

主机支持的最大可靠波特率。不同平台通常具有不同的高速 UART 配置,因此波特率需要在本地设置,并通过 HCI-VS 命令发送到 WL128x。当请求 ldisc 安装时,该条目由用户空间守护程序读取和使用。

设备名称从 ATAGS 引导加载程序固件流向特定于架构的板初始化文件。暴露的名称由用户空间守护程序读取,并在请求安装时打开设备。

/sys/devices/platform/kim/flow_cntrl

WL128x 使用流控制机制,此条目通常应为 1,主机的 UART 需要具有流控制能力,否则此条目可用于异常情况。

主机支持的最大可靠波特率。不同平台通常具有不同的高速 UART 配置,因此波特率需要在本地设置,并通过 HCI-VS 命令发送到 WL128x。当请求 ldisc 安装时,该条目由用户空间守护程序读取和使用。

/sys/devices/platform/kim/install

当蓝牙、FM 或 GPS 等协议之一希望使用共享 UART 传输时,它会向共享传输驱动程序注册,该驱动程序将通过此 sysfs 条目向用户空间发出打开、配置波特率和安装行规的信号。管理 UART 的用户空间守护程序将轮询此条目,并通过 sysfs_notify 通知更改。当需要打开 UART/安装 ldisc 时,该值为“1”;当不再需要 UART 并需要关闭时,该值为“0”。

主机支持的最大可靠波特率。不同平台通常具有不同的高速 UART 配置,因此波特率需要在本地设置,并通过 HCI-VS 命令发送到 WL128x。当请求 ldisc 安装时,该条目由用户空间守护程序读取和使用。

/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

控制风扇模式。1 表示性能模式,0 表示静音模式。

已废弃,请使用 /sys/class/power_supply/CMB0/charge_control_end_threshold 最大电池充电水平。接受的值为 80 或 100。

/sys/devices/platform/lg-laptop/fn_lock

控制 FN 锁定模式。1 表示开启,0 表示关闭。

已废弃,请使用 /sys/class/power_supply/CMB0/charge_control_end_threshold 最大电池充电水平。接受的值为 80 或 100。

/sys/devices/platform/lg-laptop/reader_mode

控制阅读器模式。1 表示开启,0 表示关闭。

已废弃,请使用 /sys/class/power_supply/CMB0/charge_control_end_threshold 最大电池充电水平。接受的值为 80 或 100。

/sys/devices/platform/lg-laptop/usb_charge

控制设备关闭时的 USB 端口充电。1 表示开启,0 表示关闭。

已废弃,请使用 /sys/class/power_supply/CMB0/charge_control_end_threshold 最大电池充电水平。接受的值为 80 或 100。

/sys/devices/platform/msi-laptop-pf/auto_brightness

定义于文件 sysfs-platform-msi-laptop

启用自动亮度控制:包含 0 或 1。如果设置为 1,硬件会在电源线插入/拔出时自动调整屏幕亮度。

/sys/devices/platform/msi-laptop-pf/auto_fan

包含 0 或 1,表示风扇速度是自动控制 (1) 还是以最大速度运行 (0)。可以在软件中切换。

启用自动亮度控制:包含 0 或 1。如果设置为 1,硬件会在电源线插入/拔出时自动调整屏幕亮度。

/sys/devices/platform/msi-laptop-pf/bluetooth

蓝牙子系统已启用:包含 0 或 1。请注意,如果没有可用的蓝牙硬件,此文件将始终为 0。

启用自动亮度控制:包含 0 或 1。如果设置为 1,硬件会在电源线插入/拔出时自动调整屏幕亮度。

/sys/devices/platform/msi-laptop-pf/eco_mode

包含 0 或 1,表示 ECO 模式是否开启。在 ECO 模式下,电源 LED 为绿色,用户空间应执行一些省电操作。ECO 模式仅在电池供电时可用。ECO 模式只能通过按 Fn+F10 键切换。

启用自动亮度控制:包含 0 或 1。如果设置为 1,硬件会在电源线插入/拔出时自动调整屏幕亮度。

/sys/devices/platform/msi-laptop-pf/lcd_level

屏幕亮度:包含一个 0 到 8 范围内的单个整数。

启用自动亮度控制:包含 0 或 1。如果设置为 1,硬件会在电源线插入/拔出时自动调整屏幕亮度。

/sys/devices/platform/msi-laptop-pf/touchpad

包含 0 或 1,表示触摸板是否开启。触摸板状态只能通过按 Fn+F3 键切换。

启用自动亮度控制:包含 0 或 1。如果设置为 1,硬件会在电源线插入/拔出时自动调整屏幕亮度。

/sys/devices/platform/msi-laptop-pf/turbo_cooldown

包含 0 到 3 范围内的值

启用自动亮度控制:包含 0 或 1。如果设置为 1,硬件会在电源线插入/拔出时自动调整屏幕亮度。

0 -> 睿频模式关闭
  • 1 -> 睿频模式开启,尚不能关闭

  • 2 -> 睿频模式关闭,尚不能开启

  • 3 -> 睿频模式开启

  • /sys/devices/platform/msi-laptop-pf/turbo_mode

包含 0 或 1,表示睿频模式是否开启。在睿频模式下,电源 LED 为橙色,处理器处于超频状态。睿频模式仅在充电时可用。只能通过按 Fn+F10 键切换睿频模式状态,并且连续切换之间有几秒的冷却时间。如果用户频繁按 Fn+F10,睿频模式状态不会改变。

启用自动亮度控制:包含 0 或 1。如果设置为 1,硬件会在电源线插入/拔出时自动调整屏幕亮度。

/sys/devices/platform/msi-laptop-pf/wlan

WLAN 子系统已启用:包含 0 或 1。

启用自动亮度控制:包含 0 或 1。如果设置为 1,硬件会在电源线插入/拔出时自动调整屏幕亮度。

/sys/devices/platform/samsung/battery_life_extender

定义于文件 sysfs-driver-samsung-laptop

可修改最大电池充电水平,通过降低最大电池充电水平可延长电池循环寿命。

0 表示正常电池模式(100% 充电)

  • 1 表示电池续航延长模式(80% 充电)

  • /sys/devices/platform/samsung/lid_handling

某些三星笔记本电脑处理合盖更快,并且仅在此模式启用时处理开盖。1 表示启用,0 表示禁用。

可修改最大电池充电水平,通过降低最大电池充电水平可延长电池循环寿命。

/sys/devices/platform/samsung/performance_level

某些三星笔记本电脑具有不同的“性能级别”,可以通过功能键和此 sysfs 文件进行修改。这些值并非总是有很大意义,但有些用户喜欢修改它们,以不惜一切代价保持风扇安静。从此文件读取将显示当前性能级别。写入文件可以更改此值。

可修改最大电池充电水平,通过降低最大电池充电水平可延长电池循环寿命。

有效选项

“静音”
  • “正常”

  • “超频”

  • 请注意,并非所有笔记本电脑都支持所有这些选项。具体来说,并非所有笔记本电脑都支持“超频”选项,并且此值是否能改变任何东西(除了让用户感觉更好一点)仍然未知。

/sys/devices/platform/samsung/usb_charge

即使笔记本电脑关机,也可以使用 USB 端口为设备充电。1 表示启用,0 表示禁用。

可修改最大电池充电水平,通过降低最大电池充电水平可延长电池循环寿命。

使用您的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 中定义

(只读) 当前运行映像在闪存中的地址。

/sys/devices/platform/stratix10-rsu.0/dcmf0

在文件 sysfs-devices-platform-stratix10-rsu 中定义

(只读) 决策固件副本0的版本信息。

/sys/devices/platform/stratix10-rsu.0/dcmf1

在文件 sysfs-devices-platform-stratix10-rsu 中定义

(只读) 决策固件副本1的版本信息。

/sys/devices/platform/stratix10-rsu.0/dcmf2

在文件 sysfs-devices-platform-stratix10-rsu 中定义

(只读) 决策固件副本2的版本信息。

/sys/devices/platform/stratix10-rsu.0/dcmf3

在文件 sysfs-devices-platform-stratix10-rsu 中定义

(只读) 决策固件副本3的版本信息。

/sys/devices/platform/stratix10-rsu.0/error_details

在文件 sysfs-devices-platform-stratix10-rsu 中定义

(只读) 错误代码。

/sys/devices/platform/stratix10-rsu.0/error_location

在文件 sysfs-devices-platform-stratix10-rsu 中定义

(只读) 发生故障的映像内部的错误偏移量。

/sys/devices/platform/stratix10-rsu.0/fail_image

在文件 sysfs-devices-platform-stratix10-rsu 中定义

(只读) 故障映像在闪存中的地址。

/sys/devices/platform/stratix10-rsu.0/max_retry

在文件 sysfs-devices-platform-stratix10-rsu 中定义

(只读) 最大重试参数存储在固件决策IO部分,作为一个位于偏移量0x18c的字节。

/sys/devices/platform/stratix10-rsu.0/notify

在文件 sysfs-devices-platform-stratix10-rsu 中定义

(只写) 客户端通知固件执行不同操作。

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 中定义

(只写) 下次重启命令时要加载的映像在闪存中的地址。

/sys/devices/platform/stratix10-rsu.0/retry_counter

在文件 sysfs-devices-platform-stratix10-rsu 中定义

(只读) 当前映像的重试计数器,用户可以通过它了解映像在放弃并启动RSU故障转移流程之前,仍被允许重新加载自身的次数。

/sys/devices/platform/stratix10-rsu.0/state

在文件 sysfs-devices-platform-stratix10-rsu 中定义

(只读) 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 中定义

(只读) 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设备导出到连接对等方。通过向此文件写入与连接到希望使用此设备的远程对等方相关联的socket fd(例如,作为字符串“8”)来完成。可以通过写入-1而不是socket 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序列号。

对于许多具有SMCCC v1.2+兼容固件的基于ARM的芯片,这将包含附加到family属性的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或没有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

    读写分配

coherency_line_size

从内存传输到缓存的最小数据量(以字节为单位)

level(级别)

多级缓存配置中的缓存层次结构

number_of_sets

缓存中的总集合数,一个集合是具有相同缓存索引的缓存行的集合

physical_line_partition

每个缓存标签的物理缓存行数

shared_cpu_list

共享缓存的逻辑CPU列表

shared_cpu_map

包含共享缓存的CPU列表的逻辑CPU掩码

size

总缓存大小(以KB为单位)

type
  • 指令:仅存储指令的缓存

  • 数据:仅缓存数据的缓存

  • 统一:同时存储数据和指令的缓存

ways_of_associativity

将特定内存块放置在缓存中的自由度

write_policy
  • WriteThrough

    数据同时写入缓存行和低级内存中的块

  • WriteBack

    数据仅写入缓存行,修改后的缓存行仅在其被替换时才写入主内存

/sys/devices/system/cpu/cpu*/cache/index*/id

在文件 sysfs-devices-system-cpu 中定义

缓存ID

ID为特定类型缓存的特定实例提供唯一编号。例如,服务器的每个插槽上可能有一个三级统一缓存,我们可以为其分配ID 0、1、2等。

请注意,ID值可以是不连续的。例如,一级缓存通常存在于每个核心,但一个插槽上可能没有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}文件对应一个可用于禁用缓存索引的禁用槽。在具有此功能的处理器上读取这些文件将返回该节点当前禁用的索引。每个节点有一个L3结构,或者MCM机器上的每个内部节点有一个L3结构。向其中一个文件写入有效索引将导致指定的缓存索引被禁用。

所有带有L3缓存的AMD处理器都提供此功能。有关详细信息,请参阅 https://www.amd.com/en/support/tech-docs?keyword=bios+kernel 上的BKDG。

/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/auto_act_window

在文件 sysfs-devices-system-cpu 中定义

自主活动窗口

此文件指示平台自主选择策略的移动利用率敏感度窗口。

从此文件读取/写入一个整数,表示自主活动窗口(以微秒为单位)。可写入的最大值为1270000000,但最大有效数字为127。这意味着如果写入128,则存储127。如果值大于130,则仅保存前两位数字作为有效数字。

向此文件写入零值将使平台能够根据工作负载确定适当的活动窗口。

只有在启用自主选择时,对此文件的写入才有意义。

仅当使用cppc-cpufreq驱动程序时,此文件才存在。

/sys/devices/system/cpu/cpuX/cpufreq/auto_select

在文件 sysfs-devices-system-cpu 中定义

自主选择启用

控制自主选择启用的读/写接口
读取返回自主选择状态

0:自主选择已禁用 1:自主选择已启用

写入“y”或“1”或“on”以启用自主选择。写入“n”或“0”或“off”以禁用自主选择。

仅当使用cppc-cpufreq驱动程序时,此文件才存在。

/sys/devices/system/cpu/cpuX/cpufreq/energy_performance_preference_val

在文件 sysfs-devices-system-cpu 中定义

能源性能偏好

从/向此文件读取/写入一个8位整数。此文件表示一个值范围,从0(性能偏好)到0xFF(能效偏好),它影响性能增/减速率以及硬件能效和性能优化策略的结果。

只有在启用自主选择时,对此文件的写入才有意义。

仅当使用cppc-cpufreq驱动程序时,此文件才存在。

/sys/devices/system/cpu/cpuX/cpufreq/freqdomain_cpus

在文件 sysfs-devices-system-cpu 中定义

发现同一CPU频率协调域中的CPU

freqdomain_cpus是共享相同时钟/频率域(可能在硬件级别)的CPU(在线+离线)列表。该信息可能对cpufreq核心隐藏,并且related_cpus的值可能与freqdomain_cpus不同。此属性对于用户空间DVFS控制器在使用acpi-cpufreq的平台上获得更好的电源/性能结果非常有用。

仅当使用acpi-cpufreq或cppc-cpufreq驱动程序时,此文件才存在。

/sys/devices/system/cpu/cpuX/cpufreq/throttle_stats

/sys/devices/system/cpu/cpuX/cpufreq/throttle_stats/turbo_stat

/sys/devices/system/cpu/cpuX/cpufreq/throttle_stats/sub_turbo_stat

/sys/devices/system/cpu/cpuX/cpufreq/throttle_stats/unthrottle

/sys/devices/system/cpu/cpuX/cpufreq/throttle_stats/powercap

/sys/devices/system/cpu/cpuX/cpufreq/throttle_stats/overtemp

/sys/devices/system/cpu/cpuX/cpufreq/throttle_stats/supply_fault

/sys/devices/system/cpu/cpuX/cpufreq/throttle_stats/overcurrent

/sys/devices/system/cpu/cpuX/cpufreq/throttle_stats/occ_reset

在文件 sysfs-devices-system-cpu 中定义

POWERNV CPUFreq驱动程序的频率限制统计目录和属性

‘cpuX/cpufreq/throttle_stats’目录包含芯片的CPU频率限制统计属性。一个CPU的限制统计数据在该芯片所有CPU之间是通用的。以下是‘throttle_stats’目录中导出的限制属性:

  • turbo_stat:此文件提供在睿频(高于和等于标称频率)频率范围内,最大频率被限制到较低频率的总次数。

  • sub_turbo_stat:此文件提供在亚睿频(低于标称频率)频率范围内,最大频率被限制到较低频率的总次数。

  • unthrottle:此文件提供在被限制后,最大频率被解除限制的总次数。

  • powercap:此文件提供因“功率限制”而导致最大频率被限制的总次数。

  • overtemp:此文件提供因“CPU温度过高”而导致最大频率被限制的总次数。

  • supply_fault:此文件提供因“电源故障”而导致最大频率被限制的总次数。

  • overcurrent:此文件提供因“过电流”而导致最大频率被限制的总次数。

  • occ_reset:此文件提供因“OCC复位”而导致最大频率被限制的总次数。

表示不同限制原因的sysfs属性,如powercap、overtemp、supply_fault、overcurrent和occ_reset,映射到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

/sys/devices/system/cpu/cpuX/cpuidle/stateN/latency

/sys/devices/system/cpu/cpuX/cpuidle/stateN/power

/sys/devices/system/cpu/cpuX/cpuidle/stateN/time

/sys/devices/system/cpu/cpuX/cpuidle/stateN/usage

/sys/devices/system/cpu/cpuX/cpuidle/stateN/above

/sys/devices/system/cpu/cpuX/cpuidle/stateN/below

在文件 sysfs-devices-system-cpu 中定义

目录 /sys/devices/system/cpu/cpuX/cpuidle 包含每个在线CPU X的每个逻辑CPU特定的cpuidle信息。可用的处理器空闲状态具有以下属性

name

(RO)

空闲状态的名称(字符串)。

latency

(RO)

退出此空闲状态的延迟(以微秒为单位)。

power

(RO)

处于此空闲状态时消耗的功率(以毫瓦为单位)。

time

(RO)

在此空闲状态下花费的总时间(以微秒为单位)。

usage

(RO)

进入此状态的次数(计数)。

above

(RO)

进入此状态的次数,但观察到的CPU空闲持续时间对其来说太短(计数)。

below

(RO)

进入此状态的次数,但观察到的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 中定义

与 suspend-to-idle 相关的空闲状态使用统计。

此属性组仅适用于可与暂停计时一起用于 suspend-to-idle 的状态。

/sys/devices/system/cpu/cpuX/cpuidle/state<N>/s2idle/time

在文件 sysfs-devices-system-cpu 中定义

CPU在请求此状态后,在 suspend-to-idle 中花费的总时间(调度器时钟已暂停)。

/sys/devices/system/cpu/cpuX/cpuidle/state<N>/s2idle/usage

在文件 sysfs-devices-system-cpu 中定义

CPU在进入 suspend-to-idle 时请求此状态的总次数。

/sys/devices/system/cpu/cpuX/crash_notes

/sys/devices/system/cpu/cpuX/crash_notes_size

在文件 sysfs-devices-system-cpu 中定义

percpu备注的地址和大小。

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/

/sys/devices/system/cpu/cpuX/regs/identification/

/sys/devices/system/cpu/cpuX/regs/identification/midr_el1

/sys/devices/system/cpu/cpuX/regs/identification/revidr_el1

/sys/devices/system/cpu/cpuX/regs/identification/aidr_el1

/sys/devices/system/cpu/cpuX/regs/identification/smidr_el1

在文件 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

/sys/devices/system/cpu/cpuX/topology/core_siblings_list

/sys/devices/system/cpu/cpuX/topology/physical_package_id

/sys/devices/system/cpu/cpuX/topology/thread_siblings

/sys/devices/system/cpu/cpuX/topology/thread_siblings_list

/sys/devices/system/cpu/cpuX/topology/ppin

在文件 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在同一核心内的硬件线程的内部内核映射。

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

/sys/devices/system/cpu/cpufreq/policyX/throttle_stats/turbo_stat

/sys/devices/system/cpu/cpufreq/policyX/throttle_stats/sub_turbo_stat

/sys/devices/system/cpu/cpufreq/policyX/throttle_stats/unthrottle

/sys/devices/system/cpu/cpufreq/policyX/throttle_stats/powercap

/sys/devices/system/cpu/cpufreq/policyX/throttle_stats/overtemp

/sys/devices/system/cpu/cpufreq/policyX/throttle_stats/supply_fault

/sys/devices/system/cpu/cpufreq/policyX/throttle_stats/overcurrent

/sys/devices/system/cpu/cpufreq/policyX/throttle_stats/occ_reset

在文件 sysfs-devices-system-cpu 中定义

POWERNV CPUFreq驱动程序的频率限制统计目录和属性

‘policyX/throttle_stats’目录和所有属性与 /sys/devices/system/cpu/cpuX/cpufreq/throttle_stats 目录和属性相同,它们提供芯片的频率限制信息。

/sys/devices/system/cpu/cpuidle/available_governors

/sys/devices/system/cpu/cpuidle/current_driver

/sys/devices/system/cpu/cpuidle/current_governor

/sys/devices/system/cpu/cpuidle/current_governer_ro

/sys/devices/system/cpu/cpuidle/intel_c1_demotion

在文件 sysfs-devices-system-cpu 中定义

发现cpuidle策略和机制

当今的各种CPU支持多种空闲级别,这些级别通过不同的退出延迟和空闲期间的功耗进行区分。

空闲策略(governor)与空闲机制(driver)是区分开的。

available_governors:(只读)显示可用governor的空格分隔列表。

current_driver:(只读)显示当前空闲机制。

current_governor:(读写)显示当前空闲策略。用户可以通过写入此文件在运行时切换governor。

current_governor_ro:(只读)显示当前空闲策略。

intel_c1_demotion:(读写)启用/禁用Intel CPU上的C1降级功能。

有关更多信息,请参阅 CPU空闲时间管理intel_idle 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

/sys/devices/system/cpu/intel_pstate/min_perf_pct

/sys/devices/system/cpu/intel_pstate/no_turbo

在文件 sysfs-devices-system-cpu 中定义

Intel P-state驱动程序的参数

用于在Intel Sandybridge+处理器中选择当前P状态的逻辑。这三个旋钮控制驱动程序将请求的P状态的限制。

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

/sys/devices/system/cpu/offline

/sys/devices/system/cpu/online

/sys/devices/system/cpu/possible

/sys/devices/system/cpu/present

在文件 sysfs-devices-system-cpu 中定义

描述与热插拔相关的内核限制的CPU拓扑文件。简而言之:

kernel_max: 内核配置允许的最大CPU索引。

offline: 未在线的CPU,因为它们已被热插拔关闭或超出内核配置允许的CPU限制(如上所述的kernel_max)。

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

/sys/devices/system/cpu/release

在文件 sysfs-devices-system-cpu 中定义

CPU的动态添加和移除。这并非热插拔移除,而是指从系统中完全移除/添加CPU。

probe: 写入此文件将动态地向系统添加一个CPU。写入文件中以添加CPU的信息是架构特定的。

release: 写入此文件将动态地从系统中移除一个CPU。写入文件中以移除CPU的信息是架构特定的。

/sys/devices/system/cpu/sev

/sys/devices/system/cpu/sev/vmpl

在文件 sysfs-devices-system-cpu 中定义

安全加密虚拟化 (SEV) 信息

此目录仅在作为SEV-SNP客户机运行时存在。

vmpl: 报告虚拟机特权级别 (VMPL),在该级别下

SEV-SNP客户机正在运行。

/sys/devices/system/cpu/smt

/sys/devices/system/cpu/smt/active

/sys/devices/system/cpu/smt/control

在文件 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

/sys/devices/system/cpu/umwait_control/enable_c02

/sys/devices/system/cpu/umwait_control/max_time

在文件 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-quanta时间。该时间是一个无符号32位数字。请注意,零值表示没有限制。低两位必须为零。

/sys/devices/system/cpu/vulnerabilities

/sys/devices/system/cpu/vulnerabilities/gather_data_sampling

/sys/devices/system/cpu/vulnerabilities/indirect_target_selection

/sys/devices/system/cpu/vulnerabilities/itlb_multihit

/sys/devices/system/cpu/vulnerabilities/l1tf

/sys/devices/system/cpu/vulnerabilities/mds

/sys/devices/system/cpu/vulnerabilities/meltdown

/sys/devices/system/cpu/vulnerabilities/mmio_stale_data

/sys/devices/system/cpu/vulnerabilities/old_microcode

/sys/devices/system/cpu/vulnerabilities/reg_file_data_sampling

/sys/devices/system/cpu/vulnerabilities/retbleed

/sys/devices/system/cpu/vulnerabilities/spec_store_bypass

/sys/devices/system/cpu/vulnerabilities/spectre_v1

/sys/devices/system/cpu/vulnerabilities/spectre_v2

/sys/devices/system/cpu/vulnerabilities/srbds

/sys/devices/system/cpu/vulnerabilities/tsx_async_abort

在文件 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标签。这对于恐慌事件(panic events)隔离不可纠正错误(UE)事件的原因至关重要。DIMM标签必须在启动后分配,并包含正确识别物理插槽及其丝印标签的信息。此信息目前非常依赖于主板,并且必须在用户空间中确定。

/sys/devices/system/edac/mc/mc*/(dimm|rank)*/dimm_location

定义在文件 sysfs-devices-edac

此属性文件将显示DIMM或Rank的位置(csrow/channel、branch/channel/slot或channel/slot)。

/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上发生的不可纠正错误(UE)的总计数。如果设置了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

此属性文件显示在此内存控制器上发生但没有关于哪个DIMM插槽出现错误信息的CE数量。内存功能受限,但仍可运行,然而没有信息表明出现故障的内存位于哪个插槽。此计数域也应监控其非零值。

/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

此属性文件显示此内存控制器上发生的不可纠正错误(UE)的总计数。如果设置了panic_on_ue,此计数器将没有机会增加,因为EDAC会使系统恐慌。

/sys/devices/system/edac/mc/mc*/ue_noinfo_count

定义在文件 sysfs-devices-edac

此属性文件显示在此内存控制器上发生但没有关于哪个DIMM插槽出现错误信息的UE数量。

/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检测到的内部硬件错误情况。未纠正的错误通常会导致机器检查(通常伴随系统恐慌),而已纠正的错误则会生成机器检查日志条目。

有关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。

单位:微秒

/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

硬下线包含写入此文件的物理地址的内存页。输入是指定页面物理地址的十六进制数字。内核随后将尝试硬下线该页面,通过尝试丢弃该页面、杀死任何所有者或在必要时触发I/O错误。请注意,这可能会杀死拥有该页面的任何进程。内核将假定该页面已被硬件“污染”而避免访问它。

下线操作以内核特定的粒度进行。通常是内核的基本页大小,但这可能会改变。

返回值是数字的大小,或者在下线失败时返回错误。不允许读取文件。

/sys/devices/system/memory/memoryX/phys_device

定义在文件 sysfs-devices-memory

文件/sys/devices/system/memory/memoryX/phys_device是只读的;它是一个传统接口,仅在s390x上用于暴露覆盖的存储增量。

用户

传统s390工具 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”,且该内存块无法下线。

对于离线内存块,它返回内存块提供的内存在上线时可由哪个区域管理。将离线内存块的状态设置为“online”时,将使用返回的第一个区域(“default”)。单个内存块只适用其中一个内核区域(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节点目录的符号链接。

例如,为node0上的内存段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内存段目录。例如,为node0上的内存段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是芯片编号)都保存着PCIe根端口的“Segment:Root Bus”,该根端口可以由该IIO PMON块进行监控。例如,在每个芯片最多有6个IIO堆栈(因此每个芯片有6个IIO PMON块)的4芯片Xeon平台上,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”值,表示芯片Y上的UPI链路X连接到芯片W上的UPI链路Z,并且插槽之间的此链路可以由UPI PMON块监控。例如,4芯片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/

/sys/devices/virtual/memory_tiering/memory_tierN/nodelist

定义在文件 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测试镜像。写入的数字被视为以下文件名的两位后缀:/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

上次测试的状态。可以是“通过”、“失败”或“未测试”之一。设备:所有

/sys/devices/virtual/misc/tdx_guest/measurements/MRNAME[:HASH]

定义在文件 sysfs-devices-virtual-misc-tdx-guest

TDX测量寄存器(MR)的值。上面的MRNAME和HASH是占位符。可选后缀:HASH用于具有关联哈希算法的MR。下面列出了通过sysfs暴露的完整TDX MR列表。有关TDREPORT的定义和完整的TDX测量列表,请参阅Intel TDX模块ABI规范。

Intel TDX模块ABI规范可在此处找到: https://www.intel.com/content/www/us/en/developer/tools/trust-domain-extensions/documentation.html#architecture

另请参阅: https://docs.linuxkernel.org.cn/driver-api/coco/measurement-registers.html

/sys/devices/virtual/misc/tdx_guest/measurements/mrconfigid

定义在文件 sysfs-devices-virtual-misc-tdx-guest

(只读) MRCONFIGID - 48字节不可变存储,通常用于客户TD的非所有者定义的配置的软件定义ID,例如:运行时或操作系统配置。

/sys/devices/virtual/misc/tdx_guest/measurements/mrowner

定义在文件 sysfs-devices-virtual-misc-tdx-guest

(只读) MROWNER - 48字节不可变存储,通常用于客户TD所有者的软件定义ID。

/sys/devices/virtual/misc/tdx_guest/measurements/mrownerconfig

定义在文件 sysfs-devices-virtual-misc-tdx-guest

(只读) MROWNERCONFIG - 48字节不可变存储,通常用于客户TD的所有者定义的配置的软件定义ID,例如:特定于工作负载而非运行时或操作系统。

/sys/devices/virtual/misc/tdx_guest/measurements/mrtd:sha384

定义在文件 sysfs-devices-virtual-misc-tdx-guest

(只读) MRTD - TD初始内容的测量。

/sys/devices/virtual/misc/tdx_guest/measurements/rtmr[0123]:sha384

定义在文件 sysfs-devices-virtual-misc-tdx-guest

(读写) RTMR[0123] - 4个运行时可扩展测量寄存器。从其中任何一个读取都会返回相应RTMR的当前值。写入会将写入的缓冲区扩展到RTMR。所有写入必须从偏移量0开始,并且大小为48字节。部分写入将导致write()系统调用返回EINVAL。

/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:在将OS引导加载程序加载到内存之前记录的计时器值。以纳秒为单位。

bootloader_launch_ns:在启动当前加载的OS引导加载程序镜像之前记录的计时器值。以纳秒为单位。

exitbootservice_start_ns:OS加载器调用ExitBootServices函数时记录的计时器值,适用于UEFI兼容固件。以纳秒为单位。

exitbootservice_end_ns:OS加载器从ExitBootServices函数重新获得控制权之前记录的计时器值,适用于UEFI兼容固件。以纳秒为单位。

suspend

suspend_start_ns:在上次OS写入SLP_TYP进入S3时记录的计时器值。以纳秒为单位。

suspend_end_ns:在上次固件写入SLP_TYP以触发硬件进入S3时记录的计时器值。以纳秒为单位。

resume

resume_count:自上次完整启动序列以来S3恢复周期的计数。

resume_avg_ns:自上次完整启动序列以来所有恢复周期的平均计时器值,包括最近的一次恢复。以纳秒为单位。
resume_prev_ns:在上次平台运行时固件S3恢复结束时记录的计时器值,紧接在切换到OS唤醒向量之前。以纳秒为单位。

/sys/firmware/acpi/hotplug/

对于ACPI支持的不同类别的设备,例如容器、内存模块、处理器、PCI根桥等,有单独的热插拔配置文件。给定类别设备的热插拔配置文件是定义该类别设备将由ACPI核心热插拔代码处理方式的设置集合。这些配置文件在sysfs中表示为/sys/firmware/acpi/hotplug/的子目录。

每个热插拔配置文件都有以下可供用户空间使用的设置

如果设置,ACPI核心将处理与给定类别设备相关的热插拔事件通知,并允许在_EJ0控制方法的帮助下弹出这些设备。取消设置将有效地禁用相应类别设备的热插拔。
上述属性的值是一个整数:1(设置)或0(未设置)。尝试向其写入任何其他值将导致返回-EINVAL。

/sys/firmware/acpi/interrupts/

所有ACPI中断都通过单个IRQ(系统控制中断,SCI)处理,该中断在/proc/interrupts中显示为“acpi”。

然而,ACPI的主要功能之一是使平台能够识别随机硬件而无需特殊的驱动程序支持。因此,虽然SCI处理一些众所周知的(固定功能)中断源,例如电源按钮,但它也可以处理可变数量的“通用事件”(GPE)。

GPE向量指向AML中指定的处理程序,该处理程序可以执行BIOS编写者希望从OS上下文执行的任何操作。例如,GPE 0x12将向量指向一个名为_L12或_E12的电平或边缘处理程序。处理程序可以执行其业务并返回。或者,处理程序可以向在ACPI设备(例如电池或处理器)上注册的Linux设备驱动程序发送通知事件。

为了弄清楚所有SCI的来源,/sys/firmware/acpi/interrupts包含一个文件,列出了所有可能的来源以及它被触发的次数

sci

定义在文件 sysfs-firmware-acpi

ACPI SCI被调用并声明中断的次数。

sci_not

enabled

ACPI SCI被调用但未声明中断的次数。

gpe_all

由GPE引起的SCI计数。

定义在文件 sysfs-firmware-acpi

gpeXX

单个GPE源的计数

ff_gbl_lock

全局锁

$ 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

ff_pmtimer

PM定时器

ff_pwr_btn

电源按钮

ff_rt_clk

实时时钟

ff_slp_btn

睡眠按钮

无法在上面列出的中断。

invalid

要么是GPE,要么是没有事件处理程序的固定事件。

disable

GPE/固定事件有效但已禁用。

GPE/固定事件有效且已启用。

Root用户有权限清除这些计数器中的任何一个。例如:

所有计数器都可以通过清除总“sci”来清除。

这些计数器对系统功能没有任何影响,它们只是统计数据。

除此之外,用户还可以向这些文件写入特定字符串,以在用户空间中启用/禁用/清除ACPI中断,这可用于调试一些ACPI中断风暴问题。

错误

请注意,只允许写入有效的GPE/固定事件,即用户只能更改已安装事件处理程序的运行时GPE和固定事件的状态。

以电源按钮固定事件为例,请杀死acpid和其他用户空间应用程序,以便在按下电源按钮时机器不会关机。

/sys/firmware/acpi/memory_ranges/rangeX

在具有ACPI MRRM表的系统上,报告每个范围的参数。

base:起始系统物理地址。

enable

length:此范围的长度(以字节为单位)。

node:此范围所属的NUMA节点。负数表示无法确定节点编号(例如,为未来内存热插拔保留的地址范围)。

# echo 0 > gpe11

local_region_id:与本地代理访问此地址范围关联的ID。

# echo 0 > sci

remote_region_id:与非本地代理访问此地址范围关联的ID。

/sys/firmware/acpi/platform_profile

请注意,只允许写入有效的 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/memory_ranges/rangeX

定义在文件 sysfs-firmware-acpi

在报告每个范围参数的 ACPI MRRM 表的系统上。

base:起始系统物理地址。

length:此范围的长度(以字节为单位)。

node:此范围所属的 NUMA 节点。负数表示无法确定节点号(例如,对于保留用于未来内存热添加的地址范围)。

local_region_id:与本地代理访问此地址范围关联的 ID。

remote_region_id:与非本地代理访问此地址范围关联的 ID。

/sys/firmware/acpi/platform_profile

定义在文件 sysfs-platform_profile

读取此文件可获取此设备当前选定的配置文件。将platform_profile_choices中的字符串之一写入此文件会将配置文件更改为新值。

该文件可以通过轮询POLLPRI来监控更改,无论这些更改是来自用户空间写入,还是来自其他来源(例如由嵌入式控制器直接处理或由内核内部完全处理的热键触发的配置文件更改),任何更改都会触发POLLPRI信号。

该文件也可能发出字符串“custom”,表示正在使用多个平台配置文件驱动程序但它们具有不同的值。此字符串无法写入此接口,仅用于信息目的。

/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”的条目,它们将以“T-0”到“T-(N-1)”的形式在 sysfs 中表示。

示例条目目录

/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 入口点和 DMI 结构体的结构、内容和大小取决于 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 标准第 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 之间的值(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 版本很有用。

相关结构已在固件和内核接口规范中定义,这些规范是通用要求且特定于 Loongson64,因此只需在 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
...

当前存在以下类型

  • 系统内存

  • ACPI 表

  • ACPI 非易失性存储

  • 不可用内存

  • 持久内存(传统)

  • 持久内存

  • 软保留

  • reserved

以下 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

/sys/firmware/opal/powercap/system-powercap/powercap-min

/sys/firmware/opal/powercap/system-powercap/powercap-max

/sys/firmware/opal/powercap/system-powercap/powercap-current

在文件 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、Job-Scheduler)的传感器组。

/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 信息显示在

/sys/firmware/qemu_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

用作 blob 在 fw_cfg 目录中“文件名”的 56 字节以 nul 结尾的 ASCII 字符串。

size

blob 的长度,如 fw_cfg 目录中所示。

key

fw_cfg 目录中给出的 blob 的选择器键值。此值与父目录名中使用的值相同。

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 上的一个 fabric 端口。端口对象的名称附加一个唯一的序数值(例如:/sys/firmware/sgi_uv/hubs/hub_5/port_3)

每个端口对象目录包含许多只读属性

conn_hub
conn_port

conn_hub 条目包含一个值,表示插入端口的 fabric 电缆另一端的 hub 的唯一序数值。如果端口断开连接,则返回值为 -1。

conn_port 条目包含一个值,表示插入端口的 fabric 电缆另一端的端口的唯一序数值。如果端口断开连接,则返回值为 -1。

例如
从以下路径读取值为“3”:

/sys/firmware/sgi_uv/hubs/hub_5/port_3/conn_hub

并从以下路径读取值为“6”:

/sys/firmware/sgi_uv/hubs/hub_5/port_3/conn_port

表示此端口连接到

/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/ram_size

在文件 sysfs-firmware-turris-mox-rwtm 中定义

(读取)此 Turris Mox 主板在制造过程中检测到并烧录到 eFuses 中的 RAM 大小(以 MiB 为单位)。可以是 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 中定义

写入此文件将丢弃与压缩相关的缓存,目前用于丢弃内存中的 pclusters 和缓存的压缩 folio

  • 1:使缓存的压缩 folio 失效

  • 2:丢弃内存中的 pclusters

  • 3:丢弃内存中的 pclusters 和缓存的压缩 folio

/sys/fs/erofs/<disk>/sync_decompress

在文件 sysfs-fs-erofs 中定义

控制同步解压缩策略

  • 0(默认,自动):为 readpage 启用,仅在原子上下文上为 readahead 启用。

  • 1(强制开启):为 readpage 和 readahead 启用。

  • 2(强制关闭):在所有情况下禁用。

/sys/fs/erofs/accel

在文件 sysfs-fs-erofs 中定义

用于设置或显示生效的硬件加速器,多个加速器之间用“n”分隔。支持的加速器:qat_deflate。使用空字符串(echo > accel)禁用所有加速器。

/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 中定义

调整参数,控制使用伙伴缓存时请求的最小大小(以 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 表示已关闭。

/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>/carve_out

在文件 sysfs-fs-f2fs 中定义

对于某些分区存储设备,供应商将提供比规范中用于设备级 GC 更多的额外空间,F2FS 可以将此空间用于文件系统级 GC。为此,我们可以使用 reserved_blocks 保留空间。然而,这还不够,因为此额外空间不应向用户显示。因此,通过这个新的 sysfs 节点,我们可以通过从总字节数中减去 reserved_blocks 来隐藏空间。

/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 中定义

当压缩缓存开启时,它控制缓存页面百分比(压缩页面 / free_ram),以限制缓存压缩页面。如果缓存页面百分比超过阈值,则拒绝缓存压缩页面。该值应在 (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 中定义

显示文件系统所设置编码的名称和版本。如果未设置编码,则显示 (none)。

/sys/fs/f2fs/<disk>/encoding_flags

在文件 sysfs-fs-f2fs 中定义

这是一个只读条目,用于显示 sb.s_encoding_flags 的值,该值为十六进制。

标志名称

标志值

SB_ENC_STRICT_MODE_FL

0x00000001

SB_ENC_NO_COMPAT_FALLBACK_FL

0x00000002

/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

0x00000001

FAULT_KVMALLOC

0x00000002

FAULT_PAGE_ALLOC

0x00000004

FAULT_PAGE_GET

0x00000008

FAULT_ALLOC_BIO

0x00000010(已废弃)

FAULT_ALLOC_NID

0x00000020

FAULT_ORPHAN

0x00000040

FAULT_BLOCK

0x00000080

FAULT_DIR_DEPTH

0x00000100

FAULT_EVICT_INODE

0x00000200

FAULT_TRUNCATE

0x00000400

FAULT_READ_IO

0x00000800

FAULT_CHECKPOINT

0x00001000

FAULT_DISCARD

0x00002000

FAULT_WRITE_IO

0x00004000

FAULT_SLAB_ALLOC

0x00008000

FAULT_DQUOT_INIT

0x00010000

FAULT_LOCK_OP

0x00020000

FAULT_BLKADDR_VALIDITY

0x00040000

FAULT_BLKADDR_CONSISTENCE

0x00080000

FAULT_NO_SEGMENT

0x00100000

FAULT_INCONSISTENT_FOOTER

0x00200000

FAULT_TIMEOUT

0x00400000 (1000毫秒)

FAULT_VMALLOC

0x00800000

/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 模式下(0:GC 正常,1:GC 空闲 CB,2:GC 空闲贪婪,3:GC 空闲 AT,4:GC 紧急高,5:GC 紧急低,6:GC 紧急中)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 urgent high(1):在给定的 gc_urgent_sleep_time 周期内强制执行 GC 并忽略 I/O 空闲检查。使用贪婪 GC 方法并开启 SSR 模式。gc urgent low(2):降低 I/O 空闲检查的门槛,以处理未完成的丢弃命令并稍微积极地进行 GC。始终使用成本效益 GC 方法,如果同时启用 ATGC,则会覆盖年龄阈值 GC 方法。gc urgent mid(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 中定义

当数据分离 (DATA SEPARATION) 开启时,它控制年龄阈值以指示数据块是否为热数据。默认情况下,它被初始化为 262144 块(等于 1GB)。

/sys/fs/f2fs/<disk>/idle_interval

在文件 sysfs-fs-f2fs 中定义

控制系统的空闲时序,如果在给定间隔内没有文件系统操作。默认为 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

如果文件系统利用率超过阈值

0x08

SSR_UTIL

如果 SSR 模式已激活且文件系统利用率超过阈值

0x10

FSYNC

仅在 fsync 路径中针对高性能闪存存储激活。仅当脏页数量超过 min_fsync_blocks 时才会触发 IPU。(=默认选项)

0x20

异步

根据异步写入请求执行 IPU

0x40

无缓存

禁用 IPU 生物缓存

0x80

HONOR_OPU_WRITE

如果 inode 具有 FI_OPU_WRITE 标志,则在 IPU 写入之前使用 OPU 写入

有关详细信息,请参阅 segment.h。

/sys/fs/f2fs/<disk>/last_age_weight

在文件 sysfs-fs-f2fs 中定义

当数据分离 (DATA SEPARATION) 开启时,它控制最后数据块年龄的权重。

/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 中定义

控制当没有丢弃操作要发出时,丢弃线程将等待的时间间隔。

/sys/fs/f2fs/<disk>/max_discard_request

在文件 sysfs-fs-f2fs 中定义

控制线程一次将发出的丢弃操作数量。数量越多,丢弃线程完成工作越快,但代价是传入 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 中定义

控制最大有序丢弃,单位大小为一个块(4KB)。默认设置为 16。

/sys/fs/f2fs/<disk>/max_read_extent_count

在文件 sysfs-fs-f2fs 中定义

它控制每个 inode 的最大读取 extent 计数,默认阈值为 10240。

/sys/fs/f2fs/<disk>/max_roll_forward_node_blocks

在文件 sysfs-fs-f2fs 中定义

控制用于前滚恢复的最大节点块写入数量。这可以限制前滚恢复时间。

/sys/fs/f2fs/<disk>/max_small_discards

在文件 sysfs-fs-f2fs 中定义

控制由小于 2MB 的小块组成的丢弃命令的发出速率。要丢弃的候选块在检查点期间被缓存,并在检查点后由 issue_discard 线程发出。默认情况下启用。

在文件 sysfs-fs-f2fs 中定义

控制在执行 SSR 和清理操作时查找受害者段的尝试次数。默认值为 4096,覆盖 8GB 的块地址范围。

/sys/fs/f2fs/<disk>/mid_discard_issue_time

在文件 sysfs-fs-f2fs 中定义

控制当有丢弃请求要发出且发生 I/O 感知中断时,丢弃线程在发出丢弃请求之间将等待的时间间隔。

/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 中定义

控制当有丢弃请求要发出且没有发生 I/O 感知中断时,丢弃线程在发出丢弃请求之间将等待的时间间隔。

/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 中定义

控制原地更新策略的文件系统利用率条件。它由 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,表示每 1 GB 内存对应 10 MB。

/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 建议选项的 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 中定义

设置卸载时发出discard命令的超时时间。默认值: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 中定义

当数据分离(DATA SEPARATION)开启时,它控制用于指示数据块为“温热”的年龄阈值。默认情况下,它被初始化为2621440块(等于10GB)。

/sys/fs/f2fs/features/

在文件 sysfs-fs-f2fs 中定义

显示所有已启用的内核特性。支持的特性:encryption(加密)、block_zoned(块分区)、extra_attr(额外属性)、project_quota(项目配额)、inode_checksum(inode校验和)、flexible_inline_xattr(弹性内联扩展属性)、quota_ino(配额inode)、inode_crtime(inode创建时间)、lost_found(丢失和找到)、verity(完整性验证)、sb_checksum(超级块校验和)、casefold(大小写折叠)、readonly(只读)、compression(压缩)、test_dummy_encryption_v2(测试虚拟加密v2)、atomic_write(原子写入)、pin_file(固定文件)、encrypted_casefold(加密大小写折叠)、linear_lookup(线性查找)。

/sys/fs/f2fs/tuning/reclaim_caches_kb

在文件 sysfs-fs-f2fs 中定义

它回收通过ioctl(F2FS_IOC_DONATE_RANGE)注册的指定KB的文件支持页。例如,写入N会尝试在LRU中释放N KB空间。

/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

/sys/fs/ocfs2/max_locking_protocol 文件显示文件系统支持的 ocfs2 锁定的版本。此版本涵盖 ocfs2 如何在集群节点之间使用分布式锁定。

协议版本有一个主版本号和一个次版本号。如果两个集群节点具有相同的主版本号和重叠的次版本号,则它们可以互操作——因此,版本为1.10的节点可以与版本为1.8的节点互操作,只要两者都使用1.8协议。

在文件sysfs-ocfs2中定义

从该文件读取会返回一行内容,主版本号和次版本号用点连接,例如“1.10”。

此文件是只读的。该值编译到驱动程序中。

/sys/fs/pstore/...

/dev/pstore/...

在文件pstore中定义

平台相关的持久存储通用接口。

提供跨系统重启保留某些数据机制的平台可以向此驱动程序注册,以提供通用接口来显示在系统崩溃前捕获的记录。在panic的情况下,会捕获控制台日志的最后一部分,但也可以保存其他有趣的数据。

此接口的不同用户将导致不同的文件名前缀。目前定义了两种:

“dmesg” - 保存的控制台日志

# 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

“mce” - 来自致命硬件错误的架构相关数据

  • 一旦文件中的信息被读取,删除文件将向底层持久存储设备发出信号,表示可以回收空间以备将来重用。

  • 期望 /sys/fs/pstore/ 中的所有文件在引导后不久会被保存到其他位置并从持久存储中擦除,以释放空间,为下一次灾难做准备。

“kmsg_bytes”挂载选项更改每次 oops/panic 时保存的目标数据量。Pstore 会根据底层持久存储的记录大小保存(可能多个)文件,直到至少达到此数量。默认值为10 Kbytes。

$ rm /sys/fs/pstore/dmesg-erst-1

Pstore一次只支持一个后端。如果可用多个后端,可以通过在引导时向内核传递 pstore.backend= 参数来设置首选后端。

/sys/fs/ubifsX_Y/error_crc

在文件sysfs-fs-ubifs中定义

暴露 CRC 错误:每个节点都嵌入一个 CRC 校验和。

此计数器跟踪访问 CRC 校验和错误的节点的次数。

重新挂载后计数器将重置为 0。

/sys/fs/ubifsX_Y/error_magic

暴露魔数错误:每个节点都以一个魔数开头。

此计数器跟踪访问魔数损坏的节点的次数。

此计数器跟踪访问 CRC 校验和错误的节点的次数。

/sys/fs/ubifsX_Y/error_node

暴露节点错误。每个节点都嵌入其类型。

暴露魔数错误:每个节点都以一个魔数开头。

此计数器跟踪访问节点类型损坏的节点的次数。

此计数器跟踪访问 CRC 校验和错误的节点的次数。

/sys/fs/virtiofs/<n>/device

在文件sysfs-fs-virtiofs中定义

暴露魔数错误:每个节点都以一个魔数开头。

指向导出此文件系统的 virtio 设备的符号链接。

/sys/fs/virtiofs/<n>/tag

[只读] 可用于挂载此文件系统的挂载“标签”。

/sys/fs/xfs/<disk>/log/log_head_lsn

/sys/fs/virtiofs/<n>/tag

在文件sysfs-fs-xfs中定义

日志当前头部的日志序列号(LSN)。LSN 以“cycle:basic block”格式导出。

xfstests

/sys/fs/xfs/<disk>/log/log_tail_lsn

用户

日志当前尾部的日志序列号(LSN)。LSN 以“cycle:basic block”格式导出。

/sys/fs/xfs/<disk>/log/reserve_grant_head_bytes

xfstests

日志保留授权头部的当前状态。它表示当前所有未完成事务的总日志保留量(以字节为单位)。

/sys/fs/xfs/<disk>/log/write_grant_head_bytes

xfstests

日志写入授权头部的当前状态。它表示当前所有未完成事务(包括由于滚动事务而重新授予的权限)的总日志保留量(以字节为单位)。

用户

日志当前尾部的日志序列号(LSN)。LSN 以“cycle:basic block”格式导出。

/sys/hypervisor下的符号

xfstests

/sys/hypervisor/guest_type

用户

日志当前尾部的日志序列号(LSN)。LSN 以“cycle:basic block”格式导出。

在文件sysfs-hypervisor-xen中定义

如果在Xen下运行:访客类型:“Xen”:arm上的标准访客类型;“HVM”:完全虚拟化访客 (x86);“PV”:半虚拟化访客 (x86);“PVH”:没有传统模拟的完全虚拟化访客 (x86)。

/sys/hypervisor/pmu/pmu_features

如果在Xen下运行:描述Xen PMU特性(整数形式)。设置的位表示相应特性已启用。有关可用特性的详细信息,请参阅 include/xen/interface/xenpmu.h

/sys/hypervisor/pmu/pmu_mode

/sys/hypervisor/pmu/pmu_features

如果在Xen下运行:描述Xen性能监控单元(PMU)使用的模式。接受的值为:

PMU 已禁用

/sys/hypervisor/pmu/pmu_features

“self”

“off”

访客可以分析自身

“hv”

访客可以分析自身,如果具有特权(例如dom0),还可以分析管理程序

“all”

访客可以分析自身、管理程序和所有其他访客。仅对特权访客可用。

/sys/hypervisor/properties/buildid

如果在 Xen 下运行:管理程序的构建 ID,用于管理程序实时修补。在管理程序中存在特殊安全设置的情况下,可能会返回“<denied>”。

/sys/kernel下的符号

/sys/hypervisor/pmu/pmu_features

/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/btf

在文件sysfs-kernel-btf中定义

/sys/kernel/boot_params
|__ data
|__ setup_data
|   |__ 0
|   |   |__ data
|   |   |__ type
|   |__ 1
|       |__ data
|       |__ type
|__ version
用户

Kexec

包含内核和内核模块的 BTF 类型信息及相关数据。

/sys/kernel/btf/<module-name>

只读二进制属性,将内核模块的 BTF 类型信息作为内核 BTF (/sys/kernel/btf/vmlinux) 的附加信息公开。

/sys/kernel/btf/vmlinux

/sys/kernel/btf/<module-name>

只读二进制属性,公开内核自身的 BTF 类型信息,并包含所有内部内核类型的描述。有关格式本身的详细描述,请参阅BPF 类型格式 (BTF)

/sys/kernel/config/most_<component>

/sys/kernel/btf/<module-name>

在文件configfs-most中定义

该接口用于配置设备通道并将其连接到组件驱动程序。

仅当configfs被挂载时,属性才可见。要将configfs挂载到/sys/kernel/config目录下,请使用:# mount -t configfs none /sys/kernel/config/

/sys/kernel/config/most_cdev/<link>

buffer_size

仅当configfs被挂载时,属性才可见。要将configfs挂载到/sys/kernel/config目录下,请使用:# mount -t configfs none /sys/kernel/config/

属性

subbuffer_size

配置此通道的子缓冲区大小(同步和等时数据需要)

配置此通道使用的缓冲区数量

datatype

num_buffers

配置将通过此通道传输的数据类型

配置此链接将是输入还是输出

dbr_size

direction

配置DBR数据缓冲区大小(仅用于MediaLB通信)

packets_per_xact

配置从网络收集并在通过USB传输前的数据包数量(仅用于USB通信)

device

链接要连接到的设备名称

channel

链接要连接到的通道名称

comp_params

传递某些组件所需的参数

create_link

向此属性写入“1”以触发链接的创建。在推测性配置的情况下,创建被推迟,直到物理设备连接到总线。

destroy_link

向此属性写入“1”以销毁活动链接

/sys/kernel/config/most_net/<link>

/sys/kernel/config/most_sound/<card>

仅当configfs被挂载时,属性才可见。要将configfs挂载到/sys/kernel/config目录下,请使用:# mount -t configfs none /sys/kernel/config/

属性

subbuffer_size

配置此通道的子缓冲区大小(同步和等时数据需要)

配置此通道使用的缓冲区数量

datatype

num_buffers

配置将通过此通道传输的数据类型

配置此链接将是输入还是输出

dbr_size

direction

配置DBR数据缓冲区大小(仅用于MediaLB通信)

packets_per_xact

配置从网络收集并在通过USB传输前的数据包数量(仅用于USB通信)

device

链接要连接到的设备名称

channel

链接要连接到的通道名称

comp_params

传递某些组件所需的参数

create_link

向此属性写入“1”以触发链接的创建。在推测性配置的情况下,创建被推迟,直到物理设备连接到总线。

destroy_link

向此属性写入“1”以销毁活动链接

/sys/kernel/config/most_net/<link>

/sys/kernel/config/most_sound/<card>

向此属性写入“1”以触发声卡在ALSA子系统中的注册。

仅当configfs被挂载时,属性才可见。要将configfs挂载到/sys/kernel/config目录下,请使用:# mount -t configfs none /sys/kernel/config/

属性

/sys/kernel/config/most_sound/<card>/<link>

/sys/kernel/config/most_video/<link>

仅当configfs被挂载时,属性才可见。要将configfs挂载到/sys/kernel/config目录下,请使用:# mount -t configfs none /sys/kernel/config/

属性

subbuffer_size

配置此通道的子缓冲区大小(同步和等时数据需要)

配置此通道使用的缓冲区数量

datatype

num_buffers

配置将通过此通道传输的数据类型

配置此链接将是输入还是输出

dbr_size

direction

配置DBR数据缓冲区大小(仅用于MediaLB通信)

packets_per_xact

配置从网络收集并在通过USB传输前的数据包数量(仅用于USB通信)

device

链接要连接到的设备名称

channel

链接要连接到的通道名称

comp_params

传递某些组件所需的参数

create_link

向此属性写入“1”以触发链接的创建。在推测性配置的情况下,创建被推迟,直到物理设备连接到总线。

destroy_link

向此属性写入“1”以销毁活动链接

/sys/kernel/config/most_net/<link>

/sys/kernel/config/most_sound/<card>

仅当configfs被挂载时,属性才可见。要将configfs挂载到/sys/kernel/config目录下,请使用:# mount -t configfs none /sys/kernel/config/

属性

subbuffer_size

配置此通道的子缓冲区大小(同步和等时数据需要)

配置此通道使用的缓冲区数量

datatype

num_buffers

配置将通过此通道传输的数据类型

配置此链接将是输入还是输出

dbr_size

direction

配置DBR数据缓冲区大小(仅用于MediaLB通信)

packets_per_xact

配置从网络收集并在通过USB传输前的数据包数量(仅用于USB通信)

device

链接要连接到的设备名称

channel

链接要连接到的通道名称

comp_params

传递某些组件所需的参数

create_link

向此属性写入“1”以触发链接的创建。在推测性配置的情况下,创建被推迟,直到物理设备连接到总线。

destroy_link

向此属性写入“1”以销毁活动链接

/sys/kernel/config/most_net/<link>

/sys/kernel/config/most_sound/<card>

(只读)TSM 可能发出的可选补充数据,此属性的可见性取决于 TSM,如果无辅助数据可用,则可能为空。

当@provider为“sev_guest”时,此文件包含SEV-ES客户机-虚拟机监控程序通信块标准化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

(只读)此属性中的值会在每次写入@inblob或任何选项时递增。用户空间可以通过在写入任何属性之前检查generation来检测冲突,并在读取@outblob之后确保写入次数与预期匹配,或者可以通过为每个请求上下文创建报告实例来防止冲突。

/sys/kernel/config/tsm/report/$name/inblob

当@provider为“sev_guest”时,此文件包含SEV-ES客户机-虚拟机监控程序通信块标准化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

(只写)多达64字节的用户指定二进制数据。为了防止重放攻击,这应该包含一个随机数,但内核对此内容不施加任何限制。

/sys/kernel/config/tsm/report/$name/manifestblob

当@provider为“sev_guest”时,此文件包含SEV-ES客户机-虚拟机监控程序通信块标准化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

(只读)TSM 可能发出的可选补充数据,此属性的可见性取决于 TSM,如果无清单数据可用,则可能为空。

有关清单 blob 格式的信息,请参阅“service_provider”。

当@provider为“sev_guest”时,此文件包含SEV-ES客户机-虚拟机监控程序通信块标准化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/outblob

(只读)由@inblob和其他选项生成的二进制证明报告。报告的格式是实现特定的,具体实现通过@provider属性传递。

/sys/kernel/config/tsm/report/$name/privlevel

当@provider为“sev_guest”时,此文件包含SEV-ES客户机-虚拟机监控程序通信块标准化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

(只写)如果TSM实现提供程序支持针对不同特权级别运行的TVM的证明报告概念,例如SEV-SNP“VMPL”,则此属性可见。通过此属性指定特权级别。可接受的最小值通过@privlevel_floor传递,最大可接受值是TSM_PRIVLEVEL_MAX(3)。

/sys/kernel/config/tsm/report/$name/privlevel_floor

当@provider为“sev_guest”时,此文件包含SEV-ES客户机-虚拟机监控程序通信块标准化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

(只读)指示可写入@privlevel的最小允许值。

/sys/kernel/config/tsm/report/$name/provider

当@provider为“sev_guest”时,此文件包含SEV-ES客户机-虚拟机监控程序通信块标准化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

(只读)@outblob 的格式规范名称,近期例如“sev_guest”[1]或“tdx_guest”[2],未来则可能是通用标准格式。

[1] SEV 安全嵌套分页固件 ABI 规范 修订版 1.55 表 22 https://www.amd.com/content/dam/amd/en/documents/epyc-technical-docs/specifications/56860.pdf

当@provider为“sev_guest”时,此文件包含SEV-ES客户机-虚拟机监控程序通信块标准化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

[2] Intel® 信任域扩展数据中心认证原语:Quote 生成库和 Quote 验证库 修订版 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

(只写)如果TSM实现提供程序支持TVM(例如在SVSM下运行的SEV-SNP)的服务提供商的证明报告概念,则此属性可见。指定一个空/null GUID(00000000-0000-0000-0000-000000)表示请求服务提供商中所有活动服务成为证明报告的一部分。指定一个GUID则请求仅包含指定服务的证明报告,使用service_manifest_version属性指定的清单格式。

有关服务 GUID 格式的信息,请参阅“service_provider”。

当@provider为“sev_guest”时,此文件包含SEV-ES客户机-虚拟机监控程序通信块标准化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/service_manifest_version

(只写)如果 TSM 实现提供商支持来自 TVM 服务提供商(例如在 SVSM 下运行的 SEV-SNP)的证明报告概念,则此属性可见。指示证明报告请求的服务清单版本(默认 0)。如果用户未设置此字段,则返回服务的默认清单版本(服务的初始/第一个清单版本)。

有关服务清单版本格式的信息,请参阅“service_provider”。

当@provider为“sev_guest”时,此文件包含SEV-ES客户机-虚拟机监控程序通信块标准化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/service_provider

(只写)如果 TSM 实现提供商支持来自 TVM 服务提供商(例如在 SVSM 下运行的 SEV-SNP)的证明报告概念,则此属性可见。通过此属性指定服务提供商将根据服务提供商的规范创建证明报告。目前唯一支持的服务提供商是“svsm”。

对于“svsm”服务提供商,请参阅适用于 SEV-SNP 访客的 Secure VM Service Module v1.00 第 7 节。要查找该文档,请搜索“site:amd.com “Secure VM Service Module for SEV-SNP Guests”,文档 ID:58019”

当@provider为“sev_guest”时,此文件包含SEV-ES客户机-虚拟机监控程序通信块标准化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/cpu_byteorder

在文件sysfs-kernel-cpu_byteorder中定义

运行中内核的字节序。

“little”(小端), “big”(大端)

/sys/kernel/debug/<cros-ec-device>/console_log

访问:只读

有效值:

在文件debugfs-cros-ec中定义

用户

在文件sysfs-kernel-boot_params中定义

如果 EC 支持 CONSOLE_READ 命令类型,此文件可用于获取 EC 日志。内核会轮询日志并保留自己的缓冲区,但用户空间应该获取此内容并将其写入日志。

/sys/kernel/debug/<cros-ec-device>/last_resume_result

某些 EC 具有一项功能,它们会跟踪到(Intel)处理器 SLP_S0 线的转换,以检测系统未能进入 S0ix 的情况。当系统恢复时,具有此功能的 EC 将返回 SLP_S0 转换的摘要。last_resume_result 文件返回 AP 的恢复消息到 EC 的最新响应。

底部31位包含自收到挂起消息以来发生的 SLP_S0 转换次数。如果 EC 在监视 SLP_S0 转换时因超时而尝试唤醒系统,则第31位被置位。调用者可以使用此来检测 EC 因 S0ix 超时而进行的唤醒。如果没有尝试挂起转换,或者 EC 不支持此功能,则结果将为零。

/sys/kernel/debug/<cros-ec-device>/last_resume_result

输出格式为:“0x%08xn”。

/sys/kernel/debug/<cros-ec-device>/panicinfo

此文件转储上次重启时 EC 的恐慌信息。此文件仅在 EC 支持 PANIC_INFO 命令类型时存在。

/sys/kernel/debug/<cros-ec-device>/pdinfo

/sys/kernel/debug/<cros-ec-device>/last_resume_result

此文件提供所有可用的 USB PD/Type-C 端口的端口角色、复用器和电源调试信息。如果没有可用的端口,此文件将只是一个空文件。

/sys/kernel/debug/<cros-ec-device>/suspend_timeout_ms

/sys/kernel/debug/<cros-ec-device>/last_resume_result

一些EC具有一项功能,它们会跟踪硬件控制的睡眠线(例如Intel的SLP_S0线)的转换,以检测系统未能进入深度睡眠状态的情况。suspend_timeout_ms文件控制EC在声明睡眠超时事件并尝试唤醒系统之前等待的时间(以毫秒为单位)。

提供 0 表示使用 EC 固件中编码的默认值。提供 65535 (EC_HOST_SLEEP_TIMEOUT_INFINITE) 表示禁用 EC 睡眠故障检测机制。介于 0 和 65535 之间的值表示 EC 在睡眠转换后应等待的毫秒数,然后才能声明超时。这包括收到睡眠命令但硬件线未改变之前的持续时间,以及硬件线改变到内核发送 EC 恢复命令之间的持续时间。

/sys/kernel/debug/<cros-ec-device>/last_resume_result

输出格式为:“%un”。

/sys/kernel/debug/<cros-ec-device>/uptime

一个 u32 值,提供 EC 启动以来的时间(毫秒)。这用于将 AP 主机时间与 EC 日志同步。如果 EC 不支持该命令或存在通信问题,则返回错误。

/sys/kernel/debug/accel/<parent_device>/addr

/sys/kernel/debug/<cros-ec-device>/last_resume_result

在文件debugfs-driver-habanalabs中定义

设置用于通过PCI BAR进行读写或主机映射内存的设备VA地址,以直接从主机进行读写。后一个选项仅在IOMMU被禁用时允许。可接受的值是“0x”开头的字符串

/sys/kernel/debug/accel/<parent_device>/clk_gate

此设置现已弃用,因为时钟门控完全由固件处理。

/sys/kernel/debug/accel/<parent_device>/command_buffers

/sys/kernel/debug/accel/<parent_device>/clk_gate

显示包含当前分配的命令缓冲区信息的列表

/sys/kernel/debug/accel/<parent_device>/command_submission

/sys/kernel/debug/accel/<parent_device>/clk_gate

显示包含当前活动命令提交信息的列表

/sys/kernel/debug/accel/<parent_device>/command_submission_jobs

/sys/kernel/debug/accel/<parent_device>/clk_gate

显示包含每个活动命令提交的每个作业(CB)详细信息的列表

/sys/kernel/debug/accel/<parent_device>/data32

/sys/kernel/debug/accel/<parent_device>/clk_gate

允许root用户直接通过设备的PCI BAR进行32位读写。写入此文件会生成写入事务,而读取此文件会生成读取事务。需要此自定义接口(而不是使用通用Linux用户空间PCI映射),因为DDR BAR相对于DDR内存非常小,只有驱动程序才能在事务前后移动BAR。

如果IOMMU被禁用,它还允许root用户从主机读取或写入主机映射内存的设备VA

/sys/kernel/debug/accel/<parent_device>/clk_gate

/sys/kernel/debug/accel/<parent_device>/data64

允许root用户直接通过设备的PCI BAR进行64位数据读写。写入此文件会生成写入事务,而读取此文件会生成读取事务。需要此自定义接口(而不是使用通用Linux用户空间PCI映射),因为DDR BAR相对于DDR内存非常小,只有驱动程序才能在事务前后移动BAR。

/sys/kernel/debug/accel/<parent_device>/data_dma

/sys/kernel/debug/accel/<parent_device>/clk_gate

允许root用户通过DMA引擎从设备的内部存储器(DRAM/SRAM)读取数据。此属性是一个二进制大对象,包含DMA传输的结果。需要此自定义接口(而不是使用通用Linux用户空间PCI映射),因为内部存储器容量巨大(>32GB),通过PCI BAR读取将花费很长时间。此接口不支持同一设备上的并发操作。在GAUDI和GOYA上,如果在设备执行用户工作负载时进行此操作,可能会导致未定义行为。目前仅在GAUDI上支持。

允许root用户直接通过设备的PCI BAR进行64位数据读写。写入此文件会生成写入事务,而读取此文件会生成读取事务。需要此自定义接口(而不是使用通用Linux用户空间PCI映射),因为DDR BAR相对于DDR内存非常小,只有驱动程序才能在事务前后移动BAR。

/sys/kernel/debug/accel/<parent_device>/device

/sys/kernel/debug/accel/<parent_device>/clk_gate

允许root用户将设备设置为特定状态。有效值为“disable”(禁用)、“enable”(启用)、“suspend”(挂起)、“resume”(恢复)。用户可以读取此属性以查看有效值。

/sys/kernel/debug/accel/<parent_device>/device_release_watchdog_timeout

/sys/kernel/debug/accel/<parent_device>/clk_gate

在某些错误情况下,设备释放的看门狗超时时间(秒),在此之后设备将被重置。

/sys/kernel/debug/accel/<parent_device>/dma_size

/sys/kernel/debug/accel/<parent_device>/clk_gate

指定使用DMA从设备内部存储器读取时的DMA传输大小。该值不能大于128MB。写入此值会启动DMA传输。写入完成后,用户可以读取“data_dma”blob。

/sys/kernel/debug/accel/<parent_device>/dump_razwi_events

/sys/kernel/debug/accel/<parent_device>/clk_gate

如果存在,将所有razwi事件转储到dmesg。读取现有事件的状态寄存器后,例程将清除状态寄存器。用法:cat dump_razwi_events

/sys/kernel/debug/accel/<parent_device>/dump_security_violations

/sys/kernel/debug/accel/<parent_device>/clk_gate

将所有安全违规转储到 dmesg。此操作还会确认所有安全违规,意味着下次用户调用此 API 时,这些违规将不再被转储。

/sys/kernel/debug/accel/<parent_device>/engines

/sys/kernel/debug/accel/<parent_device>/clk_gate

显示设备引擎的状态寄存器值及其派生的空闲状态

/sys/kernel/debug/accel/<parent_device>/i2c_addr

/sys/kernel/debug/accel/<parent_device>/clk_gate

设置由设备CPU生成的I2C事务的I2C设备地址,当设备加载安全固件时不可用

/sys/kernel/debug/accel/<parent_device>/i2c_bus

/sys/kernel/debug/accel/<parent_device>/clk_gate

设置由设备CPU生成的I2C事务的I2C总线地址,当设备加载安全固件时不可用

/sys/kernel/debug/accel/<parent_device>/i2c_data

/sys/kernel/debug/accel/<parent_device>/clk_gate

触发由设备CPU生成的I2C事务。写入此文件会生成写入事务,而读取此文件会生成读取事务,当设备加载安全固件时不可用

/sys/kernel/debug/accel/<parent_device>/i2c_len

/sys/kernel/debug/accel/<parent_device>/clk_gate

设置由设备CPU生成的I2C事务的I2C长度(以字节为单位),当设备加载安全固件时不可用

/sys/kernel/debug/accel/<parent_device>/i2c_reg

/sys/kernel/debug/accel/<parent_device>/clk_gate

设置由设备CPU生成的I2C事务的I2C寄存器ID,当设备加载安全固件时不可用

/sys/kernel/debug/accel/<parent_device>/led0

/sys/kernel/debug/accel/<parent_device>/clk_gate

设置设备上第一个S/W指示灯的状态,当设备加载安全固件时不可用

/sys/kernel/debug/accel/<parent_device>/led1

/sys/kernel/debug/accel/<parent_device>/clk_gate

设置设备上第二个S/W指示灯的状态,当设备加载安全固件时不可用

/sys/kernel/debug/accel/<parent_device>/led2

/sys/kernel/debug/accel/<parent_device>/clk_gate

设置设备上第三个S/W指示灯的状态,当设备加载安全固件时不可用

/sys/kernel/debug/accel/<parent_device>/memory_scrub

/sys/kernel/debug/accel/<parent_device>/clk_gate

允许root用户擦洗DRAM内存。擦洗值可以使用debugfs文件memory_scrub_val进行设置。

/sys/kernel/debug/accel/<parent_device>/memory_scrub_val

/sys/kernel/debug/accel/<parent_device>/clk_gate

当用户使用“memory_scrub”debugfs文件擦洗DRAM时,DRAM将被设置的值;以及使用模块参数“memory_scrub”时的擦洗值。

/sys/kernel/debug/accel/<parent_device>/mmu

/sys/kernel/debug/accel/<parent_device>/clk_gate

显示给定 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

/sys/kernel/debug/accel/<parent_device>/clk_gate

检查并显示 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

/sys/kernel/debug/accel/<parent_device>/clk_gate

允许 root 用户从设备的受保护配置空间转储监控器状态。此属性是一个二进制大对象,包含监控器寄存器转储的结果。需要此自定义接口(而不是使用通用 Linux 用户空间 PCI 映射),因为此空间受保护且无法通过 PCI 读取访问。此接口不支持同一设备上的并发操作。目前仅在 GAUDI 上支持。

/sys/kernel/debug/accel/<parent_device>/monitor_dump_trig

/sys/kernel/debug/accel/<parent_device>/clk_gate

触发监控器数据转储。触发操作的值必须为1。触发监控器转储操作会启动所有监控器当前寄存器值的转储。写入完成后,用户可以读取“monitor_dump”blob

/sys/kernel/debug/accel/<parent_device>/server_type

/sys/kernel/debug/accel/<parent_device>/clk_gate

公开设备的服务器类型,映射到枚举 hl_server_type。

/sys/kernel/debug/accel/<parent_device>/set_power_state

/sys/kernel/debug/accel/<parent_device>/clk_gate

设置PCI电源状态。有效值为D0的“1”和D3Hot的“2”

/sys/kernel/debug/accel/<parent_device>/set_power_state

/sys/kernel/debug/accel/<parent_device>/clk_gate

设置 PCI 电源状态。有效值为 “1” 表示 D0, “2” 表示 D3Hot

/sys/kernel/debug/accel/<parent_device>/skip_reset_on_timeout

/sys/kernel/debug/accel/<parent_device>/clk_gate

设置设备的超时跳过重置选项。值为“0”表示如果某个 CS 超时,设备将被重置,否则将不会被重置。

/sys/kernel/debug/accel/<parent_device>/state_dump

/sys/kernel/debug/accel/<parent_device>/clk_gate

获取 CS 超时或故障时发生的状态转储。状态转储用于调试,在 CS 执行出现问题时,重置之前,每次都会创建。从节点读取会返回最新的状态转储。写入整数 X 会丢弃 X 个状态转储,以便下次读取返回第 X+1 个最新的状态转储。

/sys/kernel/debug/accel/<parent_device>/stop_on_err

/sys/kernel/debug/accel/<parent_device>/clk_gate

设置设备引擎的“出错停止”选项。值为“0”表示禁用,否则表示启用。仅适用于 GOYA 和 GAUDI。

/sys/kernel/debug/accel/<parent_device>/timeout_locked

/sys/kernel/debug/accel/<parent_device>/clk_gate

设置命令提交超时值,单位为秒。

/sys/kernel/debug/accel/<parent_device>/userptr

/sys/kernel/debug/accel/<parent_device>/clk_gate

显示当前被锁定并映射到 DMA 地址的用户指针(用户虚拟地址)列表信息。

/sys/kernel/debug/accel/<parent_device>/userptr_lookup

/sys/kernel/debug/accel/<parent_device>/clk_gate

允许搜索被锁定并映射到 DMA 地址的特定用户指针(用户虚拟地址),并查看它们解析到的具体 DMA 地址。

/sys/kernel/debug/accel/<parent_device>/vm

/sys/kernel/debug/accel/<parent_device>/clk_gate

显示按 ASID 列出的所有活动虚拟地址映射以及所有硬件块的用户映射列表信息。

/sys/kernel/debug/alienware-wmi-<wmi_device_name>/gpio_ctl/pinX

定义于文件 debugfs-alienware-wmi

此文件控制 GPIO 引脚 X 的状态。

详情请参阅 Dell AWCC WMI 接口驱动程序 (alienware-wmi)

/sys/class/hwmon/hwmonX/currY_enable

/sys/kernel/debug/alienware-wmi-<wmi_device_name>/gpio_ctl/total_gpios

定义于文件 debugfs-alienware-wmi

设备报告的 GPIO 引脚总数。

并非总是正确。

/sys/kernel/debug/alienware-wmi-<wmi_device_name>/hwmon_data

定义于文件 debugfs-alienware-wmi

此文件公开 HWMON 私有数据。

包括风扇传感器计数、温度传感器计数、内部风扇 ID 和内部温度 ID。

0 到 255 范围内的整数值

并非总是正确。

/sys/kernel/debug/alienware-wmi-<wmi_device_name>/pprof_data

定义于文件 debugfs-alienware-wmi

此文件公开平台配置文件私有数据。

包括到平台配置文件和热管理配置文件 ID 的内部映射。

0 到 255 范围内的整数值

并非总是正确。

/sys/kernel/debug/alienware-wmi-<wmi_device_name>/system_description

定义于文件 debugfs-alienware-wmi

此文件公开 WMAX 设备报告的原始 system_description 号码。

仅存在于具有 AWCC 接口的设备上。

0 到 255 范围内的整数值

并非总是正确。

/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

(仅写) 向此文件写入一个整数会将相应的 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

(只读) 以以下格式打印平台提供的 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

(仅写) 当设备物理地址(DPA)写入此属性时,memdev 驱动程序会向设备发送指定地址的注入毒化命令。DPA 必须是 64 字节对齐的,注入毒化的长度为 64 字节。如果成功,当通过 CXL.mem 总线访问该地址时,设备会返回毒化数据。注入毒化会将地址添加到设备的毒化列表,并将错误源设置为“已注入”。此外,设备会向其内部信息事件日志添加一个毒化创建事件,更新事件状态寄存器,如果配置了,还会中断主机。向已存在毒化的地址注入毒化不是错误,也不会返回错误。如果设备返回“注入毒化限制已达到”,则会向用户返回 -EBUSY 错误。inject_poison 属性仅对支持该功能的设备可见。

/sys/kernel/debug/dcc/.../[list-number]/config

定义于文件 debugfs-driver-dcc

这存储了在硬件崩溃或手动软件触发时可读取的寄存器地址。输入地址类型可以是以下 dcc 指令之一:读取、写入、读写和循环类型。列表需要按顺序配置,而不是以重叠方式配置;例如,用户只能在列表 y 配置并启用后才能跳转到列表 x。每种类型的输入格式如下:

  1. 读取指令

    echo R <addr> <n> <bus> >/sys/kernel/debug/dcc/../[list-number]/config
    

    其中

    <addr>

    要读取的地址。

    <n>

    从地址 <1> 开始的地址字计数。每个字是 32 位(4 字节)。如果省略,默认为 1。

    <总线类型>

    总线类型,可以是“apb”或“ahb”。如果省略,默认为“ahb”。

  2. 写入指令

    echo W <addr> <n> <bus type> > /sys/kernel/debug/dcc/../[list-number]/config
    

    其中

    <addr>

    要写入的地址。

    <n>

    要写入 <addr> 的值。

    <总线类型>

    总线类型,可以是“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
    

    其中

    <循环次数>

    迭代次数

    <地址计数>

    要写入的地址总数

    <地址>

    以空格分隔的地址列表。

/sys/kernel/debug/dcc/.../[list-number]/enable

定义于文件 debugfs-driver-dcc

此 debugfs 接口用于启用 dcc 硬件。名为“enable”的文件位于目录列表编号中,用户可以通过向该文件写入布尔值(1 或 0)来启用/禁用特定列表。

启用 dcc 时,用户为相应列表指定的所有地址都将写入 dcc sram,dcc 硬件会在手动或崩溃触发时读取该 sram。列表必须按顺序配置和启用,例如,列表 2 只能在列表 1 已启用后才能启用。

/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(两字节,小端序)

有关详细信息,请参阅 Dell DDV WMI 接口驱动程序 (dell-wmi-ddv)

/sys/kernel/debug/dell-wmi-ddv-<wmi_device_name>/thermal_sensor_information

定义于文件 debugfs-dell-wmi-ddv

此文件包含热传感器信息缓冲区的内容,其中包括热传感器条目和终止字符 (0xFF)。

每个热传感器条目包含:

  • 热类型(单字节)

  • 当前温度(单字节)

  • 最低温度(单字节)

  • 最高温度(单字节)

  • 未知字段(单字节)

有关详细信息,请参阅 Dell DDV WMI 接口驱动程序 (dell-wmi-ddv)

/sys/kernel/debug/dwc_pcie_<dev>/ltssm_status

定义于文件 debugfs-dwc-pcie

(只读) 读取将以字符串和原始值两种形式返回当前的 PCIe LTSSM 状态。

/sys/kernel/debug/dwc_pcie_<dev>/rasdes_debug/lane_detect

定义于文件 debugfs-dwc-pcie

(读写) 写入要检查的通道号以进行检测。读取将返回 PHY 是否在选定通道上指示接收器检测。默认选定通道是 Lane0。

/sys/kernel/debug/dwc_pcie_<dev>/rasdes_debug/rx_valid

定义于文件 debugfs-dwc-pcie

(读写) 写入要检查为有效或无效的通道号。读取将返回选定通道的 PIPE RXVALID 信号状态。默认选定通道是 Lane0。

/sys/kernel/debug/dwc_pcie_<dev>/rasdes_err_inj/<error>

定义于文件 debugfs-dwc-pcie

“rasdes_err_inj”是一个目录,可用于向系统注入错误。可注入的错误有:

  1. tx_lcrc - TLP LCRC 错误注入 TX 路径

  2. b16_crc_dllp - ACK/NAK DLLP 的 16b CRC 错误注入

  3. b16_crc_upd_fc - Update-FC DLLP 的 16b CRC 错误注入

  4. tx_ecrc - TLP ECRC 错误注入 TX 路径

  5. fcrc_tlp - TLP 的 FCRC 错误注入 TX 路径

  6. parity_tsos - TSOS 的奇偶校验错误

  7. parity_skpos - SKPOS 的奇偶校验错误

  8. rx_lcrc - LCRC 错误注入 RX 路径

  9. rx_ecrc - ECRC 错误注入 RX 路径

  10. tlp_err_seq - TLP 序列号错误

  11. ack_nak_dllp_seq - DLLPS ACK/NAK 序列号错误

  12. ack_nak_dllp - ACK/NAK DLLP 传输块

  13. upd_fc_dllp - UpdateFC DLLP 传输块

  14. nak_dllp - NAK DLLP 始终传输

  15. inv_sync_hdr_sym - 反转 SYNC 头部

  16. com_pad_ts1 - COM/PAD TS1 顺序集

  17. com_pad_ts2 - COM/PAD TS2 顺序集

  18. com_fts - COM/FTS FTS 顺序集

  19. com_idl - COM/IDL E-空闲顺序集

  20. end_edb - END/EDB 符号

  21. stp_sdp - STP/SDP 符号

  22. com_skp - COM/SKP SKP 顺序集

  23. posted_tlp_hdr - Posted TLP 头部信用值控制

  24. non_post_tlp_hdr - Non-Posted TLP 头部信用值控制

  25. cmpl_tlp_hdr - Completion TLP 头部信用值控制

  26. posted_tlp_data - Posted TLP 数据信用值控制

  27. non_post_tlp_data - Non-Posted TLP 数据信用值控制

  28. cmpl_tlp_data - Completion TLP 数据信用值控制

  29. duplicate_tlp - 生成重复 TLP

  30. nullified_tlp - 生成空化 TLP

(仅写) 写入此属性将使控制器准备好在下一次数据传输中注入相应的错误。

写入所需的参数将按以下方式更改:

  • 错误 9 和 10 是序列错误。写入命令:

    echo <count> <diff> > /sys/kernel/debug/dwc_pcie_<dev>/rasdes_err_inj/<error>

    <count>

    要注入的错误数量

    <diff>

    要从自然序列号中添加或减去的差值,以生成序列错误。允许范围为 -4095 到 4095

  • 错误 23 到 28 是信用值错误插入。写入命令:

    echo <count> <diff> <vc> > /sys/kernel/debug/dwc_pcie_<dev>/rasdes_err_inj/<error>

    <count>

    要注入的错误数量

    <diff>

    要从 UpdateFC 信用值中添加或减去的差值。允许范围为 -4095 到 4095

    <vc>

    目标 VC 编号

  • 所有其他错误。写入命令:

    echo <count> > /sys/kernel/debug/dwc_pcie_<dev>/rasdes_err_inj/<error>

    <count>

    要注入的错误数量

/sys/kernel/debug/dwc_pcie_<dev>/rasdes_event_counters/<event>/counter_enable

定义于文件 debugfs-dwc-pcie

“rasdes_event_counters”是一个目录,可用于收集控制器中特定事件发生次数的统计数据。可能的事件列表有:

  1. EBUF 溢出

  2. EBUF 下溢

  3. 解码错误

  4. 运行偏差错误

  5. SKP OS 奇偶校验错误

  6. SYNC 头部错误

  7. Rx Valid 去断言

  8. CTL SKP OS 奇偶校验错误

  9. 第一重定时器奇偶校验错误

  10. 第二重定时器奇偶校验错误

  11. 裕度 CRC 和奇偶校验错误

  12. 检测 EI 推断

  13. 接收器错误

  14. RX 恢复请求

  15. N_FTS 超时

  16. 帧错误

  17. 去斜误差

  18. L0 中的帧错误

  19. 去斜未完成错误

  20. 坏 TLP

  21. LCRC 错误

  22. 坏 DLLP

  23. 重放号滚动

  24. 重放超时

  25. 接收 NAK DLLP

  26. 发送 NAK DLLP

  27. 重试 TLP

  28. FC 超时

  29. 毒化 TLP

  30. ECRC 错误

  31. 不支持的请求

  32. 完成器中止

  33. 完成超时

  34. EBUF SKP 添加

  35. EBUF SKP 删除

(读写) 写入 1 启用事件计数器,写入 0 禁用事件计数器。读取将返回计数器当前是启用还是禁用状态。计数器默认为禁用。

/sys/kernel/debug/dwc_pcie_<dev>/rasdes_event_counters/<event>/counter_value

定义于文件 debugfs-dwc-pcie

(只读) 读取将返回事件计数器的当前值。要重置计数器,应首先禁用计数器,然后使用“counter_enable”属性重新启用。

/sys/kernel/debug/dwc_pcie_<dev>/rasdes_event_counters/<event>/lane_select

定义于文件 debugfs-dwc-pcie

(读写) 事件列表中的某些事件是通道特定事件。这些包括事件 1 到 11,以及 34 和 35。写入您希望计数器启用、禁用或转储值的通道号。读取将返回当前选定的通道号。默认选择 Lane0。

/sys/kernel/debug/ec/*/{gpe,use_global_lock,io}

定义于文件 debugfs-ec

一般信息,例如哪个 GPE 分配给 EC 以及是否应使用全局锁。知道了 EC GPE,就可以在此处(XY -> 来自 /sys/kernel/debug/ec/*/gpe 的 GPE 编号):/sys/firmware/acpi/interrupts/gpeXY 查看与 EC 相关的硬件事件数量。

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 超时 250ms。测试可能需要 1000ms。使用 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> value > 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 - 启用中断入口缓存无效化延迟数据采样

接下来,读取 /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

此文件在 debugfs 中转储 Intel IOMMU DMA 重映射表,例如根表、上下文表、PASID 目录和 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

此文件转储中断重映射和中断发布(Interrupt posting)的表条目。

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

(只写)当一个设备物理地址(DPA)写入此属性时,memdev 驱动程序会向设备发送一个清除毒化命令,针对指定地址。清除毒化会将该地址从设备的毒化列表中移除,并从该地址开始的 64 字节写入 0(零)。从未设置毒化的地址清除毒化不是错误。如果设备无法从该地址清除毒化,则返回 -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/pcie_ptm_*/context_update

定义在文件 debugfs-pcie-ptm

(读写)控制 PTM 上下文更新模式。仅适用于端点控制器。

支持以下值:

  • auto = PTM 上下文每 10 毫秒自动更新触发

  • manual = PTM 上下文手动更新。向此文件写入“manual”会触发 PTM 上下文更新(默认)

    /sys/kernel/debug/pcie_ptm_*/context_valid

(读写)控制 PTM 上下文有效性(本地时钟计时)。仅适用于根复合控制器。如果根复合体进入低功耗模式或更改链路频率,硬件会使 PTM 上下文失效。

定义在文件 debugfs-pcie-ptm

0 = PTM 上下文无效(默认)

支持以下值:

  • 1 = PTM 上下文有效

  • /sys/kernel/debug/pcie_ptm_*/local_clock

(只读)PTM 本地时钟,单位纳秒。适用于根复合体和端点控制器。

定义在文件 debugfs-pcie-ptm

/sys/kernel/debug/pcie_ptm_*/master_clock

(只读)PTM 主时钟,单位纳秒。仅适用于端点控制器。

定义在文件 debugfs-pcie-ptm

/sys/kernel/debug/pcie_ptm_*/t1

(只读)PTM T1 时间戳,单位纳秒。仅适用于端点控制器。

定义在文件 debugfs-pcie-ptm

/sys/kernel/debug/pcie_ptm_*/t2

(只读)PTM T2 时间戳,单位纳秒。仅适用于根复合体控制器。

定义在文件 debugfs-pcie-ptm

/sys/kernel/debug/pcie_ptm_*/t3

(只读)PTM T3 时间戳,单位纳秒。仅适用于根复合体控制器。

定义在文件 debugfs-pcie-ptm

/sys/kernel/debug/pcie_ptm_*/t4

(只读)PTM T4 时间戳,单位纳秒。仅适用于端点控制器。

定义在文件 debugfs-pcie-ptm

/sys/kernel/debug/pktcdvd/pktcdvd[0-7]

定义在文件 debugfs-pktcdvd

pktcdvd 模块(数据包写入驱动程序)在 debugfs 中创建这些文件

/sys/kernel/debug/pktcdvd/pktcdvd[0-7]/

info

大量驱动程序统计信息和资料。

0444

/sys/kernel/debug/powerpc/memtrace

示例

cat /sys/kernel/debug/pktcdvd/pktcdvd0/info

定义在文件 ppc-memtrace

此文件夹包含硬件跟踪宏使用的相关 debugfs 文件。必须设置 CONFIG_PPC64_HARDWARE_TRACING。

/sys/kernel/debug/powerpc/memtrace/<node-id>

此目录包含从特定 NUMA 节点移除的内存信息。

此文件夹包含硬件跟踪宏使用的相关 debugfs 文件。必须设置 CONFIG_PPC64_HARDWARE_TRACING。

/sys/kernel/debug/powerpc/memtrace/<node-id>/size

这包含从节点移除的内存大小。

此文件夹包含硬件跟踪宏使用的相关 debugfs 文件。必须设置 CONFIG_PPC64_HARDWARE_TRACING。

/sys/kernel/debug/powerpc/memtrace/<node-id>/start

这包含移除内存的起始地址。

此文件夹包含硬件跟踪宏使用的相关 debugfs 文件。必须设置 CONFIG_PPC64_HARDWARE_TRACING。

/sys/kernel/debug/powerpc/memtrace/<node-id>/trace

这是硬件跟踪宏输出其生成跟踪的位置。

此文件夹包含硬件跟踪宏使用的相关 debugfs 文件。必须设置 CONFIG_PPC64_HARDWARE_TRACING。

/sys/kernel/debug/powerpc/memtrace/enable

向此文件写入一个整数,其中包含要从每个 NUMA 节点中移除的内存大小(以字节为单位)——它必须与 memblock 大小对齐。这将从内核映射中的每个 NUMA 节点移除等量的 RAM,并创建以下 debugfs 文件。一旦内存成功从每个节点移除,将创建以下文件。要将内存重新添加到内核,请向此文件写入 0(它将自动上线)。

此文件夹包含硬件跟踪宏使用的相关 debugfs 文件。必须设置 CONFIG_PPC64_HARDWARE_TRACING。

/sys/kernel/debug/qat_<device>_<BDF>/cnv_errors

定义在文件 debugfs-driver-qat

(只读)读取返回,对于每个加速引擎(AE),设备在执行验证压缩时检测到的错误数量和上次错误的类型。报告的计数器

/sys/kernel/debug/qat_<device>_<BDF>/fw_counters

<N>: Number of Compress and Verify (CnV) errors and type
     of the last CnV error detected by Acceleration
     Engine N.

(只读)读取返回发送到 FW 的请求数量和从 FW 接收的响应数量,针对每个加速引擎报告的固件计数器。

(只读)读取返回,对于每个加速引擎(AE),设备在执行验证压缩时检测到的错误数量和上次错误的类型。报告的计数器

/sys/kernel/debug/qat_<device>_<BDF>/heartbeat/config

<N>: Number of requests sent from Acceleration Engine N to FW and responses
     Acceleration Engine N received from FW

(读写)读取返回心跳更新周期值。写入文件会更改此周期值。

(只读)读取返回,对于每个加速引擎(AE),设备在执行验证压缩时检测到的错误数量和上次错误的类型。报告的计数器

此周期应反映设备健康状态的计划轮询间隔。高频率心跳监控会浪费 CPU 周期,但可最大程度地减少客户的系统停机时间。此外,如果存在需要一些时间才能完成的大型服务请求,高频率心跳监控可能导致不响应的错误报告,在这种情况下,需要增加周期。

此参数仅对 c3xxx、c62x、dh895xcc 设备有效。4xxx 的此值内部固定为 200 毫秒。

默认值设置为 500。允许的最小值为 200。所有值均以毫秒表示。

/sys/kernel/debug/qat_<device>_<BDF>/heartbeat/inject_error

(只写)写入以注入模拟心跳故障的错误。这用于测试目的。

(只读)读取返回,对于每个加速引擎(AE),设备在执行验证压缩时检测到的错误数量和上次错误的类型。报告的计数器

写入此文件后,驱动程序会停止对随机引擎的仲裁,并禁用心跳计数器的获取。如果设备上正在运行工作负载,提交到加速器的工作可能得不到响应,并且读取 heartbeat/status 属性可能会报告 -1,即设备无响应。此错误不可恢复,因此必须重启设备以恢复其功能。

此属性仅当内核使用 CONFIG_CRYPTO_DEV_QAT_ERROR_INJECTION=y 构建时才可用。

写入 1 启用错误注入。

以下示例展示如何启用错误注入

/sys/kernel/debug/qat_<device>_<BDF>/heartbeat/queries_failed

# cd /sys/kernel/debug/qat_<device>_<BDF>
# echo 1 > heartbeat/inject_error

(只读)读取返回设备无响应的次数。

(只读)读取返回,对于每个加速引擎(AE),设备在执行验证压缩时检测到的错误数量和上次错误的类型。报告的计数器

属性返回计数器的值,当状态查询结果为负时,此计数器会递增。

/sys/kernel/debug/qat_<device>_<BDF>/heartbeat/queries_sent

(只读)读取返回控制进程检查设备是否响应的次数。

(只读)读取返回,对于每个加速引擎(AE),设备在执行验证压缩时检测到的错误数量和上次错误的类型。报告的计数器

属性返回计数器的值,每次状态查询时,此计数器都会递增。

/sys/kernel/debug/qat_<device>_<BDF>/heartbeat/status

(只读)读取返回设备健康状态。

(只读)读取返回,对于每个加速引擎(AE),设备在执行验证压缩时检测到的错误数量和上次错误的类型。报告的计数器

设备健康时返回 0,无响应或查询发送失败时返回 -1。

驱动程序不监控心跳。它留给用户定期轮询状态。

/sys/kernel/debug/qat_<device>_<BDF>/pm_status

(只读)读取返回 QAT 设备特有的电源管理信息。

(只读)读取返回,对于每个加速引擎(AE),设备在执行验证压缩时检测到的错误数量和上次错误的类型。报告的计数器

/sys/kernel/debug/qat_<device>_<BDF>/telemetry/control

此属性仅适用于 qat_4xxx 设备。

定义在文件 debugfs-driver-qat_telemetry

(读写)启用/禁用遥测指标报告。

允许写入的值

0:禁用遥测

  • 1:启用遥测

  • 2、3、4:启用遥测并计算每个计数器在 2、3 或 4 个样本上的最小值、最大值和平均值

  • 返回值

1-4:遥测已启用并运行

  • 0:遥测已禁用

  • 示例。

向此文件写入“3”会开始收集遥测指标。每秒收集样本并存储在大小为 3 的循环缓冲区中。然后这些值用于计算每个计数器的最小值、最大值和平均值。启用后,可以通过 device_data 文件检索计数器

向此文件写入“0”会停止收集遥测指标

echo 3 > /sys/kernel/debug/qat_4xxx_0000:6b:00.0/telemetry/control

/sys/kernel/debug/qat_<device>_<BDF>/telemetry/device_data

echo 0 > /sys/kernel/debug/qat_4xxx_0000:6b:00.0/telemetry/control

此属性仅适用于 qat_4xxx 设备。

(只读)报告设备遥测计数器。读取报告有关 QAT 设备的性能和利用率的指标

(读写)启用/禁用遥测指标报告。

sample_cnt

字段

描述

从设备获取遥测数据的次数。每 1000 毫秒执行一次读取。

pci_trans_cnt

PCIe 部分事务计数

max_rd_lat

最大记录读取延迟 [ns](可以是任何读取操作)

rd_lat_acc_avg

平均读取延迟 [ns]

max_gp_lat

最大 get-to-put 延迟 [ns](仅对 AE0 采样)

gp_lat_acc_avg

平均 get-to-put 延迟 [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 的执行计数

遥测报告文件可以通过以下命令读取

如果 control 设置为 1,则仅显示计数器的当前值

cat /sys/kernel/debug/qat_4xxx_0000:6b:00.0/telemetry/device_data

如果 control 为 2、3 或 4,则计数器以以下格式显示

<counter_name> <current>

如果设备缺少特定的加速器,则不报告相应的属性。

<counter_name> <current> <min> <max> <avg>

/sys/kernel/debug/qat_<device>_<BDF>/telemetry/rp_<A/B/C/D>_data

此属性仅适用于 qat_4xxx 设备。

(读写)选择最多 4 个环对(RP)进行监控,每个文件一个,并报告与每个环对相关的遥测计数器。

(读写)启用/禁用遥测指标报告。

0 到 <num_rps - 1>:要监控的环对。num_rps 的值可以通过 /sys/bus/pci/devices/<BDF>/qat/num_rps 检索。详情请参见 testing/sysfs-driver-qat

0:禁用遥测

  • 读取报告所选 RP 的性能和利用率指标

从设备获取遥测数据的次数。每 1000 毫秒执行一次读取

字段

描述

从设备获取遥测数据的次数。每 1000 毫秒执行一次读取。

rp_num

与插槽 <A/B/C/D> 关联的 RP 编号

service_type

与 RP 关联的服务

at_glob_devtlb_hit

PCIe 部分事务计数

max_rd_lat

平均 get-to-put 延迟 [ns]

bw_in

PCIe,写入带宽 [Mbps]

bw_out

PCIe,读取带宽 [Mbps]

at_page_req_lat_avg

消息描述符 DevTLB 命中率

at_glob_devtlb_miss

消息描述符 DevTLB 未命中率

tl_at_payld_devtlb_hit

有效载荷 DevTLB 命中率

tl_at_payld_devtlb_miss

有效载荷 DevTLB 未命中率

向文件 rp_C_data 写入值“32”会开始收集环对 32 的遥测指标

向此文件写入“3”会开始收集遥测指标。每秒收集样本并存储在大小为 3 的循环缓冲区中。然后这些值用于计算每个计数器的最小值、最大值和平均值。启用后,可以通过 device_data 文件检索计数器

一旦选择了环对,可以通过访问文件读取统计信息

echo 32 > /sys/kernel/debug/qat_4xxx_0000:6b:00.0/telemetry/rp_C_data

在 QAT GEN4 设备上,一个 PF 有 64 个 RP,因此允许的值是 0..63。此数字对设备是绝对的。如果使用虚拟功能(VF),环对编号可以从 VF 的总线、设备、功能中得出

cat /sys/kernel/debug/qat_4xxx_0000:6b:00.0/telemetry/rp_C_data

如果 control 为 2、3 或 4,则计数器以以下格式显示

<counter_name> <current>

如果设备缺少特定的加速器,则不报告相应的属性。

<counter_name> <current> <min> <max> <avg>

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

下表报告了 PF 0000:6b:0.0 配置为 sym;asymasym;sym 时,环对如何映射到 VF。

RP0/服务

RP0

RP1/服务

RP2/服务

RP3/服务

RP 0 asym

RP 0

RP 1 sym

RP 2 asym

RP 3 sym

RP 4 asym

RP 4

RP 5 sym

RP 6 asym

RP 7 sym

RP 8 asym

RP 8

RP 9 sym

RP10 asym

RP11 sym

所有 VF 都遵循相同的模式。

...

...

...

...

...

下表报告了 PF 0000:6b:0.0 配置为 dc 时,环对如何映射到 VF。

RP 0 dc

RP0

RP1/服务

RP2/服务

RP3/服务

RP 0 asym

RP 0

RP 1 dc

RP 2 dc

RP 3 dc

RP 4 dc

RP 4

RP 5 dc

RP 6 dc

RP 7 dc

RP 8 dc

RP 8

RP 9 dc

RP10 dc

RP11 dc

RP 到服务的映射可以使用 sysfs 中的 rp2srv 检索。详情请参见 testing/sysfs-driver-qat

...

...

...

...

...

/sys/kernel/debug/scmi/<n>/atomic_threshold_us

此属性仅适用于 qat_4xxx 设备。

定义在文件 debugfs-scmi

一个可选的时间值,以微秒表示,表示在此 SCMI 实例 上,任何 SCMI 命令(即使已请求且其执行延迟声称高于此阈值)不应被视为原子操作模式的阈值。

调试,任何用户空间测试套件

用户

/sys/kernel/debug/scmi/<n>/instance_name

由 /sys/kernel/debug/scmi/ 下的所有 debugfs 访问器描述的基础 SCMI 实例 的名称,表示为该 SCMI 实例所根植的顶级 DT SCMI 节点的完整名称。

一个可选的时间值,以微秒表示,表示在此 SCMI 实例 上,任何 SCMI 命令(即使已请求且其执行延迟声称高于此阈值)不应被视为原子操作模式的阈值。

/sys/kernel/debug/scmi/<n>/raw/channels/<m>/message

用户

/sys/kernel/debug/scmi/<n>/instance_name

定义在文件 debugfs-scmi-raw

SCMI 原始同步消息注入/窥探功能;以小端二进制格式写入一个完整的 SCMI 同步命令消息(包含头),使其通过 <m> 传输通道发送到为实例 配置的后端 SCMI 服务器。如果后续接收到的响应在配置的超时时间内通过通道 <m> 到达,则可以从同一个条目读取该响应。每次写入该条目都会导致构建并发送一个命令请求,而回复则逐条消息读取(在每个消息边界接收到一个 EOF)。通道标识符 <m> 与在 DT 描述中与此传输通道关联的 SCMI 协议号匹配,其中基本协议号 0x10 是此实例的默认通道。请注意,这些根植于 <..>/channels 的每个通道条目仅当传输配置为具有多个默认通道时才存在。

/sys/kernel/debug/scmi/<n>/raw/channels/<m>/message_async

用户

/sys/kernel/debug/scmi/<n>/instance_name

SCMI 原始异步消息注入/窥探功能;以小端二进制格式写入一个完整的 SCMI 异步命令消息(包含头),使其通过 <m> 传输通道发送到为实例 配置的后端 SCMI 服务器。如果后续接收到的响应在配置的超时时间内通过通道 <m> 到达,则可以从同一个条目读取该响应。任何后续收到的额外延迟响应,如果在配置的超时时间内到达,也可以从同一个条目读取。每次写入该条目都会导致构建并发送一个命令请求,而回复则逐条消息读取(在每个消息边界接收到一个 EOF)。通道标识符 <m> 与在 DT 描述中与此传输通道关联的 SCMI 协议号匹配,其中基本协议号 0x10 是此实例的默认通道。请注意,这些根植于 <..>/channels 的每个通道条目仅当传输配置为具有多个默认通道时才存在。

SCMI 原始同步消息注入/窥探功能;以小端二进制格式写入一个完整的 SCMI 同步命令消息(包含头),使其通过 <m> 传输通道发送到为实例 配置的后端 SCMI 服务器。如果后续接收到的响应在配置的超时时间内通过通道 <m> 到达,则可以从同一个条目读取该响应。每次写入该条目都会导致构建并发送一个命令请求,而回复则逐条消息读取(在每个消息边界接收到一个 EOF)。通道标识符 <m> 与在 DT 描述中与此传输通道关联的 SCMI 协议号匹配,其中基本协议号 0x10 是此实例的默认通道。请注意,这些根植于 <..>/channels 的每个通道条目仅当传输配置为具有多个默认通道时才存在。

/sys/kernel/debug/scmi/<n>/raw/channels/<m>/message_poll

用户

/sys/kernel/debug/scmi/<n>/instance_name

使用轮询模式的 SCMI 原始消息注入/窥探功能;以小端二进制格式写入一个完整的 SCMI 命令消息(包含头),使其通过 <m> 传输通道发送到为实例 配置的后端 SCMI 服务器,并在接收路径上使用轮询模式。(如果传输支持轮询)如果后续接收到的响应在配置的超时时间内通过通道 <m> 到达,则可以从同一个条目读取该响应。每次写入该条目都会导致构建并发送一个命令请求,而回复则逐条消息读取(在每个消息边界接收到一个 EOF)。通道标识符 <m> 与在 DT 描述中与此传输通道关联的 SCMI 协议号匹配,其中基本协议号 0x10 是此实例的默认通道。请注意,这些根植于 <..>/channels 的每个通道条目仅当传输配置为具有多个默认通道时才存在。

SCMI 原始同步消息注入/窥探功能;以小端二进制格式写入一个完整的 SCMI 同步命令消息(包含头),使其通过 <m> 传输通道发送到为实例 配置的后端 SCMI 服务器。如果后续接收到的响应在配置的超时时间内通过通道 <m> 到达,则可以从同一个条目读取该响应。每次写入该条目都会导致构建并发送一个命令请求,而回复则逐条消息读取(在每个消息边界接收到一个 EOF)。通道标识符 <m> 与在 DT 描述中与此传输通道关联的 SCMI 协议号匹配,其中基本协议号 0x10 是此实例的默认通道。请注意,这些根植于 <..>/channels 的每个通道条目仅当传输配置为具有多个默认通道时才存在。

/sys/kernel/debug/scmi/<n>/raw/channels/<m>/message_poll_async

用户

/sys/kernel/debug/scmi/<n>/instance_name

使用轮询模式的 SCMI 原始异步消息注入/窥探功能;以小端二进制格式写入一个完整的 SCMI 异步命令消息(包含头),使其通过 <m> 传输通道发送到为实例 配置的后端 SCMI 服务器,并在异步命令即时部分的接收路径上使用轮询模式。(如果传输支持轮询)如果后续接收到的响应在配置的超时时间内通过通道 <m> 到达,则可以从同一个条目读取该响应。任何后续收到的额外延迟响应,如果在配置的超时时间内到达,也可以从同一个条目读取。每次写入该条目都会导致构建并发送一个命令请求,而回复则逐条消息读取(在每个消息边界接收到一个 EOF)。通道标识符 <m> 与在 DT 描述中与此传输通道关联的 SCMI 协议号匹配,其中基本协议号 0x10 是此实例的默认通道。请注意,这些根植于 <..>/channels 的每个通道条目仅当传输配置为具有多个默认通道时才存在。

SCMI 原始同步消息注入/窥探功能;以小端二进制格式写入一个完整的 SCMI 同步命令消息(包含头),使其通过 <m> 传输通道发送到为实例 配置的后端 SCMI 服务器。如果后续接收到的响应在配置的超时时间内通过通道 <m> 到达,则可以从同一个条目读取该响应。每次写入该条目都会导致构建并发送一个命令请求,而回复则逐条消息读取(在每个消息边界接收到一个 EOF)。通道标识符 <m> 与在 DT 描述中与此传输通道关联的 SCMI 协议号匹配,其中基本协议号 0x10 是此实例的默认通道。请注意,这些根植于 <..>/channels 的每个通道条目仅当传输配置为具有多个默认通道时才存在。

/sys/kernel/debug/scmi/<n>/raw/errors

用户

/sys/kernel/debug/scmi/<n>/instance_name

SCMI 原始消息错误功能;任何类型的超时或通常意外接收的 SCMI 消息,例如实例 的消息,都可以从该条目读取。每次读取都会返回一条消息(在每个消息边界接收到一个 EOF)。

SCMI 原始同步消息注入/窥探功能;以小端二进制格式写入一个完整的 SCMI 同步命令消息(包含头),使其通过 <m> 传输通道发送到为实例 配置的后端 SCMI 服务器。如果后续接收到的响应在配置的超时时间内通过通道 <m> 到达,则可以从同一个条目读取该响应。每次写入该条目都会导致构建并发送一个命令请求,而回复则逐条消息读取(在每个消息边界接收到一个 EOF)。通道标识符 <m> 与在 DT 描述中与此传输通道关联的 SCMI 协议号匹配,其中基本协议号 0x10 是此实例的默认通道。请注意,这些根植于 <..>/channels 的每个通道条目仅当传输配置为具有多个默认通道时才存在。

/sys/kernel/debug/scmi/<n>/raw/message

用户

/sys/kernel/debug/scmi/<n>/instance_name

/sys/kernel/debug/scmi/<n>/raw/message

SCMI 原始同步消息注入/窥探功能;以小端二进制格式写入一个完整的 SCMI 同步命令消息(包含头),使其通过 <m> 传输通道发送到为实例 配置的后端 SCMI 服务器。如果后续接收到的响应在配置的超时时间内通过通道 <m> 到达,则可以从同一个条目读取该响应。每次写入该条目都会导致构建并发送一个命令请求,而回复则逐条消息读取(在每个消息边界接收到一个 EOF)。通道标识符 <m> 与在 DT 描述中与此传输通道关联的 SCMI 协议号匹配,其中基本协议号 0x10 是此实例的默认通道。请注意,这些根植于 <..>/channels 的每个通道条目仅当传输配置为具有多个默认通道时才存在。

SCMI 原始同步消息注入/窥探功能;以小端二进制格式写入完整的 SCMI 同步命令消息(包含头部),以便将其发送到实例 <n> 配置的后端 SCMI 服务器。如果后续收到的响应在配置的超时时间内到达,则可以从该同一条目中读取。每次写入该条目都会导致构建并发送一个命令请求,而回复则一次读取一条消息(在每个消息边界接收到一个 EOF)。

用户

/sys/kernel/debug/scmi/<n>/instance_name

/sys/kernel/debug/scmi/<n>/raw/message_async

SCMI 原始同步消息注入/窥探功能;以小端二进制格式写入一个完整的 SCMI 同步命令消息(包含头),使其通过 <m> 传输通道发送到为实例 配置的后端 SCMI 服务器。如果后续接收到的响应在配置的超时时间内通过通道 <m> 到达,则可以从同一个条目读取该响应。每次写入该条目都会导致构建并发送一个命令请求,而回复则逐条消息读取(在每个消息边界接收到一个 EOF)。通道标识符 <m> 与在 DT 描述中与此传输通道关联的 SCMI 协议号匹配,其中基本协议号 0x10 是此实例的默认通道。请注意,这些根植于 <..>/channels 的每个通道条目仅当传输配置为具有多个默认通道时才存在。

SCMI 原始异步消息注入/窥探功能;以小端二进制格式写入完整的 SCMI 异步命令消息(包含头部),以便将其发送到实例 <n> 配置的后端 SCMI 服务器。如果后续收到的响应在配置的超时时间内到达,则可以从该同一条目中读取。如果之后收到任何额外的延迟响应在配置的超时时间内到达,也可以从该同一条目中读取。每次写入该条目都会导致构建并发送一个命令请求,而回复则一次读取一条消息(在每个消息边界接收到一个 EOF)。

用户

/sys/kernel/debug/scmi/<n>/instance_name

/sys/kernel/debug/scmi/<n>/raw/message_poll

SCMI 原始同步消息注入/窥探功能;以小端二进制格式写入一个完整的 SCMI 同步命令消息(包含头),使其通过 <m> 传输通道发送到为实例 配置的后端 SCMI 服务器。如果后续接收到的响应在配置的超时时间内通过通道 <m> 到达,则可以从同一个条目读取该响应。每次写入该条目都会导致构建并发送一个命令请求,而回复则逐条消息读取(在每个消息边界接收到一个 EOF)。通道标识符 <m> 与在 DT 描述中与此传输通道关联的 SCMI 协议号匹配,其中基本协议号 0x10 是此实例的默认通道。请注意,这些根植于 <..>/channels 的每个通道条目仅当传输配置为具有多个默认通道时才存在。

SCMI 原始消息注入/窥探功能(使用轮询模式);以小端二进制格式写入完整的 SCMI 命令消息(包含头部),以便将其发送到实例 <n> 配置的后端 SCMI 服务器,并在接收路径上使用轮询模式。(如果传输支持轮询)如果后续收到的响应在配置的超时时间内到达,则可以从该同一条目中读取。每次写入该条目都会导致构建并发送一个命令请求,而回复则一次读取一条消息(在每个消息边界接收到一个 EOF)。

用户

/sys/kernel/debug/scmi/<n>/instance_name

/sys/kernel/debug/scmi/<n>/raw/message_poll_async

SCMI 原始同步消息注入/窥探功能;以小端二进制格式写入一个完整的 SCMI 同步命令消息(包含头),使其通过 <m> 传输通道发送到为实例 配置的后端 SCMI 服务器。如果后续接收到的响应在配置的超时时间内通过通道 <m> 到达,则可以从同一个条目读取该响应。每次写入该条目都会导致构建并发送一个命令请求,而回复则逐条消息读取(在每个消息边界接收到一个 EOF)。通道标识符 <m> 与在 DT 描述中与此传输通道关联的 SCMI 协议号匹配,其中基本协议号 0x10 是此实例的默认通道。请注意,这些根植于 <..>/channels 的每个通道条目仅当传输配置为具有多个默认通道时才存在。

SCMI 原始异步消息注入/窥探功能(使用轮询模式);以小端二进制格式写入完整的 SCMI 异步命令消息(包含头部),以便将其发送到实例 <n> 配置的后端 SCMI 服务器,并在异步命令的即时部分的接收路径上使用轮询模式。(如果传输支持轮询)如果后续收到的响应在配置的超时时间内到达,则可以从该同一条目中读取。如果之后收到任何额外的延迟响应在配置的超时时间内到达,也可以从该同一条目中读取。每次写入该条目都会导致构建并发送一个命令请求,而回复则一次读取一条消息(在每个消息边界接收到一个 EOF)。

用户

/sys/kernel/debug/scmi/<n>/instance_name

/sys/kernel/debug/scmi/<n>/raw/notification

SCMI 原始同步消息注入/窥探功能;以小端二进制格式写入一个完整的 SCMI 同步命令消息(包含头),使其通过 <m> 传输通道发送到为实例 配置的后端 SCMI 服务器。如果后续接收到的响应在配置的超时时间内通过通道 <m> 到达,则可以从同一个条目读取该响应。每次写入该条目都会导致构建并发送一个命令请求,而回复则逐条消息读取(在每个消息边界接收到一个 EOF)。通道标识符 <m> 与在 DT 描述中与此传输通道关联的 SCMI 协议号匹配,其中基本协议号 0x10 是此实例的默认通道。请注意,这些根植于 <..>/channels 的每个通道条目仅当传输配置为具有多个默认通道时才存在。

SCMI 原始通知窥探功能;实例 <n> 的后端 SCMI 服务器发出的任何通知都可以从该条目中读取。每次读取都会返回一条消息(在每个消息边界接收到一个 EOF)。

用户

/sys/kernel/debug/scmi/<n>/instance_name

/sys/kernel/debug/scmi/<n>/raw/reset

SCMI 原始同步消息注入/窥探功能;以小端二进制格式写入一个完整的 SCMI 同步命令消息(包含头),使其通过 <m> 传输通道发送到为实例 配置的后端 SCMI 服务器。如果后续接收到的响应在配置的超时时间内通过通道 <m> 到达,则可以从同一个条目读取该响应。每次写入该条目都会导致构建并发送一个命令请求,而回复则逐条消息读取(在每个消息边界接收到一个 EOF)。通道标识符 <m> 与在 DT 描述中与此传输通道关联的 SCMI 协议号匹配,其中基本协议号 0x10 是此实例的默认通道。请注意,这些根植于 <..>/channels 的每个通道条目仅当传输配置为具有多个默认通道时才存在。

SCMI 原始堆栈复位功能;向此条目写入一个值会导致实例 <n> 的任何类型已接收消息(仍待读取)的内部队列立即被清空。可用于在两次不同的测试运行之间重置和清理 SCMI 原始堆栈。

用户

/sys/kernel/debug/scmi/<n>/instance_name

/sys/kernel/debug/scmi/<n>/transport/is_atomic

一个可选的时间值,以微秒表示,表示在此 SCMI 实例 上,任何 SCMI 命令(即使已请求且其执行延迟声称高于此阈值)不应被视为原子操作模式的阈值。

一个布尔值,表示底层 SCMI 实例 <n> 上配置的传输是否支持原子操作模式。

用户

/sys/kernel/debug/scmi/<n>/instance_name

/sys/kernel/debug/scmi/<n>/transport/max_msg_size

一个可选的时间值,以微秒表示,表示在此 SCMI 实例 上,任何 SCMI 命令(即使已请求且其执行延迟声称高于此阈值)不应被视为原子操作模式的阈值。

实例 <n> 当前配置的 SCMI 传输允许的最大 SCMI 消息大小。

用户

/sys/kernel/debug/scmi/<n>/instance_name

/sys/kernel/debug/scmi/<n>/transport/max_rx_timeout_ms

一个可选的时间值,以微秒表示,表示在此 SCMI 实例 上,任何 SCMI 命令(即使已请求且其执行延迟声称高于此阈值)不应被视为原子操作模式的阈值。

实例 <n> 当前配置的 SCMI 传输允许 SCMI 同步回复的超时时间(毫秒)。

用户

/sys/kernel/debug/scmi/<n>/instance_name

/sys/kernel/debug/scmi/<n>/transport/rx_max_msg

一个可选的时间值,以微秒表示,表示在此 SCMI 实例 上,任何 SCMI 命令(即使已请求且其执行延迟声称高于此阈值)不应被视为原子操作模式的阈值。

实例 <n> 当前配置的 SCMI 传输在接收 (RX) 通道上允许同时处理的最大 SCMI 消息数量。

用户

/sys/kernel/debug/scmi/<n>/instance_name

/sys/kernel/debug/scmi/<n>/transport/tx_max_msg

一个可选的时间值,以微秒表示,表示在此 SCMI 实例 上,任何 SCMI 命令(即使已请求且其执行延迟声称高于此阈值)不应被视为原子操作模式的阈值。

实例 <n> 当前配置的 SCMI 传输在发送 (TX) 通道上允许同时处理的最大 SCMI 消息数量。

用户

/sys/kernel/debug/scmi/<n>/instance_name

/sys/kernel/debug/scmi/<n>/transport/type

一个可选的时间值,以微秒表示,表示在此 SCMI 实例 上,任何 SCMI 命令(即使已请求且其执行延迟声称高于此阈值)不应被视为原子操作模式的阈值。

一个字符串,表示为该 SCMI 实例 <n> 配置的传输类型。

用户

/sys/kernel/debug/scmi/<n>/instance_name

/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 当前活跃的性能限制原因 (Performance Limit Reasons)。此文件内容是持久的,可以通过向此文件写入“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/vfio

定义于文件 debugfs-vfio

此 debugfs 文件目录用于调试 VFIO 设备,它是所有 VFIO 设备的公共目录。VFIO 核心将在此目录下创建一个设备子目录。

/sys/kernel/debug/vfio/<device>/migration

定义于文件 debugfs-vfio

此 debugfs 文件目录用于调试支持 live migration(在线迁移)的 VFIO 设备。每个支持 live migration 的 VFIO 设备的 debugfs 都可以此目录下创建。

/sys/kernel/debug/vfio/<device>/migration/hisi_acc/cmd_state

定义于文件 debugfs-hisi-migration

用于获取设备命令发送和接收通道的状态。根据结果返回失败或成功日志。

/sys/kernel/debug/vfio/<device>/migration/hisi_acc/dev_data

定义于文件 debugfs-hisi-migration

读取设备 live migration 所需的配置数据和一些状态数据。这些数据包括设备状态数据、队列配置数据、一些任务配置数据和设备属性数据。数据的输出格式由 live migration 驱动程序定义。

/sys/kernel/debug/vfio/<device>/migration/hisi_acc/migf_data

定义于文件 debugfs-hisi-migration

读取上次完成的 live migration 的数据。此数据包含与“dev_data”中相同的设备状态数据。`migf_data` 是已迁移的 `dev_data`。

/sys/kernel/debug/vfio/<device>/migration/state

定义于文件 debugfs-vfio

读取 VFIO 设备的 live migration 状态。state 文件的内容反映了与 `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 表示消息类型,它是 `enum 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 文件,可用于设置要传递给捕获内核的附加参数。对于 HASH MMU,仅当 RMA 大于 768MB 时才导出。

/sys/kernel/fadump/enabled

定义于文件 sysfs-kernel-fadump

只读 主要用于识别内核中是否启用了 FADump。用户:Kdump 服务

/sys/kernel/fadump/hotplug_ready

定义于文件 sysfs-kernel-fadump

只读 Kdump udev 规则在内存添加/移除事件时重新注册 fadump,主要用于更新 elfcorehdr。此 sysfs 指示 kdump udev 规则,即在内存添加/移除事件时不需要重新注册 fadump,因为 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/hardlockup_count

定义于文件 sysfs-kernel-hardlockup_count

显示自上次启动以来系统检测到硬锁定的次数。仅当 CONFIG_HARDLOCKUP_DETECTOR 启用时可用。

/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 ID 顺序,每个 CPU 一个。注意:此文件始终显示所有 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/<patch>/<object>/patched

定义于文件 sysfs-kernel-livepatch

一个属性,指示对象当前是否已修补。

/sys/kernel/livepatch/<patch>/enabled

定义于文件 sysfs-kernel-livepatch

一个可写属性,指示修补后的代码当前是否已应用。写入 0 将禁用补丁,而写入 1 将重新启用补丁。

/sys/kernel/livepatch/<patch>/force

定义于文件 sysfs-kernel-livepatch

一个可写属性,允许管理员影响现有转换的进程。写入 1 会清除所有任务的 TIF_PATCH_PENDING 标志,从而强制任务进入已打补丁或未打补丁的状态。管理员未经补丁分发商的批准不应使用此功能。使用此功能时,补丁模块的移除(rmmod)功能将永久禁用。有关更多信息,请参阅 Livepatch

/sys/kernel/livepatch/<patch>/replace

定义于文件 sysfs-kernel-livepatch

一个属性,指示补丁是否支持原子替换。

/sys/kernel/livepatch/<patch>/stack_order

定义于文件 sysfs-kernel-livepatch

此属性指定热补丁模块应用于系统的顺序。如果多个热补丁修改同一函数,则使用具有最大“stack_order”编号的实现,除非当前正在进行转换。

/sys/kernel/livepatch/<patch>/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-heap-name>` 目录)包含以下项:

alloc_pages_success alloc_pages_fail

/sys/kernel/mm/cma/<cma-heap-name>/alloc_pages_fail

定义于文件 sysfs-kernel-mm-cma

CMA API 分配失败的页数。

/sys/kernel/mm/cma/<cma-heap-name>/alloc_pages_success

定义于文件 sysfs-kernel-mm-cma

CMA API 成功分配的页数。

/sys/kernel/mm/cma/<cma-heap-name>/available_pages

定义于文件 sysfs-kernel-mm-cma

CMA 区域中仍可用于 CMA 分配的页数。

/sys/kernel/mm/cma/<cma-heap-name>/release_pages_success

定义于文件 sysfs-kernel-mm-cma

CMA API 成功释放的页数。

/sys/kernel/mm/cma/<cma-heap-name>/total_pages

定义于文件 sysfs-kernel-mm-cma

CMA 区域的大小(以页为单位)。

/sys/kernel/mm/damon/

定义于文件 sysfs-kernel-mm-damon

数据访问监控 (DAMON) 接口。包含用于控制 DAMON 的文件。有关 DAMON 本身的更多详细信息,请参阅 DAMON: Data Access MONitoring and Access-aware System Operations

/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/intrvals_goal/access_bp

定义于文件 sysfs-kernel-mm-damon

向此文件写入一个值,以 bp (1/10,000) 为单位设置监控间隔自动调整目标 DAMON 观察到的在给定时间间隔(同一目录中的 aggrs)内的访问事件比率。读取此文件将返回该值。

/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/monitoring_attrs/intervals/intrvals_goal/aggrs

定义于文件 sysfs-kernel-mm-damon

向此文件写入一个值,设置在其中实现监控间隔自动调整目标 DAMON 观察到的访问事件比率(同一目录中的 access_bp)的时间间隔。读取此文件将返回该值。

/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/monitoring_attrs/intervals/intrvals_goal/max_sample_us

定义于文件 sysfs-kernel-mm-damon

向此文件写入一个值,以微秒为单位设置自动调整采样间隔的最大值。读取此文件将返回该值。

/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/monitoring_attrs/intervals/intrvals_goal/min_sample_us

定义于文件 sysfs-kernel-mm-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>/core_filters

定义于文件 sysfs-kernel-mm-damon

用于 DAMON 核心层处理的 DAMOS 过滤器的目录。此目录下的文件与 `/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/filters` 目录下的文件功能相同。

/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/filters/<F>/addr_end

定义于文件 sysfs-kernel-mm-damon

如果向“type”文件写入“addr”,则写入或读取此文件可设置或获取过滤器的地址范围结束地址。

/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/filters/<F>/addr_start

定义于文件 sysfs-kernel-mm-damon

如果向“type”文件写入“addr”,则写入或读取此文件可设置或获取过滤器的地址范围起始地址。

/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/filters/<F>/allow

定义于文件 sysfs-kernel-mm-damon

向此文件写入“Y”或“N”,以设置是否允许或拒绝将方案的动作应用于满足目录中“type”和“matching”条件的内存。

/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/filters/<F>/matching

定义于文件 sysfs-kernel-mm-damon

向此文件写入“Y”或“N”,以设置过滤器是针对“type”类型的内存,还是除“type”类型之外的所有内存。

/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/filters/<F>/max

定义于文件 sysfs-kernel-mm-damon

如果向“type”文件写入“hugepage_size”,则写入或读取此文件可设置或获取过滤器的巨页最大大小。

/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/filters/<F>/memcg_path

定义于文件 sysfs-kernel-mm-damon

如果向“type”文件写入“memcg”,则写入和读取此文件可设置和获取目标内存 cgroup 的路径。

/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/filters/<F>/min

定义于文件 sysfs-kernel-mm-damon

如果向“type”文件写入“hugepage_size”,则写入或读取此文件可设置或获取过滤器的巨页最小大小。

/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/filters/<F>/target_idx

定义于文件 sysfs-kernel-mm-damon

如果向“type”文件写入“target”,则写入或读取此文件可设置或获取目标 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/` 目录下创建数量为“N”的目录,用于设置名为“0”到“N-1”的方案过滤器。

/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/ops_filters

定义于文件 sysfs-kernel-mm-damon

用于 DAMON 操作集层处理的 DAMOS 过滤器的目录。此目录下的文件与 `/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/filters` 目录下的文件功能相同。

/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>/nid

定义于文件 sysfs-kernel-mm-damon

写入和读取此文件可设置和获取目标的 nid 参数。

/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/` 目录下创建数量为“N”的目录,用于设置名为“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

写入和读取此文件可设置并获取配额限制区域下“大小”的优先级权重(以千分之几表示)。

/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_ops_filter_passed

定义于文件 sysfs-kernel-mm-damon

读取此文件将返回通过 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/<R>/sz_filter_passed

定义于文件 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/ 目录下创建用于控制上下文的每个基于 DAMON 的操作方案(命名为“0”到“N-1”)的目录数量。

/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/ 目录下创建用于设置上下文的每个 DAMON 目标内存区域(命名为“0”到“N-1”)的目录数量。在虚拟地址空间监控的情况下,DAMON 会根据目标进程的映射自动设置目标内存区域。

/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/targets/nr_targets

定义于文件 sysfs-kernel-mm-damon

将数字“N”写入此文件将在 contexts/ 目录下创建用于控制上下文的每个 DAMON 目标(命名为“0”到“N-1”)的目录数量。

/sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/nr_contexts

定义于文件 sysfs-kernel-mm-damon

将数字“N”写入此文件将在 contexts/ 目录下创建用于控制每个 DAMON 上下文(命名为“0”到“N-1”)的目录数量。

/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/ 目录下创建用于控制每个 DAMON 工作线程 (kdamond)(命名为“0”到“N-1”)的目录数量。

/sys/kernel/mm/hugepages/

在文件 sysfs-kernel-mm-hugepages 中定义

/sys/kernel/mm/hugepages/ 包含多个形式为 hugepages-<size>kB 的子目录,其中 <size> 是内核/CPU 组合支持的 hugepages 的页面大小。

这些目录下有许多文件:

  • 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 中定义

内存策略 (Mempolicy) 接口

/sys/kernel/mm/mempolicy/weighted_interleave/

在文件 sysfs-kernel-mm-mempolicy-weighted-interleave 中定义

加权交错策略的配置接口

/sys/kernel/mm/mempolicy/weighted_interleave/auto

在文件 sysfs-kernel-mm-mempolicy-weighted-interleave 中定义

自动加权配置接口

加权交错的配置模式。“true”表示系统处于自动模式,“false”表示系统处于手动模式。

在自动模式下,每当在引导或热插拔事件期间提供新的带宽数据时,所有节点权重都会重新计算并覆盖(通过 nodeN 接口可见)。

在手动模式下,节点权重只能由用户更新。请注意,已在线且先前设置了权重的节点将重用这些权重。如果它们未事先设置或在线时缺少带宽数据,则权重将使用默认权重 1。

写入任何真值字符串(例如 Y 或 1)将启用自动模式,而写入任何假值字符串(例如 N 或 0)将启用手动模式。所有其他字符串将被忽略,并返回 -EINVAL。

通过 nodeN 接口直接向节点写入新权重也将自动将系统切换到手动模式。

/sys/kernel/mm/mempolicy/weighted_interleave/nodeN

在文件 sysfs-kernel-mm-mempolicy-weighted-interleave 中定义

nodeN 的权重配置接口

内存节点 (N) 的交错权重。这些权重由将其内存策略设置为 MPOL_WEIGHTED_INTERLEAVE 的任务使用。

这些权重仅影响新分配,运行时更改不会导致已分配页的迁移。

节点的最小权重始终为 1。

最小权重:1 最大权重:255

写入无效值(即不在 [1,255] 范围内的任何值、空字符串等)将返回 -EINVAL。

将权重更改为有效值也将自动将系统切换到手动模式。

/sys/kernel/mm/numa/

在文件 sysfs-kernel-mm-numa 中定义

NUMA 接口

/sys/kernel/mm/numa/demotion_enabled

在文件 sysfs-kernel-mm-numa 中定义

在回收期间启用/禁用页降级

回收期间的页迁移旨在用于分层内存配置的系统。这些系统具有多种性能特性各异的内存类型,而非内存种类相同但距离不同的普通 NUMA 系统。允许回收期间的页迁移使这些系统能够在快速层面临压力时将页从快速层迁移到慢速层。如果在 cgroup 的 cpuset.mems 中存在符合条件的 NUMA 节点(或者正在使用 cpuset v1),则此迁移会在交换之前执行。如果 cpusets.mems 在运行时更改,它可能会将数据移动到不属于新 cpusets.mems 的 cpuset 的 NUMA 节点,这可能被视为违反 cpusets 的保证。由另一个 cgroup 拥有的共享内存(例如库)仍可能被降级,并导致在 cpuset.mem 中不存在的节点上使用内存。对于需要严格 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 组合支持的 hugepages 的页大小。

详情请参阅 透明大页支持

/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/rcu_stall_count

在文件 sysfs-kernel-rcu_stall_count 中定义

显示系统自上次引导以来检测到 RCU 停滞的次数。

/sys/kernel/reboot

在文件 sysfs-kernel-reboot 中定义

设置内核重启行为的接口,类似于通过 reboot= 命令行选项所能完成的操作。(参见 内核命令行参数

/sys/kernel/reboot/cpu

在文件 sysfs-kernel-reboot 中定义

用于重启的 CPU 编号。

/sys/kernel/reboot/force

在文件 sysfs-kernel-reboot 中定义

重启时不等待任何其他 CPU,并避免可能导致挂起的操作。

/sys/kernel/reboot/hw_protection

在文件 sysfs-kernel-reboot 中定义

在过温或即将电压丢失等关键事件上采取的硬件保护操作。有效值为:reboot shutdown

/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

需要 fs-verity 摘要的“测量”规则示例,并在测量列表中指明摘要类型。

measure func=FILE_CHECK digest_type=verity

template=ima-ngv2

需要存储在 security.ima xattr 中的 fs-verity 签名(格式版本 3)的“测量”和“评估”规则示例。

“测量”规则指定“ima-sigv3”模板选项,该选项在测量列表中包含摘要类型和文件签名指示。

measure func=BPRM_CHECK digest_type=verity

template=ima-sigv3

“评估”规则指定所需的类型和签名格式版本 (sigv3)。

appraise func=BPRM_CHECK digest_type=verity

appraise_type=sigv3

所有这些策略规则都可以,例如,基于文件系统的 UUID (fsuuid) 或基于 LSM 标签进行约束。

/sys/kernel/security/evm

/sys/kernel/security/*/evm

在文件 evm 中定义

EVM 保护文件的安全扩展属性 (xattrs) 免受完整性攻击。初始方法在扩展属性中维护一个 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-mm-slab 中定义

D/sys/kernel/slab 目录包含每个缓存的 SLUB 分配器内部状态的快照。某些文件可以修改以更改缓存(以及它所引用的任何缓存,如果有的话)的行为。

用户

内核内存调优工具

/sys/kernel/slab/<cache>/aliases

在文件 sysfs-kernel-mm-slab 中定义

aliases 文件是只读的,它指定有多少个缓存已合并到此缓存中。

/sys/kernel/slab/<cache>/align

在文件 sysfs-kernel-mm-slab 中定义

align 文件是只读的,它指定缓存的对象对齐方式(以字节为单位)。

/sys/kernel/slab/<cache>/alloc_calls

在文件 sysfs-kernel-mm-slab 中定义

alloc_calls 文件是只读的,它列出了为该缓存执行分配的内核代码位置。alloc_calls 文件仅在该缓存启用了调试时才包含信息(参见 SLUB 简短用户指南)。

/sys/kernel/slab/<cache>/alloc_fastpath

在文件 sysfs-kernel-mm-slab 中定义

alloc_fastpath 文件显示使用快速路径已分配了多少对象。可以写入以清除当前计数。当 CONFIG_SLUB_STATS 启用时可用。

/sys/kernel/slab/<cache>/alloc_from_partial

在文件 sysfs-kernel-mm-slab 中定义

alloc_from_partial 文件显示 CPU slab 已满并已通过使用部分已用 slab 列表中的 slab 重新填充的次数。可以写入以清除当前计数。当 CONFIG_SLUB_STATS 启用时可用。

/sys/kernel/slab/<cache>/alloc_refill

在文件 sysfs-kernel-mm-slab 中定义

alloc_refill 文件显示每 CPU 空闲列表为空但由于远程 CPU 释放而有可用对象的次数。可以写入以清除当前计数。当 CONFIG_SLUB_STATS 启用时可用。

/sys/kernel/slab/<cache>/alloc_slab

在文件 sysfs-kernel-mm-slab 中定义

alloc_slab 文件显示从页分配器分配新 slab 的次数。可以写入以清除当前计数。当 CONFIG_SLUB_STATS 启用时可用。

/sys/kernel/slab/<cache>/alloc_slowpath

在文件 sysfs-kernel-mm-slab 中定义

alloc_slowpath 文件显示由于重新填充或从部分或新 slab 分配而使用慢速路径分配了多少对象。可以写入以清除当前计数。当 CONFIG_SLUB_STATS 启用时可用。

/sys/kernel/slab/<cache>/cache_dma

在文件 sysfs-kernel-mm-slab 中定义

cache_dma 文件是只读的,它指定对象是否来自 ZONE_DMA。当 CONFIG_ZONE_DMA 启用时可用。

/sys/kernel/slab/<cache>/cpu_partial

在文件 sysfs-kernel-mm-slab 中定义

此只读文件显示要保留的每 CPU 部分页的数量。

/sys/kernel/slab/<cache>/cpu_slabs

在文件 sysfs-kernel-mm-slab 中定义

cpu_slabs 文件是只读的,它显示有多少个 CPU slab 处于活动状态及其 NUMA 局部性。

/sys/kernel/slab/<cache>/cpuslab_flush

在文件 sysfs-kernel-mm-slab 中定义

cpuslab_flush 文件显示由于销毁或缩小缓存、CPU 脱机或强制从特定节点分配而导致缓存的 CPU slab 被刷新了多少次。可以写入以清除当前计数。当 CONFIG_SLUB_STATS 启用时可用。

/sys/kernel/slab/<cache>/ctor

在文件 sysfs-kernel-mm-slab 中定义

ctor 文件是只读的,它指定缓存的对象构造函数,当分配新 slab 时,该函数会为每个对象调用。

/sys/kernel/slab/<cache>/deactivate_empty

在文件 sysfs-kernel-mm-slab 中定义

deactivate_empty 文件显示空 CPU slab 被停用了多少次。可以写入以清除当前计数。当 CONFIG_SLUB_STATS 启用时可用。

/sys/kernel/slab/<cache>/deactivate_full

在文件 sysfs-kernel-mm-slab 中定义

deactivate_full 文件显示已满 CPU slab 被停用了多少次。可以写入以清除当前计数。当 CONFIG_SLUB_STATS 启用时可用。

/sys/kernel/slab/<cache>/deactivate_remote_frees

在文件 sysfs-kernel-mm-slab 中定义

deactivate_remote_frees 文件显示 CPU slab 被停用并包含远程释放的空闲对象多少次。可以写入以清除当前计数。当 CONFIG_SLUB_STATS 启用时可用。

/sys/kernel/slab/<cache>/deactivate_to_head

在文件 sysfs-kernel-mm-slab 中定义

deactivate_to_head 文件显示部分 CPU slab 被停用并添加到其节点部分列表头部的次数。可以写入以清除当前计数。当 CONFIG_SLUB_STATS 启用时可用。

/sys/kernel/slab/<cache>/deactivate_to_tail

在文件 sysfs-kernel-mm-slab 中定义

deactivate_to_tail 文件显示部分 CPU slab 被停用并添加到其节点部分列表尾部的次数。可以写入以清除当前计数。当 CONFIG_SLUB_STATS 启用时可用。

/sys/kernel/slab/<cache>/destroy_by_rcu

在文件 sysfs-kernel-mm-slab 中定义

destroy_by_rcu 文件是只读的,它指定 slab(而不是对象)是否由 RCU 释放。

/sys/kernel/slab/<cache>/free_add_partial

在文件 sysfs-kernel-mm-slab 中定义

free_add_partial 文件显示对象在完整 slab 中被释放的次数,以至于必须将其添加到其节点的部分列表中。可以写入以清除当前计数。当 CONFIG_SLUB_STATS 启用时可用。

/sys/kernel/slab/<cache>/free_calls

在文件 sysfs-kernel-mm-slab 中定义

free_calls 文件是只读的,它列出了在启用 slab 调试时对象释放的位置(参见 SLUB 简短用户指南)。

/sys/kernel/slab/<cache>/free_fastpath

在文件 sysfs-kernel-mm-slab 中定义

free_fastpath 文件显示使用快速路径已释放多少对象,因为它来自 CPU slab。可以写入以清除当前计数。当 CONFIG_SLUB_STATS 启用时可用。

/sys/kernel/slab/<cache>/free_frozen

在文件 sysfs-kernel-mm-slab 中定义

free_frozen 文件显示已有多少对象被释放到冻结的 slab(即远程 CPU slab)。可以写入以清除当前计数。当 CONFIG_SLUB_STATS 启用时可用。

/sys/kernel/slab/<cache>/free_remove_partial

在文件 sysfs-kernel-mm-slab 中定义

free_remove_partial 文件显示对象被释放到现在为空的 slab 的次数,以至于必须将其从其节点的部分列表中移除。可以写入以清除当前计数。当 CONFIG_SLUB_STATS 启用时可用。

/sys/kernel/slab/<cache>/free_slab

在文件 sysfs-kernel-mm-slab 中定义

free_slab 文件显示空 slab 被释放回页分配器的次数。可以写入以清除当前计数。当 CONFIG_SLUB_STATS 启用时可用。

/sys/kernel/slab/<cache>/free_slowpath

在文件 sysfs-kernel-mm-slab 中定义

free_slowpath 文件显示使用慢速路径(即到完整或部分 slab)已释放多少对象。可以写入以清除当前计数。当 CONFIG_SLUB_STATS 启用时可用。

/sys/kernel/slab/<cache>/hwcache_align

在文件 sysfs-kernel-mm-slab 中定义

hwcache_align 文件是只读的,它指定对象是否按缓存行对齐。

/sys/kernel/slab/<cache>/min_partial

在文件 sysfs-kernel-mm-slab 中定义

min_partial 文件指定节点部分列表中应保留多少个空 slab,以避免分配新 slab 的开销。此类 slab 可以通过利用 shrink 文件进行回收。

/sys/kernel/slab/<cache>/object_size

在文件 sysfs-kernel-mm-slab 中定义

object_size 文件是只读的,它指定缓存的对象大小。

/sys/kernel/slab/<cache>/objects

在文件 sysfs-kernel-mm-slab 中定义

objects 文件是只读的,它显示有多少个对象处于活动状态以及它们来自哪个节点。

/sys/kernel/slab/<cache>/objects_partial

在文件 sysfs-kernel-mm-slab 中定义

objects_partial 文件是只读的,它显示有多少个对象在部分 slab 上以及它们来自哪个节点。

/sys/kernel/slab/<cache>/objs_per_slab

在文件 sysfs-kernel-mm-slab 中定义

objs_per_slab 文件是只读的,它指定可以从 /sys/kernel/slab/<cache>/order 中指定的阶数的单个 slab 分配多少个对象。

/sys/kernel/slab/<cache>/order

在文件 sysfs-kernel-mm-slab 中定义

order 文件指定分配新 slab 的页面顺序。它是可写的,可以更改以增加每个 slab 的对象数量。如果由于碎片化而无法分配 slab,SLUB 将根据其特性以最小可能的顺序重试。

当指定 debug_guardpage_minorder=N (N > 0) 参数时(参见 内核命令行参数),将使用最小可能顺序,并且此 sysfs 条目无法用于在运行时更改顺序。

/sys/kernel/slab/<cache>/order_fallback

在文件 sysfs-kernel-mm-slab 中定义

order_fallback 文件显示在缓存的顺序下无法分配新 slab 而回退到其最小可能顺序的次数。可以写入以清除当前计数。

当 CONFIG_SLUB_STATS 启用时可用。

/sys/kernel/slab/<cache>/partial

在文件 sysfs-kernel-mm-slab 中定义

该部分文件是只读的,显示有多少部分 slab 以及每个节点的列表有多长。

/sys/kernel/slab/<cache>/poison

在文件 sysfs-kernel-mm-slab 中定义

poison 文件指定了在新 slab 分配时是否应该对对象进行毒化(poisoned)。

/sys/kernel/slab/<cache>/reclaim_account

在文件 sysfs-kernel-mm-slab 中定义

reclaim_account 文件指定了缓存的对象是否可回收(并按其移动性分组)。

/sys/kernel/slab/<cache>/red_zone

在文件 sysfs-kernel-mm-slab 中定义

red_zone 文件指定了缓存的对象是否处于红区(red zoned)。

/sys/kernel/slab/<cache>/remote_node_defrag_ratio

在文件 sysfs-kernel-mm-slab 中定义

remote_node_defrag_ratio 文件指定了 SLUB 尝试使用远程节点的部分 slab 重新填充 CPU slab 的百分比,而不是在本地节点分配新的 slab。这减少了整个系统上的内存浪费,但可能会很昂贵。

当 CONFIG_NUMA 启用时可用。

/sys/kernel/slab/<cache>/sanity_checks

在文件 sysfs-kernel-mm-slab 中定义

sanity_checks 文件指定了是否应该对空闲(free)执行昂贵的检查,并至少启用双重释放(double free)检查。启用了 sanity_checks 的缓存不能与未启用该功能的缓存合并。

/sys/kernel/slab/<cache>/shrink

在文件 sysfs-kernel-mm-slab 中定义

shrink 文件用于从缓存中回收未使用的 slab 缓存内存。空的每 CPU 或部分 slab 被释放,并且部分列表被排序,以便首先使用可用对象最少的 slab。它在写入时只接受“1”作为收缩缓存的值。其他输入值被视为无效。收缩 slab 缓存可能很昂贵,并且可能会对其他正在运行的应用程序产生不利影响。因此应谨慎使用。

/sys/kernel/slab/<cache>/slab_size

在文件 sysfs-kernel-mm-slab 中定义

slab_size 文件是只读的,指定了带元数据(调试信息和对齐)的对象大小(以字节为单位)。

/sys/kernel/slab/<cache>/slabs

在文件 sysfs-kernel-mm-slab 中定义

slabs 文件是只读的,显示有多少 slab(包括 cpu 和部分 slab)以及它们来自哪个节点。

/sys/kernel/slab/<cache>/slabs_cpu_partial

在文件 sysfs-kernel-mm-slab 中定义

这个只读文件显示部分分配的冻结 slab 的数量。

/sys/kernel/slab/<cache>/store_user

在文件 sysfs-kernel-mm-slab 中定义

store_user 文件指定是否应该为缓存跟踪分配或释放的位置。

/sys/kernel/slab/<cache>/total_objects

在文件 sysfs-kernel-mm-slab 中定义

total_objects 文件是只读的,显示缓存总共有多少对象以及它们来自哪个节点。

/sys/kernel/slab/<cache>/trace

在文件 sysfs-kernel-mm-slab 中定义

trace 文件指定是否应该跟踪对象的分配和释放。

/sys/kernel/slab/<cache>/usersize

在文件 sysfs-kernel-mm-slab 中定义

usersize 文件是只读的,包含用户复制区域的大小。

/sys/kernel/slab/<cache>/validate

在文件 sysfs-kernel-mm-slab 中定义

写入 validate 文件会使 SLUB 遍历其所有缓存对象并检查元数据的有效性。

/sys/kernel/softlockup_count

在文件 sysfs-kernel-softlockup_count 中定义

显示系统自上次启动以来检测到软锁定的次数。仅当 CONFIG_SOFTLOCKUP_DETECTOR 启用时可用。

/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 中定义

读写每次迭代尝试释放的授权条目数量。

注意:未来版本的 Xen 和 Linux 可能会提供更好的接口来控制延迟授权回收的速率,或者根本不需要它。

用户

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 不缓存任何未由授权映射支持的页面的持续时间(以毫秒为单位)。默认值为 10 毫秒。

/sys/module/xen_blkback/parameters/feature_persistent

在文件 sysfs-driver-xen-blkback 中定义

是否启用持久授权功能。请注意,此选项仅对新连接的后端生效。默认值为 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 中持久映射的最大授权数量。如果前端尝试使用超过 max_persistent_grants,LRU 将启动并每 100 毫秒删除 5% 的 max_persistent_grants。

/sys/module/xen_blkback/parameters/persistent_grant_unused_seconds

在文件 sysfs-driver-xen-blkback 中定义

一个持久授权在未使用的情况下可以保持分配状态的时长。时间以秒为单位,0 表示无限长。默认值为 60 秒。

/sys/module/xen_blkfront/parameters/feature_persistent

在文件 sysfs-driver-xen-blkfront 中定义

是否启用持久授权功能。请注意,此选项仅对新连接的前端生效。默认值为 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 文件控制休眠(suspend-to-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

在文件 sysfs-power 中定义

/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 设备的“resume”回调失败的次数。

/sys/power/suspend_stats/failed_resume_early

在文件 sysfs-power 中定义

/sys/power/suspend_stats/failed_resume_early 文件包含执行设备的“early resume”回调失败的次数。

/sys/power/suspend_stats/failed_resume_noirq

在文件 sysfs-power 中定义

/sys/power/suspend_stats/failed_resume_noirq 文件包含执行设备的“noirq resume”回调失败的次数。

/sys/power/suspend_stats/failed_suspend

在文件 sysfs-power 中定义

/sys/power/suspend_stats/failed_suspend 文件包含执行所有非 sysdev 设备的“suspend”回调失败的次数。

/sys/power/suspend_stats/failed_suspend_late

在文件 sysfs-power 中定义

/sys/power/suspend_stats/failed_suspend_late 文件包含执行所有设备的“late suspend”回调失败的次数。

/sys/power/suspend_stats/failed_suspend_noirq

在文件 sysfs-power 中定义

/sys/power/suspend_stats/failed_suspend_noirq 文件包含执行所有设备的“noirq suspend”回调失败的次数。

/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 文件包含上次尝试进入系统睡眠状态失败的 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 中定义

此文件控制内核是否在系统挂起期间(冻结用户空间之后和挂起设备之前)同步(sync())文件系统。

向此文件写入“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

以下是使用 udevadm monitor -p 在 USB 充电器在线时获取的两个示例

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)使用的内存区域,供访客所有者在虚拟机启动期间注入秘密信息。这些秘密信息由访客所有者加密,并在可信 enclave 内解密,因此不可被不可信主机读取。

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 中“Structure of the EFI secret area”下有描述。