1 // SPDX-License-Identifier: GPL-2.0-only
2 /* Copyright(c) 2022 Intel Corporation. All rights reserved. */
3 #include <linux/memregion.h>
4 #include <linux/genalloc.h>
5 #include <linux/device.h>
6 #include <linux/module.h>
7 #include <linux/memory.h>
8 #include <linux/slab.h>
9 #include <linux/uuid.h>
10 #include <linux/sort.h>
11 #include <linux/idr.h>
12 #include <linux/memory-tiers.h>
18 * DOC: cxl core region
20 * CXL Regions represent mapped memory capacity in system physical address
21 * space. Whereas the CXL Root Decoders identify the bounds of potential CXL
22 * Memory ranges, Regions represent the active mapped capacity by the HDM
23 * Decoder Capability structures throughout the Host Bridges, Switches, and
24 * Endpoints in the topology.
26 * Region configuration has ordering constraints. UUID may be set at any time
27 * but is only visible for persistent regions.
28 * 1. Interleave granularity
33 static struct cxl_region
*to_cxl_region(struct device
*dev
);
35 #define __ACCESS_ATTR_RO(_level, _name) { \
36 .attr = { .name = __stringify(_name), .mode = 0444 }, \
37 .show = _name##_access##_level##_show, \
40 #define ACCESS_DEVICE_ATTR_RO(level, name) \
41 struct device_attribute dev_attr_access##level##_##name = __ACCESS_ATTR_RO(level, name)
43 #define ACCESS_ATTR_RO(level, attrib) \
44 static ssize_t attrib##_access##level##_show(struct device *dev, \
45 struct device_attribute *attr, \
48 struct cxl_region *cxlr = to_cxl_region(dev); \
50 if (cxlr->coord[level].attrib == 0) \
53 return sysfs_emit(buf, "%u\n", cxlr->coord[level].attrib); \
55 static ACCESS_DEVICE_ATTR_RO(level, attrib)
57 ACCESS_ATTR_RO(0, read_bandwidth
);
58 ACCESS_ATTR_RO(0, read_latency
);
59 ACCESS_ATTR_RO(0, write_bandwidth
);
60 ACCESS_ATTR_RO(0, write_latency
);
62 #define ACCESS_ATTR_DECLARE(level, attrib) \
63 (&dev_attr_access##level##_##attrib.attr)
65 static struct attribute
*access0_coordinate_attrs
[] = {
66 ACCESS_ATTR_DECLARE(0, read_bandwidth
),
67 ACCESS_ATTR_DECLARE(0, write_bandwidth
),
68 ACCESS_ATTR_DECLARE(0, read_latency
),
69 ACCESS_ATTR_DECLARE(0, write_latency
),
73 ACCESS_ATTR_RO(1, read_bandwidth
);
74 ACCESS_ATTR_RO(1, read_latency
);
75 ACCESS_ATTR_RO(1, write_bandwidth
);
76 ACCESS_ATTR_RO(1, write_latency
);
78 static struct attribute
*access1_coordinate_attrs
[] = {
79 ACCESS_ATTR_DECLARE(1, read_bandwidth
),
80 ACCESS_ATTR_DECLARE(1, write_bandwidth
),
81 ACCESS_ATTR_DECLARE(1, read_latency
),
82 ACCESS_ATTR_DECLARE(1, write_latency
),
86 #define ACCESS_VISIBLE(level) \
87 static umode_t cxl_region_access##level##_coordinate_visible( \
88 struct kobject *kobj, struct attribute *a, int n) \
90 struct device *dev = kobj_to_dev(kobj); \
91 struct cxl_region *cxlr = to_cxl_region(dev); \
93 if (a == &dev_attr_access##level##_read_latency.attr && \
94 cxlr->coord[level].read_latency == 0) \
97 if (a == &dev_attr_access##level##_write_latency.attr && \
98 cxlr->coord[level].write_latency == 0) \
101 if (a == &dev_attr_access##level##_read_bandwidth.attr && \
102 cxlr->coord[level].read_bandwidth == 0) \
105 if (a == &dev_attr_access##level##_write_bandwidth.attr && \
106 cxlr->coord[level].write_bandwidth == 0) \
115 static const struct attribute_group cxl_region_access0_coordinate_group
= {
117 .attrs
= access0_coordinate_attrs
,
118 .is_visible
= cxl_region_access0_coordinate_visible
,
121 static const struct attribute_group
*get_cxl_region_access0_group(void)
123 return &cxl_region_access0_coordinate_group
;
126 static const struct attribute_group cxl_region_access1_coordinate_group
= {
128 .attrs
= access1_coordinate_attrs
,
129 .is_visible
= cxl_region_access1_coordinate_visible
,
132 static const struct attribute_group
*get_cxl_region_access1_group(void)
134 return &cxl_region_access1_coordinate_group
;
137 static ssize_t
uuid_show(struct device
*dev
, struct device_attribute
*attr
,
140 struct cxl_region
*cxlr
= to_cxl_region(dev
);
141 struct cxl_region_params
*p
= &cxlr
->params
;
144 rc
= down_read_interruptible(&cxl_region_rwsem
);
147 if (cxlr
->mode
!= CXL_DECODER_PMEM
)
148 rc
= sysfs_emit(buf
, "\n");
150 rc
= sysfs_emit(buf
, "%pUb\n", &p
->uuid
);
151 up_read(&cxl_region_rwsem
);
156 static int is_dup(struct device
*match
, void *data
)
158 struct cxl_region_params
*p
;
159 struct cxl_region
*cxlr
;
162 if (!is_cxl_region(match
))
165 lockdep_assert_held(&cxl_region_rwsem
);
166 cxlr
= to_cxl_region(match
);
169 if (uuid_equal(&p
->uuid
, uuid
)) {
170 dev_dbg(match
, "already has uuid: %pUb\n", uuid
);
177 static ssize_t
uuid_store(struct device
*dev
, struct device_attribute
*attr
,
178 const char *buf
, size_t len
)
180 struct cxl_region
*cxlr
= to_cxl_region(dev
);
181 struct cxl_region_params
*p
= &cxlr
->params
;
185 if (len
!= UUID_STRING_LEN
+ 1)
188 rc
= uuid_parse(buf
, &temp
);
192 if (uuid_is_null(&temp
))
195 rc
= down_write_killable(&cxl_region_rwsem
);
199 if (uuid_equal(&p
->uuid
, &temp
))
203 if (p
->state
>= CXL_CONFIG_ACTIVE
)
206 rc
= bus_for_each_dev(&cxl_bus_type
, NULL
, &temp
, is_dup
);
210 uuid_copy(&p
->uuid
, &temp
);
212 up_write(&cxl_region_rwsem
);
218 static DEVICE_ATTR_RW(uuid
);
220 static struct cxl_region_ref
*cxl_rr_load(struct cxl_port
*port
,
221 struct cxl_region
*cxlr
)
223 return xa_load(&port
->regions
, (unsigned long)cxlr
);
226 static int cxl_region_invalidate_memregion(struct cxl_region
*cxlr
)
228 if (!cpu_cache_has_invalidate_memregion()) {
229 if (IS_ENABLED(CONFIG_CXL_REGION_INVALIDATION_TEST
)) {
232 "Bypassing cpu_cache_invalidate_memregion() for testing!\n");
236 "Failed to synchronize CPU cache state\n");
241 cpu_cache_invalidate_memregion(IORES_DESC_CXL
);
245 static void cxl_region_decode_reset(struct cxl_region
*cxlr
, int count
)
247 struct cxl_region_params
*p
= &cxlr
->params
;
251 * Before region teardown attempt to flush, evict any data cached for
252 * this region, or scream loudly about missing arch / platform support
255 cxl_region_invalidate_memregion(cxlr
);
257 for (i
= count
- 1; i
>= 0; i
--) {
258 struct cxl_endpoint_decoder
*cxled
= p
->targets
[i
];
259 struct cxl_memdev
*cxlmd
= cxled_to_memdev(cxled
);
260 struct cxl_port
*iter
= cxled_to_port(cxled
);
261 struct cxl_dev_state
*cxlds
= cxlmd
->cxlds
;
267 while (!is_cxl_root(to_cxl_port(iter
->dev
.parent
)))
268 iter
= to_cxl_port(iter
->dev
.parent
);
270 for (ep
= cxl_ep_load(iter
, cxlmd
); iter
;
271 iter
= ep
->next
, ep
= cxl_ep_load(iter
, cxlmd
)) {
272 struct cxl_region_ref
*cxl_rr
;
273 struct cxl_decoder
*cxld
;
275 cxl_rr
= cxl_rr_load(iter
, cxlr
);
276 cxld
= cxl_rr
->decoder
;
279 set_bit(CXL_REGION_F_NEEDS_RESET
, &cxlr
->flags
);
283 cxled
->cxld
.reset(&cxled
->cxld
);
284 set_bit(CXL_REGION_F_NEEDS_RESET
, &cxlr
->flags
);
287 /* all decoders associated with this region have been torn down */
288 clear_bit(CXL_REGION_F_NEEDS_RESET
, &cxlr
->flags
);
291 static int commit_decoder(struct cxl_decoder
*cxld
)
293 struct cxl_switch_decoder
*cxlsd
= NULL
;
296 return cxld
->commit(cxld
);
298 if (is_switch_decoder(&cxld
->dev
))
299 cxlsd
= to_cxl_switch_decoder(&cxld
->dev
);
301 if (dev_WARN_ONCE(&cxld
->dev
, !cxlsd
|| cxlsd
->nr_targets
> 1,
302 "->commit() is required\n"))
307 static int cxl_region_decode_commit(struct cxl_region
*cxlr
)
309 struct cxl_region_params
*p
= &cxlr
->params
;
312 for (i
= 0; i
< p
->nr_targets
; i
++) {
313 struct cxl_endpoint_decoder
*cxled
= p
->targets
[i
];
314 struct cxl_memdev
*cxlmd
= cxled_to_memdev(cxled
);
315 struct cxl_region_ref
*cxl_rr
;
316 struct cxl_decoder
*cxld
;
317 struct cxl_port
*iter
;
320 /* commit bottom up */
321 for (iter
= cxled_to_port(cxled
); !is_cxl_root(iter
);
322 iter
= to_cxl_port(iter
->dev
.parent
)) {
323 cxl_rr
= cxl_rr_load(iter
, cxlr
);
324 cxld
= cxl_rr
->decoder
;
325 rc
= commit_decoder(cxld
);
331 /* programming @iter failed, teardown */
332 for (ep
= cxl_ep_load(iter
, cxlmd
); ep
&& iter
;
333 iter
= ep
->next
, ep
= cxl_ep_load(iter
, cxlmd
)) {
334 cxl_rr
= cxl_rr_load(iter
, cxlr
);
335 cxld
= cxl_rr
->decoder
;
340 cxled
->cxld
.reset(&cxled
->cxld
);
348 /* undo the targets that were successfully committed */
349 cxl_region_decode_reset(cxlr
, i
);
353 static ssize_t
commit_store(struct device
*dev
, struct device_attribute
*attr
,
354 const char *buf
, size_t len
)
356 struct cxl_region
*cxlr
= to_cxl_region(dev
);
357 struct cxl_region_params
*p
= &cxlr
->params
;
361 rc
= kstrtobool(buf
, &commit
);
365 rc
= down_write_killable(&cxl_region_rwsem
);
369 /* Already in the requested state? */
370 if (commit
&& p
->state
>= CXL_CONFIG_COMMIT
)
372 if (!commit
&& p
->state
< CXL_CONFIG_COMMIT
)
375 /* Not ready to commit? */
376 if (commit
&& p
->state
< CXL_CONFIG_ACTIVE
) {
382 * Invalidate caches before region setup to drop any speculative
383 * consumption of this address space
385 rc
= cxl_region_invalidate_memregion(cxlr
);
390 rc
= cxl_region_decode_commit(cxlr
);
392 p
->state
= CXL_CONFIG_COMMIT
;
394 p
->state
= CXL_CONFIG_RESET_PENDING
;
395 up_write(&cxl_region_rwsem
);
396 device_release_driver(&cxlr
->dev
);
397 down_write(&cxl_region_rwsem
);
400 * The lock was dropped, so need to revalidate that the reset is
403 if (p
->state
== CXL_CONFIG_RESET_PENDING
) {
404 cxl_region_decode_reset(cxlr
, p
->interleave_ways
);
405 p
->state
= CXL_CONFIG_ACTIVE
;
410 up_write(&cxl_region_rwsem
);
417 static ssize_t
commit_show(struct device
*dev
, struct device_attribute
*attr
,
420 struct cxl_region
*cxlr
= to_cxl_region(dev
);
421 struct cxl_region_params
*p
= &cxlr
->params
;
424 rc
= down_read_interruptible(&cxl_region_rwsem
);
427 rc
= sysfs_emit(buf
, "%d\n", p
->state
>= CXL_CONFIG_COMMIT
);
428 up_read(&cxl_region_rwsem
);
432 static DEVICE_ATTR_RW(commit
);
434 static umode_t
cxl_region_visible(struct kobject
*kobj
, struct attribute
*a
,
437 struct device
*dev
= kobj_to_dev(kobj
);
438 struct cxl_region
*cxlr
= to_cxl_region(dev
);
441 * Support tooling that expects to find a 'uuid' attribute for all
442 * regions regardless of mode.
444 if (a
== &dev_attr_uuid
.attr
&& cxlr
->mode
!= CXL_DECODER_PMEM
)
449 static ssize_t
interleave_ways_show(struct device
*dev
,
450 struct device_attribute
*attr
, char *buf
)
452 struct cxl_region
*cxlr
= to_cxl_region(dev
);
453 struct cxl_region_params
*p
= &cxlr
->params
;
456 rc
= down_read_interruptible(&cxl_region_rwsem
);
459 rc
= sysfs_emit(buf
, "%d\n", p
->interleave_ways
);
460 up_read(&cxl_region_rwsem
);
465 static const struct attribute_group
*get_cxl_region_target_group(void);
467 static ssize_t
interleave_ways_store(struct device
*dev
,
468 struct device_attribute
*attr
,
469 const char *buf
, size_t len
)
471 struct cxl_root_decoder
*cxlrd
= to_cxl_root_decoder(dev
->parent
);
472 struct cxl_decoder
*cxld
= &cxlrd
->cxlsd
.cxld
;
473 struct cxl_region
*cxlr
= to_cxl_region(dev
);
474 struct cxl_region_params
*p
= &cxlr
->params
;
475 unsigned int val
, save
;
479 rc
= kstrtouint(buf
, 0, &val
);
483 rc
= ways_to_eiw(val
, &iw
);
488 * Even for x3, x6, and x12 interleaves the region interleave must be a
489 * power of 2 multiple of the host bridge interleave.
491 if (!is_power_of_2(val
/ cxld
->interleave_ways
) ||
492 (val
% cxld
->interleave_ways
)) {
493 dev_dbg(&cxlr
->dev
, "invalid interleave: %d\n", val
);
497 rc
= down_write_killable(&cxl_region_rwsem
);
500 if (p
->state
>= CXL_CONFIG_INTERLEAVE_ACTIVE
) {
505 save
= p
->interleave_ways
;
506 p
->interleave_ways
= val
;
507 rc
= sysfs_update_group(&cxlr
->dev
.kobj
, get_cxl_region_target_group());
509 p
->interleave_ways
= save
;
511 up_write(&cxl_region_rwsem
);
516 static DEVICE_ATTR_RW(interleave_ways
);
518 static ssize_t
interleave_granularity_show(struct device
*dev
,
519 struct device_attribute
*attr
,
522 struct cxl_region
*cxlr
= to_cxl_region(dev
);
523 struct cxl_region_params
*p
= &cxlr
->params
;
526 rc
= down_read_interruptible(&cxl_region_rwsem
);
529 rc
= sysfs_emit(buf
, "%d\n", p
->interleave_granularity
);
530 up_read(&cxl_region_rwsem
);
535 static ssize_t
interleave_granularity_store(struct device
*dev
,
536 struct device_attribute
*attr
,
537 const char *buf
, size_t len
)
539 struct cxl_root_decoder
*cxlrd
= to_cxl_root_decoder(dev
->parent
);
540 struct cxl_decoder
*cxld
= &cxlrd
->cxlsd
.cxld
;
541 struct cxl_region
*cxlr
= to_cxl_region(dev
);
542 struct cxl_region_params
*p
= &cxlr
->params
;
546 rc
= kstrtoint(buf
, 0, &val
);
550 rc
= granularity_to_eig(val
, &ig
);
555 * When the host-bridge is interleaved, disallow region granularity !=
556 * root granularity. Regions with a granularity less than the root
557 * interleave result in needing multiple endpoints to support a single
558 * slot in the interleave (possible to support in the future). Regions
559 * with a granularity greater than the root interleave result in invalid
560 * DPA translations (invalid to support).
562 if (cxld
->interleave_ways
> 1 && val
!= cxld
->interleave_granularity
)
565 rc
= down_write_killable(&cxl_region_rwsem
);
568 if (p
->state
>= CXL_CONFIG_INTERLEAVE_ACTIVE
) {
573 p
->interleave_granularity
= val
;
575 up_write(&cxl_region_rwsem
);
580 static DEVICE_ATTR_RW(interleave_granularity
);
582 static ssize_t
resource_show(struct device
*dev
, struct device_attribute
*attr
,
585 struct cxl_region
*cxlr
= to_cxl_region(dev
);
586 struct cxl_region_params
*p
= &cxlr
->params
;
587 u64 resource
= -1ULL;
590 rc
= down_read_interruptible(&cxl_region_rwsem
);
594 resource
= p
->res
->start
;
595 rc
= sysfs_emit(buf
, "%#llx\n", resource
);
596 up_read(&cxl_region_rwsem
);
600 static DEVICE_ATTR_RO(resource
);
602 static ssize_t
mode_show(struct device
*dev
, struct device_attribute
*attr
,
605 struct cxl_region
*cxlr
= to_cxl_region(dev
);
607 return sysfs_emit(buf
, "%s\n", cxl_decoder_mode_name(cxlr
->mode
));
609 static DEVICE_ATTR_RO(mode
);
611 static int alloc_hpa(struct cxl_region
*cxlr
, resource_size_t size
)
613 struct cxl_root_decoder
*cxlrd
= to_cxl_root_decoder(cxlr
->dev
.parent
);
614 struct cxl_region_params
*p
= &cxlr
->params
;
615 struct resource
*res
;
618 lockdep_assert_held_write(&cxl_region_rwsem
);
620 /* Nothing to do... */
621 if (p
->res
&& resource_size(p
->res
) == size
)
624 /* To change size the old size must be freed first */
628 if (p
->state
>= CXL_CONFIG_INTERLEAVE_ACTIVE
)
631 /* ways, granularity and uuid (if PMEM) need to be set before HPA */
632 if (!p
->interleave_ways
|| !p
->interleave_granularity
||
633 (cxlr
->mode
== CXL_DECODER_PMEM
&& uuid_is_null(&p
->uuid
)))
636 div64_u64_rem(size
, (u64
)SZ_256M
* p
->interleave_ways
, &remainder
);
640 res
= alloc_free_mem_region(cxlrd
->res
, size
, SZ_256M
,
641 dev_name(&cxlr
->dev
));
644 "HPA allocation error (%ld) for size:%pap in %s %pr\n",
645 PTR_ERR(res
), &size
, cxlrd
->res
->name
, cxlrd
->res
);
650 p
->state
= CXL_CONFIG_INTERLEAVE_ACTIVE
;
655 static void cxl_region_iomem_release(struct cxl_region
*cxlr
)
657 struct cxl_region_params
*p
= &cxlr
->params
;
659 if (device_is_registered(&cxlr
->dev
))
660 lockdep_assert_held_write(&cxl_region_rwsem
);
663 * Autodiscovered regions may not have been able to insert their
667 remove_resource(p
->res
);
673 static int free_hpa(struct cxl_region
*cxlr
)
675 struct cxl_region_params
*p
= &cxlr
->params
;
677 lockdep_assert_held_write(&cxl_region_rwsem
);
682 if (p
->state
>= CXL_CONFIG_ACTIVE
)
685 cxl_region_iomem_release(cxlr
);
686 p
->state
= CXL_CONFIG_IDLE
;
690 static ssize_t
size_store(struct device
*dev
, struct device_attribute
*attr
,
691 const char *buf
, size_t len
)
693 struct cxl_region
*cxlr
= to_cxl_region(dev
);
697 rc
= kstrtou64(buf
, 0, &val
);
701 rc
= down_write_killable(&cxl_region_rwsem
);
706 rc
= alloc_hpa(cxlr
, val
);
709 up_write(&cxl_region_rwsem
);
717 static ssize_t
size_show(struct device
*dev
, struct device_attribute
*attr
,
720 struct cxl_region
*cxlr
= to_cxl_region(dev
);
721 struct cxl_region_params
*p
= &cxlr
->params
;
725 rc
= down_read_interruptible(&cxl_region_rwsem
);
729 size
= resource_size(p
->res
);
730 rc
= sysfs_emit(buf
, "%#llx\n", size
);
731 up_read(&cxl_region_rwsem
);
735 static DEVICE_ATTR_RW(size
);
737 static struct attribute
*cxl_region_attrs
[] = {
739 &dev_attr_commit
.attr
,
740 &dev_attr_interleave_ways
.attr
,
741 &dev_attr_interleave_granularity
.attr
,
742 &dev_attr_resource
.attr
,
748 static const struct attribute_group cxl_region_group
= {
749 .attrs
= cxl_region_attrs
,
750 .is_visible
= cxl_region_visible
,
753 static size_t show_targetN(struct cxl_region
*cxlr
, char *buf
, int pos
)
755 struct cxl_region_params
*p
= &cxlr
->params
;
756 struct cxl_endpoint_decoder
*cxled
;
759 rc
= down_read_interruptible(&cxl_region_rwsem
);
763 if (pos
>= p
->interleave_ways
) {
764 dev_dbg(&cxlr
->dev
, "position %d out of range %d\n", pos
,
770 cxled
= p
->targets
[pos
];
772 rc
= sysfs_emit(buf
, "\n");
774 rc
= sysfs_emit(buf
, "%s\n", dev_name(&cxled
->cxld
.dev
));
776 up_read(&cxl_region_rwsem
);
781 static int check_commit_order(struct device
*dev
, void *data
)
783 struct cxl_decoder
*cxld
= to_cxl_decoder(dev
);
786 * if port->commit_end is not the only free decoder, then out of
787 * order shutdown has occurred, block further allocations until
790 if (((cxld
->flags
& CXL_DECODER_F_ENABLE
) == 0))
795 static int match_free_decoder(struct device
*dev
, const void *data
)
797 struct cxl_port
*port
= to_cxl_port(dev
->parent
);
798 struct cxl_decoder
*cxld
;
801 if (!is_switch_decoder(dev
))
804 cxld
= to_cxl_decoder(dev
);
806 if (cxld
->id
!= port
->commit_end
+ 1)
811 "next decoder to commit (%s) is already reserved (%s)\n",
812 dev_name(dev
), dev_name(&cxld
->region
->dev
));
816 rc
= device_for_each_child_reverse_from(dev
->parent
, dev
, NULL
,
820 "unable to allocate %s due to out of order shutdown\n",
827 static int match_auto_decoder(struct device
*dev
, const void *data
)
829 const struct cxl_region_params
*p
= data
;
830 struct cxl_decoder
*cxld
;
833 if (!is_switch_decoder(dev
))
836 cxld
= to_cxl_decoder(dev
);
837 r
= &cxld
->hpa_range
;
839 if (p
->res
&& p
->res
->start
== r
->start
&& p
->res
->end
== r
->end
)
845 static struct cxl_decoder
*
846 cxl_region_find_decoder(struct cxl_port
*port
,
847 struct cxl_endpoint_decoder
*cxled
,
848 struct cxl_region
*cxlr
)
852 if (port
== cxled_to_port(cxled
))
855 if (test_bit(CXL_REGION_F_AUTO
, &cxlr
->flags
))
856 dev
= device_find_child(&port
->dev
, &cxlr
->params
,
859 dev
= device_find_child(&port
->dev
, NULL
, match_free_decoder
);
863 * This decoder is pinned registered as long as the endpoint decoder is
864 * registered, and endpoint decoder unregistration holds the
865 * cxl_region_rwsem over unregister events, so no need to hold on to
866 * this extra reference.
869 return to_cxl_decoder(dev
);
872 static bool auto_order_ok(struct cxl_port
*port
, struct cxl_region
*cxlr_iter
,
873 struct cxl_decoder
*cxld
)
875 struct cxl_region_ref
*rr
= cxl_rr_load(port
, cxlr_iter
);
876 struct cxl_decoder
*cxld_iter
= rr
->decoder
;
879 * Allow the out of order assembly of auto-discovered regions.
880 * Per CXL Spec 3.1 8.2.4.20.12 software must commit decoders
881 * in HPA order. Confirm that the decoder with the lesser HPA
882 * starting address has the lesser id.
884 dev_dbg(&cxld
->dev
, "check for HPA violation %s:%d < %s:%d\n",
885 dev_name(&cxld
->dev
), cxld
->id
,
886 dev_name(&cxld_iter
->dev
), cxld_iter
->id
);
888 if (cxld_iter
->id
> cxld
->id
)
894 static struct cxl_region_ref
*
895 alloc_region_ref(struct cxl_port
*port
, struct cxl_region
*cxlr
,
896 struct cxl_endpoint_decoder
*cxled
)
898 struct cxl_region_params
*p
= &cxlr
->params
;
899 struct cxl_region_ref
*cxl_rr
, *iter
;
903 xa_for_each(&port
->regions
, index
, iter
) {
904 struct cxl_region_params
*ip
= &iter
->region
->params
;
906 if (!ip
->res
|| ip
->res
->start
< p
->res
->start
)
909 if (test_bit(CXL_REGION_F_AUTO
, &cxlr
->flags
)) {
910 struct cxl_decoder
*cxld
;
912 cxld
= cxl_region_find_decoder(port
, cxled
, cxlr
);
913 if (auto_order_ok(port
, iter
->region
, cxld
))
916 dev_dbg(&cxlr
->dev
, "%s: HPA order violation %s:%pr vs %pr\n",
917 dev_name(&port
->dev
),
918 dev_name(&iter
->region
->dev
), ip
->res
, p
->res
);
920 return ERR_PTR(-EBUSY
);
923 cxl_rr
= kzalloc(sizeof(*cxl_rr
), GFP_KERNEL
);
925 return ERR_PTR(-ENOMEM
);
927 cxl_rr
->region
= cxlr
;
928 cxl_rr
->nr_targets
= 1;
929 xa_init(&cxl_rr
->endpoints
);
931 rc
= xa_insert(&port
->regions
, (unsigned long)cxlr
, cxl_rr
, GFP_KERNEL
);
934 "%s: failed to track region reference: %d\n",
935 dev_name(&port
->dev
), rc
);
943 static void cxl_rr_free_decoder(struct cxl_region_ref
*cxl_rr
)
945 struct cxl_region
*cxlr
= cxl_rr
->region
;
946 struct cxl_decoder
*cxld
= cxl_rr
->decoder
;
951 dev_WARN_ONCE(&cxlr
->dev
, cxld
->region
!= cxlr
, "region mismatch\n");
952 if (cxld
->region
== cxlr
) {
954 put_device(&cxlr
->dev
);
958 static void free_region_ref(struct cxl_region_ref
*cxl_rr
)
960 struct cxl_port
*port
= cxl_rr
->port
;
961 struct cxl_region
*cxlr
= cxl_rr
->region
;
963 cxl_rr_free_decoder(cxl_rr
);
964 xa_erase(&port
->regions
, (unsigned long)cxlr
);
965 xa_destroy(&cxl_rr
->endpoints
);
969 static int cxl_rr_ep_add(struct cxl_region_ref
*cxl_rr
,
970 struct cxl_endpoint_decoder
*cxled
)
973 struct cxl_port
*port
= cxl_rr
->port
;
974 struct cxl_region
*cxlr
= cxl_rr
->region
;
975 struct cxl_decoder
*cxld
= cxl_rr
->decoder
;
976 struct cxl_ep
*ep
= cxl_ep_load(port
, cxled_to_memdev(cxled
));
979 rc
= xa_insert(&cxl_rr
->endpoints
, (unsigned long)cxled
, ep
,
988 get_device(&cxlr
->dev
);
994 static int cxl_rr_alloc_decoder(struct cxl_port
*port
, struct cxl_region
*cxlr
,
995 struct cxl_endpoint_decoder
*cxled
,
996 struct cxl_region_ref
*cxl_rr
)
998 struct cxl_decoder
*cxld
;
1000 cxld
= cxl_region_find_decoder(port
, cxled
, cxlr
);
1002 dev_dbg(&cxlr
->dev
, "%s: no decoder available\n",
1003 dev_name(&port
->dev
));
1008 dev_dbg(&cxlr
->dev
, "%s: %s already attached to %s\n",
1009 dev_name(&port
->dev
), dev_name(&cxld
->dev
),
1010 dev_name(&cxld
->region
->dev
));
1015 * Endpoints should already match the region type, but backstop that
1016 * assumption with an assertion. Switch-decoders change mapping-type
1017 * based on what is mapped when they are assigned to a region.
1019 dev_WARN_ONCE(&cxlr
->dev
,
1020 port
== cxled_to_port(cxled
) &&
1021 cxld
->target_type
!= cxlr
->type
,
1022 "%s:%s mismatch decoder type %d -> %d\n",
1023 dev_name(&cxled_to_memdev(cxled
)->dev
),
1024 dev_name(&cxld
->dev
), cxld
->target_type
, cxlr
->type
);
1025 cxld
->target_type
= cxlr
->type
;
1026 cxl_rr
->decoder
= cxld
;
1031 * cxl_port_attach_region() - track a region's interest in a port by endpoint
1032 * @port: port to add a new region reference 'struct cxl_region_ref'
1033 * @cxlr: region to attach to @port
1034 * @cxled: endpoint decoder used to create or further pin a region reference
1035 * @pos: interleave position of @cxled in @cxlr
1037 * The attach event is an opportunity to validate CXL decode setup
1038 * constraints and record metadata needed for programming HDM decoders,
1039 * in particular decoder target lists.
1043 * - validate that there are no other regions with a higher HPA already
1044 * associated with @port
1045 * - establish a region reference if one is not already present
1047 * - additionally allocate a decoder instance that will host @cxlr on
1050 * - pin the region reference by the endpoint
1051 * - account for how many entries in @port's target list are needed to
1052 * cover all of the added endpoints.
1054 static int cxl_port_attach_region(struct cxl_port
*port
,
1055 struct cxl_region
*cxlr
,
1056 struct cxl_endpoint_decoder
*cxled
, int pos
)
1058 struct cxl_memdev
*cxlmd
= cxled_to_memdev(cxled
);
1059 struct cxl_ep
*ep
= cxl_ep_load(port
, cxlmd
);
1060 struct cxl_region_ref
*cxl_rr
;
1061 bool nr_targets_inc
= false;
1062 struct cxl_decoder
*cxld
;
1063 unsigned long index
;
1066 lockdep_assert_held_write(&cxl_region_rwsem
);
1068 cxl_rr
= cxl_rr_load(port
, cxlr
);
1070 struct cxl_ep
*ep_iter
;
1074 * Walk the existing endpoints that have been attached to
1075 * @cxlr at @port and see if they share the same 'next' port
1076 * in the downstream direction. I.e. endpoints that share common
1079 xa_for_each(&cxl_rr
->endpoints
, index
, ep_iter
) {
1082 if (ep_iter
->next
== ep
->next
) {
1089 * New target port, or @port is an endpoint port that always
1090 * accounts its own local decode as a target.
1092 if (!found
|| !ep
->next
) {
1093 cxl_rr
->nr_targets
++;
1094 nr_targets_inc
= true;
1097 cxl_rr
= alloc_region_ref(port
, cxlr
, cxled
);
1098 if (IS_ERR(cxl_rr
)) {
1100 "%s: failed to allocate region reference\n",
1101 dev_name(&port
->dev
));
1102 return PTR_ERR(cxl_rr
);
1104 nr_targets_inc
= true;
1106 rc
= cxl_rr_alloc_decoder(port
, cxlr
, cxled
, cxl_rr
);
1110 cxld
= cxl_rr
->decoder
;
1113 * the number of targets should not exceed the target_count
1116 if (is_switch_decoder(&cxld
->dev
)) {
1117 struct cxl_switch_decoder
*cxlsd
;
1119 cxlsd
= to_cxl_switch_decoder(&cxld
->dev
);
1120 if (cxl_rr
->nr_targets
> cxlsd
->nr_targets
) {
1122 "%s:%s %s add: %s:%s @ %d overflows targets: %d\n",
1123 dev_name(port
->uport_dev
), dev_name(&port
->dev
),
1124 dev_name(&cxld
->dev
), dev_name(&cxlmd
->dev
),
1125 dev_name(&cxled
->cxld
.dev
), pos
,
1132 rc
= cxl_rr_ep_add(cxl_rr
, cxled
);
1135 "%s: failed to track endpoint %s:%s reference\n",
1136 dev_name(&port
->dev
), dev_name(&cxlmd
->dev
),
1137 dev_name(&cxld
->dev
));
1142 "%s:%s %s add: %s:%s @ %d next: %s nr_eps: %d nr_targets: %d\n",
1143 dev_name(port
->uport_dev
), dev_name(&port
->dev
),
1144 dev_name(&cxld
->dev
), dev_name(&cxlmd
->dev
),
1145 dev_name(&cxled
->cxld
.dev
), pos
,
1146 ep
? ep
->next
? dev_name(ep
->next
->uport_dev
) :
1147 dev_name(&cxlmd
->dev
) :
1149 cxl_rr
->nr_eps
, cxl_rr
->nr_targets
);
1154 cxl_rr
->nr_targets
--;
1155 if (cxl_rr
->nr_eps
== 0)
1156 free_region_ref(cxl_rr
);
1160 static void cxl_port_detach_region(struct cxl_port
*port
,
1161 struct cxl_region
*cxlr
,
1162 struct cxl_endpoint_decoder
*cxled
)
1164 struct cxl_region_ref
*cxl_rr
;
1165 struct cxl_ep
*ep
= NULL
;
1167 lockdep_assert_held_write(&cxl_region_rwsem
);
1169 cxl_rr
= cxl_rr_load(port
, cxlr
);
1174 * Endpoint ports do not carry cxl_ep references, and they
1175 * never target more than one endpoint by definition
1177 if (cxl_rr
->decoder
== &cxled
->cxld
)
1180 ep
= xa_erase(&cxl_rr
->endpoints
, (unsigned long)cxled
);
1182 struct cxl_ep
*ep_iter
;
1183 unsigned long index
;
1187 xa_for_each(&cxl_rr
->endpoints
, index
, ep_iter
) {
1188 if (ep_iter
->next
== ep
->next
) {
1194 cxl_rr
->nr_targets
--;
1197 if (cxl_rr
->nr_eps
== 0)
1198 free_region_ref(cxl_rr
);
1201 static int check_last_peer(struct cxl_endpoint_decoder
*cxled
,
1202 struct cxl_ep
*ep
, struct cxl_region_ref
*cxl_rr
,
1205 struct cxl_memdev
*cxlmd
= cxled_to_memdev(cxled
);
1206 struct cxl_region
*cxlr
= cxl_rr
->region
;
1207 struct cxl_region_params
*p
= &cxlr
->params
;
1208 struct cxl_endpoint_decoder
*cxled_peer
;
1209 struct cxl_port
*port
= cxl_rr
->port
;
1210 struct cxl_memdev
*cxlmd_peer
;
1211 struct cxl_ep
*ep_peer
;
1212 int pos
= cxled
->pos
;
1215 * If this position wants to share a dport with the last endpoint mapped
1216 * then that endpoint, at index 'position - distance', must also be
1217 * mapped by this dport.
1219 if (pos
< distance
) {
1220 dev_dbg(&cxlr
->dev
, "%s:%s: cannot host %s:%s at %d\n",
1221 dev_name(port
->uport_dev
), dev_name(&port
->dev
),
1222 dev_name(&cxlmd
->dev
), dev_name(&cxled
->cxld
.dev
), pos
);
1225 cxled_peer
= p
->targets
[pos
- distance
];
1226 cxlmd_peer
= cxled_to_memdev(cxled_peer
);
1227 ep_peer
= cxl_ep_load(port
, cxlmd_peer
);
1228 if (ep
->dport
!= ep_peer
->dport
) {
1230 "%s:%s: %s:%s pos %d mismatched peer %s:%s\n",
1231 dev_name(port
->uport_dev
), dev_name(&port
->dev
),
1232 dev_name(&cxlmd
->dev
), dev_name(&cxled
->cxld
.dev
), pos
,
1233 dev_name(&cxlmd_peer
->dev
),
1234 dev_name(&cxled_peer
->cxld
.dev
));
1241 static int check_interleave_cap(struct cxl_decoder
*cxld
, int iw
, int ig
)
1243 struct cxl_port
*port
= to_cxl_port(cxld
->dev
.parent
);
1244 struct cxl_hdm
*cxlhdm
= dev_get_drvdata(&port
->dev
);
1245 unsigned int interleave_mask
;
1248 int high_pos
, low_pos
;
1250 if (!test_bit(iw
, &cxlhdm
->iw_cap_mask
))
1253 * Per CXL specification r3.1(8.2.4.20.13 Decoder Protection),
1255 * DPAOFFSET[51: eig + 8] = HPAOFFSET[51: eig + 8 + eiw]
1256 * DPAOFFSET[eig + 7: 0] = HPAOFFSET[eig + 7: 0]
1258 * when the eiw is 0, all the bits of HPAOFFSET[51: 0] are used, the
1259 * interleave bits are none.
1262 * DPAOFFSET[51: eig + 8] = HPAOFFSET[51: eig + eiw] / 3
1263 * DPAOFFSET[eig + 7: 0] = HPAOFFSET[eig + 7: 0]
1265 * when the eiw is 8, all the bits of HPAOFFSET[51: 0] are used, the
1266 * interleave bits are none.
1268 ways_to_eiw(iw
, &eiw
);
1269 if (eiw
== 0 || eiw
== 8)
1272 granularity_to_eig(ig
, &eig
);
1274 high_pos
= eiw
+ eig
- 1;
1276 high_pos
= eiw
+ eig
+ 7;
1278 interleave_mask
= GENMASK(high_pos
, low_pos
);
1279 if (interleave_mask
& ~cxlhdm
->interleave_mask
)
1285 static int cxl_port_setup_targets(struct cxl_port
*port
,
1286 struct cxl_region
*cxlr
,
1287 struct cxl_endpoint_decoder
*cxled
)
1289 struct cxl_root_decoder
*cxlrd
= to_cxl_root_decoder(cxlr
->dev
.parent
);
1290 int parent_iw
, parent_ig
, ig
, iw
, rc
, inc
= 0, pos
= cxled
->pos
;
1291 struct cxl_port
*parent_port
= to_cxl_port(port
->dev
.parent
);
1292 struct cxl_region_ref
*cxl_rr
= cxl_rr_load(port
, cxlr
);
1293 struct cxl_memdev
*cxlmd
= cxled_to_memdev(cxled
);
1294 struct cxl_ep
*ep
= cxl_ep_load(port
, cxlmd
);
1295 struct cxl_region_params
*p
= &cxlr
->params
;
1296 struct cxl_decoder
*cxld
= cxl_rr
->decoder
;
1297 struct cxl_switch_decoder
*cxlsd
;
1298 struct cxl_port
*iter
= port
;
1303 * While root level decoders support x3, x6, x12, switch level
1304 * decoders only support powers of 2 up to x16.
1306 if (!is_power_of_2(cxl_rr
->nr_targets
)) {
1307 dev_dbg(&cxlr
->dev
, "%s:%s: invalid target count %d\n",
1308 dev_name(port
->uport_dev
), dev_name(&port
->dev
),
1309 cxl_rr
->nr_targets
);
1313 cxlsd
= to_cxl_switch_decoder(&cxld
->dev
);
1314 if (cxl_rr
->nr_targets_set
) {
1315 int i
, distance
= 1;
1316 struct cxl_region_ref
*cxl_rr_iter
;
1319 * The "distance" between peer downstream ports represents which
1320 * endpoint positions in the region interleave a given port can
1323 * For example, at the root of a hierarchy the distance is
1324 * always 1 as every index targets a different host-bridge. At
1325 * each subsequent switch level those ports map every Nth region
1326 * position where N is the width of the switch == distance.
1329 cxl_rr_iter
= cxl_rr_load(iter
, cxlr
);
1330 distance
*= cxl_rr_iter
->nr_targets
;
1331 iter
= to_cxl_port(iter
->dev
.parent
);
1332 } while (!is_cxl_root(iter
));
1333 distance
*= cxlrd
->cxlsd
.cxld
.interleave_ways
;
1335 for (i
= 0; i
< cxl_rr
->nr_targets_set
; i
++)
1336 if (ep
->dport
== cxlsd
->target
[i
]) {
1337 rc
= check_last_peer(cxled
, ep
, cxl_rr
,
1341 goto out_target_set
;
1346 if (is_cxl_root(parent_port
)) {
1348 * Root decoder IG is always set to value in CFMWS which
1349 * may be different than this region's IG. We can use the
1350 * region's IG here since interleave_granularity_store()
1351 * does not allow interleaved host-bridges with
1352 * root IG != region IG.
1354 parent_ig
= p
->interleave_granularity
;
1355 parent_iw
= cxlrd
->cxlsd
.cxld
.interleave_ways
;
1357 * For purposes of address bit routing, use power-of-2 math for
1360 if (!is_power_of_2(parent_iw
))
1363 struct cxl_region_ref
*parent_rr
;
1364 struct cxl_decoder
*parent_cxld
;
1366 parent_rr
= cxl_rr_load(parent_port
, cxlr
);
1367 parent_cxld
= parent_rr
->decoder
;
1368 parent_ig
= parent_cxld
->interleave_granularity
;
1369 parent_iw
= parent_cxld
->interleave_ways
;
1372 rc
= granularity_to_eig(parent_ig
, &peig
);
1374 dev_dbg(&cxlr
->dev
, "%s:%s: invalid parent granularity: %d\n",
1375 dev_name(parent_port
->uport_dev
),
1376 dev_name(&parent_port
->dev
), parent_ig
);
1380 rc
= ways_to_eiw(parent_iw
, &peiw
);
1382 dev_dbg(&cxlr
->dev
, "%s:%s: invalid parent interleave: %d\n",
1383 dev_name(parent_port
->uport_dev
),
1384 dev_name(&parent_port
->dev
), parent_iw
);
1388 iw
= cxl_rr
->nr_targets
;
1389 rc
= ways_to_eiw(iw
, &eiw
);
1391 dev_dbg(&cxlr
->dev
, "%s:%s: invalid port interleave: %d\n",
1392 dev_name(port
->uport_dev
), dev_name(&port
->dev
), iw
);
1397 * Interleave granularity is a multiple of @parent_port granularity.
1398 * Multiplier is the parent port interleave ways.
1400 rc
= granularity_to_eig(parent_ig
* parent_iw
, &eig
);
1403 "%s: invalid granularity calculation (%d * %d)\n",
1404 dev_name(&parent_port
->dev
), parent_ig
, parent_iw
);
1408 rc
= eig_to_granularity(eig
, &ig
);
1410 dev_dbg(&cxlr
->dev
, "%s:%s: invalid interleave: %d\n",
1411 dev_name(port
->uport_dev
), dev_name(&port
->dev
),
1416 if (iw
> 8 || iw
> cxlsd
->nr_targets
) {
1418 "%s:%s:%s: ways: %d overflows targets: %d\n",
1419 dev_name(port
->uport_dev
), dev_name(&port
->dev
),
1420 dev_name(&cxld
->dev
), iw
, cxlsd
->nr_targets
);
1424 if (test_bit(CXL_REGION_F_AUTO
, &cxlr
->flags
)) {
1425 if (cxld
->interleave_ways
!= iw
||
1426 cxld
->interleave_granularity
!= ig
||
1427 cxld
->hpa_range
.start
!= p
->res
->start
||
1428 cxld
->hpa_range
.end
!= p
->res
->end
||
1429 ((cxld
->flags
& CXL_DECODER_F_ENABLE
) == 0)) {
1431 "%s:%s %s expected iw: %d ig: %d %pr\n",
1432 dev_name(port
->uport_dev
), dev_name(&port
->dev
),
1433 __func__
, iw
, ig
, p
->res
);
1435 "%s:%s %s got iw: %d ig: %d state: %s %#llx:%#llx\n",
1436 dev_name(port
->uport_dev
), dev_name(&port
->dev
),
1437 __func__
, cxld
->interleave_ways
,
1438 cxld
->interleave_granularity
,
1439 (cxld
->flags
& CXL_DECODER_F_ENABLE
) ?
1442 cxld
->hpa_range
.start
, cxld
->hpa_range
.end
);
1446 rc
= check_interleave_cap(cxld
, iw
, ig
);
1449 "%s:%s iw: %d ig: %d is not supported\n",
1450 dev_name(port
->uport_dev
),
1451 dev_name(&port
->dev
), iw
, ig
);
1455 cxld
->interleave_ways
= iw
;
1456 cxld
->interleave_granularity
= ig
;
1457 cxld
->hpa_range
= (struct range
) {
1458 .start
= p
->res
->start
,
1462 dev_dbg(&cxlr
->dev
, "%s:%s iw: %d ig: %d\n", dev_name(port
->uport_dev
),
1463 dev_name(&port
->dev
), iw
, ig
);
1465 if (cxl_rr
->nr_targets_set
== cxl_rr
->nr_targets
) {
1467 "%s:%s: targets full trying to add %s:%s at %d\n",
1468 dev_name(port
->uport_dev
), dev_name(&port
->dev
),
1469 dev_name(&cxlmd
->dev
), dev_name(&cxled
->cxld
.dev
), pos
);
1472 if (test_bit(CXL_REGION_F_AUTO
, &cxlr
->flags
)) {
1473 if (cxlsd
->target
[cxl_rr
->nr_targets_set
] != ep
->dport
) {
1474 dev_dbg(&cxlr
->dev
, "%s:%s: %s expected %s at %d\n",
1475 dev_name(port
->uport_dev
), dev_name(&port
->dev
),
1476 dev_name(&cxlsd
->cxld
.dev
),
1477 dev_name(ep
->dport
->dport_dev
),
1478 cxl_rr
->nr_targets_set
);
1482 cxlsd
->target
[cxl_rr
->nr_targets_set
] = ep
->dport
;
1485 cxl_rr
->nr_targets_set
+= inc
;
1486 dev_dbg(&cxlr
->dev
, "%s:%s target[%d] = %s for %s:%s @ %d\n",
1487 dev_name(port
->uport_dev
), dev_name(&port
->dev
),
1488 cxl_rr
->nr_targets_set
- 1, dev_name(ep
->dport
->dport_dev
),
1489 dev_name(&cxlmd
->dev
), dev_name(&cxled
->cxld
.dev
), pos
);
1494 static void cxl_port_reset_targets(struct cxl_port
*port
,
1495 struct cxl_region
*cxlr
)
1497 struct cxl_region_ref
*cxl_rr
= cxl_rr_load(port
, cxlr
);
1498 struct cxl_decoder
*cxld
;
1501 * After the last endpoint has been detached the entire cxl_rr may now
1506 cxl_rr
->nr_targets_set
= 0;
1508 cxld
= cxl_rr
->decoder
;
1509 cxld
->hpa_range
= (struct range
) {
1515 static void cxl_region_teardown_targets(struct cxl_region
*cxlr
)
1517 struct cxl_region_params
*p
= &cxlr
->params
;
1518 struct cxl_endpoint_decoder
*cxled
;
1519 struct cxl_dev_state
*cxlds
;
1520 struct cxl_memdev
*cxlmd
;
1521 struct cxl_port
*iter
;
1526 * In the auto-discovery case skip automatic teardown since the
1527 * address space is already active
1529 if (test_bit(CXL_REGION_F_AUTO
, &cxlr
->flags
))
1532 for (i
= 0; i
< p
->nr_targets
; i
++) {
1533 cxled
= p
->targets
[i
];
1534 cxlmd
= cxled_to_memdev(cxled
);
1535 cxlds
= cxlmd
->cxlds
;
1540 iter
= cxled_to_port(cxled
);
1541 while (!is_cxl_root(to_cxl_port(iter
->dev
.parent
)))
1542 iter
= to_cxl_port(iter
->dev
.parent
);
1544 for (ep
= cxl_ep_load(iter
, cxlmd
); iter
;
1545 iter
= ep
->next
, ep
= cxl_ep_load(iter
, cxlmd
))
1546 cxl_port_reset_targets(iter
, cxlr
);
1550 static int cxl_region_setup_targets(struct cxl_region
*cxlr
)
1552 struct cxl_region_params
*p
= &cxlr
->params
;
1553 struct cxl_endpoint_decoder
*cxled
;
1554 struct cxl_dev_state
*cxlds
;
1555 int i
, rc
, rch
= 0, vh
= 0;
1556 struct cxl_memdev
*cxlmd
;
1557 struct cxl_port
*iter
;
1560 for (i
= 0; i
< p
->nr_targets
; i
++) {
1561 cxled
= p
->targets
[i
];
1562 cxlmd
= cxled_to_memdev(cxled
);
1563 cxlds
= cxlmd
->cxlds
;
1565 /* validate that all targets agree on topology */
1573 iter
= cxled_to_port(cxled
);
1574 while (!is_cxl_root(to_cxl_port(iter
->dev
.parent
)))
1575 iter
= to_cxl_port(iter
->dev
.parent
);
1578 * Descend the topology tree programming / validating
1579 * targets while looking for conflicts.
1581 for (ep
= cxl_ep_load(iter
, cxlmd
); iter
;
1582 iter
= ep
->next
, ep
= cxl_ep_load(iter
, cxlmd
)) {
1583 rc
= cxl_port_setup_targets(iter
, cxlr
, cxled
);
1585 cxl_region_teardown_targets(cxlr
);
1592 dev_err(&cxlr
->dev
, "mismatched CXL topologies detected\n");
1593 cxl_region_teardown_targets(cxlr
);
1600 static int cxl_region_validate_position(struct cxl_region
*cxlr
,
1601 struct cxl_endpoint_decoder
*cxled
,
1604 struct cxl_memdev
*cxlmd
= cxled_to_memdev(cxled
);
1605 struct cxl_region_params
*p
= &cxlr
->params
;
1608 if (pos
< 0 || pos
>= p
->interleave_ways
) {
1609 dev_dbg(&cxlr
->dev
, "position %d out of range %d\n", pos
,
1610 p
->interleave_ways
);
1614 if (p
->targets
[pos
] == cxled
)
1617 if (p
->targets
[pos
]) {
1618 struct cxl_endpoint_decoder
*cxled_target
= p
->targets
[pos
];
1619 struct cxl_memdev
*cxlmd_target
= cxled_to_memdev(cxled_target
);
1621 dev_dbg(&cxlr
->dev
, "position %d already assigned to %s:%s\n",
1622 pos
, dev_name(&cxlmd_target
->dev
),
1623 dev_name(&cxled_target
->cxld
.dev
));
1627 for (i
= 0; i
< p
->interleave_ways
; i
++) {
1628 struct cxl_endpoint_decoder
*cxled_target
;
1629 struct cxl_memdev
*cxlmd_target
;
1631 cxled_target
= p
->targets
[i
];
1635 cxlmd_target
= cxled_to_memdev(cxled_target
);
1636 if (cxlmd_target
== cxlmd
) {
1638 "%s already specified at position %d via: %s\n",
1639 dev_name(&cxlmd
->dev
), pos
,
1640 dev_name(&cxled_target
->cxld
.dev
));
1648 static int cxl_region_attach_position(struct cxl_region
*cxlr
,
1649 struct cxl_root_decoder
*cxlrd
,
1650 struct cxl_endpoint_decoder
*cxled
,
1651 const struct cxl_dport
*dport
, int pos
)
1653 struct cxl_memdev
*cxlmd
= cxled_to_memdev(cxled
);
1654 struct cxl_switch_decoder
*cxlsd
= &cxlrd
->cxlsd
;
1655 struct cxl_decoder
*cxld
= &cxlsd
->cxld
;
1656 int iw
= cxld
->interleave_ways
;
1657 struct cxl_port
*iter
;
1660 if (dport
!= cxlrd
->cxlsd
.target
[pos
% iw
]) {
1661 dev_dbg(&cxlr
->dev
, "%s:%s invalid target position for %s\n",
1662 dev_name(&cxlmd
->dev
), dev_name(&cxled
->cxld
.dev
),
1663 dev_name(&cxlrd
->cxlsd
.cxld
.dev
));
1667 for (iter
= cxled_to_port(cxled
); !is_cxl_root(iter
);
1668 iter
= to_cxl_port(iter
->dev
.parent
)) {
1669 rc
= cxl_port_attach_region(iter
, cxlr
, cxled
, pos
);
1677 for (iter
= cxled_to_port(cxled
); !is_cxl_root(iter
);
1678 iter
= to_cxl_port(iter
->dev
.parent
))
1679 cxl_port_detach_region(iter
, cxlr
, cxled
);
1683 static int cxl_region_attach_auto(struct cxl_region
*cxlr
,
1684 struct cxl_endpoint_decoder
*cxled
, int pos
)
1686 struct cxl_region_params
*p
= &cxlr
->params
;
1688 if (cxled
->state
!= CXL_DECODER_STATE_AUTO
) {
1690 "%s: unable to add decoder to autodetected region\n",
1691 dev_name(&cxled
->cxld
.dev
));
1696 dev_dbg(&cxlr
->dev
, "%s: expected auto position, not %d\n",
1697 dev_name(&cxled
->cxld
.dev
), pos
);
1701 if (p
->nr_targets
>= p
->interleave_ways
) {
1702 dev_err(&cxlr
->dev
, "%s: no more target slots available\n",
1703 dev_name(&cxled
->cxld
.dev
));
1708 * Temporarily record the endpoint decoder into the target array. Yes,
1709 * this means that userspace can view devices in the wrong position
1710 * before the region activates, and must be careful to understand when
1711 * it might be racing region autodiscovery.
1713 pos
= p
->nr_targets
;
1714 p
->targets
[pos
] = cxled
;
1721 static int cmp_interleave_pos(const void *a
, const void *b
)
1723 struct cxl_endpoint_decoder
*cxled_a
= *(typeof(cxled_a
) *)a
;
1724 struct cxl_endpoint_decoder
*cxled_b
= *(typeof(cxled_b
) *)b
;
1726 return cxled_a
->pos
- cxled_b
->pos
;
1729 static struct cxl_port
*next_port(struct cxl_port
*port
)
1731 if (!port
->parent_dport
)
1733 return port
->parent_dport
->port
;
1736 static int match_switch_decoder_by_range(struct device
*dev
,
1739 struct cxl_switch_decoder
*cxlsd
;
1740 const struct range
*r1
, *r2
= data
;
1743 if (!is_switch_decoder(dev
))
1746 cxlsd
= to_cxl_switch_decoder(dev
);
1747 r1
= &cxlsd
->cxld
.hpa_range
;
1749 if (is_root_decoder(dev
))
1750 return range_contains(r1
, r2
);
1751 return (r1
->start
== r2
->start
&& r1
->end
== r2
->end
);
1754 static int find_pos_and_ways(struct cxl_port
*port
, struct range
*range
,
1755 int *pos
, int *ways
)
1757 struct cxl_switch_decoder
*cxlsd
;
1758 struct cxl_port
*parent
;
1762 parent
= next_port(port
);
1766 dev
= device_find_child(&parent
->dev
, range
,
1767 match_switch_decoder_by_range
);
1769 dev_err(port
->uport_dev
,
1770 "failed to find decoder mapping %#llx-%#llx\n",
1771 range
->start
, range
->end
);
1774 cxlsd
= to_cxl_switch_decoder(dev
);
1775 *ways
= cxlsd
->cxld
.interleave_ways
;
1777 for (int i
= 0; i
< *ways
; i
++) {
1778 if (cxlsd
->target
[i
] == port
->parent_dport
) {
1790 * cxl_calc_interleave_pos() - calculate an endpoint position in a region
1791 * @cxled: endpoint decoder member of given region
1793 * The endpoint position is calculated by traversing the topology from
1794 * the endpoint to the root decoder and iteratively applying this
1797 * position = position * parent_ways + parent_pos;
1799 * ...where @position is inferred from switch and root decoder target lists.
1801 * Return: position >= 0 on success
1804 static int cxl_calc_interleave_pos(struct cxl_endpoint_decoder
*cxled
)
1806 struct cxl_port
*iter
, *port
= cxled_to_port(cxled
);
1807 struct cxl_memdev
*cxlmd
= cxled_to_memdev(cxled
);
1808 struct range
*range
= &cxled
->cxld
.hpa_range
;
1809 int parent_ways
= 0, parent_pos
= 0, pos
= 0;
1813 * Example: the expected interleave order of the 4-way region shown
1814 * below is: mem0, mem2, mem1, mem3
1818 * host_bridge_0 host_bridge_1
1820 * mem0 mem1 mem2 mem3
1822 * In the example the calculator will iterate twice. The first iteration
1823 * uses the mem position in the host-bridge and the ways of the host-
1824 * bridge to generate the first, or local, position. The second
1825 * iteration uses the host-bridge position in the root_port and the ways
1826 * of the root_port to refine the position.
1828 * A trace of the calculation per endpoint looks like this:
1829 * mem0: pos = 0 * 2 + 0 mem2: pos = 0 * 2 + 0
1830 * pos = 0 * 2 + 0 pos = 0 * 2 + 1
1833 * mem1: pos = 0 * 2 + 1 mem3: pos = 0 * 2 + 1
1834 * pos = 1 * 2 + 0 pos = 1 * 2 + 1
1837 * Note that while this example is simple, the method applies to more
1838 * complex topologies, including those with switches.
1841 /* Iterate from endpoint to root_port refining the position */
1842 for (iter
= port
; iter
; iter
= next_port(iter
)) {
1843 if (is_cxl_root(iter
))
1846 rc
= find_pos_and_ways(iter
, range
, &parent_pos
, &parent_ways
);
1850 pos
= pos
* parent_ways
+ parent_pos
;
1853 dev_dbg(&cxlmd
->dev
,
1854 "decoder:%s parent:%s port:%s range:%#llx-%#llx pos:%d\n",
1855 dev_name(&cxled
->cxld
.dev
), dev_name(cxlmd
->dev
.parent
),
1856 dev_name(&port
->dev
), range
->start
, range
->end
, pos
);
1861 static int cxl_region_sort_targets(struct cxl_region
*cxlr
)
1863 struct cxl_region_params
*p
= &cxlr
->params
;
1866 for (i
= 0; i
< p
->nr_targets
; i
++) {
1867 struct cxl_endpoint_decoder
*cxled
= p
->targets
[i
];
1869 cxled
->pos
= cxl_calc_interleave_pos(cxled
);
1871 * Record that sorting failed, but still continue to calc
1872 * cxled->pos so that follow-on code paths can reliably
1873 * do p->targets[cxled->pos] to self-reference their entry.
1878 /* Keep the cxlr target list in interleave position order */
1879 sort(p
->targets
, p
->nr_targets
, sizeof(p
->targets
[0]),
1880 cmp_interleave_pos
, NULL
);
1882 dev_dbg(&cxlr
->dev
, "region sort %s\n", rc
? "failed" : "successful");
1886 static int cxl_region_attach(struct cxl_region
*cxlr
,
1887 struct cxl_endpoint_decoder
*cxled
, int pos
)
1889 struct cxl_root_decoder
*cxlrd
= to_cxl_root_decoder(cxlr
->dev
.parent
);
1890 struct cxl_memdev
*cxlmd
= cxled_to_memdev(cxled
);
1891 struct cxl_region_params
*p
= &cxlr
->params
;
1892 struct cxl_port
*ep_port
, *root_port
;
1893 struct cxl_dport
*dport
;
1896 rc
= check_interleave_cap(&cxled
->cxld
, p
->interleave_ways
,
1897 p
->interleave_granularity
);
1899 dev_dbg(&cxlr
->dev
, "%s iw: %d ig: %d is not supported\n",
1900 dev_name(&cxled
->cxld
.dev
), p
->interleave_ways
,
1901 p
->interleave_granularity
);
1905 if (cxled
->mode
!= cxlr
->mode
) {
1906 dev_dbg(&cxlr
->dev
, "%s region mode: %d mismatch: %d\n",
1907 dev_name(&cxled
->cxld
.dev
), cxlr
->mode
, cxled
->mode
);
1911 if (cxled
->mode
== CXL_DECODER_DEAD
) {
1912 dev_dbg(&cxlr
->dev
, "%s dead\n", dev_name(&cxled
->cxld
.dev
));
1916 /* all full of members, or interleave config not established? */
1917 if (p
->state
> CXL_CONFIG_INTERLEAVE_ACTIVE
) {
1918 dev_dbg(&cxlr
->dev
, "region already active\n");
1920 } else if (p
->state
< CXL_CONFIG_INTERLEAVE_ACTIVE
) {
1921 dev_dbg(&cxlr
->dev
, "interleave config missing\n");
1925 if (p
->nr_targets
>= p
->interleave_ways
) {
1926 dev_dbg(&cxlr
->dev
, "region already has %d endpoints\n",
1931 ep_port
= cxled_to_port(cxled
);
1932 root_port
= cxlrd_to_port(cxlrd
);
1933 dport
= cxl_find_dport_by_dev(root_port
, ep_port
->host_bridge
);
1935 dev_dbg(&cxlr
->dev
, "%s:%s invalid target for %s\n",
1936 dev_name(&cxlmd
->dev
), dev_name(&cxled
->cxld
.dev
),
1937 dev_name(cxlr
->dev
.parent
));
1941 if (cxled
->cxld
.target_type
!= cxlr
->type
) {
1942 dev_dbg(&cxlr
->dev
, "%s:%s type mismatch: %d vs %d\n",
1943 dev_name(&cxlmd
->dev
), dev_name(&cxled
->cxld
.dev
),
1944 cxled
->cxld
.target_type
, cxlr
->type
);
1948 if (!cxled
->dpa_res
) {
1949 dev_dbg(&cxlr
->dev
, "%s:%s: missing DPA allocation.\n",
1950 dev_name(&cxlmd
->dev
), dev_name(&cxled
->cxld
.dev
));
1954 if (resource_size(cxled
->dpa_res
) * p
->interleave_ways
!=
1955 resource_size(p
->res
)) {
1957 "%s:%s: decoder-size-%#llx * ways-%d != region-size-%#llx\n",
1958 dev_name(&cxlmd
->dev
), dev_name(&cxled
->cxld
.dev
),
1959 (u64
)resource_size(cxled
->dpa_res
), p
->interleave_ways
,
1960 (u64
)resource_size(p
->res
));
1964 cxl_region_perf_data_calculate(cxlr
, cxled
);
1966 if (test_bit(CXL_REGION_F_AUTO
, &cxlr
->flags
)) {
1969 rc
= cxl_region_attach_auto(cxlr
, cxled
, pos
);
1973 /* await more targets to arrive... */
1974 if (p
->nr_targets
< p
->interleave_ways
)
1978 * All targets are here, which implies all PCI enumeration that
1979 * affects this region has been completed. Walk the topology to
1980 * sort the devices into their relative region decode position.
1982 rc
= cxl_region_sort_targets(cxlr
);
1986 for (i
= 0; i
< p
->nr_targets
; i
++) {
1987 cxled
= p
->targets
[i
];
1988 ep_port
= cxled_to_port(cxled
);
1989 dport
= cxl_find_dport_by_dev(root_port
,
1990 ep_port
->host_bridge
);
1991 rc
= cxl_region_attach_position(cxlr
, cxlrd
, cxled
,
1997 rc
= cxl_region_setup_targets(cxlr
);
2002 * If target setup succeeds in the autodiscovery case
2003 * then the region is already committed.
2005 p
->state
= CXL_CONFIG_COMMIT
;
2006 cxl_region_shared_upstream_bandwidth_update(cxlr
);
2011 rc
= cxl_region_validate_position(cxlr
, cxled
, pos
);
2015 rc
= cxl_region_attach_position(cxlr
, cxlrd
, cxled
, dport
, pos
);
2019 p
->targets
[pos
] = cxled
;
2023 if (p
->nr_targets
== p
->interleave_ways
) {
2024 rc
= cxl_region_setup_targets(cxlr
);
2027 p
->state
= CXL_CONFIG_ACTIVE
;
2028 cxl_region_shared_upstream_bandwidth_update(cxlr
);
2031 cxled
->cxld
.interleave_ways
= p
->interleave_ways
;
2032 cxled
->cxld
.interleave_granularity
= p
->interleave_granularity
;
2033 cxled
->cxld
.hpa_range
= (struct range
) {
2034 .start
= p
->res
->start
,
2038 if (p
->nr_targets
!= p
->interleave_ways
)
2042 * Test the auto-discovery position calculator function
2043 * against this successfully created user-defined region.
2044 * A fail message here means that this interleave config
2045 * will fail when presented as CXL_REGION_F_AUTO.
2047 for (int i
= 0; i
< p
->nr_targets
; i
++) {
2048 struct cxl_endpoint_decoder
*cxled
= p
->targets
[i
];
2051 test_pos
= cxl_calc_interleave_pos(cxled
);
2052 dev_dbg(&cxled
->cxld
.dev
,
2053 "Test cxl_calc_interleave_pos(): %s test_pos:%d cxled->pos:%d\n",
2054 (test_pos
== cxled
->pos
) ? "success" : "fail",
2055 test_pos
, cxled
->pos
);
2061 static int cxl_region_detach(struct cxl_endpoint_decoder
*cxled
)
2063 struct cxl_port
*iter
, *ep_port
= cxled_to_port(cxled
);
2064 struct cxl_region
*cxlr
= cxled
->cxld
.region
;
2065 struct cxl_region_params
*p
;
2068 lockdep_assert_held_write(&cxl_region_rwsem
);
2074 get_device(&cxlr
->dev
);
2076 if (p
->state
> CXL_CONFIG_ACTIVE
) {
2077 cxl_region_decode_reset(cxlr
, p
->interleave_ways
);
2078 p
->state
= CXL_CONFIG_ACTIVE
;
2081 for (iter
= ep_port
; !is_cxl_root(iter
);
2082 iter
= to_cxl_port(iter
->dev
.parent
))
2083 cxl_port_detach_region(iter
, cxlr
, cxled
);
2085 if (cxled
->pos
< 0 || cxled
->pos
>= p
->interleave_ways
||
2086 p
->targets
[cxled
->pos
] != cxled
) {
2087 struct cxl_memdev
*cxlmd
= cxled_to_memdev(cxled
);
2089 dev_WARN_ONCE(&cxlr
->dev
, 1, "expected %s:%s at position %d\n",
2090 dev_name(&cxlmd
->dev
), dev_name(&cxled
->cxld
.dev
),
2095 if (p
->state
== CXL_CONFIG_ACTIVE
) {
2096 p
->state
= CXL_CONFIG_INTERLEAVE_ACTIVE
;
2097 cxl_region_teardown_targets(cxlr
);
2099 p
->targets
[cxled
->pos
] = NULL
;
2101 cxled
->cxld
.hpa_range
= (struct range
) {
2106 /* notify the region driver that one of its targets has departed */
2107 up_write(&cxl_region_rwsem
);
2108 device_release_driver(&cxlr
->dev
);
2109 down_write(&cxl_region_rwsem
);
2111 put_device(&cxlr
->dev
);
2115 void cxl_decoder_kill_region(struct cxl_endpoint_decoder
*cxled
)
2117 down_write(&cxl_region_rwsem
);
2118 cxled
->mode
= CXL_DECODER_DEAD
;
2119 cxl_region_detach(cxled
);
2120 up_write(&cxl_region_rwsem
);
2123 static int attach_target(struct cxl_region
*cxlr
,
2124 struct cxl_endpoint_decoder
*cxled
, int pos
,
2129 if (state
== TASK_INTERRUPTIBLE
)
2130 rc
= down_write_killable(&cxl_region_rwsem
);
2132 down_write(&cxl_region_rwsem
);
2136 down_read(&cxl_dpa_rwsem
);
2137 rc
= cxl_region_attach(cxlr
, cxled
, pos
);
2138 up_read(&cxl_dpa_rwsem
);
2139 up_write(&cxl_region_rwsem
);
2143 static int detach_target(struct cxl_region
*cxlr
, int pos
)
2145 struct cxl_region_params
*p
= &cxlr
->params
;
2148 rc
= down_write_killable(&cxl_region_rwsem
);
2152 if (pos
>= p
->interleave_ways
) {
2153 dev_dbg(&cxlr
->dev
, "position %d out of range %d\n", pos
,
2154 p
->interleave_ways
);
2159 if (!p
->targets
[pos
]) {
2164 rc
= cxl_region_detach(p
->targets
[pos
]);
2166 up_write(&cxl_region_rwsem
);
2170 static size_t store_targetN(struct cxl_region
*cxlr
, const char *buf
, int pos
,
2175 if (sysfs_streq(buf
, "\n"))
2176 rc
= detach_target(cxlr
, pos
);
2180 dev
= bus_find_device_by_name(&cxl_bus_type
, NULL
, buf
);
2184 if (!is_endpoint_decoder(dev
)) {
2189 rc
= attach_target(cxlr
, to_cxl_endpoint_decoder(dev
), pos
,
2190 TASK_INTERRUPTIBLE
);
2200 #define TARGET_ATTR_RW(n) \
2201 static ssize_t target##n##_show( \
2202 struct device *dev, struct device_attribute *attr, char *buf) \
2204 return show_targetN(to_cxl_region(dev), buf, (n)); \
2206 static ssize_t target##n##_store(struct device *dev, \
2207 struct device_attribute *attr, \
2208 const char *buf, size_t len) \
2210 return store_targetN(to_cxl_region(dev), buf, (n), len); \
2212 static DEVICE_ATTR_RW(target##n)
2231 static struct attribute
*target_attrs
[] = {
2232 &dev_attr_target0
.attr
,
2233 &dev_attr_target1
.attr
,
2234 &dev_attr_target2
.attr
,
2235 &dev_attr_target3
.attr
,
2236 &dev_attr_target4
.attr
,
2237 &dev_attr_target5
.attr
,
2238 &dev_attr_target6
.attr
,
2239 &dev_attr_target7
.attr
,
2240 &dev_attr_target8
.attr
,
2241 &dev_attr_target9
.attr
,
2242 &dev_attr_target10
.attr
,
2243 &dev_attr_target11
.attr
,
2244 &dev_attr_target12
.attr
,
2245 &dev_attr_target13
.attr
,
2246 &dev_attr_target14
.attr
,
2247 &dev_attr_target15
.attr
,
2251 static umode_t
cxl_region_target_visible(struct kobject
*kobj
,
2252 struct attribute
*a
, int n
)
2254 struct device
*dev
= kobj_to_dev(kobj
);
2255 struct cxl_region
*cxlr
= to_cxl_region(dev
);
2256 struct cxl_region_params
*p
= &cxlr
->params
;
2258 if (n
< p
->interleave_ways
)
2263 static const struct attribute_group cxl_region_target_group
= {
2264 .attrs
= target_attrs
,
2265 .is_visible
= cxl_region_target_visible
,
2268 static const struct attribute_group
*get_cxl_region_target_group(void)
2270 return &cxl_region_target_group
;
2273 static const struct attribute_group
*region_groups
[] = {
2274 &cxl_base_attribute_group
,
2276 &cxl_region_target_group
,
2277 &cxl_region_access0_coordinate_group
,
2278 &cxl_region_access1_coordinate_group
,
2282 static void cxl_region_release(struct device
*dev
)
2284 struct cxl_root_decoder
*cxlrd
= to_cxl_root_decoder(dev
->parent
);
2285 struct cxl_region
*cxlr
= to_cxl_region(dev
);
2286 int id
= atomic_read(&cxlrd
->region_id
);
2289 * Try to reuse the recently idled id rather than the cached
2290 * next id to prevent the region id space from increasing
2294 if (atomic_try_cmpxchg(&cxlrd
->region_id
, &id
, cxlr
->id
)) {
2299 memregion_free(cxlr
->id
);
2301 put_device(dev
->parent
);
2305 const struct device_type cxl_region_type
= {
2306 .name
= "cxl_region",
2307 .release
= cxl_region_release
,
2308 .groups
= region_groups
2311 bool is_cxl_region(struct device
*dev
)
2313 return dev
->type
== &cxl_region_type
;
2315 EXPORT_SYMBOL_NS_GPL(is_cxl_region
, "CXL");
2317 static struct cxl_region
*to_cxl_region(struct device
*dev
)
2319 if (dev_WARN_ONCE(dev
, dev
->type
!= &cxl_region_type
,
2320 "not a cxl_region device\n"))
2323 return container_of(dev
, struct cxl_region
, dev
);
2326 static void unregister_region(void *_cxlr
)
2328 struct cxl_region
*cxlr
= _cxlr
;
2329 struct cxl_region_params
*p
= &cxlr
->params
;
2332 device_del(&cxlr
->dev
);
2335 * Now that region sysfs is shutdown, the parameter block is now
2336 * read-only, so no need to hold the region rwsem to access the
2337 * region parameters.
2339 for (i
= 0; i
< p
->interleave_ways
; i
++)
2340 detach_target(cxlr
, i
);
2342 cxl_region_iomem_release(cxlr
);
2343 put_device(&cxlr
->dev
);
2346 static struct lock_class_key cxl_region_key
;
2348 static struct cxl_region
*cxl_region_alloc(struct cxl_root_decoder
*cxlrd
, int id
)
2350 struct cxl_region
*cxlr
;
2353 cxlr
= kzalloc(sizeof(*cxlr
), GFP_KERNEL
);
2356 return ERR_PTR(-ENOMEM
);
2360 device_initialize(dev
);
2361 lockdep_set_class(&dev
->mutex
, &cxl_region_key
);
2362 dev
->parent
= &cxlrd
->cxlsd
.cxld
.dev
;
2364 * Keep root decoder pinned through cxl_region_release to fixup
2365 * region id allocations
2367 get_device(dev
->parent
);
2368 device_set_pm_not_required(dev
);
2369 dev
->bus
= &cxl_bus_type
;
2370 dev
->type
= &cxl_region_type
;
2376 static bool cxl_region_update_coordinates(struct cxl_region
*cxlr
, int nid
)
2381 for (int i
= 0; i
< ACCESS_COORDINATE_MAX
; i
++) {
2382 if (cxlr
->coord
[i
].read_bandwidth
) {
2384 if (cxl_need_node_perf_attrs_update(nid
))
2385 node_set_perf_attrs(nid
, &cxlr
->coord
[i
], i
);
2387 rc
= cxl_update_hmat_access_coordinates(nid
, cxlr
, i
);
2397 rc
= sysfs_update_group(&cxlr
->dev
.kobj
, get_cxl_region_access0_group());
2399 dev_dbg(&cxlr
->dev
, "Failed to update access0 group\n");
2401 rc
= sysfs_update_group(&cxlr
->dev
.kobj
, get_cxl_region_access1_group());
2403 dev_dbg(&cxlr
->dev
, "Failed to update access1 group\n");
2408 static int cxl_region_perf_attrs_callback(struct notifier_block
*nb
,
2409 unsigned long action
, void *arg
)
2411 struct cxl_region
*cxlr
= container_of(nb
, struct cxl_region
,
2413 struct memory_notify
*mnb
= arg
;
2414 int nid
= mnb
->status_change_nid
;
2417 if (nid
== NUMA_NO_NODE
|| action
!= MEM_ONLINE
)
2421 * No need to hold cxl_region_rwsem; region parameters are stable
2422 * within the cxl_region driver.
2424 region_nid
= phys_to_target_node(cxlr
->params
.res
->start
);
2425 if (nid
!= region_nid
)
2428 if (!cxl_region_update_coordinates(cxlr
, nid
))
2434 static int cxl_region_calculate_adistance(struct notifier_block
*nb
,
2435 unsigned long nid
, void *data
)
2437 struct cxl_region
*cxlr
= container_of(nb
, struct cxl_region
,
2439 struct access_coordinate
*perf
;
2444 * No need to hold cxl_region_rwsem; region parameters are stable
2445 * within the cxl_region driver.
2447 region_nid
= phys_to_target_node(cxlr
->params
.res
->start
);
2448 if (nid
!= region_nid
)
2451 perf
= &cxlr
->coord
[ACCESS_COORDINATE_CPU
];
2453 if (mt_perf_to_adistance(perf
, adist
))
2460 * devm_cxl_add_region - Adds a region to a decoder
2461 * @cxlrd: root decoder
2462 * @id: memregion id to create, or memregion_free() on failure
2463 * @mode: mode for the endpoint decoders of this region
2464 * @type: select whether this is an expander or accelerator (type-2 or type-3)
2466 * This is the second step of region initialization. Regions exist within an
2467 * address space which is mapped by a @cxlrd.
2469 * Return: 0 if the region was added to the @cxlrd, else returns negative error
2470 * code. The region will be named "regionZ" where Z is the unique region number.
2472 static struct cxl_region
*devm_cxl_add_region(struct cxl_root_decoder
*cxlrd
,
2474 enum cxl_decoder_mode mode
,
2475 enum cxl_decoder_type type
)
2477 struct cxl_port
*port
= to_cxl_port(cxlrd
->cxlsd
.cxld
.dev
.parent
);
2478 struct cxl_region
*cxlr
;
2482 cxlr
= cxl_region_alloc(cxlrd
, id
);
2489 rc
= dev_set_name(dev
, "region%d", id
);
2493 rc
= device_add(dev
);
2497 rc
= devm_add_action_or_reset(port
->uport_dev
, unregister_region
, cxlr
);
2501 dev_dbg(port
->uport_dev
, "%s: created %s\n",
2502 dev_name(&cxlrd
->cxlsd
.cxld
.dev
), dev_name(dev
));
2510 static ssize_t
__create_region_show(struct cxl_root_decoder
*cxlrd
, char *buf
)
2512 return sysfs_emit(buf
, "region%u\n", atomic_read(&cxlrd
->region_id
));
2515 static ssize_t
create_pmem_region_show(struct device
*dev
,
2516 struct device_attribute
*attr
, char *buf
)
2518 return __create_region_show(to_cxl_root_decoder(dev
), buf
);
2521 static ssize_t
create_ram_region_show(struct device
*dev
,
2522 struct device_attribute
*attr
, char *buf
)
2524 return __create_region_show(to_cxl_root_decoder(dev
), buf
);
2527 static struct cxl_region
*__create_region(struct cxl_root_decoder
*cxlrd
,
2528 enum cxl_decoder_mode mode
, int id
)
2533 case CXL_DECODER_RAM
:
2534 case CXL_DECODER_PMEM
:
2537 dev_err(&cxlrd
->cxlsd
.cxld
.dev
, "unsupported mode %d\n", mode
);
2538 return ERR_PTR(-EINVAL
);
2541 rc
= memregion_alloc(GFP_KERNEL
);
2545 if (atomic_cmpxchg(&cxlrd
->region_id
, id
, rc
) != id
) {
2547 return ERR_PTR(-EBUSY
);
2550 return devm_cxl_add_region(cxlrd
, id
, mode
, CXL_DECODER_HOSTONLYMEM
);
2553 static ssize_t
create_region_store(struct device
*dev
, const char *buf
,
2554 size_t len
, enum cxl_decoder_mode mode
)
2556 struct cxl_root_decoder
*cxlrd
= to_cxl_root_decoder(dev
);
2557 struct cxl_region
*cxlr
;
2560 rc
= sscanf(buf
, "region%d\n", &id
);
2564 cxlr
= __create_region(cxlrd
, mode
, id
);
2566 return PTR_ERR(cxlr
);
2571 static ssize_t
create_pmem_region_store(struct device
*dev
,
2572 struct device_attribute
*attr
,
2573 const char *buf
, size_t len
)
2575 return create_region_store(dev
, buf
, len
, CXL_DECODER_PMEM
);
2577 DEVICE_ATTR_RW(create_pmem_region
);
2579 static ssize_t
create_ram_region_store(struct device
*dev
,
2580 struct device_attribute
*attr
,
2581 const char *buf
, size_t len
)
2583 return create_region_store(dev
, buf
, len
, CXL_DECODER_RAM
);
2585 DEVICE_ATTR_RW(create_ram_region
);
2587 static ssize_t
region_show(struct device
*dev
, struct device_attribute
*attr
,
2590 struct cxl_decoder
*cxld
= to_cxl_decoder(dev
);
2593 rc
= down_read_interruptible(&cxl_region_rwsem
);
2598 rc
= sysfs_emit(buf
, "%s\n", dev_name(&cxld
->region
->dev
));
2600 rc
= sysfs_emit(buf
, "\n");
2601 up_read(&cxl_region_rwsem
);
2605 DEVICE_ATTR_RO(region
);
2607 static struct cxl_region
*
2608 cxl_find_region_by_name(struct cxl_root_decoder
*cxlrd
, const char *name
)
2610 struct cxl_decoder
*cxld
= &cxlrd
->cxlsd
.cxld
;
2611 struct device
*region_dev
;
2613 region_dev
= device_find_child_by_name(&cxld
->dev
, name
);
2615 return ERR_PTR(-ENODEV
);
2617 return to_cxl_region(region_dev
);
2620 static ssize_t
delete_region_store(struct device
*dev
,
2621 struct device_attribute
*attr
,
2622 const char *buf
, size_t len
)
2624 struct cxl_root_decoder
*cxlrd
= to_cxl_root_decoder(dev
);
2625 struct cxl_port
*port
= to_cxl_port(dev
->parent
);
2626 struct cxl_region
*cxlr
;
2628 cxlr
= cxl_find_region_by_name(cxlrd
, buf
);
2630 return PTR_ERR(cxlr
);
2632 devm_release_action(port
->uport_dev
, unregister_region
, cxlr
);
2633 put_device(&cxlr
->dev
);
2637 DEVICE_ATTR_WO(delete_region
);
2639 static void cxl_pmem_region_release(struct device
*dev
)
2641 struct cxl_pmem_region
*cxlr_pmem
= to_cxl_pmem_region(dev
);
2644 for (i
= 0; i
< cxlr_pmem
->nr_mappings
; i
++) {
2645 struct cxl_memdev
*cxlmd
= cxlr_pmem
->mapping
[i
].cxlmd
;
2647 put_device(&cxlmd
->dev
);
2653 static const struct attribute_group
*cxl_pmem_region_attribute_groups
[] = {
2654 &cxl_base_attribute_group
,
2658 const struct device_type cxl_pmem_region_type
= {
2659 .name
= "cxl_pmem_region",
2660 .release
= cxl_pmem_region_release
,
2661 .groups
= cxl_pmem_region_attribute_groups
,
2664 bool is_cxl_pmem_region(struct device
*dev
)
2666 return dev
->type
== &cxl_pmem_region_type
;
2668 EXPORT_SYMBOL_NS_GPL(is_cxl_pmem_region
, "CXL");
2670 struct cxl_pmem_region
*to_cxl_pmem_region(struct device
*dev
)
2672 if (dev_WARN_ONCE(dev
, !is_cxl_pmem_region(dev
),
2673 "not a cxl_pmem_region device\n"))
2675 return container_of(dev
, struct cxl_pmem_region
, dev
);
2677 EXPORT_SYMBOL_NS_GPL(to_cxl_pmem_region
, "CXL");
2679 struct cxl_poison_context
{
2680 struct cxl_port
*port
;
2681 enum cxl_decoder_mode mode
;
2685 static int cxl_get_poison_unmapped(struct cxl_memdev
*cxlmd
,
2686 struct cxl_poison_context
*ctx
)
2688 struct cxl_dev_state
*cxlds
= cxlmd
->cxlds
;
2693 * Collect poison for the remaining unmapped resources
2694 * after poison is collected by committed endpoints.
2696 * Knowing that PMEM must always follow RAM, get poison
2697 * for unmapped resources based on the last decoder's mode:
2698 * ram: scan remains of ram range, then any pmem range
2699 * pmem: scan remains of pmem range
2702 if (ctx
->mode
== CXL_DECODER_RAM
) {
2703 offset
= ctx
->offset
;
2704 length
= resource_size(&cxlds
->ram_res
) - offset
;
2705 rc
= cxl_mem_get_poison(cxlmd
, offset
, length
, NULL
);
2711 if (ctx
->mode
== CXL_DECODER_PMEM
) {
2712 offset
= ctx
->offset
;
2713 length
= resource_size(&cxlds
->dpa_res
) - offset
;
2716 } else if (resource_size(&cxlds
->pmem_res
)) {
2717 offset
= cxlds
->pmem_res
.start
;
2718 length
= resource_size(&cxlds
->pmem_res
);
2723 return cxl_mem_get_poison(cxlmd
, offset
, length
, NULL
);
2726 static int poison_by_decoder(struct device
*dev
, void *arg
)
2728 struct cxl_poison_context
*ctx
= arg
;
2729 struct cxl_endpoint_decoder
*cxled
;
2730 struct cxl_memdev
*cxlmd
;
2734 if (!is_endpoint_decoder(dev
))
2737 cxled
= to_cxl_endpoint_decoder(dev
);
2738 if (!cxled
->dpa_res
|| !resource_size(cxled
->dpa_res
))
2742 * Regions are only created with single mode decoders: pmem or ram.
2743 * Linux does not support mixed mode decoders. This means that
2744 * reading poison per endpoint decoder adheres to the requirement
2745 * that poison reads of pmem and ram must be separated.
2746 * CXL 3.0 Spec 8.2.9.8.4.1
2748 if (cxled
->mode
== CXL_DECODER_MIXED
) {
2749 dev_dbg(dev
, "poison list read unsupported in mixed mode\n");
2753 cxlmd
= cxled_to_memdev(cxled
);
2755 offset
= cxled
->dpa_res
->start
- cxled
->skip
;
2756 length
= cxled
->skip
;
2757 rc
= cxl_mem_get_poison(cxlmd
, offset
, length
, NULL
);
2758 if (rc
== -EFAULT
&& cxled
->mode
== CXL_DECODER_RAM
)
2764 offset
= cxled
->dpa_res
->start
;
2765 length
= cxled
->dpa_res
->end
- offset
+ 1;
2766 rc
= cxl_mem_get_poison(cxlmd
, offset
, length
, cxled
->cxld
.region
);
2767 if (rc
== -EFAULT
&& cxled
->mode
== CXL_DECODER_RAM
)
2772 /* Iterate until commit_end is reached */
2773 if (cxled
->cxld
.id
== ctx
->port
->commit_end
) {
2774 ctx
->offset
= cxled
->dpa_res
->end
+ 1;
2775 ctx
->mode
= cxled
->mode
;
2782 int cxl_get_poison_by_endpoint(struct cxl_port
*port
)
2784 struct cxl_poison_context ctx
;
2787 ctx
= (struct cxl_poison_context
) {
2791 rc
= device_for_each_child(&port
->dev
, &ctx
, poison_by_decoder
);
2793 rc
= cxl_get_poison_unmapped(to_cxl_memdev(port
->uport_dev
),
2799 struct cxl_dpa_to_region_context
{
2800 struct cxl_region
*cxlr
;
2804 static int __cxl_dpa_to_region(struct device
*dev
, void *arg
)
2806 struct cxl_dpa_to_region_context
*ctx
= arg
;
2807 struct cxl_endpoint_decoder
*cxled
;
2808 struct cxl_region
*cxlr
;
2811 if (!is_endpoint_decoder(dev
))
2814 cxled
= to_cxl_endpoint_decoder(dev
);
2815 if (!cxled
|| !cxled
->dpa_res
|| !resource_size(cxled
->dpa_res
))
2818 if (dpa
> cxled
->dpa_res
->end
|| dpa
< cxled
->dpa_res
->start
)
2822 * Stop the region search (return 1) when an endpoint mapping is
2823 * found. The region may not be fully constructed so offering
2824 * the cxlr in the context structure is not guaranteed.
2826 cxlr
= cxled
->cxld
.region
;
2828 dev_dbg(dev
, "dpa:0x%llx mapped in region:%s\n", dpa
,
2829 dev_name(&cxlr
->dev
));
2831 dev_dbg(dev
, "dpa:0x%llx mapped in endpoint:%s\n", dpa
,
2839 struct cxl_region
*cxl_dpa_to_region(const struct cxl_memdev
*cxlmd
, u64 dpa
)
2841 struct cxl_dpa_to_region_context ctx
;
2842 struct cxl_port
*port
;
2844 ctx
= (struct cxl_dpa_to_region_context
) {
2847 port
= cxlmd
->endpoint
;
2848 if (port
&& is_cxl_endpoint(port
) && cxl_num_decoders_committed(port
))
2849 device_for_each_child(&port
->dev
, &ctx
, __cxl_dpa_to_region
);
2854 static bool cxl_is_hpa_in_chunk(u64 hpa
, struct cxl_region
*cxlr
, int pos
)
2856 struct cxl_region_params
*p
= &cxlr
->params
;
2857 int gran
= p
->interleave_granularity
;
2858 int ways
= p
->interleave_ways
;
2861 /* Is the hpa in an expected chunk for its pos(-ition) */
2862 offset
= hpa
- p
->res
->start
;
2863 offset
= do_div(offset
, gran
* ways
);
2864 if ((offset
>= pos
* gran
) && (offset
< (pos
+ 1) * gran
))
2868 "Addr trans fail: hpa 0x%llx not in expected chunk\n", hpa
);
2873 u64
cxl_dpa_to_hpa(struct cxl_region
*cxlr
, const struct cxl_memdev
*cxlmd
,
2876 struct cxl_root_decoder
*cxlrd
= to_cxl_root_decoder(cxlr
->dev
.parent
);
2877 u64 dpa_offset
, hpa_offset
, bits_upper
, mask_upper
, hpa
;
2878 struct cxl_region_params
*p
= &cxlr
->params
;
2879 struct cxl_endpoint_decoder
*cxled
= NULL
;
2884 for (int i
= 0; i
< p
->nr_targets
; i
++) {
2885 cxled
= p
->targets
[i
];
2886 if (cxlmd
== cxled_to_memdev(cxled
))
2889 if (!cxled
|| cxlmd
!= cxled_to_memdev(cxled
))
2893 ways_to_eiw(p
->interleave_ways
, &eiw
);
2894 granularity_to_eig(p
->interleave_granularity
, &eig
);
2897 * The device position in the region interleave set was removed
2898 * from the offset at HPA->DPA translation. To reconstruct the
2899 * HPA, place the 'pos' in the offset.
2901 * The placement of 'pos' in the HPA is determined by interleave
2902 * ways and granularity and is defined in the CXL Spec 3.0 Section
2903 * 8.2.4.19.13 Implementation Note: Device Decode Logic
2906 /* Remove the dpa base */
2907 dpa_offset
= dpa
- cxl_dpa_resource_start(cxled
);
2909 mask_upper
= GENMASK_ULL(51, eig
+ 8);
2912 hpa_offset
= (dpa_offset
& mask_upper
) << eiw
;
2913 hpa_offset
|= pos
<< (eig
+ 8);
2915 bits_upper
= (dpa_offset
& mask_upper
) >> (eig
+ 8);
2916 bits_upper
= bits_upper
* 3;
2917 hpa_offset
= ((bits_upper
<< (eiw
- 8)) + pos
) << (eig
+ 8);
2920 /* The lower bits remain unchanged */
2921 hpa_offset
|= dpa_offset
& GENMASK_ULL(eig
+ 7, 0);
2923 /* Apply the hpa_offset to the region base address */
2924 hpa
= hpa_offset
+ p
->res
->start
;
2926 /* Root decoder translation overrides typical modulo decode */
2927 if (cxlrd
->hpa_to_spa
)
2928 hpa
= cxlrd
->hpa_to_spa(cxlrd
, hpa
);
2930 if (hpa
< p
->res
->start
|| hpa
> p
->res
->end
) {
2932 "Addr trans fail: hpa 0x%llx not in region\n", hpa
);
2936 /* Simple chunk check, by pos & gran, only applies to modulo decodes */
2937 if (!cxlrd
->hpa_to_spa
&& (!cxl_is_hpa_in_chunk(hpa
, cxlr
, pos
)))
2943 static struct lock_class_key cxl_pmem_region_key
;
2945 static int cxl_pmem_region_alloc(struct cxl_region
*cxlr
)
2947 struct cxl_region_params
*p
= &cxlr
->params
;
2948 struct cxl_nvdimm_bridge
*cxl_nvb
;
2952 guard(rwsem_read
)(&cxl_region_rwsem
);
2953 if (p
->state
!= CXL_CONFIG_COMMIT
)
2956 struct cxl_pmem_region
*cxlr_pmem
__free(kfree
) =
2957 kzalloc(struct_size(cxlr_pmem
, mapping
, p
->nr_targets
), GFP_KERNEL
);
2961 cxlr_pmem
->hpa_range
.start
= p
->res
->start
;
2962 cxlr_pmem
->hpa_range
.end
= p
->res
->end
;
2964 /* Snapshot the region configuration underneath the cxl_region_rwsem */
2965 cxlr_pmem
->nr_mappings
= p
->nr_targets
;
2966 for (i
= 0; i
< p
->nr_targets
; i
++) {
2967 struct cxl_endpoint_decoder
*cxled
= p
->targets
[i
];
2968 struct cxl_memdev
*cxlmd
= cxled_to_memdev(cxled
);
2969 struct cxl_pmem_region_mapping
*m
= &cxlr_pmem
->mapping
[i
];
2972 * Regions never span CXL root devices, so by definition the
2973 * bridge for one device is the same for all.
2976 cxl_nvb
= cxl_find_nvdimm_bridge(cxlmd
->endpoint
);
2979 cxlr
->cxl_nvb
= cxl_nvb
;
2982 get_device(&cxlmd
->dev
);
2983 m
->start
= cxled
->dpa_res
->start
;
2984 m
->size
= resource_size(cxled
->dpa_res
);
2988 dev
= &cxlr_pmem
->dev
;
2989 device_initialize(dev
);
2990 lockdep_set_class(&dev
->mutex
, &cxl_pmem_region_key
);
2991 device_set_pm_not_required(dev
);
2992 dev
->parent
= &cxlr
->dev
;
2993 dev
->bus
= &cxl_bus_type
;
2994 dev
->type
= &cxl_pmem_region_type
;
2995 cxlr_pmem
->cxlr
= cxlr
;
2996 cxlr
->cxlr_pmem
= no_free_ptr(cxlr_pmem
);
3001 static void cxl_dax_region_release(struct device
*dev
)
3003 struct cxl_dax_region
*cxlr_dax
= to_cxl_dax_region(dev
);
3008 static const struct attribute_group
*cxl_dax_region_attribute_groups
[] = {
3009 &cxl_base_attribute_group
,
3013 const struct device_type cxl_dax_region_type
= {
3014 .name
= "cxl_dax_region",
3015 .release
= cxl_dax_region_release
,
3016 .groups
= cxl_dax_region_attribute_groups
,
3019 static bool is_cxl_dax_region(struct device
*dev
)
3021 return dev
->type
== &cxl_dax_region_type
;
3024 struct cxl_dax_region
*to_cxl_dax_region(struct device
*dev
)
3026 if (dev_WARN_ONCE(dev
, !is_cxl_dax_region(dev
),
3027 "not a cxl_dax_region device\n"))
3029 return container_of(dev
, struct cxl_dax_region
, dev
);
3031 EXPORT_SYMBOL_NS_GPL(to_cxl_dax_region
, "CXL");
3033 static struct lock_class_key cxl_dax_region_key
;
3035 static struct cxl_dax_region
*cxl_dax_region_alloc(struct cxl_region
*cxlr
)
3037 struct cxl_region_params
*p
= &cxlr
->params
;
3038 struct cxl_dax_region
*cxlr_dax
;
3041 down_read(&cxl_region_rwsem
);
3042 if (p
->state
!= CXL_CONFIG_COMMIT
) {
3043 cxlr_dax
= ERR_PTR(-ENXIO
);
3047 cxlr_dax
= kzalloc(sizeof(*cxlr_dax
), GFP_KERNEL
);
3049 cxlr_dax
= ERR_PTR(-ENOMEM
);
3053 cxlr_dax
->hpa_range
.start
= p
->res
->start
;
3054 cxlr_dax
->hpa_range
.end
= p
->res
->end
;
3056 dev
= &cxlr_dax
->dev
;
3057 cxlr_dax
->cxlr
= cxlr
;
3058 device_initialize(dev
);
3059 lockdep_set_class(&dev
->mutex
, &cxl_dax_region_key
);
3060 device_set_pm_not_required(dev
);
3061 dev
->parent
= &cxlr
->dev
;
3062 dev
->bus
= &cxl_bus_type
;
3063 dev
->type
= &cxl_dax_region_type
;
3065 up_read(&cxl_region_rwsem
);
3070 static void cxlr_pmem_unregister(void *_cxlr_pmem
)
3072 struct cxl_pmem_region
*cxlr_pmem
= _cxlr_pmem
;
3073 struct cxl_region
*cxlr
= cxlr_pmem
->cxlr
;
3074 struct cxl_nvdimm_bridge
*cxl_nvb
= cxlr
->cxl_nvb
;
3077 * Either the bridge is in ->remove() context under the device_lock(),
3078 * or cxlr_release_nvdimm() is cancelling the bridge's release action
3079 * for @cxlr_pmem and doing it itself (while manually holding the bridge
3082 device_lock_assert(&cxl_nvb
->dev
);
3083 cxlr
->cxlr_pmem
= NULL
;
3084 cxlr_pmem
->cxlr
= NULL
;
3085 device_unregister(&cxlr_pmem
->dev
);
3088 static void cxlr_release_nvdimm(void *_cxlr
)
3090 struct cxl_region
*cxlr
= _cxlr
;
3091 struct cxl_nvdimm_bridge
*cxl_nvb
= cxlr
->cxl_nvb
;
3093 scoped_guard(device
, &cxl_nvb
->dev
) {
3094 if (cxlr
->cxlr_pmem
)
3095 devm_release_action(&cxl_nvb
->dev
, cxlr_pmem_unregister
,
3098 cxlr
->cxl_nvb
= NULL
;
3099 put_device(&cxl_nvb
->dev
);
3103 * devm_cxl_add_pmem_region() - add a cxl_region-to-nd_region bridge
3104 * @cxlr: parent CXL region for this pmem region bridge device
3106 * Return: 0 on success negative error code on failure.
3108 static int devm_cxl_add_pmem_region(struct cxl_region
*cxlr
)
3110 struct cxl_pmem_region
*cxlr_pmem
;
3111 struct cxl_nvdimm_bridge
*cxl_nvb
;
3115 rc
= cxl_pmem_region_alloc(cxlr
);
3118 cxlr_pmem
= cxlr
->cxlr_pmem
;
3119 cxl_nvb
= cxlr
->cxl_nvb
;
3121 dev
= &cxlr_pmem
->dev
;
3122 rc
= dev_set_name(dev
, "pmem_region%d", cxlr
->id
);
3126 rc
= device_add(dev
);
3130 dev_dbg(&cxlr
->dev
, "%s: register %s\n", dev_name(dev
->parent
),
3133 scoped_guard(device
, &cxl_nvb
->dev
) {
3134 if (cxl_nvb
->dev
.driver
)
3135 rc
= devm_add_action_or_reset(&cxl_nvb
->dev
,
3136 cxlr_pmem_unregister
,
3145 /* @cxlr carries a reference on @cxl_nvb until cxlr_release_nvdimm */
3146 return devm_add_action_or_reset(&cxlr
->dev
, cxlr_release_nvdimm
, cxlr
);
3151 put_device(&cxl_nvb
->dev
);
3152 cxlr
->cxl_nvb
= NULL
;
3156 static void cxlr_dax_unregister(void *_cxlr_dax
)
3158 struct cxl_dax_region
*cxlr_dax
= _cxlr_dax
;
3160 device_unregister(&cxlr_dax
->dev
);
3163 static int devm_cxl_add_dax_region(struct cxl_region
*cxlr
)
3165 struct cxl_dax_region
*cxlr_dax
;
3169 cxlr_dax
= cxl_dax_region_alloc(cxlr
);
3170 if (IS_ERR(cxlr_dax
))
3171 return PTR_ERR(cxlr_dax
);
3173 dev
= &cxlr_dax
->dev
;
3174 rc
= dev_set_name(dev
, "dax_region%d", cxlr
->id
);
3178 rc
= device_add(dev
);
3182 dev_dbg(&cxlr
->dev
, "%s: register %s\n", dev_name(dev
->parent
),
3185 return devm_add_action_or_reset(&cxlr
->dev
, cxlr_dax_unregister
,
3192 static int match_root_decoder_by_range(struct device
*dev
,
3195 const struct range
*r1
, *r2
= data
;
3196 struct cxl_root_decoder
*cxlrd
;
3198 if (!is_root_decoder(dev
))
3201 cxlrd
= to_cxl_root_decoder(dev
);
3202 r1
= &cxlrd
->cxlsd
.cxld
.hpa_range
;
3203 return range_contains(r1
, r2
);
3206 static int match_region_by_range(struct device
*dev
, const void *data
)
3208 struct cxl_region_params
*p
;
3209 struct cxl_region
*cxlr
;
3210 const struct range
*r
= data
;
3213 if (!is_cxl_region(dev
))
3216 cxlr
= to_cxl_region(dev
);
3219 down_read(&cxl_region_rwsem
);
3220 if (p
->res
&& p
->res
->start
== r
->start
&& p
->res
->end
== r
->end
)
3222 up_read(&cxl_region_rwsem
);
3227 /* Establish an empty region covering the given HPA range */
3228 static struct cxl_region
*construct_region(struct cxl_root_decoder
*cxlrd
,
3229 struct cxl_endpoint_decoder
*cxled
)
3231 struct cxl_memdev
*cxlmd
= cxled_to_memdev(cxled
);
3232 struct cxl_port
*port
= cxlrd_to_port(cxlrd
);
3233 struct range
*hpa
= &cxled
->cxld
.hpa_range
;
3234 struct cxl_region_params
*p
;
3235 struct cxl_region
*cxlr
;
3236 struct resource
*res
;
3240 cxlr
= __create_region(cxlrd
, cxled
->mode
,
3241 atomic_read(&cxlrd
->region_id
));
3242 } while (IS_ERR(cxlr
) && PTR_ERR(cxlr
) == -EBUSY
);
3245 dev_err(cxlmd
->dev
.parent
,
3246 "%s:%s: %s failed assign region: %ld\n",
3247 dev_name(&cxlmd
->dev
), dev_name(&cxled
->cxld
.dev
),
3248 __func__
, PTR_ERR(cxlr
));
3252 down_write(&cxl_region_rwsem
);
3254 if (p
->state
>= CXL_CONFIG_INTERLEAVE_ACTIVE
) {
3255 dev_err(cxlmd
->dev
.parent
,
3256 "%s:%s: %s autodiscovery interrupted\n",
3257 dev_name(&cxlmd
->dev
), dev_name(&cxled
->cxld
.dev
),
3263 set_bit(CXL_REGION_F_AUTO
, &cxlr
->flags
);
3265 res
= kmalloc(sizeof(*res
), GFP_KERNEL
);
3271 *res
= DEFINE_RES_MEM_NAMED(hpa
->start
, range_len(hpa
),
3272 dev_name(&cxlr
->dev
));
3273 rc
= insert_resource(cxlrd
->res
, res
);
3276 * Platform-firmware may not have split resources like "System
3277 * RAM" on CXL window boundaries see cxl_region_iomem_release()
3279 dev_warn(cxlmd
->dev
.parent
,
3280 "%s:%s: %s %s cannot insert resource\n",
3281 dev_name(&cxlmd
->dev
), dev_name(&cxled
->cxld
.dev
),
3282 __func__
, dev_name(&cxlr
->dev
));
3286 p
->interleave_ways
= cxled
->cxld
.interleave_ways
;
3287 p
->interleave_granularity
= cxled
->cxld
.interleave_granularity
;
3288 p
->state
= CXL_CONFIG_INTERLEAVE_ACTIVE
;
3290 rc
= sysfs_update_group(&cxlr
->dev
.kobj
, get_cxl_region_target_group());
3294 dev_dbg(cxlmd
->dev
.parent
, "%s:%s: %s %s res: %pr iw: %d ig: %d\n",
3295 dev_name(&cxlmd
->dev
), dev_name(&cxled
->cxld
.dev
), __func__
,
3296 dev_name(&cxlr
->dev
), p
->res
, p
->interleave_ways
,
3297 p
->interleave_granularity
);
3299 /* ...to match put_device() in cxl_add_to_region() */
3300 get_device(&cxlr
->dev
);
3301 up_write(&cxl_region_rwsem
);
3306 up_write(&cxl_region_rwsem
);
3307 devm_release_action(port
->uport_dev
, unregister_region
, cxlr
);
3311 int cxl_add_to_region(struct cxl_port
*root
, struct cxl_endpoint_decoder
*cxled
)
3313 struct cxl_memdev
*cxlmd
= cxled_to_memdev(cxled
);
3314 struct range
*hpa
= &cxled
->cxld
.hpa_range
;
3315 struct cxl_decoder
*cxld
= &cxled
->cxld
;
3316 struct device
*cxlrd_dev
, *region_dev
;
3317 struct cxl_root_decoder
*cxlrd
;
3318 struct cxl_region_params
*p
;
3319 struct cxl_region
*cxlr
;
3320 bool attach
= false;
3323 cxlrd_dev
= device_find_child(&root
->dev
, &cxld
->hpa_range
,
3324 match_root_decoder_by_range
);
3326 dev_err(cxlmd
->dev
.parent
,
3327 "%s:%s no CXL window for range %#llx:%#llx\n",
3328 dev_name(&cxlmd
->dev
), dev_name(&cxld
->dev
),
3329 cxld
->hpa_range
.start
, cxld
->hpa_range
.end
);
3333 cxlrd
= to_cxl_root_decoder(cxlrd_dev
);
3336 * Ensure that if multiple threads race to construct_region() for @hpa
3337 * one does the construction and the others add to that.
3339 mutex_lock(&cxlrd
->range_lock
);
3340 region_dev
= device_find_child(&cxlrd
->cxlsd
.cxld
.dev
, hpa
,
3341 match_region_by_range
);
3343 cxlr
= construct_region(cxlrd
, cxled
);
3344 region_dev
= &cxlr
->dev
;
3346 cxlr
= to_cxl_region(region_dev
);
3347 mutex_unlock(&cxlrd
->range_lock
);
3349 rc
= PTR_ERR_OR_ZERO(cxlr
);
3353 attach_target(cxlr
, cxled
, -1, TASK_UNINTERRUPTIBLE
);
3355 down_read(&cxl_region_rwsem
);
3357 attach
= p
->state
== CXL_CONFIG_COMMIT
;
3358 up_read(&cxl_region_rwsem
);
3362 * If device_attach() fails the range may still be active via
3363 * the platform-firmware memory map, otherwise the driver for
3364 * regions is local to this file, so driver matching can't fail.
3366 if (device_attach(&cxlr
->dev
) < 0)
3367 dev_err(&cxlr
->dev
, "failed to enable, range: %pr\n",
3371 put_device(region_dev
);
3373 put_device(cxlrd_dev
);
3376 EXPORT_SYMBOL_NS_GPL(cxl_add_to_region
, "CXL");
3378 static int is_system_ram(struct resource
*res
, void *arg
)
3380 struct cxl_region
*cxlr
= arg
;
3381 struct cxl_region_params
*p
= &cxlr
->params
;
3383 dev_dbg(&cxlr
->dev
, "%pr has System RAM: %pr\n", p
->res
, res
);
3387 static void shutdown_notifiers(void *_cxlr
)
3389 struct cxl_region
*cxlr
= _cxlr
;
3391 unregister_memory_notifier(&cxlr
->memory_notifier
);
3392 unregister_mt_adistance_algorithm(&cxlr
->adist_notifier
);
3395 static int cxl_region_probe(struct device
*dev
)
3397 struct cxl_region
*cxlr
= to_cxl_region(dev
);
3398 struct cxl_region_params
*p
= &cxlr
->params
;
3401 rc
= down_read_interruptible(&cxl_region_rwsem
);
3403 dev_dbg(&cxlr
->dev
, "probe interrupted\n");
3407 if (p
->state
< CXL_CONFIG_COMMIT
) {
3408 dev_dbg(&cxlr
->dev
, "config state: %d\n", p
->state
);
3413 if (test_bit(CXL_REGION_F_NEEDS_RESET
, &cxlr
->flags
)) {
3415 "failed to activate, re-commit region and retry\n");
3421 * From this point on any path that changes the region's state away from
3422 * CXL_CONFIG_COMMIT is also responsible for releasing the driver.
3425 up_read(&cxl_region_rwsem
);
3430 cxlr
->memory_notifier
.notifier_call
= cxl_region_perf_attrs_callback
;
3431 cxlr
->memory_notifier
.priority
= CXL_CALLBACK_PRI
;
3432 register_memory_notifier(&cxlr
->memory_notifier
);
3434 cxlr
->adist_notifier
.notifier_call
= cxl_region_calculate_adistance
;
3435 cxlr
->adist_notifier
.priority
= 100;
3436 register_mt_adistance_algorithm(&cxlr
->adist_notifier
);
3438 rc
= devm_add_action_or_reset(&cxlr
->dev
, shutdown_notifiers
, cxlr
);
3442 switch (cxlr
->mode
) {
3443 case CXL_DECODER_PMEM
:
3444 return devm_cxl_add_pmem_region(cxlr
);
3445 case CXL_DECODER_RAM
:
3447 * The region can not be manged by CXL if any portion of
3448 * it is already online as 'System RAM'
3450 if (walk_iomem_res_desc(IORES_DESC_NONE
,
3451 IORESOURCE_SYSTEM_RAM
| IORESOURCE_BUSY
,
3452 p
->res
->start
, p
->res
->end
, cxlr
,
3455 return devm_cxl_add_dax_region(cxlr
);
3457 dev_dbg(&cxlr
->dev
, "unsupported region mode: %d\n",
3463 static struct cxl_driver cxl_region_driver
= {
3464 .name
= "cxl_region",
3465 .probe
= cxl_region_probe
,
3466 .id
= CXL_DEVICE_REGION
,
3469 int cxl_region_init(void)
3471 return cxl_driver_register(&cxl_region_driver
);
3474 void cxl_region_exit(void)
3476 cxl_driver_unregister(&cxl_region_driver
);
3479 MODULE_IMPORT_NS("CXL");
3480 MODULE_IMPORT_NS("DEVMEM");
3481 MODULE_ALIAS_CXL(CXL_DEVICE_REGION
);