We're starting to see more of these kind of devices, the current upcoming wave will likely be around machine learning and inference engines. A few drivers have been added to drivers/misc for this, but it's timely to make it into a separate group of drivers/subsystem, to make it easier to find them, and to encourage collaboration between contributors. Over time, we expect to build shared frameworks that the drivers will make use of, but how that framework needs to look like to fill the needs is still unclear, and the best way to gain that knowledge is to give the disparate implementations a shared location. There has been some controversy around expectations for userspace stacks being open. The clear preference is to see that happen, and any driver and platform stack that is delivered like that will be given preferential treatment, and at some point in the future it might become the requirement. Until then, the bare minimum we need is an open low-level userspace such that the driver and HW interfaces can be exercised if someone is modifying the driver, even if the full details of the workload are not always available. Bootstrapping this with myself and Greg as maintainers (since the current drivers will be moving out of drivers/misc). Looking forward to expanding that group over time. Cc: Greg Kroah-Hartman <gregkh@xxxxxxxxxxxxxxxxxxx> Signed-off-by: Olof Johansson <olof@xxxxxxxxx> --- v2: I had missed a git add of the Documentation/ piece, which is the most important piece of this anyway. Sigh. Documentation/accelerators/README.rst | 42 +++++++++++++++++++++++++++++++++++ MAINTAINERS | 8 +++++++ drivers/Kconfig | 2 ++ drivers/Makefile | 1 + drivers/accel/Kconfig | 16 +++++++++++++ drivers/accel/Makefile | 5 +++++ 6 files changed, 74 insertions(+) create mode 100644 Documentation/accelerators/README.rst create mode 100644 drivers/accel/Kconfig create mode 100644 drivers/accel/Makefile diff --git a/Documentation/accelerators/README.rst b/Documentation/accelerators/README.rst new file mode 100644 index 0000000000000..79049ff99e93e --- /dev/null +++ b/Documentation/accelerators/README.rst @@ -0,0 +1,42 @@ +.. _readme: + +Hardware offload accelerator subsystem +====================================== + +This is a brief overview of the subsystem (grouping) of hardware +accelerators kept under drivers/accel + +Types of hardware supported +--------------------------- + + The general types of hardware supported are hardware devices that has + general interactions of sending commands and buffers to the hardware, + returning completions and possible filled buffers back, together + with the usual driver pieces around hardware control, setup, error + handling, etc. + + Drivers that fit into other subsystems are expected to be merged + there, and use the appropriate userspace interfaces of said functional + areas. We don't expect to see drivers for network, storage, graphics + and similar hardware implemented by drivers here. + +Expectations for contributions +------------------------------ + + - Platforms and hardware that has fully open stacks, from Firmware to + Userspace, are always going to be given preferential treatment. These + platforms give the best insight for behavior and interaction of all + layers, including ability to improve implementation across the stack + over time. + + - If a platform is partially proprietary, it is still expected that the + portions that interact the driver can be shared in a form that allows + for exercising the hardware/driver and evolution of the interface over + time. This could be separated into a shared library and test/sample + programs, for example. + + - Over time, there is an expectation to converge drivers over to shared + frameworks and interfaces. Until then, the general rule is that no + more than one driver per vendor will be acceptable. For vendors that + aren't participating in the work towards shared frameworks over time, + we reserve the right to phase out support for the hardware. diff --git a/MAINTAINERS b/MAINTAINERS index ddcdc29dfe1f6..8a9bbaf8f6e90 100644 --- a/MAINTAINERS +++ b/MAINTAINERS @@ -7033,6 +7033,14 @@ W: https://linuxtv.org S: Supported F: drivers/media/platform/sti/hva +HW ACCELERATOR OFFLOAD SUBSYSTEM +M: Olof Johansson <olof@xxxxxxxxx> +M: Greg Kroah-Hartman <gregkh@xxxxxxxxxxxxxxxxxxx> +L: linux-accelerators@xxxxxxxxxxxxxxxx +S: Supported +F: drivers/accel/ +F: Documentation/accelerators/ + HWPOISON MEMORY FAILURE HANDLING M: Naoya Horiguchi <n-horiguchi@xxxxxxxxxxxxx> L: linux-mm@xxxxxxxxx diff --git a/drivers/Kconfig b/drivers/Kconfig index 4f9f99057ff85..3cc461f325569 100644 --- a/drivers/Kconfig +++ b/drivers/Kconfig @@ -228,4 +228,6 @@ source "drivers/siox/Kconfig" source "drivers/slimbus/Kconfig" +source "drivers/accel/Kconfig" + endmenu diff --git a/drivers/Makefile b/drivers/Makefile index 04da7876032cc..e4be06579cc5d 100644 --- a/drivers/Makefile +++ b/drivers/Makefile @@ -186,3 +186,4 @@ obj-$(CONFIG_MULTIPLEXER) += mux/ obj-$(CONFIG_UNISYS_VISORBUS) += visorbus/ obj-$(CONFIG_SIOX) += siox/ obj-$(CONFIG_GNSS) += gnss/ +obj-$(CONFIG_ACCEL) += accel/ diff --git a/drivers/accel/Kconfig b/drivers/accel/Kconfig new file mode 100644 index 0000000000000..13b36c0398895 --- /dev/null +++ b/drivers/accel/Kconfig @@ -0,0 +1,16 @@ +# +# Drivers for hardware offload accelerators +# See Documentation/accel/README.rst for more details +# + +menuconfig ACCEL + bool "Hardware offload accelerator support" + help + HW offload accelerators are used for high-bandwidth workloads + where a higher-level kernel/userspace interface isn't suitable. + +if ACCEL + +comment "HW Accellerator drivers" + +endif diff --git a/drivers/accel/Makefile b/drivers/accel/Makefile new file mode 100644 index 0000000000000..343bbb8f45a14 --- /dev/null +++ b/drivers/accel/Makefile @@ -0,0 +1,5 @@ +# SPDX-License-Identifier: GPL-2.0 +# +# Makefile for accel devices +# + -- 2.11.0