xref: /linux/drivers/cxl/port.c (revision 24bce201d79807b668bf9d9e0aca801c5c0d5f78)
1 // SPDX-License-Identifier: GPL-2.0-only
2 /* Copyright(c) 2022 Intel Corporation. All rights reserved. */
3 #include <linux/device.h>
4 #include <linux/module.h>
5 #include <linux/slab.h>
6 
7 #include "cxlmem.h"
8 #include "cxlpci.h"
9 
10 /**
11  * DOC: cxl port
12  *
13  * The port driver enumerates dport via PCI and scans for HDM
14  * (Host-managed-Device-Memory) decoder resources via the
15  * @component_reg_phys value passed in by the agent that registered the
16  * port. All descendant ports of a CXL root port (described by platform
17  * firmware) are managed in this drivers context. Each driver instance
18  * is responsible for tearing down the driver context of immediate
19  * descendant ports. The locking for this is validated by
20  * CONFIG_PROVE_CXL_LOCKING.
21  *
22  * The primary service this driver provides is presenting APIs to other
23  * drivers to utilize the decoders, and indicating to userspace (via bind
24  * status) the connectivity of the CXL.mem protocol throughout the
25  * PCIe topology.
26  */
27 
28 static void schedule_detach(void *cxlmd)
29 {
30 	schedule_cxl_memdev_detach(cxlmd);
31 }
32 
33 static int cxl_port_probe(struct device *dev)
34 {
35 	struct cxl_port *port = to_cxl_port(dev);
36 	struct cxl_hdm *cxlhdm;
37 	int rc;
38 
39 
40 	if (!is_cxl_endpoint(port)) {
41 		rc = devm_cxl_port_enumerate_dports(port);
42 		if (rc < 0)
43 			return rc;
44 		if (rc == 1)
45 			return devm_cxl_add_passthrough_decoder(port);
46 	}
47 
48 	cxlhdm = devm_cxl_setup_hdm(port);
49 	if (IS_ERR(cxlhdm))
50 		return PTR_ERR(cxlhdm);
51 
52 	if (is_cxl_endpoint(port)) {
53 		struct cxl_memdev *cxlmd = to_cxl_memdev(port->uport);
54 		struct cxl_dev_state *cxlds = cxlmd->cxlds;
55 
56 		get_device(&cxlmd->dev);
57 		rc = devm_add_action_or_reset(dev, schedule_detach, cxlmd);
58 		if (rc)
59 			return rc;
60 
61 		rc = cxl_hdm_decode_init(cxlds, cxlhdm);
62 		if (rc)
63 			return rc;
64 
65 		rc = cxl_await_media_ready(cxlds);
66 		if (rc) {
67 			dev_err(dev, "Media not active (%d)\n", rc);
68 			return rc;
69 		}
70 	}
71 
72 	rc = devm_cxl_enumerate_decoders(cxlhdm);
73 	if (rc) {
74 		dev_err(dev, "Couldn't enumerate decoders (%d)\n", rc);
75 		return rc;
76 	}
77 
78 	return 0;
79 }
80 
81 static struct cxl_driver cxl_port_driver = {
82 	.name = "cxl_port",
83 	.probe = cxl_port_probe,
84 	.id = CXL_DEVICE_PORT,
85 };
86 
87 module_cxl_driver(cxl_port_driver);
88 MODULE_LICENSE("GPL v2");
89 MODULE_IMPORT_NS(CXL);
90 MODULE_ALIAS_CXL(CXL_DEVICE_PORT);
91