Thread (68 messages) 68 messages, 4 authors, 2026-01-23
STALE156d

[RFC PATCH v4 09/38] NTB: core: Add mw_set_trans_ranges() for subrange programming

From: Koichiro Den <hidden>
Date: 2026-01-18 13:55:12
Also in: dmaengine, linux-devicetree, linux-doc, linux-iommu, linux-kselftest, linux-pci, linux-renesas-soc, lkml
Subsystem: ntb driver core, the rest · Maintainers: Jon Mason, Dave Jiang, Allen Hubbe, Linus Torvalds

At the BAR level, multiple MWs may be packed into a single BAR. In
addition, a single MW may itself be subdivided into multiple address
subranges, each of which can be mapped independently by the underlying
NTB hardware.

Introduce an optional ntb_dev_ops callback, .mw_set_trans_ranges(), to
describe and program such layouts explicitly. The helper allows an NTB
driver to provide, for each MW, a list of contiguous subranges that
together cover the MW address space.

Signed-off-by: Koichiro Den <redacted>
---
 include/linux/ntb.h | 46 +++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 46 insertions(+)
diff --git a/include/linux/ntb.h b/include/linux/ntb.h
index 8ff9d663096b..84908753f446 100644
--- a/include/linux/ntb.h
+++ b/include/linux/ntb.h
@@ -206,6 +206,11 @@ static inline int ntb_ctx_ops_is_valid(const struct ntb_ctx_ops *ops)
 		1;
 }
 
+struct ntb_mw_subrange {
+	dma_addr_t	addr;
+	resource_size_t	size;
+};
+
 /**
  * struct ntb_dev_ops - ntb device operations
  * @port_number:	See ntb_port_number().
@@ -218,6 +223,7 @@ static inline int ntb_ctx_ops_is_valid(const struct ntb_ctx_ops *ops)
  * @mw_count:		See ntb_mw_count().
  * @mw_get_align:	See ntb_mw_get_align().
  * @mw_set_trans:	See ntb_mw_set_trans().
+ * @mw_set_trans_ranges:See ntb_mw_set_trans_ranges().
  * @mw_clear_trans:	See ntb_mw_clear_trans().
  * @peer_mw_count:	See ntb_peer_mw_count().
  * @peer_mw_get_addr:	See ntb_peer_mw_get_addr().
@@ -276,6 +282,9 @@ struct ntb_dev_ops {
 			    resource_size_t *size_max);
 	int (*mw_set_trans)(struct ntb_dev *ntb, int pidx, int widx,
 			    dma_addr_t addr, resource_size_t size);
+	int (*mw_set_trans_ranges)(struct ntb_dev *ntb, int pidx, int widx,
+				   unsigned int num_ranges,
+				   const struct ntb_mw_subrange *ranges);
 	int (*mw_clear_trans)(struct ntb_dev *ntb, int pidx, int widx);
 	int (*peer_mw_count)(struct ntb_dev *ntb);
 	int (*peer_mw_get_addr)(struct ntb_dev *ntb, int widx,
@@ -350,6 +359,7 @@ static inline int ntb_dev_ops_is_valid(const struct ntb_dev_ops *ops)
 		ops->mw_get_align			&&
 		(ops->mw_set_trans			||
 		 ops->peer_mw_set_trans)		&&
+		/* ops->mw_set_trans_ranges		&& */
 		/* ops->mw_clear_trans			&& */
 		ops->peer_mw_count			&&
 		ops->peer_mw_get_addr			&&
@@ -860,6 +870,42 @@ static inline int ntb_mw_set_trans(struct ntb_dev *ntb, int pidx, int widx,
 	return ntb->ops->mw_set_trans(ntb, pidx, widx, addr, size);
 }
 
+/**
+ * ntb_mw_set_trans_ranges() - set the translations of an inbound memory
+ *                             window, composed of multiple subranges.
+ * @ntb:	NTB device context.
+ * @pidx:	Port index of peer device.
+ * @widx:	Memory window index.
+ * @num_ranges:	The number of ranges described by @ranges array.
+ * @ranges:	Array of subranges. The subranges are interpreted in ascending
+ *		window offset order (i.e. ranges[0] maps the first part of the MW,
+ *		ranges[1] the next part, ...).
+ *
+ * Return: Zero on success, otherwise an error number. If the driver does
+ *         not implement the callback, return -EOPNOTSUPP.
+ */
+static inline int ntb_mw_set_trans_ranges(struct ntb_dev *ntb, int pidx, int widx,
+					  unsigned int num_ranges,
+					  const struct ntb_mw_subrange *ranges)
+{
+	if (!num_ranges || !ranges)
+		return -EINVAL;
+
+	if (ntb->ops->mw_set_trans_ranges)
+		return ntb->ops->mw_set_trans_ranges(ntb, pidx, widx,
+						     num_ranges, ranges);
+
+	/*
+	 * Fallback for drivers that only support the legacy single-range
+	 * translation API.
+	 */
+	if (num_ranges == 1)
+		return ntb_mw_set_trans(ntb, pidx, widx,
+					ranges[0].addr, ranges[0].size);
+
+	return -EOPNOTSUPP;
+}
+
 /**
  * ntb_mw_clear_trans() - clear the translation address of an inbound memory
  *                        window
-- 
2.51.0
Keyboard shortcuts
hback out one level
jnext message in thread
kprevious message in thread
ldrill in
Escclose help / fold thread tree
?toggle this help