0001 What: /sys/kernel/debug/hisi_zip/<bdf>/comp_core[01]/regs
0002 Date: Nov 2018
0003 Contact: linux-crypto@vger.kernel.org
0004 Description: Dump of compression cores related debug registers.
0005 Only available for PF.
0006
0007 What: /sys/kernel/debug/hisi_zip/<bdf>/decomp_core[0-5]/regs
0008 Date: Nov 2018
0009 Contact: linux-crypto@vger.kernel.org
0010 Description: Dump of decompression cores related debug registers.
0011 Only available for PF.
0012
0013 What: /sys/kernel/debug/hisi_zip/<bdf>/clear_enable
0014 Date: Nov 2018
0015 Contact: linux-crypto@vger.kernel.org
0016 Description: Compression/decompression core debug registers read clear
0017 control. 1 means enable register read clear, otherwise 0.
0018 Writing to this file has no functional effect, only enable or
0019 disable counters clear after reading of these registers.
0020 Only available for PF.
0021
0022 What: /sys/kernel/debug/hisi_zip/<bdf>/current_qm
0023 Date: Nov 2018
0024 Contact: linux-crypto@vger.kernel.org
0025 Description: One ZIP controller has one PF and multiple VFs, each function
0026 has a QM. Select the QM which below qm refers to.
0027 Only available for PF.
0028
0029 What: /sys/kernel/debug/hisi_zip/<bdf>/alg_qos
0030 Date: Jun 2021
0031 Contact: linux-crypto@vger.kernel.org
0032 Description: The <bdf> is related the function for PF and VF.
0033 ZIP driver supports to configure each function's QoS, the driver
0034 supports to write <bdf> value to alg_qos in the host. Such as
0035 "echo <bdf> value > alg_qos". The qos value is 1~1000, means
0036 1/1000~1000/1000 of total QoS. The driver reading alg_qos to
0037 get related QoS in the host and VM, Such as "cat alg_qos".
0038
0039 What: /sys/kernel/debug/hisi_zip/<bdf>/qm/regs
0040 Date: Nov 2018
0041 Contact: linux-crypto@vger.kernel.org
0042 Description: Dump of QM related debug registers.
0043 Available for PF and VF in host. VF in guest currently only
0044 has one debug register.
0045
0046 What: /sys/kernel/debug/hisi_zip/<bdf>/qm/current_q
0047 Date: Nov 2018
0048 Contact: linux-crypto@vger.kernel.org
0049 Description: One QM may contain multiple queues. Select specific queue to
0050 show its debug registers in above regs.
0051 Only available for PF.
0052
0053 What: /sys/kernel/debug/hisi_zip/<bdf>/qm/clear_enable
0054 Date: Nov 2018
0055 Contact: linux-crypto@vger.kernel.org
0056 Description: QM debug registers(regs) read clear control. 1 means enable
0057 register read clear, otherwise 0.
0058 Writing to this file has no functional effect, only enable or
0059 disable counters clear after reading of these registers.
0060 Only available for PF.
0061
0062 What: /sys/kernel/debug/hisi_zip/<bdf>/qm/err_irq
0063 Date: Apr 2020
0064 Contact: linux-crypto@vger.kernel.org
0065 Description: Dump the number of invalid interrupts for
0066 QM task completion.
0067 Available for both PF and VF, and take no other effect on ZIP.
0068
0069 What: /sys/kernel/debug/hisi_zip/<bdf>/qm/aeq_irq
0070 Date: Apr 2020
0071 Contact: linux-crypto@vger.kernel.org
0072 Description: Dump the number of QM async event queue interrupts.
0073 Available for both PF and VF, and take no other effect on ZIP.
0074
0075 What: /sys/kernel/debug/hisi_zip/<bdf>/qm/abnormal_irq
0076 Date: Apr 2020
0077 Contact: linux-crypto@vger.kernel.org
0078 Description: Dump the number of interrupts for QM abnormal event.
0079 Available for both PF and VF, and take no other effect on ZIP.
0080
0081 What: /sys/kernel/debug/hisi_zip/<bdf>/qm/create_qp_err
0082 Date: Apr 2020
0083 Contact: linux-crypto@vger.kernel.org
0084 Description: Dump the number of queue allocation errors.
0085 Available for both PF and VF, and take no other effect on ZIP.
0086
0087 What: /sys/kernel/debug/hisi_zip/<bdf>/qm/mb_err
0088 Date: Apr 2020
0089 Contact: linux-crypto@vger.kernel.org
0090 Description: Dump the number of failed QM mailbox commands.
0091 Available for both PF and VF, and take no other effect on ZIP.
0092
0093 What: /sys/kernel/debug/hisi_zip/<bdf>/qm/status
0094 Date: Apr 2020
0095 Contact: linux-crypto@vger.kernel.org
0096 Description: Dump the status of the QM.
0097 Four states: initiated, started, stopped and closed.
0098 Available for both PF and VF, and take no other effect on ZIP.
0099
0100 What: /sys/kernel/debug/hisi_zip/<bdf>/qm/diff_regs
0101 Date: Mar 2022
0102 Contact: linux-crypto@vger.kernel.org
0103 Description: QM debug registers(regs) read hardware register value. This
0104 node is used to show the change of the qm registers value. This
0105 node can be help users to check the change of register values.
0106
0107 What: /sys/kernel/debug/hisi_zip/<bdf>/zip_dfx/diff_regs
0108 Date: Mar 2022
0109 Contact: linux-crypto@vger.kernel.org
0110 Description: ZIP debug registers(regs) read hardware register value. This
0111 node is used to show the change of the registers value. this
0112 node can be help users to check the change of register values.
0113
0114 What: /sys/kernel/debug/hisi_zip/<bdf>/zip_dfx/send_cnt
0115 Date: Apr 2020
0116 Contact: linux-crypto@vger.kernel.org
0117 Description: Dump the total number of sent requests.
0118 Available for both PF and VF, and take no other effect on ZIP.
0119
0120 What: /sys/kernel/debug/hisi_zip/<bdf>/zip_dfx/recv_cnt
0121 Date: Apr 2020
0122 Contact: linux-crypto@vger.kernel.org
0123 Description: Dump the total number of received requests.
0124 Available for both PF and VF, and take no other effect on ZIP.
0125
0126 What: /sys/kernel/debug/hisi_zip/<bdf>/zip_dfx/send_busy_cnt
0127 Date: Apr 2020
0128 Contact: linux-crypto@vger.kernel.org
0129 Description: Dump the total number of requests received
0130 with returning busy.
0131 Available for both PF and VF, and take no other effect on ZIP.
0132
0133 What: /sys/kernel/debug/hisi_zip/<bdf>/zip_dfx/err_bd_cnt
0134 Date: Apr 2020
0135 Contact: linux-crypto@vger.kernel.org
0136 Description: Dump the total number of BD type error requests
0137 to be received.
0138 Available for both PF and VF, and take no other effect on ZIP.
