linux-kernel.vger.kernel.org archive mirror
 help / color / mirror / Atom feed
From: Lizhi Hou <lizhi.hou@xilinx.com>
To: <linux-kernel@vger.kernel.org>
Cc: Lizhi Hou <lizhi.hou@xilinx.com>, <linux-fpga@vger.kernel.org>,
	<maxz@xilinx.com>, <sonal.santan@xilinx.com>, <yliu@xilinx.com>,
	<michal.simek@xilinx.com>, <stefanos@xilinx.com>,
	<devicetree@vger.kernel.org>, <trix@redhat.com>, <mdf@kernel.org>,
	<robh@kernel.org>, <dwmw2@infradead.org>
Subject: [PATCH V4 XRT Alveo Infrastructure 0/5] XRT Alveo driver infrastructure overview
Date: Wed, 5 Jan 2022 14:50:08 -0800	[thread overview]
Message-ID: <20220105225013.1567871-1-lizhi.hou@xilinx.com> (raw)

Hello,

This V4 of patch series builds the core infrastructure for Xilinx Alveo PCIe 
accelerator cards. This patch series incorporates feedback on the usage of
device tree for describing HW subsystems or endpoints as they are called
here. An endpoint is exposed as an addressable range in a PCIe BAR exposed
by the Alveo device and optionally includes an interrupt specification.

The patch series includes Documentation/xrt.rst which describes Alveo
platform, XRT driver architecture and deployment model in more detail.

The Alveo PCIe device uses Device Tree blob to describe its HW subsystems.
Each device tree node represents a hardware endpoint and each endpoint
is an hardware unit which requires a driver. XRT driver infrastructure 
unflattens the device tree blob and overlays the device nodes
to the system device tree. of/unittest.c, pci/hotplug/pnv_php.c and other
linux kernel code are referenced for usage of OF functions.

The unflattened device nodes will be populated by existing Linux platform
device and OF infrastructure. This means a platform device will be created
for each endpoint node. And the platform driver will be bound based on
'compatible' property defined in endpoint node.

This patch series uses a builtin test device tree blob which contains only
one endpoint as an input.

--
Changes since v3:
- Removed xrt bus type, device and driver. Instead, the device nodes are
  populated by existing platform device and OF infrastructure.
- fixed issue reported by kernel robot

Changes since v2:
- reversed the change of of_fdt_unflatten_tree()
- unified default of_root creation with unittest code

Changes since v1:
- fixed 'make dt_binding_check' errors.

--
References:
- V3 version of patch series.
    https://lore.kernel.org/lkml/20211204003957.1448567-1-lizhi.hou@xilinx.com/
- XRT V9 driver patch series before major restructure.
    https://lore.kernel.org/lkml/20210802160521.331031-1-lizhi.hou@xilinx.com/

