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

Jason Gunthorpe
2024-07-29T16:11:25Z

On Fri, Jul 26, 2024 at 04:50:21PM +0100, Jonathan Cameron wrote:
>
> > 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

Yep, Randy noted it too

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

Thanks!

Jason