2022-06-27 08:36:49 +00:00
|
|
|
What: /sys/bus/pci/devices/<BDF>/qat/state
|
|
|
|
Date: June 2022
|
2023-01-19 08:05:08 +00:00
|
|
|
KernelVersion: 6.0
|
2022-06-27 08:36:49 +00:00
|
|
|
Contact: qat-linux@intel.com
|
2022-07-13 08:56:28 +00:00
|
|
|
Description: (RW) Reports the current state of the QAT device. Write to
|
|
|
|
the file to start or stop the device.
|
2022-06-27 08:36:49 +00:00
|
|
|
|
2022-07-13 08:56:28 +00:00
|
|
|
The values are:
|
2022-06-27 08:36:49 +00:00
|
|
|
|
2022-07-13 08:56:28 +00:00
|
|
|
* up: the device is up and running
|
|
|
|
* down: the device is down
|
2022-06-27 08:36:49 +00:00
|
|
|
|
|
|
|
|
|
|
|
It is possible to transition the device from up to down only
|
|
|
|
if the device is up and vice versa.
|
|
|
|
|
|
|
|
This attribute is only available for qat_4xxx devices.
|
2022-06-27 08:36:52 +00:00
|
|
|
|
|
|
|
What: /sys/bus/pci/devices/<BDF>/qat/cfg_services
|
|
|
|
Date: June 2022
|
2023-01-19 08:05:08 +00:00
|
|
|
KernelVersion: 6.0
|
2022-06-27 08:36:52 +00:00
|
|
|
Contact: qat-linux@intel.com
|
2022-07-13 08:56:28 +00:00
|
|
|
Description: (RW) Reports the current configuration of the QAT device.
|
|
|
|
Write to the file to change the configured services.
|
|
|
|
|
|
|
|
The values are:
|
|
|
|
|
|
|
|
* sym;asym: the device is configured for running crypto
|
|
|
|
services
|
crypto: qat - extend configuration for 4xxx
A QAT GEN4 device can be currently configured for crypto (sym;asym) or
compression (dc).
This patch extends the configuration to support more variations of these
services, download the correct FW images on the device and report the
correct capabilities on the device based on the configured service.
The device can now be configured with the following services:
"sym", "asym", "dc", "sym;asym", "asym;sym", "sym;dc", "dc;sym",
"asym;dc", "dc;asym".
With this change, the configuration "sym", "asym", "sym;dc", "dc;sym",
"asym;dc", "dc;asym" will be accessible only via userspace, i.e. the driver
for those configurations will not register into the crypto framework.
Support for such configurations in kernel will be enabled in a later
patch.
The pairs "sym;asym" and "asym;sym" result in identical device config.
As do "sym;dc", "dc;sym", and "asym;dc", "dc;asym".
Signed-off-by: Adam Guerin <adam.guerin@intel.com>
Reviewed-by: Giovanni Cabiddu <giovanni.cabiddu@intel.com>
Reviewed-by: Andy Shevchenko <andriy.shevchenko@linux.intel.com>
Signed-off-by: Herbert Xu <herbert@gondor.apana.org.au>
2023-06-09 16:38:22 +00:00
|
|
|
* asym;sym: identical to sym;asym
|
2022-07-13 08:56:28 +00:00
|
|
|
* dc: the device is configured for running compression services
|
2023-09-14 14:14:13 +00:00
|
|
|
* dcc: identical to dc but enables the dc chaining feature,
|
|
|
|
hash then compression. If this is not required chose dc
|
crypto: qat - extend configuration for 4xxx
A QAT GEN4 device can be currently configured for crypto (sym;asym) or
compression (dc).
This patch extends the configuration to support more variations of these
services, download the correct FW images on the device and report the
correct capabilities on the device based on the configured service.
The device can now be configured with the following services:
"sym", "asym", "dc", "sym;asym", "asym;sym", "sym;dc", "dc;sym",
"asym;dc", "dc;asym".
With this change, the configuration "sym", "asym", "sym;dc", "dc;sym",
"asym;dc", "dc;asym" will be accessible only via userspace, i.e. the driver
for those configurations will not register into the crypto framework.
Support for such configurations in kernel will be enabled in a later
patch.
The pairs "sym;asym" and "asym;sym" result in identical device config.
As do "sym;dc", "dc;sym", and "asym;dc", "dc;asym".
Signed-off-by: Adam Guerin <adam.guerin@intel.com>
Reviewed-by: Giovanni Cabiddu <giovanni.cabiddu@intel.com>
Reviewed-by: Andy Shevchenko <andriy.shevchenko@linux.intel.com>
Signed-off-by: Herbert Xu <herbert@gondor.apana.org.au>
2023-06-09 16:38:22 +00:00
|
|
|
* sym: the device is configured for running symmetric crypto
|
|
|
|
services
|
|
|
|
* asym: the device is configured for running asymmetric crypto
|
|
|
|
services
|
|
|
|
* asym;dc: the device is configured for running asymmetric
|
|
|
|
crypto services and compression services
|
|
|
|
* dc;asym: identical to asym;dc
|
|
|
|
* sym;dc: the device is configured for running symmetric crypto
|
|
|
|
services and compression services
|
|
|
|
* dc;sym: identical to sym;dc
|
2022-06-27 08:36:52 +00:00
|
|
|
|
|
|
|
It is possible to set the configuration only if the device
|
|
|
|
is in the `down` state (see /sys/bus/pci/devices/<BDF>/qat/state)
|
|
|
|
|
|
|
|
The following example shows how to change the configuration of
|
|
|
|
a device configured for running crypto services in order to
|
2022-07-13 08:56:27 +00:00
|
|
|
run data compression::
|
|
|
|
|
2022-06-27 08:36:52 +00:00
|
|
|
# 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
|
|
|
|
|
|
|
|
This attribute is only available for qat_4xxx devices.
|
2023-06-09 17:06:14 +00:00
|
|
|
|
|
|
|
What: /sys/bus/pci/devices/<BDF>/qat/pm_idle_enabled
|
|
|
|
Date: June 2023
|
|
|
|
KernelVersion: 6.5
|
|
|
|
Contact: qat-linux@intel.com
|
|
|
|
Description: (RW) This configuration option provides a way to force the device into remaining in
|
|
|
|
the MAX power state.
|
|
|
|
If idle support is enabled the device will transition to the `MIN` power state when
|
|
|
|
idle, otherwise will stay in the MAX power state.
|
|
|
|
Write to the file to enable or disable idle support.
|
|
|
|
|
|
|
|
The values are:
|
|
|
|
|
|
|
|
* 0: idle support is disabled
|
|
|
|
* 1: idle support is enabled
|
|
|
|
|
|
|
|
Default value is 1.
|
|
|
|
|
|
|
|
It is possible to set the pm_idle_enabled value only if the device
|
|
|
|
is in the `down` state (see /sys/bus/pci/devices/<BDF>/qat/state)
|
|
|
|
|
|
|
|
The following example shows how to change the pm_idle_enabled of
|
|
|
|
a device::
|
|
|
|
|
|
|
|
# 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
|
|
|
|
|
|
|
|
This attribute is only available for qat_4xxx devices.
|
2023-10-20 13:49:30 +00:00
|
|
|
|
|
|
|
What: /sys/bus/pci/devices/<BDF>/qat/rp2srv
|
|
|
|
Date: January 2024
|
|
|
|
KernelVersion: 6.7
|
|
|
|
Contact: qat-linux@intel.com
|
|
|
|
Description:
|
|
|
|
(RW) This attribute provides a way for a user to query a
|
|
|
|
specific ring pair for the type of service that it is currently
|
|
|
|
configured for.
|
|
|
|
|
|
|
|
When written to, the value is cached and used to perform the
|
|
|
|
read operation. Allowed values are in the range 0 to N-1, where
|
|
|
|
N is the max number of ring pairs supported by a device. This
|
|
|
|
can be queried using the attribute qat/num_rps.
|
|
|
|
|
|
|
|
A read returns the service associated to the ring pair queried.
|
|
|
|
|
|
|
|
The values are:
|
|
|
|
|
|
|
|
* dc: the ring pair is configured for running compression services
|
|
|
|
* sym: the ring pair is configured for running symmetric crypto
|
|
|
|
services
|
|
|
|
* asym: the ring pair is configured for running asymmetric crypto
|
|
|
|
services
|
|
|
|
|
|
|
|
Example usage::
|
|
|
|
|
|
|
|
# echo 1 > /sys/bus/pci/devices/<BDF>/qat/rp2srv
|
|
|
|
# cat /sys/bus/pci/devices/<BDF>/qat/rp2srv
|
|
|
|
sym
|
|
|
|
|
|
|
|
This attribute is only available for qat_4xxx devices.
|
2023-10-20 13:49:31 +00:00
|
|
|
|
|
|
|
What: /sys/bus/pci/devices/<BDF>/qat/num_rps
|
|
|
|
Date: January 2024
|
|
|
|
KernelVersion: 6.7
|
|
|
|
Contact: qat-linux@intel.com
|
|
|
|
Description:
|
|
|
|
(RO) Returns the number of ring pairs that a single device has.
|
|
|
|
|
|
|
|
Example usage::
|
|
|
|
|
|
|
|
# cat /sys/bus/pci/devices/<BDF>/qat/num_rps
|
|
|
|
64
|
|
|
|
|
|
|
|
This attribute is only available for qat_4xxx devices.
|