Subject: Re: [PATCH v2 6/8] fwctl: Add documentation

From: Jonathan Cameron <[email-masked]>
Date: Fri, 26 Jul 2024 16:50:21 +0100

> diff --git a/Documentation/userspace-api/fwctl.rst b/Documentation/userspace-api/fwctl.rst
> new file mode 100644
> index 00000000000000..ece2db2530502f
> --- /dev/null
> +++ b/Documentation/userspace-api/fwctl.rst
> @@ -0,0 +1,269 @@

> +Overview
> +========
> +
> +Modern devices contain extensive amounts of FW, and in many cases, are largely

FW and, in many cases, are

> +software-defined pieces of hardware. The evolution of this approach is largely a
> +reaction to Moore's Law where a chip tape out is now highly expensive, and the
> +chip design is extremely large. Replacing fixed HW logic with a flexible and
> +tightly coupled FW/HW combination is an effective risk mitigation against chip
> +respin. Problems in the HW design can be counteracted in device FW. This is
> +especially true for devices which present a stable and backwards compatible
> +interface to the operating system driver (such as NVMe).

...

The document lays out where this sits well.

Jonathan