| lists.openwall.net | lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC | |
|
Open Source and information security mailing list archives
| ||
|
Message-ID: <20201217075046.28553-1-sonals@xilinx.com>
Date: Wed, 16 Dec 2020 23:50:40 -0800
From: Sonal Santan <sonal.santan@...inx.com>
To: <linux-kernel@...r.kernel.org>
CC: Sonal Santan <sonals@...inx.com>, <linux-fpga@...r.kernel.org>,
<maxz@...inx.com>, <lizhih@...inx.com>, <michal.simek@...inx.com>,
<stefanos@...inx.com>, <devicetree@...r.kernel.org>,
<trix@...hat.com>, <mdf@...nel.org>
Subject: [PATCH V2 XRT Alveo 0/6] XRT Alveo driver overview
Hello,
This is V2 of patch series which adds management physical function driver
for Xilinx Alveo PCIe accelerator cards,
https://www.xilinx.com/products/boards-and-kits/alveo.html
This driver is part of Xilinx Runtime (XRT) open source stack.
The patch series depends on libfdt patches which were posted before:
https://lore.kernel.org/lkml/20201128235659.24679-1-sonals@xilinx.com/
https://lore.kernel.org/lkml/20201128235659.24679-2-sonals@xilinx.com/
ALVEO PLATFORM ARCHITECTURE
Alveo PCIe FPGA based platforms have a static *shell* partition and a partial
re-configurable *user* partition. The shell partition is automatically loaded from
flash when host is booted and PCIe is enumerated by BIOS. Shell cannot be changed
till the next cold reboot. The shell exposes two PCIe physical functions:
1. management physical function
2. user physical function
The patch series includes Documentation/xrt.rst which describes Alveo
platform, XRT driver architecture and deployment model in more detail.
Users compile their high level design in C/C++/OpenCL or RTL into FPGA image
using Vitis https://www.xilinx.com/products/design-tools/vitis/vitis-platform.html
tools. The compiled image is packaged as xclbin and contains partial bitstream
for the user partition and necessary metadata. Users can dynamically swap the
image running on the user partition in order to switch between different workloads.
XRT DRIVERS FOR ALVEO
XRT Linux kernel driver *xmgmt* binds to management physical function of
Alveo platform. The modular driver framework is organized into several
platform drivers which primarily handle the following functionality:
1. Loading firmware container also called xsabin at driver attach time
2. Loading of user compiled xclbin with FPGA Manager integration
3. Clock scaling of image running on user partition
4. In-band sensors: temp, voltage, power, etc.
5. Device reset and rescan
6. Flash upgrade of static *shell* partition
The platform drivers are packaged into *xrt-lib* helper module with a well
defined interfaces the details of which can be found in Documentation/xrt.rst.
User physical function driver is not included in this patch series.
TESTING AND VALIDATION
xmgmt driver can be tested with full XRT open source stack which includes
user space libraries, board utilities and (out of tree) first generation
user physical function driver xocl. XRT open source runtime stack is
available at https://github.com/Xilinx/XRT
Complete documentation for XRT open source stack including sections on
Alveo/XRT security and platform architecture can be found here:
https://xilinx.github.io/XRT/master/html/index.html
https://xilinx.github.io/XRT/master/html/security.html
https://xilinx.github.io/XRT/master/html/platforms_partitions.html
Changes since v1:
- Updated the driver to use fpga_region and fpga_bridge for FPGA
programming
- Dropped subdev drivers not related to PR programming to focus on XRT
core framework
- Updated Documentation/fpga/xrt.rst with information on XRT core framework
- Addressed checkpatch issues
- Dropped xrt- prefix from some header files
For reference V1 version of patch series can be found here--
https://lore.kernel.org/lkml/20201129000040.24777-1-sonals@xilinx.com/
https://lore.kernel.org/lkml/20201129000040.24777-2-sonals@xilinx.com/
https://lore.kernel.org/lkml/20201129000040.24777-3-sonals@xilinx.com/
https://lore.kernel.org/lkml/20201129000040.24777-4-sonals@xilinx.com/
https://lore.kernel.org/lkml/20201129000040.24777-5-sonals@xilinx.com/
https://lore.kernel.org/lkml/20201129000040.24777-6-sonals@xilinx.com/
https://lore.kernel.org/lkml/20201129000040.24777-7-sonals@xilinx.com/
https://lore.kernel.org/lkml/20201129000040.24777-8-sonals@xilinx.com/
https://lore.kernel.org/lkml/20201129000040.24777-9-sonals@xilinx.com/
Thanks,
-Sonal
Sonal Santan (6):
Documentation: fpga: Add a document describing XRT Alveo drivers
fpga: xrt: infrastructure support for xmgmt driver
fpga: xrt: core infrastructure for xrt-lib module
fpga: xrt: XRT Alveo management physical function driver
fpga: xrt: platform drivers for subsystems in shell partition
fpga: xrt: Kconfig and Makefile updates for XRT drivers
Documentation/fpga/index.rst | 1 +
Documentation/fpga/xrt.rst | 649 +++++++++++
drivers/fpga/Kconfig | 2 +
drivers/fpga/Makefile | 4 +
drivers/fpga/xrt/Kconfig | 7 +
drivers/fpga/xrt/Makefile | 21 +
drivers/fpga/xrt/common/xrt-metadata.c | 590 ++++++++++
drivers/fpga/xrt/common/xrt-root.c | 737 +++++++++++++
drivers/fpga/xrt/common/xrt-root.h | 26 +
drivers/fpga/xrt/common/xrt-xclbin.c | 387 +++++++
drivers/fpga/xrt/common/xrt-xclbin.h | 48 +
drivers/fpga/xrt/include/metadata.h | 184 ++++
drivers/fpga/xrt/include/parent.h | 103 ++
drivers/fpga/xrt/include/partition.h | 33 +
drivers/fpga/xrt/include/subdev.h | 333 ++++++
drivers/fpga/xrt/include/subdev/axigate.h | 31 +
drivers/fpga/xrt/include/subdev/calib.h | 28 +
drivers/fpga/xrt/include/subdev/clkfreq.h | 21 +
drivers/fpga/xrt/include/subdev/clock.h | 29 +
drivers/fpga/xrt/include/subdev/gpio.h | 41 +
drivers/fpga/xrt/include/subdev/icap.h | 27 +
drivers/fpga/xrt/include/subdev/ucs.h | 22 +
drivers/fpga/xrt/include/xmgmt-main.h | 34 +
drivers/fpga/xrt/lib/Kconfig | 11 +
drivers/fpga/xrt/lib/Makefile | 30 +
drivers/fpga/xrt/lib/subdevs/xrt-axigate.c | 298 ++++++
drivers/fpga/xrt/lib/subdevs/xrt-calib.c | 226 ++++
drivers/fpga/xrt/lib/subdevs/xrt-clkfreq.c | 214 ++++
drivers/fpga/xrt/lib/subdevs/xrt-clock.c | 638 +++++++++++
drivers/fpga/xrt/lib/subdevs/xrt-gpio.c | 198 ++++
drivers/fpga/xrt/lib/subdevs/xrt-icap.c | 306 ++++++
drivers/fpga/xrt/lib/subdevs/xrt-partition.c | 261 +++++
drivers/fpga/xrt/lib/subdevs/xrt-ucs.c | 238 +++++
drivers/fpga/xrt/lib/subdevs/xrt-vsec.c | 337 ++++++
drivers/fpga/xrt/lib/xrt-cdev.c | 234 ++++
drivers/fpga/xrt/lib/xrt-main.c | 270 +++++
drivers/fpga/xrt/lib/xrt-main.h | 46 +
drivers/fpga/xrt/lib/xrt-subdev.c | 1007 ++++++++++++++++++
drivers/fpga/xrt/mgmt/Kconfig | 11 +
drivers/fpga/xrt/mgmt/Makefile | 27 +
drivers/fpga/xrt/mgmt/xmgmt-fmgr-drv.c | 179 ++++
drivers/fpga/xrt/mgmt/xmgmt-fmgr.h | 29 +
drivers/fpga/xrt/mgmt/xmgmt-main-impl.h | 35 +
drivers/fpga/xrt/mgmt/xmgmt-main-region.c | 476 +++++++++
drivers/fpga/xrt/mgmt/xmgmt-main.c | 738 +++++++++++++
drivers/fpga/xrt/mgmt/xmgmt-root.c | 375 +++++++
include/uapi/linux/xrt/xclbin.h | 386 +++++++
include/uapi/linux/xrt/xmgmt-ioctl.h | 72 ++
48 files changed, 10000 insertions(+)
create mode 100644 Documentation/fpga/xrt.rst
create mode 100644 drivers/fpga/xrt/Kconfig
create mode 100644 drivers/fpga/xrt/Makefile
create mode 100644 drivers/fpga/xrt/common/xrt-metadata.c
create mode 100644 drivers/fpga/xrt/common/xrt-root.c
create mode 100644 drivers/fpga/xrt/common/xrt-root.h
create mode 100644 drivers/fpga/xrt/common/xrt-xclbin.c
create mode 100644 drivers/fpga/xrt/common/xrt-xclbin.h
create mode 100644 drivers/fpga/xrt/include/metadata.h
create mode 100644 drivers/fpga/xrt/include/parent.h
create mode 100644 drivers/fpga/xrt/include/partition.h
create mode 100644 drivers/fpga/xrt/include/subdev.h
create mode 100644 drivers/fpga/xrt/include/subdev/axigate.h
create mode 100644 drivers/fpga/xrt/include/subdev/calib.h
create mode 100644 drivers/fpga/xrt/include/subdev/clkfreq.h
create mode 100644 drivers/fpga/xrt/include/subdev/clock.h
create mode 100644 drivers/fpga/xrt/include/subdev/gpio.h
create mode 100644 drivers/fpga/xrt/include/subdev/icap.h
create mode 100644 drivers/fpga/xrt/include/subdev/ucs.h
create mode 100644 drivers/fpga/xrt/include/xmgmt-main.h
create mode 100644 drivers/fpga/xrt/lib/Kconfig
create mode 100644 drivers/fpga/xrt/lib/Makefile
create mode 100644 drivers/fpga/xrt/lib/subdevs/xrt-axigate.c
create mode 100644 drivers/fpga/xrt/lib/subdevs/xrt-calib.c
create mode 100644 drivers/fpga/xrt/lib/subdevs/xrt-clkfreq.c
create mode 100644 drivers/fpga/xrt/lib/subdevs/xrt-clock.c
create mode 100644 drivers/fpga/xrt/lib/subdevs/xrt-gpio.c
create mode 100644 drivers/fpga/xrt/lib/subdevs/xrt-icap.c
create mode 100644 drivers/fpga/xrt/lib/subdevs/xrt-partition.c
create mode 100644 drivers/fpga/xrt/lib/subdevs/xrt-ucs.c
create mode 100644 drivers/fpga/xrt/lib/subdevs/xrt-vsec.c
create mode 100644 drivers/fpga/xrt/lib/xrt-cdev.c
create mode 100644 drivers/fpga/xrt/lib/xrt-main.c
create mode 100644 drivers/fpga/xrt/lib/xrt-main.h
create mode 100644 drivers/fpga/xrt/lib/xrt-subdev.c
create mode 100644 drivers/fpga/xrt/mgmt/Kconfig
create mode 100644 drivers/fpga/xrt/mgmt/Makefile
create mode 100644 drivers/fpga/xrt/mgmt/xmgmt-fmgr-drv.c
create mode 100644 drivers/fpga/xrt/mgmt/xmgmt-fmgr.h
create mode 100644 drivers/fpga/xrt/mgmt/xmgmt-main-impl.h
create mode 100644 drivers/fpga/xrt/mgmt/xmgmt-main-region.c
create mode 100644 drivers/fpga/xrt/mgmt/xmgmt-main.c
create mode 100644 drivers/fpga/xrt/mgmt/xmgmt-root.c
create mode 100644 include/uapi/linux/xrt/xclbin.h
create mode 100644 include/uapi/linux/xrt/xmgmt-ioctl.h
--
2.17.1
Powered by blists - more mailing lists