1 // SPDX-License-Identifier: GPL-2.0
3 * Copyright IBM Corp. 2020
10 #define KMSG_COMPONENT "zpci"
11 #define pr_fmt(fmt) KMSG_COMPONENT ": " fmt
13 #include <linux/kernel.h>
14 #include <linux/slab.h>
15 #include <linux/err.h>
16 #include <linux/export.h>
17 #include <linux/delay.h>
18 #include <linux/seq_file.h>
19 #include <linux/jump_label.h>
20 #include <linux/pci.h>
21 #include <linux/printk.h>
23 #include <asm/pci_clp.h>
24 #include <asm/pci_dma.h>
29 static LIST_HEAD(zbus_list);
30 static DEFINE_MUTEX(zbus_list_lock);
31 static int zpci_nb_devices;
33 /* zpci_bus_prepare_device - Prepare a zPCI function for scanning
34 * @zdev: the zPCI function to be prepared
36 * The PCI resources for the function are set up and added to its zbus and the
37 * function is enabled. The function must be added to a zbus which must have
38 * a PCI bus created. If an error occurs the zPCI function is not enabled.
40 * Return: 0 on success, an error code otherwise
42 static int zpci_bus_prepare_device(struct zpci_dev *zdev)
44 struct resource_entry *window, *n;
48 if (!zdev_enabled(zdev)) {
49 rc = zpci_enable_device(zdev);
52 rc = zpci_dma_init_device(zdev);
54 zpci_disable_device(zdev);
59 if (!zdev->has_resources) {
60 zpci_setup_bus_resources(zdev, &zdev->zbus->resources);
61 resource_list_for_each_entry_safe(window, n, &zdev->zbus->resources) {
63 pci_bus_add_resource(zdev->zbus->bus, res, 0);
70 /* zpci_bus_scan_device - Scan a single device adding it to the PCI core
71 * @zdev: the zdev to be scanned
73 * Scans the PCI function making it available to the common PCI code.
75 * Return: 0 on success, an error value otherwise
77 int zpci_bus_scan_device(struct zpci_dev *zdev)
82 rc = zpci_bus_prepare_device(zdev);
86 pdev = pci_scan_single_device(zdev->zbus->bus, zdev->devfn);
90 pci_bus_add_device(pdev);
91 pci_lock_rescan_remove();
92 pci_bus_add_devices(zdev->zbus->bus);
93 pci_unlock_rescan_remove();
98 /* zpci_bus_remove_device - Removes the given zdev from the PCI core
99 * @zdev: the zdev to be removed from the PCI core
100 * @set_error: if true the device's error state is set to permanent failure
102 * Sets a zPCI device to a configured but offline state; the zPCI
103 * device is still accessible through its hotplug slot and the zPCI
104 * API but is removed from the common code PCI bus, making it
105 * no longer available to drivers.
107 void zpci_bus_remove_device(struct zpci_dev *zdev, bool set_error)
109 struct zpci_bus *zbus = zdev->zbus;
110 struct pci_dev *pdev;
112 if (!zdev->zbus->bus)
115 pdev = pci_get_slot(zbus->bus, zdev->devfn);
118 pdev->error_state = pci_channel_io_perm_failure;
119 if (pdev->is_virtfn) {
120 zpci_iov_remove_virtfn(pdev, zdev->vfn);
121 /* balance pci_get_slot */
125 pci_stop_and_remove_bus_device_locked(pdev);
126 /* balance pci_get_slot */
131 /* zpci_bus_scan_bus - Scan all configured zPCI functions on the bus
132 * @zbus: the zbus to be scanned
134 * Enables and scans all PCI functions on the bus making them available to the
135 * common PCI code. If there is no function 0 on the zbus nothing is scanned. If
136 * a function does not have a slot yet because it was added to the zbus before
137 * function 0 the slot is created. If a PCI function fails to be initialized
138 * an error will be returned but attempts will still be made for all other
139 * functions on the bus.
141 * Return: 0 on success, an error value otherwise
143 int zpci_bus_scan_bus(struct zpci_bus *zbus)
145 struct zpci_dev *zdev;
146 int devfn, rc, ret = 0;
148 if (!zbus->function[0])
151 for (devfn = 0; devfn < ZPCI_FUNCTIONS_PER_BUS; devfn++) {
152 zdev = zbus->function[devfn];
153 if (zdev && zdev->state == ZPCI_FN_STATE_CONFIGURED) {
154 rc = zpci_bus_prepare_device(zdev);
160 pci_lock_rescan_remove();
161 pci_scan_child_bus(zbus->bus);
162 pci_bus_add_devices(zbus->bus);
163 pci_unlock_rescan_remove();
168 /* zpci_bus_scan_busses - Scan all registered busses
170 * Scan all available zbusses
173 void zpci_bus_scan_busses(void)
175 struct zpci_bus *zbus = NULL;
177 mutex_lock(&zbus_list_lock);
178 list_for_each_entry(zbus, &zbus_list, bus_next) {
179 zpci_bus_scan_bus(zbus);
182 mutex_unlock(&zbus_list_lock);
185 /* zpci_bus_create_pci_bus - Create the PCI bus associated with this zbus
186 * @zbus: the zbus holding the zdevices
187 * @f0: function 0 of the bus
188 * @ops: the pci operations
190 * Function zero is taken as a parameter as this is used to determine the
191 * domain, multifunction property and maximum bus speed of the entire bus.
193 * Return: 0 on success, an error code otherwise
195 static int zpci_bus_create_pci_bus(struct zpci_bus *zbus, struct zpci_dev *f0, struct pci_ops *ops)
200 domain = zpci_alloc_domain((u16)f0->uid);
204 zbus->domain_nr = domain;
205 zbus->multifunction = f0->rid_available;
206 zbus->max_bus_speed = f0->max_bus_speed;
209 * Note that the zbus->resources are taken over and zbus->resources
210 * is empty after a successful call
212 bus = pci_create_root_bus(NULL, ZPCI_BUS_NR, ops, zbus, &zbus->resources);
214 zpci_free_domain(zbus->domain_nr);
219 pci_bus_add_devices(bus);
224 static void zpci_bus_release(struct kref *kref)
226 struct zpci_bus *zbus = container_of(kref, struct zpci_bus, kref);
229 pci_lock_rescan_remove();
230 pci_stop_root_bus(zbus->bus);
232 zpci_free_domain(zbus->domain_nr);
233 pci_free_resource_list(&zbus->resources);
235 pci_remove_root_bus(zbus->bus);
236 pci_unlock_rescan_remove();
239 mutex_lock(&zbus_list_lock);
240 list_del(&zbus->bus_next);
241 mutex_unlock(&zbus_list_lock);
245 static void zpci_bus_put(struct zpci_bus *zbus)
247 kref_put(&zbus->kref, zpci_bus_release);
250 static struct zpci_bus *zpci_bus_get(int pchid)
252 struct zpci_bus *zbus;
254 mutex_lock(&zbus_list_lock);
255 list_for_each_entry(zbus, &zbus_list, bus_next) {
256 if (pchid == zbus->pchid) {
257 kref_get(&zbus->kref);
263 mutex_unlock(&zbus_list_lock);
267 static struct zpci_bus *zpci_bus_alloc(int pchid)
269 struct zpci_bus *zbus;
271 zbus = kzalloc(sizeof(*zbus), GFP_KERNEL);
276 INIT_LIST_HEAD(&zbus->bus_next);
277 mutex_lock(&zbus_list_lock);
278 list_add_tail(&zbus->bus_next, &zbus_list);
279 mutex_unlock(&zbus_list_lock);
281 kref_init(&zbus->kref);
282 INIT_LIST_HEAD(&zbus->resources);
284 zbus->bus_resource.start = 0;
285 zbus->bus_resource.end = ZPCI_BUS_NR;
286 zbus->bus_resource.flags = IORESOURCE_BUS;
287 pci_add_resource(&zbus->resources, &zbus->bus_resource);
292 void pcibios_bus_add_device(struct pci_dev *pdev)
294 struct zpci_dev *zdev = to_zpci(pdev);
297 * With pdev->no_vf_scan the common PCI probing code does not
298 * perform PF/VF linking.
301 zpci_iov_setup_virtfn(zdev->zbus, pdev, zdev->vfn);
302 pdev->no_command_memory = 1;
306 /* zpci_bus_create_hotplug_slots - Add hotplug slot(s) for device added to bus
307 * @zdev: the zPCI device that was newly added
309 * Add the hotplug slot(s) for the newly added PCI function. Normally this is
310 * simply the slot for the function itself. If however we are adding the
311 * function 0 on a zbus, it might be that we already registered functions on
312 * that zbus but could not create their hotplug slots yet so add those now too.
314 * Return: 0 on success, an error code otherwise
316 static int zpci_bus_create_hotplug_slots(struct zpci_dev *zdev)
318 struct zpci_bus *zbus = zdev->zbus;
321 rc = zpci_init_slot(zdev);
324 zdev->has_hp_slot = 1;
326 if (zdev->devfn == 0 && zbus->multifunction) {
327 /* Now that function 0 is there we can finally create the
328 * hotplug slots for those functions with devfn != 0 that have
329 * been parked in zbus->function[] waiting for us to be able to
330 * create the PCI bus.
332 for (devfn = 1; devfn < ZPCI_FUNCTIONS_PER_BUS; devfn++) {
333 zdev = zbus->function[devfn];
334 if (zdev && !zdev->has_hp_slot) {
335 rc = zpci_init_slot(zdev);
338 zdev->has_hp_slot = 1;
347 static int zpci_bus_add_device(struct zpci_bus *zbus, struct zpci_dev *zdev)
351 if (zbus->function[zdev->devfn]) {
352 pr_err("devfn %04x is already assigned\n", zdev->devfn);
356 zbus->function[zdev->devfn] = zdev;
360 if (zbus->multifunction && !zdev->rid_available) {
361 WARN_ONCE(1, "rid_available not set for multifunction\n");
365 zpci_bus_create_hotplug_slots(zdev);
367 /* Hotplug slot will be created once function 0 appears */
368 zbus->multifunction = 1;
374 zbus->function[zdev->devfn] = NULL;
380 int zpci_bus_device_register(struct zpci_dev *zdev, struct pci_ops *ops)
382 struct zpci_bus *zbus = NULL;
385 if (zpci_nb_devices == ZPCI_NR_DEVICES) {
386 pr_warn("Adding PCI function %08x failed because the configured limit of %d is reached\n",
387 zdev->fid, ZPCI_NR_DEVICES);
391 if (zdev->devfn >= ZPCI_FUNCTIONS_PER_BUS)
394 if (!s390_pci_no_rid && zdev->rid_available)
395 zbus = zpci_bus_get(zdev->pchid);
398 zbus = zpci_bus_alloc(zdev->pchid);
403 if (zdev->devfn == 0) {
404 rc = zpci_bus_create_pci_bus(zbus, zdev, ops);
409 rc = zpci_bus_add_device(zbus, zdev);
416 pr_err("Adding PCI function %08x failed\n", zdev->fid);
421 void zpci_bus_device_unregister(struct zpci_dev *zdev)
423 struct zpci_bus *zbus = zdev->zbus;
426 zbus->function[zdev->devfn] = NULL;