xref: /linux/Documentation/ABI/testing/debugfs-hisi-hpre (revision 8a922b7728a93d837954315c98b84f6b78de0c4f)
1What:		/sys/kernel/debug/hisi_hpre/<bdf>/cluster[0-3]/regs
2Date:		Sep 2019
3Contact:	linux-crypto@vger.kernel.org
4Description:	Dump debug registers from the HPRE cluster.
5		Only available for PF.
6
7What:		/sys/kernel/debug/hisi_hpre/<bdf>/cluster[0-3]/cluster_ctrl
8Date:		Sep 2019
9Contact:	linux-crypto@vger.kernel.org
10Description:	Write the HPRE core selection in the cluster into this file,
11		and then we can read the debug information of the core.
12		Only available for PF.
13
14What:		/sys/kernel/debug/hisi_hpre/<bdf>/rdclr_en
15Date:		Sep 2019
16Contact:	linux-crypto@vger.kernel.org
17Description:	HPRE cores debug registers read clear control. 1 means enable
18		register read clear, otherwise 0. Writing to this file has no
19		functional effect, only enable or disable counters clear after
20		reading of these registers.
21		Only available for PF.
22
23What:		/sys/kernel/debug/hisi_hpre/<bdf>/current_qm
24Date:		Sep 2019
25Contact:	linux-crypto@vger.kernel.org
26Description:	One HPRE controller has one PF and multiple VFs, each function
27		has a QM. Select the QM which below qm refers to.
28		Only available for PF.
29
30What:		/sys/kernel/debug/hisi_hpre/<bdf>/alg_qos
31Date:		Jun 2021
32Contact:	linux-crypto@vger.kernel.org
33Description:	The <bdf> is related the function for PF and VF.
34		HPRE driver supports to configure each function's QoS, the driver
35		supports to write <bdf> value to alg_qos in the host. Such as
36		"echo <bdf> value > alg_qos". The qos value is 1~1000, means
37		1/1000~1000/1000 of total QoS. The driver reading alg_qos to
38		get related QoS in the host and VM, Such as "cat alg_qos".
39
40What:		/sys/kernel/debug/hisi_hpre/<bdf>/regs
41Date:		Sep 2019
42Contact:	linux-crypto@vger.kernel.org
43Description:	Dump debug registers from the HPRE.
44		Only available for PF.
45
46What:		/sys/kernel/debug/hisi_hpre/<bdf>/qm/regs
47Date:		Sep 2019
48Contact:	linux-crypto@vger.kernel.org
49Description:	Dump debug registers from the QM.
50		Available for PF and VF in host. VF in guest currently only
51		has one debug register.
52
53What:		/sys/kernel/debug/hisi_hpre/<bdf>/qm/current_q
54Date:		Sep 2019
55Contact:	linux-crypto@vger.kernel.org
56Description:	One QM may contain multiple queues. Select specific queue to
57		show its debug registers in above regs.
58		Only available for PF.
59
60What:		/sys/kernel/debug/hisi_hpre/<bdf>/qm/clear_enable
61Date:		Sep 2019
62Contact:	linux-crypto@vger.kernel.org
63Description:	QM debug registers(regs) read clear control. 1 means enable
64		register read clear, otherwise 0.
65		Writing to this file has no functional effect, only enable or
66		disable counters clear after reading of these registers.
67		Only available for PF.
68
69What:		/sys/kernel/debug/hisi_hpre/<bdf>/qm/err_irq
70Date:		Apr 2020
71Contact:	linux-crypto@vger.kernel.org
72Description:	Dump the number of invalid interrupts for
73		QM task completion.
74		Available for both PF and VF, and take no other effect on HPRE.
75
76What:		/sys/kernel/debug/hisi_hpre/<bdf>/qm/aeq_irq
77Date:		Apr 2020
78Contact:	linux-crypto@vger.kernel.org
79Description:	Dump the number of QM async event queue interrupts.
80		Available for both PF and VF, and take no other effect on HPRE.
81
82What:		/sys/kernel/debug/hisi_hpre/<bdf>/qm/abnormal_irq
83Date:		Apr 2020
84Contact:	linux-crypto@vger.kernel.org
85Description:	Dump the number of interrupts for QM abnormal event.
86		Available for both PF and VF, and take no other effect on HPRE.
87
88What:		/sys/kernel/debug/hisi_hpre/<bdf>/qm/create_qp_err
89Date:		Apr 2020
90Contact:	linux-crypto@vger.kernel.org
91Description:	Dump the number of queue allocation errors.
92		Available for both PF and VF, and take no other effect on HPRE.
93
94What:		/sys/kernel/debug/hisi_hpre/<bdf>/qm/mb_err
95Date:		Apr 2020
96Contact:	linux-crypto@vger.kernel.org
97Description:	Dump the number of failed QM mailbox commands.
98		Available for both PF and VF, and take no other effect on HPRE.
99
100What:		/sys/kernel/debug/hisi_hpre/<bdf>/qm/status
101Date:		Apr 2020
102Contact:	linux-crypto@vger.kernel.org
103Description:	Dump the status of the QM.
104		Four states: initiated, started, stopped and closed.
105		Available for both PF and VF, and take no other effect on HPRE.
106
107What:		/sys/kernel/debug/hisi_hpre/<bdf>/qm/diff_regs
108Date:		Mar 2022
109Contact:	linux-crypto@vger.kernel.org
110Description:	QM debug registers(regs) read hardware register value. This
111		node is used to show the change of the qm register values. This
112		node can be help users to check the change of register values.
113
114What:		/sys/kernel/debug/hisi_hpre/<bdf>/hpre_dfx/diff_regs
115Date:		Mar 2022
116Contact:	linux-crypto@vger.kernel.org
117Description:	HPRE debug registers(regs) read hardware register value. This
118		node is used to show the change of the register values. This
119		node can be help users to check the change of register values.
120
121What:		/sys/kernel/debug/hisi_hpre/<bdf>/hpre_dfx/send_cnt
122Date:		Apr 2020
123Contact:	linux-crypto@vger.kernel.org
124Description:	Dump the total number of sent requests.
125		Available for both PF and VF, and take no other effect on HPRE.
126
127What:		/sys/kernel/debug/hisi_hpre/<bdf>/hpre_dfx/recv_cnt
128Date:		Apr 2020
129Contact:	linux-crypto@vger.kernel.org
130Description:	Dump the total number of received requests.
131		Available for both PF and VF, and take no other effect on HPRE.
132
133What:		/sys/kernel/debug/hisi_hpre/<bdf>/hpre_dfx/send_busy_cnt
134Date:		Apr 2020
135Contact:	linux-crypto@vger.kernel.org
136Description:	Dump the total number of requests sent
137		with returning busy.
138		Available for both PF and VF, and take no other effect on HPRE.
139
140What:		/sys/kernel/debug/hisi_hpre/<bdf>/hpre_dfx/send_fail_cnt
141Date:		Apr 2020
142Contact:	linux-crypto@vger.kernel.org
143Description:	Dump the total number of completed but error requests.
144		Available for both PF and VF, and take no other effect on HPRE.
145
146What:		/sys/kernel/debug/hisi_hpre/<bdf>/hpre_dfx/invalid_req_cnt
147Date:		Apr 2020
148Contact:	linux-crypto@vger.kernel.org
149Description:	Dump the total number of invalid requests being received.
150		Available for both PF and VF, and take no other effect on HPRE.
151
152What:		/sys/kernel/debug/hisi_hpre/<bdf>/hpre_dfx/overtime_thrhld
153Date:		Apr 2020
154Contact:	linux-crypto@vger.kernel.org
155Description:	Set the threshold time for counting the request which is
156		processed longer than the threshold.
157		0: disable(default), 1: 1 microsecond.
158		Available for both PF and VF, and take no other effect on HPRE.
159
160What:		/sys/kernel/debug/hisi_hpre/<bdf>/hpre_dfx/over_thrhld_cnt
161Date:		Apr 2020
162Contact:	linux-crypto@vger.kernel.org
163Description:	Dump the total number of time out requests.
164		Available for both PF and VF, and take no other effect on HPRE.
165