Documentation / ABI / testing / sysfs-platform-mellanox-pmc


Based on kernel version 6.14. Page generated on 2025-04-02 08:20 EST.

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64
HID           Driver         Description
MLNXBFD0      mlxbf-pmc      Performance counters (BlueField-1)
MLNXBFD1      mlxbf-pmc      Performance counters (BlueField-2)
MLNXBFD2      mlxbf-pmc      Performance counters (BlueField-3)

What:		/sys/bus/platform/devices/<HID>/hwmon/hwmonX/<block>/event_list
Date:		Dec 2020
KernelVersion:	5.10
Contact:	"Shravan Kumar Ramani <shravankr@nvidia.com>"
Description:
		List of events supported by the counters in the specific block.
		It is used to extract the event number or ID associated with
		each event.

What:		/sys/bus/platform/devices/<HID>/hwmon/hwmonX/<block>/event<N>
Date:		Dec 2020
KernelVersion:	5.10
Contact:	"Shravan Kumar Ramani <shravankr@nvidia.com>"
Description:
		Event monitored by corresponding counter. This is used to
		program or read back the event that should be or is currently
		being monitored by counter<N>.

What:		/sys/bus/platform/devices/<HID>/hwmon/hwmonX/<block>/counter<N>
Date:		Dec 2020
KernelVersion:	5.10
Contact:	"Shravan Kumar Ramani <shravankr@nvidia.com>"
Description:
		Counter value of the event being monitored. This is used to
		read the counter value of the event which was programmed using
		event<N>. This is also used to clear or reset the counter value
		by writing 0 to the counter sysfs.

What:		/sys/bus/platform/devices/<HID>/hwmon/hwmonX/<block>/enable
Date:		Dec 2020
KernelVersion:	5.10
Contact:	"Shravan Kumar Ramani <shravankr@nvidia.com>"
Description:
		Start or stop counters. This is used to start the counters
		for monitoring the programmed events and also to stop the
		counters after the desired duration. Writing value 1 will
		start all the counters in the block, and writing 0 will
		stop all the counters together.

What:		/sys/bus/platform/devices/<HID>/hwmon/hwmonX/<block>/<reg>
Date:		Dec 2020
KernelVersion:	5.10
Contact:	"Shravan Kumar Ramani <shravankr@nvidia.com>"
Description:
		Value of register. This is used to read or reset the registers
		where various performance statistics are counted for each block.
		Writing 0 to the sysfs will clear the counter, writing any other
		value is not allowed.

What:		/sys/bus/platform/devices/<HID>/hwmon/hwmonX/<block>/count_clock
Date:		Mar 2025
KernelVersion:	6.14
Contact:	"Shravan Kumar Ramani <shravankr@nvidia.com>"
Description:
		Use a counter for counting cycles. This is used to repurpose/dedicate
		any of the counters in the block to counting cycles. Each counter is
		represented by a bit (bit 0 for counter0, bit1 for counter1 and so on)
		and setting the corresponding bit will reserve that specific counter
		for counting cycles and override the event<N> setting.