XCLMGMT (PCIe Management Physical Function) Driver Interfaces

PCIe Kernel Driver for Managament Physical Function

Interfaces exposed by xclmgmt driver are defined in file, mgmt-ioctl.h. Core functionality provided by xclmgmt driver is described in the following table:

# Functionality ioctl request code data format
1 FPGA image download XCLMGMT_IOCICAPDOWNLOAD_AXLF xclmgmt_ioc_bitstream_axlf
2 CL frequency scaling XCLMGMT_IOCFREQSCALE xclmgmt_ioc_freqscaling
3 PCIe hot reset XCLMGMT_IOCHOTRESET NA
4 CL reset XCLMGMT_IOCOCLRESET NA
5 Live boot FPGA from PROM XCLMGMT_IOCREBOOT NA
6 Device sensors (current, voltage and temperature) NA hwmon (xclmgmt_microblaze and xclmgmt_sysmon) interface on sysfs
7 Querying device errors XCLMGMT_IOCERRINFO xclErrorStatus
struct xclmgmt_ioc_info

Obtain information from the device used with XCLMGMT_IOCINFO ioctl

Definition

struct xclmgmt_ioc_info {
};

Members

Description

Note that this structure will be obsoleted in future and the same functionality will be exposed via sysfs nodes

struct xclmgmt_ioc_bitstream_axlf

load xclbin (AXLF) device image used with XCLMGMT_IOCICAPDOWNLOAD_AXLF ioctl

Definition

struct xclmgmt_ioc_bitstream_axlf {
  struct axlf * xclbin;
};

Members

xclbin
Pointer to user’s xclbin structure in memory
struct xclmgmt_ioc_freqscaling

scale frequencies on the board using Xilinx clock wizard used with XCLMGMT_IOCFREQSCALE ioctl

Definition

struct xclmgmt_ioc_freqscaling {
  unsigned ocl_region;
  unsigned short ocl_target_freq;
};

Members

ocl_region
PR region (currently only 0 is supported)
ocl_target_freq
Array of requested frequencies, a value o zero in the array indicates leave untouched