linux-imx/sysfs-driver-qat at lf-6.6.y

mirror of https://github.com/nxp-imx/linux-imx.git synced 2025-09-03 02:16:09 +02:00

Adam Guerin 2e513f6bc7 crypto: qat - enable dc chaining service

[ Upstream commit 37b14f2dfa ]

QAT GEN4 devices support chained compression operations. These
allow, with a single request to firmware, to hash then compress
data.

Extend the configuration to enable such mode. The cfg_services
operations in sysfs are extended to allow the string "dcc". When
selected, the driver downloads to the device both the symmetric
crypto and the compression firmware images and sends an admin message
to firmware which enables `chained` operations.
In addition, it sets the device's capabilities as the combination
of compression and symmetric crypto capabilities, while excluding
the ICP_ACCEL_CAPABILITIES_CRYPTO_SYMMETRIC bit to indicate
that in this mode, symmetric crypto instances are not supported.

When "dcc" is enabled, the device will handle compression requests
as if the "dc" configuration is loaded ("dcc" is a variation of "dc")
and the driver will register the acomp algorithms.

As for the other extended configurations, "dcc" is only available for
qat_4xxx devices and the chaining service will be only accessible from
user space.

Signed-off-by: Adam Guerin <adam.guerin@intel.com>
Reviewed-by: Giovanni Cabiddu <giovanni.cabiddu@intel.com>
Signed-off-by: Herbert Xu <herbert@gondor.apana.org.au>
Stable-dep-of: a238487f79 ("crypto: qat - fix ring to service map for QAT GEN4")
Signed-off-by: Sasha Levin <sashal@kernel.org>

2023-11-20 11:59:23 +01:00

3.2 KiB

Raw Permalink Blame History

What: /sys/bus/pci/devices//qat/state Date: June 2022 KernelVersion: 6.0 Contact: qat-linux@intel.com Description: (RW) Reports the current state of the QAT device. Write to the file to start or stop the device.

	The values are:

	* up: the device is up and running
	* down: the device is down


	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.

What: /sys/bus/pci/devices//qat/cfg_services Date: June 2022 KernelVersion: 6.0 Contact: qat-linux@intel.com 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
	* asym;sym: identical to sym;asym
	* dc: the device is configured for running compression services
	* dcc: identical to dc but enables the dc chaining feature,
	  hash then compression. If this is not required chose dc
	* 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

	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
	run data compression::

		# 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.

What: /sys/bus/pci/devices//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.

3.2 KiB Raw Permalink Blame History

3.2 KiB

Raw Permalink Blame History