1What: /sys/kernel/debug/hisi_zip/<bdf>/comp_core[01]/regs 2Date: Nov 2018 3Contact: [email protected] 4Description: Dump of compression cores related debug registers. 5 Only available for PF. 6 7What: /sys/kernel/debug/hisi_zip/<bdf>/decomp_core[0-5]/regs 8Date: Nov 2018 9Contact: [email protected] 10Description: Dump of decompression cores related debug registers. 11 Only available for PF. 12 13What: /sys/kernel/debug/hisi_zip/<bdf>/clear_enable 14Date: Nov 2018 15Contact: [email protected] 16Description: Compression/decompression core debug registers read clear 17 control. 1 means enable register read clear, otherwise 0. 18 Writing to this file has no functional effect, only enable or 19 disable counters clear after reading of these registers. 20 Only available for PF. 21 22What: /sys/kernel/debug/hisi_zip/<bdf>/current_qm 23Date: Nov 2018 24Contact: [email protected] 25Description: One ZIP controller has one PF and multiple VFs, each function 26 has a QM. Select the QM which below qm refers to. 27 Only available for PF. 28 29What: /sys/kernel/debug/hisi_zip/<bdf>/alg_qos 30Date: Jun 2021 31Contact: [email protected] 32Description: The <bdf> is related the function for PF and VF. 33 ZIP driver supports to configure each function's QoS, the driver 34 supports to write <bdf> value to alg_qos in the host. Such as 35 "echo <bdf> value > alg_qos". The qos value is 1~1000, means 36 1/1000~1000/1000 of total QoS. The driver reading alg_qos to 37 get related QoS in the host and VM, Such as "cat alg_qos". 38 39What: /sys/kernel/debug/hisi_zip/<bdf>/qm/regs 40Date: Nov 2018 41Contact: [email protected] 42Description: Dump of QM related debug registers. 43 Available for PF and VF in host. VF in guest currently only 44 has one debug register. 45 46What: /sys/kernel/debug/hisi_zip/<bdf>/qm/current_q 47Date: Nov 2018 48Contact: [email protected] 49Description: One QM may contain multiple queues. Select specific queue to 50 show its debug registers in above regs. 51 Only available for PF. 52 53What: /sys/kernel/debug/hisi_zip/<bdf>/qm/clear_enable 54Date: Nov 2018 55Contact: [email protected] 56Description: QM debug registers(regs) read clear control. 1 means enable 57 register read clear, otherwise 0. 58 Writing to this file has no functional effect, only enable or 59 disable counters clear after reading of these registers. 60 Only available for PF. 61 62What: /sys/kernel/debug/hisi_zip/<bdf>/qm/err_irq 63Date: Apr 2020 64Contact: [email protected] 65Description: Dump the number of invalid interrupts for 66 QM task completion. 67 Available for both PF and VF, and take no other effect on ZIP. 68 69What: /sys/kernel/debug/hisi_zip/<bdf>/qm/aeq_irq 70Date: Apr 2020 71Contact: [email protected] 72Description: Dump the number of QM async event queue interrupts. 73 Available for both PF and VF, and take no other effect on ZIP. 74 75What: /sys/kernel/debug/hisi_zip/<bdf>/qm/abnormal_irq 76Date: Apr 2020 77Contact: [email protected] 78Description: Dump the number of interrupts for QM abnormal event. 79 Available for both PF and VF, and take no other effect on ZIP. 80 81What: /sys/kernel/debug/hisi_zip/<bdf>/qm/create_qp_err 82Date: Apr 2020 83Contact: [email protected] 84Description: Dump the number of queue allocation errors. 85 Available for both PF and VF, and take no other effect on ZIP. 86 87What: /sys/kernel/debug/hisi_zip/<bdf>/qm/mb_err 88Date: Apr 2020 89Contact: [email protected] 90Description: Dump the number of failed QM mailbox commands. 91 Available for both PF and VF, and take no other effect on ZIP. 92 93What: /sys/kernel/debug/hisi_zip/<bdf>/qm/status 94Date: Apr 2020 95Contact: [email protected] 96Description: Dump the status of the QM. 97 Two states: work, stop. 98 Available for both PF and VF, and take no other effect on ZIP. 99 100What: /sys/kernel/debug/hisi_zip/<bdf>/qm/diff_regs 101Date: Mar 2022 102Contact: [email protected] 103Description: QM debug registers(regs) read hardware register value. This 104 node is used to show the change of the qm registers value. This 105 node can be help users to check the change of register values. 106 107What: /sys/kernel/debug/hisi_zip/<bdf>/qm/qm_state 108Date: Jan 2024 109Contact: [email protected] 110Description: Dump the state of the device. 111 0: busy, 1: idle. 112 Only available for PF, and take no other effect on ZIP. 113 114What: /sys/kernel/debug/hisi_zip/<bdf>/qm/dev_timeout 115Date: Feb 2024 116Contact: [email protected] 117Description: Set the wait time when stop queue fails. Available for both PF 118 and VF, and take no other effect on ZIP. 119 0: not wait(default), others value: wait dev_timeout * 20 microsecond. 120 121What: /sys/kernel/debug/hisi_zip/<bdf>/qm/dev_state 122Date: Feb 2024 123Contact: [email protected] 124Description: Dump the stop queue status of the QM. The default value is 0, 125 if dev_timeout is set, when stop queue fails, the dev_state 126 will return non-zero value. Available for both PF and VF, 127 and take no other effect on ZIP. 128 129What: /sys/kernel/debug/hisi_zip/<bdf>/zip_dfx/diff_regs 130Date: Mar 2022 131Contact: [email protected] 132Description: ZIP debug registers(regs) read hardware register value. This 133 node is used to show the change of the registers value. this 134 node can be help users to check the change of register values. 135 136What: /sys/kernel/debug/hisi_zip/<bdf>/zip_dfx/send_cnt 137Date: Apr 2020 138Contact: [email protected] 139Description: Dump the total number of sent requests. 140 Available for both PF and VF, and take no other effect on ZIP. 141 142What: /sys/kernel/debug/hisi_zip/<bdf>/zip_dfx/recv_cnt 143Date: Apr 2020 144Contact: [email protected] 145Description: Dump the total number of received requests. 146 Available for both PF and VF, and take no other effect on ZIP. 147 148What: /sys/kernel/debug/hisi_zip/<bdf>/zip_dfx/send_busy_cnt 149Date: Apr 2020 150Contact: [email protected] 151Description: Dump the total number of requests received 152 with returning busy. 153 Available for both PF and VF, and take no other effect on ZIP. 154 155What: /sys/kernel/debug/hisi_zip/<bdf>/zip_dfx/err_bd_cnt 156Date: Apr 2020 157Contact: [email protected] 158Description: Dump the total number of BD type error requests 159 to be received. 160 Available for both PF and VF, and take no other effect on ZIP. 161 162What: /sys/kernel/debug/hisi_zip/<bdf>/cap_regs 163Date: Oct 2024 164Contact: [email protected] 165Description: Dump the values of the qm and zip capability bit registers and 166 support the query of device specifications to facilitate fault locating. 167 Available for both PF and VF, and take no other effect on ZIP. 168