Lines Matching +full:in +full:- +full:functions

1 .. SPDX-License-Identifier: GPL-2.0
4 PCI Non-Transparent Bridge (NTB) Endpoint Function (EPF) User Guide
9 This document is a guide to help users use pci-epf-ntb function driver
11 be followed in the host side and EP side is given below. For the hardware
13 Documentation/PCI/endpoint/pci-ntb-function.rst
19 ---------------------------
24 To find the list of endpoint controller devices in the system::
27 	2900000.pcie-ep  2910000.pcie-ep
32 	2900000.pcie-ep  2910000.pcie-ep
36 -------------------------
38 To find the list of endpoint function drivers in the system::
40 	# ls /sys/bus/pci-epf/drivers
45 	# ls /sys/kernel/config/pci_ep/functions
49 Creating pci-epf-ntb Device
50 ----------------------------
53 pci-epf-ntb device, the following commands can be used::
55 	# mount -t configfs none /sys/kernel/config
57 	# mkdir functions/pci_epf_ntb/func1
59 The "mkdir func1" above creates the pci-epf-ntb function device that will
65 	# ls functions/pci_epf_ntb/func1
66 	baseclass_code    deviceid          msi_interrupts    pci-epf-ntb.0
72 when the device is bound to the driver. The pci-epf-ntb driver populates
75 	# cat functions/pci_epf_ntb/func1/vendorid
77 	# cat functions/pci_epf_ntb/func1/interrupt_pin
81 Configuring pci-epf-ntb Device
82 -------------------------------
84 The user can configure the pci-epf-ntb device using its configfs entry. In order
88 	# echo 0x104c > functions/pci_epf_ntb/func1/vendorid
89 	# echo 0xb00d > functions/pci_epf_ntb/func1/deviceid
91 The PCI endpoint framework also automatically creates a sub-directory in the
92 function attribute directory. This sub-directory has the same name as the name
96 	# ls functions/pci_epf_ntb/func1/pci_epf_ntb.0/
102 	# echo 4 > functions/pci_epf_ntb/func1/pci_epf_ntb.0/db_count
103 	# echo 128 > functions/pci_epf_ntb/func1/pci_epf_ntb.0/spad_count
104 	# echo 2 > functions/pci_epf_ntb/func1/pci_epf_ntb.0/num_mws
105 	# echo 0x100000 > functions/pci_epf_ntb/func1/pci_epf_ntb.0/mw1
106 	# echo 0x100000 > functions/pci_epf_ntb/func1/pci_epf_ntb.0/mw2
108 Binding pci-epf-ntb Device to EP Controller
109 --------------------------------------------
117 	# ln -s controllers/2900000.pcie-ep/ functions/pci-epf-ntb/func1/primary
118 	# ln -s controllers/2910000.pcie-ep/ functions/pci-epf-ntb/func1/secondary
125 --------------
127 In order for the endpoint device to establish a link with the host, the _start_
131 	# echo 1 > controllers/2900000.pcie-ep/start
132 	# echo 1 > controllers/2910000.pcie-ep/start
139 ------------
141 Note that the devices listed here correspond to the values populated in
142 "Creating pci-epf-ntb Device" section above::
150 -----------------------
152 The host side software follows the standard NTB software architecture in Linux.
158 :doc:`Non-Transparent Bridge <../../driver-api/ntb>`