Improved documentation of device tree 'ranges'.
PATCH v2 1/1 Improved documentation of device tree 'ranges'.
I was misled by the prior language. I've attempted to clarify how 'ranges' are used, in particular, how to get an identity mapping.
--- Documentation/powerpc/booting-without-of.txt | 13 +++++++++---- 1 files changed, 9 insertions(+), 4 deletions(-)
Documentation/powerpc/booting-without-of.txt +9 -4
@@ -711,13 +711,14 @@ define a bus type with a more complex address format, including things like address space bits, you'll have to add a bus translator to the prom_parse.c file of the recent kernels for your bus type. -The "reg" property only defines addresses and sizes (if #size-cells -is non-0) within a given bus. In order to translate addresses upward +The "reg" property only defines addresses and sizes (if #size-cells is +non-0) within a given bus. In order to translate addresses upward (that is into parent bus addresses, and possibly into CPU physical addresses), all busses must contain a "ranges" property. If the "ranges" property is missing at a given level, it's assumed that -translation isn't possible. The format of the "ranges" property for a -bus is a list of: +translation isn't possible, i.e., the registers are not visible on the +parent bus. The format of the "ranges" property for a bus is a list +of: bus address, parent bus address, size
@@ -735,6 +736,10 @@ fit in a single 32-bit word. New 32-bit powerpc boards should use a 1/1 format, unless the processor supports physical addresses greater than 32-bits, in which case a 2/1 format is recommended. +Alternatively, the "ranges" property may be empty, indicating that the +registers are visible on the parent bus using an identity mapping +translation. In other words, the parent bus address space is the same +as the child bus address space. 2) Note about "compatible" properties -------------------------------------
Signature · 1 line
1.5.3.4-dirty
Quoted 4 lines · Stephen Neuendorffer
I was misled by the prior language. I've attempted to clarify how 'ranges' are used, in particular, how to get an identity mapping.
Signed-off-by Stephen Neuendorffer <[email protected]>
Thanks for the update. I particularly dislike the "1:1" terminology, because in maths-speak *any* ranges translation is 1:1, unless it includes overlapping ranges.
Signature · 4 lines
David Gibson | I'll have my music baroque, and my code david AT gibson.dropbear.id.au | minimalist, thank you. NOT _the_ _other_ | _way_ _around_! http://www.ozlabs.org/~dgibson
Grant Likely
Acked-byQuoted 8 lines · David Gibson
Quoted 4 lines · Stephen Neuendorffer
I was misled by the prior language. I've attempted to clarify how 'ranges' are used, in particular, how to get an identity mapping.
Signed-off-by Stephen Neuendorffer <[email protected]>Acked-by David Gibson <[email protected]>
Quoted 11 lines
Thanks for the update. I particularly dislike the "1:1" terminology, because in maths-speak *any* ranges translation is 1:1, unless it includes overlapping ranges.
--
David Gibson | I'll have my music baroque, and my code david AT gibson.dropbear.id.au | minimalist, thank you. NOT _the_ _other_ | _way_ _around_!
Signature · 4 lines
Grant Likely, B.Sc., P.Eng. Secret Lab Technologies Ltd. [email protected] (403) 399-0195
Stephen Neuendorffer
Acked-by David GibsonRE: [PATCH] [POWERPC] [v2] Improved documentation of device tree'ranges'.
In reply to David GibsonI'm actually a little embarrassed that I didn't pick that nit myself.. :)
-----Original Message-----
From: David Gibson [mailto:[email protected]]
Sent: Mon 12/3/2007 6:40 PM
To: Stephen Neuendorffer
Cc: [email protected]; [email protected]
Subject: Re: [PATCH] [POWERPC] [v2] Improved documentation of device tree'ranges'.
Quoted 4 lines · Stephen Neuendorffer
I was misled by the prior language. I've attempted to clarify how 'ranges' are used, in particular, how to get an identity mapping.
Signed-off-by Stephen Neuendorffer <[email protected]>
Thanks for the update. I particularly dislike the "1:1" terminology, because in maths-speak *any* ranges translation is 1:1, unless it includes overlapping ranges.
Signature · 4 lines
David Gibson | I'll have my music baroque, and my code david AT gibson.dropbear.id.au | minimalist, thank you. NOT _the_ _other_ | _way_ _around_! http://www.ozlabs.org/~dgibson