fpga: generalize updating to partial and full
Subsystems (3)
[email protected]
reviewerPATCH 1/2 fpga: generalize updating to partial and full
From: Tom Rix <[email protected]>
There is a need to update the whole card. The user area, the shell and even the card firmware. This needs to be handled differently than the existing partial updating in the fpga manager.
Move the write_* ops out of fpga_manager_ops and into a new fpga_manager_update_ops struct. Add two update_ops back to fpga_manager_ops, partial_update for the exiting functionality and full_update for the new functionity.
Rewire fpga devs to use new partial_update ops
--- drivers/fpga/altera-cvp.c | 8 ++++---- drivers/fpga/altera-pr-ip-core.c | 8 ++++---- drivers/fpga/altera-ps-spi.c | 8 ++++---- drivers/fpga/dfl-fme-mgr.c | 10 +++++----- drivers/fpga/fpga-mgr.c | 23 ++++++++++++----------- drivers/fpga/ice40-spi.c | 8 ++++---- drivers/fpga/machxo2-spi.c | 8 ++++---- drivers/fpga/socfpga-a10.c | 10 +++++----- drivers/fpga/socfpga.c | 8 ++++---- drivers/fpga/xilinx-spi.c | 8 ++++---- drivers/fpga/zynq-fpga.c | 10 +++++----- drivers/fpga/zynqmp-fpga.c | 8 ++++---- include/linux/fpga/fpga-mgr.h | 32 +++++++++++++++++++++----------- 13 files changed, 80 insertions(+), 69 deletions(-)
drivers/fpga/altera-cvp.c +4 -4
@@ -516,10 +516,10 @@ static int altera_cvp_write_complete(struct fpga_manager *mgr, }static const struct fpga_manager_ops altera_cvp_ops = { - .state = altera_cvp_state, - .write_init = altera_cvp_write_init, - .write = altera_cvp_write, - .write_complete = altera_cvp_write_complete, + .state = altera_cvp_state, + .partial_update.write_init = altera_cvp_write_init, + .partial_update.write = altera_cvp_write, + .partial_update.write_complete = altera_cvp_write_complete, };static const struct cvp_priv cvp_priv_v1 = {
drivers/fpga/altera-pr-ip-core.c +4 -4
@@ -167,10 +167,10 @@ static int alt_pr_fpga_write_complete(struct fpga_manager *mgr, }static const struct fpga_manager_ops alt_pr_ops = { - .state = alt_pr_fpga_state, - .write_init = alt_pr_fpga_write_init, - .write = alt_pr_fpga_write, - .write_complete = alt_pr_fpga_write_complete, + .state = alt_pr_fpga_state, + .partial_update.write_init = alt_pr_fpga_write_init, + .partial_update.write = alt_pr_fpga_write, + .partial_update.write_complete = alt_pr_fpga_write_complete, };int alt_pr_register (struct device *dev,void __iomem *reg_base)
drivers/fpga/altera-ps-spi.c +4 -4
@@ -231,10 +231,10 @@ static int altera_ps_write_complete(struct fpga_manager *mgr, }static const struct fpga_manager_ops altera_ps_ops = { - .state = altera_ps_state, - .write_init = altera_ps_write_init, - .write = altera_ps_write, - .write_complete = altera_ps_write_complete, + .state = altera_ps_state, + .partial_update.write_init = altera_ps_write_init, + .partial_update.write = altera_ps_write, + .partial_update.write_complete = altera_ps_write_complete, };static const struct altera_ps_data *id_to_data (const struct spi_device_id *id)
drivers/fpga/dfl-fme-mgr.c +5 -5
@@ -265,11 +265,11 @@ static u64 fme_mgr_status(struct fpga_manager *mgr) }static const struct fpga_manager_ops fme_mgr_ops = { - .write_init = fme_mgr_write_init, - .write = fme_mgr_write, - .write_complete = fme_mgr_write_complete, - .state = fme_mgr_state, - .status = fme_mgr_status, + .state = fme_mgr_state, + .status = fme_mgr_status, + .partial_update.write_init = fme_mgr_write_init, + .partial_update.write = fme_mgr_write, + .partial_update.write_complete = fme_mgr_write_complete, }; static void fme_mgr_get_compat_id(void __iomem *fme_pr,
drivers/fpga/fpga-mgr.c +12 -11
@@ -83,9 +83,9 @@ static int fpga_mgr_write_init_buf(struct fpga_manager *mgr, mgr->state =FPGA_MGR_STATE_WRITE_INIT ;if (!mgr->mops->initial_header_size) - ret = mgr->mops->write_init (mgr, info,NULL ,0 ); + ret = mgr->mops->partial_update.write_init (mgr, info,NULL ,0 );else - ret = mgr->mops->write_init ( + ret = mgr->mops->partial_update.write_init ( mgr, info, buf,min (mgr->mops->initial_header_size, count));if (ret) {
@@ -147,7 +147,7 @@ static int fpga_mgr_write_complete(struct fpga_manager *mgr,int ret; mgr->state =FPGA_MGR_STATE_WRITE_COMPLETE ; - ret = mgr->mops->write_complete (mgr, info); + ret = mgr->mops->partial_update.write_complete (mgr, info);if (ret) {dev_err (&mgr->dev,"Error after writing image data to FPGA\n" ); mgr->state =FPGA_MGR_STATE_WRITE_COMPLETE_ERR ;
@@ -187,14 +187,14 @@ static int fpga_mgr_buf_load_sg(struct fpga_manager *mgr,/* Write the FPGA image to the FPGA. */ mgr->state =FPGA_MGR_STATE_WRITE ; -if (mgr->mops->write_sg) { - ret = mgr->mops->write_sg (mgr, sgt); +if (mgr->mops->partial_update.write_sg) { + ret = mgr->mops->partial_update.write_sg (mgr, sgt); }else {struct sg_mapping_iter miter;sg_miter_start (&miter, sgt->sgl, sgt->nents,SG_MITER_FROM_SG );while (sg_miter_next (&miter)) { - ret = mgr->mops->write (mgr, miter.addr, miter.length); + ret = mgr->mops->partial_update.write (mgr, miter.addr, miter.length);if (ret)break ; }
@@ -224,7 +224,7 @@ static int fpga_mgr_buf_load_mapped(struct fpga_manager *mgr,* Write the FPGA image to the FPGA. */ mgr->state =FPGA_MGR_STATE_WRITE ; - ret = mgr->mops->write (mgr, buf, count); + ret = mgr->mops->partial_update.write (mgr, buf, count);if (ret) {dev_err (&mgr->dev,"Error while writing image data to FPGA\n" ); mgr->state =FPGA_MGR_STATE_WRITE_ERR ;
@@ -264,7 +264,7 @@ static int fpga_mgr_buf_load(struct fpga_manager *mgr,* contiguous kernel buffer and the driver doesn't require SG, non-SG * drivers will still work on the slow path. */ -if (mgr->mops->write) +if (mgr->mops->partial_update.write)return fpga_mgr_buf_load_mapped (mgr, info, buf, count);/*
@@ -568,9 +568,10 @@ struct fpga_manager *fpga_mgr_create(struct device *dev, const char *name,struct fpga_manager *mgr;int id, ret; -if (!mops || !mops->write_complete || !mops->state || - !mops->write_init || (!mops->write && !mops->write_sg) || - (mops->write && mops->write_sg)) { +if (!mops || !mops->partial_update.write_complete || !mops->state || + !mops->partial_update.write_init || (!mops->partial_update.write && + !mops->partial_update.write_sg) || + (mops->partial_update.write && mops->partial_update.write_sg)) {dev_err (dev,"Attempt to register without fpga_manager_ops\n" );return NULL ; }
drivers/fpga/ice40-spi.c +4 -4
@@ -126,10 +126,10 @@ static int ice40_fpga_ops_write_complete(struct fpga_manager *mgr, }static const struct fpga_manager_ops ice40_fpga_ops = { - .state = ice40_fpga_ops_state, - .write_init = ice40_fpga_ops_write_init, - .write = ice40_fpga_ops_write, - .write_complete = ice40_fpga_ops_write_complete, + .state = ice40_fpga_ops_state, + .partial_update.write_init = ice40_fpga_ops_write_init, + .partial_update.write = ice40_fpga_ops_write, + .partial_update.write_complete = ice40_fpga_ops_write_complete, };static int ice40_fpga_probe (struct spi_device *spi)
drivers/fpga/machxo2-spi.c +4 -4
@@ -350,10 +350,10 @@ static int machxo2_write_complete(struct fpga_manager *mgr, }static const struct fpga_manager_ops machxo2_ops = { - .state = machxo2_spi_state, - .write_init = machxo2_write_init, - .write = machxo2_write, - .write_complete = machxo2_write_complete, + .state = machxo2_spi_state, + .partial_update.write_init = machxo2_write_init, + .partial_update.write = machxo2_write, + .partial_update.write_complete = machxo2_write_complete, };static int machxo2_spi_probe (struct spi_device *spi)
drivers/fpga/socfpga-a10.c +5 -5
@@ -458,11 +458,11 @@ static enum fpga_mgr_states socfpga_a10_fpga_state(struct fpga_manager *mgr) }static const struct fpga_manager_ops socfpga_a10_fpga_mgr_ops = { - .initial_header_size = (RBF_DECOMPRESS_OFFSET +1 ) *4 , - .state = socfpga_a10_fpga_state, - .write_init = socfpga_a10_fpga_write_init, - .write = socfpga_a10_fpga_write, - .write_complete = socfpga_a10_fpga_write_complete, + .initial_header_size = (RBF_DECOMPRESS_OFFSET +1 ) *4 , + .state = socfpga_a10_fpga_state, + .partial_update.write_init = socfpga_a10_fpga_write_init, + .partial_update.write = socfpga_a10_fpga_write, + .partial_update.write_complete = socfpga_a10_fpga_write_complete, };static int socfpga_a10_fpga_probe (struct platform_device *pdev)
drivers/fpga/socfpga.c +4 -4
@@ -534,10 +534,10 @@ static enum fpga_mgr_states socfpga_fpga_ops_state(struct fpga_manager *mgr) }static const struct fpga_manager_ops socfpga_fpga_ops = { - .state = socfpga_fpga_ops_state, - .write_init = socfpga_fpga_ops_configure_init, - .write = socfpga_fpga_ops_configure_write, - .write_complete = socfpga_fpga_ops_configure_complete, + .state = socfpga_fpga_ops_state, + .partial_update.write_init = socfpga_fpga_ops_configure_init, + .partial_update.write = socfpga_fpga_ops_configure_write, + .partial_update.write_complete = socfpga_fpga_ops_configure_complete, };static int socfpga_fpga_probe (struct platform_device *pdev)
drivers/fpga/xilinx-spi.c +4 -4
@@ -214,10 +214,10 @@ static int xilinx_spi_write_complete(struct fpga_manager *mgr, }static const struct fpga_manager_ops xilinx_spi_ops = { - .state = xilinx_spi_state, - .write_init = xilinx_spi_write_init, - .write = xilinx_spi_write, - .write_complete = xilinx_spi_write_complete, + .state = xilinx_spi_state, + .partial_update.write_init = xilinx_spi_write_init, + .partial_update.write = xilinx_spi_write, + .partial_update.write_complete = xilinx_spi_write_complete, };static int xilinx_spi_probe (struct spi_device *spi)
drivers/fpga/zynq-fpga.c +5 -5
@@ -543,11 +543,11 @@ static enum fpga_mgr_states zynq_fpga_ops_state(struct fpga_manager *mgr) }static const struct fpga_manager_ops zynq_fpga_ops = { - .initial_header_size =128 , - .state = zynq_fpga_ops_state, - .write_init = zynq_fpga_ops_write_init, - .write_sg = zynq_fpga_ops_write, - .write_complete = zynq_fpga_ops_write_complete, + .initial_header_size =128 , + .state = zynq_fpga_ops_state, + .partial_update.write_init = zynq_fpga_ops_write_init, + .partial_update.write_sg = zynq_fpga_ops_write, + .partial_update.write_complete = zynq_fpga_ops_write_complete, };static int zynq_fpga_probe (struct platform_device *pdev)
drivers/fpga/zynqmp-fpga.c +4 -4
@@ -84,10 +84,10 @@ static enum fpga_mgr_states zynqmp_fpga_ops_state(struct fpga_manager *mgr) }static const struct fpga_manager_ops zynqmp_fpga_ops = { - .state = zynqmp_fpga_ops_state, - .write_init = zynqmp_fpga_ops_write_init, - .write = zynqmp_fpga_ops_write, - .write_complete = zynqmp_fpga_ops_write_complete, + .state = zynqmp_fpga_ops_state, + .partial_update.write_init = zynqmp_fpga_ops_write_init, + .partial_update.write = zynqmp_fpga_ops_write, + .partial_update.write_complete = zynqmp_fpga_ops_write_complete, };static int zynqmp_fpga_probe (struct platform_device *pdev)
include/linux/fpga/fpga-mgr.h +21 -11
@@ -106,14 +106,29 @@ struct fpga_image_info { };/** -* struct fpga_manager_ops - ops for low level fpga manager drivers -* @initial_header_size: Maximum number of bytes that should be passed into write_init -* @state: returns an enum value of the FPGA's state -* @status: returns status of the FPGA, including reconfiguration error code +* struct fpga_manager_update_ops - ops updating fpga * @write_init: prepare the FPGA to receive confuration data * @write: write count bytes of configuration data to the FPGA * @write_sg: write the scatter list of configuration data to the FPGA * @write_complete: set FPGA to operating state after writing is done +*/ +struct fpga_manager_update_ops { +int (*write_init)(struct fpga_manager *mgr, +struct fpga_image_info *info, +const char *buf,size_t count); +int (*write)(struct fpga_manager *mgr,const char *buf,size_t count); +int (*write_sg)(struct fpga_manager *mgr,struct sg_table *sgt); +int (*write_complete)(struct fpga_manager *mgr, +struct fpga_image_info *info); +}; + +/** +* struct fpga_manager_ops - ops for low level fpga manager drivers +* @initial_header_size: Maximum number of bytes that should be passed into write_init +* @state: returns an enum value of the FPGA's state +* @status: returns status of the FPGA, including reconfiguration error code +* @partial_update: ops for doing partial reconfiguration +* @full_update: ops for doing a full card update, user,shell,fw ie. the works * @fpga_remove: optional: Set FPGA into a specific state during driver remove * @groups: optional attribute groups. *
@@ -125,13 +140,8 @@ struct fpga_manager_ops {size_t initial_header_size;enum fpga_mgr_states (*state)(struct fpga_manager *mgr);u64 (*status)(struct fpga_manager *mgr); -int (*write_init)(struct fpga_manager *mgr, -struct fpga_image_info *info, -const char *buf,size_t count); -int (*write)(struct fpga_manager *mgr,const char *buf,size_t count); -int (*write_sg)(struct fpga_manager *mgr,struct sg_table *sgt); -int (*write_complete)(struct fpga_manager *mgr, -struct fpga_image_info *info); +struct fpga_manager_update_ops partial_update; +struct fpga_manager_update_ops full_update;void (*fpga_remove)(struct fpga_manager *mgr);const struct attribute_group **groups; };
Signature · 1 line
2.26.3
Moritz Fischer
maintainerTom,
Quoted 7 lines · On Wed, May 19, 2021 at 01:42:56PM -0700, [email protected] wrote:
From: Tom Rix <[email protected]>
There is a need to update the whole card. The user area, the shell and even the card firmware. This needs to be handled differently than the existing partial updating in the fpga manager.
Quoted 5 lines
Move the write_* ops out of
fpga_manager_opsand into a newfpga_manager_update_opsstruct. Add twoupdate_opsback tofpga_manager_ops,partial_updatefor the exiting functionality andfull_updatefor the new functionity.
Partial and Full are somewhat loaded terms with FPGAs -- think partial reconfiguration vs full reconfiguration.
How about 'persistent' and 'volatile' or something along those lines instead?
- Moritz
Tom Rix
reviewerQuoted 15 lines · Moritz Fischer
Tom,
Quoted 7 lines · On Wed, May 19, 2021 at 01:42:56PM -0700, [email protected] wrote:
From: Tom Rix <[email protected]>
There is a need to update the whole card. The user area, the shell and even the card firmware. This needs to be handled differently than the existing partial updating in the fpga manager.
Quoted 5 lines
Move the write_* ops out of
fpga_manager_opsand into a newfpga_manager_update_opsstruct. Add twoupdate_opsback tofpga_manager_ops,partial_updatefor the exiting functionality andfull_updatefor the new functionity.
Quoted 5 lines
Partial and Full are somewhat loaded terms with FPGAs -- think partial reconfiguration vs full reconfiguration.
How about 'persistent' and 'volatile' or something along those lines instead?
I think that only applies to xilinx, its all persistent for dfl.
How about calling it what it is.
partial_update -> partial_reconfiguration
full_update -> board_reimage
Tom
Quoted 2 lines
- Moritz