Linux Sys FileSystem Nodes¶
xocl
and xclmgmt
drivers expose several sysfs
nodes under
the pci
device root node.
xocl¶
The xocl
driver exposes various sections of the xclbin
image
including the xclbin
Id
on sysfs
. This makes it very
convenient for tools (such as xbutil
) to discover characteristics
of the image currently loaded on the FPGA. The data layout of xclbin
sections are defined in file xclbin.h
which can be found under
runtime/driver/include
directory.
ip_layout
- Exposes IP LAYOUT section of
xclbin
connectivity
- Exposes CONNECTIVITY section of
xclbin
mem_topology
- Exposes MEM TOPOLOGY section of
xclbin
xclbinid
- Exposes
xclbin
unique identifier
xclmgmt¶
xclmgmt
driver exposes the instance number (suffix used in
/dev/xclmgmt%d
) on sysfs
. This makes it convenient to uniquely map a
PCIe slot on sysfs
to /dev/xclmgmt%d
device node created by the
driver.
Device sensors are exposed as standard hwmon
file hierarchy. Two
hwmon
nodes are created: sysmon
and microblaze
. sysmon
exposes device temperature and voltages. microblaze
exposes device
currents on various rails by using an embedded board management
firmware. Values with _input
suffix represent live values. The
values are compatible with the Linux standard lm-sensors
tool.
For example if the bus address of a physical function is
0000:01:00.1
then hwmon
would show up under
/sys/bus/pci/devices/0000:01:00.1
. See sample session log below:
dx4300:~>tree -L 1 /sys/bus/pci/devices/0000:01:00.1/hwmon
/sys/bus/pci/devices/0000:01:00.1/hwmon
├── hwmon3
└── hwmon4
2 directories, 0 files
dx4300:~>cat /sys/bus/pci/devices/0000:01:00.1/hwmon/hwmon3/name
xclmgmt_sysmon
dx4300:~>cat /sys/bus/pci/devices/0000:01:00.1/hwmon/hwmon4/name
xclmgmt_microblaze
dx4300:~>sensors
xclmgmt_microblaze-pci-0101
Adapter: PCI adapter
curr1: +4.47 A (avg = +0.00 A, highest = +4.63 A)
curr2: +4.52 A (avg = +0.00 A, highest = +4.80 A)
curr3: +3.12 A (avg = +0.00 A, highest = +3.36 A)
curr4: +0.00 A (avg = +0.00 A, highest = +0.00 A)
curr5: +1.00 A (avg = +0.00 A, highest = +1.00 A)
curr6: +0.50 A (avg = +0.00 A, highest = +0.50 A)
xclmgmt_sysmon-pci-0101
Adapter: PCI adapter
in0: +0.93 V (lowest = +0.92 V, highest = +0.95 V)
in1: +1.79 V (lowest = +1.78 V, highest = +1.80 V)
in2: +0.94 V (lowest = +0.92 V, highest = +0.95 V)
temp1: +46.6°C (lowest = +36.1°C, highest = +48.8°C)