1 // SPDX-License-Identifier: GPL-2.0-only
2 /* Copyright(c) 2020 Intel Corporation. */
3 #include <linux/io-64-nonatomic-lo-hi.h>
4 #include <linux/device.h>
5 #include <linux/slab.h>
12 * CXL device capabilities are enumerated by PCI DVSEC (Designated
13 * Vendor-specific) and / or descriptors provided by platform firmware.
14 * They can be defined as a set like the device and component registers
15 * mandated by CXL Section 8.1.12.2 Memory Device PCIe Capabilities and
16 * Extended Capabilities, or they can be individual capabilities
17 * appended to bridged and endpoint devices.
19 * Provide common infrastructure for enumerating and mapping these
20 * discrete capabilities.
24 * cxl_probe_component_regs() - Detect CXL Component register blocks
25 * @dev: Host device of the @base mapping
26 * @base: Mapping containing the HDM Decoder Capability Header
27 * @map: Map object describing the register block information found
29 * See CXL 2.0 8.2.4 Component Register Layout and Definition
30 * See CXL 2.0 8.2.5.5 CXL Device Register Interface
32 * Probe for component register information and return it in map object.
34 void cxl_probe_component_regs(struct device *dev, void __iomem *base,
35 struct cxl_component_reg_map *map)
40 *map = (struct cxl_component_reg_map) { 0 };
43 * CXL.cache and CXL.mem registers are at offset 0x1000 as defined in
44 * CXL 2.0 8.2.4 Table 141.
46 base += CXL_CM_OFFSET;
48 cap_array = readq(base + CXL_CM_CAP_HDR_OFFSET);
50 if (FIELD_GET(CXL_CM_CAP_HDR_ID_MASK, cap_array) != CM_CAP_HDR_CAP_ID) {
52 "Couldn't locate the CXL.cache and CXL.mem capability array header./n");
56 /* It's assumed that future versions will be backward compatible */
57 cap_count = FIELD_GET(CXL_CM_CAP_HDR_ARRAY_SIZE_MASK, cap_array);
59 for (cap = 1; cap <= cap_count; cap++) {
60 void __iomem *register_block;
66 hdr = readl(base + cap * 0x4);
68 cap_id = FIELD_GET(CXL_CM_CAP_HDR_ID_MASK, hdr);
69 offset = FIELD_GET(CXL_CM_CAP_PTR_MASK, hdr);
70 register_block = base + offset;
73 case CXL_CM_CAP_CAP_ID_HDM:
74 dev_dbg(dev, "found HDM decoder capability (0x%x)\n",
77 hdr = readl(register_block);
79 decoder_cnt = cxl_hdm_decoder_count(hdr);
80 length = 0x20 * decoder_cnt + 0x10;
82 map->hdm_decoder.valid = true;
83 map->hdm_decoder.offset = CXL_CM_OFFSET + offset;
84 map->hdm_decoder.size = length;
87 dev_dbg(dev, "Unknown CM cap ID: %d (0x%x)\n", cap_id,
93 EXPORT_SYMBOL_GPL(cxl_probe_component_regs);
96 * cxl_probe_device_regs() - Detect CXL Device register blocks
97 * @dev: Host device of the @base mapping
98 * @base: Mapping of CXL 2.0 8.2.8 CXL Device Register Interface
99 * @map: Map object describing the register block information found
101 * Probe for device register information and return it in map object.
103 void cxl_probe_device_regs(struct device *dev, void __iomem *base,
104 struct cxl_device_reg_map *map)
109 *map = (struct cxl_device_reg_map){ 0 };
111 cap_array = readq(base + CXLDEV_CAP_ARRAY_OFFSET);
112 if (FIELD_GET(CXLDEV_CAP_ARRAY_ID_MASK, cap_array) !=
113 CXLDEV_CAP_ARRAY_CAP_ID)
116 cap_count = FIELD_GET(CXLDEV_CAP_ARRAY_COUNT_MASK, cap_array);
118 for (cap = 1; cap <= cap_count; cap++) {
122 cap_id = FIELD_GET(CXLDEV_CAP_HDR_CAP_ID_MASK,
123 readl(base + cap * 0x10));
124 offset = readl(base + cap * 0x10 + 0x4);
125 length = readl(base + cap * 0x10 + 0x8);
128 case CXLDEV_CAP_CAP_ID_DEVICE_STATUS:
129 dev_dbg(dev, "found Status capability (0x%x)\n", offset);
131 map->status.valid = true;
132 map->status.offset = offset;
133 map->status.size = length;
135 case CXLDEV_CAP_CAP_ID_PRIMARY_MAILBOX:
136 dev_dbg(dev, "found Mailbox capability (0x%x)\n", offset);
137 map->mbox.valid = true;
138 map->mbox.offset = offset;
139 map->mbox.size = length;
141 case CXLDEV_CAP_CAP_ID_SECONDARY_MAILBOX:
142 dev_dbg(dev, "found Secondary Mailbox capability (0x%x)\n", offset);
144 case CXLDEV_CAP_CAP_ID_MEMDEV:
145 dev_dbg(dev, "found Memory Device capability (0x%x)\n", offset);
146 map->memdev.valid = true;
147 map->memdev.offset = offset;
148 map->memdev.size = length;
151 if (cap_id >= 0x8000)
152 dev_dbg(dev, "Vendor cap ID: %#x offset: %#x\n", cap_id, offset);
154 dev_dbg(dev, "Unknown cap ID: %#x offset: %#x\n", cap_id, offset);
159 EXPORT_SYMBOL_GPL(cxl_probe_device_regs);
161 static void __iomem *devm_cxl_iomap_block(struct device *dev,
162 resource_size_t addr,
163 resource_size_t length)
165 void __iomem *ret_val;
166 struct resource *res;
168 res = devm_request_mem_region(dev, addr, length, dev_name(dev));
170 resource_size_t end = addr + length - 1;
172 dev_err(dev, "Failed to request region %pa-%pa\n", &addr, &end);
176 ret_val = devm_ioremap(dev, addr, length);
178 dev_err(dev, "Failed to map region %pr\n", res);
183 int cxl_map_component_regs(struct pci_dev *pdev,
184 struct cxl_component_regs *regs,
185 struct cxl_register_map *map)
187 struct device *dev = &pdev->dev;
188 resource_size_t phys_addr;
189 resource_size_t length;
191 phys_addr = pci_resource_start(pdev, map->barno);
192 phys_addr += map->block_offset;
194 phys_addr += map->component_map.hdm_decoder.offset;
195 length = map->component_map.hdm_decoder.size;
196 regs->hdm_decoder = devm_cxl_iomap_block(dev, phys_addr, length);
197 if (!regs->hdm_decoder)
202 EXPORT_SYMBOL_GPL(cxl_map_component_regs);
204 int cxl_map_device_regs(struct pci_dev *pdev,
205 struct cxl_device_regs *regs,
206 struct cxl_register_map *map)
208 struct device *dev = &pdev->dev;
209 resource_size_t phys_addr;
211 phys_addr = pci_resource_start(pdev, map->barno);
212 phys_addr += map->block_offset;
214 if (map->device_map.status.valid) {
215 resource_size_t addr;
216 resource_size_t length;
218 addr = phys_addr + map->device_map.status.offset;
219 length = map->device_map.status.size;
220 regs->status = devm_cxl_iomap_block(dev, addr, length);
225 if (map->device_map.mbox.valid) {
226 resource_size_t addr;
227 resource_size_t length;
229 addr = phys_addr + map->device_map.mbox.offset;
230 length = map->device_map.mbox.size;
231 regs->mbox = devm_cxl_iomap_block(dev, addr, length);
236 if (map->device_map.memdev.valid) {
237 resource_size_t addr;
238 resource_size_t length;
240 addr = phys_addr + map->device_map.memdev.offset;
241 length = map->device_map.memdev.size;
242 regs->memdev = devm_cxl_iomap_block(dev, addr, length);
249 EXPORT_SYMBOL_GPL(cxl_map_device_regs);