Commit f2c46153 authored by Tong Zhang's avatar Tong Zhang Committed by Greg Kroah-Hartman
Browse files

staging: drop fpgaboot driver 



The gs_fpgaboot driver is totally broken since 2014 and no one even
noticed the driver is not probing. Given the quality of the driver
and its current state it makes sense to drop it.

Signed-off-by: default avatarTong Zhang <ztong0001@gmail.com>
Link: https://lore.kernel.org/r/20220204190847.3809405-1-ztong0001@gmail.com


Signed-off-by: default avatarGreg Kroah-Hartman <gregkh@linuxfoundation.org>
parent 1b9a8d75

drivers/staging/Kconfig

+0 −2
Original line number Diff line number Diff line
@@ -66,8 +66,6 @@ source "drivers/staging/gdm724x/Kconfig" 


source "drivers/staging/fwserial/Kconfig"



source "drivers/staging/gs_fpgaboot/Kconfig"



source "drivers/staging/unisys/Kconfig"



source "drivers/staging/clocking-wizard/Kconfig"

drivers/staging/Makefile

+0 −1
Original line number Diff line number Diff line
@@ -23,7 +23,6 @@ obj-$(CONFIG_ANDROID) += android/ 
obj-$(CONFIG_STAGING_BOARD)	+= board/

obj-$(CONFIG_LTE_GDM724X)	+= gdm724x/

obj-$(CONFIG_FIREWIRE_SERIAL)	+= fwserial/

obj-$(CONFIG_GS_FPGABOOT)	+= gs_fpgaboot/

obj-$(CONFIG_UNISYSSPAR)	+= unisys/

obj-$(CONFIG_COMMON_CLK_XLNX_CLKWZRD)	+= clocking-wizard/

obj-$(CONFIG_FB_TFT)		+= fbtft/

drivers/staging/gs_fpgaboot/Kconfig

deleted100644 → 0
+0 −8
Original line number Diff line number Diff line 
# SPDX-License-Identifier: GPL-2.0

#

# "xilinx FPGA firmware download, fpgaboot"

#

config GS_FPGABOOT

	tristate "Xilinx FPGA firmware download module"

	help

	  Xilinx FPGA firmware download module

drivers/staging/gs_fpgaboot/Makefile

deleted100644 → 0
+0 −3
Original line number Diff line number Diff line 
# SPDX-License-Identifier: GPL-2.0

gs_fpga-y	+= gs_fpgaboot.o io.o

obj-$(CONFIG_GS_FPGABOOT)	+= gs_fpga.o

drivers/staging/gs_fpgaboot/README

deleted100644 → 0
+0 −70
Original line number Diff line number Diff line 
==============================================================================

Linux Driver Source for Xilinx FPGA firmware download

==============================================================================





TABLE OF CONTENTS.



1.  SUMMARY

2.  BACKGROUND

3.  DESIGN

4.  HOW TO USE

5.  REFERENCE



1. SUMMARY



	- Download Xilinx FPGA firmware

	- This module downloads Xilinx FPGA firmware using gpio pins.



2. BACKGROUND



	An FPGA (Field Programmable Gate Array) is a programmable hardware that is

	used in various applications. Hardware design needs to programmed through

	a dedicated device or CPU assisted way (serial or parallel).

	This driver provides a way to download FPGA firmware.



3. DESIGN



	- load Xilinx FPGA bitstream format[1] firmware image file using

	  kernel firmware framework, request_firmware()

	- program the Xilinx FPGA using SelectMAP (parallel) mode [2]

	- FPGA prgram is done by gpio based bit-banging, as an example

	- platform independent file: gs_fpgaboot.c

	- platform dependent file: io.c



4. HOW TO USE



	$ insmod gs_fpga.ko file="xlinx_fpga_top_bitstream.bit"

	$ rmmod gs_fpga



5. USE CASE (from a mailing list discussion with Greg)



	a. As an FPGA development support tool,

	During FPGA firmware development, you need to download a new FPGA

	image frequently.

	You would do that with a dedicated JTAG, which usually a limited

	resource in the lab.

	However, if you use my driver, you don't have to have a dedicated JTAG.

	This is a real gain :)



	b. For the FPGA that runs without config after the download, which

	doesn't talk to any of Linux interfaces (such as PCIE).



	We download FPGA firmware from user triggered or some other way, and that's it.

	Since that FPGA runs on its own, it doesn't require a linux driver

	after the download.



	c. For the FPGA that requires config after the download, which talk to

	any of linux interfaces (such as PCIE)



	Then, this type of FPGA config can be put into device tree and have a

	separate driver (pcie or others), then THAT driver calls my driver to

	download FPGA firmware during the Linux boot, the take over the device

	through the interface.



6. REFERENCE



	1. Xilinx APP NOTE XAPP583:

	  https://www.xilinx.com/support/documentation/application_notes/xapp583-fpga-configuration.pdf

	2. bitstream file info:

	  http://home.earthlink.net/~davesullins/software/bitinfo.html