"master-id-bits" property added to the IOMMU device node. This property can
be used by the IOMMU driver to match relevan bits in the master id expressed
by a DMA master.
This can be used to mask out certain bits that get added to the device master id
due to IOMMU topology. For example, in case of MMU-500 the TBUID gets appended
to
the master id. This prevents sharing of a stream ID, amongst devices which are
connected to different TBUs.
Signed-off-by: Varun Sethi <varun.se...@freescale.com>
---
Documentation/devicetree/bindings/iommu/iommu.txt | 29 +++++++++++++++++++++
1 file changed, 29 insertions(+)
diff --git a/Documentation/devicetree/bindings/iommu/iommu.txt
b/Documentation/devicetree/bindings/iommu/iommu.txt
index 5a8b462..f7c8623 100644
--- a/Documentation/devicetree/bindings/iommu/iommu.txt
+++ b/Documentation/devicetree/bindings/iommu/iommu.txt
@@ -63,6 +63,23 @@ Note that these are merely examples and real-world use-cases
may use different
definitions to represent their individual needs. Always refer to the specific
IOMMU binding for the exact meaning of the cells that make up the specifier.
+Optional properties:
+--------------------
+- master-id-bits: This specifies number of master id bits used by the iommu, to
+ match master id expressed by the DMA master device. This would be typically
used
+ in cases where we need DMA memory isolation between multiple masters. Each
master
+ would specify a master id associated with a DMA trasaction.
+
+ The IOMMU driver can use this property to generate a mask to match only
relevant
+ bits in the master id. This can be used for masking out certain bits that get
+ added to the master id as a part of the IOMMU topology.
+
+ For example, in case of MMU-500 the TBU identifier is also appended to the
master id.
+ This posese issues for software implementations requiring dynamic master id
allocation
+ for supporting hot pluggable devices. It's possible to have a device group,
with
+ devices connected to different TBUs. Without masking the additional TBU ID
bits, we
+ can't share the master id across all devices in the device group.
+
IOMMU master node:
==================
@@ -147,6 +164,12 @@ Multiple-master IOMMU:
iommu {
/* the specifier represents the ID of the master */
#iommu-cells = <1>;
+
+ /*
+ * This specifies number of master id bits used by
+ * the iommu for matching the master id.
+ */
+ master-id-bits = <7>
};
master@1 {
@@ -173,6 +196,12 @@ Multiple-master IOMMU with configurable DMA window:
* master (i.e. the I/O virtual address space).
*/
#iommu-cells = <4>;
+
+ /*
+ * This specifies number of master id bits used by
+ * the iommu for matching the master id.
+ */
+ master-id-bits = <7>
};
master {
--
1.7.9.5
_______________________________________________
iommu mailing list
iommu@lists.linux-foundation.org
https://lists.linuxfoundation.org/mailman/listinfo/iommu
