mirror of
https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git
synced 2024-08-23 17:30:02 +00:00
![Xu Yilun](/assets/img/avatar_default.png)
Fix more kernel-doc warnings in drivers/fpga/: $ ./scripts/kernel-doc -none drivers/fpga/* drivers/fpga/dfl-afu.h:61: warning: expecting prototype for struct fpga_afu_dma_region. Prototype was for struct dfl_afu_dma_region instead drivers/fpga/dfl-afu-region.c:52: warning: Function parameter or member 'pdata' not described in 'afu_mmio_region_add' drivers/fpga/dfl-fme-perf.c:161: warning: Function parameter or member 'node' not described in 'fme_perf_priv' drivers/fpga/dfl-fme-pr.h:70: warning: expecting prototype for struct dfl_fme_bridge_pdata. Prototype was for struct dfl_fme_br_pdata instead drivers/fpga/dfl.h:256: warning: Function parameter or member 'revision' not described in 'dfl_feature' Signed-off-by: Xu Yilun <yilun.xu@intel.com> Reviewed-by: Randy Dunlap <rdunlap@infradead.org> Link: https://lore.kernel.org/r/20230114155444.794712-1-yilun.xu@intel.com
109 lines
3.2 KiB
C
109 lines
3.2 KiB
C
/* SPDX-License-Identifier: GPL-2.0 */
|
|
/*
|
|
* Header file for FPGA Accelerated Function Unit (AFU) Driver
|
|
*
|
|
* Copyright (C) 2017-2018 Intel Corporation, Inc.
|
|
*
|
|
* Authors:
|
|
* Wu Hao <hao.wu@intel.com>
|
|
* Xiao Guangrong <guangrong.xiao@linux.intel.com>
|
|
* Joseph Grecco <joe.grecco@intel.com>
|
|
* Enno Luebbers <enno.luebbers@intel.com>
|
|
* Tim Whisonant <tim.whisonant@intel.com>
|
|
* Ananda Ravuri <ananda.ravuri@intel.com>
|
|
* Henry Mitchel <henry.mitchel@intel.com>
|
|
*/
|
|
|
|
#ifndef __DFL_AFU_H
|
|
#define __DFL_AFU_H
|
|
|
|
#include <linux/mm.h>
|
|
|
|
#include "dfl.h"
|
|
|
|
/**
|
|
* struct dfl_afu_mmio_region - afu mmio region data structure
|
|
*
|
|
* @index: region index.
|
|
* @flags: region flags (access permission).
|
|
* @size: region size.
|
|
* @offset: region offset from start of the device fd.
|
|
* @phys: region's physical address.
|
|
* @node: node to add to afu feature dev's region list.
|
|
*/
|
|
struct dfl_afu_mmio_region {
|
|
u32 index;
|
|
u32 flags;
|
|
u64 size;
|
|
u64 offset;
|
|
u64 phys;
|
|
struct list_head node;
|
|
};
|
|
|
|
/**
|
|
* struct dfl_afu_dma_region - afu DMA region data structure
|
|
*
|
|
* @user_addr: region userspace virtual address.
|
|
* @length: region length.
|
|
* @iova: region IO virtual address.
|
|
* @pages: ptr to pages of this region.
|
|
* @node: rb tree node.
|
|
* @in_use: flag to indicate if this region is in_use.
|
|
*/
|
|
struct dfl_afu_dma_region {
|
|
u64 user_addr;
|
|
u64 length;
|
|
u64 iova;
|
|
struct page **pages;
|
|
struct rb_node node;
|
|
bool in_use;
|
|
};
|
|
|
|
/**
|
|
* struct dfl_afu - afu device data structure
|
|
*
|
|
* @region_cur_offset: current region offset from start to the device fd.
|
|
* @num_regions: num of mmio regions.
|
|
* @regions: the mmio region linked list of this afu feature device.
|
|
* @dma_regions: root of dma regions rb tree.
|
|
* @num_umsgs: num of umsgs.
|
|
* @pdata: afu platform device's pdata.
|
|
*/
|
|
struct dfl_afu {
|
|
u64 region_cur_offset;
|
|
int num_regions;
|
|
u8 num_umsgs;
|
|
struct list_head regions;
|
|
struct rb_root dma_regions;
|
|
|
|
struct dfl_feature_platform_data *pdata;
|
|
};
|
|
|
|
/* hold pdata->lock when call __afu_port_enable/disable */
|
|
int __afu_port_enable(struct platform_device *pdev);
|
|
int __afu_port_disable(struct platform_device *pdev);
|
|
|
|
void afu_mmio_region_init(struct dfl_feature_platform_data *pdata);
|
|
int afu_mmio_region_add(struct dfl_feature_platform_data *pdata,
|
|
u32 region_index, u64 region_size, u64 phys, u32 flags);
|
|
void afu_mmio_region_destroy(struct dfl_feature_platform_data *pdata);
|
|
int afu_mmio_region_get_by_index(struct dfl_feature_platform_data *pdata,
|
|
u32 region_index,
|
|
struct dfl_afu_mmio_region *pregion);
|
|
int afu_mmio_region_get_by_offset(struct dfl_feature_platform_data *pdata,
|
|
u64 offset, u64 size,
|
|
struct dfl_afu_mmio_region *pregion);
|
|
void afu_dma_region_init(struct dfl_feature_platform_data *pdata);
|
|
void afu_dma_region_destroy(struct dfl_feature_platform_data *pdata);
|
|
int afu_dma_map_region(struct dfl_feature_platform_data *pdata,
|
|
u64 user_addr, u64 length, u64 *iova);
|
|
int afu_dma_unmap_region(struct dfl_feature_platform_data *pdata, u64 iova);
|
|
struct dfl_afu_dma_region *
|
|
afu_dma_region_find(struct dfl_feature_platform_data *pdata,
|
|
u64 iova, u64 size);
|
|
|
|
extern const struct dfl_feature_ops port_err_ops;
|
|
extern const struct dfl_feature_id port_err_id_table[];
|
|
extern const struct attribute_group port_err_group;
|
|
|
|
#endif /* __DFL_AFU_H */
|