Message ID | 20220923123557.866972-2-thierry.reding@gmail.com |
---|---|
State | Changes Requested |
Headers | show |
Series | iommu: Support mappings/reservations in reserved-memory regions | expand |
On 2022-09-23 13:35, Thierry Reding wrote: > From: Thierry Reding <treding@nvidia.com> > > This adds the "iommu-addresses" property to reserved-memory nodes, which > allow describing the interaction of memory regions with IOMMUs. Two use- > cases are supported: > > 1. Static mappings can be described by pairing the "iommu-addresses" > property with a "reg" property. This is mostly useful for adopting > firmware-allocated buffers via identity mappings. One common use- > case where this is required is if early firmware or bootloaders > have set up a bootsplash framebuffer that a display controller is > actively scanning out from during the operating system boot > process. > > 2. If an "iommu-addresses" property exists without a "reg" property, > the reserved-memory node describes an IOVA reservation. Such memory > regions are excluded from the IOVA space available to operating > system drivers and can be used for regions that must not be used to > map arbitrary buffers. Bah, I've only just realised: don't we also need to change the "oneOf: required: ..." schema to permit "iommu-addresses" without "reg" or "size"? Thanks, Robin. > Each mapping or reservation is tied to a specific device via a phandle > to the device's device tree node. This allows a reserved-memory region > to be reused across multiple devices. > > Reviewed-by: Rob Herring <robh@kernel.org> > Reviewed-by: Robin Murphy <robin.murphy@arm.com> > Signed-off-by: Thierry Reding <treding@nvidia.com> > --- > Changes in v9: > - add Reviewed-by tags > > Changes in v8: > - include validation warnings that had crept into an unrelated patch > > Changes in v7: > - keep reserved-memory.txt to avoid broken references > > Changes in v6: > - add device phandle to iommu-addresses property in examples > - remove now unused dt-bindings/reserved-memory.h header > > .../reserved-memory/reserved-memory.yaml | 70 +++++++++++++++++++ > 1 file changed, 70 insertions(+) > > diff --git a/Documentation/devicetree/bindings/reserved-memory/reserved-memory.yaml b/Documentation/devicetree/bindings/reserved-memory/reserved-memory.yaml > index 44f72bcf1782..fb48d016e368 100644 > --- a/Documentation/devicetree/bindings/reserved-memory/reserved-memory.yaml > +++ b/Documentation/devicetree/bindings/reserved-memory/reserved-memory.yaml > @@ -52,6 +52,30 @@ properties: > Address and Length pairs. Specifies regions of memory that are > acceptable to allocate from. > > + iommu-addresses: > + $ref: /schemas/types.yaml#/definitions/phandle-array > + description: > > + A list of phandle and specifier pairs that describe static IO virtual > + address space mappings and carveouts associated with a given reserved > + memory region. The phandle in the first cell refers to the device for > + which the mapping or carveout is to be created. > + > + The specifier consists of an address/size pair and denotes the IO > + virtual address range of the region for the given device. The exact > + format depends on the values of the "#address-cells" and "#size-cells" > + properties of the device referenced via the phandle. > + > + When used in combination with a "reg" property, an IOVA mapping is to > + be established for this memory region. One example where this can be > + useful is to create an identity mapping for physical memory that the > + firmware has configured some hardware to access (such as a bootsplash > + framebuffer). > + > + If no "reg" property is specified, the "iommu-addresses" property > + defines carveout regions in the IOVA space for the given device. This > + can be useful if a certain memory region should not be mapped through > + the IOMMU. > + > no-map: > type: boolean > description: > > @@ -97,4 +121,50 @@ oneOf: > > additionalProperties: true > > +examples: > + - | > + / { > + compatible = "foo"; > + model = "foo"; > + > + #address-cells = <2>; > + #size-cells = <2>; > + > + reserved-memory { > + #address-cells = <2>; > + #size-cells = <2>; > + ranges; > + > + adsp_resv: reservation-adsp { > + /* > + * Restrict IOVA mappings for ADSP buffers to the 512 MiB region > + * from 0x40000000 - 0x5fffffff. Anything outside is reserved by > + * the ADSP for I/O memory and private memory allocations. > + */ > + iommu-addresses = <&adsp 0x0 0x00000000 0x00 0x40000000>, > + <&adsp 0x0 0x60000000 0xff 0xa0000000>; > + }; > + > + fb: framebuffer@90000000 { > + reg = <0x0 0x90000000 0x0 0x00800000>; > + iommu-addresses = <&dc0 0x0 0x90000000 0x0 0x00800000>; > + }; > + }; > + > + bus@0 { > + #address-cells = <1>; > + #size-cells = <1>; > + ranges = <0x0 0x0 0x0 0x40000000>; > + > + adsp: adsp@2990000 { > + reg = <0x2990000 0x2000>; > + memory-region = <&adsp_resv>; > + }; > + > + dc0: display@15200000 { > + reg = <0x15200000 0x10000>; > + memory-region = <&fb>; > + }; > + }; > + }; > ...
On Fri, Oct 07, 2022 at 02:45:31PM +0100, Robin Murphy wrote: > On 2022-09-23 13:35, Thierry Reding wrote: > > From: Thierry Reding <treding@nvidia.com> > > > > This adds the "iommu-addresses" property to reserved-memory nodes, which > > allow describing the interaction of memory regions with IOMMUs. Two use- > > cases are supported: > > > > 1. Static mappings can be described by pairing the "iommu-addresses" > > property with a "reg" property. This is mostly useful for adopting > > firmware-allocated buffers via identity mappings. One common use- > > case where this is required is if early firmware or bootloaders > > have set up a bootsplash framebuffer that a display controller is > > actively scanning out from during the operating system boot > > process. > > > > 2. If an "iommu-addresses" property exists without a "reg" property, > > the reserved-memory node describes an IOVA reservation. Such memory > > regions are excluded from the IOVA space available to operating > > system drivers and can be used for regions that must not be used to > > map arbitrary buffers. > > Bah, I've only just realised: don't we also need to change the "oneOf: > required: ..." schema to permit "iommu-addresses" without "reg" or "size"? Hm... good point. I think at least we'll want another: - required: - iommu-addresses in there. I wonder if we also need to avoid the combination of "size" and "iommu-addresses". When "size" is specified, is it guaranteed that those regions will be allocated before the direct mapping needs to be created? Thierry
On 2022-10-07 14:54, Thierry Reding wrote: > On Fri, Oct 07, 2022 at 02:45:31PM +0100, Robin Murphy wrote: >> On 2022-09-23 13:35, Thierry Reding wrote: >>> From: Thierry Reding <treding@nvidia.com> >>> >>> This adds the "iommu-addresses" property to reserved-memory nodes, which >>> allow describing the interaction of memory regions with IOMMUs. Two use- >>> cases are supported: >>> >>> 1. Static mappings can be described by pairing the "iommu-addresses" >>> property with a "reg" property. This is mostly useful for adopting >>> firmware-allocated buffers via identity mappings. One common use- >>> case where this is required is if early firmware or bootloaders >>> have set up a bootsplash framebuffer that a display controller is >>> actively scanning out from during the operating system boot >>> process. >>> >>> 2. If an "iommu-addresses" property exists without a "reg" property, >>> the reserved-memory node describes an IOVA reservation. Such memory >>> regions are excluded from the IOVA space available to operating >>> system drivers and can be used for regions that must not be used to >>> map arbitrary buffers. >> >> Bah, I've only just realised: don't we also need to change the "oneOf: >> required: ..." schema to permit "iommu-addresses" without "reg" or "size"? > > Hm... good point. I think at least we'll want another: > > - required: > - iommu-addresses > > in there. I wonder if we also need to avoid the combination of "size" > and "iommu-addresses". When "size" is specified, is it guaranteed that > those regions will be allocated before the direct mapping needs to be > created? Well, it couldn't really be a direct mapping anyway. In general I don't think that combination makes any sense, since the presence of "iommu-addresses" means one of two things; either it says the IOVA range is carved out for some special purpose or just unusable, in which case allocating any memory to back it would surely be pointless, or it's saying don't touch these addresses because the device is already accessing them, thus the underlying physical memory must be allocated somewhere already. Thanks, Robin.
On Fri, Oct 07, 2022 at 03:21:46PM +0100, Robin Murphy wrote: > On 2022-10-07 14:54, Thierry Reding wrote: > > On Fri, Oct 07, 2022 at 02:45:31PM +0100, Robin Murphy wrote: > > > On 2022-09-23 13:35, Thierry Reding wrote: > > > > From: Thierry Reding <treding@nvidia.com> > > > > > > > > This adds the "iommu-addresses" property to reserved-memory nodes, which > > > > allow describing the interaction of memory regions with IOMMUs. Two use- > > > > cases are supported: > > > > > > > > 1. Static mappings can be described by pairing the "iommu-addresses" > > > > property with a "reg" property. This is mostly useful for adopting > > > > firmware-allocated buffers via identity mappings. One common use- > > > > case where this is required is if early firmware or bootloaders > > > > have set up a bootsplash framebuffer that a display controller is > > > > actively scanning out from during the operating system boot > > > > process. > > > > > > > > 2. If an "iommu-addresses" property exists without a "reg" property, > > > > the reserved-memory node describes an IOVA reservation. Such memory > > > > regions are excluded from the IOVA space available to operating > > > > system drivers and can be used for regions that must not be used to > > > > map arbitrary buffers. > > > > > > Bah, I've only just realised: don't we also need to change the "oneOf: > > > required: ..." schema to permit "iommu-addresses" without "reg" or "size"? > > > > Hm... good point. I think at least we'll want another: > > > > - required: > > - iommu-addresses > > > > in there. I wonder if we also need to avoid the combination of "size" > > and "iommu-addresses". When "size" is specified, is it guaranteed that > > those regions will be allocated before the direct mapping needs to be > > created? > > Well, it couldn't really be a direct mapping anyway. In general I don't > think that combination makes any sense, since the presence of > "iommu-addresses" means one of two things; either it says the IOVA range is > carved out for some special purpose or just unusable, in which case > allocating any memory to back it would surely be pointless, or it's saying > don't touch these addresses because the device is already accessing them, > thus the underlying physical memory must be allocated somewhere already. I thought perhaps there could be cases where it is known that a controller needs to access memory in a certain I/O virtual region but doesn't actually care where that lives in physical memory and also does not rely on that memory have been previously set up (pre-filled, or whatever). Say you've got a micro-controller in a system that needs its firmware in a given region, but the OS can set up that region without any other limitations. One could use "size" and "iommu-addresses" to make sure the region is allocated with a specific size and located in a specific I/O virtual region. Not sure if that's perhaps a bit exotic, though. Thierry
On 2022-10-07 16:22, Thierry Reding wrote: > On Fri, Oct 07, 2022 at 03:21:46PM +0100, Robin Murphy wrote: >> On 2022-10-07 14:54, Thierry Reding wrote: >>> On Fri, Oct 07, 2022 at 02:45:31PM +0100, Robin Murphy wrote: >>>> On 2022-09-23 13:35, Thierry Reding wrote: >>>>> From: Thierry Reding <treding@nvidia.com> >>>>> >>>>> This adds the "iommu-addresses" property to reserved-memory nodes, which >>>>> allow describing the interaction of memory regions with IOMMUs. Two use- >>>>> cases are supported: >>>>> >>>>> 1. Static mappings can be described by pairing the "iommu-addresses" >>>>> property with a "reg" property. This is mostly useful for adopting >>>>> firmware-allocated buffers via identity mappings. One common use- >>>>> case where this is required is if early firmware or bootloaders >>>>> have set up a bootsplash framebuffer that a display controller is >>>>> actively scanning out from during the operating system boot >>>>> process. >>>>> >>>>> 2. If an "iommu-addresses" property exists without a "reg" property, >>>>> the reserved-memory node describes an IOVA reservation. Such memory >>>>> regions are excluded from the IOVA space available to operating >>>>> system drivers and can be used for regions that must not be used to >>>>> map arbitrary buffers. >>>> >>>> Bah, I've only just realised: don't we also need to change the "oneOf: >>>> required: ..." schema to permit "iommu-addresses" without "reg" or "size"? >>> >>> Hm... good point. I think at least we'll want another: >>> >>> - required: >>> - iommu-addresses >>> >>> in there. I wonder if we also need to avoid the combination of "size" >>> and "iommu-addresses". When "size" is specified, is it guaranteed that >>> those regions will be allocated before the direct mapping needs to be >>> created? >> >> Well, it couldn't really be a direct mapping anyway. In general I don't >> think that combination makes any sense, since the presence of >> "iommu-addresses" means one of two things; either it says the IOVA range is >> carved out for some special purpose or just unusable, in which case >> allocating any memory to back it would surely be pointless, or it's saying >> don't touch these addresses because the device is already accessing them, >> thus the underlying physical memory must be allocated somewhere already. > > I thought perhaps there could be cases where it is known that a > controller needs to access memory in a certain I/O virtual region but > doesn't actually care where that lives in physical memory and also does > not rely on that memory have been previously set up (pre-filled, or > whatever). Say you've got a micro-controller in a system that needs its > firmware in a given region, but the OS can set up that region without > any other limitations. One could use "size" and "iommu-addresses" to > make sure the region is allocated with a specific size and located in a > specific I/O virtual region. Not sure if that's perhaps a bit exotic, > though. Yeah, that was the closest case I could think of as well, but I'd really rather not encourage people to abuse DT that way. If a kernel driver is loading firmware and initialising the device from scratch then it should be able to sort everything out at runtime without DT involvement. Even if the firmware is somehow massive enough to warrant an early dynamic carveout rather than a regular page/CMA allocation, there's still no good excuse for the driver not to manage its own address space constraints. On the other hand if the device really does need its firmware at a specific hard-coded address than that would need a fixed physical reservation anyway, since the DT can't assume that the OS is definitely going to use IOMMU translation. Thanks, Robin.
diff --git a/Documentation/devicetree/bindings/reserved-memory/reserved-memory.yaml b/Documentation/devicetree/bindings/reserved-memory/reserved-memory.yaml index 44f72bcf1782..fb48d016e368 100644 --- a/Documentation/devicetree/bindings/reserved-memory/reserved-memory.yaml +++ b/Documentation/devicetree/bindings/reserved-memory/reserved-memory.yaml @@ -52,6 +52,30 @@ properties: Address and Length pairs. Specifies regions of memory that are acceptable to allocate from. + iommu-addresses: + $ref: /schemas/types.yaml#/definitions/phandle-array + description: > + A list of phandle and specifier pairs that describe static IO virtual + address space mappings and carveouts associated with a given reserved + memory region. The phandle in the first cell refers to the device for + which the mapping or carveout is to be created. + + The specifier consists of an address/size pair and denotes the IO + virtual address range of the region for the given device. The exact + format depends on the values of the "#address-cells" and "#size-cells" + properties of the device referenced via the phandle. + + When used in combination with a "reg" property, an IOVA mapping is to + be established for this memory region. One example where this can be + useful is to create an identity mapping for physical memory that the + firmware has configured some hardware to access (such as a bootsplash + framebuffer). + + If no "reg" property is specified, the "iommu-addresses" property + defines carveout regions in the IOVA space for the given device. This + can be useful if a certain memory region should not be mapped through + the IOMMU. + no-map: type: boolean description: > @@ -97,4 +121,50 @@ oneOf: additionalProperties: true +examples: + - | + / { + compatible = "foo"; + model = "foo"; + + #address-cells = <2>; + #size-cells = <2>; + + reserved-memory { + #address-cells = <2>; + #size-cells = <2>; + ranges; + + adsp_resv: reservation-adsp { + /* + * Restrict IOVA mappings for ADSP buffers to the 512 MiB region + * from 0x40000000 - 0x5fffffff. Anything outside is reserved by + * the ADSP for I/O memory and private memory allocations. + */ + iommu-addresses = <&adsp 0x0 0x00000000 0x00 0x40000000>, + <&adsp 0x0 0x60000000 0xff 0xa0000000>; + }; + + fb: framebuffer@90000000 { + reg = <0x0 0x90000000 0x0 0x00800000>; + iommu-addresses = <&dc0 0x0 0x90000000 0x0 0x00800000>; + }; + }; + + bus@0 { + #address-cells = <1>; + #size-cells = <1>; + ranges = <0x0 0x0 0x0 0x40000000>; + + adsp: adsp@2990000 { + reg = <0x2990000 0x2000>; + memory-region = <&adsp_resv>; + }; + + dc0: display@15200000 { + reg = <0x15200000 0x10000>; + memory-region = <&fb>; + }; + }; + }; ...