Lizhi Hou (5):
  Documentation: fpga: Add a document describing XRT Alveo driver
    infrastructure
  Documentation: devicetree: bindings: add binding for Alveo platform
  of: create empty of root
  fpga: xrt: xrt-lib common interfaces
  fpga: xrt: management physical function driver

 .../bindings/fpga/xlnx,alveo-partition.yaml   |  76 ++++
 .../fpga/xlnx,alveo-pr-isolation.yaml         |  40 +++
 Documentation/fpga/index.rst                  |   1 +
 Documentation/fpga/xrt.rst                    | 337 ++++++++++++++++++
 MAINTAINERS                                   |  10 +
 drivers/fpga/Kconfig                          |   3 +
 drivers/fpga/Makefile                         |   4 +
 drivers/fpga/xrt/Kconfig                      |   7 +
 drivers/fpga/xrt/include/xpartition.h         |  28 ++
 drivers/fpga/xrt/lib/Kconfig                  |  17 +
 drivers/fpga/xrt/lib/Makefile                 |  15 +
 drivers/fpga/xrt/lib/lib-drv.c                | 178 +++++++++
 drivers/fpga/xrt/lib/lib-drv.h                |  15 +
 drivers/fpga/xrt/mgmt/Kconfig                 |  14 +
 drivers/fpga/xrt/mgmt/Makefile                |  16 +
 drivers/fpga/xrt/mgmt/dt-test.dts             |  12 +
 drivers/fpga/xrt/mgmt/dt-test.h               |  15 +
 drivers/fpga/xrt/mgmt/xmgmt-drv.c             | 158 ++++++++
 drivers/of/Makefile                           |   5 +
 drivers/of/fdt.c                              |  90 +++++
 drivers/of/fdt_default.dts                    |   5 +
 drivers/of/of_private.h                       |  17 +
 drivers/of/unittest.c                         |  72 +---
 23 files changed, 1066 insertions(+), 69 deletions(-)
 create mode 100644 Documentation/devicetree/bindings/fpga/xlnx,alveo-partition.yaml
 create mode 100644 Documentation/devicetree/bindings/fpga/xlnx,alveo-pr-isolation.yaml
 create mode 100644 Documentation/fpga/xrt.rst
 create mode 100644 drivers/fpga/xrt/Kconfig
 create mode 100644 drivers/fpga/xrt/include/xpartition.h
 create mode 100644 drivers/fpga/xrt/lib/Kconfig
 create mode 100644 drivers/fpga/xrt/lib/Makefile
 create mode 100644 drivers/fpga/xrt/lib/lib-drv.c
 create mode 100644 drivers/fpga/xrt/lib/lib-drv.h
 create mode 100644 drivers/fpga/xrt/mgmt/Kconfig
 create mode 100644 drivers/fpga/xrt/mgmt/Makefile
 create mode 100644 drivers/fpga/xrt/mgmt/dt-test.dts
 create mode 100644 drivers/fpga/xrt/mgmt/dt-test.h
 create mode 100644 drivers/fpga/xrt/mgmt/xmgmt-drv.c
 create mode 100644 drivers/of/fdt_default.dts

-- 
2.27.0


             reply	other threads:[~2022-01-05 22:50 UTC|newest]

Thread overview: 23+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2022-01-05 22:50 Lizhi Hou [this message]
2022-01-05 22:50 ` [PATCH V4 XRT Alveo Infrastructure 1/5] Documentation: fpga: Add a document describing XRT Alveo driver infrastructure Lizhi Hou
2022-01-09 17:38   ` Tom Rix
2022-01-05 22:50 ` [PATCH V4 XRT Alveo Infrastructure 2/5] Documentation: devicetree: bindings: add binding for Alveo platform Lizhi Hou
2022-01-09 17:46   ` Tom Rix
2022-01-05 22:50 ` [PATCH V4 XRT Alveo Infrastructure 3/5] of: create empty of root Lizhi Hou
2022-01-08  3:34   ` kernel test robot
2022-01-09 18:39   ` Tom Rix
2022-01-11  1:14     ` Lizhi Hou
2022-01-11  4:29   ` Xu Yilun
2022-01-19 18:59     ` Lizhi Hou
2022-01-21  1:42       ` Xu Yilun
2022-01-21 16:54         ` Lizhi Hou
2022-01-05 22:50 ` [PATCH V4 XRT Alveo Infrastructure 4/5] fpga: xrt: xrt-lib common interfaces Lizhi Hou
2022-01-09 21:16   ` Tom Rix
2022-01-11  6:35     ` Xu Yilun
2022-01-05 22:50 ` [PATCH V4 XRT Alveo Infrastructure 5/5] fpga: xrt: management physical function driver Lizhi Hou
2022-01-09 21:34   ` Tom Rix
2022-01-11  7:00   ` Xu Yilun
2022-01-13 23:41     ` Lizhi Hou
2022-01-14  1:43       ` Xu Yilun
2022-01-17 17:43         ` Lizhi Hou
2022-01-18  1:36           ` Xu Yilun

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20220105225013.1567871-1-lizhi.hou@xilinx.com \
    --to=lizhi.hou@xilinx.com \
    --cc=devicetree@vger.kernel.org \
    --cc=dwmw2@infradead.org \
    --cc=linux-fpga@vger.kernel.org \
    --cc=linux-kernel@vger.kernel.org \
    --cc=maxz@xilinx.com \
    --cc=mdf@kernel.org \
    --cc=michal.simek@xilinx.com \
    --cc=robh@kernel.org \
    --cc=sonal.santan@xilinx.com \
    --cc=stefanos@xilinx.com \
    --cc=trix@redhat.com \
    --cc=yliu@xilinx.com \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).